osl/autoconf/texinfo.tex

1 % texinfo.tex -- TeX macros to handle Texinfo files.
12 % This texinfo.tex file is free software: you can redistribute it and/or
17 % This texinfo.tex file is distributed in the hope that it will be
29 % Please try the latest version of texinfo.tex before submitting bug
31 %   http://www.gnu.org/software/texinfo/ (the Texinfo home page), or
32 %   ftp://tug.org/tex/texinfo.tex
34 % The texinfo.tex in any given distribution could well be out
37 % Send bug reports to bug-texinfo@gnu.org.  Please include including a
53 % It is possible to adapt texinfo.tex for other languages, to some
57 % The GNU Texinfo home page is http://www.gnu.org/software/texinfo.
60 \message{Loading texinfo [version \texinfoversion]:}
516 % Define the framework for environments in texinfo.tex.  It's used like this:
635 % max (\topskip - \ht (first item), 0).  If that height is large,
854     \wlog{texinfo.tex: doing @include of #1^^J}%
1040 % @setfilename is done at the beginning of every texinfo file.
1042 % This makes it possible to make a .fmt file for texinfo.
1044    \fixbackslash  % Turn off hack to swallow `\input texinfo'.
1053    % If texinfo.cnf is present on the system, read it.
1055    \openin 1 texinfo.cnf
1056    \ifeof 1 \else \input texinfo.cnf \fi
1779 % before you read in texinfo.tex.
2089 % texinfo doesn't allow for producing subscripts and superscripts except
2822   % make the texinfo accent commands work in math mode
2838 % to a command which sets the catcodes (such as @item or @section).
3466 % Tables -- @table, @ftable, @vtable, @item(x).
3470 % default indentation of @itemize and @enumerate text
3472 % margin between end of table item and start of table text.
3478 % Note @table, @ftable, and @vtable define @item, @itemx, etc., with
3481 % to index the item name in whatever manner is desired (perhaps none).
3497   % If the item text does not fit in the space we have, put it on a line
3514     % \parskip glue -- logically it's part of the @item we just started.
3520     % cause the example and the item to crash together.  So we use this
3528     % The item text fits into the space.  Start a paragraph, so that the
3532     % the item text, it can migrate to the main vertical list and
3543 \def\item{\errmessage{@item while not in a list environment}}
3593   \let\item = \internalBitem
3602 % This is the counter used by @enumerate, which is really @itemize
3618   % Try typesetting the item mark that if the document erroneously says
3621   % world, but it's better than leaving it to the @item.  This means if
3629   \let\item=\itemizeitem
3632 % Definition of @item while inside @itemize and @enumerate.
3641    % parskip, or the item text will crash with the heading.  On the
3642    % other hand, when there is normal text preceding the item (as there
3650    \vadjust{\penalty 1200}}% not good to break after first line of item.
3663 \envparseargdef\enumerate{\enumeratey #1  \endenumeratey}
3701 % An @enumerate whose labels are integers.  The starting integer is
3715       \errmessage{No more lowercase letters in @enumerate; get a bigger
3728       \errmessage{No more uppercase letters in @enumerate; get a bigger
3737 % \itemno, since @item increments \itemno.
3745 % to @enumerate.
3747 \def\alphaenumerate{\enumerate{a}}
3748 \def\capsenumerate{\enumerate{A}}
3767 %   @item ...
3776 %   @item ...
3779 % Each new table line starts with @item, each subsequent new column
3784 % @item, @tab do not need to be on their own lines, but it will not hurt
3790 %   @item first col stuff @tab second col stuff @tab third col
3791 %   @item
3797 %   @item first col stuff @tab second col stuff
3801 %   @item@tab@tab This will be in third column.
3878   \the\everytab % for the first item
3895   % @item within a multitable starts a normal row.
3897   % contains an @itemize, we don't choke on the \item (seen as \crcr aka
3899   \def\item{\crcr}%
3926   % To parse everything between @multitable and @item:
3971       % @item @code{#}
3990   % See bug-texinfo report from Werner Lemberg, 31 Oct 2004 12:52:20 +0100.
4067 { \catcode`_=11 % We want to use \_STOP_ which cannot appear in texinfo source.
4341   % help-texinfo, 22may06):
4759   % If \lastskip is nonzero, that means the last item was a
4762   % non-discardable item, therefore it is not a potential
4772     % If \lastskip was zero, perhaps the last item was a penalty, and
4775     % signals); since we just inserted a non-discardable item, any
4785     % this make-up glue would be preceded by a non-discardable item
5892   % discardable item.)  However, when a paragraph is not started next
5898   % This is so the last item on the main vertical list is a known
6660 % because texinfo's \verbatim doesn't stop at '\end{verbatim}':
6691     \wlog{texinfo.tex: doing @verbatiminclude of #1^^J}%
7212 % (as in normal texinfo). It is necessary to change the definition of \
9695   % your texinfo source file like this:
9782 \message{and turning on texinfo input format.}
9874 % In texinfo, backslash is an active character; it prints the backslash
9920 % If a .fmt file is being used, we don't want the `\input texinfo' to show up.
9924 @gdef@eatinput input texinfo{@fixbackslash}
9927 % On the other hand, perhaps the file did not have a `\input texinfo'. Then