X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlport.pod;h=ef05ecf3492c94d774ff5532fc5213618631cf54;hb=666f95b95a2f6347f7b7bbc8951144df2db05479;hp=0fa8d2675fe61decf97a3dd1f61dc96d6882228e;hpb=fe8296896b14aa93f1136ce57f05259d511ec956;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perlport.pod b/pod/perlport.pod index 0fa8d26..ef05ecf 100644 --- a/pod/perlport.pod +++ b/pod/perlport.pod @@ -232,6 +232,9 @@ binary, or else consider using modules like Data::Dumper (included in the standard distribution as of Perl 5.005) and Storable (included as of perl 5.8). Keeping all data as text significantly simplifies matters. +The v-strings are portable only up to v2147483647 (0x7FFFFFFF), that's +how far EBCDIC, or more precisely UTF-EBCDIC will go. + =head2 Files and Filesystems Most platforms these days structure files in a hierarchical fashion. @@ -259,6 +262,9 @@ timestamp (meaning that about the only portable timestamp is the modification timestamp), or one second granularity of any timestamps (e.g. the FAT filesystem limits the time granularity to two seconds). +The "inode change timestamp" (the <-C> filetest) may really be the +"creation timestamp" (which it is not in UNIX). + VOS perl can emulate Unix filenames with C as path separator. The native pathname characters greater-than, less-than, number-sign, and percent-sign are always accepted. @@ -353,7 +359,12 @@ where it is undesirable. Don't use C<:> as a part of a filename since many systems use that for their own semantics (MacOS Classic for separating pathname components, many networking schemes and utilities for separating the nodename and -the pathname, and so on). +the pathname, and so on). For the same reasons, avoid C<@>, C<;> and +C<|>. + +Don't assume that in pathnames you can collapse two leading slashes +C into one: some networking and clustering filesystems have special +semantics for that. Let the operating system to sort it out. The I as defined by ANSI C are @@ -362,7 +373,12 @@ The I as defined by ANSI C are 0 1 2 3 4 5 6 7 8 9 . _ - -and the "-" shouldn't be the first character. +and the "-" shouldn't be the first character. If you want to be +hypercorrect, stay case-insensitive and within the 8.3 naming +convention (all the files and directories have to be unique within one +directory if their names are lowercased and truncated to eight +characters before the C<.>, if any, and to three characters after the +C<.>, if any). (And do not use C<.>s in directory names.) =head2 System Interaction @@ -664,6 +680,7 @@ are a few of the more popular Unix flavors: -------------------------------------------- AIX aix aix BSD/OS bsdos i386-bsdos + Darwin darwin darwin dgux dgux AViiON-dgux DYNIX/ptx dynixptx i386-dynixptx FreeBSD freebsd freebsd-i386 @@ -1423,6 +1440,9 @@ Only good for changing "owner" and "other" read-write access. (S) Access permissions are mapped onto VOS access-control list changes. (VOS) +The actual permissions set depend on the value of the C +in the SYSTEM environment settings. (Cygwin) + =item chown LIST Not implemented. (S, Win32, Plan9, S, VOS) @@ -1773,7 +1793,11 @@ as '', so numeric comparison or manipulation of these fields may cause 'not numeric' warnings. mtime and atime are the same thing, and ctime is creation time instead of -inode change time. (S) +inode change time. (S). + +ctime not supported on UFS (S). + +ctime is creation time instead of inode change time (Win32). device and inode are not meaningful. (Win32) @@ -2178,7 +2202,7 @@ Andrew M. Langmead , Larry Moore , Paul Moore , Chris Nandor , -Matthias Neeracher , +Matthias Neeracher , Philip Newton , Gary Ng <71564.1743@CompuServe.COM>, Tom Phoenix , @@ -2191,6 +2215,3 @@ Michael G Schwern , Dan Sugalski , Nathan Torkington . -=head1 VERSION - -Version 1.50, last modified 10 Jul 2001