From f28a6daf331d8f6aa423ec7dc306da75c2aada47 Mon Sep 17 00:00:00 2001
From: Daniel Gruno <humbedooh@apache.org>
Date: Sun, 24 Jun 2012 13:13:10 +0000
Subject: [PATCH] Add a link to sections.html and change the example to
 accomodate suggestions in PR20414.

git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@1353263 13f79535-47bb-0310-9956-ffa450edef68
---
 docs/manual/mod/mod_dir.xml | 27 ++++++++++++++++++---------
 1 file changed, 18 insertions(+), 9 deletions(-)

diff --git a/docs/manual/mod/mod_dir.xml b/docs/manual/mod/mod_dir.xml
index b567507c8fa..f404abab8b9 100644
--- a/docs/manual/mod/mod_dir.xml
+++ b/docs/manual/mod/mod_dir.xml
@@ -103,19 +103,28 @@ a directory</description>
     as well.</p>
 
     <p><strong>Note:</strong> Multiple <directive>DirectoryIndex</directive> 
-    directives within the <em>same context</em> will add to the list of resources to 
-    look for rather than replace:
+    directives within the <a href="../sections.html"><em>same context</em></a> will add 
+    to the list of resources to look for rather than replace:
     </p>
     <highlight language="config">
-# Set the index files to look for
-DirectoryIndex index.html index.htm
+# Example A: Set index.html as an index page, then add index.php to that list as well.
+&lt;Directory /foo&gt;
+    DirectoryIndex index.html
+    DirectoryIndex index.php
+&lt;/Directory&gt;
 
-# This will add dynamic files to the list rather than replace it
-DirectoryIndex index.php index.pl index.lua
+# Example B: This is identical to example A, except it's done with a single directive.
+&lt;Directory /foo&gt;
+    DirectoryIndex index.html index.php
+&lt;/Directory&gt;
 
-# To replace the list, we must first reset it, then set the new list
-DirectoryIndex disabled
-DirectoryIndex index.py
+# Example C: To replace the list, you must explicitly do so:
+# In this example, only index.php will remain as an index resource.
+&lt;Directory /foo&gt;
+    DirectoryIndex index.html
+    DirectoryIndex disabled
+    DirectoryIndex index.php
+&lt;/Directory&gt;
     </highlight>
 
 </usage>
-- 
2.47.3