At 6:05 PM +0000 4/28/02, Peter Prymmer wrote:
>
>I have very little time to discuss this: makes perlvms.pod podchecker
>clean (by removing the < and > from the email addresses) and adds a
>discussion of PERL_MBX_SIZE.
>
>Does this look OK?
I would suggest this on top of yours, which I hope clarifies the PERL_MBX_SIZE
situation a bit and also brings the waitpid discussion more in line with current
reality.
--- vms/perlvms.pod;-1 Sun Apr 28 13:38:33 2002
+++ vms/perlvms.pod Sun Apr 28 14:14:06 2002
@@ -231,17 +231,18 @@
Perl will wait for the subprocess to complete before continuing.
The mailbox (MBX) that perl can create to communicate with a pipe
-defaults to a record size of 512. The default record size is
-adujustable via the logical name PERL_MBX_SIZE provided that the
+defaults to a buffer size of 512. The default buffer size is
+adjustable via the logical name PERL_MBX_SIZE provided that the
value falls between 128 and the SYSGEN parameter MAXBUF inclusive.
For example, to double the MBX size from the default within
a Perl program use C<$ENV{'PERL_MBX_SIZE'} == 1024;> and then
open and use pipe constructs. An alternative would be to issue
the command:
- $ Define PERL_MBX_SIZE "1024"
+ $ Define PERL_MBX_SIZE 1024
-before running your wide record pipe program.
+before running your pipe program. A larger value may improve
+performance at the expense of BYTLM quota.
=head1 PERL5LIB and PERLLIB
@@ -681,17 +682,12 @@
=item waitpid PID,FLAGS
If PID is a subprocess started by a piped C<open()> (see L<open>),
-C<waitpid> will wait for that subprocess, and return its final
-status value in C<$?>. If PID is a subprocess created in some other
-way (e.g. SPAWNed before Perl was invoked), or is not a subprocess
-of the current process, C<waitpid> will attempt to read from the
-process's termination mailbox, making the final status available in
-C<$?> when the process completes. If the process specified by PID
-has no termination mailbox, C<waitpid> will simply check once per
-second whether the process has completed, and return when it has.
-(If PID specifies a process that isn't a subprocess of the current
-process, and you invoked Perl with the C<-w> switch, a warning will
-be issued.)
+C<waitpid> will wait for that subprocess, and return its final status
+value in C<$?>. If PID is a subprocess created in some other way (e.g.
+SPAWNed before Perl was invoked), C<waitpid> will simply check once per
+second whether the process has completed, and return when it has. (If
+PID specifies a process that isn't a subprocess of the current process,
+and you invoked Perl with the C<-w> switch, a warning will be issued.)
Returns PID on success, -1 on error. The FLAGS argument is ignored
in all cases.
[end of patch]
--
____________________________________________
Craig A. Berry
mailto:[EMAIL PROTECTED]
"Literary critics usually know what they're
talking about. Even if they're wrong."
-- Perl creator Larry Wall
