apache log file documentation unclear (fwd)

[Rob Hartill <ro...@imdb.com>]

The request below makes sense. He's talking about
htdocs/manual/mod/mod_log_config.html, but it needs to be applied to
the source code comments too:

Index: mod_log_config.c
===================================================================
RCS file: /export/home/cvs/apache/src/mod_log_config.c,v
retrieving revision 1.5
diff -u -r1.5 mod_log_config.c
--- mod_log_config.c    1997/01/16 18:22:32     1.5
+++ mod_log_config.c    1997/01/17 21:58:16
@@ -109,7 +109,7 @@
  * literal characters copied into the log files, and '%' directives as
  * follows:
  *
- * %...b:  bytes sent.
+ * %...b:  bytes sent (excluding HTTP headers)
  * %...f:  filename
  * %...h:  remote host
  * %...{Foobar}i:  The contents of Foobar: header line(s) in the request



---------- Forwarded message ----------
Date: Fri, 17 Jan 1997 16:18:59 -0500
From: David J MacKenzie <dj...@va.pubnix.com>
To: apache-bugs@apache.org
Cc: djm@va.pubnix.com
Subject: apache log file documentation unclear

In http://www.apache.org/docs/mod/mod_log_config.html
it says in the common log format description:

bytes 
      The number of bytes in the object returned to the client, not
including any headers.

and in the custom log formats section:

%...b:          Bytes sent.

This should make explicit that it's the number of bytes *sent* to the
client, which can be up to 8k more than the number of bytes *received*
by the client.  Some of our customers have wondered exactly what this
number is when trying to interpret their log files.  The documentation
for analog reportedly accuses web servers of putting inaccurate byte
counts in their log files--apparently the analog author assumes that
the number is supposed to be the number of bytes received by the
client, so clarifying what it's actually intended to be might help.

I know this is a small point, but it took me some groveling around in
the source code to come up with the answer.