<comment>

Comment in a Citation

Container element for unstructured text within a bibliographic reference.

Remarks

Usage: This element is not necessarily a comment in the formal sense of commentary.

In the <mixed-citation> element, text, numbers, and special characters such as punctuation are allowed everywhere, so the element <comment> will rarely be needed. Inside <mixed-citation>, any non-specific text can merely be left as untagged text.

In the <element-citation> element, the element <comment> can be used to contain additional information within a citation that is not appropriate in any of the other specific, named information elements. Typical comments might include:

  <comment>[Abstract]</comment>
  <comment>translated from Russian</comment>
  

Best Practice: In <mixed-citation>s, the <comment> element should be used only to mark substantive text; it should not be used to mark punctuation that occurs between elements. In contrast, in <element-citation>s, the <comment> element can be used to preserve any text, spacing, remarks, or punctuation that will not fit in any of the named reference elements. Frequently, there is material at the end of an element-styled citation that can fit into a <comment>.

Attributes

content-type Type of Content
id Document Internal Identifier
specific-use Specific Use
xml:base Base
xml:lang Language

Related Elements

Display/Formatting Note: <comment> elements should appear inline with other reference elements. This is a very different rendering from that given the similar element <annotation>, which is typically a longer commentary concerning a citation and therefore is rendered as a block element.

Content Model

<!ELEMENT  comment      (#PCDATA %comment-elements;)*                >

Expanded Content Model

(#PCDATA | email | ext-link | uri | inline-supplementary-material | related-article | related-object | hr | bold | fixed-case | italic | monospace | overline | overline-start | overline-end | roman | sans-serif | sc | strike | underline | underline-start | underline-end | ruby | alternatives | inline-graphic | private-char | chem-struct | inline-formula | tex-math | mml:math | abbrev | index-term | index-term-range-end | milestone-end | milestone-start | named-content | styled-content | fn | target | xref | sub | sup | x)*

Description

Any combination of:

This element may be contained in:

<element-citation>, <mixed-citation>, <product>, <related-article>, <related-object>

Example

In an element-style bibliographic reference (punctuation and spacing removed):

    
...
<ref>
<element-citation publication-type="book" publication-format="print">
<collab collab-type="editor">Rinsho Shokaki Naika
Henshu Iinkai [Clinical Gastroenterology Editorial
Committee] (JP)</collab>
<source xml:lang="ja">Daicho naishikyo sonyu shugi
no kihon</source>
<trans-source xml:lang="en">Basic technical procedure
of colonoscopy</trans-source>
<edition>Dai 1-pan</edition>
<publisher-loc>Tokyo</publisher-loc>
<publisher-name>Nihon Medikara Senta</publisher-name>
<year iso-8601-date="2003">2003</year>
<size units="pages">135 p</size>
<comment>Japanese</comment>
</element-citation>
</ref>
...