Let the location of APR[-Util] and PCRE libs and

includes default to the same prefix where this package
is installed, generally eliminating four required settings
for users.

APR trunk vs. APR[-Util] 1.x is selected automatically,
as is PCRE debug vs. release.  (But if you have both
debug and release builds of PCRE you may not like the choice,
and will need to override.

Add a bunch of gory details about the build to the configuration
summary.

Document that static PCRE builds aren't yet supported (before
or after this commit).


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1519270 13f79535-47bb-0310-9956-ffa450edef68

1 files changed, 22 insertions, 5 deletions

diff --git a/README.cmake b/README.cmake
index 9395ba14e8..c99b2da4a5 100644
--- a/README.cmake
+++ b/README.cmake
@@ -72,24 +72,40 @@ How to build
 
 3. cmake -G "some backend, like 'NMake Makefiles'"
      -DCMAKE_INSTALL_PREFIX=d:/path/to/httpdinst
-     -DPCRE_INCLUDE_DIR=d:/path/to/pcreinst/include
-     -DPCRE_LIBRARIES=d:/path/to/pcreinst/lib/pcre[d].lib
-     -DAPR_INCLUDE_DIR=d:/path/to/aprinst/include
-     -DAPR_LIBRARIES="d:/path/to/aprinst/lib/libapr-1.lib;d:/path/to/aprinst/lib/libaprutil-1.lib"
      -DENABLE_foo=A|I|O|a|i
      d:/path/to/httpdsource
 
    Alternately, you can use the cmake-gui and update settings in the GUI.
 
    PCRE_INCLUDE_DIR, PCRE_LIBRARIES, APR_INCLUDE_DIR, APR_LIBRARIES:
+
        cmake doesn't bundle FindXXX for these packages, so the crucial
-       information has to be specified in this manner
+       information has to be specified in this manner if they aren't found
+       in their default location.
+
+     -DPCRE_INCLUDE_DIR=d:/path/to/pcreinst/include
+     -DPCRE_LIBRARIES=d:/path/to/pcreinst/lib/pcre[d].lib
+
+       These will have to be specified only if PCRE is installed to a different
+       directory than httpd, or if debug *and* release builds of PCRE were
+       installed there and you want to control which is used.  (Currently the
+       build will use pcred.lib (debug) if it is found in the default location
+       and not overridden with -DPCRE_LIBRARIES.)
+
+     -DAPR_INCLUDE_DIR=d:/path/to/aprinst/include
+     -DAPR_LIBRARIES="d:/path/to/aprinst/lib/libapr-1.lib;d:/path/to/aprinst/lib/libaprutil-1.lib"
+
+       These will have to be specified if APR[-Util] was installed to a
+       different directory than httpd.
 
        When building with APR trunk (future APR 2.x, with integrated APR-Util),
        specify just the path to libapr-2.lib:
 
            -DAPR_LIBRARIES=d:/path/to/aprinst/lib/libapr-2.lib
 
+       APR+APR-Util 1.x vs. APR trunk will be detected automatically if they
+       are installed to the same location as httpd.
+
    LIBXML2_ICONV_INCLUDE_DIR, LIBXML2_ICONV_LIBRARIES
 
       If using a module that requires libxml2 and the build of libxml2 requires
@@ -186,6 +202,7 @@ Known Bugs and Limitations
 * ApacheMonitor has a build error and is disabled
 * CGI examples aren't installed
 * module enablement defaults are not in sync with the autoconf-based build
+* no support for static PCRE builds (need to detect then turn on PCRE_STATIC)
 
 Generally: