Class: DocumentType (in XML)

• Inheritance
• Description
• Class protocol
  • class initialization
  • instance creation
• Instance protocol
  • accessing
  • encoding
  • initialization
  • private

Inheritance:

   Object
   |
   +--XML::DocumentType

Package:

stx:goodies/xml/vw

Category:

XML-VW-Parsing

Version:

rev: 1.23 date: 2019/07/18 18:55:48

user: cg

file: DocumentType.st directory: goodies/xml/vw

module: stx stc-classLibrary: vw

Description:

This class represents an XML document type definition or DTD. The document type declaration can point to an external subset containing markup declarations, or can contain the markup declarations directly in an internal subset, or can do both. The DTD for a document consists of both subsets taken together.

Instance Variables:
	attributeDefs   <Dictionary>
	elementDefs     <Dictionary>
	generalEntities <Dictionary>
	parameterEntities       <Dictionary>
	notations       <Dictionary>

Class protocol:

 initialize

XML::DocumentType initialize

 new

Instance protocol:

 attributeFor: key subKey: k2

 attributeFor: key subKey: k2 put: value

same as parameter entities, first definition counts, do not warn because modern dtds do this
all the time

 attributesFor: key

 declaredRoot

 declaredRoot: something

 elementDefinitions

 elementFor: key

 elementFor: key put: value

 generalEntityAt: key

We do some tricks to make sure that, if the value
is predefined in the parser, we use the predefined
value. We could just store the predefined values
in with the general ones, but we don't want to show
warnings if the user (very correctly) defines them.
An enhancement would be to let the user use his own
values rather than the predefined ones, but we know
that the predefined ones will be correct--we don't know
that his will be.

 generalEntityAt: key put: value

 generalEntityAt: key put: value from: anErrorReporter

 notationAt: name

 notationAt: name ifAbsent: aBlock

 notationAt: name put: notation

 parameterEntityAt: key

 parameterEntityAt: key put: value

gj: against all expectations, in a dtd, it's the first definition of a name that counts.
raising a warning might be argued for, though

 acceptVisitor: aCoder with: aParameter

 initialize

 completeValidationAgainst: aParser

 warn: aString

Modified to unify warnings for SAX. REW