This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Small doc tweaks.
[perl5.git] / pod / perlmodlib.pod
index fbd3686..8ad8072 100644 (file)
@@ -1,4 +1,5 @@
-# Generated by perlmodlib.PL  DO NOT EDIT!
+=for maintainers
+Generated by perlmodlib.PL -- DO NOT EDIT!
 
 =head1 NAME
 
@@ -52,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
@@ -74,7 +71,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
 
@@ -84,6 +81,10 @@ Declare constants
 
 Perl compiler pragma to force verbose warning diagnostics
 
+=item encoding
+
+Pragma to control the conversion of legacy data into Unicode
+
 =item fields
 
 Compile-time class fields
@@ -108,22 +109,18 @@ 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
 
-=item re
-
-Alter regular expression behaviour
-
 =item sigtrap
 
 Enable simple signal handling
 
+=item sort
+
+Control sort() behaviour
+
 =item strict
 
 Restrict unsafe constructs
@@ -132,10 +129,6 @@ Restrict unsafe constructs
 
 Predeclare sub names
 
-=item unicode::distinct
-
-Strictly distinguish UTF8 data and non-UTF data.
-
 =item utf8
 
 Enable/disable UTF-8 (or UTF-EBCDIC) in source code
@@ -144,6 +137,10 @@ Enable/disable UTF-8 (or UTF-EBCDIC) in source code
 
 Predeclare global variable names (obsolete)
 
+=item vmsish
+
+Control VMS-specific language features
+
 =item warnings
 
 Control optional warnings
@@ -178,82 +175,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
@@ -326,10 +251,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
@@ -346,18 +267,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
@@ -450,10 +359,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
@@ -486,6 +391,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
@@ -496,7 +405,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
 
@@ -504,7 +413,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
 
@@ -558,10 +467,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
@@ -602,6 +507,10 @@ Arbitrary size floating point math package
 
 Arbitrary size integer math package
 
+=item Math::BigInt::Calc
+
+Pure Perl module to support Math::BigInt
+
 =item Math::Complex
 
 Complex numbers and associated mathematical functions
@@ -638,18 +547,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
@@ -666,10 +567,6 @@ Local configuration data for libnet
 
 Attempt to evaluate the current host's internet name and domain
 
-=item Net::DummyInetd
-
-A dummy Inetd server
-
 =item Net::FTP
 
 FTP Client class
@@ -682,10 +579,6 @@ NNTP Client class
 
 OO interface to users netrc file
 
-=item Net::PH
-
-CCSO Nameserver Client class
-
 =item Net::POP3
 
 Post Office Protocol 3 Client class (RFC1081)
@@ -698,10 +591,6 @@ Check a remote host for reachability
 
 Simple Mail Transfer Protocol Client
 
-=item Net::SNPP
-
-Simple Network Pager Protocol Client
-
 =item Net::Time
 
 Time and daytime network client interface
@@ -726,22 +615,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
@@ -754,6 +627,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
@@ -770,6 +647,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
@@ -806,13 +687,9 @@ Convert POD data to ASCII text with format escapes
 
 Print a usage message from embedded pod documentation
 
-=item SDBM_File
-
-Tied access to sdbm files
+=item Pod::t::basic
 
-=item Safe
-
-Compile and execute code in restricted compartments
+Test of various basic POD features in translators.
 
 =item Search::Dict
 
@@ -830,14 +707,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
@@ -866,6 +735,10 @@ Perl interface to various C<readline> packages. If
 
 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
@@ -878,6 +751,10 @@ Yet another framework for writing test scripts
 
 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
@@ -904,23 +781,7 @@ Line wrapping to form simple paragraphs
 
 =item Thread
 
-Manipulate threads in Perl (EXPERIMENTAL, subject to change)
-
-=item Thread::Queue
-
-Thread-safe queues
-
-=item Thread::Semaphore
-
-Thread-safe semaphores
-
-=item Thread::Signal
-
-Start a thread which runs signal handlers reliably
-
-=item Thread::Specific
-
-Thread-specific keys
+Manipulate threads in Perl
 
 =item Tie::Array
 
@@ -966,6 +827,14 @@ Internal object used by Time::gmtime and Time::localtime
 
 Base class for ALL classes (blessed references)
 
+=item Unicode::Collate
+
+Use UCA (Unicode Collation Algorithm)
+
+=item Unicode::UCD
+
+Unicode character database
+
 =item User::grent
 
 By-name interface to Perl's built-in getgr*() functions
@@ -998,7 +867,7 @@ system B<man> command, you might try the B<perldoc> program.
 
 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
@@ -1014,8 +883,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
@@ -1121,8 +989,8 @@ You should try to choose one close to you:
 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://ftpza.co.za/pub/mirrors/cpan/
     ftp://ftp.sun.ac.za/CPAN/
 
 =back
@@ -1137,21 +1005,23 @@ 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
 
 =item *
 
-Hong Kong
+India
 
-    http://CPAN.pacific.net.hk/
-    ftp://ftp.pacific.net.hk/pub/mirror/CPAN/
+    http://cpan.in.freeos.com
+    ftp://cpan.in.freeos.com/pub/CPAN/
 
 =item *
 
 Indonesia
 
-    http://piksi.itb.ac.id/CPAN/
+    http://cpan.itb.web.id/
     ftp://mirrors.piksi.itb.ac.id/CPAN/
     http://CPAN.mweb.co.id/
     ftp://ftp.mweb.co.id/pub/languages/perl/CPAN/
@@ -1162,6 +1032,7 @@ 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/
 
@@ -1169,7 +1040,7 @@ Israel
 
 Japan
 
-    ftp://ftp.u-aizu.ac.jp/pub/lang/perl/CPAN/
+    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/
@@ -1180,6 +1051,26 @@ Japan
 
 =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/
@@ -1189,8 +1080,6 @@ Saudi Arabia
 Singapore
 
     http://cpan.hjc.edu.sg
-    http://ftp.nus.edu.sg/unix/perl/CPAN/
-    ftp://ftp.nus.edu.sg/pub/unix/perl/CPAN/
 
 =item *
 
@@ -1198,7 +1087,7 @@ South Korea
 
     http://CPAN.bora.net/
     ftp://ftp.bora.net/pub/CPAN/
-    http://ftp.kornet.net/CPAN/
+    http://ftp.kornet.net/pub/CPAN/
     ftp://ftp.kornet.net/pub/CPAN/
     ftp://ftp.nuri.net/pub/CPAN/
 
@@ -1209,6 +1098,8 @@ 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/
+    ftp://ftp.tku.edu.tw/pub/CPAN/
 
 =item *
 
@@ -1242,14 +1133,16 @@ Costa Rica
 
 Austria
 
-    ftp://ftp.tuwien.ac.at/pub/languages/perl/CPAN/
+    ftp://ftp.tuwien.ac.at/pub/CPAN/
 
 =item *
 
 Belgium
 
-    http://ftp.easynet.be/CPAN/
-    ftp://ftp.easynet.be/CPAN/
+    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 *
@@ -1268,15 +1161,16 @@ Croatia
 
 Czech Republic
 
-    http://www.fi.muni.cz/pub/perl/
-    ftp://ftp.fi.muni.cz/pub/perl/
+    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
 
-    ftp://sunsite.auc.dk/pub/languages/perl/CPAN/
+    http://mirrors.sunsite.dk/cpan/
+    ftp://sunsite.dk/mirrors/cpan/
     http://www.cpan.dk/CPAN/
     ftp://www.cpan.dk/ftp.cpan.org/CPAN/
 
@@ -1286,7 +1180,8 @@ 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/
-    ftp://ftp.demon.co.uk/pub/mirrors/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/
@@ -1305,16 +1200,21 @@ Estonia
 Finland
 
     ftp://ftp.funet.fi/pub/languages/perl/CPAN/
+    http://cpan.kpnqwest.fi/
 
 =item *
 
 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/
+    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://cpan.cict.fr/
     ftp://cpan.cict.fr/pub/CPAN/
     ftp://ftp.uvsq.fr/pub/perl/CPAN/
 
@@ -1330,7 +1230,9 @@ Germany
     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/comp/general/programming/languages/script/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/
 
@@ -1347,14 +1249,15 @@ Hungary
 
     http://cpan.artifact.hu/
     ftp://cpan.artifact.hu/CPAN/
-    ftp://ftp.kfki.hu/pub/packages/perl/CPAN/
+    http://ftp.kfki.hu/pub/CPAN/
+    ftp://ftp.kfki.hu/pub/CPAN/
 
 =item *
 
 Iceland
 
-    http://cpan.gm.is/
-    ftp://ftp.gm.is/pub/CPAN/
+    http://ftp.rhnet.is/pub/CPAN/
+    ftp://ftp.rhnet.is/pub/CPAN/
 
 =item *
 
@@ -1388,11 +1291,19 @@ Latvia
 
 =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://www.cs.uu.nl/mirror/CPAN/
     ftp://ftp.cs.uu.nl/mirror/CPAN/
@@ -1401,7 +1312,7 @@ Netherlands
 
 Norway
 
-    ftp://sunsite.uio.no/pub/languages/perl/CPAN/
+    ftp://ftp.uninett.no/pub/languages/perl/CPAN
     ftp://ftp.uit.no/pub/languages/perl/cpan/
 
 =item *
@@ -1409,6 +1320,8 @@ 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/
@@ -1419,8 +1332,13 @@ Portugal
 
     ftp://ftp.ua.pt/pub/CPAN/
     ftp://perl.di.uminho.pt/pub/CPAN/
+    http://cpan.ip.pt/
+    ftp://cpan.ip.pt/pub/perl/
     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 *
 
@@ -1431,6 +1349,7 @@ Romania
     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/
 
 =item *
@@ -1441,6 +1360,7 @@ Russia
     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 *
@@ -1468,6 +1388,7 @@ 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 *
@@ -1483,6 +1404,14 @@ Turkey
 
     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/
+
 =back
 
 =head2 North America
@@ -1519,17 +1448,28 @@ Nova Scotia
 
 Ontario
 
-    ftp://ftp.crc.ca/pub/packages/lang/perl/CPAN/
+    ftp://ftp.crc.ca/pub/CPAN/
+
+=item *
+
+Quebec
+
+    http://cpan.mirror.smartworker.org/
+    ftp://cpan.mirror.smartworker.org/pub/CPAN
+
+=back
 
 =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
-
 =item *
 
 United States
@@ -1548,11 +1488,16 @@ Alabama
 California
 
     http://www.cpan.org/
-    ftp://ftp.cpan.org/CPAN/
+    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://www.kernel.org/pub/mirrors/cpan/
-    ftp://ftp.kernel.org/pub/mirrors/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/
 
@@ -1564,23 +1509,24 @@ Colorado
 
 =item *
 
-Florida
+District of Columbia
 
-    ftp://ftp.cise.ufl.edu/pub/perl/CPAN/
+    ftp://ftp.dc.us.telia.net/pub/cpan/
 
 =item *
 
-Georgia
+Florida
 
-    ftp://ftp.twoguys.org/CPAN/
+    ftp://ftp.cise.ufl.edu/pub/mirrors/CPAN/
+    http://mirror.csit.fsu.edu/pub/CPAN/
+    ftp://mirror.csit.fsu.edu/pub/CPAN/
 
 =item *
 
 Illinois
 
-    http://www.neurogames.com/mirrors/CPAN
-    http://uiarchive.uiuc.edu/mirrors/ftp/ftp.cpan.org/pub/CPAN/
-    ftp://uiarchive.uiuc.edu/mirrors/ftp/ftp.cpan.org/pub/CPAN/
+    http://uiarchive.uiuc.edu/mirrors/ftp/cpan.cse.msu.edu/
+    ftp://uiarchive.uiuc.edu/mirrors/ftp/cpan.cse.msu.edu/
 
 =item *
 
@@ -1589,6 +1535,8 @@ Indiana
     ftp://ftp.uwsg.indiana.edu/pub/perl/CPAN/
     http://cpan.nitco.com/
     ftp://cpan.nitco.com/pub/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
@@ -1605,10 +1553,18 @@ Kentucky
 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 *
 
+Michigan
+
+    ftp://cpan.cse.msu.edu/
+
+=item *
+
 New Jersey
 
     ftp://ftp.cpanel.net/pub/CPAN/
@@ -1618,11 +1574,7 @@ New Jersey
 New York
 
     ftp://ftp.freesoftware.com/pub/perl/CPAN/
-    http://www.deao.net/mirrors/CPAN/
-    ftp://ftp.deao.net/pub/CPAN/
-    ftp://ftp.stealth.net/pub/mirrors/ftp.cpan.org/pub/CPAN/
-    http://mirror.nyc.anidea.com/CPAN/
-    ftp://mirror.nyc.anidea.com/pub/CPAN/
+    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/
@@ -1649,7 +1601,7 @@ Oklahoma
 
 Oregon
 
-    ftp://ftp.orst.edu/pub/packages/CPAN/
+    ftp://ftp.orst.edu/pub/CPAN
 
 =item *
 
@@ -1657,6 +1609,8 @@ 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/
     ftp://carroll.cac.psu.edu/pub/CPAN/
 
 =item *
@@ -1670,8 +1624,6 @@ Tennessee
 Texas
 
     http://ftp.sedl.org/pub/mirrors/CPAN/
-    http://jhcloos.com/pub/mirror/CPAN/
-    ftp://jhcloos.com/pub/mirror/CPAN/
 
 =item *
 
@@ -1694,8 +1646,9 @@ Washington
 
     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/
-    ftp://ftp.spu.edu/pub/CPAN/
 
 =back
 
@@ -1717,7 +1670,6 @@ Australia
 =item *
 
 New Zealand
-
     ftp://ftp.auckland.ac.nz/pub/perl/CPAN/
 
 =back
@@ -1737,8 +1689,7 @@ Argentina
 Brazil
 
     ftp://cpan.pop-mg.com.br/pub/CPAN/
-    ftp://ftp.matrix.com.br/pub/perl/
-    ftp://cpan.if.usp.br/pub/mirror/CPAN/
+    ftp://ftp.matrix.com.br/pub/perl/CPAN/
 
 =item *
 
@@ -1749,6 +1700,7 @@ Chile
 
 =back
 
+
 For an up-to-date listing of CPAN sites,
 see http://www.cpan.org/SITES or ftp://www.cpan.org/SITES .
 
@@ -2025,8 +1977,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