[xmlvoc-comment] Cover: SGML Declaration, ASCII listing

[Patrick Durusau <pdurusau@emory.edu>]

Holger,

I don't know if the following suggestion should be a working document, 
report, etc. (i.e., probably not actually part of the standard but I 
don't have the right term for it) but I have attached a text document 
that illustrates two problems when beginning with an extant index of 
resources:

1. Level of detail from a standard to be in the initial topic list

2.  Representation of extant indexing categories that combine topics 
from #1 (obvious mechanisms, question is should? and how best?)

What I am wondering is if the TC should produce a document that 
represents the "how" to construct an ontology from a standard, based on 
our experiences with the core XML standards and technologies? (See 
initial response to the requirements on the "core" question.)

Apologies for having to take Holger up on his suggestion of a readable 
but simple ASCII listing. Last minute debates on the bible encoding 
schema consumed most of my cycles. Should have a substantial amount of 
time to devote to this activity after my return from Rome (22-30 April) 
but prior to the meeting at XML Europe (including, hopefully, a more 
formal set of examples from the Cover pages, in XTM. Steve, has Lars 
Marius written an XTM mode for Emacs yet? ;-) ).

Patrick

-- 
Patrick Durusau
Director of Research and Development
Society of Biblical Literature
pdurusau@emory.edu


SGML Declaration Topics as derived from Cover Pages: http://xml.coverpages.org/topics.html#SGMLDecl (reproduced below for reference)

topic (superclass): ISO_8879

variant name: SGML

topic (subclass, of ISO_8879): Clause 13

variant name: SGML Declaration

topic (subclass, of ISO_8879_13): General

      occurrence: An extremely useful (and free!) booklet explaining the SGML declaration is available from OmniMark
      occurrence: Wayne L. Wohler contributed a three-part serialized article on the SGML declaration
      occurrence: Creating a DTD and an SGML Declaration

topic (subclass, of ISO_8879_13): Examples

topic (subclass, of ISO_8879_13_Examples): Default declaration

      occurrence: A copy of the full SGML declaration is available from the SGML Repository
      occurrence: A Template of the SGML Declaration
      occurrence: Default SGML declaration, and handling of the SGML declaration in [James Clark's] SP" version 1.1.2
      occurrence: NSGMLS 1.1.1 SGML Declaration (implemented by James Clark);
      occurrence: SGML Declaration for Basic SGML
      
topic (subclass, of ISO_8879_13_Examples): Non-default declaration
      
      occurrence: SGML Declaration using ERCS, from Rick Jelliffe
      occurrence:  AECMA 1000D Change 7 Document Type Definition - SGML Declaration

topic (subclass, of ISO_8879_13_Examples): Applications

topic (subclass, of ISO_8879_13_Examples_Applications_SP): Specific topic for SP SGML Declaration

      occurrence: Default SGML declaration, and handling of the SGML declaration in [James Clark's] SP" version 1.1.2

topic (subclass, of ISO_8879_13): Document Character Set

      occurrence: Document Character Sets by Example
      occurrence: TEI SGML declaration, full ASCII character set
      occurrence: TEI SGML declaration for local processing with SGMLS, EBCDIC CHARSET
      occurrence: SGML decl for Japanese, from SP 1.1.2

topic (subclass of ISO_8879) 1996 Corrigendum

topic (subclass of ISO_8879_1996_Corrigendum) Extended Naming Rules

topic (subclass of ISO_8879_1996_Corrigendum_Extended_Naming_Rules): Examples

      occurrence: Default SGML declaration, and handling of the SGML declaration in [James Clark's] SP" version 1.1.2
      occurrence: Comparison of SGML and XML

topic (subclass of ISO_8879) Annex K (Web SGML Adaptations)

topic (subclass of ISO_8879_Annex_K): Examples

      occurrence: Comparison of SGML and XML


Versus a hypothetical set of topics working from ISO 8879, Clause 13:

(N.B. Topics preceded by "**" do not appear under SGML Declaration in Cover, most do appear elsewhere but that is the question of how to organize the ontology and the role of common usage in determining variants for listings) 

topic (superclass): ISO_8879

variant name: SGML

topic (subclass, of ISO_8879): Clause 13

variant name: SGML Declaration

topic (subclass, of ISO_8879_13): General

topic (subclass, of ISO_8879_13): Examples

topic (subclass, of ISO_8879_13_Examples): Default declaration

topic (subclass, of ISO_8879_13_Examples): Non-default declaration

topic (subclass, of ISO_8879_13_Examples): Applications

topic (subclass, of ISO_8879_13_Examples_Applications_SP): Specific topic for SP SGML Declaration

**topic (subclass of ISO_8879_13): Minimum Literal 

topic (subclass, of ISO_8879_13): Document Character Set

**topic (subclass of ISO_8879_13): Capacity Set

**topic (subclass of ISO_8879_13): Concrete Syntax Scope

**topic (subclass of ISO_8879_13): Concrete Syntax

**topic (subclass of ISO_8879_13_Concrete_Syntax): Shunned Character Number Identification

**topic (subclass of ISO_8879_13_Concrete_Syntax): Syntax-reference Character Set

**topic (subclass of ISO_8879_13_Concrete_Syntax): Function Character Identification

**topic (subclass of ISO_8879_13_Concrete_Syntax): Naming Rules

**topic (subclass of ISO_8879_13_Concrete_Syntax): Delimiter Set

**topic (subclass of ISO_8879_13_Concrete_Syntax): Reserved Name Use

**topic (subclass of ISO_8879_13_Concrete_Syntax): Quantity Set

**topic (subclass of ISO_8879_13): Feature Use

**topic (subclass of ISO_8879_13)_Feature_Use): Markup Minimization Features

**topic (subclass of ISO_8879_13)_Feature_Use_Markup_Minimization_Features): Datatag

**topic (subclass of ISO_8879_13)_Feature_Use_Markup_Minimization_Features): Omittag

**topic (subclass of ISO_8879_13)_Feature_Use_Markup_Minimization_Features): Rank

**topic (subclass of ISO_8879_13)_Feature_Use_Markup_Minimization_Features): Shorttag

**topic (subclass of ISO_8879_13)_Feature_Use): Link Type

**topic (subclass of ISO_8879_13)_Feature_Use_Link_Type): Explicit

**topic (subclass of ISO_8879_13)_Feature_Use_Link_Type): Implicit

**topic (subclass of ISO_8879_13)_Feature_Use_Link_Type): Simple

**topic (subclass of ISO_8879_13)_Feature_Use): Other Features

**topic (subclass of ISO_8879_13)_Feature_Use_Other_Features): Concur

**topic (subclass of ISO_8879_13)_Feature_Use_Other_Features): Subdoc

**topic (subclass of ISO_8879_13)_Feature_Use_Other_Features): Formal

Application-specific Information

topic (subclass of ISO_8879) 1996 Corrigendum

topic (subclass of ISO_8879_1996_Corrigendum) Extended Naming Rules

topic (subclass of ISO_8879_1996_Corrigendum_Extended_Naming_Rules): Examples

topic (subclass of ISO_8879) Annex K (Web SGML Adaptations)

topic (subclass of ISO_8879_Annex_K): Examples


***Cover material used as source for topics***

SGML Declaration

[CR: 19990622]

The SGML declaration establishes the "lexical" basis for an SGML document, including the character sets, markup delimiters, features, and other options. It governs both the DTD (document type definition) and the document instance. A few pointers to resources follow.

    * A copy of the full SGML declaration is available from the SGML Repository , contributed by Erik Naggum. It supplies the default values assumed by an SGML parser, thus clarifying what features and parameters are governed by the SGML declaration. [local archive copy]
    * "A Template of the SGML Declaration", from OmniMark Technologies; see immediately below; [mirror copy, text only]
    * An extremely useful (and free!) booklet explaining the SGML declaration is available from OmniMark [formerly Exoterica] Corporation. Title: Understanding the SGML Declaration. The document is available online in HTML format from the OmniMark WWW server: Understanding The SGML Declaration. It has several useful annexes. See also the main bibliography for details. To obtain a copy, send an email request with postal address to info@omnimark.com.info.
    * Wayne L. Wohler contributed a three-part serialized article on the SGML declaration in <TAG>'s occasional tutorial series. The tutorial explains the purpose and use of each part of the SGML declaration. The full text of this tutorial is available online. See also the bibliography entries for Part 1, Part 2, and Part 3.
    * "Document Character Sets by Example," by Tony Graham, Consultant, Mulberry Technologies, Inc. From the SGML '96 presentation. Available online in HTML format. The bibliographic entry for the presentation supplies abstract and other details.
    * "Default SGML declaration, and handling of the SGML declaration in [James Clark's] SP" version 1.1.2 (February 1997), including Extended Naming Rules as specified in Annex J of ISO 8879:1986 (added by the 1996 technical corrigendum.
    * [*See also preceding item] NSGMLS 1.1.1 SGML Declaration (implemented by James Clark); see the SP database entry
    * SGML decl for Japanese, from SP 1.1.2; viz., an SGML declaration with "a character set declaration is suitable for use with the ujis or sjis coding systems"
    * The document "Comparison of SGML and XML" by James Clark provides an SGML Declaration for XML. This SGML Declaration for XML is in two variants: (a) one which "takes advantage of the Extended Naming Rules Technical Corrigendum to ISO 8879, but does not make use of the Web SGML Adaptations Annex"; (b) one which "takes advantage of the Web SGML Adaptations Annex to ISO 8879".
    * [Now obsolete; see the preceding item.] SGML Declaration for XML [valid as of about April 2, 1997], from James Clark's SP 1.1.3
    * SGML Declaration for Basic SGML, posted by Paul Grosso (i.e., from Clause 15)
    * TEI SGML declaration, full ASCII character set
    * AECMA 1000D Change 7 Document Type Definition - SGML Declaration [local archive copy]
    * TEI SGML declaration for local processing with SGMLS, EBCDIC CHARSET Code Page 1047
    * Example SGML Declaration, for EBCDIC (Wayne Wohler, HTML), or: text version
    * SGML Declaration using ERCS, from Rick Jelliffe (ricko@allette.com.au); see now http://www.allette.com.au/sgml/ercs/simple.html
    * Creating a DTD and an SGML Declaration [IBM Publishing Systems. SGML Translator: Creating a DTD and an SGML Declaration. Document Number SC34-5075-01, Release 3] A tutorial resource for creating DTDs and SGML declarations.

***End of Cover material***

Patrick Durusau, 2002-04-15, pdurusau@emory.edu