2 # !!!!!!! DO NOT EDIT THIS FILE !!!!!!!
3 # This file is autogenerated by buildtoc from all the other pods.
4 # Edit those files and run buildtoc --build-toc to effect changes.
8 perltoc - perl documentation table of contents
12 This page provides a brief table of contents for the rest of the Perl
13 documentation set. It is meant to be scanned quickly or grepped
14 through to locate the proper section you're looking for.
16 =head1 BASIC DOCUMENTATION
18 =head2 perl - Practical Extraction and Report Language
30 =item Reference Manual
32 =item Internals and C Language Interface
36 =item Language-Specific
38 =item Platform-Specific
62 =head2 perlintro -- a brief introduction and overview of Perl
72 =item Running Perl programs
76 =item Basic syntax overview
78 =item Perl variable types
80 Scalars, Arrays, Hashes
82 =item Variable scoping
84 =item Conditional and looping constructs
86 if, while, for, foreach
88 =item Builtin operators and functions
90 Arithmetic, Numeric comparison, String comparison, Boolean logic,
95 =item Regular expressions
97 Simple matching, Simple substitution, More complex regular expressions,
98 Parentheses for capturing, Other regexp features
100 =item Writing subroutines
104 =item Using Perl modules
112 =head2 perlreftut - Mark's very short tutorial about references
118 =item Who Needs Complicated Data Structures?
126 =item Making References
128 =item Using References
146 =item Distribution Conditions
152 =head2 perldsc - Perl Data Structures Cookbook
158 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
159 more elaborate constructs
162 X<reference> X<dereference> X<dereferencing> X<pointer>
164 =item COMMON MISTAKES
166 =item CAVEAT ON PRECEDENCE
167 X<dereference, precedence> X<dereferencing, precedence>
169 =item WHY YOU SHOULD ALWAYS C<use strict>
172 X<data structure, debugging> X<complex data structure, debugging>
173 X<AoA, debugging> X<HoA, debugging> X<AoH, debugging> X<HoH, debugging>
174 X<array of arrays, debugging> X<hash of arrays, debugging>
175 X<array of hashes, debugging> X<hash of hashes, debugging>
179 =item ARRAYS OF ARRAYS
180 X<array of arrays> X<AoA>
184 =item Declaration of an ARRAY OF ARRAYS
186 =item Generation of an ARRAY OF ARRAYS
188 =item Access and Printing of an ARRAY OF ARRAYS
192 =item HASHES OF ARRAYS
193 X<hash of arrays> X<HoA>
197 =item Declaration of a HASH OF ARRAYS
199 =item Generation of a HASH OF ARRAYS
201 =item Access and Printing of a HASH OF ARRAYS
205 =item ARRAYS OF HASHES
206 X<array of hashes> X<AoH>
210 =item Declaration of an ARRAY OF HASHES
212 =item Generation of an ARRAY OF HASHES
214 =item Access and Printing of an ARRAY OF HASHES
218 =item HASHES OF HASHES
219 X<hass of hashes> X<HoH>
223 =item Declaration of a HASH OF HASHES
225 =item Generation of a HASH OF HASHES
227 =item Access and Printing of a HASH OF HASHES
231 =item MORE ELABORATE RECORDS
232 X<record> X<structure> X<struct>
236 =item Declaration of MORE ELABORATE RECORDS
238 =item Declaration of a HASH OF COMPLEX RECORDS
240 =item Generation of a HASH OF COMPLEX RECORDS
252 =head2 perllol - Manipulating Arrays of Arrays in Perl
260 =item Declaration and Access of Arrays of Arrays
262 =item Growing Your Own
264 =item Access and Printing
276 =head2 perlrequick - Perl regular expressions quick start
286 =item Simple word matching
288 =item Using character classes
290 =item Matching this or that
292 =item Grouping things and hierarchical matching
294 =item Extracting matches
296 =item Matching repetitions
300 =item Search and replace
302 =item The split operator
310 =item AUTHOR AND COPYRIGHT
314 =item Acknowledgments
320 =head2 perlretut - Perl regular expressions tutorial
326 =item Part 1: The basics
330 =item Simple word matching
332 =item Using character classes
334 =item Matching this or that
336 =item Grouping things and hierarchical matching
338 =item Extracting matches
342 =item Relative backreferences
344 =item Named backreferences
346 =item Alternative capture group numbering
348 =item Position information
350 =item Non-capturing groupings
352 =item Matching repetitions
354 =item Possessive quantifiers
356 =item Building a regexp
358 =item Using regular expressions in Perl
362 =item Part 2: Power tools
366 =item More on characters, strings, and character classes
368 =item Compiling and saving regular expressions
370 =item Composing regular expressions at runtime
372 =item Embedding comments and modifiers in a regular expression
374 =item Looking ahead and looking behind
376 =item Using independent subexpressions to prevent backtracking
378 =item Conditional expressions
380 =item Defining named patterns
382 =item Recursive patterns
384 =item A bit of magic: executing Perl code in a regular expression
386 =item Backtracking control verbs
388 =item Pragmas and debugging
396 =item AUTHOR AND COPYRIGHT
400 =item Acknowledgments
406 =head2 perlboot - Beginner's Object-Oriented Tutorial
414 =item If we could talk to the animals...
416 =item Introducing the method invocation arrow
418 =item Invoking a barnyard
420 =item The extra parameter of method invocation
422 =item Calling a second method to simplify things
424 =item Inheriting the windpipes
426 =item A few notes about @ISA
428 =item Overriding the methods
430 =item Starting the search from a different place
432 =item The SUPER way of doing things
434 =item Where we're at so far...
436 =item A horse is a horse, of course of course -- or is it?
438 =item Invoking an instance method
440 =item Accessing the instance data
442 =item How to build a horse
444 =item Inheriting the constructor
446 =item Making a method work with either classes or instances
448 =item Adding parameters to a method
450 =item More interesting instances
452 =item A horse of a different color
464 =head2 perltoot - Tom's object-oriented tutorial for perl
470 =item Creating a Class
474 =item Object Representation
476 =item Class Interface
478 =item Constructors and Instance Methods
480 =item Planning for the Future: Better Constructors
484 =item Other Object Methods
492 =item Accessing Class Data
494 =item Debugging Methods
496 =item Class Destructors
498 =item Documenting the Interface
508 =item Overridden Methods
510 =item Multiple Inheritance
512 =item UNIVERSAL: The Root of All Objects
514 =item Deeper UNIVERSAL details
518 =item Alternate Object Representations
522 =item Arrays as Objects
524 =item Closures as Objects
528 =item AUTOLOAD: Proxy Methods
532 =item Autoloaded Data Methods
534 =item Inherited Autoloaded Data Methods
538 =item Metaclassical Tools
544 =item Data Members as Variables
552 =item Object Terminology
558 =item AUTHOR AND COPYRIGHT
564 =item Acknowledgments
570 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
576 =item Class Data in a Can
578 =item Class Data as Package Variables
582 =item Putting All Your Eggs in One Basket
584 =item Inheritance Concerns
586 =item The Eponymous Meta-Object
588 =item Indirect References to Class Data
590 =item Monadic Classes
592 =item Translucent Attributes
596 =item Class Data as Lexical Variables
600 =item Privacy and Responsibility
602 =item File-Scoped Lexicals
604 =item More Inheritance Concerns
606 =item Locking the Door and Throwing Away the Key
608 =item Translucency Revisited
616 =item AUTHOR AND COPYRIGHT
618 =item ACKNOWLEDGEMENTS
624 =head2 perlbot - Bag'o Object Tricks (the BOT)
630 =item OO SCALING TIPS
632 =item INSTANCE VARIABLES
634 =item SCALAR INSTANCE VARIABLES
636 =item INSTANCE VARIABLE INHERITANCE
638 =item OBJECT RELATIONSHIPS
640 =item OVERRIDING SUPERCLASS METHODS
642 =item USING RELATIONSHIP WITH SDBM
644 =item THINKING OF CODE REUSE
646 =item CLASS CONTEXT AND THE OBJECT
648 =item INHERITING A CONSTRUCTOR
656 =head2 perlperf - Perl Performance and Optimization Techniques
666 =item ONE STEP SIDEWAYS
668 =item ONE STEP FORWARD
670 =item ANOTHER STEP SIDEWAYS
674 =item GENERAL GUIDELINES
680 =item Assigning and Dereferencing Variables.
682 =item Search and replace or tr
686 =item PROFILING TOOLS
692 =item Devel::Profiler
694 =item Devel::SmallProf
696 =item Devel::FastProf
704 Elapsed Real Time, User CPU Time, System CPU Time
710 =item Logging if DEBUG (constant)
734 =head2 perlstyle - Perl style guide
742 =head2 perlcheat - Perl 5 Cheat Sheet
754 =item ACKNOWLEDGEMENTS
762 =head2 perltrap - Perl traps for the unwary
780 =item Perl4 to Perl5 Traps
782 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
783 Traps, General data type traps, Context Traps - scalar, list contexts,
784 Precedence Traps, General Regular Expression Traps using s///, etc,
785 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
787 =item Discontinuance, Deprecation, and BugFix traps
789 Symbols starting with "_" no longer forced into main, Double-colon valid
790 package separator in variable name, 2nd and 3rd args to C<splice()> are now
791 in scalar context, Can't do C<goto> into a block that is optimized away,
792 Can't use whitespace as variable name or quote delimiter, C<while/if BLOCK
793 BLOCK> gone, C<**> binds tighter than unary minus, C<foreach> changed when
794 iterating over a list, C<split> with no args behavior changed, B<-e>
795 behavior fixed, C<push> returns number of elements in resulting list, Some
796 error messages differ, C<split()> honors subroutine args, Bugs removed
800 Space between . and = triggers syntax error, Better parsing in perl 5,
801 Function parsing, String interpolation of C<$#array> differs, Perl guesses
802 on C<map>, C<grep> followed by C<{> if it starts BLOCK or hash ref
804 =item Numerical Traps
806 Formatted output and significant digits, Auto-increment operator over
807 signed int limit deleted, Assignment of return values from numeric equality
808 tests doesn't work, Bitwise string ops
810 =item General data type traps
812 Negative array subscripts now count from the end of array, Setting
813 C<$#array> lower now discards array elements, Hashes get defined before
814 use, Glob assignment from localized variable to variable, Assigning
815 C<undef> to glob, Changes in unary negation (of strings), Modifying of
816 constants prohibited, C<defined $var> behavior changed, Variable Suicide
818 =item Context Traps - scalar, list contexts
820 Elements of argument lists for formats evaluated in list context,
821 C<caller()> returns false value in scalar context if no caller present,
822 Comma operator in scalar context gives scalar context to args, C<sprintf()>
823 prototyped as C<($;@)>
825 =item Precedence Traps
827 LHS vs. RHS of any assignment operator, Semantic errors introduced due to
828 precedence, Precedence of assignment operators same as the precedence of
829 assignment, C<open> requires parentheses around filehandle, C<$:>
830 precedence over C<$::> gone, Precedence of file test operators documented,
831 C<keys>, C<each>, C<values> are regular named unary operators
833 =item General Regular Expression Traps using s///, etc.
835 C<s'$lhs'$rhs'> interpolates on either side, C<m//g> attaches its state to
836 the searched string, C<m//o> used within an anonymous sub, C<$+> isn't set
837 to whole match, Substitution now returns null string if it fails,
838 C<s`lhs`rhs`> is now a normal substitution, Stricter parsing of variables
839 in regular expressions, C<m?x?> matches only once, Failed matches don't
840 reset the match variables
842 =item Subroutine, Signal, Sorting Traps
844 Barewords that used to look like strings look like subroutine calls,
845 Reverse is no longer allowed as the name of a sort subroutine, C<warn()>
846 won't let you specify a filehandle
850 SysV resets signal handler correctly, SysV C<seek()> appends correctly
852 =item Interpolation Traps
854 C<@> always interpolates an array in double-quotish strings, Double-quoted
855 strings may no longer end with an unescaped $, Arbitrary expressions are
856 evaluated inside braces within double quotes, C<$$x> now tries to
857 dereference $x, Creation of hashes on the fly with C<eval "EXPR"> requires
858 protection, Bugs in earlier perl versions, Array and hash brackets during
859 interpolation, Interpolation of C<\$$foo{bar}>, C<qq()> string passed to
860 C<eval> will not find string terminator
864 Perl5 must have been linked with same dbm/ndbm as the default for
865 C<dbmopen()>, DBM exceeding limit on the key/value size will cause perl5 to
868 =item Unclassified Traps
870 C<require>/C<do> trap using returned value, C<split> on empty string with
877 =head2 perldebtut - Perl debugging tutorial
885 =item Looking at data and -w and v
889 =item Stepping through code
891 =item Placeholder for a, w, t, T
893 =item REGULAR EXPRESSIONS
911 =head2 perlfaq - frequently asked questions about Perl
919 =item Where to get the perlfaq
921 =item How to contribute to the perlfaq
923 =item What will happen if you mail your Perl programming problems to the
930 =item AUTHOR AND COPYRIGHT
932 =item Table of Contents
934 perlfaq - this document, perlfaq1 - General Questions About Perl, perlfaq2
935 - Obtaining and Learning about Perl, perlfaq3 - Programming Tools, perlfaq4
936 - Data Manipulation, perlfaq5 - Files and Formats, perlfaq6 - Regular
937 Expressions, perlfaq7 - General Perl Language Issues, perlfaq8 - System
938 Interaction, perlfaq9 - Networking
944 =item L<perlfaq1>: General Questions About Perl
946 =item L<perlfaq2>: Obtaining and Learning about Perl
948 =item L<perlfaq3>: Programming Tools
950 =item L<perlfaq4>: Data Manipulation
952 =item L<perlfaq5>: Files and Formats
954 =item L<perlfaq6>: Regular Expressions
956 =item L<perlfaq7>: General Perl Language Issues
958 =item L<perlfaq8>: System Interaction
960 =item L<perlfaq9>: Networking
966 =head2 perlfaq1 - General Questions About Perl
976 =item Who supports Perl? Who develops it? Why is it free?
978 =item Which version of Perl should I use?
980 =item What are Perl 4, Perl 5, or Perl 6?
982 =item What was Ponie?
984 =item What is Perl 6?
986 =item How stable is Perl?
988 =item Is Perl difficult to learn?
990 =item How does Perl compare with other languages like Java, Python, REXX,
993 =item Can I do [task] in Perl?
995 =item When shouldn't I program in Perl?
997 =item What's the difference between "perl" and "Perl"?
999 =item Is it a Perl program or a Perl script?
1001 =item What is a JAPH?
1003 =item Where can I get a list of Larry Wall witticisms?
1005 =item How can I convince others to use Perl?
1007 http://perltraining.com.au/whyperl.html,
1008 http://www.perl.org/advocacy/whyperl.html
1014 =item AUTHOR AND COPYRIGHT
1018 =head2 perlfaq2 - Obtaining and Learning about Perl
1026 =item What machines support perl? Where do I get it?
1028 =item How can I get a binary version of perl?
1030 =item I don't have a C compiler. How can I build my own Perl interpreter?
1032 =item I copied the perl binary from one machine to another, but scripts
1035 =item I grabbed the sources and tried to compile but gdbm/dynamic
1036 loading/malloc/linking/... failed. How do I make it work?
1038 =item What modules and extensions are available for Perl? What is CPAN?
1039 What does CPAN/src/... mean?
1041 =item Is there an ISO or ANSI certified version of Perl?
1043 =item Where can I get information on Perl?
1045 =item What are the Perl newsgroups on Usenet? Where do I post questions?
1047 =item Where should I post source code?
1051 References, Tutorials, Task-Oriented, Special Topics
1053 =item Which magazines have Perl content?
1055 =item What mailing lists are there for Perl?
1057 =item Where are the archives for comp.lang.perl.misc?
1059 =item Where can I buy a commercial version of perl?
1061 =item Where do I send bug reports?
1063 =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
1069 =item AUTHOR AND COPYRIGHT
1073 =head2 perlfaq3 - Programming Tools
1081 =item How do I do (anything)?
1083 =item How can I use Perl interactively?
1085 =item Is there a Perl shell?
1087 =item How do I find which modules are installed on my system?
1089 =item How do I debug my Perl programs?
1091 =item How do I profile my Perl programs?
1093 =item How do I cross-reference my Perl programs?
1095 =item Is there a pretty-printer (formatter) for Perl?
1097 =item Is there a ctags for Perl?
1099 =item Is there an IDE or Windows Perl Editor?
1101 Eclipse, Enginsite, Komodo, Open Perl IDE, OptiPerl, PerlBuilder,
1102 visiPerl+, Visual Perl, Zeus, GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis,
1103 Vile, Vim, Codewright, MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, Affrus,
1104 Alpha, BBEdit and BBEdit Lite
1106 =item Where can I get Perl macros for vi?
1108 =item Where can I get perl-mode for emacs?
1110 =item How can I use curses with Perl?
1112 =item How can I write a GUI (X, Tk, Gtk, etc.) in Perl?
1113 X<GUI> X<Tk> X<Wx> X<WxWidgets> X<Gtk> X<Gtk2> X<CamelBones> X<Qt>
1115 Tk, Wx, Gtk and Gtk2, Win32::GUI, CamelBones, Qt, Athena
1117 =item How can I make my Perl program run faster?
1119 =item How can I make my Perl program take less memory?
1121 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
1122 stringification, Pass by reference, Tie large variables to disk
1124 =item Is it safe to return a reference to local or lexical data?
1126 =item How can I free an array or hash so my program shrinks?
1128 =item How can I make my CGI script more efficient?
1130 =item How can I hide the source for my Perl program?
1132 =item How can I compile my Perl program into byte code or C?
1134 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
1136 =item Can I write useful Perl programs on the command line?
1138 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
1140 =item Where can I learn about CGI or Web programming in Perl?
1142 =item Where can I learn about object-oriented Perl programming?
1144 =item Where can I learn about linking C with Perl?
1146 =item I've read perlembed, perlguts, etc., but I can't embed perl in my C
1147 program; what am I doing wrong?
1149 =item When I tried to run my script, I got this message. What does it mean?
1151 =item What's MakeMaker?
1157 =item AUTHOR AND COPYRIGHT
1161 =head2 perlfaq4 - Data Manipulation
1171 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
1172 numbers I should be getting (eg, 19.95)?
1174 =item Why is int() broken?
1176 =item Why isn't my octal data interpreted correctly?
1178 =item Does Perl have a round() function? What about ceil() and floor()?
1181 =item How do I convert between numeric representations/bases/radixes?
1183 How do I convert hexadecimal into decimal, How do I convert from decimal to
1184 hexadecimal, How do I convert from octal to decimal, How do I convert from
1185 decimal to octal, How do I convert from binary to decimal, How do I convert
1186 from decimal to binary
1188 =item Why doesn't & work the way I want it to?
1190 =item How do I multiply matrices?
1192 =item How do I perform an operation on a series of integers?
1194 =item How can I output Roman numerals?
1196 =item Why aren't my random numbers random?
1198 =item How do I get a random number between X and Y?
1206 =item How do I find the day or week of the year?
1208 =item How do I find the current century or millennium?
1210 =item How can I compare two dates and find the difference?
1212 =item How can I take a string and turn it into epoch seconds?
1214 =item How can I find the Julian Day?
1216 =item How do I find yesterday's date?
1218 =item Does Perl have a Year 2000 problem? Is Perl Y2K compliant?
1226 =item How do I validate input?
1228 =item How do I unescape a string?
1230 =item How do I remove consecutive pairs of characters?
1232 =item How do I expand function calls in a string?
1234 =item How do I find matching/nesting anything?
1236 =item How do I reverse a string?
1238 =item How do I expand tabs in a string?
1240 =item How do I reformat a paragraph?
1242 =item How can I access or change N characters of a string?
1244 =item How do I change the Nth occurrence of something?
1246 =item How can I count the number of occurrences of a substring within a
1249 =item How do I capitalize all the words on one line?
1251 =item How can I split a [character] delimited string except when inside
1254 =item How do I strip blank space from the beginning/end of a string?
1256 =item How do I pad a string with blanks or pad a number with zeroes?
1258 =item How do I extract selected columns from a string?
1260 =item How do I find the soundex value of a string?
1262 =item How can I expand variables in text strings?
1264 =item What's wrong with always quoting "$vars"?
1266 =item Why don't my E<lt>E<lt>HERE documents work?
1268 There must be no space after the E<lt>E<lt> part, There (probably) should
1269 be a semicolon at the end, You can't (easily) have any space in front of
1278 =item What is the difference between a list and an array?
1280 =item What is the difference between $array[1] and @array[1]?
1282 =item How can I remove duplicate elements from a list or array?
1284 =item How can I tell whether a certain element is contained in a list or
1287 =item How do I compute the difference of two arrays? How do I compute the
1288 intersection of two arrays?
1290 =item How do I test whether two arrays or hashes are equal?
1292 =item How do I find the first array element for which a condition is true?
1294 =item How do I handle linked lists?
1296 =item How do I handle circular lists?
1298 =item How do I shuffle an array randomly?
1300 =item How do I process/modify each element of an array?
1302 =item How do I select a random element from an array?
1304 =item How do I permute N elements of a list?
1305 X<List::Permuter> X<permute> X<Algorithm::Loops> X<Knuth>
1306 X<The Art of Computer Programming> X<Fischer-Krause>
1308 =item How do I sort an array by (anything)?
1310 =item How do I manipulate arrays of bits?
1312 =item Why does defined() return true on empty arrays and hashes?
1316 =item Data: Hashes (Associative Arrays)
1320 =item How do I process an entire hash?
1322 =item What happens if I add or remove keys from a hash while iterating over
1325 =item How do I look up a hash element by value?
1327 =item How can I know how many entries are in a hash?
1329 =item How do I sort a hash (optionally by value instead of key)?
1331 =item How can I always keep my hash sorted?
1332 X<hash tie sort DB_File Tie::IxHash>
1334 =item What's the difference between "delete" and "undef" with hashes?
1336 =item Why don't my tied hashes make the defined/exists distinction?
1338 =item How do I reset an each() operation part-way through?
1340 =item How can I get the unique keys from two hashes?
1342 =item How can I store a multidimensional array in a DBM file?
1344 =item How can I make my hash remember the order I put elements into it?
1346 =item Why does passing a subroutine an undefined element in a hash create
1349 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
1350 array of hashes or arrays?
1352 =item How can I use a reference as a hash key?
1360 =item How do I handle binary data correctly?
1362 =item How do I determine whether a scalar is a number/whole/integer/float?
1364 =item How do I keep persistent data across program calls?
1366 =item How do I print out or copy a recursive data structure?
1368 =item How do I define methods for every class/object?
1370 =item How do I verify a credit card checksum?
1372 =item How do I pack arrays of doubles or floats for XS code?
1378 =item AUTHOR AND COPYRIGHT
1382 =head2 perlfaq5 - Files and Formats
1390 =item How do I flush/unbuffer an output filehandle? Why must I do this?
1391 X<flush> X<buffer> X<unbuffer> X<autoflush>
1393 =item How do I change, delete, or insert a line in a file, or append to the
1394 beginning of a file?
1397 =item How do I count the number of lines in a file?
1398 X<file, counting lines> X<lines> X<line>
1400 =item How can I use Perl's C<-i> option from within a program?
1403 =item How can I copy a file?
1404 X<copy> X<file, copy>
1406 =item How do I make a temporary file name?
1409 =item How can I manipulate fixed-record-length files?
1410 X<fixed-length> X<file, fixed-length records>
1412 =item How can I make a filehandle local to a subroutine? How do I pass
1413 filehandles between subroutines? How do I make an array of filehandles?
1414 X<filehandle, local> X<filehandle, passing> X<filehandle, reference>
1416 =item How can I use a filehandle indirectly?
1417 X<filehandle, indirect>
1419 =item How can I set up a footer format to be used with write()?
1422 =item How can I write() into a string?
1423 X<write, into a string>
1425 =item How can I open a filehandle to a string?
1426 X<string>, X<open>, X<IO::Scalar>, X<filehandle>
1428 =item How can I output my numbers with commas added?
1431 =item How can I translate tildes (~) in a filename?
1432 X<tilde> X<tilde expansion>
1434 =item How come when I open a file read-write it wipes it out?
1435 X<clobber> X<read-write> X<clobbering> X<truncate> X<truncating>
1437 =item Why do I sometimes get an "Argument list too long" when I use
1439 X<argument list too long>
1441 =item Is there a leak/bug in glob()?
1444 =item How can I open a file with a leading ">" or trailing blanks?
1445 X<filename, special characters>
1447 =item How can I reliably rename a file?
1448 X<rename> X<mv> X<move> X<file, rename> X<ren>
1450 =item How can I lock a file?
1451 X<lock> X<file, lock> X<flock>
1453 =item Why can't I just open(FH, "E<gt>file.lock")?
1454 X<lock, lockfile race condition>
1456 =item I still don't get locking. I just want to increment the number in
1457 the file. How can I do this?
1458 X<counter> X<file, counter>
1460 =item All I want to do is append a small amount of text to the end of a
1461 file. Do I still have to use locking?
1462 X<append> X<file, append>
1464 =item How do I randomly update a binary file?
1465 X<file, binary patch>
1467 =item How do I get a file's timestamp in perl?
1468 X<timestamp> X<file, timestamp>
1470 =item How do I set a file's timestamp in perl?
1471 X<timestamp> X<file, timestamp>
1473 =item How do I print to more than one file at once?
1474 X<print, to multiple files>
1476 =item How can I read in an entire file all at once?
1477 X<slurp> X<file, slurping>
1479 =item How can I read in a file by paragraphs?
1480 X<file, reading by paragraphs>
1482 =item How can I read a single character from a file? From the keyboard?
1483 X<getc> X<file, reading one character at a time>
1485 =item How can I tell whether there's a character waiting on a filehandle?
1487 =item How do I do a C<tail -f> in perl?
1488 X<tail> X<IO::Handle> X<File::Tail> X<clearerr>
1490 =item How do I dup() a filehandle in Perl?
1493 =item How do I close a file descriptor by number?
1494 X<file, closing file descriptors> X<POSIX> X<close>
1496 =item Why can't I use "C:\temp\foo" in DOS paths? Why doesn't
1497 `C:\temp\foo.exe` work?
1498 X<filename, DOS issues>
1500 =item Why doesn't glob("*.*") get all the files?
1503 =item Why does Perl let me delete read-only files? Why does C<-i> clobber
1504 protected files? Isn't this a bug in Perl?
1506 =item How do I select a random line from a file?
1507 X<file, selecting a random line>
1509 =item Why do I get weird spaces when I print an array of lines?
1515 =item AUTHOR AND COPYRIGHT
1519 =head2 perlfaq6 - Regular Expressions
1527 =item How can I hope to use regular expressions without creating illegible
1528 and unmaintainable code?
1529 X<regex, legibility> X<regexp, legibility>
1530 X<regular expression, legibility> X</x>
1532 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
1534 =item I'm having trouble matching over more than one line. What's wrong?
1535 X<regex, multiline> X<regexp, multiline> X<regular expression, multiline>
1537 =item How can I pull out lines between two patterns that are themselves on
1541 =item I put a regular expression into $/ but it didn't work. What's wrong?
1542 X<$/, regexes in> X<$INPUT_RECORD_SEPARATOR, regexes in>
1545 =item How do I substitute case insensitively on the LHS while preserving
1547 X<replace, case preserving> X<substitute, case preserving>
1548 X<substitution, case preserving> X<s, case preserving>
1550 =item How can I make C<\w> match national character sets?
1553 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
1556 =item How can I quote a variable to use in a regex?
1557 X<regex, escaping> X<regexp, escaping> X<regular expression, escaping>
1559 =item What is C</o> really for?
1560 X</o, regular expressions> X<compile, regular expressions>
1562 =item How do I use a regular expression to strip C style comments from a
1565 =item Can I use Perl regular expressions to match balanced text?
1566 X<regex, matching balanced test> X<regexp, matching balanced test>
1567 X<regular expression, matching balanced test>
1569 =item What does it mean that regexes are greedy? How can I get around it?
1570 X<greedy> X<greediness>
1572 =item How do I process each word on each line?
1575 =item How can I print out a word-frequency or line-frequency summary?
1577 =item How can I do approximate matching?
1578 X<match, approximate> X<matching, approximate>
1580 =item How do I efficiently match many regular expressions at once?
1581 X<regex, efficiency> X<regexp, efficiency>
1582 X<regular expression, efficiency>
1584 =item Why don't word-boundary searches with C<\b> work for me?
1587 =item Why does using $&, $`, or $' slow my program down?
1588 X<$MATCH> X<$&> X<$POSTMATCH> X<$'> X<$PREMATCH> X<$`>
1590 =item What good is C<\G> in a regular expression?
1593 =item Are Perl regexes DFAs or NFAs? Are they POSIX compliant?
1594 X<DFA> X<NFA> X<POSIX>
1596 =item What's wrong with using grep in a void context?
1599 =item How can I match strings with multibyte characters?
1600 X<regex, and multibyte characters> X<regexp, and multibyte characters>
1601 X<regular expression, and multibyte characters> X<martian> X<encoding,
1604 =item How do I match a regular expression that's in a variable?
1605 X<regex, in variable> X<eval> X<regex> X<quotemeta> X<\Q, regex>
1606 X<\E, regex>, X<qr//>
1612 =item AUTHOR AND COPYRIGHT
1616 =head2 perlfaq7 - General Perl Language Issues
1624 =item Can I get a BNF/yacc/RE for the Perl language?
1626 =item What are all these $@%&* punctuation signs, and how do I know when to
1629 =item Do I always/never have to quote my strings or use semicolons and
1632 =item How do I skip some return values?
1634 =item How do I temporarily block warnings?
1636 =item What's an extension?
1638 =item Why do Perl operators have different precedence than C operators?
1640 =item How do I declare/create a structure?
1642 =item How do I create a module?
1644 =item How do I adopt or take over a module already on CPAN?
1646 =item How do I create a class?
1648 =item How can I tell if a variable is tainted?
1650 =item What's a closure?
1652 =item What is variable suicide and how can I prevent it?
1654 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
1657 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
1660 =item How do I create a static variable?
1662 =item What's the difference between dynamic and lexical (static) scoping?
1663 Between local() and my()?
1665 =item How can I access a dynamic variable while a similarly named lexical
1668 =item What's the difference between deep and shallow binding?
1670 =item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?
1672 =item How do I redefine a builtin function, operator, or method?
1674 =item What's the difference between calling a function as &foo and foo()?
1676 =item How do I create a switch or case statement?
1678 =item How can I catch accesses to undefined variables, functions, or
1681 =item Why can't a method included in this same file be found?
1683 =item How can I find out my current package?
1685 =item How can I comment out a large block of perl code?
1687 =item How do I clear a package?
1689 =item How can I use a variable as a variable name?
1691 =item What does "bad interpreter" mean?
1697 =item AUTHOR AND COPYRIGHT
1701 =head2 perlfaq8 - System Interaction
1709 =item How do I find out which operating system I'm running under?
1711 =item How come exec() doesn't return?
1713 =item How do I do fancy stuff with the keyboard/screen/mouse?
1715 Keyboard, Screen, Mouse
1717 =item How do I print something out in color?
1719 =item How do I read just one key without waiting for a return key?
1721 =item How do I check whether input is ready on the keyboard?
1723 =item How do I clear the screen?
1725 =item How do I get the screen size?
1727 =item How do I ask the user for a password?
1729 =item How do I read and write the serial port?
1731 lockfiles, open mode, end of line, flushing output, non-blocking input
1733 =item How do I decode encrypted password files?
1735 =item How do I start a process in the background?
1737 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
1739 =item How do I trap control characters/signals?
1741 =item How do I modify the shadow password file on a Unix system?
1743 =item How do I set the time and date?
1745 =item How can I sleep() or alarm() for under a second?
1746 X<Time::HiRes> X<BSD::Itimer> X<sleep> X<select>
1748 =item How can I measure time under a second?
1749 X<Time::HiRes> X<BSD::Itimer> X<sleep> X<select>
1751 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
1753 =item Why doesn't my sockets program work under System V (Solaris)? What
1754 does the error message "Protocol not supported" mean?
1756 =item How can I call my system's unique C functions from Perl?
1758 =item Where do I get the include files to do ioctl() or syscall()?
1760 =item Why do setuid perl scripts complain about kernel problems?
1762 =item How can I open a pipe both to and from a command?
1764 =item Why can't I get the output of a command with system()?
1766 =item How can I capture STDERR from an external command?
1768 =item Why doesn't open() return an error when a pipe open fails?
1770 =item What's wrong with using backticks in a void context?
1772 =item How can I call backticks without shell processing?
1774 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
1777 =item How can I convert my shell script to perl?
1779 =item Can I use perl to run a telnet or ftp session?
1781 =item How can I write expect in Perl?
1783 =item Is there a way to hide perl's command line from programs such as
1786 =item I {changed directory, modified my environment} in a perl script. How
1787 come the change disappeared when I exited the script? How do I get my
1788 changes to be visible?
1792 =item How do I close a process's filehandle without waiting for it to
1795 =item How do I fork a daemon process?
1797 =item How do I find out if I'm running interactively or not?
1799 =item How do I timeout a slow event?
1801 =item How do I set CPU limits?
1802 X<BSD::Resource> X<limit> X<CPU>
1804 =item How do I avoid zombies on a Unix system?
1806 =item How do I use an SQL database?
1808 =item How do I make a system() exit on control-C?
1810 =item How do I open a file without blocking?
1812 =item How do I tell the difference between errors from the shell and perl?
1814 =item How do I install a module from CPAN?
1816 =item What's the difference between require and use?
1818 =item How do I keep my own module/library directory?
1820 =item How do I add the directory my program lives in to the module/library
1823 =item How do I add a directory to my include path (@INC) at runtime?
1825 the PERLLIB environment variable, the PERL5LIB environment variable, the
1826 perl -Idir command line flag, the use lib pragma:
1828 =item What is socket.ph and where do I get it?
1834 =item AUTHOR AND COPYRIGHT
1838 =head2 perlfaq9 - Networking
1846 =item What is the correct form of response from a CGI script?
1848 =item My CGI script runs from the command line but not the browser. (500
1851 =item How can I get better error messages from a CGI program?
1853 =item How do I remove HTML from a string?
1855 =item How do I extract URLs?
1857 =item How do I download a file from the user's machine? How do I open a
1858 file on another machine?
1860 =item How do I make an HTML pop-up menu with Perl?
1862 =item How do I fetch an HTML file?
1864 =item How do I automate an HTML form submission?
1866 =item How do I decode or create those %-encodings on the web?
1868 =item How do I redirect to another page?
1870 =item How do I put a password on my web pages?
1872 =item How do I edit my .htpasswd and .htgroup files with Perl?
1874 =item How do I make sure users can't enter values into a form that cause my
1875 CGI script to do bad things?
1877 =item How do I parse a mail header?
1879 =item How do I decode a CGI form?
1881 =item How do I check a valid mail address?
1883 =item How do I decode a MIME/BASE64 string?
1885 =item How do I return the user's mail address?
1887 =item How do I send mail?
1889 =item How do I use MIME to make an attachment to a mail message?
1891 =item How do I read mail?
1893 =item How do I find out my hostname, domainname, or IP address?
1894 X<hostname, domainname, IP address, host, domain, hostfqdn, inet_ntoa,
1895 gethostbyname, Socket, Net::Domain, Sys::Hostname>
1897 =item How do I fetch a news article or the active newsgroups?
1899 =item How do I fetch/put an FTP file?
1901 =item How can I do RPC in Perl?
1907 =item AUTHOR AND COPYRIGHT
1911 =head2 perlsyn - Perl syntax
1920 X<declaration> X<undef> X<undefined> X<uninitialized>
1925 =item Simple Statements
1926 X<statement> X<semicolon> X<expression> X<;>
1928 =item Truth and Falsehood
1929 X<truth> X<falsehood> X<true> X<false> X<!> X<not> X<negation> X<0>
1931 =item Statement Modifiers
1932 X<statement modifier> X<modifier> X<if> X<unless> X<while>
1933 X<until> X<foreach> X<for>
1935 =item Compound Statements
1936 X<statement, compound> X<block> X<bracket, curly> X<curly bracket> X<brace>
1937 X<{> X<}> X<if> X<unless> X<while> X<until> X<foreach> X<for> X<continue>
1940 X<loop control> X<loop, control> X<next> X<last> X<redo> X<continue>
1951 =item Switch statements
1952 X<switch> X<case> X<given> X<when> X<default>
1959 =item PODs: Embedded Documentation
1960 X<POD> X<documentation>
1962 =item Plain Old Comments (Not!)
1963 X<comment> X<line> X<#> X<preprocessor> X<eval>
1969 =head2 perldata - Perl data types
1977 =item Variable names
1978 X<variable, name> X<variable name> X<data type> X<type>
1981 X<context> X<scalar context> X<list context>
1984 X<scalar> X<number> X<string> X<reference>
1986 =item Scalar value constructors
1987 X<scalar, literal> X<scalar, constant>
1989 =item List value constructors
1995 X<slice> X<array, slice> X<hash, slice>
1997 =item Typeglobs and Filehandles
1998 X<typeglob> X<filehandle> X<*>
2006 =head2 perlop - Perl operators and precedence
2014 =item Operator Precedence and Associativity
2015 X<operator, precedence> X<precedence> X<associativity>
2017 =item Terms and List Operators (Leftward)
2018 X<list operator> X<operator, list> X<term>
2020 =item The Arrow Operator
2021 X<arrow> X<dereference> X<< -> >>
2023 =item Auto-increment and Auto-decrement
2024 X<increment> X<auto-increment> X<++> X<decrement> X<auto-decrement> X<-->
2026 =item Exponentiation
2027 X<**> X<exponentiation> X<power>
2029 =item Symbolic Unary Operators
2030 X<unary operator> X<operator, unary>
2032 =item Binding Operators
2033 X<binding> X<operator, binding> X<=~> X<!~>
2035 =item Multiplicative Operators
2036 X<operator, multiplicative>
2038 =item Additive Operators
2039 X<operator, additive>
2041 =item Shift Operators
2042 X<shift operator> X<operator, shift> X<<< << >>>
2043 X<<< >> >>> X<right shift> X<left shift> X<bitwise shift>
2044 X<shl> X<shr> X<shift, right> X<shift, left>
2046 =item Named Unary Operators
2047 X<operator, named unary>
2049 =item Relational Operators
2050 X<relational operator> X<operator, relational>
2052 =item Equality Operators
2053 X<equality> X<equal> X<equals> X<operator, equality>
2056 X<operator, bitwise, and> X<bitwise and> X<&>
2058 =item Bitwise Or and Exclusive Or
2059 X<operator, bitwise, or> X<bitwise or> X<|> X<operator, bitwise, xor>
2062 =item C-style Logical And
2063 X<&&> X<logical and> X<operator, logical, and>
2065 =item C-style Logical Or
2066 X<||> X<operator, logical, or>
2068 =item C-style Logical Defined-Or
2069 X<//> X<operator, logical, defined-or>
2071 =item Range Operators
2072 X<operator, range> X<range> X<..> X<...>
2074 =item Conditional Operator
2075 X<operator, conditional> X<operator, ternary> X<ternary> X<?:>
2077 =item Assignment Operators
2078 X<assignment> X<operator, assignment> X<=> X<**=> X<+=> X<*=> X<&=>
2079 X<<< <<= >>> X<&&=> X<-=> X</=> X<|=> X<<< >>= >>> X<||=> X<//=> X<.=>
2082 =item Comma Operator
2083 X<comma> X<operator, comma> X<,>
2085 =item Yada Yada Operators
2086 X<...> X<... operator> X<!!!> X<!!! operator> X<???> X<??? operator>
2087 X<yada yada operator>
2089 =item List Operators (Rightward)
2090 X<operator, list, rightward> X<list operator>
2093 X<operator, logical, not> X<not>
2096 X<operator, logical, and> X<and>
2098 =item Logical or, Defined or, and Exclusive Or
2099 X<operator, logical, or> X<operator, logical, xor>
2100 X<operator, logical, defined or> X<operator, logical, exclusive or>
2103 =item C Operators Missing From Perl
2104 X<operator, missing from perl> X<&> X<*>
2105 X<typecasting> X<(TYPE)>
2107 unary &, unary *, (TYPE)
2109 =item Quote and Quote-like Operators
2110 X<operator, quote> X<operator, quote-like> X<q> X<qq> X<qx> X<qw> X<m>
2111 X<qr> X<s> X<tr> X<'> X<''> X<"> X<""> X<//> X<`> X<``> X<<< << >>>
2112 X<escape sequence> X<escape>
2114 =item Regexp Quote-Like Operators
2117 qr/STRING/msixpo X<qr> X</i> X</m> X</o> X</s> X</x> X</p>,
2118 m/PATTERN/msixpogc X<m> X<operator, match> X<regexp, options> X<regexp>
2119 X<regex, options> X<regex> X</m> X</s> X</i> X</x> X</p> X</o> X</g> X</c>,
2120 /PATTERN/msixpogc, The empty pattern //, Matching in list context, \G
2121 assertion, ?PATTERN? X<?>, s/PATTERN/REPLACEMENT/msixpogce X<substitute>
2122 X<substitution> X<replace> X<regexp, replace> X<regexp, substitute> X</m>
2123 X</s> X</i> X</x> X</p> X</o> X</g> X</c> X</e>
2125 =item Quote-Like Operators
2126 X<operator, quote-like>
2128 q/STRING/ X<q> X<quote, single> X<'> X<''>, 'STRING', qq/STRING/ X<qq>
2129 X<quote, double> X<"> X<"">, "STRING", qx/STRING/ X<qx> X<`> X<``>
2130 X<backtick>, `STRING`, qw/STRING/ X<qw> X<quote, list> X<quote, words>,
2131 tr/SEARCHLIST/REPLACEMENTLIST/cds X<tr> X<y> X<transliterate> X</c> X</d>
2132 X</s>, y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF X<here-doc> X<heredoc>
2133 X<here-document> X<<< << >>>, Double Quotes, Single Quotes, Backticks
2135 =item Gory details of parsing quoted constructs
2136 X<quote, gory details>
2138 Finding the end, Interpolation X<interpolation>, C<<<'EOF'>, C<m''>, the
2139 pattern of C<s'''>, C<''>, C<q//>, C<tr'''>, C<y'''>, the replacement of
2140 C<s'''>, C<tr///>, C<y///>, C<"">, C<``>, C<qq//>, C<qx//>, C<< <file*glob>
2141 >>, C<<<"EOF">, the replacement of C<s///>, C<RE> in C<?RE?>, C</RE/>,
2142 C<m/RE/>, C<s/RE/foo/>,, parsing regular expressions X<regexp, parse>,
2143 Optimization of regular expressions X<regexp, optimization>
2146 X<operator, i/o> X<operator, io> X<io> X<while> X<filehandle>
2149 =item Constant Folding
2150 X<constant folding> X<folding>
2155 =item Bitwise String Operators
2156 X<operator, bitwise, string>
2158 =item Integer Arithmetic
2161 =item Floating-point Arithmetic
2162 X<floating-point> X<floating point> X<float> X<real>
2164 =item Bigger Numbers
2165 X<number, arbitrary precision>
2171 =head2 perlsub - Perl subroutines
2181 =item Private Variables via my()
2182 X<my> X<variable, lexical> X<lexical> X<lexical variable> X<scope, lexical>
2183 X<lexical scope> X<attributes, my>
2185 =item Persistent Private Variables
2186 X<state> X<state variable> X<static> X<variable, persistent> X<variable,
2189 =item Temporary Values via local()
2190 X<local> X<scope, dynamic> X<dynamic scope> X<variable, local>
2191 X<variable, temporary>
2193 =item Lvalue subroutines
2194 X<lvalue> X<subroutine, lvalue>
2196 Lvalue subroutines are EXPERIMENTAL
2198 =item Passing Symbol Table Entries (typeglobs)
2201 =item When to Still Use local()
2202 X<local> X<variable, local>
2204 =item Pass by Reference
2205 X<pass by reference> X<pass-by-reference> X<reference>
2208 X<prototype> X<subroutine, prototype>
2210 =item Constant Functions
2213 =item Overriding Built-in Functions
2214 X<built-in> X<override> X<CORE> X<CORE::GLOBAL>
2217 X<autoloading> X<AUTOLOAD>
2219 =item Subroutine Attributes
2220 X<attribute> X<subroutine, attribute> X<attrs>
2228 =head2 perlfunc - Perl builtin functions
2236 =item Perl Functions by Category
2239 Functions for SCALARs or strings X<scalar> X<string> X<character>, Regular
2240 expressions and pattern matching X<regular expression> X<regex> X<regexp>,
2241 Numeric functions X<numeric> X<number> X<trigonometric> X<trigonometry>,
2242 Functions for real @ARRAYs X<array>, Functions for list data X<list>,
2243 Functions for real %HASHes X<hash>, Input and output functions X<I/O>
2244 X<input> X<output> X<dbm>, Functions for fixed length data or records,
2245 Functions for filehandles, files, or directories X<file> X<filehandle>
2246 X<directory> X<pipe> X<link> X<symlink>, Keywords related to the control
2247 flow of your Perl program X<control flow>, Keywords related to switch,
2248 Keywords related to scoping, Miscellaneous functions, Functions for
2249 processes and process groups X<process> X<pid> X<process id>, Keywords
2250 related to perl modules X<module>, Keywords related to classes and
2251 object-orientation X<object> X<class> X<package>, Low-level socket
2252 functions X<socket> X<sock>, System V interprocess communication functions
2253 X<IPC> X<System V> X<semaphore> X<shared memory> X<memory> X<message>,
2254 Fetching user and group info X<user> X<group> X<password> X<uid> X<gid>
2255 X<passwd> X</etc/passwd>, Fetching network info X<network> X<protocol>
2256 X<host> X<hostname> X<IP> X<address> X<service>, Time-related functions
2257 X<time> X<date>, Functions new in perl5 X<perl5>, Functions obsoleted in
2261 X<portability> X<Unix> X<portable>
2263 =item Alphabetical Listing of Perl Functions
2266 X<-r>X<-w>X<-x>X<-o>X<-R>X<-W>X<-X>X<-O>X<-e>X<-z>X<-s>X<-f>X<-d>X<-l>X<-p>
2267 X<-S>X<-b>X<-c>X<-t>X<-u>X<-g>X<-k>X<-T>X<-B>X<-M>X<-A>X<-C>, -I<X> EXPR,
2268 -I<X> DIRHANDLE, -I<X>, abs VALUE X<abs> X<absolute>, abs, accept
2269 NEWSOCKET,GENERICSOCKET X<accept>, alarm SECONDS X<alarm> X<SIGALRM>
2270 X<timer>, alarm, atan2 Y,X X<atan2> X<arctangent> X<tan> X<tangent>, bind
2271 SOCKET,NAME X<bind>, binmode FILEHANDLE, LAYER X<binmode> X<binary> X<text>
2272 X<DOS> X<Windows>, binmode FILEHANDLE, bless REF,CLASSNAME X<bless>, bless
2273 REF, break, caller EXPR X<caller> X<call stack> X<stack> X<stack trace>,
2274 caller, chdir EXPR X<chdir> X<cd> X<directory, change>, chdir FILEHANDLE,
2275 chdir DIRHANDLE, chdir, chmod LIST X<chmod> X<permission> X<mode>, chomp
2276 VARIABLE X<chomp> X<INPUT_RECORD_SEPARATOR> X<$/> X<newline> X<eol>, chomp(
2277 LIST ), chomp, chop VARIABLE X<chop>, chop( LIST ), chop, chown LIST
2278 X<chown> X<owner> X<user> X<group>, chr NUMBER X<chr> X<character> X<ASCII>
2279 X<Unicode>, chr, chroot FILENAME X<chroot> X<root>, chroot, close
2280 FILEHANDLE X<close>, close, closedir DIRHANDLE X<closedir>, connect
2281 SOCKET,NAME X<connect>, continue BLOCK X<continue>, continue, cos EXPR
2282 X<cos> X<cosine> X<acos> X<arccosine>, cos, crypt PLAINTEXT,SALT X<crypt>
2283 X<digest> X<hash> X<salt> X<plaintext> X<password> X<decrypt>
2284 X<cryptography> X<passwd> X<encrypt>, dbmclose HASH X<dbmclose>, dbmopen
2285 HASH,DBNAME,MASK X<dbmopen> X<dbm> X<ndbm> X<sdbm> X<gdbm>, defined EXPR
2286 X<defined> X<undef> X<undefined>, defined, delete EXPR X<delete>, die LIST
2287 X<die> X<throw> X<exception> X<raise> X<$@> X<abort>, do BLOCK X<do>
2288 X<block>, do SUBROUTINE(LIST) X<do>, do EXPR X<do>, dump LABEL X<dump>
2289 X<core> X<undump>, dump, each HASH X<each> X<hash, iterator>, each ARRAY
2290 X<array, iterator>, eof FILEHANDLE X<eof> X<end of file> X<end-of-file>,
2291 eof (), eof, eval EXPR X<eval> X<try> X<catch> X<evaluate> X<parse>
2292 X<execute> X<error, handling> X<exception, handling>, eval BLOCK, eval,
2293 exec LIST X<exec> X<execute>, exec PROGRAM LIST, exists EXPR X<exists>
2294 X<autovivification>, exit EXPR X<exit> X<terminate> X<abort>, exit, exp
2295 EXPR X<exp> X<exponential> X<antilog> X<antilogarithm> X<e>, exp, fcntl
2296 FILEHANDLE,FUNCTION,SCALAR X<fcntl>, fileno FILEHANDLE X<fileno>, flock
2297 FILEHANDLE,OPERATION X<flock> X<lock> X<locking>, fork X<fork> X<child>
2298 X<parent>, format X<format>, formline PICTURE,LIST X<formline>, getc
2299 FILEHANDLE X<getc> X<getchar> X<character> X<file, read>, getc, getlogin
2300 X<getlogin> X<login>, getpeername SOCKET X<getpeername> X<peer>, getpgrp
2301 PID X<getpgrp> X<group>, getppid X<getppid> X<parent> X<pid>, getpriority
2302 WHICH,WHO X<getpriority> X<priority> X<nice>, getpwnam NAME X<getpwnam>
2303 X<getgrnam> X<gethostbyname> X<getnetbyname> X<getprotobyname> X<getpwuid>
2304 X<getgrgid> X<getservbyname> X<gethostbyaddr> X<getnetbyaddr>
2305 X<getprotobynumber> X<getservbyport> X<getpwent> X<getgrent> X<gethostent>
2306 X<getnetent> X<getprotoent> X<getservent> X<setpwent> X<setgrent>
2307 X<sethostent> X<setnetent> X<setprotoent> X<setservent> X<endpwent>
2308 X<endgrent> X<endhostent> X<endnetent> X<endprotoent> X<endservent>,
2309 getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname NAME,
2310 getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr
2311 ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
2312 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
2313 getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent
2314 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
2315 endhostent, endnetent, endprotoent, endservent, getsockname SOCKET
2316 X<getsockname>, getsockopt SOCKET,LEVEL,OPTNAME X<getsockopt>, glob EXPR
2317 X<glob> X<wildcard> X<filename, expansion> X<expand>, glob, gmtime EXPR
2318 X<gmtime> X<UTC> X<Greenwich>, gmtime, goto LABEL X<goto> X<jump> X<jmp>,
2319 goto EXPR, goto &NAME, grep BLOCK LIST X<grep>, grep EXPR,LIST, hex EXPR
2320 X<hex> X<hexadecimal>, hex, import LIST X<import>, index
2321 STR,SUBSTR,POSITION X<index> X<indexOf> X<InStr>, index STR,SUBSTR, int
2322 EXPR X<int> X<integer> X<truncate> X<trunc> X<floor>, int, ioctl
2323 FILEHANDLE,FUNCTION,SCALAR X<ioctl>, join EXPR,LIST X<join>, keys HASH
2324 X<keys> X<key>, keys ARRAY, kill SIGNAL, LIST X<kill> X<signal>, last LABEL
2325 X<last> X<break>, last, lc EXPR X<lc> X<lowercase>, lc, lcfirst EXPR
2326 X<lcfirst> X<lowercase>, lcfirst, length EXPR X<length> X<size>, length,
2327 link OLDFILE,NEWFILE X<link>, listen SOCKET,QUEUESIZE X<listen>, local EXPR
2328 X<local>, localtime EXPR X<localtime> X<ctime>, localtime, lock THING
2329 X<lock>, log EXPR X<log> X<logarithm> X<e> X<ln> X<base>, log, lstat EXPR
2330 X<lstat>, lstat, m//, map BLOCK LIST X<map>, map EXPR,LIST, mkdir
2331 FILENAME,MASK X<mkdir> X<md> X<directory, create>, mkdir FILENAME, mkdir,
2332 msgctl ID,CMD,ARG X<msgctl>, msgget KEY,FLAGS X<msgget>, msgrcv
2333 ID,VAR,SIZE,TYPE,FLAGS X<msgrcv>, msgsnd ID,MSG,FLAGS X<msgsnd>, my EXPR
2334 X<my>, my TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL
2335 X<next> X<continue>, next, no Module VERSION LIST X<no>, no Module VERSION,
2336 no Module LIST, no Module, no VERSION, oct EXPR X<oct> X<octal> X<hex>
2337 X<hexadecimal> X<binary> X<bin>, oct, open FILEHANDLE,EXPR X<open> X<pipe>
2338 X<file, open> X<fopen>, open FILEHANDLE,MODE,EXPR, open
2339 FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE,MODE,REFERENCE, open FILEHANDLE,
2340 opendir DIRHANDLE,EXPR X<opendir>, ord EXPR X<ord> X<encoding>, ord, our
2341 EXPR X<our> X<global>, our TYPE EXPR, our EXPR : ATTRS, our TYPE EXPR :
2342 ATTRS, pack TEMPLATE,LIST X<pack>, package NAMESPACE X<package> X<module>
2343 X<namespace>, package, pipe READHANDLE,WRITEHANDLE X<pipe>, pop ARRAY
2344 X<pop> X<stack>, pop, pos SCALAR X<pos> X<match, position>, pos, print
2345 FILEHANDLE LIST X<print>, print LIST, print, printf FILEHANDLE FORMAT, LIST
2346 X<printf>, printf FORMAT, LIST, prototype FUNCTION X<prototype>, push
2347 ARRAY,LIST X<push> X<stack>, q/STRING/, qq/STRING/, qx/STRING/, qw/STRING/,
2348 qr/STRING/, quotemeta EXPR X<quotemeta> X<metacharacter>, quotemeta, rand
2349 EXPR X<rand> X<random>, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET X<read>
2350 X<file, read>, read FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE X<readdir>,
2351 readline EXPR, readline X<readline> X<gets> X<fgets>, readlink EXPR
2352 X<readlink>, readlink, readpipe EXPR, readpipe X<readpipe>, recv
2353 SOCKET,SCALAR,LENGTH,FLAGS X<recv>, redo LABEL X<redo>, redo, ref EXPR
2354 X<ref> X<reference>, ref, rename OLDNAME,NEWNAME X<rename> X<move> X<mv>
2355 X<ren>, require VERSION X<require>, require EXPR, require, reset EXPR
2356 X<reset>, reset, return EXPR X<return>, return, reverse LIST X<reverse>
2357 X<rev> X<invert>, rewinddir DIRHANDLE X<rewinddir>, rindex
2358 STR,SUBSTR,POSITION X<rindex>, rindex STR,SUBSTR, rmdir FILENAME X<rmdir>
2359 X<rd> X<directory, remove>, rmdir, s///, say FILEHANDLE LIST X<say>, say
2360 LIST, say, scalar EXPR X<scalar> X<context>, seek
2361 FILEHANDLE,POSITION,WHENCE X<seek> X<fseek> X<filehandle, position>,
2362 seekdir DIRHANDLE,POS X<seekdir>, select FILEHANDLE X<select> X<filehandle,
2363 default>, select, select RBITS,WBITS,EBITS,TIMEOUT X<select>, semctl
2364 ID,SEMNUM,CMD,ARG X<semctl>, semget KEY,NSEMS,FLAGS X<semget>, semop
2365 KEY,OPSTRING X<semop>, send SOCKET,MSG,FLAGS,TO X<send>, send
2366 SOCKET,MSG,FLAGS, setpgrp PID,PGRP X<setpgrp> X<group>, setpriority
2367 WHICH,WHO,PRIORITY X<setpriority> X<priority> X<nice> X<renice>, setsockopt
2368 SOCKET,LEVEL,OPTNAME,OPTVAL X<setsockopt>, shift ARRAY X<shift>, shift,
2369 shmctl ID,CMD,ARG X<shmctl>, shmget KEY,SIZE,FLAGS X<shmget>, shmread
2370 ID,VAR,POS,SIZE X<shmread> X<shmwrite>, shmwrite ID,STRING,POS,SIZE,
2371 shutdown SOCKET,HOW X<shutdown>, sin EXPR X<sin> X<sine> X<asin>
2372 X<arcsine>, sin, sleep EXPR X<sleep> X<pause>, sleep, socket
2373 SOCKET,DOMAIN,TYPE,PROTOCOL X<socket>, socketpair
2374 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL X<socketpair>, sort SUBNAME LIST
2375 X<sort> X<qsort> X<quicksort> X<mergesort>, sort BLOCK LIST, sort LIST,
2376 splice ARRAY,OFFSET,LENGTH,LIST X<splice>, splice ARRAY,OFFSET,LENGTH,
2377 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT X<split>,
2378 split /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST
2379 X<sprintf>, format parameter index, flags, vector flag, (minimum) width,
2380 precision, or maximum width X<precision>, size, order of arguments, sqrt
2381 EXPR X<sqrt> X<root> X<square root>, sqrt, srand EXPR X<srand> X<seed>
2382 X<randseed>, srand, stat FILEHANDLE X<stat> X<file, status> X<ctime>, stat
2383 EXPR, stat DIRHANDLE, stat, state EXPR X<state>, state TYPE EXPR, state
2384 EXPR : ATTRS, state TYPE EXPR : ATTRS, study SCALAR X<study>, study, sub
2385 NAME BLOCK X<sub>, sub NAME (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub NAME
2386 (PROTO) : ATTRS BLOCK, substr EXPR,OFFSET,LENGTH,REPLACEMENT X<substr>
2387 X<substring> X<mid> X<left> X<right>, substr EXPR,OFFSET,LENGTH, substr
2388 EXPR,OFFSET, symlink OLDFILE,NEWFILE X<symlink> X<link> X<symbolic link>
2389 X<link, symbolic>, syscall NUMBER, LIST X<syscall> X<system call>, sysopen
2390 FILEHANDLE,FILENAME,MODE X<sysopen>, sysopen
2391 FILEHANDLE,FILENAME,MODE,PERMS, sysread FILEHANDLE,SCALAR,LENGTH,OFFSET
2392 X<sysread>, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
2393 FILEHANDLE,POSITION,WHENCE X<sysseek> X<lseek>, system LIST X<system>
2394 X<shell>, system PROGRAM LIST, syswrite FILEHANDLE,SCALAR,LENGTH,OFFSET
2395 X<syswrite>, syswrite FILEHANDLE,SCALAR,LENGTH, syswrite FILEHANDLE,SCALAR,
2396 tell FILEHANDLE X<tell>, tell, telldir DIRHANDLE X<telldir>, tie
2397 VARIABLE,CLASSNAME,LIST X<tie>, tied VARIABLE X<tied>, time X<time>
2398 X<epoch>, times X<times>, tr///, truncate FILEHANDLE,LENGTH X<truncate>,
2399 truncate EXPR,LENGTH, uc EXPR X<uc> X<uppercase> X<toupper>, uc, ucfirst
2400 EXPR X<ucfirst> X<uppercase>, ucfirst, umask EXPR X<umask>, umask, undef
2401 EXPR X<undef> X<undefine>, undef, unlink LIST X<unlink> X<delete> X<remove>
2402 X<rm> X<del>, unlink, unpack TEMPLATE,EXPR X<unpack>, unpack TEMPLATE,
2403 untie VARIABLE X<untie>, unshift ARRAY,LIST X<unshift>, use Module VERSION
2404 LIST X<use> X<module> X<import>, use Module VERSION, use Module LIST, use
2405 Module, use VERSION, utime LIST X<utime>, values HASH X<values>, values
2406 ARRAY, vec EXPR,OFFSET,BITS X<vec> X<bit> X<bit vector>, wait X<wait>,
2407 waitpid PID,FLAGS X<waitpid>, wantarray X<wantarray> X<context>, warn LIST
2408 X<warn> X<warning> X<STDERR>, write FILEHANDLE X<write>, write EXPR, write,
2415 =head2 perlopentut - tutorial on opening things in Perl
2421 =item Open E<agrave> la shell
2427 =item Indirect Filehandles
2431 =item The Minus File
2433 =item Mixing Reads and Writes
2439 =item Open E<agrave> la C
2443 =item Permissions E<agrave> la mode
2447 =item Obscure Open Tricks
2451 =item Re-Opening Files (dups)
2453 =item Dispelling the Dweomer
2455 =item Paths as Opens
2457 =item Single Argument Open
2459 =item Playing with STDIN and STDOUT
2463 =item Other I/O Issues
2467 =item Opening Non-File Files
2469 =item Opening Named Pipes
2471 =item Opening Sockets
2483 =item AUTHOR and COPYRIGHT
2489 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
2495 =item The Basic Principle
2499 =item Packing Numbers
2505 =item Unpacking a Stack Frame
2507 =item How to Eat an Egg on a Net
2509 =item Byte-order modifiers
2511 =item Floating point Numbers
2515 =item Exotic Templates
2527 =item Another Portable Binary Encoding
2531 =item Template Grouping
2533 =item Lengths and Widths
2537 =item String Lengths
2539 =item Dynamic Templates
2541 =item Counting Repetitions
2545 =item Packing and Unpacking C Structures
2549 =item The Alignment Pit
2551 =item Dealing with Endian-ness
2553 =item Alignment, Take 2
2555 =item Alignment, Take 3
2557 =item Pointers for How to Use Them
2563 =item Funnies Section
2569 =head2 perlpod - the Plain Old Documentation format
2577 =item Ordinary Paragraph
2578 X<POD, ordinary paragraph>
2580 =item Verbatim Paragraph
2581 X<POD, verbatim paragraph> X<verbatim>
2583 =item Command Paragraph
2586 C<=head1 I<Heading Text>> X<=head1> X<=head2> X<=head3> X<=head4> X<head1>
2587 X<head2> X<head3> X<head4>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
2588 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>> X<=over>
2589 X<=item> X<=back> X<over> X<item> X<back>, C<=item I<stuff...>>, C<=back>,
2590 C<=cut> X<=cut> X<cut>, C<=pod> X<=pod> X<pod>, C<=begin I<formatname>>
2591 X<=begin> X<=end> X<=for> X<begin> X<end> X<for>, C<=end I<formatname>>,
2592 C<=for I<formatname> I<text...>>, C<=encoding I<encodingname>> X<=encoding>
2595 =item Formatting Codes
2596 X<POD, formatting code> X<formatting code>
2597 X<POD, interior sequence> X<interior sequence>
2599 C<IE<lt>textE<gt>> -- italic text X<I> X<< IZ<><> >> X<POD, formatting
2600 code, italic> X<italic>, C<BE<lt>textE<gt>> -- bold text X<B> X<< BZ<><> >>
2601 X<POD, formatting code, bold> X<bold>, C<CE<lt>codeE<gt>> -- code text X<C>
2602 X<< CZ<><> >> X<POD, formatting code, code> X<code>, C<LE<lt>nameE<gt>> --
2603 a hyperlink X<L> X<< LZ<><> >> X<POD, formatting code, hyperlink>
2604 X<hyperlink>, C<EE<lt>escapeE<gt>> -- a character escape X<E> X<< EZ<><> >>
2605 X<POD, formatting code, escape> X<escape>, C<FE<lt>filenameE<gt>> -- used
2606 for filenames X<F> X<< FZ<><> >> X<POD, formatting code, filename>
2607 X<filename>, C<SE<lt>textE<gt>> -- text contains non-breaking spaces X<S>
2608 X<< SZ<><> >> X<POD, formatting code, non-breaking space> X<non-breaking
2609 space>, C<XE<lt>topic nameE<gt>> -- an index entry X<X> X<< XZ<><> >>
2610 X<POD, formatting code, index entry> X<index entry>, C<ZE<lt>E<gt>> -- a
2611 null (zero-effect) formatting code X<Z> X<< ZZ<><> >> X<POD, formatting
2617 =item Embedding Pods in Perl Modules
2620 =item Hints for Writing Pod
2622 X<podchecker> X<POD, validating>
2632 =head2 perlpodspec - Plain Old Documentation: format specification and
2639 =item Pod Definitions
2643 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
2644 "=back", "=begin formatname", "=end formatname", "=for formatname text...",
2645 "=encoding encodingname"
2647 =item Pod Formatting Codes
2649 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2650 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
2651 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
2652 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
2653 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
2654 contains non-breaking spaces
2656 =item Notes on Implementing Pod Processors
2658 =item About LE<lt>...E<gt> Codes
2660 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
2662 =item About =over...=back Regions
2664 =item About Data Paragraphs and "=begin/=end" Regions
2672 =head2 perlrun - how to execute the Perl interpreter
2682 =item #! and quoting on non-Unix systems
2685 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
2687 =item Location of Perl
2688 X<perl, location of interpreter>
2690 =item Command Switches
2691 X<perl, command switches> X<command switches>
2693 B<-0>[I<octal/hexadecimal>] X<-0> X<$/>, B<-a> X<-a> X<autosplit>, B<-C
2694 [I<number/list>]> X<-C>, B<-c> X<-c>, B<-d> X<-d> X<-dt>, B<-dt>,
2695 B<-d:>I<foo[=bar,baz]> X<-d> X<-dt>, B<-dt:>I<foo[=bar,baz]>,
2696 B<-D>I<letters> X<-D> X<DEBUGGING> X<-DDEBUGGING>, B<-D>I<number>, B<-e>
2697 I<commandline> X<-e>, B<-E> I<commandline> X<-E>, B<-f> X<-f>,
2698 B<-F>I<pattern> X<-F>, B<-h> X<-h>, B<-i>[I<extension>] X<-i> X<in-place>,
2699 B<-I>I<directory> X<-I> X<@INC>, B<-l>[I<octnum>] X<-l> X<$/> X<$\>,
2700 B<-m>[B<->]I<module> X<-m> X<-M>, B<-M>[B<->]I<module>,
2701 B<-M>[B<->]I<'module ...'>, B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>
2702 X<-n>, B<-p> X<-p>, B<-s> X<-s>, B<-S> X<-S>, B<-t> X<-t>, B<-T> X<-T>,
2703 B<-u> X<-u>, B<-U> X<-U>, B<-v> X<-v>, B<-V> X<-V>, B<-V:>I<configvar>,
2704 B<-w> X<-w>, B<-W> X<-W>, B<-X> X<-X>, B<-x> X<-x>, B<-x>I<directory>
2709 X<perl, environment variables>
2711 HOME X<HOME>, LOGDIR X<LOGDIR>, PATH X<PATH>, PERL5LIB X<PERL5LIB>,
2712 PERL5OPT X<PERL5OPT>, PERLIO X<PERLIO>, :bytes X<:bytes>, :crlf X<:crlf>,
2713 :mmap X<:mmap>, :perlio X<:perlio>, :pop X<:pop>, :raw X<:raw>, :stdio
2714 X<:stdio>, :unix X<:unix>, :utf8 X<:utf8>, :win32 X<:win32>, PERLIO_DEBUG
2715 X<PERLIO_DEBUG>, PERLLIB X<PERLLIB>, PERL5DB X<PERL5DB>, PERL5DB_THREADED
2716 X<PERL5DB_THREADED>, PERL5SHELL (specific to the Win32 port) X<PERL5SHELL>,
2717 PERL_ALLOW_NON_IFS_LSP (specific to the Win32 port)
2718 X<PERL_ALLOW_NON_IFS_LSP>, PERL_DEBUG_MSTATS X<PERL_DEBUG_MSTATS>,
2719 PERL_DESTRUCT_LEVEL X<PERL_DESTRUCT_LEVEL>, PERL_DL_NONLAZY
2720 X<PERL_DL_NONLAZY>, PERL_ENCODING X<PERL_ENCODING>, PERL_HASH_SEED
2721 X<PERL_HASH_SEED>, PERL_HASH_SEED_DEBUG X<PERL_HASH_SEED_DEBUG>, PERL_ROOT
2722 (specific to the VMS port) X<PERL_ROOT>, PERL_SIGNALS X<PERL_SIGNALS>,
2723 PERL_UNICODE X<PERL_UNICODE>, SYS$LOGIN (specific to the VMS port)
2728 =head2 perldiag - various Perl diagnostics
2738 =head2 perllexwarn - Perl Lexical Warnings
2746 =item Default Warnings and Optional Warnings
2748 =item What's wrong with B<-w> and C<$^W>
2750 =item Controlling Warnings from the Command Line
2752 B<-w> X<-w>, B<-W> X<-W>, B<-X> X<-X>
2754 =item Backward Compatibility
2756 =item Category Hierarchy
2757 X<warning, categories>
2759 =item Fatal Warnings
2762 =item Reporting Warnings from a Module
2763 X<warning, reporting> X<warning, registering>
2773 =head2 perldebug - Perl debugging
2779 =item The Perl Debugger
2783 =item Calling the debugger
2785 perl -d program_name, perl -d -e 0, perl -d:Ptkdb program_name, perl -dt
2786 threaded_program_name
2788 =item Debugger Commands
2790 h X<debugger command, h>, h [command], h h, p expr X<debugger command, p>,
2791 x [maxdepth] expr X<debugger command, x>, V [pkg [vars]] X<debugger
2792 command, V>, X [vars] X<debugger command, X>, y [level [vars]] X<debugger
2793 command, y>, T X<debugger command, T> X<backtrace> X<stack, backtrace>, s
2794 [expr] X<debugger command, s> X<step>, n [expr] X<debugger command, n>, r
2795 X<debugger command, r>, <CR>, c [line|sub] X<debugger command, c>, l
2796 X<debugger command, l>, l min+incr, l min-max, l line, l subname, -
2797 X<debugger command, ->, v [line] X<debugger command, v>, . X<debugger
2798 command, .>, f filename X<debugger command, f>, /pattern/, ?pattern?, L
2799 [abw] X<debugger command, L>, S [[!]regex] X<debugger command, S>, t
2800 X<debugger command, t>, t expr X<debugger command, t>, b X<breakpoint>
2801 X<debugger command, b>, b [line] [condition] X<breakpoint> X<debugger
2802 command, b>, b subname [condition] X<breakpoint> X<debugger command, b>, b
2803 postpone subname [condition] X<breakpoint> X<debugger command, b>, b load
2804 filename X<breakpoint> X<debugger command, b>, b compile subname
2805 X<breakpoint> X<debugger command, b>, B line X<breakpoint> X<debugger
2806 command, B>, B * X<breakpoint> X<debugger command, B>, a [line] command
2807 X<debugger command, a>, A line X<debugger command, A>, A * X<debugger
2808 command, A>, w expr X<debugger command, w>, W expr X<debugger command, W>,
2809 W * X<debugger command, W>, o X<debugger command, o>, o booloption ...
2810 X<debugger command, o>, o anyoption? ... X<debugger command, o>, o
2811 option=value ... X<debugger command, o>, < ? X<< debugger command, < >>, <
2812 [ command ] X<< debugger command, < >>, < * X<< debugger command, < >>, <<
2813 command X<< debugger command, << >>, > ? X<< debugger command, > >>, >
2814 command X<< debugger command, > >>, > * X<< debugger command, > >>, >>
2815 command X<<< debugger command, >> >>>, { ? X<debugger command, {>, { [
2816 command ], { * X<debugger command, {>, {{ command X<debugger command, {{>,
2817 ! number X<debugger command, !>, ! -number X<debugger command, !>, !
2818 pattern X<debugger command, !>, !! cmd X<debugger command, !!>, source file
2819 X<debugger command, source>, H -number X<debugger command, H>, q or ^D
2820 X<debugger command, q> X<debugger command, ^D>, R X<debugger command, R>,
2821 |dbcmd X<debugger command, |>, ||dbcmd X<debugger command, ||>, command, m
2822 expr X<debugger command, m>, M X<debugger command, M>, man [manpage]
2823 X<debugger command, man>
2825 =item Configurable Options
2827 C<recallCommand>, C<ShellBang> X<debugger option, recallCommand> X<debugger
2828 option, ShellBang>, C<pager> X<debugger option, pager>, C<tkRunning>
2829 X<debugger option, tkRunning>, C<signalLevel>, C<warnLevel>, C<dieLevel>
2830 X<debugger option, signalLevel> X<debugger option, warnLevel> X<debugger
2831 option, dieLevel>, C<AutoTrace> X<debugger option, AutoTrace>, C<LineInfo>
2832 X<debugger option, LineInfo>, C<inhibit_exit> X<debugger option,
2833 inhibit_exit>, C<PrintRet> X<debugger option, PrintRet>, C<ornaments>
2834 X<debugger option, ornaments>, C<frame> X<debugger option, frame>,
2835 C<maxTraceLen> X<debugger option, maxTraceLen>, C<windowSize> X<debugger
2836 option, windowSize>, C<arrayDepth>, C<hashDepth> X<debugger option,
2837 arrayDepth> X<debugger option, hashDepth>, C<dumpDepth> X<debugger option,
2838 dumpDepth>, C<compactDump>, C<veryCompact> X<debugger option, compactDump>
2839 X<debugger option, veryCompact>, C<globPrint> X<debugger option,
2840 globPrint>, C<DumpDBFiles> X<debugger option, DumpDBFiles>, C<DumpPackages>
2841 X<debugger option, DumpPackages>, C<DumpReused> X<debugger option,
2842 DumpReused>, C<quote>, C<HighBit>, C<undefPrint> X<debugger option, quote>
2843 X<debugger option, HighBit> X<debugger option, undefPrint>, C<UsageOnly>
2844 X<debugger option, UsageOnly>, C<TTY> X<debugger option, TTY>, C<noTTY>
2845 X<debugger option, noTTY>, C<ReadLine> X<debugger option, ReadLine>,
2846 C<NonStop> X<debugger option, NonStop>
2848 =item Debugger input/output
2850 Prompt, Multiline commands, Stack backtrace X<backtrace> X<stack,
2851 backtrace>, Line Listing Format, Frame listing
2853 =item Debugging compile-time statements
2855 =item Debugger Customization
2857 =item Readline Support
2859 =item Editor Support for Debugging
2861 =item The Perl Profiler
2862 X<profile> X<profiling> X<profiler>
2866 =item Debugging regular expressions
2867 X<regular expression, debugging>
2868 X<regex, debugging> X<regexp, debugging>
2870 =item Debugging memory usage
2879 =head2 perlvar - Perl predefined variables
2887 =item Predefined Names
2889 $ARG, $_ X<$_> X<$ARG>, $a, $b X<$a> X<$b>, $<I<digits>> X<$1> X<$2> X<$3>,
2890 $MATCH, $& X<$&> X<$MATCH>, ${^MATCH} X<${^MATCH}>, $PREMATCH, $` X<$`>
2891 X<$PREMATCH>, ${^PREMATCH} X<${^PREMATCH}>, $POSTMATCH, $' X<$'>
2892 X<$POSTMATCH>, ${^POSTMATCH} X<${^POSTMATCH}>, $LAST_PAREN_MATCH, $+ X<$+>
2893 X<$LAST_PAREN_MATCH>, $LAST_SUBMATCH_RESULT, $^N X<$^N>, @LAST_MATCH_END,
2894 @+ X<@+> X<@LAST_MATCH_END>, %+ X<%+>, HANDLE->input_line_number(EXPR),
2895 $INPUT_LINE_NUMBER, $NR, $. X<$.> X<$NR> X<$INPUT_LINE_NUMBER> X<line
2896 number>, IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR,
2897 $RS, $/ X<$/> X<$RS> X<$INPUT_RECORD_SEPARATOR>, HANDLE->autoflush(EXPR),
2898 $OUTPUT_AUTOFLUSH, $| X<$|> X<autoflush> X<flush> X<$OUTPUT_AUTOFLUSH>,
2899 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,
2900 X<$,> X<$OFS> X<$OUTPUT_FIELD_SEPARATOR>,
2901 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
2902 $\ X<$\> X<$ORS> X<$OUTPUT_RECORD_SEPARATOR>, $LIST_SEPARATOR, $" X<$">
2903 X<$LIST_SEPARATOR>, $SUBSCRIPT_SEPARATOR, $SUBSEP, $; X<$;> X<$SUBSEP>
2904 X<SUBSCRIPT_SEPARATOR>, HANDLE->format_page_number(EXPR),
2905 $FORMAT_PAGE_NUMBER, $% X<$%> X<$FORMAT_PAGE_NUMBER>,
2906 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $= X<$=>
2907 X<$FORMAT_LINES_PER_PAGE>, HANDLE->format_lines_left(EXPR),
2908 $FORMAT_LINES_LEFT, $- X<$-> X<$FORMAT_LINES_LEFT>, @LAST_MATCH_START, @-
2909 X<@-> X<@LAST_MATCH_START>, C<$`> is the same as C<substr($var, 0, $-[0])>,
2910 C<$&> is the same as C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the
2911 same as C<substr($var, $+[0])>, C<$1> is the same as C<substr($var, $-[1],
2912 $+[1] - $-[1])>, C<$2> is the same as C<substr($var, $-[2], $+[2] -
2913 $-[2])>, C<$3> is the same as C<substr($var, $-[3], $+[3] - $-[3])>, %-
2914 X<%->, HANDLE->format_name(EXPR), $FORMAT_NAME, $~ X<$~> X<$FORMAT_NAME>,
2915 HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^ X<$^>
2916 X<$FORMAT_TOP_NAME>, IO::Handle->format_line_break_characters EXPR,
2917 $FORMAT_LINE_BREAK_CHARACTERS, $: X<$:> X<FORMAT_LINE_BREAK_CHARACTERS>,
2918 IO::Handle->format_formfeed EXPR, $FORMAT_FORMFEED, $^L X<$^L>
2919 X<$FORMAT_FORMFEED>, $ACCUMULATOR, $^A X<$^A> X<$ACCUMULATOR>,
2920 $CHILD_ERROR, $? X<$?> X<$CHILD_ERROR>, ${^CHILD_ERROR_NATIVE}
2921 X<$^CHILD_ERROR_NATIVE>, ${^ENCODING} X<$^ENCODING>, $OS_ERROR, $ERRNO, $!
2922 X<$!> X<$ERRNO> X<$OS_ERROR>, %OS_ERROR, %ERRNO, %! X<%!>,
2923 $EXTENDED_OS_ERROR, $^E X<$^E> X<$EXTENDED_OS_ERROR>, $EVAL_ERROR, $@ X<$@>
2924 X<$EVAL_ERROR>, $PROCESS_ID, $PID, $$ X<$$> X<$PID> X<$PROCESS_ID>,
2925 $REAL_USER_ID, $UID, $< X<< $< >> X<$UID> X<$REAL_USER_ID>,
2926 $EFFECTIVE_USER_ID, $EUID, $> X<< $> >> X<$EUID> X<$EFFECTIVE_USER_ID>,
2927 $REAL_GROUP_ID, $GID, $( X<$(> X<$GID> X<$REAL_GROUP_ID>,
2928 $EFFECTIVE_GROUP_ID, $EGID, $) X<$)> X<$EGID> X<$EFFECTIVE_GROUP_ID>,
2929 $PROGRAM_NAME, $0 X<$0> X<$PROGRAM_NAME>, $[ X<$[>, $] X<$]>, $COMPILING,
2930 $^C X<$^C> X<$COMPILING>, $DEBUGGING, $^D X<$^D> X<$DEBUGGING>,
2931 ${^RE_DEBUG_FLAGS}, ${^RE_TRIE_MAXBUF}, $SYSTEM_FD_MAX, $^F X<$^F>
2932 X<$SYSTEM_FD_MAX>, $^H, %^H, $INPLACE_EDIT, $^I X<$^I> X<$INPLACE_EDIT>,
2933 $^M X<$^M>, $OSNAME, $^O X<$^O> X<$OSNAME>, ${^OPEN}, $PERLDB, $^P X<$^P>
2934 X<$PERLDB>, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80, 0x100, 0x200,
2935 0x400, $LAST_REGEXP_CODE_RESULT, $^R X<$^R> X<$LAST_REGEXP_CODE_RESULT>,
2936 $EXCEPTIONS_BEING_CAUGHT, $^S X<$^S> X<$EXCEPTIONS_BEING_CAUGHT>,
2937 $BASETIME, $^T X<$^T> X<$BASETIME>, ${^TAINT}, ${^UNICODE}, ${^UTF8CACHE},
2938 ${^UTF8LOCALE}, $PERL_VERSION, $^V X<$^V> X<$PERL_VERSION>, $WARNING, $^W
2939 X<$^W> X<$WARNING>, ${^WARNING_BITS}, ${^WIN32_SLOPPY_STAT},
2940 $EXECUTABLE_NAME, $^X X<$^X> X<$EXECUTABLE_NAME>, ARGV X<ARGV>, $ARGV
2941 X<$ARGV>, @ARGV X<@ARGV>, ARGVOUT X<ARGVOUT>, @F X<@F>, @INC X<@INC>, @ARG,
2942 @_ X<@_> X<@ARG>, %INC X<%INC>, %ENV, $ENV{expr} X<%ENV>, %SIG, $SIG{expr}
2945 =item Error Indicators
2946 X<error> X<exception>
2948 =item Technical Note on the Syntax of Variable Names
2956 =head2 perlre - Perl regular expressions
2966 m X</m> X<regex, multiline> X<regexp, multiline> X<regular expression,
2967 multiline>, s X</s> X<regex, single-line> X<regexp, single-line> X<regular
2968 expression, single-line>, i X</i> X<regex, case-insensitive> X<regexp,
2969 case-insensitive> X<regular expression, case-insensitive>, x X</x>, p X</p>
2970 X<regex, preserve> X<regexp, preserve>, g and c X</g> X</c>
2972 =item Regular Expressions
2974 [1], [2], [3], [1], [2], [3], C<$>, C<+> C<< < >> C<=> C<< > >> C<|> C<~>,
2975 C<^> C<`>, cntrl X<cntrl>, graph X<graph>, print X<print>, punct X<punct>,
2978 =item Extended Patterns
2980 C<(?#text)> X<(?#)>, C<(?pimsx-imsx)> X<(?)>, C<(?:pattern)> X<(?:)>,
2981 C<(?imsx-imsx:pattern)>, C<(?|pattern)> X<(?|)> X<Branch reset>,
2982 Look-Around Assertions X<look-around assertion> X<lookaround assertion>
2983 X<look-around> X<lookaround>, C<(?=pattern)> X<(?=)> X<look-ahead,
2984 positive> X<lookahead, positive>, C<(?!pattern)> X<(?!)> X<look-ahead,
2985 negative> X<lookahead, negative>, C<(?<=pattern)> C<\K> X<(?<=)>
2986 X<look-behind, positive> X<lookbehind, positive> X<\K>, C<(?<!pattern)>
2987 X<(?<!)> X<look-behind, negative> X<lookbehind, negative>,
2988 C<(?'NAME'pattern)>, C<< (?<NAME>pattern) >> X<< (?<NAME>) >> X<(?'NAME')>
2989 X<named capture> X<capture>, C<< \k<NAME> >>, C<< \k'NAME' >>, C<(?{ code
2990 })> X<(?{})> X<regex, code in> X<regexp, code in> X<regular expression,
2991 code in>, C<(??{ code })> X<(??{})> X<regex, postponed> X<regexp,
2992 postponed> X<regular expression, postponed>, C<(?PARNO)> C<(?-PARNO)>
2993 C<(?+PARNO)> C<(?R)> C<(?0)> X<(?PARNO)> X<(?1)> X<(?R)> X<(?0)> X<(?-1)>
2994 X<(?+1)> X<(?-PARNO)> X<(?+PARNO)> X<regex, recursive> X<regexp, recursive>
2995 X<regular expression, recursive> X<regex, relative recursion>, C<(?&NAME)>
2996 X<(?&NAME)>, C<(?(condition)yes-pattern|no-pattern)> X<(?()>,
2997 C<(?(condition)yes-pattern)>, (1) (2) .., (<NAME>) ('NAME'), (?{ CODE }),
2998 (R), (R1) (R2) .., (R&NAME), (DEFINE), C<< (?>pattern) >> X<backtrack>
2999 X<backtracking> X<atomic> X<possessive>
3001 =item Special Backtracking Control Verbs
3003 Verbs that take an argument, C<(*PRUNE)> C<(*PRUNE:NAME)> X<(*PRUNE)>
3004 X<(*PRUNE:NAME)>, C<(*SKIP)> C<(*SKIP:NAME)> X<(*SKIP)>, C<(*MARK:NAME)>
3005 C<(*:NAME)> X<(*MARK)> C<(*MARK:NAME)> C<(*:NAME)>, C<(*THEN)>
3006 C<(*THEN:NAME)>, C<(*COMMIT)> X<(*COMMIT)>, Verbs without an argument,
3007 C<(*FAIL)> C<(*F)> X<(*FAIL)> X<(*F)>, C<(*ACCEPT)> X<(*ACCEPT)>
3010 X<backtrack> X<backtracking>
3012 =item Version 8 Regular Expressions
3013 X<regular expression, version 8> X<regex, version 8> X<regexp, version 8>
3015 =item Warning on \1 Instead of $1
3017 =item Repeated Patterns Matching a Zero-length Substring
3019 =item Combining RE Pieces
3021 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
3022 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
3023 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>, C<(?PARNO)>,
3024 C<(?(condition)yes-pattern|no-pattern)>
3026 =item Creating Custom RE Engines
3030 =item PCRE/Python Support
3032 C<< (?PE<lt>NAMEE<gt>pattern) >>, C<< (?P=NAME) >>, C<< (?P>NAME) >>
3040 =head2 perlrebackslash - Perl Regular Expression Backslash Sequences and
3053 =item All the sequences and escapes
3055 =item Character Escapes
3061 =item Character classes
3067 \A, \z, \Z, \G, \b, \B
3077 =head2 perlrecharclass - Perl Regular Expression Character Classes
3087 =item Backslashed sequences
3091 =item Bracketed Character Classes
3093 cntrl, graph, print, punct
3095 =item Locale, Unicode and UTF-8
3101 =head2 perlreref - Perl Regular Expressions Reference
3113 =item ESCAPE SEQUENCES
3115 =item CHARACTER CLASSES
3121 =item EXTENDED CONSTRUCTS
3139 =head2 perlref - Perl references and nested data structures
3149 =item Making References
3150 X<reference, creation> X<referencing>
3152 1. X<\> X<backslash>, 2. X<array, anonymous> X<[> X<[]> X<square bracket>
3153 X<bracket, square> X<arrayref> X<array reference> X<reference, array>, 3.
3154 X<hash, anonymous> X<{> X<{}> X<curly bracket> X<bracket, curly> X<brace>
3155 X<hashref> X<hash reference> X<reference, hash>, 4. X<subroutine,
3156 anonymous> X<subroutine, reference> X<reference, subroutine> X<scope,
3157 lexical> X<closure> X<lexical> X<lexical scope>, 5. X<constructor> X<new>,
3158 6. X<autovivification>, 7. X<*foo{THING}> X<*>
3160 =item Using References
3161 X<reference, use> X<dereferencing> X<dereference>
3163 =item Symbolic references
3164 X<reference, symbolic> X<reference, soft>
3165 X<symbolic reference> X<soft reference>
3167 =item Not-so-symbolic references
3169 =item Pseudo-hashes: Using an array as a hash
3170 X<pseudo-hash> X<pseudo hash> X<pseudohash>
3172 =item Function Templates
3173 X<scope, lexical> X<closure> X<lexical> X<lexical scope>
3174 X<subroutine, nested> X<sub, nested> X<subroutine, local> X<sub, local>
3179 X<reference, string context> X<reference, use as hash key>
3185 =head2 perlform - Perl formats
3194 X<format, text field>
3196 =item Numeric Fields
3197 X<#> X<format, numeric field>
3199 =item The Field @* for Variable Width Multi-Line Text
3202 =item The Field ^* for Variable Width One-line-at-a-time Text
3205 =item Specifying Values
3206 X<format, specifying values>
3208 =item Using Fill Mode
3209 X<format, fill mode>
3211 =item Suppressing Lines Where All Fields Are Void
3212 X<format, suppressing lines>
3214 =item Repeating Format Lines
3215 X<format, repeating lines>
3217 =item Top of Form Processing
3218 X<format, top of form> X<top> X<header>
3220 =item Format Variables
3222 X<format, variables>
3231 X<format, footer> X<footer>
3233 =item Accessing Formatting Internals
3234 X<format, internals>
3242 =head2 perlobj - Perl objects
3250 =item An Object is Simply a Reference
3251 X<object> X<bless> X<constructor> X<new>
3253 =item A Class is Simply a Package
3254 X<class> X<package> X<@ISA> X<inheritance>
3256 =item A Method is Simply a Subroutine
3259 =item Method Invocation
3260 X<invocation> X<method> X<arrow> X<< -> >>
3262 =item Indirect Object Syntax
3263 X<indirect object syntax> X<invocation, indirect> X<indirect>
3265 =item Default UNIVERSAL methods
3268 isa(CLASS) X<isa>, DOES(ROLE), can(METHOD) X<can>, VERSION( [NEED] )
3272 X<destructor> X<DESTROY>
3276 =item Two-Phased Garbage Collection
3277 X<garbage collection> X<GC> X<circular reference>
3278 X<reference, circular> X<DESTROY> X<destructor>
3286 =head2 perltie - how to hide an object class in a simple variable
3299 TIESCALAR classname, LIST X<TIESCALAR>, FETCH this X<FETCH>, STORE this,
3300 value X<STORE>, UNTIE this X<UNTIE>, DESTROY this X<DESTROY>
3305 TIEARRAY classname, LIST X<TIEARRAY>, FETCH this, index X<FETCH>, STORE
3306 this, index, value X<STORE>, FETCHSIZE this X<FETCHSIZE>, STORESIZE this,
3307 count X<STORESIZE>, EXTEND this, count X<EXTEND>, EXISTS this, key
3308 X<EXISTS>, DELETE this, key X<DELETE>, CLEAR this X<CLEAR>, PUSH this, LIST
3309 X<PUSH>, POP this X<POP>, SHIFT this X<SHIFT>, UNSHIFT this, LIST
3310 X<UNSHIFT>, SPLICE this, offset, length, LIST X<SPLICE>, UNTIE this
3311 X<UNTIE>, DESTROY this X<DESTROY>
3316 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST X<TIEHASH>, FETCH this,
3317 key X<FETCH>, STORE this, key, value X<STORE>, DELETE this, key X<DELETE>,
3318 CLEAR this X<CLEAR>, EXISTS this, key X<EXISTS>, FIRSTKEY this X<FIRSTKEY>,
3319 NEXTKEY this, lastkey X<NEXTKEY>, SCALAR this X<SCALAR>, UNTIE this
3320 X<UNTIE>, DESTROY this X<DESTROY>
3322 =item Tying FileHandles
3323 X<filehandle, tying>
3325 TIEHANDLE classname, LIST X<TIEHANDLE>, WRITE this, LIST X<WRITE>, PRINT
3326 this, LIST X<PRINT>, PRINTF this, LIST X<PRINTF>, READ this, LIST X<READ>,
3327 READLINE this X<READLINE>, GETC this X<GETC>, EOF this X<EOF>, CLOSE this
3328 X<CLOSE>, UNTIE this X<UNTIE>, DESTROY this X<DESTROY>
3333 =item The C<untie> Gotcha
3346 =head2 perldbmfilter - Perl DBM Filters
3354 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
3355 B<filter_fetch_value>
3361 =item An Example -- the NULL termination problem.
3363 =item Another Example -- Key is a C int.
3373 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
3374 safe subprocesses, sockets, and semaphores)
3384 =item Handling the SIGHUP Signal in Daemons
3392 =item Deferred Signals (Safe Signals)
3394 Long-running opcodes, Interrupting IO, Restartable system calls, Signals as
3395 "faults", Signals triggered by operating system state
3399 =item Using open() for IPC
3405 =item Background Processes
3407 =item Complete Dissociation of Child from Parent
3409 =item Safe Pipe Opens
3411 =item Bidirectional Communication with Another Process
3413 =item Bidirectional Communication with Yourself
3417 =item Sockets: Client/Server Communication
3421 =item Internet Line Terminators
3423 =item Internet TCP Clients and Servers
3425 =item Unix-Domain TCP Clients and Servers
3429 =item TCP Clients with IO::Socket
3433 =item A Simple Client
3435 C<Proto>, C<PeerAddr>, C<PeerPort>
3437 =item A Webget Client
3439 =item Interactive Client with IO::Socket
3443 =item TCP Servers with IO::Socket
3445 Proto, LocalPort, Listen, Reuse
3447 =item UDP: Message Passing
3461 =head2 perlfork - Perl's fork() emulation
3471 =item Behavior of other Perl features in forked pseudo-processes
3473 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
3474 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
3475 files, directories and network sockets
3477 =item Resource limits
3479 =item Killing the parent process
3481 =item Lifetime of the parent process and pseudo-processes
3483 =item CAVEATS AND LIMITATIONS
3485 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
3486 Global state maintained by XSUBs, Interpreter embedded in larger
3487 application, Thread-safety of extensions
3499 =head2 perlnumber - semantics of numbers and numeric operations in Perl
3507 =item Storing numbers
3509 =item Numeric operators and numeric conversions
3511 =item Flavors of Perl numeric operations
3513 Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other
3514 mathematical operators, Bitwise operators, Bitwise operators during C<use
3515 integer>, Operators which expect an integer, Operators which expect a
3524 =head2 perlthrtut - Tutorial on threads in Perl
3530 =item What Is A Thread Anyway?
3532 =item Threaded Program Models
3544 =item What kind of threads are Perl threads?
3546 =item Thread-Safe Modules
3552 =item Basic Thread Support
3554 =item A Note about the Examples
3556 =item Creating Threads
3558 =item Waiting For A Thread To Exit
3560 =item Ignoring A Thread
3562 =item Process and Thread Termination
3566 =item Threads And Data
3570 =item Shared And Unshared Data
3572 =item Thread Pitfalls: Races
3576 =item Synchronization and control
3580 =item Controlling access: lock()
3582 =item A Thread Pitfall: Deadlocks
3584 =item Queues: Passing Data Around
3586 =item Semaphores: Synchronizing Data Access
3588 =item Basic semaphores
3590 =item Advanced Semaphores
3592 =item Waiting for a Condition
3594 =item Giving up control
3598 =item General Thread Utility Routines
3602 =item What Thread Am I In?
3606 =item Are These Threads The Same?
3608 =item What Threads Are Running?
3612 =item A Complete Example
3614 =item Different implementations of threads
3616 =item Performance considerations
3618 =item Process-scope Changes
3620 =item Thread-Safety of System Libraries
3630 =item Introductory Texts
3632 =item OS-Related References
3634 =item Other References
3638 =item Acknowledgements
3646 =head2 perlothrtut - old tutorial on threads in Perl
3652 =item What Is A Thread Anyway?
3654 =item Threaded Program Models
3666 =item Native threads
3668 =item What kind of threads are perl threads?
3670 =item Threadsafe Modules
3676 =item Basic Thread Support
3678 =item Creating Threads
3680 =item Giving up control
3682 =item Waiting For A Thread To Exit
3684 =item Errors In Threads
3686 =item Ignoring A Thread
3690 =item Threads And Data
3694 =item Shared And Unshared Data
3696 =item Thread Pitfall: Races
3698 =item Controlling access: lock()
3700 =item Thread Pitfall: Deadlocks
3702 =item Queues: Passing Data Around
3706 =item Threads And Code
3710 =item Semaphores: Synchronizing Data Access
3712 Basic semaphores, Advanced Semaphores
3714 =item Attributes: Restricting Access To Subroutines
3716 =item Subroutine Locks
3720 =item Locking A Subroutine
3724 =item General Thread Utility Routines
3728 =item What Thread Am I In?
3732 =item Are These Threads The Same?
3734 =item What Threads Are Running?
3738 =item A Complete Example
3746 =item Introductory Texts
3748 =item OS-Related References
3750 =item Other References
3754 =item Acknowledgements
3762 =head2 perlport - Writing portable Perl
3768 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
3777 =item Numbers endianness and Width
3779 =item Files and Filesystems
3781 =item System Interaction
3783 =item Command names versus file pathnames
3787 =item Interprocess Communication (IPC)
3789 =item External Subroutines (XS)
3791 =item Standard Modules
3795 =item Character sets and character encoding
3797 =item Internationalisation
3799 =item System Resources
3815 =item DOS and Derivatives
3823 =item EBCDIC Platforms
3831 =item FUNCTION IMPLEMENTATIONS
3835 =item Alphabetical Listing of Perl Functions
3837 -I<X>, atan2, binmode, chmod, chown, chroot, crypt, dbmclose, dbmopen,
3838 dump, exec, exit, fcntl, flock, fork, getlogin, getpgrp, getppid,
3839 getpriority, getpwnam, getgrnam, getnetbyname, getpwuid, getgrgid,
3840 getnetbyaddr, getprotobynumber, getservbyport, getpwent, getgrent,
3841 gethostbyname, gethostent, getnetent, getprotoent, getservent, sethostent,
3842 setnetent, setprotoent, setservent, endpwent, endgrent, endhostent,
3843 endnetent, endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob,
3844 gmtime, ioctl FILEHANDLE,FUNCTION,SCALAR, kill, link, localtime, lstat,
3845 msgctl, msgget, msgsnd, msgrcv, open, pipe, readlink, rename, select,
3846 semctl, semget, semop, setgrent, setpgrp, setpriority, setpwent,
3847 setsockopt, shmctl, shmget, shmread, shmwrite, sockatmark, socketpair,
3848 stat, symlink, syscall, sysopen, system, times, truncate, umask, utime,
3853 =item Supported Platforms
3857 =item AUTHORS / CONTRIBUTORS
3861 =head2 perllocale - Perl locale handling (internationalization and
3868 =item PREPARING TO USE LOCALES
3874 =item The use locale pragma
3876 =item The setlocale function
3878 =item Finding locales
3880 =item LOCALE PROBLEMS
3882 =item Temporarily fixing locale problems
3884 =item Permanently fixing locale problems
3886 =item Permanently fixing your system's locale configuration
3888 =item Fixing system locale configuration
3890 =item The localeconv function
3892 =item I18N::Langinfo
3896 =item LOCALE CATEGORIES
3900 =item Category LC_COLLATE: Collation
3902 =item Category LC_CTYPE: Character Types
3904 =item Category LC_NUMERIC: Numeric Formatting
3906 =item Category LC_MONETARY: Formatting of monetary amounts
3910 =item Other categories
3918 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
3919 LC_NUMERIC, LC_TIME, LANG
3931 =item Backward compatibility
3933 =item I18N:Collate obsolete
3935 =item Sort speed and memory use impacts
3937 =item write() and LC_NUMERIC
3939 =item Freely available locale definitions
3943 =item An imperfect standard
3947 =item Unicode and UTF-8
3953 =item Broken systems
3963 =head2 perluniintro - Perl Unicode introduction
3973 =item Perl's Unicode Support
3975 =item Perl's Unicode Model
3977 =item Unicode and EBCDIC
3979 =item Creating Unicode
3981 =item Handling Unicode
3983 =item Legacy Encodings
3987 =item Displaying Unicode As Text
3991 =item Advanced Topics
3995 =item Questions With Answers
3997 =item Hexadecimal Notation
3999 =item Further Resources
4003 =item UNICODE IN OLDER PERLS
4007 =item ACKNOWLEDGMENTS
4009 =item AUTHOR, COPYRIGHT, AND LICENSE
4013 =head2 perlunicode - Unicode support in Perl
4021 =item Important Caveats
4023 Input and Output Layers, Regular Expressions, C<use utf8> still needed to
4024 enable UTF-8/UTF-EBCDIC in scripts, BOM-marked scripts and UTF-16 scripts
4025 autodetected, C<use encoding> needed to upgrade non-Latin-1 byte strings
4027 =item Byte and Character Semantics
4029 =item Effects of Character Semantics
4031 =item Unicode Character Properties
4033 General Category, Bidirectional Character Types, Scripts, Extended property
4034 classes, Use of "Is" Prefix, Blocks
4036 =item User-Defined Character Properties
4038 =item User-Defined Case Mappings
4040 =item Character Encodings for Input and Output
4042 =item Unicode Regular Expression Support Level
4044 =item Unicode Encodings
4046 =item Security Implications of Unicode
4048 =item Unicode in Perl on EBCDIC
4052 =item When Unicode Does Not Happen
4054 =item Forcing Unicode in Perl (Or Unforcing Unicode in Perl)
4056 =item Using Unicode in XS
4064 =item Interaction with Locales
4066 =item Problems with characters whose ordinal numbers are in the range 128 -
4067 255 with no Locale specified
4069 =item Interaction with Extensions
4073 =item Porting code from perl-5.6.X
4081 =head2 perlunifaq - Perl Unicode FAQ
4089 =item perlunitut isn't really a Unicode tutorial, is it?
4091 =item What character encodings does Perl support?
4093 =item Which version of perl should I use?
4095 =item What about binary data, like images?
4097 =item When should I decode or encode?
4099 =item What if I don't decode?
4101 =item What if I don't encode?
4103 =item Is there a way to automatically decode or encode?
4105 =item What if I don't know which encoding was used?
4107 =item Can I use Unicode in my Perl sources?
4109 =item Data::Dumper doesn't restore the UTF8 flag; is it broken?
4111 =item Why do regex character classes sometimes match only in the ASCII
4114 =item Why do some characters not uppercase or lowercase correctly?
4116 =item How can I determine if a string is a text string or a binary string?
4118 =item How do I convert from encoding FOO to encoding BAR?
4120 =item What are C<decode_utf8> and C<encode_utf8>?
4122 =item What is a "wide character"?
4130 =item What is "the UTF8 flag"?
4132 =item What about the C<use bytes> pragma?
4134 =item What about the C<use encoding> pragma?
4136 =item What is the difference between C<:encoding> and C<:utf8>?
4138 =item What's the difference between C<UTF-8> and C<utf8>?
4140 =item I lost track; what encoding is the internal format really?
4150 =head2 perlunitut - Perl Unicode Tutorial
4160 =item Your new toolkit
4162 =item I/O flow (the actual 5 minute tutorial)
4168 =item Q and A (or FAQ)
4170 =item ACKNOWLEDGEMENTS
4178 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
4184 =item COMMON CHARACTER CODE SETS
4192 =item Latin 1 (ISO 8859-1)
4196 =item 13 variant characters
4204 =item Unicode code points versus EBCDIC code points
4206 =item Remaining Perl Unicode problems in EBCDIC
4208 =item Unicode and UTF
4214 =item SINGLE OCTET TABLES
4216 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
4218 =item IDENTIFYING CHARACTER CODE SETS
4232 =item OPERATOR DIFFERENCES
4234 =item FUNCTION DIFFERENCES
4236 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
4238 =item REGULAR EXPRESSION DIFFERENCES
4246 =item Ignore ASCII vs. EBCDIC sort differences.
4248 =item MONO CASE then sort data.
4250 =item Convert, sort data, then re convert.
4252 =item Perform sorting on one type of platform only.
4256 =item TRANSFORMATION FORMATS
4260 =item URL decoding and encoding
4262 =item uu encoding and decoding
4264 =item Quoted-Printable encoding and decoding
4266 =item Caesarian ciphers
4270 =item Hashing order and checksums
4274 =item MULTI OCTET CHARACTER SETS
4286 chcp, dataset access, OS/390, z/OS iconv, locales
4306 =head2 perlsec - Perl security
4314 =item Laundering and Detecting Tainted Data
4316 =item Switches On the "#!" Line
4318 =item Taint mode and @INC
4320 =item Cleaning Up Your Path
4324 =item Protecting Your Programs
4328 =item Algorithmic Complexity Attacks
4336 =head2 perlmod - Perl modules (packages and symbol tables)
4345 X<package> X<namespace> X<variable, global> X<global variable> X<global>
4348 X<symbol table> X<stash> X<%::> X<%main::> X<typeglob> X<glob> X<alias>
4350 =item BEGIN, UNITCHECK, CHECK, INIT and END
4351 X<BEGIN> X<UNITCHECK> X<CHECK> X<INIT> X<END>
4359 =item Making your module threadsafe
4360 X<threadsafe> X<thread safe>
4361 X<module, threadsafe> X<module, thread safe>
4362 X<CLONE> X<CLONE_SKIP> X<thread> X<threads> X<ithread>
4370 =head2 perlmodlib - constructing new Perl modules and finding existing ones
4374 =item THE PERL MODULE LIBRARY
4378 =item Pragmatic Modules
4380 attributes, attrs, autodie, autouse, base, bigint, bignum, bigrat, blib,
4381 bytes, charnames, constant, diagnostics, encoding, encoding::warnings,
4382 feature, fields, filetest, if, integer, less, lib, locale, mro, open, ops,
4383 overload, parent, re, sigtrap, sort, strict, subs, threads,
4384 threads::shared, utf8, vars, version, vmsish, warnings, warnings::register
4386 =item Standard Modules
4388 AnyDBM_File, App::Prove, App::Prove::State, Archive::Extract, Archive::Tar,
4389 Archive::Tar::File, Attribute::Handlers, AutoLoader, AutoSplit, B,
4390 B::Concise, B::Debug, B::Deparse, B::Lint, B::Lint::Debug, B::Showlex,
4391 B::Terse, B::Xref, Benchmark, CGI, CGI::Apache, CGI::Carp, CGI::Cookie,
4392 CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util, CORE, CPAN,
4393 CPAN::API::HOWTO, CPAN::FirstTime, CPAN::Kwalify, CPAN::Nox, CPAN::Version,
4394 CPANPLUS, CPANPLUS::Dist::Base, CPANPLUS::Dist::Sample,
4395 CPANPLUS::Shell::Classic, CPANPLUS::Shell::Default::Plugins::HOWTO, Carp,
4396 Carp::Heavy, Class::ISA, Class::Struct, Compress::Raw::Zlib,
4397 Compress::Zlib, Config, Cwd, DB, DBM_Filter, DBM_Filter::compress,
4398 DBM_Filter::encode, DBM_Filter::int32, DBM_Filter::null, DBM_Filter::utf8,
4399 DB_File, Data::Dumper, Devel::DProf, Devel::InnerPackage, Devel::Peek,
4400 Devel::SelfStubber, Digest, Digest::MD5, Digest::SHA, Digest::base,
4401 Digest::file, DirHandle, Dumpvalue, DynaLoader, Encode, Encode::Alias,
4402 Encode::Byte, Encode::CJKConstants, Encode::CN, Encode::CN::HZ,
4403 Encode::Config, Encode::EBCDIC, Encode::Encoder, Encode::Encoding,
4404 Encode::GSM0338, Encode::Guess, Encode::JP, Encode::JP::H2Z,
4405 Encode::JP::JIS7, Encode::KR, Encode::KR::2022_KR, Encode::MIME::Header,
4406 Encode::MIME::Name, Encode::PerlIO, Encode::Supported, Encode::Symbol,
4407 Encode::TW, Encode::Unicode, Encode::Unicode::UTF7, English, Env, Errno,
4408 Exporter, Exporter::Heavy, ExtUtils::CBuilder,
4409 ExtUtils::CBuilder::Platform::Windows, ExtUtils::Command,
4410 ExtUtils::Command::MM, ExtUtils::Constant, ExtUtils::Constant::Base,
4411 ExtUtils::Constant::Utils, ExtUtils::Constant::XS, ExtUtils::Embed,
4412 ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM,
4413 ExtUtils::MM_AIX, ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin,
4414 ExtUtils::MM_DOS, ExtUtils::MM_Darwin, ExtUtils::MM_MacOS,
4415 ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_QNX, ExtUtils::MM_UWIN,
4416 ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_VOS, ExtUtils::MM_Win32,
4417 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker,
4418 ExtUtils::MakeMaker::Config, ExtUtils::MakeMaker::FAQ,
4419 ExtUtils::MakeMaker::Tutorial, ExtUtils::MakeMaker::bytes,
4420 ExtUtils::MakeMaker::vmsish, ExtUtils::Manifest, ExtUtils::Mkbootstrap,
4421 ExtUtils::Mksymlists, ExtUtils::Packlist, ExtUtils::ParseXS,
4422 ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree,
4423 File::Compare, File::Copy, File::DosGlob, File::Fetch, File::Find,
4424 File::Glob, File::GlobMapper, File::Path, File::Spec, File::Spec::Cygwin,
4425 File::Spec::Epoc, File::Spec::Functions, File::Spec::Mac, File::Spec::OS2,
4426 File::Spec::Unix, File::Spec::VMS, File::Spec::Win32, File::Temp,
4427 File::stat, FileCache, FileHandle, Filter::Simple, Filter::Util::Call,
4428 FindBin, GDBM_File, Getopt::Long, Getopt::Std, Hash::Util,
4429 Hash::Util::FieldHash, I18N::Collate, I18N::LangTags,
4430 I18N::LangTags::Detect, I18N::LangTags::List, I18N::Langinfo, IO,
4431 IO::Compress::Base, IO::Compress::Deflate, IO::Compress::Gzip,
4432 IO::Compress::RawDeflate, IO::Compress::Zip, IO::Dir, IO::File, IO::Handle,
4433 IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET,
4434 IO::Socket::UNIX, IO::Uncompress::AnyInflate,
4435 IO::Uncompress::AnyUncompress, IO::Uncompress::Base,
4436 IO::Uncompress::Gunzip, IO::Uncompress::Inflate,
4437 IO::Uncompress::RawInflate, IO::Uncompress::Unzip, IO::Zlib, IPC::Cmd,
4438 IPC::Msg, IPC::Open2, IPC::Open3, IPC::Semaphore, IPC::SharedMem,
4439 IPC::SysV, List::Util, Locale::Constants, Locale::Country,
4440 Locale::Currency, Locale::Language, Locale::Maketext,
4441 Locale::Maketext::Simple, Locale::Maketext::TPJ13, Locale::Script,
4442 Log::Message, Log::Message::Config, Log::Message::Handlers,
4443 Log::Message::Item, MIME::Base64, MIME::QuotedPrint, Math::BigFloat,
4444 Math::BigInt, Math::BigInt::Calc, Math::BigInt::CalcEmu,
4445 Math::BigInt::FastCalc, Math::BigRat, Math::Complex, Math::Trig, Memoize,
4446 Memoize::AnyDBM_File, Memoize::Expire, Memoize::ExpireFile,
4447 Memoize::ExpireTest, Memoize::NDBM_File, Memoize::SDBM_File,
4448 Memoize::Storable, Module::Build, Module::Build::API,
4449 Module::Build::Authoring, Module::Build::Base, Module::Build::Compat,
4450 Module::Build::ConfigData, Module::Build::Cookbook,
4451 Module::Build::ModuleInfo, Module::Build::Notes, Module::Build::PPMMaker,
4452 Module::Build::Platform::Amiga, Module::Build::Platform::Default,
4453 Module::Build::Platform::EBCDIC, Module::Build::Platform::MPEiX,
4454 Module::Build::Platform::MacOS, Module::Build::Platform::RiscOS,
4455 Module::Build::Platform::Unix, Module::Build::Platform::VMS,
4456 Module::Build::Platform::VOS, Module::Build::Platform::Windows,
4457 Module::Build::Platform::aix, Module::Build::Platform::cygwin,
4458 Module::Build::Platform::darwin, Module::Build::Platform::os2,
4459 Module::Build::YAML, Module::CoreList, Module::Load,
4460 Module::Load::Conditional, Module::Loaded, Module::Pluggable,
4461 Module::Pluggable::Object, NDBM_File, NEXT, Net::Cmd, Net::Config,
4462 Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3, Net::Ping,
4463 Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent,
4464 Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX,
4465 Package::Constants, Params::Check, PerlIO, PerlIO::encoding,
4466 PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint, Pod::Checker,
4467 Pod::Escapes, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects,
4468 Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser,
4469 Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff,
4470 Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText,
4471 Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer,
4472 Pod::Select, Pod::Simple, Pod::Simple::Checker, Pod::Simple::Debug,
4473 Pod::Simple::DumpAsText, Pod::Simple::DumpAsXML, Pod::Simple::HTML,
4474 Pod::Simple::HTMLBatch, Pod::Simple::LinkSection, Pod::Simple::Methody,
4475 Pod::Simple::PullParser, Pod::Simple::PullParserEndToken,
4476 Pod::Simple::PullParserStartToken, Pod::Simple::PullParserTextToken,
4477 Pod::Simple::PullParserToken, Pod::Simple::RTF, Pod::Simple::Search,
4478 Pod::Simple::SimpleTree, Pod::Simple::Subclassing, Pod::Simple::Text,
4479 Pod::Simple::TextContent, Pod::Simple::XMLOutStream, Pod::Text,
4480 Pod::Text::Color, Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage,
4481 SDBM_File, Safe, Scalar::Util, Search::Dict, SelectSaver, SelfLoader,
4482 Shell, Socket, Storable, Switch, Symbol, Sys::Hostname, Sys::Syslog,
4483 Sys::Syslog::win32::Win32, TAP::Base, TAP::Formatter::Color,
4484 TAP::Formatter::Console, TAP::Formatter::Console::ParallelSession,
4485 TAP::Formatter::Console::Session, TAP::Harness, TAP::Parser,
4486 TAP::Parser::Aggregator, TAP::Parser::Grammar, TAP::Parser::Iterator,
4487 TAP::Parser::Iterator::Array, TAP::Parser::Iterator::Process,
4488 TAP::Parser::Iterator::Stream, TAP::Parser::Multiplexer,
4489 TAP::Parser::Result, TAP::Parser::Result::Bailout,
4490 TAP::Parser::Result::Comment, TAP::Parser::Result::Plan,
4491 TAP::Parser::Result::Pragma, TAP::Parser::Result::Test,
4492 TAP::Parser::Result::Unknown, TAP::Parser::Result::Version,
4493 TAP::Parser::Result::YAML, TAP::Parser::Source, TAP::Parser::Source::Perl,
4494 TAP::Parser::Utils, TAP::Parser::YAMLish::Reader,
4495 TAP::Parser::YAMLish::Writer, Term::ANSIColor, Term::Cap, Term::Complete,
4496 Term::ReadLine, Term::UI, Test, Test::Builder, Test::Builder::Module,
4497 Test::Builder::Tester, Test::Builder::Tester::Color, Test::Harness,
4498 Test::More, Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced,
4499 Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Thread,
4500 Thread::Queue, Thread::Semaphore, Tie::Array, Tie::File, Tie::Handle,
4501 Tie::Hash, Tie::Hash::NamedCapture, Tie::Memoize, Tie::RefHash,
4502 Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::Piece,
4503 Time::Piece::Seconds, Time::gmtime, Time::localtime, Time::tm, UNIVERSAL,
4504 Unicode::Collate, Unicode::Normalize, Unicode::UCD, User::grent,
4505 User::pwent, Win32, Win32API::File, Win32CORE, XS::APItest, XS::Typemap,
4508 =item Extension Modules
4522 China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi
4523 Arabia, Singapore, South Korea, Taiwan, Thailand
4525 =item Central America
4531 Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Czech
4532 Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary,
4533 Iceland, Ireland, Italy, Latvia, Lithuania, Netherlands, Norway, Poland,
4534 Portugal, Romania, Russia, Slovakia, Slovenia, Spain, Sweden, Switzerland,
4535 Turkey, Ukraine, United Kingdom
4539 Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States,
4540 Alabama, California, Colorado, Delaware, District of Columbia, Florida,
4541 Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey, New York,
4542 North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, Utah,
4543 Virginia, Washington, Wisconsin
4547 Australia, New Zealand, United States
4551 Argentina, Brazil, Chile
4557 =item Modules: Creation, Use, and Abuse
4561 =item Guidelines for Module Creation
4563 =item Guidelines for Converting Perl 4 Library Scripts into Modules
4565 =item Guidelines for Reusing Application Code
4573 =head2 perlmodstyle - Perl module style guide
4579 =item QUICK CHECKLIST
4583 =item Before you start
4591 =item Release considerations
4595 =item BEFORE YOU START WRITING A MODULE
4599 =item Has it been done before?
4601 =item Do one thing and do it well
4603 =item What's in a name?
4607 =item DESIGNING AND WRITING YOUR MODULE
4611 =item To OO or not to OO?
4613 =item Designing your API
4615 Write simple routines to do simple things, Separate functionality from
4616 output, Provide sensible shortcuts and defaults, Naming conventions,
4619 =item Strictness and warnings
4621 =item Backwards compatibility
4623 =item Error handling and messages
4627 =item DOCUMENTING YOUR MODULE
4633 =item README, INSTALL, release notes, changelogs
4635 perl Makefile.PL, make, make test, make install, perl Build.PL, perl Build,
4636 perl Build test, perl Build install
4640 =item RELEASE CONSIDERATIONS
4644 =item Version numbering
4646 =item Pre-requisites
4656 =item COMMON PITFALLS
4660 =item Reinventing the wheel
4662 =item Trying to do too much
4664 =item Inappropriate documentation
4670 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Packaging Tools,
4671 Testing tools, http://pause.perl.org/, Any good book on software
4678 =head2 perlmodinstall - Installing CPAN Modules
4688 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
4689 module (sometimes unnecessary), B<INSTALL> the module
4703 =head2 perlnewmod - preparing a new module for distribution
4713 =item What should I make into a module?
4715 =item Step-by-step: Preparing the ground
4717 Look around, Check it's new, Discuss the need, Choose a name, Check again
4719 =item Step-by-step: Making the module
4721 Start with F<module-starter> or F<h2xs>, Use L<strict|strict> and
4722 L<warnings|warnings>, Use L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!,
4723 Use L<plain old documentation|perlpod>, Write tests, Write the README
4725 =item Step-by-step: Distributing your module
4727 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
4728 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
4738 =head2 perlpragma - how to write a user pragma
4744 =item A basic example
4746 =item Implementation details
4750 =head2 perlutil - utilities packaged with the Perl distribution
4756 =item LIST OF UTILITIES
4762 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
4763 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
4764 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
4765 L<roffitall|roffitall>
4769 L<a2p|a2p>, L<s2p|s2p> and L<psed>, L<find2perl|find2perl>
4771 =item Administration
4773 L<config_data|config_data>, L<libnetcfg|libnetcfg>, L<perlivp>
4777 L<perlbug|perlbug>, L<perlthanks|perlthanks>, L<h2ph|h2ph>, L<c2ph|c2ph>
4778 and L<pstruct|pstruct>, L<h2xs|h2xs>, L<enc2xs>, L<xsubpp>,
4779 L<dprofpp|dprofpp>, L<prove>, L<corelist>
4783 L<piconv>, L<ptar>, L<ptardiff>, L<shasum>
4787 L<cpan>, L<cpanp>, L<cpan2dist>, L<instmodsh>
4795 =head2 perlcompile - Introduction to the Perl Compiler-Translator
4805 B::Lint, B::Deparse, B::Xref
4809 =item Using The Back Ends
4813 =item The Cross Referencing Back End
4817 =item The Decompiling Back End
4819 =item The Lint Back End
4823 =item Module List for the Compiler Suite
4825 B, O, B::Concise, B::Debug, B::Deparse, B::Lint, B::Showlex, B::Terse,
4828 =item KNOWN PROBLEMS
4834 =head2 perlfilter - Source Filters
4844 =item WRITING A SOURCE FILTER
4846 =item WRITING A SOURCE FILTER IN C
4848 B<Decryption Filters>
4850 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4852 =item WRITING A SOURCE FILTER IN PERL
4854 =item USING CONTEXT: THE DEBUG FILTER
4858 =item THINGS TO LOOK OUT FOR
4860 Some Filters Clobber the C<DATA> Handle
4870 =head2 perlglossary - Perl Glossary
4880 accessor methods, actual arguments, address operator, algorithm, alias,
4881 alternatives, anonymous, architecture, argument, ARGV, arithmetical
4882 operator, array, array context, ASCII, assertion, assignment, assignment
4883 operator, associative array, associativity, asynchronous, atom, atomic
4884 operation, attribute, autogeneration, autoincrement, autoload, autosplit,
4885 autovivification, AV, awk
4889 backreference, backtracking, backward compatibility, bareword, base class,
4890 big-endian, binary, binary operator, bind, bit, bit shift, bit string,
4891 bless, block, BLOCK, block buffering, Boolean, Boolean context, breakpoint,
4892 broadcast, BSD, bucket, buffer, built-in, bundle, byte, bytecode
4896 C, C preprocessor, call by reference, call by value, callback, canonical,
4897 capturing, character, character class, character property, circumfix
4898 operator, class, class method, client, cloister, closure, cluster, CODE,
4899 code generator, code subpattern, collating sequence, command, command
4900 buffering, command name, command-line arguments, comment, compilation unit,
4901 compile phase, compile time, compiler, composer, concatenation,
4902 conditional, connection, construct, constructor, context, continuation,
4903 core dump, CPAN, cracker, current package, current working directory,
4904 currently selected output channel, CV
4908 dangling statement, data structure, data type, datagram, DBM, declaration,
4909 decrement, default, defined, delimiter, deprecated modules and features,
4910 dereference, derived class, descriptor, destroy, destructor, device,
4911 directive, directory, directory handle, dispatch, distribution, (to be)
4912 dropped modules, dweomer, dwimmer, dynamic scoping
4916 eclectic, element, embedding, empty subclass test, en passant,
4917 encapsulation, endian, environment, environment variable, EOF, errno,
4918 error, escape sequence, exception, exception handling, exec, executable
4919 file, execute, execute bit, exit status, export, expression, extension
4923 false, FAQ, fatal error, field, FIFO, file, file descriptor, file test
4924 operator, fileglob, filehandle, filename, filesystem, filter, flag,
4925 floating point, flush, FMTEYEWTK, fork, formal arguments, format, freely
4926 available, freely redistributable, freeware, function, funny character,
4931 GID, glob, global, global destruction, glue language, granularity, greedy,
4936 hacker, handler, hard reference, hash, hash table, header file, here
4937 document, hexadecimal, home directory, host, hubris, HV
4941 identifier, impatience, implementation, import, increment, indexing,
4942 indirect filehandle, indirect object, indirect object slot, indirection,
4943 infix, inheritance, instance, instance variable, integer, interface,
4944 interpolation, interpreter, invocant, invocation, I/O, IO, IP, IPC, is-a,
4945 iteration, iterator, IV
4957 label, laziness, left shift, leftmost longest, lexeme, lexer, lexical
4958 analysis, lexical scoping, lexical variable, library, LIFO, line, line
4959 buffering, line number, link, LIST, list, list context, list operator, list
4960 value, literal, little-endian, local, logical operator, lookahead,
4961 lookbehind, loop, loop control statement, loop label, lvaluable, lvalue,
4966 magic, magical increment, magical variables, Makefile, man, manpage,
4967 matching, member data, memory, metacharacter, metasymbol, method,
4968 minimalism, mode, modifier, module, modulus, monger, mortal,
4969 multidimensional array, multiple inheritance
4973 named pipe, namespace, network address, newline, NFS, null character, null
4974 list, null string, numeric context, NV, nybble
4978 object, octal, offset, one-liner, open source software, operand, operating
4979 system, operator, operator overloading, options, overloading, overriding,
4984 package, pad, parameter, parent class, parse tree, parsing, patch, PATH,
4985 pathname, pattern, pattern matching, permission bits, Pern, pipe, pipeline,
4986 platform, pod, pointer, polymorphism, port, portable, porter, POSIX,
4987 postfix, pp, pragma, precedence, prefix, preprocessing, procedure, process,
4988 program generator, progressive matching, property, protocol, prototype,
4989 pseudofunction, pseudohash, pseudoliteral, public domain, pumpkin,
4994 qualified, quantifier
4998 readable, reaping, record, recursion, reference, referent, regex, regular
4999 expression, regular expression modifier, regular file, relational operator,
5000 reserved words, return value, RFC, right shift, root, RTFM, run phase, run
5001 time, run-time pattern, RV, rvalue
5005 scalar, scalar context, scalar literal, scalar value, scalar variable,
5006 scope, scratchpad, script, script kiddie, sed, semaphore, separator,
5007 serialization, server, service, setgid, setuid, shared memory, shebang,
5008 shell, side effects, signal, signal handler, single inheritance, slice,
5009 slurp, socket, soft reference, source filter, stack, standard, standard
5010 error, standard I/O, standard input, standard output, stat structure,
5011 statement, statement modifier, static, static method, static scoping,
5012 static variable, status, STDERR, STDIN, STDIO, STDOUT, stream, string,
5013 string context, stringification, struct, structure, subclass, subpattern,
5014 subroutine, subscript, substitution, substring, superclass, superuser, SV,
5015 switch, switch cluster, switch statement, symbol, symbol table, symbolic
5016 debugger, symbolic link, symbolic reference, synchronous, syntactic sugar,
5017 syntax, syntax tree, syscall
5021 tainted, TCP, term, terminator, ternary, text, thread, tie, TMTOWTDI,
5022 token, tokener, tokenizing, toolbox approach, transliterate, trigger,
5023 trinary, troff, true, truncating, type, type casting, typed lexical,
5024 typedef, typeglob, typemap
5028 UDP, UID, umask, unary operator, Unicode, Unix
5032 value, variable, variable interpolation, variadic, vector, virtual, void
5037 warning, watch expression, whitespace, word, working directory, wrapper,
5054 =item AUTHOR AND COPYRIGHT
5058 =head2 perlembed - how to embed perl in your C program
5068 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
5069 Perl?>, B<Use C from C?>, B<Use Perl from C?>
5073 =item Compiling your C program
5075 =item Adding a Perl interpreter to your C program
5077 =item Calling a Perl subroutine from your C program
5079 =item Evaluating a Perl statement from your C program
5081 =item Performing Perl pattern matches and substitutions from your C program
5083 =item Fiddling with the Perl stack from your C program
5085 =item Maintaining a persistent interpreter
5087 =item Execution of END blocks
5089 =item $0 assignments
5091 =item Maintaining multiple interpreter instances
5093 =item Using Perl modules, which themselves use C libraries, from your C
5098 =item Embedding Perl under Win32
5110 =head2 perldebguts - Guts of Perl debugging
5116 =item Debugger Internals
5120 =item Writing Your Own Debugger
5124 =item Frame Listing Output Examples
5126 =item Debugging regular expressions
5130 =item Compile-time output
5132 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
5133 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
5134 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
5137 =item Types of nodes
5139 =item Run-time output
5143 =item Debugging Perl memory usage
5147 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
5149 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
5150 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
5159 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
5171 =item Version caveat
5173 =item Dynamic Loading versus Static Loading
5185 =item What has gone on?
5187 =item Writing good test scripts
5191 =item What's new here?
5193 =item Input and Output Parameters
5195 =item The XSUBPP Program
5197 =item The TYPEMAP file
5199 =item Warning about Output Arguments
5203 =item What has happened here?
5205 =item Anatomy of .xs file
5207 =item Getting the fat out of XSUBs
5209 =item More about XSUB arguments
5211 =item The Argument Stack
5213 =item Extending your Extension
5215 =item Documenting your Extension
5217 =item Installing your Extension
5221 =item New Things in this Example
5225 =item New Things in this Example
5227 =item EXAMPLE 7 (Coming Soon)
5229 =item EXAMPLE 8 (Coming Soon)
5231 =item EXAMPLE 9 Passing open files to XSes
5233 =item Troubleshooting these Examples
5249 =head2 perlxs - XS language reference manual
5261 =item The Anatomy of an XSUB
5263 =item The Argument Stack
5265 =item The RETVAL Variable
5267 =item Returning SVs, AVs and HVs through RETVAL
5269 =item The MODULE Keyword
5271 =item The PACKAGE Keyword
5273 =item The PREFIX Keyword
5275 =item The OUTPUT: Keyword
5277 =item The NO_OUTPUT Keyword
5279 =item The CODE: Keyword
5281 =item The INIT: Keyword
5283 =item The NO_INIT Keyword
5285 =item Initializing Function Parameters
5287 =item Default Parameter Values
5289 =item The PREINIT: Keyword
5291 =item The SCOPE: Keyword
5293 =item The INPUT: Keyword
5295 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
5297 =item The C<length(NAME)> Keyword
5299 =item Variable-length Parameter Lists
5301 =item The C_ARGS: Keyword
5303 =item The PPCODE: Keyword
5305 =item Returning Undef And Empty Lists
5307 =item The REQUIRE: Keyword
5309 =item The CLEANUP: Keyword
5311 =item The POSTCALL: Keyword
5313 =item The BOOT: Keyword
5315 =item The VERSIONCHECK: Keyword
5317 =item The PROTOTYPES: Keyword
5319 =item The PROTOTYPE: Keyword
5321 =item The ALIAS: Keyword
5323 =item The OVERLOAD: Keyword
5325 =item The FALLBACK: Keyword
5327 =item The INTERFACE: Keyword
5329 =item The INTERFACE_MACRO: Keyword
5331 =item The INCLUDE: Keyword
5333 =item The CASE: Keyword
5335 =item The & Unary Operator
5337 =item Inserting POD, Comments and C Preprocessor Directives
5339 =item Using XS With C++
5341 =item Interface Strategy
5343 =item Perl Objects And C Structures
5347 =item Safely Storing Static Data in XS
5349 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT,
5350 aMY_CXT/pMY_CXT, MY_CXT_CLONE, MY_CXT_INIT_INTERP(my_perl),
5351 dMY_CXT_INTERP(my_perl)
5353 =item Thread-aware system interfaces
5365 =head2 perlclib - Internal replacements for standard C library functions
5375 C<t>, C<p>, C<n>, C<s>
5377 =item File Operations
5379 =item File Input and Output
5381 =item File Positioning
5383 =item Memory Management and String Handling
5385 =item Character Class Tests
5387 =item F<stdlib.h> functions
5389 =item Miscellaneous functions
5397 =head2 perlguts - Introduction to the Perl API
5409 =item What is an "IV"?
5411 =item Working with SVs
5415 =item What's Really Stored in an SV?
5417 =item Working with AVs
5419 =item Working with HVs
5421 =item Hash API Extensions
5423 =item AVs, HVs and undefined values
5427 =item Blessed References and Class Objects
5429 =item Creating New Variables
5431 GV_ADDMULTI, GV_ADDWARN
5433 =item Reference Counts and Mortality
5435 =item Stashes and Globs
5437 =item Double-Typed SVs
5439 =item Magic Variables
5441 =item Assigning Magic
5443 =item Magic Virtual Tables
5447 =item Understanding the Magic of Tied Hashes and Arrays
5449 =item Localizing changes
5451 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
5452 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
5453 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
5454 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
5455 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
5456 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
5457 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
5458 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
5459 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
5460 save_hptr(HV **hptr)>
5468 =item XSUBs and the Argument Stack
5470 =item Calling Perl Routines from within C Programs
5472 =item Memory Allocation
5476 =item Putting a C value on Perl stack
5480 =item Scratchpads and recursion
5490 =item Examining the tree
5492 =item Compile pass 1: check routines
5494 =item Compile pass 1a: constant folding
5496 =item Compile pass 2: context propagation
5498 =item Compile pass 3: peephole optimization
5500 =item Pluggable runops
5504 =item Examining internal data structures with the C<dump> functions
5506 =item How multiple interpreters and concurrency are supported
5510 =item Background and PERL_IMPLICIT_CONTEXT
5512 =item So what happened to dTHR?
5514 =item How do I use all this in extensions?
5516 =item Should I do anything special if I call perl from multiple threads?
5518 =item Future Plans and PERL_IMPLICIT_SYS
5522 =item Internal Functions
5524 A, p, d, s, n, r, f, M, o, x, m, X, E, b, others
5528 =item Formatted Printing of IVs, UVs, and NVs
5530 =item Pointer-To-Integer and Integer-To-Pointer
5532 =item Exception Handling
5534 =item Source Documentation
5536 =item Backwards compatibility
5540 =item Unicode Support
5544 =item What B<is> Unicode, anyway?
5546 =item How can I recognise a UTF-8 string?
5548 =item How does UTF-8 represent Unicode characters?
5550 =item How does Perl store UTF-8 strings?
5552 =item How do I convert a string to UTF-8?
5554 =item Is there anything else I need to know?
5558 =item Custom Operators
5566 =head2 perlcall - Perl calling conventions from C
5572 An Error Handler, An Event Driven Program
5574 =item THE CALL_ FUNCTIONS
5576 call_sv, call_pv, call_method, call_argv
5596 =item Determining the Context
5604 =item No Parameters, Nothing returned
5606 =item Passing Parameters
5608 =item Returning a Scalar
5610 =item Returning a list of values
5612 =item Returning a list in a scalar context
5614 =item Returning Data from Perl via the parameter list
5618 =item Using G_KEEPERR
5622 =item Using call_argv
5624 =item Using call_method
5628 =item Using Perl to dispose of temporaries
5630 =item Strategies for storing Callback Context Information
5632 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
5633 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
5636 =item Alternate Stack Manipulation
5638 =item Creating and calling an anonymous subroutine in C
5642 =item LIGHTWEIGHT CALLBACKS
5652 =head2 perlreapi - perl regular expression plugin interface
5664 C</m> - RXf_PMf_MULTILINE, C</s> - RXf_PMf_SINGLELINE, C</i> -
5665 RXf_PMf_FOLD, C</x> - RXf_PMf_EXTENDED, C</p> - RXf_PMf_KEEPCOPY,
5666 RXf_PMf_LOCALE, RXf_UTF8, RXf_SPLIT, RXf_SKIPWHITE, RXf_START_ONLY,
5677 =item Numbered capture callbacks
5679 =item Named capture callbacks
5687 =item The REGEXP structure
5697 =item C<minlen> C<minlenret>
5703 =item C<nparens>, C<lasparen>, and C<lastcloseparen>
5713 =item C<precomp> C<prelen>
5715 =item C<paren_names>
5719 =item C<subbeg> C<sublen> C<saved_copy>
5721 =item C<wrapped> C<wraplen>
5737 =head2 perlreguts - Description of the Perl regular expression engine.
5747 =item A quick note on terms
5749 =item What is a regular expression engine?
5751 =item Structure of a Regexp Program
5753 C<regnode_1>, C<regnode_2>, C<regnode_string>, C<regnode_charclass>,
5754 C<regnode_charclass_class>
5758 =item Process Overview
5760 A. Compilation, 1. Parsing for size, 2. Parsing for construction, 3.
5761 Peep-hole optimisation and analysis, B. Execution, 4. Start position and
5762 no-match optimisations, 5. Program execution
5768 anchored fixed strings, floating fixed strings, minimum and maximum length
5769 requirements, start class, Beginning/End of line positions
5779 =item Unicode and Localisation Support
5781 =item Base Structures
5783 C<swap>, C<offsets>, C<regstclass>, C<data>, C<program>
5797 =head2 perlapi - autogenerated documentation for the perl public API
5802 X<Perl API> X<API> X<api>
5804 =item "Gimme" Values
5806 GIMME X<GIMME>, GIMME_V X<GIMME_V>, G_ARRAY X<G_ARRAY>, G_DISCARD
5807 X<G_DISCARD>, G_EVAL X<G_EVAL>, G_NOARGS X<G_NOARGS>, G_SCALAR X<G_SCALAR>,
5810 =item Array Manipulation Functions
5812 AvFILL X<AvFILL>, av_clear X<av_clear>, av_create_and_push
5813 X<av_create_and_push>, av_create_and_unshift_one
5814 X<av_create_and_unshift_one>, av_delete X<av_delete>, av_exists
5815 X<av_exists>, av_extend X<av_extend>, av_fetch X<av_fetch>, av_fill
5816 X<av_fill>, av_len X<av_len>, av_make X<av_make>, av_pop X<av_pop>, av_push
5817 X<av_push>, av_shift X<av_shift>, av_store X<av_store>, av_undef
5818 X<av_undef>, av_unshift X<av_unshift>, get_av X<get_av>, newAV X<newAV>,
5819 sortsv X<sortsv>, sortsv_flags X<sortsv_flags>
5821 =item Callback Functions
5823 call_argv X<call_argv>, call_method X<call_method>, call_pv X<call_pv>,
5824 call_sv X<call_sv>, ENTER X<ENTER>, eval_pv X<eval_pv>, eval_sv X<eval_sv>,
5825 FREETMPS X<FREETMPS>, LEAVE X<LEAVE>, SAVETMPS X<SAVETMPS>
5827 =item Character classes
5829 isALNUM X<isALNUM>, isALPHA X<isALPHA>, isDIGIT X<isDIGIT>, isLOWER
5830 X<isLOWER>, isSPACE X<isSPACE>, isUPPER X<isUPPER>, toLOWER X<toLOWER>,
5833 =item Cloning an interpreter
5835 perl_clone X<perl_clone>
5837 =item CV Manipulation Functions
5839 CvSTASH X<CvSTASH>, get_cv X<get_cv>, get_cvn_flags X<get_cvn_flags>
5841 =item Embedding Functions
5843 cv_undef X<cv_undef>, load_module X<load_module>, nothreadhook
5844 X<nothreadhook>, perl_alloc X<perl_alloc>, perl_construct
5845 X<perl_construct>, perl_destruct X<perl_destruct>, perl_free X<perl_free>,
5846 perl_parse X<perl_parse>, perl_run X<perl_run>, require_pv X<require_pv>
5848 =item Functions in file dump.c
5850 pv_display X<pv_display>, pv_escape X<pv_escape>, pv_pretty X<pv_pretty>
5852 =item Functions in file mathoms.c
5854 gv_fetchmethod X<gv_fetchmethod>, pack_cat X<pack_cat>, sv_2pvbyte_nolen
5855 X<sv_2pvbyte_nolen>, sv_2pvutf8_nolen X<sv_2pvutf8_nolen>, sv_2pv_nolen
5856 X<sv_2pv_nolen>, sv_catpvn_mg X<sv_catpvn_mg>, sv_catsv_mg X<sv_catsv_mg>,
5857 sv_force_normal X<sv_force_normal>, sv_iv X<sv_iv>, sv_nolocking
5858 X<sv_nolocking>, sv_nounlocking X<sv_nounlocking>, sv_nv X<sv_nv>, sv_pv
5859 X<sv_pv>, sv_pvbyte X<sv_pvbyte>, sv_pvbyten X<sv_pvbyten>, sv_pvn
5860 X<sv_pvn>, sv_pvutf8 X<sv_pvutf8>, sv_pvutf8n X<sv_pvutf8n>, sv_taint
5861 X<sv_taint>, sv_unref X<sv_unref>, sv_usepvn X<sv_usepvn>, sv_usepvn_mg
5862 X<sv_usepvn_mg>, sv_uv X<sv_uv>, unpack_str X<unpack_str>
5864 =item Functions in file pp_ctl.c
5866 find_runcv X<find_runcv>
5868 =item Functions in file pp_pack.c
5870 packlist X<packlist>, unpackstring X<unpackstring>
5872 =item Functions in file pp_sys.c
5874 setdefout X<setdefout>
5878 GvSV X<GvSV>, gv_const_sv X<gv_const_sv>, gv_fetchmeth X<gv_fetchmeth>,
5879 gv_fetchmethod_autoload X<gv_fetchmethod_autoload>, gv_fetchmeth_autoload
5880 X<gv_fetchmeth_autoload>, gv_stashpv X<gv_stashpv>, gv_stashpvn
5881 X<gv_stashpvn>, gv_stashpvs X<gv_stashpvs>, gv_stashsv X<gv_stashsv>
5885 Nullav X<Nullav>, Nullch X<Nullch>, Nullcv X<Nullcv>, Nullhv X<Nullhv>,
5888 =item Hash Manipulation Functions
5890 get_hv X<get_hv>, HEf_SVKEY X<HEf_SVKEY>, HeHASH X<HeHASH>, HeKEY X<HeKEY>,
5891 HeKLEN X<HeKLEN>, HePV X<HePV>, HeSVKEY X<HeSVKEY>, HeSVKEY_force
5892 X<HeSVKEY_force>, HeSVKEY_set X<HeSVKEY_set>, HeUTF8 X<HeUTF8>, HeVAL
5893 X<HeVAL>, HvNAME X<HvNAME>, hv_assert X<hv_assert>, hv_clear X<hv_clear>,
5894 hv_clear_placeholders X<hv_clear_placeholders>, hv_delete X<hv_delete>,
5895 hv_delete_ent X<hv_delete_ent>, hv_exists X<hv_exists>, hv_exists_ent
5896 X<hv_exists_ent>, hv_fetch X<hv_fetch>, hv_fetchs X<hv_fetchs>,
5897 hv_fetch_ent X<hv_fetch_ent>, hv_iterinit X<hv_iterinit>, hv_iterkey
5898 X<hv_iterkey>, hv_iterkeysv X<hv_iterkeysv>, hv_iternext X<hv_iternext>,
5899 hv_iternextsv X<hv_iternextsv>, hv_iternext_flags X<hv_iternext_flags>,
5900 hv_iterval X<hv_iterval>, hv_magic X<hv_magic>, hv_scalar X<hv_scalar>,
5901 hv_store X<hv_store>, hv_stores X<hv_stores>, hv_store_ent X<hv_store_ent>,
5902 hv_undef X<hv_undef>, newHV X<newHV>
5904 =item Magical Functions
5906 mg_clear X<mg_clear>, mg_copy X<mg_copy>, mg_find X<mg_find>, mg_free
5907 X<mg_free>, mg_get X<mg_get>, mg_length X<mg_length>, mg_magical
5908 X<mg_magical>, mg_set X<mg_set>, SvGETMAGIC X<SvGETMAGIC>, SvLOCK
5909 X<SvLOCK>, SvSETMAGIC X<SvSETMAGIC>, SvSetMagicSV X<SvSetMagicSV>,
5910 SvSetMagicSV_nosteal X<SvSetMagicSV_nosteal>, SvSetSV X<SvSetSV>,
5911 SvSetSV_nosteal X<SvSetSV_nosteal>, SvSHARE X<SvSHARE>, SvUNLOCK
5914 =item Memory Management
5916 Copy X<Copy>, CopyD X<CopyD>, Move X<Move>, MoveD X<MoveD>, Newx X<Newx>,
5917 Newxc X<Newxc>, Newxz X<Newxz>, Poison X<Poison>, PoisonFree X<PoisonFree>,
5918 PoisonNew X<PoisonNew>, PoisonWith X<PoisonWith>, Renew X<Renew>, Renewc
5919 X<Renewc>, Safefree X<Safefree>, savepv X<savepv>, savepvn X<savepvn>,
5920 savepvs X<savepvs>, savesharedpv X<savesharedpv>, savesharedpvn
5921 X<savesharedpvn>, savesvpv X<savesvpv>, StructCopy X<StructCopy>, Zero
5922 X<Zero>, ZeroD X<ZeroD>
5924 =item Miscellaneous Functions
5926 fbm_compile X<fbm_compile>, fbm_instr X<fbm_instr>, form X<form>, getcwd_sv
5927 X<getcwd_sv>, my_snprintf X<my_snprintf>, my_sprintf X<my_sprintf>,
5928 my_vsnprintf X<my_vsnprintf>, new_version X<new_version>, scan_version
5929 X<scan_version>, strEQ X<strEQ>, strGE X<strGE>, strGT X<strGT>, strLE
5930 X<strLE>, strLT X<strLT>, strNE X<strNE>, strnEQ X<strnEQ>, strnNE
5931 X<strnNE>, sv_destroyable X<sv_destroyable>, sv_nosharing X<sv_nosharing>,
5932 upg_version X<upg_version>, vcmp X<vcmp>, vnormal X<vnormal>, vnumify
5933 X<vnumify>, vstringify X<vstringify>, vverify X<vverify>
5937 mro_get_linear_isa X<mro_get_linear_isa>, mro_method_changed_in
5938 X<mro_method_changed_in>
5940 =item Multicall Functions
5942 dMULTICALL X<dMULTICALL>, MULTICALL X<MULTICALL>, POP_MULTICALL
5943 X<POP_MULTICALL>, PUSH_MULTICALL X<PUSH_MULTICALL>
5945 =item Numeric functions
5947 grok_bin X<grok_bin>, grok_hex X<grok_hex>, grok_number X<grok_number>,
5948 grok_numeric_radix X<grok_numeric_radix>, grok_oct X<grok_oct>,
5949 Perl_signbit X<Perl_signbit>, scan_bin X<scan_bin>, scan_hex X<scan_hex>,
5950 scan_oct X<scan_oct>
5952 =item Optree Manipulation Functions
5954 cv_const_sv X<cv_const_sv>, newCONSTSUB X<newCONSTSUB>, newXS X<newXS>
5956 =item Pad Data Structures
5960 =item Per-Interpreter Variables
5962 PL_modglobal X<PL_modglobal>, PL_na X<PL_na>, PL_sv_no X<PL_sv_no>,
5963 PL_sv_undef X<PL_sv_undef>, PL_sv_yes X<PL_sv_yes>
5965 =item REGEXP Functions
5967 SvRX X<SvRX>, SvRXOK X<SvRXOK>
5969 =item Simple Exception Handling Macros
5971 dXCPT X<dXCPT>, XCPT_CATCH X<XCPT_CATCH>, XCPT_RETHROW X<XCPT_RETHROW>,
5972 XCPT_TRY_END X<XCPT_TRY_END>, XCPT_TRY_START X<XCPT_TRY_START>
5974 =item Stack Manipulation Macros
5976 dMARK X<dMARK>, dORIGMARK X<dORIGMARK>, dSP X<dSP>, EXTEND X<EXTEND>, MARK
5977 X<MARK>, mPUSHi X<mPUSHi>, mPUSHn X<mPUSHn>, mPUSHp X<mPUSHp>, mPUSHs
5978 X<mPUSHs>, mPUSHu X<mPUSHu>, mXPUSHi X<mXPUSHi>, mXPUSHn X<mXPUSHn>,
5979 mXPUSHp X<mXPUSHp>, mXPUSHs X<mXPUSHs>, mXPUSHu X<mXPUSHu>, ORIGMARK
5980 X<ORIGMARK>, POPi X<POPi>, POPl X<POPl>, POPn X<POPn>, POPp X<POPp>,
5981 POPpbytex X<POPpbytex>, POPpx X<POPpx>, POPs X<POPs>, PUSHi X<PUSHi>,
5982 PUSHMARK X<PUSHMARK>, PUSHmortal X<PUSHmortal>, PUSHn X<PUSHn>, PUSHp
5983 X<PUSHp>, PUSHs X<PUSHs>, PUSHu X<PUSHu>, PUTBACK X<PUTBACK>, SP X<SP>,
5984 SPAGAIN X<SPAGAIN>, XPUSHi X<XPUSHi>, XPUSHmortal X<XPUSHmortal>, XPUSHn
5985 X<XPUSHn>, XPUSHp X<XPUSHp>, XPUSHs X<XPUSHs>, XPUSHu X<XPUSHu>, XSRETURN
5986 X<XSRETURN>, XSRETURN_EMPTY X<XSRETURN_EMPTY>, XSRETURN_IV X<XSRETURN_IV>,
5987 XSRETURN_NO X<XSRETURN_NO>, XSRETURN_NV X<XSRETURN_NV>, XSRETURN_PV
5988 X<XSRETURN_PV>, XSRETURN_UNDEF X<XSRETURN_UNDEF>, XSRETURN_UV
5989 X<XSRETURN_UV>, XSRETURN_YES X<XSRETURN_YES>, XST_mIV X<XST_mIV>, XST_mNO
5990 X<XST_mNO>, XST_mNV X<XST_mNV>, XST_mPV X<XST_mPV>, XST_mUNDEF
5991 X<XST_mUNDEF>, XST_mYES X<XST_mYES>
5995 svtype X<svtype>, SVt_IV X<SVt_IV>, SVt_NV X<SVt_NV>, SVt_PV X<SVt_PV>,
5996 SVt_PVAV X<SVt_PVAV>, SVt_PVCV X<SVt_PVCV>, SVt_PVHV X<SVt_PVHV>, SVt_PVMG
5999 =item SV Manipulation Functions
6001 croak_xs_usage X<croak_xs_usage>, get_sv X<get_sv>, newRV_inc X<newRV_inc>,
6002 newSVpvn_utf8 X<newSVpvn_utf8>, SvCUR X<SvCUR>, SvCUR_set X<SvCUR_set>,
6003 SvEND X<SvEND>, SvGAMAGIC X<SvGAMAGIC>, SvGROW X<SvGROW>, SvIOK X<SvIOK>,
6004 SvIOKp X<SvIOKp>, SvIOK_notUV X<SvIOK_notUV>, SvIOK_off X<SvIOK_off>,
6005 SvIOK_on X<SvIOK_on>, SvIOK_only X<SvIOK_only>, SvIOK_only_UV
6006 X<SvIOK_only_UV>, SvIOK_UV X<SvIOK_UV>, SvIsCOW X<SvIsCOW>,
6007 SvIsCOW_shared_hash X<SvIsCOW_shared_hash>, SvIV X<SvIV>, SvIVX X<SvIVX>,
6008 SvIVx X<SvIVx>, SvIV_nomg X<SvIV_nomg>, SvIV_set X<SvIV_set>, SvLEN
6009 X<SvLEN>, SvLEN_set X<SvLEN_set>, SvMAGIC_set X<SvMAGIC_set>, SvNIOK
6010 X<SvNIOK>, SvNIOKp X<SvNIOKp>, SvNIOK_off X<SvNIOK_off>, SvNOK X<SvNOK>,
6011 SvNOKp X<SvNOKp>, SvNOK_off X<SvNOK_off>, SvNOK_on X<SvNOK_on>, SvNOK_only
6012 X<SvNOK_only>, SvNV X<SvNV>, SvNVX X<SvNVX>, SvNVx X<SvNVx>, SvNV_set
6013 X<SvNV_set>, SvOK X<SvOK>, SvOOK X<SvOOK>, SvOOK_offset X<SvOOK_offset>,
6014 SvPOK X<SvPOK>, SvPOKp X<SvPOKp>, SvPOK_off X<SvPOK_off>, SvPOK_on
6015 X<SvPOK_on>, SvPOK_only X<SvPOK_only>, SvPOK_only_UTF8 X<SvPOK_only_UTF8>,
6016 SvPV X<SvPV>, SvPVbyte X<SvPVbyte>, SvPVbytex X<SvPVbytex>, SvPVbytex_force
6017 X<SvPVbytex_force>, SvPVbyte_force X<SvPVbyte_force>, SvPVbyte_nolen
6018 X<SvPVbyte_nolen>, SvPVutf8 X<SvPVutf8>, SvPVutf8x X<SvPVutf8x>,
6019 SvPVutf8x_force X<SvPVutf8x_force>, SvPVutf8_force X<SvPVutf8_force>,
6020 SvPVutf8_nolen X<SvPVutf8_nolen>, SvPVX X<SvPVX>, SvPVx X<SvPVx>,
6021 SvPV_force X<SvPV_force>, SvPV_force_nomg X<SvPV_force_nomg>, SvPV_nolen
6022 X<SvPV_nolen>, SvPV_nomg X<SvPV_nomg>, SvPV_set X<SvPV_set>, SvREFCNT
6023 X<SvREFCNT>, SvREFCNT_dec X<SvREFCNT_dec>, SvREFCNT_inc X<SvREFCNT_inc>,
6024 SvREFCNT_inc_NN X<SvREFCNT_inc_NN>, SvREFCNT_inc_simple
6025 X<SvREFCNT_inc_simple>, SvREFCNT_inc_simple_NN X<SvREFCNT_inc_simple_NN>,
6026 SvREFCNT_inc_simple_void X<SvREFCNT_inc_simple_void>,
6027 SvREFCNT_inc_simple_void_NN X<SvREFCNT_inc_simple_void_NN>,
6028 SvREFCNT_inc_void X<SvREFCNT_inc_void>, SvREFCNT_inc_void_NN
6029 X<SvREFCNT_inc_void_NN>, SvROK X<SvROK>, SvROK_off X<SvROK_off>, SvROK_on
6030 X<SvROK_on>, SvRV X<SvRV>, SvRV_set X<SvRV_set>, SvSTASH X<SvSTASH>,
6031 SvSTASH_set X<SvSTASH_set>, SvTAINT X<SvTAINT>, SvTAINTED X<SvTAINTED>,
6032 SvTAINTED_off X<SvTAINTED_off>, SvTAINTED_on X<SvTAINTED_on>, SvTRUE
6033 X<SvTRUE>, SvTYPE X<SvTYPE>, SvUOK X<SvUOK>, SvUPGRADE X<SvUPGRADE>, SvUTF8
6034 X<SvUTF8>, SvUTF8_off X<SvUTF8_off>, SvUTF8_on X<SvUTF8_on>, SvUV X<SvUV>,
6035 SvUVX X<SvUVX>, SvUVx X<SvUVx>, SvUV_nomg X<SvUV_nomg>, SvUV_set
6036 X<SvUV_set>, SvVOK X<SvVOK>, sv_catpvn_nomg X<sv_catpvn_nomg>,
6037 sv_catsv_nomg X<sv_catsv_nomg>, sv_derived_from X<sv_derived_from>, sv_does
6038 X<sv_does>, sv_report_used X<sv_report_used>, sv_setsv_nomg
6039 X<sv_setsv_nomg>, sv_utf8_upgrade_nomg X<sv_utf8_upgrade_nomg>
6041 =item SV-Body Allocation
6043 looks_like_number X<looks_like_number>, newRV_noinc X<newRV_noinc>, newSV
6044 X<newSV>, newSVhek X<newSVhek>, newSViv X<newSViv>, newSVnv X<newSVnv>,
6045 newSVpv X<newSVpv>, newSVpvf X<newSVpvf>, newSVpvn X<newSVpvn>,
6046 newSVpvn_flags X<newSVpvn_flags>, newSVpvn_share X<newSVpvn_share>,
6047 newSVpvs X<newSVpvs>, newSVpvs_flags X<newSVpvs_flags>, newSVpvs_share
6048 X<newSVpvs_share>, newSVrv X<newSVrv>, newSVsv X<newSVsv>, newSVuv
6049 X<newSVuv>, newSV_type X<newSV_type>, sv_2bool X<sv_2bool>, sv_2cv
6050 X<sv_2cv>, sv_2io X<sv_2io>, sv_2iv_flags X<sv_2iv_flags>, sv_2mortal
6051 X<sv_2mortal>, sv_2nv X<sv_2nv>, sv_2pvbyte X<sv_2pvbyte>, sv_2pvutf8
6052 X<sv_2pvutf8>, sv_2pv_flags X<sv_2pv_flags>, sv_2uv_flags X<sv_2uv_flags>,
6053 sv_backoff X<sv_backoff>, sv_bless X<sv_bless>, sv_catpv X<sv_catpv>,
6054 sv_catpvf X<sv_catpvf>, sv_catpvf_mg X<sv_catpvf_mg>, sv_catpvn
6055 X<sv_catpvn>, sv_catpvn_flags X<sv_catpvn_flags>, sv_catpvs X<sv_catpvs>,
6056 sv_catpv_mg X<sv_catpv_mg>, sv_catsv X<sv_catsv>, sv_catsv_flags
6057 X<sv_catsv_flags>, sv_chop X<sv_chop>, sv_clear X<sv_clear>, sv_cmp
6058 X<sv_cmp>, sv_cmp_locale X<sv_cmp_locale>, sv_collxfrm X<sv_collxfrm>,
6059 sv_copypv X<sv_copypv>, sv_dec X<sv_dec>, sv_eq X<sv_eq>,
6060 sv_force_normal_flags X<sv_force_normal_flags>, sv_free X<sv_free>, sv_gets
6061 X<sv_gets>, sv_grow X<sv_grow>, sv_inc X<sv_inc>, sv_insert X<sv_insert>,
6062 sv_insert_flags X<sv_insert_flags>, sv_isa X<sv_isa>, sv_isobject
6063 X<sv_isobject>, sv_len X<sv_len>, sv_len_utf8 X<sv_len_utf8>, sv_magic
6064 X<sv_magic>, sv_magicext X<sv_magicext>, sv_mortalcopy X<sv_mortalcopy>,
6065 sv_newmortal X<sv_newmortal>, sv_newref X<sv_newref>, sv_pos_b2u
6066 X<sv_pos_b2u>, sv_pos_u2b X<sv_pos_u2b>, sv_pvbyten_force
6067 X<sv_pvbyten_force>, sv_pvn_force X<sv_pvn_force>, sv_pvn_force_flags
6068 X<sv_pvn_force_flags>, sv_pvutf8n_force X<sv_pvutf8n_force>, sv_reftype
6069 X<sv_reftype>, sv_replace X<sv_replace>, sv_reset X<sv_reset>, sv_rvweaken
6070 X<sv_rvweaken>, sv_setiv X<sv_setiv>, sv_setiv_mg X<sv_setiv_mg>, sv_setnv
6071 X<sv_setnv>, sv_setnv_mg X<sv_setnv_mg>, sv_setpv X<sv_setpv>, sv_setpvf
6072 X<sv_setpvf>, sv_setpvf_mg X<sv_setpvf_mg>, sv_setpviv X<sv_setpviv>,
6073 sv_setpviv_mg X<sv_setpviv_mg>, sv_setpvn X<sv_setpvn>, sv_setpvn_mg
6074 X<sv_setpvn_mg>, sv_setpvs X<sv_setpvs>, sv_setpv_mg X<sv_setpv_mg>,
6075 sv_setref_iv X<sv_setref_iv>, sv_setref_nv X<sv_setref_nv>, sv_setref_pv
6076 X<sv_setref_pv>, sv_setref_pvn X<sv_setref_pvn>, sv_setref_uv
6077 X<sv_setref_uv>, sv_setsv X<sv_setsv>, sv_setsv_flags X<sv_setsv_flags>,
6078 sv_setsv_mg X<sv_setsv_mg>, sv_setuv X<sv_setuv>, sv_setuv_mg
6079 X<sv_setuv_mg>, sv_tainted X<sv_tainted>, sv_true X<sv_true>, sv_unmagic
6080 X<sv_unmagic>, sv_unref_flags X<sv_unref_flags>, sv_untaint X<sv_untaint>,
6081 sv_upgrade X<sv_upgrade>, sv_usepvn_flags X<sv_usepvn_flags>,
6082 sv_utf8_decode X<sv_utf8_decode>, sv_utf8_downgrade X<sv_utf8_downgrade>,
6083 sv_utf8_encode X<sv_utf8_encode>, sv_utf8_upgrade X<sv_utf8_upgrade>,
6084 sv_utf8_upgrade_flags X<sv_utf8_upgrade_flags>, sv_vcatpvf X<sv_vcatpvf>,
6085 sv_vcatpvfn X<sv_vcatpvfn>, sv_vcatpvf_mg X<sv_vcatpvf_mg>, sv_vsetpvf
6086 X<sv_vsetpvf>, sv_vsetpvfn X<sv_vsetpvfn>, sv_vsetpvf_mg X<sv_vsetpvf_mg>
6088 =item Unicode Support
6090 bytes_from_utf8 X<bytes_from_utf8>, bytes_to_utf8 X<bytes_to_utf8>,
6091 ibcmp_utf8 X<ibcmp_utf8>, is_utf8_char X<is_utf8_char>, is_utf8_string
6092 X<is_utf8_string>, is_utf8_string_loc X<is_utf8_string_loc>,
6093 is_utf8_string_loclen X<is_utf8_string_loclen>, pv_uni_display
6094 X<pv_uni_display>, sv_cat_decode X<sv_cat_decode>, sv_recode_to_utf8
6095 X<sv_recode_to_utf8>, sv_uni_display X<sv_uni_display>, to_utf8_case
6096 X<to_utf8_case>, to_utf8_fold X<to_utf8_fold>, to_utf8_lower
6097 X<to_utf8_lower>, to_utf8_title X<to_utf8_title>, to_utf8_upper
6098 X<to_utf8_upper>, utf8n_to_uvchr X<utf8n_to_uvchr>, utf8n_to_uvuni
6099 X<utf8n_to_uvuni>, utf8_distance X<utf8_distance>, utf8_hop X<utf8_hop>,
6100 utf8_length X<utf8_length>, utf8_to_bytes X<utf8_to_bytes>, utf8_to_uvchr
6101 X<utf8_to_uvchr>, utf8_to_uvuni X<utf8_to_uvuni>, uvchr_to_utf8
6102 X<uvchr_to_utf8>, uvuni_to_utf8_flags X<uvuni_to_utf8_flags>
6104 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
6106 ax X<ax>, CLASS X<CLASS>, dAX X<dAX>, dAXMARK X<dAXMARK>, dITEMS X<dITEMS>,
6107 dUNDERBAR X<dUNDERBAR>, dXSARGS X<dXSARGS>, dXSI32 X<dXSI32>, items
6108 X<items>, ix X<ix>, newXSproto X<newXSproto>, RETVAL X<RETVAL>, ST X<ST>,
6109 THIS X<THIS>, UNDERBAR X<UNDERBAR>, XS X<XS>, XS_VERSION X<XS_VERSION>,
6110 XS_VERSION_BOOTCHECK X<XS_VERSION_BOOTCHECK>
6112 =item Warning and Dieing
6114 croak X<croak>, warn X<warn>
6122 =head2 perlintern - autogenerated documentation of purely B<internal>
6128 X<internal Perl functions> X<interpreter functions>
6130 =item CV reference counts and CvOUTSIDE
6132 CvWEAKOUTSIDE X<CvWEAKOUTSIDE>
6134 =item Functions in file pad.h
6136 CX_CURPAD_SAVE X<CX_CURPAD_SAVE>, CX_CURPAD_SV X<CX_CURPAD_SV>, PAD_BASE_SV
6137 X<PAD_BASE_SV>, PAD_CLONE_VARS X<PAD_CLONE_VARS>, PAD_COMPNAME_FLAGS
6138 X<PAD_COMPNAME_FLAGS>, PAD_COMPNAME_GEN X<PAD_COMPNAME_GEN>,
6139 PAD_COMPNAME_GEN_set X<PAD_COMPNAME_GEN_set>, PAD_COMPNAME_OURSTASH
6140 X<PAD_COMPNAME_OURSTASH>, PAD_COMPNAME_PV X<PAD_COMPNAME_PV>,
6141 PAD_COMPNAME_TYPE X<PAD_COMPNAME_TYPE>, PAD_DUP X<PAD_DUP>,
6142 PAD_RESTORE_LOCAL X<PAD_RESTORE_LOCAL>, PAD_SAVE_LOCAL X<PAD_SAVE_LOCAL>,
6143 PAD_SAVE_SETNULLPAD X<PAD_SAVE_SETNULLPAD>, PAD_SETSV X<PAD_SETSV>,
6144 PAD_SET_CUR X<PAD_SET_CUR>, PAD_SET_CUR_NOSAVE X<PAD_SET_CUR_NOSAVE>,
6145 PAD_SV X<PAD_SV>, PAD_SVl X<PAD_SVl>, SAVECLEARSV X<SAVECLEARSV>,
6146 SAVECOMPPAD X<SAVECOMPPAD>, SAVEPADSV X<SAVEPADSV>
6150 is_gv_magical_sv X<is_gv_magical_sv>
6152 =item Hash Manipulation Functions
6154 refcounted_he_chain_2hv X<refcounted_he_chain_2hv>, refcounted_he_free
6155 X<refcounted_he_free>, refcounted_he_new X<refcounted_he_new>
6159 start_glob X<start_glob>
6161 =item Magical Functions
6163 magic_clearhint X<magic_clearhint>, magic_sethint X<magic_sethint>,
6164 mg_localize X<mg_localize>
6168 mro_get_linear_isa_c3 X<mro_get_linear_isa_c3>, mro_get_linear_isa_dfs
6169 X<mro_get_linear_isa_dfs>, mro_isa_changed_in X<mro_isa_changed_in>
6171 =item Pad Data Structures
6173 CvPADLIST X<CvPADLIST>, cv_clone X<cv_clone>, cv_dump X<cv_dump>,
6174 do_dump_pad X<do_dump_pad>, intro_my X<intro_my>, pad_add_anon
6175 X<pad_add_anon>, pad_add_name X<pad_add_name>, pad_alloc X<pad_alloc>,
6176 pad_block_start X<pad_block_start>, pad_check_dup X<pad_check_dup>,
6177 pad_findlex X<pad_findlex>, pad_findmy X<pad_findmy>, pad_fixup_inner_anons
6178 X<pad_fixup_inner_anons>, pad_free X<pad_free>, pad_leavemy X<pad_leavemy>,
6179 pad_new X<pad_new>, pad_push X<pad_push>, pad_reset X<pad_reset>, pad_setsv
6180 X<pad_setsv>, pad_swipe X<pad_swipe>, pad_tidy X<pad_tidy>, pad_undef
6183 =item Per-Interpreter Variables
6185 PL_DBsingle X<PL_DBsingle>, PL_DBsub X<PL_DBsub>, PL_DBtrace X<PL_DBtrace>,
6186 PL_dowarn X<PL_dowarn>, PL_last_in_gv X<PL_last_in_gv>, PL_ofsgv
6187 X<PL_ofsgv>, PL_rs X<PL_rs>
6189 =item Stack Manipulation Macros
6191 djSP X<djSP>, LVRET X<LVRET>
6193 =item SV Manipulation Functions
6195 sv_add_arena X<sv_add_arena>, sv_clean_all X<sv_clean_all>, sv_clean_objs
6196 X<sv_clean_objs>, sv_free_arenas X<sv_free_arenas>
6198 =item SV-Body Allocation
6202 =item Unicode Support
6204 find_uninit_var X<find_uninit_var>, report_uninit X<report_uninit>
6212 =head2 perliol - C API for Perl's implementation of IO in Layers.
6222 =item History and Background
6224 =item Basic Structure
6226 =item Layers vs Disciplines
6228 =item Data Structures
6230 =item Functions and Attributes
6232 =item Per-instance Data
6234 =item Layers in action.
6236 =item Per-instance flag bits
6238 PERLIO_F_EOF, PERLIO_F_CANWRITE, PERLIO_F_CANREAD, PERLIO_F_ERROR,
6239 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
6240 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
6241 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
6243 =item Methods in Detail
6245 fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF,
6246 PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode,
6247 Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof,
6248 Error, Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
6253 =item Implementing PerlIO Layers
6255 C implementations, Perl implementations
6259 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
6261 =item Extension Layers
6263 ":encoding", ":scalar", ":via"
6271 =head2 perlapio - perl's IO abstraction interface.
6279 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
6280 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
6281 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
6282 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
6283 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
6284 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
6285 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
6286 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
6287 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
6288 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
6289 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
6293 =item Co-existence with stdio
6295 B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
6296 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
6298 =item "Fast gets" Functions
6300 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
6301 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
6302 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
6303 B<PerlIO_get_bufsiz(f)>
6305 =item Other Functions
6307 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
6308 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
6314 =head2 perlhack - How to hack at the Perl internals
6320 Does concept match the general goals of Perl?, Where is the
6321 implementation?, Backwards compatibility, Could it be a module instead?, Is
6322 the feature generic enough?, Does it potentially introduce new bugs?, Does
6323 it preclude other desirable features?, Is the implementation robust?, Is
6324 the implementation generic enough to be portable?, Is the implementation
6325 tested?, Is there enough documentation?, Is there another way to do it?,
6326 Does it create too much work?, Patches speak louder than words
6330 =item Keeping in sync
6332 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
6333 NFS, rsync'ing the patches
6335 =item Why rsync the source tree
6337 It's easier to rsync the source tree, It's more reliable
6339 =item Why rsync the patches
6341 It's easier to rsync the patches, It's a good reference, Finding a start
6342 point, Finding how to fix a bug, Finding the source of misbehaviour
6344 =item Working with the source
6346 =item Perlbug administration
6348 =item Submitting patches
6350 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
6351 F<Porting/pumpkin.pod>, The perl5-porters FAQ
6353 =item Finding Your Way Around
6355 Core modules, Tests, Documentation, Configure, Interpreter
6357 =item Elements of the interpreter
6359 Startup, Parsing, Optimization, Running, Exception handing
6361 =item Internal Variable Types
6367 Argument stack, Mark stack, Save stack
6369 =item Millions of Macros
6371 =item The .i Targets
6375 =item SOURCE CODE STATIC ANALYSIS
6383 =item cpd (cut-and-paste detector)
6387 =item Warnings of other C compilers
6391 =item Poking at Perl
6393 =item Using a source-level debugger
6395 run [args], break function_name, break source.c:xxx, step, next, continue,
6396 finish, 'enter', print
6398 =item gdb macro support
6400 =item Dumping Perl Data Structures
6404 =item Patching a core module
6406 =item Adding a new function to the core
6408 =item Writing a test
6410 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/mro/>,
6411 F<t/op/>, F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base
6412 t/comp, t/cmd t/run t/io t/op, t/lib ext lib
6414 =item Special Make Test Targets
6416 coretest, test.deparse, test.taintwarn, minitest, test.valgrind
6417 check.valgrind utest.valgrind ucheck.valgrind, test.third check.third
6418 utest.third ucheck.third, test.torture torturetest, utest ucheck test.utf8
6419 check.utf8, minitest.utf16 test.utf16, test_harness, test-notty test_notty
6421 =item Running tests by hand
6423 -v, -torture, -re=PATTERN, -re LIST OF PATTERNS, PERL_CORE=1,
6424 PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST, PERL_TEST_Net_Ping,
6425 PERL_TEST_NOVREXX, PERL_TEST_NUMCONVERTS
6427 =item Common problems when patching Perl source code
6429 =item Perl environment problems
6431 =item Portability problems
6433 =item Problematic System Interfaces
6435 =item Security problems
6439 =item EXTERNAL TOOLS FOR DEBUGGING PERL
6443 =item Rational Software's Purify
6445 =item Purify on Unix
6447 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
6451 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
6455 =item Compaq's/Digital's/HP's Third Degree
6457 =item PERL_DESTRUCT_LEVEL
6463 =item Gprof Profiling
6465 -a, -b, -e routine, -f routine, -s, -z
6467 =item GCC gcov Profiling
6469 =item Pixie Profiling
6471 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
6474 =item Miscellaneous tricks
6480 I<The Road goes ever on and on, down from the door where it began.>
6484 =item Metaphoric Quotations
6492 =head2 perlrepository - Using the Perl source repository
6498 =item GETTING ACCESS TO THE REPOSITORY
6502 =item READ ACCESS VIA THE WEB
6504 =item READ ACCESS VIA GIT
6506 =item WRITE ACCESS TO THE REPOSITORY
6510 =item OVERVIEW OF THE REPOSITORY
6514 =item FINDING OUT YOUR STATUS
6518 =item SUBMITTING A PATCH
6520 =item ACCEPTING A PATCH
6524 =head2 perlbook - Perl book information
6532 =head2 perlcommunity - a brief overview of the Perl community
6540 =item Where to find the community
6542 =item Mailing lists and Newsgroups
6548 L<http://perl.com/>, L<http://use.perl.org/>, L<http://www.perlmonks.org/>
6558 =item Calendar of Perl Events
6566 =head2 perltodo - Perl TO-DO List
6572 =item Tasks that only need Perl knowledge
6576 =item Smartmatch design issues
6578 =item Remove duplication of test setup.
6580 =item POD -E<gt> HTML conversion in the core still sucks
6582 =item merge checkpods and podchecker
6584 =item Parallel testing
6586 =item Make Schwern poorer
6588 =item Improve the coverage of the core tests
6592 =item A decent benchmark
6594 =item fix tainting bugs
6596 =item Dual life everything
6598 =item Bundle dual life modules in ext/
6600 =item POSIX memory footprint
6602 =item embed.pl/makedef.pl
6604 =item use strict; and AutoLoad
6606 =item profile installman
6610 =item Tasks that need a little sysadmin-type knowledge
6614 =item make HTML install work
6616 =item compressed man pages
6618 =item Add a code coverage target to the Makefile
6620 =item Make Config.pm cope with differences between built and installed perl
6622 =item linker specification files
6624 =item Cross-compile support
6628 =item Split "linker" from "compiler"
6630 C<cc> (in F<cc.U>), C<ld> (in F<dlsrc.U>)
6634 =item Tasks that need a little C knowledge
6638 =item Weed out needless PERL_UNUSED_ARG
6640 =item Modernize the order of directories in @INC
6644 =item Make it clear from -v if this is the exact official release
6646 =item Profile Perl - am I hot or not?
6648 =item Allocate OPs from arenas
6650 =item Improve win32/wince.c
6652 =item Use secure CRT functions when building with VC8 on Win32
6654 =item Fix POSIX::access() and chdir() on Win32
6656 =item strcat(), strcpy(), strncat(), strncpy(), sprintf(), vsprintf()
6658 =item -D_FORTIFY_SOURCE=2, -fstack-protector
6660 =item Arenas for GPs? For MAGIC?
6666 =item Tasks that need a knowledge of XS
6670 =item safely supporting POSIX SA_SIGINFO
6672 =item autovivification
6674 =item Unicode in Filenames
6676 =item Unicode in %ENV
6678 =item Unicode and glob()
6680 =item Unicode and lc/uc operators
6682 =item use less 'memory'
6684 =item Re-implement C<:unique> in a way that is actually thread-safe
6686 =item Make tainting consistent
6688 =item readpipe(LIST)
6690 =item Audit the code for destruction ordering assumptions
6692 =item Extend PerlIO and PerlIO::Scalar
6694 =item -C on the #! line
6696 =item Organize error messages
6700 =item Tasks that need a knowledge of the interpreter
6704 =item error reporting of [$a ; $b]
6706 =item lexicals used only once
6710 =item Properly Unicode safe tokeniser and pads.
6712 =item state variable initialization in list context
6714 =item Implement $value ~~ 0 .. $range
6716 =item A does() built-in
6718 =item Tied filehandles and write() don't mix
6720 =item Attach/detach debugger from running program
6722 =item Optimize away empty destructors
6724 =item LVALUE functions for lists
6726 =item regexp optimiser optional
6728 =item delete &function
6730 =item C</w> regex modifier
6732 =item optional optimizer
6734 =item You WANT *how* many
6736 =item lexical aliases
6738 =item entersub XS vs Perl
6742 =item Optimize away @_
6744 =item Virtualize operating system access
6746 =item Investigate PADTMP hash pessimisation
6748 =item Store the current pad in the OP slab allocator
6750 =item repack the optree
6752 =item eliminate incorrect line numbers in warnings
6754 =item optimize tail-calls
6762 =item make ithreads more robust
6766 =item (?{...}) closures in regexps
6768 =item A re-entrant regexp engine
6770 =item Add class set operations to regexp engine
6776 =head2 perldoc - Look up Perl documentation in Pod format.
6786 B<-h>, B<-D>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
6787 I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-v> I<perlvar>, B<-T>, B<-d>
6788 I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
6789 B<-w> I<option:value> or B<-w> I<option>, B<-X>, B<-L> I<language_code>,
6790 B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
6803 =head2 perlhist - the Perl history records
6811 =item THE KEEPERS OF THE PUMPKIN
6823 =item SELECTED RELEASE SIZES
6825 =item SELECTED PATCH SIZES
6829 =item THE KEEPERS OF THE RECORDS
6833 =head2 perldelta - what is new for perl v5.11.0
6839 =item Incompatible Changes
6841 =item Core Enhancements
6843 =item Modules and Pragmata
6845 =item Utility Changes
6849 =item Performance Enhancements
6851 =item Installation and Configuration Improvements
6853 =item Selected Bug Fixes
6855 =item New or Changed Diagnostics
6857 =item Changed Internals
6859 =item Known Problems
6863 =item Platform Specific Problems
6867 =item Reporting Bugs
6873 =head2 perl5110delta, perldelta - what is new for perl v5.11.0
6879 =item Incompatible Changes
6881 =item Core Enhancements
6883 =item Modules and Pragmata
6885 =item Utility Changes
6889 =item Performance Enhancements
6891 =item Installation and Configuration Improvements
6893 =item Selected Bug Fixes
6895 =item New or Changed Diagnostics
6897 =item Changed Internals
6899 =item Known Problems
6903 =item Platform Specific Problems
6907 =item Reporting Bugs
6913 =head2 perl5100delta - what is new for perl 5.10.0
6919 =item Core Enhancements
6923 =item The C<feature> pragma
6925 =item New B<-E> command-line switch
6927 =item Defined-or operator
6929 =item Switch and Smart Match operator
6931 =item Regular expressions
6933 Recursive Patterns, Named Capture Buffers, Possessive Quantifiers,
6934 Backtracking control verbs, Relative backreferences, C<\K> escape, Vertical
6935 and horizontal whitespace, and linebreak
6941 =item The C<_> prototype
6943 =item UNITCHECK blocks
6945 =item New Pragma, C<mro>
6947 =item readdir() may return a "short filename" on Windows
6949 =item readpipe() is now overridable
6951 =item Default argument for readline()
6953 =item state() variables
6955 =item Stacked filetest operators
6957 =item UNIVERSAL::DOES()
6961 =item Byte-order modifiers for pack() and unpack()
6965 =item C<chdir>, C<chmod> and C<chown> on filehandles
6969 =item Recursive sort subs
6971 =item Exceptions in constant folding
6973 =item Source filters in @INC
6975 =item New internal variables
6977 C<${^RE_DEBUG_FLAGS}>, C<${^CHILD_ERROR_NATIVE}>, C<${^RE_TRIE_MAXBUF}>,
6978 C<${^WIN32_SLOPPY_STAT}>
6986 =item kill() on Windows
6990 =item Incompatible Changes
6994 =item Packing and UTF-8 strings
6996 =item Byte/character count feature in unpack()
6998 =item The C<$*> and C<$#> variables have been removed
7000 =item substr() lvalues are no longer fixed-length
7002 =item Parsing of C<-f _>
7006 =item Effect of pragmas in eval
7010 =item Handling of .pmc files
7012 =item $^V is now a C<version> object instead of a v-string
7014 =item @- and @+ in patterns
7016 =item $AUTOLOAD can now be tainted
7018 =item Tainting and printf
7020 =item undef and signal handlers
7022 =item strictures and dereferencing in defined()
7024 =item C<(?p{})> has been removed
7026 =item Pseudo-hashes have been removed
7028 =item Removal of the bytecode compiler and of perlcc
7030 =item Removal of the JPL
7032 =item Recursive inheritance detected earlier
7036 =item Modules and Pragmata
7040 =item Upgrading individual core modules
7042 =item Pragmata Changes
7044 C<feature>, C<mro>, Scoping of the C<sort> pragma, Scoping of C<bignum>,
7045 C<bigint>, C<bigrat>, C<base>, C<strict> and C<warnings>, C<version>,
7046 C<warnings>, C<less>
7050 =item Selected Changes to Core Modules
7052 C<Attribute::Handlers>, C<B::Lint>, C<B>, C<Thread>
7056 =item Utility Changes
7058 perl -d, ptar, ptardiff, shasum, corelist, h2ph and h2xs, perlivp,
7059 find2perl, config_data, cpanp, cpan2dist, pod2html
7061 =item New Documentation
7063 =item Performance Enhancements
7067 =item In-place sorting
7069 =item Lexical array access
7071 =item XS-assisted SWASHGET
7073 =item Constant subroutines
7075 =item C<PERL_DONT_CREATE_GVSV>
7077 =item Weak references are cheaper
7079 =item sort() enhancements
7081 =item Memory optimisations
7083 =item UTF-8 cache optimisation
7085 =item Sloppy stat on Windows
7087 =item Regular expressions optimisations
7089 Engine de-recursivised, Single char char-classes treated as literals, Trie
7090 optimisation of literal string alternations, Aho-Corasick start-point
7095 =item Installation and Configuration Improvements
7099 =item Configuration improvements
7101 C<-Dusesitecustomize>, Relocatable installations, strlcat() and strlcpy(),
7102 C<d_pseudofork> and C<d_printf_format_null>, Configure help
7104 =item Compilation improvements
7106 Parallel build, Borland's compilers support, Static build on Windows,
7107 ppport.h files, C++ compatibility, Support for Microsoft 64-bit compiler,
7108 Visual C++, Win32 builds
7110 =item Installation improvements
7112 Module auxiliary files
7114 =item New Or Improved Platforms
7118 =item Selected Bug Fixes
7120 strictures in regexp-eval blocks, Calling CORE::require(), Subscripts of
7121 slices, C<no warnings 'category'> works correctly with -w, threads
7122 improvements, chr() and negative values, PERL5SHELL and tainting, Using
7123 *FILE{IO}, Overloading and reblessing, Overloading and UTF-8, eval memory
7124 leaks fixed, Random device on Windows, PERLIO_DEBUG, PerlIO::scalar and
7125 read-only scalars, study() and UTF-8, Critical signals, @INC-hook fix,
7126 C<-t> switch fix, Duping UTF-8 filehandles, Localisation of hash elements
7128 =item New or Changed Diagnostics
7130 Use of uninitialized value, Deprecated use of my() in false conditional,
7131 !=~ should be !~, Newline in left-justified string, Too late for "-T"
7132 option, "%s" variable %s masks earlier declaration,
7133 readdir()/closedir()/etc. attempted on invalid dirhandle, Opening
7134 dirhandle/filehandle %s also as a file/directory, Use of -P is deprecated,
7135 v-string in use/require is non-portable, perl -V
7137 =item Changed Internals
7141 =item Reordering of SVt_* constants
7143 =item Elimination of SVt_PVBM
7145 =item New type SVt_BIND
7147 =item Removal of CPP symbols
7149 =item Less space is used by ops
7153 =item Use of C<const>
7157 =item C<AvFLAGS> has been removed
7159 =item C<av_*> changes
7163 =item B:: modules inheritance changed
7165 =item Anonymous hash and array constructors
7169 =item Known Problems
7173 =item UTF-8 problems
7177 =item Platform Specific Problems
7179 =item Reporting Bugs
7185 =head2 perl595delta - what is new for perl v5.9.5
7191 =item Incompatible Changes
7195 =item Tainting and printf
7197 =item undef and signal handlers
7199 =item strictures and array/hash dereferencing in defined()
7201 =item C<(?p{})> has been removed
7203 =item Pseudo-hashes have been removed
7205 =item Removal of the bytecode compiler and of perlcc
7207 =item Removal of the JPL
7209 =item Recursive inheritance detected earlier
7213 =item Core Enhancements
7217 =item Regular expressions
7219 Recursive Patterns, Named Capture Buffers, Possessive Quantifiers,
7220 Backtracking control verbs, Relative backreferences, C<\K> escape, Vertical
7221 and horizontal whitespace, and linebreak
7223 =item The C<_> prototype
7225 =item UNITCHECK blocks
7227 =item readpipe() is now overridable
7229 =item default argument for readline()
7235 =item Implicit loading of C<feature>
7239 =item Modules and Pragmas
7243 =item New Pragma, C<mro>
7245 =item bignum, bigint, bigrat
7247 =item Math::BigInt/Math::BigFloat
7249 config(), import(), roundmode common, bpi(), bcos(), bsin(), batan(),
7250 batan2(), bmuladd(), bexp(), bnok(), from_hex(), from_oct(), and
7251 from_bin(), as_oct()
7253 =item New Core Modules
7255 =item Module changes
7257 C<assertions>, C<base>, C<strict> and C<warnings>, C<warnings>, C<less>,
7258 C<Attribute::Handlers>, C<B::Lint>, C<B>, C<Thread>
7262 =item Utility Changes
7278 =item New manpage, perlunifaq
7282 =item Performance Enhancements
7284 =item Installation and Configuration Improvements
7288 =item C++ compatibility
7292 =item Static build on Win32
7296 =item C<d_pseudofork> and C<d_printf_format_null>
7306 =item Selected Bug Fixes
7308 =item New or Changed Diagnostics
7316 =item Changed Internals
7318 =item Known Problems
7322 =item Platform Specific Problems
7326 =item Reporting Bugs
7332 =head2 perl594delta - what is new for perl v5.9.4
7338 =item Incompatible Changes
7344 =item Handling of pmc files
7346 =item @- and @+ in patterns
7348 =item $AUTOLOAD can now be tainted
7352 =item Core Enhancements
7356 =item state() variables
7358 =item UNIVERSAL::DOES()
7360 =item Exceptions in constant folding
7362 =item Source filters in @INC
7368 =item Modules and Pragmas
7372 =item New Core Modules
7376 =item Utility Changes
7388 =item New manpage, perlpragma
7390 =item New manpage, perlreguts
7392 =item New manpage, perlunitut
7396 =item Performance Enhancements
7400 =item Memory optimisations
7402 =item UTF-8 cache optimisation
7404 =item Regular expressions
7406 Engine de-recursivised, Single char char-classes treated as literals, Trie
7407 optimisation of literal string alternations, Aho-Corasick start-point
7410 =item Sloppy stat on Windows
7414 =item Installation and Configuration Improvements
7418 =item Relocatable installations
7422 =item Compilation improvements
7426 =item Windows build improvements
7428 Building XS extensions, Support for 64-bit compiler
7432 =item Selected Bug Fixes
7436 =item PERL5SHELL and tainting
7438 =item Using *FILE{IO}
7440 =item Overloading and reblessing
7442 =item Overloading and UTF-8
7444 =item eval memory leaks fixed
7446 =item Random device on Windows
7450 =item New or Changed Diagnostics
7452 State variable %s will be reinitialized
7454 =item Changed Internals
7456 =item Known Problems
7458 =item Reporting Bugs
7464 =head2 perl593delta - what is new for perl v5.9.3
7470 =item Incompatible Changes
7474 =item Parsing of C<-f _>
7478 =item Magic goto and eval
7480 =item C<$#> has been removed
7484 =item Scoping of the C<sort> pragma
7488 =item Core Enhancements
7492 =item The C<feature> pragma
7494 =item Switch and Smart Match operator
7498 =item C<CLONE_SKIP()>
7500 =item C<${^CHILD_ERROR_NATIVE}>
7504 =item Unicode Character Database 4.1.0
7508 =item Recursive sort subs
7510 =item Effect of pragmas in eval
7512 =item New B<-E> command-line switch
7514 =item C<chdir>, C<chmod> and C<chown> on filehandles
7520 =item Modules and Pragmata
7524 =item New Core Modules
7528 =item Utility Changes
7538 =item C<h2xs> enhancements
7540 =item C<perlivp> enhancements
7552 =item Performance Enhancements
7556 =item XS-assisted SWASHGET
7558 =item Constant subroutines
7560 =item C<PERL_DONT_CREATE_GVSV>
7562 =item Weak references are cheaper
7564 =item sort() enhancements
7568 =item Installation and Configuration Improvements
7572 =item Compilation improvements
7574 =item New Or Improved Platforms
7578 =item Module auxiliary files
7582 =item Selected Bug Fixes
7586 =item C<defined $$x>
7588 =item Calling CORE::require()
7590 =item Subscripts of slices
7592 =item Remove over-optimisation
7594 =item sprintf() fixes
7596 =item no warnings 'category' works correctly with -w
7600 =item More Unicode Fixes
7604 =item New or Changed Diagnostics
7608 =item Attempt to set length of freed array
7610 =item Non-string passed as bitmask
7612 =item Search pattern not terminated or ternary operator parsed as search
7615 =item "%s" variable %s masks earlier declaration
7617 =item readdir()/closedir()/etc. attempted on invalid dirhandle
7621 =item Changed Internals
7625 =item B:: modules inheritance changed
7629 =item Reporting Bugs
7635 =head2 perl592delta - what is new for perl v5.9.2
7641 =item Incompatible Changes
7645 =item Packing and UTF-8 strings
7651 =item Core Enhancements
7655 =item Malloc wrapping
7657 =item Unicode Character Database 4.0.1
7659 =item suidperl less insecure
7665 =item Unicode Character Classes
7667 =item Byte-order modifiers for pack() and unpack()
7669 =item Byte count feature in pack()
7675 =item Modules and Pragmata
7681 =item Updated And Improved Modules and Pragmata
7683 B::Concise, Socket, Sys::Syslog, threads
7687 =item Utility Changes
7689 =item Performance Enhancements
7691 =item Installation and Configuration Improvements
7693 =item Selected Bug Fixes
7695 =item New or Changed Diagnostics
7697 =item Changed Internals
7699 =item Known Problems
7701 =item Plans for the next release
7703 =item Reporting Bugs
7709 =head2 perl591delta - what is new for perl v5.9.1
7715 =item Incompatible Changes
7719 =item substr() lvalues are no longer fixed-length
7721 =item The C<:unique> attribute is only meaningful for globals
7725 =item Core Enhancements
7731 =item Tied hashes in scalar context
7735 =item Stacked filetest operators
7739 =item Modules and Pragmata
7741 Benchmark, Carp, Exporter, FindBin, List::Util, threads::shared
7743 =item Utility Changes
7747 =item Performance Enhancements
7749 =item Selected Bug Fixes
7755 =item Threading bugs
7761 =item New or Changed Diagnostics
7763 =item Changed Internals
7767 =item Reordering of SVt_* constants
7769 =item Removal of CPP symbols
7771 =item Less space is used by ops
7777 =item Configuration and Building
7779 =item Known Problems
7783 =item Platform Specific Problems
7787 =item To-do for perl 5.10.0
7789 =item Reporting Bugs
7795 =head2 perl590delta - what is new for perl v5.9.0
7801 =item Incompatible Changes
7805 =item Hash Randomisation
7807 =item UTF-8 On Filehandles No Longer Activated By Locale
7809 =item Single-number v-strings are no longer v-strings before "=>"
7811 =item (Win32) The -C Switch Has Been Repurposed
7813 =item (Win32) The /d Switch Of cmd.exe
7815 =item The C<$*> variable has been removed
7819 =item Core Enhancements
7825 =item Defined-or operators
7827 =item UTF-8 no longer default under UTF-8 locales
7829 =item Unsafe signals again available
7831 =item Tied Arrays with Negative Array Indices
7835 =item Unicode Character Database 4.0.0
7837 =item Miscellaneous Enhancements
7841 =item Modules and Pragmata
7845 =item Updated Modules And Pragmata
7847 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
7848 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
7849 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
7850 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
7851 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
7852 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
7853 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
7858 =item Utility Changes
7860 =item New Documentation
7862 =item Performance Enhancements
7864 =item Installation and Configuration Improvements
7868 =item Platform-specific enhancements
7872 =item Selected Bug Fixes
7876 =item Closures, eval and lexicals
7880 =item Platform-specific fixes
7884 =item New or Changed Diagnostics
7888 =item Changed "A thread exited while %d threads were running"
7890 =item Removed "Attempt to clear a restricted hash"
7892 =item New "Illegal declaration of anonymous subroutine"
7894 =item Changed "Invalid range "%s" in transliteration operator"
7896 =item New "Missing control char name in \c"
7898 =item New "Newline in left-justified string for %s"
7900 =item New "Possible precedence problem on bitwise %c operator"
7902 =item New "read() on %s filehandle %s"
7904 =item New "Tied variable freed while still in use"
7906 =item New "To%s: illegal mapping '%s'"
7908 =item New "Use of freed value in iteration"
7912 =item Changed Internals
7916 =item Known Problems
7920 =item Tied hashes in scalar context
7922 =item Net::Ping 450_service and 510_ping_udp failures
7928 =item Platform Specific Problems
7932 =item EBCDIC Platforms
7934 =item Cygwin 1.5 problems
7936 =item HP-UX: HP cc warnings about sendfile and sendpath
7938 =item IRIX: t/uni/tr_7jis.t falsely failing
7940 =item Mac OS X: no usemymalloc
7942 =item Tru64: No threaded builds with GNU cc (gcc)
7944 =item Win32: sysopen, sysread, syswrite
7950 =item Reporting Bugs
7956 =head2 perl588delta - what is new for perl v5.8.8
7962 =item Incompatible Changes
7964 =item Core Enhancements
7966 =item Modules and Pragmata
7968 =item Utility Changes
7972 =item C<h2xs> enhancements
7974 =item C<perlivp> enhancements
7978 =item New Documentation
7980 =item Performance Enhancements
7982 =item Installation and Configuration Improvements
7984 =item Selected Bug Fixes
7988 =item no warnings 'category' works correctly with -w
7990 =item Remove over-optimisation
7992 =item sprintf() fixes
7994 =item Debugger and Unicode slowdown
8000 =item New or Changed Diagnostics
8004 =item Attempt to set length of freed array
8006 =item Non-string passed as bitmask
8008 =item Search pattern not terminated or ternary operator parsed as search
8013 =item Changed Internals
8015 =item Platform Specific Problems
8017 =item Reporting Bugs
8023 =head2 perl587delta - what is new for perl v5.8.7
8029 =item Incompatible Changes
8031 =item Core Enhancements
8035 =item Unicode Character Database 4.1.0
8037 =item suidperl less insecure
8039 =item Optional site customization script
8041 =item C<Config.pm> is now much smaller.
8045 =item Modules and Pragmata
8047 =item Utility Changes
8051 =item find2perl enhancements
8055 =item Performance Enhancements
8057 =item Installation and Configuration Improvements
8059 =item Selected Bug Fixes
8061 =item New or Changed Diagnostics
8063 =item Changed Internals
8065 =item Known Problems
8067 =item Platform Specific Problems
8069 =item Reporting Bugs
8075 =head2 perl586delta - what is new for perl v5.8.6
8081 =item Incompatible Changes
8083 =item Core Enhancements
8085 =item Modules and Pragmata
8087 =item Utility Changes
8089 =item Performance Enhancements
8091 =item Selected Bug Fixes
8093 =item New or Changed Diagnostics
8095 =item Changed Internals
8099 =item Reporting Bugs
8105 =head2 perl585delta - what is new for perl v5.8.5
8111 =item Incompatible Changes
8113 =item Core Enhancements
8115 =item Modules and Pragmata
8117 =item Utility Changes
8121 =item Perl's debugger
8127 =item Installation and Configuration Improvements
8129 =item Selected Bug Fixes
8131 =item New or Changed Diagnostics
8133 =item Changed Internals
8135 =item Known Problems
8137 =item Platform Specific Problems
8139 =item Reporting Bugs
8145 =head2 perl584delta - what is new for perl v5.8.4
8151 =item Incompatible Changes
8153 =item Core Enhancements
8157 =item Malloc wrapping
8159 =item Unicode Character Database 4.0.1
8161 =item suidperl less insecure
8167 =item Modules and Pragmata
8171 =item Updated modules
8173 Attribute::Handlers, B, Benchmark, CGI, Carp, Cwd, Exporter, File::Find,
8174 IO, IPC::Open3, Local::Maketext, Math::BigFloat, Math::BigInt,
8175 Math::BigRat, MIME::Base64, ODBM_File, POSIX, Shell, Socket, Storable,
8176 Switch, Sys::Syslog, Term::ANSIColor, Time::HiRes, Unicode::UCD, Win32,
8177 base, open, threads, utf8
8181 =item Performance Enhancements
8183 =item Utility Changes
8185 =item Installation and Configuration Improvements
8187 =item Selected Bug Fixes
8189 =item New or Changed Diagnostics
8191 =item Changed Internals
8193 =item Future Directions
8195 =item Platform Specific Problems
8197 =item Reporting Bugs
8203 =head2 perl583delta - what is new for perl v5.8.3
8209 =item Incompatible Changes
8211 =item Core Enhancements
8213 =item Modules and Pragmata
8215 CGI, Cwd, Digest, Digest::MD5, Encode, File::Spec, FindBin, List::Util,
8216 Math::BigInt, PodParser, Pod::Perldoc, POSIX, Unicode::Collate,
8217 Unicode::Normalize, Test::Harness, threads::shared
8219 =item Utility Changes
8221 =item New Documentation
8223 =item Installation and Configuration Improvements
8225 =item Selected Bug Fixes
8227 =item New or Changed Diagnostics
8229 =item Changed Internals
8231 =item Configuration and Building
8233 =item Platform Specific Problems
8235 =item Known Problems
8237 =item Future Directions
8241 =item Reporting Bugs
8247 =head2 perl582delta - what is new for perl v5.8.2
8253 =item Incompatible Changes
8255 =item Core Enhancements
8259 =item Hash Randomisation
8265 =item Modules and Pragmata
8269 =item Updated Modules And Pragmata
8271 Devel::PPPort, Digest::MD5, I18N::LangTags, libnet, MIME::Base64,
8272 Pod::Perldoc, strict, Tie::Hash, Time::HiRes, Unicode::Collate,
8273 Unicode::Normalize, UNIVERSAL
8277 =item Selected Bug Fixes
8279 =item Changed Internals
8281 =item Platform Specific Problems
8283 =item Future Directions
8285 =item Reporting Bugs
8291 =head2 perl581delta - what is new for perl v5.8.1
8297 =item Incompatible Changes
8301 =item Hash Randomisation
8303 =item UTF-8 On Filehandles No Longer Activated By Locale
8305 =item Single-number v-strings are no longer v-strings before "=>"
8307 =item (Win32) The -C Switch Has Been Repurposed
8309 =item (Win32) The /d Switch Of cmd.exe
8313 =item Core Enhancements
8317 =item UTF-8 no longer default under UTF-8 locales
8319 =item Unsafe signals again available
8321 =item Tied Arrays with Negative Array Indices
8325 =item Unicode Character Database 4.0.0
8327 =item Deprecation Warnings
8329 =item Miscellaneous Enhancements
8333 =item Modules and Pragmata
8337 =item Updated Modules And Pragmata
8339 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
8340 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
8341 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
8342 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
8343 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
8344 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
8345 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
8350 =item Utility Changes
8352 =item New Documentation
8354 =item Installation and Configuration Improvements
8358 =item Platform-specific enhancements
8362 =item Selected Bug Fixes
8366 =item Closures, eval and lexicals
8370 =item Platform-specific fixes
8374 =item New or Changed Diagnostics
8378 =item Changed "A thread exited while %d threads were running"
8380 =item Removed "Attempt to clear a restricted hash"
8382 =item New "Illegal declaration of anonymous subroutine"
8384 =item Changed "Invalid range "%s" in transliteration operator"
8386 =item New "Missing control char name in \c"
8388 =item New "Newline in left-justified string for %s"
8390 =item New "Possible precedence problem on bitwise %c operator"
8392 =item New "Pseudo-hashes are deprecated"
8394 =item New "read() on %s filehandle %s"
8396 =item New "5.005 threads are deprecated"
8398 =item New "Tied variable freed while still in use"
8400 =item New "To%s: illegal mapping '%s'"
8402 =item New "Use of freed value in iteration"
8406 =item Changed Internals
8410 =item Known Problems
8414 =item Tied hashes in scalar context
8416 =item Net::Ping 450_service and 510_ping_udp failures
8422 =item Platform Specific Problems
8426 =item EBCDIC Platforms
8428 =item Cygwin 1.5 problems
8430 =item HP-UX: HP cc warnings about sendfile and sendpath
8432 =item IRIX: t/uni/tr_7jis.t falsely failing
8434 =item Mac OS X: no usemymalloc
8436 =item Tru64: No threaded builds with GNU cc (gcc)
8438 =item Win32: sysopen, sysread, syswrite
8442 =item Future Directions
8444 =item Reporting Bugs
8450 =head2 perl58delta - what is new for perl v5.8.0
8456 =item Highlights In 5.8.0
8458 =item Incompatible Changes
8462 =item Binary Incompatibility
8464 =item 64-bit platforms and malloc
8466 =item AIX Dynaloading
8468 =item Attributes for C<my> variables now handled at run-time
8470 =item Socket Extension Dynamic in VMS
8472 =item IEEE-format Floating Point Default on OpenVMS Alpha
8474 =item New Unicode Semantics (no more C<use utf8>, almost)
8476 =item New Unicode Properties
8478 =item REF(...) Instead Of SCALAR(...)
8480 =item pack/unpack D/F recycled
8482 =item glob() now returns filenames in alphabetical order
8488 =item Core Enhancements
8492 =item Unicode Overhaul
8494 =item PerlIO is Now The Default
8498 =item Restricted Hashes
8502 =item Understanding of Numbers
8504 =item Arrays now always interpolate into double-quoted strings [561]
8506 =item Miscellaneous Changes
8510 =item Modules and Pragmata
8514 =item New Modules and Pragmata
8516 =item Updated And Improved Modules and Pragmata
8520 =item Utility Changes
8522 =item New Documentation
8524 =item Performance Enhancements
8526 =item Installation and Configuration Improvements
8530 =item Generic Improvements
8532 =item New Or Improved Platforms
8536 =item Selected Bug Fixes
8540 =item Platform Specific Changes and Fixes
8544 =item New or Changed Diagnostics
8546 =item Changed Internals
8548 =item Security Vulnerability Closed [561]
8552 =item Known Problems
8556 =item The Compiler Suite Is Still Very Experimental
8558 =item Localising Tied Arrays and Hashes Is Broken
8560 =item Building Extensions Can Fail Because Of Largefiles
8562 =item Modifying $_ Inside for(..)
8564 =item mod_perl 1.26 Doesn't Build With Threaded Perl
8566 =item lib/ftmp-security tests warn 'system possibly insecure'
8568 =item libwww-perl (LWP) fails base/date #51
8570 =item PDL failing some tests
8574 =item Self-tying Problems
8576 =item ext/threads/t/libc
8578 =item Failure of Thread (5.005-style) tests
8580 =item Timing problems
8582 =item Tied/Magical Array/Hash Elements Do Not Autovivify
8584 =item Unicode in package/class and subroutine names does not work
8588 =item Platform Specific Problems
8594 =item Alpha systems with old gccs fail several tests
8600 =item Cygwin "unable to remap"
8602 =item Cygwin ndbm tests fail on FAT
8604 =item DJGPP Failures
8606 =item FreeBSD built with ithreads coredumps reading large directories
8608 =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
8610 =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
8612 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
8614 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
8616 =item Linux With Sfio Fails op/misc Test 48
8620 =item Mac OS X dyld undefined symbols
8622 =item OS/2 Test Failures
8624 =item op/sprintf tests 91, 129, and 130
8630 =item Solaris x86 Fails Tests With -Duse64bitint
8632 =item SUPER-UX (NEC SX)
8634 =item Term::ReadKey not working on Win32
8646 =item XML::Parser not working
8650 =item Unicode Support on EBCDIC Still Spotty
8652 =item Seen In Perl 5.7 But Gone Now
8656 =item Reporting Bugs
8664 =head2 perl573delta - what's new for perl v5.7.3
8672 =item Reporting Bugs
8680 =head2 perl572delta - what's new for perl v5.7.2
8686 =item Security Vulnerability Closed
8688 =item Incompatible Changes
8692 =item 64-bit platforms and malloc
8694 =item AIX Dynaloading
8696 =item Socket Extension Dynamic in VMS
8698 =item Different Definition of the Unicode Character Classes \p{In...}
8704 =item Core Enhancements
8706 =item Modules and Pragmata
8710 =item New Modules and Distributions
8712 =item Updated And Improved Modules and Pragmata
8716 =item Utility Changes
8718 =item New Documentation
8720 =item Installation and Configuration Improvements
8724 =item New Or Improved Platforms
8726 =item Generic Improvements
8730 =item Selected Bug Fixes
8734 =item Platform Specific Changes and Fixes
8738 =item New or Changed Diagnostics
8740 =item Source Code Enhancements
8744 =item MAGIC constants
8746 =item Better commented code
8748 =item Regex pre-/post-compilation items matched up
8756 =item Known Problems
8762 =item Amiga Perl Invoking Mystery
8764 =item lib/ftmp-security tests warn 'system possibly insecure'
8766 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
8768 =item HP-UX lib/io_multihomed Fails When LP64-Configured
8770 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
8772 =item Linux With Sfio Fails op/misc Test 48
8776 =item op/sprintf tests 129 and 130
8778 =item Failure of Thread tests
8788 =item Localising a Tied Variable Leaks Memory
8790 =item Self-tying of Arrays and Hashes Is Forbidden
8792 =item Variable Attributes are not Currently Usable for Tieing
8794 =item Building Extensions Can Fail Because Of Largefiles
8796 =item The Compiler Suite Is Still Experimental
8798 =item The Long Double Support is Still Experimental
8802 =item Reporting Bugs
8810 =head2 perl571delta - what's new for perl v5.7.1
8816 =item Security Vulnerability Closed
8818 =item Incompatible Changes
8820 =item Core Enhancements
8824 =item AUTOLOAD Is Now Lvaluable
8826 =item PerlIO is Now The Default
8828 =item Signals Are Now Safe
8832 =item Modules and Pragmata
8838 =item Updated And Improved Modules and Pragmata
8842 =item Performance Enhancements
8844 =item Utility Changes
8846 =item New Documentation
8862 =item README.solaris
8866 =item Porting/repository.pod
8870 =item Installation and Configuration Improvements
8874 =item New Or Improved Platforms
8876 =item Generic Improvements
8878 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
8879 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
8880 d_strtoq, d_u32align, d_ualarm, d_usleep
8884 =item Selected Bug Fixes
8888 =item Platform Specific Changes and Fixes
8892 =item New or Changed Diagnostics
8894 =item Changed Internals
8898 =item Known Problems
8902 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
8904 =item lib/ftmp-security tests warn 'system possibly insecure'
8906 =item lib/io_multihomed Fails In LP64-Configured HP-UX
8908 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
8912 =item Linux With Sfio Fails op/misc Test 48
8914 =item sigaction test 13 in VMS
8916 =item sprintf tests 129 and 130
8918 =item Failure of Thread tests
8920 =item Localising a Tied Variable Leaks Memory
8922 =item Self-tying of Arrays and Hashes Is Forbidden
8924 =item Building Extensions Can Fail Because Of Largefiles
8926 =item The Compiler Suite Is Still Experimental
8930 =item Reporting Bugs
8938 =head2 perl570delta - what's new for perl v5.7.0
8944 =item Security Vulnerability Closed
8946 =item Incompatible Changes
8948 =item Core Enhancements
8950 =item Modules and Pragmata
8956 =item Updated And Improved Modules and Pragmata
8960 =item Utility Changes
8962 =item New Documentation
8964 =item Performance Enhancements
8966 =item Installation and Configuration Improvements
8970 =item Generic Improvements
8974 =item Selected Bug Fixes
8978 =item Platform Specific Changes and Fixes
8982 =item New or Changed Diagnostics
8984 =item Changed Internals
8986 =item Known Problems
8990 =item Unicode Support Still Far From Perfect
8992 =item EBCDIC Still A Lost Platform
8994 =item Building Extensions Can Fail Because Of Largefiles
8996 =item ftmp-security tests warn 'system possibly insecure'
8998 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
9000 =item Long Doubles Still Don't Work In Solaris
9002 =item Linux With Sfio Fails op/misc Test 48
9004 =item Storable tests fail in some platforms
9006 =item Threads Are Still Experimental
9008 =item The Compiler Suite Is Still Experimental
9012 =item Reporting Bugs
9020 =head2 perl561delta - what's new for perl v5.6.x
9026 =item Summary of changes between 5.6.0 and 5.6.1
9030 =item Security Issues
9032 =item Core bug fixes
9034 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
9035 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
9036 references to special variables, Lexical warnings, Spurious warnings and
9037 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
9038 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
9039 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
9044 =item Configuration issues
9048 =item Bundled modules
9050 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
9051 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
9052 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
9053 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
9055 =item Platform-specific improvements
9057 NCR MP-RAS, NonStop-UX
9061 =item Core Enhancements
9065 =item Interpreter cloning, threads, and concurrency
9067 =item Lexically scoped warning categories
9069 =item Unicode and UTF-8 support
9071 =item Support for interpolating named characters
9073 =item "our" declarations
9075 =item Support for strings represented as a vector of ordinals
9077 =item Improved Perl version numbering system
9079 =item New syntax for declaring subroutine attributes
9081 =item File and directory handles can be autovivified
9083 =item open() with more than two arguments
9085 =item 64-bit support
9087 =item Large file support
9093 =item Enhanced support for sort() subroutines
9095 =item C<sort $coderef @foo> allowed
9097 =item File globbing implemented internally
9099 =item Support for CHECK blocks
9101 =item POSIX character class syntax [: :] supported
9103 =item Better pseudo-random number generator
9105 =item Improved C<qw//> operator
9107 =item Better worst-case behavior of hashes
9109 =item pack() format 'Z' supported
9111 =item pack() format modifier '!' supported
9113 =item pack() and unpack() support counted strings
9115 =item Comments in pack() templates
9117 =item Weak references
9119 =item Binary numbers supported
9121 =item Lvalue subroutines
9123 =item Some arrows may be omitted in calls through references
9125 =item Boolean assignment operators are legal lvalues
9127 =item exists() is supported on subroutine names
9129 =item exists() and delete() are supported on array elements
9131 =item Pseudo-hashes work better
9133 =item Automatic flushing of output buffers
9135 =item Better diagnostics on meaningless filehandle operations
9137 =item Where possible, buffered data discarded from duped input filehandle
9139 =item eof() has the same old magic as <>
9141 =item binmode() can be used to set :crlf and :raw modes
9143 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
9145 =item system(), backticks and pipe open now reflect exec() failure
9147 =item Improved diagnostics
9149 =item Diagnostics follow STDERR
9151 =item More consistent close-on-exec behavior
9153 =item syswrite() ease-of-use
9155 =item Better syntax checks on parenthesized unary operators
9157 =item Bit operators support full native integer width
9159 =item Improved security features
9161 =item More functional bareword prototype (*)
9163 =item C<require> and C<do> may be overridden
9165 =item $^X variables may now have names longer than one character
9167 =item New variable $^C reflects C<-c> switch
9169 =item New variable $^V contains Perl version as a string
9171 =item Optional Y2K warnings
9173 =item Arrays now always interpolate into double-quoted strings
9175 =item @- and @+ provide starting/ending offsets of regex submatches
9179 =item Modules and Pragmata
9185 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
9186 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
9187 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
9188 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
9189 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
9190 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
9191 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
9192 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
9198 =item Utility Changes
9212 =item The Perl Debugger
9216 =item Improved Documentation
9218 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
9219 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
9220 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
9221 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
9223 =item Performance enhancements
9227 =item Simple sort() using { $a <=> $b } and the like are optimized
9229 =item Optimized assignments to lexical variables
9231 =item Faster subroutine calls
9233 =item delete(), each(), values() and hash iteration are faster
9237 =item Installation and Configuration Improvements
9241 =item -Dusethreads means something different
9243 =item New Configure flags
9245 =item Threadedness and 64-bitness now more daring
9251 =item -Duselargefiles
9253 =item installusrbinperl
9259 =item Enhanced Installation Directories
9261 =item gcc automatically tried if 'cc' does not seem to be working
9265 =item Platform specific changes
9269 =item Supported platforms
9273 =item OS390 (OpenEdition MVS)
9281 =item Significant bug fixes
9285 =item <HANDLE> on empty files
9287 =item C<eval '...'> improvements
9289 =item All compilation errors are true errors
9291 =item Implicitly closed filehandles are safer
9293 =item Behavior of list slices is more consistent
9295 =item C<(\$)> prototype and C<$foo{a}>
9297 =item C<goto &sub> and AUTOLOAD
9299 =item C<-bareword> allowed under C<use integer>
9301 =item Failures in DESTROY()
9303 =item Locale bugs fixed
9307 =item Spurious subroutine stubs after failed subroutine calls
9309 =item Taint failures under C<-U>
9311 =item END blocks and the C<-c> switch
9313 =item Potential to leak DATA filehandles
9317 =item New or Changed Diagnostics
9319 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
9320 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
9321 / cannot take a count, / must be followed by a, A or Z, / must be followed
9322 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
9323 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
9324 passed through, /%s/ should probably be written as "%s", %s() called too
9325 early to check prototype, %s argument is not a HASH or ARRAY element, %s
9326 argument is not a HASH or ARRAY element or slice, %s argument is not a
9327 subroutine name, %s package attribute may clash with future reserved word:
9328 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
9329 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
9330 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
9331 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
9332 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
9333 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
9334 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
9335 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
9336 weaken a nonreference, Character class [:%s:] unknown, Character class
9337 syntax [%s] belongs inside character classes, Constant is not %s reference,
9338 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
9339 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
9340 "local" instead of "our"?), Document contains no data, entering effective
9341 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
9342 output, flock() on closed filehandle %s, Global symbol "%s" requires
9343 explicit package name, Hexadecimal number > 0xffffffff non-portable,
9344 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
9345 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
9346 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
9347 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
9348 separator character %s in attribute list, Invalid separator character %s in
9349 subroutine attribute list, leaving effective %s failed, Lvalue subs
9350 returning %s not implemented yet, Method %s not permitted, Missing
9351 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
9352 No %s specified for -%c, No package name allowed for variable %s in "our",
9353 No space allowed after -%c, no UTC offset information; assuming local time
9354 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
9355 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
9356 around "%s" list, Possible unintended interpolation of %s in string,
9357 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
9358 instead, Premature end of script headers, Repeat count in pack overflows,
9359 Repeat count in unpack overflows, realloc() of freed memory ignored,
9360 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
9361 zero-length expression, switching effective %s is not implemented, This
9362 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
9363 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
9364 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
9365 escape \\%c passed through, Unterminated attribute parameter in attribute
9366 list, Unterminated attribute list, Unterminated attribute parameter in
9367 subroutine attribute list, Unterminated subroutine attribute list, Value of
9368 CLI symbol "%s" too long, Version number must be a constant number
9372 =item Incompatible Changes
9376 =item Perl Source Incompatibilities
9378 CHECK is a new keyword, Treatment of list slices of undef has changed,
9379 Format of $English::PERL_VERSION is different, Literals of the form
9380 C<1.2.3> parse differently, Possibly changed pseudo-random number
9381 generator, Hashing function for hash keys has changed, C<undef> fails on
9382 read only values, Close-on-exec bit may be set on pipe and socket handles,
9383 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
9384 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
9385 Text of some diagnostic output has changed, C<%@> has been removed,
9386 Parenthesized not() behaves like a list operator, Semantics of bareword
9387 prototype C<(*)> have changed, Semantics of bit operators may have changed
9388 on 64-bit platforms, More builtins taint their results
9390 =item C Source Incompatibilities
9392 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
9394 =item Compatible C Source API Changes
9396 C<PATCHLEVEL> is now C<PERL_VERSION>
9398 =item Binary Incompatibilities
9402 =item Known Problems
9406 =item Localizing a tied hash element may leak memory
9408 =item Known test failures
9410 =item EBCDIC platforms not fully supported
9412 =item UNICOS/mk CC failures during Configure run
9414 =item Arrow operator and arrays
9416 =item Experimental features
9418 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
9419 pseudo-hash data type, The Compiler suite, Internal implementation of file
9420 globbing, The DB module, The regular expression code constructs:
9424 =item Obsolete Diagnostics
9426 Character class syntax [: :] is reserved for future extensions, Ill-formed
9427 logical name |%s| in prime_env_iter, In string, @%s now must be written as
9428 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
9429 to mean "${$}<digit>" is deprecated
9431 =item Reporting Bugs
9439 =head2 perl56delta - what's new for perl v5.6.0
9445 =item Core Enhancements
9449 =item Interpreter cloning, threads, and concurrency
9451 =item Lexically scoped warning categories
9453 =item Unicode and UTF-8 support
9455 =item Support for interpolating named characters
9457 =item "our" declarations
9459 =item Support for strings represented as a vector of ordinals
9461 =item Improved Perl version numbering system
9463 =item New syntax for declaring subroutine attributes
9465 =item File and directory handles can be autovivified
9467 =item open() with more than two arguments
9469 =item 64-bit support
9471 =item Large file support
9477 =item Enhanced support for sort() subroutines
9479 =item C<sort $coderef @foo> allowed
9481 =item File globbing implemented internally
9483 =item Support for CHECK blocks
9485 =item POSIX character class syntax [: :] supported
9487 =item Better pseudo-random number generator
9489 =item Improved C<qw//> operator
9491 =item Better worst-case behavior of hashes
9493 =item pack() format 'Z' supported
9495 =item pack() format modifier '!' supported
9497 =item pack() and unpack() support counted strings
9499 =item Comments in pack() templates
9501 =item Weak references
9503 =item Binary numbers supported
9505 =item Lvalue subroutines
9507 =item Some arrows may be omitted in calls through references
9509 =item Boolean assignment operators are legal lvalues
9511 =item exists() is supported on subroutine names
9513 =item exists() and delete() are supported on array elements
9515 =item Pseudo-hashes work better
9517 =item Automatic flushing of output buffers
9519 =item Better diagnostics on meaningless filehandle operations
9521 =item Where possible, buffered data discarded from duped input filehandle
9523 =item eof() has the same old magic as <>
9525 =item binmode() can be used to set :crlf and :raw modes
9527 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
9529 =item system(), backticks and pipe open now reflect exec() failure
9531 =item Improved diagnostics
9533 =item Diagnostics follow STDERR
9535 =item More consistent close-on-exec behavior
9537 =item syswrite() ease-of-use
9539 =item Better syntax checks on parenthesized unary operators
9541 =item Bit operators support full native integer width
9543 =item Improved security features
9545 =item More functional bareword prototype (*)
9547 =item C<require> and C<do> may be overridden
9549 =item $^X variables may now have names longer than one character
9551 =item New variable $^C reflects C<-c> switch
9553 =item New variable $^V contains Perl version as a string
9555 =item Optional Y2K warnings
9557 =item Arrays now always interpolate into double-quoted strings
9559 =item @- and @+ provide starting/ending offsets of regex matches
9563 =item Modules and Pragmata
9569 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
9570 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
9571 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
9572 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
9573 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
9574 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
9575 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
9576 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
9582 =item Utility Changes
9596 =item The Perl Debugger
9600 =item Improved Documentation
9602 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
9603 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
9604 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
9605 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
9607 =item Performance enhancements
9611 =item Simple sort() using { $a <=> $b } and the like are optimized
9613 =item Optimized assignments to lexical variables
9615 =item Faster subroutine calls
9617 =item delete(), each(), values() and hash iteration are faster
9621 =item Installation and Configuration Improvements
9625 =item -Dusethreads means something different
9627 =item New Configure flags
9629 =item Threadedness and 64-bitness now more daring
9635 =item -Duselargefiles
9637 =item installusrbinperl
9643 =item Enhanced Installation Directories
9647 =item Platform specific changes
9651 =item Supported platforms
9655 =item OS390 (OpenEdition MVS)
9663 =item Significant bug fixes
9667 =item <HANDLE> on empty files
9669 =item C<eval '...'> improvements
9671 =item All compilation errors are true errors
9673 =item Implicitly closed filehandles are safer
9675 =item Behavior of list slices is more consistent
9677 =item C<(\$)> prototype and C<$foo{a}>
9679 =item C<goto &sub> and AUTOLOAD
9681 =item C<-bareword> allowed under C<use integer>
9683 =item Failures in DESTROY()
9685 =item Locale bugs fixed
9689 =item Spurious subroutine stubs after failed subroutine calls
9691 =item Taint failures under C<-U>
9693 =item END blocks and the C<-c> switch
9695 =item Potential to leak DATA filehandles
9699 =item New or Changed Diagnostics
9701 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
9702 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
9703 / cannot take a count, / must be followed by a, A or Z, / must be followed
9704 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
9705 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
9706 passed through, /%s/ should probably be written as "%s", %s() called too
9707 early to check prototype, %s argument is not a HASH or ARRAY element, %s
9708 argument is not a HASH or ARRAY element or slice, %s argument is not a
9709 subroutine name, %s package attribute may clash with future reserved word:
9710 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
9711 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
9712 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
9713 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
9714 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
9715 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
9716 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
9717 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
9718 weaken a nonreference, Character class [:%s:] unknown, Character class
9719 syntax [%s] belongs inside character classes, Constant is not %s reference,
9720 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
9721 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
9722 "local" instead of "our"?), Document contains no data, entering effective
9723 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
9724 output, flock() on closed filehandle %s, Global symbol "%s" requires
9725 explicit package name, Hexadecimal number > 0xffffffff non-portable,
9726 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
9727 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
9728 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
9729 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
9730 separator character %s in attribute list, Invalid separator character %s in
9731 subroutine attribute list, leaving effective %s failed, Lvalue subs
9732 returning %s not implemented yet, Method %s not permitted, Missing
9733 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
9734 No %s specified for -%c, No package name allowed for variable %s in "our",
9735 No space allowed after -%c, no UTC offset information; assuming local time
9736 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
9737 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
9738 around "%s" list, Possible unintended interpolation of %s in string,
9739 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
9740 instead, Premature end of script headers, Repeat count in pack overflows,
9741 Repeat count in unpack overflows, realloc() of freed memory ignored,
9742 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
9743 zero-length expression, switching effective %s is not implemented, This
9744 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
9745 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
9746 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
9747 escape \\%c passed through, Unterminated attribute parameter in attribute
9748 list, Unterminated attribute list, Unterminated attribute parameter in
9749 subroutine attribute list, Unterminated subroutine attribute list, Value of
9750 CLI symbol "%s" too long, Version number must be a constant number
9754 =item Incompatible Changes
9758 =item Perl Source Incompatibilities
9760 CHECK is a new keyword, Treatment of list slices of undef has changed,
9761 Format of $English::PERL_VERSION is different, Literals of the form
9762 C<1.2.3> parse differently, Possibly changed pseudo-random number
9763 generator, Hashing function for hash keys has changed, C<undef> fails on
9764 read only values, Close-on-exec bit may be set on pipe and socket handles,
9765 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
9766 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
9767 Text of some diagnostic output has changed, C<%@> has been removed,
9768 Parenthesized not() behaves like a list operator, Semantics of bareword
9769 prototype C<(*)> have changed, Semantics of bit operators may have changed
9770 on 64-bit platforms, More builtins taint their results
9772 =item C Source Incompatibilities
9774 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
9776 =item Compatible C Source API Changes
9778 C<PATCHLEVEL> is now C<PERL_VERSION>
9780 =item Binary Incompatibilities
9784 =item Known Problems
9788 =item Thread test failures
9790 =item EBCDIC platforms not supported
9792 =item In 64-bit HP-UX the lib/io_multihomed test may hang
9794 =item NEXTSTEP 3.3 POSIX test failure
9796 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
9799 =item UNICOS/mk CC failures during Configure run
9801 =item Arrow operator and arrays
9803 =item Experimental features
9805 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
9806 pseudo-hash data type, The Compiler suite, Internal implementation of file
9807 globbing, The DB module, The regular expression code constructs:
9811 =item Obsolete Diagnostics
9813 Character class syntax [: :] is reserved for future extensions, Ill-formed
9814 logical name |%s| in prime_env_iter, In string, @%s now must be written as
9815 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
9816 to mean "${$}<digit>" is deprecated
9818 =item Reporting Bugs
9826 =head2 perl5005delta - what's new for perl5.005
9832 =item About the new versioning system
9834 =item Incompatible Changes
9838 =item WARNING: This version is not binary compatible with Perl 5.004.
9840 =item Default installation structure has changed
9842 =item Perl Source Compatibility
9844 =item C Source Compatibility
9846 =item Binary Compatibility
9848 =item Security fixes may affect compatibility
9850 =item Relaxed new mandatory warnings introduced in 5.004
9864 =item Regular Expressions
9866 Many new and improved optimizations, Many bug fixes, New regular expression
9867 constructs, New operator for precompiled regular expressions, Other
9868 improvements, Incompatible changes
9870 =item Improved malloc()
9872 =item Quicksort is internally implemented
9874 =item Reliable signals
9876 =item Reliable stack pointers
9878 =item More generous treatment of carriage returns
9882 =item Better support for multiple interpreters
9884 =item Behavior of local() on array and hash elements is now well-defined
9886 =item C<%!> is transparently tied to the L<Errno> module
9888 =item Pseudo-hashes are supported
9890 =item C<EXPR foreach EXPR> is supported
9892 =item Keywords can be globally overridden
9894 =item C<$^E> is meaningful on Win32
9896 =item C<foreach (1..1000000)> optimized
9898 =item C<Foo::> can be used as implicitly quoted package name
9900 =item C<exists $Foo::{Bar::}> tests existence of a package
9902 =item Better locale support
9904 =item Experimental support for 64-bit platforms
9906 =item prototype() returns useful results on builtins
9908 =item Extended support for exception handling
9910 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
9912 =item All C<printf> format conversions are handled internally
9914 =item New C<INIT> keyword
9916 =item New C<lock> keyword
9918 =item New C<qr//> operator
9920 =item C<our> is now a reserved word
9922 =item Tied arrays are now fully supported
9924 =item Tied handles support is better
9926 =item 4th argument to substr
9928 =item Negative LENGTH argument to splice
9930 =item Magic lvalues are now more magical
9932 =item <> now reads in records
9936 =item Supported Platforms
9942 =item Changes in existing support
9946 =item Modules and Pragmata
9952 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
9953 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
9954 Thread, attrs, fields, re
9956 =item Changes in existing modules
9958 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
9959 MakeMaker, CPAN, Cwd
9963 =item Utility Changes
9965 =item Documentation Changes
9967 =item New Diagnostics
9969 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
9970 while coercing array into hash, Bareword "%s" refers to nonexistent
9971 package, Can't call method "%s" on an undefined value, Can't check
9972 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
9973 goto subroutine from an eval-string, Can't localize pseudo-hash element,
9974 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
9975 for "%s", Character class syntax [. .] is reserved for future extensions,
9976 Character class syntax [: :] is reserved for future extensions, Character
9977 class syntax [= =] is reserved for future extensions, %s: Eval-group in
9978 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
9979 Eval-group not allowed at run time, Explicit blessing to '' (assuming
9980 package main), Illegal hex digit ignored, No such array field, No such
9981 field "%s" in variable %s of type %s, Out of memory during ridiculously
9982 large request, Range iterator outside integer range, Recursive inheritance
9983 detected while looking for method '%s' %s, Reference found where even-sized
9984 list expected, Undefined value assigned to typeglob, Use of reserved word
9985 "%s" is deprecated, perl: warning: Setting locale failed
9987 =item Obsolete Diagnostics
9989 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
9990 temporary file, regexp too big
9992 =item Configuration Changes
10002 =head2 perl5004delta - what's new for perl5.004
10008 =item Supported Environments
10014 =item List assignment to %ENV works
10016 =item Change to "Can't locate Foo.pm in @INC" error
10018 =item Compilation option: Binary compatibility with 5.003
10020 =item $PERL5OPT environment variable
10022 =item Limitations on B<-M>, B<-m>, and B<-T> options
10024 =item More precise warnings
10026 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
10028 =item Previously deprecated %OVERLOAD is no longer usable
10030 =item Subroutine arguments created only when they're modified
10032 =item Group vector changeable with C<$)>
10034 =item Fixed parsing of $$<digit>, &$<digit>, etc.
10036 =item Fixed localization of $<digit>, $&, etc.
10038 =item No resetting of $. on implicit close
10040 =item C<wantarray> may return undef
10042 =item C<eval EXPR> determines value of EXPR in scalar context
10044 =item Changes to tainting checks
10046 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
10047 spawning if tainted $TERM doesn't look like a terminal name
10049 =item New Opcode module and revised Safe module
10051 =item Embedding improvements
10053 =item Internal change: FileHandle class based on IO::* classes
10055 =item Internal change: PerlIO abstraction interface
10057 =item New and changed syntax
10061 =item New and changed builtin constants
10065 =item New and changed builtin variables
10069 =item New and changed builtin functions
10071 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
10072 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
10073 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
10074 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
10075 nested C<sub{}> closures work now, formats work right on changing lexicals
10077 =item New builtin methods
10079 isa(CLASS), can(METHOD), VERSION( [NEED] )
10081 =item TIEHANDLE now supported
10083 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
10084 LIST, READLINE this, GETC this, DESTROY this
10086 =item Malloc enhancements
10088 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
10090 =item Miscellaneous efficiency enhancements
10094 =item Support for More Operating Systems
10110 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
10111 constant NAME => VALUE, use locale, use ops, use vmsish
10117 =item Required Updates
10119 =item Installation directories
10121 =item Module information summary
10127 =item Math::Complex
10135 =item Object-oriented overrides for builtin operators
10139 =item Utility Changes
10145 Sends converted HTML to standard output
10149 C<void> XSUBs now default to returning nothing
10153 =item C Language API Changes
10155 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
10156 manipulating hashes
10158 =item Documentation Changes
10160 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
10161 L<perlmodlib>, L<perldebug>, L<perlsec>
10163 =item New Diagnostics
10165 "my" variable %s masks earlier declaration in same scope, %s argument is
10166 not a HASH element or slice, Allocation too large: %lx, Allocation too
10167 large, Applying %s to %s will act on scalar(%s), Attempt to free
10168 nonexistent shared string, Attempt to use reference as lvalue in substr,
10169 Bareword "%s" refers to nonexistent package, Can't redefine active sort
10170 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
10171 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
10172 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
10173 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
10174 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
10175 %s, Integer overflow in hex number, Integer overflow in octal number,
10176 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
10177 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
10178 possible typo, Null picture in formline, Offset outside string, Out of
10179 memory!, Out of memory during request for %s, panic: frexp, Possible
10180 attempt to put comments in qw() list, Possible attempt to separate words
10181 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
10182 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
10183 option, untie attempted while %d inner references still exist, Unrecognized
10184 character %s, Unsupported function fork, Use of "$$<digit>" to mean
10185 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
10186 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
10187 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
10188 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
10189 long, Process terminated by SIG%s
10199 =head2 perlartistic - the Perl Artistic License
10207 =item The "Artistic License"
10215 "Package", "Standard Version", "Copyright Holder", "You", "Reasonable
10216 copying fee", "Freely Available"
10220 a), b), c), d), a), b), c), d)
10226 =head2 perlgpl - the GNU General Public License, version 2
10238 =item GNU GENERAL PUBLIC LICENSE
10242 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
10250 =item Compiling Perl 5 on AIX
10252 =item Supported Compilers
10254 =item Perl 5.8.9 was successfully compiled and tested on:
10256 AIX Level | Compiler Level | w th | w/o th
10257 --------------------------+-------------------------+------+-------
10258 5.1 TL9 32 bit | XL C/C++ V7 | OK | OK
10259 5.1 TL9 32 bit | gcc 3.2.2 | OK | OK
10260 5.1 TL9 64 bit | XL C/C++ V7 | OK | OK
10261 5.2 TL10 32 bit | XL C/C++ V8 | OK | OK
10262 5.2 TL10 64 bit | XL C/C++ V8 | OK | OK
10263 5.3 TL7 32 bit | XL C/C++ V9 + IZ35785 | OK | OK
10264 5.3 TL7 32 bit | gcc 4.2.4 | OK | OK
10265 5.3 TL7 64 bit | XL C/C++ V9 + IZ35785 | OK | OK
10266 6.1 TL1 32 bit | XL C/C++ V10 | OK | OK
10267 6.1 TL1 64 bit + IZ39077 | XL C/C++ V10 | OK | OK
10270 w/o th = without thread
10272 =item Building Dynamic Extensions on AIX
10274 =item Using Large Files with Perl
10276 =item Threaded Perl
10280 =item Recommended Options AIX 5.1/5.2/5.3 and 6.1 (threaded/32-bit)
10282 =item Recommended Options AIX 5.1/5.2/5.3 and 6.1 (32-bit)
10284 =item Recommended Options AIX 5.1/5.2/5.3 and 6.1 (threaded/64-bit)
10286 =item Recommended Options AIX 5.1/5.2/5.3 and 6.1(64-bit)
10288 =item Compiling Perl 5 on older AIX versions up to 4.3.3
10292 =item Building Dynamic Extensions on AIX
10294 =item The IBM ANSI C Compiler
10296 =item The usenm option
10298 =item Using GNU's gcc for building Perl
10300 =item Using Large Files with Perl
10302 =item Threaded Perl
10306 =item AIX 4.2 and extensions using C++ with statics
10316 =head2 perlamiga - Perl under Amiga OS
10332 =item Prerequisites for Compiling Perl on AmigaOS
10334 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
10336 =item Starting Perl programs under AmigaOS
10338 =item Shortcomings of Perl under AmigaOS
10344 =item Accessing documentation
10348 =item Manpages for Perl on AmigaOS
10350 =item Perl HTML Documentation on AmigaOS
10352 =item Perl GNU Info Files on AmigaOS
10354 =item Perl LaTeX Documentation on AmigaOS
10358 =item BUILDING PERL ON AMIGAOS
10362 =item Build Prerequisites for Perl on AmigaOS
10364 =item Getting the Perl Source for AmigaOS
10366 =item Making Perl on AmigaOS
10368 =item Testing Perl on AmigaOS
10370 =item Installing the built Perl on AmigaOS
10374 =item PERL 5.8.0 BROKEN IN AMIGAOS
10382 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
10392 =head2 perlbeos, README.beos - Perl version 5.8+ on BeOS
10398 =item BUILD AND INSTALL
10412 =item KNOWN PROBLEMS
10418 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
10428 =item gzip on BS2000
10430 =item bison on BS2000
10432 =item Unpacking Perl Distribution on BS2000
10434 =item Compiling Perl on BS2000
10436 =item Testing Perl on BS2000
10438 =item Installing Perl on BS2000
10440 =item Using Perl in the Posix-Shell of BS2000
10442 =item Using Perl in "native" BS2000
10444 =item Floating point anomalies on BS2000
10446 =item Using PerlIO and different encodings on ASCII and EBCDIC partitions
10464 =head2 perlce - Perl for WinCE
10468 =item Building Perl for WinCE
10474 =item General explanations on cross-compiling WinCE
10478 Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's
10479 celib-sources, Rainer Keuchel's console-sources, go to C<./win32>
10480 subdirectory, edit file C<./win32/ce-helpers/compile.bat>, run
10481 compile.bat, run compile.bat dist
10485 =item Using Perl on WinCE
10495 PERL5LIB, PATH, TMP, UNIXROOTPATH, ROWS/COLS, HOME, CONSOLEFONTSIZE
10507 =item ACKNOWLEDGEMENTS
10509 =item History of WinCE port
10513 Rainer Keuchel <coyxc@rainer-keuchel.de>, Vadim Konovalov
10517 =head2 perlcygwin, README.cygwin - Perl for Cygwin
10523 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
10527 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
10529 =item Cygwin Configuration
10531 C<PATH>, I<nroff>, Permissions
10535 =item CONFIGURE PERL ON CYGWIN
10539 =item Stripping Perl Binaries on Cygwin
10541 =item Optional Libraries for Perl on Cygwin
10543 C<-lcrypt>, C<-lgdbm_compat> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
10544 C<cygserver> (C<use IPC::SysV>), C<-lutil>
10546 =item Configure-time Options for Perl on Cygwin
10548 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
10549 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
10552 =item Suspicious Warnings on Cygwin
10554 Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
10558 =item MAKE ON CYGWIN
10560 =item TEST ON CYGWIN
10564 =item File Permissions on Cygwin
10566 =item NDBM_File and ODBM_File do not work on FAT filesystems
10568 =item C<fork()> failures in io_* tests
10572 =item Specific features of the Cygwin port
10576 =item Script Portability on Cygwin
10578 Pathnames, Text/Binary, PerlIO, F<.exe>, Cygwin vs. Windows process ids,
10579 Cygwin vs. Windows errors, C<chown()>, Miscellaneous
10581 =item Prebuilt methods:
10583 C<Cwd::cwd>, C<Cygwin::pid_to_winpid>, C<Cygwin::winpid_to_pid>,
10584 C<Cygwin::win_to_posix_path>, C<Cygwin::posix_to_win_path>,
10585 C<Cygwin::mount_table()>, C<Cygwin::mount_flags>, C<Cygwin::is_binmount>
10589 =item INSTALL PERL ON CYGWIN
10591 =item MANIFEST ON CYGWIN
10593 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
10594 Source, Compiled Module Source, Perl Modules/Scripts, Perl Module Tests
10596 =item BUGS ON CYGWIN
10604 =head2 perldgux - Perl under DG/UX.
10616 =item BUILDING PERL ON DG/UX
10620 =item Non-threaded Perl on DG/UX
10622 =item Threaded Perl on DG/UX
10624 =item Testing Perl on DG/UX
10626 =item Installing the built perl on DG/UX
10636 =head2 perldos - Perl under DOS, W31, W95.
10646 =item Prerequisites for Compiling Perl on DOS
10650 =item Shortcomings of Perl under DOS
10652 =item Building Perl on DOS
10654 =item Testing Perl on DOS
10656 =item Installation of Perl on DOS
10660 =item BUILDING AND INSTALLING MODULES ON DOS
10664 =item Building Prerequisites for Perl on DOS
10666 =item Unpacking CPAN Modules on DOS
10668 =item Building Non-XS Modules on DOS
10670 =item Building XS Modules on DOS
10680 =head2 perlepoc, README.epoc - Perl for EPOC
10688 =item INSTALLING PERL ON EPOC
10690 =item STARTING PERL ON EPOC
10694 =item Editors on Epoc
10696 =item Features of Perl on Epoc
10698 =item Restrictions of Perl on Epoc
10700 =item Compiling Perl 5 on the EPOC cross compiling environment
10704 =item SUPPORT STATUS OF PERL ON EPOC
10712 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
10720 =item FreeBSD core dumps from readdir_r with ithreads
10722 =item $^X doesn't always contain a full path in FreeBSD
10724 =item Perl will no longer be part of "base FreeBSD"
10732 =head2 perlhaiku, README.haiku - Perl version 5.10+ on Haiku
10738 =item BUILD AND INSTALL
10740 =item KNOWN PROBLEMS
10746 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
10755 =item Using perl as shipped with HP-UX
10757 =item Using perl from HP's porting centre
10759 =item Compiling Perl 5 on HP-UX
10763 =item Portability Between PA-RISC Versions
10771 =item Itanium Processor Family (IPF) and HP-UX
10773 =item Itanium, Itanium 2 & Madison 6
10775 =item HP-UX versions
10777 =item Building Dynamic Extensions on HP-UX
10779 =item The HP ANSI C Compiler
10781 =item The GNU C Compiler
10783 =item Using Large Files with Perl on HP-UX
10785 =item Threaded Perl on HP-UX
10787 =item 64-bit Perl on HP-UX
10789 =item Oracle on HP-UX
10791 =item GDBM and Threads on HP-UX
10793 =item NFS filesystems and utime(2) on HP-UX
10795 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
10799 =item nss_delete core dump from op/pwent or op/grent
10801 =item Miscellaneous
10809 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
10817 =item Known Problems with Perl on Hurd
10825 =head2 perlirix, README.irix - Perl version 5 on Irix systems
10833 =item Building 32-bit Perl in Irix
10835 =item Building 64-bit Perl in Irix
10837 =item About Compiler Versions of Irix
10839 =item Linker Problems in Irix
10841 =item Malloc in Irix
10843 =item Building with threads in Irix
10853 =head2 perllinux, README.linux - Perl version 5 on Linux systems
10861 =item Experimental Support for Sun Studio Compilers for Linux OS
10869 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
10878 =item Perl version 5.8.x and greater not supported
10880 =item Compiling Perl 5.6.x on MachTen
10882 =item Failures during C<make test> on MachTen
10884 op/lexassign.t, pragma/warnings.t
10886 =item Building external modules on MachTen
10896 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
10910 =head2 perlmacosx, README.macosx - Perl under Mac OS X
10920 =item Installation Prefix
10924 =item Universal Binary support
10926 =item 64-bit PPC support
10928 =item libperl and Prebinding
10930 =item Updating Apple's Perl
10932 =item Known problems
10942 =item Starting From Scratch
10950 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
10956 =item Known problems with Perl on MiNT
10962 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
10970 =item Binary distribution from HP
10972 =item What's New in Perl for MPE/iX
10974 =item Welcome to Perl/iX
10976 =item System Requirements for Perl/iX
10978 =item How to Obtain Perl/iX
10980 =item Perl/iX Distribution Contents Highlights
10982 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
10983 public_html/feedback.cgi, src/perl-5.6.0-mpe
10985 =item How to Compile Perl/iX
10989 =item Getting Started with Perl/iX
10991 =item MPE/iX Implementation Considerations
10993 =item Known Perl/iX Bugs Under Investigation
10995 =item Perl/iX To-Do List
10997 =item Perl/iX Change History
11003 =head2 perlnetware - Perl for NetWare
11017 SetNWBld.bat, Buildtype.bat
11029 =item BUILD NEW EXTENSIONS
11031 =item ACKNOWLEDGEMENTS
11039 =head2 perlopenbsd, README.openbsd - Perl version 5 on OpenBSD systems
11047 =item OpenBSD core dumps from getprotobyname_r and getservbyname_r with
11056 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
11074 =item Prerequisites
11076 EMX, RSX, HPFS, pdksh
11078 =item Starting Perl programs under OS/2 (and DOS and...)
11080 =item Starting OS/2 (and DOS) programs under Perl
11084 =item Frequently asked questions
11088 =item "It does not work"
11090 =item I cannot run external programs
11092 =item I cannot embed perl into my program, or use F<perl.dll> from my
11095 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
11096 L<ExtUtils::Embed>?
11098 =item C<``> and pipe-C<open> do not work under DOS.
11100 =item Cannot start C<find.exe "pattern" file>
11108 =item Automatic binary installation
11110 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
11112 =item Manual binary installation
11114 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
11115 (statically linked), Executables for Perl utilities, Main Perl library,
11116 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
11117 and utilities, Manpages for Perl modules, Source for Perl documentation,
11118 Perl manual in F<.INF> format, Pdksh
11124 =item Accessing documentation
11128 =item OS/2 F<.INF> file
11136 =item GNU C<info> files
11140 =item C<LaTeX> docs
11148 =item The short story
11150 =item Prerequisites
11152 =item Getting perl source
11154 =item Application of the patches
11162 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
11165 =item Installing the built perl
11167 =item C<a.out>-style build
11171 =item Building a binary distribution
11173 =item Building custom F<.EXE> files
11177 =item Making executables with a custom collection of statically loaded
11180 =item Making executables with a custom search-paths
11188 =item Some C</> became C<\> in pdksh.
11190 =item C<'errno'> - unresolved external
11192 =item Problems with tr or sed
11194 =item Some problem (forget which ;-)
11196 =item Library ... not found
11198 =item Segfault in make
11200 =item op/sprintf test failure
11204 =item Specific (mis)features of OS/2 port
11208 =item C<setpriority>, C<getpriority>
11212 =item C<extproc> on the first line
11214 =item Additional modules:
11216 =item Prebuilt methods:
11218 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>, C<Cwd::current_drive()>,
11219 C<Cwd::sys_chdir(name)>, C<Cwd::change_drive(name)>,
11220 C<Cwd::sys_is_absolute(name)>, C<Cwd::sys_is_rooted(name)>,
11221 C<Cwd::sys_is_relative(name)>, C<Cwd::sys_cwd(name)>,
11222 C<Cwd::sys_abspath(name, dir)>, C<Cwd::extLibpath([type])>,
11223 C<Cwd::extLibpath_set( path [, type ] )>,
11224 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
11225 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
11226 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
11227 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
11228 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
11229 C<OS2::DLLname([how [, \&xsub]])>
11231 =item Prebuilt variables:
11233 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
11238 =item Modifications
11240 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
11243 =item Identifying DLLs
11245 =item Centralized management of resources
11247 C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
11248 C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
11249 C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
11250 C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
11262 =item F<perl__.exe>
11264 =item F<perl___.exe>
11266 =item Why strange names?
11268 =item Why dynamic linking?
11270 =item Why chimera build?
11278 =item C<PERLLIB_PREFIX>
11280 =item C<PERL_BADLANG>
11282 =item C<PERL_BADFREE>
11284 =item C<PERL_SH_DIR>
11286 =item C<USE_PERL_FLOCK>
11288 =item C<TMP> or C<TEMP>
11296 =item Text-mode filehandles
11300 =item DLL name mangling: pre 5.6.2
11302 =item DLL name mangling: 5.6.2 and beyond
11304 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
11307 =item DLL forwarder generation
11311 =item Calls to external programs
11313 =item Memory allocation
11317 C<COND_WAIT>, F<os2.c>
11333 =head2 perlos390, README.os390 - building and installing Perl for OS/390
11346 =item Unpacking Perl distribution on OS/390
11348 =item Setup and utilities for Perl on OS/390
11350 =item Configure Perl on OS/390
11352 =item Build, Test, Install Perl on OS/390
11354 =item Build Anomalies with Perl on OS/390
11356 =item Testing Anomalies with Perl on OS/390
11358 =item Installation Anomalies with Perl on OS/390
11360 =item Usage Hints for Perl on OS/390
11362 =item Floating Point Anomalies with Perl on OS/390
11364 =item Modules and Extensions for Perl on OS/390
11374 =item Mailing list for Perl on OS/390
11382 =head2 perlos400, README.os400 - Perl version 5 on OS/400
11390 =item Compiling Perl for OS/400 PASE
11392 =item Installing Perl in OS/400 PASE
11394 =item Using Perl in OS/400 PASE
11396 =item Known Problems
11406 =head2 perlplan9 - Plan 9-specific documentation for Perl
11414 =item Invoking Perl
11416 =item What's in Plan 9 Perl
11418 =item What's not in Plan 9 Perl
11420 =item Perl5 Functions not currently supported in Plan 9 Perl
11422 =item Signals in Plan 9 Perl
11426 =item COMPILING AND INSTALLING PERL ON PLAN 9
11430 =item Installing Perl Documentation on Plan 9
11436 =item Revision date
11442 =head2 perlqnx, README.qnx - Perl version 5 on QNX
11450 =item Required Software for Compiling Perl on QNX4
11452 /bin/sh, ar, nm, cpp, make
11454 =item Outstanding Issues with Perl on QNX4
11456 =item QNX auxiliary files
11460 =item Outstanding issues with perl under QNX6
11468 =head2 perlriscos, README.riscos - Perl version 5 for RISC OS
11480 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
11488 =item Solaris Version Numbers.
11494 Solaris FAQ, Precompiled Binaries, Solaris Documentation
11500 =item File Extraction Problems on Solaris.
11502 =item Compiler and Related Tools on Solaris.
11504 =item Environment for Compiling perl on Solaris
11508 =item RUN CONFIGURE.
11512 =item 64-bit perl on Solaris.
11514 =item Threads in perl on Solaris.
11516 =item Malloc Issues with perl on Solaris.
11520 =item MAKE PROBLEMS.
11522 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
11523 relocation error:, dlopen: stub interception failed, #error "No
11524 DATAMODEL_NATIVE specified", sh: ar: not found
11530 =item op/stat.t test 4 in Solaris
11532 =item nss_delete core dump from op/pwent or op/grent
11536 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
11538 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
11542 =item Limits on Numbers of Open Files on Solaris.
11546 =item SOLARIS-SPECIFIC MODULES.
11548 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
11552 =item Proc::ProcessTable on Solaris
11554 =item BSD::Resource on Solaris
11556 =item Net::SSLeay on Solaris
11566 =head2 perlsymbian, README.symbian - Perl version 5 on Symbian OS
11574 =item Compiling Perl on Symbian
11576 =item Compilation problems
11582 =item Using Perl in Symbian
11602 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
11603 Digital UNIX formerly known as DEC OSF/1) systems
11611 =item Compiling Perl 5 on Tru64
11613 =item Using Large Files with Perl on Tru64
11615 =item Threaded Perl on Tru64
11617 =item Long Doubles on Tru64
11619 =item DB_File tests failing on Tru64
11621 =item 64-bit Perl on Tru64
11623 =item Warnings about floating-point overflow when compiling Perl on Tru64
11627 =item Testing Perl on Tru64
11629 =item ext/ODBM_File/odbm Test Failing With Static Builds
11631 =item Perl Fails Because Of Unresolved Symbol sockatmark
11637 =head2 perluts - Perl under UTS
11645 =item BUILDING PERL ON UTS
11647 =item Installing the built perl on UTS
11653 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
11663 =item Unpacking Perl Distribution on VM/ESA
11665 =item Setup Perl and utilities on VM/ESA
11667 =item Configure Perl on VM/ESA
11669 =item Testing Anomalies of Perl on VM/ESA
11671 =item Usage Hints for Perl on VM/ESA
11681 =item Mailing list for Perl on VM/ESA
11687 =head2 perlvms - VMS-specific documentation for Perl
11695 =item Organization of Perl Images
11701 =item Perl Extensions
11703 =item Installing static extensions
11705 =item Installing dynamic extensions
11709 =item File specifications
11715 =item Filename Case
11717 =item Symbolic Links
11719 =item Wildcard expansion
11725 =item PERL5LIB and PERLLIB
11727 =item The Perl Forked Debugger
11729 =item PERL_VMS_EXCEPTION_DEBUG
11735 =item I/O redirection and backgrounding
11737 =item Command line switches
11743 =item Perl functions
11745 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, die,
11746 dump, exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//,
11747 select (system call), stat EXPR, system LIST, time, times, unlink LIST,
11748 utime LIST, waitpid PID,FLAGS
11750 =item Perl variables
11752 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
11754 =item Standard modules with VMS-specific differences
11762 =item Revision date
11768 =head2 perlvos, README.vos - Perl for Stratus VOS
11774 =item BUILDING PERL FOR VOS
11776 =item INSTALLING PERL IN VOS
11778 =item USING PERL IN VOS
11782 =item Restrictions of Perl on VOS
11784 =item Handling of underflow and overflow
11790 =item SUPPORT STATUS
11798 =head2 perlwin32 - Perl under Windows
11808 =item Setting Up Perl on Win32
11810 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Visual
11811 C++ 2008 Express Edition, Microsoft Visual C++ 2005 Express Edition,
11812 Microsoft Visual C++ Toolkit 2003, Microsoft Platform SDK 64-bit Compiler,
11813 MinGW release 3 with gcc, MinGW release 1 with gcc
11817 =item Testing Perl on Win32
11819 =item Installation of Perl on Win32
11821 =item Usage Hints for Perl on Win32
11823 Environment Variables, File Globbing, Using perl from the command line,
11824 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
11825 Extensions, Notes on 64-bit Windows
11827 =item Running Perl Scripts
11829 =item Miscellaneous Things
11833 =item BUGS AND CAVEATS
11835 =item ACKNOWLEDGEMENTS
11839 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
11840 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
11841 E<lt>nick@ing-simmons.netE<gt>, Jan Dubois E<lt>jand@activestate.comE<gt>,
11842 Steve Hay E<lt>steve.hay@uk.radan.comE<gt>
11850 =head1 PRAGMA DOCUMENTATION
11852 =head2 attrs - set/get attributes of a subroutine (deprecated)
11864 =head2 re - Perl pragma to alter regular expression behaviour
11882 Compile related options, COMPILE, PARSE, OPTIMISE, TRIEC, DUMP, Execute
11883 related options, EXECUTE, MATCH, TRIEE, INTUIT, Extra debugging options,
11884 EXTRA, BUFFERS, TRIEM, STATE, STACK, OPTIMISEM, OFFSETS, OFFSETSDBG, Other
11885 useful flags, ALL, All, MORE, More
11887 =item Exportable Functions
11889 is_regexp($ref), regexp_pattern($ref), regmust($ref), regname($name,$all),
11890 regnames($all), regnames_count()
11898 =head2 threadshared::shared, threads::shared - Perl extension for sharing
11899 data structures between threads
11913 share VARIABLE, shared_clone REF, is_shared VARIABLE, lock VARIABLE,
11914 cond_wait VARIABLE, cond_wait CONDVAR, LOCKVAR, cond_timedwait VARIABLE,
11915 ABS_TIMEOUT, cond_timedwait CONDVAR, ABS_TIMEOUT, LOCKVAR, cond_signal
11916 VARIABLE, cond_broadcast VARIABLE
11922 =item BUGS AND LIMITATIONS
11932 =head2 threads - Perl interpreter-based threads
11942 $thr = threads->create(FUNCTION, ARGS), $thr->join(), $thr->detach(),
11943 threads->detach(), threads->self(), $thr->tid(), threads->tid(), "$thr",
11944 threads->object($tid), threads->yield(), threads->list(),
11945 threads->list(threads::all), threads->list(threads::running),
11946 threads->list(threads::joinable), $thr1->equal($thr2), async BLOCK;,
11947 $thr->error(), $thr->_handle(), threads->_handle()
11949 =item EXITING A THREAD
11951 threads->exit(), threads->exit(status), die(), exit(status), use threads
11952 'exit' => 'threads_only', threads->create({'exit' => 'thread_only'}, ...),
11953 $thr->set_thread_exit_only(boolean), threads->set_thread_exit_only(boolean)
11957 $thr->is_running(), $thr->is_joinable(), $thr->is_detached(),
11958 threads->is_detached()
11960 =item THREAD CONTEXT
11964 =item Explicit context
11966 =item Implicit context
11968 =item $thr->wantarray()
11970 =item threads->wantarray()
11974 =item THREAD STACK SIZE
11976 threads->get_stack_size();, $size = $thr->get_stack_size();, $old_size =
11977 threads->set_stack_size($new_size);, use threads ('stack_size' => VALUE);,
11978 $ENV{'PERL5_ITHREADS_STACK_SIZE'}, threads->create({'stack_size' => VALUE},
11979 FUNCTION, ARGS), $thr2 = $thr1->create(FUNCTION, ARGS)
11981 =item THREAD SIGNALLING
11983 $thr->kill('SIG...');
11987 Perl exited with active threads:, Thread creation failed: pthread_create
11988 returned #, Thread # terminated abnormally: .., Using minimum thread stack
11989 size of #, Thread creation failed: pthread_attr_setstacksize(I<SIZE>)
11994 This Perl not built to support threads, Cannot change stack size of an
11995 existing thread, Cannot signal threads without safe signals, Unrecognized
11998 =item BUGS AND LIMITATIONS
12000 Thread-safe modules, Using non-thread-safe modules, Current working
12001 directory, Environment variables, Parent-child threads, Creating threads
12002 inside special blocks, Unsafe signals, Perl has been built with
12003 C<PERL_OLD_SIGNALS> (see C<perl -V>), The environment variable
12004 C<PERL_SIGNALS> is set to C<unsafe> (see L<perlrun/"PERL_SIGNALS">), The
12005 module L<Perl::Unsafe::Signals> is used, Returning closures from threads,
12006 Returning objects from threads, END blocks in threads, Perl Bugs and the
12007 CPAN Version of L<threads>
12017 =item ACKNOWLEDGEMENTS
12021 =head2 attributes - get/set subroutine or variable attributes
12031 =item What C<import> does
12033 =item Built-in Attributes
12035 locked, method, lvalue
12037 =item Available Subroutines
12041 =item Package-specific Attribute Handling
12043 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
12045 =item Syntax of Attribute Lists
12053 =item Default exports
12055 =item Available exports
12057 =item Export tags defined
12063 =item MORE EXAMPLES
12069 =head2 autodie - Replace functions with ones that succeed or die with
12082 =item FUNCTION SPECIFIC NOTES
12096 :void cannot be used with lexical scope
12102 =item REPORTING BUGS
12114 =item ACKNOWLEDGEMENTS
12118 =head2 autodiexception, autodie::exception - Exceptions from autodying
12129 =item Common Methods
12137 =item Advanced methods
12151 =head2 autodiexception::system, autodie::exception::system - Exceptions
12152 from autodying system().
12176 =head2 autouse - postpone load of modules until a function is used
12192 =head2 base - Establish an ISA relationship with base classes at compile
12203 Base class package "%s" is empty, Class 'Foo' tried to inherit from itself
12213 =head2 bigint - Transparent BigInteger support for Perl
12223 =item use integer vs. use bigint
12227 a or accuracy, p or precision, t or trace, hex, oct, l, lib, try or only, v
12232 =item Internal Format
12238 inf(), NaN(), e, PI, bexp(), bpi(), upgrade(), in_effect()
12248 in_effect(), hex()/oct()
12262 =head2 bignum - Transparent BigNumber support for Perl
12274 a or accuracy, p or precision, t or trace, l or lib, hex, oct, v or version
12280 inf(), NaN(), e, PI(), bexp(), bpi(), upgrade(), in_effect()
12284 =item INTERNAL FORMAT
12292 in_effect(), hex()/oct()
12306 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
12324 inf(), NaN(), e, PI, bexp(), bpi(), upgrade(), in_effect()
12332 a or accuracy, p or precision, t or trace, l or lib, hex, oct, v or version
12338 in_effect(), hex()/oct()
12342 perl -Mbigrat -le 'print sqrt(33)'
12343 perl -Mbigrat -le 'print 2*255'
12344 perl -Mbigrat -le 'print 4.5+2*255'
12345 perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'
12346 perl -Mbigrat -le 'print 12->is_odd()';
12347 perl -Mbignum=l,GMP -le 'print 7 ** 7777'
12357 =head2 blib - Use MakeMaker's uninstalled version of a package
12371 =head2 bytes - Perl pragma to force byte semantics rather than character
12386 =head2 charnames - define character names for C<\N{named}> string literal
12397 =item CUSTOM ALIASES
12401 =item Anonymous hashes
12405 =item Alias shortcut
12409 =item charnames::viacode(code)
12411 =item charnames::vianame(name)
12413 =item CUSTOM TRANSLATORS
12415 =item ILLEGAL CHARACTERS
12421 =head2 constant - Perl pragma to declare constants
12433 =item List constants
12435 =item Defining multiple constants at once
12437 =item Magic constants
12441 =item TECHNICAL NOTES
12451 =item COPYRIGHT & LICENSE
12455 =head2 diagnostics, splain - produce verbose warning diagnostics
12465 =item The C<diagnostics> Pragma
12467 =item The I<splain> Program
12481 =head2 encoding - allows you to write your script in non-ascii or non-utf8
12491 =item Literal Conversions
12493 =item PerlIO layers for C<STD(IN|OUT)>
12495 =item Implicit upgrading for byte strings
12501 =item FEATURES THAT REQUIRE 5.8.1
12503 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
12507 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
12508 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
12510 =item The Filter Option
12514 =item Filter-related changes at Encode version 1.87
12524 =item DO NOT MIX MULTIPLE ENCODINGS
12526 =item tr/// with ranges
12528 Legend of characters above
12532 =item EXAMPLE - Greekperl
12534 =item KNOWN PROBLEMS
12536 literals in regex that are longer than 127 bytes, EBCDIC, format, Thread
12541 =item The Logic of :locale
12551 =head2 encoding::warnings - Warn on implicit encoding conversions
12563 =item Overview of the problem
12565 =item Detecting the problem
12567 =item Solving the problem
12569 Upgrade both sides to unicode-strings, Downgrade both sides to
12570 byte-strings, Specify the encoding for implicit byte-string upgrading,
12571 PerlIO layers for B<STDIN> and B<STDOUT>, Literal conversions, Implicit
12572 upgrading for byte-strings
12590 =head2 feature - Perl pragma to enable new syntactic features
12600 =item Lexical effect
12602 =item C<no feature>
12604 =item The 'switch' feature
12606 =item The 'say' feature
12608 =item the 'state' feature
12612 =item FEATURE BUNDLES
12614 =item IMPLICIT LOADING
12618 =head2 fields - compile-time class fields
12632 =head2 filetest - Perl pragma to control the filetest permission operators
12642 =item Consider this carefully
12644 =item The "access" sub-pragma
12646 =item Limitation with regard to C<_>
12652 =head2 if - C<use> a Perl module if a condition holds
12666 =head2 integer - Perl pragma to use integer arithmetic instead of floating
12677 =head2 less - perl pragma to request less of something
12685 =item FOR MODULE AUTHORS
12689 =item C<< BOOLEAN = less->of( FEATURE ) >>
12691 =item C<< FEATURES = less->of() >>
12697 This probably does nothing, This works only on 5.10+
12701 =head2 lib - manipulate @INC at compile time
12711 =item Adding directories to @INC
12713 =item Deleting directories from @INC
12715 =item Restoring original @INC
12727 =item COPYRIGHT AND LICENSE
12731 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
12742 =head2 mro - Method Resolution Order
12758 =item How does C3 work
12766 =item mro::get_linear_isa($classname[, $type])
12768 =item mro::set_mro($classname, $type)
12770 =item mro::get_mro($classname)
12772 =item mro::get_isarev($classname)
12774 =item mro::is_universal($classname)
12776 =item mro::invalidate_all_method_caches()
12778 =item mro::method_changed_in($classname)
12780 =item mro::get_pkg_gen($classname)
12786 =item maybe::next::method
12794 =item The original Dylan paper
12796 L<http://www.webcom.com/haahr/dylan/linearization-oopsla96.html>
12798 =item The prototype Perl 6 Object Model uses C3
12800 L<http://svn.openfoundry.org/pugs/perl5/Perl6-MetaModel/>
12802 =item Parrot now uses C3
12804 L<http://aspn.activestate.com/ASPN/Mail/Message/perl6-internals/2746631>,
12805 L<http://use.perl.org/~autrijus/journal/25768>
12807 =item Python 2.3 MRO related links
12809 L<http://www.python.org/2.3/mro.html>,
12810 L<http://www.python.org/2.2.2/descrintro.html#mro>
12812 =item C3 for TinyCLOS
12814 L<http://www.call-with-current-continuation.org/eggs/c3.html>
12826 =head2 open - perl pragma to set default PerlIO layers for input and output
12834 =item NONPERLIO FUNCTIONALITY
12836 =item IMPLEMENTATION DETAILS
12842 =head2 ops - Perl pragma to restrict unsafe operations when compiling
12854 =head2 overload - Package for overloading Perl operations
12864 =item Declaration of overloaded functions
12866 =item Calling Conventions for Binary Operations
12868 FALSE, TRUE, C<undef>
12870 =item Calling Conventions for Unary Operations
12872 =item Calling Conventions for Mutators
12874 C<++> and C<-->, C<x=> and other assignment versions
12876 =item Overloadable Operations
12878 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
12879 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
12880 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
12882 =item Inheritance and overloading
12884 Strings as values of C<use overload> directive, Overloading of an operation
12885 is inherited by derived classes
12889 =item SPECIAL SYMBOLS FOR C<use overload>
12897 C<undef>, TRUE, defined, but FALSE
12901 =item Copy Constructor
12907 =item MAGIC AUTOGENERATION
12909 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
12910 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
12911 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
12914 =item Minimal set of overloaded operations
12916 =item Losing overloading
12918 =item Run-time Overloading
12920 =item Public functions
12922 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
12924 =item Overloading constants
12926 integer, float, binary, q, qr
12928 =item IMPLEMENTATION
12930 =item Metaphor clash
12936 =item Two-face scalars
12938 =item Two-face references
12940 =item Symbolic calculator
12942 =item I<Really> symbolic calculator
12950 Odd number of arguments for overload::constant, `%s' is not an overloadable
12951 type, `%s' is not a code reference
12957 =head2 parent - Establish an ISA relationship with base classes at compile
12968 Class 'Foo' tried to inherit from itself
12976 =item AUTHORS AND CONTRIBUTORS
12984 =head2 sigtrap - Perl pragma to enable simple signal handling
12996 =item SIGNAL HANDLERS
12998 B<stack-trace>, B<die>, B<handler> I<your-handler>
13002 B<normal-signals>, B<error-signals>, B<old-interface-signals>
13006 B<untrapped>, B<any>, I<signal>, I<number>
13014 =head2 sort - perl pragma to control sort() behaviour
13026 =head2 strict - Perl pragma to restrict unsafe constructs
13034 C<strict refs>, C<strict vars>, C<strict subs>
13040 =head2 subs - Perl pragma to predeclare sub names
13050 =head2 threadshared, threads::shared - Perl extension for sharing data
13051 structures between threads
13065 share VARIABLE, shared_clone REF, is_shared VARIABLE, lock VARIABLE,
13066 cond_wait VARIABLE, cond_wait CONDVAR, LOCKVAR, cond_timedwait VARIABLE,
13067 ABS_TIMEOUT, cond_timedwait CONDVAR, ABS_TIMEOUT, LOCKVAR, cond_signal
13068 VARIABLE, cond_broadcast VARIABLE
13074 =item BUGS AND LIMITATIONS
13084 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
13095 =item Utility functions
13097 $num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[,
13098 FAIL_OK]), utf8::encode($string), $success = utf8::decode($string), $flag =
13099 utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
13109 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
13119 =head2 version - Perl extension for Version Objects
13129 =item BEST PRACTICES
13131 Be consistent, Be careful
13133 =item Using modules that use version.pm
13135 Numeric versions always work, Extended version work sometimes
13137 =item What IS a version
13139 Numeric Versions, Extended Versions
13141 =item Numeric Versions
13143 =item Extended Versions
13145 =item Numeric Alpha Versions
13147 =item Object Methods
13149 New Operator, qv(), Normal Form, Numification, Stringification, Comparison
13150 operators, Logical Operators
13154 =item What about v-strings?
13156 =item Types of Versions Objects
13158 Ordinary versions, Alpha Versions
13160 =item Replacement UNIVERSAL::VERSION
13174 =head2 vmsish - Perl pragma to control VMS-specific language features
13182 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
13186 =head2 warnings - Perl pragma to control optional warnings
13194 use warnings::register, warnings::enabled(), warnings::enabled($category),
13195 warnings::enabled($object), warnings::warn($message),
13196 warnings::warn($category, $message), warnings::warn($object, $message),
13197 warnings::warnif($message), warnings::warnif($category, $message),
13198 warnings::warnif($object, $message)
13202 =head2 warnings::register - warnings import function
13212 =head1 MODULE DOCUMENTATION
13214 =head2 AnyDBM_File - provide framework for multiple DBMs
13224 =item DBM Comparisons
13234 =head2 App::Prove - Implements the C<prove> command.
13256 =item Class Methods
13266 C<archive>, C<argv>, C<backwards>, C<blib>, C<color>, C<directives>,
13267 C<dry>, C<exec>, C<extension>, C<failures>, C<fork>, C<formatter>,
13268 C<harness>, C<ignore_exit>, C<includes>, C<jobs>, C<lib>, C<merge>,
13269 C<modules>, C<parse>, C<plugins>, C<quiet>, C<really_quiet>, C<recurse>,
13270 C<rules>, C<show_count>, C<show_help>, C<show_man>, C<show_version>,
13271 C<shuffle>, C<state>, C<taint_fail>, C<taint_warn>, C<test_args>, C<timer>,
13272 C<verbose>, C<warnings_fail>, C<warnings_warn>
13276 =head2 App::Prove::State - State storage for the C<prove> command.
13298 =item Class Methods
13306 =item C<result_class>
13330 =item Instance Methods
13332 C<last>, C<failed>, C<passed>, C<all>, C<hot>, C<todo>, C<slow>, C<fast>,
13333 C<new>, C<old>, C<save>
13337 =head2 App::Prove::State::Result - Individual test suite results.
13359 =item Class Methods
13367 =item C<state_version>
13373 =item C<test_class>
13377 =head2 App::Prove::State::Result::Test - Individual test results.
13399 =item Class Methods
13407 =item Instance Methods
13411 =head2 Archive::Extract - A generic archive extracting mechanism
13427 =item $ae = Archive::Extract->new(archive => '/path/to/archive',[type =>
13430 tar, tgz, gz, Z, zip, bz2, tbz, lzma
13438 =item $ae->extract( [to => '/output/path'] )
13440 $ae->extract_path, $ae->files
13450 =item $ae->error([BOOL])
13452 =item $ae->extract_path
13486 =item $ae->bin_gzip
13488 =item $ae->bin_unzip
13490 =item $ae->bin_unlzma
13496 =item $bool = $ae->have_old_bunzip2
13508 =item File Extensions
13510 =item Supporting Very Large Files
13512 =item Bunzip2 support of arbitrary extensions.
13516 =item GLOBAL VARIABLES
13520 =item $Archive::Extract::DEBUG
13522 =item $Archive::Extract::WARN
13524 =item $Archive::Extract::PREFER_BIN
13540 =head2 Archive::Tar - module for manipulations of tar archives
13548 =item Object Methods
13552 =item Archive::Tar->new( [$file, $compressed] )
13560 =item $tar->read ( $filename|$handle, [$compressed, {opt => 'val'}] )
13562 limit, filter, extract
13568 =item $tar->contains_file( $filename )
13574 =item $tar->extract( [@filenames] )
13580 =item $tar->extract_file( $file, [$extract_path] )
13586 =item $tar->list_files( [\@properties] )
13592 =item $tar->get_files( [@filenames] )
13598 =item $tar->get_content( $file )
13604 =item $tar->replace_content( $file, $content )
13610 =item $tar->rename( $file, $new_name )
13616 =item $tar->remove (@filenamelist)
13628 =item $tar->write ( [$file, $compressed, $prefix] )
13634 =item $tar->add_files( @filenamelist )
13640 =item $tar->add_data ( $filename, $data, [$opthashref] )
13642 FILE, HARDLINK, SYMLINK, CHARDEV, BLOCKDEV, DIR, FIFO, SOCKET
13648 =item $tar->error( [$BOOL] )
13654 =item $tar->setcwd( $cwd );
13660 =item Class Methods
13664 =item Archive::Tar->create_archive($file, $compressed, @filelist)
13672 =item Archive::Tar->iter( $filename, [ $compressed, {opt => $val} ] )
13678 =item Archive::Tar->list_archive($file, $compressed, [\@properties])
13684 =item Archive::Tar->extract_archive($file, $compressed)
13690 =item $bool = Archive::Tar->has_io_string
13696 =item $bool = Archive::Tar->has_perlio
13702 =item $bool = Archive::Tar->has_zlib_support
13708 =item $bool = Archive::Tar->has_bzip2_support
13714 =item Archive::Tar->can_handle_compressed_files
13720 =item GLOBAL VARIABLES
13724 =item $Archive::Tar::FOLLOW_SYMLINK
13726 =item $Archive::Tar::CHOWN
13728 =item $Archive::Tar::CHMOD
13730 =item $Archive::Tar::DO_NOT_USE_PREFIX
13732 =item $Archive::Tar::DEBUG
13734 =item $Archive::Tar::WARN
13736 =item $Archive::Tar::error
13738 =item $Archive::Tar::INSECURE_EXTRACT_MODE
13740 =item $Archive::Tar::HAS_PERLIO
13742 =item $Archive::Tar::HAS_IO_STRING
13748 What's the minimum perl version required to run Archive::Tar?, Isn't
13749 Archive::Tar slow?, Isn't Archive::Tar heavier on memory than /bin/tar?,
13750 Can you lazy-load data instead?, How much memory will an X kb tar file
13751 need?, What do you do with unsupported filetypes in an archive?, I'm using
13752 WinZip, or some other non-POSIX client, and files are not being extracted
13753 properly!, How do I extract only files that have property X from an
13754 archive?, How do I access .tar.Z files?, How do I handle Unicode strings?
13758 Check if passed in handles are open for read/write, Allow archives to be
13759 passed in as string, Facilitate processing an opened filehandle of a
13764 The GNU tar specification, The PAX format specication, A comparison of GNU
13765 and POSIX tar standards;
13766 C<http://www.delorie.com/gnu/docs/tar/tar_114.html>, GNU tar intends to
13767 switch to POSIX compatibility, A Comparison between various tar
13772 =item ACKNOWLEDGEMENTS
13778 =head2 Archive::Tar::File - a subclass for in-memory extracted file from
13791 name, mode, uid, gid, size, mtime, chksum, type, linkname, magic, version,
13792 uname, gname, devmajor, devminor, prefix, raw
13800 =item Archive::Tar::File->new( file => $path )
13802 =item Archive::Tar::File->new( data => $path, $data, $opt )
13804 =item Archive::Tar::File->new( chunk => $chunk )
13812 =item $bool = $file->extract( [ $alternative_name ] )
13818 =item $path = $file->full_path
13824 =item $bool = $file->validate
13830 =item $bool = $file->has_content
13836 =item $content = $file->get_content
13842 =item $cref = $file->get_content_by_ref
13848 =item $bool = $file->replace_content( $content )
13854 =item $bool = $file->rename( $new_name )
13860 =item Convenience methods
13862 $file->is_file, $file->is_dir, $file->is_hardlink, $file->is_symlink,
13863 $file->is_chardev, $file->is_blockdev, $file->is_fifo, $file->is_socket,
13864 $file->is_longlink, $file->is_label, $file->is_unknown
13868 =head2 Attribute::Handlers - Simpler definition of attribute handlers
13878 [0], [1], [2], [3], [4], [5], [6], [7]
13882 =item Typed lexicals
13884 =item Type-specific attribute handlers
13886 =item Non-interpretive attribute handlers
13888 =item Phase-specific attribute handlers
13890 =item Attributes as C<tie> interfaces
13898 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
13899 attributes>, C<Declaration of %s attribute in package %s may clash with
13900 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
13901 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
13902 be able to apply END handler>
13908 =item COPYRIGHT AND LICENSE
13912 =head2 AutoLoader - load subroutines only on demand
13922 =item Subroutine Stubs
13924 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
13926 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
13928 =item Package Lexicals
13930 =item Not Using AutoLoader
13932 =item B<AutoLoader> vs. B<SelfLoader>
13942 =item COPYRIGHT AND LICENSE
13946 =head2 AutoSplit - split a package for autoloading
13954 $keep, $check, $modtime
13958 =item Multiple packages
13966 =item COPYRIGHT AND LICENSE
13970 =head2 B - The Perl Compiler
13980 =item Utility Functions
13984 =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV>
13987 sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av,
13988 check_av, unitcheck_av, begin_av, end_av, comppadlist, regex_padav, main_cv
13990 =item Functions for Examining the Symbol Table
13992 walksymtable(SYMREF, METHOD, RECURSE, PREFIX)
13994 =item Functions Returning C<B::OP> objects or for walking op trees
13996 main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG)
13998 =item Miscellaneous Utility Functions
14000 ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR),
14001 perlstring(STR), class(OBJ), threadsv_names
14003 =item Exported utility variabiles
14005 @optype, @specialsv_name
14009 =item OVERVIEW OF CLASSES
14013 =item SV-RELATED CLASSES
14015 =item B::SV Methods
14017 REFCNT, FLAGS, object_2svref
14019 =item B::IV Methods
14021 IV, IVX, UVX, int_value, needs64bits, packiv
14023 =item B::NV Methods
14027 =item B::RV Methods
14031 =item B::PV Methods
14035 =item B::PVMG Methods
14039 =item B::MAGIC Methods
14041 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
14043 =item B::PVLV Methods
14045 TARGOFF, TARGLEN, TYPE, TARG
14047 =item B::BM Methods
14049 USEFUL, PREVIOUS, RARE, TABLE
14051 =item B::GV Methods
14053 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
14054 LINE, FILE, FILEGV, GvREFCNT, FLAGS
14056 =item B::IO Methods
14058 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
14059 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
14061 =item B::AV Methods
14063 FILL, MAX, ARRAY, ARRAYelt, OFF, AvFLAGS
14065 =item B::CV Methods
14067 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB,
14068 XSUBANY, CvFLAGS, const_sv
14070 =item B::HV Methods
14072 FILL, MAX, KEYS, RITER, NAME, ARRAY, PMROOT
14074 =item OP-RELATED CLASSES
14076 =item B::OP Methods
14078 next, sibling, name, ppaddr, desc, targ, type, opt, flags, private, spare
14080 =item B::UNOP METHOD
14084 =item B::BINOP METHOD
14088 =item B::LOGOP METHOD
14092 =item B::LISTOP METHOD
14096 =item B::PMOP Methods
14098 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, extflags, precomp,
14101 =item B::SVOP METHOD
14105 =item B::PADOP METHOD
14109 =item B::PVOP METHOD
14113 =item B::LOOP Methods
14115 redoop, nextop, lastop
14117 =item B::COP Methods
14119 label, stash, stashpv, file, cop_seq, arybase, line, warnings, io, hints,
14128 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
14142 =item Options for Opcode Ordering
14144 B<-basic>, B<-exec>, B<-tree>
14146 =item Options for Line-Style
14148 B<-concise>, B<-terse>, B<-linenoise>, B<-debug>, B<-env>
14150 =item Options for tree-specific formatting
14152 B<-compact>, B<-loose>, B<-vt>, B<-ascii>
14154 =item Options controlling sequence numbering
14156 B<-base>I<n>, B<-bigendian>, B<-littleendian>
14158 =item Other options
14160 B<-src>, B<-stash="somepackage">, B<-main>, B<-nomain>, B<-nobanner>,
14161 B<-banner>, B<-banneris> => subref
14163 =item Option Stickiness
14167 =item ABBREVIATIONS
14171 =item OP class abbreviations
14173 =item OP flags abbreviations
14177 =item FORMATTING SPECIFICATIONS
14181 =item Special Patterns
14183 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
14184 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
14189 B<#>I<var>, B<#>I<var>I<N>, B<#>I<Var>, B<#addr>, B<#arg>, B<#class>,
14190 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
14191 B<#flags>, B<#flagval>, B<#hints>, B<#hintsval>, B<#hyphseq>, B<#label>,
14192 B<#lastaddr>, B<#name>, B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>,
14193 B<#private>, B<#privval>, B<#seq>, B<#seqnum>, B<#opt>, B<#sibaddr>,
14194 B<#svaddr>, B<#svclass>, B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>,
14199 =item One-Liner Command tips
14201 perl -MO=Concise,bar foo.pl, perl -MDigest::MD5=md5 -MO=Concise,md5 -e1,
14202 perl -MPOSIX -MO=Concise,_POSIX_ARG_MAX -e1, perl -MPOSIX -MO=Concise,a -e
14203 'print _POSIX_SAVED_IDS', perl -MPOSIX -MO=Concise,a -e 'sub
14204 a{_POSIX_SAVED_IDS}', perl -MB::Concise -e
14205 'B::Concise::compile("-exec","-src", \%B::Concise::)->()'
14207 =item Using B::Concise outside of the O framework
14211 =item Example: Altering Concise Renderings
14215 =item set_style_standard($name)
14219 =item add_callback()
14221 =item Running B::Concise::compile()
14223 =item B::Concise::reset_sequence()
14233 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
14251 =head2 B::Deparse - Perl compiler backend to produce perl code
14261 B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>,
14262 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
14264 =item USING B::Deparse AS A MODULE
14274 =item ambient_pragmas
14276 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits,
14289 =head2 B::Lint - Perl lint
14297 =item OPTIONS AND LINT CHECKS
14299 B<magic-diamond>, B<context>, B<implicit-read> and B<implicit-write>,
14300 B<bare-subs>, B<dollar-underscore>, B<private-names>, B<undefined-subs>,
14301 B<regexp-variables>, B<all>, B<none>
14303 =item NON LINT-CHECK OPTIONS
14307 =item EXTENDING LINT
14311 while(<FH>) stomps $_, strict oo, unchecked system calls, more tests,
14312 validate against older perls
14318 =item ACKNOWLEDGEMENTS
14322 =head2 B::Lint::Debug - Adds debugging stringification to B::
14330 =head2 B::O, O - Generic interface to Perl Compiler backends
14340 =item IMPLEMENTATION
14348 =head2 B::Showlex - Show lexical variables used in functions or files
14372 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
14384 =head2 B::Xref - Generates cross reference reports for Perl programs
14394 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
14402 =head2 Benchmark - benchmark running times of Perl code
14416 =item Standard Exports
14418 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
14419 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
14420 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
14422 =item Optional Exports
14424 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [
14425 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
14426 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
14428 =item :hireswallclock
14444 =item MODIFICATION HISTORY
14448 =head2 CGI - Simple Common Gateway Interface Class
14460 =item PROGRAMMING STYLE
14462 =item CALLING CGI.PM ROUTINES
14464 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
14466 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
14468 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
14470 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
14472 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
14474 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
14476 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
14478 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
14480 =item DELETING A PARAMETER COMPLETELY:
14482 =item DELETING ALL PARAMETERS:
14484 =item HANDLING NON-URLENCODED ARGUMENTS
14486 =item DIRECT ACCESS TO THE PARAMETER LIST:
14488 =item FETCHING THE PARAMETER LIST AS A HASH:
14490 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
14492 =item RETRIEVING CGI ERRORS
14494 =item USING THE FUNCTION-ORIENTED INTERFACE
14496 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
14497 B<:standard>, B<:all>
14501 -any, -compile, -nosticky, -tabindex, -no_undef_params, -no_xhtml, -utf8,
14502 -nph, -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
14505 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
14507 1. start_table() (generates a <table> tag), 2. end_table() (generates a
14508 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
14513 =item GENERATING DYNAMIC DOCUMENTS
14517 =item CREATING A STANDARD HTTP HEADER:
14519 =item GENERATING A REDIRECTION HEADER
14521 =item CREATING THE HTML DOCUMENT HEADER
14523 B<Parameters:>, 4, 5, 6..
14525 =item ENDING THE HTML DOCUMENT:
14527 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
14529 =item OBTAINING THE SCRIPT'S URL
14531 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
14532 (B<-query_string>), B<-base>, B<-rewrite>
14534 =item MIXING POST AND URL PARAMETERS
14538 =item CREATING STANDARD HTML ELEMENTS:
14542 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
14544 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
14546 =item HTML SHORTCUTS AND LIST INTERPOLATION
14548 =item NON-STANDARD HTML SHORTCUTS
14550 =item AUTOESCAPING HTML
14552 $escaped_string = escapeHTML("unescaped string");, $charset =
14553 charset([$charset]);, $flag = autoEscape([$flag]);
14555 =item PRETTY-PRINTING HTML
14559 =item CREATING FILL-OUT FORMS:
14563 =item CREATING AN ISINDEX TAG
14565 =item STARTING AND ENDING A FORM
14567 B<application/x-www-form-urlencoded>, B<multipart/form-data>
14569 =item FORM ELEMENTS
14571 B<-name>, B<-value>, B<-values>, B<-tabindex>, B<-id>, B<-override>,
14572 B<-onChange>, B<-onFocus>, B<-onBlur>, B<-onMouseOver>, B<-onMouseOut>,
14575 =item CREATING A TEXT FIELD
14579 =item CREATING A BIG TEXT FIELD
14581 =item CREATING A PASSWORD FIELD
14583 =item CREATING A FILE UPLOAD FIELD
14587 =item CREATING A POPUP MENU
14589 =item CREATING AN OPTION GROUP
14591 =item CREATING A SCROLLING LIST
14595 =item CREATING A GROUP OF RELATED CHECKBOXES
14599 =item CREATING A STANDALONE CHECKBOX
14603 =item CREATING A RADIO BUTTON GROUP
14607 =item CREATING A SUBMIT BUTTON
14611 =item CREATING A RESET BUTTON
14613 =item CREATING A DEFAULT BUTTON
14615 =item CREATING A HIDDEN FIELD
14619 =item CREATING A CLICKABLE IMAGE BUTTON
14621 B<Parameters:>, 3. The third option (-align, optional) is an alignment
14622 type, and may be TOP, BOTTOM or MIDDLE
14624 =item CREATING A JAVASCRIPT ACTION BUTTON
14630 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
14631 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
14633 =item WORKING WITH FRAMES
14635 1. Create a <Frameset> document, 2. Specify the destination for the
14636 document in the HTTP header, 3. Specify the destination for the document in
14639 =item SUPPORT FOR JAVASCRIPT
14641 B<onLoad>, B<onUnload>, B<onSubmit>, B<onClick>, B<onChange>, B<onFocus>,
14642 B<onBlur>, B<onSelect>, B<onMouseOver>, B<onMouseOut>
14644 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
14650 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
14654 =item FETCHING ENVIRONMENT VARIABLES
14656 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
14657 B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
14658 name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
14659 ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
14660 B<virtual_port ()>, B<server_software ()>, B<remote_user ()>, B<user_name
14661 ()>, B<request_method()>, B<content_type()>, B<http()>, B<https()>
14663 =item USING NPH SCRIPTS
14665 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
14670 multipart_init(), multipart_start(), multipart_end(), multipart_final()
14672 =item Avoiding Denial of Service Attacks
14674 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
14675 basis>, B<2. Globally for all scripts>
14677 =item COMPATIBILITY WITH CGI-LIB.PL
14679 =item AUTHOR INFORMATION
14683 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
14684 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
14685 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
14686 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
14687 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
14688 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
14689 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
14690 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
14691 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
14692 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
14693 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
14694 ...and many many more..
14696 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
14704 =head2 CGI::Apache - Backward compatibility module for CGI.pm
14714 =item AUTHOR INFORMATION
14722 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
14731 =item REDIRECTING ERROR MESSAGES
14733 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
14737 =item Changing the default message
14741 =item DOING MORE THAN PRINTING A MESSAGE IN THE EVENT OF PERL ERRORS
14743 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
14745 =item OVERRIDING THE NAME OF THE PROGRAM
14753 =head2 CGI::Cookie - Interface to Netscape Cookies
14761 =item USING CGI::Cookie
14763 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>, B<4.
14768 =item Creating New Cookies
14770 =item Sending the Cookie to the Browser
14772 =item Recovering Previous Cookies
14774 =item Manipulating Cookies
14776 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
14780 =item AUTHOR INFORMATION
14788 =head2 CGI::Fast - CGI Interface for Fast CGI
14796 =item OTHER PIECES OF THE PUZZLE
14798 =item WRITING FASTCGI PERL SCRIPTS
14800 =item INSTALLING FASTCGI SCRIPTS
14802 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
14804 =item EXTERNAL FASTCGI SERVER INVOCATION
14806 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
14810 =item AUTHOR INFORMATION
14818 =head2 CGI::Pretty - module to produce nicely formatted HTML code
14828 =item Tags that won't be formatted
14830 =item Customizing the Indenting
14842 =head2 CGI::Push - Simple Interface to Server Push
14850 =item USING CGI::Push
14852 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
14856 =item Heterogeneous Pages
14858 =item Changing the Page Delay on the Fly
14862 =item INSTALLING CGI::Push SCRIPTS
14864 =item AUTHOR INFORMATION
14872 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
14882 =item AUTHOR INFORMATION
14890 =head2 CGI::Util - Internal utilities used by CGI module
14898 =item AUTHOR INFORMATION
14904 =head2 CORE - Pseudo-namespace for Perl's core routines
14912 =item OVERRIDING CORE FUNCTIONS
14920 =head2 CPAN - query, download and build perl modules from CPAN sites
14930 =item CPAN::shell([$prompt, $command]) Starting Interactive Mode
14932 Searching for authors, bundles, distribution files and modules, C<get>,
14933 C<make>, C<test>, C<install>, C<clean> modules or distributions, C<readme>,
14934 C<perldoc>, C<look> module or distribution, C<ls> author, C<ls>
14935 globbing_expression, C<failed>, Persistence between sessions, The C<force>
14936 and the C<fforce> pragma, Lockfile, Signals
14946 =item recent ***EXPERIMENTAL COMMAND***
14950 =item report Bundle|Distribution|Module
14952 =item smoke ***EXPERIMENTAL COMMAND***
14954 =item upgrade [Module|/Regex/]...
14956 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
14958 =item Integrating local directories
14964 =item CONFIGURATION
14966 completion support, displaying some help: o conf help, displaying current
14967 values: o conf [KEY], changing of scalar values: o conf KEY VALUE, changing
14968 of list values: o conf KEY SHIFT|UNSHIFT|PUSH|POP|SPLICE|LIST, reverting to
14969 saved: o conf defaults, saving the config: o conf commit
14973 =item Config Variables
14975 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
14976 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
14977 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
14978 [unshift|push|splice] E<lt>listE<gt>>, interactive editing: o conf init
14981 =item CPAN::anycwd($path): Note on config variable getcwd
14983 cwd, getcwd, fastcwd, backtickcwd
14985 =item Note on the format of the urllist parameter
14987 =item The urllist parameter has CD-ROM support
14989 =item Maintaining the urllist parameter
14991 =item The C<requires> and C<build_requires> dependency declarations
14993 =item Configuration for individual distributions (I<Distroprefs>)
14997 =item Fallback Data::Dumper and Storable
15001 =item Language Specs
15003 comment [scalar], cpanconfig [hash], depends [hash] *** EXPERIMENTAL
15004 FEATURE ***, disabled [boolean], features [array] *** EXPERIMENTAL FEATURE
15005 ***, goto [string], install [hash], make [hash], match [hash], patches
15006 [array], pl [hash], test [hash]
15008 =item Processing Instructions
15010 args [array], commandline, eexpect [hash], env [hash], expect [array]
15012 =item Schema verification with C<Kwalify>
15014 =item Example Distroprefs Files
15018 =item PROGRAMMER'S INTERFACE
15020 expand($type,@things), expandany(@things), Programming Examples
15024 =item Methods in the other Classes
15026 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
15027 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
15028 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
15029 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
15030 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
15031 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
15032 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
15033 CPAN::Bundle::readme(), CPAN::Bundle::test(),
15034 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
15035 CPAN::Distribution::author, CPAN::Distribution::pretty_id(),
15036 CPAN::Distribution::base_id(), CPAN::Distribution::clean(),
15037 CPAN::Distribution::containsmods(), CPAN::Distribution::cvs_import(),
15038 CPAN::Distribution::dir(), CPAN::Distribution::force($method,@args),
15039 CPAN::Distribution::get(), CPAN::Distribution::install(),
15040 CPAN::Distribution::install_tested(), CPAN::Distribution::isa_perl(),
15041 CPAN::Distribution::look(), CPAN::Distribution::make(),
15042 CPAN::Distribution::perldoc(), CPAN::Distribution::prefs(),
15043 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
15044 CPAN::Distribution::reports(), CPAN::Distribution::read_yaml(),
15045 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
15046 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
15047 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
15048 CPAN::Module::clean(), CPAN::Module::cpan_file(),
15049 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
15050 CPAN::Module::description(), CPAN::Module::distribution(),
15051 CPAN::Module::dslip_status(), CPAN::Module::force($method,@args),
15052 CPAN::Module::get(), CPAN::Module::inst_file(),
15053 CPAN::Module::available_file(), CPAN::Module::inst_version(),
15054 CPAN::Module::available_version(), CPAN::Module::install(),
15055 CPAN::Module::look(), CPAN::Module::make(),
15056 CPAN::Module::manpage_headline(), CPAN::Module::perldoc(),
15057 CPAN::Module::readme(), CPAN::Module::reports(), CPAN::Module::test(),
15058 CPAN::Module::uptodate(), CPAN::Module::userid()
15060 =item Cache Manager
15066 =item PREREQUISITES
15072 =item Finding packages and VERSION
15076 o debug package.., o debug -package.., o debug all, o debug number
15078 =item Floppy, Zip, Offline Mode
15080 =item Basic Utilities for Programmers
15082 has_inst($module), has_usable($module), instance($module)
15090 =item Cryptographically signed modules
15098 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
15100 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
15104 =item Three basic types of firewalls
15106 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
15108 =item Configuring lynx or ncftp for going through a firewall
15114 1), 2), 3), 4), 5), 6), 7), 8), 9), 10), 11), 12), 13), 14), 15), 16), 17),
15117 =item COMPATIBILITY
15121 =item OLD PERL VERSIONS
15127 =item SECURITY ADVICE
15141 =head2 CPAN::API::HOWTO - a recipe book for programming with CPAN.pm
15149 =item What distribution contains a particular module?
15151 =item What modules does a particular distribution contain?
15163 =head2 CPAN::Distroprefs -- read and match distroprefs
15173 a CPAN::Distroprefs::Result object, C<undef>, indicating that no prefs
15174 files remain to be found
15194 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
15204 auto_commit, build_cache, build_dir, build_dir_reuse,
15205 build_requires_install_policy, cache_metadata, check_sigs, colorize_output,
15206 colorize_print, colorize_warn, colorize_debug, commandnumber_in_prompt,
15207 connect_to_internet_ok, ftp_passive, ftpstats_period, ftpstats_size,
15208 getcwd, halt_on_failure, histfile, histsize, inactivity_timeout,
15209 index_expire, inhibit_startup_message, keep_source_where,
15210 load_module_verbosity, makepl_arg, make_arg, make_install_arg,
15211 make_install_make_command, mbuildpl_arg, mbuild_arg, mbuild_install_arg,
15212 mbuild_install_build_command, pager, prefer_installer, prefs_dir,
15213 prerequisites_policy, randomize_urllist, scan_cache, shell,
15214 show_unparsable_versions, show_upload_date, show_zero_versions,
15215 tar_verbosity, term_is_latin, term_ornaments, test_report,
15216 perl5lib_verbosity, trust_test_report_history, use_sqlite, yaml_load_code,
15225 =head2 CPAN::Kwalify - Interface between CPAN.pm and Kwalify.pm
15233 _validate($schema_name, $data, $file, $doc), yaml($schema_name)
15241 =head2 CPAN::Version - utility functions to compare CPAN versions
15253 =head2 CPANPLUS - API & CLI access to the CPAN mirrors
15259 =item GUIDE TO DOCUMENTATION
15263 =item GENERAL USAGE
15265 =item API REFERENCE
15273 =item COMMANDLINE TOOLS
15277 =item STARTING AN INTERACTIVE SHELL
15279 =item BUILDING PACKAGES
15281 =item $bool = install( Module::Name | /A/AU/AUTHOR/Module-Name-1.tgz )
15283 =item $where = fetch( Module::Name | /A/AU/AUTHOR/Module-Name-1.tgz )
15285 =item $where = get( Module::Name | /A/AU/AUTHOR/Module-Name-1.tgz )
15301 =item CONTACT INFORMATION
15303 Bug reporting: I<bug-cpanplus@rt.cpan.org>, Questions & suggestions:
15304 I<cpanplus-devel@lists.sourceforge.net>
15308 =head2 CPANPLUS::Backend
15322 =item $cb = CPANPLUS::Backend->new( [CONFIGURE_OBJ] )
15324 Provide a valid C<CPANPLUS::Configure> object, No arguments
15332 =item $href = $cb->module_tree( [@modules_names_list] )
15338 =item $href = $cb->author_tree( [@author_names_list] )
15344 =item $conf = $cb->configure_object;
15350 =item $su = $cb->selfupdate_object;
15356 =item @mods = $cb->search( type => TYPE, allow => AREF, [data => AREF,
15363 =item $backend_rv = $cb->fetch( modules => \@mods )
15365 =item $backend_rv = $cb->extract( modules => \@mods )
15367 =item $backend_rv = $cb->install( modules => \@mods )
15369 =item $backend_rv = $cb->readme( modules => \@mods )
15371 =item $backend_rv = $cb->files( modules => \@mods )
15373 =item $backend_rv = $cb->distributions( modules => \@mods )
15379 =item $mod_obj = $cb->parse_module( module =>
15380 $modname|$distname|$modobj|URI )
15382 Text::Bastardize, Text-Bastardize, Text-Bastardize-1.06,
15383 AYRNIEU/Text-Bastardize, AYRNIEU/Text-Bastardize-1.06,
15384 AYRNIEU/Text-Bastardize-1.06.tar.gz,
15385 http://example.com/Text-Bastardize-1.06.tar.gz,
15386 file:///tmp/Text-Bastardize-1.06.tar.gz
15392 =item $bool = $cb->reload_indices( [update_source => BOOL, verbose => BOOL]
15399 =item $bool = $cb->flush(CACHE_NAME)
15401 C<methods>, C<hosts>, C<modules>, C<lib>, C<load>, C<all>
15407 =item @mods = $cb->installed()
15413 =item $bool = $cb->local_mirror([path => '/dir/to/save/to', index_files =>
15414 BOOL, force => BOOL, verbose => BOOL] )
15416 path, index_files, force, verbose
15422 =item $file = $cb->autobundle([path => OUTPUT_PATH, force => BOOL, verbose
15429 =item CUSTOM MODULE SOURCES
15433 =item %files = $cb->list_custom_sources
15441 =item $local_index = $cb->add_custom_source( uri => URI, [verbose => BOOL]
15448 =item $local_index = $cb->remove_custom_source( uri => URI, [verbose =>
15455 =item $bool = $cb->update_custom_source( [remote => URI] );
15461 =item $file = $cb->write_custom_source_index( path =>
15462 /path/to/package/root, [to => /path/to/index/file, verbose => BOOL] );
15478 =head2 CPANPLUS::Backend::RV
15490 =item new( ok => BOOL, args => DATA, rv => DATA, [function => $method_name]
15493 ok, args, rv, function
15509 =head2 CPANPLUS::Config
15515 =item CONFIGURATION
15521 =item Section 'conf'
15607 =head2 CPANPLUS::Configure
15619 =item $Configure = CPANPLUS::Configure->new( load_configs => BOOL )
15627 =item $bool = $Configure->init( [rescan => BOOL])
15633 =item can_save( [$config_location] )
15639 =item $file = $conf->save( [$package_name] )
15645 =item options( type => TYPE )
15655 =item get_SOMETHING( ITEM, [ITEM, ITEM, ... ] );
15657 =item set_SOMETHING( ITEM => VAL, [ITEM => VAL, ITEM => VAL, ... ] );
15659 =item add_SOMETHING( ITEM => VAL, [ITEM => VAL, ITEM => VAL, ... ] );
15661 set|get_conf, set|get_program, _set|_get_build, _set|_get_source,
15662 _set|_get_mirror, _set|_get_fetch
15680 =head2 CPANPLUS::Dist
15692 =item STATUS ACCESSORS
15694 created(), installed(), uninstalled(), dist()
15700 =item $dist = CPANPLUS::Dist->new( module => MODOBJ, [format => DIST_TYPE]
15707 =item @dists = CPANPLUS::Dist->dist_types;
15713 =item prereq_satisfied( modobj => $modobj, version => $version_spec )
15719 =item _resolve_prereqs
15723 =head2 CPANPLUS::Dist::Base - Base class for custom distribution classes
15739 =item $bool = $Class->format_available
15745 =item $bool = $dist->init
15751 =item $bool = $dist->prepare
15757 =item $bool = $dist->create
15763 =item $bool = $dist->install
15769 =item $bool = $dist->uninstall
15773 =head2 CPANPLUS::Dist::Build
15785 =item STATUS ACCESSORS
15787 build_pl (), build (), test (), prepared (), distdir (), created (),
15788 installed (), uninstalled (), _create_args (), _install_args (), _mb_object
15799 =item $bool = CPANPLUS::Dist::Build->format_available();
15807 =item $bool = $dist->init();
15813 =item $bool = $dist->prepare([perl => '/path/to/perl', buildflags =>
15814 'EXTRA=FLAGS', force => BOOL, verbose => BOOL])
15820 =item $dist->create([perl => '/path/to/perl', buildflags => 'EXTRA=FLAGS',
15821 prereq_target => TARGET, force => BOOL, verbose => BOOL, skiptest => BOOL])
15827 =item $dist->install([verbose => BOOL, perl => /path/to/perl])
15835 Module::Build can not be upgraded using its own API (#13169), Module::Build
15836 does not provide access to install history (#9793)
15844 =head2 CPANPLUS::Dist::MM
15854 =item STATUS ACCESSORS
15856 makefile (), make (), test (), prepared (), distdir (), created (),
15857 installed (), uninstalled (), _create_args (), _install_args ()
15867 =item $bool = $dist->format_available();
15875 =item $href = $dist->_find_prereqs( file => '/path/to/Makefile', [verbose
15882 =item $bool = $dist->create([perl => '/path/to/perl', make =>
15883 '/path/to/make', makeflags => 'EXTRA=FLAGS', prereq_target => TARGET,
15884 skiptest => BOOL, force => BOOL, verbose => BOOL])
15890 =item $bool = $dist->install([make => '/path/to/make', makemakerflags =>
15891 'EXTRA=FLAGS', force => BOOL, verbose => BOOL])
15897 =item $bool = $dist->write_makefile_pl([force => BOOL, verbose => BOOL])
15901 =head2 CPANPLUS::Dist::Sample -- Sample code to create your own Dist::*
15910 =head2 CPANPLUS::Error
15922 =item cp_msg("message string" [,VERBOSE])
15926 =item cp_error("error string" [,VERBOSE])
15932 =item CLASS METHODS
15936 =item CPANPLUS::Error->stack()
15938 =item CPANPLUS::Error->stack_as_string([TRACE])
15940 =item CPANPLUS::Error->flush()
15948 =item GLOBAL VARIABLES
15954 =head2 CPANPLUS::FAQ
15968 =head2 CPANPLUS::Hacking
15974 =item OBTAINING CPANPLUS
15976 =item INSTALLING CPANPLUS
15978 =item CONFIGURING CPANPLUS
15980 =item RUNNING CPANPLUS FROM DEVELOPMENT ENVIRONMENT
15982 =item RUNNING CPANPLUS TESTS
15986 Problem description, Program demonstrating the bug, [OPTIONAL] A patch to
15987 the test suite to test for the bug, [OPTIONAL] A patch to the code + tests
15990 =item SUPPLYING PATCHES
15992 In C<diff -u> or C<diff -c> format, From the root of the snapshot,
15993 Including patches for code + tests + docs, Sent per mail to
15994 cpanplus-devel@lists.sourceforge.net, With subject containing C<[PATCH]> +
15995 description of the patch
15999 =head2 CPANPLUS::Internals
16009 _conf, _id, _lib, _perl5lib
16019 =item $internals = CPANPLUS::Internals->_init( _conf => CONFIG_OBJ )
16027 =item $bool = $internals->_flush( list => \@caches )
16033 =item $bool = $internals->_register_callback( name => CALLBACK_NAME, code
16036 install_prerequisite, send_test_report, munge_test_report,
16037 edit_test_report, proceed_on_test_failure, munge_dist_metafile
16043 =item $bool = $internals->_add_to_includepath( directories => \@dirs )
16049 =item $id = CPANPLUS::Internals->_last_id
16051 =item $id = CPANPLUS::Internals->_store_id( $internals )
16053 =item $obj = CPANPLUS::Internals->_retrieve_id( $ID )
16055 =item CPANPLUS::Internals->_remove_id( $ID )
16057 =item @objs = CPANPLUS::Internals->_return_all_objects
16061 =head2 CPANPLUS::Internals::Extract
16071 =item $dir = _extract( module => $modobj, [perl => '/path/to/perl',
16072 extractdir => '/path/to/extract/to', prefer_bin => BOOL, verbose => BOOL,
16075 module, extractdir, prefer_bin, perl, verbose, force
16081 =head2 CPANPLUS::Internals::Fetch
16095 =item $path = _fetch( module => $modobj, [fetchdir => '/path/to/save/to',
16096 fetch_from => 'scheme://path/to/fetch/from', verbose => BOOL, force =>
16097 BOOL, prefer_bin => BOOL] )
16103 =item _add_fail_host( host => $host_hashref )
16105 =item _host_ok( host => $host_hashref )
16109 =head2 CPANPLUS::Internals::Report
16121 =item $bool = $cb->_have_query_report_modules
16123 =item $bool = $cb->_have_send_report_modules
16131 =item @list = $cb->_query_report( module => $modobj, [all_versions => BOOL,
16138 =item $bool = $cb->_send_report( module => $modobj, buffer => $make_output,
16139 failed => BOOL, [save => BOOL, address => $email_to, dontcc => BOOL,
16140 verbose => BOOL, force => BOOL]);
16142 module, buffer, failed, save, address, dontcc, verbose, force
16146 =head2 CPANPLUS::Internals::Search
16158 =item _search_module_tree( type => TYPE, allow => \@regexex, [data =>
16159 \@previous_results ] )
16169 =item _search_author_tree( type => TYPE, allow => \@regexex, [data =>
16170 \@previous_results ] )
16178 =item _all_installed()
16182 =head2 CPANPLUS::Internals::Source
16196 =item $cb->_check_trees( [update_source => BOOL, path => PATH, verbose =>
16199 update_source, path, verbose
16205 =item $cb->__check_uptodate( file => $file, name => $name, [update_source
16206 => BOOL, verbose => BOOL] )
16208 file, name, update_source, verbose
16214 =item $cb->_update_source( name => $name, [path => $path, verbose => BOOL]
16217 name, path, verbose
16223 =item $cb->_build_trees( uptodate => BOOL, [use_stored => BOOL, path =>
16224 $path, verbose => BOOL] )
16226 uptodate, path, verbose, use_stored
16232 =item $cb->__retrieve_source(name => $name, [path => $path, uptodate =>
16233 BOOL, verbose => BOOL])
16235 name, uptodate, path, verbose
16241 =item $cb->_save_source([verbose => BOOL, path => $path])
16249 =item $cb->__create_author_tree([path => $path, uptodate => BOOL, verbose
16252 uptodate, path, verbose
16258 =item $cb->_create_mod_tree([path => $path, uptodate => BOOL, verbose =>
16261 uptodate, path, verbose
16267 =item $cb->__create_dslip_tree([path => $path, uptodate => BOOL, verbose =>
16270 uptodate, path, verbose
16276 =item $cb->_dslip_defs ()
16282 =item $file = $cb->_add_custom_module_source( uri => URI, [verbose => BOOL]
16289 =item $index = $cb->__custom_module_source_index_file( uri => $uri );
16295 =item $file = $cb->_remove_custom_module_source( uri => URI, [verbose =>
16302 =item %files = $cb->__list_custom_module_sources
16308 =item $bool = $cb->__update_custom_module_sources( [verbose => BOOL] );
16314 =item $ok = $cb->__update_custom_module_source
16320 =item $bool = $cb->__write_custom_module_index( path => /path/to/packages,
16321 [to => /path/to/index/file, verbose => BOOL] )
16327 =item $bool = $cb->__create_custom_module_entries( [verbose => BOOL] )
16331 =head2 CPANPLUS::Internals::Utils
16343 =item $cb->_mkdir( dir => '/some/dir' )
16351 =item $cb->_chdir( dir => '/some/dir' )
16357 =item $cb->_rmdir( dir => '/some/dir' );
16363 =item $cb->_perl_version ( perl => 'some/perl/binary' );
16369 =item $cb->_version_to_number( version => $version );
16381 =item _get_file_contents( file => $file );
16387 =item $cb->_mode_plus_w( file => '/path/to/file' );
16393 =item $uri = $cb->_host_to_uri( scheme => SCHEME, host => HOST, path =>
16400 =item $cb->_vcmp( VERSION, VERSION );
16406 =item $cb->_home_dir
16412 =item $path = $cb->_safe_path( path => $path );
16418 =item ($pkg, $version, $ext) = $cb->_split_package_string( package =>
16423 =head2 CPANPLUS::Module
16435 =item CLASS METHODS
16449 name, module, version, path, comment, package, description, dslip
16453 status, author, parent
16457 =item STATUS ACCESSORS
16459 installer_type, dist_cpan, dist, prereqs, signature, extract, fetch,
16460 readme, uninstall, created, installed, checksums, checksum_ok,
16467 =item $self = CPANPLUS::Module::new( OPTIONS )
16475 =item $mod->package_name
16477 =item $mod->package_version
16479 =item $mod->package_extension
16481 =item $mod->package_is_perl_core
16483 =item $mod->module_is_supplied_with_perl_core( [version => $]] )
16485 =item $mod->is_bundle
16487 =item $mod->is_third_party
16489 =item $mod->third_party_information
16495 =item $clone = $self->clone
16501 =item $where = $self->fetch
16507 =item $path = $self->extract
16513 =item $type = $self->get_installer_type([prefer_makefile => BOOL])
16519 =item $dist = $self->dist([target => 'prepare|create', format =>
16520 DISTRIBUTION_TYPE, args => {key => val}]);
16526 =item $bool = $mod->prepare( )
16528 Convenience method around C<install()> that prepares a module
16529 without actually building it. This is equivalent to invoking C<install>
16530 with C<target> set to C<prepare>
16536 =item $bool = $mod->create( )
16542 =item $bool = $mod->test( )
16548 =item $bool = $self->install([ target => 'prepare|create|install', format
16549 => FORMAT_TYPE, extractdir => DIRECTORY, fetchdir => DIRECTORY, prefer_bin
16550 => BOOL, force => BOOL, verbose => BOOL, ..... ]);
16556 =item $text = $self->readme
16562 =item $version = $self->installed_version()
16564 =item $where = $self->installed_file()
16566 =item $bool = $self->is_uptodate([version => VERSION_NUMBER])
16572 =item $href = $self->details()
16578 =item @list = $self->contains()
16584 =item @list_of_hrefs = $self->fetch_report()
16590 =item $bool = $self->uninstall([type => [all|man|prog])
16596 =item @modobj = $self->distributions()
16602 =item @list = $self->files ()
16608 =item @list = $self->directory_tree ()
16614 =item @list = $self->packlist ()
16620 =item @list = $self->validate ()
16626 =item $bool = $self->add_to_includepath;
16628 =item $path = $self->best_path_to_module_build();
16642 =head2 CPANPLUS::Module::Author
16652 author, cpanid, email, parent
16662 =item $auth = CPANPLUS::Module::Author->new( author => AUTHOR_NAME, cpanid
16663 => CPAN_ID, _id => INTERNALS_ID [, email => AUTHOR_EMAIL] )
16671 =item @mod_objs = $auth->modules()
16677 =item @dists = $auth->distributions()
16683 =item CLASS METHODS
16693 =head2 CPANPLUS::Module::Author::Fake
16705 =item new( _id => DIGIT )
16711 =head2 CPANPLUS::Module::Checksums
16723 =item $mod->checksums
16729 =head2 CPANPLUS::Module::Fake
16741 =item new( module => $mod, path => $path, package => $pkg, [_id => DIGIT] )
16747 =head2 CPANPLUS::inc
16755 =head2 CPANPLUS::inc - runtime inclusion of privately bundled modules
16763 Put a coderef at the beginning of C<@INC>, Add the full path to the
16764 C<CPANPLUS/inc> directory to C<$ENV{PERL5LIB>
16770 =item CPANPLUS::inc->inc_path()
16772 =item CPANPLUS::inc->my_path()
16774 =item CPANPLUS::inc->installer_path()
16782 =item CPANPLUS::inc->original_perl5lib
16784 =item CPANPLUS::inc->original_perl5opt
16786 =item CPANPLUS::inc->original_inc
16788 =item CPANPLUS::inc->limited_perl5opt(@modules);
16794 =item CPANPLUS::inc->interesting_modules()
16800 =item INTERESTING MODULES
16802 Loop over your @INC, Check the version on every suitable module found in
16813 On multiple C<use lib> calls, our coderef may not be the first in @INC,
16814 Non-directories in @INC
16818 =head2 CPANPLUSelfupdate, CPANPLUS::Selfupdate
16832 =item $self = CPANPLUS::Selfupdate->new( $backend_object );
16840 =item %list = $self->list_modules_to_update( update =>
16841 "core|dependencies|enabled_features|features|all", [latest => BOOL] )
16843 List which modules C<selfupdate> would upgrade. You can update either
16844 the core (CPANPLUS itself), the core dependencies, all features you have
16845 currently turned on, or all features available, or everything.
16851 =item @features = $self->list_features
16857 =item @features = $self->list_enabled_features
16863 =item @mods = $self->modules_for_feature( FEATURE [,AS_HASH] )
16869 =item @mods = $self->list_core_dependencies( [AS_HASH] )
16875 =item @mods = $self->list_core_modules( [AS_HASH] )
16881 =item CPANPLUS::Selfupdate::Module
16887 =item $version = $mod->version_required
16893 =item $bool = $mod->is_installed_version_sufficient
16907 =head2 CPANPLUShell, CPANPLUS::Shell
16929 =head2 CPANPLUShell::Classic, CPANPLUS::Shell::Classic - CPAN.pm emulation
16952 =head2 CPANPLUShell::Default, CPANPLUS::Shell::Default
16974 =head2 CPANPLUShell::Default::Plugins::CustomSource,
16975 CPANPLUS::Shell::Default::Plugins::CustomSource
16981 ### elaborate help text
16982 CPAN Terminal> /? cs
16988 =head2 CPANPLUShell::Default::Plugins::HOWTO,
16989 CPANPLUS::Shell::Default::Plugins::HOWTO -- documentation on how to write
17000 =item Registering Plugin Modules
17002 =item Registering Plugin Commands
17004 =item Registering Plugin Help
17006 =item Arguments to Plugin Commands
17008 Classname -- The name of your plugin class, Shell -- The
17009 CPANPLUS::Shell::Default object, Backend -- The CPANPLUS::Backend object,
17010 Command -- The command issued by the user, Input -- The input string
17011 from the user, Options -- A hashref of options provided by the user
17025 =head2 CPANPLUShell::Default::Plugins::Remote,
17026 CPANPLUS::Shell::Default::Plugins::Remote
17048 =head2 CPANPLUShell::Default::Plugins::Source,
17049 CPANPLUS::Shell::Default::Plugins::Source
17071 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
17086 =head2 Carp, carp - warn of errors (from perspective of caller)
17096 =item Forcing a Stack Trace
17100 =item GLOBAL VARIABLES
17104 =item $Carp::MaxEvalLen
17106 =item $Carp::MaxArgLen
17108 =item $Carp::MaxArgNums
17110 =item $Carp::Verbose
17112 =item %Carp::Internal
17114 =item %Carp::CarpInternal
17116 =item $Carp::CarpLevel
17124 =head2 Carp::Heavy - heavy machinery, no user serviceable parts inside
17126 =head2 Class::ISA -- report the search path for a class's ISA tree
17136 the function Class::ISA::super_path($CLASS), the function
17137 Class::ISA::self_and_super_path($CLASS), the function
17138 Class::ISA::self_and_super_versions($CLASS)
17140 =item CAUTIONARY NOTES
17148 =head2 Class::Struct - declare struct-like datatypes as Perl classes
17158 =item The C<struct()> function
17160 =item Class Creation at Compile Time
17162 =item Element Types and Accessor Methods
17164 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
17165 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
17167 =item Initializing with C<new>
17173 Example 1, Example 2, Example 3
17175 =item Author and Modification History
17179 =head2 Compress::Raw::Zlib - Low-Level Interface to zlib compression
17188 =item Compress::Raw::Zlib::Deflate
17192 =item B<($d, $status) = new Compress::Raw::Zlib::Deflate( [OPT] ) >
17194 B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>,
17195 B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32>
17197 =item B<$status = $d-E<gt>deflate($input, $output)>
17199 =item B<$status = $d-E<gt>flush($output [, $flush_type]) >
17201 =item B<$status = $d-E<gt>deflateParams([OPT])>
17203 B<-Level>, B<-Strategy>, B<-BufSize>
17205 =item B<$status = $d-E<gt>deflateTune($good_length, $max_lazy,
17206 $nice_length, $max_chain)>
17208 =item B<$d-E<gt>dict_adler()>
17210 =item B<$d-E<gt>crc32()>
17212 =item B<$d-E<gt>adler32()>
17214 =item B<$d-E<gt>msg()>
17216 =item B<$d-E<gt>total_in()>
17218 =item B<$d-E<gt>total_out()>
17220 =item B<$d-E<gt>get_Strategy()>
17222 =item B<$d-E<gt>get_Level()>
17224 =item B<$d-E<gt>get_BufSize()>
17230 =item Compress::Raw::Zlib::Inflate
17234 =item B< ($i, $status) = new Compress::Raw::Zlib::Inflate( [OPT] ) >
17236 B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>,
17237 B<-ADLER32>, B<-ConsumeInput>
17239 =item B< $status = $i-E<gt>inflate($input, $output [,$eof]) >
17241 =item B<$status = $i-E<gt>inflateSync($input)>
17243 =item B<$i-E<gt>dict_adler()>
17245 =item B<$i-E<gt>crc32()>
17247 =item B<$i-E<gt>adler32()>
17249 =item B<$i-E<gt>msg()>
17251 =item B<$i-E<gt>total_in()>
17253 =item B<$i-E<gt>total_out()>
17255 =item B<$d-E<gt>get_BufSize()>
17261 =item CHECKSUM FUNCTIONS
17263 =item ACCESSING ZIP FILES
17271 =item MODIFICATION HISTORY
17273 =item COPYRIGHT AND LICENSE
17277 =head2 Compress::Raw::Zlib::Compress::Raw::Zlib, Compress::Raw::Zlib -
17278 Low-Level Interface to zlib compression library
17286 =item Compress::Raw::Zlib::Deflate
17290 =item B<($d, $status) = new Compress::Raw::Zlib::Deflate( [OPT] ) >
17292 B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>,
17293 B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32>
17295 =item B<$status = $d-E<gt>deflate($input, $output)>
17297 =item B<$status = $d-E<gt>flush($output [, $flush_type]) >
17299 =item B<$status = $d-E<gt>deflateParams([OPT])>
17301 B<-Level>, B<-Strategy>, B<-BufSize>
17303 =item B<$status = $d-E<gt>deflateTune($good_length, $max_lazy,
17304 $nice_length, $max_chain)>
17306 =item B<$d-E<gt>dict_adler()>
17308 =item B<$d-E<gt>crc32()>
17310 =item B<$d-E<gt>adler32()>
17312 =item B<$d-E<gt>msg()>
17314 =item B<$d-E<gt>total_in()>
17316 =item B<$d-E<gt>total_out()>
17318 =item B<$d-E<gt>get_Strategy()>
17320 =item B<$d-E<gt>get_Level()>
17322 =item B<$d-E<gt>get_BufSize()>
17328 =item Compress::Raw::Zlib::Inflate
17332 =item B< ($i, $status) = new Compress::Raw::Zlib::Inflate( [OPT] ) >
17334 B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>,
17335 B<-ADLER32>, B<-ConsumeInput>
17337 =item B< $status = $i-E<gt>inflate($input, $output [,$eof]) >
17339 =item B<$status = $i-E<gt>inflateSync($input)>
17341 =item B<$i-E<gt>dict_adler()>
17343 =item B<$i-E<gt>crc32()>
17345 =item B<$i-E<gt>adler32()>
17347 =item B<$i-E<gt>msg()>
17349 =item B<$i-E<gt>total_in()>
17351 =item B<$i-E<gt>total_out()>
17353 =item B<$d-E<gt>get_BufSize()>
17359 =item CHECKSUM FUNCTIONS
17361 =item ACCESSING ZIP FILES
17369 =item MODIFICATION HISTORY
17371 =item COPYRIGHT AND LICENSE
17375 =head2 Compress::Raw::Zlib::pod::FAQ, Compress::Raw::Zlib::FAQ --
17376 Frequently Asked Questions about Compress::Raw::Zlib
17384 =item Compatibility with Unix compress/uncompress.
17386 =item Accessing .tar.Z files
17388 =item Accessing Zip Files
17390 =item Zlib Library Version Support
17398 =item MODIFICATION HISTORY
17400 =item COPYRIGHT AND LICENSE
17404 =head2 Compress::Zlib - Interface to zlib compression library
17414 =item Notes for users of Compress::Zlib version 1
17418 =item GZIP INTERFACE
17420 B<$gz = gzopen($filename, $mode)>, B<$gz = gzopen($filehandle, $mode)>,
17421 B<$bytesread = $gz-E<gt>gzread($buffer [, $size]) ;>, B<$bytesread =
17422 $gz-E<gt>gzreadline($line) ;>, B<$byteswritten = $gz-E<gt>gzwrite($buffer)
17423 ;>, B<$status = $gz-E<gt>gzflush($flush_type) ;>, B<$offset =
17424 $gz-E<gt>gztell() ;>, B<$status = $gz-E<gt>gzseek($offset, $whence) ;>,
17425 B<$gz-E<gt>gzclose>, B<$gz-E<gt>gzsetparams($level, $strategy>, B<$level>,
17426 B<$strategy>, B<$gz-E<gt>gzerror>, B<$gzerrno>
17432 =item Compress::Zlib::memGzip
17434 =item Compress::Zlib::memGunzip
17438 =item COMPRESS/UNCOMPRESS
17440 B<$dest = compress($source [, $level] ) ;>, B<$dest = uncompress($source)
17443 =item Deflate Interface
17447 =item B<($d, $status) = deflateInit( [OPT] )>
17449 B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>,
17450 B<-Dictionary>, B<-Bufsize>
17452 =item B<($out, $status) = $d-E<gt>deflate($buffer)>
17454 =item B<($out, $status) = $d-E<gt>flush()>
17455 =head2 B<($out, $status) = $d-E<gt>flush($flush_type)>
17457 =item B<$status = $d-E<gt>deflateParams([OPT])>
17459 B<-Level>, B<-Strategy>
17461 =item B<$d-E<gt>dict_adler()>
17463 =item B<$d-E<gt>msg()>
17465 =item B<$d-E<gt>total_in()>
17467 =item B<$d-E<gt>total_out()>
17473 =item Inflate Interface
17477 =item B<($i, $status) = inflateInit()>
17479 B<-WindowBits>, B<-Bufsize>, B<-Dictionary>
17481 =item B<($out, $status) = $i-E<gt>inflate($buffer)>
17483 =item B<$status = $i-E<gt>inflateSync($buffer)>
17485 =item B<$i-E<gt>dict_adler()>
17487 =item B<$i-E<gt>msg()>
17489 =item B<$i-E<gt>total_in()>
17491 =item B<$i-E<gt>total_out()>
17497 =item CHECKSUM FUNCTIONS
17505 =item MODIFICATION HISTORY
17507 =item COPYRIGHT AND LICENSE
17511 =head2 Compress::Zlib::Compress::Zlib, Compress::Zlib - Interface to zlib
17512 compression library
17522 =item Notes for users of Compress::Zlib version 1
17526 =item GZIP INTERFACE
17528 B<$gz = gzopen($filename, $mode)>, B<$gz = gzopen($filehandle, $mode)>,
17529 B<$bytesread = $gz-E<gt>gzread($buffer [, $size]) ;>, B<$bytesread =
17530 $gz-E<gt>gzreadline($line) ;>, B<$byteswritten = $gz-E<gt>gzwrite($buffer)
17531 ;>, B<$status = $gz-E<gt>gzflush($flush_type) ;>, B<$offset =
17532 $gz-E<gt>gztell() ;>, B<$status = $gz-E<gt>gzseek($offset, $whence) ;>,
17533 B<$gz-E<gt>gzclose>, B<$gz-E<gt>gzsetparams($level, $strategy>, B<$level>,
17534 B<$strategy>, B<$gz-E<gt>gzerror>, B<$gzerrno>
17540 =item Compress::Zlib::memGzip
17542 =item Compress::Zlib::memGunzip
17546 =item COMPRESS/UNCOMPRESS
17548 B<$dest = compress($source [, $level] ) ;>, B<$dest = uncompress($source)
17551 =item Deflate Interface
17555 =item B<($d, $status) = deflateInit( [OPT] )>
17557 B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>,
17558 B<-Dictionary>, B<-Bufsize>
17560 =item B<($out, $status) = $d-E<gt>deflate($buffer)>
17562 =item B<($out, $status) = $d-E<gt>flush()>
17563 =head2 B<($out, $status) = $d-E<gt>flush($flush_type)>
17565 =item B<$status = $d-E<gt>deflateParams([OPT])>
17567 B<-Level>, B<-Strategy>
17569 =item B<$d-E<gt>dict_adler()>
17571 =item B<$d-E<gt>msg()>
17573 =item B<$d-E<gt>total_in()>
17575 =item B<$d-E<gt>total_out()>
17581 =item Inflate Interface
17585 =item B<($i, $status) = inflateInit()>
17587 B<-WindowBits>, B<-Bufsize>, B<-Dictionary>
17589 =item B<($out, $status) = $i-E<gt>inflate($buffer)>
17591 =item B<$status = $i-E<gt>inflateSync($buffer)>
17593 =item B<$i-E<gt>dict_adler()>
17595 =item B<$i-E<gt>msg()>
17597 =item B<$i-E<gt>total_in()>
17599 =item B<$i-E<gt>total_out()>
17605 =item CHECKSUM FUNCTIONS
17613 =item MODIFICATION HISTORY
17615 =item COPYRIGHT AND LICENSE
17619 =head2 Compress::Zlib::pod::FAQ, Compress::Zlib::FAQ -- Frequently Asked
17620 Questions about Compress::Zlib
17628 =item Compatibility with Unix compress/uncompress.
17630 =item Accessing .tar.Z files
17632 =item Accessing Zip Files
17640 =item MODIFICATION HISTORY
17642 =item COPYRIGHT AND LICENSE
17646 =head2 Config - access Perl configuration information
17654 myconfig(), config_sh(), config_re($regex), config_vars(@names)
17670 C<_a>, C<_exe>, C<_o>
17678 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
17679 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
17680 C<ar>, C<archlib>, C<archlibexp>, C<archname>, C<archname64>, C<archobjs>,
17681 C<asctime_r_proto>, C<awk>
17689 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
17697 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
17698 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
17699 C<cf_email>, C<cf_time>, C<chgrp>, C<chmod>, C<chown>, C<clocktype>,
17700 C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>, C<cpp_stuff>,
17701 C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>, C<cpprun>,
17702 C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>, C<csh>,
17703 C<ctermid_r_proto>, C<ctime_r_proto>
17711 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>,
17712 C<d_archlib>, C<d_asctime64>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>,
17713 C<d_attribute_deprecated>, C<d_attribute_format>, C<d_attribute_malloc>,
17714 C<d_attribute_nonnull>, C<d_attribute_noreturn>, C<d_attribute_pure>,
17715 C<d_attribute_unused>, C<d_attribute_warn_unused_result>, C<d_bcmp>,
17716 C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>,
17717 C<d_builtin_choose_expr>, C<d_builtin_expect>, C<d_bzero>,
17718 C<d_c99_variadic_macros>, C<d_casti32>, C<d_castneg>, C<d_charvspr>,
17719 C<d_chown>, C<d_chroot>, C<d_chsize>, C<d_class>, C<d_clearenv>,
17720 C<d_closedir>, C<d_cmsghdr_s>, C<d_const>, C<d_copysignl>, C<d_cplusplus>,
17721 C<d_crypt>, C<d_crypt_r>, C<d_csh>, C<d_ctermid>, C<d_ctermid_r>,
17722 C<d_ctime64>, C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>,
17723 C<d_difftime>, C<d_difftime64>, C<d_dir_dd_fd>, C<d_dirfd>, C<d_dirnamlen>,
17724 C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, C<d_drand48_r>,
17725 C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endgrent_r>,
17726 C<d_endhent>, C<d_endhostent_r>, C<d_endnent>, C<d_endnetent_r>,
17727 C<d_endpent>, C<d_endprotoent_r>, C<d_endpwent>, C<d_endpwent_r>,
17728 C<d_endsent>, C<d_endservent_r>, C<d_eofnblk>, C<d_eunice>, C<d_faststdio>,
17729 C<d_fchdir>, C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>,
17730 C<d_fd_macros>, C<d_fd_set>, C<d_fds_bits>, C<d_fgetpos>, C<d_finite>,
17731 C<d_finitel>, C<d_flexfnam>, C<d_flock>, C<d_flockproto>, C<d_fork>,
17732 C<d_fp_class>, C<d_fpathconf>, C<d_fpclass>, C<d_fpclassify>,
17733 C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>,
17734 C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>,
17735 C<d_ftime>, C<d_futimes>, C<d_Gconvert>, C<d_gdbm_ndbm_h_uses_prototypes>,
17736 C<d_gdbmndbm_h_uses_prototypes>, C<d_getcwd>, C<d_getespwnam>,
17737 C<d_getfsstat>, C<d_getgrent>, C<d_getgrent_r>, C<d_getgrgid_r>,
17738 C<d_getgrnam_r>, C<d_getgrps>, C<d_gethbyaddr>, C<d_gethbyname>,
17739 C<d_gethent>, C<d_gethname>, C<d_gethostbyaddr_r>, C<d_gethostbyname_r>,
17740 C<d_gethostent_r>, C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>,
17741 C<d_getlogin_r>, C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>,
17742 C<d_getnbyname>, C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>,
17743 C<d_getnetent_r>, C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>,
17744 C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp>, C<d_getpgrp2>,
17745 C<d_getppid>, C<d_getprior>, C<d_getprotobyname_r>,
17746 C<d_getprotobynumber_r>, C<d_getprotoent_r>, C<d_getprotoprotos>,
17747 C<d_getprpwnam>, C<d_getpwent>, C<d_getpwent_r>, C<d_getpwnam_r>,
17748 C<d_getpwuid_r>, C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>,
17749 C<d_getservbyname_r>, C<d_getservbyport_r>, C<d_getservent_r>,
17750 C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, C<d_gettimeod>,
17751 C<d_gmtime64>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
17752 C<d_htonl>, C<d_ilogbl>, C<d_inc_version_list>, C<d_index>, C<d_inetaton>,
17753 C<d_int64_t>, C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>,
17754 C<d_isnanl>, C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>,
17755 C<d_libm_lib_version>, C<d_link>, C<d_localtime64>, C<d_localtime_r>,
17756 C<d_localtime_r_needs_tzset>, C<d_locconv>, C<d_lockf>, C<d_longdbl>,
17757 C<d_longlong>, C<d_lseekproto>, C<d_lstat>, C<d_madvise>,
17758 C<d_malloc_good_size>, C<d_malloc_size>, C<d_mblen>, C<d_mbstowcs>,
17759 C<d_mbtowc>, C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>,
17760 C<d_memset>, C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>,
17761 C<d_mkstemps>, C<d_mktime>, C<d_mktime64>, C<d_mmap>, C<d_modfl>,
17762 C<d_modfl_pow32_bug>, C<d_modflproto>, C<d_mprotect>, C<d_msg>,
17763 C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>,
17764 C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>,
17765 C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_ndbm>,
17766 C<d_ndbm_h_uses_prototypes>, C<d_nice>, C<d_nl_langinfo>,
17767 C<d_nv_preserves_uv>, C<d_nv_zero_is_allbits_zero>, C<d_off64_t>,
17768 C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
17769 C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
17770 C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
17771 C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
17772 C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_printf_format_null>,
17773 C<d_PRIo64>, C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>,
17774 C<d_pseudofork>, C<d_pthread_atfork>, C<d_pthread_attr_setscope>,
17775 C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>, C<d_pwclass>,
17776 C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>,
17777 C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir>, C<d_readdir64_r>,
17778 C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>, C<d_rename>,
17779 C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>,
17780 C<d_sbrkproto>, C<d_scalbnl>, C<d_sched_yield>, C<d_scm_rights>,
17781 C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>,
17782 C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>, C<d_semop>,
17783 C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>,
17784 C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>, C<d_setitimer>,
17785 C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>, C<d_setnent>,
17786 C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp>, C<d_setpgrp2>,
17787 C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>,
17788 C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>,
17789 C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setservent_r>,
17790 C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>,
17791 C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>,
17792 C<d_signbit>, C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sitearch>,
17793 C<d_snprintf>, C<d_sockatmark>, C<d_sockatmarkproto>, C<d_socket>,
17794 C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>,
17795 C<d_sprintf_returns_strlen>, C<d_sqrtl>, C<d_srand48_r>, C<d_srandom_r>,
17796 C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>,
17797 C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
17798 C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>,
17799 C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>,
17800 C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strerror_r>,
17801 C<d_strftime>, C<d_strlcat>, C<d_strlcpy>, C<d_strtod>, C<d_strtol>,
17802 C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>,
17803 C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>,
17804 C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
17805 C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
17806 C<d_telldirproto>, C<d_time>, C<d_timegm>, C<d_times>, C<d_tm_tm_gmtoff>,
17807 C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>,
17808 C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
17809 C<d_unordered>, C<d_unsetenv>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>,
17810 C<d_vendorarch>, C<d_vendorbin>, C<d_vendorlib>, C<d_vendorscript>,
17811 C<d_vfork>, C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>, C<d_volatile>,
17812 C<d_vprintf>, C<d_vsnprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>,
17813 C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>,
17814 C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
17815 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
17816 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dtrace>, C<dynamic_ext>
17824 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
17825 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
17826 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
17827 C<expr>, C<extensions>, C<extern_C>, C<extras>
17835 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
17836 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
17845 C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>,
17846 C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>,
17847 C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>,
17848 C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>,
17849 C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>,
17850 C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>,
17851 C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>,
17852 C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>,
17853 C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>,
17854 C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
17862 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>,
17863 C<html3dir>, C<html3direxp>
17871 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
17872 C<i8size>, C<i8type>, C<i_arpainet>, C<i_assert>, C<i_bsdioctl>,
17873 C<i_crypt>, C<i_db>, C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>,
17874 C<i_fcntl>, C<i_float>, C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_gdbm_ndbm>,
17875 C<i_gdbmndbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>, C<i_langinfo>,
17876 C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>, C<i_malloc>,
17877 C<i_mallocmalloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>,
17878 C<i_netdb>, C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>,
17879 C<i_prot>, C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>,
17880 C<i_shadow>, C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>,
17881 C<i_string>, C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>,
17882 C<i_sysfilio>, C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>,
17883 C<i_sysmode>, C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_syspoll>,
17884 C<i_sysresrc>, C<i_syssecrt>, C<i_sysselct>, C<i_syssockio>, C<i_sysstat>,
17885 C<i_sysstatfs>, C<i_sysstatvfs>, C<i_systime>, C<i_systimek>,
17886 C<i_systimes>, C<i_systypes>, C<i_sysuio>, C<i_sysun>, C<i_sysutsname>,
17887 C<i_sysvfs>, C<i_syswait>, C<i_termio>, C<i_termios>, C<i_time>,
17888 C<i_unistd>, C<i_ustat>, C<i_utime>, C<i_values>, C<i_varargs>,
17889 C<i_varhdr>, C<i_vfork>, C<ignore_versioned_solibs>, C<inc_version_list>,
17890 C<inc_version_list_init>, C<incpath>, C<inews>, C<initialinstalllocation>,
17891 C<installarchlib>, C<installbin>, C<installhtml1dir>, C<installhtml3dir>,
17892 C<installman1dir>, C<installman3dir>, C<installprefix>,
17893 C<installprefixexp>, C<installprivlib>, C<installscript>,
17894 C<installsitearch>, C<installsitebin>, C<installsitehtml1dir>,
17895 C<installsitehtml3dir>, C<installsitelib>, C<installsiteman1dir>,
17896 C<installsiteman3dir>, C<installsitescript>, C<installstyle>,
17897 C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>,
17898 C<installvendorhtml1dir>, C<installvendorhtml3dir>, C<installvendorlib>,
17899 C<installvendorman1dir>, C<installvendorman3dir>, C<installvendorscript>,
17900 C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
17908 C<known_extensions>, C<ksh>
17916 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
17917 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
17918 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
17919 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
17920 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
17921 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
17930 C<mad>, C<madlyh>, C<madlyobj>, C<madlysrc>, C<mail>, C<mailx>, C<make>,
17931 C<make_set_make>, C<mallocobj>, C<mallocsrc>, C<malloctype>, C<man1dir>,
17932 C<man1direxp>, C<man1ext>, C<man3dir>, C<man3direxp>, C<man3ext>,
17933 C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>, C<more>,
17934 C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>, C<myuname>
17942 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
17943 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
17944 C<nonxs_ext>, C<nroff>, C<nv_overflows_integers_at>,
17945 C<nv_preserves_uv_bits>, C<nveformat>, C<nvEUformat>, C<nvfformat>,
17946 C<nvFUformat>, C<nvgformat>, C<nvGUformat>, C<nvsize>, C<nvtype>
17954 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
17955 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
17963 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl>,
17972 C<PERL_API_REVISION>, C<PERL_API_SUBVERSION>, C<PERL_API_VERSION>,
17973 C<PERL_CONFIG_SH>, C<PERL_PATCHLEVEL>, C<perl_patchlevel>,
17974 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
17975 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
17976 C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>,
17977 C<procselfexe>, C<prototype>, C<ptrsize>
17985 C<quadkind>, C<quadtype>
17993 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
17994 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
17995 C<rm_try>, C<rmail>, C<run>, C<runnm>
18003 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
18004 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
18005 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
18006 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>,
18007 C<sGMTIME_max>, C<sGMTIME_min>, C<sh>, C<shar>, C<sharpbang>, C<shmattype>,
18008 C<shortsize>, C<shrpenv>, C<shsharp>, C<sig_count>, C<sig_name>,
18009 C<sig_name_init>, C<sig_num>, C<sig_num_init>, C<sig_size>, C<signal_t>,
18010 C<sitearch>, C<sitearchexp>, C<sitebin>, C<sitebinexp>, C<sitehtml1dir>,
18011 C<sitehtml1direxp>, C<sitehtml3dir>, C<sitehtml3direxp>, C<sitelib>,
18012 C<sitelib_stem>, C<sitelibexp>, C<siteman1dir>, C<siteman1direxp>,
18013 C<siteman3dir>, C<siteman3direxp>, C<siteprefix>, C<siteprefixexp>,
18014 C<sitescript>, C<sitescriptexp>, C<sizesize>, C<sizetype>, C<sleep>,
18015 C<sLOCALTIME_max>, C<sLOCALTIME_min>, C<smail>, C<so>, C<sockethdr>,
18016 C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>,
18017 C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>,
18018 C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>,
18019 C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>,
18020 C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>,
18021 C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>,
18022 C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>,
18023 C<submit>, C<subversion>, C<sysman>
18031 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
18032 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
18041 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
18042 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
18043 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
18044 C<use64bitint>, C<usecrosscompile>, C<usedevel>, C<usedl>, C<usedtrace>,
18045 C<usefaststdio>, C<useithreads>, C<uselargefiles>, C<uselongdouble>,
18046 C<usemallocwrap>, C<usemorebits>, C<usemultiplicity>, C<usemymalloc>,
18047 C<usenm>, C<useopcode>, C<useperlio>, C<useposix>, C<usereentrant>,
18048 C<userelocatableinc>, C<usesfio>, C<useshrplib>, C<usesitecustomize>,
18049 C<usesocks>, C<usethreads>, C<usevendorprefix>, C<usevfork>, C<usrinc>,
18050 C<uuname>, C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>,
18059 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
18060 C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>,
18061 C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>,
18062 C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>,
18063 C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>,
18064 C<vendorscriptexp>, C<version>, C<version_patchlevel_string>,
18065 C<versiononly>, C<vi>, C<voidflags>
18081 C<yacc>, C<yaccflags>
18103 dynamic, nonxs, static
18109 =head2 Cwd - get pathname of current working directory
18119 =item getcwd and friends
18121 getcwd, cwd, fastcwd, fastgetcwd, getdcwd
18123 =item abs_path and friends
18125 abs_path, realpath, fast_abs_path
18141 =head2 DB - programmatic interface to the Perl debugging API
18151 =item Global Variables
18153 $DB::sub, %DB::sub, $DB::single, $DB::signal, $DB::trace, @DB::args,
18154 @DB::dbline, %DB::dbline, $DB::package, $DB::filename, $DB::subname,
18159 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
18160 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
18162 =item Client Callback Methods
18164 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
18165 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
18166 CLIENT->output(LIST)
18176 =head2 DBM_Filter -- Filter DBM keys/values
18184 =item What is a DBM Filter?
18188 =item So what's new?
18196 =item $db->Filter_Push()
18198 =item $db->Filter_Key_Push()
18200 =item $db->Filter_Value_Push()
18202 Filter_Push, Filter_Key_Push, Filter_Value_Push
18204 =item $db->Filter_Pop()
18206 =item $db->Filtered()
18210 =item Writing a Filter
18214 =item Immediate Filters
18216 =item Canned Filters
18222 =item Filters Included
18224 utf8, encode, compress, int32, null
18230 =item Maintain Round Trip Integrity
18232 =item Don't mix filtered & non-filtered data in the same database file.
18244 =head2 DBM_Filter::compress - filter for DBM_Filter
18258 =head2 DBM_Filter::encode - filter for DBM_Filter
18272 =head2 DBM_Filter::int32 - filter for DBM_Filter
18286 =head2 DBM_Filter::null - filter for DBM_Filter
18300 =head2 DBM_Filter::utf8 - filter for DBM_Filter
18314 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
18322 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
18326 =item Using DB_File with Berkeley DB version 2 or greater
18328 =item Interface to Berkeley DB
18330 =item Opening a Berkeley DB Database File
18332 =item Default Parameters
18334 =item In Memory Databases
18342 =item A Simple Example
18350 =item Changing the BTREE sort order
18352 =item Handling Duplicate Keys
18354 =item The get_dup() Method
18356 =item The find_dup() Method
18358 =item The del_dup() Method
18360 =item Matching Partial Keys
18368 =item The 'bval' Option
18370 =item A Simple Example
18372 =item Extra RECNO Methods
18374 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
18375 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
18376 length, elements);>
18378 =item Another Example
18382 =item THE API INTERFACE
18384 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
18385 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
18386 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
18387 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
18391 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
18392 B<filter_fetch_value>
18398 =item An Example -- the NULL termination problem.
18400 =item Another Example -- Key is a C int.
18404 =item HINTS AND TIPS
18408 =item Locking: The Trouble with fd
18410 =item Safe ways to lock a database
18412 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
18414 =item Sharing Databases With C Applications
18416 =item The untie() Gotcha
18420 =item COMMON QUESTIONS
18424 =item Why is there Perl source in my database?
18426 =item How do I store complex data structures with DB_File?
18428 =item What does "Invalid Argument" mean?
18430 =item What does "Bareword 'DB_File' not allowed" mean?
18450 =head2 Data::Dumper - stringified perl data structures, suitable for both
18451 printing and C<eval>
18463 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump I<or>
18464 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
18465 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
18472 =item Configuration Variables or Methods
18498 =head2 Devel::DProf - a Perl code profiler
18506 =item PROFILE FORMAT
18518 =head2 Devel::InnerPackage - find all the inner packages of a package
18530 =item list_packages <package name>
18546 =head2 Devel::PPPort - Perl/Pollution/Portability
18556 =item Why use ppport.h?
18558 =item How to use ppport.h
18560 =item Running ppport.h
18572 =item COMPATIBILITY
18576 =item Provided Perl compatibility API
18578 =item Perl API not supported by ppport.h
18580 perl 5.11.0, perl 5.10.0, perl 5.9.5, perl 5.9.4, perl 5.9.3, perl 5.9.2,
18581 perl 5.9.1, perl 5.9.0, perl 5.8.3, perl 5.8.1, perl 5.8.0, perl 5.7.3,
18582 perl 5.7.2, perl 5.7.1, perl 5.6.1, perl 5.6.0, perl 5.005_03, perl 5.005,
18583 perl 5.004_05, perl 5.004
18597 =head2 Devel::Peek - A data debugging tool for the XS programmer
18607 =item Runtime debugging
18609 =item Memory footprint debugging
18617 =item A simple scalar string
18619 =item A simple scalar number
18621 =item A simple scalar with an extra reference
18623 =item A reference to a simple scalar
18625 =item A reference to an array
18627 =item A reference to a hash
18629 =item Dumping a large array or hash
18631 =item A reference to an SV which holds a C pointer
18633 =item A reference to a subroutine
18647 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
18657 =head2 Digest - Modules that calculate message digests
18665 I<binary>, I<hex>, I<base64>
18669 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
18670 Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset,
18671 $ctx->add( $data ), $ctx->add( $chunk1, $chunk2, ... ), $ctx->addfile(
18672 $io_handle ), $ctx->add_bits( $data, $nbits ), $ctx->add_bits( $bitstring
18673 ), $ctx->digest, $ctx->hexdigest, $ctx->b64digest
18683 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
18693 md5($data,...), md5_hex($data,...), md5_base64($data,...)
18697 $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...),
18698 $md5->addfile($io_handle), $md5->add_bits($data, $nbits),
18699 $md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest
18711 =head2 Digest::SHA - Perl extension for SHA-1/224/256/384/512
18717 =item SYNOPSIS (HMAC-SHA)
18723 =item NIST STATEMENT ON SHA-1
18725 =item PADDING OF BASE64 DIGESTS
18729 =item EXPORTABLE FUNCTIONS
18731 B<sha1($data, ...)>, B<sha224($data, ...)>, B<sha256($data, ...)>,
18732 B<sha384($data, ...)>, B<sha512($data, ...)>, B<sha1_hex($data, ...)>,
18733 B<sha224_hex($data, ...)>, B<sha256_hex($data, ...)>, B<sha384_hex($data,
18734 ...)>, B<sha512_hex($data, ...)>, B<sha1_base64($data, ...)>,
18735 B<sha224_base64($data, ...)>, B<sha256_base64($data, ...)>,
18736 B<sha384_base64($data, ...)>, B<sha512_base64($data, ...)>, B<new($alg)>,
18737 B<reset($alg)>, B<hashsize>, B<algorithm>, B<clone>, B<add($data, ...)>,
18738 B<add_bits($data, $nbits)>, B<add_bits($bits)>, B<addfile(*FILE)>,
18739 B<addfile($filename [, $mode])>, B<dump($filename)>, B<load($filename)>,
18740 B<digest>, B<hexdigest>, B<b64digest>, B<hmac_sha1($data, $key)>,
18741 B<hmac_sha224($data, $key)>, B<hmac_sha256($data, $key)>,
18742 B<hmac_sha384($data, $key)>, B<hmac_sha512($data, $key)>,
18743 B<hmac_sha1_hex($data, $key)>, B<hmac_sha224_hex($data, $key)>,
18744 B<hmac_sha256_hex($data, $key)>, B<hmac_sha384_hex($data, $key)>,
18745 B<hmac_sha512_hex($data, $key)>, B<hmac_sha1_base64($data, $key)>,
18746 B<hmac_sha224_base64($data, $key)>, B<hmac_sha256_base64($data, $key)>,
18747 B<hmac_sha384_base64($data, $key)>, B<hmac_sha512_base64($data, $key)>
18753 =item ACKNOWLEDGMENTS
18755 =item COPYRIGHT AND LICENSE
18759 =head2 Digest::SHA::lib::Digest::SHA, Digest::SHA - Perl extension for
18760 SHA-1/224/256/384/512
18766 =item SYNOPSIS (HMAC-SHA)
18772 =item NIST STATEMENT ON SHA-1
18774 =item PADDING OF BASE64 DIGESTS
18778 =item EXPORTABLE FUNCTIONS
18780 B<sha1($data, ...)>, B<sha224($data, ...)>, B<sha256($data, ...)>,
18781 B<sha384($data, ...)>, B<sha512($data, ...)>, B<sha1_hex($data, ...)>,
18782 B<sha224_hex($data, ...)>, B<sha256_hex($data, ...)>, B<sha384_hex($data,
18783 ...)>, B<sha512_hex($data, ...)>, B<sha1_base64($data, ...)>,
18784 B<sha224_base64($data, ...)>, B<sha256_base64($data, ...)>,
18785 B<sha384_base64($data, ...)>, B<sha512_base64($data, ...)>, B<new($alg)>,
18786 B<reset($alg)>, B<hashsize>, B<algorithm>, B<clone>, B<add($data, ...)>,
18787 B<add_bits($data, $nbits)>, B<add_bits($bits)>, B<addfile(*FILE)>,
18788 B<addfile($filename [, $mode])>, B<dump($filename)>, B<load($filename)>,
18789 B<digest>, B<hexdigest>, B<b64digest>, B<hmac_sha1($data, $key)>,
18790 B<hmac_sha224($data, $key)>, B<hmac_sha256($data, $key)>,
18791 B<hmac_sha384($data, $key)>, B<hmac_sha512($data, $key)>,
18792 B<hmac_sha1_hex($data, $key)>, B<hmac_sha224_hex($data, $key)>,
18793 B<hmac_sha256_hex($data, $key)>, B<hmac_sha384_hex($data, $key)>,
18794 B<hmac_sha512_hex($data, $key)>, B<hmac_sha1_base64($data, $key)>,
18795 B<hmac_sha224_base64($data, $key)>, B<hmac_sha256_base64($data, $key)>,
18796 B<hmac_sha384_base64($data, $key)>, B<hmac_sha512_base64($data, $key)>
18802 =item ACKNOWLEDGMENTS
18804 =item COPYRIGHT AND LICENSE
18808 =head2 Digest::base - Digest base class
18820 =head2 Digest::file - Calculate digests of files
18828 digest_file( $file, $algorithm, [$arg,...] ), digest_file_hex( $file,
18829 $algorithm, [$arg,...] ), digest_file_base64( $file, $algorithm, [$arg,...]
18836 =head2 DirHandle - supply object methods for directory handles
18848 =head2 Dumpvalue - provides screen dump of Perl data.
18860 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
18861 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
18862 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
18867 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
18868 compactDump, veryCompact, set, get
18874 =head2 DynaLoader - Dynamically load C libraries into Perl code
18882 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
18883 @dl_modules, @dl_shared_objects, dl_error(), $dl_debug, dl_findfile(),
18884 dl_expandspec(), dl_load_file(), dl_unload_file(), dl_load_flags(),
18885 dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(),
18886 dl_install_xsub(), bootstrap()
18892 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
18905 =item Migration from C<DynaLoader>
18907 =item Backward compatible boilerplate
18911 =item Order of initialization: early load()
18915 =item The most hairy case
18921 C<Can't find '%s' symbol in %s>, C<Can't load '%s' for module %s: %s>,
18922 C<Undefined symbols present after loading %s: %s>,
18923 C<XSLoader::load('Your::Module', $Your::Module::VERSION)>
18933 =item COPYRIGHT & LICENSE
18937 =head2 Encode - character encodings
18945 =item Table of Contents
18957 =item PERL ENCODING API
18959 $octets = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
18960 $octets [, CHECK]), [$obj =] find_encoding(ENCODING), [$length =]
18961 from_to($octets, FROM_ENC, TO_ENC [, CHECK]), $octets =
18962 encode_utf8($string);, $string = decode_utf8($octets [, CHECK]);
18966 =item Listing available encodings
18968 =item Defining Aliases
18970 =item Finding IANA Character Set Registry names
18974 =item Encoding via PerlIO
18976 =item Handling Malformed Data
18978 B<NOTE:> Not all encoding support this feature, I<CHECK> =
18979 Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1), I<CHECK> =
18980 Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode (I<CHECK> =
18981 Encode::FB_PERLQQ), HTML charref mode (I<CHECK> = Encode::FB_HTMLCREF), XML
18982 charref mode (I<CHECK> = Encode::FB_XMLCREF), The bitmask,
18987 =item coderef for CHECK
18991 =item Defining Encodings
18993 =item The UTF8 flag
18995 Goal #1:, Goal #2:, Goal #3:, Goal #4:
18999 =item Messing with Perl's Internals
19001 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
19005 =item UTF-8 vs. utf8 vs. UTF8
19015 =head2 Encode::Alias - alias definitions to encodings
19023 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
19028 =item Alias overloading
19036 =head2 Encode::Byte - Single Byte Encodings
19050 =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
19052 =head2 Encode::CN - China-based Chinese Encodings
19068 =head2 Encode::CN::HZ -- internally used by Encode::CN
19070 =head2 Encode::Config -- internally used by Encode
19072 =head2 Encode::EBCDIC - EBCDIC Encodings
19086 =head2 Encode::Encoding - Encode Implementation Base Class
19096 =item Methods you should implement
19098 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
19099 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
19101 =item Other methods defined in Encode::Encodings
19103 -E<gt>name, -E<gt>mime_name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(),
19104 -E<gt>needs_lines()
19106 =item Example: Encode::ROT13
19110 =item Why the heck Encode API is different?
19114 =item Compiled Encodings
19120 Scheme 1, Scheme 2, Other Schemes
19124 =head2 Encode::GSM0338 -- ESTI GSM 03.38 Encoding
19140 =head2 Encode::Guess -- Guesses encoding from data
19150 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
19151 Encode::decode("Guess" ...), Encode::Guess->guess($data),
19152 guess_encoding($data, [, I<list of suspects>])
19162 =head2 Encode::JP - Japanese Encodings
19172 =item Note on ISO-2022-JP(-1)?
19180 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
19182 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
19184 =head2 Encode::KR - Korean Encodings
19198 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
19200 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
19216 =head2 Encode::MIME::Name, Encode::MIME::NAME -- internally used by Encode
19224 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
19230 =item How does it work?
19232 =item Line Buffering
19236 =item How can I tell whether my encoding fully supports PerlIO ?
19244 =head2 Encode::Supported -- Encodings supported by Encode
19252 =item Encoding Names
19256 =item Supported Encodings
19260 =item Built-in Encodings
19262 =item Encode::Unicode -- other Unicode encodings
19264 =item Encode::Byte -- Extended ASCII
19266 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
19269 =item gsm0338 - Hentai Latin 1
19271 gsm0338 support before 2.19
19273 =item CJK: Chinese, Japanese, Korean (Multibyte)
19275 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
19276 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
19277 Encode::JIS2K -- JIS X 0213 encodings via CPAN
19279 =item Miscellaneous encodings
19281 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
19285 =item Unsupported encodings
19287 ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
19288 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
19289 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
19290 Various Mac encodings, (Mac) Indic encodings
19292 =item Encoding vs. Charset -- terminology
19294 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
19298 =item Microsoft-related naming mess
19300 KS_C_5601-1987, GB2312, Big5, Shift_JIS
19306 character repertoire, coded character set (CCS), character encoding scheme
19307 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
19314 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
19315 RFC, UC, Unicode Glossary
19319 =item Other Notable Sites
19321 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
19322 "Introduction to i18n"
19324 =item Offline sources
19326 C<CJKV Information Processing> by Ken Lunde
19332 =head2 Encode::Symbol - Symbol Encodings
19346 =head2 Encode::TW - Taiwan-based Chinese Encodings
19362 =head2 Encode::Unicode -- Various Unicode Transformation Formats
19370 L<http://www.unicode.org/glossary/> says:, Quick Reference
19372 =item Size, Endianness, and BOM
19378 =item by endianness
19380 BOM as integer when fetched in network byte order
19384 =item Surrogate Pairs
19386 =item Error Checking
19392 =head2 Encode::Unicode::UTF7 -- UTF-7 encoding
19406 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
19415 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
19420 =item Alias overloading
19428 =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm --
19429 Internally used by Encode::??::ISO_2022_*
19431 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
19434 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
19437 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
19438 Implementation Base Class
19448 =item Methods you should implement
19450 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
19451 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
19453 =item Other methods defined in Encode::Encodings
19455 -E<gt>name, -E<gt>mime_name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(),
19456 -E<gt>needs_lines()
19458 =item Example: Encode::ROT13
19462 =item Why the heck Encode API is different?
19466 =item Compiled Encodings
19472 Scheme 1, Scheme 2, Other Schemes
19476 =head2 Encode::lib::Encode::GSM0338, Encode::GSM0338 -- ESTI GSM 03.38
19493 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
19504 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
19505 Encode::decode("Guess" ...), Encode::Guess->guess($data),
19506 guess_encoding($data, [, I<list of suspects>])
19516 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
19517 Encode::JP::2022_JP*
19519 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
19522 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
19525 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
19526 and 'Q' header encoding
19542 =head2 Encode::lib::Encode::MIME::Name, Encode::MIME::NAME -- internally
19551 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
19552 on Encode and PerlIO
19558 =item How does it work?
19560 =item Line Buffering
19564 =item How can I tell whether my encoding fully supports PerlIO ?
19572 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
19573 supported by Encode
19581 =item Encoding Names
19585 =item Supported Encodings
19589 =item Built-in Encodings
19591 =item Encode::Unicode -- other Unicode encodings
19593 =item Encode::Byte -- Extended ASCII
19595 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
19598 =item gsm0338 - Hentai Latin 1
19600 gsm0338 support before 2.19
19602 =item CJK: Chinese, Japanese, Korean (Multibyte)
19604 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
19605 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
19606 Encode::JIS2K -- JIS X 0213 encodings via CPAN
19608 =item Miscellaneous encodings
19610 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
19614 =item Unsupported encodings
19616 ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
19617 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
19618 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
19619 Various Mac encodings, (Mac) Indic encodings
19621 =item Encoding vs. Charset -- terminology
19623 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
19627 =item Microsoft-related naming mess
19629 KS_C_5601-1987, GB2312, Big5, Shift_JIS
19635 character repertoire, coded character set (CCS), character encoding scheme
19636 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
19643 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
19644 RFC, UC, Unicode Glossary
19648 =item Other Notable Sites
19650 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
19651 "Introduction to i18n"
19653 =item Offline sources
19655 C<CJKV Information Processing> by Ken Lunde
19661 =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7
19676 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
19688 =item Predefined Methods
19690 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
19691 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
19692 $e-E<gt>bytes([$encoding])
19694 =item Example: base64 transcoder
19696 =item Operator Overloading
19704 =head2 Encodencoding, encoding - allows you to write your script in
19705 non-ascii or non-utf8
19715 =item Literal Conversions
19717 =item PerlIO layers for C<STD(IN|OUT)>
19719 =item Implicit upgrading for byte strings
19725 =item FEATURES THAT REQUIRE 5.8.1
19727 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
19731 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
19732 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
19734 =item The Filter Option
19738 =item Filter-related changes at Encode version 1.87
19748 =item DO NOT MIX MULTIPLE ENCODINGS
19750 =item tr/// with ranges
19752 Legend of characters above
19756 =item EXAMPLE - Greekperl
19758 =item KNOWN PROBLEMS
19760 literals in regex that are longer than 127 bytes, EBCDIC, format, Thread
19765 =item The Logic of :locale
19775 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
19787 =item Predefined Methods
19789 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
19790 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
19791 $e-E<gt>bytes([$encoding])
19793 =item Example: base64 transcoder
19795 =item Operator Overloading
19803 =head2 English - use nice English (or awk) names for ugly punctuation
19816 =head2 Env - perl module that imports environment variables as scalars or
19831 =head2 Errno - System errno constants
19847 =head2 Exporter - Implements default import method for modules
19857 =item How to Export
19859 =item Selecting What To Export
19861 =item How to Import
19863 C<use YourModule;>, C<use YourModule ();>, C<use YourModule qw(...);>
19867 =item Advanced features
19871 =item Specialised Import Lists
19873 =item Exporting without using Exporter's import method
19875 =item Exporting without inheriting from Exporter
19877 =item Module Version Checking
19879 =item Managing Unknown Symbols
19881 =item Tag Handling Utility Functions
19883 =item Generating combined tags
19885 =item C<AUTOLOAD>ed Constants
19889 =item Good Practices
19893 =item Declaring C<@EXPORT_OK> and Friends
19897 =item What not to Export
19907 =head2 Exporter::Heavy - Exporter guts
19917 =head2 ExtUtils::CBuilder - Compile and link C code for Perl modules
19927 new, have_compiler, compile, C<object_file>, C<include_dirs>,
19928 C<extra_compiler_flags>, link, lib_file, module_name, extra_linker_flags,
19929 link_executable, exe_file, object_file, lib_file, exe_file, prelink,
19930 need_prelink, extra_link_args_after_prelink
19944 =head2 ExtUtils::CBuilder::Platform::Windows - Builder class for Windows
19957 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
20006 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
20020 B<warn_if_old_packlist>
20022 B<perllocal_install>
20026 =head2 ExtUtils::Constant - generate XS code to import C header constants
20036 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
20044 XS_constant PACKAGE, TYPES, XS_SUBNAME, C_SUBNAME
20046 autoload PACKAGE, VERSION, AUTOLOADER
20048 WriteMakefileSnippet
20050 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
20051 BREAKOUT_AT, NAMES, PROXYSUBS, C_FH, C_FILE, XS_FH, XS_FILE, XS_SUBNAME,
20060 =head2 ExtUtils::Constant::Base - base class for ExtUtils::Constant objects
20074 memEQ_clause args_hashref
20076 dump_names arg_hashref, ITEM..
20078 assign arg_hashref, VALUE..
20080 return_clause arg_hashref, ITEM
20082 switch_clause arg_hashref, NAMELEN, ITEMHASH, ITEM..
20086 dogfood arg_hashref, ITEM..
20088 normalise_items args, default_type, seen_types, seen_items, ITEM..
20090 C_constant arg_hashref, ITEM.., name, type, value, macro, default, pre,
20091 post, def_pre, def_post, utf8, weight
20101 =head2 ExtUtils::Constant::Utils - helper functions for ExtUtils::Constant
20115 perl_stringify NAME
20123 =head2 ExtUtils::Constant::XS, ExtUtils::Constant::Base - base class for
20124 ExtUtils::Constant objects
20138 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
20150 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
20151 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
20161 =head2 ExtUtils::Install - install files from here to there
20173 _chmod($$;$), _warnonce(@), _choke(@)
20177 _move_file_at_boot( $file, $target, $moan )
20179 _unlink_or_rename( $file, $tryhard, $installing )
20191 _can_write_dir(C<$dir>)
20193 _mkpath($dir,$show,$mode,$verbose,$dry_run)
20195 _copy($from,$to,$verbose,$dry_run)
20203 install_rooted_file( $file ), install_rooted_dir( $dir )
20205 forceunlink( $file, $tryhard )
20207 directory_not_empty( $dir )
20209 B<install_default> I<DISCOURAGED>
20213 inc_uninstall($filepath,$libdir,$verbose,$dry_run,$ignore,$results)
20215 run_filter($cmd,$src,$dest)
20227 B<PERL_INSTALL_ROOT>, B<EU_INSTALL_IGNORE_SKIP>,
20228 B<EU_INSTALL_SITE_SKIPFILE>, B<EU_INSTALL_ALWAYS_COPY>
20236 =head2 ExtUtils::Installed - Inventory management of installed modules
20248 new(), modules(), files(), directories(), directory_tree(), validate(),
20249 packlist(), version()
20257 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
20265 For static extensions, For dynamic extensions at build/link time, For
20266 dynamic extensions at load time
20272 =item LDLOADLIBS and LD_RUN_PATH
20282 =item VMS implementation
20284 =item Win32 implementation
20292 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
20302 =head2 ExtUtils::MM_AIX - AIX specific subclass of ExtUtils::MM_Unix
20312 =item Overridden methods
20326 =head2 ExtUtils::MM_Any - Platform-agnostic MM methods
20338 =item Cross-platform helper methods
20364 =item File::Spec wrappers
20380 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
20381 ExtUtils::MakeMaker
20395 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
20396 ExtUtils::MakeMaker
20410 replace_manpage_separator
20414 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
20424 =item Overridden methods
20432 B<replace_manpage_separator>
20442 =head2 ExtUtils::MM_Darwin - special behaviors for OS X
20452 =item Overriden Methods
20458 =head2 ExtUtils::MM_Haiku - methods to override UN*X behaviour in
20459 ExtUtils::MakeMaker
20473 =head2 ExtUtils::MM_MacOS - once produced Makefiles for MacOS Classic
20483 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
20484 ExtUtils::MakeMaker
20496 init_platform, platform_constants
20504 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
20505 ExtUtils::MakeMaker
20523 =head2 ExtUtils::MM_QNX - QNX specific subclass of ExtUtils::MM_Unix
20533 =item Overridden methods
20547 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
20557 =item Overridden methods
20565 B<replace_manpage_separator>
20575 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
20677 init_platform, platform_constants
20719 post_initialize (o)
20731 replace_manpage_separator
20755 test_via_harness (override)
20757 test_via_script (override)
20781 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
20782 ExtUtils::MakeMaker
20792 =item Methods always loaded
20804 guess_name (override)
20808 find_perl (override)
20810 maybe_command (override)
20814 pm_to_blib (override)
20816 perl_script (override)
20818 replace_manpage_separator
20824 init_main (override)
20826 init_others (override)
20828 init_platform (override)
20832 init_VERSION (override)
20834 constants (override)
20840 const_cccmd (override)
20842 tools_other (override)
20844 init_dist (override)
20854 dynamic_lib (override)
20856 static_lib (override)
20860 zipfile_target, tarfile_target, shdist_target
20864 perldepend (override)
20866 makeaperl (override)
20868 maketext_filter (override)
20870 prefixify (override)
20898 =head2 ExtUtils::MM_VOS - VOS specific subclass of ExtUtils::MM_Unix
20908 =item Overridden methods
20922 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
20923 ExtUtils::MakeMaker
20935 =item Overridden methods
20941 replace_manpage_separator
20949 init_platform, platform_constants
20977 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
20987 =item Overridden methods
21009 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
21019 =head2 ExtUtils::MakeMaker - Create a module Makefile
21029 =item How To Write A Makefile.PL
21031 =item Default Makefile Behaviour
21041 =item PREFIX and LIB attribute
21045 =item Static Linking of a new Perl Binary
21047 =item Determination of Perl Library and Installation Locations
21049 =item Which architecture dependent directory?
21051 =item Using Attributes and Parameters
21053 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
21054 CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS,
21055 EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN,
21056 FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB,
21057 INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
21058 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB,
21059 INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLSITESCRIPT,
21060 INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB,
21061 INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INSTALLVENDORSCRIPT,
21062 INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT,
21063 LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS, LICENSE, LINKTYPE, MAKE,
21064 MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET, META_ADD,
21065 META_MERGE, MIN_PERL_VERSION, MYEXTLIB, NAME, NEEDS_LINKING, NOECHO,
21066 NORECURS, NO_META, NO_VC, OBJECT, OPTIMIZE, PERL, PERL_CORE, PERLMAINCC,
21067 PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST,
21068 PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE,
21069 PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM,
21070 PREREQ_PRINT, PRINT_PREREQ, SITEPREFIX, SIGN, SKIP, TYPEMAPS, VENDORPREFIX,
21071 VERBINST, VERSION, VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG,
21074 =item Additional lowercase attributes
21076 clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean,
21077 test, tool_autosplit
21079 =item Overriding MakeMaker Methods
21081 =item The End Of Cargo Cult Programming
21083 C<< MAN3PODS => ' ' >>
21085 =item Hintsfile support
21087 =item Distribution Support
21089 make distcheck, make skipcheck, make distclean, make manifest,
21090 make distdir, make disttest, make tardist, make dist, make
21091 uutardist, make shdist, make zipdist, make ci
21093 =item Module Meta-Data
21095 =item Disabling an extension
21097 =item Other Handy Functions
21105 PERL_MM_OPT, PERL_MM_USE_DEFAULT, PERL_CORE
21115 =head2 ExtUtils::MakeMaker::Config - Wrapper around Config.pm
21125 =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About
21134 =item Module Installation
21136 How do I install a module into my home directory?, How do I get MakeMaker
21137 and Module::Build to install to the same place?, How do I keep from
21138 installing man pages?, How do I use a module without installing it?, PREFIX
21139 vs INSTALL_BASE from Module::Build::Cookbook
21141 =item Philosophy and History
21143 Why not just use <insert other build config tool here>?, What is
21144 Module::Build and how does it relate to MakeMaker?, pure perl. no make, no
21145 shell commands, easier to customize, cleaner internals, less cruft
21147 =item Module Writing
21149 How do I keep my $VERSION up to date without resetting it manually?, What's
21150 this F<META.yml> thing and how did it get in my F<MANIFEST>?!, How do I
21151 delete everything not in my F<MANIFEST>?
21155 How to I prevent "object version X.XX does not match bootstrap parameter
21156 Y.YY" errors?, How do I make two or more XS files coexist in the same
21169 =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker
21183 Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP,
21192 =head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm
21202 =head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm
21212 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
21252 =item MANIFEST.SKIP
21254 #!include_default, #!include /Path/to/another/manifest.skip
21258 =item GLOBAL VARIABLES
21266 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
21267 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
21271 B<PERL_MM_MANIFEST_DEBUG>
21279 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
21291 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
21301 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
21310 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
21322 =head2 ExtUtils::Packlist - manage .packlist files
21334 new(), read(), write(), validate(), packlist_file()
21342 =head2 ExtUtils::ParseXS - converts Perl XS code into C code
21352 process_xs(), B<C++>, B<hiertype>, B<except>, B<typemap>, B<prototypes>,
21353 B<versioncheck>, B<linenumbers>, B<optimize>, B<inout>, B<argtypes>, B<s>,
21364 =head2 ExtUtils::testlib - add blib/* directories to @INC
21374 =head2 Fatal - Replace functions with equivalents which succeed or die
21380 =item BEST PRACTICE
21386 Bad subroutine name for Fatal: %s, %s is not a Perl subroutine, %s is
21387 neither a builtin, nor a Perl subroutine, Cannot make the non-overridable
21388 %s fatal, Internal error: %s
21400 =head2 Fcntl - load the C Fcntl.h defines
21410 =item EXPORTED SYMBOLS
21414 =head2 File::Basename - Parse file paths into directory, filename and
21425 C<fileparse> X<fileparse>
21427 C<basename> X<basename> X<filename>
21429 C<dirname> X<dirname>
21431 C<fileparse_set_fstype> X<filesystem>
21439 =head2 File::CheckTree - run many filetest checks on a tree
21453 =head2 File::Compare - Compare files or filehandles
21467 =head2 File::Copy - Copy files or filehandles
21475 copy X<copy> X<cp>, move X<move> X<mv> X<rename>, syscopy X<syscopy>,
21476 rmscopy($from,$to[,$date_flag]) X<rmscopy>
21486 =head2 File::DosGlob - DOS like globbing and then some
21496 =item EXPORTS (by request only)
21508 =head2 File::Fetch - A generic file fetching mechanism
21518 $ff->uri, $ff->scheme, $ff->host, $ff->vol, $ff->share, $ff->path,
21531 =item $ff = File::Fetch->new( uri => 'http://some.where.com/dir/file.txt'
21540 =item $ff->fetch( [to => /my/output/dir/] )
21546 =item $ff->error([BOOL])
21554 =item GLOBAL VARIABLES
21558 =item $File::Fetch::FROM_EMAIL
21560 =item $File::Fetch::USER_AGENT
21562 =item $File::Fetch::FTP_PASSIVE
21564 =item $File::Fetch::TIMEOUT
21566 =item $File::Fetch::WARN
21568 =item $File::Fetch::DEBUG
21570 =item $File::Fetch::BLACKLIST
21572 =item $File::Fetch::METHOD_FAIL
21578 =item FREQUENTLY ASKED QUESTIONS
21582 =item So how do I use a proxy with File::Fetch?
21584 =item I used 'lynx' to fetch a file, but its contents is all wrong!
21586 =item Files I'm trying to fetch have reserved characters or non-ASCII
21587 characters in them. What do I do?
21593 Implement $PREFER_BIN
21603 =head2 File::Find - Traverse a directory tree.
21611 B<find>, B<finddepth>
21617 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
21618 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
21619 C<untaint>, C<untaint_pattern>, C<untaint_skip>
21621 =item The wanted function
21623 C<$File::Find::dir> is the current directory name,, C<$_> is the current
21624 filename within that directory, C<$File::Find::name> is the complete
21625 pathname to the file
21633 $dont_use_nlink, symlinks
21637 =item BUGS AND CAVEATS
21643 =head2 File::Glob - Perl extension for BSD glob routine
21653 =item META CHARACTERS
21657 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
21658 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
21659 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
21665 C<GLOB_NOSPACE>, C<GLOB_ABEND>
21675 =head2 File::GlobMapper - Extend File Glob to Allow Input and Output Files
21685 =item Behind The Scenes
21689 =item Input File Glob
21691 B<~>, B<~user>, B<.>, B<*>, B<?>, B<\>, B<[]>, B<{,}>, B<()>
21693 =item Output File Glob
21697 =item Returned Data
21705 =item A Rename script
21707 =item A few example globmaps
21715 =item COPYRIGHT AND LICENSE
21719 =head2 File::Path - Create or remove directory trees
21729 make_path( $dir1, $dir2, .... ), make_path( $dir1, $dir2, ...., \%opts ),
21730 mode => $num, verbose => $bool, error => \$err, mkpath( $dir ), mkpath(
21731 $dir, $verbose, $mode ), mkpath( [$dir1, $dir2,...], $verbose, $mode ),
21732 mkpath( $dir1, $dir2,..., \%opt ), remove_tree( $dir1, $dir2, .... ),
21733 remove_tree( $dir1, $dir2, ...., \%opts ), verbose => $bool, safe => $bool,
21734 keep_root => $bool, result => \$res, error => \$err, rmtree( $dir ),
21735 rmtree( $dir, $verbose, $safe ), rmtree( [$dir1, $dir2,...], $verbose,
21736 $safe ), rmtree( $dir1, $dir2,..., \%opt )
21740 =item ERROR HANDLING
21750 mkdir [path]: [errmsg] (SEVERE), No root path(s) specified, No such file or
21751 directory, cannot fetch initial working directory: [errmsg], cannot stat
21752 initial working directory: [errmsg], cannot chdir to [dir]: [errmsg],
21753 directory [dir] changed before chdir, expected dev=[n] ino=[n], actual
21754 dev=[n] ino=[n], aborting. (FATAL), cannot make directory [dir]
21755 read+writeable: [errmsg], cannot read [dir]: [errmsg], cannot reset chmod
21756 [dir]: [errmsg], cannot remove [dir] when cwd is [dir], cannot chdir to
21757 [parent-dir] from [child-dir]: [errmsg], aborting. (FATAL), cannot stat
21758 prior working directory [dir]: [errmsg], aborting. (FATAL), previous
21759 directory [parent-dir] changed before entering [child-dir], expected
21760 dev=[n] ino=[n], actual dev=[n] ino=[n], aborting. (FATAL), cannot make
21761 directory [dir] writeable: [errmsg], cannot remove directory [dir]:
21762 [errmsg], cannot restore permissions of [dir] to [0nnn]: [errmsg], cannot
21763 make file [file] writeable: [errmsg], cannot unlink file [file]: [errmsg],
21764 cannot restore permissions of [file] to [0nnn]: [errmsg]
21770 =item ACKNOWLEDGEMENTS
21780 =head2 File::Spec - portably perform operations on file names
21790 canonpath X<canonpath>, catdir X<catdir>, catfile X<catfile>, curdir
21791 X<curdir>, devnull X<devnull>, rootdir X<rootdir>, tmpdir X<tmpdir>, updir
21792 X<updir>, no_upwards, case_tolerant, file_name_is_absolute, path X<path>,
21793 join X<join, path>, splitpath X<splitpath> X<split, path>, splitdir
21794 X<splitdir> X<split, dir>, catpath(), abs2rel X<abs2rel> X<absolute, path>
21795 X<relative, path>, rel2abs() X<rel2abs> X<absolute, path> X<relative, path>
21805 =head2 File::Spec::Cygwin - methods for Cygwin file specs
21817 file_name_is_absolute
21829 =head2 File::Spec::Epoc - methods for Epoc file specs
21851 =head2 File::Spec::Functions - portably perform operations on file names
21871 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
21899 file_name_is_absolute
21923 =head2 File::Spec::OS2 - methods for OS/2 file specs
21937 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
21970 file_name_is_absolute
21994 =head2 File::Spec::VMS - methods for VMS file specs
22002 canonpath (override)
22020 case_tolerant (override)
22024 file_name_is_absolute (override)
22026 splitpath (override)
22028 splitdir (override)
22044 =head2 File::Spec::Win32 - methods for Win32 file specs
22060 file_name_is_absolute
22074 =item Note For File::Spec::Win32 Maintainers
22086 =head2 File::Temp - return name and handle of a temporary file safely
22100 =item OBJECT-ORIENTED INTERFACE
22110 B<dirname>, B<unlink_on_destroy>
22126 =item MKTEMP FUNCTIONS
22140 =item POSIX FUNCTIONS
22150 =item ADDITIONAL FUNCTIONS
22158 =item UTILITY FUNCTIONS
22172 =item PACKAGE VARIABLES
22174 B<safe_level>, STANDARD, MEDIUM, HIGH
22180 B<$KEEP_ALL>, B<$DEBUG>
22188 =item Temporary files and NFS
22192 =item Directory removal
22206 =head2 File::stat - by-name interface to Perl's built-in stat() functions
22222 =head2 FileCache - keep more files open than the system permits
22230 cacheout EXPR, cacheout MODE, EXPR
22238 =head2 FileHandle - supply object methods for filehandles
22246 $fh->print, $fh->printf, $fh->getline, $fh->getlines
22252 =head2 Filter::Simple - Simplified source filtering
22266 =item Disabling or changing <no> behaviour
22268 =item All-in-one interface
22270 =item Filtering only specific components of source code
22272 C<"code">, C<"code_no_comments">, C<"executable">,
22273 C<"executable_no_comments">, C<"quotelike">, C<"string">, C<"regex">,
22276 =item Filtering only the code parts of source code
22278 Most source code ceases to be grammatically correct when it is broken up
22279 into the pieces between string literals and regexes. So the C<'code'>
22280 and C<'code_no_comments'> component filter behave slightly differently
22281 from the other partial filters described in the previous section.
22283 =item Using Filter::Simple with an explicit C<import> subroutine
22285 =item Using Filter::Simple and Exporter together
22295 =item COPYRIGHT AND LICENSE
22299 =head2 Filter::Util::Call - Perl Source Filter Utility Module
22309 =item B<use Filter::Util::Call>
22313 =item B<filter() and anonymous sub>
22315 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
22323 =item Example 1: A simple filter.
22325 =item Example 2: Using the context
22327 =item Example 3: Using the context within the filter
22329 =item Example 4: Using filter_del
22333 =item Filter::Simple
22341 =head2 FindBin - Locate directory of original perl script
22349 =item EXPORTABLE VARIABLES
22361 =head2 GDBM_File - Perl5 access to the gdbm library.
22377 =head2 Getopt::Long - Extended processing of command line options
22385 =item Command Line Options, an Introduction
22387 =item Getting Started with Getopt::Long
22391 =item Simple options
22393 =item A little bit less simple options
22395 =item Mixing command line option with other arguments
22397 =item Options with values
22399 =item Options with multiple values
22401 =item Options with hash values
22403 =item User-defined subroutines to handle options
22405 =item Options with multiple names
22407 =item Case and abbreviations
22409 =item Summary of Option Specifications
22411 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
22416 =item Advanced Possibilities
22420 =item Object oriented interface
22422 =item Thread Safety
22424 =item Documentation and help texts
22426 =item Parsing options from an arbitrary array
22428 =item Parsing options from an arbitrary string
22430 =item Storing options values in a hash
22434 =item The lonesome dash
22436 =item Argument callback
22440 =item Configuring Getopt::Long
22442 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
22443 require_order, permute, bundling (default: disabled), bundling_override
22444 (default: disabled), ignore_case (default: enabled), ignore_case_always
22445 (default: disabled), auto_version (default:disabled), auto_help
22446 (default:disabled), pass_through (default: disabled), prefix,
22447 prefix_pattern, long_prefix_pattern, debug (default: disabled)
22449 =item Exportable Methods
22451 VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage
22453 =item Return values and Errors
22459 =item Default destinations
22461 =item Alternative option starters
22463 =item Configuration variables
22467 =item Tips and Techniques
22471 =item Pushing multiple values in a hash option
22475 =item Trouble Shooting
22479 =item GetOptions does not return a false result when an option is not
22482 =item GetOptions does not split the command line correctly
22484 =item Undefined subroutine &main::GetOptions called
22486 =item How do I put a "-?" option into a Getopt::Long?
22492 =item COPYRIGHT AND DISCLAIMER
22496 =head2 Getopt::Std, getopt, getopts - Process single-character switches
22497 with switch clustering
22505 =item C<--help> and C<--version>
22509 =head2 Hash::Util - A selection of general-utility hash subroutines
22519 =item Restricted hashes
22521 B<lock_keys>, B<unlock_keys>
22529 B<lock_value>, B<unlock_value>
22531 B<lock_hash>, B<unlock_hash>
22533 B<lock_hash_recurse>, B<unlock_hash_recurse>
22537 B<legal_keys>, B<hidden_keys>, B<all_keys>, B<hash_seed>
22543 =item Operating on references to hashes.
22545 lock_ref_keys, unlock_ref_keys, lock_ref_keys_plus, lock_ref_value,
22546 unlock_ref_value, lock_hashref, unlock_hashref, lock_hashref_recurse,
22547 unlock_hashref_recurse, hash_ref_unlocked, legal_ref_keys, hidden_ref_keys
22563 =head2 Hash::Util::FieldHash - Support for Inside-Out Classes
22571 id, id_2obj, register, idhash, idhashes, fieldhash, fieldhashes
22577 =item The Inside-out Technique
22579 =item Problems of Inside-out
22583 =item More Problems
22585 =item The Generic Object
22587 =item How to use Field Hashes
22589 =item Garbage-Collected Hashes
22595 C<init()>, C<first()>, C<last()>, C<name()>, C<Name_hash>, C<Name_id>,
22596 C<Name_idhash>, C<Name_id_reg>, C<Name_idhash_reg>, C<Name_fieldhash>
22610 =item The C<PERL_MAGIC_uvar> interface for hashes
22612 =item Weakrefs call uvar magic
22614 =item How field hashes work
22616 =item Internal function Hash::Util::FieldHash::_fieldhash
22622 =item COPYRIGHT AND LICENSE
22626 =head2 Hash::Util::FieldHash::lib::Hash::Util::FieldHash,
22627 Hash::Util::FieldHash - Support for Inside-Out Classes
22635 id, id_2obj, register, idhash, idhashes, fieldhash, fieldhashes
22641 =item The Inside-out Technique
22643 =item Problems of Inside-out
22647 =item More Problems
22649 =item The Generic Object
22651 =item How to use Field Hashes
22653 =item Garbage-Collected Hashes
22659 C<init()>, C<first()>, C<last()>, C<name()>, C<Name_hash>, C<Name_id>,
22660 C<Name_idhash>, C<Name_id_reg>, C<Name_idhash_reg>, C<Name_fieldhash>
22674 =item The C<PERL_MAGIC_uvar> interface for hashes
22676 =item Weakrefs call uvar magic
22678 =item How field hashes work
22680 =item Internal function Hash::Util::FieldHash::_fieldhash
22686 =item COPYRIGHT AND LICENSE
22690 =head2 Hash::Utilib::Hash::Util, Hash::Util - A selection of
22691 general-utility hash subroutines
22701 =item Restricted hashes
22703 B<lock_keys>, B<unlock_keys>
22711 B<lock_value>, B<unlock_value>
22713 B<lock_hash>, B<unlock_hash>
22715 B<lock_hash_recurse>, B<unlock_hash_recurse>
22719 B<legal_keys>, B<hidden_keys>, B<all_keys>, B<hash_seed>
22725 =item Operating on references to hashes.
22727 lock_ref_keys, unlock_ref_keys, lock_ref_keys_plus, lock_ref_value,
22728 unlock_ref_value, lock_hashref, unlock_hashref, lock_hashref_recurse,
22729 unlock_hashref_recurse, hash_ref_unlocked, legal_ref_keys, hidden_ref_keys
22745 =head2 I18N::Collate - compare 8-bit scalar data according to the current
22756 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
22767 the function is_language_tag($lang1)
22769 the function extract_language_tags($whatever)
22771 the function same_language_tag($lang1, $lang2)
22773 the function similarity_language_tag($lang1, $lang2)
22775 the function is_dialect_of($lang1, $lang2)
22777 the function super_languages($lang1)
22779 the function locale2language_tag($locale_identifier)
22781 the function encode_language_tag($lang1)
22783 the function alternate_language_tags($lang1)
22785 the function @langs = panic_languages(@accept_languages)
22787 the function implicate_supers( ...languages... ), the function
22788 implicate_supers_strictly( ...languages... )
22792 =item ABOUT LOWERCASING
22794 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
22804 =head2 I18N::LangTags::Detect - detect the user's language preferences
22824 =head2 I18N::LangTags::List -- tags and names for human languages
22832 =item ABOUT LANGUAGE TAGS
22834 =item LIST OF LANGUAGES
22836 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} :
22837 Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} :
22838 Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian,
22839 {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)],
22840 {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic,
22841 {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy}
22842 : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} :
22843 Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} :
22844 Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae}
22845 : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} :
22846 Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai}
22847 : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} :
22848 Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} :
22849 Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber
22850 (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini,
22851 {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} :
22852 Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} :
22853 Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian
22854 (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central
22855 American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages],
22856 {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb}
22857 : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} :
22858 Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} :
22859 Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree,
22860 {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf}
22861 : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based
22862 Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} :
22863 Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} :
22864 Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru)
22865 Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri,
22866 {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch,
22867 {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi}
22868 : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} :
22869 English, {enm} : Old English (1100-1500), {ang} : Old English
22870 (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} :
22871 Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat}
22872 : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} :
22873 Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French
22874 (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} :
22875 Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan,
22876 {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian,
22877 {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High
22878 German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon}
22879 : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient
22880 Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} :
22881 Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian,
22882 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
22883 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
22884 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo,
22885 {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European
22886 (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua
22887 (International Auxiliary Language Association), {ie} : Interlingue, {iu} :
22888 Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} :
22889 Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian
22890 languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} :
22891 Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle,
22892 {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} :
22893 Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar}
22894 : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh,
22895 {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese,
22896 {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz,
22897 {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} :
22898 Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama,
22899 {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} :
22900 Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} :
22901 Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} :
22902 Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban
22903 (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui}
22904 : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai,
22905 {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili,
22906 {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} :
22907 Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} :
22908 Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} :
22909 Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai,
22910 [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} :
22911 Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} :
22912 Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)],
22913 {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple
22914 languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan,
22915 {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele,
22916 {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
22917 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
22918 {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} :
22919 Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} :
22920 Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi}
22921 : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} :
22922 Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
22923 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
22924 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
22925 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
22926 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
22927 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
22928 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
22929 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
22930 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
22931 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
22932 languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} :
22933 Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami,
22934 [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} :
22935 Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak,
22936 {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian,
22937 {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign
22938 Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} :
22939 Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave
22940 (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian,
22941 {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} :
22942 Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} :
22943 South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} :
22944 Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati,
22945 {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} :
22946 Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao,
22947 {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} :
22948 Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} :
22949 Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau,
22950 {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian,
22951 {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} :
22952 Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh}
22953 : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} :
22954 Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian,
22955 {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} :
22956 Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak}
22957 : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was}
22958 : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private
22959 Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} :
22960 Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
22961 : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu,
22966 =item COPYRIGHT AND DISCLAIMER
22972 =head2 I18N::Langinfo - query locale information
22990 =item COPYRIGHT AND LICENSE
22994 =head2 IO - load various IO modules
23006 =head2 IO::Compress::Base - Base Class for IO::Compress modules
23018 =item MODIFICATION HISTORY
23020 =item COPYRIGHT AND LICENSE
23024 =head2 IO::Compress::Deflate - Write RFC 1950 files/buffers
23032 =item Functional Interface
23036 =item deflate $input => $output [, OPTS]
23038 A filename, A filehandle, A scalar reference, An array reference, An Input
23039 FileGlob string, A filename, A filehandle, A scalar reference, An Array
23040 Reference, An Output FileGlob
23044 =item Optional Parameters
23046 C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
23058 A filename, A filehandle, A scalar reference
23060 =item Constructor Options
23062 C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
23063 Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >>
23095 =item input_line_number
23101 =item newStream([OPTS])
23103 =item deflateParams
23109 :all, :constants, :flush, :level, :strategy
23115 =item Apache::GZip Revisited
23117 =item Working with Net::FTP
23125 =item MODIFICATION HISTORY
23127 =item COPYRIGHT AND LICENSE
23131 =head2 IO::Compress::Gzip - Write RFC 1952 files/buffers
23139 =item Functional Interface
23143 =item gzip $input => $output [, OPTS]
23145 A filename, A filehandle, A scalar reference, An array reference, An Input
23146 FileGlob string, A filename, A filehandle, A scalar reference, An Array
23147 Reference, An Output FileGlob
23151 =item Optional Parameters
23153 C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
23165 A filename, A filehandle, A scalar reference
23167 =item Constructor Options
23169 C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
23170 Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Minimal => 0|1 >>,
23171 C<< Comment => $comment >>, C<< Name => $string >>, C<< Time => $number >>,
23172 C<< TextFlag => 0|1 >>, C<< HeaderCRC => 0|1 >>, C<< OS_Code => $value >>,
23173 C<< ExtraField => $data >>, C<< ExtraFlags => $value >>, C<< Strict => 0|1
23206 =item input_line_number
23212 =item newStream([OPTS])
23214 =item deflateParams
23220 :all, :constants, :flush, :level, :strategy
23226 =item Apache::GZip Revisited
23228 =item Working with Net::FTP
23236 =item MODIFICATION HISTORY
23238 =item COPYRIGHT AND LICENSE
23242 =head2 IO::Compress::RawDeflate - Write RFC 1951 files/buffers
23250 =item Functional Interface
23254 =item rawdeflate $input => $output [, OPTS]
23256 A filename, A filehandle, A scalar reference, An array reference, An Input
23257 FileGlob string, A filename, A filehandle, A scalar reference, An Array
23258 Reference, An Output FileGlob
23262 =item Optional Parameters
23264 C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
23276 A filename, A filehandle, A scalar reference
23278 =item Constructor Options
23280 C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
23281 Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >>
23313 =item input_line_number
23319 =item newStream([OPTS])
23321 =item deflateParams
23327 :all, :constants, :flush, :level, :strategy
23333 =item Apache::GZip Revisited
23335 =item Working with Net::FTP
23343 =item MODIFICATION HISTORY
23345 =item COPYRIGHT AND LICENSE
23349 =head2 IO::Compress::Zip - Write zip files/buffers
23357 =item Functional Interface
23361 =item zip $input => $output [, OPTS]
23363 A filename, A filehandle, A scalar reference, An array reference, An Input
23364 FileGlob string, A filename, A filehandle, A scalar reference, An Array
23365 Reference, An Output FileGlob
23369 =item Optional Parameters
23371 C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
23383 A filename, A filehandle, A scalar reference
23385 =item Constructor Options
23387 C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
23388 Filehandle, C<< Name => $string >>, C<< Time => $number >>, C<< ExtAttr =>
23389 $attr >>, C<< exTime => [$atime, $mtime, $ctime] >>, C<< exUnix2 => [$uid,
23390 $gid] >>, C<< Comment => $comment >>, C<< ZipComment => $comment >>, C<<
23391 Method => $method >>, C<< Stream => 0|1 >>, C<< Zip64 => 0|1 >>, C<<
23392 TextFlag => 0|1 >>, C<< ExtraFieldLocal => $data >> =item C<<
23393 ExtraFieldCentral => $data >>, C<< Minimal => 1|0 >>, C<< BlockSize100K =>
23394 number >>, C<< WorkFactor => number >>, -Level, -Strategy, C<< Strict =>
23427 =item input_line_number
23433 =item newStream([OPTS])
23435 =item deflateParams
23441 :all, :constants, :flush, :level, :strategy, :zip_method
23447 =item Apache::GZip Revisited
23449 =item Working with Net::FTP
23457 =item MODIFICATION HISTORY
23459 =item COPYRIGHT AND LICENSE
23463 =head2 IO::Dir - supply object methods for directory handles
23471 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
23472 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
23482 =head2 IO::File - supply object methods for filehandles
23492 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
23496 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode(
23507 =head2 IO::Handle - supply object methods for I/O handles
23517 new (), new_from_fd ( FD, MODE )
23521 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
23522 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
23523 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
23524 $io->blocking ( [ BOOL ] ), $io->untaint
23536 =head2 IO::Pipe - supply object methods for pipes
23546 new ( [READER, WRITER] )
23550 reader ([ARGS]), writer ([ARGS]), handles ()
23560 =head2 IO::Poll - Object interface to system poll call
23570 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
23571 IO ), handles( [ EVENT_MASK ] )
23581 =head2 IO::Seekable - supply seek based methods for I/O objects
23589 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
23590 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
23599 =head2 IO::Select - OO interface to the select system call
23609 new ( [ HANDLES ] )
23613 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
23614 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
23615 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
23625 =head2 IO::Socket - Object interface to socket communications
23639 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
23640 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
23650 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
23666 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
23679 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
23693 hostpath(), peerpath()
23703 =head2 IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip)
23712 RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip
23714 =item Functional Interface
23718 =item anyinflate $input => $output [, OPTS]
23720 A filename, A filehandle, A scalar reference, An array reference, An Input
23721 FileGlob string, A filename, A filehandle, A scalar reference, An Array
23722 Reference, An Output FileGlob
23726 =item Optional Parameters
23728 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
23729 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
23741 A filename, A filehandle, A scalar reference
23743 =item Constructor Options
23745 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
23746 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
23747 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1
23748 >>, C<< ParseExtra => 0|1 >> If the gzip FEXTRA header field is present and
23749 this option is set, it will force the module to check that it conforms to
23750 the sub-field structure as defined in RFC 1952
23772 =item getHeaderInfo
23786 =item input_line_number
23806 =item Working with Net::FTP
23814 =item MODIFICATION HISTORY
23816 =item COPYRIGHT AND LICENSE
23820 =head2 IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop
23829 RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip, bzip2, lzop, lzf
23831 =item Functional Interface
23835 =item anyuncompress $input => $output [, OPTS]
23837 A filename, A filehandle, A scalar reference, An array reference, An Input
23838 FileGlob string, A filename, A filehandle, A scalar reference, An Array
23839 Reference, An Output FileGlob
23843 =item Optional Parameters
23845 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
23846 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
23858 A filename, A filehandle, A scalar reference
23860 =item Constructor Options
23862 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
23863 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
23864 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1
23885 =item getHeaderInfo
23899 =item input_line_number
23921 =item MODIFICATION HISTORY
23923 =item COPYRIGHT AND LICENSE
23927 =head2 IO::Uncompress::Base - Base Class for IO::Uncompress modules
23939 =item MODIFICATION HISTORY
23941 =item COPYRIGHT AND LICENSE
23945 =head2 IO::Uncompress::Gunzip - Read RFC 1952 files/buffers
23953 =item Functional Interface
23957 =item gunzip $input => $output [, OPTS]
23959 A filename, A filehandle, A scalar reference, An array reference, An Input
23960 FileGlob string, A filename, A filehandle, A scalar reference, An Array
23961 Reference, An Output FileGlob
23965 =item Optional Parameters
23967 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
23968 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
23980 A filename, A filehandle, A scalar reference
23982 =item Constructor Options
23984 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
23985 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
23986 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< ParseExtra => 0|1
23987 >> If the gzip FEXTRA header field is present and this option is set, it
23988 will force the module to check that it conforms to the sub-field structure
23989 as defined in RFC 1952
24011 =item getHeaderInfo
24027 =item input_line_number
24047 =item Working with Net::FTP
24055 =item MODIFICATION HISTORY
24057 =item COPYRIGHT AND LICENSE
24061 =head2 IO::Uncompress::Inflate - Read RFC 1950 files/buffers
24069 =item Functional Interface
24073 =item inflate $input => $output [, OPTS]
24075 A filename, A filehandle, A scalar reference, An array reference, An Input
24076 FileGlob string, A filename, A filehandle, A scalar reference, An Array
24077 Reference, An Output FileGlob
24081 =item Optional Parameters
24083 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
24084 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
24096 A filename, A filehandle, A scalar reference
24098 =item Constructor Options
24100 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
24101 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
24102 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>
24124 =item getHeaderInfo
24138 =item input_line_number
24158 =item Working with Net::FTP
24166 =item MODIFICATION HISTORY
24168 =item COPYRIGHT AND LICENSE
24172 =head2 IO::Uncompress::RawInflate - Read RFC 1951 files/buffers
24180 =item Functional Interface
24184 =item rawinflate $input => $output [, OPTS]
24186 A filename, A filehandle, A scalar reference, An array reference, An Input
24187 FileGlob string, A filename, A filehandle, A scalar reference, An Array
24188 Reference, An Output FileGlob
24192 =item Optional Parameters
24194 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
24195 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
24207 A filename, A filehandle, A scalar reference
24209 =item Constructor Options
24211 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
24212 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
24213 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>
24235 =item getHeaderInfo
24249 =item input_line_number
24269 =item Working with Net::FTP
24277 =item MODIFICATION HISTORY
24279 =item COPYRIGHT AND LICENSE
24283 =head2 IO::Uncompress::Unzip - Read zip files/buffers
24291 =item Functional Interface
24295 =item unzip $input => $output [, OPTS]
24297 A filename, A filehandle, A scalar reference, An array reference, An Input
24298 FileGlob string, A filename, A filehandle, A scalar reference, An Array
24299 Reference, An Output FileGlob
24303 =item Optional Parameters
24305 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
24306 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
24318 A filename, A filehandle, A scalar reference
24320 =item Constructor Options
24322 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
24323 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
24324 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>
24346 =item getHeaderInfo
24360 =item input_line_number
24380 =item Working with Net::FTP
24382 =item Walking through a zip file
24390 =item MODIFICATION HISTORY
24392 =item COPYRIGHT AND LICENSE
24396 =head2 IO::Zlib - IO:: style interface to L<Compress::Zlib>
24408 =item OBJECT METHODS
24410 open ( FILENAME, MODE ), opened, close, getc, getline, getlines, print (
24411 ARGS... ), read ( BUF, NBYTES, [OFFSET] ), eof, seek ( OFFSET, WHENCE ),
24412 tell, setpos ( POS ), getpos ( POS )
24414 =item USING THE EXTERNAL GZIP
24416 =item CLASS METHODS
24418 has_Compress_Zlib, gzip_external, gzip_used, gzip_read_open,
24423 IO::Zlib::getlines: must be called in list context,
24424 IO::Zlib::gzopen_external: mode '...' is illegal, IO::Zlib::import: '...'
24425 is illegal, IO::Zlib::import: ':gzip_external' requires an argument,
24426 IO::Zlib::import: 'gzip_read_open' requires an argument, IO::Zlib::import:
24427 'gzip_read' '...' is illegal, IO::Zlib::import: 'gzip_write_open' requires
24428 an argument, IO::Zlib::import: 'gzip_write_open' '...' is illegal,
24429 IO::Zlib::import: no Compress::Zlib and no external gzip, IO::Zlib::open:
24430 needs a filename, IO::Zlib::READ: NBYTES must be specified,
24431 IO::Zlib::WRITE: too long LENGTH
24441 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
24450 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
24451 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
24461 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
24471 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
24475 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode(
24486 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
24497 new (), new_from_fd ( FD, MODE )
24501 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
24502 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
24503 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
24504 $io->blocking ( [ BOOL ] ), $io->untaint
24516 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
24526 new ( [READER, WRITER] )
24530 reader ([ARGS]), writer ([ARGS]), handles ()
24540 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
24550 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
24551 IO ), handles( [ EVENT_MASK ] )
24561 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
24570 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
24571 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
24580 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
24591 new ( [ HANDLES ] )
24595 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
24596 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
24597 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
24607 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
24622 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
24623 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
24633 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
24634 AF_INET domain sockets
24650 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
24663 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
24664 AF_UNIX domain sockets
24678 hostpath(), peerpath()
24688 =head2 IO_Compress_Base::lib::File::GlobMapper, File::GlobMapper - Extend
24689 File Glob to Allow Input and Output Files
24699 =item Behind The Scenes
24703 =item Input File Glob
24705 B<~>, B<~user>, B<.>, B<*>, B<?>, B<\>, B<[]>, B<{,}>, B<()>
24707 =item Output File Glob
24711 =item Returned Data
24719 =item A Rename script
24721 =item A few example globmaps
24729 =item COPYRIGHT AND LICENSE
24733 =head2 IO_Compress_Base::lib::IO::Compress::Base, IO::Compress::Base - Base
24734 Class for IO::Compress modules
24746 =item MODIFICATION HISTORY
24748 =item COPYRIGHT AND LICENSE
24752 =head2 IO_Compress_Base::lib::IO::Uncompress::AnyUncompress,
24753 IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop
24762 RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip, bzip2, lzop, lzf
24764 =item Functional Interface
24768 =item anyuncompress $input => $output [, OPTS]
24770 A filename, A filehandle, A scalar reference, An array reference, An Input
24771 FileGlob string, A filename, A filehandle, A scalar reference, An Array
24772 Reference, An Output FileGlob
24776 =item Optional Parameters
24778 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
24779 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
24791 A filename, A filehandle, A scalar reference
24793 =item Constructor Options
24795 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
24796 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
24797 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1
24818 =item getHeaderInfo
24832 =item input_line_number
24854 =item MODIFICATION HISTORY
24856 =item COPYRIGHT AND LICENSE
24860 =head2 IO_Compress_Base::lib::IO::Uncompress::Base, IO::Uncompress::Base -
24861 Base Class for IO::Uncompress modules
24873 =item MODIFICATION HISTORY
24875 =item COPYRIGHT AND LICENSE
24879 =head2 IO_Compress_Base::pod::FAQ, IO::Compress::Base::FAQ -- Frequently
24880 Asked Questions about IO::Compress::Base
24888 =item Compatibility with Unix compress/uncompress.
24890 =item Accessing .tar.Z files
24892 =item Accessing Zip Files
24894 =item Compressed files and Net::FTP
24896 =item How do I recompress using a different compression?
24898 =item Using C<InputLength> to uncompress data embedded in a larger
24907 =item MODIFICATION HISTORY
24909 =item COPYRIGHT AND LICENSE
24913 =head2 IO_Compress_Zlib::IO::Compress::Deflate, IO::Compress::Deflate -
24914 Write RFC 1950 files/buffers
24922 =item Functional Interface
24926 =item deflate $input => $output [, OPTS]
24928 A filename, A filehandle, A scalar reference, An array reference, An Input
24929 FileGlob string, A filename, A filehandle, A scalar reference, An Array
24930 Reference, An Output FileGlob
24934 =item Optional Parameters
24936 C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
24948 A filename, A filehandle, A scalar reference
24950 =item Constructor Options
24952 C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
24953 Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >>
24985 =item input_line_number
24991 =item newStream([OPTS])
24993 =item deflateParams
24999 :all, :constants, :flush, :level, :strategy
25005 =item Apache::GZip Revisited
25007 =item Working with Net::FTP
25015 =item MODIFICATION HISTORY
25017 =item COPYRIGHT AND LICENSE
25021 =head2 IO_Compress_Zlib::IO::Compress::Gzip, IO::Compress::Gzip - Write RFC
25030 =item Functional Interface
25034 =item gzip $input => $output [, OPTS]
25036 A filename, A filehandle, A scalar reference, An array reference, An Input
25037 FileGlob string, A filename, A filehandle, A scalar reference, An Array
25038 Reference, An Output FileGlob
25042 =item Optional Parameters
25044 C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
25056 A filename, A filehandle, A scalar reference
25058 =item Constructor Options
25060 C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
25061 Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Minimal => 0|1 >>,
25062 C<< Comment => $comment >>, C<< Name => $string >>, C<< Time => $number >>,
25063 C<< TextFlag => 0|1 >>, C<< HeaderCRC => 0|1 >>, C<< OS_Code => $value >>,
25064 C<< ExtraField => $data >>, C<< ExtraFlags => $value >>, C<< Strict => 0|1
25097 =item input_line_number
25103 =item newStream([OPTS])
25105 =item deflateParams
25111 :all, :constants, :flush, :level, :strategy
25117 =item Apache::GZip Revisited
25119 =item Working with Net::FTP
25127 =item MODIFICATION HISTORY
25129 =item COPYRIGHT AND LICENSE
25133 =head2 IO_Compress_Zlib::IO::Compress::RawDeflate, IO::Compress::RawDeflate
25134 - Write RFC 1951 files/buffers
25142 =item Functional Interface
25146 =item rawdeflate $input => $output [, OPTS]
25148 A filename, A filehandle, A scalar reference, An array reference, An Input
25149 FileGlob string, A filename, A filehandle, A scalar reference, An Array
25150 Reference, An Output FileGlob
25154 =item Optional Parameters
25156 C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
25168 A filename, A filehandle, A scalar reference
25170 =item Constructor Options
25172 C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
25173 Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >>
25205 =item input_line_number
25211 =item newStream([OPTS])
25213 =item deflateParams
25219 :all, :constants, :flush, :level, :strategy
25225 =item Apache::GZip Revisited
25227 =item Working with Net::FTP
25235 =item MODIFICATION HISTORY
25237 =item COPYRIGHT AND LICENSE
25241 =head2 IO_Compress_Zlib::IO::Compress::Zip, IO::Compress::Zip - Write zip
25250 =item Functional Interface
25254 =item zip $input => $output [, OPTS]
25256 A filename, A filehandle, A scalar reference, An array reference, An Input
25257 FileGlob string, A filename, A filehandle, A scalar reference, An Array
25258 Reference, An Output FileGlob
25262 =item Optional Parameters
25264 C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
25276 A filename, A filehandle, A scalar reference
25278 =item Constructor Options
25280 C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
25281 Filehandle, C<< Name => $string >>, C<< Time => $number >>, C<< ExtAttr =>
25282 $attr >>, C<< exTime => [$atime, $mtime, $ctime] >>, C<< exUnix2 => [$uid,
25283 $gid] >>, C<< Comment => $comment >>, C<< ZipComment => $comment >>, C<<
25284 Method => $method >>, C<< Stream => 0|1 >>, C<< Zip64 => 0|1 >>, C<<
25285 TextFlag => 0|1 >>, C<< ExtraFieldLocal => $data >> =item C<<
25286 ExtraFieldCentral => $data >>, C<< Minimal => 1|0 >>, C<< BlockSize100K =>
25287 number >>, C<< WorkFactor => number >>, -Level, -Strategy, C<< Strict =>
25320 =item input_line_number
25326 =item newStream([OPTS])
25328 =item deflateParams
25334 :all, :constants, :flush, :level, :strategy, :zip_method
25340 =item Apache::GZip Revisited
25342 =item Working with Net::FTP
25350 =item MODIFICATION HISTORY
25352 =item COPYRIGHT AND LICENSE
25356 =head2 IO_Compress_Zlib::IO::Uncompress::AnyInflate,
25357 IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) file/buffer
25365 RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip
25367 =item Functional Interface
25371 =item anyinflate $input => $output [, OPTS]
25373 A filename, A filehandle, A scalar reference, An array reference, An Input
25374 FileGlob string, A filename, A filehandle, A scalar reference, An Array
25375 Reference, An Output FileGlob
25379 =item Optional Parameters
25381 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
25382 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
25394 A filename, A filehandle, A scalar reference
25396 =item Constructor Options
25398 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
25399 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
25400 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1
25401 >>, C<< ParseExtra => 0|1 >> If the gzip FEXTRA header field is present and
25402 this option is set, it will force the module to check that it conforms to
25403 the sub-field structure as defined in RFC 1952
25425 =item getHeaderInfo
25439 =item input_line_number
25459 =item Working with Net::FTP
25467 =item MODIFICATION HISTORY
25469 =item COPYRIGHT AND LICENSE
25473 =head2 IO_Compress_Zlib::IO::Uncompress::Gunzip, IO::Uncompress::Gunzip -
25474 Read RFC 1952 files/buffers
25482 =item Functional Interface
25486 =item gunzip $input => $output [, OPTS]
25488 A filename, A filehandle, A scalar reference, An array reference, An Input
25489 FileGlob string, A filename, A filehandle, A scalar reference, An Array
25490 Reference, An Output FileGlob
25494 =item Optional Parameters
25496 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
25497 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
25509 A filename, A filehandle, A scalar reference
25511 =item Constructor Options
25513 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
25514 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
25515 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< ParseExtra => 0|1
25516 >> If the gzip FEXTRA header field is present and this option is set, it
25517 will force the module to check that it conforms to the sub-field structure
25518 as defined in RFC 1952
25540 =item getHeaderInfo
25556 =item input_line_number
25576 =item Working with Net::FTP
25584 =item MODIFICATION HISTORY
25586 =item COPYRIGHT AND LICENSE
25590 =head2 IO_Compress_Zlib::IO::Uncompress::Inflate, IO::Uncompress::Inflate -
25591 Read RFC 1950 files/buffers
25599 =item Functional Interface
25603 =item inflate $input => $output [, OPTS]
25605 A filename, A filehandle, A scalar reference, An array reference, An Input
25606 FileGlob string, A filename, A filehandle, A scalar reference, An Array
25607 Reference, An Output FileGlob
25611 =item Optional Parameters
25613 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
25614 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
25626 A filename, A filehandle, A scalar reference
25628 =item Constructor Options
25630 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
25631 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
25632 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>
25654 =item getHeaderInfo
25668 =item input_line_number
25688 =item Working with Net::FTP
25696 =item MODIFICATION HISTORY
25698 =item COPYRIGHT AND LICENSE
25702 =head2 IO_Compress_Zlib::IO::Uncompress::RawInflate,
25703 IO::Uncompress::RawInflate - Read RFC 1951 files/buffers
25711 =item Functional Interface
25715 =item rawinflate $input => $output [, OPTS]
25717 A filename, A filehandle, A scalar reference, An array reference, An Input
25718 FileGlob string, A filename, A filehandle, A scalar reference, An Array
25719 Reference, An Output FileGlob
25723 =item Optional Parameters
25725 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
25726 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
25738 A filename, A filehandle, A scalar reference
25740 =item Constructor Options
25742 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
25743 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
25744 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>
25766 =item getHeaderInfo
25780 =item input_line_number
25800 =item Working with Net::FTP
25808 =item MODIFICATION HISTORY
25810 =item COPYRIGHT AND LICENSE
25814 =head2 IO_Compress_Zlib::IO::Uncompress::Unzip, IO::Uncompress::Unzip -
25815 Read zip files/buffers
25823 =item Functional Interface
25827 =item unzip $input => $output [, OPTS]
25829 A filename, A filehandle, A scalar reference, An array reference, An Input
25830 FileGlob string, A filename, A filehandle, A scalar reference, An Array
25831 Reference, An Output FileGlob
25835 =item Optional Parameters
25837 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
25838 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
25850 A filename, A filehandle, A scalar reference
25852 =item Constructor Options
25854 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
25855 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
25856 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>
25878 =item getHeaderInfo
25892 =item input_line_number
25912 =item Working with Net::FTP
25914 =item Walking through a zip file
25922 =item MODIFICATION HISTORY
25924 =item COPYRIGHT AND LICENSE
25928 =head2 IO_Compress_Zlib::pod::FAQ, IO::Compress::Zlib::FAQ -- Frequently
25929 Asked Questions about IO::Compress::Zlib
25937 =item Compatibility with Unix compress/uncompress.
25939 =item Accessing .tar.Z files
25941 =item Accessing Zip Files
25943 =item Compressed files and Net::FTP
25945 =item How do I recompress using a different compression?
25947 =item Apache::GZip Revisited
25949 =item Using C<InputLength> to uncompress data embedded in a larger
25958 =item MODIFICATION HISTORY
25960 =item COPYRIGHT AND LICENSE
25964 =head2 IPC::Msg - SysV Msg IPC object class
25974 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
25975 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
25986 =head2 IPC::Open2, open2 - open a process for both reading and writing
26000 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
26011 L<IPC::Open2>, L<IPC::Run>
26017 =head2 IPC::Semaphore - SysV Semaphore IPC object class
26027 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
26028 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
26029 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
26040 =head2 IPC::SharedMem - SysV Shared Memory IPC object class
26050 new ( KEY , SIZE , FLAGS ), id, read ( POS, SIZE ), write ( STRING, POS,
26051 SIZE ), remove, is_removed, stat, attach ( [FLAG] ), detach, addr
26061 =head2 IPC::SysV - System V IPC constants and system calls
26069 ftok( PATH ), ftok( PATH, ID ), shmat( ID, ADDR, FLAG ), shmdt( ADDR ),
26070 memread( ADDR, VAR, POS, SIZE ), memwrite( ADDR, STRING, POS, SIZE )
26080 =head2 IPC::SysV::lib::IPC::Msg, IPC::Msg - SysV Msg IPC object class
26090 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
26091 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
26102 =head2 IPC::SysV::lib::IPC::Semaphore, IPC::Semaphore - SysV Semaphore IPC
26113 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
26114 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
26115 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
26126 =head2 IPC::SysV::lib::IPC::SharedMem, IPC::SharedMem - SysV Shared Memory
26137 new ( KEY , SIZE , FLAGS ), id, read ( POS, SIZE ), write ( STRING, POS,
26138 SIZE ), remove, is_removed, stat, attach ( [FLAG] ), detach, addr
26148 =head2 IPC::SysV::lib::IPC::SysV, IPC::SysV - System V IPC constants and
26157 ftok( PATH ), ftok( PATH, ID ), shmat( ID, ADDR, FLAG ), shmdt( ADDR ),
26158 memread( ADDR, VAR, POS, SIZE ), memwrite( ADDR, STRING, POS, SIZE )
26168 =head2 IPCmd, IPC::Cmd - finding and running system commands made easy
26176 =item CLASS METHODS
26180 =item $ipc_run_version = IPC::Cmd->can_use_ipc_run( [VERBOSE] )
26188 =item $ipc_open3_version = IPC::Cmd->can_use_ipc_open3( [VERBOSE] )
26194 =item $bool = IPC::Cmd->can_capture_buffer
26204 =item $path = can_run( PROGRAM );
26212 =item $ok | ($ok, $err, $full_buf, $stdout_buff, $stderr_buff) = run(
26213 command => COMMAND, [verbose => BOOL, buffer => \$SCALAR, timeout => DIGIT]
26216 command, verbose, buffer, timeout, success, error message, full_buffer,
26217 out_buffer, error_buffer
26231 =item Global Variables
26235 =item $IPC::Cmd::VERBOSE
26237 =item $IPC::Cmd::USE_IPC_RUN
26239 =item $IPC::Cmd::USE_IPC_OPEN3
26241 =item $IPC::Cmd::WARN
26247 Whitespace and IPC::Open3 / system(), Whitespace and IPC::Run, IO Redirect,
26248 Interleaving STDOUT/STDERR
26252 =item ACKNOWLEDGEMENTS
26262 =head2 List::Util - A selection of general-utility list subroutines
26270 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
26271 BLOCK LIST, shuffle LIST, sum LIST
26275 =item SUGGESTED ADDITIONS
26283 =head2 List::Utilib::List::Util, List::Util - A selection of
26284 general-utility list subroutines
26292 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
26293 BLOCK LIST, shuffle LIST, sum LIST
26297 =item SUGGESTED ADDITIONS
26305 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
26306 general-utility scalar subroutines
26314 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
26315 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
26316 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
26326 =head2 Locale::Constants - constants for Locale codes
26334 =item KNOWN BUGS AND LIMITATIONS
26338 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
26346 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
26354 B<alpha-2>, B<alpha-3>, B<numeric>
26356 =item CONVERSION ROUTINES
26358 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
26359 country_code2code( CODE, CODESET, CODESET )
26361 =item QUERY ROUTINES
26363 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
26365 =item SEMI-PRIVATE ROUTINES
26371 =item rename_country
26379 =item KNOWN BUGS AND LIMITATIONS
26383 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
26384 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
26385 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
26386 http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
26394 =head2 Locale::Currency - ISO three letter codes for currency
26395 identification (ISO 4217)
26405 =item CONVERSION ROUTINES
26407 code2currency(), currency2code()
26409 =item QUERY ROUTINES
26411 C<all_currency_codes()>, C<all_currency_names()>
26415 =item KNOWN BUGS AND LIMITATIONS
26419 Locale::Country, Locale::Script, ISO 4217:1995,
26420 http://www.bsi-global.com/iso4217currency
26428 =head2 Locale::Language - ISO two letter codes for language identification
26437 =item CONVERSION ROUTINES
26439 code2language(), language2code()
26441 =item QUERY ROUTINES
26443 C<all_language_codes()>, C<all_language_names()>
26447 =item KNOWN BUGS AND LIMITATIONS
26451 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
26452 http://lcweb.loc.gov/standards/iso639-2/langhome.html
26460 =head2 Locale::Maketext - framework for localization
26468 =item QUICK OVERVIEW
26474 =item Construction Methods
26476 =item The "maketext" Method
26478 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
26480 =item Utility Methods
26482 $language->quant($number, $singular), $language->quant($number, $singular,
26483 $plural), $language->quant($number, $singular, $plural, $negative),
26484 $language->numf($number), $language->sprintf($format, @items),
26485 $language->language_tag(), $language->encoding()
26487 =item Language Handle Attributes and Internals
26491 =item LANGUAGE CLASS HIERARCHIES
26493 =item ENTRIES IN EACH LEXICON
26495 =item BRACKET NOTATION
26497 =item AUTO LEXICONS
26499 =item CONTROLLING LOOKUP FAILURE
26501 =item HOW TO USE MAKETEXT
26505 =item COPYRIGHT AND DISCLAIMER
26511 =head2 Locale::Maketext::Simple - Simple interface to
26512 Locale::Maketext::Lexicon
26546 =item ACKNOWLEDGMENTS
26556 =item The "MIT" License
26562 =head2 Locale::Maketext::TPJ13 -- article about software localization
26570 =item Localization and Perl: gettext breaks, Maketext fixes
26574 =item A Localization Horror Story: It Could Happen To You
26576 =item The Linguistic View
26578 =item Breaking gettext
26580 =item Replacing gettext
26582 =item Buzzwords: Abstraction and Encapsulation
26584 =item Buzzword: Isomorphism
26586 =item Buzzword: Inheritance
26588 =item Buzzword: Concision
26590 =item The Devil in the Details
26592 =item The Proof in the Pudding: Localizing Web Sites
26600 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
26608 B<alpha-2>, B<alpha-3>, B<numeric>
26612 =item SPECIAL CODES
26616 =item CONVERSION ROUTINES
26618 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
26619 script_code2code( CODE, CODESET, CODESET )
26621 =item QUERY ROUTINES
26623 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
26627 =item KNOWN BUGS AND LIMITATIONS
26631 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
26632 http://www.evertype.com/standards/iso15924/
26640 =head2 Log::Message - A generic message storing mechanism;
26650 Log::Message, Log::Message::Item, Log::Message::Handlers,
26651 Log::Message::Config
26655 config, private, verbose, tag, level, remove, chrono
26675 message, tag, level, extra
26683 tag, level, message, amount, chrono, remove
26711 =item Acknowledgements
26717 =head2 Log::Message::Config - Configuration options for Log::Message
26729 =item Acknowledgements
26735 =head2 Log::Message::Handlers - Message handlers for Log::Message
26743 =item Default Handlers
26797 =item Custom Handlers
26803 =item Acknowledgements
26809 =head2 Log::Message::Item - Message objects for Log::Message
26817 =item Methods and Accessors
26845 =item Acknowledgements
26851 =head2 Log::Message::Simple
26863 =item msg("message string" [,VERBOSE])
26865 =item debug("message string" [,VERBOSE])
26867 =item error("error string" [,VERBOSE])
26887 =item CLASS METHODS
26891 =item Log::Message::Simple->stack()
26893 =item Log::Message::Simple->stack_as_string([TRACE])
26895 =item Log::Message::Simple->flush()
26903 =item GLOBAL VARIABLES
26905 $ERROR_FH, $MSG_FH, $DEBUG_FH, $STACKTRACE_ON_ERROR
26909 =head2 MIME::Base64 - Encoding and decoding of base64 strings
26917 encode_base64($str), encode_base64($str, $eol);, decode_base64($str)
26921 Premature end of base64 data, Premature padding of base64 data, Wide
26922 character in subroutine entry
26932 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
26933 of quoted-printable strings
26941 encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode),
26950 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
26959 encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode),
26968 =head2 Math::BigFloat - Arbitrary size floating point math package
26978 =item Canonical notation
26982 =item C<mantissa()>, C<exponent()> and C<parts()>
26984 =item Accuracy vs. Precision
26988 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround ( +$scale
26989 ), fround ( -$scale ) and fround ( 0 )
27019 =item Autocreating constants
27025 =item Using Math::BigInt::Lite
27035 stringify, bstr(), bdiv, brsft, Modifying and =, bpow, precision() vs.
27046 =head2 Math::BigInt - Arbitrary size integer/float math package
27084 =item is_one()/is_zero()/is_nan()/is_inf()
27086 =item is_pos()/is_neg()/is_positive()/is_negative()
27088 $x->is_pos(); # true if > 0
27089 $x->is_neg(); # true if < 0
27091 =item is_odd()/is_even()/is_int()
27187 =item as_int()/as_number()
27201 =item upgrade()/downgrade()
27209 =item ACCURACY and PRECISION
27219 =item Rounding mode R
27221 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', 'common', Precision,
27222 Accuracy (significant digits), Setting/Accessing, Creating numbers, Usage,
27223 Precedence, Overriding globals, Local settings, Rounding, Default values,
27228 =item Infinity and Not a Number
27230 oct()/hex(), log(-inf), exp(), cos(), sin(), atan2()
27240 =item mantissa(), exponent() and parts()
27248 =item Autocreating constants
27254 =item Alternative math libraries
27260 =item Subclassing Math::BigInt
27268 bsqrt(), div(), blog(), bexp()
27276 bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling,
27277 Modifying and =, bpow, Overloading -$x, Mixing different object types,
27288 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
27300 =item WRAP YOUR OWN
27304 This program is free software; you may redistribute it and/or modify it
27306 the same terms as Perl itself.
27314 =head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code
27336 This program is free software; you may redistribute it and/or modify it
27338 the same terms as Perl itself.
27346 =head2 Math::BigInt::FastCalc - Math::BigInt::Calc with some XS for more
27361 This program is free software; you may redistribute it and/or modify it
27363 the same terms as Perl itself.
27371 =head2 Math::BigRat - Arbitrary big rational numbers
27393 =item denominator()
27395 $d = $x->denominator();
27401 =item as_int()/as_number()
27411 =item from_hex()/from_bin()/from_oct()
27421 =item bround()/round()/bfround()
27431 =item is_pos()/is_positive()
27433 =item is_neg()/is_negative()
27455 =item badd()/bmul()/bsub()/bdiv()/bdec()/binc()
27459 =item bstr()/bsstr()
27461 =item bacmp()/bcmp()
27463 =item blsft()/brsft()
27479 inf handling (partial), NaN handling (partial), rounding (not implemented
27480 except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(),
27481 blog(), bmodinv() and bmodpow() (partial)
27491 =head2 Math::Complex - complex numbers and associated mathematical
27508 =item CHANGED IN PERL 5.6
27524 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
27526 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
27538 =head2 Math::Trig - trigonometric functions
27546 =item TRIGONOMETRIC FUNCTIONS
27552 =item ERRORS DUE TO DIVISION BY ZERO
27554 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
27558 =item PLANE ANGLE CONVERSIONS
27560 deg2rad, grad2rad, rad2deg, grad2deg, deg2grad, rad2grad, rad2rad, deg2deg,
27563 =item RADIAL COORDINATE CONVERSIONS
27567 =item COORDINATE SYSTEMS
27569 =item 3-D ANGLE CONVERSIONS
27571 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
27572 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
27576 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
27580 =item great_circle_distance
27582 =item great_circle_direction
27584 =item great_circle_bearing
27586 =item great_circle_destination
27588 =item great_circle_midpoint
27590 =item great_circle_waypoint
27598 =item CAVEAT FOR GREAT CIRCLE FORMULAS
27600 =item Real-valued asin and acos
27602 asin_real, acos_real
27614 =head2 Memoize - Make functions faster by trading space for time
27632 =item C<SCALAR_CACHE>, C<LIST_CACHE>
27634 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
27638 =item OTHER FACILITIES
27644 =item C<flush_cache>
27650 =item PERSISTENT CACHE SUPPORT
27652 =item EXPIRATION SUPPORT
27660 =item COPYRIGHT AND LICENSE
27666 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
27675 =head2 Memoize::Expire - Plug-in module for automatic expiration of
27686 TIEHASH, EXISTS, STORE
27698 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
27706 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
27714 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
27723 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
27732 =head2 Memoize::Storable - store Memoized data in Storable database
27740 =head2 Module::Build - Build and install Perl modules
27748 =item GUIDE TO DOCUMENTATION
27750 General Usage (L<Module::Build>), Authoring Reference
27751 (L<Module::Build::Authoring>), API Reference (L<Module::Build::API>),
27752 Cookbook (L<Module::Build::Cookbook>)
27756 build, clean, code, config_data, diff, dist, distcheck, distclean, distdir,
27757 distmeta, distsign, disttest, docs, fakeinstall, help, html, install,
27758 manifest, manpages, pardist, ppd, ppmdist, prereq_report, pure_install,
27759 realclean, retest, skipcheck, test, testall, testcover, testdb, testpod,
27760 testpodcoverage, versioninstall
27766 =item Command Line Options
27768 quiet, use_rcfile, verbose, allow_mb_mismatch
27770 =item Default Options File (F<.modulebuildrc>)
27774 =item INSTALL PATHS
27776 lib, arch, script, bin, bindoc, libdoc, binhtml, libhtml, installdirs,
27777 install_path, install_base, destdir, prefix
27793 =head2 Module::Build::API - API Reference for Module Authors
27803 current(), new(), add_to_cleanup, auto_features, autosplit, build_class,
27804 build_requires, create_packlist, c_source, conflicts, create_makefile_pl,
27805 create_readme, dist_abstract, dist_author, dist_name, dist_version,
27806 dist_version_from, dynamic_config, extra_compiler_flags,
27807 extra_linker_flags, get_options, type, store, default, include_dirs,
27808 install_path, installdirs, license, apache, artistic, artistic_2, bsd, gpl,
27809 lgpl, mit, mozilla, open_source, perl, restrictive, unrestricted, meta_add,
27810 meta_merge, module_name, PL_files, pm_files, pod_files, recommends,
27811 recursive_test_files, requires, script_files, sign, test_files,
27812 use_tap_harness, tap_harness_args, xs_files, new_from_context(%args),
27813 resume(), subclass()
27817 add_build_element($type), add_to_cleanup(@files), args(),
27818 autosplit_file($from, $to), base_dir(), build_requires(), cbuilder(),
27819 check_installed_status($module, $version), check_installed_version($module,
27820 $version), compare_versions($v1, $op, $v2), config($key), config($key,
27821 $value), config() [deprecated], config_data($name), config_data($name =>
27822 $value), conflicts(), contains_pod($file), copy_if_modified(%parameters),
27823 create_build_script(), current_action(), depends_on(@actions),
27824 dir_contains($first_dir, $second_dir), dispatch($action, %args),
27825 dist_dir(), dist_name(), dist_version(), do_system($cmd, @args),
27826 feature($name), feature($name => $value), fix_shebang_line(@files),
27827 have_c_compiler(), install_base_relpaths(), install_base_relpaths($type),
27828 install_base_relpaths($type => $path), install_destination($type),
27829 install_path(), install_path($type), install_path($type => $path),
27830 install_types(), invoked_action(), notes(), notes($key), notes($key =>
27831 $value), orig_dir(), os_type(), is_vmsish(), is_windowsish(), is_unixish(),
27832 prefix_relpaths(), prefix_relpaths($installdirs),
27833 prefix_relpaths($installdirs, $type), prefix_relpaths($installdirs, $type
27834 => $path), prepare_metadata(), prereq_failures(), prereq_report(),
27835 prompt($message, $default), recommends(), requires(), rscan_dir($dir,
27836 $pattern), runtime_params(), runtime_params($key), script_files(),
27837 up_to_date($source_file, $derived_file), up_to_date(\@source_files,
27838 \@derived_files), y_n($message, $default)
27840 =item Autogenerated Accessors
27842 PL_files(), allow_mb_mismatch(), autosplit(), base_dir(), bindoc_dirs(),
27843 blib(), build_bat(), build_class(), build_elements(), build_requires(),
27844 build_script(), c_source(), config_dir(), configure_requires(),
27845 conflicts(), create_makefile_pl(), create_packlist(), create_readme(),
27846 debugger(), destdir(), get_options(), html_css(), include_dirs(),
27847 install_base(), install_sets(), installdirs(), libdoc_dirs(), license(),
27848 magic_number(), mb_version(), meta_add(), meta_merge(), metafile(),
27849 module_name(), orig_dir(), original_prefix(), perl(), pm_files(),
27850 pod_files(), pollute(), prefix(), prereq_action_types(), program_name(),
27851 quiet(), recommends(), recurse_into(), recursive_test_files(), requires(),
27852 scripts(), sign(), tap_harness_args(), test_file_exts(), use_rcfile(),
27853 use_tap_harness(), verbose(), xs_files()
27857 =item MODULE METADATA
27859 keywords, resources
27869 =head2 Module::Build::Authoring - Authoring Module::Build modules
27879 =item PREREQUISITES
27883 =item Types of prerequisites
27885 configure_requires, build_requires, requires, recommends, conflicts
27887 =item Format of prerequisites
27889 =item XS Extensions
27893 =item SAVING CONFIGURATION INFORMATION
27895 =item STARTING MODULE DEVELOPMENT
27907 =head2 Module::Build::Base - Default methods for Module::Build
27923 =head2 Module::Build::Compat - Compatibility with ExtUtils::MakeMaker
27933 create_makefile_pl($style, $build), small, passthrough, traditional,
27934 run_build_pl(args => \@ARGV), args, script, write_makefile(), makefile
27946 =head2 Module::Build::ConfigData - Configuration for Module::Build
27956 config($name), feature($name), set_config($name, $value),
27957 set_feature($name, $value), config_names(), feature_names(),
27958 auto_feature_names(), write()
27964 =head2 Module::Build::Cookbook - Examples of Module::Build Usage
27970 =item BASIC RECIPES
27974 =item Installing modules that use Module::Build
27976 =item Modifying Config.pm values
27978 =item Installing modules using the programmatic interface
27980 =item Installing to a temporary directory
27982 =item Installing to a non-standard directory
27984 =item Installing in the same location as ExtUtils::MakeMaker
27986 =item Running a single test file
27990 =item ADVANCED RECIPES
27994 =item Making a CPAN.pm-compatible distribution
27996 =item Changing the order of the build process
27998 =item Adding new file types to the build process
28000 =item Adding new elements to the install process
28004 =item EXAMPLES ON CPAN
28008 =item SVN-Notify-Mirror
28010 1. Using C<auto_features>, I check to see whether two optional modules are
28011 available - SVN::Notify::Config and Net::SSH;, 2. If the S::N::Config
28012 module is loaded, I automatically generate testfiles for it during Build
28013 (using the C<PL_files> property), 3. If the C<ssh_feature> is available, I
28014 ask if the user wishes to perform the ssh tests (since it requires a little
28015 preliminary setup);, 4. Only if the user has C<ssh_feature> and answers yes
28016 to the testing, do I generate a test file
28018 =item Modifying an action
28030 =head2 Module::Build::ModuleInfo, ModuleInfo - Gather package and POD
28031 information from a perl module files
28037 new_from_file($filename, collect_pod => 1), new_from_module($module,
28038 collect_pod => 1, inc => \@dirs), name(), version($package), filename(),
28039 packages_inside(), pod_inside(), contains_pod(), pod($section),
28040 find_module_by_name($module, \@dirs), find_module_dir_by_name($module,
28051 =head2 Module::Build::Notes, $notes_name - Configuration for $module_name
28061 config(\$name), feature(\$name), set_config(\$name, \$value),
28062 set_feature(\$name, \$value), config_names(), feature_names(),
28063 auto_feature_names(), write()
28069 =head2 Module::Build::PPMMaker - Perl Package Manager file creation
28085 =head2 Module::Build::Platform::Amiga - Builder class for Amiga platforms
28097 =head2 Module::Build::Platform::Default - Stub class for unknown platforms
28109 =head2 Module::Build::Platform::EBCDIC - Builder class for EBCDIC platforms
28121 =head2 Module::Build::Platform::MPEiX - Builder class for MPEiX platforms
28133 =head2 Module::Build::Platform::MacOS - Builder class for MacOS platforms
28141 =item Overriden Methods
28143 new(), make_executable(), dispatch(), ACTION_realclean()
28153 =head2 Module::Build::Platform::RiscOS - Builder class for RiscOS platforms
28165 =head2 Module::Build::Platform::Unix - Builder class for Unix platforms
28177 =head2 Module::Build::Platform::VMS - Builder class for VMS platforms
28185 =item Overridden Methods
28219 find_perl_interpreter
28233 =head2 Module::Build::Platform::VOS - Builder class for VOS platforms
28245 =head2 Module::Build::Platform::Windows - Builder class for Windows
28258 =head2 Module::Build::Platform::aix - Builder class for AIX platform
28270 =head2 Module::Build::Platform::cygwin - Builder class for Cygwin platform
28282 =head2 Module::Build::Platform::darwin - Builder class for Mac OS X
28295 =head2 Module::Build::Platform::os2 - Builder class for OS/2 platform
28307 =head2 Module::Build::YAML - Provides just enough YAML support so that
28308 Module::Build works even if YAML.pm is not installed
28322 =head2 Module::CoreList - what modules shipped with versions of perl
28342 =head2 Module::Load - runtime require of both modules and files
28354 =item ACKNOWLEDGEMENTS
28364 =head2 Module::Load::Conditional - Looking up module information / loading
28375 =item $href = check_install( module => NAME [, version => VERSION, verbose
28378 module, version, verbose, file, dir, version, uptodate
28384 =item $bool = can_load( modules => { NAME => VERSION [,NAME => VERSION] },
28385 [verbose => BOOL, nocache => BOOL] )
28387 modules, verbose, nocache
28393 =item @list = requires( MODULE );
28399 =item Global Variables
28403 =item $Module::Load::Conditional::VERBOSE
28405 =item $Module::Load::Conditional::FIND_VERSION
28407 =item $Module::Load::Conditional::CHECK_INC_HASH
28409 =item $Module::Load::Conditional::CACHE
28411 =item $Module::Load::Conditional::ERROR
28425 =head2 Module::Loaded - mark modules as loaded or unloaded
28437 =item $bool = mark_as_loaded( PACKAGE );
28445 =item $bool = mark_as_unloaded( PACKAGE );
28451 =item $loc = is_loaded( PACKAGE );
28465 =head2 Module::Pluggable - automatically give your module the ability to
28476 =item ADVANCED USAGE
28478 =item INNER PACKAGES
28504 =item include_editor_junk
28528 =head2 Module::Pluggable::Object - automatically give your module the
28529 ability to have plugins
28549 =head2 Module::Pluggable::lib::Devel::InnerPackage, Devel::InnerPackage -
28550 find all the inner packages of a package
28562 =item list_packages <package name>
28578 =head2 Module::Pluggable::lib::Module::Pluggable, Module::Pluggable -
28579 automatically give your module the ability to have plugins
28589 =item ADVANCED USAGE
28591 =item INNER PACKAGES
28617 =item include_editor_junk
28641 =head2 Module::Pluggable::lib::Module::Pluggable::Object,
28642 Module::Pluggable::Object - automatically give your module the ability to
28663 =head2 NDBM_File - Tied access to ndbm files
28671 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
28677 =item C<ndbm store returned -1, errno 22, key "..." at ...>
28681 =item BUGS AND WARNINGS
28685 =head2 NEXT - Provide a pseudo-class NEXT (et al) that allows method
28696 =item Enforcing redispatch
28698 =item Avoiding repetitions
28700 =item Invoking all versions of a method with a single call
28702 =item Using C<EVERY> methods
28708 =item BUGS AND IRRITATIONS
28714 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
28724 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
28727 =item CLASS METHODS
28729 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
28730 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
28731 ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh ()
28741 =head2 Net::Config - Local configuration data for libnet
28751 requires_firewall HOST
28753 =item NetConfig VALUES
28755 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
28756 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
28757 ftp_int_passive, local_netmask, test_hosts, test_exists
28761 =head2 Net::Domain - Attempt to evaluate the current host's internet name
28770 hostfqdn (), domainname (), hostname (), hostdomain ()
28778 =head2 Net::FTP - FTP Client class
28790 new ([ HOST ] [, OPTIONS ])
28794 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
28795 site (ARGS), ascii, binary, rename ( OLDNAME, NEWNAME ), delete ( FILENAME
28796 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR [,
28797 RECURSE ]), mkdir ( DIR [, RECURSE ]), alloc ( SIZE [, RECORD_SIZE] ), ls (
28798 [ DIR ] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ),
28799 put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE
28800 ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ),
28801 size ( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[
28802 BYTES_PER_HASH_MARK] ), feature ( NAME ), nlst ( [ DIR ] ), list ( [ DIR ]
28803 ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [
28804 PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
28805 pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait (
28806 NON_PASV_SERVER ), abort (), quit ()
28810 =item Methods for the adventurous
28816 =item THE dataconn CLASS
28818 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
28819 bytes_read (), abort (), close ()
28821 =item UNIMPLEMENTED
28823 B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
28825 =item REPORTING BUGS
28833 http://www.csh.rit.edu/~adam/Progs/
28841 =head2 Net::NNTP - NNTP Client class
28851 new ( [ HOST ] [, OPTIONS ])
28855 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
28856 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
28857 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
28858 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
28859 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
28860 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
28861 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
28865 =item Extension methods
28867 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
28868 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
28869 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
28870 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
28879 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
28889 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
28899 new ( [ HOST ] [, OPTIONS ] 0
28903 auth ( USERNAME, PASSWORD ), user ( USER ), pass ( PASS ), login ( [ USER
28904 [, PASS ]] ), apop ( [ USER [, PASS ]] ), banner (), capa (), capabilities
28905 (), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [, FH ]
28906 ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ]
28907 ), delete ( MSGNUM ), reset (), quit ()
28919 =head2 Net::Ping - check a remote host for reachability
28931 Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos
28932 ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
28933 $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
28934 $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
28935 [ $host ] );, $p->nack( $failed_ack_host );, $p->close();,
28936 $p->port_number([$port_number]), pingecho($host [, $timeout]);
28952 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
28964 new ( [ HOST ] [, OPTIONS ] )
28968 banner (), domain (), hello ( DOMAIN ), host (), etrn ( DOMAIN ), auth (
28969 USERNAME, PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ),
28970 send_or_mail ( ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient (
28971 ADDRESS [, ADDRESS, [...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]]
28972 ), cc ( ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ),
28973 data ( [ DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [
28974 $subject ] ), quit ()
28986 =head2 Net::Time - time and daytime network client interface
28994 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
28995 PROTOCOL [, TIMEOUT]]])
29003 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
29020 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
29028 =item Where to get this document
29030 =item How to contribute to this document
29034 =item Author and Copyright Information
29042 =item Obtaining and installing libnet
29046 =item What is libnet ?
29048 =item Which version of perl do I need ?
29050 =item What other modules do I need ?
29052 =item What machines support libnet ?
29054 =item Where can I get the latest libnet release
29058 =item Using Net::FTP
29062 =item How do I download files from an FTP server ?
29064 =item How do I transfer files in binary mode ?
29066 =item How can I get the size of a file on a remote FTP server ?
29068 =item How can I get the modification time of a file on a remote FTP server
29071 =item How can I change the permissions of a file on a remote server ?
29073 =item Can I do a reget operation like the ftp command ?
29075 =item How do I get a directory listing from an FTP server ?
29077 =item Changing directory to "" does not fail ?
29079 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
29081 =item I am behind an FTP proxy firewall, but cannot access machines outside
29084 =item My ftp proxy firewall does not listen on port 21
29086 =item Is it possible to change the file permissions of a file on an FTP
29089 =item I have seen scripts call a method message, but cannot find it
29092 =item Why does Net::FTP not implement mput and mget methods
29096 =item Using Net::SMTP
29100 =item Why can't the part of an Email address after the @ be used as the
29103 =item Why does Net::SMTP not do DNS MX lookups ?
29105 =item The verify method always returns true ?
29109 =item Debugging scripts
29113 =item How can I debug my scripts that use Net::* modules ?
29117 =item AUTHOR AND COPYRIGHT
29121 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
29138 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
29153 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
29170 =head2 Netrc, Net::Netrc - OO interface to users netrc file
29178 =item THE .netrc FILE
29180 machine name, default, login name, password string, account string, macdef
29185 lookup ( MACHINE [, LOGIN ])
29189 login (), password (), account (), lpa ()
29199 =head2 O - Generic interface to Perl Compiler backends
29209 =item IMPLEMENTATION
29217 =head2 ODBM_File - Tied access to odbm files
29225 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
29231 =item C<odbm store returned -1, errno 22, key "..." at ...>
29235 =item BUGS AND WARNINGS
29239 =head2 Object::Accessor
29251 =item $object = Object::Accessor->new( [ARGS] );
29259 =item $bool = $object->mk_accessors( @ACCESSORS | \%ACCESSOR_MAP );
29265 =item @list = $self->ls_accessors;
29271 =item $ref = $self->ls_allow(KEY)
29277 =item $bool = $self->mk_aliases( alias => method, [alias2 => method2, ...]
29284 =item $clone = $self->mk_clone;
29290 =item $bool = $self->mk_flush;
29296 =item $bool = $self->mk_verify;
29302 =item $bool = $self->register_callback( sub { ... } );
29308 =item $bool = $self->can( METHOD_NAME )
29314 =item $val = $self->___get( METHOD_NAME );
29320 =item $bool = $self->___set( METHOD_NAME => VALUE );
29326 =item $bool = $self->___alias( ALIAS => METHOD );
29332 =item LVALUE ACCESSORS
29338 Allow handlers, Callbacks
29346 =item GLOBAL VARIABLES
29350 =item $Object::Accessor::FATAL
29352 =item $Object::Accessor::DEBUG
29360 =item Create read-only accessors
29374 =head2 Opcode - Disable named opcodes when compiling perl code
29386 =item Operator Names and Operator Lists
29388 an operator name (opname), an operator tag name (optag), a negated opname
29389 or optag, an operator set (opset)
29391 =item Opcode Functions
29393 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
29394 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
29395 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
29398 =item Manipulating Opsets
29400 =item TO DO (maybe)
29406 =item Predefined Opcode Tags
29408 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
29409 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
29410 :filesys_write, :subprocess, :ownprocess, :others, :load,
29411 :still_to_be_decided, :dangerous
29419 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
29428 a new namespace, an operator mask
29434 =item RECENT CHANGES
29436 =item Methods in class Safe
29438 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
29439 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
29440 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING, STRICT), rdo
29441 (FILENAME), root (NAMESPACE), mask (MASK)
29443 =item Some Safety Issues
29445 Memory, CPU, Snooping, Signals, State Changes
29453 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
29466 =head2 POSIX - Perl interface to IEEE Std 1003.1
29480 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
29481 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
29482 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
29483 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
29484 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
29485 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
29486 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
29487 fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv,
29488 geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid,
29489 getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha,
29490 isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace,
29491 isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime,
29492 log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr,
29493 memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice,
29494 offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc,
29495 putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename,
29496 rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid,
29497 setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
29498 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
29499 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
29500 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
29501 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
29502 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
29503 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
29504 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
29511 =item POSIX::SigAction
29513 new, handler, mask, flags, safe
29517 %SIGRT, SIGRTMIN, SIGRTMAX
29519 =item POSIX::SigSet
29521 new, addset, delset, emptyset, fillset, ismember
29523 =item POSIX::Termios
29525 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
29526 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
29527 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
29528 field values, c_cflag field values, c_iflag field values, c_lflag field
29529 values, c_oflag field values
29533 =item PATHNAME CONSTANTS
29537 =item POSIX CONSTANTS
29541 =item SYSTEM CONFIGURATION
29595 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
29596 WTERMSIG, WIFSTOPPED, WSTOPSIG
29600 =head2 Package::Constants - List all constants declared in a package
29608 =item CLASS METHODS
29612 =item @const = Package::Constants->list( PACKAGE_NAME );
29620 =item GLOBAL VARIABLES
29624 =item $Package::Constants::DEBUG
29640 =head2 Params::Check - A generic input parsing/checking mechanism.
29650 default, required, strict_type, defined, no_override, store, allow
29656 =item check( \%tmpl, \%args, [$verbose] );
29658 Template, Arguments, Verbose
29666 =item allow( $test_me, \@criteria );
29668 string, regexp, subroutine, array ref
29680 =item Global Variables
29684 =item $Params::Check::VERBOSE
29686 =item $Params::Check::STRICT_TYPE
29688 =item $Params::Check::ALLOW_UNKNOWN
29690 =item $Params::Check::STRIP_LEADING_DASHES
29692 =item $Params::Check::NO_DUPLICATES
29694 =item $Params::Check::PRESERVE_CASE
29696 =item $Params::Check::ONLY_ALLOW_DEFINED
29698 =item $Params::Check::SANITY_CHECK_TEMPLATE
29700 =item $Params::Check::WARNINGS_FATAL
29702 =item $Params::Check::CALLER_DEPTH
29708 =item Acknowledgements
29714 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
29723 :unix, :stdio, :perlio, :crlf, :mmap, :utf8, :bytes, :raw, :pop, :win32
29727 =item Custom Layers
29731 =item Alternatives to raw
29733 =item Defaults and how to override them
29735 =item Querying the layers of filehandles
29745 =head2 PerlIO::encoding - encoding layer
29757 =head2 PerlIO::scalar - in-memory IO, scalar IO
29765 =item IMPLEMENTATION NOTE
29769 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
29777 =item EXPECTED METHODS
29779 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
29780 $obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]),
29781 $obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]),
29782 $obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh),
29783 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
29784 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
29785 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
29786 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
29792 =item Example - a Hexadecimal Handle
29798 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
29806 =item REQUIRED MODULES
29810 =item ACKNOWLEDGEMENTS
29816 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
29822 =item OPTIONS/ARGUMENTS
29828 B<-warnings> =E<gt> I<val>
29840 empty =headn, =over on line I<N> without closing =back, =item without
29841 previous =over, =back without previous =over, No argument for =begin, =end
29842 without =begin, Nested =begin's, =for without formatter specification,
29843 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
29844 interior-sequence "I<SEQ>", nested commands
29845 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
29846 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
29847 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
29852 multiple occurrence of link target I<name>, line containing nothing but
29853 whitespace in paragraph, file does not start with =head, previous =item has
29854 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
29855 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
29856 items in =over, No argument for =item, empty section in previous paragraph,
29857 Verbatim paragraph in NAME section, =headI<n> without preceding higher
29862 ignoring leading/trailing whitespace in link, (section) in '$page'
29863 deprecated, alternative text/node '%s' contains non-escaped | or /
29875 C<Pod::Checker-E<gt>new( %options )>
29877 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
29880 C<$checker-E<gt>num_errors()>
29882 C<$checker-E<gt>num_warnings()>
29884 C<$checker-E<gt>name()>
29886 C<$checker-E<gt>node()>
29888 C<$checker-E<gt>idx()>
29890 C<$checker-E<gt>hyperlink()>
29898 =head2 Pod::Escapes -- for resolving Pod EE<lt>...E<gt> sequences
29908 e2char($e_content), e2charnum($e_content), $Name2character{I<name>},
29909 $Name2character_number{I<name>}, $Latin1Code_to_fallback{I<integer>},
29910 $Latin1Char_to_fallback{I<character>}, $Code2USASCII{I<integer>}
29916 =item COPYRIGHT AND DISCLAIMERS
29922 =head2 Pod::Find - find POD documents in directory trees
29934 =item C<pod_find( { %opts } , @directories )>
29936 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
29943 =item C<simplify_name( $str )>
29949 =item C<pod_where( { %opts }, $pod )>
29951 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
29958 =item C<contains_pod( $file , $verbose )>
29970 =head2 Pod::Html - module to convert pod files to HTML
29984 backlink, cachedir, css, flush, header, help, hiddendirs, htmldir,
29985 htmlroot, index, infile, libpods, netscape, outfile, podpath, podroot,
29986 quiet, recurse, title, verbose
30004 =head2 Pod::InputObjects - objects representing POD input paragraphs,
30017 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
30018 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
30024 =item B<Pod::InputSource>
30048 =item B<was_cutting()>
30054 =item B<Pod::Paragraph>
30060 =item Pod::Paragraph-E<gt>B<new()>
30066 =item $pod_para-E<gt>B<cmd_name()>
30072 =item $pod_para-E<gt>B<text()>
30078 =item $pod_para-E<gt>B<raw_text()>
30084 =item $pod_para-E<gt>B<cmd_prefix()>
30090 =item $pod_para-E<gt>B<cmd_separator()>
30096 =item $pod_para-E<gt>B<parse_tree()>
30102 =item $pod_para-E<gt>B<file_line()>
30108 =item B<Pod::InteriorSequence>
30114 =item Pod::InteriorSequence-E<gt>B<new()>
30120 =item $pod_seq-E<gt>B<cmd_name()>
30126 =item $pod_seq-E<gt>B<prepend()>
30132 =item $pod_seq-E<gt>B<append()>
30138 =item $pod_seq-E<gt>B<nested()>
30144 =item $pod_seq-E<gt>B<raw_text()>
30150 =item $pod_seq-E<gt>B<left_delimiter()>
30156 =item $pod_seq-E<gt>B<right_delimiter()>
30162 =item $pod_seq-E<gt>B<parse_tree()>
30168 =item $pod_seq-E<gt>B<file_line()>
30174 =item Pod::InteriorSequence::B<DESTROY()>
30180 =item B<Pod::ParseTree>
30186 =item Pod::ParseTree-E<gt>B<new()>
30192 =item $ptree-E<gt>B<top()>
30198 =item $ptree-E<gt>B<children()>
30204 =item $ptree-E<gt>B<prepend()>
30210 =item $ptree-E<gt>B<append()>
30216 =item $ptree-E<gt>B<raw_text()>
30222 =item Pod::ParseTree::B<DESTROY()>
30234 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
30246 =item OBJECT METHODS
30254 =item Data Accessors
30270 B<ReplaceNAMEwithSection>
30272 B<StartWithNewPage>
30286 =item Subclassed methods
30300 B<interior_sequence>
30316 =item Methods for headings
30324 =item Internal methods
30330 B<_replace_special_chars>
30332 B<_replace_special_chars_late>
30338 B<_clean_latex_commands>
30340 B<_split_delimited>
30356 =head2 Pod::Man - Convert POD data to formatted *roff input
30364 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
30365 release, section, stderr, utf8
30369 roff font should be 1 or 2 chars, not "%s", Invalid quote specification
30378 =item COPYRIGHT AND LICENSE
30384 =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
30396 =item COPYRIGHT AND LICENSE
30400 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
30414 Pod::List-E<gt>new()
30422 $list-E<gt>indent()
30430 $list-E<gt>parent()
30436 =item Pod::Hyperlink
30438 Pod::Hyperlink-E<gt>new()
30442 $link-E<gt>parse($string)
30444 $link-E<gt>markup($string)
30448 $link-E<gt>warning()
30450 $link-E<gt>file(), $link-E<gt>line()
30456 $link-E<gt>alttext()
30466 Pod::Cache-E<gt>new()
30472 $cache-E<gt>find_page($name)
30476 =item Pod::Cache::Item
30478 Pod::Cache::Item-E<gt>new()
30482 $cacheitem-E<gt>page()
30484 $cacheitem-E<gt>description()
30486 $cacheitem-E<gt>path()
30488 $cacheitem-E<gt>file()
30490 $cacheitem-E<gt>nodes()
30492 $cacheitem-E<gt>find_node($name)
30494 $cacheitem-E<gt>idx()
30504 =head2 Pod::Parser - base class for creating POD filters and translators
30516 =item QUICK OVERVIEW
30518 =item PARSING OPTIONS
30520 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
30521 B<-warnings> (default: unset)
30527 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
30535 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
30541 =item B<verbatim()>
30543 C<$text>, C<$line_num>, C<$pod_para>
30549 =item B<textblock()>
30551 C<$text>, C<$line_num>, C<$pod_para>
30557 =item B<interior_sequence()>
30563 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
30575 =item B<initialize()>
30581 =item B<begin_pod()>
30587 =item B<begin_input()>
30593 =item B<end_input()>
30605 =item B<preprocess_line()>
30611 =item B<preprocess_paragraph()>
30617 =item METHODS FOR PARSING AND PROCESSING
30623 =item B<parse_text()>
30625 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
30626 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
30627 I<code-ref>|I<method-name>
30633 =item B<interpolate()>
30639 =item B<parse_paragraph()>
30645 =item B<parse_from_filehandle()>
30651 =item B<parse_from_file()>
30657 =item ACCESSOR METHODS
30663 =item B<errorsub()>
30675 =item B<parseopts()>
30681 =item B<output_file()>
30687 =item B<output_handle()>
30693 =item B<input_file()>
30699 =item B<input_handle()>
30705 =item B<input_streams()>
30711 =item B<top_stream()>
30717 =item PRIVATE METHODS AND DATA
30723 =item B<_push_input_stream()>
30729 =item B<_pop_input_stream()>
30735 =item TREE-BASED PARSING
30745 =head2 Pod::Perldoc - Look up Perl documentation in Pod format.
30755 =item COPYRIGHT AND DISCLAIMERS
30761 =head2 Pod::Perldoc::BaseTo - Base for Pod::Perldoc formatters
30771 =item COPYRIGHT AND DISCLAIMERS
30777 =head2 Pod::Perldoc::GetOptsOO - Customized option parser for Pod::Perldoc
30787 =item COPYRIGHT AND DISCLAIMERS
30793 =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors
30803 =item COPYRIGHT AND DISCLAIMERS
30809 =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages
30821 =item COPYRIGHT AND DISCLAIMERS
30827 =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff
30839 =item COPYRIGHT AND DISCLAIMERS
30845 =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod!
30855 =item COPYRIGHT AND DISCLAIMERS
30861 =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF
30871 =item COPYRIGHT AND DISCLAIMERS
30877 =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext
30889 =item COPYRIGHT AND DISCLAIMERS
30895 =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod
30909 =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML
30919 =item COPYRIGHT AND DISCLAIMERS
30925 =head2 Pod::PlainText - Convert POD data to formatted ASCII text
30933 alt, indent, loose, sentence, width
30937 Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
30938 Unknown sequence: %s, Unmatched =back
30950 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
30970 =head2 Pod::Select, podselect() - extract selected sections of POD from
30983 =item SECTION SPECIFICATIONS
30985 =item RANGE SPECIFICATIONS
30991 =item OBJECT METHODS
30997 =item B<curr_headings()>
31009 =item B<add_selection()>
31015 =item B<clear_selections()>
31021 =item B<match_section()>
31027 =item B<is_selected()>
31033 =item EXPORTED FUNCTIONS
31039 =item B<podselect()>
31041 B<-output>, B<-sections>, B<-ranges>
31047 =item PRIVATE METHODS AND DATA
31053 =item B<_compile_section_spec()>
31059 =item $self->{_SECTION_HEADINGS}
31065 =item $self->{_SELECTED_SECTIONS}
31077 =head2 Pod::Simple - framework for parsing Pod
31087 C<< $parser = I<SomeClass>->new(); >>, C<< $parser->output_fh( *OUT ); >>,
31088 C<< $parser->output_string( \$somestring ); >>, C<< $parser->parse_file(
31089 I<$some_filename> ); >>, C<< $parser->parse_file( *INPUT_FH ); >>, C<<
31090 $parser->parse_string_document( I<$all_content> ); >>, C<<
31091 $parser->parse_lines( I<...@lines...>, undef ); >>, C<<
31092 $parser->content_seen >>, C<< I<SomeClass>->filter( I<$filename> ); >>, C<<
31093 I<SomeClass>->filter( I<*INPUT_FH> ); >>, C<< I<SomeClass>->filter(
31094 I<\$document_content> ); >>
31096 =item SECONDARY METHODS
31098 C<< $parser->no_whining( I<SOMEVALUE> ) >>, C<< $parser->no_errata_section(
31099 I<SOMEVALUE> ) >>, C<< $parser->complain_stderr( I<SOMEVALUE> ) >>, C<<
31100 $parser->source_filename >>, C<< $parser->doc_has_started >>, C<<
31101 $parser->source_dead >>
31107 =item COPYRIGHT AND DISCLAIMERS
31111 Allison Randal C<allison@perl.org>, Hans Dieter Pearcey C<hdp@cpan.org>
31115 =head2 Pod::Simple::Checker -- check the Pod syntax of a document
31125 =item COPYRIGHT AND DISCLAIMERS
31131 =head2 Pod::Simple::Debug -- put Pod::Simple into trace/debug mode
31145 =item COPYRIGHT AND DISCLAIMERS
31151 =head2 Pod::Simple::DumpAsText -- dump Pod-parsing events as text
31161 =item COPYRIGHT AND DISCLAIMERS
31167 =head2 Pod::Simple::DumpAsXML -- turn Pod into XML
31177 =item COPYRIGHT AND DISCLAIMERS
31183 =head2 Pod::Simple::HTML - convert Pod to HTML
31191 =item CALLING FROM THE COMMAND LINE
31193 =item CALLING FROM PERL
31201 =item COPYRIGHT AND DISCLAIMERS
31207 =head2 Pod::Simple::HTMLBatch - convert several Pod files to several HTML
31218 =item FROM THE COMMAND LINE
31224 $batchconv = Pod::Simple::HTMLBatch->new;, $batchconv->batch_convert(
31225 I<indirs>, I<outdir> );, $batchconv->batch_convert( undef , ...);,
31226 $batchconv->batch_convert( q{@INC}, ...);, $batchconv->batch_convert(
31227 \@dirs , ...);, $batchconv->batch_convert( "somedir" , ...);,
31228 $batchconv->batch_convert( 'somedir:someother:also' , ...);,
31229 $batchconv->batch_convert( ... , undef );, $batchconv->batch_convert( ... ,
31234 =item ACCESSOR METHODS
31236 $batchconv->verbose( I<nonnegative_integer> );, $batchconv->index(
31237 I<true-or-false> );, $batchconv->contents_file( I<filename> );,
31238 $batchconv->contents_page_start( I<HTML_string> );,
31239 $batchconv->contents_page_end( I<HTML_string> );, $batchconv->add_css( $url
31240 );, $batchconv->add_javascript( $url );, $batchconv->css_flurry(
31241 I<true-or-false> );, $batchconv->javascript_flurry( I<true-or-false> );,
31242 $batchconv->no_contents_links( I<true-or-false> );,
31243 $batchconv->html_render_class( I<classname> );
31247 =item NOTES ON CUSTOMIZATION
31253 =item COPYRIGHT AND DISCLAIMERS
31259 =head2 Pod::Simple::LinkSection -- represent "section" attributes of L
31270 =item COPYRIGHT AND DISCLAIMERS
31276 =head2 Pod::Simple::Methody -- turn Pod::Simple events into method calls
31284 =item METHOD CALLING
31288 =item COPYRIGHT AND DISCLAIMERS
31294 =head2 Pod::Simple::PullParser -- a pull-parser interface to parsing Pod
31304 my $token = $parser->get_token, $parser->unget_token( $token ),
31305 $parser->unget_token( $token1, $token2, ... ), $parser->set_source(
31306 $filename ), $parser->set_source( $filehandle_object ),
31307 $parser->set_source( \$document_source ), $parser->set_source(
31308 \@document_lines ), $parser->parse_file(...),
31309 $parser->parse_string_document(...), $parser->filter(...),
31310 $parser->parse_from_file(...), my $title_string = $parser->get_title, my
31311 $title_string = $parser->get_short_title, $author_name =
31312 $parser->get_author, $description_name = $parser->get_description,
31313 $version_block = $parser->get_version
31319 =item COPYRIGHT AND DISCLAIMERS
31325 =head2 Pod::Simple::PullParserEndToken -- end-tokens from
31326 Pod::Simple::PullParser
31334 $token->tagname, $token->tagname(I<somestring>), $token->tag(...),
31335 $token->is_tag(I<somestring>) or $token->is_tagname(I<somestring>)
31339 =item COPYRIGHT AND DISCLAIMERS
31345 =head2 Pod::Simple::PullParserStartToken -- start-tokens from
31346 Pod::Simple::PullParser
31354 $token->tagname, $token->tagname(I<somestring>), $token->tag(...),
31355 $token->is_tag(I<somestring>) or $token->is_tagname(I<somestring>),
31356 $token->attr(I<attrname>), $token->attr(I<attrname>, I<newvalue>),
31361 =item COPYRIGHT AND DISCLAIMERS
31367 =head2 Pod::Simple::PullParserTextToken -- text-tokens from
31368 Pod::Simple::PullParser
31376 $token->text, $token->text(I<somestring>), $token->text_r()
31380 =item COPYRIGHT AND DISCLAIMERS
31386 =head2 Pod::Simple::PullParserToken -- tokens from Pod::Simple::PullParser
31394 $token->type, $token->is_start, $token->is_text, $token->is_end,
31399 =item COPYRIGHT AND DISCLAIMERS
31405 =head2 Pod::Simple::RTF -- format Pod as RTF
31413 =item FORMAT CONTROL ATTRIBUTES
31415 $parser->head1_halfpoint_size( I<halfpoint_integer> );,
31416 $parser->head2_halfpoint_size( I<halfpoint_integer> );,
31417 $parser->head3_halfpoint_size( I<halfpoint_integer> );,
31418 $parser->head4_halfpoint_size( I<halfpoint_integer> );,
31419 $parser->codeblock_halfpoint_size( I<halfpoint_integer> );,
31420 $parser->header_halfpoint_size( I<halfpoint_integer> );,
31421 $parser->normal_halfpoint_size( I<halfpoint_integer> );,
31422 $parser->no_proofing_exemptions( I<true_or_false> );, $parser->doc_lang(
31423 I<microsoft_decimal_language_code> )
31427 =item COPYRIGHT AND DISCLAIMERS
31433 =head2 Pod::Simple::Search - find POD documents in directory trees
31445 $search->inc( I<true-or-false> );, $search->verbose( I<nonnegative-number>
31446 );, $search->limit_glob( I<some-glob-string> );, $search->callback(
31447 I<\&some_routine> );, $search->laborious( I<true-or-false> );,
31448 $search->shadows( I<true-or-false> );, $search->limit_re( I<some-regxp> );,
31449 $search->dir_prefix( I<some-string-value> );, $search->progress(
31450 I<some-progress-object> );, $name2path = $self->name2path;, $path2name =
31453 =item MAIN SEARCH METHODS
31457 =item C<< $search->survey( @directories ) >>
31459 C<name2path>, C<path2name>
31461 =item C<< $search->simplify_name( $str ) >>
31463 =item C<< $search->find( $pod ) >>
31465 =item C<< $search->find( $pod, @search_dirs ) >>
31467 =item C<< $self->contains_pod( $file ) >>
31477 =head2 Pod::Simple::Subclassing -- write a formatter as a Pod::Simple
31488 C<< $parser->_handle_element_start( I<element_name>, I<attr_hashref> ) >>,
31489 C<< $parser->_handle_element_end( I<element_name> ) >>, C<<
31490 $parser->_handle_text( I<text_string> ) >>, events with an element_name
31491 of Document, events with an element_name of Para, events with an
31492 element_name of B, C, F, or I, events with an element_name of S, events
31493 with an element_name of X, events with an element_name of L, events with an
31494 element_name of E or Z, events with an element_name of Verbatim, events
31495 with an element_name of head1 .. head4, events with an element_name of
31496 over-bullet, events with an element_name of over-number, events with an
31497 element_name of over-text, events with an element_name of over-block,
31498 events with an element_name of item-bullet, events with an element_name of
31499 item-number, events with an element_name of item-text, events with an
31500 element_name of for, events with an element_name of Data
31502 =item More Pod::Simple Methods
31504 C<< $parser->accept_targets( I<SOMEVALUE> ) >>, C<<
31505 $parser->accept_targets_as_text( I<SOMEVALUE> ) >>, C<<
31506 $parser->accept_codes( I<Codename>, I<Codename>... ) >>, C<<
31507 $parser->accept_directive_as_data( I<directive_name> ) >>, C<<
31508 $parser->accept_directive_as_verbatim( I<directive_name> ) >>, C<<
31509 $parser->accept_directive_as_processed( I<directive_name> ) >>, C<<
31510 $parser->nbsp_for_S( I<BOOLEAN> ); >>, C<< $parser->version_report() >>,
31511 C<< $parser->pod_para_count() >>, C<< $parser->line_count() >>, C<<
31512 $parser->nix_X_codes( I<SOMEVALUE> ) >>, C<< $parser->merge_text(
31513 I<SOMEVALUE> ) >>, C<< $parser->code_handler( I<CODE_REF> ) >>, C<<
31514 $parser->cut_handler( I<CODE_REF> ) >>, C<< $parser->whine(
31515 I<linenumber>, I<complaint string> ) >>, C<< $parser->scream(
31516 I<linenumber>, I<complaint string> ) >>, C<< $parser->source_dead(1) >>,
31517 C<< $parser->hide_line_numbers( I<SOMEVALUE> ) >>, C<< $parser->no_whining(
31518 I<SOMEVALUE> ) >>, C<< $parser->no_errata_section( I<SOMEVALUE> ) >>, C<<
31519 $parser->complain_stderr( I<SOMEVALUE> ) >>, C<< $parser->bare_output(
31520 I<SOMEVALUE> ) >>, C<< $parser->preserve_whitespace( I<SOMEVALUE> ) >>
31524 =item COPYRIGHT AND DISCLAIMERS
31530 =head2 Pod::Simple::Text -- format Pod as plaintext
31540 =item COPYRIGHT AND DISCLAIMERS
31546 =head2 Pod::Simple::TextContent -- get the text content of Pod
31556 =item COPYRIGHT AND DISCLAIMERS
31562 =head2 Pod::Simple::XHTML -- format Pod as validating XHTML
31578 =item perldoc_url_prefix
31580 =item perldoc_url_postfix
31582 =item title_prefix, title_postfix
31586 =item html_javascript
31590 =item html_header_tags
31592 =item default_title
31596 =item html_header, html_footer
31626 =head2 Pod::Simple::XMLOutStream -- turn Pod into XML
31636 =item ABOUT EXTENDING POD
31640 =item COPYRIGHT AND DISCLAIMERS
31646 =head2 Pod::SimpleTree, Pod::Simple::SimpleTree -- parse Pod into a simple
31657 =item Tree Contents
31661 =item COPYRIGHT AND DISCLAIMERS
31667 =head2 Pod::Text - Convert POD data to formatted ASCII text
31675 alt, code, indent, loose, margin, quotes, sentence, stderr, utf8, width
31679 Bizarre space in item, Item called without tag, Can't open %s for reading:
31680 %s, Invalid quote specification "%s"
31692 =item COPYRIGHT AND LICENSE
31696 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
31710 =item COPYRIGHT AND LICENSE
31714 =head2 Pod::Text::Overstrike, =for stopwords
31729 =item COPYRIGHT AND LICENSE
31733 =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
31748 =item COPYRIGHT AND LICENSE
31752 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
31761 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-sections>, C<-output>,
31762 C<-input>, C<-pathlist>, C<-noperldoc>
31770 =item Recommended Use
31778 =item ACKNOWLEDGMENTS
31782 =head2 SDBM_File - Tied access to sdbm files
31790 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
31796 =item C<sdbm store returned -1, errno 22, key "..." at ...>
31800 =item BUGS AND WARNINGS
31804 =head2 Safe - Compile and execute code in restricted compartments
31812 a new namespace, an operator mask
31818 =item RECENT CHANGES
31820 =item Methods in class Safe
31822 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
31823 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
31824 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING, STRICT), rdo
31825 (FILENAME), root (NAMESPACE), mask (MASK)
31827 =item Some Safety Issues
31829 Memory, CPU, Snooping, Signals, State Changes
31837 =head2 Scalar::Util - A selection of general-utility scalar subroutines
31845 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
31846 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
31847 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
31857 =head2 Search::Dict, look - search for key in dictionary file
31867 =head2 SelectSaver - save and restore selected file handle
31877 =head2 SelfLoader - load functions only on demand
31887 =item The __DATA__ token
31889 =item SelfLoader autoloading
31891 =item Autoloading and package lexicals
31893 =item SelfLoader and AutoLoader
31895 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
31897 =item Classes and inherited methods.
31901 =item Multiple packages and fully qualified subroutine names
31905 =item COPYRIGHT AND LICENSE
31911 =head2 Shell - run shell commands transparently within perl
31923 =item Escaping Magic Characters
31925 =item Configuration
31935 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
31936 socket.h defines and structure manipulators
31944 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
31945 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
31946 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
31947 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
31948 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
31952 =head2 Storable - persistence for Perl data structures
31962 =item ADVISORY LOCKING
31966 =item CANONICAL REPRESENTATION
31968 =item CODE REFERENCES
31970 =item FORWARD COMPATIBILITY
31972 utf8 data, restricted hashes, files from future versions of Storable
31974 =item ERROR REPORTING
31982 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
31983 I<serialized>, .., C<STORABLE_attach> I<class>, I<cloning>, I<serialized>
31987 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
31988 C<Storable::is_retrieving>
31996 =item Storable magic
31998 $info = Storable::file_magic( $filename ), C<version>, C<version_nv>,
31999 C<major>, C<minor>, C<hdrsize>, C<netorder>, C<byteorder>, C<intsize>,
32000 C<longsize>, C<ptrsize>, C<nvsize>, C<file>, $info = Storable::read_magic(
32001 $buffer ), $info = Storable::read_magic( $buffer, $must_be_file )
32011 =item 64 bit data in perl 5.6.0 and 5.6.1
32023 =head2 Switch - A switch statement for Perl
32037 =item Allowing fall-through
32039 =item Automating fall-through
32041 =item Alternative syntax
32043 =item Higher-order Operations
32059 =head2 Symbol - manipulate Perl symbols and their names
32071 =head2 Sys::Hostname - Try every conceivable way to get hostname
32083 =head2 Syslog, Sys::Syslog - Perl interface to the UNIX syslog(3) calls
32097 B<openlog($ident, $logopt, $facility)>, B<syslog($priority, $message)>,
32098 B<syslog($priority, $format, @args)>, B<Note>,
32099 B<setlogmask($mask_priority)>, B<setlogsock($sock_type)>,
32100 B<setlogsock($sock_type, $stream_location)> (added in Perl 5.004_02),
32101 B<setlogsock($sock_type, $stream_location, $sock_timeout)> (added in 0.25),
32102 B<Note>, B<closelog()>
32104 =item THE RULES OF SYS::SYSLOG
32120 C<Invalid argument passed to setlogsock>, C<eventlog passed to setlogsock,
32121 but no Win32 API available>, C<no connection to syslog available>, C<stream
32122 passed to setlogsock, but %s is not writable>, C<stream passed to
32123 setlogsock, but could not find any device>, C<tcp passed to setlogsock, but
32124 tcp service unavailable>, C<syslog: expecting argument %s>, C<syslog:
32125 invalid level/facility: %s>, C<syslog: too many levels given: %s>,
32126 C<syslog: too many facilities given: %s>, C<syslog: level must be given>,
32127 C<udp passed to setlogsock, but udp service unavailable>, C<unix passed to
32128 setlogsock, but path not available>
32144 =item AUTHORS & ACKNOWLEDGEMENTS
32150 AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request
32151 tracker, Search CPAN, Kobes' CPAN Search, Perl Documentation
32159 =head2 Syslog::Syslog, Sys::Syslog - Perl interface to the UNIX syslog(3)
32174 B<openlog($ident, $logopt, $facility)>, B<syslog($priority, $message)>,
32175 B<syslog($priority, $format, @args)>, B<Note>,
32176 B<setlogmask($mask_priority)>, B<setlogsock($sock_type)>,
32177 B<setlogsock($sock_type, $stream_location)> (added in Perl 5.004_02),
32178 B<setlogsock($sock_type, $stream_location, $sock_timeout)> (added in 0.25),
32179 B<Note>, B<closelog()>
32181 =item THE RULES OF SYS::SYSLOG
32197 C<Invalid argument passed to setlogsock>, C<eventlog passed to setlogsock,
32198 but no Win32 API available>, C<no connection to syslog available>, C<stream
32199 passed to setlogsock, but %s is not writable>, C<stream passed to
32200 setlogsock, but could not find any device>, C<tcp passed to setlogsock, but
32201 tcp service unavailable>, C<syslog: expecting argument %s>, C<syslog:
32202 invalid level/facility: %s>, C<syslog: too many levels given: %s>,
32203 C<syslog: too many facilities given: %s>, C<syslog: level must be given>,
32204 C<udp passed to setlogsock, but udp service unavailable>, C<unix passed to
32205 setlogsock, but path not available>
32221 =item AUTHORS & ACKNOWLEDGEMENTS
32227 AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request
32228 tracker, Search CPAN, Kobes' CPAN Search, Perl Documentation
32236 =head2 Syslog::win32::Win32, Sys::Syslog::Win32 - Win32 support for
32251 =head2 TAP::Base - Base class that provides common functionality to
32252 L<TAP::Parser> and L<TAP::Harness>
32270 =item Class Methods
32276 =head2 TAP::Formatter::Color - Run Perl test scripts with color
32294 =item Class Methods
32300 =head2 TAP::Formatter::Console - Harness output delegate for default
32323 =item Class Methods
32325 C<verbosity>, C<verbose>, C<timer>, C<failures>, C<quiet>, C<really_quiet>,
32326 C<silent>, C<errors>, C<directives>, C<stdout>, C<color>, C<jobs>,
32333 =head2 TAP::Formatter::Console::ParallelSession - Harness output delegate
32334 for parallel console output
32356 =item Class Methods
32362 =head2 TAP::Formatter::Console::Session - Harness output delegate for
32363 default console output
32385 =item Class Methods
32387 C<formatter>, C<parser>, C<name>, C<show_count>
32393 =head2 TAP::Harness - Run test scripts with statistics
32415 =item Class Methods
32417 C<verbosity>, C<timer>, C<failures>, C<show_count>, C<lib>, C<switches>,
32418 C<test_args>, C<color>, C<exec>, C<merge>, C<aggregator_class>,
32419 C<formatter_class>, C<multiplexer_class>, C<parser_class>,
32420 C<scheduler_class>, C<formatter>, C<errors>, C<directives>, C<ignore_exit>,
32421 C<jobs>, C<fork>, C<rules>, C<stdout>
32429 =item Instance Methods
32433 the file name of a test script to run, a reference to a [ file name,
32434 display name ] array
32458 =head2 TAP::Object - Base class that provides common functionality to all
32477 =item Class Methods
32485 =item Instance Methods
32489 =head2 TAParser, TAP::Parser - Parse L<TAP|Test::Harness::TAP> output
32507 =item Class Methods
32509 C<source>, C<tap>, C<exec>, C<callback>, C<switches>, C<test_args>,
32510 C<spool>, C<merge>, C<source_class>, C<perl_source_class>,
32511 C<grammar_class>, C<iterator_factory_class>, C<result_factory_class>
32519 =item Instance Methods
32525 =item INDIVIDUAL RESULTS
32531 Version, Plan, Pragma, Test, Comment, Bailout, Unknown
32533 =item Common type methods
32535 =item C<plan> methods
32537 =item C<pragma> methods
32539 =item C<bailout> methods
32541 =item C<unknown> methods
32543 =item C<test> methods
32547 =item TOTAL RESULTS
32551 =item Individual Results
32565 =item Summary Results
32571 =item C<ignore_exit>
32575 Misplaced plan, No plan, More than one plan, Test numbers out of sequence
32581 C<test>, C<version>, C<plan>, C<comment>, C<bailout>, C<yaml>, C<unknown>,
32582 C<ELSE>, C<ALL>, C<EOF>
32586 =item BACKWARDS COMPATABILITY
32592 TODO plans, 'Missing' tests
32600 =item Parser Components
32606 =item ACKNOWLEDGEMENTS
32608 Michael Schwern, Andy Lester, chromatic, GEOFFR, Shlomi Fish, Torsten
32609 Schoenfeld, Jerry Gay, Aristotle, Adam Kennedy, Yves Orton, Adrian Howard,
32610 Sean & Lil, Andreas J. Koenig, Florian Ragwitz, Corion, Mark Stosberg, Matt
32611 Kraai, David Wheeler, Alex Vandiver
32617 =item COPYRIGHT & LICENSE
32621 =head2 TAParser::Aggregator, TAP::Parser::Aggregator - Aggregate
32622 TAP::Parser results
32640 =item Class Methods
32648 =item Instance Methods
32654 =item Summary methods
32656 failed, parse_errors, passed, skipped, todo, todo_passed, wait, exit
32660 Failed tests, Parse erros, Bad exit or wait status
32668 =head2 TAParser::Grammar, TAP::Parser::Grammar - A grammar for the Test
32687 =item Class Methods
32695 =item Instance Methods
32709 =head2 TAParser::Iterator, TAP::Parser::Iterator - Internal base class for
32710 TAP::Parser Iterators
32728 =item Class Methods
32730 =item Instance Methods
32750 =head2 TAParser::Iterator::Array, TAP::Parser::Iterator::Array - Internal
32751 TAP::Parser array Iterator
32769 =item Class Methods
32771 =item Instance Methods
32785 =head2 TAParser::Iterator::Process, TAP::Parser::Iterator::Process -
32786 Internal TAP::Parser Iterator
32804 =item Class Methods
32806 =item Instance Methods
32820 =head2 TAParser::Iterator::Stream, TAP::Parser::Iterator::Stream - Internal
32821 TAP::Parser Iterator
32839 =item Class Methods
32847 =item Instance Methods
32859 =head2 TAParser::IteratorFactory, TAP::Parser::IteratorFactory - Internal
32860 TAP::Parser Iterator
32878 =item Class Methods
32900 =head2 TAParser::Multiplexer, TAP::Parser::Multiplexer - Multiplex multiple
32919 =item Class Methods
32927 =item Instance Methods
32937 =head2 TAParser::Result, TAP::Parser::Result - Base class for TAP::Parser
32962 =item Boolean methods
32964 C<is_plan>, C<is_pragma>, C<is_test>, C<is_comment>, C<is_bailout>,
32965 C<is_version>, C<is_unknown>, C<is_yaml>
32983 =head2 TAParser::Result::Bailout, TAP::Parser::Result::Bailout - Bailout
32996 =item OVERRIDDEN METHODS
33004 =item Instance Methods
33008 =head2 TAParser::Result::Comment, TAP::Parser::Result::Comment - Comment
33021 =item OVERRIDDEN METHODS
33029 =item Instance Methods
33033 =head2 TAParser::Result::Plan, TAP::Parser::Result::Plan - Plan result
33046 =item OVERRIDDEN METHODS
33048 C<as_string>, C<raw>
33054 =item Instance Methods
33058 =head2 TAParser::Result::Pragma, TAP::Parser::Result::Pragma - TAP pragma
33071 =item OVERRIDDEN METHODS
33073 C<as_string>, C<raw>
33079 =item Instance Methods
33083 =head2 TAParser::Result::Test, TAP::Parser::Result::Test - Test result
33096 =item OVERRIDDEN METHODS
33100 =item Instance Methods
33106 =head2 TAParser::Result::Unknown, TAP::Parser::Result::Unknown - Unknown
33119 =item OVERRIDDEN METHODS
33121 C<as_string>, C<raw>
33125 =head2 TAParser::Result::Version, TAP::Parser::Result::Version - TAP syntax
33138 =item OVERRIDDEN METHODS
33140 C<as_string>, C<raw>
33146 =item Instance Methods
33150 =head2 TAParser::Result::YAML, TAP::Parser::Result::YAML - YAML result
33163 =item OVERRIDDEN METHODS
33165 C<as_string>, C<raw>
33171 =item Instance Methods
33175 =head2 TAParser::ResultFactory, TAP::Parser::ResultFactory - Factory for
33176 creating TAP::Parser output objects
33192 =item Class Methods
33210 =head2 TAParser::Scheduler, TAP::Parser::Scheduler - Schedule tests during
33229 =item Class Methods
33235 =head2 TAParser::Scheduler::Job, TAP::Parser::Scheduler::Job - A single
33254 =item Class Methods
33260 =head2 TAParser::Scheduler::Spinner, TAP::Parser::Scheduler::Spinner - A
33279 =item Class Methods
33285 =head2 TAParser::Source, TAP::Parser::Source - Stream output from some
33304 =item Class Methods
33312 =item Instance Methods
33330 =head2 TAParser::Source::Perl, TAP::Parser::Source::Perl - Stream Perl
33349 =item Class Methods
33351 =item Instance Methods
33371 =head2 TAParser::Utils, TAP::Parser::Utils - Internal TAP::Parser utilities
33393 =head2 TAParser::YAMLish::Reader, TAP::Parser::YAMLish::Reader - Read
33394 YAMLish data from iterator
33408 =item Class Methods
33410 =item Instance Methods
33422 =head2 TAParser::YAMLish::Writer, TAP::Parser::YAMLish::Writer - Write
33437 =item Class Methods
33439 =item Instance Methods
33441 a reference to a scalar to append YAML to, the handle of an open file, a
33442 reference to an array into which YAML will be pushed, a code reference
33454 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
33464 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
33465 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
33466 comma allowed after filehandle, No name for escape sequence %s
33470 ANSI_COLORS_DISABLED
33480 =item COPYRIGHT AND LICENSE
33484 =head2 Term::Cap - Perl termcap interface
33500 B<Tgetent>, OSPEED, TERM
33502 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
33504 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
33506 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
33514 =item COPYRIGHT AND LICENSE
33522 =head2 Term::Complete - Perl word completion module
33530 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
33540 =head2 Term::ReadLine - Perl interface to various C<readline> packages.
33541 If no real package is found, substitutes stubs instead of basic functions.
33549 =item Minimal set of supported functions
33551 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>,
33552 C<findConsole>, Attribs, C<Features>
33554 =item Additional supported functions
33556 C<tkRunning>, C<ornaments>, C<newTTY>
33566 =head2 Term::UI - Term::ReadLine UI made easy
33580 =item $reply = $term->get_reply( prompt => 'question?', [choices => \@list,
33581 default => $list[0], multi => BOOL, print_me => "extra text to print &
33582 record", allow => $ref] );
33590 =item $bool = $term->ask_yn( prompt => "your question", [default =>
33591 (y|1,n|0), print_me => "extra text to print & record"] )
33597 =item ($opts, $munged) = $term->parse_options( STRING );
33603 =item $str = $term->history_as_string
33609 =item GLOBAL VARIABLES
33613 =item $Term::UI::VERBOSE
33615 =item $Term::UI::AUTOREPLY
33617 =item $Term::UI::INVALID
33619 =item $Term::UI::History::HISTORY_FH
33627 =item Basic get_reply sample
33629 =item get_reply with choices
33631 =item get_reply with choices and default
33633 =item get_reply using print_me & multi
33635 =item get_reply & allow
33637 =item an elaborate ask_yn sample
33651 =head2 Term::UI::History
33663 =item history("message string" [,VERBOSE])
33671 =item GLOBAL VARIABLES
33683 =head2 Test - provides a simple framework for writing test scripts
33691 =item QUICK START GUIDE
33697 C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>,
33698 C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub>
33708 C<skip(I<skip_if_true>, I<args...>)>
33714 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
33718 =item BUGS and CAVEATS
33730 =head2 Test::Builder - Backend for building test libraries
33754 =item Setting up tests
33772 =item Running tests
33778 B<is_eq>, B<is_num>
33780 B<isnt_eq>, B<isnt_num>
33788 =item Other Testing Methods
33802 =item Test building utility methods
33822 B<no_diag>, B<no_ending>, B<no_header>
33838 B<output>, B<failure_output>, B<todo_output>
33846 =item Test Status and Info
33890 =head2 Test::Builder::Module - Base class for test modules
33912 =head2 Test::Builder::Tester - test testsuites that have been built with
33935 test_test, title (synonym 'name', 'label'), skip_out, skip_err
33953 =head2 Test::Builder::Tester::Color - turn on colour in
33954 Test::Builder::Tester
33974 =head2 Test::Harness - Run Perl standard test scripts with statistics
33992 =item runtests( @test_files )
34000 =item execute_tests( tests => \@test_files, out => \*FH )
34008 =item ENVIRONMENT VARIABLES THAT TAP::HARNESS::COMPATIBLE SETS
34010 C<HARNESS_ACTIVE>, C<HARNESS_VERSION>
34012 =item ENVIRONMENT VARIABLES THAT AFFECT TEST::HARNESS
34014 C<HARNESS_TIMER>, C<HARNESS_VERBOSE>, C<HARNESS_OPTIONS>, C<< j<n> >>, C<<
34025 =item LICENCE AND COPYRIGHT
34029 =head2 Test::Harness::lib::App::Prove, App::Prove - Implements the C<prove>
34052 =item Class Methods
34062 C<archive>, C<argv>, C<backwards>, C<blib>, C<color>, C<directives>,
34063 C<dry>, C<exec>, C<extension>, C<failures>, C<fork>, C<formatter>,
34064 C<harness>, C<ignore_exit>, C<includes>, C<jobs>, C<lib>, C<merge>,
34065 C<modules>, C<parse>, C<plugins>, C<quiet>, C<really_quiet>, C<recurse>,
34066 C<rules>, C<show_count>, C<show_help>, C<show_man>, C<show_version>,
34067 C<shuffle>, C<state>, C<taint_fail>, C<taint_warn>, C<test_args>, C<timer>,
34068 C<verbose>, C<warnings_fail>, C<warnings_warn>
34072 =head2 Test::Harness::lib::App::Prove::State, App::Prove::State - State
34073 storage for the C<prove> command.
34095 =item Class Methods
34103 =item C<result_class>
34127 =item Instance Methods
34129 C<last>, C<failed>, C<passed>, C<all>, C<hot>, C<todo>, C<slow>, C<fast>,
34130 C<new>, C<old>, C<save>
34134 =head2 Test::Harness::lib::App::Prove::State::Result,
34135 App::Prove::State::Result - Individual test suite results.
34157 =item Class Methods
34165 =item C<state_version>
34171 =item C<test_class>
34175 =head2 Test::Harness::lib::App::Prove::State::Result::Test,
34176 App::Prove::State::Result::Test - Individual test results.
34198 =item Class Methods
34206 =item Instance Methods
34210 =head2 Test::Harness::lib::TAP::Base, TAP::Base - Base class that provides
34211 common functionality to L<TAP::Parser> and L<TAP::Harness>
34229 =item Class Methods
34235 =head2 Test::Harness::lib::TAP::Formatter::Color, TAP::Formatter::Color -
34236 Run Perl test scripts with color
34254 =item Class Methods
34260 =head2 Test::Harness::lib::TAP::Formatter::Console, TAP::Formatter::Console
34261 - Harness output delegate for default console output
34283 =item Class Methods
34285 C<verbosity>, C<verbose>, C<timer>, C<failures>, C<quiet>, C<really_quiet>,
34286 C<silent>, C<errors>, C<directives>, C<stdout>, C<color>, C<jobs>,
34293 =head2 Test::Harness::lib::TAP::Formatter::Console::ParallelSession,
34294 TAP::Formatter::Console::ParallelSession - Harness output delegate for
34295 parallel console output
34317 =item Class Methods
34323 =head2 Test::Harness::lib::TAP::Formatter::Console::Session,
34324 TAP::Formatter::Console::Session - Harness output delegate for default
34347 =item Class Methods
34349 C<formatter>, C<parser>, C<name>, C<show_count>
34355 =head2 Test::Harness::lib::TAP::Harness, TAP::Harness - Run test scripts
34378 =item Class Methods
34380 C<verbosity>, C<timer>, C<failures>, C<show_count>, C<lib>, C<switches>,
34381 C<test_args>, C<color>, C<exec>, C<merge>, C<aggregator_class>,
34382 C<formatter_class>, C<multiplexer_class>, C<parser_class>,
34383 C<scheduler_class>, C<formatter>, C<errors>, C<directives>, C<ignore_exit>,
34384 C<jobs>, C<fork>, C<rules>, C<stdout>
34392 =item Instance Methods
34396 the file name of a test script to run, a reference to a [ file name,
34397 display name ] array
34421 =head2 Test::Harness::lib::TAP::Object, TAP::Object - Base class that
34422 provides common functionality to all C<TAP::*> modules
34440 =item Class Methods
34448 =item Instance Methods
34452 =head2 Test::Harness::lib::TAParser, TAP::Parser - Parse
34453 L<TAP|Test::Harness::TAP> output
34471 =item Class Methods
34473 C<source>, C<tap>, C<exec>, C<callback>, C<switches>, C<test_args>,
34474 C<spool>, C<merge>, C<source_class>, C<perl_source_class>,
34475 C<grammar_class>, C<iterator_factory_class>, C<result_factory_class>
34483 =item Instance Methods
34489 =item INDIVIDUAL RESULTS
34495 Version, Plan, Pragma, Test, Comment, Bailout, Unknown
34497 =item Common type methods
34499 =item C<plan> methods
34501 =item C<pragma> methods
34503 =item C<bailout> methods
34505 =item C<unknown> methods
34507 =item C<test> methods
34511 =item TOTAL RESULTS
34515 =item Individual Results
34529 =item Summary Results
34535 =item C<ignore_exit>
34539 Misplaced plan, No plan, More than one plan, Test numbers out of sequence
34545 C<test>, C<version>, C<plan>, C<comment>, C<bailout>, C<yaml>, C<unknown>,
34546 C<ELSE>, C<ALL>, C<EOF>
34550 =item BACKWARDS COMPATABILITY
34556 TODO plans, 'Missing' tests
34564 =item Parser Components
34570 =item ACKNOWLEDGEMENTS
34572 Michael Schwern, Andy Lester, chromatic, GEOFFR, Shlomi Fish, Torsten
34573 Schoenfeld, Jerry Gay, Aristotle, Adam Kennedy, Yves Orton, Adrian Howard,
34574 Sean & Lil, Andreas J. Koenig, Florian Ragwitz, Corion, Mark Stosberg, Matt
34575 Kraai, David Wheeler, Alex Vandiver
34581 =item COPYRIGHT & LICENSE
34585 =head2 Test::Harness::lib::TAParser::Aggregator, TAP::Parser::Aggregator -
34586 Aggregate TAP::Parser results
34604 =item Class Methods
34612 =item Instance Methods
34618 =item Summary methods
34620 failed, parse_errors, passed, skipped, todo, todo_passed, wait, exit
34624 Failed tests, Parse erros, Bad exit or wait status
34632 =head2 Test::Harness::lib::TAParser::Grammar, TAP::Parser::Grammar - A
34633 grammar for the Test Anything Protocol.
34651 =item Class Methods
34659 =item Instance Methods
34673 =head2 Test::Harness::lib::TAParser::Iterator, TAP::Parser::Iterator -
34674 Internal base class for TAP::Parser Iterators
34692 =item Class Methods
34694 =item Instance Methods
34714 =head2 Test::Harness::lib::TAParser::Iterator::Array,
34715 TAP::Parser::Iterator::Array - Internal TAP::Parser array Iterator
34733 =item Class Methods
34735 =item Instance Methods
34749 =head2 Test::Harness::lib::TAParser::Iterator::Process,
34750 TAP::Parser::Iterator::Process - Internal TAP::Parser Iterator
34768 =item Class Methods
34770 =item Instance Methods
34784 =head2 Test::Harness::lib::TAParser::Iterator::Stream,
34785 TAP::Parser::Iterator::Stream - Internal TAP::Parser Iterator
34803 =item Class Methods
34811 =item Instance Methods
34823 =head2 Test::Harness::lib::TAParser::IteratorFactory,
34824 TAP::Parser::IteratorFactory - Internal TAP::Parser Iterator
34842 =item Class Methods
34864 =head2 Test::Harness::lib::TAParser::Multiplexer, TAP::Parser::Multiplexer
34865 - Multiplex multiple TAP::Parsers
34883 =item Class Methods
34891 =item Instance Methods
34901 =head2 Test::Harness::lib::TAParser::Result, TAP::Parser::Result - Base
34902 class for TAP::Parser output objects
34926 =item Boolean methods
34928 C<is_plan>, C<is_pragma>, C<is_test>, C<is_comment>, C<is_bailout>,
34929 C<is_version>, C<is_unknown>, C<is_yaml>
34947 =head2 Test::Harness::lib::TAParser::Result::Bailout,
34948 TAP::Parser::Result::Bailout - Bailout result token.
34960 =item OVERRIDDEN METHODS
34968 =item Instance Methods
34972 =head2 Test::Harness::lib::TAParser::Result::Comment,
34973 TAP::Parser::Result::Comment - Comment result token.
34985 =item OVERRIDDEN METHODS
34993 =item Instance Methods
34997 =head2 Test::Harness::lib::TAParser::Result::Plan,
34998 TAP::Parser::Result::Plan - Plan result token.
35010 =item OVERRIDDEN METHODS
35012 C<as_string>, C<raw>
35018 =item Instance Methods
35022 =head2 Test::Harness::lib::TAParser::Result::Pragma,
35023 TAP::Parser::Result::Pragma - TAP pragma token.
35035 =item OVERRIDDEN METHODS
35037 C<as_string>, C<raw>
35043 =item Instance Methods
35047 =head2 Test::Harness::lib::TAParser::Result::Test,
35048 TAP::Parser::Result::Test - Test result token.
35060 =item OVERRIDDEN METHODS
35064 =item Instance Methods
35070 =head2 Test::Harness::lib::TAParser::Result::Unknown,
35071 TAP::Parser::Result::Unknown - Unknown result token.
35083 =item OVERRIDDEN METHODS
35085 C<as_string>, C<raw>
35089 =head2 Test::Harness::lib::TAParser::Result::Version,
35090 TAP::Parser::Result::Version - TAP syntax version token.
35102 =item OVERRIDDEN METHODS
35104 C<as_string>, C<raw>
35110 =item Instance Methods
35114 =head2 Test::Harness::lib::TAParser::Result::YAML,
35115 TAP::Parser::Result::YAML - YAML result token.
35127 =item OVERRIDDEN METHODS
35129 C<as_string>, C<raw>
35135 =item Instance Methods
35139 =head2 Test::Harness::lib::TAParser::ResultFactory,
35140 TAP::Parser::ResultFactory - Factory for creating TAP::Parser output
35157 =item Class Methods
35175 =head2 Test::Harness::lib::TAParser::Scheduler, TAP::Parser::Scheduler -
35176 Schedule tests during parallel testing
35194 =item Class Methods
35200 =head2 Test::Harness::lib::TAParser::Scheduler::Job,
35201 TAP::Parser::Scheduler::Job - A single testing job.
35219 =item Class Methods
35225 =head2 Test::Harness::lib::TAParser::Scheduler::Spinner,
35226 TAP::Parser::Scheduler::Spinner - A no-op job.
35244 =item Class Methods
35250 =head2 Test::Harness::lib::TAParser::Source, TAP::Parser::Source - Stream
35251 output from some source
35269 =item Class Methods
35277 =item Instance Methods
35295 =head2 Test::Harness::lib::TAParser::Source::Perl,
35296 TAP::Parser::Source::Perl - Stream Perl output
35314 =item Class Methods
35316 =item Instance Methods
35336 =head2 Test::Harness::lib::TAParser::Utils, TAP::Parser::Utils - Internal
35337 TAP::Parser utilities
35359 =head2 Test::Harness::lib::TAParser::YAMLish::Reader,
35360 TAP::Parser::YAMLish::Reader - Read YAMLish data from iterator
35374 =item Class Methods
35376 =item Instance Methods
35388 =head2 Test::Harness::lib::TAParser::YAMLish::Writer,
35389 TAP::Parser::YAMLish::Writer - Write YAMLish data
35403 =item Class Methods
35405 =item Instance Methods
35407 a reference to a scalar to append YAML to, the handle of an open file, a
35408 reference to an array into which YAML will be pushed, a code reference
35420 =head2 Test::Harness::lib::Test::Harness, Test::Harness - Run Perl standard
35421 test scripts with statistics
35439 =item runtests( @test_files )
35447 =item execute_tests( tests => \@test_files, out => \*FH )
35455 =item ENVIRONMENT VARIABLES THAT TAP::HARNESS::COMPATIBLE SETS
35457 C<HARNESS_ACTIVE>, C<HARNESS_VERSION>
35459 =item ENVIRONMENT VARIABLES THAT AFFECT TEST::HARNESS
35461 C<HARNESS_TIMER>, C<HARNESS_VERBOSE>, C<HARNESS_OPTIONS>, C<< j<n> >>, C<<
35472 =item LICENCE AND COPYRIGHT
35476 =head2 Test::More - yet another framework for writing test scripts
35486 =item I love it when a plan comes together
35496 =item I'm ok, you're not ok.
35530 =item Complex data structures
35548 =item Conditional tests
35554 B<TODO: BLOCK>, B<todo_skip>
35556 When do I use SKIP vs. TODO?
35568 =item Discouraged comparison functions
35580 =item Extending and Embedding Test::More
35590 =item CAVEATS and NOTES
35592 Backwards compatibility, Overloaded objects, Threads, Test::Harness upgrade
35606 =head2 Test::Simple - Basic utilities for writing tests.
35644 =item Nuts and bolts of testing.
35646 =item Where to start?
35650 =item Test the manual
35652 =item Sometimes the tests are wrong
35654 =item Testing lots of values
35656 =item Informative names
35658 =item Skipping tests
35662 =item Testing with taint mode.
35674 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
35686 =head2 Text::Balanced - Extract delimited text sequences from strings.
35696 =item General behaviour in list contexts
35700 =item General behaviour in scalar and void contexts
35702 =item A note about prefixes
35704 =item C<extract_delimited>
35706 =item C<extract_bracketed>
35708 =item C<extract_variable>
35712 =item C<extract_tagged>
35714 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
35715 [0], [1], [2], [3], [4], [5]
35717 =item C<gen_extract_tagged>
35719 =item C<extract_quotelike>
35721 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
35723 =item C<extract_quotelike> and "here documents"
35725 [0], [1], [2], [3], [4], [5], [6], [7..10]
35727 =item C<extract_codeblock>
35729 =item C<extract_multiple>
35731 =item C<gen_delimited_pat>
35733 =item C<delimited_pat>
35739 C<Did not find a suitable bracket: "%s">, C<Did not find prefix: /%s/>,
35740 C<Did not find opening bracket after prefix: "%s">, C<No quotelike
35741 operator found after prefix: "%s">, C<Unmatched closing bracket: "%c">,
35742 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
35743 C<Did not find closing delimiter to match '%s'>, C<Mismatched closing
35744 bracket: expected "%c" but found "%s">, C<No block delimiter found after
35745 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
35746 after dereferencer>, C<Did not find expected opening bracket at %s>,
35747 C<Improperly nested codeblock at %s>, C<Missing second block for quotelike
35748 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
35749 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
35750 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
35755 =item BUGS AND IRRITATIONS
35761 =head2 Text::ParseWords - parse text into an array of tokens or array of
35776 =head2 Text::Soundex - Implementation of the soundex algorithm.
35794 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
35809 =head2 Text::Wrap - line wrapping to form simple paragraphs
35825 =head2 Thread - Manipulate threads in Perl (for old code only)
35839 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
35840 LIST), lock VARIABLE, async BLOCK;, Thread->self, Thread->list, cond_wait
35841 VARIABLE, cond_signal VARIABLE, cond_broadcast VARIABLE, yield
35845 join, detach, equal, tid, done
35849 lock(\&sub), eval, flags
35855 =head2 Thread::Queue - Thread-safe queues
35865 Ordinary scalars, Array refs, Hash refs, Scalar refs, Objects based on the
35868 =item QUEUE CREATION
35870 ->new(), ->new(LIST)
35872 =item BASIC METHODS
35874 ->enqueue(LIST), ->dequeue(), ->dequeue(COUNT), ->dequeue_nb(),
35875 ->dequeue_nb(COUNT), ->pending()
35877 =item ADVANCED METHODS
35879 ->peek(), ->peek(INDEX), ->insert(INDEX, LIST), ->extract(),
35880 ->extract(INDEX), ->extract(INDEX, COUNT)
35894 =head2 Thread::Semaphore - Thread-safe semaphores
35906 ->new(), ->new(NUMBER), ->down(), ->down(NUMBER), ->up(), ->up(NUMBER)
35918 =head2 Tie::Array - base class for tied arrays
35926 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
35927 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
35928 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
35929 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
35937 =head2 Tie::File - Access the lines of a disk file via a Perl array
35957 =item Option Format
35961 =item Public Methods
35969 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
35975 =item Tying to an already-opened filehandle
35977 =item Deferred Writing
35981 =item Autodeferring
35985 =item CONCURRENT ACCESS TO FILES
35991 =item WHAT ABOUT C<DB_File>?
36005 =head2 Tie::Handle - base class definitions for tied handles
36013 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
36014 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
36015 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
36016 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
36018 =item MORE INFORMATION
36020 =item COMPATIBILITY
36024 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
36033 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
36034 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR
36037 =item Inheriting from B<Tie::StdHash>
36039 =item Inheriting from B<Tie::ExtraHash>
36041 =item C<SCALAR>, C<UNTIE> and C<DESTROY>
36043 =item MORE INFORMATION
36047 =head2 Tie::Hash::NamedCapture - Named regexp capture buffers
36059 =head2 Tie::Memoize - add data to hash when needed
36067 =item Inheriting from B<Tie::Memoize>
36077 =head2 Tie::RefHash - use references as hash keys
36087 =item THREAD SUPPORT
36089 =item STORABLE SUPPORT
36091 =item RELIC SUPPORT
36101 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
36110 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
36112 =item MORE INFORMATION
36116 =head2 Tie::StdHandle - base class definitions for tied handles
36126 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
36138 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
36147 gettimeofday (), usleep ( $useconds ), nanosleep ( $nanoseconds ), ualarm (
36148 $useconds [, $interval_useconds ] ), tv_interval, time (), sleep (
36149 $floating_seconds ), alarm ( $floating_seconds [,
36150 $interval_floating_seconds ] ), setitimer ( $which, $floating_seconds [,
36151 $interval_floating_seconds ] ), getitimer ( $which ), clock_gettime (
36152 $which ), clock_getres ( $which ), clock_nanosleep ( $which, $nanoseconds,
36153 $flags = 0), clock(), stat, stat FH, stat EXPR
36163 =item useconds or interval more than ...
36165 =item negative time not invented yet
36167 =item internal error: useconds < 0 (unsigned ... signed ...)
36169 =item useconds or uinterval equal to or more than 1000000
36171 =item unimplemented in this platform
36181 =item COPYRIGHT AND LICENSE
36185 =head2 Time::Local - efficiently compute time from local and GMT time
36197 =item C<timelocal()> and C<timegm()>
36199 =item C<timelocal_nocheck()> and C<timegm_nocheck()>
36201 =item Year Value Interpretation
36203 =item Limits of time_t
36205 =item Ambiguous Local Times (DST)
36207 =item Non-Existent Local Times (DST)
36209 =item Negative Epoch Values
36213 =item IMPLEMENTATION
36225 =head2 Time::Piece - Object Oriented time objects
36237 =item Local Locales
36239 =item Date Calculations
36241 =item Date Comparisons
36245 =item YYYY-MM-DDThh:mm:ss
36249 =item Global Overriding
36263 =head2 Time::Piece::Seconds, Time::Seconds - a simple API to convert
36264 seconds to other date values
36282 =head2 Time::Seconds - a simple API to convert seconds to other date values
36300 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
36315 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
36330 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
36342 =head2 UNIVERSAL - base class for ALL classes (blessed references)
36350 C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<< eval { VAL->isa(
36351 TYPE ) } >>, C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->DOES( ROLE ) >>,
36352 C<< CLASS->DOES( ROLE ) >>, C<< $obj->can( METHOD ) >>, C<< CLASS->can(
36353 METHOD ) >>, C<< eval { VAL->can( METHOD ) } >>, C<VERSION ( [ REQUIRE ] )>
36359 =head2 Unicode::Collate - Unicode Collation Algorithm
36369 =item Constructor and Tailoring
36371 UCA_Version, alternate, backwards, entry, hangul_terminator, ignoreChar,
36372 ignoreName, katakana_before_hiragana, level, normalization, overrideCJK,
36373 overrideHangul, preprocess, rearrange, table, undefChar, undefName,
36374 upper_before_lower, variable
36376 =item Methods for Collation
36378 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
36379 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
36380 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
36381 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
36382 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
36383 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
36384 $Collator-E<gt>viewSortKey($string)>
36386 =item Methods for Searching
36388 C<$position = $Collator-E<gt>index($string, $substring[, $position])>,
36389 C<($position, $length) = $Collator-E<gt>index($string, $substring[,
36390 $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>,
36391 C<($match) = $Collator-E<gt>match($string, $substring)>, C<@match =
36392 $Collator-E<gt>gmatch($string, $substring)>, C<$count =
36393 $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count =
36394 $Collator-E<gt>gsubst($string, $substring, $replacement)>
36396 =item Other Methods
36398 C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, C<$version =
36399 $Collator-E<gt>version()>, C<UCA_Version()>, C<Base_Unicode_Version()>
36409 Normalization, Conformance Test
36411 =item AUTHOR, COPYRIGHT AND LICENSE
36415 Unicode Collation Algorithm - UTS #10, The Default Unicode Collation
36416 Element Table (DUCET), The conformance test for the UCA, Hangul Syllable
36417 Type, Unicode Normalization Forms - UAX #15
36421 =head2 Unicode::Normalize - Unicode Normalization Forms
36431 =item Normalization Forms
36433 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
36434 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
36435 C<$FCD_string = FCD($string)>, C<$FCC_string = FCC($string)>,
36436 C<$normalized_string = normalize($form_name, $string)>
36438 =item Decomposition and Composition
36440 C<$decomposed_string = decompose($string [, $useCompatMapping])>,
36441 C<$reordered_string = reorder($string)>, C<$composed_string =
36446 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
36447 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
36448 checkFCD($string)>, C<$result = checkFCC($string)>, C<$result =
36449 check($form_name, $string)>
36451 =item Character Data
36453 C<$canonical_decomposition = getCanon($code_point)>,
36454 C<$compatibility_decomposition = getCompat($code_point)>,
36455 C<$code_point_composite = getComposite($code_point_here,
36456 $code_point_next)>, C<$combining_class = getCombinClass($code_point)>,
36457 C<$may_be_composed_with_prev_char = isComp2nd($code_point)>,
36458 C<$is_exclusion = isExclusion($code_point)>, C<$is_singleton =
36459 isSingleton($code_point)>, C<$is_non_starter_decomposition =
36460 isNonStDecomp($code_point)>, C<$is_Full_Composition_Exclusion =
36461 isComp_Ex($code_point)>, C<$NFD_is_NO = isNFD_NO($code_point)>,
36462 C<$NFC_is_NO = isNFC_NO($code_point)>, C<$NFC_is_MAYBE =
36463 isNFC_MAYBE($code_point)>, C<$NFKD_is_NO = isNFKD_NO($code_point)>,
36464 C<$NFKC_is_NO = isNFKC_NO($code_point)>, C<$NFKC_is_MAYBE =
36465 isNFKC_MAYBE($code_point)>
36473 Perl's version vs. Unicode version, Correction of decomposition mapping,
36474 Revised definition of canonical composition
36480 http://www.unicode.org/reports/tr15/,
36481 http://www.unicode.org/Public/UNIDATA/CompositionExclusions.txt,
36482 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt,
36483 http://www.unicode.org/Public/UNIDATA/NormalizationCorrections.txt,
36484 http://www.unicode.org/review/pr-29.html, http://www.unicode.org/notes/tn5/
36488 =head2 Unicode::UCD - Unicode character database
36498 =item code point argument
36500 =item B<charinfo()>
36502 B<code>, B<name>, B<category>, B<combining>, B<bidi>, B<decomposition>,
36503 B<decimal>, B<digit>, B<numeric>, B<mirrored>, B<unicode10>, B<comment>,
36504 B<upper>, B<lower>, B<title>, B<block>, B<script>
36512 =item B<charblock()>
36518 =item B<charscript()>
36524 =item B<charblocks()>
36530 =item B<charscripts()>
36536 =item B<charinrange()>
36542 =item B<general_categories()>
36548 =item B<bidi_types()>
36554 =item B<compexcl()>
36560 =item B<casefold()>
36562 B<code>, B<full>, B<simple>, B<mapping>, B<status>, B<*>, B<*>, B<turkic>
36568 =item B<casespec()>
36570 B<code>, B<lower>, B<title>, B<lower>, B<condition>
36576 =item B<namedseq()>
36582 =item Unicode::UCD::UnicodeVersion
36588 =item B<Blocks versus Scripts>
36590 =item B<Matching Scripts and Blocks>
36592 =item Implementation Note
36604 =head2 User::grent - by-name interface to Perl's built-in getgr*()
36619 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
36630 =item System Specifics
36644 =head2 Win32 - Interfaces to some Win32 API Functions
36652 =item Alphabetical Listing of Win32 Functions
36654 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
36655 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::CreateDirectory(DIRECTORY),
36656 Win32::CreateFile(FILE), Win32::DomainName(),
36657 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
36658 Win32::FsType(), Win32::FreeLibrary(HANDLE),
36659 Win32::GetANSIPathName(FILENAME), Win32::GetArchName(),
36660 Win32::GetChipName(), Win32::GetCwd(), Win32::GetCurrentProcessId(),
36661 Win32::GetCurrentThreadId(), Win32::GetFileVersion(FILENAME),
36662 Win32::GetFolderPath(FOLDER [, CREATE]), Win32::GetFullPathName(FILENAME),
36663 Win32::GetLastError(), Win32::GetLongPathName(PATHNAME),
36664 Win32::GetNextAvailDrive(), Win32::GetOSVersion(), Win32::GetOSName(),
36665 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
36666 PROCNAME), Win32::GetTickCount(), Win32::GuidGen(), Win32::IsAdminUser(),
36667 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
36668 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
36669 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
36670 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
36671 Win32::OutputDebugString(STRING), Win32::RegisterServer(LIBRARYNAME),
36672 Win32::SetChildShowWindow(SHOWWINDOW), Win32::SetCwd(NEWDIRECTORY),
36673 Win32::SetLastError(ERROR), Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS,
36674 PID), Win32::UnregisterServer(LIBRARYNAME)
36680 =head2 Win32API::File - Low-level access to Win32 system API calls for
36691 =item Object Oriented/Tied Handle Interface
36695 C<":Func">, attrLetsToBits, C<$uBits= attrLetsToBits( $sAttributeLetters
36696 )>, C<"a">, C<"c">, C<"h">, C<"o">, C<"r">, C<"s">, C<"t">, createFile,
36697 C<$hObject= createFile( $sPath )>, C<$hObject= createFile( $sPath,
36698 $rvhvOptions )>, C<$hObject= createFile( $sPath, $svAccess )>, C<$hObject=
36699 createFile( $sPath, $svAccess, $rvhvOptions )>, C<$hObject= createFile(
36700 $sPath, $svAccess, $svShare )>, C<$hObject= createFile( $sPath, $svAccess,
36701 $svShare, $rvhvOptions )>, C<"q">, C<"r">, C<"w">, C<"k">, C<"t">, C<"n">,
36702 C<"c">, C<"e">, C<"kc">, C<"ke">, C<"tc">, C<"te">, C<"nc">, C<"ne">, Flags
36703 => $uFlags, Attributes => $sAttributes, Security => $pSecurityAttributes,
36704 Model => $hModelFile, Access => $sAccess, Access => $uAccess, Create =>
36705 $sCreate, Create => $uCreate, Share => $sShare, Share => $uShare,
36706 getLogicalDrives, C<@roots= getLogicalDrives()>, CloseHandle,
36707 C<CloseHandle( $hObject )>, CopyFile, C<CopyFile( $sOldFileName,
36708 $sNewFileName, $bFailIfExists )>, CreateFile, C<$hObject= CreateFile(
36709 $sPath, $uAccess, $uShare, $pSecAttr, $uCreate, $uFlags, $hModel )>,
36710 C<"//./PhysicalDrive0">, C<"//./C:">, C<"//./A:">, C<"//./PIPE/PipeName">,
36711 DefineDosDevice, C<DefineDosDevice( $uFlags, $sDosDeviceName, $sTargetPath
36712 )>, C<DDD_RAW_TARGET_PATH>, C<DDD_REMOVE_DEFINITION>,
36713 C<DDD_EXACT_MATCH_ON_REMOVE>, DeleteFile, C<DeleteFile( $sFileName )>,
36714 DeviceIoControl, C<DeviceIoControl( $hDevice, $uIoControlCode, $pInBuf,
36715 $lInBuf, $opOutBuf, $lOutBuf, $olRetBytes, $pOverlapped )>, FdGetOsFHandle,
36716 C<$hNativeHandle= FdGetOsFHandle( $ivFd )>, fileConstant, C<$value=
36717 fileConstant( $sConstantName )>, fileLastError, C<$svError=
36718 fileLastError();>, C<fileLastError( $uError );>, GetDriveType,
36719 C<$uDriveType= GetDriveType( $sRootPath )>, C<DRIVE_UNKNOWN>,
36720 C<DRIVE_NO_ROOT_DIR>, C<DRIVE_REMOVABLE>, C<DRIVE_FIXED>, C<DRIVE_REMOTE>,
36721 C<DRIVE_CDROM>, C<DRIVE_RAMDISK>, GetFileAttributes, C<$uAttrs =
36722 GetFileAttributes( $sPath )>, C<FILE_ATTRIBUTE_ARCHIVE>,
36723 C<FILE_ATTRIBUTE_COMPRESSED>, C<FILE_ATTRIBUTE_DEVICE>,
36724 C<FILE_ATTRIBUTE_DIRECTORY>, C<FILE_ATTRIBUTE_ENCRYPTED>,
36725 C<FILE_ATTRIBUTE_HIDDEN>, C<FILE_ATTRIBUTE_NORMAL>,
36726 C<FILE_ATTRIBUTE_NOT_CONTENT_INDEXED>, C<FILE_ATTRIBUTE_OFFLINE>,
36727 C<FILE_ATTRIBUTE_READONLY>, C<FILE_ATTRIBUTE_REPARSE_POINT>,
36728 C<FILE_ATTRIBUTE_SPARSE_FILE>, C<FILE_ATTRIBUTE_SYSTEM>,
36729 C<FILE_ATTRIBUTE_TEMPORARY>, GetFileType, C<$uFileType= GetFileType( $hFile
36730 )>, C<FILE_TYPE_UNKNOWN>, C<FILE_TYPE_DISK>, C<FILE_TYPE_CHAR>,
36731 C<FILE_TYPE_PIPE>, getFileSize, C<$size= getFileSize( $hFile )>,
36732 GetFileSize, C<$iSizeLow= GetFileSize($win32Handle, $iSizeHigh)>,
36733 GetOverlappedResult, C<$bRetval= GetOverlappedResult( $win32Handle,
36734 $pOverlapped, $numBytesTransferred, $bWait )>, GetLogicalDrives,
36735 C<$uDriveBits= GetLogicalDrives()>, GetLogicalDriveStrings, C<$olOutLength=
36736 GetLogicalDriveStrings( $lBufSize, $osBuffer )>, GetHandleInformation,
36737 C<GetHandleInformation( $hObject, $ouFlags )>, GetOsFHandle,
36738 C<$hNativeHandle= GetOsFHandle( FILE )>, GetVolumeInformation,
36739 C<GetVolumeInformation( $sRootPath, $osVolName, $lVolName, $ouSerialNum,
36740 $ouMaxNameLen, $ouFsFlags, $osFsType, $lFsType )>, C<FS_CASE_IS_PRESERVED>,
36741 C<FS_CASE_SENSITIVE>, C<FS_UNICODE_STORED_ON_DISK>, C<FS_PERSISTENT_ACLS>,
36742 C<FS_FILE_COMPRESSION>, C<FS_VOL_IS_COMPRESSED>, IsRecognizedPartition,
36743 C<IsRecognizedPartition( $ivPartitionType )>, IsContainerPartition,
36744 C<IsContainerPartition( $ivPartitionType )>, MoveFile, C<MoveFile(
36745 $sOldName, $sNewName )>, MoveFileEx, C<MoveFileEx( $sOldName, $sNewName,
36746 $uFlags )>, C<MOVEFILE_REPLACE_EXISTING>, C<MOVEFILE_COPY_ALLOWED>,
36747 C<MOVEFILE_DELAY_UNTIL_REBOOT>, C<MOVEFILE_WRITE_THROUGH>, OsFHandleOpen,
36748 C<OsFHandleOpen( FILE, $hNativeHandle, $sMode )>, OsFHandleOpenFd, C<$ivFD=
36749 OsFHandleOpenFd( $hNativeHandle, $uMode )>, QueryDosDevice, C<$olTargetLen=
36750 QueryDosDevice( $sDosDeviceName, $osTargetPath, $lTargetBuf )>, ReadFile,
36751 C<ReadFile( $hFile, $opBuffer, $lBytes, $olBytesRead, $pOverlapped )>,
36752 SetErrorMode, C<$uOldMode= SetErrorMode( $uNewMode )>,
36753 C<SEM_FAILCRITICALERRORS>, C<SEM_NOALIGNMENTFAULTEXCEPT>,
36754 C<SEM_NOGPFAULTERRORBOX>, C<SEM_NOOPENFILEERRORBOX>, setFilePointer,
36755 C<$uNewPos = setFilePointer( $hFile, $ivOffset, $uFromWhere )>,
36756 SetFilePointer, C<$uNewPos = SetFilePointer( $hFile, $ivOffset,
36757 $ioivOffsetHigh, $uFromWhere )>, SetHandleInformation,
36758 C<SetHandleInformation( $hObject, $uMask, $uFlags )>, WriteFile,
36759 C<WriteFile( $hFile, $pBuffer, $lBytes, $ouBytesWritten, $pOverlapped )>,
36760 C<":FuncA">, C<":FuncW">, CopyFileW, C<CopyFileW( $swOldFileName,
36761 $swNewFileName, $bFailIfExists )>, CreateFileW, C<$hObject= CreateFileW(
36762 $swPath, $uAccess, $uShare, $pSecAttr, $uCreate, $uFlags, $hModel )>,
36763 DefineDosDeviceW, C<DefineDosDeviceW( $uFlags, $swDosDeviceName,
36764 $swTargetPath )>, DeleteFileW, C<DeleteFileW( $swFileName )>,
36765 GetDriveTypeW, C<$uDriveType= GetDriveTypeW( $swRootPath )>,
36766 GetFileAttributesW, C<$uAttrs= GetFileAttributesW( $swPath )>,
36767 GetLogicalDriveStringsW, C<$olwOutLength= GetLogicalDriveStringsW(
36768 $lwBufSize, $oswBuffer )>, GetVolumeInformationW, C<GetVolumeInformationW(
36769 $swRootPath, $oswVolName, $lwVolName, $ouSerialNum, $ouMaxNameLen,
36770 $ouFsFlags, $oswFsType, $lwFsType )>, MoveFileW, C<MoveFileW( $swOldName,
36771 $swNewName )>, MoveFileExW, C<MoveFileExW( $swOldName, $swNewName, $uFlags
36772 )>, QueryDosDeviceW, C<$olwTargetLen= QueryDosDeviceW( $swDeviceName,
36773 $oswTargetPath, $lwTargetBuf )>, C<":Misc">, C<":DDD_">, C<":DRIVE_">,
36774 C<":FILE_">, C<":FILE_ATTRIBUTE_">, C<":FILE_FLAG_">, C<":FILE_SHARE_">,
36775 C<":FILE_TYPE_">, C<":FS_">, C<":HANDLE_FLAG_">, HANDLE_FLAG_INHERIT,
36776 HANDLE_FLAG_PROTECT_FROM_CLOSE, C<":IOCTL_STORAGE_">,
36777 C<IOCTL_STORAGE_CHECK_VERIFY>, C<IOCTL_STORAGE_MEDIA_REMOVAL>,
36778 C<IOCTL_STORAGE_EJECT_MEDIA>, C<IOCTL_STORAGE_LOAD_MEDIA>,
36779 C<IOCTL_STORAGE_RESERVE>, C<IOCTL_STORAGE_RELEASE>,
36780 C<IOCTL_STORAGE_FIND_NEW_DEVICES>, C<IOCTL_STORAGE_GET_MEDIA_TYPES>,
36781 C<$ucCylsLow[$i]>, C<$ivcCylsHigh[$i]>, C<$uMediaType[$i]>,
36782 C<$uTracksPerCyl[$i]>, C<$uSectsPerTrack[$i]>, C<$uBytesPerSect[$i]>,
36783 C<":IOCTL_DISK_">, C<IOCTL_DISK_GET_DRIVE_GEOMETRY>, C<$ucCylsLow>,
36784 C<$ivcCylsHigh>, C<$uMediaType>, C<$uTracksPerCyl>, C<$uSectsPerTrack>,
36785 C<$uBytesPerSect>, C<IOCTL_DISK_GET_PARTITION_INFO>, C<$uStartLow> and
36786 C<$ivStartHigh>, C<$ucHiddenSects>, C<$uPartitionSeqNumber>,
36787 C<$uPartitionType>, C<$bActive>, C<$bRecognized>, C<$bToRewrite>,
36788 C<IOCTL_DISK_SET_PARTITION_INFO>, C<IOCTL_DISK_GET_DRIVE_LAYOUT>,
36789 C<$cPartitions>, C<$uDiskSignature>, C<IOCTL_DISK_GET_MEDIA_TYPES>,
36790 C<IOCTL_DISK_SET_DRIVE_LAYOUT>, C<IOCTL_DISK_VERIFY>, C<$uStartOffsetLow>
36791 and C<$ivStartOffsetHigh>, C<$uLength>, C<IOCTL_DISK_FORMAT_TRACKS>,
36792 C<IOCTL_DISK_REASSIGN_BLOCKS>, C<IOCTL_DISK_PERFORMANCE>,
36793 C<IOCTL_DISK_IS_WRITABLE>, C<IOCTL_DISK_LOGGING>, DISK_LOGGING_START,
36794 DISK_LOGGING_STOP, DISK_LOGGING_DUMP, DISK_LOGGING_BINNING,
36795 C<IOCTL_DISK_FORMAT_TRACKS_EX>, C<IOCTL_DISK_HISTOGRAM_STRUCTURE>,
36796 C<IOCTL_DISK_HISTOGRAM_DATA>, C<IOCTL_DISK_HISTOGRAM_RESET>,
36797 C<IOCTL_DISK_REQUEST_STRUCTURE>, C<IOCTL_DISK_REQUEST_DATA>, C<":FSCTL_">,
36798 C<FSCTL_SET_REPARSE_POINT>, C<FSCTL_GET_REPARSE_POINT>,
36799 C<FSCTL_DELETE_REPARSE_POINT>, C<":GENERIC_">, C<":MEDIA_TYPE">,
36800 C<Unknown>, C<F5_1Pt2_512>, C<F3_1Pt44_512>, C<F3_2Pt88_512>,
36801 C<F3_20Pt8_512>, C<F3_720_512>, C<F5_360_512>, C<F5_320_512>,
36802 C<F5_320_1024>, C<F5_180_512>, C<F5_160_512>, C<RemovableMedia>,
36803 C<FixedMedia>, C<F3_120M_512>, C<":MOVEFILE_">, C<":SECURITY_">,
36804 C<":SEM_">, C<":PARTITION_">, C<":ALL">
36816 =head2 Win32CORE - Win32 CORE function stubs
36826 =head2 XSLoader - Dynamically load C libraries into Perl code
36838 =item Migration from C<DynaLoader>
36840 =item Backward compatible boilerplate
36844 =item Order of initialization: early load()
36848 =item The most hairy case
36854 C<Can't find '%s' symbol in %s>, C<Can't load '%s' for module %s: %s>,
36855 C<Undefined symbols present after loading %s: %s>,
36856 C<XSLoader::load('Your::Module', $Your::Module::VERSION)>
36866 =item COPYRIGHT & LICENSE
36870 =head1 AUXILIARY DOCUMENTATION
36872 Here should be listed all the extra programs' documentation, but they
36873 don't all have manual pages yet:
36907 Larry Wall <F<larry@wall.org>>, with the help of oodles