svn commit: r1518801 - /httpd/httpd/trunk/README.cmake

[tr...@apache.org]

Author: trawick
Date: Thu Aug 29 20:18:02 2013
New Revision: 1518801

URL: http://svn.apache.org/r1518801
Log:
mention the PATH issue

this will be resolved for most users by bundlers/distributors, but some hints
are appropriate

Modified:
    httpd/httpd/trunk/README.cmake

Modified: httpd/httpd/trunk/README.cmake
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/README.cmake?rev=1518801&r1=1518800&r2=1518801&view=diff
==============================================================================
--- httpd/httpd/trunk/README.cmake (original)
+++ httpd/httpd/trunk/README.cmake Thu Aug 29 20:18:02 2013
@@ -132,6 +132,38 @@ How to build
 
 4. build using chosen backend (e.g., "nmake install")
 
+Running the server and support programs
+---------------------------------------
+
+This build system does not copy binaries such as dlls from other projects
+into the httpd install location.  Without taking some precautions, httpd
+and support programs can fail to start or modules can fail to load because
+a support library can't be found in PATH or in the directory of the httpd
+binary.
+
+This can be resolved in several different ways:
+
+* Install httpd and the various support libraries to a common install
+  prefix so that support libraries and httpd programs are installed in
+  the same bin directory and are found without setting PATH.
+
+* Update PATH to include the bin directories of all necessary support
+  libraries.
+
+  Depending on where PATH is set, it may not effect starting httpd as
+  a service.
+
+* Maintain a script which combines required binaries into a common 
+  location, such as the httpd installion bin directory, and use that
+  script after building or otherwise installing or updating support
+  libraries.
+
+* AVOID THE USE of any unrepeatable process of copying dll files around
+  from different install locations until something starts working.  The
+  result is that when you later update a support library to pick up a
+  security fix, httpd will likely continue to use the old, vulnerable
+  library file.
+
 Known Bugs and Limitations
 --------------------------