Slight tweaks on #15443.
[p5sagit/p5-mst-13.2.git] / pod / perlmodlib.pod
index 8ad8072..5a0d28f 100644 (file)
@@ -53,6 +53,10 @@ The following pragmas are defined (and have their own documentation).
 
 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
@@ -93,6 +97,10 @@ Compile-time class fields
 
 Control the filetest permission operators
 
+=item if
+
+C<use> a Perl module if a condition holds
+
 =item integer
 
 Use integer arithmetic instead of floating point
@@ -109,10 +117,18 @@ Use and avoid POSIX locales for built-in operations
 
 Set default disciplines for input and output
 
+=item ops
+
+Restrict unsafe operations when compiling
+
 =item overload
 
 Package for overloading perl operations
 
+=item re
+
+Alter regular expression behaviour
+
 =item sigtrap
 
 Enable simple signal handling
@@ -129,6 +145,10 @@ Restrict unsafe constructs
 
 Predeclare sub names
 
+=item threads
+
+Perl extension allowing use of interpreter based threads from perl
+
 =item utf8
 
 Enable/disable UTF-8 (or UTF-EBCDIC) in source code
@@ -175,10 +195,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
@@ -251,6 +343,10 @@ Get pathname of current working directory
 
 Programmatic interface to the Perl debugging API (draft, subject to
 
+=item DB_File
+
+Perl5 access to Berkeley DB version 1.x
+
 =item Devel::SelfStubber
 
 Generate stubs for a SelfLoading module
@@ -267,6 +363,10 @@ Supply object methods for directory handles
 
 Provides screen dump of Perl data.
 
+=item Encode
+
+Character encodings
+
 =item English
 
 Use nice English (or awk) names for ugly punctuation variables
@@ -307,6 +407,10 @@ Inventory management of installed modules
 
 Determine libraries to use and how to use them
 
+=item ExtUtils::MM_BeOS
+
+Methods to override UN*X behaviour in ExtUtils::MakeMaker
+
 =item ExtUtils::MM_Cygwin
 
 Methods to override UN*X behaviour in ExtUtils::MakeMaker
@@ -359,6 +463,10 @@ 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
@@ -381,7 +489,7 @@ DOS like globbing and then some
 
 =item File::Find
 
-Traverse a file tree
+Traverse a directory tree.
 
 =item File::Path
 
@@ -455,6 +563,10 @@ Extended processing of command line options
 
 Process single-character switches with switch clustering
 
+=item Hash::Util
+
+A selection of general-utility hash subroutines
+
 =item I18N::Collate
 
 Compare 8-bit scalar data according to the current locale
@@ -467,6 +579,10 @@ Functions for dealing with RFC3066-style language tags
 
 Tags and names for human languages
 
+=item IO
+
+Load various IO modules
+
 =item IPC::Open2
 
 Open a process for both reading and writing
@@ -499,6 +615,10 @@ Framework for localization
 
 Article about software localization
 
+=item Locale::Script
+
+ISO codes for script identification (ISO 15924)
+
 =item Math::BigFloat
 
 Arbitrary size floating point math package
@@ -551,6 +671,10 @@ Glue to provide EXISTS for SDBM_File for Storable use
 
 Store Memoized data in Storable database
 
+=item NDBM_File
+
+Tied access to ndbm files
+
 =item NEXT
 
 Provide a pseudo-class NEXT that allows method redispatch
@@ -581,7 +705,7 @@ OO interface to users netrc file
 
 =item Net::POP3
 
-Post Office Protocol 3 Client class (RFC1081)
+Post Office Protocol 3 Client class (RFC1939)
 
 =item Net::Ping
 
@@ -615,6 +739,22 @@ 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 PerlIO
 
 On demand loader for PerlIO layers and root of PerlIO::* name space
@@ -691,6 +831,14 @@ Print a usage message from embedded pod documentation
 
 Test of various basic POD features in translators.
 
+=item SDBM_File
+
+Tied access to sdbm files
+
+=item Safe
+
+Compile and execute code in restricted compartments
+
 =item Search::Dict
 
 Search for key in dictionary file
@@ -707,6 +855,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
+
+Persistency for perl data structures
+
 =item Switch
 
 A switch statement for Perl
@@ -743,6 +899,18 @@ Backend for building test libraries
 
 Run perl standard test scripts with statistics
 
+=item Test::Harness::Assert
+
+Simple assert
+
+=item Test::Harness::Iterator
+
+Internal Test::Harness Iterator
+
+=item Test::Harness::Straps
+
+Detailed analysis of test results
+
 =item Test::More
 
 Yet another framework for writing test scripts
@@ -787,6 +955,10 @@ Manipulate threads in Perl
 
 Base class for tied arrays
 
+=item Tie::File
+
+Access the lines of a disk file via a Perl array
+
 =item Tie::Handle
 
 Base class definitions for tied handles
@@ -795,6 +967,10 @@ Base class definitions for tied handles
 
 Base class definitions for tied hashes
 
+=item Tie::Memoize
+
+Add data to hash when needed
+
 =item Tie::RefHash
 
 Use references as hash keys