Move Tuscany from Incubator to top level.

git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@668359 13f79535-47bb-0310-9956-ffa450edef68

1 files changed, 99 insertions, 0 deletions

diff --git a/cpp/BUILDING b/cpp/BUILDING
new file mode 100644
index 0000000000..e0923251e8
--- /dev/null
+++ b/cpp/BUILDING
@@ -0,0 +1,99 @@
+Tuscany C++ Build Instructions for Developers
+=============================================
+
+Download the source from http://svn.apache.org/repos/asf/incubator/tuscany/cpp
+The download location is <tuscany_cpp_root>
+
+Linux Build
+===========
+
+Prereqs:
+- libxml2 (version 2.6.20 or whichever version is prereq'd by axis2c)
+- Axis2C (version 0.94)
+
+Environment:
+- export LIBXML2_INCLUDE=<path to libxml2 headers. e.g. /usr/include/libxml2> 
+- export LIBXML2_LIB=<path to libxml2 libraries. e.g. /usr/lib> 
+- export AXIS2C_HOME=<axis2c_deploy>
+
+
+Build:
+- cd <tuscany_cpp_root>
+- ./build.sh
+
+This first builds the SDO subproject then SCA. The results are installed in
+ <tuscany_cpp_root>/sdo/deploy
+ <tuscany_cpp_root>/sca/deploy
+
+SDO Test
+--------
+
+Run:
+- cd <tuscany_cpp_root>/sdo
+- ./sdotest.sh
+
+
+SCA Test
+--------
+
+Run:
+- cd <tuscany_cpp_root>/sca
+- ./scatest.sh
+
+Linux distribution build
+========================
+To build the distro zips for linux:
+
+1. Download the source from http://svn.apache.org/repos/asf/incubator/tuscany/cpp
+The download location is <tuscany_cpp_root>
+
+2. cd <tuscany_cpp_root>/sdo
+
+3. set the environment
+   - export LIBXML2_INCLUDE=<path to libxml2 headers. e.g. /usr/include/libxml2> 
+   - export LIBXML2_LIB=<path to libxml2 libraries. e.g. /usr/lib> 
+   - export AXIS2C_HOME=<axis2c_deploy>
+
+4. ./builddist.sh
+   This produces a src and bin zip for Tuscany SDO
+
+5. cd <tuscany_cpp_root>/sca
+
+6. set the environment
+   - export TUSCANY_SDOCPP=<tuscany_cpp_root>/sdo/tucany_sdo-bin-${PACKAGE-VERSION}
+   
+7. ./builddist.sh
+   This produces a src and bin zip for Tuscany SCA
+   
+
+Windows Build
+=============
+
+Microsoft Visual Studio Express projects are provided for building on Windows.
+
+SDO
+---
+
+Prereqs:
+
+- libxml2 (tested with version 2.6.19)
+- Axis2C (version 0.94)
+
+1. Set the following environment variables to point to the location of the dependencies:
+        LIBXML2_INCLUDE=<libxml2 include location>
+        LIBXML2_LIB=<libxml2 lib location>
+        AXIS2C_HOME=<axis2c_deploy>
+
+2. cd <tuscany_cpp_root>\sdo
+
+3. .\build.bat
+
+
+SCA
+---
+
+1. Set the environment variable TUSCANY_SDOCPP to the path of an SDO build
+
+2. cd <tuscany_cpp_root>\sca
+
+3. .\build.bat