CTAN Comprehensive TeX Archive Network

Directory 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).

Download the contents of this package in one zip archive (350.8k).

DTX gallery – A small collection of minimal DTX examples

A collection of files that demonstrate simple things that are possible with the flexible and under-appreciated docstrip file format. Each file of the collection is provided as a .dtx file and as the corresponding .pdf.

The set is intended as a companion to Scott Pakin’s excellent and influential dtxtut example of producing packages in this way.

PackageDTX gallery
Version1
LicensesThe Project Public License
MaintainerWill Robertson
Contained inTeX Live as dtxgallery
TopicsDemo code
...
Guest Book Sitemap Contact Contact Author