DocBook 5: The Definitive Guide

By Norman Walsh & Leonard Muellner

1st Edition October 1999

1-56592-580-7, Order Number: 5807

652 pages, $36.95 , Includes CD-ROM


DocBook: The Definitive Guide
PrevNext

Name

RefSect3 -- A subsection of a RefSect2

Synopsis

Content Model

RefSect3 ::= (RefSect3Info?, (Title,Subtitle?,TitleAbbrev?), (CalloutList|GlossList|ItemizedList|OrderedList|SegmentedList| SimpleList|VariableList|Caution|Important|Note|Tip|Warning| LiteralLayout|ProgramListing|ProgramListingCO|Screen|ScreenCO| ScreenShot|Synopsis|CmdSynopsis|FuncSynopsis|FormalPara|Para| SimPara|Address|BlockQuote|Graphic|GraphicCO|MediaObject| MediaObjectCO|InformalEquation|InformalExample|InformalFigure| InformalTable|Equation|Example|Figure|Table|MsgSet|Procedure| Sidebar|QandASet|Anchor|BridgeHead|Comment|Highlights|Abstract| AuthorBlurb|Epigraph|IndexTerm)+)

Attributes

Common attributes

Name

Type

Default

StatusCDATANone

Tag Minimization

The start-tag is required for this element. The end-tag is optional, if your SGML declaration allows minimization.

Description

A RefSect3 is a third level section in a RefEntry, analogous to a Sect3 elsewhere in the document. See RefSect1.

In DocBook, RefSect3 is the lowest-level section allowed in a RefEntry. There is no element analogous to a Sect4.

Processing expectations

Formatted as a displayed block.

Parents

These elements contain RefSect3: RefSect2.

Children

The following elements occur in RefSect3: Abstract, Address, Anchor, AuthorBlurb, BlockQuote, BridgeHead, CalloutList, Caution, CmdSynopsis, Comment, Epigraph, Equation, Example, Figure, FormalPara, FuncSynopsis, GlossList, Graphic, GraphicCO, Highlights, Important, IndexTerm, InformalEquation, InformalExample, InformalFigure, InformalTable, ItemizedList, LiteralLayout, MediaObject, MediaObjectCO, MsgSet, Note, OrderedList, Para, Procedure, ProgramListing, ProgramListingCO, QandASet, RefSect3Info, Screen, ScreenCO, ScreenShot, SegmentedList, Sidebar, SimPara, SimpleList, Subtitle, Synopsis, Table, Tip, Title, TitleAbbrev, VariableList, Warning.

In some contexts, the following elements are allowed anywhere: BeginPage, IndexTerm.

Attributes

Status

Status identifies the editorial or publication status of the RefSect3.

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).

Examples

See RefSect1 and RefSect2 in RefEntry for analogous examples.


PrevHomeNext
RefSect2InfoUpRefSect3Info

Back to: DocBook: The Definitive Guide


O'Reilly Home | O'Reilly Bookstores | How to Order | O'Reilly Contacts International | About O'Reilly | Affiliated Companies

© 1999, O'Reilly & Associates, Inc.

Категории