From 216fb5473e79f233c5bdc90213ece9011d85ef3f Mon Sep 17 00:00:00 2001 From: Boris Kolpackov Date: Thu, 28 Nov 2013 09:11:35 +0200 Subject: Update README file with new information --- README | 47 +++++++++++++++++------------------------------ 1 file changed, 17 insertions(+), 30 deletions(-) (limited to 'README') diff --git a/README b/README index b7cced1..32c8904 100644 --- a/README +++ b/README @@ -1,22 +1,20 @@ This archive contains pre-configured CodeSynthesis XSD source code -with all its dependencies (except Xerces-C++ and Boost). It allows -you to build the XSD compiler in non-interactive mode (that is, -without answering any configuration questions). +with all its dependencies (except Xerces-C++). It allows you to build +the XSD compiler in non-interactive mode (that is, without answering +any configuration questions). The following GNU tools are required to build XSD. Any fairly recent -GNU/Linux distribution should have these already installed: +GNU/Linux distribution should have all of them already installed: GNU bash >= 2.00 (bash --version) http://www.gnu.org/software/bash/ -GNU m4 >= 1.4 (m4 --version) http://www.gnu.org/software/m4/ GNU make >= 3.81 (make --version) http://www.gnu.org/software/make/ -GNU g++ >= 3.4.3 (g++ --version) http://gcc.gnu.org/ +GNU g++ >= 4.2.0 (g++ --version) http://gcc.gnu.org/ -The build system expects you to have the Xerces-C++ (2.6.0 or later) -as well as Boost filesystem and regex (1.33.1 or later) libraries -built and installed in a location where the C++ compiler looks by -default (normally /usr/lib/ and /usr/local/lib/). Alternatively, you -can provide include (-I) and library (-L) paths for this packages via -the CPPFLAGS and LDFLAGS variables, respectively. +The build system expects you to have the Xerces-C++ library version +3.0.0 or later built and installed in a location where the C++ compiler +will find them by default (normally /usr/lib/ and /usr/local/lib/). +Alternatively, you can provide include (-I) and library (-L) paths +for this library via the CPPFLAGS and LDFLAGS variables, respectively. The build system supports the following variables: @@ -29,24 +27,12 @@ CFLAGS CXXFLAGS LDFLAGS LIBS -BOOST_LIB_SUFFIX -BOOST_LINK_SYSTEM EXTERNAL_LIBCUTL For example: $ make CC=gcc-4.8 CXX=g++-4.8 CFLAGS=-O3 CXXFLAGS=-O3 -j 4 -The BOOST_LIB_SUFFIX variable allows you to specify the optional -Boost library suffix. For example, if your Boost library names are -in the libboost_regex-gcc41-mt-d.so format, then you will need to -set BOOST_LIB_SUFFIX to -gcc41-mt-d. - -The BOOST_LINK_SYSTEM variable allows you to specify whether the -Boost system library should be explicitly linked to which may be -required by newer linkers. The valid values are 'y' (default) and -'n'. - The EXTERNAL_LIBCUTL variable allows you to use an external build of libcutl, for example, if you already have this library installed. The valid values are 'n' (default) and 'y'. @@ -57,9 +43,9 @@ you can add verbose=1 to the make command line: $ make verbose=1 After the build is complete, the XSD compiler can be found in the -xsd/xsd/ directory and the runtime headers in the xsd/libxsd/ directory. -You can install the XSD compiler, runtime library, and documentation -with the install target, for example: +xsd/xsd/ sub-directory and the runtime headers in the xsd/libxsd/ +sub-directory. You can install the XSD compiler, runtime library, +and documentation with the install target, for example: $ make install_prefix=/usr install @@ -85,14 +71,15 @@ You can also create a distribution package with the XSD compiler binary, source code for the runtime library and examples, as well as the documentation using the dist and dist-win targets, for example: -$ make dist_prefix=./xsd-x.y.z dist +$ make dist_prefix=/tmp/xsd-x.y.z dist Or, for Windows: -$ make dist_prefix=./xsd-x.y.z dist-win +$ make dist_prefix=/tmp/xsd-x.y.z dist-win -The build system also supports the clean target: +The build system also supports the test and clean targets, for example: +$ make test $ make clean Send bug reports or any other feedback to the xsd-users@codesynthesis.com -- cgit v1.1