Re: RegistryNG docs?

[Perrin Harkins]

Ken Williams wrote:
> 
> The only thing keeping RegistryNG from being the main version of Registry
> (which it will be in the future) is that it hasn't been tested enough by people
> like you.  So go for it!  It's probably going to be a much cleaner way to
> proceed than mucking around in Registry.

You know, I tried RegistryBB (which is a subclass of RegistryNG).  I was
seeing the call to Apache::constants::OPT_EXECCGI at the top of my DProf
output, and I wanted to get rid of it.  Unfortunately, RegistryBB was
actually slower for my app than the normal Registry.  Maybe that's not
typical, but for me the overhead of the method call seemed to erase any
savings from not stat-ing files, etc.
- Perrin

ANNOUNCE: mod_perl Guide ver 1.18

[Stas Bekman]

ver. 1.18 of mod_perl Guide is online.

Read it at http://perl.apache.org/guide/

=> Lots of new stuff, please review. 

=> Notice a complete rewrite of install and debug sections.

CHANGES:

* An almost complete rewrite of debug.pod:

(Integrated Doug's debugging article at perlmonth.com)

  Curing The "Internal Server Error" 
  Helping error_log to Help Us 
  The Importance of Warnings 
  diagnostics pragma 
  Monitoring the error_log file 
  Hanging processes: Detection and Diagnostics 
  An Example of the Code that Might Hang the Process 
  Detecting hanging processes 
  Determination of the reason 
  Handling the 'User pressed Stop button' case 
  Detecting Aborted Connections 
  The Importance of Cleanup Code 
   Critical Section 
   Safe Resource Locking 
   Cleanup Code 
  Handling the server timeout cases and working with $SIG{ALRM} 
  Watching the server 
  Configuration 
  Usage 
  Compiled Registry Scripts section seems to be empty. 
  Sometimes script works, sometimes does not 
  Code Debug 
  Locating and correcting Syntax Errors 
  Using Apache::FakeRequest to Debug Apache Perl Modules 
  Finding the Line Number the Error/Warning has been Triggered at 
  Using print() Function for Debugging 
  The Importance of Good Coding Style and Conciseness 
  Introduction into Perl Debugger 
  Interactive Perl Debugging under mod_cgi 
  Non-Interactive Perl Debugging under mod_perl 
  Interactive Perl Debugging under mod_perl 
  Interactive Perl Debugging under mod_perl and ptkdb 
  Debugging core Dumping Code 
  Apache::Debug 
  Debugging Core Dumps 
  Debug Tracing 
  gdb says there are no debugging symbols 
  Debugging Signal Handlers ($SIG{FOO}) 
  Code Profiling 
  Devel::Peek 
  How can I find if my mod_perl scripts have memory leaks 
  Debugging your code in Single Server Mode 

* A complete rewrite of install.pod:

(Integrated the INSTALL.* docs from the mod_perl distribution)

  Installing mod_perl in 10 Minutes and 10 Command Lines 
  The Gory Details 
  Sources Configuration (perl Makefile.PL ...) 
   Configuration parameters 
   APACHE_SRC 
   DO_HTTPD, NO_HTTPD, PREP_HTTPD 
   Callback Hooks 
   EVERYTHING 
   PERL_TRACE 
   APACHE_HEADER_INSTALL 
   PERL_STATIC_EXTS 
   PERL_MARK_WHERE 
   APACHE_PREFIX 
   APACI_ARGS 
   Reusing Configuration Parameters 
   Discovering whether some option was configured 
   Using an alternative Configuration file 
  mod_perl Building (make) 
   make Troubleshooting 
   undefined reference to 'Perl_newAV' 
  Built Server Testing (make test) 
   Manual Testing 
   make test Troubleshooting 
   make test fails 
   mod_perl.c is incompatible with this version of apache 
   make test..skipping test on this platform 
  Installation (make install) 
  Building Apache and mod_perl by Hand 
  Installation Scenarios for Standalone mod_perl 
  The All-In-One Way 
  The Flexible Way 
  Build mod_perl as DSO inside Apache source tree via APACI 
  Build mod_perl as DSO outside Apache source tree via APXS 
  Installation Scenarios for mod_perl and Other Components 
  mod_perl and mod_ssl (+openssl) 
  mod_perl and mod_ssl Rolled from RPMs 
  mod_perl and apache-ssl (+openssl) 
  mod_perl and Stronghold 
   Note For Solaris 2.5 users 
  mod_perl Installation with CPAN.pm's Interactive Shell 
  Installing on multiple machines 
  using RPM, DEB and other packages to install mod_perl 
  A word on mod_perl RPM packages 
  Getting Started 
  Compiling RPM source files 
  Mix and Match RPM and source 
  Installing a single apache+mod_perl RPM 
  Compiling libapreq (Apache::Request) with the RH 6.0 mod_perl RPM 
  Installing separate Apache and mod_perl RPMs 
  Testing the mod_perl API 
  Installation Without Superuser Privileges 
  Installing Perl Modules into a Directory of Choice 
  Making Your Scripts Find the Locally Installed Modules 
  CPAN.pm Shell and Locally Installed Modules 
  Making a Local Apache Installation 
  Actual Local mod_perl Enabled Apache Installation 
  Local mod_perl Enabled Apache Installation with CPAN.pm 
  Automating installation 
  How can I tell whether mod_perl is running 
  Testing by checking the error_log file 
  Testing by viewing /perl-status 
  Testing via telnet 
  Testing via a CGI script 
  Testing via lwp-request 
  General Notes 
  Should I rebuild mod_perl if I have upgraded my perl? 
  Perl installation requirements 
  mod_auth_dbm nuances 
  Stripping apache to make it almost perl-server 
  Saving the config.status Files with mod_perl, php, ssl and Oth