summaryrefslogtreecommitdiff
path: root/Master
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2011-12-05 23:59:28 +0000
committerKarl Berry <karl@freefriends.org>2011-12-05 23:59:28 +0000
commit649482075a5882440e6ed9b1e530122baa49fb5b (patch)
tree3d0483b6174d317a4b3cf36b19b20db5d62f9206 /Master
parent447c1d22bf02017dfb91166824a5d15cb643ed04 (diff)
nicetext 044 (5dec11)
git-svn-id: svn://tug.org/texlive/trunk@24771 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master')
-rw-r--r--Master/texmf-dist/doc/latex/nicetext/ANNOUNCE.txt46
-rw-r--r--Master/texmf-dist/doc/latex/nicetext/CHANGE.LOG48
-rw-r--r--Master/texmf-dist/doc/latex/nicetext/CHANGE.txt48
-rw-r--r--Master/texmf-dist/doc/latex/nicetext/RELEASE044.txt27
-rw-r--r--Master/texmf-dist/doc/latex/nicetext/SrcFILEs.txt20
-rw-r--r--Master/texmf-dist/doc/latex/nicetext/demo/sample.tex2
-rw-r--r--Master/texmf-dist/doc/latex/nicetext/fifinddo.pdfbin469082 -> 479900 bytes
-rw-r--r--Master/texmf-dist/doc/latex/nicetext/makedoc.pdfbin478364 -> 480923 bytes
-rw-r--r--Master/texmf-dist/doc/latex/nicetext/niceverb.pdfbin446369 -> 446779 bytes
-rw-r--r--Master/texmf-dist/source/latex/nicetext/fifinddo.tex24
-rw-r--r--Master/texmf-dist/source/latex/nicetext/makedoc.tex23
-rw-r--r--Master/texmf-dist/source/latex/nicetext/niceverb.tex7
-rw-r--r--Master/texmf-dist/source/latex/nicetext/srcfiles.tex4
-rw-r--r--Master/texmf-dist/tex/latex/nicetext/fifinddo.sty297
-rw-r--r--Master/texmf-dist/tex/latex/nicetext/makedoc.cfg21
-rw-r--r--Master/texmf-dist/tex/latex/nicetext/makedoc.sty31
-rw-r--r--Master/texmf-dist/tex/latex/nicetext/mdoccorr.cfg34
-rw-r--r--Master/texmf-dist/tex/latex/nicetext/niceverb.sty43
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
Binary files differ
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
Binary files differ
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
Binary files differ
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"