bc/doc/texinfo.tex

53 %   dvips foo.dvi -o # or whatever, to process the dvi file; this makes foo.ps.
63 % If in a .fmt file, print the version number
93 % starts a new line in the output.
221           \line{\ewtop\hfil\ewtop}%
223           \line{%
230         \line\bgroup
250         \hfil\egroup % end of (centering) \line\bgroup
254           \line{%
260           \line{\ewbot\hfil\ewbot}%
295 % the input line (except we remove a trailing comment).  #1 should be a
490 % at the beginning of a line will start with \penalty -- and
503 % @* forces a line break.
517 % produce a whole line of output instead of starting the paragraph.
522 % to keep its height that of a normal line.  According to the rules for
536   % next line of text is done) \lineskip glue after it.  (See p.82 of
545     % We have to put a strut on the last line in case the @group is in
547     % Otherwise, the interline space between the last line of the group
548     % and the first line afterwards is too small.  But we can't put the
549     % strut in \Egroup, since there it would be on a line by itself.
550     % Hence this just inserts a strut at the beginning of each line.
553     % Since we have a strut on every line, we don't need any of TeX's
570     % @example, where each end-of-line in the input causes an
571     % end-of-line in the output.  We don't want the end-of-line after
573     % should appear on a line by itself (according to the Texinfo
583 where each line of input produces a line of output.}
606   % If the @need value is less than one line space, it's useless.
613     % normal leading is inserted relative to the preceding line.
644 % @dots{} output an ellipsis using the current font.
646 % font as three actual period characters.
675 % outputs text on separate line in roman font, starting at standard page margin
722 % @center line   outputs that line, centered
734 % @comment ...line which is ignored...
1026 % Texinfo sort of supports the sans serif font style, which plain TeX does not.
1039 % Set the font macro #1 to the font named #2, adding on the
1040 % specified font prefix (normally `cm').
1041 % #3 is the font's design size, #4 is a scale factor
1042 \def\setfont#1#2#3#4{\font#1=\fontprefix#2#3 scaled #4}
1044 % Use cm as the default font prefix.
1045 % To specify the font prefix, you must define \fontprefix
1050 % Support font families that don't use the same naming scheme as CM.
1076 % cmbx10 is a prettier font on its own, but cmb10
1077 % looks better when embedded in a line with cmr10.
1084 \font\texti=cmmi10 scaled \mainmagstep
1085 \font\textsy=cmsy10 scaled \mainmagstep
1101 \font\smalli=cmmi9
1102 \font\smallsy=cmsy9
1113 \font\titlei=cmmi12 scaled \magstep3
1114 \font\titlesy=cmsy10 scaled \magstep4
1126 \font\chapi=cmmi12 scaled \magstep2
1127 \font\chapsy=cmsy10 scaled \magstep3
1138 \font\seci=cmmi12 scaled \magstep1
1139 \font\secsy=cmsy10 scaled \magstep2
1141 % \setfont\ssecrm\bxshape{10}{\magstep1}    % This size an font looked bad.
1164 \font\sseci=cmmi12 scaled \magstephalf
1165 \font\ssecsy=cmsy10 scaled 1315
1169 % In order for the font changes to affect most math symbols and letters,
1182 % The font-changing commands redefine the meanings of \tenSTYLE, instead
1183 % of just \STYLE.  We do this so that font changes will continue to work
1185 % cases, not the current font.  Plain TeX does \def\bf{\fam=\bffam
1231 % Count depth in font-changes, for error checks
1239 %% Add scribe-like font environments, plus @l for inline lisp (usually sans
1261 \def\nohyphenation{\hyphenchar\font = -1  \aftergroup\restorehyphenation}
1262 \def\restorehyphenation{\hyphenchar\font = `- }
1271 \font\keysy=cmsy9
1290     % Change normal interword space to be same as for the current font.
1291     \spaceskip = \fontdimen2\font
1343 % @kbdinputstyle -- arg is `distinct' (@kbd uses slanted tty font always),
1345 %   or `code' (@kbd uses normal tty font always).
1421 % Check if we are currently using a typewriter font.  Since all the
1424 % this property, we can check that font parameter.
1426 \def\ifmonospace{\ifdim\fontdimen3\font=0pt }
1435 % @l was never documented to mean ``switch to the Lisp font'',
1440 % Explicit font changes: @r, @sc, undocumented @ii.
1441 \def\r#1{{\rm #1}}              % roman font
1442 \def\sc#1{{\smallcaps#1}}       % smallcaps font
1443 \def\ii#1{{\it #1}}             % italic font
1584 \global\evenheadline={\rlap{\centerline{#2}}\line{#1\hfil#3}}}
1588 \global\oddheadline={\rlap{\centerline{#2}}\line{#1\hfil#3}}}
1594 \global\evenfootline={\rlap{\centerline{#2}}\line{#1\hfil#3}}}
1598   \global\oddfootline = {\rlap{\centerline{#2}}\line{#1\hfil#3}}%
1626 % When we turn headings on, set the page number to 1.
1635 \global\evenheadline={\line{\folio\hfil\thistitle}}
1636 \global\oddheadline={\line{\thischapter\hfil\folio}}
1642 % page number on top right.
1647 \global\evenheadline={\line{\thischapter\hfil\folio}}
1648 \global\oddheadline={\line{\thischapter\hfil\folio}}
1658 \global\evenheadline={\line{\folio\hfil\thistitle}}
1659 \global\oddheadline={\line{\thischapter\hfil\folio}}
1667 \global\evenheadline={\line{\thischapter\hfil\folio}}
1668 \global\oddheadline={\line{\thischapter\hfil\folio}}
1675   \number\day\space
1681   \space\number\year}
1683 % @settitle line...  specifies the title of the document, for headings.
1734   % If the item text does not fit in the space we have, put it on a line
1736   % line.  We do not start a paragraph here because then if the next
1738   % horizontal list on a line by itself, resulting in extra blank space.
1762     % following text (if any) will end up on the same line.
1874 % or number, to specify the first label in the enumerated list.  No
1887   % letter.  Otherwise, the only valid thing it can be is a number.
1897     % Otherwise, we assume it's a number.
1900     % continuing to look for a <number>.
1903       \numericenumerate % a number (we hope)
1913     % Multiple tokens in the argument.  We hope it's a number.
1985 % can be specified either with sample text given in a template line,
2006 % For those who want to use more than one line's worth of words in
2007 % the preamble, break the line within one argument and it
2016 % Each new table line starts with @item, each subsequent new column
2047 %   0pt means it depends on current normal line spacing.
2105 % This used to have \hskip1sp.  But then the space in a template line is
2130   % each line. Every column entry will cause \colcount to advance by one.
2143   % \vtop will set a single line and will also let text wrap and
2175   % blank line, when TeX decides to break the line at the space before the
2176   % box from the multistrut, so the strut ends up on a line by itself.
2311 % Ignore text until a line `@end #1'.
2332   % Make the letter c a comment character so that the rest of the line
2369 % uncomment the following line:
2370 %%%%%\font\nullfont=dummy\let\obstexwarn=\relax
2381   % page 401 of the TeXbook: make the current font be a dummy font.
2400     % Set the current font to be \nullfont, a TeX primitive, and define
2401     % all the font commands to also use \nullfont.  We don't use
2425     % Do minimal line-breaking.
2440 % own to delimit the rest of the line, and then take it out again if we
2574 % \fooindex ...rest of line... puts an entry in the index foo.
2575 % It also defines \fooindfile to be the number of the output channel for
2740 % \indexnofonts no-ops all font-change commands.
2850         % First process the index entry with all font commands turned
2864         % and the original text, including any font commands.  We write
2952   % as its first line, TeX doesn't complain about mismatched braces
2989   % Some minor font changes for the special characters.
2998   % Typeset the initial.  Making this add up to a whole number of
3022   % Do not fill out the last line with white space.
3028   % Do not prefer a separate line ending with a hyphen to fewer lines.
3031   % \hangindent is only relevant when the entry text and page number
3032   % don't both fit on one line.  In that case, bob suggests starting the
3033   % dots pretty far over on the line.  Unfortunately, a large
3041   % When the entry text needs to be broken, just fill out the first line
3048   % Start a ``paragraph'' for the index entry so the line breaking
3052   % Insert the text of the index entry.  TeX will do line-breaking on it.
3054   % The following is kludged to not output a line of dots in the index if
3063     % If we must, put the page number on a line of its own, and fill out
3064     % this line with blank space.  (The \hfil is overwhelmed with the
3065     % fill leaders glue in \indexdotfill if the page number does fit.)
3067     \null\nobreak\indexdotfill % Have leaders before the page number.
3073       \pdfgettoks#2.\ \the\toksA % The page number ends the paragraph.
3075       \ #2% The page number ends the paragraph.
3085 \def\primary #1{\line{#1\hfil}}
3135   % First we halve the line length, less a little for the gutter between
3136   % the columns.  We compute the gutter based on the line length, so it
3583 %       1) We use \vbox rather than the earlier \line to permit
3654 % #1 is the text, #2 the chapter number or empty if unnumbered.
3730 % number (maybe empty), #3 the text.
3740     % Only insert the separating space if we have a section number.
3745           \hangindent = \wd0 % zero if no section number
3797       \advance\hsize by -\contentsrightmargin % Don't use the full line length.
3857 % The last argument is the page number.
3858 % The arguments in between are the chapter number, section number, ...
3886   % This space should be plenty, since a single number is .5em, and the
3914 % page number.
3945 % of hyphenated-identifiers-that-do-not-fit-on-a-line-and-nothing-else.)
3954 % Space between chapter (or whatever) number and the title.
3969 % Since these characters are used in examples, it should be an even number of
4063 % space in the output.  Don't allow a line break at this space, as this
4064 % is used only in environments like @example, where each line of input
4065 % should produce a line of output anyway.
4094 \font\circle=lcircle10
4162   \obeylines % each line of input is a line of output
4187 % @lisp: indented, narrowed, typewriter font.
4221 % @display: same as @lisp except keep current font.
4293 % Allow user to change definition object font (\df) internally
4357 % First, defname, which formats the header line itself.
4368 \dimen0=\hsize \advance \dimen0 by -\wd0 % compute size for first line
4566 % Set the font temporarily and use \font in case \setfont made \tensl a macro.
4567 {\tensl\hyphenchar\font=0}%
4569 {\tensl\hyphenchar\font=45}%
4587 % Do complete processing of one @defun or @defunx line already parsed.
4942 % where N is the macro parameter number.
5112 % line.  Whatever was read is then fed to the next control sequence
5240   % not find a line break at a hyphen in a node names.  Since some manuals
5327 % Use TeX 3.0's \inputlineno to get the line number, for better error
5404   % character, we would end up writing a line like this: 'xrdef {'hat
5476 % Auto-number footnotes.  Otherwise like plain.
5482   % extra spacing after we do the footnote number.
5486   % Remove inadvertent blank space before typesetting the footnote number.
5515   % Hang the footnote text off the number.
5519   % Don't crash into the line above the footnote text.  Since this
5551 % @| inserts a changebar to the left of the current line.  It should
5561   % Append this vertical mode material after the current line in the output.
5702 % Use TeX 3.0's \emergencystretch to help line breaking, but if we're
5704 % stretch added to depend on the line length, hence the dependence on
5852 % typewriter fonts to have this, we can check that font parameter.
5854 \def\ifusingtt#1#2{\ifdim \fontdimen3\font=0pt #1\else #2\fi}
5856 % Same as above, but check for italic font.  Actually this also catches
5860 \def\ifusingit#1#2{\ifdim \fontdimen1\font>0pt #1\else #2\fi}
5864 % Most of these we simply print from the \tt font, but for some, we can
5904 % name cannot be active until we have parsed the command line.
5911 % \rawbackslashxx output one backslash character in current font
5920 % \normalbackslash outputs one backslash in fixed width font.