 <!-- $Id: p2dt.odd,v 1.4 1998/01/30 16:44:49 tei Exp $ -->
<!--*
    * $Log: p2dt.odd,v $
    * Revision 1.4  1998/01/30 16:44:49  tei
    * fix log keyword
    *
    * Revision 1.3  1994/04/08 18:54:36  msmcq
    * Last-second fixes for P3
    *-->
<!-- Revisions:                                               -->
<!-- 94-04-07 : MSM : add ID, add list of files               -->
<!-- 94-04-07 : MSM : Added RCS id                            -->
<div1 id=DT n=36><head>Obtaining the TEI DTD</head>
<p>Full copies of the TEI DTD fragments are not repeated in this
document, although they may be reconstituted by a careful reading of
each chapter.
<p>The DTD fragments are widely available over the Internet and
elsewhere.  At the time of publication, the following anonymous file
servers are expected to carry copies of a full set.  The first is
a Listserv server, the others are anonymous FTP servers.
<list>
<item>listserv@uicvm.uic.edu in filelist tei-l
<item>sgml1.ex.ac.uk in directory tei/p2/dtds
<item>ftp.ifi.uio.no in directory TEI
</list>
<p>The files are these:
<list type=bullets>
<item><ident type=file>teiana2.dtd</ident>:  tags for simple analysis
<item><ident type=file>teiana2.ent</ident>:  parameter entities for
simple analysis
<item><ident type=file>teiback2.dtd</ident>:  tags for back matter
<item><ident type=file>teicert2.dtd</ident>:  tags for certainty and
responsibility
<item><ident type=file>teiclas2.ent</ident>:  parameter entities for the
core tag sets
<item><ident type=file>teicore2.dtd</ident>:  core tags
<item><ident type=file>teicorp2.dtd</ident>:  tags for additional header
material for corpora and collections
<item><ident type=file>teidict2.dtd</ident>:  tags for printed
dictionaries
<item><ident type=file>teidict2.ent</ident>:  parameter entities for
printed dictionaries
<item><ident type=file>teidram2.dtd</ident>:  tags for performance texts
<item><ident type=file>teidram2.ent</ident>:  parameter entities for
performance texts
<item><ident type=file>teifig2.dtd</ident>:  tags for tables, formulae,
and graphics
<item><ident type=file>teifig2.ent</ident>:  parameter entities for
tables, formulae, and graphics
<item><ident type=file>teifron2.dtd</ident>:  tags for front matter
<item><ident type=file>teifsd2.dtd</ident>:  feature system declaration
<item><ident type=file>teifs2.dtd</ident>:  tags for feature structure
annotation
<item><ident type=file>teigen2.dtd</ident>:  tags for general base
<item><ident type=file>teigis2.ent</ident>:  parameter entities for
names of TEI elements
<item><ident type=file>teihdr2.dtd</ident>:  tags for TEI header
<item><ident type=file>teikey2.ent</ident>:  parameter entities for TEI
keywords
<item><ident type=file>teilink2.dtd</ident>:  tags for linking,
segmentation, and alignment
<item><ident type=file>teilink2.ent</ident>:  parameter entities for
linking, segmentation, and alignment
<item><ident type=file>teimix2.dtd</ident>:  tags for mixed base
<item><ident type=file>teind2.dtd</ident>:  tags for names and dates
<item><ident type=file>teind2.ent</ident>:  parameter entities for names
and dates
<item><ident type=file>teinet2.dtd</ident>:  tags for networks, graphs,
digraphs, and trees
<item><ident type=file>teipl2.dtd</ident>:  tags for concurrent markup
of pages and lines
<item><ident type=file>teipros2.dtd</ident>:  tags for prose
<item><ident type=file>teishd2.dtd</ident>:  tags for independent header
<item><ident type=file>teispok2.dtd</ident>:  tags for spoken texts
<item><ident type=file>teispok2.ent</ident>:  parameter entities for
spoken texts
<item><ident type=file>teistr2.dtd</ident>:  tags for default text
structure
<item><ident type=file>teitc2.dtd</ident>:  tags for text criticism
<item><ident type=file>teitc2.ent</ident>:  parameter entities for text
criticism
<item><ident type=file>teiterm2.dtd</ident>:  tags for terminological
data
<item><ident type=file>teiterm2.ent</ident>:  parameter entities for
terminological data
<item><ident type=file>teite2f.dtd</ident>:  tags for terminological
data
<item><ident type=file>teite2n.dtd</ident>:  tags for terminological
data
<item><ident type=file>teitran2.dtd</ident>:  tags for transcription of
primary sources
<item><ident type=file>teitran2.ent</ident>:  parameter entities for
transcription of primary sources
<item><ident type=file>teitsd2.dtd</ident>:  tags for tag set
documentation
<item><ident type=file>teivers2.dtd</ident>:  tags for verse
<item><ident type=file>teivers2.ent</ident>:  parameter entities for
verse
<item><ident type=file>teiwsd2.dtd</ident>:  tags for writing system
declaration
<item><ident type=file>tei2.dtd</ident>:  main TEI DTD file
</list>
                    <!-- 33 Full TEI DTDs -->
 <!-- Revisions:                                               -->
<!-- 94-04-07 : MSM : mostly cosmetic changes                 -->
<!-- 94-04-07 : MSM : suppress div2 elements                  -->
<!-- 94 -03-15 LB : rewrote -->
<!-- 93-04-12 : MSM : made file                               -->
<div1 id=XW n=37><head>Obtaining TEI WSDs</head>

<p>The TEI has produced a number of exemplary Writing System
Definitions, corresponding with several major international standards.
This section lists those which are currently available. In each case,
the root name specified is that used for the file on the TEI file
servers.

<p>A typical public identifier for a Writing System Declaration from this
list would be

<eg>
<![ CDATA [

<!ENTITY xxxx PUBLIC
    " -//TEI-1994//NOTATION WSD for YYY //EN" >

]]>
</eg>

where xxxxx corresponds with the short name given in the list below,
and YYY with the longer description provided.

<p>Writing system declarations corresponding to some
standard character sets include:
<list type=gloss>
<label>ISO646ss <item>ISO 646 Non-national Subset
<label>ISO646ir <item>ISO 646 International Reference Version
<label>ISO88591 <item>ISO 8859 Part 1 (Latin 1, Western Europe)
<label>ISO88592 <item>ISO 8859 Part 2 (Latin 2, Eastern Europe)
<label>ISO88595<item>ISO 8859 Part 5 (Latin and Cyrillic)
<label>ISO88597 <item>ISO 8859 Part 7 (Latin and Greek)
<label>ISO88598 <item>ISO 8859 Part 8 (Latin and Hebrew)
<label>ISO88599 <item>ISO 8859 Part 9 (Latin 5, Western Europe and Turkey)
</list>
<p>Writing system declarations documenting special sets of entities for
different alphabets, or commonly used transliteration systems, include
the following:

<list>
<label>TEIarb<item>TEI Entities for Arabic
<label>TEIcop<item>TEI Entities for Coptic
<label>TEIgrk<item>TEI Entities for Greek
<label>TEIipa<item>TEI Entities for International Phonetic Alphabet
</list>

<p>All standard TEI writing system declarations may be obtained from
the same file servers as are listed in chapter
<ptr target=DT>.

                    <!-- 33 Standard WSDs -->
<!-- &p2.xf; -->    <!--    FSD for Basic Gramm. -->
<!-- Revisions:                                               -->
<!-- 94-04-07 : MSM : strip down classdoc                     -->
<!-- 94-04-07 : MSM : complete refreshment                    -->
<!-- 94-04-07 : MSM : refresh examples                        -->
<!-- 93-06-05 : MSM : add editorial note, change title per Eynsham -->
<!-- 93-04-13 : MSM : Use refs, not odd versions (!)          -->
<!-- 93-04-13 : MSM : Correct marked sections                 -->
<div1 id=XT n=38><head>Sample Tag Set Documentation

<div2><head>Tag Documentation for the TEI P Element
<p>This example shows the documentation for the element <gi>p</gi>.
Since this element has no attributes other than global attributes,
its <gi>attList</gi> element is empty.
For a formatted, printed version of this information, see the
alphabetical reference section.
<eg>
<![ RCDATA [
<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>
]&nil]>
</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;)                    >
]&nil]>
</elemdecl>
<attldecl>
<![ CDATA [
<!ATTLIST p                  %a.global                          >
]&nil]>
</attldecl>

<ptr type=div2 target=COpa>
<ptr type=div2 target=DRpal>
</tagdoc>
]]>
</eg>

<div2><head>Tag Documentation for the TEI HI Element
<p>The <gi>hi</gi> element, shown below, offers an example of attribute
definition.  Since the attribute definition in question overrides a
definition inherited from the <ident type=class>global</ident> class,
no reference is made to the entity <ident type=pe>a.global</ident>.
Instead, the other global attributes are all redefined.
<eg>
<![ RCDATA [
<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 [

]&nil]>
</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 ...
]&nil]>
</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;)                    >
]&nil]>
</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       >
]&nil]>
</attldecl>

<ptr target=COhqhe>
<ptr target=COhqh>
</tagdoc>
]]>
</eg>


<div2><head>Tag Documentation for the TEI Div Element

<p>The example below shows the documentation for the <gi>div</gi>
element; this element is a member of the class
<ident type=class>divn</ident>, the documentation for which is shown
further below.
<eg>
<![ RCDATA [
<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>
]&nil]><!-- 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;)*)                     >
]&nil]>
</elemdecl>
<attldecl>
<![ CDATA [
<!ATTLIST div                %a.global
                             %a.declaring
                             %a.divn                            >
]&nil]>
</attldecl>

<ptr target=DSdiv>
<ptr target=tedt><ptr target=dsdiv1>
</tagdoc>
]]>
</eg>

<div2><head>Class Documentation for the TEI Divn Class

<p>The example below shows the documentation for the class
<ident type=class>divn</ident>, which is referred to by the
documentation for <gi>div</gi> 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.

<eg>
<![ RCDATA [
<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>
]]>
</eg>
            <!-- 33 Sample Tag Set Decl. -->
