dowit (21nov12)

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

5 files changed, 87 insertions, 18 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