nicetext (19mar12)

git-svn-id: svn://tug.org/texlive/trunk@25699 c570f23f-e606-0410-a88d-b1316a301751

3 files changed, 33 insertions, 5 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
diff --git a/Master/texmf-dist/source/latex/nicetext/mdoccheat.tex b/Master/texmf-dist/source/latex/nicetext/mdoccheat.tex
index 1fcbc68beda..4063fc275a1 100644
--- a/Master/texmf-dist/source/latex/nicetext/mdoccheat.tex
+++ b/Master/texmf-dist/source/latex/nicetext/mdoccheat.tex
@@ -16,10 +16,11 @@
   \let\@listI\@listi
 \makeatother
 \newcommand*{\defto}[2]{$#1\to_{\mathit{default}}#2$}
+\usepackage[margin=3cm]{geometry}                     %% 2012/03/18
 % \sfcode`/=1001 %% TODO makedoc.cfg!? 2010/03/15
 \sloppy
 \begin{document}
- \enlargethispage{1\baselineskip} %% 2010/03/29
+%  \enlargethispage{1\baselineskip} %% 2010/03/29 %% rm. 2012/03/18
 %   \null\kern-1\baselineskip
 \begin{center}
  \bfseries \Large
@@ -42,8 +43,7 @@ in `<jobname>.tex' \emph{after} &\begin{document}
   `\MakeInputJobDoc[<out-ext>][<in-ext>]{<header-lines>}{<main-parser>}'
 \end{displines} 
 documents `\mdJobName.<in-ext>' via `\mdJobName.<out-ext>', 
-\defto{<in-ext>}{`sty'}, \defto{&\mdJobName}{<jobname>}, 
-\defto{<out-ext>}{`doc'}, 
+\defto{<in-ext>}{`sty'}, \defto{<out-ext>}{`doc'}, \defto{&\mdJobName}{<jobname>} 
   \par\kern-5pt
 \begin{center} %% Parsers:
 \begin{tabular}{@{}l@{\hskip4pt }l@{\hskip4pt }l@{}}
@@ -93,12 +93,21 @@ documents `\mdJobName.<in-ext>' via `\mdJobName.<out-ext>',
     reads each <input> line to macro |\fdInputLine|, 
     applies <loop-body>
 \cmdboxitem|\MakeDoc{<input>}|
+    inputs `mdoccorr.cfg'
     copies <header-lines> from <input> to <output>, 
     applies <main-parser>
 \cmdboxitem|\CloseResultFile| closes <output>
 \cmdboxitem|\MakeCloseDoc{<input>}| issues 
     `\MakeDoc{<input>}\CloseResultFile'
+\cmdboxitem|\MakeSingleDoc[<out-ext>]{<in-output>.<in-ext>}| 
+    issues `\LaTeXresultFile{<in-output>.<out-ext>}'
+    and `\MakeDocCloseDoc{<in-output>.<in-ext>}',
+    \defto{<out-ext>}{`doc'},
 \end{description}
+%% 2012/03/18:
+\textbf{d.~Avoid &\input{mdoccorr.cfg} by} 
+|\MakeInputJobDoc*|, |\MakeJobDoc*|, |\MakeDoc*|, 
+|\MakeCloseDoc*|, or |\MakeSingleDoc*|
 
 \end{document}
 
diff --git a/Master/texmf-dist/source/latex/nicetext/srcfiles.tex b/Master/texmf-dist/source/latex/nicetext/srcfiles.tex
index 46fbf40b8f0..6b35a87464b 100644
--- a/Master/texmf-dist/source/latex/nicetext/srcfiles.tex
+++ b/Master/texmf-dist/source/latex/nicetext/srcfiles.tex
@@ -1,3 +1,6 @@
+\ProvidesFile{srcfiles.tex}[2012/03/18]
+\RequirePackage{longnamefilelist}
+\listfiles[9]
 \RequirePackage{myfilist}
 \ProvidesFile{srcfiles.tex}[2011/12/05 file infos -> SrcFILEs.txt]
 \EmptyFileList %%% [readprov.sty,myfilist.sty]