4.2 Hierarchical Structure

LaTeX expects documents to be arranged in a conventional, hierarchical way, with chapters, sections, sub-sections, appendixes, and the like. These are marked using macros rather than environments, probably because the end of a section can be safely inferred when a section of equal or higher level starts.

There are six ``levels'' of sectioning in the document classes used for Python documentation, and the deepest two levels¹ are not used. The levels are:

Level	Macro Name	Notes
1	`\chapter`	(1)
2	`\section`
3	`\subsection`
4	`\subsubsection`
5	`\paragraph`	(2)
6	`\subparagraph`

Notes:

(1): Only used for the manual documents, as described in section 5, ``Document Classes.''
(2): Not the same as a paragraph of text; nobody seems to use this.

Footnotes

... levels ¹: The deepest levels have the highest numbers in the table.

See About this document... for information on suggesting changes.

Document provided by Web Master Resources and hosted at Speedy Domain Registration Company