dowit (21nov12)

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

12 files changed, 625 insertions, 170 deletions

diff --git a/Master/texmf-dist/doc/generic/dowith/Announce.txt b/Master/texmf-dist/doc/generic/dowith/Announce.txt
new file mode 100644
index 00000000000..2636036d45e
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/dowith/Announce.txt
@@ -0,0 +1,43 @@
+
+r0.3a corrects TDS -- "generic", not "latex"
+________________________________________________________________
+
+Iterate stuff on argument list in TeX's gullet (no separators)
+
+r0.3 2012/11/19
+
+ * new `domore.sty' enhances `dowith.sty', allowing iterated
+   application of multi-parameter macros and inserting 
+   "separator material".
+
+ * `dowith.sty' documentation correction: according to Knuth, 
+   this is TeX's "gullet", while some authors have called it 
+   "TeX's mouth", see quotations in section 1.4 of `dowith.pdf'.
+
+ * `dowith.sty' (v0.3) "generic" now by `plainpkg' 
+   (instead of imitating `german.sty').
+
+ * `dowith.sty' documentation `dowith.pdf' furthermore reworked.
+
+________________________________________________________________
+
+Iterate command on argument list in TeX's mouth (no separators)
+
+r0.22 2012/06/03
+
+Documentation
+  (i) discusses what <cmd> in \DoWith<cmd>... can be
+ (ii) extends comparison with \@tfor
+(iii) has some contentual corrections 
+ (iv) celebrates 25 years of Alois Kabelschacht's idea
+________________________________________________________________
+
+Iterate macro on argument list in TeX's mouth – no separators
+
+r0.21c 2012/05/18
+
+  (i) @ fix for "generic" and `typeoutfileinfo' 
+ (ii) documentation much extended to clarify kind of "items," 
+      distinguishing tokens from code
+(iii) `dowith.RLS' provides release info as LaTeX file info
+
diff --git a/Master/texmf-dist/doc/generic/dowith/README b/Master/texmf-dist/doc/generic/dowith/README
index 66b577a4869..8f7664cbe35 100644
--- a/Master/texmf-dist/doc/generic/dowith/README
+++ b/Master/texmf-dist/doc/generic/dowith/README
@@ -1,36 +1,43 @@
 
-             README for the `dowith' package
-    Apply Command to Each Item in a List of Arguments 
-                     in TeX's Mouth
-                (C) Uwe Lueck 2012/06/03
+               README for the `dowith' package
+
+      Apply Command to Each Item in a List of Arguments 
+               in TeX's Macro Expansion Buffer
+
+                  (C) Uwe Lueck 2012/11/19
 
 
 `dowith.sty' provides macros for applying a command to all items
 in a list of macro arguments, and also for extending and reducing 
 macros storing such lists. "Brace groups" are single items of 
-such lists, as opposed to token lists. Applications in mind 
-belonged to LaTeX, but the package should work with other formats 
-as well. Loop and list macros in other packages are discussed. 
-Iteration is implemented within "TeX's mouth," so works within 
-\write as with `blog.sty'. There is no need for e-TeX.
+such lists, as opposed to token lists. Iteration is implemented 
+within TeX's expansion processor, so works within \write as with 
+`blog.sty'. Loop and list macros in other packages are discussed 
+in the documentation. There is no need for e-TeX to which some
+of them refer. 
+
+`domore.sty' extends `dowith.sty' in order to apply multi-
+parameter macros to a list and to insert "separator material" 
+between resulting items. One application has been generating 
+inline lists of links that are separated by ` | '.
 
-Privately, I have used macros for a more powerful package where 
-the command may have more than one argument and there is a 
-"separator" in output, such as a comma or a vertical stroke 
-between links. This extended package may soon appear here as well.
+The packages are "generic", i.e., should also work with Plain TeX, 
+relying on the `plainpkg' package for some minimal LaTeX-like 
+behaviour.
 
 KEYWORDS: programming structures; 
           macro programming, loops, list macros
 
 RELATED PACKAGES: catoptions, etextools, etoolbox, forarray, 
-forloop, multido, moredefs, lmake, texapi, xfor, xspace
+forloop, loops, multido, moredefs, lmake, texapi, xfor, xspace
 
 LICENSE:
 
-The package file `dowith.sty' and the documentation files
-`dowith.pdf' and `dowith.tex' can be redistributed and/or
-modified under the terms of the LaTeX Project Public License;
-either version 1.3c of the License, or any later version, see
+The package file `dowith.sty', `domore.sty' and the 
+documentation files `dowith.pdf', `domore.pdf', `dowith.tex', 
+and `domore.tex' can be redistributed and/or modified under the 
+terms of the LaTeX Project Public License; either version 1.3c 
+of the License, or any later version, see
 
     http://www.latex-project.org/lppl.txt
 
diff --git a/Master/texmf-dist/doc/generic/dowith/SrcFILEs.txt b/Master/texmf-dist/doc/generic/dowith/SrcFILEs.txt
new file mode 100644
index 00000000000..8080bd8ebd7
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/dowith/SrcFILEs.txt
@@ -0,0 +1,19 @@
+
+ *File List*
+  dowith.RLS  2012/11/20  r0.3a  doc. mouth -> gullet, `domore.sty'; TDS corr.
+  dowith.sty  2012/11/05  v0.3   simple list loop (UL)
+  domore.sty  2012/11/19  v0.3   dowith extended (UL)
+  dowith.tex  2012/11/19   --    documenting dowith.sty
+  domore.tex  2012/11/19   --    documenting domore files
+srcfiles.tex  2012/11/19   --    file infos -> SrcFILEs.txt
+ ---USED.---   --  -- --   --     --
+fifinddo.sty  2012/11/17  v0.61  filtering TeX(t) files by TeX (UL)
+ makedoc.sty  2012/08/28  v0.52  TeX input from *.sty (UL)
+niceverb.sty  2012/09/27  v0.5   minimize doc markup (UL)
+ makedoc.cfg  2012/11/13   --    documentation settings
+mdoccorr.cfg  2012/11/13   --    `makedoc' local typographical corrections
+ ***********
+
+ List made at 2012/11/20, 10:32
+ from script file srcfiles.tex
+
diff --git a/Master/texmf-dist/doc/generic/dowith/domore.pdf b/Master/texmf-dist/doc/generic/dowith/domore.pdf
new file mode 100644
index 00000000000..6d59d8dc3d3
--- /dev/null
+++ b/Master/texmf-dist/doc/generic/dowith/domore.pdf
diff --git a/Master/texmf-dist/doc/generic/dowith/dowith.pdf b/Master/texmf-dist/doc/generic/dowith/dowith.pdf
index 48d28085e94..36c88ec398c 100644
--- a/Master/texmf-dist/doc/generic/dowith/dowith.pdf
+++ b/Master/texmf-dist/doc/generic/dowith/dowith.pdf
diff --git a/Master/texmf-dist/source/generic/dowith/SrcFILEs.txt b/Master/texmf-dist/source/generic/dowith/SrcFILEs.txt
deleted file mode 100644
index b55be1a0d0b..00000000000
--- a/Master/texmf-dist/source/generic/dowith/SrcFILEs.txt
+++ /dev/null
@@ -1,16 +0,0 @@
-
- *File List*
-  dowith.sty  2012/06/04  v0.22  simple list loop (UL)
-  dowith.tex  2012/06/03   --    documenting dowith.sty
-fifinddo.sty  2012/03/17  v0.51  filtering TeX(t) files by TeX (UL)
- makedoc.sty  2012/04/03  v0.51  TeX input from *.sty (UL)
-niceverb.sty  2011/12/05  v0.44  minimize doc markup (UL)
- makedoc.cfg  2012/05/10   --    documentation settings
-mdoccorr.cfg  2011/12/03   --    makedoc local typographical corrections
-srcfiles.tex  2012/05/20   --    file infos -> SrcFILEs.txt
-  dowith.RLS  2012/06/03  r0.22  v0.22 arg. {}; doc.: catoptions
- ***********
-
- List made at 2012/06/04, 12:29
- from script file srcfiles.tex
-
diff --git a/Master/texmf-dist/source/generic/dowith/domore.tex b/Master/texmf-dist/source/generic/dowith/domore.tex
new file mode 100644
index 00000000000..4f44ec2977b
--- /dev/null
+++ b/Master/texmf-dist/source/generic/dowith/domore.tex
@@ -0,0 +1,167 @@
+\ProvidesFile{domore.tex}[2012/11/19 documenting domore files]
+\title{\pkg{domore}\\---\\Some More Commands for Lists of Tokens}
+% \listfiles
+{ \RequirePackage{makedoc} \ProcessLineMessage{}
+  \renewcommand\mdSectionLevelOne  {\string\subsection}
+  \renewcommand\mdSectionLevelTwo  {\string\subsubsection}
+  \MainDocParser{\SectionLevelTwoParseInput}
+  \HeaderLines{17} 
+  \MakeSingleDoc{domore.sty}
+  \MakeSingleDoc{reversdo.sty} 
+  \MakeSingleDoc{domodes.sty} 
+}
+\documentclass[fleqn]{article}%% TODO paper dimensions!?
+\input{makedoc.cfg} %% shared formatting settings
+\MDkeywords{Macro programming, programming structures, 
+            loops, list macros}
+\newcommand*{\headersec}{%
+    \subsection{Package File Header---\pkg{plainpkg} and Legalese}}
+\usepackage{catchdq} \catchdqs                  %% 2012/11/19
+\AddToMacro{\mdStartPackageCode}{\MakeOther\"}  %% 2012/11/19
+% \newcommand*{\TODO}[1][]{%
+%     \textcolor{blue}{\acro{TODO}\ifx&#1&\else\space\fi#1}}
+%% <- rm. 2012/11/05, TODO -> makedoc.cfg
+\newcommand*{\ctanpkgdref}[1]{%                 %% 2012/11/19
+    \ctanpkgref{#1}\,\foothttpurlref{ctan.org/pkg/#1}}
+\newif\ifmultmore                               %% 2012/11/19
+\sloppy
+\begin{document}
+\maketitle
+\begin{MDabstract}
+\ifmultmore
+  This document describes packages that do similar things 
+  as the 'dowith' package or extend it.
+\else
+  'domore.sty' is a package that enhances 'dowith.sty''s 
+  `\DoWith' (without assignments)
+  and `\setdo' commands for applying something 
+  (e.g., `\do') to each item of an "arglist".
+  Each item may consist of two or more arguments for a macro, 
+  and some "separator" material may be inserted between the 
+  applications to items. A practiced application has been 
+  generating inline lists of links that are separated 
+  by \qtdcode{~\string|~}.
+  'domore.sty' is (to some extent) format-independent 
+  by means of the \ctanpkgref{plainpkg} and 'stacklet' packages. 
+\fi
+% \MDaddtoabstract{Required Packages}
+% \ctanpkgref{plainpkg}, 'stacklet'
+\MDaddtoabstract{Related Packages} cf. `dowith.pdf'.
+\end{MDabstract}
+\tableofcontents
+
+\edef\domore{\ifmultmore\MetaVar domore>\else domore\fi}
+% \section{Shared Features of Usage}
+\ifmultmore
+  \section{Shared Features of Usage}
+  All the packages described in this document 
+  are "\pkg{plainpkg} packages" 
+\else
+  \section{Making 'domore.sty' Available}
+  The 'domore' package is a "\pkg{plainpkg} package"
+\fi
+in the sense of the 
+\ctanpkgdref{plainpkg}
+documentation that exhibits details of what is summarized here. 
+Therefore:
+\begin{itemize}
+  \item \ifmultmore All of them require \else It is required \fi
+        that \TeX\ finds `plainpkg.tex' 
+        as well as `stackrel.sty' from the 
+        \ctanpkgdref{catcodes} bundle.
+  \item In order to load \file{\domore.sty}%%%
+        \ifmultmore\ (where \domore\ is `domore', `domodes', or `reversdo')\fi, 
+        type
+    \begin{description}
+        \ifmultmore\cmdboxitem|\usepackage{<domore>}|
+               \else\cmdboxitem|\usepackage{domore}|      \fi
+        \ within a \LaTeX\ document 
+        preamble, \ 
+        \ifmultmore\cmdboxitem|\RequirePackage{<domore>}| 
+               \else\cmdboxitem|\RequirePackage{domore}|  \fi
+        \ in a "\pkg{plainpkg} package", or \ 
+        \ifmultmore\cmdboxitem|\input <domore>.sty| 
+               \else\cmdboxitem|\input domore.sty|        \fi
+    \end{description}
+        $\dots$ \ or perhaps `\input{<domore>.sty}'? 
+\end{itemize}
+
+\section{Remark on the Style of Code Documentation}
+In `dowith.pdf', the documentation of the 'dowith' package,
+in the section about "\TeX's tokens," I have tried to explain 
+the difference between \TeX\ input code and the tokens that 
+arise from it. In order to really understand what packages 
+in the 'dowith' bundle do, one should think of the behaviour 
+of the \emph{tokens}. For convenience however, I may rather 
+fall back into the usual confusion here. After reading the 
+documentation `dowith.pdf' of `dowith.sty', you may be able 
+to guess successfully what is meant below.
+
+% \section{Overview of Packages Described in \file{\jobname.pdf}}
+\ifmultmore
+  \section{Overview of Packages Described in \file{\jobname.pdf}}
+  \label{sec:over}
+  The present document describes the packages provided by the 
+  \ctanpkgref{dowith} bundle apart from 'dowith.sty' itself 
+  for applying something to each item from some list. 
+  \begin{enumerate}
+    \item 
+\else
+  \section{Overview of Commands}
+\fi
+        \strong{\pkg{domore.sty}} provides a more powerful version 
+        of 'dowith.sty''s 
+        \[|\DoWith{<repeat>}<args>\StopDoing|\]
+        acting on an "arglist" <args>
+        where <repeat> may be more complex than with 'dowith.sty'. 
+        Based on this, another variant |\DoWithMore| of `\DoWith' 
+        is provided where <repeat> may be a macro with more than 
+        one argument. With \LaTeX\ e.g., <repeat> may be |\do| 
+        defined by \[|\setdo[<digit>]<opt>{<replace>}|\] 
+        an extension of 'dowith.sty''s `\setdo'.
+        Further, 
+        \[|\DoSeparateWith{<repeat>}{<sep>}<args>\StopDoing|\]
+        inserts "separator material" <sep> between the applications 
+        of <repeat> to the items in <args>. Another 
+        |\DoSeparateWithMore| combines the features of the two 
+        previous macros. I have used this with 'blog.sty' from 
+        the \ctanpkgref{morehype} bundle for generating inline 
+        lists of links, separated by something like \qtdcode{~\string|~}, 
+        in \acro{HTML} documents. 
+
+        As auxiliaries, variants |\@firstsecondoftwo| and 
+        |\@secondfirstoftwo| of \LaTeX's `\@firstofone' are introduced.
+\ifmultmore 
+  \end{enumerate}
+
+  \section{'domore.sty'}
+  An overview of what 'domore.sty' provides has been given in 
+  Section~\ref{sec:over}. 
+  For details, see the comments to the package's code below.
+\else
+
+  For details, see the comments to the package's code below.
+  \section{Contents of 'domore.sty'}
+\fi
+\headersec
+\input{domore.doc}
+
+\MakeOther\"
+\ifmultmore
+\section{'domodes.sty'}
+See Section~\ref{sec:domodes-cmds} for the commands provided.
+\headersec
+\input{domodes.doc}
+
+\section{'reversdo.sty'}
+See Section~\ref{sec:reversdo-cmds} for the commands provided.
+\headersec
+\input{reversdo.doc}
+
+\fi
+\end{document}
+
+VERSION HISTORY
+
+2012/10/23    for v0.2   started
+2012/11/05ff. for v0.3
diff --git a/Master/texmf-dist/source/generic/dowith/dowith.tex b/Master/texmf-dist/source/generic/dowith/dowith.tex
index a0cb6ac3099..eb099d1e5e3 100644
--- a/Master/texmf-dist/source/generic/dowith/dowith.tex
+++ b/Master/texmf-dist/source/generic/dowith/dowith.tex
@@ -1,17 +1,17 @@
-\ProvidesFile{dowith.tex}[2012/06/03 documenting dowith.sty]
+\ProvidesFile{dowith.tex}[2012/11/19 documenting dowith.sty]
 \title{%%%\kern-\baselineskip
        \textsf{\huge dowith.sty}\\---\\Apply Command to
 %        Elements of Lists without Separators\,---\,%%% 2012/05/14
 %        and without Iterator\thanks{This
        %% 2012/05/15, "in" 2012/05/18:
-       Each Item \\ in a List of Arguments in ``\TeX's Mouth"\thanks{This
+       Each Item \\ in a List of Arguments in ``\TeX's Gullet"\thanks{This
        document describes version
        \textcolor{blue}{\UseVersionOf{\jobname.sty}}
        of \textsf{\jobname.sty} as of \UseDateOf{\jobname.sty}.}}
 { \RequirePackage{makedoc} \ProcessLineMessage{}
   \renewcommand*\mdSectionLevelOne{\string\subsection}
   \renewcommand*\mdSectionLevelTwo{\string\subsubsection}
-  \MakeJobDoc{16}%% 2011/09/06
+  \MakeJobDoc{18}%% 2012/11/05 for v0.3
   {\SectionLevelTwoParseInput}  }
 \documentclass[fleqn]{article}%% TODO paper dimensions!?
 \input{makedoc.cfg}    %% shared formatting settings
@@ -25,7 +25,11 @@
     pdfsubject=documenting dowith.sty
 }%% 2011/08/22 
 \usepackage{fixltx2e}                       %% \textsubscript 2012/05/17b
+%% <- TODO with `lmodern'?
+\newcommand*{\ctanpkgdref}[1]{%                             %% 2012/11/19
+    \ctanpkgref{#1}\,\foothttpurlref{ctan.org/pkg/#1}}
 \makeatletter                                   %% etc. 2012/05/17b
+%% TODO `actcodes'!? 2012/11/02
   \newcommand*{\GetOtherChar}[2]{% 
     \@ifdefinable#1{%
         \edef#1{\expandafter\@gobble\string#2}}}
@@ -67,9 +71,10 @@
 \newcommand*{\pdots}{~.\kern\fontdimen3\font
                       .\kern\fontdimen3\font. }
 \providecommand*{\Chi}{\mathrm{X}}
+\renewcommand*{\httpprefix}{\theHTTPprefix}
 \begin{document}
 \maketitle
-\begin{MDabstract}\noindent
+\begin{MDabstract}
 This package provides macros for applying a 
 %% mod. 2012/05/15:
 % ``command" <cmd> to all items of a list $<arg-1><arg-2>\dots<arg-$n$>$
@@ -78,11 +83,12 @@ This package provides macros for applying a
 % such as `\DoWithAllIn{<cmd>}{<list-macro>}', 
 and also for extending and reducing macros storing such lists.
 ``Brace groups" are single items of such lists, as opposed to 
- token lists. 
+token lists. Iteration is implemented within \TeX's expansion 
+processor, so works within `\write' as with 'blog.sty'.
  %%% ---pleading for mathematical rigour in \TeX ology!)    %% rm. 2012/05/17b
-Applications in mind belonged to \LaTeX, but the package should work 
-with other formats as well.
-Loop and list macros in other packages are discussed.
+% Applications in mind belonged to \LaTeX, but the package should work 
+% with other formats as well.
+Loop and list macros in other packages are discussed in the documentation.
 % %% 2012/05/09:
 % There is an emphasis on expandability 
 % %% mod./add. 2012/05/15:
@@ -90,14 +96,19 @@ Loop and list macros in other packages are discussed.
 %  essential within \cs{write} as with \CtanPkgRef{morehype}{blog.sty}),
 % without relying on \CtanPkgRef{e-tex}{$\varepsilon$-\TeX}.
 %% 2012/05/18:
-Iteration is implemented within ``\TeX's mouth," so works within 
-`\write' as with \CtanPkgRef{morehype}{blog.sty}. There is no need for 
-\CtanPkgRef{e-tex}{$\varepsilon$-\TeX}.
+% Iteration is implemented within ``\TeX's mouth," so works within 
+% `\write' as with \CtanPkgRef{morehype}{blog.sty}. 
+There is no need for \CtanPkgRef{e-tex}{$\varepsilon$-\TeX} to which 
+some of them refer.
+
+The package is ``generic," i.e., should also work with Plain \TeX\ 
+or even other formats, relying on the \ctanpkgref{plainpkg} package 
+for some minimal LaTeX-like behaviour.
 
 \MDaddtoabstract{Related packages}
 \let\pkg\ctanpkgref     \pkg{catoptions},
-\pkg{etextools}, \pkg{etoolbox}, \pkg{forarray}, 
-\pkg{forloop}, \pkg{multido}, \pkg{moredefs}, \pkg{lmake}, 
+\pkg{etextools}, \pkg{etoolbox}, \pkg{forarray}, \pkg{forloop}, 
+\pkg{loops}, \pkg{multido}, \pkg{moredefs}, \pkg{lmake}, 
 \pkg{texapi}, \pkg{xfor}, \pkg{xspace}
 \end{MDabstract}
 \tableofcontents
@@ -110,17 +121,21 @@ The file 'dowith.sty' is provided ready, installation only requires
 putting it somewhere where \TeX\ finds it
 (which may need updating the filename data
  base).\urlfoot{ukfaqref}{inst-wlcf}           %% corr. 2011/02/08
+The packages \ctanpkgdref{plainpkg}
+and 'stacklet' (\ctanpkgref{catcodes})\foothttpurlref{ctan.org/pkg/catcodes} 
+must be installed as well.
 
-With \LaTeX, 
-you load 'dowith.sty' (as usually) by
-\begin{verbatim}
-  \usepackage{dowith}
-\end{verbatim}
-below the `\documentclass' line(s) and above `\begin{document}'.
-However, the package can also be used with other formats, just
-\begin{verbatim}
-  \input dowith.sty
-\end{verbatim}
+As to calling (loading): 'dowith' is a ``\pkg{plainpkg} package" 
+in the sense of the \ctanpkgref{plainpkg}
+documentation that you may consult for details.
+So roughly, 
+\begin{itemize}
+  \item load it by \ |\usepackage{dowith}| \ if you can, 
+  \item otherwise by \ |\RequirePackage{dowith}| \\
+        (perhaps from within another ``\pkg{plainpkg} package"), 
+  \item or by \ |\input dowith.sty| 
+  \item or even by \ |\input{dowith.sty}|~\dots
+\end{itemize}
 
 % \section{Example}
 
@@ -241,52 +256,117 @@ are ignored when a macro looks for its argument.    %% 2012/05/17b
 % 
 % But keep in mind that this ``intuitive" understanding essentially is wrong.
 
+\subsection{Anatomy of \TeX}
+The documentation of v0.22 as of 2012-06-04 said that the package 
+is about ``lists in \TeX's mouth." However, this was very wrong. 
+I believed it following Alan Jeffrey's paper ``Lists in \TeX's Mouth",\footnote{%
+    Alan Jeffrey: \tugbartref{tb11-2/tb28jeffrey}{``Lists in \TeX's Mouth,"} 
+    \acro{TUG}boat Vol.~11 (1990), No.~2, pp.~237--245), 
+    \urlhttpref{tug.org/TUGboat/tb11-2/tb28jeffrey.pdf}.}
+in whose Section~2 you read:
+\begin{quote}\it
+  \TeX's programming facilities come in two forms---there 
+  are \TeX's \emph{macros} which are expanded in its
+  mouth, and some additional \emph{assignment} operations
+  like \cs{def} which take place in the stomach.
+\end{quote}
+The macros that Jeffrey lists and describes in that article can be 
+obtained as a \acro{CTAN} package 
+\ctanpkgref{lambda-lists}.\footnote{\urlhttpref{ctan.org/pkg/lambda-lists}} 
+If you follow the link given here (in the footnote), 
+you currently (2012-11-03) read about this package:
+\begin{quote}\it
+    These list-processing macros avoid the reassignments 
+    employed in the macros shown in Appendix D of the TeXbook: 
+    all the manipulations take place in what Knuth is pleased to 
+    call ``TeX's mouth".
+\end{quote}
+But Knuth doesn't. On page 267 of \TTb, you read:
+\begin{quote}\it
+  Chapter 7 has described the process by which input files
+  are converted to lists of tokens in \TeX's ``mouth,"
+  and Chapter 20 explained how expandable tokens are converted
+  to unexpandable ones in \TeX's ``gullet" by a process 
+  similar to regurgitation.
+\end{quote}
+I.e., the ``mouth" is \TeX's ``tokenizer," the inner part of what 
+van Eijkhout calls \TeX's ``input processor" on, e.g., p.~15 of his 
+\meta{\TeX~by Topic}.\footnote{It is available as a \acro{CTAN} package 
+    \ctanpkgref{texbytopic} at \urlhttpref{ctan.org/pkg/texbytopic}.}
+The exact rules the tokenizer follows are described on pp.~46f.\ 
+(Chapter~8!) of \TTb.
+\emph{Macro expansion} takes place in \TeX's \emph{``gullet"}, 
+which van Eijkhout calls \TeX's ``expansion processor" (p.~16). 
+Abrahams, Hargreaves, and Berry follow Knuth's terminology on
+pp.~16 and 46f.\ of their \meta{\TeX~for the Impatient}.\footnote{It 
+    is available as \acro{CTAN} package \ctanpkgref{impatient}, 
+    \urlhttpref{ctan.org/pkg/impatient}.} 
+% Only Jeffreys and my wrong old documentation say this were 
+% ``\TeX's mouth"---and I made the same mistake with the 
+% \ctanpkgref{bitelist} package.
+%% <- 2012/11/19 ->
+
+\TeX's gullet has been called ``\TeX's mouth" also 
+in the documentation of my \ctanpkgdref{bitelist} package and 
+in the documentation of the package \ctanpkgdref{bibleref-mouth}.
+
+Moreover, I should have clarified that Jeffrey's paper deals with 
+``lists" in some general, rather abstract sense, different from 
+the kind of lists the present documentation tries to characterize 
+as the objects for 'dowith'.
+
 \subsection{\TeX's Tokens}
 \label{sec:toks}
 
 % The \emph{\TeX\ macro writer} understanding \TeX\ properly 
 % does not really think of arglists. \TeX perts instead think of 
-What \TeX nically matters is
-what happens in ``\TeX's mouth,"\footnote{Cf.~\TTbp.~46.} 
-as some authors have suggested a metaphor,\footnote{%
-    Alan Jeffrey: \tugbartref{tb11-2/tb28jeffrey}{``Lists in \TeX's Mouth,"} 
-    TUGboat Vol.~11 (1990), No.~2, pp.~237--245), 
-    \urlhttpref{tug.org/TUGboat/tb11-2/tb28jeffrey.pdf}.}
-or somewhere deeper. 
-The 'dowith' package is a tool to control those events
-(and actually, it is confined to \TeX's mouth). 
+% What \TeX nically matters is
+% what happens in ``\TeX's mouth,"\footnote{Cf.~\TTbp.~46.} 
+% as some authors have suggested a metaphor,\footnote{%
+The 'dowith' package is a tool that affects the order of tokens in 
+\TeX's gullet.
 
 \begin{smallpar}
-The ``characters you type" are somewhere in front of ``\TeX's mouth", 
-while \emph{in} \TeX's mouth, there are \emph{tokens}. 
-Before \TeX\ \emph{swallows} them, it often manipulates them 
-in some ways, after they got \emph{into} its mouth.
-
-More formally, \TeX\ has a \emph{character buffer.}
-It forms a single token from an initial segment of the buffer content---unless 
-there is a special situation with blank spaces or something pathological.
-When an \emph{escape character}, as the backslash usually is one, 
-has been noticed recently (that isn't followed by another one immediately), 
-the character buffer may need to be feeded from more outside, 
-until it contains enough material to form a token from. 
-The character(s) \emph{after} the escape character until 
-some delimiting character form a \emph{string} that is the 
-\emph{name} of the token that is formed.
-What has been used to form a token is removed from the character buffer.
+The ``characters you type" enter ``\TeX's mouth" line by line, 
+in a slightly modified appearance. Each line forms a \emph{string}.
+\TeX\ takes initial substrings away from it and turns them 
+into \emph{tokens} that are appended to the right of \TeX's 
+\emph{expansion buffer} (``gullet").
+
+%% Removing 2012/11/04:
+% More formally, \TeX\ has a \emph{character buffer.}
+% It forms a single token from an initial segment of the buffer content---unless 
+% there is a special situation with blank spaces or something pathological.
+% When an \emph{escape character}, as the backslash usually is one, 
+% has been noticed recently (that isn't followed by another one immediately), 
+% the character buffer may need to be feeded from more outside, 
+%% <- especially wrong, 2012/11/04
+% until it contains enough material to form a token from. 
 
 There are \emph{two kinds of tokens} here: \emph{named} tokens 
 and \emph{character} tokens. ``Named" tokens usually are referred
 to as ``control sequence tokens" or just ``control sequences"---I~really 
 want to avoid those horrible confusions from \TTb.
-There never are any ``parameter tokens" in \TeX's mouth 
+There never are any ``parameter tokens" in \TeX's gullet 
 (perhaps unless one considers a one-step macro expansion 
  a two-or-more-step procedure).
+%  merged 2012/11/04
+%% Moving down 2012/11/04
+The character(s) \emph{after} the escape character until 
+some delimiting character form a \emph{string} that is the 
+\emph{name} of the token that is formed---a \emph{named} 
+token, as I am saying.
+% What has been used to form a token is removed from the character buffer.
+%% 2012/11/04:
+\emph{Character} tokens are formed by removing a character from the 
+beginning of the character buffer and appending it to the token buffer 
+paired with its \emph{category} code.
 
 For every \emph{string of characters}, there is exactly one 
 (possible) \emph{named token} whose name the string is.\footnote{``Possible" 
     refers to the fact that \TeX\ does not store named tokens anywhere 
-    before they appear in its mouth, maybe apart from ``primitive" 
-    tokens that have a ``pre-assigned meaning" when a \TeX run 
+    before they appear in its gullet, maybe apart from ``primitive" 
+    tokens that have a ``pre-assigned meaning" when a \TeX\ run     %% \ 2012/11/04
     starts.---What is more bad with my claim is that 
     the \TeX\ program by design cannot extend its memory arbitrarily---even 
     not using the ``cloud''---, so it doesn't support tokens 
@@ -310,7 +390,9 @@ before} tokenization, but \emph{no longer} afterwards.
 So if you have two computers and start a \TeX\ run on each of them 
 with a little difference in time, there will be a moment where 
 \qtd{&\input} is a string on the one computer but not on the other? 
-This is like saying \meta{``When we apply the square root function to 
+This 
+appears to me %%% is %% 2012/11/04
+like saying \meta{``When we apply the square root function to 
 the number 4, the number 4 will no longer be the number 4, 
 it will be the number 2 instead."}
 \end{smallpar}
@@ -331,32 +413,35 @@ for brevity.\footnote{I am suggesting the question mark for named tokens
     though.}
 
 \begin{smallpar}
-\emph{Character tokens} get into \TeX's mouth by tokenization 
-when characters begin the buffer content while \emph{not} scanning 
-a name for a named token. A single character then is removed from the 
-character buffer, and a token storing its character code and current 
-category code is pushed into \TeX's mouth.
+%% rm. 2012/11/04, cf. above
+% \emph{Character tokens} get into \TeX's mouth by tokenization 
+% when characters begin the buffer content while \emph{not} scanning 
+% a name for a named token. A single character then is removed from the 
+% character buffer, and a token storing its character code and current 
+% category code is pushed into \TeX's mouth.
 
-Named tokens may get into \TeX's mouth by ``tokenization" as described above, 
+Named tokens may get into \TeX's gullet by ``tokenization" as described above, 
 i.e., they are drawn from the character buffer. But they also can 
-appear in \TeX's mouth ``from within," 
-by the manipulation inside \TeX's mouth. 
+appear in \TeX's gullet ``from within," 
+by the manipulation inside \TeX's gullet. 
 
 More formally, those manipulations are called ``expansion,"
-and \TeX's mouth can be conceived of as a \emph{token buffer} 
+and \TeX's gullet can be conceived of as a \emph{token buffer} 
 that is feeded to the right (or end) by tokenization from the character buffer. 
 Expansion means that certain tokens in the token buffer are substituted 
-by other ones. This way tokens may get into \TeX's mouth that 
+by other ones. This way tokens may get into \TeX's gullet that 
 emerged from tokenization a ``long time ago", maybe in a previous 
 run that created the \emph{format} (\TeX's variant \code{INITEX}); 
 or tokens may appear by some hardwired expansion function. 
 
-However, \emph{named tokens} may get into \TeX's mouth 
+However, \emph{named tokens} may get into \TeX's gullet 
 also by \emph{expansion}, never having been drawn by tokenization 
-and not being hardwired. This happens by the `\csname' name construct. 
+and not being hardwired. This happens by the `\csname' 
+% name      %%  rm. 2012/07/25
+construct. 
 The input \emph{code} may contain 
 \[`\csname tupni\endcsname'\]
-This may be converted into 7 tokens entering \TeX's mouth, 
+This may be converted into 7 tokens entering \TeX's gullet, 
 the first one being \NTOK{csname}, the last one 
 \NTOK{endcsname}, and five character tokens in between. 
 Due to some \emph{function} (which I would denote as *\code{csname})
@@ -562,10 +647,11 @@ In ``retrospect," the result of tokenizing \ref{eq:toks} should be
 \end{equation}
 and the intention is that it works like 
 \begin{equation}
-  \ntok{typein}.\codelb.&a.\coderb\,
-  \ntok{typein}.\codelb.&a.\coderb\,
-  \ntok{typein}.\codelb \ntok{a}.\coderb\,
-  \ntok{typein}.\codelb.&a.\coderb
+  %% added \,s 2012/06/07:
+  \ntok{typein}\,.\codelb\,.&a\,.\coderb\,
+  \ntok{typein}\,.\codelb\,.&a\,.\coderb\,
+  \ntok{typein}\,.\codelb \ntok{a}\,.\coderb\,
+  \ntok{typein}\,.\codelb\,.&a\,.\coderb
 \end{equation}
 (The definition of `\DoWith' in Section~\ref{sec:core} indeed adds surrounding braces, 
  if missing.)
@@ -583,7 +669,8 @@ the token buffer's content will just be\footnote{If you use
 \end{equation}
 Next $\ntok{typein}.\codelb.&a.\coderb$ is expanded according to the code for 
 `\typein' in \file{latex.ltx}. Some unexpandable tokens will emerge 
-and be moved into the ``command buffer," and you should get a screen
+and be moved into the ``instruction buffer,"                %% cmd -> instr 2012/11/04
+and you should get a screen
 message with `a' and a prompt. When you have entered something, 
 the remaining \ntok{expandafter} tokens and the \ntok{fi} will be 
 removed from the character buffer, and it contains only
@@ -612,7 +699,7 @@ Let $\Chi_E$ be the set of character tokens of category code in $E$
 
 Let $\circ$ be the \emph{concatenation} operation among token lists.\footnote{%
     %% 2012/05/18
-    TODO: Define for representations by maps, or:
+    \TODO: Define for representations by maps, or:              %% \ 2012/11/05
     ``Concatenation is about as basic as natural numbers and is 
       understood in terms of axioms rather than by a definition.''---See 
         notes from 2011 (even with attempts with \Wikienref{Category theory})
@@ -700,7 +787,7 @@ What <cmd>s are allowed?
          from 'dowith' commands before the argument list is finished). 
   \item \strong{Other one-parameter} ``commands" <cmd> such as
         \TeX\ \strong{primitives} may work---you must think of 
-        the fact that surrounding \emph{braces} are added.\footnote{TODO: 
+        the fact that surrounding \emph{braces} are added.\footnote{\TODO: %% \ 2012/11/05
             in the future, variants not adding braces could be added.}
         So the \strong{primitives} `\hbox' and `\vbox' work, 
         for instance. `\show' is an example that doesn't work at all, 
@@ -735,7 +822,7 @@ What <cmd>s are allowed?
 % and that it works on.
 % 
 % There are \emph{more} kinds of lists that \TeX\ works on. 
-% Here we are dealing with ``\TeX's mouth."\footnote{Cf.\ documentation 
+% Here we are dealing with ``\TeX's gullet."\footnote{Cf.\ documentation 
 %     of the \ctanpkgref{bitelist} package.}
 % \TeX's mouth processes tokens formed from character input. 
 % It may turn a list `<toks-a><toks_b><toks-c>' of tokens 
@@ -781,9 +868,19 @@ Moreover, Ahmed Musa describes such commands as                 %% 2012/06/03
 ``Parsing \qtd{tsv} lists" in documenting his 
 \ctanpkgref{catoptions} package.
 \ctanpkgref{moredefs} (Matt Swift) provides list handling commands 
-like the few that are here.\footnote{\ctanpkgref{arrayjobx} 
+like the few that are here.\footnote{\ctanpkgref{arrayjobx}%    %% % 2012/11/05
     provides somewhat ``exotic" handling of ``lists".}          %% 2012/05/10
-(I~do not want to load that much.)
+%% 2012/11/05:
+---In October 2012, Ahmed Musa's \ctanpkgref{loops} appeared on 
+\acro{CTAN}, offering loops of several ``categories" about as those 
+that are listed below, very elaborate.% 
+%% /2012/11/05
+% (I~do not want to load that much.)
+%% <- 2012/11/04 ->
+---I do not want to load that much. I need and only need something 
+excessively simple, very few lines of code, as presented in 
+Section~\ref{sec:implement}. The next sections somewhat point 
+out single features of loop constructs that I do not want to have.
 
 \subsection{Separators}                             %% add. heading 2012/05/17b
 Regarding \LaTeX\ macros in `latex.ltx', the basic macro `\DoWith' of 
@@ -793,7 +890,7 @@ with lists without separators. By contrast, \LaTeX's |\@for| deals with
 With comma-separated lists, a ``string" of characters counts as 
 an item when it is delimited by commas, or by a comma and the 
 list ``border," or spaces may be used as separators additionally. 
-However, when \LaTeX\ analyzes such lists (in ``\TeX's mouth"), 
+However, when \LaTeX\ analyzes such lists (in ``\TeX's gullet"), 
 it uses representations by \emph{character tokens} of them.
 
 %% moved here 2012/05/17b:
@@ -906,13 +1003,14 @@ Note that this only was an example. In general, <item> may appear
 more than once in the ``loop body."
 
 ``Expandability" by \emph{avoiding} something iterating `\def\@tmp{<item>}'
-and doing iteration in \TeX's mouth (`\do' or so must have been defined earlier)
+and doing iteration in \TeX's gullet (`\do' or so must have been defined earlier)
 is essential especially within \cs{write}. 
 Assignments do not work there. A major motivation for developing 
 'dowith' developed with the \ctanpkgref{blog} package 
 that \cs{write}s \acro{HTML} code.
-Assignments happen somewhere \emph{behind} ``\TeX's mouth." 
-That place might be called the ``command buffer" to which 
+Assignments happen in ``\TeX's stomach."                    %% 2012/11/04
+That place might be called the 
+``instruction buffer" to which                              %% cmd -> instr 2012/11/04
 the ``expansion processor" moves items from the incoming token buffer 
 that cannot be expanded (any more).
 
@@ -1004,12 +1102,12 @@ Addition and removal commands are provided as well.
 The essential idea of 'dowith' and `\DoWith' is 
 \[`\if<code>\expandafter<one-token>\fi'\]
 %     Alan Jeffrey: \tugbartref{tb11-2/tb28jeffrey}{``Lists in \TeX's Mouth,"} 
-%     TUGboat Vol.~11 (1990), No.~2, pp.~237--245), 
+%     \acro{TUG}boat Vol.~11 (1990), No.~2, pp.~237--245), 
 %     \urlhttpref{tug.org/TUGboat/tb11-2/tb28jeffrey.pdf}.}
 It was described by \textsc{Alois Kabelschacht} as 
 \tugbartref{tb08-2/tb18kabel}{``&\expandafter\ vs.\ &\let\ and &\def\ 
     in Conditionals and a Generalization of PLAIN's &\loop"}
-in TUGboat Vol.~8 (1987), No.~2, pp.~184f.\
+in \acro{TUG}boat Vol.~8 (1987), No.~2, pp.~184f.\
 (a little more than one column).\foothttpurlref{tug.org/TUGboat/%
     tb08-2/tb18kabel.pdf}
 See some German biographical notes on Kabelschacht in the 
@@ -1054,3 +1152,7 @@ VERSION HISTORY
                         how to `foreach' ...; Kabelschacht
 2012/05/22      r0.21e  Kabelschacht vs. TeXbook
 2012/06/03      r0.21f  cf. `catoptions'; \dots\unkern\@, vs.\ 
+2012/06/07      r0.22a  added \,s in "?typein ..."
+2012/07/25      r0.3    "\csname name construct"?
+2012/11/02ff.           gullet, plainpkg, more modifications
+2012/11/19              mod. on "mouth" (bibleref-mouth)
diff --git a/Master/texmf-dist/source/generic/dowith/srcfiles.tex b/Master/texmf-dist/source/generic/dowith/srcfiles.tex
index 5221ab35f61..0402e0264ab 100644
--- a/Master/texmf-dist/source/generic/dowith/srcfiles.tex
+++ b/Master/texmf-dist/source/generic/dowith/srcfiles.tex
@@ -1,19 +1,18 @@
-\ProvidesFile{srcfiles.tex}[2012/05/20 file infos -> SrcFILEs.txt]
+\ProvidesFile{srcfiles.tex}[2012/11/19 file infos -> SrcFILEs.txt]
 \RequirePackage[r]{nicefilelist}[2012/05/20]
-%% <- [r] 2012/05/20
-%\MFfieldtemplate{f-base}{nicefilelist}
-\MFfieldtemplate{f-base}{abcdefgh}
-\RequirePackage{myfilist}
-\EmptyFileList %%% [nicefilelist.sty] %%% [readprov.sty,myfilist.sty]
+\RequirePackage{filedate}
+\input{plainpkg}
+\MaxBaseEmptyList*
+\FileDateAutoChecks*
+\ReadFileInfos{dowith.RLS}
 %% packages:
-\ReadPackageInfos{dowith}
+\ReadPackageInfos{dowith,domore}
 %% documentation:
-\ReadFileInfos{dowith}
+\ReadFileInfos{dowith,domore}
+\ReadFileInfos{srcfiles}
 %% documentation settings and auxiliaries:
+\NoFileDateAutoChecks
+\FileListRemark[ --]{---USED.---}
 \ReadPackageInfos{fifinddo,makedoc,niceverb}
-%% TODO readprov unable to handle package options:
-%\ReadPackageInfos{nicefilelist}
 \ReadFileInfos{makedoc.cfg,mdoccorr.cfg}
-\ReadFileInfos{srcfiles}
-\ReadFileInfos{dowith.RLS}
 \ListInfos[SrcFILEs.txt]
diff --git a/Master/texmf-dist/tex/generic/dowith/domore.sty b/Master/texmf-dist/tex/generic/dowith/domore.sty
new file mode 100644
index 00000000000..4650db60e61
--- /dev/null
+++ b/Master/texmf-dist/tex/generic/dowith/domore.sty
@@ -0,0 +1,136 @@
+                                                      \input plainpkg
+\ProvidesPackage{domore}[2012/11/19 v0.3 dowith extended (UL)]
+%% Copyright (C) 2012 Uwe Lueck,
+%% http://www.contact-ednotes.sty.de.vu
+%% -- author-maintained in the sense of LPPL below --
+%%
+%% This file can be redistributed and/or modified under
+%% the terms of the LaTeX Project Public License; either
+%% version 1.3c of the License, or any later version.
+%% The latest version of this license is in
+%%     http://www.latex-project.org/lppl.txt
+%% We did our best to help you, but there is NO WARRANTY.
+%%
+%% Please report bugs, problems, and suggestions via
+%%
+%%   http://www.contact-ednotes.sty.de.vu
+%%
+%% == With \LaTeX, extend 'dowith''s \cs{setdo} ==
+%% %% mod. 2012/11/06: 
+%% The original 'dowith' offers |\setdo{<do>}|
+%% for defining a one-parameter macro `\do' expanding to <do>.
+%% The present package allows applying a <digit>-parameter macro 
+%% (maybe `\do', <digit> being 2, 3, or ...)
+%% to a list of "brace groups" where each brace group 
+%% contains <digit> arguments. If \LaTeX\ is present ...
+\ifltx
+%% ... the following extension 
+%% \[|\setdo[<digit>]{<do>}]|\]
+%% of the basic 'dowith' version 
+%% can be used to define a <digit>-parameter macro `\do'.
+%% You also can equip `\do' with an initial optional argument by
+%% \[|\setdo[<digit>][<default>]{<do>}]|\]
+%% The next two moves allow loading the package 
+%% independently of 'dowith' (overriding its definition of `\setdo')
+%% as well as using the package 
+%% with a format that has not defined `\do' before.
+%% The first parameter of `\do' may even be \emph{optional.}
+  \let\setdo\relax \let\do\empty
+  \newcommand*{\setdo}[1][1]{\renewcommand\do[#1]}
+\fi
+%% 
+%% == Auxiliaries ==
+%% |\@firstsecondoftwo{<balanced-1>}{<balanced-2>}| \ 
+%% is a variant of \LaTeX's `\@firstofone{<balanced>}' for 
+%% \emph{two} arguments. It just removes outer braces
+%% from each of the two arguments (provided it has outer braces), 
+%% resulting in \[<balanced-1><balanced-2>\]
+\long\def\@firstsecondoftwo#1#2{#1#2}
+%% % |\@secondfirstoftwo<arg-1><arg-2>| results in <ark-2><ark-1> 
+%% % where <ark-1> is ... 
+%% % [TODO declare "meta-function removing braces"---in 'dowith' documentation]
+%% % (<arg-1>, <arg-2> must not contain `\par' tokens so far---TODO):
+%% |\@secondfirstoftwo{<balanced-1>}{<balanced-2>}| 
+%% \emph{additionally} interchanges the two arguments 
+%% (after removing braces):
+\long\def\@secondfirstoftwo#1#2{#2#1}
+%% Our main application is using it as an extended `\expandafter'
+%% before `\fi':
+%% \[`\@secondfirstoftwo{<do>}\fi'\]
+%% will expand to
+%% \[`\fi<do>'\]
+%% This won't work with `\else' in place of `\fi'.
+%% 
+%% == Enhanced \cs{DoWith} ==
+%% Here comes a more powerful variant of 'dowith''s `\DoWith'. 
+%% Instead of iterating a single "command" <cmd>
+%% on an arglist <args> by 
+%% \[`\DoWith{<cmd>}<args>\StopDoing'\]
+%% (cf. `dowith.pdf'), the present `\DoWith' can have a 
+%% more complex first argument. If <args> consists 
+%% of some brace groups the first of which is {<farg>} 
+%% so that <args> is 
+%% \[`{<farg>}<rgs>'\]
+%% ---<rgs> being the remaining arglist---
+%% \[|\DoWith{<repeat>}<args>\StopDoing|\]
+%% works like 
+%% \[`<repeat>{<farg>}\DoWith{<repeat>}<rgs>\StopDoing'\]
+%% and so on---a recursive explanation. Or if <args> is
+%% \[`{<arg-1>}{<arg-2>}'\dots`{<arg-n>}'\]
+%% ($n$ items), the result is like 
+%% \[`<repeat>{<arg-1>}<repeat>{<arg-2>}'\dots`<repeat>{<arg-n>}'\]
+%% The actual definition is:
+\def\DoWith#1#2{%
+    \ifx\StopDoing#2\empty      %% not \@empty for Plain 2012/11/05
+        \else\@secondfirstoftwo{#1{#2}\DoWith{#1}}\fi}
+%% In order to \strong{use} the remaining definitions from \strong{'dowith' 
+%% together with the present package},          %% \strong 2012/11/06
+%% load `dowith.sty' before `domore.sty'.
+%%
+%% == Applications of \cs{DoWith} ==
+%% `\DoWith' still is somewhat auxiliary. What I have used in practice, 
+%% are the following definitions.
+%%
+%% |\DoMore{<repeat>}<args>\StopDoing| with <args> as above 
+%% "unpacks" each arglist item so that <repeat> may be a macro 
+%% with more than one argument---say, <digit> arguments.
+%% Then <f-arg> or <arg-1>, as well as <arg-2> $\dots$ <arg-n>,
+%% should provide an arglist consisting of <digit> items.
+\def\DoWithMore#1{\DoWith{\@firstsecondoftwo{#1}}}
+%% Now I use metavariable <do> instead of <repeat>. 
+%% We consider some "separator" material <sep> to be inserted
+%% between instances of applying <do> to an item of <args>.
+%% We want to get
+%% \[`<do>{<arg-1>}<sep><do>{<arg-2>}<sep>'\dots`<sep><do>{<arg-n>}'\]
+%% This is achieved simply by starting with
+%% \[`<do>{<farg>}'\]
+%% and then proceeding as with 
+%% \[`\DoWith{<sep><do>}<rgs>\StopDoing'\]
+%% And that's what |\DoSeparateWith{<do>}{<sep>}<args>\StopDoing| does:
+\def\DoSeparateWith#1#2#3{#1{#3}\DoWith{#2#1}}
+%% |\DoSeparateWithMore{<do>}{<sep>}<args>\StopDoing| combines
+%% the two previous things, inserting separator material <sep>
+%% and unpacking the nested arg\-lists:
+\def\DoSeparateWithMore#1#2{%              %% wieder 2012/06/05
+    \DoSeparateWith{\@firstsecondoftwo{#1}}{#2}}
+%% My main application is that <do> is a link macro with arguments
+%% <target> and <text> and that <sep> is \qtdcode{~\string|~}
+%% (or some tie variant) to get a horizontal list of links like
+%% \[\def|{$\vert$}\mbox{<text-1> | <text-2> | \dots | <text-n>}\]
+%% 
+%% == Leaving and History ==
+\PopLetterCatAt
+\endinput
+
+VERSION HISTORY 
+v0.1    2012/01/17  developed in `texblog.fdf' 
+                    (using \[re]newcommand*)
+v0.2    2012/08/07  own file `domore.sty', \def's only
+        2012/08/08  dealing with "more" \setdo
+v0.3    2012/11/05  using `plainpkg'; removing old % code
+                    (see stored v0.2); auxiliaries \long
+        2012/11/06  doc.: more on \setdo (<digit>, opt. arg.), 
+                    usage with `dowith' \strong
+        2012/11/18  doc.: adjusted for `catchdq'; reworking for 
+                    \DoWith; \DoWithMore, \DoSeparateWith
+        2012/11/19  doc.: \DoSeparateWithMore
diff --git a/Master/texmf-dist/tex/generic/dowith/dowith.RLS b/Master/texmf-dist/tex/generic/dowith/dowith.RLS
index e96cee91760..24eeaed1f20 100644
--- a/Master/texmf-dist/tex/generic/dowith/dowith.RLS
+++ b/Master/texmf-dist/tex/generic/dowith/dowith.RLS
@@ -1,11 +1,14 @@
-\ProvidesFile{dowith.RLS} %% RELEASE INFO
-  [2012/06/03 r0.22 v0.22 arg. {}; doc.: catoptions]
-%   [2012/06/03 r0.21f v0.21a; doc.: catoptions]
-%   [2012/05/22 r0.21e v0.21a; doc.: Kabelschacht vs. TeXbook]
-%   [2012/05/20 r0.21d v0.21a discussing other cmds ]
-%   [2012/05/18 v0.21 r0.21c @ fix, new doc., .RLS]
-%   [2012/05/14 r0.21 @ fix, .RLS, README/title typo...] 
+\ProvidesFile{dowith.RLS}                %% >RELEASE INFO<
+    [2012/11/20 r0.3a doc. mouth -> gullet, `domore.sty';
+                      TDS corr.]
+    [2012/11/19 r0.3 doc. mouth -> gullet, `domore.sty']
+    [2012/06/03 r0.22 v0.22 arg. {}; doc.: catoptions]
+    [2012/06/03 r0.21f v0.21a; doc.: catoptions]
+    [2012/05/22 r0.21e v0.21a; doc.: Kabelschacht vs. TeXbook]
+    [2012/05/20 r0.21d v0.21a discussing other cmds ]
+    [2012/05/18 v0.21 r0.21c @ fix, new doc., .RLS]
+    [2012/05/14 r0.21 @ fix, .RLS, README/title typo...] 
     %% <- FAILED
-%   [2012/05/10 r0.2a corr. generic dir.]
-%   [2012/05/10 r0.2 first on CTAN]
+    [2012/05/10 r0.2a corr. generic dir.]
+    [2012/05/10 r0.2 first on CTAN]
 
diff --git a/Master/texmf-dist/tex/generic/dowith/dowith.sty b/Master/texmf-dist/tex/generic/dowith/dowith.sty
index 6f75654b984..a4625aade39 100644
--- a/Master/texmf-dist/tex/generic/dowith/dowith.sty
+++ b/Master/texmf-dist/tex/generic/dowith/dowith.sty
@@ -1,6 +1,7 @@
 \def\filename{dowith}     \def\fileinfo{simple list loop (UL)}
-\def\filedate{2012/06/04} \def\fileversion{v0.22}
-%% Copyright (C) 2011 Uwe Lueck,
+\def\filedate{2012/11/05} \def\fileversion{v0.3}
+%%
+%% Copyright (C) 2011 2012 Uwe Lueck,
 %% http://www.contact-ednotes.sty.de.vu
 %% -- author-maintained in the sense of LPPL below --
 %%
@@ -15,39 +16,30 @@
 %%
 %%   http://www.contact-ednotes.sty.de.vu
 %%
-%% % \pagebreak                                           %% 2012/05/19
 %% == Proceeding without \LaTeX ==
-%% A little \LaTeX\ as in Bernd Raichle's               %% 2011/11/19
-%% \CtanPkgRef{ngerman}{ngerman.sty}:
-%% %% moved 2 lines here 2012/05/14 v0.21:
-\chardef\atcode=\catcode`\@
-\catcode`\@=11 % \makeatletter
-\begingroup\expandafter\expandafter\expandafter\endgroup
-%% I need `\ProvidesPackage' for \ctanpkgref{fileinfo}, 
-%% my package version tools. 
-\expandafter\ifx\csname ProvidesPackage\endcsname\relax
-%% %% 2011/11/07:
-%% When `\ProvidesPackage' is not defined, we provide 
-%% a version of \LaTeX's `\in@' 
-%% (an old version that may wrongly 
-%%  claim to have found an occurrence of a sequence, 
-%%  but is correct for single tokens) 
-%% for checking token list macros.
-%% \LaTeX\ must not see `\ifin@' when it parses the 
-%% `\ifx' conditional:
+%% v0.3 mainly replaces imitating the 
+%% \CtanPkgRef{german}{german.sty} approach to genericity 
+%% by \ctanpkgref{plainpkg}:
+\input plainpkg
+\ProvidesPackage{\filename}[\filedate\space 
+                 \fileversion\space \fileinfo]
+\PushCatMakeLetterAt
+%% If \LaTeX\ is not present ... 
+\ifltx \else
+%% ... an old version of its `\in@' is introduced. 
+%% It is bad as a subword test 
+%% (false positive cases, cf. \CtanPkgRef{nicetext}{fifinddo} 
+%%  documentation), but 'dowith' will check for single tokens only. 
+%% If \LaTeX\ \emph{is} present, 
+%% on the other hand, `\ifin@' is recognized while skipping 
+%% `false' parts of conditionals, without being matched 
+%% by some `\fi' before the next `\else', so I hide it by `\csname':
   \expandafter\newif\csname ifin@\endcsname
   \def\in@#1#2{%
     \def\in@@##1#1##2##3\in@@{%
       \ifx\in@##2\in@false\else\in@true\fi}%
     \in@@#2#1\in@\in@@}
-%% 'readprov' stops reading the file at `\Provides'\texttt{...}, 
-%% therefore ...
-  \long\def\@gobble#1{} \expandafter\@gobble
-\else
-  \expandafter\@firstofone
 \fi
-{ \ProvidesPackage{\filename}[\filedate\space 
-                   \fileversion\space \fileinfo] }
 %% 
 %% == Applying a Command ==                             %% 2011/11/07
 %% \label{sec:apply}
@@ -58,7 +50,8 @@
 %% may be either a single token or a group `{<balanced>}'.
 \def\DoWith#1#2{%
     \ifx\StopDoing#2\empty
-%% The previous `\empty' (replacing `%') is a bug fix as of v0.22, 
+%% The previous `\empty' (replacing `%') is a bug fix as of v0.22 
+%% (June 2012),                                             %% 2012/11/05
 %% while in my extension draft I already had it in January 2012. 
 %% It allows ``empty" arglist items \qtd{\lbtok\rbtok}. 
 %% Before v0.22, such an empty brace group would have resulted 
@@ -134,16 +127,16 @@
 %% complains when <list-macro> seems to have been used earlier 
 %% while the second complains when <list-macro> seems \emph{not} to 
 %% have been used before:
-\expandafter\ifx\csname @latex@error\endcsname\relax
-  \def\InitializeListMacro#1{\let#1\empty} %% not \@empty 2011/11/07
-  \let\ReInitializeListMacro\InitializeListMacro
-\else
+\ifltx                                                  %% v0.3
   \def\InitializeListMacro#1{\@ifdefinable#1{\let#1\empty}}
   \def\ReInitializeListMacro#1{%
     \edef\@tempa{\expandafter\@gobble\string#1}%
     \expandafter\@ifundefined\expandafter{\@tempa}%
         {\@latex@error{\noexpand#1undefined}\@ehc}%
         {\let#1\empty}}
+\else
+  \def\InitializeListMacro#1{\let#1\empty} %% not \@empty 2011/11/07
+  \let\ReInitializeListMacro\InitializeListMacro
 \fi
 %% |\ToListMacroAdd{<list-macro>}{<cmd-or>}|
 %% appends <cmd-or> to the replacement token list of <list-macro>. 
@@ -193,7 +186,7 @@
 %%
 %%
 %% == Leaving and History ==
-\catcode`\@=\atcode 
+\PopLetterCatAt                                         %% v0.3
 \endinput
 
 VERSION HISTORY 
@@ -207,3 +200,5 @@ v0.21   2012/05/14     fix for "generic" and `typeoutfileinfo':
                        @ before ...!
 v0.21a  2012/05/19     \labels sec:apply, sec:core; \pagebreak?
 v0.22   2012/06/04     allow {} items
+v0.3    2012/11/05     updating copyright, using `plainpkg', 
+                       rewording documentation there