perl-modperl-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/api/ModPerl MM.pod
Date Mon, 07 Apr 2003 06:26:23 GMT
stas        2003/04/06 23:26:23

  Modified:    src/docs/2.0/user/install install.pod
               src/docs/2.0/user/config config.pod
               src/docs/2.0/user/compat compat.pod
               src/docs/2.0/api/ModPerl MM.pod
  Log:
  - document the new Makefile.PL option: MP_COMPAT_1X
  - several related updates
  
  Revision  Changes    Path
  1.37      +66 -0     modperl-docs/src/docs/2.0/user/install/install.pod
  
  Index: install.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/install/install.pod,v
  retrieving revision 1.36
  retrieving revision 1.37
  diff -u -r1.36 -r1.37
  --- install.pod	31 Jan 2003 00:32:35 -0000	1.36
  +++ install.pod	7 Apr 2003 06:26:22 -0000	1.37
  @@ -306,6 +306,72 @@
   
   Link with I<libgtop> and enable I<libgtop> reporting.
   
  +=head2 MP_COMPAT_1X
  +
  +C<MP_COMPAT_1X=1> or a lack of it enables several mod_perl 1.0
  +back-compatibility features, which are deprecated in mod_perl
  +2.0. It's enabled by default, but can be disabled with
  +C<MP_COMPAT_1X=0> during the build process.
  +
  +When this option is disabled, the following things will happen:
  +
  +=over
  +
  +=item *
  +
  +Environment variable C<GATEWAY_INTERFACE> will be enabled only if
  +C<PerlOptions +SetupEnv> is enabled and its value would be the
  +default:
  +
  +  CGI/1.1
  +
  +and not:
  +
  +  CGI-Perl/1.1
  +
  +The use of C<$ENV{GATEWAY_INTERFACE}> is deprecated and the existance
  +of C<$ENV{MOD_PERL}> should be checked instead.
  +
  +=item *
  +
  +Deprecated special variable, C<$Apache::__T> won't be available. Use
  +C<${^TAINT}> instead.
  +
  +=item *
  +
  +I<$ServerRoot> and I<$ServerRoot/lib/perl> won't be appended to
  +C<@INC>. Instead use:
  +
  +  PerlSwitches -I/path/to/server -I/path/to/server/lib/perl
  +
  +in I<httpd.conf> or:
  +
  +  use Apache::Server ();
  +  use Apache::ServerUtil ();
  +  use Apache::Process ();
  +  my $pool = Apache->server->process->pool;
  +  push @INC, Apache::server_root_relative($pool, "");
  +  push @INC, Apache::server_root_relative($pool, "lib/perl");
  +
  +in I<startup.pl>.
  +
  +=item *
  +
  +The following deprecated configuration directives won't be recognized
  +by Apache:
  +
  +  PerlSendHeader
  +  PerlSetupEnv
  +  PerlHandler
  +  PerlTaintCheck
  +  PerlWarn
  +
  +Use L<their 2.0
  +equivalents|docs::2.0::user::compat::compat/Configuration_Files_Porting>
  +instead.
  +
  +=back
  +
   =head4 MP_DEBUG
   
   Turn on debugging (C<-g -lperld>) and tracing.
  
  
  
  1.38      +1 -1      modperl-docs/src/docs/2.0/user/config/config.pod
  
  Index: config.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/config/config.pod,v
  retrieving revision 1.37
  retrieving revision 1.38
  diff -u -r1.37 -r1.38
  --- config.pod	6 Mar 2003 06:34:56 -0000	1.37
  +++ config.pod	7 Apr 2003 06:26:23 -0000	1.38
  @@ -220,7 +220,7 @@
   
   =item *
   
  -C<MOD_PERL> and C<GATEWAY_INTERFACE> (always)
  +C<MOD_PERL> (always)
   
   =item *
   
  
  
  
  1.61      +21 -4     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.60
  retrieving revision 1.61
  diff -u -r1.60 -r1.61
  --- compat.pod	13 Mar 2003 22:46:52 -0000	1.60
  +++ compat.pod	7 Apr 2003 06:26:23 -0000	1.61
  @@ -32,8 +32,10 @@
   To migrate the configuration files to the mod_perl 2.0 syntax, you may
   need to do certain adjustments. Several configuration directives are
   deprecated in 2.0, but still available for backwards compatibility
  -with mod_perl 1.0. If you don't need the backwards compatibility
  -consider using the directives that have replaced them.
  +with mod_perl 1.0 unless 2.0 was built with
  +C<L<MP_COMPAT_1X=0|docs::2.0::user::install::install/MP_COMPAT_1X>>. If
  +you don't need the backwards compatibility consider using the
  +directives that have replaced them.
   
   =head2 C<PerlHandler>
   
  @@ -306,8 +308,10 @@
   =head2 C<$ENV{GATEWAY_INTERFACE}>
   
   The environment variable C<$ENV{GATEWAY_INTERFACE}> is deprecated in
  -mod_perl 2.0. Instead use C<$ENV{MOD_PERL}>, which is set to something
  -like this:
  +mod_perl 2.0 (See:
  +C<L<MP_COMPAT_1X=0|docs::2.0::user::install::install/MP_COMPAT_1X>>). Instead
  +use C<$ENV{MOD_PERL}> (available in both mod_perl generations), which
  +is set to something like this:
   
     mod_perl/1.99_03-dev
   
  @@ -437,6 +441,19 @@
   
   instead. See the
   C<L<Apache::Log|docs::2.0::api::Apache::Log>> manpage.
  +
  +
  +
  +
  +=head1 C<Apache::> Variables
  +
  +=head2 C<$Apache::__T>
  +
  +C<$Apache::__T> is deprecated in mod_perl 2.0. Use C<${^TAINT}>
  +instead.
  +
  +
  +
   
   
   =head1 C<Apache::Server::> Methods and Variables
  
  
  
  1.4       +2 -2      modperl-docs/src/docs/2.0/api/ModPerl/MM.pod
  
  Index: MM.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/ModPerl/MM.pod,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- MM.pod	25 Mar 2003 02:24:48 -0000	1.3
  +++ MM.pod	7 Apr 2003 06:26:23 -0000	1.4
  @@ -152,8 +152,8 @@
   
     macro => { MOD_INSTALL => ... }
   
  -arranges for modules to be installed under Apache2 if mod_perl was
  -built with C<MP_INST_APACHE2=1>.
  +arranges for modules to be installed under the subdir I<Apache2/> if
  +mod_perl was built with C<MP_INST_APACHE2=1>.
   
   =head1 Public API
   
  
  
  

Mime
View raw message