10.1.3.6 LaTeX’s Table of Contents

LaTeX uses the aux file to accumulate the information for the Table of Contents.

When LaTeX is used, the Table of Contents appears at the front of the document by default (beginning with version 1.61). This is accomplished by setting the default value of the style-file parameter limbo.end to "\\FWEBtoc", where \FWEBtoc is defined in fwebmac.sty. If you initialize limbo.end yourself in fweb.sty, you should include "\\FWEBtoc" at the end of that initialization if you want the Table of Contents to appear in the beginning. Otherwise, it will appear at the end.

In essence, the Table of Contents is produced by the LaTeX commands

\pagenumbering{roman}
\maketitle
\topofcontents
\tableofcontents
\botofcontents
\newpage

By default, the FWEB hooks \topofcontents and \botofcontents are empty, but they may be used in special circumstances to override the usual behavior. One can set the parameters for \maketitle in the limbo section in the usual LaTeX way, except that it is better to use FWEB’s \Title macro instead of \title:

\Title{MYCODE.WEB}
\author{My name}
\date{January 1, 2001}

By default, the argument of the \Title macro is printed both on the title page and as a running headline in the document. The default font for the title is \ttitlefont; that for the running headline is \large\tt. However, \Title has one optional argument that allows one to override the running headline, perhaps by specifying a shorter form. Say

\Title[Short title]{Long title}

to make the running headline be ‘\large\tt Short title’ and the title-page title be ‘\ttitlefont Long title’.

The \FWEB \Title macro calls LaTeX’s \title macro with the long title as its argument. By default, FWEAVE uses (in the ‘\Wbegin’ macro)

\title{}%
\author{}%
\date{\today\\[3pt]\Time}%

Section numbers in the Table of Contents are produced by the LaTeX macro \numberline. LaTeX’s default definition is inadequate when section numbers are very large; they extend to the right and can overwrite the section name. The macro is redefined more appropriately when the package fwebnum (see Numbering) is used.