<comment>

Comment in a Citation

Definition

Used to mark unstructured text within an otherwise element-structured bibliographic reference; it is therefore not necessarily a comment in the formal sense of commentary. In an unstructured bibliographic reference, this text would merely be a mixture of text, numbers, or special characters, and not marked with tags at all.

Remarks

This element was designed primarily for use within the structured citation element <nlm-citation> (see Journal Publishing DTD), which is not present in the NCBI Book DTD and NCBI Collection DTDs. Because the model for <citation> is a loose model with data characters allowed everywhere, this element will rarely be needed; its use is therefore deprecated. The <comment> element may be used in <citation>s largely for the sake of conversion, to preserve unusual bits of semantic markup when translating from other DTDs. Typical comments might include:

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

The element <comment> is used to contain additional information about a citation that is not appropriate in any of the other, named, information types.

Conversion Note: The <comment> element should be used to mark substantive text only; it should not be used to mark punctuation that occurs between elements.

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.

Model Information

Content Model

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

Description

Any combination of:

This element may be contained in:

<citation> Citation; <related-article> Related Article Information

Tagged Example

No sample is available at this time.

Module

references.ent