caution — A note of caution
caution ::=
((((title
? &
titleabbrev
?),
info
? db.titleforbidden.info) |
info
db.titleonly.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)+)
caution
must not occur among the children
or descendants of caution
.
important
must not occur among the
children or descendants of caution
.
note
must not occur among the children or
descendants of caution
.
tip
must not occur among the children or
descendants of caution
.
warning
must not occur among the children
or descendants of caution
.
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.