Introduction to Parameter Entities

This section describes each Parameter Entity in the Archiving and Interchange DTD as well as those in the base Suite that are used by this DTD, except those that are part of the MathML or the XHTML Table structure. (Note: The math and table modules come from external sources and not maintained with this DTD or base Suite; see the documentation provided by the authority responsible for the MathML DTD or XHTML table model.)

A Parameter Entity is an XML syntactic construct that allows a name to be given to a collection of elements, attributes, or attribute values so that they can be referred to by name rather than have their members listed every time they are used. For example, the name %person-name.class; stands for all the element components of a person’s name, such as any title or honorific preceding the person’s name, a given (first) name, a surname, and any suffix following the name (such as “Jr.”).

Parameter Entity Pages

Although the Parameter Entities are declared in many different modules, they are described here in alphabetical order of their DTD names (i.e., Parameter Entity type names). The DTD name is the shorter machine-readable name used in DTD fragments and by software; for example, the DTD name %app.class; is used for the Parameter Entity named Just Appendix Class Elements. Parameter Entity names always begin with a percent sign and end with a semi-colon.

Each Parameter Entity is described by a separate HTML page, where the heading for the page displays the Parameter Entity’s DTD name followed by a more descriptive name. The rest of the Parameter Entity description page discusses aspects of the Parameter Entity and its usage. These sections within the page always appear in the following order although any given Parameter Entity description may not contain all the sections:


This section provides a narrative description of the Parameter Entity, describing what it contains, what it does, or why and when it has been used.


For some Parameter Entities, this section provides additional useful information about the Parameter Entity or its usage.

Design Notes are instructions aimed at implementors, so they may better appreciate the rationale underlying a design decision such as the inclusion of an OR bar within a Parameter Entity. For example, inline-mix Parameter Entities always begin with an OR bar to ease customization for those organizations wishing only character data rather than a mixed content model for a particular element.


This section contains a copy of the Parameter Entity’s declaration from the DTD, i.e., the “content” of a Parameter Entity as shown in XML syntax.


This portion names the base DTD Suite module in which the Parameter Entity is defined. In those instances in which the Suite’s declaration for a Parameter Entity has been over-ridden by a DTD-specific over-ride module, the name of the DTD-specific over-ride module will be named instead.

Parameter Entity Naming Conventions

These DTDs and Suite modules have used a series of design and naming conventions consistently. While parsing software cannot enforce these Parameter Entity usage or naming conventions, these conventions can make it much easier for a person to know how the content models work. Version 2.2 of the Journal Archiving DTD (and the entire Version 2.2 Archiving and Interchange DTD Suite) use the following usage and naming conventions.