Started to introduce the work done by the ACE Configuration

	Project into the official ACE distribution.

1 files changed, 148 insertions, 0 deletions

diff --git a/ACE-configuration.txt b/ACE-configuration.txt
new file mode 100644
index 00000000000..2ed4d444959
--- /dev/null
+++ b/ACE-configuration.txt
@@ -0,0 +1,148 @@
+----------------------------------------------------------------
+Configuring ACE Using the `configure' Script
+----------------------------------------------------------------
+
+To help speed development, the work being done by the ACE Configuration Project
+is being slowly introduced into the official ACE distribution.  Some of the
+functionality in the work created by the ACE Configuration Project has been
+removed so that ACE may be built in the usual fashion.  Once the ACE
+Configuration Project work stabilizes on more platforms that removed
+functionality may be added to ACE.
+
+Currently the configure script contains most of the tests that are necessary to
+properly configure ACE on most platforms.  However, there are still some
+autoconf tests that are missing.  As such, you may encounter and most likely
+will have compilation problems.  Please report any problems to the contacts
+listed at the end of this document.
+
+The `configure' script that is currently being used has been modified from the
+ACE Configuration Project's `configure' script to prevent makefiles from
+being automatically generated since there are still some issues that must be
+addressed before automatically generated makefiles are incorporated into the 
+official ACE distribution.
+
+A listing of available configure script options can be shown by entering
+
+	./configure --help
+
+at the command line.  The output should look something like the following:
+
+Usage: configure [options] [host]
+Options: [defaults in brackets after descriptions]
+Configuration:
+  --cache-file=FILE       cache test results in FILE
+  --help                  print this message
+  --no-create             do not create output files
+  --quiet, --silent       do not print `checking...' messages
+  --version               print the version of autoconf that created configure
+Directory and file names:
+  --prefix=PREFIX         install architecture-independent files in PREFIX
+                          [/usr/local]
+  --exec-prefix=EPREFIX   install architecture-dependent files in EPREFIX
+                          [same as prefix]
+  --bindir=DIR            user executables in DIR [EPREFIX/bin]
+  --sbindir=DIR           system admin executables in DIR [EPREFIX/sbin]
+  --libexecdir=DIR        program executables in DIR [EPREFIX/libexec]
+  --datadir=DIR           read-only architecture-independent data in DIR
+                          [PREFIX/share]
+  --sysconfdir=DIR        read-only single-machine data in DIR [PREFIX/etc]
+  --sharedstatedir=DIR    modifiable architecture-independent data in DIR
+                          [PREFIX/com]
+  --localstatedir=DIR     modifiable single-machine data in DIR [PREFIX/var]
+  --libdir=DIR            object code libraries in DIR [EPREFIX/lib]
+  --includedir=DIR        C header files in DIR [PREFIX/include]
+  --oldincludedir=DIR     C header files for non-gcc in DIR [/usr/include]
+  --infodir=DIR           info documentation in DIR [PREFIX/info]
+  --mandir=DIR            man documentation in DIR [PREFIX/man]
+  --srcdir=DIR            find the sources in DIR [configure dir or ..]
+  --program-prefix=PREFIX prepend PREFIX to installed program names
+  --program-suffix=SUFFIX append SUFFIX to installed program names
+  --program-transform-name=PROGRAM
+                          run sed PROGRAM on installed program names
+Host type:
+  --build=BUILD           configure for building on BUILD [BUILD=HOST]
+  --host=HOST             configure for HOST [guessed]
+  --target=TARGET         configure for TARGET [TARGET=HOST]
+Features and packages:
+  --disable-FEATURE       do not include FEATURE (same as --enable-FEATURE=no)
+  --enable-FEATURE[=ARG]  include FEATURE [ARG=yes]
+  --with-PACKAGE[=ARG]    use PACKAGE [ARG=yes]
+  --without-PACKAGE       do not use PACKAGE (same as --with-PACKAGE=no)
+  --x-includes=DIR        X include files are in DIR
+  --x-libraries=DIR       X library files are in DIR
+--enable and --with options recognized:
+  --enable-static[=PKGS]  build static libraries [default=no]
+  --enable-shared[=PKGS]  build shared libraries [default=yes]
+  --with-gnu-ld           assume the C compiler uses GNU ld [default=no]
+  --disable-libtool-lock  force libtool not to do file locking
+  --enable-debug          enable debugging                [default=yes]
+  --enable-exceptions     enable C++ exception handling   [default=yes]
+  --enable-fast           enable -fast flag, e.g. Sun C++ [default=no]
+  --enable-inline         enable code inlining            [default=yes]
+  --enable-log-msg-prop   enable threads inheriting
+                          ACE_Log_Msg properties from parent
+                          thread                          [default=yes]
+  --enable-logging        enable ACE logging macros       [default=yes]
+  --enable-malloc-stats   enable malloc statistics
+                          collection                      [default=no]
+  --enable-optimize       enable additional optimizations [default=yes]
+  --enable-probe          enable ACE_Timeprobes           [default=no]
+  --enable-profile        enable profiling                [default=no]
+  --enable-purify         Purify all executables          [default=no]
+  --enable-quantify       Quantify all executables        [default=no]
+  --enable-reentrant      enable reentrant functions      [default=yes]
+  --enable-repo           use GNU template repository
+                          GNU C++ with repo patches and
+                          EGCS only                       [default=no]
+  --enable-rtti           enable run-time type
+                          identification
+                          *Currently only for Sun C++     [default=no]
+  --enable-static-obj-mgr enable static Object_Manager    [default=yes]
+  --enable-threads        enable thread support           [default=yes]
+  --enable-verb-not-sup   enable verbose ENOTSUP reports  [default=no]
+  --enable-trace          enable ACE tracing              [default=no]
+  --enable-xt-reactor     build support for the XtReactor [default=no]
+  --with-x                use the X Window System
+  --with-gperf            compile the gperf program       [default=yes]
+  --with-orbix[=DIR]      compile ACE with Orbix          [default=no]
+  --with-tli-device[=DEV] device for TCP on TLI           [default=/dev/tcp]
+
+To enable debugging and disable code inlining, for example, just enter the
+following on the command line:
+
+	./configure --enable-debug --disable-inline
+
+This will generate a configuration header file `ace/config.h' to be used when
+compiling ACE that will enable ACE debugging macros and disable code inlining
+during compilation of ACE.
+
+Once the `ace/config.h' header has been created you will have to select a
+platform macros file.  Please read the ACE installation documents for more
+information about this.
+
+----------------------------------------------------------------
+Caveats
+----------------------------------------------------------------
+Much of the power of the `configure' script will not be useful until the
+automatically generated makefiles are enabled in ACE.  Configuration options
+such as "--prefix" will not be useful for this reason.
+
+The `configure' script will check for libraries that contain certain functions.
+If it finds a library that isn't listed in your platform_macros.GNU file you
+will have to add that library to the list of libraries to link against.
+
+----------------------------------------------------------------
+Contacts
+----------------------------------------------------------------
+If you do have problems please e-mail the ACE Configuration Project maintainer
+at:
+
+	Ossama Othman <othman@cs.wustl.edu>
+
+or send mail to the ACE mailing list.
+
+For more information take at a look at the ACE Configuration Project web page
+at:
+
+	http://www.cs.wustl.edu/~othman/aceconf
+