Test::Harness 2.21 -> 2.22
[p5sagit/p5-mst-13.2.git] / pod / perlmodlib.pod
index 64bd9b4..3a68707 100644 (file)
@@ -53,10 +53,6 @@ The following pragmas are defined (and have their own documentation).
 
 Get/set subroutine or variable attributes
 
-=item attrs
-
-Set/get attributes of a subroutine (deprecated)
-
 =item autouse
 
 Postpone load of modules until a function is used
@@ -65,6 +61,18 @@ Postpone load of modules until a function is used
 
 Establish IS-A relationship with base class at compile time
 
+=item bigint
+
+Transparent big integer support for Perl
+
+=item bignum
+
+Transparent BigNumber support for Perl
+
+=item bigrat
+
+Transparent BigNumber/BigRational support for Perl
+
 =item blib
 
 Use MakeMaker's uninstalled version of a package
@@ -97,6 +105,10 @@ Compile-time class fields
 
 Control the filetest permission operators
 
+=item if
+
+C<use> a Perl module if a condition holds
+
 =item integer
 
 Use integer arithmetic instead of floating point
@@ -113,10 +125,6 @@ Use and avoid POSIX locales for built-in operations
 
 Set default disciplines for input and output
 
-=item ops
-
-Restrict unsafe operations when compiling
-
 =item overload
 
 Package for overloading perl operations
@@ -141,10 +149,6 @@ Restrict unsafe constructs
 
 Predeclare sub names
 
-=item threads
-
-Perl extension allowing use of interpreter based threads from perl
-
 =item utf8
 
 Enable/disable UTF-8 (or UTF-EBCDIC) in source code
@@ -191,82 +195,10 @@ Load subroutines only on demand
 
 Split a package for autoloading
 
-=item B
-
-The Perl Compiler
-
-=item B::Asmdata
-
-Autogenerated data about Perl ops, used to generate bytecode
-
-=item B::Assembler
-
-Assemble Perl bytecode
-
-=item B::Bblock
-
-Walk basic blocks
-
-=item B::Bytecode
-
-Perl compiler's bytecode backend
-
-=item B::C
-
-Perl compiler's C backend
-
-=item B::CC
-
-Perl compiler's optimized C translation backend
-
-=item B::Concise
-
-Walk Perl syntax tree, printing concise info about ops
-
-=item B::Debug
-
-Walk Perl syntax tree, printing debug info about ops
-
-=item B::Deparse
-
-Perl compiler backend to produce perl code
-
-=item B::Disassembler
-
-Disassemble Perl bytecode
-
-=item B::Lint
-
-Perl lint
-
-=item B::Showlex
-
-Show lexical variables used in functions or files
-
-=item B::Stackobj
-
-Helper module for CC backend
-
-=item B::Stash
-
-Show what stashes are loaded
-
-=item B::Terse
-
-Walk Perl syntax tree, printing terse info about ops
-
-=item B::Xref
-
-Generates cross reference reports for Perl programs
-
 =item Benchmark
 
 Benchmark running times of Perl code
 
-=item ByteLoader
-
-Load byte compiled perl code
-
 =item CGI
 
 Simple Common Gateway Interface Class
@@ -339,10 +271,6 @@ Get pathname of current working directory
 
 Programmatic interface to the Perl debugging API (draft, subject to
 
-=item DB_File
-
-Perl5 access to Berkeley DB version 1.x
-
 =item Devel::SelfStubber
 
 Generate stubs for a SelfLoading module
@@ -359,18 +287,6 @@ Supply object methods for directory handles
 
 Provides screen dump of Perl data.
 
-=item Encode
-
-Character encodings
-
-=item Encode::EncodeFormat
-
-The format of encoding tables of the Encode extension
-
-=item Encode::Tcl
-
-Tcl encodings
-
 =item English
 
 Use nice English (or awk) names for ugly punctuation variables
@@ -411,6 +327,10 @@ Inventory management of installed modules
 
 Determine libraries to use and how to use them
 
+=item ExtUtils::MM_BeOS
+
+Methods to override UN*X behaviour in ExtUtils::MakeMaker
+
 =item ExtUtils::MM_Cygwin
 
 Methods to override UN*X behaviour in ExtUtils::MakeMaker
@@ -463,10 +383,6 @@ Add blib/* directories to @INC
 
 Replace functions with equivalents which succeed or die
 
-=item Fcntl
-
-Load the C Fcntl.h defines
-
 =item File::Basename
 
 Split a pathname into pieces
@@ -489,7 +405,7 @@ DOS like globbing and then some
 
 =item File::Find
 
-Traverse a file tree
+Traverse a directory tree.
 
 =item File::Path
 
@@ -499,6 +415,10 @@ Create or remove directory trees
 
 Portably perform operations on file names
 
+=item File::Spec::Cygwin
+
+Methods for Cygwin file specs
+
 =item File::Spec::Epoc
 
 Methods for Epoc file specs
@@ -559,6 +479,10 @@ Extended processing of command line options
 
 Process single-character switches with switch clustering
 
+=item Hash::Util
+
+A selection of general-utility hash subroutines
+
 =item I18N::Collate
 
 Compare 8-bit scalar data according to the current locale
@@ -571,10 +495,6 @@ Functions for dealing with RFC3066-style language tags
 
 Tags and names for human languages
 
-=item IO
-
-Load various IO modules
-
 =item IPC::Open2
 
 Open a process for both reading and writing
@@ -607,6 +527,10 @@ Framework for localization
 
 Article about software localization
 
+=item Locale::Script
+
+ISO codes for script identification (ISO 15924)
+
 =item Math::BigFloat
 
 Arbitrary size floating point math package
@@ -619,6 +543,10 @@ Arbitrary size integer math package
 
 Pure Perl module to support Math::BigInt
 
+=item Math::BigRat
+
+Arbitrarily big rationals
+
 =item Math::Complex
 
 Complex numbers and associated mathematical functions
@@ -655,18 +583,10 @@ Glue to provide EXISTS for NDBM_File for Storable use
 
 Glue to provide EXISTS for SDBM_File for Storable use
 
-=item Memoize::Saves
-
-Plug-in module to specify which return values should be memoized
-
 =item Memoize::Storable
 
 Store Memoized data in Storable database
 
-=item NDBM_File
-
-Tied access to ndbm files
-
 =item NEXT
 
 Provide a pseudo-class NEXT that allows method redispatch
@@ -697,7 +617,7 @@ OO interface to users netrc file
 
 =item Net::POP3
 
-Post Office Protocol 3 Client class (RFC1081)
+Post Office Protocol 3 Client class (RFC1939)
 
 =item Net::Ping
 
@@ -731,22 +651,6 @@ By-name interface to Perl's built-in getproto*() functions
 
 By-name interface to Perl's built-in getserv*() functions
 
-=item O
-
-Generic interface to Perl Compiler backends
-
-=item ODBM_File
-
-Tied access to odbm files
-
-=item Opcode
-
-Disable named opcodes when compiling perl code
-
-=item POSIX
-
-Perl interface to IEEE Std 1003.1
-
 =item PerlIO
 
 On demand loader for PerlIO layers and root of PerlIO::* name space
@@ -759,6 +663,10 @@ Check pod documents for syntax errors
 
 Find POD documents in directory trees
 
+=item Pod::Functions
+
+Group Perl's functions a la perlfunc.pod
+
 =item Pod::Html
 
 Module to convert pod files to HTML
@@ -819,14 +727,6 @@ Print a usage message from embedded pod documentation
 
 Test of various basic POD features in translators.
 
-=item SDBM_File
-
-Tied access to sdbm files
-
-=item Safe
-
-Compile and execute code in restricted compartments
-
 =item Search::Dict
 
 Search for key in dictionary file
@@ -843,14 +743,6 @@ Load functions only on demand
 
 Run shell commands transparently within perl
 
-=item Socket
-
-Load the C socket.h defines and structure manipulators 
-
-=item Storable
-
-Persistency for perl data structures
-
 =item Switch
 
 A switch statement for Perl
@@ -887,6 +779,18 @@ Backend for building test libraries
 
 Run perl standard test scripts with statistics
 
+=item Test::Harness::Assert
+
+Simple assert
+
+=item Test::Harness::Iterator
+
+Internal Test::Harness Iterator
+
+=item Test::Harness::Straps
+
+Detailed analysis of test results
+
 =item Test::More
 
 Yet another framework for writing test scripts
@@ -931,6 +835,10 @@ Manipulate threads in Perl
 
 Base class for tied arrays
 
+=item Tie::File
+
+Access the lines of a disk file via a Perl array
+
 =item Tie::Handle
 
 Base class definitions for tied handles
@@ -939,6 +847,10 @@ Base class definitions for tied handles
 
 Base class definitions for tied hashes
 
+=item Tie::Memoize
+
+Add data to hash when needed
+
 =item Tie::RefHash
 
 Use references as hash keys
@@ -1027,8 +939,7 @@ CPAN stands for Comprehensive Perl Archive Network; it's a globally
 replicated trove of Perl materials, including documentation, style
 guides, tricks and traps, alternate ports to non-Unix systems and
 occasional binary distributions for these.   Search engines for
-CPAN can be found at http://cpan.perl.com/ and at
-http://theory.uwinnipeg.ca/mod_perl/cpan-search.pl .
+CPAN can be found at http://www.cpan.org/
 
 Most importantly, CPAN includes around a thousand unbundled modules,
 some of which require a C compiler to build.  Major categories of
@@ -1136,7 +1047,7 @@ South Africa
     ftp://ftp.is.co.za/programming/perl/CPAN/
     ftp://ftp.mweb.co.za/pub/mirrors/cpan/
     ftp://ftp.saix.net/pub/CPAN/
-    ftp://ftp.sun.ac.za/CPAN/
+    ftp://ftp.sun.ac.za/CPAN/CPAN/
 
 =back
 
@@ -1150,8 +1061,6 @@ China
 
     ftp://freesoft.cei.gov.cn/pub/languages/perl/CPAN/
     http://www2.linuxforum.net/mirror/CPAN/
-    http://CPAN.pacific.net.hk/
-    ftp://ftp.pacific.net.hk/pub/mirror/CPAN/
     http://cpan.shellhung.org/
     ftp://ftp.shellhung.org/pub/CPAN
 
@@ -1190,6 +1099,7 @@ Japan
     http://mirror.nucba.ac.jp/mirror/Perl/
     ftp://mirror.nucba.ac.jp/mirror/Perl/
     ftp://ftp.meisei-u.ac.jp/pub/CPAN/
+    ftp://ftp.ayamura.org/pub/CPAN/
     ftp://ftp.jaist.ac.jp/pub/lang/perl/CPAN/
     ftp://ftp.dti.ad.jp/pub/lang/CPAN/
     ftp://ftp.ring.gr.jp/pub/lang/perl/CPAN/
@@ -1235,12 +1145,13 @@ South Korea
     http://ftp.kornet.net/pub/CPAN/
     ftp://ftp.kornet.net/pub/CPAN/
     ftp://ftp.nuri.net/pub/CPAN/
+    http://ftp.xgate.co.kr/cpan/
+    ftp://ftp.xgate.co.kr/pub/mirror/CPAN
 
 =item *
 
 Taiwan
 
-    ftp://coda.nctu.edu.tw/UNIX/perl/CPAN
     ftp://ftp.ee.ncku.edu.tw/pub/perl/CPAN/
     ftp://ftp1.sinica.edu.tw/pub1/perl/CPAN/
     http://ftp.tku.edu.tw/pub/CPAN/
@@ -1250,8 +1161,6 @@ Taiwan
 
 Thailand
 
-    http://download.nectec.or.th/CPAN/
-    ftp://ftp.nectec.or.th/pub/languages/CPAN/
     ftp://ftp.cs.riubon.ac.th/pub/mirrors/CPAN/
 
 =back
@@ -1294,7 +1203,8 @@ Belgium
 
 Bulgaria
 
-    ftp://ftp.ntrl.net/pub/mirrors/CPAN/
+    http://cpan.lirex.net/
+    ftp://ftp.lirex.net/pub/mirrors/CPAN
 
 =item *
 
@@ -1321,21 +1231,6 @@ Denmark
 
 =item *
 
-England
-
-    http://www.mirror.ac.uk/sites/ftp.funet.fi/pub/languages/perl/CPAN
-    ftp://ftp.mirror.ac.uk/sites/ftp.funet.fi/pub/languages/perl/CPAN/
-    http://cpan.crazygreek.co.uk
-    ftp://ftp.demon.co.uk/pub/CPAN/
-    ftp://ftp.flirble.org/pub/languages/perl/CPAN/
-    ftp://ftp.plig.org/pub/CPAN/
-    ftp://sunsite.doc.ic.ac.uk/packages/CPAN/
-    http://mirror.uklinux.net/CPAN/
-    ftp://mirror.uklinux.net/pub/CPAN/
-    ftp://usit.shef.ac.uk/pub/packages/CPAN/
-
-=item *
-
 Estonia
 
     ftp://ftp.ut.ee/pub/languages/perl/CPAN/
@@ -1351,7 +1246,6 @@ Finland
 
 France
 
-    ftp://cpan.ftp.worldonline.fr/pub/CPAN/
     http://cpan.mirrors.easynet.fr/
     ftp://cpan.mirrors.easynet.fr/pub/ftp.cpan.org/
     ftp://ftp.club-internet.fr/pub/perl/CPAN/
@@ -1372,6 +1266,8 @@ Germany
     ftp://ftp.uni-erlangen.de/pub/source/CPAN/
     ftp://ftp-stud.fht-esslingen.de/pub/Mirrors/CPAN
     ftp://ftp.gigabell.net/pub/CPAN/
+    http://pandemonium.tiscali.de/pub/CPAN/
+    ftp://pandemonium.tiscali.de/pub/CPAN/
     http://ftp.gwdg.de/pub/languages/perl/CPAN/
     ftp://ftp.gwdg.de/pub/languages/perl/CPAN/
     ftp://ftp.uni-hamburg.de/pub/soft/lang/perl/CPAN/
@@ -1385,6 +1281,7 @@ Germany
 
 Greece
 
+    ftp://ftp.acn.gr/pub/lang/perl/CPAN
     ftp://ftp.forthnet.gr/pub/languages/perl/CPAN
     ftp://ftp.ntua.gr/pub/lang/perl/
 
@@ -1394,8 +1291,8 @@ Hungary
 
     http://cpan.artifact.hu/
     ftp://cpan.artifact.hu/CPAN/
-    http://ftp.kfki.hu/pub/CPAN/
-    ftp://ftp.kfki.hu/pub/CPAN/
+    http://ftp.kfki.hu/packages/perl/CPAN/
+    ftp://ftp.kfki.hu/pub/packages/perl/CPAN/
 
 =item *
 
@@ -1422,7 +1319,7 @@ Italy
     ftp://gusp.dyndns.org/pub/CPAN
     http://softcity.iol.it/cpan
     ftp://softcity.iol.it/pub/cpan
-    ftp://ftp.unina.it/pub/Other/CPAN/
+    ftp://ftp.unina.it/pub/Other/CPAN/CPAN/
     ftp://ftp.unipi.it/pub/mirror/perl/CPAN/
     ftp://cis.uniRoma2.it/CPAN/
     ftp://ftp.edisontel.it/pub/CPAN_Mirror/
@@ -1447,8 +1344,6 @@ Netherlands
     ftp://download.xs4all.nl/pub/mirror/CPAN/
     ftp://ftp.nl.uu.net/pub/CPAN/
     ftp://ftp.nluug.nl/pub/languages/perl/CPAN/
-    http://cpan.cybercomm.nl/
-    ftp://mirror.cybercomm.nl/pub/cpan/
     ftp://ftp.cpan.nl/pub/CPAN/
     http://www.cs.uu.nl/mirror/CPAN/
     ftp://ftp.cs.uu.nl/mirror/CPAN/
@@ -1465,8 +1360,6 @@ Norway
 Poland
 
     ftp://ftp.pk.edu.pl/pub/lang/perl/CPAN/
-    http://www.fic.uni.lodz.pl/pub/CPAN
-    ftp://ftp.fic.uni.lodz.pl/pub/CPAN
     ftp://ftp.mega.net.pl/pub/mirrors/ftp.perl.com/
     ftp://ftp.man.torun.pl/pub/doc/CPAN/
     ftp://sunsite.icm.edu.pl/pub/CPAN/
@@ -1477,8 +1370,8 @@ Portugal
 
     ftp://ftp.ua.pt/pub/CPAN/
     ftp://perl.di.uminho.pt/pub/CPAN/
-    http://cpan.ip.pt/
-    ftp://cpan.ip.pt/pub/perl/
+    http://cpan.dei.uc.pt/
+    ftp://ftp.dei.uc.pt/pub/CPAN
     ftp://ftp.ist.utl.pt/pub/CPAN/
     http://cpan.ip.pt/
     ftp://cpan.ip.pt/pub/cpan/
@@ -1489,10 +1382,8 @@ Portugal
 
 Romania
 
-    ftp://archive.logicnet.ro/mirrors/ftp.cpan.org/CPAN/
     ftp://ftp.kappa.ro/pub/mirrors/ftp.perl.org/pub/CPAN/
     ftp://ftp.dntis.ro/pub/cpan/
-    ftp://ftp.opsynet.com/cpan/
     ftp://ftp.dnttm.ro/pub/CPAN/
     ftp://ftp.lasting.ro/pub/CPAN
     ftp://ftp.timisoara.roedu.net/mirrors/CPAN/
@@ -1512,7 +1403,8 @@ Russia
 
 Slovakia
 
-    ftp://ftp.entry.sk/pub/languages/perl/CPAN/
+    http://ftp.cvt.stuba.sk/pub/CPAN/
+    ftp://ftp.cvt.stuba.sk/pub/CPAN/
 
 =item *
 
@@ -1524,6 +1416,7 @@ Slovenia
 
 Spain
 
+    http://cpan.imasd.elmundo.es/
     ftp://ftp.rediris.es/mirror/CPAN/
     ftp://ftp.etse.urv.es/pub/perl/
 
@@ -1557,6 +1450,24 @@ Ukraine
     ftp://cpan.org.ua/
     ftp://ftp.perl.org.ua/pub/CPAN/
 
+=item *
+
+United Kingdom
+
+    http://www.mirror.ac.uk/sites/ftp.funet.fi/pub/languages/perl/CPAN
+    ftp://ftp.mirror.ac.uk/sites/ftp.funet.fi/pub/languages/perl/CPAN/
+    http://cpan.teleglobe.net/
+    ftp://cpan.teleglobe.net/pub/CPAN
+    http://cpan.crazygreek.co.uk
+    ftp://ftp.demon.co.uk/pub/CPAN/
+    ftp://ftp.flirble.org/pub/languages/perl/CPAN/
+    ftp://ftp.plig.org/pub/CPAN/
+    http://mirror.uklinux.net/CPAN/
+    ftp://mirror.uklinux.net/pub/CPAN/
+    http://cpan.mirrors.clockerz.net/
+    ftp://ftp.clockerz.net/pub/CPAN/
+    ftp://usit.shef.ac.uk/pub/packages/CPAN/
+
 =back
 
 =head2 North America
@@ -1600,7 +1511,6 @@ Ontario
 Quebec
 
     http://cpan.mirror.smartworker.org/
-    ftp://cpan.mirror.smartworker.org/pub/CPAN
 
 =back
 
@@ -1636,13 +1546,10 @@ California
     ftp://cpan.valueclick.com/pub/CPAN/
     http://mirrors.gossamer-threads.com/CPAN
     ftp://cpan.nas.nasa.gov/pub/perl/CPAN/
-    ftp://ftp.digital.com/pub/plan/perl/CPAN/
     http://mirrors.kernel.org/cpan/
     ftp://mirrors.kernel.org/pub/CPAN
     http://cpan.digisle.net/
     ftp://cpan.digisle.net/pub/CPAN
-    http://www.linuxjar.com/CPAN
-    ftp://linuxjar.com/pub/CPAN
     http://www.perl.com/CPAN/
     http://download.sourceforge.net/mirrors/CPAN/
 
@@ -1654,9 +1561,16 @@ Colorado
 
 =item *
 
+Delaware
+
+    http://ftp.lug.udel.edu/pub/CPAN
+    ftp://ftp.lug.udel.edu/pub/CPAN
+
+=item *
+
 District of Columbia
 
-    ftp://ftp.dc.us.telia.net/pub/cpan/
+    ftp://ftp.dc.aleron.net/pub/CPAN/
 
 =item *
 
@@ -1677,9 +1591,9 @@ Illinois
 
 Indiana
 
-    ftp://ftp.uwsg.indiana.edu/pub/perl/CPAN/
-    http://cpan.nitco.com/
-    ftp://cpan.nitco.com/pub/CPAN/
+    ftp://ftp.uwsg.iu.edu/pub/perl/CPAN/
+    http://cpan.netnitco.net/
+    ftp://cpan.netnitco.net/pub/mirrors/CPAN/
     http://archive.progeny.com/CPAN/
     ftp://archive.progeny.com/CPAN/
     ftp://cpan.in-span.net/
@@ -1700,7 +1614,6 @@ Massachusetts
     ftp://ftp.ccs.neu.edu/net/mirrors/ftp.funet.fi/pub/languages/perl/CPAN/
     http://cpan.mirrors.netnumina.com/
     ftp://mirrors.netnumina.com/cpan/
-    ftp://ftp.iguide.com/pub/mirrors/packages/perl/CPAN/
 
 =item *
 
@@ -1713,12 +1626,17 @@ Michigan
 New Jersey
 
     ftp://ftp.cpanel.net/pub/CPAN/
+    http://cpan.teleglobe.net/
+    ftp://cpan.teleglobe.net/pub/CPAN
 
 =item *
 
 New York
 
-    ftp://ftp.freesoftware.com/pub/perl/CPAN/
+    ftp://ftp.exobit.org/pub/perl/CPAN
+    http://cpan.belfry.net/
+    http://cpan.thepirtgroup.com/
+    ftp://cpan.thepirtgroup.com/
     ftp://ftp.stealth.net/pub/CPAN/
     http://www.rge.com/pub/languages/perl/
     ftp://ftp.rge.com/pub/languages/perl/
@@ -1756,6 +1674,8 @@ Pennsylvania
     ftp://ftp.epix.net/pub/languages/perl/
     http://mirrors.phenominet.com/pub/CPAN/
     ftp://mirrors.phenominet.com/pub/CPAN/
+    http://cpan.pair.com/
+    ftp://cpan.pair.com/pub/CPAN/
     ftp://carroll.cac.psu.edu/pub/CPAN/
 
 =item *
@@ -1769,6 +1689,7 @@ Tennessee
 Texas
 
     http://ftp.sedl.org/pub/mirrors/CPAN/
+    ftp://mirror.telentente.com/pub/CPAN
 
 =item *
 
@@ -1782,6 +1703,10 @@ Virginia
 
     http://mirrors.rcn.net/pub/lang/CPAN/
     ftp://mirrors.rcn.net/pub/lang/CPAN/
+    http://perl.secsup.org/
+    ftp://perl.secsup.org/pub/perl/
+    http://mirrors.phihost.com/CPAN/
+    ftp://mirrors.phihost.com/CPAN/
     ftp://ruff.cs.jmu.edu/pub/CPAN/
     http://perl.Liquidation.com/CPAN/
 
@@ -1795,7 +1720,12 @@ Washington
     ftp://ftp.mirrorcentral.com/pub/CPAN/
     ftp://ftp-mirror.internap.com/pub/CPAN/
 
-=back
+=item *
+
+Wisconsin
+
+    http://mirror.sit.wisc.edu/pub/CPAN/
+    ftp://mirror.sit.wisc.edu/pub/CPAN/
 
 =back
 
@@ -1815,6 +1745,7 @@ Australia
 =item *
 
 New Zealand
+
     ftp://ftp.auckland.ac.nz/pub/perl/CPAN/
 
 =back
@@ -1841,11 +1772,9 @@ Brazil
 Chile
 
     ftp://ftp.psinet.cl/pub/programming/perl/CPAN/
-    ftp://sunsite.dcc.uchile.cl/pub/lang/perl/
 
 =back
 
-
 For an up-to-date listing of CPAN sites,
 see http://www.cpan.org/SITES or ftp://www.cpan.org/SITES .