On Wed, 14 Feb 2007, Garrett Rooney wrote:
- Rewrite how Brigades, Buckets and filters work. Possibly replace them
with other models. I haven't been able to personally consolidate my
thoughts on how to 'fix' filters, but I am sure we can plenty of long
threads about it :-)
I think a big part of this should be documenting how filters are
supposed to interact with the rest of the system. Right now it seems
to be very much a "well, I looked at this other module and did what it
did", and it's quite easy to start depending on behavior in the system
that isn't actually documented to work that way.
This hits a rather sweet spot it seems. Browsing the current httpd
module/developer docco I find gems like:
http://httpd.apache.org/docs/2.2/developer/modules.html
One would think that now that 2.2 is released at least the 1.3->2.0
converting docco would have evolved to something better than "it's a
start" ...
Also, we have http://httpd.apache.org/docs/2.2/developer/API.html ...
It seems that the most current API docco is for 1.3, but at least
there's a nice disclaimer telling that it's obsolete but some
information might be correct.
So yes, I fully agree that documentation is needed. It's a pain trying
to figure out how stuff (are supposed to) work when the docco is two
major releases behind...
One problem here is that this kind of docco usually needs to be made
by those who hate to write it: the core programmers.
/Nikke
--
-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
Niklas Edmundsson, Admin @ {acc,hpc2n}.umu.se | [EMAIL PROTECTED]
---------------------------------------------------------------------------
"I should have done this a long time ago." - Picard
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=
