This file contains a brief description of the API for the supplied XML tools.  For a collection of
code snippets, see file .\goodies\XmlBasicTools\readme\XmlBasicTools.wks

Smalltalk class generation
--------------------------------------------

AbxXmlAbstractClassGenerator (abstract class)
Settings:
classPrefix -  a string that is used as the prefix for generated classes.
ie) 'XXX' would result in classes of the form 'XXXSample'

classSuffix - a string that is used as the suffix for generated classes.
ie) 'TestClass' would result in classes of the form 'SampleTestClass'

logger - an object that performs logging during class generation.  The logger
must understand the #log: message.

mappingSpec - mappings that determine the names of generated classes.

Class methods:
createClassesFrom:in:
createClassesFrom:in:classPrefix:classSuffix:

Instance methods:
createClassesFrom:in:

AbxXmlSchemaToClass (superclass = AbxXmlAbstractClassGenerator)
Parses an XML schema and generates Smalltalk classes based upon the schema content.

Instance methods:
createClassesFrom:in:

AbxXmlDtdToClass ( superclass = AbxXmlAbstractClassGenerator)
Parses an XML DTD and generates Smalltalk classes based upon the DTD content.

Instance methods:
createClassesFrom:in:

AbxXmlAbstractFileGenerator (abstract class)
Class settings:
generationComment - a generic comment printed by some subclasses in the generated output

uriQualifier - subclasses that must derive a target namespace for output use the 'uriQualifier' to 
construct the target namespace string.


Mapping file generation
---------------------------------------
AbxXmlMappingFileGenerator (abstract class)
Common logic for constructing VAST mapping specifications from other resources.

classPrefix - a String prefix for mapped classes.  For example, most VAST classes have the prefix
'Abt'.

classSuffix - a String suffix for mapped classes.  The suffix is appended to an XML element name
to form the mapped class name.  

defaultAttribute - the name of the Smalltalk attribute that should be used for all attribute mappings.
All attribute mappings will have the same 'ClassAttribute' setting.

genAttributeMappings - a Boolean attribute which indicates whether attribute mappings should
be created for instance variables.


AbxXmlDtdToMappingFile (superclass=AbxXmlMappingFileGenerator)
Parses a DTD and generates a VAST XML mapping specification containing rules to map XML elements into
Smalltalk classes.

Class API:
createMappingFileNamed:fromDtdFileNamed:classPrefix:classSuffix:defaultAttribute: 

Instance API:
createMappingFileNamed:from:

AbxXmlSchemaToMappingFile (superclass=AbxXmlMappingFileGenerator)
Parses a DTD and generates a VAST XML mapping specification containing rules to map XML elements into
Smalltalk classes.


Class API:
createMappingFileNamed:fromSchemaFileNamed:classPrefix:classSuffix:defaultAttribute: 

Instance API:
createMappingFileNamed:from:


Schema file generation
--------------------------------------
AbxXmlSchemaFileGenerator (abstract)

defaultElementType - an XML schema type that will be be the default element type for generated schema elements.
(default = 'xsd:string')

targetNamespace - the setting for the targetNamespace attribute of the generated schema.  If this value is not specified,
a default is derived from the resource on which the schema is based.


AbxXmlApplicationToSchemaFile
Create an XML schema based upon a Set of classes.  API allows user to provide a single application, a collection of applications,
or acollection of classes as input.

Class API:
createSchemaFileNamed:fromClassesIn:

Instance API:
createSchemaFileNamed:from: 
createSchemaFileNamed:fromClasses: 


AbxXmlDtdToSchemaFile
Create an XML schema based on the definitions from a provided DTD file.

Class API:
createSchemaFileNamed:fromDtdFileNamed:

Instance API:
createSchemaFileNamed:from: 

