home *** CD-ROM | disk | FTP | other *** search
/ Meeting Pearls 3 / Meeting_Pearls_III.iso / Pearls / texmf / inputs / latex / unpacked / letter.dtx < prev    next >
Encoding:
Text File  |  1995-06-21  |  60.6 KB  |  1,898 lines
  1. % \iffalse meta-comment
  2. %
  3. % Copyright 1993-1995 the LaTeX3 project and any individual authors
  4. % listed elsewhere in this file.  All rights reserved.
  5. % 
  6. % For further copyright information see the file legal.txt, and any
  7. % other copyright notices in this file.
  8. % 
  9. % This file is part of the LaTeX2e system.
  10. % ----------------------------------------
  11. %   This system is distributed in the hope that it will be useful,
  12. %   but WITHOUT ANY WARRANTY; without even the implied warranty of
  13. %   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
  14. % 
  15. %   For error reports concerning UNCHANGED versions of this file no more
  16. %   than one year old, see bugs.txt.
  17. % 
  18. %   Please do not request updates from us directly.  Primary
  19. %   distribution is through the CTAN archives.
  20. % 
  21. % 
  22. % IMPORTANT COPYRIGHT NOTICE:
  23. % 
  24. % You are NOT ALLOWED to distribute this file alone.
  25. % 
  26. % You are allowed to distribute this file under the condition that it is
  27. % distributed together with all the files listed in manifest.txt.
  28. % 
  29. % If you receive only some of these files from someone, complain!
  30. % 
  31. % Permission is granted to copy this file to another file with a clearly
  32. % different name and to customize the declarations in that copy to serve
  33. % the needs of your installation, provided that you comply with
  34. % the conditions in the file legal.txt.
  35. % 
  36. % However, NO PERMISSION is granted to produce or to distribute a
  37. % modified version of this file under its original name.
  38. %  
  39. % You are NOT ALLOWED to change this file.
  40. % 
  41. % 
  42. % \fi
  43. %
  44. % \CheckSum{984}
  45. %% \CharacterTable
  46. %%  {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
  47. %%   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
  48. %%   Digits        \0\1\2\3\4\5\6\7\8\9
  49. %%   Exclamation   \!     Double quote  \"     Hash (number) \#
  50. %%   Dollar        \$     Percent       \%     Ampersand     \&
  51. %%   Acute accent  \'     Left paren    \(     Right paren   \)
  52. %%   Asterisk      \*     Plus          \+     Comma         \,
  53. %%   Minus         \-     Point         \.     Solidus       \/
  54. %%   Colon         \:     Semicolon     \;     Less than     \<
  55. %%   Equals        \=     Greater than  \>     Question mark \?
  56. %%   Commercial at \@     Left bracket  \[     Backslash     \\
  57. %%   Right bracket \]     Circumflex    \^     Underscore    \_
  58. %%   Grave accent  \`     Left brace    \{     Vertical bar  \|
  59. %%   Right brace   \}     Tilde         \~}
  60. %
  61. % \iffalse
  62. % \section{Identification}
  63. %
  64. %
  65. %    This document class can only be used with \LaTeXe, so we make
  66. %    sure that an appropriate message is displayed when another \TeX{}
  67. %    format is used.
  68. %    \begin{macrocode}
  69. %<+letter>\NeedsTeXFormat{LaTeX2e}[1994/12/01]
  70. %    \end{macrocode}
  71. %
  72. %    Announce the Class name and its version.
  73. %    \begin{macrocode}
  74. %<+letter>\ProvidesClass{letter}
  75. %<*driver>
  76.        \ProvidesFile{letter.drv}
  77. %</driver>
  78.               [1995/05/25 v1.2s
  79. %<+letter>               Standard LaTeX document class]
  80. %    \end{macrocode}
  81. %
  82. % \section{The documentation driver file}
  83. %
  84. %    We have our own document class to format the \LaTeXe
  85. %    documentation.
  86. % \fi
  87. % \changes{v1.0.6}{1993/12/07}{Use class ltxdoc document class}
  88. % \iffalse
  89. %    \begin{macrocode}
  90. %<*driver>
  91. ]
  92. \documentclass{ltxdoc}
  93. %    \end{macrocode}
  94. %
  95. %    We don't want everything to appear in the index.
  96. %    \begin{macrocode}
  97. \DoNotIndex{\@Alph,\@alph,\@arabic,\@badmath}
  98. \DoNotIndex{\@centercr}
  99. \DoNotIndex{\@empty,\@ignoretrue}
  100. \DoNotIndex{\@ixpt}
  101. \DoNotIndex{\@M,\@minus,\@ne,\@plus}
  102. \DoNotIndex{\\,\addtolength}
  103. \DoNotIndex{\advance}
  104. \DoNotIndex{\ast,\begin,\begingroup,\bfseries,\bgroup,\box}
  105. \DoNotIndex{\bullet}
  106. \DoNotIndex{\cdot,\cr,\day,\DeclareOption}
  107. \DoNotIndex{\def,\DocInput,\documentclass}
  108. \DoNotIndex{\DoNotIndex,\egroup,\ifx,\else,\fi,\endtrivlist}
  109. \DoNotIndex{\EnableCrossrefs,\end,\end@dblfloat,\end@float,\endgroup}
  110. \DoNotIndex{\endlist,\everycr,\ExecuteOptions}
  111. \DoNotIndex{\filedate,\filename,\fileversion}
  112. \DoNotIndex{\global,\halign,\hangindent,\hbox,\hfil,\hfill,\hrule}
  113. \DoNotIndex{\hsize,\hskip,\hspace,\hss,\ifcase,\or,\fi}
  114. \DoNotIndex{\ifvmode,\fi,\ifnum,\fi,\input}
  115. \DoNotIndex{\kern,\leavevmode,\let,\leftmark}
  116. \DoNotIndex{\list,\llap,\long,\m@ne,\m@th,\mark}
  117. \DoNotIndex{\month,\newcommand,\newcounter,\newenvironment}
  118. \DoNotIndex{\NeedsTeXFormat,\newdimen}
  119. \DoNotIndex{\newpage,\nobreak,\noindent,\number}
  120. \DoNotIndex{\p@}
  121. \DoNotIndex{\pagestyle,\par}
  122. \DoNotIndex{\penalty,\PrintChanges,\PrintIndex,\ProcessOptions}
  123. \DoNotIndex{\protect,\ProvidesClass,\raggedbottom,\raggedright}
  124. \DoNotIndex{\refstepcounter,\relax,\renewcommand,\reset@font}
  125. \DoNotIndex{\rightmargin,\rlap,\rmfamily}
  126. \DoNotIndex{\setbox,\setcounter,\setlength}
  127. \DoNotIndex{\skip,\slshape,\space}
  128. \DoNotIndex{\trivlist,\typeout,\tw@}
  129. \DoNotIndex{\vskip,\vspace,\year,\z@}
  130. %
  131. \CodelineNumbered
  132. \CodelineIndex
  133. \EnableCrossrefs
  134. \RecordChanges
  135. %    \end{macrocode}
  136. %    We use so many \file{docstrip} modules that we set the
  137. %    \texttt{StandardModuleDepth} counter to 1.
  138. %    \begin{macrocode}
  139. \setcounter{StandardModuleDepth}{1}
  140. %    \end{macrocode}
  141. %    The following command retrieves the date and version information
  142. %    from the file.
  143. %    \begin{macrocode}
  144. \GetFileInfo{letter.drv}
  145. %    \end{macrocode}
  146. %    Some commonly used abbreviations
  147. %    \begin{macrocode}
  148. \newcommand*{\Lopt}[1]{\textsf {#1}}
  149. \newcommand*{\file}[1]{\texttt {#1}}
  150. \newcommand*{\Lcount}[1]{\textsl {\small#1}}
  151. \newcommand*{\pstyle}[1]{\textsl {#1}}
  152. %    \end{macrocode}
  153. %    We also want the full details.
  154. %    \begin{macrocode}
  155. \begin{document}
  156. \DocInput{letter.dtx}
  157. \PrintIndex
  158. % ^^A\PrintChanges
  159. \end{document}
  160. %</driver>
  161. %    \end{macrocode}
  162. % \fi
  163. %
  164. % \changes{v1.1}{1993/12/18}{Changes to make it work with
  165. %    compatibility mode.}
  166. % \changes{v1.1a}{1993/12/19}{Removed float parms}
  167. %
  168. % \changes{v1.1c}{1994/01/17}{Moved definition of \cs{@textop} to
  169. %    initialization section, to counteract setting of \cs{@texttop} in
  170. %    \cs{raggedbottom}.}
  171. %
  172. % \changes{v1.1d}{1994/01/20}{Corrected margins: Now computed from
  173. %    \cs{paperwidth} and \cs{textwidth}, so that the text is
  174. %    horizontally centered.}
  175. % \changes{v1.1e}{1994/02/03}{Corrected checksum}
  176. %
  177. % \changes{v1.2a}{1994/02/12}{Removed onecolumn and twocolumn options.}
  178. % \changes{v1.2a}{1994/02/12}{Changed label producing commands in .aux
  179. %    file.}
  180. %
  181. % \changes{v1.2b}{1994/02/28}{Moved driver further up.}
  182. %
  183. % \changes{v1.2c}{1994/03/08}{Always write .aux file.}
  184. % \changes{v1.2f}{1994/04/29}{Use LaTeX instead of LaTeX2e in messages}
  185. % \changes{v1.2f}{1994/04/29}{Removed \cs{typeout} message}
  186. % \changes{v1.2g}{1994/05/01}{Removed the use of \cs{fileversion}
  187. %    c.s.}
  188. % \changes{v1.2j}{1994/06/01}{Corrected driver code.}
  189. % \changes{v1.2k}{1994/06/17}{Various documentation enhancements}
  190. % \changes{v1.2p}{1994/12/11}{Use \cs{newcommand*} to define
  191. %    user-level commands that take an argument}
  192. % \changes{v1.2q}{1995/05/17}{cleaned up \cs{changes entries}}
  193. % \changes{v1.2q}{1995/05/18}{replaced \cs{hbox to} by \cs{hb@xt@}}
  194. % \changes{v1.2r}{1995/05/23}{removed a superfluous brace}
  195. %
  196. % \iffalse
  197. % Copyright (C) 1994 LaTeX3 project, Frank Mittelbach
  198. % and Rainer Sch\"opf, all rights reserved.
  199. % \fi
  200. %
  201. % \author{Leslie Lamport and Frank Mittelbach and Rainer Sch\"opf}
  202. %
  203. % \title{Standard Letter Document Class for \LaTeX{} version 2e}
  204. %
  205. %
  206. % \maketitle
  207. % \tableofcontents
  208. %
  209. % \StopEventually
  210. %
  211. %
  212. % \section{Initial Code}
  213. %
  214. %    In this part we define a few commands that are used later on.
  215. %
  216. % \begin{macro}{\@ptsize}
  217. %    This control sequence is used to store the second digit of the
  218. %    pointsize we are typesetting in. So, normally, it's value is one
  219. %    of 0, 1 or 2.
  220. %    \begin{macrocode}
  221. %<*letter>
  222. \newcommand\@ptsize{}
  223. %    \end{macrocode}
  224. % \end{macro}
  225. %
  226. %
  227. %
  228. % \subsection{Setting Paper Sizes}
  229. %
  230. %    The variables |\paperwidth| and |\paperheight| should reflect the
  231. %    physical paper size after trimming. For desk printer output this
  232. %    is usually the real paper size since there is no post-processing.
  233. % \changes{v1.0a}{1993/12/14}{Corrected typo, A4 is not 279 mm high}
  234. %    \begin{macrocode}
  235. \DeclareOption{a4paper}
  236.    {\setlength\paperheight {297mm}%
  237.     \setlength\paperwidth  {210mm}}
  238. \DeclareOption{a5paper}
  239.    {\setlength\paperheight {210mm}%
  240.     \setlength\paperwidth  {148mm}}
  241. \DeclareOption{b5paper}
  242.    {\setlength\paperheight {250mm}%
  243.     \setlength\paperwidth  {176mm}}
  244. \DeclareOption{letterpaper}
  245.    {\setlength\paperheight {11in}%
  246.     \setlength\paperwidth  {8.5in}}
  247. \DeclareOption{legalpaper}
  248.    {\setlength\paperheight {14in}%
  249.     \setlength\paperwidth  {8.5in}}
  250. \DeclareOption{executivepaper}
  251.    {\setlength\paperheight {10.5in}%
  252.     \setlength\paperwidth  {7.25in}}
  253. %    \end{macrocode}
  254. %
  255. % \changes{v1.2o}{1994/08/26}{Added the option \textsf{landscape}}
  256. %    The option \Lopt{landscape} switches the values of |\paperheight|
  257. %    and |\paperwidth|, assuming the dimensions wer given for portrait
  258. %    paper.
  259. %    \begin{macrocode}
  260. \DeclareOption{landscape}
  261.    {\setlength\@tempdima   {\paperheight}%
  262.     \setlength\paperheight {\paperwidth}%
  263.     \setlength\paperwidth  {\@tempdima}}
  264. %    \end{macrocode}
  265. %
  266. % \subsection{Choosing the type size}
  267. %
  268. %    The type size options are handled by defining |\@ptsize| to
  269. %    contain the last digit of the size in question and branching on
  270. %    |\ifcase| statements. This is done for historical reasons to stay
  271. %    compatible with other packages that use the |\@ptsize| variable
  272. %    to select special actions. It makes the declarations of size
  273. %    options less than 10pt difficult, although one can probably use
  274. %    \texttt{9} and \texttt{8} assuming that a class wont define both
  275. %    \Lopt{8pt} and \Lopt{18pt} options.
  276. %
  277. %    \begin{macrocode}
  278. \DeclareOption{10pt}{\renewcommand\@ptsize{0}}
  279. \DeclareOption{11pt}{\renewcommand\@ptsize{1}}
  280. \DeclareOption{12pt}{\renewcommand\@ptsize{2}}
  281. %    \end{macrocode}
  282. %
  283. %
  284. %  \subsection{Two-side or one-side printing}
  285. %
  286. %    Two-sided printing was not supported in the \LaTeX~2.09 version
  287. %    of this document class.
  288. % \changes{v1.2e}{1994/04/28}{Added oneside option and twoside option
  289. %    in native mode}
  290. %    \begin{macrocode}
  291. \if@compatibility
  292.   \DeclareOption{twoside}{\@latexerr{No `twoside' layout for letters}%
  293.                                    \@eha}
  294. \else
  295.   \DeclareOption{twoside}{\@twosidetrue  \@mparswitchtrue}
  296. \fi
  297. %    \end{macrocode}
  298. %
  299. %
  300. %    \begin{macrocode}
  301. \DeclareOption{oneside}{\@twosidefalse \@mparswitchfalse}
  302. %    \end{macrocode}
  303. %
  304. %  \subsection{Draft option}
  305. %
  306. %    If the user requests \Lopt{draft} we show any overfull boxes.
  307. %    We could probably add some more interesting stuff to this option.
  308. %    \begin{macrocode}
  309. \DeclareOption{draft}{\setlength\overfullrule{5pt}}
  310. \DeclareOption{final}{\setlength\overfullrule{0pt}}
  311. %    \end{macrocode}
  312. %
  313. %
  314. %  \subsection{Equation numbering on the left}
  315. %
  316. %    The option \Lopt{leqno} can be used to get the equation numbers
  317. %    on the left side of the equation.
  318. % \changes{v1.1c}{1994/01/17}{Option leqno now read from
  319. %    \file{leqno.clo}.}
  320. %    \begin{macrocode}
  321. \DeclareOption{leqno}{\input{leqno.clo}}
  322. %    \end{macrocode}
  323. %
  324. %  \subsection{Flush left displays}
  325. %
  326. %    The option \Lopt{fleqn} redefines the displayed math environments
  327. %    in such a way that they come out flush left, with an indentation
  328. %    of |\mathindent| from the prevailing left margin.
  329. % \changes{v1.1}{1993/12/18}{Corrected typo in \cs{renewcommand},
  330. %    doubled hash marks.}
  331. % \changes{v1.1c}{1994/01/17}{Option fleqn now read from
  332. %    \file{fleqn.clo}.}
  333. %    \begin{macrocode}
  334. \DeclareOption{fleqn}{\input{fleqn.clo}}
  335. %    \end{macrocode}
  336. %
  337. %
  338. % \section{Executing Options}
  339. %
  340. %    Here we execute the default options to initialize certain
  341. %    variables.
  342. % \changes{v1.2e}{1994/04/28}{Added execution of `oneside' option}
  343. %    \begin{macrocode}
  344. \ExecuteOptions{letterpaper,10pt,oneside,onecolumn,final}
  345. %    \end{macrocode}
  346. %
  347. %    The |\ProcessOptions| command causes the execution of the code
  348. %    for every option \Lopt{foo} which is declared and for which the
  349. %    user typed the \Lopt{foo} option in his |\documentclass| command.
  350. %    For every option \Lopt{bar} he typed, which is not declared, the
  351. %    option is assumed to be a global option.  All options will be
  352. %    passed as document options to any |\usepackage| command in the
  353. %    document preamble.
  354. %    \begin{macrocode}
  355. \ProcessOptions
  356. %    \end{macrocode}
  357. %    Now that all the options have been executed we can load the
  358. %    chosen class option file that contains all size dependant code.
  359. %    \begin{macrocode}
  360. \input{size1\@ptsize.clo}
  361. %    \end{macrocode}
  362. %
  363. %
  364. %  \section{Loading Packages}
  365. %
  366. %  The standard class files do not load additional packages.
  367. %
  368. %
  369. % \section{Document Layout}
  370. % \label{sec:maincode}
  371. %
  372. %  In this section we are finally dealing with the nasty typographical
  373. %  details.
  374. %
  375. % \subsection{Paragraphing}
  376. %
  377. % \begin{macro}{\lineskip}
  378. % \begin{macro}{\normallineskip}
  379. %    These parameters control \TeX's behavior when two lines tend to
  380. %    come too close together.
  381. %    \begin{macrocode}
  382. \setlength\lineskip{1\p@}
  383. \setlength\normallineskip{1\p@}
  384. %    \end{macrocode}
  385. % \end{macro}
  386. % \end{macro}
  387. %
  388. % \begin{macro}{\baselinestretch}
  389. %    This is used as a multiplier for |\baselineskip|. The default is
  390. %    to {\em not\/} stretch the baselines.
  391. %    \begin{macrocode}
  392. \renewcommand\baselinestretch{}
  393. %    \end{macrocode}
  394. % \end{macro}
  395. %
  396. % \begin{macro}{\parskip}
  397. % \begin{macro}{\parindent}
  398. %    |\parskip| gives extra vertical space between paragraphs and
  399. %    |\parindent| is the width of the paragraph indentation.
  400. %    Letters are typeset without paragraph indentation.
  401. %    \begin{macrocode}
  402. \setlength\parskip{0.7em}
  403. \setlength\parindent{0\p@}
  404. %    \end{macrocode}
  405. % \end{macro}
  406. % \end{macro}
  407. %
  408. % \begin{macro}{\@lowpenalty}
  409. % \begin{macro}{\@medpenalty}
  410. % \begin{macro}{\@highpenalty}
  411. %    The commands |\nopagebreak| and |\nolinebreak| put in penalties
  412. %    to discourage these breaks at the point they are put in.
  413. %    They use |\@lowpenalty|, |\@medpenalty| or |\@highpenalty|,
  414. %    dependant on their argument.
  415. %    \begin{macrocode}
  416. \@lowpenalty   51
  417. \@medpenalty  151
  418. \@highpenalty 301
  419. %    \end{macrocode}
  420. % \end{macro}
  421. % \end{macro}
  422. % \end{macro}
  423. %
  424. % \begin{macro}{\clubpenalty}
  425. % \begin{macro}{\widowpenalty}
  426. %    These penalties are used to discourage club and widow lines.
  427. %    Because we use their default values we only show them here,
  428. %    commented out.
  429. %    \begin{macrocode}
  430. % \clubpenalty  150
  431. % \widowpenalty 150
  432. %    \end{macrocode}
  433. % \end{macro}
  434. % \end{macro}
  435. %
  436. % \begin{macro}{\displaywidowpenalty}
  437. % \begin{macro}{\predisplaypenalty}
  438. % \begin{macro}{\postdisplaypenalty}
  439. %    Discourage (but not so much) widows in front of a math display
  440. %    and forbid breaking directly in front of a display. Allow break
  441. %    after a display without a penalty. Again the default values are
  442. %    used, therefore we only show them here.
  443. %    \begin{macrocode}
  444. % \displaywidowpenalty 50
  445. % \predisplaypenalty   10000
  446. % \postdisplaypenalty  0
  447. %    \end{macrocode}
  448. % \end{macro}
  449. % \end{macro}
  450. % \end{macro}
  451. %
  452. % \begin{macro}{\interlinepenalty}
  453. %    Allow the breaking of a page in the middle of a paragraph.
  454. %    \begin{macrocode}
  455. % \interlinepenalty 0
  456. %    \end{macrocode}
  457. % \end{macro}
  458. %
  459. %
  460. % \begin{macro}{\brokenpenalty}
  461. %    We allow the breaking of a page after a hyphenated line.
  462. %    \begin{macrocode}
  463. % \brokenpenalty 0
  464. %    \end{macrocode}
  465. % \end{macro}
  466. %
  467. %
  468. % \subsection{Page Layout}
  469. %
  470. %    All margin dimensions are measured from a point one inch from the
  471. %    top and lefthand side of the page.
  472. %
  473. % \subsubsection{Vertical spacing}
  474. %
  475. % \begin{macro}{\headheight}
  476. % \begin{macro}{\headsep}
  477. %    The |\headheight| is the height of the box that will contain the
  478. %    running head. The |\headsep| is the distance between the bottom
  479. %    of the running head and the top of the text. |\topskip| is the
  480. %    |\baselineskip| for the first line on a page, its value depends
  481. %    on the size option that was specified. Therefore it is
  482. %    initialized in one of the \file{size1x.clo} files.
  483. %    \begin{macrocode}
  484. \setlength\headheight{12\p@}
  485. \setlength\headsep   {45\p@}
  486. %    \end{macrocode}
  487. % \end{macro}
  488. % \end{macro}
  489. %
  490. % \begin{macro}{\footskip}
  491. %    The distance from the baseline of the box which contains the
  492. %    running footer to the baseline of last line of text is controlled
  493. %    by the |\footskip|.
  494. %    Bottom of page:
  495. %    \begin{macrocode}
  496. \setlength\footskip{25\p@}
  497. %    \end{macrocode}
  498. % \end{macro}
  499. %
  500. % \changes{v1.2n}{1994/07/13}{Setting of \cs{maxdepth} and
  501. %    \cs{@maxdepth} already happens in the size.. files, removed
  502. %    here}
  503. %
  504. % \subsubsection{The dimension of text}
  505. %
  506. % \begin{macro}{\textwidth}
  507. %    When we are in compatibility mode we have to make sure that the
  508. %    dimensions of the printed area are not different from what the
  509. %    user was used to see.
  510. %
  511. % \changes{v1.2n}{1994/07/13}{Setting \cs{textwidth} to a fixed value
  512. %    should only happen in compatibility mode}
  513. %    \begin{macrocode}
  514. \if@compatibility
  515.   \setlength\textwidth{365\p@}
  516. %    \end{macrocode}
  517. % \end{macro}
  518. %
  519. % \begin{macro}{\textheight}
  520. %    Now that we have computed the width of the text, we have to take
  521. %    care of the height. The |\textheight| is the height of text
  522. %    (including footnotes and figures, excluding running head and
  523. %    foot).
  524. % \changes{v1.2n}{1994/07/13}{Setting \cs{textheight} to a fixed value
  525. %    should only happen in compatibility mode}
  526. %    \begin{macrocode}
  527.   \setlength\textheight{505\p@}
  528. \fi
  529. %    \end{macrocode}
  530. %    In native mode we use the dimensions as they were computed by one
  531. %    of the \Lopt{xxpt} options, together with one of the
  532. %    \Lopt{..paper} options.
  533. % \end{macro}
  534. %
  535. % \subsubsection{Margins}
  536. %
  537. % \begin{macro}{\oddsidemargin}
  538. % \begin{macro}{\evensidemargin}
  539. % \begin{macro}{\marginparwidth}
  540. % \changes{v1.1d}{1994/01/20}{Corrected margins: Now computed from
  541. %    \cs{paperwidth} and \cs{textwidth}.}  The values of
  542. %    |\oddsidemargin| and |\evensidemargin| are computed from those of
  543. %    |\paperwidth| and |\textwidth|.
  544. % \changes{v1.2n}{1994/07/13}{Added fixed values for these parameters
  545. %    in compatibillity mode}
  546. %    \begin{macrocode}
  547. \if@compatibility
  548.   \setlength\oddsidemargin{53pt}
  549.   \setlength\evensidemargin{53pt}
  550.   \setlength\marginparwidth{90pt}
  551. \else
  552.   \setlength\@tempdima{\paperwidth}
  553.   \addtolength\@tempdima{-2in}
  554.   \addtolength\@tempdima{-\textwidth}
  555.   \setlength\oddsidemargin   {.5\@tempdima}
  556.   \setlength\evensidemargin  {\oddsidemargin}
  557.   \setlength\marginparwidth  {90\p@}
  558. \fi
  559. %    \end{macrocode}
  560. % \end{macro}
  561. % \end{macro}
  562. % \end{macro}
  563. %
  564. % \begin{macro}{\marginparsep}
  565. % \begin{macro}{\marginparpush}
  566. %    The horizontal space between the main text and marginal notes is
  567. %    determined by |\marginparsep|, the minimum vertical separation
  568. %    between two marginal notes is controlled by |\marginparpush|.
  569. %    \begin{macrocode}
  570. \setlength\marginparsep {11\p@}
  571. \setlength\marginparpush{5\p@}
  572. %    \end{macrocode}
  573. % \end{macro}
  574. % \end{macro}
  575. %
  576. % \begin{macro}{\topmargin}
  577. %    The |\topmargin| is the distance between the top of `the
  578. %    printable area' --which is 1 inch below the top of the paper--
  579. %    and the top of the box which contains the running head.
  580. %
  581. %    It can now be computed from the values set above.
  582. %    \begin{macrocode}
  583. \setlength\topmargin{27pt}
  584. %    \end{macrocode}
  585. % \end{macro}
  586. %
  587. %
  588. % \subsubsection{Footnotes}
  589. %
  590. % \begin{macro}{\footnotesep}
  591. %    |\footnotesep| is the height of the strut placed at the beginning
  592. %    of every footnote. It equals the  height of a normal
  593. %    |\footnotesize| strut in this
  594. %    class, thus no extra space occurs between footnotes.
  595. %    \begin{macrocode}
  596. \setlength\footnotesep{12\p@}
  597. %    \end{macrocode}
  598. % \end{macro}
  599. %
  600. % \begin{macro}{\footins}
  601. %    |\skip\footins| is the space between the last line of the main
  602. %    text and the top of the first footnote.
  603. %    \begin{macrocode}
  604. \setlength{\skip\footins}{10\p@ \@plus 2\p@ \@minus 4\p@}
  605. %    \end{macrocode}
  606. % \end{macro}
  607. %
  608. %
  609. % \subsection{Page Styles}
  610. %
  611. %    The page style \pstyle{foo} is defined by defining the command
  612. %    |\ps@foo|.   This command should make only local definitions.
  613. %    There should be no stray spaces in the definition, since they
  614. %    could lead to mysterious extra spaces in the output (well, that's
  615. %    something that should be always avoided).
  616. %
  617. % \begin{macro}{\@evenhead}
  618. % \begin{macro}{\@oddhead}
  619. % \begin{macro}{\@evenfoot}
  620. % \begin{macro}{\@oddfoot}
  621. %    The |\ps@...| command defines the macros |\@oddhead|,
  622. %    |\@oddfoot|, |\@evenhead|, and |\@evenfoot| to define the running
  623. %    heads and feet---e.g., |\@oddhead| is the macro to produce the
  624. %    contents of the heading box for odd-numbered pages.  It is called
  625. %    inside an |\hbox| of width |\textwidth|.
  626. % \end{macro}
  627. % \end{macro}
  628. % \end{macro}
  629. % \end{macro}
  630. %
  631. % \subsubsection{Marking conventions}
  632. %
  633. %    To make headings determined by the sectioning commands, the page
  634. %    style defines the commands |\chaptermark|, |\sectionmark|,
  635. %    \ldots, where |\chaptermark{|\meta{text}|}| is called by
  636. %    |\chapter| to set a mark, and so on.
  637. %
  638. %    The |\...mark| commands and the |\...head| macros are defined
  639. %    with the help of the following macros.  (All the |\...mark|
  640. %    commands should be initialized to no-ops.)
  641. %
  642. %    \LaTeX{} extends \TeX's |\mark| facility by producing two kinds
  643. %    of marks, a `left' and a `right' mark, using the following
  644. %    commands:
  645. %    \begin{flushleft}
  646. %     |\markboth{|\meta{left}|}{|\meta{right}|}|: Adds both marks.
  647. %
  648. %     |\markright{|\meta{right}|}|: Adds a `right' mark.
  649. %
  650. %     |\leftmark|: Used in the |\@oddhead|, |\@oddfoot|, |\@evenhead|
  651. %                  or |\@evenfoot| macros, it gets the current `left'
  652. %                  mark.  |\leftmark| works like \TeX's |\botmark|
  653. %                  command.
  654. %
  655. %     |\rightmark|: Used in the |\@oddhead|, |\@oddfoot|, |\@evenhead|
  656. %                   or  |\@evenfoot| macros, it gets the current
  657. %                   `right' mark. |\rightmark| works like \TeX's
  658. %                   |\firstmark| command.
  659. %    \end{flushleft}
  660. %
  661. %    The marking commands work reasonably well for right marks
  662. %    `numbered within' left marks--e.g., the left mark is changed by a
  663. %    |\chapter| command and the right mark is changed by a |\section|
  664. %    command.  However, it does produce somewhat anomalous results if
  665. %    two |\markboth|'s occur on the same page.
  666. %
  667. %
  668. %    Commands like |\tableofcontents| that should set the marks in some
  669. %    page styles use a |\@mkboth| command, which is |\let| by the
  670. %    pagestyle command (|\ps@...|)  to |\markboth| for setting the
  671. %    heading or to |\@gobbletwo| to do nothing.
  672. %
  673. %
  674. %    \begin{macrocode}
  675. % %%%\mark{{}{}}   % Initializes TeX's marks   <--- can vanish
  676. %    \end{macrocode}
  677. %
  678. % \subsubsection{Defining the page styles}
  679. % \label{sec:pagestyle}
  680. %
  681. %    The pagestyles \pstyle{empty} and \pstyle{plain} are defined in
  682. %    \file{latex.tex}.
  683. %
  684. % \begin{macro}{\ps@headings}
  685. %    The definition of the page style \pstyle{headings} has to be
  686. %    different for two sided printing than it is for one sided
  687. %    printing.
  688. %
  689. % \changes{v1.2e}{1994/04/28}{Added twoside support}
  690. %    \begin{macrocode}
  691. \if@twoside
  692.   \def\ps@headings{%
  693. %    \end{macrocode}
  694. %    The running feet are empty in this page style.
  695. %    \begin{macrocode}
  696.       \let\@oddfoot\@empty\let\@evenfoot\@empty
  697. %    \end{macrocode}
  698. %    The running head contains some information about this letter. The
  699. %    head is the same for even and odd pages.
  700. % \changes{v1.2i}{1994/05/12}{Made running heads the same on odd and
  701. %    even pages}
  702. % \changes{v1.2k}{1994/06/17}{Added a missing brace}
  703. %    \begin{macrocode}
  704.       \def\@oddhead{\slshape\headtoname{} \ignorespaces\toname
  705.                     \hfil \@date
  706.                     \hfil \pagename{} \thepage}%
  707.       \let\@evenhead\@oddhead}
  708. %    \end{macrocode}
  709. %    For one sided printing we don't need to define |\@evenhead| so
  710. %    the definition is somewhat simpler.
  711. %    \begin{macrocode}
  712. \else
  713.   \def\ps@headings{%
  714.       \let\@oddfoot\@empty
  715.       \def\@oddhead{\slshape\headtoname{} \ignorespaces\toname
  716.                     \hfil \@date
  717.                     \hfil \pagename{} \thepage}}
  718. \fi
  719. %    \end{macrocode}
  720. % \end{macro}
  721. %
  722. %
  723. % \begin{macro}{\ps@empty}
  724. %    The definition of the page style \pstyle{empty} is simple:
  725. %    No running head or foot at all.
  726. % \changes{v1.2e}{1994/04/28}{Also make even feet and head empty}
  727. %    \begin{macrocode}
  728. \def\ps@empty{%
  729.       \let\@oddfoot\@empty\let\@oddhead\@empty
  730.       \let\@evenfoot\@empty\let\@evenhead\@empty}
  731. %    \end{macrocode}
  732. % \end{macro}
  733. %
  734. % \begin{macro}{\ps@firstpage}
  735. %    The page style \pstyle{firstpage} puts the telephone number
  736. %    in the proper place for the letterhead. It should be adapted
  737. %    to site conventions. The size of the number is determined
  738. %    depending on the main size.
  739. %    \begin{macrocode}
  740. \def\ps@firstpage{%
  741.      \let\@oddhead\@empty
  742.      \def\@oddfoot{\raisebox{-45\p@}[\z@]{%
  743.         \hb@xt@\textwidth{\hspace*{100\p@}%
  744.           \ifcase \@ptsize\relax
  745.              \normalsize
  746.           \or
  747.              \small
  748.           \or
  749.              \footnotesize
  750.           \fi
  751.         \fromlocation \hfill \telephonenum}}\hss}}
  752. %    \end{macrocode}
  753. % \end{macro}
  754. %
  755. % \begin{macro}{\ps@plain}
  756. %    The definition of the page style \pstyle{plain} is again simple.
  757. % \changes{v1.2e}{1994/04/28}{Added definition of \cs{@evenfoot}
  758. %    because of twoside option}
  759. % \changes{v1.2s}{1995/05/25}{replace \cs{rmfamily} with
  760. %    \cs{normalfont} (PR 1578)}
  761. %    \begin{macrocode}
  762. \def\ps@plain{%
  763.       \let\@oddhead\@empty
  764.       \def\@oddfoot{\normalfont\hfil\thepage\hfil}%
  765.       \def\@evenfoot{\normalfont\hfil\thepage\hfil}}
  766. %    \end{macrocode}
  767. % \end{macro}
  768. %
  769. %
  770. %
  771. % \section{Document Markup}
  772. %
  773. % \subsection{Global Declarations}
  774. %
  775. % \begin{macro}{\name}
  776. % \begin{macro}{\signature}
  777. % \begin{macro}{\address}
  778. % \begin{macro}{\location}
  779. % \begin{macro}{\telephone}
  780. % The following declarations, shown with examples, give information
  781. % about the sender:
  782. % \begin{itemize}
  783. %   \item |\name{Dr. L. User}| : to be used for the return address on
  784. %          the envelope.
  785. %    \begin{macrocode}
  786. \newcommand*{\name}[1]{\def\fromname{#1}}
  787. %    \end{macrocode}
  788. %   \item |\signature{Larry User}| : goes after the closing.
  789. %    \begin{macrocode}
  790. \newcommand*{\signature}[1]{\def\fromsig{#1}}
  791. %    \end{macrocode}
  792. %   \item |\address{3245 Foo St.\\Gnu York}| : used as the return
  793. %          address in the
  794. %          letter and on the envelope.  If not declared, then an
  795. %          institutional standard address is used.
  796. %    \begin{macrocode}
  797. \newcommand*{\address}[1]{\def\fromaddress{#1}}
  798. %    \end{macrocode}
  799. %   \item |\location{Room 374}| : Acts as modifier to the standard
  800. %          institutional address.
  801. %    \begin{macrocode}
  802. \newcommand*{\location}[1]{\def\fromlocation{#1}}
  803. %    \end{macrocode}
  804. %   \item |\telephone{(415)123-4567}| : Just in case some style puts it
  805. %          on the letter.
  806. % \changes{v1.2m}{1994/06/23}{Removed typo (\#[] instead of [1])}
  807. %    \begin{macrocode}
  808. \newcommand*{\telephone}[1]{\def\telephonenum{#1}}
  809. %    \end{macrocode}
  810. % \end{itemize}
  811. % \end{macro}
  812. % \end{macro}
  813. % \end{macro}
  814. % \end{macro}
  815. % \end{macro}
  816. %
  817. % \begin{macro}{\fromname}
  818. % \begin{macro}{\fromsig}
  819. % \begin{macro}{\fromaddress}
  820. % \begin{macro}{\fromlocation}
  821. % \begin{macro}{\telephonenum}
  822. %    We make sure that the internal control sequences that are used to
  823. %    store the information exist and are empty.
  824. %    \begin{macrocode}
  825. \name{}
  826. \signature{}
  827. \address{}
  828. \location{}
  829. \telephone{}
  830. %    \end{macrocode}
  831. % \end{macro}
  832. % \end{macro}
  833. % \end{macro}
  834. % \end{macro}
  835. % \end{macro}
  836. %
  837. % \begin{macro}{\makelabels}
  838. %     The |\makelabels| declaration causes mailing labels to be made.
  839. %    \begin{macrocode}
  840. \newcommand*{\makelabels}{%
  841. %    \end{macrocode}
  842. %    At the beginning of the document, we need to activate the
  843. %    |\@mlabel| and |\@startlabels| commands, as well as  write
  844. %    |\@startlabels| to the |.aux| file.
  845. %    \begin{macrocode}
  846.   \AtBeginDocument{%
  847.      \let\@startlabels\startlabels
  848.      \let\@mlabel\mlabel
  849.      \if@filesw
  850.        \immediate\write\@mainaux{\string\@startlabels}\fi}%
  851. %    \end{macrocode}
  852. %    At the end of the document we need to write |\clearpage| to the
  853. %    |.aux| file.
  854. %    \begin{macrocode}
  855.   \AtEndDocument{%
  856.      \if@filesw\immediate\write\@mainaux{\string\clearpage}\fi}}
  857. %    \end{macrocode}
  858. %    |\makelabels| is allowed only before the |\begin{document}|
  859. %    command.
  860. %    \begin{macrocode}
  861. \@onlypreamble\makelabels
  862. %    \end{macrocode}
  863. % \end{macro}
  864. %
  865. % \subsection{The generic letter commands}
  866. %
  867. % \begin{environment}{letter}
  868. %     The letter environment creates a new letter, starting from page 1.
  869. %     (The first page is unnumbered.)  It has a single argument, which
  870. %     is the addressee and his address, as in
  871. %\begin{verbatim}
  872. %  \begin{letter}{Sam Jones \\
  873. %                 Institute for Retarded Study\\
  874. %                 Princeton, N.J.}
  875. %\end{verbatim}
  876. %     Local declarations, such as |\address|, can follow the
  877. %     |\begin{letter}|.
  878. % \changes{v1.2e}{1994/04/28}{When printing twosided a new letter
  879. %    shouldn't start on the back of the previous one. Added insertion
  880. %    of a blank page when necessary.}
  881. %    \begin{macrocode}
  882. \newenvironment{letter}[1]
  883.   {\newpage
  884.     \if@twoside \ifodd\c@page
  885.                 \else\thispagestyle{empty} \hbox{}\newpage\fi
  886.     \fi
  887.     \c@page\@ne
  888.     \interlinepenalty=200 % smaller than the TeXbook value
  889. %    \end{macrocode}
  890. %    The |\leavevmode| and |\ignorespaces| commands are there for
  891. %    protecting against an empty argument.
  892. %    \begin{macrocode}
  893.     \@processto{\leavevmode\ignorespaces #1}}
  894. %    \end{macrocode}
  895. %    The end of the environment possibly writes the address
  896. %    information on the \file{.aux} file.
  897. % \changes{v1.2p}{1994/12/11}{No longer redefine \cs{protect} but use
  898. %    one of the available settings}
  899. %    \begin{macrocode}
  900.   {\stopletter\@@par\pagebreak\@@par
  901.     \if@filesw
  902.       \begingroup
  903.         \let\\=\relax
  904.         \let\protect\@unexpandable@protect
  905.         \immediate\write\@auxout{%
  906.           \string\@mlabel{\returnaddress}{\toname\\\toaddress}}%
  907.       \endgroup
  908.     \fi}
  909. %    \end{macrocode}
  910. % \end{environment}
  911. %
  912. %
  913. % \begin{macro}{\@processto}
  914. % \begin{macro}{\@xproc}
  915. % \begin{macro}{\@yproc}
  916. %    |\@processto| gets the |\toname| and |\toaddress| from the letter
  917. %    environment's macro argument. |\@xproc| and |\@yproc| are auxiliary
  918. %    macros.
  919. %    \begin{macrocode}
  920. \long\def\@processto#1{\@xproc #1\\@@@\ifx\toaddress\@empty
  921.     \else \@yproc #1@@@\fi}
  922. \long\def\@xproc #1\\#2@@@{\def\toname{#1}\def\toaddress{#2}}
  923. \long\def\@yproc #1\\#2@@@{\def\toaddress{#2}}
  924. %    \end{macrocode}
  925. % \end{macro}
  926. % \end{macro}
  927. % \end{macro}
  928. %
  929. %
  930. % \subsubsection{Page breaking control}
  931. %
  932. % \begin{macro}{\stopbreaks}
  933. %    When the command |\stopbreaks| is issued no page breaks should
  934. %    occur until |\startbreaks| is called.
  935. %    \begin{macrocode}
  936. \newcommand*{\stopbreaks}{\interlinepenalty \@M
  937.    \def\par{\@@par\nobreak}\let\\=\@nobreakcr
  938.    \let\vspace\@nobreakvspace}
  939. %    \end{macrocode}
  940. % \end{macro}
  941. %
  942. % \begin{macro}{\nobreakvspace}
  943. % \begin{macro}{\nobreakvspacex}
  944. % \begin{macro}{\nobreakcr}
  945. %    These are needed by |\stopbreaks|
  946. %    \begin{macrocode}
  947. \def\@nobreakvspace{\@ifstar{\@nobreakvspacex}{\@nobreakvspacex}}
  948.  
  949. \def\@nobreakvspacex#1{\ifvmode\nobreak\vskip #1\relax\else
  950.                \@bsphack\vadjust{\nobreak\vskip #1}\@esphack\fi}
  951.  
  952. \def\@nobreakcr{\vadjust{\penalty\@M}\@ifstar{\@xnewline}{\@xnewline}}
  953. %    \end{macrocode}
  954. % \end{macro}
  955. % \end{macro}
  956. % \end{macro}
  957. %
  958. % \begin{macro}{\startbreaks}
  959. %    This cancels the effect of |\stopbreaks|.
  960. %    \begin{macrocode}
  961. \newcommand*{\startbreaks}{\let\\=\@normalcr
  962.    \interlinepenalty 200\def\par{\@@par\penalty 200\relax}}
  963. %    \end{macrocode}
  964. % \end{macro}
  965. %
  966. %
  967. % \begin{macro}{\longindentation}
  968. %    The size of the indent to use before the closing of the letter.
  969. %    \begin{macrocode}
  970. \newdimen\longindentation
  971. \longindentation=.5\textwidth
  972. %    \end{macrocode}
  973. % \end{macro}
  974. %
  975. % \begin{macro}{\indentedwidth}
  976. %    The width of the closing of the letter.
  977. %    \begin{macrocode}
  978. \newdimen\indentedwidth
  979. \indentedwidth=\textwidth
  980. \advance\indentedwidth -\longindentation
  981. %    \end{macrocode}
  982. % \end{macro}
  983. %
  984. % \begin{macro}{\opening}
  985. %     Text is begun with the |\opening| command, whose argument
  986. %     generates the salutation, as in
  987. %\begin{verbatim}
  988. %      \opening{Dear Henry,}
  989. %\end{verbatim}
  990. %    This should produce everything up to and including the `Dear Henry,'
  991. %    and a \par command that follows. Since there's a |\vfil| at the
  992. %    bottom of every page, it can add vertical fill to position a short
  993. %    letter. It should use the following commands:
  994. %   \begin{itemize}
  995. %   \item |\toname| : name part of `to' address.
  996. %                     Will be one line long. 
  997. %   \item |\toaddress| : address part of `to' address.
  998. %                        The lines separated by |\\|.
  999. %   \item |\fromname| : name of sender.
  1000. %   \item |\fromaddress| : argument of current |\address|
  1001. %     declaration-- null if none.  Should use standard institutional
  1002. %     address if null. 
  1003. %   \item |\fromlocation| : argument of current |\location|
  1004. %     declaration--null if none.
  1005. %   \item |\telephonenum| : argument of current |\telephone|
  1006. %     declaration--null if none.
  1007. %    \end{itemize}
  1008. %    \begin{macrocode}
  1009. \newcommand*{\opening}[1]{\ifx\@empty\fromaddress
  1010.   \thispagestyle{firstpage}%
  1011.     {\raggedleft\@date\par}%
  1012.   \else  % home address
  1013.     \thispagestyle{empty}%
  1014.     {\raggedleft\begin{tabular}{l}\ignorespaces
  1015.       \fromaddress \\*[2\parskip]%
  1016.       \@date \end{tabular}\par}%
  1017.   \fi
  1018.   \vspace{2\parskip}%
  1019.   {\raggedright \toname \\ \toaddress \par}%
  1020.   \vspace{2\parskip}%
  1021.   #1\par\nobreak}
  1022. %    \end{macrocode}
  1023. % \end{macro}
  1024. %
  1025. % \begin{macro}{\closing}
  1026. %     The body of the letter follows, ended by a |\closing| command,
  1027. %     as in
  1028. %\begin{verbatim}
  1029. %            \closing{Yours truly,}
  1030. %\end{verbatim}
  1031. %     This command generates the closing matter, and the signature.
  1032. %     An obvious thing to do is to use a |\parbox| for the closing
  1033. %     and the signature.  Should use the following:
  1034. %    \begin{itemize}
  1035. %      \item |\fromsig| : argument of current |\signature| declaration
  1036. %                   or, if null, the |\fromname|.
  1037. %      \item |\stopbreaks| : a macro that inhibits page breaking.
  1038. %    \end{itemize}
  1039. %    \begin{macrocode}
  1040. \newcommand{\closing}[1]{\par\nobreak\vspace{\parskip}%
  1041.   \stopbreaks
  1042.   \noindent
  1043.   \ifx\@empty\fromaddress\else
  1044.   \hspace*{\longindentation}\fi
  1045.   \parbox{\indentedwidth}{\raggedright
  1046.        \ignorespaces #1\\[6\medskipamount]%
  1047.        \ifx\@empty\fromsig
  1048.            \fromname
  1049.        \else \fromsig \fi\strut}%
  1050.    \par}
  1051. %    \end{macrocode}
  1052. % \end{macro}
  1053. %
  1054. % \begin{macro}{\smallskipamount}
  1055. % \begin{macro}{\mdeskipamount}
  1056. % \begin{macro}{\bigskipamount}
  1057. %   Of these three, only |\medskipmount| is actually used above.
  1058. %    \begin{macrocode}
  1059. %\smallskipamount=.5\parskip
  1060. \medskipamount=\parskip
  1061. %\bigskipamount=2\parskip
  1062. %    \end{macrocode}
  1063. % \end{macro}
  1064. % \end{macro}
  1065. % \end{macro}
  1066. %
  1067. % \begin{macro}{\cc}
  1068. % \begin{macro}{\encl}
  1069. % \begin{macro}{\ps}
  1070. %    After the |\closing| you can put arbitrary stuff, which is typeset
  1071. %    with zero |\parindent| and no page breaking.  Commands designed
  1072. %    for use after the closing are:
  1073. %    \begin{verbatim}
  1074. %  \cc{Tinker\\Evers\\Chance}
  1075. %\end{verbatim}
  1076. %    which produces:\\
  1077. %    \begin{tabular}{ll}
  1078. %        cc: & Tinker\\
  1079. %            & Evers\\
  1080. %            & Chance
  1081. %    \end{tabular}\\
  1082. %    Note the obvious use of |\parbox|.
  1083. % \changes{v1.2s}{1995/05/25}{replace \cs{reset@font} with
  1084. %    \cs{normalfont}; remove \cs{rm}}
  1085. %    \begin{macrocode}
  1086. \newcommand*{\cc}[1]{%
  1087.   \par\noindent
  1088.   \parbox[t]{\textwidth}{%
  1089.     \@hangfrom{\normalfont\ccname: }%
  1090.     \ignorespaces #1\strut}\par}
  1091. %    \end{macrocode}
  1092. %\begin{verbatim}
  1093. %  \encl{Foo(2)\\Bar}
  1094. %\end{verbatim}
  1095. %    which produces:\\
  1096. %    \begin{tabular}{ll}
  1097. %        encl: & Foo(2)\\
  1098. %              & Bar
  1099. %    \end{tabular}
  1100. %    \begin{macrocode}
  1101. \newcommand*{\encl}[1]{%
  1102.   \par\noindent
  1103.   \parbox[t]{\textwidth}{%
  1104.     \@hangfrom{\normalfont\enclname: }%
  1105.     \ignorespaces #1\strut}\par}
  1106. %    \end{macrocode}
  1107. %
  1108. %    The only thing |\ps| needs to do is call |\startbreaks|,
  1109. %        which allows page breaking again.
  1110. %    \begin{macrocode}
  1111. \newcommand*{\ps}{\par\startbreaks}
  1112. %    \end{macrocode}
  1113. % \end{macro}
  1114. % \end{macro}
  1115. % \end{macro}
  1116. %
  1117. %
  1118. % \begin{macro}{\stopletter}
  1119. %     The |\stopletter| command is called by |\endletter| to do the
  1120. %     following:
  1121. %    \begin{itemize}
  1122. %     \item Add any desired  fill  or other material at the end of the
  1123. %       letter.
  1124. %     \item Define |\returnaddress| to be the return address for the
  1125. %       mailing
  1126. %      label.  More precisely, it is the first argument of the |\mlabel|
  1127. %       command described below. It should be defined to null if the
  1128. %       return address doesn't appear on the labels.  Any command,
  1129. %       other than |\\|, that should not be expanded until the |\mlabel|
  1130. %       command is actually executed must be preceded by |\protect|.
  1131. %       Whenever possible, |\protect| commands in the definition of
  1132. %       |\returnaddress|---it's much more efficient that way.  In
  1133. %       particular, when the standard return address is used, you
  1134. %       should define |\returnaddress| to something like
  1135. %       |\protect\standardreturnaddress|.
  1136. %    \end{itemize}
  1137. %    \begin{macrocode}
  1138. \newcommand*{\stopletter}{}
  1139. %    \end{macrocode}
  1140. % \end{macro}
  1141. %
  1142. % \subsection{Customizing the labels}
  1143. %
  1144. %    Commands for generating the labels are put on the \file{.aux} file,
  1145. %    which is read in and processed by the |\end{document}| command.
  1146. %    You have to define the following two commands:
  1147. %    \begin{itemize}
  1148. %    \item |\startlabels| : Should reset the page layout parameters if
  1149. %      necessary. 
  1150. %    \item |\mlabel\marg{return address}\marg{to adress}| : Command to
  1151. %      generate a single label.
  1152. %    \end{itemize}
  1153. %
  1154. %     
  1155. %
  1156. % \begin{macro}{\returnaddress}
  1157. %    The return address for the mailing labels can be stored in this
  1158. %    macro.
  1159. %    \begin{macrocode}
  1160. \newcommand*{\returnaddress}{}
  1161. %    \end{macrocode}
  1162. % \end{macro}
  1163. %
  1164. % \begin{macro}{\labelcount}
  1165. %    A register to count the labels 
  1166. %    \begin{macrocode}
  1167. \newcount\labelcount
  1168. %    \end{macrocode}
  1169. % \end{macro}
  1170. %
  1171. % \begin{macro}{\startlabels}
  1172. %     The following |\startlabels| command sets things up for
  1173. %     producing labels in two columns of five 2" $\times$ 4-1/4"
  1174. %     labels each, suitable for reproducing onto Avery brand number
  1175. %     5352 address labels.
  1176. % \changes{v1.2q}{1995/03/14}{changed value of \cs{columnsep} by 1pt}
  1177. %    \begin{macrocode}
  1178. \newcommand*{\startlabels}{\labelcount\z@
  1179.   \pagestyle{empty}%
  1180.   \let\@texttop\relax
  1181.   \topmargin -50\p@
  1182.   \headsep \z@
  1183.   \oddsidemargin -35\p@
  1184.   \evensidemargin -35\p@
  1185.   \textheight 10in
  1186.   \@colht\textheight  \@colroom\textheight \vsize\textheight
  1187.   \textwidth 550\p@
  1188.   \columnsep 26\p@
  1189.   \ifcase \@ptsize\relax
  1190.     \normalsize
  1191.   \or
  1192.     \small
  1193.   \or
  1194.     \footnotesize
  1195.   \fi
  1196.   \baselineskip \z@
  1197.   \lineskip \z@
  1198.   \boxmaxdepth \z@
  1199.   \parindent \z@
  1200.   \twocolumn\relax}
  1201. %    \end{macrocode}
  1202. % \end{macro}
  1203. %
  1204. % \begin{macro}{\@startlabels}
  1205. %    |\@startlabels| is the command name that is written to the |.aux|
  1206. %    file. It is a no-op at first, and defined to be the same as
  1207. %    |\startlabels| in the |\begin{document}| hook.
  1208. %    \begin{macrocode}
  1209. \let\@startlabels=\relax
  1210. %    \end{macrocode}
  1211. % \end{macro}
  1212. %
  1213. % \begin{macro}{\mlabel}
  1214. %    This command prints an address label; it is used when the user
  1215. %    specified |\makelabels| in the preamble of his document. The
  1216. %    command |\mlabel| takes two arguments; the second argument is
  1217. %    supposed to be the address; the first argument can be used to
  1218. %    print a return address. In this document class we ignore the
  1219. %    first argument. Also the labels are supposed to be 2~inch high
  1220. %    and 3.6~inch wide. When your address labels have a different you
  1221. %    will have to defined your own |\mlabel| command.
  1222. % \changes{v1.2p}{1994/12/11}{Redefined \cs{mlabel} to not use the
  1223. %    \cs{setbox} primitive}
  1224. % \changes{v1.2q}{1995/03/14}{changed width of the labels slightly to
  1225. %    prevent \LaTeX\ stuffing two on each line}
  1226. %    \begin{macrocode}
  1227. \newcommand*{\mlabel}[2]{%
  1228.   \parbox[b][2in][c]{262\p@}{\strut\ignorespaces #2}%
  1229.   }
  1230. %    \end{macrocode}
  1231. % \end{macro}
  1232. %
  1233. % \begin{macro}{\@mlabel}
  1234. %    |\@mlabel| is written to the \file{.aux} file in place of |\mlabel|.
  1235. %    That allows to define it as a no-op per default, and activate it
  1236. %    in the |\begin{document}| hook.
  1237. %    \begin{macrocode}
  1238. \let\@mlabel=\@gobbletwo
  1239. %    \end{macrocode}
  1240. % \end{macro}
  1241. %
  1242. %
  1243. % \subsection{Lists}
  1244. %
  1245. % \subsubsection{General List Parameters}
  1246. %
  1247. %    The following commands are used to set the default values for the
  1248. %    list environment's parameters. See the \LaTeX{} manual for an
  1249. %    explanation of the meanings of the parameters.  Defaults for the
  1250. %    list environment are set as follows.  First, |\rightmargin|,
  1251. %    |\listparindent| and |\itemindent| are set to 0pt.  Then, for a
  1252. %    \texttt{K}th level list, the command |\@listK| is called, where
  1253. %    `\texttt{K}' denotes `\texttt{i}', `\texttt{ii}', ... ,
  1254. %    `\texttt{vi}'.  (I.e., |\@listiii| is called for a third-level
  1255. %    list.)  By convention, |\@listK| should set |\leftmargin| to
  1256. %    |\leftmarginK|.
  1257. %
  1258. % \begin{macro}{\leftmargin}
  1259. % \begin{macro}{\leftmargini}
  1260. % \begin{macro}{\leftmarginii}
  1261. % \begin{macro}{\leftmarginiii}
  1262. % \begin{macro}{\leftmarginiv}
  1263. % \begin{macro}{\leftmarginv}
  1264. % \begin{macro}{\leftmarginvi}
  1265. % For efficiency, level-one list's values are defined at top level, and
  1266. % |\@listi| is defined to set only |\leftmargin|.
  1267. %    \begin{macrocode}
  1268. \setlength\leftmargini  {2.5em}
  1269. %    \end{macrocode}
  1270. %    The following three are calculated so  that they are larger than
  1271. %    the sum of |\labelsep| and the width of the default labels (which
  1272. %    are `(m)', `vii.' and `M.').
  1273. %    \begin{macrocode}
  1274. \setlength\leftmarginii  {2.2em}
  1275. \setlength\leftmarginiii {1.87em}
  1276. \setlength\leftmarginiv  {1.7em}
  1277. \setlength\leftmarginv  {1em}
  1278. \setlength\leftmarginvi {1em}
  1279. %    \end{macrocode}
  1280. %    Here we set the top level leftmargin.
  1281. %    \begin{macrocode}
  1282. \setlength\leftmargin    {\leftmargini}
  1283. %    \end{macrocode}
  1284. % \end{macro}
  1285. % \end{macro}
  1286. % \end{macro}
  1287. % \end{macro}
  1288. % \end{macro}
  1289. % \end{macro}
  1290. % \end{macro}
  1291. %
  1292. % \begin{macro}{\labelsep}
  1293. % \begin{macro}{\labelwidth}
  1294. %    |\labelsep| is the distance between the label and the text of an
  1295. %    item; |\labelwidth| is the width of the label.
  1296. %    \begin{macrocode}
  1297. \setlength  \labelsep  {5\p@}
  1298. \setlength  \labelwidth{\leftmargini}
  1299. \addtolength\labelwidth{-\labelsep}
  1300. %    \end{macrocode}
  1301. % \end{macro}
  1302. % \end{macro}
  1303. %
  1304. % \begin{macro}{\partopsep}
  1305. %    When the user leaves a blank line before the environment an extra
  1306. %    vertical space of |\partopsep| is inserted, in addition to
  1307. %    |\parskip| and |\topsep|.
  1308. %    \begin{macrocode}
  1309. \setlength\partopsep{0\p@}
  1310. %    \end{macrocode}
  1311. % \end{macro}
  1312. %
  1313. % \begin{macro}{\@beginparpenalty}
  1314. % \begin{macro}{\@endparpenalty}
  1315. %    These penalties are inserted before and after a list or paragraph
  1316. %    environment. They are set to a bonus value to encourage page
  1317. %    breaking at these points.
  1318. % \begin{macro}{\@itempenalty}
  1319. %    This penalty is inserted between list items.
  1320. %    \begin{macrocode}
  1321. \@beginparpenalty -\@lowpenalty
  1322. \@endparpenalty   -\@lowpenalty
  1323. \@itempenalty     -\@lowpenalty
  1324. %    \end{macrocode}
  1325. % \end{macro}
  1326. % \end{macro}
  1327. % \end{macro}
  1328. %
  1329. % \begin{macro}{\@listI}
  1330. % \begin{macro}{\@listi}
  1331. % |\@listI| defines top level and |\@listi| values of
  1332. % |\leftmargin|, |\parsep|, |\topsep|, and |\itemsep|
  1333. %
  1334. %    \begin{macrocode}
  1335. \def\@listI{\setlength\leftmargin{\leftmargini}
  1336.             \setlength\parsep {0\p@}%
  1337.             \setlength\topsep {.4em}%
  1338.             \setlength\itemsep{.4em}}
  1339. \let\@listi\@listI
  1340. %    \end{macrocode}
  1341. %    We have to initialize these parameters.
  1342. %    \begin{macrocode}
  1343. \@listi
  1344. %    \end{macrocode}
  1345. % \end{macro}
  1346. % \end{macro}
  1347. %
  1348. % \begin{macro}{\@listii}
  1349. % \begin{macro}{\@listiii}
  1350. % \begin{macro}{\@listiv}
  1351. % \begin{macro}{\@listv}
  1352. % \begin{macro}{\@listvi}
  1353. %    Here are the same macros for the higher level lists.
  1354. %    \begin{macrocode}
  1355. \def\@listii {\setlength  \leftmargin{\leftmarginii}%
  1356.               \setlength  \labelwidth{\leftmarginii}%
  1357.               \addtolength\labelwidth{-\labelsep}}
  1358. \def\@listiii{\setlength  \leftmargin{\leftmarginiii}%
  1359.               \setlength  \labelwidth{\leftmarginiii}%
  1360.               \addtolength\labelwidth{-\labelsep}%
  1361.               \setlength  \topsep    {.2em}%
  1362.               \setlength  \itemsep   {\topsep}}
  1363. \def\@listiv {\setlength  \leftmargin{\leftmarginiv}%
  1364.               \setlength  \labelwidth{\leftmarginiv}%
  1365.               \addtolength\labelwidth{-\labelsep}}
  1366. \def\@listv  {\setlength  \leftmargin{\leftmarginv}%
  1367.               \setlength  \labelwidth{\leftmarginv}%
  1368.               \addtolength\labelwidth{-\labelsep}}
  1369. \def\@listvi {\setlength  \leftmargin{\leftmarginvi}%
  1370.               \setlength  \labelwidth{\leftmarginvi}%
  1371.               \addtolength\labelwidth{-\labelsep}}
  1372. %    \end{macrocode}
  1373. % \end{macro}
  1374. % \end{macro}
  1375. % \end{macro}
  1376. % \end{macro}
  1377. % \end{macro}
  1378. %
  1379. % \subsubsection{Enumerate}
  1380. %
  1381. %    The enumerate environment uses  four counters: \Lcount{enumi},
  1382. %    \Lcount{enumii}, \Lcount{enumiii} and \Lcount{enumiv}, where
  1383. %    \Lcount{enumN} controls the numbering of the Nth level
  1384. %    enumeration.
  1385. %
  1386. % \begin{macro}{\theenumi}
  1387. % \begin{macro}{\theenumii}
  1388. % \begin{macro}{\theenumiii}
  1389. % \begin{macro}{\theenumiv}
  1390. %    The counters are already defined in \file{latex.tex}, but their
  1391. %    representation is changed here.
  1392. %
  1393. %    \begin{macrocode}
  1394. \renewcommand\theenumi{\@arabic\c@enumi}
  1395. \renewcommand\theenumii{\@alph\c@enumii}
  1396. \renewcommand\theenumiii{\@roman\c@enumiii}
  1397. \renewcommand\theenumiv{\@Alph\c@enumiv}
  1398. %    \end{macrocode}
  1399. % \end{macro}
  1400. % \end{macro}
  1401. % \end{macro}
  1402. % \end{macro}
  1403. %
  1404. % \begin{macro}{\labelenumi}
  1405. % \begin{macro}{\labelenumii}
  1406. % \begin{macro}{\labelenumiii}
  1407. % \begin{macro}{\labelenumiv}
  1408. %    The commands |\labelenumi| ... |\labelenumiv| generate the label
  1409. %    for each item.
  1410. %    \begin{macrocode}
  1411. \newcommand\labelenumi{\theenumi.}
  1412. \newcommand\labelenumii{(\theenumii)}
  1413. \newcommand\labelenumiii{\theenumiii.}
  1414. \newcommand\labelenumiv{\theenumiv.}
  1415. %    \end{macrocode}
  1416. % \end{macro}
  1417. % \end{macro}
  1418. % \end{macro}
  1419. % \end{macro}
  1420. %
  1421. % \begin{macro}{\p@enumii}
  1422. % \begin{macro}{\p@enumiii}
  1423. % \begin{macro}{\p@enumiv}
  1424. %    The expansion of |\p@enumN||\theenumN| defines the output of a
  1425. %    |\ref| command when referencing an item of the Nth level of an
  1426. %    enumerated list.
  1427. %    \begin{macrocode}
  1428. \renewcommand\p@enumii{\theenumi}
  1429. \renewcommand\p@enumiii{\theenumi(\theenumii)}
  1430. \renewcommand\p@enumiv{\p@enumiii\theenumiii}
  1431. %    \end{macrocode}
  1432. % \end{macro}
  1433. % \end{macro}
  1434. % \end{macro}
  1435. %
  1436. % \subsubsection{Itemize}
  1437. %
  1438. % \begin{macro}{\labelitemi}
  1439. % \begin{macro}{\labelitemii}
  1440. % \changes{v1.2h}{1994/05/06}{Inserted \cs{normalfont}}
  1441. % \begin{macro}{\labelitemiii}
  1442. % \begin{macro}{\labelitemiv}
  1443. % Itemization is controlled by  |\labelitemi|,
  1444. % |\labelitemii|, |\labelitemiii|, and |\labelitemiv|, which define
  1445. % the labels of the various itemization levels: the symbols used are
  1446. % bullet, bold en-dash, asterisk and centered dot.
  1447. %
  1448. % \changes{v1.2n}{1994/07/11}{renamed \cs{labelitemiiii} to
  1449. %    \cs{labelitemiii}}
  1450. %    \begin{macrocode}
  1451. \newcommand\labelitemi{$\m@th\bullet$}
  1452. \newcommand\labelitemii{\normalfont\bfseries --}
  1453. \newcommand\labelitemiii{$\m@th\ast$}
  1454. \newcommand\labelitemiv{$\m@th\cdot$}
  1455. %    \end{macrocode}
  1456. % \end{macro}
  1457. % \end{macro}
  1458. % \end{macro}
  1459. % \end{macro}
  1460. %
  1461. % \subsubsection{Description}
  1462. %
  1463. % \begin{environment}{description}
  1464. %    The description environment is defined here -- while the itemize
  1465. %    and enumerate environments are defined in \file{latex.tex}.
  1466. %
  1467. %    \begin{macrocode}
  1468. \newenvironment{description}
  1469.                {\list{}{\labelwidth\z@ \itemindent-\leftmargin
  1470.                         \let\makelabel\descriptionlabel}}
  1471.                {\endlist}
  1472. %    \end{macrocode}
  1473. % \end{environment}
  1474. %
  1475. % \begin{macro}{\descriptionlabel}
  1476. %    To change the formatting of the label, you must redefine
  1477. %    |\descriptionlabel|.
  1478. %
  1479. % \changes{v1.2q}{1995/03/14}{made command short}
  1480. %    \begin{macrocode}
  1481. \newcommand*{\descriptionlabel}[1]{\hspace\labelsep
  1482.                                 \normalfont\bfseries #1}
  1483. %    \end{macrocode}
  1484. % \end{macro}
  1485. %
  1486. % \subsection{Defining new environments}
  1487. %
  1488.  
  1489. % \subsubsection{Verse}
  1490. %
  1491. % \begin{environment}{verse}
  1492. %   The verse environment is defined by making clever use of the
  1493. %   list environment's parameters.  The user types |\\| to end a line.
  1494. %   This is implemented by |\let|'ing |\\| equal |\@centercr|.
  1495. %
  1496. %    \begin{macrocode}
  1497. \newenvironment{verse}
  1498.                {\let\\=\@centercr
  1499.                 \list{}{\setlength\itemsep{\z@}%
  1500.                         \setlength\itemindent{-15\p@}%
  1501.                         \setlength\listparindent{\itemindent}%
  1502.                         \setlength\rightmargin{\leftmargin}%
  1503.                         \addtolength\leftmargin{15\p@}}%
  1504.                 \item[]}
  1505.                {\endlist}
  1506. %    \end{macrocode}
  1507. % \end{environment}
  1508. %
  1509. % \subsubsection{Quotation}
  1510. %
  1511. % \begin{environment}{quotation}
  1512. %   The quotation environment is also defined by making clever use of
  1513. %   the list environment's parameters. The lines in the environment
  1514. %   are set smaller than |\textwidth|. The first line of a paragraph
  1515. %   inside this environment is indented.
  1516. %
  1517. %    \begin{macrocode}
  1518. \newenvironment{quotation}
  1519.                {\list{}{\setlength\listparindent{1.5em}%
  1520.                         \setlength\itemindent{\listparindent}%
  1521.                         \setlength\rightmargin{\leftmargin}}%
  1522.                 \item[]}
  1523.                {\endlist}
  1524. %    \end{macrocode}
  1525. % \end{environment}
  1526. %
  1527. % \subsubsection{Quote}
  1528. %
  1529. % \begin{environment}{quote}
  1530. %   The quote environment is like the quotation environment except
  1531. %   that paragraphs are not indented.
  1532. %
  1533. %    \begin{macrocode}
  1534. \newenvironment{quote}
  1535.                {\list{}{\setlength\rightmargin{\leftmargin}}%
  1536.                 \item[]}
  1537.                {\endlist}
  1538. %    \end{macrocode}
  1539. % \end{environment}
  1540. %
  1541. % \subsubsection{Theorem}
  1542. %
  1543. %    This document class does not define it's own theorem environments,
  1544. %    the defaults, supplied by \file{latex.ltx} are available.
  1545. %
  1546.  
  1547. % \subsection{Setting parameters for existing environments}
  1548. %
  1549. % \subsubsection{Array and tabular}
  1550. %
  1551. % \begin{macro}{\arraycolsep}
  1552. %    The columns in an array environment are separated by
  1553. %    2|\arraycolsep|.
  1554. %    \begin{macrocode}
  1555. \setlength\arraycolsep{5\p@}
  1556. %    \end{macrocode}
  1557. % \end{macro}
  1558. %
  1559. % \begin{macro}{\tabcolsep}
  1560. %    The columns in an tabular environment are separated by
  1561. %    2|\tabcolsep|.
  1562. %    \begin{macrocode}
  1563. \setlength\tabcolsep{6\p@}
  1564. %    \end{macrocode}
  1565. % \end{macro}
  1566. %
  1567. % \begin{macro}{\arrayrulewidth}
  1568. %    The width of vertical rules in the array and tabular environments
  1569. %    is given by |\arrayrulewidth|.
  1570. %    \begin{macrocode}
  1571. \setlength\arrayrulewidth{.4\p@}
  1572. %    \end{macrocode}
  1573. % \end{macro}
  1574. %
  1575. % \begin{macro}{\doublerulesep}
  1576. %    The space between adjacent rules in the array and tabular
  1577. %    environments is given by |\doublerulesep|.
  1578. %    \begin{macrocode}
  1579. \setlength\doublerulesep{2\p@}
  1580. %    \end{macrocode}
  1581. % \end{macro}
  1582. %
  1583. % \subsubsection{Tabbing}
  1584. %
  1585. % \begin{macro}{\tabbingsep}
  1586. %    This controls the space that the |\'| command puts in. (See
  1587. %    \LaTeX{} manual for an explanation.)
  1588. %    \begin{macrocode}
  1589. \setlength\tabbingsep{\labelsep}
  1590. %    \end{macrocode}
  1591. % \end{macro}
  1592. %
  1593. % \subsubsection{Minipage}
  1594. %
  1595. % \begin{macro}{\@minipagerestore}
  1596. %    The macro |\@minipagerestore| is called upon entry to a minipage
  1597. %    environment to set up things that are to be handled differently
  1598. %    inside a minipage environment. In the current styles, it does
  1599. %    nothing.
  1600. % \end{macro}
  1601. %
  1602. % \begin{macro}{\@mpfootins}
  1603. %    Minipages have their own footnotes; |\skip||\@mpfootins| plays
  1604. %    same r\^ole for footnotes in a minipage as |\skip||\footins| does
  1605. %    for ordinary footnotes.
  1606. %
  1607. %    \begin{macrocode}
  1608. \skip\@mpfootins = \skip\footins
  1609. %    \end{macrocode}
  1610. % \end{macro}
  1611. %
  1612. % \subsubsection{Framed boxes}
  1613. %
  1614. % \begin{macro}{\fboxsep}
  1615. %    The space left by |\fbox| and |\framebox| between the box and the
  1616. %    text in it.
  1617. % \begin{macro}{\fboxrule}
  1618. %    The width of the rules in the box made by |\fbox| and |\framebox|.
  1619. %    \begin{macrocode}
  1620. \setlength\fboxsep{3\p@}
  1621. \setlength\fboxrule{.4\p@}
  1622. %    \end{macrocode}
  1623. % \end{macro}
  1624. % \end{macro}
  1625. %
  1626. % \subsubsection{Equation and eqnarray}
  1627. %
  1628. % \begin{macro}{\theequation}
  1629. %    The equation counter will be typeset using arabic numbers.
  1630. %    \begin{macrocode}
  1631. \renewcommand\theequation{\@arabic\c@equation}
  1632. %    \end{macrocode}
  1633. % \end{macro}
  1634. %
  1635. % \begin{macro}{\jot}
  1636. %    |\jot| is the extra space added between lines of an eqnarray
  1637. %    environment. The default value is used.
  1638. %    \begin{macrocode}
  1639. % \setlength\jot{3pt}
  1640. %    \end{macrocode}
  1641. % \end{macro}
  1642. %
  1643. % \begin{macro}{\@eqnnum}
  1644. %    The macro |\@eqnnum| defines how equation numbers are to appear in
  1645. %    equations. Again the default is used.
  1646. %
  1647. %    \begin{macrocode}
  1648. % \def\@eqnnum{(\theequation)}
  1649. %    \end{macrocode}
  1650. % \end{macro}
  1651. %
  1652. % \subsection{Font changing}
  1653. %
  1654. %    Here we supply the declarative font changing commands that were
  1655. %    common in \LaTeX\ version 2.09 and earlier. These commands work
  1656. %    in text mode \emph{and} in math mode. They are provided for
  1657. %    compatibility, but one should start using the |\text...| and
  1658. %    |\math...| commands instead. These commands are redefined using
  1659. %    |\@renewfontswitch|, a command with three arguments: the user
  1660. %    command to be defined; \LaTeX\ commands to execute in text mode
  1661. %    and \LaTeX\ commands to execute in math mode.
  1662. %
  1663. %  \begin{macro}{\rm}
  1664. %  \begin{macro}{\tt}
  1665. %  \begin{macro}{\sf}
  1666. %    The commands to change the family.
  1667. % \changes{v1.0a}{1993/12/14}{Added compatibility mode support.}
  1668. % \changes{v1.1}{1993/12/18}{Changed \cs{@newfontswitch} to
  1669. %    \cs{@renewfontswitch}, removed switch.}
  1670. % \changes{v1.2d}{1994/04/14}{\cs{@renewfontswitch} has become
  1671. %    \cs{DeclareOldFontCommand}}
  1672. %    \begin{macrocode}
  1673. \DeclareOldFontCommand{\rm}{\normalfont\rmfamily}{\mathrm}
  1674. \DeclareOldFontCommand{\sf}{\normalfont\sffamily}{\mathsf}
  1675. \DeclareOldFontCommand{\tt}{\normalfont\ttfamily}{\mathtt}
  1676. %    \end{macrocode}
  1677. %  \end{macro}
  1678. %  \end{macro}
  1679. %  \end{macro}
  1680. %
  1681. %  \begin{macro}{\bf}
  1682. %    The command to change to the bold series. One should use
  1683. %    |\mdseries| to explicitly switch back to medium series.
  1684. % \changes{v1.0a}{1993/12/14}{Added compatibility mode support.}
  1685. % \changes{v1.1}{1993/12/18}{Changed \cs{@newfontswitch} to
  1686. %    \cs{@renewfontswitch}, removed switch.}
  1687. %    \begin{macrocode}
  1688. \DeclareOldFontCommand{\bf}{\normalfont\bfseries}{\mathbf}
  1689. %    \end{macrocode}
  1690. %  \end{macro}
  1691. %
  1692. %  \begin{macro}{\sl}
  1693. %  \begin{macro}{\it}
  1694. %  \begin{macro}{\sc}
  1695. %
  1696. %    And the commands to change the shape of the font. The slanted and
  1697. %    small caps shapes are not available by default as math alphabets,
  1698. %    so those changes do nothing in math mode. One should use
  1699. %    |\upshape| to explicitly change back to the upright shape.
  1700. % \changes{v1.0a}{1993/12/14}{Added compatibility mode support.}
  1701. % \changes{v1.1}{1993/12/18}{Changed \cs{@newfontswitch} to
  1702. %    \cs{@renewfontswitch}, removed switch.}
  1703. % \changes{v1.1b}{1993/12/20}{Added forgotten re.}
  1704. %    \begin{macrocode}
  1705. \DeclareOldFontCommand{\it}{\normalfont\itshape}{\mathit}
  1706. \DeclareOldFontCommand{\sl}{\normalfont\slshape}{\relax}
  1707. \DeclareOldFontCommand{\sc}{\normalfont\scshape}{\relax}
  1708. %    \end{macrocode}
  1709. %  \end{macro}
  1710. %  \end{macro}
  1711. %  \end{macro}
  1712. %
  1713. % \begin{macro}{\cal}
  1714. % \changes{v1.0a}{1993/12/14}{Macro added}
  1715. % \begin{macro}{\mit}
  1716. % \changes{v1.0a}{1993/12/14}{Macro added}
  1717. %
  1718. %    The commands |\cal| and |\mit| should only be used in math mode,
  1719. %    outside math mode they have no effect. Currently the New Font
  1720. %    Selection Scheme defines these commands to generate warning
  1721. %    messages. Therefore we have to define them `by hand'.
  1722. % \changes{v1.2p}{1994/12/11}{Now define \cs{cal} and \cs{mit} using
  1723. %    \cs{DeclareRobustCommand*}}
  1724. %    \begin{macrocode}
  1725. \DeclareRobustCommand*{\cal}{\@fontswitch{\relax}{\mathcal}}
  1726. \DeclareRobustCommand*{\mit}{\@fontswitch{\relax}{\mathnormal}}
  1727. %    \end{macrocode}
  1728. %  \end{macro}
  1729. %  \end{macro}
  1730. %
  1731. % \subsection{Footnotes}
  1732. %
  1733. % \begin{macro}{\footnoterule}
  1734. %    Usually, footnotes are separated from the main body of the text
  1735. %    by a small rule. This rule is drawn by the macro |\footnoterule|.
  1736. %    We have to make sure that the rule takes no vertical space (see
  1737. %    \file{plain.tex}) so we compensate for the natural height of the
  1738. %    rule of 0.4pt by adding the right amount of vertical skip.
  1739. %
  1740. %    To prevent the rule from colliding with the footnote we first add
  1741. %    a little negative vertical skip, then we put the rule and make
  1742. %    sure we end up at the same point where we begun this operation.
  1743. %    \begin{macrocode}
  1744. \renewcommand\footnoterule{%
  1745.   \kern-\p@
  1746.   \hrule \@width .4\columnwidth
  1747.   \kern .6\p@}
  1748. %    \end{macrocode}
  1749. % \end{macro}
  1750. %
  1751. % \begin{macro}{\c@footnote}
  1752. %    A counter for footnotes.
  1753. %    \begin{macrocode}
  1754. % \newcounter{footnote}
  1755. %    \end{macrocode}
  1756. % \end{macro}
  1757. %
  1758. % \begin{macro}{\@makefntext}
  1759. % \changes{v1.2c}{1994/03/08}{Always call \cs{@makefnmark}.}
  1760. %    The footnote mechanism of \LaTeX{} calls the macro |\@makefntext|
  1761. %    to produce the actual footnote. The macro gets the text of the
  1762. %    footnote as its argument and should use |\@makefnmark| to produce
  1763. %    the mark of the footnote. The macro |\@makefntext| is called when
  1764. %    effectively inside a |\parbox| of width |\columnwidth| (i.e.,
  1765. %    with |\hsize| = |\columnwidth|).
  1766. %
  1767. %   An example of what can be achieved is given by the following piece
  1768. %   of \TeX\ code.
  1769. % \begin{verbatim}
  1770. %          \long\def\@makefntext#1{%
  1771. %             \@setpar{\@@par
  1772. %                      \@tempdima = \hsize
  1773. %                      \advance\@tempdima-10pt
  1774. %                      \parshape \@ne 10pt \@tempdima}%
  1775. %             \par
  1776. %             \parindent 1em\noindent
  1777. %             \hb@xt@\z@{\hss\@makefnmark}#1}
  1778. % \end{verbatim}
  1779. %    The effect of this definition is that all lines of the footnote
  1780. %    are indented by 10pt, while the first line of a new paragraph is
  1781. %    indented by 1em. To change these dimensions, just substitute the
  1782. %    desired value for `10pt' (in both places) or `1em'.  The mark is
  1783. %    flush right against the footnote.
  1784. %
  1785. %    In these document class we use a simpler macro, in which the
  1786. %    footnote text is set like an ordinary text paragraph, with no
  1787. %    indentation except on the first line of a paragraph, and the
  1788. %    first line of the footnote. Thus, all the macro must do is set
  1789. %    |\parindent| to the appropriate value for succeeding paragraphs
  1790. %    and put the proper indentation before the mark.
  1791. %
  1792. %    \begin{macrocode}
  1793. \long\def\@makefntext#1{%
  1794.     \noindent
  1795.     \hangindent 5\p@
  1796.     \hb@xt@5\p@{\hss\@makefnmark}#1}
  1797. %    \end{macrocode}
  1798. % \end{macro}
  1799. %
  1800. % \begin{macro}{\@makefnmark}
  1801. %    The footnote markers that are printed in the text to point to the
  1802. %    footnotes should be produced by the macro |\@makefnmark|. We use
  1803. %    the default definition for it.
  1804. %    \begin{macrocode}
  1805. %\def\@makefnmark{\hbox{$^{\@thefnmark}\m@th$}}
  1806. %    \end{macrocode}
  1807. % \end{macro}
  1808. %
  1809. % \subsection{Words}
  1810. %
  1811. % \begin{macro}{\ccname}
  1812. % \begin{macro}{\enclname}
  1813. % \begin{macro}{\pagename}
  1814. % \begin{macro}{\headtoname}
  1815. %     This document class is for documents prepared in the English
  1816. %     language. To prepare a version for another language, various
  1817. %     English words must be replaced.  All the English words that
  1818. %     require replacement are  defined below in command names.
  1819. %    \begin{macrocode}
  1820. \newcommand*{\ccname}{cc}
  1821. \newcommand*{\enclname}{encl}
  1822. \newcommand*{\pagename}{Page}
  1823. \newcommand*{\headtoname}{To}
  1824. %    \end{macrocode}
  1825. % \end{macro}
  1826. % \end{macro}
  1827. % \end{macro}
  1828. % \end{macro}
  1829.  
  1830. % \subsection{Date}
  1831. %
  1832. % \begin{macro}{\today}
  1833. %    This macro uses the \TeX\ primitives |\month|, |\day| and |\year|
  1834. %    to provide the date of the \LaTeX-run.
  1835. %    \begin{macrocode}
  1836. \newcommand*{\today}{\ifcase\month\or
  1837.   January\or February\or March\or April\or May\or June\or
  1838.   July\or August\or September\or October\or November\or December\fi
  1839.   \space\number\day, \number\year}
  1840. %    \end{macrocode}
  1841. % \end{macro}
  1842. %
  1843. % \subsection{Two column mode}
  1844. %
  1845. % \begin{macro}{\columnsep}
  1846. %    This gives the distance between two columns in two column mode.
  1847. %    \begin{macrocode}
  1848. \setlength\columnsep{10\p@}
  1849. %    \end{macrocode}
  1850. % \end{macro}
  1851. %
  1852. % \begin{macro}{\columnseprule}
  1853. %    This gives the width of the rule between two columns in two
  1854. %    column mode. We have no visible rule.
  1855. %    \begin{macrocode}
  1856. \setlength\columnseprule{0\p@}
  1857. %    \end{macrocode}
  1858. % \end{macro}
  1859. %
  1860. % \subsection{The page style} 
  1861. %    We have \pstyle{plain} pages in this document class by
  1862. %    default. We use arabic page numbers.
  1863. %    \begin{macrocode}
  1864. \pagestyle{plain}
  1865. \pagenumbering{arabic}
  1866. %    \end{macrocode}
  1867. %
  1868. % \subsection{Single or double sided printing}
  1869. %
  1870. %    We don't try to make each page as long as all the others.
  1871. %    \begin{macrocode}
  1872. \raggedbottom
  1873. %    \end{macrocode}
  1874. %
  1875. % \begin{macro}{\@texttop}
  1876. %    The document class letter sets |\@texttop| to |\vskip| 0pt
  1877. %    \texttt{plus} .00006fil on the first page of a letter, which
  1878. %    centers a short letter on the page. This fil value may have to be
  1879. %    changed for other letterheads.  This setting has to be done after
  1880. %    |\raggedbottom| is executed, since the latter sets |\@texttop| to
  1881. %    |\relax|.
  1882. %    \begin{macrocode}
  1883. \def\@texttop{\ifnum\c@page=1\vskip \z@ plus.00006fil\relax\fi}
  1884. %    \end{macrocode}
  1885. % \end{macro}
  1886. %
  1887. %    We always start in one column mode.
  1888. %    \begin{macrocode}
  1889. \onecolumn
  1890. %</letter>
  1891. %    \end{macrocode}
  1892. %
  1893. %
  1894. %
  1895. % \Finale
  1896. %
  1897. \endinput
  1898.