groff/doc/texinfo.tex

23 % along with this texinfo.tex file; see the file COPYING.  If not, write
116 % Set up fixed words for English if not already set.
201 % surround any changed text.  This approach does *not* work if the
296   % the headline as they should be, not taken literally (outputting ''code).
307     \normalturnoffactive  % \ in index entries must not stay \, e.g., if
476   % therein should become regular spaces in the raw index file, not the
496 % are not treated as enviroments; they don't open a group.  (The
497 % implementation of @end takes care not to call \endgroup in this
523     not \inenvironment\thisenv}%
539     % The general wording of \badenverr may not be ideal, but... --kasal, 06nov03
673 % does not have much material.  In this case, it's better to add an
700 % \lineskip glue after it.  Thus, space below is not quite equal to space
732 % forces a page break if there is not space-in-mils remaining.
739 %% if the depth of the box does not fit.
761     % TeX does not even consider page breaks if a penalty added to the
770     % almost-but-not-quite fill up a page, TeX will have a hard time doing
771     % good page breaking, for example.)  However, I could not construct an
776     % Back up by the size of the box, whether we did a page break or not.
779     % Do not allow a page break right after this kern.
837 \def\parseinmargin#1,#2,#3\finish{% not perfect, but better than nothing.
975 % The paragraph indentation is suppressed or not by calling
998 % We also make \indent itself not actually do anything until the next
1042 % this is not advertised and we don't care.  Texinfo does not
1395 % For now, we do not accumulate font styles: @b{@i{foo}} prints foo in
1396 % italics, not bold italics.
1399   \def\curfontstyle{#1}% not as a control sequence, because we are \edef'd.
1413 % Texinfo sort of supports the sans serif font style, which plain TeX does not.
1417 \let\li = \sf % Sometimes we call it \li, not \sf.
1713 % unless the following character is such as not to need one.
1906 % rms does not like angle brackets --karl, 17may97.
1938 % and it is not used as such in any manual I can find.  We need it for
1996 % Hope not.
2010   % does not work for cmbx10 and other extended/shrunken fonts.
2204   % @evenfooting will not be used by itself.
2276 % Only define if not already defined, in case a txi-??.tex file has set
2327   % If the item text does not fit in the space we have, put it on a line
2328   % by itself, and do not allow a page break either before or after that
2329   % line.  We do not start a paragraph here because then if the next
2373 \def\item{\errmessage{@item while not in a list environment}}
2374 \def\itemx{\errmessage{@itemx while not in a list environment}}
2470    \vadjust{\penalty 1200}}% not good to break after first line of item.
2499     %   not equal to itself.
2533     % Be sure we're not beyond the end of the alphabet.
2546     % Be sure we're not beyond the end of the alphabet.
2604 % @item, @tab do not need to be on their own lines, but it will not hurt
2695 % line is not enough.  That is bad.  So let's go back to just `&' until
2772 	  % If user has not set preamble in terms of percent of \hsize
2800   % Compute \multitablelinespace (if not defined by user) for use in
2809 %% table. If not, do nothing.
2989     \message{Variable `#1', used in @value, is not set.}%
3007       #1% If not set, redefine \next.
3018 % above code: if the variable is not set, do nothing, if it is set,
3037 % except not \outer, so it can be used within macros and \if's.
3134   % words, not control letters, because the \space would be incorrect
3142   % those that do not.  If it is followed by {arg} in the input, then
3238   % Handle some cases of @value -- where it does not contain any
3242   % Normal spaces, not active ones.
3462 % But don't do any of this if we're not in vertical mode.  We
3468 % We'll have to check whether \lastskip is zero skip.  \ifdim is not
3474 % the ``p'' and ``t'' characters have catcode \other, not 11 (letter).
3489   % non-discardable item, therefore it is not a potential
3552 % It does not print any chapter heading (usually an @unnumbered).
3621   % Do our best not to break after the initial.
3645     % Do not fill out the last line with white space.
3651     % Do not prefer a separate line ending with a hyphen to fewer lines.
3661     % of each paragraph, so we need not do anything with that.
3685     % The following is kludged to not output a line of dots in the index if
3749     % Here is a possibility not foreseen in manmac: if we accumulate a
3835     % invocation ends.  Having called \balancecolumns once, we do not
3900 % letter in the expansion, not just typeset.
3930   % expanded while writing the .toc file.  \char\appendixno is not
3939 % However, they are not reliable, because we don't use marks.
3961 % Trace whether the current chapter is an appendix or not:
4095   % to be executed, not expanded).
4203 %          if justification is not attempted.  Hence \raggedright.
4321     % text, then jumping from the outline may wind up with the text not
4343 % I don't think this chapter style is supported any more, so I'm not
4436   % Do not let the kern be a potential breakpoint, as it would be if it
4803       % it's not a good place to break if the last penalty was \nobreak
4849   % Flag to tell @lisp, etc., not to narrow margin.
5123 % we need not redefine '\', '{' and '}'.
5199     % Similarly, after a section heading, do not allow a break.
5201     \medskip  % preceded by discardable penalty, so not a breakpoint
5214   % It's not a great place, though.
5234     % Some of the @defun-type tags do not enable magic parentheses,
5352 % \defname, which formats the name of the @def (not the args).
5357 % We are followed by (but not passed) the arguments, if any.
5384     % Intentionally do not respect \rightskip, since we need the space.
5397     % . this still does not fix the ?` and !` ligatures, but so far no
5410 % Print arguments in slanted roman (not ttsl), inconsistently with using
5412 % the argument list (groff manual), and ttsl and tt are not very
5416   % use sl by default (not ttsl),
5439 % if the fn name has parens in it, \boldbrax will not be in effect yet,
5541     % Append \endinput to make sure that TeX does not see the ending newline.
5677     \errmessage{Macro #1 not defined}%
5694 % an opening brace, and that opening brace is not consumed.
5798 % {.  If so it reads up to the closing }, if not, it reads the whole
5807 % We want to disable all macros during \shipout so that they are not
5813 % arguments (if present).  Of course this is not nearly correct, but it
5814 % is the best we can do for now.  makeinfo does not expand macros in the
5820 % goes to end-of-line is not handled.
5854 % cross-references.  The @node line might or might not have commas, and
5855 % might or might not have spaces before the first comma, like:
5896 % floats, there is an additional part, which is not written here:
6000     % If we use \unhbox0 and \unhbox1 to print the node names, TeX does not
6002     % not find a line break at a hyphen in a node names.  Since some manuals
6079     % If not defined, say something at least.
6167   % that is not enough: for node names that actually contain a ^
6170   % argument, and \hat is not an expandable control sequence.  It could
6199   % should not typeset properly.  But it works, so I'm moving on for
6257 % Don't bother with the trickery in plain.tex to not require the
6283   % to exdent this text, so make it be a no-op.  makeinfo does not use
6285   % text after an @example or the like (not that this is good style).
6309 % Deeper inside, just make sure that the saved insertions are not spilled
6363 % If epsf.tex is not installed and @image is used, we complain.
6370   % Do not bother showing banner with epsf.tex v2.7k (available in
6387       \errmessage{epsf.tex not found, images will be ignored}%
6442 % this float will not be numbered and cannot be referred to.
6594 % Append the tokens #2 to the definition of macro #1, not expanding either.
6678 % Figures without xref labels will not be included in the list (since
6698 % @setfilename.  If done too late, it may not override everything
6956 % this is not a problem.
7037 % the literal character `\'.  (Thus, \ is not expandable when this is in
7053 % On the other hand, perhaps the file did not have a `\input texinfo'. Then
7057 % file name, in case not using a pre-dumped format.
7065 % Say @foo, not \foo, in error messages.
7068 % These look ok in all fonts, so just make them not special.