httpd-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Nick Kew <>
Subject Re: Removing AddOutputFilterByType
Date Tue, 21 Jun 2005 09:59:36 GMT
On Tuesday 21 June 2005 06:10, Astrid Ke├čler wrote:
> at Montag, 20. Juni 2005, Nick Kew wrote:
> > Hmmm.  Is it better to have a UI that's openly a little more complex but
> > works as documented, or one that appears simple but has lots of
> > gotchas lurking in ambush?  I guess that's an argument for mod_filter
> > implementing AddOutputFilterByType.
> First, it's an argument to improve the docs ;)

Not sure about that.  Full documentation for AddOutputFilterByType could 
become quite mindboggling.

The gotcha that generates most questions is "doesn't work at all in [various
situations, notably a proxy]".  ISTR that *is* documented somewhere, but
people don't notice because it's unintuitive.

Add the *ordering* issue (always comes *after* filters configured with other
directives), and it's already more complex to get the mind around than 

Now add the complex interactions that happen in setups involving more than
module, or even within a single module (c.f. )
and it's not IMO something that can be documented adequately without extensive
self-defeating reference to the code itself.

Nick Kew

View raw message