home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 1B / DATAFILE_PDCD1B.iso / _tex / tex / source / l2esrc1 / !TeX / LaTeX2eSrc / classes.dtx (.txt) < prev    next >
LaTeX Document  |  1994-07-28  |  142KB  |  3,733 lines

  1. % \iffalse meta-comment
  2. % Copyright 1994 the LaTeX3 project and the individual authors.
  3. % All rights reserved. For further copyright information see the file
  4. % legal.txt, and any other copyright indicated in this file.
  5. % This file is part of the LaTeX2e system.
  6. % ----------------------------------------
  7. %  This system is distributed in the hope that it will be useful,
  8. %  but WITHOUT ANY WARRANTY; without even the implied warranty of
  9. %  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  10. % IMPORTANT NOTICE:
  11. % For error reports in case of UNCHANGED versions see bugs.txt.
  12. % Please do not request updates from us directly.  Distribution is
  13. % done through Mail-Servers and TeX organizations.
  14. % You are not allowed to change this file.
  15. % You are allowed to distribute this file under the condition that
  16. % it is distributed together with all files mentioned in manifest.txt.
  17. % If you receive only some of these files from someone, complain!
  18. % You are NOT ALLOWED to distribute this file alone.  You are NOT
  19. % ALLOWED to take money for the distribution or use of either this
  20. % file or a changed version, except for a nominal charge for copying
  21. % etc.
  22. % \fi
  23. % \CheckSum{2948}
  24. %% \CharacterTable
  25. %%  {Upper-case    \A\B\C\D\E\F\G\H\I\J\K\L\M\N\O\P\Q\R\S\T\U\V\W\X\Y\Z
  26. %%   Lower-case    \a\b\c\d\e\f\g\h\i\j\k\l\m\n\o\p\q\r\s\t\u\v\w\x\y\z
  27. %%   Digits        \0\1\2\3\4\5\6\7\8\9
  28. %%   Exclamation   \!     Double quote  \"     Hash (number) \#
  29. %%   Dollar        \$     Percent       \%     Ampersand     \&
  30. %%   Acute accent  \'     Left paren    \(     Right paren   \)
  31. %%   Asterisk      \*     Plus          \+     Comma         \,
  32. %%   Minus         \-     Point         \.     Solidus       \/
  33. %%   Colon         \:     Semicolon     \;     Less than     \<
  34. %%   Equals        \=     Greater than  \>     Question mark \?
  35. %%   Commercial at \@     Left bracket  \[     Backslash     \\
  36. %%   Right bracket \]     Circumflex    \^     Underscore    \_
  37. %%   Grave accent  \`     Left brace    \{     Vertical bar  \|
  38. %%   Right brace   \}     Tilde         \~}
  39. % \iffalse
  40. % \section{Identification}
  41. %    These document classes can only be used with \LaTeXe, so we make
  42. %    sure that an appropriate message is displayed when another \TeX{}
  43. %    format is used.
  44. %    \begin{macrocode}
  45. %<+article|report|book>\NeedsTeXFormat{LaTeX2e}
  46. %    \end{macrocode}
  47. %    Announce the Class name and its version:
  48. %    \begin{macrocode}
  49. %<+article>\ProvidesClass{article}
  50. %<+report>\ProvidesClass{report}
  51. %<+book>\ProvidesClass{book}
  52. %<+10pt&!bk>\ProvidesFile{size10.clo}
  53. %<+11pt&!bk>\ProvidesFile{size11.clo}
  54. %<+12pt&!bk>\ProvidesFile{size12.clo}
  55. %<+10pt&bk>\ProvidesFile{bk10.clo}
  56. %<+11pt&bk>\ProvidesFile{bk11.clo}
  57. %<+12pt&bk>\ProvidesFile{bk12.clo}
  58. %<+leqno>\ProvidesFile{leqno.clo}
  59. %<+fleqn>\ProvidesFile{fleqn.clo}
  60. %<*driver>
  61. \ProvidesFile{classes.drv}
  62. %</driver>
  63.               [1994/07/13 v1.2u
  64. %<+article|report|book> Standard LaTeX document class]
  65. %<+10pt|11pt|12pt>      Standard LaTeX file (size option)]
  66. %<+leqno>               Standard LaTeX option (left equation numbers)]
  67. %<+fleqn>               Standard LaTeX option (flush left equations)]
  68. %    \end{macrocode}
  69. % \fi
  70. % \changes{v1.0j}{1993/12/20}{Added \cmd\ProvidesFile to size files}
  71. % \changes{v1.0l}{1994/01/11}{add the extension to the names of the
  72. %     files} 
  73. % \changes{v1.1a}{1994/03/12}{Removed `typeout messages}
  74. % \changes{v1.1f}{1994/04/15}{Inserted forgotten line break}
  75. % \changes{v1.2i}{1994/04/28}{Use LaTeX instead of LaTeX2e in messages}
  76. % \changes{v1.2j}{1994/05/01}{Removed the use of \cmd\fileversion
  77. %    c.s.}
  78. % \changes{v1.2o}{1994/05/24}{Changed file information}
  79. % \changes{v1.2p}{1994/05/27}{Moved identification and driver to the
  80. %    front of the file}
  81. % \iffalse
  82. % \section{A driver for this document}
  83. % The next bit of code contains the documentation driver file for
  84. % \TeX{}, i.e., the file that will produce the documentation you are
  85. % currently reading. It will be extracted from this file by the 
  86. % {\sc docstrip} program.
  87. % \changes{1.0f}{1993/12/07}{Use class ltxdoc document class}
  88. % \changes{1.0r}{1994/02/28}{Moved driver code in order not to need a
  89. %    separate driver}
  90. %    \begin{macrocode}
  91. %<*driver>
  92. \documentclass{ltxdoc}
  93. %    \end{macrocode}
  94. %    We don't want everything to appear in the index
  95. %    \begin{macrocode}
  96. \DoNotIndex{\',\.,\@M,\@@input,\@addtoreset,\@arabic,\@badmath}
  97. \DoNotIndex{\@centercr,\@cite}
  98. \DoNotIndex{\@dotsep,\@empty,\@float,\@gobble,\@gobbletwo,\@ignoretrue}
  99. \DoNotIndex{\@input,\@ixpt,\@m}
  100. \DoNotIndex{\@minus,\@mkboth,\@ne,\@nil,\@nomath,\@plus,\@set@topoint}
  101. \DoNotIndex{\@tempboxa,\@tempcnta,\@tempdima,\@tempdimb}
  102. \DoNotIndex{\@tempswafalse,\@tempswatrue,\@viipt,\@viiipt,\@vipt}
  103. \DoNotIndex{\@vpt,\@warning,\@xiipt,\@xipt,\@xivpt,\@xpt,\@xviipt}
  104. \DoNotIndex{\@xxpt,\@xxvpt,\\,\ ,\addpenalty,\addtolength,\addvspace}
  105. \DoNotIndex{\advance,\Alph,\alph}
  106. \DoNotIndex{\arabic,\ast,\begin,\begingroup,\bfseries,\bgroup,\box}
  107. \DoNotIndex{\bullet}
  108. \DoNotIndex{\cdot,\cite,\CodelineIndex,\cr,\day,\DeclareOption}
  109. \DoNotIndex{\def,\DisableCrossrefs,\divide,\DocInput,\documentclass}
  110. \DoNotIndex{\DoNotIndex,\egroup,\ifdim,\else,\fi,\em,\endtrivlist}
  111. \DoNotIndex{\EnableCrossrefs,\end,\end@dblfloat,\end@float,\endgroup}
  112. \DoNotIndex{\endlist,\everycr,\everypar,\ExecuteOptions,\expandafter}
  113. \DoNotIndex{\fbox}
  114. \DoNotIndex{\filedate,\filename,\fileversion,\fontsize,\framebox,\gdef}
  115. \DoNotIndex{\global,\halign,\hangindent,\hbox,\hfil,\hfill,\hrule}
  116. \DoNotIndex{\hsize,\hskip,\hspace,\hss,\if@tempswa,\ifcase,\or,\fi,\fi}
  117. \DoNotIndex{\ifhmode,\ifvmode,\ifnum,\iftrue,\ifx,\fi,\fi,\fi,\fi,\fi}
  118. \DoNotIndex{\input}
  119. \DoNotIndex{\jobname,\kern,\leavevmode,\let,\leftmark}
  120. \DoNotIndex{\list,\llap,\long,\m@ne,\m@th,\mark,\markboth,\markright}
  121. \DoNotIndex{\month,\newcommand,\newcounter,\newenvironment}
  122. \DoNotIndex{\NeedsTeXFormat,\newdimen}
  123. \DoNotIndex{\newlength,\newpage,\nobreak,\noindent,\null,\number}
  124. \DoNotIndex{\numberline,\OldMakeindex,\OnlyDescription,\p@}
  125. \DoNotIndex{\pagestyle,\par,\paragraph,\paragraphmark,\parfillskip}
  126. \DoNotIndex{\penalty,\PrintChanges,\PrintIndex,\ProcessOptions}
  127. \DoNotIndex{\protect,\ProvidesClass,\raggedbottom,\raggedright}
  128. \DoNotIndex{\refstepcounter,\relax,\renewcommand,\reset@font}
  129. \DoNotIndex{\rightmargin,\rightmark,\rightskip,\rlap,\rmfamily,\roman}
  130. \DoNotIndex{\roman,\secdef,\selectfont,\setbox,\setcounter,\setlength}
  131. \DoNotIndex{\settowidth,\sfcode,\skip,\sloppy,\slshape,\space}
  132. \DoNotIndex{\symbol,\the,\trivlist,\typeout,\tw@,\undefined,\uppercase}
  133. \DoNotIndex{\usecounter,\usefont,\usepackage,\vfil,\vfill,\viiipt}
  134. \DoNotIndex{\viipt,\vipt,\vskip,\vspace}
  135. \DoNotIndex{\wd,\xiipt,\year,\z@}
  136. %    \end{macrocode}
  137. %    We do want an index, using linenumbers
  138. %    \begin{macrocode}
  139. \EnableCrossrefs
  140. %    \end{macrocode}
  141. %    We use so many \file{docstrip} modules that we set the
  142. %    \texttt{StandardModuleDepth} counter to 1.
  143. %    \begin{macrocode}
  144. \setcounter{StandardModuleDepth}{1}
  145. %    \end{macrocode}
  146. %    The following command retrieves the date and version information
  147. %    from the file.
  148. %    \begin{macrocode}
  149. \GetFileInfo{classes.drv}
  150. %    \end{macrocode}
  151. %    Some commonly used abbreviations
  152. %    \begin{macrocode}
  153. \newcommand\Lopt[1]{\textsf {#1}}
  154. \newcommand\file[1]{\texttt {#1}}
  155. \newcommand\Lcount[1]{\textsl {\small#1}}
  156. \newcommand\pstyle[1]{\textsl {#1}}
  157. %    \end{macrocode}
  158. %    We also want the full details.
  159. %    \begin{macrocode}
  160. \begin{document}
  161. \DocInput{classes.dtx}
  162. \PrintIndex
  163. % ^^A\PrintChanges
  164. \end{document}
  165. %</driver>
  166. %    \end{macrocode}
  167. % \fi
  168. % \changes{v1.0d}{1993/11/30}{remove \cmd\@in, made option makeindex a
  169. %                             synonym for option makeidx}
  170. % \changes{v1.0d}{1993/11/30}{removed \cmd\@minus, \cmd\@plus,
  171. %                             \cmd\@settopoint, \cmd\@setfontsize;
  172. %                             they are now in the kernel}
  173. % \changes{v1.0d}{1993/11/30}{Added use of \cmd\NeedsTeXFormat}
  174. % \changes{v1.0d}{1993/11/30}{Replaced \cmd\bf with \cmd\bfseries;
  175. %                             \cmd\rm with \cmd\rmfamily}
  176. % \changes{v1.0d}{1993/11/30}{Made eqaution and eqnarray environments in
  177. %                             the fleqn option up to date with
  178. %                             latex.dtx}
  179. % \changes{v1.0f}{1993/12/08}{Made all lines shorter than 72 characters}
  180. % \changes{v1.0g}{1993/12/08}{Made change in eqnarray for the fleqn
  181. %                             option, as suggested by Rainer.}
  182. % \changes{v1.0h}{1993/12/18}{Made the definitions of the font- and
  183. %    size-changing commands use \cmd\renew rather than \cmd\new.
  184. %    Defined the float parameters with \cmd\renewcommand rather than
  185. %    \cmd\newcommand.  Corrected some typos in the fleqn option.
  186. %    Replaced two occurrences of -\cmd\@secpenalty by
  187. %    \cmd\@secpenalty.  ASAJ.}
  188. % \changes{v1.0j}{1993/12/10}{Use \cmd\cmd in change entries}
  189. % \changes{v1.0k}{1994/01/09}{Removed some typos/bugs}
  190. % \changes{v1.0l}{1994/01/10}{Changed version numbering; moved leqno
  191. %    and fleqn options to an external file.}
  192. % \changes{v1.0n}{1994/01/19}{Removed code for makeidx option and made
  193. %    it a separate package; removed use of \cmd\setlength from list
  194. %    parameters.}
  195. % \changes{v1.0o}{1994/01/31}{Small documention changes}
  196. % \changes{v1.0q}{1994/02/16}{Small documention changes}
  197. % \changes{v1.2a}{1994/03/17}{Added openright option. (LL)}
  198. % \changes{v1.2b}{1994/03/17}{Added the \ldots{}matter commands. (LL)}
  199. % \changes{v1.2c}{1994/03/17}{Fixed page numbering in titlepage
  200. %    env. (LL)}
  201. % \changes{v1.2d}{1994/04/11}{Checked the file for long lines and
  202. %    wrapped them when necessary; made a slight implementation
  203. %    modification to the openright and openany options.}
  204. % \changes{v1.2l}{1994/05/11}{changed some \cmd\changes entries}
  205. % \changes{v1.2m}{1994/05/12}{Forgot a few entries}
  206. % \changes{v1.2t}{1994/06/22}{Refrased a few sentences to prevent
  207. %    overfull hboxes}
  208. % \title{Standard Document Classes for \LaTeX{} version 2e\thanks{This
  209. %        file has version number \fileversion, last revised
  210. %        \filedate.}}
  211. % \author{%
  212. % Copyright (C) 1992 by Leslie Lamport \and
  213. % Copyright (C) 1994-94 by Frank Mittelbach \and Johannes Braams
  214. % \date{\filedate}
  215. % \maketitle
  216. % \tableofcontents
  217. % \StopEventually{}    ^^A 
  218. % \section{The {\sc docstrip} modules}
  219. % The following modules are used in the implementation to direct
  220. % {\sc docstrip} in generating the external files:
  221. % \begin{center}
  222. % \begin{tabular}{ll}
  223. %   article & produce the documentclass article\\
  224. %   report  & produce the documentclass report\\
  225. %   size10  & produce the class option for 10pt\\
  226. %   size11  & produce the class option for 11pt\\
  227. %   size12  & produce the class option for 12pt\\
  228. %   book    & produce the documentclass book\\
  229. %   bk10    & produce the book class option for 10pt\\
  230. %   bk11    & produce the book class option for 11pt\\
  231. %   bk12    & produce the book class option for 12pt\\
  232. %   fleqn   & produce the class option fleqn\\
  233. %   leqno   & produce the class option leqno\\
  234. %   driver  & produce a documentation driver file \\
  235. % \end{tabular}
  236. % \end{center}
  237. % \section{Initial Code}
  238. %    In this part we define a few commands that are used later on.
  239. % \begin{macro}{\@ptsize}
  240. %    This control sequence is used to store the second digit of the
  241. %    pointsize we are typesetting in. So, normally, it's value is one
  242. %    of 0, 1 or 2.
  243. %    \begin{macrocode}
  244. %<*article|report|book>
  245. \newcommand\@ptsize{}
  246. %    \end{macrocode}
  247. % \end{macro}
  248. % \begin{macro}{\if@restonecol}
  249. %    When the document has to printed in two columns, we sometimes
  250. %    have to temporarily switch to one column. This switch is used to
  251. %    remember to switch back.
  252. %    \begin{macrocode}
  253. \newif\if@restonecol
  254. %    \end{macrocode}
  255. % \end{macro}
  256. % \begin{macro}{\if@titlepage}
  257. %    A switch to indicate if a titlepage has to be produced.  For the
  258. %    article document class the default is not to make a separate
  259. %    titlepage.
  260. %    \begin{macrocode}
  261. \newif\if@titlepage
  262. %<+article>\@titlepagefalse
  263. %<-article>\@titlepagetrue
  264. %    \end{macrocode}
  265. % \end{macro}
  266. % \begin{macro}{\if@openright}
  267. %    A switch to indicate if chapters must start on a right-hand page.
  268. %    The default for the report class is no; for the book class it's
  269. %    yes.
  270. %    \begin{macrocode}
  271. %<-article>\newif\if@openright
  272. %    \end{macrocode}
  273. % \end{macro}
  274. % \begin{macro}{\if@openbib}
  275. %    A switch to indicate if the bibliography has to be produced in
  276. %    the ``open'' format. The default is to use a ``closed'' format.
  277. %    \begin{macrocode}
  278. \newif\if@openbib
  279. \@openbibfalse
  280. %    \end{macrocode}
  281. % \end{macro}
  282. % \section{Declaration of Options}
  283. % \subsection{Setting Paper Sizes}
  284. %    The variables |\paperwidth| and |\paperheight| should reflect the
  285. %    physical paper size after trimming. For desk printer output this
  286. %    is usually the real paper size since there is no post-processing.
  287. %    Classes for real book production will probably add other paper
  288. %    sizes and additionally the production of crop marks for trimming.
  289. % \changes{v1.0g}{1993/12/09}{Removed typo, A4 is not 279 mm high}
  290. %    \begin{macrocode}
  291. \DeclareOption{a4paper}
  292.    {\setlength\paperheight {297mm}%
  293.     \setlength\paperwidth  {210mm}}
  294. \DeclareOption{a5paper}
  295.    {\setlength\paperheight {210mm}%
  296.     \setlength\paperwidth  {148mm}}
  297. \DeclareOption{b5paper}
  298.    {\setlength\paperheight {250mm}%
  299.     \setlength\paperwidth  {176mm}}
  300. \DeclareOption{letterpaper}
  301.    {\setlength\paperheight {11in}%
  302.     \setlength\paperwidth  {8.5in}}
  303. \DeclareOption{legalpaper}
  304.    {\setlength\paperheight {14in}%
  305.     \setlength\paperwidth  {8.5in}}
  306. \DeclareOption{executivepaper}
  307.    {\setlength\paperheight {10.5in}%
  308.     \setlength\paperwidth  {7.25in}}
  309. %    \end{macrocode}
  310. %    The option \Lopt{landscape} switches the values of |\paperheight|
  311. %    and |\paperwidth|, assuming the dimensions wer given for portrait
  312. %    paper.
  313. %    \begin{macrocode}
  314. \DeclareOption{landscape}
  315.    {\setlength\@tempdima   {\paperheight}%
  316.     \setlength\paperheight {\paperwidth}%
  317.     \setlength\paperwidth  {\@tempdima}}
  318. %    \end{macrocode}
  319. % \subsection{Choosing the type size}
  320. %    The type size options are handled by defining |\@ptsize| to contain
  321. %    the last digit of the size in question and branching on |\ifcase|
  322. %    statements. This is done for historical reasons to stay compatible
  323. %    with other packages that use the |\@ptsize| variable to select
  324. %    special actions. It makes the declarations of size options less
  325. %    than 10pt difficult, although one can probably use \texttt{9}
  326. %    and \texttt{8} assuming that a class wont define both
  327. %    \Lopt{8pt} and \Lopt{18pt} options.
  328. %    \begin{macrocode}
  329. \DeclareOption{10pt}{\renewcommand\@ptsize{0}}
  330. \DeclareOption{11pt}{\renewcommand\@ptsize{1}}
  331. \DeclareOption{12pt}{\renewcommand\@ptsize{2}}
  332. %    \end{macrocode}
  333. %  \subsection{Two-side or one-side printing}
  334. %    For two-sided printing we use the switch |\if@twoside|. In
  335. %    addition we have to set the |\if@mparswitch| to get any margin
  336. %    paragraphs into the outside margin.
  337. %    \begin{macrocode}
  338. \DeclareOption{oneside}{\@twosidefalse \@mparswitchfalse}
  339. \DeclareOption{twoside}{\@twosidetrue  \@mparswitchtrue}
  340. %    \end{macrocode}
  341. %  \subsection{Draft option}
  342. %    If the user requests \Lopt{draft} we show any overfull boxes.
  343. %    We could probably add some more interesting stuff to this option.
  344. %    \begin{macrocode}
  345. \DeclareOption{draft}{\setlength\overfullrule{5pt}}
  346. \DeclareOption{final}{\setlength\overfullrule{0pt}}
  347. %    \end{macrocode}
  348. %  \subsection{Titlepage option}
  349. %    An article usually has no separate titlepage, but the user can
  350. %    request one.
  351. %    \begin{macrocode}
  352. \DeclareOption{titlepage}{\@titlepagetrue}
  353. \DeclareOption{notitlepage}{\@titlepagefalse}
  354. %    \end{macrocode}
  355. %  \subsection{openright option}
  356. %    This option determines whether or not a chapter must start on
  357. %    a right-hand page 
  358. %    request one.
  359. %    \begin{macrocode}
  360. %<-article>\DeclareOption{openright}{\@openrighttrue}
  361. %<-article>\DeclareOption{openany}{\@openrightfalse}
  362. %    \end{macrocode}
  363. %  \subsection{Twocolumn printing}
  364. %    Two-column and one-column printing is again realized via a switch.
  365. %    \begin{macrocode}
  366. \DeclareOption{onecolumn}{\@twocolumnfalse}
  367. \DeclareOption{twocolumn}{\@twocolumntrue}
  368. %    \end{macrocode}
  369. %  \subsection{Equation numbering on the left}
  370. %    The option \Lopt{leqno} can be used to get the equation numbers
  371. %    on the left side of the equation.
  372. %    \begin{macrocode}
  373. \DeclareOption{leqno}{\input{leqno.clo}}
  374. %    \end{macrocode}
  375. %  \subsection{Flush left displays}
  376. %    The option \Lopt{fleqn} redefines the displayed math environmens
  377. %    in such a way that they come out flush left, with an indentation
  378. %    of |\mathindent| from the prevailing left margin.
  379. % \changes{v1.0h}{1993/12/18}{Corrected some typos.  ASAJ.}
  380. %    \begin{macrocode}
  381. \DeclareOption{fleqn}{\input{fleqn.clo}}
  382. %    \end{macrocode}
  383. % \subsection{Open bibliography}
  384. %    The option \Lopt{openbib} produces the ``open'' bibliography
  385. %    style, in which each block starts on a new line, and succeeding
  386. %    lines in a block are indented by |\bibindent|.
  387. %    \begin{macrocode}
  388. \DeclareOption{openbib}{\@openbibtrue}
  389. %    \end{macrocode}
  390. % \section{Executing Options}
  391. %    Here we execute the default options to initialize certain
  392. %    variables. Note that the document class `book' always uses two
  393. %    sided printing.
  394. %    \begin{macrocode}
  395. %<*article>
  396. \ExecuteOptions{letterpaper,10pt,oneside,onecolumn,final}
  397. %</article>
  398. %<*report>
  399. \ExecuteOptions{letterpaper,10pt,oneside,onecolumn,final,openany}
  400. %</report>
  401. %<*book>
  402. \ExecuteOptions{letterpaper,10pt,twoside,onecolumn,final,openright}
  403. %</book>
  404. %    \end{macrocode}
  405. %    The |\ProcessOptions| command causes the execution of the code
  406. %    for every option \Lopt{FOO}
  407. %    which is declared and for which the user typed
  408. %    the \Lopt{FOO} option in his
  409. %    |\documentclass| command.  For every option \Lopt{BAR} he typed,
  410. %    which is not declared, the option is assumed to be a global option.
  411. %    All options will be passed as document options to any
  412. %    |\usepackage| command in the document preamble.
  413. %    \begin{macrocode}
  414. \ProcessOptions
  415. %    \end{macrocode}
  416. %    Now that all the options have been executed we can load the
  417. %    chosen class option file that contains all size dependent code.
  418. %    \begin{macrocode}
  419. %<-book>\input{size1\@ptsize.clo}
  420. %<+book>\input{bk1\@ptsize.clo}
  421. %</article|report|book>
  422. %    \end{macrocode}
  423. %  \section{Loading Packages}
  424. %  The standard class files do not load additional packages.
  425. % \section{Document Layout}
  426. % \label{sec:maincode}
  427. %  In this section we are finally dealing with the nasty typographical
  428. %  details.
  429. % \subsection{Fonts}
  430. %    \LaTeX\ offers the user commands to change the size of the font,
  431. %    relative to the `main' size. Each relative size changing command
  432. %    |\size| executes the command
  433. %    |\@setfontsize||\size|\meta{font-size}\meta{baselineskip} where:
  434. %    \begin{description}
  435. %    \item[\meta{font-size}] The absolute size of the font to use from
  436. %        now on.
  437. %    \item[\meta{baselineskip}] The normal value of |\baselineskip|
  438. %        for the size of the font selected. (The actual value will be
  439. %        |\baselinestretch| * \meta{baselineskip}.)
  440. %    \end{description}
  441. %    A number of commands, defined in the \LaTeX{} kernel, shorten the
  442. %    following  definitions and are used throughout. They are:
  443. % \begin{center}
  444. % \begin{tabular}{ll@{\qquad}ll@{\qquad}ll}
  445. %  \verb=\@vpt= & 5 & \verb=\@vipt= & 6 & \verb=\@viipt= & 7 \\
  446. %  \verb=\@viiipt= & 8 & \verb=\@ixpt= & 9 & \verb=\@xpt= & 10 \\
  447. %  \verb=\@xipt= & 10.95 & \verb=\@xiipt= & 12 & \verb=\@xivpt= & 14.4\\
  448. %  ...
  449. %  \end{tabular}
  450. %  \end{center}
  451. % \begin{macro}{\normalsize}
  452. % \begin{macro}{\@normalsize}
  453. % \changes{v1.0o}{1994/01/31}{`@normalsize now defined in the kernel}
  454. %    The user level command for the main size is |\normalsize|.
  455. %    Internally \LaTeX{} uses |\@normalsize| when it refers to the
  456. %    main size. |\@normalsize| will be defined to work like
  457. %    |\normalsize| if the latter is redefined from its default
  458. %    definition (that just issues an error message). Otherwise
  459. %    |\@normalsize| simply selects a 10pt/12pt size.
  460. %    The |\normalsize| macro also sets new values for\\
  461. %    |\abovedisplayskip|, |\abovedisplayshortskip| and
  462. %    |\belowdisplayshortskip|.
  463. % \changes{v1.0e}{1993/12/07}{\cmd\normalsize doesn't exist, so use
  464. %    \cmd\newcommand}
  465. % \changes{v1.0h}{1993/12/18}{\cmd\normalsize is now defined in the
  466. %    kernel, so use \cmd\renewcommand.  ASAJ.}
  467. %    \begin{macrocode}
  468. %<*10pt|11pt|12pt>
  469. \renewcommand\normalsize{%
  470. %<*10pt>
  471.    \@setfontsize\normalsize\@xpt\@xiipt
  472.    \abovedisplayskip 10\p@ \@plus2\p@ \@minus5\p@
  473.    \abovedisplayshortskip \z@ \@plus3\p@
  474.    \belowdisplayshortskip 6\p@ \@plus3\p@ \@minus3\p@
  475. %</10pt>
  476. %<*11pt>
  477.    \@setfontsize\normalsize\@xipt{13.6}%
  478.    \abovedisplayskip 11\p@ \@plus3\p@ \@minus6\p@
  479.    \abovedisplayshortskip \z@ \@plus3\p@
  480.    \belowdisplayshortskip 6.5\p@ \@plus3.5\p@ \@minus3\p@
  481. %</11pt>
  482. %<*12pt>
  483.    \@setfontsize\normalsize\@xiipt{14.5}%
  484.    \abovedisplayskip 12\p@ \@plus3\p@ \@minus7\p@
  485.    \abovedisplayshortskip \z@ \@plus3\p@
  486.    \belowdisplayshortskip 6.5\p@ \@plus3.5\p@ \@minus3\p@
  487. %</12pt>
  488. %    \end{macrocode}
  489. %    The |\belowdisplayskip| is always equal to the
  490. %    |\abovedisplayskip|. The parameters of the first level list are
  491. %    always given by |\@listI|.
  492. %    \begin{macrocode}
  493.    \belowdisplayskip \abovedisplayskip
  494.    \let\@listi\@listI}
  495. %    \end{macrocode}
  496. %    We initially choose the normalsize font.
  497. %    \begin{macrocode}
  498. \normalsize
  499. %    \end{macrocode}
  500. % \end{macro}
  501. % \end{macro}
  502. % \begin{macro}{\small}
  503. %    This is similar to |\normalsize|.
  504. % \changes{v1.0h}{1993/12/18}{\cmd\small is now defined in the kernel,
  505. %    so use \cmd\renewcommand.  ASAJ.}
  506. % \changes{v1.2e}{1994/04/14}{\cmd\small is no longer defined in the
  507. %    kernel; use \cmd\newcommand}
  508. %    \begin{macrocode}
  509. \newcommand\small{%
  510. %<*10pt>
  511.    \@setfontsize\small\@ixpt{11}%
  512.    \abovedisplayskip 8.5\p@ \@plus3\p@ \@minus4\p@
  513.    \abovedisplayshortskip \z@ \@plus2\p@
  514.    \belowdisplayshortskip 4\p@ \@plus2\p@ \@minus2\p@
  515.    \def\@listi{\leftmargin\leftmargini
  516.                \topsep 4\p@ \@plus2\p@ \@minus2\p@
  517.                \parsep 2\p@ \@plus\p@ \@minus\p@
  518.                \itemsep \parsep}%
  519. %</10pt>
  520. %<*11pt>
  521.    \@setfontsize\small\@xpt\@xiipt
  522.    \abovedisplayskip 10\p@ \@plus2\p@ \@minus5\p@
  523.    \abovedisplayshortskip \z@ \@plus3\p@
  524.    \belowdisplayshortskip 6\p@ \@plus3\p@ \@minus3\p@
  525.    \def\@listi{\leftmargin\leftmargini
  526.                \topsep 6\p@ \@plus2\p@ \@minus2\p@
  527.                \parsep 3\p@ \@plus2\p@ \@minus\p@
  528.                \itemsep \parsep}%
  529. %</11pt>
  530. %<*12pt>
  531.    \@setfontsize\small\@xipt{13.6}%
  532.    \abovedisplayskip 11\p@ \@plus3\p@ \@minus6\p@
  533.    \abovedisplayshortskip \z@ \@plus3\p@
  534.    \belowdisplayshortskip 6.5\p@ \@plus3.5\p@ \@minus3\p@
  535.    \def\@listi{\leftmargin\leftmargini
  536.                \topsep 9\p@ \@plus3\p@ \@minus5\p@
  537.                \parsep 4.5\p@ \@plus2\p@ \@minus\p@
  538.                \itemsep \parsep}%
  539. %</12pt>
  540.    \belowdisplayskip \abovedisplayskip
  541. %    \end{macrocode}
  542. % \end{macro}
  543. % \begin{macro}{\footnotesize}
  544. %    This is similar to |\normalsize|.
  545. % \changes{v1.0h}{1993/12/18}{\cmd\footnotesize is now defined in the
  546. %    kernel, so use \cmd\renewcommand.  ASAJ.}
  547. % \changes{v1.2e}{1994/04/14}{use \cmd\newcommand again}
  548. %    \begin{macrocode}
  549. \newcommand\footnotesize{%
  550. %<*10pt>
  551.    \@setfontsize\footnotesize\@viiipt{9.5}%
  552.    \abovedisplayskip 6\p@ \@plus2\p@ \@minus4\p@
  553.    \abovedisplayshortskip \z@ \@plus\p@
  554.    \belowdisplayshortskip 3\p@ \@plus\p@ \@minus2\p@
  555.    \def\@listi{\leftmargin\leftmargini
  556.                \topsep 3\p@ \@plus\p@ \@minus\p@
  557.                \parsep 2\p@ \@plus\p@ \@minus\p@
  558.                \itemsep \parsep}%
  559. %</10pt>
  560. %<*11pt>
  561.    \@setfontsize\footnotesize\@ixpt{11}%
  562.    \abovedisplayskip 8\p@ \@plus2\p@ \@minus4\p@
  563.    \abovedisplayshortskip \z@ \@plus\p@
  564.    \belowdisplayshortskip 4\p@ \@plus2\p@ \@minus2\p@
  565.    \def\@listi{\leftmargin\leftmargini
  566.                \topsep 4\p@ \@plus2\p@ \@minus2\p@
  567.                \parsep 2\p@ \@plus\p@ \@minus\p@
  568.                \itemsep \parsep}%
  569. %</11pt>
  570. %<*12pt>
  571.    \@setfontsize\footnotesize\@xpt\@xiipt
  572.    \abovedisplayskip 10\p@ \@plus2\p@ \@minus5\p@
  573.    \abovedisplayshortskip \z@ \@plus3\p@
  574.    \belowdisplayshortskip 6\p@ \@plus3\p@ \@minus3\p@
  575.    \def\@listi{\leftmargin\leftmargini
  576.                \topsep 6\p@ \@plus2\p@ \@minus2\p@
  577.                \parsep 3\p@ \@plus2\p@ \@minus\p@
  578.                \itemsep \parsep}%
  579. %</12pt>
  580.    \belowdisplayskip \abovedisplayskip
  581. %</10pt|11pt|12pt>
  582. %    \end{macrocode}
  583. % \end{macro}
  584. % \begin{macro}{\scriptsize}
  585. % \begin{macro}{\tiny}
  586. % \begin{macro}{\large}
  587. % \begin{macro}{\Large}
  588. % \begin{macro}{\LARGE}
  589. % \begin{macro}{\huge}
  590. % \begin{macro}{\Huge}
  591. %    These are all much simpler than the previous macros, they just
  592. %    select a new fontsize, but leave the parameters for displays and
  593. %    lists alone.
  594. % \changes{v1.0h}{1993/12/18}{These are now defined in the kernel,
  595. %    so use \cmd\renewcommand.  ASAJ.}
  596. % \changes{v1.2e}{1994/04/14}{use \cmd\newcommand again}
  597. %    \begin{macrocode}
  598. %<*10pt>
  599. \newcommand\scriptsize{\@setfontsize\scriptsize\@viipt\@viiipt}
  600. \newcommand\tiny{\@setfontsize\tiny\@vpt\@vipt}
  601. \newcommand\large{\@setfontsize\large\@xiipt{14}}
  602. \newcommand\Large{\@setfontsize\Large\@xivpt{18}}
  603. \newcommand\LARGE{\@setfontsize\LARGE\@xviipt{22}}
  604. \newcommand\huge{\@setfontsize\huge\@xxpt{25}}
  605. \newcommand\Huge{\@setfontsize\Huge\@xxvpt{30}}
  606. %</10pt>
  607. %<*11pt>
  608. \newcommand\scriptsize{\@setfontsize\scriptsize\@viiipt{9.5}}
  609. \newcommand\tiny{\@setfontsize\tiny\@vipt\@viipt}
  610. \newcommand\large{\@setfontsize\large\@xiipt{14}}
  611. \newcommand\Large{\@setfontsize\Large\@xivpt{18}}
  612. \newcommand\LARGE{\@setfontsize\LARGE\@xviipt{22}}
  613. \newcommand\huge{\@setfontsize\huge\@xxpt{25}}
  614. \newcommand\Huge{\@setfontsize\Huge\@xxvpt{30}}
  615. %</11pt>
  616. %<*12pt>
  617. \newcommand\scriptsize{\@setfontsize\scriptsize\@viiipt{9.5}}
  618. \newcommand\tiny{\@setfontsize\tiny\@vipt\@viipt}
  619. \newcommand\large{\@setfontsize\large\@xivpt{18}}
  620. \newcommand\Large{\@setfontsize\Large\@xviipt{22}}
  621. \newcommand\LARGE{\@setfontsize\LARGE\@xxpt{25}}
  622. \newcommand\huge{\@setfontsize\huge\@xxvpt{30}}
  623. \let\Huge=\huge
  624. %</12pt>
  625. %    \end{macrocode}
  626. % \end{macro}
  627. % \end{macro}
  628. % \end{macro}
  629. % \end{macro}
  630. % \end{macro}
  631. % \end{macro}
  632. % \end{macro}
  633. % \subsection{Paragraphing}
  634. % \begin{macro}{\lineskip}
  635. % \begin{macro}{\normallineskip}
  636. %    These parameters control \TeX's behaviour when two lines tend to
  637. %    come too close together.
  638. %    \begin{macrocode}
  639. %<*article|report|book>
  640. \setlength\lineskip{1\p@}
  641. \setlength\normallineskip{1\p@}
  642. %    \end{macrocode}
  643. % \end{macro}
  644. % \end{macro}
  645. % \begin{macro}{\baselinestretch}
  646. %    This is used as a multiplier for |\baselineskip|. The default is
  647. %    to {\em not\/} stretch the baselines.
  648. %    \begin{macrocode}
  649. \renewcommand\baselinestretch{}
  650. %    \end{macrocode}
  651. % \end{macro}
  652. % \begin{macro}{\parskip}
  653. % \begin{macro}{\parindent}
  654. %    |\parskip| gives extra vertical space between paragraphs and
  655. %    |\parindent| is the width of the paragraph indentation. The value
  656. %    of |\parindent| depends on whether we are in two column mode.
  657. % \changes{v1.0m}{1994/01//12}{\cmd\parindent should be different,
  658. %                             depending on the pointsize}
  659. %    \begin{macrocode}
  660. \setlength\parskip{0\p@ \@plus \p@}
  661. %</article|report|book>
  662. %<*10pt|11pt|12pt>
  663. \if@twocolumn
  664.   \setlength\parindent{1em}
  665. \else
  666. %<+10pt>  \setlength\parindent{15\p@}
  667. %<+11pt>  \setlength\parindent{17\p@}
  668. %<+12pt>  \setlength\parindent{1.5em}
  669. %</10pt|11pt|12pt>
  670. %    \end{macrocode}
  671. % \end{macro}
  672. % \end{macro}
  673. % \begin{macro}{\@lowpenalty}
  674. % \begin{macro}{\@medpenalty}
  675. % \begin{macro}{\@highpenalty}%
  676. %    The commands |\nopagebreak| and |\nolinebreak| put in penalties
  677. %    to discourage these breaks at the point they are put in.
  678. %    They use |\@lowpenalty|, |\@medpenalty| or |\@highpenalty|,
  679. %    dependent on their argument.
  680. %    \begin{macrocode}
  681. %<*article|report|book>
  682. \@lowpenalty   51
  683. \@medpenalty  151
  684. \@highpenalty 301
  685. %    \end{macrocode}
  686. % \end{macro}
  687. % \end{macro}
  688. % \end{macro}
  689. % \begin{macro}{\clubpenalty}
  690. % \begin{macro}{\widowpenalty}
  691. %    These penalties are use to discourrage club and widow lines.
  692. %    Because we use their default values we only show them here,
  693. %    commented out.
  694. %    \begin{macrocode}
  695. % \clubpenalty  150
  696. % \widowpenalty 150
  697. %    \end{macrocode}
  698. % \end{macro}
  699. % \end{macro}
  700. % \begin{macro}{\displaywidowpenalty}
  701. % \begin{macro}{\predisplaypenalty}
  702. % \begin{macro}{\postdisplaypenalty}
  703. %    Discourrage (but not so much) widows in front of a math display
  704. %    and forbid breaking directly in front of a display. Allow break
  705. %    after a display without a penalty. Again the default values are
  706. %    used, therefore we only show them here.
  707. %    \begin{macrocode}
  708. % \displaywidowpenalty 50
  709. % \predisplaypenalty   10000
  710. % \postdisplaypenalty  0
  711. %    \end{macrocode}
  712. % \end{macro}
  713. % \end{macro}
  714. % \end{macro}
  715. % \begin{macro}{\interlinepenalty}
  716. %    Allow the breaking of a page in the middle of a paragraph.
  717. %    \begin{macrocode}
  718. % \interlinepenalty 0
  719. %    \end{macrocode}
  720. % \end{macro}
  721. % \begin{macro}{\brokenpenalty}
  722. %    We allow the breaking of a page after a hyphenated line.
  723. % \changes{v1.1a}{1994/03/12}{Show correct default which is 100}
  724. %    \begin{macrocode}
  725. % \brokenpenalty 100
  726. %</article|report|book>
  727. %    \end{macrocode}
  728. % \end{macro}
  729. % \subsection{Page Layout}
  730. %    All margin dimensions are measured from a point one inch from the
  731. %    top and lefthand side of the page.
  732. % \subsubsection{Vertical spacing}
  733. % \begin{macro}{\headheight}
  734. % \begin{macro}{\headsep}
  735. % \begin{macro}{\topskip}
  736. %    The |\headheight| is the height of the box that will contain the
  737. %    running head. The |\headsep| is the distance between the bottom
  738. %    of the running head and the top of the text. |\topskip| is the
  739. %    |\baselineskip| for the first line on a page.
  740. %    \begin{macrocode}
  741. %<*10pt|11pt|12pt>
  742. \setlength\headheight{12\p@}
  743. %<-bk>\setlength\headsep   {25\p@}
  744. %<+10pt&bk>\setlength\headsep   {.25in}
  745. %<+11pt&bk>\setlength\headsep   {.275in}
  746. %<+12pt&bk>\setlength\headsep   {.275in}
  747. %<+10pt>\setlength\topskip   {10\p@}
  748. %<+11pt>\setlength\topskip   {11\p@}
  749. %<+12pt>\setlength\topskip   {12\p@}
  750. %    \end{macrocode}
  751. % \end{macro}
  752. % \end{macro}
  753. % \end{macro}
  754. % \begin{macro}{\footskip}
  755. %    The distance from the baseline of the box which contains the
  756. %    running footer to the baseline of last line of text is controlled
  757. %    by the |\footskip|.
  758. %    \begin{macrocode}
  759. %<-bk>\setlength\footskip{30\p@}
  760. %<+10pt&bk>\setlength\footskip{.35in}
  761. %<+11pt&bk>\setlength\footskip{.38in}
  762. %<+12pt&bk>\setlength\footskip{30\p@}
  763. %    \end{macrocode}
  764. % \end{macro}
  765. % \begin{macro}{\maxdepth}
  766. % \begin{macro}{\@maxdepth}
  767. % \changes{v1.2k}{1994/05/06}{Added setting of \cmd\maxdepth and
  768. %    \cmd\@maxdepth}
  769. %    The \TeX\ primitive register |\maxdepth| has a function that is
  770. %    similar to that of |\topskip|. The register |\@maxdepth| should
  771. %    always contain a copy of |\maxdepth|. In both plain \TeX\ and
  772. %    \LaTeX~2.09 |\maxdepth| had a fixed value of \texttt{4pt}; in
  773. %    native \LaTeX2e\ mode we let the value depend on the typesize. We
  774. %    set it so that |\maxdepth| $+$ |\topskip| $=$ typesize $\times
  775. %    1.5$. As it happens, in these classes |\topskip| is equal to the
  776. %    typesize, therefor we set |\maxdepth| to half the value of
  777. %    |\topskip|.
  778. %    \begin{macrocode}
  779. \if@compatibility
  780.   \setlength\maxdepth{4\p@}
  781. \else
  782.   \setlength\maxdepth{.5\topskip}
  783. \setlength\@maxdepth\maxdepth
  784. %    \end{macrocode}
  785. % \end{macro}
  786. % \end{macro}
  787. % \subsubsection{The dimension of text}
  788. % \begin{macro}{\textwidth}
  789. %    When we are in compatibility mode we have to make sure that the
  790. %    dimensions of the printed area are not different from what the
  791. %    user was used to see.
  792. %    \begin{macrocode}
  793. \if@compatibility
  794.   \if@twocolumn
  795.     \setlength\textwidth{410\p@}
  796.   \else
  797. %<+10pt&!bk>    \setlength\textwidth{345\p@}
  798. %<+11pt&!bk>    \setlength\textwidth{360\p@}
  799. %<+12pt&!bk>    \setlength\textwidth{390\p@}
  800. %<+10pt&bk>    \setlength\textwidth{4.5in}
  801. %<+11pt&bk>    \setlength\textwidth{5in}
  802. %<+12pt&bk>    \setlength\textwidth{5in}
  803.   \fi
  804. %    \end{macrocode}
  805. %    When we are not in compatibility mode we can set some of the
  806. %    dimensions differently, taking into account the paper size for
  807. %    instance.
  808. %    \begin{macrocode}
  809. \else
  810. %    \end{macrocode}
  811. %    First, we calculate the maximum |\textwidth|, which we will allow
  812. %    on the selected paper and store it in |\@tempdima|. Then we store
  813. %    the length of a line with approximately 60--70 characters in
  814. %    |\@tempdimb|. The values given are more or less suitable when
  815. %    Computer Modern fonts are used.
  816. % \changes{v1.1a}{1994/03/12}{Have old values for width in native mode}
  817. %    \begin{macrocode}
  818.   \setlength\@tempdima{\paperwidth}
  819.   \addtolength\@tempdima{-2in}
  820. %<+10pt>  \setlength\@tempdimb{345\p@}
  821. %<+11pt>  \setlength\@tempdimb{360\p@}
  822. %<+12pt>  \setlength\@tempdimb{390\p@}
  823. %    \end{macrocode}
  824. %    Now we can set the |\textwidth|, depending on whether we will be
  825. %    setting one or two columns.
  826. %    In two column mode each {\em column} shouldn't be wider than
  827. %    |\@tempdimb| (which could happen on \textsc{a3} paper for
  828. %    instance).
  829. %    \begin{macrocode}
  830.   \if@twocolumn
  831.     \ifdim\@tempdima>2\@tempdimb\relax
  832.       \setlength\textwidth{2\@tempdimb}
  833.     \else
  834.       \setlength\textwidth{\@tempdima}
  835.     \fi
  836. %    \end{macrocode}
  837. %    In one column mode the text should not be wider than the minimum
  838. %    of the paperwidth (minus 2 inches for the margins) and the
  839. %    maximum length of a line as defined by the number of characters.
  840. %    \begin{macrocode}
  841.   \else
  842.     \ifdim\@tempdima>\@tempdimb\relax
  843.       \setlength\textwidth{\@tempdimb}
  844.     \else
  845.       \setlength\textwidth{\@tempdima}
  846.     \fi
  847.   \fi
  848. %    \end{macrocode}
  849. %    Here we modify the width of the text a little to be a whole
  850. %    number of points.
  851. %    \begin{macrocode}
  852. \if@compatibility\else
  853.   \@settopoint\textwidth
  854. %    \end{macrocode}
  855. % \end{macro}
  856. % \begin{macro}{\textheight}
  857. %    Now that we have computed the width of the text, we have to take
  858. %    care of the height. The |\textheight| is the height of text
  859. %    (including footnotes and figures, excluding running head and
  860. %    foot).
  861. %    First make sure that the compatibility mode gets the same
  862. %    dimensions as we had with \LaTeX2.09. The number of lines was
  863. %    calculated as the floor of the old |\textheight| minus
  864. %    |\topskip|, divided by |\baselineskip| for |\normalsize|. The
  865. %    old value of |\textheight| was 528pt.
  866. %    \begin{macrocode}
  867. \if@compatibility
  868. %<+10pt&!bk>  \setlength\textheight{43\baselineskip}
  869. %<+10pt&bk>  \setlength\textheight{41\baselineskip}
  870. %<+11pt>  \setlength\textheight{38\baselineskip}
  871. %<+12pt>  \setlength\textheight{36\baselineskip}
  872. %    \end{macrocode}
  873. %    Again we compute this, depending on the papersize and depending
  874. %    on the baselineskip that is used, in order to have a whole number
  875. %    of lines on the page.
  876. %    \begin{macrocode}
  877. \else
  878.   \setlength\@tempdima{\paperheight}
  879. %    \end{macrocode}
  880. %    We leave at least a 1 inch margin on the top and the bottom of
  881. %    the page.
  882. %    \begin{macrocode}
  883.   \addtolength\@tempdima{-2in}
  884. %    \end{macrocode}
  885. %    We also have to leave room for the running headers and footers.
  886. %    \begin{macrocode}
  887.   \addtolength\@tempdima{-1.5in}
  888. %    \end{macrocode}
  889. %    Then we divide the result by the current |\baselineskip| and
  890. %    store this in the count register |\@tempcnta|, which then
  891. %    contains the number of lines that fit on this page.
  892. %    \begin{macrocode}
  893.   \divide\@tempdima\baselineskip
  894.   \@tempcnta=\@tempdima
  895. %    \end{macrocode}
  896. %    From this we can calculate the height of the text.
  897. %    \begin{macrocode}
  898.   \setlength\textheight{\@tempcnta\baselineskip}
  899. %    \end{macrocode}
  900. %    The first line on the page has a height of |\topskip|.
  901. %    \begin{macrocode}
  902. \addtolength\textheight{\topskip}
  903. %    \end{macrocode}
  904. % \end{macro}
  905. % \subsubsection{Margins}
  906. % \begin{macro}{\oddsidemargin}
  907. % \begin{macro}{\evensidemargin}
  908. % \begin{macro}{\marginparwidth}
  909. %    First we give the values for the compatibility mode.
  910. %    Values for two-sided printing:
  911. %    \begin{macrocode}
  912. \if@compatibility
  913. %<*bk>
  914. %<+10pt>   \setlength\oddsidemargin   {.5in}
  915. %<+11pt>   \setlength\oddsidemargin   {.25in}
  916. %<+12pt>   \setlength\oddsidemargin   {.25in}
  917. %<+10pt>   \setlength\evensidemargin  {1.5in}
  918. %<+11pt>   \setlength\evensidemargin  {1.25in}
  919. %<+12pt>   \setlength\evensidemargin  {1.25in}
  920. %<+10pt>   \setlength\marginparwidth {.75in}
  921. %<+11pt>   \setlength\marginparwidth {1in}
  922. %<+12pt>   \setlength\marginparwidth {1in}
  923. %</bk>
  924. %<*!bk>
  925.   \if@twoside
  926. %<+10pt>     \setlength\oddsidemargin   {44\p@}
  927. %<+11pt>     \setlength\oddsidemargin   {36\p@}
  928. %<+12pt>     \setlength\oddsidemargin   {21\p@}
  929. %<+10pt>     \setlength\evensidemargin  {82\p@}
  930. %<+11pt>     \setlength\evensidemargin  {74\p@}
  931. %<+12pt>     \setlength\evensidemargin  {59\p@}
  932. %<+10pt>     \setlength\marginparwidth {107\p@}
  933. %<+11pt>     \setlength\marginparwidth {100\p@}
  934. %<+12pt>     \setlength\marginparwidth {85\p@}
  935. %    \end{macrocode}
  936. %    Values for one-sided printing:
  937. %    \begin{macrocode}
  938.   \else
  939. %<+10pt>     \setlength\oddsidemargin   {63\p@}
  940. %<+11pt>     \setlength\oddsidemargin   {54\p@}
  941. %<+12pt>     \setlength\oddsidemargin   {39.5\p@}
  942. %<+10pt>     \setlength\evensidemargin  {63\p@}
  943. %<+11pt>     \setlength\evensidemargin  {54\p@}
  944. %<+12pt>     \setlength\evensidemargin  {39.5\p@}
  945. %<+10pt>     \setlength\marginparwidth  {90\p@}
  946. %<+11pt>     \setlength\marginparwidth  {83\p@}
  947. %<+12pt>     \setlength\marginparwidth  {68\p@}
  948.   \fi
  949. %</!bk>
  950. %    \end{macrocode}
  951. %    And values for two column mode:
  952. %    \begin{macrocode}
  953.   \if@twocolumn
  954.      \setlength\oddsidemargin  {30\p@}
  955.      \setlength\evensidemargin {30\p@}
  956.      \setlength\marginparwidth {48\p@}
  957.   \fi
  958. %    \end{macrocode}
  959. %    When we are not in compatibility mode we can take the dimensions
  960. %    of the selected paper into account.
  961. %    The values for |\oddsidemargin| and |\marginparwidth| will be set
  962. %    depending on the status of the |\if@twoside|.
  963. %    If |@twoside| is true (which is always the case for book) we make
  964. %    the inner margin smaller than the outer one.
  965. %    \begin{macrocode}
  966. \else
  967. %<-bk>  \if@twoside
  968.     \setlength\@tempdima        {\paperwidth}
  969.     \addtolength\@tempdima      {-\textwidth}
  970.     \setlength\oddsidemargin    {.4\@tempdima}
  971.     \addtolength\oddsidemargin  {-1in}
  972. %    \end{macrocode}
  973. %    The width of the margin for text is set to the remainder of the
  974. %    width except for a `real margin' of white space of width 0.4in.
  975. %    A check should perhaps be built in to ensure that the (text)
  976. %    margin width does not get too small!
  977. %    
  978. % \changes{v1.1a}{1994/03/12}{New algorithm for `oddsidemargin}
  979. % \changes{v1.1a}{1994/03/12}{New algorithm for `marginparwidth}
  980. %    \begin{macrocode}
  981.     \setlength\marginparwidth   {.6\@tempdima}
  982.     \addtolength\marginparwidth {-0.4in}
  983. %    \end{macrocode}
  984. %    For one-sided printing we center the text on the page, by
  985. %    calculating the difference between |\textwidth| and
  986. %    |\paperwidth|. Half of that difference is than used for
  987. %    the margin (thus |\oddsidemargin| is |1in| less). 
  988. %    \begin{macrocode}
  989. %<*!bk>
  990.   \else
  991.     \setlength\@tempdima        {\paperwidth}
  992.     \addtolength\@tempdima      {-\textwidth}
  993.     \setlength\oddsidemargin    {.5\@tempdima}
  994.     \addtolength\oddsidemargin  {-1in}
  995.     \setlength\marginparwidth   {.5\@tempdima}
  996.     \addtolength\marginparwidth {-.4in}
  997.   \fi
  998. %</!bk>
  999. %    \end{macrocode}
  1000. %    With the above algorithm the |\marginparwidth| can come out quite
  1001. %    large which we may not want.
  1002. %    \begin{macrocode}
  1003.   \ifdim \marginparwidth >2in
  1004.      \setlength\marginparwidth{2in}
  1005.   \fi
  1006. %    \end{macrocode}
  1007. %    Having done these calculation we make them pt values.
  1008. %    \begin{macrocode}
  1009.   \@settopoint\oddsidemargin
  1010.   \@settopoint\marginparwidth
  1011. %    \end{macrocode}
  1012. %    The |\evensidemargin| can now be computed from the values set
  1013. %    above.
  1014. % \changes{v1.0l}{1994/01//11}{Computing of \cmd\evensidemargin should
  1015. %                             only occur in compatibility mode}
  1016. %    \begin{macrocode}
  1017.   \setlength\evensidemargin  {\paperwidth}
  1018.   \addtolength\evensidemargin{-2in}
  1019.   \addtolength\evensidemargin{-\textwidth}
  1020.   \addtolength\evensidemargin{-\oddsidemargin}
  1021. %    \end{macrocode}
  1022. %    Setting |\evensidemargin| to a full point value may produce a
  1023. %    small error. However it will lie within the error range a
  1024. %    doublesided printer of todays technology can accuratly print.
  1025. %    \begin{macrocode}
  1026.   \@settopoint\evensidemargin
  1027. %    \end{macrocode}
  1028. % \end{macro}
  1029. % \end{macro}
  1030. % \end{macro}
  1031. % \begin{macro}{\marginparsep}
  1032. % \begin{macro}{\marginparpush}
  1033. %    The horizontal space between the main text and marginal notes is
  1034. %    determined by |\marginparsep|, the minimum vertical separation
  1035. %    between two marginal notes is controlled by |\marginparpush|.
  1036. %    \begin{macrocode}
  1037. \if@twocolumn
  1038.  \setlength\marginparsep {10\p@}
  1039. \else
  1040. %<+10pt&!bk>  \setlength\marginparsep{11\p@}
  1041. %<+11pt&!bk>  \setlength\marginparsep{10\p@}
  1042. %<+12pt&!bk>  \setlength\marginparsep{10\p@}
  1043. %<+bk>  \setlength\marginparsep{7\p@}
  1044. %<+10pt|11pt>\setlength\marginparpush{5\p@}
  1045. %<+12pt>\setlength\marginparpush{7\p@}
  1046. %    \end{macrocode}
  1047. % \end{macro}
  1048. % \end{macro}
  1049. % \begin{macro}{\topmargin}
  1050. %    The |\topmargin| is the distance between the top of `the
  1051. %    printable area' --which is 1 inch below the top of the paper--
  1052. %    and the top of the box which contains the running head.
  1053. %    It can now be computed from the values set above.
  1054. %    \begin{macrocode}
  1055. \if@compatibility
  1056. %<-bk>  \setlength\topmargin{27pt}
  1057. %<+10pt&bk>  \setlength\topmargin{.75in}
  1058. %<+11pt&bk>  \setlength\topmargin{.73in}
  1059. %<+12pt&bk>  \setlength\topmargin{.73in}
  1060. \else
  1061.   \setlength\topmargin{\paperheight}
  1062.   \addtolength\topmargin{-2in}
  1063.   \addtolength\topmargin{-\headheight}
  1064.   \addtolength\topmargin{-\headsep}
  1065.   \addtolength\topmargin{-\textheight}
  1066.   \addtolength\topmargin{-\footskip}     % this might be wrong!
  1067. %    \end{macrocode}
  1068. %    By changing the factor in the next line the complete page
  1069. %    can be shifted vertically.
  1070. % \changes{v1.2u}{1994/07/13}{Moved rounding of \cs{topmargin} to
  1071. %    native mode}
  1072. %    \begin{macrocode}
  1073.   \addtolength\topmargin{-.5\topmargin}
  1074.   \@settopoint\topmargin
  1075. %    \end{macrocode}
  1076. % \end{macro}
  1077. % \subsubsection{Footnotes}
  1078. % \begin{macro}{\footnotesep}
  1079. %    |\footnotesep| is the height of the strut placed at the beginning
  1080. %    of every footnote. It equals the  height of a normal
  1081. %    |\footnotesize| strut in this
  1082. %    class, thus no extra space occurs between footnotes.
  1083. %    \begin{macrocode}
  1084. %<+10pt>\setlength\footnotesep{6.65\p@}
  1085. %<+11pt>\setlength\footnotesep{7.7\p@}
  1086. %<+12pt>\setlength\footnotesep{8.4\p@}
  1087. %    \end{macrocode}
  1088. % \end{macro}
  1089. % \begin{macro}{\footins}
  1090. %    |\skip\footins| is the space between the last line of the main
  1091. %    text and the top of the first footnote.
  1092. %    \begin{macrocode}
  1093. %<+10pt>\setlength{\skip\footins}{9\p@ \@plus 4\p@ \@minus 2\p@}
  1094. %<+11pt>\setlength{\skip\footins}{10\p@ \@plus 4\p@ \@minus 2\p@}
  1095. %<+12pt>\setlength{\skip\footins}{10.8\p@ \@plus 4\p@ \@minus 2\p@}
  1096. %</10pt|11pt|12pt>
  1097. %    \end{macrocode}
  1098. % \end{macro}
  1099. % \subsubsection{Float placement parameters}
  1100. % All float parameters are given default values in the \LaTeXe{}
  1101. % kernel. For this reason counters only need to be set with
  1102. % |\setcounter| and other parameters are set using |\renewcommand|.
  1103. % \paragraph{Limits for the placement of floating objects}
  1104. % \begin{macro}{\c@topnumber}
  1105. %    The \Lcount{topnumber} counter holds the maximum number of
  1106. %    floats that can appear on the top of a text page.
  1107. %    \begin{macrocode}
  1108. %<*article|report|book>
  1109. \setcounter{topnumber}{2}
  1110. %    \end{macrocode}
  1111. % \end{macro}
  1112. % \begin{macro}{\topfraction}
  1113. %    This indicates the maximum part of a text page that can be
  1114. %    occupied by floats at the top.
  1115. % \changes{v1.0h}{1993/12/18}{Replaced \cmd\newcommand with
  1116. %    \cmd\renewcommand.  ASAJ.}
  1117. %    \begin{macrocode}
  1118. \renewcommand\topfraction{.7}
  1119. %    \end{macrocode}
  1120. % \end{macro}
  1121. % \begin{macro}{\c@bottomnumber}
  1122. %    The \Lcount{bottomnumber} counter holds the maximum number of
  1123. %    floats that can appear on the bottom of a text page.
  1124. %    \begin{macrocode}
  1125. \setcounter{bottomnumber}{1}
  1126. %    \end{macrocode}
  1127. % \end{macro}
  1128. % \begin{macro}{\bottomfraction}
  1129. %    This indicates the maximum part of a text page that can be
  1130. %    occupied by floats at the bottom.
  1131. % \changes{v1.0h}{1993/12/18}{Replaced \cmd\newcommand with
  1132. %    \cmd\renewcommand.  ASAJ.}
  1133. %    \begin{macrocode}
  1134. \renewcommand\bottomfraction{.3}
  1135. %    \end{macrocode}
  1136. % \end{macro}
  1137. % \begin{macro}{\c@totalnumber}
  1138. %    This indicates the maximum number of floats that can appear on
  1139. %    any text page.
  1140. %    \begin{macrocode}
  1141. \setcounter{totalnumber}{3}
  1142. %    \end{macrocode}
  1143. % \end{macro}
  1144. % \begin{macro}{\textfraction}
  1145. %    This indicates the minimum part of a text page that has to be
  1146. %    occupied by text.
  1147. % \changes{v1.0h}{1993/12/18}{Replaced \cmd\newcommand with
  1148. %    \cmd\renewcommand.  ASAJ.}
  1149. %    \begin{macrocode}
  1150. \renewcommand\textfraction{.2}
  1151. %    \end{macrocode}
  1152. % \end{macro}
  1153. % \begin{macro}{\floatpagefraction}
  1154. %    This indicates the minimum part of a page that has to be
  1155. %    occupied by floating objects before a `float page' is produced.
  1156. % \changes{v1.0h}{1993/12/18}{Replaced \cmd\newcommand with
  1157. %    \cmd\renewcommand.  ASAJ.}
  1158. %    \begin{macrocode}
  1159. \renewcommand\floatpagefraction{.5}
  1160. %    \end{macrocode}
  1161. % \end{macro}
  1162. % \begin{macro}{\c@dbltopnumber}
  1163. %    The \Lcount{dbltopnumber} counter holds the maximum number of
  1164. %    two column floats that can appear on the top of a two column text
  1165. %    page.
  1166. %    \begin{macrocode}
  1167. \setcounter{dbltopnumber}{2}
  1168. %    \end{macrocode}
  1169. % \end{macro}
  1170. % \begin{macro}{\dbltopfraction}
  1171. %    This indicates the maximum part of a two column text page that
  1172. %    can be occupied by two column floats at the top.
  1173. % \changes{v1.0h}{1993/12/18}{Replaced \cmd\newcommand with
  1174. %    \cmd\renewcommand.  ASAJ.}
  1175. %    \begin{macrocode}
  1176. \renewcommand\dbltopfraction{.7}
  1177. %    \end{macrocode}
  1178. % \end{macro}
  1179. % \begin{macro}{\dblfloatpagefraction}
  1180. %    This indicates the minimum part of a page that has to be
  1181. %    occupied by two column wide floating objects before a `float
  1182. %    page' is produced.
  1183. % \changes{v1.0h}{1993/12/18}{Replaced \cmd\newcommand with
  1184. %    \cmd\renewcommand.  ASAJ.}
  1185. %    \begin{macrocode}
  1186. \renewcommand\dblfloatpagefraction{.5}
  1187. %</article|report|book>
  1188. %    \end{macrocode}
  1189. % \end{macro}
  1190. % \paragraph{Floats on a text page}
  1191. % \begin{macro}{\floatsep}
  1192. % \begin{macro}{\textfloatsep}
  1193. % \begin{macro}{\intextsep}
  1194. %    When a floating object is placed on a page with text, these
  1195. %    parameters control the separation between the float and the other
  1196. %    objects on the page. These parameters are used for both
  1197. %    one-column mode and single-column floats in two-column mode.
  1198. %    |\floatsep| is the space between adjacent floats that are moved
  1199. %    to the top or bottom of the text page.
  1200. %    |\textfloatsep| is the space between the main text and floats
  1201. %    at the top or bottom of the page.
  1202. %    |\intextsep| is the space between in-text floats and the text.
  1203. %    \begin{macrocode}
  1204. %<*10pt>
  1205. \setlength\floatsep    {12\p@ \@plus 2\p@ \@minus 2\p@}
  1206. \setlength\textfloatsep{20\p@ \@plus 2\p@ \@minus 4\p@}
  1207. \setlength\intextsep   {12\p@ \@plus 2\p@ \@minus 2\p@}
  1208. %</10pt>
  1209. %<*11pt>
  1210. \setlength\floatsep    {12\p@ \@plus 2\p@ \@minus 2\p@}
  1211. \setlength\textfloatsep{20\p@ \@plus 2\p@ \@minus 4\p@}
  1212. \setlength\intextsep   {12\p@ \@plus 2\p@ \@minus 2\p@}
  1213. %</11pt>
  1214. %<*12pt>
  1215. \setlength\floatsep    {12\p@ \@plus 2\p@ \@minus 4\p@}
  1216. \setlength\textfloatsep{20\p@ \@plus 2\p@ \@minus 4\p@}
  1217. \setlength\intextsep   {14\p@ \@plus 4\p@ \@minus 4\p@}
  1218. %</12pt>
  1219. %    \end{macrocode}
  1220. % \end{macro}
  1221. % \end{macro}
  1222. % \end{macro}
  1223. % \begin{macro}{\dblfloatsep}
  1224. % \begin{macro}{\dbltextfloatsep}
  1225. %    When floating objects that span the whole |\textwidth| are placed
  1226. %    on a text page when we are in twocolumn mode the separation
  1227. %    between the float and the text is controlled by |\dblfloatsep|
  1228. %    and |\dbltextfloatsep|.
  1229. %    |\dblfloatsep| is the space between adjacent floats that are moved
  1230. %    to the top or bottom of the text page.
  1231. %    |\dbltextfloatsep| is the space between the main text and floats
  1232. %    at the top or bottom of the page.
  1233. %    \begin{macrocode}
  1234. %<*10pt>
  1235. \setlength\dblfloatsep    {12\p@ \@plus 2\p@ \@minus 2\p@}
  1236. \setlength\dbltextfloatsep{20\p@ \@plus 2\p@ \@minus 4\p@}
  1237. %</10pt>
  1238. %<*11pt>
  1239. \setlength\dblfloatsep    {12\p@ \@plus 2\p@ \@minus 2\p@}
  1240. \setlength\dbltextfloatsep{20\p@ \@plus 2\p@ \@minus 4\p@}
  1241. %</11pt>
  1242. %<*12pt>
  1243. \setlength\dblfloatsep    {14\p@ \@plus 2\p@ \@minus 4\p@}
  1244. \setlength\dbltextfloatsep{20\p@ \@plus 2\p@ \@minus 4\p@}
  1245. %</12pt>
  1246. %    \end{macrocode}
  1247. % \end{macro}
  1248. % \end{macro}
  1249. % \paragraph{Floats on their own page or column}
  1250. % \begin{macro}{\@fptop}
  1251. % \begin{macro}{\@fpsep}
  1252. % \begin{macro}{\@fpbot}
  1253. %    When floating objects are placed on separate pages the layout of
  1254. %    such pages is controlled by these parameters. At the top of the
  1255. %    page |\@fptop| amount of stretchable whitespace is inserted, at
  1256. %    the bottom of the page we get an |\@fpbot| amount of stretchable
  1257. %    whitespace. Between adjacent floats the |\@fpsep| is inserted.
  1258. %    These parameters are used for the placement of floating objects
  1259. %    in one column mode, or in single column floats in two column
  1260. %    mode.
  1261. %    Note that at least one of the two parameters |\@fptop| and
  1262. %    |\@fpbot| should contain a |plus ...fil| to allow filling the
  1263. %    remaining empty space.
  1264. %    \begin{macrocode}
  1265. %<*10pt>
  1266. \setlength\@fptop{0\p@ \@plus 1fil}
  1267. \setlength\@fpsep{8\p@ \@plus 2fil}
  1268. \setlength\@fpbot{0\p@ \@plus 1fil}
  1269. %</10pt>
  1270. %<*11pt>
  1271. \setlength\@fptop{0\p@ \@plus 1fil}
  1272. \setlength\@fpsep{8\p@ \@plus 2fil}
  1273. \setlength\@fpbot{0\p@ \@plus 1fil}
  1274. %</11pt>
  1275. %<*12pt>
  1276. \setlength\@fptop{0\p@ \@plus 1fil}
  1277. \setlength\@fpsep{10\p@ \@plus 2fil}
  1278. \setlength\@fpbot{0\p@ \@plus 1fil}
  1279. %</12pt>
  1280. %    \end{macrocode}
  1281. % \end{macro}
  1282. % \end{macro}
  1283. % \end{macro}
  1284. % \begin{macro}{\@dblfptop}
  1285. % \begin{macro}{\@dblfpsep}
  1286. % \begin{macro}{\@dblfpbot}
  1287. %    Double column floats in two column mode are handled with similar
  1288. %    parameters.
  1289. %    \begin{macrocode}
  1290. %<*10pt>
  1291. \setlength\@dblfptop{0\p@ \@plus 1fil}
  1292. \setlength\@dblfpsep{8\p@ \@plus 2fil}
  1293. \setlength\@dblfpbot{0\p@ \@plus 1fil}
  1294. %</10pt>
  1295. %<*11pt>
  1296. \setlength\@dblfptop{0\p@ \@plus 1fil}
  1297. \setlength\@dblfpsep{8\p@ \@plus 2fil}
  1298. \setlength\@dblfpbot{0\p@ \@plus 1fil}
  1299. %</11pt>
  1300. %<*12pt>
  1301. \setlength\@dblfptop{0\p@ \@plus 1fil}
  1302. \setlength\@dblfpsep{10\p@ \@plus 2fil}
  1303. \setlength\@dblfpbot{0\p@ \@plus 1fil}
  1304. %</12pt>
  1305. %<*article|report|book>
  1306. %    \end{macrocode}
  1307. % \end{macro}
  1308. % \end{macro}
  1309. % \end{macro}
  1310. % \subsection{Page Styles}
  1311. %    The page style \pstyle{foo} is defined by defining the command
  1312. %    |\ps@foo|.   This command should make only local definitions.
  1313. %    There should be no stray spaces in the definition, since they
  1314. %    could lead to mysterious extra spaces in the output (well, that's
  1315. %    something that should be always avoided).
  1316. % \begin{macro}{\@evenhead}
  1317. % \begin{macro}{\@oddhead}
  1318. % \begin{macro}{\@evenfoot}
  1319. % \begin{macro}{\@oddfoot}
  1320. %    The |\ps@...| command defines the macros |\@oddhead|,
  1321. %    |\@oddfoot|, |\@evenhead|, and |\@evenfoot| to define the running
  1322. %    heads and feet---e.g., |\@oddhead| is the macro to produce the
  1323. %    contents of the heading box for odd-numbered pages.  It is called
  1324. %    inside an |\hbox| of width |\textwidth|.
  1325. % \end{macro}
  1326. % \end{macro}
  1327. % \end{macro}
  1328. % \end{macro}
  1329. % \subsubsection{Marking conventions}
  1330. %    To make headings determined by the sectioning commands, the page
  1331. %    style defines the commands |\chaptermark|, |\sectionmark|,
  1332. %    \ldots,\\
  1333. %     where |\chaptermark{|\meta{TEXT}|}| is called by
  1334. %    |\chapter| to set a mark, and so on.
  1335. %    The |\...mark| commands and the |\...head| macros are defined
  1336. %    with the help of the following macros.  (All the |\...mark|
  1337. %    commands should be initialized to no-ops.)
  1338. %    \LaTeX{} extends \TeX's |\mark| facility by producing two kinds
  1339. %    of marks, a `left' and a `right' mark, using the following
  1340. %    commands:
  1341. %    \begin{flushleft}
  1342. %     |\markboth{|\meta{LEFT}|}{|\meta{RIGHT}|}|: Adds both marks.
  1343. %     |\markright{|\meta{RIGHT}|}|: Adds a `right' mark.
  1344. %     |\leftmark|: Used in the |\@oddhead|, |\@oddfoot|, |\@evenhead|
  1345. %                  or |\@evenfoot| macros, it gets the current `left'
  1346. %                  mark.  |\leftmark| works like \TeX's |\botmark|
  1347. %                  command.
  1348. %     |\rightmark|: Used in the |\@oddhead|, |\@oddfoot|, |\@evenhead|
  1349. %                   or  |\@evenfoot| macros, it gets the current
  1350. %                   `right' mark. |\rightmark| works like \TeX's
  1351. %                   |\firstmark| command.
  1352. %    \end{flushleft}
  1353. %    The marking commands work reasonably well for right marks
  1354. %    `numbered within' left marks--e.g., the left mark is changed by a
  1355. %    |\chapter| command and the right mark is changed by a |\section|
  1356. %    command.  However, it does produce somewhat anomalous results if
  1357. %    two |\markboth|'s occur on the same page.
  1358. %    Commands like |\tableofcontents| that should set the marks in some
  1359. %    page styles use a |\@mkboth| command, which is |\let| by the
  1360. %    pagestyle command (|\ps@...|)  to |\markboth| for setting the
  1361. %    heading or to |\@gobbletwo| to do nothing.
  1362. %    \begin{macrocode}
  1363. % %%%\mark{{}{}}   % Initializes TeX's marks   <--- can vanish
  1364. %    \end{macrocode}
  1365. % \subsubsection{Defining the page styles}
  1366. % \label{sec:pagestyle}
  1367. %    The pagestyles \pstyle{empty} and \pstyle{plain} are defined in
  1368. %    \file{latex.dtx}.
  1369. % \begin{macro}{\ps@headings}
  1370. %    The definition of the page style \pstyle{headings} has to be
  1371. %    different for two sided printing than it is for one sided
  1372. %    printing.
  1373. %    \begin{macrocode}
  1374. %<-book>\if@twoside
  1375.     \def\ps@headings{%
  1376. %    \end{macrocode}
  1377. %    The running feet are empty in this page style, the running head
  1378. %    contains the page number and one of the marks.
  1379. %    \begin{macrocode}
  1380.       \let\@oddfoot\@empty\let\@evenfoot\@empty
  1381.       \def\@evenhead{\thepage\hfil\slshape\leftmark}%
  1382.       \def\@oddhead{{\slshape\rightmark}\hfil\thepage}%
  1383. %    \end{macrocode}
  1384. %    When using this page style, the contents of the running head is
  1385. %    determined by the chapter and section titles. So we |\let|
  1386. %    |\@mkboth| to |\markboth|.
  1387. %    \begin{macrocode}
  1388.       \let\@mkboth\markboth
  1389. %    \end{macrocode}
  1390. %    For the article document class we define |\sectionmark| to clear
  1391. %    the right mark and put the number of the section (when it is
  1392. %    numbered) and its title in the left mark. The rightmark is set by
  1393. %    |\subsectionmark| to contain the subsection titles.
  1394. %    Note the use of |##1| for the parameter of the |\sectionmark|
  1395. %    command, which will be defined when |\ps@headings| is executed.
  1396. %    \begin{macrocode}
  1397. %<*article>
  1398.       \def\sectionmark##1{%
  1399.         \markboth {\uppercase{\ifnum \c@secnumdepth >\z@
  1400.             \thesection.\hskip 1em\relax\fi
  1401.             ##1}}{}}%
  1402.       \def\subsectionmark##1{%
  1403.         \markright {\ifnum \c@secnumdepth >\@ne
  1404.             \thesubsection\hskip 1em\relax \fi
  1405.             ##1}}}
  1406. %</article>
  1407. %    \end{macrocode}
  1408. %    In the report and book document classes we use the |\chaptermark|
  1409. %    and |\sectionmark| macros to fill the running heads.
  1410. %    Note the use of |##1| for the parameter of the |\chaptermark|
  1411. %    command, which will be defined when |\ps@headings| is executed.
  1412. %    \begin{macrocode}
  1413. %<*report|book>
  1414.       \def\chaptermark##1{%
  1415.         \markboth {\uppercase{\ifnum \c@secnumdepth >\m@ne
  1416. %<+book>          \if@mainmatter
  1417.             \@chapapp\ \thechapter. \ \fi
  1418. %<+book>          \fi
  1419.             ##1}}{}}%
  1420.       \def\sectionmark##1{%
  1421.         \markright {\uppercase{\ifnum \c@secnumdepth >\z@
  1422.             \thesection. \ \fi
  1423.             ##1}}}}
  1424. %</report|book>
  1425. %    \end{macrocode}
  1426. %    The definition of |\ps@headings| for one sided printing can be
  1427. %    much simpler, because we treat even and odd pages the same.
  1428. %    Therefore we don't need to define |\@even...|.
  1429. %    \begin{macrocode}
  1430. %<*article|report>
  1431. \else
  1432.     \def\ps@headings{%
  1433.       \let\@oddfoot\@empty
  1434.       \def\@oddhead{{\slshape\rightmark}\hfil\thepage}%
  1435.       \let\@mkboth\markboth
  1436. %    \end{macrocode}
  1437. %    We use |\markright| now instead of |\markboth| as we did for two
  1438. %    sided printing.
  1439. %    \begin{macrocode}
  1440. %<*article>
  1441.       \def\sectionmark##1{%
  1442.         \markright {\uppercase{\ifnum \c@secnumdepth >\m@ne
  1443.             \thesection\hskip 1em\relax \fi
  1444.             ##1}}}}
  1445. %</article>
  1446. %    \end{macrocode}
  1447. %    \begin{macrocode}
  1448. %<*report|book>
  1449.       \def\chaptermark##1{%
  1450.         \markright {\uppercase{\ifnum \c@secnumdepth >\m@ne
  1451. %<+book>          \if@mainmatter
  1452.             \@chapapp\ \thechapter. \ \fi
  1453. %<+book>          \fi
  1454.             ##1}}}}
  1455. %</report|book>
  1456. %</article|report>
  1457. %    \end{macrocode}
  1458. % \end{macro}
  1459. % \begin{macro}{\ps@myheadings}
  1460. %    The definition of the page style \pstyle{myheadings} is fairly
  1461. %    simple because the user determines the contents of the running
  1462. %    head himself by using the |\markboth| and |\markright| commands.
  1463. %    \begin{macrocode}
  1464. \def\ps@myheadings{%
  1465.     \let\@oddfoot\@empty\let\@evenfoot\@empty
  1466.     \def\@evenhead{\thepage\hfil\slshape\leftmark}%
  1467.     \def\@oddhead{{\slshape\rightmark}\hfil\thepage}%
  1468. %    \end{macrocode}
  1469. %    We have to make sure that the marking commands that are used by
  1470. %    the chapter and section headings are disabled. We do this
  1471. %    |\let|ting them to a macro that gobbles its argument(s).
  1472. %    \begin{macrocode}
  1473.     \let\@mkboth\@gobbletwo
  1474. %<-article>    \let\chaptermark\@gobble
  1475.     \let\sectionmark\@gobble
  1476. %<+article>    \let\subsectionmark\@gobble
  1477.     }
  1478. %    \end{macrocode}
  1479. % \end{macro}
  1480. % \section{Document Markup}
  1481. % \subsection{The title}
  1482. % \begin{macro}{\title}
  1483. % \begin{macro}{\author}
  1484. % \begin{macro}{\date}
  1485. %    These three macros are provided by \file{latex.dtx} to provide
  1486. %    information about the title, author(s) and date of the document.
  1487. %    The information is stored away in internal control sequences.
  1488. %    It is the task of the |\maketitle| command to use the
  1489. %    information provided. The definitions of these macros are shown
  1490. %    here for information.
  1491. %    \begin{macrocode}
  1492. % \newcommand\title[1]{\gdef\@title{#1}}
  1493. % \newcommand\author[1]{\gdef\@author{#1}}
  1494. % \newcommand\date[1]{\gdef\@date{#1}}
  1495. %    \end{macrocode}
  1496. %    The |\date| macro gets today's date by default.
  1497. %    \begin{macrocode}
  1498. % \gdef\@date{\today}
  1499. %    \end{macrocode}
  1500. % \end{macro}
  1501. % \end{macro}
  1502. % \end{macro}
  1503. % \begin{macro}{\maketitle}
  1504. %    The definition of |\maketitle| depends on whether a separate
  1505. %    title page is made. This is the default for the report and book
  1506. %    document classes, but for the article class it is optional.
  1507. %    When we are making a title page, we locally redefine
  1508. %    |\footnotesize| and |footnoterule| to change the appearance of
  1509. %    the footnotes that are produced by the |\thanks| command.
  1510. %    \begin{macrocode}
  1511. \if@titlepage
  1512.   \newcommand\maketitle{\begin{titlepage}%
  1513.   \let\footnotesize\small
  1514.   \let\footnoterule\relax
  1515. %    \end{macrocode}
  1516. %    We center the entire title vertically; the centering is set off a
  1517. %    little by adding a |\vskip|. (In compatibility mode the pagenumber
  1518. %    is set to 0 by the titlepage environment to keep the behaviour 
  1519. %    of \LaTeX\ 2.09 style files.)
  1520. % \changes{v1.0g}{1993/12/09}{Removed the setting of the page number,
  1521. %                            when not in compatibility mode}
  1522. % \changes{v1.2c}{1994/03/17}{Removed setting of page number, now 
  1523. %                            done in titlepage environment}
  1524. %    \begin{macrocode}
  1525.   \null\vfil
  1526.   \vskip 60\p@
  1527. %    \end{macrocode}
  1528. %    Then we set the title, in a |\LARGE| font; leave a little space
  1529. %    and set the author(s) in a |\large| font. We do this inside a
  1530. %    tabular environment to get them in a single column.
  1531. %    Before the date we leave a little whitespace again.
  1532. %    \begin{macrocode}
  1533.   \begin{center}%
  1534.     {\LARGE \@title \par}%
  1535.     \vskip 3em%
  1536.     {\large
  1537.      \lineskip .75em%
  1538.       \begin{tabular}[t]{c}%
  1539.         \@author
  1540.       \end{tabular}\par}%
  1541.       \vskip 1.5em%
  1542.     {\large \@date \par}%       % Set date in \large size.
  1543.   \end{center}\par
  1544. %    \end{macrocode}
  1545. %    Then we call |\@thanks| to print the information that goes into
  1546. %    the footnote and finish the page.
  1547. %    \begin{macrocode}
  1548.   \@thanks
  1549.   \vfil\null
  1550.   \end{titlepage}%
  1551. %    \end{macrocode}
  1552. %    We reset the \Lcount{footnote} counter, disable |\thanks| and
  1553. %    |\maketitle| and save some storage space by emptying the internal
  1554. %    information macros.
  1555. %    \begin{macrocode}
  1556.   \setcounter{footnote}{0}%
  1557.   \let\thanks\relax\let\maketitle\relax
  1558.   \gdef\@thanks{}\gdef\@author{}\gdef\@title{}}
  1559. %    \end{macrocode}
  1560. %    When the title is not on a page of its own, the layout of the
  1561. %    title is a little different. We use symbols to mark the footnotes
  1562. %    and we have to deal with two column documents.
  1563. %    Therefore we first start a new group to keep changes local. Then
  1564. %    we redefine |\thefootnote| to use |\fnsymbol|; and change
  1565. %    |\@makefnmark| so that footnotemarks have zero width (to make the
  1566. %    centering of the author names look better).
  1567. % \changes{v1.2s}{1994/06/02}{Reset \cs{@makefntext}}
  1568. %    \begin{macrocode}
  1569. \else
  1570. \newcommand\maketitle{\par
  1571.   \begingroup
  1572.     \renewcommand\thefootnote{\fnsymbol{footnote}}%
  1573.     \def\@makefnmark{\hbox to\z@{$\m@th^{\@thefnmark}$\hss}}%
  1574.     \long\def\@makefntext##1{\parindent 1em\noindent
  1575.             \hbox to1.8em{\hss$\m@th^{\@thefnmark}$}##1}%
  1576. %    \end{macrocode}
  1577. %    If this is a twocolumn document we start a new page in twocolumn
  1578. %    mode, with the title set to the full width of the text. The
  1579. %    actual printing of the title information is left to
  1580. %    |\@maketitle|.
  1581. % \changes{v1.2k}{1994/05/06}{Added check on number of columns in use
  1582. %    locally}
  1583. %    \begin{macrocode}
  1584.     \if@twocolumn
  1585.       \ifnum \col@number=\@ne
  1586.         \@maketitle
  1587.       \else
  1588.         \twocolumn[\@maketitle]%
  1589.       \fi
  1590.     \else
  1591. %    \end{macrocode}
  1592. %    When this is not a twocolumn document we just start a new page,
  1593. %    prevent floating objects from appearing on the top of this page
  1594. %    and print the title information.
  1595. %    \begin{macrocode}
  1596.       \newpage
  1597.       \global\@topnum\z@   % Prevents figures from going at top of page.
  1598.       \@maketitle
  1599.     \fi
  1600. %    \end{macrocode}
  1601. %    This page gets a \pstyle{plain} layout. We call |\@thanks| to
  1602. %    produce the footnotes.
  1603. %    \begin{macrocode}
  1604.     \thispagestyle{plain}\@thanks
  1605. %    \end{macrocode}
  1606. %    Now we can close the group, reset the \Lcount{footnote} counter,
  1607. %    disable |\thanks|, |\maketitle| and |\@maketitle| and save some
  1608. %    storage space by emptying the internal information macros.
  1609. %    \begin{macrocode}
  1610.   \endgroup
  1611.   \setcounter{footnote}{0}%
  1612.   \let\thanks\relax
  1613.   \let\maketitle\relax\let\@maketitle\relax
  1614.   \gdef\@thanks{}\gdef\@author{}\gdef\@title{}}
  1615. %    \end{macrocode}
  1616. % \end{macro}
  1617. % \begin{macro}{\@maketitle}
  1618. %    This macro takes care of formatting the title information when we
  1619. %    have no separate title page.
  1620. %    We always start a new page, leave some white space and center the
  1621. %    information. The title is set in a |\LARGE| font, the author
  1622. %    names and the in a |\large| font.
  1623. %    \begin{macrocode}
  1624. \def\@maketitle{%
  1625.   \newpage
  1626.   \null
  1627.   \vskip 2em%
  1628.   \begin{center}%
  1629.     {\LARGE \@title \par}%
  1630.     \vskip 1.5em%
  1631.     {\large
  1632.       \lineskip .5em%
  1633.       \begin{tabular}[t]{c}%
  1634.         \@author
  1635.       \end{tabular}\par}%
  1636.     \vskip 1em%
  1637.     {\large \@date}%
  1638.   \end{center}%
  1639.   \par
  1640.   \vskip 1.5em}
  1641. %    \end{macrocode}
  1642. % \end{macro}
  1643. % \subsection{Chapters and Sections}
  1644. % \subsubsection{Building blocks} The definitions in this part of the
  1645. %    class file make use of two internal macros, |\@startsection| and
  1646. %    |\secdef|. To understand
  1647. %    what is going on here, we describe their syntax.
  1648. %    The macro |\@startsection| has 6 required arguments, optionally
  1649. %    followed by  a $*$, an optional argument and a required argument:
  1650. %    |\@startsection|\meta{name}\meta{level}\meta{indent}^^A
  1651. %                    \meta{beforeskip}\meta{afterskip}\meta{style}
  1652. %            optional *\\
  1653. %    \null\hphantom{\bslash @startsection}^^A
  1654. %            |[|\meta{altheading}|]|\meta{heading}
  1655. %    It is a generic command to start a section, the arguments have
  1656. %    the following meaning:
  1657. %    \begin{description}
  1658. %    \item[\meta{name}] The name of the user level command, e.g.,
  1659. %          `section'.
  1660. %    \item[\meta{level}] A number, denoting the depth of the section
  1661. %          -- e.g., chapter=1, section = 2, etc.  A section number
  1662. %          will be printed if and only if \meta{level} $<=$  the value
  1663. %          of the \Lcount{secnumdepth} counter.
  1664. %    \item[\meta{indent}] The indentation of the heading from the left
  1665. %          margin
  1666. %    \item[\meta{beforeskip}] The absolute value of this argument
  1667. %          gives the skip to leave above the heading. If it is
  1668. %          negative, then the paragraph indent of the text following
  1669. %          the heading is suppressed.
  1670. %    \item[\meta{afterskip}] If positive, this gives the skip to leave
  1671. %          below the heading, else it gives the skip to leave to the
  1672. %          right of a run-in heading.
  1673. %    \item[\meta{style}] Commands to set the style of the heading.
  1674. %    \item[$*$] When this is missing the heading is numbered and the
  1675. %          corresponding counter is incremented.
  1676. %    \item[\meta{altheading}] Gives an alternative heading to use in
  1677. %          the table of contents and in the running heads. This should
  1678. %          be present when the $*$ form is used.
  1679. %    \item[\meta{heading}] The heading of the new section.
  1680. %    \end{description}
  1681. %  A sectioning command is normally defined to |\@startsection| and
  1682. %  its first six arguments.
  1683. %    The macro |\secdef| can be used when a sectioning command is
  1684. %    defined without using |\@startsection|. It has two arguments:
  1685. %    |\secdef|\meta{unstarcmds}\meta{starcmds}
  1686. %    \begin{description}
  1687. %    \item[\meta{unstarcmds}] Used for the normal form of the
  1688. %          sectioning command.
  1689. %    \item[\meta{starcmds}] Used for the $*$-form of the
  1690. %          sectioning command.
  1691. %    \end{description}
  1692. %    You can use |\secdef| as follows:
  1693. % \begin{verbatim}
  1694. %       \def\chapter { ... \secdef \CMDA \CMDB }
  1695. %       \def\CMDA    [#1]#2{ ... }  % Command to define
  1696. %                                   % \chapter[...]{...}
  1697. %       \def\CMDB    #1{ ... }      % Command to define
  1698. %                                   % \chapter*{...}
  1699. % \end{verbatim}
  1700. % \subsubsection{Mark commands}
  1701. % \begin{macro}{\chaptermark}
  1702. % \begin{macro}{\sectionmark}
  1703. % \begin{macro}{\subsectionmark}
  1704. % \begin{macro}{\subsubsectionmark}
  1705. % \begin{macro}{\paragraphmark}
  1706. % \begin{macro}{\subparagraphmark}
  1707. %    Default initializations of |\...mark| commands.  These commands
  1708. %    are used in the definition of the page styles (see
  1709. %    section~\ref{sec:pagestyle}) Most of them are already defined by
  1710. %    \file{latex.dtx}, so they are only shown here.
  1711. %    \begin{macrocode}
  1712. %<-article>\newcommand\chaptermark[1]{}
  1713. % \newcommand\sectionmark[1]{}
  1714. % \newcommand\subsectionmark[1]{}
  1715. % \newcommand\subsubsectionmark[1]{}
  1716. % \newcommand\paragraphmark[1]{}
  1717. % \newcommand\subparagraphmark[1]{}
  1718. %    \end{macrocode}
  1719. % \end{macro}
  1720. % \end{macro}
  1721. % \end{macro}
  1722. % \end{macro}
  1723. % \end{macro}
  1724. % \end{macro}
  1725. % \subsubsection{Define Counters}
  1726. % \begin{macro}{\c@secnumdepth}
  1727. %    The value of the counter \Lcount{secnumdepth} gives the depth of
  1728. %    the highest-level sectioning command that is to produce section
  1729. %    numbers.
  1730. %    \begin{macrocode}
  1731. %<+article>\setcounter{secnumdepth}{3}
  1732. %<-article>\setcounter{secnumdepth}{2}
  1733. %    \end{macrocode}
  1734. % \end{macro}
  1735. % \begin{macro}{\c@part}
  1736. % \begin{macro}{\c@chapter}
  1737. % \begin{macro}{\c@section}
  1738. % \begin{macro}{\c@subsection}
  1739. % \begin{macro}{\c@subsubsection}
  1740. % \begin{macro}{\c@paragraph}
  1741. % \begin{macro}{\c@subparagraph}
  1742. %    These counters are used for the section numbers. The macro\\
  1743. %    |\newcounter{|\meta{newctr}|}[|\meta{oldctr}|]|\\
  1744. %     defines\meta{newctr} to be a counter, which is reset to zero when
  1745. %    counter \meta{oldctr} is stepped. Counter \meta{oldctr} must
  1746. %    already be defined.
  1747. %    \begin{macrocode}
  1748. \newcounter {part}
  1749. %<+article>\newcounter {section}
  1750. %<*report|book>
  1751. \newcounter {chapter}
  1752. \newcounter {section}[chapter]
  1753. %</report|book>
  1754. \newcounter {subsection}[section]
  1755. \newcounter {subsubsection}[subsection]
  1756. \newcounter {paragraph}[subsubsection]
  1757. \newcounter {subparagraph}[paragraph]
  1758. %    \end{macrocode}
  1759. % \end{macro}
  1760. % \end{macro}
  1761. % \end{macro}
  1762. % \end{macro}
  1763. % \end{macro}
  1764. % \end{macro}
  1765. % \end{macro}
  1766. % \begin{macro}{\thepart}
  1767. % \begin{macro}{\thechapter}
  1768. % \begin{macro}{\thesection}
  1769. % \begin{macro}{\thesubsection}
  1770. % \begin{macro}{\thesubsubsection}
  1771. % \begin{macro}{\theparagraph}
  1772. % \begin{macro}{\thesubparagraph}
  1773. %    For any counter \Lcount{CTR}, |\theCTR| is a macro that defines
  1774. %    the printed version of counter \Lcount{CTR}.  It is defined in
  1775. %    terms of the following macros:
  1776. %    |\arabic{|\Lcount{COUNTER}|}| prints the value of
  1777. %    \Lcount{COUNTER} as an arabic numeral.
  1778. %    |\roman{|\Lcount{COUNTER}|}| prints the value of
  1779. %    \Lcount{COUNTER} as a lowercase roman numberal.
  1780. %    |\Roman{|\Lcount{COUNTER}|}| prints the value of
  1781. %    \Lcount{COUNTER} as an uppercase roman numberal.
  1782. %    |\alph{|\Lcount{COUNTER}|}| prints the value of \Lcount{COUNTER}
  1783. %    as a lowercase letter: $1 =$~a, $2 =$~ b, etc.
  1784. %    |\Alph{|\Lcount{COUNTER}|}| prints the value of \Lcount{COUNTER}
  1785. %    as an uppercase letter: $1 =$~A, $2 =$~B, etc.
  1786. %    \begin{macrocode}
  1787. \renewcommand\thepart          {\Roman{part}}
  1788. %<+article>\renewcommand\thesection       {\arabic{section}}
  1789. %<*report|book>
  1790. \renewcommand\thechapter       {\arabic{chapter}}
  1791. \renewcommand\thesection       {\thechapter.\arabic{section}}
  1792. %</report|book>
  1793. \renewcommand\thesubsection    {\thesection.\arabic{subsection}}
  1794. \renewcommand\thesubsubsection {\thesubsection .\arabic{subsubsection}}
  1795. \renewcommand\theparagraph     {\thesubsubsection.\arabic{paragraph}}
  1796. \renewcommand\thesubparagraph  {\theparagraph.\arabic{subparagraph}}
  1797. %    \end{macrocode}
  1798. % \end{macro}
  1799. % \end{macro}
  1800. % \end{macro}
  1801. % \end{macro}
  1802. % \end{macro}
  1803. % \end{macro}
  1804. % \end{macro}
  1805. % \begin{macro}{\@chapapp}
  1806. %    |\@chapapp| is initially defined to be `|\chaptername|'. The
  1807. %    |\appendix| command redefines it to be `|\appendixname|'.
  1808. %    \begin{macrocode}
  1809. %<+report|book>\newcommand\@chapapp{\chaptername}
  1810. %    \end{macrocode}
  1811. % \end{macro}
  1812. % \subsubsection{Front Matter, Main Matter, and Back Matter}
  1813. %  A book contains these three sections.
  1814. %  First, we define the switch |\@mainmatter| that is true iff
  1815. %  we are processing Main Matter.  When this switch is false, 
  1816. %  the |\chapter| command does not print chapter numbers.
  1817. %    \begin{macrocode}
  1818. %<*book>
  1819. \newif\if@mainmatter \@mainmattertrue
  1820. %    \end{macrocode}
  1821. %  Next we define the commands that start these sections.
  1822. %  \begin{macro}{\frontmatter}
  1823. %   This command starts Roman page numbering and turns off chapter
  1824. %   numbering.
  1825. %    \begin{macrocode}
  1826. \newcommand\frontmatter{\cleardoublepage
  1827.             \@mainmatterfalse\pagenumbering{roman}}
  1828. %    \end{macrocode}
  1829. %  \end{macro}
  1830. %  \begin{macro}{\mainmatter}
  1831. %   This command clears the page, starts arabic page numbering and 
  1832. %   turns on chapter numbering.
  1833. %    \begin{macrocode}
  1834. \newcommand\mainmatter{\cleardoublepage
  1835.        \@mainmattertrue\pagenumbering{arabic}}
  1836. %    \end{macrocode}
  1837. %  \end{macro}
  1838. %  \begin{macro}{\backmatter}
  1839. %   This clears the page, turns off chapter numbering and leaves page 
  1840. %   numbering unchanged.
  1841. %    \begin{macrocode}
  1842. \newcommand\backmatter{\if@openright\cleardoublepage\else\clearpage\fi
  1843.       \@mainmatterfalse}
  1844. %</book>
  1845. %    \end{macrocode}
  1846. %  \end{macro}
  1847. % \subsubsection{Parts}
  1848. % \begin{macro}{\part}
  1849. %    The command to start a new part of our document.
  1850. %    In the article class the definition of |\part| is rather simple;
  1851. %    we start a new paragraph, add a little white space, suppress the
  1852. %    indentation of the first paragraph and make use of |\secdef|.
  1853. %    \begin{macrocode}
  1854. %<*article>
  1855. \newcommand\part{\par
  1856.    \addvspace{4ex}%
  1857.    \@afterindentfalse
  1858.    \secdef\@part\@spart}
  1859. %</article>
  1860. %    \end{macrocode}
  1861. %    For the report and book classes we things a bit different.
  1862. %    We start a new (righthand) page and use the \pstyle{plain}.
  1863. %    \begin{macrocode}
  1864. %<*report|book>
  1865. \newcommand\part{\cleardoublepage
  1866.                  \thispagestyle{plain}%
  1867. %    \end{macrocode}
  1868. %    When we are making a two column document, this will be a one
  1869. %    column page. We use |@tempswa| to remember to switch back to two
  1870. %    columns.
  1871. %    \begin{macrocode}
  1872.                  \if@twocolumn
  1873.                      \onecolumn
  1874.                      \@tempswatrue
  1875.                    \else
  1876.                      \@tempswafalse
  1877.                  \fi
  1878. %    \end{macrocode}
  1879. %    We need an empty box to prevent the fil glue from disappearing.
  1880. %    \begin{macrocode}
  1881.                  \hbox{}\vfil
  1882. %    \end{macrocode}
  1883. %    Here we use |\secdef| to indicate wwhich commands to use to make
  1884. %    the actual heading.
  1885. %    \begin{macrocode}
  1886.                  \secdef\@part\@spart}
  1887. %</report|book>
  1888. %    \end{macrocode}
  1889. % \begin{macro}{\@part}
  1890. %    This macro does the actual formatting of the title of the part.
  1891. %    Again the macro is differently defined for the article document
  1892. %    class than for the document classes report and book.
  1893. %    When \Lcount{secnumdepth} is larger than $-1$ for the
  1894. %    document class article, we have a numbered
  1895. %    part, otherwise it is unnumbered.
  1896. %    \begin{macrocode}
  1897. %<*article>
  1898. \def\@part[#1]#2{%
  1899.     \ifnum \c@secnumdepth >\m@ne
  1900.       \refstepcounter{part}%
  1901.       \addcontentsline{toc}{part}{\thepart\hspace{1em}#1}%
  1902.     \else
  1903.       \addcontentsline{toc}{part}{#1}%
  1904.     \fi
  1905. %    \end{macrocode}
  1906. %    We  print the title flush left in the article class.
  1907. %    Also we prevent breaking between lines and reset the font.
  1908. %    \begin{macrocode}
  1909.     {\parindent \z@ \raggedright
  1910.      \interlinepenalty \@M
  1911.      \reset@font
  1912. %    \end{macrocode}
  1913. %    When this is a numbered part we have to print the number and the
  1914. %    title. The |\nobreak| should prevent a page break here.
  1915. %    \begin{macrocode}
  1916.      \ifnum \c@secnumdepth >\m@ne
  1917.        \Large\bfseries \partname~\thepart
  1918.        \par\nobreak
  1919.      \fi
  1920.      \huge \bfseries #2%
  1921. %    \end{macrocode}
  1922. %    Now we empty the mark registers, leave some white space and let
  1923. %    |\@afterheading| take care of suppressing the indentation.
  1924. %    \begin{macrocode}
  1925.      \markboth{}{}\par}%
  1926.     \nobreak
  1927.     \vskip 3ex
  1928.     \@afterheading}
  1929. %</article>
  1930. %    \end{macrocode}
  1931. %    When \Lcount{secnumdepth} is larger than $-2$ for the
  1932. %    document class report and book, we have a numbered
  1933. %    part, otherwise it is unnumbered.
  1934. %    \begin{macrocode}
  1935. %<*report|book>
  1936. \def\@part[#1]#2{%
  1937.     \ifnum \c@secnumdepth >-2\relax
  1938.       \refstepcounter{part}%
  1939.       \addcontentsline{toc}{part}{\thepart\hspace{1em}#1}%
  1940.     \else
  1941.       \addcontentsline{toc}{part}{#1}%
  1942.     \fi
  1943. %    \end{macrocode}
  1944. %    We empty the mark registers and center the title on the page in the
  1945. %    report and book document classes.
  1946. %    Also we prevent breaking between lines and reset the font.
  1947. %    \begin{macrocode}
  1948.     \markboth{}{}
  1949.     {\centering
  1950.      \interlinepenalty \@M
  1951.      \reset@font
  1952. %    \end{macrocode}
  1953. %    When this is a numbered part we have to print the number.
  1954. %    \begin{macrocode}
  1955.      \ifnum \c@secnumdepth >-2\relax
  1956.        \huge\bfseries \partname~\thepart
  1957.        \par
  1958. %    \end{macrocode}
  1959. %    We leave some space before we print the title and leave the
  1960. %    finishing up to |\@endpart|.
  1961. %    \begin{macrocode}
  1962.        \vskip 20\p@
  1963.      \fi
  1964.      \Huge \bfseries #2\par}%
  1965.     \@endpart}
  1966. %</report|book>
  1967. %    \end{macrocode}
  1968. % \end{macro}
  1969. % \begin{macro}{\@spart}
  1970. %    This macro does the actual formatting of the title of the part
  1971. %    when the star form of the user command was used. In this case we
  1972. %    {\em never} print a number. Otherwise the formatting is the same.
  1973. %    The differences between the definition of this macro in the
  1974. %    article document class and in the report and book document
  1975. %    classes are similar as they were for |\@part|.
  1976. %    \begin{macrocode}
  1977. %<*article>
  1978. \def\@spart#1{%
  1979.     {\parindent \z@ \raggedright
  1980.      \interlinepenalty \@M
  1981.      \reset@font
  1982.      \huge \bfseries #1\par}%
  1983.      \nobreak
  1984.      \vskip 3ex
  1985.      \@afterheading}
  1986. %</article>
  1987. %<*report|book>
  1988. \def\@spart#1{%
  1989.     {\centering
  1990.      \interlinepenalty \@M
  1991.      \reset@font
  1992.      \Huge \bfseries #1\par}%
  1993.     \@endpart}
  1994. %</report|book>
  1995. %    \end{macrocode}
  1996. % \end{macro}
  1997. % \begin{macro}{\@endpart}
  1998. %    This macro finishes the part page, for both |\@part| and
  1999. %    |\@spart|.
  2000. %    First we fill the current page.
  2001. %    \begin{macrocode}
  2002. \def\@endpart{\vfil\newpage
  2003. %    \end{macrocode}
  2004. %    Then, when we are in twosided mode, we produce a completely blank
  2005. %    page.
  2006. %    \begin{macrocode}
  2007.               \if@twoside
  2008.                 \hbox{}%
  2009.                 \thispagestyle{empty}%
  2010.                 \newpage
  2011.               \fi
  2012. %    \end{macrocode}
  2013. %    When this was a two column document we have to switch back to two
  2014. %    column mode.
  2015. %    \begin{macrocode}
  2016.               \if@tempswa
  2017.                 \twocolumn
  2018.               \fi}
  2019. %    \end{macrocode}
  2020. % \end{macro}
  2021. % \end{macro}
  2022. % \subsubsection{Chapters}
  2023. % \begin{macro}{\chapter}
  2024. %    A chapter should always start on a new page therefore we start by
  2025. %    calling |\clearpage| and setting the pagestyle for this page to
  2026. %    \pstyle{plain}.
  2027. %    \begin{macrocode}
  2028. %<*report|book>
  2029. \newcommand\chapter{\if@openright\cleardoublepage\else\clearpage\fi
  2030.                     \thispagestyle{plain}%
  2031. %    \end{macrocode}
  2032. %    Then we prevent floats from appearing at the top of this page
  2033. %    because it looks weird to see a floating object above a chapter
  2034. %    title.
  2035. %    \begin{macrocode}
  2036.                     \global\@topnum\z@
  2037. %    \end{macrocode}
  2038. %    Then we suppress the indentation of the first paragraph by
  2039. %    setting the switch |\@afterindent| to |false|. We use |\secdef|
  2040. %    to specify the macros to use for actually setting the chapter
  2041. %    title.
  2042. %    \begin{macrocode}
  2043.                     \@afterindentfalse
  2044.                     \secdef\@chapter\@schapter}
  2045. %    \end{macrocode}
  2046. % \begin{macro}{\@chapter}
  2047. %    This macro is called when we have a numbered chapter. When
  2048. %    \Lcount{secnumdepth} is larger than $-1$ and, in the book
  2049. %    class, |\@mainmatter| is true, we display the chapter
  2050. %    number. We also inform the user that a new chapter is about to be
  2051. %    typeset by writing a message to the terminal.
  2052. %    \begin{macrocode}
  2053. \def\@chapter[#1]#2{\ifnum \c@secnumdepth >\m@ne
  2054. %<+book>                       \if@mainmatter
  2055.                          \refstepcounter{chapter}%
  2056.                          \typeout{\@chapapp\space\thechapter.}%
  2057.                          \addcontentsline{toc}{chapter}%
  2058.                                    {\protect\numberline{\thechapter}#1}%
  2059. %<*book>
  2060.                        \else
  2061.                          \addcontentsline{toc}{chapter}{#1}\fi
  2062. %</book>
  2063.                     \else
  2064.                       \addcontentsline{toc}{chapter}{#1}
  2065.                     \fi
  2066. %    \end{macrocode}
  2067. %    After having written an entry to the table of contents we store
  2068. %    the (alternative) title of this chapter with |\chaptermark| and
  2069. %    add some white space to the lists of figures and tables.
  2070. %    \begin{macrocode}
  2071.                     \chaptermark{#1}%
  2072.                     \addtocontents{lof}{\protect\addvspace{10\p@}}%
  2073.                     \addtocontents{lot}{\protect\addvspace{10\p@}}%
  2074. %    \end{macrocode}
  2075. %    Then we call upon |\@makechapterhead| to format the actual
  2076. %    chapter title. We have to do this in a special way when we are in
  2077. %    twocolumn mode in order to have the chapter title use the entire
  2078. %    |\textwidth|. In one column mode we call |\@afterheading| which
  2079. %    takes care of suppressing the indentation.
  2080. %    \begin{macrocode}
  2081.                     \if@twocolumn
  2082.                       \@topnewpage[\@makechapterhead{#2}]%
  2083.                     \else
  2084.                       \@makechapterhead{#2}%
  2085.                       \@afterheading
  2086.                     \fi}
  2087. %    \end{macrocode}
  2088. % \begin{macro}{\@makechapterhead}
  2089. %    The macro above uses |\@makechapterhead|\meta{text} to format the
  2090. %    heading of the chapter.
  2091. %    We begin by leaving some white space. The we open a group in
  2092. %    which we have a paragraph indent of 0pt, and in which we have the
  2093. %    text set ragged right. We also reset the font.
  2094. %    \begin{macrocode}
  2095. \def\@makechapterhead#1{%
  2096.   \vspace*{50\p@}%
  2097.   {\parindent \z@ \raggedright \reset@font
  2098. %    \end{macrocode}
  2099. %    Then we check whether the number of the chapter has to be printed.
  2100. %    If so we leave some whitespace between the chapternumber and its
  2101. %    title.
  2102. %    \begin{macrocode}
  2103.     \ifnum \c@secnumdepth >\m@ne
  2104. %<+book>       \if@mainmatter
  2105.          \huge\bfseries \@chapapp{} \thechapter
  2106.          \par
  2107.          \vskip 20\p@
  2108. %<+book>       \fi
  2109.        \fi
  2110. %    \end{macrocode}
  2111. %    Now we set the title in a large bold font. We prevent a pagebreak
  2112. %    at this point and leave some whitespace before the text begins.
  2113. %    \begin{macrocode}
  2114.     \Huge \bfseries #1\par
  2115.     \nobreak
  2116.     \vskip 40\p@
  2117. %    \end{macrocode}
  2118. % \end{macro}
  2119. % \end{macro}
  2120. % \begin{macro}{\@schapter}
  2121. %    This macro is called when we have an unnumbered chapter. It is
  2122. %    much simpler than |\@chapter| because it only needs to typeset
  2123. %    the chapter title.
  2124. %    \begin{macrocode}
  2125. \def\@schapter#1{\if@twocolumn
  2126.                    \@topnewpage[\@makeschapterhead{#1}]%
  2127.                  \else
  2128.                    \@makeschapterhead{#1}%
  2129.                    \@afterheading
  2130.                  \fi}
  2131. %    \end{macrocode}
  2132. % \begin{macro}{\@makeschapterhead}
  2133. %    The macro above uses |\@makeschapterhead|\meta{text}to format
  2134. %    the heading of the chapter. It is similar to |\@makechapterhead|
  2135. %    except that it never has to print a chapter number.
  2136. %    \begin{macrocode}
  2137. \def\@makeschapterhead#1{%
  2138.   \vspace*{50\p@}%
  2139.   {\parindent \z@ \raggedright
  2140.     \reset@font
  2141.     \Huge \bfseries  #1\par
  2142.     \nobreak
  2143.     \vskip 40\p@
  2144. %</report|book>
  2145. %    \end{macrocode}
  2146. % \end{macro}
  2147. % \end{macro}
  2148. % \end{macro}
  2149. % \subsubsection{Lower level headings}
  2150. %    These commands all make use of |\@startsection|.
  2151. % \begin{macro}{\section}
  2152. %    This gives a normal heading with white space above and below the
  2153. %    heading, the title set in |\Large\bfseries|, and no indentation
  2154. %    on the first paragraph.
  2155. %    \begin{macrocode}
  2156. \newcommand\section{\@startsection {section}{1}{\z@}%
  2157.                                    {-3.5ex \@plus -1ex \@minus -.2ex}%
  2158.                                    {2.3ex \@plus.2ex}%
  2159.                                    {\reset@font\Large\bfseries}}
  2160. %    \end{macrocode}
  2161. % \end{macro}
  2162. % \begin{macro}{\subsection}
  2163. %    This gives a normal heading with white space above and below the
  2164. %    heading, the title set in |\large\bfseries|, and no indentation
  2165. %    on the first paragraph.
  2166. %    \begin{macrocode}
  2167. \newcommand\subsection{\@startsection{subsection}{2}{\z@}%
  2168.                                      {-3.25ex\@plus -1ex \@minus -.2ex}%
  2169.                                      {1.5ex \@plus .2ex}%
  2170.                                      {\reset@font\large\bfseries}}
  2171. %    \end{macrocode}
  2172. % \end{macro}
  2173. % \begin{macro}{\subsubsection}
  2174. %    This gives a normal heading with white space above and below the
  2175. %    heading, the title set in |\normalsize\bfseries|, and no
  2176. %    indentation on the first paragraph.
  2177. %    \begin{macrocode}
  2178. \newcommand\subsubsection{\@startsection{subsubsection}{3}{\z@}%
  2179.                                      {-3.25ex\@plus -1ex \@minus -.2ex}%
  2180.                                      {1.5ex \@plus .2ex}%
  2181.                                      {\reset@font\normalsize\bfseries}}
  2182. %    \end{macrocode}
  2183. % \end{macro}
  2184. % \begin{macro}{\paragraph}
  2185. %    This gives a run-in heading with white space above and to the
  2186. %    right of the heading, the title set in |\normalsize\bfseries|.
  2187. %    \begin{macrocode}
  2188. \newcommand\paragraph{\@startsection{paragraph}{4}{\z@}%
  2189.                                     {3.25ex \@plus1ex \@minus.2ex}%
  2190.                                     {-1em}%
  2191.                                     {\reset@font\normalsize\bfseries}}
  2192. %    \end{macrocode}
  2193. % \end{macro}
  2194. % \begin{macro}{\subparagraph}
  2195. %    This gives an indented run-in heading with white space above and
  2196. %    to the right of the heading, the title set in
  2197. %    |\normalsize\bfseries|.
  2198. %    \begin{macrocode}
  2199. \newcommand\subparagraph{\@startsection{subparagraph}{5}{\parindent}%
  2200.                                        {3.25ex \@plus1ex \@minus .2ex}%
  2201.                                        {-1em}%
  2202.                                       {\reset@font\normalsize\bfseries}}
  2203. %    \end{macrocode}
  2204. % \end{macro}
  2205. % \subsection{Lists}
  2206. % \subsubsection{General List Parameters}
  2207. % The following commands are used to set the default values for the list
  2208. % environment's parameters. See the \LaTeX{} manual for an explanation
  2209. % of the meanings of the parameters.  Defaults for the list
  2210. % environment are set as follows.  First, |\rightmargin|,
  2211. % |\listparindent| and |\itemindent| are set to 0pt.  Then, for a Kth
  2212. % level list, the command |\@listK| is called, where `K' denotes `i',
  2213. % '`i', ... , `vi'.  (I.e., |\@listiii| is called for a third-level
  2214. % list.)  By convention, |\@listK| should set |\leftmargin| to
  2215. % |\leftmarginK|.
  2216. % \begin{macro}{\leftmargin}
  2217. % \begin{macro}{\leftmargini}
  2218. % \begin{macro}{\leftmarginii}
  2219. % \begin{macro}{\leftmarginiii}
  2220. % \begin{macro}{\leftmarginiv}
  2221. % \begin{macro}{\leftmarginv}
  2222. % \begin{macro}{\leftmarginvi}
  2223. % \changes{v1.0m}{1994/01//12}{use em instead of pt to remain
  2224. %                             compatible with old styles}
  2225. % For efficiency, level-one list's values are defined at top level, and
  2226. % |\@listi| is defined to set only |\leftmargin|.
  2227. % When we are in two column mode some of the margins are set somewhat
  2228. % smaller.
  2229. %    \begin{macrocode}
  2230. \if@twocolumn
  2231.   \setlength\leftmargini  {2em}
  2232. \else
  2233.   \setlength\leftmargini  {2.5em}
  2234. %    \end{macrocode}
  2235. %    The following three are calculated so  that they are larger than
  2236. %    the sum of |\labelsep| and the width of the default labels (which
  2237. %    are `(m)', `vii.' and `M.').
  2238. %    \begin{macrocode}
  2239. \setlength\leftmarginii  {2.2em}
  2240. \setlength\leftmarginiii {1.87em}
  2241. \setlength\leftmarginiv  {1.7em}
  2242. \if@twocolumn
  2243.   \setlength\leftmarginv  {.5em}
  2244.   \setlength\leftmarginvi {.5em}
  2245. \else
  2246.   \setlength\leftmarginv  {1em}
  2247.   \setlength\leftmarginvi {1em}
  2248. %    \end{macrocode}
  2249. %    Here we set the top level leftmargin.
  2250. %    \begin{macrocode}
  2251. \setlength\leftmargin    {\leftmargini}
  2252. %    \end{macrocode}
  2253. % \end{macro}
  2254. % \end{macro}
  2255. % \end{macro}
  2256. % \end{macro}
  2257. % \end{macro}
  2258. % \end{macro}
  2259. % \end{macro}
  2260. % \begin{macro}{\labelsep}
  2261. % \begin{macro}{\labelwidth}
  2262. % \changes{v1.0m}{1994/01//12}{use em instead of pt to remain
  2263. %                             compatible with old styles}
  2264. %    |\labelsep| is the distance between the label and the text of an
  2265. %    item; |\labelwidth| is the width of the label.
  2266. %    \begin{macrocode}
  2267. \setlength  \labelsep  {.5em}
  2268. \setlength  \labelwidth{\leftmargini}
  2269. \addtolength\labelwidth{-\labelsep}
  2270. %    \end{macrocode}
  2271. % \end{macro}
  2272. % \end{macro}
  2273. % \begin{macro}{\partopsep}
  2274. %    When the user leaves a blank line before the environment an extra
  2275. %    vertical space of |\partopsep| is inserted, in addition to
  2276. %    |\parskip| and |\topsep|.
  2277. % \changes{v1.0m}{1994/01//12}{\cmd\partopsep should be different,
  2278. %                             depending on the pointsize}
  2279. %    \begin{macrocode}
  2280. %    \begin{macrocode}
  2281. %</article|report|book>
  2282. %<+10pt>\setlength\partopsep{2\p@ \@plus 1\p@ \@minus 1\p@}
  2283. %<+11pt>\setlength\partopsep{3\p@ \@plus 1\p@ \@minus 1\p@}
  2284. %<+12pt>\setlength\partopsep{3\p@ \@plus 2\p@ \@minus 2\p@}
  2285. %    \end{macrocode}
  2286. % \end{macro}
  2287. % \begin{macro}{\@beginparpenalty}
  2288. % \begin{macro}{\@endparpenalty}
  2289. %    These penalties are inserted before and after a list or paragraph
  2290. %    environment. They are set to a bonus value to encourage page
  2291. %    breaking at these points.
  2292. % \begin{macro}{\@itempenalty}
  2293. %    This penalty is inserted between list items.
  2294. %    \begin{macrocode}
  2295. %<*article|report|book>
  2296. \@beginparpenalty -\@lowpenalty
  2297. \@endparpenalty   -\@lowpenalty
  2298. \@itempenalty     -\@lowpenalty
  2299. %</article|report|book>
  2300. %    \end{macrocode}
  2301. % \end{macro}
  2302. % \end{macro}
  2303. % \end{macro}
  2304. % \begin{macro}{\@listI}
  2305. % \begin{macro}{\@listi}
  2306. % |\@listI| defines top level and |\@listi| values of
  2307. % |\leftmargin|, |\parsep|, |\topsep|, and |\itemsep|
  2308. %    \begin{macrocode}
  2309. %<*10pt|11pt|12pt>
  2310. \def\@listI{\leftmargin\leftmargini
  2311. %<*10pt>    
  2312.             \parsep 4\p@ \@plus2\p@ \@minus\p@
  2313.             \topsep 8\p@ \@plus2\p@ \@minus4\p@
  2314.             \itemsep4\p@ \@plus2\p@ \@minus\p@}
  2315. %</10pt>            
  2316. %<*11pt>            
  2317.             \parsep 4.5\p@ \@plus2\p@ \@minus\p@
  2318.             \topsep 9\p@   \@plus3\p@ \@minus5\p@
  2319.             \itemsep4.5\p@ \@plus2\p@ \@minus\p@}
  2320. %</11pt>            
  2321. %<*12pt>            
  2322.             \parsep 5\p@  \@plus2.5\p@ \@minus\p@
  2323.             \topsep 10\p@ \@plus4\p@   \@minus6\p@
  2324.             \itemsep5\p@  \@plus2.5\p@ \@minus\p@}
  2325. %</12pt>
  2326. \let\@listi\@listI
  2327. %    \end{macrocode}
  2328. %    We have to initialise these parameters.
  2329. %    \begin{macrocode}
  2330. \@listi
  2331. %    \end{macrocode}
  2332. % \end{macro}
  2333. % \end{macro}
  2334. % \begin{macro}{\@listii}
  2335. % \begin{macro}{\@listiii}
  2336. % \begin{macro}{\@listiv}
  2337. % \begin{macro}{\@listv}
  2338. % \begin{macro}{\@listvi}
  2339. %    Here are the same macros for the higher level lists.
  2340. %    \begin{macrocode}
  2341. \def\@listii {\leftmargin\leftmarginii
  2342.               \labelwidth\leftmarginii
  2343.               \advance\labelwidth-\labelsep
  2344. %<*10pt>
  2345.               \topsep    4\p@ \@plus2\p@ \@minus\p@
  2346.               \parsep    2\p@ \@plus\p@  \@minus\p@
  2347. %</10pt>                 
  2348. %<*11pt>                 
  2349.               \topsep    4.5\p@ \@plus2\p@ \@minus\p@
  2350.               \parsep    2\p@   \@plus\p@  \@minus\p@
  2351. %</11pt>                 
  2352. %<*12pt>                 
  2353.               \topsep    5\p@   \@plus2.5\p@ \@minus\p@
  2354.               \parsep    2.5\p@ \@plus\p@    \@minus\p@
  2355. %</12pt>                 
  2356.               \itemsep   \parsep}
  2357. \def\@listiii{\leftmargin\leftmarginiii
  2358.               \labelwidth\leftmarginiii
  2359.               \advance\labelwidth-\labelsep
  2360. %<+10pt>              \topsep    2\p@ \@plus\p@\@minus\p@
  2361. %<+11pt>              \topsep    2\p@ \@plus\p@\@minus\p@
  2362. %<+12pt>              \topsep    2.5\p@\@plus\p@\@minus\p@
  2363.               \parsep    \z@
  2364.               \partopsep \p@ \@plus\z@ \@minus\p@
  2365.               \itemsep   \topsep}
  2366. \def\@listiv {\leftmargin\leftmarginiv
  2367.               \labelwidth\leftmarginiv
  2368.               \advance\labelwidth-\labelsep}
  2369. \def\@listv  {\leftmargin\leftmarginv
  2370.               \labelwidth\leftmarginv
  2371.               \advance\labelwidth-\labelsep}
  2372. \def\@listvi {\leftmargin\leftmarginvi
  2373.               \labelwidth\leftmarginvi
  2374.               \advance\labelwidth-\labelsep}
  2375. %</10pt|11pt|12pt>
  2376. %    \end{macrocode}
  2377. % \end{macro}
  2378. % \end{macro}
  2379. % \end{macro}
  2380. % \end{macro}
  2381. % \end{macro}
  2382. % \subsubsection{Enumerate}
  2383. %    The enumerate environment uses  four counters: \Lcount{enumi},
  2384. %    \Lcount{enumii}, \Lcount{enumiii} and \Lcount{enumiv}, where
  2385. %    \Lcount{enumN} controls the numbering of the Nth level
  2386. %    enumeration.
  2387. % \begin{macro}{\theenumi}
  2388. % \begin{macro}{\theenumii}
  2389. % \begin{macro}{\theenumiii}
  2390. % \begin{macro}{\theenumiv}
  2391. %    The counters are already defined in \file{latex.dtx}, but their
  2392. %    representation is changed here.
  2393. %    \begin{macrocode}
  2394. %<*article|report|book>
  2395. \renewcommand\theenumi{\arabic{enumi}}
  2396. \renewcommand\theenumii{\alph{enumii}}
  2397. \renewcommand\theenumiii{\roman{enumiii}}
  2398. \renewcommand\theenumiv{\Alph{enumiv}}
  2399. %    \end{macrocode}
  2400. % \end{macro}
  2401. % \end{macro}
  2402. % \end{macro}
  2403. % \end{macro}
  2404. % \begin{macro}{\labelenumi}
  2405. % \begin{macro}{\labelenumii}
  2406. % \begin{macro}{\labelenumiii}
  2407. % \begin{macro}{\labelenumiv}
  2408. %    The label for each item is generated by the commands\\
  2409. %    |\labelenumi| \ldots\ |\labelenumiv|.
  2410. %    \begin{macrocode}
  2411. \newcommand\labelenumi{\theenumi.}
  2412. \newcommand\labelenumii{(\theenumii)}
  2413. \newcommand\labelenumiii{\theenumiii.}
  2414. \newcommand\labelenumiv{\theenumiv.}
  2415. %    \end{macrocode}
  2416. % \end{macro}
  2417. % \end{macro}
  2418. % \end{macro}
  2419. % \end{macro}
  2420. % \begin{macro}{\p@enumii}
  2421. % \begin{macro}{\p@enumiii}
  2422. % \begin{macro}{\p@enumiv}
  2423. %    The expansion of |\p@enumN||\theenumN| defines the output of a
  2424. %    |\ref| command when referencing an item of the Nth level of an
  2425. %    enumerated list.
  2426. %    \begin{macrocode}
  2427. \renewcommand\p@enumii{\theenumi}
  2428. \renewcommand\p@enumiii{\theenumi(\theenumii)}
  2429. \renewcommand\p@enumiv{\p@enumiii\theenumiii}
  2430. %    \end{macrocode}
  2431. % \end{macro}
  2432. % \end{macro}
  2433. % \end{macro}
  2434. % \subsubsection{Itemize}
  2435. % \begin{macro}{\labelitemi}
  2436. % \begin{macro}{\labelitemii}
  2437. % \changes{v1.2k}{1994/05/06}{Inserted \cmd\normalfont}
  2438. % \begin{macro}{\labelitemiii}
  2439. % \begin{macro}{\labelitemiv}
  2440. %    Itemization is controlled by four commands: |\labelitemi|,
  2441. %    |\labelitemii|, |\labelitemiii|, and |\labelitemiv|, which define
  2442. %    the labels of thevarious itemization levels: the symbols used are
  2443. %    bullet, bold en-dash, asterisk and centred dot.
  2444. %    \begin{macrocode}
  2445. \newcommand\labelitemi{$\m@th\bullet$}
  2446. \newcommand\labelitemii{\normalfont\bfseries --}
  2447. \newcommand\labelitemiii{$\m@th\ast$}
  2448. \newcommand\labelitemiv{$\m@th\cdot$}
  2449. %    \end{macrocode}
  2450. % \end{macro}
  2451. % \end{macro}
  2452. % \end{macro}
  2453. % \end{macro}
  2454. % \subsubsection{Description}
  2455. % \begin{environment}{description}
  2456. %    The description environment is defined here -- while the itemize
  2457. %    and enumerate environments are defined in \file{latex.dtx}.
  2458. %    \begin{macrocode}
  2459. \newenvironment{description}
  2460.                {\list{}{\labelwidth\z@ \itemindent-\leftmargin
  2461.                         \let\makelabel\descriptionlabel}}
  2462.                {\endlist}
  2463. %    \end{macrocode}
  2464. % \end{environment}
  2465. % \begin{macro}{\descriptionlabel}
  2466. %    To change the formatting of the label, you must redefine
  2467. %    |\descriptionlabel|.
  2468. % \changes{v1.2k}{1994/05/06}{Inserted \cmd\normalfont}
  2469. %    \begin{macrocode}
  2470. \newcommand\descriptionlabel[1]{\hspace\labelsep
  2471.                                 \normalfont\bfseries #1}
  2472. %    \end{macrocode}
  2473. % \end{macro}
  2474. % \subsection{Defining new environments}
  2475. % \subsubsection{Abstract}
  2476. % \begin{environment}{abstract}
  2477. %    When we are producing a separate titlepage we also put the
  2478. %    abstract on a page of its own. It will be centred vertically on
  2479. %    the page.
  2480. %    Note that this environment is not defined for books.
  2481. %    \begin{macrocode}
  2482. %<*article|report>
  2483. \if@titlepage
  2484.   \newenvironment{abstract}{%
  2485.       \titlepage
  2486.       \null\vfil
  2487.       \begin{center}
  2488.         \bfseries \abstractname
  2489.       \end{center}}
  2490.      {\par\vfil\null\endtitlepage}
  2491. %    \end{macrocode}
  2492. %    When we are not making a separate titlepage --the default for the
  2493. %    article document class-- we have to check if we are in twocolumn
  2494. %    mode. In that case the abstract is as a |\section*|, otherwise
  2495. %    the quotation environment is used to typeset the abstract.
  2496. %    \begin{macrocode}
  2497. \else
  2498.   \newenvironment{abstract}{%
  2499.       \if@twocolumn
  2500.         \section*{\abstractname}%
  2501.       \else
  2502.         \small
  2503.         \begin{center}%
  2504.           {\bfseries \abstractname\vspace{-.5em}\vspace{\z@}}%
  2505.         \end{center}%
  2506.         \quotation
  2507.       \fi}
  2508.       {\if@twocolumn\else\endquotation\fi}
  2509. %</article|report>
  2510. %    \end{macrocode}
  2511. % \end{environment}
  2512. % \subsubsection{Verse}
  2513. % \begin{environment}{verse}
  2514. %   The verse environment is defined by making clever use of the
  2515. %   list environment's parameters.  The user types |\\| to end a line.
  2516. %   This is implemented by |\let|'ing |\\| equal |\@centercr|.
  2517. %    \begin{macrocode}
  2518. \newenvironment{verse}
  2519.                {\let\\=\@centercr
  2520.                 \list{}{\itemsep      \z@
  2521.                         \itemindent   -1.5em%
  2522.                         \listparindent\itemindent
  2523.                         \rightmargin  \leftmargin
  2524.                         \advance\leftmargin 1.5em}%
  2525.                 \item[]}
  2526.                {\endlist}
  2527. %    \end{macrocode}
  2528. % \end{environment}
  2529. % \subsubsection{Quotation}
  2530. % \begin{environment}{quotation}
  2531. %   The quotation environment is also defined by making clever use of
  2532. %   the list environment's parameters. The lines in the environment
  2533. %   are set smaller than |\textwidth|. The first line of a paragraph
  2534. %   inside this environment is indented.
  2535. %    \begin{macrocode}
  2536. \newenvironment{quotation}
  2537.                {\list{}{\listparindent 1.5em%
  2538.                         \itemindent    \listparindent
  2539.                         \rightmargin   \leftmargin
  2540.                         \parsep        \z@ \@plus\p@}%
  2541.                 \item[]}
  2542.                {\endlist}
  2543. %    \end{macrocode}
  2544. % \end{environment}
  2545. % \subsubsection{Quote}
  2546. % \begin{environment}{quote}
  2547. %   The quote environment is like the quotation environment except
  2548. %   that paragraphs are not indented.
  2549. %    \begin{macrocode}
  2550. \newenvironment{quote}
  2551.                {\list{}{\rightmargin\leftmargin}%
  2552.                 \item[]}
  2553.                {\endlist}
  2554. %    \end{macrocode}
  2555. % \end{environment}
  2556. % \subsubsection{Theorem}
  2557. %    This document class does not define it's own theorem environments,
  2558. %    the defaults, supplied by \file{latex.dtx} are available.
  2559. % \subsubsection{Titlepage}
  2560. % \begin{environment}{titlepage}
  2561. %  In the normal environments, the titlepage environment does nothing
  2562. %  but start and end a page, and inhibit page numbers.  In the report
  2563. %  style, it also resets the page number to one, and then sets it
  2564. %  back to one at the end.  In compatibility mode, it sets the
  2565. %  page number to zero. In two-column style, it still makes a 
  2566. %  one-column page.
  2567. % \changes{v1.0g}{1993/12/09}{Moved the setting of
  2568. %                             \cmd\@restonecolfalse}
  2569. % \changes{v1.2c}{1994/03/17}{page := 0 only in compatibility mode (LL)}
  2570. % \changes{v1.2d}{1994/04/11}{Moved \cmd\cleardoublepage inside
  2571. %    definition of titlepage environment}
  2572. %    \begin{macrocode}
  2573. \newenvironment{titlepage}
  2574.     {%
  2575. %<+book>      \cleardoublepage
  2576.       \if@twocolumn
  2577.         \@restonecoltrue\onecolumn
  2578.       \else
  2579.         \@restonecolfalse\newpage
  2580.       \fi
  2581.       \thispagestyle{empty}%
  2582.       \if@compatibility
  2583.         \setcounter{page}{0}
  2584. %<*report|article>
  2585.       \else
  2586.         \setcounter{page}{1}%
  2587. %</report|article>
  2588.       \fi}%
  2589.     {\if@restonecol\twocolumn \else \newpage \fi
  2590. %<+report|article>      \setcounter{page}{1}%
  2591.     }
  2592. %    \end{macrocode}
  2593. % \end{environment}
  2594. % \subsubsection{Appendix}
  2595. % \begin{macro}{\appendix}
  2596. %    The |\appendix| command is not really an environment, it is a
  2597. %    macro that makes some changes in the way things are done.
  2598. %    In the article document class the |\appendix| command must do the
  2599. %    following:
  2600. %    \begin{itemize}
  2601. %    \item reset the section and subsection counters to zero,
  2602. %    \item redefine |\thesection| to produce alphabetic appendix
  2603. %        numbers.
  2604. %    \end{itemize}
  2605. %    \begin{macrocode}
  2606. %<*article>
  2607. \newcommand\appendix{\par
  2608.   \setcounter{section}{0}%
  2609.   \setcounter{subsection}{0}%
  2610.   \renewcommand\thesection{\Alph{section}}}
  2611. %</article>
  2612. %    \end{macrocode}
  2613. %    In the report and book document classes the |\appendix| command
  2614. %    must do the following:
  2615. %    \begin{itemize}
  2616. %    \item reset the chapter and section counters to zero,
  2617. %    \item set |\@chapapp| to |\appendixname| (for messages),
  2618. %    \item redefine the chapter counter to produce appendix numbers,
  2619. %    \item possibly redefine the |\chapter| command if appendix titles
  2620. %        and headings are to look different from chapter titles and
  2621. %        headings.
  2622. %    \end{itemize}
  2623. %    \begin{macrocode}
  2624. %<*report|book>
  2625. \newcommand\appendix{\par
  2626.   \setcounter{chapter}{0}%
  2627.   \setcounter{section}{0}%
  2628.   \renewcommand\@chapapp{\appendixname}%
  2629.   \renewcommand\thechapter{\Alph{chapter}}}
  2630. %</report|book>
  2631. %    \end{macrocode}
  2632. % \end{macro}
  2633. % \subsection{Setting parameters for existing environments}
  2634. % \subsubsection{Array and tabular}
  2635. % \begin{macro}{\arraycolsep}
  2636. %    The columns in an array environment are separated by
  2637. %    2|\arraycolsep|.
  2638. %    \begin{macrocode}
  2639. \setlength\arraycolsep{5\p@}
  2640. %    \end{macrocode}
  2641. % \end{macro}
  2642. % \begin{macro}{\tabcolsep}
  2643. %    The columns in an tabular environment are separated by
  2644. %    2|\tabcolsep|.
  2645. %    \begin{macrocode}
  2646. \setlength\tabcolsep{6\p@}
  2647. %    \end{macrocode}
  2648. % \end{macro}
  2649. % \begin{macro}{\arrayrulewidth}
  2650. %    The width of rules in the array and tabular environments is given
  2651. %    by\\ |\arrayrulewidth|.
  2652. %    \begin{macrocode}
  2653. \setlength\arrayrulewidth{.4\p@}
  2654. %    \end{macrocode}
  2655. % \end{macro}
  2656. % \begin{macro}{\doublerulesep}
  2657. %    The space between adjacent rules in the array and tabular
  2658. %    environments is given by |\doublerulesep|.
  2659. %    \begin{macrocode}
  2660. \setlength\doublerulesep{2\p@}
  2661. %    \end{macrocode}
  2662. % \end{macro}
  2663. % \subsubsection{Tabbing}
  2664. % \begin{macro}{\tabbingsep}
  2665. %    This controls the space that the |\'| command puts in. (See
  2666. %    \LaTeX{} manual for an explanation.)
  2667. %    \begin{macrocode}
  2668. \setlength\tabbingsep{\labelsep}
  2669. %    \end{macrocode}
  2670. % \end{macro}
  2671. % \subsubsection{Minipage}
  2672. % \begin{macro}{\@minipagerestore}
  2673. %    The macro |\@minipagerestore| is called upon entry to a minipage
  2674. %    environment to set up things that are to be handled differently
  2675. %    inside a minipage environment. In the current styles, it does
  2676. %    nothing.
  2677. % \end{macro}
  2678. % \begin{macro}{\@mpfootins}
  2679. %    Minipages have their own footnotes; |\skip||\@mpfootins| plays
  2680. %    same r\^ole for footnotes in a minipage as |\skip||\footins| does
  2681. %    for ordinary footnotes.
  2682. %    \begin{macrocode}
  2683. \skip\@mpfootins = \skip\footins
  2684. %    \end{macrocode}
  2685. % \end{macro}
  2686. % \subsubsection{Framed boxes}
  2687. % \begin{macro}{\fboxsep}
  2688. %    The space left by |\fbox| and |\framebox| between the box and the
  2689. %    text in it.
  2690. % \begin{macro}{\fboxrule}
  2691. %    The width of the rules in the box made by |\fbox| and |\framebox|.
  2692. %    \begin{macrocode}
  2693. \setlength\fboxsep{3\p@}
  2694. \setlength\fboxrule{.4\p@}
  2695. %    \end{macrocode}
  2696. % \end{macro}
  2697. % \end{macro}
  2698. % \subsubsection{Equation and eqnarray}
  2699. % \begin{macro}{\theequation}
  2700. %    The equation counter will be reset at beginning of a new chapter
  2701. %    and the equation number will be prefixed by the chapter number.
  2702. %    This code  must follow the |\chapter| definition, or more exactly
  2703. %    the definition of the chapter counter.
  2704. %    \begin{macrocode}
  2705. %<+article>\renewcommand\theequation{\arabic{equation}}
  2706. %<*report|book>
  2707. \@addtoreset{equation}{chapter}
  2708. \renewcommand\theequation{\thechapter.\arabic{equation}}
  2709. %</report|book>
  2710. %    \end{macrocode}
  2711. % \end{macro}
  2712. % \begin{macro}{\jot}
  2713. %    |\jot| is the extra space added between lines of an eqnarray
  2714. %    environment. The default value is used.
  2715. %    \begin{macrocode}
  2716. % \setlength\jot{3pt}
  2717. %    \end{macrocode}
  2718. % \end{macro}
  2719. % \begin{macro}{\@eqnnum}
  2720. %    The macro |\@eqnnum| defines how equation numbers are to appear in
  2721. %    equations. Again the default is used.
  2722. %    \begin{macrocode}
  2723. % \def\@eqnnum{(\theequation)}
  2724. %    \end{macrocode}
  2725. % \end{macro}
  2726. % \subsection{Floating objects}
  2727. %    The file \file{latex.dtx} only defines a number of tools with
  2728. %    which floating objects can be defined. This is done in the
  2729. %    document class. It needs to define the following macros for each
  2730. %    floating object of type \texttt{TYPE} (e.g., \texttt{TYPE} =
  2731. %    figure).
  2732. %    \begin{description}
  2733. %    \item[\texttt{\bslash fps@TYPE}]
  2734. %        The default placement specifier for floats of type
  2735. %        \texttt{TYPE}.
  2736. %    \item[\texttt{\bslash ftype@TYPE}]
  2737. %        The type number for floats of type \texttt{TYPE}.  Each
  2738. %        \texttt{TYPE} has associated a unique positive {\texttt
  2739. %        TYPE} number, which is a power of two.  E.g., figures might
  2740. %        have type number 1, tables type number 2, programs type
  2741. %        number 4, etc.
  2742. %    \item[\texttt{\bslash ext@TYPE}]
  2743. %        The file extension indicating the file on which the contents
  2744. %        list for float type \texttt{TYPE} is stored.  For example,
  2745. %        |\ext@figure| = `lof'.
  2746. %    \item[\texttt{\bslash fnum@TYPE}]
  2747. %        A macro to generate the figure number for a caption. For
  2748. %        example, |\fnum@TYPE| == `Figure |\thefigure|'.
  2749. %    \item[\texttt{\bslash @makecaption{\meta{num}}{\meta{text}}}]
  2750. %        A macro to make a caption, with \meta{num} the value produced
  2751. %        by |\fnum@...| and \meta{text} the text of the caption. It
  2752. %        can assume it's in a |\parbox| of the appropriate width.
  2753. %        This will be used for {\em all} floating objects.
  2754. %    \end{description}
  2755. %    The actual environment that implements a floating object such as
  2756. %    a figure is defined using the macros |\@float| and |\end@float|,
  2757. %    which are defined in \file{latex.dtx}.
  2758. %    An environment that implements a single column floating object is
  2759. %    started with |\@float{|\texttt{TYPE}|}[|\meta{placement}|]| of type
  2760. %    \texttt{TYPE} with \meta{placement} as the placement specifier.
  2761. %    The default value of \meta{PLACEMENT} is defined by |\fps@TYPE|.
  2762. %    The environment is ended by |\end@float|.  E.g., |\figure| ==
  2763. %    |\@float|{figure}, |\endfigure| == |\end@float|.
  2764. % \subsubsection{Figure}
  2765. %    Here is the implementation of the figure environment.
  2766. % \begin{macro}{\c@figure}
  2767. %    First we have to allocate a counter to number the figures. In the
  2768. %    report and book document classes the figures are numbered per
  2769. %    chapter.
  2770. %    \begin{macrocode}
  2771. %<*article>
  2772. \newcounter{figure}
  2773. \renewcommand\thefigure{\@arabic\c@figure}
  2774. %</article>
  2775. %<*report|book>
  2776. \newcounter{figure}[chapter]
  2777. \renewcommand\thefigure{\thechapter.\@arabic\c@figure}
  2778. %</report|book>
  2779. %    \end{macrocode}
  2780. % \end{macro}
  2781. % \begin{macro}{\fps@figure}
  2782. % \begin{macro}{\ftype@figure}
  2783. % \begin{macro}{\ext@figure}
  2784. % \begin{macro}{\num@figure}
  2785. %    Here are the parameters for the floating objects of type `figure'.
  2786. %    \begin{macrocode}
  2787. \def\fps@figure{tbp}
  2788. \def\ftype@figure{1}
  2789. \def\ext@figure{lof}
  2790. \def\fnum@figure{\figurename~\thefigure}
  2791. %    \end{macrocode}
  2792. % \end{macro}
  2793. % \end{macro}
  2794. % \end{macro}
  2795. % \end{macro}
  2796. % \begin{environment}{figure}
  2797. % \begin{environment}{figure*}
  2798. %    And the definition of the actual environment. The form with the
  2799. %    |*| is used for double column figures.
  2800. %    \begin{macrocode}
  2801. \newenvironment{figure}
  2802.                {\@float{figure}}
  2803.                {\end@float}
  2804. \newenvironment{figure*}
  2805.                {\@dblfloat{figure}}
  2806.                {\end@dblfloat}
  2807. %    \end{macrocode}
  2808. % \end{environment}
  2809. % \end{environment}
  2810. % \subsubsection{Table}
  2811. %    Here is the implementation of the table environment. It is very
  2812. %    much the same as the figure environment.
  2813. % \begin{macro}{\c@table}
  2814. %    First we have to allocate a counter to number the tables. In the
  2815. %    report and book document classes the tables are numbered per
  2816. %    chapter.
  2817. %    \begin{macrocode}
  2818. %<*article>
  2819. \newcounter{table}
  2820. \renewcommand\thetable{\@arabic\c@table}
  2821. %</article>
  2822. %<*report|book>
  2823. \newcounter{table}[chapter]
  2824. \renewcommand\thetable{\thechapter.\@arabic\c@table}
  2825. %</report|book>
  2826. %    \end{macrocode}
  2827. % \end{macro}
  2828. % \begin{macro}{\fps@table}
  2829. % \begin{macro}{\ftype@table}
  2830. % \begin{macro}{\ext@table}
  2831. % \begin{macro}{\num@table}
  2832. %    Here are the parameters for the floating objects of type `table'.
  2833. %    \begin{macrocode}
  2834. \def\fps@table{tbp}
  2835. \def\ftype@table{2}
  2836. \def\ext@table{lot}
  2837. \def\fnum@table{\tablename~\thetable}
  2838. %    \end{macrocode}
  2839. % \end{macro}
  2840. % \end{macro}
  2841. % \end{macro}
  2842. % \end{macro}
  2843. % \begin{environment}{table}
  2844. % \begin{environment}{table*}
  2845. %    And the definition of the actual environment. The form with the
  2846. %    |*| is used for double column tables.
  2847. %    \begin{macrocode}
  2848. \newenvironment{table}
  2849.                {\@float{table}}
  2850.                {\end@float}
  2851. \newenvironment{table*}
  2852.                {\@dblfloat{table}}
  2853.                {\end@dblfloat}
  2854. %    \end{macrocode}
  2855. % \end{environment}
  2856. % \end{environment}
  2857. % \subsubsection{Captions}
  2858. % \begin{macro}{\@makecaption}
  2859. %    The |\caption| command calls |\@makecaption| to format the
  2860. %    caption of floating objects. It gets two arguments,
  2861. %    \meta{number}, the number of the floating object and \meta{text},
  2862. %    the text of the caption. Usually \meta{number} contains a string
  2863. %    such as `Figure 3.2'. The macro can assume it is called inside a
  2864. %    |\parbox| of right width, with |\normalsize|.
  2865. % \begin{macro}{\abovecaptionskip}
  2866. % \begin{macro}{\belowcaptionskip}
  2867. %    These lengths contain the amount of white space to leave above
  2868. %    and below the caption.
  2869. %    \begin{macrocode}
  2870. \newlength\abovecaptionskip
  2871. \newlength\belowcaptionskip
  2872. \setlength\abovecaptionskip{10\p@}
  2873. \setlength\belowcaptionskip{0\p@}
  2874. %    \end{macrocode}
  2875. % \end{macro}
  2876. % \end{macro}
  2877. %    The definition of this macro is |\long| in order to allow more
  2878. %    then one paragraph in a caption.
  2879. %    \begin{macrocode}
  2880. \long\def\@makecaption#1#2{%
  2881.   \vskip\abovecaptionskip
  2882. %    \end{macrocode}
  2883. %    We want to see if the caption fits on one line on the page,
  2884. %    therefore we first typeset it in a temporary box.
  2885. % \changes{v1.2q}{1994/05/29}{Use \cs{sbox}\cs{@tempboxa} instead of
  2886. %    \cs{setbox}\cs{@tempboxa}\cs{hbox} to make this colour safe}
  2887. %    \begin{macrocode}
  2888.   \sbox\@tempboxa{#1: #2}%
  2889. %    \end{macrocode}
  2890. %    We can the measure its width. It that is larger than the current
  2891. %    |\hsize| we typeset the caption as an ordinary paragraph.
  2892. %    \begin{macrocode}
  2893.   \ifdim \wd\@tempboxa >\hsize
  2894.     #1: #2\par
  2895. %    \end{macrocode}
  2896. %    If the caption fits, we center it.
  2897. %    \begin{macrocode}
  2898.   \else
  2899.     \hbox to\hsize{\hfil\box\@tempboxa\hfil}%
  2900.   \fi
  2901.   \vskip\belowcaptionskip}
  2902. %    \end{macrocode}
  2903. % \end{macro}
  2904. % \subsection{Font changing}
  2905. %    Here we supply the declarative font changing commands that were
  2906. %    common in \LaTeX\ version 2.09 and earlier. These commands work
  2907. %    in text mode \emph{and} in math mode. They are provided for
  2908. %    compatibility, but one should start using the |\text...| and
  2909. %    |\math...| commands instead. These commands are defined using
  2910. %    |\DeclareTextFontCommand|, a command with three arguments: the
  2911. %    user command to be defined; \LaTeX\ commands to execute in text
  2912. %    mode and \LaTeX\ commands to execute in math mode.
  2913. % \changes{v1.0g}{1993/12/12}{Distinguished between compatibility and
  2914. %    `normal' mode for the font changing commands.}
  2915. % \changes{v1.0h}{1993/12/18}{These are now defined in the kernel,
  2916. %    so use \cmd\@renewfontswitch.  Compatibility mode defines
  2917. %    \cmd\@renewfontswitch to do nothing, so we don't need to check for
  2918. %    compatibility mode any more.}
  2919. % \changes{v1.0j}{1993/12/20}{Added \cmd\normalfont back in the
  2920. %    definitions of \cmd\rm etc. as this should be the default
  2921. %    behaviour}
  2922. % \changes{v1.2e}{1994/04/14}{\cmd\@renewfontswitch has become
  2923. %    \cmd\DeclareOldFontCommand}
  2924. %  \begin{macro}{\rm}
  2925. % \changes{v1.0f}{1993/12/08}{Macro added}
  2926. %  \begin{macro}{\tt}
  2927. % \changes{v1.0f}{1993/12/08}{Macro added}
  2928. %  \begin{macro}{\sf}
  2929. % \changes{v1.0f}{1993/12/08}{Macro added}
  2930. %    The commands to change the family. When in compatibility mode we
  2931. %    select the `default' font first, to get \LaTeX2.09 behviour.
  2932. %    \begin{macrocode}
  2933. \DeclareOldFontCommand{\rm}{\normalfont\rmfamily}{\mathrm}
  2934. \DeclareOldFontCommand{\sf}{\normalfont\sffamily}{\mathsf}
  2935. \DeclareOldFontCommand{\tt}{\normalfont\ttfamily}{\mathtt}
  2936. %    \end{macrocode}
  2937. %  \end{macro}
  2938. %  \end{macro}
  2939. %  \end{macro}
  2940. %  \begin{macro}{\bf}
  2941. % \changes{v1.0f}{1993/12/08}{Macro added}
  2942. %    The command to change to the bold series. One should use
  2943. %    |\mdseries| to explicitly switch back to medium series.
  2944. %    \begin{macrocode}
  2945. \DeclareOldFontCommand{\bf}{\normalfont\bfseries}{\mathbf}
  2946. %    \end{macrocode}
  2947. %  \end{macro}
  2948. %  \begin{macro}{\sl}
  2949. % \changes{v1.0f}{1993/12/08}{Macro added}
  2950. % \changes{v1.2g}{1994/04/24}{Added warning if used in math mode}
  2951. %  \begin{macro}{\it}
  2952. % \changes{v1.0f}{1993/12/08}{Macro added}
  2953. %  \begin{macro}{\sc}
  2954. % \changes{v1.0f}{1993/12/08}{Macro added}
  2955. % \changes{v1.2g}{1994/04/24}{Added warning if used in math mode}
  2956. %    And the commands to change the shape of the font. The slanted and
  2957. %    small caps shapes are not available by default as math alphabets,
  2958. %    so those changes do nothing in math mode. However, we do warn the
  2959. %    user that the selection will not have any effect.One should use
  2960. %    |\upshape| to explicitly change back to the upright shape.
  2961. %    \begin{macrocode}
  2962. \DeclareOldFontCommand{\it}{\normalfont\itshape}{\mathit}
  2963. \DeclareOldFontCommand{\sl}{\normalfont\slshape}{\@nomath\sl}
  2964. \DeclareOldFontCommand{\sc}{\normalfont\scshape}{\@nomath\sc}
  2965. %    \end{macrocode}
  2966. %  \end{macro}
  2967. %  \end{macro}
  2968. %  \end{macro}
  2969. % \begin{macro}{\cal}
  2970. % \changes{v1.0g}{1993/12/12}{Macro added}
  2971. % \begin{macro}{\mit}
  2972. % \changes{v1.0g}{1993/12/12}{Macro added}
  2973. %    The commands |\cal| and |\mit| should only be used in math mode,
  2974. %    outside math mode they have no effect. Currently the New Font
  2975. %    Selection Scheme defines these commands to generate warning
  2976. %    messages. Therefore we have to define them `by hand'.
  2977. %    \begin{macrocode}
  2978. \renewcommand{\cal}{\protect\pcal}
  2979. \newcommand{\pcal}{\@fontswitch{\relax}{\mathcal}}
  2980. \renewcommand{\mit}{\protect\pmit}
  2981. \newcommand{\pmit}{\@fontswitch{\relax}{\mathnormal}}
  2982. %    \end{macrocode}
  2983. %  \end{macro}
  2984. %  \end{macro}
  2985. % \section{Cross Referencing}
  2986. % \subsection{Table of Contents, etc.}
  2987. %     A |\section| command writes a
  2988. %     |\contentsline{section}{|\meta{title}|}{|\meta{page}|}| command
  2989. %     on the \file{.toc} file, where \meta{title} contains the
  2990. %     contents of the entry and \meta{page} is the page number. If
  2991. %     sections are being numbered, then \meta{title} will be of the
  2992. %     form |\numberline{|\meta{num}|}{|\meta{heading}|}| where
  2993. %     \meta{num} is the number produced by |\thesection|.  Other
  2994. %     sectioning commands work similarly.
  2995. %     A |\caption| command in a `figure' environment writes
  2996. %     |\contentsline{figure}{\numberline{|\meta{num}|}{|%
  2997. %                    \meta{caption}|}}{|\meta{page}|}|
  2998. %     on the .\file{lof} file, where \meta{num} is the number produced
  2999. %     by |\thefigure| and \meta{caption} is the figure caption.  It
  3000. %     works similarly for a `table' environment.
  3001. %    The command |\contentsline{|\meta{name}|}| expands to
  3002. %    |\l@|\meta{name}.  So, to specify the table of contents, we must
  3003. %    define |\l@chapter|, |\l@section|, |\l@subsection|, ... ; to
  3004. %    specify the list of figures, we must define |\l@figure|; and so
  3005. %    on.  Most of these can be defined with the |\@dottedtocline|
  3006. %    command, which works as follows.
  3007. %    |\@dottedtocline{|\meta{level}|}{|\meta{indent}|}{|^^A
  3008. %                      \meta{numwidth}|}{|^^A
  3009. %                      \meta{title}|}{|\meta{page}|}|
  3010. %    \begin{description}
  3011. %    \item[\meta{level}] An entry is produced only if\meta{ level}
  3012. %        $<=$ value of the \Lcount{tocdepth} counter.  Note,
  3013. %        |\chapter| is level 0, |\section| is level 1, etc.
  3014. %    \item[\meta{indent}] The indentation from the outer left margin
  3015. %        of the start   of the contents line.
  3016. %    \item[\meta{numwidth}] The width of a box in which the section
  3017. %        number is to go, if \meta{title} includes a |\numberline|
  3018. %        command.
  3019. %    \end{description}
  3020. % \begin{macro}{\@pnumwidth}
  3021. % \begin{macro}{\@tocrmarg}
  3022. % \begin{macro}{\@dotsep}
  3023. %    This command uses the following three parameters, which are set
  3024. %    with a |\newcommand| (so em's can be used to make them depend upon
  3025. %    the font).
  3026. %    \begin{description}
  3027. %    \item[\texttt{\bslash @pnumwidth}] The width of a box in which the
  3028. %        page number is put.
  3029. %    \item[\texttt{\bslash @tocrmarg}] The right margin for multiple
  3030. %        line entries.  One wants |\@tocrmarg| > or = |\@pnumwidth|
  3031. %    \item[\texttt{\bslash @dotsep}] Separation between dots, in mu
  3032. %        units. Should be defined as a number like 2 or 1.7
  3033. %    \end{description}
  3034. %    \begin{macrocode}
  3035. \newcommand\@pnumwidth{1.55em}
  3036. \newcommand\@tocrmarg {2.55em}
  3037. \newcommand\@dotsep{4.5}
  3038. %<+article>\setcounter{tocdepth}{3}
  3039. %<-article>\setcounter{tocdepth}{2}
  3040. %    \end{macrocode}
  3041. % \end{macro}
  3042. % \end{macro}
  3043. % \end{macro}
  3044. % \subsubsection{Table of Contents}
  3045. % \begin{macro}{\tableofcontents}
  3046. %    This macro is used to request that \LaTeX{} produces a table of
  3047. %    contents. In the report and book document classes the tables of
  3048. %    contents, figures etc. are always set in single-column style.
  3049. % \changes{v1.0g}{1993/12/09}{Moved the setting of
  3050. %    \cmd\@restonecolfalse}
  3051. %    \begin{macrocode}
  3052. \newcommand\tableofcontents{%
  3053. %<*report|book>
  3054.     \if@twocolumn
  3055.       \@restonecoltrue\onecolumn
  3056.     \else
  3057.       \@restonecolfalse
  3058.     \fi
  3059. %    \end{macrocode}
  3060. %    The title is set using the |\chapter*| command, making sure that
  3061. %    the running head --if one is required-- contains the right
  3062. %    information.
  3063. %    \begin{macrocode}
  3064.     \chapter*{\contentsname
  3065. %</report|book>
  3066. %<+article>    \section*{\contentsname
  3067.         \@mkboth{\uppercase{\contentsname}}{\uppercase{\contentsname}}}%
  3068. %    \end{macrocode}
  3069. %    The the actual table of contents is made by calling
  3070. %    |\@starttoc{toc}|. After that we restore twocolumn mode if
  3071. %    necessary.
  3072. %    \begin{macrocode}
  3073.     \@starttoc{toc}%
  3074. %<-article>    \if@restonecol\twocolumn\fi
  3075.     }
  3076. %    \end{macrocode}
  3077. % \end{macro}
  3078. % \begin{macro}{\l@part}
  3079. %    Each sectioning command needs an additional macro  to format its
  3080. %    entry in the table of contents, as described above. The macro for
  3081. %    the entry for parts is defined in a special way.
  3082. %    First we make sure that if a pagebreak should occur, it occurs
  3083. %    {\em before} this entry. Also a little whitespace is added and a
  3084. %    group begun to keep changes local.
  3085. % \changes{v1.0h}{1993/12/18}{Replaced -\cmd\@secpenalty by
  3086. %    \cmd\@secpenalty.  ASAJ.}
  3087. % \changes{v1.2i}{1994/04/28}{Don't print a toc line when the tocdepth
  3088. %    counter is less then -1}
  3089. %    \begin{macrocode}
  3090. \newcommand\l@part[2]{%
  3091.   \ifnum \c@tocdepth >-2\relax
  3092. %<+article>    \addpenalty{\@secpenalty}%
  3093. %<-article>    \addpenalty{-\@highpenalty}%
  3094.     \addvspace{2.25em \@plus\p@}%
  3095.     \begingroup
  3096. %    \end{macrocode}
  3097. %    The macro |\numberline| requires that the width of the box that
  3098. %    holds the part number is stored in \LaTeX's scratch register
  3099. %    |\@tempdima|. Therefore we put it there.
  3100. %    \begin{macrocode}
  3101.       \setlength\@tempdima{3em}%
  3102. %    \end{macrocode}
  3103. %    The we set |\parindent| to 0pt and use |\rightskip| to leave
  3104. %    enough room for the pagenumbers. To prevent overfull box messages
  3105. %    the |\parfillskip| is set to a negative value.
  3106. %    \begin{macrocode}
  3107.       \parindent \z@ \rightskip \@pnumwidth
  3108.       \parfillskip -\@pnumwidth
  3109. %    \end{macrocode}
  3110. %    Now we can set the entry, in a large bold font. We make sure to
  3111. %    leave vertical mode, set the part title and add the pagenumber,
  3112. %    set flush right.
  3113. %    \begin{macrocode}
  3114.       {\leavevmode
  3115.        \large \bfseries #1\hfil \hbox to\@pnumwidth{\hss #2}}\par
  3116. %    \end{macrocode}
  3117. %    Prevent a pagebreak immediately after this entry, but use
  3118. %    |\everypar| to reset the |\if@nobreak| switch. Finally we close
  3119. %    the group.
  3120. %    \begin{macrocode}
  3121.        \nobreak
  3122. %<+article>       \if@compatibility
  3123.          \global\@nobreaktrue
  3124.          \everypar{\global\@nobreakfalse\everypar{}}
  3125. %<+article>      \fi
  3126.     \endgroup
  3127.   \fi}
  3128. %    \end{macrocode}
  3129. % \end{macro}
  3130. % \begin{macro}{\l@chapter}
  3131. %    This macro formats the entries in the table of contents for
  3132. %    chapters. It is very similar to |\l@part|
  3133. %    First we make sure that if a pagebreak should occur, it occurs
  3134. %    {\em before} this entry. Also a little whitespace is added and a
  3135. %    group begun to keep changes local.
  3136. % \changes{v1.2i}{1994/04/28}{Don't print a toc line when the tocdepth
  3137. %    counter is less then 0}
  3138. %    \begin{macrocode}
  3139. %<*report|book>
  3140. \newcommand\l@chapter[2]{%
  3141.   \ifnum \c@tocdepth >\m@ne
  3142.     \addpenalty{-\@highpenalty}%
  3143.     \vskip 1.0em \@plus\p@
  3144. %    \end{macrocode}
  3145. %    The macro |\numberline| requires that the width of the box that
  3146. %    holds the part number is stored in \LaTeX's scratch register
  3147. %    |\@tempdima|. Therefore we put it there. We begin a group, and
  3148. %    change some of the paragraph parameters.
  3149. %    \begin{macrocode}
  3150.     \setlength\@tempdima{1.5em}%
  3151.     \begingroup
  3152.       \parindent \z@ \rightskip \@pnumwidth
  3153.       \parfillskip -\@pnumwidth
  3154. %    \end{macrocode}
  3155. %    Then we leave vertical mode and switch to a bold font.
  3156. %    \begin{macrocode}
  3157.       \leavevmode \bfseries
  3158. %    \end{macrocode}
  3159. %    Because we do not use |\numberline| here, we have do some fine
  3160. %    tuning `by hand', before we can set the entry. We discourage but
  3161. %    not disallow a pagebreak immediately after a chapter entry.
  3162. %    \begin{macrocode}
  3163.       \advance\leftskip\@tempdima
  3164.       \hskip -\leftskip
  3165.       #1\nobreak\hfil \nobreak\hbox to\@pnumwidth{\hss #2}\par
  3166.       \penalty\@highpenalty
  3167.     \endgroup
  3168.   \fi}
  3169. %</report|book>
  3170. %    \end{macrocode}
  3171. % \end{macro}
  3172. % \begin{macro}{\l@section}
  3173. %    In the article document class the entry in the table of contents
  3174. %    for sections looks much like the chapter entries for the report
  3175. %    and book document classes.
  3176. %    First we make sure that if a pagebreak should occur, it occurs
  3177. %    {\em before} this entry. Also a little whitespace is added and a
  3178. %    group begun to keep changes local.
  3179. % \changes{v1.0h}{1993/12/18}{Replaced -\cmd\@secpenalty by
  3180. %    \cmd\@secpenalty.  ASAJ.}
  3181. % \changes{v1.2i}{1994/04/28}{Don't print a toc line when the tocdepth
  3182. %    counter is less then 1}
  3183. %    \begin{macrocode}
  3184. %<*article>
  3185. \newcommand\l@section[2]{%
  3186.   \ifnum \c@tocdepth >\z@
  3187.     \addpenalty{\@secpenalty}%
  3188.     \addvspace{1.0em \@plus\p@}%
  3189. %    \end{macrocode}
  3190. %    The macro |\numberline| requires that the width of the box that
  3191. %    holds the part number is stored in \LaTeX's scratch register
  3192. %    |\@tempdima|. Therefore we put it there. We begin a group, and
  3193. %    change some of the paragraph parameters.
  3194. %    \begin{macrocode}
  3195.     \setlength\@tempdima{1.5em}%
  3196.     \begingroup
  3197.       \parindent \z@ \rightskip \@pnumwidth
  3198.       \parfillskip -\@pnumwidth
  3199. %    \end{macrocode}
  3200. %    Then we leave vertical mode and switch to a bold font.
  3201. %    \begin{macrocode}
  3202.       \leavevmode \bfseries
  3203. %    \end{macrocode}
  3204. %    Because we do not use |\numberline| here, we have do some fine
  3205. %    tuning `by hand', before we can set the entry. We discourage but
  3206. %    not disallow a pagebreak immediately after a chapter entry.
  3207. %    \begin{macrocode}
  3208.       \advance\leftskip\@tempdima
  3209.       \hskip -\leftskip
  3210.       #1\nobreak\hfil \nobreak\hbox to\@pnumwidth{\hss #2}\par
  3211.     \endgroup
  3212.   \fi}
  3213. %</article>
  3214. %    \end{macrocode}
  3215. %    In the report and book document classes the definition for
  3216. %    |\l@section| is much simpler.
  3217. %    \begin{macrocode}
  3218. %<*report|book>
  3219. \newcommand\l@section      {\@dottedtocline{1}{1.5em}{2.3em}}
  3220. %</report|book>
  3221. %    \end{macrocode}
  3222. % \end{macro}
  3223. % \begin{macro}{\l@subsection}
  3224. % \begin{macro}{\l@subsubsection}
  3225. % \begin{macro}{\l@paragraph}
  3226. % \begin{macro}{\l@subparagraph}
  3227. %    All lower level entries are defined using the macro
  3228. %    |\@dottedtocline| (see above).
  3229. %    \begin{macrocode}
  3230. %<*article>
  3231. \newcommand\l@subsection   {\@dottedtocline{2}{1.5em}{2.3em}}
  3232. \newcommand\l@subsubsection{\@dottedtocline{3}{3.8em}{3.2em}}
  3233. \newcommand\l@paragraph    {\@dottedtocline{4}{7.0em}{4.1em}}
  3234. \newcommand\l@subparagraph {\@dottedtocline{5}{10em}{5em}}
  3235. %</article>
  3236. %<*report|book>
  3237. \newcommand\l@subsection   {\@dottedtocline{2}{3.8em}{3.2em}}
  3238. \newcommand\l@subsubsection{\@dottedtocline{3}{7.0em}{4.1em}}
  3239. \newcommand\l@paragraph    {\@dottedtocline{4}{10em}{5em}}
  3240. \newcommand\l@subparagraph {\@dottedtocline{5}{12em}{6em}}
  3241. %</report|book>
  3242. %    \end{macrocode}
  3243. % \end{macro}
  3244. % \end{macro}
  3245. % \end{macro}
  3246. % \end{macro}
  3247. % \subsubsection{List of figures}
  3248. % \begin{macro}{\listoffigures}
  3249. %    This macro is used to request that \LaTeX{} produces a list of
  3250. %    figures. It is very similar to |\tableofcontents|.
  3251. % \changes{v1.0g}{1993/12/09}{Moved the setting of
  3252. %                             \cmd\@restonecolfalse}
  3253. %    \begin{macrocode}
  3254. \newcommand\listoffigures{%
  3255. %<*report|book>
  3256.     \if@twocolumn
  3257.       \@restonecoltrue\onecolumn
  3258.     \else
  3259.       \@restonecolfalse
  3260.     \fi
  3261.     \chapter*{\listfigurename
  3262. %</report|book>
  3263. %<+article>    \section*{\listfigurename
  3264.       \@mkboth{\uppercase{\listfigurename}}%
  3265.               {\uppercase{\listfigurename}}}%
  3266.     \@starttoc{lof}%
  3267. %<+report|book>    \if@restonecol\twocolumn\fi
  3268.     }
  3269. %    \end{macrocode}
  3270. % \end{macro}
  3271. % \begin{macro}{\l@figure}
  3272. %    This macro produces an entry in the list of figures.
  3273. %    \begin{macrocode}
  3274. \newcommand\l@figure{\@dottedtocline{1}{1.5em}{2.3em}}
  3275. %    \end{macrocode}
  3276. % \end{macro}
  3277. % \subsubsection{List of tables}
  3278. % \begin{macro}{\listoftables}
  3279. %    This macro is used to request that \LaTeX{} produces a list of
  3280. %    tables. It is very similar to |\tableofcontents|.
  3281. % \changes{v1.0g}{1993/12/09}{Moved the setting of
  3282. %                             \cmd\@restonecolfalse}
  3283. %    \begin{macrocode}
  3284. \newcommand\listoftables{%
  3285. %<*report|book>
  3286.     \if@twocolumn
  3287.       \@restonecoltrue\onecolumn
  3288.     \else
  3289.       \@restonecolfalse
  3290.     \fi
  3291.     \chapter*{\listtablename
  3292. %</report|book>
  3293. %<+article>    \section*{\listtablename
  3294.       \@mkboth{\uppercase{\listtablename}}{\uppercase{\listtablename}}}%
  3295.     \@starttoc{lot}%
  3296. %<+report|book>    \if@restonecol\twocolumn\fi
  3297.     }
  3298. %    \end{macrocode}
  3299. % \end{macro}
  3300. % \begin{macro}{\l@table}
  3301. %    This macro produces an entry in the list of tables.
  3302. %    \begin{macrocode}
  3303. \let\l@table\l@figure
  3304. %    \end{macrocode}
  3305. % \end{macro}
  3306. % \subsection{Bibliography}
  3307. % \begin{macro}{\bibindent}
  3308. %    The ``open'' bibliography format uses an indentation of
  3309. %    |\bibindent|.
  3310. %    \begin{macrocode}
  3311. \newdimen\bibindent
  3312. \bibindent=1.5em
  3313. %    \end{macrocode}
  3314. % \end{macro}
  3315. % \begin{environment}{thebibliography}
  3316. %    The `thebibliography' environment executes the following
  3317. %    commands:
  3318. %    |\renewcommand\newblock{\hskip .11em \@plus .33em \@minus .07em}|
  3319. %      -- Defines the ``closed'' format, where the blocks (major units
  3320. %      of information) of an entry run together.
  3321. %    |\sloppy|  -- Used because it's rather hard to do line breaks in
  3322. %      bibliographies,
  3323. %    |\sfcode`\.=1000\relax| --
  3324. %      Causes a `.' (period) not to produce an end-of-sentence space.
  3325. %    The implementation of this environment is based on the generic
  3326. %    list environment. It uses the \Lcount{enumiv} counter internally
  3327. %    to generate the labels of the list.
  3328. %    When an empty `thebibliography' environment is found, a warning
  3329. %    is issued.
  3330. % \changes{v1.0i}{1993/12/19}{Corrected definition of thebibliography
  3331. %           for article}
  3332. %    \begin{macrocode}
  3333. \newenvironment{thebibliography}[1]
  3334. %<*article>
  3335.      {\section*{\refname
  3336.         \@mkboth{\uppercase{\refname}}{\uppercase{\refname}}}%
  3337. %</article>
  3338. %<*!article>
  3339.      {\chapter*{\bibname
  3340.         \@mkboth{\uppercase{\bibname}}{\uppercase{\bibname}}}%
  3341. %</!article>
  3342.       \list{\@biblabel{\arabic{enumiv}}}%
  3343.            {\settowidth\labelwidth{\@biblabel{#1}}%
  3344.             \leftmargin\labelwidth
  3345.             \advance\leftmargin\labelsep
  3346.             \if@openbib
  3347.               \advance\leftmargin\bibindent
  3348.               \itemindent -\bibindent
  3349.               \listparindent \itemindent
  3350.               \parsep \z@
  3351.             \fi
  3352.             \usecounter{enumiv}%
  3353.             \let\p@enumiv\@empty
  3354.             \renewcommand\theenumiv{\arabic{enumiv}}}%
  3355.       \if@openbib
  3356.         \renewcommand\newblock{\par}
  3357.       \else
  3358.         \renewcommand\newblock{\hskip .11em \@plus.33em \@minus.07em}%
  3359.       \fi
  3360.       \sloppy\clubpenalty4000\widowpenalty4000%
  3361.       \sfcode`\.=\@m}
  3362.      {\def\@noitemerr
  3363.        {\@latex@warning{Empty `thebibliography' environment}}%
  3364.       \endlist}
  3365. %    \end{macrocode}
  3366. % \end{environment}
  3367. % \begin{macro}{\newblock}
  3368. %    A dummy definition of |\newblock|, just to let it exist.
  3369. %    \begin{macrocode}
  3370. \newcommand\newblock{}
  3371. %    \end{macrocode}
  3372. % \end{macro}
  3373. % \begin{macro}{\@biblabel}
  3374. %    The label for a |\bibitem[...]| command is produced by this
  3375. %    macro. The default from \file{latex.dtx} is used.
  3376. %    \begin{macrocode}
  3377. % \renewcommand\@biblabel[1]{[#1]\hfill}
  3378. %    \end{macrocode}
  3379. % \end{macro}
  3380. % \begin{macro}{\@cite}
  3381. %    The output of the |\cite| command is produced by this macro. The
  3382. %    default from \file{latex.dtx} is used.
  3383. %    \begin{macrocode}
  3384. % \renewcommand\@cite[1]{[#1]}
  3385. %    \end{macrocode}
  3386. % \end{macro}
  3387. %  \subsection{The index}
  3388. % \begin{environment}{theindex}
  3389. %    The environment `theindex' can be used for indices. It makes an
  3390. %    index with two columns, with each entry a separate paragraph. At
  3391. %    the user level the commands |\item|, |\subitem| and |\subsubitem|
  3392. %    are used to produce index entries of various levels. When a new
  3393. %    letter of the alphabet is encountered an amount of |\indexspace|
  3394. %    white space can be added.
  3395. % \changes{v1.0g}{1993/12/09}{Moved the setting of
  3396. %                             \cmd\@restonecoltrue}
  3397. %    \begin{macrocode}
  3398. \newenvironment{theindex}
  3399.                {\if@twocolumn
  3400.                   \@restonecolfalse
  3401.                 \else
  3402.                   \@restonecoltrue
  3403.                 \fi
  3404.                 \columnseprule \z@
  3405.                 \columnsep 35\p@
  3406. %<+article>                \twocolumn[\section*{\indexname}]%
  3407. %<-article>                \twocolumn[\@makeschapterhead{\indexname}]%
  3408.                 \@mkboth{\uppercase{\indexname}}%
  3409.                         {\uppercase{\indexname}}%
  3410.                 \thispagestyle{plain}\parindent\z@
  3411.                 \parskip\z@ \@plus .3\p@\relax
  3412.                 \let\item\@idxitem}
  3413. %    \end{macrocode}
  3414. %    When the document continues after the index and it was a one
  3415. %    column document we have to switch back to one column after the
  3416. %    index.
  3417. %    \begin{macrocode}
  3418.                {\if@restonecol\onecolumn\else\clearpage\fi}
  3419. %    \end{macrocode}
  3420. % \end{environment}
  3421. % \begin{macro}{\@idxitem}
  3422. % \begin{macro}{\subitem}
  3423. % \begin{macro}{\subsubitem}
  3424. %    Thsee macros are used to format the entries in the index. ^^AA ???
  3425. %    \begin{macrocode}
  3426. \newcommand\@idxitem  {\par\hangindent 40\p@}
  3427. \newcommand\subitem   {\par\hangindent 40\p@ \hspace*{20\p@}}
  3428. \newcommand\subsubitem{\par\hangindent 40\p@ \hspace*{30\p@}}
  3429. %    \end{macrocode}
  3430. % \end{macro}
  3431. % \end{macro}
  3432. % \end{macro}
  3433. % \begin{macro}{\indexspace}
  3434. %    The amount of white space that is inserted between `letter
  3435. %    blocks' in the index.
  3436. %    \begin{macrocode}
  3437. \newcommand\indexspace{\par \vskip 10\p@ \@plus5\p@ \@minus3\p@\relax}
  3438. %    \end{macrocode}
  3439. % \end{macro}
  3440. % \subsection{Footnotes}
  3441. % \begin{macro}{\footnoterule}
  3442. %    Usually, footnotes are separated from the main body of the text
  3443. %    by a small rule. This rule is drawn by the macro |\footnoterule|.
  3444. %    We have to make sure that the rule takes no vertical space (see
  3445. %    \file{plain.tex}) so we compensate for the natural heigth of the
  3446. %    rule of 0.4pt by adding the right amount of vertical skip.
  3447. %    To prevent the rule from colliding with the footnote we first add
  3448. %    a little negative vertical skip, then we put the rule and make
  3449. %    sure we end up at the same point where we begun this operation.
  3450. %    \begin{macrocode}
  3451. \renewcommand\footnoterule{%
  3452.   \kern-3\p@
  3453.   \hrule width .4\columnwidth
  3454.   \kern 2.6\p@}
  3455. %    \end{macrocode}
  3456. % \end{macro}
  3457. % \begin{macro}{\c@footnote}
  3458. %    Footnotes are numbered within chapters in the report and book
  3459. %    document styles.
  3460. %    \begin{macrocode}
  3461. % \newcounter{footnote}
  3462. %<-article>\@addtoreset{footnote}{chapter}
  3463. %    \end{macrocode}
  3464. % \end{macro}
  3465. % \begin{macro}{\@makefntext}
  3466. %    The footnote mechanism of \LaTeX{} calls the macro |\@makefntext|
  3467. %    to produce the actual footnote. The macro gets the text of the
  3468. %    footnote as its argument and should use |\@thefnmark| as the mark
  3469. %    of the footnote. The macro |\@makefntext|is called when
  3470. %    effectively inside a |\parbox| of width |\columnwidth| (i.e.,
  3471. %    with |\hsize| = |\columnwidth|).
  3472. %   An example of what can be achieved is given by the following piece
  3473. %   of \TeX\ code.
  3474. % \begin{verbatim}
  3475. %          \long\def\@makefntext#1{%
  3476. %             \@setpar{\@@par
  3477. %                      \@tempdima = \hsize
  3478. %                      \advance\@tempdima-10pt
  3479. %                      \parshape \@ne 10pt \@tempdima}%
  3480. %             \par
  3481. %             \parindent 1em\noindent
  3482. %             \hbox to \z@{\hss\@makefnmark}#1}
  3483. % \end{verbatim}
  3484. %    The effect of this definition is that all lines of the footnote
  3485. %    are indented by 10pt, while the first line of a new paragraph is
  3486. %    indented by 1em. To change these dimensions, just substitute the
  3487. %    desired value for `10pt' (in both places) or `1em'.  The mark is
  3488. %    flushright against the footnote.
  3489. %    In these document classes we use a simpler macro, in which the
  3490. %    footnote text is set like an ordinary text paragraph, with no
  3491. %    indentation except on the first line of a paragraph, and the
  3492. %    first line of the footnote. Thus, all the macro must do is set
  3493. %    |\parindent| to the appropriate value for succeeding paragraphs
  3494. %    and put the proper indentation before the mark.
  3495. % \changes{v1.1a}{1994/03/13}{Use `@makefnmark to generate footnote
  3496. %                            marker}
  3497. %    \begin{macrocode}
  3498. \long\def\@makefntext#1{%
  3499.     \parindent 1em%
  3500.     \noindent
  3501.     \hbox to 1.8em{\hss\@makefnmark}#1}
  3502. %    \end{macrocode}
  3503. % \end{macro}
  3504. % \begin{macro}{\@makefnmark}
  3505. %    The footnote markers that are printed in the text to point to the
  3506. %    footnotes should be produced by the macro |\@makefnmark|. We use
  3507. %    the default definition for it.
  3508. %    \begin{macrocode}
  3509. %\def\@makefnmark{\hbox{$^{\@thefnmark}\m@th$}}
  3510. %    \end{macrocode}
  3511. % \end{macro}
  3512. % \section{Initialization}
  3513. % \subsection{Words}
  3514. % \begin{macro}{\contentsname}
  3515. % \begin{macro}{\listfigurename}
  3516. % \begin{macro}{\listtablename}
  3517. % \begin{macro}{\refname}
  3518. % \begin{macro}{\bibname}
  3519. % \begin{macro}{\indexname}
  3520. % \begin{macro}{\figurename}
  3521. % \begin{macro}{\tablename}
  3522. % \begin{macro}{\partname}
  3523. % \begin{macro}{\chaptername}
  3524. % \begin{macro}{\appendixname}
  3525. % \begin{macro}{\abstractname}
  3526. % This document class is for documents prepared in the English language.
  3527. % To prepare a version for another language, various English words must
  3528. % be replaced.  All the English words that require replacement are
  3529. % defined below in command names.
  3530. %    \begin{macrocode}
  3531. \newcommand\contentsname{Contents}
  3532. \newcommand\listfigurename{List of Figures}
  3533. \newcommand\listtablename{List of Tables}
  3534. %<+article>\newcommand\refname{References}
  3535. %<+report|book>\newcommand\bibname{Bibliography}
  3536. \newcommand\indexname{Index}
  3537. \newcommand\figurename{Figure}
  3538. \newcommand\tablename{Table}
  3539. \newcommand\partname{Part}
  3540. %<+report|book>\newcommand\chaptername{Chapter}
  3541. \newcommand\appendixname{Appendix}
  3542. %<-book>\newcommand\abstractname{Abstract}
  3543. %    \end{macrocode}
  3544. % \end{macro}
  3545. % \end{macro}
  3546. % \end{macro}
  3547. % \end{macro}
  3548. % \end{macro}
  3549. % \end{macro}
  3550. % \end{macro}
  3551. % \end{macro}
  3552. % \end{macro}
  3553. % \end{macro}
  3554. % \end{macro}
  3555. % \end{macro}
  3556. % \subsection{Date}
  3557. % \begin{macro}{\today}
  3558. %    This macro uses the \TeX\ primitives |\month|, |\day| and |\year|
  3559. %    to provide the date of the \LaTeX-run.
  3560. %    \begin{macrocode}
  3561. \newcommand\today{\ifcase\month\or
  3562.   January\or February\or March\or April\or May\or June\or
  3563.   July\or August\or September\or October\or November\or December\fi
  3564.   \space\number\day, \number\year}
  3565. %    \end{macrocode}
  3566. % \end{macro}
  3567. % \subsection{Two column mode}
  3568. % \begin{macro}{\columnsep}
  3569. %    This gives the distance between two columns in two column mode.
  3570. %    \begin{macrocode}
  3571. \setlength\columnsep{10\p@}
  3572. %    \end{macrocode}
  3573. % \end{macro}
  3574. % \begin{macro}{\columnseprule}
  3575. %    This gives the width of the rule between two columns in two
  3576. %    column mode. We have no visible rule.
  3577. %    \begin{macrocode}
  3578. \setlength\columnseprule{0\p@}
  3579. %    \end{macrocode}
  3580. % \end{macro}
  3581. % \subsection{The page style}
  3582. %    We have \pstyle{plain} pages in the document classes article and
  3583. %    report unless the user specified otherwise. In the `book'
  3584. %    document class we use the page style \pstyle{headings} by
  3585. %    default. We use arabic pagenumbers.
  3586. %    \begin{macrocode}
  3587. %<-book>\pagestyle{plain}
  3588. %<+book>\pagestyle{headings}
  3589. \pagenumbering{arabic}      % Arabic page numbers
  3590. %    \end{macrocode}
  3591. % \subsection{Single or double sided printing}
  3592. %    When the \Lopt{twoside} option was specified, we don't try to
  3593. %    make each page as long as all the others.
  3594. %    \begin{macrocode}
  3595. %<*article|report>
  3596. \if@twoside
  3597. \else
  3598.   \raggedbottom
  3599. %</article|report>
  3600. %    \end{macrocode}
  3601. %    When the \Lopt{twocolumn} option was specified we call
  3602. %    |\twocolumn| to activate this mode. We try to make each column as
  3603. %    long as the others, but call |sloppy| to make our life easier.
  3604. %    \begin{macrocode}
  3605. \if@twocolumn
  3606.   \twocolumn
  3607.   \sloppy
  3608.   \flushbottom
  3609. %    \end{macrocode}
  3610. %    Normally we call |\onecolumn| to initiate typesetting in one
  3611. %    column.
  3612. %    \begin{macrocode}
  3613. \else
  3614.   \onecolumn
  3615. %</article|report|book>
  3616. %    \end{macrocode}
  3617. % \section{External options to the standard document classes}
  3618. % \subsection{Left equation numbering}
  3619. %  \begin{macro}{\@eqnnum}
  3620. %    To put the equation number on the left side of an equation we
  3621. %    have to use a little trick. The number is shifted |\displaywidth|
  3622. %    to the left inside a box of (approximately) zero width. This
  3623. %    fails when the quation is too wide, the equation number than may
  3624. %    overprint the equation itself.
  3625. %    \begin{macrocode}
  3626. %<*leqno>
  3627. \renewcommand\@eqnnum{\hbox to .01\p@{}%
  3628.                       \rlap{\reset@font\rmfamily
  3629.                         \hskip -\displaywidth(\theequation)}}
  3630. %</leqno>
  3631. %    \end{macrocode}
  3632. %  \end{macro}
  3633. % \subsection{Flush left equations}
  3634. %    To get the displayed math environments to print the contents
  3635. %    flush left (with an indentation) we have to redefine all of
  3636. %    \LaTeXe's displayed math environments. 
  3637. %  \begin{macro}{\mathindent}
  3638. %    The amount of indentation of the equations is stored in a register.
  3639. %    \begin{macrocode}
  3640. %<*fleqn>
  3641. \newdimen\mathindent
  3642. %    \end{macrocode}
  3643. %    The setting of |\mathindent| has to be deferred until the class
  3644. %    file has been processed, because |\leftmargini| is still 0pt
  3645. %    wide at the moment \file{fleqn.clo} is read in.
  3646. % \changes{v1.0n}{1994/01/19}{Deferred setting of \cmd\mathindent}
  3647. % \changes{v1.2t}{1994/06/22}{Set \cs{mathindent} at the end of the
  3648. %    class instead of at begin document}
  3649. %    \begin{macrocode}
  3650. \AtEndOfClass{\mathindent\leftmargini}
  3651. %    \end{macrocode}
  3652. % \end{macro}
  3653. %  \begin{macro}{\[}
  3654. %    Begin display math;
  3655. %    \begin{macrocode}
  3656. \renewcommand{\[}{\relax
  3657.                  \ifmmode\@badmath
  3658.                  \else
  3659.                    \begin{trivlist}%
  3660.                      \@beginparpenalty\predisplaypenalty
  3661.                      \@endparpenalty\postdisplaypenalty
  3662.                      \item[]\leavevmode
  3663.                      \hbox to\linewidth\bgroup $\m@th\displaystyle %$
  3664.                        \hskip\mathindent\bgroup
  3665.                  \fi}
  3666. %    \end{macrocode}
  3667. % \end{macro}
  3668. %  \begin{macro}{\]}
  3669. %    end display math;
  3670. %    \begin{macrocode}
  3671. \renewcommand{\]}{\relax
  3672.                  \ifmmode
  3673.                        \egroup $\hfil% $
  3674.                      \egroup
  3675.                    \end{trivlist}%
  3676.                  \else \@badmath
  3677.                  \fi}
  3678. %    \end{macrocode}
  3679. % \end{macro}
  3680. %  \begin{environment}{equation}
  3681. %    The \textsf{equation} environment
  3682. %    \begin{macrocode}
  3683. \renewenvironment{equation}%
  3684.     {\@beginparpenalty\predisplaypenalty
  3685.      \@endparpenalty\postdisplaypenalty
  3686.      \refstepcounter{equation}%
  3687.      \trivlist \item[]\leavevmode
  3688.        \hbox to\linewidth\bgroup $\m@th% $
  3689.          \displaystyle
  3690.          \hskip\mathindent}%
  3691.         {$\hfil % $
  3692.          \displaywidth\linewidth\hbox{\@eqnnum}%
  3693.        \egroup
  3694.      \endtrivlist}
  3695. %    \end{macrocode}
  3696. % \end{environment}
  3697. % \begin{environment}{eqnarray}
  3698. %    The \textsf{eqnarray} environment
  3699. %    \begin{macrocode}
  3700. \renewenvironment{eqnarray}{%
  3701.     \stepcounter{equation}%
  3702.     \def\@currentlabel{\p@equation\theequation}%
  3703.     \global\@eqnswtrue\m@th
  3704.     \global\@eqcnt\z@
  3705.     \tabskip\mathindent
  3706.     \let\\=\@eqncr
  3707.     \setlength\abovedisplayskip{\topsep}%
  3708.     \ifvmode
  3709.       \addtolength\abovedisplayskip{\partopsep}%
  3710.     \fi
  3711.     \setlength\belowdisplayskip{\abovedisplayskip}%
  3712.     \setlength\belowdisplayshortskip{\abovedisplayskip}%
  3713.     \setlength\abovedisplayshortskip{\abovedisplayskip}%
  3714.     $$\everycr{}\halign to\linewidth% $$
  3715.     \bgroup
  3716.       \hskip\@centering
  3717.       $\displaystyle\tabskip\z@skip{##}$\@eqnsel&%
  3718.       \global\@eqcnt\@ne \hskip \tw@\arraycolsep \hfil${##}$\hfil&%
  3719.       \global\@eqcnt\tw@ \hskip \tw@\arraycolsep
  3720.         $\displaystyle{##}$\hfil \tabskip\@centering&%
  3721.       \global\@eqcnt\thr@@
  3722.         \hbox to \z@\bgroup\hss##\egroup\tabskip\z@skip\cr}%
  3723.       {\@@eqncr
  3724.     \egroup
  3725.     \global\advance\c@equation\m@ne$$% $$
  3726.     \global\@ignoretrue
  3727.     }
  3728. %</fleqn>
  3729. %    \end{macrocode}
  3730. % \end{environment}
  3731. % \Finale
  3732. \endinput
  3733.