lineannotation — A comment on a line in a verbatim listing.


lineannotation ::=


Common attributes and common linking attributes.

No additional attributes.


A lineannotation is an author’s or editor’s comment on a line in one of the verbatim environments. These are annotations added by the documentor; they are not part of the original listing.

Processing expectations

Formatted inline. In verbatim environments like programlisting, which are often presented in a fixed-width font, they may get special typographic treatment, such as italics.

If several lineannotations occur in the same listing, they may be aligned horizontally.


Common attributes and common linking attributes.

any attribute

Any attribute in any other explicit namespace


These elements contain lineannotation: classsynopsisinfo, funcsynopsisinfo, literallayout, programlisting, rhs, screen, synopsis, synopsisinfo.


The following elements occur in lineannotation: text, abbrev, acronym, alt, anchor, annotation, biblioref, coref, date, emphasis (db._emphasis), firstterm (db._firstterm), footnote, footnoteref, foreignphrase (db._foreignphrase), glossterm (db._glossterm), indexterm (db.indexterm.endofrange), indexterm (db.indexterm.singular), indexterm (db.indexterm.startofrange), inlinemediaobject, link, olink, phrase (db._phrase), quote (db._quote), remark, replaceable, subscript, superscript, trademark, wordasword, xref.

See Also

Related elements: computeroutput, literallayout, programlisting, screen, screenshot, synopsis, userinput.


 1 |<article xmlns=''>
   |<title>Example lineannotation</title>
 5 |&lt;entry>  <lineannotation>Error: No line break before block element</lineannotation>
   |A paragraph of text.
10 | 
  |<entry>  Error: No line break before block element
  |A paragraph of text.