A document's Contents Page is MANUAL's reference for the sectional
layout of the document and for any parameters which are to be
applied when the document is being processed.

Two types of line may appear in Contents Pages: Section lines and
Parameter lines.

A Section Line has the general form

          Number Title | FileName

Every Section Line must have a Number and a Title.

If a section has subsections then its Section Line must not contain
a FileName.

If a section has no subsections then its Section Line must contain
a FileName.

If a section has no FileName then the | character should be omitted
also.

The first section of any document must have a Number of 0 (zero) and
serves to give a short title to the document for on-screen display
purposes. The Section 0 line is never printed. It must have a Title.
If it has a FileName, the FileName is ignored.

The Title may be up to sixty characters in length. FileName is a
standard DOS file name and specifies the name of the file in which
the text of the section is to be placed.

Contents Pages are best explained by example:

0 A Guide to Algebra

  1 Introduction                   | intro

  2 Equations

    2.1 Linear Equations           | linear
    2.2 Quadratic Equations        | quad

  3 Numbers

    3.1 Real Numbers               | real
    3.2 Integers                   | integer
    3.3 Complex Numbers

        3.3.1 Real Parts           | realpart
        3.3.2 Imaginary Parts      | imagine

  4 Bibliography                   | booklist

The FileName field may specify any name acceptable to DOS as a simple
file name. Alphabetic characters may be upper or lower case and the
name may have a three-character extension if required.

A Contents Page is completely free format. It may contain any number
of blank lines, indentation is optional, and any number of space
characters may appear between fields.

Sections may be omitted but section numbers must be in ascending
order. In other words, subsection 3.2 in the above example could
have been omitted but sections 3.1 and 3.2 could not have been
transposed.

If MANUAL finds an error in a Contents Page, it reports the number
of the line at fault and henceforth ignores that line.

Parameter Lines may appear anywhere within Contents Pages but are
placed conventionally at the end.

Parameter Lines may contain no space characters but alphabetic
characters within them may be of either upper or lower case.

Parameter lines are never printed.

Please refer to the separate section headed 'Summary of Contents
Page Parameters'.
