Next Up Previous Contents
Next: C.1.61 Element softwareversion
Up: C.1 Element listing
Previous: C.1.59 Element row
[ID index][Keyword index]

C.1.60 Element sect

C.1.60.1 Description

This element contains a section.

The content of this element starts with a subhead element, which in turn contains a title element, and the two are followed by the section content. Note, however, that since the subhead and title start and end tags are both omissable, you may omit both, and follow the sect start tag with the section title.

That is, the structure is formally Example:

<sect><subhead><title>Section title</title><subhead>
<p>Section body</p>
</sect>
but this may be abbreviated to just Example:
<sect>Section title
<p>Section body
The same is true for the subsect, subsubsect, and subsubsubsect elements.

Note that the sect element contains the subsect element, but not the subsubsect element - it is therefore impossible to break the sectioning structure.

C.1.60.2 Parents

appendices, docbody

C.1.60.3 Content

(subhead , (routinelist | (p | table | figure | mdefs) * ) , subsect * )

sect
 |_(subhead,
 |__(routinelist |
 |___(p |
 |____table |
 |____figure |
 |____mdefs)*),
 |__subsect*)

C.1.60.4 Attribute sect/indexkey

If this attribute is present, then an index entry is made, pointing to this section, with the specified key.

C.1.60.5 Attribute sect/id

An ID for this section, to allow it to be referred to from elsewhere.

C.1.60.6 Attribute sect/export

If this attribute is present, then the SGML application will allow other documents to link to this section using this ID. In other words, the presence of this attribute is a commitment to maintain this ID as a meaningful link target in future versions of this document. See the mapid element for a mechanism which allows you to rename obsolete IDs.

You should include this attribute on all sections and subsections. This is enforced by the DTD for sect and subsect elements (this can be controlled by the %Feature.EnforceLinkPolicy switch: see the main documentation for details).

Note that the DTD and processing system do not default this attribute to be present, even though it is required and its presence could be inferred. They require you to insert it explicitly, so that you are aware that the ID has been exported, and that it might therefore be referred to by another document, so that you should not change the ID once the document has been published.


Next Up Previous Contents
Next: C.1.61 Element softwareversion
Up: C.1 Element listing
Previous: C.1.59 Element row
[ID index][Keyword index]
The Starlink SGML Set
Starlink System Note 70
Norman Gray, Mark Taylor
21 April 1999. Release DR-0.7-13. Last updated 24 August 2001