mpc/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
44 %   tex foo.texi
46 %   tex foo.texi
47 %   tex foo.texi
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]:}
62 % If in a .fmt file, print the version number
72 % For @tex, we can use \tabalign.
75 % Save some plain tex macros whose names we will redefine.
102 \global\let\ptexquoteright'}% Math-mode def from plain.tex.
537 % Define the framework for environments in texinfo.tex.  It's used like this:
744 % percent of a page (\vfilllimit can be changed inside of @tex).
1116 % FYI, plain.tex uses \\ as a temporary control sequence (why?), but
1124   \tex
1128   % make the texinfo accent commands work in math mode
1140 \def\finishmath#1{#1$\endgroup}  % Close the group opened by \tex.
1211 % @setfilename is done at the beginning of every texinfo file.
1213 % This makes it possible to make a .fmt file for texinfo.
1215    \fixbackslash  % Turn off hack to swallow `\input texinfo'.
1224    % If texinfo.cnf is present on the system, read it.
1226    \openin 1 texinfo.cnf
1227    \ifeof 1 \else \input texinfo.cnf \fi
1335   % Color manipulation macros based on pdfcolor.tex,
1337   % very dark gray on-screen and a very dark halftone in print, instead
1447   % by default, use a color that is dark enough to print on paper as
1964 % before you read in texinfo.tex.
2259   % Set \globaldefs so that documents can use this inside @tex, since
2275 % texinfo doesn't allow for producing subscripts and superscripts except
2416 \newif\ifmarkuptex % @tex (and part of @math, for now).
2798 % We print this one point size smaller, since it's intended for
2825 % @point{}, @result{}, @expansion{}, @print{}, @equiv{}.
2834 \def\print{\leavevmode\lower.1ex\hbox to 1em{\hfil$\dashv$\hfil}}
2868 % It is available from http://www.ctan.org/tex-archive/fonts/eurosym.
2978 % Adapted from the plain.tex definition of \copyright.
3031     % No rule at page bottom unless we print one at the top with @title.
3091   % print a rule at the page bottom also.
3262 % Only define if not already defined, in case a txi-??.tex file has set
3263 % up a different format (e.g., txi-cs.tex does this).
3806   % See bug-texinfo report from Werner Lemberg, 31 Oct 2004 12:52:20 +0100.
3883 { \catcode`_=11 % We want to use \_STOP_ which cannot appear in texinfo source.
4045 % Define \newwrite to be identical to plain tex's \newwrite
4137   % Need these in case \tex is in effect and \{ is a \delimiter again.
4153   % Sample source (mac-idx3.tex, reported by Graham Percival to
4154   % help-texinfo, 22may06):
4267   \definedummyword\print
4366   % Likewise with the other plain tex font commands.
4416   \def\print{-|}%
4481       % so it will be output as is; and it will print as backslash.
4613 % It does not print any chapter heading (usually an @unnumbered).
4775 % Like plain.tex's \dotfill, except uses up at least 1 em.
4798 % the manmac.tex format used to print the TeXbook itself.
4814     % runs and this will be a no-op.  See the indexspread.tex test case.
5094   % Now print the heading:
5442     % number, and don't print the unnumbered ``number''.
5709 % These characters do not print properly in the Computer Modern roman
5932 % @tex ... @end tex    escapes into raw Tex temporarily.
5933 % One exception: @ is still an escape character, so that @end tex works.
5934 % But \@ or @@ will get a plain tex @ character.
5936 \envdef\tex{%
5937   \setupmarkupstyle{tex}%
6213 % justification.  From plain.tex.
6326   % print special symbols as themselves, and
6363   % print special symbols as themselves, and
6391 % because texinfo's \verbatim doesn't stop at '\end{verbatim}':
6653   % (plain.tex says that \dimen1 should be used only as global.)
6705 % We want ()&[] to print specially on the defun line.
6737     % At the first level, print parens in roman,
6880 % (as in normal texinfo). It is necessary to change the definition of \.
7261     % If the user specified the print name (third arg) to the ref,
7262     % print it instead of our usual "Figure 1.2".
7277     % If we use \unhbox0 and \unhbox1 to print the node names, TeX does not
7547 % Don't bother with the trickery in plain.tex to not require the
7652 % @image.  We use the macros from epsf.tex to support this.
7653 % If epsf.tex is not installed and @image is used, we complain.
7655 % Check for and read epsf.tex up front.  If we read it only at @image
7658 \openin 1 = epsf.tex
7660   % Do not bother showing banner with epsf.tex v2.7k (available in
7661   % doc/epsf.tex and on ctan).
7663   \input epsf.tex
7667 % We will only complain once about lack of epsf.tex.
7669 \newhelp\noepsfhelp{epsf.tex must be installed for images to
7671   it from ftp://tug.org/tex/epsf.tex.}
7677       \errmessage{epsf.tex not found, images will be ignored}%
7844     % If we have anything to print, print it, with space before.
7942 % @listoffloats FLOATTYPE - print a list of floats like a table of contents.
8002   \tex % read txi-??.tex file in plain TeX.
8004     \openin 1 txi-#1.tex
8009       \input txi-#1.tex
8015 % If they passed de_DE, and txi-de_DE.tex doesn't exist,
8016 % try txi-de.tex.
8019   \openin 1 txi-#1.tex
8022     \errmessage{Cannot read language file txi-#1.tex}%
8025     \input txi-#1.tex
8035 % This macro is called from txi-??.tex files; the first argument is the
9011 % Use @afourpaper to print on European A4 paper.
9021   % your texinfo source file like this:
9022   % @tex
9025   % @end tex
9037 % Use @afivepaper to print on European A5 paper.
9069 % Use @afourwide to print on A4 paper in landscape format.
9108 \message{and turning on texinfo input format.}
9133 % This macro is used to make a character print one way in \tt
9137 % #1 is what to print if we are indeed using \tt; #2 is what to print
9152 % Most of these we simply print from the \tt font, but for some, we can
9207 % In texinfo, backslash is an active character; it prints the backslash
9243 % If a .fmt file is being used, we don't want the `\input texinfo' to show up.
9247 @gdef@eatinput input texinfo{@fixbackslash}
9250 % On the other hand, perhaps the file did not have a `\input texinfo'. Then