section
The section element represents an organizational division in a topic. Sections are used to organize subsets of information that are directly related to the topic. Multiple section elements within a single topic do not represent a hierarchy, but rather peer divisions of that topic. Sections cannot be nested. A section can have an optional title.
For example, the titles Reference Syntax and Properties might represent section-level discourse within a topic about a command-line process—the content in each section relates uniquely to the subject of that topic.
Note: For maximum flexibility, sections allow plain text as well as phrase and block level elements. Because of the way XML grammars are defined within a DTD, any element that allows plain text cannot restrict the order or frequency of other elements. As a result, the section element allows title to appear anywhere as a child of section. However, the intent of the specification is that title should only be used once in any section, and when used, it should precede any other text or element content.
Content models
See appendix for information about this element in OASIS document type shells.
Inheritance
- topic/section
Example 85. Example
<reference id="reference">
<title>Copy Command</title>
<refbody>
<section>
<title>Purpose</title>
<p>This little command copies
things.</p>
</section>
</refbody>
</reference>
Attributes
The following attributes are available on this element:
Universal attribute group,
outputclass, and
spectitle.
Parent topic