From ef507e472ce502674072839ebf6ec7ddf7e5d478 Mon Sep 17 00:00:00 2001
From: jsdelfino <jsdelfino@13f79535-47bb-0310-9956-ffa450edef68>
Date: Tue, 5 Jan 2010 09:17:17 +0000
Subject: Updated building instructions, added python build option and a list
 of the required build tools.

git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@895955 13f79535-47bb-0310-9956-ffa450edef68
---
 sca-cpp/trunk/INSTALL      | 60 ++++++++++++++++++++++++++++++++++++----------
 sca-cpp/trunk/configure.ac |  2 +-
 2 files changed, 49 insertions(+), 13 deletions(-)

diff --git a/sca-cpp/trunk/INSTALL b/sca-cpp/trunk/INSTALL
index 5d9239d1ff..78b375d378 100644
--- a/sca-cpp/trunk/INSTALL
+++ b/sca-cpp/trunk/INSTALL
@@ -4,16 +4,25 @@ Apache Tuscany SCA Runtime
 Building
 ========
 
-First get the following dependencies:
+The Tuscany SCA Linux build uses the GNU Autotools tool chain.
+
+First get the following tools:
+autoconf-2.64
+automake-1.4
+gcc-4.4.1
+libtool-2.2.6
+doxygen-1.6.1
+
+Then get the following development dependencies:
 
 HTTP server and APR
 httpd-2.2-13
 libapr-1-0.3.8
 libaprutil-1-0.3.9
 
-Recommended httpd configure options:
---with-included-apr to build httpd with the included APR distribution,
---with-mpm=worker to run the Tuscany httpd modules in multiple threads.
+Recommended HTTPD configure options:
+--with-included-apr to build HTTPD with the included APR distribution,
+--with-mpm=worker to run HTTPD modules in multiple threads.
 
 XML
 libxml2-2.7.5
@@ -22,26 +31,47 @@ JSON
 SpiderMonkey libmozjs
 (included in xulrunner-1.9.1.5)
 
-To configure the Tuscany build do this:
+Python
+libpython2.6
+
+To configure the Tuscany SCA build do this:
 ./autogen.sh
 ./configure --prefix=<install dir>
 
-To turn on debugging, profiling and strict warning compile options:
-./configure --enable-maintainer-mode
+To enable debugging and strict warning compile options, add:
+--enable-maintainer-mode
+
+To enable gprof profiling, add:
+--enable-profiling
+
+To enable multi-threading with the HTTPD worker MPM, add:
+--enable-threads
+
+To generate doxygen documentation, add:
+--enable-doxygen
 
-To configure where to find dependencies, see the configure help:
+To configure where to find dependencies, see the --with-* options described
+in the configure help:
 ./configure --help
 
+Here's an example configuration, tested on Ubuntu 9.10, with development
+dependencies installed in the standard directories and a build of the
+HTTPD worker MPM in $HOME/httpd-2-2.13-bin:
+
+./configure --prefix=$HOME/tuscany-sca-cpp-bin \
+--with-apr=$HOME/httpd-2.2.13-bin --with-httpd=$HOME/httpd-2.2.13-bin \
+--with-js-include=/usr/include/xulrunner-1.9.1.5/unstable \
+--with-js-lib=/usr/lib/xulrunner-1.9.1.5 \
+--with-python=/usr \
+--with-curl=/usr --with-libxml2=/usr \
+--enable-threads --enable-maintainer-mode
+
 To build the runtime, do this:
 make
 
 To run the tests, do this:
 make check
 
-To build doxygen documentation, do this:
-./configure --prefix=<install dir> --enable-doxygen
-make
-
 To build ctags for the source, do this:
 make ctags
 
@@ -51,3 +81,9 @@ make dist
 To build a binary distribution, do this:
 make bindist
 
+Installing
+==========
+
+To install the binaries, do this:
+make install
+
diff --git a/sca-cpp/trunk/configure.ac b/sca-cpp/trunk/configure.ac
index 95d984396c..8c0fa5094a 100644
--- a/sca-cpp/trunk/configure.ac
+++ b/sca-cpp/trunk/configure.ac
@@ -17,7 +17,7 @@
 
 dnl run autogen.sh to generate the configure script.
 
-AC_PREREQ(2.59)
+AC_PREREQ(2.64)
 AC_INIT(tuscany-sca, 1.0, dev@tuscany.apache.org)
 AC_CONFIG_MACRO_DIR([m4])
 AC_CANONICAL_SYSTEM
-- 
cgit v1.2.3