caution

caution — A note of caution

Synopsis

caution ::=

Sequence of:
- One of:
  - Sequence of:
    
    Interleave of:
    
    title?
    
    titleabbrev?
    
    info? (db.titleforbidden.info)
  - info (db.titleonly.info)
- One or more of:
  - annotation
  - bridgehead
  - remark
  - revhistory
  - Indexing inlines
    
    indexterm (db.indexterm.endofrange)
    
    indexterm (db.indexterm.singular)
    
    indexterm (db.indexterm.startofrange)
  - Admonition elements
    
    caution
    
    important
    
    note
    
    tip
    
    warning
  - Formal elements
    
    equation
    
    example
    
    figure
    
    table (db.cals.table)
    
    table (db.html.table)
  - Graphic elements
    
    mediaobject
    
    screenshot
  - HTML Form elements
    
    html:form
  - Informal elements
    
    informalequation
    
    informalexample
    
    informalfigure
    
    informaltable (db.cals.informaltable)
    
    informaltable (db.html.informaltable)
  - List elements
    
    bibliolist
    
    calloutlist
    
    glosslist
    
    itemizedlist
    
    orderedlist
    
    procedure
    
    qandaset
    
    segmentedlist
    
    simplelist
    
    variablelist
  - Paragraph elements
    
    anchor
    
    formalpara
    
    para
    
    simpara
  - Publishing elements
    
    address
    
    blockquote
    
    epigraph
    
    sidebar
  - Synopsis elements
    
    classsynopsis
    
    cmdsynopsis
    
    constructorsynopsis
    
    destructorsynopsis
    
    fieldsynopsis
    
    funcsynopsis
    
    methodsynopsis
  - Technical elements
    
    constraintdef
    
    msgset
    
    procedure
    
    productionset
    
    task
  - Verbatim elements
    
    literallayout
    
    programlisting
    
    programlistingco
    
    screen
    
    screenco
    
    synopsis

Attributes

Common attributes and common linking attributes.

Additional Constraints

caution must not occur in the descendants of caution
important must not occur in the descendants of caution
note must not occur in the descendants of caution
tip must not occur in the descendants of caution
warning must not occur in the descendants of caution

Description

A caution is an admonition, usually set off from the main text.

In some types of documentation, the semantics of admonitions are clearly defined (A caution might imply the possibility of harm to equipment whereas a warning might imply harm to a person) However, DocBook makes no such assertions.

Processing expectations

Formatted as a displayed block. Often outputs the generated text “Caution” or some other visible indication of the type of admonition, especially if a title is not present. Sometimes outputs a graphical icon or other symbol as well.

Parents

These elements contain caution: acknowledgements, annotation, answer, appendix, article, bibliodiv, bibliography, bibliolist, blockquote, callout, calloutlist, caption (db.caption), caution, chapter, colophon, constraintdef, dedication, entry, example, figure, footnote, glossary, glossdef, glossdiv, glosslist, html:fieldset, html:form, important, index, indexdiv, informalexample, informalfigure, itemizedlist, legalnotice, listitem, msgexplan, msgtext, note, orderedlist, para, partintro, preface, procedure, qandadiv, qandaset, question, refsect1, refsect2, refsect3, refsection, refsynopsisdiv, revdescription, sect1, sect2, sect3, sect4, sect5, section, setindex, sidebar, simplesect, step, taskprerequisites, taskrelated, tasksummary, td, textobject, th, tip, toc, tocdiv, variablelist, warning.

Children

The following elements occur in caution: address, anchor, annotation, bibliolist, blockquote, bridgehead, calloutlist, caution, classsynopsis, cmdsynopsis, constraintdef, constructorsynopsis, destructorsynopsis, epigraph, equation, example, fieldsynopsis, figure, formalpara, funcsynopsis, glosslist, html:form, important, indexterm (db.indexterm.endofrange), indexterm (db.indexterm.singular), indexterm (db.indexterm.startofrange), info (db.titleforbidden.info), info (db.titleonly.info), informalequation, informalexample, informalfigure, informaltable (db.cals.informaltable), informaltable (db.html.informaltable), itemizedlist, literallayout, mediaobject, methodsynopsis, msgset, note, orderedlist, para, procedure, productionset, programlisting, programlistingco, qandaset, remark, revhistory, screen, screenco, screenshot, segmentedlist, sidebar, simpara, simplelist, synopsis, table (db.cals.table), table (db.html.table), task, tip, title, titleabbrev, variablelist, warning.

Examples

<article xmlns='http://docbook.org/ns/docbook'>
<title>Example caution</title>

<caution><title>No User Servicable Parts Inside</title>
<para>Breaking this seal voids all warranties.
</para>
</caution>

</article>

No User Servicable Parts Inside

Breaking this seal voids all warranties.

ChangeLog

This alpha reference page is $Revision: 7120 $ published Sun, 22 Jul 2007.


caption (db.html.caption)		chapter