bridgehead

$Revision: 1.3 $

$Date: 2002/06/12 11:18:03 $

bridgehead — A free-floating heading

Synopsis

Mixed Content Model

bridgehead ::=
(#PCDATA|footnoteref|xref|abbrev|acronym|citation|citerefentry|
 citetitle|emphasis|firstterm|foreignphrase|glossterm|footnote|
 phrase|quote|trademark|wordasword|personname|link|olink|ulink|
 action|application|classname|methodname|interfacename|
 exceptionname|ooclass|oointerface|ooexception|command|
 computeroutput|database|email|envar|errorcode|errorname|
 errortype|errortext|filename|function|guibutton|guiicon|guilabel|
 guimenu|guimenuitem|guisubmenu|hardware|interface|keycap|keycode|
 keycombo|keysym|literal|constant|markup|medialabel|menuchoice|
 mousebutton|option|optional|parameter|prompt|property|
 replaceable|returnvalue|sgmltag|structfield|structname|symbol|
 systemitem|token|type|userinput|varname|nonterminal|anchor|
 author|authorinitials|corpauthor|modespec|othercredit|
 productname|productnumber|revhistory|remark|subscript|
 superscript|inlinegraphic|inlinemediaobject|inlineequation|
 indexterm)*

Attributes

Common attributes

Name

Type

Default

renderas
Enumeration:
other
sect1
sect2
sect3
sect4
sect5
None

Description

Some documents, usually legacy documents, use headings that are not tied to the normal sectional hieararchy. These headings may be represented in DocBook with the BridgeHead element.

BridgeHeads may also be useful in fiction or journalistic works that don't have a nested hierarchy.

Processing expectations

A BridgeHead is formatted as a block, using the same display properties as the section heading which it masquerades as. The RenderAs attribute controls which heading it mimics.

Future Changes

The InterfaceDefinition element will be discarded in DocBook V4.0. It will no longer be available in the content model of this element.

Attributes

renderas

The RenderAs attribute identifies how the BridgeHead should be rendered. In this way, a BridgeHead can be made to appear as a Sect1, for example.

See Also

sect1, sect2, sect3, sect4, sect5, section, simplesect.

Examples

For examples, see chapter.