summaryrefslogtreecommitdiff
path: root/README.cmake
diff options
context:
space:
mode:
authorJeff Trawick <trawick@apache.org>2013-09-08 22:13:41 +0000
committerJeff Trawick <trawick@apache.org>2013-09-08 22:13:41 +0000
commit550b738e8935d380c1cef887d6c1676705893287 (patch)
tree57de4f51c76a7ad2d6d7cbd29966556a43134dda /README.cmake
parent90daf71806b3b01b23bdf46ca7c5b011353a2332 (diff)
downloadhttpd-550b738e8935d380c1cef887d6c1676705893287.tar.gz
Add a global ENABLE_MODULES setting to make it easy
to build and/or activate all possible modules. A few modules that are not currently buildable needed a prereq to be defined so that they will be skipped over appropriately for reasonable values of ENABLE_MODULES. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1520937 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'README.cmake')
-rw-r--r--README.cmake35
1 files changed, 35 insertions, 0 deletions
diff --git a/README.cmake b/README.cmake
index 480fcd6e1e..306bf93a66 100644
--- a/README.cmake
+++ b/README.cmake
@@ -73,6 +73,7 @@ How to build
3. cmake -G "some backend, like 'NMake Makefiles'"
-DCMAKE_INSTALL_PREFIX=d:/path/to/httpdinst
-DENABLE_foo=A|I|O|a|i
+ -DENABLE_MODULES=A|I|O|a|i
d:/path/to/httpdsource
Alternately, you can use the cmake-gui and update settings in the GUI.
@@ -136,6 +137,40 @@ How to build
Examples: -DENABLE_ACCESS_COMPAT=O
-DENABLE_PROXY_HTML=i
+ ENABLE_MODULES:
+ This changes the *minimum* enablement of all modules to the specified
+ value (one of A, a, I, i, O, as described under ENABLE_foo above).
+
+ The ranking of enablement from lowest to highest is O, i, I, a, A.
+ If a specific module has a higher rank enablement setting, either from
+ a built-in default or from -DENABLE_foo, ENABLE_MODULES won't affect
+ that module. However, if a specific module has a lower-rank enablement
+ setting, presumably from a built-in default, the value of ENABLE_MODULES
+ will be used for that module.
+
+ Explanations for possible values:
+
+ -DENABLE_MODULES=a build and activate all possible modules,
+ ignoring any with missing prereqs
+ (doesn't affect modules with A for ENABLE_foo)
+
+ -DENABLE_MODULES=i build but leave inactive all possible
+ modules, ignoring any with missing
+ prereqs
+ (doesn't affect modules with A, a, or I for
+ ENABLE_foo)
+
+ -DENABLE_MODULES=O no impact, since all modules are either
+ already disabled or have a higher setting
+
+ -DENABLE_MODULES=A build and activate all possible modules,
+ failing the build if any module is missing
+ a prereq
+
+ -DENABLE_MODULES=I similar to -DENABLE_MODULES=I
+ (doesn't affect modules with A or a for
+ ENABLE_foo)
+
WITH_MODULES:
Comma-separated paths to single file modules to statically link into
the server, like the --with-module=modpath:/path/to/mod_foo.c with