A new version of the Guide is out (1.20). It's available from: http://perl.apache.org/guide Comments and contributions are always welcome. Major changes: * I've created a mod_perl_guide package and now it's available from CPAN! So when a new version gets released you just open your CPAN shell and do: % perl -MCPAN -eshell cpan> install mod_perl_guide All the POD sources and build scripts has moved to this distribution, get them from CPAN. In a few hours it'll be available at your favorite CPAN mirrors: The uploaded file Apache-mod_perl_guide-1.20.tar.gz has entered CPAN as file: $CPAN/authors/id/S/ST/STAS/Apache-mod_perl_guide-1.20.tar.gz size: 377761 bytes md5: a708a3eaec195e8df23a66eb1c309eb9 * There is no more PostScript file book style distribution. A better PDF version has replaced it. Note that you can use gv (ghostview) to view pdf files, if you don't have a free acroread installed. Or you can always use 'pdf2ps' utility to convert it back to PS. BTW this release's PDF file consists of 481 Letter format pages. Other changes: * install: rewritten "What Compiler Should Be Used to Build mod_perl?" * performance: added "Measuring the Subroutines Memory Usage" * install: added "using http://localhost/perl-status?hooks" to check what hooks where enabled during the build process. * debug: extended the "Looking inside the server" section with new info about Apache::Status, mod_status and Apache::VMonitor * snippets: added "Emulating the Authentication Mechanism" (Eric Cholet) * troubleshooting: runtime: added "Can't call method "register_cleanup" (CGI.pm)" (Doug, Nick Tonkin) * snippets: added "Setting PerlHandler Based on MIME Type" (Doug) * install: .makepl_args.mod_perl in $HOME, otherwise makepl_args.mod_perl (no leading dot) (Ask Bjoern Hansen) * databases: completed the DBI trace info (Doug Kyle) * modules: added and extended the Apache::Registry{BB|NG} sections (Doug) * config: added "debugging <Perl> sections" (Doug) * modules: added a ref to "Apache::RedirectLogFix" (Doug) * snippets: added "Passing Notes Between mod_perl and other (non-perl) Apache Modules" (David Harris) * snippets: added "mod_rewrite Based On Query String and URI Implemented in Perl" (darren chamberlain) * config: added "Knowing the proxy_pass'ed Connection Type" (Geoff Crawshaw) * perl: the long time ago added regexp section "lifted" from mod_perl_traps.pod was written by David Landgren and I apologize for not stating it here (I didn't know it was David who wrote it). Now everything is in its place. * perl: added a workaround to make FindBin work under mod_perl (Joao Fonseca) * install: "make test troubleshooting": added the 'localhost' entry existance in '/etc/hosts' verification. * debug: explained the confusion about Sys::Signal and SIGALRM (was already solved internally) (Doug) * perl: John Hyland and Kavitha have pointed out a few typos of mine :) * dbm: mentioned DB_File::Lock and Tie::DB_FileLock modules and added a summary of all available dbm lock wrappers ripped of from the DB_File::Lock manpage. (David Harris) * installation: APACHE_PREFIX works only if APACI_ARGS is used (Joe Slag) * databases: fixed sql_escape from My::DB module's example (Yann Kerherv) * databases: starting from Apache::DBI 0.84 Apache::DebugDBI is discarded. (Mike Depot) * debug: added the "PERL_DEBUG=1 Build Option" * debug: added the "PERL_DESTRUCT_LEVEL Environment Variable" (Doug) * databases: updated the DBI wrapper module * install: added to the troubleshooting section the solution to 'PL_perl_destruct_level errors' problem, which happened during the mod_perl build process. * review: Ged W. Haywood was very kind to review and correct the following chapters: frequent, perl, performance (!), scenario (!) * perl: rewritten "Tracing Warnings Reports" section * porting: fixed a bad mistake in the code that prints header only once in the "Generating correct HTTP Headers" section. Added more material about headers as well. * config: added "Options Values Merging" section * config: the chapter was partially rewritten and reorganized * config: completed the "Apache Restarts Twice On Start" section Enjoy! _______________________________________________________________________ Stas Bekman mailto:[EMAIL PROTECTED] http://www.stason.org/stas Perl,CGI,Apache,Linux,Web,Java,PC http://www.stason.org/stas/TULARC perl.apache.org modperl.sourcegarden.org perlmonth.com perl.org single o-> + single o-+ = singlesheaven http://www.singlesheaven.com
