Introduction to Attributes

This section describes each attribute used in the Journal Publishing DTD, and Archiving and Interchange DTD Suite modules. The attributes have not been separated by module but are displayed together in alphabetical order by their DTD names. The DTD name is the shorter machine-readable name used in the tagging of a document, in the DTD, and by the software, for example, the attribute name corresp instead of the descriptive name Corresponding Author.

There is one HTML page per attribute. The title at the top of each attribute page gives the attribute’s name as it appears in a tagged document or in the DTD, followed by the attribute’s descriptive name. The rest of the attribute page contains multiple sections that describe aspects of the attribute, its usage, and the elements to which it can be attached. These sections always appear in the following order, although any given attribute page may not contain every section:

Definition

Narrative description of the attribute. This is not a formal, dictionary definition, but more of an explanation of what the attribute means, what question it asks, or how it can be used.

Usage

Explanation of the expected uses for the attribute, such as when or why it might be used, or how to determine its value.

Remarks

Additional useful information about the attribute.

Values

This section performs two functions: 1) naming the elements that can take this attribute and 2) describing the values and defaults for the attribute.

Elements. The elements that may take this attribute are named after the phrase “In elements:”. For each element, both the tag name (the shorter element type name) and the longer descriptive name are given.

If an attribute can be used in more than one way or with several slightly different meanings, there may be more than one “In elements:” section, each followed by a value table that describes the attribute’s values when it is used with the specific elements just listed. For example, the attribute may have exactly the same meaning whenever it is used, but sometimes it is required whereas at other times it is optional; therefore, there will be two “In elements:” sections, one naming all the elements for which the attribute is required and one naming all the elements for which the attribute is optional.

Values. After each “In elements:” section is an attribute value table, which lists and/or explains the possible values of the attribute. When the attribute originates in this DTD Suite, the values section also explains the meaning of each value. Elements defined in the MathML DTD, for example, do not have their attribute values explained, because those values are not under control of this DTD Suite and may change.

Each row in the table describes one value. The column titled “Value” names or describes the value, and the column titled “Meaning” specifies the meaning of the attribute value or describes what an XML application might do with the attribute value. The last row of the table indicates the default value of the attribute, if any, or whether the attribute must be supplied when the element is used or is optional and may be supplied. The row begins with the word “Restriction:”.