1ffa9044 |
1 | % \begin{meta-comment} |
2 | % |
186f3b71 |
3 | % $Id: strayman.dtx,v 1.4 2003/11/07 11:32:53 mdw Exp $ |
1ffa9044 |
4 | % |
e8c85bbe |
5 | % Document class for Straylight manuals |
1ffa9044 |
6 | % |
e8c85bbe |
7 | % (c) 1996 Straylight |
1ffa9044 |
8 | % |
9 | %----- Revision history ----------------------------------------------------- |
10 | % |
11 | % $Log: strayman.dtx,v $ |
186f3b71 |
12 | % Revision 1.4 2003/11/07 11:32:53 mdw |
13 | % Numbering-within macros added. |
14 | % |
c3f26ad3 |
15 | % Revision 1.3 2003/09/06 11:25:28 mdw |
16 | % Various tweaks. |
17 | % |
e8c85bbe |
18 | % Revision 1.2 2002/02/24 12:45:56 mdw |
19 | % Fix banners. |
20 | % |
1ffa9044 |
21 | % Revision 1.1 2002/02/19 23:27:57 mdw |
22 | % Initial revision. |
23 | % |
24 | % Revision 1.8 1996/12/09 23:20:42 mdw |
25 | % (\tab@setstrut): Fixed so that it uses \dimen\tw@ for the strut depth, |
26 | % as advertised. |
27 | % |
28 | % Revision 1.7 1996/11/29 21:59:16 mdw |
29 | % Fixed a little formatting mistake in a syntax diagram, and switched over |
30 | % to the new syntax diagram commands on the grounds that they're slightly |
31 | % less messy. Maybe. |
32 | % |
33 | % Revision 1.6 1996/11/19 20:54:33 mdw |
34 | % Entered into RCS |
35 | % |
36 | % |
37 | % \end{meta-comment} |
38 | % |
39 | % \begin{meta-comment} <general public licence> |
40 | %% |
e8c85bbe |
41 | %% strayman -- a LaTeX document class for Straylight manuals |
42 | %% Copyright (c) 1996 Straylight |
1ffa9044 |
43 | %% |
44 | %% This program is free software; you can redistribute it and/or modify |
45 | %% it under the terms of the GNU General Public License as published by |
46 | %% the Free Software Foundation; either version 2 of the License, or |
47 | %% (at your option) any later version. |
48 | %% |
49 | %% This program is distributed in the hope that it will be useful, |
50 | %% but WITHOUT ANY WARRANTY; without even the implied warranty of |
51 | %% MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the |
52 | %% GNU General Public License for more details. |
53 | %% |
54 | %% You should have received a copy of the GNU General Public License |
55 | %% along with this program; if not, write to the Free Software |
56 | %% Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. |
57 | %% |
58 | % \end{meta-comment} |
59 | % |
60 | % \begin{meta-comment} <Package preamble> |
61 | %<+strayman>\NeedsTeXFormat{LaTeX2e} |
62 | %<+strayman>\ProvidesClass{strayman} |
c3f26ad3 |
63 | %<+strayman> [2003/09/04 1.10 Straylight document class] |
1ffa9044 |
64 | % \end{meta-comment} |
65 | % |
186f3b71 |
66 | % \CheckSum{2934} |
1ffa9044 |
67 | %% \CharacterTable |
68 | %% {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 |
69 | %% 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 |
70 | %% Digits \0\1\2\3\4\5\6\7\8\9 |
71 | %% Exclamation \! Double quote \" Hash (number) \# |
72 | %% Dollar \$ Percent \% Ampersand \& |
73 | %% Acute accent \' Left paren \( Right paren \) |
74 | %% Asterisk \* Plus \+ Comma \, |
75 | %% Minus \- Point \. Solidus \/ |
76 | %% Colon \: Semicolon \; Less than \< |
77 | %% Equals \= Greater than \> Question mark \? |
78 | %% Commercial at \@ Left bracket \[ Backslash \\ |
79 | %% Right bracket \] Circumflex \^ Underscore \_ |
80 | %% Grave accent \` Left brace \{ Vertical bar \| |
81 | %% Right brace \} Tilde \~} |
82 | %% |
83 | % |
84 | % \begin{meta-comment} <driver> |
85 | % |
86 | %<*driver> |
87 | \documentclass[10pt,a4paper,times,cmtt]{strayman} |
88 | \input{mdwtools} |
89 | \usepackage{mdwlist} |
90 | \describesclass{strayman} |
91 | \title[The \strayman\ document class] |
92 | {The \strayman\footnote{The \strayman\ document class is currently % |
93 | at version \mdwfileinfo{strayman.cls}{version}, dated % |
94 | \mdwfileinfo{strayman.cls}{date}.} {} document class} |
95 | \newenvironment{syndisplay}{\display\synshorts}{\enddisplay} |
96 | \DeclareRobustCommand\strayman{\package{strayman}} |
97 | \mdwdoc |
98 | %</driver> |
99 | % |
100 | % \end{meta-comment} |
101 | % |
102 | % \chapter{About the \strayman\ document class} |
103 | % |
104 | % The standard \LaTeX\ document classes are all very well for simple |
105 | % documents, but the style isn't appropriate for works like manuals. |
106 | % The \strayman\ document class is an attempt to recitfy this situataion, |
107 | % providing an attractive and distinctive style for Straylight documents. |
108 | % The layout is based on an earlier style built for \emph{Impression} |
109 | % documents, although many improvements have been made. This document |
110 | % was typeset using \strayman, and it demonstrates the design far better |
111 | % than I can describe it. |
112 | % |
113 | % |
114 | % \section{Document class options} |
115 | % |
116 | % The document class provides many options, most of which are taken from |
117 | % the standard \LaTeX\ classes. |
118 | % |
119 | % \begin{description} |
120 | % \def\|{\ensuremath\vert} |
121 | % |
122 | % \item [\texttt{a4paper} \| \texttt{a5paper} \| \texttt{b5paper} \| |
123 | % \texttt{letterpaper} \| \texttt{legalpaper} \| |
124 | % \texttt{executivepaper}] Select the output paper size. Since |
125 | % \strayman\ is intended to be used mainly for manuals, the default |
126 | % size is |a5paper|. |
127 | % |
128 | % \item [\texttt{landscape}] Swaps the width and height of the paper. |
129 | % Probably not much use, to be honest. |
130 | % |
131 | % \item [\texttt{9pt} \| \texttt{10pt} \| \texttt{11pt} \| \texttt{12pt}] |
132 | % Selects the basic type size for the document. The |9pt| option is |
133 | % nonstandard, but it is the default, since larger sizes don't work |
134 | % well on A5~paper. |
135 | % |
136 | % \item [\texttt{text}] Sets up the page layout and fonts so that the |
137 | % output can be converted fairly easily into a raw text file. |
138 | % |
139 | % \item [\texttt{oneside} \| \texttt{twoside}] Selects one- or two-sided |
140 | % page layouts. Note that one-sided output doesn't look too good. |
141 | % |
142 | % \item [\texttt{draft} \| \texttt{final}] Select various options for draft |
143 | % or final copy. |
144 | % |
145 | % \item [\texttt{titlepage} \| \texttt{notitlepage}] Selects whether |
146 | % the |\maketitle| displays its output on a separate title page. |
147 | % |
148 | % \item [\texttt{openright} \| \texttt{openany}] Select whether chapters |
149 | % start only on quarto pages, or any page. The default is |openright|. |
150 | % |
151 | % \item [\texttt{onecolumn} \| \texttt{twocolumn}] Choose whether the |
152 | % main body text is set in one or two columns. Note that this uses |
153 | % \LaTeX's built-in column handling, not the \package{multicol} |
154 | % package. |
155 | % |
156 | % \item [\texttt{leqno}] Put the equation numbers on the left, not the |
157 | % right. |
158 | % |
159 | % \item [\texttt{fleqn}] Typeset displayed equations left aligned. |
160 | % |
161 | % \item [\texttt{openbib}] Use the `open' style for the bibliography. |
162 | % |
163 | % \item [\texttt{article}] Change the formatting slightly, in a way more |
164 | % suited to short documents. |
165 | % |
166 | % \item [\texttt{square} \| \texttt{rounded}] These options are passed |
167 | % directly to the \package{syntax} package, when it's loaded. |
168 | % |
169 | % \item [\texttt{helvetica}] Typeset headings in the Helvetica font, |
170 | % not in Computer Modern. |
171 | % |
172 | % \item [\texttt{palatino}] Typeset the main body text in Palatino, and |
173 | % headings in Helvetica. The |\tt| font is changed to Courier, but |
174 | % see the \texttt{cmtt} option. |
175 | % |
176 | % \item [\texttt{times}] Typeset the main body text in Times, and headings |
177 | % in Helvetica. The |\tt| font is changed to Courier, but see the |
178 | % \texttt{cmtt} option. |
179 | % |
180 | % \end{description} |
181 | % |
182 | % |
183 | % \section{The \texttt{text} option} |
184 | % |
185 | % In order to facilitate creation of attractively formatted text files |
186 | % from \LaTeX\ documents, \strayman\ provides a |text| option. This will |
187 | % set up \emph{all} the fonts to be monospaced, in the same size. The page |
188 | % size is set up to be a multiple of the character size. The command |
189 | % \begin{syndisplay} |
190 | % "dvi2tty -e-17" <filename> |
191 | % \end{syndisplay} |
192 | % appears to produce a reasonable output from a DVI file created in this |
193 | % way. The output will need to be formatted and corrected slightly by hand |
194 | % although there's a good deal less work to do than might be required |
195 | % otherwise. |
196 | % |
197 | % |
198 | % \section{That's it} |
199 | % |
200 | % That's all I'm writing for now. It's a document class. It defines the |
201 | % style. What more do you expect? |
202 | % |
203 | % |
204 | % \implementation |
205 | % |
206 | % \chapter{Implementation} |
207 | % |
208 | % \section{Options handling} |
209 | % |
210 | % From here on, a lot of the code is shamelessly borrowed from |
211 | % \file{book.cls} and other places. This is what code re-use is for. |
212 | % |
213 | % This bit handles all the options on the |\documentclass| command, either |
214 | % altering our own internal arguments, or loading other packages as |
215 | % appropriate. |
216 | % |
217 | % \subsection{Set up some defaults} |
218 | % |
219 | % We create some variables to hold the settings, and initialise them to |
220 | % sensible values. |
221 | % |
222 | % \begin{macrocode} |
223 | %<*strayman> |
224 | \newcommand\@ptsize{} |
225 | \newif\if@restonecol\@restonecolfalse |
226 | \newif\if@titlepage\@titlepagetrue |
227 | \newif\if@openright\@openrighttrue |
228 | \newif\if@openbib\@openbibfalse |
229 | \newif\if@appendix\@appendixfalse |
230 | \newif\if@article\@articlefalse |
231 | \newif\if@offsetpages\@offsetpagestrue |
232 | \newif\if@numbering\@numberingfalse |
233 | \newif\if@herefloats\@herefloatstrue |
234 | \newif\if@runinsubsubsec\@runinsubsubsecfalse |
235 | \newdimen\pagesurround |
236 | \let\headfam\rmfamily |
237 | \let\pad@margin\@empty |
238 | \def\@delayed{} |
239 | \def\@delaycode#1{% |
240 | \expandafter\def\expandafter\@delayed\expandafter{\@delayed#1}% |
241 | } |
242 | % \end{macrocode} |
243 | % |
244 | % \subsection{Declare the options we support} |
245 | % |
246 | % This is just a tedious list of all the options. |
247 | % |
248 | % \begin{macrocode} |
249 | \DeclareOption{a4paper}{% |
250 | \paperheight297mm% |
251 | \paperwidth210mm% |
252 | \pagesurround1in% |
253 | } |
254 | \DeclareOption{a5paper}{% |
255 | \paperheight210mm% |
256 | \paperwidth148mm% |
257 | \pagesurround12mm% |
258 | } |
259 | \DeclareOption{b5paper}{% |
260 | \paperheight250mm% |
261 | \paperwidth176mm% |
262 | \pagesurround1in% |
263 | } |
264 | \DeclareOption{letterpaper}{% |
265 | \paperheight11in% |
266 | \paperwidth8.5in% |
267 | \pagesurround1in% |
268 | } |
269 | \DeclareOption{legalpaper}{% |
270 | \paperheight14in% |
271 | \paperwidth8.5in% |
272 | \pagesurround1in% |
273 | } |
274 | \DeclareOption{executivepaper}{% |
275 | \paperheight10.5in% |
276 | \paperwidth7.25in% |
277 | \pagesurround1in% |
278 | } |
279 | \DeclareOption{landscape}{% |
280 | \@tempdima\paperheight% |
281 | \paperheight\paperwidth% |
282 | \paperwidth\@tempdima% |
283 | } |
284 | \DeclareOption{8pt}{\renewcommand\@ptsize{8pt}} |
285 | \DeclareOption{9pt}{\renewcommand\@ptsize{9pt}} |
286 | \DeclareOption{10pt}{\renewcommand\@ptsize{10pt}} |
287 | \DeclareOption{11pt}{\renewcommand\@ptsize{11pt}} |
288 | \DeclareOption{12pt}{\renewcommand\@ptsize{12pt}} |
289 | \DeclareOption{text}{% |
290 | \renewcommand\@ptsize{text}% |
291 | \setbox\z@\hbox{\texttt{M\strut}}% |
292 | \newdimen\tt@chw\tt@chw\wd\z@% |
293 | \newdimen\tt@chh\tt@chh\ht\z@\advance\tt@chh\dp\z@% |
294 | \paperwidth77\tt@chw% |
295 | \paperheight60\tt@chh% |
296 | \raggedright% |
297 | \def\pad@margin{.} |
298 | } |
299 | \DeclareOption{oneside}{\@twosidefalse \@mparswitchfalse} |
300 | \DeclareOption{twoside}{\@twosidetrue \@mparswitchfalse \reversemarginpar} |
301 | \DeclareOption{draft}{\overfullrule5\p@} |
302 | \DeclareOption{final}{\overfullrule\z@} |
303 | \DeclareOption{titlepage}{\@titlepagetrue} |
304 | \DeclareOption{notitlepage}{\@titlepagefalse} |
305 | \DeclareOption{openright}{\@openrighttrue} |
306 | \DeclareOption{openany}{\@openrightfalse} |
307 | \DeclareOption{onecolumn}{\@twocolumnfalse} |
308 | \DeclareOption{twocolumn}{\@twocolumntrue} |
309 | \DeclareOption{offsetpages}{\@offsetpagestrue} |
310 | \DeclareOption{nooffsetpages}{\@offsetpagesfalse} |
311 | \DeclareOption{herefloats}{\@herefloatstrue} |
312 | \DeclareOption{noherefloats}{\@herefloatsfalse} |
313 | \DeclareOption{leqno}{\input{leqno.clo}} |
314 | \DeclareOption{fleqn}{\input{fleqn.clo}} |
315 | \DeclareOption{openbib}{\@openbibtrue} |
316 | \DeclareOption{article}{\@articletrue} |
317 | \DeclareOption{numbering}{\@numberingtrue} |
318 | \DeclareOption{nonumbering}{\@numberingfalse} |
319 | \DeclareOption{runinsubsubsec}{\@runinsubsubsectrue} |
320 | \DeclareOption{noruninsubsubsec}{\@runinsubsubsecfalse} |
321 | % \end{macrocode} |
322 | % |
323 | % \subsection{Set up the options} |
324 | % |
325 | % We set up some default options, and then read the user's. |
326 | % |
327 | % \begin{macrocode} |
328 | \ExecuteOptions{a5paper,8pt,twoside,onecolumn,final,openright} |
329 | \ProcessOptions |
330 | % \end{macrocode} |
331 | % |
332 | % If this is PDF\TeX\ then tell it the page bounds. |
333 | % |
334 | % \begin{macrocode} |
335 | \@ifundefined{pdfpageheight}{ |
336 | \relax |
337 | }{ |
338 | \pdfpageheight\paperheight |
339 | \pdfpagewidth\paperwidth |
340 | } |
341 | % \end{macrocode} |
342 | % |
343 | % \subsection{Read in the text size option} |
344 | % |
345 | % The text sizing is rather messy. We store this in a separate file. To |
346 | % keep this stuff away from other classes, we use the file \emph{extension} |
347 | % as the size specifier, rather than the filename, which is the normal |
348 | % \LaTeX\ way of doing this. This is a \riscos\ thing mainly: I don't like |
349 | % loads of directories cluttering up my disk, and it means that I can move |
350 | % the whole of the \strayman\ stuff around as one directory. |
351 | % |
352 | % \begin{macrocode} |
353 | \input{strayman.\@ptsize} |
354 | %</strayman> |
355 | % \end{macrocode} |
356 | % |
357 | % \section{Package loading} |
358 | % |
359 | % \begin{macrocode} |
360 | %<*strayman> |
361 | \RequirePackage{fancyhdr} |
362 | \RequirePackage{multicol} |
363 | \@delayed |
364 | %</strayman> |
365 | % \end{macrocode} |
366 | % |
367 | % \section{Page layout} |
368 | % |
369 | % This is largely the domain of the size option files. |
370 | % |
371 | % \begin{macrocode} |
372 | %<*8pt|9pt|10pt|11pt|12pt|text> |
373 | %<+8pt>\ProvidesFile{strayman.8pt} |
374 | %<+9pt>\ProvidesFile{strayman.9pt} |
375 | %<+10pt>\ProvidesFile{strayman.10pt} |
376 | %<+11pt>\ProvidesFile{strayman.11pt} |
377 | %<+12pt>\ProvidesFile{strayman.12pt} |
378 | %<+text>\ProvidesFile{strayman.text} |
379 | % \end{macrocode} |
380 | % |
381 | % \subsection{Font sizes} |
382 | % |
383 | % These are fairly standard, and mainly copied from the original size |
384 | % options. |
385 | % |
386 | % \begin{macro}{\@setparskip} |
387 | % |
388 | % Because we separate paragraphs by vertical space, we need to vary this |
389 | % gap when we change font size. This macro does the job. |
390 | % |
391 | % \begin{macrocode} |
392 | \def\@setparskip{% |
393 | \relax\ifdim\parskip=\z@\else% |
394 | \parskip.67\baselineskip\@plus\p@\relax% |
395 | \fi% |
396 | } |
397 | % \end{macrocode} |
398 | % \end{macro} |
399 | % |
400 | % \begin{macro}{\normalsize} |
401 | % |
402 | % Defines the standard size of text in the document. |
403 | % |
404 | % \begin{macrocode} |
405 | \renewcommand\normalsize{% |
406 | %<*8pt> |
186f3b71 |
407 | \@setfontsize\normalsize\@viiipt{9.6\p@}% |
1ffa9044 |
408 | \abovedisplayskip8\p@\@plus2\p@\@minus4\p@% |
409 | \abovedisplayshortskip\z@\@plus3\p@% |
410 | \belowdisplayshortskip6\p@\@plus3\p@\@minus3\p@% |
411 | %</8pt> |
412 | %<*9pt> |
413 | \@setfontsize\normalsize\@ixpt\@xipt% |
414 | \abovedisplayskip9\p@\@plus2\p@\@minus5\p@% |
415 | \abovedisplayshortskip\z@\@plus3\p@% |
416 | \belowdisplayshortskip6\p@\@plus3\p@\@minus3\p@% |
417 | %</9pt> |
418 | %<*10pt> |
419 | \@setfontsize\normalsize\@xpt\@xiipt% |
420 | \abovedisplayskip10\p@\@plus2\p@\@minus5\p@% |
421 | \abovedisplayshortskip\z@\@plus3\p@% |
422 | \belowdisplayshortskip6\p@\@plus3\p@\@minus3\p@% |
423 | %</10pt> |
424 | %<*11pt> |
425 | \@setfontsize\normalsize\@xipt{13.6}% |
426 | \abovedisplayskip11\p@\@plus3\p@\@minus6\p@% |
427 | \abovedisplayshortskip\z@\@plus3\p@% |
428 | \belowdisplayshortskip6.5\p@ \@plus3.5\p@\@minus3\p@% |
429 | %</11pt> |
430 | %<*12pt> |
431 | \@setfontsize\normalsize\@xiipt{14.5}% |
432 | \abovedisplayskip12\p@\@plus3\p@\@minus7\p@% |
433 | \abovedisplayshortskip\z@\@plus3\p@% |
434 | \belowdisplayshortskip6.5\p@ \@plus3.5\p@\@minus3\p@% |
435 | %</12pt> |
436 | %<*text> |
437 | \@setfontsize\normalsize\@xpt\@xiipt% |
438 | \abovedisplayskip10\p@\@plus2\p@\@minus5\p@% |
439 | \abovedisplayshortskip\z@\@plus3\p@% |
440 | \belowdisplayshortskip6\p@\@plus3\p@\@minus3\p@% |
441 | %</text> |
442 | \belowdisplayskip\abovedisplayskip% |
443 | \let\@listi\@listI% |
444 | \@setparskip% |
445 | } |
446 | \normalsize |
447 | \parskip2ex\@plus\p@ |
448 | % \end{macrocode} |
449 | % \end{macro} |
450 | % |
451 | % \begin{macro}{\small} |
452 | % |
453 | % The |\small| size is defined with similar care to |\normalsize|. The |
454 | % list defaults are altered to cope with our different value for |\parskip|. |
455 | % We can then separate this out independently from the typesize. |
456 | % |
457 | % \begin{macrocode} |
458 | %<+text>\let\small\normalsize |
459 | %<*8pt|9pt|10pt|11pt|12pt> |
460 | \newcommand\small{% |
461 | %<*8pt> |
462 | \@setfontsize\small\@viipt{8.4}% |
463 | \abovedisplayskip8\p@\@plus2\p@\@minus4\p@% |
464 | \abovedisplayshortskip\z@\@plus2\p@% |
465 | \belowdisplayshortskip4\p@\@plus2\p@\@minus2\p@% |
466 | %</8pt> |
467 | %<*9pt> |
468 | \@setfontsize\small\@viiipt{9.5}% |
469 | \abovedisplayskip8\p@\@plus2\p@\@minus4\p@% |
470 | \abovedisplayshortskip\z@\@plus2\p@% |
471 | \belowdisplayshortskip4\p@\@plus2\p@\@minus2\p@% |
472 | %</9pt> |
473 | %<*10pt> |
474 | \@setfontsize\small\@ixpt{11}% |
475 | \abovedisplayskip8.5\p@\@plus3\p@\@minus4\p@% |
476 | \abovedisplayshortskip\z@\@plus2\p@% |
477 | \belowdisplayshortskip4\p@\@plus2\p@\@minus2\p@% |
478 | %</10pt> |
479 | %<*11pt> |
480 | \@setfontsize\small\@xpt\@xiipt% |
481 | \abovedisplayskip10\p@\@plus2\p@\@minus5\p@% |
482 | \abovedisplayshortskip\z@\@plus3\p@% |
483 | \belowdisplayshortskip6\p@\@plus3\p@\@minus3\p@% |
484 | %</11pt> |
485 | %<*12pt> |
486 | \@setfontsize\small\@xipt{13.6}% |
487 | \abovedisplayskip11\p@\@plus3\p@\@minus6\p@% |
488 | \abovedisplayshortskip\z@ \@plus3\p@% |
489 | \belowdisplayshortskip6.5\p@ \@plus3.5\p@\@minus3\p@% |
490 | %</12pt> |
491 | \def\@listi{% |
492 | \leftmargin\leftmargini% |
493 | \topsep\z@% |
494 | \parsep\parskip% |
495 | \itemsep\z@% |
496 | }% |
497 | \belowdisplayskip\abovedisplayskip% |
498 | \@setparskip% |
499 | } |
500 | %</8pt|9pt|10pt|11pt|12pt> |
501 | % \end{macrocode} |
502 | % \end{macro} |
503 | % |
504 | % \begin{macro}{\footnotesize} |
505 | % |
506 | % This is also defined with the meticulous care of |\normalsize|, and |
507 | % altered in the same way as for |\small|. |
508 | % |
509 | % \begin{macrocode} |
510 | %<+text>\let\footnotesize\normalsize |
511 | %<*8pt|9pt|10pt|11pt|12pt> |
512 | \newcommand\footnotesize{% |
513 | %<*8pt> |
514 | \@setfontsize\footnotesize\@vipt\@viipt% |
515 | \abovedisplayskip6\p@\@plus2\p@\@minus4\p@% |
516 | \abovedisplayshortskip\z@\@plus\p@% |
517 | \belowdisplayshortskip3\p@\@plus\p@\@minus2\p@% |
518 | %</8pt> |
519 | %<*9pt> |
520 | \@setfontsize\footnotesize\@viipt{8.4}% |
521 | \abovedisplayskip6\p@\@plus2\p@\@minus4\p@% |
522 | \abovedisplayshortskip\z@\@plus\p@% |
523 | \belowdisplayshortskip3\p@\@plus\p@\@minus2\p@% |
524 | %</9pt> |
525 | %<*10pt> |
526 | \@setfontsize\footnotesize\@viiipt{9.5}% |
527 | \abovedisplayskip6\p@\@plus2\p@\@minus4\p@% |
528 | \abovedisplayshortskip\z@\@plus\p@% |
529 | \belowdisplayshortskip3\p@\@plus\p@\@minus2\p@% |
530 | %</10pt> |
531 | %<*11pt> |
532 | \@setfontsize\footnotesize\@ixpt{11}% |
533 | \abovedisplayskip8\p@\@plus2\p@\@minus4\p@% |
534 | \abovedisplayshortskip\z@\@plus\p@% |
535 | \belowdisplayshortskip4\p@\@plus2\p@\@minus2\p@% |
536 | %</11pt> |
537 | %<*12pt> |
538 | \@setfontsize\footnotesize\@xpt\@xiipt |
539 | \abovedisplayskip10\p@\@plus2\p@\@minus5\p@% |
540 | \abovedisplayshortskip\z@\@plus3\p@% |
541 | \belowdisplayshortskip6\p@\@plus3\p@\@minus3\p@% |
542 | %</12pt> |
543 | \def\@listi{% |
544 | \leftmargin\leftmargini% |
545 | \topsep\z@% |
546 | \parsep\parskip% |
547 | \itemsep\z@% |
548 | }% |
549 | \belowdisplayskip\abovedisplayskip% |
550 | \@setparskip% |
551 | } |
552 | %</8pt|9pt|10pt|11pt|12pt> |
553 | % \end{macrocode} |
554 | % \end{macro} |
555 | % |
556 | % The other sizes are all much simpler. We introduce a new size, |
557 | % |\listingsize|, which is used for the \env{listing} environment, to ensure |
558 | % that 77 columns of text fit across an A5 sheet. |
559 | % |
560 | % \begin{macrocode} |
561 | %<*8pt> |
562 | \newcommand\scriptsize{\@setfontsize\scriptsize\@vpt\@vipt\@setparskip} |
563 | \newcommand\tiny{\@setfontsize\tiny{4}\@vpt\@setparskip} |
564 | \newcommand\large{\@setfontsize\large\@xpt\@xiipt\@setparskip} |
565 | \newcommand\Large{\@setfontsize\Large\@xipt{13}\@setparskip} |
566 | \newcommand\LARGE{\@setfontsize\LARGE\@xiipt\@xivpt\@setparskip} |
567 | \newcommand\huge{\@setfontsize\huge\@xviipt{20}\@setparskip} |
568 | \newcommand\Huge{\@setfontsize\Huge\@xxpt{26}\@setparskip} |
1ffa9044 |
569 | %</8pt> |
570 | %<*9pt> |
571 | \newcommand\scriptsize{\@setfontsize\scriptsize\@vipt\@viipt\@setparskip} |
572 | \newcommand\tiny{\@setfontsize\tiny\@vpt\@vipt\@setparskip} |
573 | \newcommand\large{\@setfontsize\large\@xipt{13}\@setparskip} |
574 | \newcommand\Large{\@setfontsize\Large\@xiipt{14.4}\@setparskip} |
575 | \newcommand\LARGE{\@setfontsize\LARGE\@xivpt{17}\@setparskip} |
576 | \newcommand\huge{\@setfontsize\huge\@xviipt{20}\@setparskip} |
577 | \newcommand\Huge{\@setfontsize\Huge\@xxpt{26}\@setparskip} |
1ffa9044 |
578 | %</9pt> |
579 | %<*10pt> |
580 | \newcommand\scriptsize{\@setfontsize\scriptsize\@viipt\@viiipt\@setparskip} |
581 | \newcommand\tiny{\@setfontsize\tiny\@vpt\@vipt\@setparskip} |
582 | \newcommand\large{\@setfontsize\large\@xiipt{14}\@setparskip} |
583 | \newcommand\Large{\@setfontsize\Large\@xivpt{18}\@setparskip} |
584 | \newcommand\LARGE{\@setfontsize\LARGE\@xviipt{22}\@setparskip} |
585 | \newcommand\huge{\@setfontsize\huge\@xxpt{25}\@setparskip} |
586 | \newcommand\Huge{\@setfontsize\Huge\@xxvpt{30}\@setparskip} |
1ffa9044 |
587 | %</10pt> |
588 | %<*11pt> |
589 | \newcommand\scriptsize{\@setfontsize\scriptsize\@viiipt{9.5}\@setparskip} |
590 | \newcommand\tiny{\@setfontsize\tiny\@vipt\@viipt\@setparskip} |
591 | \newcommand\large{\@setfontsize\large\@xiipt{14}\@setparskip} |
592 | \newcommand\Large{\@setfontsize\Large\@xivpt{18}\@setparskip} |
593 | \newcommand\LARGE{\@setfontsize\LARGE\@xviipt{22}\@setparskip} |
594 | \newcommand\huge{\@setfontsize\huge\@xxpt{25}\@setparskip} |
595 | \newcommand\Huge{\@setfontsize\Huge\@xxvpt{30}\@setparskip} |
1ffa9044 |
596 | %</11pt> |
597 | %<*12pt> |
598 | \newcommand\scriptsize{\@setfontsize\scriptsize\@viiipt{9.5}\@setparskip} |
599 | \newcommand\tiny{\@setfontsize\tiny\@vipt\@viipt\@setparskip} |
600 | \newcommand\large{\@setfontsize\large\@xivpt{18}\@setparskip} |
601 | \newcommand\Large{\@setfontsize\Large\@xviipt{22}\@setparskip} |
602 | \newcommand\LARGE{\@setfontsize\LARGE\@xxpt{25}\@setparskip} |
603 | \newcommand\huge{\@setfontsize\huge\@xxvpt{30}\@setparskip} |
604 | \let\Huge\huge |
1ffa9044 |
605 | %</12pt> |
c3f26ad3 |
606 | %<+8pt|9pt|10pt|11pt|12pt>\let\listingsize\footnotesize |
1ffa9044 |
607 | %<*text> |
608 | \def\scriptsize{\@setfontsize\scriptsize\@xpt\@xiipt\@setparskip} |
609 | \let\tiny\scriptsize |
610 | \let\large\scriptsize |
611 | \let\Large\scriptsize |
612 | \let\LARGE\scriptsize |
613 | \let\huge\scriptsize |
614 | \let\Huge\scriptsize |
615 | \let\listingsize\scriptsize |
616 | % |
617 | \let\txt@selectfont\selectfont |
618 | \def\selectfont{% |
619 | \fontfamily\ttdefault% |
620 | \fontseries{m}% |
621 | \fontshape{n}% |
622 | \txt@selectfont% |
623 | } |
624 | %</text> |
625 | %</8pt|9pt|10pt|11pt|12pt|text> |
626 | % \end{macrocode} |
627 | % |
628 | % \subsection{Paragraph layout} |
629 | % |
630 | % Here we define various paragraph layout parameters. |
631 | % |
632 | % First, set up the line separation parameters. |\baselineskip| is set |
633 | % up by the individual size commands. |
634 | % |
635 | % \begin{macrocode} |
636 | %<*strayman> |
637 | \lineskip\p@ |
638 | \normallineskip\p@ |
639 | % \end{macrocode} |
640 | % |
641 | % We don't try to stretch the baselines apart: |
642 | % |
643 | % \begin{macrocode} |
644 | \renewcommand\baselinestretch{} |
645 | % \end{macrocode} |
646 | % |
647 | % We don't indent paragraphs at all; instead, we separate them with blank |
648 | % lines. The vertical gap is worked out in the size command; we just clear |
649 | % |\parindent|. |
650 | % |
651 | % \begin{macrocode} |
652 | \parindent\z@ |
653 | % \end{macrocode} |
654 | % |
655 | % Set up some standard penalty values. |
656 | % |
657 | % \begin{macrocode} |
658 | \@lowpenalty 51 |
659 | \@medpenalty 151 |
660 | \@highpenalty 301 |
661 | %</strayman> |
662 | % \end{macrocode} |
663 | % |
664 | % \subsection{Page layout} |
665 | % |
666 | % Our layout is a bit different to the standard \LaTeX\ ones: we leave a lot |
667 | % of space down the left hand side: this is reserved for headings and |
668 | % marginal notes. |
669 | % |
670 | % Calculating the size of the space on the left, which we call |\leftindent|, |
671 | % is complicated. We want to use as much of the width of the page as |
672 | % possible, unlike the \LaTeX\ defaults, making sure that we can fit on |
673 | % 77 columns of |\listingsize\tt| text. We also try to make space for a |
674 | % reasonable amount of marginal text, although we don't worry too much if |
675 | % that suffers. |
676 | % |
677 | % The calculation is done as follows. More than about 40\,mm of margin will |
678 | % look very strange. We must have at least 104\,mm of main text, which |
679 | % leaves 20\,mm for the notes on A5 paper (actually, 17\,mm, since we leave |
680 | % 3\,mm gap between the notes and the main text). We divide the page |
681 | % horizontally into $s$\,mm of left border, $m$\,mm of marginal notes, |
682 | % $t$\,mm of body text, and another $s$\,mm of right border, giving |
683 | % a total of $w$\,mm. The value $s$ is given to us by the parameter |
684 | % |\pagesurround|. |
685 | % |
686 | % Articles look odd with a big gap down the side, so this is reduced when |
687 | % necessary. |
688 | % |
689 | % We calculate the quantity~$m$ as $\min\bigl(40,17(w-2s-3)/121+3\bigr)$\@. |
690 | % Then we calculate $t=w-m-24-3$. |
691 | % |
692 | % \begin{macrocode} |
693 | %<*8pt|9pt|10pt|11pt|12pt|text> |
694 | \newdimen\leftindent |
695 | %<*8pt|9pt|10pt|11pt|12pt> |
696 | \leftindent\paperwidth |
697 | \if@offsetpages |
698 | \advance\leftindent-2\pagesurround |
699 | \advance\leftindent-3mm |
700 | \leftindent0.1405\leftindent |
701 | \advance\leftindent3mm |
702 | \ifdim\leftindent>40mm\relax |
703 | \leftindent40mm |
704 | \fi |
705 | \if@article\divide\leftindent\tw@\fi |
706 | \ifdim\leftindent<15mm\leftindent15mm\fi |
707 | \else |
708 | \leftindent\z@ |
709 | \fi |
710 | %</8pt|9pt|10pt|11pt|12pt> |
711 | %<+text>\leftindent8\tt@chw |
712 | % \end{macrocode} |
713 | % |
714 | % In two-column layouts, we prevent headings from being outdented, by |
715 | % zeroing |\sectindent|. Chapter headings and suchlike are still outdented |
716 | % as before. We do not support margin paragraphs in two-column layouts. |
717 | % |
718 | % \begin{macrocode} |
719 | \newdimen\sectindent |
720 | \if@twocolumn |
721 | \sectindent\z@ |
722 | \else |
723 | \sectindent\if@numbering\z@\else\if@article\else\tw@\fi\leftindent\fi |
724 | \fi |
725 | % \end{macrocode} |
726 | % |
727 | % Having set up the size of the margin, we can get on with the rest of the |
728 | % setting up. |
729 | % |
730 | % First, we fix |\hoffset| and |\voffset| so we can work on the whole size |
731 | % of the paper. |
732 | % |
733 | % \begin{macrocode} |
734 | \advance\hoffset-1in |
735 | \advance\voffset-1in |
736 | % \end{macrocode} |
737 | % |
738 | % Now we can design the page layout in earnest. We begin with the vertical |
739 | % layout. |
740 | % |
741 | % \begin{macrocode} |
742 | %<+8pt>\topskip8\p@ |
743 | %<+9pt>\topskip9\p@ |
744 | %<+10pt>\topskip10\p@ |
745 | %<+11pt>\topskip11\p@ |
746 | %<+12pt>\topskip12\p@ |
747 | %<+text>\topskip\tt@chh |
748 | %<-text>\topmargin\pagesurround |
749 | %<+text>\topmargin\z@ |
750 | %<-text>\headheight12\p@ |
751 | %<+text>\headheight12\p@ |
752 | %<-text>\headsep.5\pagesurround |
753 | %<+text>\headsep2\tt@chh |
754 | %<+text>\advance\headsep-12\p@ |
755 | %<-text>\footskip12\p@ |
756 | %<-text>\advance\footskip.5\pagesurround |
757 | %<+text>\footskip2\tt@chh |
758 | \textheight\paperheight |
759 | %<-text>\advance\textheight-24\p@ |
760 | %<-text>\advance\textheight-3\pagesurround |
761 | %<+text>\advance\textheight-4\tt@chh |
762 | % \end{macrocode} |
763 | % |
764 | % Now we define the horizontal layout. |
765 | % |
766 | % \begin{macrocode} |
767 | \oddsidemargin\leftindent |
768 | %<-text>\advance\oddsidemargin\pagesurround |
769 | \evensidemargin\oddsidemargin |
770 | \textwidth\paperwidth |
771 | \advance\textwidth-\oddsidemargin |
772 | %<-text> \advance\textwidth-\pagesurround |
773 | %<-text>\marginparsep3mm |
774 | %<+text>\marginparsep\tt@chw |
775 | \marginparwidth\leftindent |
776 | \advance\marginparwidth-\marginparsep |
777 | % \end{macrocode} |
778 | % |
779 | % Setting |\maxdepth| is fairly simple. This looks odd, because normally |
780 | % there's some messing for compatibility with \LaTeX~2.09. |
781 | % |
782 | % \begin{macrocode} |
783 | \maxdepth.5\topskip |
784 | \@maxdepth\maxdepth |
785 | % \end{macrocode} |
786 | % |
787 | % Marginal notes need some setting up. |
788 | % |
789 | % \begin{macrocode} |
790 | \marginparpush5\p@ |
791 | % \end{macrocode} |
792 | % |
793 | % Footnotes need some setting up now. |
794 | % |
795 | % \begin{macrocode} |
796 | %<+8pt>\footnotesep5.8\p@ |
797 | %<+9pt>\footnotesep6.2\p@ |
798 | %<+10pt>\footnotesep6.65\p@ |
799 | %<+11pt>\footnotesep7.7\p@ |
800 | %<+12pt>\footnotesep8.4\p@ |
801 | %<+8pt>\setlength{\skip\footins}{7\p@\@plus4\p@\@minus2\p@} |
802 | %<+9pt>\setlength{\skip\footins}{8\p@\@plus4\p@\@minus2\p@} |
803 | %<+10pt>\setlength{\skip\footins}{9\p@\@plus4\p@\@minus2\p@} |
804 | %<+11pt>\setlength{\skip\footins}{10\p@\@plus4\p@\@minus2\p@} |
805 | %<+12pt>\setlength{\skip\footins}{10.8\p@\@plus4\p@\@minus2\p@} |
806 | %</8pt|9pt|10pt|11pt|12pt|text> |
807 | % \end{macrocode} |
808 | % |
809 | % \subsection{Float placement} |
810 | % |
811 | % First, we determine how we position the floats on the page. |
812 | % |
813 | % \begin{macrocode} |
814 | %<*strayman> |
815 | \setcounter{topnumber}{2} |
816 | \renewcommand\topfraction{.7} |
817 | \setcounter{bottomnumber}{1} |
818 | \renewcommand\bottomfraction{.3} |
819 | \setcounter{totalnumber}{3} |
820 | \renewcommand\textfraction{.1} |
821 | \renewcommand\floatpagefraction{.8} |
822 | \setcounter{dbltopnumber}{2} |
823 | \renewcommand\dbltopfraction{.7} |
824 | \renewcommand\dblfloatpagefraction{.5} |
825 | %</strayman> |
826 | % \end{macrocode} |
827 | % |
828 | % Now we define the glue which surrounds floats. |
829 | % |
830 | % \begin{macrocode} |
831 | %<*8pt|9pt|10pt|11pt|12pt> |
832 | \floatsep12\p@\@plus2\p@\@minus2\p@ |
833 | \textfloatsep20\p@\@plus2\p@\@minus4\p@ |
834 | \dbltextfloatsep20\p@\@plus2\p@\@minus4\p@ |
835 | %<+8pt|9pt|10pt|11pt>\intextsep12\p@\@plus2\p@\@minus 2\p@ |
836 | %<+8pt|9pt|10pt|11pt>\dblfloatsep12\p@\@plus2\p@\@minus 2\p@ |
837 | %<+12pt>\intextsep14\p@\@plus4\p@\@minus 4\p@ |
838 | %<+12pt>\dblfloatsep14\p@\@plus2\p@\@minus 4\p@ |
839 | % \end{macrocode} |
840 | % |
841 | % We must now define the parameters for float pages and columns. |
842 | % |
843 | % \begin{macrocode} |
844 | \@fptop0\p@\@plus 1fil |
845 | %<+8pt|9pt|10pt|11pt>\@fpsep8\p@\@plus2fil |
846 | %<+12pt>\@fpsep10\p@\@plus2fil |
847 | \@fpbot0\p@\@plus 1fil |
848 | % |
849 | \@dblfptop0\p@\@plus 1fil |
850 | %<+8pt|9pt|10pt|11pt>\@dblfpsep8\p@\@plus 2fil |
851 | %<+12pt>\@dblfpsep10\p@\@plus2fil |
852 | \@dblfpbot0\p@\@plus 1fil |
853 | %</8pt|9pt|10pt|11pt|12pt> |
854 | % \end{macrocode} |
855 | % |
856 | % \section{Headers and footers} |
857 | % |
858 | % This part defines the standard page styles. By default, \strayman\ |
859 | % imports \package{fancyheadings} and uses them, although this section is |
860 | % retained in case anything actually needs the original \LaTeX-style |
861 | % headings. |
862 | % |
863 | % \begin{macrocode} |
864 | %<*strayman> |
865 | \def\ps@headings{% |
866 | \let\@oddfoot\@empty\let\@evenfoot\@empty |
867 | \def\@evenhead{\thepage\hfil\slshape\leftmark}% |
868 | \def\@oddhead{{\slshape\rightmark}\hfil\thepage}% |
869 | \let\@mkboth\markboth |
870 | \def\chaptermark##1{\markboth {##1}{}}% |
871 | \def\sectionmark##1{\markright {##1}}% |
872 | } |
873 | % |
874 | \def\ps@myheadings{% |
875 | \let\@oddfoot\@empty\let\@evenfoot\@empty |
876 | \def\@evenhead{\thepage\hfil\slshape\leftmark}% |
877 | \def\@oddhead{{\slshape\rightmark}\hfil\thepage}% |
878 | \let\@mkboth\@gobbletwo |
879 | \let\chaptermark\@gobble |
880 | \let\sectionmark\@gobble |
881 | } |
882 | % \end{macrocode} |
883 | % |
884 | % \section{Titles} |
885 | % |
886 | % \begin{macro}{\maketitle} |
887 | % This is a bit of a thorny issue at the moment. Really, these titles need |
888 | % a complete rewrite. The |\maketitle| command will only be used for inside |
889 | % front covers anyway. I'm wondering if it wouldn't be better just to use |
890 | % special case code for each individual manual. Until a decision is made, |
891 | % I'll leave this as it was in \package{book}. |
892 | % |
893 | % \begin{note} |
894 | % This code is largely uncommented. It seems to be fairly straightforward, |
895 | % and if I do need to change it, I'll probably start again from scratch |
896 | % anyway. |
897 | % \end{note} |
898 | % |
899 | % \begin{macrocode} |
900 | \if@titlepage |
901 | % |
902 | \newcommand\maketitle{% |
903 | \begin{titlepage}% |
904 | \let\footnotesize\small% |
905 | \let\footnoterule\relax% |
906 | \null\vfil% |
907 | \vskip 60\p@% |
908 | \begin{center}% |
909 | {\LARGE\@title\par}% |
910 | \vskip3em% |
911 | {% |
912 | \large% |
913 | \lineskip.75em% |
914 | \begin{tabular}[t]{c}% |
915 | \@author% |
916 | \end{tabular}% |
917 | \par% |
918 | }% |
919 | \vskip1.5em% |
920 | {\large \@date \par}% % Set date in \large size. |
921 | \end{center}% |
922 | \par% |
923 | \@thanks% |
924 | \vfil\null% |
925 | \end{titlepage}% |
926 | \setcounter{footnote}{0}% |
927 | \let\thanks\relax% |
928 | \let\maketitle\relax% |
929 | \gdef\@thanks{}% |
930 | \gdef\@author{}% |
931 | \gdef\@title{}% |
932 | } |
933 | % |
934 | \else |
935 | % |
936 | \newcommand\maketitle{% |
937 | \par% |
938 | \begingroup% |
939 | \renewcommand\thefootnote{\fnsymbol{footnote}}% |
940 | \def\@makefnmark{\hb@xt@\z@{$\m@th^{\@thefnmark}$\hss}}% |
941 | \long\def\@makefntext##1{% |
942 | \parindent1em\noindent% |
943 | \hb@xt@1.8em{\hss$\m@th^{\@thefnmark}$}##1% |
944 | }% |
945 | \if@twocolumn% |
946 | \ifnum\col@number=\@ne% |
947 | \@maketitle% |
948 | \else% |
949 | \twocolumn[\@maketitle]% |
950 | \fi% |
951 | \else% |
952 | \newpage% |
953 | \global\@topnum\z@% % Prevents figures from going at top of page. |
954 | \@maketitle% |
955 | \fi% |
956 | \thispagestyle{plain}% |
957 | \@thanks% |
958 | \endgroup% |
959 | \setcounter{footnote}{0}% |
960 | \let\thanks\relax% |
961 | \let\maketitle\relax% |
962 | \let\@maketitle\relax% |
963 | \gdef\@thanks{}% |
964 | \gdef\@author{}% |
965 | \gdef\@title{}% |
966 | } |
967 | % |
968 | \fi |
969 | % |
970 | \def\@maketitle{% |
971 | \newpage% |
972 | \null% |
973 | \vskip2em% |
974 | \begin{center}% |
975 | {\LARGE\@title\par}% |
976 | \vskip1.5em% |
977 | {% |
978 | \large% |
979 | \lineskip.5em% |
980 | \begin{tabular}[t]{c}% |
981 | \@author% |
982 | \end{tabular}% |
983 | \par% |
984 | }% |
985 | \vskip 1em% |
986 | {\large\@date}% |
987 | \end{center}% |
988 | \par% |
989 | \vskip1.5em% |
990 | } |
991 | % \end{macrocode} |
992 | % \end{macro} |
993 | % |
994 | % \begin{environment}{titlepage} |
995 | % |
996 | % The \env{titlepage} environment typesets its contents on a title page. |
997 | % The implementation is fairly straightforward: we just need to do some |
998 | % fiddling with two-column layouts. We also add in some hacking to make |
999 | % title pages centred properly, a bit like the \env{central} environment. |
1000 | % |
1001 | % \begin{macrocode} |
1002 | \newenvironment{titlepage}{% |
1003 | \cleardoublepage% |
1004 | \if@twocolumn% |
1005 | \@restonecoltrue\onecolumn% |
1006 | \else% |
1007 | \@restonecolfalse\newpage% |
1008 | \fi% |
1009 | \centrepage% |
1010 | \if@compatibility% |
1011 | \setcounter{page}{0}% |
1012 | \fi% |
1013 | }{% |
1014 | \thispagestyle{empty}% |
1015 | \if@restonecol% |
1016 | \twocolumn% |
1017 | \else% |
1018 | \newpage% |
1019 | \fi% |
1020 | } |
1021 | % \end{macrocode} |
1022 | % \end{environment} |
1023 | % |
1024 | % \begin{macro}{\centrepage} |
1025 | % |
1026 | % Change the page layout to centre everything properly. We guard against |
1027 | % this sort of thing happening again by clearing |\leftindent| and |
1028 | % |\sectindent|. This should only be cleared after the page has been |
1029 | % finished, for obvious reasons. |
1030 | % |
1031 | % \begin{macrocode} |
1032 | \def\centrepage{% |
1033 | \advance\oddsidemargin-\leftindent% |
1034 | \advance\evensidemargin-\leftindent% |
1035 | \advance\textwidth\leftindent% |
1036 | \advance\linewidth\leftindent% |
1037 | \advance\leftmargini0.5\leftindent% |
1038 | \leftindent\z@% |
1039 | \sectindent\z@% |
1040 | \hsize\textwidth% |
1041 | } |
1042 | % \end{macrocode} |
1043 | % \end{macro} |
1044 | % |
1045 | % \section{Sectioning commands} |
1046 | % |
1047 | % In \strayman, quite a lot of the sectioning is different. We |
1048 | % don't tend to number sections much. Also, the chapter heading style has |
1049 | % been completely rewritten (several times). |
1050 | % |
1051 | % \subsection{Setting up the counters} |
1052 | % |
1053 | % This is pretty simple stuff. |
1054 | % |
1055 | % \begin{macrocode} |
1056 | \newcommand\chaptermark[1]{} |
1057 | \setcounter{secnumdepth}{\if@numbering\if@runinsubsubsec2\else3\fi\else0\fi} |
1058 | \newcounter {part} |
1059 | \newcounter {chapter} |
1060 | \newcounter {section}[chapter] |
1061 | \newcounter {subsection}[section] |
1062 | \newcounter {subsubsection}[subsection] |
1063 | \newcounter {paragraph}[subsubsection] |
1064 | \newcounter {subparagraph}[paragraph] |
1065 | \renewcommand\thepart {\Roman{part}} |
1066 | \renewcommand\thechapter {\arabic{chapter}} |
1067 | \if@article |
1068 | \renewcommand\thesection {\arabic{section}} |
1069 | \else |
1070 | \renewcommand\thesection {\thechapter.\arabic{section}} |
1071 | \fi |
1072 | \renewcommand\thesubsection {\thesection.\arabic{subsection}} |
1073 | \renewcommand\thesubsubsection {\thesubsection .\arabic{subsubsection}} |
1074 | \renewcommand\theparagraph {\thesubsubsection.\arabic{paragraph}} |
1075 | \renewcommand\thesubparagraph {\theparagraph.\arabic{subparagraph}} |
1076 | % \end{macrocode} |
1077 | % |
1078 | % \subsection{Frontmatter, mainmatter and backmatter} |
1079 | % |
1080 | % We start off thinking we're in the main matter. The user ought to put a |
1081 | % |\frontmatter| command at the beginning of the document if this is not |
1082 | % correct, as it usually won't be. |
1083 | % |
1084 | % \begin{macrocode} |
1085 | \newif\if@mainmatter |
1086 | \@mainmattertrue |
1087 | \newcommand\frontmatter{% |
1088 | \cleardoublepage% |
1089 | \@mainmatterfalse% |
1090 | \pagenumbering{roman}% |
1091 | } |
1092 | \newcommand\mainmatter{% |
1093 | \cleardoublepage% |
1094 | \@mainmattertrue% |
1095 | \pagenumbering{arabic}% |
1096 | } |
1097 | \newcommand\backmatter{% |
1098 | \if@openright% |
1099 | \cleardoublepage% |
1100 | \else% |
1101 | \clearpage% |
1102 | \fi% |
1103 | \@mainmatterfalse% |
1104 | } |
1105 | % \end{macrocode} |
1106 | % |
1107 | % \subsection{Abstracts} |
1108 | % |
1109 | % \begin{environment}{abstract} |
1110 | % |
1111 | % The \env{abstract} environment reduces the type size and margins slightly. |
1112 | % Abstracts are placed on their own pages when the |titlepage| option is |
1113 | % enabled. The code is filched from the LaTeX article class. |
1114 | % |
1115 | % \begin{macrocode} |
1116 | \if@titlepage |
1117 | \newenvironment{abstract}{% |
1118 | \titlepage |
1119 | \null\vfil |
1120 | \@beginparpenalty\@lowpenalty |
1121 | \begin{center}% |
1122 | \bfseries \abstractname |
1123 | \@endparpenalty\@M |
1124 | \end{center}}% |
1125 | {\par\vfil\null\endtitlepage} |
1126 | \else |
1127 | \newenvironment{abstract}{% |
1128 | \if@twocolumn |
1129 | \section*{\abstractname}% |
1130 | \else |
1131 | \small |
1132 | \list{}{% |
1133 | \def\makelabel##1{% |
1134 | \normalfont% |
1135 | \fontseries{b}\fontfamily\headdefault\selectfont% |
1136 | ##1% |
1137 | }% |
1138 | \labelsep1em\labelwidth\z@\itemindent\labelsep% |
1139 | \rightmargin\leftmargin% |
1140 | } |
1141 | \item[\abstractname]% |
1142 | \fi} |
1143 | {\if@twocolumn\else\endlist\fi} |
1144 | \fi |
1145 | % \end{macrocode} |
1146 | % \end{environment} |
1147 | % |
1148 | % \subsection{Appendices} |
1149 | % |
1150 | % \begin{macro}{\appendix} |
1151 | % |
1152 | % This command sets everything up to typeset the appendix. |
1153 | % |
1154 | % \begin{macrocode} |
1155 | \newcommand\appendix{% |
1156 | \par% |
1157 | \setcounter{chapter}{0}% |
1158 | \setcounter{section}{0}% |
1159 | \renewcommand\@chapapp{\appendixname}% |
1160 | \if@article% |
1161 | \renewcommand\thesection{\Alph{section}}% |
1162 | \else% |
1163 | \renewcommand\thechapter{\Alph{chapter}}% |
1164 | \fi% |
1165 | \@appendixtrue% |
1166 | } |
1167 | % \end{macrocode} |
1168 | % \end{macro} |
1169 | % |
1170 | % \subsection{Parts} |
1171 | % |
1172 | % Part headings are typeset on completely unadorned sheets, devoid of page |
1173 | % numbers and suchlike. Because of the strange page layout, we have to |
1174 | % put the part heading into a |central| environment. to stop the page looking |
1175 | % horribly lopsided. |
1176 | % |
1177 | % \begin{macro}{\part} |
1178 | % |
1179 | % The |\part| macro moves to an appropriate page, changes the pagestyle to |
1180 | % empty to switch off page numbering, and then calls |\@part| or |\@spart| |
1181 | % as appropriate, according to whether a \lit* was supplied. We put some |
1182 | % |\vfil| glue in, to vertically centre anything that these commands typeset, |
1183 | % and ensure printing in a single column. |
1184 | % |
1185 | % \begin{macrocode} |
1186 | \newcommand\part{% |
1187 | \cleardoublepage% |
1188 | \thispagestyle{empty}% |
1189 | \if@twocolumn% |
1190 | \onecolumn% |
1191 | \@tempswatrue% |
1192 | \else% |
1193 | \@tempswafalse% |
1194 | \fi% |
1195 | \hbox{}\vfil% |
1196 | \begin{centrepage}% |
1197 | \secdef\@part\@spart% |
1198 | } |
1199 | % \end{macrocode} |
1200 | % |
1201 | % \begin{macro}{\@part} |
1202 | % |
1203 | % This is where most of the part heading typesetting is done. We stick a |
1204 | % line in the contents file, clear the heading markers, and typeset the |
1205 | % heading in the biggest letters we can find. When we're done, we call |
1206 | % |\@endpart| to do some common cleaning up. |
1207 | % |
1208 | % \begin{macrocode} |
1209 | \def\@part[#1]#2{% |
1210 | \ifnum\c@secnumdepth>-2\relax% |
1211 | \refstepcounter{part}% |
1212 | \addcontentsline{toc}{part}{\thepart\hspace{1em}#1}% |
1213 | \else% |
1214 | \addcontentsline{toc}{part}{#1}% |
1215 | \fi% |
1216 | \markboth{}{}% |
1217 | \centering% |
1218 | \interlinepenalty\@M% |
1219 | \reset@font% |
1220 | \ifnum\c@secnumdepth>-2\relax% |
1221 | \huge\bfseries\headfam\partname~\thepart% |
1222 | \par% |
1223 | \vskip20\p@ |
1224 | \fi% |
1225 | \normalfont\Huge\bfseries\headfam#2\par% |
1226 | \@endpart% |
1227 | } |
1228 | % \end{macrocode} |
1229 | % \end{macro} |
1230 | % |
1231 | % \begin{macro}{\@spart} |
1232 | % |
1233 | % Here we typeset just the part heading: numbers have been suppressed. Also |
1234 | % we don't put things into the contents file. Otherwise, this is similar to |
1235 | % |\@part|. |
1236 | % |
1237 | % \begin{macrocode} |
1238 | \def\@spart#1{% |
1239 | \centering% |
1240 | \interlinepenalty\@M% |
1241 | \reset@font% |
1242 | \normalfont\Huge\bfseries\headfam#1\par% |
1243 | \@endpart% |
1244 | } |
1245 | % \end{macrocode} |
1246 | % \end{macro} |
1247 | % |
1248 | % \begin{macro}{\@endpart} |
1249 | % |
1250 | % This does the clearing up operation after a part has been typeset. We |
1251 | % insert the other |\vfil| glue to centre the heading, clear the other |
1252 | % side of the page, if printing two-sided, and return if necessary to |
1253 | % two-column printing. |
1254 | % |
1255 | % \begin{macrocode} |
1256 | \def\@endpart{% |
1257 | \vfil\newpage% |
1258 | \end{centrepage}% |
1259 | \if@twoside% |
1260 | \hbox{}% |
1261 | \thispagestyle{empty}% |
1262 | \newpage% |
1263 | \fi% |
1264 | \if@tempswa% |
1265 | \twocolumn% |
1266 | \fi% |
1267 | } |
1268 | % \end{macrocode} |
1269 | % \end{macro} |
1270 | % \end{macro} |
1271 | % |
1272 | % \subsection{Chapters} |
1273 | % |
1274 | % The chapter typesetting has been more-or-less rewritten. We'll follow this |
1275 | % in a reasonable amount of detail. |
1276 | % |
1277 | % \begin{macro}{\@chapapp} |
1278 | % |
1279 | % Because |\appendix| needs to change what chapters are called, we add a |
1280 | % level of indirection through |\@chapapp|: |
1281 | % |
1282 | % \begin{macrocode} |
1283 | \newcommand\@chapapp{\chaptername} |
1284 | % \end{macrocode} |
1285 | % \end{macro} |
1286 | % |
1287 | % \begin{macro}{\chapter} |
1288 | % |
1289 | % The |\chapter| command is the main dispatcher for chapters. We move to |
1290 | % an appropriate page, depending on the |openright| setting, suppress |
1291 | % headers, and then call |\@chapter| or |\@schapter| as appropriate. |
1292 | % |
1293 | % \begin{macrocode} |
1294 | \newcommand\chapter{% |
1295 | \if@openright% |
1296 | \cleardoublepage% |
1297 | \else% |
1298 | \clearpage% |
1299 | \fi% |
1300 | \thispagestyle{plain}% |
1301 | \global\@topnum\z@% |
1302 | \@afterindentfalse% |
1303 | \secdef\@chapter\@schapter% |
1304 | } |
1305 | % \end{macrocode} |
1306 | % |
1307 | % \begin{macro}{\@chapter} |
1308 | % |
1309 | % There's a lot of messing about to do, depending on whether we're in the |
1310 | % main matter and so on. We'll take this carefully. |
1311 | % |
1312 | % \begin{macrocode} |
1313 | \def\@chapter[#1]#2{% |
1314 | % \end{macrocode} |
1315 | % |
1316 | % The first thing to do is put a line in the contents table. We need to |
1317 | % check |secnumdepth| and the |mainmatter| flag for this: we should only |
1318 | % include a number if both these tests pass. In this case, we also type a |
1319 | % message on the terminal. |
1320 | % |
1321 | % \begin{macrocode} |
1322 | \ifnum\c@secnumdepth>\m@ne% |
1323 | \if@mainmatter% |
1324 | \refstepcounter{chapter}% |
1325 | \typeout{\@chapapp\space\thechapter.}% |
1326 | \addcontentsline{toc}{chapter}{\protect\numberline{\thechapter}#1}% |
1327 | \else |
1328 | \addcontentsline{toc}{chapter}{#1}% |
1329 | \fi |
1330 | \else |
1331 | \addcontentsline{toc}{chapter}{#1} |
1332 | \fi |
1333 | % \end{macrocode} |
1334 | % |
1335 | % Now we put a bit of space in the lists of figures and tables, and set up |
1336 | % the mark to put the chapter heading in the running header. |
1337 | % \begin{macrocode} |
1338 | \chaptermark{#1}% |
1339 | \addtocontents{lof}{\protect\addvspace{10\p@}}% |
1340 | \addtocontents{lot}{\protect\addvspace{10\p@}}% |
1341 | % \end{macrocode} |
1342 | % |
1343 | % Finally, we need to decide how to typeset the chapter heading. On |
1344 | % single-column chapters, this is easy. On double-column formats, we need |
1345 | % to do horrid things with |\@topnewpage|. |
1346 | % |
1347 | % \begin{macrocode} |
1348 | \if@twocolumn% |
1349 | \@topnewpage[\@makechapterhead{% |
1350 | \hb@xt@.5\leftindent{\thechapter\hfil}% |
1351 | }{#2}]% |
1352 | \else% |
1353 | \@makechapterhead{% |
1354 | \hb@xt@.5\leftindent{\thechapter\hfil}% |
1355 | }{#2}% |
1356 | \@afterheading% |
1357 | \fi% |
1358 | } |
1359 | % \end{macrocode} |
1360 | % \end{macro} |
1361 | % |
1362 | % \begin{macro}{\@makechapterhead} |
1363 | % |
1364 | % This macro actually does the job of typesetting a chapter heading. Call |
1365 | % this routine as |\@makechapterhead{|\synt{number}|}{|\synt{title}|}|. |
1366 | % Here, \synt{number} is how to typeset the chapter number, and \synt{title} |
1367 | % is the rest of the title. To suppress the number, just leave \synt{number} |
1368 | % empty. The number is only typeset when it is correct to do so anyway. |
1369 | % |
1370 | % The spacing is rather awkward. We have to cope with two-column layouts, |
1371 | % which seem to require different spacing. In a double-column layout, |
1372 | % the title is normally one |\baselineskip| too high. Also, the space I |
1373 | % add at the bottom of the heading gets eaten in double-column chapters, |
1374 | % because I'm actually typesetting into a vbox which is floated to the top |
1375 | % by \LaTeX\ in a fairly horrid way. This can't really be worked around, |
1376 | % so we just make the space beneath the heading equal to |\dbltextfloatsep|, |
1377 | % which is what gets added anyway. |
1378 | % |
1379 | % The other snags are to do with the rule after the chapter heading. |
1380 | % Firstly, this is meant to be typeset into the left margin, like the |
1381 | % heading itself, which is a bit messy. More awkwardly, we have to be |
1382 | % careful not to let the depth of the line vary when the chapter heading has |
1383 | % descenders, although obviously we must lower the rule if the heading really |
1384 | % is very deep indeed. |
1385 | % |
1386 | % |
1387 | % We'll approach this a bit at a time. |
1388 | % |
1389 | % \begin{macrocode} |
1390 | \def\@makechapterhead#1#2{% |
1391 | \begingroup% % Stop my hacking messing things up |
1392 | % \end{macrocode} |
1393 | % |
1394 | % First, the top spacing. This is divided into two parts, by an invisible |
1395 | % rule: the |\vskip| above the rule is eaten by \TeX\ if this is a genuine |
1396 | % new page, but put into the floating vbox if this is a two-column affair. |
1397 | % The second bit is added in both cases. |
1398 | % |
1399 | % \begin{macrocode} |
1400 | \vskip\baselineskip% % This is gobbled in single column |
1401 | \hrule\@height\z@% % Stops TeX from binning my vskips |
1402 | \vskip32\p@% % Start chapters in a funny place |
1403 | % \end{macrocode} |
1404 | % |
1405 | % Now we actually typeset the heading. This is fairly simple: we must just |
1406 | % check that we need to typeset the number. |
1407 | % |
1408 | % \begin{macrocode} |
1409 | \normalfont\Huge\bfseries\headfam% % Choose a nice font for it |
1410 | \raggedright % Don't justify -- it looks nasty |
1411 | \@hangfrom{\hskip-\leftindent}% % Start text at `real left margin' |
1412 | \ifnum\c@secnumdepth>\m@ne% % Do we typeset chapter numbers? |
1413 | \if@mainmatter% % Are we past the front matter? |
1414 | #1% % Yes -- then typeset the number |
1415 | \fi\fi% % Now back to normality |
1416 | {#2}% % Typeset the actual chapter head |
1417 | \par\nobreak% % Back to vmode again, please |
1418 | % \end{macrocode} |
1419 | % |
1420 | % The next tricky bit is the space before the ruleoff. We must be careful |
1421 | % here: |
1422 | % |
1423 | % \begin{itemize} |
1424 | % |
1425 | % \item We want the rule to be the right depth below the heading baseline, |
1426 | % regardless of whether the heading contains descenders: helpfully, \TeX\ |
1427 | % omits |\baselineskip| glue before and after rules. |
1428 | % |
1429 | % \item We want the rule to always be below any oddly deep descenders that |
1430 | % a strange user might throw at us (e.g., horrid fractions or weird |
1431 | % |\vrule|s). |
1432 | % |
1433 | % \end{itemize} |
1434 | % |
1435 | % We accomplish this by scrutinising |\prevdepth| carefully. |
1436 | % |
1437 | % \begin{macrocode} |
1438 | \@tempdima14\p@% % Be this low below the baseline |
1439 | \advance\@tempdima-\prevdepth% % This is the actual skip then |
1440 | \ifdim\@tempdima<8\p@% % Is this not enough skippage? |
1441 | \@tempdima8\p@% % No: then skip some more |
1442 | \fi% |
1443 | \vskip\@tempdima% % Skip a bit below the title |
1444 | % \end{macrocode} |
1445 | % |
1446 | % Now we can set the rule. This needs a little care. |
1447 | % |
1448 | % \begin{macrocode} |
1449 | \@tempskipa\textwidth% % Find the width of the column |
1450 | \advance\@tempskipa\leftindent% % Add on the big lefthand gap |
1451 | \nointerlineskip% % Don't add any more space please |
1452 | \moveleft\leftindent\vbox{% % Shift something left by an amount |
1453 | \hrule\@width\@tempskipa% % Typeset the rule nicely |
1454 | }% |
1455 | \nointerlineskip% % Don't leave a gap beneath it |
1456 | % \end{macrocode} |
1457 | % |
1458 | % Finally, we leave a gap. In two-column layouts this is done for us, and |
1459 | % \LaTeX\ gobbles this glue and replaces it with |\dbltextfloatsep|. To make |
1460 | % things consistent, this is the glue we use anyway. |
1461 | % |
1462 | % \begin{macrocode} |
1463 | \nobreak% % This would be a bad place to break |
1464 | \vspace{\dbltextfloatsep}% % Add in some extra glue beneath |
1465 | \endgroup% |
1466 | } |
1467 | % \end{macrocode} |
1468 | % \end{macro} |
1469 | % |
1470 | % \begin{macro}{\@makeschapterhead} |
1471 | % |
1472 | % This is now just a veneer onto |\@makechapterhead|. It's needed, because |
1473 | % other bits of \LaTeX\ call it. |
1474 | % |
1475 | % \begin{macrocode} |
1476 | \def\@makeschapterhead{% |
1477 | \@makechapterhead{} |
1478 | } |
1479 | % \end{macrocode} |
1480 | % \end{macro} |
1481 | % |
1482 | % \begin{macro}{\@schapter} |
1483 | % |
1484 | % This macro typesets a starred chapter heading. This is terribly simple, |
1485 | % compared to the sort of things we've been doing so far. |
1486 | % |
1487 | % \begin{macrocode} |
1488 | \def\@schapter#1{% |
1489 | \if@twocolumn% |
1490 | \@topnewpage[\@makeschapterhead{#1}]% |
1491 | \else% |
1492 | \@makeschapterhead{#1}% |
1493 | \@afterheading% |
1494 | \fi% |
1495 | } |
1496 | % \end{macrocode} |
1497 | % \end{macro} |
1498 | % \end{macro} |
1499 | % |
1500 | % \subsection{The other sectioning commands} |
1501 | % |
1502 | % These are all defined through |\@startsection|. They've been modified |
1503 | % to typeset sections and subsections hanging into the left margin, and to |
1504 | % moderate the amount of following space, due to the extra |\parskip| already |
1505 | % introduced. |
1506 | % |
1507 | % \begin{macrocode} |
1508 | \newcommand\section{% |
1509 | \@startsection% |
1510 | {section}% % Section name (for contents) |
1511 | {1}% % Level number (for numbering) |
1512 | {-.5\sectindent}% % Indentation of title |
1513 | {-1.5ex\@plus-1ex\@minus-.2ex}% % Space after title (vert/horiz) |
1514 | {.3ex\@plus.2ex}% % Space before title |
1515 | {\reset@font\Large\bfseries\headfam}% How to typeset the title |
1516 | } |
1517 | \newcommand\subsection{% |
1518 | \@startsection% |
1519 | {subsection}% |
1520 | {2}% |
1521 | {-.25\sectindent}% |
1522 | {-1.25ex\@plus-1ex\@minus-.2ex}% |
1523 | {\p@\@plus.2ex}% |
1524 | {\reset@font\large\bfseries\headfam}% |
1525 | } |
1526 | \if@runinsubsubsec |
1527 | \newcommand\subsubsection{% |
1528 | \@startsection% |
1529 | {subsubsection}% |
1530 | {3}% |
1531 | {\z@}% |
1532 | {0pt\@plus1ex\@minus.2ex}% |
1533 | {-1em}% |
1534 | {\reset@font\normalsize\bfseries\headfam}% |
1535 | } |
1536 | \newcommand\paragraph{% |
1537 | \@startsection% |
1538 | {paragraph}% |
1539 | {4}% |
1540 | {\z@}% |
1541 | {0pt\@plus.5ex\@minus.1ex}% |
1542 | {-1em}% |
1543 | {\reset@font\normalsize\bfseries\headfam}% |
1544 | } |
1545 | \newcommand\subparagraph{% |
1546 | \@startsection% |
1547 | {subparagraph}% |
1548 | {5}% |
1549 | {\parindent}% |
1550 | {0pt\@plus.5ex\@minus.1ex}% |
1551 | {-1em}% |
1552 | {\reset@font\normalsize\bfseries\headfam}% |
1553 | } |
1554 | \else |
1555 | \newcommand\subsubsection{% |
1556 | \@startsection% |
1557 | {subsubsection}% |
1558 | {3}% |
1559 | {\z@}% |
1560 | {-1.25ex\@plus-1ex\@minus-.2ex}% |
1561 | {\p@\@plus.2ex}% |
1562 | {\reset@font\normalsize\bfseries\headfam}% |
1563 | } |
1564 | \newcommand\paragraph{% |
1565 | \@startsection% |
1566 | {paragraph}% |
1567 | {4}% |
1568 | {\z@}% |
1569 | {0pt\@plus1ex\@minus.2ex}% |
1570 | {-1em}% |
1571 | {\reset@font\normalsize\bfseries\headfam}% |
1572 | } |
1573 | \newcommand\subparagraph{% |
1574 | \@startsection% |
1575 | {subparagraph}% |
1576 | {5}% |
1577 | {\parindent}% |
1578 | {0pt\@plus.5ex\@minus.1ex}% |
1579 | {-1em}% |
1580 | {\reset@font\normalsize\bfseries\headfam}% |
1581 | } |
1582 | \fi |
1583 | % \end{macrocode} |
1584 | % |
1585 | % \subsection{Section number formatting} |
1586 | % |
1587 | % \begin{macro}{\@seccntformat} |
1588 | % |
1589 | % The macro is given a section counter and must format it in some nice way. |
1590 | % |
1591 | % \begin{macrocode} |
1592 | \def\@seccntformat#1{% |
1593 | \llap{\csname the#1\endcsname{\normalsize\quad}\hfil}% |
1594 | } |
1595 | % |
1596 | % \subsection{Top level sectioning} |
1597 | % |
1598 | % \begin{macro}{\@topsect} |
1599 | % |
1600 | % Articles are divided into sections; other documents are divided into |
1601 | % chapters. Things like the table of contents need to know which. |
1602 | % |
1603 | % \begin{macrocode} |
1604 | \if@article |
c3f26ad3 |
1605 | \def\@topsect@star{\section*} |
1606 | \let\@topsect\section |
1ffa9044 |
1607 | \else |
c3f26ad3 |
1608 | \let\@topsect@star\chapter |
1ffa9044 |
1609 | \let\@topsect\chapter |
1610 | \fi |
1611 | % \end{macrocode} |
1612 | % |
1613 | % \end{macro} |
1614 | % |
1615 | % |
1616 | % \section{List handling} |
1617 | % |
1618 | % A surprising number of \LaTeX's environments are defined in terms of |
1619 | % lists, many of which hide the fact by putting the entire text in one big |
1620 | % item. |
1621 | % |
1622 | % This part of the document class has to set up lots of list parameters. |
1623 | % This is largely the same as the standard classes, altered slightly to cope |
1624 | % with the different paragraph spacing. |
1625 | % |
1626 | % \subsection{General list parameters} |
1627 | % |
1628 | % Default left margins for lists: |
1629 | % |
1630 | % \begin{macrocode} |
1631 | \if@twocolumn |
1632 | \leftmargini2em |
1633 | \else |
1634 | \leftmargini2.2em |
1635 | \fi |
1636 | \leftmarginii2em |
1637 | \leftmarginiii1.87em |
1638 | \leftmarginiv1.7em |
1639 | \if@twocolumn |
1640 | \leftmarginv.5em |
1641 | \leftmarginvi.5em |
1642 | \else |
1643 | \leftmarginv1em |
1644 | \leftmarginvi1em |
1645 | \fi |
1646 | % \end{macrocode} |
1647 | % |
1648 | % Other spacing defaults: |
1649 | % |
1650 | % \begin{macrocode} |
1651 | \leftmargin\leftmargini |
1652 | \labelsep.5em |
1653 | \labelwidth\leftmargini |
1654 | \advance\labelwidth-\labelsep |
1655 | \partopsep\z@\@plus1\p@\@minus1\p@ |
1656 | % \end{macrocode} |
1657 | % |
1658 | % Interline penalties: |
1659 | % |
1660 | % \begin{macrocode} |
1661 | \@beginparpenalty -\@lowpenalty |
1662 | \@endparpenalty -\@lowpenalty |
1663 | \@itempenalty -\@lowpenalty |
1664 | % \end{macrocode} |
1665 | % |
1666 | % Now we define the defaults for the list environments. These have managed |
1667 | % to migrate from the size options into the main document class. |
1668 | % |
1669 | % \begin{macrocode} |
1670 | \def\@listI{% |
1671 | \leftmargin\leftmargini% |
1672 | \parsep\parskip% |
1673 | \topsep\z@% |
1674 | \itemsep\z@% |
1675 | } |
1676 | \let\@listi\@listI |
1677 | \@listi\topsep\parskip% |
1678 | \def\@listii{% |
1679 | \leftmargin\leftmarginii% |
1680 | \labelwidth\leftmarginii% |
1681 | \advance\labelwidth-\labelsep% |
1682 | } |
1683 | \def\@listiii{% |
1684 | \leftmargin\leftmarginiii% |
1685 | \labelwidth\leftmarginiii% |
1686 | \advance\labelwidth-\labelsep% |
c3f26ad3 |
1687 | % \partopsep\p@\@plus\z@\@minus\p@% |
1ffa9044 |
1688 | } |
1689 | \def\@listiv{% |
1690 | \leftmargin\leftmarginiv% |
1691 | \labelwidth\leftmarginiv% |
1692 | \advance\labelwidth-\labelsep% |
1693 | } |
1694 | \def\@listv{% |
1695 | \leftmargin\leftmarginv% |
1696 | \labelwidth\leftmarginv% |
1697 | \advance\labelwidth-\labelsep% |
1698 | } |
1699 | \def\@listvi{% |
1700 | \leftmargin\leftmarginvi% |
1701 | \labelwidth\leftmarginvi% |
1702 | \advance\labelwidth-\labelsep% |
1703 | } |
1704 | % \end{macrocode} |
1705 | % |
186f3b71 |
1706 | % \subsection{Numbering things} |
1707 | % |
1708 | % \begin{macro}{\numberwithin} |
1709 | % |
1710 | % Does the obvious thing. Optional argument gives numbering style. |
1711 | % |
1712 | % \begin{macrocode} |
1713 | \def\numberwithin{\@testopt\nw@i\arabic} |
1714 | \def\nw@i[#1]#2#3{% |
1715 | \@addtoreset{#2}{#3}% |
1716 | \expandafter\xdef\csname the#2\endcsname{% |
1717 | \expandafter\noexpand\csname the#3\endcsname.% |
1718 | \noexpand#1{#2}}% |
1719 | } |
1720 | % \end{macrocode} |
1721 | % |
1722 | % \end{macro} |
1723 | % |
1724 | % \begin{macro}{\removefromreset} |
1725 | % |
1726 | % Does the obvious thing. |
1727 | % |
1728 | % \begin{macrocode} |
1729 | \def\removefromreset#1#2{% |
1730 | \begingroup% |
1731 | \def\@tempa{#1}% |
1732 | \toks@{}% |
1733 | \def\@elt##1{% |
1734 | \def\@tempb{##1}% |
1735 | \ifx\@tempa\@tempb% |
1736 | \else\toks@\expandafter{\the\toks@\@elt{##1}}% |
1737 | \fi% |
1738 | } |
1739 | \csname cl@#2\endcsname% |
1740 | \expandafter\xdef\csname cl@#2\endcsname{\the\toks@}% |
1741 | \endgroup% |
1742 | } |
1743 | % \end{macrocode} |
1744 | % |
1745 | % \end{macro} |
1746 | % |
1ffa9044 |
1747 | % \subsection{Enumerated lists} |
1748 | % |
1749 | % We busily redefine all the counters for enumerated lists, and how to |
1750 | % typeset them. |
1751 | % |
1752 | % How to typeset the numbers: |
1753 | % |
1754 | % \begin{macrocode} |
1755 | \renewcommand\theenumi{\arabic{enumi}} |
1756 | \renewcommand\theenumii{\alph{enumii}} |
1757 | \renewcommand\theenumiii{\roman{enumiii}} |
1758 | \renewcommand\theenumiv{\Alph{enumiv}} |
1759 | % \end{macrocode} |
1760 | % |
1761 | % Typesetting the item labels: |
1762 | % |
1763 | % \begin{macrocode} |
1764 | \newcommand\labelenumi{\theenumi.} |
1765 | \newcommand\labelenumii{(\theenumii)} |
1766 | \newcommand\labelenumiii{\theenumiii.} |
1767 | \newcommand\labelenumiv{\theenumiv.} |
1768 | % \end{macrocode} |
1769 | % |
1770 | % And finally how to typeset references to the items: |
1771 | % |
1772 | % \begin{macrocode} |
1773 | \renewcommand\p@enumii{\theenumi} |
1774 | \renewcommand\p@enumiii{\theenumi(\theenumii)} |
1775 | \renewcommand\p@enumiv{\p@enumiii\theenumiii} |
1776 | % \end{macrocode} |
1777 | % |
1778 | % \subsection{Itemized lists} |
1779 | % |
1780 | % We set up the various bullet shapes for the itemized lists. |
1781 | % |
1782 | % \begin{macrocode} |
1783 | \newcommand\labelitemi{$\m@th\bullet$} |
1784 | \newcommand\labelitemii{\normalfont\bfseries --} |
1785 | \newcommand\labelitemiii{$\m@th\ast$} |
1786 | \newcommand\labelitemiv{$\m@th\cdot$} |
1787 | % \end{macrocode} |
1788 | % |
1789 | % \subsection{Description lists} |
1790 | % |
1791 | % This has been redefined a little to make it more sensible. The old version |
1792 | % had a weird |\hspace\labelsep| in the labelling macro. This has now been |
1793 | % added into the main list definition. You can now redefine |
1794 | % |\descriptionlabel| without fear of messing up the spacing. |
1795 | % |
1796 | % \begin{environment}{description} |
1797 | % |
1798 | % Here we set up the main list parameters. The label width is zeroed to |
1799 | % ensure that the text is always indented nicely. |
1800 | % |
1801 | % \begin{macrocode} |
1802 | \def\description{% |
1803 | \list{}{% |
1804 | \labelwidth\z@% |
1805 | \itemindent-\leftmargin% |
1806 | \advance\itemindent\labelsep% |
1807 | \def\makelabel{\descriptionlabel}% |
1808 | }% |
1809 | } |
1810 | \let\enddescription\endlist |
1811 | % \end{macrocode} |
1812 | % |
1813 | % \begin{macro}{\descriptionlabel} |
1814 | % |
1815 | % This typesets a description label. Redefine it the obvious way for |
1816 | % different exciting effects. |
1817 | % |
1818 | % \begin{macrocode} |
1819 | \def\descriptionlabel#1{\normalfont\bfseries #1} |
1820 | % \end{macrocode} |
1821 | % |
1822 | % \end{macro} |
1823 | % \end{environment} |
1824 | % |
1825 | % \subsection{Other list-based environments} |
1826 | % |
1827 | % Several other standard environments are defined in terms of lists. These |
1828 | % are all dealt with here. |
1829 | % |
1830 | % \begin{environment}{verse} |
1831 | % |
1832 | % The \env{verse} environment is specially fiddled so that |\\| works as it |
1833 | % should. There's nothing else exciting about it. |
1834 | % |
1835 | % \begin{macrocode} |
1836 | \newenvironment{verse}{% |
1837 | \let\\\@centercr% |
1838 | \list{}{% |
1839 | \itemsep\z@% |
1840 | \itemindent-1.5em% |
1841 | \listparindent\itemindent% |
1842 | \rightmargin\leftmargin% |
1843 | \advance\leftmargin1.5em% |
1844 | }% |
1845 | \item[]% |
1846 | }{% |
1847 | \endlist% |
1848 | } |
1849 | % \end{macrocode} |
1850 | % \end{environment} |
1851 | % |
1852 | % \begin{environment}{quotation} |
1853 | % |
1854 | % The \env{quotation} environment is a pretty standard display, except that |
1855 | % we kill off inter-paragraph space. The current definition means that |
1856 | % \env{quotation}s are typeset in normal indented-paragraph style, which |
1857 | % is inconsistent with the rest of the document style. |
1858 | % |
1859 | % \begin{macrocode} |
1860 | \newenvironment{quotation}{% |
1861 | \list{}{% |
1862 | \listparindent\z@% |
1863 | \itemindent\listparindent% |
1864 | \rightmargin\leftmargin% |
1865 | }% |
1866 | \item[]% |
1867 | }{% |
1868 | \endlist% |
1869 | } |
1870 | % \end{macrocode} |
1871 | % \end{environment} |
1872 | % |
1873 | % \begin{environment}{quote} |
1874 | % |
1875 | % This is even simpler. We just pull in the right margin a bit. |
1876 | % |
1877 | % \begin{macrocode} |
1878 | \newenvironment{quote}{% |
1879 | \list{}{% |
1880 | \rightmargin\leftmargin% |
1881 | }% |
1882 | \item[]% |
1883 | }{% |
1884 | \endlist% |
1885 | } |
1886 | % \end{macrocode} |
1887 | % \end{environment} |
1888 | % |
1889 | % \begin{environment}{display} |
1890 | % |
1891 | % The \env{display} environment is intended for any other displays which you |
1892 | % need to typeset. This is \emph{not} a standard environment. |
1893 | % |
1894 | % \begin{macrocode} |
1895 | \newenvironment{display}{% |
1896 | \list{}{% |
1897 | \leftmargin1em% |
1898 | \rightmargin\leftmargin% |
1899 | \labelsep\z@% |
1900 | \labelwidth\z@% |
1901 | }% |
1902 | \item[]\relax% |
1903 | }{% |
1904 | \endlist% |
1905 | } |
1906 | % \end{macrocode} |
1907 | % \end{environment} |
1908 | % |
1909 | % And some quick hacking of the theorem environment. |
1910 | % |
1911 | % \section{Other parameters} |
1912 | % |
1913 | % We define some miscellaneous parameters for standard environments. |
1914 | % |
1915 | % \begin{macrocode} |
1916 | \arraycolsep5\p@ |
1917 | \tabcolsep6\p@ |
1918 | \arrayrulewidth.4\p@ |
1919 | \doublerulesep2\p@ |
1920 | \tabbingsep\labelsep |
1921 | \skip\@mpfootins\skip\footins |
1922 | \fboxsep3\p@ |
1923 | \fboxrule.4\p@ |
1924 | % |
1925 | \if@article |
1926 | \renewcommand\theequation{\arabic{equation}} |
1927 | \else |
1928 | \@addtoreset{equation}{chapter} |
1929 | \renewcommand\theequation{\thechapter.\arabic{equation}} |
1930 | \fi |
1931 | % \end{macrocode} |
1932 | % |
1933 | % \section{Floats} |
1934 | % |
1935 | % Since raw \LaTeX\ doesn't actually define any floating objects, we have |
1936 | % to do some of the work here. This isn't actually terribly arduous. For |
1937 | % a float called \synt{float}, we have to define the following macros: |
1938 | % |
1939 | % \begin{description} |
1940 | % \let\descriptionlabel\relax |
1941 | % |
1942 | % \item[\texttt{\bslash fps@}\synt{float}] is the default float positioning |
1943 | % argument for the float type. |
1944 | % |
1945 | % \item[\texttt{\bslash ftype@}\synt{float}] is a flag bit for the float |
1946 | % type. This is used in \LaTeX's |\output| routine to identify floats of |
1947 | % this type. |
1948 | % |
1949 | % \item[\texttt{\bslash ext@}\synt{float}] is the file extension for the |
1950 | % list of these floats (e.g., \lit{lof} for figures). |
1951 | % |
1952 | % \item[\texttt{\bslash fnum@}\synt{float}] is a macro which generates the |
1953 | % caption number. For figures, this expands to `|Figure~\thefigure|'. |
1954 | % |
1955 | % \end{description} |
1956 | % |
1957 | % We must also define |\@makecaption|, which typesets a float caption in |
1958 | % an appropriate way, and an environment for each type of float. |
1959 | % |
1960 | % \subsection{Figures} |
1961 | % |
1962 | % This is all fairly straightforward stuff. First, we create a counter for |
1963 | % figures: |
1964 | % |
1965 | % \begin{macrocode} |
1966 | \newcounter{figure}[chapter] |
1967 | \if@article |
1968 | \renewcommand\thefigure{\@arabic\c@figure} |
1969 | \else |
1970 | \renewcommand\thefigure{\thechapter.\@arabic\c@figure} |
1971 | \fi |
1972 | % \end{macrocode} |
1973 | % |
1974 | % Now we define all the macros \LaTeX\ requires. |
1975 | % |
1976 | % \begin{macrocode} |
1977 | \if@herefloats\def\fps@figure{htbp}\else\def\fps@figure{tbp}\fi |
1978 | \def\ftype@figure{1} |
1979 | \def\ext@figure{lof} |
1980 | \def\fnum@figure{\figurename~\thefigure} |
1981 | % \end{macrocode} |
1982 | % |
1983 | % \begin{environment}{figure} |
1984 | % \begin{environment}{figure*} |
1985 | % |
1986 | % Finally, we create the \env{figure} and \env{figure$*$} environments. |
1987 | % |
1988 | % \begin{macrocode} |
1989 | \newenvironment{figure}{\@float{figure}}{\end@float} |
1990 | \newenvironment{figure*}{\@dblfloat{figure}}{\end@dblfloat} |
1991 | % \end{macrocode} |
1992 | % \end{environment} |
1993 | % \end{environment} |
1994 | % |
1995 | % \subsection{Tables} |
1996 | % |
1997 | % This is pretty similar to the figure handling. |
1998 | % |
1999 | % \begin{macrocode} |
2000 | \newcounter{table}[chapter] |
2001 | \if@article |
2002 | \renewcommand\thetable{\@arabic\c@table} |
2003 | \else |
2004 | \renewcommand\thetable{\thechapter.\@arabic\c@table} |
2005 | \fi |
2006 | % |
2007 | \if@herefloats\def\fps@table{htbp}\else\def\fps@table{tbp}\fi |
2008 | \def\ftype@table{2} |
2009 | \def\ext@table{lot} |
2010 | \def\fnum@table{\tablename~\thetable} |
2011 | % |
2012 | \newenvironment{table}{\@float{table}}{\end@float} |
2013 | \newenvironment{table*}{\@dblfloat{table}}{\end@dblfloat} |
2014 | % \end{macrocode} |
2015 | % |
2016 | % \subsection{Other float parameters} |
2017 | % |
2018 | % \begin{macro}{\@makecaption} |
2019 | % |
2020 | % The |\@makecaption| macro is called to display a float caption. It will |
2021 | % typeset its argument either centred in a box, if it is short enough, or |
2022 | % in a paragraph if it is longer than a line. |
2023 | % |
2024 | % \begin{macrocode} |
2025 | \newlength\abovecaptionskip |
2026 | \newlength\belowcaptionskip |
2027 | \abovecaptionskip10\p@ |
2028 | \belowcaptionskip0\p@ |
2029 | % |
c3f26ad3 |
2030 | \long\def\captionstyle#1#2{\itshape #1: #2} |
1ffa9044 |
2031 | \long\def\@makecaption#1#2{% |
2032 | \vskip\abovecaptionskip% |
c3f26ad3 |
2033 | \sbox\@tempboxa{\captionstyle{#1}{#2}}% |
1ffa9044 |
2034 | \ifdim\wd\@tempboxa>\hsize% |
c3f26ad3 |
2035 | \unhbox\@tempboxa\par% |
1ffa9044 |
2036 | \else% |
c3f26ad3 |
2037 | \hb@xt@\hsize{\hfil\unhbox\@tempboxa\hfil}% |
1ffa9044 |
2038 | \fi% |
2039 | \vskip\belowcaptionskip% |
2040 | } |
2041 | % \end{macrocode} |
2042 | % \end{macro} |
2043 | % |
2044 | % \section{Font commands} |
2045 | % |
2046 | % We allow the `old' font commands to do sensible \textsf{NFSS} things, since |
2047 | % we don't have any legacy documents. This means that we have proper |
2048 | % abbreviations for font changes. We also add |\nm| to return to a normal |
2049 | % font, whatever that may mean. |
2050 | % |
2051 | % \begin{macrocode} |
2052 | \DeclareOldFontCommand{\rm}{\rmfamily}{\mathrm} |
2053 | \DeclareOldFontCommand{\sf}{\sffamily}{\mathsf} |
2054 | \DeclareOldFontCommand{\tt}{\ttfamily}{\mathtt} |
2055 | \DeclareOldFontCommand{\bf}{\bfseries}{\mathbf} |
2056 | \DeclareOldFontCommand{\md}{\mdseries}{\@nomath\md} |
2057 | \DeclareOldFontCommand{\it}{\itshape}{\mathit} |
2058 | \DeclareOldFontCommand{\up}{\upshape}{\@nomath\up} |
2059 | \DeclareOldFontCommand{\sl}{\slshape}{\@nomath\sl} |
2060 | \DeclareOldFontCommand{\sc}{\scshape}{\@nomath\sc} |
2061 | \DeclareOldFontCommand{\nm}{\normalfont}{\mathnormal} |
2062 | % \end{macrocode} |
2063 | % |
2064 | % Now we define some special commands which only work in maths mode. It |
2065 | % seems that older versions of \LaTeX\ (in particular, that at Warwick |
2066 | % University) don't define these commands initially, so we'd better not |
2067 | % use |\renewcommand| after all. We also dispose of lots of messing with |
2068 | % |\protect| by using |\DeclareRobustCommand|. |
2069 | % |
2070 | % \begin{macrocode} |
2071 | \DeclareRobustCommand\cal{\@fontswitch{\relax}{\mathcal}} |
2072 | \DeclareRobustCommand\pmit{\@fontswitch{\relax}{\mathnormal}} |
2073 | % \end{macrocode} |
2074 | % |
2075 | % \section{Tables of contents} |
2076 | % |
2077 | % This section deals with tables of contents, and lists of figures. |
2078 | % |
2079 | % \subsection{Contents} |
2080 | % |
2081 | % First, we have to define some parameters. |
2082 | % |
2083 | % \begin{macrocode} |
2084 | \newcommand\@pnumwidth{2em} |
2085 | \newcommand\@tocrmarg {3em} |
2086 | \newcommand\@dotsep{4.5} |
2087 | \setcounter{tocdepth}{\if@runinsubsubsec1\else2\fi} |
2088 | % \end{macrocode} |
2089 | % |
2090 | % \begin{macro}{\tableofcontents} |
2091 | % |
2092 | % This is the main command for setting up tables of contents. We ensure |
2093 | % a single-page layout, put in the chapter heading, read in the contents |
2094 | % file, and then restore the old layout. |
2095 | % |
2096 | % \begin{macrocode} |
c3f26ad3 |
2097 | \def\@tocthing#1#2{% |
2098 | \@ifnextchar[{\@tocthing@i{#1}{#2}}{\@tocthing@i{#1}{#2}[\relax][\relax]}% |
2099 | } |
2100 | \def\@tocthing@i#1#2[#3][#4]{% |
2101 | \if@twocolumn\@restonecoltrue\onecolumn\else\@restonecolfalse\fi% |
2102 | \@topsect@star{#1}#3{\parskip\z@\@starttoc{#2}}#4% |
2103 | \if@restonecol\twocolumn\fi% |
1ffa9044 |
2104 | } |
c3f26ad3 |
2105 | \newcommand\tableofcontents{\@tocthing\contentsname{toc}} |
1ffa9044 |
2106 | % \end{macrocode} |
2107 | % \end{macro} |
2108 | % |
2109 | % Each section type \synt{type} is typeset by a command |\l@|\synt{type}: |
2110 | % for example, the |\l@chapter| command typesets the entry for a chapter |
2111 | % heading. |
2112 | % |
2113 | % \begin{macro}{\l@part} |
2114 | % |
2115 | % This command is vaguely interesting. We'll explore in detail. |
2116 | % |
2117 | % \begin{macrocode} |
2118 | \def\l@part#1#2{% |
2119 | % \end{macrocode} |
2120 | % |
2121 | % We don't typeset the entry if |tocdepth| tells us not to. What kind of |
2122 | % stupid user is going to disable \emph{all} the contents items. |
2123 | % |
2124 | % \begin{macrocode} |
2125 | \ifnum\c@tocdepth>-2\relax% |
2126 | % \end{macrocode} |
2127 | % |
2128 | % Before we start, we try to break above the title. Later, we'll disable |
2129 | % breaking afterwards. We then leave some vertical space. |
2130 | % |
2131 | % \begin{macrocode} |
2132 | \addpenalty{-\@highpenalty}% |
2133 | \addvspace{2.25em\@plus\p@}% |
2134 | % \end{macrocode} |
2135 | % |
2136 | % We open a group, to avoid messing other things up. The |\numberline| |
2137 | % macro, which numbers the entry on the left, typesets its argument in a box |
2138 | % of width |\@tempdima|, which we must set up. We then set up the values |
2139 | % of |\rightskip| and |\parfillskip| to avoid printing over the page number. |
2140 | % We also make |\interlinepenalty| infinite to suppress breaking pages in |
2141 | % the middle of the title. |
2142 | % |
2143 | % \begin{macrocode} |
2144 | \begingroup% |
2145 | \@tempdima3em% |
2146 | \parindent\z@% |
2147 | \rightskip\@pnumwidth% |
2148 | \parfillskip-\@pnumwidth% |
2149 | \interlinepenalty\@M |
2150 | % \end{macrocode} |
2151 | % |
2152 | % Time to typeset the actual title. This is fairly simple, apart from |
2153 | % a complicated mixture of glue and penalties, which handles a line break |
2154 | % right at the end of the title. |
2155 | % |
2156 | % \begin{macrocode} |
2157 | {% |
2158 | \leavevmode% |
2159 | \large\bfseries {#1}% |
2160 | \nobreak\hfil\penalty\@highpenalty\hbox{}\nobreak\hfil% |
2161 | \hb@xt@\@pnumwidth{\hss #2}% |
2162 | }% |
2163 | % \end{macrocode} |
2164 | % |
2165 | % Now we end the paragraph and suppress page breaking here. |
2166 | % |
2167 | % \begin{macrocode} |
2168 | \par% |
2169 | \nobreak% |
2170 | \global\@nobreaktrue% |
2171 | \everypar{\global\@nobreakfalse\everypar{}}% |
2172 | \endgroup% |
2173 | \fi% |
2174 | } |
2175 | % \end{macrocode} |
2176 | % \end{macro} |
2177 | % |
2178 | % \begin{macro}{\@artsw} |
2179 | % |
2180 | % Define a macro named after the first or second argument depending on |
2181 | % whether the document is an article. |
2182 | % |
2183 | % \begin{macrocode} |
2184 | \def\@artsw#1#2#3{% |
2185 | \edef\@tempa{#1\if@article\noexpand#3\else\noexpand#2\fi}% |
2186 | \@tempa% |
2187 | } |
2188 | % \end{macrocode} |
2189 | % |
2190 | % \end{macro} |
2191 | % |
2192 | % \begin{macro}{\l@chapter} |
2193 | % |
2194 | % This is terribly similar to the previous macro. |
2195 | % |
2196 | % \begin{macrocode} |
2197 | \@artsw\def\l@chapter\l@section#1#2{% |
2198 | \ifnum\c@tocdepth >\m@ne% |
2199 | \addpenalty{-\@highpenalty}% |
2200 | \vskip1.0em\@plus\p@% |
2201 | \setlength\@tempdima{2em}% |
2202 | \begingroup% |
2203 | \interlinepenalty\@M |
2204 | \parindent\z@% |
2205 | \rightskip\@pnumwidth% |
2206 | \parfillskip-\@pnumwidth% |
2207 | \leavevmode% |
2208 | \bfseries% |
2209 | \advance\leftskip\@tempdima% |
2210 | \hskip-\leftskip% |
2211 | {#1}% |
2212 | \nobreak\hfil\penalty\@highpenalty\hbox{}\nobreak\hfil% |
2213 | \hb@xt@\@pnumwidth{\hss #2}% |
2214 | \par% |
2215 | \penalty\@highpenalty% |
2216 | \endgroup% |
2217 | \fi% |
2218 | } |
2219 | % \end{macrocode} |
2220 | % \end{macro} |
2221 | % |
2222 | % The other types are all defined in terms of |\@dottedtocline|, which is |
2223 | % redefined beloew. |
2224 | % |
2225 | % \begin{macrocode} |
2226 | \@artsw\def\l@section\l@subsection{\@dottedtocline{1}{2em}{2.5em}} |
2227 | \@artsw\def\l@subsection\l@subsubsection{\@dottedtocline{2}{4.5em}{3.2em}} |
2228 | \@artsw\def\l@subsubsection\l@paragraph{\@dottedtocline{3}{7.7em}{4.1em}} |
2229 | \@artsw\def\l@paragraph\l@subparagraph{\@dottedtocline{4}{10.5em}{5em}} |
2230 | \@artsw\def\l@subparagraph\@tempa{\@dottedtocline{5}{12.5em}{6em}} |
2231 | % \end{macrocode} |
2232 | % |
2233 | % \begin{macro}{\@dottedtocline} |
2234 | % |
2235 | % This is actually a part of the \LaTeX\ kernel, although it's not quite |
2236 | % right the way it is. We've improved the handling of line breaks after the |
2237 | % title. |
2238 | % |
2239 | % \begin{macrocode} |
2240 | \def\@dottedtocline#1#2#3#4#5{% |
2241 | % \end{macrocode} |
2242 | % |
2243 | % We have to make sure that we're meant to typeset this contents entry. |
2244 | % |
2245 | % \begin{macrocode} |
2246 | \ifnum#1>\c@tocdepth\else% |
2247 | % \end{macrocode} |
2248 | % |
2249 | % Now we add in a little stretchy space. |
2250 | % |
2251 | % \begin{macrocode} |
2252 | \vskip\z@\@plus.2\p@% |
2253 | % \end{macrocode} |
2254 | % |
2255 | % Set up the paragraph layout now. We forbid page breaks in the middle of |
2256 | % the title. |
2257 | % |
2258 | % \begin{macrocode} |
2259 | {% |
2260 | \leftskip#2\relax% |
2261 | \rightskip\@tocrmarg% |
2262 | \parfillskip-\rightskip% |
2263 | \parindent#2\relax% |
2264 | \@afterindenttrue% |
2265 | \interlinepenalty\@M% |
2266 | % \end{macrocode} |
2267 | % |
2268 | % Now we typeset the actual title. |
2269 | % |
2270 | % \begin{macrocode} |
2271 | \leavevmode% |
2272 | \@tempdima#3\relax% |
2273 | \advance\leftskip\@tempdima% |
2274 | \hbox{}% |
2275 | \hskip-\leftskip% |
2276 | {#4}% |
2277 | % \end{macrocode} |
2278 | % |
2279 | % This is the clever bit. After the actual title, we add the following |
2280 | % items: |
2281 | % |
2282 | % \begin{itemize} |
2283 | % |
2284 | % \item A |\nobreak| penalty, to stop a break from eating the glue. |
2285 | % |
2286 | % \item A glob of |\hfil| glue. If there's a line break after this glue, |
2287 | % the title is set flush left as a result of this. Otherwise, it is ignored |
2288 | % because the leaders are |\hfill|. |
2289 | % |
2290 | % \item A penalty. This is a reasonable place to break the line if |
2291 | % necessary. |
2292 | % |
2293 | % \item An empty |\hbox|. This stops the following glue from being discarded |
2294 | % at the beginning of a new line. |
2295 | % |
2296 | % \item Another |\nobreak|, which stops a break at the following glue item. |
2297 | % |
2298 | % \item The dotted |\leaders|, which have |\hfill| stretchiness. This forces |
2299 | % the page number to be flush right. |
2300 | % |
2301 | % \end{itemize} |
2302 | % |
2303 | % The net result of all this is we can now cope with a line break at the |
2304 | % end of the title, before the page number, which means that the dots are |
2305 | % put on the next line. The original \LaTeX\ version forced the last word |
2306 | % of the title onto the next line as well, which can cause underful boxes. |
2307 | % |
2308 | % \begin{macrocode} |
2309 | \nobreak\hfil\penalty\@highpenalty\hbox{}\nobreak% |
2310 | \leaders\hbox{$\m@th\mkern\@dotsep mu.\mkern\@dotsep mu$}\hfill% |
2311 | \hb@xt@\@pnumwidth{\hfil\reset@font\rmfamily#5}\par% |
2312 | }% |
2313 | \fi% |
2314 | } |
2315 | % \end{macrocode} |
2316 | % \end{macro} |
2317 | % |
2318 | % \subsection{Lists of figures and tables} |
2319 | % |
2320 | % These macros are terribly similar to the other ones. |
2321 | % |
2322 | % \begin{macrocode} |
c3f26ad3 |
2323 | \newcommand\listoffigures{\@tocthing\listfigurename{lof}} |
2324 | \newcommand\l@figure{\@dottedtocline{0}{0pt}{2em}} |
2325 | \newcommand\listoftables{\@tocthing\listtablename{lot}} |
1ffa9044 |
2326 | \let\l@table\l@figure |
2327 | % \end{macrocode} |
2328 | % |
2329 | % \section{Bibliography} |
2330 | % |
2331 | % This isn't actually terribly interesting. |
2332 | % |
2333 | % \begin{environment}{thebibliography} |
2334 | % |
2335 | % \begin{macrocode} |
2336 | \newdimen\bibindent |
2337 | \bibindent1.5em |
2338 | % |
2339 | \newenvironment{thebibliography}[1]{% |
2340 | \@topsect\bibname% |
2341 | \list{\@biblabel{\arabic{enumiv}}}% |
2342 | {\settowidth\labelwidth{\@biblabel{#1}}% |
2343 | \leftmargin\labelwidth% |
2344 | \advance\leftmargin\labelsep% |
2345 | \if@openbib% |
2346 | \advance\leftmargin\bibindent% |
2347 | \itemindent-\bibindent% |
2348 | \listparindent\itemindent% |
2349 | \parsep\z@% |
2350 | \fi% |
2351 | \usecounter{enumiv}% |
2352 | \let\p@enumiv\@empty% |
2353 | \renewcommand\theenumiv{\arabic{enumiv}}}% |
2354 | \if@openbib% |
2355 | \renewcommand\newblock{\par}% |
2356 | \else% |
2357 | \renewcommand\newblock{\hskip.11em\@plus.33em\@minus.07em}% |
2358 | \fi% |
2359 | \sloppy% |
2360 | \clubpenalty4000% |
2361 | \widowpenalty4000% |
2362 | \sfcode`\.\@m% |
2363 | }{% |
2364 | \def\@noitemerr{\@latex@warning{Empty `thebibliography' environment}}% |
2365 | \endlist% |
2366 | } |
2367 | % |
2368 | \newcommand\newblock{} |
2369 | % \end{macrocode} |
2370 | % \end{environment} |
2371 | % |
2372 | % \section{Index} |
2373 | % |
2374 | % Defines the \env{theindex} environment. |
2375 | % |
2376 | % \begin{environment}{theindex} |
2377 | % |
2378 | % The macros are fairly simple. We change to a two column layout, and |
2379 | % redefine |\item| appropriately. |
2380 | % |
2381 | % \begin{macrocode} |
2382 | \newenvironment{theindex}{% |
2383 | \columnseprule\z@% |
2384 | \columnsep35\p@% |
2385 | \@topsect\indexname% |
2386 | \if@twocolumn\else% |
2387 | \begin{multicols}{2}% |
2388 | \fi% |
2389 | \parskip\z@\@plus.3\p@\relax% |
2390 | \raggedright% |
2391 | \let\item\@idxitem% |
2392 | }{% |
2393 | \if@twocolumn\else% |
2394 | \end{multicols}% |
2395 | \fi% |
2396 | } |
2397 | % \end{macrocode} |
2398 | % \end{environment} |
2399 | % |
2400 | % Now we define the item and spacing macros. |
2401 | % |
2402 | % \begin{macrocode} |
2403 | \newcommand\@idxitem {\par\hangindent 40\p@} |
2404 | \newcommand\subitem {\par\hangindent 40\p@ \hspace*{20\p@}} |
2405 | \newcommand\subsubitem{\par\hangindent 40\p@ \hspace*{30\p@}} |
2406 | \newcommand\indexspace{\par \vskip 10\p@ \@plus5\p@ \@minus3\p@\relax} |
2407 | % \end{macrocode} |
2408 | % |
2409 | % \begin{macro}{\passim} |
2410 | % |
2411 | % The |passim| encapsulator is used to typeset the word `\textit{passim}' |
2412 | % after a page range. |
2413 | % |
2414 | % \begin{macrocode} |
2415 | \def\passim#1{#1 \textit{passim}} % Passim encapsulator for indices |
2416 | % \end{macrocode} |
2417 | % \end{macro} |
2418 | % |
2419 | % Other useful commands for indexing: |
2420 | % |
2421 | % \begin{description*} |
2422 | % \def\descriptionlabel#1{\ttfamily \bslash #1} |
2423 | % |
2424 | % \item[Term] typesets its argument in italics, and adds it to the index. |
2425 | % |
2426 | % \item[term] typesets its first argument in italics, and adds its second |
2427 | % to the index. |
2428 | % |
2429 | % \item[Index] typesets its argument normally, and adds it to the index. |
2430 | % |
2431 | % \end{description*} |
2432 | % |
2433 | % \begin{macrocode} |
2434 | \def\Term#1{\emph{#1}\index{#1}} |
2435 | \def\term#1{\emph{#1}\index} |
2436 | \def\Index#1{#1\index{#1}} |
2437 | % \end{macrocode} |
2438 | % |
2439 | % \section{Footnotes} |
2440 | % |
2441 | % \begin{macro}{\footnoterule} |
2442 | % |
2443 | % This macro typesets the rule above footnotes. This is a bit more complex |
2444 | % than the default: we try and typeset the rule to be at most 1\,in wide, |
2445 | % although if the column isn't wide enough, we use $4\over10$~of the |
2446 | % box width instead. |
2447 | % |
2448 | % \begin{macrocode} |
2449 | \def\footnoterule{% |
2450 | \@tempdima.4\columnwidth% |
2451 | \ifdim\@tempdima>1in\relax% |
2452 | \@tempdima1in\relax% |
2453 | \fi% |
2454 | \kern-3\p@% |
2455 | \hrule\@width\@tempdima% |
2456 | \kern2.6\p@% |
2457 | } |
2458 | % \end{macrocode} |
2459 | % \end{macro} |
2460 | % |
2461 | % We number footnotes within chapters: |
2462 | % |
2463 | % \begin{macrocode} |
2464 | \@addtoreset{footnote}{chapter} |
2465 | % \end{macrocode} |
2466 | % |
2467 | % \begin{macro}{\@makefntext} |
2468 | % |
2469 | % This is the macro which actually typesets a footnote. This is rather |
2470 | % complicated. It's based on example code from \file{classes.dtx} which |
2471 | % doesn't actually work properly. |
2472 | % |
2473 | % \begin{macrocode} |
2474 | \long\def\@makefntext#1{% |
2475 | % \end{macrocode} |
2476 | % |
2477 | % First, we redefine |\par| to set up the correct paragraph shape. This |
2478 | % is indented from the left margin by a small amount. |
2479 | % |
2480 | % \begin{macrocode} |
2481 | \@setpar{% |
2482 | \@@par% |
2483 | \@tempdima\hsize% |
2484 | \advance\@tempdima-1.6em% |
2485 | \parshape\@ne1.6em\@tempdima% |
2486 | }% |
2487 | % \end{macrocode} |
2488 | % |
2489 | % Now we set up some parameters so that \env{list} environments work properly |
2490 | % within the footnote. We also clear |\parindent| to prevent nasty |
2491 | % indentation. The |\par| sets up the paragraph shape for the next |
2492 | % paragraph: we're in vertical mode already, so it does nothing else. |
2493 | % |
2494 | % \begin{macrocode} |
2495 | \advance\linewidth-1.6em% |
2496 | \advance\@totalleftmargin1.6em% |
2497 | \par% |
2498 | \parindent\z@% |
2499 | % \end{macrocode} |
2500 | % |
2501 | % We leave vertical mode to stop the hbox created by |\llap| from being |
2502 | % stacked vertically. Then we typeset the footnote mark, and put in the |
2503 | % main text. Finally we leave some space afterwards, to space out the next |
2504 | % footnote. |
2505 | % |
2506 | % \begin{macrocode} |
2507 | \leavevmode% |
2508 | \llap{\@makefnmark\enspace}#1\par% |
2509 | \vskip\parskip% |
2510 | } |
2511 | % \end{macrocode} |
2512 | % \end{macro} |
2513 | % |
2514 | % \begin{macro}{\@makecol} |
2515 | % |
2516 | % The standard \LaTeX\ output routine messes up footnotes a bit, in my |
2517 | % opinion: |
2518 | % \begin{itemize} |
2519 | % |
2520 | % \item If a page is cut off short, because the next item won't fit (e.g., |
2521 | % a section heading), then footnotes are added right below the end |
2522 | % of the text, which can look strange. |
2523 | % |
2524 | % \item Footnotes are displayed \emph{above} floats at the bottom of a page, |
2525 | % which also looks strange. |
2526 | % |
2527 | % \item The |\@makefntext| routine above needs to add vertical space between |
2528 | % footnotes, but this leaves a gap at the very bottom. We remove this |
2529 | % gap with an |\unskip|. |
2530 | % |
2531 | % \end{itemize} |
2532 | % |
2533 | % \begin{macrocode} |
2534 | \def\@makecol{% |
2535 | \setbox\@outputbox \box\@cclv |
2536 | \xdef\@freelist{\@freelist\@midlist}% |
2537 | \global \let \@midlist \@empty |
2538 | \@combinefloats |
2539 | \ifvoid\footins \else |
2540 | \setbox\@outputbox \vbox {% |
2541 | \boxmaxdepth \@maxdepth |
2542 | \unvbox \@outputbox |
2543 | \vskip \skip\footins |
2544 | \vfil |
2545 | \footnoterule |
2546 | \unvbox \footins |
2547 | \unskip |
2548 | }% |
2549 | \fi |
2550 | \ifvbox\@kludgeins |
2551 | \@makespecialcolbox |
2552 | \else |
2553 | \setbox\@outputbox \vbox to\@colht {% |
2554 | \@texttop |
2555 | \dimen@ \dp\@outputbox |
2556 | \unvbox \@outputbox |
2557 | \vskip -\dimen@ |
2558 | \@textbottom |
2559 | }% |
2560 | \fi |
2561 | \global \maxdepth \@maxdepth |
2562 | } |
2563 | % \end{macrocode} |
2564 | % \end{macro} |
2565 | % |
2566 | % \section{Tidying up} |
2567 | % |
2568 | % This section gathers together various other useful bits of standard |
2569 | % document class setting. |
2570 | % |
2571 | % \subsection{Item names} |
2572 | % |
2573 | % These commands typeset bits of text. They can then be redefined by |
2574 | % \package{babel} and suchlike. |
2575 | % |
2576 | % \begin{macrocode} |
2577 | \newcommand\contentsname{Contents} |
c3f26ad3 |
2578 | \newcommand\listfigurename{List of figures} |
2579 | \newcommand\listtablename{List of tables} |
1ffa9044 |
2580 | \if@article\newcommand\bibname{References} |
2581 | \else\newcommand\bibname{Bibliography}\fi |
2582 | \newcommand\indexname{Index} |
2583 | \newcommand\figurename{Figure} |
2584 | \newcommand\tablename{Table} |
2585 | \newcommand\partname{Part} |
2586 | \newcommand\abstractname{Abstract} |
2587 | \newcommand\chaptername{Chapter} |
2588 | \newcommand\appendixname{Appendix} |
2589 | \newcommand\today{\number\day\space\ifcase\month\or |
2590 | January\or February\or March\or April\or May\or June\or |
2591 | July\or August\or September\or October\or November\or December\fi |
2592 | \space\number\year} |
2593 | % \end{macrocode} |
2594 | % |
2595 | % \subsection{Final fiddling for two columns} |
2596 | % |
2597 | % \begin{macrocode} |
2598 | \columnsep10\p@ |
2599 | \columnseprule\z@ |
2600 | \pagestyle{headings} |
2601 | \pagenumbering{arabic} % Arabic page numbers |
2602 | \if@twocolumn |
2603 | \twocolumn |
2604 | \sloppy |
2605 | \flushbottom |
2606 | \else |
2607 | \onecolumn |
2608 | \fi |
2609 | % \end{macrocode} |
2610 | % |
2611 | % \section{The \protect\env{central} environment} |
2612 | % |
2613 | % Because of the strange layout of the pages, text which is centred using |
2614 | % normal \LaTeX\ commands is centred in the text area, not on the page, |
2615 | % which is undesirable for large headings, like part headings. |
2616 | % |
2617 | % \begin{environment}{central} |
2618 | % |
2619 | % The \env{central} environment typesets its contents centrally on the page. |
2620 | % It should only be used from outer vertical mode. |
2621 | % |
2622 | % The code just creates a box of the appropriate size and moves it into the |
2623 | % right place. |
2624 | % |
2625 | % \begin{macrocode} |
2626 | \newenvironment{central}{% |
2627 | \par% |
2628 | \vbox\bgroup\moveleft\leftindent\vbox\bgroup% |
2629 | \textwidth\paperwidth% |
2630 | \advance\textwidth-2\pagesurround\relax% |
2631 | \hsize\textwidth% |
2632 | \hrule\@height\z@\@depth\z@\@width\hsize% |
2633 | }{% |
2634 | \egroup% |
2635 | \egroup% |
2636 | } |
2637 | % \end{macrocode} |
2638 | % \end{environment} |
2639 | % |
2640 | % \section{Headers and footers} |
2641 | % |
2642 | % The \strayman\ class uses \package{fancyheadings} for its headers |
2643 | % and footers. This has already been included in the preamble. We now |
2644 | % need to fix a few problems with \package{fancyheadings} and set up some |
2645 | % macros. |
2646 | % |
2647 | % \begin{macro}{\title} |
2648 | % |
2649 | % We extend |\title|, and give it an optional argument. It can now specify |
2650 | % the document title as used by |\maketitle| and the running title for the |
2651 | % header separately. |
2652 | % |
2653 | % We store the running header in the macro |\@headertitle|, which is |
2654 | % initially empty. |
2655 | % |
2656 | % \begin{macrocode} |
2657 | \def\@headertitle{} |
2658 | % \end{macrocode} |
2659 | % |
2660 | % Now we define the |\title| macro, using |\@dblarg| to duplicate the |
2661 | % mandatory argument if the optional one is omitted. |
2662 | % |
2663 | % \begin{macrocode} |
2664 | \def\title{\@dblarg\title@i} |
2665 | \def\title@i[#1]#2{% |
2666 | \gdef\@title{#2}% |
2667 | \gdef\@headertitle{#1}% |
2668 | } |
2669 | % \end{macrocode} |
2670 | % \end{macro} |
2671 | % |
2672 | % \begin{macro}{\innerhead} |
2673 | % \begin{macro}{\innerfoot} |
2674 | % |
2675 | % We allow the user to specify an `inner heading' which is displayed on the |
2676 | % inside of the header on of each page. This can be used for security |
2677 | % classifications, for example. Any \package{fancyheadings} commands can |
2678 | % be used to control the header, which is expanded on each page. |
2679 | % |
2680 | % \begin{macrocode} |
2681 | \def\l@innerhead{} |
2682 | \def\r@innerhead{} |
2683 | \def\l@innerfoot{} |
2684 | \def\r@innerfoot{} |
2685 | \def\innerhead{\@dblarg\innerhead@i} |
2686 | \def\innerhead@i[#1]#2{% |
2687 | \def\l@innerhead{#1}% |
2688 | \def\r@innerhead{#2}% |
2689 | } |
2690 | \def\innerfoot{\@dblarg\innerfoot@i} |
2691 | \def\innerfoot@i[#1]#2{% |
2692 | \def\l@innerfoot{#1}% |
2693 | \def\r@innerfoot{#2}% |
2694 | } |
2695 | % \end{macrocode} |
2696 | % \end{macro} |
2697 | % \end{macro} |
2698 | % |
2699 | % The next step is to set up the headings: |
2700 | % |
2701 | % \begin{macrocode} |
2702 | \let\headrulewidth\z@ |
2703 | \headwidth\textwidth |
2704 | \advance\headwidth\leftindent |
2705 | \fancypagestyle{headings}{% |
2706 | \fancyhf{} |
2707 | \fancyhead[LE]{\bfseries\@headertitle} |
2708 | \if@article\fancyhead[RO]{\rightmark}\else\fancyhead[RO]{\leftmark}\fi |
2709 | \fancyhead[RE]{\l@innerhead} \fancyhead[LO]{\r@innerhead} |
2710 | \fancyfoot[RE]{\l@innerfoot} \fancyfoot[LO]{\r@innerfoot} |
2711 | \fancyfoot[LE,RO]{\thepage} |
2712 | } |
2713 | \fancypagestyle{plain}{% |
2714 | \fancyhf{}% |
2715 | \fancyfoot[RE]{\l@innerfoot} \fancyfoot[LO]{\r@innerfoot} |
2716 | \fancyfoot[LE,RO]{\thepage}% |
2717 | } |
2718 | \let\ps@fancy\ps@@fancy |
2719 | % \end{macrocode} |
2720 | % |
2721 | % The \package{fancyheadings} package by default expects pages to be |
2722 | % symmetrical. We have to redefine the |\ps@fancy| macro to make it |
2723 | % work properly. |
2724 | % |
2725 | % \begin{macrocode} |
2726 | \def\@lodd{\ifodd\c@page\hss\else\relax\fi} |
2727 | \def\@rodd{\ifodd\c@page\relax\else\hss\fi} |
2728 | % \end{macrocode} |
2729 | % |
2730 | % Finally, we can choose the page style we want: |
2731 | % |
2732 | % \begin{macrocode} |
2733 | \pagestyle{headings} |
2734 | % \end{macrocode} |
2735 | % |
2736 | % \section{Parbox alteration} |
2737 | % |
2738 | % The standard \LaTeX\ |\parbox| command, and the \env{minipage} environment, |
2739 | % reset |\parskip| to zero, which is inconsistent with the document style. |
2740 | % We amend |\@arrayparboxrestore|, the macro which sets up the paragraph |
2741 | % style for parboxes. |
2742 | % |
2743 | % First, we define a macro explaining how the parbox should set the spacing. |
2744 | % |
2745 | % \begin{macrocode} |
2746 | \def\parboxparskip{2ex} |
2747 | % \end{macrocode} |
2748 | % |
2749 | % Next, we redefine the macro. This is taken directly from the \LaTeXe |
2750 | % source. |
2751 | % |
2752 | % \begin{macrocode} |
2753 | \def\@arrayparboxrestore{% |
2754 | \let\par\@@par |
2755 | \let\-\@dischyph |
2756 | \let\'\@acci\let\`\@accii\let\=\@acciii |
2757 | \parindent\z@ \parskip\z@ |
2758 | \everypar{\parskip\parboxparskip\everypar{}}% |
2759 | \linewidth\hsize |
2760 | \@totalleftmargin\z@ |
2761 | \leftskip\z@skip \rightskip\z@skip \@rightskip\z@skip |
2762 | \parfillskip\@flushglue \lineskip\normallineskip |
2763 | \baselineskip\normalbaselineskip |
2764 | \@noskipsectrue% % The comp.text.tex gurus said it should be |
2765 | \sloppy} |
2766 | % \end{macrocode} |
2767 | % |
2768 | % |
2769 | % \section{Other features} |
2770 | % |
2771 | % At the end is a miscellany of useful features. |
2772 | % |
2773 | % \subsection{Other typesetting conventions} |
2774 | % |
2775 | % Some items need typesetting in particular ways. |
2776 | % |
2777 | % \begin{macrocode} |
2778 | \let\key\textit |
2779 | \let\button\textbf |
2780 | \def\submenu{\ensuremath\Rightarrow} |
2781 | \let\name\relax |
2782 | \def\file#1{\mbox{\itshape #1\/}} |
2783 | % \end{macrocode} |
2784 | % |
2785 | % \subsection{And finally} |
2786 | % |
2787 | % \begin{macrocode} |
2788 | \sloppy |
2789 | \raggedbottom |
2790 | \def\riscos{RISC~OS} |
2791 | \hyphenpenalty1000 |
2792 | %</strayman> |
2793 | % \end{macrocode} |
2794 | % |
2795 | % \Finale |
2796 | % |
2797 | \endinput |