From: Jarkko Hietaniemi Date: Sat, 15 Jul 2000 03:10:40 +0000 (+0000) Subject: perlvms.pod whitespace cleanup to keep pod utils happy. X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=39aca757f075951894687e1a4a61bdac290192fb;p=p5sagit%2Fp5-mst-13.2.git perlvms.pod whitespace cleanup to keep pod utils happy. p4raw-id: //depot/perl@6413 --- diff --git a/vms/perlvms.pod b/vms/perlvms.pod index e6d13f3..17e83e5 100644 --- a/vms/perlvms.pod +++ b/vms/perlvms.pod @@ -122,7 +122,7 @@ I The procedure by which extensions are built and tested creates several levels (at least 4) under the directory in which the extension's source files live. For this reason, you shouldn't nest the source directory -too deeply in your directory structure, lest you eccedd RMS' +too deeply in your directory structure, lest you exceed RMS' maximum of 8 levels of subdirectory in a filespec. (You can use rooted logical names to get another 8 levels of nesting, if you can't place the files near the top of @@ -167,7 +167,7 @@ translates to the full file specification of the shareable image. We have tried to make Perl aware of both VMS-style and Unix- style file specifications wherever possible. You may use either style, or both, on the command line and in scripts, -but you may not combine the two styles within a single fle +but you may not combine the two styles within a single file specification. VMS Perl interprets Unix pathnames in much the same way as the CRTL (I the first component of an absolute path is read as the device name for the @@ -233,7 +233,7 @@ Perl will wait for the subprocess to complete before continuing. =head1 PERL5LIB and PERLLIB -The PERL5LIB and PERLLIB logical names work as documented L, +The PERL5LIB and PERLLIB logical names work as documented in L, except that the element separator is '|' instead of ':'. The directory specifications may use either VMS or Unix syntax. @@ -516,7 +516,7 @@ true, a warning message is printed, and C is returned. =item kill -In most cases, C kill is implemented via the CRTL's C +In most cases, C is implemented via the CRTL's C function, so it will behave according to that function's documentation. If you send a SIGKILL, however, the $DELPRC system service is called directly. This insures that the target @@ -592,7 +592,7 @@ The array returned by the C operator is divided up according to the same rules the CRTL C routine. Therefore, the "system time" elements will always be 0, since there is no difference between "user time" and "system" time -under VMS, and the time accumulated by subprocess may or may +under VMS, and the time accumulated by a subprocess may or may not appear separately in the "child time" field, depending on whether L keeps track of subprocesses separately. Note especially that the VAXCRTL (at least) keeps track only of @@ -604,7 +604,9 @@ or backticks. C will delete the highest version of a file only; in order to delete all versions, you need to say + 1 while (unlink LIST); + You may need to make this change to scripts written for a Unix system which expect that after a call to C, no files with the names passed to C will exist. @@ -644,8 +646,8 @@ time of the file (VMS revision date). =item waitpid PID,FLAGS -If PID is a subprocess started by a piped L, C -will wait for that subprocess, and return its final +If PID is a subprocess started by a piped C (see L), +C will wait for that subprocess, and return its final status value. 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 will check once per second whether @@ -694,7 +696,7 @@ an element of C<%ENV>, the local symbol table is scanned first, followed by the global symbol table.. The characters following C are significant when an element of C<%ENV> is set or deleted: if the complete string is C, the change is made in the local -symbol table, otherwise the global symbol table is changed. +symbol table; otherwise the global symbol table is changed. =item Any other string @@ -751,7 +753,7 @@ copy of Perl knows about the CRTL's C function. (This is present only in some versions of the DECCRTL; check C<$Config{d_setenv}> to see whether your copy of Perl was built with a CRTL that has this function.) - + When an element of C<%ENV> is set to C, the element is looked up as if it were being read, and if it is found, it is deleted. (An item "deleted" from the CRTL C @@ -796,7 +798,7 @@ to logical name tables caused by other programs. You do need to be careful with the logicals representing process-permanent files, such as C and C. The translations for these logicals are prepended with a two-byte binary value (0x1B 0x00) that needs to be -stripped off if you want to use it. (In previous versions of perl it wasn't +stripped off if you want to use it. (In previous versions of Perl it wasn't possible to get the values of these logicals, as the null byte acted as an end-of-string marker) @@ -830,7 +832,7 @@ portably test for successful completion of subprocesses. The low order 8 bits of C<$?> are always 0 under VMS, since the termination status of a process may or may not have been generated by an exception. The next 8 bits are derived from -severity portion of the subprocess' exit status: if the +the severity portion of the subprocess' exit status: if the severity was success or informational, these bits are all 0; otherwise, they contain the severity value shifted left one bit. As a result, C<$?> will always be zero if the subprocess' exit @@ -841,7 +843,7 @@ be found in C<$^S> (q.v.). =item $^S Under VMS, this is the 32-bit VMS status value returned by the -last subprocess to complete. Unlink C<$?>, no manipulation +last subprocess to complete. Unlike C<$?>, no manipulation is done to make this look like a POSIX wait(5) value, so it may be treated as a normal VMS status value.