    | DocBook: The Definitive Guide 2.0.9 (Alpha) |
| | DocBook: The Definitive Guide 2.0.9 (Alpha) |
![[4.2]](figures/rev_4.2.png)
refsection$Revision: 1.3 $
$Date: 2002/06/11 01:20:12 $
refsection — A recursive section in a refentry
refsection ::= (refsectioninfo?, (title,subtitle?,titleabbrev?), (((calloutlist|glosslist|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+))
Name | Type | Default |
| status | CDATA | None |
Common attributes and common linking attributes.
Additional attributes: (Required attributes, if any, are bold)
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.
The following elements occur in refsection: abstract, address, anchor, authorblurb, beginpage, blockquote, bridgehead, calloutlist, caution, classsynopsis, cmdsynopsis, constraintdef, constructorsynopsis, destructorsynopsis, epigraph, equation, example, fieldsynopsis, figure, formalpara, funcsynopsis, glosslist, graphic, graphicco, highlights, important, indexterm, informalequation, informalexample, informalfigure, informaltable, itemizedlist, literallayout, mediaobject, mediaobjectco, methodsynopsis, msgset, note, orderedlist, para, procedure, productionset, programlisting, programlistingco, qandaset, refsection, refsectioninfo, remark, screen, screenco, screenshot, segmentedlist, sidebar, simpara, simplelist, subtitle, synopsis, table, task, tip, title, titleabbrev, variablelist, warning.
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).
| | | |
| refsect3info | | refsectioninfo |