X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlvar.pod;h=0248fe07192a52de4d495923623b644611b0a4aa;hb=84287afe68eecc4342d7e27aac5d9df9d2412490;hp=c36355ab07ed364284bd62e8782045c19c598d77;hpb=cb1a09d0194fed9b905df7b04a4bc031d354609d;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perlvar.pod b/pod/perlvar.pod index c36355a..0248fe0 100644 --- a/pod/perlvar.pod +++ b/pod/perlvar.pod @@ -102,6 +102,10 @@ test. Note that outside of a C test, this will not happen. (Mnemonic: underline is understood in certain operations.) +=back + +=over 8 + =item $> Contains the subpattern from the corresponding set of parentheses in @@ -176,8 +180,9 @@ Use of "C<$*>" is deprecated in Perl 5. =item $. -The current input line number of the last filehandle that was read. An -explicit close on the filehandle resets the line number. Since +The current input line number for the last file handle from +which you read (or performed a C or on). An +explicit close on a filehandle resets the line number. Since "CE>" never does an explicit close, line numbers increase across ARGV files (but see examples under eof()). Localizing C<$.> has the effect of also localizing Perl's notion of "the last read @@ -214,12 +219,14 @@ delimit line boundaries when quoting poetry.) =item $| If set to nonzero, forces a flush after every write or print on the -currently selected output channel. Default is 0. Note that STDOUT -will typically be line buffered if output is to the terminal and block -buffered otherwise. Setting this variable is useful primarily when you -are outputting to a pipe, such as when you are running a Perl script -under rsh and want to see the output as it's happening. This has no -effect on input buffering. +currently selected output channel. Default is 0 (regardless of whether +the channel is actually buffered by the system or not; C<$|> only tells +you whether you've asked Perl to explicitly flush after each write). +Note that STDOUT will typically be line buffered if output is to the +terminal and block buffered otherwise. Setting this variable is useful +primarily when you are outputting to a pipe, such as when you are running +a Perl script under rsh and want to see the output as it's happening. This +has no effect on input buffering. (Mnemonic: when you want your pipes to be piping hot.) =item output_field_separator HANDLE EXPR @@ -300,9 +307,10 @@ Consider using "real" multi-dimensional arrays in Perl 5. The output format for printed numbers. This variable is a half-hearted attempt to emulate B's OFMT variable. There are times, however, when B and Perl have differing notions of what is in fact -numeric. Also, the initial value is %.20g rather than %.6g, so you -need to set "C<$#>" explicitly to get B's value. (Mnemonic: # is the -number sign.) +numeric. The initial value is %.Ig, where I is the value +of the macro DBL_DIG from your system's F. This is different from +B's default OFMT setting of %.6g, so you need to set "C<$#>" +explicitly to get B's value. (Mnemonic: # is the number sign.) Use of "C<$#>" is deprecated in Perl 5. @@ -409,6 +417,18 @@ to "C<$!>" in order to set I if, for instance, you want "C<$!>" to return string for error I, or you want to set the exit value for the die() operator. (Mnemonic: What just went bang?) +=item $EXTENDED_OS_ERROR + +=item $^E + +More specific information about the last system error than that +provided by C<$!>, if available. (If not, it's just C<$!> again.) +At the moment, this differs from C<$!> only under VMS, where it +provides the VMS status value from the last system error. The +caveats mentioned in the description of C<$!> apply here, too. +(Mnemonic: Extra error explanation.) + + =item $EVAL_ERROR =item $@ @@ -549,6 +569,11 @@ closed before the open() is attempted.) Note that the close-on-exec status of a file descriptor will be decided according to the value of C<$^F> at the time of the open, not the time of the exec. +=item $^H + +The current set of syntax checks enabled by C. See the +documentation of C for more details. + =item $INPLACE_EDIT =item $^I @@ -556,12 +581,20 @@ C<$^F> at the time of the open, not the time of the exec. The current value of the inplace-edit extension. Use C to disable inplace editing. (Mnemonic: value of B<-i> switch.) +=item $OSNAME + +=item $^O + +The name of the operating system under which this copy of Perl was +built, as determined during the configuration process. The value +is identical to C<$Config{'osname'}>. + =item $PERLDB =item $^P The internal flag that the debugger clears so that it doesn't debug -itself. You could conceivable disable debugging yourself by clearing +itself. You could conceivably disable debugging yourself by clearing it. =item $BASETIME @@ -602,7 +635,7 @@ one, since C<$ARGV[0]> is the first argument, I the command name. See The array @INC contains the list of places to look for Perl scripts to be evaluated by the C, C, or C constructs. It initially consists of the arguments to any B<-I> command line switches, -followed by the default Perl library, probably "/usr/local/lib/perl", +followed by the default Perl library, probably F, followed by ".", to represent the current directory. If you need to modify this at runtime, you should use the C pragma in order to also get the machine-dependent library properly loaded: @@ -673,4 +706,3 @@ The __DIE__ handler is explicitly disabled during the call, so that you can die from a __DIE__ handler. Similarly for __WARN__. =back -