config

Personal configuration.
git clone git://code.dwrz.net/config
Log | Files | Refs

texinfo.tex (325847B)


      1 % texinfo.tex -- TeX macros to handle Texinfo files.
      2 %
      3 % Load plain if necessary, i.e., if running under initex.
      4 \expandafter\ifx\csname fmtname\endcsname\relax\input plain\fi
      5 %
      6 \def\texinfoversion{2013-09-11.11}
      7 %
      8 % Copyright 1985, 1986, 1988, 1990, 1991, 1992, 1993, 1994, 1995,
      9 % 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006,
     10 % 2007, 2008, 2009, 2010, 2011, 2012, 2013 Free Software Foundation, Inc.
     11 %
     12 % This texinfo.tex file is free software: you can redistribute it and/or
     13 % modify it under the terms of the GNU General Public License as
     14 % published by the Free Software Foundation, either version 3 of the
     15 % License, or (at your option) any later version.
     16 %
     17 % This texinfo.tex file is distributed in the hope that it will be
     18 % useful, but WITHOUT ANY WARRANTY; without even the implied warranty
     19 % of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
     20 % General Public License for more details.
     21 %
     22 % You should have received a copy of the GNU General Public License
     23 % along with this program.  If not, see <https://www.gnu.org/licenses/>.
     24 %
     25 % As a special exception, when this file is read by TeX when processing
     26 % a Texinfo source document, you may use the result without
     27 % restriction. This Exception is an additional permission under section 7
     28 % of the GNU General Public License, version 3 ("GPLv3").
     29 %
     30 % Please try the latest version of texinfo.tex before submitting bug
     31 % reports; you can get the latest version from:
     32 %   https://ftp.gnu.org/gnu/texinfo/ (the Texinfo release area), or
     33 %   https://ftpmirror.gnu.org/texinfo/ (same, via a mirror), or
     34 %   https://www.gnu.org/software/texinfo/ (the Texinfo home page)
     35 % The texinfo.tex in any given distribution could well be out
     36 % of date, so if that's what you're using, please check.
     37 %
     38 % Send bug reports to bug-texinfo@gnu.org.  Please include including a
     39 % complete document in each bug report with which we can reproduce the
     40 % problem.  Patches are, of course, greatly appreciated.
     41 %
     42 % To process a Texinfo manual with TeX, it's most reliable to use the
     43 % texi2dvi shell script that comes with the distribution.  For a simple
     44 % manual foo.texi, however, you can get away with this:
     45 %   tex foo.texi
     46 %   texindex foo.??
     47 %   tex foo.texi
     48 %   tex foo.texi
     49 %   dvips foo.dvi -o  # or whatever; this makes foo.ps.
     50 % The extra TeX runs get the cross-reference information correct.
     51 % Sometimes one run after texindex suffices, and sometimes you need more
     52 % than two; texi2dvi does it as many times as necessary.
     53 %
     54 % It is possible to adapt texinfo.tex for other languages, to some
     55 % extent.  You can get the existing language-specific files from the
     56 % full Texinfo distribution.
     57 %
     58 % The GNU Texinfo home page is https://www.gnu.org/software/texinfo.
     59 
     60 
     61 \message{Loading texinfo [version \texinfoversion]:}
     62 
     63 % If in a .fmt file, print the version number
     64 % and turn on active characters that we couldn't do earlier because
     65 % they might have appeared in the input file name.
     66 \everyjob{\message{[Texinfo version \texinfoversion]}%
     67   \catcode`+=\active \catcode`\_=\active}
     68 
     69 \chardef\other=12
     70 
     71 % We never want plain's \outer definition of \+ in Texinfo.
     72 % For @tex, we can use \tabalign.
     73 \let\+ = \relax
     74 
     75 % Save some plain tex macros whose names we will redefine.
     76 \let\ptexb=\b
     77 \let\ptexbullet=\bullet
     78 \let\ptexc=\c
     79 \let\ptexcomma=\,
     80 \let\ptexdot=\.
     81 \let\ptexdots=\dots
     82 \let\ptexend=\end
     83 \let\ptexequiv=\equiv
     84 \let\ptexexclam=\!
     85 \let\ptexfootnote=\footnote
     86 \let\ptexgtr=>
     87 \let\ptexhat=^
     88 \let\ptexi=\i
     89 \let\ptexindent=\indent
     90 \let\ptexinsert=\insert
     91 \let\ptexlbrace=\{
     92 \let\ptexless=<
     93 \let\ptexnewwrite\newwrite
     94 \let\ptexnoindent=\noindent
     95 \let\ptexplus=+
     96 \let\ptexraggedright=\raggedright
     97 \let\ptexrbrace=\}
     98 \let\ptexslash=\/
     99 \let\ptexstar=\*
    100 \let\ptext=\t
    101 \let\ptextop=\top
    102 {\catcode`\'=\active \global\let\ptexquoteright'}% active in plain's math mode
    103 
    104 % If this character appears in an error message or help string, it
    105 % starts a new line in the output.
    106 \newlinechar = `^^J
    107 
    108 % Use TeX 3.0's \inputlineno to get the line number, for better error
    109 % messages, but if we're using an old version of TeX, don't do anything.
    110 %
    111 \ifx\inputlineno\thisisundefined
    112   \let\linenumber = \empty % Pre-3.0.
    113 \else
    114   \def\linenumber{l.\the\inputlineno:\space}
    115 \fi
    116 
    117 % Set up fixed words for English if not already set.
    118 \ifx\putwordAppendix\undefined  \gdef\putwordAppendix{Appendix}\fi
    119 \ifx\putwordChapter\undefined   \gdef\putwordChapter{Chapter}\fi
    120 \ifx\putworderror\undefined     \gdef\putworderror{error}\fi
    121 \ifx\putwordfile\undefined      \gdef\putwordfile{file}\fi
    122 \ifx\putwordin\undefined        \gdef\putwordin{in}\fi
    123 \ifx\putwordIndexIsEmpty\undefined       \gdef\putwordIndexIsEmpty{(Index is empty)}\fi
    124 \ifx\putwordIndexNonexistent\undefined   \gdef\putwordIndexNonexistent{(Index is nonexistent)}\fi
    125 \ifx\putwordInfo\undefined      \gdef\putwordInfo{Info}\fi
    126 \ifx\putwordInstanceVariableof\undefined \gdef\putwordInstanceVariableof{Instance Variable of}\fi
    127 \ifx\putwordMethodon\undefined  \gdef\putwordMethodon{Method on}\fi
    128 \ifx\putwordNoTitle\undefined   \gdef\putwordNoTitle{No Title}\fi
    129 \ifx\putwordof\undefined        \gdef\putwordof{of}\fi
    130 \ifx\putwordon\undefined        \gdef\putwordon{on}\fi
    131 \ifx\putwordpage\undefined      \gdef\putwordpage{page}\fi
    132 \ifx\putwordsection\undefined   \gdef\putwordsection{section}\fi
    133 \ifx\putwordSection\undefined   \gdef\putwordSection{Section}\fi
    134 \ifx\putwordsee\undefined       \gdef\putwordsee{see}\fi
    135 \ifx\putwordSee\undefined       \gdef\putwordSee{See}\fi
    136 \ifx\putwordShortTOC\undefined  \gdef\putwordShortTOC{Short Contents}\fi
    137 \ifx\putwordTOC\undefined       \gdef\putwordTOC{Table of Contents}\fi
    138 %
    139 \ifx\putwordMJan\undefined \gdef\putwordMJan{January}\fi
    140 \ifx\putwordMFeb\undefined \gdef\putwordMFeb{February}\fi
    141 \ifx\putwordMMar\undefined \gdef\putwordMMar{March}\fi
    142 \ifx\putwordMApr\undefined \gdef\putwordMApr{April}\fi
    143 \ifx\putwordMMay\undefined \gdef\putwordMMay{May}\fi
    144 \ifx\putwordMJun\undefined \gdef\putwordMJun{June}\fi
    145 \ifx\putwordMJul\undefined \gdef\putwordMJul{July}\fi
    146 \ifx\putwordMAug\undefined \gdef\putwordMAug{August}\fi
    147 \ifx\putwordMSep\undefined \gdef\putwordMSep{September}\fi
    148 \ifx\putwordMOct\undefined \gdef\putwordMOct{October}\fi
    149 \ifx\putwordMNov\undefined \gdef\putwordMNov{November}\fi
    150 \ifx\putwordMDec\undefined \gdef\putwordMDec{December}\fi
    151 %
    152 \ifx\putwordDefmac\undefined    \gdef\putwordDefmac{Macro}\fi
    153 \ifx\putwordDefspec\undefined   \gdef\putwordDefspec{Special Form}\fi
    154 \ifx\putwordDefvar\undefined    \gdef\putwordDefvar{Variable}\fi
    155 \ifx\putwordDefopt\undefined    \gdef\putwordDefopt{User Option}\fi
    156 \ifx\putwordDeffunc\undefined   \gdef\putwordDeffunc{Function}\fi
    157 
    158 % Since the category of space is not known, we have to be careful.
    159 \chardef\spacecat = 10
    160 \def\spaceisspace{\catcode`\ =\spacecat}
    161 
    162 % sometimes characters are active, so we need control sequences.
    163 \chardef\ampChar   = `\&
    164 \chardef\colonChar = `\:
    165 \chardef\commaChar = `\,
    166 \chardef\dashChar  = `\-
    167 \chardef\dotChar   = `\.
    168 \chardef\exclamChar= `\!
    169 \chardef\hashChar  = `\#
    170 \chardef\lquoteChar= `\`
    171 \chardef\questChar = `\?
    172 \chardef\rquoteChar= `\'
    173 \chardef\semiChar  = `\;
    174 \chardef\slashChar = `\/
    175 \chardef\underChar = `\_
    176 
    177 % Ignore a token.
    178 %
    179 \def\gobble#1{}
    180 
    181 % The following is used inside several \edef's.
    182 \def\makecsname#1{\expandafter\noexpand\csname#1\endcsname}
    183 
    184 % Hyphenation fixes.
    185 \hyphenation{
    186   Flor-i-da Ghost-script Ghost-view Mac-OS Post-Script
    187   ap-pen-dix bit-map bit-maps
    188   data-base data-bases eshell fall-ing half-way long-est man-u-script
    189   man-u-scripts mini-buf-fer mini-buf-fers over-view par-a-digm
    190   par-a-digms rath-er rec-tan-gu-lar ro-bot-ics se-vere-ly set-up spa-ces
    191   spell-ing spell-ings
    192   stand-alone strong-est time-stamp time-stamps which-ever white-space
    193   wide-spread wrap-around
    194 }
    195 
    196 % Margin to add to right of even pages, to left of odd pages.
    197 \newdimen\bindingoffset
    198 \newdimen\normaloffset
    199 \newdimen\pagewidth \newdimen\pageheight
    200 
    201 % For a final copy, take out the rectangles
    202 % that mark overfull boxes (in case you have decided
    203 % that the text looks ok even though it passes the margin).
    204 %
    205 \def\finalout{\overfullrule=0pt }
    206 
    207 % Sometimes it is convenient to have everything in the transcript file
    208 % and nothing on the terminal.  We don't just call \tracingall here,
    209 % since that produces some useless output on the terminal.  We also make
    210 % some effort to order the tracing commands to reduce output in the log
    211 % file; cf. trace.sty in LaTeX.
    212 %
    213 \def\gloggingall{\begingroup \globaldefs = 1 \loggingall \endgroup}%
    214 \def\loggingall{%
    215   \tracingstats2
    216   \tracingpages1
    217   \tracinglostchars2  % 2 gives us more in etex
    218   \tracingparagraphs1
    219   \tracingoutput1
    220   \tracingmacros2
    221   \tracingrestores1
    222   \showboxbreadth\maxdimen \showboxdepth\maxdimen
    223   \ifx\eTeXversion\thisisundefined\else % etex gives us more logging
    224     \tracingscantokens1
    225     \tracingifs1
    226     \tracinggroups1
    227     \tracingnesting2
    228     \tracingassigns1
    229   \fi
    230   \tracingcommands3  % 3 gives us more in etex
    231   \errorcontextlines16
    232 }%
    233 
    234 % @errormsg{MSG}.  Do the index-like expansions on MSG, but if things
    235 % aren't perfect, it's not the end of the world, being an error message,
    236 % after all.
    237 %
    238 \def\errormsg{\begingroup \indexnofonts \doerrormsg}
    239 \def\doerrormsg#1{\errmessage{#1}}
    240 
    241 % add check for \lastpenalty to plain's definitions.  If the last thing
    242 % we did was a \nobreak, we don't want to insert more space.
    243 %
    244 \def\smallbreak{\ifnum\lastpenalty<10000\par\ifdim\lastskip<\smallskipamount
    245   \removelastskip\penalty-50\smallskip\fi\fi}
    246 \def\medbreak{\ifnum\lastpenalty<10000\par\ifdim\lastskip<\medskipamount
    247   \removelastskip\penalty-100\medskip\fi\fi}
    248 \def\bigbreak{\ifnum\lastpenalty<10000\par\ifdim\lastskip<\bigskipamount
    249   \removelastskip\penalty-200\bigskip\fi\fi}
    250 
    251 % Do @cropmarks to get crop marks.
    252 %
    253 \newif\ifcropmarks
    254 \let\cropmarks = \cropmarkstrue
    255 %
    256 % Dimensions to add cropmarks at corners.
    257 % Added by P. A. MacKay, 12 Nov. 1986
    258 %
    259 \newdimen\outerhsize \newdimen\outervsize % set by the paper size routines
    260 \newdimen\cornerlong  \cornerlong=1pc
    261 \newdimen\cornerthick \cornerthick=.3pt
    262 \newdimen\topandbottommargin \topandbottommargin=.75in
    263 
    264 % Output a mark which sets \thischapter, \thissection and \thiscolor.
    265 % We dump everything together because we only have one kind of mark.
    266 % This works because we only use \botmark / \topmark, not \firstmark.
    267 %
    268 % A mark contains a subexpression of the \ifcase ... \fi construct.
    269 % \get*marks macros below extract the needed part using \ifcase.
    270 %
    271 % Another complication is to let the user choose whether \thischapter
    272 % (\thissection) refers to the chapter (section) in effect at the top
    273 % of a page, or that at the bottom of a page.  The solution is
    274 % described on page 260 of The TeXbook.  It involves outputting two
    275 % marks for the sectioning macros, one before the section break, and
    276 % one after.  I won't pretend I can describe this better than DEK...
    277 \def\domark{%
    278   \toks0=\expandafter{\lastchapterdefs}%
    279   \toks2=\expandafter{\lastsectiondefs}%
    280   \toks4=\expandafter{\prevchapterdefs}%
    281   \toks6=\expandafter{\prevsectiondefs}%
    282   \toks8=\expandafter{\lastcolordefs}%
    283   \mark{%
    284                    \the\toks0 \the\toks2  % 0: top marks (\last...)
    285       \noexpand\or \the\toks4 \the\toks6  % 1: bottom marks (default, \prev...)
    286     \noexpand\else \the\toks8             % 2: color marks
    287   }%
    288 }
    289 % \topmark doesn't work for the very first chapter (after the title
    290 % page or the contents), so we use \firstmark there -- this gets us
    291 % the mark with the chapter defs, unless the user sneaks in, e.g.,
    292 % @setcolor (or @url, or @link, etc.) between @contents and the very
    293 % first @chapter.
    294 \def\gettopheadingmarks{%
    295   \ifcase0\topmark\fi
    296   \ifx\thischapter\empty \ifcase0\firstmark\fi \fi
    297 }
    298 \def\getbottomheadingmarks{\ifcase1\botmark\fi}
    299 \def\getcolormarks{\ifcase2\topmark\fi}
    300 
    301 % Avoid "undefined control sequence" errors.
    302 \def\lastchapterdefs{}
    303 \def\lastsectiondefs{}
    304 \def\prevchapterdefs{}
    305 \def\prevsectiondefs{}
    306 \def\lastcolordefs{}
    307 
    308 % Main output routine.
    309 \chardef\PAGE = 255
    310 \output = {\onepageout{\pagecontents\PAGE}}
    311 
    312 \newbox\headlinebox
    313 \newbox\footlinebox
    314 
    315 % \onepageout takes a vbox as an argument.  Note that \pagecontents
    316 % does insertions, but you have to call it yourself.
    317 \def\onepageout#1{%
    318   \ifcropmarks \hoffset=0pt \else \hoffset=\normaloffset \fi
    319   %
    320   \ifodd\pageno  \advance\hoffset by \bindingoffset
    321   \else \advance\hoffset by -\bindingoffset\fi
    322   %
    323   % Do this outside of the \shipout so @code etc. will be expanded in
    324   % the headline as they should be, not taken literally (outputting ''code).
    325   \def\commmonheadfootline{\let\hsize=\pagewidth \texinfochars}
    326   %
    327   \ifodd\pageno \getoddheadingmarks \else \getevenheadingmarks \fi
    328   \global\setbox\headlinebox = \vbox{\commmonheadfootline \makeheadline}%
    329   %
    330   \ifodd\pageno \getoddfootingmarks \else \getevenfootingmarks \fi
    331   \global\setbox\footlinebox = \vbox{\commmonheadfootline \makefootline}%
    332   %
    333   {%
    334     % Have to do this stuff outside the \shipout because we want it to
    335     % take effect in \write's, yet the group defined by the \vbox ends
    336     % before the \shipout runs.
    337     %
    338     \indexdummies         % don't expand commands in the output.
    339     \normalturnoffactive  % \ in index entries must not stay \, e.g., if
    340                % the page break happens to be in the middle of an example.
    341                % We don't want .vr (or whatever) entries like this:
    342                % \entry{{\tt \indexbackslash }acronym}{32}{\code {\acronym}}
    343                % "\acronym" won't work when it's read back in;
    344                % it needs to be
    345                % {\code {{\tt \backslashcurfont }acronym}
    346     \shipout\vbox{%
    347       % Do this early so pdf references go to the beginning of the page.
    348       \ifpdfmakepagedest \pdfdest name{\the\pageno} xyz\fi
    349       %
    350       \ifcropmarks \vbox to \outervsize\bgroup
    351         \hsize = \outerhsize
    352         \vskip-\topandbottommargin
    353         \vtop to0pt{%
    354           \line{\ewtop\hfil\ewtop}%
    355           \nointerlineskip
    356           \line{%
    357             \vbox{\moveleft\cornerthick\nstop}%
    358             \hfill
    359             \vbox{\moveright\cornerthick\nstop}%
    360           }%
    361           \vss}%
    362         \vskip\topandbottommargin
    363         \line\bgroup
    364           \hfil % center the page within the outer (page) hsize.
    365           \ifodd\pageno\hskip\bindingoffset\fi
    366           \vbox\bgroup
    367       \fi
    368       %
    369       \unvbox\headlinebox
    370       \pagebody{#1}%
    371       \ifdim\ht\footlinebox > 0pt
    372         % Only leave this space if the footline is nonempty.
    373         % (We lessened \vsize for it in \oddfootingyyy.)
    374         % The \baselineskip=24pt in plain's \makefootline has no effect.
    375         \vskip 24pt
    376         \unvbox\footlinebox
    377       \fi
    378       %
    379       \ifcropmarks
    380           \egroup % end of \vbox\bgroup
    381         \hfil\egroup % end of (centering) \line\bgroup
    382         \vskip\topandbottommargin plus1fill minus1fill
    383         \boxmaxdepth = \cornerthick
    384         \vbox to0pt{\vss
    385           \line{%
    386             \vbox{\moveleft\cornerthick\nsbot}%
    387             \hfill
    388             \vbox{\moveright\cornerthick\nsbot}%
    389           }%
    390           \nointerlineskip
    391           \line{\ewbot\hfil\ewbot}%
    392         }%
    393       \egroup % \vbox from first cropmarks clause
    394       \fi
    395     }% end of \shipout\vbox
    396   }% end of group with \indexdummies
    397   \advancepageno
    398   \ifnum\outputpenalty>-20000 \else\dosupereject\fi
    399 }
    400 
    401 \newinsert\margin \dimen\margin=\maxdimen
    402 
    403 \def\pagebody#1{\vbox to\pageheight{\boxmaxdepth=\maxdepth #1}}
    404 {\catcode`\@ =11
    405 \gdef\pagecontents#1{\ifvoid\topins\else\unvbox\topins\fi
    406 % marginal hacks, juha@viisa.uucp (Juha Takala)
    407 \ifvoid\margin\else % marginal info is present
    408   \rlap{\kern\hsize\vbox to\z@{\kern1pt\box\margin \vss}}\fi
    409 \dimen@=\dp#1\relax \unvbox#1\relax
    410 \ifvoid\footins\else\vskip\skip\footins\footnoterule \unvbox\footins\fi
    411 \ifr@ggedbottom \kern-\dimen@ \vfil \fi}
    412 }
    413 
    414 % Here are the rules for the cropmarks.  Note that they are
    415 % offset so that the space between them is truly \outerhsize or \outervsize
    416 % (P. A. MacKay, 12 November, 1986)
    417 %
    418 \def\ewtop{\vrule height\cornerthick depth0pt width\cornerlong}
    419 \def\nstop{\vbox
    420   {\hrule height\cornerthick depth\cornerlong width\cornerthick}}
    421 \def\ewbot{\vrule height0pt depth\cornerthick width\cornerlong}
    422 \def\nsbot{\vbox
    423   {\hrule height\cornerlong depth\cornerthick width\cornerthick}}
    424 
    425 % Parse an argument, then pass it to #1.  The argument is the rest of
    426 % the input line (except we remove a trailing comment).  #1 should be a
    427 % macro which expects an ordinary undelimited TeX argument.
    428 %
    429 \def\parsearg{\parseargusing{}}
    430 \def\parseargusing#1#2{%
    431   \def\argtorun{#2}%
    432   \begingroup
    433     \obeylines
    434     \spaceisspace
    435     #1%
    436     \parseargline\empty% Insert the \empty token, see \finishparsearg below.
    437 }
    438 
    439 {\obeylines %
    440   \gdef\parseargline#1^^M{%
    441     \endgroup % End of the group started in \parsearg.
    442     \argremovecomment #1\comment\ArgTerm%
    443   }%
    444 }
    445 
    446 % First remove any @comment, then any @c comment.
    447 \def\argremovecomment#1\comment#2\ArgTerm{\argremovec #1\c\ArgTerm}
    448 \def\argremovec#1\c#2\ArgTerm{\argcheckspaces#1\^^M\ArgTerm}
    449 
    450 % Each occurrence of `\^^M' or `<space>\^^M' is replaced by a single space.
    451 %
    452 % \argremovec might leave us with trailing space, e.g.,
    453 %    @end itemize  @c foo
    454 % This space token undergoes the same procedure and is eventually removed
    455 % by \finishparsearg.
    456 %
    457 \def\argcheckspaces#1\^^M{\argcheckspacesX#1\^^M \^^M}
    458 \def\argcheckspacesX#1 \^^M{\argcheckspacesY#1\^^M}
    459 \def\argcheckspacesY#1\^^M#2\^^M#3\ArgTerm{%
    460   \def\temp{#3}%
    461   \ifx\temp\empty
    462     % Do not use \next, perhaps the caller of \parsearg uses it; reuse \temp:
    463     \let\temp\finishparsearg
    464   \else
    465     \let\temp\argcheckspaces
    466   \fi
    467   % Put the space token in:
    468   \temp#1 #3\ArgTerm
    469 }
    470 
    471 % If a _delimited_ argument is enclosed in braces, they get stripped; so
    472 % to get _exactly_ the rest of the line, we had to prevent such situation.
    473 % We prepended an \empty token at the very beginning and we expand it now,
    474 % just before passing the control to \argtorun.
    475 % (Similarly, we have to think about #3 of \argcheckspacesY above: it is
    476 % either the null string, or it ends with \^^M---thus there is no danger
    477 % that a pair of braces would be stripped.
    478 %
    479 % But first, we have to remove the trailing space token.
    480 %
    481 \def\finishparsearg#1 \ArgTerm{\expandafter\argtorun\expandafter{#1}}
    482 
    483 % \parseargdef\foo{...}
    484 %	is roughly equivalent to
    485 % \def\foo{\parsearg\Xfoo}
    486 % \def\Xfoo#1{...}
    487 %
    488 % Actually, I use \csname\string\foo\endcsname, ie. \\foo, as it is my
    489 % favourite TeX trick.  --kasal, 16nov03
    490 
    491 \def\parseargdef#1{%
    492   \expandafter \doparseargdef \csname\string#1\endcsname #1%
    493 }
    494 \def\doparseargdef#1#2{%
    495   \def#2{\parsearg#1}%
    496   \def#1##1%
    497 }
    498 
    499 % Several utility definitions with active space:
    500 {
    501   \obeyspaces
    502   \gdef\obeyedspace{ }
    503 
    504   % Make each space character in the input produce a normal interword
    505   % space in the output.  Don't allow a line break at this space, as this
    506   % is used only in environments like @example, where each line of input
    507   % should produce a line of output anyway.
    508   %
    509   \gdef\sepspaces{\obeyspaces\let =\tie}
    510 
    511   % If an index command is used in an @example environment, any spaces
    512   % therein should become regular spaces in the raw index file, not the
    513   % expansion of \tie (\leavevmode \penalty \@M \ ).
    514   \gdef\unsepspaces{\let =\space}
    515 }
    516 
    517 
    518 \def\flushcr{\ifx\par\lisppar \def\next##1{}\else \let\next=\relax \fi \next}
    519 
    520 % Define the framework for environments in texinfo.tex.  It's used like this:
    521 %
    522 %   \envdef\foo{...}
    523 %   \def\Efoo{...}
    524 %
    525 % It's the responsibility of \envdef to insert \begingroup before the
    526 % actual body; @end closes the group after calling \Efoo.  \envdef also
    527 % defines \thisenv, so the current environment is known; @end checks
    528 % whether the environment name matches.  The \checkenv macro can also be
    529 % used to check whether the current environment is the one expected.
    530 %
    531 % Non-false conditionals (@iftex, @ifset) don't fit into this, so they
    532 % are not treated as environments; they don't open a group.  (The
    533 % implementation of @end takes care not to call \endgroup in this
    534 % special case.)
    535 
    536 
    537 % At run-time, environments start with this:
    538 \def\startenvironment#1{\begingroup\def\thisenv{#1}}
    539 % initialize
    540 \let\thisenv\empty
    541 
    542 % ... but they get defined via ``\envdef\foo{...}'':
    543 \long\def\envdef#1#2{\def#1{\startenvironment#1#2}}
    544 \def\envparseargdef#1#2{\parseargdef#1{\startenvironment#1#2}}
    545 
    546 % Check whether we're in the right environment:
    547 \def\checkenv#1{%
    548   \def\temp{#1}%
    549   \ifx\thisenv\temp
    550   \else
    551     \badenverr
    552   \fi
    553 }
    554 
    555 % Environment mismatch, #1 expected:
    556 \def\badenverr{%
    557   \errhelp = \EMsimple
    558   \errmessage{This command can appear only \inenvironment\temp,
    559     not \inenvironment\thisenv}%
    560 }
    561 \def\inenvironment#1{%
    562   \ifx#1\empty
    563     outside of any environment%
    564   \else
    565     in environment \expandafter\string#1%
    566   \fi
    567 }
    568 
    569 % @end foo executes the definition of \Efoo.
    570 % But first, it executes a specialized version of \checkenv
    571 %
    572 \parseargdef\end{%
    573   \if 1\csname iscond.#1\endcsname
    574   \else
    575     % The general wording of \badenverr may not be ideal.
    576     \expandafter\checkenv\csname#1\endcsname
    577     \csname E#1\endcsname
    578     \endgroup
    579   \fi
    580 }
    581 
    582 \newhelp\EMsimple{Press RETURN to continue.}
    583 
    584 
    585 % Be sure we're in horizontal mode when doing a tie, since we make space
    586 % equivalent to this in @example-like environments. Otherwise, a space
    587 % at the beginning of a line will start with \penalty -- and
    588 % since \penalty is valid in vertical mode, we'd end up putting the
    589 % penalty on the vertical list instead of in the new paragraph.
    590 {\catcode`@ = 11
    591  % Avoid using \@M directly, because that causes trouble
    592  % if the definition is written into an index file.
    593  \global\let\tiepenalty = \@M
    594  \gdef\tie{\leavevmode\penalty\tiepenalty\ }
    595 }
    596 
    597 % @: forces normal size whitespace following.
    598 \def\:{\spacefactor=1000 }
    599 
    600 % @* forces a line break.
    601 \def\*{\unskip\hfil\break\hbox{}\ignorespaces}
    602 
    603 % @/ allows a line break.
    604 \let\/=\allowbreak
    605 
    606 % @. is an end-of-sentence period.
    607 \def\.{.\spacefactor=\endofsentencespacefactor\space}
    608 
    609 % @! is an end-of-sentence bang.
    610 \def\!{!\spacefactor=\endofsentencespacefactor\space}
    611 
    612 % @? is an end-of-sentence query.
    613 \def\?{?\spacefactor=\endofsentencespacefactor\space}
    614 
    615 % @frenchspacing on|off  says whether to put extra space after punctuation.
    616 %
    617 \def\onword{on}
    618 \def\offword{off}
    619 %
    620 \parseargdef\frenchspacing{%
    621   \def\temp{#1}%
    622   \ifx\temp\onword \plainfrenchspacing
    623   \else\ifx\temp\offword \plainnonfrenchspacing
    624   \else
    625     \errhelp = \EMsimple
    626     \errmessage{Unknown @frenchspacing option `\temp', must be on|off}%
    627   \fi\fi
    628 }
    629 
    630 % @w prevents a word break.  Without the \leavevmode, @w at the
    631 % beginning of a paragraph, when TeX is still in vertical mode, would
    632 % produce a whole line of output instead of starting the paragraph.
    633 \def\w#1{\leavevmode\hbox{#1}}
    634 
    635 % @group ... @end group forces ... to be all on one page, by enclosing
    636 % it in a TeX vbox.  We use \vtop instead of \vbox to construct the box
    637 % to keep its height that of a normal line.  According to the rules for
    638 % \topskip (p.114 of the TeXbook), the glue inserted is
    639 % max (\topskip - \ht (first item), 0).  If that height is large,
    640 % therefore, no glue is inserted, and the space between the headline and
    641 % the text is small, which looks bad.
    642 %
    643 % Another complication is that the group might be very large.  This can
    644 % cause the glue on the previous page to be unduly stretched, because it
    645 % does not have much material.  In this case, it's better to add an
    646 % explicit \vfill so that the extra space is at the bottom.  The
    647 % threshold for doing this is if the group is more than \vfilllimit
    648 % percent of a page (\vfilllimit can be changed inside of @tex).
    649 %
    650 \newbox\groupbox
    651 \def\vfilllimit{0.7}
    652 %
    653 \envdef\group{%
    654   \ifnum\catcode`\^^M=\active \else
    655     \errhelp = \groupinvalidhelp
    656     \errmessage{@group invalid in context where filling is enabled}%
    657   \fi
    658   \startsavinginserts
    659   %
    660   \setbox\groupbox = \vtop\bgroup
    661     % Do @comment since we are called inside an environment such as
    662     % @example, where each end-of-line in the input causes an
    663     % end-of-line in the output.  We don't want the end-of-line after
    664     % the `@group' to put extra space in the output.  Since @group
    665     % should appear on a line by itself (according to the Texinfo
    666     % manual), we don't worry about eating any user text.
    667     \comment
    668 }
    669 %
    670 % The \vtop produces a box with normal height and large depth; thus, TeX puts
    671 % \baselineskip glue before it, and (when the next line of text is done)
    672 % \lineskip glue after it.  Thus, space below is not quite equal to space
    673 % above.  But it's pretty close.
    674 \def\Egroup{%
    675     % To get correct interline space between the last line of the group
    676     % and the first line afterwards, we have to propagate \prevdepth.
    677     \endgraf % Not \par, as it may have been set to \lisppar.
    678     \global\dimen1 = \prevdepth
    679   \egroup           % End the \vtop.
    680   % \dimen0 is the vertical size of the group's box.
    681   \dimen0 = \ht\groupbox  \advance\dimen0 by \dp\groupbox
    682   % \dimen2 is how much space is left on the page (more or less).
    683   \dimen2 = \pageheight   \advance\dimen2 by -\pagetotal
    684   % if the group doesn't fit on the current page, and it's a big big
    685   % group, force a page break.
    686   \ifdim \dimen0 > \dimen2
    687     \ifdim \pagetotal < \vfilllimit\pageheight
    688       \page
    689     \fi
    690   \fi
    691   \box\groupbox
    692   \prevdepth = \dimen1
    693   \checkinserts
    694 }
    695 %
    696 % TeX puts in an \escapechar (i.e., `@') at the beginning of the help
    697 % message, so this ends up printing `@group can only ...'.
    698 %
    699 \newhelp\groupinvalidhelp{%
    700 group can only be used in environments such as @example,^^J%
    701 where each line of input produces a line of output.}
    702 
    703 % @need space-in-mils
    704 % forces a page break if there is not space-in-mils remaining.
    705 
    706 \newdimen\mil  \mil=0.001in
    707 
    708 \parseargdef\need{%
    709   % Ensure vertical mode, so we don't make a big box in the middle of a
    710   % paragraph.
    711   \par
    712   %
    713   % If the @need value is less than one line space, it's useless.
    714   \dimen0 = #1\mil
    715   \dimen2 = \ht\strutbox
    716   \advance\dimen2 by \dp\strutbox
    717   \ifdim\dimen0 > \dimen2
    718     %
    719     % Do a \strut just to make the height of this box be normal, so the
    720     % normal leading is inserted relative to the preceding line.
    721     % And a page break here is fine.
    722     \vtop to #1\mil{\strut\vfil}%
    723     %
    724     % TeX does not even consider page breaks if a penalty added to the
    725     % main vertical list is 10000 or more.  But in order to see if the
    726     % empty box we just added fits on the page, we must make it consider
    727     % page breaks.  On the other hand, we don't want to actually break the
    728     % page after the empty box.  So we use a penalty of 9999.
    729     %
    730     % There is an extremely small chance that TeX will actually break the
    731     % page at this \penalty, if there are no other feasible breakpoints in
    732     % sight.  (If the user is using lots of big @group commands, which
    733     % almost-but-not-quite fill up a page, TeX will have a hard time doing
    734     % good page breaking, for example.)  However, I could not construct an
    735     % example where a page broke at this \penalty; if it happens in a real
    736     % document, then we can reconsider our strategy.
    737     \penalty9999
    738     %
    739     % Back up by the size of the box, whether we did a page break or not.
    740     \kern -#1\mil
    741     %
    742     % Do not allow a page break right after this kern.
    743     \nobreak
    744   \fi
    745 }
    746 
    747 % @br   forces paragraph break (and is undocumented).
    748 
    749 \let\br = \par
    750 
    751 % @page forces the start of a new page.
    752 %
    753 \def\page{\par\vfill\supereject}
    754 
    755 % @exdent text....
    756 % outputs text on separate line in roman font, starting at standard page margin
    757 
    758 % This records the amount of indent in the innermost environment.
    759 % That's how much \exdent should take out.
    760 \newskip\exdentamount
    761 
    762 % This defn is used inside fill environments such as @defun.
    763 \parseargdef\exdent{\hfil\break\hbox{\kern -\exdentamount{\rm#1}}\hfil\break}
    764 
    765 % This defn is used inside nofill environments such as @example.
    766 \parseargdef\nofillexdent{{\advance \leftskip by -\exdentamount
    767   \leftline{\hskip\leftskip{\rm#1}}}}
    768 
    769 % @inmargin{WHICH}{TEXT} puts TEXT in the WHICH margin next to the current
    770 % paragraph.  For more general purposes, use the \margin insertion
    771 % class.  WHICH is `l' or `r'.  Not documented, written for gawk manual.
    772 %
    773 \newskip\inmarginspacing \inmarginspacing=1cm
    774 \def\strutdepth{\dp\strutbox}
    775 %
    776 \def\doinmargin#1#2{\strut\vadjust{%
    777   \nobreak
    778   \kern-\strutdepth
    779   \vtop to \strutdepth{%
    780     \baselineskip=\strutdepth
    781     \vss
    782     % if you have multiple lines of stuff to put here, you'll need to
    783     % make the vbox yourself of the appropriate size.
    784     \ifx#1l%
    785       \llap{\ignorespaces #2\hskip\inmarginspacing}%
    786     \else
    787       \rlap{\hskip\hsize \hskip\inmarginspacing \ignorespaces #2}%
    788     \fi
    789     \null
    790   }%
    791 }}
    792 \def\inleftmargin{\doinmargin l}
    793 \def\inrightmargin{\doinmargin r}
    794 %
    795 % @inmargin{TEXT [, RIGHT-TEXT]}
    796 % (if RIGHT-TEXT is given, use TEXT for left page, RIGHT-TEXT for right;
    797 % else use TEXT for both).
    798 %
    799 \def\inmargin#1{\parseinmargin #1,,\finish}
    800 \def\parseinmargin#1,#2,#3\finish{% not perfect, but better than nothing.
    801   \setbox0 = \hbox{\ignorespaces #2}%
    802   \ifdim\wd0 > 0pt
    803     \def\lefttext{#1}%  have both texts
    804     \def\righttext{#2}%
    805   \else
    806     \def\lefttext{#1}%  have only one text
    807     \def\righttext{#1}%
    808   \fi
    809   %
    810   \ifodd\pageno
    811     \def\temp{\inrightmargin\righttext}% odd page -> outside is right margin
    812   \else
    813     \def\temp{\inleftmargin\lefttext}%
    814   \fi
    815   \temp
    816 }
    817 
    818 % @| inserts a changebar to the left of the current line.  It should
    819 % surround any changed text.  This approach does *not* work if the
    820 % change spans more than two lines of output.  To handle that, we would
    821 % have adopt a much more difficult approach (putting marks into the main
    822 % vertical list for the beginning and end of each change).  This command
    823 % is not documented, not supported, and doesn't work.
    824 %
    825 \def\|{%
    826   % \vadjust can only be used in horizontal mode.
    827   \leavevmode
    828   %
    829   % Append this vertical mode material after the current line in the output.
    830   \vadjust{%
    831     % We want to insert a rule with the height and depth of the current
    832     % leading; that is exactly what \strutbox is supposed to record.
    833     \vskip-\baselineskip
    834     %
    835     % \vadjust-items are inserted at the left edge of the type.  So
    836     % the \llap here moves out into the left-hand margin.
    837     \llap{%
    838       %
    839       % For a thicker or thinner bar, change the `1pt'.
    840       \vrule height\baselineskip width1pt
    841       %
    842       % This is the space between the bar and the text.
    843       \hskip 12pt
    844     }%
    845   }%
    846 }
    847 
    848 % @include FILE -- \input text of FILE.
    849 %
    850 \def\include{\parseargusing\filenamecatcodes\includezzz}
    851 \def\includezzz#1{%
    852   \pushthisfilestack
    853   \def\thisfile{#1}%
    854   {%
    855     \makevalueexpandable  % we want to expand any @value in FILE.
    856     \turnoffactive        % and allow special characters in the expansion
    857     \indexnofonts         % Allow `@@' and other weird things in file names.
    858     \wlog{texinfo.tex: doing @include of #1^^J}%
    859     \edef\temp{\noexpand\input #1 }%
    860     %
    861     % This trickery is to read FILE outside of a group, in case it makes
    862     % definitions, etc.
    863     \expandafter
    864   }\temp
    865   \popthisfilestack
    866 }
    867 \def\filenamecatcodes{%
    868   \catcode`\\=\other
    869   \catcode`~=\other
    870   \catcode`^=\other
    871   \catcode`_=\other
    872   \catcode`|=\other
    873   \catcode`<=\other
    874   \catcode`>=\other
    875   \catcode`+=\other
    876   \catcode`-=\other
    877   \catcode`\`=\other
    878   \catcode`\'=\other
    879 }
    880 
    881 \def\pushthisfilestack{%
    882   \expandafter\pushthisfilestackX\popthisfilestack\StackTerm
    883 }
    884 \def\pushthisfilestackX{%
    885   \expandafter\pushthisfilestackY\thisfile\StackTerm
    886 }
    887 \def\pushthisfilestackY #1\StackTerm #2\StackTerm {%
    888   \gdef\popthisfilestack{\gdef\thisfile{#1}\gdef\popthisfilestack{#2}}%
    889 }
    890 
    891 \def\popthisfilestack{\errthisfilestackempty}
    892 \def\errthisfilestackempty{\errmessage{Internal error:
    893   the stack of filenames is empty.}}
    894 %
    895 \def\thisfile{}
    896 
    897 % @center line
    898 % outputs that line, centered.
    899 %
    900 \parseargdef\center{%
    901   \ifhmode
    902     \let\centersub\centerH
    903   \else
    904     \let\centersub\centerV
    905   \fi
    906   \centersub{\hfil \ignorespaces#1\unskip \hfil}%
    907   \let\centersub\relax % don't let the definition persist, just in case
    908 }
    909 \def\centerH#1{{%
    910   \hfil\break
    911   \advance\hsize by -\leftskip
    912   \advance\hsize by -\rightskip
    913   \line{#1}%
    914   \break
    915 }}
    916 %
    917 \newcount\centerpenalty
    918 \def\centerV#1{%
    919   % The idea here is the same as in \startdefun, \cartouche, etc.: if
    920   % @center is the first thing after a section heading, we need to wipe
    921   % out the negative parskip inserted by \sectionheading, but still
    922   % prevent a page break here.
    923   \centerpenalty = \lastpenalty
    924   \ifnum\centerpenalty>10000 \vskip\parskip \fi
    925   \ifnum\centerpenalty>9999 \penalty\centerpenalty \fi
    926   \line{\kern\leftskip #1\kern\rightskip}%
    927 }
    928 
    929 % @sp n   outputs n lines of vertical space
    930 %
    931 \parseargdef\sp{\vskip #1\baselineskip}
    932 
    933 % @comment ...line which is ignored...
    934 % @c is the same as @comment
    935 % @ignore ... @end ignore  is another way to write a comment
    936 %
    937 \def\comment{\begingroup \catcode`\^^M=\other%
    938 \catcode`\@=\other \catcode`\{=\other \catcode`\}=\other%
    939 \commentxxx}
    940 {\catcode`\^^M=\other \gdef\commentxxx#1^^M{\endgroup}}
    941 %
    942 \let\c=\comment
    943 
    944 % @paragraphindent NCHARS
    945 % We'll use ems for NCHARS, close enough.
    946 % NCHARS can also be the word `asis' or `none'.
    947 % We cannot feasibly implement @paragraphindent asis, though.
    948 %
    949 \def\asisword{asis} % no translation, these are keywords
    950 \def\noneword{none}
    951 %
    952 \parseargdef\paragraphindent{%
    953   \def\temp{#1}%
    954   \ifx\temp\asisword
    955   \else
    956     \ifx\temp\noneword
    957       \defaultparindent = 0pt
    958     \else
    959       \defaultparindent = #1em
    960     \fi
    961   \fi
    962   \parindent = \defaultparindent
    963 }
    964 
    965 % @exampleindent NCHARS
    966 % We'll use ems for NCHARS like @paragraphindent.
    967 % It seems @exampleindent asis isn't necessary, but
    968 % I preserve it to make it similar to @paragraphindent.
    969 \parseargdef\exampleindent{%
    970   \def\temp{#1}%
    971   \ifx\temp\asisword
    972   \else
    973     \ifx\temp\noneword
    974       \lispnarrowing = 0pt
    975     \else
    976       \lispnarrowing = #1em
    977     \fi
    978   \fi
    979 }
    980 
    981 % @firstparagraphindent WORD
    982 % If WORD is `none', then suppress indentation of the first paragraph
    983 % after a section heading.  If WORD is `insert', then do indent at such
    984 % paragraphs.
    985 %
    986 % The paragraph indentation is suppressed or not by calling
    987 % \suppressfirstparagraphindent, which the sectioning commands do.
    988 % We switch the definition of this back and forth according to WORD.
    989 % By default, we suppress indentation.
    990 %
    991 \def\suppressfirstparagraphindent{\dosuppressfirstparagraphindent}
    992 \def\insertword{insert}
    993 %
    994 \parseargdef\firstparagraphindent{%
    995   \def\temp{#1}%
    996   \ifx\temp\noneword
    997     \let\suppressfirstparagraphindent = \dosuppressfirstparagraphindent
    998   \else\ifx\temp\insertword
    999     \let\suppressfirstparagraphindent = \relax
   1000   \else
   1001     \errhelp = \EMsimple
   1002     \errmessage{Unknown @firstparagraphindent option `\temp'}%
   1003   \fi\fi
   1004 }
   1005 
   1006 % Here is how we actually suppress indentation.  Redefine \everypar to
   1007 % \kern backwards by \parindent, and then reset itself to empty.
   1008 %
   1009 % We also make \indent itself not actually do anything until the next
   1010 % paragraph.
   1011 %
   1012 \gdef\dosuppressfirstparagraphindent{%
   1013   \gdef\indent{%
   1014     \restorefirstparagraphindent
   1015     \indent
   1016   }%
   1017   \gdef\noindent{%
   1018     \restorefirstparagraphindent
   1019     \noindent
   1020   }%
   1021   \global\everypar = {%
   1022     \kern -\parindent
   1023     \restorefirstparagraphindent
   1024   }%
   1025 }
   1026 
   1027 \gdef\restorefirstparagraphindent{%
   1028   \global \let \indent = \ptexindent
   1029   \global \let \noindent = \ptexnoindent
   1030   \global \everypar = {}%
   1031 }
   1032 
   1033 
   1034 % @refill is a no-op.
   1035 \let\refill=\relax
   1036 
   1037 % If working on a large document in chapters, it is convenient to
   1038 % be able to disable indexing, cross-referencing, and contents, for test runs.
   1039 % This is done with @novalidate (before @setfilename).
   1040 %
   1041 \newif\iflinks \linkstrue % by default we want the aux files.
   1042 \let\novalidate = \linksfalse
   1043 
   1044 % @setfilename is done at the beginning of every texinfo file.
   1045 % So open here the files we need to have open while reading the input.
   1046 % This makes it possible to make a .fmt file for texinfo.
   1047 \def\setfilename{%
   1048    \fixbackslash  % Turn off hack to swallow `\input texinfo'.
   1049    \iflinks
   1050      \tryauxfile
   1051      % Open the new aux file.  TeX will close it automatically at exit.
   1052      \immediate\openout\auxfile=\jobname.aux
   1053    \fi % \openindices needs to do some work in any case.
   1054    \openindices
   1055    \let\setfilename=\comment % Ignore extra @setfilename cmds.
   1056    %
   1057    % If texinfo.cnf is present on the system, read it.
   1058    % Useful for site-wide @afourpaper, etc.
   1059    \openin 1 texinfo.cnf
   1060    \ifeof 1 \else \input texinfo.cnf \fi
   1061    \closein 1
   1062    %
   1063    \comment % Ignore the actual filename.
   1064 }
   1065 
   1066 % Called from \setfilename.
   1067 %
   1068 \def\openindices{%
   1069   \newindex{cp}%
   1070   \newcodeindex{fn}%
   1071   \newcodeindex{vr}%
   1072   \newcodeindex{tp}%
   1073   \newcodeindex{ky}%
   1074   \newcodeindex{pg}%
   1075 }
   1076 
   1077 % @bye.
   1078 \outer\def\bye{\pagealignmacro\tracingstats=1\ptexend}
   1079 
   1080 
   1081 \message{pdf,}
   1082 % adobe `portable' document format
   1083 \newcount\tempnum
   1084 \newcount\lnkcount
   1085 \newtoks\filename
   1086 \newcount\filenamelength
   1087 \newcount\pgn
   1088 \newtoks\toksA
   1089 \newtoks\toksB
   1090 \newtoks\toksC
   1091 \newtoks\toksD
   1092 \newbox\boxA
   1093 \newcount\countA
   1094 \newif\ifpdf
   1095 \newif\ifpdfmakepagedest
   1096 
   1097 % when pdftex is run in dvi mode, \pdfoutput is defined (so \pdfoutput=1
   1098 % can be set).  So we test for \relax and 0 as well as being undefined.
   1099 \ifx\pdfoutput\thisisundefined
   1100 \else
   1101   \ifx\pdfoutput\relax
   1102   \else
   1103     \ifcase\pdfoutput
   1104     \else
   1105       \pdftrue
   1106     \fi
   1107   \fi
   1108 \fi
   1109 
   1110 % PDF uses PostScript string constants for the names of xref targets,
   1111 % for display in the outlines, and in other places.  Thus, we have to
   1112 % double any backslashes.  Otherwise, a name like "\node" will be
   1113 % interpreted as a newline (\n), followed by o, d, e.  Not good.
   1114 %
   1115 % See http://www.ntg.nl/pipermail/ntg-pdftex/2004-July/000654.html and
   1116 % related messages.  The final outcome is that it is up to the TeX user
   1117 % to double the backslashes and otherwise make the string valid, so
   1118 % that's what we do.  pdftex 1.30.0 (ca.2005) introduced a primitive to
   1119 % do this reliably, so we use it.
   1120 
   1121 % #1 is a control sequence in which to do the replacements,
   1122 % which we \xdef.
   1123 \def\txiescapepdf#1{%
   1124   \ifx\pdfescapestring\thisisundefined
   1125     % No primitive available; should we give a warning or log?
   1126     % Many times it won't matter.
   1127   \else
   1128     % The expandable \pdfescapestring primitive escapes parentheses,
   1129     % backslashes, and other special chars.
   1130     \xdef#1{\pdfescapestring{#1}}%
   1131   \fi
   1132 }
   1133 
   1134 \newhelp\nopdfimagehelp{Texinfo supports .png, .jpg, .jpeg, and .pdf images
   1135 with PDF output, and none of those formats could be found.  (.eps cannot
   1136 be supported due to the design of the PDF format; use regular TeX (DVI
   1137 output) for that.)}
   1138 
   1139 \ifpdf
   1140   %
   1141   % Color manipulation macros based on pdfcolor.tex,
   1142   % except using rgb instead of cmyk; the latter is said to render as a
   1143   % very dark gray on-screen and a very dark halftone in print, instead
   1144   % of actual black.
   1145   \def\rgbDarkRed{0.50 0.09 0.12}
   1146   \def\rgbBlack{0 0 0}
   1147   %
   1148   % k sets the color for filling (usual text, etc.);
   1149   % K sets the color for stroking (thin rules, e.g., normal _'s).
   1150   \def\pdfsetcolor#1{\pdfliteral{#1 rg  #1 RG}}
   1151   %
   1152   % Set color, and create a mark which defines \thiscolor accordingly,
   1153   % so that \makeheadline knows which color to restore.
   1154   \def\setcolor#1{%
   1155     \xdef\lastcolordefs{\gdef\noexpand\thiscolor{#1}}%
   1156     \domark
   1157     \pdfsetcolor{#1}%
   1158   }
   1159   %
   1160   \def\maincolor{\rgbBlack}
   1161   \pdfsetcolor{\maincolor}
   1162   \edef\thiscolor{\maincolor}
   1163   \def\lastcolordefs{}
   1164   %
   1165   \def\makefootline{%
   1166     \baselineskip24pt
   1167     \line{\pdfsetcolor{\maincolor}\the\footline}%
   1168   }
   1169   %
   1170   \def\makeheadline{%
   1171     \vbox to 0pt{%
   1172       \vskip-22.5pt
   1173       \line{%
   1174         \vbox to8.5pt{}%
   1175         % Extract \thiscolor definition from the marks.
   1176         \getcolormarks
   1177         % Typeset the headline with \maincolor, then restore the color.
   1178         \pdfsetcolor{\maincolor}\the\headline\pdfsetcolor{\thiscolor}%
   1179       }%
   1180       \vss
   1181     }%
   1182     \nointerlineskip
   1183   }
   1184   %
   1185   %
   1186   \pdfcatalog{/PageMode /UseOutlines}
   1187   %
   1188   % #1 is image name, #2 width (might be empty/whitespace), #3 height (ditto).
   1189   \def\dopdfimage#1#2#3{%
   1190     \def\pdfimagewidth{#2}\setbox0 = \hbox{\ignorespaces #2}%
   1191     \def\pdfimageheight{#3}\setbox2 = \hbox{\ignorespaces #3}%
   1192     %
   1193     % pdftex (and the PDF format) support .pdf, .png, .jpg (among
   1194     % others).  Let's try in that order, PDF first since if
   1195     % someone has a scalable image, presumably better to use that than a
   1196     % bitmap.
   1197     \let\pdfimgext=\empty
   1198     \begingroup
   1199       \openin 1 #1.pdf \ifeof 1
   1200         \openin 1 #1.PDF \ifeof 1
   1201           \openin 1 #1.png \ifeof 1
   1202             \openin 1 #1.jpg \ifeof 1
   1203               \openin 1 #1.jpeg \ifeof 1
   1204                 \openin 1 #1.JPG \ifeof 1
   1205                   \errhelp = \nopdfimagehelp
   1206                   \errmessage{Could not find image file #1 for pdf}%
   1207                 \else \gdef\pdfimgext{JPG}%
   1208                 \fi
   1209               \else \gdef\pdfimgext{jpeg}%
   1210               \fi
   1211             \else \gdef\pdfimgext{jpg}%
   1212             \fi
   1213           \else \gdef\pdfimgext{png}%
   1214           \fi
   1215         \else \gdef\pdfimgext{PDF}%
   1216         \fi
   1217       \else \gdef\pdfimgext{pdf}%
   1218       \fi
   1219       \closein 1
   1220     \endgroup
   1221     %
   1222     % without \immediate, ancient pdftex seg faults when the same image is
   1223     % included twice.  (Version 3.14159-pre-1.0-unofficial-20010704.)
   1224     \ifnum\pdftexversion < 14
   1225       \immediate\pdfimage
   1226     \else
   1227       \immediate\pdfximage
   1228     \fi
   1229       \ifdim \wd0 >0pt width \pdfimagewidth \fi
   1230       \ifdim \wd2 >0pt height \pdfimageheight \fi
   1231       \ifnum\pdftexversion<13
   1232          #1.\pdfimgext
   1233        \else
   1234          {#1.\pdfimgext}%
   1235        \fi
   1236     \ifnum\pdftexversion < 14 \else
   1237       \pdfrefximage \pdflastximage
   1238     \fi}
   1239   %
   1240   \def\pdfmkdest#1{{%
   1241     % We have to set dummies so commands such as @code, and characters
   1242     % such as \, aren't expanded when present in a section title.
   1243     \indexnofonts
   1244     \turnoffactive
   1245     \makevalueexpandable
   1246     \def\pdfdestname{#1}%
   1247     \txiescapepdf\pdfdestname
   1248     \safewhatsit{\pdfdest name{\pdfdestname} xyz}%
   1249   }}
   1250   %
   1251   % used to mark target names; must be expandable.
   1252   \def\pdfmkpgn#1{#1}
   1253   %
   1254   % by default, use a color that is dark enough to print on paper as
   1255   % nearly black, but still distinguishable for online viewing.
   1256   \def\urlcolor{\rgbDarkRed}
   1257   \def\linkcolor{\rgbDarkRed}
   1258   \def\endlink{\setcolor{\maincolor}\pdfendlink}
   1259   %
   1260   % Adding outlines to PDF; macros for calculating structure of outlines
   1261   % come from Petr Olsak
   1262   \def\expnumber#1{\expandafter\ifx\csname#1\endcsname\relax 0%
   1263     \else \csname#1\endcsname \fi}
   1264   \def\advancenumber#1{\tempnum=\expnumber{#1}\relax
   1265     \advance\tempnum by 1
   1266     \expandafter\xdef\csname#1\endcsname{\the\tempnum}}
   1267   %
   1268   % #1 is the section text, which is what will be displayed in the
   1269   % outline by the pdf viewer.  #2 is the pdf expression for the number
   1270   % of subentries (or empty, for subsubsections).  #3 is the node text,
   1271   % which might be empty if this toc entry had no corresponding node.
   1272   % #4 is the page number
   1273   %
   1274   \def\dopdfoutline#1#2#3#4{%
   1275     % Generate a link to the node text if that exists; else, use the
   1276     % page number.  We could generate a destination for the section
   1277     % text in the case where a section has no node, but it doesn't
   1278     % seem worth the trouble, since most documents are normally structured.
   1279     \edef\pdfoutlinedest{#3}%
   1280     \ifx\pdfoutlinedest\empty
   1281       \def\pdfoutlinedest{#4}%
   1282     \else
   1283       \txiescapepdf\pdfoutlinedest
   1284     \fi
   1285     %
   1286     % Also escape PDF chars in the display string.
   1287     \edef\pdfoutlinetext{#1}%
   1288     \txiescapepdf\pdfoutlinetext
   1289     %
   1290     \pdfoutline goto name{\pdfmkpgn{\pdfoutlinedest}}#2{\pdfoutlinetext}%
   1291   }
   1292   %
   1293   \def\pdfmakeoutlines{%
   1294     \begingroup
   1295       % Read toc silently, to get counts of subentries for \pdfoutline.
   1296       \def\partentry##1##2##3##4{}% ignore parts in the outlines
   1297       \def\numchapentry##1##2##3##4{%
   1298 	\def\thischapnum{##2}%
   1299 	\def\thissecnum{0}%
   1300 	\def\thissubsecnum{0}%
   1301       }%
   1302       \def\numsecentry##1##2##3##4{%
   1303 	\advancenumber{chap\thischapnum}%
   1304 	\def\thissecnum{##2}%
   1305 	\def\thissubsecnum{0}%
   1306       }%
   1307       \def\numsubsecentry##1##2##3##4{%
   1308 	\advancenumber{sec\thissecnum}%
   1309 	\def\thissubsecnum{##2}%
   1310       }%
   1311       \def\numsubsubsecentry##1##2##3##4{%
   1312 	\advancenumber{subsec\thissubsecnum}%
   1313       }%
   1314       \def\thischapnum{0}%
   1315       \def\thissecnum{0}%
   1316       \def\thissubsecnum{0}%
   1317       %
   1318       % use \def rather than \let here because we redefine \chapentry et
   1319       % al. a second time, below.
   1320       \def\appentry{\numchapentry}%
   1321       \def\appsecentry{\numsecentry}%
   1322       \def\appsubsecentry{\numsubsecentry}%
   1323       \def\appsubsubsecentry{\numsubsubsecentry}%
   1324       \def\unnchapentry{\numchapentry}%
   1325       \def\unnsecentry{\numsecentry}%
   1326       \def\unnsubsecentry{\numsubsecentry}%
   1327       \def\unnsubsubsecentry{\numsubsubsecentry}%
   1328       \readdatafile{toc}%
   1329       %
   1330       % Read toc second time, this time actually producing the outlines.
   1331       % The `-' means take the \expnumber as the absolute number of
   1332       % subentries, which we calculated on our first read of the .toc above.
   1333       %
   1334       % We use the node names as the destinations.
   1335       \def\numchapentry##1##2##3##4{%
   1336         \dopdfoutline{##1}{count-\expnumber{chap##2}}{##3}{##4}}%
   1337       \def\numsecentry##1##2##3##4{%
   1338         \dopdfoutline{##1}{count-\expnumber{sec##2}}{##3}{##4}}%
   1339       \def\numsubsecentry##1##2##3##4{%
   1340         \dopdfoutline{##1}{count-\expnumber{subsec##2}}{##3}{##4}}%
   1341       \def\numsubsubsecentry##1##2##3##4{% count is always zero
   1342         \dopdfoutline{##1}{}{##3}{##4}}%
   1343       %
   1344       % PDF outlines are displayed using system fonts, instead of
   1345       % document fonts.  Therefore we cannot use special characters,
   1346       % since the encoding is unknown.  For example, the eogonek from
   1347       % Latin 2 (0xea) gets translated to a | character.  Info from
   1348       % Staszek Wawrykiewicz, 19 Jan 2004 04:09:24 +0100.
   1349       %
   1350       % TODO this right, we have to translate 8-bit characters to
   1351       % their "best" equivalent, based on the @documentencoding.  Too
   1352       % much work for too little return.  Just use the ASCII equivalents
   1353       % we use for the index sort strings.
   1354       %
   1355       \indexnofonts
   1356       \setupdatafile
   1357       % We can have normal brace characters in the PDF outlines, unlike
   1358       % Texinfo index files.  So set that up.
   1359       \def\{{\lbracecharliteral}%
   1360       \def\}{\rbracecharliteral}%
   1361       \catcode`\\=\active \otherbackslash
   1362       \input \tocreadfilename
   1363     \endgroup
   1364   }
   1365   {\catcode`[=1 \catcode`]=2
   1366    \catcode`{=\other \catcode`}=\other
   1367    \gdef\lbracecharliteral[{]%
   1368    \gdef\rbracecharliteral[}]%
   1369   ]
   1370   %
   1371   \def\skipspaces#1{\def\PP{#1}\def\D{|}%
   1372     \ifx\PP\D\let\nextsp\relax
   1373     \else\let\nextsp\skipspaces
   1374       \addtokens{\filename}{\PP}%
   1375       \advance\filenamelength by 1
   1376     \fi
   1377     \nextsp}
   1378   \def\getfilename#1{%
   1379     \filenamelength=0
   1380     % If we don't expand the argument now, \skipspaces will get
   1381     % snagged on things like "@value{foo}".
   1382     \edef\temp{#1}%
   1383     \expandafter\skipspaces\temp|\relax
   1384   }
   1385   \ifnum\pdftexversion < 14
   1386     \let \startlink \pdfannotlink
   1387   \else
   1388     \let \startlink \pdfstartlink
   1389   \fi
   1390   % make a live url in pdf output.
   1391   \def\pdfurl#1{%
   1392     \begingroup
   1393       % it seems we really need yet another set of dummies; have not
   1394       % tried to figure out what each command should do in the context
   1395       % of @url.  for now, just make @/ a no-op, that's the only one
   1396       % people have actually reported a problem with.
   1397       %
   1398       \normalturnoffactive
   1399       \def\@{@}%
   1400       \let\/=\empty
   1401       \makevalueexpandable
   1402       % do we want to go so far as to use \indexnofonts instead of just
   1403       % special-casing \var here?
   1404       \def\var##1{##1}%
   1405       %
   1406       \leavevmode\setcolor{\urlcolor}%
   1407       \startlink attr{/Border [0 0 0]}%
   1408         user{/Subtype /Link /A << /S /URI /URI (#1) >>}%
   1409     \endgroup}
   1410   \def\pdfgettoks#1.{\setbox\boxA=\hbox{\toksA={#1.}\toksB={}\maketoks}}
   1411   \def\addtokens#1#2{\edef\addtoks{\noexpand#1={\the#1#2}}\addtoks}
   1412   \def\adn#1{\addtokens{\toksC}{#1}\global\countA=1\let\next=\maketoks}
   1413   \def\poptoks#1#2|ENDTOKS|{\let\first=#1\toksD={#1}\toksA={#2}}
   1414   \def\maketoks{%
   1415     \expandafter\poptoks\the\toksA|ENDTOKS|\relax
   1416     \ifx\first0\adn0
   1417     \else\ifx\first1\adn1 \else\ifx\first2\adn2 \else\ifx\first3\adn3
   1418     \else\ifx\first4\adn4 \else\ifx\first5\adn5 \else\ifx\first6\adn6
   1419     \else\ifx\first7\adn7 \else\ifx\first8\adn8 \else\ifx\first9\adn9
   1420     \else
   1421       \ifnum0=\countA\else\makelink\fi
   1422       \ifx\first.\let\next=\done\else
   1423         \let\next=\maketoks
   1424         \addtokens{\toksB}{\the\toksD}
   1425         \ifx\first,\addtokens{\toksB}{\space}\fi
   1426       \fi
   1427     \fi\fi\fi\fi\fi\fi\fi\fi\fi\fi
   1428     \next}
   1429   \def\makelink{\addtokens{\toksB}%
   1430     {\noexpand\pdflink{\the\toksC}}\toksC={}\global\countA=0}
   1431   \def\pdflink#1{%
   1432     \startlink attr{/Border [0 0 0]} goto name{\pdfmkpgn{#1}}
   1433     \setcolor{\linkcolor}#1\endlink}
   1434   \def\done{\edef\st{\global\noexpand\toksA={\the\toksB}}\st}
   1435 \else
   1436   % non-pdf mode
   1437   \let\pdfmkdest = \gobble
   1438   \let\pdfurl = \gobble
   1439   \let\endlink = \relax
   1440   \let\setcolor = \gobble
   1441   \let\pdfsetcolor = \gobble
   1442   \let\pdfmakeoutlines = \relax
   1443 \fi  % \ifx\pdfoutput
   1444 
   1445 
   1446 \message{fonts,}
   1447 
   1448 % Change the current font style to #1, remembering it in \curfontstyle.
   1449 % For now, we do not accumulate font styles: @b{@i{foo}} prints foo in
   1450 % italics, not bold italics.
   1451 %
   1452 \def\setfontstyle#1{%
   1453   \def\curfontstyle{#1}% not as a control sequence, because we are \edef'd.
   1454   \csname ten#1\endcsname  % change the current font
   1455 }
   1456 
   1457 % Select #1 fonts with the current style.
   1458 %
   1459 \def\selectfonts#1{\csname #1fonts\endcsname \csname\curfontstyle\endcsname}
   1460 
   1461 \def\rm{\fam=0 \setfontstyle{rm}}
   1462 \def\it{\fam=\itfam \setfontstyle{it}}
   1463 \def\sl{\fam=\slfam \setfontstyle{sl}}
   1464 \def\bf{\fam=\bffam \setfontstyle{bf}}\def\bfstylename{bf}
   1465 \def\tt{\fam=\ttfam \setfontstyle{tt}}
   1466 
   1467 % Unfortunately, we have to override this for titles and the like, since
   1468 % in those cases "rm" is bold.  Sigh.
   1469 \def\rmisbold{\rm\def\curfontstyle{bf}}
   1470 
   1471 % Texinfo sort of supports the sans serif font style, which plain TeX does not.
   1472 % So we set up a \sf.
   1473 \newfam\sffam
   1474 \def\sf{\fam=\sffam \setfontstyle{sf}}
   1475 \let\li = \sf % Sometimes we call it \li, not \sf.
   1476 
   1477 % We don't need math for this font style.
   1478 \def\ttsl{\setfontstyle{ttsl}}
   1479 
   1480 
   1481 % Set the baselineskip to #1, and the lineskip and strut size
   1482 % correspondingly.  There is no deep meaning behind these magic numbers
   1483 % used as factors; they just match (closely enough) what Knuth defined.
   1484 %
   1485 \def\lineskipfactor{.08333}
   1486 \def\strutheightpercent{.70833}
   1487 \def\strutdepthpercent {.29167}
   1488 %
   1489 % can get a sort of poor man's double spacing by redefining this.
   1490 \def\baselinefactor{1}
   1491 %
   1492 \newdimen\textleading
   1493 \def\setleading#1{%
   1494   \dimen0 = #1\relax
   1495   \normalbaselineskip = \baselinefactor\dimen0
   1496   \normallineskip = \lineskipfactor\normalbaselineskip
   1497   \normalbaselines
   1498   \setbox\strutbox =\hbox{%
   1499     \vrule width0pt height\strutheightpercent\baselineskip
   1500                     depth \strutdepthpercent \baselineskip
   1501   }%
   1502 }
   1503 
   1504 % PDF CMaps.  See also LaTeX's t1.cmap.
   1505 %
   1506 % do nothing with this by default.
   1507 \expandafter\let\csname cmapOT1\endcsname\gobble
   1508 \expandafter\let\csname cmapOT1IT\endcsname\gobble
   1509 \expandafter\let\csname cmapOT1TT\endcsname\gobble
   1510 
   1511 % if we are producing pdf, and we have \pdffontattr, then define cmaps.
   1512 % (\pdffontattr was introduced many years ago, but people still run
   1513 % older pdftex's; it's easy to conditionalize, so we do.)
   1514 \ifpdf \ifx\pdffontattr\thisisundefined \else
   1515   \begingroup
   1516     \catcode`\^^M=\active \def^^M{^^J}% Output line endings as the ^^J char.
   1517     \catcode`\%=12 \immediate\pdfobj stream {%!PS-Adobe-3.0 Resource-CMap
   1518 %%DocumentNeededResources: ProcSet (CIDInit)
   1519 %%IncludeResource: ProcSet (CIDInit)
   1520 %%BeginResource: CMap (TeX-OT1-0)
   1521 %%Title: (TeX-OT1-0 TeX OT1 0)
   1522 %%Version: 1.000
   1523 %%EndComments
   1524 /CIDInit /ProcSet findresource begin
   1525 12 dict begin
   1526 begincmap
   1527 /CIDSystemInfo
   1528 << /Registry (TeX)
   1529 /Ordering (OT1)
   1530 /Supplement 0
   1531 >> def
   1532 /CMapName /TeX-OT1-0 def
   1533 /CMapType 2 def
   1534 1 begincodespacerange
   1535 <00> <7F>
   1536 endcodespacerange
   1537 8 beginbfrange
   1538 <00> <01> <0393>
   1539 <09> <0A> <03A8>
   1540 <23> <26> <0023>
   1541 <28> <3B> <0028>
   1542 <3F> <5B> <003F>
   1543 <5D> <5E> <005D>
   1544 <61> <7A> <0061>
   1545 <7B> <7C> <2013>
   1546 endbfrange
   1547 40 beginbfchar
   1548 <02> <0398>
   1549 <03> <039B>
   1550 <04> <039E>
   1551 <05> <03A0>
   1552 <06> <03A3>
   1553 <07> <03D2>
   1554 <08> <03A6>
   1555 <0B> <00660066>
   1556 <0C> <00660069>
   1557 <0D> <0066006C>
   1558 <0E> <006600660069>
   1559 <0F> <00660066006C>
   1560 <10> <0131>
   1561 <11> <0237>
   1562 <12> <0060>
   1563 <13> <00B4>
   1564 <14> <02C7>
   1565 <15> <02D8>
   1566 <16> <00AF>
   1567 <17> <02DA>
   1568 <18> <00B8>
   1569 <19> <00DF>
   1570 <1A> <00E6>
   1571 <1B> <0153>
   1572 <1C> <00F8>
   1573 <1D> <00C6>
   1574 <1E> <0152>
   1575 <1F> <00D8>
   1576 <21> <0021>
   1577 <22> <201D>
   1578 <27> <2019>
   1579 <3C> <00A1>
   1580 <3D> <003D>
   1581 <3E> <00BF>
   1582 <5C> <201C>
   1583 <5F> <02D9>
   1584 <60> <2018>
   1585 <7D> <02DD>
   1586 <7E> <007E>
   1587 <7F> <00A8>
   1588 endbfchar
   1589 endcmap
   1590 CMapName currentdict /CMap defineresource pop
   1591 end
   1592 end
   1593 %%EndResource
   1594 %%EOF
   1595     }\endgroup
   1596   \expandafter\edef\csname cmapOT1\endcsname#1{%
   1597     \pdffontattr#1{/ToUnicode \the\pdflastobj\space 0 R}%
   1598   }%
   1599 %
   1600 % \cmapOT1IT
   1601   \begingroup
   1602     \catcode`\^^M=\active \def^^M{^^J}% Output line endings as the ^^J char.
   1603     \catcode`\%=12 \immediate\pdfobj stream {%!PS-Adobe-3.0 Resource-CMap
   1604 %%DocumentNeededResources: ProcSet (CIDInit)
   1605 %%IncludeResource: ProcSet (CIDInit)
   1606 %%BeginResource: CMap (TeX-OT1IT-0)
   1607 %%Title: (TeX-OT1IT-0 TeX OT1IT 0)
   1608 %%Version: 1.000
   1609 %%EndComments
   1610 /CIDInit /ProcSet findresource begin
   1611 12 dict begin
   1612 begincmap
   1613 /CIDSystemInfo
   1614 << /Registry (TeX)
   1615 /Ordering (OT1IT)
   1616 /Supplement 0
   1617 >> def
   1618 /CMapName /TeX-OT1IT-0 def
   1619 /CMapType 2 def
   1620 1 begincodespacerange
   1621 <00> <7F>
   1622 endcodespacerange
   1623 8 beginbfrange
   1624 <00> <01> <0393>
   1625 <09> <0A> <03A8>
   1626 <25> <26> <0025>
   1627 <28> <3B> <0028>
   1628 <3F> <5B> <003F>
   1629 <5D> <5E> <005D>
   1630 <61> <7A> <0061>
   1631 <7B> <7C> <2013>
   1632 endbfrange
   1633 42 beginbfchar
   1634 <02> <0398>
   1635 <03> <039B>
   1636 <04> <039E>
   1637 <05> <03A0>
   1638 <06> <03A3>
   1639 <07> <03D2>
   1640 <08> <03A6>
   1641 <0B> <00660066>
   1642 <0C> <00660069>
   1643 <0D> <0066006C>
   1644 <0E> <006600660069>
   1645 <0F> <00660066006C>
   1646 <10> <0131>
   1647 <11> <0237>
   1648 <12> <0060>
   1649 <13> <00B4>
   1650 <14> <02C7>
   1651 <15> <02D8>
   1652 <16> <00AF>
   1653 <17> <02DA>
   1654 <18> <00B8>
   1655 <19> <00DF>
   1656 <1A> <00E6>
   1657 <1B> <0153>
   1658 <1C> <00F8>
   1659 <1D> <00C6>
   1660 <1E> <0152>
   1661 <1F> <00D8>
   1662 <21> <0021>
   1663 <22> <201D>
   1664 <23> <0023>
   1665 <24> <00A3>
   1666 <27> <2019>
   1667 <3C> <00A1>
   1668 <3D> <003D>
   1669 <3E> <00BF>
   1670 <5C> <201C>
   1671 <5F> <02D9>
   1672 <60> <2018>
   1673 <7D> <02DD>
   1674 <7E> <007E>
   1675 <7F> <00A8>
   1676 endbfchar
   1677 endcmap
   1678 CMapName currentdict /CMap defineresource pop
   1679 end
   1680 end
   1681 %%EndResource
   1682 %%EOF
   1683     }\endgroup
   1684   \expandafter\edef\csname cmapOT1IT\endcsname#1{%
   1685     \pdffontattr#1{/ToUnicode \the\pdflastobj\space 0 R}%
   1686   }%
   1687 %
   1688 % \cmapOT1TT
   1689   \begingroup
   1690     \catcode`\^^M=\active \def^^M{^^J}% Output line endings as the ^^J char.
   1691     \catcode`\%=12 \immediate\pdfobj stream {%!PS-Adobe-3.0 Resource-CMap
   1692 %%DocumentNeededResources: ProcSet (CIDInit)
   1693 %%IncludeResource: ProcSet (CIDInit)
   1694 %%BeginResource: CMap (TeX-OT1TT-0)
   1695 %%Title: (TeX-OT1TT-0 TeX OT1TT 0)
   1696 %%Version: 1.000
   1697 %%EndComments
   1698 /CIDInit /ProcSet findresource begin
   1699 12 dict begin
   1700 begincmap
   1701 /CIDSystemInfo
   1702 << /Registry (TeX)
   1703 /Ordering (OT1TT)
   1704 /Supplement 0
   1705 >> def
   1706 /CMapName /TeX-OT1TT-0 def
   1707 /CMapType 2 def
   1708 1 begincodespacerange
   1709 <00> <7F>
   1710 endcodespacerange
   1711 5 beginbfrange
   1712 <00> <01> <0393>
   1713 <09> <0A> <03A8>
   1714 <21> <26> <0021>
   1715 <28> <5F> <0028>
   1716 <61> <7E> <0061>
   1717 endbfrange
   1718 32 beginbfchar
   1719 <02> <0398>
   1720 <03> <039B>
   1721 <04> <039E>
   1722 <05> <03A0>
   1723 <06> <03A3>
   1724 <07> <03D2>
   1725 <08> <03A6>
   1726 <0B> <2191>
   1727 <0C> <2193>
   1728 <0D> <0027>
   1729 <0E> <00A1>
   1730 <0F> <00BF>
   1731 <10> <0131>
   1732 <11> <0237>
   1733 <12> <0060>
   1734 <13> <00B4>
   1735 <14> <02C7>
   1736 <15> <02D8>
   1737 <16> <00AF>
   1738 <17> <02DA>
   1739 <18> <00B8>
   1740 <19> <00DF>
   1741 <1A> <00E6>
   1742 <1B> <0153>
   1743 <1C> <00F8>
   1744 <1D> <00C6>
   1745 <1E> <0152>
   1746 <1F> <00D8>
   1747 <20> <2423>
   1748 <27> <2019>
   1749 <60> <2018>
   1750 <7F> <00A8>
   1751 endbfchar
   1752 endcmap
   1753 CMapName currentdict /CMap defineresource pop
   1754 end
   1755 end
   1756 %%EndResource
   1757 %%EOF
   1758     }\endgroup
   1759   \expandafter\edef\csname cmapOT1TT\endcsname#1{%
   1760     \pdffontattr#1{/ToUnicode \the\pdflastobj\space 0 R}%
   1761   }%
   1762 \fi\fi
   1763 
   1764 
   1765 % Set the font macro #1 to the font named \fontprefix#2.
   1766 % #3 is the font's design size, #4 is a scale factor, #5 is the CMap
   1767 % encoding (only OT1, OT1IT and OT1TT are allowed, or empty to omit).
   1768 % Example:
   1769 % #1 = \textrm
   1770 % #2 = \rmshape
   1771 % #3 = 10
   1772 % #4 = \mainmagstep
   1773 % #5 = OT1
   1774 %
   1775 \def\setfont#1#2#3#4#5{%
   1776   \font#1=\fontprefix#2#3 scaled #4
   1777   \csname cmap#5\endcsname#1%
   1778 }
   1779 % This is what gets called when #5 of \setfont is empty.
   1780 \let\cmap\gobble
   1781 %
   1782 % (end of cmaps)
   1783 
   1784 % Use cm as the default font prefix.
   1785 % To specify the font prefix, you must define \fontprefix
   1786 % before you read in texinfo.tex.
   1787 \ifx\fontprefix\thisisundefined
   1788 \def\fontprefix{cm}
   1789 \fi
   1790 % Support font families that don't use the same naming scheme as CM.
   1791 \def\rmshape{r}
   1792 \def\rmbshape{bx}               % where the normal face is bold
   1793 \def\bfshape{b}
   1794 \def\bxshape{bx}
   1795 \def\ttshape{tt}
   1796 \def\ttbshape{tt}
   1797 \def\ttslshape{sltt}
   1798 \def\itshape{ti}
   1799 \def\itbshape{bxti}
   1800 \def\slshape{sl}
   1801 \def\slbshape{bxsl}
   1802 \def\sfshape{ss}
   1803 \def\sfbshape{ss}
   1804 \def\scshape{csc}
   1805 \def\scbshape{csc}
   1806 
   1807 % Definitions for a main text size of 11pt.  (The default in Texinfo.)
   1808 %
   1809 \def\definetextfontsizexi{%
   1810 % Text fonts (11.2pt, magstep1).
   1811 \def\textnominalsize{11pt}
   1812 \edef\mainmagstep{\magstephalf}
   1813 \setfont\textrm\rmshape{10}{\mainmagstep}{OT1}
   1814 \setfont\texttt\ttshape{10}{\mainmagstep}{OT1TT}
   1815 \setfont\textbf\bfshape{10}{\mainmagstep}{OT1}
   1816 \setfont\textit\itshape{10}{\mainmagstep}{OT1IT}
   1817 \setfont\textsl\slshape{10}{\mainmagstep}{OT1}
   1818 \setfont\textsf\sfshape{10}{\mainmagstep}{OT1}
   1819 \setfont\textsc\scshape{10}{\mainmagstep}{OT1}
   1820 \setfont\textttsl\ttslshape{10}{\mainmagstep}{OT1TT}
   1821 \font\texti=cmmi10 scaled \mainmagstep
   1822 \font\textsy=cmsy10 scaled \mainmagstep
   1823 \def\textecsize{1095}
   1824 
   1825 % A few fonts for @defun names and args.
   1826 \setfont\defbf\bfshape{10}{\magstep1}{OT1}
   1827 \setfont\deftt\ttshape{10}{\magstep1}{OT1TT}
   1828 \setfont\defttsl\ttslshape{10}{\magstep1}{OT1TT}
   1829 \def\df{\let\tentt=\deftt \let\tenbf = \defbf \let\tenttsl=\defttsl \bf}
   1830 
   1831 % Fonts for indices, footnotes, small examples (9pt).
   1832 \def\smallnominalsize{9pt}
   1833 \setfont\smallrm\rmshape{9}{1000}{OT1}
   1834 \setfont\smalltt\ttshape{9}{1000}{OT1TT}
   1835 \setfont\smallbf\bfshape{10}{900}{OT1}
   1836 \setfont\smallit\itshape{9}{1000}{OT1IT}
   1837 \setfont\smallsl\slshape{9}{1000}{OT1}
   1838 \setfont\smallsf\sfshape{9}{1000}{OT1}
   1839 \setfont\smallsc\scshape{10}{900}{OT1}
   1840 \setfont\smallttsl\ttslshape{10}{900}{OT1TT}
   1841 \font\smalli=cmmi9
   1842 \font\smallsy=cmsy9
   1843 \def\smallecsize{0900}
   1844 
   1845 % Fonts for small examples (8pt).
   1846 \def\smallernominalsize{8pt}
   1847 \setfont\smallerrm\rmshape{8}{1000}{OT1}
   1848 \setfont\smallertt\ttshape{8}{1000}{OT1TT}
   1849 \setfont\smallerbf\bfshape{10}{800}{OT1}
   1850 \setfont\smallerit\itshape{8}{1000}{OT1IT}
   1851 \setfont\smallersl\slshape{8}{1000}{OT1}
   1852 \setfont\smallersf\sfshape{8}{1000}{OT1}
   1853 \setfont\smallersc\scshape{10}{800}{OT1}
   1854 \setfont\smallerttsl\ttslshape{10}{800}{OT1TT}
   1855 \font\smalleri=cmmi8
   1856 \font\smallersy=cmsy8
   1857 \def\smallerecsize{0800}
   1858 
   1859 % Fonts for title page (20.4pt):
   1860 \def\titlenominalsize{20pt}
   1861 \setfont\titlerm\rmbshape{12}{\magstep3}{OT1}
   1862 \setfont\titleit\itbshape{10}{\magstep4}{OT1IT}
   1863 \setfont\titlesl\slbshape{10}{\magstep4}{OT1}
   1864 \setfont\titlett\ttbshape{12}{\magstep3}{OT1TT}
   1865 \setfont\titlettsl\ttslshape{10}{\magstep4}{OT1TT}
   1866 \setfont\titlesf\sfbshape{17}{\magstep1}{OT1}
   1867 \let\titlebf=\titlerm
   1868 \setfont\titlesc\scbshape{10}{\magstep4}{OT1}
   1869 \font\titlei=cmmi12 scaled \magstep3
   1870 \font\titlesy=cmsy10 scaled \magstep4
   1871 \def\titleecsize{2074}
   1872 
   1873 % Chapter (and unnumbered) fonts (17.28pt).
   1874 \def\chapnominalsize{17pt}
   1875 \setfont\chaprm\rmbshape{12}{\magstep2}{OT1}
   1876 \setfont\chapit\itbshape{10}{\magstep3}{OT1IT}
   1877 \setfont\chapsl\slbshape{10}{\magstep3}{OT1}
   1878 \setfont\chaptt\ttbshape{12}{\magstep2}{OT1TT}
   1879 \setfont\chapttsl\ttslshape{10}{\magstep3}{OT1TT}
   1880 \setfont\chapsf\sfbshape{17}{1000}{OT1}
   1881 \let\chapbf=\chaprm
   1882 \setfont\chapsc\scbshape{10}{\magstep3}{OT1}
   1883 \font\chapi=cmmi12 scaled \magstep2
   1884 \font\chapsy=cmsy10 scaled \magstep3
   1885 \def\chapecsize{1728}
   1886 
   1887 % Section fonts (14.4pt).
   1888 \def\secnominalsize{14pt}
   1889 \setfont\secrm\rmbshape{12}{\magstep1}{OT1}
   1890 \setfont\secit\itbshape{10}{\magstep2}{OT1IT}
   1891 \setfont\secsl\slbshape{10}{\magstep2}{OT1}
   1892 \setfont\sectt\ttbshape{12}{\magstep1}{OT1TT}
   1893 \setfont\secttsl\ttslshape{10}{\magstep2}{OT1TT}
   1894 \setfont\secsf\sfbshape{12}{\magstep1}{OT1}
   1895 \let\secbf\secrm
   1896 \setfont\secsc\scbshape{10}{\magstep2}{OT1}
   1897 \font\seci=cmmi12 scaled \magstep1
   1898 \font\secsy=cmsy10 scaled \magstep2
   1899 \def\sececsize{1440}
   1900 
   1901 % Subsection fonts (13.15pt).
   1902 \def\ssecnominalsize{13pt}
   1903 \setfont\ssecrm\rmbshape{12}{\magstephalf}{OT1}
   1904 \setfont\ssecit\itbshape{10}{1315}{OT1IT}
   1905 \setfont\ssecsl\slbshape{10}{1315}{OT1}
   1906 \setfont\ssectt\ttbshape{12}{\magstephalf}{OT1TT}
   1907 \setfont\ssecttsl\ttslshape{10}{1315}{OT1TT}
   1908 \setfont\ssecsf\sfbshape{12}{\magstephalf}{OT1}
   1909 \let\ssecbf\ssecrm
   1910 \setfont\ssecsc\scbshape{10}{1315}{OT1}
   1911 \font\sseci=cmmi12 scaled \magstephalf
   1912 \font\ssecsy=cmsy10 scaled 1315
   1913 \def\ssececsize{1200}
   1914 
   1915 % Reduced fonts for @acro in text (10pt).
   1916 \def\reducednominalsize{10pt}
   1917 \setfont\reducedrm\rmshape{10}{1000}{OT1}
   1918 \setfont\reducedtt\ttshape{10}{1000}{OT1TT}
   1919 \setfont\reducedbf\bfshape{10}{1000}{OT1}
   1920 \setfont\reducedit\itshape{10}{1000}{OT1IT}
   1921 \setfont\reducedsl\slshape{10}{1000}{OT1}
   1922 \setfont\reducedsf\sfshape{10}{1000}{OT1}
   1923 \setfont\reducedsc\scshape{10}{1000}{OT1}
   1924 \setfont\reducedttsl\ttslshape{10}{1000}{OT1TT}
   1925 \font\reducedi=cmmi10
   1926 \font\reducedsy=cmsy10
   1927 \def\reducedecsize{1000}
   1928 
   1929 \textleading = 13.2pt % line spacing for 11pt CM
   1930 \textfonts            % reset the current fonts
   1931 \rm
   1932 } % end of 11pt text font size definitions, \definetextfontsizexi
   1933 
   1934 
   1935 % Definitions to make the main text be 10pt Computer Modern, with
   1936 % section, chapter, etc., sizes following suit.  This is for the GNU
   1937 % Press printing of the Emacs 22 manual.  Maybe other manuals in the
   1938 % future.  Used with @smallbook, which sets the leading to 12pt.
   1939 %
   1940 \def\definetextfontsizex{%
   1941 % Text fonts (10pt).
   1942 \def\textnominalsize{10pt}
   1943 \edef\mainmagstep{1000}
   1944 \setfont\textrm\rmshape{10}{\mainmagstep}{OT1}
   1945 \setfont\texttt\ttshape{10}{\mainmagstep}{OT1TT}
   1946 \setfont\textbf\bfshape{10}{\mainmagstep}{OT1}
   1947 \setfont\textit\itshape{10}{\mainmagstep}{OT1IT}
   1948 \setfont\textsl\slshape{10}{\mainmagstep}{OT1}
   1949 \setfont\textsf\sfshape{10}{\mainmagstep}{OT1}
   1950 \setfont\textsc\scshape{10}{\mainmagstep}{OT1}
   1951 \setfont\textttsl\ttslshape{10}{\mainmagstep}{OT1TT}
   1952 \font\texti=cmmi10 scaled \mainmagstep
   1953 \font\textsy=cmsy10 scaled \mainmagstep
   1954 \def\textecsize{1000}
   1955 
   1956 % A few fonts for @defun names and args.
   1957 \setfont\defbf\bfshape{10}{\magstephalf}{OT1}
   1958 \setfont\deftt\ttshape{10}{\magstephalf}{OT1TT}
   1959 \setfont\defttsl\ttslshape{10}{\magstephalf}{OT1TT}
   1960 \def\df{\let\tentt=\deftt \let\tenbf = \defbf \let\tenttsl=\defttsl \bf}
   1961 
   1962 % Fonts for indices, footnotes, small examples (9pt).
   1963 \def\smallnominalsize{9pt}
   1964 \setfont\smallrm\rmshape{9}{1000}{OT1}
   1965 \setfont\smalltt\ttshape{9}{1000}{OT1TT}
   1966 \setfont\smallbf\bfshape{10}{900}{OT1}
   1967 \setfont\smallit\itshape{9}{1000}{OT1IT}
   1968 \setfont\smallsl\slshape{9}{1000}{OT1}
   1969 \setfont\smallsf\sfshape{9}{1000}{OT1}
   1970 \setfont\smallsc\scshape{10}{900}{OT1}
   1971 \setfont\smallttsl\ttslshape{10}{900}{OT1TT}
   1972 \font\smalli=cmmi9
   1973 \font\smallsy=cmsy9
   1974 \def\smallecsize{0900}
   1975 
   1976 % Fonts for small examples (8pt).
   1977 \def\smallernominalsize{8pt}
   1978 \setfont\smallerrm\rmshape{8}{1000}{OT1}
   1979 \setfont\smallertt\ttshape{8}{1000}{OT1TT}
   1980 \setfont\smallerbf\bfshape{10}{800}{OT1}
   1981 \setfont\smallerit\itshape{8}{1000}{OT1IT}
   1982 \setfont\smallersl\slshape{8}{1000}{OT1}
   1983 \setfont\smallersf\sfshape{8}{1000}{OT1}
   1984 \setfont\smallersc\scshape{10}{800}{OT1}
   1985 \setfont\smallerttsl\ttslshape{10}{800}{OT1TT}
   1986 \font\smalleri=cmmi8
   1987 \font\smallersy=cmsy8
   1988 \def\smallerecsize{0800}
   1989 
   1990 % Fonts for title page (20.4pt):
   1991 \def\titlenominalsize{20pt}
   1992 \setfont\titlerm\rmbshape{12}{\magstep3}{OT1}
   1993 \setfont\titleit\itbshape{10}{\magstep4}{OT1IT}
   1994 \setfont\titlesl\slbshape{10}{\magstep4}{OT1}
   1995 \setfont\titlett\ttbshape{12}{\magstep3}{OT1TT}
   1996 \setfont\titlettsl\ttslshape{10}{\magstep4}{OT1TT}
   1997 \setfont\titlesf\sfbshape{17}{\magstep1}{OT1}
   1998 \let\titlebf=\titlerm
   1999 \setfont\titlesc\scbshape{10}{\magstep4}{OT1}
   2000 \font\titlei=cmmi12 scaled \magstep3
   2001 \font\titlesy=cmsy10 scaled \magstep4
   2002 \def\titleecsize{2074}
   2003 
   2004 % Chapter fonts (14.4pt).
   2005 \def\chapnominalsize{14pt}
   2006 \setfont\chaprm\rmbshape{12}{\magstep1}{OT1}
   2007 \setfont\chapit\itbshape{10}{\magstep2}{OT1IT}
   2008 \setfont\chapsl\slbshape{10}{\magstep2}{OT1}
   2009 \setfont\chaptt\ttbshape{12}{\magstep1}{OT1TT}
   2010 \setfont\chapttsl\ttslshape{10}{\magstep2}{OT1TT}
   2011 \setfont\chapsf\sfbshape{12}{\magstep1}{OT1}
   2012 \let\chapbf\chaprm
   2013 \setfont\chapsc\scbshape{10}{\magstep2}{OT1}
   2014 \font\chapi=cmmi12 scaled \magstep1
   2015 \font\chapsy=cmsy10 scaled \magstep2
   2016 \def\chapecsize{1440}
   2017 
   2018 % Section fonts (12pt).
   2019 \def\secnominalsize{12pt}
   2020 \setfont\secrm\rmbshape{12}{1000}{OT1}
   2021 \setfont\secit\itbshape{10}{\magstep1}{OT1IT}
   2022 \setfont\secsl\slbshape{10}{\magstep1}{OT1}
   2023 \setfont\sectt\ttbshape{12}{1000}{OT1TT}
   2024 \setfont\secttsl\ttslshape{10}{\magstep1}{OT1TT}
   2025 \setfont\secsf\sfbshape{12}{1000}{OT1}
   2026 \let\secbf\secrm
   2027 \setfont\secsc\scbshape{10}{\magstep1}{OT1}
   2028 \font\seci=cmmi12
   2029 \font\secsy=cmsy10 scaled \magstep1
   2030 \def\sececsize{1200}
   2031 
   2032 % Subsection fonts (10pt).
   2033 \def\ssecnominalsize{10pt}
   2034 \setfont\ssecrm\rmbshape{10}{1000}{OT1}
   2035 \setfont\ssecit\itbshape{10}{1000}{OT1IT}
   2036 \setfont\ssecsl\slbshape{10}{1000}{OT1}
   2037 \setfont\ssectt\ttbshape{10}{1000}{OT1TT}
   2038 \setfont\ssecttsl\ttslshape{10}{1000}{OT1TT}
   2039 \setfont\ssecsf\sfbshape{10}{1000}{OT1}
   2040 \let\ssecbf\ssecrm
   2041 \setfont\ssecsc\scbshape{10}{1000}{OT1}
   2042 \font\sseci=cmmi10
   2043 \font\ssecsy=cmsy10
   2044 \def\ssececsize{1000}
   2045 
   2046 % Reduced fonts for @acro in text (9pt).
   2047 \def\reducednominalsize{9pt}
   2048 \setfont\reducedrm\rmshape{9}{1000}{OT1}
   2049 \setfont\reducedtt\ttshape{9}{1000}{OT1TT}
   2050 \setfont\reducedbf\bfshape{10}{900}{OT1}
   2051 \setfont\reducedit\itshape{9}{1000}{OT1IT}
   2052 \setfont\reducedsl\slshape{9}{1000}{OT1}
   2053 \setfont\reducedsf\sfshape{9}{1000}{OT1}
   2054 \setfont\reducedsc\scshape{10}{900}{OT1}
   2055 \setfont\reducedttsl\ttslshape{10}{900}{OT1TT}
   2056 \font\reducedi=cmmi9
   2057 \font\reducedsy=cmsy9
   2058 \def\reducedecsize{0900}
   2059 
   2060 \divide\parskip by 2  % reduce space between paragraphs
   2061 \textleading = 12pt   % line spacing for 10pt CM
   2062 \textfonts            % reset the current fonts
   2063 \rm
   2064 } % end of 10pt text font size definitions, \definetextfontsizex
   2065 
   2066 
   2067 % We provide the user-level command
   2068 %   @fonttextsize 10
   2069 % (or 11) to redefine the text font size.  pt is assumed.
   2070 %
   2071 \def\xiword{11}
   2072 \def\xword{10}
   2073 \def\xwordpt{10pt}
   2074 %
   2075 \parseargdef\fonttextsize{%
   2076   \def\textsizearg{#1}%
   2077   %\wlog{doing @fonttextsize \textsizearg}%
   2078   %
   2079   % Set \globaldefs so that documents can use this inside @tex, since
   2080   % makeinfo 4.8 does not support it, but we need it nonetheless.
   2081   %
   2082  \begingroup \globaldefs=1
   2083   \ifx\textsizearg\xword \definetextfontsizex
   2084   \else \ifx\textsizearg\xiword \definetextfontsizexi
   2085   \else
   2086     \errhelp=\EMsimple
   2087     \errmessage{@fonttextsize only supports `10' or `11', not `\textsizearg'}
   2088   \fi\fi
   2089  \endgroup
   2090 }
   2091 
   2092 
   2093 % In order for the font changes to affect most math symbols and letters,
   2094 % we have to define the \textfont of the standard families.  Since
   2095 % texinfo doesn't allow for producing subscripts and superscripts except
   2096 % in the main text, we don't bother to reset \scriptfont and
   2097 % \scriptscriptfont (which would also require loading a lot more fonts).
   2098 %
   2099 \def\resetmathfonts{%
   2100   \textfont0=\tenrm \textfont1=\teni \textfont2=\tensy
   2101   \textfont\itfam=\tenit \textfont\slfam=\tensl \textfont\bffam=\tenbf
   2102   \textfont\ttfam=\tentt \textfont\sffam=\tensf
   2103 }
   2104 
   2105 % The font-changing commands redefine the meanings of \tenSTYLE, instead
   2106 % of just \STYLE.  We do this because \STYLE needs to also set the
   2107 % current \fam for math mode.  Our \STYLE (e.g., \rm) commands hardwire
   2108 % \tenSTYLE to set the current font.
   2109 %
   2110 % Each font-changing command also sets the names \lsize (one size lower)
   2111 % and \lllsize (three sizes lower).  These relative commands are used in
   2112 % the LaTeX logo and acronyms.
   2113 %
   2114 % This all needs generalizing, badly.
   2115 %
   2116 \def\textfonts{%
   2117   \let\tenrm=\textrm \let\tenit=\textit \let\tensl=\textsl
   2118   \let\tenbf=\textbf \let\tentt=\texttt \let\smallcaps=\textsc
   2119   \let\tensf=\textsf \let\teni=\texti \let\tensy=\textsy
   2120   \let\tenttsl=\textttsl
   2121   \def\curfontsize{text}%
   2122   \def\lsize{reduced}\def\lllsize{smaller}%
   2123   \resetmathfonts \setleading{\textleading}}
   2124 \def\titlefonts{%
   2125   \let\tenrm=\titlerm \let\tenit=\titleit \let\tensl=\titlesl
   2126   \let\tenbf=\titlebf \let\tentt=\titlett \let\smallcaps=\titlesc
   2127   \let\tensf=\titlesf \let\teni=\titlei \let\tensy=\titlesy
   2128   \let\tenttsl=\titlettsl
   2129   \def\curfontsize{title}%
   2130   \def\lsize{chap}\def\lllsize{subsec}%
   2131   \resetmathfonts \setleading{27pt}}
   2132 \def\titlefont#1{{\titlefonts\rmisbold #1}}
   2133 \def\chapfonts{%
   2134   \let\tenrm=\chaprm \let\tenit=\chapit \let\tensl=\chapsl
   2135   \let\tenbf=\chapbf \let\tentt=\chaptt \let\smallcaps=\chapsc
   2136   \let\tensf=\chapsf \let\teni=\chapi \let\tensy=\chapsy
   2137   \let\tenttsl=\chapttsl
   2138   \def\curfontsize{chap}%
   2139   \def\lsize{sec}\def\lllsize{text}%
   2140   \resetmathfonts \setleading{19pt}}
   2141 \def\secfonts{%
   2142   \let\tenrm=\secrm \let\tenit=\secit \let\tensl=\secsl
   2143   \let\tenbf=\secbf \let\tentt=\sectt \let\smallcaps=\secsc
   2144   \let\tensf=\secsf \let\teni=\seci \let\tensy=\secsy
   2145   \let\tenttsl=\secttsl
   2146   \def\curfontsize{sec}%
   2147   \def\lsize{subsec}\def\lllsize{reduced}%
   2148   \resetmathfonts \setleading{16pt}}
   2149 \def\subsecfonts{%
   2150   \let\tenrm=\ssecrm \let\tenit=\ssecit \let\tensl=\ssecsl
   2151   \let\tenbf=\ssecbf \let\tentt=\ssectt \let\smallcaps=\ssecsc
   2152   \let\tensf=\ssecsf \let\teni=\sseci \let\tensy=\ssecsy
   2153   \let\tenttsl=\ssecttsl
   2154   \def\curfontsize{ssec}%
   2155   \def\lsize{text}\def\lllsize{small}%
   2156   \resetmathfonts \setleading{15pt}}
   2157 \let\subsubsecfonts = \subsecfonts
   2158 \def\reducedfonts{%
   2159   \let\tenrm=\reducedrm \let\tenit=\reducedit \let\tensl=\reducedsl
   2160   \let\tenbf=\reducedbf \let\tentt=\reducedtt \let\reducedcaps=\reducedsc
   2161   \let\tensf=\reducedsf \let\teni=\reducedi \let\tensy=\reducedsy
   2162   \let\tenttsl=\reducedttsl
   2163   \def\curfontsize{reduced}%
   2164   \def\lsize{small}\def\lllsize{smaller}%
   2165   \resetmathfonts \setleading{10.5pt}}
   2166 \def\smallfonts{%
   2167   \let\tenrm=\smallrm \let\tenit=\smallit \let\tensl=\smallsl
   2168   \let\tenbf=\smallbf \let\tentt=\smalltt \let\smallcaps=\smallsc
   2169   \let\tensf=\smallsf \let\teni=\smalli \let\tensy=\smallsy
   2170   \let\tenttsl=\smallttsl
   2171   \def\curfontsize{small}%
   2172   \def\lsize{smaller}\def\lllsize{smaller}%
   2173   \resetmathfonts \setleading{10.5pt}}
   2174 \def\smallerfonts{%
   2175   \let\tenrm=\smallerrm \let\tenit=\smallerit \let\tensl=\smallersl
   2176   \let\tenbf=\smallerbf \let\tentt=\smallertt \let\smallcaps=\smallersc
   2177   \let\tensf=\smallersf \let\teni=\smalleri \let\tensy=\smallersy
   2178   \let\tenttsl=\smallerttsl
   2179   \def\curfontsize{smaller}%
   2180   \def\lsize{smaller}\def\lllsize{smaller}%
   2181   \resetmathfonts \setleading{9.5pt}}
   2182 
   2183 % Fonts for short table of contents.
   2184 \setfont\shortcontrm\rmshape{12}{1000}{OT1}
   2185 \setfont\shortcontbf\bfshape{10}{\magstep1}{OT1}  % no cmb12
   2186 \setfont\shortcontsl\slshape{12}{1000}{OT1}
   2187 \setfont\shortconttt\ttshape{12}{1000}{OT1TT}
   2188 
   2189 % Define these just so they can be easily changed for other fonts.
   2190 \def\angleleft{$\langle$}
   2191 \def\angleright{$\rangle$}
   2192 
   2193 % Set the fonts to use with the @small... environments.
   2194 \let\smallexamplefonts = \smallfonts
   2195 
   2196 % About \smallexamplefonts.  If we use \smallfonts (9pt), @smallexample
   2197 % can fit this many characters:
   2198 %   8.5x11=86   smallbook=72  a4=90  a5=69
   2199 % If we use \scriptfonts (8pt), then we can fit this many characters:
   2200 %   8.5x11=90+  smallbook=80  a4=90+  a5=77
   2201 % For me, subjectively, the few extra characters that fit aren't worth
   2202 % the additional smallness of 8pt.  So I'm making the default 9pt.
   2203 %
   2204 % By the way, for comparison, here's what fits with @example (10pt):
   2205 %   8.5x11=71  smallbook=60  a4=75  a5=58
   2206 % --karl, 24jan03.
   2207 
   2208 % Set up the default fonts, so we can use them for creating boxes.
   2209 %
   2210 \definetextfontsizexi
   2211 
   2212 
   2213 \message{markup,}
   2214 
   2215 % Check if we are currently using a typewriter font.  Since all the
   2216 % Computer Modern typewriter fonts have zero interword stretch (and
   2217 % shrink), and it is reasonable to expect all typewriter fonts to have
   2218 % this property, we can check that font parameter.
   2219 %
   2220 \def\ifmonospace{\ifdim\fontdimen3\font=0pt }
   2221 
   2222 % Markup style infrastructure.  \defmarkupstylesetup\INITMACRO will
   2223 % define and register \INITMACRO to be called on markup style changes.
   2224 % \INITMACRO can check \currentmarkupstyle for the innermost
   2225 % style and the set of \ifmarkupSTYLE switches for all styles
   2226 % currently in effect.
   2227 \newif\ifmarkupvar
   2228 \newif\ifmarkupsamp
   2229 \newif\ifmarkupkey
   2230 %\newif\ifmarkupfile % @file == @samp.
   2231 %\newif\ifmarkupoption % @option == @samp.
   2232 \newif\ifmarkupcode
   2233 \newif\ifmarkupkbd
   2234 %\newif\ifmarkupenv % @env == @code.
   2235 %\newif\ifmarkupcommand % @command == @code.
   2236 \newif\ifmarkuptex % @tex (and part of @math, for now).
   2237 \newif\ifmarkupexample
   2238 \newif\ifmarkupverb
   2239 \newif\ifmarkupverbatim
   2240 
   2241 \let\currentmarkupstyle\empty
   2242 
   2243 \def\setupmarkupstyle#1{%
   2244   \csname markup#1true\endcsname
   2245   \def\currentmarkupstyle{#1}%
   2246   \markupstylesetup
   2247 }
   2248 
   2249 \let\markupstylesetup\empty
   2250 
   2251 \def\defmarkupstylesetup#1{%
   2252   \expandafter\def\expandafter\markupstylesetup
   2253     \expandafter{\markupstylesetup #1}%
   2254   \def#1%
   2255 }
   2256 
   2257 % Markup style setup for left and right quotes.
   2258 \defmarkupstylesetup\markupsetuplq{%
   2259   \expandafter\let\expandafter \temp
   2260     \csname markupsetuplq\currentmarkupstyle\endcsname
   2261   \ifx\temp\relax \markupsetuplqdefault \else \temp \fi
   2262 }
   2263 
   2264 \defmarkupstylesetup\markupsetuprq{%
   2265   \expandafter\let\expandafter \temp
   2266     \csname markupsetuprq\currentmarkupstyle\endcsname
   2267   \ifx\temp\relax \markupsetuprqdefault \else \temp \fi
   2268 }
   2269 
   2270 {
   2271 \catcode`\'=\active
   2272 \catcode`\`=\active
   2273 
   2274 \gdef\markupsetuplqdefault{\let`\lq}
   2275 \gdef\markupsetuprqdefault{\let'\rq}
   2276 
   2277 \gdef\markupsetcodequoteleft{\let`\codequoteleft}
   2278 \gdef\markupsetcodequoteright{\let'\codequoteright}
   2279 }
   2280 
   2281 \let\markupsetuplqcode \markupsetcodequoteleft
   2282 \let\markupsetuprqcode \markupsetcodequoteright
   2283 %
   2284 \let\markupsetuplqexample \markupsetcodequoteleft
   2285 \let\markupsetuprqexample \markupsetcodequoteright
   2286 %
   2287 \let\markupsetuplqkbd     \markupsetcodequoteleft
   2288 \let\markupsetuprqkbd     \markupsetcodequoteright
   2289 %
   2290 \let\markupsetuplqsamp \markupsetcodequoteleft
   2291 \let\markupsetuprqsamp \markupsetcodequoteright
   2292 %
   2293 \let\markupsetuplqverb \markupsetcodequoteleft
   2294 \let\markupsetuprqverb \markupsetcodequoteright
   2295 %
   2296 \let\markupsetuplqverbatim \markupsetcodequoteleft
   2297 \let\markupsetuprqverbatim \markupsetcodequoteright
   2298 
   2299 % Allow an option to not use regular directed right quote/apostrophe
   2300 % (char 0x27), but instead the undirected quote from cmtt (char 0x0d).
   2301 % The undirected quote is ugly, so don't make it the default, but it
   2302 % works for pasting with more pdf viewers (at least evince), the
   2303 % lilypond developers report.  xpdf does work with the regular 0x27.
   2304 %
   2305 \def\codequoteright{%
   2306   \expandafter\ifx\csname SETtxicodequoteundirected\endcsname\relax
   2307     \expandafter\ifx\csname SETcodequoteundirected\endcsname\relax
   2308       '%
   2309     \else \char'15 \fi
   2310   \else \char'15 \fi
   2311 }
   2312 %
   2313 % and a similar option for the left quote char vs. a grave accent.
   2314 % Modern fonts display ASCII 0x60 as a grave accent, so some people like
   2315 % the code environments to do likewise.
   2316 %
   2317 \def\codequoteleft{%
   2318   \expandafter\ifx\csname SETtxicodequotebacktick\endcsname\relax
   2319     \expandafter\ifx\csname SETcodequotebacktick\endcsname\relax
   2320       % [Knuth] pp. 380,381,391
   2321       % \relax disables Spanish ligatures ?` and !` of \tt font.
   2322       \relax`%
   2323     \else \char'22 \fi
   2324   \else \char'22 \fi
   2325 }
   2326 
   2327 % Commands to set the quote options.
   2328 %
   2329 \parseargdef\codequoteundirected{%
   2330   \def\temp{#1}%
   2331   \ifx\temp\onword
   2332     \expandafter\let\csname SETtxicodequoteundirected\endcsname
   2333       = t%
   2334   \else\ifx\temp\offword
   2335     \expandafter\let\csname SETtxicodequoteundirected\endcsname
   2336       = \relax
   2337   \else
   2338     \errhelp = \EMsimple
   2339     \errmessage{Unknown @codequoteundirected value `\temp', must be on|off}%
   2340   \fi\fi
   2341 }
   2342 %
   2343 \parseargdef\codequotebacktick{%
   2344   \def\temp{#1}%
   2345   \ifx\temp\onword
   2346     \expandafter\let\csname SETtxicodequotebacktick\endcsname
   2347       = t%
   2348   \else\ifx\temp\offword
   2349     \expandafter\let\csname SETtxicodequotebacktick\endcsname
   2350       = \relax
   2351   \else
   2352     \errhelp = \EMsimple
   2353     \errmessage{Unknown @codequotebacktick value `\temp', must be on|off}%
   2354   \fi\fi
   2355 }
   2356 
   2357 % [Knuth] pp. 380,381,391, disable Spanish ligatures ?` and !` of \tt font.
   2358 \def\noligaturesquoteleft{\relax\lq}
   2359 
   2360 % Count depth in font-changes, for error checks
   2361 \newcount\fontdepth \fontdepth=0
   2362 
   2363 % Font commands.
   2364 
   2365 % #1 is the font command (\sl or \it), #2 is the text to slant.
   2366 % If we are in a monospaced environment, however, 1) always use \ttsl,
   2367 % and 2) do not add an italic correction.
   2368 \def\dosmartslant#1#2{%
   2369   \ifusingtt
   2370     {{\ttsl #2}\let\next=\relax}%
   2371     {\def\next{{#1#2}\futurelet\next\smartitaliccorrection}}%
   2372   \next
   2373 }
   2374 \def\smartslanted{\dosmartslant\sl}
   2375 \def\smartitalic{\dosmartslant\it}
   2376 
   2377 % Output an italic correction unless \next (presumed to be the following
   2378 % character) is such as not to need one.
   2379 \def\smartitaliccorrection{%
   2380   \ifx\next,%
   2381   \else\ifx\next-%
   2382   \else\ifx\next.%
   2383   \else\ifx\next\.%
   2384   \else\ifx\next\comma%
   2385   \else\ptexslash
   2386   \fi\fi\fi\fi\fi
   2387   \aftersmartic
   2388 }
   2389 
   2390 % Unconditional use \ttsl, and no ic.  @var is set to this for defuns.
   2391 \def\ttslanted#1{{\ttsl #1}}
   2392 
   2393 % @cite is like \smartslanted except unconditionally use \sl.  We never want
   2394 % ttsl for book titles, do we?
   2395 \def\cite#1{{\sl #1}\futurelet\next\smartitaliccorrection}
   2396 
   2397 \def\aftersmartic{}
   2398 \def\var#1{%
   2399   \let\saveaftersmartic = \aftersmartic
   2400   \def\aftersmartic{\null\let\aftersmartic=\saveaftersmartic}%
   2401   \smartslanted{#1}%
   2402 }
   2403 
   2404 \let\i=\smartitalic
   2405 \let\slanted=\smartslanted
   2406 \let\dfn=\smartslanted
   2407 \let\emph=\smartitalic
   2408 
   2409 % Explicit font changes: @r, @sc, undocumented @ii.
   2410 \def\r#1{{\rm #1}}              % roman font
   2411 \def\sc#1{{\smallcaps#1}}       % smallcaps font
   2412 \def\ii#1{{\it #1}}             % italic font
   2413 
   2414 % @b, explicit bold.  Also @strong.
   2415 \def\b#1{{\bf #1}}
   2416 \let\strong=\b
   2417 
   2418 % @sansserif, explicit sans.
   2419 \def\sansserif#1{{\sf #1}}
   2420 
   2421 % We can't just use \exhyphenpenalty, because that only has effect at
   2422 % the end of a paragraph.  Restore normal hyphenation at the end of the
   2423 % group within which \nohyphenation is presumably called.
   2424 %
   2425 \def\nohyphenation{\hyphenchar\font = -1  \aftergroup\restorehyphenation}
   2426 \def\restorehyphenation{\hyphenchar\font = `- }
   2427 
   2428 % Set sfcode to normal for the chars that usually have another value.
   2429 % Can't use plain's \frenchspacing because it uses the `\x notation, and
   2430 % sometimes \x has an active definition that messes things up.
   2431 %
   2432 \catcode`@=11
   2433   \def\plainfrenchspacing{%
   2434     \sfcode\dotChar  =\@m \sfcode\questChar=\@m \sfcode\exclamChar=\@m
   2435     \sfcode\colonChar=\@m \sfcode\semiChar =\@m \sfcode\commaChar =\@m
   2436     \def\endofsentencespacefactor{1000}% for @. and friends
   2437   }
   2438   \def\plainnonfrenchspacing{%
   2439     \sfcode`\.3000\sfcode`\?3000\sfcode`\!3000
   2440     \sfcode`\:2000\sfcode`\;1500\sfcode`\,1250
   2441     \def\endofsentencespacefactor{3000}% for @. and friends
   2442   }
   2443 \catcode`@=\other
   2444 \def\endofsentencespacefactor{3000}% default
   2445 
   2446 % @t, explicit typewriter.
   2447 \def\t#1{%
   2448   {\tt \rawbackslash \plainfrenchspacing #1}%
   2449   \null
   2450 }
   2451 
   2452 % @samp.
   2453 \def\samp#1{{\setupmarkupstyle{samp}\lq\tclose{#1}\rq\null}}
   2454 
   2455 % @indicateurl is \samp, that is, with quotes.
   2456 \let\indicateurl=\samp
   2457 
   2458 % @code (and similar) prints in typewriter, but with spaces the same
   2459 % size as normal in the surrounding text, without hyphenation, etc.
   2460 % This is a subroutine for that.
   2461 \def\tclose#1{%
   2462   {%
   2463     % Change normal interword space to be same as for the current font.
   2464     \spaceskip = \fontdimen2\font
   2465     %
   2466     % Switch to typewriter.
   2467     \tt
   2468     %
   2469     % But `\ ' produces the large typewriter interword space.
   2470     \def\ {{\spaceskip = 0pt{} }}%
   2471     %
   2472     % Turn off hyphenation.
   2473     \nohyphenation
   2474     %
   2475     \rawbackslash
   2476     \plainfrenchspacing
   2477     #1%
   2478   }%
   2479   \null % reset spacefactor to 1000
   2480 }
   2481 
   2482 % We *must* turn on hyphenation at `-' and `_' in @code.
   2483 % (But see \codedashfinish below.)
   2484 % Otherwise, it is too hard to avoid overfull hboxes
   2485 % in the Emacs manual, the Library manual, etc.
   2486 %
   2487 % Unfortunately, TeX uses one parameter (\hyphenchar) to control
   2488 % both hyphenation at - and hyphenation within words.
   2489 % We must therefore turn them both off (\tclose does that)
   2490 % and arrange explicitly to hyphenate at a dash. -- rms.
   2491 {
   2492   \catcode`\-=\active \catcode`\_=\active
   2493   \catcode`\'=\active \catcode`\`=\active
   2494   \global\let'=\rq \global\let`=\lq  % default definitions
   2495   %
   2496   \global\def\code{\begingroup
   2497     \setupmarkupstyle{code}%
   2498     % The following should really be moved into \setupmarkupstyle handlers.
   2499     \catcode\dashChar=\active  \catcode\underChar=\active
   2500     \ifallowcodebreaks
   2501      \let-\codedash
   2502      \let_\codeunder
   2503     \else
   2504      \let-\normaldash
   2505      \let_\realunder
   2506     \fi
   2507     % Given -foo (with a single dash), we do not want to allow a break
   2508     % after the hyphen.
   2509     \global\let\codedashprev=\codedash
   2510     %
   2511     \codex
   2512   }
   2513   %
   2514   \gdef\codedash{\futurelet\next\codedashfinish}
   2515   \gdef\codedashfinish{%
   2516     \normaldash % always output the dash character itself.
   2517     %
   2518     % Now, output a discretionary to allow a line break, unless
   2519     % (a) the next character is a -, or
   2520     % (b) the preceding character is a -.
   2521     % E.g., given --posix, we do not want to allow a break after either -.
   2522     % Given --foo-bar, we do want to allow a break between the - and the b.
   2523     \ifx\next\codedash \else
   2524       \ifx\codedashprev\codedash
   2525       \else \discretionary{}{}{}\fi
   2526     \fi
   2527     % we need the space after the = for the case when \next itself is a
   2528     % space token; it would get swallowed otherwise.  As in @code{- a}.
   2529     \global\let\codedashprev= \next
   2530   }
   2531 }
   2532 \def\normaldash{-}
   2533 %
   2534 \def\codex #1{\tclose{#1}\endgroup}
   2535 
   2536 \def\codeunder{%
   2537   % this is all so @math{@code{var_name}+1} can work.  In math mode, _
   2538   % is "active" (mathcode"8000) and \normalunderscore (or \char95, etc.)
   2539   % will therefore expand the active definition of _, which is us
   2540   % (inside @code that is), therefore an endless loop.
   2541   \ifusingtt{\ifmmode
   2542                \mathchar"075F % class 0=ordinary, family 7=ttfam, pos 0x5F=_.
   2543              \else\normalunderscore \fi
   2544              \discretionary{}{}{}}%
   2545             {\_}%
   2546 }
   2547 
   2548 % An additional complication: the above will allow breaks after, e.g.,
   2549 % each of the four underscores in __typeof__.  This is bad.
   2550 % @allowcodebreaks provides a document-level way to turn breaking at -
   2551 % and _ on and off.
   2552 %
   2553 \newif\ifallowcodebreaks  \allowcodebreakstrue
   2554 
   2555 \def\keywordtrue{true}
   2556 \def\keywordfalse{false}
   2557 
   2558 \parseargdef\allowcodebreaks{%
   2559   \def\txiarg{#1}%
   2560   \ifx\txiarg\keywordtrue
   2561     \allowcodebreakstrue
   2562   \else\ifx\txiarg\keywordfalse
   2563     \allowcodebreaksfalse
   2564   \else
   2565     \errhelp = \EMsimple
   2566     \errmessage{Unknown @allowcodebreaks option `\txiarg', must be true|false}%
   2567   \fi\fi
   2568 }
   2569 
   2570 % For @command, @env, @file, @option quotes seem unnecessary,
   2571 % so use \code rather than \samp.
   2572 \let\command=\code
   2573 \let\env=\code
   2574 \let\file=\code
   2575 \let\option=\code
   2576 
   2577 % @uref (abbreviation for `urlref') takes an optional (comma-separated)
   2578 % second argument specifying the text to display and an optional third
   2579 % arg as text to display instead of (rather than in addition to) the url
   2580 % itself.  First (mandatory) arg is the url.
   2581 % (This \urefnobreak definition isn't used now, leaving it for a while
   2582 % for comparison.)
   2583 \def\urefnobreak#1{\dourefnobreak #1,,,\finish}
   2584 \def\dourefnobreak#1,#2,#3,#4\finish{\begingroup
   2585   \unsepspaces
   2586   \pdfurl{#1}%
   2587   \setbox0 = \hbox{\ignorespaces #3}%
   2588   \ifdim\wd0 > 0pt
   2589     \unhbox0 % third arg given, show only that
   2590   \else
   2591     \setbox0 = \hbox{\ignorespaces #2}%
   2592     \ifdim\wd0 > 0pt
   2593       \ifpdf
   2594         \unhbox0             % PDF: 2nd arg given, show only it
   2595       \else
   2596         \unhbox0\ (\code{#1})% DVI: 2nd arg given, show both it and url
   2597       \fi
   2598     \else
   2599       \code{#1}% only url given, so show it
   2600     \fi
   2601   \fi
   2602   \endlink
   2603 \endgroup}
   2604 
   2605 % This \urefbreak definition is the active one.
   2606 \def\urefbreak{\begingroup \urefcatcodes \dourefbreak}
   2607 \let\uref=\urefbreak
   2608 \def\dourefbreak#1{\urefbreakfinish #1,,,\finish}
   2609 \def\urefbreakfinish#1,#2,#3,#4\finish{% doesn't work in @example
   2610   \unsepspaces
   2611   \pdfurl{#1}%
   2612   \setbox0 = \hbox{\ignorespaces #3}%
   2613   \ifdim\wd0 > 0pt
   2614     \unhbox0 % third arg given, show only that
   2615   \else
   2616     \setbox0 = \hbox{\ignorespaces #2}%
   2617     \ifdim\wd0 > 0pt
   2618       \ifpdf
   2619         \unhbox0             % PDF: 2nd arg given, show only it
   2620       \else
   2621         \unhbox0\ (\urefcode{#1})% DVI: 2nd arg given, show both it and url
   2622       \fi
   2623     \else
   2624       \urefcode{#1}% only url given, so show it
   2625     \fi
   2626   \fi
   2627   \endlink
   2628 \endgroup}
   2629 
   2630 % Allow line breaks around only a few characters (only).
   2631 \def\urefcatcodes{%
   2632   \catcode\ampChar=\active   \catcode\dotChar=\active
   2633   \catcode\hashChar=\active  \catcode\questChar=\active
   2634   \catcode\slashChar=\active
   2635 }
   2636 {
   2637   \urefcatcodes
   2638   %
   2639   \global\def\urefcode{\begingroup
   2640     \setupmarkupstyle{code}%
   2641     \urefcatcodes
   2642     \let&\urefcodeamp
   2643     \let.\urefcodedot
   2644     \let#\urefcodehash
   2645     \let?\urefcodequest
   2646     \let/\urefcodeslash
   2647     \codex
   2648   }
   2649   %
   2650   % By default, they are just regular characters.
   2651   \global\def&{\normalamp}
   2652   \global\def.{\normaldot}
   2653   \global\def#{\normalhash}
   2654   \global\def?{\normalquest}
   2655   \global\def/{\normalslash}
   2656 }
   2657 
   2658 % we put a little stretch before and after the breakable chars, to help
   2659 % line breaking of long url's.  The unequal skips make look better in
   2660 % cmtt at least, especially for dots.
   2661 \def\urefprestretch{\urefprebreak \hskip0pt plus.13em }
   2662 \def\urefpoststretch{\urefpostbreak \hskip0pt plus.1em }
   2663 %
   2664 \def\urefcodeamp{\urefprestretch \&\urefpoststretch}
   2665 \def\urefcodedot{\urefprestretch .\urefpoststretch}
   2666 \def\urefcodehash{\urefprestretch \#\urefpoststretch}
   2667 \def\urefcodequest{\urefprestretch ?\urefpoststretch}
   2668 \def\urefcodeslash{\futurelet\next\urefcodeslashfinish}
   2669 {
   2670   \catcode`\/=\active
   2671   \global\def\urefcodeslashfinish{%
   2672     \urefprestretch \slashChar
   2673     % Allow line break only after the final / in a sequence of
   2674     % slashes, to avoid line break between the slashes in http://.
   2675     \ifx\next/\else \urefpoststretch \fi
   2676   }
   2677 }
   2678 
   2679 % One more complication: by default we'll break after the special
   2680 % characters, but some people like to break before the special chars, so
   2681 % allow that.  Also allow no breaking at all, for manual control.
   2682 %
   2683 \parseargdef\urefbreakstyle{%
   2684   \def\txiarg{#1}%
   2685   \ifx\txiarg\wordnone
   2686     \def\urefprebreak{\nobreak}\def\urefpostbreak{\nobreak}
   2687   \else\ifx\txiarg\wordbefore
   2688     \def\urefprebreak{\allowbreak}\def\urefpostbreak{\nobreak}
   2689   \else\ifx\txiarg\wordafter
   2690     \def\urefprebreak{\nobreak}\def\urefpostbreak{\allowbreak}
   2691   \else
   2692     \errhelp = \EMsimple
   2693     \errmessage{Unknown @urefbreakstyle setting `\txiarg'}%
   2694   \fi\fi\fi
   2695 }
   2696 \def\wordafter{after}
   2697 \def\wordbefore{before}
   2698 \def\wordnone{none}
   2699 
   2700 \urefbreakstyle after
   2701 
   2702 % @url synonym for @uref, since that's how everyone uses it.
   2703 %
   2704 \let\url=\uref
   2705 
   2706 % rms does not like angle brackets --karl, 17may97.
   2707 % So now @email is just like @uref, unless we are pdf.
   2708 %
   2709 %\def\email#1{\angleleft{\tt #1}\angleright}
   2710 \ifpdf
   2711   \def\email#1{\doemail#1,,\finish}
   2712   \def\doemail#1,#2,#3\finish{\begingroup
   2713     \unsepspaces
   2714     \pdfurl{mailto:#1}%
   2715     \setbox0 = \hbox{\ignorespaces #2}%
   2716     \ifdim\wd0>0pt\unhbox0\else\code{#1}\fi
   2717     \endlink
   2718   \endgroup}
   2719 \else
   2720   \let\email=\uref
   2721 \fi
   2722 
   2723 % @kbdinputstyle -- arg is `distinct' (@kbd uses slanted tty font always),
   2724 %   `example' (@kbd uses ttsl only inside of @example and friends),
   2725 %   or `code' (@kbd uses normal tty font always).
   2726 \parseargdef\kbdinputstyle{%
   2727   \def\txiarg{#1}%
   2728   \ifx\txiarg\worddistinct
   2729     \gdef\kbdexamplefont{\ttsl}\gdef\kbdfont{\ttsl}%
   2730   \else\ifx\txiarg\wordexample
   2731     \gdef\kbdexamplefont{\ttsl}\gdef\kbdfont{\tt}%
   2732   \else\ifx\txiarg\wordcode
   2733     \gdef\kbdexamplefont{\tt}\gdef\kbdfont{\tt}%
   2734   \else
   2735     \errhelp = \EMsimple
   2736     \errmessage{Unknown @kbdinputstyle setting `\txiarg'}%
   2737   \fi\fi\fi
   2738 }
   2739 \def\worddistinct{distinct}
   2740 \def\wordexample{example}
   2741 \def\wordcode{code}
   2742 
   2743 % Default is `distinct'.
   2744 \kbdinputstyle distinct
   2745 
   2746 % @kbd is like @code, except that if the argument is just one @key command,
   2747 % then @kbd has no effect.
   2748 \def\kbd#1{{\def\look{#1}\expandafter\kbdsub\look??\par}}
   2749 
   2750 \def\xkey{\key}
   2751 \def\kbdsub#1#2#3\par{%
   2752   \def\one{#1}\def\three{#3}\def\threex{??}%
   2753   \ifx\one\xkey\ifx\threex\three \key{#2}%
   2754   \else{\tclose{\kbdfont\setupmarkupstyle{kbd}\look}}\fi
   2755   \else{\tclose{\kbdfont\setupmarkupstyle{kbd}\look}}\fi
   2756 }
   2757 
   2758 % definition of @key that produces a lozenge.  Doesn't adjust to text size.
   2759 %\setfont\keyrm\rmshape{8}{1000}{OT1}
   2760 %\font\keysy=cmsy9
   2761 %\def\key#1{{\keyrm\textfont2=\keysy \leavevmode\hbox{%
   2762 %  \raise0.4pt\hbox{\angleleft}\kern-.08em\vtop{%
   2763 %    \vbox{\hrule\kern-0.4pt
   2764 %     \hbox{\raise0.4pt\hbox{\vphantom{\angleleft}}#1}}%
   2765 %    \kern-0.4pt\hrule}%
   2766 %  \kern-.06em\raise0.4pt\hbox{\angleright}}}}
   2767 
   2768 % definition of @key with no lozenge.  If the current font is already
   2769 % monospace, don't change it; that way, we respect @kbdinputstyle.  But
   2770 % if it isn't monospace, then use \tt.
   2771 %
   2772 \def\key#1{{\setupmarkupstyle{key}%
   2773   \nohyphenation
   2774   \ifmonospace\else\tt\fi
   2775   #1}\null}
   2776 
   2777 % @clicksequence{File @click{} Open ...}
   2778 \def\clicksequence#1{\begingroup #1\endgroup}
   2779 
   2780 % @clickstyle @arrow   (by default)
   2781 \parseargdef\clickstyle{\def\click{#1}}
   2782 \def\click{\arrow}
   2783 
   2784 % Typeset a dimension, e.g., `in' or `pt'.  The only reason for the
   2785 % argument is to make the input look right: @dmn{pt} instead of @dmn{}pt.
   2786 %
   2787 \def\dmn#1{\thinspace #1}
   2788 
   2789 % @l was never documented to mean ``switch to the Lisp font'',
   2790 % and it is not used as such in any manual I can find.  We need it for
   2791 % Polish suppressed-l.  --karl, 22sep96.
   2792 %\def\l#1{{\li #1}\null}
   2793 
   2794 % @acronym for "FBI", "NATO", and the like.
   2795 % We print this one point size smaller, since it's intended for
   2796 % all-uppercase.
   2797 %
   2798 \def\acronym#1{\doacronym #1,,\finish}
   2799 \def\doacronym#1,#2,#3\finish{%
   2800   {\selectfonts\lsize #1}%
   2801   \def\temp{#2}%
   2802   \ifx\temp\empty \else
   2803     \space ({\unsepspaces \ignorespaces \temp \unskip})%
   2804   \fi
   2805   \null % reset \spacefactor=1000
   2806 }
   2807 
   2808 % @abbr for "Comput. J." and the like.
   2809 % No font change, but don't do end-of-sentence spacing.
   2810 %
   2811 \def\abbr#1{\doabbr #1,,\finish}
   2812 \def\doabbr#1,#2,#3\finish{%
   2813   {\plainfrenchspacing #1}%
   2814   \def\temp{#2}%
   2815   \ifx\temp\empty \else
   2816     \space ({\unsepspaces \ignorespaces \temp \unskip})%
   2817   \fi
   2818   \null % reset \spacefactor=1000
   2819 }
   2820 
   2821 % @asis just yields its argument.  Used with @table, for example.
   2822 %
   2823 \def\asis#1{#1}
   2824 
   2825 % @math outputs its argument in math mode.
   2826 %
   2827 % One complication: _ usually means subscripts, but it could also mean
   2828 % an actual _ character, as in @math{@var{some_variable} + 1}.  So make
   2829 % _ active, and distinguish by seeing if the current family is \slfam,
   2830 % which is what @var uses.
   2831 {
   2832   \catcode`\_ = \active
   2833   \gdef\mathunderscore{%
   2834     \catcode`\_=\active
   2835     \def_{\ifnum\fam=\slfam \_\else\sb\fi}%
   2836   }
   2837 }
   2838 % Another complication: we want \\ (and @\) to output a math (or tt) \.
   2839 % FYI, plain.tex uses \\ as a temporary control sequence (for no
   2840 % particular reason), but this is not advertised and we don't care.
   2841 %
   2842 % The \mathchar is class=0=ordinary, family=7=ttfam, position=5C=\.
   2843 \def\mathbackslash{\ifnum\fam=\ttfam \mathchar"075C \else\backslash \fi}
   2844 %
   2845 \def\math{%
   2846   \tex
   2847   \mathunderscore
   2848   \let\\ = \mathbackslash
   2849   \mathactive
   2850   % make the texinfo accent commands work in math mode
   2851   \let\"=\ddot
   2852   \let\'=\acute
   2853   \let\==\bar
   2854   \let\^=\hat
   2855   \let\`=\grave
   2856   \let\u=\breve
   2857   \let\v=\check
   2858   \let\~=\tilde
   2859   \let\dotaccent=\dot
   2860   $\finishmath
   2861 }
   2862 \def\finishmath#1{#1$\endgroup}  % Close the group opened by \tex.
   2863 
   2864 % Some active characters (such as <) are spaced differently in math.
   2865 % We have to reset their definitions in case the @math was an argument
   2866 % to a command which sets the catcodes (such as @item or @section).
   2867 %
   2868 {
   2869   \catcode`^ = \active
   2870   \catcode`< = \active
   2871   \catcode`> = \active
   2872   \catcode`+ = \active
   2873   \catcode`' = \active
   2874   \gdef\mathactive{%
   2875     \let^ = \ptexhat
   2876     \let< = \ptexless
   2877     \let> = \ptexgtr
   2878     \let+ = \ptexplus
   2879     \let' = \ptexquoteright
   2880   }
   2881 }
   2882 
   2883 % ctrl is no longer a Texinfo command, but leave this definition for fun.
   2884 \def\ctrl #1{{\tt \rawbackslash \hat}#1}
   2885 
   2886 % @inlinefmt{FMTNAME,PROCESSED-TEXT} and @inlineraw{FMTNAME,RAW-TEXT}.
   2887 % Ignore unless FMTNAME == tex; then it is like @iftex and @tex,
   2888 % except specified as a normal braced arg, so no newlines to worry about.
   2889 %
   2890 \def\outfmtnametex{tex}
   2891 %
   2892 \long\def\inlinefmt#1{\doinlinefmt #1,\finish}
   2893 \long\def\doinlinefmt#1,#2,\finish{%
   2894   \def\inlinefmtname{#1}%
   2895   \ifx\inlinefmtname\outfmtnametex \ignorespaces #2\fi
   2896 }
   2897 %
   2898 % @inlinefmtifelse{FMTNAME,THEN-TEXT,ELSE-TEXT} expands THEN-TEXT if
   2899 % FMTNAME is tex, else ELSE-TEXT.
   2900 \long\def\inlinefmtifelse#1{\doinlinefmtifelse #1,,,\finish}
   2901 \long\def\doinlinefmtifelse#1,#2,#3,#4,\finish{%
   2902   \def\inlinefmtname{#1}%
   2903   \ifx\inlinefmtname\outfmtnametex \ignorespaces #2\else \ignorespaces #3\fi
   2904 }
   2905 %
   2906 % For raw, must switch into @tex before parsing the argument, to avoid
   2907 % setting catcodes prematurely.  Doing it this way means that, for
   2908 % example, @inlineraw{html, foo{bar} gets a parse error instead of being
   2909 % ignored.  But this isn't important because if people want a literal
   2910 % *right* brace they would have to use a command anyway, so they may as
   2911 % well use a command to get a left brace too.  We could re-use the
   2912 % delimiter character idea from \verb, but it seems like overkill.
   2913 %
   2914 \long\def\inlineraw{\tex \doinlineraw}
   2915 \long\def\doinlineraw#1{\doinlinerawtwo #1,\finish}
   2916 \def\doinlinerawtwo#1,#2,\finish{%
   2917   \def\inlinerawname{#1}%
   2918   \ifx\inlinerawname\outfmtnametex \ignorespaces #2\fi
   2919   \endgroup % close group opened by \tex.
   2920 }
   2921 
   2922 % @inlineifset{VAR, TEXT} expands TEXT if VAR is @set.
   2923 %
   2924 \long\def\inlineifset#1{\doinlineifset #1,\finish}
   2925 \long\def\doinlineifset#1,#2,\finish{%
   2926   \def\inlinevarname{#1}%
   2927   \expandafter\ifx\csname SET\inlinevarname\endcsname\relax
   2928   \else\ignorespaces#2\fi
   2929 }
   2930 
   2931 % @inlineifclear{VAR, TEXT} expands TEXT if VAR is not @set.
   2932 %
   2933 \long\def\inlineifclear#1{\doinlineifclear #1,\finish}
   2934 \long\def\doinlineifclear#1,#2,\finish{%
   2935   \def\inlinevarname{#1}%
   2936   \expandafter\ifx\csname SET\inlinevarname\endcsname\relax \ignorespaces#2\fi
   2937 }
   2938 
   2939 
   2940 \message{glyphs,}
   2941 % and logos.
   2942 
   2943 % @@ prints an @, as does @atchar{}.
   2944 \def\@{\char64 }
   2945 \let\atchar=\@
   2946 
   2947 % @{ @} @lbracechar{} @rbracechar{} all generate brace characters.
   2948 % Unless we're in typewriter, use \ecfont because the CM text fonts do
   2949 % not have braces, and we don't want to switch into math.
   2950 \def\mylbrace{{\ifmonospace\else\ecfont\fi \char123}}
   2951 \def\myrbrace{{\ifmonospace\else\ecfont\fi \char125}}
   2952 \let\{=\mylbrace \let\lbracechar=\{
   2953 \let\}=\myrbrace \let\rbracechar=\}
   2954 \begingroup
   2955   % Definitions to produce \{ and \} commands for indices,
   2956   % and @{ and @} for the aux/toc files.
   2957   \catcode`\{ = \other \catcode`\} = \other
   2958   \catcode`\[ = 1 \catcode`\] = 2
   2959   \catcode`\! = 0 \catcode`\\ = \other
   2960   !gdef!lbracecmd[\{]%
   2961   !gdef!rbracecmd[\}]%
   2962   !gdef!lbraceatcmd[@{]%
   2963   !gdef!rbraceatcmd[@}]%
   2964 !endgroup
   2965 
   2966 % @comma{} to avoid , parsing problems.
   2967 \let\comma = ,
   2968 
   2969 % Accents: @, @dotaccent @ringaccent @ubaraccent @udotaccent
   2970 % Others are defined by plain TeX: @` @' @" @^ @~ @= @u @v @H.
   2971 \let\, = \ptexc
   2972 \let\dotaccent = \ptexdot
   2973 \def\ringaccent#1{{\accent23 #1}}
   2974 \let\tieaccent = \ptext
   2975 \let\ubaraccent = \ptexb
   2976 \let\udotaccent = \d
   2977 
   2978 % Other special characters: @questiondown @exclamdown @ordf @ordm
   2979 % Plain TeX defines: @AA @AE @O @OE @L (plus lowercase versions) @ss.
   2980 \def\questiondown{?`}
   2981 \def\exclamdown{!`}
   2982 \def\ordf{\leavevmode\raise1ex\hbox{\selectfonts\lllsize \underbar{a}}}
   2983 \def\ordm{\leavevmode\raise1ex\hbox{\selectfonts\lllsize \underbar{o}}}
   2984 
   2985 % Dotless i and dotless j, used for accents.
   2986 \def\imacro{i}
   2987 \def\jmacro{j}
   2988 \def\dotless#1{%
   2989   \def\temp{#1}%
   2990   \ifx\temp\imacro \ifmmode\imath \else\ptexi \fi
   2991   \else\ifx\temp\jmacro \ifmmode\jmath \else\j \fi
   2992   \else \errmessage{@dotless can be used only with i or j}%
   2993   \fi\fi
   2994 }
   2995 
   2996 % The \TeX{} logo, as in plain, but resetting the spacing so that a
   2997 % period following counts as ending a sentence.  (Idea found in latex.)
   2998 %
   2999 \edef\TeX{\TeX \spacefactor=1000 }
   3000 
   3001 % @LaTeX{} logo.  Not quite the same results as the definition in
   3002 % latex.ltx, since we use a different font for the raised A; it's most
   3003 % convenient for us to use an explicitly smaller font, rather than using
   3004 % the \scriptstyle font (since we don't reset \scriptstyle and
   3005 % \scriptscriptstyle).
   3006 %
   3007 \def\LaTeX{%
   3008   L\kern-.36em
   3009   {\setbox0=\hbox{T}%
   3010    \vbox to \ht0{\hbox{%
   3011      \ifx\textnominalsize\xwordpt
   3012        % for 10pt running text, \lllsize (8pt) is too small for the A in LaTeX.
   3013        % Revert to plain's \scriptsize, which is 7pt.
   3014        \count255=\the\fam $\fam\count255 \scriptstyle A$%
   3015      \else
   3016        % For 11pt, we can use our lllsize.
   3017        \selectfonts\lllsize A%
   3018      \fi
   3019      }%
   3020      \vss
   3021   }}%
   3022   \kern-.15em
   3023   \TeX
   3024 }
   3025 
   3026 % Some math mode symbols.
   3027 \def\bullet{$\ptexbullet$}
   3028 \def\geq{\ifmmode \ge\else $\ge$\fi}
   3029 \def\leq{\ifmmode \le\else $\le$\fi}
   3030 \def\minus{\ifmmode -\else $-$\fi}
   3031 
   3032 % @dots{} outputs an ellipsis using the current font.
   3033 % We do .5em per period so that it has the same spacing in the cm
   3034 % typewriter fonts as three actual period characters; on the other hand,
   3035 % in other typewriter fonts three periods are wider than 1.5em.  So do
   3036 % whichever is larger.
   3037 %
   3038 \def\dots{%
   3039   \leavevmode
   3040   \setbox0=\hbox{...}% get width of three periods
   3041   \ifdim\wd0 > 1.5em
   3042     \dimen0 = \wd0
   3043   \else
   3044     \dimen0 = 1.5em
   3045   \fi
   3046   \hbox to \dimen0{%
   3047     \hskip 0pt plus.25fil
   3048     .\hskip 0pt plus1fil
   3049     .\hskip 0pt plus1fil
   3050     .\hskip 0pt plus.5fil
   3051   }%
   3052 }
   3053 
   3054 % @enddots{} is an end-of-sentence ellipsis.
   3055 %
   3056 \def\enddots{%
   3057   \dots
   3058   \spacefactor=\endofsentencespacefactor
   3059 }
   3060 
   3061 % @point{}, @result{}, @expansion{}, @print{}, @equiv{}.
   3062 %
   3063 % Since these characters are used in examples, they should be an even number of
   3064 % \tt widths. Each \tt character is 1en, so two makes it 1em.
   3065 %
   3066 \def\point{$\star$}
   3067 \def\arrow{\leavevmode\raise.05ex\hbox to 1em{\hfil$\rightarrow$\hfil}}
   3068 \def\result{\leavevmode\raise.05ex\hbox to 1em{\hfil$\Rightarrow$\hfil}}
   3069 \def\expansion{\leavevmode\hbox to 1em{\hfil$\mapsto$\hfil}}
   3070 \def\print{\leavevmode\lower.1ex\hbox to 1em{\hfil$\dashv$\hfil}}
   3071 \def\equiv{\leavevmode\hbox to 1em{\hfil$\ptexequiv$\hfil}}
   3072 
   3073 % The @error{} command.
   3074 % Adapted from the TeXbook's \boxit.
   3075 %
   3076 \newbox\errorbox
   3077 %
   3078 {\tentt \global\dimen0 = 3em}% Width of the box.
   3079 \dimen2 = .55pt % Thickness of rules
   3080 % The text. (`r' is open on the right, `e' somewhat less so on the left.)
   3081 \setbox0 = \hbox{\kern-.75pt \reducedsf \putworderror\kern-1.5pt}
   3082 %
   3083 \setbox\errorbox=\hbox to \dimen0{\hfil
   3084    \hsize = \dimen0 \advance\hsize by -5.8pt % Space to left+right.
   3085    \advance\hsize by -2\dimen2 % Rules.
   3086    \vbox{%
   3087       \hrule height\dimen2
   3088       \hbox{\vrule width\dimen2 \kern3pt          % Space to left of text.
   3089          \vtop{\kern2.4pt \box0 \kern2.4pt}% Space above/below.
   3090          \kern3pt\vrule width\dimen2}% Space to right.
   3091       \hrule height\dimen2}
   3092     \hfil}
   3093 %
   3094 \def\error{\leavevmode\lower.7ex\copy\errorbox}
   3095 
   3096 % @pounds{} is a sterling sign, which Knuth put in the CM italic font.
   3097 %
   3098 \def\pounds{{\it\$}}
   3099 
   3100 % @euro{} comes from a separate font, depending on the current style.
   3101 % We use the free feym* fonts from the eurosym package by Henrik
   3102 % Theiling, which support regular, slanted, bold and bold slanted (and
   3103 % "outlined" (blackboard board, sort of) versions, which we don't need).
   3104 % It is available from https://www.ctan.org/tex-archive/fonts/eurosym.
   3105 %
   3106 % Although only regular is the truly official Euro symbol, we ignore
   3107 % that.  The Euro is designed to be slightly taller than the regular
   3108 % font height.
   3109 %
   3110 % feymr - regular
   3111 % feymo - slanted
   3112 % feybr - bold
   3113 % feybo - bold slanted
   3114 %
   3115 % There is no good (free) typewriter version, to my knowledge.
   3116 % A feymr10 euro is ~7.3pt wide, while a normal cmtt10 char is ~5.25pt wide.
   3117 % Hmm.
   3118 %
   3119 % Also doesn't work in math.  Do we need to do math with euro symbols?
   3120 % Hope not.
   3121 %
   3122 %
   3123 \def\euro{{\eurofont e}}
   3124 \def\eurofont{%
   3125   % We set the font at each command, rather than predefining it in
   3126   % \textfonts and the other font-switching commands, so that
   3127   % installations which never need the symbol don't have to have the
   3128   % font installed.
   3129   %
   3130   % There is only one designed size (nominal 10pt), so we always scale
   3131   % that to the current nominal size.
   3132   %
   3133   % By the way, simply using "at 1em" works for cmr10 and the like, but
   3134   % does not work for cmbx10 and other extended/shrunken fonts.
   3135   %
   3136   \def\eurosize{\csname\curfontsize nominalsize\endcsname}%
   3137   %
   3138   \ifx\curfontstyle\bfstylename
   3139     % bold:
   3140     \font\thiseurofont = \ifusingit{feybo10}{feybr10} at \eurosize
   3141   \else
   3142     % regular:
   3143     \font\thiseurofont = \ifusingit{feymo10}{feymr10} at \eurosize
   3144   \fi
   3145   \thiseurofont
   3146 }
   3147 
   3148 % Glyphs from the EC fonts.  We don't use \let for the aliases, because
   3149 % sometimes we redefine the original macro, and the alias should reflect
   3150 % the redefinition.
   3151 %
   3152 % Use LaTeX names for the Icelandic letters.
   3153 \def\DH{{\ecfont \char"D0}} % Eth
   3154 \def\dh{{\ecfont \char"F0}} % eth
   3155 \def\TH{{\ecfont \char"DE}} % Thorn
   3156 \def\th{{\ecfont \char"FE}} % thorn
   3157 %
   3158 \def\guillemetleft{{\ecfont \char"13}}
   3159 \def\guillemotleft{\guillemetleft}
   3160 \def\guillemetright{{\ecfont \char"14}}
   3161 \def\guillemotright{\guillemetright}
   3162 \def\guilsinglleft{{\ecfont \char"0E}}
   3163 \def\guilsinglright{{\ecfont \char"0F}}
   3164 \def\quotedblbase{{\ecfont \char"12}}
   3165 \def\quotesinglbase{{\ecfont \char"0D}}
   3166 %
   3167 % This positioning is not perfect (see the ogonek LaTeX package), but
   3168 % we have the precomposed glyphs for the most common cases.  We put the
   3169 % tests to use those glyphs in the single \ogonek macro so we have fewer
   3170 % dummy definitions to worry about for index entries, etc.
   3171 %
   3172 % ogonek is also used with other letters in Lithuanian (IOU), but using
   3173 % the precomposed glyphs for those is not so easy since they aren't in
   3174 % the same EC font.
   3175 \def\ogonek#1{{%
   3176   \def\temp{#1}%
   3177   \ifx\temp\macrocharA\Aogonek
   3178   \else\ifx\temp\macrochara\aogonek
   3179   \else\ifx\temp\macrocharE\Eogonek
   3180   \else\ifx\temp\macrochare\eogonek
   3181   \else
   3182     \ecfont \setbox0=\hbox{#1}%
   3183     \ifdim\ht0=1ex\accent"0C #1%
   3184     \else\ooalign{\unhbox0\crcr\hidewidth\char"0C \hidewidth}%
   3185     \fi
   3186   \fi\fi\fi\fi
   3187   }%
   3188 }
   3189 \def\Aogonek{{\ecfont \char"81}}\def\macrocharA{A}
   3190 \def\aogonek{{\ecfont \char"A1}}\def\macrochara{a}
   3191 \def\Eogonek{{\ecfont \char"86}}\def\macrocharE{E}
   3192 \def\eogonek{{\ecfont \char"A6}}\def\macrochare{e}
   3193 %
   3194 % Use the ec* fonts (cm-super in outline format) for non-CM glyphs.
   3195 \def\ecfont{%
   3196   % We can't distinguish serif/sans and italic/slanted, but this
   3197   % is used for crude hacks anyway (like adding French and German
   3198   % quotes to documents typeset with CM, where we lose kerning), so
   3199   % hopefully nobody will notice/care.
   3200   \edef\ecsize{\csname\curfontsize ecsize\endcsname}%
   3201   \edef\nominalsize{\csname\curfontsize nominalsize\endcsname}%
   3202   \ifmonospace
   3203     % typewriter:
   3204     \font\thisecfont = ectt\ecsize \space at \nominalsize
   3205   \else
   3206     \ifx\curfontstyle\bfstylename
   3207       % bold:
   3208       \font\thisecfont = ecb\ifusingit{i}{x}\ecsize \space at \nominalsize
   3209     \else
   3210       % regular:
   3211       \font\thisecfont = ec\ifusingit{ti}{rm}\ecsize \space at \nominalsize
   3212     \fi
   3213   \fi
   3214   \thisecfont
   3215 }
   3216 
   3217 % @registeredsymbol - R in a circle.  The font for the R should really
   3218 % be smaller yet, but lllsize is the best we can do for now.
   3219 % Adapted from the plain.tex definition of \copyright.
   3220 %
   3221 \def\registeredsymbol{%
   3222   $^{{\ooalign{\hfil\raise.07ex\hbox{\selectfonts\lllsize R}%
   3223                \hfil\crcr\Orb}}%
   3224     }$%
   3225 }
   3226 
   3227 % @textdegree - the normal degrees sign.
   3228 %
   3229 \def\textdegree{$^\circ$}
   3230 
   3231 % Laurent Siebenmann reports \Orb undefined with:
   3232 %  Textures 1.7.7 (preloaded format=plain 93.10.14)  (68K)  16 APR 2004 02:38
   3233 % so we'll define it if necessary.
   3234 %
   3235 \ifx\Orb\thisisundefined
   3236 \def\Orb{\mathhexbox20D}
   3237 \fi
   3238 
   3239 % Quotes.
   3240 \chardef\quotedblleft="5C
   3241 \chardef\quotedblright=`\"
   3242 \chardef\quoteleft=`\`
   3243 \chardef\quoteright=`\'
   3244 
   3245 
   3246 \message{page headings,}
   3247 
   3248 \newskip\titlepagetopglue \titlepagetopglue = 1.5in
   3249 \newskip\titlepagebottomglue \titlepagebottomglue = 2pc
   3250 
   3251 % First the title page.  Must do @settitle before @titlepage.
   3252 \newif\ifseenauthor
   3253 \newif\iffinishedtitlepage
   3254 
   3255 % Do an implicit @contents or @shortcontents after @end titlepage if the
   3256 % user says @setcontentsaftertitlepage or @setshortcontentsaftertitlepage.
   3257 %
   3258 \newif\ifsetcontentsaftertitlepage
   3259  \let\setcontentsaftertitlepage = \setcontentsaftertitlepagetrue
   3260 \newif\ifsetshortcontentsaftertitlepage
   3261  \let\setshortcontentsaftertitlepage = \setshortcontentsaftertitlepagetrue
   3262 
   3263 \parseargdef\shorttitlepage{%
   3264   \begingroup \hbox{}\vskip 1.5in \chaprm \centerline{#1}%
   3265   \endgroup\page\hbox{}\page}
   3266 
   3267 \envdef\titlepage{%
   3268   % Open one extra group, as we want to close it in the middle of \Etitlepage.
   3269   \begingroup
   3270     \parindent=0pt \textfonts
   3271     % Leave some space at the very top of the page.
   3272     \vglue\titlepagetopglue
   3273     % No rule at page bottom unless we print one at the top with @title.
   3274     \finishedtitlepagetrue
   3275     %
   3276     % Most title ``pages'' are actually two pages long, with space
   3277     % at the top of the second.  We don't want the ragged left on the second.
   3278     \let\oldpage = \page
   3279     \def\page{%
   3280       \iffinishedtitlepage\else
   3281 	 \finishtitlepage
   3282       \fi
   3283       \let\page = \oldpage
   3284       \page
   3285       \null
   3286     }%
   3287 }
   3288 
   3289 \def\Etitlepage{%
   3290     \iffinishedtitlepage\else
   3291 	\finishtitlepage
   3292     \fi
   3293     % It is important to do the page break before ending the group,
   3294     % because the headline and footline are only empty inside the group.
   3295     % If we use the new definition of \page, we always get a blank page
   3296     % after the title page, which we certainly don't want.
   3297     \oldpage
   3298   \endgroup
   3299   %
   3300   % Need this before the \...aftertitlepage checks so that if they are
   3301   % in effect the toc pages will come out with page numbers.
   3302   \HEADINGSon
   3303   %
   3304   % If they want short, they certainly want long too.
   3305   \ifsetshortcontentsaftertitlepage
   3306     \shortcontents
   3307     \contents
   3308     \global\let\shortcontents = \relax
   3309     \global\let\contents = \relax
   3310   \fi
   3311   %
   3312   \ifsetcontentsaftertitlepage
   3313     \contents
   3314     \global\let\contents = \relax
   3315     \global\let\shortcontents = \relax
   3316   \fi
   3317 }
   3318 
   3319 \def\finishtitlepage{%
   3320   \vskip4pt \hrule height 2pt width \hsize
   3321   \vskip\titlepagebottomglue
   3322   \finishedtitlepagetrue
   3323 }
   3324 
   3325 % Settings used for typesetting titles: no hyphenation, no indentation,
   3326 % don't worry much about spacing, ragged right.  This should be used
   3327 % inside a \vbox, and fonts need to be set appropriately first.  Because
   3328 % it is always used for titles, nothing else, we call \rmisbold.  \par
   3329 % should be specified before the end of the \vbox, since a vbox is a group.
   3330 %
   3331 \def\raggedtitlesettings{%
   3332   \rmisbold
   3333   \hyphenpenalty=10000
   3334   \parindent=0pt
   3335   \tolerance=5000
   3336   \ptexraggedright
   3337 }
   3338 
   3339 % Macros to be used within @titlepage:
   3340 
   3341 \let\subtitlerm=\tenrm
   3342 \def\subtitlefont{\subtitlerm \normalbaselineskip = 13pt \normalbaselines}
   3343 
   3344 \parseargdef\title{%
   3345   \checkenv\titlepage
   3346   \vbox{\titlefonts \raggedtitlesettings #1\par}%
   3347   % print a rule at the page bottom also.
   3348   \finishedtitlepagefalse
   3349   \vskip4pt \hrule height 4pt width \hsize \vskip4pt
   3350 }
   3351 
   3352 \parseargdef\subtitle{%
   3353   \checkenv\titlepage
   3354   {\subtitlefont \rightline{#1}}%
   3355 }
   3356 
   3357 % @author should come last, but may come many times.
   3358 % It can also be used inside @quotation.
   3359 %
   3360 \parseargdef\author{%
   3361   \def\temp{\quotation}%
   3362   \ifx\thisenv\temp
   3363     \def\quotationauthor{#1}% printed in \Equotation.
   3364   \else
   3365     \checkenv\titlepage
   3366     \ifseenauthor\else \vskip 0pt plus 1filll \seenauthortrue \fi
   3367     {\secfonts\rmisbold \leftline{#1}}%
   3368   \fi
   3369 }
   3370 
   3371 
   3372 % Set up page headings and footings.
   3373 
   3374 \let\thispage=\folio
   3375 
   3376 \newtoks\evenheadline    % headline on even pages
   3377 \newtoks\oddheadline     % headline on odd pages
   3378 \newtoks\evenfootline    % footline on even pages
   3379 \newtoks\oddfootline     % footline on odd pages
   3380 
   3381 % Now make TeX use those variables
   3382 \headline={{\textfonts\rm \ifodd\pageno \the\oddheadline
   3383                             \else \the\evenheadline \fi}}
   3384 \footline={{\textfonts\rm \ifodd\pageno \the\oddfootline
   3385                             \else \the\evenfootline \fi}\HEADINGShook}
   3386 \let\HEADINGShook=\relax
   3387 
   3388 % Commands to set those variables.
   3389 % For example, this is what  @headings on  does
   3390 % @evenheading @thistitle|@thispage|@thischapter
   3391 % @oddheading @thischapter|@thispage|@thistitle
   3392 % @evenfooting @thisfile||
   3393 % @oddfooting ||@thisfile
   3394 
   3395 
   3396 \def\evenheading{\parsearg\evenheadingxxx}
   3397 \def\evenheadingxxx #1{\evenheadingyyy #1\|\|\|\|\finish}
   3398 \def\evenheadingyyy #1\|#2\|#3\|#4\finish{%
   3399 \global\evenheadline={\rlap{\centerline{#2}}\line{#1\hfil#3}}}
   3400 
   3401 \def\oddheading{\parsearg\oddheadingxxx}
   3402 \def\oddheadingxxx #1{\oddheadingyyy #1\|\|\|\|\finish}
   3403 \def\oddheadingyyy #1\|#2\|#3\|#4\finish{%
   3404 \global\oddheadline={\rlap{\centerline{#2}}\line{#1\hfil#3}}}
   3405 
   3406 \parseargdef\everyheading{\oddheadingxxx{#1}\evenheadingxxx{#1}}%
   3407 
   3408 \def\evenfooting{\parsearg\evenfootingxxx}
   3409 \def\evenfootingxxx #1{\evenfootingyyy #1\|\|\|\|\finish}
   3410 \def\evenfootingyyy #1\|#2\|#3\|#4\finish{%
   3411 \global\evenfootline={\rlap{\centerline{#2}}\line{#1\hfil#3}}}
   3412 
   3413 \def\oddfooting{\parsearg\oddfootingxxx}
   3414 \def\oddfootingxxx #1{\oddfootingyyy #1\|\|\|\|\finish}
   3415 \def\oddfootingyyy #1\|#2\|#3\|#4\finish{%
   3416   \global\oddfootline = {\rlap{\centerline{#2}}\line{#1\hfil#3}}%
   3417   %
   3418   % Leave some space for the footline.  Hopefully ok to assume
   3419   % @evenfooting will not be used by itself.
   3420   \global\advance\pageheight by -12pt
   3421   \global\advance\vsize by -12pt
   3422 }
   3423 
   3424 \parseargdef\everyfooting{\oddfootingxxx{#1}\evenfootingxxx{#1}}
   3425 
   3426 % @evenheadingmarks top     \thischapter <- chapter at the top of a page
   3427 % @evenheadingmarks bottom  \thischapter <- chapter at the bottom of a page
   3428 %
   3429 % The same set of arguments for:
   3430 %
   3431 % @oddheadingmarks
   3432 % @evenfootingmarks
   3433 % @oddfootingmarks
   3434 % @everyheadingmarks
   3435 % @everyfootingmarks
   3436 
   3437 \def\evenheadingmarks{\headingmarks{even}{heading}}
   3438 \def\oddheadingmarks{\headingmarks{odd}{heading}}
   3439 \def\evenfootingmarks{\headingmarks{even}{footing}}
   3440 \def\oddfootingmarks{\headingmarks{odd}{footing}}
   3441 \def\everyheadingmarks#1 {\headingmarks{even}{heading}{#1}
   3442                           \headingmarks{odd}{heading}{#1} }
   3443 \def\everyfootingmarks#1 {\headingmarks{even}{footing}{#1}
   3444                           \headingmarks{odd}{footing}{#1} }
   3445 % #1 = even/odd, #2 = heading/footing, #3 = top/bottom.
   3446 \def\headingmarks#1#2#3 {%
   3447   \expandafter\let\expandafter\temp \csname get#3headingmarks\endcsname
   3448   \global\expandafter\let\csname get#1#2marks\endcsname \temp
   3449 }
   3450 
   3451 \everyheadingmarks bottom
   3452 \everyfootingmarks bottom
   3453 
   3454 % @headings double      turns headings on for double-sided printing.
   3455 % @headings single      turns headings on for single-sided printing.
   3456 % @headings off         turns them off.
   3457 % @headings on          same as @headings double, retained for compatibility.
   3458 % @headings after       turns on double-sided headings after this page.
   3459 % @headings doubleafter turns on double-sided headings after this page.
   3460 % @headings singleafter turns on single-sided headings after this page.
   3461 % By default, they are off at the start of a document,
   3462 % and turned `on' after @end titlepage.
   3463 
   3464 \def\headings #1 {\csname HEADINGS#1\endcsname}
   3465 
   3466 \def\headingsoff{% non-global headings elimination
   3467   \evenheadline={\hfil}\evenfootline={\hfil}%
   3468    \oddheadline={\hfil}\oddfootline={\hfil}%
   3469 }
   3470 
   3471 \def\HEADINGSoff{{\globaldefs=1 \headingsoff}} % global setting
   3472 \HEADINGSoff  % it's the default
   3473 
   3474 % When we turn headings on, set the page number to 1.
   3475 % For double-sided printing, put current file name in lower left corner,
   3476 % chapter name on inside top of right hand pages, document
   3477 % title on inside top of left hand pages, and page numbers on outside top
   3478 % edge of all pages.
   3479 \def\HEADINGSdouble{%
   3480 \global\pageno=1
   3481 \global\evenfootline={\hfil}
   3482 \global\oddfootline={\hfil}
   3483 \global\evenheadline={\line{\folio\hfil\thistitle}}
   3484 \global\oddheadline={\line{\thischapter\hfil\folio}}
   3485 \global\let\contentsalignmacro = \chapoddpage
   3486 }
   3487 \let\contentsalignmacro = \chappager
   3488 
   3489 % For single-sided printing, chapter title goes across top left of page,
   3490 % page number on top right.
   3491 \def\HEADINGSsingle{%
   3492 \global\pageno=1
   3493 \global\evenfootline={\hfil}
   3494 \global\oddfootline={\hfil}
   3495 \global\evenheadline={\line{\thischapter\hfil\folio}}
   3496 \global\oddheadline={\line{\thischapter\hfil\folio}}
   3497 \global\let\contentsalignmacro = \chappager
   3498 }
   3499 \def\HEADINGSon{\HEADINGSdouble}
   3500 
   3501 \def\HEADINGSafter{\let\HEADINGShook=\HEADINGSdoublex}
   3502 \let\HEADINGSdoubleafter=\HEADINGSafter
   3503 \def\HEADINGSdoublex{%
   3504 \global\evenfootline={\hfil}
   3505 \global\oddfootline={\hfil}
   3506 \global\evenheadline={\line{\folio\hfil\thistitle}}
   3507 \global\oddheadline={\line{\thischapter\hfil\folio}}
   3508 \global\let\contentsalignmacro = \chapoddpage
   3509 }
   3510 
   3511 \def\HEADINGSsingleafter{\let\HEADINGShook=\HEADINGSsinglex}
   3512 \def\HEADINGSsinglex{%
   3513 \global\evenfootline={\hfil}
   3514 \global\oddfootline={\hfil}
   3515 \global\evenheadline={\line{\thischapter\hfil\folio}}
   3516 \global\oddheadline={\line{\thischapter\hfil\folio}}
   3517 \global\let\contentsalignmacro = \chappager
   3518 }
   3519 
   3520 % Subroutines used in generating headings
   3521 % This produces Day Month Year style of output.
   3522 % Only define if not already defined, in case a txi-??.tex file has set
   3523 % up a different format (e.g., txi-cs.tex does this).
   3524 \ifx\today\thisisundefined
   3525 \def\today{%
   3526   \number\day\space
   3527   \ifcase\month
   3528   \or\putwordMJan\or\putwordMFeb\or\putwordMMar\or\putwordMApr
   3529   \or\putwordMMay\or\putwordMJun\or\putwordMJul\or\putwordMAug
   3530   \or\putwordMSep\or\putwordMOct\or\putwordMNov\or\putwordMDec
   3531   \fi
   3532   \space\number\year}
   3533 \fi
   3534 
   3535 % @settitle line...  specifies the title of the document, for headings.
   3536 % It generates no output of its own.
   3537 \def\thistitle{\putwordNoTitle}
   3538 \def\settitle{\parsearg{\gdef\thistitle}}
   3539 
   3540 
   3541 \message{tables,}
   3542 % Tables -- @table, @ftable, @vtable, @item(x).
   3543 
   3544 % default indentation of table text
   3545 \newdimen\tableindent \tableindent=.8in
   3546 % default indentation of @itemize and @enumerate text
   3547 \newdimen\itemindent  \itemindent=.3in
   3548 % margin between end of table item and start of table text.
   3549 \newdimen\itemmargin  \itemmargin=.1in
   3550 
   3551 % used internally for \itemindent minus \itemmargin
   3552 \newdimen\itemmax
   3553 
   3554 % Note @table, @ftable, and @vtable define @item, @itemx, etc., with
   3555 % these defs.
   3556 % They also define \itemindex
   3557 % to index the item name in whatever manner is desired (perhaps none).
   3558 
   3559 \newif\ifitemxneedsnegativevskip
   3560 
   3561 \def\itemxpar{\par\ifitemxneedsnegativevskip\nobreak\vskip-\parskip\nobreak\fi}
   3562 
   3563 \def\internalBitem{\smallbreak \parsearg\itemzzz}
   3564 \def\internalBitemx{\itemxpar \parsearg\itemzzz}
   3565 
   3566 \def\itemzzz #1{\begingroup %
   3567   \advance\hsize by -\rightskip
   3568   \advance\hsize by -\tableindent
   3569   \setbox0=\hbox{\itemindicate{#1}}%
   3570   \itemindex{#1}%
   3571   \nobreak % This prevents a break before @itemx.
   3572   %
   3573   % If the item text does not fit in the space we have, put it on a line
   3574   % by itself, and do not allow a page break either before or after that
   3575   % line.  We do not start a paragraph here because then if the next
   3576   % command is, e.g., @kindex, the whatsit would get put into the
   3577   % horizontal list on a line by itself, resulting in extra blank space.
   3578   \ifdim \wd0>\itemmax
   3579     %
   3580     % Make this a paragraph so we get the \parskip glue and wrapping,
   3581     % but leave it ragged-right.
   3582     \begingroup
   3583       \advance\leftskip by-\tableindent
   3584       \advance\hsize by\tableindent
   3585       \advance\rightskip by0pt plus1fil\relax
   3586       \leavevmode\unhbox0\par
   3587     \endgroup
   3588     %
   3589     % We're going to be starting a paragraph, but we don't want the
   3590     % \parskip glue -- logically it's part of the @item we just started.
   3591     \nobreak \vskip-\parskip
   3592     %
   3593     % Stop a page break at the \parskip glue coming up.  However, if
   3594     % what follows is an environment such as @example, there will be no
   3595     % \parskip glue; then the negative vskip we just inserted would
   3596     % cause the example and the item to crash together.  So we use this
   3597     % bizarre value of 10001 as a signal to \aboveenvbreak to insert
   3598     % \parskip glue after all.  Section titles are handled this way also.
   3599     %
   3600     \penalty 10001
   3601     \endgroup
   3602     \itemxneedsnegativevskipfalse
   3603   \else
   3604     % The item text fits into the space.  Start a paragraph, so that the
   3605     % following text (if any) will end up on the same line.
   3606     \noindent
   3607     % Do this with kerns and \unhbox so that if there is a footnote in
   3608     % the item text, it can migrate to the main vertical list and
   3609     % eventually be printed.
   3610     \nobreak\kern-\tableindent
   3611     \dimen0 = \itemmax  \advance\dimen0 by \itemmargin \advance\dimen0 by -\wd0
   3612     \unhbox0
   3613     \nobreak\kern\dimen0
   3614     \endgroup
   3615     \itemxneedsnegativevskiptrue
   3616   \fi
   3617 }
   3618 
   3619 \def\item{\errmessage{@item while not in a list environment}}
   3620 \def\itemx{\errmessage{@itemx while not in a list environment}}
   3621 
   3622 % @table, @ftable, @vtable.
   3623 \envdef\table{%
   3624   \let\itemindex\gobble
   3625   \tablecheck{table}%
   3626 }
   3627 \envdef\ftable{%
   3628   \def\itemindex ##1{\doind {fn}{\code{##1}}}%
   3629   \tablecheck{ftable}%
   3630 }
   3631 \envdef\vtable{%
   3632   \def\itemindex ##1{\doind {vr}{\code{##1}}}%
   3633   \tablecheck{vtable}%
   3634 }
   3635 \def\tablecheck#1{%
   3636   \ifnum \the\catcode`\^^M=\active
   3637     \endgroup
   3638     \errmessage{This command won't work in this context; perhaps the problem is
   3639       that we are \inenvironment\thisenv}%
   3640     \def\next{\doignore{#1}}%
   3641   \else
   3642     \let\next\tablex
   3643   \fi
   3644   \next
   3645 }
   3646 \def\tablex#1{%
   3647   \def\itemindicate{#1}%
   3648   \parsearg\tabley
   3649 }
   3650 \def\tabley#1{%
   3651   {%
   3652     \makevalueexpandable
   3653     \edef\temp{\noexpand\tablez #1\space\space\space}%
   3654     \expandafter
   3655   }\temp \endtablez
   3656 }
   3657 \def\tablez #1 #2 #3 #4\endtablez{%
   3658   \aboveenvbreak
   3659   \ifnum 0#1>0 \advance \leftskip by #1\mil \fi
   3660   \ifnum 0#2>0 \tableindent=#2\mil \fi
   3661   \ifnum 0#3>0 \advance \rightskip by #3\mil \fi
   3662   \itemmax=\tableindent
   3663   \advance \itemmax by -\itemmargin
   3664   \advance \leftskip by \tableindent
   3665   \exdentamount=\tableindent
   3666   \parindent = 0pt
   3667   \parskip = \smallskipamount
   3668   \ifdim \parskip=0pt \parskip=2pt \fi
   3669   \let\item = \internalBitem
   3670   \let\itemx = \internalBitemx
   3671 }
   3672 \def\Etable{\endgraf\afterenvbreak}
   3673 \let\Eftable\Etable
   3674 \let\Evtable\Etable
   3675 \let\Eitemize\Etable
   3676 \let\Eenumerate\Etable
   3677 
   3678 % This is the counter used by @enumerate, which is really @itemize
   3679 
   3680 \newcount \itemno
   3681 
   3682 \envdef\itemize{\parsearg\doitemize}
   3683 
   3684 \def\doitemize#1{%
   3685   \aboveenvbreak
   3686   \itemmax=\itemindent
   3687   \advance\itemmax by -\itemmargin
   3688   \advance\leftskip by \itemindent
   3689   \exdentamount=\itemindent
   3690   \parindent=0pt
   3691   \parskip=\smallskipamount
   3692   \ifdim\parskip=0pt \parskip=2pt \fi
   3693   %
   3694   % Try typesetting the item mark that if the document erroneously says
   3695   % something like @itemize @samp (intending @table), there's an error
   3696   % right away at the @itemize.  It's not the best error message in the
   3697   % world, but it's better than leaving it to the @item.  This means if
   3698   % the user wants an empty mark, they have to say @w{} not just @w.
   3699   \def\itemcontents{#1}%
   3700   \setbox0 = \hbox{\itemcontents}%
   3701   %
   3702   % @itemize with no arg is equivalent to @itemize @bullet.
   3703   \ifx\itemcontents\empty\def\itemcontents{\bullet}\fi
   3704   %
   3705   \let\item=\itemizeitem
   3706 }
   3707 
   3708 % Definition of @item while inside @itemize and @enumerate.
   3709 %
   3710 \def\itemizeitem{%
   3711   \advance\itemno by 1  % for enumerations
   3712   {\let\par=\endgraf \smallbreak}% reasonable place to break
   3713   {%
   3714    % If the document has an @itemize directly after a section title, a
   3715    % \nobreak will be last on the list, and \sectionheading will have
   3716    % done a \vskip-\parskip.  In that case, we don't want to zero
   3717    % parskip, or the item text will crash with the heading.  On the
   3718    % other hand, when there is normal text preceding the item (as there
   3719    % usually is), we do want to zero parskip, or there would be too much
   3720    % space.  In that case, we won't have a \nobreak before.  At least
   3721    % that's the theory.
   3722    \ifnum\lastpenalty<10000 \parskip=0in \fi
   3723    \noindent
   3724    \hbox to 0pt{\hss \itemcontents \kern\itemmargin}%
   3725    %
   3726    \vadjust{\penalty 1200}}% not good to break after first line of item.
   3727   \flushcr
   3728 }
   3729 
   3730 % \splitoff TOKENS\endmark defines \first to be the first token in
   3731 % TOKENS, and \rest to be the remainder.
   3732 %
   3733 \def\splitoff#1#2\endmark{\def\first{#1}\def\rest{#2}}%
   3734 
   3735 % Allow an optional argument of an uppercase letter, lowercase letter,
   3736 % or number, to specify the first label in the enumerated list.  No
   3737 % argument is the same as `1'.
   3738 %
   3739 \envparseargdef\enumerate{\enumeratey #1  \endenumeratey}
   3740 \def\enumeratey #1 #2\endenumeratey{%
   3741   % If we were given no argument, pretend we were given `1'.
   3742   \def\thearg{#1}%
   3743   \ifx\thearg\empty \def\thearg{1}\fi
   3744   %
   3745   % Detect if the argument is a single token.  If so, it might be a
   3746   % letter.  Otherwise, the only valid thing it can be is a number.
   3747   % (We will always have one token, because of the test we just made.
   3748   % This is a good thing, since \splitoff doesn't work given nothing at
   3749   % all -- the first parameter is undelimited.)
   3750   \expandafter\splitoff\thearg\endmark
   3751   \ifx\rest\empty
   3752     % Only one token in the argument.  It could still be anything.
   3753     % A ``lowercase letter'' is one whose \lccode is nonzero.
   3754     % An ``uppercase letter'' is one whose \lccode is both nonzero, and
   3755     %   not equal to itself.
   3756     % Otherwise, we assume it's a number.
   3757     %
   3758     % We need the \relax at the end of the \ifnum lines to stop TeX from
   3759     % continuing to look for a <number>.
   3760     %
   3761     \ifnum\lccode\expandafter`\thearg=0\relax
   3762       \numericenumerate % a number (we hope)
   3763     \else
   3764       % It's a letter.
   3765       \ifnum\lccode\expandafter`\thearg=\expandafter`\thearg\relax
   3766         \lowercaseenumerate % lowercase letter
   3767       \else
   3768         \uppercaseenumerate % uppercase letter
   3769       \fi
   3770     \fi
   3771   \else
   3772     % Multiple tokens in the argument.  We hope it's a number.
   3773     \numericenumerate
   3774   \fi
   3775 }
   3776 
   3777 % An @enumerate whose labels are integers.  The starting integer is
   3778 % given in \thearg.
   3779 %
   3780 \def\numericenumerate{%
   3781   \itemno = \thearg
   3782   \startenumeration{\the\itemno}%
   3783 }
   3784 
   3785 % The starting (lowercase) letter is in \thearg.
   3786 \def\lowercaseenumerate{%
   3787   \itemno = \expandafter`\thearg
   3788   \startenumeration{%
   3789     % Be sure we're not beyond the end of the alphabet.
   3790     \ifnum\itemno=0
   3791       \errmessage{No more lowercase letters in @enumerate; get a bigger
   3792                   alphabet}%
   3793     \fi
   3794     \char\lccode\itemno
   3795   }%
   3796 }
   3797 
   3798 % The starting (uppercase) letter is in \thearg.
   3799 \def\uppercaseenumerate{%
   3800   \itemno = \expandafter`\thearg
   3801   \startenumeration{%
   3802     % Be sure we're not beyond the end of the alphabet.
   3803     \ifnum\itemno=0
   3804       \errmessage{No more uppercase letters in @enumerate; get a bigger
   3805                   alphabet}
   3806     \fi
   3807     \char\uccode\itemno
   3808   }%
   3809 }
   3810 
   3811 % Call \doitemize, adding a period to the first argument and supplying the
   3812 % common last two arguments.  Also subtract one from the initial value in
   3813 % \itemno, since @item increments \itemno.
   3814 %
   3815 \def\startenumeration#1{%
   3816   \advance\itemno by -1
   3817   \doitemize{#1.}\flushcr
   3818 }
   3819 
   3820 % @alphaenumerate and @capsenumerate are abbreviations for giving an arg
   3821 % to @enumerate.
   3822 %
   3823 \def\alphaenumerate{\enumerate{a}}
   3824 \def\capsenumerate{\enumerate{A}}
   3825 \def\Ealphaenumerate{\Eenumerate}
   3826 \def\Ecapsenumerate{\Eenumerate}
   3827 
   3828 
   3829 % @multitable macros
   3830 % Amy Hendrickson, 8/18/94, 3/6/96
   3831 %
   3832 % @multitable ... @end multitable will make as many columns as desired.
   3833 % Contents of each column will wrap at width given in preamble.  Width
   3834 % can be specified either with sample text given in a template line,
   3835 % or in percent of \hsize, the current width of text on page.
   3836 
   3837 % Table can continue over pages but will only break between lines.
   3838 
   3839 % To make preamble:
   3840 %
   3841 % Either define widths of columns in terms of percent of \hsize:
   3842 %   @multitable @columnfractions .25 .3 .45
   3843 %   @item ...
   3844 %
   3845 %   Numbers following @columnfractions are the percent of the total
   3846 %   current hsize to be used for each column. You may use as many
   3847 %   columns as desired.
   3848 
   3849 
   3850 % Or use a template:
   3851 %   @multitable {Column 1 template} {Column 2 template} {Column 3 template}
   3852 %   @item ...
   3853 %   using the widest term desired in each column.
   3854 
   3855 % Each new table line starts with @item, each subsequent new column
   3856 % starts with @tab. Empty columns may be produced by supplying @tab's
   3857 % with nothing between them for as many times as empty columns are needed,
   3858 % ie, @tab@tab@tab will produce two empty columns.
   3859 
   3860 % @item, @tab do not need to be on their own lines, but it will not hurt
   3861 % if they are.
   3862 
   3863 % Sample multitable:
   3864 
   3865 %   @multitable {Column 1 template} {Column 2 template} {Column 3 template}
   3866 %   @item first col stuff @tab second col stuff @tab third col
   3867 %   @item
   3868 %   first col stuff
   3869 %   @tab
   3870 %   second col stuff
   3871 %   @tab
   3872 %   third col
   3873 %   @item first col stuff @tab second col stuff
   3874 %   @tab Many paragraphs of text may be used in any column.
   3875 %
   3876 %         They will wrap at the width determined by the template.
   3877 %   @item@tab@tab This will be in third column.
   3878 %   @end multitable
   3879 
   3880 % Default dimensions may be reset by user.
   3881 % @multitableparskip is vertical space between paragraphs in table.
   3882 % @multitableparindent is paragraph indent in table.
   3883 % @multitablecolmargin is horizontal space to be left between columns.
   3884 % @multitablelinespace is space to leave between table items, baseline
   3885 %                                                            to baseline.
   3886 %   0pt means it depends on current normal line spacing.
   3887 %
   3888 \newskip\multitableparskip
   3889 \newskip\multitableparindent
   3890 \newdimen\multitablecolspace
   3891 \newskip\multitablelinespace
   3892 \multitableparskip=0pt
   3893 \multitableparindent=6pt
   3894 \multitablecolspace=12pt
   3895 \multitablelinespace=0pt
   3896 
   3897 % Macros used to set up halign preamble:
   3898 %
   3899 \let\endsetuptable\relax
   3900 \def\xendsetuptable{\endsetuptable}
   3901 \let\columnfractions\relax
   3902 \def\xcolumnfractions{\columnfractions}
   3903 \newif\ifsetpercent
   3904 
   3905 % #1 is the @columnfraction, usually a decimal number like .5, but might
   3906 % be just 1.  We just use it, whatever it is.
   3907 %
   3908 \def\pickupwholefraction#1 {%
   3909   \global\advance\colcount by 1
   3910   \expandafter\xdef\csname col\the\colcount\endcsname{#1\hsize}%
   3911   \setuptable
   3912 }
   3913 
   3914 \newcount\colcount
   3915 \def\setuptable#1{%
   3916   \def\firstarg{#1}%
   3917   \ifx\firstarg\xendsetuptable
   3918     \let\go = \relax
   3919   \else
   3920     \ifx\firstarg\xcolumnfractions
   3921       \global\setpercenttrue
   3922     \else
   3923       \ifsetpercent
   3924          \let\go\pickupwholefraction
   3925       \else
   3926          \global\advance\colcount by 1
   3927          \setbox0=\hbox{#1\unskip\space}% Add a normal word space as a
   3928                    % separator; typically that is always in the input, anyway.
   3929          \expandafter\xdef\csname col\the\colcount\endcsname{\the\wd0}%
   3930       \fi
   3931     \fi
   3932     \ifx\go\pickupwholefraction
   3933       % Put the argument back for the \pickupwholefraction call, so
   3934       % we'll always have a period there to be parsed.
   3935       \def\go{\pickupwholefraction#1}%
   3936     \else
   3937       \let\go = \setuptable
   3938     \fi%
   3939   \fi
   3940   \go
   3941 }
   3942 
   3943 % multitable-only commands.
   3944 %
   3945 % @headitem starts a heading row, which we typeset in bold.
   3946 % Assignments have to be global since we are inside the implicit group
   3947 % of an alignment entry.  \everycr resets \everytab so we don't have to
   3948 % undo it ourselves.
   3949 \def\headitemfont{\b}% for people to use in the template row; not changeable
   3950 \def\headitem{%
   3951   \checkenv\multitable
   3952   \crcr
   3953   \global\everytab={\bf}% can't use \headitemfont since the parsing differs
   3954   \the\everytab % for the first item
   3955 }%
   3956 %
   3957 % A \tab used to include \hskip1sp.  But then the space in a template
   3958 % line is not enough.  That is bad.  So let's go back to just `&' until
   3959 % we again encounter the problem the 1sp was intended to solve.
   3960 %					--karl, nathan@acm.org, 20apr99.
   3961 \def\tab{\checkenv\multitable &\the\everytab}%
   3962 
   3963 % @multitable ... @end multitable definitions:
   3964 %
   3965 \newtoks\everytab  % insert after every tab.
   3966 %
   3967 \envdef\multitable{%
   3968   \vskip\parskip
   3969   \startsavinginserts
   3970   %
   3971   % @item within a multitable starts a normal row.
   3972   % We use \def instead of \let so that if one of the multitable entries
   3973   % contains an @itemize, we don't choke on the \item (seen as \crcr aka
   3974   % \endtemplate) expanding \doitemize.
   3975   \def\item{\crcr}%
   3976   %
   3977   \tolerance=9500
   3978   \hbadness=9500
   3979   \setmultitablespacing
   3980   \parskip=\multitableparskip
   3981   \parindent=\multitableparindent
   3982   \overfullrule=0pt
   3983   \global\colcount=0
   3984   %
   3985   \everycr = {%
   3986     \noalign{%
   3987       \global\everytab={}%
   3988       \global\colcount=0 % Reset the column counter.
   3989       % Check for saved footnotes, etc.
   3990       \checkinserts
   3991       % Keeps underfull box messages off when table breaks over pages.
   3992       %\filbreak
   3993 	% Maybe so, but it also creates really weird page breaks when the
   3994 	% table breaks over pages. Wouldn't \vfil be better?  Wait until the
   3995 	% problem manifests itself, so it can be fixed for real --karl.
   3996     }%
   3997   }%
   3998   %
   3999   \parsearg\domultitable
   4000 }
   4001 \def\domultitable#1{%
   4002   % To parse everything between @multitable and @item:
   4003   \setuptable#1 \endsetuptable
   4004   %
   4005   % This preamble sets up a generic column definition, which will
   4006   % be used as many times as user calls for columns.
   4007   % \vtop will set a single line and will also let text wrap and
   4008   % continue for many paragraphs if desired.
   4009   \halign\bgroup &%
   4010     \global\advance\colcount by 1
   4011     \multistrut
   4012     \vtop{%
   4013       % Use the current \colcount to find the correct column width:
   4014       \hsize=\expandafter\csname col\the\colcount\endcsname
   4015       %
   4016       % In order to keep entries from bumping into each other
   4017       % we will add a \leftskip of \multitablecolspace to all columns after
   4018       % the first one.
   4019       %
   4020       % If a template has been used, we will add \multitablecolspace
   4021       % to the width of each template entry.
   4022       %
   4023       % If the user has set preamble in terms of percent of \hsize we will
   4024       % use that dimension as the width of the column, and the \leftskip
   4025       % will keep entries from bumping into each other.  Table will start at
   4026       % left margin and final column will justify at right margin.
   4027       %
   4028       % Make sure we don't inherit \rightskip from the outer environment.
   4029       \rightskip=0pt
   4030       \ifnum\colcount=1
   4031 	% The first column will be indented with the surrounding text.
   4032 	\advance\hsize by\leftskip
   4033       \else
   4034 	\ifsetpercent \else
   4035 	  % If user has not set preamble in terms of percent of \hsize
   4036 	  % we will advance \hsize by \multitablecolspace.
   4037 	  \advance\hsize by \multitablecolspace
   4038 	\fi
   4039        % In either case we will make \leftskip=\multitablecolspace:
   4040       \leftskip=\multitablecolspace
   4041       \fi
   4042       % Ignoring space at the beginning and end avoids an occasional spurious
   4043       % blank line, when TeX decides to break the line at the space before the
   4044       % box from the multistrut, so the strut ends up on a line by itself.
   4045       % For example:
   4046       % @multitable @columnfractions .11 .89
   4047       % @item @code{#}
   4048       % @tab Legal holiday which is valid in major parts of the whole country.
   4049       % Is automatically provided with highlighting sequences respectively
   4050       % marking characters.
   4051       \noindent\ignorespaces##\unskip\multistrut
   4052     }\cr
   4053 }
   4054 \def\Emultitable{%
   4055   \crcr
   4056   \egroup % end the \halign
   4057   \global\setpercentfalse
   4058 }
   4059 
   4060 \def\setmultitablespacing{%
   4061   \def\multistrut{\strut}% just use the standard line spacing
   4062   %
   4063   % Compute \multitablelinespace (if not defined by user) for use in
   4064   % \multitableparskip calculation.  We used define \multistrut based on
   4065   % this, but (ironically) that caused the spacing to be off.
   4066   % See bug-texinfo report from Werner Lemberg, 31 Oct 2004 12:52:20 +0100.
   4067 \ifdim\multitablelinespace=0pt
   4068 \setbox0=\vbox{X}\global\multitablelinespace=\the\baselineskip
   4069 \global\advance\multitablelinespace by-\ht0
   4070 \fi
   4071 % Test to see if parskip is larger than space between lines of
   4072 % table. If not, do nothing.
   4073 %        If so, set to same dimension as multitablelinespace.
   4074 \ifdim\multitableparskip>\multitablelinespace
   4075 \global\multitableparskip=\multitablelinespace
   4076 \global\advance\multitableparskip-7pt % to keep parskip somewhat smaller
   4077                                       % than skip between lines in the table.
   4078 \fi%
   4079 \ifdim\multitableparskip=0pt
   4080 \global\multitableparskip=\multitablelinespace
   4081 \global\advance\multitableparskip-7pt % to keep parskip somewhat smaller
   4082                                       % than skip between lines in the table.
   4083 \fi}
   4084 
   4085 
   4086 \message{conditionals,}
   4087 
   4088 % @iftex, @ifnotdocbook, @ifnothtml, @ifnotinfo, @ifnotplaintext,
   4089 % @ifnotxml always succeed.  They currently do nothing; we don't
   4090 % attempt to check whether the conditionals are properly nested.  But we
   4091 % have to remember that they are conditionals, so that @end doesn't
   4092 % attempt to close an environment group.
   4093 %
   4094 \def\makecond#1{%
   4095   \expandafter\let\csname #1\endcsname = \relax
   4096   \expandafter\let\csname iscond.#1\endcsname = 1
   4097 }
   4098 \makecond{iftex}
   4099 \makecond{ifnotdocbook}
   4100 \makecond{ifnothtml}
   4101 \makecond{ifnotinfo}
   4102 \makecond{ifnotplaintext}
   4103 \makecond{ifnotxml}
   4104 
   4105 % Ignore @ignore, @ifhtml, @ifinfo, and the like.
   4106 %
   4107 \def\direntry{\doignore{direntry}}
   4108 \def\documentdescription{\doignore{documentdescription}}
   4109 \def\docbook{\doignore{docbook}}
   4110 \def\html{\doignore{html}}
   4111 \def\ifdocbook{\doignore{ifdocbook}}
   4112 \def\ifhtml{\doignore{ifhtml}}
   4113 \def\ifinfo{\doignore{ifinfo}}
   4114 \def\ifnottex{\doignore{ifnottex}}
   4115 \def\ifplaintext{\doignore{ifplaintext}}
   4116 \def\ifxml{\doignore{ifxml}}
   4117 \def\ignore{\doignore{ignore}}
   4118 \def\menu{\doignore{menu}}
   4119 \def\xml{\doignore{xml}}
   4120 
   4121 % Ignore text until a line `@end #1', keeping track of nested conditionals.
   4122 %
   4123 % A count to remember the depth of nesting.
   4124 \newcount\doignorecount
   4125 
   4126 \def\doignore#1{\begingroup
   4127   % Scan in ``verbatim'' mode:
   4128   \obeylines
   4129   \catcode`\@ = \other
   4130   \catcode`\{ = \other
   4131   \catcode`\} = \other
   4132   %
   4133   % Make sure that spaces turn into tokens that match what \doignoretext wants.
   4134   \spaceisspace
   4135   %
   4136   % Count number of #1's that we've seen.
   4137   \doignorecount = 0
   4138   %
   4139   % Swallow text until we reach the matching `@end #1'.
   4140   \dodoignore{#1}%
   4141 }
   4142 
   4143 { \catcode`_=11 % We want to use \_STOP_ which cannot appear in texinfo source.
   4144   \obeylines %
   4145   %
   4146   \gdef\dodoignore#1{%
   4147     % #1 contains the command name as a string, e.g., `ifinfo'.
   4148     %
   4149     % Define a command to find the next `@end #1'.
   4150     \long\def\doignoretext##1^^M@end #1{%
   4151       \doignoretextyyy##1^^M@#1\_STOP_}%
   4152     %
   4153     % And this command to find another #1 command, at the beginning of a
   4154     % line.  (Otherwise, we would consider a line `@c @ifset', for
   4155     % example, to count as an @ifset for nesting.)
   4156     \long\def\doignoretextyyy##1^^M@#1##2\_STOP_{\doignoreyyy{##2}\_STOP_}%
   4157     %
   4158     % And now expand that command.
   4159     \doignoretext ^^M%
   4160   }%
   4161 }
   4162 
   4163 \def\doignoreyyy#1{%
   4164   \def\temp{#1}%
   4165   \ifx\temp\empty			% Nothing found.
   4166     \let\next\doignoretextzzz
   4167   \else					% Found a nested condition, ...
   4168     \advance\doignorecount by 1
   4169     \let\next\doignoretextyyy		% ..., look for another.
   4170     % If we're here, #1 ends with ^^M\ifinfo (for example).
   4171   \fi
   4172   \next #1% the token \_STOP_ is present just after this macro.
   4173 }
   4174 
   4175 % We have to swallow the remaining "\_STOP_".
   4176 %
   4177 \def\doignoretextzzz#1{%
   4178   \ifnum\doignorecount = 0	% We have just found the outermost @end.
   4179     \let\next\enddoignore
   4180   \else				% Still inside a nested condition.
   4181     \advance\doignorecount by -1
   4182     \let\next\doignoretext      % Look for the next @end.
   4183   \fi
   4184   \next
   4185 }
   4186 
   4187 % Finish off ignored text.
   4188 { \obeylines%
   4189   % Ignore anything after the last `@end #1'; this matters in verbatim
   4190   % environments, where otherwise the newline after an ignored conditional
   4191   % would result in a blank line in the output.
   4192   \gdef\enddoignore#1^^M{\endgroup\ignorespaces}%
   4193 }
   4194 
   4195 
   4196 % @set VAR sets the variable VAR to an empty value.
   4197 % @set VAR REST-OF-LINE sets VAR to the value REST-OF-LINE.
   4198 %
   4199 % Since we want to separate VAR from REST-OF-LINE (which might be
   4200 % empty), we can't just use \parsearg; we have to insert a space of our
   4201 % own to delimit the rest of the line, and then take it out again if we
   4202 % didn't need it.
   4203 % We rely on the fact that \parsearg sets \catcode`\ =10.
   4204 %
   4205 \parseargdef\set{\setyyy#1 \endsetyyy}
   4206 \def\setyyy#1 #2\endsetyyy{%
   4207   {%
   4208     \makevalueexpandable
   4209     \def\temp{#2}%
   4210     \edef\next{\gdef\makecsname{SET#1}}%
   4211     \ifx\temp\empty
   4212       \next{}%
   4213     \else
   4214       \setzzz#2\endsetzzz
   4215     \fi
   4216   }%
   4217 }
   4218 % Remove the trailing space \setxxx inserted.
   4219 \def\setzzz#1 \endsetzzz{\next{#1}}
   4220 
   4221 % @clear VAR clears (i.e., unsets) the variable VAR.
   4222 %
   4223 \parseargdef\clear{%
   4224   {%
   4225     \makevalueexpandable
   4226     \global\expandafter\let\csname SET#1\endcsname=\relax
   4227   }%
   4228 }
   4229 
   4230 % @value{foo} gets the text saved in variable foo.
   4231 \def\value{\begingroup\makevalueexpandable\valuexxx}
   4232 \def\valuexxx#1{\expandablevalue{#1}\endgroup}
   4233 {
   4234   \catcode`\-=\active \catcode`\_=\active
   4235   %
   4236   \gdef\makevalueexpandable{%
   4237     \let\value = \expandablevalue
   4238     % We don't want these characters active, ...
   4239     \catcode`\-=\other \catcode`\_=\other
   4240     % ..., but we might end up with active ones in the argument if
   4241     % we're called from @code, as @code{@value{foo-bar_}}, though.
   4242     % So \let them to their normal equivalents.
   4243     \let-\normaldash \let_\normalunderscore
   4244   }
   4245 }
   4246 
   4247 % We have this subroutine so that we can handle at least some @value's
   4248 % properly in indexes (we call \makevalueexpandable in \indexdummies).
   4249 % The command has to be fully expandable (if the variable is set), since
   4250 % the result winds up in the index file.  This means that if the
   4251 % variable's value contains other Texinfo commands, it's almost certain
   4252 % it will fail (although perhaps we could fix that with sufficient work
   4253 % to do a one-level expansion on the result, instead of complete).
   4254 %
   4255 % Unfortunately, this has the consequence that when _ is in the *value*
   4256 % of an @set, it does not print properly in the roman fonts (get the cmr
   4257 % dot accent at position 126 instead).  No fix comes to mind, and it's
   4258 % been this way since 2003 or earlier, so just ignore it.
   4259 %
   4260 \def\expandablevalue#1{%
   4261   \expandafter\ifx\csname SET#1\endcsname\relax
   4262     {[No value for ``#1'']}%
   4263     \message{Variable `#1', used in @value, is not set.}%
   4264   \else
   4265     \csname SET#1\endcsname
   4266   \fi
   4267 }
   4268 
   4269 % @ifset VAR ... @end ifset reads the `...' iff VAR has been defined
   4270 % with @set.
   4271 %
   4272 % To get the special treatment we need for `@end ifset,' we call
   4273 % \makecond and then redefine.
   4274 %
   4275 \makecond{ifset}
   4276 \def\ifset{\parsearg{\doifset{\let\next=\ifsetfail}}}
   4277 \def\doifset#1#2{%
   4278   {%
   4279     \makevalueexpandable
   4280     \let\next=\empty
   4281     \expandafter\ifx\csname SET#2\endcsname\relax
   4282       #1% If not set, redefine \next.
   4283     \fi
   4284     \expandafter
   4285   }\next
   4286 }
   4287 \def\ifsetfail{\doignore{ifset}}
   4288 
   4289 % @ifclear VAR ... @end executes the `...' iff VAR has never been
   4290 % defined with @set, or has been undefined with @clear.
   4291 %
   4292 % The `\else' inside the `\doifset' parameter is a trick to reuse the
   4293 % above code: if the variable is not set, do nothing, if it is set,
   4294 % then redefine \next to \ifclearfail.
   4295 %
   4296 \makecond{ifclear}
   4297 \def\ifclear{\parsearg{\doifset{\else \let\next=\ifclearfail}}}
   4298 \def\ifclearfail{\doignore{ifclear}}
   4299 
   4300 % @ifcommandisdefined CMD ... @end executes the `...' if CMD (written
   4301 % without the @) is in fact defined.  We can only feasibly check at the
   4302 % TeX level, so something like `mathcode' is going to considered
   4303 % defined even though it is not a Texinfo command.
   4304 %
   4305 \makecond{ifcommanddefined}
   4306 \def\ifcommanddefined{\parsearg{\doifcmddefined{\let\next=\ifcmddefinedfail}}}
   4307 %
   4308 \def\doifcmddefined#1#2{{%
   4309     \makevalueexpandable
   4310     \let\next=\empty
   4311     \expandafter\ifx\csname #2\endcsname\relax
   4312       #1% If not defined, \let\next as above.
   4313     \fi
   4314     \expandafter
   4315   }\next
   4316 }
   4317 \def\ifcmddefinedfail{\doignore{ifcommanddefined}}
   4318 
   4319 % @ifcommandnotdefined CMD ... handled similar to @ifclear above.
   4320 \makecond{ifcommandnotdefined}
   4321 \def\ifcommandnotdefined{%
   4322   \parsearg{\doifcmddefined{\else \let\next=\ifcmdnotdefinedfail}}}
   4323 \def\ifcmdnotdefinedfail{\doignore{ifcommandnotdefined}}
   4324 
   4325 % Set the `txicommandconditionals' variable, so documents have a way to
   4326 % test if the @ifcommand...defined conditionals are available.
   4327 \set txicommandconditionals
   4328 
   4329 % @dircategory CATEGORY  -- specify a category of the dir file
   4330 % which this file should belong to.  Ignore this in TeX.
   4331 \let\dircategory=\comment
   4332 
   4333 % @defininfoenclose.
   4334 \let\definfoenclose=\comment
   4335 
   4336 
   4337 \message{indexing,}
   4338 % Index generation facilities
   4339 
   4340 % Define \newwrite to be identical to plain tex's \newwrite
   4341 % except not \outer, so it can be used within macros and \if's.
   4342 \edef\newwrite{\makecsname{ptexnewwrite}}
   4343 
   4344 % \newindex {foo} defines an index named foo.
   4345 % It automatically defines \fooindex such that
   4346 % \fooindex ...rest of line... puts an entry in the index foo.
   4347 % It also defines \fooindfile to be the number of the output channel for
   4348 % the file that accumulates this index.  The file's extension is foo.
   4349 % The name of an index should be no more than 2 characters long
   4350 % for the sake of vms.
   4351 %
   4352 \def\newindex#1{%
   4353   \iflinks
   4354     \expandafter\newwrite \csname#1indfile\endcsname
   4355     \openout \csname#1indfile\endcsname \jobname.#1 % Open the file
   4356   \fi
   4357   \expandafter\xdef\csname#1index\endcsname{%     % Define @#1index
   4358     \noexpand\doindex{#1}}
   4359 }
   4360 
   4361 % @defindex foo  ==  \newindex{foo}
   4362 %
   4363 \def\defindex{\parsearg\newindex}
   4364 
   4365 % Define @defcodeindex, like @defindex except put all entries in @code.
   4366 %
   4367 \def\defcodeindex{\parsearg\newcodeindex}
   4368 %
   4369 \def\newcodeindex#1{%
   4370   \iflinks
   4371     \expandafter\newwrite \csname#1indfile\endcsname
   4372     \openout \csname#1indfile\endcsname \jobname.#1
   4373   \fi
   4374   \expandafter\xdef\csname#1index\endcsname{%
   4375     \noexpand\docodeindex{#1}}%
   4376 }
   4377 
   4378 
   4379 % @synindex foo bar    makes index foo feed into index bar.
   4380 % Do this instead of @defindex foo if you don't want it as a separate index.
   4381 %
   4382 % @syncodeindex foo bar   similar, but put all entries made for index foo
   4383 % inside @code.
   4384 %
   4385 \def\synindex#1 #2 {\dosynindex\doindex{#1}{#2}}
   4386 \def\syncodeindex#1 #2 {\dosynindex\docodeindex{#1}{#2}}
   4387 
   4388 % #1 is \doindex or \docodeindex, #2 the index getting redefined (foo),
   4389 % #3 the target index (bar).
   4390 \def\dosynindex#1#2#3{%
   4391   % Only do \closeout if we haven't already done it, else we'll end up
   4392   % closing the target index.
   4393   \expandafter \ifx\csname donesynindex#2\endcsname \relax
   4394     % The \closeout helps reduce unnecessary open files; the limit on the
   4395     % Acorn RISC OS is a mere 16 files.
   4396     \expandafter\closeout\csname#2indfile\endcsname
   4397     \expandafter\let\csname donesynindex#2\endcsname = 1
   4398   \fi
   4399   % redefine \fooindfile:
   4400   \expandafter\let\expandafter\temp\expandafter=\csname#3indfile\endcsname
   4401   \expandafter\let\csname#2indfile\endcsname=\temp
   4402   % redefine \fooindex:
   4403   \expandafter\xdef\csname#2index\endcsname{\noexpand#1{#3}}%
   4404 }
   4405 
   4406 % Define \doindex, the driver for all \fooindex macros.
   4407 % Argument #1 is generated by the calling \fooindex macro,
   4408 %  and it is "foo", the name of the index.
   4409 
   4410 % \doindex just uses \parsearg; it calls \doind for the actual work.
   4411 % This is because \doind is more useful to call from other macros.
   4412 
   4413 % There is also \dosubind {index}{topic}{subtopic}
   4414 % which makes an entry in a two-level index such as the operation index.
   4415 
   4416 \def\doindex#1{\edef\indexname{#1}\parsearg\singleindexer}
   4417 \def\singleindexer #1{\doind{\indexname}{#1}}
   4418 
   4419 % like the previous two, but they put @code around the argument.
   4420 \def\docodeindex#1{\edef\indexname{#1}\parsearg\singlecodeindexer}
   4421 \def\singlecodeindexer #1{\doind{\indexname}{\code{#1}}}
   4422 
   4423 % Take care of Texinfo commands that can appear in an index entry.
   4424 % Since there are some commands we want to expand, and others we don't,
   4425 % we have to laboriously prevent expansion for those that we don't.
   4426 %
   4427 \def\indexdummies{%
   4428   \escapechar = `\\     % use backslash in output files.
   4429   \def\@{@}% change to @@ when we switch to @ as escape char in index files.
   4430   \def\ {\realbackslash\space }%
   4431   %
   4432   % Need these unexpandable (because we define \tt as a dummy)
   4433   % definitions when @{ or @} appear in index entry text.  Also, more
   4434   % complicated, when \tex is in effect and \{ is a \delimiter again.
   4435   % We can't use \lbracecmd and \rbracecmd because texindex assumes
   4436   % braces and backslashes are used only as delimiters.  Perhaps we
   4437   % should define @lbrace and @rbrace commands a la @comma.
   4438   \def\{{{\tt\char123}}%
   4439   \def\}{{\tt\char125}}%
   4440   %
   4441   % I don't entirely understand this, but when an index entry is
   4442   % generated from a macro call, the \endinput which \scanmacro inserts
   4443   % causes processing to be prematurely terminated.  This is,
   4444   % apparently, because \indexsorttmp is fully expanded, and \endinput
   4445   % is an expandable command.  The redefinition below makes \endinput
   4446   % disappear altogether for that purpose -- although logging shows that
   4447   % processing continues to some further point.  On the other hand, it
   4448   % seems \endinput does not hurt in the printed index arg, since that
   4449   % is still getting written without apparent harm.
   4450   %
   4451   % Sample source (mac-idx3.tex, reported by Graham Percival to
   4452   % help-texinfo, 22may06):
   4453   % @macro funindex {WORD}
   4454   % @findex xyz
   4455   % @end macro
   4456   % ...
   4457   % @funindex commtest
   4458   %
   4459   % The above is not enough to reproduce the bug, but it gives the flavor.
   4460   %
   4461   % Sample whatsit resulting:
   4462   % .@write3{\entry{xyz}{@folio }{@code {xyz@endinput }}}
   4463   %
   4464   % So:
   4465   \let\endinput = \empty
   4466   %
   4467   % Do the redefinitions.
   4468   \commondummies
   4469 }
   4470 
   4471 % For the aux and toc files, @ is the escape character.  So we want to
   4472 % redefine everything using @ as the escape character (instead of
   4473 % \realbackslash, still used for index files).  When everything uses @,
   4474 % this will be simpler.
   4475 %
   4476 \def\atdummies{%
   4477   \def\@{@@}%
   4478   \def\ {@ }%
   4479   \let\{ = \lbraceatcmd
   4480   \let\} = \rbraceatcmd
   4481   %
   4482   % Do the redefinitions.
   4483   \commondummies
   4484   \otherbackslash
   4485 }
   4486 
   4487 % Called from \indexdummies and \atdummies.
   4488 %
   4489 \def\commondummies{%
   4490   %
   4491   % \definedummyword defines \#1 as \string\#1\space, thus effectively
   4492   % preventing its expansion.  This is used only for control words,
   4493   % not control letters, because the \space would be incorrect for
   4494   % control characters, but is needed to separate the control word
   4495   % from whatever follows.
   4496   %
   4497   % For control letters, we have \definedummyletter, which omits the
   4498   % space.
   4499   %
   4500   % These can be used both for control words that take an argument and
   4501   % those that do not.  If it is followed by {arg} in the input, then
   4502   % that will dutifully get written to the index (or wherever).
   4503   %
   4504   \def\definedummyword  ##1{\def##1{\string##1\space}}%
   4505   \def\definedummyletter##1{\def##1{\string##1}}%
   4506   \let\definedummyaccent\definedummyletter
   4507   %
   4508   \commondummiesnofonts
   4509   %
   4510   \definedummyletter\_%
   4511   \definedummyletter\-%
   4512   %
   4513   % Non-English letters.
   4514   \definedummyword\AA
   4515   \definedummyword\AE
   4516   \definedummyword\DH
   4517   \definedummyword\L
   4518   \definedummyword\O
   4519   \definedummyword\OE
   4520   \definedummyword\TH
   4521   \definedummyword\aa
   4522   \definedummyword\ae
   4523   \definedummyword\dh
   4524   \definedummyword\exclamdown
   4525   \definedummyword\l
   4526   \definedummyword\o
   4527   \definedummyword\oe
   4528   \definedummyword\ordf
   4529   \definedummyword\ordm
   4530   \definedummyword\questiondown
   4531   \definedummyword\ss
   4532   \definedummyword\th
   4533   %
   4534   % Although these internal commands shouldn't show up, sometimes they do.
   4535   \definedummyword\bf
   4536   \definedummyword\gtr
   4537   \definedummyword\hat
   4538   \definedummyword\less
   4539   \definedummyword\sf
   4540   \definedummyword\sl
   4541   \definedummyword\tclose
   4542   \definedummyword\tt
   4543   %
   4544   \definedummyword\LaTeX
   4545   \definedummyword\TeX
   4546   %
   4547   % Assorted special characters.
   4548   \definedummyword\arrow
   4549   \definedummyword\bullet
   4550   \definedummyword\comma
   4551   \definedummyword\copyright
   4552   \definedummyword\registeredsymbol
   4553   \definedummyword\dots
   4554   \definedummyword\enddots
   4555   \definedummyword\entrybreak
   4556   \definedummyword\equiv
   4557   \definedummyword\error
   4558   \definedummyword\euro
   4559   \definedummyword\expansion
   4560   \definedummyword\geq
   4561   \definedummyword\guillemetleft
   4562   \definedummyword\guillemetright
   4563   \definedummyword\guilsinglleft
   4564   \definedummyword\guilsinglright
   4565   \definedummyword\lbracechar
   4566   \definedummyword\leq
   4567   \definedummyword\minus
   4568   \definedummyword\ogonek
   4569   \definedummyword\pounds
   4570   \definedummyword\point
   4571   \definedummyword\print
   4572   \definedummyword\quotedblbase
   4573   \definedummyword\quotedblleft
   4574   \definedummyword\quotedblright
   4575   \definedummyword\quoteleft
   4576   \definedummyword\quoteright
   4577   \definedummyword\quotesinglbase
   4578   \definedummyword\rbracechar
   4579   \definedummyword\result
   4580   \definedummyword\textdegree
   4581   %
   4582   % We want to disable all macros so that they are not expanded by \write.
   4583   \macrolist
   4584   %
   4585   \normalturnoffactive
   4586   %
   4587   % Handle some cases of @value -- where it does not contain any
   4588   % (non-fully-expandable) commands.
   4589   \makevalueexpandable
   4590 }
   4591 
   4592 % \commondummiesnofonts: common to \commondummies and \indexnofonts.
   4593 %
   4594 \def\commondummiesnofonts{%
   4595   % Control letters and accents.
   4596   \definedummyletter\!%
   4597   \definedummyaccent\"%
   4598   \definedummyaccent\'%
   4599   \definedummyletter\*%
   4600   \definedummyaccent\,%
   4601   \definedummyletter\.%
   4602   \definedummyletter\/%
   4603   \definedummyletter\:%
   4604   \definedummyaccent\=%
   4605   \definedummyletter\?%
   4606   \definedummyaccent\^%
   4607   \definedummyaccent\`%
   4608   \definedummyaccent\~%
   4609   \definedummyword\u
   4610   \definedummyword\v
   4611   \definedummyword\H
   4612   \definedummyword\dotaccent
   4613   \definedummyword\ogonek
   4614   \definedummyword\ringaccent
   4615   \definedummyword\tieaccent
   4616   \definedummyword\ubaraccent
   4617   \definedummyword\udotaccent
   4618   \definedummyword\dotless
   4619   %
   4620   % Texinfo font commands.
   4621   \definedummyword\b
   4622   \definedummyword\i
   4623   \definedummyword\r
   4624   \definedummyword\sansserif
   4625   \definedummyword\sc
   4626   \definedummyword\slanted
   4627   \definedummyword\t
   4628   %
   4629   % Commands that take arguments.
   4630   \definedummyword\abbr
   4631   \definedummyword\acronym
   4632   \definedummyword\anchor
   4633   \definedummyword\cite
   4634   \definedummyword\code
   4635   \definedummyword\command
   4636   \definedummyword\dfn
   4637   \definedummyword\dmn
   4638   \definedummyword\email
   4639   \definedummyword\emph
   4640   \definedummyword\env
   4641   \definedummyword\file
   4642   \definedummyword\image
   4643   \definedummyword\indicateurl
   4644   \definedummyword\inforef
   4645   \definedummyword\kbd
   4646   \definedummyword\key
   4647   \definedummyword\math
   4648   \definedummyword\option
   4649   \definedummyword\pxref
   4650   \definedummyword\ref
   4651   \definedummyword\samp
   4652   \definedummyword\strong
   4653   \definedummyword\tie
   4654   \definedummyword\uref
   4655   \definedummyword\url
   4656   \definedummyword\var
   4657   \definedummyword\verb
   4658   \definedummyword\w
   4659   \definedummyword\xref
   4660 }
   4661 
   4662 % \indexnofonts is used when outputting the strings to sort the index
   4663 % by, and when constructing control sequence names.  It eliminates all
   4664 % control sequences and just writes whatever the best ASCII sort string
   4665 % would be for a given command (usually its argument).
   4666 %
   4667 \def\indexnofonts{%
   4668   % Accent commands should become @asis.
   4669   \def\definedummyaccent##1{\let##1\asis}%
   4670   % We can just ignore other control letters.
   4671   \def\definedummyletter##1{\let##1\empty}%
   4672   % All control words become @asis by default; overrides below.
   4673   \let\definedummyword\definedummyaccent
   4674   %
   4675   \commondummiesnofonts
   4676   %
   4677   % Don't no-op \tt, since it isn't a user-level command
   4678   % and is used in the definitions of the active chars like <, >, |, etc.
   4679   % Likewise with the other plain tex font commands.
   4680   %\let\tt=\asis
   4681   %
   4682   \def\ { }%
   4683   \def\@{@}%
   4684   \def\_{\normalunderscore}%
   4685   \def\-{}% @- shouldn't affect sorting
   4686   %
   4687   % Unfortunately, texindex is not prepared to handle braces in the
   4688   % content at all.  So for index sorting, we map @{ and @} to strings
   4689   % starting with |, since that ASCII character is between ASCII { and }.
   4690   \def\{{|a}%
   4691   \def\lbracechar{|a}%
   4692   %
   4693   \def\}{|b}%
   4694   \def\rbracechar{|b}%
   4695   %
   4696   % Non-English letters.
   4697   \def\AA{AA}%
   4698   \def\AE{AE}%
   4699   \def\DH{DZZ}%
   4700   \def\L{L}%
   4701   \def\OE{OE}%
   4702   \def\O{O}%
   4703   \def\TH{ZZZ}%
   4704   \def\aa{aa}%
   4705   \def\ae{ae}%
   4706   \def\dh{dzz}%
   4707   \def\exclamdown{!}%
   4708   \def\l{l}%
   4709   \def\oe{oe}%
   4710   \def\ordf{a}%
   4711   \def\ordm{o}%
   4712   \def\o{o}%
   4713   \def\questiondown{?}%
   4714   \def\ss{ss}%
   4715   \def\th{zzz}%
   4716   %
   4717   \def\LaTeX{LaTeX}%
   4718   \def\TeX{TeX}%
   4719   %
   4720   % Assorted special characters.
   4721   % (The following {} will end up in the sort string, but that's ok.)
   4722   \def\arrow{->}%
   4723   \def\bullet{bullet}%
   4724   \def\comma{,}%
   4725   \def\copyright{copyright}%
   4726   \def\dots{...}%
   4727   \def\enddots{...}%
   4728   \def\equiv{==}%
   4729   \def\error{error}%
   4730   \def\euro{euro}%
   4731   \def\expansion{==>}%
   4732   \def\geq{>=}%
   4733   \def\guillemetleft{<<}%
   4734   \def\guillemetright{>>}%
   4735   \def\guilsinglleft{<}%
   4736   \def\guilsinglright{>}%
   4737   \def\leq{<=}%
   4738   \def\minus{-}%
   4739   \def\point{.}%
   4740   \def\pounds{pounds}%
   4741   \def\print{-|}%
   4742   \def\quotedblbase{"}%
   4743   \def\quotedblleft{"}%
   4744   \def\quotedblright{"}%
   4745   \def\quoteleft{`}%
   4746   \def\quoteright{'}%
   4747   \def\quotesinglbase{,}%
   4748   \def\registeredsymbol{R}%
   4749   \def\result{=>}%
   4750   \def\textdegree{o}%
   4751   %
   4752   \expandafter\ifx\csname SETtxiindexlquoteignore\endcsname\relax
   4753   \else \indexlquoteignore \fi
   4754   %
   4755   % We need to get rid of all macros, leaving only the arguments (if present).
   4756   % Of course this is not nearly correct, but it is the best we can do for now.
   4757   % makeinfo does not expand macros in the argument to @deffn, which ends up
   4758   % writing an index entry, and texindex isn't prepared for an index sort entry
   4759   % that starts with \.
   4760   %
   4761   % Since macro invocations are followed by braces, we can just redefine them
   4762   % to take a single TeX argument.  The case of a macro invocation that
   4763   % goes to end-of-line is not handled.
   4764   %
   4765   \macrolist
   4766 }
   4767 
   4768 % Undocumented (for FSFS 2nd ed.): @set txiindexlquoteignore makes us
   4769 % ignore left quotes in the sort term.
   4770 {\catcode`\`=\active
   4771  \gdef\indexlquoteignore{\let`=\empty}}
   4772 
   4773 \let\indexbackslash=0  %overridden during \printindex.
   4774 \let\SETmarginindex=\relax % put index entries in margin (undocumented)?
   4775 
   4776 % Most index entries go through here, but \dosubind is the general case.
   4777 % #1 is the index name, #2 is the entry text.
   4778 \def\doind#1#2{\dosubind{#1}{#2}{}}
   4779 
   4780 % Workhorse for all \fooindexes.
   4781 % #1 is name of index, #2 is stuff to put there, #3 is subentry --
   4782 % empty if called from \doind, as we usually are (the main exception
   4783 % is with most defuns, which call us directly).
   4784 %
   4785 \def\dosubind#1#2#3{%
   4786   \iflinks
   4787   {%
   4788     % Store the main index entry text (including the third arg).
   4789     \toks0 = {#2}%
   4790     % If third arg is present, precede it with a space.
   4791     \def\thirdarg{#3}%
   4792     \ifx\thirdarg\empty \else
   4793       \toks0 = \expandafter{\the\toks0 \space #3}%
   4794     \fi
   4795     %
   4796     \edef\writeto{\csname#1indfile\endcsname}%
   4797     %
   4798     \safewhatsit\dosubindwrite
   4799   }%
   4800   \fi
   4801 }
   4802 
   4803 % Write the entry in \toks0 to the index file:
   4804 %
   4805 \def\dosubindwrite{%
   4806   % Put the index entry in the margin if desired.
   4807   \ifx\SETmarginindex\relax\else
   4808     \insert\margin{\hbox{\vrule height8pt depth3pt width0pt \the\toks0}}%
   4809   \fi
   4810   %
   4811   % Remember, we are within a group.
   4812   \indexdummies % Must do this here, since \bf, etc expand at this stage
   4813   \def\backslashcurfont{\indexbackslash}% \indexbackslash isn't defined now
   4814       % so it will be output as is; and it will print as backslash.
   4815   %
   4816   % Process the index entry with all font commands turned off, to
   4817   % get the string to sort by.
   4818   {\indexnofonts
   4819    \edef\temp{\the\toks0}% need full expansion
   4820    \xdef\indexsorttmp{\temp}%
   4821   }%
   4822   %
   4823   % Set up the complete index entry, with both the sort key and
   4824   % the original text, including any font commands.  We write
   4825   % three arguments to \entry to the .?? file (four in the
   4826   % subentry case), texindex reduces to two when writing the .??s
   4827   % sorted result.
   4828   \edef\temp{%
   4829     \write\writeto{%
   4830       \string\entry{\indexsorttmp}{\noexpand\folio}{\the\toks0}}%
   4831   }%
   4832   \temp
   4833 }
   4834 
   4835 % Take care of unwanted page breaks/skips around a whatsit:
   4836 %
   4837 % If a skip is the last thing on the list now, preserve it
   4838 % by backing up by \lastskip, doing the \write, then inserting
   4839 % the skip again.  Otherwise, the whatsit generated by the
   4840 % \write or \pdfdest will make \lastskip zero.  The result is that
   4841 % sequences like this:
   4842 % @end defun
   4843 % @tindex whatever
   4844 % @defun ...
   4845 % will have extra space inserted, because the \medbreak in the
   4846 % start of the @defun won't see the skip inserted by the @end of
   4847 % the previous defun.
   4848 %
   4849 % But don't do any of this if we're not in vertical mode.  We
   4850 % don't want to do a \vskip and prematurely end a paragraph.
   4851 %
   4852 % Avoid page breaks due to these extra skips, too.
   4853 %
   4854 % But wait, there is a catch there:
   4855 % We'll have to check whether \lastskip is zero skip.  \ifdim is not
   4856 % sufficient for this purpose, as it ignores stretch and shrink parts
   4857 % of the skip.  The only way seems to be to check the textual
   4858 % representation of the skip.
   4859 %
   4860 % The following is almost like \def\zeroskipmacro{0.0pt} except that
   4861 % the ``p'' and ``t'' characters have catcode \other, not 11 (letter).
   4862 %
   4863 \edef\zeroskipmacro{\expandafter\the\csname z@skip\endcsname}
   4864 %
   4865 \newskip\whatsitskip
   4866 \newcount\whatsitpenalty
   4867 %
   4868 % ..., ready, GO:
   4869 %
   4870 \def\safewhatsit#1{\ifhmode
   4871   #1%
   4872  \else
   4873   % \lastskip and \lastpenalty cannot both be nonzero simultaneously.
   4874   \whatsitskip = \lastskip
   4875   \edef\lastskipmacro{\the\lastskip}%
   4876   \whatsitpenalty = \lastpenalty
   4877   %
   4878   % If \lastskip is nonzero, that means the last item was a
   4879   % skip.  And since a skip is discardable, that means this
   4880   % -\whatsitskip glue we're inserting is preceded by a
   4881   % non-discardable item, therefore it is not a potential
   4882   % breakpoint, therefore no \nobreak needed.
   4883   \ifx\lastskipmacro\zeroskipmacro
   4884   \else
   4885     \vskip-\whatsitskip
   4886   \fi
   4887   %
   4888   #1%
   4889   %
   4890   \ifx\lastskipmacro\zeroskipmacro
   4891     % If \lastskip was zero, perhaps the last item was a penalty, and
   4892     % perhaps it was >=10000, e.g., a \nobreak.  In that case, we want
   4893     % to re-insert the same penalty (values >10000 are used for various
   4894     % signals); since we just inserted a non-discardable item, any
   4895     % following glue (such as a \parskip) would be a breakpoint.  For example:
   4896     %   @deffn deffn-whatever
   4897     %   @vindex index-whatever
   4898     %   Description.
   4899     % would allow a break between the index-whatever whatsit
   4900     % and the "Description." paragraph.
   4901     \ifnum\whatsitpenalty>9999 \penalty\whatsitpenalty \fi
   4902   \else
   4903     % On the other hand, if we had a nonzero \lastskip,
   4904     % this make-up glue would be preceded by a non-discardable item
   4905     % (the whatsit from the \write), so we must insert a \nobreak.
   4906     \nobreak\vskip\whatsitskip
   4907   \fi
   4908 \fi}
   4909 
   4910 % The index entry written in the file actually looks like
   4911 %  \entry {sortstring}{page}{topic}
   4912 % or
   4913 %  \entry {sortstring}{page}{topic}{subtopic}
   4914 % The texindex program reads in these files and writes files
   4915 % containing these kinds of lines:
   4916 %  \initial {c}
   4917 %     before the first topic whose initial is c
   4918 %  \entry {topic}{pagelist}
   4919 %     for a topic that is used without subtopics
   4920 %  \primary {topic}
   4921 %     for the beginning of a topic that is used with subtopics
   4922 %  \secondary {subtopic}{pagelist}
   4923 %     for each subtopic.
   4924 
   4925 % Define the user-accessible indexing commands
   4926 % @findex, @vindex, @kindex, @cindex.
   4927 
   4928 \def\findex {\fnindex}
   4929 \def\kindex {\kyindex}
   4930 \def\cindex {\cpindex}
   4931 \def\vindex {\vrindex}
   4932 \def\tindex {\tpindex}
   4933 \def\pindex {\pgindex}
   4934 
   4935 \def\cindexsub {\begingroup\obeylines\cindexsub}
   4936 {\obeylines %
   4937 \gdef\cindexsub "#1" #2^^M{\endgroup %
   4938 \dosubind{cp}{#2}{#1}}}
   4939 
   4940 % Define the macros used in formatting output of the sorted index material.
   4941 
   4942 % @printindex causes a particular index (the ??s file) to get printed.
   4943 % It does not print any chapter heading (usually an @unnumbered).
   4944 %
   4945 \parseargdef\printindex{\begingroup
   4946   \dobreak \chapheadingskip{10000}%
   4947   %
   4948   \smallfonts \rm
   4949   \tolerance = 9500
   4950   \plainfrenchspacing
   4951   \everypar = {}% don't want the \kern\-parindent from indentation suppression.
   4952   %
   4953   % See if the index file exists and is nonempty.
   4954   % Change catcode of @ here so that if the index file contains
   4955   % \initial {@}
   4956   % as its first line, TeX doesn't complain about mismatched braces
   4957   % (because it thinks @} is a control sequence).
   4958   \catcode`\@ = 11
   4959   \openin 1 \jobname.#1s
   4960   \ifeof 1
   4961     % \enddoublecolumns gets confused if there is no text in the index,
   4962     % and it loses the chapter title and the aux file entries for the
   4963     % index.  The easiest way to prevent this problem is to make sure
   4964     % there is some text.
   4965     \putwordIndexNonexistent
   4966   \else
   4967     %
   4968     % If the index file exists but is empty, then \openin leaves \ifeof
   4969     % false.  We have to make TeX try to read something from the file, so
   4970     % it can discover if there is anything in it.
   4971     \read 1 to \temp
   4972     \ifeof 1
   4973       \putwordIndexIsEmpty
   4974     \else
   4975       % Index files are almost Texinfo source, but we use \ as the escape
   4976       % character.  It would be better to use @, but that's too big a change
   4977       % to make right now.
   4978       \def\indexbackslash{\backslashcurfont}%
   4979       \catcode`\\ = 0
   4980       \escapechar = `\\
   4981       \begindoublecolumns
   4982       \input \jobname.#1s
   4983       \enddoublecolumns
   4984     \fi
   4985   \fi
   4986   \closein 1
   4987 \endgroup}
   4988 
   4989 % These macros are used by the sorted index file itself.
   4990 % Change them to control the appearance of the index.
   4991 
   4992 \def\initial#1{{%
   4993   % Some minor font changes for the special characters.
   4994   \let\tentt=\sectt \let\tt=\sectt \let\sf=\sectt
   4995   %
   4996   % Remove any glue we may have, we'll be inserting our own.
   4997   \removelastskip
   4998   %
   4999   % We like breaks before the index initials, so insert a bonus.
   5000   \nobreak
   5001   \vskip 0pt plus 3\baselineskip
   5002   \penalty 0
   5003   \vskip 0pt plus -3\baselineskip
   5004   %
   5005   % Typeset the initial.  Making this add up to a whole number of
   5006   % baselineskips increases the chance of the dots lining up from column
   5007   % to column.  It still won't often be perfect, because of the stretch
   5008   % we need before each entry, but it's better.
   5009   %
   5010   % No shrink because it confuses \balancecolumns.
   5011   \vskip 1.67\baselineskip plus .5\baselineskip
   5012   \leftline{\secbf #1}%
   5013   % Do our best not to break after the initial.
   5014   \nobreak
   5015   \vskip .33\baselineskip plus .1\baselineskip
   5016 }}
   5017 
   5018 % \entry typesets a paragraph consisting of the text (#1), dot leaders, and
   5019 % then page number (#2) flushed to the right margin.  It is used for index
   5020 % and table of contents entries.  The paragraph is indented by \leftskip.
   5021 %
   5022 % A straightforward implementation would start like this:
   5023 %	\def\entry#1#2{...
   5024 % But this freezes the catcodes in the argument, and can cause problems to
   5025 % @code, which sets - active.  This problem was fixed by a kludge---
   5026 % ``-'' was active throughout whole index, but this isn't really right.
   5027 % The right solution is to prevent \entry from swallowing the whole text.
   5028 %                                 --kasal, 21nov03
   5029 \def\entry{%
   5030   \begingroup
   5031     %
   5032     % Start a new paragraph if necessary, so our assignments below can't
   5033     % affect previous text.
   5034     \par
   5035     %
   5036     % Do not fill out the last line with white space.
   5037     \parfillskip = 0in
   5038     %
   5039     % No extra space above this paragraph.
   5040     \parskip = 0in
   5041     %
   5042     % Do not prefer a separate line ending with a hyphen to fewer lines.
   5043     \finalhyphendemerits = 0
   5044     %
   5045     % \hangindent is only relevant when the entry text and page number
   5046     % don't both fit on one line.  In that case, bob suggests starting the
   5047     % dots pretty far over on the line.  Unfortunately, a large
   5048     % indentation looks wrong when the entry text itself is broken across
   5049     % lines.  So we use a small indentation and put up with long leaders.
   5050     %
   5051     % \hangafter is reset to 1 (which is the value we want) at the start
   5052     % of each paragraph, so we need not do anything with that.
   5053     \hangindent = 2em
   5054     %
   5055     % When the entry text needs to be broken, just fill out the first line
   5056     % with blank space.
   5057     \rightskip = 0pt plus1fil
   5058     %
   5059     % A bit of stretch before each entry for the benefit of balancing
   5060     % columns.
   5061     \vskip 0pt plus1pt
   5062     %
   5063     % When reading the text of entry, convert explicit line breaks
   5064     % from @* into spaces.  The user might give these in long section
   5065     % titles, for instance.
   5066     \def\*{\unskip\space\ignorespaces}%
   5067     \def\entrybreak{\hfil\break}%
   5068     %
   5069     % Swallow the left brace of the text (first parameter):
   5070     \afterassignment\doentry
   5071     \let\temp =
   5072 }
   5073 \def\entrybreak{\unskip\space\ignorespaces}%
   5074 \def\doentry{%
   5075     \bgroup % Instead of the swallowed brace.
   5076       \noindent
   5077       \aftergroup\finishentry
   5078       % And now comes the text of the entry.
   5079 }
   5080 \def\finishentry#1{%
   5081     % #1 is the page number.
   5082     %
   5083     % The following is kludged to not output a line of dots in the index if
   5084     % there are no page numbers.  The next person who breaks this will be
   5085     % cursed by a Unix daemon.
   5086     \setbox\boxA = \hbox{#1}%
   5087     \ifdim\wd\boxA = 0pt
   5088       \ %
   5089     \else
   5090       %
   5091       % If we must, put the page number on a line of its own, and fill out
   5092       % this line with blank space.  (The \hfil is overwhelmed with the
   5093       % fill leaders glue in \indexdotfill if the page number does fit.)
   5094       \hfil\penalty50
   5095       \null\nobreak\indexdotfill % Have leaders before the page number.
   5096       %
   5097       % The `\ ' here is removed by the implicit \unskip that TeX does as
   5098       % part of (the primitive) \par.  Without it, a spurious underfull
   5099       % \hbox ensues.
   5100       \ifpdf
   5101 	\pdfgettoks#1.%
   5102 	\ \the\toksA
   5103       \else
   5104 	\ #1%
   5105       \fi
   5106     \fi
   5107     \par
   5108   \endgroup
   5109 }
   5110 
   5111 % Like plain.tex's \dotfill, except uses up at least 1 em.
   5112 \def\indexdotfill{\cleaders
   5113   \hbox{$\mathsurround=0pt \mkern1.5mu.\mkern1.5mu$}\hskip 1em plus 1fill}
   5114 
   5115 \def\primary #1{\line{#1\hfil}}
   5116 
   5117 \newskip\secondaryindent \secondaryindent=0.5cm
   5118 \def\secondary#1#2{{%
   5119   \parfillskip=0in
   5120   \parskip=0in
   5121   \hangindent=1in
   5122   \hangafter=1
   5123   \noindent\hskip\secondaryindent\hbox{#1}\indexdotfill
   5124   \ifpdf
   5125     \pdfgettoks#2.\ \the\toksA % The page number ends the paragraph.
   5126   \else
   5127     #2
   5128   \fi
   5129   \par
   5130 }}
   5131 
   5132 % Define two-column mode, which we use to typeset indexes.
   5133 % Adapted from the TeXbook, page 416, which is to say,
   5134 % the manmac.tex format used to print the TeXbook itself.
   5135 \catcode`\@=11
   5136 
   5137 \newbox\partialpage
   5138 \newdimen\doublecolumnhsize
   5139 
   5140 \def\begindoublecolumns{\begingroup % ended by \enddoublecolumns
   5141   % Grab any single-column material above us.
   5142   \output = {%
   5143     %
   5144     % Here is a possibility not foreseen in manmac: if we accumulate a
   5145     % whole lot of material, we might end up calling this \output
   5146     % routine twice in a row (see the doublecol-lose test, which is
   5147     % essentially a couple of indexes with @setchapternewpage off).  In
   5148     % that case we just ship out what is in \partialpage with the normal
   5149     % output routine.  Generally, \partialpage will be empty when this
   5150     % runs and this will be a no-op.  See the indexspread.tex test case.
   5151     \ifvoid\partialpage \else
   5152       \onepageout{\pagecontents\partialpage}%
   5153     \fi
   5154     %
   5155     \global\setbox\partialpage = \vbox{%
   5156       % Unvbox the main output page.
   5157       \unvbox\PAGE
   5158       \kern-\topskip \kern\baselineskip
   5159     }%
   5160   }%
   5161   \eject % run that output routine to set \partialpage
   5162   %
   5163   % Use the double-column output routine for subsequent pages.
   5164   \output = {\doublecolumnout}%
   5165   %
   5166   % Change the page size parameters.  We could do this once outside this
   5167   % routine, in each of @smallbook, @afourpaper, and the default 8.5x11
   5168   % format, but then we repeat the same computation.  Repeating a couple
   5169   % of assignments once per index is clearly meaningless for the
   5170   % execution time, so we may as well do it in one place.
   5171   %
   5172   % First we halve the line length, less a little for the gutter between
   5173   % the columns.  We compute the gutter based on the line length, so it
   5174   % changes automatically with the paper format.  The magic constant
   5175   % below is chosen so that the gutter has the same value (well, +-<1pt)
   5176   % as it did when we hard-coded it.
   5177   %
   5178   % We put the result in a separate register, \doublecolumhsize, so we
   5179   % can restore it in \pagesofar, after \hsize itself has (potentially)
   5180   % been clobbered.
   5181   %
   5182   \doublecolumnhsize = \hsize
   5183     \advance\doublecolumnhsize by -.04154\hsize
   5184     \divide\doublecolumnhsize by 2
   5185   \hsize = \doublecolumnhsize
   5186   %
   5187   % Double the \vsize as well.  (We don't need a separate register here,
   5188   % since nobody clobbers \vsize.)
   5189   \vsize = 2\vsize
   5190 }
   5191 
   5192 % The double-column output routine for all double-column pages except
   5193 % the last.
   5194 %
   5195 \def\doublecolumnout{%
   5196   \splittopskip=\topskip \splitmaxdepth=\maxdepth
   5197   % Get the available space for the double columns -- the normal
   5198   % (undoubled) page height minus any material left over from the
   5199   % previous page.
   5200   \dimen@ = \vsize
   5201   \divide\dimen@ by 2
   5202   \advance\dimen@ by -\ht\partialpage
   5203   %
   5204   % box0 will be the left-hand column, box2 the right.
   5205   \setbox0=\vsplit255 to\dimen@ \setbox2=\vsplit255 to\dimen@
   5206   \onepageout\pagesofar
   5207   \unvbox255
   5208   \penalty\outputpenalty
   5209 }
   5210 %
   5211 % Re-output the contents of the output page -- any previous material,
   5212 % followed by the two boxes we just split, in box0 and box2.
   5213 \def\pagesofar{%
   5214   \unvbox\partialpage
   5215   %
   5216   \hsize = \doublecolumnhsize
   5217   \wd0=\hsize \wd2=\hsize
   5218   \hbox to\pagewidth{\box0\hfil\box2}%
   5219 }
   5220 %
   5221 % All done with double columns.
   5222 \def\enddoublecolumns{%
   5223   % The following penalty ensures that the page builder is exercised
   5224   % _before_ we change the output routine.  This is necessary in the
   5225   % following situation:
   5226   %
   5227   % The last section of the index consists only of a single entry.
   5228   % Before this section, \pagetotal is less than \pagegoal, so no
   5229   % break occurs before the last section starts.  However, the last
   5230   % section, consisting of \initial and the single \entry, does not
   5231   % fit on the page and has to be broken off.  Without the following
   5232   % penalty the page builder will not be exercised until \eject
   5233   % below, and by that time we'll already have changed the output
   5234   % routine to the \balancecolumns version, so the next-to-last
   5235   % double-column page will be processed with \balancecolumns, which
   5236   % is wrong:  The two columns will go to the main vertical list, with
   5237   % the broken-off section in the recent contributions.  As soon as
   5238   % the output routine finishes, TeX starts reconsidering the page
   5239   % break.  The two columns and the broken-off section both fit on the
   5240   % page, because the two columns now take up only half of the page
   5241   % goal.  When TeX sees \eject from below which follows the final
   5242   % section, it invokes the new output routine that we've set after
   5243   % \balancecolumns below; \onepageout will try to fit the two columns
   5244   % and the final section into the vbox of \pageheight (see
   5245   % \pagebody), causing an overfull box.
   5246   %
   5247   % Note that glue won't work here, because glue does not exercise the
   5248   % page builder, unlike penalties (see The TeXbook, pp. 280-281).
   5249   \penalty0
   5250   %
   5251   \output = {%
   5252     % Split the last of the double-column material.  Leave it on the
   5253     % current page, no automatic page break.
   5254     \balancecolumns
   5255     %
   5256     % If we end up splitting too much material for the current page,
   5257     % though, there will be another page break right after this \output
   5258     % invocation ends.  Having called \balancecolumns once, we do not
   5259     % want to call it again.  Therefore, reset \output to its normal
   5260     % definition right away.  (We hope \balancecolumns will never be
   5261     % called on to balance too much material, but if it is, this makes
   5262     % the output somewhat more palatable.)
   5263     \global\output = {\onepageout{\pagecontents\PAGE}}%
   5264   }%
   5265   \eject
   5266   \endgroup % started in \begindoublecolumns
   5267   %
   5268   % \pagegoal was set to the doubled \vsize above, since we restarted
   5269   % the current page.  We're now back to normal single-column
   5270   % typesetting, so reset \pagegoal to the normal \vsize (after the
   5271   % \endgroup where \vsize got restored).
   5272   \pagegoal = \vsize
   5273 }
   5274 %
   5275 % Called at the end of the double column material.
   5276 \def\balancecolumns{%
   5277   \setbox0 = \vbox{\unvbox255}% like \box255 but more efficient, see p.120.
   5278   \dimen@ = \ht0
   5279   \advance\dimen@ by \topskip
   5280   \advance\dimen@ by-\baselineskip
   5281   \divide\dimen@ by 2 % target to split to
   5282   %debug\message{final 2-column material height=\the\ht0, target=\the\dimen@.}%
   5283   \splittopskip = \topskip
   5284   % Loop until we get a decent breakpoint.
   5285   {%
   5286     \vbadness = 10000
   5287     \loop
   5288       \global\setbox3 = \copy0
   5289       \global\setbox1 = \vsplit3 to \dimen@
   5290     \ifdim\ht3>\dimen@
   5291       \global\advance\dimen@ by 1pt
   5292     \repeat
   5293   }%
   5294   %debug\message{split to \the\dimen@, column heights: \the\ht1, \the\ht3.}%
   5295   \setbox0=\vbox to\dimen@{\unvbox1}%
   5296   \setbox2=\vbox to\dimen@{\unvbox3}%
   5297   %
   5298   \pagesofar
   5299 }
   5300 \catcode`\@ = \other
   5301 
   5302 
   5303 \message{sectioning,}
   5304 % Chapters, sections, etc.
   5305 
   5306 % Let's start with @part.
   5307 \outer\parseargdef\part{\partzzz{#1}}
   5308 \def\partzzz#1{%
   5309   \chapoddpage
   5310   \null
   5311   \vskip.3\vsize  % move it down on the page a bit
   5312   \begingroup
   5313     \noindent \titlefonts\rmisbold #1\par % the text
   5314     \let\lastnode=\empty      % no node to associate with
   5315     \writetocentry{part}{#1}{}% but put it in the toc
   5316     \headingsoff              % no headline or footline on the part page
   5317     \chapoddpage
   5318   \endgroup
   5319 }
   5320 
   5321 % \unnumberedno is an oxymoron.  But we count the unnumbered
   5322 % sections so that we can refer to them unambiguously in the pdf
   5323 % outlines by their "section number".  We avoid collisions with chapter
   5324 % numbers by starting them at 10000.  (If a document ever has 10000
   5325 % chapters, we're in trouble anyway, I'm sure.)
   5326 \newcount\unnumberedno \unnumberedno = 10000
   5327 \newcount\chapno
   5328 \newcount\secno        \secno=0
   5329 \newcount\subsecno     \subsecno=0
   5330 \newcount\subsubsecno  \subsubsecno=0
   5331 
   5332 % This counter is funny since it counts through charcodes of letters A, B, ...
   5333 \newcount\appendixno  \appendixno = `\@
   5334 %
   5335 % \def\appendixletter{\char\the\appendixno}
   5336 % We do the following ugly conditional instead of the above simple
   5337 % construct for the sake of pdftex, which needs the actual
   5338 % letter in the expansion, not just typeset.
   5339 %
   5340 \def\appendixletter{%
   5341   \ifnum\appendixno=`A A%
   5342   \else\ifnum\appendixno=`B B%
   5343   \else\ifnum\appendixno=`C C%
   5344   \else\ifnum\appendixno=`D D%
   5345   \else\ifnum\appendixno=`E E%
   5346   \else\ifnum\appendixno=`F F%
   5347   \else\ifnum\appendixno=`G G%
   5348   \else\ifnum\appendixno=`H H%
   5349   \else\ifnum\appendixno=`I I%
   5350   \else\ifnum\appendixno=`J J%
   5351   \else\ifnum\appendixno=`K K%
   5352   \else\ifnum\appendixno=`L L%
   5353   \else\ifnum\appendixno=`M M%
   5354   \else\ifnum\appendixno=`N N%
   5355   \else\ifnum\appendixno=`O O%
   5356   \else\ifnum\appendixno=`P P%
   5357   \else\ifnum\appendixno=`Q Q%
   5358   \else\ifnum\appendixno=`R R%
   5359   \else\ifnum\appendixno=`S S%
   5360   \else\ifnum\appendixno=`T T%
   5361   \else\ifnum\appendixno=`U U%
   5362   \else\ifnum\appendixno=`V V%
   5363   \else\ifnum\appendixno=`W W%
   5364   \else\ifnum\appendixno=`X X%
   5365   \else\ifnum\appendixno=`Y Y%
   5366   \else\ifnum\appendixno=`Z Z%
   5367   % The \the is necessary, despite appearances, because \appendixletter is
   5368   % expanded while writing the .toc file.  \char\appendixno is not
   5369   % expandable, thus it is written literally, thus all appendixes come out
   5370   % with the same letter (or @) in the toc without it.
   5371   \else\char\the\appendixno
   5372   \fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi
   5373   \fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi\fi}
   5374 
   5375 % Each @chapter defines these (using marks) as the number+name, number
   5376 % and name of the chapter.  Page headings and footings can use
   5377 % these.  @section does likewise.
   5378 \def\thischapter{}
   5379 \def\thischapternum{}
   5380 \def\thischaptername{}
   5381 \def\thissection{}
   5382 \def\thissectionnum{}
   5383 \def\thissectionname{}
   5384 
   5385 \newcount\absseclevel % used to calculate proper heading level
   5386 \newcount\secbase\secbase=0 % @raisesections/@lowersections modify this count
   5387 
   5388 % @raisesections: treat @section as chapter, @subsection as section, etc.
   5389 \def\raisesections{\global\advance\secbase by -1}
   5390 \let\up=\raisesections % original BFox name
   5391 
   5392 % @lowersections: treat @chapter as section, @section as subsection, etc.
   5393 \def\lowersections{\global\advance\secbase by 1}
   5394 \let\down=\lowersections % original BFox name
   5395 
   5396 % we only have subsub.
   5397 \chardef\maxseclevel = 3
   5398 %
   5399 % A numbered section within an unnumbered changes to unnumbered too.
   5400 % To achieve this, remember the "biggest" unnum. sec. we are currently in:
   5401 \chardef\unnlevel = \maxseclevel
   5402 %
   5403 % Trace whether the current chapter is an appendix or not:
   5404 % \chapheadtype is "N" or "A", unnumbered chapters are ignored.
   5405 \def\chapheadtype{N}
   5406 
   5407 % Choose a heading macro
   5408 % #1 is heading type
   5409 % #2 is heading level
   5410 % #3 is text for heading
   5411 \def\genhead#1#2#3{%
   5412   % Compute the abs. sec. level:
   5413   \absseclevel=#2
   5414   \advance\absseclevel by \secbase
   5415   % Make sure \absseclevel doesn't fall outside the range:
   5416   \ifnum \absseclevel < 0
   5417     \absseclevel = 0
   5418   \else
   5419     \ifnum \absseclevel > 3
   5420       \absseclevel = 3
   5421     \fi
   5422   \fi
   5423   % The heading type:
   5424   \def\headtype{#1}%
   5425   \if \headtype U%
   5426     \ifnum \absseclevel < \unnlevel
   5427       \chardef\unnlevel = \absseclevel
   5428     \fi
   5429   \else
   5430     % Check for appendix sections:
   5431     \ifnum \absseclevel = 0
   5432       \edef\chapheadtype{\headtype}%
   5433     \else
   5434       \if \headtype A\if \chapheadtype N%
   5435 	\errmessage{@appendix... within a non-appendix chapter}%
   5436       \fi\fi
   5437     \fi
   5438     % Check for numbered within unnumbered:
   5439     \ifnum \absseclevel > \unnlevel
   5440       \def\headtype{U}%
   5441     \else
   5442       \chardef\unnlevel = 3
   5443     \fi
   5444   \fi
   5445   % Now print the heading:
   5446   \if \headtype U%
   5447     \ifcase\absseclevel
   5448 	\unnumberedzzz{#3}%
   5449     \or \unnumberedseczzz{#3}%
   5450     \or \unnumberedsubseczzz{#3}%
   5451     \or \unnumberedsubsubseczzz{#3}%
   5452     \fi
   5453   \else
   5454     \if \headtype A%
   5455       \ifcase\absseclevel
   5456 	  \appendixzzz{#3}%
   5457       \or \appendixsectionzzz{#3}%
   5458       \or \appendixsubseczzz{#3}%
   5459       \or \appendixsubsubseczzz{#3}%
   5460       \fi
   5461     \else
   5462       \ifcase\absseclevel
   5463 	  \chapterzzz{#3}%
   5464       \or \seczzz{#3}%
   5465       \or \numberedsubseczzz{#3}%
   5466       \or \numberedsubsubseczzz{#3}%
   5467       \fi
   5468     \fi
   5469   \fi
   5470   \suppressfirstparagraphindent
   5471 }
   5472 
   5473 % an interface:
   5474 \def\numhead{\genhead N}
   5475 \def\apphead{\genhead A}
   5476 \def\unnmhead{\genhead U}
   5477 
   5478 % @chapter, @appendix, @unnumbered.  Increment top-level counter, reset
   5479 % all lower-level sectioning counters to zero.
   5480 %
   5481 % Also set \chaplevelprefix, which we prepend to @float sequence numbers
   5482 % (e.g., figures), q.v.  By default (before any chapter), that is empty.
   5483 \let\chaplevelprefix = \empty
   5484 %
   5485 \outer\parseargdef\chapter{\numhead0{#1}} % normally numhead0 calls chapterzzz
   5486 \def\chapterzzz#1{%
   5487   % section resetting is \global in case the chapter is in a group, such
   5488   % as an @include file.
   5489   \global\secno=0 \global\subsecno=0 \global\subsubsecno=0
   5490     \global\advance\chapno by 1
   5491   %
   5492   % Used for \float.
   5493   \gdef\chaplevelprefix{\the\chapno.}%
   5494   \resetallfloatnos
   5495   %
   5496   % \putwordChapter can contain complex things in translations.
   5497   \toks0=\expandafter{\putwordChapter}%
   5498   \message{\the\toks0 \space \the\chapno}%
   5499   %
   5500   % Write the actual heading.
   5501   \chapmacro{#1}{Ynumbered}{\the\chapno}%
   5502   %
   5503   % So @section and the like are numbered underneath this chapter.
   5504   \global\let\section = \numberedsec
   5505   \global\let\subsection = \numberedsubsec
   5506   \global\let\subsubsection = \numberedsubsubsec
   5507 }
   5508 
   5509 \outer\parseargdef\appendix{\apphead0{#1}} % normally calls appendixzzz
   5510 %
   5511 \def\appendixzzz#1{%
   5512   \global\secno=0 \global\subsecno=0 \global\subsubsecno=0
   5513     \global\advance\appendixno by 1
   5514   \gdef\chaplevelprefix{\appendixletter.}%
   5515   \resetallfloatnos
   5516   %
   5517   % \putwordAppendix can contain complex things in translations.
   5518   \toks0=\expandafter{\putwordAppendix}%
   5519   \message{\the\toks0 \space \appendixletter}%
   5520   %
   5521   \chapmacro{#1}{Yappendix}{\appendixletter}%
   5522   %
   5523   \global\let\section = \appendixsec
   5524   \global\let\subsection = \appendixsubsec
   5525   \global\let\subsubsection = \appendixsubsubsec
   5526 }
   5527 
   5528 % normally unnmhead0 calls unnumberedzzz:
   5529 \outer\parseargdef\unnumbered{\unnmhead0{#1}}
   5530 \def\unnumberedzzz#1{%
   5531   \global\secno=0 \global\subsecno=0 \global\subsubsecno=0
   5532     \global\advance\unnumberedno by 1
   5533   %
   5534   % Since an unnumbered has no number, no prefix for figures.
   5535   \global\let\chaplevelprefix = \empty
   5536   \resetallfloatnos
   5537   %
   5538   % This used to be simply \message{#1}, but TeX fully expands the
   5539   % argument to \message.  Therefore, if #1 contained @-commands, TeX
   5540   % expanded them.  For example, in `@unnumbered The @cite{Book}', TeX
   5541   % expanded @cite (which turns out to cause errors because \cite is meant
   5542   % to be executed, not expanded).
   5543   %
   5544   % Anyway, we don't want the fully-expanded definition of @cite to appear
   5545   % as a result of the \message, we just want `@cite' itself.  We use
   5546   % \the<toks register> to achieve this: TeX expands \the<toks> only once,
   5547   % simply yielding the contents of <toks register>.  (We also do this for
   5548   % the toc entries.)
   5549   \toks0 = {#1}%
   5550   \message{(\the\toks0)}%
   5551   %
   5552   \chapmacro{#1}{Ynothing}{\the\unnumberedno}%
   5553   %
   5554   \global\let\section = \unnumberedsec
   5555   \global\let\subsection = \unnumberedsubsec
   5556   \global\let\subsubsection = \unnumberedsubsubsec
   5557 }
   5558 
   5559 % @centerchap is like @unnumbered, but the heading is centered.
   5560 \outer\parseargdef\centerchap{%
   5561   % Well, we could do the following in a group, but that would break
   5562   % an assumption that \chapmacro is called at the outermost level.
   5563   % Thus we are safer this way:		--kasal, 24feb04
   5564   \let\centerparametersmaybe = \centerparameters
   5565   \unnmhead0{#1}%
   5566   \let\centerparametersmaybe = \relax
   5567 }
   5568 
   5569 % @top is like @unnumbered.
   5570 \let\top\unnumbered
   5571 
   5572 % Sections.
   5573 %
   5574 \outer\parseargdef\numberedsec{\numhead1{#1}} % normally calls seczzz
   5575 \def\seczzz#1{%
   5576   \global\subsecno=0 \global\subsubsecno=0  \global\advance\secno by 1
   5577   \sectionheading{#1}{sec}{Ynumbered}{\the\chapno.\the\secno}%
   5578 }
   5579 
   5580 % normally calls appendixsectionzzz:
   5581 \outer\parseargdef\appendixsection{\apphead1{#1}}
   5582 \def\appendixsectionzzz#1{%
   5583   \global\subsecno=0 \global\subsubsecno=0  \global\advance\secno by 1
   5584   \sectionheading{#1}{sec}{Yappendix}{\appendixletter.\the\secno}%
   5585 }
   5586 \let\appendixsec\appendixsection
   5587 
   5588 % normally calls unnumberedseczzz:
   5589 \outer\parseargdef\unnumberedsec{\unnmhead1{#1}}
   5590 \def\unnumberedseczzz#1{%
   5591   \global\subsecno=0 \global\subsubsecno=0  \global\advance\secno by 1
   5592   \sectionheading{#1}{sec}{Ynothing}{\the\unnumberedno.\the\secno}%
   5593 }
   5594 
   5595 % Subsections.
   5596 %
   5597 % normally calls numberedsubseczzz:
   5598 \outer\parseargdef\numberedsubsec{\numhead2{#1}}
   5599 \def\numberedsubseczzz#1{%
   5600   \global\subsubsecno=0  \global\advance\subsecno by 1
   5601   \sectionheading{#1}{subsec}{Ynumbered}{\the\chapno.\the\secno.\the\subsecno}%
   5602 }
   5603 
   5604 % normally calls appendixsubseczzz:
   5605 \outer\parseargdef\appendixsubsec{\apphead2{#1}}
   5606 \def\appendixsubseczzz#1{%
   5607   \global\subsubsecno=0  \global\advance\subsecno by 1
   5608   \sectionheading{#1}{subsec}{Yappendix}%
   5609                  {\appendixletter.\the\secno.\the\subsecno}%
   5610 }
   5611 
   5612 % normally calls unnumberedsubseczzz:
   5613 \outer\parseargdef\unnumberedsubsec{\unnmhead2{#1}}
   5614 \def\unnumberedsubseczzz#1{%
   5615   \global\subsubsecno=0  \global\advance\subsecno by 1
   5616   \sectionheading{#1}{subsec}{Ynothing}%
   5617                  {\the\unnumberedno.\the\secno.\the\subsecno}%
   5618 }
   5619 
   5620 % Subsubsections.
   5621 %
   5622 % normally numberedsubsubseczzz:
   5623 \outer\parseargdef\numberedsubsubsec{\numhead3{#1}}
   5624 \def\numberedsubsubseczzz#1{%
   5625   \global\advance\subsubsecno by 1
   5626   \sectionheading{#1}{subsubsec}{Ynumbered}%
   5627                  {\the\chapno.\the\secno.\the\subsecno.\the\subsubsecno}%
   5628 }
   5629 
   5630 % normally appendixsubsubseczzz:
   5631 \outer\parseargdef\appendixsubsubsec{\apphead3{#1}}
   5632 \def\appendixsubsubseczzz#1{%
   5633   \global\advance\subsubsecno by 1
   5634   \sectionheading{#1}{subsubsec}{Yappendix}%
   5635                  {\appendixletter.\the\secno.\the\subsecno.\the\subsubsecno}%
   5636 }
   5637 
   5638 % normally unnumberedsubsubseczzz:
   5639 \outer\parseargdef\unnumberedsubsubsec{\unnmhead3{#1}}
   5640 \def\unnumberedsubsubseczzz#1{%
   5641   \global\advance\subsubsecno by 1
   5642   \sectionheading{#1}{subsubsec}{Ynothing}%
   5643                  {\the\unnumberedno.\the\secno.\the\subsecno.\the\subsubsecno}%
   5644 }
   5645 
   5646 % These macros control what the section commands do, according
   5647 % to what kind of chapter we are in (ordinary, appendix, or unnumbered).
   5648 % Define them by default for a numbered chapter.
   5649 \let\section = \numberedsec
   5650 \let\subsection = \numberedsubsec
   5651 \let\subsubsection = \numberedsubsubsec
   5652 
   5653 % Define @majorheading, @heading and @subheading
   5654 
   5655 \def\majorheading{%
   5656   {\advance\chapheadingskip by 10pt \chapbreak }%
   5657   \parsearg\chapheadingzzz
   5658 }
   5659 
   5660 \def\chapheading{\chapbreak \parsearg\chapheadingzzz}
   5661 \def\chapheadingzzz#1{%
   5662   \vbox{\chapfonts \raggedtitlesettings #1\par}%
   5663   \nobreak\bigskip \nobreak
   5664   \suppressfirstparagraphindent
   5665 }
   5666 
   5667 % @heading, @subheading, @subsubheading.
   5668 \parseargdef\heading{\sectionheading{#1}{sec}{Yomitfromtoc}{}
   5669   \suppressfirstparagraphindent}
   5670 \parseargdef\subheading{\sectionheading{#1}{subsec}{Yomitfromtoc}{}
   5671   \suppressfirstparagraphindent}
   5672 \parseargdef\subsubheading{\sectionheading{#1}{subsubsec}{Yomitfromtoc}{}
   5673   \suppressfirstparagraphindent}
   5674 
   5675 % These macros generate a chapter, section, etc. heading only
   5676 % (including whitespace, linebreaking, etc. around it),
   5677 % given all the information in convenient, parsed form.
   5678 
   5679 % Args are the skip and penalty (usually negative)
   5680 \def\dobreak#1#2{\par\ifdim\lastskip<#1\removelastskip\penalty#2\vskip#1\fi}
   5681 
   5682 % Parameter controlling skip before chapter headings (if needed)
   5683 \newskip\chapheadingskip
   5684 
   5685 % Define plain chapter starts, and page on/off switching for it.
   5686 \def\chapbreak{\dobreak \chapheadingskip {-4000}}
   5687 \def\chappager{\par\vfill\supereject}
   5688 % Because \domark is called before \chapoddpage, the filler page will
   5689 % get the headings for the next chapter, which is wrong.  But we don't
   5690 % care -- we just disable all headings on the filler page.
   5691 \def\chapoddpage{%
   5692   \chappager
   5693   \ifodd\pageno \else
   5694     \begingroup
   5695       \headingsoff
   5696       \null
   5697       \chappager
   5698     \endgroup
   5699   \fi
   5700 }
   5701 
   5702 \def\setchapternewpage #1 {\csname CHAPPAG#1\endcsname}
   5703 
   5704 \def\CHAPPAGoff{%
   5705 \global\let\contentsalignmacro = \chappager
   5706 \global\let\pchapsepmacro=\chapbreak
   5707 \global\let\pagealignmacro=\chappager}
   5708 
   5709 \def\CHAPPAGon{%
   5710 \global\let\contentsalignmacro = \chappager
   5711 \global\let\pchapsepmacro=\chappager
   5712 \global\let\pagealignmacro=\chappager
   5713 \global\def\HEADINGSon{\HEADINGSsingle}}
   5714 
   5715 \def\CHAPPAGodd{%
   5716 \global\let\contentsalignmacro = \chapoddpage
   5717 \global\let\pchapsepmacro=\chapoddpage
   5718 \global\let\pagealignmacro=\chapoddpage
   5719 \global\def\HEADINGSon{\HEADINGSdouble}}
   5720 
   5721 \CHAPPAGon
   5722 
   5723 % Chapter opening.
   5724 %
   5725 % #1 is the text, #2 is the section type (Ynumbered, Ynothing,
   5726 % Yappendix, Yomitfromtoc), #3 the chapter number.
   5727 %
   5728 % To test against our argument.
   5729 \def\Ynothingkeyword{Ynothing}
   5730 \def\Yomitfromtockeyword{Yomitfromtoc}
   5731 \def\Yappendixkeyword{Yappendix}
   5732 %
   5733 \def\chapmacro#1#2#3{%
   5734   % Insert the first mark before the heading break (see notes for \domark).
   5735   \let\prevchapterdefs=\lastchapterdefs
   5736   \let\prevsectiondefs=\lastsectiondefs
   5737   \gdef\lastsectiondefs{\gdef\thissectionname{}\gdef\thissectionnum{}%
   5738                         \gdef\thissection{}}%
   5739   %
   5740   \def\temptype{#2}%
   5741   \ifx\temptype\Ynothingkeyword
   5742     \gdef\lastchapterdefs{\gdef\thischaptername{#1}\gdef\thischapternum{}%
   5743                           \gdef\thischapter{\thischaptername}}%
   5744   \else\ifx\temptype\Yomitfromtockeyword
   5745     \gdef\lastchapterdefs{\gdef\thischaptername{#1}\gdef\thischapternum{}%
   5746                           \gdef\thischapter{}}%
   5747   \else\ifx\temptype\Yappendixkeyword
   5748     \toks0={#1}%
   5749     \xdef\lastchapterdefs{%
   5750       \gdef\noexpand\thischaptername{\the\toks0}%
   5751       \gdef\noexpand\thischapternum{\appendixletter}%
   5752       % \noexpand\putwordAppendix avoids expanding indigestible
   5753       % commands in some of the translations.
   5754       \gdef\noexpand\thischapter{\noexpand\putwordAppendix{}
   5755                                  \noexpand\thischapternum:
   5756                                  \noexpand\thischaptername}%
   5757     }%
   5758   \else
   5759     \toks0={#1}%
   5760     \xdef\lastchapterdefs{%
   5761       \gdef\noexpand\thischaptername{\the\toks0}%
   5762       \gdef\noexpand\thischapternum{\the\chapno}%
   5763       % \noexpand\putwordChapter avoids expanding indigestible
   5764       % commands in some of the translations.
   5765       \gdef\noexpand\thischapter{\noexpand\putwordChapter{}
   5766                                  \noexpand\thischapternum:
   5767                                  \noexpand\thischaptername}%
   5768     }%
   5769   \fi\fi\fi
   5770   %
   5771   % Output the mark.  Pass it through \safewhatsit, to take care of
   5772   % the preceding space.
   5773   \safewhatsit\domark
   5774   %
   5775   % Insert the chapter heading break.
   5776   \pchapsepmacro
   5777   %
   5778   % Now the second mark, after the heading break.  No break points
   5779   % between here and the heading.
   5780   \let\prevchapterdefs=\lastchapterdefs
   5781   \let\prevsectiondefs=\lastsectiondefs
   5782   \domark
   5783   %
   5784   {%
   5785     \chapfonts \rmisbold
   5786     %
   5787     % Have to define \lastsection before calling \donoderef, because the
   5788     % xref code eventually uses it.  On the other hand, it has to be called
   5789     % after \pchapsepmacro, or the headline will change too soon.
   5790     \gdef\lastsection{#1}%
   5791     %
   5792     % Only insert the separating space if we have a chapter/appendix
   5793     % number, and don't print the unnumbered ``number''.
   5794     \ifx\temptype\Ynothingkeyword
   5795       \setbox0 = \hbox{}%
   5796       \def\toctype{unnchap}%
   5797     \else\ifx\temptype\Yomitfromtockeyword
   5798       \setbox0 = \hbox{}% contents like unnumbered, but no toc entry
   5799       \def\toctype{omit}%
   5800     \else\ifx\temptype\Yappendixkeyword
   5801       \setbox0 = \hbox{\putwordAppendix{} #3\enspace}%
   5802       \def\toctype{app}%
   5803     \else
   5804       \setbox0 = \hbox{#3\enspace}%
   5805       \def\toctype{numchap}%
   5806     \fi\fi\fi
   5807     %
   5808     % Write the toc entry for this chapter.  Must come before the
   5809     % \donoderef, because we include the current node name in the toc
   5810     % entry, and \donoderef resets it to empty.
   5811     \writetocentry{\toctype}{#1}{#3}%
   5812     %
   5813     % For pdftex, we have to write out the node definition (aka, make
   5814     % the pdfdest) after any page break, but before the actual text has
   5815     % been typeset.  If the destination for the pdf outline is after the
   5816     % text, then jumping from the outline may wind up with the text not
   5817     % being visible, for instance under high magnification.
   5818     \donoderef{#2}%
   5819     %
   5820     % Typeset the actual heading.
   5821     \nobreak % Avoid page breaks at the interline glue.
   5822     \vbox{\raggedtitlesettings \hangindent=\wd0 \centerparametersmaybe
   5823           \unhbox0 #1\par}%
   5824   }%
   5825   \nobreak\bigskip % no page break after a chapter title
   5826   \nobreak
   5827 }
   5828 
   5829 % @centerchap -- centered and unnumbered.
   5830 \let\centerparametersmaybe = \relax
   5831 \def\centerparameters{%
   5832   \advance\rightskip by 3\rightskip
   5833   \leftskip = \rightskip
   5834   \parfillskip = 0pt
   5835 }
   5836 
   5837 
   5838 % I don't think this chapter style is supported any more, so I'm not
   5839 % updating it with the new noderef stuff.  We'll see.  --karl, 11aug03.
   5840 %
   5841 \def\setchapterstyle #1 {\csname CHAPF#1\endcsname}
   5842 %
   5843 \def\unnchfopen #1{%
   5844   \chapoddpage
   5845   \vbox{\chapfonts \raggedtitlesettings #1\par}%
   5846   \nobreak\bigskip\nobreak
   5847 }
   5848 \def\chfopen #1#2{\chapoddpage {\chapfonts
   5849 \vbox to 3in{\vfil \hbox to\hsize{\hfil #2} \hbox to\hsize{\hfil #1} \vfil}}%
   5850 \par\penalty 5000 %
   5851 }
   5852 \def\centerchfopen #1{%
   5853   \chapoddpage
   5854   \vbox{\chapfonts \raggedtitlesettings \hfill #1\hfill}%
   5855   \nobreak\bigskip \nobreak
   5856 }
   5857 \def\CHAPFopen{%
   5858   \global\let\chapmacro=\chfopen
   5859   \global\let\centerchapmacro=\centerchfopen}
   5860 
   5861 
   5862 % Section titles.  These macros combine the section number parts and
   5863 % call the generic \sectionheading to do the printing.
   5864 %
   5865 \newskip\secheadingskip
   5866 \def\secheadingbreak{\dobreak \secheadingskip{-1000}}
   5867 
   5868 % Subsection titles.
   5869 \newskip\subsecheadingskip
   5870 \def\subsecheadingbreak{\dobreak \subsecheadingskip{-500}}
   5871 
   5872 % Subsubsection titles.
   5873 \def\subsubsecheadingskip{\subsecheadingskip}
   5874 \def\subsubsecheadingbreak{\subsecheadingbreak}
   5875 
   5876 
   5877 % Print any size, any type, section title.
   5878 %
   5879 % #1 is the text, #2 is the section level (sec/subsec/subsubsec), #3 is
   5880 % the section type for xrefs (Ynumbered, Ynothing, Yappendix), #4 is the
   5881 % section number.
   5882 %
   5883 \def\seckeyword{sec}
   5884 %
   5885 \def\sectionheading#1#2#3#4{%
   5886   {%
   5887     \checkenv{}% should not be in an environment.
   5888     %
   5889     % Switch to the right set of fonts.
   5890     \csname #2fonts\endcsname \rmisbold
   5891     %
   5892     \def\sectionlevel{#2}%
   5893     \def\temptype{#3}%
   5894     %
   5895     % Insert first mark before the heading break (see notes for \domark).
   5896     \let\prevsectiondefs=\lastsectiondefs
   5897     \ifx\temptype\Ynothingkeyword
   5898       \ifx\sectionlevel\seckeyword
   5899         \gdef\lastsectiondefs{\gdef\thissectionname{#1}\gdef\thissectionnum{}%
   5900                               \gdef\thissection{\thissectionname}}%
   5901       \fi
   5902     \else\ifx\temptype\Yomitfromtockeyword
   5903       % Don't redefine \thissection.
   5904     \else\ifx\temptype\Yappendixkeyword
   5905       \ifx\sectionlevel\seckeyword
   5906         \toks0={#1}%
   5907         \xdef\lastsectiondefs{%
   5908           \gdef\noexpand\thissectionname{\the\toks0}%
   5909           \gdef\noexpand\thissectionnum{#4}%
   5910           % \noexpand\putwordSection avoids expanding indigestible
   5911           % commands in some of the translations.
   5912           \gdef\noexpand\thissection{\noexpand\putwordSection{}
   5913                                      \noexpand\thissectionnum:
   5914                                      \noexpand\thissectionname}%
   5915         }%
   5916       \fi
   5917     \else
   5918       \ifx\sectionlevel\seckeyword
   5919         \toks0={#1}%
   5920         \xdef\lastsectiondefs{%
   5921           \gdef\noexpand\thissectionname{\the\toks0}%
   5922           \gdef\noexpand\thissectionnum{#4}%
   5923           % \noexpand\putwordSection avoids expanding indigestible
   5924           % commands in some of the translations.
   5925           \gdef\noexpand\thissection{\noexpand\putwordSection{}
   5926                                      \noexpand\thissectionnum:
   5927                                      \noexpand\thissectionname}%
   5928         }%
   5929       \fi
   5930     \fi\fi\fi
   5931     %
   5932     % Go into vertical mode.  Usually we'll already be there, but we
   5933     % don't want the following whatsit to end up in a preceding paragraph
   5934     % if the document didn't happen to have a blank line.
   5935     \par
   5936     %
   5937     % Output the mark.  Pass it through \safewhatsit, to take care of
   5938     % the preceding space.
   5939     \safewhatsit\domark
   5940     %
   5941     % Insert space above the heading.
   5942     \csname #2headingbreak\endcsname
   5943     %
   5944     % Now the second mark, after the heading break.  No break points
   5945     % between here and the heading.
   5946     \global\let\prevsectiondefs=\lastsectiondefs
   5947     \domark
   5948     %
   5949     % Only insert the space after the number if we have a section number.
   5950     \ifx\temptype\Ynothingkeyword
   5951       \setbox0 = \hbox{}%
   5952       \def\toctype{unn}%
   5953       \gdef\lastsection{#1}%
   5954     \else\ifx\temptype\Yomitfromtockeyword
   5955       % for @headings -- no section number, don't include in toc,
   5956       % and don't redefine \lastsection.
   5957       \setbox0 = \hbox{}%
   5958       \def\toctype{omit}%
   5959       \let\sectionlevel=\empty
   5960     \else\ifx\temptype\Yappendixkeyword
   5961       \setbox0 = \hbox{#4\enspace}%
   5962       \def\toctype{app}%
   5963       \gdef\lastsection{#1}%
   5964     \else
   5965       \setbox0 = \hbox{#4\enspace}%
   5966       \def\toctype{num}%
   5967       \gdef\lastsection{#1}%
   5968     \fi\fi\fi
   5969     %
   5970     % Write the toc entry (before \donoderef).  See comments in \chapmacro.
   5971     \writetocentry{\toctype\sectionlevel}{#1}{#4}%
   5972     %
   5973     % Write the node reference (= pdf destination for pdftex).
   5974     % Again, see comments in \chapmacro.
   5975     \donoderef{#3}%
   5976     %
   5977     % Interline glue will be inserted when the vbox is completed.
   5978     % That glue will be a valid breakpoint for the page, since it'll be
   5979     % preceded by a whatsit (usually from the \donoderef, or from the
   5980     % \writetocentry if there was no node).  We don't want to allow that
   5981     % break, since then the whatsits could end up on page n while the
   5982     % section is on page n+1, thus toc/etc. are wrong.  Debian bug 276000.
   5983     \nobreak
   5984     %
   5985     % Output the actual section heading.
   5986     \vbox{\hyphenpenalty=10000 \tolerance=5000 \parindent=0pt \ptexraggedright
   5987           \hangindent=\wd0  % zero if no section number
   5988           \unhbox0 #1}%
   5989   }%
   5990   % Add extra space after the heading -- half of whatever came above it.
   5991   % Don't allow stretch, though.
   5992   \kern .5 \csname #2headingskip\endcsname
   5993   %
   5994   % Do not let the kern be a potential breakpoint, as it would be if it
   5995   % was followed by glue.
   5996   \nobreak
   5997   %
   5998   % We'll almost certainly start a paragraph next, so don't let that
   5999   % glue accumulate.  (Not a breakpoint because it's preceded by a
   6000   % discardable item.)  However, when a paragraph is not started next
   6001   % (\startdefun, \cartouche, \center, etc.), this needs to be wiped out
   6002   % or the negative glue will cause weirdly wrong output, typically
   6003   % obscuring the section heading with something else.
   6004   \vskip-\parskip
   6005   %
   6006   % This is so the last item on the main vertical list is a known
   6007   % \penalty > 10000, so \startdefun, etc., can recognize the situation
   6008   % and do the needful.
   6009   \penalty 10001
   6010 }
   6011 
   6012 
   6013 \message{toc,}
   6014 % Table of contents.
   6015 \newwrite\tocfile
   6016 
   6017 % Write an entry to the toc file, opening it if necessary.
   6018 % Called from @chapter, etc.
   6019 %
   6020 % Example usage: \writetocentry{sec}{Section Name}{\the\chapno.\the\secno}
   6021 % We append the current node name (if any) and page number as additional
   6022 % arguments for the \{chap,sec,...}entry macros which will eventually
   6023 % read this.  The node name is used in the pdf outlines as the
   6024 % destination to jump to.
   6025 %
   6026 % We open the .toc file for writing here instead of at @setfilename (or
   6027 % any other fixed time) so that @contents can be anywhere in the document.
   6028 % But if #1 is `omit', then we don't do anything.  This is used for the
   6029 % table of contents chapter openings themselves.
   6030 %
   6031 \newif\iftocfileopened
   6032 \def\omitkeyword{omit}%
   6033 %
   6034 \def\writetocentry#1#2#3{%
   6035   \edef\writetoctype{#1}%
   6036   \ifx\writetoctype\omitkeyword \else
   6037     \iftocfileopened\else
   6038       \immediate\openout\tocfile = \jobname.toc
   6039       \global\tocfileopenedtrue
   6040     \fi
   6041     %
   6042     \iflinks
   6043       {\atdummies
   6044        \edef\temp{%
   6045          \write\tocfile{@#1entry{#2}{#3}{\lastnode}{\noexpand\folio}}}%
   6046        \temp
   6047       }%
   6048     \fi
   6049   \fi
   6050   %
   6051   % Tell \shipout to create a pdf destination on each page, if we're
   6052   % writing pdf.  These are used in the table of contents.  We can't
   6053   % just write one on every page because the title pages are numbered
   6054   % 1 and 2 (the page numbers aren't printed), and so are the first
   6055   % two pages of the document.  Thus, we'd have two destinations named
   6056   % `1', and two named `2'.
   6057   \ifpdf \global\pdfmakepagedesttrue \fi
   6058 }
   6059 
   6060 
   6061 % These characters do not print properly in the Computer Modern roman
   6062 % fonts, so we must take special care.  This is more or less redundant
   6063 % with the Texinfo input format setup at the end of this file.
   6064 %
   6065 \def\activecatcodes{%
   6066   \catcode`\"=\active
   6067   \catcode`\$=\active
   6068   \catcode`\<=\active
   6069   \catcode`\>=\active
   6070   \catcode`\\=\active
   6071   \catcode`\^=\active
   6072   \catcode`\_=\active
   6073   \catcode`\|=\active
   6074   \catcode`\~=\active
   6075 }
   6076 
   6077 
   6078 % Read the toc file, which is essentially Texinfo input.
   6079 \def\readtocfile{%
   6080   \setupdatafile
   6081   \activecatcodes
   6082   \input \tocreadfilename
   6083 }
   6084 
   6085 \newskip\contentsrightmargin \contentsrightmargin=1in
   6086 \newcount\savepageno
   6087 \newcount\lastnegativepageno \lastnegativepageno = -1
   6088 
   6089 % Prepare to read what we've written to \tocfile.
   6090 %
   6091 \def\startcontents#1{%
   6092   % If @setchapternewpage on, and @headings double, the contents should
   6093   % start on an odd page, unlike chapters.  Thus, we maintain
   6094   % \contentsalignmacro in parallel with \pagealignmacro.
   6095   % From: Torbjorn Granlund <tege@matematik.su.se>
   6096   \contentsalignmacro
   6097   \immediate\closeout\tocfile
   6098   %
   6099   % Don't need to put `Contents' or `Short Contents' in the headline.
   6100   % It is abundantly clear what they are.
   6101   \chapmacro{#1}{Yomitfromtoc}{}%
   6102   %
   6103   \savepageno = \pageno
   6104   \begingroup                  % Set up to handle contents files properly.
   6105     \raggedbottom              % Worry more about breakpoints than the bottom.
   6106     \advance\hsize by -\contentsrightmargin % Don't use the full line length.
   6107     %
   6108     % Roman numerals for page numbers.
   6109     \ifnum \pageno>0 \global\pageno = \lastnegativepageno \fi
   6110 }
   6111 
   6112 % redefined for the two-volume lispref.  We always output on
   6113 % \jobname.toc even if this is redefined.
   6114 %
   6115 \def\tocreadfilename{\jobname.toc}
   6116 
   6117 % Normal (long) toc.
   6118 %
   6119 \def\contents{%
   6120   \startcontents{\putwordTOC}%
   6121     \openin 1 \tocreadfilename\space
   6122     \ifeof 1 \else
   6123       \readtocfile
   6124     \fi
   6125     \vfill \eject
   6126     \contentsalignmacro % in case @setchapternewpage odd is in effect
   6127     \ifeof 1 \else
   6128       \pdfmakeoutlines
   6129     \fi
   6130     \closein 1
   6131   \endgroup
   6132   \lastnegativepageno = \pageno
   6133   \global\pageno = \savepageno
   6134 }
   6135 
   6136 % And just the chapters.
   6137 \def\summarycontents{%
   6138   \startcontents{\putwordShortTOC}%
   6139     %
   6140     \let\partentry = \shortpartentry
   6141     \let\numchapentry = \shortchapentry
   6142     \let\appentry = \shortchapentry
   6143     \let\unnchapentry = \shortunnchapentry
   6144     % We want a true roman here for the page numbers.
   6145     \secfonts
   6146     \let\rm=\shortcontrm \let\bf=\shortcontbf
   6147     \let\sl=\shortcontsl \let\tt=\shortconttt
   6148     \rm
   6149     \hyphenpenalty = 10000
   6150     \advance\baselineskip by 1pt % Open it up a little.
   6151     \def\numsecentry##1##2##3##4{}
   6152     \let\appsecentry = \numsecentry
   6153     \let\unnsecentry = \numsecentry
   6154     \let\numsubsecentry = \numsecentry
   6155     \let\appsubsecentry = \numsecentry
   6156     \let\unnsubsecentry = \numsecentry
   6157     \let\numsubsubsecentry = \numsecentry
   6158     \let\appsubsubsecentry = \numsecentry
   6159     \let\unnsubsubsecentry = \numsecentry
   6160     \openin 1 \tocreadfilename\space
   6161     \ifeof 1 \else
   6162       \readtocfile
   6163     \fi
   6164     \closein 1
   6165     \vfill \eject
   6166     \contentsalignmacro % in case @setchapternewpage odd is in effect
   6167   \endgroup
   6168   \lastnegativepageno = \pageno
   6169   \global\pageno = \savepageno
   6170 }
   6171 \let\shortcontents = \summarycontents
   6172 
   6173 % Typeset the label for a chapter or appendix for the short contents.
   6174 % The arg is, e.g., `A' for an appendix, or `3' for a chapter.
   6175 %
   6176 \def\shortchaplabel#1{%
   6177   % This space should be enough, since a single number is .5em, and the
   6178   % widest letter (M) is 1em, at least in the Computer Modern fonts.
   6179   % But use \hss just in case.
   6180   % (This space doesn't include the extra space that gets added after
   6181   % the label; that gets put in by \shortchapentry above.)
   6182   %
   6183   % We'd like to right-justify chapter numbers, but that looks strange
   6184   % with appendix letters.  And right-justifying numbers and
   6185   % left-justifying letters looks strange when there is less than 10
   6186   % chapters.  Have to read the whole toc once to know how many chapters
   6187   % there are before deciding ...
   6188   \hbox to 1em{#1\hss}%
   6189 }
   6190 
   6191 % These macros generate individual entries in the table of contents.
   6192 % The first argument is the chapter or section name.
   6193 % The last argument is the page number.
   6194 % The arguments in between are the chapter number, section number, ...
   6195 
   6196 % Parts, in the main contents.  Replace the part number, which doesn't
   6197 % exist, with an empty box.  Let's hope all the numbers have the same width.
   6198 % Also ignore the page number, which is conventionally not printed.
   6199 \def\numeralbox{\setbox0=\hbox{8}\hbox to \wd0{\hfil}}
   6200 \def\partentry#1#2#3#4{\dochapentry{\numeralbox\labelspace#1}{}}
   6201 %
   6202 % Parts, in the short toc.
   6203 \def\shortpartentry#1#2#3#4{%
   6204   \penalty-300
   6205   \vskip.5\baselineskip plus.15\baselineskip minus.1\baselineskip
   6206   \shortchapentry{{\bf #1}}{\numeralbox}{}{}%
   6207 }
   6208 
   6209 % Chapters, in the main contents.
   6210 \def\numchapentry#1#2#3#4{\dochapentry{#2\labelspace#1}{#4}}
   6211 %
   6212 % Chapters, in the short toc.
   6213 % See comments in \dochapentry re vbox and related settings.
   6214 \def\shortchapentry#1#2#3#4{%
   6215   \tocentry{\shortchaplabel{#2}\labelspace #1}{\doshortpageno\bgroup#4\egroup}%
   6216 }
   6217 
   6218 % Appendices, in the main contents.
   6219 % Need the word Appendix, and a fixed-size box.
   6220 %
   6221 \def\appendixbox#1{%
   6222   % We use M since it's probably the widest letter.
   6223   \setbox0 = \hbox{\putwordAppendix{} M}%
   6224   \hbox to \wd0{\putwordAppendix{} #1\hss}}
   6225 %
   6226 \def\appentry#1#2#3#4{\dochapentry{\appendixbox{#2}\labelspace#1}{#4}}
   6227 
   6228 % Unnumbered chapters.
   6229 \def\unnchapentry#1#2#3#4{\dochapentry{#1}{#4}}
   6230 \def\shortunnchapentry#1#2#3#4{\tocentry{#1}{\doshortpageno\bgroup#4\egroup}}
   6231 
   6232 % Sections.
   6233 \def\numsecentry#1#2#3#4{\dosecentry{#2\labelspace#1}{#4}}
   6234 \let\appsecentry=\numsecentry
   6235 \def\unnsecentry#1#2#3#4{\dosecentry{#1}{#4}}
   6236 
   6237 % Subsections.
   6238 \def\numsubsecentry#1#2#3#4{\dosubsecentry{#2\labelspace#1}{#4}}
   6239 \let\appsubsecentry=\numsubsecentry
   6240 \def\unnsubsecentry#1#2#3#4{\dosubsecentry{#1}{#4}}
   6241 
   6242 % And subsubsections.
   6243 \def\numsubsubsecentry#1#2#3#4{\dosubsubsecentry{#2\labelspace#1}{#4}}
   6244 \let\appsubsubsecentry=\numsubsubsecentry
   6245 \def\unnsubsubsecentry#1#2#3#4{\dosubsubsecentry{#1}{#4}}
   6246 
   6247 % This parameter controls the indentation of the various levels.
   6248 % Same as \defaultparindent.
   6249 \newdimen\tocindent \tocindent = 15pt
   6250 
   6251 % Now for the actual typesetting. In all these, #1 is the text and #2 is the
   6252 % page number.
   6253 %
   6254 % If the toc has to be broken over pages, we want it to be at chapters
   6255 % if at all possible; hence the \penalty.
   6256 \def\dochapentry#1#2{%
   6257    \penalty-300 \vskip1\baselineskip plus.33\baselineskip minus.25\baselineskip
   6258    \begingroup
   6259      \chapentryfonts
   6260      \tocentry{#1}{\dopageno\bgroup#2\egroup}%
   6261    \endgroup
   6262    \nobreak\vskip .25\baselineskip plus.1\baselineskip
   6263 }
   6264 
   6265 \def\dosecentry#1#2{\begingroup
   6266   \secentryfonts \leftskip=\tocindent
   6267   \tocentry{#1}{\dopageno\bgroup#2\egroup}%
   6268 \endgroup}
   6269 
   6270 \def\dosubsecentry#1#2{\begingroup
   6271   \subsecentryfonts \leftskip=2\tocindent
   6272   \tocentry{#1}{\dopageno\bgroup#2\egroup}%
   6273 \endgroup}
   6274 
   6275 \def\dosubsubsecentry#1#2{\begingroup
   6276   \subsubsecentryfonts \leftskip=3\tocindent
   6277   \tocentry{#1}{\dopageno\bgroup#2\egroup}%
   6278 \endgroup}
   6279 
   6280 % We use the same \entry macro as for the index entries.
   6281 \let\tocentry = \entry
   6282 
   6283 % Space between chapter (or whatever) number and the title.
   6284 \def\labelspace{\hskip1em \relax}
   6285 
   6286 \def\dopageno#1{{\rm #1}}
   6287 \def\doshortpageno#1{{\rm #1}}
   6288 
   6289 \def\chapentryfonts{\secfonts \rm}
   6290 \def\secentryfonts{\textfonts}
   6291 \def\subsecentryfonts{\textfonts}
   6292 \def\subsubsecentryfonts{\textfonts}
   6293 
   6294 
   6295 \message{environments,}
   6296 % @foo ... @end foo.
   6297 
   6298 % @tex ... @end tex    escapes into raw TeX temporarily.
   6299 % One exception: @ is still an escape character, so that @end tex works.
   6300 % But \@ or @@ will get a plain @ character.
   6301 
   6302 \envdef\tex{%
   6303   \setupmarkupstyle{tex}%
   6304   \catcode `\\=0 \catcode `\{=1 \catcode `\}=2
   6305   \catcode `\$=3 \catcode `\&=4 \catcode `\#=6
   6306   \catcode `\^=7 \catcode `\_=8 \catcode `\~=\active \let~=\tie
   6307   \catcode `\%=14
   6308   \catcode `\+=\other
   6309   \catcode `\"=\other
   6310   \catcode `\|=\other
   6311   \catcode `\<=\other
   6312   \catcode `\>=\other
   6313   \catcode `\`=\other
   6314   \catcode `\'=\other
   6315   \escapechar=`\\
   6316   %
   6317   % ' is active in math mode (mathcode"8000).  So reset it, and all our
   6318   % other math active characters (just in case), to plain's definitions.
   6319   \mathactive
   6320   %
   6321   \let\b=\ptexb
   6322   \let\bullet=\ptexbullet
   6323   \let\c=\ptexc
   6324   \let\,=\ptexcomma
   6325   \let\.=\ptexdot
   6326   \let\dots=\ptexdots
   6327   \let\equiv=\ptexequiv
   6328   \let\!=\ptexexclam
   6329   \let\i=\ptexi
   6330   \let\indent=\ptexindent
   6331   \let\noindent=\ptexnoindent
   6332   \let\{=\ptexlbrace
   6333   \let\+=\tabalign
   6334   \let\}=\ptexrbrace
   6335   \let\/=\ptexslash
   6336   \let\*=\ptexstar
   6337   \let\t=\ptext
   6338   \expandafter \let\csname top\endcsname=\ptextop  % we've made it outer
   6339   \let\frenchspacing=\plainfrenchspacing
   6340   %
   6341   \def\endldots{\mathinner{\ldots\ldots\ldots\ldots}}%
   6342   \def\enddots{\relax\ifmmode\endldots\else$\mathsurround=0pt \endldots\,$\fi}%
   6343   \def\@{@}%
   6344 }
   6345 % There is no need to define \Etex.
   6346 
   6347 % Define @lisp ... @end lisp.
   6348 % @lisp environment forms a group so it can rebind things,
   6349 % including the definition of @end lisp (which normally is erroneous).
   6350 
   6351 % Amount to narrow the margins by for @lisp.
   6352 \newskip\lispnarrowing \lispnarrowing=0.4in
   6353 
   6354 % This is the definition that ^^M gets inside @lisp, @example, and other
   6355 % such environments.  \null is better than a space, since it doesn't
   6356 % have any width.
   6357 \def\lisppar{\null\endgraf}
   6358 
   6359 % This space is always present above and below environments.
   6360 \newskip\envskipamount \envskipamount = 0pt
   6361 
   6362 % Make spacing and below environment symmetrical.  We use \parskip here
   6363 % to help in doing that, since in @example-like environments \parskip
   6364 % is reset to zero; thus the \afterenvbreak inserts no space -- but the
   6365 % start of the next paragraph will insert \parskip.
   6366 %
   6367 \def\aboveenvbreak{{%
   6368   % =10000 instead of <10000 because of a special case in \itemzzz and
   6369   % \sectionheading, q.v.
   6370   \ifnum \lastpenalty=10000 \else
   6371     \advance\envskipamount by \parskip
   6372     \endgraf
   6373     \ifdim\lastskip<\envskipamount
   6374       \removelastskip
   6375       % it's not a good place to break if the last penalty was \nobreak
   6376       % or better ...
   6377       \ifnum\lastpenalty<10000 \penalty-50 \fi
   6378       \vskip\envskipamount
   6379     \fi
   6380   \fi
   6381 }}
   6382 
   6383 \let\afterenvbreak = \aboveenvbreak
   6384 
   6385 % \nonarrowing is a flag.  If "set", @lisp etc don't narrow margins; it will
   6386 % also clear it, so that its embedded environments do the narrowing again.
   6387 \let\nonarrowing=\relax
   6388 
   6389 % @cartouche ... @end cartouche: draw rectangle w/rounded corners around
   6390 % environment contents.
   6391 \font\circle=lcircle10
   6392 \newdimen\circthick
   6393 \newdimen\cartouter\newdimen\cartinner
   6394 \newskip\normbskip\newskip\normpskip\newskip\normlskip
   6395 \circthick=\fontdimen8\circle
   6396 %
   6397 \def\ctl{{\circle\char'013\hskip -6pt}}% 6pt from pl file: 1/2charwidth
   6398 \def\ctr{{\hskip 6pt\circle\char'010}}
   6399 \def\cbl{{\circle\char'012\hskip -6pt}}
   6400 \def\cbr{{\hskip 6pt\circle\char'011}}
   6401 \def\carttop{\hbox to \cartouter{\hskip\lskip
   6402         \ctl\leaders\hrule height\circthick\hfil\ctr
   6403         \hskip\rskip}}
   6404 \def\cartbot{\hbox to \cartouter{\hskip\lskip
   6405         \cbl\leaders\hrule height\circthick\hfil\cbr
   6406         \hskip\rskip}}
   6407 %
   6408 \newskip\lskip\newskip\rskip
   6409 
   6410 \envdef\cartouche{%
   6411   \ifhmode\par\fi  % can't be in the midst of a paragraph.
   6412   \startsavinginserts
   6413   \lskip=\leftskip \rskip=\rightskip
   6414   \leftskip=0pt\rightskip=0pt % we want these *outside*.
   6415   \cartinner=\hsize \advance\cartinner by-\lskip
   6416   \advance\cartinner by-\rskip
   6417   \cartouter=\hsize
   6418   \advance\cartouter by 18.4pt	% allow for 3pt kerns on either
   6419 				% side, and for 6pt waste from
   6420 				% each corner char, and rule thickness
   6421   \normbskip=\baselineskip \normpskip=\parskip \normlskip=\lineskip
   6422   % Flag to tell @lisp, etc., not to narrow margin.
   6423   \let\nonarrowing = t%
   6424   %
   6425   % If this cartouche directly follows a sectioning command, we need the
   6426   % \parskip glue (backspaced over by default) or the cartouche can
   6427   % collide with the section heading.
   6428   \ifnum\lastpenalty>10000 \vskip\parskip \penalty\lastpenalty \fi
   6429   %
   6430   \vbox\bgroup
   6431       \baselineskip=0pt\parskip=0pt\lineskip=0pt
   6432       \carttop
   6433       \hbox\bgroup
   6434 	  \hskip\lskip
   6435 	  \vrule\kern3pt
   6436 	  \vbox\bgroup
   6437 	      \kern3pt
   6438 	      \hsize=\cartinner
   6439 	      \baselineskip=\normbskip
   6440 	      \lineskip=\normlskip
   6441 	      \parskip=\normpskip
   6442 	      \vskip -\parskip
   6443 	      \comment % For explanation, see the end of def\group.
   6444 }
   6445 \def\Ecartouche{%
   6446               \ifhmode\par\fi
   6447 	      \kern3pt
   6448 	  \egroup
   6449 	  \kern3pt\vrule
   6450 	  \hskip\rskip
   6451       \egroup
   6452       \cartbot
   6453   \egroup
   6454   \checkinserts
   6455 }
   6456 
   6457 
   6458 % This macro is called at the beginning of all the @example variants,
   6459 % inside a group.
   6460 \newdimen\nonfillparindent
   6461 \def\nonfillstart{%
   6462   \aboveenvbreak
   6463   \ifdim\hfuzz < 12pt \hfuzz = 12pt \fi % Don't be fussy
   6464   \sepspaces % Make spaces be word-separators rather than space tokens.
   6465   \let\par = \lisppar % don't ignore blank lines
   6466   \obeylines % each line of input is a line of output
   6467   \parskip = 0pt
   6468   % Turn off paragraph indentation but redefine \indent to emulate
   6469   % the normal \indent.
   6470   \nonfillparindent=\parindent
   6471   \parindent = 0pt
   6472   \let\indent\nonfillindent
   6473   %
   6474   \emergencystretch = 0pt % don't try to avoid overfull boxes
   6475   \ifx\nonarrowing\relax
   6476     \advance \leftskip by \lispnarrowing
   6477     \exdentamount=\lispnarrowing
   6478   \else
   6479     \let\nonarrowing = \relax
   6480   \fi
   6481   \let\exdent=\nofillexdent
   6482 }
   6483 
   6484 \begingroup
   6485 \obeyspaces
   6486 % We want to swallow spaces (but not other tokens) after the fake
   6487 % @indent in our nonfill-environments, where spaces are normally
   6488 % active and set to @tie, resulting in them not being ignored after
   6489 % @indent.
   6490 \gdef\nonfillindent{\futurelet\temp\nonfillindentcheck}%
   6491 \gdef\nonfillindentcheck{%
   6492 \ifx\temp %
   6493 \expandafter\nonfillindentgobble%
   6494 \else%
   6495 \leavevmode\nonfillindentbox%
   6496 \fi%
   6497 }%
   6498 \endgroup
   6499 \def\nonfillindentgobble#1{\nonfillindent}
   6500 \def\nonfillindentbox{\hbox to \nonfillparindent{\hss}}
   6501 
   6502 % If you want all examples etc. small: @set dispenvsize small.
   6503 % If you want even small examples the full size: @set dispenvsize nosmall.
   6504 % This affects the following displayed environments:
   6505 %    @example, @display, @format, @lisp
   6506 %
   6507 \def\smallword{small}
   6508 \def\nosmallword{nosmall}
   6509 \let\SETdispenvsize\relax
   6510 \def\setnormaldispenv{%
   6511   \ifx\SETdispenvsize\smallword
   6512     % end paragraph for sake of leading, in case document has no blank
   6513     % line.  This is redundant with what happens in \aboveenvbreak, but
   6514     % we need to do it before changing the fonts, and it's inconvenient
   6515     % to change the fonts afterward.
   6516     \ifnum \lastpenalty=10000 \else \endgraf \fi
   6517     \smallexamplefonts \rm
   6518   \fi
   6519 }
   6520 \def\setsmalldispenv{%
   6521   \ifx\SETdispenvsize\nosmallword
   6522   \else
   6523     \ifnum \lastpenalty=10000 \else \endgraf \fi
   6524     \smallexamplefonts \rm
   6525   \fi
   6526 }
   6527 
   6528 % We often define two environments, @foo and @smallfoo.
   6529 % Let's do it in one command.  #1 is the env name, #2 the definition.
   6530 \def\makedispenvdef#1#2{%
   6531   \expandafter\envdef\csname#1\endcsname {\setnormaldispenv #2}%
   6532   \expandafter\envdef\csname small#1\endcsname {\setsmalldispenv #2}%
   6533   \expandafter\let\csname E#1\endcsname \afterenvbreak
   6534   \expandafter\let\csname Esmall#1\endcsname \afterenvbreak
   6535 }
   6536 
   6537 % Define two environment synonyms (#1 and #2) for an environment.
   6538 \def\maketwodispenvdef#1#2#3{%
   6539   \makedispenvdef{#1}{#3}%
   6540   \makedispenvdef{#2}{#3}%
   6541 }
   6542 %
   6543 % @lisp: indented, narrowed, typewriter font;
   6544 % @example: same as @lisp.
   6545 %
   6546 % @smallexample and @smalllisp: use smaller fonts.
   6547 % Originally contributed by Pavel@xerox.
   6548 %
   6549 \maketwodispenvdef{lisp}{example}{%
   6550   \nonfillstart
   6551   \tt\setupmarkupstyle{example}%
   6552   \let\kbdfont = \kbdexamplefont % Allow @kbd to do something special.
   6553   \gobble % eat return
   6554 }
   6555 % @display/@smalldisplay: same as @lisp except keep current font.
   6556 %
   6557 \makedispenvdef{display}{%
   6558   \nonfillstart
   6559   \gobble
   6560 }
   6561 
   6562 % @format/@smallformat: same as @display except don't narrow margins.
   6563 %
   6564 \makedispenvdef{format}{%
   6565   \let\nonarrowing = t%
   6566   \nonfillstart
   6567   \gobble
   6568 }
   6569 
   6570 % @flushleft: same as @format, but doesn't obey \SETdispenvsize.
   6571 \envdef\flushleft{%
   6572   \let\nonarrowing = t%
   6573   \nonfillstart
   6574   \gobble
   6575 }
   6576 \let\Eflushleft = \afterenvbreak
   6577 
   6578 % @flushright.
   6579 %
   6580 \envdef\flushright{%
   6581   \let\nonarrowing = t%
   6582   \nonfillstart
   6583   \advance\leftskip by 0pt plus 1fill\relax
   6584   \gobble
   6585 }
   6586 \let\Eflushright = \afterenvbreak
   6587 
   6588 
   6589 % @raggedright does more-or-less normal line breaking but no right
   6590 % justification.  From plain.tex.
   6591 \envdef\raggedright{%
   6592   \rightskip0pt plus2em \spaceskip.3333em \xspaceskip.5em\relax
   6593 }
   6594 \let\Eraggedright\par
   6595 
   6596 \envdef\raggedleft{%
   6597   \parindent=0pt \leftskip0pt plus2em
   6598   \spaceskip.3333em \xspaceskip.5em \parfillskip=0pt
   6599   \hbadness=10000 % Last line will usually be underfull, so turn off
   6600                   % badness reporting.
   6601 }
   6602 \let\Eraggedleft\par
   6603 
   6604 \envdef\raggedcenter{%
   6605   \parindent=0pt \rightskip0pt plus1em \leftskip0pt plus1em
   6606   \spaceskip.3333em \xspaceskip.5em \parfillskip=0pt
   6607   \hbadness=10000 % Last line will usually be underfull, so turn off
   6608                   % badness reporting.
   6609 }
   6610 \let\Eraggedcenter\par
   6611 
   6612 
   6613 % @quotation does normal linebreaking (hence we can't use \nonfillstart)
   6614 % and narrows the margins.  We keep \parskip nonzero in general, since
   6615 % we're doing normal filling.  So, when using \aboveenvbreak and
   6616 % \afterenvbreak, temporarily make \parskip 0.
   6617 %
   6618 \makedispenvdef{quotation}{\quotationstart}
   6619 %
   6620 \def\quotationstart{%
   6621   \indentedblockstart % same as \indentedblock, but increase right margin too.
   6622   \ifx\nonarrowing\relax
   6623     \advance\rightskip by \lispnarrowing
   6624   \fi
   6625   \parsearg\quotationlabel
   6626 }
   6627 
   6628 % We have retained a nonzero parskip for the environment, since we're
   6629 % doing normal filling.
   6630 %
   6631 \def\Equotation{%
   6632   \par
   6633   \ifx\quotationauthor\thisisundefined\else
   6634     % indent a bit.
   6635     \leftline{\kern 2\leftskip \sl ---\quotationauthor}%
   6636   \fi
   6637   {\parskip=0pt \afterenvbreak}%
   6638 }
   6639 \def\Esmallquotation{\Equotation}
   6640 
   6641 % If we're given an argument, typeset it in bold with a colon after.
   6642 \def\quotationlabel#1{%
   6643   \def\temp{#1}%
   6644   \ifx\temp\empty \else
   6645     {\bf #1: }%
   6646   \fi
   6647 }
   6648 
   6649 % @indentedblock is like @quotation, but indents only on the left and
   6650 % has no optional argument.
   6651 %
   6652 \makedispenvdef{indentedblock}{\indentedblockstart}
   6653 %
   6654 \def\indentedblockstart{%
   6655   {\parskip=0pt \aboveenvbreak}% because \aboveenvbreak inserts \parskip
   6656   \parindent=0pt
   6657   %
   6658   % @cartouche defines \nonarrowing to inhibit narrowing at next level down.
   6659   \ifx\nonarrowing\relax
   6660     \advance\leftskip by \lispnarrowing
   6661     \exdentamount = \lispnarrowing
   6662   \else
   6663     \let\nonarrowing = \relax
   6664   \fi
   6665 }
   6666 
   6667 % Keep a nonzero parskip for the environment, since we're doing normal filling.
   6668 %
   6669 \def\Eindentedblock{%
   6670   \par
   6671   {\parskip=0pt \afterenvbreak}%
   6672 }
   6673 \def\Esmallindentedblock{\Eindentedblock}
   6674 
   6675 
   6676 % LaTeX-like @verbatim...@end verbatim and @verb{<char>...<char>}
   6677 % If we want to allow any <char> as delimiter,
   6678 % we need the curly braces so that makeinfo sees the @verb command, eg:
   6679 % `@verbx...x' would look like the '@verbx' command.  --janneke@gnu.org
   6680 %
   6681 % [Knuth]: Donald Ervin Knuth, 1996.  The TeXbook.
   6682 %
   6683 % [Knuth] p.344; only we need to do the other characters Texinfo sets
   6684 % active too.  Otherwise, they get lost as the first character on a
   6685 % verbatim line.
   6686 \def\dospecials{%
   6687   \do\ \do\\\do\{\do\}\do\$\do\&%
   6688   \do\#\do\^\do\^^K\do\_\do\^^A\do\%\do\~%
   6689   \do\<\do\>\do\|\do\@\do+\do\"%
   6690   % Don't do the quotes -- if we do, @set txicodequoteundirected and
   6691   % @set txicodequotebacktick will not have effect on @verb and
   6692   % @verbatim, and ?` and !` ligatures won't get disabled.
   6693   %\do\`\do\'%
   6694 }
   6695 %
   6696 % [Knuth] p. 380
   6697 \def\uncatcodespecials{%
   6698   \def\do##1{\catcode`##1=\other}\dospecials}
   6699 %
   6700 % Setup for the @verb command.
   6701 %
   6702 % Eight spaces for a tab
   6703 \begingroup
   6704   \catcode`\^^I=\active
   6705   \gdef\tabeightspaces{\catcode`\^^I=\active\def^^I{\ \ \ \ \ \ \ \ }}
   6706 \endgroup
   6707 %
   6708 \def\setupverb{%
   6709   \tt  % easiest (and conventionally used) font for verbatim
   6710   \def\par{\leavevmode\endgraf}%
   6711   \setupmarkupstyle{verb}%
   6712   \tabeightspaces
   6713   % Respect line breaks,
   6714   % print special symbols as themselves, and
   6715   % make each space count
   6716   % must do in this order:
   6717   \obeylines \uncatcodespecials \sepspaces
   6718 }
   6719 
   6720 % Setup for the @verbatim environment
   6721 %
   6722 % Real tab expansion.
   6723 \newdimen\tabw \setbox0=\hbox{\tt\space} \tabw=8\wd0 % tab amount
   6724 %
   6725 % We typeset each line of the verbatim in an \hbox, so we can handle
   6726 % tabs.  The \global is in case the verbatim line starts with an accent,
   6727 % or some other command that starts with a begin-group.  Otherwise, the
   6728 % entire \verbbox would disappear at the corresponding end-group, before
   6729 % it is typeset.  Meanwhile, we can't have nested verbatim commands
   6730 % (can we?), so the \global won't be overwriting itself.
   6731 \newbox\verbbox
   6732 \def\starttabbox{\global\setbox\verbbox=\hbox\bgroup}
   6733 %
   6734 \begingroup
   6735   \catcode`\^^I=\active
   6736   \gdef\tabexpand{%
   6737     \catcode`\^^I=\active
   6738     \def^^I{\leavevmode\egroup
   6739       \dimen\verbbox=\wd\verbbox % the width so far, or since the previous tab
   6740       \divide\dimen\verbbox by\tabw
   6741       \multiply\dimen\verbbox by\tabw % compute previous multiple of \tabw
   6742       \advance\dimen\verbbox by\tabw  % advance to next multiple of \tabw
   6743       \wd\verbbox=\dimen\verbbox \box\verbbox \starttabbox
   6744     }%
   6745   }
   6746 \endgroup
   6747 
   6748 % start the verbatim environment.
   6749 \def\setupverbatim{%
   6750   \let\nonarrowing = t%
   6751   \nonfillstart
   6752   \tt % easiest (and conventionally used) font for verbatim
   6753   % The \leavevmode here is for blank lines.  Otherwise, we would
   6754   % never \starttabox and the \egroup would end verbatim mode.
   6755   \def\par{\leavevmode\egroup\box\verbbox\endgraf}%
   6756   \tabexpand
   6757   \setupmarkupstyle{verbatim}%
   6758   % Respect line breaks,
   6759   % print special symbols as themselves, and
   6760   % make each space count.
   6761   % Must do in this order:
   6762   \obeylines \uncatcodespecials \sepspaces
   6763   \everypar{\starttabbox}%
   6764 }
   6765 
   6766 % Do the @verb magic: verbatim text is quoted by unique
   6767 % delimiter characters.  Before first delimiter expect a
   6768 % right brace, after last delimiter expect closing brace:
   6769 %
   6770 %    \def\doverb'{'<char>#1<char>'}'{#1}
   6771 %
   6772 % [Knuth] p. 382; only eat outer {}
   6773 \begingroup
   6774   \catcode`[=1\catcode`]=2\catcode`\{=\other\catcode`\}=\other
   6775   \gdef\doverb{#1[\def\next##1#1}[##1\endgroup]\next]
   6776 \endgroup
   6777 %
   6778 \def\verb{\begingroup\setupverb\doverb}
   6779 %
   6780 %
   6781 % Do the @verbatim magic: define the macro \doverbatim so that
   6782 % the (first) argument ends when '@end verbatim' is reached, ie:
   6783 %
   6784 %     \def\doverbatim#1@end verbatim{#1}
   6785 %
   6786 % For Texinfo it's a lot easier than for LaTeX,
   6787 % because texinfo's \verbatim doesn't stop at '\end{verbatim}':
   6788 % we need not redefine '\', '{' and '}'.
   6789 %
   6790 % Inspired by LaTeX's verbatim command set [latex.ltx]
   6791 %
   6792 \begingroup
   6793   \catcode`\ =\active
   6794   \obeylines %
   6795   % ignore everything up to the first ^^M, that's the newline at the end
   6796   % of the @verbatim input line itself.  Otherwise we get an extra blank
   6797   % line in the output.
   6798   \xdef\doverbatim#1^^M#2@end verbatim{#2\noexpand\end\gobble verbatim}%
   6799   % We really want {...\end verbatim} in the body of the macro, but
   6800   % without the active space; thus we have to use \xdef and \gobble.
   6801 \endgroup
   6802 %
   6803 \envdef\verbatim{%
   6804     \setupverbatim\doverbatim
   6805 }
   6806 \let\Everbatim = \afterenvbreak
   6807 
   6808 
   6809 % @verbatiminclude FILE - insert text of file in verbatim environment.
   6810 %
   6811 \def\verbatiminclude{\parseargusing\filenamecatcodes\doverbatiminclude}
   6812 %
   6813 \def\doverbatiminclude#1{%
   6814   {%
   6815     \makevalueexpandable
   6816     \setupverbatim
   6817     \indexnofonts       % Allow `@@' and other weird things in file names.
   6818     \wlog{texinfo.tex: doing @verbatiminclude of #1^^J}%
   6819     \input #1
   6820     \afterenvbreak
   6821   }%
   6822 }
   6823 
   6824 % @copying ... @end copying.
   6825 % Save the text away for @insertcopying later.
   6826 %
   6827 % We save the uninterpreted tokens, rather than creating a box.
   6828 % Saving the text in a box would be much easier, but then all the
   6829 % typesetting commands (@smallbook, font changes, etc.) have to be done
   6830 % beforehand -- and a) we want @copying to be done first in the source
   6831 % file; b) letting users define the frontmatter in as flexible order as
   6832 % possible is very desirable.
   6833 %
   6834 \def\copying{\checkenv{}\begingroup\scanargctxt\docopying}
   6835 \def\docopying#1@end copying{\endgroup\def\copyingtext{#1}}
   6836 %
   6837 \def\insertcopying{%
   6838   \begingroup
   6839     \parindent = 0pt  % paragraph indentation looks wrong on title page
   6840     \scanexp\copyingtext
   6841   \endgroup
   6842 }
   6843 
   6844 
   6845 \message{defuns,}
   6846 % @defun etc.
   6847 
   6848 \newskip\defbodyindent \defbodyindent=.4in
   6849 \newskip\defargsindent \defargsindent=50pt
   6850 \newskip\deflastargmargin \deflastargmargin=18pt
   6851 \newcount\defunpenalty
   6852 
   6853 % Start the processing of @deffn:
   6854 \def\startdefun{%
   6855   \ifnum\lastpenalty<10000
   6856     \medbreak
   6857     \defunpenalty=10003 % Will keep this @deffn together with the
   6858                         % following @def command, see below.
   6859   \else
   6860     % If there are two @def commands in a row, we'll have a \nobreak,
   6861     % which is there to keep the function description together with its
   6862     % header.  But if there's nothing but headers, we need to allow a
   6863     % break somewhere.  Check specifically for penalty 10002, inserted
   6864     % by \printdefunline, instead of 10000, since the sectioning
   6865     % commands also insert a nobreak penalty, and we don't want to allow
   6866     % a break between a section heading and a defun.
   6867     %
   6868     % As a further refinement, we avoid "club" headers by signalling
   6869     % with penalty of 10003 after the very first @deffn in the
   6870     % sequence (see above), and penalty of 10002 after any following
   6871     % @def command.
   6872     \ifnum\lastpenalty=10002 \penalty2000 \else \defunpenalty=10002 \fi
   6873     %
   6874     % Similarly, after a section heading, do not allow a break.
   6875     % But do insert the glue.
   6876     \medskip  % preceded by discardable penalty, so not a breakpoint
   6877   \fi
   6878   %
   6879   \parindent=0in
   6880   \advance\leftskip by \defbodyindent
   6881   \exdentamount=\defbodyindent
   6882 }
   6883 
   6884 \def\dodefunx#1{%
   6885   % First, check whether we are in the right environment:
   6886   \checkenv#1%
   6887   %
   6888   % As above, allow line break if we have multiple x headers in a row.
   6889   % It's not a great place, though.
   6890   \ifnum\lastpenalty=10002 \penalty3000 \else \defunpenalty=10002 \fi
   6891   %
   6892   % And now, it's time to reuse the body of the original defun:
   6893   \expandafter\gobbledefun#1%
   6894 }
   6895 \def\gobbledefun#1\startdefun{}
   6896 
   6897 % \printdefunline \deffnheader{text}
   6898 %
   6899 \def\printdefunline#1#2{%
   6900   \begingroup
   6901     % call \deffnheader:
   6902     #1#2 \endheader
   6903     % common ending:
   6904     \interlinepenalty = 10000
   6905     \advance\rightskip by 0pt plus 1fil\relax
   6906     \endgraf
   6907     \nobreak\vskip -\parskip
   6908     \penalty\defunpenalty  % signal to \startdefun and \dodefunx
   6909     % Some of the @defun-type tags do not enable magic parentheses,
   6910     % rendering the following check redundant.  But we don't optimize.
   6911     \checkparencounts
   6912   \endgroup
   6913 }
   6914 
   6915 \def\Edefun{\endgraf\medbreak}
   6916 
   6917 % \makedefun{deffn} creates \deffn, \deffnx and \Edeffn;
   6918 % the only thing remaining is to define \deffnheader.
   6919 %
   6920 \def\makedefun#1{%
   6921   \expandafter\let\csname E#1\endcsname = \Edefun
   6922   \edef\temp{\noexpand\domakedefun
   6923     \makecsname{#1}\makecsname{#1x}\makecsname{#1header}}%
   6924   \temp
   6925 }
   6926 
   6927 % \domakedefun \deffn \deffnx \deffnheader
   6928 %
   6929 % Define \deffn and \deffnx, without parameters.
   6930 % \deffnheader has to be defined explicitly.
   6931 %
   6932 \def\domakedefun#1#2#3{%
   6933   \envdef#1{%
   6934     \startdefun
   6935     \doingtypefnfalse    % distinguish typed functions from all else
   6936     \parseargusing\activeparens{\printdefunline#3}%
   6937   }%
   6938   \def#2{\dodefunx#1}%
   6939   \def#3%
   6940 }
   6941 
   6942 \newif\ifdoingtypefn       % doing typed function?
   6943 \newif\ifrettypeownline    % typeset return type on its own line?
   6944 
   6945 % @deftypefnnewline on|off says whether the return type of typed functions
   6946 % are printed on their own line.  This affects @deftypefn, @deftypefun,
   6947 % @deftypeop, and @deftypemethod.
   6948 %
   6949 \parseargdef\deftypefnnewline{%
   6950   \def\temp{#1}%
   6951   \ifx\temp\onword
   6952     \expandafter\let\csname SETtxideftypefnnl\endcsname
   6953       = \empty
   6954   \else\ifx\temp\offword
   6955     \expandafter\let\csname SETtxideftypefnnl\endcsname
   6956       = \relax
   6957   \else
   6958     \errhelp = \EMsimple
   6959     \errmessage{Unknown @txideftypefnnl value `\temp',
   6960                 must be on|off}%
   6961   \fi\fi
   6962 }
   6963 
   6964 % Untyped functions:
   6965 
   6966 % @deffn category name args
   6967 \makedefun{deffn}{\deffngeneral{}}
   6968 
   6969 % @deffn category class name args
   6970 \makedefun{defop}#1 {\defopon{#1\ \putwordon}}
   6971 
   6972 % \defopon {category on}class name args
   6973 \def\defopon#1#2 {\deffngeneral{\putwordon\ \code{#2}}{#1\ \code{#2}} }
   6974 
   6975 % \deffngeneral {subind}category name args
   6976 %
   6977 \def\deffngeneral#1#2 #3 #4\endheader{%
   6978   % Remember that \dosubind{fn}{foo}{} is equivalent to \doind{fn}{foo}.
   6979   \dosubind{fn}{\code{#3}}{#1}%
   6980   \defname{#2}{}{#3}\magicamp\defunargs{#4\unskip}%
   6981 }
   6982 
   6983 % Typed functions:
   6984 
   6985 % @deftypefn category type name args
   6986 \makedefun{deftypefn}{\deftypefngeneral{}}
   6987 
   6988 % @deftypeop category class type name args
   6989 \makedefun{deftypeop}#1 {\deftypeopon{#1\ \putwordon}}
   6990 
   6991 % \deftypeopon {category on}class type name args
   6992 \def\deftypeopon#1#2 {\deftypefngeneral{\putwordon\ \code{#2}}{#1\ \code{#2}} }
   6993 
   6994 % \deftypefngeneral {subind}category type name args
   6995 %
   6996 \def\deftypefngeneral#1#2 #3 #4 #5\endheader{%
   6997   \dosubind{fn}{\code{#4}}{#1}%
   6998   \doingtypefntrue
   6999   \defname{#2}{#3}{#4}\defunargs{#5\unskip}%
   7000 }
   7001 
   7002 % Typed variables:
   7003 
   7004 % @deftypevr category type var args
   7005 \makedefun{deftypevr}{\deftypecvgeneral{}}
   7006 
   7007 % @deftypecv category class type var args
   7008 \makedefun{deftypecv}#1 {\deftypecvof{#1\ \putwordof}}
   7009 
   7010 % \deftypecvof {category of}class type var args
   7011 \def\deftypecvof#1#2 {\deftypecvgeneral{\putwordof\ \code{#2}}{#1\ \code{#2}} }
   7012 
   7013 % \deftypecvgeneral {subind}category type var args
   7014 %
   7015 \def\deftypecvgeneral#1#2 #3 #4 #5\endheader{%
   7016   \dosubind{vr}{\code{#4}}{#1}%
   7017   \defname{#2}{#3}{#4}\defunargs{#5\unskip}%
   7018 }
   7019 
   7020 % Untyped variables:
   7021 
   7022 % @defvr category var args
   7023 \makedefun{defvr}#1 {\deftypevrheader{#1} {} }
   7024 
   7025 % @defcv category class var args
   7026 \makedefun{defcv}#1 {\defcvof{#1\ \putwordof}}
   7027 
   7028 % \defcvof {category of}class var args
   7029 \def\defcvof#1#2 {\deftypecvof{#1}#2 {} }
   7030 
   7031 % Types:
   7032 
   7033 % @deftp category name args
   7034 \makedefun{deftp}#1 #2 #3\endheader{%
   7035   \doind{tp}{\code{#2}}%
   7036   \defname{#1}{}{#2}\defunargs{#3\unskip}%
   7037 }
   7038 
   7039 % Remaining @defun-like shortcuts:
   7040 \makedefun{defun}{\deffnheader{\putwordDeffunc} }
   7041 \makedefun{defmac}{\deffnheader{\putwordDefmac} }
   7042 \makedefun{defspec}{\deffnheader{\putwordDefspec} }
   7043 \makedefun{deftypefun}{\deftypefnheader{\putwordDeffunc} }
   7044 \makedefun{defvar}{\defvrheader{\putwordDefvar} }
   7045 \makedefun{defopt}{\defvrheader{\putwordDefopt} }
   7046 \makedefun{deftypevar}{\deftypevrheader{\putwordDefvar} }
   7047 \makedefun{defmethod}{\defopon\putwordMethodon}
   7048 \makedefun{deftypemethod}{\deftypeopon\putwordMethodon}
   7049 \makedefun{defivar}{\defcvof\putwordInstanceVariableof}
   7050 \makedefun{deftypeivar}{\deftypecvof\putwordInstanceVariableof}
   7051 
   7052 % \defname, which formats the name of the @def (not the args).
   7053 % #1 is the category, such as "Function".
   7054 % #2 is the return type, if any.
   7055 % #3 is the function name.
   7056 %
   7057 % We are followed by (but not passed) the arguments, if any.
   7058 %
   7059 \def\defname#1#2#3{%
   7060   \par
   7061   % Get the values of \leftskip and \rightskip as they were outside the @def...
   7062   \advance\leftskip by -\defbodyindent
   7063   %
   7064   % Determine if we are typesetting the return type of a typed function
   7065   % on a line by itself.
   7066   \rettypeownlinefalse
   7067   \ifdoingtypefn  % doing a typed function specifically?
   7068     % then check user option for putting return type on its own line:
   7069     \expandafter\ifx\csname SETtxideftypefnnl\endcsname\relax \else
   7070       \rettypeownlinetrue
   7071     \fi
   7072   \fi
   7073   %
   7074   % How we'll format the category name.  Putting it in brackets helps
   7075   % distinguish it from the body text that may end up on the next line
   7076   % just below it.
   7077   \def\temp{#1}%
   7078   \setbox0=\hbox{\kern\deflastargmargin \ifx\temp\empty\else [\rm\temp]\fi}
   7079   %
   7080   % Figure out line sizes for the paragraph shape.  We'll always have at
   7081   % least two.
   7082   \tempnum = 2
   7083   %
   7084   % The first line needs space for \box0; but if \rightskip is nonzero,
   7085   % we need only space for the part of \box0 which exceeds it:
   7086   \dimen0=\hsize  \advance\dimen0 by -\wd0  \advance\dimen0 by \rightskip
   7087   %
   7088   % If doing a return type on its own line, we'll have another line.
   7089   \ifrettypeownline
   7090     \advance\tempnum by 1
   7091     \def\maybeshapeline{0in \hsize}%
   7092   \else
   7093     \def\maybeshapeline{}%
   7094   \fi
   7095   %
   7096   % The continuations:
   7097   \dimen2=\hsize  \advance\dimen2 by -\defargsindent
   7098   %
   7099   % The final paragraph shape:
   7100   \parshape \tempnum  0in \dimen0  \maybeshapeline  \defargsindent \dimen2
   7101   %
   7102   % Put the category name at the right margin.
   7103   \noindent
   7104   \hbox to 0pt{%
   7105     \hfil\box0 \kern-\hsize
   7106     % \hsize has to be shortened this way:
   7107     \kern\leftskip
   7108     % Intentionally do not respect \rightskip, since we need the space.
   7109   }%
   7110   %
   7111   % Allow all lines to be underfull without complaint:
   7112   \tolerance=10000 \hbadness=10000
   7113   \exdentamount=\defbodyindent
   7114   {%
   7115     % defun fonts. We use typewriter by default (used to be bold) because:
   7116     % . we're printing identifiers, they should be in tt in principle.
   7117     % . in languages with many accents, such as Czech or French, it's
   7118     %   common to leave accents off identifiers.  The result looks ok in
   7119     %   tt, but exceedingly strange in rm.
   7120     % . we don't want -- and --- to be treated as ligatures.
   7121     % . this still does not fix the ?` and !` ligatures, but so far no
   7122     %   one has made identifiers using them :).
   7123     \df \tt
   7124     \def\temp{#2}% text of the return type
   7125     \ifx\temp\empty\else
   7126       \tclose{\temp}% typeset the return type
   7127       \ifrettypeownline
   7128         % put return type on its own line; prohibit line break following:
   7129         \hfil\vadjust{\nobreak}\break
   7130       \else
   7131         \space  % type on same line, so just followed by a space
   7132       \fi
   7133     \fi           % no return type
   7134     #3% output function name
   7135   }%
   7136   {\rm\enskip}% hskip 0.5 em of \tenrm
   7137   %
   7138   \boldbrax
   7139   % arguments will be output next, if any.
   7140 }
   7141 
   7142 % Print arguments in slanted roman (not ttsl), inconsistently with using
   7143 % tt for the name.  This is because literal text is sometimes needed in
   7144 % the argument list (groff manual), and ttsl and tt are not very
   7145 % distinguishable.  Prevent hyphenation at `-' chars.
   7146 %
   7147 \def\defunargs#1{%
   7148   % use sl by default (not ttsl),
   7149   % tt for the names.
   7150   \df \sl \hyphenchar\font=0
   7151   %
   7152   % On the other hand, if an argument has two dashes (for instance), we
   7153   % want a way to get ttsl.  We used to recommend @var for that, so
   7154   % leave the code in, but it's strange for @var to lead to typewriter.
   7155   % Nowadays we recommend @code, since the difference between a ttsl hyphen
   7156   % and a tt hyphen is pretty tiny.  @code also disables ?` !`.
   7157   \def\var##1{{\setupmarkupstyle{var}\ttslanted{##1}}}%
   7158   #1%
   7159   \sl\hyphenchar\font=45
   7160 }
   7161 
   7162 % We want ()&[] to print specially on the defun line.
   7163 %
   7164 \def\activeparens{%
   7165   \catcode`\(=\active \catcode`\)=\active
   7166   \catcode`\[=\active \catcode`\]=\active
   7167   \catcode`\&=\active
   7168 }
   7169 
   7170 % Make control sequences which act like normal parenthesis chars.
   7171 \let\lparen = ( \let\rparen = )
   7172 
   7173 % Be sure that we always have a definition for `(', etc.  For example,
   7174 % if the fn name has parens in it, \boldbrax will not be in effect yet,
   7175 % so TeX would otherwise complain about undefined control sequence.
   7176 {
   7177   \activeparens
   7178   \global\let(=\lparen \global\let)=\rparen
   7179   \global\let[=\lbrack \global\let]=\rbrack
   7180   \global\let& = \&
   7181 
   7182   \gdef\boldbrax{\let(=\opnr\let)=\clnr\let[=\lbrb\let]=\rbrb}
   7183   \gdef\magicamp{\let&=\amprm}
   7184 }
   7185 
   7186 \newcount\parencount
   7187 
   7188 % If we encounter &foo, then turn on ()-hacking afterwards
   7189 \newif\ifampseen
   7190 \def\amprm#1 {\ampseentrue{\bf\&#1 }}
   7191 
   7192 \def\parenfont{%
   7193   \ifampseen
   7194     % At the first level, print parens in roman,
   7195     % otherwise use the default font.
   7196     \ifnum \parencount=1 \rm \fi
   7197   \else
   7198     % The \sf parens (in \boldbrax) actually are a little bolder than
   7199     % the contained text.  This is especially needed for [ and ] .
   7200     \sf
   7201   \fi
   7202 }
   7203 \def\infirstlevel#1{%
   7204   \ifampseen
   7205     \ifnum\parencount=1
   7206       #1%
   7207     \fi
   7208   \fi
   7209 }
   7210 \def\bfafterword#1 {#1 \bf}
   7211 
   7212 \def\opnr{%
   7213   \global\advance\parencount by 1
   7214   {\parenfont(}%
   7215   \infirstlevel \bfafterword
   7216 }
   7217 \def\clnr{%
   7218   {\parenfont)}%
   7219   \infirstlevel \sl
   7220   \global\advance\parencount by -1
   7221 }
   7222 
   7223 \newcount\brackcount
   7224 \def\lbrb{%
   7225   \global\advance\brackcount by 1
   7226   {\bf[}%
   7227 }
   7228 \def\rbrb{%
   7229   {\bf]}%
   7230   \global\advance\brackcount by -1
   7231 }
   7232 
   7233 \def\checkparencounts{%
   7234   \ifnum\parencount=0 \else \badparencount \fi
   7235   \ifnum\brackcount=0 \else \badbrackcount \fi
   7236 }
   7237 % these should not use \errmessage; the glibc manual, at least, actually
   7238 % has such constructs (when documenting function pointers).
   7239 \def\badparencount{%
   7240   \message{Warning: unbalanced parentheses in @def...}%
   7241   \global\parencount=0
   7242 }
   7243 \def\badbrackcount{%
   7244   \message{Warning: unbalanced square brackets in @def...}%
   7245   \global\brackcount=0
   7246 }
   7247 
   7248 
   7249 \message{macros,}
   7250 % @macro.
   7251 
   7252 % To do this right we need a feature of e-TeX, \scantokens,
   7253 % which we arrange to emulate with a temporary file in ordinary TeX.
   7254 \ifx\eTeXversion\thisisundefined
   7255   \newwrite\macscribble
   7256   \def\scantokens#1{%
   7257     \toks0={#1}%
   7258     \immediate\openout\macscribble=\jobname.tmp
   7259     \immediate\write\macscribble{\the\toks0}%
   7260     \immediate\closeout\macscribble
   7261     \input \jobname.tmp
   7262   }
   7263 \fi
   7264 
   7265 \def\scanmacro#1{\begingroup
   7266   \newlinechar`\^^M
   7267   \let\xeatspaces\eatspaces
   7268   %
   7269   % Undo catcode changes of \startcontents and \doprintindex
   7270   % When called from @insertcopying or (short)caption, we need active
   7271   % backslash to get it printed correctly.  Previously, we had
   7272   % \catcode`\\=\other instead.  We'll see whether a problem appears
   7273   % with macro expansion.				--kasal, 19aug04
   7274   \catcode`\@=0 \catcode`\\=\active \escapechar=`\@
   7275   %
   7276   % ... and for \example:
   7277   \spaceisspace
   7278   %
   7279   % The \empty here causes a following catcode 5 newline to be eaten as
   7280   % part of reading whitespace after a control sequence.  It does not
   7281   % eat a catcode 13 newline.  There's no good way to handle the two
   7282   % cases (untried: maybe e-TeX's \everyeof could help, though plain TeX
   7283   % would then have different behavior).  See the Macro Details node in
   7284   % the manual for the workaround we recommend for macros and
   7285   % line-oriented commands.
   7286   %
   7287   \scantokens{#1\empty}%
   7288 \endgroup}
   7289 
   7290 \def\scanexp#1{%
   7291   \edef\temp{\noexpand\scanmacro{#1}}%
   7292   \temp
   7293 }
   7294 
   7295 \newcount\paramno   % Count of parameters
   7296 \newtoks\macname    % Macro name
   7297 \newif\ifrecursive  % Is it recursive?
   7298 
   7299 % List of all defined macros in the form
   7300 %    \definedummyword\macro1\definedummyword\macro2...
   7301 % Currently is also contains all @aliases; the list can be split
   7302 % if there is a need.
   7303 \def\macrolist{}
   7304 
   7305 % Add the macro to \macrolist
   7306 \def\addtomacrolist#1{\expandafter \addtomacrolistxxx \csname#1\endcsname}
   7307 \def\addtomacrolistxxx#1{%
   7308      \toks0 = \expandafter{\macrolist\definedummyword#1}%
   7309      \xdef\macrolist{\the\toks0}%
   7310 }
   7311 
   7312 % Utility routines.
   7313 % This does \let #1 = #2, with \csnames; that is,
   7314 %   \let \csname#1\endcsname = \csname#2\endcsname
   7315 % (except of course we have to play expansion games).
   7316 %
   7317 \def\cslet#1#2{%
   7318   \expandafter\let
   7319   \csname#1\expandafter\endcsname
   7320   \csname#2\endcsname
   7321 }
   7322 
   7323 % Trim leading and trailing spaces off a string.
   7324 % Concepts from aro-bend problem 15 (see CTAN).
   7325 {\catcode`\@=11
   7326 \gdef\eatspaces #1{\expandafter\trim@\expandafter{#1 }}
   7327 \gdef\trim@ #1{\trim@@ @#1 @ #1 @ @@}
   7328 \gdef\trim@@ #1@ #2@ #3@@{\trim@@@\empty #2 @}
   7329 \def\unbrace#1{#1}
   7330 \unbrace{\gdef\trim@@@ #1 } #2@{#1}
   7331 }
   7332 
   7333 % Trim a single trailing ^^M off a string.
   7334 {\catcode`\^^M=\other \catcode`\Q=3%
   7335 \gdef\eatcr #1{\eatcra #1Q^^MQ}%
   7336 \gdef\eatcra#1^^MQ{\eatcrb#1Q}%
   7337 \gdef\eatcrb#1Q#2Q{#1}%
   7338 }
   7339 
   7340 % Macro bodies are absorbed as an argument in a context where
   7341 % all characters are catcode 10, 11 or 12, except \ which is active
   7342 % (as in normal texinfo). It is necessary to change the definition of \
   7343 % to recognize macro arguments; this is the job of \mbodybackslash.
   7344 %
   7345 % Non-ASCII encodings make 8-bit characters active, so un-activate
   7346 % them to avoid their expansion.  Must do this non-globally, to
   7347 % confine the change to the current group.
   7348 %
   7349 % It's necessary to have hard CRs when the macro is executed. This is
   7350 % done by making ^^M (\endlinechar) catcode 12 when reading the macro
   7351 % body, and then making it the \newlinechar in \scanmacro.
   7352 %
   7353 \def\scanctxt{% used as subroutine
   7354   \catcode`\"=\other
   7355   \catcode`\+=\other
   7356   \catcode`\<=\other
   7357   \catcode`\>=\other
   7358   \catcode`\@=\other
   7359   \catcode`\^=\other
   7360   \catcode`\_=\other
   7361   \catcode`\|=\other
   7362   \catcode`\~=\other
   7363   \ifx\declaredencoding\ascii \else \setnonasciicharscatcodenonglobal\other \fi
   7364 }
   7365 
   7366 \def\scanargctxt{% used for copying and captions, not macros.
   7367   \scanctxt
   7368   \catcode`\\=\other
   7369   \catcode`\^^M=\other
   7370 }
   7371 
   7372 \def\macrobodyctxt{% used for @macro definitions
   7373   \scanctxt
   7374   \catcode`\{=\other
   7375   \catcode`\}=\other
   7376   \catcode`\^^M=\other
   7377   \usembodybackslash
   7378 }
   7379 
   7380 \def\macroargctxt{% used when scanning invocations
   7381   \scanctxt
   7382   \catcode`\\=0
   7383 }
   7384 % why catcode 0 for \ in the above?  To recognize \\ \{ \} as "escapes"
   7385 % for the single characters \ { }.  Thus, we end up with the "commands"
   7386 % that would be written @\ @{ @} in a Texinfo document.
   7387 %
   7388 % We already have @{ and @}.  For @\, we define it here, and only for
   7389 % this purpose, to produce a typewriter backslash (so, the @\ that we
   7390 % define for @math can't be used with @macro calls):
   7391 %
   7392 \def\\{\normalbackslash}%
   7393 %
   7394 % We would like to do this for \, too, since that is what makeinfo does.
   7395 % But it is not possible, because Texinfo already has a command @, for a
   7396 % cedilla accent.  Documents must use @comma{} instead.
   7397 %
   7398 % \anythingelse will almost certainly be an error of some kind.
   7399 
   7400 
   7401 % \mbodybackslash is the definition of \ in @macro bodies.
   7402 % It maps \foo\ => \csname macarg.foo\endcsname => #N
   7403 % where N is the macro parameter number.
   7404 % We define \csname macarg.\endcsname to be \realbackslash, so
   7405 % \\ in macro replacement text gets you a backslash.
   7406 %
   7407 {\catcode`@=0 @catcode`@\=@active
   7408  @gdef@usembodybackslash{@let\=@mbodybackslash}
   7409  @gdef@mbodybackslash#1\{@csname macarg.#1@endcsname}
   7410 }
   7411 \expandafter\def\csname macarg.\endcsname{\realbackslash}
   7412 
   7413 \def\margbackslash#1{\char`\#1 }
   7414 
   7415 \def\macro{\recursivefalse\parsearg\macroxxx}
   7416 \def\rmacro{\recursivetrue\parsearg\macroxxx}
   7417 
   7418 \def\macroxxx#1{%
   7419   \getargs{#1}% now \macname is the macname and \argl the arglist
   7420   \ifx\argl\empty       % no arguments
   7421      \paramno=0\relax
   7422   \else
   7423      \expandafter\parsemargdef \argl;%
   7424      \if\paramno>256\relax
   7425        \ifx\eTeXversion\thisisundefined
   7426          \errhelp = \EMsimple
   7427          \errmessage{You need eTeX to compile a file with macros with more than 256 arguments}
   7428        \fi
   7429      \fi
   7430   \fi
   7431   \if1\csname ismacro.\the\macname\endcsname
   7432      \message{Warning: redefining \the\macname}%
   7433   \else
   7434      \expandafter\ifx\csname \the\macname\endcsname \relax
   7435      \else \errmessage{Macro name \the\macname\space already defined}\fi
   7436      \global\cslet{macsave.\the\macname}{\the\macname}%
   7437      \global\expandafter\let\csname ismacro.\the\macname\endcsname=1%
   7438      \addtomacrolist{\the\macname}%
   7439   \fi
   7440   \begingroup \macrobodyctxt
   7441   \ifrecursive \expandafter\parsermacbody
   7442   \else \expandafter\parsemacbody
   7443   \fi}
   7444 
   7445 \parseargdef\unmacro{%
   7446   \if1\csname ismacro.#1\endcsname
   7447     \global\cslet{#1}{macsave.#1}%
   7448     \global\expandafter\let \csname ismacro.#1\endcsname=0%
   7449     % Remove the macro name from \macrolist:
   7450     \begingroup
   7451       \expandafter\let\csname#1\endcsname \relax
   7452       \let\definedummyword\unmacrodo
   7453       \xdef\macrolist{\macrolist}%
   7454     \endgroup
   7455   \else
   7456     \errmessage{Macro #1 not defined}%
   7457   \fi
   7458 }
   7459 
   7460 % Called by \do from \dounmacro on each macro.  The idea is to omit any
   7461 % macro definitions that have been changed to \relax.
   7462 %
   7463 \def\unmacrodo#1{%
   7464   \ifx #1\relax
   7465     % remove this
   7466   \else
   7467     \noexpand\definedummyword \noexpand#1%
   7468   \fi
   7469 }
   7470 
   7471 % This makes use of the obscure feature that if the last token of a
   7472 % <parameter list> is #, then the preceding argument is delimited by
   7473 % an opening brace, and that opening brace is not consumed.
   7474 \def\getargs#1{\getargsxxx#1{}}
   7475 \def\getargsxxx#1#{\getmacname #1 \relax\getmacargs}
   7476 \def\getmacname#1 #2\relax{\macname={#1}}
   7477 \def\getmacargs#1{\def\argl{#1}}
   7478 
   7479 % For macro processing make @ a letter so that we can make Texinfo private macro names.
   7480 \edef\texiatcatcode{\the\catcode`\@}
   7481 \catcode `@=11\relax
   7482 
   7483 % Parse the optional {params} list.  Set up \paramno and \paramlist
   7484 % so \defmacro knows what to do.  Define \macarg.BLAH for each BLAH
   7485 % in the params list to some hook where the argument si to be expanded.  If
   7486 % there are less than 10 arguments that hook is to be replaced by ##N where N
   7487 % is the position in that list, that is to say the macro arguments are to be
   7488 % defined `a la TeX in the macro body.
   7489 %
   7490 % That gets used by \mbodybackslash (above).
   7491 %
   7492 % We need to get `macro parameter char #' into several definitions.
   7493 % The technique used is stolen from LaTeX: let \hash be something
   7494 % unexpandable, insert that wherever you need a #, and then redefine
   7495 % it to # just before using the token list produced.
   7496 %
   7497 % The same technique is used to protect \eatspaces till just before
   7498 % the macro is used.
   7499 %
   7500 % If there are 10 or more arguments, a different technique is used, where the
   7501 % hook remains in the body, and when macro is to be expanded the body is
   7502 % processed again to replace the arguments.
   7503 %
   7504 % In that case, the hook is \the\toks N-1, and we simply set \toks N-1 to the
   7505 % argument N value and then \edef  the body (nothing else will expand because of
   7506 % the catcode regime underwhich the body was input).
   7507 %
   7508 % If you compile with TeX (not eTeX), and you have macros with 10 or more
   7509 % arguments, you need that no macro has more than 256 arguments, otherwise an
   7510 % error is produced.
   7511 \def\parsemargdef#1;{%
   7512   \paramno=0\def\paramlist{}%
   7513   \let\hash\relax
   7514   \let\xeatspaces\relax
   7515   \parsemargdefxxx#1,;,%
   7516   % In case that there are 10 or more arguments we parse again the arguments
   7517   % list to set new definitions for the \macarg.BLAH macros corresponding to
   7518   % each BLAH argument. It was anyhow needed to parse already once this list
   7519   % in order to count the arguments, and as macros with at most 9 arguments
   7520   % are by far more frequent than macro with 10 or more arguments, defining
   7521   % twice the \macarg.BLAH macros does not cost too much processing power.
   7522   \ifnum\paramno<10\relax\else
   7523     \paramno0\relax
   7524     \parsemmanyargdef@@#1,;,% 10 or more arguments
   7525   \fi
   7526 }
   7527 \def\parsemargdefxxx#1,{%
   7528   \if#1;\let\next=\relax
   7529   \else \let\next=\parsemargdefxxx
   7530     \advance\paramno by 1
   7531     \expandafter\edef\csname macarg.\eatspaces{#1}\endcsname
   7532         {\xeatspaces{\hash\the\paramno}}%
   7533     \edef\paramlist{\paramlist\hash\the\paramno,}%
   7534   \fi\next}
   7535 
   7536 \def\parsemmanyargdef@@#1,{%
   7537   \if#1;\let\next=\relax
   7538   \else
   7539     \let\next=\parsemmanyargdef@@
   7540     \edef\tempb{\eatspaces{#1}}%
   7541     \expandafter\def\expandafter\tempa
   7542        \expandafter{\csname macarg.\tempb\endcsname}%
   7543     % Note that we need some extra \noexpand\noexpand, this is because we
   7544     % don't want \the  to be expanded in the \parsermacbody  as it uses an
   7545     % \xdef .
   7546     \expandafter\edef\tempa
   7547       {\noexpand\noexpand\noexpand\the\toks\the\paramno}%
   7548     \advance\paramno by 1\relax
   7549   \fi\next}
   7550 
   7551 % These two commands read recursive and nonrecursive macro bodies.
   7552 % (They're different since rec and nonrec macros end differently.)
   7553 %
   7554 
   7555 \catcode `\@\texiatcatcode
   7556 \long\def\parsemacbody#1@end macro%
   7557 {\xdef\temp{\eatcr{#1}}\endgroup\defmacro}%
   7558 \long\def\parsermacbody#1@end rmacro%
   7559 {\xdef\temp{\eatcr{#1}}\endgroup\defmacro}%
   7560 \catcode `\@=11\relax
   7561 
   7562 \let\endargs@\relax
   7563 \let\nil@\relax
   7564 \def\nilm@{\nil@}%
   7565 \long\def\nillm@{\nil@}%
   7566 
   7567 % This macro is expanded during the Texinfo macro expansion, not during its
   7568 % definition.  It gets all the arguments values and assigns them to macros
   7569 % macarg.ARGNAME
   7570 %
   7571 % #1 is the macro name
   7572 % #2 is the list of argument names
   7573 % #3 is the list of argument values
   7574 \def\getargvals@#1#2#3{%
   7575   \def\macargdeflist@{}%
   7576   \def\saveparamlist@{#2}% Need to keep a copy for parameter expansion.
   7577   \def\paramlist{#2,\nil@}%
   7578   \def\macroname{#1}%
   7579   \begingroup
   7580   \macroargctxt
   7581   \def\argvaluelist{#3,\nil@}%
   7582   \def\@tempa{#3}%
   7583   \ifx\@tempa\empty
   7584     \setemptyargvalues@
   7585   \else
   7586     \getargvals@@
   7587   \fi
   7588 }
   7589 
   7590 %
   7591 \def\getargvals@@{%
   7592   \ifx\paramlist\nilm@
   7593       % Some sanity check needed here that \argvaluelist is also empty.
   7594       \ifx\argvaluelist\nillm@
   7595       \else
   7596         \errhelp = \EMsimple
   7597         \errmessage{Too many arguments in macro `\macroname'!}%
   7598       \fi
   7599       \let\next\macargexpandinbody@
   7600   \else
   7601     \ifx\argvaluelist\nillm@
   7602        % No more arguments values passed to macro.  Set remaining named-arg
   7603        % macros to empty.
   7604        \let\next\setemptyargvalues@
   7605     \else
   7606       % pop current arg name into \@tempb
   7607       \def\@tempa##1{\pop@{\@tempb}{\paramlist}##1\endargs@}%
   7608       \expandafter\@tempa\expandafter{\paramlist}%
   7609        % pop current argument value into \@tempc
   7610       \def\@tempa##1{\longpop@{\@tempc}{\argvaluelist}##1\endargs@}%
   7611       \expandafter\@tempa\expandafter{\argvaluelist}%
   7612        % Here \@tempb is the current arg name and \@tempc is the current arg value.
   7613        % First place the new argument macro definition into \@tempd
   7614        \expandafter\macname\expandafter{\@tempc}%
   7615        \expandafter\let\csname macarg.\@tempb\endcsname\relax
   7616        \expandafter\def\expandafter\@tempe\expandafter{%
   7617          \csname macarg.\@tempb\endcsname}%
   7618        \edef\@tempd{\long\def\@tempe{\the\macname}}%
   7619        \push@\@tempd\macargdeflist@
   7620        \let\next\getargvals@@
   7621     \fi
   7622   \fi
   7623   \next
   7624 }
   7625 
   7626 \def\push@#1#2{%
   7627   \expandafter\expandafter\expandafter\def
   7628   \expandafter\expandafter\expandafter#2%
   7629   \expandafter\expandafter\expandafter{%
   7630   \expandafter#1#2}%
   7631 }
   7632 
   7633 % Replace arguments by their values in the macro body, and place the result
   7634 % in macro \@tempa
   7635 \def\macvalstoargs@{%
   7636   %  To do this we use the property that token registers that are \the'ed
   7637   % within an \edef  expand only once. So we are going to place all argument
   7638   % values into respective token registers.
   7639   %
   7640   % First we save the token context, and initialize argument numbering.
   7641   \begingroup
   7642     \paramno0\relax
   7643     % Then, for each argument number #N, we place the corresponding argument
   7644     % value into a new token list register \toks#N
   7645     \expandafter\putargsintokens@\saveparamlist@,;,%
   7646     % Then, we expand the body so that argument are replaced by their
   7647     % values. The trick for values not to be expanded themselves is that they
   7648     % are within tokens and that tokens expand only once in an \edef .
   7649     \edef\@tempc{\csname mac.\macroname .body\endcsname}%
   7650     % Now we restore the token stack pointer to free the token list registers
   7651     % which we have used, but we make sure that expanded body is saved after
   7652     % group.
   7653     \expandafter
   7654   \endgroup
   7655   \expandafter\def\expandafter\@tempa\expandafter{\@tempc}%
   7656   }
   7657 
   7658 \def\macargexpandinbody@{%
   7659   %% Define the named-macro outside of this group and then close this group.
   7660   \expandafter
   7661   \endgroup
   7662   \macargdeflist@
   7663   % First the replace in body the macro arguments by their values, the result
   7664   % is in \@tempa .
   7665   \macvalstoargs@
   7666   % Then we point at the \norecurse or \gobble (for recursive) macro value
   7667   % with \@tempb .
   7668   \expandafter\let\expandafter\@tempb\csname mac.\macroname .recurse\endcsname
   7669   % Depending on whether it is recursive or not, we need some tailing
   7670   % \egroup .
   7671   \ifx\@tempb\gobble
   7672      \let\@tempc\relax
   7673   \else
   7674      \let\@tempc\egroup
   7675   \fi
   7676   % And now we do the real job:
   7677   \edef\@tempd{\noexpand\@tempb{\macroname}\noexpand\scanmacro{\@tempa}\@tempc}%
   7678   \@tempd
   7679 }
   7680 
   7681 \def\putargsintokens@#1,{%
   7682   \if#1;\let\next\relax
   7683   \else
   7684     \let\next\putargsintokens@
   7685     % First we allocate the new token list register, and give it a temporary
   7686     % alias \@tempb .
   7687     \toksdef\@tempb\the\paramno
   7688     % Then we place the argument value into that token list register.
   7689     \expandafter\let\expandafter\@tempa\csname macarg.#1\endcsname
   7690     \expandafter\@tempb\expandafter{\@tempa}%
   7691     \advance\paramno by 1\relax
   7692   \fi
   7693   \next
   7694 }
   7695 
   7696 % Save the token stack pointer into macro #1
   7697 \def\texisavetoksstackpoint#1{\edef#1{\the\@cclvi}}
   7698 % Restore the token stack pointer from number in macro #1
   7699 \def\texirestoretoksstackpoint#1{\expandafter\mathchardef\expandafter\@cclvi#1\relax}
   7700 % newtoks that can be used non \outer .
   7701 \def\texinonouternewtoks{\alloc@ 5\toks \toksdef \@cclvi}
   7702 
   7703 % Tailing missing arguments are set to empty
   7704 \def\setemptyargvalues@{%
   7705   \ifx\paramlist\nilm@
   7706     \let\next\macargexpandinbody@
   7707   \else
   7708     \expandafter\setemptyargvaluesparser@\paramlist\endargs@
   7709     \let\next\setemptyargvalues@
   7710   \fi
   7711   \next
   7712 }
   7713 
   7714 \def\setemptyargvaluesparser@#1,#2\endargs@{%
   7715   \expandafter\def\expandafter\@tempa\expandafter{%
   7716     \expandafter\def\csname macarg.#1\endcsname{}}%
   7717   \push@\@tempa\macargdeflist@
   7718   \def\paramlist{#2}%
   7719 }
   7720 
   7721 % #1 is the element target macro
   7722 % #2 is the list macro
   7723 % #3,#4\endargs@ is the list value
   7724 \def\pop@#1#2#3,#4\endargs@{%
   7725    \def#1{#3}%
   7726    \def#2{#4}%
   7727 }
   7728 \long\def\longpop@#1#2#3,#4\endargs@{%
   7729    \long\def#1{#3}%
   7730    \long\def#2{#4}%
   7731 }
   7732 
   7733 % This defines a Texinfo @macro. There are eight cases: recursive and
   7734 % nonrecursive macros of zero, one, up to nine, and many arguments.
   7735 % Much magic with \expandafter here.
   7736 % \xdef is used so that macro definitions will survive the file
   7737 % they're defined in; @include reads the file inside a group.
   7738 %
   7739 \def\defmacro{%
   7740   \let\hash=##% convert placeholders to macro parameter chars
   7741   \ifrecursive
   7742     \ifcase\paramno
   7743     % 0
   7744       \expandafter\xdef\csname\the\macname\endcsname{%
   7745         \noexpand\scanmacro{\temp}}%
   7746     \or % 1
   7747       \expandafter\xdef\csname\the\macname\endcsname{%
   7748          \bgroup\noexpand\macroargctxt
   7749          \noexpand\braceorline
   7750          \expandafter\noexpand\csname\the\macname xxx\endcsname}%
   7751       \expandafter\xdef\csname\the\macname xxx\endcsname##1{%
   7752          \egroup\noexpand\scanmacro{\temp}}%
   7753     \else
   7754       \ifnum\paramno<10\relax % at most 9
   7755         \expandafter\xdef\csname\the\macname\endcsname{%
   7756            \bgroup\noexpand\macroargctxt
   7757            \noexpand\csname\the\macname xx\endcsname}%
   7758         \expandafter\xdef\csname\the\macname xx\endcsname##1{%
   7759             \expandafter\noexpand\csname\the\macname xxx\endcsname ##1,}%
   7760         \expandafter\expandafter
   7761         \expandafter\xdef
   7762         \expandafter\expandafter
   7763           \csname\the\macname xxx\endcsname
   7764             \paramlist{\egroup\noexpand\scanmacro{\temp}}%
   7765       \else % 10 or more
   7766         \expandafter\xdef\csname\the\macname\endcsname{%
   7767           \noexpand\getargvals@{\the\macname}{\argl}%
   7768         }%
   7769         \global\expandafter\let\csname mac.\the\macname .body\endcsname\temp
   7770         \global\expandafter\let\csname mac.\the\macname .recurse\endcsname\gobble
   7771       \fi
   7772     \fi
   7773   \else
   7774     \ifcase\paramno
   7775     % 0
   7776       \expandafter\xdef\csname\the\macname\endcsname{%
   7777         \noexpand\norecurse{\the\macname}%
   7778         \noexpand\scanmacro{\temp}\egroup}%
   7779     \or % 1
   7780       \expandafter\xdef\csname\the\macname\endcsname{%
   7781          \bgroup\noexpand\macroargctxt
   7782          \noexpand\braceorline
   7783          \expandafter\noexpand\csname\the\macname xxx\endcsname}%
   7784       \expandafter\xdef\csname\the\macname xxx\endcsname##1{%
   7785         \egroup
   7786         \noexpand\norecurse{\the\macname}%
   7787         \noexpand\scanmacro{\temp}\egroup}%
   7788     \else % at most 9
   7789       \ifnum\paramno<10\relax
   7790         \expandafter\xdef\csname\the\macname\endcsname{%
   7791            \bgroup\noexpand\macroargctxt
   7792            \expandafter\noexpand\csname\the\macname xx\endcsname}%
   7793         \expandafter\xdef\csname\the\macname xx\endcsname##1{%
   7794             \expandafter\noexpand\csname\the\macname xxx\endcsname ##1,}%
   7795         \expandafter\expandafter
   7796         \expandafter\xdef
   7797         \expandafter\expandafter
   7798         \csname\the\macname xxx\endcsname
   7799         \paramlist{%
   7800             \egroup
   7801             \noexpand\norecurse{\the\macname}%
   7802             \noexpand\scanmacro{\temp}\egroup}%
   7803       \else % 10 or more:
   7804         \expandafter\xdef\csname\the\macname\endcsname{%
   7805           \noexpand\getargvals@{\the\macname}{\argl}%
   7806         }%
   7807         \global\expandafter\let\csname mac.\the\macname .body\endcsname\temp
   7808         \global\expandafter\let\csname mac.\the\macname .recurse\endcsname\norecurse
   7809       \fi
   7810     \fi
   7811   \fi}
   7812 
   7813 \catcode `\@\texiatcatcode\relax
   7814 
   7815 \def\norecurse#1{\bgroup\cslet{#1}{macsave.#1}}
   7816 
   7817 % \braceorline decides whether the next nonwhitespace character is a
   7818 % {.  If so it reads up to the closing }, if not, it reads the whole
   7819 % line.  Whatever was read is then fed to the next control sequence
   7820 % as an argument (by \parsebrace or \parsearg).
   7821 %
   7822 \def\braceorline#1{\let\macnamexxx=#1\futurelet\nchar\braceorlinexxx}
   7823 \def\braceorlinexxx{%
   7824   \ifx\nchar\bgroup\else
   7825     \expandafter\parsearg
   7826   \fi \macnamexxx}
   7827 
   7828 
   7829 % @alias.
   7830 % We need some trickery to remove the optional spaces around the equal
   7831 % sign.  Make them active and then expand them all to nothing.
   7832 %
   7833 \def\alias{\parseargusing\obeyspaces\aliasxxx}
   7834 \def\aliasxxx #1{\aliasyyy#1\relax}
   7835 \def\aliasyyy #1=#2\relax{%
   7836   {%
   7837     \expandafter\let\obeyedspace=\empty
   7838     \addtomacrolist{#1}%
   7839     \xdef\next{\global\let\makecsname{#1}=\makecsname{#2}}%
   7840   }%
   7841   \next
   7842 }
   7843 
   7844 
   7845 \message{cross references,}
   7846 
   7847 \newwrite\auxfile
   7848 \newif\ifhavexrefs    % True if xref values are known.
   7849 \newif\ifwarnedxrefs  % True if we warned once that they aren't known.
   7850 
   7851 % @inforef is relatively simple.
   7852 \def\inforef #1{\inforefzzz #1,,,,**}
   7853 \def\inforefzzz #1,#2,#3,#4**{%
   7854   \putwordSee{} \putwordInfo{} \putwordfile{} \file{\ignorespaces #3{}},
   7855   node \samp{\ignorespaces#1{}}}
   7856 
   7857 % @node's only job in TeX is to define \lastnode, which is used in
   7858 % cross-references.  The @node line might or might not have commas, and
   7859 % might or might not have spaces before the first comma, like:
   7860 % @node foo , bar , ...
   7861 % We don't want such trailing spaces in the node name.
   7862 %
   7863 \parseargdef\node{\checkenv{}\donode #1 ,\finishnodeparse}
   7864 %
   7865 % also remove a trailing comma, in case of something like this:
   7866 % @node Help-Cross,  ,  , Cross-refs
   7867 \def\donode#1 ,#2\finishnodeparse{\dodonode #1,\finishnodeparse}
   7868 \def\dodonode#1,#2\finishnodeparse{\gdef\lastnode{#1}}
   7869 
   7870 \let\nwnode=\node
   7871 \let\lastnode=\empty
   7872 
   7873 % Write a cross-reference definition for the current node.  #1 is the
   7874 % type (Ynumbered, Yappendix, Ynothing).
   7875 %
   7876 \def\donoderef#1{%
   7877   \ifx\lastnode\empty\else
   7878     \setref{\lastnode}{#1}%
   7879     \global\let\lastnode=\empty
   7880   \fi
   7881 }
   7882 
   7883 % @anchor{NAME} -- define xref target at arbitrary point.
   7884 %
   7885 \newcount\savesfregister
   7886 %
   7887 \def\savesf{\relax \ifhmode \savesfregister=\spacefactor \fi}
   7888 \def\restoresf{\relax \ifhmode \spacefactor=\savesfregister \fi}
   7889 \def\anchor#1{\savesf \setref{#1}{Ynothing}\restoresf \ignorespaces}
   7890 
   7891 % \setref{NAME}{SNT} defines a cross-reference point NAME (a node or an
   7892 % anchor), which consists of three parts:
   7893 % 1) NAME-title - the current sectioning name taken from \lastsection,
   7894 %                 or the anchor name.
   7895 % 2) NAME-snt   - section number and type, passed as the SNT arg, or
   7896 %                 empty for anchors.
   7897 % 3) NAME-pg    - the page number.
   7898 %
   7899 % This is called from \donoderef, \anchor, and \dofloat.  In the case of
   7900 % floats, there is an additional part, which is not written here:
   7901 % 4) NAME-lof   - the text as it should appear in a @listoffloats.
   7902 %
   7903 \def\setref#1#2{%
   7904   \pdfmkdest{#1}%
   7905   \iflinks
   7906     {%
   7907       \atdummies  % preserve commands, but don't expand them
   7908       \edef\writexrdef##1##2{%
   7909 	\write\auxfile{@xrdef{#1-% #1 of \setref, expanded by the \edef
   7910 	  ##1}{##2}}% these are parameters of \writexrdef
   7911       }%
   7912       \toks0 = \expandafter{\lastsection}%
   7913       \immediate \writexrdef{title}{\the\toks0 }%
   7914       \immediate \writexrdef{snt}{\csname #2\endcsname}% \Ynumbered etc.
   7915       \safewhatsit{\writexrdef{pg}{\folio}}% will be written later, at \shipout
   7916     }%
   7917   \fi
   7918 }
   7919 
   7920 % @xrefautosectiontitle on|off says whether @section(ing) names are used
   7921 % automatically in xrefs, if the third arg is not explicitly specified.
   7922 % This was provided as a "secret" @set xref-automatic-section-title
   7923 % variable, now it's official.
   7924 %
   7925 \parseargdef\xrefautomaticsectiontitle{%
   7926   \def\temp{#1}%
   7927   \ifx\temp\onword
   7928     \expandafter\let\csname SETxref-automatic-section-title\endcsname
   7929       = \empty
   7930   \else\ifx\temp\offword
   7931     \expandafter\let\csname SETxref-automatic-section-title\endcsname
   7932       = \relax
   7933   \else
   7934     \errhelp = \EMsimple
   7935     \errmessage{Unknown @xrefautomaticsectiontitle value `\temp',
   7936                 must be on|off}%
   7937   \fi\fi
   7938 }
   7939 
   7940 % 
   7941 % @xref, @pxref, and @ref generate cross-references.  For \xrefX, #1 is
   7942 % the node name, #2 the name of the Info cross-reference, #3 the printed
   7943 % node name, #4 the name of the Info file, #5 the name of the printed
   7944 % manual.  All but the node name can be omitted.
   7945 %
   7946 \def\pxref#1{\putwordsee{} \xrefX[#1,,,,,,,]}
   7947 \def\xref#1{\putwordSee{} \xrefX[#1,,,,,,,]}
   7948 \def\ref#1{\xrefX[#1,,,,,,,]}
   7949 %
   7950 \newbox\toprefbox
   7951 \newbox\printedrefnamebox
   7952 \newbox\infofilenamebox
   7953 \newbox\printedmanualbox
   7954 %
   7955 \def\xrefX[#1,#2,#3,#4,#5,#6]{\begingroup
   7956   \unsepspaces
   7957   %
   7958   % Get args without leading/trailing spaces.
   7959   \def\printedrefname{\ignorespaces #3}%
   7960   \setbox\printedrefnamebox = \hbox{\printedrefname\unskip}%
   7961   %
   7962   \def\infofilename{\ignorespaces #4}%
   7963   \setbox\infofilenamebox = \hbox{\infofilename\unskip}%
   7964   %
   7965   \def\printedmanual{\ignorespaces #5}%
   7966   \setbox\printedmanualbox  = \hbox{\printedmanual\unskip}%
   7967   %
   7968   % If the printed reference name (arg #3) was not explicitly given in
   7969   % the @xref, figure out what we want to use.
   7970   \ifdim \wd\printedrefnamebox = 0pt
   7971     % No printed node name was explicitly given.
   7972     \expandafter\ifx\csname SETxref-automatic-section-title\endcsname \relax
   7973       % Not auto section-title: use node name inside the square brackets.
   7974       \def\printedrefname{\ignorespaces #1}%
   7975     \else
   7976       % Auto section-title: use chapter/section title inside
   7977       % the square brackets if we have it.
   7978       \ifdim \wd\printedmanualbox > 0pt
   7979         % It is in another manual, so we don't have it; use node name.
   7980         \def\printedrefname{\ignorespaces #1}%
   7981       \else
   7982         \ifhavexrefs
   7983           % We (should) know the real title if we have the xref values.
   7984           \def\printedrefname{\refx{#1-title}{}}%
   7985         \else
   7986           % Otherwise just copy the Info node name.
   7987           \def\printedrefname{\ignorespaces #1}%
   7988         \fi%
   7989       \fi
   7990     \fi
   7991   \fi
   7992   %
   7993   % Make link in pdf output.
   7994   \ifpdf
   7995     {\indexnofonts
   7996      \turnoffactive
   7997      \makevalueexpandable
   7998      % This expands tokens, so do it after making catcode changes, so _
   7999      % etc. don't get their TeX definitions.  This ignores all spaces in
   8000      % #4, including (wrongly) those in the middle of the filename.
   8001      \getfilename{#4}%
   8002      %
   8003      % This (wrongly) does not take account of leading or trailing
   8004      % spaces in #1, which should be ignored.
   8005      \edef\pdfxrefdest{#1}%
   8006      \ifx\pdfxrefdest\empty
   8007        \def\pdfxrefdest{Top}% no empty targets
   8008      \else
   8009        \txiescapepdf\pdfxrefdest  % escape PDF special chars
   8010      \fi
   8011      %
   8012      \leavevmode
   8013      \startlink attr{/Border [0 0 0]}%
   8014      \ifnum\filenamelength>0
   8015        goto file{\the\filename.pdf} name{\pdfxrefdest}%
   8016      \else
   8017        goto name{\pdfmkpgn{\pdfxrefdest}}%
   8018      \fi
   8019     }%
   8020     \setcolor{\linkcolor}%
   8021   \fi
   8022   %
   8023   % Float references are printed completely differently: "Figure 1.2"
   8024   % instead of "[somenode], p.3".  We distinguish them by the
   8025   % LABEL-title being set to a magic string.
   8026   {%
   8027     % Have to otherify everything special to allow the \csname to
   8028     % include an _ in the xref name, etc.
   8029     \indexnofonts
   8030     \turnoffactive
   8031     \expandafter\global\expandafter\let\expandafter\Xthisreftitle
   8032       \csname XR#1-title\endcsname
   8033   }%
   8034   \iffloat\Xthisreftitle
   8035     % If the user specified the print name (third arg) to the ref,
   8036     % print it instead of our usual "Figure 1.2".
   8037     \ifdim\wd\printedrefnamebox = 0pt
   8038       \refx{#1-snt}{}%
   8039     \else
   8040       \printedrefname
   8041     \fi
   8042     %
   8043     % If the user also gave the printed manual name (fifth arg), append
   8044     % "in MANUALNAME".
   8045     \ifdim \wd\printedmanualbox > 0pt
   8046       \space \putwordin{} \cite{\printedmanual}%
   8047     \fi
   8048   \else
   8049     % node/anchor (non-float) references.
   8050     %
   8051     % If we use \unhbox to print the node names, TeX does not insert
   8052     % empty discretionaries after hyphens, which means that it will not
   8053     % find a line break at a hyphen in a node names.  Since some manuals
   8054     % are best written with fairly long node names, containing hyphens,
   8055     % this is a loss.  Therefore, we give the text of the node name
   8056     % again, so it is as if TeX is seeing it for the first time.
   8057     %
   8058     \ifdim \wd\printedmanualbox > 0pt
   8059       % Cross-manual reference with a printed manual name.
   8060       %
   8061       \crossmanualxref{\cite{\printedmanual\unskip}}%
   8062     %
   8063     \else\ifdim \wd\infofilenamebox > 0pt
   8064       % Cross-manual reference with only an info filename (arg 4), no
   8065       % printed manual name (arg 5).  This is essentially the same as
   8066       % the case above; we output the filename, since we have nothing else.
   8067       %
   8068       \crossmanualxref{\code{\infofilename\unskip}}%
   8069     %
   8070     \else
   8071       % Reference within this manual.
   8072       %
   8073       % _ (for example) has to be the character _ for the purposes of the
   8074       % control sequence corresponding to the node, but it has to expand
   8075       % into the usual \leavevmode...\vrule stuff for purposes of
   8076       % printing. So we \turnoffactive for the \refx-snt, back on for the
   8077       % printing, back off for the \refx-pg.
   8078       {\turnoffactive
   8079        % Only output a following space if the -snt ref is nonempty; for
   8080        % @unnumbered and @anchor, it won't be.
   8081        \setbox2 = \hbox{\ignorespaces \refx{#1-snt}{}}%
   8082        \ifdim \wd2 > 0pt \refx{#1-snt}\space\fi
   8083       }%
   8084       % output the `[mynode]' via the macro below so it can be overridden.
   8085       \xrefprintnodename\printedrefname
   8086       %
   8087       % But we always want a comma and a space:
   8088       ,\space
   8089       %
   8090       % output the `page 3'.
   8091       \turnoffactive \putwordpage\tie\refx{#1-pg}{}%
   8092     \fi\fi
   8093   \fi
   8094   \endlink
   8095 \endgroup}
   8096 
   8097 % Output a cross-manual xref to #1.  Used just above (twice).
   8098 %
   8099 % Only include the text "Section ``foo'' in" if the foo is neither
   8100 % missing or Top.  Thus, @xref{,,,foo,The Foo Manual} outputs simply
   8101 % "see The Foo Manual", the idea being to refer to the whole manual.
   8102 %
   8103 % But, this being TeX, we can't easily compare our node name against the
   8104 % string "Top" while ignoring the possible spaces before and after in
   8105 % the input.  By adding the arbitrary 7sp below, we make it much less
   8106 % likely that a real node name would have the same width as "Top" (e.g.,
   8107 % in a monospaced font).  Hopefully it will never happen in practice.
   8108 %
   8109 % For the same basic reason, we retypeset the "Top" at every
   8110 % reference, since the current font is indeterminate.
   8111 %
   8112 \def\crossmanualxref#1{%
   8113   \setbox\toprefbox = \hbox{Top\kern7sp}%
   8114   \setbox2 = \hbox{\ignorespaces \printedrefname \unskip \kern7sp}%
   8115   \ifdim \wd2 > 7sp  % nonempty?
   8116     \ifdim \wd2 = \wd\toprefbox \else  % same as Top?
   8117       \putwordSection{} ``\printedrefname'' \putwordin{}\space
   8118     \fi
   8119   \fi
   8120   #1%
   8121 }
   8122 
   8123 % This macro is called from \xrefX for the `[nodename]' part of xref
   8124 % output.  It's a separate macro only so it can be changed more easily,
   8125 % since square brackets don't work well in some documents.  Particularly
   8126 % one that Bob is working on :).
   8127 %
   8128 \def\xrefprintnodename#1{[#1]}
   8129 
   8130 % Things referred to by \setref.
   8131 %
   8132 \def\Ynothing{}
   8133 \def\Yomitfromtoc{}
   8134 \def\Ynumbered{%
   8135   \ifnum\secno=0
   8136     \putwordChapter@tie \the\chapno
   8137   \else \ifnum\subsecno=0
   8138     \putwordSection@tie \the\chapno.\the\secno
   8139   \else \ifnum\subsubsecno=0
   8140     \putwordSection@tie \the\chapno.\the\secno.\the\subsecno
   8141   \else
   8142     \putwordSection@tie \the\chapno.\the\secno.\the\subsecno.\the\subsubsecno
   8143   \fi\fi\fi
   8144 }
   8145 \def\Yappendix{%
   8146   \ifnum\secno=0
   8147      \putwordAppendix@tie @char\the\appendixno{}%
   8148   \else \ifnum\subsecno=0
   8149      \putwordSection@tie @char\the\appendixno.\the\secno
   8150   \else \ifnum\subsubsecno=0
   8151     \putwordSection@tie @char\the\appendixno.\the\secno.\the\subsecno
   8152   \else
   8153     \putwordSection@tie
   8154       @char\the\appendixno.\the\secno.\the\subsecno.\the\subsubsecno
   8155   \fi\fi\fi
   8156 }
   8157 
   8158 % Define \refx{NAME}{SUFFIX} to reference a cross-reference string named NAME.
   8159 % If its value is nonempty, SUFFIX is output afterward.
   8160 %
   8161 \def\refx#1#2{%
   8162   {%
   8163     \indexnofonts
   8164     \otherbackslash
   8165     \expandafter\global\expandafter\let\expandafter\thisrefX
   8166       \csname XR#1\endcsname
   8167   }%
   8168   \ifx\thisrefX\relax
   8169     % If not defined, say something at least.
   8170     \angleleft un\-de\-fined\angleright
   8171     \iflinks
   8172       \ifhavexrefs
   8173         {\toks0 = {#1}% avoid expansion of possibly-complex value
   8174          \message{\linenumber Undefined cross reference `\the\toks0'.}}%
   8175       \else
   8176         \ifwarnedxrefs\else
   8177           \global\warnedxrefstrue
   8178           \message{Cross reference values unknown; you must run TeX again.}%
   8179         \fi
   8180       \fi
   8181     \fi
   8182   \else
   8183     % It's defined, so just use it.
   8184     \thisrefX
   8185   \fi
   8186   #2% Output the suffix in any case.
   8187 }
   8188 
   8189 % This is the macro invoked by entries in the aux file.  Usually it's
   8190 % just a \def (we prepend XR to the control sequence name to avoid
   8191 % collisions).  But if this is a float type, we have more work to do.
   8192 %
   8193 \def\xrdef#1#2{%
   8194   {% The node name might contain 8-bit characters, which in our current
   8195    % implementation are changed to commands like @'e.  Don't let these
   8196    % mess up the control sequence name.
   8197     \indexnofonts
   8198     \turnoffactive
   8199     \xdef\safexrefname{#1}%
   8200   }%
   8201   %
   8202   \expandafter\gdef\csname XR\safexrefname\endcsname{#2}% remember this xref
   8203   %
   8204   % Was that xref control sequence that we just defined for a float?
   8205   \expandafter\iffloat\csname XR\safexrefname\endcsname
   8206     % it was a float, and we have the (safe) float type in \iffloattype.
   8207     \expandafter\let\expandafter\floatlist
   8208       \csname floatlist\iffloattype\endcsname
   8209     %
   8210     % Is this the first time we've seen this float type?
   8211     \expandafter\ifx\floatlist\relax
   8212       \toks0 = {\do}% yes, so just \do
   8213     \else
   8214       % had it before, so preserve previous elements in list.
   8215       \toks0 = \expandafter{\floatlist\do}%
   8216     \fi
   8217     %
   8218     % Remember this xref in the control sequence \floatlistFLOATTYPE,
   8219     % for later use in \listoffloats.
   8220     \expandafter\xdef\csname floatlist\iffloattype\endcsname{\the\toks0
   8221       {\safexrefname}}%
   8222   \fi
   8223 }
   8224 
   8225 % Read the last existing aux file, if any.  No error if none exists.
   8226 %
   8227 \def\tryauxfile{%
   8228   \openin 1 \jobname.aux
   8229   \ifeof 1 \else
   8230     \readdatafile{aux}%
   8231     \global\havexrefstrue
   8232   \fi
   8233   \closein 1
   8234 }
   8235 
   8236 \def\setupdatafile{%
   8237   \catcode`\^^@=\other
   8238   \catcode`\^^A=\other
   8239   \catcode`\^^B=\other
   8240   \catcode`\^^C=\other
   8241   \catcode`\^^D=\other
   8242   \catcode`\^^E=\other
   8243   \catcode`\^^F=\other
   8244   \catcode`\^^G=\other
   8245   \catcode`\^^H=\other
   8246   \catcode`\^^K=\other
   8247   \catcode`\^^L=\other
   8248   \catcode`\^^N=\other
   8249   \catcode`\^^P=\other
   8250   \catcode`\^^Q=\other
   8251   \catcode`\^^R=\other
   8252   \catcode`\^^S=\other
   8253   \catcode`\^^T=\other
   8254   \catcode`\^^U=\other
   8255   \catcode`\^^V=\other
   8256   \catcode`\^^W=\other
   8257   \catcode`\^^X=\other
   8258   \catcode`\^^Z=\other
   8259   \catcode`\^^[=\other
   8260   \catcode`\^^\=\other
   8261   \catcode`\^^]=\other
   8262   \catcode`\^^^=\other
   8263   \catcode`\^^_=\other
   8264   % It was suggested to set the catcode of ^ to 7, which would allow ^^e4 etc.
   8265   % in xref tags, i.e., node names.  But since ^^e4 notation isn't
   8266   % supported in the main text, it doesn't seem desirable.  Furthermore,
   8267   % that is not enough: for node names that actually contain a ^
   8268   % character, we would end up writing a line like this: 'xrdef {'hat
   8269   % b-title}{'hat b} and \xrdef does a \csname...\endcsname on the first
   8270   % argument, and \hat is not an expandable control sequence.  It could
   8271   % all be worked out, but why?  Either we support ^^ or we don't.
   8272   %
   8273   % The other change necessary for this was to define \auxhat:
   8274   % \def\auxhat{\def^{'hat }}% extra space so ok if followed by letter
   8275   % and then to call \auxhat in \setq.
   8276   %
   8277   \catcode`\^=\other
   8278   %
   8279   % Special characters.  Should be turned off anyway, but...
   8280   \catcode`\~=\other
   8281   \catcode`\[=\other
   8282   \catcode`\]=\other
   8283   \catcode`\"=\other
   8284   \catcode`\_=\other
   8285   \catcode`\|=\other
   8286   \catcode`\<=\other
   8287   \catcode`\>=\other
   8288   \catcode`\$=\other
   8289   \catcode`\#=\other
   8290   \catcode`\&=\other
   8291   \catcode`\%=\other
   8292   \catcode`+=\other % avoid \+ for paranoia even though we've turned it off
   8293   %
   8294   % This is to support \ in node names and titles, since the \
   8295   % characters end up in a \csname.  It's easier than
   8296   % leaving it active and making its active definition an actual \
   8297   % character.  What I don't understand is why it works in the *value*
   8298   % of the xrdef.  Seems like it should be a catcode12 \, and that
   8299   % should not typeset properly.  But it works, so I'm moving on for
   8300   % now.  --karl, 15jan04.
   8301   \catcode`\\=\other
   8302   %
   8303   % Make the characters 128-255 be printing characters.
   8304   {%
   8305     \count1=128
   8306     \def\loop{%
   8307       \catcode\count1=\other
   8308       \advance\count1 by 1
   8309       \ifnum \count1<256 \loop \fi
   8310     }%
   8311   }%
   8312   %
   8313   % @ is our escape character in .aux files, and we need braces.
   8314   \catcode`\{=1
   8315   \catcode`\}=2
   8316   \catcode`\@=0
   8317 }
   8318 
   8319 \def\readdatafile#1{%
   8320 \begingroup
   8321   \setupdatafile
   8322   \input\jobname.#1
   8323 \endgroup}
   8324 
   8325 
   8326 \message{insertions,}
   8327 % including footnotes.
   8328 
   8329 \newcount \footnoteno
   8330 
   8331 % The trailing space in the following definition for supereject is
   8332 % vital for proper filling; pages come out unaligned when you do a
   8333 % pagealignmacro call if that space before the closing brace is
   8334 % removed. (Generally, numeric constants should always be followed by a
   8335 % space to prevent strange expansion errors.)
   8336 \def\supereject{\par\penalty -20000\footnoteno =0 }
   8337 
   8338 % @footnotestyle is meaningful for Info output only.
   8339 \let\footnotestyle=\comment
   8340 
   8341 {\catcode `\@=11
   8342 %
   8343 % Auto-number footnotes.  Otherwise like plain.
   8344 \gdef\footnote{%
   8345   \let\indent=\ptexindent
   8346   \let\noindent=\ptexnoindent
   8347   \global\advance\footnoteno by \@ne
   8348   \edef\thisfootno{$^{\the\footnoteno}$}%
   8349   %
   8350   % In case the footnote comes at the end of a sentence, preserve the
   8351   % extra spacing after we do the footnote number.
   8352   \let\@sf\empty
   8353   \ifhmode\edef\@sf{\spacefactor\the\spacefactor}\ptexslash\fi
   8354   %
   8355   % Remove inadvertent blank space before typesetting the footnote number.
   8356   \unskip
   8357   \thisfootno\@sf
   8358   \dofootnote
   8359 }%
   8360 
   8361 % Don't bother with the trickery in plain.tex to not require the
   8362 % footnote text as a parameter.  Our footnotes don't need to be so general.
   8363 %
   8364 % Oh yes, they do; otherwise, @ifset (and anything else that uses
   8365 % \parseargline) fails inside footnotes because the tokens are fixed when
   8366 % the footnote is read.  --karl, 16nov96.
   8367 %
   8368 \gdef\dofootnote{%
   8369   \insert\footins\bgroup
   8370   % We want to typeset this text as a normal paragraph, even if the
   8371   % footnote reference occurs in (for example) a display environment.
   8372   % So reset some parameters.
   8373   \hsize=\pagewidth
   8374   \interlinepenalty\interfootnotelinepenalty
   8375   \splittopskip\ht\strutbox % top baseline for broken footnotes
   8376   \splitmaxdepth\dp\strutbox
   8377   \floatingpenalty\@MM
   8378   \leftskip\z@skip
   8379   \rightskip\z@skip
   8380   \spaceskip\z@skip
   8381   \xspaceskip\z@skip
   8382   \parindent\defaultparindent
   8383   %
   8384   \smallfonts \rm
   8385   %
   8386   % Because we use hanging indentation in footnotes, a @noindent appears
   8387   % to exdent this text, so make it be a no-op.  makeinfo does not use
   8388   % hanging indentation so @noindent can still be needed within footnote
   8389   % text after an @example or the like (not that this is good style).
   8390   \let\noindent = \relax
   8391   %
   8392   % Hang the footnote text off the number.  Use \everypar in case the
   8393   % footnote extends for more than one paragraph.
   8394   \everypar = {\hang}%
   8395   \textindent{\thisfootno}%
   8396   %
   8397   % Don't crash into the line above the footnote text.  Since this
   8398   % expands into a box, it must come within the paragraph, lest it
   8399   % provide a place where TeX can split the footnote.
   8400   \footstrut
   8401   %
   8402   % Invoke rest of plain TeX footnote routine.
   8403   \futurelet\next\fo@t
   8404 }
   8405 }%end \catcode `\@=11
   8406 
   8407 % In case a @footnote appears in a vbox, save the footnote text and create
   8408 % the real \insert just after the vbox finished.  Otherwise, the insertion
   8409 % would be lost.
   8410 % Similarly, if a @footnote appears inside an alignment, save the footnote
   8411 % text to a box and make the \insert when a row of the table is finished.
   8412 % And the same can be done for other insert classes.  --kasal, 16nov03.
   8413 
   8414 % Replace the \insert primitive by a cheating macro.
   8415 % Deeper inside, just make sure that the saved insertions are not spilled
   8416 % out prematurely.
   8417 %
   8418 \def\startsavinginserts{%
   8419   \ifx \insert\ptexinsert
   8420     \let\insert\saveinsert
   8421   \else
   8422     \let\checkinserts\relax
   8423   \fi
   8424 }
   8425 
   8426 % This \insert replacement works for both \insert\footins{foo} and
   8427 % \insert\footins\bgroup foo\egroup, but it doesn't work for \insert27{foo}.
   8428 %
   8429 \def\saveinsert#1{%
   8430   \edef\next{\noexpand\savetobox \makeSAVEname#1}%
   8431   \afterassignment\next
   8432   % swallow the left brace
   8433   \let\temp =
   8434 }
   8435 \def\makeSAVEname#1{\makecsname{SAVE\expandafter\gobble\string#1}}
   8436 \def\savetobox#1{\global\setbox#1 = \vbox\bgroup \unvbox#1}
   8437 
   8438 \def\checksaveins#1{\ifvoid#1\else \placesaveins#1\fi}
   8439 
   8440 \def\placesaveins#1{%
   8441   \ptexinsert \csname\expandafter\gobblesave\string#1\endcsname
   8442     {\box#1}%
   8443 }
   8444 
   8445 % eat @SAVE -- beware, all of them have catcode \other:
   8446 {
   8447   \def\dospecials{\do S\do A\do V\do E} \uncatcodespecials  %  ;-)
   8448   \gdef\gobblesave @SAVE{}
   8449 }
   8450 
   8451 % initialization:
   8452 \def\newsaveins #1{%
   8453   \edef\next{\noexpand\newsaveinsX \makeSAVEname#1}%
   8454   \next
   8455 }
   8456 \def\newsaveinsX #1{%
   8457   \csname newbox\endcsname #1%
   8458   \expandafter\def\expandafter\checkinserts\expandafter{\checkinserts
   8459     \checksaveins #1}%
   8460 }
   8461 
   8462 % initialize:
   8463 \let\checkinserts\empty
   8464 \newsaveins\footins
   8465 \newsaveins\margin
   8466 
   8467 
   8468 % @image.  We use the macros from epsf.tex to support this.
   8469 % If epsf.tex is not installed and @image is used, we complain.
   8470 %
   8471 % Check for and read epsf.tex up front.  If we read it only at @image
   8472 % time, we might be inside a group, and then its definitions would get
   8473 % undone and the next image would fail.
   8474 \openin 1 = epsf.tex
   8475 \ifeof 1 \else
   8476   % Do not bother showing banner with epsf.tex v2.7k (available in
   8477   % doc/epsf.tex and on ctan).
   8478   \def\epsfannounce{\toks0 = }%
   8479   \input epsf.tex
   8480 \fi
   8481 \closein 1
   8482 %
   8483 % We will only complain once about lack of epsf.tex.
   8484 \newif\ifwarnednoepsf
   8485 \newhelp\noepsfhelp{epsf.tex must be installed for images to
   8486   work.  It is also included in the Texinfo distribution, or you can get
   8487   it from ftp://tug.org/tex/epsf.tex.}
   8488 %
   8489 \def\image#1{%
   8490   \ifx\epsfbox\thisisundefined
   8491     \ifwarnednoepsf \else
   8492       \errhelp = \noepsfhelp
   8493       \errmessage{epsf.tex not found, images will be ignored}%
   8494       \global\warnednoepsftrue
   8495     \fi
   8496   \else
   8497     \imagexxx #1,,,,,\finish
   8498   \fi
   8499 }
   8500 %
   8501 % Arguments to @image:
   8502 % #1 is (mandatory) image filename; we tack on .eps extension.
   8503 % #2 is (optional) width, #3 is (optional) height.
   8504 % #4 is (ignored optional) html alt text.
   8505 % #5 is (ignored optional) extension.
   8506 % #6 is just the usual extra ignored arg for parsing stuff.
   8507 \newif\ifimagevmode
   8508 \def\imagexxx#1,#2,#3,#4,#5,#6\finish{\begingroup
   8509   \catcode`\^^M = 5     % in case we're inside an example
   8510   \normalturnoffactive  % allow _ et al. in names
   8511   % If the image is by itself, center it.
   8512   \ifvmode
   8513     \imagevmodetrue
   8514   \else \ifx\centersub\centerV
   8515     % for @center @image, we need a vbox so we can have our vertical space
   8516     \imagevmodetrue
   8517     \vbox\bgroup % vbox has better behavior than vtop herev
   8518   \fi\fi
   8519   %
   8520   \ifimagevmode
   8521     \nobreak\medskip
   8522     % Usually we'll have text after the image which will insert
   8523     % \parskip glue, so insert it here too to equalize the space
   8524     % above and below.
   8525     \nobreak\vskip\parskip
   8526     \nobreak
   8527   \fi
   8528   %
   8529   % Leave vertical mode so that indentation from an enclosing
   8530   %  environment such as @quotation is respected.
   8531   % However, if we're at the top level, we don't want the
   8532   %  normal paragraph indentation.
   8533   % On the other hand, if we are in the case of @center @image, we don't
   8534   %  want to start a paragraph, which will create a hsize-width box and
   8535   %  eradicate the centering.
   8536   \ifx\centersub\centerV\else \noindent \fi
   8537   %
   8538   % Output the image.
   8539   \ifpdf
   8540     \dopdfimage{#1}{#2}{#3}%
   8541   \else
   8542     % \epsfbox itself resets \epsf?size at each figure.
   8543     \setbox0 = \hbox{\ignorespaces #2}\ifdim\wd0 > 0pt \epsfxsize=#2\relax \fi
   8544     \setbox0 = \hbox{\ignorespaces #3}\ifdim\wd0 > 0pt \epsfysize=#3\relax \fi
   8545     \epsfbox{#1.eps}%
   8546   \fi
   8547   %
   8548   \ifimagevmode
   8549     \medskip  % space after a standalone image
   8550   \fi
   8551   \ifx\centersub\centerV \egroup \fi
   8552 \endgroup}
   8553 
   8554 
   8555 % @float FLOATTYPE,LABEL,LOC ... @end float for displayed figures, tables,
   8556 % etc.  We don't actually implement floating yet, we always include the
   8557 % float "here".  But it seemed the best name for the future.
   8558 %
   8559 \envparseargdef\float{\eatcommaspace\eatcommaspace\dofloat#1, , ,\finish}
   8560 
   8561 % There may be a space before second and/or third parameter; delete it.
   8562 \def\eatcommaspace#1, {#1,}
   8563 
   8564 % #1 is the optional FLOATTYPE, the text label for this float, typically
   8565 % "Figure", "Table", "Example", etc.  Can't contain commas.  If omitted,
   8566 % this float will not be numbered and cannot be referred to.
   8567 %
   8568 % #2 is the optional xref label.  Also must be present for the float to
   8569 % be referable.
   8570 %
   8571 % #3 is the optional positioning argument; for now, it is ignored.  It
   8572 % will somehow specify the positions allowed to float to (here, top, bottom).
   8573 %
   8574 % We keep a separate counter for each FLOATTYPE, which we reset at each
   8575 % chapter-level command.
   8576 \let\resetallfloatnos=\empty
   8577 %
   8578 \def\dofloat#1,#2,#3,#4\finish{%
   8579   \let\thiscaption=\empty
   8580   \let\thisshortcaption=\empty
   8581   %
   8582   % don't lose footnotes inside @float.
   8583   %
   8584   % BEWARE: when the floats start float, we have to issue warning whenever an
   8585   % insert appears inside a float which could possibly float. --kasal, 26may04
   8586   %
   8587   \startsavinginserts
   8588   %
   8589   % We can't be used inside a paragraph.
   8590   \par
   8591   %
   8592   \vtop\bgroup
   8593     \def\floattype{#1}%
   8594     \def\floatlabel{#2}%
   8595     \def\floatloc{#3}% we do nothing with this yet.
   8596     %
   8597     \ifx\floattype\empty
   8598       \let\safefloattype=\empty
   8599     \else
   8600       {%
   8601         % the floattype might have accents or other special characters,
   8602         % but we need to use it in a control sequence name.
   8603         \indexnofonts
   8604         \turnoffactive
   8605         \xdef\safefloattype{\floattype}%
   8606       }%
   8607     \fi
   8608     %
   8609     % If label is given but no type, we handle that as the empty type.
   8610     \ifx\floatlabel\empty \else
   8611       % We want each FLOATTYPE to be numbered separately (Figure 1,
   8612       % Table 1, Figure 2, ...).  (And if no label, no number.)
   8613       %
   8614       \expandafter\getfloatno\csname\safefloattype floatno\endcsname
   8615       \global\advance\floatno by 1
   8616       %
   8617       {%
   8618         % This magic value for \lastsection is output by \setref as the
   8619         % XREFLABEL-title value.  \xrefX uses it to distinguish float
   8620         % labels (which have a completely different output format) from
   8621         % node and anchor labels.  And \xrdef uses it to construct the
   8622         % lists of floats.
   8623         %
   8624         \edef\lastsection{\floatmagic=\safefloattype}%
   8625         \setref{\floatlabel}{Yfloat}%
   8626       }%
   8627     \fi
   8628     %
   8629     % start with \parskip glue, I guess.
   8630     \vskip\parskip
   8631     %
   8632     % Don't suppress indentation if a float happens to start a section.
   8633     \restorefirstparagraphindent
   8634 }
   8635 
   8636 % we have these possibilities:
   8637 % @float Foo,lbl & @caption{Cap}: Foo 1.1: Cap
   8638 % @float Foo,lbl & no caption:    Foo 1.1
   8639 % @float Foo & @caption{Cap}:     Foo: Cap
   8640 % @float Foo & no caption:        Foo
   8641 % @float ,lbl & Caption{Cap}:     1.1: Cap
   8642 % @float ,lbl & no caption:       1.1
   8643 % @float & @caption{Cap}:         Cap
   8644 % @float & no caption:
   8645 %
   8646 \def\Efloat{%
   8647     \let\floatident = \empty
   8648     %
   8649     % In all cases, if we have a float type, it comes first.
   8650     \ifx\floattype\empty \else \def\floatident{\floattype}\fi
   8651     %
   8652     % If we have an xref label, the number comes next.
   8653     \ifx\floatlabel\empty \else
   8654       \ifx\floattype\empty \else % if also had float type, need tie first.
   8655         \appendtomacro\floatident{\tie}%
   8656       \fi
   8657       % the number.
   8658       \appendtomacro\floatident{\chaplevelprefix\the\floatno}%
   8659     \fi
   8660     %
   8661     % Start the printed caption with what we've constructed in
   8662     % \floatident, but keep it separate; we need \floatident again.
   8663     \let\captionline = \floatident
   8664     %
   8665     \ifx\thiscaption\empty \else
   8666       \ifx\floatident\empty \else
   8667 	\appendtomacro\captionline{: }% had ident, so need a colon between
   8668       \fi
   8669       %
   8670       % caption text.
   8671       \appendtomacro\captionline{\scanexp\thiscaption}%
   8672     \fi
   8673     %
   8674     % If we have anything to print, print it, with space before.
   8675     % Eventually this needs to become an \insert.
   8676     \ifx\captionline\empty \else
   8677       \vskip.5\parskip
   8678       \captionline
   8679       %
   8680       % Space below caption.
   8681       \vskip\parskip
   8682     \fi
   8683     %
   8684     % If have an xref label, write the list of floats info.  Do this
   8685     % after the caption, to avoid chance of it being a breakpoint.
   8686     \ifx\floatlabel\empty \else
   8687       % Write the text that goes in the lof to the aux file as
   8688       % \floatlabel-lof.  Besides \floatident, we include the short
   8689       % caption if specified, else the full caption if specified, else nothing.
   8690       {%
   8691         \atdummies
   8692         %
   8693         % since we read the caption text in the macro world, where ^^M
   8694         % is turned into a normal character, we have to scan it back, so
   8695         % we don't write the literal three characters "^^M" into the aux file.
   8696 	\scanexp{%
   8697 	  \xdef\noexpand\gtemp{%
   8698 	    \ifx\thisshortcaption\empty
   8699 	      \thiscaption
   8700 	    \else
   8701 	      \thisshortcaption
   8702 	    \fi
   8703 	  }%
   8704 	}%
   8705         \immediate\write\auxfile{@xrdef{\floatlabel-lof}{\floatident
   8706 	  \ifx\gtemp\empty \else : \gtemp \fi}}%
   8707       }%
   8708     \fi
   8709   \egroup  % end of \vtop
   8710   %
   8711   % place the captured inserts
   8712   %
   8713   % BEWARE: when the floats start floating, we have to issue warning
   8714   % whenever an insert appears inside a float which could possibly
   8715   % float. --kasal, 26may04
   8716   %
   8717   \checkinserts
   8718 }
   8719 
   8720 % Append the tokens #2 to the definition of macro #1, not expanding either.
   8721 %
   8722 \def\appendtomacro#1#2{%
   8723   \expandafter\def\expandafter#1\expandafter{#1#2}%
   8724 }
   8725 
   8726 % @caption, @shortcaption
   8727 %
   8728 \def\caption{\docaption\thiscaption}
   8729 \def\shortcaption{\docaption\thisshortcaption}
   8730 \def\docaption{\checkenv\float \bgroup\scanargctxt\defcaption}
   8731 \def\defcaption#1#2{\egroup \def#1{#2}}
   8732 
   8733 % The parameter is the control sequence identifying the counter we are
   8734 % going to use.  Create it if it doesn't exist and assign it to \floatno.
   8735 \def\getfloatno#1{%
   8736   \ifx#1\relax
   8737       % Haven't seen this figure type before.
   8738       \csname newcount\endcsname #1%
   8739       %
   8740       % Remember to reset this floatno at the next chap.
   8741       \expandafter\gdef\expandafter\resetallfloatnos
   8742         \expandafter{\resetallfloatnos #1=0 }%
   8743   \fi
   8744   \let\floatno#1%
   8745 }
   8746 
   8747 % \setref calls this to get the XREFLABEL-snt value.  We want an @xref
   8748 % to the FLOATLABEL to expand to "Figure 3.1".  We call \setref when we
   8749 % first read the @float command.
   8750 %
   8751 \def\Yfloat{\floattype@tie \chaplevelprefix\the\floatno}%
   8752 
   8753 % Magic string used for the XREFLABEL-title value, so \xrefX can
   8754 % distinguish floats from other xref types.
   8755 \def\floatmagic{!!float!!}
   8756 
   8757 % #1 is the control sequence we are passed; we expand into a conditional
   8758 % which is true if #1 represents a float ref.  That is, the magic
   8759 % \lastsection value which we \setref above.
   8760 %
   8761 \def\iffloat#1{\expandafter\doiffloat#1==\finish}
   8762 %
   8763 % #1 is (maybe) the \floatmagic string.  If so, #2 will be the
   8764 % (safe) float type for this float.  We set \iffloattype to #2.
   8765 %
   8766 \def\doiffloat#1=#2=#3\finish{%
   8767   \def\temp{#1}%
   8768   \def\iffloattype{#2}%
   8769   \ifx\temp\floatmagic
   8770 }
   8771 
   8772 % @listoffloats FLOATTYPE - print a list of floats like a table of contents.
   8773 %
   8774 \parseargdef\listoffloats{%
   8775   \def\floattype{#1}% floattype
   8776   {%
   8777     % the floattype might have accents or other special characters,
   8778     % but we need to use it in a control sequence name.
   8779     \indexnofonts
   8780     \turnoffactive
   8781     \xdef\safefloattype{\floattype}%
   8782   }%
   8783   %
   8784   % \xrdef saves the floats as a \do-list in \floatlistSAFEFLOATTYPE.
   8785   \expandafter\ifx\csname floatlist\safefloattype\endcsname \relax
   8786     \ifhavexrefs
   8787       % if the user said @listoffloats foo but never @float foo.
   8788       \message{\linenumber No `\safefloattype' floats to list.}%
   8789     \fi
   8790   \else
   8791     \begingroup
   8792       \leftskip=\tocindent  % indent these entries like a toc
   8793       \let\do=\listoffloatsdo
   8794       \csname floatlist\safefloattype\endcsname
   8795     \endgroup
   8796   \fi
   8797 }
   8798 
   8799 % This is called on each entry in a list of floats.  We're passed the
   8800 % xref label, in the form LABEL-title, which is how we save it in the
   8801 % aux file.  We strip off the -title and look up \XRLABEL-lof, which
   8802 % has the text we're supposed to typeset here.
   8803 %
   8804 % Figures without xref labels will not be included in the list (since
   8805 % they won't appear in the aux file).
   8806 %
   8807 \def\listoffloatsdo#1{\listoffloatsdoentry#1\finish}
   8808 \def\listoffloatsdoentry#1-title\finish{{%
   8809   % Can't fully expand XR#1-lof because it can contain anything.  Just
   8810   % pass the control sequence.  On the other hand, XR#1-pg is just the
   8811   % page number, and we want to fully expand that so we can get a link
   8812   % in pdf output.
   8813   \toksA = \expandafter{\csname XR#1-lof\endcsname}%
   8814   %
   8815   % use the same \entry macro we use to generate the TOC and index.
   8816   \edef\writeentry{\noexpand\entry{\the\toksA}{\csname XR#1-pg\endcsname}}%
   8817   \writeentry
   8818 }}
   8819 
   8820 
   8821 \message{localization,}
   8822 
   8823 % For single-language documents, @documentlanguage is usually given very
   8824 % early, just after @documentencoding.  Single argument is the language
   8825 % (de) or locale (de_DE) abbreviation.
   8826 %
   8827 {
   8828   \catcode`\_ = \active
   8829   \globaldefs=1
   8830 \parseargdef\documentlanguage{\begingroup
   8831   \let_=\normalunderscore  % normal _ character for filenames
   8832   \tex % read txi-??.tex file in plain TeX.
   8833     % Read the file by the name they passed if it exists.
   8834     \openin 1 txi-#1.tex
   8835     \ifeof 1
   8836       \documentlanguagetrywithoutunderscore{#1_\finish}%
   8837     \else
   8838       \globaldefs = 1  % everything in the txi-LL files needs to persist
   8839       \input txi-#1.tex
   8840     \fi
   8841     \closein 1
   8842   \endgroup % end raw TeX
   8843 \endgroup}
   8844 %
   8845 % If they passed de_DE, and txi-de_DE.tex doesn't exist,
   8846 % try txi-de.tex.
   8847 %
   8848 \gdef\documentlanguagetrywithoutunderscore#1_#2\finish{%
   8849   \openin 1 txi-#1.tex
   8850   \ifeof 1
   8851     \errhelp = \nolanghelp
   8852     \errmessage{Cannot read language file txi-#1.tex}%
   8853   \else
   8854     \globaldefs = 1  % everything in the txi-LL files needs to persist
   8855     \input txi-#1.tex
   8856   \fi
   8857   \closein 1
   8858 }
   8859 }% end of special _ catcode
   8860 %
   8861 \newhelp\nolanghelp{The given language definition file cannot be found or
   8862 is empty.  Maybe you need to install it?  Putting it in the current
   8863 directory should work if nowhere else does.}
   8864 
   8865 % This macro is called from txi-??.tex files; the first argument is the
   8866 % \language name to set (without the "\lang@" prefix), the second and
   8867 % third args are \{left,right}hyphenmin.
   8868 %
   8869 % The language names to pass are determined when the format is built.
   8870 % See the etex.log file created at that time, e.g.,
   8871 % /usr/local/texlive/2008/texmf-var/web2c/pdftex/etex.log.
   8872 %
   8873 % With TeX Live 2008, etex now includes hyphenation patterns for all
   8874 % available languages.  This means we can support hyphenation in
   8875 % Texinfo, at least to some extent.  (This still doesn't solve the
   8876 % accented characters problem.)
   8877 %
   8878 \catcode`@=11
   8879 \def\txisetlanguage#1#2#3{%
   8880   % do not set the language if the name is undefined in the current TeX.
   8881   \expandafter\ifx\csname lang@#1\endcsname \relax
   8882     \message{no patterns for #1}%
   8883   \else
   8884     \global\language = \csname lang@#1\endcsname
   8885   \fi
   8886   % but there is no harm in adjusting the hyphenmin values regardless.
   8887   \global\lefthyphenmin = #2\relax
   8888   \global\righthyphenmin = #3\relax
   8889 }
   8890 
   8891 % Helpers for encodings.
   8892 % Set the catcode of characters 128 through 255 to the specified number.
   8893 %
   8894 \def\setnonasciicharscatcode#1{%
   8895    \count255=128
   8896    \loop\ifnum\count255<256
   8897       \global\catcode\count255=#1\relax
   8898       \advance\count255 by 1
   8899    \repeat
   8900 }
   8901 
   8902 \def\setnonasciicharscatcodenonglobal#1{%
   8903    \count255=128
   8904    \loop\ifnum\count255<256
   8905       \catcode\count255=#1\relax
   8906       \advance\count255 by 1
   8907    \repeat
   8908 }
   8909 
   8910 % @documentencoding sets the definition of non-ASCII characters
   8911 % according to the specified encoding.
   8912 %
   8913 \parseargdef\documentencoding{%
   8914   % Encoding being declared for the document.
   8915   \def\declaredencoding{\csname #1.enc\endcsname}%
   8916   %
   8917   % Supported encodings: names converted to tokens in order to be able
   8918   % to compare them with \ifx.
   8919   \def\ascii{\csname US-ASCII.enc\endcsname}%
   8920   \def\latnine{\csname ISO-8859-15.enc\endcsname}%
   8921   \def\latone{\csname ISO-8859-1.enc\endcsname}%
   8922   \def\lattwo{\csname ISO-8859-2.enc\endcsname}%
   8923   \def\utfeight{\csname UTF-8.enc\endcsname}%
   8924   %
   8925   \ifx \declaredencoding \ascii
   8926      \asciichardefs
   8927   %
   8928   \else \ifx \declaredencoding \lattwo
   8929      \setnonasciicharscatcode\active
   8930      \lattwochardefs
   8931   %
   8932   \else \ifx \declaredencoding \latone
   8933      \setnonasciicharscatcode\active
   8934      \latonechardefs
   8935   %
   8936   \else \ifx \declaredencoding \latnine
   8937      \setnonasciicharscatcode\active
   8938      \latninechardefs
   8939   %
   8940   \else \ifx \declaredencoding \utfeight
   8941      \setnonasciicharscatcode\active
   8942      \utfeightchardefs
   8943   %
   8944   \else
   8945     \message{Unknown document encoding #1, ignoring.}%
   8946   %
   8947   \fi % utfeight
   8948   \fi % latnine
   8949   \fi % latone
   8950   \fi % lattwo
   8951   \fi % ascii
   8952 }
   8953 
   8954 % A message to be logged when using a character that isn't available
   8955 % the default font encoding (OT1).
   8956 %
   8957 \def\missingcharmsg#1{\message{Character missing in OT1 encoding: #1.}}
   8958 
   8959 % Take account of \c (plain) vs. \, (Texinfo) difference.
   8960 \def\cedilla#1{\ifx\c\ptexc\c{#1}\else\,{#1}\fi}
   8961 
   8962 % First, make active non-ASCII characters in order for them to be
   8963 % correctly categorized when TeX reads the replacement text of
   8964 % macros containing the character definitions.
   8965 \setnonasciicharscatcode\active
   8966 %
   8967 % Latin1 (ISO-8859-1) character definitions.
   8968 \def\latonechardefs{%
   8969   \gdef^^a0{\tie}
   8970   \gdef^^a1{\exclamdown}
   8971   \gdef^^a2{\missingcharmsg{CENT SIGN}}
   8972   \gdef^^a3{{\pounds}}
   8973   \gdef^^a4{\missingcharmsg{CURRENCY SIGN}}
   8974   \gdef^^a5{\missingcharmsg{YEN SIGN}}
   8975   \gdef^^a6{\missingcharmsg{BROKEN BAR}}
   8976   \gdef^^a7{\S}
   8977   \gdef^^a8{\"{}}
   8978   \gdef^^a9{\copyright}
   8979   \gdef^^aa{\ordf}
   8980   \gdef^^ab{\guillemetleft}
   8981   \gdef^^ac{$\lnot$}
   8982   \gdef^^ad{\-}
   8983   \gdef^^ae{\registeredsymbol}
   8984   \gdef^^af{\={}}
   8985   %
   8986   \gdef^^b0{\textdegree}
   8987   \gdef^^b1{$\pm$}
   8988   \gdef^^b2{$^2$}
   8989   \gdef^^b3{$^3$}
   8990   \gdef^^b4{\'{}}
   8991   \gdef^^b5{$\mu$}
   8992   \gdef^^b6{\P}
   8993   %
   8994   \gdef^^b7{$^.$}
   8995   \gdef^^b8{\cedilla\ }
   8996   \gdef^^b9{$^1$}
   8997   \gdef^^ba{\ordm}
   8998   %
   8999   \gdef^^bb{\guillemetright}
   9000   \gdef^^bc{$1\over4$}
   9001   \gdef^^bd{$1\over2$}
   9002   \gdef^^be{$3\over4$}
   9003   \gdef^^bf{\questiondown}
   9004   %
   9005   \gdef^^c0{\`A}
   9006   \gdef^^c1{\'A}
   9007   \gdef^^c2{\^A}
   9008   \gdef^^c3{\~A}
   9009   \gdef^^c4{\"A}
   9010   \gdef^^c5{\ringaccent A}
   9011   \gdef^^c6{\AE}
   9012   \gdef^^c7{\cedilla C}
   9013   \gdef^^c8{\`E}
   9014   \gdef^^c9{\'E}
   9015   \gdef^^ca{\^E}
   9016   \gdef^^cb{\"E}
   9017   \gdef^^cc{\`I}
   9018   \gdef^^cd{\'I}
   9019   \gdef^^ce{\^I}
   9020   \gdef^^cf{\"I}
   9021   %
   9022   \gdef^^d0{\DH}
   9023   \gdef^^d1{\~N}
   9024   \gdef^^d2{\`O}
   9025   \gdef^^d3{\'O}
   9026   \gdef^^d4{\^O}
   9027   \gdef^^d5{\~O}
   9028   \gdef^^d6{\"O}
   9029   \gdef^^d7{$\times$}
   9030   \gdef^^d8{\O}
   9031   \gdef^^d9{\`U}
   9032   \gdef^^da{\'U}
   9033   \gdef^^db{\^U}
   9034   \gdef^^dc{\"U}
   9035   \gdef^^dd{\'Y}
   9036   \gdef^^de{\TH}
   9037   \gdef^^df{\ss}
   9038   %
   9039   \gdef^^e0{\`a}
   9040   \gdef^^e1{\'a}
   9041   \gdef^^e2{\^a}
   9042   \gdef^^e3{\~a}
   9043   \gdef^^e4{\"a}
   9044   \gdef^^e5{\ringaccent a}
   9045   \gdef^^e6{\ae}
   9046   \gdef^^e7{\cedilla c}
   9047   \gdef^^e8{\`e}
   9048   \gdef^^e9{\'e}
   9049   \gdef^^ea{\^e}
   9050   \gdef^^eb{\"e}
   9051   \gdef^^ec{\`{\dotless i}}
   9052   \gdef^^ed{\'{\dotless i}}
   9053   \gdef^^ee{\^{\dotless i}}
   9054   \gdef^^ef{\"{\dotless i}}
   9055   %
   9056   \gdef^^f0{\dh}
   9057   \gdef^^f1{\~n}
   9058   \gdef^^f2{\`o}
   9059   \gdef^^f3{\'o}
   9060   \gdef^^f4{\^o}
   9061   \gdef^^f5{\~o}
   9062   \gdef^^f6{\"o}
   9063   \gdef^^f7{$\div$}
   9064   \gdef^^f8{\o}
   9065   \gdef^^f9{\`u}
   9066   \gdef^^fa{\'u}
   9067   \gdef^^fb{\^u}
   9068   \gdef^^fc{\"u}
   9069   \gdef^^fd{\'y}
   9070   \gdef^^fe{\th}
   9071   \gdef^^ff{\"y}
   9072 }
   9073 
   9074 % Latin9 (ISO-8859-15) encoding character definitions.
   9075 \def\latninechardefs{%
   9076   % Encoding is almost identical to Latin1.
   9077   \latonechardefs
   9078   %
   9079   \gdef^^a4{\euro}
   9080   \gdef^^a6{\v S}
   9081   \gdef^^a8{\v s}
   9082   \gdef^^b4{\v Z}
   9083   \gdef^^b8{\v z}
   9084   \gdef^^bc{\OE}
   9085   \gdef^^bd{\oe}
   9086   \gdef^^be{\"Y}
   9087 }
   9088 
   9089 % Latin2 (ISO-8859-2) character definitions.
   9090 \def\lattwochardefs{%
   9091   \gdef^^a0{\tie}
   9092   \gdef^^a1{\ogonek{A}}
   9093   \gdef^^a2{\u{}}
   9094   \gdef^^a3{\L}
   9095   \gdef^^a4{\missingcharmsg{CURRENCY SIGN}}
   9096   \gdef^^a5{\v L}
   9097   \gdef^^a6{\'S}
   9098   \gdef^^a7{\S}
   9099   \gdef^^a8{\"{}}
   9100   \gdef^^a9{\v S}
   9101   \gdef^^aa{\cedilla S}
   9102   \gdef^^ab{\v T}
   9103   \gdef^^ac{\'Z}
   9104   \gdef^^ad{\-}
   9105   \gdef^^ae{\v Z}
   9106   \gdef^^af{\dotaccent Z}
   9107   %
   9108   \gdef^^b0{\textdegree}
   9109   \gdef^^b1{\ogonek{a}}
   9110   \gdef^^b2{\ogonek{ }}
   9111   \gdef^^b3{\l}
   9112   \gdef^^b4{\'{}}
   9113   \gdef^^b5{\v l}
   9114   \gdef^^b6{\'s}
   9115   \gdef^^b7{\v{}}
   9116   \gdef^^b8{\cedilla\ }
   9117   \gdef^^b9{\v s}
   9118   \gdef^^ba{\cedilla s}
   9119   \gdef^^bb{\v t}
   9120   \gdef^^bc{\'z}
   9121   \gdef^^bd{\H{}}
   9122   \gdef^^be{\v z}
   9123   \gdef^^bf{\dotaccent z}
   9124   %
   9125   \gdef^^c0{\'R}
   9126   \gdef^^c1{\'A}
   9127   \gdef^^c2{\^A}
   9128   \gdef^^c3{\u A}
   9129   \gdef^^c4{\"A}
   9130   \gdef^^c5{\'L}
   9131   \gdef^^c6{\'C}
   9132   \gdef^^c7{\cedilla C}
   9133   \gdef^^c8{\v C}
   9134   \gdef^^c9{\'E}
   9135   \gdef^^ca{\ogonek{E}}
   9136   \gdef^^cb{\"E}
   9137   \gdef^^cc{\v E}
   9138   \gdef^^cd{\'I}
   9139   \gdef^^ce{\^I}
   9140   \gdef^^cf{\v D}
   9141   %
   9142   \gdef^^d0{\DH}
   9143   \gdef^^d1{\'N}
   9144   \gdef^^d2{\v N}
   9145   \gdef^^d3{\'O}
   9146   \gdef^^d4{\^O}
   9147   \gdef^^d5{\H O}
   9148   \gdef^^d6{\"O}
   9149   \gdef^^d7{$\times$}
   9150   \gdef^^d8{\v R}
   9151   \gdef^^d9{\ringaccent U}
   9152   \gdef^^da{\'U}
   9153   \gdef^^db{\H U}
   9154   \gdef^^dc{\"U}
   9155   \gdef^^dd{\'Y}
   9156   \gdef^^de{\cedilla T}
   9157   \gdef^^df{\ss}
   9158   %
   9159   \gdef^^e0{\'r}
   9160   \gdef^^e1{\'a}
   9161   \gdef^^e2{\^a}
   9162   \gdef^^e3{\u a}
   9163   \gdef^^e4{\"a}
   9164   \gdef^^e5{\'l}
   9165   \gdef^^e6{\'c}
   9166   \gdef^^e7{\cedilla c}
   9167   \gdef^^e8{\v c}
   9168   \gdef^^e9{\'e}
   9169   \gdef^^ea{\ogonek{e}}
   9170   \gdef^^eb{\"e}
   9171   \gdef^^ec{\v e}
   9172   \gdef^^ed{\'{\dotless{i}}}
   9173   \gdef^^ee{\^{\dotless{i}}}
   9174   \gdef^^ef{\v d}
   9175   %
   9176   \gdef^^f0{\dh}
   9177   \gdef^^f1{\'n}
   9178   \gdef^^f2{\v n}
   9179   \gdef^^f3{\'o}
   9180   \gdef^^f4{\^o}
   9181   \gdef^^f5{\H o}
   9182   \gdef^^f6{\"o}
   9183   \gdef^^f7{$\div$}
   9184   \gdef^^f8{\v r}
   9185   \gdef^^f9{\ringaccent u}
   9186   \gdef^^fa{\'u}
   9187   \gdef^^fb{\H u}
   9188   \gdef^^fc{\"u}
   9189   \gdef^^fd{\'y}
   9190   \gdef^^fe{\cedilla t}
   9191   \gdef^^ff{\dotaccent{}}
   9192 }
   9193 
   9194 % UTF-8 character definitions.
   9195 %
   9196 % This code to support UTF-8 is based on LaTeX's utf8.def, with some
   9197 % changes for Texinfo conventions.  It is included here under the GPL by
   9198 % permission from Frank Mittelbach and the LaTeX team.
   9199 %
   9200 \newcount\countUTFx
   9201 \newcount\countUTFy
   9202 \newcount\countUTFz
   9203 
   9204 \gdef\UTFviiiTwoOctets#1#2{\expandafter
   9205    \UTFviiiDefined\csname u8:#1\string #2\endcsname}
   9206 %
   9207 \gdef\UTFviiiThreeOctets#1#2#3{\expandafter
   9208    \UTFviiiDefined\csname u8:#1\string #2\string #3\endcsname}
   9209 %
   9210 \gdef\UTFviiiFourOctets#1#2#3#4{\expandafter
   9211    \UTFviiiDefined\csname u8:#1\string #2\string #3\string #4\endcsname}
   9212 
   9213 \gdef\UTFviiiDefined#1{%
   9214   \ifx #1\relax
   9215     \message{\linenumber Unicode char \string #1 not defined for Texinfo}%
   9216   \else
   9217     \expandafter #1%
   9218   \fi
   9219 }
   9220 
   9221 \begingroup
   9222   \catcode`\~13
   9223   \catcode`\"12
   9224 
   9225   \def\UTFviiiLoop{%
   9226     \global\catcode\countUTFx\active
   9227     \uccode`\~\countUTFx
   9228     \uppercase\expandafter{\UTFviiiTmp}%
   9229     \advance\countUTFx by 1
   9230     \ifnum\countUTFx < \countUTFy
   9231       \expandafter\UTFviiiLoop
   9232     \fi}
   9233 
   9234   \countUTFx = "C2
   9235   \countUTFy = "E0
   9236   \def\UTFviiiTmp{%
   9237     \xdef~{\noexpand\UTFviiiTwoOctets\string~}}
   9238   \UTFviiiLoop
   9239 
   9240   \countUTFx = "E0
   9241   \countUTFy = "F0
   9242   \def\UTFviiiTmp{%
   9243     \xdef~{\noexpand\UTFviiiThreeOctets\string~}}
   9244   \UTFviiiLoop
   9245 
   9246   \countUTFx = "F0
   9247   \countUTFy = "F4
   9248   \def\UTFviiiTmp{%
   9249     \xdef~{\noexpand\UTFviiiFourOctets\string~}}
   9250   \UTFviiiLoop
   9251 \endgroup
   9252 
   9253 \begingroup
   9254   \catcode`\"=12
   9255   \catcode`\<=12
   9256   \catcode`\.=12
   9257   \catcode`\,=12
   9258   \catcode`\;=12
   9259   \catcode`\!=12
   9260   \catcode`\~=13
   9261 
   9262   \gdef\DeclareUnicodeCharacter#1#2{%
   9263     \countUTFz = "#1\relax
   9264     %\wlog{\space\space defining Unicode char U+#1 (decimal \the\countUTFz)}%
   9265     \begingroup
   9266       \parseXMLCharref
   9267       \def\UTFviiiTwoOctets##1##2{%
   9268         \csname u8:##1\string ##2\endcsname}%
   9269       \def\UTFviiiThreeOctets##1##2##3{%
   9270         \csname u8:##1\string ##2\string ##3\endcsname}%
   9271       \def\UTFviiiFourOctets##1##2##3##4{%
   9272         \csname u8:##1\string ##2\string ##3\string ##4\endcsname}%
   9273       \expandafter\expandafter\expandafter\expandafter
   9274        \expandafter\expandafter\expandafter
   9275        \gdef\UTFviiiTmp{#2}%
   9276     \endgroup}
   9277 
   9278   \gdef\parseXMLCharref{%
   9279     \ifnum\countUTFz < "A0\relax
   9280       \errhelp = \EMsimple
   9281       \errmessage{Cannot define Unicode char value < 00A0}%
   9282     \else\ifnum\countUTFz < "800\relax
   9283       \parseUTFviiiA,%
   9284       \parseUTFviiiB C\UTFviiiTwoOctets.,%
   9285     \else\ifnum\countUTFz < "10000\relax
   9286       \parseUTFviiiA;%
   9287       \parseUTFviiiA,%
   9288       \parseUTFviiiB E\UTFviiiThreeOctets.{,;}%
   9289     \else
   9290       \parseUTFviiiA;%
   9291       \parseUTFviiiA,%
   9292       \parseUTFviiiA!%
   9293       \parseUTFviiiB F\UTFviiiFourOctets.{!,;}%
   9294     \fi\fi\fi
   9295   }
   9296 
   9297   \gdef\parseUTFviiiA#1{%
   9298     \countUTFx = \countUTFz
   9299     \divide\countUTFz by 64
   9300     \countUTFy = \countUTFz
   9301     \multiply\countUTFz by 64
   9302     \advance\countUTFx by -\countUTFz
   9303     \advance\countUTFx by 128
   9304     \uccode `#1\countUTFx
   9305     \countUTFz = \countUTFy}
   9306 
   9307   \gdef\parseUTFviiiB#1#2#3#4{%
   9308     \advance\countUTFz by "#10\relax
   9309     \uccode `#3\countUTFz
   9310     \uppercase{\gdef\UTFviiiTmp{#2#3#4}}}
   9311 \endgroup
   9312 
   9313 \def\utfeightchardefs{%
   9314   \DeclareUnicodeCharacter{00A0}{\tie}
   9315   \DeclareUnicodeCharacter{00A1}{\exclamdown}
   9316   \DeclareUnicodeCharacter{00A3}{\pounds}
   9317   \DeclareUnicodeCharacter{00A8}{\"{ }}
   9318   \DeclareUnicodeCharacter{00A9}{\copyright}
   9319   \DeclareUnicodeCharacter{00AA}{\ordf}
   9320   \DeclareUnicodeCharacter{00AB}{\guillemetleft}
   9321   \DeclareUnicodeCharacter{00AD}{\-}
   9322   \DeclareUnicodeCharacter{00AE}{\registeredsymbol}
   9323   \DeclareUnicodeCharacter{00AF}{\={ }}
   9324 
   9325   \DeclareUnicodeCharacter{00B0}{\ringaccent{ }}
   9326   \DeclareUnicodeCharacter{00B4}{\'{ }}
   9327   \DeclareUnicodeCharacter{00B8}{\cedilla{ }}
   9328   \DeclareUnicodeCharacter{00BA}{\ordm}
   9329   \DeclareUnicodeCharacter{00BB}{\guillemetright}
   9330   \DeclareUnicodeCharacter{00BF}{\questiondown}
   9331 
   9332   \DeclareUnicodeCharacter{00C0}{\`A}
   9333   \DeclareUnicodeCharacter{00C1}{\'A}
   9334   \DeclareUnicodeCharacter{00C2}{\^A}
   9335   \DeclareUnicodeCharacter{00C3}{\~A}
   9336   \DeclareUnicodeCharacter{00C4}{\"A}
   9337   \DeclareUnicodeCharacter{00C5}{\AA}
   9338   \DeclareUnicodeCharacter{00C6}{\AE}
   9339   \DeclareUnicodeCharacter{00C7}{\cedilla{C}}
   9340   \DeclareUnicodeCharacter{00C8}{\`E}
   9341   \DeclareUnicodeCharacter{00C9}{\'E}
   9342   \DeclareUnicodeCharacter{00CA}{\^E}
   9343   \DeclareUnicodeCharacter{00CB}{\"E}
   9344   \DeclareUnicodeCharacter{00CC}{\`I}
   9345   \DeclareUnicodeCharacter{00CD}{\'I}
   9346   \DeclareUnicodeCharacter{00CE}{\^I}
   9347   \DeclareUnicodeCharacter{00CF}{\"I}
   9348 
   9349   \DeclareUnicodeCharacter{00D0}{\DH}
   9350   \DeclareUnicodeCharacter{00D1}{\~N}
   9351   \DeclareUnicodeCharacter{00D2}{\`O}
   9352   \DeclareUnicodeCharacter{00D3}{\'O}
   9353   \DeclareUnicodeCharacter{00D4}{\^O}
   9354   \DeclareUnicodeCharacter{00D5}{\~O}
   9355   \DeclareUnicodeCharacter{00D6}{\"O}
   9356   \DeclareUnicodeCharacter{00D8}{\O}
   9357   \DeclareUnicodeCharacter{00D9}{\`U}
   9358   \DeclareUnicodeCharacter{00DA}{\'U}
   9359   \DeclareUnicodeCharacter{00DB}{\^U}
   9360   \DeclareUnicodeCharacter{00DC}{\"U}
   9361   \DeclareUnicodeCharacter{00DD}{\'Y}
   9362   \DeclareUnicodeCharacter{00DE}{\TH}
   9363   \DeclareUnicodeCharacter{00DF}{\ss}
   9364 
   9365   \DeclareUnicodeCharacter{00E0}{\`a}
   9366   \DeclareUnicodeCharacter{00E1}{\'a}
   9367   \DeclareUnicodeCharacter{00E2}{\^a}
   9368   \DeclareUnicodeCharacter{00E3}{\~a}
   9369   \DeclareUnicodeCharacter{00E4}{\"a}
   9370   \DeclareUnicodeCharacter{00E5}{\aa}
   9371   \DeclareUnicodeCharacter{00E6}{\ae}
   9372   \DeclareUnicodeCharacter{00E7}{\cedilla{c}}
   9373   \DeclareUnicodeCharacter{00E8}{\`e}
   9374   \DeclareUnicodeCharacter{00E9}{\'e}
   9375   \DeclareUnicodeCharacter{00EA}{\^e}
   9376   \DeclareUnicodeCharacter{00EB}{\"e}
   9377   \DeclareUnicodeCharacter{00EC}{\`{\dotless{i}}}
   9378   \DeclareUnicodeCharacter{00ED}{\'{\dotless{i}}}
   9379   \DeclareUnicodeCharacter{00EE}{\^{\dotless{i}}}
   9380   \DeclareUnicodeCharacter{00EF}{\"{\dotless{i}}}
   9381 
   9382   \DeclareUnicodeCharacter{00F0}{\dh}
   9383   \DeclareUnicodeCharacter{00F1}{\~n}
   9384   \DeclareUnicodeCharacter{00F2}{\`o}
   9385   \DeclareUnicodeCharacter{00F3}{\'o}
   9386   \DeclareUnicodeCharacter{00F4}{\^o}
   9387   \DeclareUnicodeCharacter{00F5}{\~o}
   9388   \DeclareUnicodeCharacter{00F6}{\"o}
   9389   \DeclareUnicodeCharacter{00F8}{\o}
   9390   \DeclareUnicodeCharacter{00F9}{\`u}
   9391   \DeclareUnicodeCharacter{00FA}{\'u}
   9392   \DeclareUnicodeCharacter{00FB}{\^u}
   9393   \DeclareUnicodeCharacter{00FC}{\"u}
   9394   \DeclareUnicodeCharacter{00FD}{\'y}
   9395   \DeclareUnicodeCharacter{00FE}{\th}
   9396   \DeclareUnicodeCharacter{00FF}{\"y}
   9397 
   9398   \DeclareUnicodeCharacter{0100}{\=A}
   9399   \DeclareUnicodeCharacter{0101}{\=a}
   9400   \DeclareUnicodeCharacter{0102}{\u{A}}
   9401   \DeclareUnicodeCharacter{0103}{\u{a}}
   9402   \DeclareUnicodeCharacter{0104}{\ogonek{A}}
   9403   \DeclareUnicodeCharacter{0105}{\ogonek{a}}
   9404   \DeclareUnicodeCharacter{0106}{\'C}
   9405   \DeclareUnicodeCharacter{0107}{\'c}
   9406   \DeclareUnicodeCharacter{0108}{\^C}
   9407   \DeclareUnicodeCharacter{0109}{\^c}
   9408   \DeclareUnicodeCharacter{0118}{\ogonek{E}}
   9409   \DeclareUnicodeCharacter{0119}{\ogonek{e}}
   9410   \DeclareUnicodeCharacter{010A}{\dotaccent{C}}
   9411   \DeclareUnicodeCharacter{010B}{\dotaccent{c}}
   9412   \DeclareUnicodeCharacter{010C}{\v{C}}
   9413   \DeclareUnicodeCharacter{010D}{\v{c}}
   9414   \DeclareUnicodeCharacter{010E}{\v{D}}
   9415 
   9416   \DeclareUnicodeCharacter{0112}{\=E}
   9417   \DeclareUnicodeCharacter{0113}{\=e}
   9418   \DeclareUnicodeCharacter{0114}{\u{E}}
   9419   \DeclareUnicodeCharacter{0115}{\u{e}}
   9420   \DeclareUnicodeCharacter{0116}{\dotaccent{E}}
   9421   \DeclareUnicodeCharacter{0117}{\dotaccent{e}}
   9422   \DeclareUnicodeCharacter{011A}{\v{E}}
   9423   \DeclareUnicodeCharacter{011B}{\v{e}}
   9424   \DeclareUnicodeCharacter{011C}{\^G}
   9425   \DeclareUnicodeCharacter{011D}{\^g}
   9426   \DeclareUnicodeCharacter{011E}{\u{G}}
   9427   \DeclareUnicodeCharacter{011F}{\u{g}}
   9428 
   9429   \DeclareUnicodeCharacter{0120}{\dotaccent{G}}
   9430   \DeclareUnicodeCharacter{0121}{\dotaccent{g}}
   9431   \DeclareUnicodeCharacter{0124}{\^H}
   9432   \DeclareUnicodeCharacter{0125}{\^h}
   9433   \DeclareUnicodeCharacter{0128}{\~I}
   9434   \DeclareUnicodeCharacter{0129}{\~{\dotless{i}}}
   9435   \DeclareUnicodeCharacter{012A}{\=I}
   9436   \DeclareUnicodeCharacter{012B}{\={\dotless{i}}}
   9437   \DeclareUnicodeCharacter{012C}{\u{I}}
   9438   \DeclareUnicodeCharacter{012D}{\u{\dotless{i}}}
   9439 
   9440   \DeclareUnicodeCharacter{0130}{\dotaccent{I}}
   9441   \DeclareUnicodeCharacter{0131}{\dotless{i}}
   9442   \DeclareUnicodeCharacter{0132}{IJ}
   9443   \DeclareUnicodeCharacter{0133}{ij}
   9444   \DeclareUnicodeCharacter{0134}{\^J}
   9445   \DeclareUnicodeCharacter{0135}{\^{\dotless{j}}}
   9446   \DeclareUnicodeCharacter{0139}{\'L}
   9447   \DeclareUnicodeCharacter{013A}{\'l}
   9448 
   9449   \DeclareUnicodeCharacter{0141}{\L}
   9450   \DeclareUnicodeCharacter{0142}{\l}
   9451   \DeclareUnicodeCharacter{0143}{\'N}
   9452   \DeclareUnicodeCharacter{0144}{\'n}
   9453   \DeclareUnicodeCharacter{0147}{\v{N}}
   9454   \DeclareUnicodeCharacter{0148}{\v{n}}
   9455   \DeclareUnicodeCharacter{014C}{\=O}
   9456   \DeclareUnicodeCharacter{014D}{\=o}
   9457   \DeclareUnicodeCharacter{014E}{\u{O}}
   9458   \DeclareUnicodeCharacter{014F}{\u{o}}
   9459 
   9460   \DeclareUnicodeCharacter{0150}{\H{O}}
   9461   \DeclareUnicodeCharacter{0151}{\H{o}}
   9462   \DeclareUnicodeCharacter{0152}{\OE}
   9463   \DeclareUnicodeCharacter{0153}{\oe}
   9464   \DeclareUnicodeCharacter{0154}{\'R}
   9465   \DeclareUnicodeCharacter{0155}{\'r}
   9466   \DeclareUnicodeCharacter{0158}{\v{R}}
   9467   \DeclareUnicodeCharacter{0159}{\v{r}}
   9468   \DeclareUnicodeCharacter{015A}{\'S}
   9469   \DeclareUnicodeCharacter{015B}{\'s}
   9470   \DeclareUnicodeCharacter{015C}{\^S}
   9471   \DeclareUnicodeCharacter{015D}{\^s}
   9472   \DeclareUnicodeCharacter{015E}{\cedilla{S}}
   9473   \DeclareUnicodeCharacter{015F}{\cedilla{s}}
   9474 
   9475   \DeclareUnicodeCharacter{0160}{\v{S}}
   9476   \DeclareUnicodeCharacter{0161}{\v{s}}
   9477   \DeclareUnicodeCharacter{0162}{\cedilla{t}}
   9478   \DeclareUnicodeCharacter{0163}{\cedilla{T}}
   9479   \DeclareUnicodeCharacter{0164}{\v{T}}
   9480 
   9481   \DeclareUnicodeCharacter{0168}{\~U}
   9482   \DeclareUnicodeCharacter{0169}{\~u}
   9483   \DeclareUnicodeCharacter{016A}{\=U}
   9484   \DeclareUnicodeCharacter{016B}{\=u}
   9485   \DeclareUnicodeCharacter{016C}{\u{U}}
   9486   \DeclareUnicodeCharacter{016D}{\u{u}}
   9487   \DeclareUnicodeCharacter{016E}{\ringaccent{U}}
   9488   \DeclareUnicodeCharacter{016F}{\ringaccent{u}}
   9489 
   9490   \DeclareUnicodeCharacter{0170}{\H{U}}
   9491   \DeclareUnicodeCharacter{0171}{\H{u}}
   9492   \DeclareUnicodeCharacter{0174}{\^W}
   9493   \DeclareUnicodeCharacter{0175}{\^w}
   9494   \DeclareUnicodeCharacter{0176}{\^Y}
   9495   \DeclareUnicodeCharacter{0177}{\^y}
   9496   \DeclareUnicodeCharacter{0178}{\"Y}
   9497   \DeclareUnicodeCharacter{0179}{\'Z}
   9498   \DeclareUnicodeCharacter{017A}{\'z}
   9499   \DeclareUnicodeCharacter{017B}{\dotaccent{Z}}
   9500   \DeclareUnicodeCharacter{017C}{\dotaccent{z}}
   9501   \DeclareUnicodeCharacter{017D}{\v{Z}}
   9502   \DeclareUnicodeCharacter{017E}{\v{z}}
   9503 
   9504   \DeclareUnicodeCharacter{01C4}{D\v{Z}}
   9505   \DeclareUnicodeCharacter{01C5}{D\v{z}}
   9506   \DeclareUnicodeCharacter{01C6}{d\v{z}}
   9507   \DeclareUnicodeCharacter{01C7}{LJ}
   9508   \DeclareUnicodeCharacter{01C8}{Lj}
   9509   \DeclareUnicodeCharacter{01C9}{lj}
   9510   \DeclareUnicodeCharacter{01CA}{NJ}
   9511   \DeclareUnicodeCharacter{01CB}{Nj}
   9512   \DeclareUnicodeCharacter{01CC}{nj}
   9513   \DeclareUnicodeCharacter{01CD}{\v{A}}
   9514   \DeclareUnicodeCharacter{01CE}{\v{a}}
   9515   \DeclareUnicodeCharacter{01CF}{\v{I}}
   9516 
   9517   \DeclareUnicodeCharacter{01D0}{\v{\dotless{i}}}
   9518   \DeclareUnicodeCharacter{01D1}{\v{O}}
   9519   \DeclareUnicodeCharacter{01D2}{\v{o}}
   9520   \DeclareUnicodeCharacter{01D3}{\v{U}}
   9521   \DeclareUnicodeCharacter{01D4}{\v{u}}
   9522 
   9523   \DeclareUnicodeCharacter{01E2}{\={\AE}}
   9524   \DeclareUnicodeCharacter{01E3}{\={\ae}}
   9525   \DeclareUnicodeCharacter{01E6}{\v{G}}
   9526   \DeclareUnicodeCharacter{01E7}{\v{g}}
   9527   \DeclareUnicodeCharacter{01E8}{\v{K}}
   9528   \DeclareUnicodeCharacter{01E9}{\v{k}}
   9529 
   9530   \DeclareUnicodeCharacter{01F0}{\v{\dotless{j}}}
   9531   \DeclareUnicodeCharacter{01F1}{DZ}
   9532   \DeclareUnicodeCharacter{01F2}{Dz}
   9533   \DeclareUnicodeCharacter{01F3}{dz}
   9534   \DeclareUnicodeCharacter{01F4}{\'G}
   9535   \DeclareUnicodeCharacter{01F5}{\'g}
   9536   \DeclareUnicodeCharacter{01F8}{\`N}
   9537   \DeclareUnicodeCharacter{01F9}{\`n}
   9538   \DeclareUnicodeCharacter{01FC}{\'{\AE}}
   9539   \DeclareUnicodeCharacter{01FD}{\'{\ae}}
   9540   \DeclareUnicodeCharacter{01FE}{\'{\O}}
   9541   \DeclareUnicodeCharacter{01FF}{\'{\o}}
   9542 
   9543   \DeclareUnicodeCharacter{021E}{\v{H}}
   9544   \DeclareUnicodeCharacter{021F}{\v{h}}
   9545 
   9546   \DeclareUnicodeCharacter{0226}{\dotaccent{A}}
   9547   \DeclareUnicodeCharacter{0227}{\dotaccent{a}}
   9548   \DeclareUnicodeCharacter{0228}{\cedilla{E}}
   9549   \DeclareUnicodeCharacter{0229}{\cedilla{e}}
   9550   \DeclareUnicodeCharacter{022E}{\dotaccent{O}}
   9551   \DeclareUnicodeCharacter{022F}{\dotaccent{o}}
   9552 
   9553   \DeclareUnicodeCharacter{0232}{\=Y}
   9554   \DeclareUnicodeCharacter{0233}{\=y}
   9555   \DeclareUnicodeCharacter{0237}{\dotless{j}}
   9556 
   9557   \DeclareUnicodeCharacter{02DB}{\ogonek{ }}
   9558 
   9559   \DeclareUnicodeCharacter{1E02}{\dotaccent{B}}
   9560   \DeclareUnicodeCharacter{1E03}{\dotaccent{b}}
   9561   \DeclareUnicodeCharacter{1E04}{\udotaccent{B}}
   9562   \DeclareUnicodeCharacter{1E05}{\udotaccent{b}}
   9563   \DeclareUnicodeCharacter{1E06}{\ubaraccent{B}}
   9564   \DeclareUnicodeCharacter{1E07}{\ubaraccent{b}}
   9565   \DeclareUnicodeCharacter{1E0A}{\dotaccent{D}}
   9566   \DeclareUnicodeCharacter{1E0B}{\dotaccent{d}}
   9567   \DeclareUnicodeCharacter{1E0C}{\udotaccent{D}}
   9568   \DeclareUnicodeCharacter{1E0D}{\udotaccent{d}}
   9569   \DeclareUnicodeCharacter{1E0E}{\ubaraccent{D}}
   9570   \DeclareUnicodeCharacter{1E0F}{\ubaraccent{d}}
   9571 
   9572   \DeclareUnicodeCharacter{1E1E}{\dotaccent{F}}
   9573   \DeclareUnicodeCharacter{1E1F}{\dotaccent{f}}
   9574 
   9575   \DeclareUnicodeCharacter{1E20}{\=G}
   9576   \DeclareUnicodeCharacter{1E21}{\=g}
   9577   \DeclareUnicodeCharacter{1E22}{\dotaccent{H}}
   9578   \DeclareUnicodeCharacter{1E23}{\dotaccent{h}}
   9579   \DeclareUnicodeCharacter{1E24}{\udotaccent{H}}
   9580   \DeclareUnicodeCharacter{1E25}{\udotaccent{h}}
   9581   \DeclareUnicodeCharacter{1E26}{\"H}
   9582   \DeclareUnicodeCharacter{1E27}{\"h}
   9583 
   9584   \DeclareUnicodeCharacter{1E30}{\'K}
   9585   \DeclareUnicodeCharacter{1E31}{\'k}
   9586   \DeclareUnicodeCharacter{1E32}{\udotaccent{K}}
   9587   \DeclareUnicodeCharacter{1E33}{\udotaccent{k}}
   9588   \DeclareUnicodeCharacter{1E34}{\ubaraccent{K}}
   9589   \DeclareUnicodeCharacter{1E35}{\ubaraccent{k}}
   9590   \DeclareUnicodeCharacter{1E36}{\udotaccent{L}}
   9591   \DeclareUnicodeCharacter{1E37}{\udotaccent{l}}
   9592   \DeclareUnicodeCharacter{1E3A}{\ubaraccent{L}}
   9593   \DeclareUnicodeCharacter{1E3B}{\ubaraccent{l}}
   9594   \DeclareUnicodeCharacter{1E3E}{\'M}
   9595   \DeclareUnicodeCharacter{1E3F}{\'m}
   9596 
   9597   \DeclareUnicodeCharacter{1E40}{\dotaccent{M}}
   9598   \DeclareUnicodeCharacter{1E41}{\dotaccent{m}}
   9599   \DeclareUnicodeCharacter{1E42}{\udotaccent{M}}
   9600   \DeclareUnicodeCharacter{1E43}{\udotaccent{m}}
   9601   \DeclareUnicodeCharacter{1E44}{\dotaccent{N}}
   9602   \DeclareUnicodeCharacter{1E45}{\dotaccent{n}}
   9603   \DeclareUnicodeCharacter{1E46}{\udotaccent{N}}
   9604   \DeclareUnicodeCharacter{1E47}{\udotaccent{n}}
   9605   \DeclareUnicodeCharacter{1E48}{\ubaraccent{N}}
   9606   \DeclareUnicodeCharacter{1E49}{\ubaraccent{n}}
   9607 
   9608   \DeclareUnicodeCharacter{1E54}{\'P}
   9609   \DeclareUnicodeCharacter{1E55}{\'p}
   9610   \DeclareUnicodeCharacter{1E56}{\dotaccent{P}}
   9611   \DeclareUnicodeCharacter{1E57}{\dotaccent{p}}
   9612   \DeclareUnicodeCharacter{1E58}{\dotaccent{R}}
   9613   \DeclareUnicodeCharacter{1E59}{\dotaccent{r}}
   9614   \DeclareUnicodeCharacter{1E5A}{\udotaccent{R}}
   9615   \DeclareUnicodeCharacter{1E5B}{\udotaccent{r}}
   9616   \DeclareUnicodeCharacter{1E5E}{\ubaraccent{R}}
   9617   \DeclareUnicodeCharacter{1E5F}{\ubaraccent{r}}
   9618 
   9619   \DeclareUnicodeCharacter{1E60}{\dotaccent{S}}
   9620   \DeclareUnicodeCharacter{1E61}{\dotaccent{s}}
   9621   \DeclareUnicodeCharacter{1E62}{\udotaccent{S}}
   9622   \DeclareUnicodeCharacter{1E63}{\udotaccent{s}}
   9623   \DeclareUnicodeCharacter{1E6A}{\dotaccent{T}}
   9624   \DeclareUnicodeCharacter{1E6B}{\dotaccent{t}}
   9625   \DeclareUnicodeCharacter{1E6C}{\udotaccent{T}}
   9626   \DeclareUnicodeCharacter{1E6D}{\udotaccent{t}}
   9627   \DeclareUnicodeCharacter{1E6E}{\ubaraccent{T}}
   9628   \DeclareUnicodeCharacter{1E6F}{\ubaraccent{t}}
   9629 
   9630   \DeclareUnicodeCharacter{1E7C}{\~V}
   9631   \DeclareUnicodeCharacter{1E7D}{\~v}
   9632   \DeclareUnicodeCharacter{1E7E}{\udotaccent{V}}
   9633   \DeclareUnicodeCharacter{1E7F}{\udotaccent{v}}
   9634 
   9635   \DeclareUnicodeCharacter{1E80}{\`W}
   9636   \DeclareUnicodeCharacter{1E81}{\`w}
   9637   \DeclareUnicodeCharacter{1E82}{\'W}
   9638   \DeclareUnicodeCharacter{1E83}{\'w}
   9639   \DeclareUnicodeCharacter{1E84}{\"W}
   9640   \DeclareUnicodeCharacter{1E85}{\"w}
   9641   \DeclareUnicodeCharacter{1E86}{\dotaccent{W}}
   9642   \DeclareUnicodeCharacter{1E87}{\dotaccent{w}}
   9643   \DeclareUnicodeCharacter{1E88}{\udotaccent{W}}
   9644   \DeclareUnicodeCharacter{1E89}{\udotaccent{w}}
   9645   \DeclareUnicodeCharacter{1E8A}{\dotaccent{X}}
   9646   \DeclareUnicodeCharacter{1E8B}{\dotaccent{x}}
   9647   \DeclareUnicodeCharacter{1E8C}{\"X}
   9648   \DeclareUnicodeCharacter{1E8D}{\"x}
   9649   \DeclareUnicodeCharacter{1E8E}{\dotaccent{Y}}
   9650   \DeclareUnicodeCharacter{1E8F}{\dotaccent{y}}
   9651 
   9652   \DeclareUnicodeCharacter{1E90}{\^Z}
   9653   \DeclareUnicodeCharacter{1E91}{\^z}
   9654   \DeclareUnicodeCharacter{1E92}{\udotaccent{Z}}
   9655   \DeclareUnicodeCharacter{1E93}{\udotaccent{z}}
   9656   \DeclareUnicodeCharacter{1E94}{\ubaraccent{Z}}
   9657   \DeclareUnicodeCharacter{1E95}{\ubaraccent{z}}
   9658   \DeclareUnicodeCharacter{1E96}{\ubaraccent{h}}
   9659   \DeclareUnicodeCharacter{1E97}{\"t}
   9660   \DeclareUnicodeCharacter{1E98}{\ringaccent{w}}
   9661   \DeclareUnicodeCharacter{1E99}{\ringaccent{y}}
   9662 
   9663   \DeclareUnicodeCharacter{1EA0}{\udotaccent{A}}
   9664   \DeclareUnicodeCharacter{1EA1}{\udotaccent{a}}
   9665 
   9666   \DeclareUnicodeCharacter{1EB8}{\udotaccent{E}}
   9667   \DeclareUnicodeCharacter{1EB9}{\udotaccent{e}}
   9668   \DeclareUnicodeCharacter{1EBC}{\~E}
   9669   \DeclareUnicodeCharacter{1EBD}{\~e}
   9670 
   9671   \DeclareUnicodeCharacter{1ECA}{\udotaccent{I}}
   9672   \DeclareUnicodeCharacter{1ECB}{\udotaccent{i}}
   9673   \DeclareUnicodeCharacter{1ECC}{\udotaccent{O}}
   9674   \DeclareUnicodeCharacter{1ECD}{\udotaccent{o}}
   9675 
   9676   \DeclareUnicodeCharacter{1EE4}{\udotaccent{U}}
   9677   \DeclareUnicodeCharacter{1EE5}{\udotaccent{u}}
   9678 
   9679   \DeclareUnicodeCharacter{1EF2}{\`Y}
   9680   \DeclareUnicodeCharacter{1EF3}{\`y}
   9681   \DeclareUnicodeCharacter{1EF4}{\udotaccent{Y}}
   9682 
   9683   \DeclareUnicodeCharacter{1EF8}{\~Y}
   9684   \DeclareUnicodeCharacter{1EF9}{\~y}
   9685 
   9686   \DeclareUnicodeCharacter{2013}{--}
   9687   \DeclareUnicodeCharacter{2014}{---}
   9688   \DeclareUnicodeCharacter{2018}{\quoteleft}
   9689   \DeclareUnicodeCharacter{2019}{\quoteright}
   9690   \DeclareUnicodeCharacter{201A}{\quotesinglbase}
   9691   \DeclareUnicodeCharacter{201C}{\quotedblleft}
   9692   \DeclareUnicodeCharacter{201D}{\quotedblright}
   9693   \DeclareUnicodeCharacter{201E}{\quotedblbase}
   9694   \DeclareUnicodeCharacter{2022}{\bullet}
   9695   \DeclareUnicodeCharacter{2026}{\dots}
   9696   \DeclareUnicodeCharacter{2039}{\guilsinglleft}
   9697   \DeclareUnicodeCharacter{203A}{\guilsinglright}
   9698   \DeclareUnicodeCharacter{20AC}{\euro}
   9699 
   9700   \DeclareUnicodeCharacter{2192}{\expansion}
   9701   \DeclareUnicodeCharacter{21D2}{\result}
   9702 
   9703   \DeclareUnicodeCharacter{2212}{\minus}
   9704   \DeclareUnicodeCharacter{2217}{\point}
   9705   \DeclareUnicodeCharacter{2261}{\equiv}
   9706 }% end of \utfeightchardefs
   9707 
   9708 
   9709 % US-ASCII character definitions.
   9710 \def\asciichardefs{% nothing need be done
   9711    \relax
   9712 }
   9713 
   9714 % Make non-ASCII characters printable again for compatibility with
   9715 % existing Texinfo documents that may use them, even without declaring a
   9716 % document encoding.
   9717 %
   9718 \setnonasciicharscatcode \other
   9719 
   9720 
   9721 \message{formatting,}
   9722 
   9723 \newdimen\defaultparindent \defaultparindent = 15pt
   9724 
   9725 \chapheadingskip = 15pt plus 4pt minus 2pt
   9726 \secheadingskip = 12pt plus 3pt minus 2pt
   9727 \subsecheadingskip = 9pt plus 2pt minus 2pt
   9728 
   9729 % Prevent underfull vbox error messages.
   9730 \vbadness = 10000
   9731 
   9732 % Don't be very finicky about underfull hboxes, either.
   9733 \hbadness = 6666
   9734 
   9735 % Following George Bush, get rid of widows and orphans.
   9736 \widowpenalty=10000
   9737 \clubpenalty=10000
   9738 
   9739 % Use TeX 3.0's \emergencystretch to help line breaking, but if we're
   9740 % using an old version of TeX, don't do anything.  We want the amount of
   9741 % stretch added to depend on the line length, hence the dependence on
   9742 % \hsize.  We call this whenever the paper size is set.
   9743 %
   9744 \def\setemergencystretch{%
   9745   \ifx\emergencystretch\thisisundefined
   9746     % Allow us to assign to \emergencystretch anyway.
   9747     \def\emergencystretch{\dimen0}%
   9748   \else
   9749     \emergencystretch = .15\hsize
   9750   \fi
   9751 }
   9752 
   9753 % Parameters in order: 1) textheight; 2) textwidth;
   9754 % 3) voffset; 4) hoffset; 5) binding offset; 6) topskip;
   9755 % 7) physical page height; 8) physical page width.
   9756 %
   9757 % We also call \setleading{\textleading}, so the caller should define
   9758 % \textleading.  The caller should also set \parskip.
   9759 %
   9760 \def\internalpagesizes#1#2#3#4#5#6#7#8{%
   9761   \voffset = #3\relax
   9762   \topskip = #6\relax
   9763   \splittopskip = \topskip
   9764   %
   9765   \vsize = #1\relax
   9766   \advance\vsize by \topskip
   9767   \outervsize = \vsize
   9768   \advance\outervsize by 2\topandbottommargin
   9769   \pageheight = \vsize
   9770   %
   9771   \hsize = #2\relax
   9772   \outerhsize = \hsize
   9773   \advance\outerhsize by 0.5in
   9774   \pagewidth = \hsize
   9775   %
   9776   \normaloffset = #4\relax
   9777   \bindingoffset = #5\relax
   9778   %
   9779   \ifpdf
   9780     \pdfpageheight #7\relax
   9781     \pdfpagewidth #8\relax
   9782     % if we don't reset these, they will remain at "1 true in" of
   9783     % whatever layout pdftex was dumped with.
   9784     \pdfhorigin = 1 true in
   9785     \pdfvorigin = 1 true in
   9786   \fi
   9787   %
   9788   \setleading{\textleading}
   9789   %
   9790   \parindent = \defaultparindent
   9791   \setemergencystretch
   9792 }
   9793 
   9794 % @letterpaper (the default).
   9795 \def\letterpaper{{\globaldefs = 1
   9796   \parskip = 3pt plus 2pt minus 1pt
   9797   \textleading = 13.2pt
   9798   %
   9799   % If page is nothing but text, make it come out even.
   9800   \internalpagesizes{607.2pt}{6in}% that's 46 lines
   9801                     {\voffset}{.25in}%
   9802                     {\bindingoffset}{36pt}%
   9803                     {11in}{8.5in}%
   9804 }}
   9805 
   9806 % Use @smallbook to reset parameters for 7x9.25 trim size.
   9807 \def\smallbook{{\globaldefs = 1
   9808   \parskip = 2pt plus 1pt
   9809   \textleading = 12pt
   9810   %
   9811   \internalpagesizes{7.5in}{5in}%
   9812                     {-.2in}{0in}%
   9813                     {\bindingoffset}{16pt}%
   9814                     {9.25in}{7in}%
   9815   %
   9816   \lispnarrowing = 0.3in
   9817   \tolerance = 700
   9818   \hfuzz = 1pt
   9819   \contentsrightmargin = 0pt
   9820   \defbodyindent = .5cm
   9821 }}
   9822 
   9823 % Use @smallerbook to reset parameters for 6x9 trim size.
   9824 % (Just testing, parameters still in flux.)
   9825 \def\smallerbook{{\globaldefs = 1
   9826   \parskip = 1.5pt plus 1pt
   9827   \textleading = 12pt
   9828   %
   9829   \internalpagesizes{7.4in}{4.8in}%
   9830                     {-.2in}{-.4in}%
   9831                     {0pt}{14pt}%
   9832                     {9in}{6in}%
   9833   %
   9834   \lispnarrowing = 0.25in
   9835   \tolerance = 700
   9836   \hfuzz = 1pt
   9837   \contentsrightmargin = 0pt
   9838   \defbodyindent = .4cm
   9839 }}
   9840 
   9841 % Use @afourpaper to print on European A4 paper.
   9842 \def\afourpaper{{\globaldefs = 1
   9843   \parskip = 3pt plus 2pt minus 1pt
   9844   \textleading = 13.2pt
   9845   %
   9846   % Double-side printing via postscript on Laserjet 4050
   9847   % prints double-sided nicely when \bindingoffset=10mm and \hoffset=-6mm.
   9848   % To change the settings for a different printer or situation, adjust
   9849   % \normaloffset until the front-side and back-side texts align.  Then
   9850   % do the same for \bindingoffset.  You can set these for testing in
   9851   % your texinfo source file like this:
   9852   % @tex
   9853   % \global\normaloffset = -6mm
   9854   % \global\bindingoffset = 10mm
   9855   % @end tex
   9856   \internalpagesizes{673.2pt}{160mm}% that's 51 lines
   9857                     {\voffset}{\hoffset}%
   9858                     {\bindingoffset}{44pt}%
   9859                     {297mm}{210mm}%
   9860   %
   9861   \tolerance = 700
   9862   \hfuzz = 1pt
   9863   \contentsrightmargin = 0pt
   9864   \defbodyindent = 5mm
   9865 }}
   9866 
   9867 % Use @afivepaper to print on European A5 paper.
   9868 % From romildo@urano.iceb.ufop.br, 2 July 2000.
   9869 % He also recommends making @example and @lisp be small.
   9870 \def\afivepaper{{\globaldefs = 1
   9871   \parskip = 2pt plus 1pt minus 0.1pt
   9872   \textleading = 12.5pt
   9873   %
   9874   \internalpagesizes{160mm}{120mm}%
   9875                     {\voffset}{\hoffset}%
   9876                     {\bindingoffset}{8pt}%
   9877                     {210mm}{148mm}%
   9878   %
   9879   \lispnarrowing = 0.2in
   9880   \tolerance = 800
   9881   \hfuzz = 1.2pt
   9882   \contentsrightmargin = 0pt
   9883   \defbodyindent = 2mm
   9884   \tableindent = 12mm
   9885 }}
   9886 
   9887 % A specific text layout, 24x15cm overall, intended for A4 paper.
   9888 \def\afourlatex{{\globaldefs = 1
   9889   \afourpaper
   9890   \internalpagesizes{237mm}{150mm}%
   9891                     {\voffset}{4.6mm}%
   9892                     {\bindingoffset}{7mm}%
   9893                     {297mm}{210mm}%
   9894   %
   9895   % Must explicitly reset to 0 because we call \afourpaper.
   9896   \globaldefs = 0
   9897 }}
   9898 
   9899 % Use @afourwide to print on A4 paper in landscape format.
   9900 \def\afourwide{{\globaldefs = 1
   9901   \afourpaper
   9902   \internalpagesizes{241mm}{165mm}%
   9903                     {\voffset}{-2.95mm}%
   9904                     {\bindingoffset}{7mm}%
   9905                     {297mm}{210mm}%
   9906   \globaldefs = 0
   9907 }}
   9908 
   9909 % @pagesizes TEXTHEIGHT[,TEXTWIDTH]
   9910 % Perhaps we should allow setting the margins, \topskip, \parskip,
   9911 % and/or leading, also. Or perhaps we should compute them somehow.
   9912 %
   9913 \parseargdef\pagesizes{\pagesizesyyy #1,,\finish}
   9914 \def\pagesizesyyy#1,#2,#3\finish{{%
   9915   \setbox0 = \hbox{\ignorespaces #2}\ifdim\wd0 > 0pt \hsize=#2\relax \fi
   9916   \globaldefs = 1
   9917   %
   9918   \parskip = 3pt plus 2pt minus 1pt
   9919   \setleading{\textleading}%
   9920   %
   9921   \dimen0 = #1\relax
   9922   \advance\dimen0 by \voffset
   9923   %
   9924   \dimen2 = \hsize
   9925   \advance\dimen2 by \normaloffset
   9926   %
   9927   \internalpagesizes{#1}{\hsize}%
   9928                     {\voffset}{\normaloffset}%
   9929                     {\bindingoffset}{44pt}%
   9930                     {\dimen0}{\dimen2}%
   9931 }}
   9932 
   9933 % Set default to letter.
   9934 %
   9935 \letterpaper
   9936 
   9937 
   9938 \message{and turning on texinfo input format.}
   9939 
   9940 \def^^L{\par} % remove \outer, so ^L can appear in an @comment
   9941 
   9942 % DEL is a comment character, in case @c does not suffice.
   9943 \catcode`\^^? = 14
   9944 
   9945 % Define macros to output various characters with catcode for normal text.
   9946 \catcode`\"=\other \def\normaldoublequote{"}
   9947 \catcode`\$=\other \def\normaldollar{$}%$ font-lock fix
   9948 \catcode`\+=\other \def\normalplus{+}
   9949 \catcode`\<=\other \def\normalless{<}
   9950 \catcode`\>=\other \def\normalgreater{>}
   9951 \catcode`\^=\other \def\normalcaret{^}
   9952 \catcode`\_=\other \def\normalunderscore{_}
   9953 \catcode`\|=\other \def\normalverticalbar{|}
   9954 \catcode`\~=\other \def\normaltilde{~}
   9955 
   9956 % This macro is used to make a character print one way in \tt
   9957 % (where it can probably be output as-is), and another way in other fonts,
   9958 % where something hairier probably needs to be done.
   9959 %
   9960 % #1 is what to print if we are indeed using \tt; #2 is what to print
   9961 % otherwise.  Since all the Computer Modern typewriter fonts have zero
   9962 % interword stretch (and shrink), and it is reasonable to expect all
   9963 % typewriter fonts to have this, we can check that font parameter.
   9964 %
   9965 \def\ifusingtt#1#2{\ifdim \fontdimen3\font=0pt #1\else #2\fi}
   9966 
   9967 % Same as above, but check for italic font.  Actually this also catches
   9968 % non-italic slanted fonts since it is impossible to distinguish them from
   9969 % italic fonts.  But since this is only used by $ and it uses \sl anyway
   9970 % this is not a problem.
   9971 \def\ifusingit#1#2{\ifdim \fontdimen1\font>0pt #1\else #2\fi}
   9972 
   9973 % Turn off all special characters except @
   9974 % (and those which the user can use as if they were ordinary).
   9975 % Most of these we simply print from the \tt font, but for some, we can
   9976 % use math or other variants that look better in normal text.
   9977 
   9978 \catcode`\"=\active
   9979 \def\activedoublequote{{\tt\char34}}
   9980 \let"=\activedoublequote
   9981 \catcode`\~=\active \def\activetilde{{\tt\char126}} \let~ = \activetilde
   9982 \chardef\hat=`\^
   9983 \catcode`\^=\active \def\activehat{{\tt \hat}} \let^ = \activehat
   9984 
   9985 \catcode`\_=\active
   9986 \def_{\ifusingtt\normalunderscore\_}
   9987 \let\realunder=_
   9988 % Subroutine for the previous macro.
   9989 \def\_{\leavevmode \kern.07em \vbox{\hrule width.3em height.1ex}\kern .07em }
   9990 
   9991 \catcode`\|=\active
   9992 \def|{{\tt\char124}}
   9993 
   9994 \chardef \less=`\<
   9995 \catcode`\<=\active \def\activeless{{\tt \less}}\let< = \activeless
   9996 \chardef \gtr=`\>
   9997 \catcode`\>=\active \def\activegtr{{\tt \gtr}}\let> = \activegtr
   9998 \catcode`\+=\active \def+{{\tt \char 43}}
   9999 \catcode`\$=\active \def${\ifusingit{{\sl\$}}\normaldollar}%$ font-lock fix
  10000 
  10001 % used for headline/footline in the output routine, in case the page
  10002 % breaks in the middle of an @tex block.
  10003 \def\texinfochars{%
  10004   \let< = \activeless
  10005   \let> = \activegtr
  10006   \let~ = \activetilde
  10007   \let^ = \activehat
  10008   \markupsetuplqdefault \markupsetuprqdefault
  10009   \let\b = \strong
  10010   \let\i = \smartitalic
  10011   % in principle, all other definitions in \tex have to be undone too.
  10012 }
  10013 
  10014 % If a .fmt file is being used, characters that might appear in a file
  10015 % name cannot be active until we have parsed the command line.
  10016 % So turn them off again, and have \everyjob (or @setfilename) turn them on.
  10017 % \otherifyactive is called near the end of this file.
  10018 \def\otherifyactive{\catcode`+=\other \catcode`\_=\other}
  10019 
  10020 % Used sometimes to turn off (effectively) the active characters even after
  10021 % parsing them.
  10022 \def\turnoffactive{%
  10023   \normalturnoffactive
  10024   \otherbackslash
  10025 }
  10026 
  10027 \catcode`\@=0
  10028 
  10029 % \backslashcurfont outputs one backslash character in current font,
  10030 % as in \char`\\.
  10031 \global\chardef\backslashcurfont=`\\
  10032 \global\let\rawbackslashxx=\backslashcurfont  % let existing .??s files work
  10033 
  10034 % \realbackslash is an actual character `\' with catcode other, and
  10035 % \doublebackslash is two of them (for the pdf outlines).
  10036 {\catcode`\\=\other @gdef@realbackslash{\} @gdef@doublebackslash{\\}}
  10037 
  10038 % In texinfo, backslash is an active character; it prints the backslash
  10039 % in fixed width font.
  10040 \catcode`\\=\active  % @ for escape char from now on.
  10041 
  10042 % The story here is that in math mode, the \char of \backslashcurfont
  10043 % ends up printing the roman \ from the math symbol font (because \char
  10044 % in math mode uses the \mathcode, and plain.tex sets
  10045 % \mathcode`\\="026E).  It seems better for @backslashchar{} to always
  10046 % print a typewriter backslash, hence we use an explicit \mathchar,
  10047 % which is the decimal equivalent of "715c (class 7, e.g., use \fam;
  10048 % ignored family value; char position "5C).  We can't use " for the
  10049 % usual hex value because it has already been made active.
  10050 @def@normalbackslash{{@tt @ifmmode @mathchar29020 @else @backslashcurfont @fi}}
  10051 @let@backslashchar = @normalbackslash % @backslashchar{} is for user documents.
  10052 
  10053 % On startup, @fixbackslash assigns:
  10054 %  @let \ = @normalbackslash
  10055 % \rawbackslash defines an active \ to do \backslashcurfont.
  10056 % \otherbackslash defines an active \ to be a literal `\' character with
  10057 % catcode other.  We switch back and forth between these.
  10058 @gdef@rawbackslash{@let\=@backslashcurfont}
  10059 @gdef@otherbackslash{@let\=@realbackslash}
  10060 
  10061 % Same as @turnoffactive except outputs \ as {\tt\char`\\} instead of
  10062 % the literal character `\'.  Also revert - to its normal character, in
  10063 % case the active - from code has slipped in.
  10064 %
  10065 {@catcode`- = @active
  10066  @gdef@normalturnoffactive{%
  10067    @let-=@normaldash
  10068    @let"=@normaldoublequote
  10069    @let$=@normaldollar %$ font-lock fix
  10070    @let+=@normalplus
  10071    @let<=@normalless
  10072    @let>=@normalgreater
  10073    @let\=@normalbackslash
  10074    @let^=@normalcaret
  10075    @let_=@normalunderscore
  10076    @let|=@normalverticalbar
  10077    @let~=@normaltilde
  10078    @markupsetuplqdefault
  10079    @markupsetuprqdefault
  10080    @unsepspaces
  10081  }
  10082 }
  10083 
  10084 % Make _ and + \other characters, temporarily.
  10085 % This is canceled by @fixbackslash.
  10086 @otherifyactive
  10087 
  10088 % If a .fmt file is being used, we don't want the `\input texinfo' to show up.
  10089 % That is what \eatinput is for; after that, the `\' should revert to printing
  10090 % a backslash.
  10091 %
  10092 @gdef@eatinput input texinfo{@fixbackslash}
  10093 @global@let\ = @eatinput
  10094 
  10095 % On the other hand, perhaps the file did not have a `\input texinfo'. Then
  10096 % the first `\' in the file would cause an error. This macro tries to fix
  10097 % that, assuming it is called before the first `\' could plausibly occur.
  10098 % Also turn back on active characters that might appear in the input
  10099 % file name, in case not using a pre-dumped format.
  10100 %
  10101 @gdef@fixbackslash{%
  10102   @ifx\@eatinput @let\ = @normalbackslash @fi
  10103   @catcode`+=@active
  10104   @catcode`@_=@active
  10105 }
  10106 
  10107 % Say @foo, not \foo, in error messages.
  10108 @escapechar = `@@
  10109 
  10110 % These (along with & and #) are made active for url-breaking, so need
  10111 % active definitions as the normal characters.
  10112 @def@normaldot{.}
  10113 @def@normalquest{?}
  10114 @def@normalslash{/}
  10115 
  10116 % These look ok in all fonts, so just make them not special.
  10117 % @hashchar{} gets its own user-level command, because of #line.
  10118 @catcode`@& = @other @def@normalamp{&}
  10119 @catcode`@# = @other @def@normalhash{#}
  10120 @catcode`@% = @other @def@normalpercent{%}
  10121 
  10122 @let @hashchar = @normalhash
  10123 
  10124 @c Finally, make ` and ' active, so that txicodequoteundirected and
  10125 @c txicodequotebacktick work right in, e.g., @w{@code{`foo'}}.  If we
  10126 @c don't make ` and ' active, @code will not get them as active chars.
  10127 @c Do this last of all since we use ` in the previous @catcode assignments.
  10128 @catcode`@'=@active
  10129 @catcode`@`=@active
  10130 @markupsetuplqdefault
  10131 @markupsetuprqdefault
  10132 
  10133 @c Local variables:
  10134 @c eval: (add-hook 'write-file-hooks 'time-stamp)
  10135 @c page-delimiter: "^\\\\message"
  10136 @c time-stamp-start: "def\\\\texinfoversion{"
  10137 @c time-stamp-format: "%:y-%02m-%02d.%02H"
  10138 @c time-stamp-end: "}"
  10139 @c End:
  10140 
  10141 @c vim:sw=2:
  10142 
  10143 @ignore
  10144    arch-tag: e1b36e32-c96e-4135-a41a-0b2efa2ea115
  10145 @end ignore