Author: ajborley
Date: Thu Oct 5 08:25:05 2006
New Revision: 453267
URL: http://svn.apache.org/viewvc?view=rev&rev=453267
Log:
Doc updates including building SDO with STDCXX and building STDCXX for SDO
Added:
incubator/tuscany/cpp/sdo/doc/BuildingSTDCXX.html (with props)
Modified:
incubator/tuscany/cpp/sca/GettingStarted.html
incubator/tuscany/cpp/sdo/GettingStarted.html
incubator/tuscany/cpp/sdo/doc/css/maven-theme.css
Modified: incubator/tuscany/cpp/sca/GettingStarted.html
URL:
http://svn.apache.org/viewvc/incubator/tuscany/cpp/sca/GettingStarted.html?view=diff&rev=453267&r1=453266&r2=453267
==============================================================================
--- incubator/tuscany/cpp/sca/GettingStarted.html (original)
+++ incubator/tuscany/cpp/sca/GettingStarted.html Thu Oct 5 08:25:05 2006
@@ -119,11 +119,11 @@
<OL>
<LI>Extract the binary tar package to a folder</LI>
<LI>Set the TUSCANY_SCACPP environment variable to point to the
directory that was just extracted</LI>
- <LI>Add the *install_dir*/lib directory to the LD_LIBRARY_PATH
<!--(Linux) or DYLD_LIBRARY_PATH (MacOS X)--> environment variable</LI>
+ <LI>Add the <tuscany_sca_install_dir>/lib directory to the
LD_LIBRARY_PATH <!--(Linux) or DYLD_LIBRARY_PATH (MacOS X)--> environment
variable</LI>
</OL>
<A NAME="linuxsrc"><H3>Getting Tuscany SCA for C++ working with the
source release on Linux</H3></A>
<OL>
- <LI>Extract the source tar package to a folder
<tuscany_sca></LI>
+ <LI>Extract the source tar package to a folder
<tuscany_sca_install_dir></LI>
<LI>The following environment variables are required:
<UL>
<LI>TUSCANY_SDOCPP=<path to installed Tuscany SDO>
@@ -131,19 +131,21 @@
</UL></LI>
<LI>Build the source with the following command sequence:
<UL>
- <LI>./configure</LI>
+ <LI>./configure
--prefix=<tuscany_sca_install_dir>/deploy</LI>
<LI>make</LI>
<LI>make install</LI>
</UL>
NOTE: If you don't provide a --prefix configure option,
it will by default install into
/usr/local/tuscany/sca</LI>
+ <LI>Set the TUSCANY_SCACPP environment variable to point to the
<tuscany_sca_install_dir>/deploy
+ directory that contains the built Tuscany SCA
distribution</LI>
</OL>
<A NAME="winbin"><H3>Getting Tuscany SCA for C++ working with the
binary release on Windows</H3></A>
<OL>
<LI>Unzip the supplied zip file to a folder</LI>
<LI>Set the TUSCANY_SCACPP environment variable to point to the
directory that was just unzipped</LI>
- <LI>Add the *install_dir*\bin directory to the PATH environment
variable</LI>
+ <LI>Add the <tuscany_sca_install_dir>\bin directory to the
PATH environment variable</LI>
</OL>
<A NAME="winsrc"><H3>Getting Tuscany SCA for C++ working with the
source release on Windows</H3></A>
<OL>
@@ -179,8 +181,8 @@
compiled into a dll) or invoke a binding (e.g. make a Web Services
call).
</P>
<P>The table below details the extensions that are included with
TuscanySCA for C++ Milestone
- Release 2. All these extensions are compiled in the binary releases,
but not all are compiled by default
- when you follow the instructions above for building SCA from a
source release.
+ Release 2. All these extensions are compiled in the binary
releases, but not all are compiled by
+ default when you follow the instructions above for building SCA
from a source release.
</P>
<TABLE CLASS="bodyTable">
<TBODY>
@@ -225,7 +227,18 @@
</TR>
</TBODY>
</TABLE>
- <BR>
+ <P>It is possible to build all the extensions from a Tuscany SCA
source release, but you
+ must ensure that the extension requirements and environment
variables are available on
+ your system (see the <A HREF="doc/PythonExtension.html">Python</A>
and
+ <A HREF="doc/RubyExtension.html">Ruby</A> extension documentation
for this information):
+ </P>
+ <P>On <STRONG>Linux</STRONG> use the --enable-all-extensions
configure option and then follow
+ the rest of the above instructions. e.g:
+ </P>
+ <UL>
+ <LI>./configure --prefix=<tuscany_sca_install_dir>/deploy
--enable-all-extensions</LI>
+ </UL>
+ <BR/>
</DIV>
<DIV CLASS="section">
Modified: incubator/tuscany/cpp/sdo/GettingStarted.html
URL:
http://svn.apache.org/viewvc/incubator/tuscany/cpp/sdo/GettingStarted.html?view=diff&rev=453267&r1=453266&r2=453267
==============================================================================
--- incubator/tuscany/cpp/sdo/GettingStarted.html (original)
+++ incubator/tuscany/cpp/sdo/GettingStarted.html Thu Oct 5 08:25:05 2006
@@ -94,8 +94,11 @@
<TD>
<A HREF="http://xmlsoft.org/downloads.html";
TARGET="_blank">http://xmlsoft.org/downloads.html</A><BR/>
- Most Linux systems have libxml2 by default. On Windows you
need to download and install libxml2 from <A
HREF="http://www.zlatkovic.com/libxml.en.html";
TARGET="_blank">http://www.zlatkovic.com/libxml.en.html</A><BR/>
- Please read the installation notes for libxml2 particularly
regarding it's pre-req's iconv and zlib on Windows. <BR/>
+ Most Linux systems have libxml2 by default. On Windows you
need to download
+ and install libxml2 from
+ <A HREF="http://www.zlatkovic.com/libxml.en.html";
TARGET="_blank">http://www.zlatkovic.com/libxml.en.html</A><BR/>
+ Please read the installation notes for libxml2 particularly
regarding it's
+ pre-req's iconv and zlib on Windows. <BR/>
These libraries will need to be on the PATH in order to run
Tuscany SDO.
</TD>
</TR>
@@ -104,10 +107,12 @@
<TD>
<A HREF="http://incubator.apache.org/stdcxx/";
TARGET="_blank">http://incubator.apache.org/stdcxx/download.html</A><BR/>
- STDCXX is the Apache implementation of the C++ Standard
Library. Tuscany SDO can be built using this library implementation
- rather than the default platform libraries available on your
operating system.<BR/>
- If you wish to use STDCXX please download, install and
follow the instructions below to build SDO with STDCXX.<BR/>
- The STDCXX libraries will then need to be on the PATH in
order to run Tuscany SDO.
+ STDCXX is the Apache implementation of the C++ Standard
Library. Tuscany SDO
+ can be built using this library implementation rather than
the default
+ platform libraries available on your operating system.<BR/>
+ If you wish to use STDCXX please follow
+ <A HREF="doc/BuildingSTDCXX.html">these instructions to
build STDCXX for Tuscany SDO</A>
+ before following the instructions below to build SDO with
STDCXX.<BR/>
</TD>
</TR>
</TBODY>
@@ -147,34 +152,8 @@
<LI>./tuscany_sdo_test</LI>
</UL></LI>
</OL>
- <A NAME="linuxsrcstdcxx"><H3>Getting Tuscany SDO for C++ working with
the source release and Apache STDCXX on Linux</H3></A>
- <OL>
- <LI>Extract the source tar package to a folder
<tuscany_sdo_install_dir></LI>
- <LI>The following environment variables are required:
- <UL>
- <LI>LIBXML2_INCLUDE=<path to libxml2 includes>
- <LI>LIBXML2_LIB=<path to libxml2 lib><BR/>
- Note: If you are using the default installation of libxml2
these are usually:<BR/>
- LIBXML2_LIB=/usr/lib<BR/>
- LIBXML2_INCLUDE=/usr/include/libxml2<BR/></LI>
-
- <LI>AXIS2C_HOME=<path to axis2c version 0.94></LI>
- </UL></LI>
- <LI>Build the source with the following command sequence:
- <UL>
- <LI>./configure</LI>
- <LI>make</LI>
- <LI>make install</LI>
- </UL>
- NOTE: If you don't provide a --prefix configure option,
it will by default install into
- /usr/local/tuscany/sdo</LI>
- <LI>Run the test:
- <UL>
- <LI>cd
<tuscany_sdo_install_dir>/runtime/core/test</LI>
- <LI>./tuscany_sdo_test</LI>
- </UL></LI>
- </OL>
-
+ <A NAME="linuxsrcstdcxx"><H3>Getting Tuscany SDO for C++ working with
the source release and Apache STDCXX on Linux</H3></A>
+
<A NAME="winbin"><H3>Getting Tuscany SDO for C++ working with the
binary release on Windows</H3></A>
<OL>
<LI>Unzip the supplied zip file to a folder
<tuscany_sdo_install_dir></LI>
@@ -203,27 +182,29 @@
<LI>Add the <tuscany_sdo_install_dir>\deploy\bin directory
to the PATH environment variable</LI>
</OL>
<A NAME="winsrcstdcxx"><H3>Getting Tuscany SDO for C++ working with
the source release and Apache STDCXX on Windows</H3></A>
- <OL>
- <LI>Unzip the supplied source zip file to a folder
<tuscany_sdo_install_dir></LI>
- <LI>The following environment variables are required:
- <UL>
- <LI>LIBXML2_HOME=<path to installed libxml2><BR/>
- <LI>AXIS2C_HOME=<path to axis2c version 0.94></LI>
- </UL></LI>
- <LI>You must have set up the environment for Microsoft Visual
C++ tools. The build command
- will call vcvars32 to set the environment. Ensure the
directory containing this is on your path.
- This will be where you installed the compiler.</LI>
- <LI>Build the source:
- <UL>
- <LI>cd <tuscany_sdo_install_dir></LI>
- <LI>build</LI>
- </UL>
- This will build all the projects and put the required
output into the <tuscany_sdo_install_dir>\deploy directory<BR/><BR/>
- Alternatively, open the workspace tuscany_sdo.dsw in Visual
Studio 6 - you can build projects individually
- or build the test project to build all its dependencies.
Running the test project should give a list of
- tests passed - this is currently 108 tests, no failures.</LI>
- <LI>Add the <tuscany_sdo_install_dir>\deploy\bin directory
to the PATH environment variable</LI>
- </OL>
+ <P>STDCXX is an implementation of the C++ Standard Library provided
by Apache.
+ The website is at <A
HREF="http://incubator.apache.org/stdcxx/";>http://incubator.apache.org/stdcxx/</A>.
+ </P>
+ <P>You must begin by downloading and building STDCXX as described <A
HREF="doc/BuildingSTDCXX.html">here</A>
+ </P>
+ <P>STDCXX is supported only when used with Microsoft Visual Studio
C++ V7.1. Launch the
+ MSVC++ 7.1 studio by opening the file
<tuscany_sdo_install_dir>\projectsvc7\tuscany_sdo\tuscany_sdo.sln
+ </P>
+ <P>Both the sdo_runtime and sdo_test projects include build
configurations that
+ use STDCXX. There are several ways to access the build
configurations, and all
+ are equally effective. As an example, open the Property pages for
sdo_test by
+ right clicking on sdo_test in the Solution Explorer pane and
selecting
+ Properties. The Configuration property in the top left corner of
the pane is a
+ drop down box offering four options: Debug, Release, stdcxx-Debug,
+ stdcxx-Release. Choose the one you want and then launch the build.
+ </P>
+ <P>All components that are linked (by the linker) must all use the
same C++
+ Standard library. Therefore, if either sdo_test or sdo_runtime
are built with
+ STDCXX then both must be.
+ </P>
+ <P>Tuscany SCA does not currently offer the option to build with
stdcxx and so it
+ cannot be used with a version of SDO built using stdcxx.
+ </P>
</DIV>
<DIV CLASS="section">
Added: incubator/tuscany/cpp/sdo/doc/BuildingSTDCXX.html
URL:
http://svn.apache.org/viewvc/incubator/tuscany/cpp/sdo/doc/BuildingSTDCXX.html?view=auto&rev=453267
==============================================================================
--- incubator/tuscany/cpp/sdo/doc/BuildingSTDCXX.html (added)
+++ incubator/tuscany/cpp/sdo/doc/BuildingSTDCXX.html Thu Oct 5 08:25:05 2006
@@ -0,0 +1,141 @@
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<!--
+ Copyright 2006 The Apache Software Foundation or its licensors, as
applicable.
+
+ Licensed under the Apache License, Version 2.0 (the "License");
+ you may not use this file except in compliance with the License.
+ You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+ -->
+<HTML>
+<HEAD>
+ <META CONTENT="text/html; charset=iso-8859-1" HTTP-EQUIV="Content-Type">
+ <META CONTENT="text/css" HTTP-EQUIV="Content-Style-Type">
+ <STYLE MEDIA="all" TYPE="text/css">
[EMAIL PROTECTED] url("css/maven-base.css");
[EMAIL PROTECTED] url("css/maven-theme.css");
+ </STYLE>
+
+ <LINK HREF="css/maven-theme.css" MEDIA="print" REL="stylesheet"
+ TYPE="text/css">
+ <TITLE>Tuscany SDO C++ - Building STDCXX for Tuscany SDO</TITLE>
+</HEAD>
+
+<BODY>
+<DIV ID="bodyColumn">
+ <DIV ID="contentBox">
+ <DIV CLASS="section">
+ <H2>Tuscany SDO C++ - Building STDCXX for Tuscany SDO</H2>
+
+ <P>STDCXX is an implementation of the C++ Standard Library provided
by Apache.
+ </P>
+ <P>The website is at <A
href="http://incubator.apache.org/stdcxx/";>http://incubator.apache.org/stdcxx/</A>.
+ </P>
+ <P>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.
+ </P>
+ </DIV>
+ <DIV CLASS="section">
+ <H2>Contents</H2>
+ <OL>
+ <LI><A HREF="#install">Building STDCXX..</A>
+ <UL>
+ <LI><A HREF="#linux">..on Linux</A></LI>
+ <LI><A HREF="#win">..on Windows</A></LI>
+ </UL></LI>
+ </OL>
+ </DIV>
+
+ <DIV CLASS="section">
+ <A NAME="install"><H2>Building STDCXX</H2></A>
+ <A NAME="linux"><H3>Building STDCXX on Linux</H3></A>
+
+ <OL>
+ <LI>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
+ </LI>
+ <LI>Define the STDCXX_HOME environment variable to refer to this
directory. The
+ Tuscany SDO build system uses this environment variable to
locate stdcxx.
+ </LI>
+ <LI>Change directory to STDCXX_HOME. Then build a debug version
of the stdcxx
+ library using the following command:
+ <DIV CLASS="sourcecode">gmake BUILDDIR=$STDCXX_HOME/Debug
BUILDTYPE=15d CONFIG=gcc.config</DIV>
+ This will create a sub-directory of STDCXX_HOME called Debug
and place the
+ build products below that.
+ </LI>
+ <LI>For a release version the command is:
+ <DIV CLASS="sourcecode">gmake BUILDDIR=$STDCXX_HOME/Release
BUILDTYPE=12d CONFIG=gcc.config</DIV>
+ </LI>
+ </OL>
+ <P>This provides Tuscany SDO with the versions of stdcxx that it
needs for both
+ Release and Debug builds.
+ </P>
+ <A NAME="win"><H3>Building STDCXX on Windows</H3></A>
+ <P>STDCXX is supported only when used with Microsoft Visual Studio
C++ V7.1
+ </P>
+ <OL>
+ <LI>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
+ </LI>
+ <LI>Define the STDCXX_HOME environment variable to refer to this
directory. The
+ Tuscany SDO build system uses this environment variable to
locate stdcxx.
+ </LI>
+ <LI>Create two directories to contain the results of building
stdcxx. The first is
+ for the debug enabled version and must be:
+ <DIV CLASS="sourcecode"><STDCXX_HOME>\Debug</DIV>
+ </LI>
+ <LI>The second is for the release (ie optimised) version and must
be
+ <DIV CLASS="sourcecode"><STDCXX_HOME>\Release</DIV>
+ </LI>
+ <LI>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:
+ <DIV CLASS="sourcecode">.\generate.bat
/BUILDDIR:<STDCXX_HOME>\Debug /CONFIG:VC71</DIV>
+ 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.)
+ </LI>
+ <LI>Repeat this operation for the release build, via the command:
+ <DIV CLASS="sourcecode">.\generate.bat
/BUILDDIR:<STDCXX_HOME>\Release /CONFIG:VC71</DIV>
+ </LI>
+ <LI>Still using the MSVC++ 7.1 command window, set the default
directory to one of
+ the two build directories eg
+ <DIV CLASS="sourcecode">cd <STDCXX_HOME>\Debug</DIV>
+ </LI>
+ <LI>Then launch the developer studio via
+ <DIV CLASS="sourcecode">cd <STDCXX_HOME>\Debug</DIV>
+ </LI>
+ <LI>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.
+ </LI>
+ <LI>Repeat this process for the release version, setting the
default directory to
+ <DIV CLASS="sourcecode">cd <STDCXX_HOME>\Release</DIV>
+ and choosing "12d Optimized Thread-safe Dll" as the build
configuration.
+ </LI>
+ </OL>
+ <P>This provides Tuscany SDO with the versions of stdcxx that it
needs for both
+ Release and Debug builds.
+ </P>
+ </DIV>
+ </DIV>
+</DIV>
+</BODY>
+
+</HTML>
+
Propchange: incubator/tuscany/cpp/sdo/doc/BuildingSTDCXX.html
------------------------------------------------------------------------------
svn:eol-style = native
Propchange: incubator/tuscany/cpp/sdo/doc/BuildingSTDCXX.html
------------------------------------------------------------------------------
svn:keywords = Rev Date
Modified: incubator/tuscany/cpp/sdo/doc/css/maven-theme.css
URL:
http://svn.apache.org/viewvc/incubator/tuscany/cpp/sdo/doc/css/maven-theme.css?view=diff&rev=453267&r1=453266&r2=453267
==============================================================================
--- incubator/tuscany/cpp/sdo/doc/css/maven-theme.css (original)
+++ incubator/tuscany/cpp/sdo/doc/css/maven-theme.css Thu Oct 5 08:25:05 2006
@@ -123,3 +123,12 @@
#banner {
border-bottom: 1px solid #fff;
}
+.sourcecode {
+ border: 1px solid #999;
+ font-family: Courier, monospace;
+ font-size: 13px;
+ white-space: pre;
+ padding: 4px 4px 4px 6px;
+}
+
+
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
