Index: install.txt
===================================================================
--- install.txt	(revision 5493)
+++ install.txt	(working copy)
@@ -105,26 +105,28 @@
 =======================
 
 Installation instructions are slightly different depending on whether you're
-using the latest official version or the latest development version.
+installing a distribution-specific package, downloading the the latest official
+release, or fetching the latest development version.
 
-It's easy either way.
+Installing a distribution-specific package
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
+Check the `distribution specific notes`_ to see if your
+platform/distribution provides official Django packages/installers.
+Distribution-provided packages will typically allow for automatic
+installation of dependancies and easy upgrade paths.
+
 Installing the official version
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-    1. Check the `distribution specific notes`_ to see if your
-       platform/distribution provides official Django packages/installers.
-       Distribution-provided packages will typically allow for automatic
-       installation of dependancies and easy upgrade paths.
+    1. Download the latest release from our `download page`_.
 
-    2. Download the latest release from our `download page`_.
+    2. Untar the downloaded file (e.g. ``tar xzvf Django-NNN.tar.gz``).
 
-    3. Untar the downloaded file (e.g. ``tar xzvf Django-NNN.tar.gz``).
+    3. Change into the downloaded directory (e.g. ``cd Django-NNN``).
 
-    4. Change into the downloaded directory (e.g. ``cd Django-NNN``).
+    4. Run ``sudo python setup.py install``.
 
-    5. Run ``sudo python setup.py install``.
-
 The command will install Django in your Python installation's ``site-packages``
 directory.
 
Index: apache_auth.txt
===================================================================
--- apache_auth.txt	(revision 5493)
+++ apache_auth.txt	(working copy)
@@ -29,6 +29,24 @@
         PythonAuthenHandler django.contrib.auth.handlers.modpython
     </Location>
 
+Note: If you're using Apache 2.2 or later, you'll also need to insert directives
+to prevent Apache from using other available auth modules. The full list of
+such modules is:
+
+    AuthBasicAuthoritative
+    AuthDefaultAuthoritative
+    AuthzLDAPAuthoritative
+    AuthzDBMAuthoritative
+    AuthzDefaultAuthoritative
+    AuthzGroupFileAuthoritative
+    AuthzOwnerAuthoritative
+    AuthzUserAuthoritative
+
+To tell Apache not to use a particular module, add a line for each of your   
+installed auth modules to your Apache configuration, like this:
+
+    AuthBasicAuthoritative Off
+
 By default, the authentication handler will limit access to the ``/example/``
 location to users marked as staff members.  You can use a set of
 ``PythonOption`` directives to modify this behavior: