gmp/doc/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]:}
289 % (\thissection) refers to the chapter (section) in effect at the top
306 % \topmark doesn't work for the very first chapter (after the title
308 % the mark with the chapter defs, unless the user sneaks in, e.g.,
310 % first @chapter.
534 % Define the framework for environments in texinfo.tex.  It's used like this:
1122   % make the texinfo accent commands work in math mode
1203 % @setfilename is done at the beginning of every texinfo file.
1205 % This makes it possible to make a .fmt file for texinfo.
1207    \fixbackslash  % Turn off hack to swallow `\input texinfo'.
1216    % If texinfo.cnf is present on the system, read it.
1218    \openin 1 texinfo.cnf
1219    \ifeof 1 \else \input texinfo.cnf \fi
1241 % adobe `portable' document format
1322 be supported due to the design of the PDF format; use regular TeX (DVI
1373     % pdftex (and the PDF format) support .png, .jpg, .pdf (among
1941 % before you read in texinfo.tex.
2094 % section, chapter, etc., sizes following suit.  This is for the GNU
2256 % texinfo doesn't allow for producing subscripts and superscripts except
2784 %  Textures 1.7.7 (preloaded format=plain 93.10.14)  (68K)  16 APR 2004 02:38
2966 % @evenheadingmarks top     \thischapter <- chapter at the top of a page
2967 % @evenheadingmarks bottom  \thischapter <- chapter at the bottom of a page
3012 % chapter name on inside top of right hand pages, document
3025 % For single-sided printing, chapter title goes across top left of page,
3059 % up a different format (e.g., txi-cs.tex does this).
3585   % See bug-texinfo report from Werner Lemberg, 31 Oct 2004 12:52:20 +0100.
3662 { \catcode`_=11 % We want to use \_STOP_ which cannot appear in texinfo source.
3933   % help-texinfo, 22may06):
4381 % It does not print any chapter heading (usually an @unnumbered).
4400     % and it loses the chapter title and the aux file entries for the
4566 % the manmac.tex format used to print the TeXbook itself.
4600   % format, but then we repeat the same computation.  Repeating a couple
4606   % changes automatically with the paper format.  The magic constant
4740 % outlines by their "section number".  We avoid collisions with chapter
4792 % Each @chapter defines these (using marks) as the number+name, number
4793 % and name of the chapter.  Page headings and footings can use
4805 % @raisesections: treat @section as chapter, @subsection as section, etc.
4809 % @lowersections: treat @chapter as section, @section as subsection, etc.
4820 % Trace whether the current chapter is an appendix or not:
4852 	\errmessage{@appendix... within a non-appendix chapter}%
4895 % @chapter, @appendix, @unnumbered.  Increment top-level counter, reset
4899 % (e.g., figures), q.v.  By default (before any chapter), that is empty.
4902 \outer\parseargdef\chapter{\numhead0{#1}} % normally numhead0 calls chapterzzz
4904   % section resetting is \global in case the chapter is in a group, such
4918   % So @section and the like are numbered underneath this chapter.
5048 % to what kind of chapter we are in (ordinary, appendix, or unnumbered).
5049 % Define them by default for a numbered chapter.
5056 % NOTE on use of \vbox for chapter headings, section headings, and such:
5087 % These macros generate a chapter, section, etc. heading only
5094 %%% Define plain chapter starts, and page on/off switching for it
5095 % Parameter controlling skip before chapter headings (if needed)
5102 % get the headings for the next chapter, which is wrong.  But we don't
5140 % Yappendix, Yomitfromtoc), #3 the chapter number.
5183   % Insert the chapter heading break.
5200     % Only insert the separating space if we have a chapter/appendix
5216     % Write the toc entry for this chapter.  Must come before the
5234   \nobreak\bigskip % no page break after a chapter title
5247 % I don't think this chapter style is supported any more, so I'm not
5414 % Called from @chapter, etc.
5425 % table of contents chapter openings themselves.
5459 % with the Texinfo input format setup at the end of this file.
5568 % Typeset the label for a chapter or appendix for the short contents.
5569 % The arg is, e.g., `A' for an appendix, or `3' for a chapter.
5578   % We'd like to right-justify chapter numbers, but that looks strange
5587 % The first argument is the chapter or section name.
5589 % The arguments in between are the chapter number, section number, ...
5665 % Space between chapter (or whatever) number and the title.
5885 %    @example, @display, @format, @lisp
5941 % @format/@smallformat: same as @display except don't narrow margins.
5943 \makedispenv{format}{%
5949 % @flushleft: same as @format, but doesn't obey \SETdispenvsize.
6149 % because texinfo's \verbatim doesn't stop at '\end{verbatim}':
6398   % How we'll format the type name.  Putting it in brackets helps
6637 % (as in normal texinfo). It is necessary to change the definition of \.
6966       % Use the actual chapter/section title appear inside
7502 % chapter-level command.
7547         % labels (which have a completely different output format) from
8740   % your texinfo source file like this:
8788 % Use @afourwide to print on A4 paper in landscape format.
8827 \message{and turning on texinfo input format.}
8923 % In texinfo, backslash is an active character; it prints the backslash
8957 % If a .fmt file is being used, we don't want the `\input texinfo' to show up.
8961 @gdef@eatinput input texinfo{@fixbackslash}
8964 % On the other hand, perhaps the file did not have a `\input texinfo'. Then
8968 % file name, in case not using a pre-dumped format.
8989 @c time-stamp-format: "%:y-%02m-%02d.%02H"