A new fatal error :
[p5sagit/p5-mst-13.2.git] / pod / perlmodlib.pod
index 62d249a..a23ec1f 100644 (file)
@@ -1,14 +1,15 @@
+=for maintainers
+Generated by perlmodlib.PL -- DO NOT EDIT!
+
 =head1 NAME
 
 perlmodlib - constructing new Perl modules and finding existing ones
 
-=head1 DESCRIPTION
-
 =head1 THE PERL MODULE LIBRARY
 
-Many modules are included the Perl distribution.  These are described
+Many modules are included in the Perl distribution.  These are described
 below, and all end in F<.pm>.  You may discover compiled library
-file (usually ending in F<.so>) or small pieces of modules to be
+files (usually ending in F<.so>) or small pieces of modules to be
 autoloaded (ending in F<.al>); these were automatically generated
 by the installation process.  You may also discover files in the
 library directory that end in either F<.pl> or F<.ph>.  These are
@@ -62,6 +63,18 @@ Postpone load of modules until a function is used
 
 Establish IS-A relationship with base class at compile time
 
+=item bigint
+
+Transparent BigInteger support for Perl
+
+=item bignum
+
+Transparent BigNumber support for Perl
+
+=item bigrat
+
+Transparent BigNumber/BigRationale support for Perl
+
 =item blib
 
 Use MakeMaker's uninstalled version of a package
@@ -72,7 +85,7 @@ Force byte semantics rather than character semantics
 
 =item charnames
 
-Define character names for C<\N{named}> string literal escape.
+Define character names for C<\N{named}> string literal escapes
 
 =item constant
 
@@ -82,6 +95,10 @@ Declare constants
 
 Perl compiler pragma to force verbose warning diagnostics
 
+=item encoding
+
+Allows you to write your script in non-ascii or non-utf8
+
 =item fields
 
 Compile-time class fields
@@ -90,21 +107,29 @@ Compile-time class fields
 
 Control the filetest permission operators
 
+=item if
+
+C<use> a Perl module if a condition holds
+
 =item integer
 
-Compute arithmetic in integer instead of double
+Use integer arithmetic instead of floating point
 
 =item less
 
 Request less of something from the compiler
 
+=item lib
+
+Manipulate @INC at compile time
+
 =item locale
 
 Use and avoid POSIX locales for built-in operations
 
 =item open
 
-Set default disciplines for input and output
+Set default PerlIO layers for input and output
 
 =item ops
 
@@ -114,10 +139,6 @@ Restrict unsafe operations when compiling
 
 Package for overloading perl operations
 
-=item perlio
-
-Configure C level IO
-
 =item re
 
 Alter regular expression behaviour
@@ -126,6 +147,10 @@ Alter regular expression behaviour
 
 Enable simple signal handling
 
+=item sort
+
+Control sort() behaviour
+
 =item strict
 
 Restrict unsafe constructs
@@ -134,14 +159,30 @@ Restrict unsafe constructs
 
 Predeclare sub names
 
+=item threads
+
+Perl extension allowing use of interpreter based threads from perl
+
+=item threads::shared
+
+Perl extension for sharing data structures between threads
+
 =item utf8
 
-Enable/disable UTF-8 in source code
+Enable/disable UTF-8 (or UTF-EBCDIC) in source code
 
 =item vars
 
 Predeclare global variable names (obsolete)
 
+=item version
+
+Perl extension for Version Objects
+
+=item vmsish
+
+Control VMS-specific language features
+
 =item warnings
 
 Control optional warnings
@@ -158,12 +199,20 @@ Standard, bundled modules are all expected to behave in a well-defined
 manner with respect to namespace pollution because they use the
 Exporter module.  See their own documentation for details.
 
+It's possible that not all modules listed below are installed on your
+system. For example, the GDBM_File module will not be installed if you
+don't have the gdbm library.
+
 =over 12
 
 =item AnyDBM_File
 
 Provide framework for multiple DBMs
 
+=item Attribute::Handlers
+
+Simpler definition of attribute handlers
+
 =item AutoLoader
 
 Load subroutines only on demand
@@ -200,6 +249,10 @@ Perl compiler's C backend
 
 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
@@ -276,6 +329,10 @@ Simple Interface to Server Push
 
 Backward compatibility module for defunct CGI::Switch
 
+=item CGI::Util
+
+Internal utilities used by CGI module
+
 =item CPAN
 
 Query, download and build perl modules from CPAN sites
@@ -292,10 +349,22 @@ Wrapper around CPAN.pm without using any XS module
 
 Warn of errors (from perspective of caller)
 
+=item Carp::Heavy
+
+No user serviceable parts inside
+
+=item Class::ISA
+
+Report the search path for a class's ISA tree
+
 =item Class::Struct
 
 Declare struct-like datatypes as Perl classes
 
+=item Config
+
+Access Perl configuration information
+
 =item Cwd
 
 Get pathname of current working directory
@@ -308,10 +377,30 @@ Programmatic interface to the Perl debugging API (draft, subject to
 
 Perl5 access to Berkeley DB version 1.x
 
+=item Data::Dumper
+
+Stringified perl data structures, suitable for both printing and C<eval>
+
+=item Devel::DProf
+
+A Perl code profiler
+
+=item Devel::Peek
+
+A data debugging tool for the XS programmer
+
 =item Devel::SelfStubber
 
 Generate stubs for a SelfLoading module
 
+=item Digest
+
+Modules that calculate message digests
+
+=item Digest::MD5
+
+Perl interface to the MD5 Algorithm
+
 =item DirHandle
 
 Supply object methods for directory handles
@@ -320,10 +409,98 @@ Supply object methods for directory handles
 
 Provides screen dump of Perl data.
 
+=item DynaLoader
+
+Dynamically load C libraries into Perl code
+
 =item Encode
 
 Character encodings
 
+=item Encode::Alias
+
+Alias definitions to encodings
+
+=item Encode::Byte
+
+Single Byte Encodings
+
+=item Encode::CJKConstants
+
+Internally used by Encode::??::ISO_2022_*
+
+=item Encode::CN
+
+China-based Chinese Encodings
+
+=item Encode::CN::HZ
+
+Internally used by Encode::CN
+
+=item Encode::Config
+
+Internally used by Encode
+
+=item Encode::EBCDIC
+
+EBCDIC Encodings
+
+=item Encode::Encoder
+
+Object Oriented Encoder
+
+=item Encode::Encoding
+
+Encode Implementation Base Class
+
+=item Encode::Guess
+
+Guesses encoding from data
+
+=item Encode::JP
+
+Japanese Encodings
+
+=item Encode::JP::H2Z
+
+Internally used by Encode::JP::2022_JP*
+
+=item Encode::JP::JIS7
+
+Internally used by Encode::JP
+
+=item Encode::KR
+
+Korean Encodings
+
+=item Encode::KR::2022_KR
+
+Internally used by Encode::KR
+
+=item Encode::MIME::Header
+
+MIME 'B' and 'Q' header encoding
+
+=item Encode::PerlIO
+
+A detailed document on Encode and PerlIO
+
+=item Encode::Supported
+
+Encodings supported by Encode
+
+=item Encode::Symbol
+
+Symbol Encodings
+
+=item Encode::TW
+
+Taiwan-based Chinese Encodings
+
+=item Encode::Unicode
+
+Various Unicode Transformation Formats
+
 =item English
 
 Use nice English (or awk) names for ugly punctuation variables
@@ -332,6 +509,10 @@ Use nice English (or awk) names for ugly punctuation variables
 
 Perl module that imports environment variables as scalars or arrays
 
+=item Errno
+
+System errno constants
+
 =item Exporter
 
 Implements default import method for modules
@@ -344,6 +525,14 @@ Exporter guts
 
 Utilities to replace common UNIX commands in Makefiles etc.
 
+=item ExtUtils::Command::MM
+
+Commands for the MM's to use in Makefiles
+
+=item ExtUtils::Constant
+
+Generate XS code to import C header constants
+
 =item ExtUtils::Embed
 
 Utilities for embedding Perl in C/C++ applications
@@ -360,14 +549,42 @@ Inventory management of installed modules
 
 Determine libraries to use and how to use them
 
+=item ExtUtils::MM
+
+OS adjusted ExtUtils::MakeMaker subclass
+
+=item ExtUtils::MM_Any
+
+Platform agnostic MM methods
+
+=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
 
+=item ExtUtils::MM_DOS
+
+DOS specific subclass of ExtUtils::MM_Unix
+
+=item ExtUtils::MM_MacOS
+
+Methods to override UN*X behaviour in ExtUtils::MakeMaker
+
+=item ExtUtils::MM_NW5
+
+Methods to override UN*X behaviour in ExtUtils::MakeMaker
+
 =item ExtUtils::MM_OS2
 
 Methods to override UN*X behaviour in ExtUtils::MakeMaker
 
+=item ExtUtils::MM_UWIN
+
+U/WIN specific subclass of ExtUtils::MM_Unix
+
 =item ExtUtils::MM_Unix
 
 Methods used by ExtUtils::MakeMaker
@@ -380,6 +597,14 @@ Methods to override UN*X behaviour in ExtUtils::MakeMaker
 
 Methods to override UN*X behaviour in ExtUtils::MakeMaker
 
+=item ExtUtils::MM_Win95
+
+Method to customize MakeMaker for Win9X
+
+=item ExtUtils::MY
+
+ExtUtils::MakeMaker subclass for customization
+
 =item ExtUtils::MakeMaker
 
 Create an extension Makefile
@@ -434,7 +659,11 @@ DOS like globbing and then some
 
 =item File::Find
 
-Traverse a file tree
+Traverse a directory tree.
+
+=item File::Glob
+
+Perl extension for BSD glob routine
 
 =item File::Path
 
@@ -444,6 +673,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
@@ -454,7 +687,7 @@ Portably perform operations on file names
 
 =item File::Spec::Mac
 
-File::Spec for MacOS
+File::Spec for Mac OS (Classic)
 
 =item File::Spec::OS2
 
@@ -462,7 +695,7 @@ Methods for OS/2 file specs
 
 =item File::Spec::Unix
 
-Methods used by File::Spec
+File::Spec for Unix, base for other File::Spec modules
 
 =item File::Spec::VMS
 
@@ -492,10 +725,18 @@ Supply object methods for filehandles
 
 Simplified source filtering
 
+=item Filter::Util::Call
+
+Perl Source Filter Utility Module
+
 =item FindBin
 
 Locate directory of original perl script
 
+=item GDBM_File
+
+Perl5 access to the gdbm library.
+
 =item Getopt::Long
 
 Extended processing of command line options
@@ -504,14 +745,70 @@ 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
 
+=item I18N::LangTags
+
+Functions for dealing with RFC3066-style language tags
+
+=item I18N::LangTags::List
+
+Tags and names for human languages
+
+=item I18N::Langinfo
+
+Query locale information
+
 =item IO
 
 Load various IO modules
 
+=item IO::Dir
+
+Supply object methods for directory handles
+
+=item IO::File
+
+Supply object methods for filehandles
+
+=item IO::Handle
+
+Supply object methods for I/O handles
+
+=item IO::Pipe
+
+Supply object methods for pipes
+
+=item IO::Poll
+
+Object interface to system poll call
+
+=item IO::Seekable
+
+Supply seek based methods for I/O objects
+
+=item IO::Select
+
+OO interface to the select system call
+
+=item IO::Socket
+
+Object interface to socket communications
+
+=item IO::Socket::INET
+
+Object interface for AF_INET domain sockets
+
+=item IO::Socket::UNIX
+
+Object interface for AF_UNIX domain sockets
+
 =item IPC::Open2
 
 Open a process for both reading and writing
@@ -520,14 +817,78 @@ Open a process for both reading and writing
 
 Open a process for reading, writing, and error handling
 
+=item IPC::SysV
+
+SysV IPC constants
+
+=item IPC::SysV::Msg
+
+SysV Msg IPC object class
+
+=item IPC::SysV::Semaphore
+
+SysV Semaphore IPC object class
+
+=item List::Util
+
+A selection of general-utility list subroutines
+
+=item Locale::Constants
+
+Constants for Locale codes
+
+=item Locale::Country
+
+ISO codes for country identification (ISO 3166)
+
+=item Locale::Currency
+
+ISO three letter codes for currency identification (ISO 4217)
+
+=item Locale::Language
+
+ISO two letter codes for language identification (ISO 639)
+
+=item Locale::Maketext
+
+Framework for localization
+
+=item Locale::Maketext::TPJ13
+
+Article about software localization
+
+=item Locale::Script
+
+ISO codes for script identification (ISO 15924)
+
+=item MIME::Base64
+
+Encoding and decoding of base64 strings
+
+=item MIME::Base64::QuotedPrint
+
+Encoding and decoding of quoted-printable strings
+
 =item Math::BigFloat
 
-Arbitrary length float math package
+Arbitrary size floating point math package
 
 =item Math::BigInt
 
 Arbitrary size integer math package
 
+=item Math::BigInt::Calc
+
+Pure Perl module to support Math::BigInt
+
+=item Math::BigInt::Scalar
+
+Pure Perl module to test Math::BigInt with scalars
+
+=item Math::BigRat
+
+Arbitrarily big rationales
+
 =item Math::Complex
 
 Complex numbers and associated mathematical functions
@@ -536,18 +897,94 @@ Complex numbers and associated mathematical functions
 
 Trigonometric functions
 
+=item Memoize
+
+Make functions faster by trading space for time
+
+=item Memoize::AnyDBM_File
+
+Glue to provide EXISTS for AnyDBM_File for Storable use
+
+=item Memoize::Expire
+
+Plug-in module for automatic expiration of memoized values
+
+=item Memoize::ExpireFile
+
+Test for Memoize expiration semantics
+
+=item Memoize::ExpireTest
+
+Test for Memoize expiration semantics
+
+=item Memoize::NDBM_File
+
+Glue to provide EXISTS for NDBM_File for Storable use
+
+=item Memoize::SDBM_File
+
+Glue to provide EXISTS for SDBM_File for Storable use
+
+=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
+
+=item Net::Cmd
+
+Network Command class (as used by FTP, SMTP etc)
+
+=item Net::Config
+
+Local configuration data for libnet
+
+=item Net::Domain
+
+Attempt to evaluate the current host's internet name and domain
+
+=item Net::FTP
+
+FTP Client class
+
+=item Net::NNTP
+
+NNTP Client class
+
+=item Net::Netrc
+
+OO interface to users netrc file
+
+=item Net::POP3
+
+Post Office Protocol 3 Client class (RFC1939)
+
 =item Net::Ping
 
 Check a remote host for reachability
 
+=item Net::SMTP
+
+Simple Mail Transfer Protocol Client
+
+=item Net::Time
+
+Time and daytime network client interface
+
 =item Net::hostent
 
 By-name interface to Perl's built-in gethost*() functions
 
+=item Net::libnetFAQ
+
+Libnet Frequently Asked Questions
+
 =item Net::netent
 
 By-name interface to Perl's built-in getnet*() functions
@@ -572,6 +1009,30 @@ Tied access to odbm files
 
 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
+
+=item PerlIO::encoding
+
+Encoding layer
+
+=item PerlIO::scalar
+
+Support module for in-memory IO.
+
+=item PerlIO::via
+
+Helper class for PerlIO layers implemented in perl
+
+=item PerlIO::via::QuotedPrint
+
+PerlIO layer for quoted-printable strings
+
 =item Pod::Checker
 
 Check pod documents for syntax errors
@@ -580,6 +1041,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
@@ -596,6 +1061,10 @@ Convert Pod data to formatted Latex
 
 Convert POD data to formatted *roff input
 
+=item Pod::ParseLink
+
+Parse an LE<lt>E<gt> formatting code in POD text
+
 =item Pod::ParseUtils
 
 Helpers for POD parsing and conversion
@@ -620,6 +1089,10 @@ Convert POD data to formatted ASCII text
 
 Convert POD data to formatted color ASCII text
 
+=item Pod::Text::Overstrike
+
+Convert POD data to formatted overstrike text
+
 =item Pod::Text::Termcap
 
 Convert POD data to ASCII text with format escapes
@@ -636,6 +1109,10 @@ Tied access to sdbm files
 
 Compile and execute code in restricted compartments
 
+=item Scalar::Util
+
+A selection of general-utility scalar subroutines
+
 =item Search::Dict
 
 Search for key in dictionary file
@@ -658,12 +1135,24 @@ Load the C socket.h defines and structure manipulators
 
 =item Storable
 
-Persistency for perl data structures
+Persistence for Perl data structures
+
+=item Switch
+
+A switch statement for Perl
 
 =item Symbol
 
 Manipulate Perl symbols and their names
 
+=item Sys::Hostname
+
+Try every conceivable way to get hostname
+
+=item Sys::Syslog
+
+Perl interface to the UNIX syslog(3) calls
+
 =item Term::ANSIColor
 
 Color screen output using ANSI escape sequences
@@ -678,20 +1167,52 @@ Perl word completion module
 
 =item Term::ReadLine
 
-Perl interface to various C<readline> packages. If
+Perl interface to various C<readline> packages.
 
 =item Test
 
 Provides a simple framework for writing test scripts
 
+=item Test::Builder
+
+Backend for building test libraries
+
 =item Test::Harness
 
 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
+
+=item Test::Simple
+
+Basic utilities for writing tests.
+
+=item Test::Tutorial
+
+A tutorial about writing really basic tests
+
 =item Text::Abbrev
 
 Create an abbreviation table from a list
 
+=item Text::Balanced
+
+Extract delimited text sequences from strings.
+
 =item Text::ParseWords
 
 Parse text into an array of tokens or array of arrays
@@ -700,14 +1221,42 @@ Parse text into an array of tokens or array of arrays
 
 Implementation of the Soundex Algorithm as Described by Knuth
 
+=item Text::Tabs
+
+Expand and unexpand tabs per the unix expand(1) and unexpand(1)
+
 =item Text::Wrap
 
 Line wrapping to form simple paragraphs
 
+=item Thread
+
+Manipulate threads in Perl (for old code only)
+
+=item Thread::Queue
+
+Thread-safe queues
+
+=item Thread::Semaphore
+
+Thread-safe semaphores
+
+=item Thread::Signal
+
+Start a thread which runs signal handlers reliably (for old code)
+
+=item Thread::Specific
+
+Thread-specific keys
+
 =item Tie::Array
 
 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
@@ -716,6 +1265,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
@@ -728,6 +1281,10 @@ Base class definitions for tied scalars
 
 Fixed-table-size, fixed-key-length hashing
 
+=item Time::HiRes
+
+High resolution alarm, sleep, gettimeofday, interval timers
+
 =item Time::Local
 
 Efficiently compute time from local and GMT time
@@ -748,6 +1305,18 @@ Internal object used by Time::gmtime and Time::localtime
 
 Base class for ALL classes (blessed references)
 
+=item Unicode::Collate
+
+Unicode Collation Algorithm
+
+=item Unicode::Normalize
+
+Unicode Normalization Forms
+
+=item Unicode::UCD
+
+Unicode character database
+
 =item User::grent
 
 By-name interface to Perl's built-in getgr*() functions
@@ -756,14 +1325,31 @@ By-name interface to Perl's built-in getgr*() functions
 
 By-name interface to Perl's built-in getpw*() functions
 
+=item Win32
+
+Interfaces to some Win32 API Functions
+
+=item XS::APItest
+
+Test the perl C API
+
+=item XS::Typemap
+
+Module to test the XS typemaps distributed with perl
+
+=item XSLoader
+
+Dynamically load C libraries into Perl code
+
 =back
 
 To find out I<all> modules installed on your system, including
 those without documentation or outside the standard release,
 just do this:
 
-    % find `perl -e 'print "@INC"'` -name '*.pm' -print
+    % find `perl -Te 'print "@INC"'` -name '*.pm' -print
 
+(The -T is here to prevent '.' from being listed in @INC.)
 They should all have their own documentation installed and accessible
 via your system man(1) command.  If you do not have a B<find>
 program, you can use the Perl B<find2perl> program instead, which
@@ -772,11 +1358,16 @@ have a B<man> program but it doesn't find your modules, you'll have
 to fix your manpath.  See L<perl> for details.  If you have no
 system B<man> command, you might try the B<perldoc> program.
 
+Note also that the command C<perldoc perllocal> gives you a (possibly
+incomplete) list of the modules that have been further installed on
+your system. (The perllocal.pod file is updated by the standard MakeMaker
+install process.)
+
 =head2 Extension Modules
 
 Extension modules are written in C (or a mix of Perl and C).  They
 are usually dynamically loaded into Perl if and when you need them,
-but may also be be linked in statically.  Supported extension modules
+but may also be linked in statically.  Supported extension modules
 include Socket, Fcntl, and POSIX.
 
 Many popular C extension modules do not come bundled (at least, not
@@ -784,7 +1375,7 @@ completely) due to their sizes, volatility, or simply lack of time
 for adequate testing and configuration across the multitude of
 platforms on which Perl was beta-tested.  You are encouraged to
 look for them on CPAN (described below), or using web search engines
-like Alta Vista or Deja News.
+like Alta Vista or Google.
 
 =head1 CPAN
 
@@ -792,14 +1383,13 @@ 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
 modules are:
 
-=over 4
+=over
 
 =item *
 
@@ -887,179 +1477,649 @@ Miscellaneous Modules
 
 =back
 
-Registered CPAN sites as of this writing include the following.
-You should try to choose one close to you:
+The list of the registered CPAN sites as of this writing follows.
+Please note that the sorting order is alphabetical on fields:
+
+Continent
+   |
+   |-->Country
+         |
+         |-->[state/province]
+                   |
+                   |-->ftp
+                   |
+                   |-->[http]
+
+and thus the North American servers happen to be listed between the
+European and the South American sites.
+
+You should try to choose one close to you.
+
+=head2 Africa
+
+=over 4
+
+=item 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/CPAN/
+
+=back
+
+=head2 Asia
+
+=over 4
+
+=item China
+
+                      ftp://freesoft.cei.gov.cn/pub/languages/perl/CPAN/
+                      http://www2.linuxforum.net/mirror/CPAN/
+                      http://cpan.shellhung.org/
+                      ftp://ftp.shellhung.org/pub/CPAN
+
+=item India
+
+                      http://cpan.in.freeos.com
+                      ftp://cpan.in.freeos.com/pub/CPAN/
+
+=item Indonesia
+
+                      http://cpan.itb.web.id/
+                      ftp://mirrors.piksi.itb.ac.id/CPAN/
+                      http://cpan.cbn.net.id/
+                      ftp://ftp.cbn.net.id/mirror/CPAN
+                      http://CPAN.mweb.co.id/
+                      ftp://ftp.mweb.co.id/pub/languages/perl/CPAN/
+
+=item Israel
+
+                      http://www.iglu.org.il:/pub/CPAN/
+                      ftp://ftp.iglu.org.il/pub/CPAN/
+                      http://cpan.lerner.co.il/
+                      http://bioinfo.weizmann.ac.il/pub/software/perl/CPAN/
+                      ftp://bioinfo.weizmann.ac.il/pub/software/perl/CPAN/
+
+=item Japan
+
+                      ftp://ftp.u-aizu.ac.jp/pub/CPAN
+                      ftp://ftp.kddlabs.co.jp/CPAN/
+                      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/
+
+=item Korea
+
+                      http://mirror.Mazic.org/pub/CPAN
+                      ftp://mirror.Mazic.org/pub/CPAN
+
+=item Philippines
+
+                      http://www.adzu.edu.ph/CPAN
+
+=item Russian Federation
+
+                      http://cpan.tomsk.ru
+                      ftp://cpan.tomsk.ru/pub/CPAN
+
+=item Saudi Arabia
+
+                      ftp://ftp.isu.net.sa/pub/CPAN/
+
+=item Singapore
+
+                      http://cpan.hjc.edu.sg
+                      http://mirror.averse.net/pub/CPAN
+                      ftp://mirror.averse.net/pub/CPAN
+
+=item South Korea
+
+                      http://CPAN.bora.net/
+                      ftp://ftp.bora.net/pub/CPAN/
+                      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://ftp.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/
+                      ftp://ftp.tku.edu.tw/pub/CPAN/
+
+=item Thailand
+
+                      ftp://ftp.loxinfo.co.th/pub/cpan/
+                      ftp://ftp.cs.riubon.ac.th/pub/mirrors/CPAN/
+
+=back
+
+=head2 Central America
+
+=over 4
+
+=item Costa Rica
+
+                      ftp://ftp.linux.co.cr/mirrors/CPAN/
+                      http://ftp.ucr.ac.cr/Unix/CPAN/
+                      ftp://ftp.ucr.ac.cr/pub/Unix/CPAN/
+
+=back
+
+=head2 Europe
+
+=over 4
+
+=item Austria
+
+                      ftp://ftp.tuwien.ac.at/pub/CPAN/
+
+=item Belgium
+
+                      http://ftp.easynet.be/pub/CPAN/
+                      ftp://ftp.easynet.be/pub/CPAN/
+                      http://cpan.skynet.be
+                      ftp://ftp.skynet.be/pub/CPAN
+                      ftp://ftp.kulnet.kuleuven.ac.be/pub/mirror/CPAN/
+
+=item Bulgaria
+
+                      http://cpan.lirex.net/
+                      ftp://ftp.lirex.net/pub/mirrors/CPAN
+
+=item Croatia
+
+                      http://ftp.linux.hr/pub/CPAN/
+                      ftp://ftp.linux.hr/pub/CPAN/
+
+=item Czech Republic
+
+                      http://ftp.fi.muni.cz/pub/CPAN/
+                      ftp://ftp.fi.muni.cz/pub/CPAN/
+                      ftp://sunsite.mff.cuni.cz/MIRRORS/ftp.funet.fi/pub/languages/perl/CPAN/
+
+=item Denmark
+
+                      http://mirrors.sunsite.dk/cpan/
+                      ftp://sunsite.dk/mirrors/cpan/
+                      http://cpan.cybercity.dk
+                      http://www.cpan.dk/CPAN/
+                      ftp://www.cpan.dk/ftp.cpan.org/CPAN/
+
+=item Estonia
+
+                      ftp://ftp.ut.ee/pub/languages/perl/CPAN/
+
+=item Finland
+
+                      ftp://ftp.funet.fi/pub/languages/perl/CPAN/
+                      http://cpan.kpnqwest.fi/
+
+=item France
+
+                      http://ftp.u-paris10.fr/perl/CPAN
+                      ftp://ftp.u-paris10.fr/perl/CPAN
+                      http://cpan.mirrors.easynet.fr/
+                      ftp://cpan.mirrors.easynet.fr/pub/ftp.cpan.org/
+                      ftp://ftp.club-internet.fr/pub/perl/CPAN/
+                      http://fr.cpan.org/
+                      ftp://ftp.lip6.fr/pub/perl/CPAN/
+                      ftp://ftp.oleane.net/pub/mirrors/CPAN/
+                      ftp://ftp.pasteur.fr/pub/computing/CPAN/
+                      http://mir2.ovh.net/ftp.cpan.org
+                      ftp://mir1.ovh.net/ftp.cpan.org
+                      http://ftp.u-strasbg.fr/CPAN
+                      ftp://ftp.u-strasbg.fr/CPAN
+                      http://cpan.cict.fr/
+                      ftp://cpan.cict.fr/pub/CPAN/
+                      ftp://ftp.uvsq.fr/pub/perl/CPAN/
+
+=item Germany
+
+                      ftp://ftp.rz.ruhr-uni-bochum.de/pub/CPAN/
+                      ftp://ftp.freenet.de/pub/ftp.cpan.org/pub/CPAN/
+                      ftp://ftp.uni-erlangen.de/pub/source/CPAN/
+                      ftp://ftp-stud.fht-esslingen.de/pub/Mirrors/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/
+                      ftp://ftp.leo.org/pub/CPAN/
+                      http://cpan.noris.de/
+                      ftp://cpan.noris.de/pub/CPAN/
+                      ftp://ftp.mpi-sb.mpg.de/pub/perl/CPAN/
+                      ftp://ftp.gmd.de/mirrors/CPAN/
+
+=item Greece
+
+                      ftp://ftp.acn.gr/pub/lang/perl/CPAN
+                      ftp://ftp.forthnet.gr/pub/languages/perl/CPAN
+                      ftp://ftp.ntua.gr/pub/lang/perl/
+
+=item Hungary
+
+                      http://cpan.artifact.hu/
+                      ftp://cpan.artifact.hu/CPAN/
+                      http://ftp.kfki.hu/packages/perl/CPAN/
+                      ftp://ftp.kfki.hu/pub/packages/perl/CPAN/
+
+=item Iceland
+
+                      http://ftp.rhnet.is/pub/CPAN/
+                      ftp://ftp.rhnet.is/pub/CPAN/
+
+=item Ireland
+
+                      http://cpan.indigo.ie/
+                      ftp://cpan.indigo.ie/pub/CPAN/
+                      http://sunsite.compapp.dcu.ie/pub/perl/
+                      ftp://sunsite.compapp.dcu.ie/pub/perl/
+
+=item Italy
+
+                      http://cpan.nettuno.it/
+                      http://gusp.dyndns.org/CPAN/
+                      ftp://gusp.dyndns.org/pub/CPAN
+                      http://softcity.iol.it/cpan
+                      ftp://softcity.iol.it/pub/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/
+                      ftp://ftp.flashnet.it/pub/CPAN/
+
+=item Latvia
+
+                      http://kvin.lv/pub/CPAN/
+
+=item Lithuania
+
+                      ftp://ftp.unix.lt/pub/CPAN/
+
+=item 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://ftp.easynet.nl/mirror/CPAN
+                      ftp://ftp.easynet.nl/mirror/CPAN
+                      http://archive.cs.uu.nl/mirror/CPAN/
+                      ftp://ftp.cs.uu.nl/mirror/CPAN/
+
+=item Norway
+
+                      ftp://ftp.uninett.no/pub/languages/perl/CPAN
+                      ftp://ftp.uit.no/pub/languages/perl/cpan/
+
+=item Poland
+
+                      ftp://ftp.pk.edu.pl/pub/lang/perl/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/
+
+=item Portugal
+
+                      ftp://ftp.ua.pt/pub/CPAN/
+                      ftp://perl.di.uminho.pt/pub/CPAN/
+                      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/
+                      ftp://ftp.netc.pt/pub/CPAN/
+                      ftp://ftp.up.pt/pub/CPAN
+
+=item Romania
+
+                      ftp://ftp.kappa.ro/pub/mirrors/ftp.perl.org/pub/CPAN/
+                      ftp://ftp.dntis.ro/pub/cpan/
+                      ftp://ftp.dnttm.ro/pub/CPAN/
+                      ftp://ftp.lasting.ro/pub/CPAN
+                      ftp://ftp.timisoara.roedu.net/mirrors/CPAN/
+
+=item Russia
+
+                      ftp://ftp.chg.ru/pub/lang/perl/CPAN/
+                      http://cpan.rinet.ru/
+                      ftp://cpan.rinet.ru/pub/mirror/CPAN/
+                      ftp://ftp.aha.ru/pub/CPAN/
+                      http://cpan.sai.msu.ru/
+                      ftp://ftp.sai.msu.su/pub/lang/perl/CPAN/
+
+=item Slovakia
+
+                      http://ftp.cvt.stuba.sk/pub/CPAN/
+                      ftp://ftp.cvt.stuba.sk/pub/CPAN/
+
+=item Slovenia
+
+                      ftp://ftp.arnes.si/software/perl/CPAN/
+
+=item Spain
+
+                      http://cpan.imasd.elmundo.es/
+                      ftp://ftp.rediris.es/mirror/CPAN/
+                      ftp://ftp.etse.urv.es/pub/perl/
+
+=item Sweden
+
+                      http://ftp.du.se/CPAN/
+                      ftp://ftp.du.se/pub/CPAN/
+                      ftp://mirror.dataphone.se/pub/CPAN
+                      ftp://ftp.sunet.se/pub/lang/perl/CPAN/
+
+=item Switzerland
+
+                      ftp://ftp.danyk.ch/CPAN/
+                      ftp://sunsite.cnlab-switch.ch/mirror/CPAN/
+
+=item Turkey
+
+                      http://ftp.ulak.net.tr/perl/CPAN/
+                      ftp://ftp.ulak.net.tr/perl/CPAN
+                      ftp://sunsite.bilkent.edu.tr/pub/languages/CPAN/
+
+=item Ukraine
+
+                      http://cpan.org.ua/
+                      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/
+                      http://cpan.m.flirble.org/
+                      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
+
+=over 4
+
+=item Alberta
+
+                      http://sunsite.ualberta.ca/pub/Mirror/CPAN/
+                      ftp://sunsite.ualberta.ca/pub/Mirror/CPAN/
+
+=item Manitoba
+
+                      http://theoryx5.uwinnipeg.ca/pub/CPAN/
+                      ftp://theoryx5.uwinnipeg.ca/pub/CPAN/
+
+=item Nova Scotia
+
+                      ftp://cpan.chebucto.ns.ca/pub/CPAN/
+
+=item Ontario
+
+                      ftp://ftp.crc.ca/pub/CPAN/
+
+=item Quebec
+
+                      http://cpan.mirror.smartworker.org/
+
+=item Mexico
+
+                      http://cpan.azc.uam.mx
+                      ftp://cpan.azc.uam.mx/mirrors/CPAN
+                      http://cpan.unam.mx/
+                      ftp://cpan.unam.mx/pub/CPAN
+                      http://www.msg.com.mx/CPAN/
+                      ftp://ftp.msg.com.mx/pub/CPAN/
+
+=back
+
+=head2 United States
+
+=over 4
+
+=item Alabama
+
+                      http://mirror.hiwaay.net/CPAN/
+                      ftp://mirror.hiwaay.net/CPAN/
+
+=item California
+
+                      http://cpan.develooper.com/
+                      http://www.cpan.org/
+                      ftp://cpan.valueclick.com/pub/CPAN/
+                      http://mirrors.gossamer-threads.com/CPAN
+                      ftp://cpan.nas.nasa.gov/pub/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.perl.com/CPAN/
+                      http://download.sourceforge.net/mirrors/CPAN/
+
+=item Colorado
+
+                      ftp://ftp.cs.colorado.edu/pub/perl/CPAN/
+
+=item Delaware
+
+                      http://ftp.lug.udel.edu/pub/CPAN
+                      ftp://ftp.lug.udel.edu/pub/CPAN
+
+=item District of Columbia
+
+                      ftp://ftp.dc.aleron.net/pub/CPAN/
+
+=item Florida
+
+                      ftp://ftp.cise.ufl.edu/pub/mirrors/CPAN/
+                      http://mirror.csit.fsu.edu/pub/CPAN/
+                      ftp://mirror.csit.fsu.edu/pub/CPAN/
+                      http://cpan.mirrors.nks.net/
+
+=item Illinois
+
+                      http://uiarchive.uiuc.edu/mirrors/ftp/cpan.cse.msu.edu/
+                      ftp://uiarchive.uiuc.edu/mirrors/ftp/cpan.cse.msu.edu/
+
+=item Indiana
+
+                      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/
+                      http://csociety-ftp.ecn.purdue.edu/pub/CPAN
+                      ftp://csociety-ftp.ecn.purdue.edu/pub/CPAN
+
+=item Kentucky
+
+                      http://cpan.uky.edu/
+                      ftp://cpan.uky.edu/pub/CPAN/
+
+=item 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/
+
+=item Michigan
+
+                      ftp://cpan.cse.msu.edu/
+
+=item New Jersey
+
+                      ftp://ftp.cpanel.net/pub/CPAN/
+                      http://cpan.teleglobe.net/
+                      ftp://cpan.teleglobe.net/pub/CPAN
+
+=item New York
+
+                      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/
+                      ftp://mirrors.cloud9.net/pub/mirrors/CPAN/
+
+=item North Carolina
+
+                      ftp://ftp.duke.edu/pub/perl/
+
+=item Ohio
+
+                      ftp://ftp.loaded.net/pub/CPAN/
+
+=item Oklahoma
+
+                      ftp://ftp.ou.edu/mirrors/CPAN/
+
+=item Oregon
+
+                      ftp://ftp.orst.edu/pub/CPAN
+
+=item Pennsylvania
+
+                      http://ftp.epix.net/CPAN/
+                      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 Tennessee
+
+                      ftp://ftp.sunsite.utk.edu/pub/CPAN/
+
+=item Texas
+
+                      http://ftp.sedl.org/pub/mirrors/CPAN/
+                      ftp://mirror.telentente.com/pub/CPAN
+
+=item Utah
+
+                      ftp://mirror.xmission.com/CPAN/
+
+=item 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/
+
+=item ashington
+
+                      http://cpan.llarian.net/
+                      ftp://cpan.llarian.net/pub/CPAN/
+                      http://cpan.mirrorcentral.com/
+                      ftp://ftp.mirrorcentral.com/pub/CPAN/
+                      ftp://ftp-mirror.internap.com/pub/CPAN/
+
+=item Wisconsin
+
+                      http://mirror.sit.wisc.edu/pub/CPAN/
+                      ftp://mirror.sit.wisc.edu/pub/CPAN/
+
+=back
+
+=head2 Oceania
 
 =over 4
 
-=item Africa
-
-    South Africa   ftp://ftp.is.co.za/programming/perl/CPAN/
-                   ftp://ftp.saix.net/pub/CPAN/
-                   ftp://ftp.sun.ac.za/CPAN/
-                   ftp://ftpza.co.za/pub/mirrors/cpan/
-
-
-=item Asia
-
-    China          ftp://freesoft.cei.gov.cn/pub/languages/perl/CPAN/
-    Hong Kong      ftp://ftp.pacific.net.hk/pub/mirror/CPAN/
-    Indonesia      ftp://malone.piksi.itb.ac.id/pub/CPAN/
-    Israel         ftp://bioinfo.weizmann.ac.il/pub/software/perl/CPAN/
-    Japan          ftp://ftp.dti.ad.jp/pub/lang/CPAN/
-                   ftp://ftp.jaist.ac.jp/pub/lang/perl/CPAN/
-                   ftp://ftp.lab.kdd.co.jp/lang/perl/CPAN/
-                   ftp://ftp.meisei-u.ac.jp/pub/CPAN/
-                   ftp://ftp.ring.gr.jp/pub/lang/perl/CPAN/
-                   ftp://mirror.nucba.ac.jp/mirror/Perl/
-    Saudi-Arabia   ftp://ftp.isu.net.sa/pub/CPAN/
-    Singapore      ftp://ftp.nus.edu.sg/pub/unix/perl/CPAN/
-    South Korea    ftp://ftp.bora.net/pub/CPAN/
-                   ftp://ftp.kornet.net/pub/CPAN/
-                   ftp://ftp.nuri.net/pub/CPAN/
-    Taiwan         ftp://coda.nctu.edu.tw/computer-languages/perl/CPAN/
-                   ftp://ftp.ee.ncku.edu.tw/pub3/perl/CPAN/
-                   ftp://ftp1.sinica.edu.tw/pub1/perl/CPAN/
-    Thailand       ftp://ftp.nectec.or.th/pub/mirrors/CPAN/
-
-
-=item Australasia
-
-    Australia      ftp://cpan.topend.com.au/pub/CPAN/
-                   ftp://ftp.labyrinth.net.au/pub/perl-CPAN/
-                   ftp://ftp.sage-au.org.au/pub/compilers/perl/CPAN/
-                   ftp://mirror.aarnet.edu.au/pub/perl/CPAN/
-    New Zealand    ftp://ftp.auckland.ac.nz/pub/perl/CPAN/
-                   ftp://sunsite.net.nz/pub/languages/perl/CPAN/
-
-
-=item Central America
-
-    Costa Rica     ftp://ftp.ucr.ac.cr/pub/Unix/CPAN/
-
-
-=item Europe
-
-    Austria        ftp://ftp.tuwien.ac.at/pub/languages/perl/CPAN/
-    Belgium        ftp://ftp.kulnet.kuleuven.ac.be/pub/mirror/CPAN/
-    Bulgaria       ftp://ftp.ntrl.net/pub/mirrors/CPAN/
-    Croatia        ftp://ftp.linux.hr/pub/CPAN/
-    Czech Republic ftp://ftp.fi.muni.cz/pub/perl/
-                   ftp://sunsite.mff.cuni.cz/Languages/Perl/CPAN/
-    Denmark        ftp://sunsite.auc.dk/pub/languages/perl/CPAN/
-    Estonia        ftp://ftp.ut.ee/pub/languages/perl/CPAN/
-    Finland        ftp://ftp.funet.fi/pub/languages/perl/CPAN/
-    France         ftp://ftp.grolier.fr/pub/perl/CPAN/
-                   ftp://ftp.lip6.fr/pub/perl/CPAN/
-                   ftp://ftp.oleane.net/pub/mirrors/CPAN/
-                   ftp://ftp.pasteur.fr/pub/computing/CPAN/
-                   ftp://ftp.uvsq.fr/pub/perl/CPAN/
-    German         ftp://ftp.gigabell.net/pub/CPAN/
-    Germany        ftp://ftp.archive.de.uu.net/pub/CPAN/
-                   ftp://ftp.freenet.de/pub/ftp.cpan.org/pub/
-                   ftp://ftp.gmd.de/packages/CPAN/
-                   ftp://ftp.gwdg.de/pub/languages/perl/CPAN/
-
-ftp://ftp.leo.org/pub/comp/general/programming/languages/script/perl/CPAN/
-                   ftp://ftp.mpi-sb.mpg.de/pub/perl/CPAN/
-                   ftp://ftp.rz.ruhr-uni-bochum.de/pub/CPAN/
-                   ftp://ftp.uni-erlangen.de/pub/source/CPAN/
-                   ftp://ftp.uni-hamburg.de/pub/soft/lang/perl/CPAN/
-    Germany        ftp://ftp.archive.de.uu.net/pub/CPAN/
-                   ftp://ftp.freenet.de/pub/ftp.cpan.org/pub/
-                   ftp://ftp.gmd.de/packages/CPAN/
-                   ftp://ftp.gwdg.de/pub/languages/perl/CPAN/
-
-ftp://ftp.leo.org/pub/comp/general/programming/languages/script/perl/CPAN/
-                   ftp://ftp.mpi-sb.mpg.de/pub/perl/CPAN/
-                   ftp://ftp.rz.ruhr-uni-bochum.de/pub/CPAN/
-                   ftp://ftp.uni-erlangen.de/pub/source/CPAN/
-                   ftp://ftp.uni-hamburg.de/pub/soft/lang/perl/CPAN/
-    Greece         ftp://ftp.ntua.gr/pub/lang/perl/
-    Hungary        ftp://ftp.kfki.hu/pub/packages/perl/CPAN/
-    Iceland        ftp://ftp.gm.is/pub/CPAN/
-    Ireland        ftp://cpan.indigo.ie/pub/CPAN/
-                   ftp://sunsite.compapp.dcu.ie/pub/perl/
-    Italy          ftp://cis.uniRoma2.it/CPAN/
-                   ftp://ftp.flashnet.it/pub/CPAN/
-                   ftp://ftp.unina.it/pub/Other/CPAN/
-                   ftp://ftp.unipi.it/pub/mirror/perl/CPAN/
-    Netherlands    ftp://ftp.cs.uu.nl/mirror/CPAN/
-                   ftp://ftp.nluug.nl/pub/languages/perl/CPAN/
-    Norway         ftp://ftp.uit.no/pub/languages/perl/cpan/
-                   ftp://sunsite.uio.no/pub/languages/perl/CPAN/
-    Poland         ftp://ftp.man.torun.pl/pub/CPAN/
-                   ftp://ftp.pk.edu.pl/pub/lang/perl/CPAN/
-                   ftp://sunsite.icm.edu.pl/pub/CPAN/
-    Portugal       ftp://ftp.ci.uminho.pt/pub/mirrors/cpan/
-                   ftp://ftp.ist.utl.pt/pub/CPAN/
-                   ftp://ftp.ua.pt/pub/CPAN/
-    Romania        ftp://ftp.dnttm.ro/pub/CPAN/
-    Russia         ftp://ftp.chg.ru/pub/lang/perl/CPAN/
-                   ftp://ftp.sai.msu.su/pub/lang/perl/CPAN/
-    Slovakia       ftp://ftp.entry.sk/pub/languages/perl/CPAN/
-    Slovenia       ftp://ftp.arnes.si/software/perl/CPAN/
-    Spain          ftp://ftp.etse.urv.es/pub/perl/
-                   ftp://ftp.rediris.es/mirror/CPAN/
-    Sweden         ftp://ftp.sunet.se/pub/lang/perl/CPAN/
-    Switzerland    ftp://sunsite.cnlab-switch.ch/mirror/CPAN/
-    Turkey         ftp://sunsite.bilkent.edu.tr/pub/languages/CPAN/
-    United Kingdom ftp://ftp.demon.co.uk/pub/mirrors/perl/CPAN/
-                   ftp://ftp.flirble.org/pub/languages/perl/CPAN/
-
-ftp://ftp.mirror.ac.uk/sites/ftp.funet.fi/pub/languages/perl/CPAN/
-                   ftp://ftp.plig.org/pub/CPAN/
-                   ftp://sunsite.doc.ic.ac.uk/packages/CPAN/
-
-
-=item North America
-
-    Alberta        ftp://sunsite.ualberta.ca/pub/Mirror/CPAN/
-    California     ftp://cpan.nas.nasa.gov/pub/perl/CPAN/
-                   ftp://cpan.valueclick.com/CPAN/
-                   ftp://ftp.cdrom.com/pub/perl/CPAN/
-                   http://download.sourceforge.net/mirrors/CPAN/
-    Colorado       ftp://ftp.cs.colorado.edu/pub/perl/CPAN/
-    Florida        ftp://ftp.cise.ufl.edu/pub/perl/CPAN/
-    Georgia        ftp://ftp.twoguys.org/CPAN/
-    Illinois       ftp://uiarchive.uiuc.edu/pub/lang/perl/CPAN/
-    Indiana        ftp://csociety-ftp.ecn.purdue.edu/pub/CPAN/
-                   ftp://ftp.uwsg.indiana.edu/pub/perl/CPAN/
-    Kentucky       ftp://ftp.uky.edu/CPAN/
-    Manitoba       ftp://theoryx5.uwinnipeg.ca/pub/CPAN/
-    Massachusetts
-ftp://ftp.ccs.neu.edu/net/mirrors/ftp.funet.fi/pub/languages/perl/CPAN/
-                   ftp://ftp.iguide.com/pub/mirrors/packages/perl/CPAN/
-    Mexico         ftp://ftp.msg.com.mx/pub/CPAN/
-    New York       ftp://ftp.deao.net/pub/CPAN/
-                   ftp://ftp.rge.com/pub/languages/perl/
-    North Carolina ftp://ftp.duke.edu/pub/perl/
-    Nova Scotia    ftp://cpan.chebucto.ns.ca/pub/CPAN/
-    Oklahoma       ftp://ftp.ou.edu/mirrors/CPAN/
-    Ontario        ftp://ftp.crc.ca/pub/packages/lang/perl/CPAN/
-    Oregon         ftp://ftp.orst.edu/pub/packages/CPAN/
-    Pennsylvania   ftp://ftp.epix.net/pub/languages/perl/
-    Tennessee      ftp://ftp.sunsite.utk.edu/pub/CPAN/
-    Texas          ftp://ftp.sedl.org/pub/mirrors/CPAN/
-                   ftp://jhcloos.com/pub/mirror/CPAN/
-    Utah           ftp://mirror.xmission.com/CPAN/
-    Virginia       ftp://ftp.perl.org/pub/perl/CPAN/
-                   ftp://ruff.cs.jmu.edu/pub/CPAN/
-    Washington     ftp://ftp-mirror.internap.com/pub/CPAN/
-                   ftp://ftp.llarian.net/pub/CPAN/
-                   ftp://ftp.spu.edu/pub/CPAN/
-
-
-=item South America
-
-    Brazil         ftp://cpan.if.usp.br/pub/mirror/CPAN/
-                   ftp://ftp.matrix.com.br/pub/perl/
-    Chile          ftp://sunsite.dcc.uchile.cl/pub/Lang/PERL/
+=item Australia
+
+                      http://ftp.planetmirror.com/pub/CPAN/
+                      ftp://ftp.planetmirror.com/pub/CPAN/
+                      ftp://mirror.aarnet.edu.au/pub/perl/CPAN/
+                      ftp://cpan.topend.com.au/pub/CPAN/
+
+=item New Zealand
+
+                      ftp://ftp.auckland.ac.nz/pub/perl/CPAN/
+                      http://cpan.soa.co.nz/CPAN/
 
 =back
 
+=head2 South America
+
+=over 4
+
+=item Argentina
+
+                      ftp://mirrors.bannerlandia.com.ar/mirrors/CPAN/
+                      http://ftp.fcaglp.unlp.edu.ar/pub/CPAN/
+                      ftp://ftp.fcaglp.unlp.edu.ar/pub/CPAN/
+
+=item Brazil
+
+                      ftp://cpan.pop-mg.com.br/pub/CPAN/
+                      ftp://ftp.matrix.com.br/pub/perl/CPAN/
+
+=item Chile
+
+                      http://cpan.netglobalis.net/
+                      ftp://cpan.netglobalis.net/pub/CPAN/
+
+=back
+
+=head2 RSYNC Mirrors
+
+                      ftp.fcaglp.unlp.edu.ar::CPAN
+                      cpan.mirror.smartworker.org::CPAN
+                      theoryx5.uwinnipeg.ca::CPAN
+                      ftp.shellhung.org::CPAN
+                      ftp.funet.fi::CPAN
+                      ftp.u-paris10.fr::CPAN
+                      mir1.ovh.net::CPAN
+                      ftp.gwdg.de::FTP/languages/perl/CPAN/
+                      ftp.leo.org::CPAN
+                      CPAN.piksi.itb.ac.id::CPAN
+                      ftp.cbn.net.id::CPAN
+                      ftp.iglu.org.il::CPAN
+                      gusp.dyndns.org::cpan
+                      ftp.kddlabs.co.jp::cpan
+                      ftp.ayamura.org::pub/CPAN/
+                      mirror.averse.net::cpan
+                      cpan.teleglobe.net::CPAN
+                      ftp.sedl.org::cpan
+                      archive.progeny.com::CPAN
+                      cpan.teleglobe.net::CPAN
+                      ftp.lug.udel.edu::cpan
+                      mirrors.kernel.org::mirrors/CPAN
+                      mirrors.phenominet.com::CPAN
+                      mirror.csit.fsu.edu::CPAN
+                      csociety-ftp.ecn.purdue.edu::CPAN
+
 For an up-to-date listing of CPAN sites,
-see http://www.perl.com/perl/CPAN/SITES or ftp://www.perl.com/CPAN/SITES .
+see http://www.cpan.org/SITES or ftp://www.cpan.org/SITES .
 
 =head1 Modules: Creation, Use, and Abuse
 
@@ -1087,7 +2147,9 @@ the AUTOLOAD mechanism.
 
 =over 4
 
-=item Do similar modules already exist in some form?
+=item  *
+
+Do similar modules already exist in some form?
 
 If so, please try to reuse the existing modules either in whole or
 by inheriting useful features into a new class.  If this is not
@@ -1101,7 +2163,9 @@ modules, please coordinate with the author of the package.  It
 helps if you follow the same naming scheme and module interaction
 scheme as the original author.
 
-=item Try to design the new module to be easy to extend and reuse.
+=item  *
+
+Try to design the new module to be easy to extend and reuse.
 
 Try to C<use warnings;> (or C<use warnings qw(...);>).
 Remember that you can add C<no warnings qw(...);> to individual blocks
@@ -1166,7 +2230,9 @@ Follow the guidelines in the perlstyle(1) manual.
 
 Always use B<-w>.
 
-=item Some simple style guidelines
+=item  *
+
+Some simple style guidelines
 
 The perlstyle manual supplied with Perl has many helpful points.
 
@@ -1198,7 +2264,9 @@ e.g., C<< $obj->as_string() >>.
 You can use a leading underscore to indicate that a variable or
 function should not be used outside the package that defined it.
 
-=item Select what to export.
+=item  *
+
+Select what to export.
 
 Do NOT export method names!
 
@@ -1222,7 +2290,9 @@ As a general rule, if the module is trying to be object oriented
 then export nothing. If it's just a collection of functions then
 @EXPORT_OK anything but use @EXPORT with caution.
 
-=item Select a name for the module.
+=item  *
+
+Select a name for the module.
 
 This name should be as descriptive, accurate, and complete as
 possible.  Avoid any risk of ambiguity. Always try to use two or
@@ -1256,7 +2326,9 @@ To be portable each component of a module name should be limited to
 11 characters. If it might be used on MS-DOS then try to ensure each is
 unique in the first 8 characters. Nested modules make this easier.
 
-=item Have you got it right?
+=item  *
+
+Have you got it right?
 
 How do you know that you've made the right decisions? Have you
 picked an interface design that will cause problems later? Have
@@ -1275,7 +2347,9 @@ Don't worry about posting if you can't say when the module will be
 ready - just say so in the message. It might be worth inviting
 others to help you, they may be able to complete it for you!
 
-=item README and other Additional Files.
+=item  *
+
+README and other Additional Files.
 
 It's well known that software developers usually fully document the
 software they write. If, however, the world is in urgent need of
@@ -1285,24 +2359,31 @@ documentation please at least provide a README file containing:
 =over 10
 
 =item *
+
 A description of the module/package/extension etc.
 
 =item *
+
 A copyright notice - see below.
 
 =item *
+
 Prerequisites - what else you may need to have.
 
 =item *
+
 How to build it - possible changes to Makefile.PL etc.
 
 =item *
+
 How to install it.
 
 =item *
+
 Recent changes in this release, especially incompatibilities
 
 =item *
+
 Changes / enhancements you plan to make in the future.
 
 =back
@@ -1313,7 +2394,9 @@ Copying, ToDo etc.
 
 =over 4
 
-=item Adding a Copyright Notice.
+=item *
+
+Adding a Copyright Notice.
 
 How you choose to license your work is a personal decision.
 The general mechanism is to assert your Copyright and then make
@@ -1334,7 +2417,9 @@ This statement should at least appear in the README file. You may
 also wish to include it in a Copying file and your source files.
 Remember to include the other words in addition to the Copyright.
 
-=item Give the module a version/issue/release number.
+=item  *
+
+Give the module a version/issue/release number.
 
 To be fully compatible with the Exporter and MakeMaker modules you
 should store your module's version number in a non-my package
@@ -1348,7 +2433,9 @@ Use the number in announcements and archive file names when
 releasing the module (ModuleName-1.02.tar.Z).
 See perldoc ExtUtils::MakeMaker.pm for details.
 
-=item How to release and distribute a module.
+=item  *
+
+How to release and distribute a module.
 
 It's good idea to post an announcement of the availability of your
 module (or the module itself if small) to the comp.lang.perl.announce
@@ -1371,8 +2458,8 @@ FTP Archives for Perl Modules:
 
 Follow the instructions and links on:
 
-   http://www.perl.com/CPAN/modules/00modlist.long.html
-   http://www.perl.com/CPAN/modules/04pause.html
+   http://www.cpan.org/modules/00modlist.long.html
+   http://www.cpan.org/modules/04pause.html
 
 or upload to one of these sites:
 
@@ -1387,7 +2474,9 @@ CPAN!
 
 Please remember to send me an updated entry for the Module list!
 
-=item Take care when changing a released module.
+=item  *
+
+Take care when changing a released module.
 
 Always strive to remain compatible with previous released versions.
 Otherwise try to add a mechanism to revert to the
@@ -1401,26 +2490,34 @@ old behavior if people rely on it.  Document incompatible changes.
 
 =over 4
 
-=item There is no requirement to convert anything.
+=item  *
+
+There is no requirement to convert anything.
 
 If it ain't broke, don't fix it! Perl 4 library scripts should
 continue to work with no problems. You may need to make some minor
 changes (like escaping non-array @'s in double quoted strings) but
 there is no need to convert a .pl file into a Module for just that.
 
-=item Consider the implications.
+=item  *
+
+Consider the implications.
 
 All Perl applications that make use of the script will need to
 be changed (slightly) if the script is converted into a module.  Is
 it worth it unless you plan to make other changes at the same time?
 
-=item Make the most of the opportunity.
+=item  *
+
+Make the most of the opportunity.
 
 If you are going to convert the script to a module you can use the
 opportunity to redesign the interface.  The guidelines for module
 creation above include many of the issues you should consider.
 
-=item The pl2pm utility will get you started.
+=item  *
+
+The pl2pm utility will get you started.
 
 This utility will read *.pl files (given as parameters) and write
 corresponding *.pm files. The pl2pm utilities does the following:
@@ -1428,15 +2525,19 @@ corresponding *.pm files. The pl2pm utilities does the following:
 =over 10
 
 =item *
+
 Adds the standard Module prologue lines
 
 =item *
+
 Converts package specifiers from ' to ::
 
 =item *
+
 Converts die(...) to croak(...)
 
 =item *
+
 Several other minor changes
 
 =back
@@ -1451,26 +2552,26 @@ Don't delete the original .pl file till the new .pm one works!
 
 =over 4
 
-=item *
+=item  *
 
 Complete applications rarely belong in the Perl Module Library.
 
-=item *
+=item  *
 
 Many applications contain some Perl code that could be reused.
 
 Help save the world! Share your code in a form that makes it easy
 to reuse.
 
-=item *
+=item  *
 
 Break-out the reusable code into one or more separate module files.
 
-=item *
+=item  *
 
 Take the opportunity to reconsider and redesign the interfaces.
 
-=item *
+=item  *
 
 In some cases the 'application' can then be reduced to a small