stas 2004/03/10 13:44:13
Modified: src/docs/2.0/user/porting compat.pod
src/docs/2.0/api/ModPerl Util.pod
Log:
correct the exit entry docs
Revision Changes Path
1.45 +5 -6 modperl-docs/src/docs/2.0/user/porting/compat.pod
Index: compat.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/2.0/user/porting/compat.pod,v
retrieving revision 1.44
retrieving revision 1.45
diff -u -u -r1.44 -r1.45
--- compat.pod 3 Mar 2004 23:37:20 -0000 1.44
+++ compat.pod 10 Mar 2004 21:44:12 -0000 1.45
@@ -628,15 +628,14 @@
C<Apache-E<gt>httpd_conf> is avalable via
C<L<Apache::compat|docs::2.0::api::Apache::compat>>.
+
+
=head2 C<Apache::exit()>
-C<Apache::exit()> has been replaced with C<ModPerl::Util::exit()>,
-which is a function (not a method) and accepts a single optional
-argument: status, whose default is 0 (== do nothing).
+C<Apache::exit()> has been replaced with
+C<L<ModPerl::Util::exit()|docs::2.0::api::ModPerl::Util/C_exit_>>.
+
-See the
-C<L<ModPerl::Util|docs::2.0::api::ModPerl::Util>>
-manpage.
=head2 C<Apache::gensym()>
1.5 +12 -4 modperl-docs/src/docs/2.0/api/ModPerl/Util.pod
Index: Util.pod
===================================================================
RCS file: /home/cvs/modperl-docs/src/docs/2.0/api/ModPerl/Util.pod,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -u -r1.4 -r1.5
--- Util.pod 13 Jan 2004 20:39:05 -0000 1.4
+++ Util.pod 10 Mar 2004 21:44:12 -0000 1.5
@@ -69,8 +69,8 @@
=head2 C<exit>
-Used internally to replace C<CORE::exit> and terminate the request,
-not the current process.
+Terminate the request, but not the current process (with threaded
+Perls not the current Perl interpreter).
ModPerl::Util::exit($status);
@@ -78,13 +78,21 @@
=item opt arg1: C<$status> (integer)
-The exit status, similar to C<CORE::exit>. If not passed, the default
-value of 0 is used.
+The exit status, which as of this writing is ignored.
=item ret: no return value
+=item since: 1.99_10
+
=back
+Normally you will use the plain C<exit()> in your code. You don't need
+to use C<ModPerl::Util::exit> explicitly, since mod_perl overrides
+C<exit()> by setting C<CORE::GLOBAL::exit> to
+C<ModPerl::Util::exit>. Only if you redefine C<CORE::GLOBAL::exit>
+once mod_perl is running, you may want to use this function.
+
+The original C<exit()> is still available via C<CORE::exit()>.
---------------------------------------------------------------------
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
