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
important.
> 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.
Joshua.
