From d5eedd1a20be348760ec1e398649693481297e04 Mon Sep 17 00:00:00 2001 From: Jeff Trawick Date: Sun, 23 Sep 2012 14:11:02 +0000 Subject: consolidate hints/instructions about using APR (and maybe APR-util) with httpd git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1389060 13f79535-47bb-0310-9956-ffa450edef68 --- INSTALL | 71 +++++++++++++++++++++++++++++++++++++++++++++++++++++++---------- 1 file changed, 60 insertions(+), 11 deletions(-) (limited to 'INSTALL') diff --git a/INSTALL b/INSTALL index 82c5acfd01..63a43d696e 100644 --- a/INSTALL +++ b/INSTALL @@ -17,17 +17,7 @@ might use "/usr/local/apache2" for PREFIX (without the quotes). - * Consider if you want to use a previously installed APR and - APR-Util (such as those provided with many OSes) or if - you need to use the APR and APR-Util from the - httpd-2.5.x-deps.tar.gz tarball via ./configure's - --with-included-apr option. This is required if you don't - have the compiler which the system APR was built with. It - can also be advantageous if you are a developer who will be - linking your code with Apache or using a debugger to step - through server code, as it removes the possibility of - version or compile-option mismatches with APR and APR-util - code. + * Read the section "APR - Unix" below. * If you are a developer building Apache directly from Subversion, you will need to run ./buildconf before running @@ -63,6 +53,65 @@ The easiest way to find all of the configuration flags for Apache 2.5 is to run ./configure --help. + APR - Unix + ---------- + + httpd trunk (httpd development version 2.5) can use APR trunk (future + APR version 2.0) or the combination of the current APR 1.x branch and + the current APR-util 1.x branch. (APR trunk bundles the features in + APR-util 1.x.) + + The httpd buildconf step, required when building httpd from Subversion, + must have access to the APR source. The httpd configure step, always + required, can configure the APR source in srclib or use a previously- + built APR. + + APR (and APR-util if using APR 1.x) can be built with httpd from httpd's + srclib directory or can be built separately, prior to building httpd. + + Building APR with httpd from httpd's srclib directory is required if + you don't have the compiler which the system APR was built with, and it + can also be advantageous if you are a developer who will be linking your + code with httpd or using a debugger to step through server code, as it + removes the possibility of version or compile-option mismatches with + APR and APR-util code. + + To use APR trunk in srclib: + + Check out APR trunk in srclib/apr with the following command: + + svn co http://svn.apache.org/repos/asf/apr/apr/trunk srclib/apr + + buildconf will find it automaticaly. Use the --with-included-apr + argument to httpd configure. + + To use APR 1.x and APR-util 1.x in srclib: + + Check out the current branches as srclib/apr and srclib/apr-util with + the following commands: + + svn co http://svn.apache.org/repos/asf/apr/apr/branches/1.4.x srclib/apr + svn co http://svn.apache.org/repos/asf/apr/apr-util/branches/1.5.x srclib/apr-util + + buildconf will find them automaticaly. Use the --with-included-apr + argument to httpd configure. + + To use existing checkouts of APR (and APR-util if using APR 1.x): + + httpd buildconf must have access to the source trees. Use these arguments + to httpd buildconf: + + --with-apr=[path to apr source] --with-apr-util=[path to apr-util source] + + (Omit --with-apr-util if using APR trunk.) + + httpd configure must have access to a previously build apr. Use these + arguments to httpd configure: + + --with-apr=[path to apr install] --with-apr-util=[path to apr-util install] + + (Omit --with-apr-util if using APR trunk.) + Quick Start - Windows --------------------- -- cgit v1.2.1