X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlfunc.pod;h=8722105c2b6fa9beffc50b5e9ca9b9b71f1f974a;hb=1b1f1335be81080356b687a63b64fde210a3b697;hp=340e15c2857f9a6d44ed4ee251825a3a20316d48;hpb=ffce7b87576a6bbdec03658f58f16de7401d199a;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod index 340e15c..8722105 100644 --- a/pod/perlfunc.pod +++ b/pod/perlfunc.pod @@ -291,7 +291,7 @@ X<-S>X<-b>X<-c>X<-t>X<-u>X<-g>X<-k>X<-T>X<-B>X<-M>X<-A>X<-C> -g File has setgid bit set. -k File has sticky bit set. - -T File is an ASCII text file. + -T File is an ASCII text file (heuristic guess). -B File is a "binary" file (opposite of -T). -M Age of file in days when script started. @@ -563,9 +563,9 @@ previous time C was called. Changes the working directory to EXPR, if possible. If EXPR is omitted, changes to the directory specified by C<$ENV{HOME}>, if set; if not, changes to the directory specified by C<$ENV{LOGDIR}>. (Under VMS, the -variable C<$ENV{SYS$LOGIN}> is used instead.) If neither is set, -C does nothing. It returns true upon success, false otherwise. -See the example under C. +variable C<$ENV{SYS$LOGIN}> is also checked, and used if it is set.) If +neither is set, C does nothing. It returns true upon success, +false otherwise. See the example under C. =item chmod LIST @@ -682,12 +682,12 @@ On POSIX systems, you can detect this condition this way: Returns the character represented by that NUMBER in the character set. For example, C is C<"A"> in either ASCII or Unicode, and -chr(0x263a) is a Unicode smiley face. Note that characters from -127 to 255 (inclusive) are not encoded in Unicode for backward -compatibility reasons. +chr(0x263a) is a Unicode smiley face. Note that characters from 127 +to 255 (inclusive) are by default not encoded in Unicode for backward +compatibility reasons (but see L). For the reverse, use L. -See L for more about Unicode. +See L and L for more about Unicode. If NUMBER is omitted, uses C<$_>. @@ -2330,7 +2330,7 @@ C work. Returns an lowercased version of EXPR. This is the internal function implementing the C<\L> escape in double-quoted strings. Respects current LC_CTYPE locale if C in force. See L -and L. +and L for more details about locale and Unicode support. If EXPR is omitted, uses C<$_>. @@ -2341,7 +2341,8 @@ If EXPR is omitted, uses C<$_>. Returns the value of EXPR with the first character lowercased. This is the internal function implementing the C<\l> escape in double-quoted strings. Respects current LC_CTYPE locale if C in force. See L and L. +locale> in force. See L and L for more +details about locale and Unicode support. If EXPR is omitted, uses C<$_>. @@ -2969,9 +2970,12 @@ DIRHANDLEs have their own namespace separate from FILEHANDLEs. =item ord -Returns the numeric (ASCII or Unicode) value of the first character of EXPR. If -EXPR is omitted, uses C<$_>. For the reverse, see L. -See L for more about Unicode. +Returns the numeric (the native 8-bit encoding, like ASCII or EBCDIC, +or Unicode) value of the first character of EXPR. If EXPR is omitted, +uses C<$_>. + +For the reverse, see L. +See L and L for more about Unicode. =item our EXPR @@ -3050,8 +3054,8 @@ sequence of characters that give the order and type of values, as follows: a A string with arbitrary binary data, will be null padded. - A An ASCII string, will be space padded. - Z A null terminated (asciz) string, will be null padded. + A A text (ASCII) string, will be space padded. + Z A null terminated (ASCIZ) string, will be null padded. b A bit string (ascending bit order inside each byte, like vec()). B A bit string (descending bit order inside each byte). @@ -3882,6 +3886,9 @@ C
.) Here is a typical code layout: # In the main program push @INC, new Foo(...); +Note that these hooks are also permitted to set the %INC entry +corresponding to the files they have loaded. See L. + For a yet-more-powerful import facility, see L and L. =item reset EXPR @@ -4108,7 +4115,7 @@ calling select() in scalar context just returns $nfound. Any of the bit masks can also be undef. The timeout, if specified, is in seconds, which may be fractional. Note: not all implementations are -capable of returning the$timeleft. If not, they always return +capable of returning the $timeleft. If not, they always return $timeleft equal to the supplied $timeout. You can effect a sleep of 250 milliseconds this way: @@ -5461,8 +5468,9 @@ otherwise. Returns an uppercased version of EXPR. This is the internal function implementing the C<\U> escape in double-quoted strings. Respects current LC_CTYPE locale if C in force. See L -and L. It does not attempt to do titlecase mapping on -initial letters. See C for that. +and L for more details about locale and Unicode support. +It does not attempt to do titlecase mapping on initial letters. See +C for that. If EXPR is omitted, uses C<$_>. @@ -5473,7 +5481,8 @@ If EXPR is omitted, uses C<$_>. Returns the value of EXPR with the first character in uppercase (titlecase in Unicode). This is the internal function implementing the C<\u> escape in double-quoted strings. Respects current LC_CTYPE -locale if C in force. See L and L. +locale if C in force. See L and L +for more details about locale and Unicode support. If EXPR is omitted, uses C<$_>.