remark — A remark (or comment) intended for presentation in a draft manuscript
phrase
(db._phrase)replaceable
alt
anchor
annotation
biblioref
indexterm
(db.indexterm.endofrange)indexterm
(db.indexterm.singular)indexterm
(db.indexterm.startofrange)inlinemediaobject
link
olink
remark
subscript
superscript
xref
The remark
element is designed to hold remarks, for example, editorial comments, that are useful while the document is in the draft stage, but are not intended for final publication.
Remarks are available almost anywhere and have a particularly broad content model. Your processing system may or may not support either the use of comments everywhere they are allowed or the full generality of the remark
content model.
Prior to version 4.0 of DocBook, this element was named comment.
May be formatted inline or as a displayed block, depending on context. Remarks are often printed only in draft versions of a document and suppressed otherwise. This may be controlled by the status
attribute of an ancestor element (for example, chapter
), or by external processes, such as selecting an alternate stylesheet when publishing.
These elements contain remark
: abbrev
, accel
, acknowledgements
, acronym
, address
, annotation
, answer
, appendix
, application
, arg
, article
, artpagenums
, attribution
, authorinitials
, bibliocoverage
, bibliodiv
, bibliography
, biblioid
, bibliolist
, bibliomisc
, bibliomset
, bibliorelation
, bibliosource
, blockquote
, bridgehead
, callout
, calloutlist
, caption
(db.caption), caption
(db.html.caption), caution
, chapter
, citation
, citebiblioid
, citetitle
, city
, classname
, classsynopsisinfo
, code
, colophon
, command
, computeroutput
, confdates
, confnum
, confsponsor
, conftitle
, constant
, constraintdef
, contractnum
,
contractsponsor
, contrib
, country
, cover
, database
, dedication
, edition
, email
, emphasis
(db._emphasis), emphasis
(db.emphasis), entry
, envar
, errorcode
, errorname
, errortext
, errortype
, example
, exceptionname
, fax
, figure
, filename
, firstname
, firstterm
, footnote
, funcdef
, funcparams
, funcsynopsisinfo
, function
, glossary
, glossdef
, glossdiv
, glosslist
, glosssee
, glossseealso
, glossterm
, guibutton
, guiicon
, guilabel
, guimenu
, guimenuitem
, guisubmenu
, hardware
, holder
, honorific
, html:button
, html:fieldset
, html:form
, html:label
, html:legend
, important
, index
,
indexdiv
, informalexample
, informalfigure
, initializer
, interfacename
, issuenum
, itemizedlist
, jobtitle
, keycap
, keycode
, keysym
, label
, legalnotice
, lineage
, lineannotation
, link
, listitem
, literal
, literallayout
, manvolnum
, markup
, mathphrase
, member
, methodname
, modifier
, mousebutton
, msgaud
, msgexplan
, msglevel
, msgorig
, msgtext
, note
, olink
, option
, optional
, orderedlist
, orgdiv
, orgname
, otheraddr
, othername
, package
, pagenums
, para
, paramdef
, parameter
, partintro
, personname
, phone
, phrase
(db._phrase), phrase
(db.phrase), pob
, postcode
, preface
, primary
, primaryie
, procedure
, productname
, productnumber
, programlisting
, prompt
, property
, publishername
, qandadiv
, qandaset
,
question
, quote
, refdescriptor
, refentrytitle
, refmiscinfo
, refname
, refpurpose
, refsect1
, refsect2
, refsect3
, refsection
, refsynopsisdiv
, releaseinfo
, remark
, replaceable
, returnvalue
, revdescription
, revnumber
, revremark
, screen
, secondary
, secondaryie
, sect1
, sect2
, sect3
, sect4
, sect5
, section
, see
, seealso
, seealsoie
, seeie
, seg
, segtitle
, seriesvolnums
, setindex
, shortaffil
, sidebar
, simpara
, simplesect
, state
, step
, street
, subscript
, subtitle
, superscript
,
surname
, symbol
, synopsis
, systemitem
, tag
, taskprerequisites
, taskrelated
, tasksummary
, td
, term
, termdef
, tertiary
, tertiaryie
, textobject
, th
, tip
, title
, titleabbrev
, toc
, tocdiv
, tocentry
, token
, trademark
, type
, uri
, userinput
, variablelist
,
varname
, volumenum
, warning
, wordasword
, year
.
The following elements occur in remark: text, alt
, anchor
, annotation
, biblioref
, indexterm
(db.indexterm.endofrange), indexterm
(db.indexterm.singular), indexterm
(db.indexterm.startofrange), inlinemediaobject
, link
, olink
, phrase
(db._phrase), remark
, replaceable
, subscript
, superscript
, xref
.