RELAX NG: Coding requirements for attribute domain modules

All vocabulary and constraint modules must document their @domains attribute contribution. The value of the contribution is constructed according to the rules found in @domains attribute rules and syntax. The OASIS grammar files use a <domainsContribution> element to document the contribution; this element is used to help enable generation of DTD and XSD grammar files. An XML comment or <a:documentation> element can also be used.

An attribute domain's name is the name of the attribute plus "Att". For example, for the attribute named "deliveryTarget" the attribute domain name is "deliveryTargetAtt". The attribute domain name is used to construct pattern names for the domain.

An attribute domain consists of one file, which has three sections:

Domains attribute contribution

The @domains contribution must be documented in the module. The value is constructed according to the rules found in @domains attribute rules and syntax.

Attribute extension pattern

The attribute extension pattern extends either the @props or @base attribute set pattern to include the attribute specialization.

For specializations of @props the pattern is named props-attribute-extensions. The pattern specifies a @combine value of "interleave", and the content of the pattern is a reference to the specialized attribute declaration pattern. For example:

<define name="props-attribute-extensions" combine="interleave">
    <ref name="deliveryTargetAtt-d-attribute"/>
</define>

For specializations of @base the pattern is named base-attribute-extensions. The pattern specifies a @combine value of "interleave", and the content of the pattern is a reference to the specialized attribute declaration pattern. For example:

<define name="base-attribute-extensions" combine="interleave">
    <ref name="myBaseSpecializationAtt-d-attribute"/>
</define>

Attribute declaration pattern

The specialized attribute is declared in a pattern named domainName-d-attribute. The attribute must be defined as optional. For example, the @deliveryTarget specialization of @props is defined as follows:

<define name="deliveryTargetAtt-d-attribute">
  <optional>
    <attribute name="deliveryTarget"/>
  </optional>    
</define>