<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
Attributesatt.global (@xml:id, @n, @xml:lang, @rend, @rendition, @xml:base, @xml:space) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change))
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
model.specDescLike
Contained by
analysis: cl phr s
core: abbr add addrLine author biblScope corr date del distinct editor email emph expan foreign gloss head headItem headLabel hi item l label measure mentioned name note num orig p pubPlace publisher q quote ref reg rs said sic soCalled speaker stage street term textLang time title unclear
dictionaries: case colloc def dictScrap entryFree etym form gen gram gramGrp hyph iType lang lbl mood number orth per pos pron re sense stress subc syll tns usg xr
drama: actor camera caption castItem role roleDesc sound tech view
figures: cell
header: change distributor edition extent geoDecl handNote licence scriptNote typeNote
linking: ab seg
msdescription: accMat acquisition additions catchwords collation colophon condition custEvent decoNote explicit filiation finalRubric foliation heraldry incipit layout material musicNotation objectType origDate origPlace origin provenance rubric secFol signatures source stamp summary support surrogates watermark
namesdates: addName affiliation birth bloc country death district education faith floruit forename genName geogName nameLink nationality occupation orgName persName placeName region residence roleName settlement sex socecStatus surname
spoken: u writing
tagdocs: specList
textcrit: lem rdg wit witDetail
textstructure: byline closer dateline docAuthor docDate docEdition docImprint imprimatur opener salute signed titlePart trailer
transcr: damage fw metamark mod restore retrace supplied surplus
verse: rhyme
May containEmpty element
Declaration

<rng:element name="specDesc">
 <rng:ref name="att.global.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: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,
   att.global.linking.attributes,
   att.global.analytic.attributes,
   att.global.facs.attributes,
   att.global.change.attributes,
   attribute key { data.name }?,
   attribute atts { list { data.name* } }?,
   empty
}
Example
<specDesc key="orth"/>
Example
<specDesc key="emph"/>
Example
<specDesc key="foreign" atts="usage xml:lang"/>
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.