nightmorph    07/11/29 08:40:48

  Modified:             apache-upgrading.xml apache-troubleshooting.xml
  Log:
  massive update from bug 200617, with cleanups by yours truly. thanks to 
hollow for the original patch

Revision  Changes    Path
1.9                  xml/htdocs/doc/en/apache-upgrading.xml

file : 
http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/apache-upgrading.xml?rev=1.9&view=markup
plain: 
http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/apache-upgrading.xml?rev=1.9&content-type=text/plain
diff : 
http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/apache-upgrading.xml?r1=1.8&r2=1.9

Index: apache-upgrading.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/apache-upgrading.xml,v
retrieving revision 1.8
retrieving revision 1.9
diff -u -r1.8 -r1.9
--- apache-upgrading.xml        30 Jul 2007 18:06:35 -0000      1.8
+++ apache-upgrading.xml        29 Nov 2007 08:40:48 -0000      1.9
@@ -1,6 +1,6 @@
 <?xml version='1.0' encoding="UTF-8"?>
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
-<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/apache-upgrading.xml,v 1.8 
2007/07/30 18:06:35 nightmorph Exp $ -->
+<!-- $Header: /var/cvsroot/gentoo/xml/htdocs/doc/en/apache-upgrading.xml,v 1.9 
2007/11/29 08:40:48 nightmorph Exp $ -->
 
 <guide link="/doc/en/apache-upgrading.xml" lang="en">
 <title>Upgrading Apache</title>
@@ -8,6 +8,12 @@
 <author title="Author">
   <mail link="[EMAIL PROTECTED]">Michael Stewart</mail>
 </author>
+<author title="Editor">
+  <mail link="hollow"/>
+</author>
+<author title="Editor">
+  <mail link="nightmorph"/>
+</author>
 
 <abstract>
 This document describes the procedure end-users should follow to safely 
@@ -18,12 +24,80 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>2.5</version>
-<date>2007-07-30</date>
+<version>2.6</version>
+<date>2007-11-29</date>
 
-<chapter>
-<title>Introduction</title>
+<chapter id="upgrade-2.2.6-r4">
+<title>Upgrading from &lt;2.2.6-r4</title>
+<section>
+<body>
+
+<p>
+The Apache ebuilds have used <path>/etc/apache2/apache2-builtin-mods</path> for
+a very long time to select the built-in modules during compile time. However,
+this behavior has several disadvantages:
+</p>
+
+<ul>
+  <li>
+    Selecting built-in modules during the initial merge is not possible
+  </li>
+  <li>
+    Portage does not know which modules have been installed. This is especially
+    annoying for binary packages.
+  </li>
+  <li>
+    Portage will try to overwrite <path>apache2-builtin-mods</path> on every
+    upgrade
+  </li>
+</ul>
+
+<p>
+To rectify this situation <path>/etc/apache2/apache2-builtin-mods</path> has
+been deprecated and migrated to the new <c>APACHE2_MODULES</c> 
<c>USE_EXPAND</c>
+variable. To convert your custom module selection to the new format use the
+following command:
+</p>
+
+<pre caption="Convert apache2-builtin-mods to APACHE2_MODULES">
+$ <i>echo APACHE2_MODULES=\"$(sed 
'/^mod_/s/mod_\(.*\)\s\+\(shared\|static\)/\1/;t n;d;:n' 
/etc/apache2/apache2-builtin-mods)\" >> /etc/make.conf</i>
+# <i>rm /etc/apache2/apache2-builtin-mods</i>
+
+<comment>(You can now safely upgrade apache:)</comment>
+# <i>emerge -uva '>=www-servers/apache-2.2.6-r4'</i>
+</pre>
+
+<p>
+Additionally to the new <c>APACHE2_MODULES</c> the local USE flags have been
+cleaned up:
+</p>
+
+<ul>
+  <li>
+    All MPM USE flags have been moved to the <c>APACHE2_MPMS</c>
+    <c>USE_EXPAND</c> variable
+  </li>
+  <li>
+    <c>no-suexec</c> is now <c>suexec</c>
+  </li>
+  <li>
+    <c>static-modules</c> is now <c>static</c>
+  </li>
+</ul>
+
+<p>
+For a detailed description of old and corresponding new USE flags see <uri
+link="#use-2.2.6-r4">below</uri>.
+</p>
+
+</body>
+</section>
+</chapter>
+
+<chapter id="upgrade-2.0.52-r3">
+<title>Upgrading from &lt;2.0.52-r3</title>
 <section>
+<title>Introduction</title>
 <body>
 
 <p>
@@ -57,29 +131,20 @@
 </ul>
 
 <p>
-The solution? The Apache herd was expanded, adding several new members, who 
-worked together to create an eclass, update all the modules and fix a number 
-of bugs.
-</p>
-
-<p>
 This document details how to upgrade without breaking your system. If you are 
-a  developer or would like to know what we changed, or how ebuilds need to be 
+a developer or would like to know what we changed, or how ebuilds need to be 
 modified to take advantage of our eclass, then check the <uri 
 link="apache-developer.xml">Apache Developer Reference</uri>.
 </p>
 
 </body>
 </section>
-</chapter>
-
-<chapter id="upgrade">
-<title>Upgrade Instructions</title>
 <section>
+<title>Upgrading</title>
 <body>
 
 <p>
-We have made many changes to how Apache works within Gentoo. Every package 
+There have been many changes to how Apache works within Gentoo. Every package
 that is directly related to Apache needs to be updated and some things that 
 worked previously will no longer work.
 </p>
@@ -125,13 +190,13 @@
 </p>
 
 <p>
-As we have added some new USE-flags, you may want to review them and add 
+As we have added some new USE flags, you may want to review them and add 
 appropriate lines to <path>/etc/portage/package.use</path>. See <uri 
-link="#use">Apache supported USE-flags</uri> for more details.
+link="#use">Apache supported USE flags</uri> for more details.
 </p>
 
 <pre caption="Checking USE flag settings and rebuild">
-<comment>(Check the USE-flags and needed updates)</comment>
+<comment>(Check the USE flags and needed updates)</comment>
 # <i>emerge --pretend --verbose --update --newuse --deep apache subversion \
 mod_php mod_bandwidth mod_layout mod_ldap_userdir mod_loopback mod_mp3 \ 
 mod_random mod_throttle mod_watch</i>
@@ -191,7 +256,7 @@
 link="/doc/en/apache-troubleshooting.xml">Apache Troubleshooting Guide</uri>
 and if that doesn't solve the issue, please report it on <uri 
 link="http://bugs.gentoo.org";>Gentoo Bugzilla</uri>. Be sure to include the 
-modules you have enabled and (if you are using Apache 2) what MPM USE-flag you
+modules you have enabled and (if you are using Apache 2) what MPM USE flag you
 compiled with (if any). You may also join <path>#gentoo-apache</path> on 
 <path>irc.freenode.net</path> for support.
 </p>
@@ -200,57 +265,79 @@
 </section>
 </chapter>
 
-<chapter id="use">
-<title>Apache supported USE-flags</title>
+<chapter id="use-pre-2.2.6-r4">
+<title>Supported USE flags in &lt;2.2.6-r4</title>
 <section>
 <body>
 
 
 <p>
-There are USE-flags that are local to apache and its modules. Apache 
-supports several other more generic USE-flags such as <c>ssl</c>, but the 
+There are USE flags that are local to apache and its modules. Apache 
+supports several other more generic USE flags such as <c>ssl</c>, but the 
 effect they have on apache doesn't differ much from the effect is has 
elsewhere,
 so it's not included in this list. Run a <c>emerge --verbose --pretend 
-apache</c> to see the full listing of supported USE-flags.
+apache</c> to see the full listing of supported USE flags.
 </p>
 
 <table>
 <tr>
-  <th>USE-flag</th>
-  <th>Packages</th>
+  <th>USE flag</th>
   <th>Description</th>
 </tr>
 <tr>
   <ti>apache2</ti>
-  <ti>depend.apache eclass (all modules)</ti>
   <ti>
     Should always be set if using the Apache-2.0 line, should not be set if
-    using the Apache-1.3 line. The eclass uses this to determine what version 
-    of apache to depend on.</ti>
+    using the Apache-1.3 line. The eclass uses this to determine what version 
of
+    apache to depend on.
+  </ti>
 </tr>
 <tr>
-  <ti>mpm-leader</ti>
-  <ti>apache-2*</ti>
+  <ti>debug</ti>
   <ti>
-    Builds the <uri    
-    link="http://httpd.apache.org/docs/2.0/mod/leader.html";>leader</uri> 
-    MPM</ti>
+    Enables a hook that allows external modules to plug in and do something
+    after a child crashed. There are already two modules,
+    <c>mod_whatkilledus</c> and <c>mod_backtrace</c> that make use of this
+    hook.
+  </ti>
 </tr>
 <tr>
-  <ti>mpm-metux</ti>
-  <ti>apache-2*</ti>
-  <ti>Builds the <uri link="http://www.metux.de/mpm/";>metux</uri> MPM</ti>
+  <ti>doc</ti>
+  <ti>
+    Install the Apache manual and configuration.
+  </ti>
+</tr>
+<tr>
+  <ti>ldap</ti>
+  <ti>
+    Install <c>mod_ldap</c> and <c>mod_auth_ldap</c>/<c>mod_authnz_ldap</c>.
+  </ti>
+</tr>
+<tr>
+  <ti>ssl</ti>
+  <ti>
+    Installs <c>mod_ssl</c>.
+  </ti>
+</tr>
+<tr>
+  <ti>mpm-itk</ti>
+  <ti>Builds the <uri link="http://mpm-itk.sesse.net/";>itk</uri> MPM</ti>
+</tr>
+<tr>
+  <ti>mpm-leader</ti>
+  <ti>
+    Builds the <uri
+    link="http://httpd.apache.org/docs/2.0/mod/leader.html";>leader</uri> MPM
+  </ti>
 </tr>
 <tr>
   <ti>mpm-peruser</ti>
-  <ti>apache-2*</ti>
   <ti>
     Builds the <uri link="http://www.telana.com/peruser.php";>peruser</uri> MPM
   </ti>
 </tr>
 <tr>
   <ti>mpm-prefork</ti>
-  <ti>apache-2*</ti>
   <ti>
     Builds the <uri    
     link="http://httpd.apache.org/docs/2.0/mod/prefork.html";>prefork</uri> 
@@ -258,66 +345,441 @@
 </tr>
 <tr>
   <ti>mpm-threadpool</ti>
-  <ti>apache-2*</ti>
   <ti>
     Builds the <uri    
     
link="http://httpd.apache.org/docs/2.0/mod/threadpool.html";>threadpool</uri>
-    MPM</ti>
+    MPM
+  </ti>
 </tr>
 <tr>
   <ti>mpm-worker</ti>
-  <ti>apache-2*</ti>
-  <ti>
-    Builds the <uri    
-    link="http://httpd.apache.org/docs/2.0/mod/worker.html";>worker</uri> 
-    MPM</ti>
-</tr>
-<tr>
-  <ti>no-suexec</ti>
-  <ti>apache</ti>
   <ti>
-    Disables building of the suexec module (for those that don't want a 
-    potentially unsafe suid binary on their system)
+    Builds the <uri
+    link="http://httpd.apache.org/docs/2.0/mod/worker.html";>worker</uri> MPM
   </ti>
 </tr>
 <tr>
   <ti>static-modules</ti>
-  <ti>apache</ti>
   <ti>
     Statically links the modules into the apache binary, so that a 
     LoadModule isn't required for loading the base modules into 
     Apache.
   </ti>
 </tr>
+</table>
+
+<note>
+While there are many <c>mpm-*</c> USE flags, they are mutually exclusive. You
+should enable one and only one of the <c>mpm-*</c> USE flags. (If you do not
+enable one, <c>mpm-prefork</c> or <c>mpm-worker</c> will be used, depending on
+if the threads USE flag is set.)
+</note>
+
+</body>
+</section>
+</chapter>
+
+<chapter id="use-2.2.6-r4">
+<title>Supported USE flags in 2.2.6-r4 and above</title>
+<section>
+<body>
+
+<p>
+With the advent of <c>APACHE2_MODULES</c> a general cleanup of USE flags was
+necessary. The following table lists supported USE flags for
+<c>apache-2.2.6-r4</c> and above as well as their equivalent in previous
+versions.
+</p>
+
+<table>
+<tr>
+  <th>USE flag</th>
+  <th>Old USE flag</th>
+  <th>Description</th>
+</tr>
 <tr>
-  <ti>lingerd</ti>
-  <ti>apache-1*</ti>
+  <ti>debug</ti>
+  <ti>debug</ti>
   <ti>
-    Adds support for <uri   
-    link="http://www.iagora.com/about/software/lingerd/";>lingerd</uri>
+    Enables a hook that allows external modules to plug in and do something
+    after a child crashed. There are already two modules,
+    <c>mod_whatkilledus</c> and <c>mod_backtrace</c>, that make use of this
+    hook.
   </ti>
 </tr>
 <tr>
-  <ti>no-htdocs</ti>
-  <ti>gentoo-webroot-default</ti>
+  <ti>doc</ti>
+  <ti>doc</ti>
+  <ti>Install the Apache manual and configuration.</ti>
+</tr>
+<tr>
+  <ti>ldap</ti>
+  <ti>ldap</ti>
+  <ti>Install <c>mod_ldap</c> and <c>mod_authnz_ldap</c></ti>
+</tr>
+<tr>
+  <ti>ssl</ti>
+  <ti>ssl</ti>
+  <ti>Installs <c>mod_ssl</c></ti>
+</tr>
+<tr>
+  <ti>static</ti>
+  <ti>static-modules</ti>
   <ti>
-    Disables installing the default webroot  into 
-    <path>/var/www/localhost</path> so that custom files there are not 
-    overwritten. Instead the webroot is installed into 
-    <path>/usr/share/doc/gentoo-webroot-default-*/webroot/</path>.
+    Statically links the modules into the apache binary, so that a LoadModule
+    isn't required for loading the base modules into Apache
   </ti>
 </tr>
+<tr>
+  <ti>suexec</ti>
+  <ti>no-suexec</ti>
+  <ti>Install <c>mod_suexec</c> and the <c>suexec</c> helper binary</ti>
+</tr>
+<tr>
+  <ti>threads</ti>
+  <ti>threads</ti>
+  <ti>Selects the default MPM if none is set in APACHE2_MPMS</ti>
+</tr>
 </table>
 
-<note>
-While there are many mpm-* USE-flags, they are mutually exclusive. You should 
-enable one and only one of the mpm-* USE-flags. (If you do not enable one, 
-mpm-prefork or mpm-worker will be used, depending on if the threads USE-flag is
-set.)
-</note>
+<p>
+The following table lists supported <c>APACHE2_MPMS</c> as of
+<c>apache-2.2.6-r4</c> and their corresponding previous local USE flag.
+</p>
+
+<table>
+<tr>
+  <th>Flag</th>
+  <th>Old USE flag</th>
+  <th>Description</th>
+</tr>
+<tr>
+  <ti>event</ti>
+  <ti>mpm-event</ti>
+  <ti>An experimental variant of the standard worker MPM</ti>
+</tr>
+<tr>
+  <ti>itk</ti>
+  <ti>mpm-itk</ti>
+  <ti>Allows to run each virtual host under a separate uid and gid</ti>
+</tr>
+<tr>
+  <ti>peruser</ti>
+  <ti>mpm-peruser</ti>
+  <ti>
+    Peruser is a working implementation of the perchild MPM allowing to run 
each
+    apache child process as its own user and group, each handling its own set 
of
+    virtual hosts
+  </ti>
+</tr>
+<tr>
+  <ti>prefork</ti>
+  <ti>mpm-prefork</ti>
+  <ti>Implements a non-threaded, pre-forking web server</ti>
+</tr>
+<tr>
+  <ti>worker</ti>
+  <ti>mpm-worker</ti>
+  <ti>
+    Multi-Processing Module implementing a hybrid multi-threaded multi-process
+    web server
+  </ti>
+</tr>
+</table>
+
+<p>
+The following table lists supported <c>APACHE2_MODULES</c> as of
+<c>apache-2.2.6-r4</c>.
+</p>
+
+<table>
+<tr>
+  <th>Flag</th>
+  <th>Description</th>
+</tr>
+<tr>
+  <ti>actions</ti>
+  <ti>
+    Provides for executing CGI scripts based on media type or request method
+  </ti>
+</tr>
+<tr>
+  <ti>alias</ti>
+  <ti>
+    Provides for mapping different parts of the host filesystem in the
+    document tree and for URL redirection
+  </ti>
+</tr>
+<tr>
+  <ti>asis</ti>
+  <ti>Sends files that contain their own HTTP headers</ti>
+</tr>
+<tr>
+  <ti>auth_basic</ti>
+  <ti>Basic authentication</ti>
+</tr>
+<tr>
+  <ti>auth_digest</ti>
+  <ti>User authentication using MD5 Digest Authentication</ti>
+</tr>
+<tr>
+  <ti>authn_alias</ti>
+  <ti>
+    Provides the ability to create extended authentication providers based on
+    actual providers
+  </ti>
+</tr>
+<tr>
+  <ti>authn_anon</ti>
+  <ti>Allows "anonymous" user access to authenticated areas</ti>
+</tr>
+<tr>
+  <ti>authn_dbd</ti>
+  <ti>User authentication using an SQL database</ti>
+</tr>
+<tr>
+  <ti>authn_dbm</ti>
+  <ti>User authentication using DBM files</ti>
+</tr>
+<tr>
+  <ti>authn_default</ti>
+  <ti>Authentication fallback module</ti>
+</tr>
+<tr>
+  <ti>authn_file</ti>
+  <ti>User authentication using text files</ti>
+</tr>
+<tr>
+  <ti>authz_dbm</ti>
+  <ti>Group authorization using DBM files</ti>
+</tr>
+<tr>
+  <ti>authz_default</ti>
+  <ti>Authorization fallback module</ti>
+</tr>
+<tr>
+  <ti>authz_groupfile</ti>
+  <ti>Group authorization using plaintext files</ti>
+</tr>
+<tr>
+  <ti>authz_host</ti>
+  <ti>Group authorizations based on host (name or IP address)</ti>
+</tr>
+<tr>
+  <ti>authz_owner</ti>
+  <ti>Authorization based on file ownership</ti>
+</tr>
+<tr>
+  <ti>authz_user</ti>
+  <ti>User Authorization</ti>
+</tr>
+<tr>
+  <ti>autoindex</ti>
+  <ti>
+    Generates directory indexes automatically, similar to the Unix <c>ls</c>
+    command
+  </ti>
+</tr>
+<tr>
+  <ti>cache</ti>
+  <ti>Content cache keyed to URIs</ti>
+</tr>
+<tr>
+  <ti>cern_meta</ti>
+  <ti>CERN httpd metafile semantics</ti>
+</tr>
+<tr>
+  <ti>charset_lite</ti>
+  <ti>Specify character set translation or recoding</ti>
+</tr>
+<tr>
+  <ti>dav</ti>
+  <ti>Distributed Authoring and Versioning (WebDAV) functionality</ti>
+</tr>
+<tr>
+  <ti>dav_fs</ti>
+  <ti>filesystem provider for mod_dav</ti>
+</tr>
+<tr>
+  <ti>dav_lock</ti>
+  <ti>generic locking module for mod_dav</ti>
+</tr>
+<tr>
+  <ti>dbd</ti>
+  <ti>Manages SQL database connections</ti>
+</tr>
+<tr>
+  <ti>deflate</ti>
+  <ti>Compress content before it is delivered to the client</ti>
+</tr>
+<tr>
+  <ti>dir</ti>
+  <ti>
+    Provides for "trailing slash" redirects and serving directory index files
+  </ti>
+</tr>
+<tr>
+  <ti>disk_cache</ti>
+  <ti>Content cache storage manager keyed to URIs</ti>
+</tr>
+<tr>
+  <ti>dumpio</ti>
+  <ti>Dumps all I/O to error log as desired</ti>
+</tr>
+<tr>
+  <ti>env</ti>
+  <ti>Modifies the environment which is passed to CGI scripts and SSI 
pages</ti>
+</tr>
+<tr>
+  <ti>expires</ti>
+  <ti>
+    Generation of Expires and Cache-Control HTTP headers according to
+    user-specified criteria
+  </ti>
+</tr>
+<tr>
+  <ti>ext_filter</ti>
+  <ti>
+    Pass the response body through an external program before delivery to the
+    client
+  </ti>
+</tr>
+<tr>
+  <ti>file_cache</ti>
+  <ti>Caches a static list of files in memory</ti>
+</tr>
+<tr>
+  <ti>filter</ti>
+  <ti>Context-sensitive smart filter configuration module</ti>
+</tr>
+<tr>
+  <ti>headers</ti>
+  <ti>Customization of HTTP request and response headers</ti>
+</tr>
+<tr>
+  <ti>ident</ti>
+  <ti>RFC 1413 ident lookups</ti>
+</tr>
+<tr>
+  <ti>imagemap</ti>
+  <ti>Server-side imagemap processing</ti>
+</tr>
+<tr>
+  <ti>include</ti>
+  <ti>Server-parsed html documents (Server Side Includes)</ti>
+</tr>
+<tr>
+  <ti>info</ti>
+  <ti>Provides a comprehensive overview of the server configuration</ti>
+</tr>
+<tr>
+  <ti>log_config</ti>
+  <ti>Logging of the requests made to the server</ti>
+</tr>
+<tr>
+  <ti>log_forensic</ti>
+  <ti>Forensic Logging of the requests made to the server</ti>
+</tr>
+<tr>
+  <ti>logio</ti>
+  <ti>Logging of input and output bytes per request</ti>
+</tr>
+<tr>
+  <ti>mem_cache</ti>
+  <ti>Content cache keyed to URIs</ti>
+</tr>
+<tr>
+  <ti>mime</ti>
+  <ti>
+    Associates the requested filename's extensions with the file's behavior
+    (handlers and filters) and content (mime-type, language, character set and
+    encoding)
+  </ti>
+</tr>
+<tr>
+  <ti>mime_magic</ti>
+  <ti>
+    Determines the MIME type of a file by looking at a few bytes of its
+    contents
+  </ti>
+</tr>
+<tr>
+  <ti>negotiation</ti>
+  <ti>Provides for content negotiation</ti>
+</tr>
+<tr>
+  <ti>proxy</ti>
+  <ti>HTTP/1.1 proxy/gateway server</ti>
+</tr>
+<tr>
+  <ti>proxy_ajp</ti>
+  <ti>AJP support module for mod_proxy</ti>
+</tr>
+<tr>
+  <ti>proxy_balancer</ti>
+  <ti>mod_proxy extension for load balancing</ti>
+</tr>
+<tr>
+  <ti>proxy_connect</ti>
+  <ti>mod_proxy extension for CONNECT request handling</ti>
+</tr>
+<tr>
+  <ti>proxy_ftp</ti>
+  <ti>FTP support module for mod_proxy</ti>
+</tr>
+<tr>
+  <ti>proxy_http</ti>
+  <ti>HTTP support module for mod_proxy</ti>
+</tr>
+<tr>
+  <ti>rewrite</ti>
+  <ti>
+    Provides a rule-based rewriting engine to rewrite requested URLs on the fly
+  </ti>
+</tr>
+<tr>
+  <ti>setenvif</ti>
+  <ti>
+    Allows the setting of environment variables based on characteristics of the
+    request
+  </ti>
+</tr>
+<tr>
+  <ti>speling</ti>
+  <ti>
+    Attempts to correct mistaken URLs that users might have entered by
+    ignoring capitalization and by allowing up to one misspelling
+  </ti>
+</tr>
+<tr>
+  <ti>status</ti>
+  <ti>Provides information on server activity and performance</ti>
+</tr>
+<tr>
+  <ti>unique_id</ti>
+  <ti>
+    Provides an environment variable with a unique identifier for each request
+  </ti>
+</tr>
+<tr>
+  <ti>userdir</ti>
+  <ti>User-specific directories</ti>
+</tr>
+<tr>
+  <ti>usertrack</ti>
+  <ti>Clickstream logging of user activity on a site</ti>
+</tr>
+<tr>
+  <ti>version</ti>
+  <ti>Version dependent configuration</ti>
+</tr>
+<tr>
+  <ti>vhost_alias</ti>
+  <ti>Provides for dynamically configured mass virtual hosting</ti>
+</tr>
+</table>
 
 </body>
 </section>
 </chapter>
-
 </guide>



1.6                  xml/htdocs/doc/en/apache-troubleshooting.xml

file : 
http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/apache-troubleshooting.xml?rev=1.6&view=markup
plain: 
http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/apache-troubleshooting.xml?rev=1.6&content-type=text/plain
diff : 
http://sources.gentoo.org/viewcvs.py/gentoo/xml/htdocs/doc/en/apache-troubleshooting.xml?r1=1.5&r2=1.6

Index: apache-troubleshooting.xml
===================================================================
RCS file: /var/cvsroot/gentoo/xml/htdocs/doc/en/apache-troubleshooting.xml,v
retrieving revision 1.5
retrieving revision 1.6
diff -u -r1.5 -r1.6
--- apache-troubleshooting.xml  11 Oct 2007 20:20:53 -0000      1.5
+++ apache-troubleshooting.xml  29 Nov 2007 08:40:48 -0000      1.6
@@ -1,5 +1,5 @@
 <?xml version='1.0' encoding="UTF-8"?>
-<!-- $Header: 
/var/cvsroot/gentoo/xml/htdocs/doc/en/apache-troubleshooting.xml,v 1.5 
2007/10/11 20:20:53 nightmorph Exp $ -->
+<!-- $Header: 
/var/cvsroot/gentoo/xml/htdocs/doc/en/apache-troubleshooting.xml,v 1.6 
2007/11/29 08:40:48 nightmorph Exp $ -->
 <!DOCTYPE guide SYSTEM "/dtd/guide.dtd">
 
 <guide link="/doc/en/apache-troubleshooting.xml" lang="en">
@@ -14,6 +14,9 @@
 <author title="Contributor">
   <mail link="[EMAIL PROTECTED]">Bryan Østergaard</mail>
 </author>
+<author title="Contributor">
+  <mail link="[EMAIL PROTECTED]">Benedikt Böhm</mail>
+</author>
 
 <abstract>
 This document covers a number of ways to figure out how to fix your Apache 
@@ -24,8 +27,8 @@
 <!-- See http://creativecommons.org/licenses/by-sa/2.5 -->
 <license/>
 
-<version>1.7</version>
-<date>2007-10-11</date>
+<version>1.8</version>
+<date>2007-11-29</date>
 
 <chapter>
 <title>Checking the Logs</title>
@@ -47,7 +50,7 @@
 </section>
 
 <section>
-<title>access_log</title>
+<title>access_log and ssl_access_log</title>
 <body>
 
 <pre caption="access_log">
@@ -103,7 +106,7 @@
 </body>
 </section>
 <section>
-<title>error_log</title>
+<title>error_log and ssl_error_log</title>
 <body>
 
 <pre caption="error_log">
@@ -203,60 +206,11 @@
 </p>
 
 <p>
-There are several options you can add to <c>APACHE2_OPTS</c> that are 
-specified in the default configuration:
+There are several options you can add to <c>APACHE2_OPTS</c> that are specified
+in the default configuration and well explained in
+<path>/etc/conf.d/apache2</path>.
 </p>
 
-<table>
-<tr>
-  <th>Option</th>
-  <th>Result</th>
-</tr>
-<tr>
-  <ti>USERDIR</ti>
-  <ti>
-    Enables user public_html folders to be accessible by 
http://server/~username
-  </ti>
-</tr>
-<tr>
-  <ti>INFO</ti>
-  <ti>
-    Enables the mod_info module, which displays information about the running 
-    server's configuration at http://localhost/server-info
-  </ti>
-</tr>
-<tr>
-  <ti>PROXY</ti>
-  <ti>Enables mod_proxy</ti>
-</tr>
-<tr>
-  <ti>SSL</ti>
-  <ti>
-    Enables SSL/HTTPS support. (Apache must have been compiled with the ssl 
-    USE-flag)
-  </ti>
-</tr>
-<tr>
-  <ti>DAV</ti>
-  <ti>Enables mod_dav, the built-in WebDav module</ti>
-</tr>
-<tr>
-  <ti>DAV_FS</ti>
-  <ti>Enables mod_dav_fs, support for file systems in WebDav</ti>
-</tr>
-<tr>
-  <ti>LDAP</ti>
-  <ti>
-    Enables mod_ldap, which allows Apache to connect to LDAP resources. 
-    (Requires the ldap USE-flag to be enabled)
-  </ti>
-</tr>
-<tr>
-  <ti>AUTH_LDAP</ti>
-  <ti>Enables authentication to resources via a LDAP resource.</ti>
-</tr>
-</table>
-
 <p>
 Documentation for all of the built-in modules can be found in the <uri 
 link="http://httpd.apache.org/docs/2.0/";>Apache 2.0 documentation</uri>.



-- 
[EMAIL PROTECTED] mailing list

Reply via email to