Remove duplicate assignment to PL_eval_root in Perl_create_eval_scope
[p5sagit/p5-mst-13.2.git] / pod / perlmodlib.pod
index 28f25af..223b7df 100644 (file)
@@ -47,6 +47,18 @@ The following pragmas are defined (and have their own documentation).
 
 =over 12
 
+=item assertions
+
+Select assertions in blocks of code
+
+=item assertions::activate
+
+Activate assertions
+
+=item assertions::compat
+
+Assertions for pre-5.9 versions of perl
+
 =item attributes
 
 Get/set subroutine or variable attributes
@@ -61,7 +73,7 @@ Postpone load of modules until a function is used
 
 =item base
 
-Establish IS-A relationship with base class at compile time
+Establish IS-A relationship with base classes at compile time
 
 =item bigint
 
@@ -73,7 +85,7 @@ Transparent BigNumber support for Perl
 
 =item bigrat
 
-Transparent BigNumber/BigRationale support for Perl
+Transparent BigNumber/BigRational support for Perl
 
 =item blib
 
@@ -93,12 +105,20 @@ Declare constants
 
 =item diagnostics
 
-Perl compiler pragma to force verbose warning diagnostics
+Produce verbose warning diagnostics
 
 =item encoding
 
 Allows you to write your script in non-ascii or non-utf8
 
+=item encoding::warnings
+
+Warn on implicit encoding conversions
+
+=item feature
+
+Enable new syntactic features
+
 =item fields
 
 Compile-time class fields
@@ -137,7 +157,7 @@ Restrict unsafe operations when compiling
 
 =item overload
 
-Package for overloading perl operations
+Package for overloading Perl operations
 
 =item re
 
@@ -161,7 +181,7 @@ Predeclare sub names
 
 =item threads
 
-Perl extension allowing use of interpreter based threads from perl
+Perl interpreter-based threads
 
 =item threads::shared
 
@@ -209,6 +229,14 @@ don't have the gdbm library.
 
 Provide framework for multiple DBMs
 
+=item Archive::Tar
+
+Module for manipulations of tar archives
+
+=item Archive::Tar::File
+
+A subclass for in-memory extracted file from Archive::Tar
+
 =item Attribute::Handlers
 
 Simpler definition of attribute handlers
@@ -345,13 +373,17 @@ Utility for CPAN::Config file Initialization
 
 Wrapper around CPAN.pm without using any XS module
 
+=item CPAN::Version
+
+Utility functions to compare CPAN versions
+
 =item Carp
 
 Warn of errors (from perspective of caller)
 
 =item Carp::Heavy
 
-No user serviceable parts inside
+Heavy machinery, no user serviceable parts inside
 
 =item Class::ISA
 
@@ -361,6 +393,14 @@ Report the search path for a class's ISA tree
 
 Declare struct-like datatypes as Perl classes
 
+=item Compress::Raw::Zlib
+
+Low-Level Interface to zlib compression library
+
+=item Compress::Zlib
+
+Interface to zlib compression library
+
 =item Config
 
 Access Perl configuration information
@@ -373,6 +413,30 @@ Get pathname of current working directory
 
 Programmatic interface to the Perl debugging API (draft, subject to
 
+=item DBM_Filter
+
+Filter DBM keys/values 
+
+=item DBM_Filter::compress
+
+Filter for DBM_Filter
+
+=item DBM_Filter::encode
+
+Filter for DBM_Filter
+
+=item DBM_Filter::int32
+
+Filter for DBM_Filter
+
+=item DBM_Filter::null
+
+Filter for DBM_Filter
+
+=item DBM_Filter::utf8
+
+Filter for DBM_Filter
+
 =item DB_File
 
 Perl5 access to Berkeley DB version 1.x
@@ -401,6 +465,18 @@ Modules that calculate message digests
 
 Perl interface to the MD5 Algorithm
 
+=item Digest::SHA
+
+Perl extension for SHA-1/224/256/384/512
+
+=item Digest::base
+
+Digest base class
+
+=item Digest::file
+
+Calculate digests of files
+
 =item DirHandle
 
 Supply object methods for directory handles
@@ -501,6 +577,10 @@ Taiwan-based Chinese Encodings
 
 Various Unicode Transformation Formats
 
+=item Encode::Unicode::UTF7
+
+UTF-7 encoding
+
 =item English
 
 Use nice English (or awk) names for ugly punctuation variables
@@ -521,6 +601,14 @@ Implements default import method for modules
 
 Exporter guts
 
+=item ExtUtils::CBuilder
+
+Compile and link C code for Perl modules
+
+=item ExtUtils::CBuilder::Platform::Windows
+
+Builder class for Windows platforms
+
 =item ExtUtils::Command
 
 Utilities to replace common UNIX commands in Makefiles etc.
@@ -533,6 +621,18 @@ Commands for the MM's to use in Makefiles
 
 Generate XS code to import C header constants
 
+=item ExtUtils::Constant::Base
+
+Base class for ExtUtils::Constant objects
+
+=item ExtUtils::Constant::Utils
+
+Helper functions for ExtUtils::Constant
+
+=item ExtUtils::Constant::XS
+
+Base class for ExtUtils::Constant objects
+
 =item ExtUtils::Embed
 
 Utilities for embedding Perl in C/C++ applications
@@ -553,9 +653,13 @@ Determine libraries to use and how to use them
 
 OS adjusted ExtUtils::MakeMaker subclass
 
+=item ExtUtils::MM_AIX
+
+AIX specific subclass of ExtUtils::MM_Unix
+
 =item ExtUtils::MM_Any
 
-Platform agnostic MM methods
+Platform-agnostic MM methods
 
 =item ExtUtils::MM_BeOS
 
@@ -571,7 +675,7 @@ DOS specific subclass of ExtUtils::MM_Unix
 
 =item ExtUtils::MM_MacOS
 
-Methods to override UN*X behaviour in ExtUtils::MakeMaker
+Once produced Makefiles for MacOS Classic
 
 =item ExtUtils::MM_NW5
 
@@ -581,6 +685,10 @@ Methods to override UN*X behaviour in ExtUtils::MakeMaker
 
 Methods to override UN*X behaviour in ExtUtils::MakeMaker
 
+=item ExtUtils::MM_QNX
+
+QNX specific subclass of ExtUtils::MM_Unix
+
 =item ExtUtils::MM_UWIN
 
 U/WIN specific subclass of ExtUtils::MM_Unix
@@ -593,6 +701,10 @@ Methods used by ExtUtils::MakeMaker
 
 Methods to override UN*X behaviour in ExtUtils::MakeMaker
 
+=item ExtUtils::MM_VOS
+
+VOS specific subclass of ExtUtils::MM_Unix
+
 =item ExtUtils::MM_Win32
 
 Methods to override UN*X behaviour in ExtUtils::MakeMaker
@@ -607,7 +719,27 @@ ExtUtils::MakeMaker subclass for customization
 
 =item ExtUtils::MakeMaker
 
-Create an extension Makefile
+Create a module Makefile
+
+=item ExtUtils::MakeMaker::Config
+
+Wrapper around Config.pm
+
+=item ExtUtils::MakeMaker::FAQ
+
+Frequently Asked Questions About MakeMaker
+
+=item ExtUtils::MakeMaker::Tutorial
+
+Writing a module with MakeMaker
+
+=item ExtUtils::MakeMaker::bytes
+
+Version-agnostic bytes.pm
+
+=item ExtUtils::MakeMaker::vmsish
+
+Platform-agnostic vmsish.pm
 
 =item ExtUtils::Manifest
 
@@ -625,6 +757,10 @@ Write linker options files for dynamic extension
 
 Manage .packlist files
 
+=item ExtUtils::ParseXS
+
+Converts Perl XS code into C code
+
 =item ExtUtils::testlib
 
 Add blib/* directories to @INC
@@ -639,7 +775,7 @@ Load the C Fcntl.h defines
 
 =item File::Basename
 
-Split a pathname into pieces
+Parse file paths into directory, filename and suffix.
 
 =item File::CheckTree
 
@@ -665,6 +801,10 @@ Traverse a directory tree.
 
 Perl extension for BSD glob routine
 
+=item File::GlobMapper
+
+Extend File Glob to Allow Input and Output Files
+
 =item File::Path
 
 Create or remove directory trees
@@ -749,6 +889,10 @@ Process single-character switches with switch clustering
 
 A selection of general-utility hash subroutines
 
+=item Hash::Util::FieldHash
+
+Associate references with data
+
 =item I18N::Collate
 
 Compare 8-bit scalar data according to the current locale
@@ -757,6 +901,10 @@ Compare 8-bit scalar data according to the current locale
 
 Functions for dealing with RFC3066-style language tags
 
+=item I18N::LangTags::Detect
+
+Detect the user's language preferences
+
 =item I18N::LangTags::List
 
 Tags and names for human languages
@@ -769,6 +917,26 @@ Query locale information
 
 Load various IO modules
 
+=item IO::Compress::Base
+
+Base Class for IO::Compress modules 
+
+=item IO::Compress::Deflate
+
+Write RFC 1950 files/buffers
+
+=item IO::Compress::Gzip
+
+Write RFC 1952 files/buffers
+
+=item IO::Compress::RawDeflate
+
+Write RFC 1951 files/buffers
+
+=item IO::Compress::Zip
+
+Write zip files/buffers
+
 =item IO::Dir
 
 Supply object methods for directory handles
@@ -809,6 +977,38 @@ Object interface for AF_INET domain sockets
 
 Object interface for AF_UNIX domain sockets
 
+=item IO::Uncompress::AnyInflate
+
+Uncompress zlib-based (zip, gzip) file/buffer
+
+=item IO::Uncompress::AnyUncompress
+
+Uncompress gzip, zip, bzip2 or lzop file/buffer
+
+=item IO::Uncompress::Base
+
+Base Class for IO::Uncompress modules 
+
+=item IO::Uncompress::Gunzip
+
+Read RFC 1952 files/buffers
+
+=item IO::Uncompress::Inflate
+
+Read RFC 1950 files/buffers
+
+=item IO::Uncompress::RawInflate
+
+Read RFC 1951 files/buffers
+
+=item IO::Uncompress::Unzip
+
+Read zip files/buffers
+
+=item IO::Zlib
+
+IO:: style interface to L<Compress::Zlib>
+
 =item IPC::Open2
 
 Open a process for both reading and writing
@@ -875,19 +1075,23 @@ Arbitrary size floating point math package
 
 =item Math::BigInt
 
-Arbitrary size integer math package
+Arbitrary size integer/float math package
 
 =item Math::BigInt::Calc
 
 Pure Perl module to support Math::BigInt
 
-=item Math::BigInt::Scalar
+=item Math::BigInt::CalcEmu
+
+Emulate low-level math with BigInt code
 
-Pure Perl module to test Math::BigInt with scalars
+=item Math::BigInt::FastCalc
+
+Math::BigInt::Calc with some XS for more speed
 
 =item Math::BigRat
 
-Arbitrarily big rationales
+Arbitrary big rational numbers
 
 =item Math::Complex
 
@@ -929,13 +1133,125 @@ Glue to provide EXISTS for SDBM_File for Storable use
 
 Store Memoized data in Storable database
 
+=item Module::Build
+
+Build and install Perl modules
+
+=item Module::Build::API
+
+API Reference for Module Authors
+
+=item Module::Build::Authoring
+
+Authoring Module::Build modules
+
+=item Module::Build::Base
+
+Default methods for Module::Build
+
+=item Module::Build::Compat
+
+Compatibility with ExtUtils::MakeMaker
+
+=item Module::Build::ConfigData
+
+Configuration for Module::Build
+
+=item Module::Build::Cookbook
+
+Examples of Module::Build Usage
+
+=item Module::Build::ModuleInfo
+
+Gather package and POD information from a perl module files
+
+=item Module::Build::Notes
+
+Configuration for $module_name
+
+=item Module::Build::PPMMaker
+
+Perl Package Manager file creation
+
+=item Module::Build::Platform::Amiga
+
+Builder class for Amiga platforms
+
+=item Module::Build::Platform::Default
+
+Stub class for unknown platforms
+
+=item Module::Build::Platform::EBCDIC
+
+Builder class for EBCDIC platforms
+
+=item Module::Build::Platform::MPEiX
+
+Builder class for MPEiX platforms
+
+=item Module::Build::Platform::MacOS
+
+Builder class for MacOS platforms
+
+=item Module::Build::Platform::RiscOS
+
+Builder class for RiscOS platforms
+
+=item Module::Build::Platform::Unix
+
+Builder class for Unix platforms
+
+=item Module::Build::Platform::VMS
+
+Builder class for VMS platforms
+
+=item Module::Build::Platform::VOS
+
+Builder class for VOS platforms
+
+=item Module::Build::Platform::Windows
+
+Builder class for Windows platforms
+
+=item Module::Build::Platform::aix
+
+Builder class for AIX platform
+
+=item Module::Build::Platform::cygwin
+
+Builder class for Cygwin platform
+
+=item Module::Build::Platform::darwin
+
+Builder class for Mac OS X platform
+
+=item Module::Build::Platform::os2
+
+Builder class for OS/2 platform
+
+=item Module::Build::YAML
+
+Provides just enough YAML support so that Module::Build works even if YAML.pm is not installed
+
+=item Module::CoreList
+
+What modules shipped with versions of perl
+
+=item Module::Load
+
+Runtime require of both modules and files
+
+=item Module::Loaded
+
+Mark modules as loaded or unloaded
+
 =item NDBM_File
 
 Tied access to ndbm files
 
 =item NEXT
 
-Provide a pseudo-class NEXT that allows method redispatch
+Provide a pseudo-class NEXT (et al) that allows method redispatch
 
 =item Net::Cmd
 
@@ -1013,6 +1329,10 @@ Disable named opcodes when compiling perl code
 
 Perl interface to IEEE Std 1003.1
 
+=item Package::Constants
+
+List all constants declared in a package
+
 =item PerlIO
 
 On demand loader for PerlIO layers and root of PerlIO::* name space
@@ -1023,7 +1343,7 @@ Encoding layer
 
 =item PerlIO::scalar
 
-Support module for in-memory IO.
+In-memory IO, scalar IO
 
 =item PerlIO::via
 
@@ -1037,6 +1357,10 @@ PerlIO layer for quoted-printable strings
 
 Check pod documents for syntax errors
 
+=item Pod::Escapes
+
+For resolving Pod EE<lt>...E<gt> sequences
+
 =item Pod::Find
 
 Find POD documents in directory trees
@@ -1073,6 +1397,42 @@ Helpers for POD parsing and conversion
 
 Base class for creating POD filters and translators
 
+=item Pod::Perldoc::ToChecker
+
+Let Perldoc check Pod for errors
+
+=item Pod::Perldoc::ToMan
+
+Let Perldoc render Pod as man pages
+
+=item Pod::Perldoc::ToNroff
+
+Let Perldoc convert Pod to nroff
+
+=item Pod::Perldoc::ToPod
+
+Let Perldoc render Pod as ... Pod!
+
+=item Pod::Perldoc::ToRtf
+
+Let Perldoc render Pod as RTF
+
+=item Pod::Perldoc::ToText
+
+Let Perldoc render Pod as plaintext
+
+=item Pod::Perldoc::ToTk
+
+Let Perldoc use Tk::Pod to render Pod
+
+=item Pod::Perldoc::ToXml
+
+Let Perldoc render Pod as XML
+
+=item Pod::PlainText
+
+Convert POD data to formatted ASCII text
+
 =item Pod::Plainer
 
 Perl extension for converting Pod to old style Pod.
@@ -1081,6 +1441,90 @@ Perl extension for converting Pod to old style Pod.
 
 Extract selected sections of POD from input
 
+=item Pod::Simple
+
+Framework for parsing Pod
+
+=item Pod::Simple::Checker
+
+Check the Pod syntax of a document
+
+=item Pod::Simple::Debug
+
+Put Pod::Simple into trace/debug mode
+
+=item Pod::Simple::DumpAsText
+
+Dump Pod-parsing events as text
+
+=item Pod::Simple::DumpAsXML
+
+Turn Pod into XML
+
+=item Pod::Simple::HTML
+
+Convert Pod to HTML
+
+=item Pod::Simple::HTMLBatch
+
+Convert several Pod files to several HTML files
+
+=item Pod::Simple::LinkSection
+
+Represent "section" attributes of L codes
+
+=item Pod::Simple::Methody
+
+Turn Pod::Simple events into method calls
+
+=item Pod::Simple::PullParser
+
+A pull-parser interface to parsing Pod
+
+=item Pod::Simple::PullParserEndToken
+
+End-tokens from Pod::Simple::PullParser
+
+=item Pod::Simple::PullParserStartToken
+
+Start-tokens from Pod::Simple::PullParser
+
+=item Pod::Simple::PullParserTextToken
+
+Text-tokens from Pod::Simple::PullParser
+
+=item Pod::Simple::PullParserToken
+
+Tokens from Pod::Simple::PullParser
+
+=item Pod::Simple::RTF
+
+Format Pod as RTF
+
+=item Pod::Simple::Search
+
+Find POD documents in directory trees
+
+=item Pod::Simple::SimpleTree
+
+Parse Pod into a simple parse tree 
+
+=item Pod::Simple::Subclassing
+
+Write a formatter as a Pod::Simple subclass
+
+=item Pod::Simple::Text
+
+Format Pod as plaintext
+
+=item Pod::Simple::TextContent
+
+Get the text content of Pod
+
+=item Pod::Simple::XMLOutStream
+
+Turn Pod into XML
+
 =item Pod::Text
 
 Convert POD data to formatted ASCII text
@@ -1177,9 +1621,21 @@ Provides a simple framework for writing test scripts
 
 Backend for building test libraries
 
+=item Test::Builder::Module
+
+Base class for test modules
+
+=item Test::Builder::Tester
+
+Test testsuites that have been built with
+
+=item Test::Builder::Tester::Color
+
+Turn on colour in Test::Builder::Tester
+
 =item Test::Harness
 
-Run perl standard test scripts with statistics
+Run Perl standard test scripts with statistics
 
 =item Test::Harness::Assert
 
@@ -1189,10 +1645,22 @@ Simple assert
 
 Internal Test::Harness Iterator
 
+=item Test::Harness::Point
+
+Object for tracking a single test point
+
 =item Test::Harness::Straps
 
 Detailed analysis of test results
 
+=item Test::Harness::TAP
+
+Documentation for the TAP format
+
+=item Test::Harness::Util
+
+Utility functions for Test::Harness::*
+
 =item Test::More
 
 Yet another framework for writing test scripts
@@ -1325,10 +1793,6 @@ 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
@@ -1345,10 +1809,14 @@ Dynamically load C libraries into Perl code
 
 To find out I<all> modules installed on your system, including
 those without documentation or outside the standard release,
-just do this:
+just use the following command (under the default win32 shell,
+double quotes should be used instead of single quotes).
 
-    % find `perl -Te 'print "@INC"'` -name '*.pm' -print
+    % perl -MFile::Find=find -MFile::Spec::Functions -Tlwe \
+      'find { wanted => sub { print canonpath $_ if /\.pm\z/ },
+      no_chdir => 1 }, @INC'
 
+(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
@@ -1357,6 +1825,11 @@ 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
@@ -1495,8 +1968,9 @@ You should try to choose one close to you.
 
 =item South Africa
 
+                      http://ftp.rucus.ru.ac.za/pub/perl/CPAN/
+                      ftp://ftp.rucus.ru.ac.za/pub/perl/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/
 
@@ -1508,28 +1982,19 @@ You should try to choose one close to you.
 
 =item China
 
-                      ftp://freesoft.cei.gov.cn/pub/languages/perl/CPAN/
-                      http://www2.linuxforum.net/mirror/CPAN/
+                      http://cpan.linuxforum.net/
                       http://cpan.shellhung.org/
                       ftp://ftp.shellhung.org/pub/CPAN
-
-=item India
-
-                      http://cpan.in.freeos.com
-                      ftp://cpan.in.freeos.com/pub/CPAN/
+                      ftp://mirrors.hknet.com/CPAN
 
 =item Indonesia
 
-                      http://cpan.itb.web.id/
-                      ftp://mirrors.piksi.itb.ac.id/CPAN/
+                      http://mirrors.tf.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/
@@ -1539,27 +2004,23 @@ You should try to choose one close to you.
 
                       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/
+                      http://ftp.cpan.jp/
+                      ftp://ftp.cpan.jp/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 Malaysia
 
-=item Philippines
-
-                      http://www.adzu.edu.ph/CPAN
+                      http://cpan.MyBSD.org.my
+                      http://mirror.leafbug.org/pub/CPAN
+                      http://ossig.mncc.com.my/mirror/pub/CPAN
 
 =item Russian Federation
 
                       http://cpan.tomsk.ru
-                      ftp://cpan.tomsk.ru/pub/CPAN
+                      ftp://cpan.tomsk.ru/
 
 =item Saudi Arabia
 
@@ -1567,24 +2028,27 @@ You should try to choose one close to you.
 
 =item Singapore
 
-                      http://cpan.hjc.edu.sg
+                      http://CPAN.en.com.sg/
+                      ftp://cpan.en.com.sg/
                       http://mirror.averse.net/pub/CPAN
                       ftp://mirror.averse.net/pub/CPAN
+                      http://cpan.oss.eznetsols.org
+                      ftp://ftp.oss.eznetsols.org/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
+                      http://mirror.kr.FreeBSD.org/CPAN
+                      ftp://ftp.kr.FreeBSD.org/pub/CPAN
 
 =item Taiwan
 
                       ftp://ftp.nctu.edu.tw/UNIX/perl/CPAN
-                      ftp://ftp.ee.ncku.edu.tw/pub/perl/CPAN/
+                      http://cpan.cdpa.nsysu.edu.tw/
+                      ftp://cpan.cdpa.nsysu.edu.tw/pub/CPAN
+                      http://ftp.isu.edu.tw/pub/CPAN
+                      ftp://ftp.isu.edu.tw/pub/CPAN
                       ftp://ftp1.sinica.edu.tw/pub1/perl/CPAN/
                       http://ftp.tku.edu.tw/pub/CPAN/
                       ftp://ftp.tku.edu.tw/pub/CPAN/
@@ -1602,7 +2066,6 @@ You should try to choose one close to you.
 
 =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/
 
@@ -1614,6 +2077,8 @@ You should try to choose one close to you.
 
 =item Austria
 
+                      http://cpan.inode.at/
+                      ftp://cpan.inode.at
                       ftp://ftp.tuwien.ac.at/pub/CPAN/
 
 =item Belgium
@@ -1621,11 +2086,19 @@ You should try to choose one close to you.
                       http://ftp.easynet.be/pub/CPAN/
                       ftp://ftp.easynet.be/pub/CPAN/
                       http://cpan.skynet.be
-                      ftp://ftp.skynet.be/pub/CPAN
+                      ftp://ftp.cpan.skynet.be/pub/CPAN
                       ftp://ftp.kulnet.kuleuven.ac.be/pub/mirror/CPAN/
 
+=item Bosnia and Herzegovina
+
+                      http://cpan.blic.net/
+
 =item Bulgaria
 
+                      http://cpan.online.bg
+                      ftp://cpan.online.bg/cpan
+                      http://cpan.zadnik.org
+                      ftp://ftp.zadnik.org/mirrors/CPAN/
                       http://cpan.lirex.net/
                       ftp://ftp.lirex.net/pub/mirrors/CPAN
 
@@ -1636,7 +2109,6 @@ You should try to choose one close to you.
 
 =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/
 
@@ -1655,10 +2127,11 @@ You should try to choose one close to you.
 =item Finland
 
                       ftp://ftp.funet.fi/pub/languages/perl/CPAN/
-                      http://cpan.kpnqwest.fi/
+                      http://mirror.eunet.fi/CPAN
 
 =item France
 
+                      http://www.enstimac.fr/Perl/CPAN
                       http://ftp.u-paris10.fr/perl/CPAN
                       ftp://ftp.u-paris10.fr/perl/CPAN
                       http://cpan.mirrors.easynet.fr/
@@ -1670,15 +2143,16 @@ You should try to choose one close to you.
                       ftp://ftp.pasteur.fr/pub/computing/CPAN/
                       http://mir2.ovh.net/ftp.cpan.org
                       ftp://mir1.ovh.net/ftp.cpan.org
+                      http://ftp.crihan.fr/mirrors/ftp.cpan.org/
+                      ftp://ftp.crihan.fr/mirrors/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.rub.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
@@ -1695,14 +2169,12 @@ You should try to choose one close to you.
 
 =item Greece
 
-                      ftp://ftp.acn.gr/pub/lang/perl/CPAN
+                      ftp://ftp.acn.gr/pub/lang/perl
                       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/
 
@@ -1715,6 +2187,8 @@ You should try to choose one close to you.
 
                       http://cpan.indigo.ie/
                       ftp://cpan.indigo.ie/pub/CPAN/
+                      http://ftp.heanet.ie/mirrors/ftp.perl.org/pub/CPAN
+                      ftp://ftp.heanet.ie/mirrors/ftp.perl.org/pub/CPAN
                       http://sunsite.compapp.dcu.ie/pub/perl/
                       ftp://sunsite.compapp.dcu.ie/pub/perl/
 
@@ -1729,6 +2203,7 @@ You should try to choose one close to you.
                       ftp://ftp.unipi.it/pub/mirror/perl/CPAN/
                       ftp://cis.uniRoma2.it/CPAN/
                       ftp://ftp.edisontel.it/pub/CPAN_Mirror/
+                      http://cpan.flashnet.it/
                       ftp://ftp.flashnet.it/pub/CPAN/
 
 =item Latvia
@@ -1746,6 +2221,7 @@ You should try to choose one close to you.
                       ftp://ftp.nluug.nl/pub/languages/perl/CPAN/
                       http://cpan.cybercomm.nl/
                       ftp://mirror.cybercomm.nl/pub/CPAN
+                      ftp://mirror.vuurwerk.nl/pub/CPAN/
                       ftp://ftp.cpan.nl/pub/CPAN/
                       http://ftp.easynet.nl/mirror/CPAN
                       ftp://ftp.easynet.nl/mirror/CPAN
@@ -1759,8 +2235,7 @@ You should try to choose one close to you.
 
 =item Poland
 
-                      ftp://ftp.pk.edu.pl/pub/lang/perl/CPAN/
-                      ftp://ftp.mega.net.pl/pub/mirrors/ftp.perl.com/
+                      ftp://ftp.mega.net.pl/CPAN
                       ftp://ftp.man.torun.pl/pub/doc/CPAN/
                       ftp://sunsite.icm.edu.pl/pub/CPAN/
 
@@ -1770,16 +2245,24 @@ You should try to choose one close to you.
                       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/
+                      ftp://ftp.nfsi.pt/pub/CPAN
+                      http://ftp.linux.pt/pub/mirrors/CPAN
+                      ftp://ftp.linux.pt/pub/mirrors/CPAN
                       http://cpan.ip.pt/
                       ftp://cpan.ip.pt/pub/cpan/
-                      ftp://ftp.netc.pt/pub/CPAN/
-                      ftp://ftp.up.pt/pub/CPAN
+                      http://cpan.telepac.pt/
+                      ftp://ftp.telepac.pt/pub/cpan/
 
 =item Romania
 
+                      ftp://ftp.bio-net.ro/pub/CPAN
                       ftp://ftp.kappa.ro/pub/mirrors/ftp.perl.org/pub/CPAN/
+                      ftp://ftp.lug.ro/CPAN
+                      ftp://ftp.roedu.net/pub/CPAN/
                       ftp://ftp.dntis.ro/pub/cpan/
+                      ftp://ftp.iasi.roedu.net/pub/mirrors/ftp.cpan.org/
+                      http://cpan.ambra.ro/
+                      ftp://ftp.ambra.ro/pub/CPAN
                       ftp://ftp.dnttm.ro/pub/CPAN/
                       ftp://ftp.lasting.ro/pub/CPAN
                       ftp://ftp.timisoara.roedu.net/mirrors/CPAN/
@@ -1790,12 +2273,12 @@ You should try to choose one close to you.
                       http://cpan.rinet.ru/
                       ftp://cpan.rinet.ru/pub/mirror/CPAN/
                       ftp://ftp.aha.ru/pub/CPAN/
+                      ftp://ftp.corbina.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
@@ -1806,17 +2289,21 @@ You should try to choose one close to you.
 
                       http://cpan.imasd.elmundo.es/
                       ftp://ftp.rediris.es/mirror/CPAN/
+                      ftp://ftp.ri.telefonica-data.net/CPAN
                       ftp://ftp.etse.urv.es/pub/perl/
 
 =item Sweden
 
                       http://ftp.du.se/CPAN/
                       ftp://ftp.du.se/pub/CPAN/
+                      http://mirror.dataphone.se/CPAN
                       ftp://mirror.dataphone.se/pub/CPAN
                       ftp://ftp.sunet.se/pub/lang/perl/CPAN/
 
 =item Switzerland
 
+                      http://cpan.mirror.solnet.ch/
+                      ftp://ftp.solnet.ch/mirror/CPAN/
                       ftp://ftp.danyk.ch/CPAN/
                       ftp://sunsite.cnlab-switch.ch/mirror/CPAN/
 
@@ -1831,6 +2318,8 @@ You should try to choose one close to you.
                       http://cpan.org.ua/
                       ftp://cpan.org.ua/
                       ftp://ftp.perl.org.ua/pub/CPAN/
+                      http://no-more.kiev.ua/CPAN/
+                      ftp://no-more.kiev.ua/pub/CPAN/
 
 =item United Kingdom
 
@@ -1838,13 +2327,15 @@ You should try to choose one close to you.
                       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
+                      http://cpan.mirror.anlx.net/
+                      ftp://ftp.mirror.anlx.net/CPAN/
+                      http://cpan.etla.org/
+                      ftp://cpan.etla.org/pub/CPAN
                       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.hambule.co.uk/
                       http://cpan.mirrors.clockerz.net/
                       ftp://ftp.clockerz.net/pub/CPAN/
                       ftp://usit.shef.ac.uk/pub/packages/CPAN/
@@ -1855,10 +2346,14 @@ You should try to choose one close to you.
 
 =over 4
 
+=item Canada
+
+=over 8
+
 =item Alberta
 
-                      http://sunsite.ualberta.ca/pub/Mirror/CPAN/
-                      ftp://sunsite.ualberta.ca/pub/Mirror/CPAN/
+                      http://cpan.sunsite.ualberta.ca/
+                      ftp://cpan.sunsite.ualberta.ca/pub/CPAN/
 
 =item Manitoba
 
@@ -1871,26 +2366,22 @@ You should try to choose one close to you.
 
 =item Ontario
 
-                      ftp://ftp.crc.ca/pub/CPAN/
-
-=item Quebec
+                      ftp://ftp.nrc.ca/pub/CPAN/
 
-                      http://cpan.mirror.smartworker.org/
+=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.cpan.unam.mx/
+                      ftp://ftp.unam.mx/pub/CPAN
                       http://www.msg.com.mx/CPAN/
                       ftp://ftp.msg.com.mx/pub/CPAN/
 
-=back
-
-=head2 United States
+=item United States
 
-=over 4
+=over 8
 
 =item Alabama
 
@@ -1902,18 +2393,23 @@ You should try to choose one close to you.
                       http://cpan.develooper.com/
                       http://www.cpan.org/
                       ftp://cpan.valueclick.com/pub/CPAN/
+                      http://www.mednor.net/ftp/pub/mirrors/CPAN/
+                      ftp://ftp.mednor.net/pub/mirrors/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-sj.viaverio.com/
+                      ftp://cpan-sj.viaverio.com/pub/CPAN/
                       http://cpan.digisle.net/
                       ftp://cpan.digisle.net/pub/CPAN
                       http://www.perl.com/CPAN/
-                      http://download.sourceforge.net/mirrors/CPAN/
+                      http://www.uberlan.net/CPAN
 
 =item Colorado
 
                       ftp://ftp.cs.colorado.edu/pub/perl/CPAN/
+                      http://cpan.four10.com
 
 =item Delaware
 
@@ -1931,11 +2427,6 @@ You should try to choose one close to you.
                       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/
@@ -1943,7 +2434,8 @@ You should try to choose one close to you.
                       ftp://cpan.netnitco.net/pub/mirrors/CPAN/
                       http://archive.progeny.com/CPAN/
                       ftp://archive.progeny.com/CPAN/
-                      ftp://cpan.in-span.net/
+                      http://fx.saintjoe.edu/pub/CPAN
+                      ftp://ftp.saintjoe.edu/pub/CPAN
                       http://csociety-ftp.ecn.purdue.edu/pub/CPAN
                       ftp://csociety-ftp.ecn.purdue.edu/pub/CPAN
 
@@ -1951,41 +2443,50 @@ You should try to choose one close to you.
 
                       http://cpan.uky.edu/
                       ftp://cpan.uky.edu/pub/CPAN/
+                      http://slugsite.louisville.edu/cpan
+                      ftp://slugsite.louisville.edu/CPAN
 
 =item Massachusetts
 
+                      http://mirrors.towardex.com/CPAN
+                      ftp://mirrors.towardex.com/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 Michigan
 
                       ftp://cpan.cse.msu.edu/
+                      http://cpan.calvin.edu/pub/CPAN
+                      ftp://cpan.calvin.edu/pub/CPAN
+
+=item Nevada
+
+                      http://www.oss.redundant.com/pub/CPAN
+                      ftp://www.oss.redundant.com/pub/CPAN
 
 =item New Jersey
 
+                      http://ftp.cpanel.net/pub/CPAN/
                       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.erlbaum.net/
+                      ftp://cpan.erlbaum.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
 
+                      http://www.ibiblio.org/pub/languages/perl/CPAN
+                      ftp://ftp.ibiblio.org/pub/languages/perl/CPAN
                       ftp://ftp.duke.edu/pub/perl/
-
-=item Ohio
-
-                      ftp://ftp.loaded.net/pub/CPAN/
+                      ftp://ftp.ncsu.edu/pub/mirror/CPAN/
 
 =item Oklahoma
 
@@ -2012,7 +2513,9 @@ You should try to choose one close to you.
 =item Texas
 
                       http://ftp.sedl.org/pub/mirrors/CPAN/
+                      http://www.binarycode.org/cpan
                       ftp://mirror.telentente.com/pub/CPAN
+                      http://mirrors.theonlinerecordstore.com/CPAN
 
 =item Utah
 
@@ -2020,16 +2523,15 @@ You should try to choose one close to you.
 
 =item Virginia
 
+                      http://cpan-du.viaverio.com/
+                      ftp://cpan-du.viaverio.com/pub/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/
+                      http://noc.cvaix.com/mirrors/CPAN/
 
-=item ashington
+=item Washington
 
                       http://cpan.llarian.net/
                       ftp://cpan.llarian.net/pub/CPAN/
@@ -2041,6 +2543,10 @@ You should try to choose one close to you.
 
                       http://mirror.sit.wisc.edu/pub/CPAN/
                       ftp://mirror.sit.wisc.edu/pub/CPAN/
+                      http://mirror.aphix.com/CPAN
+                      ftp://mirror.aphix.com/pub/CPAN
+
+=back
 
 =back
 
@@ -2054,11 +2560,16 @@ You should try to choose one close to you.
                       ftp://ftp.planetmirror.com/pub/CPAN/
                       ftp://mirror.aarnet.edu.au/pub/perl/CPAN/
                       ftp://cpan.topend.com.au/pub/CPAN/
+                      http://cpan.mirrors.ilisys.com.au
 
 =item New Zealand
 
                       ftp://ftp.auckland.ac.nz/pub/perl/CPAN/
-                      http://cpan.soa.co.nz/CPAN/
+
+=item United States
+
+                      http://aniani.ifa.hawaii.edu/CPAN/
+                      ftp://aniani.ifa.hawaii.edu/CPAN/
 
 =back
 
@@ -2069,13 +2580,15 @@ You should try to choose one close to you.
 =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/
+                      http://www.linux.org.ar/mirrors/cpan
+                      ftp://ftp.linux.org.ar/mirrors/cpan
 
 =item Brazil
 
                       ftp://cpan.pop-mg.com.br/pub/CPAN/
                       ftp://ftp.matrix.com.br/pub/perl/CPAN/
+                      http://cpan.hostsul.com.br/
+                      ftp://cpan.hostsul.com.br/
 
 =item Chile
 
@@ -2086,29 +2599,43 @@ You should try to choose one close to you.
 
 =head2 RSYNC Mirrors
 
-                      ftp.fcaglp.unlp.edu.ar::CPAN
-                      cpan.mirror.smartworker.org::CPAN
+                      www.linux.org.ar::cpan
                       theoryx5.uwinnipeg.ca::CPAN
                       ftp.shellhung.org::CPAN
-                      ftp.funet.fi::CPAN
+                      rsync.nic.funet.fi::CPAN
                       ftp.u-paris10.fr::CPAN
                       mir1.ovh.net::CPAN
+                      rsync://ftp.crihan.fr::CPAN
                       ftp.gwdg.de::FTP/languages/perl/CPAN/
                       ftp.leo.org::CPAN
-                      CPAN.piksi.itb.ac.id::CPAN
                       ftp.cbn.net.id::CPAN
+                      rsync://ftp.heanet.ie/mirrors/ftp.perl.org/pub/CPAN
                       ftp.iglu.org.il::CPAN
                       gusp.dyndns.org::cpan
                       ftp.kddlabs.co.jp::cpan
                       ftp.ayamura.org::pub/CPAN/
+                      mirror.leafbug.org::CPAN
+                      rsync.en.com.sg::CPAN
                       mirror.averse.net::cpan
+                      rsync.oss.eznetsols.org
+                      ftp.kr.FreeBSD.org::CPAN
+                      ftp.solnet.ch::CPAN
+                      cpan.cdpa.nsysu.edu.tw::CPAN
                       cpan.teleglobe.net::CPAN
+                      rsync://rsync.mirror.anlx.net::CPAN
                       ftp.sedl.org::cpan
+                      ibiblio.org::CPAN
+                      cpan-du.viaverio.com::CPAN
+                      aniani.ifa.hawaii.edu::CPAN
                       archive.progeny.com::CPAN
+                      rsync://slugsite.louisville.edu::CPAN
+                      mirror.aphix.com::CPAN
                       cpan.teleglobe.net::CPAN
                       ftp.lug.udel.edu::cpan
                       mirrors.kernel.org::mirrors/CPAN
                       mirrors.phenominet.com::CPAN
+                      cpan.pair.com::CPAN
+                      cpan-sj.viaverio.com::CPAN
                       mirror.csit.fsu.edu::CPAN
                       csociety-ftp.ecn.purdue.edu::CPAN
 
@@ -2396,9 +2923,10 @@ How you choose to license your work is a personal decision.
 The general mechanism is to assert your Copyright and then make
 a declaration of how others may copy/use/modify your work.
 
-Perl, for example, is supplied with two types of licence: The GNU
-GPL and The Artistic Licence (see the files README, Copying, and
-Artistic).  Larry has good reasons for NOT just using the GNU GPL.
+Perl, for example, is supplied with two types of licence: The GNU GPL
+and The Artistic Licence (see the files README, Copying, and Artistic,
+or L<perlgpl> and L<perlartistic>).  Larry has good reasons for NOT
+just using the GNU GPL.
 
 My personal recommendation, out of respect for Larry, Perl, and the
 Perl community at large is to state something simply like: