This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
[perl #71000] Wrong variable name in warning
[perl5.git] / pod / perlport.pod
index b639c47..6c5fa17 100644 (file)
@@ -59,7 +59,7 @@ choices you can avail yourself of, and at the same time you can give
 your users lots of platform choices.  On the other hand, when you have to
 take advantage of some unique feature of a particular platform, as is
 often the case with systems programming (whether for Unix, Windows,
-S<Mac OS>, VMS, etc.), consider writing platform-specific code.
+VMS, etc.), consider writing platform-specific code.
 
 When the code will run on only two or three operating systems, you
 may need to consider only the differences of those particular systems.
@@ -88,11 +88,11 @@ and S<Mac OS> uses C<\015>.
 
 Perl uses C<\n> to represent the "logical" newline, where what is
 logical may depend on the platform in use.  In MacPerl, C<\n> always
-means C<\015>.  In DOSish perls, C<\n> usually means C<\012>, but
-when accessing a file in "text" mode, STDIO translates it to (or
-from) C<\015\012>, depending on whether you're reading or writing.
-Unix does the same thing on ttys in canonical mode.  C<\015\012>
-is commonly referred to as CRLF.
+means C<\015>.  In DOSish perls, C<\n> usually means C<\012>, but when
+accessing a file in "text" mode, perl uses the C<:crlf> layer that
+translates it to (or from) C<\015\012>, depending on whether you're
+reading or writing. Unix does the same thing on ttys in canonical
+mode.  C<\015\012> is commonly referred to as CRLF.
 
 To trim trailing newlines from text lines use chomp().  With default 
 settings that function looks for a trailing C<\n> character and thus 
@@ -260,7 +260,7 @@ as path separator, or in their own idiosyncratic ways (such as having
 several root directories and various "unrooted" device files such NIL:
 and LPT:).
 
-S<Mac OS> uses C<:> as a path separator instead of C</>.
+S<Mac OS> 9 and earlier used C<:> as a path separator instead of C</>.
 
 The filesystem may support neither hard links (C<link>) nor
 symbolic links (C<symlink>, C<readlink>, C<lstat>).
@@ -297,7 +297,7 @@ to be running the program.
     chdir(updir());        # go up one directory
     $file = catfile(curdir(), 'temp', 'file.txt');
     # on Unix and Win32, './temp/file.txt'
-    # on Mac OS, ':temp:file.txt'
+    # on Mac OS Classic, ':temp:file.txt'
     # on VMS, '[.temp]file.txt'
 
 File::Spec is available in the standard distribution as of version
@@ -433,6 +433,16 @@ if you really have to, make it conditional on C<$^O ne 'VMS'> since in
 VMS the C<%ENV> table is much more than a per-process key-value string
 table.
 
+On VMS, some entries in the %ENV hash are dynamically created when
+their key is used on a read if they did not previously exist.  The
+values for C<$ENV{HOME}>, C<$ENV{TERM}>, C<$ENV{HOME}>, and C<$ENV{USER}>,
+are known to be dynamically generated.  The specific names that are
+dynamically generated may vary with the version of the C library on VMS,
+and more may exist than is documented.
+
+On VMS by default, changes to the %ENV hash are persistent after the process
+exits.  This can cause unintended issues.
+
 Don't count on signals or C<%SIG> for anything.
 
 Don't count on filename globbing.  Use C<opendir>, C<readdir>, and
@@ -627,12 +637,9 @@ it may be appropriate to calculate an offset for the epoch.
     require Time::Local;
     $offset = Time::Local::timegm(0, 0, 0, 1, 0, 70);
 
-The value for C<$offset> in Unix will be C<0>, but in Mac OS will be
-some large number.  C<$offset> can then be added to a Unix time value
-to get what should be the proper value on any system.
-
-On Windows (at least), you shouldn't pass a negative value to C<gmtime> or
-C<localtime>.
+The value for C<$offset> in Unix will be C<0>, but in Mac OS Classic
+will be some large number.  C<$offset> can then be added to a Unix time
+value to get what should be the proper value on any system.
 
 =head2 Character sets and character encoding
 
@@ -672,12 +679,9 @@ ISO 8859-1 bytes beyond 0x7f into your strings might cause trouble
 later.  If the bytes are native 8-bit bytes, you can use the C<bytes>
 pragma.  If the bytes are in a string (regular expression being a
 curious string), you can often also use the C<\xHH> notation instead
-of embedding the bytes as-is.  If they are in some particular legacy
-encoding (ether single-byte or something more complicated), you can
-use the C<encoding> pragma.  (If you want to write your code in UTF-8,
-you can use either the C<utf8> pragma, or the C<encoding> pragma.)
-The C<bytes> and C<utf8> pragmata are available since Perl 5.6.0, and
-the C<encoding> pragma since Perl 5.8.0.
+of embedding the bytes as-is.  (If you want to write your code in UTF-8,
+you can use the C<utf8>.) The C<bytes> and C<utf8> pragmata are
+available since Perl 5.6.0.
 
 =head2 System Resources
 
@@ -808,6 +812,7 @@ are a few of the more popular Unix flavors:
     dgux          dgux       AViiON-dgux
     DYNIX/ptx     dynixptx   i386-dynixptx
     FreeBSD       freebsd    freebsd-i386    
+    Haiku         haiku      BePC-haiku
     Linux         linux      arm-linux
     Linux         linux      i386-linux
     Linux         linux      i586-linux
@@ -815,7 +820,6 @@ are a few of the more popular Unix flavors:
     HP-UX         hpux       PA-RISC1.1
     IRIX          irix       irix
     Mac OS X      darwin     darwin
-    MachTen PPC   machten    powerpc-machten
     NeXT 3        next       next-fat
     NeXT 4        next       OPENSTEP-Mach
     openbsd       openbsd    i386-openbsd
@@ -928,7 +932,6 @@ and L<perldos>.
 =item *
 
 The EMX environment for DOS, OS/2, etc. emx@iaehv.nl,
-http://www.leo.org/pub/comp/os/os2/leo/gnu/emx+gcc/index.html or
 ftp://hobbes.nmsu.edu/pub/os2/dev/emx/  Also L<perlos2>.
 
 =item *
@@ -960,89 +963,6 @@ Build instructions for OS/2, L<perlos2>
 
 =back
 
-=head2 S<Mac OS>
-
-Any module requiring XS compilation is right out for most people, because
-MacPerl is built using non-free (and non-cheap!) compilers.  Some XS
-modules that can work with MacPerl are built and distributed in binary
-form on CPAN.
-
-Directories are specified as:
-
-    volume:folder:file              for absolute pathnames
-    volume:folder:                  for absolute pathnames
-    :folder:file                    for relative pathnames
-    :folder:                        for relative pathnames
-    :file                           for relative pathnames
-    file                            for relative pathnames
-
-Files are stored in the directory in alphabetical order.  Filenames are
-limited to 31 characters, and may include any character except for
-null and C<:>, which is reserved as the path separator.
-
-Instead of C<flock>, see C<FSpSetFLock> and C<FSpRstFLock> in the
-Mac::Files module, or C<chmod(0444, ...)> and C<chmod(0666, ...)>.
-
-In the MacPerl application, you can't run a program from the command line;
-programs that expect C<@ARGV> to be populated can be edited with something
-like the following, which brings up a dialog box asking for the command
-line arguments.
-
-    if (!@ARGV) {
-        @ARGV = split /\s+/, MacPerl::Ask('Arguments?');
-    }
-
-A MacPerl script saved as a "droplet" will populate C<@ARGV> with the full
-pathnames of the files dropped onto the script.
-
-Mac users can run programs under a type of command line interface
-under MPW (Macintosh Programmer's Workshop, a free development
-environment from Apple).  MacPerl was first introduced as an MPW
-tool, and MPW can be used like a shell:
-
-    perl myscript.plx some arguments
-
-ToolServer is another app from Apple that provides access to MPW tools
-from MPW and the MacPerl app, which allows MacPerl programs to use
-C<system>, backticks, and piped C<open>.
-
-"S<Mac OS>" is the proper name for the operating system, but the value
-in C<$^O> is "MacOS".  To determine architecture, version, or whether
-the application or MPW tool version is running, check:
-
-    $is_app    = $MacPerl::Version =~ /App/;
-    $is_tool   = $MacPerl::Version =~ /MPW/;
-    ($version) = $MacPerl::Version =~ /^(\S+)/;
-    $is_ppc    = $MacPerl::Architecture eq 'MacPPC';
-    $is_68k    = $MacPerl::Architecture eq 'Mac68K';
-
-S<Mac OS X>, based on NeXT's OpenStep OS, runs MacPerl natively, under the
-"Classic" environment.  There is no "Carbon" version of MacPerl to run
-under the primary Mac OS X environment.  S<Mac OS X> and its Open Source
-version, Darwin, both run Unix perl natively.
-
-Also see:
-
-=over 4
-
-=item *
-
-MacPerl Development, http://dev.macperl.org/ .
-
-=item *
-
-The MacPerl Pages, http://www.macperl.com/ .
-
-=item *
-
-The MacPerl mailing lists, http://lists.perl.org/ .
-
-=item *
-
-MPW, ftp://ftp.apple.com/developer/Tool_Chest/Core_Mac_OS_Tools/
-
-=back
-
 =head2 VMS
 
 Perl on VMS is discussed in L<perlvms> in the perl distribution.
@@ -1159,11 +1079,18 @@ a VMS format directory, then C<readdir> should return F<a.>, and
 again with the optionally the exact case.
 
 RMS had an eight level limit on directory depths from any rooted logical
-(allowing 16 levels overall) prior to VMS 7.2.  Hence
-C<PERL_ROOT:[LIB.2.3.4.5.6.7.8]> is a valid directory specification but
-C<PERL_ROOT:[LIB.2.3.4.5.6.7.8.9]> is not.  F<Makefile.PL> authors might
-have to take this into account, but at least they can refer to the former
-as C</PERL_ROOT/lib/2/3/4/5/6/7/8/>.
+(allowing 16 levels overall) prior to VMS 7.2, and even with versions of
+VMS on VAX up through 7.3.  Hence C<PERL_ROOT:[LIB.2.3.4.5.6.7.8]> is a
+valid directory specification but C<PERL_ROOT:[LIB.2.3.4.5.6.7.8.9]> is
+not.  F<Makefile.PL> authors might have to take this into account, but at
+least they can refer to the former as C</PERL_ROOT/lib/2/3/4/5/6/7/8/>.
+
+Pumpkings and module integrators can easily see whether files with too many
+directory levels have snuck into the core by running the following in the
+top-level source directory:
+
+   $ perl -ne "$_=~s/\s+.*//; print if scalar(split /\//) > 8;" < MANIFEST
+
 
 The VMS::Filespec module, which gets installed as part of the build
 process on VMS, is a pure Perl module that can easily be installed on
@@ -1219,9 +1146,7 @@ F<README.vms> (installed as L<README_vms>), L<perlvms>
 
 =item *
 
-vmsperl list, majordomo@perl.org
-
-(Put the words C<subscribe vmsperl> in message body.)
+vmsperl list, vmsperl-subscribe@perl.org
 
 =item *
 
@@ -1235,19 +1160,20 @@ Perl on VOS is discussed in F<README.vos> in the perl distribution
 (installed as L<perlvos>).  Perl on VOS can accept either VOS- or
 Unix-style file specifications as in either of the following:
 
-    C<< $ perl -ne "print if /perl_setup/i" >system>notices >>
-    C<< $ perl -ne "print if /perl_setup/i" /system/notices >>
+    $ perl -ne "print if /perl_setup/i" >system>notices
+    $ perl -ne "print if /perl_setup/i" /system/notices
 
 or even a mixture of both as in:
 
-    C<< $ perl -ne "print if /perl_setup/i" >system/notices >>
+    $ perl -ne "print if /perl_setup/i" >system/notices
 
 Even though VOS allows the slash character to appear in object
 names, because the VOS port of Perl interprets it as a pathname
 delimiting character, VOS files, directories, or links whose names
 contain a slash character cannot be processed.  Such files must be
 renamed before they can be processed by Perl.  Note that VOS limits
-file names to 32 or fewer characters.
+file names to 32 or fewer characters, file names cannot start with a
+C<-> character, or contain any character matching C<< tr/ !%&'()*+;<>?// >>
 
 The value of C<$^O> on VOS is "VOS".  To determine the architecture that
 you are running on without resorting to loading all of C<%Config> you
@@ -1488,13 +1414,13 @@ in C<$^O> is "riscos" (because we don't like shouting).
 =head2 Other perls
 
 Perl has been ported to many platforms that do not fit into any of
-the categories listed above.  Some, such as AmigaOS, Atari MiNT,
-BeOS, HP MPE/iX, QNX, Plan 9, and VOS, have been well-integrated
-into the standard Perl source code kit.  You may need to see the
-F<ports/> directory on CPAN for information, and possibly binaries,
-for the likes of: aos, Atari ST, lynxos, riscos, Novell Netware,
-Tandem Guardian, I<etc.>  (Yes, we know that some of these OSes may
-fall under the Unix category, but we are not a standards body.)
+the categories listed above.  Some, such as AmigaOS, BeOS, HP MPE/iX,
+QNX, Plan 9, and VOS, have been well-integrated into the standard
+Perl source code kit.  You may need to see the F<ports/> directory
+on CPAN for information, and possibly binaries, for the likes of:
+aos, Atari ST, lynxos, riscos, Novell Netware, Tandem Guardian,
+I<etc.>  (Yes, we know that some of these OSes may fall under the
+Unix category, but we are not a standards body.)
 
 Some approximate operating system names and their C<$^O> values
 in the "OTHER" category include:
@@ -1515,17 +1441,12 @@ Amiga, F<README.amiga> (installed as L<perlamiga>).
 
 =item *
 
-Atari, F<README.mint> and Guido Flohr's web page
-http://stud.uni-sb.de/~gufl0000/
-
-=item *
-
 Be OS, F<README.beos>
 
 =item *
 
 HP 300 MPE/iX, F<README.mpeix> and Mark Bixby's web page
-http://www.bixby.org/mark/perlix.html
+http://www.bixby.org/mark/porting.html
 
 =item *
 
@@ -1564,36 +1485,29 @@ L<Config> for a full description of available variables.
 
 =item -X
 
-C<-r>, C<-w>, and C<-x> have a limited meaning only; directories
-and applications are executable, and there are no uid/gid
-considerations.  C<-o> is not supported.  (S<Mac OS>)
+C<-w> only inspects the read-only file attribute (FILE_ATTRIBUTE_READONLY),
+which determines whether the directory can be deleted, not whether it can
+be written to. Directories always have read and write access unless denied
+by discretionary access control lists (DACLs).  (S<Win32>)
 
 C<-r>, C<-w>, C<-x>, and C<-o> tell whether the file is accessible,
 which may not reflect UIC-based file protections.  (VMS)
 
-C<-s> returns the size of the data fork, not the total size of data fork
-plus resource fork.  (S<Mac OS>).
-
 C<-s> by name on an open file will return the space reserved on disk,
 rather than the current extent.  C<-s> on an open filehandle returns the
 current size.  (S<RISC OS>)
 
 C<-R>, C<-W>, C<-X>, C<-O> are indistinguishable from C<-r>, C<-w>,
-C<-x>, C<-o>. (S<Mac OS>, Win32, VMS, S<RISC OS>)
-
-C<-b>, C<-c>, C<-k>, C<-g>, C<-p>, C<-u>, C<-A> are not implemented.
-(S<Mac OS>)
+C<-x>, C<-o>. (Win32, VMS, S<RISC OS>)
 
-C<-g>, C<-k>, C<-l>, C<-p>, C<-u>, C<-A> are not particularly meaningful.
+C<-g>, C<-k>, C<-l>, C<-u>, C<-A> are not particularly meaningful.
 (Win32, VMS, S<RISC OS>)
 
+C<-p> is not particularly meaningful. (VMS, S<RISC OS>)
+
 C<-d> is true if passed a device spec without an explicit directory.
 (VMS)
 
-C<-T> and C<-B> are implemented, but might misclassify Mac text files
-with foreign characters; this is the case will all platforms, but may
-affect S<Mac OS> often.  (S<Mac OS>)
-
 C<-x> (or C<-X>) determine if a file ends in one of the executable
 suffixes.  C<-S> is meaningless.  (Win32)
 
@@ -1613,7 +1527,7 @@ L<http://www.opengroup.org/onlinepubs/009695399/functions/atan2.html>.
 
 =item binmode
 
-Meaningless.  (S<Mac OS>, S<RISC OS>)
+Meaningless.  (S<RISC OS>)
 
 Reopens file and restores pointer; if function fails, underlying
 filehandle may be closed, or pointer may be in a different position.
@@ -1624,9 +1538,6 @@ the filehandle may be flushed. (Win32)
 
 =item chmod
 
-Only limited meaning.  Disabling/enabling write permission is mapped to
-locking/unlocking the file. (S<Mac OS>)
-
 Only good for changing "owner" read-write access, "group", and "other"
 bits are meaningless. (Win32)
 
@@ -1639,7 +1550,7 @@ in the SYSTEM environment settings.  (Cygwin)
 
 =item chown
 
-Not implemented. (S<Mac OS>, Win32, S<Plan 9>, S<RISC OS>)
+Not implemented. (Win32, S<Plan 9>, S<RISC OS>)
 
 Does nothing, but won't fail. (Win32)
 
@@ -1647,7 +1558,7 @@ A little funky, because VOS's notion of ownership is a little funky (VOS).
 
 =item chroot
 
-Not implemented. (S<Mac OS>, Win32, VMS, S<Plan 9>, S<RISC OS>, VOS, VM/ESA)
+Not implemented. (Win32, VMS, S<Plan 9>, S<RISC OS>, VOS, VM/ESA)
 
 =item crypt
 
@@ -1664,7 +1575,7 @@ Not implemented. (VMS, S<Plan 9>, VOS)
 
 =item dump
 
-Not useful. (S<Mac OS>, S<RISC OS>)
+Not useful. (S<RISC OS>)
 
 Not supported. (Cygwin, Win32)
 
@@ -1672,8 +1583,6 @@ Invokes VMS debugger. (VMS)
 
 =item exec
 
-Not implemented. (S<Mac OS>)
-
 Implemented via Spawn. (VM/ESA)
 
 Does not automatically flush output handles on some platforms.
@@ -1700,13 +1609,13 @@ Some functions available based on the version of VMS. (VMS)
 
 =item flock
 
-Not implemented (S<Mac OS>, VMS, S<RISC OS>, VOS).
+Not implemented (VMS, S<RISC OS>, VOS).
 
 Available only on Windows NT (not on Windows 95). (Win32)
 
 =item fork
 
-Not implemented. (S<Mac OS>, AmigaOS, S<RISC OS>, VM/ESA, VMS)
+Not implemented. (AmigaOS, S<RISC OS>, VM/ESA, VMS)
 
 Emulated using multiple interpreters.  See L<perlfork>.  (Win32)
 
@@ -1715,80 +1624,76 @@ Does not automatically flush output handles on some platforms.
 
 =item getlogin
 
-Not implemented. (S<Mac OS>, S<RISC OS>)
+Not implemented. (S<RISC OS>)
 
 =item getpgrp
 
-Not implemented. (S<Mac OS>, Win32, VMS, S<RISC OS>)
+Not implemented. (Win32, VMS, S<RISC OS>)
 
 =item getppid
 
-Not implemented. (S<Mac OS>, Win32, S<RISC OS>)
+Not implemented. (Win32, S<RISC OS>)
 
 =item getpriority
 
-Not implemented. (S<Mac OS>, Win32, VMS, S<RISC OS>, VOS, VM/ESA)
+Not implemented. (Win32, VMS, S<RISC OS>, VOS, VM/ESA)
 
 =item getpwnam
 
-Not implemented. (S<Mac OS>, Win32)
+Not implemented. (Win32)
 
 Not useful. (S<RISC OS>)
 
 =item getgrnam
 
-Not implemented. (S<Mac OS>, Win32, VMS, S<RISC OS>)
+Not implemented. (Win32, VMS, S<RISC OS>)
 
 =item getnetbyname
 
-Not implemented. (S<Mac OS>, Win32, S<Plan 9>)
+Not implemented. (Win32, S<Plan 9>)
 
 =item getpwuid
 
-Not implemented. (S<Mac OS>, Win32)
+Not implemented. (Win32)
 
 Not useful. (S<RISC OS>)
 
 =item getgrgid
 
-Not implemented. (S<Mac OS>, Win32, VMS, S<RISC OS>)
+Not implemented. (Win32, VMS, S<RISC OS>)
 
 =item getnetbyaddr
 
-Not implemented. (S<Mac OS>, Win32, S<Plan 9>)
+Not implemented. (Win32, S<Plan 9>)
 
 =item getprotobynumber
 
-Not implemented. (S<Mac OS>)
-
 =item getservbyport
 
-Not implemented. (S<Mac OS>)
-
 =item getpwent
 
-Not implemented. (S<Mac OS>, Win32, VM/ESA)
+Not implemented. (Win32, VM/ESA)
 
 =item getgrent
 
-Not implemented. (S<Mac OS>, Win32, VMS, VM/ESA)
+Not implemented. (Win32, VMS, VM/ESA)
 
 =item gethostbyname
 
 C<gethostbyname('localhost')> does not work everywhere: you may have
-to use C<gethostbyname('127.0.0.1')>. (S<Mac OS>, S<Irix 5>)
+to use C<gethostbyname('127.0.0.1')>. (S<Irix 5>)
 
 =item gethostent
 
-Not implemented. (S<Mac OS>, Win32)
+Not implemented. (Win32)
 
 =item getnetent
 
-Not implemented. (S<Mac OS>, Win32, S<Plan 9>)
+Not implemented. (Win32, S<Plan 9>)
 
 =item getprotoent
 
-Not implemented. (S<Mac OS>, Win32, S<Plan 9>)
+Not implemented. (Win32, S<Plan 9>)
 
 =item getservent
 
@@ -1796,15 +1701,15 @@ Not implemented. (Win32, S<Plan 9>)
 
 =item sethostent
 
-Not implemented. (S<Mac OS>, Win32, S<Plan 9>, S<RISC OS>)
+Not implemented. (Win32, S<Plan 9>, S<RISC OS>)
 
 =item setnetent
 
-Not implemented. (S<Mac OS>, Win32, S<Plan 9>, S<RISC OS>)
+Not implemented. (Win32, S<Plan 9>, S<RISC OS>)
 
 =item setprotoent
 
-Not implemented. (S<Mac OS>, Win32, S<Plan 9>, S<RISC OS>)
+Not implemented. (Win32, S<Plan 9>, S<RISC OS>)
 
 =item setservent
 
@@ -1812,23 +1717,23 @@ Not implemented. (S<Plan 9>, Win32, S<RISC OS>)
 
 =item endpwent
 
-Not implemented. (S<Mac OS>, MPE/iX, VM/ESA, Win32)
+Not implemented. (MPE/iX, VM/ESA, Win32)
 
 =item endgrent
 
-Not implemented. (S<Mac OS>, MPE/iX, S<RISC OS>, VM/ESA, VMS, Win32)
+Not implemented. (MPE/iX, S<RISC OS>, VM/ESA, VMS, Win32)
 
 =item endhostent
 
-Not implemented. (S<Mac OS>, Win32)
+Not implemented. (Win32)
 
 =item endnetent
 
-Not implemented. (S<Mac OS>, Win32, S<Plan 9>)
+Not implemented. (Win32, S<Plan 9>)
 
 =item endprotoent
 
-Not implemented. (S<Mac OS>, Win32, S<Plan 9>)
+Not implemented. (Win32, S<Plan 9>)
 
 =item endservent
 
@@ -1845,7 +1750,10 @@ platforms.  See L<File::Glob> for portability information.
 
 =item gmtime
 
-Same portability caveats as L<localtime>.
+In theory, gmtime() is reliable from -2**63 to 2**63-1.  However,
+because work arounds in the implementation use floating point numbers,
+it will become inaccurate as the time gets larger.  This is a bug and
+will be fixed in the future.
 
 =item ioctl FILEHANDLE,FUNCTION,SCALAR
 
@@ -1858,9 +1766,6 @@ Available only for socket handles. (S<RISC OS>)
 
 =item kill
 
-C<kill(0, LIST)> is implemented for the sake of taint checking;
-use with other signals is unimplemented. (S<Mac OS>)
-
 Not implemented, hence not useful for taint checking. (S<RISC OS>)
 
 C<kill()> doesn't have the semantics of C<raise()>, i.e. it doesn't send
@@ -1870,27 +1775,35 @@ and makes it exit immediately with exit status $sig.  As in Unix, if
 $sig is 0 and the specified process exists, it returns true without
 actually terminating it. (Win32)
 
+C<kill(-9, $pid)> will terminate the process specified by $pid and
+recursively all child processes owned by it.  This is different from
+the Unix semantics, where the signal will be delivered to all
+processes in the same process group as the process specified by
+$pid. (Win32)
+
 Is not supported for process identification number of 0 or negative
 numbers. (VMS)
 
 =item link
 
-Not implemented. (S<Mac OS>, MPE/iX, S<RISC OS>)
+Not implemented. (MPE/iX, S<RISC OS>)
 
 Link count not updated because hard links are not quite that hard
 (They are sort of half-way between hard and soft links). (AmigaOS)
 
-Hard links are implemented on Win32 (Windows NT and Windows 2000)
-under NTFS only.
+Hard links are implemented on Win32 under NTFS only. They are
+natively supported on Windows 2000 and later.  On Windows NT they
+are implemented using the Windows POSIX subsystem support and the
+Perl process will need Administrator or Backup Operator privileges
+to create hard links.
 
 Available on 64 bit OpenVMS 8.2 and later.  (VMS)
 
 =item localtime
 
-Because Perl currently relies on the native standard C localtime()
-function, it is only safe to use times between 0 and (2**31)-1.  Times
-outside this range may result in unexpected behavior depending on your
-operating system's implementation of localtime().
+localtime() has the same range as L<gmtime>, but because time zone
+rules change its accuracy for historical and future times may degrade
+but usually by no more than an hour.
 
 =item lstat
 
@@ -1906,22 +1819,15 @@ Return values (especially for device and inode) may be bogus. (Win32)
 
 =item msgrcv
 
-Not implemented. (S<Mac OS>, Win32, VMS, S<Plan 9>, S<RISC OS>, VOS)
+Not implemented. (Win32, VMS, S<Plan 9>, S<RISC OS>, VOS)
 
 =item open
 
-The C<|> variants are supported only if ToolServer is installed.
-(S<Mac OS>)
-
-open to C<|-> and C<-|> are unsupported. (S<Mac OS>, Win32, S<RISC OS>)
+open to C<|-> and C<-|> are unsupported. (Win32, S<RISC OS>)
 
 Opening a process does not automatically flush output handles on some
 platforms.  (SunOS, Solaris, HP-UX)
 
-=item pipe
-
-Very limited functionality. (MiNT)
-
 =item readlink
 
 Not implemented. (Win32, VMS, S<RISC OS>)
@@ -1944,23 +1850,23 @@ Note that the C<select FILEHANDLE> form is generally portable.
 
 =item semop
 
-Not implemented. (S<Mac OS>, Win32, VMS, S<RISC OS>, VOS)
+Not implemented. ( Win32, VMS, S<RISC OS>, VOS)
 
 =item setgrent
 
-Not implemented. (S<Mac OS>, MPE/iX, VMS, Win32, S<RISC OS>, VOS)
+Not implemented. (MPE/iX, VMS, Win32, S<RISC OS>, VOS)
 
 =item setpgrp
 
-Not implemented. (S<Mac OS>, Win32, VMS, S<RISC OS>, VOS)
+Not implemented. (Win32, VMS, S<RISC OS>, VOS)
 
 =item setpriority
 
-Not implemented. (S<Mac OS>, Win32, VMS, S<RISC OS>, VOS)
+Not implemented. (Win32, VMS, S<RISC OS>, VOS)
 
 =item setpwent
 
-Not implemented. (S<Mac OS>, MPE/iX, Win32, S<RISC OS>, VOS)
+Not implemented. (MPE/iX, Win32, S<RISC OS>, VOS)
 
 =item setsockopt
 
@@ -1974,7 +1880,7 @@ Not implemented. (S<Plan 9>)
 
 =item shmwrite
 
-Not implemented. (S<Mac OS>, Win32, VMS, S<RISC OS>, VOS)
+Not implemented. (Win32, VMS, S<RISC OS>, VOS)
 
 =item sockatmark
 
@@ -1983,7 +1889,7 @@ be implemented even in UNIX platforms.
 
 =item socketpair
 
-Not implemented. (Win32, S<RISC OS>, VOS, VM/ESA)
+Not implemented. (S<RISC OS>, VOS, VM/ESA)
 
 Available on 64 bit OpenVMS 8.2 and later.  (VMS)
 
@@ -1993,9 +1899,6 @@ Platforms that do not have rdev, blksize, or blocks will return these
 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<Mac OS>).
-
 ctime not supported on UFS (S<Mac OS X>).
 
 ctime is creation time instead of inode change time  (Win32).
@@ -2013,13 +1916,21 @@ meaningful and will differ between stat calls on the same file.  (os2)
 some versions of cygwin when doing a stat("foo") and if not finding it
 may then attempt to stat("foo.exe") (Cygwin)
 
+On Win32 stat() needs to open the file to determine the link count
+and update attributes that may have been changed through hard links.
+Setting ${^WIN32_SLOPPY_STAT} to a true value speeds up stat() by
+not performing this operation. (Win32)
+
 =item symlink
 
-Not implemented. (Win32, VMS, S<RISC OS>)
+Not implemented. (Win32, S<RISC OS>)
+
+Implemented on 64 bit VMS 8.3.  VMS requires the symbolic link to be in Unix
+syntax if it is intended to resolve to a valid path.
 
 =item syscall
 
-Not implemented. (S<Mac OS>, Win32, VMS, S<RISC OS>, VOS, VM/ESA)
+Not implemented. (Win32, VMS, S<RISC OS>, VOS, VM/ESA)
 
 =item sysopen
 
@@ -2030,8 +1941,6 @@ OS>, OS/390, VM/ESA)
 
 =item system
 
-Only implemented if ToolServer is installed. (S<Mac OS>)
-
 As an optimization, may not call the command shell specified in
 C<$ENV{PERL5SHELL}>.  C<system(1, @args)> spawns an external
 process and immediately returns its process designator, without
@@ -2051,11 +1960,6 @@ the child program uses a compatible version of the emulation library.
 I<scalar> will call the native command line direct and no such emulation
 of a child Unix program will exists.  Mileage B<will> vary.  (S<RISC OS>)
 
-Far from being POSIX compliant.  Because there may be no underlying
-/bin/sh tries to work around the problem by forking and execing the
-first token in its argument string.  Handles basic redirection
-("<" or ">") on its own behalf. (MiNT)
-
 Does not automatically flush output handles on some platforms.
 (SunOS, Solaris, HP-UX)
 
@@ -2068,8 +1972,6 @@ For more details see L<perlvms/$?>. (VMS)
 
 =item times
 
-Only the first entry returned is nonzero. (S<Mac OS>)
-
 "cumulative" times will be bogus.  On anything other than Windows NT
 or Windows 2000, "system" time will be bogus, and "user" time is
 actually the time returned by the clock() function in the C runtime
@@ -2097,7 +1999,7 @@ is finally closed. (AmigaOS)
 
 =item utime
 
-Only the modification time is updated. (S<BeOS>, S<Mac OS>, VMS, S<RISC OS>)
+Only the modification time is updated. (S<BeOS>, VMS, S<RISC OS>)
 
 May not behave as expected.  Behavior depends on the C runtime
 library's implementation of utime(), and the filesystem being
@@ -2109,8 +2011,6 @@ two seconds. (Win32)
 
 =item waitpid
 
-Not implemented. (S<Mac OS>)
-
 Can only be applied to process handles returned for processes spawned
 using C<system(1, ...)> or pseudo processes created with C<fork()>. (Win32)
 
@@ -2119,11 +2019,126 @@ Not useful. (S<RISC OS>)
 =back
 
 
-=head1 Supported Platforms
+=head1 Supported Platforms (Perl 5.12)
+
+
+As of _____ 20??, (The release of Perl 5.12), the following platforms are
+known to build Perl from the standard source code distribution available
+at http://www.cpan.org/src
+
+
+=over
+
+=item Linux (x86, ARM, IA64)
+
+=item HP-UX
+
+=item AIX
+
+=item Win32
+
+=over
+
+=item Windows 2000
+
+=item Windows XP
+
+=item Windows Server 2003
+
+=item Windows Vista
+
+=item Windows Server 2008
+
+=item Windows 7
+
+=back
+
+=item Cygwin
+
+=item Solaris (x86, SPARC)
+
+=item OpenVMS
+
+=over
+
+=item Alpha (7.2 and later)
+
+=item I64 (8.2 and later)
+
+=back
+
+=item Symbian
+
+=item NetBSD
+
+=item FreeBSD
+
+=item Haiku
+
+=item Irix (6.5. What else?)
+
+=item OpenBSD
+
+=item Dragonfly BSD
+
+=item MirOS BSD
+
+Caveats:
+
+=over
+
+=item time_t issues that may or may not be fixed
+
+=back
+
+
+=item Symbian (Series 60 v3, 3.2 and 5 - what else?)
+
+=item Stratus VOS
+
+=item AIX
+
+=back
+
+=head1 EOL Platforms (Perl 5.12)
+
+The following platforms were supported by a previous version of
+Perl but have been officially removed from Perl's source code
+as of 5.12:
+
+=over
+
+=item Atari MiNT
+
+=item Apollo Domain/OS
+
+=item Apple Mac OS 8/9
+
+=item Tenon Machten
+
+=back
+
+The following platforms may still work as of Perl 5.12, but Perl's
+developers have made an explicit decision to discontinue support for
+them:
+
+=over
+
+=item Windows 95
+
+=item Windows 98
+
+=item Windows ME
+
+=item Windows NT4
+
+=back
+
+=head1 Supported Platforms (Perl 5.8)
 
-As of July 2002 (the Perl release 5.8.0), the following platforms are
+As of July 2002 (the Perl release 5.8.0), the following platforms were
 able to build Perl from the standard source code distribution
-available at http://www.cpan.org/src/index.html
+available at http://www.cpan.org/src/
 
         AIX
         BeOS
@@ -2212,7 +2227,6 @@ of any trouble.
         Greenhills
         ISC
         MachTen 68k
-        MiNT
         MPC
         NEWS-OS
         NextSTEP
@@ -2255,7 +2269,7 @@ http://www.cpan.org/ports/index.html for binary distributions.
 L<perlaix>, L<perlamiga>, L<perlapollo>, L<perlbeos>, L<perlbs2000>,
 L<perlce>, L<perlcygwin>, L<perldgux>, L<perldos>, L<perlepoc>,
 L<perlebcdic>, L<perlfreebsd>, L<perlhurd>, L<perlhpux>, L<perlirix>,
-L<perlmachten>, L<perlmacos>, L<perlmacosx>, L<perlmint>, L<perlmpeix>,
+L<perlmacos>, L<perlmacosx>, L<perlmpeix>,
 L<perlnetware>, L<perlos2>, L<perlos390>, L<perlos400>,
 L<perlplan9>, L<perlqnx>, L<perlsolaris>, L<perltru64>,
 L<perlunicode>, L<perlvmesa>, L<perlvms>, L<perlvos>,