summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/generic/dowith
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2012-11-22 00:51:04 +0000
committerKarl Berry <karl@freefriends.org>2012-11-22 00:51:04 +0000
commitac225c92964fc1f94322e26a4edc729528882bcb (patch)
treea8da670546bd0acf1141edc0bd0e6b620ce4334a /Master/texmf-dist/doc/generic/dowith
parent31cb4a9239c6be1c8e24250668182e12a7bc8b74 (diff)
dowit (21nov12)
git-svn-id: svn://tug.org/texlive/trunk@28325 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic/dowith')
-rw-r--r--Master/texmf-dist/doc/generic/dowith/Announce.txt43
-rw-r--r--Master/texmf-dist/doc/generic/dowith/README43
-rw-r--r--Master/texmf-dist/doc/generic/dowith/SrcFILEs.txt19
-rw-r--r--Master/texmf-dist/doc/generic/dowith/domore.pdfbin0 -> 548019 bytes
-rw-r--r--Master/texmf-dist/doc/generic/dowith/dowith.pdfbin515977 -> 768193 bytes
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
Binary files 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
--- a/Master/texmf-dist/doc/generic/dowith/dowith.pdf
+++ b/Master/texmf-dist/doc/generic/dowith/dowith.pdf
Binary files differ