Whole document tree
    

Whole document tree

Comment

Comment

Name

Comment -- Remark made within the document file that is intended for use during interim stages of production

Description

A remark made within the document file that is intended for use during interim stages of production. A Comment should not be displayed to the reader of the finished, published work. It may appear almost anywhere, and may contain almost anything below the Section level.

Usage

Note that, unlike an SGML Comment, unless you take steps to suppress it, the Comment element will be output by an SGML parser or application. You may wish to do this to display Comments along with text during the editorial process. Comment has common attributes.

Parents

These elements contain Comment: Abbrev, Ackno, Acronym, Action, Appendix, Application, ArtPageNums, Article, Attribution, AuthorInitials, BiblioDiv, BiblioMisc, Bibliography, BlockQuote, BridgeHead, Callout, Caution, Chapter, Citation, CiteTitle, City, CollabName, Command, Comment, ComputerOutput, ConfDates, ConfNum, ConfSponsor, ConfTitle, ContractNum, ContractSponsor, Contrib, CorpAuthor, CorpName, Country, Database, Date, Edition, Email, Emphasis, Fax, Filename, FirstName, FirstTerm, ForeignPhrase, FuncParams, FuncSynopsisInfo, Function, GlossDef, GlossDiv, GlossSee, GlossSeeAlso, GlossTerm, Glossary, Hardware, Holder, Honorific, ISBN, ISSN, Important, Index, IndexDiv, Interface, InterfaceDefinition, InvPartNumber, IssueNum, JobTitle, KeyCap, LineAnnotation, Lineage, Link, ListItem, Literal, LiteralLayout, LoTentry, ManVolNum, Member, ModeSpec, MsgAud, MsgExplan, MsgText, Note, OLink, Option, Optional, OrgDiv, OrgName, OtherAddr, OtherName, POB, PageNums, Para, Parameter, PartIntro, Phone, Phrase, Postcode, Preface, Primary, PrimaryIE, Procedure, ProductName, ProductNumber, ProgramListing, Property, PubDate, PublisherName, PubsNumber, Quote, RefEntry, RefEntryTitle, RefMiscInfo, RefNameDiv, RefPurpose, RefSect1, RefSect2, RefSect3, RefSynopsisDiv, ReleaseInfo, Replaceable, RevNumber, RevRemark, Screen, ScreenInfo, Secondary, SecondaryIE, Sect1, Sect2, Sect3, Sect4, Sect5, See, SeeAlso, SeeAlsoIE, SeeIE, Seg, SegTitle, SeriesVolNums, SetIndex, ShortAffil, Sidebar, SimPara, SimpleSect, State, Step, Street, Subscript, Subtitle, Superscript, Surname, Synopsis, SystemItem, Term, Tertiary, TertiaryIE, Tip, Title, TitleAbbrev, ToCback, ToCentry, ToCfront, Trademark, ULink, UserInput, VolumeNum, Warning, WordAsWord, Year, entry.

Examples

<PARA>
This fine set of examples has been tested by parsing them
<COMMENT>ta:  say which tool you used.</COMMENT>
against the version of the DTD to which they pertain.
<COMMENT>ed:  don't say that until you do the testing.</COMMENT>  
<COMMENT>ta:  right, and after I've done so I'll change the
style sheet to hide these comments.</COMMENT>
</PARA>