From bada6666c70977a058755ccf232e7d67b24adeed Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B6rg=20Frings-F=C3=BCrst?= Date: Wed, 23 Jul 2014 15:21:29 +0200 Subject: New upstream release --- README | 62 ++++++++++++++++++++++++++++---------------------------------- 1 file changed, 28 insertions(+), 34 deletions(-) (limited to 'README') diff --git a/README b/README index 8f2d04a..32c8904 100644 --- a/README +++ b/README @@ -1,58 +1,51 @@ -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). +This archive contains pre-configured CodeSynthesis XSD source code +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: +The following GNU tools are required to build XSD. Any fairly recent +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: +CC (defaults to gcc if not set) CXX (defaults to g++ if not set) AR (defaults to ar if not set) RANLIB (defaults to ranlib if not set) CPPFLAGS +CFLAGS CXXFLAGS -LDFALGS +LDFLAGS LIBS -BOOST_LIB_SUFFIX -BOOST_LINK_SYSTEM +EXTERNAL_LIBCUTL For example: -$ make CXX=g++-4.2 CXXFLAGS=-O3 -j 4 +$ 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'. If you would like to see the full compiler/linker/etc., command lines, 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: +After the build is complete, the XSD compiler can be found in the +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 @@ -78,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.2.3