It has long frustrated me that there was no mod_perl module
documentation, in the style of the standard Apache module documentation.
I don't mean to bash the docs that are there - clearly, they are of
exceptional quality. But I wanted something like the standard module
docs.

So, rather than complaining, which would seem to be, at best, in poor
taste, given the quantity of stuff that folks like Stas have already
written, I've started on a mod_perl module doc, based on the Apache 2.0
module documentation XML template. You can see the first cut at
http://www.apacheadmin.com/mod_perl.html

I know, it is gravely lacking, and needs help. And I intend to do
something about that. But I have a few questions before I burn a lot of
time on that.

Where, if anywhere, should such a document go? Yeah, it can stay
where it is, but I would not think that anyone would think to look
there.

Has someone already done this, and I'm just missing it? I know that
there is similar information at
http://www.apacheref.com/ref/mod_perl.html but I was hesitant to steal
that wholesale. Besides, everyone should buy Ralf's book, and I don't
want to dilute that in any way. ;-)

Is there currently, or are there any plans for, a mod_perl
documentation cvs repository, where something like this could live?

Anyways, tell me what you think. I have the original XML, which is
vastly more useful than the HTML output, and would be glad to give that
to anyone that wants it.

-- 
CooperMcGregor, Inc.
Apache, Perl, and mod_perl
More #! for your $

Reply via email to