<specDesc>

<specDesc> (specification description) indicates that a description of the specified element or class should be included at this point within a document.
Moduletagdocs — 22 Documentation Elements
AttributesIn addition to global attributes
key(identifier) supplies the identifier of the documentary element or class for which a description is to be obtained.
Status Optional
Datatype 

<rng:ref name="data.name"/>
data.name
<specDesc key="emph"/>
atts(attributes) supplies attribute names for which descriptions should additionally be obtained.
Status Recommended
Datatype 0–∞ occurrences of 

<rng:ref name="data.name"/>
data.name
separated by whitespace
Values a whitespace-separated list of attribute names
<specDesc key="foreign" atts="usage xml:lang"/>
Note
The attribute names listed may include both attributes inherited from a class and those defined explicitly for the associated element. If the atts attribute is not supplied, then descriptions for all non-inherited attributes are listed, along with references to any classes. If an empty string is supplied as the value for the atts attribute, then no description should be displayed.
Used by
specList model.specDescLike
May containEmpty element
Declaration

<rng:element name="specDesc">
<rng:ref name="att.global.attributes"/>
<rng:optional>
 <rng:attribute name="key">
  <rng:ref name="data.name"/>
 </rng:attribute>
</rng:optional>
<rng:optional>
 <rng:attribute name="atts">
  <rng:list>
   <rng:zeroOrMore>
    <rng:ref name="data.name"/>
   </rng:zeroOrMore>
  </rng:list>
 </rng:attribute>
</rng:optional>
<rng:empty/>
</rng:element>
element specDesc
{
   att.global.attributes,
   attribute key { data.name }?,
   attribute atts { list { data.name* } }?,
   empty
}
Example
<specDesc key="orth"/>
Note
The description is usually displayed as a label and an item, with any list of values defined for the attribute as an embedded glossary list, No selection among the values is possible. The list of attributes may include some which are inherited by virtue of an element's class membership; descriptions for such attributes may also be retrieved using another specDesc, this time pointing at the relevant class.