Article Authoring Tag Set Tag Library version 3.0

<comment>

Comment in a Citation

A container element that holds unstructured text within a bibliographic reference (<element-citation> or <mixed-citation>). This element is not necessarily a comment in the formal sense of commentary.

Remarks

Because the model for <mixed-citation> is a loose model with data characters allowed everywhere, the <comment> element will rarely be needed in <mixed-citation>s. Any non-specific text can merely be left as untagged text.

In <element-citation>s, the element <comment> is 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>

In <mixed-citation>s, the <comment> element should be used to mark substantive text only; it should not be used to mark punctuation that occurs between elements. In <element-citation>s, in contrast, 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>.

Attribute

content-type Type of Content

Related Elements

Display Note: <comment>s 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 is therefore 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 | bold | italic | monospace | overline | roman | sc | strike | underline | alternatives | inline-graphic | chem-struct | inline-formula | abbrev | named-content | styled-content | sub | sup)*

Description

Any combination of:

This element may be contained in:

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

Example 1

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


...
<ref>
<element-citation publication-type="commun">
<person-group>
<name><surname>Nightingale</surname>
<given-names>Florence</given-names></name>
</person-group>
<comment>115 Park Street, W, [London, GB]</comment>
<source>Letter to: Marquis Townshend</source>
<year>1864</year>
<month>Jul</month>
<day>27</day>
<size units="leaf">4 leaves</size>
<comment>Located at: Modern Manuscripts Collection,
History of Medicine Division, National Library of
Medicine, Bethesda, MD; MS F 179</comment>
<annotation><p>Nightingale responds to Townshend&rsquo;s
request on behalf of a Mrs. Montague for funds to
support old nurses</p></annotation>
</element-citation>
</ref>
...

Example 2

In a mixed-style bibliographic reference:

...
<ref>
<mixed-citation publication-type="commun">
<string-name><surname>Nightingale</surname>
<given-names>Florence</given-names></string-name> (115
Park Street, W, [London, GB]). <source>Letter
to: Marquis Townshend</source>. <year>1864</year>
<month>Jul</month> <day>27</day>. <size units="leaf">4
leaves</size>. Located at: Modern Manuscripts Collection,
History of Medicine Division, National Library of
Medicine, Bethesda, MD; MS F 179. 
<comment>Located at: Modern Manuscripts Collection,
History of Medicine Division, National Library of
Medicine, Bethesda, MD; MS F 179</comment>
<annotation><p>Nightingale
responds to Townshend&rsquo;s request on behalf of a Mrs.
Montague for funds to support old nurses.</p></annotation>
</mixed-citation>
</ref>
...

Module

references3.ent

Article Authoring Tag Set Tag Library version 3.0

Version of November 2008