Subsections


5 Generated output files.

1 HTML output

The HTML output consists of the following files, per unit:

  1. A general unit description with the contents of the module's descr tag. The uses clause is documented here as well. All units in the uses clause together with their short description tags are typeset in a table.
  2. A listing of all constants in the unit.
  3. A listing of all types in the unit (except classes).
  4. A listing of all variables in the unit.
  5. A listing of all functions/procedures in the unit.
  6. A listing of all classes in the unit.
All these overviews are hyperlinked to pages which contain the documentation of each identifier. Each page starts with the name of the identifier, plus a synopsis (made from the short tag's contents). After that follows the declaration, and the description. The description is filled with the descr node of the identifiers element tag.

If an errors tag was present, an 'Errors' section follows the description. Similarly, if there is a seealso tag, a 'See also' section with cross-reference links is made.

For classes, the declaration contains hyperlinks to separate pages which document all the members of the class. Each member in the declaration is followed by the short tag of the member's element tag, if one exists. As an extra, the class hierarchy is given, plus links to pop-up pages (if JavaScript is available, otherwise they are normal links) which contain alphabetical or hierarchical listings of the methods, fields or properties of the class.

For functions and procedures, the declaration will be typeset in such a way that all function arguments (if they are present) are in tabular format, followed by the short description of the argument. If it concerns a function, and a result element exists, the result description will be provided in a separate section, before the actual description.

The declaration of an enumerated type will be laid out in a table, with the enumeration value at the left, and the short description node of the value's element.

2 Latex output

The latex output is in one big file with the name of the package as specified on the command line. in this file, one chapter is made per unit.

Per unit the following sections are made:

  1. A section with all constants.
  2. A section with all types.
  3. A section with all variables.
  4. A section with all functions and procedures.
  5. A section per declared class.

For the constants, types and variables, the declaration is given, followed by the descr node of the element corresponding to the identifier. All other nodes are ignored.

For functions and procedures, a subsection is made per procedure or function. This subsection consists of a list with the following entries:

Synopsis
filled with the contents of the short tag.
Declaration
Filled with the declaration of the function.
Arguments
A tabular description of all arguments, if short tags are found for them.
Description
Description of the function. Filled with the contents of the descr tag.
Errors
Description of any error conditions. Filled with the contents of the errors tag.
See Also
Cross-references to other functions. Filled with the contents of the seealso tag.

For classes, a subsection is made with an overview of implemented methods. Then a subsection is presented with available properties.

Then follows a subsection per method. These are formatted as a function, with an additional Visibility list element, giving the visibility of the function.

After the methods, a list of properties is given , formatted as a method, with an additional Access list element, specifying whether the property is read/write or not.




2004-02-13