From: Jeff Trawick <trawick@apache.org>
Date: Wed, 25 Oct 2000 10:39:04 +0000 (+0000)
Subject: Provide a bit of doc for the hackish^H^H^H^H^H^H^Hwonderful filter
X-Git-Tag: APACHE_2_0_ALPHA_8~246
X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=c19cd1fcbf3574c7c9787c2703bd546a775a8967;p=thirdparty%2Fapache%2Fhttpd.git

Provide a bit of doc for the hackish^H^H^H^H^H^H^Hwonderful filter
types I introduced yesterday.


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

diff --git a/include/util_filter.h b/include/util_filter.h
index 36ef6255bab..b7bce62f2cc 100644
--- a/include/util_filter.h
+++ b/include/util_filter.h
@@ -167,16 +167,28 @@ typedef union ap_filter_func {
  *     These filters are used to alter the content that is passed through
  *     them. Examples are SSI or PHP.
  *
+ * AP_FTYPE_HTTP_HEADER: (XXX somebody rename me or get rid of me please)
+ *     This special type ensures that the HTTP header filter ends up in
+ *     the proper location in the filter chain.
+ *
+ * AP_FTYPE_TRANSCODE:
+ *     These filters implement transport encodings (e.g., chunking).
+ *
  * AP_FTYPE_CONNECTION:
  *     These filters will alter the content, but in ways that are more
- *     strongly associated with the output connection. Examples are
- *     compression, character recoding, or chunked transfer coding.
+ *     strongly associated with the connection.  Examples are splitting
+ *     an HTTP connection into multiple requests and buffering HTTP
+ *     responses across multiple requests.
  *
  *     It is important to note that these types of filters are not allowed
  *     in a sub-request. A sub-requests output can certainly be filtered
  *     by AP_FTYPE_CONTENT filters, but all of the "final processing" is
  *     determined by the main request.
  *
+ * AP_FTYPE_NETWORK:
+ *     These filters don't alter the content.  They are responsible for
+ *     sending/receiving data to/from the client.
+ *
  * The types have a particular sort order, which allows us to insert them
  * into the filter chain in a determistic order. Within a particular grouping,
  * the ordering is equivalent to the order of calls to ap_add_*_filter().