X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlmodlib.pod;h=223b7df1e8cd55b8e51e765ff89c047757f54374;hb=53ae2428795d0b9d42a1657c22c5f1b557784379;hp=20fffc834677b8cdde357b791ebb4e986e770de7;hpb=556e28cf79d79a34ad04435dccb8be1321f3a6c9;p=p5sagit%2Fp5-mst-13.2.git diff --git a/pod/perlmodlib.pod b/pod/perlmodlib.pod index 20fffc8..223b7df 100644 --- a/pod/perlmodlib.pod +++ b/pod/perlmodlib.pod @@ -5,13 +5,11 @@ Generated by perlmodlib.PL -- DO NOT EDIT! perlmodlib - constructing new Perl modules and finding existing ones -=head1 DESCRIPTION - =head1 THE PERL MODULE LIBRARY -Many modules are included the Perl distribution. These are described +Many modules are included in the Perl distribution. These are described below, and all end in F<.pm>. You may discover compiled library -file (usually ending in F<.so>) or small pieces of modules to be +files (usually ending in F<.so>) or small pieces of modules to be autoloaded (ending in F<.al>); these were automatically generated by the installation process. You may also discover files in the library directory that end in either F<.pl> or F<.ph>. These are @@ -49,21 +47,37 @@ 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 +=item attrs + +Set/get attributes of a subroutine (deprecated) + =item autouse 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 -Transparent big integer support for Perl +Transparent BigInteger support for Perl =item bignum @@ -83,7 +97,7 @@ Force byte semantics rather than character semantics =item charnames -Define character names for C<\N{named}> string literal escapes. +Define character names for C<\N{named}> string literal escapes =item constant @@ -91,11 +105,19 @@ Declare constants =item diagnostics -Perl compiler pragma to force verbose warning diagnostics +Produce verbose warning diagnostics =item encoding -Pragma to control the conversion of legacy data into Unicode +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 @@ -117,17 +139,25 @@ Use integer arithmetic instead of floating point Request less of something from the compiler +=item lib + +Manipulate @INC at compile time + =item locale Use and avoid POSIX locales for built-in operations =item open -Set default disciplines for input and output +Set default PerlIO layers for input and output + +=item ops + +Restrict unsafe operations when compiling =item overload -Package for overloading perl operations +Package for overloading Perl operations =item re @@ -149,6 +179,14 @@ Restrict unsafe constructs Predeclare sub names +=item threads + +Perl interpreter-based threads + +=item threads::shared + +Perl extension for sharing data structures between threads + =item utf8 Enable/disable UTF-8 (or UTF-EBCDIC) in source code @@ -157,6 +195,10 @@ Enable/disable UTF-8 (or UTF-EBCDIC) in source code Predeclare global variable names (obsolete) +=item version + +Perl extension for Version Objects + =item vmsish Control VMS-specific language features @@ -177,12 +219,24 @@ Standard, bundled modules are all expected to behave in a well-defined manner with respect to namespace pollution because they use the Exporter module. See their own documentation for details. +It's possible that not all modules listed below are installed on your +system. For example, the GDBM_File module will not be installed if you +don't have the gdbm library. + =over 12 =item AnyDBM_File Provide framework for multiple DBMs +=item 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 @@ -195,10 +249,82 @@ Load subroutines only on demand Split a package for autoloading +=item B + +The Perl Compiler + +=item B::Asmdata + +Autogenerated data about Perl ops, used to generate bytecode + +=item B::Assembler + +Assemble Perl bytecode + +=item B::Bblock + +Walk basic blocks + +=item B::Bytecode + +Perl compiler's bytecode backend + +=item B::C + +Perl compiler's C backend + +=item B::CC + +Perl compiler's optimized C translation backend + +=item B::Concise + +Walk Perl syntax tree, printing concise info about ops + +=item B::Debug + +Walk Perl syntax tree, printing debug info about ops + +=item B::Deparse + +Perl compiler backend to produce perl code + +=item B::Disassembler + +Disassemble Perl bytecode + +=item B::Lint + +Perl lint + +=item B::Showlex + +Show lexical variables used in functions or files + +=item B::Stackobj + +Helper module for CC backend + +=item B::Stash + +Show what stashes are loaded + +=item B::Terse + +Walk Perl syntax tree, printing terse info about ops + +=item B::Xref + +Generates cross reference reports for Perl programs + =item Benchmark Benchmark running times of Perl code +=item ByteLoader + +Load byte compiled perl code + =item CGI Simple Common Gateway Interface Class @@ -247,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 @@ -263,6 +393,18 @@ 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 + =item Cwd Get pathname of current working directory @@ -271,6 +413,46 @@ 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 + +=item Data::Dumper + +Stringified perl data structures, suitable for both printing and C + +=item Devel::DProf + +A Perl code profiler + +=item Devel::Peek + +A data debugging tool for the XS programmer + =item Devel::SelfStubber Generate stubs for a SelfLoading module @@ -279,6 +461,22 @@ Generate stubs for a SelfLoading module Modules that calculate message digests +=item Digest::MD5 + +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 @@ -287,6 +485,102 @@ Supply object methods for directory handles Provides screen dump of Perl data. +=item DynaLoader + +Dynamically load C libraries into Perl code + +=item Encode + +Character encodings + +=item Encode::Alias + +Alias definitions to encodings + +=item Encode::Byte + +Single Byte Encodings + +=item Encode::CJKConstants + +Internally used by Encode::??::ISO_2022_* + +=item Encode::CN + +China-based Chinese Encodings + +=item Encode::CN::HZ + +Internally used by Encode::CN + +=item Encode::Config + +Internally used by Encode + +=item Encode::EBCDIC + +EBCDIC Encodings + +=item Encode::Encoder + +Object Oriented Encoder + +=item Encode::Encoding + +Encode Implementation Base Class + +=item Encode::Guess + +Guesses encoding from data + +=item Encode::JP + +Japanese Encodings + +=item Encode::JP::H2Z + +Internally used by Encode::JP::2022_JP* + +=item Encode::JP::JIS7 + +Internally used by Encode::JP + +=item Encode::KR + +Korean Encodings + +=item Encode::KR::2022_KR + +Internally used by Encode::KR + +=item Encode::MIME::Header + +MIME 'B' and 'Q' header encoding + +=item Encode::PerlIO + +A detailed document on Encode and PerlIO + +=item Encode::Supported + +Encodings supported by Encode + +=item Encode::Symbol + +Symbol Encodings + +=item Encode::TW + +Taiwan-based Chinese Encodings + +=item Encode::Unicode + +Various Unicode Transformation Formats + +=item Encode::Unicode::UTF7 + +UTF-7 encoding + =item English Use nice English (or awk) names for ugly punctuation variables @@ -295,6 +589,10 @@ Use nice English (or awk) names for ugly punctuation variables Perl module that imports environment variables as scalars or arrays +=item Errno + +System errno constants + =item Exporter Implements default import method for modules @@ -303,14 +601,38 @@ 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. +=item ExtUtils::Command::MM + +Commands for the MM's to use in Makefiles + =item ExtUtils::Constant Generate XS code to import C header constants +=item ExtUtils::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 @@ -327,6 +649,18 @@ Inventory management of installed modules Determine libraries to use and how to use them +=item ExtUtils::MM + +OS adjusted ExtUtils::MakeMaker subclass + +=item ExtUtils::MM_AIX + +AIX specific subclass of ExtUtils::MM_Unix + +=item ExtUtils::MM_Any + +Platform-agnostic MM methods + =item ExtUtils::MM_BeOS Methods to override UN*X behaviour in ExtUtils::MakeMaker @@ -335,6 +669,14 @@ Methods to override UN*X behaviour in ExtUtils::MakeMaker Methods to override UN*X behaviour in ExtUtils::MakeMaker +=item ExtUtils::MM_DOS + +DOS specific subclass of ExtUtils::MM_Unix + +=item ExtUtils::MM_MacOS + +Once produced Makefiles for MacOS Classic + =item ExtUtils::MM_NW5 Methods to override UN*X behaviour in ExtUtils::MakeMaker @@ -343,6 +685,14 @@ 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 + =item ExtUtils::MM_Unix Methods used by ExtUtils::MakeMaker @@ -351,13 +701,45 @@ 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 +=item ExtUtils::MM_Win95 + +Method to customize MakeMaker for Win9X + +=item ExtUtils::MY + +ExtUtils::MakeMaker subclass for customization + =item ExtUtils::MakeMaker -Create an extension Makefile +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 @@ -375,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 @@ -383,9 +769,13 @@ Add blib/* directories to @INC Replace functions with equivalents which succeed or die +=item Fcntl + +Load the C Fcntl.h defines + =item File::Basename -Split a pathname into pieces +Parse file paths into directory, filename and suffix. =item File::CheckTree @@ -407,6 +797,14 @@ DOS like globbing and then some Traverse a directory tree. +=item File::Glob + +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 @@ -467,10 +865,18 @@ Supply object methods for filehandles Simplified source filtering +=item Filter::Util::Call + +Perl Source Filter Utility Module + =item FindBin Locate directory of original perl script +=item GDBM_File + +Perl5 access to the gdbm library. + =item Getopt::Long Extended processing of command line options @@ -483,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 @@ -491,109 +901,361 @@ 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 -=item IPC::Open2 +=item I18N::Langinfo -Open a process for both reading and writing +Query locale information -=item IPC::Open3 +=item IO -Open a process for reading, writing, and error handling +Load various IO modules -=item Locale::Constants +=item IO::Compress::Base -Constants for Locale codes +Base Class for IO::Compress modules -=item Locale::Country +=item IO::Compress::Deflate -ISO codes for country identification (ISO 3166) +Write RFC 1950 files/buffers -=item Locale::Currency +=item IO::Compress::Gzip -ISO three letter codes for currency identification (ISO 4217) +Write RFC 1952 files/buffers -=item Locale::Language +=item IO::Compress::RawDeflate -ISO two letter codes for language identification (ISO 639) +Write RFC 1951 files/buffers -=item Locale::Maketext +=item IO::Compress::Zip -Framework for localization +Write zip files/buffers -=item Locale::Maketext::TPJ13 +=item IO::Dir -Article about software localization +Supply object methods for directory handles -=item Locale::Script +=item IO::File -ISO codes for script identification (ISO 15924) +Supply object methods for filehandles -=item Math::BigFloat +=item IO::Handle -Arbitrary size floating point math package +Supply object methods for I/O handles -=item Math::BigInt +=item IO::Pipe -Arbitrary size integer math package +Supply object methods for pipes -=item Math::BigInt::Calc +=item IO::Poll -Pure Perl module to support Math::BigInt +Object interface to system poll call -=item Math::BigRat +=item IO::Seekable -Arbitrarily big rationals +Supply seek based methods for I/O objects -=item Math::Complex +=item IO::Select -Complex numbers and associated mathematical functions +OO interface to the select system call -=item Math::Trig +=item IO::Socket -Trigonometric functions +Object interface to socket communications -=item Memoize +=item IO::Socket::INET -Make your functions faster by trading space for time +Object interface for AF_INET domain sockets -=item Memoize::AnyDBM_File +=item IO::Socket::UNIX -Glue to provide EXISTS for AnyDBM_File for Storable use +Object interface for AF_UNIX domain sockets -=item Memoize::Expire +=item IO::Uncompress::AnyInflate -Plug-in module for automatic expiration of memoized values +Uncompress zlib-based (zip, gzip) file/buffer -=item Memoize::ExpireFile +=item IO::Uncompress::AnyUncompress -Test for Memoize expiration semantics +Uncompress gzip, zip, bzip2 or lzop file/buffer -=item Memoize::ExpireTest +=item IO::Uncompress::Base -Test for Memoize expiration semantics +Base Class for IO::Uncompress modules -=item Memoize::NDBM_File +=item IO::Uncompress::Gunzip -Glue to provide EXISTS for NDBM_File for Storable use +Read RFC 1952 files/buffers -=item Memoize::SDBM_File +=item IO::Uncompress::Inflate -Glue to provide EXISTS for SDBM_File for Storable use +Read RFC 1950 files/buffers -=item Memoize::Storable +=item IO::Uncompress::RawInflate -Store Memoized data in Storable database +Read RFC 1951 files/buffers -=item NEXT +=item IO::Uncompress::Unzip -Provide a pseudo-class NEXT that allows method redispatch +Read zip files/buffers -=item Net::Cmd +=item IO::Zlib -Network Command class (as used by FTP, SMTP etc) +IO:: style interface to L + +=item IPC::Open2 + +Open a process for both reading and writing + +=item IPC::Open3 + +Open a process for reading, writing, and error handling + +=item IPC::SysV + +SysV IPC constants + +=item IPC::SysV::Msg + +SysV Msg IPC object class + +=item IPC::SysV::Semaphore + +SysV Semaphore IPC object class + +=item List::Util + +A selection of general-utility list subroutines + +=item Locale::Constants + +Constants for Locale codes + +=item Locale::Country + +ISO codes for country identification (ISO 3166) + +=item Locale::Currency + +ISO three letter codes for currency identification (ISO 4217) + +=item Locale::Language + +ISO two letter codes for language identification (ISO 639) + +=item Locale::Maketext + +Framework for localization + +=item Locale::Maketext::TPJ13 + +Article about software localization + +=item Locale::Script + +ISO codes for script identification (ISO 15924) + +=item MIME::Base64 + +Encoding and decoding of base64 strings + +=item MIME::Base64::QuotedPrint + +Encoding and decoding of quoted-printable strings + +=item Math::BigFloat + +Arbitrary size floating point math package + +=item Math::BigInt + +Arbitrary size integer/float math package + +=item Math::BigInt::Calc + +Pure Perl module to support Math::BigInt + +=item Math::BigInt::CalcEmu + +Emulate low-level math with BigInt code + +=item Math::BigInt::FastCalc + +Math::BigInt::Calc with some XS for more speed + +=item Math::BigRat + +Arbitrary big rational numbers + +=item Math::Complex + +Complex numbers and associated mathematical functions + +=item Math::Trig + +Trigonometric functions + +=item Memoize + +Make functions faster by trading space for time + +=item Memoize::AnyDBM_File + +Glue to provide EXISTS for AnyDBM_File for Storable use + +=item Memoize::Expire + +Plug-in module for automatic expiration of memoized values + +=item Memoize::ExpireFile + +Test for Memoize expiration semantics + +=item Memoize::ExpireTest + +Test for Memoize expiration semantics + +=item Memoize::NDBM_File + +Glue to provide EXISTS for NDBM_File for Storable use + +=item Memoize::SDBM_File + +Glue to provide EXISTS for SDBM_File for Storable use + +=item Memoize::Storable + +Store Memoized data in Storable database + +=item 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 (et al) that allows method redispatch + +=item Net::Cmd + +Network Command class (as used by FTP, SMTP etc) =item Net::Config @@ -651,14 +1313,54 @@ By-name interface to Perl's built-in getproto*() functions By-name interface to Perl's built-in getserv*() functions +=item O + +Generic interface to Perl Compiler backends + +=item ODBM_File + +Tied access to odbm files + +=item Opcode + +Disable named opcodes when compiling perl code + +=item POSIX + +Perl interface to IEEE Std 1003.1 + +=item Package::Constants + +List all constants declared in a package + =item PerlIO On demand loader for PerlIO layers and root of PerlIO::* name space +=item PerlIO::encoding + +Encoding layer + +=item PerlIO::scalar + +In-memory IO, scalar IO + +=item PerlIO::via + +Helper class for PerlIO layers implemented in perl + +=item PerlIO::via::QuotedPrint + +PerlIO layer for quoted-printable strings + =item Pod::Checker Check pod documents for syntax errors +=item Pod::Escapes + +For resolving Pod EE...E sequences + =item Pod::Find Find POD documents in directory trees @@ -695,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. @@ -703,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 @@ -723,9 +1545,17 @@ Convert POD data to ASCII text with format escapes Print a usage message from embedded pod documentation -=item Pod::t::basic +=item SDBM_File + +Tied access to sdbm files -Test of various basic POD features in translators. +=item Safe + +Compile and execute code in restricted compartments + +=item Scalar::Util + +A selection of general-utility scalar subroutines =item Search::Dict @@ -743,6 +1573,14 @@ Load functions only on demand Run shell commands transparently within perl +=item Socket + +Load the C socket.h defines and structure manipulators + +=item Storable + +Persistence for Perl data structures + =item Switch A switch statement for Perl @@ -751,6 +1589,14 @@ A switch statement for Perl Manipulate Perl symbols and their names +=item Sys::Hostname + +Try every conceivable way to get hostname + +=item Sys::Syslog + +Perl interface to the UNIX syslog(3) calls + =item Term::ANSIColor Color screen output using ANSI escape sequences @@ -765,7 +1611,7 @@ Perl word completion module =item Term::ReadLine -Perl interface to various C packages. If +Perl interface to various C packages. =item Test @@ -775,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 @@ -787,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 @@ -829,7 +1699,23 @@ Line wrapping to form simple paragraphs =item Thread -Manipulate threads in Perl +Manipulate threads in Perl (for old code only) + +=item Thread::Queue + +Thread-safe queues + +=item Thread::Semaphore + +Thread-safe semaphores + +=item Thread::Signal + +Start a thread which runs signal handlers reliably (for old code) + +=item Thread::Specific + +Thread-specific keys =item Tie::Array @@ -863,6 +1749,10 @@ Base class definitions for tied scalars Fixed-table-size, fixed-key-length hashing +=item Time::HiRes + +High resolution alarm, sleep, gettimeofday, interval timers + =item Time::Local Efficiently compute time from local and GMT time @@ -885,7 +1775,11 @@ Base class for ALL classes (blessed references) =item Unicode::Collate -Use UCA (Unicode Collation Algorithm) +Unicode Collation Algorithm + +=item Unicode::Normalize + +Unicode Normalization Forms =item Unicode::UCD @@ -899,18 +1793,30 @@ By-name interface to Perl's built-in getgr*() functions By-name interface to Perl's built-in getpw*() functions -=item Win32 +=item XS::APItest + +Test the perl C API -Interfaces to some Win32 API Functions +=item XS::Typemap + +Module to test the XS typemaps distributed with perl + +=item XSLoader + +Dynamically load C libraries into Perl code =back To find out I 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 -e '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 program, you can use the Perl B program instead, which @@ -919,6 +1825,11 @@ have a B program but it doesn't find your modules, you'll have to fix your manpath. See L for details. If you have no system B command, you might try the B program. +Note also that the command C 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 @@ -931,7 +1842,7 @@ completely) due to their sizes, volatility, or simply lack of time for adequate testing and configuration across the multitude of platforms on which Perl was beta-tested. You are encouraged to look for them on CPAN (described below), or using web search engines -like Alta Vista or Deja News. +like Alta Vista or Google. =head1 CPAN @@ -939,7 +1850,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://www.cpan.org/. +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 @@ -1033,21 +1944,35 @@ 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.mweb.co.za/pub/mirrors/cpan/ - ftp://ftp.saix.net/pub/CPAN/ - ftp://ftp.sun.ac.za/CPAN/CPAN/ + 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.saix.net/pub/CPAN/ + ftp://ftp.sun.ac.za/CPAN/CPAN/ =back @@ -1055,113 +1980,83 @@ South Africa =over 4 -=item * - -China - - ftp://freesoft.cei.gov.cn/pub/languages/perl/CPAN/ - http://www2.linuxforum.net/mirror/CPAN/ - http://cpan.shellhung.org/ - ftp://ftp.shellhung.org/pub/CPAN - -=item * - -India - - http://cpan.in.freeos.com - ftp://cpan.in.freeos.com/pub/CPAN/ - -=item * - -Indonesia - - http://cpan.itb.web.id/ - ftp://mirrors.piksi.itb.ac.id/CPAN/ - http://CPAN.mweb.co.id/ - ftp://ftp.mweb.co.id/pub/languages/perl/CPAN/ - -=item * - -Israel - - http://www.iglu.org.il:/pub/CPAN/ - ftp://ftp.iglu.org.il/pub/CPAN/ - http://cpan.lerner.co.il/ - http://bioinfo.weizmann.ac.il/pub/software/perl/CPAN/ - ftp://bioinfo.weizmann.ac.il/pub/software/perl/CPAN/ - -=item * - -Japan +=item China - 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/ + http://cpan.linuxforum.net/ + http://cpan.shellhung.org/ + ftp://ftp.shellhung.org/pub/CPAN + ftp://mirrors.hknet.com/CPAN -=item * - -Korea - - http://mirror.Mazic.org/pub/CPAN - ftp://mirror.Mazic.org/pub/CPAN - -=item * - -Philippines +=item Indonesia - http://www.adzu.edu.ph/CPAN + http://mirrors.tf.itb.ac.id/cpan/ + http://cpan.cbn.net.id/ + ftp://ftp.cbn.net.id/mirror/CPAN -=item * +=item Israel -Russian Federation + 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://cpan.tomsk.ru - ftp://cpan.tomsk.ru/pub/CPAN +=item Japan -=item * + ftp://ftp.u-aizu.ac.jp/pub/CPAN + ftp://ftp.kddlabs.co.jp/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/ -Saudi Arabia +=item Malaysia - ftp://ftp.isu.net.sa/pub/CPAN/ + http://cpan.MyBSD.org.my + http://mirror.leafbug.org/pub/CPAN + http://ossig.mncc.com.my/mirror/pub/CPAN -=item * +=item Russian Federation -Singapore + http://cpan.tomsk.ru + ftp://cpan.tomsk.ru/ - http://cpan.hjc.edu.sg +=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/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://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 * +=item South Korea -Taiwan + http://CPAN.bora.net/ + ftp://ftp.bora.net/pub/CPAN/ + http://mirror.kr.FreeBSD.org/CPAN + ftp://ftp.kr.FreeBSD.org/pub/CPAN - ftp://ftp.ee.ncku.edu.tw/pub/perl/CPAN/ - ftp://ftp1.sinica.edu.tw/pub1/perl/CPAN/ - http://ftp.tku.edu.tw/pub/CPAN/ - ftp://ftp.tku.edu.tw/pub/CPAN/ +=item Taiwan -=item * + ftp://ftp.nctu.edu.tw/UNIX/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/ -Thailand +=item Thailand - 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 @@ -1169,13 +2064,10 @@ 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/ + http://ftp.ucr.ac.cr/Unix/CPAN/ + ftp://ftp.ucr.ac.cr/pub/Unix/CPAN/ =back @@ -1183,290 +2075,270 @@ Costa Rica =over 4 -=item * - -Austria - - ftp://ftp.tuwien.ac.at/pub/CPAN/ - -=item * - -Belgium - - http://ftp.easynet.be/pub/CPAN/ - ftp://ftp.easynet.be/pub/CPAN/ - http://cpan.skynet.be - ftp://ftp.skynet.be/pub/CPAN - ftp://ftp.kulnet.kuleuven.ac.be/pub/mirror/CPAN/ - -=item * - -Bulgaria - - http://cpan.lirex.net/ - ftp://ftp.lirex.net/pub/mirrors/CPAN - -=item * - -Croatia - - ftp://ftp.linux.hr/pub/CPAN/ - -=item * - -Czech Republic - - http://ftp.fi.muni.cz/pub/CPAN/ - ftp://ftp.fi.muni.cz/pub/CPAN/ - ftp://sunsite.mff.cuni.cz/MIRRORS/ftp.funet.fi/pub/languages/perl/CPAN/ - -=item * - -Denmark - - http://mirrors.sunsite.dk/cpan/ - ftp://sunsite.dk/mirrors/cpan/ - http://www.cpan.dk/CPAN/ - ftp://www.cpan.dk/ftp.cpan.org/CPAN/ - -=item * - -Estonia - - ftp://ftp.ut.ee/pub/languages/perl/CPAN/ - -=item * - -Finland - - ftp://ftp.funet.fi/pub/languages/perl/CPAN/ - http://cpan.kpnqwest.fi/ - -=item * - -France - - http://cpan.mirrors.easynet.fr/ - ftp://cpan.mirrors.easynet.fr/pub/ftp.cpan.org/ - ftp://ftp.club-internet.fr/pub/perl/CPAN/ - http://fr.cpan.org/ - ftp://ftp.lip6.fr/pub/perl/CPAN/ - ftp://ftp.oleane.net/pub/mirrors/CPAN/ - ftp://ftp.pasteur.fr/pub/computing/CPAN/ - http://cpan.cict.fr/ - ftp://cpan.cict.fr/pub/CPAN/ - ftp://ftp.uvsq.fr/pub/perl/CPAN/ - -=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://pandemonium.tiscali.de/pub/CPAN/ - ftp://pandemonium.tiscali.de/pub/CPAN/ - http://ftp.gwdg.de/pub/languages/perl/CPAN/ - ftp://ftp.gwdg.de/pub/languages/perl/CPAN/ - ftp://ftp.uni-hamburg.de/pub/soft/lang/perl/CPAN/ - ftp://ftp.leo.org/pub/CPAN/ - http://cpan.noris.de/ - ftp://cpan.noris.de/pub/CPAN/ - ftp://ftp.mpi-sb.mpg.de/pub/perl/CPAN/ - ftp://ftp.gmd.de/mirrors/CPAN/ - -=item * - -Greece - - ftp://ftp.acn.gr/pub/lang/perl/CPAN - ftp://ftp.forthnet.gr/pub/languages/perl/CPAN - ftp://ftp.ntua.gr/pub/lang/perl/ - -=item * - -Hungary - - http://cpan.artifact.hu/ - ftp://cpan.artifact.hu/CPAN/ - http://ftp.kfki.hu/packages/perl/CPAN/ - ftp://ftp.kfki.hu/pub/packages/perl/CPAN/ - -=item * - -Iceland +=item Austria - http://ftp.rhnet.is/pub/CPAN/ - ftp://ftp.rhnet.is/pub/CPAN/ + http://cpan.inode.at/ + ftp://cpan.inode.at + ftp://ftp.tuwien.ac.at/pub/CPAN/ -=item * - -Ireland - - http://cpan.indigo.ie/ - ftp://cpan.indigo.ie/pub/CPAN/ - http://sunsite.compapp.dcu.ie/pub/perl/ - ftp://sunsite.compapp.dcu.ie/pub/perl/ - -=item * - -Italy - - http://cpan.nettuno.it/ - http://gusp.dyndns.org/CPAN/ - ftp://gusp.dyndns.org/pub/CPAN - http://softcity.iol.it/cpan - ftp://softcity.iol.it/pub/cpan - ftp://ftp.unina.it/pub/Other/CPAN/CPAN/ - ftp://ftp.unipi.it/pub/mirror/perl/CPAN/ - ftp://cis.uniRoma2.it/CPAN/ - ftp://ftp.edisontel.it/pub/CPAN_Mirror/ - ftp://ftp.flashnet.it/pub/CPAN/ - -=item * - -Latvia - - http://kvin.lv/pub/CPAN/ - -=item * - -Lithuania - - ftp://ftp.unix.lt/pub/CPAN/ - -=item * - -Netherlands - - ftp://download.xs4all.nl/pub/mirror/CPAN/ - ftp://ftp.nl.uu.net/pub/CPAN/ - ftp://ftp.nluug.nl/pub/languages/perl/CPAN/ - ftp://ftp.cpan.nl/pub/CPAN/ - http://www.cs.uu.nl/mirror/CPAN/ - ftp://ftp.cs.uu.nl/mirror/CPAN/ - -=item * - -Norway - - ftp://ftp.uninett.no/pub/languages/perl/CPAN - ftp://ftp.uit.no/pub/languages/perl/cpan/ - -=item * +=item Belgium -Poland + http://ftp.easynet.be/pub/CPAN/ + ftp://ftp.easynet.be/pub/CPAN/ + http://cpan.skynet.be + ftp://ftp.cpan.skynet.be/pub/CPAN + ftp://ftp.kulnet.kuleuven.ac.be/pub/mirror/CPAN/ - 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 Bosnia and Herzegovina -=item * + http://cpan.blic.net/ -Portugal +=item Bulgaria - 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 + 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 -=item * +=item Croatia -Romania + http://ftp.linux.hr/pub/CPAN/ + ftp://ftp.linux.hr/pub/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 Czech Republic -=item * + ftp://ftp.fi.muni.cz/pub/CPAN/ + ftp://sunsite.mff.cuni.cz/MIRRORS/ftp.funet.fi/pub/languages/perl/CPAN/ -Russia +=item Denmark - 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/ + 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 -Slovakia + ftp://ftp.ut.ee/pub/languages/perl/CPAN/ - http://ftp.cvt.stuba.sk/pub/CPAN/ - ftp://ftp.cvt.stuba.sk/pub/CPAN/ +=item Finland -=item * + ftp://ftp.funet.fi/pub/languages/perl/CPAN/ + http://mirror.eunet.fi/CPAN -Slovenia +=item France - ftp://ftp.arnes.si/software/perl/CPAN/ + 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/ + 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.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 + ftp://cpan.cict.fr/pub/CPAN/ + ftp://ftp.uvsq.fr/pub/perl/CPAN/ -=item * +=item Germany -Spain + 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 + http://pandemonium.tiscali.de/pub/CPAN/ + ftp://pandemonium.tiscali.de/pub/CPAN/ + http://ftp.gwdg.de/pub/languages/perl/CPAN/ + ftp://ftp.gwdg.de/pub/languages/perl/CPAN/ + ftp://ftp.uni-hamburg.de/pub/soft/lang/perl/CPAN/ + ftp://ftp.leo.org/pub/CPAN/ + http://cpan.noris.de/ + ftp://cpan.noris.de/pub/CPAN/ + ftp://ftp.mpi-sb.mpg.de/pub/perl/CPAN/ + ftp://ftp.gmd.de/mirrors/CPAN/ + +=item Greece - http://cpan.imasd.elmundo.es/ - ftp://ftp.rediris.es/mirror/CPAN/ - ftp://ftp.etse.urv.es/pub/perl/ + 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://ftp.kfki.hu/packages/perl/CPAN/ + ftp://ftp.kfki.hu/pub/packages/perl/CPAN/ + +=item Iceland + + http://ftp.rhnet.is/pub/CPAN/ + ftp://ftp.rhnet.is/pub/CPAN/ + +=item Ireland + + http://cpan.indigo.ie/ + ftp://cpan.indigo.ie/pub/CPAN/ + http://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/ + +=item Italy + + http://cpan.nettuno.it/ + http://gusp.dyndns.org/CPAN/ + ftp://gusp.dyndns.org/pub/CPAN + http://softcity.iol.it/cpan + ftp://softcity.iol.it/pub/cpan + ftp://ftp.unina.it/pub/Other/CPAN/CPAN/ + ftp://ftp.unipi.it/pub/mirror/perl/CPAN/ + ftp://cis.uniRoma2.it/CPAN/ + ftp://ftp.edisontel.it/pub/CPAN_Mirror/ + http://cpan.flashnet.it/ + ftp://ftp.flashnet.it/pub/CPAN/ + +=item Latvia + + http://kvin.lv/pub/CPAN/ + +=item Lithuania + + ftp://ftp.unix.lt/pub/CPAN/ + +=item Netherlands + + ftp://download.xs4all.nl/pub/mirror/CPAN/ + ftp://ftp.nl.uu.net/pub/CPAN/ + ftp://ftp.nluug.nl/pub/languages/perl/CPAN/ + http://cpan.cybercomm.nl/ + ftp://mirror.cybercomm.nl/pub/CPAN + ftp://mirror.vuurwerk.nl/pub/CPAN/ + ftp://ftp.cpan.nl/pub/CPAN/ + http://ftp.easynet.nl/mirror/CPAN + ftp://ftp.easynet.nl/mirror/CPAN + http://archive.cs.uu.nl/mirror/CPAN/ + ftp://ftp.cs.uu.nl/mirror/CPAN/ + +=item Norway + + ftp://ftp.uninett.no/pub/languages/perl/CPAN + ftp://ftp.uit.no/pub/languages/perl/cpan/ + +=item Poland + + ftp://ftp.mega.net.pl/CPAN + 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.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/ + 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/ -=item * - -Sweden - - http://ftp.du.se/CPAN/ - ftp://ftp.du.se/pub/CPAN/ - ftp://mirror.dataphone.se/pub/CPAN - ftp://ftp.sunet.se/pub/lang/perl/CPAN/ - -=item * - -Switzerland - - ftp://ftp.danyk.ch/CPAN/ - ftp://sunsite.cnlab-switch.ch/mirror/CPAN/ - -=item * - -Turkey - - ftp://sunsite.bilkent.edu.tr/pub/languages/CPAN/ - -=item * - -Ukraine - - http://cpan.org.ua/ - ftp://cpan.org.ua/ - ftp://ftp.perl.org.ua/pub/CPAN/ - -=item * - -United Kingdom - - http://www.mirror.ac.uk/sites/ftp.funet.fi/pub/languages/perl/CPAN - ftp://ftp.mirror.ac.uk/sites/ftp.funet.fi/pub/languages/perl/CPAN/ - http://cpan.teleglobe.net/ - ftp://cpan.teleglobe.net/pub/CPAN - http://cpan.crazygreek.co.uk - ftp://ftp.demon.co.uk/pub/CPAN/ - 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/ +=item Russia + + ftp://ftp.chg.ru/pub/lang/perl/CPAN/ + http://cpan.rinet.ru/ + ftp://cpan.rinet.ru/pub/mirror/CPAN/ + ftp://ftp.aha.ru/pub/CPAN/ + ftp://ftp.corbina.ru/pub/CPAN/ + http://cpan.sai.msu.ru/ + ftp://ftp.sai.msu.su/pub/lang/perl/CPAN/ + +=item Slovakia + + ftp://ftp.cvt.stuba.sk/pub/CPAN/ + +=item Slovenia + + ftp://ftp.arnes.si/software/perl/CPAN/ + +=item Spain + + http://cpan.imasd.elmundo.es/ + ftp://ftp.rediris.es/mirror/CPAN/ + ftp://ftp.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/ + +=item Turkey + + http://ftp.ulak.net.tr/perl/CPAN/ + ftp://ftp.ulak.net.tr/perl/CPAN + ftp://sunsite.bilkent.edu.tr/pub/languages/CPAN/ + +=item Ukraine + + http://cpan.org.ua/ + ftp://cpan.org.ua/ + ftp://ftp.perl.org.ua/pub/CPAN/ + http://no-more.kiev.ua/CPAN/ + ftp://no-more.kiev.ua/pub/CPAN/ + +=item United Kingdom + + http://www.mirror.ac.uk/sites/ftp.funet.fi/pub/languages/perl/CPAN + ftp://ftp.mirror.ac.uk/sites/ftp.funet.fi/pub/languages/perl/CPAN/ + http://cpan.teleglobe.net/ + ftp://cpan.teleglobe.net/pub/CPAN + http://cpan.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://cpan.hambule.co.uk/ + http://cpan.mirrors.clockerz.net/ + ftp://ftp.clockerz.net/pub/CPAN/ + ftp://usit.shef.ac.uk/pub/packages/CPAN/ =back @@ -1474,258 +2346,207 @@ United Kingdom =over 4 -=item * - -Canada +=item Canada =over 8 -=item * - -Alberta - - http://sunsite.ualberta.ca/pub/Mirror/CPAN/ - ftp://sunsite.ualberta.ca/pub/Mirror/CPAN/ +=item Alberta -=item * + http://cpan.sunsite.ualberta.ca/ + ftp://cpan.sunsite.ualberta.ca/pub/CPAN/ -Manitoba +=item Manitoba - http://theoryx5.uwinnipeg.ca/pub/CPAN/ - ftp://theoryx5.uwinnipeg.ca/pub/CPAN/ + http://theoryx5.uwinnipeg.ca/pub/CPAN/ + ftp://theoryx5.uwinnipeg.ca/pub/CPAN/ -=item * +=item Nova Scotia -Nova Scotia - - ftp://cpan.chebucto.ns.ca/pub/CPAN/ - -=item * - -Ontario - - ftp://ftp.crc.ca/pub/CPAN/ - -=item * + ftp://cpan.chebucto.ns.ca/pub/CPAN/ -Quebec +=item Ontario - http://cpan.mirror.smartworker.org/ + ftp://ftp.nrc.ca/pub/CPAN/ =back -=item * - -Mexico +=item Mexico - http://cpan.azc.uam.mx - ftp://cpan.azc.uam.mx/mirrors/CPAN - http://cpan.unam.mx/ - ftp://cpan.unam.mx/pub/CPAN - http://www.msg.com.mx/CPAN/ - ftp://ftp.msg.com.mx/pub/CPAN/ - -=item * + http://cpan.azc.uam.mx + ftp://cpan.azc.uam.mx/mirrors/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/ -United States +=item United States =over 8 -=item * - -Alabama - - http://mirror.hiwaay.net/CPAN/ - ftp://mirror.hiwaay.net/CPAN/ - -=item * - -California - - http://www.cpan.org/ - ftp://cpan.valueclick.com/pub/CPAN/ - http://mirrors.gossamer-threads.com/CPAN - ftp://cpan.nas.nasa.gov/pub/perl/CPAN/ - http://mirrors.kernel.org/cpan/ - ftp://mirrors.kernel.org/pub/CPAN - http://cpan.digisle.net/ - ftp://cpan.digisle.net/pub/CPAN - http://www.perl.com/CPAN/ - http://download.sourceforge.net/mirrors/CPAN/ - -=item * - -Colorado - - ftp://ftp.cs.colorado.edu/pub/perl/CPAN/ - -=item * +=item Alabama -Delaware + http://mirror.hiwaay.net/CPAN/ + ftp://mirror.hiwaay.net/CPAN/ - http://ftp.lug.udel.edu/pub/CPAN - ftp://ftp.lug.udel.edu/pub/CPAN +=item California -=item * + 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://www.uberlan.net/CPAN -District of Columbia +=item Colorado - ftp://ftp.dc.aleron.net/pub/CPAN/ + ftp://ftp.cs.colorado.edu/pub/perl/CPAN/ + http://cpan.four10.com -=item * +=item Delaware -Florida + http://ftp.lug.udel.edu/pub/CPAN + ftp://ftp.lug.udel.edu/pub/CPAN - ftp://ftp.cise.ufl.edu/pub/mirrors/CPAN/ - http://mirror.csit.fsu.edu/pub/CPAN/ - ftp://mirror.csit.fsu.edu/pub/CPAN/ +=item District of Columbia -=item * + ftp://ftp.dc.aleron.net/pub/CPAN/ -Illinois +=item Florida - http://uiarchive.uiuc.edu/mirrors/ftp/cpan.cse.msu.edu/ - ftp://uiarchive.uiuc.edu/mirrors/ftp/cpan.cse.msu.edu/ + ftp://ftp.cise.ufl.edu/pub/mirrors/CPAN/ + http://mirror.csit.fsu.edu/pub/CPAN/ + ftp://mirror.csit.fsu.edu/pub/CPAN/ + http://cpan.mirrors.nks.net/ -=item * +=item Indiana -Indiana + ftp://ftp.uwsg.iu.edu/pub/perl/CPAN/ + http://cpan.netnitco.net/ + ftp://cpan.netnitco.net/pub/mirrors/CPAN/ + http://archive.progeny.com/CPAN/ + ftp://archive.progeny.com/CPAN/ + 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 - ftp://ftp.uwsg.iu.edu/pub/perl/CPAN/ - http://cpan.netnitco.net/ - ftp://cpan.netnitco.net/pub/mirrors/CPAN/ - http://archive.progeny.com/CPAN/ - ftp://archive.progeny.com/CPAN/ - ftp://cpan.in-span.net/ - http://csociety-ftp.ecn.purdue.edu/pub/CPAN - ftp://csociety-ftp.ecn.purdue.edu/pub/CPAN +=item Kentucky -=item * + http://cpan.uky.edu/ + ftp://cpan.uky.edu/pub/CPAN/ + http://slugsite.louisville.edu/cpan + ftp://slugsite.louisville.edu/CPAN -Kentucky +=item Massachusetts - http://cpan.uky.edu/ - ftp://cpan.uky.edu/pub/CPAN/ + 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/ -=item * +=item Michigan -Massachusetts + ftp://cpan.cse.msu.edu/ + http://cpan.calvin.edu/pub/CPAN + ftp://cpan.calvin.edu/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 Nevada -=item * + http://www.oss.redundant.com/pub/CPAN + ftp://www.oss.redundant.com/pub/CPAN -Michigan +=item New Jersey - ftp://cpan.cse.msu.edu/ + http://ftp.cpanel.net/pub/CPAN/ + ftp://ftp.cpanel.net/pub/CPAN/ + http://cpan.teleglobe.net/ + ftp://cpan.teleglobe.net/pub/CPAN -=item * +=item New York -New Jersey + 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://ftp.cpanel.net/pub/CPAN/ - http://cpan.teleglobe.net/ - ftp://cpan.teleglobe.net/pub/CPAN +=item North Carolina -=item * + http://www.ibiblio.org/pub/languages/perl/CPAN + ftp://ftp.ibiblio.org/pub/languages/perl/CPAN + ftp://ftp.duke.edu/pub/perl/ + ftp://ftp.ncsu.edu/pub/mirror/CPAN/ -New York +=item Oklahoma - 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/ + ftp://ftp.ou.edu/mirrors/CPAN/ -=item * +=item Oregon -North Carolina + ftp://ftp.orst.edu/pub/CPAN - ftp://ftp.duke.edu/pub/perl/ +=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/ -Ohio +=item Tennessee - ftp://ftp.loaded.net/pub/CPAN/ + ftp://ftp.sunsite.utk.edu/pub/CPAN/ -=item * +=item Texas -Oklahoma + http://ftp.sedl.org/pub/mirrors/CPAN/ + http://www.binarycode.org/cpan + ftp://mirror.telentente.com/pub/CPAN + http://mirrors.theonlinerecordstore.com/CPAN - ftp://ftp.ou.edu/mirrors/CPAN/ +=item Utah -=item * + ftp://mirror.xmission.com/CPAN/ -Oregon +=item Virginia - ftp://ftp.orst.edu/pub/CPAN + 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://noc.cvaix.com/mirrors/CPAN/ -=item * +=item Washington -Pennsylvania + 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/ - http://ftp.epix.net/CPAN/ - ftp://ftp.epix.net/pub/languages/perl/ - http://mirrors.phenominet.com/pub/CPAN/ - ftp://mirrors.phenominet.com/pub/CPAN/ - http://cpan.pair.com/ - ftp://cpan.pair.com/pub/CPAN/ - ftp://carroll.cac.psu.edu/pub/CPAN/ +=item Wisconsin -=item * + 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 -Tennessee - - ftp://ftp.sunsite.utk.edu/pub/CPAN/ - -=item * - -Texas - - http://ftp.sedl.org/pub/mirrors/CPAN/ - ftp://mirror.telentente.com/pub/CPAN - -=item * - -Utah - - ftp://mirror.xmission.com/CPAN/ - -=item * - -Virginia - - http://mirrors.rcn.net/pub/lang/CPAN/ - ftp://mirrors.rcn.net/pub/lang/CPAN/ - http://perl.secsup.org/ - ftp://perl.secsup.org/pub/perl/ - http://mirrors.phihost.com/CPAN/ - ftp://mirrors.phihost.com/CPAN/ - ftp://ruff.cs.jmu.edu/pub/CPAN/ - http://perl.Liquidation.com/CPAN/ - -=item * - -Washington - - http://cpan.llarian.net/ - ftp://cpan.llarian.net/pub/CPAN/ - http://cpan.mirrorcentral.com/ - ftp://ftp.mirrorcentral.com/pub/CPAN/ - ftp://ftp-mirror.internap.com/pub/CPAN/ - -=item * - -Wisconsin - - http://mirror.sit.wisc.edu/pub/CPAN/ - ftp://mirror.sit.wisc.edu/pub/CPAN/ +=back =back @@ -1733,20 +2554,22 @@ Wisconsin =over 4 -=item * +=item Australia -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/ + http://cpan.mirrors.ilisys.com.au - http://ftp.planetmirror.com/pub/CPAN/ - ftp://ftp.planetmirror.com/pub/CPAN/ - ftp://mirror.aarnet.edu.au/pub/perl/CPAN/ - ftp://cpan.topend.com.au/pub/CPAN/ +=item New Zealand -=item * + ftp://ftp.auckland.ac.nz/pub/perl/CPAN/ -New Zealand +=item United States - ftp://ftp.auckland.ac.nz/pub/perl/CPAN/ + http://aniani.ifa.hawaii.edu/CPAN/ + ftp://aniani.ifa.hawaii.edu/CPAN/ =back @@ -1754,27 +2577,68 @@ New Zealand =over 4 -=item * - -Argentina +=item Argentina - ftp://mirrors.bannerlandia.com.ar/mirrors/CPAN/ + ftp://mirrors.bannerlandia.com.ar/mirrors/CPAN/ + http://www.linux.org.ar/mirrors/cpan + ftp://ftp.linux.org.ar/mirrors/cpan -=item * +=item Brazil -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/ - ftp://cpan.pop-mg.com.br/pub/CPAN/ - ftp://ftp.matrix.com.br/pub/perl/CPAN/ +=item Chile -=item * - -Chile - - ftp://ftp.psinet.cl/pub/programming/perl/CPAN/ + http://cpan.netglobalis.net/ + ftp://cpan.netglobalis.net/pub/CPAN/ =back +=head2 RSYNC Mirrors + + www.linux.org.ar::cpan + theoryx5.uwinnipeg.ca::CPAN + ftp.shellhung.org::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 + 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 + For an up-to-date listing of CPAN sites, see http://www.cpan.org/SITES or ftp://www.cpan.org/SITES . @@ -2059,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 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: