]> granicus.if.org Git - apache/blobdiff - INSTALL
* docs/: Clarify ProxyBlock docs.
[apache] / INSTALL
diff --git a/INSTALL b/INSTALL
index f8ca57275f64a279468daec12ac8c1eb0674eedc..82c5acfd01b203f06aadd35a6c95cdfa2a69cc86 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -5,7 +5,7 @@
   ------------------
 
   For complete installation documentation, see [ht]docs/manual/install.html or
-  http://httpd.apache.org/docs-2.0/install.html
+  http://httpd.apache.org/docs/2.5/install.html
 
      $ ./configure --prefix=PREFIX
      $ make
               might use "/usr/local/apache2" for PREFIX (without the
               quotes).
 
-            * If you are building on FreeBSD, be aware that threads will
-              be disabled and the prefork MPM will be used by default,
-              as threads do not work well with Apache on FreeBSD.  If
-              you wish to try a threaded Apache on FreeBSD anyway, use
-              "./configure --enable-threads".
-
-            * If you are a developer building Apache directly from CVS,
-              you will need to run ./buildconf before running configure.
+            * 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.
+
+            * If you are a developer building Apache directly from
+              Subversion, you will need to run ./buildconf before running
+              configure. This script bootstraps the build environment and
+              requires Python as well as GNU autoconf and libtool. If you
+              build Apache from a release tarball, you don't have to run
+              buildconf.
+
+            * If you want to build a threaded MPM (for instance worker)
+              on  FreeBSD, be aware that threads do not work well with
+              Apache on FreeBSD versions before 5.4-RELEASE. If you wish
+              to try a threaded Apache on an earlier version of FreeBSD,
+              use the --enable-threads parameter to ./configure in
+              addition to the --with-mpm parameter.
+
+            * If you are building directly from Subversion on Mac OS X
+              (Darwin), make sure to use GNU Libtool 1.4.2 or newer. All
+              recent versions of the developer tools on this platform
+              include a sufficiently recent version of GNU Libtool (named
+              glibtool, but buildconf knows where to find it).
 
   For a short impression of what possibilities you have, here is a
   typical example which configures Apache for the installation tree
      --enable-rewrite=shared \
      --enable-speling=shared 
 
-  The easiest way to find all of the configuration flags for Apache 2.0
+  The easiest way to find all of the configuration flags for Apache 2.5
   is to run ./configure --help.
 
 
   Quick Start - Windows
   ---------------------
 
-  For complete documentation, see [ht]docs/manual/platform/windows.html or
-  http://httpd.apache.org/docs-2.0/platform/windows.html.
-
-  The Apache/Win32 binaries are primarily distributed as a Windows Installer 
-  package (.msi), and may be available as a .zip file as well.  These packages 
-  are named apache-2.0.xx-win32-x86.msi and apache-2.0.xx-win32-x86.zip.  
-  Please choose the .msi package if at all possible.
-
-  If you have unpacked a source distribution (named httpd-2.0-xx.zip, without
-  any -win32-x86 notation) you must compile the package yourself, see the links
-  mentioned above.  Unless you intended to do this, please look again for the 
-  binary package from http://www.apache.org/dist/httpd/binaries/win32/ and
-  install that .msi (or .zip package, if you must.)
+  For complete documentation, see manual/platform/windows.html.en or
+  http://httpd.apache.org/docs/2.5/platform/windows.html.
 
-  If you have unpacked this binary distribution from the .zip package, you 
-  _must_ edit the conf/httpd.conf file (with notepad or another text editor) 
-  to reflect the correct ServerName, Domain, and directory paths.  Search for 
-  the text "@@" to discover what you must edit.  To install and start the 
-  service after you have corrected the httpd.conf file, use the command
+  The Apache/Win32 binaries are distributed as Windows Installer packages 
+  (.msi) named httpd-2.5.xx-win32-x86-no_ssl.msi for a version without mod_ssl
+  and httpd-2.5.xx-win32-x86-openssl-1.0.1x.msi for a version including the
+  mod_ssl plus the openssl library and command line utility.  Additional 64 bit
+  binaries have similarly named -win64-x64 package names.  These packages
+  may be unpacked without "installing" them by using the msiexec /a option.
 
-    bin\Apache -k install
-    bin\Apache -k start
+  If you have unpacked a source distribution (named httpd-2.5.x-win32-src.zip, 
+  without any -x86 or -x64 notation) you must compile the package yourself, 
+  see the links mentioned above.  Unless you intended to do this, please look
+  again for an .msi package in http://www.apache.org/dist/httpd/binaries/win32/
+  and install that desired .msi package.
 
   The .msi package configures the httpd.conf file, and installs and starts 
-  the Apache2 service for you.  It also installs plenty of useful shortcuts
+  the Apache2.x service for you.  It also installs plenty of useful shortcuts
   and the taskbar ApacheMonitor.  We strongly encourage you to use it.
 
 
 
   The Apache HTTP Server group cannot field user's installation questions.
   There are many valuable forums to help you get started.  Please refer your
-  questions to the appropriate forum, such as the user supported newsgroups
-  comp.infosystems.www.servers.unix and comp.infosystems.www.servers.ms-windows.
+  questions to the appropriate forum, such as the Users Mailing List at
+  http://httpd.apache.org/userslist.html or the usenet newsgroups
+  comp.infosystems.www.servers.unix or
+  comp.infosystems.www.servers.ms-windows.
 
-  Thanks for using the Apache HTTP Server, version 2.0.
+  Thanks for using the Apache HTTP Server, version 2.5.
 
                                      The Apache Software Foundation
                                      http://www.apache.org/