From: Rafael Garcia-Suarez Date: Fri, 12 Mar 2004 23:39:16 +0000 (+0000) Subject: perl591delta nits. Regenerate the tables of contents. X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=f99d9048b891f4a31bd48eef7bd16fa99bfd812a;p=p5sagit%2Fp5-mst-13.2.git perl591delta nits. Regenerate the tables of contents. p4raw-id: //depot/perl@22493 --- diff --git a/pod/perl591delta.pod b/pod/perl591delta.pod index a120c31..a0c966b 100644 --- a/pod/perl591delta.pod +++ b/pod/perl591delta.pod @@ -44,8 +44,8 @@ overriding the lexical declaration with C. =head2 Tied hashes in scalar context -As of perl 5.8.2, tied hashes did not return anything useful in scalar -context, for example when used as boolean tests: +As of perl 5.8.2/5.9.0, tied hashes did not return anything useful in +scalar context, for example when used as boolean tests: if (%tied_hash) { ... } @@ -127,11 +127,11 @@ The documentation has been revised in places to produce more standard manpages. The long-existing feature of C regexps setting C<$_> and pos() is now documented. +=head1 Performance Enhancements + Sorting arrays in place (C<@a = sort @a>) is now optimized to avoid making a temporary copy of the array. -=head1 Performance Enhancements - The operations involving case mapping on UTF-8 strings (uc(), lc(), C, etc.) have been greatly speeded up. @@ -171,9 +171,6 @@ Reading $^E now preserves $!. Previously, the C code implementing $^E did not preserve C, so reading $^E could cause C and therefore C<$!> to change unexpectedly. -Reentrant functions will (once more) work with C++. 5.8.2 introduced a bugfix -which accidentally broke the compilation of Perl extensions written in C++. - C wasn't in effect in regexp-eval blocks (C). =head1 New or Changed Diagnostics @@ -261,8 +258,10 @@ list of things to do (or nice to have) for perl 5.10.0 : Clean up and finish support for assertions. See L. Reimplement the mechanism of lexical pragmas to be more extensible. Fix -current pragmas that don't work well with lexical scopes (C, for -example). MJD has ideas on this. +current pragmas that don't work well with lexical scopes or in +eval(STRING) (C, C for example). MJD has ideas on this. + +Fix (or rewrite) the implementation of the C closures. Conversions from byte strings to UTF-8 currently map high bit characters to Unicode without translation (or, depending on how you look at it, by @@ -276,7 +275,7 @@ XS coders miserable.) Introduce a new special block, UNITCHECK, which is run at the end of a compilation unit (module, file, eval(STRING) block). This will correspond to the Perl 6 CHECK. Perl 5's CHECK cannot be changed or removed because the -O/B framework depends on it. +O.pm/B.pm backend framework depends on it. Study the possibility of adding a new prototype character, C<_>, meaning "this argument defaults to $_". diff --git a/pod/perlmodlib.pod b/pod/perlmodlib.pod index 4df51c4..d76b5c1 100644 --- a/pod/perlmodlib.pod +++ b/pod/perlmodlib.pod @@ -69,7 +69,7 @@ Postpone load of modules until a function is used =item base -Establish IS-A relationship with base class at compile time +Establish IS-A relationship with base classes at compile time =item bigint @@ -359,7 +359,7 @@ Warn of errors (from perspective of caller) =item Carp::Heavy -No user serviceable parts inside +Heavy machinery, no user serviceable parts inside =item Class::ISA @@ -381,6 +381,10 @@ Get pathname of current working directory Programmatic interface to the Perl debugging API (draft, subject to +=item DBM_Filter + +Filter DBM keys/values + =item DB_File Perl5 access to Berkeley DB version 1.x @@ -917,9 +921,13 @@ Arbitrary size integer math package Pure Perl module to support Math::BigInt +=item Math::BigInt::CalcEmu + +Emulate low-level math with BigInt code + =item Math::BigRat -Arbitrarily big rationals +Arbitrarily big rational numbers =item Math::Complex diff --git a/pod/perltoc.pod b/pod/perltoc.pod index c2ac02d..ebad35b 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -3619,20 +3619,21 @@ B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash, B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util, CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA, -Class::Struct, Config, Cwd, DB, DB_File, Data::Dumper, Devel::DProf, -Devel::PPPort, Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5, -Digest::base, DirHandle, Dumpvalue, DynaLoader, Encode, Encode::Alias, -Encode::Byte, Encode::CJKConstants, Encode::CN, Encode::CN::HZ, -Encode::Config, Encode::EBCDIC, Encode::Encoder, Encode::Encoding, -Encode::Guess, Encode::JP, Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR, -Encode::KR::2022_KR, Encode::MIME::Header, Encode::PerlIO, -Encode::Supported, Encode::Symbol, Encode::TW, Encode::Unicode, -Encode::Unicode::UTF7, English, Env, Errno, Exporter, Exporter::Heavy, -ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant, -ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist, -ExtUtils::MM, ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, -ExtUtils::MM_DOS, ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, -ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32, +Class::Struct, Config, Cwd, DB, DBM_Filter, DB_File, Data::Dumper, +Devel::DProf, Devel::PPPort, Devel::Peek, Devel::SelfStubber, Digest, +Digest::MD5, Digest::base, DirHandle, Dumpvalue, DynaLoader, Encode, +Encode::Alias, Encode::Byte, Encode::CJKConstants, Encode::CN, +Encode::CN::HZ, Encode::Config, Encode::EBCDIC, Encode::Encoder, +Encode::Encoding, Encode::Guess, Encode::JP, Encode::JP::H2Z, +Encode::JP::JIS7, Encode::KR, Encode::KR::2022_KR, Encode::MIME::Header, +Encode::PerlIO, Encode::Supported, Encode::Symbol, Encode::TW, +Encode::Unicode, Encode::Unicode::UTF7, English, Env, Errno, Exporter, +Exporter::Heavy, ExtUtils::Command, ExtUtils::Command::MM, +ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install, +ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_Any, +ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS, +ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_UWIN, +ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32, ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker, ExtUtils::MakeMaker::FAQ, ExtUtils::MakeMaker::Tutorial, ExtUtils::MakeMaker::bytes, ExtUtils::MakeMaker::vmsish, @@ -3651,16 +3652,16 @@ IPC::SysV::Semaphore, List::Util, Locale::Constants, Locale::Country, Locale::Currency, Locale::Language, Locale::Maketext, Locale::Maketext::TPJ13, Locale::Script, MIME::Base64, MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt, -Math::BigInt::Calc, Math::BigRat, Math::Complex, Math::Trig, Memoize, -Memoize::AnyDBM_File, Memoize::Expire, Memoize::ExpireFile, -Memoize::ExpireTest, Memoize::NDBM_File, Memoize::SDBM_File, -Memoize::Storable, NDBM_File, NEXT, Net::Cmd, Net::Config, Net::Domain, -Net::FTP, Net::NNTP, Net::Netrc, Net::POP3, Net::Ping, Net::SMTP, -Net::Time, Net::hostent, Net::libnetFAQ, Net::netent, Net::protoent, -Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO, PerlIO::encoding, -PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint, Pod::Checker, -Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects, Pod::LaTeX, -Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser, +Math::BigInt::Calc, Math::BigInt::CalcEmu, Math::BigRat, Math::Complex, +Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire, +Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File, +Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT, Net::Cmd, +Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3, +Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent, +Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO, +PerlIO::encoding, PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint, +Pod::Checker, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects, +Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser, Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff, Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText, Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer, @@ -4242,6 +4243,8 @@ C, C, C =item The RETVAL Variable +=item Returning SVs, AVs and HVs through RETVAL + =item The MODULE Keyword =item The PACKAGE Keyword @@ -4731,15 +4734,15 @@ newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIsCOW, SvIsCOW_shared_hash, SvIV, SvIVx, SvIVX, SvIV_nomg, SvLEN, SvNIOK, SvNIOKp, -SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX, -SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only, +SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVx, +SvNVX, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only, SvPOK_only_UTF8, SvPV, SvPVbyte, SvPVbytex, SvPVbytex_force, SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, SvPVutf8x, SvPVutf8x_force, -SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX, SvPV_force, SvPV_force_nomg, +SvPVutf8_force, SvPVutf8_nolen, SvPVX, SvPVx, SvPV_force, SvPV_force_nomg, SvPV_nolen, SvPV_nomg, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on, SvTRUE, SvTYPE, SvUNLOCK, SvUOK, SvUPGRADE, SvUTF8, -SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, SvUV_nomg, SvVOK, sv_2bool, +SvUTF8_off, SvUTF8_on, SvUV, SvUVx, SvUVX, SvUV_nomg, SvVOK, sv_2bool, sv_2cv, sv_2io, sv_2iv_flags, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen, sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv_flags, sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, @@ -5505,7 +5508,7 @@ B<-V> =back -=head2 perl591delta, perldelta - what is new for perl v5.9.1 +=head2 perldelta - what is new for perl v5.9.1 =over 4 @@ -5513,6 +5516,14 @@ B<-V> =item Incompatible Changes +=over 4 + +=item substr() lvalues are no longer fixed-length + +=item The C<:unique> attribute is only meaningful for globals + +=back + =item Core Enhancements =over 4 @@ -5523,15 +5534,99 @@ B<-V> =item Formats +=item Stacked filetest operators + +=back + +=item Modules and Pragmata + +Benchmark, Carp, Exporter, FindBin, List::Util, threads::shared + +=item Utility Changes + +=item Documentation + +=item Performance Enhancements + +=item Selected Bug Fixes + +=over 4 + +=item UTF-8 bugs + +=item Threading bugs + +=item More bugs + +=back + +=item New or Changed Diagnostics + +=item Changed Internals + +=over 4 + +=item Reordering of SVt_* constants + +=item Removal of CPP symbols + +=item Less space is used by ops + +=item New parser + +=back + +=item Configuration and Building + +=item Known Problems + +=over 4 + +=item Platform Specific Problems + +=back + +=item To-do for perl 5.10.0 + +=item Reporting Bugs + +=item SEE ALSO + +=back + +=head2 perl591delta, perldelta - what is new for perl v5.9.1 + +=over 4 + +=item DESCRIPTION + +=item Incompatible Changes + +=over 4 + +=item substr() lvalues are no longer fixed-length + =item The C<:unique> attribute is only meaningful for globals +=back + +=item Core Enhancements + +=over 4 + +=item Lexical C<$_> + +=item Tied hashes in scalar context + +=item Formats + =item Stacked filetest operators =back =item Modules and Pragmata -Carp, Exporter, FindBin, List::Util, threads::shared +Benchmark, Carp, Exporter, FindBin, List::Util, threads::shared =item Utility Changes @@ -5539,13 +5634,11 @@ Carp, Exporter, FindBin, List::Util, threads::shared =item Performance Enhancements -=item Installation and Configuration Improvements - =item Selected Bug Fixes =over 4 -=item UTF8 bugs +=item UTF-8 bugs =item Threading bugs @@ -5557,14 +5650,30 @@ Carp, Exporter, FindBin, List::Util, threads::shared =item Changed Internals -=item Configuration and Building +=over 4 -=item New Tests +=item Reordering of SVt_* constants + +=item Removal of CPP symbols + +=item Less space is used by ops + +=item New parser + +=back + +=item Configuration and Building =item Known Problems +=over 4 + =item Platform Specific Problems +=back + +=item To-do for perl 5.10.0 + =item Reporting Bugs =item SEE ALSO @@ -7433,298 +7542,1716 @@ improvements, Incompatible changes =item prototype() returns useful results on builtins -=item Extended support for exception handling +=item Extended support for exception handling + +=item Re-blessing in DESTROY() supported for chaining DESTROY() methods + +=item All C format conversions are handled internally + +=item New C keyword + +=item New C keyword + +=item New C operator + +=item C is now a reserved word + +=item Tied arrays are now fully supported + +=item Tied handles support is better + +=item 4th argument to substr + +=item Negative LENGTH argument to splice + +=item Magic lvalues are now more magical + +=item <> now reads in records + +=back + +=item Supported Platforms + +=over 4 + +=item New Platforms + +=item Changes in existing support + +=back + +=item Modules and Pragmata + +=over 4 + +=item New Modules + +B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed, +ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle, +Thread, attrs, fields, re + +=item Changes in existing modules + +Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File, +MakeMaker, CPAN, Cwd + +=back + +=item Utility Changes + +=item Documentation Changes + +=item New Diagnostics + +Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index +while coercing array into hash, Bareword "%s" refers to nonexistent +package, Can't call method "%s" on an undefined value, Can't check +filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't +goto subroutine from an eval-string, Can't localize pseudo-hash element, +Can't use %%! because Errno.pm is not available, Cannot find an opnumber +for "%s", Character class syntax [. .] is reserved for future extensions, +Character class syntax [: :] is reserved for future extensions, Character +class syntax [= =] is reserved for future extensions, %s: Eval-group in +insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s: +Eval-group not allowed at run time, Explicit blessing to '' (assuming +package main), Illegal hex digit ignored, No such array field, No such +field "%s" in variable %s of type %s, Out of memory during ridiculously +large request, Range iterator outside integer range, Recursive inheritance +detected while looking for method '%s' %s, Reference found where even-sized +list expected, Undefined value assigned to typeglob, Use of reserved word +"%s" is deprecated, perl: warning: Setting locale failed + +=item Obsolete Diagnostics + +Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open +temporary file, regexp too big + +=item Configuration Changes + +=item BUGS + +=item SEE ALSO + +=item HISTORY + +=back + +=head2 perl5004delta - what's new for perl5.004 + +=over 4 + +=item DESCRIPTION + +=item Supported Environments + +=item Core Changes + +=over 4 + +=item List assignment to %ENV works + +=item Change to "Can't locate Foo.pm in @INC" error + +=item Compilation option: Binary compatibility with 5.003 + +=item $PERL5OPT environment variable + +=item Limitations on B<-M>, B<-m>, and B<-T> options + +=item More precise warnings + +=item Deprecated: Inherited C for non-methods + +=item Previously deprecated %OVERLOAD is no longer usable + +=item Subroutine arguments created only when they're modified + +=item Group vector changeable with C<$)> + +=item Fixed parsing of $$, &$, etc. + +=item Fixed localization of $, $&, etc. + +=item No resetting of $. on implicit close + +=item C may return undef + +=item C determines value of EXPR in scalar context + +=item Changes to tainting checks + +No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No +spawning if tainted $TERM doesn't look like a terminal name + +=item New Opcode module and revised Safe module + +=item Embedding improvements + +=item Internal change: FileHandle class based on IO::* classes + +=item Internal change: PerlIO abstraction interface + +=item New and changed syntax + +$coderef->(PARAMS) + +=item New and changed builtin constants + +__PACKAGE__ + +=item New and changed builtin variables + +$^E, $^H, $^M + +=item New and changed builtin functions + +delete on slices, flock, printf and sprintf, keys as an lvalue, my() in +Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module +VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C does not +reset search position on failure, C ignores whitespace before ?*+{}, +nested C closures work now, formats work right on changing lexicals + +=item New builtin methods + +isa(CLASS), can(METHOD), VERSION( [NEED] ) + +=item TIEHANDLE now supported + +TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this +LIST, READLINE this, GETC this, DESTROY this + +=item Malloc enhancements + +-DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE + +=item Miscellaneous efficiency enhancements + +=back + +=item Support for More Operating Systems + +=over 4 + +=item Win32 + +=item Plan 9 + +=item QNX + +=item AmigaOS + +=back + +=item Pragmata + +use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use +constant NAME => VALUE, use locale, use ops, use vmsish + +=item Modules + +=over 4 + +=item Required Updates + +=item Installation directories + +=item Module information summary + +=item Fcntl + +=item IO + +=item Math::Complex + +=item Math::Trig + +=item DB_File + +=item Net::Ping + +=item Object-oriented overrides for builtin operators + +=back + +=item Utility Changes + +=over 4 + +=item pod2html + +Sends converted HTML to standard output + +=item xsubpp + +C XSUBs now default to returning nothing + +=back + +=item C Language API Changes + +C and C, C, Extended API for +manipulating hashes + +=item Documentation Changes + +L, L, L, L, L, +L, L, L + +=item New Diagnostics + +"my" variable %s masks earlier declaration in same scope, %s argument is +not a HASH element or slice, Allocation too large: %lx, Allocation too +large, Applying %s to %s will act on scalar(%s), Attempt to free +nonexistent shared string, Attempt to use reference as lvalue in substr, +Bareword "%s" refers to nonexistent package, Can't redefine active sort +subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in +use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant +subroutine %s redefined, Constant subroutine %s undefined, Copy method did +not return a reference, Died, Exiting pseudo-block via %s, Identifier too +long, Illegal character %s (carriage return), Illegal switch in PERL5OPT: +%s, Integer overflow in hex number, Integer overflow in octal number, +internal error: glob failed, Invalid conversion in %s: "%s", Invalid type +in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once: +possible typo, Null picture in formline, Offset outside string, Out of +memory!, Out of memory during request for %s, panic: frexp, Possible +attempt to put comments in qw() list, Possible attempt to separate words +with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found +while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>" +option, untie attempted while %d inner references still exist, Unrecognized +character %s, Unsupported function fork, Use of "$$" to mean +"${$}" is deprecated, Value of %s can be "0"; test with defined(), +Variable "%s" may be unavailable, Variable "%s" will not stay shared, +Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter, +Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too +long, Process terminated by SIG%s + +=item BUGS + +=item SEE ALSO + +=item HISTORY + +=back + +=head2 perlartistic - the Perl Artistic License + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item The "Artistic License" + +=over 4 + +=item Preamble + +=item Definitions + +"Package", "Standard Version", "Copyright Holder", "You", "Reasonable +copying fee", "Freely Available" + +=item Conditions + +a), b), c), d), a), b), c), d) + +=back + +=back + +=head2 perlgpl - the GNU General Public License, version 2 + +=over 4 + +=item SYNOPSIS + +=back + +=over 4 + +=item DESCRIPTION + +=item GNU GENERAL PUBLIC LICENSE + +=back + +=head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Compiling Perl 5 on AIX + +=item OS level + +=item Building Dynamic Extensions on AIX + +=item The IBM ANSI C Compiler + +=item The usenm option + +=item Using GNU's gcc for building perl + +=item Using Large Files with Perl + +=item Threaded Perl + +=item 64-bit Perl + +=item AIX 4.2 and extensions using C++ with statics + +=back + +=item AUTHOR + +=item DATE + +=back + +=head2 perlamiga - Perl under Amiga OS + +=over 4 + +=item NOTE + +=item SYNOPSIS + +=back + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Prerequisites for Compiling Perl on AmigaOS + +B, B + +=item Starting Perl programs under AmigaOS + +=item Shortcomings of Perl under AmigaOS + +=back + +=item INSTALLATION + +=item Accessing documentation + +=over 4 + +=item Manpages for Perl on AmigaOS + +=item Perl HTML Documentation on AmigaOS + +=item Perl GNU Info Files on AmigaOS + +=item Perl LaTeX Documentation on AmigaOS + +=back + +=item BUILDING PERL ON AMIGAOS + +=over 4 + +=item Build Prerequisites for Perl on AmigaOS + +=item Getting the Perl Source for AmigaOS + +=item Making Perl on AmigaOS + +=item Testing Perl on AmigaOS + +=item Installing the built Perl on AmigaOS + +=back + +=item PERL 5.8.0 BROKEN IN AMIGAOS + +=item AUTHORS + +=item SEE ALSO + +=back + +=head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS + +=over 4 + +=item DESCRIPTION + +=item AUTHOR + +=back + +=head2 perlbeos, README.beos - Perl version 5 on BeOS + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item General Issues with Perl on BeOS + +=item BeOS Release-specific Notes + +R4 x86, R4 PPC + +=item Contact Information + +=item Update 2002-05-30 + +=back + +=back + +=head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item gzip on BS2000 + +=item bison on BS2000 + +=item Unpacking Perl Distribution on BS2000 + +=item Compiling Perl on BS2000 + +=item Testing Perl on BS2000 + +=item Installing Perl on BS2000 + +=item Using Perl in the Posix-Shell of BS2000 + +=item Using Perl in "native" BS2000 + +=item Floating point anomalies on BS2000 + +=item Using PerlIO and different encodings on ASCII and EBCDIC partitions + +=back + +=item AUTHORS + +=item SEE ALSO + +=over 4 + +=item Mailing list + +=back + +=item HISTORY + +=back + +=head2 perlce - Perl for WinCE + +=over 4 + +=item DESCRIPTION + +=item BUILD + +=over 4 + +=item Tools & SDK + +Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's +celib-sources, Rainer Keuchel's console-sources + +=item Make + +go to ./wince subdirectory, edit file compile.bat, run compile.bat, run + compile.bat dist + +=back + +=item ACKNOWLEDGEMENTS + +=item AUTHORS + +=back + +=head2 perlcygwin, README.cygwin - Perl for Cygwin + +=over 4 + +=item SYNOPSIS + +=item PREREQUISITES FOR COMPILING PERL ON CYGWIN + +=over 4 + +=item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it) + +=item Cygwin Configuration + +C, I, Permissions + +=back + +=item CONFIGURE PERL ON CYGWIN + +=over 4 + +=item Stripping Perl Binaries on Cygwin + +=item Optional Libraries for Perl on Cygwin + +C<-lcrypt>, C<-lgdbm> (C), C<-ldb> (C), +C<-lcygipc> (C), C<-lutil> + +=item Configure-time Options for Perl on Cygwin + +C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>, +C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>, +C<-Dmksymlinks> + +=item Suspicious Warnings on Cygwin + +I, Win9x and C, Compiler/Preprocessor defines + +=back + +=item MAKE ON CYGWIN + +=over 4 + +=item Errors on Cygwin + +=item ld2 on Cygwin + +=back + +=item TEST ON CYGWIN + +=over 4 + +=item File Permissions on Cygwin + +=item NDBM_File and ODBM_File do not work on FAT filesystems + +=item C failures in io_* tests + +=item Script Portability on Cygwin + +Pathnames, Text/Binary, PerlIO, F<.exe>, C, Miscellaneous + +=back + +=item INSTALL PERL ON CYGWIN + +=item MANIFEST ON CYGWIN + +Documentation, Build, Configure, Make, Install, Tests, Compiled Perl +Source, Compiled Module Source, Perl Modules/Scripts + +=item BUGS ON CYGWIN + +=item AUTHORS + +=item HISTORY + +=back + +=head2 perldgux - Perl under DG/UX. + +=over 4 + +=item SYNOPSIS + +=back + +=over 4 + +=item DESCRIPTION + +=item BUILDING PERL ON DG/UX + +=over 4 + +=item Non-threaded Perl on DG/UX + +=item Threaded Perl on DG/UX + +=item Testing Perl on DG/UX + +=item Installing the built perl on DG/UX + +=back + +=item AUTHOR + +=item SEE ALSO + +=back + +=head2 perldos - Perl under DOS, W31, W95. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Prerequisites for Compiling Perl on DOS + +DJGPP, Pthreads + +=item Shortcomings of Perl under DOS + +=item Building Perl on DOS + +=item Testing Perl on DOS + +=item Installation of Perl on DOS + +=back + +=item BUILDING AND INSTALLING MODULES ON DOS + +=over 4 + +=item Building Prerequisites for Perl on DOS + +=item Unpacking CPAN Modules on DOS + +=item Building Non-XS Modules on DOS + +=item Building XS Modules on DOS + +=back + +=item AUTHOR + +=item SEE ALSO + +=back + +=head2 perlepoc, README.epoc - Perl for EPOC + +=over 4 + +=item SYNOPSIS + +=item INTRODUCTION + +=item INSTALLING PERL ON EPOC + +=item STARTING PERL ON EPOC + +=over 4 + +=item Editors on Epoc + +=item Features of Perl on Epoc + +=item Restrictions of Perl on Epoc + +=item Compiling Perl 5 on the EPOC cross compiling environment + +=back + +=item SUPPORT STATUS OF PERL ON EPOC + +=item AUTHOR + +=item LAST UPDATE + +=back + +=head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item FreeBSD core dumps from readdir_r with ithreads + +=item $^X doesn't always contain a full path in FreeBSD + +=item Perl will no longer be part of "base FreeBSD" + +=back + +=item AUTHOR + +=back + +=head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix +(HP-UX) systems + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Using perl as shipped with HP-UX + +=item Using perl from HP's porting centre + +=item Compiling Perl 5 on HP-UX + +=item PA-RISC + +=item PA-RISC 1.0 + +=item PA-RISC 1.1 + +=item PA-RISC 2.0 + +=item Itanium + +=item Portability Between PA-RISC Versions + +=item Itanium Processor Family and HP-UX + +=item Building Dynamic Extensions on HP-UX + +=item The HP ANSI C Compiler + +=item The GNU C Compiler + +=item Using Large Files with Perl on HP-UX + +=item Threaded Perl on HP-UX + +=item 64-bit Perl on HP-UX + +=item Oracle on HP-UX + +=item GDBM and Threads on HP-UX + +=item NFS filesystems and utime(2) on HP-UX + +=item perl -P and // and HP-UX + +=item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl + +=back + +=item nss_delete core dump from op/pwent or op/grent + +=item AUTHOR + +=item DATE + +=back + +=head2 perlhurd, README.hurd - Perl version 5 on Hurd + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Known Problems with Perl on Hurd + +=back + +=item AUTHOR + +=back + +=head2 perlirix, README.irix - Perl version 5 on Irix systems + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Building 32-bit Perl in Irix + +=item Building 64-bit Perl in Irix + +=item About Compiler Versions of Irix + +=item Linker Problems in Irix + +=item Malloc in Irix + +=item Building with threads in Irix + +=item Irix 5.3 + +=back + +=item AUTHOR + +=back + +=head2 perlmachten, README.machten - Perl version 5 on Power MachTen +systems + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Perl version 5.8.x and greater not supported + +=item Compiling Perl 5.6.x on MachTen + +=item Failures during C on MachTen + +op/lexassign.t, pragma/warnings.t + +=item Building external modules on MachTen + +=back + +=item AUTHOR + +=item DATE + +=back + +=head2 perlmacos, README.macos - Perl under Mac OS (Classic) + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item AUTHOR + +=item DATE + +=back + +=head2 perlmacosx, README.macosx - Perl under Mac OS X + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Installation Prefix + +=item libperl and Prebinding + +=item Updating Panther + +=item Known problems + +=item MacPerl + +=item Carbon + +=item Cocoa + +=back + +=item Starting From Scratch + +=item AUTHOR + +=item DATE + +=back + +=head2 perlmint, README.mint - Perl version 5 on Atari MiNT + +=over 4 + +=item DESCRIPTION + +=item Known problems with Perl on MiNT + +=item AUTHOR + +=back + +=head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE + +=over 4 + +=item SYNOPSIS + +=item NOTE + +=item Binary distribution from HP + +=item What's New in Perl for MPE/iX + +=item Welcome to Perl/iX + +=item System Requirements for Perl/iX + +=item How to Obtain Perl/iX + +=item Perl/iX Distribution Contents Highlights + +README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/, +public_html/feedback.cgi, src/perl-5.6.0-mpe + +=item How to Compile Perl/iX + + 4, 6 + +=item Getting Started with Perl/iX + +=item MPE/iX Implementation Considerations + +=item Known Perl/iX Bugs Under Investigation + +=item Perl/iX To-Do List + +=item Perl/iX Change History + +=item AUTHOR + +=back + +=head2 perlnetware - Perl for NetWare + +=over 4 + +=item DESCRIPTION + +=item BUILD + +=over 4 + +=item Tools & SDK + +=item Setup + +SetNWBld.bat, Buildtype.bat + +=item Make + +=item Interpreter + +=item Extensions + +=back + +=item INSTALL + +=item BUILD NEW EXTENSIONS + +=item ACKNOWLEDGEMENTS + +=item AUTHORS + +=item DATE + +=back + +=head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT. + +=over 4 + +=item SYNOPSIS + +=back + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Target + +=item Other OSes + +=item Prerequisites + +EMX, RSX, HPFS, pdksh + +=item Starting Perl programs under OS/2 (and DOS and...) + +=item Starting OS/2 (and DOS) programs under Perl + +=back + +=item Frequently asked questions + +=over 4 + +=item "It does not work" + +=item I cannot run external programs + +=item I cannot embed perl into my program, or use F from my +program. + +Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use +L? + +=item C<``> and pipe-C do not work under DOS. + +=item Cannot start C + +=back + +=item INSTALLATION + +=over 4 + +=item Automatic binary installation + +C, C, F + +=item Manual binary installation + +Perl VIO and PM executables (dynamically linked), Perl_ VIO executable +(statically linked), Executables for Perl utilities, Main Perl library, +Additional Perl modules, Tools to compile Perl modules, Manpages for Perl +and utilities, Manpages for Perl modules, Source for Perl documentation, +Perl manual in F<.INF> format, Pdksh + +=item B + +=back + +=item Accessing documentation + +=over 4 + +=item OS/2 F<.INF> file + +=item Plain text + +=item Manpages + +=item HTML + +=item GNU C files + +=item F files + +=item C docs + +=back + +=item BUILD + +=over 4 + +=item The short story + +=item Prerequisites + +=item Getting perl source + +=item Application of the patches + +=item Hand-editing + +=item Making + +=item Testing + +A lot of C, Process terminated by SIGTERM/SIGINT, F, +F + +=item Installing the built perl + +=item C-style build + +=back + +=item Building a binary distribution + +=item Building custom F<.EXE> files + +=over 4 + +=item Making executables with a custom collection of statically loaded +extensions + +=item Making executables with a custom search-paths + +=back + +=item Build FAQ + +=over 4 + +=item Some C became C<\> in pdksh. + +=item C<'errno'> - unresolved external + +=item Problems with tr or sed + +=item Some problem (forget which ;-) + +=item Library ... not found + +=item Segfault in make + +=item op/sprintf test failure + +=back + +=item Specific (mis)features of OS/2 port + +=over 4 + +=item C, C + +=item C + +=item C on the first line + +=item Additional modules: + +=item Prebuilt methods: + +C, C, C, + C, C, +C, C, +C, C, +C, C, +C, +C, C, +OS2::SysInfo(), OS2::BootDrive(), C, +C, C, +C, C, +OS2::get_control87(), C, +C + +=item Prebuilt variables: + +$OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork, +$OS2::nsyserror + +=item Misfeatures + +=item Modifications + +C, C, C, C, C, C, C, +C + +=item Identifying DLLs + +=item Centralized management of resources + +C, C, Treating errors reported by OS/2 API, +C, C, C, +C, C, +C, C, Loading DLLs and ordinals in DLLs + +=back + +=item Perl flavors + +=over 4 + +=item F + +=item F + +=item F + +=item F + +=item Why strange names? + +=item Why dynamic linking? + +=item Why chimera build? + +=back + +=item ENVIRONMENT + +=over 4 + +=item C + +=item C + +=item C + +=item C + +=item C + +=item C or C + +=back + +=item Evolution + +=over 4 + +=item Text-mode filehandles + +=item Priorities + +=item DLL name mangling: pre 5.6.2 + +=item DLL name mangling: 5.6.2 and beyond + +Global DLLs, specific DLLs, C and C, F<.> from +C + +=item DLL forwarder generation + +=item Threading + +=item Calls to external programs + +=item Memory allocation + +=item Threads + +C, F + +=back + +=item BUGS + +=back + +=over 4 + +=item AUTHOR + +=item SEE ALSO + +=back + +=head2 perlos390, README.os390 - building and installing Perl for OS/390 +and z/OS + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Tools + +=item Unpacking Perl distribution on OS/390 + +=item Setup and utilities for Perl on OS/390 + +=item Configure Perl on OS/390 + +=item Build, Test, Install Perl on OS/390 + +=item Build Anomalies with Perl on OS/390 + +=item Testing Anomalies with Perl on OS/390 + +=item Installation Anomalies with Perl on OS/390 + +=item Usage Hints for Perl on OS/390 + +=item Floating Point Anomalies with Perl on OS/390 + +=item Modules and Extensions for Perl on OS/390 + +=back + +=item AUTHORS + +=item SEE ALSO + +=over 4 + +=item Mailing list for Perl on OS/390 + +=back + +=item HISTORY + +=back + +=head2 perlos400, README.os400 - Perl version 5 on OS/400 + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Compiling Perl for OS/400 PASE + +=item Installing Perl in OS/400 PASE + +=item Using Perl in OS/400 PASE + +=item Known Problems + +=item Perl on ILE + +=back + +=item AUTHORS + +=back + +=head2 perlplan9 - Plan 9-specific documentation for Perl + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Invoking Perl + +=item What's in Plan 9 Perl + +=item What's not in Plan 9 Perl + +=item Perl5 Functions not currently supported in Plan 9 Perl + +=item Signals in Plan 9 Perl + +=back + +=item COMPILING AND INSTALLING PERL ON PLAN 9 + +=over 4 + +=item Installing Perl Documentation on Plan 9 + +=back + +=item BUGS + +=item Revision date + +=item AUTHOR + +=back + +=head2 perlqnx, README.qnx - Perl version 5 on QNX + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Required Software for Compiling Perl on QNX4 + +/bin/sh, ar, nm, cpp, make + +=item Outstanding Issues with Perl on QNX4 + +=item QNX auxiliary files + +qnx/ar, qnx/cpp + +=item Outstanding issues with perl under QNX6 + +=back + +=item AUTHOR + +=back + +=head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems -=item Re-blessing in DESTROY() supported for chaining DESTROY() methods +=over 4 -=item All C format conversions are handled internally +=item DESCRIPTION -=item New C keyword +=over 4 -=item New C keyword +=item Solaris Version Numbers. -=item New C operator +=back -=item C is now a reserved word +=item RESOURCES -=item Tied arrays are now fully supported +Solaris FAQ, Precompiled Binaries, Solaris Documentation -=item Tied handles support is better +=item SETTING UP -=item 4th argument to substr +=over 4 -=item Negative LENGTH argument to splice +=item File Extraction Problems on Solaris. -=item Magic lvalues are now more magical +=item Compiler and Related Tools on Solaris. -=item <> now reads in records +=item Environment for Compiling perl on Solaris =back -=item Supported Platforms +=item RUN CONFIGURE. =over 4 -=item New Platforms +=item 64-bit perl on Solaris. -=item Changes in existing support +=item Threads in perl on Solaris. + +=item Malloc Issues with perl on Solaris. =back -=item Modules and Pragmata +=item MAKE PROBLEMS. + +Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal: +relocation error:, dlopen: stub interception failed, #error "No +DATAMODEL_NATIVE specified", sh: ar: not found + +=item MAKE TEST =over 4 -=item New Modules +=item op/stat.t test 4 in Solaris -B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed, -ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle, -Thread, attrs, fields, re +=item nss_delete core dump from op/pwent or op/grent -=item Changes in existing modules +=back -Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File, -MakeMaker, CPAN, Cwd +=item PREBUILT BINARIES OF PERL FOR SOLARIS. + +=item RUNTIME ISSUES FOR PERL ON SOLARIS. + +=over 4 + +=item Limits on Numbers of Open Files on Solaris. =back -=item Utility Changes +=item SOLARIS-SPECIFIC MODULES. -=item Documentation Changes +=item SOLARIS-SPECIFIC PROBLEMS WITH MODULES. -=item New Diagnostics +=over 4 -Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index -while coercing array into hash, Bareword "%s" refers to nonexistent -package, Can't call method "%s" on an undefined value, Can't check -filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't -goto subroutine from an eval-string, Can't localize pseudo-hash element, -Can't use %%! because Errno.pm is not available, Cannot find an opnumber -for "%s", Character class syntax [. .] is reserved for future extensions, -Character class syntax [: :] is reserved for future extensions, Character -class syntax [= =] is reserved for future extensions, %s: Eval-group in -insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s: -Eval-group not allowed at run time, Explicit blessing to '' (assuming -package main), Illegal hex digit ignored, No such array field, No such -field "%s" in variable %s of type %s, Out of memory during ridiculously -large request, Range iterator outside integer range, Recursive inheritance -detected while looking for method '%s' %s, Reference found where even-sized -list expected, Undefined value assigned to typeglob, Use of reserved word -"%s" is deprecated, perl: warning: Setting locale failed +=item Proc::ProcessTable on Solaris -=item Obsolete Diagnostics +=item BSD::Resource on Solaris -Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open -temporary file, regexp too big +=item Net::SSLeay on Solaris -=item Configuration Changes +=back -=item BUGS +=item SunOS 4.x -=item SEE ALSO +=item AUTHOR -=item HISTORY +=item LAST MODIFIED =back -=head2 perl5004delta - what's new for perl5.004 +=head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as +Digital UNIX formerly known as DEC OSF/1) systems =over 4 =item DESCRIPTION -=item Supported Environments - -=item Core Changes - =over 4 -=item List assignment to %ENV works +=item Compiling Perl 5 on Tru64 -=item Change to "Can't locate Foo.pm in @INC" error +=item Using Large Files with Perl on Tru64 -=item Compilation option: Binary compatibility with 5.003 +=item Threaded Perl on Tru64 -=item $PERL5OPT environment variable +=item Long Doubles on Tru64 -=item Limitations on B<-M>, B<-m>, and B<-T> options +=item DB_File tests failing on Tru64 -=item More precise warnings +=item 64-bit Perl on Tru64 -=item Deprecated: Inherited C for non-methods +=item Warnings about floating-point overflow when compiling Perl on Tru64 -=item Previously deprecated %OVERLOAD is no longer usable +=back -=item Subroutine arguments created only when they're modified +=item Testing Perl on Tru64 -=item Group vector changeable with C<$)> +=item ext/ODBM_File/odbm Test Failing With Static Builds -=item Fixed parsing of $$, &$, etc. +=item Perl Fails Because Of Unresolved Symbol sockatmark -=item Fixed localization of $, $&, etc. +=item AUTHOR -=item No resetting of $. on implicit close +=back -=item C may return undef +=head2 perluts - Perl under UTS -=item C determines value of EXPR in scalar context +=over 4 -=item Changes to tainting checks +=item SYNOPSIS -No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No -spawning if tainted $TERM doesn't look like a terminal name +=item DESCRIPTION -=item New Opcode module and revised Safe module +=item BUILDING PERL ON UTS -=item Embedding improvements +=item Installing the built perl on UTS -=item Internal change: FileHandle class based on IO::* classes +=item AUTHOR -=item Internal change: PerlIO abstraction interface +=back -=item New and changed syntax +=head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA. -$coderef->(PARAMS) +=over 4 -=item New and changed builtin constants +=item SYNOPSIS -__PACKAGE__ +=item DESCRIPTION -=item New and changed builtin variables +=over 4 -$^E, $^H, $^M +=item Unpacking Perl Distribution on VM/ESA -=item New and changed builtin functions +=item Setup Perl and utilities on VM/ESA -delete on slices, flock, printf and sprintf, keys as an lvalue, my() in -Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module -VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C does not -reset search position on failure, C ignores whitespace before ?*+{}, -nested C closures work now, formats work right on changing lexicals +=item Configure Perl on VM/ESA -=item New builtin methods +=item Testing Anomalies of Perl on VM/ESA -isa(CLASS), can(METHOD), VERSION( [NEED] ) +=item Usage Hints for Perl on VM/ESA -=item TIEHANDLE now supported +=back -TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this -LIST, READLINE this, GETC this, DESTROY this +=item AUTHORS -=item Malloc enhancements +=item SEE ALSO --DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE +=over 4 -=item Miscellaneous efficiency enhancements +=item Mailing list for Perl on VM/ESA =back -=item Support for More Operating Systems +=back + +=head2 perlvms - VMS-specific documentation for Perl =over 4 -=item Win32 +=item DESCRIPTION -=item Plan 9 +=item Installation -=item QNX +=item Organization of Perl Images -=item AmigaOS +=over 4 -=back +=item Core Images -=item Pragmata +=item Perl Extensions -use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use -constant NAME => VALUE, use locale, use ops, use vmsish +=item Installing static extensions -=item Modules +=item Installing dynamic extensions + +=back + +=item File specifications =over 4 -=item Required Updates +=item Syntax -=item Installation directories +=item Wildcard expansion -=item Module information summary +=item Pipes -=item Fcntl +=back -=item IO +=item PERL5LIB and PERLLIB -=item Math::Complex +=item Command line -=item Math::Trig +=over 4 -=item DB_File +=item I/O redirection and backgrounding -=item Net::Ping +=item Command line switches -=item Object-oriented overrides for builtin operators +-i, -S, -u =back -=item Utility Changes +=item Perl functions + +File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump, +exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select +(system call), stat EXPR, system LIST, time, times, unlink LIST, utime +LIST, waitpid PID,FLAGS + +=item Perl variables + +%ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $| + +=item Standard modules with VMS-specific differences =over 4 -=item pod2html +=item SDBM_File -Sends converted HTML to standard output +=back -=item xsubpp +=item Revision date -C XSUBs now default to returning nothing +=item AUTHOR =back -=item C Language API Changes +=head2 perlvos, README.vos - Perl for Stratus VOS -C and C, C, Extended API for -manipulating hashes +=over 4 -=item Documentation Changes +=item SYNOPSIS -L, L, L, L, L, -L, L, L +=item BUILDING PERL FOR VOS -=item New Diagnostics +=item INSTALLING PERL IN VOS -"my" variable %s masks earlier declaration in same scope, %s argument is -not a HASH element or slice, Allocation too large: %lx, Allocation too -large, Applying %s to %s will act on scalar(%s), Attempt to free -nonexistent shared string, Attempt to use reference as lvalue in substr, -Bareword "%s" refers to nonexistent package, Can't redefine active sort -subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in -use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant -subroutine %s redefined, Constant subroutine %s undefined, Copy method did -not return a reference, Died, Exiting pseudo-block via %s, Identifier too -long, Illegal character %s (carriage return), Illegal switch in PERL5OPT: -%s, Integer overflow in hex number, Integer overflow in octal number, -internal error: glob failed, Invalid conversion in %s: "%s", Invalid type -in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once: -possible typo, Null picture in formline, Offset outside string, Out of -memory!, Out of memory during request for %s, panic: frexp, Possible -attempt to put comments in qw() list, Possible attempt to separate words -with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found -while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>" -option, untie attempted while %d inner references still exist, Unrecognized -character %s, Unsupported function fork, Use of "$$" to mean -"${$}" is deprecated, Value of %s can be "0"; test with defined(), -Variable "%s" may be unavailable, Variable "%s" will not stay shared, -Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter, -Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too -long, Process terminated by SIG%s +=item USING PERL IN VOS -=item BUGS +=over 4 -=item SEE ALSO +=item Restrictions of Perl on VOS -=item HISTORY +=item Handling of underflow and overflow =back -=head2 perlartistic - the Perl Artistic License +=item TEST STATUS + +=item SUPPORT STATUS + +=item AUTHOR + +=item LAST UPDATE + +=back + +=head2 perlwin32 - Perl under Windows =over 4 @@ -7732,38 +9259,44 @@ long, Process terminated by SIG%s =item DESCRIPTION -=item The "Artistic License" - =over 4 -=item Preamble - -=item Definitions +=item Setting Up Perl on Win32 -"Package", "Standard Version", "Copyright Holder", "You", "Reasonable -copying fee", "Freely Available" +Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform +SDK 64-bit Compiler, MinGW32 with gcc, MinGW release 1 -=item Conditions +=item Building -a), b), c), d), a), b), c), d) +=item Testing Perl on Win32 -=back +=item Installation of Perl on Win32 -=back +=item Usage Hints for Perl on Win32 -=head2 perlgpl - the GNU General Public License, version 2 +Environment Variables, File Globbing, Using perl from the command line, +Building Extensions, Command-line Wildcard Expansion, Win32 Specific +Extensions, Notes on 64-bit Windows -=over 4 +=item Running Perl Scripts -=item SYNOPSIS +Miscellaneous Things =back -=over 4 +=item BUGS AND CAVEATS -=item DESCRIPTION +=item ACKNOWLEDGEMENTS -=item GNU GENERAL PUBLIC LICENSE +=item AUTHORS + +Gary Ng E71564.1743@CompuServe.COME, Gurusamy Sarathy +Egsar@activestate.comE, Nick Ing-Simmons +Enick@ing-simmons.netE + +=item SEE ALSO + +=item HISTORY =back @@ -9114,8 +10647,8 @@ B<#>I, B<#>II, B<~>, B<#addr>, B<#arg>, B<#class>, B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>, B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>, B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>, -B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>, -B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum> +B<#seq>, B<#opt>, B<#static>, B<#sibaddr>, B<#svaddr>, B<#svclass>, +B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum> =item ABBREVIATIONS @@ -10298,8 +11831,8 @@ C, C C, C, C, C, C, C, C, C, C, C, -C, C, C, C, C, C, -C, C, C, C +C, C, C, C, C, C, +C, C, C =item q @@ -10365,7 +11898,7 @@ C, C, C =item x -C, C +C =item y @@ -10405,6 +11938,8 @@ abs_path, realpath, fast_abs_path =item NOTES +=item AUTHOR + =item SEE ALSO =back @@ -12703,6 +14238,8 @@ fixpath os_flavor +blibdirs_target (override) + =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in ExtUtils::MakeMaker @@ -13045,6 +14582,18 @@ B =back +=head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=back + =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader =over 4