Direc­tory info/dtxgallery

README

============
DTXGALLERY
============
This work is a collection of files that demonstrate
simple things that are possible with the flexible
and under-appreciated docstrip file format.
It is intended as a companion to Scott Pakin's
excellent and influential "dtxtut" example of producing
LaTeX packages in this way.
This work consists of the following files:
--------------
dtxgallery.dtx
A `meta-example' showing how multiple .dtx files can be
documented in a single file. Read the .pdf version of this
file first.
--------------
-----------------
single-source.dtx
This is an example of both the .sty and .ins
files being extracted from the .dtx file. This
allows maintenance of a single source file
but still produces a "standard-behaviour" .dtx/.ins
pair for upload to CTAN.
-----------------
--------------------
conditional-code.dtx
This example shows how code can be extracted in different
contexts. For example, debug code in a package can be
included in the source .dtx file but be automatically
stripped out for the public release version of the package.
--------------------
-------------
rearrange.dtx
This example demonstrates how source code may
be written and documented in a different logical
order than in which it is required to execute.
This can be useful, for example, when default
values are provided at the very stage of the package
loading, but you wish to describe them first in the
main body of the (non-technical) documentation.
-------------
Maintained by Will Robertson, 2007.
Please send comments and suggestions (entire examples very
welcome!) to me at the typeset string of:
\zap@space wspr \number`\Q \char64 gmail \char46 com {}
Distributed under the LaTeX Project Public License, version
1.3c or higher (your choice).

DTX gallery – A small col­lec­tion of min­i­mal DTX ex­am­ples

A col­lec­tion of files that demon­strate sim­ple things that are
pos­si­ble with the flex­i­ble and un­der-ap­pre­ci­ated doc­strip file
for­mat. Each file of the col­lec­tion is pro­vided as a
.dtx file and as the cor­re­spond­ing .pdf.

The set is in­tended as a com­pan­ion to Scott Pakin’s
ex­cel­lent and in­flu­en­tial dtx­tut
ex­am­ple of pro­duc­ing LaTeX pack­ages in this way.