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
74 =item Basic syntax overview
76 =item Perl variable types
78 Scalars, Arrays, Hashes
80 =item Variable scoping
82 =item Conditional and looping constructs
84 if, while, for, foreach
86 =item Builtin operators and functions
88 Arithmetic, Numeric comparison, String comparison, Boolean logic,
93 =item Regular expressions
95 Simple matching, Simple substitution, More complex regular expressions,
96 Parentheses for capturing, Other regexp features
98 =item Writing subroutines
102 =item Using Perl modules
110 =head2 perlreftut - Mark's very short tutorial about references
116 =item Who Needs Complicated Data Structures?
124 =item Making References
126 =item Using References
144 =item Distribution Conditions
150 =head2 perldsc - Perl Data Structures Cookbook
156 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
157 more elaborate constructs
160 X<reference> X<dereference> X<dereferencing> X<pointer>
162 =item COMMON MISTAKES
164 =item CAVEAT ON PRECEDENCE
165 X<dereference, precedence> X<dereferencing, precedence>
167 =item WHY YOU SHOULD ALWAYS C<use strict>
170 X<data structure, debugging> X<complex data structure, debugging>
171 X<AoA, debugging> X<HoA, debugging> X<AoH, debugging> X<HoH, debugging>
172 X<array of arrays, debugging> X<hash of arrays, debugging>
173 X<array of hashes, debugging> X<hash of hashes, debugging>
177 =item ARRAYS OF ARRAYS
178 X<array of arrays> X<AoA>
182 =item Declaration of an ARRAY OF ARRAYS
184 =item Generation of an ARRAY OF ARRAYS
186 =item Access and Printing of an ARRAY OF ARRAYS
190 =item HASHES OF ARRAYS
191 X<hash of arrays> X<HoA>
195 =item Declaration of a HASH OF ARRAYS
197 =item Generation of a HASH OF ARRAYS
199 =item Access and Printing of a HASH OF ARRAYS
203 =item ARRAYS OF HASHES
204 X<array of hashes> X<AoH>
208 =item Declaration of an ARRAY OF HASHES
210 =item Generation of an ARRAY OF HASHES
212 =item Access and Printing of an ARRAY OF HASHES
216 =item HASHES OF HASHES
217 X<hass of hashes> X<HoH>
221 =item Declaration of a HASH OF HASHES
223 =item Generation of a HASH OF HASHES
225 =item Access and Printing of a HASH OF HASHES
229 =item MORE ELABORATE RECORDS
230 X<record> X<structure> X<struct>
234 =item Declaration of MORE ELABORATE RECORDS
236 =item Declaration of a HASH OF COMPLEX RECORDS
238 =item Generation of a HASH OF COMPLEX RECORDS
250 =head2 perllol - Manipulating Arrays of Arrays in Perl
258 =item Declaration and Access of Arrays of Arrays
260 =item Growing Your Own
262 =item Access and Printing
274 =head2 perlrequick - Perl regular expressions quick start
284 =item Simple word matching
286 =item Using character classes
288 =item Matching this or that
290 =item Grouping things and hierarchical matching
292 =item Extracting matches
294 =item Matching repetitions
298 =item Search and replace
300 =item The split operator
308 =item AUTHOR AND COPYRIGHT
312 =item Acknowledgments
318 =head2 perlretut - Perl regular expressions tutorial
324 =item Part 1: The basics
328 =item Simple word matching
330 =item Using character classes
332 =item Matching this or that
334 =item Grouping things and hierarchical matching
336 =item Extracting matches
338 =item Matching repetitions
340 =item Building a regexp
342 =item Using regular expressions in Perl
346 =item Part 2: Power tools
350 =item More on characters, strings, and character classes
352 =item Compiling and saving regular expressions
354 =item Embedding comments and modifiers in a regular expression
356 =item Non-capturing groupings
358 =item Looking ahead and looking behind
360 =item Using independent subexpressions to prevent backtracking
362 =item Conditional expressions
364 =item A bit of magic: executing Perl code in a regular expression
366 =item Pragmas and debugging
374 =item AUTHOR AND COPYRIGHT
378 =item Acknowledgments
384 =head2 perlboot - Beginner's Object-Oriented Tutorial
392 =item If we could talk to the animals...
394 =item Introducing the method invocation arrow
396 =item Invoking a barnyard
398 =item The extra parameter of method invocation
400 =item Calling a second method to simplify things
402 =item Inheriting the windpipes
404 =item A few notes about @ISA
406 =item Overriding the methods
408 =item Starting the search from a different place
410 =item The SUPER way of doing things
412 =item Where we're at so far...
414 =item A horse is a horse, of course of course -- or is it?
416 =item Invoking an instance method
418 =item Accessing the instance data
420 =item How to build a horse
422 =item Inheriting the constructor
424 =item Making a method work with either classes or instances
426 =item Adding parameters to a method
428 =item More interesting instances
430 =item A horse of a different color
442 =head2 perltoot - Tom's object-oriented tutorial for perl
448 =item Creating a Class
452 =item Object Representation
454 =item Class Interface
456 =item Constructors and Instance Methods
458 =item Planning for the Future: Better Constructors
462 =item Other Object Methods
470 =item Accessing Class Data
472 =item Debugging Methods
474 =item Class Destructors
476 =item Documenting the Interface
486 =item Overridden Methods
488 =item Multiple Inheritance
490 =item UNIVERSAL: The Root of All Objects
494 =item Alternate Object Representations
498 =item Arrays as Objects
500 =item Closures as Objects
504 =item AUTOLOAD: Proxy Methods
508 =item Autoloaded Data Methods
510 =item Inherited Autoloaded Data Methods
514 =item Metaclassical Tools
520 =item Data Members as Variables
528 =item Object Terminology
534 =item AUTHOR AND COPYRIGHT
540 =item Acknowledgments
546 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
552 =item Class Data in a Can
554 =item Class Data as Package Variables
558 =item Putting All Your Eggs in One Basket
560 =item Inheritance Concerns
562 =item The Eponymous Meta-Object
564 =item Indirect References to Class Data
566 =item Monadic Classes
568 =item Translucent Attributes
572 =item Class Data as Lexical Variables
576 =item Privacy and Responsibility
578 =item File-Scoped Lexicals
580 =item More Inheritance Concerns
582 =item Locking the Door and Throwing Away the Key
584 =item Translucency Revisited
592 =item AUTHOR AND COPYRIGHT
594 =item ACKNOWLEDGEMENTS
600 =head2 perlbot - Bag'o Object Tricks (the BOT)
606 =item OO SCALING TIPS
608 =item INSTANCE VARIABLES
610 =item SCALAR INSTANCE VARIABLES
612 =item INSTANCE VARIABLE INHERITANCE
614 =item OBJECT RELATIONSHIPS
616 =item OVERRIDING SUPERCLASS METHODS
618 =item USING RELATIONSHIP WITH SDBM
620 =item THINKING OF CODE REUSE
622 =item CLASS CONTEXT AND THE OBJECT
624 =item INHERITING A CONSTRUCTOR
632 =head2 perlstyle - Perl style guide
640 =head2 perlcheat - Perl 5 Cheat Sheet
652 =item ACKNOWLEDGEMENTS
660 =head2 perltrap - Perl traps for the unwary
678 =item Perl4 to Perl5 Traps
680 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
681 Traps, General data type traps, Context Traps - scalar, list contexts,
682 Precedence Traps, General Regular Expression Traps using s///, etc,
683 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
685 =item Discontinuance, Deprecation, and BugFix traps
687 Symbols starting with "_" no longer forced into main, Double-colon valid
688 package separator in variable name, 2nd and 3rd args to C<splice()> are now
689 in scalar context, Can't do C<goto> into a block that is optimized away,
690 Can't use whitespace as variable name or quote delimiter, C<while/if BLOCK
691 BLOCK> gone, C<**> binds tighter than unary minus, C<foreach> changed when
692 iterating over a list, C<split> with no args behavior changed, B<-e>
693 behavior fixed, C<push> returns number of elements in resulting list, Some
694 error messages differ, C<split()> honors subroutine args, Bugs removed
698 Space between . and = triggers syntax error, Better parsing in perl 5,
699 Function parsing, String interpolation of C<$#array> differs, Perl guesses
700 on C<map>, C<grep> followed by C<{> if it starts BLOCK or hash ref
702 =item Numerical Traps
704 Formatted output and significant digits, Auto-increment operator over
705 signed int limit deleted, Assignment of return values from numeric equality
706 tests doesn't work, Bitwise string ops
708 =item General data type traps
710 Negative array subscripts now count from the end of array, Setting
711 C<$#array> lower now discards array elements, Hashes get defined before
712 use, Glob assignment from localized variable to variable, Assigning
713 C<undef> to glob, Changes in unary negation (of strings), Modifying of
714 constants prohibited, C<defined $var> behavior changed, Variable Suicide
716 =item Context Traps - scalar, list contexts
718 Elements of argument lists for formats evaluated in list context,
719 C<caller()> returns false value in scalar context if no caller present,
720 Comma operator in scalar context gives scalar context to args, C<sprintf()>
721 prototyped as C<($;@)>
723 =item Precedence Traps
725 LHS vs. RHS of any assignment operator, Semantic errors introduced due to
726 precedence, Precedence of assignment operators same as the precedence of
727 assignment, C<open> requires parentheses around filehandle, C<$:>
728 precedence over C<$::> gone, Precedence of file test operators documented,
729 C<keys>, C<each>, C<values> are regular named unary operators
731 =item General Regular Expression Traps using s///, etc.
733 C<s'$lhs'$rhs'> interpolates on either side, C<m//g> attaches its state to
734 the searched string, C<m//o> used within an anonymous sub, C<$+> isn't set
735 to whole match, Substitution now returns null string if it fails,
736 C<s`lhs`rhs`> is now a normal substitution, Stricter parsing of variables
737 in regular expressions, C<m?x?> matches only once, Failed matches don't
738 reset the match variables
740 =item Subroutine, Signal, Sorting Traps
742 Barewords that used to look like strings look like subroutine calls,
743 Reverse is no longer allowed as the name of a sort subroutine, C<warn()>
744 won't let you specify a filehandle
748 SysV resets signal handler correctly, SysV C<seek()> appends correctly
750 =item Interpolation Traps
752 C<@> always interpolates an array in double-quotish strings, Double-quoted
753 strings may no longer end with an unescaped $, Arbitrary expressions are
754 evaluated inside braces within double quotes, C<$$x> now tries to
755 dereference $x, Creation of hashes on the fly with C<eval "EXPR"> requires
756 protection, Bugs in earlier perl versions, Array and hash brackets during
757 interpolation, Interpolation of C<\$$foo{bar}>, C<qq()> string passed to
758 C<eval> will not find string terminator
762 Perl5 must have been linked with same dbm/ndbm as the default for
763 C<dbmopen()>, DBM exceeding limit on the key/value size will cause perl5 to
766 =item Unclassified Traps
768 C<require>/C<do> trap using returned value, C<split> on empty string with
775 =head2 perldebtut - Perl debugging tutorial
783 =item Looking at data and -w and v
787 =item Stepping through code
789 =item Placeholder for a, w, t, T
791 =item REGULAR EXPRESSIONS
809 =head2 perlfaq - frequently asked questions about Perl ($Revision: 3606 $)
817 =item Where to get the perlfaq
819 =item How to contribute to the perlfaq
821 =item What will happen if you mail your Perl programming problems to the
828 =item AUTHOR AND COPYRIGHT
830 =item Table of Contents
832 perlfaq - this document, perlfaq1 - General Questions About Perl, perlfaq2
833 - Obtaining and Learning about Perl, perlfaq3 - Programming Tools, perlfaq4
834 - Data Manipulation, perlfaq5 - Files and Formats, perlfaq6 - Regular
835 Expressions, perlfaq7 - General Perl Language Issues, perlfaq8 - System
836 Interaction, perlfaq9 - Networking
842 =item L<perlfaq1>: General Questions About Perl
844 =item L<perlfaq2>: Obtaining and Learning about Perl
846 =item L<perlfaq3>: Programming Tools
848 =item L<perlfaq4>: Data Manipulation
850 =item L<perlfaq5>: Files and Formats
852 =item L<perlfaq6>: Regular Expressions
854 =item L<perlfaq7>: General Perl Language Issues
856 =item L<perlfaq8>: System Interaction
858 =item L<perlfaq9>: Networking
864 =head2 perlfaq1 - General Questions About Perl ($Revision: 3606 $)
874 =item Who supports Perl? Who develops it? Why is it free?
876 =item Which version of Perl should I use?
878 =item What are perl4, perl5, or perl6?
884 =item How stable is Perl?
886 =item Is Perl difficult to learn?
888 =item How does Perl compare with other languages like Java, Python, REXX,
891 =item Can I do [task] in Perl?
893 =item When shouldn't I program in Perl?
895 =item What's the difference between "perl" and "Perl"?
897 =item Is it a Perl program or a Perl script?
899 =item What is a JAPH?
901 =item Where can I get a list of Larry Wall witticisms?
903 =item How can I convince others to use Perl?
905 http://perltraining.com.au/whyperl.html,
906 http://www.perl.org/advocacy/whyperl.html
912 =item AUTHOR AND COPYRIGHT
916 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 3606 $)
924 =item What machines support perl? Where do I get it?
926 =item How can I get a binary version of perl?
928 =item I don't have a C compiler. How can I build my own Perl interpreter?
930 =item I copied the perl binary from one machine to another, but scripts
933 =item I grabbed the sources and tried to compile but gdbm/dynamic
934 loading/malloc/linking/... failed. How do I make it work?
936 =item What modules and extensions are available for Perl? What is CPAN?
937 What does CPAN/src/... mean?
939 =item Is there an ISO or ANSI certified version of Perl?
941 =item Where can I get information on Perl?
943 =item What are the Perl newsgroups on Usenet? Where do I post questions?
945 =item Where should I post source code?
949 References, Tutorials, Task-Oriented, Special Topics
951 =item Which magazines have Perl content?
953 =item What mailing lists are there for Perl?
955 =item Where are the archives for comp.lang.perl.misc?
957 =item Where can I buy a commercial version of perl?
959 =item Where do I send bug reports?
961 =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
967 =item AUTHOR AND COPYRIGHT
971 =head2 perlfaq3 - Programming Tools ($Revision: 3606 $)
979 =item How do I do (anything)?
981 =item How can I use Perl interactively?
983 =item Is there a Perl shell?
985 =item How do I find which modules are installed on my system?
987 =item How do I debug my Perl programs?
989 =item How do I profile my Perl programs?
991 =item How do I cross-reference my Perl programs?
993 =item Is there a pretty-printer (formatter) for Perl?
995 =item Is there a ctags for Perl?
997 =item Is there an IDE or Windows Perl Editor?
999 Eclipse, Enginsite, Komodo, Open Perl IDE, OptiPerl, PerlBuilder,
1000 visiPerl+, Visual Perl, Zeus, GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis,
1001 Vile, Vim, Codewright, MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, Affrus,
1002 Alpha, BBEdit and BBEdit Lite
1004 =item Where can I get Perl macros for vi?
1006 =item Where can I get perl-mode for emacs?
1008 =item How can I use curses with Perl?
1010 =item How can I use X or Tk with Perl?
1012 =item How can I make my Perl program run faster?
1014 =item How can I make my Perl program take less memory?
1016 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
1017 stringification, Pass by reference, Tie large variables to disk
1019 =item Is it safe to return a reference to local or lexical data?
1021 =item How can I free an array or hash so my program shrinks?
1023 =item How can I make my CGI script more efficient?
1025 =item How can I hide the source for my Perl program?
1027 =item How can I compile my Perl program into byte code or C?
1029 =item How can I compile Perl into Java?
1031 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
1033 =item Can I write useful Perl programs on the command line?
1035 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
1037 =item Where can I learn about CGI or Web programming in Perl?
1039 =item Where can I learn about object-oriented Perl programming?
1041 =item Where can I learn about linking C with Perl?
1043 =item I've read perlembed, perlguts, etc., but I can't embed perl in my C
1044 program; what am I doing wrong?
1046 =item When I tried to run my script, I got this message. What does it mean?
1048 =item What's MakeMaker?
1054 =item AUTHOR AND COPYRIGHT
1058 =head2 perlfaq4 - Data Manipulation ($Revision: 3606 $)
1068 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
1069 numbers I should be getting (eg, 19.95)?
1071 =item Why is int() broken?
1073 =item Why isn't my octal data interpreted correctly?
1075 =item Does Perl have a round() function? What about ceil() and floor()?
1078 =item How do I convert between numeric representations/bases/radixes?
1080 How do I convert hexadecimal into decimal, How do I convert from decimal to
1081 hexadecimal, How do I convert from octal to decimal, How do I convert from
1082 decimal to octal, How do I convert from binary to decimal, How do I convert
1083 from decimal to binary
1085 =item Why doesn't & work the way I want it to?
1087 =item How do I multiply matrices?
1089 =item How do I perform an operation on a series of integers?
1091 =item How can I output Roman numerals?
1093 =item Why aren't my random numbers random?
1095 =item How do I get a random number between X and Y?
1103 =item How do I find the day or week of the year?
1105 =item How do I find the current century or millennium?
1107 =item How can I compare two dates and find the difference?
1109 =item How can I take a string and turn it into epoch seconds?
1111 =item How can I find the Julian Day?
1113 =item How do I find yesterday's date?
1115 =item Does Perl have a Year 2000 problem? Is Perl Y2K compliant?
1123 =item How do I validate input?
1125 =item How do I unescape a string?
1127 =item How do I remove consecutive pairs of characters?
1129 =item How do I expand function calls in a string?
1131 =item How do I find matching/nesting anything?
1133 =item How do I reverse a string?
1135 =item How do I expand tabs in a string?
1137 =item How do I reformat a paragraph?
1139 =item How can I access or change N characters of a string?
1141 =item How do I change the Nth occurrence of something?
1143 =item How can I count the number of occurrences of a substring within a
1146 =item How do I capitalize all the words on one line?
1148 =item How can I split a [character] delimited string except when inside
1151 =item How do I strip blank space from the beginning/end of a string?
1153 =item How do I pad a string with blanks or pad a number with zeroes?
1155 =item How do I extract selected columns from a string?
1157 =item How do I find the soundex value of a string?
1159 =item How can I expand variables in text strings?
1161 =item What's wrong with always quoting "$vars"?
1163 =item Why don't my E<lt>E<lt>HERE documents work?
1165 There must be no space after the E<lt>E<lt> part, There (probably) should
1166 be a semicolon at the end, You can't (easily) have any space in front of
1175 =item What is the difference between a list and an array?
1177 =item What is the difference between $array[1] and @array[1]?
1179 =item How can I remove duplicate elements from a list or array?
1181 =item How can I tell whether a certain element is contained in a list or
1184 =item How do I compute the difference of two arrays? How do I compute the
1185 intersection of two arrays?
1187 =item How do I test whether two arrays or hashes are equal?
1189 =item How do I find the first array element for which a condition is true?
1191 =item How do I handle linked lists?
1193 =item How do I handle circular lists?
1195 =item How do I shuffle an array randomly?
1197 =item How do I process/modify each element of an array?
1199 =item How do I select a random element from an array?
1201 =item How do I permute N elements of a list?
1203 =item How do I sort an array by (anything)?
1205 =item How do I manipulate arrays of bits?
1207 =item Why does defined() return true on empty arrays and hashes?
1211 =item Data: Hashes (Associative Arrays)
1215 =item How do I process an entire hash?
1217 =item What happens if I add or remove keys from a hash while iterating over
1220 =item How do I look up a hash element by value?
1222 =item How can I know how many entries are in a hash?
1224 =item How do I sort a hash (optionally by value instead of key)?
1226 =item How can I always keep my hash sorted?
1228 =item What's the difference between "delete" and "undef" with hashes?
1230 =item Why don't my tied hashes make the defined/exists distinction?
1232 =item How do I reset an each() operation part-way through?
1234 =item How can I get the unique keys from two hashes?
1236 =item How can I store a multidimensional array in a DBM file?
1238 =item How can I make my hash remember the order I put elements into it?
1240 =item Why does passing a subroutine an undefined element in a hash create
1243 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
1244 array of hashes or arrays?
1246 =item How can I use a reference as a hash key?
1254 =item How do I handle binary data correctly?
1256 =item How do I determine whether a scalar is a number/whole/integer/float?
1258 =item How do I keep persistent data across program calls?
1260 =item How do I print out or copy a recursive data structure?
1262 =item How do I define methods for every class/object?
1264 =item How do I verify a credit card checksum?
1266 =item How do I pack arrays of doubles or floats for XS code?
1272 =item AUTHOR AND COPYRIGHT
1276 =head2 perlfaq5 - Files and Formats ($Revision: 3606 $)
1284 =item How do I flush/unbuffer an output filehandle? Why must I do this?
1285 X<flush> X<buffer> X<unbuffer> X<autoflush>
1287 =item How do I change one line in a file/delete a line in a file/insert a
1288 line in the middle of a file/append to the beginning of a file?
1291 =item How do I count the number of lines in a file?
1292 X<file, counting lines> X<lines> X<line>
1294 =item How can I use Perl's C<-i> option from within a program?
1297 =item How can I copy a file?
1298 X<copy> X<file, copy>
1300 =item How do I make a temporary file name?
1303 =item How can I manipulate fixed-record-length files?
1304 X<fixed-length> X<file, fixed-length records>
1306 =item How can I make a filehandle local to a subroutine? How do I pass
1307 filehandles between subroutines? How do I make an array of filehandles?
1308 X<filehandle, local> X<filehandle, passing> X<filehandle, reference>
1310 =item How can I use a filehandle indirectly?
1311 X<filehandle, indirect>
1313 =item How can I set up a footer format to be used with write()?
1316 =item How can I write() into a string?
1317 X<write, into a string>
1319 =item How can I output my numbers with commas added?
1322 =item How can I translate tildes (~) in a filename?
1323 X<tilde> X<tilde expansion>
1325 =item How come when I open a file read-write it wipes it out?
1326 X<clobber> X<read-write> X<clobbering> X<truncate> X<truncating>
1328 =item Why do I sometimes get an "Argument list too long" when I use
1330 X<argument list too long>
1332 =item Is there a leak/bug in glob()?
1335 =item How can I open a file with a leading ">" or trailing blanks?
1336 X<filename, special characters>
1338 =item How can I reliably rename a file?
1339 X<rename> X<mv> X<move> X<file, rename> X<ren>
1341 =item How can I lock a file?
1342 X<lock> X<file, lock> X<flock>
1344 =item Why can't I just open(FH, "E<gt>file.lock")?
1345 X<lock, lockfile race condition>
1347 =item I still don't get locking. I just want to increment the number in
1348 the file. How can I do this?
1349 X<counter> X<file, counter>
1351 =item All I want to do is append a small amount of text to the end of a
1352 file. Do I still have to use locking?
1353 X<append> X<file, append>
1355 =item How do I randomly update a binary file?
1356 X<file, binary patch>
1358 =item How do I get a file's timestamp in perl?
1359 X<timestamp> X<file, timestamp>
1361 =item How do I set a file's timestamp in perl?
1362 X<timestamp> X<file, timestamp>
1364 =item How do I print to more than one file at once?
1365 X<print, to multiple files>
1367 =item How can I read in an entire file all at once?
1368 X<slurp> X<file, slurping>
1370 =item How can I read in a file by paragraphs?
1371 X<file, reading by paragraphs>
1373 =item How can I read a single character from a file? From the keyboard?
1374 X<getc> X<file, reading one character at a time>
1376 =item How can I tell whether there's a character waiting on a filehandle?
1378 =item How do I do a C<tail -f> in perl?
1381 =item How do I dup() a filehandle in Perl?
1384 =item How do I close a file descriptor by number?
1385 X<file, closing file descriptors>
1387 =item Why can't I use "C:\temp\foo" in DOS paths? Why doesn't
1388 `C:\temp\foo.exe` work?
1389 X<filename, DOS issues>
1391 =item Why doesn't glob("*.*") get all the files?
1394 =item Why does Perl let me delete read-only files? Why does C<-i> clobber
1395 protected files? Isn't this a bug in Perl?
1397 =item How do I select a random line from a file?
1398 X<file, selecting a random line>
1400 =item Why do I get weird spaces when I print an array of lines?
1406 =item AUTHOR AND COPYRIGHT
1410 =head2 perlfaq6 - Regular Expressions ($Revision: 3606 $)
1418 =item How can I hope to use regular expressions without creating illegible
1419 and unmaintainable code?
1420 X<regex, legibility> X<regexp, legibility>
1421 X<regular expression, legibility> X</x>
1423 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
1425 =item I'm having trouble matching over more than one line. What's wrong?
1426 X<regex, multiline> X<regexp, multiline> X<regular expression, multiline>
1428 =item How can I pull out lines between two patterns that are themselves on
1432 =item I put a regular expression into $/ but it didn't work. What's wrong?
1433 X<$/, regexes in> X<$INPUT_RECORD_SEPARATOR, regexes in>
1436 =item How do I substitute case insensitively on the LHS while preserving
1438 X<replace, case preserving> X<substitute, case preserving>
1439 X<substitution, case preserving> X<s, case preserving>
1441 =item How can I make C<\w> match national character sets?
1444 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
1447 =item How can I quote a variable to use in a regex?
1448 X<regex, escaping> X<regexp, escaping> X<regular expression, escaping>
1450 =item What is C</o> really for?
1453 =item How do I use a regular expression to strip C style comments from a
1456 =item Can I use Perl regular expressions to match balanced text?
1457 X<regex, matching balanced test> X<regexp, matching balanced test>
1458 X<regular expression, matching balanced test>
1460 =item What does it mean that regexes are greedy? How can I get around it?
1461 X<greedy> X<greediness>
1463 =item How do I process each word on each line?
1466 =item How can I print out a word-frequency or line-frequency summary?
1468 =item How can I do approximate matching?
1469 X<match, approximate> X<matching, approximate>
1471 =item How do I efficiently match many regular expressions at once?
1472 X<regex, efficiency> X<regexp, efficiency>
1473 X<regular expression, efficiency>
1475 =item Why don't word-boundary searches with C<\b> work for me?
1478 =item Why does using $&, $`, or $' slow my program down?
1479 X<$MATCH> X<$&> X<$POSTMATCH> X<$'> X<$PREMATCH> X<$`>
1481 =item What good is C<\G> in a regular expression?
1484 =item Are Perl regexes DFAs or NFAs? Are they POSIX compliant?
1485 X<DFA> X<NFA> X<POSIX>
1487 =item What's wrong with using grep in a void context?
1490 =item How can I match strings with multibyte characters?
1491 X<regex, and multibyte characters> X<regexp, and multibyte characters>
1492 X<regular expression, and multibyte characters>
1494 =item How do I match a pattern that is supplied by the user?
1500 =item AUTHOR AND COPYRIGHT
1504 =head2 perlfaq7 - General Perl Language Issues ($Revision: 3606 $)
1512 =item Can I get a BNF/yacc/RE for the Perl language?
1514 =item What are all these $@%&* punctuation signs, and how do I know when to
1517 =item Do I always/never have to quote my strings or use semicolons and
1520 =item How do I skip some return values?
1522 =item How do I temporarily block warnings?
1524 =item What's an extension?
1526 =item Why do Perl operators have different precedence than C operators?
1528 =item How do I declare/create a structure?
1530 =item How do I create a module?
1532 =item How do I create a class?
1534 =item How can I tell if a variable is tainted?
1536 =item What's a closure?
1538 =item What is variable suicide and how can I prevent it?
1540 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
1543 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
1546 =item How do I create a static variable?
1548 =item What's the difference between dynamic and lexical (static) scoping?
1549 Between local() and my()?
1551 =item How can I access a dynamic variable while a similarly named lexical
1554 =item What's the difference between deep and shallow binding?
1556 =item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?
1558 =item How do I redefine a builtin function, operator, or method?
1560 =item What's the difference between calling a function as &foo and foo()?
1562 =item How do I create a switch or case statement?
1564 =item How can I catch accesses to undefined variables, functions, or
1567 =item Why can't a method included in this same file be found?
1569 =item How can I find out my current package?
1571 =item How can I comment out a large block of perl code?
1573 =item How do I clear a package?
1575 =item How can I use a variable as a variable name?
1577 =item What does "bad interpreter" mean?
1583 =item AUTHOR AND COPYRIGHT
1587 =head2 perlfaq8 - System Interaction ($Revision: 3606 $)
1595 =item How do I find out which operating system I'm running under?
1597 =item How come exec() doesn't return?
1599 =item How do I do fancy stuff with the keyboard/screen/mouse?
1601 Keyboard, Screen, Mouse
1603 =item How do I print something out in color?
1605 =item How do I read just one key without waiting for a return key?
1607 =item How do I check whether input is ready on the keyboard?
1609 =item How do I clear the screen?
1611 =item How do I get the screen size?
1613 =item How do I ask the user for a password?
1615 =item How do I read and write the serial port?
1617 lockfiles, open mode, end of line, flushing output, non-blocking input
1619 =item How do I decode encrypted password files?
1621 =item How do I start a process in the background?
1623 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
1625 =item How do I trap control characters/signals?
1627 =item How do I modify the shadow password file on a Unix system?
1629 =item How do I set the time and date?
1631 =item How can I sleep() or alarm() for under a second?
1633 =item How can I measure time under a second?
1635 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
1637 =item Why doesn't my sockets program work under System V (Solaris)? What
1638 does the error message "Protocol not supported" mean?
1640 =item How can I call my system's unique C functions from Perl?
1642 =item Where do I get the include files to do ioctl() or syscall()?
1644 =item Why do setuid perl scripts complain about kernel problems?
1646 =item How can I open a pipe both to and from a command?
1648 =item Why can't I get the output of a command with system()?
1650 =item How can I capture STDERR from an external command?
1652 =item Why doesn't open() return an error when a pipe open fails?
1654 =item What's wrong with using backticks in a void context?
1656 =item How can I call backticks without shell processing?
1658 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
1661 =item How can I convert my shell script to perl?
1663 =item Can I use perl to run a telnet or ftp session?
1665 =item How can I write expect in Perl?
1667 =item Is there a way to hide perl's command line from programs such as
1670 =item I {changed directory, modified my environment} in a perl script. How
1671 come the change disappeared when I exited the script? How do I get my
1672 changes to be visible?
1676 =item How do I close a process's filehandle without waiting for it to
1679 =item How do I fork a daemon process?
1681 =item How do I find out if I'm running interactively or not?
1683 =item How do I timeout a slow event?
1685 =item How do I set CPU limits?
1687 =item How do I avoid zombies on a Unix system?
1689 =item How do I use an SQL database?
1691 =item How do I make a system() exit on control-C?
1693 =item How do I open a file without blocking?
1695 =item How do I tell the difference between errors from the shell and perl?
1697 =item How do I install a module from CPAN?
1699 =item What's the difference between require and use?
1701 =item How do I keep my own module/library directory?
1703 =item How do I add the directory my program lives in to the module/library
1706 =item How do I add a directory to my include path (@INC) at runtime?
1708 =item What is socket.ph and where do I get it?
1714 =item AUTHOR AND COPYRIGHT
1718 =head2 perlfaq9 - Networking ($Revision: 3606 $)
1726 =item What is the correct form of response from a CGI script?
1728 =item My CGI script runs from the command line but not the browser. (500
1731 =item How can I get better error messages from a CGI program?
1733 =item How do I remove HTML from a string?
1735 =item How do I extract URLs?
1737 =item How do I download a file from the user's machine? How do I open a
1738 file on another machine?
1740 =item How do I make a pop-up menu in HTML?
1742 =item How do I fetch an HTML file?
1744 =item How do I automate an HTML form submission?
1746 =item How do I decode or create those %-encodings on the web?
1748 =item How do I redirect to another page?
1750 =item How do I put a password on my web pages?
1752 =item How do I edit my .htpasswd and .htgroup files with Perl?
1754 =item How do I make sure users can't enter values into a form that cause my
1755 CGI script to do bad things?
1757 =item How do I parse a mail header?
1759 =item How do I decode a CGI form?
1761 =item How do I check a valid mail address?
1763 =item How do I decode a MIME/BASE64 string?
1765 =item How do I return the user's mail address?
1767 =item How do I send mail?
1769 =item How do I use MIME to make an attachment to a mail message?
1771 =item How do I read mail?
1773 =item How do I find out my hostname, domainname, or IP address?
1774 X<hostname, domainname, IP address, host, domain, hostfqdn, inet_ntoa,
1775 gethostbyname, Socket, Net::Domain, Sys::Hostname>
1777 =item How do I fetch a news article or the active newsgroups?
1779 =item How do I fetch/put an FTP file?
1781 =item How can I do RPC in Perl?
1787 =item AUTHOR AND COPYRIGHT
1791 =head2 perlsyn - Perl syntax
1800 X<declaration> X<undef> X<undefined> X<uninitialized>
1805 =item Simple Statements
1806 X<statement> X<semicolon> X<expression> X<;>
1808 =item Truth and Falsehood
1809 X<truth> X<falsehood> X<true> X<false> X<!> X<not> X<negation> X<0>
1811 =item Statement Modifiers
1812 X<statement modifier> X<modifier> X<if> X<unless> X<while>
1813 X<until> X<foreach> X<for>
1815 =item Compound Statements
1816 X<statement, compound> X<block> X<bracket, curly> X<curly bracket> X<brace>
1817 X<{> X<}> X<if> X<unless> X<while> X<until> X<foreach> X<for> X<continue>
1820 X<loop control> X<loop, control> X<next> X<last> X<redo> X<continue>
1831 =item Switch statements
1832 X<switch> X<case> X<given> X<when> X<default>
1839 =item PODs: Embedded Documentation
1840 X<POD> X<documentation>
1842 =item Plain Old Comments (Not!)
1843 X<comment> X<line> X<#> X<preprocessor> X<eval>
1849 =head2 perldata - Perl data types
1857 =item Variable names
1858 X<variable, name> X<variable name> X<data type> X<type>
1861 X<context> X<scalar context> X<list context>
1864 X<scalar> X<number> X<string> X<reference>
1866 =item Scalar value constructors
1867 X<scalar, literal> X<scalar, constant>
1869 =item List value constructors
1875 X<slice> X<array, slice> X<hash, slice>
1877 =item Typeglobs and Filehandles
1878 X<typeglob> X<filehandle> X<*>
1886 =head2 perlop - Perl operators and precedence
1894 =item Operator Precedence and Associativity
1895 X<operator, precedence> X<precedence> X<associativity>
1897 =item Terms and List Operators (Leftward)
1898 X<list operator> X<operator, list> X<term>
1900 =item The Arrow Operator
1901 X<arrow> X<dereference> X<< -> >>
1903 =item Auto-increment and Auto-decrement
1904 X<increment> X<auto-increment> X<++> X<decrement> X<auto-decrement> X<-->
1906 =item Exponentiation
1907 X<**> X<exponentiation> X<power>
1909 =item Symbolic Unary Operators
1910 X<unary operator> X<operator, unary>
1912 =item Binding Operators
1913 X<binding> X<operator, binding> X<=~> X<!~>
1915 =item Multiplicative Operators
1916 X<operator, multiplicative>
1918 =item Additive Operators
1919 X<operator, additive>
1921 =item Shift Operators
1922 X<shift operator> X<operator, shift> X<<< << >>>
1923 X<<< >> >>> X<right shift> X<left shift> X<bitwise shift>
1924 X<shl> X<shr> X<shift, right> X<shift, left>
1926 =item Named Unary Operators
1927 X<operator, named unary>
1929 =item Relational Operators
1930 X<relational operator> X<operator, relational>
1932 =item Equality Operators
1933 X<equality> X<equal> X<equals> X<operator, equality>
1936 X<operator, bitwise, and> X<bitwise and> X<&>
1938 =item Bitwise Or and Exclusive Or
1939 X<operator, bitwise, or> X<bitwise or> X<|> X<operator, bitwise, xor>
1942 =item C-style Logical And
1943 X<&&> X<logical and> X<operator, logical, and>
1945 =item C-style Logical Or
1946 X<||> X<operator, logical, or>
1948 =item C-style Logical Defined-Or
1949 X<//> X<operator, logical, defined-or>
1951 =item Range Operators
1952 X<operator, range> X<range> X<..> X<...>
1954 =item Conditional Operator
1955 X<operator, conditional> X<operator, ternary> X<ternary> X<?:>
1957 =item Assignment Operators
1958 X<assignment> X<operator, assignment> X<=> X<**=> X<+=> X<*=> X<&=>
1959 X<<< <<= >>> X<&&=> X<-=> X</=> X<|=> X<<< >>= >>> X<||=> X<//=> X<.=>
1962 =item Comma Operator
1963 X<comma> X<operator, comma> X<,>
1965 =item List Operators (Rightward)
1966 X<operator, list, rightward> X<list operator>
1969 X<operator, logical, not> X<not>
1972 X<operator, logical, and> X<and>
1974 =item Logical or, Defined or, and Exclusive Or
1975 X<operator, logical, or> X<operator, logical, xor> X<operator, logical,
1977 X<operator, logical, defined or> X<operator, logical, exclusive or>
1980 =item C Operators Missing From Perl
1981 X<operator, missing from perl> X<&> X<*>
1982 X<typecasting> X<(TYPE)>
1984 unary &, unary *, (TYPE)
1986 =item Quote and Quote-like Operators
1987 X<operator, quote> X<operator, quote-like> X<q> X<qq> X<qx> X<qw> X<m>
1988 X<qr> X<s> X<tr> X<'> X<''> X<"> X<""> X<//> X<`> X<``> X<<< << >>>
1989 X<escape sequence> X<escape>
1991 =item Regexp Quote-Like Operators
1994 ?PATTERN? X<?>, m/PATTERN/cgimosx X<m> X<operator, match> X<regexp,
1995 options> X<regexp> X<regex, options> X<regex> X</c> X</i> X</m> X</o>
1996 X</s> X</x>, /PATTERN/cgimosx, q/STRING/ X<q> X<quote, double> X<'> X<''>,
1997 C<'STRING'>, qq/STRING/ X<qq> X<quote, double> X<"> X<"">, "STRING",
1998 qr/STRING/imosx X<qr> X</i> X</m> X</o> X</s> X</x>, qx/STRING/ X<qx> X<`>
1999 X<``> X<backtick>, `STRING`, qw/STRING/ X<qw> X<quote, list> X<quote,
2000 words>, s/PATTERN/REPLACEMENT/egimosx X<substitute> X<substitution>
2001 X<replace> X<regexp, replace> X<regexp, substitute> X</e> X</g> X</i> X</m>
2002 X</o> X</s> X</x>, tr/SEARCHLIST/REPLACEMENTLIST/cds X<tr> X<y>
2003 X<transliterate> X</c> X</d> X</s>, y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF
2004 X<here-doc> X<heredoc> X<here-document> X<<< << >>>
2006 =item Gory details of parsing quoted constructs
2007 X<quote, gory details>
2009 Finding the end, Removal of backslashes before delimiters, Interpolation
2010 X<interpolation>, C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>,
2011 C<q//>, C<"">, C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>,
2012 C</RE/>, C<m/RE/>, C<s/RE/foo/>,, Interpolation of regular expressions
2013 X<regexp, interpolation>, Optimization of regular expressions X<regexp,
2017 X<operator, i/o> X<operator, io> X<io> X<while> X<filehandle>
2020 =item Constant Folding
2021 X<constant folding> X<folding>
2026 =item Bitwise String Operators
2027 X<operator, bitwise, string>
2029 =item Integer Arithmetic
2032 =item Floating-point Arithmetic
2033 X<floating-point> X<floating point> X<float> X<real>
2035 =item Bigger Numbers
2036 X<number, arbitrary precision>
2042 =head2 perlsub - Perl subroutines
2052 =item Private Variables via my()
2053 X<my> X<variable, lexical> X<lexical> X<lexical variable> X<scope, lexical>
2054 X<lexical scope> X<attributes, my>
2056 =item Persistent Private Variables
2057 X<static> X<variable, persistent> X<variable, static> X<closure>
2059 =item Temporary Values via local()
2060 X<local> X<scope, dynamic> X<dynamic scope> X<variable, local>
2061 X<variable, temporary>
2063 =item Lvalue subroutines
2064 X<lvalue> X<subroutine, lvalue>
2066 Lvalue subroutines are EXPERIMENTAL
2068 =item Passing Symbol Table Entries (typeglobs)
2071 =item When to Still Use local()
2072 X<local> X<variable, local>
2074 =item Pass by Reference
2075 X<pass by reference> X<pass-by-reference> X<reference>
2078 X<prototype> X<subroutine, prototype>
2080 =item Constant Functions
2083 =item Overriding Built-in Functions
2084 X<built-in> X<override> X<CORE> X<CORE::GLOBAL>
2087 X<autoloading> X<AUTOLOAD>
2089 =item Subroutine Attributes
2090 X<attribute> X<subroutine, attribute> X<attrs>
2098 =head2 perlfunc - Perl builtin functions
2106 =item Perl Functions by Category
2109 Functions for SCALARs or strings X<scalar> X<string> X<character>, Regular
2110 expressions and pattern matching X<regular expression> X<regex> X<regexp>,
2111 Numeric functions X<numeric> X<number> X<trigonometric> X<trigonometry>,
2112 Functions for real @ARRAYs X<array>, Functions for list data X<list>,
2113 Functions for real %HASHes X<hash>, Input and output functions X<I/O>
2114 X<input> X<output> X<dbm>, Functions for fixed length data or records,
2115 Functions for filehandles, files, or directories X<file> X<filehandle>
2116 X<directory> X<pipe> X<link> X<symlink>, Keywords related to the control
2117 flow of your Perl program X<control flow>, Keywords related to switch,
2118 Keywords related to scoping, Miscellaneous functions, Functions for
2119 processes and process groups X<process> X<pid> X<process id>, Keywords
2120 related to perl modules X<module>, Keywords related to classes and
2121 object-orientedness X<object> X<class> X<package>, Low-level socket
2122 functions X<socket> X<sock>, System V interprocess communication functions
2123 X<IPC> X<System V> X<semaphore> X<shared memory> X<memory> X<message>,
2124 Fetching user and group info X<user> X<group> X<password> X<uid> X<gid>
2125 X<passwd> X</etc/passwd>, Fetching network info X<network> X<protocol>
2126 X<host> X<hostname> X<IP> X<address> X<service>, Time-related functions
2127 X<time> X<date>, Functions new in perl5 X<perl5>, Functions obsoleted in
2131 X<portability> X<Unix> X<portable>
2133 =item Alphabetical Listing of Perl Functions
2136 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>
2137 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,
2138 -I<X>, abs VALUE X<abs> X<absolute>, abs, accept NEWSOCKET,GENERICSOCKET
2139 X<accept>, alarm SECONDS X<alarm> X<SIGALRM> X<timer>, alarm, atan2 Y,X
2140 X<atan2> X<arctangent> X<tan> X<tangent>, bind SOCKET,NAME X<bind>, binmode
2141 FILEHANDLE, LAYER X<binmode> X<binary> X<text> X<DOS> X<Windows>, binmode
2142 FILEHANDLE, bless REF,CLASSNAME X<bless>, bless REF, break, caller EXPR
2143 X<caller> X<call stack> X<stack> X<stack trace>, caller, chdir EXPR
2144 X<chdir> X<cd>, chdir FILEHANDLE, chdir DIRHANDLE, chdir, chmod LIST
2145 X<chmod> X<permission> X<mode>, chomp VARIABLE X<chomp>
2146 X<INPUT_RECORD_SEPARATOR> X<$/> X<newline> X<eol>, chomp( LIST ), chomp,
2147 chop VARIABLE X<chop>, chop( LIST ), chop, chown LIST X<chown> X<owner>
2148 X<user> X<group>, chr NUMBER X<chr> X<character> X<ASCII> X<Unicode>, chr,
2149 chroot FILENAME X<chroot> X<root>, chroot, close FILEHANDLE X<close>,
2150 close, closedir DIRHANDLE X<closedir>, connect SOCKET,NAME X<connect>,
2151 continue BLOCK X<continue>, continue, cos EXPR X<cos> X<cosine> X<acos>
2152 X<arccosine>, cos, crypt PLAINTEXT,SALT X<crypt> X<digest> X<hash> X<salt>
2153 X<plaintext> X<password> X<decrypt> X<cryptography> X<passwd>, dbmclose
2154 HASH X<dbmclose>, dbmopen HASH,DBNAME,MASK X<dbmopen> X<dbm> X<ndbm>
2155 X<sdbm> X<gdbm>, defined EXPR X<defined> X<undef> X<undefined>, defined,
2156 delete EXPR X<delete>, die LIST X<die> X<throw> X<exception> X<raise> X<$@>
2157 X<abort>, do BLOCK X<do> X<block>, do SUBROUTINE(LIST) X<do>, do EXPR
2158 X<do>, dump LABEL X<dump> X<core> X<undump>, dump, each HASH X<each>
2159 X<hash, iterator>, eof FILEHANDLE X<eof> X<end of file> X<end-of-file>, eof
2160 (), eof, eval EXPR X<eval> X<try> X<catch> X<evaluate> X<parse> X<execute>,
2161 eval BLOCK, eval, exec LIST X<exec> X<execute>, exec PROGRAM LIST, exists
2162 EXPR X<exists> X<autovivification>, exit EXPR X<exit> X<terminate>
2163 X<abort>, exit, exp EXPR X<exp> X<exponential> X<antilog> X<antilogarithm>
2164 X<e>, exp, fcntl FILEHANDLE,FUNCTION,SCALAR X<fcntl>, fileno FILEHANDLE
2165 X<fileno>, flock FILEHANDLE,OPERATION X<flock> X<lock> X<locking>, fork
2166 X<fork> X<child> X<parent>, format X<format>, formline PICTURE,LIST
2167 X<formline>, getc FILEHANDLE X<getc> X<getchar>, getc, getlogin X<getlogin>
2168 X<login>, getpeername SOCKET X<getpeername> X<peer>, getpgrp PID X<getpgrp>
2169 X<group>, getppid X<getppid> X<parent> X<pid>, getpriority WHICH,WHO
2170 X<getpriority> X<priority> X<nice>, getpwnam NAME X<getpwnam> X<getgrnam>
2171 X<gethostbyname> X<getnetbyname> X<getprotobyname> X<getpwuid> X<getgrgid>
2172 X<getservbyname> X<gethostbyaddr> X<getnetbyaddr> X<getprotobynumber>
2173 X<getservbyport> X<getpwent> X<getgrent> X<gethostent> X<getnetent>
2174 X<getprotoent> X<getservent> X<setpwent> X<setgrent> X<sethostent>
2175 X<setnetent> X<setprotoent> X<setservent> X<endpwent> X<endgrent>
2176 X<endhostent> X<endnetent> X<endprotoent> X<endservent>, getgrnam NAME,
2177 gethostbyname NAME, getnetbyname NAME, getprotobyname NAME, getpwuid UID,
2178 getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE,
2179 getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport
2180 PORT,PROTO, getpwent, getgrent, gethostent, getnetent, getprotoent,
2181 getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent STAYOPEN,
2182 setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, endhostent,
2183 endnetent, endprotoent, endservent, getsockname SOCKET X<getsockname>,
2184 getsockopt SOCKET,LEVEL,OPTNAME X<getsockopt>, glob EXPR X<glob>
2185 X<wildcard> X<filename, expansion> X<expand>, glob, gmtime EXPR X<gmtime>
2186 X<UTC> X<Greenwich>, gmtime, goto LABEL X<goto> X<jump> X<jmp>, goto EXPR,
2187 goto &NAME, grep BLOCK LIST X<grep>, grep EXPR,LIST, hex EXPR X<hex>
2188 X<hexadecimal>, hex, import LIST X<import>, index STR,SUBSTR,POSITION
2189 X<index> X<indexOf> X<InStr>, index STR,SUBSTR, int EXPR X<int> X<integer>
2190 X<truncate> X<trunc>, int, ioctl FILEHANDLE,FUNCTION,SCALAR X<ioctl>, join
2191 EXPR,LIST X<join>, keys HASH X<keys> X<key>, kill SIGNAL, LIST X<kill>
2192 X<signal>, last LABEL X<last> X<break>, last, lc EXPR X<lc> X<lowercase>,
2193 lc, lcfirst EXPR X<lcfirst> X<lowercase>, lcfirst, length EXPR X<length>
2194 X<size>, length, link OLDFILE,NEWFILE X<link>, listen SOCKET,QUEUESIZE
2195 X<listen>, local EXPR X<local>, localtime EXPR X<localtime>, localtime,
2196 lock THING X<lock>, log EXPR X<log> X<logarithm> X<e> X<ln> X<base>, log,
2197 lstat EXPR X<lstat>, lstat, m//, map BLOCK LIST X<map>, map EXPR,LIST,
2198 mkdir FILENAME,MASK X<mkdir> X<md> X<directory, create>, mkdir FILENAME,
2199 mkdir, msgctl ID,CMD,ARG X<msgctl>, msgget KEY,FLAGS X<msgget>, msgrcv
2200 ID,VAR,SIZE,TYPE,FLAGS X<msgrcv>, msgsnd ID,MSG,FLAGS X<msgsnd>, my EXPR
2201 X<my>, my TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL
2202 X<next> X<continue>, next, no Module VERSION LIST X<no>, no Module VERSION,
2203 no Module LIST, no Module, oct EXPR X<oct> X<octal> X<hex> X<hexadecimal>
2204 X<binary> X<bin>, oct, open FILEHANDLE,EXPR X<open> X<pipe> X<file, open>
2205 X<fopen>, open FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, open
2206 FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, opendir DIRHANDLE,EXPR
2207 X<opendir>, ord EXPR X<ord> X<encoding>, ord, our EXPR X<our> X<global>,
2208 our EXPR TYPE, our EXPR : ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST
2209 X<pack>, package NAMESPACE X<package> X<module> X<namespace>, package, pipe
2210 READHANDLE,WRITEHANDLE X<pipe>, pop ARRAY X<pop> X<stack>, pop, pos SCALAR
2211 X<pos> X<match, position>, pos, print FILEHANDLE LIST X<print>, print LIST,
2212 print, printf FILEHANDLE FORMAT, LIST X<printf>, printf FORMAT, LIST,
2213 prototype FUNCTION X<prototype>, push ARRAY,LIST X<push>, X<stack>,
2214 q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR
2215 X<quotemeta> X<metacharacter>, quotemeta, rand EXPR X<rand> X<random>,
2216 rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET X<read>, read
2217 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE X<readdir>, readline EXPR
2218 X<readline> X<gets> X<fgets>, readlink EXPR X<readlink>, readlink, readpipe
2219 EXPR X<readpipe>, recv SOCKET,SCALAR,LENGTH,FLAGS X<recv>, redo LABEL
2220 X<redo>, redo, ref EXPR X<ref> X<reference>, ref, rename OLDNAME,NEWNAME
2221 X<rename> X<move> X<mv> X<ren>, require VERSION X<require>, require EXPR,
2222 require, reset EXPR X<reset>, reset, return EXPR X<return>, return, reverse
2223 LIST X<reverse> X<rev> X<invert>, rewinddir DIRHANDLE X<rewinddir>, rindex
2224 STR,SUBSTR,POSITION X<rindex>, rindex STR,SUBSTR, rmdir FILENAME X<rmdir>
2225 X<rd> X<directory, remove>, rmdir, s///, say FILEHANDLE LIST X<say>, say
2226 LIST, say, scalar EXPR X<scalar> X<context>, seek
2227 FILEHANDLE,POSITION,WHENCE X<seek> X<fseek> X<filehandle, position>,
2228 seekdir DIRHANDLE,POS X<seekdir>, select FILEHANDLE X<select> X<filehandle,
2229 default>, select, select RBITS,WBITS,EBITS,TIMEOUT X<select>, semctl
2230 ID,SEMNUM,CMD,ARG X<semctl>, semget KEY,NSEMS,FLAGS X<semget>, semop
2231 KEY,OPSTRING X<semop>, send SOCKET,MSG,FLAGS,TO X<send>, send
2232 SOCKET,MSG,FLAGS, setpgrp PID,PGRP X<setpgrp> X<group>, setpriority
2233 WHICH,WHO,PRIORITY X<setpriority> X<priority> X<nice> X<renice>, setsockopt
2234 SOCKET,LEVEL,OPTNAME,OPTVAL X<setsockopt>, shift ARRAY X<shift>, shift,
2235 shmctl ID,CMD,ARG X<shmctl>, shmget KEY,SIZE,FLAGS X<shmget>, shmread
2236 ID,VAR,POS,SIZE X<shmread> X<shmwrite>, shmwrite ID,STRING,POS,SIZE,
2237 shutdown SOCKET,HOW X<shutdown>, sin EXPR X<sin> X<sine> X<asin>
2238 X<arcsine>, sin, sleep EXPR X<sleep> X<pause>, sleep, socket
2239 SOCKET,DOMAIN,TYPE,PROTOCOL X<socket>, socketpair
2240 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL X<socketpair>, sort SUBNAME LIST
2241 X<sort> X<qsort> X<quicksort> X<mergesort>, sort BLOCK LIST, sort LIST,
2242 splice ARRAY,OFFSET,LENGTH,LIST X<splice>, splice ARRAY,OFFSET,LENGTH,
2243 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT X<split>,
2244 split /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST
2245 X<sprintf>, format parameter index, flags, vector flag, (minimum) width,
2246 precision, or maximum width X<precision>, size, order of arguments, sqrt
2247 EXPR X<sqrt> X<root> X<square root>, sqrt, srand EXPR X<srand> X<seed>
2248 X<randseed>, srand, stat FILEHANDLE X<stat> X<file, status>, stat EXPR,
2249 stat, study SCALAR X<study>, study, sub NAME BLOCK X<sub>, sub NAME (PROTO)
2250 BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK, substr
2251 EXPR,OFFSET,LENGTH,REPLACEMENT X<substr> X<substring> X<mid> X<left>
2252 X<right>, substr EXPR,OFFSET,LENGTH, substr EXPR,OFFSET, symlink
2253 OLDFILE,NEWFILE X<symlink> X<link> X<symbolic link> X<link, symbolic>,
2254 syscall NUMBER, LIST X<syscall> X<system call>, sysopen
2255 FILEHANDLE,FILENAME,MODE X<sysopen>, sysopen
2256 FILEHANDLE,FILENAME,MODE,PERMS, sysread FILEHANDLE,SCALAR,LENGTH,OFFSET
2257 X<sysread>, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
2258 FILEHANDLE,POSITION,WHENCE X<sysseek> X<lseek>, system LIST X<system>
2259 X<shell>, system PROGRAM LIST, syswrite FILEHANDLE,SCALAR,LENGTH,OFFSET
2260 X<syswrite>, syswrite FILEHANDLE,SCALAR,LENGTH, syswrite FILEHANDLE,SCALAR,
2261 tell FILEHANDLE X<tell>, tell, telldir DIRHANDLE X<telldir>, tie
2262 VARIABLE,CLASSNAME,LIST X<tie>, tied VARIABLE X<tied>, time X<time>
2263 X<epoch>, times X<times>, tr///, truncate FILEHANDLE,LENGTH X<truncate>,
2264 truncate EXPR,LENGTH, uc EXPR X<uc> X<uppercase> X<toupper>, uc, ucfirst
2265 EXPR X<ucfirst> X<uppercase>, ucfirst, umask EXPR X<umask>, umask, undef
2266 EXPR X<undef> X<undefine>, undef, unlink LIST X<unlink> X<delete> X<remove>
2267 X<rm>, unlink, unpack TEMPLATE,EXPR X<unpack>, unpack TEMPLATE, untie
2268 VARIABLE X<untie>, unshift ARRAY,LIST X<unshift>, use Module VERSION LIST
2269 X<use> X<module> X<import>, use Module VERSION, use Module LIST, use
2270 Module, use VERSION, utime LIST X<utime>, values HASH X<values>, vec
2271 EXPR,OFFSET,BITS X<vec> X<bit> X<bit vector>, wait X<wait>, waitpid
2272 PID,FLAGS X<waitpid>, wantarray X<wantarray> X<context>, warn LIST X<warn>
2273 X<warning> X<STDERR>, write FILEHANDLE X<write>, write EXPR, write, y///
2279 =head2 perlopentut - tutorial on opening things in Perl
2285 =item Open E<agrave> la shell
2291 =item Indirect Filehandles
2295 =item The Minus File
2297 =item Mixing Reads and Writes
2303 =item Open E<agrave> la C
2307 =item Permissions E<agrave> la mode
2311 =item Obscure Open Tricks
2315 =item Re-Opening Files (dups)
2317 =item Dispelling the Dweomer
2319 =item Paths as Opens
2321 =item Single Argument Open
2323 =item Playing with STDIN and STDOUT
2327 =item Other I/O Issues
2331 =item Opening Non-File Files
2333 =item Opening Named Pipes
2335 =item Opening Sockets
2347 =item AUTHOR and COPYRIGHT
2353 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
2359 =item The Basic Principle
2363 =item Packing Numbers
2369 =item Unpacking a Stack Frame
2371 =item How to Eat an Egg on a Net
2373 =item Byte-order modifiers
2375 =item Floating point Numbers
2379 =item Exotic Templates
2391 =item Another Portable Binary Encoding
2395 =item Template Grouping
2397 =item Lengths and Widths
2401 =item String Lengths
2403 =item Dynamic Templates
2405 =item Counting Repetitions
2409 =item Packing and Unpacking C Structures
2413 =item The Alignment Pit
2415 =item Dealing with Endian-ness
2417 =item Alignment, Take 2
2419 =item Alignment, Take 3
2421 =item Pointers for How to Use Them
2427 =item Funnies Section
2433 =head2 perlpod - the Plain Old Documentation format
2441 =item Ordinary Paragraph
2442 X<POD, ordinary paragraph>
2444 =item Verbatim Paragraph
2445 X<POD, verbatim paragraph> X<verbatim>
2447 =item Command Paragraph
2450 C<=head1 I<Heading Text>> X<=head1> X<=head2> X<=head3> X<=head4> X<head1>
2451 X<head2> X<head3> X<head4>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
2452 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>> X<=over>
2453 X<=item> X<=back> X<over> X<item> X<back>, C<=item I<stuff...>>, C<=back>,
2454 C<=cut> X<=cut> X<cut>, C<=pod> X<=pod> X<pod>, C<=begin I<formatname>>
2455 X<=begin> X<=end> X<=for> X<begin> X<end> X<for>, C<=end I<formatname>>,
2456 C<=for I<formatname> I<text...>>, C<=encoding I<encodingname>> X<=encoding>
2459 =item Formatting Codes
2460 X<POD, formatting code> X<formatting code>
2461 X<POD, interior sequence> X<interior sequence>
2463 C<IE<lt>textE<gt>> -- italic text X<I> X<< IZ<><> >> X<POD, formatting
2464 code, italic> X<italic>, C<BE<lt>textE<gt>> -- bold text X<B> X<< BZ<><> >>
2465 X<POD, formatting code, bold> X<bold>, C<CE<lt>codeE<gt>> -- code text X<C>
2466 X<< CZ<><> >> X<POD, formatting code, code> X<code>, C<LE<lt>nameE<gt>> --
2467 a hyperlink X<L> X<< LZ<><> >> X<POD, formatting code, hyperlink>
2468 X<hyperlink>, C<EE<lt>escapeE<gt>> -- a character escape X<E> X<< EZ<><> >>
2469 X<POD, formatting code, escape> X<escape>, C<FE<lt>filenameE<gt>> -- used
2470 for filenames X<F> X<< FZ<><> >> X<POD, formatting code, filename>
2471 X<filename>, C<SE<lt>textE<gt>> -- text contains non-breaking spaces X<S>
2472 X<< SZ<><> >> X<POD, formatting code, non-breaking space> X<non-breaking
2473 space>, C<XE<lt>topic nameE<gt>> -- an index entry X<X> X<< XZ<><> >>
2474 X<POD, formatting code, index entry> X<index entry>, C<ZE<lt>E<gt>> -- a
2475 null (zero-effect) formatting code X<Z> X<< ZZ<><> >> X<POD, formatting
2481 =item Embedding Pods in Perl Modules
2484 =item Hints for Writing Pod
2486 X<podchecker> X<POD, validating>
2496 =head2 perlpodspec - Plain Old Documentation: format specification and
2503 =item Pod Definitions
2507 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
2508 "=back", "=begin formatname", "=end formatname", "=for formatname text...",
2509 "=encoding encodingname"
2511 =item Pod Formatting Codes
2513 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2514 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
2515 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
2516 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
2517 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
2518 contains non-breaking spaces
2520 =item Notes on Implementing Pod Processors
2522 =item About LE<lt>...E<gt> Codes
2524 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
2526 =item About =over...=back Regions
2528 =item About Data Paragraphs and "=begin/=end" Regions
2536 =head2 perlrun - how to execute the Perl interpreter
2546 =item #! and quoting on non-Unix systems
2549 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
2551 =item Location of Perl
2552 X<perl, location of interpreter>
2554 =item Command Switches
2555 X<perl, command switches> X<command switches>
2557 B<-0>[I<octal/hexadecimal>] X<-0> X<$/>, B<-A[I<module>][=I<assertions>]>
2558 X<-A>, B<-a> X<-a> X<autosplit>, B<-C [I<number/list>]> X<-C>, B<-c> X<-c>,
2559 B<-d> X<-d> X<-dt>, B<-dt>, B<-d:>I<foo[=bar,baz]> X<-d> X<-dt>,
2560 B<-dt:>I<foo[=bar,baz]>, B<-D>I<letters> X<-D> X<DEBUGGING> X<-DDEBUGGING>,
2561 B<-D>I<number>, B<-e> I<commandline> X<-e>, B<-E> I<commandline> X<-E>,
2562 B<-f> X<-f>, B<-F>I<pattern> X<-F>, B<-h> X<-h>, B<-i>[I<extension>] X<-i>
2563 X<in-place>, B<-I>I<directory> X<-I> X<@INC>, B<-l>[I<octnum>] X<-l> X<$/>
2564 X<$\>, B<-m>[B<->]I<module> X<-m> X<-M>, B<-M>[B<->]I<module>,
2565 B<-M>[B<->]I<'module ...'>, B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>
2566 X<-n>, B<-p> X<-p>, B<-P> X<-P>, B<-s> X<-s>, B<-S> X<-S>, B<-t> X<-t>,
2567 B<-T> X<-T>, B<-u> X<-u>, B<-U> X<-U>, B<-v> X<-v>, B<-V> X<-V>,
2568 B<-V:>I<configvar>, B<-w> X<-w>, B<-W> X<-W>, B<-X> X<-X>, B<-x> X<-x>,
2574 X<perl, environment variables>
2576 HOME X<HOME>, LOGDIR X<LOGDIR>, PATH X<PATH>, PERL5LIB X<PERL5LIB>,
2577 PERL5OPT X<PERL5OPT>, PERLIO X<PERLIO>, :bytes X<:bytes>, :crlf X<:crlf>,
2578 :mmap X<:mmap>, :perlio X<:perlio>, :pop X<:pop>, :raw X<:raw>, :stdio
2579 X<:stdio>, :unix X<:unix>, :utf8 X<:utf8>, :win32 X<:win32>, PERLIO_DEBUG
2580 X<PERLIO_DEBUG>, PERLLIB X<PERLLIB>, PERL5DB X<PERL5DB>, PERL5DB_THREADED
2581 X<PERL5DB_THREADED>, PERL5SHELL (specific to the Win32 port) X<PERL5SHELL>,
2582 PERL_ALLOW_NON_IFS_LSP (specific to the Win32 port)
2583 X<PERL_ALLOW_NON_IFS_LSP>, PERL_DEBUG_MSTATS X<PERL_DEBUG_MSTATS>,
2584 PERL_DESTRUCT_LEVEL X<PERL_DESTRUCT_LEVEL>, PERL_DL_NONLAZY
2585 X<PERL_DL_NONLAZY>, PERL_ENCODING X<PERL_ENCODING>, PERL_HASH_SEED
2586 X<PERL_HASH_SEED>, PERL_HASH_SEED_DEBUG X<PERL_HASH_SEED_DEBUG>, PERL_ROOT
2587 (specific to the VMS port) X<PERL_ROOT>, PERL_SIGNALS X<PERL_SIGNALS>,
2588 PERL_UNICODE X<PERL_UNICODE>, SYS$LOGIN (specific to the VMS port)
2593 =head2 perldiag - various Perl diagnostics
2601 =head2 perllexwarn - Perl Lexical Warnings
2609 =item Default Warnings and Optional Warnings
2611 =item What's wrong with B<-w> and C<$^W>
2613 =item Controlling Warnings from the Command Line
2615 B<-w> X<-w>, B<-W> X<-W>, B<-X> X<-X>
2617 =item Backward Compatibility
2619 =item Category Hierarchy
2620 X<warning, categories>
2622 =item Fatal Warnings
2625 =item Reporting Warnings from a Module
2626 X<warning, reporting> X<warning, registering>
2638 =head2 perldebug - Perl debugging
2644 =item The Perl Debugger
2648 =item Debugger Commands
2650 h X<debugger command, h>, h [command], h h, p expr X<debugger command, p>,
2651 x [maxdepth] expr X<debugger command, x>, V [pkg [vars]] X<debugger
2652 command, V>, X [vars] X<debugger command, X>, y [level [vars]] X<debugger
2653 command, y>, T X<debugger command, T> X<backtrace> X<stack, backtrace>, s
2654 [expr] X<debugger command, s> X<step>, n [expr] X<debugger command, n>, r
2655 X<debugger command, r>, <CR>, c [line|sub] X<debugger command, c>, l
2656 X<debugger command, l>, l min+incr, l min-max, l line, l subname, -
2657 X<debugger command, ->, v [line] X<debugger command, v>, . X<debugger
2658 command, .>, f filename X<debugger command, f>, /pattern/, ?pattern?, L
2659 [abw] X<debugger command, L>, S [[!]regex] X<debugger command, S>, t
2660 X<debugger command, t>, t expr X<debugger command, t>, b X<breakpoint>
2661 X<debugger command, b>, b [line] [condition] X<breakpoint> X<debugger
2662 command, b>, b subname [condition] X<breakpoint> X<debugger command, b>, b
2663 postpone subname [condition] X<breakpoint> X<debugger command, b>, b load
2664 filename X<breakpoint> X<debugger command, b>, b compile subname
2665 X<breakpoint> X<debugger command, b>, B line X<breakpoint> X<debugger
2666 command, B>, B * X<breakpoint> X<debugger command, B>, a [line] command
2667 X<debugger command, a>, A line X<debugger command, A>, A * X<debugger
2668 command, A>, w expr X<debugger command, w>, W expr X<debugger command, W>,
2669 W * X<debugger command, W>, o X<debugger command, o>, o booloption ...
2670 X<debugger command, o>, o anyoption? ... X<debugger command, o>, o
2671 option=value ... X<debugger command, o>, < ? X<< debugger command, < >>, <
2672 [ command ] X<< debugger command, < >>, < * X<< debugger command, < >>, <<
2673 command X<< debugger command, << >>, > ? X<< debugger command, > >>, >
2674 command X<< debugger command, > >>, > * X<< debugger command, > >>, >>
2675 command X<<< debugger command, >> >>>, { ? X<debugger command, {>, { [
2676 command ], { * X<debugger command, {>, {{ command X<debugger command, {{>,
2677 ! number X<debugger command, !>, ! -number X<debugger command, !>, !
2678 pattern X<debugger command, !>, !! cmd X<debugger command, !!>, source file
2679 X<debugger command, source>, H -number X<debugger command, H>, q or ^D
2680 X<debugger command, q> X<debugger command, ^D>, R X<debugger command, R>,
2681 |dbcmd X<debugger command, |>, ||dbcmd X<debugger command, ||>, command, m
2682 expr X<debugger command, m>, M X<debugger command, M>, man [manpage]
2683 X<debugger command, man>
2685 =item Configurable Options
2687 C<recallCommand>, C<ShellBang> X<debugger option, recallCommand> X<debugger
2688 option, ShellBang>, C<pager> X<debugger option, pager>, C<tkRunning>
2689 X<debugger option, tkRunning>, C<signalLevel>, C<warnLevel>, C<dieLevel>
2690 X<debugger option, signalLevel> X<debugger option, warnLevel> X<debugger
2691 option, dieLevel>, C<AutoTrace> X<debugger option, AutoTrace>, C<LineInfo>
2692 X<debugger option, LineInfo>, C<inhibit_exit> X<debugger option,
2693 inhibit_exit>, C<PrintRet> X<debugger option, PrintRet>, C<ornaments>
2694 X<debugger option, ornaments>, C<frame> X<debugger option, frame>,
2695 C<maxTraceLen> X<debugger option, maxTraceLen>, C<windowSize> X<debugger
2696 option, windowSize>, C<arrayDepth>, C<hashDepth> X<debugger option,
2697 arrayDepth> X<debugger option, hashDepth>, C<dumpDepth> X<debugger option,
2698 dumpDepth>, C<compactDump>, C<veryCompact> X<debugger option, compactDump>
2699 X<debugger option, veryCompact>, C<globPrint> X<debugger option,
2700 globPrint>, C<DumpDBFiles> X<debugger option, DumpDBFiles>, C<DumpPackages>
2701 X<debugger option, DumpPackages>, C<DumpReused> X<debugger option,
2702 DumpReused>, C<quote>, C<HighBit>, C<undefPrint> X<debugger option, quote>
2703 X<debugger option, HighBit> X<debugger option, undefPrint>, C<UsageOnly>
2704 X<debugger option, UsageOnly>, C<TTY> X<debugger option, TTY>, C<noTTY>
2705 X<debugger option, noTTY>, C<ReadLine> X<debugger option, ReadLine>,
2706 C<NonStop> X<debugger option, NonStop>
2708 =item Debugger input/output
2710 Prompt, Multiline commands, Stack backtrace X<backtrace> X<stack,
2711 backtrace>, Line Listing Format, Frame listing
2713 =item Debugging compile-time statements
2715 =item Debugger Customization
2717 =item Readline Support
2719 =item Editor Support for Debugging
2721 =item The Perl Profiler
2722 X<profile> X<profiling> X<profiler>
2726 =item Debugging regular expressions
2727 X<regular expression, debugging>
2728 X<regex, debugging> X<regexp, debugging>
2730 =item Debugging memory usage
2739 =head2 perlvar - Perl predefined variables
2747 =item Predefined Names
2749 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
2750 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+,
2751 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
2752 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
2753 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
2754 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
2755 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
2756 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;,
2757 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
2758 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
2759 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
2760 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
2761 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
2762 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
2763 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
2764 C<substr($var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
2765 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
2766 IO::Handle->format_line_break_characters EXPR,
2767 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
2768 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?,
2769 ${^CHILD_ERROR_NATIVE}, ${^ENCODING}, $OS_ERROR, $ERRNO, $!, %!,
2770 $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@, $PROCESS_ID, $PID, $$,
2771 $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID, $>, $REAL_GROUP_ID,
2772 $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $), $PROGRAM_NAME, $0, $[, $],
2773 $COMPILING, $^C, $DEBUGGING, $^D, ${^RE_DEBUG_FLAGS}, ${^RE_TRIE_MAXBUF},
2774 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
2775 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
2776 0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R,
2777 $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, ${^UNICODE},
2778 ${^UTF8CACHE}, ${^UTF8LOCALE}, $PERL_VERSION, $^V, $WARNING, $^W,
2779 ${^WARNING_BITS}, ${^WIN32_SLOPPY_STAT}, $EXECUTABLE_NAME, $^X, ARGV,
2780 $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG,
2783 =item Error Indicators
2785 =item Technical Note on the Syntax of Variable Names
2793 =head2 perlre - Perl regular expressions
2799 i X</i> X<regex, case-insensitive> X<regexp, case-insensitive> X<regular
2800 expression, case-insensitive>, m X</m> X<regex, multiline> X<regexp,
2801 multiline> X<regular expression, multiline>, s X</s> X<regex, single-line>
2802 X<regexp, single-line> X<regular expression, single-line>, x X</x>
2806 =item Regular Expressions
2808 [1], [2], [3], cntrl X<cntrl>, graph X<graph>, print X<print>, punct
2809 X<punct>, xdigit X<xdigit>
2811 =item Extended Patterns
2813 C<(?#text)> X<(?#)>, C<(?imsx-imsx)> X<(?)>, C<(?:pattern)> X<(?:)>,
2814 C<(?imsx-imsx:pattern)>, C<(?=pattern)> X<(?=)> X<look-ahead, positive>
2815 X<lookahead, positive>, C<(?!pattern)> X<(?!)> X<look-ahead, negative>
2816 X<lookahead, negative>, C<(?<=pattern)> X<(?<=)> X<look-behind, positive>
2817 X<lookbehind, positive>, C<(?<!pattern)> X<(?<!)> X<look-behind, negative>
2818 X<lookbehind, negative>, C<(?{ code })> X<(?{})> X<regex, code in>
2819 X<regexp, code in> X<regular expression, code in>, C<(??{ code })>
2820 X<(??{})> X<regex, postponed> X<regexp, postponed> X<regular expression,
2821 postponed> X<regex, recursive> X<regexp, recursive> X<regular expression,
2822 recursive>, C<< (?>pattern) >> X<backtrack> X<backtracking>,
2823 C<(?(condition)yes-pattern|no-pattern)> X<(?()>,
2824 C<(?(condition)yes-pattern)>
2827 X<backtrack> X<backtracking>
2829 =item Version 8 Regular Expressions
2830 X<regular expression, version 8> X<regex, version 8> X<regexp, version 8>
2832 =item Warning on \1 vs $1
2834 =item Repeated patterns matching zero-length substring
2836 =item Combining pieces together
2838 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
2839 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
2840 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
2841 C<(?(condition)yes-pattern|no-pattern)>
2843 =item Creating custom RE engines
2853 =head2 perlreref - Perl Regular Expressions Reference
2865 =item ESCAPE SEQUENCES
2867 =item CHARACTER CLASSES
2873 =item EXTENDED CONSTRUCTS
2891 =head2 perlref - Perl references and nested data structures
2901 =item Making References
2902 X<reference, creation> X<referencing>
2904 1. X<\> X<backslash>, 2. X<array, anonymous> X<[> X<[]> X<square bracket>
2905 X<bracket, square> X<arrayref> X<array reference> X<reference, array>, 3.
2906 X<hash, anonymous> X<{> X<{}> X<curly bracket> X<bracket, curly> X<brace>
2907 X<hashref> X<hash reference> X<reference, hash>, 4. X<subroutine,
2908 anonymous> X<subroutine, reference> X<reference, subroutine> X<scope,
2909 lexical> X<closure> X<lexical> X<lexical scope>, 5. X<constructor> X<new>,
2910 6. X<autovivification>, 7. X<*foo{THING}> X<*>
2912 =item Using References
2913 X<reference, use> X<dereferencing> X<dereference>
2915 2. X<${}> X<@{}> X<%{}>, 3. X<autovivification> X<< -> >> X<arrow>, 4.
2918 =item Symbolic references
2919 X<reference, symbolic> X<reference, soft>
2920 X<symbolic reference> X<soft reference>
2922 =item Not-so-symbolic references
2924 =item Pseudo-hashes: Using an array as a hash
2925 X<pseudo-hash> X<pseudo hash> X<pseudohash>
2927 =item Function Templates
2928 X<scope, lexical> X<closure> X<lexical> X<lexical scope>
2929 X<subroutine, nested> X<sub, nested> X<subroutine, local> X<sub, local>
2934 X<reference, string context> X<reference, use as hash key>
2940 =head2 perlform - Perl formats
2949 X<format, text field>
2951 =item Numeric Fields
2952 X<#> X<format, numeric field>
2954 =item The Field @* for Variable Width Multi-Line Text
2957 =item The Field ^* for Variable Width One-line-at-a-time Text
2960 =item Specifying Values
2961 X<format, specifying values>
2963 =item Using Fill Mode
2964 X<format, fill mode>
2966 =item Suppressing Lines Where All Fields Are Void
2967 X<format, suppressing lines>
2969 =item Repeating Format Lines
2970 X<format, repeating lines>
2972 =item Top of Form Processing
2973 X<format, top of form> X<top> X<header>
2975 =item Format Variables
2977 X<format, variables>
2986 X<format, footer> X<footer>
2988 =item Accessing Formatting Internals
2989 X<format, internals>
2997 =head2 perlobj - Perl objects
3005 =item An Object is Simply a Reference
3006 X<object> X<bless> X<constructor> X<new>
3008 =item A Class is Simply a Package
3009 X<class> X<package> X<@ISA> X<inheritance>
3011 =item A Method is Simply a Subroutine
3014 =item Method Invocation
3015 X<invocation> X<method> X<arrow> X<< -> >>
3017 =item Indirect Object Syntax
3018 X<indirect object syntax> X<invocation, indirect> X<indirect>
3020 =item Default UNIVERSAL methods
3023 isa(CLASS) X<isa>, can(METHOD) X<can>, VERSION( [NEED] ) X<VERSION>
3026 X<destructor> X<DESTROY>
3030 =item Two-Phased Garbage Collection
3031 X<garbage collection> X<GC> X<circular reference>
3032 X<reference, circular> X<DESTROY> X<destructor>
3040 =head2 perltie - how to hide an object class in a simple variable
3053 TIESCALAR classname, LIST X<TIESCALAR>, FETCH this X<FETCH>, STORE this,
3054 value X<STORE>, UNTIE this X<UNTIE>, DESTROY this X<DESTROY>
3059 TIEARRAY classname, LIST X<TIEARRAY>, FETCH this, index X<FETCH>, STORE
3060 this, index, value X<STORE>, FETCHSIZE this X<FETCHSIZE>, STORESIZE this,
3061 count X<STORESIZE>, EXTEND this, count X<EXTEND>, EXISTS this, key
3062 X<EXISTS>, DELETE this, key X<DELETE>, CLEAR this X<CLEAR>, PUSH this, LIST
3063 X<PUSH>, POP this X<POP>, SHIFT this X<SHIFT>, UNSHIFT this, LIST
3064 X<UNSHIFT>, SPLICE this, offset, length, LIST X<SPLICE>, UNTIE this
3065 X<UNTIE>, DESTROY this X<DESTROY>
3070 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST X<TIEHASH>, FETCH this,
3071 key X<FETCH>, STORE this, key, value X<STORE>, DELETE this, key X<DELETE>,
3072 CLEAR this X<CLEAR>, EXISTS this, key X<EXISTS>, FIRSTKEY this X<FIRSTKEY>,
3073 NEXTKEY this, lastkey X<NEXTKEY>, SCALAR this X<SCALAR>, UNTIE this
3074 X<UNTIE>, DESTROY this X<DESTROY>
3076 =item Tying FileHandles
3077 X<filehandle, tying>
3079 TIEHANDLE classname, LIST X<TIEHANDLE>, WRITE this, LIST X<WRITE>, PRINT
3080 this, LIST X<PRINT>, PRINTF this, LIST X<PRINTF>, READ this, LIST X<READ>,
3081 READLINE this X<READLINE>, GETC this X<GETC>, CLOSE this X<CLOSE>, UNTIE
3082 this X<UNTIE>, DESTROY this X<DESTROY>
3087 =item The C<untie> Gotcha
3100 =head2 perldbmfilter - Perl DBM Filters
3108 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
3109 B<filter_fetch_value>
3115 =item An Example -- the NULL termination problem.
3117 =item Another Example -- Key is a C int.
3127 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
3128 safe subprocesses, sockets, and semaphores)
3138 =item Handling the SIGHUP Signal in Daemons
3146 =item Deferred Signals (Safe Signals)
3148 Long running opcodes, Interrupting IO, Restartable system calls, Signals as
3149 "faults", Signals triggered by operating system state
3153 =item Using open() for IPC
3159 =item Background Processes
3161 =item Complete Dissociation of Child from Parent
3163 =item Safe Pipe Opens
3165 =item Bidirectional Communication with Another Process
3167 =item Bidirectional Communication with Yourself
3171 =item Sockets: Client/Server Communication
3175 =item Internet Line Terminators
3177 =item Internet TCP Clients and Servers
3179 =item Unix-Domain TCP Clients and Servers
3183 =item TCP Clients with IO::Socket
3187 =item A Simple Client
3189 C<Proto>, C<PeerAddr>, C<PeerPort>
3191 =item A Webget Client
3193 =item Interactive Client with IO::Socket
3197 =item TCP Servers with IO::Socket
3199 Proto, LocalPort, Listen, Reuse
3201 =item UDP: Message Passing
3215 =head2 perlfork - Perl's fork() emulation
3225 =item Behavior of other Perl features in forked pseudo-processes
3227 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
3228 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
3229 files, directories and network sockets
3231 =item Resource limits
3233 =item Killing the parent process
3235 =item Lifetime of the parent process and pseudo-processes
3237 =item CAVEATS AND LIMITATIONS
3239 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
3240 Global state maintained by XSUBs, Interpreter embedded in larger
3241 application, Thread-safety of extensions
3253 =head2 perlnumber - semantics of numbers and numeric operations in Perl
3261 =item Storing numbers
3263 =item Numeric operators and numeric conversions
3265 =item Flavors of Perl numeric operations
3267 Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other
3268 mathematical operators, Bitwise operators, Bitwise operators during C<use
3269 integer>, Operators which expect an integer, Operators which expect a
3278 =head2 perlthrtut - tutorial on threads in Perl
3286 =item What Is A Thread Anyway?
3288 =item Threaded Program Models
3300 =item What kind of threads are Perl threads?
3302 =item Thread-Safe Modules
3308 =item Basic Thread Support
3310 =item A Note about the Examples
3312 =item Creating Threads
3314 =item Waiting For A Thread To Exit
3316 =item Ignoring A Thread
3320 =item Threads And Data
3324 =item Shared And Unshared Data
3326 =item Thread Pitfalls: Races
3330 =item Synchronization and control
3334 =item Controlling access: lock()
3336 =item A Thread Pitfall: Deadlocks
3338 =item Queues: Passing Data Around
3340 =item Semaphores: Synchronizing Data Access
3342 =item Basic semaphores
3344 =item Advanced Semaphores
3346 =item cond_wait() and cond_signal()
3348 =item Giving up control
3352 =item General Thread Utility Routines
3356 =item What Thread Am I In?
3360 =item Are These Threads The Same?
3362 =item What Threads Are Running?
3366 =item A Complete Example
3368 =item Different implementations of threads
3370 =item Performance considerations
3372 =item Process-scope Changes
3374 =item Thread-Safety of System Libraries
3382 =item Introductory Texts
3384 =item OS-Related References
3386 =item Other References
3390 =item Acknowledgements
3398 =head2 perlothrtut - old tutorial on threads in Perl
3404 =item What Is A Thread Anyway?
3406 =item Threaded Program Models
3418 =item Native threads
3420 =item What kind of threads are perl threads?
3422 =item Threadsafe Modules
3428 =item Basic Thread Support
3430 =item Creating Threads
3432 =item Giving up control
3434 =item Waiting For A Thread To Exit
3436 =item Errors In Threads
3438 =item Ignoring A Thread
3442 =item Threads And Data
3446 =item Shared And Unshared Data
3448 =item Thread Pitfall: Races
3450 =item Controlling access: lock()
3452 =item Thread Pitfall: Deadlocks
3454 =item Queues: Passing Data Around
3458 =item Threads And Code
3462 =item Semaphores: Synchronizing Data Access
3464 Basic semaphores, Advanced Semaphores
3466 =item Attributes: Restricting Access To Subroutines
3468 =item Subroutine Locks
3472 =item Locking A Subroutine
3476 =item General Thread Utility Routines
3480 =item What Thread Am I In?
3484 =item Are These Threads The Same?
3486 =item What Threads Are Running?
3490 =item A Complete Example
3498 =item Introductory Texts
3500 =item OS-Related References
3502 =item Other References
3506 =item Acknowledgements
3514 =head2 perlport - Writing portable Perl
3520 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
3529 =item Numbers endianness and Width
3531 =item Files and Filesystems
3533 =item System Interaction
3535 =item Command names versus file pathnames
3539 =item Interprocess Communication (IPC)
3541 =item External Subroutines (XS)
3543 =item Standard Modules
3547 =item Character sets and character encoding
3549 =item Internationalisation
3551 =item System Resources
3567 =item DOS and Derivatives
3575 =item EBCDIC Platforms
3583 =item FUNCTION IMPLEMENTATIONS
3587 =item Alphabetical Listing of Perl Functions
3589 -I<X>, atan2, binmode, chmod, chown, chroot, crypt, dbmclose, dbmopen,
3590 dump, exec, exit, fcntl, flock, fork, getlogin, getpgrp, getppid,
3591 getpriority, getpwnam, getgrnam, getnetbyname, getpwuid, getgrgid,
3592 getnetbyaddr, getprotobynumber, getservbyport, getpwent, getgrent,
3593 gethostbyname, gethostent, getnetent, getprotoent, getservent, sethostent,
3594 setnetent, setprotoent, setservent, endpwent, endgrent, endhostent,
3595 endnetent, endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob,
3596 gmtime, ioctl FILEHANDLE,FUNCTION,SCALAR, kill, link, localtime, lstat,
3597 msgctl, msgget, msgsnd, msgrcv, open, pipe, readlink, rename, select,
3598 semctl, semget, semop, setgrent, setpgrp, setpriority, setpwent,
3599 setsockopt, shmctl, shmget, shmread, shmwrite, sockatmark, socketpair,
3600 stat, symlink, syscall, sysopen, system, times, truncate, umask, utime,
3605 =item Supported Platforms
3609 =item AUTHORS / CONTRIBUTORS
3613 =head2 perllocale - Perl locale handling (internationalization and
3620 =item PREPARING TO USE LOCALES
3626 =item The use locale pragma
3628 =item The setlocale function
3630 =item Finding locales
3632 =item LOCALE PROBLEMS
3634 =item Temporarily fixing locale problems
3636 =item Permanently fixing locale problems
3638 =item Permanently fixing your system's locale configuration
3640 =item Fixing system locale configuration
3642 =item The localeconv function
3644 =item I18N::Langinfo
3648 =item LOCALE CATEGORIES
3652 =item Category LC_COLLATE: Collation
3654 =item Category LC_CTYPE: Character Types
3656 =item Category LC_NUMERIC: Numeric Formatting
3658 =item Category LC_MONETARY: Formatting of monetary amounts
3662 =item Other categories
3670 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
3671 LC_NUMERIC, LC_TIME, LANG
3677 =item Backward compatibility
3679 =item I18N:Collate obsolete
3681 =item Sort speed and memory use impacts
3683 =item write() and LC_NUMERIC
3685 =item Freely available locale definitions
3689 =item An imperfect standard
3693 =item Unicode and UTF-8
3699 =item Broken systems
3709 =head2 perluniintro - Perl Unicode introduction
3719 =item Perl's Unicode Support
3721 =item Perl's Unicode Model
3723 =item Unicode and EBCDIC
3725 =item Creating Unicode
3727 =item Handling Unicode
3729 =item Legacy Encodings
3733 =item Displaying Unicode As Text
3737 =item Advanced Topics
3741 =item Questions With Answers
3743 =item Hexadecimal Notation
3745 =item Further Resources
3749 =item UNICODE IN OLDER PERLS
3753 =item ACKNOWLEDGMENTS
3755 =item AUTHOR, COPYRIGHT, AND LICENSE
3759 =head2 perlunicode - Unicode support in Perl
3767 =item Important Caveats
3769 Input and Output Layers, Regular Expressions, C<use utf8> still needed to
3770 enable UTF-8/UTF-EBCDIC in scripts, BOM-marked scripts and UTF-16 scripts
3771 autodetected, C<use encoding> needed to upgrade non-Latin-1 byte strings
3773 =item Byte and Character Semantics
3775 =item Effects of Character Semantics
3781 =item User-Defined Character Properties
3783 =item Character Encodings for Input and Output
3785 =item Unicode Regular Expression Support Level
3787 =item Unicode Encodings
3789 =item Security Implications of Unicode
3791 =item Unicode in Perl on EBCDIC
3795 =item When Unicode Does Not Happen
3797 =item Forcing Unicode in Perl (Or Unforcing Unicode in Perl)
3799 =item Using Unicode in XS
3807 =item Interaction with Locales
3809 =item Interaction with Extensions
3813 =item Porting code from perl-5.6.X
3821 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
3827 =item COMMON CHARACTER CODE SETS
3835 =item Latin 1 (ISO 8859-1)
3839 =item 13 variant characters
3847 =item Unicode code points versus EBCDIC code points
3849 =item Remaining Perl Unicode problems in EBCDIC
3851 =item Unicode and UTF
3857 =item SINGLE OCTET TABLES
3859 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
3861 =item IDENTIFYING CHARACTER CODE SETS
3875 =item OPERATOR DIFFERENCES
3877 =item FUNCTION DIFFERENCES
3879 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
3881 =item REGULAR EXPRESSION DIFFERENCES
3889 =item Ignore ASCII vs. EBCDIC sort differences.
3891 =item MONO CASE then sort data.
3893 =item Convert, sort data, then re convert.
3895 =item Perform sorting on one type of machine only.
3899 =item TRANSFORMATION FORMATS
3903 =item URL decoding and encoding
3905 =item uu encoding and decoding
3907 =item Quoted-Printable encoding and decoding
3909 =item Caesarian ciphers
3913 =item Hashing order and checksums
3917 =item MULTI OCTET CHARACTER SETS
3929 chcp, dataset access, OS/390, z/OS iconv, locales
3949 =head2 perlsec - Perl security
3957 =item Laundering and Detecting Tainted Data
3959 =item Switches On the "#!" Line
3961 =item Taint mode and @INC
3963 =item Cleaning Up Your Path
3967 =item Protecting Your Programs
3971 =item Algorithmic Complexity Attacks
3979 =head2 perlmod - Perl modules (packages and symbol tables)
3988 X<package> X<namespace> X<variable, global> X<global variable> X<global>
3991 X<symbol table> X<stash> X<%::> X<%main::> X<typeglob> X<glob> X<alias>
3993 =item BEGIN, CHECK, INIT and END
3994 X<BEGIN> X<CHECK> X<INIT> X<END>
4002 =item Making your module threadsafe
4003 X<threadsafe> X<thread safe>
4004 X<module, threadsafe> X<module, thread safe>
4005 X<CLONE> X<CLONE_SKIP> X<thread> X<threads> X<ithread>
4013 =head2 perlmodlib - constructing new Perl modules and finding existing ones
4017 =item THE PERL MODULE LIBRARY
4021 =item Pragmatic Modules
4023 assertions, assertions::activate, assertions::compat, attributes, attrs,
4024 autouse, base, bigint, bignum, bigrat, blib, bytes, charnames, constant,
4025 diagnostics, encoding, encoding::warnings, feature, fields, filetest, if,
4026 integer, less, lib, locale, open, ops, overload, re, sigtrap, sort, strict,
4027 subs, threads, threads::shared, utf8, vars, version, vmsish, warnings,
4030 =item Standard Modules
4032 AnyDBM_File, Archive::Tar, Archive::Tar::File, Attribute::Handlers,
4033 AutoLoader, AutoSplit, B, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode,
4034 B::C, B::CC, B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint,
4035 B::Showlex, B::Stackobj, B::Stash, B::Terse, B::Xref, Benchmark,
4036 ByteLoader, CGI, CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast,
4037 CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util, CPAN, CPAN::FirstTime,
4038 CPAN::Nox, CPAN::Version, Carp, Carp::Heavy, Class::ISA, Class::Struct,
4039 Compress::Zlib, Compress::Zlib::pod::FAQ, Config, Cwd, DB, DBM_Filter,
4040 DB_File, Data::Dumper, Devel::DProf, Devel::PPPort, Devel::Peek,
4041 Devel::SelfStubber, Digest, Digest::MD5, Digest::SHA, Digest::base,
4042 Digest::file, DirHandle, Dumpvalue, DynaLoader, Encode, Encode::Alias,
4043 Encode::Byte, Encode::CJKConstants, Encode::CN, Encode::CN::HZ,
4044 Encode::Config, Encode::EBCDIC, Encode::Encoder, Encode::Encoding,
4045 Encode::Guess, Encode::JP, Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR,
4046 Encode::KR::2022_KR, Encode::MIME::Header, Encode::PerlIO,
4047 Encode::Supported, Encode::Symbol, Encode::TW, Encode::Unicode,
4048 Encode::Unicode::UTF7, English, Env, Errno, Exporter, Exporter::Heavy,
4049 ExtUtils::CBuilder, ExtUtils::CBuilder::Platform::Windows,
4050 ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant,
4051 ExtUtils::Constant::Base, ExtUtils::Constant::Utils,
4052 ExtUtils::Constant::XS, ExtUtils::Embed, ExtUtils::Install,
4053 ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_AIX,
4054 ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS,
4055 ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_QNX,
4056 ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_VOS,
4057 ExtUtils::MM_Win32, ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker,
4058 ExtUtils::MakeMaker::Config, ExtUtils::MakeMaker::FAQ,
4059 ExtUtils::MakeMaker::Tutorial, ExtUtils::MakeMaker::bytes,
4060 ExtUtils::MakeMaker::vmsish, ExtUtils::Manifest, ExtUtils::Mkbootstrap,
4061 ExtUtils::Mksymlists, ExtUtils::Packlist, ExtUtils::ParseXS,
4062 ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree,
4063 File::Compare, File::Copy, File::DosGlob, File::Find, File::Glob,
4064 File::GlobMapper, File::Path, File::Spec, File::Spec::Cygwin,
4065 File::Spec::Epoc, File::Spec::Functions, File::Spec::Mac, File::Spec::OS2,
4066 File::Spec::Unix, File::Spec::VMS, File::Spec::Win32, File::Temp,
4067 File::stat, FileCache, FileHandle, Filter::Simple, Filter::Util::Call,
4068 FindBin, GDBM_File, Getopt::Long, Getopt::Std, Hash::Util, I18N::Collate,
4069 I18N::LangTags, I18N::LangTags::Detect, I18N::LangTags::List,
4070 I18N::Langinfo, IO, IO::Compress::Deflate, IO::Compress::Gzip,
4071 IO::Compress::RawDeflate, IO::Dir, IO::File, IO::Handle, IO::Pipe,
4072 IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET,
4073 IO::Socket::UNIX, IO::Uncompress::AnyInflate, IO::Uncompress::Gunzip,
4074 IO::Uncompress::Inflate, IO::Uncompress::RawInflate, IO::Zlib, IPC::Open2,
4075 IPC::Open3, IPC::SysV, IPC::SysV::Msg, IPC::SysV::Semaphore, List::Util,
4076 Locale::Constants, Locale::Country, Locale::Currency, Locale::Language,
4077 Locale::Maketext, Locale::Maketext::TPJ13, Locale::Script, MIME::Base64,
4078 MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt,
4079 Math::BigInt::Calc, Math::BigInt::CalcEmu, Math::BigInt::FastCalc,
4080 Math::BigRat, Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File,
4081 Memoize::Expire, Memoize::ExpireFile, Memoize::ExpireTest,
4082 Memoize::NDBM_File, Memoize::SDBM_File, Memoize::Storable,
4083 Module::CoreList, NDBM_File, NEXT, Net::Cmd, Net::Config, Net::Domain,
4084 Net::FTP, Net::NNTP, Net::Netrc, Net::POP3, Net::Ping, Net::SMTP,
4085 Net::Time, Net::hostent, Net::libnetFAQ, Net::netent, Net::protoent,
4086 Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO, PerlIO::encoding,
4087 PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint, Pod::Checker,
4088 Pod::Escapes, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects,
4089 Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser,
4090 Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff,
4091 Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText,
4092 Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer,
4093 Pod::Select, Pod::Simple, Pod::Simple::Checker, Pod::Simple::Debug,
4094 Pod::Simple::DumpAsText, Pod::Simple::DumpAsXML, Pod::Simple::HTML,
4095 Pod::Simple::HTMLBatch, Pod::Simple::LinkSection, Pod::Simple::Methody,
4096 Pod::Simple::PullParser, Pod::Simple::PullParserEndToken,
4097 Pod::Simple::PullParserStartToken, Pod::Simple::PullParserTextToken,
4098 Pod::Simple::PullParserToken, Pod::Simple::RTF, Pod::Simple::Search,
4099 Pod::Simple::SimpleTree, Pod::Simple::Subclassing, Pod::Simple::Text,
4100 Pod::Simple::TextContent, Pod::Simple::XMLOutStream, Pod::Text,
4101 Pod::Text::Color, Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage,
4102 SDBM_File, Safe, Scalar::Util, Search::Dict, SelectSaver, SelfLoader,
4103 Shell, Socket, Storable, Switch, Symbol, Sys::Hostname, Sys::Syslog,
4104 Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine, Test,
4105 Test::Builder, Test::Builder::Module, Test::Builder::Tester,
4106 Test::Builder::Tester::Color, Test::Harness, Test::Harness::Assert,
4107 Test::Harness::Iterator, Test::Harness::Point, Test::Harness::Straps,
4108 Test::Harness::TAP, Test::More, Test::Simple, Test::Tutorial, Text::Abbrev,
4109 Text::Balanced, Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap,
4110 Thread, Thread::Queue, Thread::Semaphore, Thread::Signal, Thread::Specific,
4111 Tie::Array, Tie::File, Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash,
4112 Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::gmtime,
4113 Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate, Unicode::Normalize,
4114 Unicode::UCD, User::grent, User::pwent, XS::APItest, XS::Typemap, XSLoader
4116 =item Extension Modules
4130 China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi
4131 Arabia, Singapore, South Korea, Taiwan, Thailand
4133 =item Central America
4139 Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Czech
4140 Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary,
4141 Iceland, Ireland, Italy, Latvia, Lithuania, Netherlands, Norway, Poland,
4142 Portugal, Romania, Russia, Slovakia, Slovenia, Spain, Sweden, Switzerland,
4143 Turkey, Ukraine, United Kingdom
4147 Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States,
4148 Alabama, California, Colorado, Delaware, District of Columbia, Florida,
4149 Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey, New York,
4150 North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, Utah,
4151 Virginia, Washington, Wisconsin
4155 Australia, New Zealand, United States
4159 Argentina, Brazil, Chile
4165 =item Modules: Creation, Use, and Abuse
4169 =item Guidelines for Module Creation
4171 =item Guidelines for Converting Perl 4 Library Scripts into Modules
4173 =item Guidelines for Reusing Application Code
4181 =head2 perlmodstyle - Perl module style guide
4187 =item QUICK CHECKLIST
4191 =item Before you start
4199 =item Release considerations
4203 =item BEFORE YOU START WRITING A MODULE
4207 =item Has it been done before?
4209 =item Do one thing and do it well
4211 =item What's in a name?
4215 =item DESIGNING AND WRITING YOUR MODULE
4219 =item To OO or not to OO?
4221 =item Designing your API
4223 Write simple routines to do simple things, Separate functionality from
4224 output, Provide sensible shortcuts and defaults, Naming conventions,
4227 =item Strictness and warnings
4229 =item Backwards compatibility
4231 =item Error handling and messages
4235 =item DOCUMENTING YOUR MODULE
4241 =item README, INSTALL, release notes, changelogs
4243 perl Makefile.PL, make, make test, make install, perl Build.PL, perl Build,
4244 perl Build test, perl Build install
4248 =item RELEASE CONSIDERATIONS
4252 =item Version numbering
4254 =item Pre-requisites
4264 =item COMMON PITFALLS
4268 =item Reinventing the wheel
4270 =item Trying to do too much
4272 =item Inappropriate documentation
4278 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Packaging Tools,
4279 Testing tools, http://pause.perl.org/, Any good book on software
4286 =head2 perlmodinstall - Installing CPAN Modules
4296 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
4297 module (sometimes unnecessary), B<INSTALL> the module
4311 =head2 perlnewmod - preparing a new module for distribution
4321 =item What should I make into a module?
4323 =item Step-by-step: Preparing the ground
4325 Look around, Check it's new, Discuss the need, Choose a name, Check again
4327 =item Step-by-step: Making the module
4329 Start with F<module-starter> or F<h2xs>, Use L<strict|strict> and
4330 L<warnings|warnings>, Use L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!,
4331 Use L<plain old documentation|perlpod>, Write tests, Write the README
4333 =item Step-by-step: Distributing your module
4335 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
4336 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
4346 =head2 perlpragma - how to write a user pragma
4352 =item A basic example
4354 =item Implementation details
4358 =head2 perlutil - utilities packaged with the Perl distribution
4364 =item LIST OF UTILITIES
4370 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
4371 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
4372 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
4373 L<roffitall|roffitall>
4377 L<a2p|a2p>, L<s2p|s2p> and L<psed>, L<find2perl|find2perl>
4379 =item Administration
4381 L<config_data|config_data>, L<libnetcfg|libnetcfg>, L<perlivp>
4385 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
4386 L<h2xs|h2xs>, L<enc2xs>, L<xsubpp>, L<dprofpp|dprofpp>, L<perlcc|perlcc>,
4387 L<prove>, L<corelist>
4391 L<piconv>, L<ptar>, L<ptardiff>, L<shasum>
4395 L<cpan>, L<instmodsh>
4403 =head2 perlcompile - Introduction to the Perl Compiler-Translator
4413 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
4417 =item Using The Back Ends
4421 =item The Cross Referencing Back End
4425 =item The Decompiling Back End
4427 =item The Lint Back End
4429 =item The Simple C Back End
4431 =item The Bytecode Back End
4433 =item The Optimized C Back End
4437 =item Module List for the Compiler Suite
4439 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
4440 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
4441 B::Stackobj, B::Stash, B::Terse, B::Xref
4443 =item KNOWN PROBLEMS
4449 =head2 perlfilter - Source Filters
4459 =item WRITING A SOURCE FILTER
4461 =item WRITING A SOURCE FILTER IN C
4463 B<Decryption Filters>
4465 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4467 =item WRITING A SOURCE FILTER IN PERL
4469 =item USING CONTEXT: THE DEBUG FILTER
4473 =item THINGS TO LOOK OUT FOR
4475 Some Filters Clobber the C<DATA> Handle
4485 =head2 perlglossary - Perl Glossary
4495 accessor methods, actual arguments, address operator, algorithm, alias,
4496 alternatives, anonymous, architecture, argument, ARGV, arithmetical
4497 operator, array, array context, ASCII, assertion, assignment, assignment
4498 operator, associative array, associativity, asynchronous, atom, atomic
4499 operation, attribute, autogeneration, autoincrement, autoload, autosplit,
4500 autovivification, AV, awk
4504 backreference, backtracking, backward compatibility, bareword, base class,
4505 big-endian, binary, binary operator, bind, bit, bit shift, bit string,
4506 bless, block, BLOCK, block buffering, Boolean, Boolean context, breakpoint,
4507 broadcast, BSD, bucket, buffer, built-in, bundle, byte, bytecode
4511 C, C preprocessor, call by reference, call by value, callback, canonical,
4512 capturing, character, character class, character property, circumfix
4513 operator, class, class method, client, cloister, closure, cluster, CODE,
4514 code generator, code subpattern, collating sequence, command, command
4515 buffering, command name, command-line arguments, comment, compilation unit,
4516 compile phase, compile time, compiler, composer, concatenation,
4517 conditional, connection, construct, constructor, context, continuation,
4518 core dump, CPAN, cracker, current package, current working directory,
4519 currently selected output channel, CV
4523 dangling statement, data structure, data type, datagram, DBM, declaration,
4524 decrement, default, defined, delimiter, dereference, derived class,
4525 descriptor, destroy, destructor, device, directive, directory, directory
4526 handle, dispatch, distribution, dweomer, dwimmer, dynamic scoping
4530 eclectic, element, embedding, empty subclass test, en passant,
4531 encapsulation, endian, environment, environment variable, EOF, errno,
4532 error, escape sequence, exception, exception handling, exec, executable
4533 file, execute, execute bit, exit status, export, expression, extension
4537 false, FAQ, fatal error, field, FIFO, file, file descriptor, file test
4538 operator, fileglob, filehandle, filename, filesystem, filter, flag,
4539 floating point, flush, FMTEYEWTK, fork, formal arguments, format, freely
4540 available, freely redistributable, freeware, function, funny character,
4545 GID, glob, global, global destruction, glue language, granularity, greedy,
4550 hacker, handler, hard reference, hash, hash table, header file, here
4551 document, hexadecimal, home directory, host, hubris, HV
4555 identifier, impatience, implementation, import, increment, indexing,
4556 indirect filehandle, indirect object, indirect object slot, indirection,
4557 infix, inheritance, instance, instance variable, integer, interface,
4558 interpolation, interpreter, invocant, invocation, I/O, IO, IP, IPC, is-a,
4559 iteration, iterator, IV
4571 label, laziness, left shift, leftmost longest, lexeme, lexer, lexical
4572 analysis, lexical scoping, lexical variable, library, LIFO, line, line
4573 buffering, line number, link, LIST, list, list context, list operator, list
4574 value, literal, little-endian, local, logical operator, lookahead,
4575 lookbehind, loop, loop control statement, loop label, lvaluable, lvalue,
4580 magic, magical increment, magical variables, Makefile, man, manpage,
4581 matching, member data, memory, metacharacter, metasymbol, method,
4582 minimalism, mode, modifier, module, modulus, monger, mortal,
4583 multidimensional array, multiple inheritance
4587 named pipe, namespace, network address, newline, NFS, null character, null
4588 list, null string, numeric context, NV, nybble
4592 object, octal, offset, one-liner, open source software, operand, operating
4593 system, operator, operator overloading, options, overloading, overriding,
4598 package, pad, parameter, parent class, parse tree, parsing, patch, PATH,
4599 pathname, pattern, pattern matching, permission bits, Pern, pipe, pipeline,
4600 platform, pod, pointer, polymorphism, port, portable, porter, POSIX,
4601 postfix, pp, pragma, precedence, prefix, preprocessing, procedure, process,
4602 program generator, progressive matching, property, protocol, prototype,
4603 pseudofunction, pseudohash, pseudoliteral, public domain, pumpkin,
4608 qualified, quantifier
4612 readable, reaping, record, recursion, reference, referent, regex, regular
4613 expression, regular expression modifier, regular file, relational operator,
4614 reserved words, return value, RFC, right shift, root, RTFM, run phase, run
4615 time, run-time pattern, RV, rvalue
4619 scalar, scalar context, scalar literal, scalar value, scalar variable,
4620 scope, scratchpad, script, script kiddie, sed, semaphore, separator,
4621 serialization, server, service, setgid, setuid, shared memory, shebang,
4622 shell, side effects, signal, signal handler, single inheritance, slice,
4623 slurp, socket, soft reference, source filter, stack, standard, standard
4624 error, standard I/O, standard input, standard output, stat structure,
4625 statement, statement modifier, static, static method, static scoping,
4626 static variable, status, STDERR, STDIN, STDIO, STDOUT, stream, string,
4627 string context, stringification, struct, structure, subclass, subpattern,
4628 subroutine, subscript, substitution, substring, superclass, superuser, SV,
4629 switch, switch cluster, switch statement, symbol, symbol table, symbolic
4630 debugger, symbolic link, symbolic reference, synchronous, syntactic sugar,
4631 syntax, syntax tree, syscall
4635 tainted, TCP, term, terminator, ternary, text, thread, tie, TMTOWTDI,
4636 token, tokener, tokenizing, toolbox approach, transliterate, trigger,
4637 trinary, troff, true, truncating, type, type casting, typed lexical,
4638 typedef, typeglob, typemap
4642 UDP, UID, umask, unary operator, Unicode, Unix
4646 value, variable, variable interpolation, variadic, vector, virtual, void
4651 warning, watch expression, whitespace, word, working directory, wrapper,
4668 =item AUTHOR AND COPYRIGHT
4672 =head2 perlembed - how to embed perl in your C program
4682 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
4683 Perl?>, B<Use C from C?>, B<Use Perl from C?>
4687 =item Compiling your C program
4689 =item Adding a Perl interpreter to your C program
4691 =item Calling a Perl subroutine from your C program
4693 =item Evaluating a Perl statement from your C program
4695 =item Performing Perl pattern matches and substitutions from your C program
4697 =item Fiddling with the Perl stack from your C program
4699 =item Maintaining a persistent interpreter
4701 =item Execution of END blocks
4703 =item $0 assignments
4705 =item Maintaining multiple interpreter instances
4707 =item Using Perl modules, which themselves use C libraries, from your C
4712 =item Embedding Perl under Win32
4724 =head2 perldebguts - Guts of Perl debugging
4730 =item Debugger Internals
4734 =item Writing Your Own Debugger
4738 =item Frame Listing Output Examples
4740 =item Debugging regular expressions
4744 =item Compile-time output
4746 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
4747 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
4748 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
4751 =item Types of nodes
4753 =item Run-time output
4757 =item Debugging Perl memory usage
4761 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
4763 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
4764 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
4773 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
4785 =item Version caveat
4787 =item Dynamic Loading versus Static Loading
4799 =item What has gone on?
4801 =item Writing good test scripts
4805 =item What's new here?
4807 =item Input and Output Parameters
4809 =item The XSUBPP Program
4811 =item The TYPEMAP file
4813 =item Warning about Output Arguments
4817 =item What has happened here?
4819 =item Anatomy of .xs file
4821 =item Getting the fat out of XSUBs
4823 =item More about XSUB arguments
4825 =item The Argument Stack
4827 =item Extending your Extension
4829 =item Documenting your Extension
4831 =item Installing your Extension
4835 =item New Things in this Example
4839 =item New Things in this Example
4841 =item EXAMPLE 7 (Coming Soon)
4843 =item EXAMPLE 8 (Coming Soon)
4845 =item EXAMPLE 9 Passing open files to XSes
4847 =item Troubleshooting these Examples
4863 =head2 perlxs - XS language reference manual
4875 =item The Anatomy of an XSUB
4877 =item The Argument Stack
4879 =item The RETVAL Variable
4881 =item Returning SVs, AVs and HVs through RETVAL
4883 =item The MODULE Keyword
4885 =item The PACKAGE Keyword
4887 =item The PREFIX Keyword
4889 =item The OUTPUT: Keyword
4891 =item The NO_OUTPUT Keyword
4893 =item The CODE: Keyword
4895 =item The INIT: Keyword
4897 =item The NO_INIT Keyword
4899 =item Initializing Function Parameters
4901 =item Default Parameter Values
4903 =item The PREINIT: Keyword
4905 =item The SCOPE: Keyword
4907 =item The INPUT: Keyword
4909 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
4911 =item The C<length(NAME)> Keyword
4913 =item Variable-length Parameter Lists
4915 =item The C_ARGS: Keyword
4917 =item The PPCODE: Keyword
4919 =item Returning Undef And Empty Lists
4921 =item The REQUIRE: Keyword
4923 =item The CLEANUP: Keyword
4925 =item The POSTCALL: Keyword
4927 =item The BOOT: Keyword
4929 =item The VERSIONCHECK: Keyword
4931 =item The PROTOTYPES: Keyword
4933 =item The PROTOTYPE: Keyword
4935 =item The ALIAS: Keyword
4937 =item The OVERLOAD: Keyword
4939 =item The FALLBACK: Keyword
4941 =item The INTERFACE: Keyword
4943 =item The INTERFACE_MACRO: Keyword
4945 =item The INCLUDE: Keyword
4947 =item The CASE: Keyword
4949 =item The & Unary Operator
4951 =item Inserting POD, Comments and C Preprocessor Directives
4953 =item Using XS With C++
4955 =item Interface Strategy
4957 =item Perl Objects And C Structures
4961 =item Safely Storing Static Data in XS
4963 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT,
4964 aMY_CXT/pMY_CXT, MY_CXT_CLONE, MY_CXT_INIT_INTERP(my_perl),
4965 dMY_CXT_INTERP(my_perl)
4977 =head2 perlclib - Internal replacements for standard C library functions
4987 C<t>, C<p>, C<n>, C<s>
4989 =item File Operations
4991 =item File Input and Output
4993 =item File Positioning
4995 =item Memory Management and String Handling
4997 =item Character Class Tests
4999 =item F<stdlib.h> functions
5001 =item Miscellaneous functions
5009 =head2 perlguts - Introduction to the Perl API
5021 =item What is an "IV"?
5023 =item Working with SVs
5027 =item What's Really Stored in an SV?
5029 =item Working with AVs
5031 =item Working with HVs
5033 =item Hash API Extensions
5035 =item AVs, HVs and undefined values
5039 =item Blessed References and Class Objects
5041 =item Creating New Variables
5043 GV_ADDMULTI, GV_ADDWARN
5045 =item Reference Counts and Mortality
5047 =item Stashes and Globs
5049 =item Double-Typed SVs
5051 =item Magic Variables
5053 =item Assigning Magic
5055 =item Magic Virtual Tables
5059 =item Understanding the Magic of Tied Hashes and Arrays
5061 =item Localizing changes
5063 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
5064 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
5065 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
5066 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
5067 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
5068 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
5069 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
5070 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
5071 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
5072 save_hptr(HV **hptr)>
5080 =item XSUBs and the Argument Stack
5082 =item Calling Perl Routines from within C Programs
5084 =item Memory Allocation
5088 =item Putting a C value on Perl stack
5092 =item Scratchpads and recursion
5102 =item Examining the tree
5104 =item Compile pass 1: check routines
5106 =item Compile pass 1a: constant folding
5108 =item Compile pass 2: context propagation
5110 =item Compile pass 3: peephole optimization
5112 =item Pluggable runops
5116 =item Examining internal data structures with the C<dump> functions
5118 =item How multiple interpreters and concurrency are supported
5122 =item Background and PERL_IMPLICIT_CONTEXT
5124 =item So what happened to dTHR?
5126 =item How do I use all this in extensions?
5128 =item Should I do anything special if I call perl from multiple threads?
5130 =item Future Plans and PERL_IMPLICIT_SYS
5134 =item Internal Functions
5136 A, p, d, s, n, r, f, M, o, x, m, X, E, b, others
5140 =item Formatted Printing of IVs, UVs, and NVs
5142 =item Pointer-To-Integer and Integer-To-Pointer
5144 =item Exception Handling
5146 =item Source Documentation
5148 =item Backwards compatibility
5152 =item Unicode Support
5156 =item What B<is> Unicode, anyway?
5158 =item How can I recognise a UTF-8 string?
5160 =item How does UTF-8 represent Unicode characters?
5162 =item How does Perl store UTF-8 strings?
5164 =item How do I convert a string to UTF-8?
5166 =item Is there anything else I need to know?
5170 =item Custom Operators
5178 =head2 perlcall - Perl calling conventions from C
5184 An Error Handler, An Event Driven Program
5186 =item THE CALL_ FUNCTIONS
5188 call_sv, call_pv, call_method, call_argv
5208 =item Determining the Context
5216 =item No Parameters, Nothing returned
5218 =item Passing Parameters
5220 =item Returning a Scalar
5222 =item Returning a list of values
5224 =item Returning a list in a scalar context
5226 =item Returning Data from Perl via the parameter list
5230 =item Using G_KEEPERR
5234 =item Using call_argv
5236 =item Using call_method
5240 =item Using Perl to dispose of temporaries
5242 =item Strategies for storing Callback Context Information
5244 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
5245 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
5248 =item Alternate Stack Manipulation
5250 =item Creating and calling an anonymous subroutine in C
5254 =item LIGHTWEIGHT CALLBACKS
5264 =head2 perlapi - autogenerated documentation for the perl public API
5269 X<Perl API> X<API> X<api>
5271 =item "Gimme" Values
5273 GIMME X<GIMME>, GIMME_V X<GIMME_V>, G_ARRAY X<G_ARRAY>, G_DISCARD
5274 X<G_DISCARD>, G_EVAL X<G_EVAL>, G_NOARGS X<G_NOARGS>, G_SCALAR X<G_SCALAR>,
5277 =item Array Manipulation Functions
5279 AvFILL X<AvFILL>, av_clear X<av_clear>, av_delete X<av_delete>, av_exists
5280 X<av_exists>, av_extend X<av_extend>, av_fetch X<av_fetch>, av_fill
5281 X<av_fill>, av_len X<av_len>, av_make X<av_make>, av_pop X<av_pop>, av_push
5282 X<av_push>, av_shift X<av_shift>, av_store X<av_store>, av_undef
5283 X<av_undef>, av_unshift X<av_unshift>, get_av X<get_av>, newAV X<newAV>,
5284 sortsv X<sortsv>, sortsv_flags X<sortsv_flags>
5286 =item Callback Functions
5288 call_argv X<call_argv>, call_method X<call_method>, call_pv X<call_pv>,
5289 call_sv X<call_sv>, ENTER X<ENTER>, eval_pv X<eval_pv>, eval_sv X<eval_sv>,
5290 FREETMPS X<FREETMPS>, LEAVE X<LEAVE>, SAVETMPS X<SAVETMPS>
5292 =item Character classes
5294 isALNUM X<isALNUM>, isALPHA X<isALPHA>, isDIGIT X<isDIGIT>, isLOWER
5295 X<isLOWER>, isSPACE X<isSPACE>, isUPPER X<isUPPER>, toLOWER X<toLOWER>,
5298 =item Cloning an interpreter
5300 perl_clone X<perl_clone>
5302 =item CV Manipulation Functions
5304 CvSTASH X<CvSTASH>, get_cv X<get_cv>
5306 =item Embedding Functions
5308 cv_undef X<cv_undef>, load_module X<load_module>, nothreadhook
5309 X<nothreadhook>, perl_alloc X<perl_alloc>, perl_construct
5310 X<perl_construct>, perl_destruct X<perl_destruct>, perl_free X<perl_free>,
5311 perl_parse X<perl_parse>, perl_run X<perl_run>, require_pv X<require_pv>
5313 =item Functions in file mathoms.c
5315 gv_fetchmethod X<gv_fetchmethod>, pack_cat X<pack_cat>, sv_2pvbyte_nolen
5316 X<sv_2pvbyte_nolen>, sv_2pvutf8_nolen X<sv_2pvutf8_nolen>, sv_2pv_nolen
5317 X<sv_2pv_nolen>, sv_catpvn_mg X<sv_catpvn_mg>, sv_catsv_mg X<sv_catsv_mg>,
5318 sv_force_normal X<sv_force_normal>, sv_iv X<sv_iv>, sv_nolocking
5319 X<sv_nolocking>, sv_nounlocking X<sv_nounlocking>, sv_nv X<sv_nv>, sv_pv
5320 X<sv_pv>, sv_pvbyte X<sv_pvbyte>, sv_pvbyten X<sv_pvbyten>, sv_pvn
5321 X<sv_pvn>, sv_pvutf8 X<sv_pvutf8>, sv_pvutf8n X<sv_pvutf8n>, sv_taint
5322 X<sv_taint>, sv_unref X<sv_unref>, sv_usepvn X<sv_usepvn>, sv_usepvn_mg
5323 X<sv_usepvn_mg>, sv_uv X<sv_uv>, unpack_str X<unpack_str>
5325 =item Functions in file pp_pack.c
5327 packlist X<packlist>, unpackstring X<unpackstring>
5329 =item Global Variables
5331 PL_modglobal X<PL_modglobal>, PL_na X<PL_na>, PL_sv_no X<PL_sv_no>,
5332 PL_sv_undef X<PL_sv_undef>, PL_sv_yes X<PL_sv_yes>
5336 GvSV X<GvSV>, gv_const_sv X<gv_const_sv>, gv_fetchmeth X<gv_fetchmeth>,
5337 gv_fetchmethod_autoload X<gv_fetchmethod_autoload>, gv_fetchmeth_autoload
5338 X<gv_fetchmeth_autoload>, gv_stashpv X<gv_stashpv>, gv_stashpvn
5339 X<gv_stashpvn>, gv_stashsv X<gv_stashsv>
5343 Nullav X<Nullav>, Nullch X<Nullch>, Nullcv X<Nullcv>, Nullhv X<Nullhv>,
5346 =item Hash Manipulation Functions
5348 get_hv X<get_hv>, HEf_SVKEY X<HEf_SVKEY>, HeHASH X<HeHASH>, HeKEY X<HeKEY>,
5349 HeKLEN X<HeKLEN>, HePV X<HePV>, HeSVKEY X<HeSVKEY>, HeSVKEY_force
5350 X<HeSVKEY_force>, HeSVKEY_set X<HeSVKEY_set>, HeVAL X<HeVAL>, HvNAME
5351 X<HvNAME>, hv_assert X<hv_assert>, hv_clear X<hv_clear>,
5352 hv_clear_placeholders X<hv_clear_placeholders>, hv_delete X<hv_delete>,
5353 hv_delete_ent X<hv_delete_ent>, hv_exists X<hv_exists>, hv_exists_ent
5354 X<hv_exists_ent>, hv_fetch X<hv_fetch>, hv_fetch_ent X<hv_fetch_ent>,
5355 hv_iterinit X<hv_iterinit>, hv_iterkey X<hv_iterkey>, hv_iterkeysv
5356 X<hv_iterkeysv>, hv_iternext X<hv_iternext>, hv_iternextsv
5357 X<hv_iternextsv>, hv_iternext_flags X<hv_iternext_flags>, hv_iterval
5358 X<hv_iterval>, hv_magic X<hv_magic>, hv_scalar X<hv_scalar>, hv_store
5359 X<hv_store>, hv_store_ent X<hv_store_ent>, hv_undef X<hv_undef>, newHV
5362 =item Magical Functions
5364 mg_clear X<mg_clear>, mg_copy X<mg_copy>, mg_find X<mg_find>, mg_free
5365 X<mg_free>, mg_get X<mg_get>, mg_length X<mg_length>, mg_magical
5366 X<mg_magical>, mg_set X<mg_set>, SvGETMAGIC X<SvGETMAGIC>, SvLOCK
5367 X<SvLOCK>, SvSETMAGIC X<SvSETMAGIC>, SvSetMagicSV X<SvSetMagicSV>,
5368 SvSetMagicSV_nosteal X<SvSetMagicSV_nosteal>, SvSetSV X<SvSetSV>,
5369 SvSetSV_nosteal X<SvSetSV_nosteal>, SvSHARE X<SvSHARE>, SvUNLOCK
5372 =item Memory Management
5374 Copy X<Copy>, CopyD X<CopyD>, Move X<Move>, MoveD X<MoveD>, Newx X<Newx>,
5375 Newxc X<Newxc>, Newxz X<Newxz>, Poison X<Poison>, PoisonNew X<PoisonNew>,
5376 PoisonWith X<PoisonWith>, Renew X<Renew>, Renewc X<Renewc>, Safefree
5377 X<Safefree>, savepv X<savepv>, savepvn X<savepvn>, savesharedpv
5378 X<savesharedpv>, savesvpv X<savesvpv>, StructCopy X<StructCopy>, Zero
5379 X<Zero>, ZeroD X<ZeroD>
5381 =item Miscellaneous Functions
5383 fbm_compile X<fbm_compile>, fbm_instr X<fbm_instr>, form X<form>, getcwd_sv
5384 X<getcwd_sv>, my_snprintf X<my_snprintf>, my_sprintf X<my_sprintf>,
5385 my_vsnprintf X<my_vsnprintf>, new_version X<new_version>, scan_version
5386 X<scan_version>, strEQ X<strEQ>, strGE X<strGE>, strGT X<strGT>, strLE
5387 X<strLE>, strLT X<strLT>, strNE X<strNE>, strnEQ X<strnEQ>, strnNE
5388 X<strnNE>, sv_nosharing X<sv_nosharing>, upg_version X<upg_version>, vcmp
5389 X<vcmp>, vnormal X<vnormal>, vnumify X<vnumify>, vstringify X<vstringify>,
5392 =item Multicall Functions
5394 dMULTICALL X<dMULTICALL>, MULTICALL X<MULTICALL>, POP_MULTICALL
5395 X<POP_MULTICALL>, PUSH_MULTICALL X<PUSH_MULTICALL>
5397 =item Numeric functions
5399 grok_bin X<grok_bin>, grok_hex X<grok_hex>, grok_number X<grok_number>,
5400 grok_numeric_radix X<grok_numeric_radix>, grok_oct X<grok_oct>, scan_bin
5401 X<scan_bin>, scan_hex X<scan_hex>, scan_oct X<scan_oct>
5403 =item Optree Manipulation Functions
5405 cv_const_sv X<cv_const_sv>, newCONSTSUB X<newCONSTSUB>, newXS X<newXS>
5407 =item Pad Data Structures
5411 =item Simple Exception Handling Macros
5413 dXCPT X<dXCPT>, XCPT_CATCH X<XCPT_CATCH>, XCPT_RETHROW X<XCPT_RETHROW>,
5414 XCPT_TRY_END X<XCPT_TRY_END>, XCPT_TRY_START X<XCPT_TRY_START>
5416 =item Stack Manipulation Macros
5418 dMARK X<dMARK>, dORIGMARK X<dORIGMARK>, dSP X<dSP>, EXTEND X<EXTEND>, MARK
5419 X<MARK>, mPUSHi X<mPUSHi>, mPUSHn X<mPUSHn>, mPUSHp X<mPUSHp>, mPUSHu
5420 X<mPUSHu>, mXPUSHi X<mXPUSHi>, mXPUSHn X<mXPUSHn>, mXPUSHp X<mXPUSHp>,
5421 mXPUSHu X<mXPUSHu>, ORIGMARK X<ORIGMARK>, POPi X<POPi>, POPl X<POPl>, POPn
5422 X<POPn>, POPp X<POPp>, POPpbytex X<POPpbytex>, POPpx X<POPpx>, POPs
5423 X<POPs>, PUSHi X<PUSHi>, PUSHMARK X<PUSHMARK>, PUSHmortal X<PUSHmortal>,
5424 PUSHn X<PUSHn>, PUSHp X<PUSHp>, PUSHs X<PUSHs>, PUSHu X<PUSHu>, PUTBACK
5425 X<PUTBACK>, SP X<SP>, SPAGAIN X<SPAGAIN>, XPUSHi X<XPUSHi>, XPUSHmortal
5426 X<XPUSHmortal>, XPUSHn X<XPUSHn>, XPUSHp X<XPUSHp>, XPUSHs X<XPUSHs>,
5427 XPUSHu X<XPUSHu>, XSRETURN X<XSRETURN>, XSRETURN_EMPTY X<XSRETURN_EMPTY>,
5428 XSRETURN_IV X<XSRETURN_IV>, XSRETURN_NO X<XSRETURN_NO>, XSRETURN_NV
5429 X<XSRETURN_NV>, XSRETURN_PV X<XSRETURN_PV>, XSRETURN_UNDEF
5430 X<XSRETURN_UNDEF>, XSRETURN_UV X<XSRETURN_UV>, XSRETURN_YES
5431 X<XSRETURN_YES>, XST_mIV X<XST_mIV>, XST_mNO X<XST_mNO>, XST_mNV
5432 X<XST_mNV>, XST_mPV X<XST_mPV>, XST_mUNDEF X<XST_mUNDEF>, XST_mYES
5437 svtype X<svtype>, SVt_IV X<SVt_IV>, SVt_NV X<SVt_NV>, SVt_PV X<SVt_PV>,
5438 SVt_PVAV X<SVt_PVAV>, SVt_PVCV X<SVt_PVCV>, SVt_PVHV X<SVt_PVHV>, SVt_PVMG
5441 =item SV Manipulation Functions
5443 get_sv X<get_sv>, newRV_inc X<newRV_inc>, SvCUR X<SvCUR>, SvCUR_set
5444 X<SvCUR_set>, SvEND X<SvEND>, SvGAMAGIC X<SvGAMAGIC>, SvGROW X<SvGROW>,
5445 SvIOK X<SvIOK>, SvIOKp X<SvIOKp>, SvIOK_notUV X<SvIOK_notUV>, SvIOK_off
5446 X<SvIOK_off>, SvIOK_on X<SvIOK_on>, SvIOK_only X<SvIOK_only>, SvIOK_only_UV
5447 X<SvIOK_only_UV>, SvIOK_UV X<SvIOK_UV>, SvIsCOW X<SvIsCOW>,
5448 SvIsCOW_shared_hash X<SvIsCOW_shared_hash>, SvIV X<SvIV>, SvIVX X<SvIVX>,
5449 SvIVx X<SvIVx>, SvIV_nomg X<SvIV_nomg>, SvIV_set X<SvIV_set>, SvLEN
5450 X<SvLEN>, SvLEN_set X<SvLEN_set>, SvMAGIC_set X<SvMAGIC_set>, SvNIOK
5451 X<SvNIOK>, SvNIOKp X<SvNIOKp>, SvNIOK_off X<SvNIOK_off>, SvNOK X<SvNOK>,
5452 SvNOKp X<SvNOKp>, SvNOK_off X<SvNOK_off>, SvNOK_on X<SvNOK_on>, SvNOK_only
5453 X<SvNOK_only>, SvNV X<SvNV>, SvNVX X<SvNVX>, SvNVx X<SvNVx>, SvNV_set
5454 X<SvNV_set>, SvOK X<SvOK>, SvOOK X<SvOOK>, SvPOK X<SvPOK>, SvPOKp
5455 X<SvPOKp>, SvPOK_off X<SvPOK_off>, SvPOK_on X<SvPOK_on>, SvPOK_only
5456 X<SvPOK_only>, SvPOK_only_UTF8 X<SvPOK_only_UTF8>, SvPV X<SvPV>, SvPVbyte
5457 X<SvPVbyte>, SvPVbytex X<SvPVbytex>, SvPVbytex_force X<SvPVbytex_force>,
5458 SvPVbyte_force X<SvPVbyte_force>, SvPVbyte_nolen X<SvPVbyte_nolen>,
5459 SvPVutf8 X<SvPVutf8>, SvPVutf8x X<SvPVutf8x>, SvPVutf8x_force
5460 X<SvPVutf8x_force>, SvPVutf8_force X<SvPVutf8_force>, SvPVutf8_nolen
5461 X<SvPVutf8_nolen>, SvPVX X<SvPVX>, SvPVx X<SvPVx>, SvPV_force
5462 X<SvPV_force>, SvPV_force_nomg X<SvPV_force_nomg>, SvPV_nolen
5463 X<SvPV_nolen>, SvPV_nomg X<SvPV_nomg>, SvPV_set X<SvPV_set>, SvREFCNT
5464 X<SvREFCNT>, SvREFCNT_dec X<SvREFCNT_dec>, SvREFCNT_inc X<SvREFCNT_inc>,
5465 SvREFCNT_inc_NN X<SvREFCNT_inc_NN>, SvREFCNT_inc_simple
5466 X<SvREFCNT_inc_simple>, SvREFCNT_inc_simple_NN X<SvREFCNT_inc_simple_NN>,
5467 SvREFCNT_inc_simple_void X<SvREFCNT_inc_simple_void>, SvREFCNT_inc_void
5468 X<SvREFCNT_inc_void>, SvREFCNT_inc_void_NN X<SvREFCNT_inc_void_NN>, SvROK
5469 X<SvROK>, SvROK_off X<SvROK_off>, SvROK_on X<SvROK_on>, SvRV X<SvRV>,
5470 SvRV_set X<SvRV_set>, SvSTASH X<SvSTASH>, SvSTASH_set X<SvSTASH_set>,
5471 SvTAINT X<SvTAINT>, SvTAINTED X<SvTAINTED>, SvTAINTED_off X<SvTAINTED_off>,
5472 SvTAINTED_on X<SvTAINTED_on>, SvTRUE X<SvTRUE>, SvTYPE X<SvTYPE>, SvUOK
5473 X<SvUOK>, SvUPGRADE X<SvUPGRADE>, SvUTF8 X<SvUTF8>, SvUTF8_off
5474 X<SvUTF8_off>, SvUTF8_on X<SvUTF8_on>, SvUV X<SvUV>, SvUVX X<SvUVX>, SvUVx
5475 X<SvUVx>, SvUV_nomg X<SvUV_nomg>, SvUV_set X<SvUV_set>, SvVOK X<SvVOK>,
5476 sv_catpvn_nomg X<sv_catpvn_nomg>, sv_catsv_nomg X<sv_catsv_nomg>,
5477 sv_derived_from X<sv_derived_from>, sv_report_used X<sv_report_used>,
5478 sv_setsv_nomg X<sv_setsv_nomg>
5480 =item SV-Body Allocation
5482 looks_like_number X<looks_like_number>, newRV_noinc X<newRV_noinc>, newSV
5483 X<newSV>, newSVhek X<newSVhek>, newSViv X<newSViv>, newSVnv X<newSVnv>,
5484 newSVpv X<newSVpv>, newSVpvf X<newSVpvf>, newSVpvn X<newSVpvn>,
5485 newSVpvn_share X<newSVpvn_share>, newSVrv X<newSVrv>, newSVsv X<newSVsv>,
5486 newSVuv X<newSVuv>, sv_2bool X<sv_2bool>, sv_2cv X<sv_2cv>, sv_2io
5487 X<sv_2io>, sv_2iv_flags X<sv_2iv_flags>, sv_2mortal X<sv_2mortal>, sv_2nv
5488 X<sv_2nv>, sv_2pvbyte X<sv_2pvbyte>, sv_2pvutf8 X<sv_2pvutf8>, sv_2pv_flags
5489 X<sv_2pv_flags>, sv_2uv_flags X<sv_2uv_flags>, sv_backoff X<sv_backoff>,
5490 sv_bless X<sv_bless>, sv_catpv X<sv_catpv>, sv_catpvf X<sv_catpvf>,
5491 sv_catpvf_mg X<sv_catpvf_mg>, sv_catpvn X<sv_catpvn>, sv_catpvn_flags
5492 X<sv_catpvn_flags>, sv_catpv_mg X<sv_catpv_mg>, sv_catsv X<sv_catsv>,
5493 sv_catsv_flags X<sv_catsv_flags>, sv_chop X<sv_chop>, sv_clear X<sv_clear>,
5494 sv_cmp X<sv_cmp>, sv_cmp_locale X<sv_cmp_locale>, sv_collxfrm
5495 X<sv_collxfrm>, sv_copypv X<sv_copypv>, sv_dec X<sv_dec>, sv_eq X<sv_eq>,
5496 sv_force_normal_flags X<sv_force_normal_flags>, sv_free X<sv_free>, sv_gets
5497 X<sv_gets>, sv_grow X<sv_grow>, sv_inc X<sv_inc>, sv_insert X<sv_insert>,
5498 sv_isa X<sv_isa>, sv_isobject X<sv_isobject>, sv_len X<sv_len>, sv_len_utf8
5499 X<sv_len_utf8>, sv_magic X<sv_magic>, sv_magicext X<sv_magicext>,
5500 sv_mortalcopy X<sv_mortalcopy>, sv_newmortal X<sv_newmortal>, sv_newref
5501 X<sv_newref>, sv_pos_b2u X<sv_pos_b2u>, sv_pos_u2b X<sv_pos_u2b>,
5502 sv_pvbyten_force X<sv_pvbyten_force>, sv_pvn_force X<sv_pvn_force>,
5503 sv_pvn_force_flags X<sv_pvn_force_flags>, sv_pvutf8n_force
5504 X<sv_pvutf8n_force>, sv_reftype X<sv_reftype>, sv_replace X<sv_replace>,
5505 sv_reset X<sv_reset>, sv_rvweaken X<sv_rvweaken>, sv_setiv X<sv_setiv>,
5506 sv_setiv_mg X<sv_setiv_mg>, sv_setnv X<sv_setnv>, sv_setnv_mg
5507 X<sv_setnv_mg>, sv_setpv X<sv_setpv>, sv_setpvf X<sv_setpvf>, sv_setpvf_mg
5508 X<sv_setpvf_mg>, sv_setpviv X<sv_setpviv>, sv_setpviv_mg X<sv_setpviv_mg>,
5509 sv_setpvn X<sv_setpvn>, sv_setpvn_mg X<sv_setpvn_mg>, sv_setpv_mg
5510 X<sv_setpv_mg>, sv_setref_iv X<sv_setref_iv>, sv_setref_nv X<sv_setref_nv>,
5511 sv_setref_pv X<sv_setref_pv>, sv_setref_pvn X<sv_setref_pvn>, sv_setref_uv
5512 X<sv_setref_uv>, sv_setsv X<sv_setsv>, sv_setsv_flags X<sv_setsv_flags>,
5513 sv_setsv_mg X<sv_setsv_mg>, sv_setuv X<sv_setuv>, sv_setuv_mg
5514 X<sv_setuv_mg>, sv_tainted X<sv_tainted>, sv_true X<sv_true>, sv_unmagic
5515 X<sv_unmagic>, sv_unref_flags X<sv_unref_flags>, sv_untaint X<sv_untaint>,
5516 sv_upgrade X<sv_upgrade>, sv_usepvn_flags X<sv_usepvn_flags>,
5517 sv_utf8_decode X<sv_utf8_decode>, sv_utf8_downgrade X<sv_utf8_downgrade>,
5518 sv_utf8_encode X<sv_utf8_encode>, sv_utf8_upgrade X<sv_utf8_upgrade>,
5519 sv_utf8_upgrade_flags X<sv_utf8_upgrade_flags>, sv_vcatpvf X<sv_vcatpvf>,
5520 sv_vcatpvfn X<sv_vcatpvfn>, sv_vcatpvf_mg X<sv_vcatpvf_mg>, sv_vsetpvf
5521 X<sv_vsetpvf>, sv_vsetpvfn X<sv_vsetpvfn>, sv_vsetpvf_mg X<sv_vsetpvf_mg>
5523 =item Unicode Support
5525 bytes_from_utf8 X<bytes_from_utf8>, bytes_to_utf8 X<bytes_to_utf8>,
5526 ibcmp_utf8 X<ibcmp_utf8>, is_utf8_char X<is_utf8_char>, is_utf8_string
5527 X<is_utf8_string>, is_utf8_string_loc X<is_utf8_string_loc>,
5528 is_utf8_string_loclen X<is_utf8_string_loclen>, pv_uni_display
5529 X<pv_uni_display>, sv_cat_decode X<sv_cat_decode>, sv_recode_to_utf8
5530 X<sv_recode_to_utf8>, sv_uni_display X<sv_uni_display>, to_utf8_case
5531 X<to_utf8_case>, to_utf8_fold X<to_utf8_fold>, to_utf8_lower
5532 X<to_utf8_lower>, to_utf8_title X<to_utf8_title>, to_utf8_upper
5533 X<to_utf8_upper>, utf8n_to_uvchr X<utf8n_to_uvchr>, utf8n_to_uvuni
5534 X<utf8n_to_uvuni>, utf8_distance X<utf8_distance>, utf8_hop X<utf8_hop>,
5535 utf8_length X<utf8_length>, utf8_to_bytes X<utf8_to_bytes>, utf8_to_uvchr
5536 X<utf8_to_uvchr>, utf8_to_uvuni X<utf8_to_uvuni>, uvchr_to_utf8
5537 X<uvchr_to_utf8>, uvuni_to_utf8_flags X<uvuni_to_utf8_flags>
5539 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
5541 ax X<ax>, CLASS X<CLASS>, dAX X<dAX>, dAXMARK X<dAXMARK>, dITEMS X<dITEMS>,
5542 dUNDERBAR X<dUNDERBAR>, dXSARGS X<dXSARGS>, dXSI32 X<dXSI32>, items
5543 X<items>, ix X<ix>, newXSproto X<newXSproto>, RETVAL X<RETVAL>, ST X<ST>,
5544 THIS X<THIS>, UNDERBAR X<UNDERBAR>, XS X<XS>, XS_VERSION X<XS_VERSION>,
5545 XS_VERSION_BOOTCHECK X<XS_VERSION_BOOTCHECK>
5547 =item Warning and Dieing
5549 croak X<croak>, warn X<warn>
5557 =head2 perlintern - autogenerated documentation of purely B<internal>
5563 X<internal Perl functions> X<interpreter functions>
5565 =item CV reference counts and CvOUTSIDE
5567 CvWEAKOUTSIDE X<CvWEAKOUTSIDE>
5569 =item Functions in file pad.h
5571 CX_CURPAD_SAVE X<CX_CURPAD_SAVE>, CX_CURPAD_SV X<CX_CURPAD_SV>, PAD_BASE_SV
5572 X<PAD_BASE_SV>, PAD_CLONE_VARS X<PAD_CLONE_VARS>, PAD_COMPNAME_FLAGS
5573 X<PAD_COMPNAME_FLAGS>, PAD_COMPNAME_GEN X<PAD_COMPNAME_GEN>,
5574 PAD_COMPNAME_GEN_set X<PAD_COMPNAME_GEN_set>, PAD_COMPNAME_OURSTASH
5575 X<PAD_COMPNAME_OURSTASH>, PAD_COMPNAME_PV X<PAD_COMPNAME_PV>,
5576 PAD_COMPNAME_TYPE X<PAD_COMPNAME_TYPE>, PAD_DUP X<PAD_DUP>,
5577 PAD_RESTORE_LOCAL X<PAD_RESTORE_LOCAL>, PAD_SAVE_LOCAL X<PAD_SAVE_LOCAL>,
5578 PAD_SAVE_SETNULLPAD X<PAD_SAVE_SETNULLPAD>, PAD_SETSV X<PAD_SETSV>,
5579 PAD_SET_CUR X<PAD_SET_CUR>, PAD_SET_CUR_NOSAVE X<PAD_SET_CUR_NOSAVE>,
5580 PAD_SV X<PAD_SV>, PAD_SVl X<PAD_SVl>, SAVECLEARSV X<SAVECLEARSV>,
5581 SAVECOMPPAD X<SAVECOMPPAD>, SAVEPADSV X<SAVEPADSV>
5583 =item Functions in file pp_ctl.c
5585 find_runcv X<find_runcv>
5587 =item Global Variables
5589 PL_DBsingle X<PL_DBsingle>, PL_DBsub X<PL_DBsub>, PL_DBtrace X<PL_DBtrace>,
5590 PL_dowarn X<PL_dowarn>, PL_last_in_gv X<PL_last_in_gv>, PL_ofs_sv
5591 X<PL_ofs_sv>, PL_rs X<PL_rs>
5595 is_gv_magical X<is_gv_magical>, is_gv_magical_sv X<is_gv_magical_sv>
5597 =item Hash Manipulation Functions
5599 refcounted_he_chain_2hv X<refcounted_he_chain_2hv>, refcounted_he_free
5600 X<refcounted_he_free>, refcounted_he_new X<refcounted_he_new>
5604 start_glob X<start_glob>
5606 =item Magical Functions
5608 magic_sethint X<magic_sethint>, mg_localize X<mg_localize>
5610 =item Pad Data Structures
5612 CvPADLIST X<CvPADLIST>, cv_clone X<cv_clone>, cv_dump X<cv_dump>,
5613 do_dump_pad X<do_dump_pad>, intro_my X<intro_my>, pad_add_anon
5614 X<pad_add_anon>, pad_add_name X<pad_add_name>, pad_alloc X<pad_alloc>,
5615 pad_block_start X<pad_block_start>, pad_check_dup X<pad_check_dup>,
5616 pad_findlex X<pad_findlex>, pad_findmy X<pad_findmy>, pad_fixup_inner_anons
5617 X<pad_fixup_inner_anons>, pad_free X<pad_free>, pad_leavemy X<pad_leavemy>,
5618 pad_new X<pad_new>, pad_push X<pad_push>, pad_reset X<pad_reset>, pad_setsv
5619 X<pad_setsv>, pad_swipe X<pad_swipe>, pad_tidy X<pad_tidy>, pad_undef
5622 =item Stack Manipulation Macros
5624 djSP X<djSP>, LVRET X<LVRET>
5626 =item SV Manipulation Functions
5628 sv_add_arena X<sv_add_arena>, sv_clean_all X<sv_clean_all>, sv_clean_objs
5629 X<sv_clean_objs>, sv_free_arenas X<sv_free_arenas>
5631 =item Unicode Support
5633 find_uninit_var X<find_uninit_var>, report_uninit X<report_uninit>
5641 =head2 perliol - C API for Perl's implementation of IO in Layers.
5651 =item History and Background
5653 =item Basic Structure
5655 =item Layers vs Disciplines
5657 =item Data Structures
5659 =item Functions and Attributes
5661 =item Per-instance Data
5663 =item Layers in action.
5665 =item Per-instance flag bits
5667 PERLIO_F_EOF, PERLIO_F_CANWRITE, PERLIO_F_CANREAD, PERLIO_F_ERROR,
5668 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
5669 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
5670 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
5672 =item Methods in Detail
5674 fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF,
5675 PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode,
5676 Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof,
5677 Error, Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
5682 =item Implementing PerlIO Layers
5684 C implementations, Perl implementations
5688 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
5690 =item Extension Layers
5692 ":encoding", ":scalar", ":via"
5700 =head2 perlapio - perl's IO abstraction interface.
5708 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
5709 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
5710 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
5711 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
5712 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
5713 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
5714 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
5715 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
5716 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
5717 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
5718 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
5722 =item Co-existence with stdio
5724 B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
5725 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
5727 =item "Fast gets" Functions
5729 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
5730 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
5731 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
5732 B<PerlIO_get_bufsiz(f)>
5734 =item Other Functions
5736 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
5737 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
5743 =head2 perlhack - How to hack at the Perl internals
5749 Does concept match the general goals of Perl?, Where is the
5750 implementation?, Backwards compatibility, Could it be a module instead?, Is
5751 the feature generic enough?, Does it potentially introduce new bugs?, Does
5752 it preclude other desirable features?, Is the implementation robust?, Is
5753 the implementation generic enough to be portable?, Is the implementation
5754 tested?, Is there enough documentation?, Is there another way to do it?,
5755 Does it create too much work?, Patches speak louder than words
5759 =item Keeping in sync
5761 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
5762 NFS, rsync'ing the patches
5764 =item Why rsync the source tree
5766 It's easier to rsync the source tree, It's more reliable
5768 =item Why rsync the patches
5770 It's easier to rsync the patches, It's a good reference, Finding a start
5771 point, Finding how to fix a bug, Finding the source of misbehaviour
5773 =item Working with the source
5775 =item Perlbug administration
5777 =item Submitting patches
5779 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
5780 F<Porting/pumpkin.pod>, The perl5-porters FAQ
5782 =item Finding Your Way Around
5784 Core modules, Tests, Documentation, Configure, Interpreter
5786 =item Elements of the interpreter
5788 Startup, Parsing, Optimization, Running, Exception handing
5790 =item Internal Variable Types
5796 Argument stack, Mark stack, Save stack
5798 =item Millions of Macros
5800 =item The .i Targets
5802 =item Poking at Perl
5804 =item Using a source-level debugger
5806 run [args], break function_name, break source.c:xxx, step, next, continue,
5807 finish, 'enter', print
5809 =item gdb macro support
5811 =item Dumping Perl Data Structures
5815 =item Patching a core module
5817 =item Adding a new function to the core
5819 =item Writing a test
5821 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5822 F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base t/comp,
5823 t/cmd t/run t/io t/op, t/lib ext lib
5825 =item Special Make Test Targets
5827 coretest, test.deparse, test.taintwarn, minitest, test.valgrind
5828 check.valgrind utest.valgrind ucheck.valgrind, test.third check.third
5829 utest.third ucheck.third, test.torture torturetest, utest ucheck test.utf8
5830 check.utf8, minitest.utf16 test.utf16, test_harness, test-notty test_notty
5832 =item Running tests by hand
5834 -v, -torture, -re=PATTERN, -re LIST OF PATTERNS, PERL_CORE=1,
5835 PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST
5839 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5843 =item Rational Software's Purify
5845 =item Purify on Unix
5847 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5851 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5855 =item Compaq's/Digital's/HP's Third Degree
5857 =item PERL_DESTRUCT_LEVEL
5863 =item Gprof Profiling
5865 -a, -b, -e routine, -f routine, -s, -z
5867 =item GCC gcov Profiling
5869 =item Pixie Profiling
5871 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5874 =item Miscellaneous tricks
5878 I<The Road goes ever on and on, down from the door where it began.>
5886 =head2 perlbook - Perl book information
5894 =head2 perltodo - Perl TO-DO List
5900 =item The roadmap to 5.10
5904 =item Needed for a 5.9.4 release
5906 =item Needed for a 5.9.5 release
5908 Implement L</_ prototype character>, Implement L</state variables>
5910 =item Needed for a 5.9.6 release
5914 =item Tasks that only need Perl knowledge
5918 =item common test code for timed bail out
5920 =item POD -> HTML conversion in the core still sucks
5922 =item Parallel testing
5924 =item Make Schwern poorer
5926 =item Improve the coverage of the core tests
5930 =item A decent benchmark
5932 =item fix tainting bugs
5934 =item Dual life everything
5936 =item Improving C<threads::shared>
5938 =item POSIX memory footprint
5940 =item embed.pl/makedef.pl
5944 =item Tasks that need a little sysadmin-type knowledge
5948 =item make HTML install work
5950 =item compressed man pages
5952 =item Add a code coverage target to the Makefile
5954 =item Make Config.pm cope with differences between build and installed perl
5956 =item linker specification files
5960 =item Tasks that need a little C knowledge
5964 =item Make it clear from -v if this is the exact official release
5966 =item Ordering of "global" variables.
5968 =item Profile Perl - am I hot or not?
5970 =item Shrink struct context
5972 =item Allocate OPs from arenas
5974 =item Merge the win32 and wince codebases
5978 =item Tasks that need a knowledge of XS
5982 =item shrink C<PVBM>s
5984 =item Implicit Latin 1 => Unicode translation
5986 =item autovivification
5988 =item Unicode in Filenames
5990 =item Unicode in %ENV
5992 =item use less 'memory'
5994 =item Re-implement C<:unique> in a way that is actually thread-safe
5996 =item Make tainting consistent
5998 =item readpipe(LIST)
6002 =item Tasks that need a knowledge of the interpreter
6006 =item lexical pragmas
6008 =item Attach/detach debugger from running program
6010 =item LVALUE functions for lists
6012 =item LVALUE functions in the debugger
6014 =item _ prototype character
6016 =item state variables
6018 =item regexp optimiser optional
6022 =item optional optimizer
6024 =item You WANT *how* many
6026 =item lexical aliases
6028 =item entersub XS vs Perl
6032 =item Optimize away @_
6034 =item What hooks would assertions need?
6036 =item Properly Unicode safe tokeniser and pads.
6044 =item make ithreads more robust
6048 =item (?{...}) closures in regexps
6050 =item A re-entrant regexp engine
6056 =head2 perldoc - Look up Perl documentation in Pod format.
6066 B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
6067 I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
6068 I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
6069 B<-w> I<option:value> or B<-w> I<option>, B<-X>, B<-L> I<language_code>,
6070 B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
6081 =head2 perlhist - the Perl history records
6089 =item THE KEEPERS OF THE PUMPKIN
6101 =item SELECTED RELEASE SIZES
6103 =item SELECTED PATCH SIZES
6107 =item THE KEEPERS OF THE RECORDS
6111 =head2 perldelta - what is new for perl v5.9.4
6117 =item Incompatible Changes
6125 =item Core Enhancements
6127 =item Modules and Pragmata
6129 =item Utility Changes
6133 =item Performance Enhancements
6135 =item Installation and Configuration Improvements
6137 =item Selected Bug Fixes
6139 =item New or Changed Diagnostics
6141 =item Changed Internals
6143 =item Known Problems
6147 =item Platform Specific Problems
6151 =item Reporting Bugs
6157 =head2 perl594delta, perldelta - what is new for perl v5.9.4
6163 =item Incompatible Changes
6171 =item Core Enhancements
6173 =item Modules and Pragmata
6175 =item Utility Changes
6179 =item Performance Enhancements
6181 =item Installation and Configuration Improvements
6183 =item Selected Bug Fixes
6185 =item New or Changed Diagnostics
6187 =item Changed Internals
6189 =item Known Problems
6193 =item Platform Specific Problems
6197 =item Reporting Bugs
6203 =head2 perl593delta, perldelta - what is new for perl v5.9.3
6209 =item Incompatible Changes
6213 =item Parsing of C<-f _>
6217 =item Magic goto and eval
6219 =item C<$#> has been removed
6223 =item Scoping of the C<sort> pragma
6227 =item Core Enhancements
6231 =item The C<feature> pragma
6233 =item Switch and Smart Match operator
6237 =item C<CLONE_SKIP()>
6239 =item C<${^CHILD_ERROR_NATIVE}>
6243 =item Unicode Character Database 4.1.0
6247 =item Recursive sort subs
6249 =item Effect of pragmas in eval
6251 =item New B<-E> command-line switch
6253 =item C<chdir>, C<chmod> and C<chown> on filehandles
6259 =item Modules and Pragmata
6263 =item New Core Modules
6267 =item Utility Changes
6277 =item C<h2xs> enhancements
6279 =item C<perlivp> enhancements
6291 =item Performance Enhancements
6295 =item XS-assisted SWASHGET
6297 =item Constant subroutines
6299 =item C<PERL_DONT_CREATE_GVSV>
6301 =item Weak references are cheaper
6303 =item sort() enhancements
6307 =item Installation and Configuration Improvements
6311 =item Compilation improvements
6313 =item New Or Improved Platforms
6317 =item Module auxiliary files
6321 =item Selected Bug Fixes
6325 =item C<defined $$x>
6327 =item Calling CORE::require()
6329 =item Subscripts of slices
6331 =item Remove over-optimisation
6333 =item sprintf() fixes
6335 =item no warnings 'category' works correctly with -w
6339 =item More Unicode Fixes
6343 =item New or Changed Diagnostics
6347 =item Attempt to set length of freed array
6349 =item Non-string passed as bitmask
6351 =item Search pattern not terminated or ternary operator parsed as search
6354 =item "%s" variable %s masks earlier declaration
6356 =item readdir()/closedir()/etc. attempted on invalid dirhandle
6360 =item Changed Internals
6364 =item B:: modules inheritance changed
6368 =item Reporting Bugs
6374 =head2 perl592delta, perldelta - what is new for perl v5.9.2
6380 =item Incompatible Changes
6384 =item Packing and UTF-8 strings
6390 =item Core Enhancements
6394 =item Malloc wrapping
6396 =item Unicode Character Database 4.0.1
6398 =item suidperl less insecure
6404 =item Unicode Character Classes
6406 =item Byte-order modifiers for pack() and unpack()
6408 =item Byte count feature in pack()
6414 =item Modules and Pragmata
6420 =item Updated And Improved Modules and Pragmata
6422 B::Concise, Socket, Sys::Syslog, threads
6426 =item Utility Changes
6428 =item Performance Enhancements
6430 =item Installation and Configuration Improvements
6432 =item Selected Bug Fixes
6434 =item New or Changed Diagnostics
6436 =item Changed Internals
6438 =item Known Problems
6440 =item Plans for the next release
6442 =item Reporting Bugs
6448 =head2 perl591delta, perldelta - what is new for perl v5.9.1
6454 =item Incompatible Changes
6458 =item substr() lvalues are no longer fixed-length
6460 =item The C<:unique> attribute is only meaningful for globals
6464 =item Core Enhancements
6470 =item Tied hashes in scalar context
6474 =item Stacked filetest operators
6478 =item Modules and Pragmata
6480 Benchmark, Carp, Exporter, FindBin, List::Util, threads::shared
6482 =item Utility Changes
6486 =item Performance Enhancements
6488 =item Selected Bug Fixes
6494 =item Threading bugs
6500 =item New or Changed Diagnostics
6502 =item Changed Internals
6506 =item Reordering of SVt_* constants
6508 =item Removal of CPP symbols
6510 =item Less space is used by ops
6516 =item Configuration and Building
6518 =item Known Problems
6522 =item Platform Specific Problems
6526 =item To-do for perl 5.10.0
6528 =item Reporting Bugs
6534 =head2 perl590delta, perldelta - what is new for perl v5.9.0
6540 =item Incompatible Changes
6544 =item Hash Randomisation
6546 =item UTF-8 On Filehandles No Longer Activated By Locale
6548 =item Single-number v-strings are no longer v-strings before "=>"
6550 =item (Win32) The -C Switch Has Been Repurposed
6552 =item (Win32) The /d Switch Of cmd.exe
6554 =item The C<$*> variable has been removed
6558 =item Core Enhancements
6564 =item Defined-or operators
6566 =item UTF-8 no longer default under UTF-8 locales
6568 =item Unsafe signals again available
6570 =item Tied Arrays with Negative Array Indices
6574 =item Unicode Character Database 4.0.0
6576 =item Miscellaneous Enhancements
6580 =item Modules and Pragmata
6584 =item Updated Modules And Pragmata
6586 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
6587 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
6588 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
6589 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
6590 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
6591 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
6592 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
6597 =item Utility Changes
6599 =item New Documentation
6601 =item Performance Enhancements
6603 =item Installation and Configuration Improvements
6607 =item Platform-specific enhancements
6611 =item Selected Bug Fixes
6615 =item Closures, eval and lexicals
6619 =item Platform-specific fixes
6623 =item New or Changed Diagnostics
6627 =item Changed "A thread exited while %d threads were running"
6629 =item Removed "Attempt to clear a restricted hash"
6631 =item New "Illegal declaration of anonymous subroutine"
6633 =item Changed "Invalid range "%s" in transliteration operator"
6635 =item New "Missing control char name in \c"
6637 =item New "Newline in left-justified string for %s"
6639 =item New "Possible precedence problem on bitwise %c operator"
6641 =item New "read() on %s filehandle %s"
6643 =item New "Tied variable freed while still in use"
6645 =item New "To%s: illegal mapping '%s'"
6647 =item New "Use of freed value in iteration"
6651 =item Changed Internals
6655 =item Known Problems
6659 =item Tied hashes in scalar context
6661 =item Net::Ping 450_service and 510_ping_udp failures
6667 =item Platform Specific Problems
6671 =item EBCDIC Platforms
6673 =item Cygwin 1.5 problems
6675 =item HP-UX: HP cc warnings about sendfile and sendpath
6677 =item IRIX: t/uni/tr_7jis.t falsely failing
6679 =item Mac OS X: no usemymalloc
6681 =item Tru64: No threaded builds with GNU cc (gcc)
6683 =item Win32: sysopen, sysread, syswrite
6689 =item Reporting Bugs
6695 =head2 perl588delta, perldelta - what is new for perl v5.8.8
6701 =item Incompatible Changes
6703 =item Core Enhancements
6705 =item Modules and Pragmata
6707 =item Utility Changes
6711 =item C<h2xs> enhancements
6713 =item C<perlivp> enhancements
6717 =item New Documentation
6719 =item Performance Enhancements
6721 =item Installation and Configuration Improvements
6723 =item Selected Bug Fixes
6727 =item no warnings 'category' works correctly with -w
6729 =item Remove over-optimisation
6731 =item sprintf() fixes
6733 =item Debugger and Unicode slowdown
6739 =item New or Changed Diagnostics
6743 =item Attempt to set length of freed array
6745 =item Non-string passed as bitmask
6747 =item Search pattern not terminated or ternary operator parsed as search
6752 =item Changed Internals
6754 =item Platform Specific Problems
6756 =item Reporting Bugs
6762 =head2 perl587delta, perldelta - what is new for perl v5.8.7
6768 =item Incompatible Changes
6770 =item Core Enhancements
6774 =item Unicode Character Database 4.1.0
6776 =item suidperl less insecure
6778 =item Optional site customization script
6780 =item C<Config.pm> is now much smaller.
6784 =item Modules and Pragmata
6786 =item Utility Changes
6790 =item find2perl enhancements
6794 =item Performance Enhancements
6796 =item Installation and Configuration Improvements
6798 =item Selected Bug Fixes
6800 =item New or Changed Diagnostics
6802 =item Changed Internals
6804 =item Known Problems
6806 =item Platform Specific Problems
6808 =item Reporting Bugs
6814 =head2 perl586delta - what is new for perl v5.8.6
6820 =item Incompatible Changes
6822 =item Core Enhancements
6824 =item Modules and Pragmata
6826 =item Utility Changes
6828 =item Performance Enhancements
6830 =item Selected Bug Fixes
6832 =item New or Changed Diagnostics
6834 =item Changed Internals
6838 =item Reporting Bugs
6844 =head2 perl585delta - what is new for perl v5.8.5
6850 =item Incompatible Changes
6852 =item Core Enhancements
6854 =item Modules and Pragmata
6856 =item Utility Changes
6860 =item Perl's debugger
6866 =item Installation and Configuration Improvements
6868 =item Selected Bug Fixes
6870 =item New or Changed Diagnostics
6872 =item Changed Internals
6874 =item Known Problems
6876 =item Platform Specific Problems
6878 =item Reporting Bugs
6884 =head2 perl584delta - what is new for perl v5.8.4
6890 =item Incompatible Changes
6892 =item Core Enhancements
6896 =item Malloc wrapping
6898 =item Unicode Character Database 4.0.1
6900 =item suidperl less insecure
6906 =item Modules and Pragmata
6910 =item Updated modules
6912 Attribute::Handlers, B, Benchmark, CGI, Carp, Cwd, Exporter, File::Find,
6913 IO, IPC::Open3, Local::Maketext, Math::BigFloat, Math::BigInt,
6914 Math::BigRat, MIME::Base64, ODBM_File, POSIX, Shell, Socket, Storable,
6915 Switch, Sys::Syslog, Term::ANSIColor, Time::HiRes, Unicode::UCD, Win32,
6916 base, open, threads, utf8
6920 =item Performance Enhancements
6922 =item Utility Changes
6924 =item Installation and Configuration Improvements
6926 =item Selected Bug Fixes
6928 =item New or Changed Diagnostics
6930 =item Changed Internals
6932 =item Future Directions
6934 =item Platform Specific Problems
6936 =item Reporting Bugs
6942 =head2 perl583delta - what is new for perl v5.8.3
6948 =item Incompatible Changes
6950 =item Core Enhancements
6952 =item Modules and Pragmata
6954 CGI, Cwd, Digest, Digest::MD5, Encode, File::Spec, FindBin, List::Util,
6955 Math::BigInt, PodParser, Pod::Perldoc, POSIX, Unicode::Collate,
6956 Unicode::Normalize, Test::Harness, threads::shared
6958 =item Utility Changes
6960 =item New Documentation
6962 =item Installation and Configuration Improvements
6964 =item Selected Bug Fixes
6966 =item New or Changed Diagnostics
6968 =item Changed Internals
6970 =item Configuration and Building
6972 =item Platform Specific Problems
6974 =item Known Problems
6976 =item Future Directions
6980 =item Reporting Bugs
6986 =head2 perl582delta - what is new for perl v5.8.2
6992 =item Incompatible Changes
6994 =item Core Enhancements
6998 =item Hash Randomisation
7004 =item Modules and Pragmata
7008 =item Updated Modules And Pragmata
7010 Devel::PPPort, Digest::MD5, I18N::LangTags, libnet, MIME::Base64,
7011 Pod::Perldoc, strict, Tie::Hash, Time::HiRes, Unicode::Collate,
7012 Unicode::Normalize, UNIVERSAL
7016 =item Selected Bug Fixes
7018 =item Changed Internals
7020 =item Platform Specific Problems
7022 =item Future Directions
7024 =item Reporting Bugs
7030 =head2 perl581delta - what is new for perl v5.8.1
7036 =item Incompatible Changes
7040 =item Hash Randomisation
7042 =item UTF-8 On Filehandles No Longer Activated By Locale
7044 =item Single-number v-strings are no longer v-strings before "=>"
7046 =item (Win32) The -C Switch Has Been Repurposed
7048 =item (Win32) The /d Switch Of cmd.exe
7052 =item Core Enhancements
7056 =item UTF-8 no longer default under UTF-8 locales
7058 =item Unsafe signals again available
7060 =item Tied Arrays with Negative Array Indices
7064 =item Unicode Character Database 4.0.0
7066 =item Deprecation Warnings
7068 =item Miscellaneous Enhancements
7072 =item Modules and Pragmata
7076 =item Updated Modules And Pragmata
7078 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
7079 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
7080 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
7081 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
7082 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
7083 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
7084 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
7089 =item Utility Changes
7091 =item New Documentation
7093 =item Installation and Configuration Improvements
7097 =item Platform-specific enhancements
7101 =item Selected Bug Fixes
7105 =item Closures, eval and lexicals
7109 =item Platform-specific fixes
7113 =item New or Changed Diagnostics
7117 =item Changed "A thread exited while %d threads were running"
7119 =item Removed "Attempt to clear a restricted hash"
7121 =item New "Illegal declaration of anonymous subroutine"
7123 =item Changed "Invalid range "%s" in transliteration operator"
7125 =item New "Missing control char name in \c"
7127 =item New "Newline in left-justified string for %s"
7129 =item New "Possible precedence problem on bitwise %c operator"
7131 =item New "Pseudo-hashes are deprecated"
7133 =item New "read() on %s filehandle %s"
7135 =item New "5.005 threads are deprecated"
7137 =item New "Tied variable freed while still in use"
7139 =item New "To%s: illegal mapping '%s'"
7141 =item New "Use of freed value in iteration"
7145 =item Changed Internals
7149 =item Known Problems
7153 =item Tied hashes in scalar context
7155 =item Net::Ping 450_service and 510_ping_udp failures
7161 =item Platform Specific Problems
7165 =item EBCDIC Platforms
7167 =item Cygwin 1.5 problems
7169 =item HP-UX: HP cc warnings about sendfile and sendpath
7171 =item IRIX: t/uni/tr_7jis.t falsely failing
7173 =item Mac OS X: no usemymalloc
7175 =item Tru64: No threaded builds with GNU cc (gcc)
7177 =item Win32: sysopen, sysread, syswrite
7181 =item Future Directions
7183 =item Reporting Bugs
7189 =head2 perl58delta - what is new for perl v5.8.0
7195 =item Highlights In 5.8.0
7197 =item Incompatible Changes
7201 =item Binary Incompatibility
7203 =item 64-bit platforms and malloc
7205 =item AIX Dynaloading
7207 =item Attributes for C<my> variables now handled at run-time
7209 =item Socket Extension Dynamic in VMS
7211 =item IEEE-format Floating Point Default on OpenVMS Alpha
7213 =item New Unicode Semantics (no more C<use utf8>, almost)
7215 =item New Unicode Properties
7217 =item REF(...) Instead Of SCALAR(...)
7219 =item pack/unpack D/F recycled
7221 =item glob() now returns filenames in alphabetical order
7227 =item Core Enhancements
7231 =item Unicode Overhaul
7233 =item PerlIO is Now The Default
7237 =item Restricted Hashes
7241 =item Understanding of Numbers
7243 =item Arrays now always interpolate into double-quoted strings [561]
7245 =item Miscellaneous Changes
7249 =item Modules and Pragmata
7253 =item New Modules and Pragmata
7255 =item Updated And Improved Modules and Pragmata
7259 =item Utility Changes
7261 =item New Documentation
7263 =item Performance Enhancements
7265 =item Installation and Configuration Improvements
7269 =item Generic Improvements
7271 =item New Or Improved Platforms
7275 =item Selected Bug Fixes
7279 =item Platform Specific Changes and Fixes
7283 =item New or Changed Diagnostics
7285 =item Changed Internals
7287 =item Security Vulnerability Closed [561]
7291 =item Known Problems
7295 =item The Compiler Suite Is Still Very Experimental
7297 =item Localising Tied Arrays and Hashes Is Broken
7299 =item Building Extensions Can Fail Because Of Largefiles
7301 =item Modifying $_ Inside for(..)
7303 =item mod_perl 1.26 Doesn't Build With Threaded Perl
7305 =item lib/ftmp-security tests warn 'system possibly insecure'
7307 =item libwww-perl (LWP) fails base/date #51
7309 =item PDL failing some tests
7313 =item Self-tying Problems
7315 =item ext/threads/t/libc
7317 =item Failure of Thread (5.005-style) tests
7319 =item Timing problems
7321 =item Tied/Magical Array/Hash Elements Do Not Autovivify
7323 =item Unicode in package/class and subroutine names does not work
7327 =item Platform Specific Problems
7333 =item Alpha systems with old gccs fail several tests
7339 =item Cygwin "unable to remap"
7341 =item Cygwin ndbm tests fail on FAT
7343 =item DJGPP Failures
7345 =item FreeBSD built with ithreads coredumps reading large directories
7347 =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
7349 =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
7351 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
7353 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
7355 =item Linux With Sfio Fails op/misc Test 48
7359 =item Mac OS X dyld undefined symbols
7361 =item OS/2 Test Failures
7363 =item op/sprintf tests 91, 129, and 130
7369 =item Solaris x86 Fails Tests With -Duse64bitint
7371 =item SUPER-UX (NEC SX)
7373 =item Term::ReadKey not working on Win32
7385 =item XML::Parser not working
7389 =item Unicode Support on EBCDIC Still Spotty
7391 =item Seen In Perl 5.7 But Gone Now
7395 =item Reporting Bugs
7403 =head2 perl573delta - what's new for perl v5.7.3
7411 =item Reporting Bugs
7419 =head2 perl572delta - what's new for perl v5.7.2
7425 =item Security Vulnerability Closed
7427 =item Incompatible Changes
7431 =item 64-bit platforms and malloc
7433 =item AIX Dynaloading
7435 =item Socket Extension Dynamic in VMS
7437 =item Different Definition of the Unicode Character Classes \p{In...}
7443 =item Core Enhancements
7445 =item Modules and Pragmata
7449 =item New Modules and Distributions
7451 =item Updated And Improved Modules and Pragmata
7455 =item Utility Changes
7457 =item New Documentation
7459 =item Installation and Configuration Improvements
7463 =item New Or Improved Platforms
7465 =item Generic Improvements
7469 =item Selected Bug Fixes
7473 =item Platform Specific Changes and Fixes
7477 =item New or Changed Diagnostics
7479 =item Source Code Enhancements
7483 =item MAGIC constants
7485 =item Better commented code
7487 =item Regex pre-/post-compilation items matched up
7495 =item Known Problems
7501 =item Amiga Perl Invoking Mystery
7503 =item lib/ftmp-security tests warn 'system possibly insecure'
7505 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
7507 =item HP-UX lib/io_multihomed Fails When LP64-Configured
7509 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
7511 =item Linux With Sfio Fails op/misc Test 48
7515 =item op/sprintf tests 129 and 130
7517 =item Failure of Thread tests
7527 =item Localising a Tied Variable Leaks Memory
7529 =item Self-tying of Arrays and Hashes Is Forbidden
7531 =item Variable Attributes are not Currently Usable for Tieing
7533 =item Building Extensions Can Fail Because Of Largefiles
7535 =item The Compiler Suite Is Still Experimental
7537 =item The Long Double Support is Still Experimental
7541 =item Reporting Bugs
7549 =head2 perl571delta - what's new for perl v5.7.1
7555 =item Security Vulnerability Closed
7557 =item Incompatible Changes
7559 =item Core Enhancements
7563 =item AUTOLOAD Is Now Lvaluable
7565 =item PerlIO is Now The Default
7567 =item Signals Are Now Safe
7571 =item Modules and Pragmata
7577 =item Updated And Improved Modules and Pragmata
7581 =item Performance Enhancements
7583 =item Utility Changes
7585 =item New Documentation
7601 =item README.solaris
7605 =item Porting/repository.pod
7609 =item Installation and Configuration Improvements
7613 =item New Or Improved Platforms
7615 =item Generic Improvements
7617 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
7618 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
7619 d_strtoq, d_u32align, d_ualarm, d_usleep
7623 =item Selected Bug Fixes
7627 =item Platform Specific Changes and Fixes
7631 =item New or Changed Diagnostics
7633 =item Changed Internals
7637 =item Known Problems
7641 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
7643 =item lib/ftmp-security tests warn 'system possibly insecure'
7645 =item lib/io_multihomed Fails In LP64-Configured HP-UX
7647 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
7651 =item Linux With Sfio Fails op/misc Test 48
7653 =item sigaction test 13 in VMS
7655 =item sprintf tests 129 and 130
7657 =item Failure of Thread tests
7659 =item Localising a Tied Variable Leaks Memory
7661 =item Self-tying of Arrays and Hashes Is Forbidden
7663 =item Building Extensions Can Fail Because Of Largefiles
7665 =item The Compiler Suite Is Still Experimental
7669 =item Reporting Bugs
7677 =head2 perl570delta - what's new for perl v5.7.0
7683 =item Security Vulnerability Closed
7685 =item Incompatible Changes
7687 =item Core Enhancements
7689 =item Modules and Pragmata
7695 =item Updated And Improved Modules and Pragmata
7699 =item Utility Changes
7701 =item New Documentation
7703 =item Performance Enhancements
7705 =item Installation and Configuration Improvements
7709 =item Generic Improvements
7713 =item Selected Bug Fixes
7717 =item Platform Specific Changes and Fixes
7721 =item New or Changed Diagnostics
7723 =item Changed Internals
7725 =item Known Problems
7729 =item Unicode Support Still Far From Perfect
7731 =item EBCDIC Still A Lost Platform
7733 =item Building Extensions Can Fail Because Of Largefiles
7735 =item ftmp-security tests warn 'system possibly insecure'
7737 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
7739 =item Long Doubles Still Don't Work In Solaris
7741 =item Linux With Sfio Fails op/misc Test 48
7743 =item Storable tests fail in some platforms
7745 =item Threads Are Still Experimental
7747 =item The Compiler Suite Is Still Experimental
7751 =item Reporting Bugs
7759 =head2 perl561delta - what's new for perl v5.6.x
7765 =item Summary of changes between 5.6.0 and 5.6.1
7769 =item Security Issues
7771 =item Core bug fixes
7773 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
7774 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
7775 references to special variables, Lexical warnings, Spurious warnings and
7776 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
7777 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
7778 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
7783 =item Configuration issues
7787 =item Bundled modules
7789 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
7790 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
7791 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
7792 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
7794 =item Platform-specific improvements
7796 NCR MP-RAS, NonStop-UX
7800 =item Core Enhancements
7804 =item Interpreter cloning, threads, and concurrency
7806 =item Lexically scoped warning categories
7808 =item Unicode and UTF-8 support
7810 =item Support for interpolating named characters
7812 =item "our" declarations
7814 =item Support for strings represented as a vector of ordinals
7816 =item Improved Perl version numbering system
7818 =item New syntax for declaring subroutine attributes
7820 =item File and directory handles can be autovivified
7822 =item open() with more than two arguments
7824 =item 64-bit support
7826 =item Large file support
7832 =item Enhanced support for sort() subroutines
7834 =item C<sort $coderef @foo> allowed
7836 =item File globbing implemented internally
7838 =item Support for CHECK blocks
7840 =item POSIX character class syntax [: :] supported
7842 =item Better pseudo-random number generator
7844 =item Improved C<qw//> operator
7846 =item Better worst-case behavior of hashes
7848 =item pack() format 'Z' supported
7850 =item pack() format modifier '!' supported
7852 =item pack() and unpack() support counted strings
7854 =item Comments in pack() templates
7856 =item Weak references
7858 =item Binary numbers supported
7860 =item Lvalue subroutines
7862 =item Some arrows may be omitted in calls through references
7864 =item Boolean assignment operators are legal lvalues
7866 =item exists() is supported on subroutine names
7868 =item exists() and delete() are supported on array elements
7870 =item Pseudo-hashes work better
7872 =item Automatic flushing of output buffers
7874 =item Better diagnostics on meaningless filehandle operations
7876 =item Where possible, buffered data discarded from duped input filehandle
7878 =item eof() has the same old magic as <>
7880 =item binmode() can be used to set :crlf and :raw modes
7882 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
7884 =item system(), backticks and pipe open now reflect exec() failure
7886 =item Improved diagnostics
7888 =item Diagnostics follow STDERR
7890 =item More consistent close-on-exec behavior
7892 =item syswrite() ease-of-use
7894 =item Better syntax checks on parenthesized unary operators
7896 =item Bit operators support full native integer width
7898 =item Improved security features
7900 =item More functional bareword prototype (*)
7902 =item C<require> and C<do> may be overridden
7904 =item $^X variables may now have names longer than one character
7906 =item New variable $^C reflects C<-c> switch
7908 =item New variable $^V contains Perl version as a string
7910 =item Optional Y2K warnings
7912 =item Arrays now always interpolate into double-quoted strings
7914 =item @- and @+ provide starting/ending offsets of regex submatches
7918 =item Modules and Pragmata
7924 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
7925 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
7926 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
7927 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
7928 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
7929 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
7930 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
7931 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
7937 =item Utility Changes
7951 =item The Perl Debugger
7955 =item Improved Documentation
7957 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
7958 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
7959 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
7960 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
7962 =item Performance enhancements
7966 =item Simple sort() using { $a <=> $b } and the like are optimized
7968 =item Optimized assignments to lexical variables
7970 =item Faster subroutine calls
7972 =item delete(), each(), values() and hash iteration are faster
7976 =item Installation and Configuration Improvements
7980 =item -Dusethreads means something different
7982 =item New Configure flags
7984 =item Threadedness and 64-bitness now more daring
7990 =item -Duselargefiles
7992 =item installusrbinperl
7998 =item Enhanced Installation Directories
8000 =item gcc automatically tried if 'cc' does not seem to be working
8004 =item Platform specific changes
8008 =item Supported platforms
8012 =item OS390 (OpenEdition MVS)
8020 =item Significant bug fixes
8024 =item <HANDLE> on empty files
8026 =item C<eval '...'> improvements
8028 =item All compilation errors are true errors
8030 =item Implicitly closed filehandles are safer
8032 =item Behavior of list slices is more consistent
8034 =item C<(\$)> prototype and C<$foo{a}>
8036 =item C<goto &sub> and AUTOLOAD
8038 =item C<-bareword> allowed under C<use integer>
8040 =item Failures in DESTROY()
8042 =item Locale bugs fixed
8046 =item Spurious subroutine stubs after failed subroutine calls
8048 =item Taint failures under C<-U>
8050 =item END blocks and the C<-c> switch
8052 =item Potential to leak DATA filehandles
8056 =item New or Changed Diagnostics
8058 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
8059 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
8060 / cannot take a count, / must be followed by a, A or Z, / must be followed
8061 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
8062 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
8063 passed through, /%s/ should probably be written as "%s", %s() called too
8064 early to check prototype, %s argument is not a HASH or ARRAY element, %s
8065 argument is not a HASH or ARRAY element or slice, %s argument is not a
8066 subroutine name, %s package attribute may clash with future reserved word:
8067 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
8068 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
8069 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
8070 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
8071 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
8072 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
8073 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
8074 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
8075 weaken a nonreference, Character class [:%s:] unknown, Character class
8076 syntax [%s] belongs inside character classes, Constant is not %s reference,
8077 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
8078 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
8079 "local" instead of "our"?), Document contains no data, entering effective
8080 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
8081 output, flock() on closed filehandle %s, Global symbol "%s" requires
8082 explicit package name, Hexadecimal number > 0xffffffff non-portable,
8083 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
8084 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
8085 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
8086 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
8087 separator character %s in attribute list, Invalid separator character %s in
8088 subroutine attribute list, leaving effective %s failed, Lvalue subs
8089 returning %s not implemented yet, Method %s not permitted, Missing
8090 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
8091 No %s specified for -%c, No package name allowed for variable %s in "our",
8092 No space allowed after -%c, no UTC offset information; assuming local time
8093 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
8094 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
8095 around "%s" list, Possible unintended interpolation of %s in string,
8096 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
8097 instead, Premature end of script headers, Repeat count in pack overflows,
8098 Repeat count in unpack overflows, realloc() of freed memory ignored,
8099 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
8100 zero-length expression, switching effective %s is not implemented, This
8101 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
8102 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
8103 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
8104 escape \\%c passed through, Unterminated attribute parameter in attribute
8105 list, Unterminated attribute list, Unterminated attribute parameter in
8106 subroutine attribute list, Unterminated subroutine attribute list, Value of
8107 CLI symbol "%s" too long, Version number must be a constant number
8111 =item Incompatible Changes
8115 =item Perl Source Incompatibilities
8117 CHECK is a new keyword, Treatment of list slices of undef has changed,
8118 Format of $English::PERL_VERSION is different, Literals of the form
8119 C<1.2.3> parse differently, Possibly changed pseudo-random number
8120 generator, Hashing function for hash keys has changed, C<undef> fails on
8121 read only values, Close-on-exec bit may be set on pipe and socket handles,
8122 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
8123 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
8124 Text of some diagnostic output has changed, C<%@> has been removed,
8125 Parenthesized not() behaves like a list operator, Semantics of bareword
8126 prototype C<(*)> have changed, Semantics of bit operators may have changed
8127 on 64-bit platforms, More builtins taint their results
8129 =item C Source Incompatibilities
8131 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
8133 =item Compatible C Source API Changes
8135 C<PATCHLEVEL> is now C<PERL_VERSION>
8137 =item Binary Incompatibilities
8141 =item Known Problems
8145 =item Localizing a tied hash element may leak memory
8147 =item Known test failures
8149 =item EBCDIC platforms not fully supported
8151 =item UNICOS/mk CC failures during Configure run
8153 =item Arrow operator and arrays
8155 =item Experimental features
8157 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
8158 pseudo-hash data type, The Compiler suite, Internal implementation of file
8159 globbing, The DB module, The regular expression code constructs:
8163 =item Obsolete Diagnostics
8165 Character class syntax [: :] is reserved for future extensions, Ill-formed
8166 logical name |%s| in prime_env_iter, In string, @%s now must be written as
8167 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
8168 to mean "${$}<digit>" is deprecated
8170 =item Reporting Bugs
8178 =head2 perl56delta - what's new for perl v5.6.0
8184 =item Core Enhancements
8188 =item Interpreter cloning, threads, and concurrency
8190 =item Lexically scoped warning categories
8192 =item Unicode and UTF-8 support
8194 =item Support for interpolating named characters
8196 =item "our" declarations
8198 =item Support for strings represented as a vector of ordinals
8200 =item Improved Perl version numbering system
8202 =item New syntax for declaring subroutine attributes
8204 =item File and directory handles can be autovivified
8206 =item open() with more than two arguments
8208 =item 64-bit support
8210 =item Large file support
8216 =item Enhanced support for sort() subroutines
8218 =item C<sort $coderef @foo> allowed
8220 =item File globbing implemented internally
8222 =item Support for CHECK blocks
8224 =item POSIX character class syntax [: :] supported
8226 =item Better pseudo-random number generator
8228 =item Improved C<qw//> operator
8230 =item Better worst-case behavior of hashes
8232 =item pack() format 'Z' supported
8234 =item pack() format modifier '!' supported
8236 =item pack() and unpack() support counted strings
8238 =item Comments in pack() templates
8240 =item Weak references
8242 =item Binary numbers supported
8244 =item Lvalue subroutines
8246 =item Some arrows may be omitted in calls through references
8248 =item Boolean assignment operators are legal lvalues
8250 =item exists() is supported on subroutine names
8252 =item exists() and delete() are supported on array elements
8254 =item Pseudo-hashes work better
8256 =item Automatic flushing of output buffers
8258 =item Better diagnostics on meaningless filehandle operations
8260 =item Where possible, buffered data discarded from duped input filehandle
8262 =item eof() has the same old magic as <>
8264 =item binmode() can be used to set :crlf and :raw modes
8266 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
8268 =item system(), backticks and pipe open now reflect exec() failure
8270 =item Improved diagnostics
8272 =item Diagnostics follow STDERR
8274 =item More consistent close-on-exec behavior
8276 =item syswrite() ease-of-use
8278 =item Better syntax checks on parenthesized unary operators
8280 =item Bit operators support full native integer width
8282 =item Improved security features
8284 =item More functional bareword prototype (*)
8286 =item C<require> and C<do> may be overridden
8288 =item $^X variables may now have names longer than one character
8290 =item New variable $^C reflects C<-c> switch
8292 =item New variable $^V contains Perl version as a string
8294 =item Optional Y2K warnings
8296 =item Arrays now always interpolate into double-quoted strings
8298 =item @- and @+ provide starting/ending offsets of regex matches
8302 =item Modules and Pragmata
8308 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
8309 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
8310 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
8311 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
8312 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
8313 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
8314 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
8315 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
8321 =item Utility Changes
8335 =item The Perl Debugger
8339 =item Improved Documentation
8341 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
8342 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
8343 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
8344 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
8346 =item Performance enhancements
8350 =item Simple sort() using { $a <=> $b } and the like are optimized
8352 =item Optimized assignments to lexical variables
8354 =item Faster subroutine calls
8356 =item delete(), each(), values() and hash iteration are faster
8360 =item Installation and Configuration Improvements
8364 =item -Dusethreads means something different
8366 =item New Configure flags
8368 =item Threadedness and 64-bitness now more daring
8374 =item -Duselargefiles
8376 =item installusrbinperl
8382 =item Enhanced Installation Directories
8386 =item Platform specific changes
8390 =item Supported platforms
8394 =item OS390 (OpenEdition MVS)
8402 =item Significant bug fixes
8406 =item <HANDLE> on empty files
8408 =item C<eval '...'> improvements
8410 =item All compilation errors are true errors
8412 =item Implicitly closed filehandles are safer
8414 =item Behavior of list slices is more consistent
8416 =item C<(\$)> prototype and C<$foo{a}>
8418 =item C<goto &sub> and AUTOLOAD
8420 =item C<-bareword> allowed under C<use integer>
8422 =item Failures in DESTROY()
8424 =item Locale bugs fixed
8428 =item Spurious subroutine stubs after failed subroutine calls
8430 =item Taint failures under C<-U>
8432 =item END blocks and the C<-c> switch
8434 =item Potential to leak DATA filehandles
8438 =item New or Changed Diagnostics
8440 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
8441 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
8442 / cannot take a count, / must be followed by a, A or Z, / must be followed
8443 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
8444 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
8445 passed through, /%s/ should probably be written as "%s", %s() called too
8446 early to check prototype, %s argument is not a HASH or ARRAY element, %s
8447 argument is not a HASH or ARRAY element or slice, %s argument is not a
8448 subroutine name, %s package attribute may clash with future reserved word:
8449 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
8450 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
8451 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
8452 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
8453 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
8454 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
8455 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
8456 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
8457 weaken a nonreference, Character class [:%s:] unknown, Character class
8458 syntax [%s] belongs inside character classes, Constant is not %s reference,
8459 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
8460 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
8461 "local" instead of "our"?), Document contains no data, entering effective
8462 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
8463 output, flock() on closed filehandle %s, Global symbol "%s" requires
8464 explicit package name, Hexadecimal number > 0xffffffff non-portable,
8465 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
8466 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
8467 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
8468 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
8469 separator character %s in attribute list, Invalid separator character %s in
8470 subroutine attribute list, leaving effective %s failed, Lvalue subs
8471 returning %s not implemented yet, Method %s not permitted, Missing
8472 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
8473 No %s specified for -%c, No package name allowed for variable %s in "our",
8474 No space allowed after -%c, no UTC offset information; assuming local time
8475 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
8476 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
8477 around "%s" list, Possible unintended interpolation of %s in string,
8478 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
8479 instead, Premature end of script headers, Repeat count in pack overflows,
8480 Repeat count in unpack overflows, realloc() of freed memory ignored,
8481 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
8482 zero-length expression, switching effective %s is not implemented, This
8483 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
8484 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
8485 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
8486 escape \\%c passed through, Unterminated attribute parameter in attribute
8487 list, Unterminated attribute list, Unterminated attribute parameter in
8488 subroutine attribute list, Unterminated subroutine attribute list, Value of
8489 CLI symbol "%s" too long, Version number must be a constant number
8493 =item Incompatible Changes
8497 =item Perl Source Incompatibilities
8499 CHECK is a new keyword, Treatment of list slices of undef has changed,
8500 Format of $English::PERL_VERSION is different, Literals of the form
8501 C<1.2.3> parse differently, Possibly changed pseudo-random number
8502 generator, Hashing function for hash keys has changed, C<undef> fails on
8503 read only values, Close-on-exec bit may be set on pipe and socket handles,
8504 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
8505 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
8506 Text of some diagnostic output has changed, C<%@> has been removed,
8507 Parenthesized not() behaves like a list operator, Semantics of bareword
8508 prototype C<(*)> have changed, Semantics of bit operators may have changed
8509 on 64-bit platforms, More builtins taint their results
8511 =item C Source Incompatibilities
8513 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
8515 =item Compatible C Source API Changes
8517 C<PATCHLEVEL> is now C<PERL_VERSION>
8519 =item Binary Incompatibilities
8523 =item Known Problems
8527 =item Thread test failures
8529 =item EBCDIC platforms not supported
8531 =item In 64-bit HP-UX the lib/io_multihomed test may hang
8533 =item NEXTSTEP 3.3 POSIX test failure
8535 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
8538 =item UNICOS/mk CC failures during Configure run
8540 =item Arrow operator and arrays
8542 =item Experimental features
8544 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
8545 pseudo-hash data type, The Compiler suite, Internal implementation of file
8546 globbing, The DB module, The regular expression code constructs:
8550 =item Obsolete Diagnostics
8552 Character class syntax [: :] is reserved for future extensions, Ill-formed
8553 logical name |%s| in prime_env_iter, In string, @%s now must be written as
8554 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
8555 to mean "${$}<digit>" is deprecated
8557 =item Reporting Bugs
8565 =head2 perl5005delta - what's new for perl5.005
8571 =item About the new versioning system
8573 =item Incompatible Changes
8577 =item WARNING: This version is not binary compatible with Perl 5.004.
8579 =item Default installation structure has changed
8581 =item Perl Source Compatibility
8583 =item C Source Compatibility
8585 =item Binary Compatibility
8587 =item Security fixes may affect compatibility
8589 =item Relaxed new mandatory warnings introduced in 5.004
8603 =item Regular Expressions
8605 Many new and improved optimizations, Many bug fixes, New regular expression
8606 constructs, New operator for precompiled regular expressions, Other
8607 improvements, Incompatible changes
8609 =item Improved malloc()
8611 =item Quicksort is internally implemented
8613 =item Reliable signals
8615 =item Reliable stack pointers
8617 =item More generous treatment of carriage returns
8621 =item Better support for multiple interpreters
8623 =item Behavior of local() on array and hash elements is now well-defined
8625 =item C<%!> is transparently tied to the L<Errno> module
8627 =item Pseudo-hashes are supported
8629 =item C<EXPR foreach EXPR> is supported
8631 =item Keywords can be globally overridden
8633 =item C<$^E> is meaningful on Win32
8635 =item C<foreach (1..1000000)> optimized
8637 =item C<Foo::> can be used as implicitly quoted package name
8639 =item C<exists $Foo::{Bar::}> tests existence of a package
8641 =item Better locale support
8643 =item Experimental support for 64-bit platforms
8645 =item prototype() returns useful results on builtins
8647 =item Extended support for exception handling
8649 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
8651 =item All C<printf> format conversions are handled internally
8653 =item New C<INIT> keyword
8655 =item New C<lock> keyword
8657 =item New C<qr//> operator
8659 =item C<our> is now a reserved word
8661 =item Tied arrays are now fully supported
8663 =item Tied handles support is better
8665 =item 4th argument to substr
8667 =item Negative LENGTH argument to splice
8669 =item Magic lvalues are now more magical
8671 =item <> now reads in records
8675 =item Supported Platforms
8681 =item Changes in existing support
8685 =item Modules and Pragmata
8691 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
8692 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
8693 Thread, attrs, fields, re
8695 =item Changes in existing modules
8697 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
8698 MakeMaker, CPAN, Cwd
8702 =item Utility Changes
8704 =item Documentation Changes
8706 =item New Diagnostics
8708 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
8709 while coercing array into hash, Bareword "%s" refers to nonexistent
8710 package, Can't call method "%s" on an undefined value, Can't check
8711 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
8712 goto subroutine from an eval-string, Can't localize pseudo-hash element,
8713 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
8714 for "%s", Character class syntax [. .] is reserved for future extensions,
8715 Character class syntax [: :] is reserved for future extensions, Character
8716 class syntax [= =] is reserved for future extensions, %s: Eval-group in
8717 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
8718 Eval-group not allowed at run time, Explicit blessing to '' (assuming
8719 package main), Illegal hex digit ignored, No such array field, No such
8720 field "%s" in variable %s of type %s, Out of memory during ridiculously
8721 large request, Range iterator outside integer range, Recursive inheritance
8722 detected while looking for method '%s' %s, Reference found where even-sized
8723 list expected, Undefined value assigned to typeglob, Use of reserved word
8724 "%s" is deprecated, perl: warning: Setting locale failed
8726 =item Obsolete Diagnostics
8728 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
8729 temporary file, regexp too big
8731 =item Configuration Changes
8741 =head2 perl5004delta - what's new for perl5.004
8747 =item Supported Environments
8753 =item List assignment to %ENV works
8755 =item Change to "Can't locate Foo.pm in @INC" error
8757 =item Compilation option: Binary compatibility with 5.003
8759 =item $PERL5OPT environment variable
8761 =item Limitations on B<-M>, B<-m>, and B<-T> options
8763 =item More precise warnings
8765 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
8767 =item Previously deprecated %OVERLOAD is no longer usable
8769 =item Subroutine arguments created only when they're modified
8771 =item Group vector changeable with C<$)>
8773 =item Fixed parsing of $$<digit>, &$<digit>, etc.
8775 =item Fixed localization of $<digit>, $&, etc.
8777 =item No resetting of $. on implicit close
8779 =item C<wantarray> may return undef
8781 =item C<eval EXPR> determines value of EXPR in scalar context
8783 =item Changes to tainting checks
8785 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
8786 spawning if tainted $TERM doesn't look like a terminal name
8788 =item New Opcode module and revised Safe module
8790 =item Embedding improvements
8792 =item Internal change: FileHandle class based on IO::* classes
8794 =item Internal change: PerlIO abstraction interface
8796 =item New and changed syntax
8800 =item New and changed builtin constants
8804 =item New and changed builtin variables
8808 =item New and changed builtin functions
8810 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
8811 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
8812 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
8813 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
8814 nested C<sub{}> closures work now, formats work right on changing lexicals
8816 =item New builtin methods
8818 isa(CLASS), can(METHOD), VERSION( [NEED] )
8820 =item TIEHANDLE now supported
8822 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
8823 LIST, READLINE this, GETC this, DESTROY this
8825 =item Malloc enhancements
8827 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
8829 =item Miscellaneous efficiency enhancements
8833 =item Support for More Operating Systems
8849 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
8850 constant NAME => VALUE, use locale, use ops, use vmsish
8856 =item Required Updates
8858 =item Installation directories
8860 =item Module information summary
8874 =item Object-oriented overrides for builtin operators
8878 =item Utility Changes
8884 Sends converted HTML to standard output
8888 C<void> XSUBs now default to returning nothing
8892 =item C Language API Changes
8894 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
8897 =item Documentation Changes
8899 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
8900 L<perlmodlib>, L<perldebug>, L<perlsec>
8902 =item New Diagnostics
8904 "my" variable %s masks earlier declaration in same scope, %s argument is
8905 not a HASH element or slice, Allocation too large: %lx, Allocation too
8906 large, Applying %s to %s will act on scalar(%s), Attempt to free
8907 nonexistent shared string, Attempt to use reference as lvalue in substr,
8908 Bareword "%s" refers to nonexistent package, Can't redefine active sort
8909 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
8910 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
8911 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
8912 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
8913 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
8914 %s, Integer overflow in hex number, Integer overflow in octal number,
8915 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
8916 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
8917 possible typo, Null picture in formline, Offset outside string, Out of
8918 memory!, Out of memory during request for %s, panic: frexp, Possible
8919 attempt to put comments in qw() list, Possible attempt to separate words
8920 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
8921 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
8922 option, untie attempted while %d inner references still exist, Unrecognized
8923 character %s, Unsupported function fork, Use of "$$<digit>" to mean
8924 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
8925 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
8926 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
8927 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
8928 long, Process terminated by SIG%s
8938 =head2 perlartistic - the Perl Artistic License
8946 =item The "Artistic License"
8954 "Package", "Standard Version", "Copyright Holder", "You", "Reasonable
8955 copying fee", "Freely Available"
8959 a), b), c), d), a), b), c), d)
8965 =head2 perlgpl - the GNU General Public License, version 2
8977 =item GNU GENERAL PUBLIC LICENSE
8981 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
8989 =item Compiling Perl 5 on AIX
8993 =item Building Dynamic Extensions on AIX
8995 =item The IBM ANSI C Compiler
8997 =item The usenm option
8999 =item Using GNU's gcc for building perl
9001 =item Using Large Files with Perl
9007 =item AIX 4.2 and extensions using C++ with statics
9017 =head2 perlamiga - Perl under Amiga OS
9033 =item Prerequisites for Compiling Perl on AmigaOS
9035 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
9037 =item Starting Perl programs under AmigaOS
9039 =item Shortcomings of Perl under AmigaOS
9045 =item Accessing documentation
9049 =item Manpages for Perl on AmigaOS
9051 =item Perl HTML Documentation on AmigaOS
9053 =item Perl GNU Info Files on AmigaOS
9055 =item Perl LaTeX Documentation on AmigaOS
9059 =item BUILDING PERL ON AMIGAOS
9063 =item Build Prerequisites for Perl on AmigaOS
9065 =item Getting the Perl Source for AmigaOS
9067 =item Making Perl on AmigaOS
9069 =item Testing Perl on AmigaOS
9071 =item Installing the built Perl on AmigaOS
9075 =item PERL 5.8.0 BROKEN IN AMIGAOS
9083 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
9093 =head2 perlbeos, README.beos - Perl version 5.8+ on BeOS
9099 =item BUILD AND INSTALL
9113 =item KNOWN PROBLEMS
9119 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
9129 =item gzip on BS2000
9131 =item bison on BS2000
9133 =item Unpacking Perl Distribution on BS2000
9135 =item Compiling Perl on BS2000
9137 =item Testing Perl on BS2000
9139 =item Installing Perl on BS2000
9141 =item Using Perl in the Posix-Shell of BS2000
9143 =item Using Perl in "native" BS2000
9145 =item Floating point anomalies on BS2000
9147 =item Using PerlIO and different encodings on ASCII and EBCDIC partitions
9165 =head2 perlce - Perl for WinCE
9169 =item Building Perl for WinCE
9175 =item General explanations on cross-compiling WinCE
9179 Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's
9180 celib-sources, Rainer Keuchel's console-sources, go to C<./win32>
9181 subdirectory, edit file C<compile.bat>, run compile.bat, run
9186 =item Using Perl on WinCE
9196 PERL5LIB, PATH, TMP, UNIXROOTPATH, ROWS/COLS, HOME, CONSOLEFONTSIZE
9208 =item ACKNOWLEDGEMENTS
9210 =item History of WinCE port
9214 Rainer Keuchel <coyxc@rainer-keuchel.de>, Vadim Konovalov
9218 =head2 perlcygwin, README.cygwin - Perl for Cygwin
9224 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
9228 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
9230 =item Cygwin Configuration
9232 C<PATH>, I<nroff>, Permissions
9236 =item CONFIGURE PERL ON CYGWIN
9240 =item Stripping Perl Binaries on Cygwin
9242 =item Optional Libraries for Perl on Cygwin
9244 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
9245 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
9247 =item Configure-time Options for Perl on Cygwin
9249 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
9250 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
9253 =item Suspicious Warnings on Cygwin
9255 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
9259 =item MAKE ON CYGWIN
9263 =item Errors on Cygwin
9269 =item TEST ON CYGWIN
9273 =item File Permissions on Cygwin
9275 =item NDBM_File and ODBM_File do not work on FAT filesystems
9277 =item C<fork()> failures in io_* tests
9281 =item Specific features of the Cygwin port
9285 =item Script Portability on Cygwin
9287 Pathnames, Text/Binary, PerlIO, F<.exe>, cygwin vs. windows process ids,
9288 C<chown()>, Miscellaneous
9290 =item Prebuilt methods:
9292 C<Cwd::cwd>, C<Cygwin::pid_to_winpid>, C<Cygwin::winpid_to_pid>
9296 =item INSTALL PERL ON CYGWIN
9298 =item MANIFEST ON CYGWIN
9300 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
9301 Source, Compiled Module Source, Perl Modules/Scripts
9303 =item BUGS ON CYGWIN
9311 =head2 perldgux - Perl under DG/UX.
9323 =item BUILDING PERL ON DG/UX
9327 =item Non-threaded Perl on DG/UX
9329 =item Threaded Perl on DG/UX
9331 =item Testing Perl on DG/UX
9333 =item Installing the built perl on DG/UX
9343 =head2 perldos - Perl under DOS, W31, W95.
9353 =item Prerequisites for Compiling Perl on DOS
9357 =item Shortcomings of Perl under DOS
9359 =item Building Perl on DOS
9361 =item Testing Perl on DOS
9363 =item Installation of Perl on DOS
9367 =item BUILDING AND INSTALLING MODULES ON DOS
9371 =item Building Prerequisites for Perl on DOS
9373 =item Unpacking CPAN Modules on DOS
9375 =item Building Non-XS Modules on DOS
9377 =item Building XS Modules on DOS
9387 =head2 perlepoc, README.epoc - Perl for EPOC
9395 =item INSTALLING PERL ON EPOC
9397 =item STARTING PERL ON EPOC
9401 =item Editors on Epoc
9403 =item Features of Perl on Epoc
9405 =item Restrictions of Perl on Epoc
9407 =item Compiling Perl 5 on the EPOC cross compiling environment
9411 =item SUPPORT STATUS OF PERL ON EPOC
9419 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
9427 =item FreeBSD core dumps from readdir_r with ithreads
9429 =item $^X doesn't always contain a full path in FreeBSD
9431 =item Perl will no longer be part of "base FreeBSD"
9439 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
9448 =item Using perl as shipped with HP-UX
9450 =item Using perl from HP's porting centre
9452 =item Compiling Perl 5 on HP-UX
9456 =item Portability Between PA-RISC Versions
9464 =item Itanium Processor Family and HP-UX
9466 =item Itanium & Itanium 2
9468 =item Building Dynamic Extensions on HP-UX
9470 =item The HP ANSI C Compiler
9472 =item The GNU C Compiler
9474 =item Using Large Files with Perl on HP-UX
9476 =item Threaded Perl on HP-UX
9478 =item 64-bit Perl on HP-UX
9480 =item Oracle on HP-UX
9482 =item GDBM and Threads on HP-UX
9484 =item NFS filesystems and utime(2) on HP-UX
9486 =item perl -P and // and HP-UX
9488 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
9492 =item nss_delete core dump from op/pwent or op/grent
9500 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
9508 =item Known Problems with Perl on Hurd
9516 =head2 perlirix, README.irix - Perl version 5 on Irix systems
9524 =item Building 32-bit Perl in Irix
9526 =item Building 64-bit Perl in Irix
9528 =item About Compiler Versions of Irix
9530 =item Linker Problems in Irix
9532 =item Malloc in Irix
9534 =item Building with threads in Irix
9544 =head2 perllinux, README.linux - Perl version 5 on Linux systems
9552 =item Experimental Support for Sun Studio Compilers for Linux OS
9560 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
9569 =item Perl version 5.8.x and greater not supported
9571 =item Compiling Perl 5.6.x on MachTen
9573 =item Failures during C<make test> on MachTen
9575 op/lexassign.t, pragma/warnings.t
9577 =item Building external modules on MachTen
9587 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
9601 =head2 perlmacosx, README.macosx - Perl under Mac OS X
9611 =item Installation Prefix
9615 =item Universal Binary support
9617 =item 64-bit PPC support
9619 =item libperl and Prebinding
9621 =item Updating Apple's Perl
9623 =item Known problems
9633 =item Starting From Scratch
9641 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
9647 =item Known problems with Perl on MiNT
9653 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
9661 =item Binary distribution from HP
9663 =item What's New in Perl for MPE/iX
9665 =item Welcome to Perl/iX
9667 =item System Requirements for Perl/iX
9669 =item How to Obtain Perl/iX
9671 =item Perl/iX Distribution Contents Highlights
9673 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
9674 public_html/feedback.cgi, src/perl-5.6.0-mpe
9676 =item How to Compile Perl/iX
9680 =item Getting Started with Perl/iX
9682 =item MPE/iX Implementation Considerations
9684 =item Known Perl/iX Bugs Under Investigation
9686 =item Perl/iX To-Do List
9688 =item Perl/iX Change History
9694 =head2 perlnetware - Perl for NetWare
9708 SetNWBld.bat, Buildtype.bat
9720 =item BUILD NEW EXTENSIONS
9722 =item ACKNOWLEDGEMENTS
9730 =head2 perlopenbsd, README.openbsd - Perl version 5 on OpenBSD systems
9738 =item OpenBSD core dumps from getprotobyname_r and getservbyname_r with
9747 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
9767 EMX, RSX, HPFS, pdksh
9769 =item Starting Perl programs under OS/2 (and DOS and...)
9771 =item Starting OS/2 (and DOS) programs under Perl
9775 =item Frequently asked questions
9779 =item "It does not work"
9781 =item I cannot run external programs
9783 =item I cannot embed perl into my program, or use F<perl.dll> from my
9786 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
9789 =item C<``> and pipe-C<open> do not work under DOS.
9791 =item Cannot start C<find.exe "pattern" file>
9799 =item Automatic binary installation
9801 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
9803 =item Manual binary installation
9805 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
9806 (statically linked), Executables for Perl utilities, Main Perl library,
9807 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
9808 and utilities, Manpages for Perl modules, Source for Perl documentation,
9809 Perl manual in F<.INF> format, Pdksh
9815 =item Accessing documentation
9819 =item OS/2 F<.INF> file
9827 =item GNU C<info> files
9839 =item The short story
9843 =item Getting perl source
9845 =item Application of the patches
9853 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
9856 =item Installing the built perl
9858 =item C<a.out>-style build
9862 =item Building a binary distribution
9864 =item Building custom F<.EXE> files
9868 =item Making executables with a custom collection of statically loaded
9871 =item Making executables with a custom search-paths
9879 =item Some C</> became C<\> in pdksh.
9881 =item C<'errno'> - unresolved external
9883 =item Problems with tr or sed
9885 =item Some problem (forget which ;-)
9887 =item Library ... not found
9889 =item Segfault in make
9891 =item op/sprintf test failure
9895 =item Specific (mis)features of OS/2 port
9899 =item C<setpriority>, C<getpriority>
9903 =item C<extproc> on the first line
9905 =item Additional modules:
9907 =item Prebuilt methods:
9909 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>, C<Cwd::current_drive()>,
9910 C<Cwd::sys_chdir(name)>, C<Cwd::change_drive(name)>,
9911 C<Cwd::sys_is_absolute(name)>, C<Cwd::sys_is_rooted(name)>,
9912 C<Cwd::sys_is_relative(name)>, C<Cwd::sys_cwd(name)>,
9913 C<Cwd::sys_abspath(name, dir)>, C<Cwd::extLibpath([type])>,
9914 C<Cwd::extLibpath_set( path [, type ] )>,
9915 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
9916 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
9917 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
9918 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
9919 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
9920 C<OS2::DLLname([how [, \&xsub]])>
9922 =item Prebuilt variables:
9924 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
9931 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
9934 =item Identifying DLLs
9936 =item Centralized management of resources
9938 C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
9939 C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
9940 C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
9941 C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
9955 =item F<perl___.exe>
9957 =item Why strange names?
9959 =item Why dynamic linking?
9961 =item Why chimera build?
9969 =item C<PERLLIB_PREFIX>
9971 =item C<PERL_BADLANG>
9973 =item C<PERL_BADFREE>
9975 =item C<PERL_SH_DIR>
9977 =item C<USE_PERL_FLOCK>
9979 =item C<TMP> or C<TEMP>
9987 =item Text-mode filehandles
9991 =item DLL name mangling: pre 5.6.2
9993 =item DLL name mangling: 5.6.2 and beyond
9995 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
9998 =item DLL forwarder generation
10002 =item Calls to external programs
10004 =item Memory allocation
10008 C<COND_WAIT>, F<os2.c>
10024 =head2 perlos390, README.os390 - building and installing Perl for OS/390
10037 =item Unpacking Perl distribution on OS/390
10039 =item Setup and utilities for Perl on OS/390
10041 =item Configure Perl on OS/390
10043 =item Build, Test, Install Perl on OS/390
10045 =item Build Anomalies with Perl on OS/390
10047 =item Testing Anomalies with Perl on OS/390
10049 =item Installation Anomalies with Perl on OS/390
10051 =item Usage Hints for Perl on OS/390
10053 =item Floating Point Anomalies with Perl on OS/390
10055 =item Modules and Extensions for Perl on OS/390
10065 =item Mailing list for Perl on OS/390
10073 =head2 perlos400, README.os400 - Perl version 5 on OS/400
10081 =item Compiling Perl for OS/400 PASE
10083 =item Installing Perl in OS/400 PASE
10085 =item Using Perl in OS/400 PASE
10087 =item Known Problems
10097 =head2 perlplan9 - Plan 9-specific documentation for Perl
10105 =item Invoking Perl
10107 =item What's in Plan 9 Perl
10109 =item What's not in Plan 9 Perl
10111 =item Perl5 Functions not currently supported in Plan 9 Perl
10113 =item Signals in Plan 9 Perl
10117 =item COMPILING AND INSTALLING PERL ON PLAN 9
10121 =item Installing Perl Documentation on Plan 9
10127 =item Revision date
10133 =head2 perlqnx, README.qnx - Perl version 5 on QNX
10141 =item Required Software for Compiling Perl on QNX4
10143 /bin/sh, ar, nm, cpp, make
10145 =item Outstanding Issues with Perl on QNX4
10147 =item QNX auxiliary files
10151 =item Outstanding issues with perl under QNX6
10159 =head2 perlriscos, README.riscos - Perl version 5 for RISC OS
10171 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
10179 =item Solaris Version Numbers.
10185 Solaris FAQ, Precompiled Binaries, Solaris Documentation
10191 =item File Extraction Problems on Solaris.
10193 =item Compiler and Related Tools on Solaris.
10195 =item Environment for Compiling perl on Solaris
10199 =item RUN CONFIGURE.
10203 =item 64-bit perl on Solaris.
10205 =item Threads in perl on Solaris.
10207 =item Malloc Issues with perl on Solaris.
10211 =item MAKE PROBLEMS.
10213 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
10214 relocation error:, dlopen: stub interception failed, #error "No
10215 DATAMODEL_NATIVE specified", sh: ar: not found
10221 =item op/stat.t test 4 in Solaris
10223 =item nss_delete core dump from op/pwent or op/grent
10227 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
10229 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
10233 =item Limits on Numbers of Open Files on Solaris.
10237 =item SOLARIS-SPECIFIC MODULES.
10239 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
10243 =item Proc::ProcessTable on Solaris
10245 =item BSD::Resource on Solaris
10247 =item Net::SSLeay on Solaris
10257 =head2 perlsymbian, README.symbian - Perl version 5 on Symbian OS
10265 =item Compiling Perl on Symbian
10267 =item Compilation problems
10273 =item Using Perl in Symbian
10293 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
10294 Digital UNIX formerly known as DEC OSF/1) systems
10302 =item Compiling Perl 5 on Tru64
10304 =item Using Large Files with Perl on Tru64
10306 =item Threaded Perl on Tru64
10308 =item Long Doubles on Tru64
10310 =item DB_File tests failing on Tru64
10312 =item 64-bit Perl on Tru64
10314 =item Warnings about floating-point overflow when compiling Perl on Tru64
10318 =item Testing Perl on Tru64
10320 =item ext/ODBM_File/odbm Test Failing With Static Builds
10322 =item Perl Fails Because Of Unresolved Symbol sockatmark
10328 =head2 perluts - Perl under UTS
10336 =item BUILDING PERL ON UTS
10338 =item Installing the built perl on UTS
10344 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
10354 =item Unpacking Perl Distribution on VM/ESA
10356 =item Setup Perl and utilities on VM/ESA
10358 =item Configure Perl on VM/ESA
10360 =item Testing Anomalies of Perl on VM/ESA
10362 =item Usage Hints for Perl on VM/ESA
10372 =item Mailing list for Perl on VM/ESA
10378 =head2 perlvms - VMS-specific documentation for Perl
10386 =item Organization of Perl Images
10392 =item Perl Extensions
10394 =item Installing static extensions
10396 =item Installing dynamic extensions
10400 =item File specifications
10406 =item Wildcard expansion
10412 =item PERL5LIB and PERLLIB
10414 =item PERL_VMS_EXCEPTION_DEBUG
10420 =item I/O redirection and backgrounding
10422 =item Command line switches
10428 =item Perl functions
10430 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, die,
10431 dump, exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//,
10432 select (system call), stat EXPR, system LIST, time, times, unlink LIST,
10433 utime LIST, waitpid PID,FLAGS
10435 =item Perl variables
10437 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
10439 =item Standard modules with VMS-specific differences
10447 =item Revision date
10453 =head2 perlvos, README.vos - Perl for Stratus VOS
10459 =item BUILDING PERL FOR VOS
10461 =item INSTALLING PERL IN VOS
10463 =item USING PERL IN VOS
10467 =item Restrictions of Perl on VOS
10469 =item Handling of underflow and overflow
10475 =item SUPPORT STATUS
10483 =head2 perlwin32 - Perl under Windows
10493 =item Setting Up Perl on Win32
10495 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Visual
10496 C++ Toolkit 2003, Microsoft Platform SDK 64-bit Compiler, MinGW release 3
10497 with gcc, MinGW release 1 with gcc
10501 =item Testing Perl on Win32
10503 =item Installation of Perl on Win32
10505 =item Usage Hints for Perl on Win32
10507 Environment Variables, File Globbing, Using perl from the command line,
10508 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
10509 Extensions, Notes on 64-bit Windows
10511 =item Running Perl Scripts
10513 =item Miscellaneous Things
10517 =item BUGS AND CAVEATS
10519 =item ACKNOWLEDGEMENTS
10523 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
10524 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
10525 E<lt>nick@ing-simmons.netE<gt>, Jan Dubois E<lt>jand@activestate.comE<gt>,
10526 Steve Hay E<lt>steve.hay@uk.radan.comE<gt>
10534 =head1 PRAGMA DOCUMENTATION
10536 =head2 attrs - set/get attributes of a subroutine (deprecated)
10548 =head2 re - Perl pragma to alter regular expression behaviour
10558 =head2 threadshared::shared, threads::shared - Perl extension for sharing
10559 data structures between threads
10571 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
10572 LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
10573 ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
10585 =head2 threads - Perl interpreter-based threads
10595 $thr = threads->create(FUNCTION, ARGS), $thr->join(), $thr->detach(),
10596 threads->detach(), threads->self(), $thr->tid(), threads->tid(),
10597 threads->object($tid), threads->yield(), threads->list(),
10598 $thr1->equal($thr2), async BLOCK;, $thr->_handle(), threads->_handle()
10600 =item THREAD STACK SIZE
10602 threads->get_stack_size();, $size = $thr->get_stack_size();, $old_size =
10603 threads->set_stack_size($new_size);, use threads ('stack_size' => VALUE);,
10604 $ENV{'PERL5_ITHREADS_STACK_SIZE'}, threads->create({'stack_size' => VALUE},
10605 FUNCTION, ARGS), $thr2 = $thr1->create(FUNCTION, ARGS)
10607 =item THREAD SIGNALLING
10609 $thr->kill('SIG...');
10613 A thread exited while # other threads were still running, Thread creation
10614 failed: pthread_create returned #, Thread # terminated abnormally: ..,
10615 Using minimum thread stack size of #, Thread creation failed:
10616 pthread_attr_setstacksize(I<SIZE>) returned 22
10620 This Perl not built to support threads, Cannot change stack size of an
10621 existing thread, Cannot signal other threads without safe signals,
10622 Unrecognized signal name: ..
10626 Parent-child threads, Creating threads inside special blocks, Unsafe
10627 signals, Perl was been built with C<PERL_OLD_SIGNALS> (see C<perl -V>), The
10628 environment variable C<PERL_SIGNALS> is set to C<unsafe> (see
10629 L<perlrun/"PERL_SIGNALS">), The module L<Perl::Unsafe::Signals> is used,
10630 Returning closures from threads, Perl Bugs and the CPAN Version of
10639 =item ACKNOWLEDGEMENTS
10643 =head2 assertions - select assertions in blocks of code
10653 =item Selecting assertions
10655 =item Handling assertions your own way
10657 enabled($on), enabled(), seen($on), seen()
10661 =item COMPATIBILITY
10667 =item COPYRIGHT AND LICENSE
10671 =head2 assertions::activate - activate assertions
10683 =item COPYRIGHT AND LICENSE
10687 =head2 assertions::compat - assertions for pre-5.9 versions of perl
10697 =item The C<assertion> attribute handler
10699 =item Assertion execution status as a constant
10707 =item COPYRIGHT AND LICENSE
10711 =head2 attributes - get/set subroutine or variable attributes
10721 =item Built-in Attributes
10723 locked, method, lvalue
10725 =item Available Subroutines
10729 =item Package-specific Attribute Handling
10731 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
10733 =item Syntax of Attribute Lists
10741 =item Default exports
10743 =item Available exports
10745 =item Export tags defined
10755 =head2 autouse - postpone load of modules until a function is used
10771 =head2 base - Establish IS-A relationship with base classes at compile time
10781 Base class package "%s" is empty
10791 =head2 bigint - Transparent BigInteger support for Perl
10803 a or accuracy, p or precision, t or trace, l or lib, v or version
10807 =item Internal Format
10829 =head2 bignum - Transparent BigNumber support for Perl
10841 a or accuracy, p or precision, t or trace, l or lib, v or version
10847 inf(), NaN(), upgrade()
10851 =item INTERNAL FORMAT
10869 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
10891 a or accuracy, p or precision, t or trace, l or lib, v or version
10897 perl -Mbigrat -le 'print sqrt(33)'
10898 perl -Mbigrat -le 'print 2*255'
10899 perl -Mbigrat -le 'print 4.5+2*255'
10900 perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'
10901 perl -Mbigrat -le 'print 12->is_odd()';
10911 =head2 blib - Use MakeMaker's uninstalled version of a package
10925 =head2 bytes - Perl pragma to force byte semantics rather than character
10940 =head2 charnames - define character names for C<\N{named}> string literal
10949 =item CUSTOM TRANSLATORS
10951 =item CUSTOM ALIASES
10955 =item Anonymous hashes
10959 =item Alias shortcut
10963 =item charnames::viacode(code)
10965 =item charnames::vianame(name)
10969 =item ILLEGAL CHARACTERS
10975 =head2 constant - Perl pragma to declare constants
10987 =item List constants
10989 =item Defining multiple constants at once
10991 =item Magic constants
10995 =item TECHNICAL NOTES
11005 =head2 diagnostics, splain - produce verbose warning diagnostics
11015 =item The C<diagnostics> Pragma
11017 =item The I<splain> Program
11031 =head2 encoding - allows you to write your script in non-ascii or non-utf8
11041 =item Literal Conversions
11043 =item PerlIO layers for C<STD(IN|OUT)>
11045 =item Implicit upgrading for byte strings
11049 =item FEATURES THAT REQUIRE 5.8.1
11051 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
11055 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
11056 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
11058 =item The Filter Option
11062 =item Filter-related changes at Encode version 1.87
11072 =item DO NOT MIX MULTIPLE ENCODINGS
11074 =item tr/// with ranges
11076 Legend of characters above
11080 =item EXAMPLE - Greekperl
11082 =item KNOWN PROBLEMS
11084 literals in regex that are longer than 127 bytes, EBCDIC, format
11088 =item The Logic of :locale
11098 =head2 encoding::warnings - Warn on implicit encoding conversions
11110 =item Overview of the problem
11112 =item Detecting the problem
11114 =item Solving the problem
11116 Upgrade both sides to unicode-strings, Downgrade both sides to
11117 byte-strings, Specify the encoding for implicit byte-string upgrading,
11118 PerlIO layers for B<STDIN> and B<STDOUT>, Literal conversions, Implicit
11119 upgrading for byte-strings
11137 =head2 feature - Perl pragma to enable new syntactic features
11147 =item The 'switch' feature
11149 =item The '~~' feature
11151 =item The 'say' feature
11153 =item the 'err' feature
11155 =item the 'state' feature
11159 =item FEATURE BUNDLES
11163 =head2 fields - compile-time class fields
11177 =head2 filetest - Perl pragma to control the filetest permission operators
11187 =item subpragma access
11193 =head2 if - C<use> a Perl module if a condition holds
11207 =head2 integer - Perl pragma to use integer arithmetic instead of floating
11218 =head2 less - perl pragma to request less of something from the compiler
11228 =head2 lib - manipulate @INC at compile time
11238 =item Adding directories to @INC
11240 =item Deleting directories from @INC
11242 =item Restoring original @INC
11256 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
11267 =head2 open - perl pragma to set default PerlIO layers for input and output
11275 =item NONPERLIO FUNCTIONALITY
11277 =item IMPLEMENTATION DETAILS
11283 =head2 ops - Perl pragma to restrict unsafe operations when compiling
11295 =head2 overload - Package for overloading Perl operations
11305 =item Declaration of overloaded functions
11307 =item Calling Conventions for Binary Operations
11309 FALSE, TRUE, C<undef>
11311 =item Calling Conventions for Unary Operations
11313 =item Calling Conventions for Mutators
11315 C<++> and C<-->, C<x=> and other assignment versions
11317 =item Overloadable Operations
11319 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
11320 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
11321 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
11323 =item Inheritance and overloading
11325 Strings as values of C<use overload> directive, Overloading of an operation
11326 is inherited by derived classes
11330 =item SPECIAL SYMBOLS FOR C<use overload>
11338 C<undef>, TRUE, defined, but FALSE
11342 =item Copy Constructor
11348 =item MAGIC AUTOGENERATION
11350 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
11351 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
11352 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
11355 =item Minimal set of overloaded operations
11357 =item Losing overloading
11359 =item Run-time Overloading
11361 =item Public functions
11363 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
11365 =item Overloading constants
11367 integer, float, binary, q, qr
11369 =item IMPLEMENTATION
11371 =item Metaphor clash
11377 =item Two-face scalars
11379 =item Two-face references
11381 =item Symbolic calculator
11383 =item I<Really> symbolic calculator
11391 Odd number of arguments for overload::constant, `%s' is not an overloadable
11392 type, `%s' is not a code reference
11398 =head2 sigtrap - Perl pragma to enable simple signal handling
11410 =item SIGNAL HANDLERS
11412 B<stack-trace>, B<die>, B<handler> I<your-handler>
11416 B<normal-signals>, B<error-signals>, B<old-interface-signals>
11420 B<untrapped>, B<any>, I<signal>, I<number>
11428 =head2 sort - perl pragma to control sort() behaviour
11440 =head2 strict - Perl pragma to restrict unsafe constructs
11448 C<strict refs>, C<strict vars>, C<strict subs>
11454 =head2 subs - Perl pragma to predeclare sub names
11464 =head2 threadshared, threads::shared - Perl extension for sharing data
11465 structures between threads
11477 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
11478 LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
11479 ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
11491 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
11502 =item Utility functions
11504 $num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[,
11505 FAIL_OK]), utf8::encode($string), utf8::decode($string), $flag =
11506 utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
11516 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
11526 =head2 version - Perl extension for Version Objects
11536 =item BEST PRACTICES
11538 Be consistent, Be careful
11540 =item What IS a version
11542 Numeric Versions, Extended Versions
11544 =item Numeric Versions
11546 =item Extended Versions
11548 =item Numeric Alpha Versions
11550 =item Object Methods
11552 New Operator, qv(), Normal Form, Numification, Stringification, Comparison
11553 operators, Logical Operators
11557 =item What about v-strings?
11559 =item Types of Versions Objects
11561 Ordinary versions, Alpha Versions
11563 =item Replacement UNIVERSAL::VERSION
11577 =head2 vmsish - Perl pragma to control VMS-specific language features
11585 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
11589 =head2 warnings - Perl pragma to control optional warnings
11597 use warnings::register, warnings::enabled(), warnings::enabled($category),
11598 warnings::enabled($object), warnings::warn($message),
11599 warnings::warn($category, $message), warnings::warn($object, $message),
11600 warnings::warnif($message), warnings::warnif($category, $message),
11601 warnings::warnif($object, $message)
11605 =head2 warnings::register - warnings import function
11615 =head1 MODULE DOCUMENTATION
11617 =head2 AnyDBM_File - provide framework for multiple DBMs
11627 =item DBM Comparisons
11637 =head2 Archive::Tar - module for manipulations of tar archives
11645 =item Object Methods
11649 =item Archive::Tar->new( [$file, $compressed] )
11657 =item $tar->read ( $filename|$handle, $compressed, {opt => 'val'} )
11665 =item $tar->contains_file( $filename )
11671 =item $tar->extract( [@filenames] )
11677 =item $tar->extract_file( $file, [$extract_path] )
11683 =item $tar->list_files( [\@properties] )
11689 =item $tar->get_files( [@filenames] )
11695 =item $tar->get_content( $file )
11701 =item $tar->replace_content( $file, $content )
11707 =item $tar->rename( $file, $new_name )
11713 =item $tar->remove (@filenamelist)
11725 =item $tar->write ( [$file, $compressed, $prefix] )
11731 =item $tar->add_files( @filenamelist )
11737 =item $tar->add_data ( $filename, $data, [$opthashref] )
11739 FILE, HARDLINK, SYMLINK, CHARDEV, BLOCKDEV, DIR, FIFO, SOCKET
11745 =item $tar->error( [$BOOL] )
11751 =item $bool = $tar->has_io_string
11757 =item $bool = $tar->has_perlio
11763 =item Class Methods
11767 =item Archive::Tar->create_archive($file, $compression, @filelist)
11775 =item Archive::Tar->list_archive ($file, $compressed, [\@properties])
11781 =item Archive::Tar->extract_archive ($file, $gzip)
11787 =item Archive::Tar->can_handle_compressed_files
11793 =item GLOBAL VARIABLES
11797 =item $Archive::Tar::FOLLOW_SYMLINK
11799 =item $Archive::Tar::CHOWN
11801 =item $Archive::Tar::CHMOD
11803 =item $Archive::Tar::DO_NOT_USE_PREFIX
11805 =item $Archive::Tar::DEBUG
11807 =item $Archive::Tar::WARN
11809 =item $Archive::Tar::error
11811 =item $Archive::Tar::HAS_PERLIO
11813 =item $Archive::Tar::HAS_IO_STRING
11819 What's the minimum perl version required to run Archive::Tar?, Isn't
11820 Archive::Tar slow?, Isn't Archive::Tar heavier on memory than /bin/tar?,
11821 Can't you lazy-load data instead?, How much memory will an X kb tar file
11822 need?, What do you do with unsupported filetypes in an archive?, How do I
11823 extract only files that have property X from an archive?, How do I access
11828 Check if passed in handles are open for read/write, Allow archives to be
11829 passed in as string, Facilitate processing an opened filehandle of a
11834 =item ACKNOWLEDGEMENTS
11840 =head2 Archive::Tar::File - a subclass for in-memory extracted file from
11853 name, mode, uid, gid, size, mtime, chksum, type, linkname, magic, version,
11854 uname, gname, devmajor, devminor, prefix, raw
11862 =item new( file => $path )
11864 =item new( data => $path, $data, $opt )
11866 =item new( chunk => $chunk )
11898 =item get_content_by_ref
11904 =item replace_content( $content )
11910 =item rename( $new_name )
11916 =item Convenience methods
11918 is_file, is_dir, is_hardlink, is_symlink, is_chardev, is_blockdev, is_fifo,
11919 is_socket, is_longlink, is_label, is_unknown
11923 =head2 Attribute::Handlers - Simpler definition of attribute handlers
11933 [0], [1], [2], [3], [4], [5]
11937 =item Typed lexicals
11939 =item Type-specific attribute handlers
11941 =item Non-interpretive attribute handlers
11943 =item Phase-specific attribute handlers
11945 =item Attributes as C<tie> interfaces
11953 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
11954 attributes>, C<Declaration of %s attribute in package %s may clash with
11955 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
11956 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
11957 be able to apply END handler>
11967 =head2 AutoLoader - load subroutines only on demand
11977 =item Subroutine Stubs
11979 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
11981 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
11983 =item Package Lexicals
11985 =item Not Using AutoLoader
11987 =item B<AutoLoader> vs. B<SelfLoader>
11997 =head2 AutoSplit - split a package for autoloading
12005 $keep, $check, $modtime
12009 =item Multiple packages
12017 =head2 B - The Perl Compiler
12027 =item Utility Functions
12031 =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV>
12034 sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av,
12035 check_av, begin_av, end_av, comppadlist, regex_padav, main_cv
12037 =item Functions for Examining the Symbol Table
12039 walksymtable(SYMREF, METHOD, RECURSE, PREFIX)
12041 =item Functions Returning C<B::OP> objects or for walking op trees
12043 main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG)
12045 =item Miscellaneous Utility Functions
12047 ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR),
12048 perlstring(STR), class(OBJ), threadsv_names
12052 =item OVERVIEW OF CLASSES
12056 =item SV-RELATED CLASSES
12058 =item B::SV Methods
12060 REFCNT, FLAGS, object_2svref
12062 =item B::IV Methods
12064 IV, IVX, UVX, int_value, needs64bits, packiv
12066 =item B::NV Methods
12070 =item B::RV Methods
12074 =item B::PV Methods
12078 =item B::PVMG Methods
12082 =item B::MAGIC Methods
12084 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
12086 =item B::PVLV Methods
12088 TARGOFF, TARGLEN, TYPE, TARG
12090 =item B::BM Methods
12092 USEFUL, PREVIOUS, RARE, TABLE
12094 =item B::GV Methods
12096 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
12097 LINE, FILE, FILEGV, GvREFCNT, FLAGS
12099 =item B::IO Methods
12101 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
12102 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
12104 =item B::AV Methods
12106 FILL, MAX, ARRAY, ARRAYelt, OFF, AvFLAGS
12108 =item B::CV Methods
12110 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB,
12111 XSUBANY, CvFLAGS, const_sv
12113 =item B::HV Methods
12115 FILL, MAX, KEYS, RITER, NAME, ARRAY, PMROOT
12117 =item OP-RELATED CLASSES
12119 =item B::OP Methods
12121 next, sibling, name, ppaddr, desc, targ, type, opt, static, flags, private,
12124 =item B::UNOP METHOD
12128 =item B::BINOP METHOD
12132 =item B::LOGOP METHOD
12136 =item B::LISTOP METHOD
12140 =item B::PMOP Methods
12142 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
12143 pmpermflags, precomp, pmoffset
12145 =item B::SVOP METHOD
12149 =item B::PADOP METHOD
12153 =item B::PVOP METHOD
12157 =item B::LOOP Methods
12159 redoop, nextop, lastop
12161 =item B::COP Methods
12163 label, stash, stashpv, file, cop_seq, arybase, line, warnings, io
12171 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
12180 %insn_data, @insn_name, @optype, @specialsv_name
12186 =head2 B::Assembler - Assemble Perl bytecode
12198 =head2 B::Bblock - Walk basic blocks
12218 =head2 B::Bytecode - Perl compiler's bytecode backend
12230 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
12240 =head2 B::C - Perl compiler's C backend
12250 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
12251 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
12252 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
12263 =head2 B::CC - Perl compiler's optimized C translation backend
12273 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
12274 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
12275 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
12287 =item Context of ".."
12291 =item Deprecated features
12299 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
12313 =item Options for Opcode Ordering
12315 B<-basic>, B<-exec>, B<-tree>
12317 =item Options for Line-Style
12319 B<-concise>, B<-terse>, B<-linenoise>, B<-debug>, B<-env>
12321 =item Options for tree-specific formatting
12323 B<-compact>, B<-loose>, B<-vt>, B<-ascii>
12325 =item Options controlling sequence numbering
12327 B<-base>I<n>, B<-bigendian>, B<-littleendian>
12329 =item Other options
12331 B<-main>, B<-nomain>, B<-nobanner>, B<-banner>, B<-banneris> => subref
12333 =item Option Stickiness
12337 =item ABBREVIATIONS
12341 =item OP class abbreviations
12343 =item OP flags abbreviations
12347 =item FORMATTING SPECIFICATIONS
12351 =item Special Patterns
12353 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
12354 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
12359 B<#>I<var>, B<#>I<var>I<N>, B<#>I<Var>, B<#addr>, B<#arg>, B<#class>,
12360 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
12361 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
12362 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
12363 B<#seq>, B<#seqnum>, B<#opt>, B<#static>, B<#sibaddr>, B<#svaddr>,
12364 B<#svclass>, B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
12368 =item One-Liner Command tips
12370 perl -MO=Concise,bar foo.pl, perl -MDigest::MD5=md5 -MO=Concise,md5 -e1,
12371 perl -MPOSIX -MO=Concise,_POSIX_ARG_MAX -e1, perl -MPOSIX -MO=Concise,a -e
12372 'print _POSIX_SAVED_IDS', perl -MPOSIX -MO=Concise,a -e 'sub
12373 a{_POSIX_SAVED_IDS}'
12375 =item Using B::Concise outside of the O framework
12379 =item Example: Altering Concise Renderings
12383 =item set_style_standard($name)
12387 =item add_callback()
12389 =item Running B::Concise::compile()
12391 =item B::Concise::reset_sequence()
12401 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
12413 =head2 B::Deparse - Perl compiler backend to produce perl code
12423 B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>,
12424 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
12426 =item USING B::Deparse AS A MODULE
12436 =item ambient_pragmas
12438 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
12450 =head2 B::Disassembler - Disassemble Perl bytecode
12462 =head2 B::Lint - Perl lint
12470 =item OPTIONS AND LINT CHECKS
12472 B<context>, B<implicit-read> and B<implicit-write>, B<bare-subs>,
12473 B<dollar-underscore>, B<private-names>, B<undefined-subs>,
12474 B<regexp-variables>, B<all>, B<none>
12476 =item NON LINT-CHECK OPTIONS
12480 =item EXTENDING LINT
12488 =head2 B::O, O - Generic interface to Perl Compiler backends
12498 =item IMPLEMENTATION
12506 =head2 B::Showlex - Show lexical variables used in functions or files
12530 =head2 B::Stackobj - Helper module for CC backend
12542 =head2 B::Stash - show what stashes are loaded
12544 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
12556 =head2 B::Xref - Generates cross reference reports for Perl programs
12566 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
12574 =head2 Bblock, B::Bblock - Walk basic blocks
12594 =head2 Benchmark - benchmark running times of Perl code
12608 =item Standard Exports
12610 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
12611 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
12612 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
12614 =item Optional Exports
12616 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [
12617 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
12618 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
12620 =item :hireswallclock
12636 =item MODIFICATION HISTORY
12640 =head2 ByteLoader - load byte compiled perl code
12654 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
12666 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
12676 =head2 CGI - Simple Common Gateway Interface Class
12688 =item PROGRAMMING STYLE
12690 =item CALLING CGI.PM ROUTINES
12692 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
12694 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
12696 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
12698 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
12700 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
12702 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
12704 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
12706 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
12708 =item DELETING A PARAMETER COMPLETELY:
12710 =item DELETING ALL PARAMETERS:
12712 =item HANDLING NON-URLENCODED ARGUMENTS
12714 =item DIRECT ACCESS TO THE PARAMETER LIST:
12716 =item FETCHING THE PARAMETER LIST AS A HASH:
12718 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
12720 =item RETRIEVING CGI ERRORS
12722 =item USING THE FUNCTION-ORIENTED INTERFACE
12724 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
12725 B<:standard>, B<:all>
12729 -any, -compile, -nosticky, -tabindex, -no_undef_params, -no_xhtml, -nph,
12730 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
12733 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
12735 1. start_table() (generates a <table> tag), 2. end_table() (generates a
12736 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
12741 =item GENERATING DYNAMIC DOCUMENTS
12745 =item CREATING A STANDARD HTTP HEADER:
12747 =item GENERATING A REDIRECTION HEADER
12749 =item CREATING THE HTML DOCUMENT HEADER
12751 B<Parameters:>, 4, 5, 6..
12753 =item ENDING THE HTML DOCUMENT:
12755 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
12757 =item OBTAINING THE SCRIPT'S URL
12759 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
12760 (B<-query_string>), B<-base>, B<-rewrite>
12762 =item MIXING POST AND URL PARAMETERS
12766 =item CREATING STANDARD HTML ELEMENTS:
12770 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
12772 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
12774 =item HTML SHORTCUTS AND LIST INTERPOLATION
12776 =item NON-STANDARD HTML SHORTCUTS
12778 =item AUTOESCAPING HTML
12780 $escaped_string = escapeHTML("unescaped string");, $charset =
12781 charset([$charset]);, $flag = autoEscape([$flag]);
12783 =item PRETTY-PRINTING HTML
12787 =item CREATING FILL-OUT FORMS:
12791 =item CREATING AN ISINDEX TAG
12793 =item STARTING AND ENDING A FORM
12795 B<application/x-www-form-urlencoded>, B<multipart/form-data>
12797 =item FORM ELEMENTS
12799 B<-name>, B<-value>, B<-values>, B<-tabindex>, B<-id>, B<-override>,
12800 B<-onChange>, B<-onFocus>, B<-onBlur>, B<-onMouseOver>, B<-onMouseOut>,
12803 =item CREATING A TEXT FIELD
12807 =item CREATING A BIG TEXT FIELD
12809 =item CREATING A PASSWORD FIELD
12811 =item CREATING A FILE UPLOAD FIELD
12815 =item CREATING A POPUP MENU
12817 =item CREATING AN OPTION GROUP
12819 =item CREATING A SCROLLING LIST
12823 =item CREATING A GROUP OF RELATED CHECKBOXES
12827 =item CREATING A STANDALONE CHECKBOX
12831 =item CREATING A RADIO BUTTON GROUP
12835 =item CREATING A SUBMIT BUTTON
12839 =item CREATING A RESET BUTTON
12841 =item CREATING A DEFAULT BUTTON
12843 =item CREATING A HIDDEN FIELD
12847 =item CREATING A CLICKABLE IMAGE BUTTON
12849 B<Parameters:>, 3. The third option (-align, optional) is an alignment
12850 type, and may be TOP, BOTTOM or MIDDLE
12852 =item CREATING A JAVASCRIPT ACTION BUTTON
12858 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
12859 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
12861 =item WORKING WITH FRAMES
12863 1. Create a <Frameset> document, 2. Specify the destination for the
12864 document in the HTTP header, 3. Specify the destination for the document in
12867 =item SUPPORT FOR JAVASCRIPT
12869 B<onLoad>, B<onUnload>, B<onSubmit>, B<onClick>, B<onChange>, B<onFocus>,
12870 B<onBlur>, B<onSelect>, B<onMouseOver>, B<onMouseOut>
12872 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
12878 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
12882 =item FETCHING ENVIRONMENT VARIABLES
12884 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
12885 B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
12886 name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
12887 ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
12888 B<virtual_port ()>, B<server_software ()>, B<remote_user ()>, B<user_name
12889 ()>, B<request_method()>, B<content_type()>, B<http()>, B<https()>
12891 =item USING NPH SCRIPTS
12893 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
12898 multipart_init(), multipart_start(), multipart_end(), multipart_final()
12900 =item Avoiding Denial of Service Attacks
12902 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
12903 basis>, B<2. Globally for all scripts>
12905 =item COMPATIBILITY WITH CGI-LIB.PL
12907 =item AUTHOR INFORMATION
12911 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
12912 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
12913 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
12914 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
12915 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
12916 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
12917 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
12918 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
12919 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
12920 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
12921 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
12922 ...and many many more..
12924 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
12932 =head2 CGI::Apache - Backward compatibility module for CGI.pm
12942 =item AUTHOR INFORMATION
12950 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
12959 =item REDIRECTING ERROR MESSAGES
12961 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
12965 =item Changing the default message
12969 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
12971 =item OVERRIDING THE NAME OF THE PROGRAM
12979 =head2 CGI::Cookie - Interface to Netscape Cookies
12987 =item USING CGI::Cookie
12989 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
12993 =item Creating New Cookies
12995 =item Sending the Cookie to the Browser
12997 =item Recovering Previous Cookies
12999 =item Manipulating Cookies
13001 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
13005 =item AUTHOR INFORMATION
13013 =head2 CGI::Fast - CGI Interface for Fast CGI
13021 =item OTHER PIECES OF THE PUZZLE
13023 =item WRITING FASTCGI PERL SCRIPTS
13025 =item INSTALLING FASTCGI SCRIPTS
13027 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
13029 =item EXTERNAL FASTCGI SERVER INVOCATION
13031 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
13035 =item AUTHOR INFORMATION
13043 =head2 CGI::Pretty - module to produce nicely formatted HTML code
13053 =item Tags that won't be formatted
13055 =item Customizing the Indenting
13067 =head2 CGI::Push - Simple Interface to Server Push
13075 =item USING CGI::Push
13077 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
13081 =item Heterogeneous Pages
13083 =item Changing the Page Delay on the Fly
13087 =item INSTALLING CGI::Push SCRIPTS
13089 =item AUTHOR INFORMATION
13097 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
13107 =item AUTHOR INFORMATION
13115 =head2 CGI::Util - Internal utilities used by CGI module
13123 =item AUTHOR INFORMATION
13129 =head2 CPAN - query, download and build perl modules from CPAN sites
13137 =item COMPATIBILITY
13143 =item Interactive Mode
13145 Searching for authors, bundles, distribution files and modules, make, test,
13146 install, clean modules or distributions, get, readme, perldoc, look module
13147 or distribution, ls author, ls globbing_expression, failed, Lockfile,
13158 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
13160 =item Programmer's interface
13162 expand($type,@things), expandany(@things), Programming Examples
13164 =item Methods in the other Classes
13166 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
13167 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
13168 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
13169 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
13170 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
13171 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
13172 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
13173 CPAN::Bundle::readme(), CPAN::Bundle::test(),
13174 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
13175 CPAN::Distribution::author, CPAN::Distribution::clean(),
13176 CPAN::Distribution::containsmods(), CPAN::Distribution::cvs_import(),
13177 CPAN::Distribution::dir(), CPAN::Distribution::force($method,@args),
13178 CPAN::Distribution::get(), CPAN::Distribution::install(),
13179 CPAN::Distribution::isa_perl(), CPAN::Distribution::look(),
13180 CPAN::Distribution::make(), CPAN::Distribution::perldoc(),
13181 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
13182 CPAN::Distribution::read_yaml(), CPAN::Distribution::test(),
13183 CPAN::Distribution::uptodate(), CPAN::Index::force_reload(),
13184 CPAN::Index::reload(), CPAN::InfoObj::dump(), CPAN::Module::as_glimpse(),
13185 CPAN::Module::as_string(), CPAN::Module::clean(),
13186 CPAN::Module::cpan_file(), CPAN::Module::cpan_version(),
13187 CPAN::Module::cvs_import(), CPAN::Module::description(),
13188 CPAN::Module::distribution(), CPAN::Module::dslip_status(),
13189 CPAN::Module::force($method,@args), CPAN::Module::get(),
13190 CPAN::Module::inst_file(), CPAN::Module::inst_version(),
13191 CPAN::Module::install(), CPAN::Module::look(), CPAN::Module::make(),
13192 CPAN::Module::manpage_headline(), CPAN::Module::perldoc(),
13193 CPAN::Module::readme(), CPAN::Module::test(), CPAN::Module::uptodate(),
13194 CPAN::Module::userid()
13196 =item Cache Manager
13200 =item Prerequisites
13202 =item Finding packages and VERSION
13206 =item Floppy, Zip, Offline Mode
13210 =item CONFIGURATION
13212 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
13213 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
13214 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
13215 [unshift|push|splice] E<lt>listE<gt>>
13219 =item Not on config variable getcwd
13221 =item Note on urllist parameter's format
13223 =item urllist parameter has CD-ROM support
13231 =item Cryptographically signed modules
13239 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
13241 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
13245 =item Three basic types of firewalls
13247 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
13249 =item Configuring lynx or ncftp for going through a firewall
13255 1), 2), 3), 4), 5), 6), 7), 8), 9), 10), 11), 12), 13), 14)
13267 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
13277 =head2 CPAN::Version - utility functions to compare CPAN versions
13287 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
13300 =head2 Carp, carp - warn of errors (from perspective of caller)
13310 =item Forcing a Stack Trace
13314 =item GLOBAL VARIABLES
13318 =item $Carp::CarpLevel
13320 =item $Carp::MaxEvalLen
13322 =item $Carp::MaxArgLen
13324 =item $Carp::MaxArgNums
13326 =item $Carp::Verbose
13334 =head2 Carp::Heavy - heavy machinery, no user serviceable parts inside
13336 =head2 Class::ISA -- report the search path for a class's ISA tree
13346 the function Class::ISA::super_path($CLASS), the function
13347 Class::ISA::self_and_super_path($CLASS), the function
13348 Class::ISA::self_and_super_versions($CLASS)
13350 =item CAUTIONARY NOTES
13358 =head2 Class::Struct - declare struct-like datatypes as Perl classes
13368 =item The C<struct()> function
13370 =item Class Creation at Compile Time
13372 =item Element Types and Accessor Methods
13374 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
13375 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
13377 =item Initializing with C<new>
13383 Example 1, Example 2, Example 3
13385 =item Author and Modification History
13389 =head2 Compress::IO::Base::lib::File::GlobMapper, File::GlobMapper - Extend
13390 File Glob to Allow Input and Output Files
13398 This code is a work in progress, There are known bugs, The interface
13399 defined here is tentative, There are portability issues, Do not use in
13400 production code, Consider yourself warned!
13404 =item Behind The Scenes
13408 =item Input File Glob
13410 B<~>, B<~user>, B<.>, B<*>, B<?>, B<\>, B<[]>, B<{,}>, B<()>
13412 =item Output File Glob
13416 =item Returned Data
13424 =item A Rename script
13426 =item A few example globmaps
13434 =item COPYRIGHT AND LICENSE
13438 =head2 Compress::IO::Base::lib::IO::Compress::Base, IO::Compress::Base -
13439 Base Class for IO::Compress modules
13451 =item MODIFICATION HISTORY
13453 =item COPYRIGHT AND LICENSE
13457 =head2 Compress::IO::Base::lib::IO::Uncompress::AnyUncompress,
13458 IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop
13467 DO NOT use in production code, The documentation is incomplete in places,
13468 Parts of the interface defined here are tentative, Please report any
13469 problems you find, RFC 1950, RFC 1951, gzip (RFC 1952), zip, bzip2, lzop
13471 =item Functional Interface
13475 =item anyuncompress $input => $output [, OPTS]
13477 A filename, A filehandle, A scalar reference, An array reference, An Input
13478 FileGlob string, A filename, A filehandle, A scalar reference, An Array
13479 Reference, An Output FileGlob
13483 =item Optional Parameters
13485 AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1,
13486 -MultiStream =E<gt> 0|1
13498 A filename, A filehandle, A scalar reference
13500 =item Constructor Options
13502 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
13503 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
13504 -Append =E<gt> 0|1, -Strict =E<gt> 0|1
13524 =item getHeaderInfo
13538 =item input_line_number
13556 =item MODIFICATION HISTORY
13558 =item COPYRIGHT AND LICENSE
13562 =head2 Compress::IO::Base::lib::IO::Uncompress::Base, IO::Uncompress::Base
13563 - Base Class for IO::Uncompress modules
13575 =item MODIFICATION HISTORY
13577 =item COPYRIGHT AND LICENSE
13581 =head2 Compress::IO::Zlib::IO::Compress::Deflate, IO::Compress::Deflate -
13582 Write RFC 1950 files/buffers
13590 DO NOT use in production code, The documentation is incomplete in places,
13591 Parts of the interface defined here are tentative, Please report any
13594 =item Functional Interface
13598 =item deflate $input => $output [, OPTS]
13600 A filename, A filehandle, A scalar reference, An array reference, An Input
13601 FileGlob string, A filename, A filehandle, A scalar reference, An Array
13602 Reference, An Output FileGlob
13606 =item Optional Parameters
13608 AutoClose =E<gt> 0|1, BinModeIn =E<gt> 0|1, -Append =E<gt> 0|1
13620 A filename, A filehandle, A scalar reference
13622 =item Constructor Options
13624 AutoClose =E<gt> 0|1, Append =E<gt> 0|1, A Buffer, A Filename, A
13625 Filehandle, Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1
13657 =item input_line_number
13663 =item newStream([OPTS])
13667 =item deflateParams
13673 :all, :constants, :flush, :level, :strategy
13681 =item MODIFICATION HISTORY
13683 =item COPYRIGHT AND LICENSE
13687 =head2 Compress::IO::Zlib::IO::Compress::Gzip, IO::Compress::Gzip - Write
13688 RFC 1952 files/buffers
13696 DO NOT use in production code, The documentation is incomplete in places,
13697 Parts of the interface defined here are tentative, Please report any
13700 =item Functional Interface
13704 =item gzip $input => $output [, OPTS]
13706 A filename, A filehandle, A scalar reference, An array reference, An Input
13707 FileGlob string, A filename, A filehandle, A scalar reference, An Array
13708 Reference, An Output FileGlob
13712 =item Optional Parameters
13714 AutoClose =E<gt> 0|1, BinModeIn =E<gt> 0|1, -Append =E<gt> 0|1
13726 A filename, A filehandle, A scalar reference
13728 =item Constructor Options
13730 AutoClose =E<gt> 0|1, Append =E<gt> 0|1, A Buffer, A Filename, A
13731 Filehandle, Merge =E<gt> 0|1, -Level, -Strategy, -Minimal =E<gt> 0|1,
13732 -Comment =E<gt> $comment, -Name =E<gt> $string, -Time =E<gt> $number,
13733 -TextFlag =E<gt> 0|1, -HeaderCRC =E<gt> 0|1, -OS_Code =E<gt> $value,
13734 -ExtraField =E<gt> $data, -ExtraFlags =E<gt> $value, -Strict =E<gt> 0|1
13766 =item input_line_number
13772 =item newStream([OPTS])
13776 =item deflateParams
13782 :all, :constants, :flush, :level, :strategy
13790 =item MODIFICATION HISTORY
13792 =item COPYRIGHT AND LICENSE
13796 =head2 Compress::IO::Zlib::IO::Compress::RawDeflate,
13797 IO::Compress::RawDeflate - Write RFC 1951 files/buffers
13805 DO NOT use in production code, The documentation is incomplete in places,
13806 Parts of the interface defined here are tentative, Please report any
13809 =item Functional Interface
13813 =item rawdeflate $input => $output [, OPTS]
13815 A filename, A filehandle, A scalar reference, An array reference, An Input
13816 FileGlob string, A filename, A filehandle, A scalar reference, An Array
13817 Reference, An Output FileGlob
13821 =item Optional Parameters
13823 AutoClose =E<gt> 0|1, BinModeIn =E<gt> 0|1, -Append =E<gt> 0|1
13835 A filename, A filehandle, A scalar reference
13837 =item Constructor Options
13839 AutoClose =E<gt> 0|1, Append =E<gt> 0|1, A Buffer, A Filename, A
13840 Filehandle, Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1
13872 =item input_line_number
13878 =item newStream([OPTS])
13882 =item deflateParams
13888 :all, :constants, :flush, :level, :strategy
13896 =item MODIFICATION HISTORY
13898 =item COPYRIGHT AND LICENSE
13902 =head2 Compress::IO::Zlib::IO::Compress::Zip, IO::Compress::Zip - Write zip
13911 DO NOT use in production code, The documentation is incomplete in places,
13912 Parts of the interface defined here are tentative, Please report any
13915 =item Functional Interface
13919 =item zip $input => $output [, OPTS]
13921 A filename, A filehandle, A scalar reference, An array reference, An Input
13922 FileGlob string, A filename, A filehandle, A scalar reference, An Array
13923 Reference, An Output FileGlob
13927 =item Optional Parameters
13929 AutoClose =E<gt> 0|1, BinModeIn =E<gt> 0|1, -Append =E<gt> 0|1
13941 A filename, A filehandle, A scalar reference
13943 =item Constructor Options
13945 AutoClose =E<gt> 0|1, Append =E<gt> 0|1, A Buffer, A Filename, A
13946 Filehandle, -Name =E<gt> $string, -Time =E<gt> $number, -exTime =E<gt>
13947 [$atime, $mtime, $ctime], -Comment =E<gt> $comment, -ZipComment =E<gt>
13948 $comment, Method =E<gt> $method, Stream =E<gt> 0|1, -TextFlag =E<gt> 0|1,
13949 ExtraFieldLocal =E<gt> $data =item ExtraFieldCentral =E<gt> $data, Minimal
13950 =E<gt> 1|0, BlockSize100K =E<gt> number, WorkFactor =E<gt> number, -Level,
13951 -Strategy, -Strict =E<gt> 0|1
13983 =item input_line_number
13989 =item newStream([OPTS])
13993 =item deflateParams
13999 :all, :constants, :flush, :level, :strategy, :zip_method
14007 =item MODIFICATION HISTORY
14009 =item COPYRIGHT AND LICENSE
14013 =head2 Compress::IO::Zlib::IO::Uncompress::AnyInflate,
14014 IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) file/buffer
14022 DO NOT use in production code, The documentation is incomplete in places,
14023 Parts of the interface defined here are tentative, Please report any
14024 problems you find, RFC 1950, RFC 1951, gzip (RFC 1952), zip
14026 =item Functional Interface
14030 =item anyinflate $input => $output [, OPTS]
14032 A filename, A filehandle, A scalar reference, An array reference, An Input
14033 FileGlob string, A filename, A filehandle, A scalar reference, An Array
14034 Reference, An Output FileGlob
14038 =item Optional Parameters
14040 AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1,
14041 -MultiStream =E<gt> 0|1
14053 A filename, A filehandle, A scalar reference
14055 =item Constructor Options
14057 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
14058 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
14059 -Append =E<gt> 0|1, -Strict =E<gt> 0|1, -ParseExtra =E<gt> 0|1
14081 =item getHeaderInfo
14095 =item input_line_number
14113 =item MODIFICATION HISTORY
14115 =item COPYRIGHT AND LICENSE
14119 =head2 Compress::IO::Zlib::IO::Uncompress::Gunzip, IO::Uncompress::Gunzip -
14120 Read RFC 1952 files/buffers
14128 DO NOT use in production code, The documentation is incomplete in places,
14129 Parts of the interface defined here are tentative, Please report any
14132 =item Functional Interface
14136 =item gunzip $input => $output [, OPTS]
14138 A filename, A filehandle, A scalar reference, An array reference, An Input
14139 FileGlob string, A filename, A filehandle, A scalar reference, An Array
14140 Reference, An Output FileGlob
14144 =item Optional Parameters
14146 AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1,
14147 -MultiStream =E<gt> 0|1
14159 A filename, A filehandle, A scalar reference
14161 =item Constructor Options
14163 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
14164 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
14165 -Append =E<gt> 0|1, -Strict =E<gt> 0|1, -ParseExtra =E<gt> 0|1
14187 =item getHeaderInfo
14203 =item input_line_number
14221 =item MODIFICATION HISTORY
14223 =item COPYRIGHT AND LICENSE
14227 =head2 Compress::IO::Zlib::IO::Uncompress::Inflate, IO::Uncompress::Inflate
14228 - Read RFC 1950 files/buffers
14236 DO NOT use in production code, The documentation is incomplete in places,
14237 Parts of the interface defined here are tentative, Please report any
14240 =item Functional Interface
14244 =item inflate $input => $output [, OPTS]
14246 A filename, A filehandle, A scalar reference, An array reference, An Input
14247 FileGlob string, A filename, A filehandle, A scalar reference, An Array
14248 Reference, An Output FileGlob
14252 =item Optional Parameters
14254 AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1,
14255 -MultiStream =E<gt> 0|1
14267 A filename, A filehandle, A scalar reference
14269 =item Constructor Options
14271 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
14272 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
14273 -Append =E<gt> 0|1, -Strict =E<gt> 0|1
14295 =item getHeaderInfo
14309 =item input_line_number
14327 =item MODIFICATION HISTORY
14329 =item COPYRIGHT AND LICENSE
14333 =head2 Compress::IO::Zlib::IO::Uncompress::RawInflate,
14334 IO::Uncompress::RawInflate - Read RFC 1951 files/buffers
14342 DO NOT use in production code, The documentation is incomplete in places,
14343 Parts of the interface defined here are tentative, Please report any
14346 =item Functional Interface
14350 =item rawinflate $input => $output [, OPTS]
14352 A filename, A filehandle, A scalar reference, An array reference, An Input
14353 FileGlob string, A filename, A filehandle, A scalar reference, An Array
14354 Reference, An Output FileGlob
14358 =item Optional Parameters
14360 AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1,
14361 -MultiStream =E<gt> 0|1
14373 A filename, A filehandle, A scalar reference
14375 =item Constructor Options
14377 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
14378 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
14379 -Append =E<gt> 0|1, -Strict =E<gt> 0|1
14401 =item getHeaderInfo
14415 =item input_line_number
14433 =item MODIFICATION HISTORY
14435 =item COPYRIGHT AND LICENSE
14439 =head2 Compress::IO::Zlib::IO::Uncompress::Unzip, IO::Uncompress::Unzip -
14440 Read zip files/buffers
14448 DO NOT use in production code, The documentation is incomplete in places,
14449 Parts of the interface defined here are tentative, Please report any
14452 =item Functional Interface
14456 =item unzip $input => $output [, OPTS]
14458 A filename, A filehandle, A scalar reference, An array reference, An Input
14459 FileGlob string, A filename, A filehandle, A scalar reference, An Array
14460 Reference, An Output FileGlob
14464 =item Optional Parameters
14466 AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1,
14467 -MultiStream =E<gt> 0|1
14479 A filename, A filehandle, A scalar reference
14481 =item Constructor Options
14483 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
14484 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
14485 -Append =E<gt> 0|1, -Strict =E<gt> 0|1
14507 =item getHeaderInfo
14521 =item input_line_number
14539 =item MODIFICATION HISTORY
14541 =item COPYRIGHT AND LICENSE
14545 =head2 Compress::Raw::Zlib - Low-Level Interface to zlib compression
14554 =item Compress::Raw::Zlib::Deflate
14558 =item B<($d, $status) = new Compress::Raw::Zlib::Deflate( [OPT] ) >
14560 B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>,
14561 B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32>
14563 =item B<$status = $d-E<gt>deflate($input, $output)>
14565 =item B<$status = $d-E<gt>flush($output [, $flush_type]) >
14567 =item B<$status = $d-E<gt>deflateParams([OPT])>
14569 B<-Level>, B<-Strategy>, B<-BufSize>
14571 =item B<$status = $d-E<gt>deflateTune($good_length, $max_lazy,
14572 $nice_length, $max_chain)>
14574 =item B<$d-E<gt>dict_adler()>
14576 =item B<$d-E<gt>crc32()>
14578 =item B<$d-E<gt>adler32()>
14580 =item B<$d-E<gt>msg()>
14582 =item B<$d-E<gt>total_in()>
14584 =item B<$d-E<gt>total_out()>
14586 =item B<$d-E<gt>get_Strategy()>
14588 =item B<$d-E<gt>get_Level()>
14590 =item B<$d-E<gt>get_BufSize()>
14596 =item Compress::Raw::Zlib::Inflate
14600 =item B< ($i, $status) = new Compress::Raw::Zlib::Inflate( [OPT] ) >
14602 B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>,
14603 B<-ADLER32>, B<-ConsumeInput>
14605 =item B< $status = $i-E<gt>inflate($input, $output [,$eof]) >
14607 =item B<$status = $i-E<gt>inflateSync($input)>
14609 =item B<$i-E<gt>dict_adler()>
14611 =item B<$i-E<gt>crc32()>
14613 =item B<$i-E<gt>adler32()>
14615 =item B<$i-E<gt>msg()>
14617 =item B<$i-E<gt>total_in()>
14619 =item B<$i-E<gt>total_out()>
14621 =item B<$d-E<gt>get_BufSize()>
14627 =item CHECKSUM FUNCTIONS
14629 =item ACCESSING ZIP FILES
14637 =item MODIFICATION HISTORY
14639 =item COPYRIGHT AND LICENSE
14643 =head2 Compress::Raw::Zlib::Compress::Raw::Zlib, Compress::Raw::Zlib -
14644 Low-Level Interface to zlib compression library
14652 =item Compress::Raw::Zlib::Deflate
14656 =item B<($d, $status) = new Compress::Raw::Zlib::Deflate( [OPT] ) >
14658 B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>,
14659 B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32>
14661 =item B<$status = $d-E<gt>deflate($input, $output)>
14663 =item B<$status = $d-E<gt>flush($output [, $flush_type]) >
14665 =item B<$status = $d-E<gt>deflateParams([OPT])>
14667 B<-Level>, B<-Strategy>, B<-BufSize>
14669 =item B<$status = $d-E<gt>deflateTune($good_length, $max_lazy,
14670 $nice_length, $max_chain)>
14672 =item B<$d-E<gt>dict_adler()>
14674 =item B<$d-E<gt>crc32()>
14676 =item B<$d-E<gt>adler32()>
14678 =item B<$d-E<gt>msg()>
14680 =item B<$d-E<gt>total_in()>
14682 =item B<$d-E<gt>total_out()>
14684 =item B<$d-E<gt>get_Strategy()>
14686 =item B<$d-E<gt>get_Level()>
14688 =item B<$d-E<gt>get_BufSize()>
14694 =item Compress::Raw::Zlib::Inflate
14698 =item B< ($i, $status) = new Compress::Raw::Zlib::Inflate( [OPT] ) >
14700 B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>,
14701 B<-ADLER32>, B<-ConsumeInput>
14703 =item B< $status = $i-E<gt>inflate($input, $output [,$eof]) >
14705 =item B<$status = $i-E<gt>inflateSync($input)>
14707 =item B<$i-E<gt>dict_adler()>
14709 =item B<$i-E<gt>crc32()>
14711 =item B<$i-E<gt>adler32()>
14713 =item B<$i-E<gt>msg()>
14715 =item B<$i-E<gt>total_in()>
14717 =item B<$i-E<gt>total_out()>
14719 =item B<$d-E<gt>get_BufSize()>
14725 =item CHECKSUM FUNCTIONS
14727 =item ACCESSING ZIP FILES
14735 =item MODIFICATION HISTORY
14737 =item COPYRIGHT AND LICENSE
14741 =head2 Compress::Zlib - Interface to zlib compression library
14751 =item Notes for users of Compress::Zlib version 1
14755 =item GZIP INTERFACE
14757 B<$gz = gzopen($filename, $mode)>, B<$gz = gzopen($filehandle, $mode)>,
14758 B<$bytesread = $gz-E<gt>gzread($buffer [, $size]) ;>, B<$bytesread =
14759 $gz-E<gt>gzreadline($line) ;>, B<$byteswritten = $gz-E<gt>gzwrite($buffer)
14760 ;>, B<$status = $gz-E<gt>gzflush($flush_type) ;>, B<$offset =
14761 $gz-E<gt>gztell() ;>, B<$status = $gz-E<gt>gzseek($offset, $whence) ;>,
14762 B<$gz-E<gt>gzclose>, B<$gz-E<gt>gzsetparams($level, $strategy>, B<$level>,
14763 B<$strategy>, B<$gz-E<gt>gzerror>, B<$gzerrno>
14769 =item Compress::Zlib::memGzip
14771 =item Compress::Zlib::memGunzip
14775 =item COMPRESS/UNCOMPRESS
14777 B<$dest = compress($source [, $level] ) ;>, B<$dest = uncompress($source)
14780 =item Deflate Interface
14784 =item B<($d, $status) = deflateInit( [OPT] )>
14786 B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>,
14787 B<-Dictionary>, B<-Bufsize>
14789 =item B<($out, $status) = $d-E<gt>deflate($buffer)>
14791 =item B<($out, $status) = $d-E<gt>flush([flush_type])>
14793 =item B<$status = $d-E<gt>deflateParams([OPT])>
14795 B<-Level>, B<-Strategy>
14797 =item B<$d-E<gt>dict_adler()>
14799 =item B<$d-E<gt>msg()>
14801 =item B<$d-E<gt>total_in()>
14803 =item B<$d-E<gt>total_out()>
14809 =item Inflate Interface
14813 =item B<($i, $status) = inflateInit()>
14815 B<-WindowBits>, B<-Bufsize>, B<-Dictionary>
14817 =item B<($out, $status) = $i-E<gt>inflate($buffer)>
14819 =item B<$status = $i-E<gt>inflateSync($buffer)>
14821 =item B<$i-E<gt>dict_adler()>
14823 =item B<$i-E<gt>msg()>
14825 =item B<$i-E<gt>total_in()>
14827 =item B<$i-E<gt>total_out()>
14833 =item CHECKSUM FUNCTIONS
14835 =item ACCESSING ZIP FILES
14843 =item MODIFICATION HISTORY
14845 =item COPYRIGHT AND LICENSE
14849 =head2 Compress::Zlib::Compress::Zlib, Compress::Zlib - Interface to zlib
14850 compression library
14860 =item Notes for users of Compress::Zlib version 1
14864 =item GZIP INTERFACE
14866 B<$gz = gzopen($filename, $mode)>, B<$gz = gzopen($filehandle, $mode)>,
14867 B<$bytesread = $gz-E<gt>gzread($buffer [, $size]) ;>, B<$bytesread =
14868 $gz-E<gt>gzreadline($line) ;>, B<$byteswritten = $gz-E<gt>gzwrite($buffer)
14869 ;>, B<$status = $gz-E<gt>gzflush($flush_type) ;>, B<$offset =
14870 $gz-E<gt>gztell() ;>, B<$status = $gz-E<gt>gzseek($offset, $whence) ;>,
14871 B<$gz-E<gt>gzclose>, B<$gz-E<gt>gzsetparams($level, $strategy>, B<$level>,
14872 B<$strategy>, B<$gz-E<gt>gzerror>, B<$gzerrno>
14878 =item Compress::Zlib::memGzip
14880 =item Compress::Zlib::memGunzip
14884 =item COMPRESS/UNCOMPRESS
14886 B<$dest = compress($source [, $level] ) ;>, B<$dest = uncompress($source)
14889 =item Deflate Interface
14893 =item B<($d, $status) = deflateInit( [OPT] )>
14895 B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>,
14896 B<-Dictionary>, B<-Bufsize>
14898 =item B<($out, $status) = $d-E<gt>deflate($buffer)>
14900 =item B<($out, $status) = $d-E<gt>flush([flush_type])>
14902 =item B<$status = $d-E<gt>deflateParams([OPT])>
14904 B<-Level>, B<-Strategy>
14906 =item B<$d-E<gt>dict_adler()>
14908 =item B<$d-E<gt>msg()>
14910 =item B<$d-E<gt>total_in()>
14912 =item B<$d-E<gt>total_out()>
14918 =item Inflate Interface
14922 =item B<($i, $status) = inflateInit()>
14924 B<-WindowBits>, B<-Bufsize>, B<-Dictionary>
14926 =item B<($out, $status) = $i-E<gt>inflate($buffer)>
14928 =item B<$status = $i-E<gt>inflateSync($buffer)>
14930 =item B<$i-E<gt>dict_adler()>
14932 =item B<$i-E<gt>msg()>
14934 =item B<$i-E<gt>total_in()>
14936 =item B<$i-E<gt>total_out()>
14942 =item CHECKSUM FUNCTIONS
14944 =item ACCESSING ZIP FILES
14952 =item MODIFICATION HISTORY
14954 =item COPYRIGHT AND LICENSE
14958 =head2 Config - access Perl configuration information
14966 myconfig(), config_sh(), config_re($regex), config_vars(@names)
14978 C<_a>, C<_exe>, C<_o>
14982 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
14983 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
14984 C<ar>, C<archlib>, C<archlibexp>, C<archname>, C<archname64>, C<archobjs>,
14985 C<asctime_r_proto>, C<awk>
14989 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
14993 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
14994 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
14995 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
14996 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
14997 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
14998 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
14999 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
15003 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>,
15004 C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>,
15005 C<d_attribute_format>, C<d_attribute_malloc>, C<d_attribute_nonnull>,
15006 C<d_attribute_noreturn>, C<d_attribute_pure>, C<d_attribute_unused>,
15007 C<d_attribute_warn_unused_result>, C<d_bcmp>, C<d_bcopy>, C<d_bsd>,
15008 C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_builtin_choose_expr>,
15009 C<d_builtin_expect>, C<d_bzero>, C<d_casti32>, C<d_castneg>, C<d_charvspr>,
15010 C<d_chown>, C<d_chroot>, C<d_chsize>, C<d_class>, C<d_clearenv>,
15011 C<d_closedir>, C<d_cmsghdr_s>, C<d_const>, C<d_copysignl>, C<d_crypt>,
15012 C<d_crypt_r>, C<d_csh>, C<d_ctermid_r>, C<d_ctime_r>,
15013 C<d_c99_variadic_macros>, C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>,
15014 C<d_difftime>, C<d_dirfd>, C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>,
15015 C<d_dlsymun>, C<d_dosuid>, C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>,
15016 C<d_eaccess>, C<d_endgrent>, C<d_endgrent_r>, C<d_endhent>,
15017 C<d_endhostent_r>, C<d_endnent>, C<d_endnetent_r>, C<d_endpent>,
15018 C<d_endprotoent_r>, C<d_endpwent>, C<d_endpwent_r>, C<d_endsent>,
15019 C<d_endservent_r>, C<d_eofnblk>, C<d_eunice>, C<d_faststdio>, C<d_fchdir>,
15020 C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>,
15021 C<d_fd_set>, C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>,
15022 C<d_flexfnam>, C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>,
15023 C<d_fpathconf>, C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>,
15024 C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>,
15025 C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>, C<d_ftime>,
15026 C<d_futimes>, C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>,
15027 C<d_getgrent>, C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>,
15028 C<d_getgrps>, C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>,
15029 C<d_gethname>, C<d_gethostbyaddr_r>, C<d_gethostbyname_r>,
15030 C<d_gethostent_r>, C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>,
15031 C<d_getlogin_r>, C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>,
15032 C<d_getnbyname>, C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>,
15033 C<d_getnetent_r>, C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>,
15034 C<d_getpbynumber>, C<d_getpent>, C<d_getpgid>, C<d_getpgrp>, C<d_getpgrp2>,
15035 C<d_getppid>, C<d_getprior>, C<d_getprotobyname_r>,
15036 C<d_getprotobynumber_r>, C<d_getprotoent_r>, C<d_getprotoprotos>,
15037 C<d_getprpwnam>, C<d_getpwent>, C<d_getpwent_r>, C<d_getpwnam_r>,
15038 C<d_getpwuid_r>, C<d_getsbyname>, C<d_getsbyport>, C<d_getsent>,
15039 C<d_getservbyname_r>, C<d_getservbyport_r>, C<d_getservent_r>,
15040 C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>, C<d_gettimeod>,
15041 C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>, C<d_htonl>,
15042 C<d_ilogbl>, C<d_inc_version_list>, C<d_index>, C<d_inetaton>,
15043 C<d_int64_t>, C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>,
15044 C<d_isnanl>, C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>,
15045 C<d_libm_lib_version>, C<d_link>, C<d_localtime_r>, C<d_locconv>,
15046 C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>, C<d_lstat>,
15047 C<d_madvise>, C<d_malloc_good_size>, C<d_malloc_size>, C<d_mblen>,
15048 C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>, C<d_memcpy>,
15049 C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>,
15050 C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>, C<d_modfl>,
15051 C<d_modfl_pow32_bug>, C<d_modflproto>, C<d_mprotect>, C<d_msg>,
15052 C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>,
15053 C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>,
15054 C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>,
15055 C<d_nl_langinfo>, C<d_nv_preserves_uv>, C<d_nv_zero_is_allbits_zero>,
15056 C<d_off64_t>, C<d_old_pthread_create_joinable>, C<d_oldpthreads>,
15057 C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>,
15058 C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>,
15059 C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>,
15060 C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>,
15061 C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>,
15062 C<d_pthread_atfork>, C<d_pthread_attr_setscope>, C<d_pthread_yield>,
15063 C<d_pwage>, C<d_pwchange>, C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>,
15064 C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>, C<d_qgcvt>, C<d_quad>,
15065 C<d_random_r>, C<d_readdir>, C<d_readdir64_r>, C<d_readdir_r>,
15066 C<d_readlink>, C<d_readv>, C<d_recvmsg>, C<d_rename>, C<d_rewinddir>,
15067 C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>, C<d_sbrkproto>,
15068 C<d_scalbnl>, C<d_sched_yield>, C<d_scm_rights>, C<d_SCNfldbl>,
15069 C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>, C<d_semctl_semid_ds>,
15070 C<d_semctl_semun>, C<d_semget>, C<d_semop>, C<d_sendmsg>, C<d_setegid>,
15071 C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>,
15072 C<d_sethostent_r>, C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>,
15073 C<d_setlocale_r>, C<d_setnent>, C<d_setnetent_r>, C<d_setpent>,
15074 C<d_setpgid>, C<d_setpgrp>, C<d_setpgrp2>, C<d_setprior>,
15075 C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>, C<d_setpwent_r>,
15076 C<d_setregid>, C<d_setresgid>, C<d_setresuid>, C<d_setreuid>, C<d_setrgid>,
15077 C<d_setruid>, C<d_setsent>, C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>,
15078 C<d_sfio>, C<d_shm>, C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>,
15079 C<d_shmdt>, C<d_shmget>, C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>,
15080 C<d_sitearch>, C<d_snprintf>, C<d_sockatmark>, C<d_sockatmarkproto>,
15081 C<d_socket>, C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>,
15082 C<d_sprintf_returns_strlen>, C<d_sqrtl>, C<d_srand48_r>, C<d_srandom_r>,
15083 C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>,
15084 C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
15085 C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>,
15086 C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>,
15087 C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strerror_r>,
15088 C<d_strftime>, C<d_strlcat>, C<d_strlcpy>, C<d_strtod>, C<d_strtol>,
15089 C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>,
15090 C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>,
15091 C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
15092 C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
15093 C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>,
15094 C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>,
15095 C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
15096 C<d_unordered>, C<d_unsetenv>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>,
15097 C<d_vendorarch>, C<d_vendorbin>, C<d_vendorlib>, C<d_vendorscript>,
15098 C<d_vfork>, C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>, C<d_volatile>,
15099 C<d_vprintf>, C<d_vsnprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>,
15100 C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>,
15101 C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
15102 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
15103 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
15107 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
15108 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
15109 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
15110 C<expr>, C<extensions>, C<extras>
15114 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
15115 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
15120 C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>,
15121 C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>,
15122 C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>,
15123 C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>,
15124 C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>,
15125 C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>,
15126 C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>,
15127 C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>,
15128 C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>,
15129 C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
15133 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>,
15134 C<html3dir>, C<html3direxp>
15138 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
15139 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
15140 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
15141 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
15142 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
15143 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
15144 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
15145 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
15146 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
15147 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
15148 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
15149 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
15150 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
15151 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
15152 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
15153 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
15154 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
15155 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
15156 C<incpath>, C<inews>, C<initialinstalllocation>, C<installarchlib>,
15157 C<installbin>, C<installhtml1dir>, C<installhtml3dir>, C<installman1dir>,
15158 C<installman3dir>, C<installprefix>, C<installprefixexp>,
15159 C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>,
15160 C<installsitehtml1dir>, C<installsitehtml3dir>, C<installsitelib>,
15161 C<installsiteman1dir>, C<installsiteman3dir>, C<installsitescript>,
15162 C<installstyle>, C<installusrbinperl>, C<installvendorarch>,
15163 C<installvendorbin>, C<installvendorhtml1dir>, C<installvendorhtml3dir>,
15164 C<installvendorlib>, C<installvendorman1dir>, C<installvendorman3dir>,
15165 C<installvendorscript>, C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>,
15170 C<known_extensions>, C<ksh>
15174 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
15175 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
15176 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
15177 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
15178 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
15179 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
15184 C<mad>, C<madlyh>, C<madlyobj>, C<madlysrc>, C<mail>, C<mailx>, C<make>,
15185 C<make_set_make>, C<mallocobj>, C<mallocsrc>, C<malloctype>, C<man1dir>,
15186 C<man1direxp>, C<man1ext>, C<man3dir>, C<man3direxp>, C<man3ext>
15190 C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>,
15191 C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>,
15196 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
15197 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
15198 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
15199 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
15200 C<nvsize>, C<nvtype>
15204 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
15205 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
15209 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl>,
15214 C<PERL_API_REVISION>, C<PERL_API_SUBVERSION>, C<PERL_API_VERSION>,
15215 C<PERL_CONFIG_SH>, C<PERL_PATCHLEVEL>, C<perl_patchlevel>,
15216 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
15217 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
15218 C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>,
15219 C<procselfexe>, C<prototype>, C<ptrsize>
15223 C<quadkind>, C<quadtype>
15227 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
15228 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
15229 C<rmail>, C<run>, C<runnm>
15233 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
15234 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
15235 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
15236 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
15237 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
15238 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
15239 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
15240 C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>,
15241 C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>,
15242 C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>,
15243 C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>,
15244 C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>,
15245 C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>,
15246 C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>,
15247 C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>,
15248 C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>,
15249 C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>,
15250 C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>,
15251 C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>,
15252 C<submit>, C<subversion>, C<sysman>
15256 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
15257 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
15262 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
15263 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
15264 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
15265 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>,
15266 C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemallocwrap>,
15267 C<usemorebits>, C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>,
15268 C<useperlio>, C<useposix>, C<usereentrant>, C<userelocatableinc>,
15269 C<usesfio>, C<useshrplib>, C<usesitecustomize>, C<usesocks>, C<usethreads>,
15270 C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>,
15271 C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, C<uvXUformat>
15275 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
15276 C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>,
15277 C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>,
15278 C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>,
15279 C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>,
15280 C<vendorscriptexp>, C<version>, C<version_patchlevel_string>,
15281 C<versiononly>, C<vi>, C<voidflags>
15289 C<yacc>, C<yaccflags>
15307 dynamic, nonxs, static
15313 =head2 Cwd - get pathname of current working directory
15323 =item getcwd and friends
15325 getcwd, cwd, fastcwd, fastgetcwd, getdcwd
15327 =item abs_path and friends
15329 abs_path, realpath, fast_abs_path
15345 =head2 DB - programmatic interface to the Perl debugging API (draft,
15357 =item Global Variables
15359 $DB::sub, %DB::sub, $DB::single, $DB::signal, $DB::trace, @DB::args,
15360 @DB::dbline, %DB::dbline, $DB::package, $DB::filename, $DB::subname,
15365 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
15366 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
15368 =item Client Callback Methods
15370 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
15371 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
15372 CLIENT->output(LIST)
15382 =head2 DBM_Filter -- Filter DBM keys/values
15390 =item What is a DBM Filter?
15394 =item So what's new?
15402 =item $db->Filter_Push()
15404 =item $db->Filter_Key_Push()
15406 =item $db->Filter_Value_Push()
15408 Filter_Push, Filter_Key_Push, Filter_Value_Push
15410 =item $db->Filter_Pop()
15412 =item $db->Filtered()
15416 =item Writing a Filter
15420 =item Immediate Filters
15422 =item Canned Filters
15428 =item Filters Included
15430 utf8, encode, compress, int32, null
15436 =item Maintain Round Trip Integrity
15438 =item Don't mix filtered & non-filtered data in the same database file.
15450 =head2 DBM_Filter::compress - filter for DBM_Filter
15464 =head2 DBM_Filter::encode - filter for DBM_Filter
15478 =head2 DBM_Filter::int32 - filter for DBM_Filter
15492 =head2 DBM_Filter::null - filter for DBM_Filter
15506 =head2 DBM_Filter::utf8 - filter for DBM_Filter
15520 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
15528 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
15532 =item Using DB_File with Berkeley DB version 2 or greater
15534 =item Interface to Berkeley DB
15536 =item Opening a Berkeley DB Database File
15538 =item Default Parameters
15540 =item In Memory Databases
15548 =item A Simple Example
15556 =item Changing the BTREE sort order
15558 =item Handling Duplicate Keys
15560 =item The get_dup() Method
15562 =item The find_dup() Method
15564 =item The del_dup() Method
15566 =item Matching Partial Keys
15574 =item The 'bval' Option
15576 =item A Simple Example
15578 =item Extra RECNO Methods
15580 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
15581 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
15582 length, elements);>
15584 =item Another Example
15588 =item THE API INTERFACE
15590 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
15591 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
15592 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
15593 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
15597 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
15598 B<filter_fetch_value>
15604 =item An Example -- the NULL termination problem.
15606 =item Another Example -- Key is a C int.
15610 =item HINTS AND TIPS
15614 =item Locking: The Trouble with fd
15616 =item Safe ways to lock a database
15618 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
15620 =item Sharing Databases With C Applications
15622 =item The untie() Gotcha
15626 =item COMMON QUESTIONS
15630 =item Why is there Perl source in my database?
15632 =item How do I store complex data structures with DB_File?
15634 =item What does "Invalid Argument" mean?
15636 =item What does "Bareword 'DB_File' not allowed" mean?
15656 =head2 Data::Dumper - stringified perl data structures, suitable for both
15657 printing and C<eval>
15669 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump I<or>
15670 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
15671 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
15678 =item Configuration Variables or Methods
15704 =head2 Devel::Arena - Perl extension for inspecting the core's arena
15717 sv_stats [DONT_SHARE], shared_string_table, sizes, HEK_size STRING,
15718 shared_string_table_effectiveness, write_stats_at_END
15726 =item COPYRIGHT AND LICENSE
15730 =head2 Devel::DProf - a Perl code profiler
15738 =item PROFILE FORMAT
15750 =head2 Devel::PPPort - Perl/Pollution/Portability
15760 =item Why use ppport.h?
15762 =item How to use ppport.h
15764 =item Running ppport.h
15776 =item COMPATIBILITY
15780 =item Provided Perl compatibility API
15782 =item Perl API not supported by ppport.h
15784 perl 5.9.3, perl 5.9.2, perl 5.9.1, perl 5.9.0, perl 5.8.3, perl 5.8.1,
15785 perl 5.8.0, perl 5.7.3, perl 5.7.2, perl 5.7.1, perl 5.6.1, perl 5.6.0,
15786 perl 5.005_03, perl 5.005, perl 5.004_05, perl 5.004
15800 =head2 Devel::Peek - A data debugging tool for the XS programmer
15810 =item Runtime debugging
15812 =item Memory footprint debugging
15820 =item A simple scalar string
15822 =item A simple scalar number
15824 =item A simple scalar with an extra reference
15826 =item A reference to a simple scalar
15828 =item A reference to an array
15830 =item A reference to a hash
15832 =item Dumping a large array or hash
15834 =item A reference to an SV which holds a C pointer
15836 =item A reference to a subroutine
15850 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
15860 =head2 Devel::Size - Perl extension for finding the memory usage of Perl
15875 =item total_size($ref)
15881 =item UNDERSTANDING MEMORY ALLOCATION
15885 =item The C library
15893 =item Messages: texts originating from this module.
15913 =head2 Digest - Modules that calculate message digests
15921 I<binary>, I<hex>, I<base64>
15925 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
15926 Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset,
15927 $ctx->add( $data ), $ctx->add( $chunk1, $chunk2, ... ), $ctx->addfile(
15928 $io_handle ), $ctx->add_bits( $data, $nbits ), $ctx->add_bits( $bitstring
15929 ), $ctx->digest, $ctx->hexdigest, $ctx->b64digest
15939 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
15949 md5($data,...), md5_hex($data,...), md5_base64($data,...)
15953 $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...),
15954 $md5->addfile($io_handle), $md5->add_bits($data, $nbits),
15955 $md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest
15967 =head2 Digest::SHA - Perl extension for SHA-1/224/256/384/512
15971 =item SYNOPSIS (SHA)
15973 =item SYNOPSIS (HMAC-SHA)
15979 =item NIST STATEMENT ON SHA-1
15983 =item EXPORTABLE FUNCTIONS
15985 B<sha1($data, ...)>, B<sha224($data, ...)>, B<sha256($data, ...)>,
15986 B<sha384($data, ...)>, B<sha512($data, ...)>, B<sha1_hex($data, ...)>,
15987 B<sha224_hex($data, ...)>, B<sha256_hex($data, ...)>, B<sha384_hex($data,
15988 ...)>, B<sha512_hex($data, ...)>, B<sha1_base64($data, ...)>,
15989 B<sha224_base64($data, ...)>, B<sha256_base64($data, ...)>,
15990 B<sha384_base64($data, ...)>, B<sha512_base64($data, ...)>, B<new($alg)>,
15991 B<reset($alg)>, B<hashsize>, B<algorithm>, B<clone>, B<add($data, ...)>,
15992 B<add_bits($data, $nbits)>, B<add_bits($bits)>, B<addfile(*FILE)>,
15993 B<dump($filename)>, B<load($filename)>, B<digest>, B<hexdigest>,
15994 B<b64digest>, B<hmac_sha1($data, $key)>, B<hmac_sha224($data, $key)>,
15995 B<hmac_sha256($data, $key)>, B<hmac_sha384($data, $key)>,
15996 B<hmac_sha512($data, $key)>, B<hmac_sha1_hex($data, $key)>,
15997 B<hmac_sha224_hex($data, $key)>, B<hmac_sha256_hex($data, $key)>,
15998 B<hmac_sha384_hex($data, $key)>, B<hmac_sha512_hex($data, $key)>,
15999 B<hmac_sha1_base64($data, $key)>, B<hmac_sha224_base64($data, $key)>,
16000 B<hmac_sha256_base64($data, $key)>, B<hmac_sha384_base64($data, $key)>,
16001 B<hmac_sha512_base64($data, $key)>
16007 =item ACKNOWLEDGMENTS
16009 =item COPYRIGHT AND LICENSE
16013 =head2 Digest::base - Digest base class
16025 =head2 Digest::file - Calculate digests of files
16033 digest_file( $file, $algorithm, [$arg,...] ), digest_file_hex( $file,
16034 $algorithm, [$arg,...] ), digest_file_base64( $file, $algorithm, [$arg,...]
16041 =head2 DirHandle - supply object methods for directory handles
16053 =head2 Dumpvalue - provides screen dump of Perl data.
16065 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
16066 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
16067 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
16072 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
16073 compactDump, veryCompact, set, get
16079 =head2 DynaLoader - Dynamically load C libraries into Perl code
16087 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
16088 @dl_modules, @dl_shared_objects, dl_error(), $dl_debug, dl_findfile(),
16089 dl_expandspec(), dl_load_file(), dl_unload_file(), dl_load_flags(),
16090 dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(),
16091 dl_install_xsub(), bootstrap()
16097 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
16110 =item Migration from C<DynaLoader>
16112 =item Backward compatible boilerplate
16116 =item Order of initialization: early load()
16120 =item The most hairy case
16126 Can't find '%s' symbol in %s, Can't load '%s' for module %s: %s, Undefined
16127 symbols present after loading %s: %s, XSLoader::load('Your::Module',
16128 $Your::Module::VERSION)
16142 =head2 Encode - character encodings
16150 =item Table of Contents
16162 =item PERL ENCODING API
16164 $octets = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
16165 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
16166 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
16171 =item Listing available encodings
16173 =item Defining Aliases
16177 =item Encoding via PerlIO
16179 =item Handling Malformed Data
16181 B<NOTE:> Not all encoding support this feature, I<CHECK> =
16182 Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1), I<CHECK> =
16183 Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode (I<CHECK> =
16184 Encode::FB_PERLQQ), HTML charref mode (I<CHECK> = Encode::FB_HTMLCREF), XML
16185 charref mode (I<CHECK> = Encode::FB_XMLCREF), The bitmask
16189 =item coderef for CHECK
16193 =item Defining Encodings
16195 =item The UTF-8 flag
16197 Goal #1:, Goal #2:, Goal #3:, Goal #4:
16201 =item Messing with Perl's Internals
16203 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
16207 =item UTF-8 vs. utf8
16217 =head2 Encode::Alias - alias definitions to encodings
16225 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
16230 =item Alias overloading
16238 =head2 Encode::Byte - Single Byte Encodings
16252 =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
16254 =head2 Encode::CN - China-based Chinese Encodings
16270 =head2 Encode::CN::HZ -- internally used by Encode::CN
16272 =head2 Encode::Config -- internally used by Encode
16274 =head2 Encode::EBCDIC - EBCDIC Encodings
16288 =head2 Encode::Encoding - Encode Implementation Base Class
16298 =item Methods you should implement
16300 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
16301 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
16303 =item Other methods defined in Encode::Encodings
16305 -E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(),
16306 -E<gt>needs_lines()
16308 =item Example: Encode::ROT13
16312 =item Why the heck Encode API is different?
16316 =item Compiled Encodings
16322 Scheme 1, Scheme 2, Other Schemes
16326 =head2 Encode::Guess -- Guesses encoding from data
16336 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
16337 Encode::decode("Guess" ...), Encode::Guess->guess($data),
16338 guess_encoding($data, [, I<list of suspects>])
16348 =head2 Encode::JP - Japanese Encodings
16358 =item Note on ISO-2022-JP(-1)?
16366 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
16368 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
16370 =head2 Encode::KR - Korean Encodings
16384 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
16386 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
16402 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
16408 =item How does it work?
16410 =item Line Buffering
16414 =item How can I tell whether my encoding fully supports PerlIO ?
16422 =head2 Encode::Supported -- Encodings supported by Encode
16430 =item Encoding Names
16434 =item Supported Encodings
16438 =item Built-in Encodings
16440 =item Encode::Unicode -- other Unicode encodings
16442 =item Encode::Byte -- Extended ASCII
16444 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
16445 the Cyrillic world, gsm0338 - Hentai Latin 1
16447 =item CJK: Chinese, Japanese, Korean (Multibyte)
16449 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
16450 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
16451 Encode::JIS2K -- JIS X 0213 encodings via CPAN
16453 =item Miscellaneous encodings
16455 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
16459 =item Unsupported encodings
16461 ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
16462 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
16463 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
16464 Various Mac encodings, (Mac) Indic encodings
16466 =item Encoding vs. Charset -- terminology
16468 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
16472 =item Microsoft-related naming mess
16474 KS_C_5601-1987, GB2312, Big5, Shift_JIS
16480 character repertoire, coded character set (CCS), character encoding scheme
16481 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
16488 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
16489 RFC, UC, Unicode Glossary
16493 =item Other Notable Sites
16495 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
16496 "Introduction to i18n"
16498 =item Offline sources
16500 C<CJKV Information Processing> by Ken Lunde
16506 =head2 Encode::Symbol - Symbol Encodings
16520 =head2 Encode::TW - Taiwan-based Chinese Encodings
16536 =head2 Encode::Unicode -- Various Unicode Transformation Formats
16544 L<http://www.unicode.org/glossary/> says:, Quick Reference
16546 =item Size, Endianness, and BOM
16552 =item by endianness
16554 BOM as integer when fetched in network byte order
16558 =item Surrogate Pairs
16560 =item Error Checking
16566 =head2 Encode::Unicode::UTF7 -- UTF-7 encoding
16580 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
16589 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
16594 =item Alias overloading
16602 =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm --
16603 Internally used by Encode::??::ISO_2022_*
16605 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
16608 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
16611 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
16612 Implementation Base Class
16622 =item Methods you should implement
16624 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
16625 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
16627 =item Other methods defined in Encode::Encodings
16629 -E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(),
16630 -E<gt>needs_lines()
16632 =item Example: Encode::ROT13
16636 =item Why the heck Encode API is different?
16640 =item Compiled Encodings
16646 Scheme 1, Scheme 2, Other Schemes
16650 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
16661 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
16662 Encode::decode("Guess" ...), Encode::Guess->guess($data),
16663 guess_encoding($data, [, I<list of suspects>])
16673 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
16674 Encode::JP::2022_JP*
16676 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
16679 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
16682 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
16683 and 'Q' header encoding
16699 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
16700 on Encode and PerlIO
16706 =item How does it work?
16708 =item Line Buffering
16712 =item How can I tell whether my encoding fully supports PerlIO ?
16720 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
16721 supported by Encode
16729 =item Encoding Names
16733 =item Supported Encodings
16737 =item Built-in Encodings
16739 =item Encode::Unicode -- other Unicode encodings
16741 =item Encode::Byte -- Extended ASCII
16743 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
16744 the Cyrillic world, gsm0338 - Hentai Latin 1
16746 =item CJK: Chinese, Japanese, Korean (Multibyte)
16748 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
16749 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
16750 Encode::JIS2K -- JIS X 0213 encodings via CPAN
16752 =item Miscellaneous encodings
16754 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
16758 =item Unsupported encodings
16760 ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
16761 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
16762 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
16763 Various Mac encodings, (Mac) Indic encodings
16765 =item Encoding vs. Charset -- terminology
16767 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
16771 =item Microsoft-related naming mess
16773 KS_C_5601-1987, GB2312, Big5, Shift_JIS
16779 character repertoire, coded character set (CCS), character encoding scheme
16780 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
16787 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
16788 RFC, UC, Unicode Glossary
16792 =item Other Notable Sites
16794 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
16795 "Introduction to i18n"
16797 =item Offline sources
16799 C<CJKV Information Processing> by Ken Lunde
16805 =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7
16820 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
16832 =item Predefined Methods
16834 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
16835 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
16836 $e-E<gt>bytes([$encoding])
16838 =item Example: base64 transcoder
16840 =item Operator Overloading
16848 =head2 Encodencoding, encoding - allows you to write your script in
16849 non-ascii or non-utf8
16859 =item Literal Conversions
16861 =item PerlIO layers for C<STD(IN|OUT)>
16863 =item Implicit upgrading for byte strings
16867 =item FEATURES THAT REQUIRE 5.8.1
16869 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
16873 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
16874 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
16876 =item The Filter Option
16880 =item Filter-related changes at Encode version 1.87
16890 =item DO NOT MIX MULTIPLE ENCODINGS
16892 =item tr/// with ranges
16894 Legend of characters above
16898 =item EXAMPLE - Greekperl
16900 =item KNOWN PROBLEMS
16902 literals in regex that are longer than 127 bytes, EBCDIC, format
16906 =item The Logic of :locale
16916 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
16928 =item Predefined Methods
16930 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
16931 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
16932 $e-E<gt>bytes([$encoding])
16934 =item Example: base64 transcoder
16936 =item Operator Overloading
16944 =head2 English - use nice English (or awk) names for ugly punctuation
16957 =head2 Env - perl module that imports environment variables as scalars or
16972 =head2 Errno - System errno constants
16988 =head2 Exporter - Implements default import method for modules
16998 =item How to Export
17000 =item Selecting What To Export
17002 =item How to Import
17004 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
17008 =item Advanced features
17012 =item Specialised Import Lists
17014 =item Exporting without using Exporter's import method
17016 =item Exporting without inheriting from Exporter
17018 =item Module Version Checking
17020 =item Managing Unknown Symbols
17022 =item Tag Handling Utility Functions
17024 =item Generating combined tags
17026 =item C<AUTOLOAD>ed Constants
17032 =head2 Exporter::Heavy - Exporter guts
17042 =head2 ExtUtils::CBuilder - Compile and link C code for Perl modules
17052 new, have_compiler, compile, C<object_file>, C<include_dirs>,
17053 C<extra_compiler_flags>, link, lib_file, module_name, extra_linker_flags,
17054 link_executable, exe_file, object_file, lib_file, exe_file, prelink,
17055 need_prelink, extra_link_args_after_prelink
17069 =head2 ExtUtils::CBuilder::Platform::Windows - Builder class for Windows
17082 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
17123 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
17137 B<warn_if_old_packlist>
17139 B<perllocal_install>
17143 =head2 ExtUtils::Constant - generate XS code to import C header constants
17153 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
17161 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
17163 autoload PACKAGE, VERSION, AUTOLOADER
17165 WriteMakefileSnippet
17167 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
17168 BREAKOUT_AT, NAMES, C_FH, C_FILE, XS_FH, XS_FILE, SUBNAME, C_SUBNAME
17176 =head2 ExtUtils::Constant::Base - base class for ExtUtils::Constant objects
17190 memEQ_clause args_hashref
17192 dump_names arg_hashref, ITEM..
17194 assign arg_hashref, VALUE..
17196 return_clause arg_hashref, ITEM
17198 switch_clause arg_hashref, NAMELEN, ITEMHASH, ITEM..
17202 dogfood arg_hashref, ITEM..
17204 normalise_items args, default_type, seen_types, seen_items, ITEM..
17206 C_constant arg_hashref, ITEM.., name, type, value, macro, default, pre,
17207 post, def_pre, def_post, utf8, weight
17217 =head2 ExtUtils::Constant::Utils - helper functions for ExtUtils::Constant
17231 perl_stringify NAME
17239 =head2 ExtUtils::Constant::XS, ExtUtils::Constant::Base - base class for
17240 ExtUtils::Constant objects
17254 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
17266 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
17267 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
17277 =head2 ExtUtils::Install - install files from here to there
17285 _chmod($$;$), _warnonce(@), _choke(@)
17289 _move_file_at_boot( $file, $target, $moan )
17291 _unlink_or_rename( $file, $tryhard, $installing )
17305 _can_write_dir(C<$dir>)
17307 _mkpath($dir,$show,$mode,$verbose,$fake)
17309 _copy($from,$to,$verbose,$fake)
17315 install_rooted_file( $file ), install_rooted_dir( $dir )
17317 forceunlink( $file, $tryhard )
17319 directory_not_empty( $dir )
17321 B<install_default> I<DISCOURAGED>
17325 inc_uninstall($filepath,$libdir,$verbose,$nonono,$ignore)
17327 run_filter($cmd,$src,$dest)
17339 B<PERL_INSTALL_ROOT>, B<EU_INSTALL_IGNORE_SKIP>,
17340 B<EU_INSTALL_SITE_SKIPFILE>
17348 =head2 ExtUtils::Installed - Inventory management of installed modules
17360 new(), modules(), files(), directories(), directory_tree(), validate(),
17361 packlist(), version()
17369 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
17377 For static extensions, For dynamic extensions at build/link time, For
17378 dynamic extensions at load time
17384 =item LDLOADLIBS and LD_RUN_PATH
17394 =item VMS implementation
17396 =item Win32 implementation
17404 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
17414 =head2 ExtUtils::MM_AIX - AIX specific subclass of ExtUtils::MM_Unix
17424 =item Overridden methods
17438 =head2 ExtUtils::MM_Any - Platform-agnostic MM methods
17450 =item Cross-platform helper methods
17476 =item File::Spec wrappers
17492 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
17493 ExtUtils::MakeMaker
17507 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
17508 ExtUtils::MakeMaker
17522 replace_manpage_separator
17526 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
17536 =item Overridden methods
17544 B<replace_manpage_separator>
17554 =head2 ExtUtils::MM_MacOS - once produced Makefiles for MacOS Classic
17564 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
17565 ExtUtils::MakeMaker
17577 init_platform, platform_constants
17585 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
17586 ExtUtils::MakeMaker
17604 =head2 ExtUtils::MM_QNX - QNX specific subclass of ExtUtils::MM_Unix
17614 =item Overridden methods
17628 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
17638 =item Overridden methods
17646 B<replace_manpage_separator>
17656 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
17758 init_platform, platform_constants
17802 post_initialize (o)
17814 replace_manpage_separator
17838 test_via_harness (override)
17840 test_via_script (override)
17864 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
17865 ExtUtils::MakeMaker
17875 =item Methods always loaded
17887 guess_name (override)
17891 find_perl (override)
17893 maybe_command (override)
17897 pm_to_blib (override)
17899 perl_script (override)
17901 replace_manpage_separator
17907 init_main (override)
17909 init_others (override)
17911 init_platform (override)
17915 init_VERSION (override)
17917 constants (override)
17923 const_cccmd (override)
17925 tools_other (override)
17927 init_dist (override)
17937 dynamic_lib (override)
17939 static_lib (override)
17943 zipfile_target, tarfile_target, shdist_target
17947 perldepend (override)
17949 makeaperl (override)
17951 nicetext (override)
17953 prefixify (override)
17981 =head2 ExtUtils::MM_VOS - VOS specific subclass of ExtUtils::MM_Unix
17991 =item Overridden methods
18005 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
18006 ExtUtils::MakeMaker
18018 =item Overridden methods
18024 replace_manpage_separator
18032 init_platform, platform_constants
18058 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
18068 =item Overridden methods
18090 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
18100 =head2 ExtUtils::MakeMaker - Create a module Makefile
18110 =item How To Write A Makefile.PL
18112 =item Default Makefile Behaviour
18120 =item PREFIX and LIB attribute
18124 =item Static Linking of a new Perl Binary
18126 =item Determination of Perl Library and Installation Locations
18128 =item Which architecture dependent directory?
18130 =item Using Attributes and Parameters
18132 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
18133 CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS,
18134 EXCLUDE_EXT, EXE_FILES, EXTRA_META, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN,
18135 FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB,
18136 INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
18137 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB,
18138 INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLSITESCRIPT,
18139 INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB,
18140 INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INSTALLVENDORSCRIPT,
18141 INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT,
18142 LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS, LICENSE, LINKTYPE, MAKE,
18143 MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME,
18144 NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT, OPTIMIZE, PERL,
18145 PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLPREFIX,
18146 PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM, PMLIBDIRS,
18147 PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, PREFIX,
18148 PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT, PRINT_PREREQ, SITEPREFIX, SIGN,
18149 SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, VERSION_FROM, VERSION_SYM,
18150 XS, XSOPT, XSPROTOARG, XS_VERSION
18152 =item Additional lowercase attributes
18154 clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean,
18155 test, tool_autosplit
18157 =item Overriding MakeMaker Methods
18159 =item The End Of Cargo Cult Programming
18161 C<< MAN3PODS => ' ' >>
18163 =item Hintsfile support
18165 =item Distribution Support
18167 make distcheck, make skipcheck, make distclean, make manifest,
18168 make distdir, make disttest, make tardist, make dist, make
18169 uutardist, make shdist, make zipdist, make ci
18171 =item Module Meta-Data
18173 =item Disabling an extension
18175 =item Other Handy Functions
18183 PERL_MM_OPT, PERL_MM_USE_DEFAULT, PERL_CORE
18193 =head2 ExtUtils::MakeMaker::Config - Wrapper around Config.pm
18203 =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About
18212 =item Module Installation
18214 How do I keep from installing man pages?, How do I use a module without
18217 =item Philosophy and History
18219 Why not just use <insert other build config tool here>?, What is
18220 Module::Build and how does it relate to MakeMaker?, pure perl. no make, no
18221 shell commands, easier to customize, cleaner internals, less cruft
18223 =item Module Writing
18225 How do I keep my $VERSION up to date without resetting it manually?, What's
18226 this F<META.yml> thing and how did it get in my F<MANIFEST>?!
18230 How to I prevent "object version X.XX does not match bootstrap parameter
18231 Y.YY" errors?, How do I make two or more XS files coexist in the same
18244 =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker
18258 Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP,
18267 =head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm
18277 =head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm
18287 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
18325 =item MANIFEST.SKIP
18329 =item GLOBAL VARIABLES
18337 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
18338 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
18342 B<PERL_MM_MANIFEST_DEBUG>
18350 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
18362 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
18372 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
18381 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
18393 =head2 ExtUtils::Packlist - manage .packlist files
18405 new(), read(), write(), validate(), packlist_file()
18413 =head2 ExtUtils::ParseXS - converts Perl XS code into C code
18423 process_xs(), B<C++>, B<hiertype>, B<except>, B<typemap>, B<prototypes>,
18424 B<versioncheck>, B<linenumbers>, B<optimize>, B<inout>, B<argtypes>, B<s>,
18435 =head2 ExtUtils::testlib - add blib/* directories to @INC
18445 =head2 Fatal - replace functions with equivalents which succeed or die
18459 =head2 Fcntl - load the C Fcntl.h defines
18469 =item EXPORTED SYMBOLS
18473 =head2 File::Basename - Parse file paths into directory, filename and
18490 C<fileparse_set_fstype>
18498 =head2 File::CheckTree, validate - run many filetest checks on a tree
18512 =head2 File::Compare - Compare files or filehandles
18526 =head2 File::Copy - Copy files or filehandles
18536 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
18538 rmscopy($from,$to[,$date_flag])
18550 =head2 File::DosGlob - DOS like globbing and then some
18560 =item EXPORTS (by request only)
18572 =head2 File::Find - Traverse a directory tree.
18580 B<find>, B<finddepth>
18586 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
18587 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
18588 C<untaint>, C<untaint_pattern>, C<untaint_skip>
18590 =item The wanted function
18592 C<$File::Find::dir> is the current directory name,, C<$_> is the current
18593 filename within that directory, C<$File::Find::name> is the complete
18594 pathname to the file
18602 $dont_use_nlink, symlinks
18606 =item BUGS AND CAVEATS
18612 =head2 File::Glob - Perl extension for BSD glob routine
18622 =item META CHARACTERS
18626 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
18627 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
18628 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
18634 C<GLOB_NOSPACE>, C<GLOB_ABEND>
18644 =head2 File::GlobMapper - Extend File Glob to Allow Input and Output Files
18652 This code is a work in progress, There are known bugs, The interface
18653 defined here is tentative, There are portability issues, Do not use in
18654 production code, Consider yourself warned!
18658 =item Behind The Scenes
18662 =item Input File Glob
18664 B<~>, B<~user>, B<.>, B<*>, B<?>, B<\>, B<[]>, B<{,}>, B<()>
18666 =item Output File Glob
18670 =item Returned Data
18678 =item A Rename script
18680 =item A few example globmaps
18688 =item COPYRIGHT AND LICENSE
18692 =head2 File::Path - create or remove directory trees
18706 =head2 File::Spec - portably perform operations on file names
18716 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
18717 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
18718 splitdir, catpath(), abs2rel, rel2abs()
18728 =head2 File::Spec::Cygwin - methods for Cygwin file specs
18740 file_name_is_absolute
18750 =head2 File::Spec::Epoc - methods for Epoc file specs
18772 =head2 File::Spec::Functions - portably perform operations on file names
18792 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
18820 file_name_is_absolute
18844 =head2 File::Spec::OS2 - methods for OS/2 file specs
18858 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
18891 file_name_is_absolute
18915 =head2 File::Spec::VMS - methods for VMS file specs
18923 canonpath (override)
18941 case_tolerant (override)
18945 file_name_is_absolute (override)
18947 splitpath (override)
18949 splitdir (override)
18965 =head2 File::Spec::Win32 - methods for Win32 file specs
18991 =item Note For File::Spec::Win32 Maintainers
19003 =head2 File::Temp - return name and handle of a temporary file safely
19017 =item OBJECT-ORIENTED INTERFACE
19025 B<unlink_on_destroy>
19041 =item MKTEMP FUNCTIONS
19055 =item POSIX FUNCTIONS
19065 =item ADDITIONAL FUNCTIONS
19073 =item UTILITY FUNCTIONS
19087 =item PACKAGE VARIABLES
19089 B<safe_level>, STANDARD, MEDIUM, HIGH
19095 B<$KEEP_ALL>, B<$DEBUG>
19103 =item Temporary files and NFS
19119 =head2 File::stat - by-name interface to Perl's built-in stat() functions
19135 =head2 FileCache - keep more files open than the system permits
19143 cacheout EXPR, cacheout MODE, EXPR
19151 =head2 FileHandle - supply object methods for filehandles
19159 $fh->print, $fh->printf, $fh->getline, $fh->getlines
19165 =head2 Filter::Simple - Simplified source filtering
19179 =item Disabling or changing <no> behaviour
19181 =item All-in-one interface
19183 =item Filtering only specific components of source code
19185 C<"code">, C<"code_no_comments">, C<"executable">,
19186 C<"executable_no_comments">, C<"quotelike">, C<"string">, C<"regex">,
19189 =item Filtering only the code parts of source code
19191 Most source code ceases to be grammatically correct when it is broken up
19192 into the pieces between string literals and regexes. So the C<'code'>
19193 and C<'code_no_comments'> component filter behave slightly differently
19194 from the other partial filters described in the previous section.
19196 =item Using Filter::Simple with an explicit C<import> subroutine
19198 =item Using Filter::Simple and Exporter together
19210 =head2 Filter::Util::Call - Perl Source Filter Utility Module
19220 =item B<use Filter::Util::Call>
19224 =item B<filter() and anonymous sub>
19226 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
19234 =item Example 1: A simple filter.
19236 =item Example 2: Using the context
19238 =item Example 3: Using the context within the filter
19240 =item Example 4: Using filter_del
19244 =item Filter::Simple
19252 =head2 FindBin - Locate directory of original perl script
19260 =item EXPORTABLE VARIABLES
19272 =head2 GDBM_File - Perl5 access to the gdbm library.
19288 =head2 Getopt::Long - Extended processing of command line options
19296 =item Command Line Options, an Introduction
19298 =item Getting Started with Getopt::Long
19302 =item Simple options
19304 =item A little bit less simple options
19306 =item Mixing command line option with other arguments
19308 =item Options with values
19310 =item Options with multiple values
19312 =item Options with hash values
19314 =item User-defined subroutines to handle options
19316 =item Options with multiple names
19318 =item Case and abbreviations
19320 =item Summary of Option Specifications
19322 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
19327 =item Advanced Possibilities
19331 =item Object oriented interface
19333 =item Thread Safety
19335 =item Documentation and help texts
19337 =item Storing option values in a hash
19341 =item The lonesome dash
19343 =item Argument callback
19347 =item Configuring Getopt::Long
19349 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
19350 require_order, permute, bundling (default: disabled), bundling_override
19351 (default: disabled), ignore_case (default: enabled), ignore_case_always
19352 (default: disabled), auto_version (default:disabled), auto_help
19353 (default:disabled), pass_through (default: disabled), prefix,
19354 prefix_pattern, long_prefix_pattern, debug (default: disabled)
19356 =item Exportable Methods
19358 VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage
19360 =item Return values and Errors
19366 =item Default destinations
19368 =item Alternative option starters
19370 =item Configuration variables
19374 =item Trouble Shooting
19378 =item GetOptions does not return a false result when an option is not
19381 =item GetOptions does not split the command line correctly
19383 =item Undefined subroutine &main::GetOptions called
19385 =item How do I put a "-?" option into a Getopt::Long?
19391 =item COPYRIGHT AND DISCLAIMER
19395 =head2 Getopt::Std, getopt, getopts - Process single-character switches
19396 with switch clustering
19404 =item C<--help> and C<--version>
19408 =head2 Hash::Util - A selection of general-utility hash subroutines
19418 =item Restricted hashes
19420 B<lock_keys>, B<unlock_keys>
19428 B<lock_value>, B<unlock_value>
19430 B<lock_hash>, B<unlock_hash>
19432 B<lock_hash_recurse>, B<unlock_hash_recurse>
19436 b<legal_keys>, B<hidden_keys>, B<all_keys>, B<hash_seed>
19442 =item Operating on references to hashes.
19444 lock_ref_keys, unlock_ref_keys, lock_ref_keys_plus, lock_ref_value,
19445 unlock_ref_value, lock_hashref, unlock_hashref, lock_hashref_recurse,
19446 unlock_hashref_recurse, hash_ref_unlocked, legal_ref_keys, hidden_ref_keys
19462 =head2 Hash::Utilib::Hash::Util, Hash::Util - A selection of
19463 general-utility hash subroutines
19473 =item Restricted hashes
19475 B<lock_keys>, B<unlock_keys>
19483 B<lock_value>, B<unlock_value>
19485 B<lock_hash>, B<unlock_hash>
19487 B<lock_hash_recurse>, B<unlock_hash_recurse>
19491 b<legal_keys>, B<hidden_keys>, B<all_keys>, B<hash_seed>
19497 =item Operating on references to hashes.
19499 lock_ref_keys, unlock_ref_keys, lock_ref_keys_plus, lock_ref_value,
19500 unlock_ref_value, lock_hashref, unlock_hashref, lock_hashref_recurse,
19501 unlock_hashref_recurse, hash_ref_unlocked, legal_ref_keys, hidden_ref_keys
19517 =head2 I18N::Collate - compare 8-bit scalar data according to the current
19528 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
19539 the function is_language_tag($lang1)
19541 the function extract_language_tags($whatever)
19543 the function same_language_tag($lang1, $lang2)
19545 the function similarity_language_tag($lang1, $lang2)
19547 the function is_dialect_of($lang1, $lang2)
19549 the function super_languages($lang1)
19551 the function locale2language_tag($locale_identifier)
19553 the function encode_language_tag($lang1)
19555 the function alternate_language_tags($lang1)
19557 the function @langs = panic_languages(@accept_languages)
19559 the function implicate_supers( ...languages... ), the function
19560 implicate_supers_strictly( ...languages... )
19564 =item ABOUT LOWERCASING
19566 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
19576 =head2 I18N::LangTags::Detect - detect the user's language preferences
19596 =head2 I18N::LangTags::List -- tags and names for human languages
19604 =item ABOUT LANGUAGE TAGS
19606 =item LIST OF LANGUAGES
19608 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} :
19609 Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} :
19610 Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian,
19611 {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)],
19612 {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic,
19613 {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy}
19614 : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} :
19615 Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} :
19616 Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae}
19617 : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} :
19618 Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai}
19619 : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} :
19620 Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} :
19621 Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber
19622 (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini,
19623 {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} :
19624 Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} :
19625 Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian
19626 (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central
19627 American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages],
19628 {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb}
19629 : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} :
19630 Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} :
19631 Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree,
19632 {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf}
19633 : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based
19634 Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} :
19635 Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} :
19636 Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru)
19637 Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri,
19638 {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch,
19639 {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi}
19640 : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} :
19641 English, {enm} : Old English (1100-1500), {ang} : Old English
19642 (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} :
19643 Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat}
19644 : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} :
19645 Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French
19646 (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} :
19647 Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan,
19648 {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian,
19649 {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High
19650 German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon}
19651 : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient
19652 Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} :
19653 Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian,
19654 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
19655 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
19656 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo,
19657 {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European
19658 (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua
19659 (International Auxiliary Language Association), {ie} : Interlingue, {iu} :
19660 Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} :
19661 Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian
19662 languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} :
19663 Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle,
19664 {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} :
19665 Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar}
19666 : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh,
19667 {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese,
19668 {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz,
19669 {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} :
19670 Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama,
19671 {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} :
19672 Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} :
19673 Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} :
19674 Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban
19675 (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui}
19676 : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai,
19677 {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili,
19678 {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} :
19679 Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} :
19680 Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} :
19681 Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai,
19682 [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} :
19683 Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} :
19684 Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)],
19685 {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple
19686 languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan,
19687 {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele,
19688 {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
19689 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
19690 {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} :
19691 Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} :
19692 Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi}
19693 : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} :
19694 Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
19695 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
19696 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
19697 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
19698 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
19699 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
19700 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
19701 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
19702 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
19703 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
19704 languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} :
19705 Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami,
19706 [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} :
19707 Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak,
19708 {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian,
19709 {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign
19710 Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} :
19711 Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave
19712 (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian,
19713 {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} :
19714 Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} :
19715 South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} :
19716 Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati,
19717 {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} :
19718 Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao,
19719 {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} :
19720 Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} :
19721 Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau,
19722 {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian,
19723 {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} :
19724 Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh}
19725 : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} :
19726 Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian,
19727 {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} :
19728 Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak}
19729 : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was}
19730 : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private
19731 Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} :
19732 Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
19733 : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu,
19738 =item COPYRIGHT AND DISCLAIMER
19744 =head2 I18N::Langinfo - query locale information
19762 =item COPYRIGHT AND LICENSE
19766 =head2 IO - load various IO modules
19778 =head2 IO::Compress::Base - Base Class for IO::Compress modules
19790 =item MODIFICATION HISTORY
19792 =item COPYRIGHT AND LICENSE
19796 =head2 IO::Compress::Deflate - Write RFC 1950 files/buffers
19804 DO NOT use in production code, The documentation is incomplete in places,
19805 Parts of the interface defined here are tentative, Please report any
19808 =item Functional Interface
19812 =item deflate $input => $output [, OPTS]
19814 A filename, A filehandle, A scalar reference, An array reference, An Input
19815 FileGlob string, A filename, A filehandle, A scalar reference, An Array
19816 Reference, An Output FileGlob
19820 =item Optional Parameters
19822 AutoClose =E<gt> 0|1, BinModeIn =E<gt> 0|1, -Append =E<gt> 0|1
19834 A filename, A filehandle, A scalar reference
19836 =item Constructor Options
19838 AutoClose =E<gt> 0|1, Append =E<gt> 0|1, A Buffer, A Filename, A
19839 Filehandle, Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1
19871 =item input_line_number
19877 =item newStream([OPTS])
19881 =item deflateParams
19887 :all, :constants, :flush, :level, :strategy
19895 =item MODIFICATION HISTORY
19897 =item COPYRIGHT AND LICENSE
19901 =head2 IO::Compress::Gzip - Write RFC 1952 files/buffers
19909 DO NOT use in production code, The documentation is incomplete in places,
19910 Parts of the interface defined here are tentative, Please report any
19913 =item Functional Interface
19917 =item gzip $input => $output [, OPTS]
19919 A filename, A filehandle, A scalar reference, An array reference, An Input
19920 FileGlob string, A filename, A filehandle, A scalar reference, An Array
19921 Reference, An Output FileGlob
19925 =item Optional Parameters
19927 AutoClose =E<gt> 0|1, BinModeIn =E<gt> 0|1, -Append =E<gt> 0|1
19939 A filename, A filehandle, A scalar reference
19941 =item Constructor Options
19943 AutoClose =E<gt> 0|1, Append =E<gt> 0|1, A Buffer, A Filename, A
19944 Filehandle, Merge =E<gt> 0|1, -Level, -Strategy, -Minimal =E<gt> 0|1,
19945 -Comment =E<gt> $comment, -Name =E<gt> $string, -Time =E<gt> $number,
19946 -TextFlag =E<gt> 0|1, -HeaderCRC =E<gt> 0|1, -OS_Code =E<gt> $value,
19947 -ExtraField =E<gt> $data, -ExtraFlags =E<gt> $value, -Strict =E<gt> 0|1
19979 =item input_line_number
19985 =item newStream([OPTS])
19989 =item deflateParams
19995 :all, :constants, :flush, :level, :strategy
20003 =item MODIFICATION HISTORY
20005 =item COPYRIGHT AND LICENSE
20009 =head2 IO::Compress::RawDeflate - Write RFC 1951 files/buffers
20017 DO NOT use in production code, The documentation is incomplete in places,
20018 Parts of the interface defined here are tentative, Please report any
20021 =item Functional Interface
20025 =item rawdeflate $input => $output [, OPTS]
20027 A filename, A filehandle, A scalar reference, An array reference, An Input
20028 FileGlob string, A filename, A filehandle, A scalar reference, An Array
20029 Reference, An Output FileGlob
20033 =item Optional Parameters
20035 AutoClose =E<gt> 0|1, BinModeIn =E<gt> 0|1, -Append =E<gt> 0|1
20047 A filename, A filehandle, A scalar reference
20049 =item Constructor Options
20051 AutoClose =E<gt> 0|1, Append =E<gt> 0|1, A Buffer, A Filename, A
20052 Filehandle, Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1
20084 =item input_line_number
20090 =item newStream([OPTS])
20094 =item deflateParams
20100 :all, :constants, :flush, :level, :strategy
20108 =item MODIFICATION HISTORY
20110 =item COPYRIGHT AND LICENSE
20114 =head2 IO::Compress::Zip - Write zip files/buffers
20122 DO NOT use in production code, The documentation is incomplete in places,
20123 Parts of the interface defined here are tentative, Please report any
20126 =item Functional Interface
20130 =item zip $input => $output [, OPTS]
20132 A filename, A filehandle, A scalar reference, An array reference, An Input
20133 FileGlob string, A filename, A filehandle, A scalar reference, An Array
20134 Reference, An Output FileGlob
20138 =item Optional Parameters
20140 AutoClose =E<gt> 0|1, BinModeIn =E<gt> 0|1, -Append =E<gt> 0|1
20152 A filename, A filehandle, A scalar reference
20154 =item Constructor Options
20156 AutoClose =E<gt> 0|1, Append =E<gt> 0|1, A Buffer, A Filename, A
20157 Filehandle, -Name =E<gt> $string, -Time =E<gt> $number, -exTime =E<gt>
20158 [$atime, $mtime, $ctime], -Comment =E<gt> $comment, -ZipComment =E<gt>
20159 $comment, Method =E<gt> $method, Stream =E<gt> 0|1, -TextFlag =E<gt> 0|1,
20160 ExtraFieldLocal =E<gt> $data =item ExtraFieldCentral =E<gt> $data, Minimal
20161 =E<gt> 1|0, BlockSize100K =E<gt> number, WorkFactor =E<gt> number, -Level,
20162 -Strategy, -Strict =E<gt> 0|1
20194 =item input_line_number
20200 =item newStream([OPTS])
20204 =item deflateParams
20210 :all, :constants, :flush, :level, :strategy, :zip_method
20218 =item MODIFICATION HISTORY
20220 =item COPYRIGHT AND LICENSE
20224 =head2 IO::Dir - supply object methods for directory handles
20232 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
20233 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
20243 =head2 IO::File - supply object methods for filehandles
20253 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
20257 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode(
20268 =head2 IO::Handle - supply object methods for I/O handles
20278 new (), new_from_fd ( FD, MODE )
20282 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
20283 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
20284 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
20285 $io->blocking ( [ BOOL ] ), $io->untaint
20297 =head2 IO::Pipe - supply object methods for pipes
20307 new ( [READER, WRITER] )
20311 reader ([ARGS]), writer ([ARGS]), handles ()
20321 =head2 IO::Poll - Object interface to system poll call
20331 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
20332 IO ), handles( [ EVENT_MASK ] )
20342 =head2 IO::Seekable - supply seek based methods for I/O objects
20350 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
20351 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
20360 =head2 IO::Select - OO interface to the select system call
20370 new ( [ HANDLES ] )
20374 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
20375 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
20376 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
20386 =head2 IO::Socket - Object interface to socket communications
20400 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
20401 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
20411 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
20427 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
20440 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
20454 hostpath(), peerpath()
20464 =head2 IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip)
20473 DO NOT use in production code, The documentation is incomplete in places,
20474 Parts of the interface defined here are tentative, Please report any
20475 problems you find, RFC 1950, RFC 1951, gzip (RFC 1952), zip
20477 =item Functional Interface
20481 =item anyinflate $input => $output [, OPTS]
20483 A filename, A filehandle, A scalar reference, An array reference, An Input
20484 FileGlob string, A filename, A filehandle, A scalar reference, An Array
20485 Reference, An Output FileGlob
20489 =item Optional Parameters
20491 AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1,
20492 -MultiStream =E<gt> 0|1
20504 A filename, A filehandle, A scalar reference
20506 =item Constructor Options
20508 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
20509 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
20510 -Append =E<gt> 0|1, -Strict =E<gt> 0|1, -ParseExtra =E<gt> 0|1
20532 =item getHeaderInfo
20546 =item input_line_number
20564 =item MODIFICATION HISTORY
20566 =item COPYRIGHT AND LICENSE
20570 =head2 IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop
20579 DO NOT use in production code, The documentation is incomplete in places,
20580 Parts of the interface defined here are tentative, Please report any
20581 problems you find, RFC 1950, RFC 1951, gzip (RFC 1952), zip, bzip2, lzop
20583 =item Functional Interface
20587 =item anyuncompress $input => $output [, OPTS]
20589 A filename, A filehandle, A scalar reference, An array reference, An Input
20590 FileGlob string, A filename, A filehandle, A scalar reference, An Array
20591 Reference, An Output FileGlob
20595 =item Optional Parameters
20597 AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1,
20598 -MultiStream =E<gt> 0|1
20610 A filename, A filehandle, A scalar reference
20612 =item Constructor Options
20614 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
20615 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
20616 -Append =E<gt> 0|1, -Strict =E<gt> 0|1
20636 =item getHeaderInfo
20650 =item input_line_number
20668 =item MODIFICATION HISTORY
20670 =item COPYRIGHT AND LICENSE
20674 =head2 IO::Uncompress::Base - Base Class for IO::Uncompress modules
20686 =item MODIFICATION HISTORY
20688 =item COPYRIGHT AND LICENSE
20692 =head2 IO::Uncompress::Gunzip - Read RFC 1952 files/buffers
20700 DO NOT use in production code, The documentation is incomplete in places,
20701 Parts of the interface defined here are tentative, Please report any
20704 =item Functional Interface
20708 =item gunzip $input => $output [, OPTS]
20710 A filename, A filehandle, A scalar reference, An array reference, An Input
20711 FileGlob string, A filename, A filehandle, A scalar reference, An Array
20712 Reference, An Output FileGlob
20716 =item Optional Parameters
20718 AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1,
20719 -MultiStream =E<gt> 0|1
20731 A filename, A filehandle, A scalar reference
20733 =item Constructor Options
20735 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
20736 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
20737 -Append =E<gt> 0|1, -Strict =E<gt> 0|1, -ParseExtra =E<gt> 0|1
20759 =item getHeaderInfo
20775 =item input_line_number
20793 =item MODIFICATION HISTORY
20795 =item COPYRIGHT AND LICENSE
20799 =head2 IO::Uncompress::Inflate - Read RFC 1950 files/buffers
20807 DO NOT use in production code, The documentation is incomplete in places,
20808 Parts of the interface defined here are tentative, Please report any
20811 =item Functional Interface
20815 =item inflate $input => $output [, OPTS]
20817 A filename, A filehandle, A scalar reference, An array reference, An Input
20818 FileGlob string, A filename, A filehandle, A scalar reference, An Array
20819 Reference, An Output FileGlob
20823 =item Optional Parameters
20825 AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1,
20826 -MultiStream =E<gt> 0|1
20838 A filename, A filehandle, A scalar reference
20840 =item Constructor Options
20842 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
20843 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
20844 -Append =E<gt> 0|1, -Strict =E<gt> 0|1
20866 =item getHeaderInfo
20880 =item input_line_number
20898 =item MODIFICATION HISTORY
20900 =item COPYRIGHT AND LICENSE
20904 =head2 IO::Uncompress::RawInflate - Read RFC 1951 files/buffers
20912 DO NOT use in production code, The documentation is incomplete in places,
20913 Parts of the interface defined here are tentative, Please report any
20916 =item Functional Interface
20920 =item rawinflate $input => $output [, OPTS]
20922 A filename, A filehandle, A scalar reference, An array reference, An Input
20923 FileGlob string, A filename, A filehandle, A scalar reference, An Array
20924 Reference, An Output FileGlob
20928 =item Optional Parameters
20930 AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1,
20931 -MultiStream =E<gt> 0|1
20943 A filename, A filehandle, A scalar reference
20945 =item Constructor Options
20947 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
20948 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
20949 -Append =E<gt> 0|1, -Strict =E<gt> 0|1
20971 =item getHeaderInfo
20985 =item input_line_number
21003 =item MODIFICATION HISTORY
21005 =item COPYRIGHT AND LICENSE
21009 =head2 IO::Uncompress::Unzip - Read zip files/buffers
21017 DO NOT use in production code, The documentation is incomplete in places,
21018 Parts of the interface defined here are tentative, Please report any
21021 =item Functional Interface
21025 =item unzip $input => $output [, OPTS]
21027 A filename, A filehandle, A scalar reference, An array reference, An Input
21028 FileGlob string, A filename, A filehandle, A scalar reference, An Array
21029 Reference, An Output FileGlob
21033 =item Optional Parameters
21035 AutoClose =E<gt> 0|1, BinModeOut =E<gt> 0|1, -Append =E<gt> 0|1,
21036 -MultiStream =E<gt> 0|1
21048 A filename, A filehandle, A scalar reference
21050 =item Constructor Options
21052 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
21053 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
21054 -Append =E<gt> 0|1, -Strict =E<gt> 0|1
21076 =item getHeaderInfo
21090 =item input_line_number
21108 =item MODIFICATION HISTORY
21110 =item COPYRIGHT AND LICENSE
21114 =head2 IO::Zlib - IO:: style interface to L<Compress::Zlib>
21126 =item OBJECT METHODS
21128 open ( FILENAME, MODE ), opened, close, getc, getline, getlines, print (
21129 ARGS... ), read ( BUF, NBYTES, [OFFSET] ), eof, seek ( OFFSET, WHENCE ),
21130 tell, setpos ( POS ), getpos ( POS )
21132 =item USING THE EXTERNAL GZIP
21134 =item CLASS METHODS
21136 has_Compress_Zlib, gzip_external, gzip_used, gzip_read_open,
21141 IO::Zlib::getlines: must be called in list context,
21142 IO::Zlib::gzopen_external: mode '...' is illegal, IO::Zlib::import: '...'
21143 is illegal, IO::Zlib::import: ':gzip_external' requires an argument,
21144 IO::Zlib::import: 'gzip_read_open' requires an argument, IO::Zlib::import:
21145 'gzip_read' '...' is illegal, IO::Zlib::import: 'gzip_write_open' requires
21146 an argument, IO::Zlib::import: 'gzip_write_open' '...' is illegal,
21147 IO::Zlib::import: no Compress::Zlib and no external gzip, IO::Zlib::open:
21148 needs a filename, IO::Zlib::READ: NBYTES must be specified, IO::Zlib::READ:
21149 OFFSET is not supported, IO::Zlib::WRITE: too long LENGTH, IO::Zlib::WRITE:
21150 OFFSET is not supported
21160 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
21169 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
21170 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
21180 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
21190 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
21194 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode(
21205 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
21216 new (), new_from_fd ( FD, MODE )
21220 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
21221 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
21222 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
21223 $io->blocking ( [ BOOL ] ), $io->untaint
21235 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
21245 new ( [READER, WRITER] )
21249 reader ([ARGS]), writer ([ARGS]), handles ()
21259 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
21269 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
21270 IO ), handles( [ EVENT_MASK ] )
21280 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
21289 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
21290 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
21299 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
21310 new ( [ HANDLES ] )
21314 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
21315 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
21316 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
21326 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
21341 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
21342 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
21352 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
21353 AF_INET domain sockets
21369 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
21382 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
21383 AF_UNIX domain sockets
21397 hostpath(), peerpath()
21407 =head2 IPC::Msg - SysV Msg IPC object class
21417 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
21418 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
21429 =head2 IPC::Open2, open2 - open a process for both reading and writing
21443 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
21456 =head2 IPC::Semaphore - SysV Semaphore IPC object class
21466 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
21467 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
21468 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
21479 =head2 IPC::SysV - SysV IPC constants
21497 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
21507 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
21508 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
21519 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
21530 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
21531 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
21532 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
21543 =head2 List::Util - A selection of general-utility list subroutines
21551 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
21552 BLOCK LIST, shuffle LIST, sum LIST
21556 =item SUGGESTED ADDITIONS
21562 =head2 List::Utilib::List::Util, List::Util - A selection of
21563 general-utility list subroutines
21571 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
21572 BLOCK LIST, shuffle LIST, sum LIST
21576 =item SUGGESTED ADDITIONS
21582 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
21583 general-utility scalar subroutines
21591 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
21592 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
21593 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
21603 =head2 Locale::Constants - constants for Locale codes
21611 =item KNOWN BUGS AND LIMITATIONS
21615 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
21623 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
21631 B<alpha-2>, B<alpha-3>, B<numeric>
21633 =item CONVERSION ROUTINES
21635 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
21636 country_code2code( CODE, CODESET, CODESET )
21638 =item QUERY ROUTINES
21640 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
21642 =item SEMI-PRIVATE ROUTINES
21648 =item rename_country
21656 =item KNOWN BUGS AND LIMITATIONS
21660 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
21661 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
21662 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
21663 http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
21671 =head2 Locale::Currency - ISO three letter codes for currency
21672 identification (ISO 4217)
21682 =item CONVERSION ROUTINES
21684 code2currency(), currency2code()
21686 =item QUERY ROUTINES
21688 C<all_currency_codes()>, C<all_currency_names()>
21692 =item KNOWN BUGS AND LIMITATIONS
21696 Locale::Country, Locale::Script, ISO 4217:1995,
21697 http://www.bsi-global.com/iso4217currency
21705 =head2 Locale::Language - ISO two letter codes for language identification
21714 =item CONVERSION ROUTINES
21716 code2language(), language2code()
21718 =item QUERY ROUTINES
21720 C<all_language_codes()>, C<all_language_names()>
21724 =item KNOWN BUGS AND LIMITATIONS
21728 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
21729 http://lcweb.loc.gov/standards/iso639-2/langhome.html
21737 =head2 Locale::Maketext - framework for localization
21745 =item QUICK OVERVIEW
21751 =item Construction Methods
21753 =item The "maketext" Method
21755 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
21757 =item Utility Methods
21759 $language->quant($number, $singular), $language->quant($number, $singular,
21760 $plural), $language->quant($number, $singular, $plural, $negative),
21761 $language->numf($number), $language->sprintf($format, @items),
21762 $language->language_tag(), $language->encoding()
21764 =item Language Handle Attributes and Internals
21768 =item LANGUAGE CLASS HIERARCHIES
21770 =item ENTRIES IN EACH LEXICON
21772 =item BRACKET NOTATION
21774 =item AUTO LEXICONS
21776 =item CONTROLLING LOOKUP FAILURE
21778 =item HOW TO USE MAKETEXT
21782 =item COPYRIGHT AND DISCLAIMER
21788 =head2 Locale::Maketext::TPJ13 -- article about software localization
21796 =item Localization and Perl: gettext breaks, Maketext fixes
21800 =item A Localization Horror Story: It Could Happen To You
21802 =item The Linguistic View
21804 =item Breaking gettext
21806 =item Replacing gettext
21808 =item Buzzwords: Abstraction and Encapsulation
21810 =item Buzzword: Isomorphism
21812 =item Buzzword: Inheritance
21814 =item Buzzword: Concision
21816 =item The Devil in the Details
21818 =item The Proof in the Pudding: Localizing Web Sites
21826 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
21834 B<alpha-2>, B<alpha-3>, B<numeric>
21838 =item SPECIAL CODES
21842 =item CONVERSION ROUTINES
21844 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
21845 script_code2code( CODE, CODESET, CODESET )
21847 =item QUERY ROUTINES
21849 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
21853 =item KNOWN BUGS AND LIMITATIONS
21857 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
21858 http://www.evertype.com/standards/iso15924/
21866 =head2 MIME::Base64 - Encoding and decoding of base64 strings
21874 encode_base64($str), encode_base64($str, $eol);, decode_base64($str)
21878 Premature end of base64 data, Premature padding of base64 data, Wide
21879 character in subroutine entry
21889 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
21890 of quoted-printable strings
21898 encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode),
21907 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
21916 encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode),
21925 =head2 Math::BigFloat - Arbitrary size floating point math package
21935 =item Canonical notation
21939 =item C<mantissa()>, C<exponent()> and C<parts()>
21941 =item Accuracy vs. Precision
21945 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround ( +$scale
21946 ), fround ( -$scale ) and fround ( 0 )
21960 =item Autocreating constants
21966 =item Using Math::BigInt::Lite
21974 stringify, bstr(), bdiv, Modifying and =, bpow, precision() vs. accuracy()
21984 =head2 Math::BigInt - Arbitrary size integer/float math package
22016 =item is_one()/is_zero()/is_nan()/is_inf()
22018 =item is_pos()/is_neg()
22020 $x->is_pos(); # true if > 0
22021 $x->is_neg(); # true if < 0
22023 =item is_odd()/is_even()/is_int()
22109 =item ACCURACY and PRECISION
22119 =item Rounding mode R
22121 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
22122 (significant digits), Setting/Accessing, Creating numbers, Usage,
22123 Precedence, Overriding globals, Local settings, Rounding, Default values,
22128 =item Infinity and Not a Number
22130 oct()/hex(), log(-inf), exp(), cos(), sin(), atan2()
22140 =item mantissa(), exponent() and parts()
22148 =item Autocreating constants
22154 =item Alternative math libraries
22160 =item Subclassing Math::BigInt
22168 bsqrt(), div(), blog()
22174 broot() does not work, Out of Memory!, Fails to load Calc on Perl prior
22179 bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling,
22180 Modifying and =, bpow, Overloading -$x, Mixing different object types,
22191 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
22203 =item WRAP YOUR OWN
22207 This program is free software; you may redistribute it and/or modify it
22209 the same terms as Perl itself.
22217 =head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code
22239 This program is free software; you may redistribute it and/or modify it
22241 the same terms as Perl itself.
22249 =head2 Math::BigInt::FastCalc - Math::BigInt::Calc with some XS for more
22264 This program is free software; you may redistribute it and/or modify it
22266 the same terms as Perl itself.
22274 =head2 Math::BigRat - Arbitrary big rational numbers
22296 =item denominator()
22298 $d = $x->denominator();
22312 =item bround()/round()/bfround()
22346 inf handling (partial), NaN handling (partial), rounding (not implemented
22347 except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(),
22348 blog(), bmodinv() and bmodpow() (partial)
22358 =head2 Math::Complex - complex numbers and associated mathematical
22375 =item CHANGED IN PERL 5.6
22381 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
22383 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
22391 =head2 Math::Trig - trigonometric functions
22399 =item TRIGONOMETRIC FUNCTIONS
22405 =item ERRORS DUE TO DIVISION BY ZERO
22407 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
22411 =item PLANE ANGLE CONVERSIONS
22413 =item RADIAL COORDINATE CONVERSIONS
22417 =item COORDINATE SYSTEMS
22419 =item 3-D ANGLE CONVERSIONS
22421 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
22422 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
22426 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
22432 =item CAVEAT FOR GREAT CIRCLE FORMULAS
22442 =head2 Memoize - Make functions faster by trading space for time
22460 =item C<SCALAR_CACHE>, C<LIST_CACHE>
22462 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
22466 =item OTHER FACILITIES
22472 =item C<flush_cache>
22478 =item PERSISTENT CACHE SUPPORT
22480 =item EXPIRATION SUPPORT
22488 =item COPYRIGHT AND LICENSE
22494 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
22503 =head2 Memoize::Expire - Plug-in module for automatic expiration of
22514 TIEHASH, EXISTS, STORE
22526 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
22534 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
22542 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
22551 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
22560 =head2 Memoize::Storable - store Memoized data in Storable database
22568 =head2 Module::Build - Build and install Perl modules
22576 =item GUIDE TO DOCUMENTATION
22578 General Usage (L<Module::Build>), Authoring Reference
22579 (L<Module::Build::Authoring>), API Reference (L<Module::Build::API>),
22580 Cookbook (L<Module::Build::Cookbook>)
22584 build, clean, code, config_data, diff, dist, distcheck, distclean, distdir,
22585 distmeta, distsign, disttest, docs, fakeinstall, help, html, install,
22586 manifest, manpages, ppd, ppmdist, prereq_report, pure_install, realclean,
22587 skipcheck, test, testcover, testdb, testpod, testpodcoverage,
22594 =item Command Line Options
22596 quiet, use_rcfile, verbose
22598 =item Default Options File (F<.modulebuildrc>)
22602 =item INSTALL PATHS
22604 lib, arch, script, bin, bindoc, libdoc, binhtml, libhtml, installdirs,
22605 install_path, install_base, destdir
22609 =item About PREFIX Support
22611 Why PREFIX is not recommended, Alternatives to PREFIX
22629 =head2 Module::Build::API - API Reference for Module Authors
22639 current(), new(), add_to_cleanup, auto_features, autosplit, build_class,
22640 build_requires, create_packlist, c_source, conflicts, create_makefile_pl,
22641 create_readme, dist_abstract, dist_author, dist_name, dist_version,
22642 dist_version_from, dynamic_config, extra_compiler_flags,
22643 extra_linker_flags, get_options, type, store, default, include_dirs,
22644 install_path, installdirs, license, apache, artistic, bsd, gpl, lgpl, mit,
22645 mozilla, open_source, perl, restrictive, unrestricted, meta_add,
22646 meta_merge, module_name, PL_files, pm_files, pod_files, recommends,
22647 recursive_test_files, requires, script_files, sign, test_files, xs_files,
22648 new_from_context(%args), resume(), subclass()
22652 add_build_element($type), add_to_cleanup(@files), args(),
22653 autosplit_file($from, $to), base_dir(), build_requires(),
22654 check_installed_status($module, $version), check_installed_version($module,
22655 $version), compare_versions($v1, $op, $v2), config(), config_data($name),
22656 config_data($name => $value), conflicts(), contains_pod($file),
22657 copy_if_modified(%parameters), create_build_script(), current_action(),
22658 depends_on(@actions), dir_contains($first_dir, $second_dir),
22659 dispatch($action, %args), dist_dir(), dist_name(), dist_version(),
22660 do_system($cmd, @args), feature($name), feature($name => $value),
22661 have_c_compiler(), install_base_relpaths(), install_base_relpaths($type),
22662 install_base_relpaths($type => $path), install_destination($type),
22663 install_path(), install_path($type), install_path($type => $path),
22664 install_types(), invoked_action(), notes(), notes($key), notes($key =>
22665 $value), orig_dir(), os_type(), prefix_relpaths(),
22666 prefix_relpaths($installdirs), prefix_relpaths($installdirs, $type),
22667 prefix_relpaths($installdirs, $type => $path), prepare_metadata(),
22668 prereq_failures(), prereq_report(), prompt($message, $default),
22669 recommends(), requires(), rscan_dir($dir, $pattern), runtime_params(),
22670 runtime_params($key), script_files(), up_to_date($source_file,
22671 $derived_file), up_to_date(\@source_files, \@derived_files), y_n($message,
22674 =item Autogenerated Accessors
22676 PL_files(), autosplit(), base_dir(), bindoc_dirs(), blib(), build_bat(),
22677 build_class(), build_elements(), build_requires(), build_script(),
22678 c_source(), config(), config_dir(), conflicts(), create_makefile_pl(),
22679 create_packlist(), create_readme(), debugger(), destdir(), get_options(),
22680 html_css(), include_dirs(), install_base(), install_sets(), installdirs(),
22681 libdoc_dirs(), license(), magic_number(), mb_version(), meta_add(),
22682 meta_merge(), metafile(), module_name(), orig_dir(), original_prefix(),
22683 perl(), pm_files(), pod_files(), pollute(), prefix(),
22684 prereq_action_types(), quiet(), recommends(), recurse_into(),
22685 recursive_test_files(), requires(), scripts(), use_rcfile(), verbose(),
22698 =head2 Module::Build::Authoring - Authoring Module::Build modules
22708 =item PREREQUISITES
22712 =item Format of prerequisites
22716 =item SAVING CONFIGURATION INFORMATION
22718 =item STARTING MODULE DEVELOPMENT
22730 =head2 Module::Build::Base - Default methods for Module::Build
22746 =head2 Module::Build::Compat - Compatibility with ExtUtils::MakeMaker
22756 create_makefile_pl($style, $build), small, passthrough, traditional,
22757 run_build_pl(args => \@ARGV), args, script, write_makefile(), makefile
22769 =head2 Module::Build::ConfigData - Configuration for Module::Build
22779 config($name), feature($name), set_config($name, $value),
22780 set_feature($name, $value), config_names(), feature_names(),
22781 auto_feature_names(), write()
22787 =head2 Module::Build::Cookbook - Examples of Module::Build Usage
22793 =item BASIC RECIPES
22797 =item The basic installation recipe for modules that use Module::Build
22799 =item Making a CPAN.pm-compatible distribution
22801 =item Installing modules using the programmatic interface
22803 =item Installing to a temporary directory
22805 =item Installing to a non-standard directory
22807 =item Running a single test file
22811 =item ADVANCED RECIPES
22815 =item Changing the order of the build process
22817 =item Adding new file types to the build process
22819 =item Adding new elements to the install process
22823 =item EXAMPLES ON CPAN
22827 =item SVN-Notify-Mirror
22829 1. Using C<auto_features>, I check to see whether two optional modules are
22830 available - SVN::Notify::Config and Net::SSH;, 2. If the S::N::Config
22831 module is loaded, I automatically generate testfiles for it during Build
22832 (using the C<PL_files> property), 3. If the C<ssh_feature> is available, I
22833 ask if the user wishes to perform the ssh tests (since it requires a little
22834 preliminary setup);, 4. Only if the user has C<ssh_feature> and answers yes
22835 to the testing, do I generate a test file
22837 =item Modifying an action
22849 =head2 Module::Build::ModuleInfo, ModuleInfo - Gather package and POD
22850 information from a perl module files
22856 new_from_file($filename, collect_pod => 1), new_from_module($module,
22857 collect_pod => 1, inc => \@dirs), name(), version($package), filename(),
22858 packages_inside(), pod_inside(), contains_pod(), pod($section),
22859 find_module_by_name($module, \@dirs), find_module_dir_by_name($module,
22870 =head2 Module::Build::Notes, $notes_name - Configuration for $module_name
22880 config(\$name), feature(\$name), set_config(\$name, \$value),
22881 set_feature(\$name, \$value), config_names(), feature_names(),
22882 auto_feature_names(), write()
22888 =head2 Module::Build::PPMMaker - Perl Package Manager file creation
22904 =head2 Module::Build::Platform::Amiga - Builder class for Amiga platforms
22916 =head2 Module::Build::Platform::Default - Stub class for unknown platforms
22928 =head2 Module::Build::Platform::EBCDIC - Builder class for EBCDIC platforms
22940 =head2 Module::Build::Platform::MPEiX - Builder class for MPEiX platforms
22952 =head2 Module::Build::Platform::MacOS - Builder class for MacOS platforms
22960 =item Overriden Methods
22962 new(), make_executable(), dispatch(), ACTION_realclean()
22972 =head2 Module::Build::Platform::RiscOS - Builder class for RiscOS platforms
22984 =head2 Module::Build::Platform::Unix - Builder class for Unix platforms
22996 =head2 Module::Build::Platform::VMS - Builder class for VMS platforms
23004 =item Overridden Methods
23026 =head2 Module::Build::Platform::VOS - Builder class for VOS platforms
23038 =head2 Module::Build::Platform::Windows - Builder class for Windows
23051 =head2 Module::Build::Platform::aix - Builder class for AIX platform
23063 =head2 Module::Build::Platform::cygwin - Builder class for Cygwin platform
23075 =head2 Module::Build::Platform::darwin - Builder class for Mac OS X
23088 =head2 Module::Build::Platform::os2 - Builder class for OS/2 platform
23100 =head2 Module::Build::YAML - Provides just enough YAML support so that
23101 Module::Build works even if YAML.pm is not installed
23115 =head2 Module::CoreList - what modules shipped with versions of perl
23135 =head2 NDBM_File - Tied access to ndbm files
23143 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
23149 =item C<ndbm store returned -1, errno 22, key "..." at ...>
23153 =item BUGS AND WARNINGS
23157 =head2 NEXT - Provide a pseudo-class NEXT (et al) that allows method
23168 =item Enforcing redispatch
23170 =item Avoiding repetitions
23172 =item Invoking all versions of a method with a single call
23174 =item Using C<EVERY> methods
23180 =item BUGS AND IRRITATIONS
23186 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
23196 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
23199 =item CLASS METHODS
23201 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
23202 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
23203 ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh ()
23213 =head2 Net::Config - Local configuration data for libnet
23223 requires_firewall HOST
23225 =item NetConfig VALUES
23227 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
23228 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
23229 ftp_int_passive, local_netmask, test_hosts, test_exists
23233 =head2 Net::Domain - Attempt to evaluate the current host's internet name
23242 hostfqdn (), domainname (), hostname (), hostdomain ()
23250 =head2 Net::FTP - FTP Client class
23262 new ([ HOST ] [, OPTIONS ])
23266 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
23267 site (ARGS), ascii, binary, rename ( OLDNAME, NEWNAME ), delete ( FILENAME
23268 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR [,
23269 RECURSE ]), mkdir ( DIR [, RECURSE ]), alloc ( SIZE [, RECORD_SIZE] ), ls (
23270 [ DIR ] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ),
23271 put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE
23272 ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ),
23273 size ( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[
23274 BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ DIR ] ), retr ( FILE ),
23275 stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [ PORT ] ), pasv (),
23276 pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_xfer_unique (
23277 SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( NON_PASV_SERVER ),
23282 =item Methods for the adventurous
23288 =item THE dataconn CLASS
23290 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
23291 bytes_read (), abort (), close ()
23293 =item UNIMPLEMENTED
23295 B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
23297 =item REPORTING BUGS
23305 http://www.csh.rit.edu/~adam/Progs/
23313 =head2 Net::NNTP - NNTP Client class
23323 new ( [ HOST ] [, OPTIONS ])
23327 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
23328 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
23329 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
23330 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
23331 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
23332 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
23333 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
23337 =item Extension methods
23339 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
23340 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
23341 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
23342 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
23351 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
23361 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
23371 new ( [ HOST ] [, OPTIONS ] 0
23375 auth ( USERNAME, PASSWORD ), user ( USER ), pass ( PASS ), login ( [ USER
23376 [, PASS ]] ), apop ( [ USER [, PASS ]] ), banner (), capa (), capabilities
23377 (), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [, FH ]
23378 ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ]
23379 ), delete ( MSGNUM ), reset (), quit ()
23391 =head2 Net::Ping - check a remote host for reachability
23403 Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos
23404 ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
23405 $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
23406 $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
23407 [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host
23424 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
23436 new ( [ HOST ] [, OPTIONS ] )
23440 banner (), domain (), hello ( DOMAIN ), host (), etrn ( DOMAIN ), auth (
23441 USERNAME, PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ),
23442 send_or_mail ( ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient (
23443 ADDRESS [, ADDRESS, [...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]]
23444 ), cc ( ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ),
23445 data ( [ DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [
23446 $subject ] ), quit ()
23458 =head2 Net::Time - time and daytime network client interface
23466 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
23467 PROTOCOL [, TIMEOUT]]])
23475 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
23492 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
23500 =item Where to get this document
23502 =item How to contribute to this document
23506 =item Author and Copyright Information
23514 =item Obtaining and installing libnet
23518 =item What is libnet ?
23520 =item Which version of perl do I need ?
23522 =item What other modules do I need ?
23524 =item What machines support libnet ?
23526 =item Where can I get the latest libnet release
23530 =item Using Net::FTP
23534 =item How do I download files from an FTP server ?
23536 =item How do I transfer files in binary mode ?
23538 =item How can I get the size of a file on a remote FTP server ?
23540 =item How can I get the modification time of a file on a remote FTP server
23543 =item How can I change the permissions of a file on a remote server ?
23545 =item Can I do a reget operation like the ftp command ?
23547 =item How do I get a directory listing from an FTP server ?
23549 =item Changing directory to "" does not fail ?
23551 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
23553 =item I am behind an FTP proxy firewall, but cannot access machines outside
23556 =item My ftp proxy firewall does not listen on port 21
23558 =item Is it possible to change the file permissions of a file on an FTP
23561 =item I have seen scripts call a method message, but cannot find it
23564 =item Why does Net::FTP not implement mput and mget methods
23568 =item Using Net::SMTP
23572 =item Why can't the part of an Email address after the @ be used as the
23575 =item Why does Net::SMTP not do DNS MX lookups ?
23577 =item The verify method always returns true ?
23581 =item Debugging scripts
23585 =item How can I debug my scripts that use Net::* modules ?
23589 =item AUTHOR AND COPYRIGHT
23593 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
23610 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
23625 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
23642 =head2 Netrc, Net::Netrc - OO interface to users netrc file
23650 =item THE .netrc FILE
23652 machine name, default, login name, password string, account string, macdef
23657 lookup ( MACHINE [, LOGIN ])
23661 login (), password (), account (), lpa ()
23671 =head2 O - Generic interface to Perl Compiler backends
23681 =item IMPLEMENTATION
23689 =head2 ODBM_File - Tied access to odbm files
23697 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
23703 =item C<odbm store returned -1, errno 22, key "..." at ...>
23707 =item BUGS AND WARNINGS
23711 =head2 Opcode - Disable named opcodes when compiling perl code
23723 =item Operator Names and Operator Lists
23725 an operator name (opname), an operator tag name (optag), a negated opname
23726 or optag, an operator set (opset)
23728 =item Opcode Functions
23730 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
23731 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
23732 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
23735 =item Manipulating Opsets
23737 =item TO DO (maybe)
23743 =item Predefined Opcode Tags
23745 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
23746 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
23747 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
23756 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
23765 a new namespace, an operator mask
23771 =item RECENT CHANGES
23773 =item Methods in class Safe
23775 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
23776 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
23777 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
23778 root (NAMESPACE), mask (MASK)
23780 =item Some Safety Issues
23782 Memory, CPU, Snooping, Signals, State Changes
23790 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
23803 =head2 POSIX - Perl interface to IEEE Std 1003.1
23817 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
23818 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
23819 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
23820 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
23821 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
23822 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
23823 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
23824 fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv,
23825 geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid,
23826 getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha,
23827 isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace,
23828 isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime,
23829 log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr,
23830 memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice,
23831 offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc,
23832 putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename,
23833 rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid,
23834 setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
23835 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
23836 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
23837 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
23838 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
23839 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
23840 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
23841 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
23848 =item POSIX::SigAction
23850 new, handler, mask, flags, safe
23854 %SIGRT, SIGRTMIN, SIGRTMAX
23856 =item POSIX::SigSet
23858 new, addset, delset, emptyset, fillset, ismember
23860 =item POSIX::Termios
23862 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
23863 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
23864 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
23865 field values, c_cflag field values, c_iflag field values, c_lflag field
23866 values, c_oflag field values
23870 =item PATHNAME CONSTANTS
23874 =item POSIX CONSTANTS
23878 =item SYSTEM CONFIGURATION
23932 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
23933 WTERMSIG, WIFSTOPPED, WSTOPSIG
23937 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
23946 :unix, :stdio, :perlio, :crlf, :mmap, :utf8, :bytes, :raw, :pop, :win32
23950 =item Custom Layers
23954 =item Alternatives to raw
23956 =item Defaults and how to override them
23958 =item Querying the layers of filehandles
23968 =head2 PerlIO::encoding - encoding layer
23980 =head2 PerlIO::scalar - in-memory IO, scalar IO
23988 =item IMPLEMENTATION NOTE
23992 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
24000 =item EXPECTED METHODS
24002 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
24003 $obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]),
24004 $obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]),
24005 $obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh),
24006 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
24007 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
24008 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
24009 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
24015 =item Example - a Hexadecimal Handle
24021 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
24029 =item REQUIRED MODULES
24033 =item ACKNOWLEDGEMENTS
24039 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
24045 =item OPTIONS/ARGUMENTS
24051 B<-warnings> =E<gt> I<val>
24063 empty =headn, =over on line I<N> without closing =back, =item without
24064 previous =over, =back without previous =over, No argument for =begin, =end
24065 without =begin, Nested =begin's, =for without formatter specification,
24066 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
24067 interior-sequence "I<SEQ>", nested commands
24068 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
24069 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
24070 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
24075 multiple occurrence of link target I<name>, line containing nothing but
24076 whitespace in paragraph, file does not start with =head, previous =item has
24077 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
24078 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
24079 items in =over, No argument for =item, empty section in previous paragraph,
24080 Verbatim paragraph in NAME section, =headI<n> without preceding higher
24085 ignoring leading/trailing whitespace in link, (section) in '$page'
24086 deprecated, alternative text/node '%s' contains non-escaped | or /
24098 C<Pod::Checker-E<gt>new( %options )>
24100 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
24103 C<$checker-E<gt>num_errors()>
24105 C<$checker-E<gt>num_warnings()>
24107 C<$checker-E<gt>name()>
24109 C<$checker-E<gt>node()>
24111 C<$checker-E<gt>idx()>
24113 C<$checker-E<gt>hyperlink()>
24121 =head2 Pod::Escapes -- for resolving Pod EE<lt>...E<gt> sequences
24131 e2char($e_content), e2charnum($e_content), $Name2character{I<name>},
24132 $Name2character_number{I<name>}, $Latin1Code_to_fallback{I<integer>},
24133 $Latin1Char_to_fallback{I<character>}, $Code2USASCII{I<integer>}
24139 =item COPYRIGHT AND DISCLAIMERS
24145 =head2 Pod::Find - find POD documents in directory trees
24157 =item C<pod_find( { %opts } , @directories )>
24159 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
24166 =item C<simplify_name( $str )>
24172 =item C<pod_where( { %opts }, $pod )>
24174 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
24181 =item C<contains_pod( $file , $verbose )>
24193 =head2 Pod::Html - module to convert pod files to HTML
24207 backlink, cachedir, css, flush, header, help, hiddendirs, htmldir,
24208 htmlroot, index, infile, libpods, netscape, outfile, podpath, podroot,
24209 quiet, recurse, title, verbose
24227 =head2 Pod::InputObjects - objects representing POD input paragraphs,
24240 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
24241 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
24247 =item B<Pod::InputSource>
24271 =item B<was_cutting()>
24277 =item B<Pod::Paragraph>
24283 =item Pod::Paragraph-E<gt>B<new()>
24289 =item $pod_para-E<gt>B<cmd_name()>
24295 =item $pod_para-E<gt>B<text()>
24301 =item $pod_para-E<gt>B<raw_text()>
24307 =item $pod_para-E<gt>B<cmd_prefix()>
24313 =item $pod_para-E<gt>B<cmd_separator()>
24319 =item $pod_para-E<gt>B<parse_tree()>
24325 =item $pod_para-E<gt>B<file_line()>
24331 =item B<Pod::InteriorSequence>
24337 =item Pod::InteriorSequence-E<gt>B<new()>
24343 =item $pod_seq-E<gt>B<cmd_name()>
24349 =item $pod_seq-E<gt>B<prepend()>
24355 =item $pod_seq-E<gt>B<append()>
24361 =item $pod_seq-E<gt>B<nested()>
24367 =item $pod_seq-E<gt>B<raw_text()>
24373 =item $pod_seq-E<gt>B<left_delimiter()>
24379 =item $pod_seq-E<gt>B<right_delimiter()>
24385 =item $pod_seq-E<gt>B<parse_tree()>
24391 =item $pod_seq-E<gt>B<file_line()>
24397 =item Pod::InteriorSequence::B<DESTROY()>
24403 =item B<Pod::ParseTree>
24409 =item Pod::ParseTree-E<gt>B<new()>
24415 =item $ptree-E<gt>B<top()>
24421 =item $ptree-E<gt>B<children()>
24427 =item $ptree-E<gt>B<prepend()>
24433 =item $ptree-E<gt>B<append()>
24439 =item $ptree-E<gt>B<raw_text()>
24445 =item Pod::ParseTree::B<DESTROY()>
24457 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
24469 =item OBJECT METHODS
24477 =item Data Accessors
24493 B<ReplaceNAMEwithSection>
24495 B<StartWithNewPage>
24509 =item Subclassed methods
24523 B<interior_sequence>
24539 =item Methods for headings
24547 =item Internal methods
24553 B<_replace_special_chars>
24555 B<_replace_special_chars_late>
24561 B<_clean_latex_commands>
24563 B<_split_delimited>
24579 =head2 Pod::Man - Convert POD data to formatted *roff input
24587 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
24592 roff font should be 1 or 2 chars, not "%s", Invalid quote specification
24601 =item COPYRIGHT AND LICENSE
24607 =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
24619 =item COPYRIGHT AND LICENSE
24623 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
24637 Pod::List-E<gt>new()
24645 $list-E<gt>indent()
24653 $list-E<gt>parent()
24659 =item Pod::Hyperlink
24661 Pod::Hyperlink-E<gt>new()
24665 $link-E<gt>parse($string)
24667 $link-E<gt>markup($string)
24671 $link-E<gt>warning()
24673 $link-E<gt>file(), $link-E<gt>line()
24679 $link-E<gt>alttext()
24689 Pod::Cache-E<gt>new()
24695 $cache-E<gt>find_page($name)
24699 =item Pod::Cache::Item
24701 Pod::Cache::Item-E<gt>new()
24705 $cacheitem-E<gt>page()
24707 $cacheitem-E<gt>description()
24709 $cacheitem-E<gt>path()
24711 $cacheitem-E<gt>file()
24713 $cacheitem-E<gt>nodes()
24715 $cacheitem-E<gt>find_node($name)
24717 $cacheitem-E<gt>idx()
24727 =head2 Pod::Parser - base class for creating POD filters and translators
24739 =item QUICK OVERVIEW
24741 =item PARSING OPTIONS
24743 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
24744 B<-warnings> (default: unset)
24750 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
24758 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
24764 =item B<verbatim()>
24766 C<$text>, C<$line_num>, C<$pod_para>
24772 =item B<textblock()>
24774 C<$text>, C<$line_num>, C<$pod_para>
24780 =item B<interior_sequence()>
24786 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
24798 =item B<initialize()>
24804 =item B<begin_pod()>
24810 =item B<begin_input()>
24816 =item B<end_input()>
24828 =item B<preprocess_line()>
24834 =item B<preprocess_paragraph()>
24840 =item METHODS FOR PARSING AND PROCESSING
24846 =item B<parse_text()>
24848 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
24849 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
24850 I<code-ref>|I<method-name>
24856 =item B<interpolate()>
24862 =item B<parse_paragraph()>
24868 =item B<parse_from_filehandle()>
24874 =item B<parse_from_file()>
24880 =item ACCESSOR METHODS
24886 =item B<errorsub()>
24898 =item B<parseopts()>
24904 =item B<output_file()>
24910 =item B<output_handle()>
24916 =item B<input_file()>
24922 =item B<input_handle()>
24928 =item B<input_streams()>
24934 =item B<top_stream()>
24940 =item PRIVATE METHODS AND DATA
24946 =item B<_push_input_stream()>
24952 =item B<_pop_input_stream()>
24958 =item TREE-BASED PARSING
24966 =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors
24976 =item COPYRIGHT AND DISCLAIMERS
24982 =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages
24994 =item COPYRIGHT AND DISCLAIMERS
25000 =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff
25012 =item COPYRIGHT AND DISCLAIMERS
25018 =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod!
25028 =item COPYRIGHT AND DISCLAIMERS
25034 =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF
25044 =item COPYRIGHT AND DISCLAIMERS
25050 =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext
25062 =item COPYRIGHT AND DISCLAIMERS
25068 =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod
25082 =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML
25092 =item COPYRIGHT AND DISCLAIMERS
25098 =head2 Pod::PlainText - Convert POD data to formatted ASCII text
25106 alt, indent, loose, sentence, width
25110 Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
25111 Unknown sequence: %s, Unmatched =back
25123 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
25143 =head2 Pod::Select, podselect() - extract selected sections of POD from
25156 =item SECTION SPECIFICATIONS
25158 =item RANGE SPECIFICATIONS
25164 =item OBJECT METHODS
25170 =item B<curr_headings()>
25182 =item B<add_selection()>
25188 =item B<clear_selections()>
25194 =item B<match_section()>
25200 =item B<is_selected()>
25206 =item EXPORTED FUNCTIONS
25212 =item B<podselect()>
25214 B<-output>, B<-sections>, B<-ranges>
25220 =item PRIVATE METHODS AND DATA
25226 =item B<_compile_section_spec()>
25232 =item $self->{_SECTION_HEADINGS}
25238 =item $self->{_SELECTED_SECTIONS}
25250 =head2 Pod::Simple - framework for parsing Pod
25260 C<< $parser = I<SomeClass>->new(); >>, C<< $parser->output_fh( *OUT ); >>,
25261 C<< $parser->output_string( \$somestring ); >>, C<< $parser->parse_file(
25262 I<$some_filename> ); >>, C<< $parser->parse_file( *INPUT_FH ); >>, C<<
25263 $parser->parse_string_document( I<$all_content> ); >>, C<<
25264 $parser->parse_lines( I<...@lines...>, undef ); >>, C<<
25265 $parser->content_seen >>, C<< I<SomeClass>->filter( I<$filename> ); >>, C<<
25266 I<SomeClass>->filter( I<*INPUT_FH> ); >>, C<< I<SomeClass>->filter(
25267 I<\$document_content> ); >>
25269 =item SECONDARY METHODS
25271 C<< $parser->no_whining( I<SOMEVALUE> ) >>, C<< $parser->no_errata_section(
25272 I<SOMEVALUE> ) >>, C<< $parser->complain_stderr( I<SOMEVALUE> ) >>, C<<
25273 $parser->source_filename >>, C<< $parser->doc_has_started >>, C<<
25274 $parser->source_dead >>
25280 =item COPYRIGHT AND DISCLAIMERS
25286 =head2 Pod::Simple::Checker -- check the Pod syntax of a document
25296 =item COPYRIGHT AND DISCLAIMERS
25302 =head2 Pod::Simple::Debug -- put Pod::Simple into trace/debug mode
25316 =item COPYRIGHT AND DISCLAIMERS
25322 =head2 Pod::Simple::DumpAsText -- dump Pod-parsing events as text
25332 =item COPYRIGHT AND DISCLAIMERS
25338 =head2 Pod::Simple::DumpAsXML -- turn Pod into XML
25348 =item COPYRIGHT AND DISCLAIMERS
25354 =head2 Pod::Simple::HTML - convert Pod to HTML
25362 =item CALLING FROM THE COMMAND LINE
25364 =item CALLING FROM PERL
25372 =item COPYRIGHT AND DISCLAIMERS
25378 =head2 Pod::Simple::HTMLBatch - convert several Pod files to several HTML
25389 =item FROM THE COMMAND LINE
25395 $batchconv = Pod::Simple::HTMLBatch->new;, $batchconv->batch_convert(
25396 I<indirs>, I<outdir> );, $batchconv->batch_convert( undef , ...);,
25397 $batchconv->batch_convert( q{@INC}, ...);, $batchconv->batch_convert(
25398 \@dirs , ...);, $batchconv->batch_convert( "somedir" , ...);,
25399 $batchconv->batch_convert( 'somedir:someother:also' , ...);,
25400 $batchconv->batch_convert( ... , undef );, $batchconv->batch_convert( ... ,
25405 =item ACCESSOR METHODS
25407 $batchconv->verbose( I<nonnegative_integer> );, $batchconv->index(
25408 I<true-or-false> );, $batchconv->contents_file( I<filename> );,
25409 $batchconv->contents_page_start( I<HTML_string> );,
25410 $batchconv->contents_page_end( I<HTML_string> );, $batchconv->add_css( $url
25411 );, $batchconv->add_javascript( $url );, $batchconv->css_flurry(
25412 I<true-or-false> );, $batchconv->javascript_flurry( I<true-or-false> );,
25413 $batchconv->no_contents_links( I<true-or-false> );,
25414 $batchconv->html_render_class( I<classname> );
25418 =item NOTES ON CUSTOMIZATION
25424 =item COPYRIGHT AND DISCLAIMERS
25430 =head2 Pod::Simple::LinkSection -- represent "section" attributes of L
25441 =item COPYRIGHT AND DISCLAIMERS
25447 =head2 Pod::Simple::Methody -- turn Pod::Simple events into method calls
25455 =item METHOD CALLING
25459 =item COPYRIGHT AND DISCLAIMERS
25465 =head2 Pod::Simple::PullParser -- a pull-parser interface to parsing Pod
25475 my $token = $parser->get_token, $parser->unget_token( $token ),
25476 $parser->unget_token( $token1, $token2, ... ), $parser->set_source(
25477 $filename ), $parser->set_source( $filehandle_object ),
25478 $parser->set_source( \$document_source ), $parser->set_source(
25479 \@document_lines ), $parser->parse_file(...),
25480 $parser->parse_string_document(...), $parser->filter(...),
25481 $parser->parse_from_file(...), my $title_string = $parser->get_title, my
25482 $title_string = $parser->get_short_title, $author_name =
25483 $parser->get_author, $description_name = $parser->get_description,
25484 $version_block = $parser->get_version
25490 =item COPYRIGHT AND DISCLAIMERS
25496 =head2 Pod::Simple::PullParserEndToken -- end-tokens from
25497 Pod::Simple::PullParser
25505 $token->tagname, $token->tagname(I<somestring>), $token->tag(...),
25506 $token->is_tag(I<somestring>) or $token->is_tagname(I<somestring>)
25510 =item COPYRIGHT AND DISCLAIMERS
25516 =head2 Pod::Simple::PullParserStartToken -- start-tokens from
25517 Pod::Simple::PullParser
25525 $token->tagname, $token->tagname(I<somestring>), $token->tag(...),
25526 $token->is_tag(I<somestring>) or $token->is_tagname(I<somestring>),
25527 $token->attr(I<attrname>), $token->attr(I<attrname>, I<newvalue>),
25532 =item COPYRIGHT AND DISCLAIMERS
25538 =head2 Pod::Simple::PullParserTextToken -- text-tokens from
25539 Pod::Simple::PullParser
25547 $token->text, $token->text(I<somestring>), $token->text_r()
25551 =item COPYRIGHT AND DISCLAIMERS
25557 =head2 Pod::Simple::PullParserToken -- tokens from Pod::Simple::PullParser
25565 $token->type, $token->is_start, $token->is_text, $token->is_end,
25570 =item COPYRIGHT AND DISCLAIMERS
25576 =head2 Pod::Simple::RTF -- format Pod as RTF
25584 =item FORMAT CONTROL ATTRIBUTES
25586 $parser->head1_halfpoint_size( I<halfpoint_integer> );,
25587 $parser->head2_halfpoint_size( I<halfpoint_integer> );,
25588 $parser->head3_halfpoint_size( I<halfpoint_integer> );,
25589 $parser->head4_halfpoint_size( I<halfpoint_integer> );,
25590 $parser->codeblock_halfpoint_size( I<halfpoint_integer> );,
25591 $parser->header_halfpoint_size( I<halfpoint_integer> );,
25592 $parser->normal_halfpoint_size( I<halfpoint_integer> );,
25593 $parser->no_proofing_exemptions( I<true_or_false> );, $parser->doc_lang(
25594 I<microsoft_decimal_language_code> )
25598 =item COPYRIGHT AND DISCLAIMERS
25604 =head2 Pod::Simple::Search - find POD documents in directory trees
25616 $search->inc( I<true-or-false> );, $search->verbose( I<nonnegative-number>
25617 );, $search->limit_glob( I<some-glob-string> );, $search->callback(
25618 I<\&some_routine> );, $search->laborious( I<true-or-false> );,
25619 $search->shadows( I<true-or-false> );, $search->limit_re( I<some-regxp> );,
25620 $search->dir_prefix( I<some-string-value> );, $search->progress(
25621 I<some-progress-object> );, $name2path = $self->name2path;, $path2name =
25624 =item MAIN SEARCH METHODS
25628 =item C<< $search->survey( @directories ) >>
25630 C<name2path>, C<path2name>
25632 =item C<< $search->simplify_name( $str ) >>
25634 =item C<< $search->find( $pod ) >>
25636 =item C<< $search->find( $pod, @search_dirs ) >>
25638 =item C<< $self->contains_pod( $file ) >>
25648 =head2 Pod::Simple::Subclassing -- write a formatter as a Pod::Simple
25659 C<< $parser->_handle_element_start( I<element_name>, I<attr_hashref> ) >>,
25660 C<< $parser->_handle_element_end( I<element_name> ) >>, C<<
25661 $parser->_handle_text( I<text_string> ) >>, events with an element_name
25662 of Document, events with an element_name of Para, events with an
25663 element_name of B, C, F, or I, events with an element_name of S, events
25664 with an element_name of X, events with an element_name of L, events with an
25665 element_name of E or Z, events with an element_name of Verbatim, events
25666 with an element_name of head1 .. head4, events with an element_name of
25667 over-bullet, events with an element_name of over-number, events with an
25668 element_name of over-text, events with an element_name of over-block,
25669 events with an element_name of item-bullet, events with an element_name of
25670 item-number, events with an element_name of item-text, events with an
25671 element_name of for, events with an element_name of Data
25673 =item More Pod::Simple Methods
25675 C<< $parser->accept_targets( I<SOMEVALUE> ) >>, C<<
25676 $parser->accept_targets_as_text( I<SOMEVALUE> ) >>, C<<
25677 $parser->accept_codes( I<Codename>, I<Codename>... ) >>, C<<
25678 $parser->accept_directive_as_data( I<directive_name> ) >>, C<<
25679 $parser->accept_directive_as_verbatim( I<directive_name> ) >>, C<<
25680 $parser->accept_directive_as_processed( I<directive_name> ) >>, C<<
25681 $parser->nbsp_for_S( I<BOOLEAN> ); >>, C<< $parser->version_report() >>,
25682 C<< $parser->pod_para_count() >>, C<< $parser->line_count() >>, C<<
25683 $parser->nix_X_codes( I<SOMEVALUE> ) >>, C<< $parser->merge_text(
25684 I<SOMEVALUE> ) >>, C<< $parser->code_handler( I<CODE_REF> ) >>, C<<
25685 $parser->cut_handler( I<CODE_REF> ) >>, C<< $parser->whine(
25686 I<linenumber>, I<complaint string> ) >>, C<< $parser->scream(
25687 I<linenumber>, I<complaint string> ) >>, C<< $parser->source_dead(1) >>,
25688 C<< $parser->hide_line_numbers( I<SOMEVALUE> ) >>, C<< $parser->no_whining(
25689 I<SOMEVALUE> ) >>, C<< $parser->no_errata_section( I<SOMEVALUE> ) >>, C<<
25690 $parser->complain_stderr( I<SOMEVALUE> ) >>, C<< $parser->bare_output(
25691 I<SOMEVALUE> ) >>, C<< $parser->preserve_whitespace( I<SOMEVALUE> ) >>
25695 =item COPYRIGHT AND DISCLAIMERS
25701 =head2 Pod::Simple::Text -- format Pod as plaintext
25711 =item COPYRIGHT AND DISCLAIMERS
25717 =head2 Pod::Simple::TextContent -- get the text content of Pod
25727 =item COPYRIGHT AND DISCLAIMERS
25733 =head2 Pod::Simple::XMLOutStream -- turn Pod into XML
25743 =item ABOUT EXTENDING POD
25747 =item COPYRIGHT AND DISCLAIMERS
25753 =head2 Pod::SimpleTree, Pod::Simple::SimpleTree -- parse Pod into a simple
25764 =item Tree Contents
25768 =item COPYRIGHT AND DISCLAIMERS
25774 =head2 Pod::Text - Convert POD data to formatted ASCII text
25782 alt, code, indent, loose, margin, quotes, sentence, width
25786 Bizarre space in item, Item called without tag, Can't open %s for reading:
25787 %s, Invalid quote specification "%s"
25795 =item COPYRIGHT AND LICENSE
25799 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
25813 =item COPYRIGHT AND LICENSE
25817 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
25832 =item COPYRIGHT AND LICENSE
25836 =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
25851 =item COPYRIGHT AND LICENSE
25855 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
25864 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-sections>, C<-output>,
25865 C<-input>, C<-pathlist>, C<-noperldoc>
25873 =item Recommended Use
25881 =item ACKNOWLEDGEMENTS
25885 =head2 SDBM_File - Tied access to sdbm files
25893 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
25899 =item C<sdbm store returned -1, errno 22, key "..." at ...>
25903 =item BUGS AND WARNINGS
25907 =head2 Safe - Compile and execute code in restricted compartments
25915 a new namespace, an operator mask
25921 =item RECENT CHANGES
25923 =item Methods in class Safe
25925 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
25926 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
25927 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
25928 root (NAMESPACE), mask (MASK)
25930 =item Some Safety Issues
25932 Memory, CPU, Snooping, Signals, State Changes
25940 =head2 Scalar::Util - A selection of general-utility scalar subroutines
25948 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
25949 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
25950 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
25960 =head2 Search::Dict, look - search for key in dictionary file
25970 =head2 SelectSaver - save and restore selected file handle
25980 =head2 SelfLoader - load functions only on demand
25990 =item The __DATA__ token
25992 =item SelfLoader autoloading
25994 =item Autoloading and package lexicals
25996 =item SelfLoader and AutoLoader
25998 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
26000 =item Classes and inherited methods.
26004 =item Multiple packages and fully qualified subroutine names
26008 =head2 Shell - run shell commands transparently within perl
26020 =item Escaping Magic Characters
26022 =item Configuration
26032 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
26033 socket.h defines and structure manipulators
26041 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
26042 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
26043 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
26044 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
26045 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
26049 =head2 Storable - persistence for Perl data structures
26059 =item ADVISORY LOCKING
26063 =item CANONICAL REPRESENTATION
26065 =item CODE REFERENCES
26067 =item FORWARD COMPATIBILITY
26069 utf8 data, restricted hashes, files from future versions of Storable
26071 =item ERROR REPORTING
26079 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
26080 I<serialized>, .., C<STORABLE_attach> I<class>, I<cloning>, I<serialized>
26084 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
26085 C<Storable::is_retrieving>
26093 =item Storable magic
26095 $info = Storable::file_magic( $filename ), C<version>, C<version_nv>,
26096 C<major>, C<minor>, C<hdrsize>, C<netorder>, C<byteorder>, C<intsize>,
26097 C<longsize>, C<ptrsize>, C<nvsize>, C<file>, $info = Storable::read_magic(
26098 $buffer ), $info = Storable::read_magic( $buffer, $must_be_file )
26108 =item 64 bit data in perl 5.6.0 and 5.6.1
26120 =head2 Switch - A switch statement for Perl
26134 =item Allowing fall-through
26136 =item Automating fall-through
26138 =item Alternative syntax
26140 =item Higher-order Operations
26156 =head2 Symbol - manipulate Perl symbols and their names
26168 =head2 Sys::Hostname - Try every conceivable way to get hostname
26180 =head2 Syslog, Sys::Syslog - Perl interface to the UNIX syslog(3) calls
26194 B<openlog($ident, $logopt, $facility)>, B<syslog($priority, $message)>,
26195 B<syslog($priority, $format, @args)>, B<Note>,
26196 B<setlogmask($mask_priority)>, B<setlogsock($sock_type)>,
26197 B<setlogsock($sock_type, $stream_location)> (added in 5.004_02),
26214 Invalid argument passed to setlogsock, no connection to syslog available,
26215 stream passed to setlogsock, but %s is not writable, stream passed to
26216 setlogsock, but could not find any device, tcp passed to setlogsock, but
26217 tcp service unavailable, syslog: expecting argument %s, syslog: invalid
26218 level/facility: %s, syslog: too many levels given: %s, syslog: too many
26219 facilities given: %s, syslog: level must be given, udp passed to
26220 setlogsock, but udp service unavailable, unix passed to setlogsock, but
26231 AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request
26232 tracker, Search CPAN
26238 =head2 Syslog::Syslog, Sys::Syslog - Perl interface to the UNIX syslog(3)
26253 B<openlog($ident, $logopt, $facility)>, B<syslog($priority, $message)>,
26254 B<syslog($priority, $format, @args)>, B<Note>,
26255 B<setlogmask($mask_priority)>, B<setlogsock($sock_type)>,
26256 B<setlogsock($sock_type, $stream_location)> (added in 5.004_02),
26273 Invalid argument passed to setlogsock, no connection to syslog available,
26274 stream passed to setlogsock, but %s is not writable, stream passed to
26275 setlogsock, but could not find any device, tcp passed to setlogsock, but
26276 tcp service unavailable, syslog: expecting argument %s, syslog: invalid
26277 level/facility: %s, syslog: too many levels given: %s, syslog: too many
26278 facilities given: %s, syslog: level must be given, udp passed to
26279 setlogsock, but udp service unavailable, unix passed to setlogsock, but
26290 AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request
26291 tracker, Search CPAN
26297 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
26307 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
26308 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
26309 comma allowed after filehandle, No name for escape sequence %s
26313 ANSI_COLORS_DISABLED
26323 =item COPYRIGHT AND LICENSE
26327 =head2 Term::Cap - Perl termcap interface
26343 B<Tgetent>, OSPEED, TERM
26345 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
26347 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
26349 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
26357 =item COPYRIGHT AND LICENSE
26365 =head2 Term::Complete - Perl word completion module
26373 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
26383 =head2 Term::ReadLine - Perl interface to various C<readline> packages.
26384 If no real package is found, substitutes stubs instead of basic functions.
26392 =item Minimal set of supported functions
26394 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>,
26395 C<findConsole>, Attribs, C<Features>
26397 =item Additional supported functions
26399 C<tkRunning>, C<ornaments>, C<newTTY>
26409 =head2 Test - provides a simple framework for writing test scripts
26417 =item QUICK START GUIDE
26423 C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>,
26424 C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub>
26434 C<skip(I<skip_if_true>, I<args...>)>
26440 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
26444 =item BUGS and CAVEATS
26456 =head2 Test::Builder - Backend for building test libraries
26480 =item Setting up tests
26498 =item Running tests
26504 B<is_eq>, B<is_num>
26506 B<isnt_eq>, B<isnt_num>
26532 B<no_diag>, B<no_ending>, B<no_header>
26546 B<output>, B<failure_output>, B<todo_output>
26550 =item Test Status and Info
26586 =head2 Test::Builder::Module - Base class for test modules
26608 =head2 Test::Builder::Tester - test testsuites that have been built with
26631 test_test, title (synonym 'name', 'label'), skip_out, skip_err
26649 =head2 Test::Builder::Tester::Color - turn on colour in
26650 Test::Builder::Tester
26670 =head2 Test::Harness - Run Perl standard test scripts with statistics
26688 =item Configuration variables.
26690 C<$Test::Harness::Verbose>, C<$Test::Harness::switches>,
26691 C<$Test::Harness::Timer>
26695 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<List of Failed>
26703 =item runtests( @test_files )
26711 =item execute_tests( tests => \@test_files, out => \*FH )
26721 C<All tests successful.\nFiles=%d, Tests=%d, %s>, C<FAILED tests
26722 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
26723 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
26724 %s>, C<FAILED--Further testing stopped: %s>
26726 =item ENVIRONMENT VARIABLES THAT TEST::HARNESS SETS
26728 C<HARNESS_ACTIVE>, C<HARNESS_VERSION>
26730 =item ENVIRONMENT VARIABLES THAT AFFECT TEST::HARNESS
26732 C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>, C<HARNESS_DEBUG>,
26733 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_NOTTY>, C<HARNESS_PERL>,
26734 C<HARNESS_PERL_SWITCHES>, C<HARNESS_TIMER>, C<HARNESS_VERBOSE>
26746 AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request
26747 tracker, Search CPAN
26757 =head2 Test::Harness::Assert - simple assert
26783 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
26801 =head2 Test::Harness::Point - object for tracking a single test point
26819 =item from_test_line( $line )
26831 =head2 Test::Harness::Straps - detailed analysis of test results
26855 =item $strap->analyze( $name, \@output_lines )
26863 =item $strap->analyze_file( $test_file )
26885 =head2 Test::Harness::TAP - Documentation for the TAP format
26893 =item THE TAP FORMAT
26895 =item HARNESS BEHAVIOR
26897 =item TESTS LINES AND THE PLAN
26903 =item The test line
26905 C<ok> or C<not ok>, Test number, Description, Directive, ok/not ok
26906 (required), Test number (recommended), Description (recommended), Directive
26907 (only when necessary)
26917 =item Skipping tests
26929 =item Anything else
26937 =item Common with explanation
26939 =item Unknown amount and failures
26943 =item Skipping a few
26945 =item Skipping everything
26947 =item Got spare tuits?
26949 =item Creative liberties
26959 Specify a test plan, Run tests, Skip tests in certain situations, Have TODO
26960 tests, Produce TAP compatible diagnostics
26968 phpt, PHPUnit, SimpleTest, Apache-Test
26974 =item ACKNOWLEDGEMENTS
26980 =head2 Test::Harness::Util - Utility functions for Test::Harness::*
26986 =item PUBLIC FUNCTIONS
26990 =item all_in( {parm => value, parm => value} )
27000 =item shuffle( @list )
27010 =head2 Test::More - yet another framework for writing test scripts
27020 =item I love it when a plan comes together
27030 =item I'm ok, you're not ok.
27062 =item Complex data structures
27078 =item Conditional tests
27084 B<TODO: BLOCK>, B<todo_skip>
27086 When do I use SKIP vs. TODO?
27098 =item Discouraged comparison functions
27110 =item Extending and Embedding Test::More
27120 =item CAVEATS and NOTES
27122 Backwards compatibility, Overloaded objects, Threads, Test::Harness upgrade
27136 =head2 Test::Simple - Basic utilities for writing tests.
27160 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
27169 =head2 Test::Tutorial - A tutorial about writing really basic tests
27177 =item Nuts and bolts of testing.
27179 =item Where to start?
27183 =item Test the manual
27185 =item Sometimes the tests are wrong
27187 =item Testing lots of values
27189 =item Informative names
27191 =item Skipping tests
27195 =item Testing with taint mode.
27207 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
27219 =head2 Text::Balanced - Extract delimited text sequences from strings.
27229 =item General behaviour in list contexts
27233 =item General behaviour in scalar and void contexts
27235 =item A note about prefixes
27237 =item C<extract_delimited>
27239 =item C<extract_bracketed>
27241 =item C<extract_variable>
27245 =item C<extract_tagged>
27247 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
27248 [0], [1], [2], [3], [4], [5]
27250 =item C<gen_extract_tagged>
27252 =item C<extract_quotelike>
27254 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
27256 =item C<extract_quotelike> and "here documents"
27258 [0], [1], [2], [3], [4], [5], [6], [7..10]
27260 =item C<extract_codeblock>
27262 =item C<extract_multiple>
27264 =item C<gen_delimited_pat>
27266 =item C<delimited_pat>
27272 C<Did not find a suitable bracket: "%s">, C<Did not find prefix: /%s/>,
27273 C<Did not find opening bracket after prefix: "%s">, C<No quotelike
27274 operator found after prefix: "%s">, C<Unmatched closing bracket: "%c">,
27275 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
27276 C<Did not find closing delimiter to match '%s'>, C<Mismatched closing
27277 bracket: expected "%c" but found "%s">, C<No block delimiter found after
27278 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
27279 after dereferencer>, C<Did not find expected opening bracket at %s>,
27280 C<Improperly nested codeblock at %s>, C<Missing second block for quotelike
27281 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
27282 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
27283 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
27288 =item BUGS AND IRRITATIONS
27294 =head2 Text::ParseWords - parse text into an array of tokens or array of
27309 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
27326 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
27341 =head2 Text::Wrap - line wrapping to form simple paragraphs
27357 =head2 Thread - manipulate threads in Perl (for old code only)
27369 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
27370 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
27371 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
27375 join, eval, detach, equal, tid, flags, done
27383 =head2 Thread::Queue - thread-safe queues
27391 =item FUNCTIONS AND METHODS
27393 new, enqueue LIST, dequeue, dequeue_nb, pending
27399 =head2 Thread::Semaphore - thread-safe semaphores
27407 =item FUNCTIONS AND METHODS
27409 new, new NUMBER, down, down NUMBER, up, up NUMBER
27413 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
27428 =head2 Thread::Specific - thread-specific keys
27438 =head2 Tie::Array - base class for tied arrays
27446 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
27447 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
27448 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
27449 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
27457 =head2 Tie::File - Access the lines of a disk file via a Perl array
27477 =item Option Format
27481 =item Public Methods
27489 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
27495 =item Tying to an already-opened filehandle
27497 =item Deferred Writing
27501 =item Autodeferring
27505 =item CONCURRENT ACCESS TO FILES
27511 =item WHAT ABOUT C<DB_File>?
27525 =head2 Tie::Handle, Tie::StdHandle - base class definitions for tied
27534 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
27535 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
27536 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
27537 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
27539 =item MORE INFORMATION
27541 =item COMPATIBILITY
27545 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
27554 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
27555 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR
27558 =item Inheriting from B<Tie::StdHash>
27560 =item Inheriting from B<Tie::ExtraHash>
27562 =item C<SCALAR>, C<UNTIE> and C<DESTROY>
27564 =item MORE INFORMATION
27568 =head2 Tie::Memoize - add data to hash when needed
27576 =item Inheriting from B<Tie::Memoize>
27586 =head2 Tie::RefHash - use references as hash keys
27596 =item THREAD SUPPORT
27598 =item STORABLE SUPPORT
27600 =item RELIC SUPPORT
27610 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
27619 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
27621 =item MORE INFORMATION
27625 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
27637 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
27646 gettimeofday (), usleep ( $useconds ), nanosleep ( $nanoseconds ), ualarm (
27647 $useconds [, $interval_useconds ] ), tv_interval, time (), sleep (
27648 $floating_seconds ), alarm ( $floating_seconds [,
27649 $interval_floating_seconds ] ), setitimer ( $which, $floating_seconds [,
27650 $interval_floating_seconds ] ), getitimer ( $which ), clock_gettime (
27651 $which ), clock_getres ( $which ), clock_nanosleep ( $which, $seconds,
27652 $flags = 0), clock()
27662 =item negative time not invented yet
27664 =item internal error: useconds < 0 (unsigned ... signed ...)
27674 =item COPYRIGHT AND LICENSE
27678 =head2 Time::Local - efficiently compute time from local and GMT time
27688 =item Ambiguous Local Times (DST)
27690 =item Non-Existent Local Times (DST)
27692 =item Negative Epoch Values
27696 =item IMPLEMENTATION
27706 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
27721 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
27736 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
27748 =head2 UNIVERSAL - base class for ALL classes (blessed references)
27756 C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<< eval { VAL->isa(
27757 TYPE ) } >>, C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD )
27758 >>, C<< CLASS->can( METHOD ) >>, C<< eval { VAL->can( METHOD ) } >>,
27759 C<VERSION ( [ REQUIRE ] )>
27765 =head2 Unicode::Collate - Unicode Collation Algorithm
27775 =item Constructor and Tailoring
27777 UCA_Version, alternate, backwards, entry, hangul_terminator, ignoreChar,
27778 ignoreName, katakana_before_hiragana, level, normalization, overrideCJK,
27779 overrideHangul, preprocess, rearrange, table, undefChar, undefName,
27780 upper_before_lower, variable
27782 =item Methods for Collation
27784 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
27785 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
27786 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
27787 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
27788 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
27789 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
27790 $Collator-E<gt>viewSortKey($string)>
27792 =item Methods for Searching
27794 C<$position = $Collator-E<gt>index($string, $substring[, $position])>,
27795 C<($position, $length) = $Collator-E<gt>index($string, $substring[,
27796 $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>,
27797 C<($match) = $Collator-E<gt>match($string, $substring)>, C<@match =
27798 $Collator-E<gt>gmatch($string, $substring)>, C<$count =
27799 $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count =
27800 $Collator-E<gt>gsubst($string, $substring, $replacement)>
27802 =item Other Methods
27804 C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, C<$version =
27805 $Collator-E<gt>version()>, C<UCA_Version()>, C<Base_Unicode_Version()>
27815 Normalization, Conformance Test
27817 =item AUTHOR, COPYRIGHT AND LICENSE
27821 Unicode Collation Algorithm - UTS #10, The Default Unicode Collation
27822 Element Table (DUCET), The conformance test for the UCA, Hangul Syllable
27823 Type, Unicode Normalization Forms - UAX #15
27827 =head2 Unicode::Normalize - Unicode Normalization Forms
27837 =item Normalization Forms
27839 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
27840 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
27841 C<$FCD_string = FCD($string)>, C<$FCC_string = FCC($string)>,
27842 C<$normalized_string = normalize($form_name, $string)>
27844 =item Decomposition and Composition
27846 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
27847 decompose($string, $useCompatMapping)>, C<$reordered_string =
27848 reorder($string)>, C<$composed_string = compose($string)>
27852 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
27853 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
27854 checkFCD($string)>, C<$result = checkFCC($string)>, C<$result =
27855 check($form_name, $string)>
27857 =item Character Data
27859 C<$canonical_decomposed = getCanon($codepoint)>,
27860 C<$compatibility_decomposed = getCompat($codepoint)>,
27861 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
27862 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
27863 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
27864 C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>,
27865 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
27873 Perl's version vs. Unicode version, Correction of decomposition mapping,
27874 Revised definition of canonical composition
27880 http://www.unicode.org/reports/tr15/,
27881 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt,
27882 http://www.unicode.org/Public/UNIDATA/NormalizationCorrections.txt,
27883 http://www.unicode.org/review/pr-29.html, http://www.unicode.org/notes/tn5/
27887 =head2 Unicode::UCD - Unicode character database
27929 =item Blocks versus Scripts
27931 =item Matching Scripts and Blocks
27933 =item Code Point Arguments
27965 =item Unicode::UCD::UnicodeVersion
27971 =item Implementation Note
27983 =head2 User::grent - by-name interface to Perl's built-in getgr*()
27998 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
28009 =item System Specifics
28023 =head2 XSLoader - Dynamically load C libraries into Perl code
28035 =item Migration from C<DynaLoader>
28037 =item Backward compatible boilerplate
28041 =item Order of initialization: early load()
28045 =item The most hairy case
28051 Can't find '%s' symbol in %s, Can't load '%s' for module %s: %s, Undefined
28052 symbols present after loading %s: %s, XSLoader::load('Your::Module',
28053 $Your::Module::VERSION)
28067 =head1 AUXILIARY DOCUMENTATION
28069 Here should be listed all the extra programs' documentation, but they
28070 don't all have manual pages yet:
28104 Larry Wall <F<larry@wall.org>>, with the help of oodles