<specDesc>

<specDesc> (description d'élément ou de classe) indique qu'une description de l'élément particulier ou de la classe particulière doit être incluse à ce point dans un document
Moduletagdocs — 22 Documentation Elements
Attributs
key (identifiant) donne l'identifiant de l'élément ou de la classe documentaires dont 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 d'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="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 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
Peut contenirElé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"/>
Note
La description est habituellement affichée sous la forme d'une étiquette et d'un contenu, avec toute liste 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.