That's actually the reason I didn't recommend starting with mp2 to this guy: the documentation. It's easy for me to look at things and say "oh, this corresponds to the 1.0 docs here", but to a newbie that will sound like insanity. There's a lot more documented than there used to be, and I am in no position to criticize anyone else's efforts, having done very little to contribute to the 2.0 docs at this point, but this is the thing that holds me back from recommending it to newbies.
I think that's true to a point. however, if the user wants to do authentication and goes to the eagle book or cookbook to see how it's done, it's still $r->get_basic_auth_pw and $r->note_basic_auth_failure, whether it's mod_perl 1.0 or 2.0.
the issue is finding them in 2.0 when they used to just be there in 1.0. Apache::porting seems to be a good way to go in this respect, but I haven't tried it myself. but I have tried to do my part
http://www.perl.com/pub/a/2003/04/17/filters.html
tries to explain some of the new classes you need to use(), what they do, and how to go about finding what you need. it's not much, but I hope it helps at least a few get started.
Well, that and concerns about the safety of Perl threads at this point, but that's easy to avoid by using pre-fork.
:)
--Geoff
