Change Notes for Implementors
In previous versions of this Tag Set, some parameter entities for groups of attributes were
used to make other parameter entities and occasionally two or more elements shared a parameter
entity. In version NISO 0.4 (NLM 3.1), such dependencies have been reduced, and each element has
a parameter entity for its attributes, ending in “
-atts
”. The new
parameter entities implement the same attribute lists, so no XML document will be made invalid.
However, if a Tag Set has been customized, those customizations should be examined in the light
of the new parameter entities. Some customizations may need to change to use the new Parameter
entities and some implementors may wish to change for the3 sake of increased compatibility with
the base Tag Set and increased flexibility.
The following changes have been made to attribute list parameter entities:
-
Citations. Attributes for both <element-citation> and <mixed-citation> were
defined in the shared parameter entity &citation-atts;. When the Tag Set was
originally designed, this was viewed as a useful maintenance mechanism, to make sure that the
attributes for the two citation types never got out of synch. This was useful, but it also
made it impossible to have different attributes for mixed-style and element-style citations.
The element <element-citation> now uses %element-citation-atts; and element <mixed-citation>
now uses %mixed-citation-atts;. Note:
both of these parameter entities include the original %citation-atts;,
for synchronization purposes. Note: The attribute list for the deprecated <nlm-citation> has been similarly changed.
-
Private Characters. The attribute lists for the elements
<private-char>, <glyph-data>, and
<glyph-ref> have been made into parameter entities. No attribute
list changes were made, just parameterization.
-
Subscript and Superscript The attribute lists for
elements <sub> and <sup> have been
made into parameter entities. No attribute list changes were made, just
parameterization.
-
Translations. The element <trans-source> shared the parameter entity %source-atts; with the element <source>. It now has its own parameter
entity %trans-source-atts; with the same content.
-
Definition list. The element <def-list> shared the parameter entity %list-atts;
with the element <list>, by defining its own parameter entity
%def-list-atts; and also using %list-atts;. It now still has its own parameter entity %def-list-atts;, but the content has been changed to include both previous
%def-list-atts; and previous %list-atts;.
-
Date Elements. The elements <month> and <season> used the parameter entity
%day-atts; instead of their own already defined parameter entities.
The element <month> will now use %month-atts; and the element <season> will now use
%season-atts; .
Textual Form Elements Parameter Entity. Corrected an error
that had the parameter entity %textual-form-elements; started with an
element instead of an OR bar, as inline mixes (elements groupings) should be. The parameter
entity now begins with an OR bar and the OR bar has been removed from the model of <textual-form>. Customizations should be updated to match.