X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlfunc.pod;h=c1efce7b8506a454bfafa29e0e406894b8e1ca53;hb=8939ba947b65b018b80ecab3fe1366287d07d1d7;hp=49fa80046712eda3f91a8536162acc067a6d544e;hpb=a6d5524ecde20b5db1ce867a5f7d6515a107b933;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod index 49fa800..c1efce7 100644 --- a/pod/perlfunc.pod +++ b/pod/perlfunc.pod @@ -1089,7 +1089,7 @@ This is useful for propagating exceptions: If LIST is empty and C<$@> contains an object reference that has a C method, that method will be called with additional file and line number parameters. The return value replaces the value in -C<$@>. ie. as if C<<$@ = eval { $@->PROPAGATE(__FILE__, __LINE__) };>> +C<$@>. ie. as if C<<$@ = eval { $@->PROPAGATE(__FILE__, __LINE__) };>> were called. If C<$@> is empty then the string C<"Died"> is used. @@ -1280,7 +1280,7 @@ formed from the files listed on the command line and accessed via the C<< <> >> operator. Since C<< <> >> isn't explicitly opened, as a normal filehandle is, an C before C<< <> >> has been used will cause C<@ARGV> to be examined to determine if input is -available. Similarly, an C after C<< <> >> has returned +available. Similarly, an C after C<< <> >> has returned end-of-file will assume you are processing another C<@ARGV> list, and if you haven't set C<@ARGV>, will read input from C; see L. @@ -2469,14 +2469,13 @@ and the month of the year, may not necessarily be three characters wide. =item lock THING -This function places an advisory lock on a variable, subroutine, -or referenced object contained in I until the lock goes out -of scope. +This function places an advisory lock on a shared variable, or referenced +object contained in I until the lock goes out of scope. -lock() is a "weak keyword" : that means that if you've defined a -function by this name, this function will be called instead. -(However, if you've said C, lock() is always a keyword.) -See L. +lock() is a "weak keyword" : this means that if you've defined a function +by this name (before any calls to it), that function will be called +instead. (However, if you've said C, lock() is always a +keyword.) See L. =item log EXPR @@ -2717,7 +2716,7 @@ strict 'refs'> should I be in effect.) If EXPR is omitted, the scalar variable of the same name as the FILEHANDLE contains the filename. (Note that lexical variables--those declared with C--will not work for this purpose; so if you're -using C, specify EXPR in your call to open.) +using C, specify EXPR in your call to open.) If three or more arguments are specified then the mode of opening and the file name are separate. If MODE is C<< '<' >> or nothing, the file @@ -2788,7 +2787,7 @@ If you're running Perl on a system that distinguishes between text files and binary files, then you should check out L for tips for dealing with this. The key distinction between systems that need C and those that don't is their text file formats. Systems -like Unix, MacOS, and Plan9, which delimit lines with a single +like Unix, Mac OS, and Plan 9, which delimit lines with a single character, and which encode that character in C as C<"\n">, do not need C. The rest need it. @@ -4967,7 +4966,7 @@ Most programs won't even call srand() at all, except those that need a cryptographically-strong starting point rather than the generally acceptable default, which is based on time of day, process ID, and memory allocation, or the F device, -if available. +if available. You can call srand($seed) with the same $seed to reproduce the I sequence from rand(), but this is usually reserved for @@ -5614,7 +5613,7 @@ package. =item time Returns the number of non-leap seconds since whatever time the system -considers to be the epoch (that's 00:00:00, January 1, 1904 for MacOS, +considers to be the epoch (that's 00:00:00, January 1, 1904 for Mac OS, and 00:00:00 UTC, January 1, 1970 for most other systems). Suitable for feeding to C and C.