mpfr/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]:}
271 % (\thissection) refers to the chapter (section) in effect at the top
288 % \topmark doesn't work for the very first chapter (after the title
290 % the mark with the chapter defs, unless the user sneaks in, e.g.,
292 % first @chapter.
516 % Define the framework for environments in texinfo.tex.  It's used like this:
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
1078 % adobe `portable' document format
1132 be supported due to the design of the PDF format; use regular TeX (DVI
1189     % pdftex (and the PDF format) support .pdf, .png, .jpg (among
1779 % before you read in texinfo.tex.
1930 % section, chapter, etc., sizes following suit.  This is for the GNU
2089 % texinfo doesn't allow for producing subscripts and superscripts except
2822   % make the texinfo accent commands work in math mode
3137 % Use the ec* fonts (cm-super in outline format) for non-CM glyphs.
3170 %  Textures 1.7.7 (preloaded format=plain 93.10.14)  (68K)  16 APR 2004 02:38
3350 % @evenheadingmarks top     \thischapter <- chapter at the top of a page
3351 % @evenheadingmarks bottom  \thischapter <- chapter at the bottom of a page
3400 % chapter name on inside top of right hand pages, document
3413 % For single-sided printing, chapter title goes across top left of page,
3447 % up a different format (e.g., txi-cs.tex does this).
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):
4824 % It does not print any chapter heading (usually an @unnumbered).
4843     % and it loses the chapter title and the aux file entries for the
5015 % the manmac.tex format used to print the TeXbook itself.
5049   % format, but then we repeat the same computation.  Repeating a couple
5055   % changes automatically with the paper format.  The magic constant
5204 % outlines by their "section number".  We avoid collisions with chapter
5256 % Each @chapter defines these (using marks) as the number+name, number
5257 % and name of the chapter.  Page headings and footings can use
5269 % @raisesections: treat @section as chapter, @subsection as section, etc.
5273 % @lowersections: treat @chapter as section, @section as subsection, etc.
5284 % Trace whether the current chapter is an appendix or not:
5316 	\errmessage{@appendix... within a non-appendix chapter}%
5359 % @chapter, @appendix, @unnumbered.  Increment top-level counter, reset
5363 % (e.g., figures), q.v.  By default (before any chapter), that is empty.
5366 \outer\parseargdef\chapter{\numhead0{#1}} % normally numhead0 calls chapterzzz
5368   % section resetting is \global in case the chapter is in a group, such
5384   % So @section and the like are numbered underneath this chapter.
5528 % to what kind of chapter we are in (ordinary, appendix, or unnumbered).
5529 % Define them by default for a numbered chapter.
5536 % NOTE on use of \vbox for chapter headings, section headings, and such:
5566 % These macros generate a chapter, section, etc. heading only
5573 % Parameter controlling skip before chapter headings (if needed)
5576 % Define plain chapter starts, and page on/off switching for it.
5580 % get the headings for the next chapter, which is wrong.  But we don't
5617 % Yappendix, Yomitfromtoc), #3 the chapter number.
5666   % Insert the chapter heading break.
5683     % Only insert the separating space if we have a chapter/appendix
5699     % Write the toc entry for this chapter.  Must come before the
5717   \nobreak\bigskip % no page break after a chapter title
5730 % I don't think this chapter style is supported any more, so I'm not
5910 % Called from @chapter, etc.
5921 % table of contents chapter openings themselves.
5955 % with the Texinfo input format setup at the end of this file.
6065 % Typeset the label for a chapter or appendix for the short contents.
6066 % The arg is, e.g., `A' for an appendix, or `3' for a chapter.
6075   % We'd like to right-justify chapter numbers, but that looks strange
6084 % The first argument is the chapter or section name.
6086 % The arguments in between are the chapter number, section number, ...
6175 % Space between chapter (or whatever) number and the title.
6397 %    @example, @display, @format, @lisp
6454 % @format/@smallformat: same as @display except don't narrow margins.
6456 \makedispenvdef{format}{%
6462 % @flushleft: same as @format, but doesn't obey \SETdispenvsize.
6660 % because texinfo's \verbatim doesn't stop at '\end{verbatim}':
6691     \wlog{texinfo.tex: doing @verbatiminclude of #1^^J}%
6947   % How we'll format the category name.  Putting it in brackets helps
7212 % (as in normal texinfo). It is necessary to change the definition of \
7841       % Auto section-title: use chapter/section title inside
8419 % chapter-level command.
8464         % labels (which have a completely different output format) from
8713 % The language names to pass are determined when the format is built.
9695   % your texinfo source file like this:
9743 % Use @afourwide to print on A4 paper in landscape format.
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
9931 % file name, in case not using a pre-dumped format.
9969 @c time-stamp-format: "%:y-%02m-%02d.%02H"