diff options
Diffstat (limited to 'Master/tlpkg/tlperl/lib/pods/perlport.pod')
-rw-r--r-- | Master/tlpkg/tlperl/lib/pods/perlport.pod | 93 |
1 files changed, 55 insertions, 38 deletions
diff --git a/Master/tlpkg/tlperl/lib/pods/perlport.pod b/Master/tlpkg/tlperl/lib/pods/perlport.pod index 9c81e73e445..0193dc852ca 100644 --- a/Master/tlpkg/tlperl/lib/pods/perlport.pod +++ b/Master/tlpkg/tlperl/lib/pods/perlport.pod @@ -480,17 +480,17 @@ file name. To convert $^X to a file pathname, taking account of the requirements of the various operating system possibilities, say: - use Config; - my $thisperl = $^X; - if ($^O ne 'VMS') - {$thisperl .= $Config{_exe} unless $thisperl =~ m/$Config{_exe}$/i;} + use Config; + my $thisperl = $^X; + if ($^O ne 'VMS') + {$thisperl .= $Config{_exe} unless $thisperl =~ m/$Config{_exe}$/i;} To convert $Config{perlpath} to a file pathname, say: - use Config; - my $thisperl = $Config{perlpath}; - if ($^O ne 'VMS') - {$thisperl .= $Config{_exe} unless $thisperl =~ m/$Config{_exe}$/i;} + use Config; + my $thisperl = $Config{perlpath}; + if ($^O ne 'VMS') + {$thisperl .= $Config{_exe} unless $thisperl =~ m/$Config{_exe}$/i;} =head2 Networking @@ -624,7 +624,7 @@ because that is OS- and implementation-specific. It is better to store a date in an unambiguous representation. The ISO 8601 standard defines YYYY-MM-DD as the date format, or YYYY-MM-DDTHH-MM-SS (that's a literal "T" separating the date from the time). -Please do use the ISO 8601 instead of making us to guess what +Please do use the ISO 8601 instead of making us guess what date 02/03/04 might be. ISO 8601 even sorts nicely as-is. A text representation (like "1987-12-18") can be easily converted into an OS-specific value using a module like Date::Parse. @@ -771,11 +771,11 @@ Also see: =item * -Mailing list: cpan-testers@perl.org +Mailing list: cpan-testers-discuss@perl.org =item * -Testing results: http://testers.cpan.org/ +Testing results: L<http://www.cpantesters.org/> =back @@ -929,13 +929,13 @@ Also see: =item * -The djgpp environment for DOS, http://www.delorie.com/djgpp/ +The djgpp environment for DOS, L<http://www.delorie.com/djgpp/> and L<perldos>. =item * The EMX environment for DOS, OS/2, etc. emx@iaehv.nl, -ftp://hobbes.nmsu.edu/pub/os2/dev/emx/ Also L<perlos2>. +L<ftp://hobbes.nmsu.edu/pub/os2/dev/emx/> Also L<perlos2>. =item * @@ -948,17 +948,17 @@ The C<Win32::*> modules in L<Win32>. =item * -The ActiveState Pages, http://www.activestate.com/ +The ActiveState Pages, L<http://www.activestate.com/> =item * The Cygwin environment for Win32; F<README.cygwin> (installed -as L<perlcygwin>), http://www.cygwin.com/ +as L<perlcygwin>), L<http://www.cygwin.com/> =item * The U/WIN environment for Win32, -http://www.research.att.com/sw/tools/uwin/ +L<http://www.research.att.com/sw/tools/uwin/> =item * @@ -1092,7 +1092,7 @@ 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 + $ perl -ne "$_=~s/\s+.*//; print if scalar(split /\//) > 8;" < MANIFEST The VMS::Filespec module, which gets installed as part of the build @@ -1145,7 +1145,7 @@ Also see: =item * -F<README.vms> (installed as L<README_vms>), L<perlvms> +F<README.vms> (installed as F<README_vms>), L<perlvms> =item * @@ -1153,7 +1153,7 @@ vmsperl list, vmsperl-subscribe@perl.org =item * -vmsperl on the web, http://www.sidhe.org/vmsperl/index.html +vmsperl on the web, L<http://www.sidhe.org/vmsperl/index.html> =back @@ -1187,7 +1187,7 @@ feature known as extended names. On these releases, file names can contain up to 255 characters, are prohibited from starting with a C<-> character, and the set of prohibited characters is reduced to any character matching C<< tr/#%*<>?// >>. There are -restrictions involving spaces and apostrophies: these characters +restrictions involving spaces and apostrophes: these characters must not begin or end a name, nor can they immediately precede or follow a period. Additionally, a space must not immediately precede another space or hyphen. Specifically, the following @@ -1229,7 +1229,7 @@ Anonymous FTP site. =item * -VOS Perl on the web at http://ftp.stratus.com/pub/vos/posix/posix.html +VOS Perl on the web at L<http://ftp.stratus.com/pub/vos/posix/posix.html> =back @@ -1298,7 +1298,7 @@ The values of C<$^O> on some of these platforms includes: Some simple tricks for determining if you are running on an EBCDIC platform could include any of the following (perhaps all): - if ("\t" eq "\05") { print "EBCDIC may be spoken here!\n"; } + if ("\t" eq "\005") { print "EBCDIC may be spoken here!\n"; } if (ord('A') == 193) { print "EBCDIC may be spoken here!\n"; } @@ -1327,7 +1327,7 @@ general usage issues for all EBCDIC Perls. Send a message body of =item * AS/400 Perl information at -http://as400.rochester.ibm.com/ +L<http://as400.rochester.ibm.com/> as well as on CPAN in the F<ports/> directory. =back @@ -1470,12 +1470,12 @@ Be OS, F<README.beos> =item * HP 300 MPE/iX, F<README.mpeix> and Mark Bixby's web page -http://www.bixby.org/mark/porting.html +L<http://www.bixby.org/mark/porting.html> =item * A free perl5-based PERL.NLM for Novell Netware is available in -precompiled binary and source code form from http://www.novell.com/ +precompiled binary and source code form from L<http://www.novell.com/> as well as from CPAN. =item * @@ -1618,6 +1618,8 @@ Implemented via Spawn. (VM/ESA) Does not automatically flush output handles on some platforms. (SunOS, Solaris, HP-UX) +Not supported. (Symbian OS) + =item exit Emulates Unix exit() (which considers C<exit 1> to indicate an error) by @@ -1632,17 +1634,23 @@ enabled, a generic number will be encoded in a method compatible with the C library _POSIX_EXIT macro so that it can be decoded by other programs, particularly ones written in C, like the GNV package. (VMS) +C<exit()> resets file pointers, which is a problem when called +from a child process (created by C<fork()>) in C<BEGIN>. +A workaround is to use C<POSIX::_exit>. (Solaris) + + exit unless $Config{archname} =~ /\bsolaris\b/; + require POSIX and POSIX::_exit(0); + =item fcntl Not implemented. (Win32) + Some functions available based on the version of VMS. (VMS) =item flock Not implemented (VMS, S<RISC OS>, VOS). -Available only on Windows NT (not on Windows 95). (Win32) - =item fork Not implemented. (AmigaOS, S<RISC OS>, VM/ESA, VMS) @@ -1833,7 +1841,7 @@ Available on 64 bit OpenVMS 8.2 and later. (VMS) =item localtime -localtime() has the same range as L<gmtime>, but because time zone +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. @@ -1868,6 +1876,12 @@ Not implemented. (Win32, VMS, S<RISC OS>) Can't move directories between directories on different logical volumes. (Win32) +=item rewinddir + +Will not cause readdir() to re-read the directory stream. The entries +already read before the rewinddir() call will just be returned again +from a cache buffer. (Win32) + =item select Only implemented on sockets. (Win32, VMS) @@ -2057,7 +2071,7 @@ Not useful. (S<RISC OS>) The following platforms are known to build Perl 5.12 (as of April 2010, its release date) from the standard source code distribution available -at http://www.cpan.org/src +at L<http://www.cpan.org/src> =over @@ -2105,6 +2119,8 @@ at http://www.cpan.org/src =item FreeBSD +=item Debian GNU/kFreeBSD + =item Haiku =item Irix (6.5. What else?) @@ -2113,6 +2129,8 @@ at http://www.cpan.org/src =item Dragonfly BSD +=item QNX Neutrino RTOS (6.5.0) + =item MirOS BSD Caveats: @@ -2132,7 +2150,7 @@ Caveats: =back -=head1 EOL Platforms (Perl 5.12) +=head1 EOL Platforms (Perl 5.14) The following platforms were supported by a previous version of Perl but have been officially removed from Perl's source code @@ -2150,9 +2168,8 @@ as of 5.12: =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: +The following platforms were supported up to 5.10. They may still +have worked in 5.12, but supporting code has been removed for 5.14: =over @@ -2170,7 +2187,7 @@ them: 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/ +available at L<http://www.cpan.org/src/> AIX BeOS @@ -2275,7 +2292,7 @@ of any trouble. Unisys Dynix The following platforms have their own source code distributions and -binaries available via http://www.cpan.org/ports/ +binaries available via L<http://www.cpan.org/ports/> Perl release @@ -2283,7 +2300,7 @@ binaries available via http://www.cpan.org/ports/ Tandem Guardian 5.004 The following platforms have only binaries available via -http://www.cpan.org/ports/index.html : +L<http://www.cpan.org/ports/index.html> : Perl release @@ -2294,7 +2311,7 @@ http://www.cpan.org/ports/index.html : Although we do suggest that you always build your own Perl from the source code, both for maximal configurability and for security, in case you are in a hurry you can check -http://www.cpan.org/ports/index.html for binary distributions. +L<http://www.cpan.org/ports/index.html> for binary distributions. =head1 SEE ALSO @@ -2341,5 +2358,5 @@ Gurusamy Sarathy <gsar@activestate.com>, Paul J. Schinder <schinder@pobox.com>, Michael G Schwern <schwern@pobox.com>, Dan Sugalski <dan@sidhe.org>, -Nathan Torkington <gnat@frii.com>. +Nathan Torkington <gnat@frii.com>, John Malmberg <wb8tyw@qsl.net> |