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