| blob | 72ca0eee21b5b4793000decc0c9b35a968eed0fd |
1 % \iffalse meta-comment
2 %
3 % Copyright 1993-2016
4 % The LaTeX3 Project and any individual authors listed elsewhere
5 % in this file.
6 %
7 % This file is part of the LaTeX base system.
8 % -------------------------------------------
9 %
10 % It may be distributed and/or modified under the
11 % conditions of the LaTeX Project Public License, either version 1.3c
12 % of this license or (at your option) any later version.
13 % The latest version of this license is in
14 % http://www.latex-project.org/lppl.txt
15 % and version 1.3c or later is part of all distributions of LaTeX
16 % version 2005/12/01 or later.
17 %
18 % This file has the LPPL maintenance status "maintained".
19 %
20 % The list of all files belonging to the LaTeX base distribution is
21 % given in the file `manifest.txt'. See also `legal.txt' for additional
22 % information.
23 %
24 % The list of derived (unpacked) files belonging to the distribution
25 % and covered by LPPL is defined by the unpacking scripts (with
26 % extension .ins) which are part of the distribution.
27 %
28 % \fi
29 %
30 % \iffalse
31 %%% From File: ltsect.dtx
32 %<*driver>
33 % \fi
34 \ProvidesFile{ltsect.dtx}[2016/09/29 v1.0z LaTeX Kernel (Sectioning)]
35 % \iffalse
36 \documentclass{ltxdoc}
37 \GetFileInfo{ltsect.dtx}
38 \title{\filename}
39 \date{\filedate}
40 \author{%
41 Johannes Braams\and
42 David Carlisle\and
43 Alan Jeffrey\and
44 Leslie Lamport\and
45 Frank Mittelbach\and
46 Chris Rowley\and
47 Tobias Oetiker\thanks{Tobi updated
48 the comments to `doc' conventions}\and
49 Rainer Sch\"opf}
51 \begin{document}
52 \MaintainedByLaTeXTeam{latex}
53 \maketitle
54 \DocInput{\filename}
55 \end{document}
56 %</driver>
57 % \fi
58 %
59 %
60 % \changes{v1.0o}{1995/05/07}{Use \cs{hb@xt@}}
61 % \changes{v1.0y}{1996/10/31}{Corrected and tidied documentation;
62 % removed long lines}
63 %
64 %
65 % \section{Sectioning Commands}
66 %
67 % This file defines the declarations such as |\author| which are used
68 % by |\maketitle|. |\maketitle| itself is defined by each class, not
69 % in the \LaTeX{} kernel.
70 %
71 % The second part of the file defines the generic commands used for
72 % defining sectioning commands such as |\chapter|. Again the actual
73 % document level commands are defined in the class files, in terms of
74 % these commands.
75 %
76 % \StopEventually{}
77 %
78 %
79 % \changes{v1.0a}{1994/03/04}{Initial version, split from latex.dtx}
80 % \changes{v1.0b}{1994/03/28}{Split further from ltherest.dtx}
81 % \changes{v1.0d}{1994/05/21}{Use new error commands}
82 % \changes{v1.0f}{1994/10/12}{Doc. typos}
83 % \changes{v1.0g}{1994/10/18}{Added \cs{normalcolor}}
84 % \changes{v1.0i}{1994/11/17}
85 % {\cs{@tempa} to \cs{reserved@a}}
86 % \changes{v1.0m}{1995/05/03}{TO: Promoted documentation to doc.sty
87 % standard}
88 %
89 % \begin{macrocode}
90 %<*2ekernel>
91 \message{title,}
92 % \end{macrocode}
93 %
94 % \subsection{The Title}
95 %
96 % \DescribeMacro{\title}
97 % The user defines the title and author by the declarations
98 % |\title|\marg{name},
99 % \DescribeMacro{\author}
100 % |\author|\marg{name}
101 %
102 % \DescribeMacro{\date}
103 % Similarly the date is declared with
104 % |\date|\marg{date}.
105 %
106 % \DescribeMacro{\thanks}
107 % Inside these, the |\thanks|\marg{footnote text} command may be used
108 % to make acknowledgements, notice of address, etc.\ in a footnote.
109 % \DescribeMacro{\and}
110 % If there are multiple authors, they have to be separated with the
111 % |\and| command.
112 %
113 % \DescribeMacro{\maketitle}
114 % And finally, the |\maketitle| command produces the actual title,
115 % using the information previously saved with the other commands.
116 %
117 % \begin{macro}{\title}
118 % \begin{macro}{\@title}
119 % \changes{LaTeX2e}{1993/12/11}{Added default}
120 % |\title| for use in |\maketitle|. If not given |\maketitle| will
121 % produce an error message.
122 % \begin{macrocode}
123 \def\title#1{\gdef\@title{#1}}
124 \def\@title{\@latex@error{No \noexpand\title given}\@ehc}
125 % \end{macrocode}
126 % \end{macro}
127 % \end{macro}
128 %
129 % \begin{macro}{\author}
130 % \begin{macro}{\@author}
131 % \changes{LaTeX2e}{1993/12/11}{Added default}
132 %
133 % |\author| for use in |\maketitle|. If not given |\maketitle| will
134 % produce a warning message.
135 %
136 % \begin{macrocode}
137 \def\author#1{\gdef\@author{#1}}
138 \def\@author{\@latex@warning@no@line{No \noexpand\author given}}
139 % \end{macrocode}
140 % \end{macro}
141 % \end{macro}
142 %
143 % \begin{macro}{\date}
144 % \begin{macro}{\@date}
145 % |\date| for use in |\maketitle|. If not given |\maketitle| will
146 % produce |\today| as the default.
147 % \begin{macrocode}
148 \def\date#1{\gdef\@date{#1}}
149 \gdef\@date{\today}
150 % \end{macrocode}
151 % \end{macro}
152 % \end{macro}
153 %
154 % \changes{1.0h}{1994/11/04}{(ASAJ) Added \cs{protected@xdef} to
155 % \cs{thanks}.}
156 % \begin{macro}{\thanks}
157 % \begin{macrocode}
158 \def\thanks#1{\footnotemark
159 \protected@xdef\@thanks{\@thanks
160 \protect\footnotetext[\the\c@footnote]{#1}}%
161 }
162 % \end{macrocode}
163 % \end{macro}
164 %
165 % \begin{macro}{\@thanks}
166 % \begin{macrocode}
167 \let\@thanks\@empty
168 % \end{macrocode}
169 % \end{macro}
170 % \begin{macro}{\and}
171 % \begin{macrocode}
172 \def\and{% % \begin{tabular}
173 \end{tabular}%
174 \hskip 1em \@plus.17fil%
175 \begin{tabular}[t]{c}}% % \end{tabular}
176 % \end{macrocode}
177 % \end{macro}
178 %
179 % \begin{macrocode}
180 \message{sectioning,}
181 % \end{macrocode}
182 % \subsection{Sectioning}
183 %
184 %
185 % \begin{macro}{\@secpenalty}
186 % \begin{macrocode}
187 \newcount\@secpenalty
188 \@secpenalty = -300
189 % \end{macrocode}
190 % \end{macro}
191 %
192 % \begin{macro}{\if@noskipsec}
193 % \begin{macro}{\@noskipsectrue}
194 % \changes{1.0w}{1996/09/29}{Added documentation}
195 % Way back in 1991 (08/26) FMi \& RmS set the |\@noskipsec| switch
196 % to true for the preamble and to false in |\document|.
197 % This was done to trap lists and related text in the preamble but it
198 % does not catch everything.
199 % \begin{macrocode}
200 \newif\if@noskipsec \@noskipsectrue
201 % \end{macrocode}
202 % \end{macro}
203 % \end{macro}
204 %
205 % \begin{macro}{\@startsection}
206 %
207 % The |\@startsection{|\meta{name}|}{|\meta{level}|}{|%
208 % \meta{indent}|}{|\meta{beforeskip}|}|\\
209 % |{|\meta{afterskip}|}{|\meta{style}|}*[|\meta{altheading}%
210 % |]{|\meta{heading}|}|
211 % command is the mother of all the user level sectioning commands.
212 % The part after the |*|, including the |*| is optional.
213 %
214 % \begin{description}
215 % \item[name:] e.g., 'subsection'
216 % \item[level:] a number, denoting depth of section -- e.g.,
217 % chapter = 0, section = 1, etc.
218 % \item[indent:] Indentation of heading from left margin
219 % \item[beforeskip:] Absolute value = skip to leave above the heading.
220 % If negative, then paragraph indent of text following
221 % heading is suppressed.
222 % \item[afterskip:] if positive, then skip to leave below heading, else
223 % negative of skip to leave to right of run-in heading.
224 % \item[style:] Commands to set style. Since June 1996 release the
225 % \emph{last} command in this argument may be a command
226 % such as |\MakeUppercase| or |\fbox| that takes an
227 % argument. The section heading will be supplied as the
228 % argument to this command. So setting |#6| to, say,
229 % |\bfseries\MakeUppercase| would produce bold,
230 % uppercase headings.
231 % \end{description}
232 %
233 % If `|*|' is missing, then increment the counter. If it is
234 % present, then there should be no |[|\meta{altheading}|]| argument.
235 % The command uses the counter 'secnumdepth'. It contains a pointer
236 % to the highest section level that is to be numbered.
237 %
238 % \textbf{Warning:}
239 % The |\@startsection| command should be at the same or higher
240 % grouping level as the text that follows it. For example, you should
241 % \emph{not} do something like
242 % \begin{verbatim}
243 % \def\foo{ \begingroup ...
244 % \paragraph{...}
245 % \endgroup}
246 % \end{verbatim}
247 %
248 % Pseudocode for the |\@startsection| command
249 % \begin{oldcomments}
250 % \@startsection {NAME}{LEVEL}{INDENT}{BEFORESKIP}{AFTERSKIP}{STYLE} ==
251 % BEGIN
252 % IF @noskipsec = T THEN \leavevmode FI
253 % % true if previous section had no body.
254 %
255 % \par
256 % \@tempskipa := BEFORESKIP
257 % @afterindent := T
258 % IF \@tempskipa < 0 THEN \@tempskipa := -\@tempskipa
259 % @afterindent := F
260 % FI
261 % IF @nobreak = true
262 % THEN \everypar == null
263 % ELSE \addpenalty{\@secpenalty}
264 % \addvspace{\@tempskipa}
265 % FI
266 % IF * next
267 % THEN \@ssect{INDENT}{BEFORESKIP}{AFTERSKIP}{STYLE}
268 % ELSE \@dblarg{\@sect
269 % {NAME}{LEVEL}{INDENT}
270 % {BEFORESKIP}{AFTERSKIP}{STYLE}}
271 % FI
272 % END
273 % \end{oldcomments}
274 %
275 % \begin{macrocode}
276 \def\@startsection#1#2#3#4#5#6{%
277 \if@noskipsec \leavevmode \fi
278 \par
279 \@tempskipa #4\relax
280 \@afterindenttrue
281 \ifdim \@tempskipa <\z@
282 \@tempskipa -\@tempskipa \@afterindentfalse
283 \fi
284 \if@nobreak
285 \everypar{}%
286 \else
287 \addpenalty\@secpenalty\addvspace\@tempskipa
288 \fi
289 \@ifstar
290 {\@ssect{#3}{#4}{#5}{#6}}%
291 {\@dblarg{\@sect{#1}{#2}{#3}{#4}{#5}{#6}}}}
292 % \end{macrocode}
293 % \end{macro}
294 %
295 % \begin{macro}{\@sect}
296 % Pseudocode for the |\@sect| command
297 % \begin{oldcomments}
298 % \@sect{NAME}{LEVEL}{INDENT}{BEFORESKIP}{AFTERSKIP}{STYLE}[ARG1]{ARG2}
299 % ==
300 % BEGIN
301 % IF LEVEL > \c@secnumdepth
302 % THEN \@svsec :=L null
303 % ELSE \refstepcounter{NAME}
304 % \@svsec :=L BEGIN \@seccntformat{#1}\relax END
305 % FI
306 % IF AFTERSKIP > 0
307 % THEN \begingroup
308 % STYLE
309 % \@hangfrom{\hskip INDENT\@svsec}
310 % {\interlinepenalty 10000 ARG2\par}
311 % \endgroup
312 % \NAMEmark{ARG1}
313 % \addcontentsline{toc}{NAME}
314 % { IF LEVEL > \c@secnumdepth
315 % ELSE \protect\numberline{\theNAME} FI
316 % ARG1 }
317 % ELSE \@svsechd == BEGIN STYLE
318 % \hskip INDENT\@svsec
319 % ARG2
320 % \NAMEmark{ARG1}
321 % \addcontentsline{toc}{NAME}
322 % { IF LEVEL > \c@secnumdepth
323 % ELSE
324 % \protect\numberline{\theNAME}
325 % FI
326 % ARG1 }
327 % END
328 % FI
329 % \@xsect{AFTERSKIP}
330 % END
331 % \end{oldcomments}
332 %
333 % \changes{LaTeX2.09}{1992/08/25}
334 % {(FMi) replaced explicit setting of \cs{@svsec}
335 % by call to \cs{@seccntformat}}
336 % \changes{LaTeX2.09}{1993/08/05}
337 % {(RmS) Made sure that \cs{protect} works correctly in
338 % expansion of \cs{the} counter}
339 % \changes{1.0h}{1994/11/04}
340 % {(ASAJ) Added \cs{protected@edef}.}
341 % \begin{macrocode}
342 \def\@sect#1#2#3#4#5#6[#7]#8{%
343 \ifnum #2>\c@secnumdepth
344 \let\@svsec\@empty
345 \else
346 \refstepcounter{#1}%
347 % \end{macrocode}
348 % Since |\@seccntformat| might end with an improper |\hskip| which
349 % is scanning forward for |plus| or |minus| we end the definition
350 % of |\@svsec| with |\relax| as a precaution.
351 % \changes{1.0n}{1995/05/06}{Added \cs{relax} after
352 % \cs{@seccntformat} just in case}
353 % \begin{macrocode}
354 \protected@edef\@svsec{\@seccntformat{#1}\relax}%
355 \fi
356 \@tempskipa #5\relax
357 \ifdim \@tempskipa>\z@
358 \begingroup
359 % \end{macrocode}
360 % \changes{v1.0s}{1996/05/21}
361 % {(DPC) Moved brace to allow commands like
362 % \cs{MakeUppercase} in 6th argument.
363 % Changed \cs{par} to \cs{endgraf} to allow non-long
364 % commands. internal/2148}
365 % \changes{v1.0t}{1996/06/10}
366 % {(DPC) Changed \cs{endgraf} to \cs{@@par}}
367 % This |{| used to be after the argument to |\@hangfrom| but was moved
368 % here to allow commands such as |\MakeUppercase| to be used at the end
369 % of |#6|.
370 % \begin{macrocode}
371 #6{%
372 \@hangfrom{\hskip #3\relax\@svsec}%
373 \interlinepenalty \@M #8\@@par}%
374 \endgroup
375 \csname #1mark\endcsname{#7}%
376 \addcontentsline{toc}{#1}{%
377 \ifnum #2>\c@secnumdepth \else
378 \protect\numberline{\csname the#1\endcsname}%
379 \fi
380 #7}%
381 \else
382 % \end{macrocode}
383 % |\relax| added 2 May 90
384 % \changes{v1.0s}{1996/05/21}
385 % {(DPC) Added extra braces for internal/2148}
386 % \begin{macrocode}
387 \def\@svsechd{%
388 #6{\hskip #3\relax
389 \@svsec #8}%
390 \csname #1mark\endcsname{#7}%
391 \addcontentsline{toc}{#1}{%
392 \ifnum #2>\c@secnumdepth \else
393 \protect\numberline{\csname the#1\endcsname}%
394 \fi
395 #7}}%
396 \fi
397 \@xsect{#5}}
398 % \end{macrocode}
399 % \end{macro}
400 %
401 % \begin{macro}{\@xsect}%
402 % Pseudocode for the |\@xsect| command
403 % \begin{oldcomments}
404 % \@xsect{AFTERSKIP} ==
405 % BEGIN
406 % IF AFTERSKIP > 0
407 % THEN \par \nobreak
408 % \vskip AFTERSKIP
409 % \@afterheading
410 % ELSE @nobreak :=G F
411 % @noskipsec :=G T
412 % \everypar{ IF @noskipsec = T
413 % THEN @noskipsec :=G F
414 % \clubpenalty :=G 10000
415 % \hskip -\parindent
416 % \begingroup
417 % \@svsechd
418 % \endgroup
419 % \unskip
420 % \hskip -AFTERSKIP \relax
421 % %% relax added 14 Jan 91
422 % ELSE \clubpenalty :=G \@clubpenalty
423 % \everypar := NULL
424 % FI
425 % }
426 % FI
427 %
428 % END
429 % \end{oldcomments}
430 %
431 % \changes{0.0}{1992/08/19}
432 % {(RmS) corrected bug: stretch and shrink in argument to
433 % \cs{hskip} previously not negated}
434 % \begin{macrocode}
435 \def\@xsect#1{%
436 \@tempskipa #1\relax
437 \ifdim \@tempskipa>\z@
438 % \end{macrocode}
439 % Why not combine |\@sect| and |\@xsect| and save doing the
440 % same test twice? It is not possible to change this now as these
441 % have become hooks!
442 %
443 % This |\par| seems unnecessary.
444 % \begin{macrocode}
445 \par \nobreak
446 \vskip \@tempskipa
447 \@afterheading
448 \else
449 % \end{macrocode}
450 % \changes{v1.0u}{1996/07/26}{Removed \cs{global} before
451 % \cs{@nobreak...}}
452 % \changes{v1.0x}{1996/10/23}{Replaced \cs{hskip...} with \cs{setbox...}
453 % as used in \cs{@afterheading}}
454 % \begin{macrocode}
455 \@nobreakfalse
456 \global\@noskipsectrue
457 \everypar{%
458 \if@noskipsec
459 \global\@noskipsecfalse
460 {\setbox\z@\lastbox}%
461 \clubpenalty\@M
462 \begingroup \@svsechd \endgroup
463 \unskip
464 \@tempskipa #1\relax
465 \hskip -\@tempskipa
466 \else
467 \clubpenalty \@clubpenalty
468 \everypar{}%
469 \fi}%
470 \fi
471 \ignorespaces}
472 % \end{macrocode}
473 % \end{macro}
474 %
475 % \begin{macro}{\@seccntformat}
476 % This command formats the section number including the space
477 % following it.
478 % \changes{1.0n}{1995/05/06}{Use \cs{quad} instead of \cs{hskip}}
479 % \begin{macrocode}
480 \def\@seccntformat#1{\csname the#1\endcsname\quad}
481 % \end{macrocode}
482 % \end{macro}
483 %
484 % Pseudocode for the |\@ssect| command
485 % \begin{oldcomments}
486 % \@ssect{INDENT}{BEFORESKIP}{AFTERSKIP}{STYLE}{ARG} ==
487 % BEGIN
488 % IF AFTERSKIP > 0
489 % THEN \begingroup
490 % STYLE
491 % \@hangfrom{\hskip INDENT}{\interlinepenalty 10000 ARG\par}
492 % \endgroup
493 % ELSE \@svsechd == BEGIN STYLE
494 % \hskip INDENT
495 % ARG
496 % END
497 % FI
498 % \@xsect{AFTERSKIP}
499 % END
500 % \end{oldcomments}
501 %
502 % Pseudocode for the |\@afterheading| command
503 % \begin{oldcomments}
504 % \@afterheading ==
505 % BEGIN
506 % @nobreak :=G true
507 % \everypar := BEGIN IF @nobreak = T
508 % THEN @nobreak :=G false
509 % \clubpenalty :=G 10000
510 % IF @afterindent = F
511 % THEN remove \lastbox
512 % FI
513 % ELSE \clubpenalty :=G \@clubpenalty
514 % \everypar := NULL
515 % FI
516 % END
517 % END
518 % \end{oldcomments}
519 %
520 %
521 % \begin{macro}{\@ssect}
522 % \begin{macrocode}
523 \def\@ssect#1#2#3#4#5{%
524 \@tempskipa #3\relax
525 \ifdim \@tempskipa>\z@
526 \begingroup
527 % \end{macrocode}
528 % \changes{v1.0s}{1996/05/21}
529 % {(DPC) Moved brace to allow commands like
530 % \cs{MakeUppercase} in 4th argument.
531 % Changed \cs{par} to \cs{endgraf} to allow non-long
532 % commands. internal/2148}
533 % \changes{v1.0t}{1996/06/10}
534 % {(DPC) Changed \cs{endgraf} to \cs{@@par}}
535 % This |{| used to be after the argument to |\@hangfrom| but was moved
536 % here to allow commands such as |\MakeUppercase| to be used at the end
537 % of |#4|.
538 % \begin{macrocode}
539 #4{%
540 \@hangfrom{\hskip #1}%
541 \interlinepenalty \@M #5\@@par}%
542 \endgroup
543 \else
544 % \end{macrocode}
545 % \changes{v1.0s}{1996/05/21}
546 % {(DPC) Added extra braces for internal/2148}
547 % \begin{macrocode}
548 \def\@svsechd{#4{\hskip #1\relax #5}}%
549 \fi
550 \@xsect{#3}}
551 % \end{macrocode}
552 % \end{macro}
553 %
554 % \begin{macro}{\if@afterindent}
555 % \begin{macro}{\@afterindenttrue}
556 % \begin{macrocode}
557 \newif\if@afterindent \@afterindenttrue
558 % \end{macrocode}
559 % \end{macro}\end{macro}
560 %
561 % \begin{macro}{\@afterheading}
562 % \changes{v1.0v}{1996/08/02}{Removed \cs{global}
563 % before \cs{@nobreak...}}
564 %
565 % This hook is used in setting up custom-built headings in classes.dtx.
566 %
567 % \begin{macrocode}
568 \def\@afterheading{%
569 \@nobreaktrue
570 \everypar{%
571 \if@nobreak
572 \@nobreakfalse
573 \clubpenalty \@M
574 \if@afterindent \else
575 {\setbox\z@\lastbox}%
576 \fi
577 \else
578 \clubpenalty \@clubpenalty
579 \everypar{}%
580 \fi}}
581 % \end{macrocode}
582 % \end{macro}
583 %
584 %
585 % \begin{macro}{\@hangfrom}
586 %
587 % |\@hangfrom{|\meta{text}|}| : Puts \meta{text} in a box, and makes a
588 % hanging indentation of the following material up to the first
589 % |\par|. Should be used in vertical mode.
590 %
591 % \changes{v1.0a}{1994/03/07}{(DPC)Extra groups for colour}
592 % \begin{macrocode}
593 \def\@hangfrom#1{\setbox\@tempboxa\hbox{{#1}}%
594 \hangindent \wd\@tempboxa\noindent\box\@tempboxa}
595 % \end{macrocode}
596 % \end{macro}
597 %
598 % \begin{macro}{\c@secnumdepth}
599 % \begin{macro}{\c@tocdepth}
600 % \begin{macrocode}
601 \newcount\c@secnumdepth
602 \newcount\c@tocdepth
603 % \end{macrocode}
604 % \end{macro}\end{macro}
605 %
606 % \begin{macro}{\secdef}
607 %
608 % |\secdef{|\meta{unstarcmds}|}{|\meta{unstarcmds}|}{|%
609 % \meta{starcmds}|}|\\
610 % When defining a |\chapter| or |\section| command without using
611 % |\@startsection|, you can use |\secdef| as follows:
612 % \begin{enumerate}
613 % \item |\def\chapter{| \ldots |\secdef|
614 % |\|\meta{starcmd} |\|\meta{unstarcmd} |}|
615 % \item |\def\|\meta{starcmd}|[#1]#2{| \ldots |}|
616 % |%| Command to define |\chapter[|\ldots|]{|\ldots|}|
617 % \item |\def\|\meta{unstarcmd}|#1{| \ldots |}|
618 % |%| Command to define |\chapter*{|\ldots|}|
619 % \end{enumerate}
620 %
621 % \begin{macrocode}
622 \def\secdef#1#2{\@ifstar{#2}{\@dblarg{#1}}}
623 % \end{macrocode}
624 % \end{macro}
625 %
626 % \subsubsection{Initializations}
627 % \begin{macro}{\sectionmark}
628 % \begin{macro}{\subsectionmark}
629 % \begin{macro}{\subsubsectionmark}
630 % \begin{macro}{\paragraphmark}
631 % \begin{macro}{\subparagraphmark}
632 % \changes{v1.0q}{1995/10/25}{Use \cs{let} not \cs{def} to save space.}
633 % \begin{macrocode}
634 \let\sectionmark\@gobble
635 \let\subsectionmark\@gobble
636 \let\subsubsectionmark\@gobble
637 \let\paragraphmark\@gobble
638 \let\subparagraphmark\@gobble
639 % \end{macrocode}
640 % \end{macro}
641 % \end{macro}
642 % \end{macro}
643 % \end{macro}
644 % \end{macro}
645 %
646 % \begin{macrocode}
647 \message{contents,}
648 % \end{macrocode}
649 %
650 % \subsection{Table of Contents etc.}
651 %
652 % \subsubsection{Convention}
653 % |\tf@|\meta{foo} = file number for output for table foo.
654 % The file is opened only if |@filesw| = |true|.
655 %
656 % \subsubsection{Commands}
657 %
658 %
659 % A |\l@|\meta{type}|{|\meta{entry}|}{|\meta{page}|}| Macro needs to
660 % defined by document style for making an entry of type \meta{type}
661 % in a table of contents, etc. E.g., the document style
662 % should define |\l@chapter|, |\l@section|, etc.
663 %
664 % \textbf{Note:} When the |\protect| command is
665 % used in the \meta{entry} or \meta{text} of one of the commands
666 % below, it causes the following control sequence to be written on
667 % the file without being expanded. The sequence will be expanded
668 % when the table of contents entry is processed.
669 %
670 % \textbf{Surprise:} Inside an |\addcontentsline| or |\addtocontents|
671 % command argument, the commands: |\index|, |\glossary|, and |\label|
672 % are no-ops . This could cause a problem if the user puts an
673 % |\index| or |\label| into one of the commands he writes, or into the
674 % optional `short version' argument of a |\section| or |\caption|
675 % command.
676 %
677 % \begin{macro}{\@starttoc}
678 % The |\@starttoc|\marg{ext} command is used to define the commands:\\
679 % |\tableofcontents|, |\listoffigures|, etc.
680 %
681 % For example:
682 % |\@starttoc{lof}| is used in |\listoffigures|. This command
683 % reads the |.|\meta{ext} file and sets up to write the new
684 % |.|\meta{ext} file.
685 %
686 % \begin{oldcomments}
687 % \@starttoc{EXT} ==
688 % BEGIN
689 % \begingroup
690 % \makeatletter
691 % read file \jobname.EXT
692 % IF @filesw = true
693 % THEN open \jobname.EXT as file \tf@EXT
694 % FI
695 % @nobreak :=G FALSE %% added 24 May 89
696 % \endgroup
697 % END
698 % \end{oldcomments}
699 %
700 % \changes{0.0}{1992/01/14}{(RmS) added \cs{immediate} to \cs{openout}
701 % as all \cs{write} commands
702 % are also executed \cs{immediate}}
703 % \changes{v1.0u}{1996/07/26}{removed \cs{global}
704 % before \cs{@nobreak...}}
705 % \begin{macrocode}
706 \def\@starttoc#1{%
707 \begingroup
708 \makeatletter
709 \@input{\jobname.#1}%
710 \if@filesw
711 \expandafter\newwrite\csname tf@#1\endcsname
712 \immediate\openout \csname tf@#1\endcsname \jobname.#1\relax
713 \fi
714 \@nobreakfalse
715 \endgroup}
716 % \end{macrocode}
717 % \end{macro}
718 %
719 % \begin{macro}{\addcontentsline}
720 % The |\addcontentsline{|\meta{table}|}{|\meta{type}|}{|%
721 % \meta{entry}|}| command allows the user to add
722 % his/her own entry to a table of contents, etc. The command adds the
723 % entry |\contentsline{|\meta{type}|}{|\meta{entry}|}{|\meta{page}|}|
724 % to the |.|\meta{table} file.
725 %
726 % This macro is implemented as an application of |\addtocontents|.
727 % Note that |\thepage| is not expandable during |\protected@write|
728 % therefore one gets the page number at the time of the |\shipout|.
729 %
730 % \changes{v1.0c}{1994/05/20}{Correct setting of \cs{protect}.}
731 % \changes{v1.0j}{1995/04/23}{Use \cs{contentsline} internally.}
732 % \changes{v1.0h}{1994/11/04}{Added \cs{protected@write} to
733 % \cs{addcontentsline}. ASAJ.}
734 % \begin{macrocode}
735 \def\addcontentsline#1#2#3{%
736 \addtocontents{#1}{\protect\contentsline{#2}{#3}{\thepage}}}
737 % \end{macrocode}
738 % \end{macro}
739 %
740 % \changes{v1.0c}{1994/05/20}{Correct setting of \cs{protect}.}
741 % \changes{v1.0h}{1994/11/04}{Added \cs{protected@write} to
742 % \cs{addtocontents}. ASAJ.}
743 % \begin{macro}{\addtocontents}
744 %
745 % The |\addtocontents{|\meta{table}|}{|\meta{text}|}| command
746 % adds \meta{text} to the |.|\meta{table} file, with no
747 % page number.
748 %
749 % \begin{macrocode}
750 \long\def\addtocontents#1#2{%
751 \protected@write\@auxout
752 {\let\label\@gobble \let\index\@gobble \let\glossary\@gobble}%
753 {\string\@writefile{#1}{#2}}}
754 % \end{macrocode}
755 % \end{macro}
756 %
757 % \begin{macro}{\contentsline}
758 % The |\contentsline{|\meta{type}|}{|\meta{entry}|}{|\meta{page}|}|
759 % macro produces a \meta{type} entry in a table of contents, etc.
760 % It will appear in the |.toc| or other file. For example,
761 % The entry for subsection 1.4.3 in the table of contents for
762 % example, might be produced by:
763 %
764 % \begin{verbatim}
765 % \contentsline{subsection}
766 % {\makebox{30pt}[r]{1.4.3} Gnats and Gnus}{22}
767 % \end{verbatim}
768 %
769 % The |\protect| command causes command sequences to be written
770 % without expanding them.
771 %
772 % \begin{macrocode}
773 \def\contentsline#1{\csname l@#1\endcsname}
774 % \end{macrocode}
775 % \end{macro}
776 %
777 % |\@dottedtocline{|\meta{level}|}{|\meta{indent}|}{|\meta{numwidth}%
778 % |}{|\meta{title}|}{|\meta{page}|}|:
779 % Macro to produce a table of contents line with the following
780 % parameters:
781 % \begin{description}
782 % \item[level] If \meta{level} $>$ |\c@tocdepth|, then no line
783 % produced.
784 % \item[indent] Total indentation from the left margin.
785 % \item[numwidth] Width of box for number if the \meta{title} has a
786 % |\numberline| command.
787 % As of 25 Jan 1988, this is also the amount of extra
788 % indentation added to second and later lines of a
789 % multiple line entry.
790 % \item[title] Contents of entry.
791 % \item[page] Page number.
792 % \end{description}
793 %
794 % Uses the following parameters, which must be set by the document
795 % style. They should be defined with |\def|'s.
796 % \begin{description}
797 % \item[|\@pnumwidth|] Width of box in which page number is set.
798 % \item[|\@tocrmarg|] Right margin indentation for all but last line
799 % of multiple-line entries.
800 % \item[|\@dotsep|] Separation between dots, in mu units.
801 % Should be |\def|'d to a number like 2 or 1.7
802 % \end{description}
803 %
804 % \begin{macro}{\@dottedtocline}
805 % \changes{LaTeX2.09}{1991/09/29}
806 % {(RmS) added \cs{reset@font} for page number}
807 % \changes{v1.0e}{1994/05/25}{Put braces around argument 4
808 % (the actual toc entry) to avoid font (and possibly other)
809 % changes leaking out to the leaders.}
810 % \changes{v1.0g}{1994/10/18}{Added \cs{normalcolor} for page number}
811 % \changes{v1.0z}{1996/12/20}{Added \cs{nobreak} for latex/2343}
812 % \begin{macrocode}
813 \def\@dottedtocline#1#2#3#4#5{%
814 \ifnum #1>\c@tocdepth \else
815 \vskip \z@ \@plus.2\p@
816 {\leftskip #2\relax \rightskip \@tocrmarg \parfillskip -\rightskip
817 \parindent #2\relax\@afterindenttrue
818 \interlinepenalty\@M
819 \leavevmode
820 \@tempdima #3\relax
821 % \end{macrocode}
822 % \changes{v1.0z}{1996/12/20}{Added \cs{nobreak} for latex/2343}
823 % \begin{macrocode}
824 \advance\leftskip \@tempdima \null\nobreak\hskip -\leftskip
825 {#4}\nobreak
826 \leaders\hbox{$\m@th
827 % \end{macrocode}
828 % If a document uses fonts other than computer modern, the use of a
829 % dot from math can be very disturbing despite the fact that this
830 % might be the only place in a document that then uses computer
831 % modern.
832 % Therefore we surround the dot with an |\hbox| to escape to the
833 % surrounding text font.
834 % \changes{v1.0k}{1995/04/25}{Added \cs{hbox} around dots.}
835 % \changes{v1.0l}{1995/05/02}{Don't reset to \cs{rmfamily}}
836 % \begin{macrocode}
837 \mkern \@dotsep mu\hbox{.}\mkern \@dotsep
838 mu$}\hfill
839 \nobreak
840 \hb@xt@\@pnumwidth{\hfil\normalfont \normalcolor #5}%
841 \par}%
842 \fi}
843 % \end{macrocode}
844 % \end{macro}
845 %
846 % \textbf{Note:} |\nobreak|'s added 7 Jan 86 to prevent bad line break
847 % that left the page number dangling by itself at left edge of a new
848 % line.
849 %
850 % Changed 25 Jan 88 to use |\leftskip| instead of |\hangindent| so
851 % leaders of multiple-line contents entries would line up properly.
852 % \begin{macro}{\numberline}
853 % |\numberline{|\meta{number}|}|: For use in a |\contentsline| command.
854 % It puts \meta{number} flushleft in a box of width |\@tempdima|
855 % (Before 25
856 % Jan 88 change, it also added |\@tempdima| to the hanging
857 % indentation.)
858 %
859 % \begin{macrocode}
860 \def\numberline#1{\hb@xt@\@tempdima{#1\hfil}}
861 %</2ekernel>
862 % \end{macrocode}
863 % \end{macro}
864 %
865 % \Finale
866 %