diff options
author | Karl Berry <karl@freefriends.org> | 2012-03-29 23:20:23 +0000 |
---|---|---|
committer | Karl Berry <karl@freefriends.org> | 2012-03-29 23:20:23 +0000 |
commit | 84c2b4bf9bf9fa99638f75dd5c81041d7e8705cf (patch) | |
tree | 08001c80f59e16e691575822fde1669bf8fccc44 /Master/texmf-dist/doc/generic | |
parent | 9fc033895f0466fc3ad09b515d588d61ea42f960 (diff) |
new generic package bitelist (29mar12)
git-svn-id: svn://tug.org/texlive/trunk@25779 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc/generic')
-rw-r--r-- | Master/texmf-dist/doc/generic/bitelist/README | 64 | ||||
-rw-r--r-- | Master/texmf-dist/doc/generic/bitelist/bitelist.pdf | bin | 0 -> 405448 bytes |
2 files changed, 64 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/generic/bitelist/README b/Master/texmf-dist/doc/generic/bitelist/README new file mode 100644 index 00000000000..81331006413 --- /dev/null +++ b/Master/texmf-dist/doc/generic/bitelist/README @@ -0,0 +1,64 @@ + + README for the `bitelist' package + "Split list at list inside in TeX's Mouth" + (C) Uwe Lueck 2012/03/28 + + +`bitelist.sty' provides commands for "splitting" a token list +at the first occurrence of a contained token list. I.e., for given +token lists s, t return b and shortest a, such that t = a s b. +As opposed to other packages providing similar features, + (i) the method uses TeX's mechanism of reading delimited macro + parameters; + (ii) the splitting macros work by pure expansion, without + assignments, provided the macro doing the search has been + defined before processing (e.g., a file); +(iii) instead of using one macro for a "substring" test and another + one to replace the "substring"--which includes extracting + corresponding prefix and suffix--, the *same* macro that + detects the occurrence returns the split; + (iv) e-TeX is not required. +(And LaTeX is not required.) This improves `fifinddo.sty' (v0.51). + +An elaborated approach (additionally to a simpler one) is provided +that does not loose outer braces of prefix/suffix. + +"Substring" detection and "string" replacement are (implicitly) +included with respect to certain representations of characters by tokens. +Counting occurrences and "global" replacement could be achieved +by applying the operation to earlier results, etc.--so +this approach seems to be "fundamental" for a certain larger +set of list analysis tasks. + +The documentation aims to prove the correctness of the methods +with mathematical rigour. + +KEYWORDs: macro programming, text filtering, substrings + +RELATEd PACKAGEs: datatool, stringstrings, ted, texapi, xstring + +The package file `bitelist.sty' and the documentation files +`bitelist.pdf' and `bitelist.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 + +We did our best to help you, but there is NO WARRANTY. + +The `bitelist' package is author-maintained in the sense of +this license. + +The latest public version of the package is available at + + http://mirror.ctan.org/macros/latex/contrib/bitelist/ + +A TDS version of the package is available as + + http://mirror.ctan.org/install/macros/generic/bitelist.tds.zip + +Please report bugs, problems, and suggestions via + + http://www.contact-ednotes.sty.de.vu + + diff --git a/Master/texmf-dist/doc/generic/bitelist/bitelist.pdf b/Master/texmf-dist/doc/generic/bitelist/bitelist.pdf Binary files differnew file mode 100644 index 00000000000..5608e6e5e89 --- /dev/null +++ b/Master/texmf-dist/doc/generic/bitelist/bitelist.pdf |