<elementSpec>

<elementSpec> (element specification) documents the structure, content, and purpose of a single element type. 22.4.4 Element Specifications 22 Documentation Elements
Moduletagdocs — 22 Documentation Elements
Attributes att.identified (@ident, @predeclare, @module, @mode)
ns(namespace) specifies the namespace to which this element belongs
Status Optional
Datatype 

<rng:ref name="data.namespace"/>
data.namespace
usagespecifies the optionality of an attribute or element.
Status Optional
Legal values are:
req
(required)
mwa
(mandatory when applicable)
rec
(recommended)
rwa
(recommended when applicable)
opt
(optional) [Default]
Used by
model.oddDecl
May contain
core: desc gloss
tagdocs: altIdent attList classes content equiv exemplum listRef remarks
Declaration

<rng:element name="elementSpec">
<rng:ref name="att.global.attributes"/>
<rng:ref name="att.identified.attributes"/>
<rng:optional>
 <rng:attribute name="ns"
   a:defaultValue="http://www.tei-c.org/ns/1.0">
  <rng:ref name="data.namespace"/>
 </rng:attribute>
</rng:optional>
<rng:optional>
 <rng:attribute name="usage" a:defaultValue="opt">
  <rng:choice>
   <rng:value>req</rng:value>
   <rng:value>mwa</rng:value>
   <rng:value>rec</rng:value>
   <rng:value>rwa</rng:value>
   <rng:value>opt</rng:value>
  </rng:choice>
 </rng:attribute>
</rng:optional>
<rng:group>
 <rng:zeroOrMore>
  <rng:ref name="model.glossLike"/>
 </rng:zeroOrMore>
<!--      <rng:ref name="macro.glossSeq"/>-->
 <rng:optional>
  <rng:ref name="classes"/>
 </rng:optional>
 <rng:optional>
  <rng:ref name="content"/>
 </rng:optional>
 <rng:optional>
  <rng:ref name="attList"/>
 </rng:optional>
 <rng:zeroOrMore>
  <rng:ref name="exemplum"/>
 </rng:zeroOrMore>
 <rng:zeroOrMore>
  <rng:ref name="remarks"/>
 </rng:zeroOrMore>
 <rng:zeroOrMore>
  <rng:ref name="listRef"/>
 </rng:zeroOrMore>
</rng:group>
</rng:element>
element elementSpec
{
   att.global.attributes,
   att.identified.attributes,
   attribute ns { data.namespace }?,
   attribute usage { "req" | "mwa" | "rec" | "rwa" | "opt" }?,
   (
      model.glossLike*,
      classes?,
      content?,
      attList?,
      exemplum*,
      remarks*,
      listRef*
   )
}
Example
<elementSpec
  module="tagdocs"
  xml:id="Code"
  usage="mwa"
  ident="code">
 <equiv/>
 <gloss/>
 <desc>contains literal code</desc>
 <classes>
  <memberOf key="model.emphLike"/>
 </classes>
 <content>
  <rng:text/>
 </content>
 <attList>
  <attDef ident="type" usage="opt">
   <equiv/>
   <desc>the language of the code</desc>
   <datatype>
    <rng:ref name="data.enumerated"/>
   </datatype>
  </attDef>
 </attList>
</elementSpec>