From c0a2dcce89b1f374fc1987753dd28c6541bbbfe5 Mon Sep 17 00:00:00 2001 From: jsdelfino Date: Mon, 16 Nov 2009 06:27:11 +0000 Subject: Cleaning up SVN structure, moving branch under sdo-cpp/branches. git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@880614 13f79535-47bb-0310-9956-ffa450edef68 --- .../sdo-cpp-pre2.1/doc/BuildingSTDCXX.html | 145 +++++++++++++++++++++ 1 file changed, 145 insertions(+) create mode 100644 sdo-cpp/branches/sdo-cpp-pre2.1/doc/BuildingSTDCXX.html (limited to 'sdo-cpp/branches/sdo-cpp-pre2.1/doc/BuildingSTDCXX.html') diff --git a/sdo-cpp/branches/sdo-cpp-pre2.1/doc/BuildingSTDCXX.html b/sdo-cpp/branches/sdo-cpp-pre2.1/doc/BuildingSTDCXX.html new file mode 100644 index 0000000000..6ffc018157 --- /dev/null +++ b/sdo-cpp/branches/sdo-cpp-pre2.1/doc/BuildingSTDCXX.html @@ -0,0 +1,145 @@ + + + + + + + + + + + Tuscany SDO C++ - Building STDCXX for Tuscany SDO + + + +
+
+
+

Tuscany SDO C++ - Building STDCXX for Tuscany SDO

+ +

STDCXX is an implementation of the C++ Standard Library provided by Apache. +

+

The website is at http://incubator.apache.org/stdcxx/. +

+

At the time of writing, the current release is 4.1.3 and is available as + source distribution only. This document explains how to build stdcxx for + Windows XP and Red Hat Enterprise Linux 3 in the way required by the SDO build + process. +

+
+
+

Contents

+
    +
  1. Building STDCXX.. +
    2. +
+
+ +
+

Building STDCXX

 +

Building STDCXX on Linux

 + +
    +
  1. The release is distributed as a gzipped tar file, called + stdcxx-incubating-4.1.3.tar.gz. Extract the contents of this file into a + convenient directory. For this example, let's assume it is + /home/Tuscany/stdcxx-4.1.3 +
    2. +
  2. Define the STDCXX_HOME environment variable to refer to this directory. The + Tuscany SDO build system uses this environment variable to locate stdcxx. +
    3. +
  3. Change directory to STDCXX_HOME. Then build a debug version of the stdcxx + library using the following command: + 
    gmake BUILDDIR=$STDCXX_HOME/Debug BUILDTYPE=15d CONFIG=gcc.config
    + This will create a sub-directory of STDCXX_HOME called Debug and place the + build products below that. +
    4. +
  4. For a release version the command is: + 
    gmake BUILDDIR=$STDCXX_HOME/Release BUILDTYPE=12d CONFIG=gcc.config
    +
    5. +
+

This provides Tuscany SDO with the versions of stdcxx that it needs for both + Release and Debug builds. +

+

Building STDCXX on Windows

 +

STDCXX is supported only when used with Microsoft Visual Studio C++ V7.1 +

+
    +
  1. The release is distributed as a gzipped tar file, called stdcxx-incubating-4.1.3.tar.gz. + Extract the contents of this file into a convenient directory. For this example let's + assume it is C:\Tuscany\stdcxx-4.1.3 +
    2. +
  2. Define the STDCXX_HOME environment variable to refer to this directory. The + Tuscany SDO build system uses this environment variable to locate stdcxx. +
    3. +
  3. Create two directories to contain the results of building stdcxx. The first is + for the debug enabled version and must be: + 
    <STDCXX_HOME>\Debug
    +
    4. +
  4. The second is for the release (ie optimised) version and must be + 
    <STDCXX_HOME>\Release
    +
    5. +
  5. Launch an MSVC++ 7.1 command window. In the command window, set the default + directory to <STDCXX_HOME> where there is a file called generate.bat. Create + the project definitions that MSVC++ 7.1 will need in order to build stdcxx by + running generate.bat using the following command: + 
    .\generate.bat /BUILDDIR:<STDCXX_HOME>\Debug /CONFIG:VC71
    + It is necessary to provide the full, absolute path to the build directory - it + is not sufficient to provide a relative path. (This restriction will be fixed + in a future release.) +
    6. +
  6. Repeat this operation for the release build, via the command: + 
    .\generate.bat /BUILDDIR:<STDCXX_HOME>\Release /CONFIG:VC71
    +
    7. +
  7. Still using the MSVC++ 7.1 command window, set the default directory to one of + the two build directories eg + 
    cd <STDCXX_HOME>\Debug
    +
    8. +
  8. Then launch the developer studio via + 
    cd <STDCXX_HOME>\Debug
    +
    9. +
  9. Select the configuration to build. For the Debug version of SDO this will be + "15d Debug Thread-safe Dll". Then select "Build Solution". The build will take + a while to complete and runs a test suite when it is finished. The test suite + is extensive and produces a scattering of errors, however the library build + itself is fine. +
    10. +
  10. Repeat this process for the release version, setting the default directory to + 
    cd <STDCXX_HOME>\Release
    + and choosing "12d Optimized Thread-safe Dll" as the build configuration. +
    11. +
+

This provides Tuscany SDO with the versions of stdcxx that it needs for both + Release and Debug builds. +

+
+
+
+ + + + -- cgit v1.2.3