Name
refsection — A recursive section in a refentry
Synopsis
refsection ::=
((((title
&
titleabbrev
? & subtitle
?),
info
? db.titleforbidden.info) |
info
db.titlereq.info),
(((annotation
| bridgehead
|
remark
| revhistory
| Indexing inlines | Admonition elements | Formal elements | Graphic elements | Informal elements | List elements | Paragraph elements | Publishing elements | Synopsis elements | Technical elements | Verbatim elements)+,
refsection
*) |
refsection
+))
Additional constraints
If this element is the root element, it must have a
version
attribute.
Description
Reference pages have their own hierarchical structure. A
refsection
is a recursive division in a refentry
,
analogous 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.
Attributes
Common attributes and common linking attributes.
- label
Specifies an identifying string for presentation purposes
- status
Identifies the editorial or publication status of the element on which it occurs
See Also
refnamediv
, refsect1
, refsect2
, refsect3
, refsynopsisdiv
Get DocBook 5: The Definitive Guide now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.