Update logging docs

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

diff --git a/webapps/docs/logging.xml b/webapps/docs/logging.xml
index b9be2a4..3b01343 100644 (file)
--- a/webapps/docs/logging.xml
+++ b/webapps/docs/logging.xml
@@ -128,11 +128,13 @@
       boolean value.</li>
       <li>The root logger can define its set of handlers using a
       <code>.handlers</code> property.</li>
-      <li>Logging is buffered using a default buffer size of 0 bytes.
-      To change bufferSize, use the <code>bufferSize</code> property of a handler.
-      The value of <code>0</code> uses system default buffering.
-      The value of <code>&lt;0</code> forces a writer flush upon each log write.
-      A value <code>&gt;0</code> uses a BufferedOutputStream with the defined value.</li>
+      <li>Logging is not buffered by default. To configure buffering, use the
+      <code>bufferSize</code> property of a handler. A value of <code>0</code>
+      uses system default buffering (typically an 8K buffer will be used). A
+      value of <code>&lt;0</code> forces a writer flush upon each log write. A
+      value <code>&gt;0</code> uses a BufferedOutputStream with the defined
+      value but note that the system default buffering will also be
+      applied.</li>
       <li>System property replacement is performed for property values which
       contain ${systemPropertyName}.</li>
     </ul>