tuscany-commits mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From ajbor...@apache.org
Subject svn commit: r453643 - in /incubator/tuscany/cpp: sca/README sca/samples/Calculator/README.html sca/samples/PythonCalculator/README.html sca/samples/RubyBank/README.html sca/samples/RubyCalculator/README.html sdo/README sdo/samples/GettingStarted.html
Date Fri, 06 Oct 2006 15:34:55 GMT
Author: ajborley
Date: Fri Oct  6 08:34:54 2006
New Revision: 453643

URL: http://svn.apache.org/viewvc?view=rev&rev=453643
Log:
More documentation updates. Includes building the SDO samples with STDCXX and initial updates
to the README status docs

Modified:
    incubator/tuscany/cpp/sca/README
    incubator/tuscany/cpp/sca/samples/Calculator/README.html
    incubator/tuscany/cpp/sca/samples/PythonCalculator/README.html
    incubator/tuscany/cpp/sca/samples/RubyBank/README.html
    incubator/tuscany/cpp/sca/samples/RubyCalculator/README.html
    incubator/tuscany/cpp/sdo/README
    incubator/tuscany/cpp/sdo/samples/GettingStarted.html

Modified: incubator/tuscany/cpp/sca/README
URL: http://svn.apache.org/viewvc/incubator/tuscany/cpp/sca/README?view=diff&rev=453643&r1=453642&r2=453643
==============================================================================
--- incubator/tuscany/cpp/sca/README (original)
+++ incubator/tuscany/cpp/sca/README Fri Oct  6 08:34:54 2006
@@ -1,5 +1,5 @@
-Apache Tuscany C++ M1 build (July, 2006)
-===================================
+Apache Tuscany C++ M2 build (October, 2006)
+===========================================
 
 http://incubator.apache.org/tuscany
 
@@ -19,18 +19,23 @@
 ===============
 
 Documentation describing the system requirements and the steps to install
-Tuscany SCA C++ and run the samples can be found in the GettingStarted.html file.
+Tuscany SCA C++ and run the samples can be found in the GettingStarted.html 
+file.
 
 
 About Tuscany SCA C++
 =====================
 
-Tuscany SCA C++ provides a runtime implementation for the Service Component
-Architecture 0.9 specification, written in C++ and will currently support C++
-component implementation types. 
+Tuscany SCA C++ provides a runtime implementation for the for the Service 
+Component Architecture 0.96 Assembly specification and the 0.95 C++ Client 
+& Implementation Model specification, written in C++ and will currently 
+support C++, Python and Ruby component implementation types.
+
+The specifications can be found at
+http://www.osoa.org/display/Main/Service+Component+Architecture+Specifications 
 
 It is possible to interoperate with Tuscany SCA Java via the Web Service bindings
-for EntryPoint/ExternalService but restrictions apply. This is not yet a complete
+for services and references but restrictions apply. This is not yet a complete
 implementation and known restrictions are described below.
 
 Supported SCA Assembly Model features
@@ -38,29 +43,29 @@
      below. See SCA Assembly Model specification.
 
 Supported language bindings
-  * Component implementations written in C++. See SCA Client and
+  * Component implementations written in C++. See the SCA C++ Client and 
     Implementation Model specification.
+  * Component implementations written in Python. See the doc/PythonExtension.html 
+    documentation.
+  * Component implementations written in Python. See the doc/RubyExtension.html 
+    documentation.
   * Component interfaces described by C++ classes. See SCA Client and
     Implementation Model specification.
 
-Supported external service and entry point bindings
+Supported service and reference bindings
   * The web service binding is supported. This implementation will support
     web services which using document literal SOAP bindings conforming to the
     WS-I basic profile (rpc/encoded is not yet supported).
 
 Known restrictions
-  * Subsystem wiring, entry points and external services are not supported.
   * Local service interfaces cannot use overloaded operations (the SCA
     specification limits remote service interfaces to not using overloaded
-	operations).
+    operations).
   * Each WSDL definition for a web service binding must be in a single WSDL
     document.
-  * No load time validation of the deployed SCA application (run time validation
-    only).
-  * No metadata API.
-  * A Web Service EntryPoint that is wired (via zero or more components) to a 
-    Web Service ExternalService will fail when attempting to send the final 
-    response to the originating client. 
+  * No load time validation of the deployed SCA application (run time 
+    validation only).
+  * No metadata API. 
 
 
 

Modified: incubator/tuscany/cpp/sca/samples/Calculator/README.html
URL: http://svn.apache.org/viewvc/incubator/tuscany/cpp/sca/samples/Calculator/README.html?view=diff&rev=453643&r1=453642&r2=453643
==============================================================================
--- incubator/tuscany/cpp/sca/samples/Calculator/README.html (original)
+++ incubator/tuscany/cpp/sca/samples/Calculator/README.html Fri Oct  6 08:34:54 2006
@@ -122,7 +122,8 @@
          </OL>                                                  
          <A NAME="linuxws"><H3>Calculator with Web Service client</H3></A>
          <OL>
-             <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow
the instructions found here.
+             <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow
the instructions 
+                 found <A HREF="../../../doc/Axis2CWSService.html">here</A>.
              </LI>
              <LI>Start the Axis2C simple http server:
                 <OL>
@@ -197,7 +198,8 @@
          </OL>                                                  
          <A NAME="winws"><H3>Calculator with Web Service client</H3></A>
          <OL>
-             <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow
the instructions found here.
+             <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow
the instructions 
+                 found <A HREF="../../../doc/Axis2CWSService.html">here</A>.
              </LI>
              <LI>Start the Axis2C simple http server:
                 <OL>

Modified: incubator/tuscany/cpp/sca/samples/PythonCalculator/README.html
URL: http://svn.apache.org/viewvc/incubator/tuscany/cpp/sca/samples/PythonCalculator/README.html?view=diff&rev=453643&r1=453642&r2=453643
==============================================================================
--- incubator/tuscany/cpp/sca/samples/PythonCalculator/README.html (original)
+++ incubator/tuscany/cpp/sca/samples/PythonCalculator/README.html Fri Oct  6 08:34:54 2006
@@ -128,7 +128,8 @@
          </OL>                                                  
          <A NAME="linuxws"><H3>PythonCalculator with Web Service client</H3></A>
          <OL>
-             <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow
the instructions found here.
+             <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow
the instructions 
+                 found <A HREF="../../../doc/Axis2CWSService.html">here</A>.
              </LI>
              <LI>Start the Axis2C simple http server:
                 <OL>
@@ -200,7 +201,8 @@
          </OL>                                                  
          <A NAME="winws"><H3>PythonCalculator with Web Service client</H3></A>
          <OL>
-             <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow
the instructions found here.
+             <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow
the instructions 
+                 found <A HREF="../../../doc/Axis2CWSService.html">here</A>.
              </LI>
              <LI>Start the Axis2C simple http server:
                 <OL>

Modified: incubator/tuscany/cpp/sca/samples/RubyBank/README.html
URL: http://svn.apache.org/viewvc/incubator/tuscany/cpp/sca/samples/RubyBank/README.html?view=diff&rev=453643&r1=453642&r2=453643
==============================================================================
--- incubator/tuscany/cpp/sca/samples/RubyBank/README.html (original)
+++ incubator/tuscany/cpp/sca/samples/RubyBank/README.html Fri Oct  6 08:34:54 2006
@@ -122,7 +122,8 @@
          </OL>                                                  
          <A NAME="linuxws"><H3>RubyBank with Web Service clients</H3></A>
          <OL>
-             <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow
the instructions found here.
+             <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow
the instructions 
+                 found <A HREF="../../../doc/Axis2CWSService.html">here</A>.
              </LI>
              <LI>Start the Axis2C simple http server:
                 <OL>
@@ -187,7 +188,8 @@
          </OL>                                                  
          <A NAME="winws"><H3>RubyBank with Web Service clients</H3></A>
          <OL>
-             <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow
the instructions found here.
+             <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow
the instructions 
+                 found <A HREF="../../../doc/Axis2CWSService.html">here</A>.
              </LI>
              <LI>Start the Axis2C simple http server:
                 <OL>

Modified: incubator/tuscany/cpp/sca/samples/RubyCalculator/README.html
URL: http://svn.apache.org/viewvc/incubator/tuscany/cpp/sca/samples/RubyCalculator/README.html?view=diff&rev=453643&r1=453642&r2=453643
==============================================================================
--- incubator/tuscany/cpp/sca/samples/RubyCalculator/README.html (original)
+++ incubator/tuscany/cpp/sca/samples/RubyCalculator/README.html Fri Oct  6 08:34:54 2006
@@ -123,7 +123,8 @@
          </OL>                                                  
          <A NAME="linuxws"><H3>RubyCalculator with Web Service client</H3></A>
          <OL>
-             <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow
the instructions found here.
+             <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow
the instructions 
+                 found <A HREF="../../../doc/Axis2CWSService.html">here</A>.
              </LI>
              <LI>Start the Axis2C simple http server:
                 <OL>
@@ -195,7 +196,8 @@
          </OL>                                                  
          <A NAME="winws"><H3>RubyCalculator with Web Service client</H3></A>
          <OL>
-             <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow
the instructions found here.
+             <LI>Ensure you have enabled Axis2C to run Tuscany SCA services. Follow
the instructions 
+                 found <A HREF="../../../doc/Axis2CWSService.html">here</A>.
              </LI>
              <LI>Start the Axis2C simple http server:
                 <OL>

Modified: incubator/tuscany/cpp/sdo/README
URL: http://svn.apache.org/viewvc/incubator/tuscany/cpp/sdo/README?view=diff&rev=453643&r1=453642&r2=453643
==============================================================================
--- incubator/tuscany/cpp/sdo/README (original)
+++ incubator/tuscany/cpp/sdo/README Fri Oct  6 08:34:54 2006
@@ -1,5 +1,5 @@
-Apache Tuscany C++ M1 build (July, 2006)
-===================================
+Apache Tuscany C++ M2 build (October, 2006)
+===========================================
 
 http://incubator.apache.org/tuscany
 
@@ -19,38 +19,45 @@
 ===============
 
 Documentation describing the system requirements and the steps to install
-Tuscany SDO C++ and run the samples can be found in the GettingStarted.html file.
+Tuscany SDO C++ and run the samples can be found in the GettingStarted.html 
+file.
 
 
 About Tuscany SDO for C++
 =========================
 
-Tuscany SDO is an implementation of the Service Data Objects 2.0 specification for C++ developers.
-
-The implementation adheres closely to the specification, but there are a number of features
which 
-did not make it into this release. These are documented below.
+Tuscany SDO is an implementation of the Service Data Objects 2.01 
+specification for C++ developers found at
+http://www.osoa.org/display/Main/Service+Data+Objects+Specifications
+
+The implementation adheres closely to the specification, but there are a number 
+of features which did not make it into this release. These are documented 
+below.
 
 
 Generic get/set
 ---------------
-The C++ implementation defines a set of access methods directly appropriate to each Type.
For example
-getString(), setString(), getBoolean(), setBoolean(). There is no generic get() method as
there is no
-common base object to return - unlike the java implementation which can return an Object.
 
+The C++ implementation defines a set of access methods directly appropriate to
+each Type. For example getString(), setString(), getBoolean(), setBoolean(). 
+There is no generic get() method as there is no common base object to return - 
+unlike the java implementation which can return an Object.
 
 
 Typesafe interface
 ------------------
-There is no code generation in this version, so there is no interface such that a property
called
-"Name" can be accessed via object->getName().  The name must be accessed via object->getString("Name");
+There is no code generation in this version, so there is no interface such that
+a property called "Name" can be accessed via object->getName().  The name must 
+be accessed via object->getString("Name");
 
 
 Change Summary Serialization
 ----------------------------
-Change summaries contain creations, deletions and modifications to data graphs. The specification

-indicates that these will be serialized to XML such that creations and deletions will become
attributes
-of the change summary element, whilst changes become elements within the change summary element.
-This implementation saves all creations, deletions and changes as elements within the chang
summary
-element.
+Change summaries contain creations, deletions and modifications to data graphs.
+The specification indicates that these will be serialized to XML such that 
+creations and deletions will become attributes of the change summary element, 
+whilst changes become elements within the change summary element. This 
+implementation saves all creations, deletions and changes as elements within 
+the change summary element.
 
 
 Change Summary Undo
@@ -60,8 +67,8 @@
 
 Read-Only
 ---------
-Read-only data elements are not supported by this implementation. Properties may be set read-only,
but
-the property may still be modified without an error.
+Read-only data elements are not supported by this implementation. Properties 
+may be set read-only, but the property may still be modified without an error.
 
 
 Opposites
@@ -71,21 +78,23 @@
 
 Date and Time
 -------------
-Date support is limited to using a time_t. There are no calendar or duration style objects,
and no
-helpers for conversions.
+Date support is limited to using a time_t. There are no calendar or duration 
+style objects, and no helpers for conversions.
 
 
 BigDecimal and BigInteger
 -------------------------
-The equivalent of the java BigDecimal and BigInteger objects are not implmented.
+The equivalent of the java BigDecimal and BigInteger objects are not 
+implemented.
 
 
 NLS support
 -----------
-Data objects may contain multi-byte data in the form of an SDO string, but locale information
is not
-stored with the data.
+Data objects may contain multi-byte data in the form of an SDO string, but 
+locale information is not stored with the data.
 
-The creation API only allows properties and types to have ascii names (taking a char* as
the name).
+The creation API only allows properties and types to have ascii names (taking a 
+char* as the name).
 
 
 Inheritance

Modified: incubator/tuscany/cpp/sdo/samples/GettingStarted.html
URL: http://svn.apache.org/viewvc/incubator/tuscany/cpp/sdo/samples/GettingStarted.html?view=diff&rev=453643&r1=453642&r2=453643
==============================================================================
--- incubator/tuscany/cpp/sdo/samples/GettingStarted.html (original)
+++ incubator/tuscany/cpp/sdo/samples/GettingStarted.html Fri Oct  6 08:34:54 2006
@@ -157,24 +157,27 @@
 
          <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=&lt;path to installed Tuscany SDO&gt;
                                     
-                  <LI>AXIS2C_HOME=&lt;path to axis2c version 0.94&gt;</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 
-                 &lt;tuscany_sdo_install_dir&gt;\samples\ides or via the command-line
build file
-                 found at &lt;tuscany_sdo_install_dir&gt;\samples\ides\devstudio6\projects\misc\build.cmd
-                 which will build and deploy the samples.
-             </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;samples\ides\devstudio7\projects\misc\misc.sln
+          </P>
+          <P>The sdo_misc project includes 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_misc by
+             right clicking on sdo_misc 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_misc or sdo_runtime are built with
+             STDCXX then both must be.
+          </P>                                                  
         </DIV>
 
        <DIV CLASS="section"> 



---------------------------------------------------------------------
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