38 % complete document in each bug report with which we can reproduce the
63 % and turn on active characters that we couldn't do earlier because
72 % For @tex, we can use \tabalign.
75 % Save some plain tex macros whose names we will redefine.
106 % messages, but if we're using an old version of TeX, don't do anything.
154 % Since the category of space is not known, we have to be careful.
158 % sometimes characters are active, so we need control sequences.
202 % change spans more than two lines of output.  To handle that, we would
257 % we did was a \nobreak, we don't want to insert more space.
281 % We dump everything together because we only have one kind of mark.
282 % This works because we only use \botmark / \topmark, not \firstmark.
306 % page or the contents), so we use \firstmark there -- this gets us
347     % Have to do this stuff outside the \shipout because we want it to
439 % the input line (except we remove a trailing comment).  #1 should be a
485 % to get _exactly_ the rest of the line, we had to prevent such situation.
486 % We prepended an \empty token at the very beginning and we expand it now,
488 % (Similarily, we have to think about #3 of \argcheckspacesY above: it is
492 % But first, we have to remove the trailing space token.
559 % Check whether we're in the right environment:
664 % latex.ltx, since we use a different font for the raised A; it's most
666 % the \scriptstyle font (since we don't reset \scriptstyle and
677 % Be sure we're in horizontal mode when doing a tie, since we make space
680 % since \penalty is valid in vertical mode, we'd end up putting the
753     % Do @comment since we are called inside an environment such as
758     % manual), we don't worry about eating any user text.
768     % and the first line afterwards, we have to propagate \prevdepth.
810   % Ensure vertical mode, so we don't make a big box in the middle of a
827     % empty box we just added fits on the page, we must make it consider
828     % page breaks.  On the other hand, we don't want to actually break the
829     % page after the empty box.  So we use a penalty of 9999.
837     % document, then we can reconsider our strategy.
840     % Back up by the size of the box, whether we did a page break or not.
1042 % By default, we suppress indentation.
1059 % Here is how we actually suppress indentation.  Redefine \everypar to
1104 % Another complication: we want \\ (and @\) to output a \ character.
1106 % this is not advertised and we don't care.  Texinfo does not
1183 \newif\iflinks \linkstrue % by default we want the aux files.
1187 % So open here the files we need to have open while reading the input.
1240 % can be set).  So we test for \relax and 0 as well as \undefined,
1254 % for display in the outlines, and in other places.  Thus, we have to
1260 % that's what we do).
1270 % To handle parens, we must adopt a different approach, since parens are
1482       % use \def rather than \let here because we redefine \chapentry et
1496       % subentries, which we calculated on our first read of the .toc above.
1509       % document fonts.  Therefore we cannot use special characters,
1514       % xx to do this right, we have to translate 8-bit characters to
1516       % now, I guess we'll just let the pdf reader have its way.
1541       % it seems we really need yet another set of dummies; have not
1592 % For now, we do not accumulate font styles: @b{@i{foo}} prints foo in
1596   \def\curfontstyle{#1}% not as a control sequence, because we are \edef'd.
1611 % So we set up a \sf.
1614 \let\li = \sf % Sometimes we call it \li, not \sf.
2219   % makeinfo 4.8 does not support it, but we need it nonetheless.
2233 % we have to define the \textfont of the standard families.  Since
2235 % in the main text, we don't bother to reset \scriptfont and
2325 % About \smallexamplefonts.  If we use \smallfonts (9pt), @smallexample
2328 % If we use \scriptfonts (8pt), then we can fit this many characters:
2340 % Set up the default fonts, so we can use them for creating boxes.
2372 % ttsl for book titles, do we?
2594 % So now @email is just like @uref, unless we are pdf.
2610 % Check if we are currently using a typewriter font.  Since all the
2613 % this property, we can check that font parameter.
2666 % "outlined" (blackboard board, sort of) versions, which we don't need).
2669 % Although only regular is the truly official Euro symbol, we ignore
2682 % Also doesn't work in math.  Do we need to do math with euro symbols?
2693   % There is only one designed size (nominal 10pt), so we always scale
2712 % use \let for the aliases, because sometimes we redefine the original
2726   % quotes to documents typeset with CM, where we lose kerning), so
2741 % be smaller yet, but lllsize is the best we can do for now.
2756 % so we'll define it if necessary.
2789   % Open one extra group, as we want to close it in the middle of \Etitlepage.
2794     % No rule at page bottom unless we print one at the top with @title.
2816     % If we use the new definition of \page, we always get a blank page
2817     % after the title page, which we certainly don't want.
2980 % When we turn headings on, set the page number to 1.
3079   % If the item text does not fit in the space we have, put it on a line
3086     % Make this a paragraph so we get the \parskip glue and wrapping,
3095     % We're going to be starting a paragraph, but we don't want the
3096     % \parskip glue -- logically it's part of the @item we just started.
3101     % \parskip glue; then the negative vskip we just inserted would
3102     % cause the example and the item to crash together.  So we use this
3145       that we are \inenvironment\thisenv}%
3213    % done a \vskip-\parskip.  In that case, we don't want to zero
3216    % usually is), we do want to zero parskip, or there would be too much
3217    % space.  In that case, we won't have a \nobreak before.  At least
3237   % If we were given no argument, pretend we were given `1'.
3243   % (We will always have one token, because of the test we just made.
3252     % Otherwise, we assume it's a number.
3258       \numericenumerate % a number (we hope)
3285     % Be sure we're not beyond the end of the alphabet.
3298     % Be sure we're not beyond the end of the alphabet.
3430       % we'll always have a period there to be parsed.
3441 % @headitem starts a heading row, which we typeset in bold.
3442 % Assignments have to be global since we are inside the implicit group
3448 % we encounter the problem it was intended to solve again.
3462   % contains an @itemize, we don't choke on the \item (seen as \crcr aka
3506       % we will add a \leftskip of \multitablecolspace to all columns after
3509       % If a template has been used, we will add \multitablecolspace
3512       % If the user has set preamble in terms of percent of \hsize we will
3517       % Make sure we don't inherit \rightskip from the outer environment.
3525 	  % we will advance \hsize by \multitablecolspace.
3528        % In either case we will make \leftskip=\multitablecolspace:
3578 % @ifnotxml always succeed.  They currently do nothing; we don't
3579 % attempt to check whether the conditionals are properly nested.  But we
3625   % Count number of #1's that we've seen.
3628   % Swallow text until we reach the matching `@end #1'.
3643     % line.  (Otherwise, we would consider a line `@c @ifset', for
3659     % If we're here, #1 ends with ^^M\ifinfo (for example).
3688 % Since we want to separate VAR from REST-OF-LINE (which might be
3689 % empty), we can't just use \parsearg; we have to insert a space of our
3690 % own to delimit the rest of the line, and then take it out again if we
3729     % ..., but we might end up with active ones in the argument if
3730     % we're called from @code, as @code{@value{foo-bar_}}, though.
3736 % We have this subroutine so that we can handle at least some @value's
3737 % properly in indexes (we call \makevalueexpandable in \indexdummies).
3741 % it will fail (although perhaps we could fix that with sufficient work
3845   % Only do \closeout if we haven't already done it, else we'll end up
3878 % Since there are some commands we want to expand, and others we don't,
3879 % we have to laboriously prevent expansion for those that we don't.
3883   \def\@{@}% change to @@ when we switch to @ as escape char in index files.
3922 % For the aux and toc files, @ is the escape character.  So we want to
3948   % For control letters, we have \definedummyletter, which omits the
4166   % Of course this is not nearly correct, but it is the best we can do for now.
4171   % Since macro invocations are followed by braces, we can just redefine them
4187 % empty if called from \doind, as we usually are (the main exception
4216   % Remember, we are within a group.
4254 % But don't do any of this if we're not in vertical mode.  We
4286   % -\whatsitskip glue we're inserting is preceded by a
4298     % perhaps it was >=10000, e.g., a \nobreak.  In that case, we want
4300     % signals); since we just inserted a non-discardable item, any
4310     % On the other hand, if we had a nonzero \lastskip,
4312     % (the whatsit from the \write), so we must insert a \nobreak.
4383       % Index files are almost Texinfo source, but we use \ as the escape
4404   % Remove any glue we may have, we'll be inserting our own.
4416   % we need before each entry, but it's better.
4458     % lines.  So we use a small indentation and put up with long leaders.
4460     % \hangafter is reset to 1 (which is the value we want) at the start
4461     % of each paragraph, so we need not do anything with that.
4493       % If we must, put the page number on a line of its own, and fill out
4534 % Define two-column mode, which we use to typeset indexes.
4546     % Here is a possibility not foreseen in manmac: if we accumulate a
4547     % whole lot of material, we might end up calling this \output
4550     % that case we just ship out what is in \partialpage with the normal
4570   % format, but then we repeat the same computation.  Repeating a couple
4572   % execution time, so we may as well do it in one place.
4574   % First we halve the line length, less a little for the gutter between
4578   % as it did when we hard-coded it.
4580   % We put the result in a separate register, \doublecolumhsize, so we
4614 % followed by the two boxes we just split, in box0 and box2.
4626   % _before_ we change the output routine.  This is necessary in the
4635   % below, and by that time we'll already have changed the output
4644   % section, it invokes the new output routine that we've set after
4658     % If we end up splitting too much material for the current page,
4660     % invocation ends.  Having called \balancecolumns once, we do not
4670   % \pagegoal was set to the doubled \vsize above, since we restarted
4686   % Loop until we get a decent breakpoint.
4708 % \unnumberedno is an oxymoron, of course.  But we count the unnumbered
4709 % sections so that we can refer to them unambiguously in the pdf
4712 % chapters, we're in trouble anyway, I'm sure.)
4783 % we only have subsub.
4787 % To achive this, remember the "biggest" unnum. sec. we are currently in:
4868 % Also set \chaplevelprefix, which we prepend to @float sequence numbers
4926   % Anyway, we don't want the fully-expanded definition of @cite to appear
4927   % as a result of the \message, we just want `@cite' itself.  We use
4943   % Well, we could do the following in a group, but that would break
4945   % Thus we are safer this way:		--kasal, 24feb04
5018 % to what kind of chapter we are in (ordinary, appendix, or unnumbered).
5072 % get the headings for the next chapter, which is wrong.  But we don't
5073 % care -- we just disable all headings on the filler page.
5170     % Only insert the separating space if we have a chapter/appendix
5187     % \donoderef, because we include the current node name in the toc
5191     % For pdftex, we have to write out the node definition (aka, make
5315     % Only insert the space after the number if we have a section number.
5394 % But if #1 is `omit', then we don't do anything.  This is used for the
5417   % Tell \shipout to create a pdf destination on each page, if we're
5421   % two pages of the document.  Thus, we'd have two destinations named
5428 % fonts, so we must take special care.  This is more or less redundant
5455 % Prepare to read what we've written to \tocfile.
5459   % start on an odd page, unlike chapters.  Thus, we maintain
5606 % If the toc has to be broken over pages, we want it to be at chapters
5792   \leftskip=0pt\rightskip=0pt % we want these *outside*.
5862     % we need to do it before changing the fonts, and it's inconvenient
5936 % @quotation does normal linebreaking (hence we can't use \nonfillstart)
5938 % we're doing normal filling.  So, when using \aboveenvbreak and
5956 % We have retained a nonzero parskip for the environment, since we're
5968 % If we're given an argument, typeset it in bold with a colon after.
5978 % If we want to allow any <char> as delimiter,
5979 % we need the curly braces so that makeinfo sees the @verb command, eg:
5984 % [Knuth] p.344; only we need to do the other characters Texinfo sets
6118 % we need not redefine '\', '{' and '}'.
6126   % of the @verbatim input line itself.  Otherwise we get an extra blank
6130   % without the active space; thus we have to use \xdef and \gobble.
6158 % beforehand -- and a) we want @copying to be done first in the source
6188     % If there are two @def commands in a row, we'll have a \nobreak,
6190     % header.  But if there's nothing but headers, we need to allow a
6193     % commands also insert a nobreak penalty, and we don't want to allow
6196     % As a minor refinement, we avoid "club" headers by signalling
6213   % First, check whether we are in the right environment:
6216   % As above, allow line break if we have multiple x headers in a row.
6238     % rendering the following check redundant.  But we don't optimize.
6366   % How we'll format the type name.  Putting it in brackets helps
6374   % we need only space for the part of \box0 which exceeds it:
6387     % Intentionally do not respect \rightskip, since we need the space.
6395     % . we're printing identifiers, they should be in tt in principle.
6399     % . we don't want -- and --- to be treated as ligatures.
6423   % On the other hand, if an argument has two dashes (for instance), we
6441 % Be sure that we always have a definition for `(', etc.  For example,
6456 % If we encounter &foo, then turn on ()-hacking afterwards
6520 % To do this right we need a feature of e-TeX, \scantokens,
6521 % which we arrange to emulate with a temporary file in ordinary TeX.
6538     % When called from @insertcopying or (short)caption, we need active
6539     % backslash to get it printed correctly.  Previously, we had
6578 % (except of course we have to play expansion games).
6844 \newif\ifwarnedxrefs  % True if we warned once that they aren't known.
6935       % the square brackets.  Use the real section title if we have it.
6937         % It is in another manual, so we don't have it.
6941           % We know the real title if we have the xref values.
7000     % If we use \unhbox0 and \unhbox1 to print the node names, TeX does not
7004     % is a loss.  Therefore, we give the text of the node name again, so it
7012       % printing. So we \turnoffactive for the \refx-snt, back on for the
7023       % But we always want a comma and a space:
7099 % just a \def (we prepend XR to the control sequence name to avoid
7100 % collisions).  But if this is a float type, we have more work to do.
7113   % Was that xref control sequence that we just defined for a float?
7115     % it was a float, and we have the (safe) float type in \iffloattype.
7119     % Is this the first time we've seen this float type?
7177   % character, we would end up writing a line like this: 'xrdef {'hat
7180   % all be worked out, but why?  Either we support ^^ or we don't.
7201   \catcode`+=\other % avoid \+ for paranoia even though we've turned it off
7222   % @ is our escape character in .aux files, and we need braces.
7260   % extra spacing after we do the footnote number.
7295   % Because we use hanging indentation in footnotes, a @noindent appears
7376 % If epsf.tex is not installed and @image is used, we complain.
7378 % Check for and read epsf.tex up front.  If we read it only at @image
7379 % time, we might be inside a group, and then its definitions would get
7409 % #1 is (mandatory) image filename; we tack on .eps extension.
7416   \catcode`\^^M = 5     % in case we're inside an example
7422     % Usually we'll have text after the image which will insert
7445 % etc.  We don't actually implement floating yet, we always include the
7463 % We keep a separate counter for each FLOATTYPE, which we reset at each
7473   % BEWARE: when the floats start float, we have to issue warning whenever an
7484     \def\floatloc{#3}% we do nothing with this yet.
7491         % but we need to use it in a control sequence name.
7498     % If label is given but no type, we handle that as the empty type.
7525 % we have these possibilities:
7538     % In all cases, if we have a float type, it comes first.
7541     % If we have an xref label, the number comes next.
7550     % Start the printed caption with what we've constructed in
7551     % \floatident, but keep it separate; we need \floatident again.
7563     % If we have anything to print, print it, with space before.
7577       % \floatlabel-lof.  Besides \floatident, we include the short
7582         % since we read the caption text in the macro world, where ^^M
7583         % is turned into a normal character, we have to scan it back, so
7584         % we don't write the literal three characters "^^M" into the aux file.
7602   % BEWARE: when the floats start floating, we have to issue warning
7622 % The parameter is the control sequence identifying the counter we are
7637 % to the FLOATLABEL to expand to "Figure 3.1".  We call \setref when we
7646 % #1 is the control sequence we are passed; we expand into a conditional
7648 % \lastsection value which we \setref above.
7667     % but we need to use it in a control sequence name.
7689 % xref label, in the form LABEL-title, which is how we save it in the
7691 % has the text we're supposed to typeset here.
7700   % page number, and we want to fully expand that so we can get a link
7704   % use the same \entry macro we use to generate the TOC and index.
7715 % abbreviation.  It would be nice if we could set up a hyphenation file.
8590 % Use TeX 3.0's \emergencystretch to help line breaking, but if we're
8633     % if we don't reset these, they will remain at "1 true in" of
8746   % Must explicitly reset to 0 because we call \afourpaper.
8761 % Perhaps we should allow setting the margins, \topskip, \parskip,
8762 % and/or leading, also. Or perhaps we should compute them somehow.
8815 % #1 is what to print if we are indeed using \tt; #2 is what to print
8818 % typewriter fonts to have this, we can check that font parameter.
8830 % Most of these we simply print from the \tt font, but for some, we can
8862 % name cannot be active until we have parsed the command line.
8919 % If a .fmt file is being used, we don't want the `\input texinfo' to show up.

Indexes created Tue Jul 24 14:28:13 CEST 2018