[4.2]refsection

$Revision: 1615 $

$Date: 2002-06-10 21:20:20 -0400 (Mon, 10 Jun 2002) $

refsection — A recursive section in a refentry

Synopsis

Content Model

refsection ::=
(refsectioninfo?,
 (title,subtitle?,titleabbrev?),
 (((calloutlist|glosslist|bibliolist|itemizedlist|orderedlist|
    segmentedlist|simplelist|variablelist|caution|important|note|
    tip|warning|literallayout|programlisting|programlistingco|
    screen|screenco|screenshot|synopsis|cmdsynopsis|funcsynopsis|
    classsynopsis|fieldsynopsis|constructorsynopsis|
    destructorsynopsis|methodsynopsis|formalpara|para|simpara|
    address|blockquote|graphic|graphicco|mediaobject|
    mediaobjectco|informalequation|informalexample|informalfigure|
    informaltable|equation|example|figure|table|msgset|procedure|
    sidebar|qandaset|task|productionset|constraintdef|anchor|
    bridgehead|remark|highlights|abstract|authorblurb|epigraph|
    indexterm|beginpage)+,
   refsection*)|
  refsection+))

Attributes

Common attributes

Name

Type

Default

statusCDATANone

Description

Reference pages have their own hierarchical structure. A RefSection is a recursive division in a RefEntry, analagous to a Section elsewhere in the document.

The value of a separate hierarchical structure is that it allows the content model of sections in reference pages to be customized differently than the content model of sections outside.

Processing expectations

Formatted as a displayed block.

Parents

These elements contain refsection: refentry, refsection.

Attributes

status

Status identifies the editorial or publication status of the RefSection.

Publication status might be used to control formatting (for example, printing a “draft” watermark on drafts) or processing (perhaps a document with a status of “final” should not include any components that are not final).

See Also

refnamediv, refsect1, refsect2, refsect3, refsynopsisdiv.