perl-docs-cvs mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From s...@apache.org
Subject cvs commit: modperl-docs/src/docs/2.0/user/compat compat.pod
Date Tue, 18 Jun 2002 13:49:21 GMT
stas        2002/06/18 06:49:21

  Modified:    src/docs/2.0/user/compat compat.pod
  Log:
  clarify the issue with Apache2, using explicit examples
  
  Revision  Changes    Path
  1.26      +39 -8     modperl-docs/src/docs/2.0/user/compat/compat.pod
  
  Index: compat.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/compat/compat.pod,v
  retrieving revision 1.25
  retrieving revision 1.26
  diff -u -r1.25 -r1.26
  --- compat.pod	6 Jun 2002 08:54:29 -0000	1.25
  +++ compat.pod	18 Jun 2002 13:49:20 -0000	1.26
  @@ -96,14 +96,6 @@
   at the server startup. And unless there are forgotten things or bugs,
   your code should work without any changes under 2.0 series.
   
  -If you have mod_perl 1.0 and 2.0 installed on the same system and the
  -two use the same perl libraries directories (e.g. I</usr/lib/perl5>),
  -make sure to load first the C<Apache2> module which will perform the
  -necessary adjustments to C<@INC>.
  -
  -  use Apache2; # if you have 1.0 and 2.0 installed
  -  use Apache::compat;
  -
   However, unless you want to keep the 1.0 compatibility, you should try
   to remove the compatibility layer and adjust your code to work under
   2.0 without it. You want to do it mainly for the performance
  @@ -111,6 +103,45 @@
   
   This document explains what APIs have changed and what new APIs should
   be used instead.
  +
  +If you have mod_perl 1.0 and 2.0 installed on the same system and the
  +two use the same perl libraries directory (e.g. I</usr/lib/perl5>), to
  +use mod_perl 2.0 make sure to load first the C<Apache2> module which
  +will perform the necessary adjustments to C<@INC>.
  +
  +  use Apache2; # if you have 1.0 and 2.0 installed
  +  use Apache::compat;
  +
  +So if before loading C<Apache2.pm> the C<@INC> array consisted of:
  +
  +  /home/stas/perl/ithread/lib/5.8.0/i686-linux-thread-multi
  +  /home/stas/perl/ithread/lib/5.8.0
  +  /home/stas/perl/ithread/lib/site_perl/5.8.0/i686-linux-thread-multi
  +  /home/stas/perl/ithread/lib/site_perl/5.8.0
  +  /home/stas/perl/ithread/lib/site_perl
  +  .
  +
  +It will now look as:
  +
  +  /home/stas/perl/ithread/lib/site_perl/5.8.0/i686-linux-thread-multi/Apache2
  +  /home/stas/perl/ithread/lib/5.8.0/i686-linux-thread-multi
  +  /home/stas/perl/ithread/lib/5.8.0
  +  /home/stas/perl/ithread/lib/site_perl/5.8.0/i686-linux-thread-multi
  +  /home/stas/perl/ithread/lib/site_perl/5.8.0
  +  /home/stas/perl/ithread/lib/site_perl
  +  .
  +
  +Notice that a new directory was prepended to the search path, so if
  +for example the code attempts to load C<Apache::RequestRec> and there
  +are two versions of this module undef
  +I</home/stas/perl/ithread/lib/site_perl/>:
  +
  +          5.8.0/i686-linux-thread-multi/Apache/RequestRec.pm
  +  5.8.0/i686-linux-thread-multi/Apache2/Apache/RequestRec.pm
  +
  +The mod_perl 2.0 version will be loaded first, because the directory
  +I<5.8.0/i686-linux-thread-multi/Apache2> is coming before the
  +directory I<5.8.0/i686-linux-thread-multi> in C<@INC>.
   
   
   =head1 The C<Apache::Registry> Family
  
  
  

---------------------------------------------------------------------
To unsubscribe, e-mail: docs-cvs-unsubscribe@perl.apache.org
For additional commands, e-mail: docs-cvs-help@perl.apache.org


Mime
View raw message