<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 — Elements Available in All TEI Documents | ||||||||||||
Attributes |
|
||||||||||||
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 unclear
dictionaries: case colloc def dictScrap entryFree etym form gen gram gramGrp hyph iType lang lbl mood number orth per pos pron stress subc syll tns usg xr
figures: cell figDesc figure notatedMusic
header: application category change citeStructure handNote licence listChange listPrefixDef rendition schemaRef scriptNote tagUsage taxonomy unitDef
msdescription: accMat acquisition additions collation condition custEvent decoNote filiation foliation layout musicNotation origin provenance signatures source summary support surrogates typeNote
namesdates: climate event listEvent listNym listObject listOrg listPerson listPlace listRelation location occupation org place population relation state terrain trait
nets: listForest
tagdocs: attDef classSpec constraintSpec dataSpec elementSpec listRef macroSpec model modelGrp modelSequence moduleSpec paramSpec schemaSpec valItem
textstructure: argument body div div1 div2 div3 div4 div5 div6 div7 docEdition epigraph imprimatur postscript salute signed titlePart trailer
transcr: damage listTranspose metamark mod restore retrace secl space substJoin supplied surface surplus
verse: rhyme
|
||||||||||||
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 affiliation bloc climate country district eventName forename genName geo geogFeat geogName listEvent listNym listObject listOrg listPerson listPlace listRelation location nameLink objectName offset orgName persName persPronouns placeName population region roleName settlement state surname terrain trait
tagdocs: att classSpec code constraintSpec dataSpec eg egXML elementSpec gi ident listRef macroSpec moduleSpec outputRendition specGrp specGrpRef tag val
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 |
<rng:element name="desc"> element desc { att.global.attributes, att.global.rendition.attributes, att.global.linking.attributes, att.global.analytic.attributes, att.global.facs.attributes, att.global.change.attributes, att.global.responsibility.attributes, att.global.source.attributes, att.translatable.attributes, att.typed.attribute.subtype, attribute type { "deprecationInfo" | teidata.enumerated }?, macro.limitedContent } |