X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlmodlib.pod;h=c0a447ee77a12985d859d2a0862ea5d316dd076b;hb=91a462243ea69db634187747c3ddad662e832e86;hp=86fac4b4c96f7dcac0ae0fff36261fe1d37f38cb;hpb=a4373870b404ad399ffc74d3c253b331a8999454;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perlmodlib.pod b/pod/perlmodlib.pod index 86fac4b..c0a447e 100644 --- a/pod/perlmodlib.pod +++ b/pod/perlmodlib.pod @@ -47,14 +47,6 @@ The following pragmas are defined (and have their own documentation). =over 12 -=item assertions - -Selects assertions - -=item assertions::activate - -Assertions activation - =item attributes Get/set subroutine or variable attributes @@ -69,7 +61,7 @@ Postpone load of modules until a function is used =item base -Establish IS-A relationship with base class at compile time +Establish an ISA relationship with base classes at compile time =item bigint @@ -81,7 +73,7 @@ Transparent BigNumber support for Perl =item bigrat -Transparent BigNumber/BigRationale support for Perl +Transparent BigNumber/BigRational support for Perl =item blib @@ -101,12 +93,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 @@ -125,7 +125,7 @@ Use integer arithmetic instead of floating point =item less -Request less of something from the compiler +Request less of something =item lib @@ -135,6 +135,10 @@ Manipulate @INC at compile time Use and avoid POSIX locales for built-in operations +=item mro + +Method Resolution Order + =item open Set default PerlIO layers for input and output @@ -145,7 +149,11 @@ Restrict unsafe operations when compiling =item overload -Package for overloading perl operations +Package for overloading Perl operations + +=item parent + +Establish an ISA relationship with base classes at compile time =item re @@ -169,7 +177,7 @@ Predeclare sub names =item threads -Perl extension allowing use of interpreter based threads from perl +Perl interpreter-based threads =item threads::shared @@ -217,45 +225,41 @@ don't have the gdbm library. Provide framework for multiple DBMs -=item Attribute::Handlers - -Simpler definition of attribute handlers +=item App::Prove -=item AutoLoader - -Load subroutines only on demand +Implements the C command. -=item AutoSplit +=item App::Prove::State -Split a package for autoloading +State storage for the C command. -=item B +=item Archive::Extract -The Perl Compiler +A generic archive extracting mechanism -=item B::Asmdata +=item Archive::Tar -Autogenerated data about Perl ops, used to generate bytecode +Module for manipulations of tar archives -=item B::Assembler +=item Archive::Tar::File -Assemble Perl bytecode +A subclass for in-memory extracted file from Archive::Tar -=item B::Bblock +=item Attribute::Handlers -Walk basic blocks +Simpler definition of attribute handlers -=item B::Bytecode +=item AutoLoader -Perl compiler's bytecode backend +Load subroutines only on demand -=item B::C +=item AutoSplit -Perl compiler's C backend +Split a package for autoloading -=item B::CC +=item B -Perl compiler's optimized C translation backend +The Perl Compiler =item B::Concise @@ -269,25 +273,17 @@ Walk Perl syntax tree, printing debug info about ops 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 +=item B::Lint::Debug -Helper module for CC backend +Adds debugging stringification to B:: -=item B::Stash +=item B::Showlex -Show what stashes are loaded +Show lexical variables used in functions or files =item B::Terse @@ -301,10 +297,6 @@ Generates cross reference reports for Perl programs Benchmark running times of Perl code -=item ByteLoader - -Load byte compiled perl code - =item CGI Simple Common Gateway Interface Class @@ -341,25 +333,61 @@ Backward compatibility module for defunct CGI::Switch Internal utilities used by CGI module +=item CORE + +Pseudo-namespace for Perl's core routines + =item CPAN Query, download and build perl modules from CPAN sites +=item CPAN::API::HOWTO + +A recipe book for programming with CPAN.pm + =item CPAN::FirstTime Utility for CPAN::Config file Initialization +=item CPAN::Kwalify + +Interface between CPAN.pm and Kwalify.pm + =item CPAN::Nox Wrapper around CPAN.pm without using any XS module +=item CPAN::Version + +Utility functions to compare CPAN versions + +=item CPANPLUS + +API & CLI access to the CPAN mirrors + +=item CPANPLUS::Dist::Base + +Base class for custom distribution classes + +=item CPANPLUS::Dist::Sample + +Sample code to create your own Dist::* plugin + +=item CPANPLUS::Shell::Classic + +CPAN.pm emulation for CPANPLUS + +=item CPANPLUS::Shell::Default::Plugins::HOWTO + +Documentation on how to write your own plugins + =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 @@ -369,6 +397,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 @@ -379,7 +415,31 @@ Get pathname of current working directory =item DB -Programmatic interface to the Perl debugging API (draft, subject to +Programmatic interface to the Perl debugging API + +=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 @@ -393,9 +453,9 @@ Stringified perl data structures, suitable for both printing and C A Perl code profiler -=item Devel::PPPort +=item Devel::InnerPackage -Perl/Pollution/Portability +Find all the inner packages of a package =item Devel::Peek @@ -413,6 +473,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 @@ -465,6 +537,10 @@ Object Oriented Encoder Encode Implementation Base Class +=item Encode::GSM0338 + +ESTI GSM 03.38 Encoding + =item Encode::Guess Guesses encoding from data @@ -493,6 +569,10 @@ Internally used by Encode::KR MIME 'B' and 'Q' header encoding +=item Encode::MIME::Name + +Internally used by Encode + =item Encode::PerlIO A detailed document on Encode and PerlIO @@ -513,6 +593,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 @@ -533,6 +617,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. @@ -545,6 +637,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 @@ -565,9 +669,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 @@ -581,9 +689,13 @@ Methods to override UN*X behaviour in ExtUtils::MakeMaker DOS specific subclass of ExtUtils::MM_Unix +=item ExtUtils::MM_Darwin + +Special behaviors for OS X + =item ExtUtils::MM_MacOS -Methods to override UN*X behaviour in ExtUtils::MakeMaker +Once produced Makefiles for MacOS Classic =item ExtUtils::MM_NW5 @@ -593,6 +705,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 @@ -605,6 +721,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 @@ -621,6 +741,10 @@ ExtUtils::MakeMaker subclass for customization Create a module Makefile +=item ExtUtils::MakeMaker::Config + +Wrapper around Config.pm + =item ExtUtils::MakeMaker::FAQ Frequently Asked Questions About MakeMaker @@ -629,9 +753,13 @@ Frequently Asked Questions About MakeMaker Writing a module with MakeMaker +=item ExtUtils::MakeMaker::bytes + +Version-agnostic bytes.pm + =item ExtUtils::MakeMaker::vmsish -Platform agnostic vmsish.pm +Platform-agnostic vmsish.pm =item ExtUtils::Manifest @@ -649,6 +777,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 @@ -663,7 +795,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 @@ -681,6 +813,10 @@ Copy files or filehandles DOS like globbing and then some +=item File::Fetch + +A generic file fetching mechanism + =item File::Find Traverse a directory tree. @@ -689,6 +825,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 @@ -773,6 +913,10 @@ Process single-character switches with switch clustering A selection of general-utility hash subroutines +=item Hash::Util::FieldHash + +Support for Inside-Out Classes + =item I18N::Collate Compare 8-bit scalar data according to the current locale @@ -781,6 +925,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 @@ -793,6 +941,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 @@ -833,6 +1001,46 @@ 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 + +=item IPC::Cmd + +Finding and running system commands made easy + +=item IPC::Msg + +SysV Msg IPC object class + =item IPC::Open2 Open a process for both reading and writing @@ -841,17 +1049,17 @@ Open a process for both reading and writing Open a process for reading, writing, and error handling -=item IPC::SysV +=item IPC::Semaphore -SysV IPC constants +SysV Semaphore IPC object class -=item IPC::SysV::Msg +=item IPC::SharedMem -SysV Msg IPC object class +SysV Shared Memory IPC object class -=item IPC::SysV::Semaphore +=item IPC::SysV -SysV Semaphore IPC object class +System V IPC constants and system calls =item List::Util @@ -877,6 +1085,10 @@ ISO two letter codes for language identification (ISO 639) Framework for localization +=item Locale::Maketext::Simple + +Simple interface to Locale::Maketext::Lexicon + =item Locale::Maketext::TPJ13 Article about software localization @@ -885,11 +1097,27 @@ Article about software localization ISO codes for script identification (ISO 15924) +=item Log::Message + +A generic message storing mechanism; + +=item Log::Message::Config + +Configuration options for Log::Message + +=item Log::Message::Handlers + +Message handlers for Log::Message + +=item Log::Message::Item + +Message objects for Log::Message + =item MIME::Base64 Encoding and decoding of base64 strings -=item MIME::Base64::QuotedPrint +=item MIME::QuotedPrint Encoding and decoding of quoted-printable strings @@ -899,19 +1127,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 -Pure Perl module to test Math::BigInt with scalars +Emulate low-level math with BigInt code + +=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 @@ -953,13 +1185,137 @@ 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::Load::Conditional + +Looking up module information / loading at runtime + +=item Module::Loaded + +Mark modules as loaded or unloaded + +=item Module::Pluggable + +Automatically give your module the ability to have plugins + +=item Module::Pluggable::Object + +Automatically give your module the ability to have plugins + =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 @@ -1037,6 +1393,14 @@ 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 Params::Check + +A generic input parsing/checking mechanism. + =item PerlIO On demand loader for PerlIO layers and root of PerlIO::* name space @@ -1047,7 +1411,7 @@ Encoding layer =item PerlIO::scalar -Support module for in-memory IO. +In-memory IO, scalar IO =item PerlIO::via @@ -1061,6 +1425,10 @@ PerlIO layer for quoted-printable strings Check pod documents for syntax errors +=item Pod::Escapes + +For resolving Pod EE...E sequences + =item Pod::Find Find POD documents in directory trees @@ -1141,6 +1509,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 @@ -1213,6 +1665,122 @@ Try every conceivable way to get hostname Perl interface to the UNIX syslog(3) calls +=item Sys::Syslog::win32::Win32 + +Win32 support for Sys::Syslog + +=item TAP::Base + +Base class that provides common functionality to L and L + +=item TAP::Formatter::Color + +Run Perl test scripts with color + +=item TAP::Formatter::Console + +Harness output delegate for default console output + +=item TAP::Formatter::Console::ParallelSession + +Harness output delegate for parallel console output + +=item TAP::Formatter::Console::Session + +Harness output delegate for default console output + +=item TAP::Harness + +Run test scripts with statistics + +=item TAP::Parser + +Parse L output + +=item TAP::Parser::Aggregator + +Aggregate TAP::Parser results + +=item TAP::Parser::Grammar + +A grammar for the Test Anything Protocol. + +=item TAP::Parser::Iterator + +Internal TAP::Parser Iterator + +=item TAP::Parser::Iterator::Array + +Internal TAP::Parser Iterator + +=item TAP::Parser::Iterator::Process + +Internal TAP::Parser Iterator + +=item TAP::Parser::Iterator::Stream + +Internal TAP::Parser Iterator + +=item TAP::Parser::Multiplexer + +Multiplex multiple TAP::Parsers + +=item TAP::Parser::Result + +TAP::Parser output + +=item TAP::Parser::Result::Bailout + +Bailout result token. + +=item TAP::Parser::Result::Comment + +Comment result token. + +=item TAP::Parser::Result::Plan + +Plan result token. + +=item TAP::Parser::Result::Pragma + +TAP pragma token. + +=item TAP::Parser::Result::Test + +Test result token. + +=item TAP::Parser::Result::Unknown + +Unknown result token. + +=item TAP::Parser::Result::Version + +TAP syntax version token. + +=item TAP::Parser::Result::YAML + +YAML result token. + +=item TAP::Parser::Source + +Stream output from some source + +=item TAP::Parser::Source::Perl + +Stream Perl output + +=item TAP::Parser::Utils + +Internal TAP::Parser utilities + +=item TAP::Parser::YAMLish::Reader + +Read YAMLish data from iterator + +=item TAP::Parser::YAMLish::Writer + +Write YAMLish data + =item Term::ANSIColor Color screen output using ANSI escape sequences @@ -1229,6 +1797,10 @@ Perl word completion module Perl interface to various C packages. +=item Term::UI + +Term::ReadLine UI made easy + =item Test Provides a simple framework for writing test scripts @@ -1237,21 +1809,21 @@ Provides a simple framework for writing test scripts Backend for building test libraries -=item Test::Harness +=item Test::Builder::Module -Run perl standard test scripts with statistics +Base class for test modules -=item Test::Harness::Assert +=item Test::Builder::Tester -Simple assert +Test testsuites that have been built with -=item Test::Harness::Iterator +=item Test::Builder::Tester::Color -Internal Test::Harness Iterator +Turn on colour in Test::Builder::Tester -=item Test::Harness::Straps +=item Test::Harness -Detailed analysis of test results +Run Perl standard test scripts with statistics =item Test::More @@ -1279,7 +1851,7 @@ Parse text into an array of tokens or array of arrays =item Text::Soundex -Implementation of the Soundex Algorithm as Described by Knuth +Implementation of the soundex algorithm. =item Text::Tabs @@ -1301,14 +1873,6 @@ Thread-safe queues Thread-safe semaphores -=item Thread::Signal - -Start a thread which runs signal handlers reliably (for old code) - -=item Thread::Specific - -Thread-specific keys - =item Tie::Array Base class for tied arrays @@ -1325,6 +1889,10 @@ Base class definitions for tied handles Base class definitions for tied hashes +=item Tie::Hash::NamedCapture + +Named regexp capture buffers + =item Tie::Memoize Add data to hash when needed @@ -1349,6 +1917,14 @@ High resolution alarm, sleep, gettimeofday, interval timers Efficiently compute time from local and GMT time +=item Time::Piece + +Object Oriented time objects + +=item Time::Piece::Seconds + +A simple API to convert seconds to other date values + =item Time::gmtime By-name interface to Perl's built-in gmtime() function @@ -1389,6 +1965,14 @@ By-name interface to Perl's built-in getpw*() functions Interfaces to some Win32 API Functions +=item Win32API::File + +Low-level access to Win32 system API calls for files/dirs. + +=item Win32CORE + +Win32 CORE function stubs + =item XS::APItest Test the perl C API @@ -1564,8 +2148,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/ @@ -1577,28 +2162,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/ @@ -1608,27 +2184,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 @@ -1636,24 +2208,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/ @@ -1671,7 +2246,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/ @@ -1683,6 +2257,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 @@ -1690,11 +2266,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 @@ -1705,7 +2289,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/ @@ -1724,10 +2307,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/ @@ -1739,15 +2323,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 @@ -1764,14 +2349,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/ @@ -1784,6 +2367,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/ @@ -1798,6 +2383,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 @@ -1815,6 +2401,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 @@ -1828,8 +2415,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/ @@ -1839,16 +2425,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/ @@ -1859,12 +2453,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 @@ -1875,17 +2469,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/ @@ -1900,6 +2498,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 @@ -1907,13 +2507,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/ @@ -1924,10 +2526,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 @@ -1940,26 +2546,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 +=item United States -=head2 United States - -=over 4 +=over 8 =item Alabama @@ -1971,18 +2573,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 @@ -2000,11 +2607,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/ @@ -2012,7 +2614,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 @@ -2020,41 +2623,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 @@ -2081,7 +2693,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 @@ -2089,16 +2703,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/ @@ -2110,6 +2723,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 @@ -2123,11 +2740,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 @@ -2138,13 +2760,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 @@ -2155,29 +2779,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 @@ -2274,8 +2912,8 @@ the module after __END__ either using AutoSplit or by saying: Does your module pass the 'empty subclass' test? If you say C<@SUBCLASS::ISA = qw(YOURCLASS);> your applications should be able to use SUBCLASS in exactly the same way as YOURCLASS. For example, -does your application still work if you change: C<$obj = new YOURCLASS;> -into: C<$obj = new SUBCLASS;> ? +does your application still work if you change: C<< $obj = YOURCLASS->new(); >> +into: C<< $obj = SUBCLASS->new(); >> ? Avoid keeping any state information in your packages. It makes it difficult for multiple other packages to use yours. Keep state @@ -2465,9 +3103,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 and L). 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: