stas 2004/03/01 19:50:10
Modified: src/docs/2.0/api/Apache Filter.pod
Log:
- $f->remove updates
Revision Changes Path
1.8 +15 -7 modperl-docs/src/docs/2.0/api/Apache/Filter.pod
Index: Filter.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/Apache/Filter.pod,v
retrieving revision 1.7
retrieving revision 1.8
diff -u -u -r1.7 -r1.8
--- Filter.pod 14 Jan 2004 09:23:47 -0000 1.7
+++ Filter.pod 2 Mar 2004 03:50:10 -0000 1.8
@@ -197,7 +197,7 @@
=head2 C<remove>
Remove the current filter from the filter chain (for the current
-request).
+request or connection).
$f->remove;
@@ -216,12 +216,20 @@
care of passing the current bucket brigade through unmodified to the
next filter in chain.
-note: calling remove() on the very top connection filter doesn't
-affect the filter chain due to a bug in Apache 2.0.46 and lower (may
-be fixed in 2.0.47). So don't use it with connection filters, till it
-gets fixed in Apache and then make sure to require the minimum Apache
-version if you rely on it.
-
+Note: calling remove() on the very top connection filter doesn't
+affect the filter chain due to a bug in Apache 2.0 (which may be fixed
+in 2.1). So don't use it with connection filters, till it gets fixed
+in Apache and then make sure to require the minimum Apache version if
+you rely on.
+
+Remember that if the connection is
+C<L<$c-E<gt>keepalive|docs::2.0::api::Apache::Connection/C_keepalive_>>)
+and the connection filter is removed, it won't be added untill the
+connection is closed. Which may happen after many HTTP requests. You
+may want to keep the filter in place and pass the data through
+unmodified, by returning C<Apache::DECLINED>. If you need to reset the
+whole or parts of the filter context between requests, use the
+L<technique based on C<$c-E<gt>keepalives>
counting|docs::2.0::user::handler::filters>.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
