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 mod_filter. Now add the complex interactions that happen in setups involving more than module, or even within a single module (c.f. http://issues.apache.org/bugzilla/show_bug.cgi?id=33499 ) and it's not IMO something that can be documented adequately without extensive self-defeating reference to the code itself. -- Nick Kew
