From: Rich Bowen <rbowen@apache.org>
Date: Sat, 9 Aug 2008 20:26:31 +0000 (+0000)
Subject: Offer a little more detail in troubleshooting problems with .htaccess
X-Git-Tag: 2.3.0~385
X-Git-Url: https://granicus.if.org/sourcecode?a=commitdiff_plain;h=c5dcd1a4ece4a96411958048c53aa27959d111cf;p=apache

Offer a little more detail in troubleshooting problems with .htaccess
files.


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

diff --git a/docs/manual/howto/htaccess.html.en b/docs/manual/howto/htaccess.html.en
index 52afc1c99f..89dc046b2f 100644
--- a/docs/manual/howto/htaccess.html.en
+++ b/docs/manual/howto/htaccess.html.en
@@ -370,8 +370,28 @@ Options +IncludesNoExec -ExecCGI<br />
     <p>If, on the other hand, you are getting server errors when trying to
     access documents, check your Apache error log. It will likely tell you
     that the directive used in your <code>.htaccess</code> file is not
-    permitted. Alternately, it may tell you that you had a syntax error,
-    which you will then need to fix.</p>
+    permitted.</p>
+
+    <div class="example"><p><code>
+    [Sat Aug 09 16:19:20 2008] [alert] [client 192.168.200.51] /var/www/html/.htaccess: RewriteLog not allowed here
+    </code></p></div>
+
+    <p>This will indicate either that you've used a directive that is
+    never permitted in <code>.htaccess</code> files, or that you simply
+    don't have <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> set to
+    a level sufficient for the directive you've used. Consult the
+    documentation for that particular directive to determine which is
+    the case.</p>
+    
+    <p>Alternately, it may tell you that you had a syntax error in your
+    usage of the directive itself.</p>
+
+    <div class="example"><p><code>
+    [Sat Aug 09 16:22:34 2008] [alert] [client 192.168.200.51] /var/www/html/.htaccess: RewriteCond: bad flag delimiters
+    </code></p></div>
+
+    <p>In this case, the error message should be specific to the
+    particular syntax error that you have committed.</p>
 
 </div></div>
 <div class="bottomlang">
diff --git a/docs/manual/howto/htaccess.xml b/docs/manual/howto/htaccess.xml
index d71a36a074..ccddcc8c1f 100644
--- a/docs/manual/howto/htaccess.xml
+++ b/docs/manual/howto/htaccess.xml
@@ -401,8 +401,28 @@ Options +IncludesNoExec -ExecCGI<br />
     <p>If, on the other hand, you are getting server errors when trying to
     access documents, check your Apache error log. It will likely tell you
     that the directive used in your <code>.htaccess</code> file is not
-    permitted. Alternately, it may tell you that you had a syntax error,
-    which you will then need to fix.</p>
+    permitted.</p>
+
+    <example>
+    [Sat Aug 09 16:19:20 2008] [alert] [client 192.168.200.51] /var/www/html/.htaccess: RewriteLog not allowed here
+    </example>
+
+    <p>This will indicate either that you've used a directive that is
+    never permitted in <code>.htaccess</code> files, or that you simply
+    don't have <directive module="core">AllowOverride</directive> set to
+    a level sufficient for the directive you've used. Consult the
+    documentation for that particular directive to determine which is
+    the case.</p>
+    
+    <p>Alternately, it may tell you that you had a syntax error in your
+    usage of the directive itself.</p>
+
+    <example>
+    [Sat Aug 09 16:22:34 2008] [alert] [client 192.168.200.51] /var/www/html/.htaccess: RewriteCond: bad flag delimiters
+    </example>
+
+    <p>In this case, the error message should be specific to the
+    particular syntax error that you have committed.</p>
 
 </section>