From e004bab8f6d319d04837f6125c16794a70ad00f6 Mon Sep 17 00:00:00 2001 From: Nick Kew Date: Wed, 26 Oct 2005 10:03:13 +0000 Subject: [PATCH] Update mod_filter docs to mention API functions and promote out of experimental. git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@328616 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/mod/mod_filter.html.en | 14 +++++++------- docs/manual/mod/mod_filter.xml | 12 ++++++++++-- 2 files changed, 17 insertions(+), 9 deletions(-) diff --git a/docs/manual/mod/mod_filter.html.en b/docs/manual/mod/mod_filter.html.en index d93af66ea4..fb30f25de4 100644 --- a/docs/manual/mod/mod_filter.html.en +++ b/docs/manual/mod/mod_filter.html.en @@ -24,7 +24,7 @@

Available Languages:  en 

- +
Description:Context-sensitive smart filter configuration module
Status:Experimental
Status:Base
Module Identifier:filter_module
Source File:mod_filter.c
Compatibility:Version 2.1 and higher
@@ -233,7 +233,7 @@ Syntax:FilterChain [+=-@!]filter-name ... Context:server config, virtual host, directory, .htaccess Override:Options -Status:Experimental +Status:Base Module:mod_filter

This configures an actual filter chain, from declared filters. @@ -269,7 +269,7 @@ Syntax:FilterDeclare filter-name [type] Context:server config, virtual host, directory, .htaccess Override:Options -Status:Experimental +Status:Base Module:mod_filter

This directive declares an output filter together with a @@ -294,7 +294,7 @@ proto-flags Context:server config, virtual host, directory, .htaccess Override:Options -Status:Experimental +Status:Base Module:mod_filter

This directs mod_filter to deal with ensuring the @@ -343,7 +343,7 @@ [req|resp|env]=dispatch match Context:server config, virtual host, directory, .htaccess Override:Options -Status:Experimental +Status:Base Module:mod_filter

This directive registers a provider for the smart filter. @@ -399,7 +399,7 @@ mod_filter Syntax:FilterTrace filter-name level Context:server config, virtual host, directory -Status:Experimental +Status:Base Module:mod_filter

This directive generates debug information from @@ -432,4 +432,4 @@

- \ No newline at end of file + diff --git a/docs/manual/mod/mod_filter.xml b/docs/manual/mod/mod_filter.xml index f5982e9be3..4466b06c53 100644 --- a/docs/manual/mod/mod_filter.xml +++ b/docs/manual/mod/mod_filter.xml @@ -24,7 +24,7 @@ mod_filter Context-sensitive smart filter configuration module -Experimental +Base mod_filter.c filter_module Version 2.1 and higher @@ -207,13 +207,21 @@ details of filter implementation, reducing the complexity required of content filter modules. This is work-in-progress; the FilterProtocol implements - some of this functionality, but there are no API calls yet.

+ some of this functionality for back-compatibility with Apache 2.0 + modules. For httpd 2.1 and up, the + ap_register_output_filter_protocol and + ap_filter_protocol API enables filter modules to + declare their own behaviour.

At the same time, mod_filter should not interfere with a filter that wants to handle all aspects of the protocol. By default (i.e. in the absence of any FilterProtocol directives), mod_filter will leave the headers untouched.

+ +

At the time of writing, this feature is largely untested, + as modules in common use are designed to work with 2.0. + Modules using it should test it carefully.

-- 2.40.0