doc: fix client_timeout documentation in yahns_config

The default value was incorrect, also expand on common reasons
why it should be tweaked.

1 files changed, 7 insertions, 1 deletions

diff --git a/Documentation/yahns_config.txt b/Documentation/yahns_config.txt
index b49617b..049e305 100644
--- a/Documentation/yahns_config.txt
+++ b/Documentation/yahns_config.txt
@@ -216,7 +216,13 @@ Ruby it is running under.
     time a worker thread will wait synchronously for a client socket
     to become writable.
 
-    Default: 5 (seconds)
+    It makes sense to lower this to a low value (e.g. 5 seconds) if
+    either output or input buffering are disabled.  The default value
+    of 15 seconds is suitable for configurations with both input and
+    output buffering enabled and assumes all application dispatch
+    finishes in less than 15 seconds.
+
+    Default: 15 (seconds)
 
 * errors {IO|PATHNAME}