This directory contains precompiled binaries of xsd, a W3C XML Schema
definition compiler, built for Microsoft Windows. For more information
about xsd visit http://codesynthesis.com/products/xsd/. This README file
describes how to start using xsd in the Microsoft Windows environment
with Microsoft Visual C++ 7.1 (.NET 2003).


Prerequisites
-------------

The xsd runtime library and the generated code depend on the Xerces-C++ XML
parser which you can obtain from http://xml.apache.org/xerces-c/. Note that
it is important to compile Xerces-C++ with RTTI enabled while the default
project files that come with the Xerces-C++ source distribution have RTTI
turned off. You can also download precompiled Xerces-C++ libraries with RTTI
enabled from http://codesynthesis.com/download/xerces-c/.


Environment
-----------

Before you can start building examples or your applications that use xsd
you need to set include, library and executable search paths in the Visual
C++ IDE and the System Environment.

1. Setting up Xerces-C++

  First you need to set up Xerces-C++ include and library search paths.
  If you already have Xerces-C++ set up in your development environment,
  you can skip to the next step. Here we assume that your Xerces-C++ path
  is C:\projects\xerces-c-x.y.z. If you have Xerces-C++ in a different
  place you will need to adjust the paths below accordingly.


  a) In the Visual C++ IDE, select "Tools"/"Options"/"Projects"/"VC++
     Directories".

     Then, in the "Show directories for" field, select "Include files" and
     create a new entry with the value "C:\projects\xerces-c-x.y.z\include".

     After that, in the "Show directories for" field, select "Library files"
     and create a new entry with the value "C:\projects\xerces-c-x.y.z\lib".


  b) In the Control Panel, choose "System" and select the "Advanced" tab.
     Click on the "Environment Variables" button. In the "System Variables"
     list, select "Path" and add (via "Edit" button) the
     ";C:\projects\xerces-c-x.y.z\lib" path at the end.


2. Setting up xsd

  Now you need to set up xsd executable and include search paths. Here
  we assume that your xsd path is C:\projects\xsd-x.y.z. If you have xsd
  in a different place you will need to adjust the paths below accordingly.


  a) In the Visual C++ IDE, select "Tools"/"Options"/"Projects"/"VC++
     Directories".

     Then, in the "Show directories for" field, select "Include files" and
     create a new entry with the value "C:\projects\xsd-x.y.z\libxsd".

  b) In the Control Panel, choose "System" and select the "Advanced" tab.
     Click on the "Environment Variables" button. In the "System Variables"
     list, select "Path" and add (via the "Edit" button) the
     ";C:\projects\xsd-x.y.z\bin" path at the end.

3. Restart the Visual C++ IDE. This is necessary for the new value of the
   "Path" environment variable to take effect.


Building Examples
-----------------

Now you are ready to build examples. Simply open one of the solution files
found in the examples/ directory.
