diff options
author | Karl Berry <karl@freefriends.org> | 2007-08-08 17:46:07 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2007-08-08 17:46:07 +0000 |
commit | e5fe7bcd5a619359401f314997d3e95db5100c5f (patch) | |
tree | 0b702e1f6db15e9d38f62cae172caf44fb664dd0 /Master/texmf-dist/doc/latex/dtxgallery/README | |
parent | 47a39d3836481a603a6eed0de31822508101f6d5 (diff) |
new package dtxgallery (6aug07)
git-svn-id: svn://tug.org/texlive/trunk@4715 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/latex/dtxgallery/README')
-rw-r--r-- | Master/texmf-dist/doc/latex/dtxgallery/README | 62 |
1 files changed, 62 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/dtxgallery/README b/Master/texmf-dist/doc/latex/dtxgallery/README new file mode 100644 index 00000000000..fe78ab4c2e2 --- /dev/null +++ b/Master/texmf-dist/doc/latex/dtxgallery/README @@ -0,0 +1,62 @@ +============ + 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). |