Copy perldelta as perl58delta, purge the perldelta.
[p5sagit/p5-mst-13.2.git] / pod / perlmodlib.PL
index 0cdadb7..982adff 100644 (file)
@@ -1,17 +1,23 @@
 #!../miniperl
 
+$ENV{LC_ALL} = 'C';
+
 open (OUT, ">perlmodlib.tmp") or die $!;
-my (@pragma, @mod);
+my (@pragma, @mod, @MANIFEST);
+
 open (MANIFEST, "../MANIFEST") or die $!;
+@MANIFEST = grep !m</(?:t|demo)/>, <MANIFEST>;
+push @MANIFEST, 'lib/Config.pm', 'lib/Errno.pm';
 
-while (<MANIFEST>) {
+for (@MANIFEST) {
      my $filename;
      next unless s|^lib/|| or m|^ext/|;
-     ($filename) = /(\S+)/;
+     ($filename) = m|^(\S+)|;
      $filename =~ s|^[^/]+/|| if $filename =~ s|^ext/||;
-     next unless $filename =~ /\.p(m|od)$/;
+     next unless $filename =~ m!\.p(m|od)$!;
      next unless open (MOD, "../lib/$filename");
 
+
      my ($name, $thing);
      my $foundit=0;
      {
@@ -23,7 +29,7 @@ while (<MANIFEST>) {
         }
      }
      unless ($foundit) {
-        warn "$filename missing head1\n";
+        warn "$filename missing =head1 NAME (okay if there is respective .pod)\n";
         next;
      }
      my $title = <MOD>;
@@ -42,13 +48,12 @@ while (<MANIFEST>) {
         next;
      }
 
+
      $thing =~ s/^perl pragma to //i;
      $thing = ucfirst($thing);
      $title = "=item $perlname\n\n$thing\n\n";
 
-     # print "$perlname $thing\n";
-
-     if ($filename=~/[A-Z]/) {
+     if ($filename =~ /[A-Z]/) {
           push @mod, $title;
      } else {
           push @pragma, $title;
@@ -56,7 +61,8 @@ while (<MANIFEST>) {
 }
 
 print OUT <<'EOF';
-# Generated by perlmodlib.PL  DO NOT EDIT!
+=for maintainers
+Generated by perlmodlib.PL -- DO NOT EDIT!
 
 =head1 NAME
 
@@ -146,7 +152,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
@@ -162,8 +168,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
@@ -257,21 +262,34 @@ 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
+=item South Africa
 
-    ftp://ftp.is.co.za/programming/perl/CPAN/
-    ftp://ftp.saix.net/pub/CPAN/
-    ftp://ftpza.co.za/pub/mirrors/cpan/
-    ftp://ftp.sun.ac.za/CPAN/
+                      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
 
@@ -279,92 +297,93 @@ South Africa
 
 =over 4
 
-=item *
+=item China
 
-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
 
-    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
 
-=item *
+                      http://cpan.in.freeos.com
+                      ftp://cpan.in.freeos.com/pub/CPAN/
 
-Hong Kong
+=item Indonesia
 
-    http://CPAN.pacific.net.hk/
-    ftp://ftp.pacific.net.hk/pub/mirror/CPAN/
+                      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 *
+=item Israel
 
-Indonesia
+                      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/
 
-    http://piksi.itb.ac.id/CPAN/
-    ftp://mirrors.piksi.itb.ac.id/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://bioinfo.weizmann.ac.il/pub/software/perl/CPAN/
-    ftp://bioinfo.weizmann.ac.il/pub/software/perl/CPAN/
-
-=item *
+=item Japan
 
-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/
 
-    ftp://ftp.u-aizu.ac.jp/pub/lang/perl/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.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
 
-=item *
+                      http://mirror.Mazic.org/pub/CPAN
+                      ftp://mirror.Mazic.org/pub/CPAN
 
-Saudi Arabia
+=item Philippines
 
-    ftp://ftp.isu.net.sa/pub/CPAN/
+                      http://www.adzu.edu.ph/CPAN
 
-=item *
+=item Russian Federation
 
-Singapore
+                      http://cpan.tomsk.ru
+                      ftp://cpan.tomsk.ru/pub/CPAN
 
-    http://cpan.hjc.edu.sg
-    http://ftp.nus.edu.sg/unix/perl/CPAN/
-    ftp://ftp.nus.edu.sg/pub/unix/perl/CPAN/
+=item Saudi Arabia
 
-=item *
+                      ftp://ftp.isu.net.sa/pub/CPAN/
 
-South Korea
+=item Singapore
 
-    http://CPAN.bora.net/
-    ftp://ftp.bora.net/pub/CPAN/
-    http://ftp.kornet.net/CPAN/
-    ftp://ftp.kornet.net/pub/CPAN/
-    ftp://ftp.nuri.net/pub/CPAN/
+                      http://cpan.hjc.edu.sg
+                      http://mirror.averse.net/pub/CPAN
+                      ftp://mirror.averse.net/pub/CPAN
 
-=item *
+=item South Korea
 
-Taiwan
+                      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
 
-    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/
+=item Taiwan
 
-=item *
+                      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/
 
-Thailand
+=item Thailand
 
-    http://download.nectec.or.th/CPAN/
-    ftp://ftp.nectec.or.th/pub/languages/CPAN/
-    ftp://ftp.cs.riubon.ac.th/pub/mirrors/CPAN/
+                      ftp://ftp.loxinfo.co.th/pub/cpan/
+                      ftp://ftp.cs.riubon.ac.th/pub/mirrors/CPAN/
 
 =back
 
@@ -372,13 +391,11 @@ Thailand
 
 =over 4
 
-=item *
-
-Costa Rica
+=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/
+                      ftp://ftp.linux.co.cr/mirrors/CPAN/
+                      http://ftp.ucr.ac.cr/Unix/CPAN/
+                      ftp://ftp.ucr.ac.cr/pub/Unix/CPAN/
 
 =back
 
@@ -386,250 +403,242 @@ Costa Rica
 
 =over 4
 
-=item *
+=item Austria
 
-Austria
+                      ftp://ftp.tuwien.ac.at/pub/CPAN/
 
-    ftp://ftp.tuwien.ac.at/pub/languages/perl/CPAN/
+=item Belgium
 
-=item *
+                      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/
 
-Belgium
+=item Bulgaria
 
-    http://ftp.easynet.be/CPAN/
-    ftp://ftp.easynet.be/CPAN/
-    ftp://ftp.kulnet.kuleuven.ac.be/pub/mirror/CPAN/
+                      http://cpan.lirex.net/
+                      ftp://ftp.lirex.net/pub/mirrors/CPAN
 
-=item *
+=item Croatia
 
-Bulgaria
+                      http://ftp.linux.hr/pub/CPAN/
+                      ftp://ftp.linux.hr/pub/CPAN/
 
-    ftp://ftp.ntrl.net/pub/mirrors/CPAN/
+=item Czech Republic
 
-=item *
+                      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/
 
-Croatia
+=item Denmark
 
-    ftp://ftp.linux.hr/pub/CPAN/
+                      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 *
+=item Estonia
 
-Czech Republic
+                      ftp://ftp.ut.ee/pub/languages/perl/CPAN/
 
-    http://www.fi.muni.cz/pub/perl/
-    ftp://ftp.fi.muni.cz/pub/perl/
-    ftp://sunsite.mff.cuni.cz/MIRRORS/ftp.funet.fi/pub/languages/perl/CPAN/
+=item Finland
 
-=item *
+                      ftp://ftp.funet.fi/pub/languages/perl/CPAN/
+                      http://cpan.kpnqwest.fi/
 
-Denmark
+=item France
 
-    ftp://sunsite.auc.dk/pub/languages/perl/CPAN/
-    http://www.cpan.dk/CPAN/
-    ftp://www.cpan.dk/ftp.cpan.org/CPAN/
+                      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 *
+=item Germany
 
-England
+                      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/
 
-    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/
-    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 Greece
 
-=item *
-
-Estonia
-
-    ftp://ftp.ut.ee/pub/languages/perl/CPAN/
-
-=item *
+                      ftp://ftp.acn.gr/pub/lang/perl/CPAN
+                      ftp://ftp.forthnet.gr/pub/languages/perl/CPAN
+                      ftp://ftp.ntua.gr/pub/lang/perl/
 
-Finland
+=item Hungary
 
-    ftp://ftp.funet.fi/pub/languages/perl/CPAN/
+                      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 *
-
-France
-
-    ftp://cpan.ftp.worldonline.fr/pub/CPAN/
-    ftp://ftp.club-internet.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://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
-    ftp://ftp.gigabell.net/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/comp/general/programming/languages/script/perl/CPAN/
-    ftp://ftp.mpi-sb.mpg.de/pub/perl/CPAN/
-    ftp://ftp.gmd.de/mirrors/CPAN/
-
-=item *
-
-Greece
-
-    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/
-    ftp://ftp.kfki.hu/pub/packages/perl/CPAN/
-
-=item *
-
-Iceland
-
-    http://cpan.gm.is/
-    ftp://ftp.gm.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/
-    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 *
-
-Netherlands
-
-    ftp://download.xs4all.nl/pub/mirror/CPAN/
-    ftp://ftp.nl.uu.net/pub/CPAN/
-    ftp://ftp.nluug.nl/pub/languages/perl/CPAN/
-    ftp://ftp.cpan.nl/pub/CPAN/
-    http://www.cs.uu.nl/mirror/CPAN/
-    ftp://ftp.cs.uu.nl/mirror/CPAN/
-
-=item *
+=item Iceland
 
-Norway
+                      http://ftp.rhnet.is/pub/CPAN/
+                      ftp://ftp.rhnet.is/pub/CPAN/
 
-    ftp://sunsite.uio.no/pub/languages/perl/CPAN/
-    ftp://ftp.uit.no/pub/languages/perl/cpan/
+=item Ireland
 
-=item *
+                      http://cpan.indigo.ie/
+                      ftp://cpan.indigo.ie/pub/CPAN/
+                      http://sunsite.compapp.dcu.ie/pub/perl/
+                      ftp://sunsite.compapp.dcu.ie/pub/perl/
 
-Poland
+=item Italy
 
-    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/
+                      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 *
+=item Latvia
 
-Portugal
+                      http://kvin.lv/pub/CPAN/
 
-    ftp://ftp.ua.pt/pub/CPAN/
-    ftp://perl.di.uminho.pt/pub/CPAN/
-    ftp://ftp.ist.utl.pt/pub/CPAN/
-    ftp://ftp.netc.pt/pub/CPAN/
+=item Lithuania
 
-=item *
+                      ftp://ftp.unix.lt/pub/CPAN/
 
-Romania
+=item Netherlands
 
-    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.timisoara.roedu.net/mirrors/CPAN/
+                      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 *
+=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
 
-Russia
+=item Romania
 
-    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/
-    ftp://ftp.sai.msu.su/pub/lang/perl/CPAN/
+                      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 *
+=item Russia
 
-Slovakia
+                      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/
 
-    ftp://ftp.entry.sk/pub/languages/perl/CPAN/
+=item Slovakia
 
-=item *
+                      http://ftp.cvt.stuba.sk/pub/CPAN/
+                      ftp://ftp.cvt.stuba.sk/pub/CPAN/
 
-Slovenia
+=item Slovenia
 
-    ftp://ftp.arnes.si/software/perl/CPAN/
+                      ftp://ftp.arnes.si/software/perl/CPAN/
 
-=item *
+=item Spain
 
-Spain
+                      http://cpan.imasd.elmundo.es/
+                      ftp://ftp.rediris.es/mirror/CPAN/
+                      ftp://ftp.etse.urv.es/pub/perl/
 
-    ftp://ftp.rediris.es/mirror/CPAN/
-    ftp://ftp.etse.urv.es/pub/perl/
+=item Sweden
 
-=item *
+                      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/
 
-Sweden
+=item Switzerland
 
-    http://ftp.du.se/CPAN/
-    ftp://ftp.du.se/pub/CPAN/
-    ftp://ftp.sunet.se/pub/lang/perl/CPAN/
+                      ftp://ftp.danyk.ch/CPAN/
+                      ftp://sunsite.cnlab-switch.ch/mirror/CPAN/
 
-=item *
+=item Turkey
 
-Switzerland
+                      http://ftp.ulak.net.tr/perl/CPAN/
+                      ftp://ftp.ulak.net.tr/perl/CPAN
+                      ftp://sunsite.bilkent.edu.tr/pub/languages/CPAN/
 
-    ftp://ftp.danyk.ch/CPAN/
-    ftp://sunsite.cnlab-switch.ch/mirror/CPAN/
+=item Ukraine
 
-=item *
+                      http://cpan.org.ua/
+                      ftp://cpan.org.ua/
+                      ftp://ftp.perl.org.ua/pub/CPAN/
 
-Turkey
+=item United Kingdom
 
-    ftp://sunsite.bilkent.edu.tr/pub/languages/CPAN/
+                      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
 
@@ -637,215 +646,192 @@ Turkey
 
 =over 4
 
-=item *
-
-Canada
-
-=over 8
-
-=item *
-
-Alberta
-
-    http://sunsite.ualberta.ca/pub/Mirror/CPAN/
-    ftp://sunsite.ualberta.ca/pub/Mirror/CPAN/
-
-=item *
+=item Alberta
 
-Manitoba
+                      http://sunsite.ualberta.ca/pub/Mirror/CPAN/
+                      ftp://sunsite.ualberta.ca/pub/Mirror/CPAN/
 
-    http://theoryx5.uwinnipeg.ca/pub/CPAN/
-    ftp://theoryx5.uwinnipeg.ca/pub/CPAN/
+=item Manitoba
 
-=item *
+                      http://theoryx5.uwinnipeg.ca/pub/CPAN/
+                      ftp://theoryx5.uwinnipeg.ca/pub/CPAN/
 
-Nova Scotia
+=item Nova Scotia
 
-    ftp://cpan.chebucto.ns.ca/pub/CPAN/
+                      ftp://cpan.chebucto.ns.ca/pub/CPAN/
 
-=item *
+=item Ontario
 
-Ontario
+                      ftp://ftp.crc.ca/pub/CPAN/
 
-    ftp://ftp.crc.ca/pub/packages/lang/perl/CPAN/
+=item Quebec
 
-=item *
+                      http://cpan.mirror.smartworker.org/
 
-Mexico
+=item Mexico
 
-    http://www.msg.com.mx/CPAN/
-    ftp://ftp.msg.com.mx/pub/CPAN/
+                      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
-
-=over 8
-
-=item *
-
-Alabama
-
-    http://mirror.hiwaay.net/CPAN/
-    ftp://mirror.hiwaay.net/CPAN/
+=head2 United States
 
-=item *
-
-California
-
-    http://www.cpan.org/
-    ftp://ftp.cpan.org/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://www.perl.com/CPAN/
-    http://download.sourceforge.net/mirrors/CPAN/
-
-=item *
-
-Colorado
-
-    ftp://ftp.cs.colorado.edu/pub/perl/CPAN/
-
-=item *
+=over 4
 
-Florida
+=item Alabama
 
-    ftp://ftp.cise.ufl.edu/pub/perl/CPAN/
+                      http://mirror.hiwaay.net/CPAN/
+                      ftp://mirror.hiwaay.net/CPAN/
 
-=item *
+=item California
 
-Georgia
+                      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/
 
-    ftp://ftp.twoguys.org/CPAN/
+=item Colorado
 
-=item *
+                      ftp://ftp.cs.colorado.edu/pub/perl/CPAN/
 
-Illinois
+=item Delaware
 
-    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://ftp.lug.udel.edu/pub/CPAN
+                      ftp://ftp.lug.udel.edu/pub/CPAN
 
-=item *
+=item District of Columbia
 
-Indiana
+                      ftp://ftp.dc.aleron.net/pub/CPAN/
 
-    ftp://ftp.uwsg.indiana.edu/pub/perl/CPAN/
-    http://cpan.nitco.com/
-    ftp://cpan.nitco.com/pub/CPAN/
-    ftp://cpan.in-span.net/
-    http://csociety-ftp.ecn.purdue.edu/pub/CPAN
-    ftp://csociety-ftp.ecn.purdue.edu/pub/CPAN
+=item Florida
 
-=item *
+                      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/
 
-Kentucky
+=item Illinois
 
-    http://cpan.uky.edu/
-    ftp://cpan.uky.edu/pub/CPAN/
+                      http://uiarchive.uiuc.edu/mirrors/ftp/cpan.cse.msu.edu/
+                      ftp://uiarchive.uiuc.edu/mirrors/ftp/cpan.cse.msu.edu/
 
-=item *
+=item Indiana
 
-Massachusetts
+                      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
 
-    ftp://ftp.ccs.neu.edu/net/mirrors/ftp.funet.fi/pub/languages/perl/CPAN/
-    ftp://ftp.iguide.com/pub/mirrors/packages/perl/CPAN/
+=item Kentucky
 
-=item *
+                      http://cpan.uky.edu/
+                      ftp://cpan.uky.edu/pub/CPAN/
 
-New Jersey
+=item Massachusetts
 
-    ftp://ftp.cpanel.net/pub/CPAN/
+                      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 *
+=item Michigan
 
-New York
+                      ftp://cpan.cse.msu.edu/
 
-    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/
-    http://www.rge.com/pub/languages/perl/
-    ftp://ftp.rge.com/pub/languages/perl/
-    ftp://mirrors.cloud9.net/pub/mirrors/CPAN/
+=item New Jersey
 
-=item *
+                      ftp://ftp.cpanel.net/pub/CPAN/
+                      http://cpan.teleglobe.net/
+                      ftp://cpan.teleglobe.net/pub/CPAN
 
-North Carolina
+=item New York
 
-    ftp://ftp.duke.edu/pub/perl/
+                      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 *
+=item North Carolina
 
-Ohio
+                      ftp://ftp.duke.edu/pub/perl/
 
-    ftp://ftp.loaded.net/pub/CPAN/
+=item Ohio
 
-=item *
+                      ftp://ftp.loaded.net/pub/CPAN/
 
-Oklahoma
+=item Oklahoma
 
-    ftp://ftp.ou.edu/mirrors/CPAN/
+                      ftp://ftp.ou.edu/mirrors/CPAN/
 
-=item *
+=item Oregon
 
-Oregon
+                      ftp://ftp.orst.edu/pub/CPAN
 
-    ftp://ftp.orst.edu/pub/packages/CPAN/
+=item Pennsylvania
 
-=item *
+                      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/
 
-Pennsylvania
+=item Tennessee
 
-    http://ftp.epix.net/CPAN/
-    ftp://ftp.epix.net/pub/languages/perl/
-    ftp://carroll.cac.psu.edu/pub/CPAN/
+                      ftp://ftp.sunsite.utk.edu/pub/CPAN/
 
-=item *
+=item Texas
 
-Tennessee
+                      http://ftp.sedl.org/pub/mirrors/CPAN/
+                      ftp://mirror.telentente.com/pub/CPAN
 
-    ftp://ftp.sunsite.utk.edu/pub/CPAN/
+=item Utah
 
-=item *
+                      ftp://mirror.xmission.com/CPAN/
 
-Texas
+=item Virginia
 
-    http://ftp.sedl.org/pub/mirrors/CPAN/
-    http://jhcloos.com/pub/mirror/CPAN/
-    ftp://jhcloos.com/pub/mirror/CPAN/
+                      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 *
-
-Utah
+=item ashington
 
-    ftp://mirror.xmission.com/CPAN/
-
-=item *
+                      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/
 
-Virginia
+=item Wisconsin
 
-    http://mirrors.rcn.net/pub/lang/CPAN/
-    ftp://mirrors.rcn.net/pub/lang/CPAN/
-    ftp://ruff.cs.jmu.edu/pub/CPAN/
-    http://perl.Liquidation.com/CPAN/
-
-=item *
-
-Washington
-
-    http://cpan.llarian.net/
-    ftp://cpan.llarian.net/pub/CPAN/
-    ftp://ftp-mirror.internap.com/pub/CPAN/
-    ftp://ftp.spu.edu/pub/CPAN/
-
-=back
+                      http://mirror.sit.wisc.edu/pub/CPAN/
+                      ftp://mirror.sit.wisc.edu/pub/CPAN/
 
 =back
 
@@ -853,20 +839,17 @@ Washington
 
 =over 4
 
-=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 Australia
 
-=item *
+                      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/
 
-New Zealand
+=item New Zealand
 
-    ftp://ftp.auckland.ac.nz/pub/perl/CPAN/
+                      ftp://ftp.auckland.ac.nz/pub/perl/CPAN/
+                      http://cpan.soa.co.nz/CPAN/
 
 =back
 
@@ -874,29 +857,52 @@ New Zealand
 
 =over 4
 
-=item *
+=item Argentina
 
-Argentina
+                      ftp://mirrors.bannerlandia.com.ar/mirrors/CPAN/
+                      http://ftp.fcaglp.unlp.edu.ar/pub/CPAN/
+                      ftp://ftp.fcaglp.unlp.edu.ar/pub/CPAN/
 
-    ftp://mirrors.bannerlandia.com.ar/mirrors/CPAN/
+=item Brazil
 
-=item *
+                      ftp://cpan.pop-mg.com.br/pub/CPAN/
+                      ftp://ftp.matrix.com.br/pub/perl/CPAN/
 
-Brazil
+=item Chile
 
-    ftp://cpan.pop-mg.com.br/pub/CPAN/
-    ftp://ftp.matrix.com.br/pub/perl/
-    ftp://cpan.if.usp.br/pub/mirror/CPAN/
-
-=item *
-
-Chile
-
-    ftp://ftp.psinet.cl/pub/programming/perl/CPAN/
-    ftp://sunsite.dcc.uchile.cl/pub/lang/perl/
+                      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.cpan.org/SITES or ftp://www.cpan.org/SITES .
 
@@ -1173,8 +1179,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