Add a comment about how http_filter works.

Submitted by:	Graham Leggett <minfrin@sharp.fm>

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

diff --git a/modules/http/http_protocol.c b/modules/http/http_protocol.c
index 9d765249d90c8ae916694219dfb282bda8df4704..6e1298a9da2a514df3adff111a2d8cff5e77a7c4 100644 (file)
--- a/modules/http/http_protocol.c
+++ b/modules/http/http_protocol.c
@@ -575,6 +575,11 @@ apr_status_t ap_http_filter(ap_filter_t *f, apr_bucket_brigade *b, ap_input_mode
             }
 
             if (len) {
+                /* note: this can sometimes insert empty buckets into the
+                 * brigade, or the data might come in a few characters at
+                 * a time - don't assume that one call to apr_bucket_read()
+                 * will return the full string.
+                 */
                 if (f->c->remain < len) {
                     apr_bucket_split(e, f->c->remain);
                     f->c->remain = 0;