From: Jesse Vincent Date: Sun, 18 Oct 2009 18:34:30 +0000 (-0400) Subject: Remove Mac OS Classic caveats from perlport.pod as Perl is no longer portable to... X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=204ad8d57498ad6ce940795f2eb8391c230a1217;p=p5sagit%2Fp5-mst-13.2.git Remove Mac OS Classic caveats from perlport.pod as Perl is no longer portable to Mac OS Classic --- diff --git a/pod/perlport.pod b/pod/perlport.pod index f44ae69..41f28b1 100644 --- a/pod/perlport.pod +++ b/pod/perlport.pod @@ -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, 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. @@ -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 uses C<:> as a path separator instead of C. +S 9 and earlier used C<:> as a path separator instead of C. The filesystem may support neither hard links (C) nor symbolic links (C, C, C). @@ -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 @@ -637,9 +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. +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 @@ -963,85 +963,6 @@ Build instructions for OS/2, L =back -=head2 S - -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, see C and C in the -Mac::Files module, or C and C. - -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, backticks, and piped C. - -"S" 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, 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 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 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 in the perl distribution. @@ -1564,10 +1485,6 @@ L 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) - 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 @@ -1576,18 +1493,12 @@ by discretionary access control lists (DACLs). (S) 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). - 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) C<-R>, C<-W>, C<-X>, C<-O> are indistinguishable from C<-r>, C<-w>, -C<-x>, C<-o>. (S, Win32, VMS, S) - -C<-b>, C<-c>, C<-k>, C<-g>, C<-p>, C<-u>, C<-A> are not implemented. -(S) +C<-x>, C<-o>. (Win32, VMS, S) C<-g>, C<-k>, C<-l>, C<-u>, C<-A> are not particularly meaningful. (Win32, VMS, S) @@ -1597,10 +1508,6 @@ C<-p> is not particularly meaningful. (VMS, S) 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 often. (S) - C<-x> (or C<-X>) determine if a file ends in one of the executable suffixes. C<-S> is meaningless. (Win32) @@ -1620,7 +1527,7 @@ L. =item binmode -Meaningless. (S, S) +Meaningless. (S) Reopens file and restores pointer; if function fails, underlying filehandle may be closed, or pointer may be in a different position. @@ -1631,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) - Only good for changing "owner" read-write access, "group", and "other" bits are meaningless. (Win32) @@ -1646,7 +1550,7 @@ in the SYSTEM environment settings. (Cygwin) =item chown -Not implemented. (S, Win32, S, S) +Not implemented. (Win32, S, S) Does nothing, but won't fail. (Win32) @@ -1654,7 +1558,7 @@ A little funky, because VOS's notion of ownership is a little funky (VOS). =item chroot -Not implemented. (S, Win32, VMS, S, S, VOS, VM/ESA) +Not implemented. (Win32, VMS, S, S, VOS, VM/ESA) =item crypt @@ -1671,7 +1575,7 @@ Not implemented. (VMS, S, VOS) =item dump -Not useful. (S, S) +Not useful. (S) Not supported. (Cygwin, Win32) @@ -1679,8 +1583,6 @@ Invokes VMS debugger. (VMS) =item exec -Not implemented. (S) - Implemented via Spawn. (VM/ESA) Does not automatically flush output handles on some platforms. @@ -1707,13 +1609,13 @@ Some functions available based on the version of VMS. (VMS) =item flock -Not implemented (S, VMS, S, VOS). +Not implemented (VMS, S, VOS). Available only on Windows NT (not on Windows 95). (Win32) =item fork -Not implemented. (S, AmigaOS, S, VM/ESA, VMS) +Not implemented. (AmigaOS, S, VM/ESA, VMS) Emulated using multiple interpreters. See L. (Win32) @@ -1722,80 +1624,76 @@ Does not automatically flush output handles on some platforms. =item getlogin -Not implemented. (S, S) +Not implemented. (S) =item getpgrp -Not implemented. (S, Win32, VMS, S) +Not implemented. (Win32, VMS, S) =item getppid -Not implemented. (S, Win32, S) +Not implemented. (Win32, S) =item getpriority -Not implemented. (S, Win32, VMS, S, VOS, VM/ESA) +Not implemented. (Win32, VMS, S, VOS, VM/ESA) =item getpwnam -Not implemented. (S, Win32) +Not implemented. (Win32) Not useful. (S) =item getgrnam -Not implemented. (S, Win32, VMS, S) +Not implemented. (Win32, VMS, S) =item getnetbyname -Not implemented. (S, Win32, S) +Not implemented. (Win32, S) =item getpwuid -Not implemented. (S, Win32) +Not implemented. (Win32) Not useful. (S) =item getgrgid -Not implemented. (S, Win32, VMS, S) +Not implemented. (Win32, VMS, S) =item getnetbyaddr -Not implemented. (S, Win32, S) +Not implemented. (Win32, S) =item getprotobynumber -Not implemented. (S) - =item getservbyport -Not implemented. (S) - =item getpwent -Not implemented. (S, Win32, VM/ESA) +Not implemented. (Win32, VM/ESA) =item getgrent -Not implemented. (S, Win32, VMS, VM/ESA) +Not implemented. (Win32, VMS, VM/ESA) =item gethostbyname C does not work everywhere: you may have -to use C. (S, S) +to use C. (S) =item gethostent -Not implemented. (S, Win32) +Not implemented. (Win32) =item getnetent -Not implemented. (S, Win32, S) +Not implemented. (Win32, S) =item getprotoent -Not implemented. (S, Win32, S) +Not implemented. (Win32, S) =item getservent @@ -1803,15 +1701,15 @@ Not implemented. (Win32, S) =item sethostent -Not implemented. (S, Win32, S, S) +Not implemented. (Win32, S, S) =item setnetent -Not implemented. (S, Win32, S, S) +Not implemented. (Win32, S, S) =item setprotoent -Not implemented. (S, Win32, S, S) +Not implemented. (Win32, S, S) =item setservent @@ -1819,23 +1717,23 @@ Not implemented. (S, Win32, S) =item endpwent -Not implemented. (S, MPE/iX, VM/ESA, Win32) +Not implemented. (MPE/iX, VM/ESA, Win32) =item endgrent -Not implemented. (S, MPE/iX, S, VM/ESA, VMS, Win32) +Not implemented. (MPE/iX, S, VM/ESA, VMS, Win32) =item endhostent -Not implemented. (S, Win32) +Not implemented. (Win32) =item endnetent -Not implemented. (S, Win32, S) +Not implemented. (Win32, S) =item endprotoent -Not implemented. (S, Win32, S) +Not implemented. (Win32, S) =item endservent @@ -1868,9 +1766,6 @@ Available only for socket handles. (S) =item kill -C is implemented for the sake of taint checking; -use with other signals is unimplemented. (S) - Not implemented, hence not useful for taint checking. (S) C doesn't have the semantics of C, i.e. it doesn't send @@ -1891,7 +1786,7 @@ numbers. (VMS) =item link -Not implemented. (S, MPE/iX, S) +Not implemented. (MPE/iX, S) Link count not updated because hard links are not quite that hard (They are sort of half-way between hard and soft links). (AmigaOS) @@ -1924,14 +1819,11 @@ Return values (especially for device and inode) may be bogus. (Win32) =item msgrcv -Not implemented. (S, Win32, VMS, S, S, VOS) +Not implemented. (Win32, VMS, S, S, VOS) =item open -The C<|> variants are supported only if ToolServer is installed. -(S) - -open to C<|-> and C<-|> are unsupported. (S, Win32, S) +open to C<|-> and C<-|> are unsupported. (Win32, S) Opening a process does not automatically flush output handles on some platforms. (SunOS, Solaris, HP-UX) @@ -1958,23 +1850,23 @@ Note that the C