From: Rafael Garcia-Suarez Date: Tue, 17 Feb 2004 21:03:09 +0000 (+0000) Subject: Regenerate table of contents and other related files. X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=d61fd5839368ba2d6df15b21f4d0d037a0604f9f;p=p5sagit%2Fp5-mst-13.2.git Regenerate table of contents and other related files. p4raw-id: //depot/perl@22319 --- diff --git a/MANIFEST b/MANIFEST index 4fe2c94..ebb37d8 100644 --- a/MANIFEST +++ b/MANIFEST @@ -812,9 +812,9 @@ h2pl/tcbreak2 cbreak test routine using .pl handy.h Handy definitions hints/3b1cc Hints for named architecture hints/3b1.sh Hints for named architecture -hints/aix.sh Hints for named architecture hints/aix_3.sh Hints for named architecture hints/aix_4.sh Hints for named architecture +hints/aix.sh Hints for named architecture hints/altos486.sh Hints for named architecture hints/amigaos.sh Hints for named architecture hints/apollo.sh Hints for named architecture @@ -2815,9 +2815,9 @@ t/op/lop.t See if logical operators work t/op/magic.t See if magic variables work t/op/method.t See if method calls work t/op/mkdir.t See if mkdir works +t/op/mydef.t See if "my $_" works t/op/my_stash.t See if my Package works t/op/my.t See if lexical scoping works -t/op/mydef.t See if "my $_" works t/op/numconvert.t See if accessing fields does not change numeric values t/op/oct.t See if oct and hex work t/op/ord.t See if ord works diff --git a/pod/perl.pod b/pod/perl.pod index c2f85f2..0ae41e6 100644 --- a/pod/perl.pod +++ b/pod/perl.pod @@ -132,7 +132,6 @@ For ease of access, the Perl manual has been split up into several sections. perlhist Perl history records perldelta Perl changes since previous version - perl591delta Perl changes in version 5.9.1 perl590delta Perl changes in version 5.9.0 perl583delta Perl changes in version 5.8.3 perl582delta Perl changes in version 5.8.2 diff --git a/pod/perltoc.pod b/pod/perltoc.pod index f572d35..c2ac02d 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -4731,15 +4731,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, @@ -5517,15 +5517,25 @@ B<-V> =over 4 +=item Lexical C<$_> + =item Tied hashes in scalar context +=item Formats + +=item The C<:unique> attribute is only meaningful for globals + +=item Stacked filetest operators + =back =item Modules and Pragmata +Carp, Exporter, FindBin, List::Util, threads::shared + =item Utility Changes -=item New Documentation +=item Documentation =item Performance Enhancements @@ -5533,10 +5543,22 @@ B<-V> =item Selected Bug Fixes +=over 4 + +=item UTF8 bugs + +=item Threading bugs + +=item More bugs + +=back + =item New or Changed Diagnostics =item Changed Internals +=item Configuration and Building + =item New Tests =item Known Problems @@ -7409,1716 +7431,300 @@ improvements, Incompatible changes =item Experimental support for 64-bit platforms -=item prototype() returns useful results on builtins - -=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 Compiling Perl 5 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 +=item prototype() returns useful results on builtins -=head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems +=item Extended support for exception handling -=over 4 +=item Re-blessing in DESTROY() supported for chaining DESTROY() methods -=item DESCRIPTION +=item All C format conversions are handled internally -=over 4 +=item New C keyword -=item Solaris Version Numbers. +=item New C keyword -=back +=item New C operator -=item RESOURCES +=item C is now a reserved word -Solaris FAQ, Precompiled Binaries, Solaris Documentation +=item Tied arrays are now fully supported -=item SETTING UP +=item Tied handles support is better -=over 4 +=item 4th argument to substr -=item File Extraction Problems on Solaris. +=item Negative LENGTH argument to splice -=item Compiler and Related Tools on Solaris. +=item Magic lvalues are now more magical -=item Environment for Compiling perl on Solaris +=item <> now reads in records =back -=item RUN CONFIGURE. +=item Supported Platforms =over 4 -=item 64-bit perl on Solaris. - -=item Threads in perl on Solaris. +=item New Platforms -=item Malloc Issues with perl on Solaris. +=item Changes in existing support =back -=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 +=item Modules and Pragmata =over 4 -=item op/stat.t test 4 in Solaris - -=item nss_delete core dump from op/pwent or op/grent - -=back - -=item PREBUILT BINARIES OF PERL FOR SOLARIS. +=item New Modules -=item RUNTIME ISSUES FOR PERL ON SOLARIS. +B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed, +ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle, +Thread, attrs, fields, re -=over 4 +=item Changes in existing modules -=item Limits on Numbers of Open Files on Solaris. +Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File, +MakeMaker, CPAN, Cwd =back -=item SOLARIS-SPECIFIC MODULES. +=item Utility Changes -=item SOLARIS-SPECIFIC PROBLEMS WITH MODULES. +=item Documentation Changes -=over 4 +=item New Diagnostics -=item Proc::ProcessTable on Solaris +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 BSD::Resource on Solaris +=item Obsolete Diagnostics -=item Net::SSLeay on Solaris +Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open +temporary file, regexp too big -=back +=item Configuration Changes -=item SunOS 4.x +=item BUGS -=item AUTHOR +=item SEE ALSO -=item LAST MODIFIED +=item HISTORY =back -=head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as -Digital UNIX formerly known as DEC OSF/1) systems +=head2 perl5004delta - what's new for perl5.004 =over 4 =item DESCRIPTION -=over 4 +=item Supported Environments -=item Compiling Perl 5 on Tru64 +=item Core Changes -=item Using Large Files with Perl on Tru64 +=over 4 -=item Threaded Perl on Tru64 +=item List assignment to %ENV works -=item Long Doubles on Tru64 +=item Change to "Can't locate Foo.pm in @INC" error -=item DB_File tests failing on Tru64 +=item Compilation option: Binary compatibility with 5.003 -=item 64-bit Perl on Tru64 +=item $PERL5OPT environment variable -=item Warnings about floating-point overflow when compiling Perl on Tru64 +=item Limitations on B<-M>, B<-m>, and B<-T> options -=back +=item More precise warnings -=item Testing Perl on Tru64 +=item Deprecated: Inherited C for non-methods -=item ext/ODBM_File/odbm Test Failing With Static Builds +=item Previously deprecated %OVERLOAD is no longer usable -=item Perl Fails Because Of Unresolved Symbol sockatmark +=item Subroutine arguments created only when they're modified -=item AUTHOR +=item Group vector changeable with C<$)> -=back +=item Fixed parsing of $$, &$, etc. -=head2 perluts - Perl under UTS +=item Fixed localization of $, $&, etc. -=over 4 +=item No resetting of $. on implicit close -=item SYNOPSIS +=item C may return undef -=item DESCRIPTION +=item C determines value of EXPR in scalar context -=item BUILDING PERL ON UTS +=item Changes to tainting checks -=item Installing the built perl on UTS +No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No +spawning if tainted $TERM doesn't look like a terminal name -=item AUTHOR +=item New Opcode module and revised Safe module -=back +=item Embedding improvements -=head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA. +=item Internal change: FileHandle class based on IO::* classes -=over 4 +=item Internal change: PerlIO abstraction interface -=item SYNOPSIS +=item New and changed syntax -=item DESCRIPTION +$coderef->(PARAMS) -=over 4 +=item New and changed builtin constants -=item Unpacking Perl Distribution on VM/ESA +__PACKAGE__ -=item Setup Perl and utilities on VM/ESA +=item New and changed builtin variables -=item Configure Perl on VM/ESA +$^E, $^H, $^M -=item Testing Anomalies of Perl on VM/ESA +=item New and changed builtin functions -=item Usage Hints for Perl 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 -=back +=item New builtin methods -=item AUTHORS +isa(CLASS), can(METHOD), VERSION( [NEED] ) -=item SEE ALSO +=item TIEHANDLE now supported -=over 4 +TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this +LIST, READLINE this, GETC this, DESTROY this -=item Mailing list for Perl on VM/ESA +=item Malloc enhancements -=back +-DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE + +=item Miscellaneous efficiency enhancements =back -=head2 perlvms - VMS-specific documentation for Perl +=item Support for More Operating Systems =over 4 -=item DESCRIPTION - -=item Installation - -=item Organization of Perl Images +=item Win32 -=over 4 +=item Plan 9 -=item Core Images +=item QNX -=item Perl Extensions +=item AmigaOS -=item Installing static extensions +=back -=item Installing dynamic extensions +=item Pragmata -=back +use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use +constant NAME => VALUE, use locale, use ops, use vmsish -=item File specifications +=item Modules =over 4 -=item Syntax +=item Required Updates -=item Wildcard expansion +=item Installation directories -=item Pipes +=item Module information summary -=back +=item Fcntl -=item PERL5LIB and PERLLIB +=item IO -=item Command line +=item Math::Complex -=over 4 +=item Math::Trig -=item I/O redirection and backgrounding +=item DB_File -=item Command line switches +=item Net::Ping --i, -S, -u +=item Object-oriented overrides for builtin operators =back -=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 +=item Utility Changes =over 4 -=item SDBM_File +=item pod2html -=back +Sends converted HTML to standard output -=item Revision date +=item xsubpp -=item AUTHOR +C XSUBs now default to returning nothing =back -=head2 perlvos, README.vos - Perl for Stratus VOS - -=over 4 - -=item SYNOPSIS - -=item BUILDING PERL FOR VOS - -=item INSTALLING PERL IN VOS - -=item USING PERL IN VOS +=item C Language API Changes -=over 4 +C and C, C, Extended API for +manipulating hashes -=item Restrictions of Perl on VOS +=item Documentation Changes -=item Handling of underflow and overflow +L, L, L, L, L, +L, L, L -=back +=item New Diagnostics -=item TEST STATUS +"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 SUPPORT STATUS +=item BUGS -=item AUTHOR +=item SEE ALSO -=item LAST UPDATE +=item HISTORY =back -=head2 perlwin32 - Perl under Windows +=head2 perlartistic - the Perl Artistic License =over 4 @@ -9126,44 +7732,38 @@ LIST, waitpid PID,FLAGS =item DESCRIPTION -=over 4 - -=item Setting Up Perl on Win32 - -Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform -SDK 64-bit Compiler, MinGW32 with gcc, MinGW release 1 +=item The "Artistic License" -=item Building +=over 4 -=item Testing Perl on Win32 +=item Preamble -=item Installation of Perl on Win32 +=item Definitions -=item Usage Hints for Perl on Win32 +"Package", "Standard Version", "Copyright Holder", "You", "Reasonable +copying fee", "Freely Available" -Environment Variables, File Globbing, Using perl from the command line, -Building Extensions, Command-line Wildcard Expansion, Win32 Specific -Extensions, Notes on 64-bit Windows +=item Conditions -=item Running Perl Scripts +a), b), c), d), a), b), c), d) -Miscellaneous Things +=back =back -=item BUGS AND CAVEATS +=head2 perlgpl - the GNU General Public License, version 2 -=item ACKNOWLEDGEMENTS +=over 4 -=item AUTHORS +=item SYNOPSIS -Gary Ng E71564.1743@CompuServe.COME, Gurusamy Sarathy -Egsar@activestate.comE, Nick Ing-Simmons -Enick@ing-simmons.netE +=back -=item SEE ALSO +=over 4 -=item HISTORY +=item DESCRIPTION + +=item GNU GENERAL PUBLIC LICENSE =back @@ -10024,22 +8624,24 @@ utf8::is_utf8(STRING), $flag = utf8::valid(STRING) =item What IS a version -Numeric Versions, V-String Versions +Numeric Versions, Quoted Versions + +=item What about v-strings? =item Numeric Versions -=item V-String Versions +=item Quoted Versions =item Object Methods -New Operator, Stringification, Numification, Comparison operators, Logical -Operators +New Operator, qv(), Stringification, Numification, Comparison operators, +Logical Operators =item Quoting =item Types of Versions Objects -Ordinary versions, alpha versions +Ordinary versions, Alpha versions =item Replacement UNIVERSAL::VERSION @@ -11393,7 +9995,7 @@ module =back -=head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside +=head2 Carp::Heavy - heavy machinery, no user serviceable parts inside =head2 Class::ISA -- report the search path for a class's ISA tree @@ -14443,18 +13045,6 @@ 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