remark

Processing expectations

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.

Remarks must not be nested within other Remarks. Because DocBook is harmonizing towards XML, this restriction cannot be enforced by the DTD. The processing of nested comments is undefined.

Parents

These elements contain remark: abbrev, ackno, acronym, action, answer, appendix, application, article, artpagenums, attribution, authorinitials, bibliocoverage, bibliodiv, bibliography, biblioid, bibliomisc, bibliorelation, bibliosource, blockquote, bridgehead, callout, caution, chapter, citation, citebiblioid, citetitle, city, classsynopsisinfo, code, collabname, command, computeroutput, confdates, confnum, confsponsor, conftitle, constraintdef, contractnum, contractsponsor, contrib, corpauthor, corpcredit, corpname, country, database, date, edition, email, emphasis, entry, fax, filename, firstname, firstterm, foreignphrase, funcparams, funcsynopsisinfo, function, glossary, glossdef, glossdiv, glosssee, glossseealso, glossterm, hardware, holder, honorific, important, index, indexdiv, interfacename, invpartnumber, isbn, issn, issuenum, itemizedlist, jobtitle, keycap, label, lineage, lineannotation, link, listitem, literal, literallayout, lotentry, manvolnum, member, modespec, msgaud, msgexplan, msgtext, note, olink, option, optional, orderedlist, orgdiv, orgname, otheraddr, othername, pagenums, para, parameter, partintro, phone, phrase, pob, postcode, preface, primary, primaryie, procedure, productname, productnumber, programlisting, property, pubdate, publishername, pubsnumber, qandadiv, qandaset, question, quote, refentry, refentrytitle, refmiscinfo, refnamediv, refpurpose, refsect1, refsect2, refsect3, refsection, refsynopsisdiv, releaseinfo, remark, replaceable, revdescription, revnumber, revremark, screen, screeninfo, 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, synopsis, systemitem, taskprerequisites, taskrelated, tasksummary, td, term, tertiary, tertiaryie, th, tip, title, titleabbrev, tocback, tocentry, tocfront, trademark, ulink, userinput, variablelist, volumenum, warning, wordasword, year.

Children

The following elements occur in remark: abbrev, acronym, action, anchor, application, author, authorinitials, beginpage, citation, citerefentry, citetitle, classname, classsynopsis, cmdsynopsis, code, command, computeroutput, constant, constructorsynopsis, corpauthor, corpcredit, database, destructorsynopsis, email, emphasis, envar, errorcode, errorname, errortext, errortype, exceptionname, fieldsynopsis, filename, firstterm, footnote, footnoteref, foreignphrase, funcsynopsis, function, glossterm, guibutton, guiicon, guilabel, guimenu, guimenuitem, guisubmenu, hardware, indexterm, inlineequation, inlinegraphic, inlinemediaobject, interface, interfacename, keycap, keycode, keycombo, keysym, link, literal, markup, medialabel, menuchoice, methodname, methodsynopsis, modespec, mousebutton, nonterminal, olink, ooclass, ooexception, oointerface, option, optional, orgname, othercredit, parameter, personname, phrase, productname, productnumber, prompt, property, quote, remark, replaceable, returnvalue, revhistory, sgmltag, structfield, structname, subscript, superscript, symbol, synopsis, systemitem, token, trademark, type, ulink, uri, userinput, varname, wordasword, xref.

<!DOCTYPE example PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
          "http://www.oasis-open.org/docbook/xml/4.1.2/docbookx.dtd">
<example><title>The Grand Unified Theory</title>
<para>
<remark>Some details are still a bit shaky</remark>
&hellip;
Q.E.D.
</para>
</example>