TYPICAL INVOCATION:

#  

#       "-//W3C//DTD Specification::19980323//EN"

#       "http://www.w3.org/XML/Group/DTD/xmlspec.dtd">

PURPOSE:

  This DTD was developed for use with the XML family of W3C

  specifications.  It is an XML-compliant DTD based in part on

  the TEI Lite and Sweb DTDs.

DEPENDENCIES:

  None.

CHANGE HISTORY:

  The list of changes is at the end of the DTD.

  For all details, see the design report at:

    <http://www.w3.org/XML/Group/DTD/xmlspec-report.htm>

  The "typical invocation" FPI always gets updated to reflect the

  date of the most recent changes.

  Search this file for "#" in the first column to see change history

  comments.

MAINTAINER:

  Eve Maler

  ArborText Inc.

  elm@arbortext.com

  voice: +1 781 270 5750

  fax:   +1 781 273 3760

-->

#1998-03-10: maler: Added “ and ”.

#                   Used 8879:1986-compatible decimal character

#                   references.

#                   Merged charent.mod file back into main file.

-->

#1997-10-16: maler: Added table to %illus.class;.

#1997-11-28: maler: Added htable to %illus.class;.

#1997-12-29: maler: IGNOREd table.

#1998-03-10: maler: Removed SGML Open-specific %illus.class;.

#                   Added "local" entities for customization.

-->

                                %local.p.class;">

                                %local.statusp.class;">

                                %local.list.class;">

                                %local.speclist.class;">

                                %local.note.class;">

                                %local.illus.class;">

#1997-12-29: maler: Added xspecref to %ref.class;.

#1998-03-10: maler: Added %ednote.class;.

#                   Added "local" entities for customization.

-->

                                %local.annot.class;">

                                %local.termdef.class;">

                                %local.emph.class;">

                                |xspecref|xtermref

                                %local.ref.class;">

                                %local.loc.class;">

                                %local.tech.class;">

                                %local.ednote.class;">

#1997-09-30: maler: Created %p.mix; to eliminate p from self.

#1997-09-30: maler: Added %speclist.class; to %obj.mix; and %p.mix;.

#1997-09-30: maler: Added %note.class; to %obj.mix; and %p.mix;.

#1997-10-16: maler: Created %entry.mix;.  Note that some elements

#                   left out here are still allowed in termdef,

#                   which entry can contain through %p.pcd.mix;.

#1997-11-28: maler: Added %p.class; to %statusobj.mix;.

#1998-03-10: maler: Added %ednote.class; to all mixtures, except

#                   %p.mix; and %statusobj.mix;, because paragraphs

#                   and status paragraphs will contain ednote

#                   through %p.pcd.mix;.

#1998-03-123: maler: Added %termdef.mix; (broken out from

#                    %termdef.pcd.mix;).

-->

        "%p.class;|%list.class;|%speclist.class;|%note.class;

        |%illus.class;|%ednote.class;">

        "%p.class;|%list.class;|%speclist.class;|%note.class;

        |%illus.class;|%ednote.class;">

        "%list.class;|%speclist.class;|%note.class;|%illus.class;">

        "%list.class;|note|eg|graphic|%ednote.class;">

        "%p.class;|%statusp.class;|%list.class;">

        "%p.class;|%list.class;|%ednote.class;">

        "%note.class;|%illus.class;">

        and %illus.class;, considered standalone elements. -->

#1997-09-30: maler: Added scrap and %note.class; to %termdef.pcd.mix;.

#1997-11-28: maler: Added %loc.class; to %p.pcd.mix;.

#1998-03-10: maler: Added %ednote.class; to all mixtures.

#1998-03-23: maler: Moved some %termdef.pcd.mix; stuff out to

#                   %termdef.mix;.

-->

        "#PCDATA|%annot.class;|%termdef.class;|%emph.class;

        |%ref.class;|%tech.class;|%loc.class;|%ednote.class;">

        "#PCDATA|%annot.class;|%termdef.class;|%emph.class;

        |%ref.class;|%tech.class;|%loc.class;|%ednote.class;">

        "#PCDATA|%annot.class;|%emph.class;|%tech.class;|%ednote.class;">

        "#PCDATA|%annot.class;|%termdef.class;|%emph.class;|%tech.class;

        |%ednote.class;">

        "#PCDATA|%annot.class;|%emph.class;|%ednote.class;">

        "#PCDATA|term|%emph.class;|%ref.class;|%tech.class;

        |%ednote.class;">

        "#PCDATA|%emph.class;|%ref.class;|%loc.class;|%ednote.class;">

        "#PCDATA|%ednote.class;">

        "#PCDATA|%loc.class;|%ednote.class;">

#1998-03-10: maler: Added customization entities.

-->

        "header, front?, body, back?">

        "title, subtitle?, version, w3c-designation, w3c-doctype,

        pubdate, notice*, publoc, latestloc?, prevlocs?, authlist,

        abstract, status, pubstmt?, sourcedesc?, langusage,

        revisiondesc">

        "day?, month, year">

        Optionally provides a sorting or indexing key, for cases when

        the element content is inappropriate for this purpose. -->

        'key                    CDATA           #IMPLIED'>

        Points to the element where the relevant definition can be

        found, using the IDREF mechanism.  %def.att; is for optional

        def attributes, and %def-req.att; is for required def

        attributes. -->

        'def                    IDREF           #IMPLIED'>

        'def                    IDREF           #REQUIRED'>

        Points to the element where more information can be found,

        using the IDREF mechanism.  %ref.att; is for optional

        ref attributes, and %ref-req.att; is for required ref

        attributes. -->

        'ref                    IDREF           #IMPLIED'>

        'ref                    IDREF           #REQUIRED'>

#1998-03-23: maler: Added show and actuate attributes to href.

#                   Added semi-common xml:space attribute.

-->

        Points to the element where more information or source data

        can be found, using the URL (XLL simple link) mechanism.

        For some purposes, is associated with additional XLL

        attributes. %href.att; is for optional HREF attributes,

        and %href-req.att; is for required HREF attributes.

        %source-req.att; is for the source attribute, which

        is always required. -->

        'xml-link               CDATA           #FIXED "simple"

        href                    CDATA           #IMPLIED

        show                    CDATA           #FIXED "embed"

        actuate                 CDATA           #FIXED "auto"'>

        'xml-link               CDATA           #FIXED "simple"

        href                    CDATA           #REQUIRED

        show                    CDATA           #FIXED "embed"

        actuate                 CDATA           #FIXED "auto"'>

        'xml-link               CDATA           #FIXED "simple"

        xml:attributes          NMTOKENS        #FIXED "href source"

        source                  CDATA           #REQUIRED

        show                    CDATA           #FIXED "embed"

        actuate                 CDATA           #FIXED "auto"'>

        Indicates that the element contains white space

        that the formatter or other application should retain,

        as appropriate to its function. -->

        'xml:space              (default

                                |preserve)      #FIXED "preserve"'>

        Every element has an ID attribute (sometimes required,

        but usually optional) for links, and a Role attribute

        for extending the useful life of the DTD by allowing

        authors to make subclasses for any element. %common.att;

        is for common attributes where the ID is optional, and

        %common-idreq.att; is for common attributes where the

        ID is required. -->

        'id                     ID              #IMPLIED

        role                    NMTOKEN         #IMPLIED'>

        'id                     ID              #REQUIRED

        role                    NMTOKEN         #IMPLIED'>

#1998-03-10: maler: Made spec content model easily customizable.

-->

#1997-09-30: maler: Added inform-div1 to back content.

-->

#1997-09-30: maler: Added inform-div1 declarations.

-->

#1998-03-10: maler: Made header content model easily customizable.

-->

        Draft" -->

#1998-03-10: maler: Made pubdate content model easily customizable.

-->

#1997-09-30: maler: Made affiliation optional.

#1998-03-10: maler: Made email optional.

-->

        %common.att;

        %key.att;>

        email functions as a hypertext reference through this

        required attribute.  Typically the reference would use

        the mailto: scheme. -->

        %common.att;

        %href-req.att;>

        the latter now allows loc.  Use p; statusp will be removed

        eventually. -->

#1997-09-30: maler: Changed from %obj.mix; to %p.mix;.

#1997-12-29: maler: Changed order of %p.mix; and %p.pcd.mix; references.

#1997-12-29: maler: Changed order of %statusobj.mix; and %statusp.pcd.mix;

#                   references.

-->

        p now also allows loc) -->

        Use "normal" to get normal vertical spacing for items;

        use "compact" to get less spacing.  The default is dependent

        on the stylesheet. -->

        %common.att;

        spacing         (normal|compact)        #IMPLIED>

        Use "normal" to get normal vertical spacing for items;

        use "compact" to get less spacing.  The default is dependent

        on the stylesheet. -->

        %common.att;

        spacing         (normal|compact)        #IMPLIED>

        bibl optionally functions as a hypertext reference to the

        referred-to resource through this attribute. -->

        %common.att;

        %href.att;

        %key.att;>

#1997-09-30: maler: Added optional affiliation.

-->

        wfcnote must have an ID so that it can be pointed to

        from a wfc element in a production. -->

        %common-idreq.att;>

        vcnote must have an ID so that it can be pointed to

        from a vc element in a production. -->

        %common-idreq.att;>

#1998-03-23: maler: Added xml:space attribute.

-->

        %common.att;

        %xmlspace.att;>

        The graphic data must reside at the location pointed to.

        This is a hypertext reference, but for practical purposes,

        for now it should just be a pathname. -->

        %common.att;

        %source-req.att;

        alt             CDATA           #IMPLIED>

#1997-11-28: maler: Added prodgroup to scrap and defined it.

-->

        The scrap can link to a description of the language used,

        found in a language element in the header. -->

        %common.att;

        lang            IDREF           #IMPLIED>

        Presentational attributes to control the width

        of the "pseudo-table" columns used to output

        groups of productions. -->

        %common.att;

        pcw1            CDATA           #IMPLIED

        pcw2            CDATA           #IMPLIED

        pcw3            CDATA           #IMPLIED

        pcw4            CDATA           #IMPLIED

        pcw5            CDATA           #IMPLIED

>

        The production must have an ID so that cross-references

        (specref) and mentions of nonterminals (nt) can link to

        it. -->

        %common-idreq.att;>

#1997-11-28: maler: Added loc and bibref to com content.

-->

        Each well formedness tagline in a production must link to the

        wfcnote that defines it. -->

        %def-req.att;

        %common.att;>

        Each validity tagline in a production must link to the vcnote

        that defines it. -->

        %def-req.att;

        %common.att;>

#1998-03-23: maler: Added xml:space attribute.

-->

        %common.att;

        %xmlspace.att;>

#1997-10-16: maler: Added table mechanism.

#1997-11-28: maler: Added non-null system ID to entity declaration.

#                   Added HTML table module.

#1997-12-29: maler: IGNOREd SGML Open table model.

#1998-03-10: maler: Removed SGML Open table model.

#                   Merged html-tbl.mod file into main file.

#                   Added %common.att; to all HTML table elements.

-->

        Alignment attributes.  No default. -->

        "align          (left

                        |center

                        |right)         #IMPLIED

        valign          (top

                        |middle

                        |bottom)        #IMPLIED">

          border        CDATA           "0"

          cellpadding   CDATA           "0"

          align         (left

                        |center

                        |right)         "left">

        %common.att;

        %trtd.att;>

        %common.att;

        %trtd.att;

        bgcolor         CDATA           #IMPLIED

        rowspan         CDATA           "1"

        colspan         CDATA           "1">

        A bibliography reference must link to the bibl element that

        describes the resource. -->

        %common.att;

        %ref-req.att;>

#1998-03-10: maler: Declared ednote and related elements.

-->

        The purpose of a loc element is to function as a hypertext

        link to a resource.  (Ideally, the content of loc will also

        mention the URI of the resource, so that readers of the

        printed version will be able to locate the resource.) -->

        %common.att;

        %href-req.att;>

        The nonterminal must link to the production that defines

        it. -->

        %common.att;

        %def-req.att;>

#1998-03-10: maler: Declared quote.

-->

        div, "n" for numbered item, or "[n]" for production -->

        The purpose of a specref element is to link to a div, item

        in an olist, or production in the current spec. -->

        %common.att;

        %ref-req.att;>

        A term definition must have an ID so that it can be linked

        to from termref elements. -->

        The canonical form of the term or phrase being defined must

        appear in this attribute, even if the term or phrase also

        appears in the element content in identical form (e.g., in

        the term element). -->

        %common-idreq.att;

        term            CDATA           #REQUIRED>

        A term reference must link to the termdef element that

        defines the term. -->

        %common.att;

        %def-req.att;>

        A title reference can optionally function as a hypertext

        link to the resource with this title. -->

        %common.att;

        %href.att;>

        The nonterminal must hyperlink to a resource that serves

        to define it (e.g., a production in a related XML

        specification). -->

        %common.att;

        %href-req.att;>

#1997-12-29: maler: Declared xspecref.

-->

        The spec reference must hyperlink to the resource to

        cross-refer to (e.g., a section in a related XML

        specification). -->

        %common.att;

        %href-req.att;>

        The term reference must hyperlink to the resource that

        serves to define the term (e.g., a term definition in

        a related XML specification). -->

        %common.att;

        %href-req.att;>

#1997-09-30: maler: Added unusued elements.

#1997-10-14: maler: Fixed div to move nested div to the mixture.

-->

        referenced.  Declaring them allows them to be pasted from

        an HTML document into a document using this DTD in ADEPT.

        The ATD Context Transformation mechanism will try to convert

        them to the appropriate element for this DTD.  While this

        conversion will not work for all fragments, it does allow

        many cases to work reasonably well. -->