<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.
Module tagdocs — 22 Documentation Elements
En complément des attributs globaux
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"/>
atts (attributs) donne les noms des attributs dont il faut une description supplémentaire.
Statut Recommendé
Type de données 0–∞ occurrences of  

<rng:ref name="data.name"/>
data.name
séparé par un espace
Valeurs a whitespace-separated list of attribute names
<specDesc key="foreign" atts="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.
Utilisé par
specList model.specDescLike
Peut contenir Elément vide
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
}
Exemple
<specDesc key="orth"/>
Exemple
<specDesc key="emph"/>
Exemple
<specDesc key="foreign" atts="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.