
====================================================================
     Patch 1 for GJXDM Release versions 3.0, 3.0.2, and 3.0.3
====================================================================

November 1, 2005

The GJXDM uses Uniform Crime Reporting (UCR) code values for some
elements.  Recently, it was discovered that some of the codes are
labeled with the wrong literals in GJXDM Releases 3.0, 3.0.2, and
3.0.3.  This patch provides an updated schema for the UCR code values
that corrects the error.  This patch changes documentation only and 
does not change XML type or element definitions.

====================================================================

This patch distribution includes the following files:

    README.txt    This instruction file

    ucr-v2.xsd    An update to the original ucr.xsd that corrects the
                  UCR code literals and sets the "version" attribute
                  of the schema element to the value "2".

    diff.txt      Differences between original ucr.xsd and ucr-v2.xsd  

The GJXDM uses Uniform Crime Reporting (UCR) code values for some
elements.  To do this it imports, through a proxy schema, the schema
file "ucr.xsd".  This schema file contains the UCR code values, each
documented with its associated literal.  Recently, it was discovered 
that some of the codes are labeled with the wrong literals in GJXDM 
Releases 3.0, 3.0.2, and 3.0.3.  This does not impact validation,
however it does confuse the semantics of the codes and is therefore, 
inaccurate.  

This distribution contains the file necessary for users to update the
UCR code values, and to correct these errors for all versions, without
requiring a move to a new version of the GJXDM.

Users may use either of two methods to patch the GJXDM:

Method A:

  (1) Rename ucr-v2.xsd to name of the original file ucr.xsd.

  (2) Replace or overwrite jxdm/ucr/1.0/ucr.xsd (the original UCR
      schema) with the new schema that you just renamed.

Method B: 

  Users who dynamically update their schema locations may put the new
  schema into the same directory as the old schema, and use the schema
  location setting to indicate the new (ucr-v2.xsd) schema.

      jxdm/ucr/1.0/ucr.xsd
      jxdm/ucr/1.0/ucr-v2.xsd

Additional notes:

The version 2 schema uses the same namespace as the original schema,
but sets the "version" attribute of the schema element to the value "2".

Included with this distribution is a diff file (diff.txt), that
indicates the exact differences between ucr.xsd (the old file) and
ucr-v2.xsd (new file).

DO NOT confuse jxdm/ucr/1.0/ucr.xsd with its corresponding proxy schema.  
The UCR proxy schema is proxy/ucr/1.0/ucr.xsd.  DO NOT modify or replace 
the proxy schema.

Please email jxdm@gtri.gatech.edu with any questions or concerns. 
