3.2.7 Table of Contents

A package may handle a table of contents by directing section heading macros to save section heading text and the page number where it occurs for use in a later entry for a table of contents. It writes the collected entries at the end of the document, once all are known, upon request. A row of dots (a leader) bridges the text on the left with its location on the right. Other collections might work in this manner, providing lists of figures or tables.

A table of contents is often found at the end of a GNU troff document because the formatter processes the document in a single pass. The gropdf output driver supports a PDF feature that relocates pages at the time the document is rendered; see the gropdf(1) man page. Type ‘man gropdf’ at the command line to view it.