Path: blob/main/crypto/krb5/src/util/et/texinfo.tex
34907 views
%% TeX macros to handle texinfo files12% Copyright (C) 1985, 1986, 1988 Richard M. Stallman34% NO WARRANTY56% BECAUSE THIS PROGRAM IS LICENSED FREE OF CHARGE, WE PROVIDE ABSOLUTELY7%NO WARRANTY, TO THE EXTENT PERMITTED BY APPLICABLE STATE LAW. EXCEPT8%WHEN OTHERWISE STATED IN WRITING, FREE SOFTWARE FOUNDATION, INC,9%RICHARD M. STALLMAN AND/OR OTHER PARTIES PROVIDE THIS PROGRAM "AS IS"10%WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING,11%BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND12%FITNESS FOR A PARTICULAR PURPOSE. THE ENTIRE RISK AS TO THE QUALITY13%AND PERFORMANCE OF THE PROGRAM IS WITH YOU. SHOULD THE PROGRAM PROVE14%DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING, REPAIR OR15%CORRECTION.1617% IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW WILL RICHARD M.18%STALLMAN, THE FREE SOFTWARE FOUNDATION, INC., AND/OR ANY OTHER PARTY19%WHO MAY MODIFY AND REDISTRIBUTE THIS PROGRAM AS PERMITTED BELOW, BE20%LIABLE TO YOU FOR DAMAGES, INCLUDING ANY LOST PROFITS, LOST MONIES, OR21%OTHER SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE22%USE OR INABILITY TO USE (INCLUDING BUT NOT LIMITED TO LOSS OF DATA OR23%DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY THIRD PARTIES OR24%A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS) THIS25%PROGRAM, EVEN IF YOU HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH26%DAMAGES, OR FOR ANY CLAIM BY ANY OTHER PARTY.2728% GENERAL PUBLIC LICENSE TO COPY2930% 1. You may copy and distribute verbatim copies of this source file31%as you receive it, in any medium, provided that you conspicuously32%and appropriately publish on each copy a valid copyright notice33%"Copyright (C) 1986 Richard M. Stallman"; and include34%following the copyright notice a verbatim copy of the above disclaimer35%of warranty and of this License.3637% 2. You may modify your copy or copies of this source file or38%any portion of it, and copy and distribute such modifications under39%the terms of Paragraph 1 above, provided that you also do the following:4041% a) cause the modified files to carry prominent notices stating42% that you changed the files and the date of any change; and4344% b) cause the whole of any work that you distribute or publish,45% that in whole or in part contains or is a derivative of this46% program or any part thereof, to be licensed at no charge to all47% third parties on terms identical to those contained in this48% License Agreement (except that you may choose to grant more extensive49% warranty protection to some or all third parties, at your option).5051% c) You may charge a distribution fee for the physical act of52% transferring a copy, and you may at your option offer warranty53% protection in exchange for a fee.5455%Mere aggregation of another unrelated program with this program (or its56%derivative) on a volume of a storage or distribution medium does not bring57%the other program under the scope of these terms.5859% 3. You may copy and distribute this program (or a portion or derivative60%of it, under Paragraph 2) in object code or executable form under the terms61%of Paragraphs 1 and 2 above provided that you also do one of the following:6263% a) accompany it with the complete corresponding machine-readable64% source code, which must be distributed under the terms of65% Paragraphs 1 and 2 above; or,6667% b) accompany it with a written offer, valid for at least three68% years, to give any third party free (except for a nominal69% shipping charge) a complete machine-readable copy of the70% corresponding source code, to be distributed under the terms of71% Paragraphs 1 and 2 above; or,7273% c) accompany it with the information you received as to where the74% corresponding source code may be obtained. (This alternative is75% allowed only for noncommercial distribution and only if you76% received the program in object code or executable form alone.)7778%For an executable file, complete source code means all the source code for79%all modules it contains; but, as a special exception, it need not include80%source code for modules which are standard libraries that accompany the81%operating system on which the executable file runs.8283% 4. You may not copy, sublicense, distribute or transfer this program84%except as expressly provided under this License Agreement. Any attempt85%otherwise to copy, sublicense, distribute or transfer this program is void and86%your rights to use the program under this License agreement shall be87%automatically terminated. However, parties who have received computer88%software programs from you with this License Agreement will not have89%their licenses terminated so long as such parties remain in full compliance.9091% 5. If you wish to incorporate parts of this program into other free92%programs whose distribution conditions are different, write to the Free93%Software Foundation at 675 Mass Ave, Cambridge, MA 02139. We have not yet94%worked out a simple rule that can be stated here, but we will often permit95%this. We will be guided by the two goals of preserving the free status of96%all derivatives of our free software and of promoting the sharing and reuse of97%software.9899%In other words, you are welcome to use, share and improve this program.100%You are forbidden to forbid anyone else to use, share and improve101%what you give them. Help stamp out software-hoarding!102103\def\texinfoversion{1.18}104\message{Loading texinfo package [Version \texinfoversion]:}105\message{}106107% Save some parts of plain tex whose names we will redefine.108109\let\ptexlbrace=\{110\let\ptexrbrace=\}111\let\ptexdot=\.112\let\ptexstar=\*113\let\ptexend=\end114\let\ptexbullet=\bullet115\let\ptexb=\b116\let\ptexc=\c117\let\ptexi=\i118\let\ptext=\t119\let\ptexl=\l120\let\ptexL=\L121122\def\tie{\penalty 10000\ } % Save plain tex definition of ~.123124\message{Basics,}125\chardef\other=12126127\hyphenation{ap-pen-dix}128\hyphenation{mini-buf-fer mini-buf-fers}129\hyphenation{eshell}130131% Margin to add to right of even pages, to left of odd pages.132\newdimen \bindingoffset \bindingoffset=0pt133\newdimen \normaloffset \normaloffset=\hoffset134\newdimen\pagewidth \newdimen\pageheight135\pagewidth=\hsize \pageheight=\vsize136137%---------------------Begin change-----------------------138%139% Dimensions to add cropmarks at corners Added by P. A. MacKay, 12 Nov. 1986140%141\newdimen\cornerlong \newdimen\cornerthick142\newdimen \topandbottommargin143\newdimen \outerhsize \newdimen \outervsize144\cornerlong=1pc\cornerthick=.3pt % These set size of cropmarks145\outerhsize=7in146\outervsize=9.5in147\topandbottommargin=.75in148%149%---------------------End change-----------------------150151% \onepageout takes a vbox as an argument. Note that \pagecontents152% does insertions itself, but you have to call it yourself.153\chardef\PAGE=255 \output={\onepageout{\pagecontents\PAGE}}154\def\onepageout#1{\hoffset=\normaloffset155\ifodd\pageno \advance\hoffset by \bindingoffset156\else \advance\hoffset by -\bindingoffset\fi157\shipout\vbox{{\let\hsize=\pagewidth \makeheadline} \pagebody{#1}%158{\let\hsize=\pagewidth \makefootline}}159\advancepageno \ifnum\outputpenalty>-20000 \else\dosupereject\fi}160161162% Here is a modification of the main output routine for Near East Publications163% This provides right-angle cropmarks at all four corners.164% The contents of the page are centerlined into the cropmarks,165% and any desired binding offset is added as an \hskip on either166% site of the centerlined box. (P. A. MacKay, 12 November, 1986)167%168\def\croppageout#1{\hoffset=0pt % make sure this doesn't mess things up169\shipout170\vbox to \outervsize{\hsize=\outerhsize171\vbox{\line{\ewtop\hfill\ewtop}}172\nointerlineskip173\line{\vbox{\moveleft\cornerthick\nstop}174\hfill175\vbox{\moveright\cornerthick\nstop}}176\vskip \topandbottommargin177\centerline{\ifodd\pageno\hskip\bindingoffset\fi178\vbox{179{\let\hsize=\pagewidth \makeheadline}180\pagebody{#1}181{\let\hsize=\pagewidth \makefootline}}182\ifodd\pageno\else\hskip\bindingoffset\fi}183\vskip \topandbottommargin plus1fill minus1fill184\boxmaxdepth\cornerthick185\line{\vbox{\moveleft\cornerthick\nsbot}186\hfill187\vbox{\moveright\cornerthick\nsbot}}188\nointerlineskip189\vbox{\line{\ewbot\hfill\ewbot}}190}191\advancepageno192\ifnum\outputpenalty>-20000 \else\dosupereject\fi}193%194% Do @cropmarks to get crop marks195\def\cropmarks{\let\onepageout=\croppageout }196197\def\pagebody#1{\vbox to\pageheight{\boxmaxdepth=\maxdepth #1}}198{\catcode`\@ =11199\gdef\pagecontents#1{\ifvoid\topins\else\unvbox\topins\fi200\dimen@=\dp#1 \unvbox#1201\ifvoid\footins\else\vskip\skip\footins\footnoterule \unvbox\footins\fi202\ifr@ggedbottom \kern-\dimen@ \vfil \fi}203}204205%206% Here are the rules for the cropmarks. Note that they are207% offset so that the space between them is truly \outerhsize or \outervsize208% (P. A. MacKay, 12 November, 1986)209%210\def\ewtop{\vrule height\cornerthick depth0pt width\cornerlong}211\def\nstop{\vbox212{\hrule height\cornerthick depth\cornerlong width\cornerthick}}213\def\ewbot{\vrule height0pt depth\cornerthick width\cornerlong}214\def\nsbot{\vbox215{\hrule height\cornerlong depth\cornerthick width\cornerthick}}216217% Parse an argument, then pass it to #1.218% The argument can be delimited with [...] or with "..." or braces219% or it can be a whole line.220% #1 should be a macro which expects221% an ordinary undelimited TeX argument.222223\def\parsearg #1{\let\next=#1\begingroup\obeylines\futurelet\temp\parseargx}224225\def\parseargx{%226\ifx \obeyedspace\temp \aftergroup\parseargdiscardspace \else%227\aftergroup \parseargline %228\fi \endgroup}229230{\obeyspaces %231\gdef\parseargdiscardspace {\begingroup\obeylines\futurelet\temp\parseargx}}232233\gdef\obeyedspace{\ }234235\def\parseargline{\begingroup \obeylines \parsearglinex}236{\obeylines %237\gdef\parsearglinex #1^^M{\endgroup \next {#1}}}238239\def\flushcr{\ifx\par\lisppar \def\next##1{}\else \let\next=\relax \fi \next}240241%% These are used to keep @begin/@end levels from running away242%% Call \inENV within environments (after a \begingroup)243\newif\ifENV \ENVfalse \def\inENV{\ifENV\relax\else\ENVtrue\fi}244\def\ENVcheck{%245\ifENV\errmessage{Still within an environment. Type Return to continue.}246\endgroup\fi} % This is not perfect, but it should reduce lossage247248% @begin foo is the same as @foo, for now.249\newhelp\EMsimple{Type <Return> to continue}250251\outer\def\begin{\parsearg\beginxxx}252253\def\beginxxx #1{%254\expandafter\ifx\csname #1\endcsname\relax255{\errhelp=\EMsimple \errmessage{Undefined command @begin #1}}\else256\csname #1\endcsname\fi}257258%% @end foo executes the definition of \Efoo.259%% foo can be delimited by doublequotes or brackets.260261\def\end{\parsearg\endxxx}262263\def\endxxx #1{%264\expandafter\ifx\csname E#1\endcsname\relax265\expandafter\ifx\csname #1\endcsname\relax266\errmessage{Undefined command @end #1}\else267\errorE{#1}\fi\fi268\csname E#1\endcsname}269\def\errorE#1{270{\errhelp=\EMsimple \errmessage{@end #1 not within #1 environment}}}271272% Single-spacing is done by various environments.273274\newskip\singlespaceskip \singlespaceskip = \baselineskip275\def\singlespace{%276{\advance \baselineskip by -\singlespaceskip277\kern \baselineskip}%278\baselineskip=\singlespaceskip279}280281%% Simple single-character @ commands282283% @@ prints an @284% Kludge this until the fonts are right (grr).285\def\@{{\sf \char '100}}286287% Define @` and @' to be the same as ` and '288% but suppressing ligatures.289\def\`{{`}}290\def\'{{'}}291292% Used to generate quoted braces.293294\def\mylbrace {{\tt \char '173}}295\def\myrbrace {{\tt \char '175}}296\let\{=\mylbrace297\let\}=\myrbrace298299% @: forces normal size whitespace following.300\def\:{\spacefactor=1000 }301302% @* forces a line break.303\def\*{\hfil\break}304305% @. is an end-of-sentence period.306\def\.{.\spacefactor=3000 }307308% @w prevents a word break309\def\w #1{\hbox{#1}}310311% @group ... @end group forces ... to be all on one page.312313\def\group{\begingroup% \inENV ???314\def \Egroup{\egroup\endgroup}315\vbox\bgroup}316317% @br forces paragraph break318319\let\br = \par320321% @dots{} output some dots322323\def\dots{$\ldots$}324325% @page forces the start of a new page326327\def\page{\par\vfill\supereject}328329% @exdent text....330% outputs text on separate line in roman font, starting at standard page margin331332\def\exdent{\errmessage{@exdent in filled text}}333% @lisp, etc, define \exdent locally from \internalexdent334335{\obeyspaces336\gdef\internalexdent{\parsearg\exdentzzz}}337338\def\exdentzzz #1{{\advance \leftskip by -\lispnarrowing339\advance \hsize by -\leftskip340\advance \hsize by -\rightskip341\leftline{{\rm#1}}}}342343% @include file insert text of that file as input.344345\def\include{\parsearg\includezzz}346\def\includezzz #1{{\def\thisfile{#1}\input #1347}}348349\def\thisfile{}350351% @center line outputs that line, centered352353\def\center{\parsearg\centerzzz}354\def\centerzzz #1{{\advance\hsize by -\leftskip355\advance\hsize by -\rightskip356\centerline{#1}}}357358% @sp n outputs n lines of vertical space359360\def\sp{\parsearg\spxxx}361\def\spxxx #1{\par \vskip #1\baselineskip}362363% @comment ...line which is ignored...364% @c is the same as @comment365% @ignore ... @end ignore is another way to write a comment366367\def\comment{\parsearg \commentxxx}368369\def\commentxxx #1{}370371\let\c=\comment372373\long\def\ignore #1\end ignore{}374375\outer\def\ifset{\parsearg\ifsetxxx}376377\def\ifsetxxx #1#2\end ifset{%378\expandafter\ifx\csname IF#1\endcsname\relax \else #2\fi}379380\outer\def\ifclear{\parsearg\ifclearxxx}381382\def\ifclearxxx #1#2\end ifclear{%383\expandafter\ifx\csname IF#1\endcsname\relax #2\fi}384385% Some texinfo constructs that are trivial in tex386387\def\iftex{}388\def\Eiftex{}389\long\def\ifinfo #1\end ifinfo{}390\long\def\menu #1\end menu{}391\def\asis#1{#1}392393\def\node{\parsearg\nodezzz}394\def\nodezzz#1{\nodexxx [#1,]}395\def\nodexxx[#1,#2]{\gdef\lastnode{#1}}396\let\lastnode=\relax397398\def\donoderef{\ifx\lastnode\relax\else399\expandafter\expandafter\expandafter\setref{\lastnode}\fi400\let\lastnode=\relax}401402\def\unnumbnoderef{\ifx\lastnode\relax\else403\expandafter\expandafter\expandafter\unnumbsetref{\lastnode}\fi404\let\lastnode=\relax}405406\let\refill=\relax407408\let\setfilename=\comment409410\def\inforef #1{\inforefzzz #1,,,,**}411\def\inforefzzz #1,#2,#3,#4**{See Info file \file{\losespace#3{}}, node `\losespace#1{}'}412\def\losespace #1{#1}413414\message{fonts,}415416% Font-change commands.417418%% Try out Computer Modern fonts at \magstephalf419\font\tenrm=cmr10 scaled \magstephalf420\font\tentt=cmtt10 scaled \magstephalf421% Instead of cmb10, you many want to use cmbx10.422% cmbx10 is a prettier font on its own, but cmb10423% looks better when embedded in a line with cmr10.424\font\tenbf=cmb10 scaled \magstephalf425\font\tenit=cmti10 scaled \magstephalf426\font\tensl=cmsl10 scaled \magstephalf427\font\tensf=cmss10 scaled \magstephalf428\def\li{\sf}429\font\tensc=cmcsc10 scaled \magstephalf430431% Fonts for @defun, etc.432\font\defbf=cmbx10 scaled \magstep1 %was 1314433\let\deftt=\tentt434\def\df{\let\tt=\deftt \defbf}435436% Font for title437\font\titlerm = cmbx10 scaled \magstep5438439% Fonts for indices440\font\indit=cmti9 \font\indrm=cmr9441\def\indbf{\indrm} \def\indsl{\indit}442\def\indexfonts{\let\it=\indit \let\sl=\indsl \let\bf=\indbf \let\rm=\indrm}443444% Fonts for headings445\font\chaprm=cmbx10 scaled \magstep3446\font\chapit=cmti10 scaled \magstep3447\font\chapsl=cmsl10 scaled \magstep3448\font\chaptt=cmtt10 scaled \magstep3449\font\chapsf=cmss10 scaled \magstep3450\let\chapbf=\chaprm451452\font\secrm=cmbx10 scaled \magstep2453\font\secit=cmti10 scaled \magstep2454\font\secsl=cmsl10 scaled \magstep2455\font\sectt=cmtt10 scaled \magstep2456\font\secsf=cmss10 scaled \magstep2457\let\secbf=\secrm458459\font\ssecrm=cmbx10 scaled \magstep1460\font\ssecit=cmti10 scaled \magstep1461\font\ssecsl=cmsl10 scaled \magstep1462\font\ssectt=cmtt10 scaled \magstep1463\font\ssecsf=cmss10 scaled \magstep1464\let\ssecbf=\ssecrm465466\def\textfonts{\let\rm=\tenrm\let\it=\tenit\let\sl=\tensl\let\bf=\tenbf%467\let\sc=\tensc\let\sf=\tensf}468\def\chapfonts{\let\rm=\chaprm\let\it=\chapit\let\sl=\chapsl\let\bf=\chapbf\let\tt=\chaptt\let\sf=\chapsf}469\def\secfonts{\let\rm=\secrm\let\it=\secit\let\sl=\secsl\let\bf=\secbf\let\tt=\sectt\let\sf=\secsf}470\def\subsecfonts{\let\rm=\ssecrm\let\it=\ssecit\let\sl=\ssecsl\let\bf=\ssecbf\let\tt=\ssectt\let\sf=\ssecsf}471% Count depth in font-changes, for error checks472\newcount\fontdepth \fontdepth=0473474%% Add scribe-like font environments, plus @l for inline lisp (usually sans475%% serif) and @ii for TeX italic476477\def\i#1{{\sl #1}}478\let\var=\i479\let\dfn=\i480\let\emph=\i481\let\cite=\i482483\def\b#1{{\bf #1}}484\let\strong=\b485486\def\t#1{{\tt \rawbackslash \frenchspacing #1}\null}487\let\ttfont = \t488\let\kbd=\t489\let\code=\t490\def\samp #1{`{\tt \rawbackslash \frenchspacing #1}'\null}491\def\key #1{{\tt \uppercase{#1}}\null}492\def\ctrl #1{{\tt \rawbackslash \hat}#1}493494\let\file=\samp495496\def\l#1{{\li #1}\null}497498\def\r#1{{\rm #1}}499\def\s#1{{\sc #1}}500\def\ii#1{{\it #1}}501502\def\titlefont#1{{\titlerm #1}}503504\def\titlepage{\begingroup \parindent=0pt \hbox{}%505\let\oldpage=\page506\def\page{\oldpage \hbox{}}}507508\def\Etitlepage{\endgroup\page\HEADINGSon}509510% Make altmode in file print out right511512\catcode `\^^[=\active \def^^[{$\diamondsuit$}513514\message{page headings,}515516%%% Set up page headings and footings.517518\let\thispage=\folio519520\newtoks \evenheadline % Token sequence for heading line of even pages521\newtoks \oddheadline % Token sequence for heading line of odd pages522\newtoks \evenfootline % Token sequence for footing line of even pages523\newtoks \oddfootline % Token sequence for footing line of odd pages524525% Now make Tex use those variables526\headline={{\textfonts\rm \ifodd\pageno \the\oddheadline \else \the\evenheadline \fi}}527\footline={{\textfonts\rm \ifodd\pageno \the\oddfootline \else \the\evenfootline \fi}}528529% Commands to set those variables.530% For example, this is what @headings on does531% @evenheading @thistitle|@thispage|@thischapter532% @oddheading @thischapter|@thispage|@thistitle533% @evenfooting @thisfile||534% @oddfooting ||@thisfile535536\def\evenheading{\parsearg\evenheadingxxx}537\def\oddheading{\parsearg\oddheadingxxx}538\def\everyheading{\parsearg\everyheadingxxx}539540\def\evenfooting{\parsearg\evenfootingxxx}541\def\oddfooting{\parsearg\oddfootingxxx}542\def\everyfooting{\parsearg\everyfootingxxx}543544{\catcode`\@=0 %545546\gdef\evenheadingxxx #1{\evenheadingyyy #1@|@|@|@|\finish}547\gdef\evenheadingyyy #1@|#2@|#3@|#4\finish{%548\global\evenheadline={\rlap{\centerline{#2}}\line{#1\hfil#3}}}549550\gdef\oddheadingxxx #1{\oddheadingyyy #1@|@|@|@|\finish}551\gdef\oddheadingyyy #1@|#2@|#3@|#4\finish{%552\global\oddheadline={\rlap{\centerline{#2}}\line{#1\hfil#3}}}553554\gdef\everyheadingxxx #1{\everyheadingyyy #1@|@|@|@|\finish}555\gdef\everyheadingyyy #1@|#2@|#3@|#4\finish{%556\global\evenheadline={\rlap{\centerline{#2}}\line{#1\hfil#3}}557\global\oddheadline={\rlap{\centerline{#2}}\line{#1\hfil#3}}}558559\gdef\evenfootingxxx #1{\evenfootingyyy #1@|@|@|@|\finish}560\gdef\evenfootingyyy #1@|#2@|#3@|#4\finish{%561\global\evenfootline={\rlap{\centerline{#2}}\line{#1\hfil#3}}}562563\gdef\oddfootingxxx #1{\oddfootingyyy #1@|@|@|@|\finish}564\gdef\oddfootingyyy #1@|#2@|#3@|#4\finish{%565\global\oddfootline={\rlap{\centerline{#2}}\line{#1\hfil#3}}}566567\gdef\everyfootingxxx #1{\everyfootingyyy #1@|@|@|@|\finish}568\gdef\everyfootingyyy #1@|#2@|#3@|#4\finish{%569\global\evenfootline={\rlap{\centerline{#2}}\line{#1\hfil#3}}570\global\oddfootline={\rlap{\centerline{#2}}\line{#1\hfil#3}}}571%572}% unbind the catcode of @.573574% @headings on turns them on.575% @headings off turns them off.576% By default, they are off.577578\def\headings #1 {\csname HEADINGS#1\endcsname}579580\def\HEADINGSoff{581\global\evenheadline={\hfil} \global\evenfootline={\hfil}582\global\oddheadline={\hfil} \global\oddfootline={\hfil}}583\HEADINGSoff584% When we turn headings on, set the page number to 1,585% Put current file name in lower left corner,586% Put chapter name on inside top of right hand pages, document587% title on inside top of left hand pages, and page numbers on outside top588% edge of all pages.589\def\HEADINGSon{590\pagealignmacro591\global\pageno=1592\global\evenfootline={\hfil}593\global\oddfootline={\hfil}594\global\evenheadline={\line{\folio\hfil\thistitle}}595\global\oddheadline={\line{\thischapter\hfil\folio}}596}597598% Subroutines used in generating headings599% Produces Day Month Year style of output.600\def\today{\number\day\space601\ifcase\month\or602January\or February\or March\or April\or May\or June\or603July\or August\or September\or October\or November\or December\fi604\space\number\year}605606% Use this if you want the Month Day, Year style of output.607%\def\today{\ifcase\month\or608%January\or February\or March\or April\or May\or June\or609%July\or August\or September\or October\or November\or December\fi610%\space\number\day, \number\year}611612% @settitle line... specifies the title of the document, for headings613% It generates no output of its own614615\def\thistitle{No Title}616\def\settitle{\parsearg\settitlezzz}617\def\settitlezzz #1{\gdef\thistitle{#1}}618619\message{tables,}620621% Tables -- @table, @ftable, @item(x), @kitem(x), @xitem(x).622623% default indentation of table text624\newdimen\tableindent \tableindent=.8in625% default indentation of @itemize and @enumerate text626\newdimen\itemindent \itemindent=.3in627% margin between end of table item and start of table text.628\newdimen\itemmargin \itemmargin=.1in629630% used internally for \itemindent minus \itemmargin631\newdimen\itemmax632633% Note @table and @ftable define @item, @itemx, etc., with these defs.634% They also define \itemindex635% to index the item name in whatever manner is desired (perhaps none).636637\def\internalBitem{\smallbreak \parsearg\itemzzz}638\def\internalBitemx{\par \parsearg\itemzzz}639640\def\internalBxitem "#1"{\def\xitemsubtopix{#1} \smallbreak \parsearg\xitemzzz}641\def\internalBxitemx "#1"{\def\xitemsubtopix{#1} \par \parsearg\xitemzzz}642643\def\internalBkitem{\smallbreak \parsearg\kitemzzz}644\def\internalBkitemx{\par \parsearg\kitemzzz}645646\def\kitemzzz #1{\dosubind {kw}{\code{#1}}{for {\bf \lastfunction}}\itemzzz {#1}}647648\def\xitemzzz #1{\dosubind {kw}{\code{#1}}{for {\bf \xitemsubtopic}}\itemzzz {#1}}649650\def\itemzzz #1{\begingroup %651\advance \hsize by -\rightskip %652\advance \hsize by -\leftskip %653\setbox0=\hbox{\itemfont{#1}}%654\itemindex{#1}%655\parskip=0in %656\noindent %657\ifdim \wd0>\itemmax %658\vadjust{\penalty 10000}%659\hbox to \hsize{\hskip -\tableindent\box0\hss}\ %660\else %661\hbox to 0pt{\hskip -\tableindent\box0\hss}%662\fi %663\endgroup %664}665666\def\item{\errmessage{@item while not in a table}}667\def\itemx{\errmessage{@itemx while not in a table}}668\def\kitem{\errmessage{@kitem while not in a table}}669\def\kitemx{\errmessage{@kitemx while not in a table}}670\def\xitem{\errmessage{@xitem while not in a table}}671\def\xitemx{\errmessage{@xitemx while not in a table}}672673%% Contains a kludge to get @end[description] to work674\def\description{\tablez{\dontindex}{1}{}{}{}{}}675676\def\table{\begingroup\inENV\obeylines\obeyspaces\tablex}677{\obeylines\obeyspaces%678\gdef\tablex #1^^M{%679\tabley\dontindex#1 \endtabley}}680681\def\ftable{\begingroup\inENV\obeylines\obeyspaces\ftablex}682{\obeylines\obeyspaces%683\gdef\ftablex #1^^M{%684\tabley\fnitemindex#1 \endtabley}}685686\def\dontindex #1{}687\def\fnitemindex #1{\doind {fn}{\code{#1}}}%688689{\obeyspaces %690\gdef\tabley#1#2 #3 #4 #5 #6 #7\endtabley{\endgroup%691\tablez{#1}{#2}{#3}{#4}{#5}{#6}}}692693\def\tablez #1#2#3#4#5#6{%694\aboveenvbreak %695\begingroup %696\def\Edescription{\Etable}% Neccessary kludge.697\let\itemindex=#1%698\ifnum 0#3>0 \advance \leftskip by #3\mil \fi %699\ifnum 0#4>0 \tableindent=#4\mil \fi %700\ifnum 0#5>0 \advance \rightskip by #5\mil \fi %701\def\itemfont{#2}%702\itemmax=\tableindent %703\advance \itemmax by -\itemmargin %704\advance \leftskip by \tableindent %705\parindent = 0pt706\parskip = \smallskipamount707\ifdim \parskip=0pt \parskip=2pt \fi%708\def\Etable{\endgraf\endgroup\afterenvbreak}%709\let\item = \internalBitem %710\let\itemx = \internalBitemx %711\let\kitem = \internalBkitem %712\let\kitemx = \internalBkitemx %713\let\xitem = \internalBxitem %714\let\xitemx = \internalBxitemx %715}716717% This is the counter used by @enumerate, which is really @itemize718719\newcount \itemno720721\def\itemize{\parsearg\itemizezzz}722723\def\itemizezzz #1{\itemizey {#1}{\Eitemize}}724725\def\itemizey #1#2{%726\aboveenvbreak %727\begingroup %728\itemno = 0 %729\itemmax=\itemindent %730\advance \itemmax by -\itemmargin %731\advance \leftskip by \itemindent %732\parindent = 0pt733\parskip = \smallskipamount734\ifdim \parskip=0pt \parskip=2pt \fi%735\def#2{\endgraf\endgroup\afterenvbreak}%736\def\itemcontents{#1}%737\let\item=\itemizeitem}738739\def\bullet{$\ptexbullet$}740\def\minus{$-$}741742\def\enumerate{\itemizey{\the\itemno.}\Eenumerate\flushcr}743744% Definition of @item while inside @itemize.745746\def\itemizeitem{%747\advance\itemno by 1748{\let\par=\endgraf \smallbreak}%749\ifhmode \errmessage{\in hmode at itemizeitem}\fi750{\parskip=0in \hskip 0pt751\hbox to 0pt{\hss \itemcontents\hskip \itemmargin}%752\vadjust{\penalty 300}}%753\flushcr}754755\message{indexing,}756% Index generation facilities757758% Define \newwrite to be identical to plain tex's \newwrite759% except not \outer, so it can be used within \newindex.760{\catcode`\@=11761\gdef\newwrite{\alloc@7\write\chardef\sixt@@n}}762763% \newindex {foo} defines an index named foo.764% It automatically defines \fooindex such that765% \fooindex ...rest of line... puts an entry in the index foo.766% It also defines \fooindfile to be the number of the output channel for767% the file that accumulates this index. The file's extension is foo.768% The name of an index should be no more than 2 characters long769% for the sake of vms.770771\def\newindex #1{772\expandafter\newwrite \csname#1indfile\endcsname% Define number for output file773\openout \csname#1indfile\endcsname \jobname.#1 % Open the file774\expandafter\xdef\csname#1index\endcsname{% % Define \xxxindex775\noexpand\doindex {#1}}776}777778% @defindex foo == \newindex{foo}779780\def\defindex{\parsearg\newindex}781782% Define @defcodeindex, like @defindex except put all entries in @code.783784\def\newcodeindex #1{785\expandafter\newwrite \csname#1indfile\endcsname% Define number for output file786\openout \csname#1indfile\endcsname \jobname.#1 % Open the file787\expandafter\xdef\csname#1index\endcsname{% % Define \xxxindex788\noexpand\docodeindex {#1}}789}790791\def\defcodeindex{\parsearg\newcodeindex}792793% @synindex foo bar makes index foo feed into index bar.794% Do this instead of @defindex foo if you don't want it as a separate index.795\def\synindex #1 #2 {%796\expandafter\xdef\csname#1index\endcsname{% % Define \xxxindex797\noexpand\doindex {#2}}%798}799800% @syncodeindex foo bar similar, but put all entries made for index foo801% inside @code.802\def\syncodeindex #1 #2 {%803\expandafter\xdef\csname#1index\endcsname{% % Define \xxxindex804\noexpand\docodeindex {#2}}%805}806807% Define \doindex, the driver for all \fooindex macros.808% Argument #1 is generated by the calling \fooindex macro,809% and it is "foo", the name of the index.810811% \doindex just uses \parsearg; it calls \doind for the actual work.812% This is because \doind is more useful to call from other macros.813814% There is also \dosubind {index}{topic}{subtopic}815% which makes an entry in a two-level index such as the operation index.816817\def\doindex#1{\edef\indexname{#1}\parsearg\singleindexer}818\def\singleindexer #1{\doind{\indexname}{#1}}819820% like the previous two, but they put @code around the argument.821\def\docodeindex#1{\edef\indexname{#1}\parsearg\singlecodeindexer}822\def\singlecodeindexer #1{\doind{\indexname}{\code{#1}}}823824\def\indexdummies{%825\def\bf{\realbackslash bf }%826\def\rm{\realbackslash rm }%827\def\sl{\realbackslash sl }%828\def\dots{\realbackslash dots }%829\def\copyright{\realbackslash copyright }%830}831832% \indexnofonts no-ops all font-change commands.833% This is used when outputting the strings to sort the index by.834\def\indexdummyfont#1{#1}835\def\indexnofonts{%836\let\code=\indexdummyfont837\let\samp=\indexdummyfont838\let\kbd=\indexdummyfont839\let\key=\indexdummyfont840\let\var=\indexdummyfont841}842843% To define \realbackslash, we must make \ not be an escape.844% We must first make another character (@) an escape845% so we do not become unable to do a definition.846847{\catcode`\@=0 \catcode`\\=\other848@gdef@realbackslash{\}}849850\let\indexbackslash=0 %overridden during \printindex.851852\def\doind #1#2{%853{\indexdummies % Must do this here, since \bf, etc expand at this stage854\count10=\lastpenalty %855\escapechar=`\\%856{\let\folio=0% Expand all macros now EXCEPT \folio857\def\rawbackslashxx{\indexbackslash}% \indexbackslash isn't defined now858% so it will be output as is; and it will print as backslash in the indx.859%860% Now process the index-string once, with all font commands turned off,861% to get the string to sort the index by.862{\indexnofonts863\xdef\temp1{#2}%864}%865% Now produce the complete index entry. We process the index-string again,866% this time with font commands expanded, to get what to print in the index.867\edef\temp{%868\write \csname#1indfile\endcsname{%869\realbackslash entry {\temp1}{\folio}{#2}}}%870\temp }%871\penalty\count10}}872873\def\dosubind #1#2#3{%874{\indexdummies % Must do this here, since \bf, etc expand at this stage875\count10=\lastpenalty %876\escapechar=`\\%877{\let\folio=0%878\def\rawbackslashxx{\indexbackslash}%879%880% Now process the index-string once, with all font commands turned off,881% to get the string to sort the index by.882{\indexnofonts883\xdef\temp1{#2 #3}%884}%885% Now produce the complete index entry. We process the index-string again,886% this time with font commands expanded, to get what to print in the index.887\edef\temp{%888\write \csname#1indfile\endcsname{%889\realbackslash entry {\temp1}{\folio}{#2}{#3}}}%890\temp }%891\penalty\count10}}892893% The index entry written in the file actually looks like894% \entry {sortstring}{page}{topic}895% or896% \entry {sortstring}{page}{topic}{subtopic}897% The texindex program reads in these files and writes files898% containing these kinds of lines:899% \initial {c}900% before the first topic whose initial is c901% \entry {topic}{pagelist}902% for a topic that is used without subtopics903% \primary {topic}904% for the beginning of a topic that is used with subtopics905% \secondary {subtopic}{pagelist}906% for each subtopic.907908% Define the user-accessible indexing commands909% @findex, @vindex, @kindex, @cindex.910911\def\findex {\fnindex}912\def\kindex {\kyindex}913\def\cindex {\cpindex}914\def\vindex {\vrindex}915\def\tindex {\tpindex}916\def\pindex {\pgindex}917918\def\cindexsub {\begingroup\obeylines\cindexsub}919{\obeylines %920\gdef\cindexsub "#1" #2^^M{\endgroup %921\dosubind{cp}{#2}{#1}}}922923% Define the macros used in formatting output of the sorted index material.924925% This is what you call to cause a particular index to get printed.926% Write927% @unnumbered Function Index928% @printindex fn929930\def\printindex{\parsearg\doprintindex}931932\def\doprintindex#1{\tex %933\catcode`\%=\other\catcode`\&=\other\catcode`\#=\other934\catcode`\$=\other\catcode`\_=\other935\catcode`\~=\other936\def\indexbackslash{\rawbackslashxx}937\indexfonts\rm \tolerance=9500 \advance\baselineskip -1pt938\begindoublecolumns939\openin 1 \jobname.#1s940\ifeof 1 \else \closein 1 \input \jobname.#1s941\fi942\enddoublecolumns943\Etex}944945% These macros are used by the sorted index file itself.946% Change them to control the appearance of the index.947948% Same as \bigskipamount except no shrink.949% \balancecolumns gets confused if there is any shrink.950\newskip\initialskipamount \initialskipamount 12pt plus4pt951952\outer\def\initial #1{%953{\let\tentt=\sectt \let\sf=\sectt954\ifdim\lastskip<\initialskipamount955\removelastskip \penalty-200 \vskip \initialskipamount\fi956\line{\secbf#1\hfill}\kern 2pt\penalty3000}}957958\outer\def\entry #1#2{959{\parfillskip=0in \parskip=0in \parindent=0in960\hangindent=1in \hangafter=1%961\noindent\hbox{#1}\leaders\Dotsbox\hskip 0pt plus 1filll #2\par962}}963964\def\primary #1{\line{#1\hfil}}965966\newskip\secondaryindent \secondaryindent=0.5cm967968\def\secondary #1#2{969{\parfillskip=0in \parskip=0in970\hangindent =1in \hangafter=1971\noindent\hskip\secondaryindent\hbox{#1}\leaders\Dotsbox\hskip 0pt plus 1filll#2\par972}}973974%% Define two-column mode, which is used in indexes.975%% Adapted from the TeXBook, page 416976\catcode `\@=11977978\newbox\partialpage979980\newdimen\doublecolumnhsize \doublecolumnhsize = 3.11in981\newdimen\doublecolumnvsize \doublecolumnvsize = 19.1in982983\def\begindoublecolumns{\begingroup984\output={\global\setbox\partialpage=\vbox{\unvbox255\kern -\topskip \kern \baselineskip}}\eject985\output={\doublecolumnout} \hsize=\doublecolumnhsize \vsize=\doublecolumnvsize}986\def\enddoublecolumns{\output={\balancecolumns}\eject987\endgroup \pagegoal=\vsize}988989\def\doublecolumnout{\splittopskip=\topskip \splitmaxdepth=\maxdepth990\dimen@=\pageheight \advance\dimen@ by-\ht\partialpage991\setbox0=\vsplit255 to\dimen@ \setbox2=\vsplit255 to\dimen@992\onepageout\pagesofar \unvbox255 \penalty\outputpenalty}993\def\pagesofar{\unvbox\partialpage %994\hsize=\doublecolumnhsize % have to restore this since output routine995% changes it to set cropmarks (P. A. MacKay, 12 Nov. 1986)996\wd0=\hsize \wd2=\hsize \hbox to\pagewidth{\box0\hfil\box2}}997\def\balancecolumns{\setbox0=\vbox{\unvbox255} \dimen@=\ht0998\advance\dimen@ by\topskip \advance\dimen@ by-\baselineskip999\divide\dimen@ by2 \splittopskip=\topskip1000{\vbadness=10000 \loop \global\setbox3=\copy01001\global\setbox1=\vsplit3 to\dimen@1002\ifdim\ht3>\dimen@ \global\advance\dimen@ by1pt \repeat}1003\setbox0=\vbox to\dimen@{\unvbox1} \setbox2=\vbox to\dimen@{\unvbox3}1004\pagesofar}10051006\catcode `\@=\other1007\message{sectioning,}1008% Define chapters, sections, etc.10091010\newcount \chapno1011\newcount \secno1012\newcount \subsecno1013\newcount \subsubsecno10141015% This counter is funny since it counts through charcodes of letters A, B, ...1016\newcount \appendixno \appendixno = `\@1017\def\appendixletter{\char\the\appendixno}10181019\newwrite \contentsfile1020\openout \contentsfile = \jobname.toc10211022% Each @chapter defines this as the name of the chapter.1023% page headings and footings can use it. @section does likewise10241025\def\thischapter{} \def\thissection{}1026\def\seccheck#1{\if \pageno<0 %1027\errmessage{@#1 not allowed after generating table of contents}\fi1028%1029}10301031\outer\def\chapter{\parsearg\chapterzzz}1032\def\chapterzzz #1{\seccheck{chapter}%1033\secno=0 \subsecno=0 \subsubsecno=0 \global\advance \chapno by 1 \message{Chapter \the\chapno}%1034\chapmacro {#1}{\the\chapno}%1035\gdef\thissection{#1}\gdef\thischapter{#1}%1036\let\rawbackslash=\relax%1037\let\frenchspacing=\relax%1038\edef\temp{{\realbackslash chapentry {#1}{\the\chapno}{\noexpand\folio}}}%1039\escapechar=`\\%1040\write \contentsfile \temp %1041\donoderef %1042}10431044\outer\def\appendix{\parsearg\appendixzzz}1045\def\appendixzzz #1{\seccheck{appendix}%1046\secno=0 \subsecno=0 \subsubsecno=0 \global\advance \appendixno by 1 \message{Appendix \appendixletter}%1047\chapmacro {#1}{Appendix \appendixletter}%1048\gdef\thischapter{#1}\gdef\thissection{#1}%1049\let\rawbackslash=\relax%1050\let\frenchspacing=\relax%1051\edef\temp{{\realbackslash chapentry {#1}{Appendix \appendixletter}{\noexpand\folio}}}%1052\escapechar=`\\%1053\write \contentsfile \temp %1054\unnumbnoderef %1055}10561057\outer\def\unnumbered{\parsearg\unnumberedzzz}1058\def\unnumberedzzz #1{\seccheck{unnumbered}%1059\secno=0 \subsecno=0 \subsubsecno=0 \message{(#1)}1060\unnumbchapmacro {#1}%1061\gdef\thischapter{#1}\gdef\thissection{#1}%1062\let\rawbackslash=\relax%1063\let\frenchspacing=\relax%1064\edef\temp{{\realbackslash unnumbchapentry {#1}{\noexpand\folio}}}%1065\escapechar=`\\%1066\write \contentsfile \temp %1067\unnumbnoderef %1068}10691070\outer\def\section{\parsearg\sectionzzz}1071\def\sectionzzz #1{\seccheck{section}%1072\subsecno=0 \subsubsecno=0 \global\advance \secno by 1 %1073\gdef\thissection{#1}\secheading {#1}{\the\chapno}{\the\secno}%1074\let\rawbackslash=\relax%1075\let\frenchspacing=\relax%1076\edef\temp{{\realbackslash secentry %1077{#1}{\the\chapno}{\the\secno}{\noexpand\folio}}}%1078\escapechar=`\\%1079\write \contentsfile \temp %1080\donoderef %1081\penalty 10000 %1082}10831084\outer\def\appendixsection{\parsearg\appendixsectionzzz}1085\outer\def\appendixsec{\parsearg\appendixsectionzzz}1086\def\appendixsectionzzz #1{\seccheck{appendixsection}%1087\subsecno=0 \subsubsecno=0 \global\advance \secno by 1 %1088\gdef\thissection{#1}\secheading {#1}{\appendixletter}{\the\secno}%1089\let\rawbackslash=\relax%1090\let\frenchspacing=\relax%1091\edef\temp{{\realbackslash secentry %1092{#1}{\appendixletter}{\the\secno}{\noexpand\folio}}}%1093\escapechar=`\\%1094\write \contentsfile \temp %1095\unnumbnoderef %1096\penalty 10000 %1097}10981099\outer\def\unnumberedsec{\parsearg\unnumberedseczzz}1100\def\unnumberedseczzz #1{\seccheck{unnumberedsec}%1101\plainsecheading {#1}\gdef\thissection{#1}%1102\let\rawbackslash=\relax%1103\let\frenchspacing=\relax%1104\edef\temp{{\realbackslash unnumbsecentry{#1}{\noexpand\folio}}}%1105\escapechar=`\\%1106\write \contentsfile \temp %1107\unnumbnoderef %1108\penalty 10000 %1109}11101111\outer\def\subsection{\parsearg\subsectionzzz}1112\def\subsectionzzz #1{\seccheck{subsection}%1113\gdef\thissection{#1}\subsubsecno=0 \global\advance \subsecno by 1 %1114\subsecheading {#1}{\the\chapno}{\the\secno}{\the\subsecno}%1115\let\rawbackslash=\relax%1116\let\frenchspacing=\relax%1117\edef\temp{{\realbackslash subsecentry %1118{#1}{\the\chapno}{\the\secno}{\the\subsecno}{\noexpand\folio}}}%1119\escapechar=`\\%1120\write \contentsfile \temp %1121\donoderef %1122\penalty 10000 %1123}11241125\outer\def\appendixsubsec{\parsearg\appendixsubseczzz}1126\def\appendixsubseczzz #1{\seccheck{appendixsubsec}%1127\gdef\thissection{#1}\subsubsecno=0 \global\advance \subsecno by 1 %1128\subsecheading {#1}{\appendixletter}{\the\secno}{\the\subsecno}%1129\let\rawbackslash=\relax%1130\let\frenchspacing=\relax%1131\edef\temp{{\realbackslash subsecentry %1132{#1}{\appendixletter}{\the\secno}{\the\subsecno}{\noexpand\folio}}}%1133\escapechar=`\\%1134\write \contentsfile \temp %1135\unnumbnoderef %1136\penalty 10000 %1137}11381139\outer\def\unnumberedsubsec{\parsearg\unnumberedsubseczzz}1140\def\unnumberedsubseczzz #1{\seccheck{unnumberedsubsec}%1141\plainsecheading {#1}\gdef\thissection{#1}%1142\let\rawbackslash=\relax%1143\let\frenchspacing=\relax%1144\edef\temp{{\realbackslash unnumbsubsecentry{#1}{\noexpand\folio}}}%1145\escapechar=`\\%1146\write \contentsfile \temp %1147\unnumbnoderef %1148\penalty 10000 %1149}11501151\outer\def\subsubsection{\parsearg\subsubsectionzzz}1152\def\subsubsectionzzz #1{\seccheck{subsubsection}%1153\gdef\thissection{#1}\global\advance \subsubsecno by 1 %1154\subsubsecheading {#1}{\the\chapno}{\the\secno}{\the\subsecno}{\the\subsubsecno}%1155\let\rawbackslash=\relax%1156\let\frenchspacing=\relax%1157\edef\temp{{\realbackslash subsubsecentry %1158{#1}{\the\chapno}{\the\secno}{\the\subsecno}{\the\subsubsecno}{\noexpand\folio}}}%\1159\escapechar=`\\%1160\write \contentsfile \temp %1161\donoderef %1162\penalty 10000 %1163}11641165\outer\def\appendixsubsubsec{\parsearg\appendixsubsubseczzz}1166\def\appendixsubsubseczzz #1{\seccheck{appendixsubsubsec}%1167\gdef\thissection{#1}\global\advance \subsubsecno by 1 %1168\subsubsecheading {#1}{\appendixletter}{\the\secno}{\the\subsecno}{\the\subsubsecno}%1169\let\rawbackslash=\relax%1170\let\frenchspacing=\relax%1171\edef\temp{{\realbackslash subsubsecentry{#1}%1172{\appendixletter}{\the\secno}{\the\subsecno}{\the\subsubsecno}{\noexpand\folio}}}%\1173\escapechar=`\\%1174\write \contentsfile \temp %1175\unnumbnoderef %1176\penalty 10000 %1177}11781179\outer\def\unnumberedsubsubsec{\parsearg\unnumberedsubsubseczzz}1180\def\unnumberedsubsubseczzz #1{\seccheck{unnumberedsubsubsec}%1181\plainsecheading {#1}\gdef\thissection{#1}%1182\let\rawbackslash=\relax%1183\let\frenchspacing=\relax%1184\edef\temp{{\realbackslash unnumbsubsubsecentry{#1}{\noexpand\folio}}}%1185\escapechar=`\\%1186\write \contentsfile \temp %1187\unnumbnoderef %1188\penalty 10000 %1189}11901191% Define @majorheading, @heading and @subheading11921193\outer\def\majorheading #1{%1194{\advance\chapheadingskip by 10pt \chapbreak }%1195{\chapfonts \line{\chaprm #1\hfill}}\bigskip \par\penalty 200}11961197\outer\def\chapheading #1{\chapbreak %1198{\chapfonts \line{\chaprm #1\hfill}}\bigskip \par\penalty 200}11991200\let\heading=\secheadingi1201\let\subheading=\subsecheadingi1202\let\subsubheading=\subsubsecheadingi12031204% These macros generate a chapter, section, etc. heading only1205% (including whitespace, linebreaking, etc. around it),1206% given all the information in convenient, parsed form.12071208%%% Args are the skip and penalty (usually negative)1209\def\dobreak#1#2{\par\ifdim\lastskip<#1\removelastskip\penalty#2\vskip#1\fi}12101211\def\setchapterstyle #1 {\csname CHAPF#1\endcsname}12121213%%% Define plain chapter starts, and page on/off switching for it1214% Parameter controlling skip before chapter headings (if needed)12151216\newskip \chapheadingskip \chapheadingskip = 30pt plus 8pt minus 4pt12171218\def\chapbreak{\dobreak \chapheadingskip {-4000}}1219\def\chappager{\par\vfill\supereject}1220\def\chapoddpage{\chappager \ifodd\pageno \else \hbox to 0pt{} \chappager\fi}12211222\def\setchapternewpage #1 {\csname CHAPPAG#1\endcsname}12231224\def\CHAPPAGoff{1225\global\let\pchapsepmacro=\chapbreak1226\global\let\pagealignmacro=\chappager}12271228\def\CHAPPAGon{1229\global\let\pchapsepmacro=\chappager1230\global\let\pagealignmacro=\chappager}12311232\def\CHAPPAGodd{1233\global\let\pchapsepmacro=\chapoddpage1234\global\let\pagealignmacro=\chapoddpage}12351236\CHAPPAGon12371238\def\CHAPFplain{1239\global\let\chapmacro=\chfplain1240\global\let\unnumbchapmacro=\unnchfplain}12411242\def\chfplain #1#2{%1243\pchapsepmacro %1244{\chapfonts \line{\chaprm #2.\enspace #1\hfill}}\bigskip \par\penalty 5000 %1245}12461247\def\unnchfplain #1{%1248\pchapsepmacro %1249{\chapfonts \line{\chaprm #1\hfill}}\bigskip \par\penalty 10000 %1250}1251\CHAPFplain % The default12521253\def\unnchfopen #1{%1254\chapoddpage {\chapfonts \line{\chaprm #1\hfill}}\bigskip \par\penalty 10000 %1255}12561257\def\chfopen #1#2{\chapoddpage {\chapfonts1258\vbox to 3in{\vfil \hbox to\hsize{\hfil #2} \hbox to\hsize{\hfil #1} \vfil}}%1259\par\penalty 5000 %1260}12611262\def\CHAPFopen{1263\global\let\chapmacro=\chfopen1264\global\let\unnumbchapmacro=\unnchfopen}12651266% Parameter controlling skip before section headings.12671268\newskip \subsecheadingskip \subsecheadingskip = 17pt plus 8pt minus 4pt1269\def\subsecheadingbreak{\dobreak \subsecheadingskip {-500}}12701271\newskip \secheadingskip \secheadingskip = 21pt plus 8pt minus 4pt1272\def\secheadingbreak{\dobreak \secheadingskip {-1000}}12731274\def\secheading #1#2#3{\secheadingi {#2.#3\enspace #1}}1275\def\plainsecheading #1{\secheadingi {#1}}1276\def\secheadingi #1{{\advance \secheadingskip by \parskip %1277\secheadingbreak}%1278{\secfonts \line{\secrm #1\hfill}}%1279\ifdim \parskip<10pt \kern 10pt\kern -\parskip\fi \penalty 10000 }12801281\def\subsecheading #1#2#3#4{{\advance \subsecheadingskip by \parskip %1282\subsecheadingbreak}%1283{\secfonts \line{\secrm#2.#3.#4\enspace #1\hfill}}%1284\ifdim \parskip<10pt \kern 10pt\kern -\parskip\fi \penalty 10000 }12851286\def\subsubsecfonts{\subsecfonts} % Maybe this should change12871288\def\subsubsecheading #1#2#3#4#5{{\advance \subsecheadingskip by \parskip %1289\subsecheadingbreak}%1290{\secfonts \line{\secrm#2.#3.#4.#5\enspace #1\hfill}}%1291\ifdim \parskip<10pt \kern 10pt\kern -\parskip\fi \penalty 10000}12921293\message{toc printing,}12941295\def\Dotsbox{\hbox to 1em{\hss.\hss}} % Used by index macros12961297\def\finishcontents{%1298\ifnum\pageno>0 %1299\pagealignmacro %1300\immediate\closeout \contentsfile%1301\pageno=-1 % Request roman numbered pages1302\fi}13031304\outer\def\contents{%1305\finishcontents %1306\unnumbchapmacro{Table of Contents}1307\def\thischapter{Table of Contents}1308{\catcode`\\=01309\catcode`\{=1 % Set up to handle contents files properly1310\catcode`\}=21311\catcode`\@=111312\input \jobname.toc1313}1314\vfill \eject}13151316\outer\def\summarycontents{%1317\finishcontents %1318\unnumbchapmacro{Summary Table of Contents}1319\def\thischapter{Summary Table of Contents}1320{\catcode`\\=01321\catcode`\{=1 % Set up to handle contents files properly1322\catcode`\}=21323\catcode`\@=111324\def\smallbreak{}1325\def\secentry ##1##2##3##4{}1326\def\subsecentry ##1##2##3##4##5{}1327\def\subsubsecentry ##1##2##3##4##5##6{}1328\def\unnumbsecentry ##1##2{}1329\def\unnumbsubsecentry ##1##2{}1330\def\unnumbsubsubsecentry ##1##2{}1331\let\medbreak=\smallbreak1332\input \jobname.toc1333}1334\vfill \eject}13351336\outer\def\bye{\pagealignmacro\tracingstats=1\ptexend}13371338% These macros generate individual entries in the table of contents1339% The first argument is the chapter or section name.1340% The last argument is the page number.1341% The arguments in between are the chapter number, section number, ...13421343\def\chapentry #1#2#3{%1344\medbreak1345\line{#2.\space#1\leaders\hbox to 1em{\hss.\hss}\hfill #3}1346}13471348\def\unnumbchapentry #1#2{%1349\medbreak1350\line{#1\leaders\Dotsbox\hfill #2}1351}13521353\def\secentry #1#2#3#4{%1354\line{\enspace\enspace#2.#3\space#1\leaders\Dotsbox\hfill#4}1355}13561357\def\unnumbsecentry #1#2{%1358\line{\enspace\enspace#1\leaders\Dotsbox\hfill #2}1359}13601361\def\subsecentry #1#2#3#4#5{%1362\line{\enspace\enspace\enspace\enspace1363#2.#3.#4\space#1\leaders\Dotsbox\hfill #5}1364}13651366\def\unnumbsubsecentry #1#2{%1367\line{\enspace\enspace\enspace\enspace#1\leaders\Dotsbox\hfill #2}1368}13691370\def\subsubsecentry #1#2#3#4#5#6{%1371\line{\enspace\enspace\enspace\enspace\enspace\enspace1372#2.#3.#4.#5\space#1\leaders\Dotsbox\hfill #6}1373}13741375\def\unnumbsubsubsecentry #1#2{%1376\line{\enspace\enspace\enspace\enspace\enspace\enspace#1\leaders\Dotsbox\hfill #2}1377}13781379\message{environments,}13801381% @tex ... @end tex escapes into raw Tex temporarily.1382% One exception: @ is still an escape character, so that @end tex works.1383% But \@ or @@ will get a plain tex @ character.13841385\def\tex{\begingroup1386\catcode `\\=0 \catcode `\{=1 \catcode `\}=21387\catcode `\$=3 \catcode `\&=4 \catcode `\#=61388\catcode `\^=7 \catcode `\_=8 \catcode `\~=13 \let~=\tie1389\catcode `\%=141390\catcode`\"=121391\catcode`\|=121392\catcode`\<=121393\catcode`\>=121394\escapechar=`\\1395%1396\let\{=\ptexlbrace1397\let\}=\ptexrbrace1398\let\.=\ptexdot1399\let\*=\ptexstar1400\def\@={@}%1401\let\bullet=\ptexbullet1402\let\b=\ptexb \let\c=\ptexc \let\i=\ptexi \let\t=\ptext \let\l=\ptexl1403\let\L=\ptexL1404%1405\let\Etex=\endgroup}14061407% Define @lisp ... @endlisp.1408% @lisp does a \begingroup so it can rebind things,1409% including the definition of @endlisp (which normally is erroneous).14101411% Amount to narrow the margins by for @lisp.1412\newskip\lispnarrowing \lispnarrowing=0.4in14131414% This is the definition that ^M gets inside @lisp1415% phr: changed space to \null, to avoid overfull hbox problems.1416{\obeyspaces%1417\gdef\lisppar{\null\endgraf}}14181419% Cause \obeyspaces to make each Space cause a word-separation1420% rather than the default which is that it acts punctuation.1421% This is because space in tt font looks funny.1422{\obeyspaces %1423\gdef\sepspaces{\def {\ }}}14241425\newskip\aboveenvskipamount \aboveenvskipamount= 0pt1426\def\aboveenvbreak{{\advance\aboveenvskipamount by \parskip1427\endgraf \ifdim\lastskip<\aboveenvskipamount1428\removelastskip \penalty-50 \vskip\aboveenvskipamount \fi}}14291430\def\afterenvbreak{\endgraf \ifdim\lastskip<\aboveenvskipamount1431\removelastskip \penalty-50 \vskip\aboveenvskipamount \fi}14321433\def\lisp{\aboveenvbreak\begingroup\inENV %This group ends at the end of the @lisp body1434\hfuzz=12truept % Don't be fussy1435% Make spaces be word-separators rather than space tokens.1436\sepspaces %1437% Single space lines1438\singlespace %1439% The following causes blank lines not to be ignored1440% by adding a space to the end of each line.1441\let\par=\lisppar1442\def\Elisp{\endgroup\afterenvbreak}%1443\parskip=0pt \advance \rightskip by \lispnarrowing1444\advance \leftskip by \lispnarrowing1445\parindent=0pt1446\let\exdent=\internalexdent1447\obeyspaces \obeylines \tt \rawbackslash1448\def\next##1{}\next}144914501451\let\example=\lisp1452\def\Eexample{\Elisp}14531454\let\smallexample=\lisp1455\def\Esmallexample{\Elisp}14561457% Macro for 9 pt. examples, necessary to print with 5" lines.1458% From Pavel@xerox. This is not really used unless the1459% @smallbook command is given.14601461\def\smalllispx{\aboveenvbreak\begingroup\inENV1462% This group ends at the end of the @lisp body1463\hfuzz=12truept % Don't be fussy1464% Make spaces be word-separators rather than space tokens.1465\sepspaces %1466% Single space lines1467\singlespace %1468% The following causes blank lines not to be ignored1469% by adding a space to the end of each line.1470\let\par=\lisppar1471\def\Esmalllisp{\endgroup\afterenvbreak}%1472\parskip=0pt \advance \rightskip by \lispnarrowing1473\advance \leftskip by \lispnarrowing1474\parindent=0pt1475\let\exdent=\internalexdent1476\obeyspaces \obeylines \ninett \rawbackslash1477\def\next##1{}\next}14781479% This is @display; same as @lisp except use roman font.14801481\def\display{\begingroup\inENV %This group ends at the end of the @display body1482\aboveenvbreak1483% Make spaces be word-separators rather than space tokens.1484\sepspaces %1485% Single space lines1486\singlespace %1487% The following causes blank lines not to be ignored1488% by adding a space to the end of each line.1489\let\par=\lisppar1490\def\Edisplay{\endgroup\afterenvbreak}%1491\parskip=0pt \advance \rightskip by \lispnarrowing1492\advance \leftskip by \lispnarrowing1493\parindent=0pt1494\let\exdent=\internalexdent1495\obeyspaces \obeylines1496\def\next##1{}\next}14971498% This is @format; same as @lisp except use roman font and don't narrow margins14991500\def\format{\begingroup\inENV %This group ends at the end of the @format body1501\aboveenvbreak1502% Make spaces be word-separators rather than space tokens.1503\sepspaces %1504\singlespace %1505% The following causes blank lines not to be ignored1506% by adding a space to the end of each line.1507\let\par=\lisppar1508\def\Eformat{\endgroup\afterenvbreak}1509\parskip=0pt \parindent=0pt1510\obeyspaces \obeylines1511\def\next##1{}\next}15121513% @flushleft and @flushright15141515\def\flushleft{\begingroup\inENV %This group ends at the end of the @format body1516\aboveenvbreak1517% Make spaces be word-separators rather than space tokens.1518\sepspaces %1519% The following causes blank lines not to be ignored1520% by adding a space to the end of each line.1521% This also causes @ to work when the directive name1522% is terminated by end of line.1523\let\par=\lisppar1524\def\Eflushleft{\endgroup\afterenvbreak}%1525\parskip=0pt \parindent=0pt1526\obeyspaces \obeylines1527\def\next##1{}\next}15281529\def\flushright{\begingroup\inENV %This group ends at the end of the @format body1530\aboveenvbreak1531% Make spaces be word-separators rather than space tokens.1532\sepspaces %1533% The following causes blank lines not to be ignored1534% by adding a space to the end of each line.1535% This also causes @ to work when the directive name1536% is terminated by end of line.1537\let\par=\lisppar1538\def\Eflushright{\endgroup\afterenvbreak}%1539\parskip=0pt \parindent=0pt1540\advance \leftskip by 0pt plus 1fill1541\obeyspaces \obeylines1542\def\next##1{}\next}15431544% @quotation - narrow the margins.15451546\def\quotation{\begingroup\inENV %This group ends at the end of the @quotation body1547{\parskip=0pt % because we will skip by \parskip too, later1548\aboveenvbreak}%1549\singlespace1550\parindent=0pt1551\def\Equotation{\par\endgroup\afterenvbreak}%1552\advance \rightskip by \lispnarrowing1553\advance \leftskip by \lispnarrowing}15541555\message{defuns,}1556% Define formatter for defuns1557% First, allow user to change definition object font (\df) internally1558\def\setdeffont #1 {\csname DEF#1\endcsname}15591560\newskip\defbodyindent \defbodyindent=36pt1561\newskip\defargsindent \defargsindent=50pt1562\newskip\deftypemargin \deftypemargin=12pt1563\newskip\deflastargmargin \deflastargmargin=18pt15641565\newcount\parencount1566% define \functionparens, which makes ( and ) and & do special things.1567% \functionparens affects the group it is contained in.1568\def\activeparens{%1569\catcode`\(=\active \catcode`\)=\active \catcode`\&=\active1570\catcode`\[=\active \catcode`\]=\active}1571{\activeparens % Now, smart parens don't turn on until &foo (see \amprm)1572\gdef\functionparens{\boldbrax\let&=\amprm\parencount=0 }1573\gdef\boldbrax{\let(=\opnr\let)=\clnr\let[=\lbrb\let]=\rbrb}15741575% Definitions of (, ) and & used in args for functions.1576% This is the definition of ( outside of all parentheses.1577\gdef\oprm#1 {{\rm\char`\(}#1 \bf \let(=\opnested %1578\global\advance\parencount by 1 }1579%1580% This is the definition of ( when already inside a level of parens.1581\gdef\opnested{\char`\(\global\advance\parencount by 1 }1582%1583\gdef\clrm{% Print a paren in roman if it is taking us back to depth of 0.1584% also in that case restore the outer-level definition of (.1585\ifnum \parencount=1 {\rm \char `\)}\sl \let(=\oprm \else \char `\) \fi1586\global\advance \parencount by -1 }1587% If we encounter &foo, then turn on ()-hacking afterwards1588\gdef\amprm#1 {{\rm\}\let(=\oprm \let)=\clrm\ }1589%1590\gdef\normalparens{\boldbrax\let&=\ampnr}1591} % End of definition inside \activeparens1592%% These parens (in \boldbrax) actually are a little bolder than the1593%% contained text. This is especially needed for [ and ]1594\def\opnr{{\sf\char`\(}} \def\clnr{{\sf\char`\)}} \def\ampnr{\&}1595\def\lbrb{{\tt\char`\[}} \def\rbrb{{\tt\char`\]}}15961597% First, defname, which formats the header line itself.1598% #1 should be the function name.1599% #2 should be the type of definition, such as "Function".16001601\def\defname #1#2{%1602\leftskip = 0in %1603\noindent %1604\setbox0=\hbox{\hskip \deflastargmargin{\rm #2}\hskip \deftypemargin}%1605\dimen0=\hsize \advance \dimen0 by -\wd0 % compute size for first line1606\dimen1=\hsize \advance \dimen1 by -\defargsindent %size for continuations1607\parshape 2 0in \dimen0 \defargsindent \dimen1 %1608% Now output arg 2 ("Function" or some such)1609% ending at \deftypemargin from the right margin,1610% but stuck inside a box of width 0 so it does not interfere with linebreaking1611\rlap{\rightline{{\rm #2}\hskip \deftypemargin}}%1612\tolerance=10000 \hbadness=10000 % Make all lines underfull and no complaints1613{\df #1}\enskip % Generate function name1614}16151616% Actually process the body of a definition1617% #1 should be the terminating control sequence, such as \Edefun.1618% #2 should be the "another name" control sequence, such as \defunx.1619% #3 should be the control sequence that actually processes the header,1620% such as \defunheader.16211622\def\defparsebody #1#2#3{\begingroup\inENV% Environment for definitionbody1623\medbreak %1624% Define the end token that this defining construct specifies1625% so that it will exit this group.1626\def#1{\endgraf\endgroup\medbreak}%1627\def#2{\begingroup\obeylines\activeparens\spacesplit#3}%1628\parindent=0in \leftskip=\defbodyindent %1629\begingroup\obeylines\activeparens\spacesplit#3}16301631\def\defmethparsebody #1#2#3#4 {\begingroup\inENV %1632\medbreak %1633% Define the end token that this defining construct specifies1634% so that it will exit this group.1635\def#1{\endgraf\endgroup\medbreak}%1636\def#2##1 {\begingroup\obeylines\activeparens\spacesplit{#3{##1}}}%1637\parindent=0in \leftskip=\defbodyindent %1638\begingroup\obeylines\activeparens\spacesplit{#3{#4}}}16391640% Split up #2 at the first space token.1641% call #1 with two arguments:1642% the first is all of #2 before the space token,1643% the second is all of #2 after that space token.1644% If #2 contains no space token, all of it is passed as the first arg1645% and the second is passed as empty.16461647{\obeylines1648\gdef\spacesplit#1#2^^M{\endgroup\spacesplitfoo{#1}#2 \relax\spacesplitfoo}%1649\long\gdef\spacesplitfoo#1#2 #3#4\spacesplitfoo{%1650\ifx\relax #3%1651#1{#2}{}\else #1{#2}{#3#4}\fi}}16521653% So much for the things common to all kinds of definitions.16541655% Define @defun.16561657% First, define the processing that is wanted for arguments of \defun1658% Use this to expand the args and terminate the paragraph they make up16591660\def\defunargs #1{\functionparens \sl #1%1661\ifnum\parencount=0 \else \errmessage{unbalanced parens in @def arguments}\fi%1662\interlinepenalty=100001663\endgraf\vskip -\parskip \penalty 10000}16641665% Do complete processing of one @defun or @defunx line already parsed.16661667% @deffn Command forward-char nchars16681669\def\deffn{\defmethparsebody\Edeffn\deffnx\deffnheader}16701671\def\deffnheader #1#2#3{\doind {fn}{\code{#2}}%1672\begingroup\defname {#2}{#1}\defunargs{#3}\endgroup}16731674% @defun == @deffn Function16751676\def\defun{\defparsebody\Edefun\defunx\defunheader}16771678\def\defunheader #1#2{\doind {fn}{\code{#1}}% Make entry in function index1679\begingroup\defname {#1}{Function}%1680\defunargs {#2}\endgroup %1681}16821683% @defmac == @deffn Macro16841685\def\defmac{\defparsebody\Edefmac\defmacx\defmacheader}16861687\def\defmacheader #1#2{\doind {fn}{\code{#1}}% Make entry in function index1688\begingroup\defname {#1}{Macro}%1689\defunargs {#2}\endgroup %1690}16911692% @defspec == @deffn Special Form16931694\def\defspec{\defparsebody\Edefspec\defspecx\defspecheader}16951696\def\defspecheader #1#2{\doind {fn}{\code{#1}}% Make entry in function index1697\begingroup\defname {#1}{Special form}%1698\defunargs {#2}\endgroup %1699}17001701% This definition is run if you use @defunx1702% anywhere other than immediately after a @defun or @defunx.17031704\def\deffnx #1 {\errmessage{@deffnx in invalid context}}1705\def\defunx #1 {\errmessage{@defunx in invalid context}}1706\def\defmacx #1 {\errmessage{@defmacx in invalid context}}1707\def\defspecx #1 {\errmessage{@defspecx in invalid context}}17081709% @defmethod, and so on17101711% @defop {Funny Method} foo-class frobnicate argument17121713\def\defop #1 {\def\defoptype{#1}%1714\defmethparsebody\Edefop\defopx\defopheader}17151716\def\defopheader #1#2#3{\dosubind {fn}{\code{#2}}{on #1}% Make entry in function index1717\begingroup\defname {#2}{\defoptype{} on #1}%1718\defunargs {#3}\endgroup %1719}17201721% @defmethod == @defop Method17221723\def\defmethod{\defmethparsebody\Edefmethod\defmethodx\defmethodheader}17241725\def\defmethodheader #1#2#3{\dosubind {fn}{\code{#2}}{on #1}% entry in function index1726\begingroup\defname {#2}{Operation on #1}%1727\defunargs {#3}\endgroup %1728}17291730% @defcv {Class Option} foo-class foo-flag17311732\def\defcv #1 {\def\defcvtype{#1}%1733\defmethparsebody\Edefcv\defcvx\defcvheader}17341735\def\defcvarheader #1#2#3{%1736\dosubind {vr}{\code{#2}}{of #1}% Make entry in var index1737\begingroup\defname {#2}{\defcvtype of #1}%1738\defvarargs {#3}\endgroup %1739}17401741% @defivar == @defcv {Instance Variable}17421743\def\defivar{\defmethparsebody\Edefivar\defivarx\defivarheader}17441745\def\defivarheader #1#2#3{%1746\dosubind {vr}{\code{#2}}{of #1}% Make entry in var index1747\begingroup\defname {#2}{Instance variable of #1}%1748\defvarargs {#3}\endgroup %1749}17501751% These definitions are run if you use @defmethodx, etc.,1752% anywhere other than immediately after a @defmethod, etc.17531754\def\defopx #1 {\errmessage{@defopx in invalid context}}1755\def\defmethodx #1 {\errmessage{@defmethodx in invalid context}}1756\def\defcvx #1 {\errmessage{@defcvx in invalid context}}1757\def\defivarx #1 {\errmessage{@defivarx in invalid context}}17581759% Now @defvar17601761% First, define the processing that is wanted for arguments of @defvar.1762% This is actually simple: just print them in roman.1763% This must expand the args and terminate the paragraph they make up1764\def\defvarargs #1{\normalparens #1%1765\interlinepenalty=100001766\endgraf\vskip -\parskip \penalty 10000}17671768% @defvr Counter foo-count17691770\def\defvr{\defmethparsebody\Edefvr\defvrx\defvrheader}17711772\def\defvrheader #1#2#3{\doind {vr}{\code{#2}}%1773\begingroup\defname {#2}{#1}\defvarargs{#3}\endgroup}17741775% @defvar == @defvr Variable17761777\def\defvar{\defparsebody\Edefvar\defvarx\defvarheader}17781779\def\defvarheader #1#2{\doind {vr}{\code{#1}}% Make entry in var index1780\begingroup\defname {#1}{Variable}%1781\defvarargs {#2}\endgroup %1782}17831784% @defopt == @defvr {User Option}17851786\def\defopt{\defparsebody\Edefopt\defoptx\defoptheader}17871788\def\defoptheader #1#2{\doind {vr}{\code{#1}}% Make entry in var index1789\begingroup\defname {#1}{User Option}%1790\defvarargs {#2}\endgroup %1791}17921793% This definition is run if you use @defvarx1794% anywhere other than immediately after a @defvar or @defvarx.17951796\def\defvrx #1 {\errmessage{@defvrx in invalid context}}1797\def\defvarx #1 {\errmessage{@defvarx in invalid context}}1798\def\defoptx #1 {\errmessage{@defoptx in invalid context}}17991800% Now define @deftp1801% Args are printed in bold, a slight difference from @defvar.18021803\def\deftpargs #1{\bf \defvarargs{#1}}18041805% @deftp Class window height width ...18061807\def\deftp{\defmethparsebody\Edeftp\deftpx\deftpheader}18081809\def\deftpheader #1#2#3{\doind {tp}{\code{#2}}%1810\begingroup\defname {#2}{#1}\deftpargs{#3}\endgroup}18111812% This definition is run if you use @deftpx, etc1813% anywhere other than immediately after a @deftp, etc.18141815\def\deftpx #1 {\errmessage{@deftpx in invalid context}}18161817\message{cross reference,}1818% Define cross-reference macros1819\newwrite \auxfile18201821% \setref{foo} defines a cross-reference point named foo.18221823\def\setref#1{%1824\dosetq{#1-pg}{Ypagenumber}%1825\dosetq{#1-snt}{Ysectionnumberandtype}}18261827\def\unnumbsetref#1{%1828\dosetq{#1-pg}{Ypagenumber}%1829\dosetq{#1-snt}{Ynothing}}18301831% \xref and \pxref generate cross references to specified points.18321833\def\pxref #1{see \xrefX [#1,,,,,,,]}1834\def\xref #1{See \xrefX [#1,,,,,,,]}1835\def\xrefX [#1,#2,#3,#4,#5,#6]{%1836\setbox1=\hbox{\i{\losespace#5{}}}%1837\setbox0=\hbox{\losespace#3{}}%1838\ifdim \wd0 =0pt \setbox0=\hbox{\losespace#1{}}\fi%1839\ifdim \wd1 >0pt%1840section \unhbox0{} in \unhbox1%1841\else%1842\refx{#1-snt} [\unhbox0], page\tie \refx{#1-pg}%1843\fi }18441845% \dosetq is the interface for calls from other macros18461847\def\dosetq #1#2{{\let\folio=0%1848\edef\next{\write\auxfile{\internalsetq {#1}{#2}}}%1849\next}}18501851% \internalsetq {foo}{page} expands into CHARACTERS 'xrdef {foo}{...expansion of \Ypage...}1852% When the aux file is read, ' is the escape character18531854\def\internalsetq #1#2{'xrdef {#1}{\csname #2\endcsname}}18551856% Things to be expanded by \internalsetq18571858\def\Ypagenumber{\folio}18591860\def\Ynothing{}18611862\def\Ysectionnumberandtype{%1863\ifnum\secno=0 chapter\xreftie\the\chapno %1864\else \ifnum \subsecno=0 section\xreftie\the\chapno.\the\secno %1865\else \ifnum \subsubsecno=0 %1866section\xreftie\the\chapno.\the\secno.\the\subsecno %1867\else %1868section\xreftie\the\chapno.\the\secno.\the\subsecno.\the\subsubsecno %1869\fi \fi \fi }18701871\gdef\xreftie{'tie}18721873% Define @refx to reference a specific cross-reference string.18741875\def\refx#1{%1876{%1877\expandafter\ifx\csname X#1\endcsname\relax1878% If not defined, say something at least.1879\expandafter\gdef\csname X#1\endcsname {$<$undefined$>$}%1880\message {WARNING: Cross-reference "#1" used but not yet defined}%1881\message {}%1882\fi %1883\csname X#1\endcsname %It's defined, so just use it.1884}}18851886% Read the last existing aux file, if any. No error if none exists.18871888% This is the macro invoked by entries in the aux file.1889\def\xrdef #1#2{1890{\catcode`\'=\other\expandafter \gdef \csname X#1\endcsname {#2}}}18911892{1893\catcode `\^^@=\other1894\catcode `\^^A=\other1895\catcode `\^^B=\other1896\catcode `\^^C=\other1897\catcode `\^^D=\other1898\catcode `\^^E=\other1899\catcode `\^^F=\other1900\catcode `\^^G=\other1901\catcode `\^^H=\other1902\catcode `\^^K=\other1903\catcode `\^^L=\other1904\catcode `\^^N=\other1905\catcode `\^^O=\other1906\catcode `\^^P=\other1907\catcode `\^^Q=\other1908\catcode `\^^R=\other1909\catcode `\^^S=\other1910\catcode `\^^T=\other1911\catcode `\^^U=\other1912\catcode `\^^V=\other1913\catcode `\^^W=\other1914\catcode `\^^X=\other1915\catcode `\^^Y=\other1916\catcode `\^^Z=\other1917\catcode `\^^[=\other1918\catcode `\^^\=\other1919\catcode `\^^]=\other1920\catcode `\^^^=\other1921\catcode `\^^_=\other1922\catcode `\@=\other1923\catcode `\^=\other1924\catcode `\~=\other1925\catcode `\[=\other1926\catcode `\]=\other1927\catcode`\"=\other1928\catcode`\_=\other1929\catcode`\|=\other1930\catcode`\<=\other1931\catcode`\>=\other1932\catcode `\$=\other1933\catcode `\#=\other1934\catcode `\&=\other19351936% the aux file uses ' as the escape.1937% Turn off \ as an escape so we do not lose on1938% entries which were dumped with control sequences in their names.1939% For example, 'xrdef {$\leq $-fun}{page ...} made by @defun ^^1940% Reference to such entries still does not work the way one would wish,1941% but at least they do not bomb out when the aux file is read in.19421943\catcode `\{=1 \catcode `\}=21944\catcode `\%=\other1945\catcode `\'=01946\catcode `\\=\other19471948'openin 1 'jobname.aux1949'ifeof 1 'else 'closein 1 'input 'jobname.aux1950'fi1951}19521953% Open the new aux file. Tex will close it automatically at exit.19541955\openout \auxfile=\jobname.aux19561957% Footnotes.19581959\newcount \footnoteno19601961\def\supereject{\par\penalty -20000\footnoteno =0 }19621963\let\ptexfootnote=\footnote19641965{\catcode `\@=111966\gdef\footnote{\global\advance \footnoteno by \@ne1967\edef\thisfootno{$^{\the\footnoteno}$}%1968\let\@sf\empty1969\ifhmode\edef\@sf{\spacefactor\the\spacefactor}\/\fi1970\thisfootno\@sf\parsearg\footnotezzz}19711972\gdef\footnotezzz #1{\insert\footins{1973\interlinepenalty\interfootnotelinepenalty1974\splittopskip\ht\strutbox % top baseline for broken footnotes1975\splitmaxdepth\dp\strutbox \floatingpenalty\@MM1976\leftskip\z@skip \rightskip\z@skip \spaceskip\z@skip \xspaceskip\z@skip1977\footstrut\hang\textindent{\thisfootno}#1\strut}}19781979}%end \catcode `\@=1119801981% End of control word definitions.19821983\message{and turning on texinfo input format.}19841985\newindex{cp}1986\newcodeindex{fn}1987\newcodeindex{vr}1988\newcodeindex{tp}1989\newcodeindex{ky}1990\newcodeindex{pg}19911992% Set some numeric style parameters, for 8.5 x 11 format.19931994\hsize = 6.5in1995\parindent 15pt1996\parskip 18pt plus 1pt1997\baselineskip 15pt1998\advance\topskip by 1.2cm19992000% Prevent underfull vbox error messages.2001\vbadness=1000020022003% Use @smallbook to reset parameters for 7x9.5 format2004\def\smallbook{2005\global\lispnarrowing = 0.3in2006\global\baselineskip 12pt2007\global\parskip 3pt plus 1pt2008\global\hsize = 5in2009\global\doublecolumnhsize=2.4in \global\doublecolumnvsize=15.0in2010\global\vsize=7.5in2011\global\tolerance=7002012\global\hfuzz=1pt20132014\global\pagewidth=\hsize2015\global\pageheight=\vsize2016\global\font\ninett=cmtt920172018\global\let\smalllisp=\smalllispx2019\global\let\smallexample=\smalllispx2020\global\def\Esmallexample{\Esmalllisp}2021}20222023%% For a final copy, take out the rectangles2024%% that mark overfull boxes (in case you have decided2025%% that the text looks ok even though it passes the margin).2026\def\finalout{\overfullrule=0pt}20272028% Turn off all special characters except @2029% (and those which the user can use as if they were ordinary)2030% Define certain chars to be always in tt font.20312032\catcode`\"=\active2033\def\activedoublequote{{\tt \char '042}}2034\let"=\activedoublequote2035\catcode`\~=\active2036\def~{{\tt \char '176}}2037\chardef\hat=`\^2038\catcode`\^=\active2039\def^{{\tt \hat}}2040\catcode`\_=\active2041\def_{{\tt \char '137}}2042\catcode`\|=\active2043\def|{{\tt \char '174}}2044\chardef \less=`\<2045\catcode`\<=\active2046\def<{{\tt \less}}2047\chardef \gtr=`\>2048\catcode`\>=\active2049\def>{{\tt \gtr}}20502051\catcode`\@=020522053% \rawbackslashxx output one backslash character in current font2054{\catcode`\\=\other2055@gdef@rawbackslashxx{\}}20562057% \rawbackslash redefines \ as input to do \rawbackslashxx.2058{\catcode`\\=\active2059@gdef@rawbackslash{@let\=@rawbackslashxx }}20602061% \normalbackslash outputs one backslash in fixed width font.2062\def\normalbackslash{{\tt\rawbackslashxx}}20632064% Say @foo, not \foo, in error messages.2065\escapechar=`\@20662067%% These look ok in all fonts, so just make them not special. The @rm below2068%% makes sure that the current font starts out as the newly loaded cmr102069\catcode`\$=\other \catcode`\%=\other \catcode`\&=\other \catcode`\#=\other20702071\catcode 17=0 @c Define control-q2072\catcode`\\=\active2073@let\=@normalbackslash20742075@textfonts2076@rm207720782079