This directory contains precompiled binaries of XSD, a W3C XML Schema
to C++ Data Binding compiler, built for Microsoft Windows. For more
information about XSD visit http://www.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) and
Microsoft Visual C++ 8 (Visual Studio 2005).


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/.
You can also download precompiled Xerces-C++ libraries 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".

     After that, in the "Show directories for" field, select "Executable
     files" and create a new entry with the value "C:\projects\xsd-x.y.z\bin".
     Make sure it is the first line in the list of directories (use the
     "Up" button to move the new entry up, if necessary).


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 the solution file
found in the examples/cxx/tree and examples/cxx/parser directories.

Some of the examples depend on additional third-party libraries or
show a specific feature of XSD and are not included in the solutions
above. They come with their individual solution files:

examples/cxx/tree/custom           - examples of type customization
examples/cxx/tree/binary           - depends on the ACE library
examples/cxx/tree/dbxml            - depends on the Berkeley DB XML library
examples/cxx/tree/custom/calendar  - depends on the Boost date_time library
