summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/latex/multiexpand/README
blob: 160664a37ee841b928207cc9ad69dae92b9debac (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
Variations on the `\expandafter` TeX primitive
==============================================
* E-mail: blflatex@gmail.com
* Released under the LaTeX Project Public License v1.3c or later
  See http://www.latex-project.org/lppl.txt

Every TeX programmer knows `\expandafter`, and how messy it can become
when trying to expand several times a very deeply hidden token.  For
example, say we want to expand `\C` four times before `\A` and `\B` in
`\A\B\C`.  The traditional approach would be to insert 15 `\expandafter`
before `\A` and the same number before `\B`.  With this package one can
do either of the following

    \expandafter\A\expandafter\B\romannumeral\multiexpand{4}\C
    \expandafter\A\romannumeral\multiexpandafter{4}\B\C

In one step of expansion (triggered by the `\expandafter`'s),
`\romannumeral\multiexpand{4}` expands the following token 4 times,
whereas `\romannumeral\multiexpandafter{4}` expands the token after
that 4 times.  For more complicated cases, use `\MultiExpandAfter`:

    \MultiExpandAfter{2}\a\MultiExpandAfter{3}{%
      \MultiExpandAfter{10}\b\MultiExpandAfter{10}\c\d}

expands `\d` 10 times, then `\c` 8 times, then `\b` once.
The whole process only takes two steps of expansion.

The package can be built from the file `multiexpand.dtx' by running

    pdflatex multiexpand.dtx
    pdflatex multiexpand.dtx