diff options
Diffstat (limited to 'Master/texmf-dist/source/latex/nicetext/makedoc.tex')
-rw-r--r-- | Master/texmf-dist/source/latex/nicetext/makedoc.tex | 20 |
1 files changed, 18 insertions, 2 deletions
diff --git a/Master/texmf-dist/source/latex/nicetext/makedoc.tex b/Master/texmf-dist/source/latex/nicetext/makedoc.tex index f09d2a5bd23..fdf4ce95b11 100644 --- a/Master/texmf-dist/source/latex/nicetext/makedoc.tex +++ b/Master/texmf-dist/source/latex/nicetext/makedoc.tex @@ -1,4 +1,4 @@ -\ProvidesFile{makedoc.tex}[2011/11/19 documenting makedoc.sty] +\ProvidesFile{makedoc.tex}[2012/03/18 documenting makedoc.sty] \RequirePackage{makedoc} \documentclass[fleqn]{article} %% fleqn 2011/10/12 \input{makedoc.cfg} @@ -189,6 +189,7 @@ or you can switch to it by \[`\CopyFDconditionFromTo{PScomment}{comment}'\] \subsection{Markup in comments} +\label{sec:mdoccorr-tex} %% 2012/03/18 Packages using the 'doc'\slash '.dtx' system as well as alternative highly developed systems mentioned above use (enhanced) usual \emph{\LaTeX} syntax for markup of comments. Other packages just use @@ -534,6 +535,19 @@ file from a single input file! Therefore: % difficult---its parsing and that from 'verbatim' cannot % distinguish between markup code and typeset code.} % \end{enumerate} +\subsection{Star avoids &\input{mdoccorrhook}} +All the preprocessing commands described above---apart from the +'fifinddo' command `\ProcessFileWith'---input the file +'mdoccorr.cfg' with (typographical) replacement rules +(Sec.~\ref{sec:mdoccorr-tex}, Sec.~\ref{sec:mdoccorr}) +automatically. They have star variants that don't: +|\MakeInputJobDoc*|, |\MakeJobDoc*|, |\MakeDoc*|, +|\MakeCloseDoc*|, and |\MakeSingleDoc*|. +This is useful when rules very specific to a certain package +must be applied instead of the usual ones. +The examples named in Sec.~\ref{sec:otherauth} use this feature +for formatting other author's plain text documentation +without modifying their files. \section{Examples}%%% (documentation of 'mdoccorr.cfg')} %% moved here 2010/03/23 @@ -593,8 +607,9 @@ And this is the content of the intermediate generated file: % \fussy %% 2010/03/29 \subsection{Packages from other authors} +\label{sec:otherauth} `substr.tex' should typeset a nicely formatted documentation -of Harald Har\-der's 'substr.sty', see my own result `substr.pdf'. +of Harald Har\-ders' 'substr.sty', see my own result `substr.pdf'. 'substr.sty' is a rare case of the \lq`%% '\rq\ commenting style that 'nicetext' has used itself. @@ -673,3 +688,4 @@ end of a file it writes. %% todo TeXbook where? 2009/04/08 2011/10/25 without \enlargethispage 2011/11/05 or \RequirePackage{makedoc}; \MakeSingleDoc 2011/11/19 debugging for fifinddo v0.5 +2012/03/18 * forms; Harald H. corrected |