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/user/compat compat.pod
Date Fri, 21 Dec 2001 15:24:35 GMT
stas        01/12/21 07:24:35

  Modified:    src/user/compat compat.pod
  Log:
  - document the Configuration Directives that have changed in 2.x
  
  Revision  Changes    Path
  1.4       +69 -5     modperl-docs/src/user/compat/compat.pod
  
  Index: compat.pod
  ===================================================================
  RCS file: /home/cvs/modperl-docs/src/user/compat/compat.pod,v
  retrieving revision 1.3
  retrieving revision 1.4
  diff -u -r1.3 -r1.4
  --- compat.pod	2001/12/21 14:58:43	1.3
  +++ compat.pod	2001/12/21 15:24:35	1.4
  @@ -7,8 +7,8 @@
   mod_perl 2.x is trying hard to be back compatible with mod_perl
   1.x. However some things (mostly APIs) have been changed. In order to
   gain a complete compatibilty with 1.x while running under 2.x, you
  -should build mod_perl with C<MP_COMPAT_1X=1> and simply load the
  -compatibility module:
  +should build mod_perl with C<MP_COMPAT_1X=1> and load the
  +compatibility module as early as possible:
   
     use Apache::compat;
   
  @@ -23,8 +23,62 @@
   This document explains what APIs have changed and what new APIs should
   be used instead.
   
  -=head1 Apache methods
  +=head1 Configuration Directives
   
  +To continue using mod_perl configuration files from 1.x, build
  +mod_perl with C<MP_COMPAT_1X=1>. To migrate the configuration files to
  +the 2.x syntax, you may need to do certain adjustments if you use any
  +of the configuration directives listed in the following sections.
  +
  +Remember that if you use any of the new directives you configuration
  +won't work anymore with mod_perl 1.x.
  +
  +=head2 PerlHandler
  +
  +Replaced with C<PerlResponseHandler>.
  +
  +=head2 PerlSendHeader
  +
  +Replaced with C<PerlOptions +/-ParseHeaders> directive.
  +
  +  PerlSendHeader On  => Options +ParseHeaders
  +  PerlSendHeader Off => Options -ParseHeaders
  +
  +=head2 PerlSetupEnv
  +
  +Replaced with C<PerlOptions +/-SetupEnv> directive.
  +
  +  PerlSendHeader On  => Options +SetupEnv
  +  PerlSendHeader Off => Options -SetupEnv
  +
  +=head2 PerlTaintCheck
  +
  +Now can be turned on with:
  +
  +  PerlSwitches -T
  +
  +The default is I<Off>. You cannot turn it I<Off> once it's turned
  +I<On>.
  +
  +=head2 PerlWarn
  +
  +Now can be turned on with:
  +
  +  PerlSwitches -w
  +
  +
  +
  +
  +
  +=head1 Apache API
  +
  +To continue using Apache API from 1.x, load the compatibility module
  +as early as possible:
  +
  +  use Apache::compat;
  +
  +at the server startup.
  +
   =head2 gensym
   
   Since Perl 5.6.1 filehandlers are autovivified and there is no need
  @@ -34,14 +88,24 @@
   
   The C function modperl_perl_gensym() is available for XS/C extension
   writers, though.
  +
  +=head2 Apache::File
  +
  +
   
  -=head1 Apache::Registry and Apache::PerlRun
  +=head1 Apache::Registry and Apache::PerlRun and Other mod_cgi Emulators
   
  -=head1 Apache::File
  +C<Apache::Registry> and C<Apache::PerlRun> now live in the
  +C<ModPerl::> namespace to avoid collisions with the versions from 1.x.
   
  +META: complete
  +
  +
   =head1 Apache::StatINC
   
   C<Apache::StatINC> has been replaced by C<Apache::Reload>.
  +
  +
   
   =head1 Maintainers
   
  
  
  

---------------------------------------------------------------------
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