From 3c853bc264719437bcb2807d75ff5e9f9a3ea4f8 Mon Sep 17 00:00:00 2001 From: Boris Kolpackov Date: Tue, 22 Sep 2009 14:40:53 +0200 Subject: Add distribution-specific files, dist and dist-win targets --- dist/README-WINDOWS | 105 ++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 105 insertions(+) create mode 100644 dist/README-WINDOWS (limited to 'dist/README-WINDOWS') diff --git a/dist/README-WINDOWS b/dist/README-WINDOWS new file mode 100644 index 0000000..fbc938c --- /dev/null +++ b/dist/README-WINDOWS @@ -0,0 +1,105 @@ +This package contains precompiled binaries of CodeSynthesis 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), +Microsoft Visual C++ 8 (Visual Studio 2005), and Microsoft Visual +C++ 9 (Visual Studio 2008). + + +Prerequisites +------------- + +The XSD runtime library and the generated code depend on the Xerces-C++ +XML parser which you can obtain from http://xerces.apache.org/xerces-c/. +You can also download precompiled Xerces-C++ libraries for Windows from +http://xerces.apache.org/xerces-c/download.cgi + + +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\bin" 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/custom/calendar - depends on the Boost date_time library +examples/cxx/tree/binary/boost - depends on the Boost serialization library +examples/cxx/tree/binary/cdr - depends on the ACE library +examples/cxx/tree/binary/xdr - requires a third-party XDR library +examples/cxx/tree/xpath - depends on the XQilla library (XPath 2) +examples/cxx/tree/dbxml - depends on the Berkeley DB XML library + + +Using in Your Projects +---------------------- + +For various ways to integrate the XSD compiler with the Microsoft Visual +Studio IDE as well as other Visual Studio-specific topics, refer to the +Using XSD with Microsoft Visual Studio Wiki page: + +http://wiki.codesynthesis.com/Using_XSD_with_Microsoft_Visual_Studio + + -- cgit v1.1