<specDesc>

<specDesc> (specification description) indicates that a description of the specified element, class, or macro should be included at this point within a document. [23.1.2 Element and Attribute Descriptions]
Module tagdocs — Documentation Elements
Attributes
key⚓︎ (identifier) supplies the identifier of the documentary element or class for which a description is to be obtained.
Status Required
Datatype teidata.name
<specDesc key="emph"/>
Note

The value should match the ident of a documentary element (that is, a member of att.identified).

atts⚓︎ (attributes) supplies attribute names for which descriptions should additionally be obtained.
Status Recommended
Datatype 0–∞ occurrences of teidata.name separated by whitespace
<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.

Member of
Contained by
analysis: cl phr s
cmc: post
figures: cell
linking: ab seg
spoken: u writing
tagdocs: eg specList
textcrit: lem rdg wit witDetail
verse: rhyme
May contain Empty element
Note

The description is usually displayed as a label and an item. 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.

Example
<specDesc key="orth"/>
Example
<specDesc key="emph"/>
Example
<specDesc key="foreign"
 atts="usage xml:lang"/>
Content model
<content>
 <empty/>
</content>
Schema Declaration
<rng:element name="specDesc">
 <rng:ref name="att.global.attributes"/>
 <rng:ref name="att.global.rendition.attributes"/>
 <rng:ref name="att.global.linking.attributes"/>
 <rng:ref name="att.global.analytic.attributes"/>
 <rng:ref name="att.global.facs.attributes"/>
 <rng:ref name="att.global.change.attributes"/>
 <rng:ref name="att.global.responsibility.attributes"/>
 <rng:ref name="att.global.source.attributes"/>
 <rng:attribute name="key">
  <rng:ref name="teidata.name"/>
 </rng:attribute>
 <rng:optional>
  <rng:attribute name="atts">
   <rng:list>
    <rng:zeroOrMore>
     <rng:ref name="teidata.name"/>
    </rng:zeroOrMore>
   </rng:list>
  </rng:attribute>
 </rng:optional>
 <rng:empty/>
</rng:element>
element specDesc
{
   att.global.attributes,
   att.global.rendition.attributes,
   att.global.linking.attributes,
   att.global.analytic.attributes,
   att.global.facs.attributes,
   att.global.change.attributes,
   att.global.responsibility.attributes,
   att.global.source.attributes,
   attribute key { teidata.name },
   attribute atts { list { teidata.name* } }?,
   empty
}