Change 13905 by jhi@alpha on 2001/12/27 13:55:03
Subject: [DOC PATCH] left is right and right is left
From: Philip Newton <[EMAIL PROTECTED]>
Date: Thu, 27 Dec 2001 10:04:17 +0100
Message-ID: <[EMAIL PROTECTED]>
Affected files ...
.... //depot/perl/pod/perlfunc.pod#288 edit
.... //depot/perl/pod/perlport.pod#88 edit
Differences ...
==== //depot/perl/pod/perlfunc.pod#288 (text) ====
Index: perl/pod/perlfunc.pod
--- perl/pod/perlfunc.pod.~1~ Thu Dec 27 07:00:06 2001
+++ perl/pod/perlfunc.pod Thu Dec 27 07:00:06 2001
@@ -5377,7 +5377,7 @@
of C<IO::Handle> on any open handles.
The return value is the exit status of the program as returned by the
-C<wait> call. To get the actual exit value shift left by eight (see below).
+C<wait> call. To get the actual exit value shift right by eight (see below).
See also L</exec>. This is I<not> what you want to use to capture
the output from a command, for that you should use merely backticks or
C<qx//>, as described in L<perlop/"`STRING`">. Return value of -1
@@ -5401,7 +5401,7 @@
$signal_num = $? & 127;
$dumped_core = $? & 128;
-or more portably by using the W*() calls of the POSIX extension,
+or more portably by using the W*() calls of the POSIX extension;
see L<perlport> for more information.
When the arguments get executed via the system shell, results
==== //depot/perl/pod/perlport.pod#88 (text) ====
Index: perl/pod/perlport.pod
--- perl/pod/perlport.pod.~1~ Thu Dec 27 07:00:06 2001
+++ perl/pod/perlport.pod Thu Dec 27 07:00:06 2001
@@ -1780,13 +1780,13 @@
=item system LIST
In general, do not assume the UNIX/POSIX semantics that you can shift
-the C<$?> left by eight to get the exit value, or that C<$? & 127>
+C<$?> right by eight to get the exit value, or that C<$? & 127>
would give you the number of the signal that terminated the program,
or that C<$? & 128> would test true if the program was terminated by a
coredump. Instead, use the POSIX W*() interfaces: for example, use
WIFEXITED($?) an WEXITVALUE($?) to test for a normal exit and the exit
value, and WIFSIGNALED($?) and WTERMSIG($?) for a signal exit and the
-signal. Core dumping is not a portable concept so there's no portable
+signal. Core dumping is not a portable concept, so there's no portable
way to test for that.
Only implemented if ToolServer is installed. (S<Mac OS>)
End of Patch.