Page 1
εXTEX
εXTEX
εXTEX
User’s Guide
Version 0.0 (Revision 1.17)
Gerd Neugebauer
This document describes εXTEX. It explains how to get εXTEX up and run-
ning and which features εXTEX offers to you. Since εXTEX provides a testbed
for experimentation the focus has been put on the default configurations.
The intended audience for this document are end users of the typesetting
engine who want to use εXTEX on the command line or as plug-in replacement
of TEX.
Draft
cс 2005 The εXTEX Group and individual authors listed below
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free
copy of the license is included in the section entitled “GNU Free Documentation License”.
This product includes software developed by the Apache Software Foundation (http://www.apache.org/).
Gerd Neugebauer
Im Lerchelsböhl 5
64521 Groß-Gerau (Germany)
2
Contents
5
1.1. This Document . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5
1.2. Web Site . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5
1.3. Mailing Lists . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5
1.4. Reporting Bugs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
5
7
2.1. Prerequisites . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7
2.1.1. Java . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7
2.1.2. TEXMF . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
7
2.2. Getting εXTEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
8
2.2.1. Getting the Installer . . . . . . . . . . . . . . . . . . . . . . . . .
8
2.2.2. Getting the Sources . . . . . . . . . . . . . . . . . . . . . . . . . .
8
2.3. Installing εXTEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .
9
2.3.1. Installing εXTEX with the Installer . . . . . . . . . . . . . . . . . .
9
2.3.2. Replaying an Installation . . . . . . . . . . . . . . . . . . . . . . . 10
2.3.3. Creating the εXTEX Installer . . . . . . . . . . . . . . . . . . . . . 10
2.3.4. Installing εXTEX from the Sources on the Command Line . . . . . 11
2.4. Configuring εXTEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.4.1. Start-up Files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
2.4.2. Configuration Files . . . . . . . . . . . . . . . . . . . . . . . . . . 16
2.4.3. Predefined Configurations . . . . . . . . . . . . . . . . . . . . . . 16
2.4.4. Primitive Sets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
2.5. Running εXTEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
2.5.1. Command Line Parameters . . . . . . . . . . . . . . . . . . . . . 21
2.5.2. Creating Formats . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
3. Troubleshooting εXTEX
25
3.1. Why are my files not found? . . . . . . . . . . . . . . . . . . . . . . . . . 25
3.2. Why are is the log file different from TEX’s? . . . . . . . . . . . . . . . . 25
4. The Macro Language of εXTEX
27
4.1. Basic Syntactic Entities of εXTEX . . . . . . . . . . . . . . . . . . . . . . 27
4.2. Primitives of εXTEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 29
3
Contents
157
A.1. GNU Free Documentation License . . . . . . . . . . . . . . . . . . . . . . 157
A.2. GNU Library General Public License . . . . . . . . . . . . . . . . . . . . 159
A.3. The License for Avalon . . . . . . . . . . . . . . . . . . . . . . . . . . . . 161
A.4. ICU4J license - ICU4J 1.3.1 and later . . . . . . . . . . . . . . . . . . . . 162
A.5. License for PDFBox . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 162
4
1. Introduction
εXTEX aims at providing a high-quality typesetting system. The development of εXTEX
has been inspired by the experiences with TEX. The focus lies on an open design and a
high degree of configurability. Thus εXTEX should be a good base for further develop-
ment.
On the other hand we have to take care not to leave the current user base of TEX
behind. pdfTEX has taught us that a migration path from TEX has a positive value in
it. In the mean time the majority of TEX users applies in fact pdfTEX.
To provide a backward compatibility of εXTEX with TEX one special configuration is
provided. Thus backward compatibility is just a matter of configuration.
1.1. This Document
This document is meant to be a reference document. It should contain all information
necessary to know. It is not meant to be a tutorial. Thus do not expect tutorial type
material in this document.
1.2. Web Site
There is a web site devoted to εXTEX. This web site can be reached via the URL
1.3. Mailing Lists
If you are ready to try εXTEX you might as well want to join a mailing list to get in
contact with the community.
1.4. Reporting Bugs
If you find any bugs in εXTEX you can submit them either via a HTML form or via
email. You can find the HTML form at
5
1. Introduction
Emails containing the description can be sent to
• the source of a minimal example showing the problem
• the log file resulting from running this example
• a description why you think that something went wrong and what the expected
result would be
• a description of the environment you are using (host architecture, operating system,
Java version)
6
2. Getting Started
In this chapter we describe the steps you can take to get εXTEX up and running. We try
to use as few as possible premises. Thus it should be not too hard to get started.
2.1. Prerequisites
2.1.1. Java
You need to have Java 1.4.2 or later installed on your system. You can get Java for a
several systems directly from java.sun.com. Download and install it according to the
To check that you have an appropriate Java on your path you can use the command
java with the argument -version. This can be seen in the following listing:
# java -version
java version "1.4.2_06"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.2_06-b03)
Java HotSpot(TM) Client VM (build 1.4.2_06-b03, mixed mode)
#
2.1.2. TEXMF
If you want to use more than the pure εXTEX engine, fonts and macros can be inherited
from a texmf tree. εXTEX itself does not contain a full texmf tree. It comes just with
some rudimentary files necessary for testing. Thus you should have installed a texmf
tree, e.g. from a TEXLive installation. This can be found on the Comprehensive TEX
There is no need to install the texmf tree in a special place. You have to tell εXTEX
anyhow where it can be found. It is even possible to work with several texmf trees.
One requirement for the texmf trees is that they have a file database (ls-R). εXTEX
can be configured to work without it, but then εXTEX is deadly slow. Thus you do not
really want to try this alternative.
7
2. Getting Started
2.2. Getting εXTEX
2.2.1. Getting the Installer
The simplest way to get εXTEX up and running is to use the εXTEX installer. This
installer is distributed as one file ExTeX-setup.jar. You can download it from
To be completed.
2.2.2. Getting the Sources
The sources of εXTEX are stored in a CVS repository. To access this repository you need
The coordinates of the repository are:
Connection type: pserver
User:
anonymous
Host:
cvs.extex.berlios.de
Location:
/cvsroot/extex
Module:
ExTeX
We assume here that you have access to CVS on the command line. This can be either
a shell on a Unix-like system or something like cygwin on Windows. We also assume
that you have direct connection to the internet.
First we create a directory where the sources are stored:
# mkdir ExTeX
Next we change the current directory to this base directory:
# cd ExTeX
enables us to download the sources but not to commit any changes. The committing is
restricted to members of the εXTEX team.
Finally we can check out the sources:
# cvs -d:pserver:anonymous@cvs.extex.berlios.de/cvsroot/extex co ExTeX
This command shows a lot of output. At the end the current directory is filled with
a lot of files and directories.
8
2.3. Installing εXTEX
Figure 2.1.: The Language Selection in the Installer
2.3. Installing εXTEX
There are several ways to install εXTEX. Some of them are described in this section.
2.3.1. Installing εXTEX with the Installer
The easiest installation of εXTEX works with the εXTEX installer. This installer is named
ExTeX-setup.jar. You can start the installer with the following command line:
# java -jar ExTeX-setup.jar
On Windows with a properly installed Java you can also start the installer by double-
clicking ExTeX-setup.jar in the Explorer.
The installer provides a graphical user interface with a wizard guiding you through
the installation process. The first dialog is shown in figure 2.1. As you can see you
can select one of several languages for the installation process. Currently the languages
English and German are supported. There might be some more at the time you are
performing the installation.
Note that the internationalization covers the installer only. εXTEX can be run under
different language environments as well. This is controlled by a setting at run-time.
Currently only an English language binding for εXTEX is provided.
Finally you have to make sure that the executables extex or extex.bat is on your
path for executables.
9
2. Getting Started
Figure 2.2.: Generating a Auto-Configuration for the Installer
2.3.2. Replaying an Installation
Sometimes it is desirable to perform an installation on several similar machines. This
means that the answers to the questions in the installer are the same. This process can
be automated.
In figure 2.2 you can see the last screen of the installer. Here you have the possibility
to select the button “Generate an automatic installation script”. This produces an XML
file which can be passed to the installer to avoid the dialogs.
Suppose you have named the file replay.xml in the file selector which pops up when
the button has been pressed. Then you can replay the installation with the following
command invocation:
# java -jar ExTeX-setup.jar replay.xml
This supposes that the two files ExTeX-setup.jar and replay.xml are in the current
directory.
Finally you have to make sure that the executables extex or extex.bat is on your
path for executables.
2.3.3. Creating the εXTEX Installer
You can create the installer of εXTEX from the sources. All you need for this step
is contained in the source distribution. Suppose you are in the base directory of the
distribution. Then the following command creates the installer:
# build installer
10
2.4. Configuring εXTEX
As a result the file ExTeX-setup.jar is created in the directory target. This file
is a self-contained installer. You can immediately start the installer with the following
command line:
# java -jar target/ExTeX-setup.jar
In addition the installer file can be moved to any other place – even other machines –
2.3.4. Installing εXTEX from the Sources on the Command Line
To install you can use the build script provided in the εXTEX base directory.
# build -Dinstall.dir=/usr/local/share/ExTeX install
Additionally you have to copy the file .extex from the base directory of the εXTEX to
Finally you have to make sure that the executables extex or
extex.bat is on your path for executables.
Now you can forget the source directory. It is not needed any more unless you are
debugging or developing εXTEX extensions.
2.4. Configuring εXTEX
The behaviour of εXTEX can be influenced via command line arguments and configuration
files. Most of the times the start-up files will be enough for the casual user.
2.4.1. Start-up Files
Whenever εXTEX starts it looks for start-up files named .extex. This file is sought in
the user’s home directory in the current directory. The settings in the current directory
overwrite the settings from the user’s home directory. Those in turn overwrite the built-
in settings.
εXTEX user properties files contain setting of properties. This is done in a line-based
way. Lines containing only white space characters are ignored. If the first character is a
hash sign (#) then the line is treated as a comment and ignored.
The first appearance of a equal sign (=) or the colon (:) separates the name of the
property from the value. Leading and trailing white space is ignored both for the name
and the value of the property.
Some characters have a special meaning. The backslash (\) acts as an escape character.
The sequence \n is replaced by the newline character. If the last character in a line is
a backslash then the line is continued in the next line. To produce a single backslash it
has to be doubled.
11
2. Getting Started
You can set any property name you like to a legal value. εXTEX will not complain
about unknown properties but ignore them silently. The following properties are used
by εXTEX:
extex.code
This parameter contains εXTEX code to be executed directly. The execution is
performed after any code specified in an input file.
Example:
extex.code = \\relax
extex.color.converter
This parameter contains the logical name of the color converter to use. The color
converter describes how colors are converted between different color soaces. Cur-
rently at least the color spaces RGB, Grayscale, HSV, and CMYK are supported.
The configuration mapps this to a concrete instance.
Example:
extex.color.converter = basic
extex.config
This parameter contains the name of the configuration resource to use. This con-
figuration resource is sought on the class path.
Example:
extex.config = tex.xml
extex.encoding
This parameter contains the name of the property for the standard encoding to
use.
Example:
extex.encoding = ISO-8859-1
extex.error.handler
This parameter contains the logical name of the error handler.
Example:
extex.error.handler = TeX
extex.fonts
This parameter contains the property indicating where to find font files. The value
is a path similar to extex.texinputs.
Example:
12
2.4. Configuring εXTEX
extex.fonts = /usr/local/share/fonts
extex.halt.on.error
This boolean parameter contains the property indicating whether the processing
should stop after the first error. Allowed values are true and false.
Example:
extex.halt.on.error = false
extex.file
This parameter contains the file to read from. It has no default. If this property is
not set or set to the empty string then no attempt is made to read a file. Maybe
the user is asked to provide one.
Example:
extex.file = abc.tex
extex.fmt
This parameter contains the name of the format to read. An empty string denotes
that no format should be read. This is the default. In this case εXTEX acts with
Example:
extex.fmt = plain
extex.ini
If set to true then act as iniTEX. This command line option is defined for com-
patibility to TEX only. In εXTEX it has no effect at all. Allowed values are true
and false.
Example:
extex.ini = true
extex.interaction
This parameter contains the interaction mode. Possible values are the numbers
0. . . 3 and the symbolic names batchmode (0), nonstopmode (1), scrollmode (2),
and errorstopmode (3).
Example:
extex.interaction = scrollmode
13
2. Getting Started
extex.jobname
This parameter contains the name of the job. It is overwritten if a file is given to
read from. In this case the basename of the input file is used instead. If no file is
read in then the default value texput is used.
Example:
extex.jobname = texput
extex.jobname.master
This parameter contains the name of the job to be used with high priority.
Example:
extex.jobname.master = texput
extex.lang
This parameter contains the name of the locale to be used for the messages. The
value is a two letter ISO language code. εXTEX can be internationalized just
by providing some files with the translated strings. Currently only the language
English (en) is supported.
Example:
extex.lang = en
extex.nobanner
This parameter contains a boolean indicating that the banner should be sup-
pressed. Allowed values are true and false.
Example:
extex.nobanner = false
extex.output
This parameter contains the output format. This logical name is resolved via the
configuration.
Example:
extex.output = pdf
extex.outputdir
This parameter contains the directory where output files should be created. The
period is interpreted as the current directory. The default is the current directory.
Example:
extex.outputdir = .
14
2.4. Configuring εXTEX
extex.outputdir.fallback
This parameter contains the property for the fallback if the output directory
(extex.outputdir) fails to be writable. The period is interpreted as the current
directory.
The default is the current directory. Thus you can reset extex.outputdir and
if this directory happens not to be writable then the current directory is used to
create the log file and output files in.
Example:
extex.outputdir.fallback = .
extex.progname
This parameter can be used to overrule the name of the program shown in the
banner and the version information.
Example:
extex.progname = iniExTeX
extex.stacktrace.on.internal.error
This parameter can be used to force a stack trace on stdout if an internal error is
encountered. This is handy for development. Allowed values are true and false.
Example:
extex.stacktrace.on.internal.error = true
extex.texinputs
This parameter contains the additional directories for searching εXTEX input files.
The directories are separated by the system-dependant separator. This separator
is a colon (:) on Unix and the semicolon (;) on Windows.
Example:
extex.texinputs = /home/gene/lib/tex
extex.trace.input.files
This boolean parameter contains the indicator whether or not to trace the search
for input files. Allowed values are true and false.
Example:
extex.trace.input.files = false
extex.trace.font.files
This boolean parameter contains the indicator whether or not to trace the search
for font files. Allowed values are true and false.
Example:
15
2. Getting Started
extex.trace.font.files = false
extex.trace.macros
This boolean parameter contains the indicator whether or not to trace the execu-
tion of macros. Allowed values are true and false.
Example:
extex.trace.macros = false
extex.trace.tokenizer
This boolean parameter contains the indicator whether or not to trace the work
of the tokenizer. Allowed values are true and false.
Example:
extex.trace.tokenizer = false
extex.typesetter
This parameter contains the name of the typesetter to use. If it is not set then the
default from the configuration file is used.
Example:
extex.typesetter = default
2.4.2. Configuration Files
Configuration files of another kind contain the assembly instructions for εXTEX. Those
files can be used to provide additional features in εXTEX.
To be completed.
2.4.3. Predefined Configurations
The Configuration extex
The configuration extex identifies itself as “ExTeX mode”. The configuration contains
the primitive sets tex, etex, and omega. The configuration allows extended register
names.
16
2.4. Configuring εXTEX
The Configuration extex-jx
The configuration extex-jx identifies itself as “Java extensions”. The configuration
contains the primitive sets tex, etex, and jx. The configuration allows extended register
names.
The Configuration extex-native
The configuration extex-native identifies itself as “Native extensions”. The configu-
ration contains the primitive sets tex, etex, and native. The configuration allows
extended register names.
The Configuration nextex
The configuration nextex identifies itself as “Namespace extension”. The configuration
contains the primitive sets tex, etex, and namespace. The configuration allows extended
register names.
The Configuration omega
The configuration omega identifies itself as “Omega compatibility mode”. The configu-
ration contains the primitive sets tex, etex, and omega.
The Configuration pdftex
The configuration pdftex identifies itself as “pdfTeX compatibility mode”. The config-
uration contains the primitive sets tex and pdftex.
The Configuration tex
The configuration tex identifies itself as “TeX compatibility mode”. The configuration
contains the primitive set tex.
2.4.4. Primitive Sets
The Primitive Set etex
The primitive set etex defines the following primitives:
\beginL \beginR \botmarks \clubpenalties \currentgrouplevel
\currentgrouptype \currentifbranch \currentiflevel \currentiftype
\detokenize \dimenexpr \displaywidowpenalties \endL \endR \eTeXrevision
\eTeXversion \everyeof \firstmarks \fontchardp \fontcharht \fontcharic
\fontcharwd \glueexpr \glueshrink \glueshrinkorder \gluestretch
\gluestretchorder \ifcsname \ifdefined \iffontchar \interactionmode
\interlinepenalties \lastlinefit \lastnodetype \marks \middle \muexpr
\numexpr \pagediscarts \parshapedimen \parshapeindent \parshapelength
17
2. Getting Started
\savingvdiscarts \scantokens \showgroups \showtokens \splitbotmarks
\splitdiscarts \splitfirstmarks \TeXXeTstate \topmarks \tracingassigns
\tracingcommands \tracinggroups \tracingifs \tracingnesting
\tracingscantokens \unexpanded \unless \widowpenalties
The Primitive Set jx
The primitive set jx defines the following primitives:
The Primitive Set namespace
The primitive set namespace defines the following primitives:
\export \import \namespace
The Primitive Set native
The primitive set native defines the following primitives:
The Primitive Set omega
The primitive set omega defines the following primitives:
\DefaultInputTranslation \DefaultOutputMode \DefaultOutputTranslation
\hfi \InputMode \InputTranslation \localbrokenpenalty
\localinterlinepenalty \localleftbox \localrightbox \mathdir
\naturaldir \noDefaultInputMode \noDefaultInputTranslation
\noDefaultOutputMode \noDefaultOutputTranslation \nullocplist \ocp
\ocplist \odelmiter \omathaccent \omathchar \omathchardef \omathcode
\pagedirHL \pagedirHR \popocplist \pushocplist \removebeforeocplist
\textdir \unnaturaldir \vfi
The Primitive Set pdftex
The primitive set pdftex defines the following primitives:
\pdfimageresolution \pdfincludechars \pdfinfo \pdflastannot
18
2.4. Configuring εXTEX
\pdfmovechars \pdfnames \pdfobj \pdfoutline \pdfoutput \pdfpageattr
\pdfpageheight \pdfpagesattr \pdfpagewidth \pdfpkresolution
The Primitive Set tex
The primitive set tex defines the following primitives:
\ \/ \\ \above \abovedisplayshortskip \abovedisplayskip
\aftergroup \atop \atopwithdelims \badness \baselineskip \batchmode
\begingroup \belowdisplayshortskip \belowdisplayskip \binoppenalty
\botmark \box \boxmaxdepth \brokenpenalty \catcode \char \chardef
\cleaders \closein \closeout \clubpenalty \copy \count \countdef \cr
\crcr \csname \day \deadcycles \def \defaulthyphenchar \defaultskewchar
\delcode \delimiter \delimiterfactor \delimitershortfall \dimen
\dimendef \discretionary \displayindent \displaylimits \displaystyle
\displaywidowpenalty \displaywidth \divide \doublehyphendemerits
\dp \dump \edef \else \emergencystretch \end \endcsname \endgroup
\endinput \endlinechar \eqno \errhelp \errmessage \errorcontextlines
\errorstopmode \escapechar \everycr \everydisplay \everyhbox \everyjob
\everymath \everypar \everyvbox \exhyphenpenalty \expandafter \fam \fi
\finalhyphendemerits \firstmark \floatingpenalty \font \fontdimen
\fontname \futurelet \gdef \global \globaldefs \halign \hangafter
\hangindent \hbadness \hbox \hfil \hfill \hfilneg \hfuzz \hoffset
\holdinginserts \hrule \hsize \hskip \hss \ht \hyphenation \hyphenchar
\hyphenpenalty \if \ifcase \ifcat \ifdim \ifeof \iffalse \ifhbox
\ifhmode \ifinner \ifmmode \ifnum \ifodd \iftrue \ifvbox \ifvmode
\ifvoid \ifx \ignorespaces \immediate \indent \input \inputlineno
\insert \insertpenalties \interlinepenalty \jobname \kern \language
\lastbox \lastkern \lastpenalty \lastskip \lccode \leaders \left
\lefthyphenmin \leftskip \leqno \let \limits \linepenalty \lineskip
\lineskiplimit \long \looseness \lower \lowercase \mag \mark
\mathaccent \mathbin \mathchar \mathchardef \mathchoice \mathclose
\mathcode \mathinner \mathop \mathopen \mathord \mathpunct \mathrel
\mathsurround \maxdeadcycles \maxdepth \meaning \medmuskip \message
\mkern \month \moveleft \moveright \mskip \multiply \muskip \muskipdef
\newlinechar \noalign \noboundary \noexpand \noindent \nolimits
\nonscript \nonstopmode \nulldelimiterspace \nullfont \number
\omit \openin \openout \or \outer \output \outputpenalty \over
\overfullrule \overline \overwithdelims \pagedepth \pagefilllstretch
\pagefillstretch \pagefilstretch \pagegoal \pageshrink \pagestretch
\pagetotal \par \parfillskip \parindent \parshape \parskip
\patterns \pausing \penalty \postdisplaypenalty \predisplaypenalty
19
2. Getting Started
\raise \read \relax \relpenalty \right \righthyphenmin \rightskip
\romannumeral \scriptfont \scriptscriptfont \scriptscriptstyle
\scriptspace \scriptstyle \scrollmode \setbox \setlanguage \sfcode
\shipout \show \showbox \showboxbreadth \showboxdepth \showlists
\showthe \skewchar \skip \skipdef \spacefactor \spaceskip \span
\special \splitbotmark \splitfirstmark \splitmaxdepth \splittopskip
\string \tabskip \textfont \textstyle \the \thickmuskip \thinmuskip
\time \toks \toksdef \tolerance \topmark \topskip \tracingcommands
\tracinglostchars \tracingmacros \tracingonline \tracingoutput
\tracingpages \tracingparagraphs \tracingrestores \tracingstats
\uccode \uchyph \underline \unhbox \unhcopy \unkern \unpenalty \unskip
\vfil \vfill \vfilneg \vfuzz \voffset \vrule \vsize \vskip \vsplit \vss
\vtop \wd \widowpenalty \write \xdef \xleaders \xspaceskip \year
2.5. Running εXTEX
Currently εXTEX can be run from the command line. In this respect it is more or less
identical to TEX and can be used as a plug-in replacement.
The following sample show a simple invocation of εXTEX without any command line
arguments.
# extex
This is ExTeX, Version 0.0 (TeX compatibility mode)
**\relax
*\end
No pages of output.
Transcript written on ./texput.log.
In this case εXTEX enters interaction with the user and asks for an input file. This
is indicated by the two asterisks. We have entered \relax here to indicate that we are
not willing to pass in a file name. The εXTEX system asks us to enter some command –
indicted by the single asterisk. Here we have entered \end to indicate that we want to
finish the processing. Thus εXTEX terminates normally.
To be completed.
# extex plain
This is ExTeX, Version 0.0 (TeX compatibility mode)
20
2.5. Running εXTEX
more fonts, macros, math definitions, output routines, hyphenation(hyphen))
*\dump
Beginning to dump on file plain.fmt
*\end
No pages of output.
Transcript written on ./plain.log.
2.5.1. Command Line Parameters
The invocation of the executable extex can be controlled by large number of command
line arguments. Those command line arguments are described in the following list:
(code)
This parameter contains εXTEX code to be executed directly. The execution is
performed after any code specified in an input file. On the command line the
code has to start with a backslash. This restriction does not hold for the property
settings.
This command line argument sets the property extex.code
(file)
backslash or an ambercent. It has no default.
This command line argument sets the property extex.file.
– (file)
This parameter terminates the normal processing of arguments. The next argu-
ment – if present – is interpreted as input file. With this construction it is possible
to process an input file which starts with one of the special characters \ or &.
This command line argument sets the property extex.file if a file argument is
present.
-configuration (resource)
This parameter contains the name of the configuration resource to use. This con-
figuration resource is sought on the class path.
This command line argument sets the property extex.config.
This command line option produces a copyright notice on the standard output
stream and terminates the program afterwards.
&(format)
21
2. Getting Started
-fmt (format)
This parameter contains the name of the format to read. An empty string denotes
that no format should be read. This is the default.
This command line argument sets the property extex.fmt.
-debug (spec)
This command line parameter can be used to instruct the program to produce
debugging output of several kinds. The debug output is written to the log file.
The specification (spec) is interpreted left to right. Each character is interpreted
according to the following table:
Spec Description
See
F
This specifier contains the indicator
whether or not to trace the search-
ing for input files.
extex.trace.input.files
f
This specifier contains the indicator
whether or not to trace the search-
ing for font files.
extex.trace.font.files
M
This specifier contains the indicator
whether or not to trace the execu-
tion of macros.
extex.trace.macros
T
This specifier contains the indicator
whether or not to trace the work of
the tokenizer.
extex.trace.tokenizer
The following example shows a possible invocation with this parameter:
# extex -debug FfMT abc.tex
This is ExTeX, Version 0.0 (TeX compatibility mode)
...
-halt-on-error
This parameter contains the indicator whether the processing should halt after the
first error which has been encountered.
This command line argument sets the property extex.halt.on.error.
-help
This command line option produces a short usage description on the standard
output stream and terminates the program afterwards.
-ini
If set to true then act as iniTEX. This command line option is defined for compat-
ibility to TEX only. In εXTEX it has no effect at all.
This command line argument sets the property extex.ini.
The following example shows a possible invocation with this parameter:
22
2.5. Running εXTEX
# extex -ini abc.tex
This is ExTeX, Version 0.0 (TeX compatibility mode)
...
-interaction (mode)
This parameter contains the interaction mode. possible values are the numbers
0. . . 3 and the symbolic names batchmode (0), nonstopmode (1), scrollmode (2),
and errorstopmode (3).
This command line argument sets the property extex.interaction.
The following example shows a possible invocation with this parameter:
# extex -interaction batchmode abc.tex
This is ExTeX, Version 0.0 (TeX compatibility mode)
...
-job-name (name)
This parameter contains the name of the job. It is overwritten if a file is given to
read from. In this case the base name of the input file is used instead.
This command line argument sets the property extex.jobname.
-language (language)
This parameter contains the name of the locale to be used for the messages.
This command line argument sets the property extex.lang.
-output (format)
This parameter contains the output format. This logical name is resolved via the
configuration.
This command line argument sets the property extex.output.
The following example shows a possible invocation with this parameter:
# extex -output pdf abc.tex
This is ExTeX, Version 0.0 (TeX compatibility mode)
-progname (name)
This parameter can be used to overrule the name of the program shown in the
banner and the version information. The following example shows a possible in-
vocation and the resulting output:
# extex -progname XeTxE -version
This is XeTxE, Version 0.0 (1.4.2_06)
#
This command line argument sets the property extex.progname.
23
2. Getting Started
-texinputs (path)
This parameter contains the additional directories for searching εXTEX input files.
The directories are separated by the system-dependant separator. This separator
is a colon (:) on Unix and the semicolon (;) on Windows.
This command line argument sets the property extex.texinputs.
-texmfoutputs (dir)
This parameter contains the name of the property for the fallback if the output
directory fails to be writable.
This command line argument sets the property extex.outputdir.fallback.
-texoutputs (dir)
This parameter contain the directory where output files should be created.
This command line argument sets the property extex.outputdir.
-version
This command line parameter forces that the version information is written to
standard output and the program is terminated. The version of εXTEX is shown
and the version of the Java engine in parentheses. The following example shows a
possible invocation and the resulting output:
# extex -version
This is ExTeX, Version 0.0 (1.4.2_06)
#
Command line parameters can be abbreviated up to a unique prefix – and sometimes
even more. Thus the following invocations are equivalent:
extex -v
extex -ve
extex -ver
extex -vers
extex -versi
extex -versio
extex -version
2.5.2. Creating Formats
To be completed.
24
3. Troubleshooting εXTEX
This chapter contains some hints in the case of trouble.
εXTEX has a configurable search for external resources. This search is controlled by
several parameters.
To be completed.
3.2. Why are is the log file different from TEX’s?
εXTEX has the goal to produce a visual result comparable to the one of TEX. It has been
decided explicitly that the contents of the log file is not considered for compatibility.
The log file is meant for a human reader who should not have any trouble with the
differences. The log file is not meant to be a means for communicating with another
program.
25
3. Troubleshooting εXTEX
26
4. The Macro Language of εXTEX
4.1. Basic Syntactic Entities of εXTEX
The underlying parsing routines provide several sytactic entities which are user across the
parsing of primitives and their arguments. These general syntactic entities are describes
in this section.
The Syntactic Entity (8-bit number)
(8-bit number)
A number consists of a non-empty sequence of digits with category code OTHER. The
check for a maximal value of 255 is not performed in εXTEX.
The Syntactic Entity (box)
This method parses the following syntactic entity:
(box)
The Syntactic Entity (box register name)
A box register name determines under which key a box register can be addressed. In
TEX this used to be a positive number only. This has been extended to allow also a
token list in braces.
Syntax
(box register name)
→ (tokens)
|
(number)
Examples
123 abc
27
4. The Macro Language of εXTEX
The Syntactic Entity (control sequence)
(control sequence)
A control sequence is either a active character or an escape sequence.
The Syntactic Entity (dimen)
This method parses the following syntactic entity:
(dimen)
→ ...
To be completed.
The Syntactic Entity (equals)
This method parses the following syntactic entity:
(equals)
→ (optional spaces)
|
(optional spaces) =12
The Syntactic Entity (filename)
This method parses the following syntactic entity:
(file name)
The scanning is performed in one of two ways:
• If the first token is a left brace then a block is read until the matching right brace
is found. On the way the tokens are expanded.
• Otherwise tokens are read until a space token is encountered.
The Syntactic Entity (font)
This method parses the following syntactic entity:
(font)
28
4.2. Primitives of εXTEX
The Syntactic Entity (general text)
This method corresponds to the following syntax specification:
(general text)
The Syntactic Entity (number)
(number)
A number consists of a non-empty sequence of digits with category code OTHER. The
number is optionally preceded by white space and a sign + or -.
Tokens are expanded while gathering the requested values.
The Syntactic Entity (replacement text)
This method corresponds to the following syntax specification:
(replacement text)
The Syntactic Entity (token)
(token)
A single token depends on the category code of the characters.
4.2. Primitives of εXTEX
εXTEX defines a lot of primitives. Those primitives are described below.
The Primitive \
This primitive inserts an explicite space into the current list. This has an effect in
horizontal or restricted horizontal modes only. In other modes it has no effect.
The formal description of this primitive is the following:
(space primitive)
→ \
Examples:
123\ 456
123\ \ 456
The primitive \ is defined in the set tex.
29
4. The Macro Language of εXTEX
The Primitive \/
To be completed.
The formal description of this primitive is the following:
(italic correction)
→ \/
Examples:
123\/456
The primitive \/ is defined in the set tex.
The Primitive \\
To be completed.
The formal description of this primitive is the following:
(newline)
→ \\
Examples:
\\
The primitive \
is defined in the set tex.
The Math Primitive \above
To be completed.
Syntax
The formal description of this primitive is the following:
(above)
→ ... \above ...
30
4.2. Primitives of εXTEX
Examples
{a \above b}
The primitive \above is defined in the set tex.
The Glue Primitive \abovedisplayshortskip
\abovedisplayshortskip is a skip register. The primitive \abovedisplayshortskip
is defined in the set tex.
The Glue Primitive \abovedisplayskip
\abovedisplayskip is a skip register. The primitive \abovedisplayskip is defined in
the set tex.
The Math Primitive \abovewithdelims
To be completed.
Syntax
The formal description of this primitive is the following:
(abovewithdelims)
→ ... \abovewithdelims ...
Examples
\abovewithdelims
The primitive \abovewithdelims is defined in the set tex.
The Primitive \accent
To be completed.
The formal description of this primitive is the following:
(accent)
→ \accent ...
31
4. The Macro Language of εXTEX
Examples:
\accent 13 a
The primitive \accent is defined in the set tex.
The primitive \addafterocplist is defined in the set omega.
The primitive \addbeforeocplist is defined in the set omega.
\adjdemerits is a count register. The primitive \adjdemerits is defined in the set tex.
This primitive implements an assignment. The variable given as next tokens is incre-
mented by the quantity given after the optional by.
The formal description of this primitive is the following:
(optional prefix)
|
\global (optional prefix)
→ (integer variable) (optional by ) (number)
|
(dimen variable) (optional by ) (dimen)
|
(glue variable) (optional by ) (glue)
|
(muglue variable) (optional by ) (muglue)
(optional by )
→ [by]
|
(optional spaces)
Examples:
The primitive \advance is defined in the set tex.
32
4.2. Primitives of εXTEX
The Primitive \afterassignment
The primitive \afterassignment registers the token to be inserted after the next as-
signment. Note that there is at most one token to be inserted after the next assignment.
Thus the primitive may overwrite any previously registered token.
The formal description of this primitive is the following:
(afterassignment)
→ \afterassignment (token)
Examples:
\afterassignment\abc
\afterassignment X
\afterassignment ~
The primitive \afterassignment is defined in the set tex.
The Primitive \aftergroup
This primitive takes the next token and saves it. The saved token will be inserted after
the current group has been closed. If several tokens are saved then they will be inserted
in the same sequence as they are saved.
Syntax
The formal description of this primitive is the following:
(aftergroup)
→ \aftergroup (token)
Example:
{\aftergroup~ xyz}
{\aftergroup\a\aftergroup\b xyz}
The primitive \aftergroup is defined in the set tex.
The Math Primitive \atop
To be completed.
33
4. The Macro Language of εXTEX
Syntax
The formal description of this primitive is the following:
(atop)
→ ... \atop ...
Examples
\atop
The primitive \atop is defined in the set tex.
The Math Primitive \atopwithdelims
To be completed.
Syntax
The formal description of this primitive is the following:
(atopwithdelims)
→ ... \atopwithdelims ...
Examples
\atopwithdelims
The primitive \atopwithdelims is defined in the set tex.
To be completed.
The formal description of this primitive is the following:
Examples
The primitive \badness is defined in the set tex.
34
4.2. Primitives of εXTEX
The Glue Primitive \baselineskip
\baselineskip is a skip register. The primitive \baselineskip is defined in the set
tex.
The Primitive \batchmode
This primitive sets the interaction mode to batch mode. In batch mode the processing is
terminated if the program needs input from the terminal or n error occurs. The output
to the terminal is reduced to a minimum.
The setting of the interaction mode is an assignment. The mode is always processed
globally. This means it does not interact with the group concept.
Syntax
The formal description of this primitive is the following:
(batchmode)
→ \batchmode
Examples
\batchmode
The primitive \batchmode is defined in the set tex.
The Primitive \begingroup
The primitive \begingroup starts a new group. The new group inherits all properties
from the previous group.
The group is usually ended by a corresponding \endgroup. If the job is completed
without encountering a proper \endgroup then an error is raised.
Syntax
The formal description of this primitive is the following:
(begingroup)
→ \begingroup
Examples
\begingroup 123 \endgroup
The primitive \begingroup is defined in the set tex.
35
4. The Macro Language of εXTEX
The Primitive \beginL
\beginL is not implemented yet.
The primitive \beginL is defined in the set etex.
The Primitive \beginR
\beginR is not implemented yet.
The primitive \beginR is defined in the set etex.
The Glue Primitive \belowdisplayshortskip
\belowdisplayshortskip is a skip register. The primitive \belowdisplayshortskip
is defined in the set tex.
The Glue Primitive \belowdisplayskip
\belowdisplayskip is a skip register. The primitive \belowdisplayskip is defined in
the set tex.
The Count Primitive \binoppenalty
\binoppenalty is a count register. The primitive \binoppenalty is defined in the set
tex.
The Primitive \botmark
To be completed.
The formal description of this primitive is the following:
\botmark ...
Examples:
\botmark ...
The primitive \botmark is defined in the set tex.
The Primitive \botmarks
\botmarks is not implemented yet.
The primitive \botmarks is defined in the set etex.
36
4.2. Primitives of εXTEX
The Primitive \box
To be completed.
The formal description of this primitive is the following:
(box)
→ \box (8-bit number)
Examples:
\box42
The primitive \box is defined in the set tex.
The Dimen Primitive \boxmaxdepth
\boxmaxdepth is a dimen register. The primitive \boxmaxdepth is defined in the set
tex.
The Count Primitive \brokenpenalty
\brokenpenalty is a count register. The primitive \brokenpenalty is defined in the
set tex.
The Primitive \catcode
The primitive \catcode can be used to influence the tokenizer of εXTEX. This is done
by assigning category codes to single characters.
To be completed.
The assignment is controlled by the prefix macro \global and the count parame-
ter \globaldefs. Usually the assignment is acting on the current group only. If the
count parameter \globaldefs is greater than 0 or the prefix \global is given then the
assignment is applied to all groups.
The following table contains the category codes with their meaning and the mapping
to numerical values.
37
4. The Macro Language of εXTEX
ESCAPE
0
LEFTBRACE
1
RIGHTBRACE
2
MATHSHIFT
3
TABMARK
4
CR
5
MACROPARAM
6
SUPMARK
7
SUBMARK
8
IGNORE
9
SPACE
10
LETTER
11
OTHER
12
ACTIVE
13
COMMENT
14
INVALID
15
Syntax
The formal description of this primitive is the following:
(catcode)
→ (prefix) \catcode (8-bit number) (equals) (4-bit number)
(prefix)
|
(global)
Examples
\catcode ‘\%=12
\global\catcode ‘\%=11
\catcode as a Count Value
\catcode can be used wherever a count value is required.
The primitive \catcode is defined in the set tex.
The Primitive \char
The primitive \char provides access to any character in the current font. The argu-
ment is the numeric value of the character. This value can be any expanded expression
resulting in a number of the proper range.
If no proper argument is found then an error is raised.
38
4.2. Primitives of εXTEX
Syntax
The formal description of this primitive is the following:
(char)
→ \char (number)
Examples
\char42
\char\count1
The primitive \char is defined in the set tex.
The Primitive \chardef
To be completed.
Syntax
The formal description of this primitive is the following:
(chardef )
→ \chardef (control sequence) (equals) (8-bit number)
Examples
\chardef\abc=45
\chardef\abc 33
The primitive \chardef is defined in the set tex.
To be completed.
The formal description of this primitive is the following:
Examples:
The primitive \cleaders is defined in the set tex.
39
4. The Macro Language of εXTEX
The Primitive \clearocplists
\clearocplists is not implemented yet.
The primitive \clearocplists is defined in the set omega.
The Primitive \closein
The primitive takes one expanded integer argument. This argument denotes a read
register which will be closed if it is currently assigned to a file.
Syntax
The formal description of this primitive is the following:
(closein)
→ \closein (number)
Examples
\closein5
\closein\count120
The primitive \closein is defined in the set tex.
The Primitive \closeout
The primitive takes one expanded integer argument. This argument denotes a write
register which will be closed if it is currently assigned to a file.
Syntax
The formal description of this primitive is the following:
(closeout)
→ \closeout (number)
Examples
\closeout5
\closeout\count120
The primitive \closeout is defined in the set tex.
40
4.2. Primitives of εXTEX
The Primitive \clubpenalties
\clubpenalties is not implemented yet.
The primitive \clubpenalties is defined in the set etex.
The Count Primitive \clubpenalty
\clubpenalty is a count register. The primitive \clubpenalty is defined in the set tex.
The Primitive \copy
To be completed.
The formal description of this primitive is the following:
(copy)
→ \copy (8-bit number)
Examples:
\copy42
The primitive \copy is defined in the set tex.
The Primitive \count
To be completed.
Syntax
The formal description of this primitive is the following:
(count)
→ \count (8-bit number) (equals) (number)
Examples
\count23=-456
The primitive \count is defined in the set tex.
41
4. The Macro Language of εXTEX
The Primitive \countdef
To be completed.
The formal description of this primitive is the following:
(countdef )
→ \countdef (control sequence) (equals) (8-bit number)
Examples:
\countdef\abc=45
\countdef\abc 33
The primitive \countdef is defined in the set tex.
The Primitive \cr
To be completed.
The formal description of this primitive is the following:
(cr)
→ \cr
Examples:
\cr
The primitive \cr is defined in the set tex.
The Primitive \crcr
To be completed.
The formal description of this primitive is the following:
(crcr)
→ \crcr
Examples:
\crcr
The primitive \crcr is defined in the set tex.
42
4.2. Primitives of εXTEX
The Primitive \csname
To be completed.
When TEX expands \csname it reads to the matching \endcsname, expanding tokens
as it goes; only character tokens should remain after this expansion has taken place.
Then the “expansion” of the entire \csname...\endcsname text will be a single control
sequence token, defined to be like \relax if its meaning is currently undefined.
Syntax
The formal description of this primitive is the following:
(csname)
→ \csname (...) \endcsname
Examples
\csname abc\endcsname
\csname ab#de\endcsname
The example is valid. It shows that even non-character tokens might be contained.
\csname \TeX\endcsname
This is usually illegal since \TeX is defined in plain to contain some non-expandable
primitives.
The primitive \csname is defined in the set tex.
The Primitive \currentgrouplevel
...
The formal description of this primitive is the following:
(currentgrouplevel)
→ \currentgrouplevel
Examples:
\the\currentgrouplevel
The primitive \currentgrouplevel is defined in the set etex.
The Primitive \currentgrouptype
\currentgrouptype is not implemented yet.
The primitive \currentgrouptype is defined in the set etex.
43
4. The Macro Language of εXTEX
The Primitive \currentifbranch
\currentifbranch is not implemented yet.
The primitive \currentifbranch is defined in the set etex.
The Primitive \currentiflevel
\currentiflevel is not implemented yet.
The primitive \currentiflevel is defined in the set etex.
The Primitive \currentiftype
\currentiftype is not implemented yet.
The primitive \currentiftype is defined in the set etex.
The Count Primitive \day
\day is a count register. The primitive \day is defined in the set tex.
\deadcycles is a count register. The primitive \deadcycles is defined in the set tex.
The Primitive \def
To be completed.
The formal description of this primitive is the following:
(def )
→ (prefix) \def (control sequence) (parameter text) { (replacement text) }
(prefix)
|
\global (prefix)
|
\long (prefix)
|
\outer (prefix)
Examples:
\def#1{--#1--}
The primitive \def is defined in the set tex.
44
4.2. Primitives of εXTEX
The Count Primitive \defaulthyphenchar
\defaulthyphenchar is a count register. The primitive \defaulthyphenchar is defined
in the set tex.
The Primitive \DefaultInputMode
\DefaultInputMode is not implemented yet.
The primitive \DefaultInputMode is defined in the set omega.
The Primitive \DefaultInputTranslation
\DefaultInputTranslation is not implemented yet.
The primitive \DefaultInputTranslation is defined in the set omega.
The Primitive \DefaultOutputMode
\DefaultOutputMode is not implemented yet.
The primitive \DefaultOutputMode is defined in the set omega.
The Primitive \DefaultOutputTranslation
\DefaultOutputTranslation is not implemented yet.
The primitive \DefaultOutputTranslation is defined in the set omega.
The Count Primitive \defaultskewchar
\defaultskewchar is a count register. The primitive \defaultskewchar is defined in
the set tex.
The Math Primitive \delcode
The primitive \delcode can be used to assign and query the delimiter code for a char-
acter. The delimiter code determines, how a character is typeset in math mode.
The TEX encoding interprets the number as 27 bit hex number: "csyylxx. Here the
digits have the following meaning:
c the math class of this delimiter. It has a range from 0 to 7.
l the family for the large character. It has a range from 0 to 15.
xx the character code of the large character.
s the family for the small character. It has a range from 0 to 15.
yy the character code of the small character.
45
4. The Macro Language of εXTEX
The assigning a new value to a delimiter code acts in a group restricted way unless
declared differently. If the prefix \global is given then the assignment is performed
globally. The same effect can be achieved when the count register \globaldefs is
greater than 0.
Syntax
The formal description of this primitive is the following:
(delcode)
→ (prefix) \delcode (8-bit number) (equals) (8-bit number)
(prefix)
|
(global)
Examples
\delcode‘x="123456
\global\delcode‘x="123456
Using as Count Register
The primitive \delcode can be used like a count register. This means you can use it
wherever a number is expected. In addition the value can be advanced, multiplied, and
divided. In any case the delimiter code is translated according to the TEX encoding and
processed as number.
Examples
\count1=\delcode‘x
The primitive \delcode is defined in the set tex.
The Math Primitive \delimiter
The math primitive \delimiter can be used to insert a delimiter. Thus it is possible
to bypass the definition of the delimiter code as assigned to single characters.
To be completed.
46
4.2. Primitives of εXTEX
Syntax
The formal description of this primitive is the following:
(delimiter)
→ \delimiter (delcode)
Examples
\delimiter "426830A
The primitive \delimiter is defined in the set tex.
The Count Primitive \delimiterfactor
\delimiterfactor is a count register. The primitive \delimiterfactor is defined in
the set tex.
The Dimen Primitive \delimitershortfall
\delimitershortfall is a dimen register. The primitive \delimitershortfall is de-
fined in the set tex.
The Primitive \detokenize
\detokenize is not implemented yet.
The primitive \detokenize is defined in the set etex.
The Primitive \dimen
The primitive \dimen provides access to the dimen registers. Those registers contain
length values.
To be completed.
Syntax
The formal description of this primitive is the following:
(dimen)
→ (prefix) \dimen (key) ...
47
4. The Macro Language of εXTEX
Examples
\dimen1=12 pt
The primitive \dimen is defined in the set tex.
The Primitive \dimendef
To be completed.
The formal description of this primitive is the following:
(dimendef )
→ \dimendef (control sequence) (equals) (8-bit number)
Examples:
\dimendef\abc=45
\dimendef\abc 33
The primitive \dimendef is defined in the set tex.
The Primitive \dimenexpr
The primitive \dimenexpr provides a means to use a inline way of writing mathematical
expressions to be evaluated. Mathematical expressions can be evaluated in εXTEX using
\advance, \multiply, and \divide. Nevertheless those primitives result in an assign-
ment. This is not the case for \dimenexpr. Here the intermediate results are not stored
in dimen registers but kept internally. Also the application of \afterassignment and
\tracingassigns is suppressed.
The mathematical expression to be evaluated can be made up of the basic operations
addition (+), subtraction (-), multiplication (*) with numbers, and division(/) by num-
bers. The unary minus can be used. Parentheses can be used for grouping. Anything
which looks like a length can be used as argument. White-space can be used freely
without any harm.
The expression is terminated at the first token which can not be part of an expression.
For instance a letter may signal the end of the expression. If the expression should
terminate without a proper token following it, the token \relax can be used to signal
the end of the expression. This \relax token is silently consumed by \dimenexpr.
The primitive \dimenexpr can be used in any place where a dimen is required. This
includes assignments to dimen registers and comparisons.
48
4.2. Primitives of εXTEX
Syntax
The formal description of this primitive is the following:
(dimenexpr)
→ \dimenexpr (expr) \relax
|
\dimenexpr (expr)
(expr)
→ (operand)
|
(operand) + (expr)
|
(operand) - (expr)
(operand)
→ (dimen)
|
(operand) * (number)
|
(number) * (operand)
|
(operand) / (number)
|
- (expr)
|
( (expr) )
Examples
\count1=\dimenexpr 23pt \relax
\count1=\dimenexpr 2 * 3pt \relax
\count1=\dimenexpr 2pt*\count2
\count1=\dimenexpr 2*(1pt+3em)
\count1=\dimenexpr 2*-\dimen0
The primitive \dimenexpr is defined in the set etex.
The Primitive \discretionary
The primitive \discretionary can be used to insert an optional break point into the
paragraph. The optional break point consists of three parts. The first part is inserted
into the paragraph if no line breaking happens at this position. In case that the line
breaking chooses this place for a line break then the second part of the discretionary is
inserted at the end of the current line and the third part is inserted at the beginning of
the next line.
The three parts are given as three sequences of characters in braces. It may be
composed of characters, ligatures, and rules only.
In math mode the third part is forced to be empty.
49
4. The Macro Language of εXTEX
Syntax
The formal description of this primitive is the following:
(discretionary)
→ \discretionary.........
Examples
\discretionary{f-}{fi}{ffi}
\discretionary{-}{}{}
The primitive \discretionary is defined in the set tex.
The Dimen Primitive \displayindent
\displayindent is a dimen register. The primitive \displayindent is defined in the
set tex.
The Math Primitive \displaylimits
To be completed.
Syntax
The formal description of this primitive is the following:
(displaylimits)
→ \displaylimits
Examples
\displaylimits
The primitive \displaylimits is defined in the set tex.
The Math Primitive \displaystyle
To be completed.
50
4.2. Primitives of εXTEX
Syntax
The formal description of this primitive is the following:
(displaystyle)
→ \displaystyle
Examples
\displaystyle
The primitive \displaystyle is defined in the set tex.
The Primitive \displaywidowpenalties
\displaywidowpenalties is not implemented yet.
The primitive \displaywidowpenalties is defined in the set etex.
The Count Primitive \displaywidowpenalty
\displaywidowpenalty is a count register. The primitive \displaywidowpenalty is
defined in the set tex.
The Dimen Primitive \displaywidth
\displaywidth is a dimen register. The primitive \displaywidth is defined in the set
tex.
The Primitive \divide
This primitive implements an assignment. The variable given as next tokens is divided
by the quantity given after the optional by.
The formal description of this primitive is the following:
(divide)
→ \divide (dividable)
(dividable)
→ (integer variable) (optional by ) (8-bit number)
|
(dimen variable) (optional by ) (8-bit number)
|
(glue variable) (optional by ) (8-bit number)
|
(muglue variable) (optional by ) (8-bit number)
(optional by )
→ [by]
|
(optional spaces)
51
4. The Macro Language of εXTEX
Examples:
\divide\count12 345
\divide\count12 by -345
The primitive \divide is defined in the set tex.
The Count Primitive \doublehyphendemerits
\doublehyphendemerits is a count register. The primitive \doublehyphendemerits is
defined in the set tex.
The Primitive \dp
The primitive \dp refers to the depth of a box register. It can be used in various contexts.
Execution of the Primitive
If the primitive is used in a context it initiated an assignment to the actual depth of the
box register. This has an effect only in the case that the box register is not void.
The formal description of this primitive is the following:
(dp)
→ (optional prefix) \dp (8-bit number) (equals) (dimen)
(optional prefix)
|
\global (optional prefix)
Examples:
\dp42 = 12mm
\dp42 = \dimen3
Expansion of the Primitive
In an expansion context the primitive results in the the currentr depth of the given box
register. In case that the box register is empty the result is 0 pt.
The formal description of this primitive is the following:
\dp (8-bit number)
Examples:
\dimen0 = \dp42
52
4.2. Primitives of εXTEX
Conversion to a Count
To be completed.
Interaction with \the
To be completed.
The primitive \dp is defined in the set tex.
The Primitive \dump
The primitive writes out the current state of the interpreter to an format file. This
format file can be read back in to restore the saved state.
The primitive can be used outside of any group only.
To be completed.
Syntax
The formal description of this primitive is the following:
(dump)
→ \dump
Examples
\dump
The primitive \dump is defined in the set tex.
The Primitive \edef
To be completed.
The formal description of this primitive is the following:
53
4. The Macro Language of εXTEX
(edef )
→ (prefix) \edef (control sequence) (parameter text) { (replacement text) }
(prefix)
|
\global (prefix)
|
\long (prefix)
|
\outer (prefix)
Examples:
\edef#1{--#1--}
The primitive \edef is defined in the set tex.
The Primitive \efcode
\efcode is not implemented yet.
The primitive \efcode is defined in the set pdftex.
The Primitive \else
The primitive \else can not be used alone. It always comes in conjunction with a
conditional. A isolated \else leads to an error immediately.
Syntax
The formal description of this primitive is the following:
(else)
→ \else (...)
Examples
\ifnum 1<2\else no\fi
The primitive \else is defined in the set tex.
The Dimen Primitive \emergencystretch
\emergencystretch is a dimen register. The primitive \emergencystretch is defined
in the set tex.
The Primitive \end
The primitive \end closes all input stream and discards all tokens which might be waiting
to be read. This usually mean the end of the processing of one document.
54
4.2. Primitives of εXTEX
Syntax
The formal description of this primitive is the following:
(end)
→ \end
Examples
\end
The primitive \end is defined in the set tex.
The Primitive \endcsname
The macro \endcsname is used in combination with the macro \csname only. Whenever
a \endcsname is seen alone it must be an error. Thus thus primitive produces an error
message in any case.
Syntax
The formal description of this primitive is the following:
(endcsname)
→ \endscsname
Examples
The following example shows a complicated way to invoke the macro abc. Here the
primitive \endcsname is legal. It is consumed by the primitive \csname and nt expanded
by its own.
\csname abc\endcsname
The primitive \endcsname is defined in the set tex.
The Primitive \endgroup
The primitive \endgroup closes the current group all properties are reset to the val-
ues they had before the group had been entered. A group is usually opened with
\begingroup.
If no group has been opened then an error is raised.
Syntax
The formal description of this primitive is the following:
(endgroup)
→ \endgroup
55
4. The Macro Language of εXTEX
Examples
\begingroup 123 \endgroup
The primitive \endgroup is defined in the set tex.
The Primitive \endinput
The primitive \endinput closes the topmost file input stream. All tokens collected for
this input stream and the ones above are discarded. This means that you can place
arbitrary text behind this primitive in a file. This text is ignored immediately.
Syntax
The formal description of this primitive is the following:
(endinput)
→ \endinput
Examples
\endinput ... and some ignored text
The primitive \endinput is defined in the set tex.
The Primitive \endL
\endL is not implemented yet.
The primitive \endL is defined in the set etex.
The Count Primitive \endlinechar
\endlinechar is a count register. The primitive \endlinechar is defined in the set tex.
The Primitive \endR
\endR is not implemented yet.
The primitive \endR is defined in the set etex.
The Math Primitive \eqno
To be completed.
56
4.2. Primitives of εXTEX
Syntax
The formal description of this primitive is the following:
(eqno)
→ \eqno
Examples
\eqno
The primitive \eqno is defined in the set tex.
The Toks Primitive \errhelp
\errhelp is a toks register. The primitive \errhelp is defined in the set tex.
The Primitive \errmessage
The primitive \errmessage takes one argument. This argument is an expanded list of
tokens. Those tokens are presented as error message
The formal description of this primitive is the following:
(eqno)
→ \errmessage (tokens)
Examples:
\errmessage{}
The primitive \errmessage is defined in the set tex.
The Count Primitive \errorcontextlines
\errorcontextlines is a count register. The primitive \errorcontextlines is defined
in the set tex.
The Primitive \errorstopmode
This primitive sets the interaction mode to error stop mode. In error stop mode the
processing is interrupted and the error handler is invoked when an error occurs.
The setting of the interaction mode is an assignment. The mode is always processed
globally. This means it does not interact with the group concept.
57
4. The Macro Language of εXTEX
Syntax
The formal description of this primitive is the following:
(errorstopmode)
→ \errorstopmode
Examples
\errorstopmode
The primitive \errorstopmode is defined in the set tex.
The Count Primitive \escapechar
\escapechar is a count register. The primitive \escapechar is defined in the set tex.
The Toks Primitive \eTeXrevision
\eTeXrevision is a toks register. The primitive \eTeXrevision is defined in the set
etex.
The Count Primitive \eTeXversion
\eTeXversion is a count register. The primitive \eTeXversion is defined in the set
etex.
The Toks Primitive \everycr
\everycr is a toks register. The primitive \everycr is defined in the set tex.
The Toks Primitive \everydisplay
\everydisplay is a toks register. The primitive \everydisplay is defined in the set
tex.
The Toks Primitive \everyeof
\everyeof is a toks register. The primitive \everyeof is defined in the set etex.
The Toks Primitive \everyhbox
\everyhbox is a toks register. The primitive \everyhbox is defined in the set tex.
58
4.2. Primitives of εXTEX
The Toks Primitive \everyjob
\everyjob is a toks register. The primitive \everyjob is defined in the set tex.
The Toks Primitive \everymath
\everymath is a toks register. The primitive \everymath is defined in the set tex.
The Toks Primitive \everypar
\everypar is a toks register. The primitive \everypar is defined in the set tex.
The Toks Primitive \everyvbox
\everyvbox is a toks register. The primitive \everyvbox is defined in the set tex.
The Count Primitive \exhyphenpenalty
\exhyphenpenalty is a count register. The primitive \exhyphenpenalty is defined in
the set tex.
The Primitive \expandafter
To be completed.
TEX first reads the token that comes immediately after \expandafter, without ex-
panding it; let’s call this token t. Then TEX reads the token that comes after t (and
possibly more tokens, if that token has an argument), replacing it by its expansion.
Finally TEX puts t back in front of that expansion.
The formal description of this primitive is the following:
(expandafter)
→ \expandafter (control sequence) ...
Examples:
\expandafter ...
The primitive \expandafter is defined in the set tex.
59
4. The Macro Language of εXTEX
The Primitive \export
The primitive \export takes a list of tokens and saves them away for an associated
\import. The tokens in the list are either control sequence tokens or active characters.
All other tokens are ignored.
The formal description of this primitive is the following:
(export)
→ \export (replacement text)
Examples:
\export{\a\b}
The primitive \export is defined in the set namespace.
The Count Primitive \fam
\fam is a count register. The primitive \fam is defined in the set tex.
The Primitive \fi
This primitive indicates the end of an conditional. As such it can not appear alone but
only in combination with a preceding \if*.
Syntax
The formal description of this primitive is the following:
(fi)
→ \fi
Examples
\fi
The primitive \fi is defined in the set tex.
The Count Primitive \finalhyphendemerits
\finalhyphendemerits is a count register. The primitive \finalhyphendemerits is
defined in the set tex.
60
4.2. Primitives of εXTEX
The Primitive \firstmark
To be completed.
The formal description of this primitive is the following:
\firstmark ...
Examples:
\firstmark ...
The primitive \firstmark is defined in the set tex.
The Primitive \firstmarks
\firstmarks is not implemented yet.
The primitive \firstmarks is defined in the set etex.
The Count Primitive \floatingpenalty
\floatingpenalty is a count register. The primitive \floatingpenalty is defined in
the set tex.
The Primitive \font
The primitive \font can be used to load a font with some specified properties and assign
it to a control sequence. The primary option is the specification of a size for the font. If
no size is given then the font is loaded at its design size.
An exact size can be specified with the at keyword. The dimension following this
keyword determines the size of the font.
The design size can be multiplied by a scale factor. This scale fator is given as number
after the keyword scaled. The value given is 1000 times the scale factor to be used.
To be completed.
This primitive is an assignment.
The formal description of this primitive is the following:
(font)
→ \font (control sequence) (equals) (font name) (options)
(options)
→ (option)
|
(option) (options)
(option)
61
4. The Macro Language of εXTEX
→ [scaled] (number)
|
[at] (size...)
|
[noligatures]
|
[nokerning]
|
[letterspaced]
Examples
In the following example the font cmr12 is loaded at its design size. The macro \myfont
is bound to this font.
\font\myfont=cmr12
In the following example the font cmr12 is loaded at the size 15pt. The macro \myfont
is bound to this font.
\font\myfont=cmr12 at 15pt
In the following example the font cmr12 is loaded at the double design size. The scale
factor 2000 is divided by 1000 to get the effective scaling factor. The macro \myfont is
bound to this font.
\font\magnifiedfiverm=cmr5 scaled 2000
In the following example the font cmr10 is loaded at the size of 12 true pt. The macro
\myfont is bound to this font.
\font\second=cmr10 at 12truept
The primitive \font is defined in the set tex.
The Primitive \fontchardp
To be completed.
The formal description of this primitive is the following:
(fontchardp)
→ \fontchardp (font) (number)
Examples:
\dimen0 = \fontchardp\tenrm ‘a
The primitive \fontchardp is defined in the set etex.
62
4.2. Primitives of εXTEX
The Primitive \fontcharht
To be completed.
The formal description of this primitive is the following:
\fontcharht
Examples:
\fontcharht\tenrm ‘a
The primitive \fontcharht is defined in the set etex.
The Primitive \fontcharic
To be completed.
The formal description of this primitive is the following:
\fontcharic
Examples:
\fontcharic\tenrm ‘a
The primitive \fontcharic is defined in the set etex.
The Primitive \fontcharwd
To be completed.
The formal description of this primitive is the following:
\fontcharwd
Examples:
\fontcharwd\tenrm ‘a
The primitive \fontcharwd is defined in the set etex.
63
4. The Macro Language of εXTEX
The Primitive \fontdimen
The primitive \fontdimen can be used to set a font dimension value. Each font has an
arbitrary number of dimen values which are addressed by an numerical index in TEX.
In εXTEX this has been extended to arbitrary strings.
The primitive expands to the value of the font dimension in a right hand context.
The formal description of this primitive is the following:
\fontdimen (8-bit number) (font) (equals) (dimen)
To be completed.
Examples:
\fontdimen13\ff=5pt
\the\fontdimen13\ff
\the\fontdimen{em}\ff=8pt
The primitive \fontdimen is defined in the set tex.
The Primitive \fontname
The primitive \fontname can be used to retrieve the name of a font. It takes a font
specification as argument. It expands to the name of the font. If this font is not loaded
at its design size then the actual size is appended after the tokens at . All tokens
produced this way are other tokens except of the spaces. Ths means that even the
letters are of category other.
The primitive \fontname is defined in the set tex.
The Primitive \futurelet
To be completed.
The formal description of this primitive is the following:
(futurelet)
→ \futurelet (control sequence) (token) ...
Examples:
\futurelet ...
The primitive \futurelet is defined in the set tex.
64
4.2. Primitives of εXTEX
The Primitive \gdef
To be completed.
The formal description of this primitive is the following:
(gdef )
→ (prefix) \gdef (control sequence) (parameter text) { (replacement text) }
(prefix)
|
\global (prefix)
|
\long (prefix)
|
\outer (prefix)
Examples:
\gdef#1{--#1--}
The primitive \gdef is defined in the set tex.
The Prefix Primitive \global
The primitive \global is a prefix macro. It does not do anything by its own but works in
combination with a following primitive token only. If the following token constitutes an
assignment then the assignment is not restricted to the current group but acts globallay
in all groups.
If the following command token does not happen to be an operation for which the
global modifier is applicable then a warning might be raised.
The formal description of this primitive is the following:
(global)
→ \global (...)
Examples
The following example shows that two macros defined in a group. The first macro falls
back to its previous binding when the group is closed. The second macro has the same
binding in all groups. defined.
\begingroup
\def\a{123}
\global\def\b{123}
\endgroup
The following example shows that two count registers are set in a group. The first count
register keeps its value untile the group is closed and falls back to the value it had when
the group has been entered. The second count register keeps its value even when the
group is closed.
65
4. The Macro Language of εXTEX
\begingroup
\count1=123
\global\count2=45
\endgroup
The primitive \global is defined in the set tex.
The Count Primitive \globaldefs
\globaldefs is a count register. The primitive \globaldefs is defined in the set tex.
The Primitive \glueexpr
\glueexpr is not implemented yet.
The primitive \glueexpr is defined in the set etex.
The Primitive \glueshrink
The primitive \glueshrink translates a shrink part of a glue value into a length. The
shrink order is stripped and just the size is preserved. The unit is changed to pt. For
instance, if the value considered is 8pt minus 1.23 fil then \glueshrink returns 1.23 pt.
The primitive \glueshrink can be used wherever a length is expected. The primitive
is also applicable to \the.
Syntax
The formal description of this primitive is the following:
(glueshrink)
→ \glueshrink (glue)
Examples
\glueshrink\skip1
The primitive \glueshrink is defined in the set etex.
The Primitive \glueshrinkorder
The primitive \glueshrinkorder determines the order of the glue shrink component of
the following glue specification. A fixed, non-shrinkable glue returns the value 0. Glue
with the order fil gives 1, fill gives 2, and filll gives 3.
Note that the glue specification of 1 fi returns also 1. This is due to the compatibility
with ε-TEX which does not have this unit. This unit has been introduced by Omega.
The formal description of this primitive is the following:
66
4.2. Primitives of εXTEX
(glueshrinkorder)
→ \glueshrinkorder (glue)
Examples
\glueshrinkorder\skip1
The primitive \glueshrinkorder is defined in the set etex.
The Primitive \gluestretch
The primitive \gluestretch translates a stretch part of a glue value into a length. The
stretch order is stripped and just the size is preserved. The unit is changed to pt. For
instance, if the value considered is 8pt plus 1.23 fil then \gluestretch returns 1.23 pt.
The primitive \gluestretch can be used wherever a length is expected. The primitive
is also applicable to \the.
Syntax
The formal description of this primitive is the following:
(gluestretch)
→ \gluestretch (glue)
Examples
\gluestretch\skip1
The primitive \gluestretch is defined in the set etex.
The Primitive \gluestretchorder
The primitive \gluestretchorder determines the order of the glue stretch component
of the following glue specification. A fixed, non-stretchable glue returns the value 0.
Glue with the order fil gives 1, fill gives 2, and filll gives 3.
Note that the glue specification of 1 fi returns also 1. This is due to the compatibility
with ε-TEX which does not have this unit. This unit has been introduced by Omega.
The formal description of this primitive is the following:
(gluestretchorder)
→ \gluestretchorder (glue)
Examples
\gluestretchorder\skip1
The primitive \gluestretchorder is defined in the set etex.
67
4. The Macro Language of εXTEX
The Primitive \halign
To be completed.
The formal description of this primitive is the following:
(halign)
→ \halign (box specification) { (preamble) \cr (rows) }
(box specification)
|
to (rule dimension)
|
(rows)
|
(row) (rows)
(preamble)
→ ...
Examples:
\halign
The primitive \halign is defined in the set tex.
The Count Primitive \hangafter
\hangafter is a count register. The primitive \hangafter is defined in the set tex.
The Dimen Primitive \hangindent
\hangindent is a dimen register. The primitive \hangindent is defined in the set tex.
\hbadness is a count register. The primitive \hbadness is defined in the set tex.
The Primitive \hbox
To be completed.
The contents of the toks register \everyhbox is inserted at the beginning of the
horizontal material of the box.
The formal description of this primitive is the following:
68
4.2. Primitives of εXTEX
(hbox)
→ \hbox (box specification) { (horizontal material) }
(box specification)
|
to (rule dimension)
|
Examples:
\hbox{abc}
\hbox to 120pt{abc}
The Tokens Parameter \everyhbox
The tokens parameter is used in /hbox. The tokens contained are inserted at the beginnig
of the horizontal material of the hbox.
The primitive \hbox is defined in the set tex.
The Primitive \hfil
To be completed.
The formal description of this primitive is the following:
(hfi)
→ \hfi
Examples:
\hfi
The primitive \hfi is defined in the set omega.
The Primitive \hfil
To be completed.
The formal description of this primitive is the following:
(hfil)
→ \hfil
69
4. The Macro Language of εXTEX
Examples:
\hfil
The primitive \hfil is defined in the set tex.
The Primitive \hfill
To be completed.
The formal description of this primitive is the following:
(hfill)
→ \hfill
Examples:
\hfill
The primitive \hfill is defined in the set tex.
The Primitive \hfilneg
To be completed.
The formal description of this primitive is the following:
(hfilneg)
→ \hfilneg
Examples:
\hfilneg
The primitive \hfilneg is defined in the set tex.
The Dimen Primitive \hfuzz
\hfuzz is a dimen register. The primitive \hfuzz is defined in the set tex.
The Dimen Primitive \hoffset
\hoffset is a dimen register. The primitive \hoffset is defined in the set tex.
70
4.2. Primitives of εXTEX
The Count Primitive \holdinginserts
\holdinginserts is a count register. The primitive \holdinginserts is defined in the
set tex.
The Primitive \hrule
This primitive produces a horizontal rule. This is a rectangular area of specified di-
mensions. If not overwritten the width and depth are 0pt and the height is 0.4 pt
(26214 sp).
The formal description of this primitive is the following:
(hrule)
→ \hrule (rule specification)
(rule specification)
→ (optional spaces)
|
(rule dimension) (rule specification)
(rule dimension)
→ width (dimen)
|
height (dimen)
|
depth (dimen)
The color from the typographic context is taken as foreground color for the rule. The
default color is black.
Examples:
\hrule
\hrule width 2pt
\hrule width 2pt depth 3mm height \dimen4
The primitive \hrule is defined in the set tex.
The Dimen Primitive \hsize
\hsize is a dimen register. The primitive \hsize is defined in the set tex.
The Primitive \hskip
To be completed.
The formal description of this primitive is the following:
71
4. The Macro Language of εXTEX
(hskip)
→ \hskip (Glue)
Examples:
\hskip 1em plus 1pt minus 1pt
The primitive \hskip is defined in the set tex.
The Primitive \hss
To be completed.
The formal description of this primitive is the following:
(hss)
→ \hss
Examples:
\hss
The primitive \hss is defined in the set tex.
The Primitive \ht
To be completed.
The formal description of this primitive is the following:
(ht)
→ \ht (8-bit number) (equals) (dimen)
Examples:
\ht42
The primitive \ht is defined in the set tex.
The Primitive \hyphenation
To be completed.
72
4.2. Primitives of εXTEX
Syntax
(hyphenation)
→ \hyphenation ...
Example:
\hyphenation{as-so-ciate as-so-ciates}
The primitive \hyphenation is defined in the set tex.
The Primitive \hyphenchar
To be completed.
The formal description of this primitive is the following:
\hyphenchar (font) (equals) (8-bit number)
Examples:
\hyphenchar\font=132
Incompatibility
The TeXbook gives no indication ow the primitive should react for negative values –
except -1. The implementation of TEX allows to store and retrieve arbirary negative
values. This behaviour of TEX is not preserved in εXTEX.
The primitive \hyphenchar is defined in the set tex.
The Count Primitive \hyphenpenalty
\hyphenpenalty is a count register. The primitive \hyphenpenalty is defined in the
set tex.
The Primitive \if
The primitive expands the tokens following it until two unexpandable tokens are found.
The conditional is true iff the character codes of the two tokens agree.
The formal description of this primitive is the following:
(if )
→ \if (token1) (token2) (true text) \fi
|
\if (token1) (token2) (true text) \else (false text) \fi
73
4. The Macro Language of εXTEX
Examples:
\if\a\x ok \fi
The primitive \if is defined in the set tex.
The Primitive \ifcase
To be completed.
(ifcase)
→ \ifcase ...
The primitive \ifcase is defined in the set tex.
The Primitive \ifcat
To be completed.
(ifcat)
→ \ifcat ...
The primitive \ifcat is defined in the set tex.
The Primitive \ifcsname
\ifcsname is not implemented yet.
The primitive \ifcsname is defined in the set etex.
The Primitive \unless
Copied of the eTeX reference.
similar in effect to \unless \ifx \undefined, but does not require \undefined to
actually be undefined, since no explicit comparison is made with any particular control
sequence.
The formal description of this primitive is the following:
To be completed.
Examples:
\ifdefined\TESTNAME\else not\fi defined
The primitive \ifdefined is defined in the set etex.
74
4.2. Primitives of εXTEX
The Primitive \ifdim
To be completed.
The formal description of this primitive is the following:
(ifdim)
→ \ifdim (dimen) (op) (dimen) (true text) \fi
|
\ifdim (dimen) (op) (dimen) (true text) \else (false text) \fi
(op)
→ [<]
|
[=]
|
[>]
The primitive \ifdim is defined in the set tex.
The Primitive \ifeof
This primitive tests for end of file on the given read register. The read register is specified
as a (expanded) number.
The formal description of this primitive is the following:
(ifeof )
→ \ifeof (number) (true text) \fi
|
\ifeof (number) (true text) \else (false text) \fi
Examples:
\ifeof 3 -E-O-F- \else ready \fi
The primitive \ifeof is defined in the set tex.
The Primitive \iffalse
The primitive does not take any further arguments. The conditional is always false.
Thus only the else branch is expanded.
The formal description of this primitive is the following:
(iffalse)
→ \iffalse (true text) \fi
|
\iffalse (true text) \else (false text) \fi
Examples:
\iffalse abc \fi
The primitive \iffalse is defined in the set tex.
75
4. The Macro Language of εXTEX
The Primitive \iffontchar
The primitive \iffontchar can be used to check whether a certain glyph exists in a
font. For this purpose it takes a font and the code of a character and performs the test.
If the character exists the then branch is expanded otherwise the else branch.
The formal description of this primitive is the following:
(iffontchar)
→ \iffontchar ... (true text) \fi
|
\iffontchar ... (true text) \else (false text) \fi
Examples:
\iffontchar abc \fi
The primitive \iffontchar is defined in the set etex.
The Primitive \ifhbox
The primitive takes one expanded integer argument. The conditional is true iff the box
denoted by the argument is a horizontal box.
The formal description of this primitive is the following:
(ifhbox)
→ \ifhbox (number) (true text) \fi
|
\ifhbox (number) (true text) \else (false text) \fi
Examples:
\ifhbox255 abc \fi
\ifhbox\count120 abc \fi
The primitive \ifhbox is defined in the set tex.
The Primitive \ifhmode
The primitive does not take any further arguments. The conditional is true iff the
typesetter is in a horizontal mode. This is either the restricted horizontal vertical mode
or the horizontal mode.
The formal description of this primitive is the following:
(ifhmode)
→ \ifhmode (true text) \fi
|
\ifhmode (true text) \else (false text) \fi
Examples:
\ifhmode abc \fi
The primitive \ifhmode is defined in the set tex.
76
4.2. Primitives of εXTEX
The Primitive \ifinner
The primitive does not take any further arguments. The conditional is true iff the
typesetter is in an internal mode. This is either the internal vertical mode, the restricted
horizontal mode, or the math mode (non-display).
The formal description of this primitive is the following:
(ifinner)
→ \ifinner (true text) \fi
|
\ifinner (true text) \else (false text) \fi
Examples:
\ifinner abc \fi
The primitive \ifinner is defined in the set tex.
The Primitive \ifmmode
The primitive does not take any further arguments. The conditional is true iff the
typesetter is in math mode or display math mode.
The formal description of this primitive is the following:
(ifmmode)
→ \ifmmode (true text) \fi
|
\ifmmode (true text) \else (false text) \fi
Examples:
\ifmmode abc \fi
The primitive \ifmmode is defined in the set tex.
The Primitive \ifnum
To be completed.
The formal description of this primitive is the following:
(ifnum)
→ \ifnum (number) (op) (number) (true text) \fi
|
\ifodd (number) (op) (number) (true text) \else (false text) \fi
(op)
→ [<]
|
[=]
|
[>]
77
4. The Macro Language of εXTEX
Examples:
\ifodd\count0 abc \fi
The primitive \ifnum is defined in the set tex.
The Primitive \ifodd
The primitive takes one expanded integer argument. The conditional is true iff the
argument is odd.
The formal description of this primitive is the following:
(ifodd)
→ \ifodd (number) (true text) \fi
|
\ifodd (number) (true text) \else (false text) \fi
Examples:
\ifodd\count0 abc \fi
The primitive \ifodd is defined in the set tex.
The Primitive \iftrue
The primitive does not take any further arguments. The conditional is always true.
Thus only the then branch is expanded.
The formal description of this primitive is the following:
(iftrue)
→ \iftrue (true text) \fi
|
\ifture (true text) \else (false text) \fi
Examples:
\iftrue abc \fi
The primitive \iftrue is defined in the set tex.
The Primitive \ifvbox
The primitive takes one expanded integer argument. The conditional is true iff the box
denoted by the argument is a vertical box.
The formal description of this primitive is the following:
(ifvbox)
→ \ifvbox (number) (true text) \fi
|
\ifvbox (number) (true text) \else (false text) \fi
Examples:
78
4.2. Primitives of εXTEX
\ifvbox255 abc \fi
\ifvbox\count120 abc \fi
The primitive \ifvbox is defined in the set tex.
The Primitive \ifvmode
The primitive does not take any further arguments. The conditional is true iff the
typesetter is in a vertical mode. This is either the internal vertical mode or the vertical
mode.
The formal description of this primitive is the following:
(ifvmode)
→ \ifvmode (true text) \fi
|
\ifvmode (true text) \else (false text) \fi
Examples:
\ifvmode abc \fi
The primitive \ifvmode is defined in the set tex.
The Primitive \ifvoid
The primitive takes one expanded integer argument. The conditional is true iff the box
denoted by the argument is void.
The formal description of this primitive is the following:
(ifvoid)
→ \ifvoid (number) (true text) \fi
|
\ifvoid (number) (true text) \else (false text) \fi
Examples:
\ifvoid255 abc \fi
\ifvoid\count120 abc \fi
The primitive \ifvoid is defined in the set tex.
The Primitive \ifx
To be completed.
The formal description of this primitive is the following:
79
4. The Macro Language of εXTEX
(ifx)
→ \ifx (token1) (token2); (true text) \fi
|
\ifx (token1) (token2) (true text) \else (false text) \fi
Examples:
\ifx\a\x ok \fi
The primitive \ifx is defined in the set tex.
The Primitive \ignorespaces
To be completed.
The formal description of this primitive is the following:
(ignorespaces)
→ \ignorespaces
Examples:
\ignorespaces
The primitive \ignorespaces is defined in the set tex.
The Prefix Primitive \immediate
To be completed.
The formal description of this primitive is the following:
(immediate)
→ \immediate ...
Examples:
\immediate\write1{abc}
The primitive \immediate is defined in the set tex.
80
4.2. Primitives of εXTEX
The Primitive \import
To be completed.
The formal description of this primitive is the following:
(import)
→ \import (replacement text)
Examples:
\import{de.dante.dtk}
The primitive \import is defined in the set namespace.
The Primitive \indent
To be completed.
The formal description of this primitive is the following:
(indent)
→ \indent
Examples:
The primitive \indent is defined in the set tex.
The Primitive \input
The primitive \input takes as argument one file name and opens this file for reading.
The following tokens are taken from this input stream. Thus the effect is as if the file
contents where copied at the place of the primitive.
If the file can not be opened for reading then an error is raised.
The primitive also makes provisions that the information in \inputfilename and
\inputlineno are set properly.
Syntax
The formal description of this primitive is the following:
(input)
→ \input (file name)
81
4. The Macro Language of εXTEX
Examples
The traditional version of the file name parsing allows the following syntax:
\input file.name
If the parsing is not configured to be strict then the following syntax is allowed as well:
\input{file.name}
The primitive \input is defined in the set tex.
The Primitive \inputlineno
The primitive \inputlineno is an internal integer quantity which expands to the line
number of the current input file. This primitive can be used to assign the value to
variables or after \the to translate it to tokens.
Syntax
The formal description of this primitive is the following:
(inputlineno)
→ \inputlineno
Examples
\count1=\inputlineno
\the\inputlineno
The primitive \inputlineno is defined in the set tex.
The Primitive \InputMode
\InputMode is not implemented yet.
The primitive \InputMode is defined in the set omega.
The Primitive \InputTranslation
\InputTranslation is not implemented yet.
The primitive \InputTranslation is defined in the set omega.
82
4.2. Primitives of εXTEX
The Primitive \insert
To be completed.
The formal description of this primitive is the following:
(insert)
→ \insert
Examples:
\insert42{abc}
The primitive \insert is defined in the set tex.
The Count Primitive \insertpenalties
\insertpenalties is a count register. The primitive \insertpenalties is defined in
the set tex.
The Primitive \interactionmode
To be completed.
Syntax
The formal description of this primitive is the following:
(interactionmode)
→ \interactionmode
Examples
\interactionmode
The primitive \interactionmode is defined in the set etex.
The Primitive \interlinepenalties
\interlinepenalties is not implemented yet.
The primitive \interlinepenalties is defined in the set etex.
83
4. The Macro Language of εXTEX
The Count Primitive \interlinepenalty
\interlinepenalty is a count register. The primitive \interlinepenalty is defined
in the set tex.
The primitive \javadef attaches a definition to a macro or active character. This is
done in a similar way as \def works. The difference is that the definition has to be
provided in form of a Java class.
Syntax
The general form of this primitive is
The (control sequence) is any macro or active character. If this token is missing or of
the wrong type then an error is raised.
The (tokens) is any specification of a list of tokens like a constant list enclosed in
braces or a toks register. The value of these tokens are taken and interpreted as the
name of a Java class. This class is loaded if needed and instantiated. The instance is
bound as code to the (control sequence).
The following example illustrates the use of this primitive:
The primitive \javadef is local to the enclosing group as is \def. And similar to
\def the modifier \global can be used to make the definition in all groups instead of
the current group only. This is shown in the following example:
Now we come to the Java side of the definition. The class given as (tokens) must imple-
ment the interface @link de.dante.extex.interpreter.type.Code Code. The easiest way to
achieve this is by declaring a class derived from @link de.dante.extex.interpreter.type.AbstractCode
AbstractCode.
package my.package;
import de.dante.extex.interpreter.AbstractCode;
import de.dante.extex.interpreter.contect.Context;
import de.dante.extex.interpreter.Flags;
import de.dante.extex.interpreter.TokenSource;
import de.dante.extex.typesetter.Typesetter;
import de.dante.util.GeneralException;
84
4.2. Primitives of εXTEX
class MyPrimitive extends AbstractCode {
public MyPrimitive(final String name) {
super(name);
// initialization code --if required
}
public boolean execute(final Flags prefix,
final Context context,
final TokenSource source,
final Typesetter typesetter
) {
// implement the execution behaviour here
return true;
}
}
There is more to say about primitives like how to write expandable primitives or ifs.
Those details can be found in section Primitives.
The primitive \javadef is defined in the set jx.
The primitive \javaload loads a java class and invokes its init() method. With this
method it is possible to load larger extensions of εXTEX in one junk. There is no need
to declare each single macro with \javadef.
The general form of this primitive is
The (tokens) is any specification of a list of tokens like a constant list enclosed in
braces or a toks register. The value of these tokens are taken and interpreted as the
name of a Java class. This class is loaded if needed, instantiated, and its method
de.dante.extex.interpreter.context.Context, de.dante.extex.typesetter.Typesetter) init()
is invoked. The instantiation requires the empty contructor to be visible.
The following example illustrates the use of this primitive:
For the loading of the Java class it is necessary that this Java class implements the
package my.package;
import de.dante.extex.interpreter.contect.Context;
import de.dante.extex.typesetter.Typesetter;
85
4. The Macro Language of εXTEX
import de.dante.util.GeneralException;
public MyModule() {
super();
// initialization code --if required
}
public void init(final Context context,
final Typesetter typesetter
) throws GeneralException {
// implement the initialization code here
}
}
The primitive \javaload is defined in the set jx.
The Primitive \jobname
The primitive \jobname expands to the name of the job currently processed. The job
name is usually the name of the first input file. If this can not be determined – e.g.
because the input is not coming from a file – then the fallback texput is usd as default
value.
The formal description of this primitive is the following:
(jobname)
→ \jobname
Examples:
\jobname
The primitive \jobname is defined in the set tex.
The Primitive \kern
This primitive produces a horizontal or vertical kerning. This is a (minor) adjustment
of the position. The meaning depends on the current mode of the typesetter. In vertical
modes it means a vertival adjustment. Otherwise it means a horizontal adjustment.
The formal description of this primitive is the following:
(kern)
→ \kern (dimen)
Examples:
\kern 12pt
86
4.2. Primitives of εXTEX
\kern -3mm
\kern -\dimen123
The primitive \kern is defined in the set tex.
The Count Primitive \language
\language is a count register. The primitive \language is defined in the set tex.
The Primitive \lastbox
To be completed.
The formal description of this primitive is the following:
(lastbox)
→ \lastbox
Examples:
\lastbox
\box1=\lastbox
The primitive \lastbox is defined in the set tex.
The Primitive \lastkern
To be completed.
Examples:
\dimen1=\lastkern
The primitive \lastkern is defined in the set tex.
The Primitive \lastlinefit
\lastlinefit is not implemented yet.
The primitive \lastlinefit is defined in the set etex.
87
4. The Macro Language of εXTEX
The Primitive \lastnodetype
To be completed.
Examples:
Test\the\lastnodetype
The primitive \lastnodetype is defined in the set etex.
The Primitive \lastpenalty
To be completed.
Examples:
\count1=\lastpenalty
The primitive \lastpenalty is defined in the set tex.
The Glue Primitive \lastskip
\lastskip is a skip register. The primitive \lastskip is defined in the set tex.
The Primitive \lccode
To be completed.
The formal description of this primitive is the following:
(lccode)
→ \lccode (...)
Examples:
\lccode ...
The primitive \lccode is defined in the set tex.
88
4.2. Primitives of εXTEX
To be completed.
The formal description of this primitive is the following:
Examples:
The primitive \leaders is defined in the set tex.
The Math Primitive \left
To be completed.
Syntax
The formal description of this primitive is the following:
(left)
→ \left ...
Examples
\left(
The primitive \left is defined in the set tex.
The Primitive \lefthyphenmin
To be completed.
Syntax
(lefthyphenmin)
→ \lefthyphenmin = ...
89
4. The Macro Language of εXTEX
Example:
\lefthyphenmin=3
The primitive \lefthyphenmin is defined in the set tex.
The Glue Primitive \leftskip
\leftskip is a skip register. The primitive \leftskip is defined in the set tex.
The Math Primitive \leqno
To be completed.
Syntax
The formal description of this primitive is the following:
(span)
→ \leqno
Examples
\leqno
The primitive \leqno is defined in the set tex.
The Primitive \let
To be completed.
The formal description of this primitive is the following:
(let)
→ \let (control sequence) (equals) (token)
Examples:
\let\a=\b
The primitive \let is defined in the set tex.
90
4.2. Primitives of εXTEX
The Math Primitive \limits
To be completed.
Syntax
The formal description of this primitive is the following:
(limits)
→ \limits
Examples
\limits
The primitive \limits is defined in the set tex.
The Count Primitive \linepenalty
\linepenalty is a count register. The primitive \linepenalty is defined in the set tex.
The Glue Primitive \lineskip
\lineskip is a skip register. The primitive \lineskip is defined in the set tex.
The Dimen Primitive \lineskiplimit
\lineskiplimit is a dimen register. The primitive \lineskiplimit is defined in the
set tex.
The Count Primitive \localbrokenpenalty
\localbrokenpenalty is a count register. The primitive \localbrokenpenalty is de-
fined in the set omega.
The Count Primitive \localinterlinepenalty
\localinterlinepenalty is a count register. The primitive \localinterlinepenalty
is defined in the set omega.
The Primitive \localleftbox
\localleftbox is not implemented yet.
The primitive \localleftbox is defined in the set omega.
91
4. The Macro Language of εXTEX
The Primitive \localrightbox
\localrightbox is not implemented yet.
The primitive \localrightbox is defined in the set omega.
The Prefix Primitive \long
To be completed.
The formal description of this primitive is the following:
(long)
→ \long ...
Examples:
\long\def#1{--#1--}
The primitive \long is defined in the set tex.
The Count Primitive \looseness
\looseness is a count register. The primitive \looseness is defined in the set tex.
The Primitive \lower
To be completed.
The formal description of this primitive is the following:
(lower)
→ \lower (dimen) (box)
Examples:
\lower 2em \hbox{abc}
\lower -1pt \hbox to 120pt {abc}
\lower 2mm \hbox spread 12pt {abc}
The primitive \lower is defined in the set tex.
92
4.2. Primitives of εXTEX
The Primitive \lowercase
To be completed.
The formal description of this primitive is the following:
(lowercase)
→ \lowercase (...)
Examples:
\lowercase ...
The primitive \lowercase is defined in the set tex.
The Primitive \mag
To be completed.
Syntax
The formal description of this primitive is the following:
(mag)
→ \mag
Examples
\count23=-456
The primitive \mag is defined in the set tex.
The Primitive \mark
To be completed.
The formal description of this primitive is the following:
\mark ...
Examples:
\mark{abc}
The primitive \mark is defined in the set tex.
93
4. The Macro Language of εXTEX
The Primitive \marks
To be completed.
The formal description of this primitive is the following:
\marks ...
Examples:
\marks123{abc}
The primitive \marks is defined in the set etex.
The Math Primitive \mathaccent
To be completed.
Syntax
The formal description of this primitive is the following:
(mathaccent)
→ \mathaccent
Examples
\mathaccent
The primitive \mathaccent is defined in the set tex.
The Math Primitive \mathbin
To be completed.
Syntax
The formal description of this primitive is the following:
(mathbin)
→ \mathbin
94
4.2. Primitives of εXTEX
Examples
\mathbin
The primitive \mathbin is defined in the set tex.
The Math Primitive \mathchar
The primitive \mathchar inserts a mathematical character consisting of a math class
and a character code inti the current math list. This is supposed to work in math mode
only.
To be completed.
Syntax
The formal description of this primitive is the following:
\mathchar ...
Examples
\mathchar"041
\mathchar{ordinary}0 ‘A
The primitive \mathchar is defined in the set tex.
The Math Primitive \mathchardef
To be completed.
Syntax
The formal description of this primitive is the following:
\mathchardef ...
Examples
\mathchardef\alpha ...
The primitive \mathchardef is defined in the set tex.
95
4. The Macro Language of εXTEX
The Math Primitive \mathchoice
To be completed.
Syntax
The formal description of this primitive is the following:
(mathchoice)
→ \mathchoice ...
Examples
\mathchoice{d}{t}{s}{ss}
The primitive \mathchoice is defined in the set tex.
The Math Primitive \mathclose
To be completed.
Syntax
The formal description of this primitive is the following:
(mathclose)
→ \mathclose
Examples
\mathclose
The primitive \mathclose is defined in the set tex.
The Math Primitive \mathcode
To be completed.
96
4.2. Primitives of εXTEX
Syntax
The formal description of this primitive is the following:
\mathcode ...
Examples
\mathcode ...
The primitive \mathcode is defined in the set tex.
The Primitive \mathdir
\mathdir is not implemented yet.
The primitive \mathdir is defined in the set omega.
The Math Primitive \mathinner
To be completed.
Syntax
The formal description of this primitive is the following:
(mathinner)
→ \mathinner (math block)
Examples
\mathinner{a^b}
The primitive \mathinner is defined in the set tex.
The Math Primitive \mathop
To be completed.
97
4. The Macro Language of εXTEX
Syntax
The formal description of this primitive is the following:
(mathop)
→ \mathop
Examples
\mathop
The primitive \mathop is defined in the set tex.
The Math Primitive \mathopen
To be completed.
Syntax
The formal description of this primitive is the following:
(mathopen)
→ \mathopen
Examples
\mathopen
The primitive \mathopen is defined in the set tex.
The Math Primitive \mathord
To be completed.
Syntax
The formal description of this primitive is the following:
(mathord)
→ \mathord
98
4.2. Primitives of εXTEX
Examples
\mathord
The primitive \mathord is defined in the set tex.
The Math Primitive \mathpunct
To be completed.
Syntax
The formal description of this primitive is the following:
(mathpunct)
→ \mathpunct
Examples
\mathpunct
The primitive \mathpunct is defined in the set tex.
The Math Primitive \mathrel
To be completed.
Syntax
The formal description of this primitive is the following:
(mathrel)
→ \mathrel
Examples
\mathrel
The primitive \mathrel is defined in the set tex.
99
4. The Macro Language of εXTEX
The Dimen Primitive \mathsurround
\mathsurround is a dimen register. The primitive \mathsurround is defined in the set
tex.
\maxdeadcycles is a count register. The primitive \maxdeadcycles is defined in the
set tex.
The Dimen Primitive \maxdepth
\maxdepth is a dimen register. The primitive \maxdepth is defined in the set tex.
The Primitive \meaning
To be completed.
Syntax
The formal description of this primitive is the following:
(meaning)
→ \meaning (token)
Examples
\meaning a
The primitive \meaning is defined in the set tex. The primitive \medmuskip is defined
in the set tex.
The Primitive \message
To be completed.
Syntax
The formal description of this primitive is the following:
(message)
→ \message ...
100
4.2. Primitives of εXTEX
Examples
\message{Hello World!}
The primitive \message is defined in the set tex.
The Math Primitive \middle
To be completed.
Syntax
The formal description of this primitive is the following:
(span)
→ \middle ...
Examples
\middle
The primitive \middle is defined in the set etex.
The Math Primitive \mkern
To be completed.
Syntax
The formal description of this primitive is the following:
(mkern)
→ \mkern
Examples
\mkern
The primitive \mkern is defined in the set tex.
101
4. The Macro Language of εXTEX
The Count Primitive \month
\month is a count register. The primitive \month is defined in the set tex.
The Primitive \moveleft
To be completed.
The formal description of this primitive is the following:
(moveleft)
→ \moveleft (dimen) (box)
Examples:
\moveleft 2em \hbox{abc}
\moveleft -1pt \hbox to 120pt {abc}
\moveleft 2mm \hbox spread 12pt {abc}
The primitive \moveleft is defined in the set tex.
The Primitive \moveright
To be completed.
The formal description of this primitive is the following:
(moveright)
→ \moveright (dimen) (box)
The color from the typographic context is taken as foregroud color for the rule. The
default color is black.
Examples:
\moveright 2em \hbox{abc}
\moveright -1pt \hbox to 120pt {abc}
\moveright 2mm \hbox spread 12pt {abc}
The primitive \moveright is defined in the set tex.
102
4.2. Primitives of εXTEX
The Math Primitive \mskip
To be completed.
Syntax
The formal description of this primitive is the following:
(mskip)
→ \mskip
Examples
\mskip 12mu plus 3mu minus 4 mu
The primitive \mskip is defined in the set tex.
The Primitive \muexpr
\muexpr is not implemented yet.
The primitive \muexpr is defined in the set etex.
This primitive implements an assignment. The variable given as next tokens is multiplied
by the quantity given after the optional by.
The formal description of this primitive is the following:
(multiply)
→ \multiply (multiplyable)
(multiplyable)
→ (integer variable) (optional by ) (8-bit number)
|
(dimen variable) (optional by ) (8-bit number)
|
(glue variable) (optional by ) (8-bit number)
|
(muglue variable) (optional by ) (8-bit number)
(optional by )
→ [by]
|
(optional spaces)
Examples:
\multiply\count12 345
103
4. The Macro Language of εXTEX
\multiply\count12 by -345
The primitive \multiply is defined in the set tex. The primitive \muskip is defined
in the set tex.
The Primitive \muskipdef
To be completed.
The formal description of this primitive is the following:
\muskipdef (control sequence) (equals) (8-bit number)
Examples:
\muskipdef\abc=45
\muskipdef\abc 33
The primitive \muskipdef is defined in the set tex.
The Primitive \namespace
To be completed.
The formal description of this primitive is the following:
(namespace)
→ \namespace (replacement text)
Examples:
\namespace{org.dante.dtk}
The primitive \namespace is defined in the set namespace.
The Primitive \nativedef
The primitive \nativedef assigns a definition to a macro or active character. This is
done in a similar way as \def works. The difference is that the definition has to be
provided in form of a Java class which glues in native code.
104
4.2. Primitives of εXTEX
Syntax
The general form of this primitive is
(nativedef )
→ \nativedef (control sequence) (name)
The (control sequence) is any macro or active character. If this token is missing or of
the wrong type then an error is raised.
The (name) is any specification of a list of tokens like a constant list enclosed in
braces or a token register. The value of these tokens are taken and resolved via the
configuration. This appropriate class is loaded if needed and instantiated. The instance
is bound as code to the (control sequence).
The primitive \javadef is local to the enclosing group as is \def. And similar to
\def the modifier \global can be used to make the definition in all groups instead of
the current group only.
The primitive \nativedef is defined in the set native.
To be completed.
Syntax
The general form of this primitive is
The primitive \nativeload is defined in the set native.
The Primitive \naturaldir
\naturaldir is not implemented yet.
The primitive \naturaldir is defined in the set omega.
The Count Primitive \newlinechar
\newlinechar is a count register. The primitive \newlinechar is defined in the set tex.
105
4. The Macro Language of εXTEX
The Primitive \noalign
To be completed.
The formal description of this primitive is the following:
(noalign)
→ \noalign
Examples:
\cr\noalign
The primitive \noalign is defined in the set tex.
The Primitive \\
To be completed.
The formal description of this primitive is the following:
(noboundary)
→ \\
Examples:
\\
The primitive \noboundary is defined in the set tex.
The Primitive \noDefaultInputMode
\noDefaultInputMode is not implemented yet.
The primitive \noDefaultInputMode is defined in the set omega.
The Primitive \noDefaultInputTranslation
\noDefaultInputTranslation is not implemented yet.
The primitive \noDefaultInputTranslation is defined in the set omega.
The Primitive \noDefaultOutputMode
\noDefaultOutputMode is not implemented yet.
The primitive \noDefaultOutputMode is defined in the set omega.
106
4.2. Primitives of εXTEX
The Primitive \noDefaultOutputTranslation
\noDefaultOutputTranslation is not implemented yet.
The primitive \noDefaultOutputTranslation is defined in the set omega.
The Primitive \noexpand
To be completed.
The formal description of this primitive is the following:
(noexpand)
→ \noexpand
Examples:
\noexpand
The primitive \noexpand is defined in the set tex.
The Primitive \noindent
To be completed.
The formal description of this primitive is the following:
(noindent)
→ \noindent
Examples:
\noindent
The primitive \noindent is defined in the set tex.
The Math Primitive \nolimits
To be completed.
Syntax
The formal description of this primitive is the following:
(nolimits)
→ \nolimits
107
4. The Macro Language of εXTEX
Examples
\nolimits
The primitive \nolimits is defined in the set tex.
The Math Primitive \nonscript
The primitive can be used in math modes only. It cancels following glue if the current
style is script style or scriptscript style.
Syntax
The formal description of this primitive is the following:
(nonscript)
→ \nonscript
Examples
\nonscript
The primitive \nonscript is defined in the set tex.
The Primitive \nonstopmode
This primitive sets the interaction mode to batch mode. In batch mode the processing
is terminated if the program needs input from the terminal or n error occurs.
The setting of the interaction mode is an assignment. The mode is always processed
globally. This means it does not interact with the group concept.
Syntax
The formal description of this primitive is the following:
(nonstopmode)
→ \nonstopmode
Examples:
\nonstopmode
The primitive \nonstopmode is defined in the set tex.
The Dimen Primitive \nulldelimiterspace
\nulldelimiterspace is a dimen register. The primitive \nulldelimiterspace is de-
fined in the set tex.
108
4.2. Primitives of εXTEX
The Primitive \nullfont
To be completed.
The formal description of this primitive is the following:
\nullfont
Examples:
\font123=\nullfont
The primitive \nullfont is defined in the set tex.
The Primitive \nullocplist
\nullocplist is not implemented yet.
The primitive \nullocplist is defined in the set omega.
The Primitive \number
To be completed.
The formal description of this primitive is the following:
(number)
→ \number (...)
Examples:
\number ...
The primitive \number is defined in the set tex.
The Primitive \numexpr
The primitive \numexpr provides a means to use a inline way of writing mathematical
expressions to be evaluated. Mathematical expressions can be evaluated in εXTEX using
\advance, \multiply, and \divide. Nevertheless those primitives result in an assign-
ment. This is not the case for \numexpr. Here the intermediate results are not stored
in count registers but kept internally. Also the application of \afterassignment and
\tracingassigns is suppressed.
The mathematical expression to be evaluated can be made up of the basic operations
addition (+), subtraction (-), multiplication (*), and division(/). The unary minus can
109
4. The Macro Language of εXTEX
be used. Parentheses can be used for grouping. Anything which looks like a number can
be used as argument. White-space can be used freely without any harm.
The expression is terminated at the first token which can not be part of an expression.
For instance a letter may signal the end of the expression. If the expression should
terminate without a proper token following it, the token \relax can be used to signal
the end of the expression. This \relax token is silently consumed by \numexpr.
The primitive \numexpr can be used in any place where a number is required. This
includes assignments to count registers and comparisons.
Syntax
The formal description of this primitive is the following:
(numexpr)
→ \numexpr (expr) \relax
|
\numexpr (expr)
(expr)
→ (number)
|
(operand)
|
(expr) + (expr)
|
(expr) - (expr)
|
(expr) * (expr)
|
(expr) / (expr)
(operand)
→ (number)
|
- (expr)
|
( (expr) )
Examples
\count1=\numexpr 23 \relax
\count1=\numexpr 2 * 3 \relax
\count1=\numexpr 2*\count2
\count1=\numexpr 2*(1+3)
\count1=\numexpr 2*-\count0
The primitive \numexpr is defined in the set etex.
The Primitive \ocp
\ocp is not implemented yet.
The primitive \ocp is defined in the set omega.
110
4.2. Primitives of εXTEX
The Primitive \ocplist
\ocplist is not implemented yet.
The primitive \ocplist is defined in the set omega.
The Primitive \odelmiter
\odelmiter is not implemented yet.
The primitive \odelmiter is defined in the set omega.
The Primitive \omathaccent
\omathaccent is not implemented yet.
The primitive \omathaccent is defined in the set omega.
The Primitive \omathchar
\omathchar is not implemented yet.
The primitive \omathchar is defined in the set omega.
The Primitive \omathchardef
\omathchardef is not implemented yet.
The primitive \omathchardef is defined in the set omega.
The Primitive \omathcode
\omathcode is not implemented yet.
The primitive \omathcode is defined in the set omega.
The Primitive \omathdelcode
\omathdelcode is not implemented yet.
The primitive \omathdelcode is defined in the set omega.
The Primitive \omit
To be completed.
The formal description of this primitive is the following:
(omit)
→ \omit
111
4. The Macro Language of εXTEX
Examples:
\omit 1
The primitive \omit is defined in the set tex.
The Primitive \openin
The primitive \openin tries to open a file or other named resource for reading. The
reference is stored in a read register to be used with \read. If the opening fails then the
read register is void. This can be checked with the primitive \ifeof.
The assignment to a read register is local to the current group unless specified differ-
ently. If the prefix \global is given then the read register is assigned globally.
The stream should be closed with \closein when not needed any more.
Syntax
The formal description of this primitive is the following:
(openin)
→ (modifier) \openin (8-bit number) (equals) (file name)
(modifier)
|
\global
Examples
\openin3= abc.def
\closein3
The primitive \openin is defined in the set tex.
The Primitive \openout
To be completed.
Syntax
The formal description of this primitive is the following:
(openin)
→ (modifier) \openin (8-bit number) (equals) (file name)
(modifier)
112
4.2. Primitives of εXTEX
|
\global (modifier)
|
\immediate (modifier)
Examples
\immediate\openout3= abc.def
\write3{Hi there!}
\closeout3
The primitive \openout is defined in the set tex.
The Primitive \or
To be completed.
(or)
→ \ifcase ... \or ... \fi
The primitive \or is defined in the set tex.
The primitive \oradical is defined in the set omega.
The Prefix Primitive \outer
To be completed.
The formal description of this primitive is the following:
(outer)
→ \outer ...
Examples:
\outer\def#1{--#1--}
The primitive \outer is defined in the set tex.
The Toks Primitive \output
\output is a toks register. The primitive \output is defined in the set tex.
113
4. The Macro Language of εXTEX
The Primitive \OutputMode
\OutputMode is not implemented yet.
The primitive \OutputMode is defined in the set omega.
The Count Primitive \outputpenalty
\outputpenalty is a count register. The primitive \outputpenalty is defined in the
set tex.
The Primitive \OutputTranslation
\OutputTranslation is not implemented yet.
The primitive \OutputTranslation is defined in the set omega.
The Math Primitive \over
To be completed.
Syntax
The formal description of this primitive is the following:
(over)
→ ... \over ...
Examples
a \over b
The primitive \over is defined in the set tex.
The Dimen Primitive \overfullrule
\overfullrule is a dimen register. The primitive \overfullrule is defined in the set
tex.
The Math Primitive \overline
To be completed.
114
4.2. Primitives of εXTEX
Syntax
The formal description of this primitive is the following:
(span)
→ \overline ...
Examples
\overline{abc}
The primitive \overline is defined in the set tex.
The Primitive \overwithdelims
To be completed.
The formal description of this primitive is the following:
(overwithdelims)
→ ... \overwithdelims ...
Examples:
\overwithdelims
The primitive \overwithdelims is defined in the set tex.
The Dimen Primitive \pagedepth
\pagedepth is a dimen register. The primitive \pagedepth is defined in the set tex.
The Primitive \pagedir
\pagedir is not implemented yet.
The primitive \pagedir is defined in the set omega.
The Primitive \pagedirHL
\pagedirHL is not implemented yet.
The primitive \pagedirHL is defined in the set omega.
The Primitive \pagedirHR
\pagedirHR is not implemented yet.
The primitive \pagedirHR is defined in the set omega.
115
4. The Macro Language of εXTEX
The Primitive \pagediscarts
\pagediscarts is not implemented yet.
The primitive \pagediscarts is defined in the set etex.
The Dimen Primitive \pagefilllstretch
\pagefilllstretch is a dimen register. The primitive \pagefilllstretch is defined
in the set tex.
The Dimen Primitive \pagefillstretch
\pagefillstretch is a dimen register. The primitive \pagefillstretch is defined in
the set tex.
The Dimen Primitive \pagefilstretch
\pagefilstretch is a dimen register. The primitive \pagefilstretch is defined in the
set tex.
The Dimen Primitive \pagegoal
\pagegoal is a dimen register. The primitive \pagegoal is defined in the set tex.
The Dimen Primitive \pageshrink
\pageshrink is a dimen register. The primitive \pageshrink is defined in the set tex.
The Dimen Primitive \pagestretch
\pagestretch is a dimen register. The primitive \pagestretch is defined in the set
tex.
The Dimen Primitive \pagetotal
\pagetotal is a dimen register. The primitive \pagetotal is defined in the set tex.
The Primitive \par
The primitive \par signals the end of a paragraph. If εXTEX is in a horizontal mode
then the preceding material is typeset and the paragraph is added to the vertical list.
εXTEX goes into a vertical mode afterwards.
If εXTEX is in a vertical mode then this primitive is simply ignored.
116
4.2. Primitives of εXTEX
The scanner rules of TEX determine that the macro \par is inserted for any number
of subsequent empty lines. This means that in a normal text there might be a lot of
invocations of \par even if none of them is written explicitly.
Syntax
The formal description of this primitive is the following:
(par)
→ \par
Examples
abc \par def
The primitive \par is defined in the set tex.
The Glue Primitive \parfillskip
\parfillskip is a skip register. The primitive \parfillskip is defined in the set tex.
The Dimen Primitive \parindent
\parindent is a dimen register. The primitive \parindent is defined in the set tex.
The Primitive \parshape
The primitive \parshape is a declaration of the shape of the paragraph. With its help
it is possible to control the left and right margin of the current paragraph.
The shape of the paragraph is controlled on a line base. For each line the left indenta-
tion and the width are given. The first argument of \parshape determines the number
of such pairs to follow.
When the paragraph is typeset the lines are indented and adjusted according to the
specification given. If there are more lines specified as actually present in the current
paragraph then the remaining specifications are discarded at the end of the paragraph.
If there are less lines then the last specification is repeated.
If several \parshape declarations are given in one oaragraph then the one is used
which is in effect at the end of the paragraph. This means that later declarations
overrule earlier ones.
Syntax
The formal description of this primitive is the following:
(parshape)
→ \parshape (8-bit number) ...
117
4. The Macro Language of εXTEX
Examples
\parshape 3 20pt \linewidth
20pt \linewidth
0pt \linewidth
\parshape 0
\parshape as special integer
\parshape acts as special count register which can be queried. It returns the size of the
current parshape specification or 0 if none is present.
Examples
\count1=\parshape
The primitive \parshape is defined in the set tex.
The Primitive \parshapedimen
The primitive \parshapedimen ...
Syntax
The formal description of this primitive is the following:
(parshapedimen)
→ \parshapedimen (8-bit number)
Examples
\dimen2=\parshapedimen 3
\dimen2=\parshapedimen -3
The primitive \parshapedimen is defined in the set etex.
The Primitive \parshapeindent
The primitive \parshapeindent ...
118
4.2. Primitives of εXTEX
Syntax
The formal description of this primitive is the following:
(parshapeindent)
→ \parshapeindent (8-bit number)
Examples
\dimen2=\parshapeindent 3
\dimen2=\parshapeindent -3
The primitive \parshapeindent is defined in the set etex.
The Primitive \parshapelength
The primitive \parshapelength ...
Syntax
The formal description of this primitive is the following:
(parshapelength)
→ \parshapelength (8-bit number)
Examples
\dimen2=\parshapelength 3
\dimen2=\parshapelength -3
The primitive \parshapelength is defined in the set etex.
The Glue Primitive \parskip
\parskip is a skip register. The primitive \parskip is defined in the set tex.
The Primitive \patterns
To be completed.
The formal description of this primitive is the following:
119
4. The Macro Language of εXTEX
(patterns)
→ \patterns (patterns)
Examples:
The primitive \patterns is defined in the set tex.
The Count Primitive \pausing
\pausing is a count register. The primitive \pausing is defined in the set tex.
in the set pdftex.
The Primitive \pdfannot
\pdfannot is not implemented yet.
The primitive \pdfannot is defined in the set pdftex.
The primitive \pdfannotlink is defined in the set pdftex.
The Primitive \pdfannottext
\pdfannottext is not implemented yet.
The primitive \pdfannottext is defined in the set pdftex.
The Primitive \pdfcatalog
\pdfcatalog is not implemented yet.
The primitive \pdfcatalog is defined in the set pdftex.
The Count Primitive \pdfcompresslevel
\pdfcompresslevel is a count register. The primitive \pdfcompresslevel is defined
in the set pdftex.
120
4.2. Primitives of εXTEX
The Count Primitive \pdfdecimaldigits
\pdfdecimaldigits is a count register. The primitive \pdfdecimaldigits is defined
in the set pdftex.
The Primitive \pdfdest
\pdfdest is not implemented yet.
The primitive \pdfdest is defined in the set pdftex.
The primitive \pdfendlink is defined in the set pdftex.
The primitive \pdfendthread is defined in the set pdftex.
The Primitive \pdffontname
\pdffontname is not implemented yet.
The primitive \pdffontname is defined in the set pdftex.
The Primitive \pdffontobjnum
\pdffontobjnum is not implemented yet.
The primitive \pdffontobjnum is defined in the set pdftex.
The Dimen Primitive \pdfhorigin
\pdfhorigin is a dimen register. The primitive \pdfhorigin is defined in the set
pdftex.
The Primitive \pdfimage
\pdfimage is not implemented yet.
The primitive \pdfimage is defined in the set pdftex.
The Count Primitive \pdfimageresolution
\pdfimageresolution is a count register. The primitive \pdfimageresolution is de-
fined in the set pdftex.
121
4. The Macro Language of εXTEX
The Primitive \pdfincludechars
\pdfincludechars is not implemented yet.
The primitive \pdfincludechars is defined in the set pdftex.
The Primitive \pdfinfo
\pdfinfo is not implemented yet.
The primitive \pdfinfo is defined in the set pdftex.
The Primitive \pdflastannot
\pdflastannot is not implemented yet.
The primitive \pdflastannot is defined in the set pdftex.
The Primitive \pdflastobj
\pdflastobj is not implemented yet.
The primitive \pdflastobj is defined in the set pdftex.
The Primitive \pdflastxform
\pdflastxform is not implemented yet.
The primitive \pdflastxform is defined in the set pdftex.
The Primitive \pdflastximage
\pdflastximage is not implemented yet.
The primitive \pdflastximage is defined in the set pdftex.
\pdflinkmargin is a dimen register. The primitive \pdflinkmargin is defined in the
set pdftex.
The Primitive \pdfliteral
\pdfliteral is not implemented yet.
The primitive \pdfliteral is defined in the set pdftex.
The Count Primitive \pdfmovechars
\pdfmovechars is a count register. The primitive \pdfmovechars is defined in the set
pdftex.
122
4.2. Primitives of εXTEX
The Primitive \pdfnames
\pdfnames is not implemented yet.
The primitive \pdfnames is defined in the set pdftex.
The Primitive \pdfobj
\pdfobj is not implemented yet.
The primitive \pdfobj is defined in the set pdftex.
The Primitive \pdfoutline
\pdfoutline is not implemented yet.
The primitive \pdfoutline is defined in the set pdftex.
The Count Primitive \pdfoutput
\pdfoutput is a count register. The primitive \pdfoutput is defined in the set pdftex.
The Primitive \pdfpageattr
\pdfpageattr is not implemented yet.
The primitive \pdfpageattr is defined in the set pdftex.
The Dimen Primitive \pdfpageheight
\pdfpageheight is a dimen register. The primitive \pdfpageheight is defined in the
set pdftex.
The Primitive \pdfpagesattr
\pdfpagesattr is not implemented yet.
The primitive \pdfpagesattr is defined in the set pdftex.
The Dimen Primitive \pdfpagewidth
\pdfpagewidth is a dimen register. The primitive \pdfpagewidth is defined in the set
pdftex.
The Count Primitive \pdfpkresolution
\pdfpkresolution is a count register. The primitive \pdfpkresolution is defined in
the set pdftex.
123
4. The Macro Language of εXTEX
The Primitive \pdfrefobj
\pdfrefobj is not implemented yet.
The primitive \pdfrefobj is defined in the set pdftex.
The Primitive \pdfrefxform
\pdfrefxform is not implemented yet.
The primitive \pdfrefxform is defined in the set pdftex.
The Primitive \pdfrefximage
\pdfrefximage is not implemented yet.
The primitive \pdfrefximage is defined in the set pdftex.
The primitive \pdfstartlink is defined in the set pdftex.
The Primitive \pdftexrevision
\pdftexrevision is not implemented yet.
The primitive \pdftexrevision is defined in the set pdftex.
The Count Primitive \pdftexversion
\pdftexversion is a count register. The primitive \pdftexversion is defined in the
set pdftex.
The primitive \pdfthread is defined in the set pdftex.
The primitive \pdfthreadhoffset is defined in the set pdftex.
the set pdftex.
124
4.2. Primitives of εXTEX
The primitive \pdfthreadvoffset is defined in the set pdftex.
The Dimen Primitive \pdfvorigin
\pdfvorigin is a dimen register. The primitive \pdfvorigin is defined in the set
pdftex.
The Primitive \pdfxform
\pdfxform is not implemented yet.
The primitive \pdfxform is defined in the set pdftex.
The Primitive \pdfximage
\pdfximage is not implemented yet.
The primitive \pdfximage is defined in the set pdftex.
The Primitive \penalty
This primitive inserts penalty into the current node list. In vertical mode the page
builder is also invoked.
A penalty of 10000 or more will inhibit a break at this position. A penalty of -10000
or less will force a break at this position.
The formal description of this primitive is the following:
(penalty)
→ \penalty (8-bit number)
Examples:
\penalty 123
\penalty -456
\penalty -\count254
The primitive \penalty is defined in the set tex.
The Primitive \popocplist
\popocplist is not implemented yet.
The primitive \popocplist is defined in the set omega.
125
4. The Macro Language of εXTEX
The Count Primitive \postdisplaypenalty
\postdisplaypenalty is a count register. The primitive \postdisplaypenalty is de-
fined in the set tex.
The Primitive \predisplaydirection
\predisplaydirection is not implemented yet.
The primitive \predisplaydirection is defined in the set etex.
The Count Primitive \predisplaypenalty
\predisplaypenalty is a count register. The primitive \predisplaypenalty is defined
in the set tex.
The Dimen Primitive \predisplaysize
\predisplaysize is a dimen register. The primitive \predisplaysize is defined in the
set tex.
The Count Primitive \pretolerance
\pretolerance is a count register. The primitive \pretolerance is defined in the set
tex.
The Primitive \prevdepth
To be completed.
The formal description of this primitive is the following:
(prevdepth)
→ \prevdepth ...
Examples:
\prevdepth ...
The primitive \prevdepth is defined in the set tex.
126
4.2. Primitives of εXTEX
The Primitive \prevgraf
To be completed.
The formal description of this primitive is the following:
(prevgraf )
→ \prevgraf
Examples:
\prevgraf
The primitive \prevgraf is defined in the set tex.
The Prefix Primitive \protected
To be completed.
The formal description of this primitive is the following:
(protected)
→ \protected
Examples:
\protected\def\abc{123}
The primitive \protected is defined in the set etex.
The Primitive \pushocplist
\pushocplist is not implemented yet.
The primitive \pushocplist is defined in the set omega.
To be completed.
Syntax
The formal description of this primitive is the following:
127
4. The Macro Language of εXTEX
Examples
The primitive \radical is defined in the set tex.
The Primitive \raise
To be completed.
The formal description of this primitive is the following:
(raise)
→ \raise (dimen) (box)
Examples:
\raise 2em \hbox{abc}
\raise -1pt \hbox to 120pt {abc}
\raise 2mm \hbox spread 12pt {abc}
The primitive \raise is defined in the set tex.
To be completed.
Syntax
The formal description of this primitive is the following:
Examples
\openin3= abc.def
\closein3
The primitive \read is defined in the set tex.
128
4.2. Primitives of εXTEX
To be completed.
Syntax
The formal description of this primitive is the following:
Examples
\openin3= abc.def
\closein3
The primitive \readline is defined in the set etex.
The Primitive \relax
This primitive simply does nothing. It acts as a no-op for the TEX macro language.
\relax is not even expandable. in certain circumstances it might be treated as if it
where expandable and the expansion is empty.
\relax sometimes acts as terminating token. For instance when a number is parsed
\relax terminates the parsing even if the following token is a digit.
The formal description of this primitive is the following:
(relax)
→ \relax
Examples
\relax
\the\count123\relax456
The primitive \relax is defined in the set tex.
The Count Primitive \relpenalty
\relpenalty is a count register. The primitive \relpenalty is defined in the set tex.
129
4. The Macro Language of εXTEX
The Primitive \removebeforeocplist
\removebeforeocplist is not implemented yet.
The primitive \removebeforeocplist is defined in the set omega.
The Math Primitive \right
To be completed.
Syntax
The formal description of this primitive is the following:
(span)
→ \right ...
Examples
\right )
The primitive \right is defined in the set tex.
The Primitive \righthyphenmin
To be completed.
Syntax
(righthyphenmin)
→ \righthyphenmin = ...
Example:
\righthyphenmin=3
The primitive \righthyphenmin is defined in the set tex.
The Glue Primitive \rightskip
\rightskip is a skip register. The primitive \rightskip is defined in the set tex.
130
4.2. Primitives of εXTEX
The Primitive \romannumeral
The primitive \romannumeral takes a single argument of a number and produces the
representation of this number in lower case roman numerals. If the number is less than
one than nothing is produced at all.
Syntax
The formal description of this primitive is the following:
(romannumeral)
→ \romannumeral (number)
Examples
\romannumeral\count1
\romannumeral 2004
The primitive \romannumeral is defined in the set tex.
The Primitive \savinghyphcodes
\savinghyphcodes is not implemented yet.
The primitive \savinghyphcodes is defined in the set etex.
The Primitive \savingvdiscarts
\savingvdiscarts is not implemented yet.
The primitive \savingvdiscarts is defined in the set etex.
The Primitive \scantokens
\scantokens is not implemented yet.
The primitive \scantokens is defined in the set etex.
The Font Primitive \scriptfont
\scriptfont is a numbered font register. The primitive \scriptfont is defined in the
set tex.
The Font Primitive \scriptscriptfont
\scriptscriptfont is a numbered font register. The primitive \scriptscriptfont is
defined in the set tex.
131
4. The Macro Language of εXTEX
The Math Primitive \scriptscriptstyle
To be completed.
Syntax
The formal description of this primitive is the following:
(scriptscriptstyle)
→ \scriptscriptstyle
Examples
\scriptscriptstyle
The primitive \scriptscriptstyle is defined in the set tex.
The Dimen Primitive \scriptspace
\scriptspace is a dimen register. The primitive \scriptspace is defined in the set
tex.
The Math Primitive \scriptstyle
To be completed.
Syntax
The formal description of this primitive is the following:
(scriptstyle)
→ \scriptstyle
Examples
\scriptstyle
The primitive \scriptstyle is defined in the set tex.
132
4.2. Primitives of εXTEX
The Primitive \scrollmode
This primitive sets the interaction mode to scroll mode.
The setting of the interaction mode is an assignment. The mode is always processed
globally. This means it does not interact with the group concept.
Syntax
The formal description of this primitive is the following:
(scrollmode)
→ \scrollmode
Examples
\scrollmode
The primitive \scrollmode is defined in the set tex.
The Primitive \setbox
To be completed.
The formal description of this primitive is the following:
(setbox)
→ \setbox (8-bit number)...
Examples:
\setbox0\hbox{abc}
The primitive \setbox is defined in the set tex.
The Primitive \\
To be completed.
The formal description of this primitive is the following:
(setlanguage)
→ \setlanguage (number)
Examples:
\setlanguage2
The primitive \setlanguage is defined in the set tex.
133
4. The Macro Language of εXTEX
The Primitive \sfcode
To be completed.
The formal description of this primitive is the following:
(sfcode)
→ \sfcode ...
Examples:
\sfcode ...
The primitive \sfcode is defined in the set tex.
The Primitive \shipout
The primitive \shipout takes a box and send the contents of the box to the document
writer.
In addition the count register \deadcyles is reset to 0. This count register is used to
break out of infinite loops when no material is shipped out in the output routine.
Syntax
The formal description of this primitive is the following:
(shipout)
→ \shipout (box)
Examples
\shipout\box255
The primitive \shipout is defined in the set tex.
The Primitive \show
To be completed.
Syntax
The formal description of this primitive is the following:
(show)
→ \show (token)
134
4.2. Primitives of εXTEX
Examples
Examples:
\show\abc
The primitive \show is defined in the set tex.
The Primitive \showbox
To be completed.
Syntax
The formal description of this primitive is the following:
(showbox)
→ \showbox (8-bit number)
Examples
\showbox 1
The primitive \showbox is defined in the set tex.
\showboxbreadth is a count register. The primitive \showboxbreadth is defined in the
set tex.
The Count Primitive \showboxdepth
\showboxdepth is a count register. The primitive \showboxdepth is defined in the set
tex.
The Primitive \showgroups
\showgroups is not implemented yet.
The primitive \showgroups is defined in the set etex.
135
4. The Macro Language of εXTEX
The Primitive \showlists
To be completed.
The formal description of this primitive is the following:
(showlists)
→ \showlists
Examples:
\showlists 1
The primitive \showlists is defined in the set tex.
The Primitive \showthe
To be completed.
The primitive \showthe is defined in the set tex.
The Primitive \showtokens
\showtokens is not implemented yet.
The primitive \showtokens is defined in the set etex.
The Primitive \skewchar
To be completed.
The formal description of this primitive is the following:
\skewchar (font) (equals) (8-bit number)
Examples:
\skewchar\font=123
Incompatibility
The TeXbook gives no indication ow the primitive should react for negative values –
except -1. The implementation of TEX allows to store and retrieve arbirary negative
values. This behaviour of TEX is not preserved in εXTEX.
The primitive \skewchar is defined in the set tex. The primitive \skip is defined in
the set tex.
136
4.2. Primitives of εXTEX
The Primitive \skipdef
To be completed.
The formal description of this primitive is the following:
\skipdef (control sequence) (equals) (8-bit number)
Examples:
\skipdef\abc=45
\skipdef\abc 33
The primitive \skipdef is defined in the set tex.
The Primitive \spacefactor
To be completed.
The formal description of this primitive is the following:
(spacefactor)
→ \spacefactor ...
Examples:
\spacefactor ...
The primitive \spacefactor is defined in the set tex.
The Glue Primitive \spaceskip
\spaceskip is a skip register. The primitive \spaceskip is defined in the set tex.
The Primitive \span
To be completed.
The formal description of this primitive is the following:
(span)
→ \span
Examples:
\span 1
The primitive \span is defined in the set tex.
137
4. The Macro Language of εXTEX
The Primitive \special
This primitive sends a string to the backend driver. The argument is a balanced block of
text which is expanded and translated into a string. The string is given in a SpecialNode
to the typesetter for passing it down.
The formal description of this primitive is the following:
(special)
→ \special (general text)
Examples:
\special{hello world}
\special{ps: \abc}
For several backend drivers for TEX a quasi-standard has emerged which uses a prefix
ended by a colon to indicate the backend driver the special is targeted at.
The primitive \special is defined in the set tex.
The Primitive \splitbotmark
To be completed.
The formal description of this primitive is the following:
\splitbotmark ...
Examples:
\splitbotmark ...
The primitive \splitbotmark is defined in the set tex.
The Primitive \splitbotmarks
\splitbotmarks is not implemented yet.
The primitive \splitbotmarks is defined in the set etex.
The Primitive \splitdiscarts
\splitdiscarts is not implemented yet.
The primitive \splitdiscarts is defined in the set etex.
138
4.2. Primitives of εXTEX
The Primitive \splitfirstmark
To be completed.
The formal description of this primitive is the following:
\splitfirstmark ...
Examples:
\splitfirstmark ...
The primitive \splitfirstmark is defined in the set tex.
The Primitive \splitfirstmarks
\splitfirstmarks is not implemented yet.
The primitive \splitfirstmarks is defined in the set etex.
The Dimen Primitive \splitmaxdepth
\splitmaxdepth is a dimen register. The primitive \splitmaxdepth is defined in the
set tex.
The Glue Primitive \splittopskip
\splittopskip is a skip register. The primitive \splittopskip is defined in the set
tex.
The Primitive \string
This primitive takes the next unexpanded token. If this token is a control sequence –
and no active character – then the value of escapechar followed by the characters from
the name of the control sequence. Otherwise it is a single character token containing
the character code of the token.
The formal description of this primitive is the following:
(string)
→ \string (token)
Examples:
\string ...
The primitive \string is defined in the set tex.
139
4. The Macro Language of εXTEX
The Glue Primitive \tabskip
\tabskip is a skip register. The primitive \tabskip is defined in the set tex.
The Primitive \textdir
\textdir is not implemented yet.
The primitive \textdir is defined in the set omega.
The Font Primitive \textfont
\textfont is a numbered font register. The primitive \textfont is defined in the set
tex.
The Math Primitive \textstyle
To be completed.
Syntax
The formal description of this primitive is the following:
(textstyle)
→ \textstyle
Examples
\textstyle
The primitive \textstyle is defined in the set tex.
The Count Primitive \TeXXeTstate
\TeXXeTstate is a count register. The primitive \TeXXeTstate is defined in the set
etex.
The Primitive \the
To be completed.
The formal description of this primitive is the following:
140
4.2. Primitives of εXTEX
(the)
→ \the (internal quantity)
Examples:
\the\count123
The primitive \the is defined in the set tex. The primitive \thickmuskip is defined
in the set tex. The primitive \thinmuskip is defined in the set tex.
The Count Primitive \time
\time is a count register. The primitive \time is defined in the set tex. The primitive
\toks is defined in the set tex.
The Primitive \toksdef
To be completed.
The formal description of this primitive is the following:
\toksdef (control sequence) (equals) (8-bit number)
Examples:
\toksdef\abc=45
\toksdef\abc 33
The primitive \toksdef is defined in the set tex.
The Count Primitive \tolerance
\tolerance is a count register. The primitive \tolerance is defined in the set tex.
The Primitive \topmark
To be completed.
The formal description of this primitive is the following:
\topmark ...
Examples:
\topmark ...
The primitive \topmark is defined in the set tex.
141
4. The Macro Language of εXTEX
The Primitive \topmarks
\topmarks is not implemented yet.
The primitive \topmarks is defined in the set etex.
The Glue Primitive \topskip
\topskip is a skip register. The primitive \topskip is defined in the set tex.
The Count Primitive \tracingassigns
\tracingassigns is a count register. The primitive \tracingassigns is defined in the
set etex.
The Count Primitive \tracingcommands
\tracingcommands is a count register. The primitive \tracingcommands is defined in
the set tex.
The Count Primitive \tracinggroups
\tracinggroups is a count register. The primitive \tracinggroups is defined in the
set etex.
The Count Primitive \tracingifs
\tracingifs is a count register. The primitive \tracingifs is defined in the set etex.
The Count Primitive \tracinglostchars
\tracinglostchars is a count register. The primitive \tracinglostchars is defined
in the set tex.
The Count Primitive \tracingmacros
\tracingmacros is a count register. The primitive \tracingmacros is defined in the
set tex.
The Count Primitive \tracingnesting
\tracingnesting is a count register. The primitive \tracingnesting is defined in the
set etex.
142
4.2. Primitives of εXTEX
The Count Primitive \tracingonline
\tracingonline is a count register. The primitive \tracingonline is defined in the
set tex.
The Count Primitive \tracingoutput
\tracingoutput is a count register. The primitive \tracingoutput is defined in the
set tex.
The Count Primitive \tracingpages
\tracingpages is a count register. The primitive \tracingpages is defined in the set
tex.
The Count Primitive \tracingparagraphs
\tracingparagraphs is a count register. The primitive \tracingparagraphs is defined
in the set tex.
The Count Primitive \tracingrestores
\tracingrestores is a count register. The primitive \tracingrestores is defined in
the set tex.
The Count Primitive \tracingscantokens
\tracingscantokens is a count register. The primitive \tracingscantokens is defined
in the set etex.
The Count Primitive \tracingstats
\tracingstats is a count register. The primitive \tracingstats is defined in the set
tex.
The Primitive \uccode
To be completed.
The formal description of this primitive is the following:
(uccode)
→ \uccode (...)
143
4. The Macro Language of εXTEX
Examples:
\uccode ...
The primitive \uccode is defined in the set tex.
The Count Primitive \uchyph
\uchyph is a count register. The primitive \uchyph is defined in the set tex.
The Math Primitive \underline
To be completed.
Syntax
The formal description of this primitive is the following:
(span)
→ \underline ...
Examples
\underline{abc}
The primitive \underline is defined in the set tex.
The Primitive \unexpanded
\unexpanded is not implemented yet.
The primitive \unexpanded is defined in the set etex.
The Primitive \unhbox
To be completed.
The formal description of this primitive is the following:
(unhbox)
→ \unhbox (8-bit number)
Examples:
\unhbox42
The primitive \unhbox is defined in the set tex.
144
4.2. Primitives of εXTEX
The Primitive \unhcopy
To be completed.
The formal description of this primitive is the following:
(unhcopy)
→ \unhcopy (8-bit number)
Examples:
\unhcopy42
The primitive \unhcopy is defined in the set tex.
The Primitive \unkern
The formal description of this primitive is the following:
(unkern)
→ \unkern
Examples:
\unkern
The primitive \unkern is defined in the set tex.
The Primitive \unless
Copied of the ε-TEX reference.
TEX has, by design, a rather sparse set of conditional primitives: \ifeof, \ifodd,
\ifvoid, etc., have no complementary counterparts. Whilst this normally poses no
problems since each accepts both a \then (implicit) and an \else (explicit) part, they
fall down when used as the final \if... of a \loop ... \if ... \repeat construct,
since no \else is allowed after the final \if.... \unless allows the sense of all Boolean
conditionals to be inverted, and thus (for example) \unless \ifeof yields true iff end-
of-file has not yet been reached.
The formal description of this primitive is the following:
To be completed.
Examples:
\unless\if\x\y not ok \fi
The primitive \unless is defined in the set etex.
145
4. The Macro Language of εXTEX
The Primitive \unnaturaldir
\unnaturaldir is not implemented yet.
The primitive \unnaturaldir is defined in the set omega.
The Primitive \unpenalty
The formal description of this primitive is the following:
(unpenalty)
→ \unpenalty
Examples:
\unpenalty
The primitive \unpenalty is defined in the set tex.
The Primitive \unskip
The formal description of this primitive is the following:
(unskip)
→ \unskip
Examples:
\unskip
The primitive \unskip is defined in the set tex.
The Primitive \unvbox
To be completed.
The formal description of this primitive is the following:
(unvbox)
→ \unvbox (8-bit number)
Examples:
\unvbox42
The primitive \unvbox is defined in the set tex.
146
4.2. Primitives of εXTEX
The Primitive \unvcopy
To be completed.
The formal description of this primitive is the following:
(unvcopy)
→ \unvcopy (8-bit number)
Examples:
\unvcopy42
The primitive \unvcopy is defined in the set tex.
The Primitive \uppercase
To be completed.
The formal description of this primitive is the following:
(uppercase)
→ \uppercase (...)
Examples:
\uppercase ...
The primitive \uppercase is defined in the set tex.
To be completed.
The formal description of this primitive is the following:
Examples:
The primitive \vadjust is defined in the set tex.
147
4. The Macro Language of εXTEX
The Primitive \valign
To be completed.
The formal description of this primitive is the following:
(valign)
→ \valign
Examples:
\valign
The primitive \valign is defined in the set tex.
\vbadness is a count register. The primitive \vbadness is defined in the set tex.
The Primitive \vbox
To be completed.
The contents of the toks register \everyvbox is inserted at the beginning of the vertical
material of the box.
The formal description of this primitive is the following:
(vbox)
→ \vbox (box specification) { (vertical material) {
(box specification)
|
to (rule dimension)
|
Examples:
\vbox{abc}
\vbox to 120pt{abc}
148
4.2. Primitives of εXTEX
The Tokens Parameter \everyvbox
The tokens parameter is used in /vbox. The tokens contained are inserted at the beginnig
of the vertical material of the vbox.
The primitive \vbox is defined in the set tex.
The Math Primitive \vcenter
To be completed.
Syntax
The formal description of this primitive is the following:
(vcenter)
→ \vcenter ...
Examples
\vcenter
The primitive \vcenter is defined in the set tex.
The Primitive \vfil
To be completed.
The formal description of this primitive is the following:
(vfi)
→ \vfi
Examples:
\vfi
The primitive \vfi is defined in the set omega.
149
4. The Macro Language of εXTEX
The Primitive \vfil
To be completed.
The formal description of this primitive is the following:
(vfil)
→ \vfil
Examples:
\vfil
The primitive \vfil is defined in the set tex.
The Primitive \vfill
To be completed.
The formal description of this primitive is the following:
(vfill)
→ \vfill
Examples:
\vfill
The primitive \vfill is defined in the set tex.
The Primitive \vfilneg
To be completed.
The formal description of this primitive is the following:
(vfilneg)
→ \vfilneg
Examples:
\vfilneg
The primitive \vfilneg is defined in the set tex.
150
4.2. Primitives of εXTEX
The Dimen Primitive \vfuzz
\vfuzz is a dimen register. The primitive \vfuzz is defined in the set tex.
The Dimen Primitive \voffset
\voffset is a dimen register. The primitive \voffset is defined in the set tex.
The Primitive \vrule
This primitive produces a vertical rule. This is a rectangular area of specified dimensions.
If not overwritten the height and depth are 0pt and the width is 0.4 pt (26214 sp).
The formal description of this primitive is the following:
(vrule)
→ \vrule(rule specification)
(rule specification)
→ (optional spaces)
|
(rule dimension) (rule specification)
(rule dimension)
→ width (dimen)
|
height (dimen)
|
depth (dimen)
The color from the typographic context is taken as foregroud color for the rule. The
default color is black.
Examples:
\vrule
\vrule height 2pt
\vrule width 2pt depth 3mm height \dimen4
The primitive \vrule is defined in the set tex.
The Dimen Primitive \vsize
\vsize is a dimen register. The primitive \vsize is defined in the set tex.
The Primitive \vskip
To be completed.
The formal description of this primitive is the following:
151
4. The Macro Language of εXTEX
(vskip)
→ \vskip (Glue)
Examples:
\vskip 1em plus 1pt minus 1pt
The primitive \vskip is defined in the set tex.
The Primitive \vsplit
To be completed.
The formal description of this primitive is the following:
(vsplit)
→ \vsplit
Examples:
\vsplit ...
The primitive \vsplit is defined in the set tex.
The Primitive \vss
To be completed.
The formal description of this primitive is the following:
(vss)
→ \vss
Examples:
\vss
The primitive \vss is defined in the set tex.
152
4.2. Primitives of εXTEX
The Primitive \vtop
To be completed.
The contents of the toks register \everyvbox is inserted at the beginning of the vertical
material of the box.
The formal description of this primitive is the following:
(vtop)
→ \vtop (box specification) { (vertical material) {
(box specification)
|
to (rule dimension)
|
Examples:
\vtop{abc}
\vtop to 120pt{abc}
The primitive \vtop is defined in the set tex.
The Primitive \wd
To be completed.
The formal description of this primitive is the following:
(wd)
→ \wd (8-bit number) (equals) (dimen)
Examples:
\wd42
The primitive \wd is defined in the set tex.
The Primitive \widowpenalties
\widowpenalties is not implemented yet.
The primitive \widowpenalties is defined in the set etex.
153
4. The Macro Language of εXTEX
The Count Primitive \widowpenalty
\widowpenalty is a count register. The primitive \widowpenalty is defined in the set
tex.
The Primitive \write
To be completed.
Syntax
Examples
\immediate\openout3= abc.def
\write3{Hi there!}
\closeout3
The primitive \write is defined in the set tex.
The Primitive \xdef
To be completed.
The formal description of this primitive is the following:
(xdef )
→ (prefix) \xdef (control sequence) (parameter text) { (replacement text) }
(prefix)
|
\global (prefix)
|
\long (prefix)
|
\outer (prefix)
Examples:
\xdef#1{--#1--}
The primitive \xdef is defined in the set tex.
154
4.2. Primitives of εXTEX
To be completed.
The formal description of this primitive is the following:
Examples:
The primitive \xleaders is defined in the set tex.
The Glue Primitive \xspaceskip
\xspaceskip is a skip register. The primitive \xspaceskip is defined in the set tex.
The Count Primitive \year
\year is a count register. The primitive \year is defined in the set tex.
155
4. The Macro Language of εXTEX
156
Version 1.2, November 2002
Foundation, Inc.
51 Franklin St, Fifth Floor, Boston, MA
02110-1301 USA
Everyone is permitted to copy and distribute
verbatim copies of this license document, but
changing it is not allowed.
Preamble
The purpose of this License is to make a man-
ual, textbook, or other functional and useful doc-
ument “free” in the sense of freedom: to assure
everyone the effective freedom to copy and redis-
tribute it, with or without modifying it, either
commercially or noncommercially.
Secondarily,
this License preserves for the author and publisher
a way to get credit for their work, while not being
considered responsible for modifications made by
others.
This License is a kind of “copyleft”, which
means that derivative works of the document
must themselves be free in the same sense. It
complements the GNU General Public License,
ware.
We have designed this License in order to use
ware needs free documentation: a free program
should come with manuals providing the same
freedoms that the software does. But this Li-
cense is not limited to software manuals; it can
be used for any textual work, regardless of sub-
ject matter or whether it is published as a printed
book. We recommend this License principally for
works whose purpose is instruction or reference.
1. APPLICABILITY AND
DEFINITIONS
This License applies to any manual or other
work, in any medium, that contains a notice
placed by the copyright holder saying it can be
a notice grants a world-wide, royalty-free license,
unlimited in duration, to use that work under the
conditions stated herein. The “Document”, be-
low, refers to any such manual or work. Any
dressed as “you”. You accept the license if you
copy, modify or distribute the work in a way re-
A “Modified Version” of the Document means
any work containing the Document or a portion of
it, either copied verbatim, or with modifications
and/or translated into another language.
A “Secondary Section” is a named appendix
or a front-matter section of the Document that
deals exclusively with the relationship of the pub-
lishers or authors of the Document to the Docu-
ment’s overall subject (or to related matters) and
contains nothing that could fall directly within
that overall subject. (Thus, if the Document is
in part a textbook of mathematics, a Secondary
Section may not explain any mathematics.) The
relationship could be a matter of historical con-
nection with the subject or with related matters,
or of legal, commercial, philosophical, ethical or
political position regarding them.
The “Invariant Sections” are certain Sec-
ondary Sections whose titles are designated, as
being those of Invariant Sections, in the notice
that says that the Document is released under
this License. If a section does not fit the above
definition of Secondary then it is not allowed
to be designated as Invariant. The Document
may contain zero Invariant Sections. If the Doc-
ument does not identify any Invariant Sections
then there are none.
The “Cover Texts” are certain short passages
of text that are listed, as Front-Cover Texts or
Back-Cover Texts, in the notice that says that
the Document is released under this License. A
Front-Cover Text may be at most 5 words, and a
Back-Cover Text may be at most 25 words.
A “Transparent” copy of the Document means
a machine-readable copy, represented in a for-
mat whose specification is available to the gen-
eral public, that is suitable for revising the doc-
ument straightforwardly with generic text editors
or (for images composed of pixels) generic paint
programs or (for drawings) some widely available
drawing editor, and that is suitable for input to
text formatters or for automatic translation to a
variety of formats suitable for input to text for-
matters. A copy made in an otherwise Trans-
parent file format whose markup, or absence of
markup, has been arranged to thwart or discour-
age subsequent modification by readers is not
Transparent. An image format is not Transpar-
ent if used for any substantial amount of text. A
copy that is not “Transparent” is called “Opaque”.
Examples of suitable formats for Transpar-
ent copies include plain ASCII without markup,
Texinfo input format, LATEX input format, SGML
or XML using a publicly available DTD, and
standard-conforming simple HTML, PostScript or
PDF designed for human modification. Examples
of transparent image formats include PNG, XCF
and JPG. Opaque formats include proprietary for-
mats that can be read and edited only by propri-
etary word processors, SGML or XML for which
the DTD and/or processing tools are not gener-
ally available, and the machine-generated HTML,
PostScript or PDF produced by some word pro-
cessors for output purposes only.
The “Title Page” means, for a printed book,
the title page itself, plus such following pages as
are needed to hold, legibly, the material this Li-
cense requires to appear in the title page. For
works in formats which do not have any title page
as such, “Title Page” means the text near the
most prominent appearance of the work’s title,
preceding the beginning of the body of the text.
A section “Entitled XYZ” means a named sub-
unit of the Document whose title either is pre-
cisely XYZ or contains XYZ in parentheses fol-
lowing text that translates XYZ in another lan-
guage. (Here XYZ stands for a specific section
name mentioned below, such as “Acknowledge-
ments”, “Dedications”, “Endorsements”, or “His-
tory”.) To “Preserve the Title” of such a section
when you modify the Document means that it re-
mains a section “Entitled XYZ” according to this
definition.
The Document may include Warranty Dis-
claimers next to the notice which states that this
License applies to the Document. These War-
ranty Disclaimers are considered to be included
by reference in this License, but only as regards
disclaiming warranties: any other implication that
these Warranty Disclaimers may have is void and
has no effect on the meaning of this License.
2. VERBATIM COPYING
You may copy and distribute the Document
in any medium, either commercially or noncom-
mercially, provided that this License, the copy-
right notices, and the license notice saying this
License applies to the Document are reproduced
in all copies, and that you add no other conditions
whatsoever to those of this License. You may not
use technical measures to obstruct or control the
reading or further copying of the copies you make
or distribute. However, you may accept compen-
sation in exchange for copies. If you distribute
a large enough number of copies you must also
follow the conditions in section 3.
You may also lend copies, under the same
conditions stated above, and you may publicly
display copies.
3. COPYING IN QUANTITY
If you publish printed copies (or copies in me-
dia that commonly have printed covers) of the
Document, numbering more than 100, and the
Document’s license notice requires Cover Texts,
you must enclose the copies in covers that carry,
clearly and legibly, all these Cover Texts: Front-
Cover Texts on the front cover, and Back-Cover
Texts on the back cover. Both covers must also
clearly and legibly identify you as the publisher of
these copies. The front cover must present the
full title with all words of the title equally promi-
nent and visible. You may add other material
on the covers in addition. Copying with changes
limited to the covers, as long as they preserve
the title of the Document and satisfy these con-
ditions, can be treated as verbatim copying in
other respects.
If the required texts for either cover are too
voluminous to fit legibly, you should put the first
ones listed (as many as fit reasonably) on the ac-
tual cover, and continue the rest onto adjacent
pages.
If you publish or distribute Opaque copies of
the Document numbering more than 100, you
must either include a machine-readable Transpar-
ent copy along with each Opaque copy, or state in
or with each Opaque copy a computer-network lo-
cation from which the general network-using pub-
network protocols a complete Transparent copy
of the Document, free of added material. If you
use the latter option, you must take reasonably
prudent steps, when you begin distribution of
Opaque copies in quantity, to ensure that this
Transparent copy will remain thus accessible at
157
the stated location until at least one year after
the last time you distribute an Opaque copy (di-
rectly or through your agents or retailers) of that
edition to the public.
It is requested, but not required, that you
contact the authors of the Document well before
redistributing any large number of copies, to give
them a chance to provide you with an updated
version of the Document.
4. MODIFICATIONS
You may copy and distribute a Modified Ver-
sion of the Document under the conditions of
sections 2 and 3 above, provided that you re-
lease the Modified Version under precisely this
License, with the Modified Version filling the role
of the Document, thus licensing distribution and
modification of the Modified Version to whoever
possesses a copy of it. In addition, you must do
these things in the Modified Version:
A. Use in the Title Page (and on the cov-
ers, if any) a title distinct from that of
the Document, and from those of pre-
vious versions (which should, if there
were any, be listed in the History sec-
tion of the Document). You may use
the same title as a previous version if
the original publisher of that version
gives permission.
B. List on the Title Page, as authors, one
or more persons or entities responsible
for authorship of the modifications in
the Modified Version, together with at
least five of the principal authors of the
Document (all of its principal authors,
if it has fewer than five), unless they
release you from this requirement.
C. State on the Title page the name of
the publisher of the Modified Version,
as the publisher.
D. Preserve all the copyright notices of the
Document.
F. Include, immediately after the copy-
right notices, a license notice giving the
public permission to use the Modified
Version under the terms of this License,
in the form shown in the Addendum be-
low.
G. Preserve in that license notice the full
lists of Invariant Sections and required
Cover Texts given in the Document’s
H. Include an unaltered copy of this Li-
cense.
I. Preserve the section Entitled “History”,
Preserve its Title, and add to it an item
stating at least the title, year, new au-
thors, and publisher of the Modified
Version as given on the Title Page. If
there is no section Entitled “History” in
the Document, create one stating the
title, year, authors, and publisher of the
Document as given on its Title Page,
then add an item describing the Mod-
ified Version as stated in the previous
sentence.
J. Preserve the network location, if any,
given in the Document for public ac-
cess to a Transparent copy of the Doc-
ument, and likewise the network loca-
tions given in the Document for pre-
vious versions it was based on. These
may be placed in the “History” section.
You may omit a network location for a
work that was published at least four
years before the Document itself, or if
the original publisher of the version it
refers to gives permission.
K. For any section Entitled “Acknowledge-
ments” or “Dedications”, Preserve the
Title of the section, and preserve in
the section all the substance and tone
of each of the contributor acknowl-
edgements and/or dedications given
therein.
L. Preserve all the Invariant Sections of
the Document, unaltered in their text
and in their titles. Section numbers or
the equivalent are not considered part
of the section titles.
M. Delete any section Entitled “Endorse-
ments”. Such a section may not be in-
cluded in the Modified Version.
N. Do not retitle any existing section to be
Entitled “Endorsements” or to conflict
in title with any Invariant Section.
O. Preserve any Warranty Disclaimers.
If the Modified Version includes new front-
matter sections or appendices that qualify as Sec-
ondary Sections and contain no material copied
from the Document, you may at your option des-
ignate some or all of these sections as invariant.
To do this, add their titles to the list of Invariant
Sections in the Modified Version’s license notice.
These titles must be distinct from any other sec-
tion titles.
You may add a section Entitled “Endorse-
ments”, provided it contains nothing but en-
dorsements of your Modified Version by various
parties–for example, statements of peer review or
that the text has been approved by an organiza-
tion as the authoritative definition of a standard.
You may add a passage of up to five words
as a Front-Cover Text, and a passage of up to
25 words as a Back-Cover Text, to the end of
the list of Cover Texts in the Modified Version.
Only one passage of Front-Cover Text and one of
Back-Cover Text may be added by (or through ar-
rangements made by) any one entity. If the Doc-
ument already includes a cover text for the same
cover, previously added by you or by arrangement
made by the same entity you are acting on be-
half of, you may not add another; but you may
replace the old one, on explicit permission from
the previous publisher that added the old one.
The author(s) and publisher(s) of the Docu-
ment do not by this License give permission to
use their names for publicity for or to assert or
imply endorsement of any Modified Version.
5. COMBINING DOCUMENTS
You may combine the Document with other
documents released under this License, under the
terms defined in section 4 above for modified ver-
sions, provided that you include in the combi-
nation all of the Invariant Sections of all of the
original documents, unmodified, and list them all
as Invariant Sections of your combined work in
its license notice, and that you preserve all their
Warranty Disclaimers.
The combined work need only contain one
copy of this License, and multiple identical Invari-
ant Sections may be replaced with a single copy.
If there are multiple Invariant Sections with the
same name but different contents, make the title
of each such section unique by adding at the end
of it, in parentheses, the name of the original au-
thor or publisher of that section if known, or else
a unique number. Make the same adjustment to
the section titles in the list of Invariant Sections
in the license notice of the combined work.
In the combination, you must combine any
sections Entitled “History” in the various orig-
inal documents, forming one section Entitled
“History”; likewise combine any sections Entitled
“Acknowledgements”, and any sections Entitled
“Dedications”. You must delete all sections Enti-
tled “Endorsements”.
6. COLLECTIONS OF DOCUMENTS
You may make a collection consisting of the
Document and other documents released under
this License, and replace the individual copies of
this License in the various documents with a sin-
gle copy that is included in the collection, pro-
verbatim copying of each of the documents in all
other respects.
You may extract a single document from such
a collection, and distribute it individually under
this License, provided you insert a copy of this
License into the extracted document, and follow
this License in all other respects regarding verba-
tim copying of that document.
7. AGGREGATION WITH
INDEPENDENT WORKS
A compilation of the Document or its deriva-
tives with other separate and independent docu-
ments or works, in or on a volume of a storage
or distribution medium, is called an “aggregate”
if the copyright resulting from the compilation
is not used to limit the legal rights of the com-
pilation’s users beyond what the individual works
permit. When the Document is included in an ag-
gregate, this License does not apply to the other
works in the aggregate which are not themselves
derivative works of the Document.
If the Cover Text requirement of section 3 is
applicable to these copies of the Document, then
if the Document is less than one half of the en-
tire aggregate, the Document’s Cover Texts may
be placed on covers that bracket the Document
within the aggregate, or the electronic equivalent
of covers if the Document is in electronic form.
Otherwise they must appear on printed covers
that bracket the whole aggregate.
8. TRANSLATION
Translation is considered a kind of modifica-
tion, so you may distribute translations of the
Document under the terms of section 4. Replac-
ing Invariant Sections with translations requires
special permission from their copyright holders,
but you may include translations of some or all
Invariant Sections in addition to the original ver-
sions of these Invariant Sections. You may in-
clude a translation of this License, and all the
license notices in the Document, and any War-
ranty Disclaimers, provided that you also include
the original English version of this License and the
original versions of those notices and disclaimers.
In case of a disagreement between the translation
and the original version of this License or a notice
or disclaimer, the original version will prevail.
If a section in the Document is Entitled “Ac-
knowledgements”, “Dedications”, or “History”, the
requirement (section 4) to Preserve its Title (sec-
tion 1) will typically require changing the actual
title.
9. TERMINATION
You may not copy, modify, sublicense, or dis-
tribute the Document except as expressly pro-
vided for under this License. Any other attempt
to copy, modify, sublicense or distribute the Doc-
ument is void, and will automatically terminate
who have received copies, or rights, from you un-
minated so long as such parties remain in full
compliance.
158
A.2. GNU Library General Public License
10. FUTURE REVISIONS OF THIS
The Free Software Foundation may publish
new, revised versions of the GNU Free Documen-
tation License from time to time. Such new ver-
sions will be similar in spirit to the present version,
but may differ in detail to address new problems
or concerns. See http://www.gnu.org/copyleft/.
Each version of the License is given a distin-
guishing version number. If the Document spec-
ifies that a particular numbered version of this
License “or any later version” applies to it, you
have the option of following the terms and con-
ditions either of that specified version or of any
later version that has been published (not as a
draft) by the Free Software Foundation. If the
Document does not specify a version number of
this License, you may choose any version ever
published (not as a draft) by the Free Software
Foundation.
To use this License in a document you have
written, include a copy of the License in the docu-
notices just after the title page:
c
NAME.
Permission
is
granted
to
copy, distribute and/or mod-
ify this document under the
terms of the GNU Free Doc-
1.2 or any later version pub-
lished by the Free Software
Foundation; with no Invari-
ant Sections, no Front-Cover
Texts, and no Back-Cover
Texts. A copy of the license
is included in the section en-
titled “GNU Free Documen-
If you
have
Invariant
Sections,
Front-
Cover Texts and Back-Cover Texts, replace the
“with...Texts.” line with this:
with the Invariant Sections
being LIST THEIR TITLES,
with the Front-Cover Texts
being LIST, and with the
Back-Cover
Texts
being
LIST.
If you have Invariant Sections without Cover
Texts, or some other combination of the three,
merge those two alternatives to suit the situa-
tion.
If your document contains nontrivial exam-
ples of program code, we recommend releasing
these examples in parallel under your choice of
free software license, such as the GNU General
Public License, to permit their use in free soft-
ware.
A.2. GNU Library General Public License
Version 2, June 1991
Inc. 59 Temple Place - Suite 330, Boston, MA
02111-1307, USA Everyone is permitted to copy
and distribute verbatim copies of this license doc-
ument, but changing it is not allowed.
[This is the first released version of the li-
brary GPL. It is numbered 2 because it goes with
version 2 of the ordinary GPL.]
Preamble
The licenses for most software are designed
to take away your freedom to share and change it.
By contrast, the GNU General Public Licenses are
intended to guarantee your freedom to share and
change free software–to make sure the software
is free for all its users.
This license, the Library General Public Li-
cense, applies to some specially designated Free
Software Foundation software, and to any other
libraries whose authors decide to use it. You can
use it for your libraries, too.
When we speak of free software, we are re-
ferring to freedom, not price. Our General Public
Licenses are designed to make sure that you have
the freedom to distribute copies of free software
(and charge for this service if you wish), that you
receive source code or can get it if you want it,
that you can change the software or use pieces of
it in new free programs; and that you know you
can do these things.
To protect your rights, we need to make re-
strictions that forbid anyone to deny you these
rights or to ask you to surrender the rights. These
restrictions translate to certain responsibilities for
you if you distribute copies of the library, or if you
modify it.
For example, if you distribute copies of the
library, whether gratis or for a fee, you must give
the recipients all the rights that we gave you. You
must make sure that they, too, receive or can get
the source code. If you link a program with the
library, you must provide complete object files to
the recipients so that they can relink them with
the library, after making changes to the library
and recompiling it. And you must show them
these terms so they know their rights.
Our method of protecting your rights has two
steps: (1) copyright the library, and (2) offer you
this license which gives you legal permission to
copy, distribute and/or modify the library.
Also, for each distributor’s protection, we
want to make certain that everyone understands
that there is no warranty for this free library. If
the library is modified by someone else and passed
on, we want its recipients to know that what they
have is not the original version, so that any prob-
lems introduced by others will not reflect on the
original authors’ reputations.
Finally, any free program is threatened con-
stantly by software patents. We wish to avoid
the danger that companies distributing free soft-
ware will individually obtain patent licenses, thus
in effect transforming the program into propri-
etary software. To prevent this, we have made it
clear that any patent must be licensed for every-
one’s free use or not licensed at all.
Most GNU software, including some libraries,
is covered by the ordinary GNU General Public
License, which was designed for utility programs.
This license, the GNU Library General Public Li-
cense, applies to certain designated libraries. This
license is quite different from the ordinary one; be
sure to read it in full, and don’t assume that any-
thing in it is the same as in the ordinary license.
The reason we have a separate public license
for some libraries is that they blur the distinction
we usually make between modifying or adding to
a program and simply using it. Linking a pro-
gram with a library, without changing the library,
is in some sense simply using the library, and is
analogous to running a utility program or appli-
cation program. However, in a textual and legal
sense, the linked executable is a combined work, a
derivative of the original library, and the ordinary
General Public License treats it as such.
Because of this blurred distinction, using the
ordinary General Public License for libraries did
not effectively promote software sharing, because
most developers did not use the libraries. We
concluded that weaker conditions might promote
sharing better.
However, unrestricted linking of non-free pro-
grams would deprive the users of those programs
of all benefit from the free status of the libraries
themselves. This Library General Public License
is intended to permit developers of non-free pro-
grams to use free libraries, while preserving your
freedom as a user of such programs to change
the free libraries that are incorporated in them.
(We have not seen how to achieve this as regards
changes in header files, but we have achieved it
as regards changes in the actual functions of the
Library.) The hope is that this will lead to faster
development of free libraries.
The precise terms and conditions for copy-
ing, distribution and modification follow.
Pay
close attention to the difference between a “work
based on the library” and a “work that uses the
library”. The former contains code derived from
the library, while the latter only works together
with the library.
Note that it is possible for a library to be cov-
ered by the ordinary General Public License rather
than by this special one.
TERMS AND CONDITIONS FOR
COPYING, DISTRIBUTION AND
MODIFICATION
0. This License Agreement applies to any
software library which contains a notice
placed by the copyright holder or other
authorized party saying it may be dis-
tributed under the terms of this Library
General Public License (also called “this
“you”.
A “library” means a collection of soft-
ware functions and/or data prepared so
as to be conveniently linked with ap-
plication programs (which use some of
those functions and data) to form exe-
cutables.
The “Library”, below, refers to any such
software library or work which has been
based on the Library” means either
the Library or any derivative work un-
der copyright law: that is to say, a
work containing the Library or a por-
tion of it, either verbatim or with mod-
ifications and/or translated straightfor-
wardly into another language. (Here-
inafter, translation is included without
limitation in the term “modification”.)
“Source code” for a work means the
preferred form of the work for making
modifications to it. For a library, com-
plete source code means all the source
code for all modules it contains, plus
any associated interface definition files,
plus the scripts used to control compi-
lation and installation of the library.
Activities other than copying, distribu-
tion and modification are not covered
by this License; they are outside its
scope. The act of running a program
using the Library is not restricted, and
output from such a program is covered
only if its contents constitute a work
based on the Library (independent of
159
the use of the Library in a tool for writ-
ing it). Whether that is true depends
on what the Library does and what the
program that uses the Library does.
1. You may copy and distribute verbatim
copies of the Library’s complete source
code as you receive it, in any medium,
provided that you conspicuously and
appropriately publish on each copy an
claimer of warranty; keep intact all the
notices that refer to this License and
to the absence of any warranty; and
distribute a copy of this License along
with the Library.
You may charge a fee for the physical
act of transferring a copy, and you may
at your option offer warranty protection
in exchange for a fee.
2. You may modify your copy or copies of
the Library or any portion of it, thus
forming a work based on the Library,
and copy and distribute such modifica-
tions or work under the terms of Sec-
tion 1 above, provided that you also
meet all of these conditions:
a) The modified work must itself
be a software library.
b) You must cause the files mod-
ified to carry prominent no-
tices stating that you changed
the files and the date of any
change.
c) You must cause the whole of
the work to be licensed at no
charge to all third parties un-
der the terms of this License.
d) If a facility in the modified Li-
brary refers to a function or a
table of data to be supplied by
an application program that
uses the facility, other than
as an argument passed when
the facility is invoked, then
you must make a good faith
effort to ensure that, in the
event an application does not
supply such function or ta-
ble, the facility still operates,
and performs whatever part of
its purpose remains meaning-
ful.
(For example, a func-
tion in a library to compute
square roots has a purpose
that is entirely well-defined in-
dependent of the application.
Therefore, Subsection 2d re-
quires that any application-
supplied function or table used
by this function must be op-
tional: if the application does
not supply it, the square root
function must still compute
square roots.)
These requirements apply to the mod-
ified work as a whole. If identifiable
sections of that work are not derived
from the Library, and can be reason-
ably considered independent and sep-
arate works in themselves, then this
License, and its terms, do not apply
to those sections when you distribute
them as separate works. But when you
distribute the same sections as part of
a whole which is a work based on the
Library, the distribution of the whole
must be on the terms of this License,
extend to the entire whole, and thus to
each and every part regardless of who
wrote it.
Thus, it is not the intent of this section
to claim rights or contest your rights
to work written entirely by you; rather,
the intent is to exercise the right to
control the distribution of derivative or
collective works based on the Library.
In addition, mere aggregation of an-
other work not based on the Library
with the Library (or with a work based
on the Library) on a volume of a stor-
age or distribution medium does not
bring the other work under the scope
3. You may opt to apply the terms of the
of the Library. To do this, you must al-
ter all the notices that refer to this Li-
cense, so that they refer to the ordinary
GNU General Public License, version 2,
version than version 2 of the ordinary
GNU General Public License has ap-
peared, then you can specify that ver-
sion instead if you wish.) Do not make
any other change in these notices.
Once this change is made in a given
copy, it is irreversible for that copy, so
the ordinary GNU General Public Li-
cense applies to all subsequent copies
and derivative works made from that
copy.
This option is useful when you wish to
copy part of the code of the Library into
a program that is not a library.
4. You may copy and distribute the Li-
brary (or a portion or derivative of
it, under Section 2) in object code
or executable form under the terms of
Sections 1 and 2 above provided that
you accompany it with the complete
the terms of Sections 1 and 2 above on
a medium customarily used for software
interchange.
If distribution of object code is made
ignated place, then offering equivalent
same place satisfies the requirement to
distribute the source code, even though
third parties are not compelled to copy
the source along with the object code.
5. A program that contains no derivative
of any portion of the Library, but is de-
signed to work with the Library by be-
ing compiled or linked with it, is called
a “work that uses the Library”. Such
a work, in isolation, is not a derivative
work of the Library, and therefore falls
outside the scope of this License.
However, linking a “work that uses the
Library” with the Library creates an ex-
ecutable that is a derivative of the Li-
brary (because it contains portions of
the Library), rather than a “work that
uses the library”.
The executable is
therefore covered by this License. Sec-
tion 6 states terms for distribution of
such executables.
When a “work that uses the Library”
uses material from a header file that
is part of the Library, the object code
for the work may be a derivative work
of the Library even though the source
code is not. Whether this is true is
especially significant if the work can
be linked without the Library, or if the
work is itself a library. The threshold
for this to be true is not precisely de-
fined by law.
If such an object file uses only nu-
merical parameters, data structure lay-
outs and accessors, and small macros
and small inline functions (ten lines
or less in length), then the use of
the object file is unrestricted, regard-
less of whether it is legally a derivative
work. (Executables containing this ob-
ject code plus portions of the Library
will still fall under Section 6.)
Otherwise, if the work is a derivative of
the Library, you may distribute the ob-
ject code for the work under the terms
of Section 6. Any executables contain-
ing that work also fall under Section 6,
whether or not they are linked directly
with the Library itself.
6. As an exception to the Sections above,
you may also compile or link a “work
that uses the Library” with the Library
to produce a work containing portions
of the Library, and distribute that work
under terms of your choice, provided
that the terms permit modification of
the work for the customer’s own use
and reverse engineering for debugging
such modifications.
You must give prominent notice with
each copy of the work that the Library
is used in it and that the Library and
its use are covered by this License. You
must supply a copy of this License.
If the work during execution displays
copyright notices, you must include the
copyright notice for the Library among
them, as well as a reference directing
the user to the copy of this License.
Also, you must do one of these things:
a) Accompany the work with
the complete corresponding
for the Library including what-
ever changes were used in
the work (which must be dis-
tributed under Sections 1 and
2 above); and, if the work
the Library, with the com-
that uses the Library”, as ob-
ject code and/or source code,
so that the user can mod-
ify the Library and then re-
link to produce a modified ex-
ecutable containing the modi-
fied Library. (It is understood
that the user who changes the
contents of definitions files in
the Library will not necessarily
be able to recompile the ap-
plication to use the modified
definitions.)
b) Accompany the work with a
written offer, valid for at least
three years, to give the same
user the materials specified
in Subsection 6a, above, for
a charge no more than the
cost of performing this distri-
bution.
c) If distribution of the work is
copy from a designated place,
the above specified materials
from the same place.
d) Verify that the user has al-
materials or that you have al-
ready sent this user a copy.
160
For an executable, the required form
of the “work that uses the Library”
must include any data and utility pro-
grams needed for reproducing the exe-
cutable from it. However, as a special
exception, the source code distributed
need not include anything that is nor-
mally distributed (in either source or bi-
nary form) with the major components
(compiler, kernel, and so on) of the op-
erating system on which the executable
runs, unless that component itself ac-
companies the executable.
It may happen that this requirement
other proprietary libraries that do not
normally accompany the operating sys-
tem. Such a contradiction means you
cannot use both them and the Library
together in an executable that you dis-
tribute.
7. You may place library facilities that are
a work based on the Library side-by-
side in a single library together with
other library facilities not covered by
this License, and distribute such a com-
bined library, provided that the sepa-
rate distribution of the work based on
the Library and of the other library fa-
cilities is otherwise permitted, and pro-
vided that you do these two things:
a) Accompany the combined library
with a copy of the same work based
on the Library, uncombined with any
other library facilities. This must be
tions above.
b) Give prominent notice with the com-
bined library of the fact that part of it
is a work based on the Library, and ex-
plaining where to find the accompany-
ing uncombined form of the same work.
8. You may not copy, modify, sublicense,
link with, or distribute the Library ex-
cept as expressly provided under this Li-
cense. Any attempt otherwise to copy,
tribute the Library is void, and will au-
der this License. However, parties who
have received copies, or rights, from
you under this License will not have
their licenses terminated so long as
such parties remain in full compliance.
9. You are not required to accept this Li-
cense, since you have not signed it.
However, nothing else grants you per-
mission to modify or distribute the Li-
brary or its derivative works. These ac-
tions are prohibited by law if you do
not accept this License. Therefore, by
modifying or distributing the Library
(or any work based on the Library), you
to do so, and all its terms and condi-
tions for copying, distributing or modi-
fying the Library or works based on it.
10. Each time you redistribute the Library
(or any work based on the Library),
the recipient automatically receives a li-
cense from the original licensor to copy,
distribute, link with or modify the Li-
brary subject to these terms and con-
ditions. You may not impose any fur-
ther restrictions on the recipients’ exer-
cise of the rights granted herein. You
are not responsible for enforcing com-
pliance by third parties to this License.
11. If, as a consequence of a court judg-
ment or allegation of patent infringe-
ment or for any other reason (not lim-
ited to patent issues), conditions are
imposed on you (whether by court or-
der, agreement or otherwise) that con-
they do not excuse you from the con-
ditions of this License. If you cannot
distribute so as to satisfy simultane-
ously your obligations under this Li-
cense and any other pertinent obliga-
tions, then as a consequence you may
not distribute the Library at all. For
example, if a patent license would not
permit royalty-free redistribution of the
Library by all those who receive copies
directly or indirectly through you, then
the only way you could satisfy both it
and this License would be to refrain en-
tirely from distribution of the Library.
If any portion of this section is held in-
valid or unenforceable under any partic-
ular circumstance, the balance of the
section is intended to apply, and the
section as a whole is intended to apply
in other circumstances.
It is not the purpose of this section to
induce you to infringe any patents or
other property right claims or to con-
test validity of any such claims; this
section has the sole purpose of pro-
tecting the integrity of the free soft-
ware distribution system which is im-
Many people have made generous con-
tributions to the wide range of software
distributed through that system in re-
liance on consistent application of that
system; it is up to the author/donor to
decide if he or she is willing to distribute
software through any other system and
a licensee cannot impose that choice.
This section is intended to make thor-
oughly clear what is believed to be a
consequence of the rest of this License.
12. If the distribution and/or use of the Li-
brary is restricted in certain countries
either by patents or by copyrighted in-
who places the Library under this Li-
cense may add an explicit geographical
distribution limitation excluding those
countries, so that distribution is per-
mitted only in or among countries not
thus excluded. In such case, this Li-
cense incorporates the limitation as if
written in the body of this License.
13. The Free Software Foundation may
publish revised and/or new versions of
the Library General Public License from
time to time. Such new versions will be
similar in spirit to the present version,
but may differ in detail to address new
problems or concerns.
Each version is given a distinguishing
version number. If the Library speci-
fies a version number of this License
which applies to it and “any later ver-
sion”, you have the option of following
the terms and conditions either of that
version or of any later version published
by the Free Software Foundation. If
the Library does not specify a license
version number, you may choose any
ware Foundation.
14. If you wish to incorporate parts of the
Library into other free programs whose
distribution conditions are incompati-
ble with these, write to the author to
ask for permission. For software which
is copyrighted by the Free Software
Foundation, write to the Free Soft-
ware Foundation; we sometimes make
exceptions for this. Our decision will
be guided by the two goals of preserv-
ing the free status of all derivatives of
our free software and of promoting the
sharing and reuse of software generally.
NO WARRANTY
15. BECAUSE
THE
LIBRARY
IS
LI-
CENSED FREE OF CHARGE, THERE
IS NO WARRANTY FOR THE LI-
BRARY, TO THE EXTENT PER-
MITTED BY APPLICABLE LAW. EX-
CEPT WHEN OTHERWISE STATED
IN
WRITING
THE
HOLDERS AND/OR OTHER PAR-
TIES PROVIDE THE LIBRARY “AS
IS” WITHOUT WARRANTY OF ANY
KIND, EITHER
EXPRESSED
OR
IMPLIED, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WAR-
RANTIES OF MERCHANTABILITY
AND FITNESS FOR A PARTICU-
LAR PURPOSE. THE ENTIRE RISK
AS TO THE QUALITY AND PER-
FORMANCE OF THE LIBRARY IS
WITH YOU. SHOULD THE LIBRARY
PROVE DEFECTIVE, YOU ASSUME
THE COST OF ALL NECESSARY
SERVICING, REPAIR OR CORREC-
TION.
16. IN NO EVENT UNLESS REQUIRED
BY APPLICABLE LAW OR AGREED
TO
IN
WRITING
WILL
ANY
HOLDER, OR
ANY
OTHER PARTY WHO MAY MOD-
IFY AND/OR REDISTRIBUTE THE
LIBRARY AS PERMITTED ABOVE,
BE LIABLE TO YOU FOR DAM-
AGES, INCLUDING ANY GENERAL,
SPECIAL, INCIDENTAL OR CON-
SEQUENTIAL DAMAGES ARISING
OUT OF THE USE OR INABILITY
TO USE THE LIBRARY (INCLUD-
ING BUT NOT LIMITED TO LOSS
OF DATA OR DATA BEING REN-
DERED INACCURATE OR LOSSES
SUSTAINED BY YOU OR THIRD
PARTIES OR A FAILURE OF THE
LIBRARY TO OPERATE WITH ANY
OTHER
SOFTWARE),
EVEN
IF
SUCH HOLDER OR OTHER PARTY
HAS BEEN ADVISED OF THE POS-
SIBILITY OF SUCH DAMAGES.
161
The Apache
Version 1.1
Redistribution and use in source and binary
forms, with or without modifica- tion, are per-
mitted provided that the following conditions are
met:
1. Redistributions of source code must re-
tain the above copyright notice, this
list of conditions and the following dis-
claimer.
2. Redistributions in binary form must re-
this list of conditions and the follow-
ing disclaimer in the documentation
and/or other materials provided with
the distribution.
3. The end-user documentation included
with the redistribution, if any, must
include the following acknowledgment:
“This product includes software devel-
oped by the Apache Software Founda-
tion (http://www.apache.org/).” Alter-
nately, this acknowledgment may ap-
pear in the software itself, if and wher-
ever such third-party acknowledgments
normally appear.
4. The names “Jakarta”, “Apache Avalon”,
“Avalon Excalibur”, “Avalon Frame-
work” and “Apache Software Founda-
tion” must not be used to endorse
or promote products derived from this
software without prior written permis-
sion.
contact apache@apache.org.
5. Products derived from this software
may not be called “Apache”, nor may
“Apache” appear in their name, without
prior written permission of the Apache
Software Foundation.
THIS SOFTWARE IS PROVIDED “AS IS”
AND ANY EXPRESSED OR IMPLIED WAR-
RANTIES, INCLUDING, BUT NOT LIMITED
TO, THE IMPLIED WARRANTIES OF MER-
CHANTABILITY AND FITNESS FOR A PAR-
TICULAR PURPOSE ARE DISCLAIMED. IN
NO EVENT SHALL THE APACHE SOFTWARE
FOUNDATION OR ITS CONTRIBUTORS BE
LIABLE FOR ANY DIRECT, INDIRECT, INCI-
DENTAL, SPECIAL, EXEMPLARY, OR CON-
SEQUENTIAL DAMAGES (INCLU- DING, BUT
NOT LIMITED TO, PROCUREMENT OF SUB-
STITUTE GOODS OR SERVICES; LOSS OF
USE, DATA, OR PROFITS; OR BUSINESS IN-
TERRUPTION) HOWEVER CAUSED AND ON
ANY THEORY OF LIABILITY, WHETHER IN
CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
This software consists of voluntary contri-
butions made by many individuals on behalf
of the Apache Software Foundation and was
originally created by Stefano Mazzocchi <ste-
Apache Software Foundation, please see <http:
A.4. ICU4J license - ICU4J 1.3.1 and later
ness Machines Corporation and others
Permission is hereby granted, free of charge,
to any person obtaining a copy of this software
and associated documentation files (the “Soft-
ware”), to deal in the Software without restric-
tion, including without limitation the rights to
use, copy, modify, merge, publish, distribute,
and/or sell copies of the Software, and to permit
persons to whom the Software is furnished to do
so, provided that the above copyright notice(s)
and this permission notice appear in all copies
of the Software and that both the above copy-
right notice(s) and this permission notice appear
in supporting documentation.
THE SOFTWARE IS PROVIDED “AS IS”,
WITHOUT WARRANTY OF ANY KIND, EX-
PRESS OR IMPLIED, INCLUDING BUT NOT
LIMITED TO THE WARRANTIES OF MER-
CHANTABILITY, FITNESS FOR A PARTICU-
LAR PURPOSE AND NONINFRINGEMENT OF
THIRD PARTY RIGHTS. IN NO EVENT SHALL
INCLUDED IN THIS NOTICE BE LIABLE
FOR ANY CLAIM, OR ANY SPECIAL INDI-
RECT OR CONSEQUENTIAL DAMAGES, OR
ANY DAMAGES WHATSOEVER RESULTING
FROM LOSS OF USE, DATA OR PROFITS,
WHETHER IN AN ACTION OF CONTRACT,
NEGLIGENCE OR OTHER TORTIOUS AC-
TION, ARISING OUT OF OR IN CONNECTION
WITH THE USE OR PERFORMANCE OF THIS
SOFTWARE.
Except as contained in this notice, the name
tising or otherwise to promote the sale, use or
other dealings in this Software without prior writ-
ten authorization of the copyright holder.
mentioned herein are the property of their respec-
tive owners.
Redistribution and use in source and binary
forms, with or without modification, are permit-
ted provided that the following conditions are
met:
1. Redistributions of source code must re-
tain the above copyright notice, this
list of conditions and the following dis-
claimer.
2. Redistributions in binary form must re-
this list of conditions and the follow-
ing disclaimer in the documentation
and/or other materials provided with
the distribution.
3. Neither the name of pdfbox; nor the
names of its contributors may be used
to endorse or promote products derived
from this software without specific prior
written permission.
THIS SOFTWARE IS PROVIDED BY THE
TORS “AS IS” AND ANY EXPRESS OR
IMPLIED WARRANTIES, INCLUDING, BUT
NOT LIMITED TO, THE IMPLIED WAR-
RANTIES OF MERCHANTABILITY AND FIT-
NESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE
REGENTS OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUEN-
TIAL DAMAGES (INCLUDING, BUT NOT LIM-
ITED TO, PROCUREMENT OF SUBSTITUTE
GOODS OR SERVICES; LOSS OF USE, DATA,
TION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CON-
TRACT, STRICT LIABILITY, OR TORT (IN-
CLUDING NEGLIGENCE OR OTHERWISE)
ARISING IN ANY WAY OUT OF THE USE OF
THIS SOFTWARE, EVEN IF ADVISED OF THE
POSSIBILITY OF SUCH DAMAGE.
162
Index
Symbols
– .................................. 21
〈...〉 . . 43, 54, 65, 88, 93, 109, 143, 147
.extex .............................. 11
\/ . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 30
&..................................21
\
\\ ................................. 19
〈4-bit number〉.....................38
〈8-bit number〉.....................27
〈8-bit number〉. . . . . . 3739, 41, 42, 46,
A
〈above〉 ............................ 30
\above . . . . . . . . . . . . . . . . . . . . . . . . . 19, 31
\abovedisplayshortskip. . . . . . . 19, 31
\abovedisplayskip . . . . . . . . . . . . 19, 31
〈abovewithdelims〉..................31
\abovewithdelims. . . . . . . . . . . . . . 19, 31
〈accent〉 ........................... 31
\accent . . . . . . . . . . . . . . . . . . . . . . . . 19, 32
\addafterocplist. . . . . . . . . . . . . . 18, 32
\addbeforeocplist . . . . . . . . . . . . 18, 32
\adjdemerits . . . . . . . . . . . . . . . . . . 19, 32
\advance. . . . . . . . . . . . . . . . . . . . . . . 19, 32
〈afterassignment〉 .................. 33
\afterassignment. . . . . . . . . . . . . . 19, 33
〈aftergroup〉 ....................... 33
\aftergroup . . . . . . . . . . . . . . . . . . . 19, 33
〈atop〉 ............................. 34
\atop . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 34
〈atopwithdelims〉...................34
\atopwithdelims. . . . . . . . . . . . . . . 19, 34
B
\badness. . . . . . . . . . . . . . . . . . . . . . . 19, 34
\baselineskip . . . . . . . . . . . . . . . . . 19, 35
batchmode . . . . . . . . . . . . . . . . . . . . . 13, 23
〈batchmode〉 ....................... 35
\batchmode . . . . . . . . . . . . . . . . . . . . 19, 35
〈begingroup〉 ....................... 35
\begingroup . . . . . . . . . . . . . . . . . . . 19, 35
\beginL . . . . . . . . . . . . . . . . . . . . . . . . 17, 36
\beginR . . . . . . . . . . . . . . . . . . . . . . . . 17, 36
\belowdisplayshortskip. . . . . . . 19, 36
\belowdisplayskip . . . . . . . . . . . . 19, 36
\binoppenalty . . . . . . . . . . . . . . . . . 19, 36
\botmark. . . . . . . . . . . . . . . . . . . . . . . 19, 36
\botmarks. . . . . . . . . . . . . . . . . . . . . .17, 36
〈box〉 . . . . . . . . 27, 37, 92, 102, 128, 134
\box . . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 37
〈box register name〉 ................ 27
〈box specification〉 . . . . 68, 69, 148, 153
\boxmaxdepth . . . . . . . . . . . . . . . . . . 19, 37
\brokenpenalty . . . . . . . . . . . . . . . . 19, 37
C
〈catcode〉 .......................... 38
\catcode. . . . . . . . . . . . . . . . . . . . . . . 19, 38
〈char〉 ............................. 39
\char . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 39
〈chardef 〉 .......................... 39
\chardef. . . . . . . . . . . . . . . . . . . . . . . 19, 39
\cleaders. . . . . . . . . . . . . . . . . . . . . .19, 39
\clearocplists . . . . . . . . . . . . . . . . 18, 40
〈closein〉...........................40
\closein. . . . . . . . . . . . . . . . . . . . . . . 19, 40
〈closeout〉..........................40
\closeout. . . . . . . . . . . . . . . . . . . . . .19, 40
\clubpenalties . . . . . . . . . . . . . . . . 17, 41
\clubpenalty . . . . . . . . . . . . . . . . . . 19, 41
-configuration ................... 21
〈control sequence〉 . . . . . . . . . 28, 39, 42,
44, 48, 54, 59, 61, 64, 65, 84,
90, 104, 105, 128, 129, 137,
141, 154
〈copy〉 ............................. 41
\copy . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 41
〈count〉 ............................ 41
\count . . . . . . . . . . . . . . . . . . . . . . . . . 19, 41
〈countdef 〉 ......................... 42
\countdef. . . . . . . . . . . . . . . . . . . . . .19, 42
〈cr〉 ............................... 42
\cr . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 42
〈crcr〉 ............................. 42
\crcr . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 42
〈csname〉 .......................... 43
\csname . . . . . . . . . . . . . . . . . . . . . . . . 19, 43
CTAN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
〈currentgrouplevel〉 ................ 43
\currentgrouplevel . . . . . . . . . . . 17, 43
\currentgrouptype . . . . . . . . . . . . 17, 43
\currentifbranch. . . . . . . . . . . . . . 17, 44
\currentiflevel. . . . . . . . . . . . . . . 17, 44
\currentiftype . . . . . . . . . . . . . . . . 17, 44
CVS . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
D
\day . . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 44
\deadcycles . . . . . . . . . . . . . . . . . . . 19, 44
-debug.............................22
〈def 〉 .............................. 44
\def . . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 44
\defaulthyphenchar . . . . . . . . . . . 19, 45
\DefaultInputMode . . . . . . . . . . . . 18, 45
\DefaultInputTranslation . . . . 18, 45
\DefaultOutputMode . . . . . . . . . . . 18, 45
\DefaultOutputTranslation . . . 18, 45
\defaultskewchar. . . . . . . . . . . . . . 19, 45
〈delcode〉. . . . . . . . . . . . . . . . . . . . . . . 46, 47
\delcode. . . . . . . . . . . . . . . . . . . . . . . 19, 46
〈delimiter〉.........................47
\delimiter . . . . . . . . . . . . . . . . . . . . 19, 47
\delimiterfactor. . . . . . . . . . . . . . 19, 47
\delimitershortfall . . . . . . . . . . 19, 47
\detokenize . . . . . . . . . . . . . . . . . . . 17, 47
〈dimen〉 . . . . . . . . 28, 32, 47, 49, 52, 64,
71, 72, 75, 86, 92, 102, 128,
151, 153
\dimen . . . . . . . . . . . . . . . . . . . . . . . . . 19, 48
〈dimen variable〉 . . . . . . . . . . 32, 51, 103
〈dimendef 〉 ........................ 48
\dimendef. . . . . . . . . . . . . . . . . . . . . .19, 48
〈dimenexpr〉 ....................... 49
\dimenexpr . . . . . . . . . . . . . . . . . . . . 17, 49
〈discretionary〉 .................... 50
\discretionary . . . . . . . . . . . . . . . . 19, 50
\displayindent . . . . . . . . . . . . . . . . 19, 50
〈displaylimits〉 ..................... 50
\displaylimits . . . . . . . . . . . . . . . . 19, 50
〈displaystyle〉 ...................... 51
\displaystyle . . . . . . . . . . . . . . . . . 19, 51
\displaywidowpenalties. . . . . . . 17, 51
\displaywidowpenalty . . . . . . . . . 19, 51
\displaywidth . . . . . . . . . . . . . . . . . 19, 51
〈dividable〉 ......................... 51
〈divide〉............................51
\divide . . . . . . . . . . . . . . . . . . . . . . . . 19, 52
\doublehyphendemerits . . . . . . . . 19, 52
〈dp〉 ............................... 52
\dp . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 53
〈dump〉 ............................ 53
163
Index
\dump . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 53
E
〈edef 〉 ............................. 54
\edef . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 54
\efcode . . . . . . . . . . . . . . . . . . . . . . . . 18, 54
〈else〉 .............................. 54
\else . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 54
\emergencystretch . . . . . . . . . . . . 19, 54
〈end〉 .............................. 55
\end. . . . . . . . . . . . . . . . . . . . . . . .19, 20, 55
〈endcsname〉.......................55
\endcsname . . . . . . . . . . . . . . . . . . . . 19, 55
〈endgroup〉 ........................ 55
\endgroup. . . . . . . . . . . . . . . . . . . . . .19, 56
〈endinput〉.........................56
\endinput. . . . . . . . . . . . . . . . . . . . . .19, 56
\endL . . . . . . . . . . . . . . . . . . . . . . . . . . 17, 56
\endlinechar . . . . . . . . . . . . . . . . . . 19, 56
\endR . . . . . . . . . . . . . . . . . . . . . . . . . . 17, 56
〈eqno〉 ............................. 57
\eqno . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 57
〈equals〉 . 28, 34, 38, 39, 41, 42, 46, 48,
52, 61, 64, 72, 73, 90, 104,
112, 136, 137, 141, 153
\errhelp. . . . . . . . . . . . . . . . . . . . . . . 19, 57
\errmessage . . . . . . . . . . . . . . . . . . . 19, 57
\errorcontextlines . . . . . . . . . . . 19, 57
errorstopmode . . . . . . . . . . . . . . . . . 13, 23
〈errorstopmode〉 ................... 58
\errorstopmode . . . . . . . . . . . . . . . . 19, 58
\escapechar . . . . . . . . . . . . . . . . . . . 19, 58
\eTeXrevision . . . . . . . . . . . . . . . . . 17, 58
\eTeXversion . . . . . . . . . . . . . . . . . . 17, 58
\everycr. . . . . . . . . . . . . . . . . . . . . . . 19, 58
\everydisplay . . . . . . . . . . . . . . . . . 19, 58
\everyeof. . . . . . . . . . . . . . . . . . . . . .17, 58
\everyhbox . . . . . . . . . . . . . . . . . . . . 19, 58
\everyjob. . . . . . . . . . . . . . . . . . . . . .19, 59
\everymath . . . . . . . . . . . . . . . . . . . . 19, 59
\everypar. . . . . . . . . . . . . . . . . . . . . .19, 59
\everyvbox . . . . . . . . . . . . . . . . . . . . 19, 59
\exhyphenpenalty. . . . . . . . . . . . . . 19, 59
〈expandafter〉 ...................... 59
\expandafter . . . . . . . . . . . . . . . . . . 19, 59
Explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
〈export〉 ........................... 60
\export . . . . . . . . . . . . . . . . . . . . . . . . 18, 60
〈expr〉 . . . . . . . . . . . . . . . . . . . . . . . . 49, 110
extex . . . . . . . . . . . . . . . . . . . . 911, 16, 21
extex-jx . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
extex-native . . . . . . . . . . . . . . . . . . . . . . . 17
ExTeX-setup.jar . . . . . . . . . . . . . . . . . . 811
extex.bat . . . . . . . . . . . . . . . . . . . . . . . . 911
extex.code . . . . . . . . . . . . . . . . . . . . 12, 21
extex.color.converter............12
extex.config . . . . . . . . . . . . . . . . . . 12, 21
extex.encoding ................... 12
extex.error.handler .............. 12
extex.file . . . . . . . . . . . . . . . . . . . . 13, 21
extex.fmt. . . . . . . . . . . . . . . . . . . . . .13, 22
extex.fonts ....................... 12
extex.halt.on.error . . . . . . . . . . 13, 22
extex.ini. . . . . . . . . . . . . . . . . . . . . .13, 22
extex.interaction . . . . . . . . . . . . 13, 23
extex.jobname . . . . . . . . . . . . . . . . . 14, 23
extex.jobname.master.............14
extex.lang . . . . . . . . . . . . . . . . . . . . 14, 23
extex.nobanner ................... 14
extex.output . . . . . . . . . . . . . . . . . . 14, 23
extex.outputdir . . . . . . . . . . . 14, 15, 24
extex.outputdir.fallback . . . . 15, 24
extex.progname . . . . . . . . . . . . . . . . 15, 23
extex.stacktrace.on.internal.error
extex.texinputs . . . . . . . 11, 12, 15, 24
extex.trace.font.files. . . . . . . 15, 22
extex.trace.input.files. . . . . . 15, 22
extex.trace.macros . . . . . . . . . . . 16, 22
extex.trace.tokenizer . . . . . . . . 16, 22
extex.typesetter ................. 16
F
〈false text〉 . . . . . . . . . . . . . . . . . 73, 7580
\fam . . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 60
〈fi〉 ................................ 60
\fi . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 60
〈file name〉 . . . . . . . . . . . . . . . . 28, 81, 112
\finalhyphendemerits . . . . . . . . . 19, 60
\firstmark . . . . . . . . . . . . . . . . . . . . 19, 61
\firstmarks . . . . . . . . . . . . . . . . . . . 17, 61
\floatingpenalty. . . . . . . . . . . . . . 19, 61
-fmt ............................... 22
〈font〉 . . . . . . . . . . 28, 61, 62, 64, 73, 136
\font . . . . . . . . . . . . . . . . . . . . . . 18, 19, 62
〈font name〉 ....................... 61
〈fontchardp〉 ....................... 62
\fontchardp . . . . . . . . . . . . . . . . . . . 17, 62
\fontcharht . . . . . . . . . . . . . . . . . . . 17, 63
\fontcharic . . . . . . . . . . . . . . . . . . . 17, 63
\fontcharwd . . . . . . . . . . . . . . . . . . . 17, 63
\fontdimen . . . . . . . . . . . . . . . . . . . . 19, 64
\fontname. . . . . . . . . . . . . . . . . . . . . .19, 64
〈futurelet〉 ......................... 64
\futurelet . . . . . . . . . . . . . . . . . . . . 19, 64
G
〈gdef 〉 ............................. 65
\gdef . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 65
〈general text〉 . . . . . . . . . . . . . . . . . 29, 138
〈global〉. . . . . . . . . . . . . . . . . . . . . 38, 46, 65
\global . . . . . . . . . . . . . . . . . . . . . . . . 19, 66
\globaldefs . . . . . . . . . . . . . . . . . . . 19, 66
〈Glue〉 . . . . . . . . . . . . . . . . . . . . . . . . 72, 152
〈glue〉 . . . . . . . . . . . . . . . . . . . . . . 32, 66, 67
〈glue variable〉 . . . . . . . . . . . . 32, 51, 103
\glueexpr. . . . . . . . . . . . . . . . . . . . . .17, 66
〈glueshrink〉 ....................... 66
\glueshrink . . . . . . . . . . . . . . . . . . . 17, 66
〈glueshrinkorder〉 .................. 67
\glueshrinkorder. . . . . . . . . . . . . . 17, 67
〈gluestretch〉 ....................... 67
\gluestretch . . . . . . . . . . . . . . . . . . 17, 67
〈gluestretchorder〉..................67
\gluestretchorder . . . . . . . . . . . . 17, 67
H
〈halign〉 ........................... 68
\halign . . . . . . . . . . . . . . . . . . . . . . . . 19, 68
-halt-on-error ................... 22
\hangafter . . . . . . . . . . . . . . . . . . . . 19, 68
\hangindent . . . . . . . . . . . . . . . . . . . 19, 68
\hbadness. . . . . . . . . . . . . . . . . . . . . .19, 68
〈hbox〉 ............................. 69
\hbox . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 69
-help..............................22
〈hfi〉 ............................... 69
\hfi . . . . . . . . . . . . . . . . . . . . . . . . . . . 18, 69
〈hfil〉 .............................. 69
\hfil . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 70
〈hfill〉..............................70
\hfill . . . . . . . . . . . . . . . . . . . . . . . . . 19, 70
〈hfilneg〉 ........................... 70
\hfilneg. . . . . . . . . . . . . . . . . . . . . . . 19, 70
\hfuzz . . . . . . . . . . . . . . . . . . . . . . . . . 19, 70
\hoffset. . . . . . . . . . . . . . . . . . . . . . . 19, 70
\holdinginserts. . . . . . . . . . . . . . . 19, 71
〈horizontal material〉 .............. 69
〈hrule〉 ............................ 71
\hrule . . . . . . . . . . . . . . . . . . . . . . . . . 19, 71
\hsize . . . . . . . . . . . . . . . . . . . . . . . . . 19, 71
〈hskip〉 ............................ 72
\hskip . . . . . . . . . . . . . . . . . . . . . . . . . 19, 72
〈hss〉 .............................. 72
\hss . . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 72
〈ht〉 ............................... 72
\ht . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 72
〈hyphenation〉 ..................... 73
\hyphenation . . . . . . . . . . . . . . . . . . 19, 73
\hyphenchar . . . . . . . . . . . . . . . . . . . 19, 73
\hyphenpenalty . . . . . . . . . . . . . . . . 19, 73
I
〈if 〉................................73
\if . . . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 74
〈ifcase〉 ............................ 74
\ifcase . . . . . . . . . . . . . . . . . . . . . . . . 19, 74
〈ifcat〉 ............................. 74
\ifcat . . . . . . . . . . . . . . . . . . . . . . . . . 19, 74
\ifcsname. . . . . . . . . . . . . . . . . . . . . .17, 74
\ifdefined . . . . . . . . . . . . . . . . . . . . 17, 74
〈ifdim〉 ............................ 75
\ifdim . . . . . . . . . . . . . . . . . . . . . . . . . 19, 75
〈ifeof 〉 ............................. 75
\ifeof . . . . . . . . . . . . . . . . . . . . . . . . . 19, 75
〈iffalse〉............................75
\iffalse. . . . . . . . . . . . . . . . . . . . . . . 19, 75
〈iffontchar〉........................76
\iffontchar . . . . . . . . . . . . . . . . . . . 17, 76
〈ifhbox〉............................76
\ifhbox . . . . . . . . . . . . . . . . . . . . . . . . 19, 76
〈ifhmode〉..........................76
\ifhmode. . . . . . . . . . . . . . . . . . . . . . . 19, 76
〈ifinner〉 ........................... 77
\ifinner. . . . . . . . . . . . . . . . . . . . . . . 19, 77
〈ifmmode〉 ......................... 77
\ifmmode. . . . . . . . . . . . . . . . . . . . . . . 19, 77
〈ifnum〉............................77
\ifnum . . . . . . . . . . . . . . . . . . . . . . . . . 19, 78
〈ifodd〉.............................78
\ifodd . . . . . . . . . . . . . . . . . . . . . . . . . 19, 78
〈iftrue〉 ............................ 78
\iftrue . . . . . . . . . . . . . . . . . . . . . . . . 19, 78
164
Index
〈ifvbox〉............................78
\ifvbox . . . . . . . . . . . . . . . . . . . . . . . . 19, 79
〈ifvmode〉 .......................... 79
\ifvmode. . . . . . . . . . . . . . . . . . . . . . . 19, 79
〈ifvoid〉 ............................ 79
\ifvoid . . . . . . . . . . . . . . . . . . . . . . . . 19, 79
〈ifx〉 ............................... 80
\ifx . . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 80
〈ignorespaces〉 ..................... 80
\ignorespaces . . . . . . . . . . . . . . . . . 19, 80
〈immediate〉 ....................... 80
\immediate . . . . . . . . . . . . . . . . . . . . 19, 80
〈import〉 ........................... 81
\import . . . . . . . . . . . . . . . . . . . . . . . . 18, 81
〈indent〉 ........................... 81
\indent . . . . . . . . . . . . . . . . . . . . . . . . 19, 81
-ini ............................... 22
initTEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
〈input〉 ............................ 81
\input . . . . . . . . . . . . . . . . . . . . . . . . . 19, 82
〈inputlineno〉 ...................... 82
\inputlineno . . . . . . . . . . . . . . . . . . 19, 82
\InputMode . . . . . . . . . . . . . . . . . . . . 18, 82
\InputTranslation . . . . . . . . . . . . 18, 82
〈insert〉............................83
\insert . . . . . . . . . . . . . . . . . . . . . . . . 19, 83
\insertpenalties. . . . . . . . . . . . . . 19, 83
installation script . . . . . . . . . . . . . . . . . . 10
installer . . . . . . . . . . . . . . . . . . . . . . . . . 810
building . . . . . . . . . . . . . . . . . . . . . . 10
language . . . . . . . . . . . . . . . . . . . . . . 9
〈integer variable〉. . . . . . . . . . 32, 51, 103
-interaction......................23
〈interactionmode〉 ................. 83
\interactionmode. . . . . . . . . . . . . . 17, 83
\interlinepenalties . . . . . . . . . . 17, 83
\interlinepenalty . . . . . . . . . . . . 19, 84
〈internal quantity〉. . . . . . . . . . . . . . . .141
〈italic correction〉 .................. 30
J
Java . . . . . . . . . . . . . . . . . . . . . . . . . . 7, 9, 24
\javadef. . . . . . . . . . . . . . . . . . . . . . . 18, 85
\javaload. . . . . . . . . . . . . . . . . . . . . .18, 86
-job-name ......................... 23
〈jobname〉 ......................... 86
\jobname. . . . . . . . . . . . . . . . . . . . . . . 19, 86
K
〈kern〉 ............................. 86
\kern . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 87
〈key〉 .............................. 47
L
language . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
installer . . . . . . . . . . . . . . . . . . . . . . . 9
-language ......................... 23
\language. . . . . . . . . . . . . . . . . . . . . .19, 87
〈lastbox〉...........................87
\lastbox. . . . . . . . . . . . . . . . . . . . . . . 19, 87
\lastkern. . . . . . . . . . . . . . . . . . . . . .19, 87
\lastlinefit . . . . . . . . . . . . . . . . . . 17, 87
\lastnodetype . . . . . . . . . . . . . . . . . 17, 88
\lastpenalty . . . . . . . . . . . . . . . . . . 19, 88
\lastskip. . . . . . . . . . . . . . . . . . . . . .19, 88
〈lccode〉............................88
\lccode . . . . . . . . . . . . . . . . . . . . . . . . 19, 88
\leaders. . . . . . . . . . . . . . . . . . . . . . . 19, 89
〈left〉 .............................. 89
\left . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 89
〈lefthyphenmin〉 ................... 89
\lefthyphenmin . . . . . . . . . . . . . . . . 19, 90
\leftskip. . . . . . . . . . . . . . . . . . . . . .19, 90
\leqno . . . . . . . . . . . . . . . . . . . . . . . . . 19, 90
〈let〉 ............................... 90
\let . . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 90
〈limits〉 ............................ 91
\limits . . . . . . . . . . . . . . . . . . . . . . . . 19, 91
\linepenalty . . . . . . . . . . . . . . . . . . 19, 91
\lineskip. . . . . . . . . . . . . . . . . . . . . .19, 91
\lineskiplimit . . . . . . . . . . . . . . . . 19, 91
\localbrokenpenalty . . . . . . . . . . 18, 91
\localinterlinepenalty. . . . . . . 18, 91
\localleftbox . . . . . . . . . . . . . . . . . 18, 91
\localrightbox . . . . . . . . . . . . . . . . 18, 92
log file . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
〈long〉 ............................. 92
\long . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 92
\looseness . . . . . . . . . . . . . . . . . . . . 19, 92
〈lower〉 ............................ 92
\lower . . . . . . . . . . . . . . . . . . . . . . . . . 19, 92
〈lowercase〉 ........................ 93
\lowercase . . . . . . . . . . . . . . . . . . . . 19, 93
ls-R ................................. 7
M
〈mag〉 ............................. 93
\mag . . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 93
Mailing list . . . . . . . . . . . . . . . . . . . . . . . . . 5
\mark . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 93
\marks . . . . . . . . . . . . . . . . . . . . . . . . . 17, 94
〈math block〉 .......................97
〈mathaccent〉 ...................... 94
\mathaccent . . . . . . . . . . . . . . . . . . . 19, 94
〈mathbin〉 ......................... 94
\mathbin. . . . . . . . . . . . . . . . . . . . . . . 19, 95
\mathchar. . . . . . . . . . . . . . . . . . . . . .19, 95
\mathchardef . . . . . . . . . . . . . . . . . . 19, 95
〈mathchoice〉 ...................... 96
\mathchoice . . . . . . . . . . . . . . . . . . . 19, 96
〈mathclose〉........................96
\mathclose . . . . . . . . . . . . . . . . . . . . 19, 96
\mathcode. . . . . . . . . . . . . . . . . . . . . .19, 97
\mathdir. . . . . . . . . . . . . . . . . . . . . . . 18, 97
〈mathinner〉 ....................... 97
\mathinner . . . . . . . . . . . . . . . . . . . . 19, 97
〈mathop〉 .......................... 98
\mathop . . . . . . . . . . . . . . . . . . . . . . . . 19, 98
〈mathopen〉 ........................ 98
\mathopen. . . . . . . . . . . . . . . . . . . . . .19, 98
〈mathord〉 ......................... 98
\mathord. . . . . . . . . . . . . . . . . . . . . . . 19, 99
〈mathpunct〉 ....................... 99
\mathpunct . . . . . . . . . . . . . . . . . . . . 19, 99
〈mathrel〉 .......................... 99
\mathrel. . . . . . . . . . . . . . . . . . . . . . . 19, 99
\mathsurround . . . . . . . . . . . . . . . . 19, 100
\maxdeadcycles. . . . . . . . . . . . . . . 19, 100
\maxdepth . . . . . . . . . . . . . . . . . . . . 19, 100
〈meaning〉 . . . . . . . . . . . . . . . . . . . . . . . . 100
\meaning. . . . . . . . . . . . . . . . . . . . . .19, 100
\medmuskip . . . . . . . . . . . . . . . . . . . 19, 100
〈message〉 . . . . . . . . . . . . . . . . . . . . . . . . 100
\message. . . . . . . . . . . . . . . . . . . . . .19, 101
\middle. . . . . . . . . . . . . . . . . . . . . . . 17, 101
〈mkern〉 . . . . . . . . . . . . . . . . . . . . . . . . . . 101
\mkern . . . . . . . . . . . . . . . . . . . . . . . . 19, 101
〈modifier〉 . . . . . . . . . . . . . . . . . . . 112, 113
\month . . . . . . . . . . . . . . . . . . . . . . . . 19, 102
〈moveleft〉 . . . . . . . . . . . . . . . . . . . . . . . . 102
\moveleft . . . . . . . . . . . . . . . . . . . . 19, 102
〈moveright〉 . . . . . . . . . . . . . . . . . . . . . . 102
\moveright . . . . . . . . . . . . . . . . . . . 19, 102
〈mskip〉. . . . . . . . . . . . . . . . . . . . . . . . . . . 103
\mskip . . . . . . . . . . . . . . . . . . . . . . . . 19, 103
\muexpr. . . . . . . . . . . . . . . . . . . . . . . 17, 103
〈muglue〉 .......................... 32
〈muglue variable〉 . . . . . . . . . 32, 51, 103
〈multiply〉 . . . . . . . . . . . . . . . . . . . . . . . . 103
\multiply . . . . . . . . . . . . . . . . . . . . 19, 104
〈multiplyable〉 . . . . . . . . . . . . . . . . . . . . 103
\muskip. . . . . . . . . . . . . . . . . . . . . . . 19, 104
\muskipdef . . . . . . . . . . . . . . . . . . . 19, 104
N
〈name〉 . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
〈namespace〉. . . . . . . . . . . . . . . . . . . . . . 104
\namespace . . . . . . . . . . . . . . . . . . . 18, 104
〈nativedef 〉 . . . . . . . . . . . . . . . . . . . . . . . 105
\nativedef . . . . . . . . . . . . . . . . . . . 18, 105
〈nativeload〉 . . . . . . . . . . . . . . . . . . . . . . 105
\nativeload . . . . . . . . . . . . . . . . . . 18, 105
\naturaldir . . . . . . . . . . . . . . . . . . 18, 105
〈newline〉 .......................... 30
\newlinechar . . . . . . . . . . . . . . . . . 19, 105
nextex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
〈noalign〉 . . . . . . . . . . . . . . . . . . . . . . . . . 106
\noalign. . . . . . . . . . . . . . . . . . . . . .19, 106
〈noboundary〉. . . . . . . . . . . . . . . . . . . . . 106
\noboundary . . . . . . . . . . . . . . . . . . 19, 106
\noDefaultInputMode . . . . . . . . . 18, 106
\noDefaultInputTranslation . 18, 106
\noDefaultOutputMode . . . . . . . . 18, 106
\noDefaultOutputTranslation 18, 107
〈noexpand〉 . . . . . . . . . . . . . . . . . . . . . . . 107
\noexpand . . . . . . . . . . . . . . . . . . . . 19, 107
〈noindent〉. . . . . . . . . . . . . . . . . . . . . . . . 107
\noindent . . . . . . . . . . . . . . . . . . . . 19, 107
〈nolimits〉 . . . . . . . . . . . . . . . . . . . . . . . . 107
\nolimits . . . . . . . . . . . . . . . . . . . . 19, 108
〈nonscript〉 . . . . . . . . . . . . . . . . . . . . . . . 108
\nonscript . . . . . . . . . . . . . . . . . . . 19, 108
nonstopmode . . . . . . . . . . . . . . . . . . . 13, 23
〈nonstopmode〉 . . . . . . . . . . . . . . . . . . . 108
\nonstopmode . . . . . . . . . . . . . . . . . 19, 108
\nulldelimiterspace . . . . . . . . . 19, 108
\nullfont . . . . . . . . . . . . . . . . . . . . 19, 109
\nullocplist . . . . . . . . . . . . . . . . . 18, 109
〈number〉 27, 29, 32, 34, 3941, 49, 62,
7579, 109, 110, 131, 133
165
Index
\number. . . . . . . . . . . . . . . . . . . . . . . 19, 109
〈numexpr〉. . . . . . . . . . . . . . . . . . . . . . . . 110
\numexpr. . . . . . . . . . . . . . . . . . . . . .17, 110
O
\ocp . . . . . . . . . . . . . . . . . . . . . . . . . . 18, 110
\ocplist. . . . . . . . . . . . . . . . . . . . . .18, 111
\odelmiter . . . . . . . . . . . . . . . . . . . 18, 111
\omathaccent . . . . . . . . . . . . . . . . . 18, 111
\omathchar . . . . . . . . . . . . . . . . . . . 18, 111
\omathchardef . . . . . . . . . . . . . . . . 18, 111
\omathcode . . . . . . . . . . . . . . . . . . . 18, 111
\omathdelcode . . . . . . . . . . . . . . . . 18, 111
omega . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
〈omit〉. . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
\omit . . . . . . . . . . . . . . . . . . . . . . . . . 19, 112
〈op〉 . . . . . . . . . . . . . . . . . . . . . . . . . . . 75, 77
〈openin〉. . . . . . . . . . . . . . . . . . . . . . . . . . 112
\openin. . . . . . . . . . . . . . . . . . . . . . . 19, 112
\openout. . . . . . . . . . . . . . . . . . . . . .19, 113
〈operand〉 . . . . . . . . . . . . . . . . . . . . . 49, 110
〈option〉 ........................... 61
〈optional by 〉. . . . . . . . . . . . . . 32, 51, 103
〈optional prefix〉 . . . . . . . . . . . . . . . 32, 52
〈optional spaces〉 . . 28, 32, 51, 71, 103,
〈options〉 .......................... 61
〈or〉 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
\or . . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 113
\oradical . . . . . . . . . . . . . . . . . . . . 18, 113
〈outer〉 . . . . . . . . . . . . . . . . . . . . . . . . . . . 113
\outer . . . . . . . . . . . . . . . . . . . . . . . . 19, 113
-output ........................... 23
\output. . . . . . . . . . . . . . . . . . . . . . . 19, 113
\OutputMode . . . . . . . . . . . . . . . . . . 18, 114
\outputpenalty. . . . . . . . . . . . . . . 19, 114
\OutputTranslation . . . . . . . . . . 18, 114
〈over〉 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 114
\over . . . . . . . . . . . . . . . . . . . . . . . . . 19, 114
\overfullrule . . . . . . . . . . . . . . . . 19, 114
\overline . . . . . . . . . . . . . . . . . . . . 19, 115
〈overwithdelims〉. . . . . . . . . . . . . . . . . . 115
\overwithdelims. . . . . . . . . . . . . . 19, 115
P
\pagedepth . . . . . . . . . . . . . . . . . . . 19, 115
\pagedir. . . . . . . . . . . . . . . . . . . . . .18, 115
\pagedirHL . . . . . . . . . . . . . . . . . . . 18, 115
\pagedirHR . . . . . . . . . . . . . . . . . . . 18, 115
\pagediscarts . . . . . . . . . . . . . . . . 17, 116
\pagefilllstretch . . . . . . . . . . . 19, 116
\pagefillstretch . . . . . . . . . . . . 19, 116
\pagefilstretch. . . . . . . . . . . . . . 19, 116
\pagegoal . . . . . . . . . . . . . . . . . . . . 19, 116
\pageshrink . . . . . . . . . . . . . . . . . . 19, 116
\pagestretch . . . . . . . . . . . . . . . . . 19, 116
\pagetotal . . . . . . . . . . . . . . . . . . . 19, 116
〈par〉 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 117
\par . . . . . . . . . . . . . . . . . . . . . . . . . . 19, 117
〈parameter text〉 . . . . . . . 44, 54, 65, 154
\parfillskip . . . . . . . . . . . . . . . . . 19, 117
\parindent . . . . . . . . . . . . . . . . . . . 19, 117
〈parshape〉. . . . . . . . . . . . . . . . . . . . . . . . 117
\parshape . . . . . . . . . . . . . . . . . . . . 19, 118
〈parshapedimen〉. . . . . . . . . . . . . . . . . . 118
\parshapedimen. . . . . . . . . . . . . . . 17, 118
〈parshapeindent〉 . . . . . . . . . . . . . . . . . 119
\parshapeindent. . . . . . . . . . . . . . 17, 119
〈parshapelength〉 . . . . . . . . . . . . . . . . . . 119
\parshapelength. . . . . . . . . . . . . . 17, 119
\parskip. . . . . . . . . . . . . . . . . . . . . .19, 119
path . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9, 10
〈patterns〉 . . . . . . . . . . . . . . . . . . . . . . . . 120
\patterns . . . . . . . . . . . . . . . . . . . . 19, 120
\pausing. . . . . . . . . . . . . . . . . . . . . .19, 120
\pdfadjustspacing . . . . . . . . . . . 18, 120
\pdfannot . . . . . . . . . . . . . . . . . . . . 18, 120
\pdfannotlink . . . . . . . . . . . . . . . . 18, 120
\pdfannottext . . . . . . . . . . . . . . . . 18, 120
\pdfcatalog . . . . . . . . . . . . . . . . . . 18, 120
\pdfcompresslevel . . . . . . . . . . . 18, 120
\pdfdecimaldigits . . . . . . . . . . . 18, 121
\pdfdest. . . . . . . . . . . . . . . . . . . . . .18, 121
\pdfendlink . . . . . . . . . . . . . . . . . . 18, 121
\pdfendthread . . . . . . . . . . . . . . . . 18, 121
\pdffontname . . . . . . . . . . . . . . . . . 18, 121
\pdffontobjnum. . . . . . . . . . . . . . . 18, 121
\pdfhorigin . . . . . . . . . . . . . . . . . . 18, 121
\pdfimage . . . . . . . . . . . . . . . . . . . . 18, 121
\pdfimageresolution . . . . . . . . . 18, 121
\pdfincludechars . . . . . . . . . . . . 18, 122
\pdfinfo. . . . . . . . . . . . . . . . . . . . . .18, 122
\pdflastannot . . . . . . . . . . . . . . . . 18, 122
\pdflastobj . . . . . . . . . . . . . . . . . . 18, 122
\pdflastxform . . . . . . . . . . . . . . . . 18, 122
\pdflastximage. . . . . . . . . . . . . . . 18, 122
\pdflinkmargin. . . . . . . . . . . . . . . 18, 122
\pdfliteral . . . . . . . . . . . . . . . . . . 18, 122
\pdfmovechars . . . . . . . . . . . . . . . . 19, 122
\pdfnames . . . . . . . . . . . . . . . . . . . . 19, 123
\pdfobj. . . . . . . . . . . . . . . . . . . . . . . 19, 123
\pdfoutline . . . . . . . . . . . . . . . . . . 19, 123
\pdfoutput . . . . . . . . . . . . . . . . . . . 19, 123
\pdfpageattr . . . . . . . . . . . . . . . . . 19, 123
\pdfpageheight. . . . . . . . . . . . . . . 19, 123
\pdfpagesattr . . . . . . . . . . . . . . . . 19, 123
\pdfpagewidth . . . . . . . . . . . . . . . . 19, 123
\pdfpkresolution . . . . . . . . . . . . 19, 123
\pdfrefobj . . . . . . . . . . . . . . . . . . . 19, 124
\pdfrefxform . . . . . . . . . . . . . . . . . 19, 124
\pdfrefximage . . . . . . . . . . . . . . . . 19, 124
\pdfstartlink . . . . . . . . . . . . . . . . 19, 124
pdfTEX . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
pdftex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
\pdftexrevision. . . . . . . . . . . . . . 19, 124
\pdftexversion. . . . . . . . . . . . . . . 19, 124
\pdfthread . . . . . . . . . . . . . . . . . . . 19, 124
\pdfthreadhoffset . . . . . . . . . . . 19, 124
\pdfthreadmargin . . . . . . . . . . . . 19, 124
\pdfthreadvoffset . . . . . . . . . . . 19, 125
\pdfvorigin . . . . . . . . . . . . . . . . . . 19, 125
\pdfxform . . . . . . . . . . . . . . . . . . . . 19, 125
\pdfximage . . . . . . . . . . . . . . . . . . . 19, 125
〈penalty〉 . . . . . . . . . . . . . . . . . . . . . . . . . 125
\penalty. . . . . . . . . . . . . . . . . . . . . .19, 125
\popocplist . . . . . . . . . . . . . . . . . . 18, 125
\postdisplaypenalty . . . . . . . . . 19, 126
〈preamble〉.........................68
\predisplaydirection . . . . . . . . 18, 126
\predisplaypenalty . . . . . . . . . . 19, 126
\predisplaysize. . . . . . . . . . . . . . 19, 126
〈prefix〉 . . . . . 38, 44, 46, 47, 54, 65, 154
\pretolerance . . . . . . . . . . . . . . . . 19, 126
〈prevdepth〉 . . . . . . . . . . . . . . . . . . . . . . . 126
\prevdepth . . . . . . . . . . . . . . . . . . . 19, 126
〈prevgraf 〉 . . . . . . . . . . . . . . . . . . . . . . . . 127
\prevgraf . . . . . . . . . . . . . . . . . . . . 19, 127
-progname ......................... 23
〈protected〉 . . . . . . . . . . . . . . . . . . . . . . . 127
\protected . . . . . . . . . . . . . . . . . . . 18, 127
\pushocplist . . . . . . . . . . . . . . . . . 18, 127
R
〈radical〉. . . . . . . . . . . . . . . . . . . . . . . . . . 127
\radical. . . . . . . . . . . . . . . . . . . . . .19, 128
〈raise〉. . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
\raise . . . . . . . . . . . . . . . . . . . . . . . . 20, 128
〈read〉 . . . . . . . . . . . . . . . . . . . . . . . 128, 129
\read . . . . . . . . . . . . . . . . . . . . . . . . . 20, 128
〈readline〉 . . . . . . . . . . . . . . . . . . . . . . . . 129
\readline . . . . . . . . . . . . . . . . . . . . 18, 129
〈relax〉. . . . . . . . . . . . . . . . . . . . . . . . . . . .129
\relax . . . . . . . . . . . . . . . . . . . . . . . . 20, 129
\relax.............................12
\relpenalty . . . . . . . . . . . . . . . . . . 20, 129
\removebeforeocplist . . . . . . . . 18, 130
〈replacement text〉 . . 29, 44, 54, 60, 65,
repository . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
\right . . . . . . . . . . . . . . . . . . . . . . . . 20, 130
〈righthyphenmin〉 . . . . . . . . . . . . . . . . . 130
\righthyphenmin. . . . . . . . . . . . . . 20, 130
\rightskip . . . . . . . . . . . . . . . . . . . 20, 130
〈romannumeral〉 . . . . . . . . . . . . . . . . . . 131
\romannumeral . . . . . . . . . . . . . . . . 20, 131
〈row〉 .............................. 68
〈rows〉 ............................. 68
〈rule dimension〉 . 68, 69, 71, 148, 151,
〈rule specification〉 . . . . . . . . . . . . 71, 151
S
\savinghyphcodes . . . . . . . . . . . . 18, 131
\savingvdiscarts . . . . . . . . . . . . 18, 131
\scantokens . . . . . . . . . . . . . . . . . . 18, 131
\scriptfont . . . . . . . . . . . . . . . . . . 20, 131
\scriptscriptfont . . . . . . . . . . . 20, 131
〈scriptscriptstyle〉. . . . . . . . . . . . . . . . . 132
\scriptscriptstyle . . . . . . . . . . 20, 132
\scriptspace . . . . . . . . . . . . . . . . . 20, 132
〈scriptstyle〉 . . . . . . . . . . . . . . . . . . . . . . 132
\scriptstyle . . . . . . . . . . . . . . . . . 20, 132
scrollmode . . . . . . . . . . . . . . . . . . . . . 13, 23
〈scrollmode〉 . . . . . . . . . . . . . . . . . . . . . . 133
\scrollmode . . . . . . . . . . . . . . . . . . 20, 133
search . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 25
〈setbox〉 . . . . . . . . . . . . . . . . . . . . . . . . . . 133
\setbox. . . . . . . . . . . . . . . . . . . . . . . 20, 133
〈setlanguage〉 . . . . . . . . . . . . . . . . . . . . . 133
\setlanguage . . . . . . . . . . . . . . . . . 20, 133
〈sfcode〉 . . . . . . . . . . . . . . . . . . . . . . . . . . 134
\sfcode. . . . . . . . . . . . . . . . . . . . . . . 20, 134
〈shipout〉 . . . . . . . . . . . . . . . . . . . . . . . . . 134
\shipout. . . . . . . . . . . . . . . . . . . . . .20, 134
〈show〉 . . . . . . . . . . . . . . . . . . . . . . . . . . . 134
166
Index
\show . . . . . . . . . . . . . . . . . . . . . . . . . 20, 135
〈showbox〉 . . . . . . . . . . . . . . . . . . . . . . . . 135
\showbox. . . . . . . . . . . . . . . . . . . . . .20, 135
\showboxbreadth. . . . . . . . . . . . . . 20, 135
\showboxdepth . . . . . . . . . . . . . . . . 20, 135
\showgroups . . . . . . . . . . . . . . . . . . 18, 135
〈showlists〉 . . . . . . . . . . . . . . . . . . . . . . . 136
\showlists . . . . . . . . . . . . . . . . . . . 20, 136
\showthe. . . . . . . . . . . . . . . . . . . . . .20, 136
\showtokens . . . . . . . . . . . . . . . . . . 18, 136
〈size...〉 ............................ 62
\skewchar . . . . . . . . . . . . . . . . . . . . 20, 136
\skip . . . . . . . . . . . . . . . . . . . . . . . . . 20, 136
\skipdef. . . . . . . . . . . . . . . . . . . . . .20, 137
〈space primitive〉 .................. 29
〈spacefactor〉 . . . . . . . . . . . . . . . . . . . . . 137
\spacefactor . . . . . . . . . . . . . . . . . 20, 137
\spaceskip . . . . . . . . . . . . . . . . . . . 20, 137
〈span〉 . . . . . 90, 101, 115, 130, 137, 144
\span . . . . . . . . . . . . . . . . . . . . . . . . . 20, 137
〈special〉 . . . . . . . . . . . . . . . . . . . . . . . . . . 138
\special. . . . . . . . . . . . . . . . . . . . . .20, 138
\splitbotmark . . . . . . . . . . . . . . . . 20, 138
\splitbotmarks. . . . . . . . . . . . . . . 18, 138
\splitdiscarts. . . . . . . . . . . . . . . 18, 138
\splitfirstmark. . . . . . . . . . . . . . 20, 139
\splitfirstmarks . . . . . . . . . . . . 18, 139
\splitmaxdepth. . . . . . . . . . . . . . . 20, 139
\splittopskip . . . . . . . . . . . . . . . . 20, 139
〈string〉. . . . . . . . . . . . . . . . . . . . . . . . . . . 139
\string. . . . . . . . . . . . . . . . . . . . . . . 20, 139
T
\tabskip. . . . . . . . . . . . . . . . . . . . . .20, 140
TEX . . . . . . . . . . . . . . . . . . . . . . . . . 5, 22, 25
tex . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
-texinputs ........................ 24
TEXLive . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
texmf . . . . . . . . . . . . . . . . . . . . . . . . . . . 7, 11
-texmfoutputs.....................24
-texoutputs ....................... 24
\textdir. . . . . . . . . . . . . . . . . . . . . .18, 140
\textfont . . . . . . . . . . . . . . . . . . . . 20, 140
〈textstyle〉 . . . . . . . . . . . . . . . . . . . . . . . . 140
\textstyle . . . . . . . . . . . . . . . . . . . 20, 140
\TeXXeTstate . . . . . . . . . . . . . . . . . 18, 140
〈the〉 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 141
\the . . . . . . . . . . . . . . . . . . . . . . . . . . 20, 141
\thickmuskip . . . . . . . . . . . . . . . . . 20, 141
\thinmuskip . . . . . . . . . . . . . . . . . . 20, 141
\time . . . . . . . . . . . . . . . . . . . . . . . . . 20, 141
〈token〉...29, 33, 64, 90, 100, 134, 139
〈token1〉. . . . . . . . . . . . . . . . . . . . . . . .73, 80
〈token2〉. . . . . . . . . . . . . . . . . . . . . . . .73, 80
〈tokens〉 . . . . . . . . . . . 27, 57, 84, 85, 105
\toks . . . . . . . . . . . . . . . . . . . . . . . . . 20, 141
\toksdef. . . . . . . . . . . . . . . . . . . . . .20, 141
\tolerance . . . . . . . . . . . . . . . . . . . 20, 141
\topmark. . . . . . . . . . . . . . . . . . . . . .20, 141
\topmarks . . . . . . . . . . . . . . . . . . . . 18, 142
\topskip. . . . . . . . . . . . . . . . . . . . . .20, 142
\tracingassigns. . . . . . . . . . . . . . 18, 142
\tracingcommands. . . . . . . . . 18, 20, 142
\tracinggroups. . . . . . . . . . . . . . . 18, 142
\tracingifs . . . . . . . . . . . . . . . . . . 18, 142
\tracinglostchars . . . . . . . . . . . 20, 142
\tracingmacros. . . . . . . . . . . . . . . 20, 142
\tracingnesting. . . . . . . . . . . . . . 18, 142
\tracingonline. . . . . . . . . . . . . . . 20, 143
\tracingoutput. . . . . . . . . . . . . . . 20, 143
\tracingpages . . . . . . . . . . . . . . . . 20, 143
\tracingparagraphs . . . . . . . . . . 20, 143
\tracingrestores . . . . . . . . . . . . 20, 143
\tracingscantokens . . . . . . . . . . 18, 143
\tracingstats . . . . . . . . . . . . . . . . 20, 143
〈true text〉 . . . . . . . . . . . . . . . . . . 73, 7580
〈type〉 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
U
〈uccode〉 . . . . . . . . . . . . . . . . . . . . . . . . . . 143
\uccode. . . . . . . . . . . . . . . . . . . . . . . 20, 144
\uchyph. . . . . . . . . . . . . . . . . . . . . . . 20, 144
\underline . . . . . . . . . . . . . . . . . . . 20, 144
\unexpanded . . . . . . . . . . . . . . . . . . 18, 144
〈unhbox〉 . . . . . . . . . . . . . . . . . . . . . . . . . 144
\unhbox. . . . . . . . . . . . . . . . . . . . . . . 20, 144
〈unhcopy〉 . . . . . . . . . . . . . . . . . . . . . . . . 145
\unhcopy. . . . . . . . . . . . . . . . . . . . . .20, 145
Unix . . . . . . . . . . . . . . . . . . . . . . . . . . . 15, 24
〈unkern〉 . . . . . . . . . . . . . . . . . . . . . . . . . 145
\unkern. . . . . . . . . . . . . . . . . . . . . . . 20, 145
\unless. . . . . . . . . . . . . . . . . . . . . . . 18, 145
\unnaturaldir . . . . . . . . . . . . . . . . 18, 146
〈unpenalty〉. . . . . . . . . . . . . . . . . . . . . . . 146
\unpenalty . . . . . . . . . . . . . . . . . . . 20, 146
〈unskip〉 . . . . . . . . . . . . . . . . . . . . . . . . . . 146
\unskip. . . . . . . . . . . . . . . . . . . . . . . 20, 146
〈unvbox〉 . . . . . . . . . . . . . . . . . . . . . . . . . 146
\unvbox. . . . . . . . . . . . . . . . . . . . . . . 20, 146
〈unvcopy〉 . . . . . . . . . . . . . . . . . . . . . . . . 147
\unvcopy. . . . . . . . . . . . . . . . . . . . . .20, 147
〈uppercase〉 . . . . . . . . . . . . . . . . . . . . . . . 147
\uppercase . . . . . . . . . . . . . . . . . . . 20, 147
V
〈vadjust〉 . . . . . . . . . . . . . . . . . . . . . . . . . 147
\vadjust. . . . . . . . . . . . . . . . . . . . . .20, 147
〈valign〉 . . . . . . . . . . . . . . . . . . . . . . . . . . 148
\valign. . . . . . . . . . . . . . . . . . . . . . . 20, 148
\vbadness . . . . . . . . . . . . . . . . . . . . 20, 148
〈vbox〉 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 148
\vbox . . . . . . . . . . . . . . . . . . . . . . . . . 20, 149
〈vcenter〉 . . . . . . . . . . . . . . . . . . . . . . . . . 149
\vcenter. . . . . . . . . . . . . . . . . . . . . .20, 149
version . . . . . . . . . . . . . . . . . . . . . . . . . . . . 24
-version .......................... 24
〈vertical material〉 . . . . . . . . . . . 148, 153
〈vfi〉 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 149
\vfi . . . . . . . . . . . . . . . . . . . . . . . . . . 18, 149
〈vfil〉 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
\vfil . . . . . . . . . . . . . . . . . . . . . . . . . 20, 150
〈vfill〉. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 150
\vfill . . . . . . . . . . . . . . . . . . . . . . . . 20, 150
〈vfilneg〉 . . . . . . . . . . . . . . . . . . . . . . . . . . 150
\vfilneg. . . . . . . . . . . . . . . . . . . . . .20, 150
\vfuzz . . . . . . . . . . . . . . . . . . . . . . . . 20, 151
\voffset. . . . . . . . . . . . . . . . . . . . . .20, 151
〈vrule〉 . . . . . . . . . . . . . . . . . . . . . . . . . . . 151
\vrule . . . . . . . . . . . . . . . . . . . . . . . . 20, 151
\vsize . . . . . . . . . . . . . . . . . . . . . . . . 20, 151
〈vskip〉 . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
\vskip . . . . . . . . . . . . . . . . . . . . . . . . 20, 152
〈vsplit〉 . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
\vsplit. . . . . . . . . . . . . . . . . . . . . . . 20, 152
〈vss〉 . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 152
\vss . . . . . . . . . . . . . . . . . . . . . . . . . . 20, 152
〈vtop〉 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
\vtop . . . . . . . . . . . . . . . . . . . . . . . . . 20, 153
W
〈wd〉. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 153
\wd . . . . . . . . . . . . . . . . . . . . . . . . . . . 20, 153
Web Site . . . . . . . . . . . . . . . . . . . . . . . . . . . . 5
\widowpenalties. . . . . . . . . . . . . . 18, 153
\widowpenalty . . . . . . . . . . . . . . . . 20, 154
Windows . . . . . . . . . . . . . . . . . . . . 9, 15, 24
\write . . . . . . . . . . . . . . . . . . . . . . . . 20, 154
WWW..............................5
X
〈xdef 〉 . . . . . . . . . . . . . . . . . . . . . . . . . . . . 154
\xdef . . . . . . . . . . . . . . . . . . . . . . . . . 20, 154
〈xleaders〉 . . . . . . . . . . . . . . . . . . . . . . . . 155
\xleaders . . . . . . . . . . . . . . . . . . . . 20, 155
\xspaceskip . . . . . . . . . . . . . . . . . . 20, 155
Y
\year . . . . . . . . . . . . . . . . . . . . . . . . . 20, 155
167