summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/source/latex/nicetext/makedoc.tex
diff options
context:
space:
mode:
Diffstat (limited to 'Master/texmf-dist/source/latex/nicetext/makedoc.tex')
-rw-r--r--Master/texmf-dist/source/latex/nicetext/makedoc.tex20
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