Rosetta Usage Guide Updates

The following reflects updates to the usage guide associated with the
current release.  Chapters are indicated followed by changes within
the chapter and a list of known To Do items.  Change bars are included
in the document to reflect where changes occur in the text.  There is
not a one-to-one correspondance between notations in this file and
change bars in the text.

When versions are released to the web, content specific to the
distribution should be appened to the CHANGELOG file with a date stamp
for the web release.  There is no need to do this each time a CVS commit
occurs, only for officially released versions.

CVS tags should be generated for each release using the form usageX-Y
where X is the major release and Y is the update number.

Inquiries should be directed to perry.alexander@ieee.org.

------ Information specific to this distribution ------
Items, Variables, Values and Types

Tue Jun 12 23:30:49 EDT 2001 -- wpa
Removed change bars for start of next version.

Wed Jun 13 21:11:02 EDT 2001 -- wpa
Removed tuple types.

Wed Jun 13 21:11:22 EDT 2001 -- wpa
Removed record types in favor of using constructed types for the same
function.

Wed Jun 13 21:11:54 EDT 2001 -- wpa
Removed reference to the universal type and reworked the univ type 
definition.

Thu Jun 14 13:17:40 CDT 2001 -- wpa
Moved the definition of enumerations from the constructed types section
to the element section.  Changed the semantics to reflect introduction of
new value items by the enumeration rather than constructed types.

Sat Jun 16 10:36:41 EDT 2001
Reworked the definition of enumerations to allow inclusion of existing
value items in new enumerations.


Expressions, Terms, Labeling and Facet Inclusion

Known To Do Items:
1. Include discussion on expressions.
2. Redo facet inclusion section to explicitly list three types of inclusion:
   (i) use clause (only packages); (ii) domain (only domains); and (iii) 
   facet inclusion (only facets and components).
3. Structural definition is very weak.


General Updates

Thu Jun 14 10:37:38 EDT 2001 -- dws
Culmination of substantial example clean up for chapters 2-5,
facets.tex, types.tex, labeling.tex and facet-algebra.tex. Almost all
'complete' Rosetta code (single lines all the way up to full packages)
have been corrected--where possbile--and run through the parser. For
rosetta code in the Usage guide that still does not parse, the errors
are being catalogued in a file called UsageGuide_err. This document
contains full declarations of the packages used to test the code as
well as the page(s) from the Usage guide from which the code
comes. Note that UsageGuide_err has not yet been checked in; only the
modified .tex files and this README are currently checked in.


------ End ------