Author: ajborley
Date: Wed Oct 4 03:33:16 2006
New Revision: 452827
URL: http://svn.apache.org/viewvc?view=rev&rev=452827
Log:
Initial updates to SDO docs
Modified:
incubator/tuscany/cpp/sdo/GettingStarted.html
incubator/tuscany/cpp/sdo/samples/GettingStarted.html
Modified: incubator/tuscany/cpp/sdo/GettingStarted.html
URL:
http://svn.apache.org/viewvc/incubator/tuscany/cpp/sdo/GettingStarted.html?view=diff&rev=452827&r1=452826&r2=452827
==============================================================================
--- incubator/tuscany/cpp/sdo/GettingStarted.html (original)
+++ incubator/tuscany/cpp/sdo/GettingStarted.html Wed Oct 4 03:33:16 2006
@@ -1,4 +1,19 @@
<!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">
@@ -17,12 +32,12 @@
<DIV ID="bodyColumn">
<DIV ID="contentBox">
<DIV CLASS="section">
- <H2>Tuscany - Getting Started - SDO C++ Milestone release 1</H2>
+ <H2>Tuscany - Getting Started - SDO C++ Milestone release 2</H2>
<P>Tuscany SDO C++ is an implementation of the Service Data Objects
2.0 specification for C++ developers.
This page describes what is needed to install Tuscany SDO for
C++.<BR/>If you haven't already done so, the first
- step is to download the SDO C++ Milestone release 1 of Apache Tuscany
from our
- <A HREF="http://incubator.apache.org/tuscany/download.html";
target='_blank'>download page</A>.<BR/>
+ step is to download the SDO C++ Milestone release 2 of Apache Tuscany
from our
+ <A HREF="http://incubator.apache.org/tuscany/downloads.html";
target='_blank'>download page</A>.<BR/>
</P>
</DIV>
<DIV CLASS="section">
@@ -33,8 +48,10 @@
<UL>
<LI><A HREF="#linuxbin">..from the binary release on
Linux</A></LI>
<LI><A HREF="#linuxsrc">..from the source release on
Linux</A></LI>
+ <LI><A HREF="#linuxsrcstdcxx">..from the source release on
Linux with Apache STDCXX</A></LI>
<LI><A HREF="#winbin">..from the binary release on
Windows</A></LI>
<LI><A HREF="#winsrc">..from the source release on
Windows</A></LI>
+ <LI><A HREF="#winsrcstdcxx">..from the source release on
Windows with Apache STDCXX</A></LI>
</UL></LI>
<LI><A HREF="#samples">Samples</A></LI>
<LI><A HREF="#help">Getting Help</A></LI>
@@ -63,7 +80,7 @@
</TD>
</TR>
<TR CLASS="a">
- <TD>Axis2C Release 0.92</TD>
+ <TD>Axis2C Release 0.93</TD>
<TD>
<A HREF="http://ws.apache.org/axis2/c/download.cgi";
@@ -82,6 +99,17 @@
These libraries will need to be on the PATH in order to run
Tuscany SDO.
</TD>
</TR>
+ <TR CLASS="b">
+ <TD><STRONG>Optional: </STRONG>STDCXX Release 4.1.3</TD>
+
+ <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.
+ </TD>
+ </TR>
</TBODY>
</TABLE>
</DIV>
@@ -89,12 +117,12 @@
<A NAME="install"><H2>Installing Tuscany SDO for C++</H2></A>
<A NAME="linuxbin"><H3>Getting Tuscany SDO for C++ working with the
binary release on Linux</H3></A>
<OL>
- <LI>Extract the binary tar package to a folder</LI>
- <LI>Add the *install_dir*/lib directory to the LD_LIBRARY_PATH
(Linux) or DYLD_LIBRARY_PATH (MacOS X) environment variable</LI>
+ <LI>Extract the binary tar package to a folder
<tuscany_sdo_install_dir></LI>
+ <LI>Add the <tuscany_sdo_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 SDO for C++ working with the
source release on Linux</H3></A>
<OL>
- <LI>Extract the source tar package to a folder
<tuscany_sdo></LI>
+ <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>
@@ -103,7 +131,7 @@
LIBXML2_LIB=/usr/lib<BR/>
LIBXML2_INCLUDE=/usr/include/libxml2<BR/></LI>
- <LI>AXIS2C_HOME=<path to axis2c version 0.92></LI>
+ <LI>AXIS2C_HOME=<path to axis2c version 0.93></LI>
</UL></LI>
<LI>Build the source with the following command sequence:
<UL>
@@ -115,37 +143,86 @@
/usr/local/tuscany/sdo</LI>
<LI>Run the test:
<UL>
- <LI>cd to <tuscany_sdo>/runtime/core/test</LI>
+ <LI>cd to
<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>
+ <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.93></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="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</LI>
- <LI>Add the *install_dir*\bin directory to the PATH environment
variable</LI>
+ <LI>Unzip the supplied zip file to a folder
<tuscany_sdo_install_dir></LI>
+ <LI>Add the <tuscany_sdo_install_dir>\bin directory to the
PATH environment variable</LI>
</OL>
<A NAME="winsrc"><H3>Getting Tuscany SDO for C++ working with the
source release on Windows</H3></A>
<OL>
- <LI>Unzip the supplied source zip file</LI>
+ <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.92></LI>
+ <LI>AXIS2C_HOME=<path to axis2c version 0.93></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 <to where you unzipped the source></LI>
+ <LI>cd <tuscany_sdo_install_dir></LI>
<LI>build</LI>
</UL>
- This will build all the projects and put the required
output into the 'deploy' directory<BR/><BR/>
+ 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 'deploy'\bin directory PATH environment variable</LI>
+ <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.93></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>
</DIV>
@@ -195,9 +272,6 @@
</TD>
</TR>
</TBODY>
- </TABLE>
-
- <P></P>
</DIV>
</DIV>
</DIV>
Modified: incubator/tuscany/cpp/sdo/samples/GettingStarted.html
URL:
http://svn.apache.org/viewvc/incubator/tuscany/cpp/sdo/samples/GettingStarted.html?view=diff&rev=452827&r1=452826&r2=452827
==============================================================================
--- incubator/tuscany/cpp/sdo/samples/GettingStarted.html (original)
+++ incubator/tuscany/cpp/sdo/samples/GettingStarted.html Wed Oct 4 03:33:16
2006
@@ -1,4 +1,19 @@
<!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">
@@ -22,24 +37,26 @@
<P>Tuscany SDO C++ includes some simple technology samples that
demonstrate some of the basic sceanrios for C++ SDO.
This page describes the samples and what is needed to install and
run them.
</P>
- <P>The ObjectCreation sample demonstrates building the metadata
programmatically, followed by use
- of the metadata to instantiate objects in a graph.
- </P>
- <P>The XSDLoading sample shows how to load metadata from an XSD, and
how to check for errors during
- parsing. The parser gathers all non-fatal errors into one list, so
all errors can be checked at one
- time after parsing. Elements which contained errors will have been
omitted from the resulting metadata.
- </P>
- <P>The ChangeSummarySave sample modifies a data graph of employees,
and saves the modified graph with
- its change summary. The output in ChangeSummarySave-output.xml
shows the summary and its relationship
- by references to the data graph.
- </P>
- <P>The Substitutes sample shows how to use substitites in XSD to
achieve a property which will accept a
- range of types.
- </P>
- <P>The Query sample shows how to use XPath to navigate within a graph
to the required element. Note
- that exceptions such as "path not found" may well be thrown if the
XPath specified does not lead to
- a real object in the graph.
- </P>
+ <UL>
+ <LI>The ObjectCreation sample demonstrates building the metadata
programmatically, followed by use
+ of the metadata to instantiate objects in a graph.
+ </LI>
+ <LI>The XSDLoading sample shows how to load metadata from an XSD,
and how to check for errors during
+ parsing. The parser gathers all non-fatal errors into one
list, so all errors can be checked at one
+ time after parsing. Elements which contained errors will have
been omitted from the resulting metadata.
+ </LI>
+ <LI>The ChangeSummarySave sample modifies a data graph of
employees, and saves the modified graph with
+ its change summary. The output in ChangeSummarySave-output.xml
shows the summary and its relationship
+ by references to the data graph.
+ </LI>
+ <LI>The Substitutes sample shows how to use substitites in XSD
to achieve a property which will accept a
+ range of types.
+ </LI>
+ <LI>The Query sample shows how to use XPath to navigate within a
graph to the required element. Note
+ that exceptions such as "path not found" may well be thrown if
the XPath specified does not lead to
+ a real object in the graph.
+ </LI>
+ </UL>
<P>The SDO samples are built together into a single executable called
sdo_misc.exe on Windows and sdo_misc on Linux
</P>
</DIV>
@@ -48,8 +65,9 @@
<H2>Contents</H2>
<OL>
<LI><A HREF="#linuxbld">Building the samples on Linux</A></LI>
+ <LI><A HREF="#linuxbldstdcxx">Building the samples on Linux with
Apache STDCXX</A></LI>
<LI><A HREF="#linuxrun">Running the samples on Linux</A></LI>
- <LI><A HREF="#winbld">Building the samples on Windows</A></LI>
+ <LI><A HREF="#winbldstdcxx">Building the samples on Windows with
Apache STDCXX</A></LI>
<LI><A HREF="#winrun">Running the samples on Windows</A></LI>
</OL>
</DIV>
@@ -63,7 +81,28 @@
<LI>The following environment variables are required:
<UL>
<LI>TUSCANY_SDOCPP=<path to installed Tuscany SDO>
- <LI>AXIS2C_HOME=<path to axis2c version 0.92></LI>
+ <LI>AXIS2C_HOME=<path to axis2c version 0.93></LI>
+ </UL></LI>
+ </LI>
+ <LI>Build the source with the following command sequence:
+ <UL>
+ <LI>cd <tuscany_sdo_install_dir>/samples</LI>
+ <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/samples/misc</LI>
+ </OL>
+ </DIV>
+
+ <DIV CLASS="section">
+ <A NAME="linuxbldstdcxx"><H2>Building the samples on Linux with
Apache STDCXX</H2></A>
+ <OL>
+ <LI>The following environment variables are required:
+ <UL>
+ <LI>TUSCANY_SDOCPP=<path to installed Tuscany SDO>
+ <LI>AXIS2C_HOME=<path to axis2c version 0.93></LI>
</UL></LI>
</LI>
<LI>Build the source with the following command sequence:
@@ -100,7 +139,29 @@
<LI>The following environment variables are required:
<UL>
<LI>TUSCANY_SDOCPP=<path to installed Tuscany SDO>
- <LI>AXIS2C_HOME=<path to axis2c version 0.92></LI>
+ <LI>AXIS2C_HOME=<path to axis2c version 0.93></LI>
+ </UL></LI>
+ </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, either via the Visual Studio 6 project
under
+ <tuscany_sdo_install_dir>\samples\ides or via the
command-line build file
+ found at
<tuscany_sdo_install_dir>\samples\ides\devstudio6\projects\misc\build.cmd
+ which will build and deploy the samples.
+ </LI>
+ </OL>
+ </DIV>
+
+ <DIV CLASS="section">
+ <A NAME="winbldstdcxx"><H2>Building the samples on Windows with
Apache STDCXX</H2></A>
+ <OL>
+ <LI>The following environment variables are required:
+ <UL>
+ <LI>TUSCANY_SDOCPP=<path to installed Tuscany SDO>
+ <LI>AXIS2C_HOME=<path to axis2c version 0.93></LI>
</UL></LI>
</LI>
<LI>You must have set up the environment for Microsoft Visual C++
tools.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
