From: Stefan Fritsch <sf@apache.org>
Date: Fri, 8 Oct 2010 19:17:40 +0000 (+0000)
Subject: backport r1005973:
X-Git-Tag: 2.2.17~7
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=a7f1f4963f4a9eac9cd4a26e159607802cdb1a9b;p=thirdparty%2Fapache%2Fhttpd.git

backport r1005973:
Mention that the required ThreadStackSize depends on the modules loaded.
Instead of recommending a value, recommend not to reduce it unless necessary.


git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.2.x@1005975 13f79535-47bb-0310-9956-ffa450edef68
---

diff --git a/docs/manual/mod/mpm_common.xml b/docs/manual/mod/mpm_common.xml
index 7da9bf4beef..4967d317117 100644
--- a/docs/manual/mod/mpm_common.xml
+++ b/docs/manual/mod/mpm_common.xml
@@ -898,11 +898,15 @@ client connections</description>
       of adjustment should only be made in a test environment which allows
       the full set of web server processing can be exercised, as there
       may be infrequent requests which require more stack to process.
-      A change in the web server configuration can invalidate the
-      current <directive>ThreadStackSize</directive> setting.
-      On some platforms (including Linux), a setting of 128000 is known to
-      cause crashes. A value of at least 204800 is recommended.</li>
+      The minumum required stack size strongly depends on the modules
+      used, but any change in the web server configuration can invalidate
+      the current <directive>ThreadStackSize</directive> setting.</li>
     </ul>
+
+    <note>It is recommended to not reduce <directive>ThreadStackSize</directive>
+    unless a high number of threads per child process is needed. On some
+    platforms (including Linux), a setting of 128000 is already too low and
+    causes crashes with some common modules.</note>
 </usage>
 </directivesynopsis>