    | DocBook: The Definitive Guide 2.0.17 (Alpha) |
| | DocBook: The Definitive Guide 2.0.17 (Alpha) |
![[4.2]](figures/rev_4.2.png)
refsection$Revision: 1615 $
$Date: 2002-06-10 21:20:20 -0400 (Mon, 10 Jun 2002) $
refsection — A recursive section in a refentry
refsection ::= (refsectioninfo?, (%refsect.title.content;), (((%refcomponent.mix;)+,refsection*)|refsection+))
Name | Type | Default |
| status | CDATA | None |
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, bibliolist, 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 |