Hi,
following patch adds a new entry to the FAQ's trouble shooting section,
documenting the known problem with large headers, exceeding Apache
httpd's LimitRequestFieldSize setting.
[[[
Document known issue about long header sections causing problems with
Apache httpd.
* docs/faq.html
(Table of Contents): add link to new http-400 section
(http-400): new trouble shooting section about http-400-error
]]]
Regards,
Stefan
Index: faq.html
===================================================================
--- faq.html (revision 1743727)
+++ faq.html (working copy)
@@ -275,6 +275,8 @@
characters do not seem to be working?</a></li>
<li><a href="#dav-slow-copy">Why does an HTTP(S) URL-to-URL copy or
branch/tag operation take a long time?</a></li>
+<li><a href="#http-400">When performing an operation, I get the error:
+ "Unexpected HTTP status 400 'Bad Request' [...]". How can I resolve it?</a></li>
</ul>
<h4>Developer questions:</h4>
@@ -4399,8 +4401,36 @@
</div>
+<div class="h3" id="http-400">
+
+<h3>When performing an operation, I get the error: "Unexpected HTTP status 400
+'Bad Request' [...]". How can I resolve it?
+ <a class="sectionlink" href="#http-400"
+ title="Link to this section">¶</a>
+</h3>
+
+<p>The error can have different causes. In general it points out that there's
+some communication issue between the client and the server.<br />
+Best check the server log to see if that contains further information on what's
+wrong.</p>
+
+<p>For Subversion 1.8.10 to 1.9.3 (including) the issue could have been
+experienced when deleting directories containing multiple locks
+(<a href="https://issues.apache.org/jira/browse/SVN-4557";>issue 4557</a>).
+<br />
+Another manifestation of the same underlying issue is logged as
+<a href="https://issues.apache.org/jira/browse/SVN-4634";>issue 4634</a>.<br />
+In these cases the problem is that the server doesn't process the complete
+http header section which the client sends to the server.<br />
+A possible workaround is to check the server configuration to see if the
+current limit can be changed (for Apache httpd that's the LimitRequestFieldSize
+setting, for instance). Alternatively switching to HTTP/2 should also resolve
+the problem.</p>
+
</div>
+</div>
+
<div class="h2" id="developer-questions">
<h2>Developer questions:
<a class="sectionlink" href="#developer-questions"
