bash-3.2/doc/texinfo.tex

1 % texinfo.tex -- TeX macros to handle Texinfo files.
11 % This texinfo.tex file is free software; you can redistribute it and/or
16 % This texinfo.tex file is distributed in the hope that it will be
22 % along with this texinfo.tex file; see the file COPYING.  If not, write
30 % Please try the latest version of texinfo.tex before submitting bug
32 %   ftp://ftp.gnu.org/gnu/texinfo/texinfo.tex
34 %   ftp://tug.org/tex/texinfo.tex
36 %   and /home/gd/gnu/doc/texinfo.tex on the GNU machines.
38 % The GNU Texinfo home page is http://www.gnu.org/software/texinfo.
40 % The texinfo.tex in any given Texinfo distribution could well be out
43 % Send bug reports to bug-texinfo@gnu.org.  Please include including a
59 % It is possible to adapt texinfo.tex for other languages, to some
63 \message{Loading texinfo [version \texinfoversion]:}
204 % we did was a \nobreak, we don't want to insert more space.
613     % lines in the input in @example-like environments, which normally
614     % just turn into \lisppar, which will insert no space now that we've
758     % if you have multiple lines of stuff to put here, you'll need to
794 % @include file    insert text of that file as input.
828 % @sp n   outputs n lines of vertical space
951 % @setfilename is done at the beginning of every texinfo file.
953 % This makes it possible to make a .fmt file for texinfo.
959    \fixbackslash  % Turn off hack to swallow `\input texinfo'.
962    % If texinfo.cnf is present on the system, read it.
965    \openin 1 texinfo.cnf
966    \ifeof1 \let\temp=\relax \else \def\temp{\input texinfo.cnf }\fi
1208 % before you read in texinfo.tex.
1336 % texinfo doesn't allow for producing subscripts and superscripts except
1976     % to \aboveenvbreak to insert \parskip glue after all.
2118     % We need the \relax at the end of the \ifnum lines to stop TeX from
2207 % Table can continue over pages but will only break between lines.
2241 % own lines, but it will not hurt if they are.
2416 %% to keep lines equally spaced
2422 %% Test to see if parskip is larger than space between lines of
2428                                       %% than skip between lines in the table.
2433                                       %% than skip between lines in the table.
2437 % text to a box and make the \insert when a row of the table is
2452     \noalign{\insert\footins{\box\savedfootnotes}}%
2614   % this texinfo.tex file).  We change the catcode of @ below to match.
2745 % empty), we can't just use \parsearg; we have to insert a space of our
3215     \insert\margin{\hbox{\vrule height8pt depth3pt width0pt #2}}%
3293 % containing these kinds of lines:
3377   % We like breaks before the index initials, so insert a bonus.
3410   % Do not prefer a separate line ending with a hyphen to fewer lines.
3417   % lines.  So we use a small indentation and put up with long leaders.
4104     % Only insert the separating space if we have a section number.
4461 % start of the next paragraph will insert \parskip.
4552   \let\par = \lisppar % don't ignore blank lines
4770 % because texinfo's \verbatim doesn't stop at '\end{verbatim}':
4799 % @verbatiminclude FILE - insert text of file in verbatim environment.
4846   % \ is the escape char in this texinfo.tex file, so it is the
4867 % Our approach is to make ^^M insert a space and a penalty1 normally;
5006   % Allow all lines to be underfull without complaint:
5026   % commands insert a \penalty10000, and we don't want to allow a break
5543 % (as in normal texinfo). It is necessary to change the definition of \.
5655 % unexpandable, insert that wherever you need a #, and then redefine
5783   node \samp{\ignorespaces#1{}}}
5785 % @node's job is to define \lastnode.
5786 \def\node{\ENVcheck\parsearg\nodezzz}
5789 \let\nwnode=\node
5822 % \setref{NAME}{SNT} defines a cross-reference point NAME (a node or an
5832 % and backslash work in node names.
5845 % the node name, #2 the name of the Info cross-reference, #3 the printed
5846 % node name, #4 the name of the Info file, #5 the name of the printed
5847 % manual.  All but the node name can be omitted.
5859     % No printed node name was explicitly given.
5861       % Use the node name inside the square brackets.
5874           % Otherwise just copy the Info node name.
5881   % If we use \unhbox0 and \unhbox1 to print the node names, TeX does not
5882   % insert empty discretionaries after hyphens, which means that it will
5883   % not find a line break at a hyphen in a node names.  Since some manuals
5884   % are best written with fairly long node names, containing hyphens, this
5885   % is a loss.  Therefore, we give the text of the node name again, so it
5906     % control sequence corresponding to the node, but it has to expand
6040   % in xref tags, i.e., node names.  But since ^^e4 notation isn't
6042   % that is not enough: for node names that actually contain a ^
6145 \gdef\startfootins{\insert\footins\bgroup}
6188 % change spans more than two lines of output.  To handle that, we would
6198     % We want to insert a rule with the height and depth of the current
6268     % Usually we'll have text after the image which will insert
6269     % \parskip glue, so insert it here too to equalize the space
6431   % your texinfo source file like this:
6519 \message{and turning on texinfo input format.}
6650 % If a .fmt file is being used, we don't want the `\input texinfo' to show up.
6654 @gdef@eatinput input texinfo{@fixbackslash}
6657 % On the other hand, perhaps the file did not have a `\input texinfo'. Then