<comment>

Comment in a Citation

Definition

A container element that holds unstructured text within an otherwise element-structured bibliographic reference (<citation>), therefore, this is not necessarily a comment in the formal sense of commentary. In an unstructured bibliographic reference, this textual material would merely be a mixture of text, numbers, or special characters, such as punctuation, and not marked with tags at all.

Remarks

Since in the Journal Archiving and Interchange DTD, the model for <citation> is a loose model with text, numbers, and special characters, such as punctuation, allowed everywhere, this element will rarely be needed. The <comment> element has been defined here 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>

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> 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.

Model Information

Content Model

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

Description

Any combination of:

This element may be contained in:

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

Tagged Example

No sample is available at this time.

Module

references.ent