httpd-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Joshua Slive <>
Subject Re: Documentation; updating filter.xml
Date Wed, 09 Nov 2005 15:13:51 GMT
Nick Kew wrote:
> OK, I've made an effort at tackling filter.xml, one of the
> documentation todos.  Since it's pretty much a complete
> rewrite, please review before I commit.
> <p>One of the major innovations in Apache 2 was the Filter Chain.

I think this "historical" approach to documentation is a mistake (even 
though I have used it myself at times).  We still have statements in the 
docs about how things differ from apache 1.1, and they look very silly. 
  Just say how things are, and point out changes only where they are 

 >  This is basically
> independent of the request processing axis.</p>

I don't really understand what you mean here.  Perhaps the figure 
explains it, but this statement doesn't really stand on its own.

> <p class="figure">
> <img src="images/filter_arch.gif" width="550" height="379" alt=

Make sure you include a png variant also.

> <p>A limitation of this in Apache 2.0 was that the filter chain
>  lacked flexibility. 

Again, this whole section is framed as history rather than as 
documentation of a current server.  Just say how things are now, and 
point out any crucial changes.

> <p>The Old Way is the only way to configure input filters, and is

I'd call them "simple" and "flexible" or something like that, rather 
than "old" and "new".

>     <p>In addition, the module <module>mod_ext_filter</module> allows
>     for external programs to be defined as filters.</p>

I think you forgot to delete this.


View raw message