summaryrefslogtreecommitdiff
path: root/README.cmake
diff options
context:
space:
mode:
authorJeff Trawick <trawick@apache.org>2013-09-01 13:49:55 +0000
committerJeff Trawick <trawick@apache.org>2013-09-01 13:49:55 +0000
commit659017cc5377f37af32a39686e388eec2dcaba37 (patch)
tree1cba617c6d117c38f914cc0f70a52fd76cbf2a6c /README.cmake
parent728ec107c285a4e54bc764f95c2476d903c7bd24 (diff)
downloadhttpd-659017cc5377f37af32a39686e388eec2dcaba37.tar.gz
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
Diffstat (limited to 'README.cmake')
-rw-r--r--README.cmake27
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: