Chapter 38
SAMPLE TAG SET DOCUMENTATION
38.1 Tag Documentation for the TEI P Element
This example shows the documentation for the element <p>. Since this element has no attributes other than global attributes, its <attList> element is empty. For a formatted, printed version of this information, see the alphabetical reference section.
<tagDoc id=p usage=req>
<gi>p</gi>
<rs>paragraph</rs>
<desc>marks paragraphs in prose.</desc>
<attlist>
</attlist>
<exemplum><eg><![ CDATA [
<p>Hallgerd was outside. <q>There is blood on your
axe,</q> she said. <q>What have you done?</q></p>
<p><q>I have now arranged that you can be married a
second time,</q> replied Thjostolf.</p>
<p><q>Then you must mean that Thorvald is dead,</q>
she said.</p>
<p><q>Yes,</q> said Thjostolf. <q>And now you must
think up some plan for me.</q>
]]>
</eg>
</exemplum>
<remarks><p>In some contexts, the paragraph may have a specialized
meaning, e.g. in the tag set for dictionaries, <gi>p</gi> is used to
enclose any running text, and thus does not imply text set off as is
conventionally done in running prose.
<part type='top' name='core'>additional tag set for common core
features</part>
<classes names='chunk'>chunk [and indirectly also:] common</classes>
<files names='teicore2'>
<datadesc>May contain character data and phrase-level elements.
<parents>add argument availability body broadcast castList corr
correction div div0 div1 div2 div3 div4 div5 div6 div7 editionStmt
editorialDecl encodingDesc epigraph epilogue equipment equiv exemplum
figure hyphenation interpretation item langUsage metDecl
normalization note particDesc particLinks performance person
personGrp projectDesc prologue publicationStmt q quotation quote
recording recordingStmt refsDecl remarks samplingDecl scriptStmt
segmentation seriesStmt set setting settingDesc sic sourceDesc sp
stage stdVals view</parents>
<children>#PCDATA abbr add address anchor att bibl biblFull
biblStruct c caesura camera caption castList cit cl corr date
dateRange dateStruct del distinct emph expan figure foreign formula
gap gi gloss handShift hi label lang link list listBibl m measure
mentioned move name note num orig oRef oVar phr ptr pRef pVar q quote
ref reg rs s seg sic sound soCalled stage table tag tech term text
time timeRange timeStruct title val view w xptr xref</children>
<elemdecl>
<![ CDATA [
<!ELEMENT p - O (%paraContent;) >
]]>

</elemdecl>
<attldecl>
<![ CDATA [
<!ATTLIST p %a.global >
]]>
</attldecl>
<ptr type=div2 target=COpa>
<ptr type=div2 target=DRpal>
</tagdoc>
38.2 Tag Documentation for the TEI HI Element
The <hi> element, shown below, offers an example of attribute defini- tion. Since the attribute definition in question overrides a definition inherited from the global class, no reference is made to the entity a.global. Instead, the other global attributes are all redefined.
<tagdoc usage=opt id="hi"><gi>hi</gi>
<rs>highlighted</rs>
<desc>marks a word or phrase as graphically distinct from the
surrounding text, for reasons concerning which no claim is made.
</desc>
<attlist>
<!-- ................................................... rend -->
<attDef usage=rec>
<attname>rend
<rs>rendition</rs>
<desc>describes the rendition or presentation of the word or phrase
highlighted.
<datatype>CDATA
<valdesc>a set of keywords from some suitable vocabulary; no systematic
recommendations for such a vocabulary are made by these Guidelines.
<default>#IMPLIED
<eg><![ CDATA [
]]>
</eg>
<remarks><p>The <att>rend</att> attribute, though optional in general,
is recommended on the <gi>hi</gi> element.
</attDef>
</attlist>
<exemplum><eg><![ CDATA [
<hi rend=gothic>And this Indenture further witnesseth</hi>
that the said <hi rend=italic>Walter Shandy</hi>, merchant,
in consideration of the said intended marriage ...
]]>
</eg></exemplum>
<remarks></remarks>
<part type='aux' name='hdr'>auxiliary tag set for TEI headers</part>
<classes names='hqphrase'>hqphrase [and indirectly also:]
phrase</classes>
<files names='teicore2'>
<datadesc>free prose</datadesc>
<parents>abbr activity actor add addrLine addName admin affiliation
author authority bibl biblScope birth bloc byline camera caption case

castItem catDesc cell channel cl classCode closer colloc constitution
corr country creation damage dataDesc date dateRange def del
derivation desc descrip distance distinct distributor docAuthor
docDate docEdition docImprint domain edition editor education emph
equiv etym expan extent factuality figDesc firstLang foreign forename
form fsDescr funder fw fDescr gen genName gloss gram gramGrp head
headItem headLabel hi hyph imprimatur interaction item itype l label
lang language langKnown lbl lem locale measure meeting mentioned mood
name nameLink note num number occasion occupation opener orgdivn
orgtitle orgtype orgName orig orth otherForm p per persName phr
placeName pos preparedness principal pron publisher pubPlace purpose
q quote rdg re ref reg region rendition residence resp restore role
roleDesc roleName rs s salute seg sense set settlement sic signed
socecStatus sound soCalled speaker sponsor stage street stress subc
supplied surname syll symbol tagUsage tech term time timeRange title
titlePart tns tr trailer trans u unclear usg valDesc view wit witness
witDetail writing xr xref</parents>
<children>#PCDATA abbr add address anchor att bibl biblFull
biblStruct c caesura camera caption castList cit cl corr date
dateRange dateStruct del distinct emph expan figure foreign formula
gap gi gloss handShift hi label lang link list listBibl m measure
mentioned move name note num orig oRef oVar phr ptr pRef pVar q quote
ref reg rs s seg sic sound soCalled stage table tag tech term text
time timeRange timeStruct title val view w xptr xref</children>
<elemdecl>
<![ CDATA [
<!ELEMENT hi - - (%paraContent;) >
]]>
</elemdecl>
<attldecl>
<![ CDATA [
<!ATTLIST hi %a.fs
%a.analysis
%a.linking
%a.terminology
id ID #IMPLIED
n CDATA #IMPLIED
lang IDREF %INHERITED
rend CDATA #IMPLIED >
]]>
</attldecl>
<ptr target=COhqhe>
<ptr target=COhqh>
</tagdoc>
38.3 Tag Documentation for the TEI Div Element
The example below shows the documentation for the <div> element; this element is a member of the class divn, the documentation for which is shown further below.
<tagdoc usage=rwa id="div"><gi>div</gi>
<rs>text division</rs>

<desc>contains a subdivision of the front, body, or back of a
text.</desc>
<attlist>
</attlist>
<exemplum><eg><![ CDATA [
<body>
<div type=part><head>Fallacies of Authority</head>
<epigraph>The subject of which is Authority in
various shapes, and the object, to repress all
exercise of the reasoning faculty.</epigraph>
<div type=chapter n=1><head>The Nature of Authority</head>
<p>With reference to any proposed measures
having for their object the greatest happiness
of the greatest number....
<div type=section n='1.1'><head>Analysis of Authority
<p>What on any given occasion is the legitimate
weight or influence to be attached to authority
<!-- ... -->
</div>
<div type=section n='1.2'><head>Appeal to Authority,
in What Cases Fallacious.
<p>Reference to authority is open to the charge of
fallacy when...
<!-- ... -->
</div>
<!-- other sections here -->
</div>
<div type=chapter n=2>
<!-- other chapters here -->
</div>
</div>
<!-- other parts here -->
</body>
]]><!-- J Bentham: Handbook of Political Fallacies (1824), ed -->
<!-- Larrabee, Johns Hopkins Pr, 1952 -->
</eg></exemplum>
<remarks>
<part type='base' name='core'>base tag set for common core
features</part>
<classes names='divn decling'>declaring, divn</classes>
<files names='teistr2'>
<datadesc>any sequence of low-level structural elements, possibly grouped
into lower subdivisions.</datadesc>
<parents>back body div front</parents>
<children>argument bibl biblFull biblStruct byline camera caption
castList cit closer div docAuthor docDate entry entryFree epigraph
event eTree graph head kinesic l label lg lg1 list listBibl move note
opener p pause q quote salute shift signed sound sp stage superentry
tech termEntry trailer tree u view vocal writing</children>
<elemdecl>
<![ CDATA [
<!ELEMENT div - O ((%m.divtop;)*, (div+ |
((%component;)+, div*)),
(%m.divbot;)*) >
]]>
</elemdecl>
<attldecl>
<![ CDATA [
<!ATTLIST div %a.global

%a.declaring
%a.divn >
]]>
</attldecl>
<ptr target=DSdiv>
<ptr target=tedt><ptr target=dsdiv1>
</tagdoc>
38.4 Class Documentation for the TEI Divn Class
The example below shows the documentation for the class divn, which is referred to by the documentation for <div> shown above. The class documentation in the alphabetical reference section of this document uses a slightly extended tag set which provides for information about elements within which members of the class may appear, members of the class, and the actual declaration of the parameter entities by which properties of the class are expressed.
<classDoc id=divn type=atts>
<class>divn</class>
<desc>structural elements which behave in the same way as divisions.
<attlist>
<attDef usage=rec>
<attname>type</attname>
<desc>specifies a name conventionally used
for this level of subdivision, e.g. <q>act</q>,
<q>volume</q>, <q>book</q>, <q>section</q>, <q>canto</q>, etc.</desc>
<datatype>CDATA
<valdesc>any string of characters</valdesc>
<default>#CURRENT
</attdef>
<attdef usage=opt><attname>org
<desc>specifies how the content of the division is organized.
<datatype>(composite | uniform)
<vallist type=closed>
<val>composite<desc>composite content: i.e. no claim is
made about the sequence in which the immediate contents of this
division are to be processed, or their inter-relationships.</desc>
<val>uniform<desc>uniform content: i.e. the immediate contents
of this element are regarded as forming a logical unit,
to be processed in sequence.</desc>
</vallist>
<default>uniform
</attdef>
<attdef>
<attname>sample
<desc>indicates whether this division is a sample of the original source
and if so, from which part.
</desc>
<datatype>(initial | medial | final | unknown | complete)
<vallist type=closed>
<val>initial<desc>division lacks material present at end in
source.</desc>
<val>medial<desc>division lacks material at start and end.</desc>
<val>final<desc>division lacks material at start.</desc>
<val>unknown<desc>position of sampled material within original
unknown.</desc>

<val>complete<desc>division is not a sample.</desc>
</vallist>
<default>complete
<remarks>
</attDef>
<attdef usage=mwa><attname>part</attname>
<desc>specifies whether or not the division is fragmented by some other
structural element, for example a speech which is divided between two
or more verse stanzas.
</desc>
<datatype>(Y | N | I | M | F)
<vallist type=closed>
<val>Y<desc>the division is incomplete in some respect</desc>
<val>N<desc>either the division is complete, or no claim is made as to
its completeness.</desc>
<val>I<desc>the initial part of an incomplete division</desc>
<val>M<desc>a medial part of an incomplete division</desc>
<val>F<desc>the final part of an incomplete division</desc>
</vallist>
<default>N
<remarks><p>The values I, M, or F should be used only where it is
clear how the division is to be reconstituted.
</attdef>
</attlist>
<part type='base' name='core'>base tag set for common core
features</part>
<classes names=''></classes>
<files names='teiclas2.ent'>
<ptr target=DS>
</classdoc>