nicetext 044 (5dec11)

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

18 files changed, 464 insertions, 211 deletions

diff --git a/Master/texmf-dist/doc/latex/nicetext/ANNOUNCE.txt b/Master/texmf-dist/doc/latex/nicetext/ANNOUNCE.txt
index a288aee0fb8..f1faefcb5e3 100644
--- a/Master/texmf-dist/doc/latex/nicetext/ANNOUNCE.txt
+++ b/Master/texmf-dist/doc/latex/nicetext/ANNOUNCE.txt
@@ -1,27 +1,31 @@
-Nice meta-verbatim, dialogues for .txt->.tex/encoding conversion
+nicetext: minimal markup for documentation, text filtering ...
 =================================================================
-Release 0.44:
+Release 0.5 2011/12/05:
 
-`niceverb.sty' v0.44 copes with design issue: on "\AddQuotes", 
-                     "`...'" indeed surrounds inline TeX code 
-                     with single quotation marks automatically
-                     (besides meta-verbatim)
+`mdoccorr.cfg'
+    - bug fix for 2011/10/25: `...' at line ends 
+    - applying new \PrependExpandableAllReplacer* from:
 
-`fddial0g.sty' v0.2  all my ideas so far for dialogue programming 
-                     tools carried out (handling "variables", 
-                     displaying their values on a "screen", 
-                     "\Spaces{15}" [e.g.] counts when expanding
-                     w/o e-TeX); not super-comfortable, but fine
+`fifinddo.sty' v0.5
+    - \PrependExpandableAllReplacer* uses automatically generated 
+      job ids, job id `*' alias for most recent, 
+      new \MakeSetupCommand another simplification
+    - new \ifFinalInputFile + \ProcessFinalFileWith simplify 
+      typical applications
+    - support for blogexec (morehype, 
+      besides expanding, execute some code from source file)
+    - input check fixed
+    - \CloseResultFile message "aligned"
+    - documentation modifications
 
-`fifinddo.sty' v0.43 new command useful in programming dialogues
+ `makedoc.sty' v0.42
+    - new \MakeSingleDoc simplifies typical application
+    - \MakeDoc reads mdoccorr.cfg
 
-dialogues/templates  adjusted
+ `makedoc.cfg'
+    logical markup \code + \pkg 
 
-`u8atablg.fdf'       fifinddo rules for replacing UTF-8 chars
-                     with TeX commands (and some extended ASCII)
-
-(I use all of this for converting my Xpad/Tomboy notes into input 
- for my great Atari editor)
-
-`mdoccheat.pdf'      was missing in previous release, back again
- 
+`niceverb.sty'
+    - modified \niceverb_collect_egroup/\VerticalCmdBox
+      (little success)
+    - doc. clarification
diff --git a/Master/texmf-dist/doc/latex/nicetext/CHANGE.LOG b/Master/texmf-dist/doc/latex/nicetext/CHANGE.LOG
index 95d4060b94f..1ae8e368654 100644
--- a/Master/texmf-dist/doc/latex/nicetext/CHANGE.LOG
+++ b/Master/texmf-dist/doc/latex/nicetext/CHANGE.LOG
@@ -1,5 +1,40 @@
 
 ______________________________________________________________________
+nicetext RELEASE  0.5   2011/12/05
+
+      DOC.
+ ANNOUNCE.txt           2011/12/05   most recent
+   CHANGE.LOG/txt       2011/12/05   updated
+ SrcFILEs.txt           2011/12/05   updated
+ fifinddo.pdf           2011/11/21   updated
+  makedoc.pdf           2011/12/03   updated 
+ niceverb.pdf           2011/12/05   updated
+
+   DOCSRC.
+ fifinddo.tex           2011/11/19   [fleqn], \pagebreak
+  makedoc.tex           2011/11/19   or \RequirePackage, 
+                                     \MakeSingleDoc
+ niceverb.tex           2011/11/05   mod. pdftitle
+ srcfiles.tex           2011/12/05   cosmetic
+
+      USE.
+ fifinddo.sty    v0.5   2011/11/21   \PrependExpandableAllReplacer*, 
+                                     + job `*' + \MakeSetupCommand
+                                     + \ifFinalInputFile 
+                                     + \ProcessFinalFileWith
+                                     + support for blogexec, 
+                                     input check fixed, 
+                                     \CloseResultFile message 
+                                     "aligned"; doc. mod.s
+  makedoc.cfg           2011/11/20   + \code + \pkg
+  makedoc.sty    v0.42  2011/11/19   + \MakeSingleDoc; \MakeDoc
+                                     reads mdoccorr.cfg
+ mdoccorr.cfg           2011/12/03   fix `...', apply
+                                     \PrependExpandableAllReplacer*
+ niceverb.sty    v0.44  2011/12/05   mod. \niceverb_collect_egroup/
+                                     \VerticalCmdBox, doc. fix
+
+______________________________________________________________________
 nicetext RELEASE  0.47  2011/10/25
 `mdoccorr.cfg' uses `csquotes''s idea for symmetrical text ellipsis
 (\unkern), no need for new macro as in r0.45; adds `...)'
@@ -19,19 +54,6 @@ ______________________________________________________________________
 nicetext RELEASE  0.44  2011/09/14   SUMMARY: niceverb + \AddQuotes,
                                      enhancements for dialogues and 
                                      templates, mdoccheat.pdf back
-      DOC.
- ANNOUNCE.txt           2011/09/14   most recent
-   CHANGE.LOG/txt       2011/09/14   updated
- SrcFILEs.txt           2011/09/14   updated
- fifinddo.pdf           2011/09/13   updated
-mdoccheat.pdf           2010/03/30   back again
-  makedoc.pdf           2011/09/14   updated for mdoccorr.cfg
- niceverb.pdf           2011/09/09   updated
-
-   DOCSRC.
- srcfiles.tex           2011/09/13   updated 
-  makedoc.tex           2011/09/14   revision of page breaks
-
      RUN.    
 README-run.txt          2011/09/14   more accurate
  copyfile.tex           2011/09/13   adjusted for fddial0g v0.2
diff --git a/Master/texmf-dist/doc/latex/nicetext/CHANGE.txt b/Master/texmf-dist/doc/latex/nicetext/CHANGE.txt
index 95d4060b94f..1ae8e368654 100644
--- a/Master/texmf-dist/doc/latex/nicetext/CHANGE.txt
+++ b/Master/texmf-dist/doc/latex/nicetext/CHANGE.txt
@@ -1,5 +1,40 @@
 
 ______________________________________________________________________
+nicetext RELEASE  0.5   2011/12/05
+
+      DOC.
+ ANNOUNCE.txt           2011/12/05   most recent
+   CHANGE.LOG/txt       2011/12/05   updated
+ SrcFILEs.txt           2011/12/05   updated
+ fifinddo.pdf           2011/11/21   updated
+  makedoc.pdf           2011/12/03   updated 
+ niceverb.pdf           2011/12/05   updated
+
+   DOCSRC.
+ fifinddo.tex           2011/11/19   [fleqn], \pagebreak
+  makedoc.tex           2011/11/19   or \RequirePackage, 
+                                     \MakeSingleDoc
+ niceverb.tex           2011/11/05   mod. pdftitle
+ srcfiles.tex           2011/12/05   cosmetic
+
+      USE.
+ fifinddo.sty    v0.5   2011/11/21   \PrependExpandableAllReplacer*, 
+                                     + job `*' + \MakeSetupCommand
+                                     + \ifFinalInputFile 
+                                     + \ProcessFinalFileWith
+                                     + support for blogexec, 
+                                     input check fixed, 
+                                     \CloseResultFile message 
+                                     "aligned"; doc. mod.s
+  makedoc.cfg           2011/11/20   + \code + \pkg
+  makedoc.sty    v0.42  2011/11/19   + \MakeSingleDoc; \MakeDoc
+                                     reads mdoccorr.cfg
+ mdoccorr.cfg           2011/12/03   fix `...', apply
+                                     \PrependExpandableAllReplacer*
+ niceverb.sty    v0.44  2011/12/05   mod. \niceverb_collect_egroup/
+                                     \VerticalCmdBox, doc. fix
+
+______________________________________________________________________
 nicetext RELEASE  0.47  2011/10/25
 `mdoccorr.cfg' uses `csquotes''s idea for symmetrical text ellipsis
 (\unkern), no need for new macro as in r0.45; adds `...)'
@@ -19,19 +54,6 @@ ______________________________________________________________________
 nicetext RELEASE  0.44  2011/09/14   SUMMARY: niceverb + \AddQuotes,
                                      enhancements for dialogues and 
                                      templates, mdoccheat.pdf back
-      DOC.
- ANNOUNCE.txt           2011/09/14   most recent
-   CHANGE.LOG/txt       2011/09/14   updated
- SrcFILEs.txt           2011/09/14   updated
- fifinddo.pdf           2011/09/13   updated
-mdoccheat.pdf           2010/03/30   back again
-  makedoc.pdf           2011/09/14   updated for mdoccorr.cfg
- niceverb.pdf           2011/09/09   updated
-
-   DOCSRC.
- srcfiles.tex           2011/09/13   updated 
-  makedoc.tex           2011/09/14   revision of page breaks
-
      RUN.    
 README-run.txt          2011/09/14   more accurate
  copyfile.tex           2011/09/13   adjusted for fddial0g v0.2
diff --git a/Master/texmf-dist/doc/latex/nicetext/RELEASE044.txt b/Master/texmf-dist/doc/latex/nicetext/RELEASE044.txt
new file mode 100644
index 00000000000..e1e514ba245
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/nicetext/RELEASE044.txt
@@ -0,0 +1,27 @@
+Nice meta-verbatim, dialogues for .txt->.tex/encoding conversion
+=================================================================
+Release 0.44, 2011/09/14:
+
+`niceverb.sty' v0.44 copes with design issue: on "\AddQuotes", 
+                     "`...'" indeed surrounds inline TeX code 
+                     with single quotation marks automatically
+                     (besides meta-verbatim)
+
+`fddial0g.sty' v0.2  all my ideas so far for dialogue programming 
+                     tools carried out (handling "variables", 
+                     displaying their values on a "screen", 
+                     "\Spaces{15}" [e.g.] counts when expanding
+                     w/o e-TeX); not super-comfortable, but fine
+
+`fifinddo.sty' v0.43 new command useful in programming dialogues
+
+dialogues/templates  adjusted
+
+`u8atablg.fdf'       fifinddo rules for replacing UTF-8 chars
+                     with TeX commands (and some extended ASCII)
+
+(I use all of this for converting my Xpad/Tomboy notes into input 
+ for my great Atari editor)
+
+`mdoccheat.pdf'      was missing in previous release, back again
+ 
diff --git a/Master/texmf-dist/doc/latex/nicetext/SrcFILEs.txt b/Master/texmf-dist/doc/latex/nicetext/SrcFILEs.txt
index 54f8c19bab5..4d9fc2b6834 100644
--- a/Master/texmf-dist/doc/latex/nicetext/SrcFILEs.txt
+++ b/Master/texmf-dist/doc/latex/nicetext/SrcFILEs.txt
@@ -1,13 +1,13 @@
 
  *File List*
   DOCSRC.    
-srcfiles.tex    2011/09/13 collect file infos
   README.tex    2011/02/14 make README.pdf
-fifinddo.tex    2011/08/22 documenting fifinddo.sty
- makedoc.tex    2011/10/25 documenting makedoc.sty
-niceverb.tex    2011/10/07 documenting niceverb.sty
+fifinddo.tex    2011/11/19 documenting fifinddo.sty
+ makedoc.tex    2011/11/19 documenting makedoc.sty
+niceverb.tex    2011/11/05 documenting niceverb.sty
 mdoccheat.tex    2011/01/26 cheat sheet for `makedoc.sty'
 wikicheat.tex    2011/01/26 cheatsheet for wiki.sty
+srcfiles.tex    2011/12/05 file infos -> SrcFILEs.txt
      RUN.    
 arseneau.tex    2010/04/05 some packages by D. Arseneau (ul)
   substr.tex    2011/08/20 [2010/03/30] documentation for substr.sty
@@ -23,14 +23,14 @@ fddial0g.sty    2011/09/13 v0.2 dialogues with fifinddo (UL)
 copyfile.cfg    2011/09/13 initializing copyfile.tex
 fdtxttex.cfg    2011/09/12 initializing fdtxttex.tex
      USE.    
-fifinddo.sty    2011/10/23 v0.44 filtering TeX(t) files by TeX (UL)
- makedoc.sty    2011/10/12 v0.41b TeX input from *.sty (UL)
- makedoc.cfg    2011/08/22 documentation settings
-mdoccorr.cfg    2011/10/25 local typographical corrections with makedoc.sty
-niceverb.sty    2011/09/09 v0.44 minimize doc markup (UL)
+fifinddo.sty    2011/11/21 v0.5 filtering TeX(t) files by TeX (UL)
+ makedoc.sty    2011/11/19 v0.42 TeX input from *.sty (UL)
+ makedoc.cfg    2011/11/20 documentation settings
+mdoccorr.cfg    2011/12/03 local typographical corrections with makedoc.sty
+niceverb.sty    2011/11/05 v0.44 minimize doc markup (UL)
     wiki.sty    2008/07/02 v0.2 LaTeX through Wiki markup
  ***********
 
- List made at 2011/10/25, 11:29
+ List made at 2011/12/05, 09:45
  from script file srcfiles.tex
 
diff --git a/Master/texmf-dist/doc/latex/nicetext/demo/sample.tex b/Master/texmf-dist/doc/latex/nicetext/demo/sample.tex
index f313574d5b2..3264d37af50 100644
--- a/Master/texmf-dist/doc/latex/nicetext/demo/sample.tex
+++ b/Master/texmf-dist/doc/latex/nicetext/demo/sample.tex
@@ -1,4 +1,4 @@
-\ProvidesFile{sample.tex}[2011/10/25 automatically generated with fifinddo.sty]
+\ProvidesFile{sample.tex}[2011/11/13 automatically generated with fifinddo.sty]
 blabla \textellipsis\unkern\ blabla
 blabla cf.\ bla
 etc.\ bla bla
diff --git a/Master/texmf-dist/doc/latex/nicetext/fifinddo.pdf b/Master/texmf-dist/doc/latex/nicetext/fifinddo.pdf
index 2b77512d809..30416e7f03b 100644
--- a/Master/texmf-dist/doc/latex/nicetext/fifinddo.pdf
+++ b/Master/texmf-dist/doc/latex/nicetext/fifinddo.pdf
diff --git a/Master/texmf-dist/doc/latex/nicetext/makedoc.pdf b/Master/texmf-dist/doc/latex/nicetext/makedoc.pdf
index 738e229018d..c72a9b4ef4f 100644
--- a/Master/texmf-dist/doc/latex/nicetext/makedoc.pdf
+++ b/Master/texmf-dist/doc/latex/nicetext/makedoc.pdf
diff --git a/Master/texmf-dist/doc/latex/nicetext/niceverb.pdf b/Master/texmf-dist/doc/latex/nicetext/niceverb.pdf
index c1873d59a09..3d757fcd223 100644
--- a/Master/texmf-dist/doc/latex/nicetext/niceverb.pdf
+++ b/Master/texmf-dist/doc/latex/nicetext/niceverb.pdf
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}
diff --git a/Master/texmf-dist/tex/latex/nicetext/fifinddo.sty b/Master/texmf-dist/tex/latex/nicetext/fifinddo.sty
index 75681f23eb8..e25e67aed5d 100644
--- a/Master/texmf-dist/tex/latex/nicetext/fifinddo.sty
+++ b/Master/texmf-dist/tex/latex/nicetext/fifinddo.sty
@@ -5,7 +5,7 @@
 %% for processing tex(t) files 
 %% (checking, filtering, converting, substituting, expanding, ...)
  
-\def\fileversion{0.44} \def\filedate{2011/10/23}
+\def\fileversion{0.5} \def\filedate{2011/11/21}
 
 %% This file can be redistributed and/or modified under 
 %% the terms of the LaTeX Project Public License; either 
@@ -99,14 +99,19 @@
 %%
 %% 
 %%  == File handling ==
-%% \label{sec:files}                                %% 2010/11/10
-\newwrite\result_file %% or write to \@mainaux!?
+%% %% structured 2011/11/19
+%% Peter Wilson's \ctanpkgref{newfile}
+%% provides more powerful file handling. 
+%% % <- TODO relevant? 2009/04/12
+%%
+%% === Opening, Writing to, Closing Output ===
+%% \label{sec:output}
+\newwrite\result_file %% or write to \@mainaux!? TODO
 %% |\ResultFile{<output>}| opens (and empties) a file 
 %% <output> to be written into. 
 \newcommand*{\ResultFile}[1]{%
   \def\result_file_name{#1}%
-%% By analogy to `\ProcessFileWith' 2011/10/23:
-  \typeout{`fifinddo' generating `\result_file_name'}%
+  \typeout{`fifinddo' generating `\result_file_name'}%  %% 2011/10/23
   \immediate\openout\result_file=#1}
 %% |\WriteResult{<balanced>}| writes a <balanced> line into 
 %% <output> (or more lines with `^^J').
@@ -120,6 +125,15 @@
     \string\ProvidesFile{\result_file_name}% 
       [\the\year/\two@digits\month/\two@digits\day\space 
        automatically generated with fifinddo.sty]}}%
+%% |\CloseResultFile| closes <output>:
+\newcommand*{\CloseResultFile}{% 
+    \immediate\closeout\result_file
+    \typeout{`fifinddo'                     %% 2011/10/23
+             \space\space\space             %% 2011/10/26
+             closing `\result_file_name'}} 
+%%
+%% === Processing Input ===
+%% \label{sec:input} 
 %% %% opt arg 2010/04/06:
 %% |\ProcessFileWith[<changes>]{<input>}{<loop-body>}| 
 %% opens a file <input> 
@@ -147,20 +161,26 @@
 %% \item ignoring certain characters. 
 %% \end{itemize}
 \newcommand*{\ProcessFileWith}[3][]{%
-  \typeout{`fifinddo' processing `#2'}%% 2010/04/15
-  \openin\@inputcheck=#2%
-%   \ifeof\@inputcheck  %% bad `exists?' test
-%     \PackageError{fifinddo}{File `#1' not here}%
-%                            {Mistyped?}%
-%   \else
-    \global\c@fdInputLine=\z@ %% line counter reset
+%% v0.5: Variant of \LaTeX's `\IfFileExists'---failed so far 
+%% because I had omitted the blank space:
+  \openin\@inputcheck#2 % space essential!  2011/11/19
+  \ifeof\@inputcheck 
+    \PackageError{fifinddo}{File `#2' not here}%
+                           {Mistyped?}%
+  \else
+    \typeout{`fifinddo' processing `#2'}%%  2010/04/15
+%% %% 2011/11/19:
+%% ... moves into conditional with v0.5. Resetting line counter:
+    \global\c@fdInputLine=\z@ 
     \begingroup 
       \MakeOther\{\MakeOther\}\@sanitize
-      %% from docstrip.tex: 
+%% ... switching into ``plain text mode"; from `docstrip.tex': 
       % \MakeOther\^^A\MakeOther\^^K%% irrelevant, not LaTeX
+%% <- cf. \TeX book 
+%%    pp.~43ff., 368ff.,                            %% 2011/11/19
+%%    ``extended keyboards", up-/downarrow;
+%%    -> ``math specials", cf. ``space specials"
       \endlinechar\m@ne
-      %% <- cf. TeXbook "extended keyboards" up-/downarrow
-      %%    -> "math specials", cf. "space specials"
       \MakeOther\^^I% ASCII horizontal tab -- guessed!? ^^L!?
 %% With v0.31, we support non-ASCII:
       \count@=128
@@ -181,13 +201,25 @@
               \else                 \@secondoftwo \fi
       \repeat
     \endgroup
-%   \fi
-  \closein\@inputcheck} 
-%% TODO: write EOF for debugging!?---%% 2010/03/18
-%% Peter Wilson's \ctanpkgref{newfile}
-%% provides more powerful file handling. 
-%% % <- TODO relevant? 2009/04/12
-%%
+  \fi
+  \closein\@inputcheck
+%% Added for v0.5, cf. Sec.~\ref{sec:final-input}
+  \ifFinalInputFile
+    \CloseResultFile \FinalInputFilefalse
+  \fi
+} 
+%% % TODO: write EOF for debugging!?---%% 2010/03/18
+%% % Another difference to some \ctanpkgref{verbatimcopy}
+%% % is that `\CopyFile' really was meant to 
+%% % be used for creating a \acro{HTML} file from some \emph{number} of 
+%% % sources, especially for shared head sections (however, 
+%% % I have used macros for this purpose so far), a navigation column, 
+%% % the main varying ``blog-like" content, and finally a shared 
+%% % footer section.
+%% % In the meantime, however, I have chosen another variant 
+%% % for generating \acro{HTML} that 
+%% % replaces an empty line by a line consisting of \verb+<p>+. 
+%% % 
 %% |\CopyFile[<changes>]{<file>}| 
 %% is an application of `\ProcessFileWith' 
 %% that ``copies" the content of file <file> 
@@ -220,25 +252,33 @@
 \newcommand*{\FD@compress@voids}{%
     \IfFDinputEmpty{\IfFDpreviousInputEmpty\relax\CopyLine}%
                    \CopyLine}
-%% Another difference to some \ctanpkgref{verbatimcopy}
-%% is that `\CopyFile' really was meant to 
-%% be used for creating a \acro{HTML} file from some \emph{number} of 
-%% sources, especially for shared head sections (however, 
-%% I have used macros for this purpose so far), a navigation column, 
-%% the main varying ``blog-like" content, and finally a shared 
-%% footer section.
-%% In the meantime, however, I have chosen another variant 
-%% for generating \acro{HTML} that 
-%% replaces an empty line by a line consisting of \verb+<p>+. 
 %% 
-%% |\CloseResultFile| closes <output>. 
-\newcommand*{\CloseResultFile}{% 
-    \immediate\closeout\result_file
-%% \enlargethispage{1\baselineskip}
-%% Another analogy to `\ProcessFileWith' 2011/10/23:
-    \typeout{`\result_file_name' completed (`fifinddo')}}
+%% === A Combining Shorthand ===
+%% \label{sec:final-input}
+%% Before v0.5, the general idea was that some number of \strong{input} 
+%% files would be combined for creating a single \strong{output} file 
+%% (e.g., as opposed to \ctanpkgref{verbatimcopy}, regarding 
+%% `\CopyFile').
+%% According to experience, however, a \strong{single} input file 
+%% typically suffices for generating an output file. 
+%% Then |\CloseResultFile| (Sec.~\ref{sec:output}) 
+%% may be called ``implicitly". The flag |\ifFinalInputFile|
+%% will control (and generalize!) this 
+%% (in `\ProcessFileWith', Sec.~\ref{sec:input}), 
+%% and will be reset if changed 
+%% (thinking of generating another file in the same \TeX\ run).
+%% 
+%% So 
+%% |\ProcessFinalFileWith[<changes>]{<input>}{<loop-body>}| 
+%% % |\ProcessFinalFileWith| works like `\ProcessFileWith'
+%% works as with `\ProcessFileWith'
+%% except that `\CloseResultFile' is issued after processing, 
+%% so you can omit the latter.
+\newif\ifFinalInputFile
+\newcommand*{\ProcessFinalFileWith}{%
+    \FinalInputFiletrue \ProcessFileWith}
 %%
-%% \pagebreak
+%% \pagebreak                               %% 2011/11/19 again
 %%  == Basic handling of substring conditionals ==
 %% \label{sec:theory}
 %% %% TODO move theory to fifinddo.tex 2009/04/12
@@ -318,9 +358,13 @@
 %%              Steven Segletes confirms that his 'stringstrings' doesn't 
 %%              suffer the problem (returning positions of substrings and 
 %%              numbers of occurrences).}
-%% \[`\makeatletter \in@{bonbon}{bon}\ifin@ YES\else NO\fi \makeatother'\]
+%% \begin{center}
+%% % \[
+%%    `\makeatletter \in@{bonbon}{bon}\ifin@ YES\else NO\fi \makeatother'
 %% %% \makeatletter \in@{bonbon}{bon}\ifin@ YES\else NO\fi \makeatother
 %% %% \IfSubStringInString{ionization}{ionizat}{YES}{NO}
+%% % \]
+%% \end{center}
 %%
 %% In general, the previous approach \emph{fails if and exactly if} 
 %% <pattern> has a \emph{period} $p$---less than its length---in the sense of that 
@@ -411,7 +455,10 @@
 %%   `\newcommand*{<do-setup>}[<args>]{<action>}'
 %% \end{quote}
 %% <do-setup>'s first argument will be the <pattern> argument
-%% of <setup-cmd>.
+%% of <setup-cmd>.---With v0.5, we learn from the previous and provide 
+%% \[|\MakeSetupCommand{<setup-cmd>}{<do-setup>}[<args>]{<action>}|\]
+\newcommand*{\MakeSetupCommand}[2]{\newcommand*#1{\StartFDsetup#2}%
+                                   \newcommand*#2}
 %%
 %% === Setup for conditionals ===
 %% `substr_cond' is the ``name space" for substring conditionals. 
@@ -423,16 +470,12 @@
 %% starts the definition of a conditional with identifier <id> 
 %% and pattern <pattern>. <changes> optionally add commands to 
 %% be executed after `\PatternCodes' in a local group. 
-%%
-\newcommand*{\MakeSubstringConditional}
-            {\StartFDsetup\mk_substr_cond}
-%%
 %% `\begingroup' |\mk_substr_cond{<pattern>}| %% TODO!? 2010/03/22
 %% can be directly called by other programmer setup commands when 
 %% `\fdParserId' and <pattern> have been read.
-\def\mk_substr_cond #1{%% #1 pattern string
+\MakeSetupCommand{\MakeSubstringConditional}{\mk_substr_cond}[1]{%
+  %% #1 pattern string
   \endgroup \@namedef{\substr_cond \fdParserId}##1#1##2&}
-%%
 %% This really is not \LaTeX. We are starting defining a macro 
 %% `\substr_cond:<id>' in primitive \TeX\ with `\def' in the form
 %% \[`\def\substr_cond:<id>#1<pattern>#2&'\]
@@ -494,8 +537,9 @@
 %% `setup_substr_cond' is the name space for macros that build
 %% sandboxes and initialize arguments for conditional macros. 
 \def\setup_substr_cond{setup_substr_cond:}
-%% |\MakeSetupSubstringCondition{<id>}[<changes>]{<pattern>}{<more-args>}|\\ 
-%% [\topsep]                                            %% 2010/11/25
+%% \begin{center}                           %% 2011/11/13
+%% |\MakeSetupSubstringCondition{<id>}[<changes>]{<pattern>}{<more-args>}|
+%% \end{center}
 %% % <- TODO allow `%' and ` ' for breaking code lines. 
 %% ---same <id>, <changes>, <pattern> as for 
 %% `\MakeSubstringConditional' (this is bad, there may be 
@@ -505,30 +549,37 @@
 %% <more-args> may contain `{#1}' to store the string that was tested,
 %% also `{<id>}' for calling repetitions and `{<pattern>}' for screen 
 %% or log informations. 
-\newcommand*{\MakeSetupSubstringCondition}
-            {\StartFDsetup\mk_setup_substr_cond}
+\MakeSetupCommand{\MakeSetupSubstringCondition}
+                 {\mk_setup_substr_cond}[2]{%
 %% |\mk_setup_substr_cond{<pattern>}{<more-args>}| 
 %% %% without \begingroup 2010/03/29
 %% can be directly called by other programmer setup commands after 
-%% `\fdParserId' and <pattern> have been read:
-\def\mk_setup_substr_cond #1#2{%% #1 pattern string, 
+%% `\fdParserId' and <pattern> have been read.
+  %% #1 pattern string
   %% #2 additional arguments, e.g., `{#1}' to keep tested string
   \endgroup 
-  \expandafter \edef 
+  \expandafter \protected@edef                 %% protected 2011/11/21
+%% ... keeps `\protect' instead of just not expanding, 
+%% but I cannot implement `\UseBlogLigs' otherwise right now.
    \csname \setup_substr_cond \fdParserId \endcsname ##1{%
-      \make_not_expanding_cs{\substr_cond \fdParserId}%
+      \noexpandcsname \substr_cond \fdParserId \endcsname
 %% By `\edef', the name of the substring conditional is stored here 
 %% as a single token. The rest of the sandbox follows. 
-          ##1\noexpand~#1\dollar_tilde&#2}%
+          ##1~#1\dollar_tilde&#2}%
+%% <- `\noexpand~' replaced for v0.5 according to 
+%% Sec.~\ref{sec:pseudo-tilde}.
   \let\dollar_tilde\sandbox_dollar}
 %% If a tilde `~' has been used instead of `$', the default 
 %% is restored. 
 \def\sandbox_dollar{$}
 \let\dollar_tilde\sandbox_dollar
-%% The following general tool |\make_not_expanding_cs| has been used 
+%% % The following general tool |\make_not_expanding_cs| has been used 
+%% The following general tool |\noexpandcsname| has been used 
 %% (many definitions in 'latex.ltx' could have used it): %% 2009/04/10
-\def\make_not_expanding_cs#1{%
-    \expandafter \noexpand \csname #1\endcsname}
+% \def\make_not_expanding_cs#1{%
+%     \expandafter \noexpand \csname #1\endcsname}
+%% <- 2011/11/20 ->
+\def\noexpandcsname{\expandafter\noexpand\csname}
 %%
 %% === Getting rid of the tildes ===
 %% |\let~\TildeGobbles| can be used to suppress dummy patterns 
@@ -555,6 +606,21 @@
 \newcommand*{\RemoveTildeArg}[2]{% 
   \expandafter #1\expandafter {\RemoveTilde #2}} 
 %%
+%% === Alternative Setup ===
+%% \label{sec:pseudo-tilde}
+%% 'blog.sty' v0.7---``ligatures"---has problems with the tilde. 
+%% We call a different setup by |\FDpseudoTilde| and go back 
+%% to the original one by |\FDnormalTilde| 
+%% (which, however, works only for new processing jobs and 
+%%  processing another file---at present, TODO  2011/11/21):
+\newcommand*{\FDnormalTilde}{\def~{\noexpand~}%
+                             \let\RemoveTilde\FD_remove_normal_tilde} 
+\let\FD_remove_normal_tilde\RemoveTilde
+\FDnormalTilde
+\newcommand*{\FDpseudoTilde}{\def~{\noexpand\pseudo_tilde}%
+                             \let\RemoveTilde\FD_remove_pseudo_tilde}
+\def\FD_remove_pseudo_tilde#1\pseudo_tilde{#1}
+%%
 %% === Calling conditionals ===
 %% |\ProcessStringWith{<target-string>}{<id>}| \ builds the sandbox 
 %% to search <target-string> for the <pattern> associated with the 
@@ -585,10 +651,11 @@
 %% Anyway, most desired will be |\ProcessInputWith{<id>}| just 
 %% applying to `\fdInputLine':
 \newcommand*{\ProcessInputWith}[1]{%
-  \csname \setup_substr_cond #1\expandafter \endcsname
-    \expandafter{\fdInputLine}}
-%% (Definition almost copied for efficiency.)
-  %% TODO: error when undefined 2009/04/07
+%   \csname \setup_substr_cond #1\expandafter \endcsname
+%     \expandafter{\fdInputLine}}
+% %% (Definition almost copied for efficiency.)
+  \ProcessExpandedWith\fdInputLine{#1}}             %% 2011/11/21
+%% TODO: error when undefined 2009/04/07
 %%
 %% === Copy jobs ===
 %% A job identifier <id> may also be considered a mere \emph{hook}, 
@@ -615,6 +682,7 @@
 %% This feature could have been placed more below as a ``programming 
 %% tool."
 %%
+%% 
 %%  == Programming tools ==
 %% === Tails of conditionals ===
 %% \label{sec:tails}
@@ -673,7 +741,7 @@
 %% (v0.42)
 %% is a companion of `\IfFDpreviousInputEmpty' referring to 
 %% `\fdInputLine' as of the \emph{previous} run of the loop 
-%% in `\ProcessFileWith', cf. section~\ref{sec:files}, 
+%% in `\ProcessFileWith', cf. section~\ref{sec:input}, 
 %% where its choice among its two arguments is determined. 
 %% It is initialized as follows:
 \newcommand*{\IfFDpreviousInputEmpty}[2]{#2}
@@ -717,8 +785,8 @@
   \ifnum\c@fdInputLine#1\relax \expandafter \@firstoftwo
   \else                        \expandafter \@secondoftwo \fi}
 %%
-%% === The ``identity job" `LEAVE' ===
-%% \label{sec:LEAVE}
+%% === ``Identity job" `LEAVE' and ``default job" `*' ===
+%% \label{sec:LEAVE}\label{sec:*}
 %% The job with identifier |LEAVE| 
 %% \emph{leaves} an (expandable) chain of jobs 
 %% (as expandable replacement in section~\ref{sec:replchain}) 
@@ -728,6 +796,24 @@
   \csname \setup_substr_cond LEAVE\endcsname \@firstofone
 %% I.e., `\ProcessStringWith{<string>}{LEAVE}' expands to <string> 
 %% ... \ProcessStringWith{(Indeed!)}{LEAVE}
+%% 
+%% |LEAVE| is used for ``chaining" jobs---there will be a routine 
+%% (Sec.~\ref{sec:auto-chain}) 
+%% to define the action of a job, including what job to run 
+%% \emph{next} after the present one has been finished.
+%% Using this routine, the final job will call `LEAVE'.
+%%
+%% |*| may be considered a ``meta-job"---it does not directly 
+%% set up a sandbox, it just ``redirects" to the job that has been 
+%% declared most recently. When job ids are assigned automatically, 
+%% with `*' you can call that job without knowing its actual id:
+\@namedef{\setup_substr_cond*}{%
+    \csname \setup_substr_cond \fdParserId \endcsname}
+%% As an important example, when all the jobs in the chain are 
+%% expandable, you can call the chain by 
+%% \[|\WriteResult{\ProcessInputWith{*}}|\]
+%% in the body of the file processing loop (Sec.~\ref{sec:input}).
+%% TODO: test!                                          %% 2011/11/21
 %%
 %%  == Setup for expandable chains of replacements ==
 %% \label{sec:replchain}%% TODO makedoc: provide less visible label/ref 2009/04/11 
@@ -800,26 +886,26 @@
 %% Optional argument <chng> changes category codes locally 
 %% for reading <find> and <replace>.
 %% %% <- added <cat>, <pattern> -> <find> 2010/03/19
-\newcommand*{\MakeExpandableAllReplacer}
-            {\StartFDsetup\mk_setup_xpdbl_all_repl}
-\newcommand*{\mk_setup_xpdbl_all_repl}[3]{%
+\MakeSetupCommand{\MakeExpandableAllReplacer}
+                 {\mk_setup_xpdbl_all_repl}[3]{%
   %% #1 pattern, #2 substitute, #3 pass to
   \endgroup
 %% We take pains to call next jobs by single 
 %% command strings and store them this way, not by `\csname', 
 %% as `\ProcessStringWith' would do it. `\edef\@tempa' 
 %% is used for this purpose, but \dots
-    \edef\@tempa{%
+    \protected@edef\@tempa{%                %% protected 2011/11/21
       \noexpand\mk_setup_substr_cond{#1}{%
         {}{#2}%
         \noexpand\noexpand
-%% That `\edef\@tempa' must \emph{not expand} the controll 
-%% words after they have been computed from `\csname' etc. 
+%% That `\edef\@tempa' must \emph{not expand} 
+%% tokens %%% the controll words after they have been %% 2011/11/20
+%% computed from `\csname' etc. 
 %% Moreover, expansion of the parser commands 
-%% must be avoided another time, when `\@tempa' is executed. 
-          \make_not_expanding_cs{\substr_cond\fdParserId}%
+%% must be avoided another time when `\@tempa' is executed. 
+          \noexpandcsname \substr_cond \fdParserId \endcsname
         \noexpand\noexpand
-          \make_not_expanding_cs{\setup_substr_cond #3}}}%
+          \noexpandcsname \setup_substr_cond #3\endcsname}}%
 %% Those internal setup commands start with `\endgroup' to switch back 
 %% to standard category codes. We must match them here by 
 %% `\begingroup'.
@@ -828,11 +914,13 @@
       \repl_all_chain_expandable{##1}{##2}}}
 %% The final command is the one that we explained first. %% TODO 2009/04/11 
 %%
-%% === Half-automatic chaining ===
-%% |\PrependExpandableAllReplacer{<id>}[<cat>]{<find>}{<replace>}| %%\\ 
-%% %% [\topsep]
-%% %% \[|\PrependExpandableAllReplacer{<id>}[<cat>]{<find>}{<replace>}|\]
-%% is hoped to be a slight relief in composing replacement chains.
+%% === Automatic chaining ===
+%% \label{sec:auto-chain}
+%% With v0.31, %% "Half-automatic" \Prepend...
+%% \[|\PrependExpandableAllReplacer{<id>}[<cat>]{<find>}{<replace>}|\]
+%% % |\PrependExpandableAllReplacer{<id>}[<cat>]{<find>}{<replace>}| 
+%% % \\[\topsep]
+%% was hoped to be a slight relief in composing replacement chains. 
 %% It does something like invoking `\MakeExpandableAllReplacer' 
 %% with <prev-setup-id> for the last <next-id> argument
 %% where <prev-setup-id> is the <id> of the job that was set up most 
@@ -846,11 +934,23 @@
 %% \end{quote}
 %% and call <id-2>, it will call <id-1>, and the latter will call 
 %% <id-0>. So you can reorder the chain by moving `\Prepend'... lines. 
+%%
+%% With v0.5, 
+%% |\PrependExpandableAllReplacer*[<cat>]{<find>}{<replace>}|
+%% saves you from inventing and typing <id>, it is automatically 
+%% generated; or the `*' replaces the <id> argument.
 \newcommand*{\PrependExpandableAllReplacer}{%
     \let\fdParserId_before\fdParserId
-    \StartFDsetup\prep_xpdbl_all_repl}
+    \@ifstar{\stepcounter{fd_line_job}%
+             \edef\@tempa{%
+                \noexpand\StartFDsetup 
+                    \noexpand\prep_xpdbl_all_repl
+                        {\number\value{fd_line_job}}}%
+             \@tempa}%
+            {\StartFDsetup\prep_xpdbl_all_repl}}
 \newcommand*{\prep_xpdbl_all_repl}[2]{%
     \mk_setup_xpdbl_all_repl{#1}{#2}{\fdParserId_before}}%
+    %% #1 pattern, #2 substitute, #3 pass to
 %% |\StartPrependingChain| makes `\MakeExpandableReplacer' 
 %% superfluous, in the sense that 
 %% the above chain setup can be achieved as well like this:
@@ -860,12 +960,25 @@
 %%   `\PrependExpandableAllReplacer{<id-1>}{<find-1>}{<subst-1>}'\\
 %%   `\PrependExpandableAllReplacer{<id-2>}{<find-2>}{<subst-2>}'
 %% \end{quote}
+%% or with v0.5:
+%% \begin{quote}
+%%   `\StartPrependingChain'\\
+%%   `\PrependExpandableAllReplacer*{<find-0>}{<subst-0>}'\\
+%%   `\PrependExpandableAllReplacer*{<find-1>}{<subst-1>}'\\
+%%   `\PrependExpandableAllReplacer{<start>}{<find-2>}{<subst-2>}'
+%% \end{quote}
 %% This adds a code line, but this way you can choose
 %% the final ``real" job more easily. So you can think of 
 %% `\StartPrependingChain' as ``initializing a chain of 
-%% prependments."
-\newcommand*{\StartPrependingChain}{\def\fdParserId{LEAVE}}
-%% Use automatic ids another time ... TODO %% 2010/11/24
+%% prependments." As to the `*' version, the example suggests 
+%% using an explicit <id> argument finally if you want to invoke 
+%% the chain explicitly by a line job identity 
+%% (without counting the declaration lines---however, 
+%% note job `*' according to Sec.~\ref{sec:*}).
+\newcommand*{\StartPrependingChain}{% 
+    \def\fdParserId{LEAVE}%
+    \setcounter{fd_line_job}{0}} %% 2011/11/13; TODO \Nameprefix...
+\newcounter{fd_line_job}
 %%
 %% === `CorrectHook' launching the replacement chain ===
 %% %% 2010/03/29:
@@ -889,7 +1002,7 @@
 %%  == Leave package mode ==
 %% We restore the underscore `_' for math subscripts. 
 %% (This might better depend on something \dots) %% TODO 2009/04/07
-\catcode`\_=8   %% restores underscore use for subscripts
+\catcode`\_=8 
 %%
 \endinput 
 %% \TeX\ ignores the rest of the file when it is \emph{input} 
@@ -1001,11 +1114,21 @@ v0.42  2010/11/09   typo corr.
        2011/01/25   updated (C); footnotes to `substring theory';
                     TODO with \RemoveTilde; some manual line spacings 
                     (adding `\ ')
-belonged to nicetext RELEASE 0.42
+       -> r0.42 
 v0.43  2011/08/06   doc.: mistake \WriteResult/\ResultFile,
        2011/08/22         use \acro
        2011/09/12f. \CorrectedInputLine - reworded for breaking
-belonged to nicetext RELEASE 0.44
+       -> r0.44
 v0.44  2011/10/23   messages from \ResultFile and \CloseResultFile
+       -> r0.46
+v0.45  2011/10/26   little modification of \CloseResultFile message, 
+                    "sacrificing" \pagebreak before Sec. 4 -- fine!
+v0.5   2011/11/13   \PrependExpandableAllReplacer*, \MakeSetupCommand; 
+                    doc.: {center} with too long verbatim quote
+       2011/11/19   input check fixed, doc. there adjusted, 
+                    \ifFinalInputFile, \ProcessFinalFileWith, job `*' 
+       2011/11/20   \noexpandcsname; "default job" lowercase
+       2011/11/21   \ProcessInputWith "less efficient", 
+                    \protected@edef, "pseudo-tilde"
 
 TODO: cleveref 2010/03/18
diff --git a/Master/texmf-dist/tex/latex/nicetext/makedoc.cfg b/Master/texmf-dist/tex/latex/nicetext/makedoc.cfg
index 5873581b871..14f36544d58 100644
--- a/Master/texmf-dist/tex/latex/nicetext/makedoc.cfg
+++ b/Master/texmf-dist/tex/latex/nicetext/makedoc.cfg
@@ -1,4 +1,4 @@
-\ProvidesFile{makedoc.cfg}[2011/08/22 documentation settings] 
+\ProvidesFile{makedoc.cfg}[2011/11/20 documentation settings] 
 
 \author{Uwe L\"uck\thanks{\url{http://contact-ednotes.sty.de.vu}}}
 % \author{Uwe L\"uck---{\tt http://contact-ednotes.sty.de.vu}}
@@ -57,19 +57,24 @@
 \RequirePackage{relsize}                %% 2011/06/27
 \RequirePackage{color}                  %% 2011/08/06
 \makeatletter
-  \@ifundefined{strong} 
+  \@ifdefinable{strong} 
                {\let\strong\textbf}     %% 2011/01/24
-               {} 
-  \@ifundefined{file} 
+  \@ifdefinable{file} 
                {\let\file\texttt}       %% 2011/05/23
-               {} 
-  \@ifundefined{acro} 
+  \@ifdefinable{acro} 
                {\let\acro\textsmaller}  %% 2011/05/23
-               {} 
   \@ifdefinable{\meta} 
                {\let\meta\textit}       %% 2011/07/22
+  \@ifdefinable{\pkg}             %% corr. 2011/11/20
+               {\let\pkg\textsf}        %% 2011/11/09
+  \@ifdefinable{\code} 
+               {\let\code\texttt}       %% 2011/11/20
   \ifpdf
-    \pdfstringdefDisableCommands{\let\acro\textrm}
+    \pdfstringdefDisableCommands{%
+        \let\acro\textrm 
+        \let\file\textrm                %% 2011/11/09
+        \let\code\textrm                %% 2011/11/20
+    }
   \fi
   %% TODO 2011/07/22 -> `htlogml.sty'
 \makeatother
diff --git a/Master/texmf-dist/tex/latex/nicetext/makedoc.sty b/Master/texmf-dist/tex/latex/nicetext/makedoc.sty
index 502f1307d0b..67658845ab3 100644
--- a/Master/texmf-dist/tex/latex/nicetext/makedoc.sty
+++ b/Master/texmf-dist/tex/latex/nicetext/makedoc.sty
@@ -4,7 +4,7 @@
 %% -- author-maintained in the sense of LPPL below -- 
 %% for preparing documentations from packages.
 
-\def\fileversion{0.41b}  \def\filedate{2011/10/12} 
+\def\fileversion{0.42}  \def\filedate{2011/11/19} 
 
 %% This file can be redistributed and/or modified under 
 %% the terms of the LaTeX Project Public License; either 
@@ -379,11 +379,17 @@
 %% \LaTeX, considering what is typical for a \LaTeX\ package as the 
 %% <input> one here:
 \newcommand*{\MakeDoc}[1]{%
+  \input{mdoccorr.cfg}%     %% 2011/11/05
+%% ... added for what `makedoc.tex' says about it.
+%% See `\make_doc_job' for TODOs about it. 
+%% Now also wondering: \ (i)~there are other ways to get the 
+%% correcting hook, so why forcing this here? \ 
+%% (ii)~different correcting hooks for different input files?---%
 %% In case of a ``header" (see below) we change into ``code mode":
   \ifnum\header_lines>\z@
         \WriteResult{\string\begin{mdPackageCode}}%
-        \PackageCodeTrue %% TODO both lines makedoc command!? 
-                         %%      2009/04/08
+        \PackageCodeTrue    %% TODO both lines makedoc command!? 
+                            %%      2009/04/08
   \else \PackageCodeFalse \fi
 %% The loop follows. There is a placeholder `\makd_doc_line_body' 
 %% that is predefined below and can be changed while processing the 
@@ -406,15 +412,28 @@
 %   \HeaderLines{0}% 
 %   \MainDocParser{\SectionLevelThreeParseInput}%% TODO!? 2009/04/08
 }
-%% |\MakeCloseDoc{<input>}| %% 2010/03/11
-%% just is a shorthand for 
+%% |\MakeCloseDoc{<input>}|                 %% 2010/03/11
+%% is a kind of shorthand for 
 %% \[`\MakeDoc{<input>}\CloseResultFile'\]  %% was MakeClose 2011/10/12
 %% where `\CloseResultFile' is from 'fifinddo'.
 \newcommand*{\MakeCloseDoc}[1]{\MakeDoc{#1}\CloseResultFile}
+%% Reimplementation using 'fifinddo' v0.5 failed:         %% 2011/11/19
+% \newcommand*{\MakeCloseDoc}{\FinalInputFiletrue\MakeDoc}
 %% `\MakeDoc' and `\MakeCloseDoc' actually \emph{process} 
 %% the <input> file, 
 %% depending on certain \emph{parameters} some of which are set 
 %% by the commands described next.
+%% 
+%% \subsubsection{Combining input and output}
+%% \[|\MakeSingleDoc[<out-ext>]{<in-output>.<in-ext>}|\] %% 2011/11/05
+%% generates `<in-output>.<out-ext>' from `<in-output>.<in-ext>', 
+%% using settings like `\MakeDoc'. The default for <out-ext> is `doc'.
+%% `\MakeSingleDoc' combines `\LaTeXresultFile'
+%% and `\MakeCloseDoc' with appropriate arguments. 
+%% (TODO: not so sure about dot vs.\ optional <in-ext>.)
+\newcommand*{\MakeSingleDoc}[2][doc]{\make_single_doc[#1]#2\@nil}
+\def\make_single_doc[#1]#2.#3\@nil{%
+    \LaTeXresultFile{#2.#1}\MakeCloseDoc{#2.#3}}
 %%
 %% \subsubsection{Preamble vs.\ main part of input file}
 %% A \LaTeX\ package typically has a ``header" or ``preamble" 
@@ -592,3 +611,5 @@ v0.41  2010/12/20   \ResetCodeLineNumbers defined globally
        2011/01/25   updated (C)
 v0.41a 2011/08/22   doc.: makedoc.cfg -> mdoccorr.cfg
 v0.41b 2011/10/12   doc.: MakeClose -> MakeDoc
+v0.42  2011/11/05   \MakeDoc reads mdoccorr.cfg, \MakeSingleDoc
+       2011/11/19   failing reimplementation of \MakeCloseDoc
diff --git a/Master/texmf-dist/tex/latex/nicetext/mdoccorr.cfg b/Master/texmf-dist/tex/latex/nicetext/mdoccorr.cfg
index 5ff8438a78e..f832ddedea9 100644
--- a/Master/texmf-dist/tex/latex/nicetext/mdoccorr.cfg
+++ b/Master/texmf-dist/tex/latex/nicetext/mdoccorr.cfg
@@ -1,4 +1,4 @@
-\ProvidesFile{mdoccorr.cfg}[2011/10/25
+\ProvidesFile{mdoccorr.cfg}[2011/12/03
               local typographical corrections with makedoc.sty]
 %% ... also demonstrates 'niceverb.sty'---see the typeset 
 %% documentation of the present file in `makedoc.pdf'.
@@ -10,28 +10,24 @@
 %% |\StartPrependingChain| initializes setup of a replacement 
 %% chain:
 \StartPrependingChain
-%% |\PrependExpandableAllReplacer{<id>}{<find>}{<subst>}|:
-\PrependExpandableAllReplacer{etc}{etc. }{etc.\ }
+%% |\PrependExpandableAllReplacer*{<find>}{<subst>}|:
+\PrependExpandableAllReplacer*{etc. }{etc.\ }
 %% ... you can keep inter-sentence space after `etc.'
 %% by a code line break.
-\PrependExpandableAllReplacer{Cf}{Cf. }{Cf.\ } %% 2011/01/12
-\PrependExpandableAllReplacer{cf}{cf. }{cf.\ } %% corr. 2010/03/23
+\PrependExpandableAllReplacer*{Cf. }{Cf.\ } %% 2011/01/12
+\PrependExpandableAllReplacer*{cf. }{cf.\ } %% corr. 2010/03/23
 %% ... but think of `cf.~'. Don't leave `cf.' at code line end!
-\PrependExpandableAllReplacer{rarr}{->}{$\to$}      %% 2010/11/06
-\PrependExpandableAllReplacer{larr}{<-}{$\gets$}    %% 2010/11/06
-% \PrependExpandableAllReplacer{dots}{...}{$\dots$}
-%% ... 2010/11/24 ``symmetric" variant of `\textellipsis':
-%% allow extra space at line end. 
-%% % `MD' macro 2011/10/13 
-%% % (final dot separates; TODO provide generally):
-% \gdef\MDtwodots{.\kern\fontdimen3\font.\kern\fontdimen3\font}
-\PrependExpandableAllReplacer{dots}{...}{\textellipsis\unkern }
+\PrependExpandableAllReplacer*{->}{$\to$}      %% 2010/11/06
+\PrependExpandableAllReplacer*{<-}{$\gets$}    %% 2010/11/06
+% \PrependExpandableAllReplacer{...}{...}{$\dots$}
+%% Allow extra space at line end (bug fix `{}' 2011/12/03): 
+\PrependExpandableAllReplacer*{...}{\textellipsis\unkern{}}
 %% 2011/10/13: original `\dots' correct before punctuation:
 % \PrependExpandableAllReplacer{dots,}{...,}{\dots,}
-\PrependExpandableAllReplacer{dots)}{...)}{\dots)}  %% 2011/10/25
-\PrependExpandableAllReplacer{dots:}{...:}{\dots:}
-\PrependExpandableAllReplacer{dots }{... }{\textellipsis\unkern\ }
-\PrependExpandableAllReplacer{TODO}{TODO}{\textcolor{blue}{TODO}}
+\PrependExpandableAllReplacer*{...)}{\dots)}  %% 2011/10/25
+\PrependExpandableAllReplacer*{...:}{\dots:}
+\PrependExpandableAllReplacer*{... }{\textellipsis\unkern\ }
+\PrependExpandableAllReplacer*{TODO}{\textcolor{blue}{TODO}}
 %% ... chain starts here, and here |\MakeDocCorrectHook| (silently) 
 %% enters through a default variant |\SetCorrectHookJobLast|
 %% of |\SetCorrectHookJob{<id>}|:
@@ -56,3 +52,5 @@ HISTORY
 2011/09/13  \providecommand for dialogues
 2011/10/13  \MDtwodots, without \PXAR, `...,' `...:'
 2011/10/25  \textellipsis\unkern from csquotes instead, `...)'
+2011/11/13  \PrependExpandableAllReplacer*
+2011/12/03  bug fix for 2011/10/25 at line ends 
diff --git a/Master/texmf-dist/tex/latex/nicetext/niceverb.sty b/Master/texmf-dist/tex/latex/nicetext/niceverb.sty
index 8f88e1e46ce..4150de49265 100644
--- a/Master/texmf-dist/tex/latex/nicetext/niceverb.sty
+++ b/Master/texmf-dist/tex/latex/nicetext/niceverb.sty
@@ -1,5 +1,5 @@
 \NeedsTeXFormat{LaTeX2e}[1994/12/01]
-\ProvidesPackage{niceverb}[2011/09/09 v0.44
+\ProvidesPackage{niceverb}[2011/12/05 v0.44
                            minimize doc markup (UL)] 
 
 %% Copyright (C) 2009-2011 Uwe Lueck, 
@@ -514,22 +514,25 @@
 %% (for the documentation of the present package).
 \newcommand*{\HardVerbBox}{\_no_nice_meta_verb_true  \gen_cmd_box}
 \newcommand*{\gen_cmd_box}{%
-  \bgroup 
-    \let\niceverb_egroup\nice_collect_verb_egroup
-    \global %% TODO!? for \cmdboxitem 2010/03/15
-    %% <- TODO replace \niceverb_egroup by parameter, 
-    %%         save one nesting level 2010/03/15
-    \setbox\niceverb_savebox \hbox\bgroup 
-      \if_no_nice_meta_verb_ 
-            \expandafter \HardNVerb
-      \else \expandafter \NVerb     \fi}
+%   \ifvmode\let\niceverb_boxtype\VerticalCmdBox      %% 2011/11/05
+%      \else\let\niceverb_boxtype\InlineCmdBox   \fi
+  \let\niceverb_egroup\nice_collect_verb_egroup
+  \setbox\niceverb_savebox \hbox\bgroup 
+    \if_no_nice_meta_verb_ 
+          \expandafter \HardNVerb
+    \else \expandafter \NVerb     \fi}
 \newcommand*{\nice_collect_verb_egroup}{%
-      \egroup \egroup
-    \ifvmode \expandafter \VerticalCmdBox
-    \else    \ifmmode \hbox \fi 
-             \expandafter \InlineCmdBox \fi
-    {\box\niceverb_savebox}%
-  \niceverb_normal_egroup}
+    \egroup \egroup
+  \ifvmode \expandafter \VerticalCmdBox
+  \else    \ifmmode \hbox \fi
+           \expandafter \InlineCmdBox \fi
+%   \ifmmode\hbox\fi \niceverb_boxtype                %% 2011/11/05
+   {\box\niceverb_savebox}%
+%% Modifying invocation of `\niceverb_normal_egroup' 2011/11/05
+%% according to remark of 2010/03/15 for saving nesting level:
+  \ifmmode\else\@\fi
+  \let\niceverb_egroup\niceverb_normal_egroup
+}
 %% |\nvCmdBox| will be the permanent alias for \qtd{&|}.
 \newcommand*{\nvCmdBox}{\GenCmdBox\|}
 %% |\VerticalCmdBox{<content>}| 
@@ -542,7 +545,8 @@
 %% The user can choose later by some `\renewcommand'. 
 %% We do the perhaps most essential thing here 
 %% (again cf. `\begin_min_verb'):{\sloppy\par}
-\newcommand*{\VerticalCmdBox}{\leavevmode\null\InlineCmdBox}
+\newcommand*{\VerticalCmdBox}{\leavevmode\InlineCmdBox}
+%% (2011/11/05 removing `\null'.)
 %% The command declaration boxes in the documentation of 
 %% Nicola Talbot's \ctanpkgref{datatool}
 %% would be an especially nice realization of `\VerticalCmdBox'.
@@ -827,4 +831,7 @@ v0.43  2011/05/09   \gt, \lt
        2011/08/20   `r0.42', `v0.43'
 with nicetext RELEASE r0.43
 v0.44  2011/09/09   \AddQuotes, \DontAddQuotes
-
+with nicetext RELEASE r0.44
+v0.45  2011/11/05   mod. \niceverb_collect_egroup/\VerticalCmdBox, 
+                    tried \output problem without avail
+       2011/12/05   clarified "r0.44"