nicetext 044 (5dec11)

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

4 files changed, 41 insertions, 17 deletions

diff --git a/Master/texmf-dist/source/latex/nicetext/fifinddo.tex b/Master/texmf-dist/source/latex/nicetext/fifinddo.tex
index 5417ee4c02b..e026929dbfc 100644
--- a/Master/texmf-dist/source/latex/nicetext/fifinddo.tex
+++ b/Master/texmf-dist/source/latex/nicetext/fifinddo.tex
@@ -1,9 +1,9 @@
-\ProvidesFile{fifinddo.tex}[2011/08/22 documenting fifinddo.sty]
+\ProvidesFile{fifinddo.tex}[2011/11/19 documenting fifinddo.sty]
 \title{\textsf{fifinddo}\\---\\Filtering \TeX(t) Files by 
        \TeX\thanks{This file describes 
        version \fileversion\ of \textsf{\filename} as of \filedate.}} 
 % \listfiles
-\documentclass{article}
+\documentclass[fleqn]{article}
 \usepackage{makedoc}
 % \usepackage{substr} %% for failure examples TODO 2010/03/17
 \input{makedoc.cfg}
@@ -40,6 +40,7 @@ and \LaTeX's internal `\in@'.
 \end{MDabstract}
 \tableofcontents
 
+\pagebreak                                      %% 2011/11/19
 \section{Introduction: The Gnome of the Aim} 
 \subsection{Parsing by \TeX---are you mad?}
 The package name 'fifinddo' is a &\listfiles-compatible abbreviation 
@@ -82,17 +83,20 @@ At least the first item is just the philosophy of the 'docstrip' program,
 standard for installing \TeX\ packages; 
 and while I am typing this, I find at least 14 other similar packages 
 in J\"urgen Fenn's \emph{Topic Index} of the \emph{\TeX\ Catalogue:}
+\begin{center}                      %% 2011/11/13
 % \begin{quote}\small
-\[\texttt{%
-%   \hbox\bgroup\url{%                %% \url impossible!? 2010/03/19
+% \[\texttt{%
+%   \hbox\bgroup\url{%                %% \url impossible!? 2010/03/19 
+  \url{%
     http://mirror.ctan.org/help/Catalogue/bytopic.html\string#parsingfiles}% 
-      \footnotemark
+%       \footnotemark
 %        \egroup\] 
-\]
-\footnotetext{%
-  \href{http://mirror.ctan.org/help/Catalogue/bytopic.html\string#parsingfiles}%
-       {Click here!}}
+% \]
+% \footnotetext{%
+%   \href{http://mirror.ctan.org/help/Catalogue/bytopic.html\string#parsingfiles}%
+%        {Click here!}}
 % \end{quote}
+\end{center}
 (Some of them may have been \emph{reactance} to 'texhax' and other 
 postings urging not to try something like this; some seem just to be 
 celebrations of the power of \TeX---yes, celebrate!)
@@ -340,3 +344,5 @@ TODO cf. Kastrup 'makematch' and others 2009/04/09,
 2010/11/25f. using readprov.sty
 2010/11/27  reworked \ProvidesFile
 2011/08/22  PDF metadata; adjusting to makedoc.cfg
+2011/11/13  [fleqn]
+2011/11/19  \pagebreak
diff --git a/Master/texmf-dist/source/latex/nicetext/makedoc.tex b/Master/texmf-dist/source/latex/nicetext/makedoc.tex
index 88835e71e93..f09d2a5bd23 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/10/25 documenting makedoc.sty]
+\ProvidesFile{makedoc.tex}[2011/11/19 documenting makedoc.sty]
 \RequirePackage{makedoc}
 \documentclass[fleqn]{article}              %% fleqn 2011/10/12
 \input{makedoc.cfg} 
@@ -251,8 +251,10 @@ and `\maketitle' etc.\ about your package.\footnote{With 'niceverb'
 The documentation will be produced by running `<jobname>.tex' with 
 \LaTeX\ (e.g., \texttt{latex <jobname>.tex}).
 
-First, `<jobname>.tex' must have |\usepackage{makedoc}| in its preamble. 
-There are no package options. 
+First, `<jobname>.tex' must have 
+\[|\usepackage{makedoc}|\quad\mbox{or}\quad 
+  |\RequirePackage{makedoc}|\]                          %% 2011/11/05
+in its preamble. There are no package options. 
 
 Second, to typeset the commented implementation from `<jobname>.sty', 
 include in <jobname>.tex's `document' environment a line 
@@ -464,7 +466,16 @@ general way.\footnote{%% TODO 2010/03/16
 Using `\MakeDoc' \emph{instead} of `\MakeCloseDoc' allows processing 
 additional <input> files writing into the same <output>. Or maybe you 
 want to add some additional lines manually to <output> using 
-`\WriteResult'.
+`\WriteResult'.---By contrast, you may want to make a single output 
+file from a single input file! Therefore:
+%% <- 2011/11/05 ->
+%
+\begin{description}
+\cmdboxitem|\MakeSingleDoc[<out-ext>]{<in-output>.<in-ext>}| \
+    issues\\`\LaTeXresultFile{<in-output>.<out-ext>}'\quad 
+    and\\`\MakeDocCloseDoc{<in-output>.<in-ext>}'.\\
+    The default for <out-ext> is `doc'.
+\end{description}
 
 %% removed 2010/03/09:
 % At least in the long run, using 'makedoc' should not imply commitment 
@@ -567,6 +578,7 @@ and then looks thus:
 %  \sloppy %% 2010/03/29
 \strut\hrule
 \renewcommand*{\mdJobName}{mdoccorr}
+%  \tracingmacros=1 \tracingonline=1                      %% 2011/11/19
 \MakeInputJobDoc[cfg]{0}{\ProcessInputWith{comment}}
 \hrule \noindent\strut
 And this is the content of the intermediate generated file:
@@ -600,6 +612,7 @@ Head of file (Legalese):
 \renewcommand*{\mdJobName}{makedoc}
 \ProcessLineMessage{}
 \MakeInputJobDoc{22}{\ProcessInputWith{comment}}
+\enlargethispage{2\baselineskip}                    %% 2011/11/05
 The previous empty code line is the one \TeX\ insists to add at every 
 end of a file it writes. %% todo TeXbook where? 2009/04/08
 
@@ -658,3 +671,5 @@ end of a file it writes. %% todo TeXbook where? 2009/04/08
 2011/10/07  "grouping" fix(?) + \label in "Separating"
 2011/10/12  fleqn
 2011/10/25  without \enlargethispage
+2011/11/05  or \RequirePackage{makedoc}; \MakeSingleDoc
+2011/11/19  debugging for fifinddo v0.5
diff --git a/Master/texmf-dist/source/latex/nicetext/niceverb.tex b/Master/texmf-dist/source/latex/nicetext/niceverb.tex
index 738d05f34f9..e62a028eabf 100644
--- a/Master/texmf-dist/source/latex/nicetext/niceverb.tex
+++ b/Master/texmf-dist/source/latex/nicetext/niceverb.tex
@@ -1,4 +1,4 @@
-\ProvidesFile{niceverb.tex}[2011/10/07 documenting niceverb.sty]
+\ProvidesFile{niceverb.tex}[2011/11/05 documenting niceverb.sty]
 \title{\textsf{niceverb.sty}\\---\\Minimizing 
   Markup\\for Documenting \LaTeX\ packages\thanks{This 
     document describes version 
@@ -14,7 +14,9 @@
 \MDkeywords{literate programming, syntactic sugar,
             .txt to .tex enhancement, macro programming}
 \hypersetup{%% was `syntacic' 2011/10/07:
-    pdftitle=syntactic sugar for LaTeX documentation by niceverb.sty,
+%     pdftitle=syntactic sugar for LaTeX documentation by niceverb.sty, 
+    %% <- 2011/11/05 -> 
+    pdftitle=niceverb.sty: syntactic sugar for LaTeX documentation,
     pdfsubject=documenting niceverb.sty
 }%% /2011/08/22
 \begin{document}
@@ -458,3 +460,4 @@ HISTORY
 2011/05/09  undoubled lines about `&'
 2011/08/22  using new makedoc.cfg features 
 2011/10/07  `syntacic'
+2011/11/05  modified pdftitle
diff --git a/Master/texmf-dist/source/latex/nicetext/srcfiles.tex b/Master/texmf-dist/source/latex/nicetext/srcfiles.tex
index e674df5a1d5..46fbf40b8f0 100644
--- a/Master/texmf-dist/source/latex/nicetext/srcfiles.tex
+++ b/Master/texmf-dist/source/latex/nicetext/srcfiles.tex
@@ -1,11 +1,11 @@
 \RequirePackage{myfilist}
-\ProvidesFile{srcfiles.tex}[2011/09/13 collect file infos]
+\ProvidesFile{srcfiles.tex}[2011/12/05 file infos -> SrcFILEs.txt]
 \EmptyFileList %%% [readprov.sty,myfilist.sty]
 % \ReadPackageInfos{readprov,myfilist}
 \ReadFileInfos{DOCSRC.}             %% updsfl.sh
-\ReadFileInfos{srcfiles}
 \ReadFileInfos{README,fifinddo,makedoc,niceverb}
 \ReadFileInfos{mdoccheat,wikicheat} %% updsfl.sh
+\ReadFileInfos{srcfiles}
 \ReadFileInfos{RUN.}
 \ReadFileInfos{arseneau,substr}
 \ReadFileInfos{copyfile,fdtxttex}