X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlport.pod;h=65ca9d8a3aaef8d8b1551210d6c9ecd835d3d3ba;hb=522b859adcc800ddbbe593fba580633bb305644f;hp=7ec23096976dfb606e492767f34a5ef4c688f15b;hpb=c40b5d1d4ac4304e78466da597926abb31c7b9e5;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perlport.pod b/pod/perlport.pod index 7ec2309..65ca9d8 100644 --- a/pod/perlport.pod +++ b/pod/perlport.pod @@ -104,7 +104,7 @@ newlines: #... } -You can get away with this on Unix and MacOS (they have a single +You can get away with this on Unix and Mac OS (they have a single character end-of-line), but the same program will break under DOSish perls because you're only chop()ing half the end-of-line. Instead, chomp() should be used to trim newlines. The Dunce::Files module can @@ -188,9 +188,9 @@ The Unix column assumes that you are not accessing a serial line "\n", and "\n" on output becomes CRLF. These are just the most common definitions of C<\n> and C<\r> in Perl. -There may well be others. For example, on an EBCDIC implementation such -as z/OS or OS/400 the above material is similar to "Unix" but the code -numbers change: +There may well be others. For example, on an EBCDIC implementation +such as z/OS (OS/390) or OS/400 (using the ILE, the PASE is ASCII-based) +the above material is similar to "Unix" but the code numbers change: LF eq \025 eq \x15 eq chr(21) eq CP-1047 21 LF eq \045 eq \x25 eq \cU eq chr(37) eq CP-0037 37 @@ -373,7 +373,7 @@ Three-arg open can also help protect against this translation in cases 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, +their own semantics (Mac OS Classic for separating pathname components, many networking schemes and utilities for separating the nodename and the pathname, and so on). For the same reasons, avoid C<@>, C<;> and C<|>. @@ -832,6 +832,13 @@ Win32::GetOSVersion(). For example: print +('3.1','95','NT')[$os_version_info[4]],"\n"; } +There are also Win32::IsWinNT() and Win32::IsWin95(), try C, +and as of libwin32 0.19 (not part of the core Perl distribution) +Win32::GetOSName(). The very portable POSIX::uname() will work too: + + c:\> perl -MPOSIX -we "print join '|', uname" + Windows NT|moonru|5.0|Build 2195 (Service Pack 2)|x86 + Also see: =over 4 @@ -1086,13 +1093,6 @@ 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. -Perl on VOS can be built using two different compilers and two different -versions of the POSIX runtime. The recommended method for building full -Perl is with the GNU C compiler and the generally-available version of -VOS POSIX support. See F (installed as L) for -restrictions that apply when Perl is built using the VOS Standard C -compiler or the alpha version of VOS POSIX support. - 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 can examine the content of the @INC array like so: @@ -1104,19 +1104,6 @@ can examine the content of the @INC array like so: die; } - if (grep(/860/, @INC)) { - print "This box is a Stratus XA/R!\n"; - - } elsif (grep(/7100/, @INC)) { - print "This box is a Stratus HP 7100 or 8xxx!\n"; - - } elsif (grep(/8000/, @INC)) { - print "This box is a Stratus HP 8xxx!\n"; - - } else { - print "This box is a Stratus 68K!\n"; - } - Also see: =over 4 @@ -1149,7 +1136,9 @@ Character Code Set ID 0037 for OS/400 and either 1047 or POSIX-BC for S/390 systems). On the mainframe perl currently works under the "Unix system services for OS/390" (formerly known as OpenEdition), VM/ESA OpenEdition, or the BS200 POSIX-BC system (BS2000 is supported in perl 5.6 and greater). -See L for details. +See L for details. Note that for OS/400 there is also a port of +Perl 5.8.1/5.9.0 or later to the PASE which is ASCII-based (as opposed to +ILE which is EBCDIC-based), see L. As of R2.5 of USS for OS/390 and Version 2.3 of VM/ESA these Unix sub-systems do not support the C<#!> shebang trick for script invocation. @@ -1392,7 +1381,7 @@ as well as from CPAN. =item * -Plan 9, F +S, F =back @@ -1495,30 +1484,30 @@ in the SYSTEM environment settings. (Cygwin) =item chown LIST -Not implemented. (S, Win32, Plan9, S, VOS) +Not implemented. (S, Win32, S, S) Does nothing, but won't fail. (Win32) +A little funky, because VOS's notion of ownership is a little funky (VOS). + =item chroot FILENAME =item chroot -Not implemented. (S, Win32, VMS, Plan9, S, VOS, VM/ESA) +Not implemented. (S, Win32, VMS, S, S, VOS, VM/ESA) =item crypt PLAINTEXT,SALT May not be available if library or source was not provided when building perl. (Win32) -Not implemented. (VOS) - =item dbmclose HASH -Not implemented. (VMS, Plan9, VOS) +Not implemented. (VMS, S, VOS) =item dbmopen HASH,DBNAME,MODE -Not implemented. (VMS, Plan9, VOS) +Not implemented. (VMS, S, VOS) =item dump LABEL @@ -1560,7 +1549,7 @@ Available only on Windows NT (not on Windows 95). (Win32) =item fork -Not implemented. (S, AmigaOS, S, VOS, VM/ESA) +Not implemented. (S, AmigaOS, S, VM/ESA, VMS) Emulated using multiple interpreters. See L. (Win32) @@ -1573,11 +1562,11 @@ Not implemented. (S, S) =item getpgrp PID -Not implemented. (S, Win32, VMS, S, VOS) +Not implemented. (S, Win32, VMS, S) =item getppid -Not implemented. (S, Win32, VMS, S) +Not implemented. (S, Win32, S) =item getpriority WHICH,WHO @@ -1595,7 +1584,7 @@ Not implemented. (S, Win32, VMS, S) =item getnetbyname NAME -Not implemented. (S, Win32, Plan9) +Not implemented. (S, Win32, S) =item getpwuid UID @@ -1609,7 +1598,7 @@ Not implemented. (S, Win32, VMS, S) =item getnetbyaddr ADDR,ADDRTYPE -Not implemented. (S, Win32, Plan9) +Not implemented. (S, Win32, S) =item getprotobynumber NUMBER @@ -1633,31 +1622,31 @@ Not implemented. (S, Win32) =item getnetent -Not implemented. (S, Win32, Plan9) +Not implemented. (S, Win32, S) =item getprotoent -Not implemented. (S, Win32, Plan9) +Not implemented. (S, Win32, S) =item getservent -Not implemented. (Win32, Plan9) +Not implemented. (Win32, S) =item sethostent STAYOPEN -Not implemented. (S, Win32, Plan9, S) +Not implemented. (S, Win32, S, S) =item setnetent STAYOPEN -Not implemented. (S, Win32, Plan9, S) +Not implemented. (S, Win32, S, S) =item setprotoent STAYOPEN -Not implemented. (S, Win32, Plan9, S) +Not implemented. (S, Win32, S, S) =item setservent STAYOPEN -Not implemented. (Plan9, Win32, S) +Not implemented. (S, Win32, S) =item endpwent @@ -1673,19 +1662,19 @@ Not implemented. (S, Win32) =item endnetent -Not implemented. (S, Win32, Plan9) +Not implemented. (S, Win32, S) =item endprotoent -Not implemented. (S, Win32, Plan9) +Not implemented. (S, Win32, S) =item endservent -Not implemented. (Plan9, Win32) +Not implemented. (S, Win32) =item getsockopt SOCKET,LEVEL,OPTNAME -Not implemented. (Plan9) +Not implemented. (S) =item glob EXPR @@ -1745,7 +1734,7 @@ Return values (especially for device and inode) may be bogus. (Win32) =item msgrcv ID,VAR,SIZE,TYPE,FLAGS -Not implemented. (S, Win32, VMS, Plan9, S, VOS) +Not implemented. (S, Win32, VMS, S, S, VOS) =item open FILEHANDLE,EXPR @@ -1787,7 +1776,7 @@ Not implemented. (S, Win32, VMS, S, VOS) =item setgrent -Not implemented. (S, MPE/iX, VMS, Win32, VMS, S) +Not implemented. (S, MPE/iX, VMS, Win32, S, VOS) =item setpgrp PID,PGRP @@ -1799,11 +1788,11 @@ Not implemented. (S, Win32, VMS, S, VOS) =item setpwent -Not implemented. (S, MPE/iX, Win32, S) +Not implemented. (S, MPE/iX, Win32, S, VOS) =item setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL -Not implemented. (Plan9) +Not implemented. (S) =item shmctl ID,CMD,ARG @@ -1932,7 +1921,7 @@ Not useful. (S) Not implemented. (Older versions of VMS) -Truncation to zero-length only. (VOS) +Truncation to same-or-shorter lengths only. (VOS) If a FILEHANDLE is supplied, it must be writable and opened in append mode (i.e., use C<<< open(FH, '>>filename') >>> @@ -1962,7 +1951,7 @@ two seconds. (Win32) =item waitpid PID,FLAGS -Not implemented. (S, VOS) +Not implemented. (S) Can only be applied to process handles returned for processes spawned using C or pseudo processes created with C. (Win32) @@ -1975,6 +1964,10 @@ Not useful. (S) =over 4 +=item v1.49, 12 August 2002 + +Updates for VOS from Paul Green. + =item v1.48, 02 February 2001 Various updates from perl5-porters over the past year, supported @@ -2062,7 +2055,7 @@ First public release with perl5.005. =head1 Supported Platforms -As of June 2002 (the Perl release 5.8.0), the following platforms are +As of July 2002 (the Perl release 5.8.0), the following platforms are able to build Perl from the standard source code distribution available at http://www.cpan.org/src/index.html @@ -2077,8 +2070,8 @@ available at http://www.cpan.org/src/index.html HP-UX IRIX Linux - MacOS Classic - MacOS X (Darwin) + Mac OS Classic + Mac OS X (Darwin) MPE/iX NetBSD NetWare @@ -2087,42 +2080,45 @@ available at http://www.cpan.org/src/index.html OpenBSD OpenVMS (VMS) OS/2 + OS/400 (using the PASE) (since Perl 5.8.1/5.9.0) + PowerUX POSIX-BC (BS2000) QNX Solaris + SunOS 4 + SUPER-UX Tru64 UNIX (DEC OSF/1, Digital UNIX) UNICOS UNICOS/mk UTS VOS - Win32/NT/2K 2) + Win95/98/ME/2K/XP 2) WinCE z/OS (OS/390) VM/ESA 1) in DOS mode either the DOS or OS/2 ports can be used - 2) compilers: Borland, Cygwin (GCC), MinGW (GCC), VC6 + 2) compilers: Borland, MinGW (GCC), VC6 The following platforms worked with the previous releases (5.6 and 5.7), but we did not manage either to fix or to test these in time for the 5.8.0 release. There is a very good chance that many of these -will work fine with the 5.8.0. The only one known for certain to be -broken for 5.8.0 is the AmigaOS. +will work fine with the 5.8.0. - AmigaOS + BSD/OS DomainOS Hurd LynxOS MachTen PowerMAX SCO SV - SunOS 4 SVR4 Unixware Windows 3.1 - Windows 95 - Windows 98 - Windows Me + +Known to be broken for 5.8.0 (but 5.6.1 and 5.7.2 can be used): + + AmigaOS The following platforms have been known to build Perl from source in the past (5.005_03 and earlier), but we haven't been able to verify @@ -2134,7 +2130,6 @@ of any trouble. 3b1 A/UX - BSD/OS ConvexOS CX/UX DC/OSx @@ -2155,24 +2150,21 @@ of any trouble. OpenSTEP Opus Plan 9 - PowerUX RISC/os - SCO ODT/OSR + SCO ODT/OSR Stellar SVR2 TI1500 TitanOS Ultrix Unisys Dynix - Unixware - UTS The following platforms have their own source code distributions and binaries available via http://www.cpan.org/ports/ Perl release - OS/400 5.005_02 + OS/400 (ILE) 5.005_02 Tandem Guardian 5.004 The following platforms have only binaries available via @@ -2192,11 +2184,13 @@ http://www.cpan.org/ports/index.html for binary distributions. =head1 SEE ALSO L, L, L, L, L, -L, L, L, L, L, L, -L, L, L, L, L, -L, L, L, L, L, -L, L, L, L, -L, L, L, L, and L. +L, L, L, L, L, +L, L, L, L, L, +L, L, L, L, +L, L, L, L, +L, L, L, L, +L, L, L, L, +L, and L. =head1 AUTHORS / CONTRIBUTORS @@ -2210,7 +2204,7 @@ Andy Dougherty , Dominic Dunlop , Neale Ferguson , David J. Fiander , -Paul Green , +Paul Green , M.J.T. Guy , Jarkko Hietaniemi , Luther Huffman ,