diff options
| author | Karl Berry <karl@freefriends.org> | 2013-07-29 22:39:06 +0000 |
|---|---|---|
| committer | Karl Berry <karl@freefriends.org> | 2013-07-29 22:39:06 +0000 |
| commit | 61aff27e54e84c0be9a312b82a413847a527c580 (patch) | |
| tree | 2f134ca286a522f8cd44ed8de040a6c9365c8d8e /Master/texmf-dist/doc | |
| parent | 81ad2a9f387b54bdad66ad8e98714b742d059445 (diff) | |
unravel (29jul13)
git-svn-id: svn://tug.org/texlive/trunk@31307 c570f23f-e606-0410-a88d-b1316a301751
Diffstat (limited to 'Master/texmf-dist/doc')
| -rw-r--r-- | Master/texmf-dist/doc/latex/unravel/README | 34 | ||||
| -rw-r--r-- | Master/texmf-dist/doc/latex/unravel/unravel.pdf | bin | 0 -> 674252 bytes |
2 files changed, 34 insertions, 0 deletions
diff --git a/Master/texmf-dist/doc/latex/unravel/README b/Master/texmf-dist/doc/latex/unravel/README new file mode 100644 index 00000000000..b2dce6d2cc1 --- /dev/null +++ b/Master/texmf-dist/doc/latex/unravel/README @@ -0,0 +1,34 @@ +---------------------------------------------------------------- +unravel --- Watching TeX digest tokens +E-mail: blflatex@gmail.com +Released under the LaTeX Project Public License v1.3c or later +See http://www.latex-project.org/lppl.txt +---------------------------------------------------------------- + +The unravel LaTeX package provides tools to explore TeX code, +performing expansion and assignments step by step. + +TeX is a strange beast. Its eyes read files, making characters +into tokens. Its mouth then chews tokens, expanding them if +possible, namely, expanding user-defined macros, or conditionals, +etc. When meeting a so called ``unexpandable'' token, TeX's +stomach comes into play, performing assignments, or moving boxes +around, eventually typesetting the result thanks to its great +line- and page-breaking algorithms. + +All of this is interleaved, and difficult to follow. Of course, +one can always use \tracingall, but the result is... messy. +This package is an attempt to replicate how TeX digests tokens, +and to make the process easier to follow. Namely, +\unravel{\some\tokens} will let you go through expansions and +assignments performed by TeX upon seeing of ``\some\tokens'', +step by step. + +Some parts of TeX are not covered. In particular, category codes +are fixed for the whole argument of \unravel when it is read. + +This package requires up-to-date versions of the l3kernel, +l3packages, and l3experimental bundles. + +The package is extracted by running "pdflatex unravel.ins". +For documentation, run "pdflatex unravel.dtx" twice.
\ No newline at end of file diff --git a/Master/texmf-dist/doc/latex/unravel/unravel.pdf b/Master/texmf-dist/doc/latex/unravel/unravel.pdf Binary files differnew file mode 100644 index 00000000000..19a0e4fe3f1 --- /dev/null +++ b/Master/texmf-dist/doc/latex/unravel/unravel.pdf |