From ac225c92964fc1f94322e26a4edc729528882bcb Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Thu, 22 Nov 2012 00:51:04 +0000 Subject: dowit (21nov12) git-svn-id: svn://tug.org/texlive/trunk@28325 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/generic/dowith/Announce.txt | 43 ++++++++++++++++++++++ Master/texmf-dist/doc/generic/dowith/README | 43 +++++++++++++--------- Master/texmf-dist/doc/generic/dowith/SrcFILEs.txt | 19 ++++++++++ Master/texmf-dist/doc/generic/dowith/domore.pdf | Bin 0 -> 548019 bytes Master/texmf-dist/doc/generic/dowith/dowith.pdf | Bin 515977 -> 768193 bytes 5 files changed, 87 insertions(+), 18 deletions(-) create mode 100644 Master/texmf-dist/doc/generic/dowith/Announce.txt create mode 100644 Master/texmf-dist/doc/generic/dowith/SrcFILEs.txt create mode 100644 Master/texmf-dist/doc/generic/dowith/domore.pdf (limited to 'Master/texmf-dist/doc') 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 in \DoWith... 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 Binary files /dev/null and b/Master/texmf-dist/doc/generic/dowith/domore.pdf differ diff --git a/Master/texmf-dist/doc/generic/dowith/dowith.pdf b/Master/texmf-dist/doc/generic/dowith/dowith.pdf index 48d28085e94..36c88ec398c 100644 Binary files a/Master/texmf-dist/doc/generic/dowith/dowith.pdf and b/Master/texmf-dist/doc/generic/dowith/dowith.pdf differ -- cgit v1.2.3