From 639f8edf9a3829bff812fc07d5e6b5755190263d Mon Sep 17 00:00:00 2001 From: Hugo van der Sanden Date: Mon, 27 Oct 2003 02:50:04 +0000 Subject: [PATCH] regen pods and toc p4raw-id: //depot/perl@21543 --- pod/perlmodlib.pod | 12 +- pod/perltoc.pod | 3109 +++++++++++++++++++++++++++++++++++++++++++++++++--- 2 files changed, 2960 insertions(+), 161 deletions(-) diff --git a/pod/perlmodlib.pod b/pod/perlmodlib.pod index 7358b7c..0ed73da 100644 --- a/pod/perlmodlib.pod +++ b/pod/perlmodlib.pod @@ -571,7 +571,7 @@ OS adjusted ExtUtils::MakeMaker subclass =item ExtUtils::MM_Any -Platform agnostic MM methods +Platform-agnostic MM methods =item ExtUtils::MM_BeOS @@ -1055,7 +1055,7 @@ Encoding layer =item PerlIO::scalar -Support module for in-memory IO. +In-memory IO, scalar IO =item PerlIO::via @@ -1681,6 +1681,8 @@ You should try to choose one close to you. =item Austria + http://cpan.inode.at/ + ftp://cpan.inode.at ftp://ftp.tuwien.ac.at/pub/CPAN/ =item Belgium @@ -1837,7 +1839,7 @@ You should try to choose one close to you. =item Poland - ftp.mega.net.pl/CPAN + ftp://ftp.mega.net.pl/CPAN ftp://ftp.man.torun.pl/pub/doc/CPAN/ ftp://sunsite.icm.edu.pl/pub/CPAN/ @@ -1891,7 +1893,7 @@ You should try to choose one close to you. http://cpan.imasd.elmundo.es/ ftp://ftp.rediris.es/mirror/CPAN/ - ftp://ftp.ri.telefonica-data.net/ + ftp://ftp.ri.telefonica-data.net/CPAN ftp://ftp.etse.urv.es/pub/perl/ =item Sweden @@ -2057,6 +2059,8 @@ You should try to choose one close to you. =item Michigan ftp://cpan.cse.msu.edu/ + http://cpan.calvin.edu/pub/CPAN + ftp://cpan.calvin.edu/pub/CPAN =item Nevada diff --git a/pod/perltoc.pod b/pod/perltoc.pod index 00ca67b..3f4239e 100644 --- a/pod/perltoc.pod +++ b/pod/perltoc.pod @@ -1021,8 +1021,8 @@ my C program; what am I doing wrong? =back -=head2 perlfaq4 - Data Manipulation ($Revision: 1.49 $, $Date: 2003/09/20 -06:37:43 $) +=head2 perlfaq4 - Data Manipulation ($Revision: 1.52 $, $Date: 2003/10/02 +04:44:33 $) =over 4 @@ -1697,6 +1697,10 @@ CGI script to do bad things? =item Simple Statements +=item Truth and Falsehood + +=item Statement Modifiers + =item Compound Statements =item Loop Control @@ -1751,12 +1755,12 @@ CGI script to do bad things? =over 4 -=item SYNOPSIS - =item DESCRIPTION =over 4 +=item Operator Precedence and Associativity + =item Terms and List Operators (Leftward) =item The Arrow Operator @@ -4705,12 +4709,12 @@ get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv, 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, 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, +SvIsCOW_shared_hash, SvIV, SvIVx, SvIVX, 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, 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, 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, @@ -4775,8 +4779,8 @@ CvWEAKOUTSIDE CX_CURPAD_SAVE, CX_CURPAD_SV, PAD_BASE_SV, PAD_CLONE_VARS, PAD_COMPNAME_FLAGS, PAD_COMPNAME_GEN, PAD_COMPNAME_OURSTASH, PAD_COMPNAME_PV, PAD_COMPNAME_TYPE, PAD_DUP, PAD_RESTORE_LOCAL, -PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV, PAD_SET_CUR, PAD_SV, -PAD_SVl, SAVECLEARSV, SAVECOMPPAD, SAVEPADSV +PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV, PAD_SET_CUR, +PAD_SET_CUR_NOSAVE, PAD_SV, PAD_SVl, SAVECLEARSV, SAVECOMPPAD, SAVEPADSV =item Functions in file pp_ctl.c @@ -5000,10 +5004,10 @@ t/cmd t/run t/io t/op, t/lib ext lib =item Special Make Test Targets -coretest, test.deparse, minitest, test.valgrind check.valgrind -utest.valgrind ucheck.valgrind, test.third check.third utest.third -ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8, -test_harness +coretest, test.deparse, test.taintwarn, minitest, test.valgrind +check.valgrind utest.valgrind ucheck.valgrind, test.third check.third +utest.third ucheck.third, test.torture torturetest, utest ucheck test.utf8 +check.utf8, test_harness =item Running tests by hand @@ -5490,6 +5494,16 @@ B<-V> =over 4 +=item Hash Randomisation + +=item UTF-8 On Filehandles No Longer Activated By Locale + +=item Single-number v-strings are no longer v-strings before "=>" + +=item (Win32) The -C Switch Has Been Repurposed + +=item (Win32) The /d Switch Of cmd.exe + =item The C<$*> variable has been removed =back @@ -5498,12 +5512,41 @@ B<-V> =over 4 +=item Assertions + +=item Defined-or operators + +=item UTF-8 no longer default under UTF-8 locales + +=item Unsafe signals again available + =item Tied Arrays with Negative Array Indices +=item local ${$x} + +=item Unicode Character Database 4.0.0 + +=item Miscellaneous Enhancements + =back =item Modules and Pragmata +=over 4 + +=item Updated Modules And Pragmata + +base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes, +CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5, +Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping, +PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc, +Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More, +Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared, +Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath, +Win32::GetOSVersion + +=back + =item Utility Changes =item New Documentation @@ -5512,18 +5555,90 @@ B<-V> =item Installation and Configuration Improvements +=over 4 + +=item Platform-specific enhancements + +=back + =item Selected Bug Fixes +=over 4 + +=item Closures, eval and lexicals + +=item Generic fixes + +=item Platform-specific fixes + +=back + =item New or Changed Diagnostics +=over 4 + +=item Changed "A thread exited while %d threads were running" + +=item Removed "Attempt to clear a restricted hash" + +=item New "Illegal declaration of anonymous subroutine" + +=item Changed "Invalid range "%s" in transliteration operator" + +=item New "Missing control char name in \c" + +=item New "Newline in left-justified string for %s" + +=item New "Possible precedence problem on bitwise %c operator" + +=item New "read() on %s filehandle %s" + +=item New "Tied variable freed while still in use" + +=item New "To%s: illegal mapping '%s'" + +=item New "Use of freed value in iteration" + +=back + =item Changed Internals =item New Tests =item Known Problems +=over 4 + +=item Tied hashes in scalar context + +=item Net::Ping 450_service and 510_ping_udp failures + +=item B::C + +=back + =item Platform Specific Problems +=over 4 + +=item EBCDIC Platforms + +=item Cygwin 1.5 problems + +=item HP-UX: HP cc warnings about sendfile and sendpath + +=item IRIX: t/uni/tr_7jis.t falsely failing + +=item Mac OS X: no usemymalloc + +=item Tru64: No threaded builds with GNU cc (gcc) + +=item Win32: sysopen, sysread, syswrite + +=back + +=item TODO + =item Reporting Bugs =item SEE ALSO @@ -7477,163 +7592,141 @@ a), b), c), d), a), b), c), d) =back -=head1 PRAGMA DOCUMENTATION - -=head2 attrs - set/get attributes of a subroutine (deprecated) +=head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems =over 4 -=item SYNOPSIS - =item DESCRIPTION -method, locked - -=back - -=head2 re - Perl pragma to alter regular expression behaviour - =over 4 -=item SYNOPSIS - -=item DESCRIPTION +=item Compiling Perl 5 on AIX -=back +=item OS level -=head2 threadshared::shared, threads::shared - Perl extension for sharing -data structures between threads +=item Building Dynamic Extensions on AIX -=over 4 +=item The IBM ANSI C Compiler -=item SYNOPSIS +=item The usenm option -=item DESCRIPTION +=item Using GNU's gcc for building perl -=item EXPORT +=item Using Large Files with Perl -=item FUNCTIONS +=item Threaded Perl -share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE, -cond_broadcast VARIABLE +=item 64-bit Perl -=item NOTES +=item AIX 4.2 and extensions using C++ with statics -=item BUGS +=back =item AUTHOR -=item SEE ALSO +=item DATE =back -=head2 threads - Perl extension allowing use of interpreter based threads -from perl +=head2 perlamiga - Perl under Amiga OS =over 4 -=item SYNOPSIS +=item NOTE -=item DESCRIPTION +=item SYNOPSIS -$thread = threads->create(function, LIST), $thread->join, $thread->detach, -threads->self, $thread->tid, threads->object( tid ), threads->yield();, -threads->list();, async BLOCK; +=back -=item WARNINGS +=over 4 -A thread exited while %d other threads were still running +=item DESCRIPTION -=item TODO +=over 4 -=item BUGS +=item Prerequisites for Compiling Perl on AmigaOS -Parent-Child threads, Returning objects, Creating threads inside BEGIN -blocks, PERL_OLD_SIGNALS are not threadsafe, will not be +B, B -=item AUTHOR and COPYRIGHT +=item Starting Perl programs under AmigaOS -=item SEE ALSO +=item Shortcomings of Perl under AmigaOS =back -=head2 assertions - select assertions in blocks of code +=item INSTALLATION -=over 4 +=item Accessing documentation -=item SYNOPSIS +=over 4 -=item DESCRIPTION +=item Manpages for Perl on AmigaOS -=item SEE ALSO +=item Perl HTML Documentation on AmigaOS -=item AUTHOR +=item Perl GNU Info Files on AmigaOS -=item COPYRIGHT AND LICENSE +=item Perl LaTeX Documentation on AmigaOS =back -=head2 assertions::activate - activate assertions +=item BUILDING PERL ON AMIGAOS =over 4 -=item SYNOPSIS +=item Build Prerequisites for Perl on AmigaOS -=item DESCRIPTION +=item Getting the Perl Source for AmigaOS -=item SEE ALSO +=item Making Perl on AmigaOS -=item AUTHOR +=item Testing Perl on AmigaOS -=item COPYRIGHT AND LICENSE +=item Installing the built Perl on AmigaOS =back -=head2 attributes - get/set subroutine or variable attributes - -=over 4 - -=item SYNOPSIS +=item PERL 5.8.0 BROKEN IN AMIGAOS -=item DESCRIPTION +=item AUTHORS -=over 4 +=item SEE ALSO -=item Built-in Attributes +=back -locked, method, lvalue +=head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS -=item Available Subroutines +=over 4 -get, reftype +=item DESCRIPTION -=item Package-specific Attribute Handling +=item AUTHOR -FETCH_I_ATTRIBUTES, MODIFY_I_ATTRIBUTES +=back -=item Syntax of Attribute Lists +=head2 perlbeos, README.beos - Perl version 5 on BeOS -=back +=over 4 -=item EXPORTS +=item DESCRIPTION =over 4 -=item Default exports +=item General Issues with Perl on BeOS -=item Available exports +=item BeOS Release-specific Notes -=item Export tags defined +R4 x86, R4 PPC -=back +=item Contact Information -=item EXAMPLES +=item Update 2002-05-30 -=item SEE ALSO +=back =back -=head2 autouse - postpone load of modules until a function is used +=head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000. =over 4 @@ -7641,85 +7734,1510 @@ FETCH_I_ATTRIBUTES, MODIFY_I_ATTRIBUTES =item DESCRIPTION -=item WARNING +=over 4 -=item AUTHOR +=item gzip on BS2000 -=item SEE ALSO +=item bison on BS2000 -=back +=item Unpacking Perl Distribution on BS2000 -=head2 base - Establish IS-A relationship with base class at compile time +=item Compiling Perl on BS2000 -=over 4 +=item Testing Perl on BS2000 -=item SYNOPSIS +=item Installing Perl on BS2000 -=item DESCRIPTION +=item Using Perl in the Posix-Shell of BS2000 -=item HISTORY +=item Using Perl in "native" BS2000 -=item CAVEATS +=item Floating point anomalies on BS2000 -=item SEE ALSO +=item Using PerlIO and different encodings on ASCII and EBCDIC partitions =back -=head2 bigint - Transparent BigInteger support for Perl +=item AUTHORS + +=item SEE ALSO =over 4 -=item SYNOPSIS +=item Mailing list -=item DESCRIPTION +=back -=over 4 +=item HISTORY -=item OPTIONS +=back -a or accuracy, p or precision, t or trace, l or lib, v or version +=over 4 -=item MATH LIBRARY +=item Name -=item INTERNAL FORMAT +=item Description -=item SIGN +=item Build -=item METHODS +=over 4 -=item CAVEAT +=item Tools & SDK -=back +Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's +celib-sources, Rainer Keuchel's console-sources -=item MODULES USED +=item Make -=item EXAMPLES +go to ./wince subdirectory, edit file compile.bat, run compile.bat, run + compile.bat dist -=item LICENSE +=back -=item SEE ALSO +=item Acknowledgements =item AUTHORS =back -=head2 bignum - Transparent BigNumber support for Perl +=head2 perlcygwin, README.cygwin - Perl for Cygwin =over 4 =item SYNOPSIS -=item DESCRIPTION +=item PREREQUISITES FOR COMPILING PERL ON CYGWIN =over 4 -=item OPTIONS +=item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it) -a or accuracy, p or precision, t or trace, l or lib, v or version +=item Cygwin Configuration -=item METHODS +C, I, Permissions -=item CAVEAT +=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 + +=item Name + +=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 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 + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Solaris Version Numbers. + +=back + +=item RESOURCES + +Solaris FAQ, Precompiled Binaries, Solaris Documentation + +=item SETTING UP + +=over 4 + +=item File Extraction Problems on Solaris. + +=item Compiler and Related Tools on Solaris. + +=item Environment for Compiling perl on Solaris + +=back + +=item RUN CONFIGURE. + +=over 4 + +=item 64-bit perl on Solaris. + +=item Threads in perl on Solaris. + +=item Malloc Issues with perl on Solaris. + +=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 + +=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 RUNTIME ISSUES FOR PERL ON SOLARIS. + +=over 4 + +=item Limits on Numbers of Open Files on Solaris. + +=back + +=item SOLARIS-SPECIFIC MODULES. + +=item SOLARIS-SPECIFIC PROBLEMS WITH MODULES. + +=over 4 + +=item Proc::ProcessTable on Solaris + +=item BSD::Resource on Solaris + +=item Net::SSLeay on Solaris + +=back + +=item SunOS 4.x + +=item AUTHOR + +=item LAST MODIFIED + +=back + +=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 + +=over 4 + +=item Compiling Perl 5 on Tru64 + +=item Using Large Files with Perl on Tru64 + +=item Threaded Perl on Tru64 + +=item Long Doubles on Tru64 + +=item DB_File tests failing on Tru64 + +=item 64-bit Perl on Tru64 + +=item Warnings about floating-point overflow when compiling Perl on Tru64 + +=back + +=item Testing Perl on Tru64 + +=item ext/ODBM_File/odbm Test Failing With Static Builds + +=item Perl Fails Because Of Unresolved Symbol sockatmark + +=item AUTHOR + +=back + +=head2 perluts - Perl under UTS + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item BUILDING PERL ON UTS + +=item Installing the built perl on UTS + +=item AUTHOR + +=back + +=head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA. + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Unpacking Perl Distribution on VM/ESA + +=item Setup Perl and utilities on VM/ESA + +=item Configure Perl on VM/ESA + +=item Testing Anomalies of Perl on VM/ESA + +=item Usage Hints for Perl on VM/ESA + +=back + +=item AUTHORS + +=item SEE ALSO + +=over 4 + +=item Mailing list for Perl on VM/ESA + +=back + +=back + +=head2 perlvms - VMS-specific documentation for Perl + +=over 4 + +=item DESCRIPTION + +=item Installation + +=item Organization of Perl Images + +=over 4 + +=item Core Images + +=item Perl Extensions + +=item Installing static extensions + +=item Installing dynamic extensions + +=back + +=item File specifications + +=over 4 + +=item Syntax + +=item Wildcard expansion + +=item Pipes + +=back + +=item PERL5LIB and PERLLIB + +=item Command line + +=over 4 + +=item I/O redirection and backgrounding + +=item Command line switches + +-i, -S, -u + +=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 + +=over 4 + +=item SDBM_File + +=back + +=item Revision date + +=item AUTHOR + +=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 + +=over 4 + +=item Restrictions of Perl on VOS + +=item Handling of underflow and overflow + +=back + +=item TEST STATUS + +=item SUPPORT STATUS + +=item AUTHOR + +=item LAST UPDATE + +=back + +=head2 perlwin32 - Perl under Windows + +=over 4 + +=item SYNOPSIS + +=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 Building + +=item Testing Perl on Win32 + +=item Installation of Perl on Win32 + +=item Usage Hints for Perl on Win32 + +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 Running Perl Scripts + +Miscellaneous Things + +=back + +=item BUGS AND CAVEATS + +=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 + +=head1 PRAGMA DOCUMENTATION + +=head2 attrs - set/get attributes of a subroutine (deprecated) + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +method, locked + +=back + +=head2 re - Perl pragma to alter regular expression behaviour + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=back + +=head2 threadshared::shared, threads::shared - Perl extension for sharing +data structures between threads + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item EXPORT + +=item FUNCTIONS + +share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE, +cond_broadcast VARIABLE + +=item NOTES + +=item BUGS + +=item AUTHOR + +=item SEE ALSO + +=back + +=head2 threads - Perl extension allowing use of interpreter based threads +from perl + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +$thread = threads->create(function, LIST), $thread->join, $thread->detach, +threads->self, $thread->tid, threads->object( tid ), threads->yield();, +threads->list();, async BLOCK; + +=item WARNINGS + +A thread exited while %d other threads were still running + +=item TODO + +=item BUGS + +Parent-Child threads, Returning objects, Creating threads inside BEGIN +blocks, PERL_OLD_SIGNALS are not threadsafe, will not be + +=item AUTHOR and COPYRIGHT + +=item SEE ALSO + +=back + +=head2 assertions - select assertions in blocks of code + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT AND LICENSE + +=back + +=head2 assertions::activate - activate assertions + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT AND LICENSE + +=back + +=head2 attributes - get/set subroutine or variable attributes + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Built-in Attributes + +locked, method, lvalue + +=item Available Subroutines + +get, reftype + +=item Package-specific Attribute Handling + +FETCH_I_ATTRIBUTES, MODIFY_I_ATTRIBUTES + +=item Syntax of Attribute Lists + +=back + +=item EXPORTS + +=over 4 + +=item Default exports + +=item Available exports + +=item Export tags defined + +=back + +=item EXAMPLES + +=item SEE ALSO + +=back + +=head2 autouse - postpone load of modules until a function is used + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item WARNING + +=item AUTHOR + +=item SEE ALSO + +=back + +=head2 base - Establish IS-A relationship with base class at compile time + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item HISTORY + +=item CAVEATS + +=item SEE ALSO + +=back + +=head2 bigint - Transparent BigInteger support for Perl + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item OPTIONS + +a or accuracy, p or precision, t or trace, l or lib, v or version + +=item MATH LIBRARY + +=item INTERNAL FORMAT + +=item SIGN + +=item METHODS + +=item CAVEAT + +=back + +=item MODULES USED + +=item EXAMPLES + +=item LICENSE + +=item SEE ALSO + +=item AUTHORS + +=back + +=head2 bignum - Transparent BigNumber support for Perl + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item OPTIONS + +a or accuracy, p or precision, t or trace, l or lib, v or version + +=item METHODS + +=item CAVEAT inf(), NaN(), upgrade() @@ -7902,6 +9420,65 @@ diagnostics =back +=head2 encoding - allows you to write your script in non-ascii or non-utf8 + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=over 4 + +=item Literal Conversions + +=item PerlIO layers for C + +=back + +=item FEATURES THAT REQUIRE 5.8.1 + +"NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle + +=item USAGE + +use encoding [I] ;, use encoding I [ STDIN =E +I ...] ;, use encoding I Filter=E1;, no encoding; + +=item The Filter Option + +=over 4 + +=item Filter-related changes at Encode version 1.87 + +=back + +=item CAVEATS + +=over 4 + +=item NOT SCOPED + +=item DO NOT MIX MULTIPLE ENCODINGS + +=item tr/// with ranges + +Legend of characters above + +=back + +=item EXAMPLE - Greekperl + +=item KNOWN PROBLEMS + +literals in regex that are longer than 127 bytes, EBCDIC, format + +=item HISTORY + +=item SEE ALSO + +=back + =head2 fields - compile-time class fields =over 4 @@ -7967,6 +9544,34 @@ point =back +=head2 lib - manipulate @INC at compile time + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Adding directories to @INC + +=item Deleting directories from @INC + +=item Restoring original @INC + +=back + +=item CAVEATS + +=item NOTES + +=item SEE ALSO + +=item AUTHOR + +=back + =head2 locale - Perl pragma to use and avoid POSIX locales for built-in operations @@ -7994,6 +9599,18 @@ operations =back +=head2 ops - Perl pragma to restrict unsafe operations when compiling + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item SEE ALSO + +=back + =head2 overload - Package for overloading perl operations =over 4 @@ -8159,6 +9776,32 @@ C, C, C =back +=head2 threadshared, threads::shared - Perl extension for sharing data +structures between threads + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item EXPORT + +=item FUNCTIONS + +share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE, +cond_broadcast VARIABLE + +=item NOTES + +=item BUGS + +=item AUTHOR + +=item SEE ALSO + +=back + =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source code @@ -8872,6 +10515,26 @@ C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]> =back +=head2 Bblock, B::Bblock - Walk basic blocks + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Functions + +B + +=back + +=item AUTHOR + +=back + =head2 Benchmark - benchmark running times of Perl code =over 4 @@ -8932,6 +10595,28 @@ disablecache ( ), enablecache ( ), timesum ( T1, T2 ) =back +=head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item EXAMPLE + +=item OPTIONS + +B<-b>, B<-H>, B<-k>, B<-o>I, B<-s> + +=item KNOWN BUGS + +=item NOTICE + +=item AUTHORS + +=back + =head2 CGI - Simple Common Gateway Interface Class =over 4 @@ -9549,42 +11234,373 @@ the function Class::ISA::super_path($CLASS), the function Class::ISA::self_and_super_path($CLASS), the function Class::ISA::self_and_super_versions($CLASS) -=item CAUTIONARY NOTES +=item CAUTIONARY NOTES + +=item COPYRIGHT + +=item AUTHOR + +=back + +=head2 Class::Struct - declare struct-like datatypes as Perl classes + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item The C function + +=item Class Creation at Compile Time + +=item Element Types and Accessor Methods + +Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or +C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>) + +=item Initializing with C + +=back + +=item EXAMPLES + +Example 1, Example 2, Example 3 + +=item Author and Modification History + +=back + +=head2 Config - access Perl configuration information + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +myconfig(), config_sh(), config_re($regex), config_vars(@names) + +=item EXAMPLE + +=item WARNING -=item COPYRIGHT +=item GLOSSARY + +=over 4 + +=item _ + +C<_a>, C<_exe>, C<_o> + +=item a + +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, C, +C, C + +=item b + +C, C, C, C, C, C, C + +=item 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, +C, C, C, C, C, +C, C, C + +=item d + +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, 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, +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, 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, 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, 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, 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, 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, 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, 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, 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, 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, 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, C, C, +C, C, C, C, C, +C, C, C, C + +=item e + +C, C, C, C, C, C, +C, C, C, +C, C, C, C, +C, C, C + +=item f + +C, C, C, C, C, +C, C, C, C, C, C, +C + +=item g + +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, C, C, C, C + +=item h + +C, C, C, C, C, C, +C, C + +=item i + +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, 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, 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, +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, C, C, C, C + +=item k + +C, C + +=item l + +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, C, +C + +=item m + +C, C, C, C, C, C, +C, C, C, C, C, +C, C + +=item M + +C, C, C, C, C, C, +C, C, C, C, C, C, +C + +=item n + +C, C, C, C, +C, C, C, C, C, +C, C, C, C, +C, C, C, C, C, +C, C + +=item o + +C, C, C, C, +C, C, C, C + +=item p + +C, C, C, C, C, C, +C, C + +=item P + +C, C, C, C, +C, C, C, C, C, C, +C, C, C, C, C, C, +C, C, C, C + +=item q + +C, C + +=item r + +C, C, C, C, C, +C, C, C, C, C, +C, C, C -=item AUTHOR +=item s -=back +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, 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, 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 -=head2 Class::Struct - declare struct-like datatypes as Perl classes +=item t -=over 4 +C, C, C, C, C, C, C, +C, C, C, C, C, C, C, +C -=item SYNOPSIS +=item u -=item DESCRIPTION +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, C, C, C, C, +C, C, C, C, C, +C, C, C, C, C, +C -=over 4 +=item v -=item The C function +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 Class Creation at Compile Time +=item x -=item Element Types and Accessor Methods +C, C -Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or -C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>) +=item y -=item Initializing with C +C, C -=back +=item z -=item EXAMPLES +C, C -Example 1, Example 2, Example 3 +=back -=item Author and Modification History +=item NOTE =back @@ -10027,6 +12043,55 @@ compactDump, veryCompact, set, get =back +=head2 DynaLoader - Dynamically load C libraries into Perl code + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +@dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs, +@dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(), +dl_load_file(), dl_unload_file(), dl_load_flags(), dl_find_symbol(), +dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(), +bootstrap() + +=item AUTHOR + +=back + +=head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into +Perl code + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Migration from C + +=item Backward compatible boilerplate + +=back + +=item Order of initialization: early load() + +=over 4 + +=item The most hairy case + +=back + +=item LIMITATIONS + +=item AUTHOR + +=back + =head2 Encode - character encodings =over 4 @@ -10098,6 +12163,27 @@ is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING) =back +=head2 Encode::Alias - alias definitions to encodings + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +As a simple string, As a qr// compiled regular expression, e.g.:, As a code +reference, e.g.: + +=over 4 + +=item Alias overloading + +=back + +=item SEE ALSO + +=back + =head2 Encode::Byte - Single Byte Encodings =over 4 @@ -10112,6 +12198,8 @@ is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING) =back +=head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_* + =head2 Encode::CN - China-based Chinese Encodings =over 4 @@ -10128,6 +12216,10 @@ is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING) =back +=head2 Encode::CN::HZ -- internally used by Encode::CN + +=head2 Encode::Config -- internally used by Encode + =head2 Encode::EBCDIC - EBCDIC Encodings =over 4 @@ -10142,6 +12234,65 @@ is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING) =back +=head2 Encode::Encoding - Encode Implementation Base Class + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Methods you should implement + +-Eencode($string [,$check]), -Edecode($octets [,$check]), +-Ecat_decode($destination, $octets, $offset, $terminator [,$check]) + +=item Other methods defined in Encode::Encodings + +-Ename, -Erenew, -Eperlio_ok(), -Eneeds_lines() + +=item Example: Encode::ROT13 + +=back + +=item Why the heck Encode API is different? + +=over 4 + +=item Compiled Encodings + +=back + +=item SEE ALSO + +Scheme 1, Scheme 2, Other Schemes + +=back + +=head2 Encode::Guess -- Guesses encoding from data + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item DESCRIPTION + +Encode::Guess->set_suspects, Encode::Guess->add_suspects, +Encode::decode("Guess" ...), Encode::Guess->guess($data), +guess_encoding($data, [, I]) + +=item CAVEATS + +=item TO DO + +=item SEE ALSO + +=back + =head2 Encode::JP - Japanese Encodings =over 4 @@ -10160,17 +12311,143 @@ is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING) =back +=head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP* + +=head2 Encode::JP::JIS7 -- internally used by Encode::JP + =head2 Encode::KR - Korean Encodings =over 4 -=item SYNOPSIS +=item SYNOPSIS + +=item DESCRIPTION + +=item BUGS + +=item SEE ALSO + +=back + +=head2 Encode::KR::2022_KR -- internally used by Encode::KR + +=head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item DESCRIPTION + +=item BUGS + +=item SEE ALSO + +=back + +=head2 Encode::PerlIO -- a detailed document on Encode and PerlIO + +=over 4 + +=item Overview + +=item How does it work? + +=item Line Buffering + +=over 4 + +=item How can I tell whether my encoding fully supports PerlIO ? + +=back + +=item SEE ALSO + +=back + +=head2 Encode::Supported -- Encodings supported by Encode + +=over 4 + +=item DESCRIPTION + +=over 4 + +=item Encoding Names + +=back + +=item Supported Encodings + +=over 4 + +=item Built-in Encodings + +=item Encode::Unicode -- other Unicode encodings + +=item Encode::Byte -- Extended ASCII + +ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for +the Cyrillic world, gsm0338 - Hentai Latin 1 + +=item CJK: Chinese, Japanese, Korean (Multibyte) + +Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea, +Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN, +Encode::JIS2K -- JIS X 0213 encodings via CPAN + +=item Miscellaneous encodings + +Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess + +=back + +=item Unsupported encodings + + ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings, +Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran +System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS, +Various Mac encodings, (Mac) Indic encodings + +=item Encoding vs. Charset -- terminology + +=item Encoding Classification (by Anton Tagunov and Dan Kogai) + +=over 4 + +=item Microsoft-related naming mess + +KS_C_5601-1987, GB2312, Big5, Shift_JIS + +=back + +=item Glossary + +character repertoire, coded character set (CCS), character encoding scheme +(CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF, +UTF-16 + +=item See Also + +=item References + +ECMA, ECMA-035 (eq C), IANA, Assigned Charset Names by IANA, ISO, +RFC, UC, Unicode Glossary + +=over 4 + +=item Other Notable Sites -=item DESCRIPTION +czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org: +"Introduction to i18n" -=item BUGS +=item Offline sources -=item SEE ALSO +C by Ken Lunde + +=back =back @@ -10232,6 +12509,20 @@ BOM as integer when fetched in network byte order =back +=head2 Encode::Unicode::UTF7 -- UTF-7 encoding + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item In Practice + +=item SEE ALSO + +=back + =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to encodings @@ -10559,6 +12850,34 @@ literals in regex that are longer than 127 bytes, EBCDIC, format =back +=head2 Encoder, Encode::Encoder -- Object Oriented Encoder + +=over 4 + +=item SYNOPSIS + +=item ABSTRACT + +=item Description + +=over 4 + +=item Predefined Methods + +$e = Encode::Encoder-Enew([$data, $encoding]);, encoder(), +$e-Edata([$data]), $e-Eencoding([$encoding]), +$e-Ebytes([$encoding]) + +=item Example: base64 transcoder + +=item Operator Overloading + +=back + +=item SEE ALSO + +=back + =head2 English - use nice English (or awk) names for ugly punctuation variables @@ -10587,6 +12906,22 @@ arrays =back +=head2 Errno - System errno constants + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CAVEATS + +=item AUTHOR + +=item COPYRIGHT + +=back + =head2 Exporter - Implements default import method for modules =over 4 @@ -10941,8 +13276,12 @@ all_target metafile_target +signature_target + metafile_addtomanifest_target +signature_addtomanifest_target + =over 4 =item Abstract methods @@ -11644,8 +13983,8 @@ OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT, -PRINT_PREREQ, SITEPREFIX, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, -VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION +PRINT_PREREQ, SITEPREFIX, SIGN, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, +VERSION, VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION =item Additional lowercase attributes @@ -11830,6 +14169,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 @@ -12989,15 +15340,233 @@ Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd} : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu, {zun} : Zuni -=item SEE ALSO +=item SEE ALSO + +=item COPYRIGHT AND DISCLAIMER + +=item AUTHOR + +=back + +=head2 I18N::Langinfo - query locale information + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item EXPORT + +=back + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT AND LICENSE + +=back + +=head2 IO - load various IO modules + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item DEPRECATED + +=back + +=head2 IO::Dir - supply object methods for directory handles + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (), +rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ] + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 IO::File - supply object methods for filehandles + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile + +=item METHODS + +open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ) + +=item SEE ALSO + +=item HISTORY + +=back + +=head2 IO::Handle - supply object methods for I/O handles + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new (), new_from_fd ( FD, MODE ) + +=item METHODS + +$io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines, +$io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error, +$io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ), +$io->blocking ( [ BOOL ] ), $io->untaint + +=item NOTE + +=item SEE ALSO + +=item BUGS + +=item HISTORY + +=back + +=head2 IO::Pipe - supply object methods for pipes + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new ( [READER, WRITER] ) + +=item METHODS + +reader ([ARGS]), writer ([ARGS]), handles () + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 IO::Poll - Object interface to system poll call + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove ( +IO ), handles( [ EVENT_MASK ] ) + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 IO::Seekable - supply seek based methods for I/O objects + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +$io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET), +WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ), +$io->tell + +=item SEE ALSO + +=item HISTORY + +=back + +=head2 IO::Select - OO interface to the select system call + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new ( [ HANDLES ] ) -=item COPYRIGHT AND DISCLAIMER +=item METHODS + +add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read ( +[ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ), +count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] ) + +=item EXAMPLE =item AUTHOR +=item COPYRIGHT + =back -=head2 I18N::Langinfo - query locale information +=head2 IO::Socket - Object interface to socket communications + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONSTRUCTOR + +new ( [ARGS] ) + +=item METHODS + +accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected, +protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL]) + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + +=head2 IO::Socket::INET - Object interface for AF_INET domain sockets =over 4 @@ -13005,9 +15574,16 @@ Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd} =item DESCRIPTION +=item CONSTRUCTOR + +new ( [ARGS] ) + =over 4 -=item EXPORT +=item METHODS + +sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost +() =back @@ -13015,11 +15591,11 @@ Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd} =item AUTHOR -=item COPYRIGHT AND LICENSE +=item COPYRIGHT =back -=head2 IO - load various IO modules +=head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets =over 4 @@ -13027,7 +15603,19 @@ Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd} =item DESCRIPTION -=item DEPRECATED +=item CONSTRUCTOR + +new ( [ARGS] ) + +=item METHODS + +hostpath(), peerpath() + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT =back @@ -13275,6 +15863,28 @@ hostpath(), peerpath() =back +=head2 IPC::Msg - SysV Msg IPC object class + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set +( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [, +FLAGS ] ), stat + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + =head2 IPC::Open2, open2 - open a process for both reading and writing =over 4 @@ -13302,6 +15912,29 @@ handling =back +=head2 IPC::Semaphore - SysV Semaphore IPC object class + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item METHODS + +new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ), +getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ), +set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N +, VALUE ), stat + +=item SEE ALSO + +=item AUTHOR + +=item COPYRIGHT + +=back + =head2 IPC::SysV - SysV IPC constants =over 4 @@ -13366,6 +15999,25 @@ set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N =back +=head2 List::Util - A selection of general-utility list subroutines + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce +BLOCK LIST, shuffle LIST, sum LIST + +=item KNOWN BUGS + +=item SUGGESTED ADDITIONS + +=item COPYRIGHT + +=back + =head2 List::Utilib::List::Util, List::Util - A selection of general-utility list subroutines @@ -13688,6 +16340,8 @@ Premature end of base64 data, Premature padding of base64 data =item COPYRIGHT +=item SEE ALSO + =back =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding @@ -13703,6 +16357,25 @@ encode_qp($str), encode_qp($str, $eol), decode_qp($str); =item COPYRIGHT +=item SEE ALSO + +=back + +=head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable +strings + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +encode_qp($str), encode_qp($str, $eol), decode_qp($str); + +=item COPYRIGHT + +=item SEE ALSO + =back =head2 Math::BigFloat - Arbitrary size floating point math package @@ -14828,6 +17501,24 @@ login (), password (), account (), lpa () =back +=head2 O - Generic interface to Perl Compiler backends + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=item CONVENTIONS + +=item IMPLEMENTATION + +=item BUGS + +=item AUTHOR + +=back + =head2 ODBM_File - Tied access to odbm files =over 4 @@ -16490,6 +19181,59 @@ C, C, C =back +=head2 Safe - Compile and execute code in restricted compartments + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +a new namespace, an operator mask + +=item WARNING + +=over 4 + +=item RECENT CHANGES + +=item Methods in class Safe + +permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP, +...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from +(PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME), +root (NAMESPACE), mask (MASK) + +=item Some Safety Issues + +Memory, CPU, Snooping, Signals, State Changes + +=item AUTHOR + +=back + +=back + +=head2 Scalar::Util - A selection of general-utility scalar subroutines + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR, +looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR, +set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF + +=item KNOWN BUGS + +=item COPYRIGHT + +=item BLATANT PLUG + +=back + =head2 Search::Dict, look - search for key in dictionary file =over 4 @@ -16699,6 +19443,27 @@ C =back +=head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl +interface to the UNIX syslog(3) calls + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +openlog $ident, $logopt, $facility, syslog $priority, $format, @args, +setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added +in 5.004_02), closelog + +=item EXAMPLES + +=item SEE ALSO + +=item AUTHOR + +=back + =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl interface to the UNIX syslog(3) calls @@ -18232,6 +20997,36 @@ Win32::UnregisterServer(LIBRARYNAME) =back +=head2 XSLoader - Dynamically load C libraries into Perl code + +=over 4 + +=item SYNOPSIS + +=item DESCRIPTION + +=over 4 + +=item Migration from C + +=item Backward compatible boilerplate + +=back + +=item Order of initialization: early load() + +=over 4 + +=item The most hairy case + +=back + +=item LIMITATIONS + +=item AUTHOR + +=back + =head1 AUXILIARY DOCUMENTATION Here should be listed all the extra programs' documentation, but they -- 2.7.4