From aa040bf06e9ffb30895fc92178a8f1aa44fda1de Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Tue, 22 Sep 2015 22:26:18 +0000 Subject: unravel (22sep15) git-svn-id: svn://tug.org/texlive/trunk@38435 c570f23f-e606-0410-a88d-b1316a301751 --- Master/texmf-dist/doc/latex/unravel/README | 34 ---------------------- Master/texmf-dist/doc/latex/unravel/README.md | 36 ++++++++++++++++++++++++ Master/texmf-dist/doc/latex/unravel/unravel.pdf | Bin 674252 -> 692725 bytes 3 files changed, 36 insertions(+), 34 deletions(-) delete mode 100644 Master/texmf-dist/doc/latex/unravel/README create mode 100644 Master/texmf-dist/doc/latex/unravel/README.md (limited to 'Master/texmf-dist/doc/latex/unravel') diff --git a/Master/texmf-dist/doc/latex/unravel/README b/Master/texmf-dist/doc/latex/unravel/README deleted file mode 100644 index b2dce6d2cc1..00000000000 --- a/Master/texmf-dist/doc/latex/unravel/README +++ /dev/null @@ -1,34 +0,0 @@ ----------------------------------------------------------------- -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/README.md b/Master/texmf-dist/doc/latex/unravel/README.md new file mode 100644 index 00000000000..bc25d285c38 --- /dev/null +++ b/Master/texmf-dist/doc/latex/unravel/README.md @@ -0,0 +1,36 @@ +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 the documentation, run `pdflatex unravel.dtx` twice. + +This is work in progress, all suggestions/comments/bug reports +are welcome! See https://github.com/blefloch/latex-unravel/ diff --git a/Master/texmf-dist/doc/latex/unravel/unravel.pdf b/Master/texmf-dist/doc/latex/unravel/unravel.pdf index 19a0e4fe3f1..a8af7eaff51 100644 Binary files a/Master/texmf-dist/doc/latex/unravel/unravel.pdf and b/Master/texmf-dist/doc/latex/unravel/unravel.pdf differ -- cgit v1.2.3