<desc>

<desc> (description) contains a short description of the purpose, function, or use of its parent element, or when the parent is a documentation element, describes or defines the object being documented. [22.4.1. Description of Components]
Modulecore
Attributes
typecharacterizes the element in some sense, using any convenient classification scheme or typology.
Derived fromatt.typed
Status Optional
Datatype teidata.enumerated
Suggested values include:
deprecationInfo
(deprecation information) This element describes why or how its parent element is being deprecated, typically including recommendations for alternate encoding.
<dataSpec module="tei"
 ident="teidata.point" validUntil="2050-02-25">
 <desc type="deprecationInfo"
  versionDate="2018-09-14" xml:lang="en">Several standards bodies, including NIST in the USA,
   strongly recommend against ending the representation of a number
   with a decimal point. So instead of <q>3.</q> use either <q>3</q>
   or <q>3.0</q>.</desc>
<!-- ... -->
</dataSpec>
Member of
model.descLike model.labelLike
Contained by
analysis: interp interpGrp
certainty: certainty precision
core: add corr del desc ellipsis emph gap graphic head hi item l lg list listBibl media meeting note noteGrp orig p q quote ref reg said sic stage textLang title
dictionaries: form gen lang
figures: cell figDesc figure notatedMusic
gaiji: charDecl glyph
header: application category change citeStructure handNote licence listChange listPrefixDef rendition schemaRef scriptNote tagUsage taxonomy unitDef
linking: ab join linkGrp listAnnotation seg
msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote
namesdates: event listEvent listNym listObject listOrg listPerson listPlace listRelation location org place relation state
spoken: transcriptionDesc
textcrit: lem listApp rdg
textstructure: body div docEdition epigraph
transcr: damage listTranspose metamark mod retrace secl space substJoin supplied surface surplus
May contain
core: abbr address bibl biblStruct choice cit date desc distinct email emph expan foreign gloss hi label list listBibl measure measureGrp mentioned name num ptr q quote ref rs said soCalled stage term time title unit
dictionaries: lang
figures: table
header: biblFull idno
msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width
namesdates: addName bloc country district eventName forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location objectName offset orgName persName persPronouns placeName region roleName settlement state surname
textcrit: listApp
textstructure: floatingText
transcr: am ex subst
character data
Note

When used in a specification element such as <elementSpec>, TEI convention requires that this be expressed as a finite clause, begining with an active verb.

Example

Example of a desc element inside a documentation element.

<dataSpec module="tei"
 ident="teidata.point">
 <desc versionDate="2010-10-17"
  xml:lang="en">defines the data type used to express a point in cartesian space.</desc>
 <content>
  <dataRef name="token"
   restriction="(-?[0-9]+(\.[0-9]+)?,-?[0-9]+(\.[0-9]+)?)"/>
 </content>
<!-- ... -->
</dataSpec>
Example

Example of a desc element in a non-documentation element.

<place xml:id="KERG2">
 <placeName>Kerguelen Islands</placeName>
<!-- ... -->
 <terrain>
  <desc>antarctic tundra</desc>
 </terrain>
<!-- ... -->
</place>
SchematronA desc with a type of deprecationInfo should only occur when its parent element is being deprecated. Furthermore, it should always occur in an element that is being deprecated when desc is a valid child of that element.

<sch:rule context="tei:desc[ @type eq 'deprecationInfo']">
<sch:assert test="../@validUntil">Information about a
deprecation should only be present in a specification element
that is being deprecated: that is, only an element that has a
@validUntil attribute should have a child <desc
type="deprecationInfo">.</sch:assert>
</sch:rule>
Content model
<content>
 <macroRef key="macro.limitedContent"/>
</content>
Schema Declaration
element desc
{
   tei_att.global.attributes,
   tei_att.typed.attribute.subtype,
   attribute type { "deprecationInfo" | teidata.enumerated }?,
   tei_macro.limitedContent
}