summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc
diff options
context:
space:
mode:
authorKarl Berry <karl@freefriends.org>2013-07-29 22:39:06 +0000
committerKarl Berry <karl@freefriends.org>2013-07-29 22:39:06 +0000
commit61aff27e54e84c0be9a312b82a413847a527c580 (patch)
tree2f134ca286a522f8cd44ed8de040a6c9365c8d8e /Master/texmf-dist/doc
parent81ad2a9f387b54bdad66ad8e98714b742d059445 (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/README34
-rw-r--r--Master/texmf-dist/doc/latex/unravel/unravel.pdfbin0 -> 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
new file mode 100644
index 00000000000..19a0e4fe3f1
--- /dev/null
+++ b/Master/texmf-dist/doc/latex/unravel/unravel.pdf
Binary files differ