CTAN Comprehensive TeX Archive Network

Direc­tory info/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:


A `meta-example' showing how multiple .dtx files can be
documented in a single file. Read the .pdf version of this
file first. 


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.


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.


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

Down­load the con­tents of this pack­age in one zip archive (350.8k).

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 pack­ages in this way.

Pack­ageDTX gallery
Li­censesThe Project Public Li­cense
Main­tainerWill Robert­son
Con­tained inTeX Live as dtx­gallery
TopicsDemo code
Guest Book Sitemap Contact Contact Author