looking for good mod_perl documentation -- desperate, out of options

I'm looking for any online documentation of mod_perl that is complete
and generally believed to be error-free. Every source of
documentation I've found has been plagued with so many omissions or
outright mistakes that it has been useless, or worse, almost resulted
in the machine being put into a state that would have left it
irretrievably broken.

For example even the "official" documentation at
http://perl.apache.org/docs/2.0/user/install/install.html
is 16 pages long, and still:
- does not tell you how to tell if you have mod_perl already
installed, so that you can skip all of that
- says mod_perl 1.x goes with apache 1.x and mod_perl 2.x goes with
apache 2.x, but fails to say that mod_perl 1.99 "counts as" a 2.x
version (caused me hours of out-of-my-mind frustration and lost time
last time I attempted this)
- neglects to say that on some systems you can save yourself 16 pages
of grief by just typing "yum install mod_perl"
- says you need a certain version of Apache but does not tell you how
to find which version of Apache you have. (Yes, I know how to do
this, but it's the kind of thing that documentation should include.)

plus many, many other sentences that are useless without some
explanatory note saying "And this is how you do xyz". Most other
sources of advice on mod_perl are even worse, consisting fo a
hodgepodge of comments posted in a forum that are out of date or do
not work for some other reason.

I'm looking for documentation on mod_perl that has the best track
record -- that means the highest percentage of reasonably smart but
not UNIX-headed people who read it and got it to work, and the lowest
percentage of people who read it and got into arguments that ended
with "Well of COURSE you have to do THAT first -- EVERYBODY knows
that!"

Ideally, something that was written by a commercial author, whose
ability to feed themselves and their family was dependent on their
ability to produce documentation that actually worked, and, if they
had published something consisting of the contents of the URL above,
would have been thrown out in the snow and beaten to death with their
own frozen limbs.

Has any documentation ever been written for mod_perl that comes out
positively even when judged on those standards?

.

Relevant Pages

  • Re: Method description thingy...
    ... Redistributable command line tool that easily registers and integrates your component documentation on user's machine during installation. ... it works as it should (unlike free tools). ... Support for generics and partial classes. ... Conditional inclusion of members in resulting documentation, ability to include source code, ability to document namespaces. ...
    (microsoft.public.dotnet.languages.vb)
  • Re: looking for good mod_perl documentation -- desperate, out of options
    ... ability to feed themselves and their family was dependent on their ... ability to produce documentation that actually worked, and, if they ... had published something consisting of the contents of the URL above, ... Has any documentation ever been written for mod_perl that comes out ...
    (comp.lang.perl.modules)
  • Re: Id RTFM if they actually GAVE me a FM!!
    ... "documentation" consists of nothing more than names of variables and methods ... ability to place themselves back in the role of learner, ... package information in ways easily assimilated by those who lack expertise. ... The writer has a mental representation which the reader may not ...
    (alt.comp.lang.borland-delphi)
  • Re: WinCE visible in workgroup/domain
    ... especially without noting it in documentation? ... to share resources you should also put in the ability to be seen. ... it actually is in the documentation, or at least it was I haven't looked ...
    (microsoft.public.windowsce.platbuilder)
  • Technical Writer, AS400. Posting # 9
    ... Expert knowledge of: ... Working knowledge and ability to comprehend ILE RPG, ... Ability to identify business rules effecting screen inputs, data flows, ... maintenance of project and user documentation; ...
    (comp.sys.ibm.as400.misc)