<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] | |||||||||||||
Module | core | ||||||||||||
Attributes | att.global (@xml:id, @n, @xml:lang, @xml:base, @xml:space) (att.global.rendition (@rend, @style, @rendition)) (att.global.linking (@corresp, @synch, @sameAs, @copyOf, @next, @prev, @exclude, @select)) (att.global.analytic (@ana)) (att.global.facs (@facs)) (att.global.change (@change)) (att.global.responsibility (@cert, @resp)) (att.global.source (@source)) att.typed (type, @subtype)
| ||||||||||||
Member of | |||||||||||||
Contained by | 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 figures: cell figDesc figure notatedMusic 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 textstructure: body div docEdition epigraph | ||||||||||||
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 msdescription: catchwords depth dim dimensions height heraldry locus locusGrp material msDesc objectType origDate origPlace secFol signatures stamp watermark width namesdates: addName bloc country district 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 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> | ||||||||||||
Schematron | A 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> | ||||||||||||
Schema Declaration | element desc { tei_att.global.attributes, tei_att.typed.attribute.subtype, attribute type { "deprecationInfo" | teidata.enumerated }?, tei_macro.limitedContent } |