<!-- ComRef.DTD:  declarations common to OddRef and P2XRef.   -->
<!-- Draft 1, CMSMcQ, 25 November 1991.                       -->
<!-- Revisions:                                               -->
<!--  4 Jan 91 : LB, MSM : drop other pes for Att types.      -->
<!--      fixes to exemplum.                                  -->
<!--  3 Jan 91 : LB, MSM : drop %gidoc, no longer needed.     -->
<!--      add exemplum                                        -->
<!-- 29 Dec 91 : MSM : make ENTNAME, PENAME take #PCDATA      -->
<!--      require end-tag for STRING                          -->
<!--  7 Dec 91 : MSM : rename Class as Classes                -->
<!-- 29 Nov 91 : MSM : make class NAMES type IDREFS not NAMES -->
<!-- 27 Nov 91 : MSM : change elemdecl, attlDecl to #PCDATA   -->
<!--      from RCDATA; it's more trouble than it's worth.     -->
<!--      make DEFAULT take PCDATA not soup as content, to    -->
<!--          avoid having following EG taken as content.     -->
<!-- 26 Nov 91 : MSM : change GI att on TagDoc to CDATA       -->
<!-- 25 Nov 91 : MSM : made file                              -->
 
<!-- TagDoc:  SYSTEMatic documentation for an element.  Content models
differ in ODD and P2X.  Constituents are given here. -->
 
<!-- GI, name:  gi and full linguistic form of gi.            -->
<!-- GI is defined in ComAdd.dtd                              -->
<!-- name should be an expansion of GI or classname.          -->
<!-- omit if GI is a full NL word or phrase                   -->
<!-- lowercase unless proper noun                             -->
<!ELEMENT name          - O  (#PCDATA)                          >
<!ATTLIST name               %global;                           >
 
<!-- Desc, Def:  one-liner and full paragraph about item      -->
 
<!ELEMENT desc          - O  (%soup;)                           >
<!ATTLIST desc               %global;                           >
<!--
<!ELEMENT def           - O  (%p.seq;)                          >
<!ATTLIST def                %global;                           >
-->
 
<!-- Usage:  is this item required, mandatory when applicable,
recommended, or optional?  -->
<!--
<!ELEMENT usage         - O  (%soup;)                           >
<!ATTLIST usage              %global;                           >
-->
 
<!-- EG:  example of this item's use.  Will be CDATA section. -->
<!-- Need to allow more than one per Xdoc.                    -->
<!-- Single example per EG, to simplify formatting, indexing. -->
<!-- Commentary needed:  define EXEMPLUM element.             -->
<!ELEMENT exemplum      - O  (p*, eg, p*)                       >
<!ATTLIST exemplum           %global;                           >
<!-- Semantics of EG:  content is an example, not nec. SGML.  -->
<!-- Usual formatting:  obey lines, monospace font.           -->
<!-- Recognize tags and entity references.  (If tags, entity  -->
<!-- references not to be recognized, use CDATA section.)     -->
<!ELEMENT eg            - O  (%soup;)                           >
<!ATTLIST eg                 %global;                           >
 
<!-- Remarks:  whatever fits nowhere else.                    -->
<!ELEMENT remarks       - O  (%p.seq;)                          >
<!ATTLIST remarks            %global;                           >
 
<!-- Part:  separate in OddRef, P2XRef.                       -->
 
<!-- Classes:  assigns an element to one or more classes; the -->
<!-- membership of a class is controlled from here, not from  -->
<!-- Members element of the ClassDoc crystal.                 -->
<!-- In Odd, name only direct-membership classes.             -->
<!-- In P2X, take transitive closure, possibly in parens      -->
<!-- <!ELEMENT classes       - O  EMPTY                    >  -->
<!-- <!ATTLIST classes            %global;                    -->
<!--           names              IDREFS    #IMPLIED       >  -->
 
<!-- Files:  what file(s) is this element in?  P2X only.      -->
 
<!-- Bound, struct, parents, children:  is this element bound?
structured?  what are its parents?  children?  -->
<!-- bound, struct killed 3 Jan 92 MSM, LB -->
 
<!-- DataDesc:  are there constraints on element content?     -->
<!-- Declarative sentence, VP, NP, or adjectival phrase.      -->
<!-- For empty elements, use 'EMPTY'                          -->
<!ELEMENT dataDesc      - O  (%soup;)                           >
<!ATTLIST dataDesc           %global;                           >
 
<!-- Elemdecl:  form of element declaration (without <!element, gi, or
mdc:  just omissibility and content model.  -->
<!ELEMENT elemDecl      - O  (#PCDATA)                          >
<!ATTLIST elemDecl           %global;                           >
 
<!-- Attldecl:  P2X only. -->
 
<!-- Equiv:  equivalent or comparable items in other markup languages.
-->
<!ELEMENT equiv         - O  (%soup;)                           >
<!ATTLIST equiv              %global;
          mlang              CDATA               #REQUIRED      >
 
<!-- * * * * * * * * * * * * * * * * * * * * * * * * * * * *  -->
<!-- AttList:  list attributes for a given element.  This list will
contain entries for all attributes unique to this GI; no entries are
needed for attributes defined for a class to which this element belongs,
or for global attributes, unless the default definitions are to be
overridden.  A full definition must be given in either case:  overrides
cannot inherit anything from the default definitions.
 
N.B.  AttDef is identical in ODD and REF forms; it seems likely that
the example of usage will not be printed as part of the GI
documentation, however, so the OddRef processor is allowed to suppress
the EG, if it exists.  We don't expect to use EG often.
-->
 
<!ELEMENT attList       - -  (attDef*)                          >
<!ATTLIST attList            %global;                           >
<!ELEMENT attDef        - O  (attName,
                             name?,
                             desc,
                             (datatype, (valList | valDesc)?),
                             default,
                             eg?,
                             remarks?,
                             equiv*)                            >
<!ATTLIST attDef             %global;
          usage              (req | mwa | rec | rwa | opt) opt  >
<!ELEMENT attName       - O  (#PCDATA)                          >
<!ATTLIST attName            %global;                           >
<!ELEMENT valList       - -  ((val, desc)*)                     >
<!ATTLIST valList            %global;
          type               (closed | semi | open) open        >
<!-- Use ValDesc to describe syntactic/semantic constraints   -->
<!-- Don't re-state the Desc and Datatype.                    -->
<!ELEMENT valDesc       - O  (%soup;)                           >
<!ATTLIST valDesc            %global;                           >
 
<!-- Datatype should be a valid Declared Value:  CDATA,       -->
<!-- ENTITY, ENTITIES, ID, IDREF, IDREFS, NAME, NAMES,        -->
<!-- NMTOKEN, NMTOKENS, NUMBER, NUMBERS, NUTOKEN, NUTOKENS,   -->
<!-- notation, name token group                               -->
<!ELEMENT datatype      - O  (#PCDATA)                          >
<!ATTLIST datatype           %global;                           >
 
<!-- n.b. default has PCDATA not soup in model, since it must -->
<!-- be a legal default value and cannot have embedded tags.  -->
<!-- For inherited values, default is '*INHERITED'            -->
<!ELEMENT default       - O  (#PCDATA)                          >
<!ATTLIST default            %global;                           >
<!ELEMENT val           - O  (#PCDATA)                          >
<!ATTLIST val                %global;                           >
 
<!-- * * * * * * * * * * * * * * * * * * * * * * * * * * * *  -->
<!-- AttDoc:  gives a SYSTEMatic documentation for a given attribute.
This is used only in P2Xref.dtd. -->
 
<!-- * * * * * * * * * * * * * * * * * * * * * * * * * * * *  -->
<!-- PEDoc:  SYSTEMatic documentation of a parameter entity.
Differs in ODD and P2X. -->
 
<!ELEMENT string        - -  (#PCDATA)                          >
<!ATTLIST string             %global;                           >
 
<!-- * * * * * * * * * * * * * * * * * * * * * * * * * * * *  -->
<!-- GEDoc:  SYSTEMatic documentation of a general entity.  Different
in Odd and P2X.
-->
<!ELEMENT entName       - O  (#PCDATA)                          >
<!ATTLIST entName            %global;                           >
 
<!-- * * * * * * * * * * * * * * * * * * * * * * * * * * * * -->
<!-- ClassDoc:  SYSTEMatic documentation of an element class; differs in
ODD and P2X.  MEMBERS lists elements which form part of this class (it
must be generated from the CLASS elements of individual TagDoc
crystals).  -->
 
<!ELEMENT class         - O  (#PCDATA)                          >
<!ATTLIST class              %global;                           >




