<specDesc>

<specDesc> (specification description) indique qu'une description de l'élément particulier ou de la classe particulière doit être incluse à ce point dans un document. [22.1.2 Element and Attribute Descriptions]
Moduletagdocs — Documentation Elements
Attributsatt.global (@xml:id, @n, @xml:lang, @rend, @style, @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 (identifiant) donne l'identifiant de l'élément ou de la classe documentaire pour lequels la description est à faire.
Statut Optionel
Type de données

<rng:ref name="data.name"/>
data.name
<specDesc key="emph"/>
<specDesc key="emph"/>
atts (attributs) donne les noms des attributs dont il faut une description supplémentaire.
Statut Recommendé
Type de données 0–∞ occurrences de 

<rng:ref name="data.name"/>
data.name
séparé par un espace
Valeurs a whitespace-separated list of attribute names
<specDesc key="foreignatts="usage xml:lang"/>
<specDesc key="foreignatts="usage xml:lang"/>
Note

Les noms d'attribut listés peuvent inclure à la fois des attributs hérités d'une classe et ceux qui sont définis explicitement pour l'élément associé. Si l'attribut atts n'est pas fourni, il faut lister et décrire tous les attributs non hérités, avec référence aux classes éventuelles. Si une chaîne vide est indiquée comme valeur pour l'attribut atts, on ne devrait pas afficher de description.

Membre du
Contenu dans
Peut contenirElément vide
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
}
Exemple
<specDesc key="orth"/>
Exemple
<specDesc key="orth"/>
Exemple
<specDesc key="emph"/>
Exemple
<specDesc key="foreignatts="usage xml:lang"/>
Note

La description est habituellement affichée sous la forme d'une étiquette et d'un contenu, avec toutes les listes de valeurs définies pour l'attribut, comme une liste de glossaire imbriquée. Aucune sélection parmi ces valeurs n'est possible. La liste d'attributs peut inclure des attributs hérités en vertu de leur appartenance à une classe d'éléments ; les descriptions de ces attributs peuvent également être récupérées en utilisant un autre élément specDesc qui pointe cette fois vers la classe pertinente.