bunch of random updates... this file still had a lot of 1.3'isms, and also

needed a goodly number of changes for current layouts, web locations, etc.

added mod_dav, mod_dav_fs, and removed the obsolete loggers.


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@87491 13f79535-47bb-0310-9956-ffa450edef68

1 files changed, 72 insertions, 47 deletions

diff --git a/INSTALL b/INSTALL
index ba598eb212..f668713129 100644
--- a/INSTALL
+++ b/INSTALL
@@ -10,8 +10,8 @@
   to create an environment that looks like many other Open Source projects.
 
 
-  Installing the Apache 1.3 HTTP server with APACI
-  ================================================
+  Installing the Apache 2.0 HTTP server
+  =====================================
 
   1. Overview for the impatient
      --------------------------
@@ -26,6 +26,11 @@
            filesystem path under which Apache should be installed. For
            instance use "/usr/local/apache" for PREFIX above.
 
+     NOTE: if you are building from a copy of the Apache CVS
+           repository, rather than a release distribution, then you
+	   must use the "buildconf" script before running configure.
+
+
   2. Requirements
      ------------
 
@@ -47,20 +52,6 @@
         at http://www.gnu.org/ and the GCC distribution under
         http://www.gnu.org/order/ftp.html .
 
-     o  Libtool 1.3.3:
-
-        Make sure that you have libtool 1.3.3 or later installed before
-        trying to configure and build Apache 2.0.  Libtool can be downloaded
-        from the Free Software Foundation (FSF), at 
-        http://www.gnu.org/order/ftp.html.
-
-     o  Autoconf 2.13:
-
-        Make sure that you have autoconf 2.13 or later installed before
-        trying to configure and build Apache 2.0.  Autoconf can be
-        downloaded from the Free Software Foundation (FSF), at
-        http://www.gnu.org/order/ftp.html.
-
      o  Perl 5 Interpreter [OPTIONAL]:
 
         For some of the support scripts like `apxs' or `dbmmanage' (which are
@@ -101,13 +92,34 @@
         below) manually or at least make sure a Perl 5 interpreter is
         installed from which Apache can guess the options.
 
+
+     If you are building from a copy of the CVS repository, rather
+     than a release distribution, then you will need these additional
+     tools:
+
+     o  Libtool 1.3.3:
+
+        Make sure that you have libtool 1.3.3 or later installed before
+        trying to configure and build Apache 2.0.  Libtool can be downloaded
+        from the Free Software Foundation (FSF), at 
+        http://www.gnu.org/order/ftp.html.
+
+     o  Autoconf 2.13:
+
+        Make sure that you have autoconf 2.13 or later installed before
+        trying to configure and build Apache 2.0.  Autoconf can be
+        downloaded from the Free Software Foundation (FSF), at
+        http://www.gnu.org/order/ftp.html.
+
+
   3. Configuring the source tree
      ---------------------------
 
      Setup:
- 
-     The first step in compiling Apache 2.0 is to setup the source tree so
-     that it can be built.  This is done by running:
+
+     If you have downloading the Apache 2.0 from the CVS, rather than
+     a release distribution, then you will need to prepare the source
+     tree for configuration and compilation. This is done by running:
  
      ./buildconf
 
@@ -180,14 +192,16 @@
      PREFIX=/usr/local/apache and EPREFIX=PREFIX.
 
      Use the --bindir=DIR, --sbindir=DIR, --libexecdir=DIR, --mandir=DIR,
-     --sysconfdir=DIR, --datadir=DIR, --includedir=DIR, --localstatedir=DIR,
-     --runtimedir=DIR, --logfiledir=DIR and proxycachedir=DIR option to change
+     --sysconfdir=DIR, --datadir=DIR, --iconsdir=DIR, --htdocsdir=DIR,
+     --cgidir=DIR, --includedir=DIR, --localstatedir=DIR,
+     --runtimedir=DIR, --logfiledir=DIR and --proxycachedir=DIR option to change
      the paths for particular subdirectories of the installation tree.
-     Defaults are bindir=EPREFIX/bin, sbindir=EPREFIX/sbin,
-     libexecdir=EPREFIX/libexec, mandir=PREFIX/man, sysconfdir=PREFIX/etc,
-     datadir=PREFIX/share, includedir=PREFIX/include,
-     localstatedir=PREFIX/var, runtimedir=PREFIX/var/run,
-     logfiledir=PREFIX/var/log and proxycachedir=PREFIX/var/proxy.
+     Defaults are bindir=EPREFIX/bin, sbindir=EPREFIX/bin,
+     libexecdir=EPREFIX/modules, mandir=PREFIX/man, sysconfdir=PREFIX/conf,
+     datadir=PREFIX, iconsdir=PREFIX/icons, htdocsdir=PREFIX/htdocs,
+     cgidir=PREFIX/cgi-bin, includedir=PREFIX/include,
+     localstatedir=PREFIX, runtimedir=PREFIX/logs,
+     logfiledir=PREFIX/logs and proxycachedir=PREFIX/proxy.
 
          Note: To reduce the pollution of shared installation locations
                (like /usr/local/ or /etc) with Apache files to a minimum the
@@ -218,12 +232,6 @@
      Use the --show-layout option to check the final installation path layout
      while fiddling with the options above.
  
-     Use the --enable-rule=NAME and --disable-rule=NAME options to enable or
-     disable a particular Rule from the Apache src/Configuration.tmpl file. The
-     defaults (yes=enabled, no=disabled) can either be seen when running
-     `./configure --help' or manually looked up in the src/Configuration.tmpl
-     file.
- 
      Use the --enable-NAME=(shared) and --disable-NAME options to enable
      or disable a particular already distributed module from the Apache
      package.
@@ -237,50 +245,63 @@
       (+) mod_env .......... Set environment variables for CGI/SSI scripts
       (+) mod_setenvif ..... Set environment variables based on HTTP headers
       (-) mod_unique_id .... Generate unique identifiers for request
+
      Content type decisions
       (+) mod_mime ......... Content type/encoding determination (configured)
       (-) mod_mime_magic ... Content type/encoding determination (automatic)
       (+) mod_negotiation .. Content selection based on the HTTP Accept* headers
+
      URL mapping
       (+) mod_alias ........ Simple   URL translation and redirection
       (-) mod_rewrite ...... Advanced URL translation and redirection
       (+) mod_userdir ...... Selection of resource directories by username
       (-) mod_speling ...... Correction of misspelled URLs
+
      Directory Handling
       (+) mod_dir .......... Directory and directory default file handling
       (+) mod_autoindex .... Automated directory index file generation
-     Access Control
+
+     Access Control and Authentication
       (+) mod_access ....... Access Control (user, host, network)
       (+) mod_auth ......... HTTP Basic Authentication (user, passwd)
       (-) mod_auth_dbm ..... HTTP Basic Authentication via Unix NDBM files
       (-) mod_auth_db ...... HTTP Basic Authentication via Berkeley-DB files
       (-) mod_auth_anon .... HTTP Basic Authentication for Anonymous-style users
       (-) mod_digest ....... HTTP Digest Authentication
+
      HTTP response
       (-) mod_headers ...... Arbitrary HTTP response headers (configured)
       (-) mod_cern_meta .... Arbitrary HTTP response headers (CERN-style files)
       (-) mod_expires ...... Expires HTTP responses 
       (+) mod_asis ......... Raw HTTP responses 
+
      Scripting
       (+) mod_include ...... Server Side Includes (SSI) support
       (+) mod_cgi .......... Common Gateway Interface (CGI) support
       (+) mod_cgid ......... Common Gateway Interface (CGI) support for 
                              multi-threaded MPMs
       (+) mod_actions ...... Map CGI scripts to act as internal `handlers'
+
      Internal Content Handlers
       (+) mod_status ....... Content handler for server run-time status
       (-) mod_info ......... Content handler for server configuration summary
+
      Request Logging
       (+) mod_log_config ... Customizable logging of requests
-      (-) mod_log_agent .... Specialized HTTP User-Agent logging (deprecated)
-      (-) mod_log_referer .. Specialized HTTP Referrer logging   (deprecated)
       (-) mod_usertrack .... Logging of user click-trails via HTTP Cookies
+
+     Content Management
+      (-) mod_dav .......... WebDAV (RFC 2518) support for Apache
+      (-) mod_dav_fs ....... mod_dav backend to managing filesystem content
+
      Miscellaneous
       (+) mod_imap ......... Server-side Image Map support
       (-) mod_proxy ........ Caching Proxy Module (HTTP, HTTPS, FTP)
       (-) mod_so ........... Dynamic Shared Object (DSO) bootstrapping
+
      Experimental
       (-) mod_mmap_static .. Caching of frequently served pages via mmap()
+
      Development
       (-) mod_example ...... Apache API demonstration (developers only)
 
@@ -345,6 +366,7 @@
      Use the --server-gid option to specify the group ID you want the server user ID to
      be a member of.  If not specified, the group ID will be #-1.
 
+
   4. Building the package
      --------------------
      
@@ -356,6 +378,7 @@
      Please be patient here, this takes approximately 2 minutes to complete
      under a Pentium-166/FreeBSD-2.2 system, dependend on the amount of
      modules you have enabled. 
+
  
   5. Installing the package
      ----------------------
@@ -368,7 +391,8 @@
      For the paranoid hackers under us: The above command really installs under
      prefix _only_, i.e. no other stuff from your system is touched. Even if
      you upgrade an existing installation your configuration files in
-     PREFIX/etc/ are preserved.
+     PREFIX/conf/ are preserved.
+
 
   6. Testing the package
      -------------------
@@ -384,21 +408,21 @@
      server again by running: 
 
         $ PREFIX/bin/apachectl stop
+
  
   7. Customizing the package
      -----------------------
  
      Finally you can customize your Apache HTTP server by editing the
-     configuration files under PREFIX/etc/.
+     configuration files under PREFIX/conf/.
  
-        $ vi PREFIX/etc/httpd.conf
-        $ vi PREFIX/etc/access.conf
-        $ vi PREFIX/etc/srm.conf
+        $ vi PREFIX/conf/httpd.conf
  
-     Have a look at the Apache manual under htdocs/manual/ or
-     http://www.apache.org/docs/ for a complete reference of available
+     Have a look at the Apache manual under docs/manual/ or
+     http://httpd.apache.org/docs/ for a complete reference of available
      configuration directives.
 
+
   8. Preparing the system
      --------------------
 
@@ -418,13 +442,14 @@
         http://www.eecis.udel.edu/~ntp/ for more details about NTP software
         and public time servers.
 
+
   9. Contacts
      --------
 
      o If you want to be informed about new code releases, bug fixes, 
        security fixes, general news and information about the Apache server
        subscribe to the apache-announce mailing list as described under
-       http://www.apache.org/announcelist.html
+       http://httpd.apache.org/announcelist.html
 
      o If you want freely available support for running Apache please join the
        Apache user community by subscribing at least to the following USENET
@@ -433,17 +458,17 @@
 
      o If you want commercial support for running Apache please contact
        one of the companies and contractors which are listed at
-       http://www.apache.org/info/support.cgi
+       http://httpd.apache.org/info/support.cgi
 
      o If you have a concrete bug report for Apache please go to the
        Apache Group Bug Database and submit your report:
-       http://www.apache.org/bug_report.html
+       http://httpd.apache.org/bug_report.html
 
      o If you want to participate in actively developing Apache please
        subscribe to the `new-httpd' mailing list as described at
-       http://dev.apache.org/mailing-lists
+       http://www.apache.org/foundation/mailinglists.html
 
      Thanks for running Apache.
+
                                           The Apache Group
                                           http://www.apache.org/
-