stas01/12/21 07:24:35
Modified:src/user/compat compat.pod
Log:
- document the Configuration Directives that have changed in 2.x
Revision ChangesPath
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.pod2001/12/21 14:58:43 1.3
+++ compat.pod2001/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 CMP_COMPAT_1X=1 and simply load the
-compatibility module:
+should build mod_perl with CMP_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 CMP_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 CPerlResponseHandler.
+
+=head2 PerlSendHeader
+
+Replaced with CPerlOptions +/-ParseHeaders directive.
+
+ PerlSendHeader On = Options +ParseHeaders
+ PerlSendHeader Off = Options -ParseHeaders
+
+=head2 PerlSetupEnv
+
+Replaced with CPerlOptions +/-SetupEnv directive.
+
+ PerlSendHeader On = Options +SetupEnv
+ PerlSendHeader Off = Options -SetupEnv
+
+=head2 PerlTaintCheck
+
+Now can be turned on with:
+
+ PerlSwitches -T
+
+The default is IOff. You cannot turn it IOff once it's turned
+IOn.
+
+=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
+CApache::Registry and CApache::PerlRun now live in the
+CModPerl:: namespace to avoid collisions with the versions from 1.x.
+META: complete
+
+
=head1 Apache::StatINC
CApache::StatINC has been replaced by CApache::Reload.
+
+
=head1 Maintainers
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]