summaryrefslogtreecommitdiff
path: root/dist/README-WINDOWS
diff options
context:
space:
mode:
authorBoris Kolpackov <boris@codesynthesis.com>2009-09-22 14:40:53 +0200
committerBoris Kolpackov <boris@codesynthesis.com>2009-09-22 14:40:53 +0200
commit3c853bc264719437bcb2807d75ff5e9f9a3ea4f8 (patch)
treee9405b1078b0ed8a7be6c296d1a50653c1785b89 /dist/README-WINDOWS
parent8564df32f304589dfdffe46140a75f6e5d44523c (diff)
Add distribution-specific files, dist and dist-win targets
Diffstat (limited to 'dist/README-WINDOWS')
-rw-r--r--dist/README-WINDOWS105
1 files changed, 105 insertions, 0 deletions
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
+
+