On Jul 24, 2007, at 9:36 AM, Richard Hubbell wrote:
> Just finished a porting project of a module from
> 1.3->2.2.4 and I found information scattered all over
> and eventually found what I needed. I thought that I
> just didn't have the "right" link or something to the
> docs. I guess my expectations may have been too high.
> It seems like a project like httpd.apache with it's
> millions of users wold have a much more mature set of
> docs. The httpd 2.2.4 doxygen stuff was hosted
> off-site and those were a life-saver. The APR docs
> helped a bunch too. But the docs don't seem to match
> the popularity and ubiquity of the project. Anyone
> disagree? Or have I missed something?
> I will help with docs where I can.
As one who wrote some modules for 1.3 a few years back, and recently
returned to write one for 2.2, I found the documentation to be pretty
weak, and (what's worse) mod_example is simply incorrect; it should
be fixed or removed. If I get some cycles to invest in docs, I'll
start with mod_example on the theory that examples are the best
tutorials.
The saving grace is that the httpd & modules code is generally very
transparent and readable. In every case, when I was puzzled as to
(a) what does apr_furgle_brolly() really do? or (b) how do I
accomplish XXX? I was able to track the answer down by poking around
*.[ch].
Use the Source, Luke. -Tim
|