Revert "show -E in error message when called with -E"
[p5sagit/p5-mst-13.2.git] / pod / perlmodlib.pod
index 7284efd..2913616 100644 (file)
@@ -47,14 +47,6 @@ 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 attributes
 
 Get/set subroutine or variable attributes
@@ -63,13 +55,17 @@ Get/set subroutine or variable attributes
 
 Set/get attributes of a subroutine (deprecated)
 
+=item autodie
+
+Replace functions with ones that succeed or die with lexical scope
+
 =item autouse
 
 Postpone load of modules until a function is used
 
 =item base
 
-Establish IS-A relationship with base classes at compile time
+Establish an ISA relationship with base classes at compile time
 
 =item bigint
 
@@ -111,6 +107,10 @@ Allows you to write your script in non-ascii or non-utf8
 
 Warn on implicit encoding conversions
 
+=item feature
+
+Enable new syntactic features
+
 =item fields
 
 Compile-time class fields
@@ -129,7 +129,7 @@ Use integer arithmetic instead of floating point
 
 =item less
 
-Request less of something from the compiler
+Request less of something
 
 =item lib
 
@@ -139,6 +139,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
@@ -149,7 +153,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
 
@@ -173,7 +181,7 @@ Predeclare sub names
 
 =item threads
 
-Perl extension allowing use of interpreter based threads from perl
+Perl interpreter-based threads
 
 =item threads::shared
 
@@ -221,45 +229,41 @@ don't have the gdbm library.
 
 Provide framework for multiple DBMs
 
-=item Attribute::Handlers
+=item App::Prove
 
-Simpler definition of attribute handlers
+Implements the C<prove> command.
 
-=item AutoLoader
+=item App::Prove::State
 
-Load subroutines only on demand
+State storage for the C<prove> command.
 
-=item AutoSplit
+=item Archive::Extract
 
-Split a package for autoloading
-
-=item B
-
-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
 
@@ -273,25 +277,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
+=item B::Lint::Debug
 
-Show lexical variables used in functions or files
-
-=item B::Stackobj
-
-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
 
@@ -305,10 +301,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
@@ -345,18 +337,54 @@ 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)
@@ -373,6 +401,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
@@ -383,12 +419,32 @@ 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
 
 Perl5 access to Berkeley DB version 1.x
@@ -401,9 +457,9 @@ Stringified perl data structures, suitable for both printing and C<eval>
 
 A Perl code profiler
 
-=item Devel::PPPort
+=item Devel::InnerPackage
 
-Perl/Pollution/Portability
+Find all the inner packages of a package
 
 =item Devel::Peek
 
@@ -421,6 +477,10 @@ 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
@@ -481,6 +541,10 @@ Object Oriented Encoder
 
 Encode Implementation Base Class
 
+=item Encode::GSM0338
+
+ESTI GSM 03.38 Encoding
+
 =item Encode::Guess
 
 Guesses encoding from data
@@ -509,6 +573,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
@@ -553,6 +621,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.
@@ -597,6 +673,10 @@ 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
@@ -613,6 +693,10 @@ 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
 
 Once produced Makefiles for MacOS Classic
@@ -625,6 +709,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
@@ -637,6 +725,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
@@ -653,6 +745,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
@@ -685,6 +781,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
@@ -699,7 +799,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
 
@@ -717,6 +817,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.
@@ -725,6 +829,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
@@ -809,6 +917,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
@@ -833,6 +945,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
@@ -873,6 +1005,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<Compress::Zlib>
+
+=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
@@ -881,17 +1053,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
 
@@ -917,6 +1089,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
@@ -925,11 +1101,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
 
@@ -939,7 +1131,7 @@ Arbitrary size floating point math package
 
 =item Math::BigInt
 
-Arbitrary size integer math package
+Arbitrary size integer/float math package
 
 =item Math::BigInt::Calc
 
@@ -949,6 +1141,10 @@ Pure Perl module to support Math::BigInt
 
 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
@@ -993,10 +1189,130 @@ 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
@@ -1081,6 +1397,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
@@ -1105,6 +1429,10 @@ PerlIO layer for quoted-printable strings
 
 Check pod documents for syntax errors
 
+=item Pod::Escapes
+
+For resolving Pod EE<lt>...E<gt> sequences
+
 =item Pod::Find
 
 Find POD documents in directory trees
@@ -1185,6 +1513,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
@@ -1257,6 +1669,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<TAP::Parser> and L<TAP::Harness>
+
+=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<TAP|Test::Harness::TAP> 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
@@ -1273,6 +1801,10 @@ Perl word completion module
 
 Perl interface to various C<readline> packages.
 
+=item Term::UI
+
+Term::ReadLine UI made easy
+
 =item Test
 
 Provides a simple framework for writing test scripts
@@ -1281,25 +1813,21 @@ Provides a simple framework for writing test scripts
 
 Backend for building test libraries
 
-=item Test::Harness
-
-Run Perl standard test scripts with statistics
-
-=item Test::Harness::Assert
+=item Test::Builder::Module
 
-Simple assert
+Base class for test modules
 
-=item Test::Harness::Iterator
+=item Test::Builder::Tester
 
-Internal Test::Harness Iterator
+Test testsuites that have been built with
 
-=item Test::Harness::Straps
+=item Test::Builder::Tester::Color
 
-Detailed analysis of test results
+Turn on colour in Test::Builder::Tester
 
-=item Test::Harness::TAP
+=item Test::Harness
 
-Documentation for the TAP format
+Run Perl standard test scripts with statistics
 
 =item Test::More
 
@@ -1327,7 +1855,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
 
@@ -1349,14 +1877,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
@@ -1373,6 +1893,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
@@ -1397,6 +1921,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
@@ -1433,6 +1965,18 @@ By-name interface to Perl's built-in getgr*() functions
 
 By-name interface to Perl's built-in getpw*() functions
 
+=item Win32
+
+Interfaces to some Win32 API Functions
+
+=item 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
@@ -2372,8 +2916,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