tuscany-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ajbor...@apache.org
Subject svn commit: r453267 - in /incubator/tuscany/cpp: sca/GettingStarted.html sdo/GettingStarted.html sdo/doc/BuildingSTDCXX.html sdo/doc/css/maven-theme.css
Date Thu, 05 Oct 2006 15:25:06 GMT
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 &lt;tuscany_sca_install_dir&gt;/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 &lt;tuscany_sca&gt;</LI>
+              <LI>Extract the source tar package to a folder &lt;tuscany_sca_install_dir&gt;</LI>
               <LI>The following environment variables are required:               
                 
                 <UL>
                   <LI>TUSCANY_SDOCPP=&lt;path to installed Tuscany SDO&gt;
                                     
@@ -131,19 +131,21 @@
                 </UL></LI>
               <LI>Build the source with the following command sequence:
                   <UL>
-                      <LI>./configure</LI>
+                      <LI>./configure --prefix=&lt;tuscany_sca_install_dir&gt;/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 &lt;tuscany_sca_install_dir&gt;/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 &lt;tuscany_sca_install_dir&gt;\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=&lt;tuscany_sca_install_dir&gt;/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 &lt;tuscany_sdo_install_dir&gt;</LI>
-              <LI>The following environment variables are required:               
                 
-                <UL>
-                  <LI>LIBXML2_INCLUDE=&lt;path to libxml2 includes&gt;    
                                 
-                  <LI>LIBXML2_LIB=&lt;path to libxml2 lib&gt;<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=&lt;path to axis2c version 0.94&gt;</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 &lt;tuscany_sdo_install_dir&gt;/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 &lt;tuscany_sdo_install_dir&gt;</LI>
@@ -203,27 +182,29 @@
               <LI>Add the &lt;tuscany_sdo_install_dir&gt;\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 &lt;tuscany_sdo_install_dir&gt;</LI>
-              <LI>The following environment variables are required:               
                 
-                <UL>
-                  <LI>LIBXML2_HOME=&lt;path to installed libxml2&gt;<BR/>
-                  <LI>AXIS2C_HOME=&lt;path to axis2c version 0.94&gt;</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 &lt;tuscany_sdo_install_dir&gt;</LI>
-                      <LI>build</LI>                      
-                  </UL>
-	              This will build all the projects and put the required output into the &lt;tuscany_sdo_install_dir&gt;\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 &lt;tuscany_sdo_install_dir&gt;\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 &lt;tuscany_sdo_install_dir&gt;\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">
+@import url("css/maven-base.css");
+@import 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">&lt;STDCXX_HOME&gt;\Debug</DIV>
+             </LI>
+             <LI>The second is for the release (ie optimised) version and must be
+             <DIV CLASS="sourcecode">&lt;STDCXX_HOME&gt;\Release</DIV>
+             </LI>
+             <LI>Launch an MSVC++ 7.1 command window. In the command window, set the
default
+                directory to &lt;STDCXX_HOME&gt; 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:&lt;STDCXX_HOME&gt;\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:&lt;STDCXX_HOME&gt;\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 &lt;STDCXX_HOME&gt;\Debug</DIV>
+             </LI>
+             <LI>Then launch the developer studio via
+             <DIV CLASS="sourcecode">cd &lt;STDCXX_HOME&gt;\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 &lt;STDCXX_HOME&gt;\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: tuscany-commits-unsubscribe@ws.apache.org
For additional commands, e-mail: tuscany-commits-help@ws.apache.org


Mime
View raw message