It seems that a lot of people get confused about where they can put

header and footer files, and assume that they *must* be in the same
directory as that being indexed. Just being a little more explicit on
this point, as it seems to come up very frequently.


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

1 files changed, 20 insertions, 5 deletions

diff --git a/docs/manual/mod/mod_autoindex.xml b/docs/manual/mod/mod_autoindex.xml
index 8f4a194439..b24f769765 100644
--- a/docs/manual/mod/mod_autoindex.xml
+++ b/docs/manual/mod/mod_autoindex.xml
@@ -409,15 +409,23 @@ of the index listing</description>
     of the file that will be inserted at the top of the index
     listing. <em>Filename</em> is the name of the file to include.</p>
 
-<example><title>Example</title>
-HeaderName HEADER.html
-</example>
+    <example><title>Example</title>
+    HeaderName HEADER.html
+    </example>
 
 <note>
       <p>Both HeaderName and <directive
       module="mod_autoindex">ReadmeName</directive> now treat
       <em>Filename</em> as a URI path relative to the one used to
-      access the directory being indexed. <em>Filename</em> must
+      access the directory being indexed. If <em>Filename</em> begins
+      with a slash, it will be taken to be relative to the <directive
+      module="core">DocumentRoot</directive>.</p>
+
+      <example><title>Example</title>
+      HeaderName /include/HEADER.html
+      </example>
+      
+      <p><em>Filename</em> must
       resolve to a document with a major content type of
       "<code>text/*</code>" (<em>e.g.</em>, <code>text/html</code>,
       <code>text/plain</code>, <em>etc.</em>). This means that
@@ -839,12 +847,19 @@ of the index listing</description>
     <p>The <directive>ReadmeName</directive> directive sets the name
     of the file that will be appended to the end of the index
     listing. <em>Filename</em> is the name of the file to include, and
-    is taken to be relative to the location being indexed.</p>
+    is taken to be relative to the location being indexed. If
+    <em>Filename</em> begins with a slash, it will be taken to be
+    relative to the <directive module="core">DocumentRoot</directive>.
+    </p>
 
     <example><title>Example</title>
     ReadmeName FOOTER.html
     </example>
 
+    <example><title>Example 2</title>
+    ReadmeName /include/FOOTER.html
+    </example>
+
     <p>See also <directive
     module="mod_autoindex">HeaderName</directive>, where this behavior
     is described in greater detail.</p>