12 % This texinfo.tex file is free software; you can redistribute it and/or
35 %     (and all CTAN mirrors, see http://www.ctan.org).
52 % Sometimes one run after texindex suffices, and sometimes you need more
65 % and turn on active characters that we couldn't do earlier because
204 % vertical list for the beginning and end of each change).
212     % We want to insert a rule with the height and depth of the current
223       % This is the space between the bar and the text.
230 % and nothing on the terminal.  We don't just call \tracingall here,
417 % This space token undergoes the same procedure and is eventually removed
437 % We prepended an \empty token at the very beginning and we expand it now,
556 % and you can use @w{...} around a quote to suppress ligatures.
557 %% Define @` and @' to be the same as ` and '
568   % Definitions to produce \{ and \} commands for indices,
569   % and @{ and @} for the aux file.
598 % Dotless i and dotless j, used for accents.
617 % the \scriptstyle font (since we don't reset \scriptstyle and
630 % at the beginning of a line will start with \penalty -- and
668 % therefore, no glue is inserted, and the space between the headline and
698 % The \vtop produces a box with normal height and large depth; thus, TeX puts
699 % \baselineskip glue before it, and (when the next line of text is done)
704     % and the first line afterwards, we have to propagate \prevdepth.
712   % if the group doesn't fit on the current page, and it's a big big
784 % @br   forces paragraph break (and is undocumented).
977 % We switch the definition of this back and forth according to WORD.
996 % \kern backwards by \parindent, and then reset itself to empty.
1031 % _ active, and distinguish by seeing if the current family is \slfam,
1040 % Another complication: we want \\ (and @\) to output a \ character.
1042 % this is not advertised and we don't care.  Texinfo does not
1074 % @bullet and @minus need the same treatment as @math, just above.
1107 % be able to disable indexing, cross-referencing, and contents, for test runs.
1167 % can be set).  So we test for \relax and 0 as well as \undefined,
1425 % Set the baselineskip to #1, and the lineskip and strut size
1485 % A few fonts for @defun names and args.
1532 % Chapter (and unnumbered) fonts (17.28pt).
1584 % In order for the font changes to affect most math symbols and letters,
1586 % texinfo doesn't allow for producing subscripts and superscripts except
1587 % in the main text, we don't bother to reset \scriptfont and
1602 % and \lllsize (three sizes lower).  These relative commands are used in
1603 % the LaTeX logo and acronyms.
1710 %% serif) and @ii for TeX italic
1748 % Can't use plain's \frenchspacing because it uses the `\x notation, and
1802 % We *must* turn on hyphenation at `-' and `_' in @code.
1807 % both hyphenation at - and hyphenation within words.
1809 % and arrange explicitly to hyphenate at a dash.
1826   % is "active" (mathcode"8000) and \normalunderscore (or \char95, etc.)
1841 %   `example' (@kbd uses ttsl only inside of @example and friends),
1875 % second argument specifying the text to display and an optional third
1893         \unhbox0\ (\code{#1})% DVI: 2nd arg given, show both it and url
1924 % Computer Modern typewriter fonts have zero interword stretch (and
1925 % shrink), and it is reasonable to expect all typewriter fonts to have
1938 % and it is not used as such in any manual I can find.  We need it for
1947 % @acronym for "FBI", "NATO", and the like.
1960 % @abbr for "Comput. J." and the like.
1978 % Theiling, which support regular, slanted, bold and bold slanted (and
2002   % \textfonts and the other font-switching commands, so that
2009   % By the way, simply using "at 1em" works for cmr10 and the like, but
2010   % does not work for cmbx10 and other extended/shrunken fonts.
2090     % because the headline and footline are only empty inside the group.
2157 %%% Set up page headings and footings.
2220 % and turned `on' after @end titlepage.
2231 % title on inside top of left hand pages, and page numbers on outside top
2300 % default indentation of @itemize and @enumerate text
2302 % margin between end of table item and start of table text.
2308 % Note @table, @ftable, and @vtable define @item, @itemx, etc., with
2328   % by itself, and do not allow a page break either before or after that
2334     % Make this a paragraph so we get the \parskip glue and wrapping,
2350     % cause the example and the item to crash together.  So we use this
2361     % Do this with kerns and \unhbox so that if there is a footnote in
2362     % the item text, it can migrate to the main vertical list and
2453 % Definition of @item while inside @itemize and @enumerate.
2460    % \nobreak will be last on the list, and \sectionheading will have
2475 % TOKENS, and \rest to be the remainder.
2498     % An ``uppercase letter'' is one whose \lccode is both nonzero, and
2555 % Call \doitemize, adding a period to the first argument and supplying the
2564 % @alphaenumerate and @capsenumerate are abbreviations for giving an arg
2739   % To parse everything between @multitable and @item:
2744   % \vtop will set a single line and will also let text wrap and
2761       % use that dimension as the width of the column, and the \leftskip
2763       % left margin and final column will justify at right margin.
2779       % Ignoring space at the beginning and end avoids an occasional spurious
2842 % Ignore @ignore, @ifhtml, @ifinfo, and the like.
2932 % own to delimit the rest of the line, and then take it out again if we
2998 % To get special treatment of `@end ifset,' call \makeond and the redefine.
3037 % except not \outer, so it can be used within macros and \if's.
3104 %  and it is "foo", the name of the index.
3120 % Since there are some commands we want to expand, and others we don't,
3126   % Need these in case \tex is in effect and \{ is a \delimiter again.
3127   % But can't use \lbracecmd and \rbracecmd because texindex assumes
3128   % braces and backslashes are used only as delimiters.
3141   % These can be used both for control words that take an argument and
3180 % Called from \indexdummies and \atdummies.  \definedummyword and
3249 % \commondummiesnofonts: common to \commondummies and \indexnofonts.
3255     % Control letters and accents.
3311 % by, and when constructing control sequence names.  It eliminates all
3312 % control sequences and just writes whatever the best ASCII sort string
3330   % and is used in the definitions of the active chars like <, >, |, etc.
3427       % so it will be output as is; and it will print as backslash.
3436   % Set up the complete index entry, with both the sort key and
3463 % don't want to do a \vskip and prematurely end a paragraph.
3469 % sufficient for this purpose, as it ignores stretch and shrink parts
3474 % the ``p'' and ``t'' characters have catcode \other, not 11 (letter).
3481   % \lastskip and \lastpenalty cannot both be nonzero simultaneously.
3499     % If \lastskip was zero, perhaps the last item was a penalty, and
3509     % and the "Description." paragraph.
3523 % The texindex program reads in these files and writes files
3561   % See if the index file exists and is nonempty.
3570     % and it loses the chapter title and the aux file entries for the
3626 % \entry typesets a paragraph consisting of the text (#1), dot leaders, and
3628 % and table of contents entries.  The paragraph is indented by \leftskip.
3632 % But this frozes the catcodes in the argument, and can cause problems to
3654     % \hangindent is only relevant when the entry text and page number
3658     % lines.  So we use a small indentation and put up with long leaders.
3696       % If we must, put the page number on a line of its own, and fill out
3755     % runs and this will be a no-op.  See the indexspread.tex test case.
3772   % routine, in each of @smallbook, @afourpaper, and the default 8.5x11
3817 % followed by the two boxes we just split, in box0 and box2.
3938 % page headings and footings can use it.  @section does likewise.
4059   % So @section and the like are numbered underneath this chapter.
4195 % Define @majorheading, @heading and @subheading
4197 % NOTE on use of \vbox for chapter headings, section headings, and such:
4202 %       3) Likewise, headings look best if no \parindent is used, and
4232 %%% Args are the skip and penalty (usually negative)
4235 %%% Define plain chapter starts, and page on/off switching for it
4287     % number, and don't print the unnumbered ``number''.
4315     % entry, and \donoderef resets it to empty.
4334 % @centerchap -- centered and unnumbered.
4367 % Section titles.  These macros combine the section number parts and
4406       % and don't redefine \thissection.
4463 % We append the current node name (if any) and page number as additional
4496   % 1 and 2 (the page numbers aren't printed), and so are the first
4498   % `1', and two named `2'.
4509   % If @setchapternewpage on, and @headings double, the contents should
4593   % This space should be enough, since a single number is .5em, and the
4600   % with appendix letters.  And right-justifying numbers and
4616 % See comments in \dochapentry re vbox and related settings.
4622 % Need the word Appendix, and a fixed-size box.
4654 % Now for the actual typesetting. In all these, #1 is the text and #2 is the
4686 % Space between chapter (or whatever) number and the title.
4782 % This is the definition that ^^M gets inside @lisp, @example, and other
4787 % This space is always present above and below environments.
4790 % Make spacing and below environment symmetrical.  We use \parskip here
4796   % =10000 instead of <10000 because of a special case in \itemzzz and
4846 				% side, and for 6pt waste from
4847 				% each corner char, and rule thickness
4919 % We often define two environments, @foo and @smallfoo.
4936 % @smallexample and @smalllisp: use smaller fonts.
4981 % and narrows the margins.  We keep \parskip nonzero in general, since
4982 % we're doing normal filling.  So, when using \aboveenvbreak and
5020 % LaTeX-like @verbatim...@end verbatim and @verb{<char>...<char>}
5041 % Disable Spanish ligatures ?` and !` of \tt font
5055   \tt  % easiest (and conventionally used) font for verbatim
5060   % print special symbols as themselves, and
5088   % Easiest (and conventionally used) font for verbatim
5094   % print special symbols as themselves, and
5123 % we need not redefine '\', '{' and '}'.
5135   % without the active space; thus we have to use \xdef and \gobble.
5163 % beforehand -- and a) we want @copying to be done first in the source
5194     % commands also insert a nobreak penalty, and we don't want to allow
5195     % a break between a section heading and a defun.
5233     \penalty 10002  % signal to \startdefun and \dodefunx
5242 % \makedefun{deffn} creates \deffn, \deffnx and \Edeffn;
5254 % Define \deffn and \deffnx, without parameters.
5360   % Get the values of \leftskip and \rightskip as they were outside the @def...
5396     % . we don't want -- and --- to be treated as ligatures.
5397     % . this still does not fix the ?` and !` ligatures, but so far no
5412 % the argument list (groff manual), and ttsl and tt are not very
5464     % the contained text.  This is especially needed for [ and ] .
5532     % Undo catcode changes of \startcontents and \doprintindex
5538     % ... and \example
5543     % I've verified that it is necessary both for e-TeX and for ordinary TeX
5571 % Trim leading and trailing spaces off a string.
5594 % body, and then making it the \newlinechar in \scanmacro.
5643   \getargs{#1}%           now \macname is the macname and \argl the arglist
5694 % an opening brace, and that opening brace is not consumed.
5700 % Parse the optional {params} list.  Set up \paramno and \paramlist
5707 % unexpandable, insert that wherever you need a #, and then redefine
5724 % These two commands read recursive and nonrecursive macro bodies.
5725 % (They're different since rec and nonrec macros end differently.)
5732 % This defines the macro itself. There are six cases: recursive and
5733 % nonrecursive macros of zero, one, and many arguments.
5815 % argument to @deffn, which ends up writing an index entry, and texindex
5829 % sign.  Just make them active and then expand them all to nothing.
5854 % cross-references.  The @node line might or might not have commas, and
5891 % 2) NAME-snt   - section number and type, passed as the SNT arg, or
5895 % This is called from \donoderef, \anchor, and \dofloat.  In the case of
5918 % @xref, @pxref, and @ref generate cross-references.  For \xrefX, #1 is
6000     % If we use \unhbox0 and \unhbox1 to print the node names, TeX does not
6016        % @unnumbered and @anchor, it won't be.
6023       % But we always want a comma and a space:
6107     % it was a float, and we have the (safe) float type in \iffloattype.
6169   % b-title}{'hat b} and \xrdef does a \csname...\endcsname on the first
6170   % argument, and \hat is not an expandable control sequence.  It could
6175   % and then to call \auxhat in \setq.
6194   % This is to support \ in node names and titles, since the \
6196   % leaving it active and making its active definition an actual \
6198   % of the xrdef.  Seems like it should be a catcode12 \, and that
6213   % @ is our escape character in .aux files, and we need braces.
6260 % Oh yes, they do; otherwise, @ifset (and anything else that uses
6301 % In case a @footnote appears in a vbox, save the footnote text and create
6305 % text to a box and make the \insert when a row of the table is finished.
6320 % This \insert replacement works for both \insert\footins{foo} and
6363 % If epsf.tex is not installed and @image is used, we complain.
6365 % Check for and read epsf.tex up front.  If we read it only at @image
6366 % time, we might be inside a group, and then its definitions would get
6367 % undone and the next image would fail.
6371   % doc/epsf.tex and on ctan).
6411     % above and below.
6437 % There may be a space before second and/or third parameter; delete it.
6442 % this float will not be numbered and cannot be referred to.
6497         % node and anchor labels.  And \xrdef uses it to construct the
6608 % going to use.  Create it if it doesn't exist and assign it to \floatno.
6675 % aux file.  We strip off the -title and look up \XRLABEL-lof, which
6685   % page number, and we want to fully expand that so we can get a link
6689   % use the same \entry macro we use to generate the TOC and index.
6695 % and i18n.
6739 % Following George Bush, just get rid of widows and orphans.
6829   % prints double-sided nicely when \bindingoffset=10mm and \hoffset=-6mm.
6831   % \normaloffset until the front-side and back-side texts align.  Then
6851 % He also recommends making @example and @lisp be small.
6893 % and/or leading, also. Or perhaps we should compute them somehow.
6920 \message{and turning on texinfo input format.}
6943 % (where it can probably be output as-is), and another way in other fonts,
6948 % interword stretch (and shrink), and it is reasonable to expect all
6955 % italic fonts.  But since this is only used by $ and it uses \sl anyway
6960 % (and those which the user can use as if they were ordinary).
6993 % So turn them off again, and have \everyjob (or @setfilename) turn them on.
7042 % Make _ and + \other characters, temporarily.

Indexes created Mon Jul 15 19:46:26 MDT 2024