Track /etc/gitconfig
[msysgit.git] / lib / perl5 / 5.8.8 / pods / perltoc.pod
blob3787686312c466ef4cfa626f06cc3a77d3f0e391
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.
6 =head1 NAME
8 perltoc - perl documentation table of contents
10 =head1 DESCRIPTION
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
20 =over 4
22 =item SYNOPSIS
24 =over 4
26 =item Overview
28 =item Tutorials
30 =item Reference Manual
32 =item Internals and C Language Interface
34 =item Miscellaneous
36 =item Language-Specific
38 =item Platform-Specific
40 =back
42 =item DESCRIPTION
44 =item AVAILABILITY
46 =item ENVIRONMENT
48 =item AUTHOR
50 =item FILES
52 =item SEE ALSO
54 =item DIAGNOSTICS
56 =item BUGS
58 =item NOTES
60 =back
62 =head2 perlintro -- a brief introduction and overview of Perl
64 =over 4
66 =item DESCRIPTION
68 =over 4
70 =item What is 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,
89 Miscellaneous
91 =item Files and I/O
93 =item Regular expressions
95 Simple matching, Simple substitution, More complex regular expressions,
96 Parentheses for capturing, Other regexp features
98 =item Writing subroutines
100 =item OO Perl
102 =item Using Perl modules
104 =back
106 =item AUTHOR
108 =back
110 =head2 perlreftut - Mark's very short tutorial about references
112 =over 4
114 =item DESCRIPTION
116 =item Who Needs Complicated Data Structures?
118 =item The Solution
120 =item Syntax
122 =over 4
124 =item Making References
126 =item Using References
128 =item An Example
130 =item Arrow Rule
132 =back
134 =item Solution
136 =item The Rest
138 =item Summary
140 =item Credits
142 =over 4
144 =item Distribution Conditions
146 =back
148 =back
150 =head2 perldsc - Perl Data Structures Cookbook
152 =over 4
154 =item DESCRIPTION
156 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
157 more elaborate constructs
159 =item REFERENCES
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>
169 =item DEBUGGING
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>
175 =item CODE EXAMPLES
177 =item ARRAYS OF ARRAYS
178 X<array of arrays> X<AoA>
180 =over 4
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
188 =back
190 =item HASHES OF ARRAYS
191 X<hash of arrays> X<HoA>
193 =over 4
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
201 =back
203 =item ARRAYS OF HASHES
204 X<array of hashes> X<AoH>
206 =over 4
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
214 =back
216 =item HASHES OF HASHES
217 X<hass of hashes> X<HoH>
219 =over 4
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
227 =back
229 =item MORE ELABORATE RECORDS
230 X<record> X<structure> X<struct>
232 =over 4
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
240 =back
242 =item Database Ties
244 =item SEE ALSO
246 =item AUTHOR
248 =back
250 =head2 perllol - Manipulating Arrays of Arrays in Perl
252 =over 4
254 =item DESCRIPTION
256 =over 4
258 =item Declaration and Access of Arrays of Arrays
260 =item Growing Your Own
262 =item Access and Printing
264 =item Slices
266 =back
268 =item SEE ALSO
270 =item AUTHOR
272 =back
274 =head2 perlrequick - Perl regular expressions quick start
276 =over 4
278 =item DESCRIPTION
280 =item The Guide
282 =over 4
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
296 =item More matching
298 =item Search and replace
300 =item The split operator
302 =back
304 =item BUGS
306 =item SEE ALSO
308 =item AUTHOR AND COPYRIGHT
310 =over 4
312 =item Acknowledgments
314 =back
316 =back
318 =head2 perlretut - Perl regular expressions tutorial
320 =over 4
322 =item DESCRIPTION
324 =item Part 1: The basics
326 =over 4
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
344 =back
346 =item Part 2: Power tools
348 =over 4
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
368 =back
370 =item BUGS
372 =item SEE ALSO
374 =item AUTHOR AND COPYRIGHT
376 =over 4
378 =item Acknowledgments
380 =back
382 =back
384 =head2 perlboot - Beginner's Object-Oriented Tutorial
386 =over 4
388 =item DESCRIPTION
390 =over 4
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
432 =item Summary
434 =back
436 =item SEE ALSO
438 =item COPYRIGHT
440 =back
442 =head2 perltoot - Tom's object-oriented tutorial for perl
444 =over 4
446 =item DESCRIPTION
448 =item Creating a Class
450 =over 4
452 =item Object Representation
454 =item Class Interface
456 =item Constructors and Instance Methods
458 =item Planning for the Future: Better Constructors
460 =item Destructors
462 =item Other Object Methods
464 =back
466 =item Class Data
468 =over 4
470 =item Accessing Class Data
472 =item Debugging Methods
474 =item Class Destructors
476 =item Documenting the Interface
478 =back
480 =item Aggregation
482 =item Inheritance
484 =over 4
486 =item Overridden Methods
488 =item Multiple Inheritance
490 =item UNIVERSAL: The Root of All Objects
492 =back
494 =item Alternate Object Representations
496 =over 4
498 =item Arrays as Objects
500 =item Closures as Objects
502 =back
504 =item AUTOLOAD: Proxy Methods
506 =over 4
508 =item Autoloaded Data Methods
510 =item Inherited Autoloaded Data Methods
512 =back
514 =item Metaclassical Tools
516 =over 4
518 =item Class::Struct
520 =item Data Members as Variables
522 =back
524 =item NOTES
526 =over 4
528 =item Object Terminology
530 =back
532 =item SEE ALSO
534 =item AUTHOR AND COPYRIGHT
536 =item COPYRIGHT
538 =over 4
540 =item Acknowledgments
542 =back
544 =back
546 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
548 =over 4
550 =item DESCRIPTION
552 =item Class Data in a Can
554 =item Class Data as Package Variables
556 =over 4
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
570 =back
572 =item Class Data as Lexical Variables
574 =over 4
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
586 =back
588 =item NOTES
590 =item SEE ALSO
592 =item AUTHOR AND COPYRIGHT
594 =item ACKNOWLEDGEMENTS
596 =item HISTORY
598 =back
600 =head2 perlbot - Bag'o Object Tricks (the BOT)
602 =over 4
604 =item DESCRIPTION
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
626 =item DELEGATION
628 =item SEE ALSO
630 =back
632 =head2 perlstyle - Perl style guide
634 =over 4
636 =item DESCRIPTION
638 =back
640 =head2 perlcheat - Perl 5 Cheat Sheet
642 =over 4
644 =item DESCRIPTION
646 =over 4
648 =item The sheet
650 =back
652 =item ACKNOWLEDGEMENTS
654 =item AUTHOR
656 =item SEE ALSO
658 =back
660 =head2 perltrap - Perl traps for the unwary
662 =over 4
664 =item DESCRIPTION
666 =over 4
668 =item Awk Traps
670 =item C/C++ Traps
672 =item Sed Traps
674 =item Shell Traps
676 =item Perl Traps
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
696 =item Parsing Traps
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
746 =item OS Traps
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
760 =item DBM Traps
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
764 exit immediately
766 =item Unclassified Traps
768 C<require>/C<do> trap using returned value, C<split> on empty string with
769 LIMIT specified
771 =back
773 =back
775 =head2 perldebtut - Perl debugging tutorial
777 =over 4
779 =item DESCRIPTION
781 =item use strict
783 =item Looking at data and -w and v
785 =item help
787 =item Stepping through code
789 =item Placeholder for a, w, t, T
791 =item REGULAR EXPRESSIONS
793 =item OUTPUT TIPS
795 =item CGI
797 =item GUIs
799 =item SUMMARY
801 =item SEE ALSO
803 =item AUTHOR
805 =item CONTRIBUTORS
807 =back
809 =head2 perlfaq - frequently asked questions about Perl ($Date: 2005/12/30
810 15:04:07 $)
812 =over 4
814 =item DESCRIPTION
816 =over 4
818 =item Where to get the perlfaq
820 =item How to contribute to the perlfaq
822 =item What will happen if you mail your Perl programming problems to the
823 authors
825 =back
827 =item Credits
829 =item Author and Copyright Information
831 =over 4
833 =item Bundled Distributions
835 =item Disclaimer
837 =back
839 =item Table of Contents
841 perlfaq  - this document, perlfaq1 - General Questions About Perl, perlfaq2
842 - Obtaining and Learning about Perl, perlfaq3 - Programming Tools, perlfaq4
843 - Data Manipulation, perlfaq5 - Files and Formats, perlfaq6 - Regular
844 Expressions, perlfaq7 - General Perl Language Issues, perlfaq8 - System
845 Interaction, perlfaq9 - Networking
847 =item The Questions
849 =over 4
851 =item L<perlfaq1>: General Questions About Perl
853 =item L<perlfaq2>: Obtaining and Learning about Perl
855 =item L<perlfaq3>: Programming Tools
857 =item L<perlfaq4>: Data Manipulation
859 =item L<perlfaq5>: Files and Formats
861 =item L<perlfaq6>: Regular Expressions
863 =item L<perlfaq7>: General Perl Language Issues
865 =item L<perlfaq8>: System Interaction
867 =item L<perlfaq9>: Networking
869 =back
871 =back
873 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.19 $, $Date:
874 2005/12/31 00:54:37 $)
876 =over 4
878 =item DESCRIPTION
880 =over 4
882 =item What is Perl?
884 =item Who supports Perl?  Who develops it?  Why is it free?
886 =item Which version of Perl should I use?
888 =item What are perl4, perl5, or perl6?
890 =item What is Ponie?
892 =item What is perl6?
894 =item How stable is Perl?
896 =item Is Perl difficult to learn?
898 =item How does Perl compare with other languages like Java, Python, REXX,
899 Scheme, or Tcl?
901 =item Can I do [task] in Perl?
903 =item When shouldn't I program in Perl?
905 =item What's the difference between "perl" and "Perl"?
907 =item Is it a Perl program or a Perl script?
909 =item What is a JAPH?
911 =item Where can I get a list of Larry Wall witticisms?
913 =item How can I convince my sysadmin/supervisor/employees to use version
914 5/5.6.1/Perl instead of some other language?
916 =back
918 =item AUTHOR AND COPYRIGHT
920 =back
922 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.38 $,
923 $Date: 2005/12/31 00:54:37 $)
925 =over 4
927 =item DESCRIPTION
929 =over 4
931 =item What machines support perl?  Where do I get it?
933 =item How can I get a binary version of perl?
935 =item I don't have a C compiler. How can I build my own Perl interpreter?
937 =item I copied the perl binary from one machine to another, but scripts
938 don't work.
940 =item I grabbed the sources and tried to compile but gdbm/dynamic
941 loading/malloc/linking/... failed.  How do I make it work?
943 =item What modules and extensions are available for Perl?  What is CPAN? 
944 What does CPAN/src/... mean?
946 =item Is there an ISO or ANSI certified version of Perl?
948 =item Where can I get information on Perl?
950 =item What are the Perl newsgroups on Usenet?  Where do I post questions?
952 =item Where should I post source code?
954 =item Perl Books
956 References, Tutorials, Task-Oriented, Special Topics
958 =item Perl in Magazines
960 =item Perl on the Net: FTP and WWW Access
962 =item What mailing lists are there for Perl?
964 =item Archives of comp.lang.perl.misc
966 =item Where can I buy a commercial version of perl?
968 =item Where do I send bug reports?
970 =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
972 =back
974 =item AUTHOR AND COPYRIGHT
976 =back
978 =head2 perlfaq3 - Programming Tools ($Revision: 1.56 $, $Date: 2005/12/31
979 00:54:37 $)
981 =over 4
983 =item DESCRIPTION
985 =over 4
987 =item How do I do (anything)?
989 =item How can I use Perl interactively?
991 =item Is there a Perl shell?
993 =item How do I find which modules are installed on my system?
995 =item How do I debug my Perl programs?
997 =item How do I profile my Perl programs?
999 =item How do I cross-reference my Perl programs?
1001 =item Is there a pretty-printer (formatter) for Perl?
1003 =item Is there a ctags for Perl?
1005 =item Is there an IDE or Windows Perl Editor?
1007 Eclipse, Enginsite, Komodo, Open Perl IDE, OptiPerl, PerlBuilder,
1008 visiPerl+, Visual Perl, Zeus, GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis,
1009 Vile, Vim, Codewright, MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, Affrus,
1010 Alpha, BBEdit and BBEdit Lite
1012 =item Where can I get Perl macros for vi?
1014 =item Where can I get perl-mode for emacs?
1016 =item How can I use curses with Perl?
1018 =item How can I use X or Tk with Perl?
1020 =item How can I make my Perl program run faster?
1022 =item How can I make my Perl program take less memory?
1024 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
1025 stringification, Pass by reference, Tie large variables to disk
1027 =item Is it safe to return a reference to local or lexical data?
1029 =item How can I free an array or hash so my program shrinks?
1031 =item How can I make my CGI script more efficient?
1033 =item How can I hide the source for my Perl program?
1035 =item How can I compile my Perl program into byte code or C?
1037 =item How can I compile Perl into Java?
1039 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
1041 =item Can I write useful Perl programs on the command line?
1043 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
1045 =item Where can I learn about CGI or Web programming in Perl?
1047 =item Where can I learn about object-oriented Perl programming?
1049 =item Where can I learn about linking C with Perl?
1051 =item I've read perlembed, perlguts, etc., but I can't embed perl in my C
1052 program; what am I doing wrong?
1054 =item When I tried to run my script, I got this message. What does it mean?
1056 =item What's MakeMaker?
1058 =back
1060 =item AUTHOR AND COPYRIGHT
1062 =back
1064 =head2 perlfaq4 - Data Manipulation ($Revision: 1.73 $, $Date: 2005/12/31
1065 00:54:37 $)
1067 =over 4
1069 =item DESCRIPTION
1071 =item Data: Numbers
1073 =over 4
1075 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
1076 numbers I should be getting (eg, 19.95)?
1078 =item Why is int() broken?
1080 =item Why isn't my octal data interpreted correctly?
1082 =item Does Perl have a round() function?  What about ceil() and floor()? 
1083 Trig functions?
1085 =item How do I convert between numeric representations/bases/radixes?
1087 How do I convert hexadecimal into decimal, How do I convert from decimal to
1088 hexadecimal, How do I convert from octal to decimal, How do I convert from
1089 decimal to octal, How do I convert from binary to decimal, How do I convert
1090 from decimal to binary
1092 =item Why doesn't & work the way I want it to?
1094 =item How do I multiply matrices?
1096 =item How do I perform an operation on a series of integers?
1098 =item How can I output Roman numerals?
1100 =item Why aren't my random numbers random?
1102 =item How do I get a random number between X and Y?
1104 =back
1106 =item Data: Dates
1108 =over 4
1110 =item How do I find the day or week of the year?
1112 =item How do I find the current century or millennium?
1114 =item How can I compare two dates and find the difference?
1116 =item How can I take a string and turn it into epoch seconds?
1118 =item How can I find the Julian Day?
1120 =item How do I find yesterday's date?
1122 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
1124 =back
1126 =item Data: Strings
1128 =over 4
1130 =item How do I validate input?
1132 =item How do I unescape a string?
1134 =item How do I remove consecutive pairs of characters?
1136 =item How do I expand function calls in a string?
1138 =item How do I find matching/nesting anything?
1140 =item How do I reverse a string?
1142 =item How do I expand tabs in a string?
1144 =item How do I reformat a paragraph?
1146 =item How can I access or change N characters of a string?
1148 =item How do I change the Nth occurrence of something?
1150 =item How can I count the number of occurrences of a substring within a
1151 string?
1153 =item How do I capitalize all the words on one line?
1155 =item How can I split a [character] delimited string except when inside
1156 [character]?
1158 =item How do I strip blank space from the beginning/end of a string?
1160 =item How do I pad a string with blanks or pad a number with zeroes?
1162 =item How do I extract selected columns from a string?
1164 =item How do I find the soundex value of a string?
1166 =item How can I expand variables in text strings?
1168 =item What's wrong with always quoting "$vars"?
1170 =item Why don't my E<lt>E<lt>HERE documents work?
1172 There must be no space after the E<lt>E<lt> part, There (probably) should
1173 be a semicolon at the end, You can't (easily) have any space in front of
1174 the tag
1176 =back
1178 =item Data: Arrays
1180 =over 4
1182 =item What is the difference between a list and an array?
1184 =item What is the difference between $array[1] and @array[1]?
1186 =item How can I remove duplicate elements from a list or array?
1188 =item How can I tell whether a certain element is contained in a list or
1189 array?
1191 =item How do I compute the difference of two arrays?  How do I compute the
1192 intersection of two arrays?
1194 =item How do I test whether two arrays or hashes are equal?
1196 =item How do I find the first array element for which a condition is true?
1198 =item How do I handle linked lists?
1200 =item How do I handle circular lists?
1202 =item How do I shuffle an array randomly?
1204 =item How do I process/modify each element of an array?
1206 =item How do I select a random element from an array?
1208 =item How do I permute N elements of a list?
1210 =item How do I sort an array by (anything)?
1212 =item How do I manipulate arrays of bits?
1214 =item Why does defined() return true on empty arrays and hashes?
1216 =back
1218 =item Data: Hashes (Associative Arrays)
1220 =over 4
1222 =item How do I process an entire hash?
1224 =item What happens if I add or remove keys from a hash while iterating over
1227 =item How do I look up a hash element by value?
1229 =item How can I know how many entries are in a hash?
1231 =item How do I sort a hash (optionally by value instead of key)?
1233 =item How can I always keep my hash sorted?
1235 =item What's the difference between "delete" and "undef" with hashes?
1237 =item Why don't my tied hashes make the defined/exists distinction?
1239 =item How do I reset an each() operation part-way through?
1241 =item How can I get the unique keys from two hashes?
1243 =item How can I store a multidimensional array in a DBM file?
1245 =item How can I make my hash remember the order I put elements into it?
1247 =item Why does passing a subroutine an undefined element in a hash create
1250 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
1251 array of hashes or arrays?
1253 =item How can I use a reference as a hash key?
1255 =back
1257 =item Data: Misc
1259 =over 4
1261 =item How do I handle binary data correctly?
1263 =item How do I determine whether a scalar is a number/whole/integer/float?
1265 =item How do I keep persistent data across program calls?
1267 =item How do I print out or copy a recursive data structure?
1269 =item How do I define methods for every class/object?
1271 =item How do I verify a credit card checksum?
1273 =item How do I pack arrays of doubles or floats for XS code?
1275 =back
1277 =item AUTHOR AND COPYRIGHT
1279 =back
1281 =head2 perlfaq5 - Files and Formats ($Revision: 1.42 $, $Date: 2005/12/31
1282 00:54:37 $)
1284 =over 4
1286 =item DESCRIPTION
1288 =over 4
1290 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
1291 X<flush> X<buffer> X<unbuffer> X<autoflush>
1293 =item How do I change one line in a file/delete a line in a file/insert a
1294 line in the middle of a file/append to the beginning of a file?
1295 X<file, editing>
1297 =item How do I count the number of lines in a file?
1298 X<file, counting lines> X<lines> X<line>
1300 =item How can I use Perl's C<-i> option from within a program?
1301 X<-i> X<in-place>
1303 =item How can I copy a file?
1304 X<copy> X<file, copy>
1306 =item How do I make a temporary file name?
1307 X<file, temporary>
1309 =item How can I manipulate fixed-record-length files?
1310 X<fixed-length> X<file, fixed-length records>
1312 =item How can I make a filehandle local to a subroutine?  How do I pass
1313 filehandles between subroutines?  How do I make an array of filehandles?
1314 X<filehandle, local> X<filehandle, passing> X<filehandle, reference>
1316 =item How can I use a filehandle indirectly?
1317 X<filehandle, indirect>
1319 =item How can I set up a footer format to be used with write()?
1320 X<footer>
1322 =item How can I write() into a string?
1323 X<write, into a string>
1325 =item How can I output my numbers with commas added?
1326 X<number, commify>
1328 =item How can I translate tildes (~) in a filename?
1329 X<tilde> X<tilde expansion>
1331 =item How come when I open a file read-write it wipes it out?
1332 X<clobber> X<read-write> X<clobbering> X<truncate> X<truncating>
1334 =item Why do I sometimes get an "Argument list too long" when I use
1335 E<lt>*E<gt>?
1336 X<argument list too long>
1338 =item Is there a leak/bug in glob()?
1339 X<glob>
1341 =item How can I open a file with a leading ">" or trailing blanks?
1342 X<filename, special characters>
1344 =item How can I reliably rename a file?
1345 X<rename> X<mv> X<move> X<file, rename> X<ren>
1347 =item How can I lock a file?
1348 X<lock> X<file, lock> X<flock>
1350 =item Why can't I just open(FH, "E<gt>file.lock")?
1351 X<lock, lockfile race condition>
1353 =item I still don't get locking.  I just want to increment the number in
1354 the file.  How can I do this?
1355 X<counter> X<file, counter>
1357 =item All I want to do is append a small amount of text to the end of a
1358 file.  Do I still have to use locking?
1359 X<append> X<file, append>
1361 =item How do I randomly update a binary file?
1362 X<file, binary patch>
1364 =item How do I get a file's timestamp in perl?
1365 X<timestamp> X<file, timestamp>
1367 =item How do I set a file's timestamp in perl?
1368 X<timestamp> X<file, timestamp>
1370 =item How do I print to more than one file at once?
1371 X<print, to multiple files>
1373 =item How can I read in an entire file all at once?
1374 X<slurp> X<file, slurping>
1376 =item How can I read in a file by paragraphs?
1377 X<file, reading by paragraphs>
1379 =item How can I read a single character from a file?  From the keyboard?
1380 X<getc> X<file, reading one character at a time>
1382 =item How can I tell whether there's a character waiting on a filehandle?
1384 =item How do I do a C<tail -f> in perl?
1385 X<tail>
1387 =item How do I dup() a filehandle in Perl?
1388 X<dup>
1390 =item How do I close a file descriptor by number?
1391 X<file, closing file descriptors>
1393 =item Why can't I use "C:\temp\foo" in DOS paths?  Why doesn't
1394 `C:\temp\foo.exe` work?
1395 X<filename, DOS issues>
1397 =item Why doesn't glob("*.*") get all the files?
1398 X<glob>
1400 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
1401 protected files?  Isn't this a bug in Perl?
1403 =item How do I select a random line from a file?
1404 X<file, selecting a random line>
1406 =item Why do I get weird spaces when I print an array of lines?
1408 =back
1410 =item AUTHOR AND COPYRIGHT
1412 =back
1414 =head2 perlfaq6 - Regular Expressions ($Revision: 1.38 $, $Date: 2005/12/31
1415 00:54:37 $)
1417 =over 4
1419 =item DESCRIPTION
1421 =over 4
1423 =item How can I hope to use regular expressions without creating illegible
1424 and unmaintainable code?
1425 X<regex, legibility> X<regexp, legibility>
1426 X<regular expression, legibility> X</x>
1428 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
1430 =item I'm having trouble matching over more than one line.  What's wrong?
1431 X<regex, multiline> X<regexp, multiline> X<regular expression, multiline>
1433 =item How can I pull out lines between two patterns that are themselves on
1434 different lines?
1435 X<..>
1437 =item I put a regular expression into $/ but it didn't work. What's wrong?
1438 X<$/, regexes in> X<$INPUT_RECORD_SEPARATOR, regexes in>
1439 X<$RS, regexes in>
1441 =item How do I substitute case insensitively on the LHS while preserving
1442 case on the RHS?
1443 X<replace, case preserving> X<substitute, case preserving>
1444 X<substitution, case preserving> X<s, case preserving>
1446 =item How can I make C<\w> match national character sets?
1447 X<\w>
1449 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
1450 X<alpha>
1452 =item How can I quote a variable to use in a regex?
1453 X<regex, escaping> X<regexp, escaping> X<regular expression, escaping>
1455 =item What is C</o> really for?
1456 X</o>
1458 =item How do I use a regular expression to strip C style comments from a
1459 file?
1461 =item Can I use Perl regular expressions to match balanced text?
1462 X<regex, matching balanced test> X<regexp, matching balanced test>
1463 X<regular expression, matching balanced test>
1465 =item What does it mean that regexes are greedy?  How can I get around it?
1466 X<greedy> X<greediness>
1468 =item How do I process each word on each line?
1469 X<word>
1471 =item How can I print out a word-frequency or line-frequency summary?
1473 =item How can I do approximate matching?
1474 X<match, approximate> X<matching, approximate>
1476 =item How do I efficiently match many regular expressions at once?
1477 X<regex, efficiency> X<regexp, efficiency>
1478 X<regular expression, efficiency>
1480 =item Why don't word-boundary searches with C<\b> work for me?
1481 X<\b>
1483 =item Why does using $&, $`, or $' slow my program down?
1484 X<$MATCH> X<$&> X<$POSTMATCH> X<$'> X<$PREMATCH> X<$`>
1486 =item What good is C<\G> in a regular expression?
1487 X<\G>
1489 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
1490 X<DFA> X<NFA> X<POSIX>
1492 =item What's wrong with using grep in a void context?
1493 X<grep>
1495 =item How can I match strings with multibyte characters?
1496 X<regex, and multibyte characters> X<regexp, and multibyte characters>
1497 X<regular expression, and multibyte characters>
1499 =item How do I match a pattern that is supplied by the user?
1501 =back
1503 =item AUTHOR AND COPYRIGHT
1505 =back
1507 =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.28 $, $Date:
1508 2005/12/31 00:54:37 $)
1510 =over 4
1512 =item DESCRIPTION
1514 =over 4
1516 =item Can I get a BNF/yacc/RE for the Perl language?
1518 =item What are all these $@%&* punctuation signs, and how do I know when to
1519 use them?
1521 =item Do I always/never have to quote my strings or use semicolons and
1522 commas?
1524 =item How do I skip some return values?
1526 =item How do I temporarily block warnings?
1528 =item What's an extension?
1530 =item Why do Perl operators have different precedence than C operators?
1532 =item How do I declare/create a structure?
1534 =item How do I create a module?
1536 =item How do I create a class?
1538 =item How can I tell if a variable is tainted?
1540 =item What's a closure?
1542 =item What is variable suicide and how can I prevent it?
1544 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
1545 Regex}?
1547 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
1548 Passing Methods
1550 =item How do I create a static variable?
1552 =item What's the difference between dynamic and lexical (static) scoping? 
1553 Between local() and my()?
1555 =item How can I access a dynamic variable while a similarly named lexical
1556 is in scope?
1558 =item What's the difference between deep and shallow binding?
1560 =item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?
1562 =item How do I redefine a builtin function, operator, or method?
1564 =item What's the difference between calling a function as &foo and foo()?
1566 =item How do I create a switch or case statement?
1568 =item How can I catch accesses to undefined variables, functions, or
1569 methods?
1571 =item Why can't a method included in this same file be found?
1573 =item How can I find out my current package?
1575 =item How can I comment out a large block of perl code?
1577 =item How do I clear a package?
1579 =item How can I use a variable as a variable name?
1581 =item What does "bad interpreter" mean?
1583 =back
1585 =item AUTHOR AND COPYRIGHT
1587 =back
1589 =head2 perlfaq8 - System Interaction ($Revision: 1.27 $, $Date: 2005/12/31
1590 00:54:37 $)
1592 =over 4
1594 =item DESCRIPTION
1596 =over 4
1598 =item How do I find out which operating system I'm running under?
1600 =item How come exec() doesn't return?
1602 =item How do I do fancy stuff with the keyboard/screen/mouse?
1604 Keyboard, Screen, Mouse
1606 =item How do I print something out in color?
1608 =item How do I read just one key without waiting for a return key?
1610 =item How do I check whether input is ready on the keyboard?
1612 =item How do I clear the screen?
1614 =item How do I get the screen size?
1616 =item How do I ask the user for a password?
1618 =item How do I read and write the serial port?
1620 lockfiles, open mode, end of line, flushing output, non-blocking input
1622 =item How do I decode encrypted password files?
1624 =item How do I start a process in the background?
1626 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
1628 =item How do I trap control characters/signals?
1630 =item How do I modify the shadow password file on a Unix system?
1632 =item How do I set the time and date?
1634 =item How can I sleep() or alarm() for under a second?
1636 =item How can I measure time under a second?
1638 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
1640 =item Why doesn't my sockets program work under System V (Solaris)?  What
1641 does the error message "Protocol not supported" mean?
1643 =item How can I call my system's unique C functions from Perl?
1645 =item Where do I get the include files to do ioctl() or syscall()?
1647 =item Why do setuid perl scripts complain about kernel problems?
1649 =item How can I open a pipe both to and from a command?
1651 =item Why can't I get the output of a command with system()?
1653 =item How can I capture STDERR from an external command?
1655 =item Why doesn't open() return an error when a pipe open fails?
1657 =item What's wrong with using backticks in a void context?
1659 =item How can I call backticks without shell processing?
1661 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
1662 ^Z on MS-DOS)?
1664 =item How can I convert my shell script to perl?
1666 =item Can I use perl to run a telnet or ftp session?
1668 =item How can I write expect in Perl?
1670 =item Is there a way to hide perl's command line from programs such as
1671 "ps"?
1673 =item I {changed directory, modified my environment} in a perl script.  How
1674 come the change disappeared when I exited the script?  How do I get my
1675 changes to be visible?
1677 Unix
1679 =item How do I close a process's filehandle without waiting for it to
1680 complete?
1682 =item How do I fork a daemon process?
1684 =item How do I find out if I'm running interactively or not?
1686 =item How do I timeout a slow event?
1688 =item How do I set CPU limits?
1690 =item How do I avoid zombies on a Unix system?
1692 =item How do I use an SQL database?
1694 =item How do I make a system() exit on control-C?
1696 =item How do I open a file without blocking?
1698 =item How do I tell the difference between errors from the shell and perl?
1700 =item How do I install a module from CPAN?
1702 =item What's the difference between require and use?
1704 =item How do I keep my own module/library directory?
1706 =item How do I add the directory my program lives in to the module/library
1707 search path?
1709 =item How do I add a directory to my include path (@INC) at runtime?
1711 =item What is socket.ph and where do I get it?
1713 =back
1715 =item AUTHOR AND COPYRIGHT
1717 =back
1719 =head2 perlfaq9 - Networking ($Revision: 1.28 $, $Date: 2005/12/31 00:54:37
1722 =over 4
1724 =item DESCRIPTION
1726 =over 4
1728 =item What is the correct form of response from a CGI script?
1730 =item My CGI script runs from the command line but not the browser.  (500
1731 Server Error)
1733 =item How can I get better error messages from a CGI program?
1735 =item How do I remove HTML from a string?
1737 =item How do I extract URLs?
1739 =item How do I download a file from the user's machine?  How do I open a
1740 file on another machine?
1742 =item How do I make a pop-up menu in HTML?
1744 =item How do I fetch an HTML file?
1746 =item How do I automate an HTML form submission?
1748 =item How do I decode or create those %-encodings on the web?
1750 =item How do I redirect to another page?
1752 =item How do I put a password on my web pages?
1754 =item How do I edit my .htpasswd and .htgroup files with Perl?
1756 =item How do I make sure users can't enter values into a form that cause my
1757 CGI script to do bad things?
1759 =item How do I parse a mail header?
1761 =item How do I decode a CGI form?
1763 =item How do I check a valid mail address?
1765 =item How do I decode a MIME/BASE64 string?
1767 =item How do I return the user's mail address?
1769 =item How do I send mail?
1771 =item How do I use MIME to make an attachment to a mail message?
1773 =item How do I read mail?
1775 =item How do I find out my hostname, domainname, or IP address?
1776 X<hostname, domainname, IP address, host, domain, hostfqdn, inet_ntoa,
1777 gethostbyname, Socket, Net::Domain, Sys::Hostname>
1779 =item How do I fetch a news article or the active newsgroups?
1781 =item How do I fetch/put an FTP file?
1783 =item How can I do RPC in Perl?
1785 =back
1787 =item AUTHOR AND COPYRIGHT
1789 =back
1791 =head2 perlsyn - Perl syntax
1793 =over 4
1795 =item DESCRIPTION
1797 =over 4
1799 =item Declarations
1800 X<declaration> X<undef> X<undefined> X<uninitialized>
1802 =item Comments
1803 X<comment> X<#>
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>
1819 =item Loop Control
1820 X<loop control> X<loop, control> X<next> X<last> X<redo> X<continue>
1822 =item For Loops
1823 X<for> X<foreach>
1825 =item Foreach Loops
1826 X<for> X<foreach>
1828 =item Basic BLOCKs and Switch Statements
1829 X<switch> X<block> X<case>
1831 =item Goto
1832 X<goto>
1834 =item PODs: Embedded Documentation
1835 X<POD> X<documentation>
1837 =item Plain Old Comments (Not!)
1838 X<comment> X<line> X<#> X<preprocessor> X<eval>
1840 =back
1842 =back
1844 =head2 perldata - Perl data types
1846 =over 4
1848 =item DESCRIPTION
1850 =over 4
1852 =item Variable names
1853 X<variable, name> X<variable name> X<data type> X<type>
1855 =item Context
1856 X<context> X<scalar context> X<list context>
1858 =item Scalar values
1859 X<scalar> X<number> X<string> X<reference>
1861 =item Scalar value constructors
1862 X<scalar, literal> X<scalar, constant>
1864 =item List value constructors
1865 X<list>
1867 =item Subscripts
1869 =item Slices
1870 X<slice> X<array, slice> X<hash, slice>
1872 =item Typeglobs and Filehandles
1873 X<typeglob> X<filehandle> X<*>
1875 =back
1877 =item SEE ALSO
1879 =back
1881 =head2 perlop - Perl operators and precedence
1883 =over 4
1885 =item DESCRIPTION
1887 =over 4
1889 =item Operator Precedence and Associativity 
1890 X<operator, precedence> X<precedence> X<associativity>
1892 =item Terms and List Operators (Leftward)
1893 X<list operator> X<operator, list> X<term>
1895 =item The Arrow Operator
1896 X<arrow> X<dereference> X<< -> >>
1898 =item Auto-increment and Auto-decrement
1899 X<increment> X<auto-increment> X<++> X<decrement> X<auto-decrement> X<-->
1901 =item Exponentiation
1902 X<**> X<exponentiation> X<power>
1904 =item Symbolic Unary Operators
1905 X<unary operator> X<operator, unary>
1907 =item Binding Operators
1908 X<binding> X<operator, binding> X<=~> X<!~>
1910 =item Multiplicative Operators
1911 X<operator, multiplicative>
1913 =item Additive Operators
1914 X<operator, additive>
1916 =item Shift Operators
1917 X<shift operator> X<operator, shift> X<<< << >>>
1918 X<<< >> >>> X<right shift> X<left shift> X<bitwise shift>
1919 X<shl> X<shr> X<shift, right> X<shift, left>
1921 =item Named Unary Operators
1922 X<operator, named unary>
1924 =item Relational Operators
1925 X<relational operator> X<operator, relational>
1927 =item Equality Operators
1928 X<equality> X<equal> X<equals> X<operator, equality>
1930 =item Bitwise And
1931 X<operator, bitwise, and> X<bitwise and> X<&>
1933 =item Bitwise Or and Exclusive Or
1934 X<operator, bitwise, or> X<bitwise or> X<|> X<operator, bitwise, xor>
1935 X<bitwise xor> X<^>
1937 =item C-style Logical And
1938 X<&&> X<logical and> X<operator, logical, and>
1940 =item C-style Logical Or
1941 X<||> X<operator, logical, or>
1943 =item Range Operators
1944 X<operator, range> X<range> X<..> X<...>
1946 =item Conditional Operator
1947 X<operator, conditional> X<operator, ternary> X<ternary> X<?:>
1949 =item Assignment Operators
1950 X<assignment> X<operator, assignment> X<=> X<**=> X<+=> X<*=> X<&=>
1951 X<<< <<= >>> X<&&=> X<-=> X</=> X<|=> X<<< >>= >>> X<||=> X<.=>
1952 X<%=> X<^=> X<x=>
1954 =item Comma Operator
1955 X<comma> X<operator, comma> X<,>
1957 =item List Operators (Rightward)
1958 X<operator, list, rightward> X<list operator>
1960 =item Logical Not
1961 X<operator, logical, not> X<not>
1963 =item Logical And
1964 X<operator, logical, and> X<and>
1966 =item Logical or and Exclusive Or
1967 X<operator, logical, or> X<operator, logical, xor> X<operator, logical,
1968 err>
1969 X<operator, logical, defined or> X<operator, logical, exclusive or>
1970 X<or> X<xor> X<err>
1972 =item C Operators Missing From Perl
1973 X<operator, missing from perl> X<&> X<*>
1974 X<typecasting> X<(TYPE)>
1976 unary &, unary *, (TYPE)
1978 =item Quote and Quote-like Operators
1979 X<operator, quote> X<operator, quote-like> X<q> X<qq> X<qx> X<qw> X<m> 
1980 X<qr> X<s> X<tr> X<'> X<''> X<"> X<""> X<//> X<`> X<``> X<<< << >>>
1981 X<escape sequence> X<escape>
1983 =item Regexp Quote-Like Operators
1984 X<operator, regexp>
1986 ?PATTERN? X<?>, m/PATTERN/cgimosx X<m> X<operator, match>  X<regexp,
1987 options> X<regexp> X<regex, options> X<regex>  X</c> X</i> X</m> X</o>
1988 X</s> X</x>, /PATTERN/cgimosx, q/STRING/ X<q> X<quote, double> X<'> X<''>,
1989 C<'STRING'>, qq/STRING/ X<qq> X<quote, double> X<"> X<"">, "STRING",
1990 qr/STRING/imosx X<qr> X</i> X</m> X</o> X</s> X</x>, qx/STRING/ X<qx> X<`>
1991 X<``> X<backtick>, `STRING`, qw/STRING/ X<qw> X<quote, list> X<quote,
1992 words>, s/PATTERN/REPLACEMENT/egimosx X<substitute> X<substitution>
1993 X<replace> X<regexp, replace> X<regexp, substitute> X</e> X</g> X</i> X</m>
1994 X</o> X</s> X</x>, tr/SEARCHLIST/REPLACEMENTLIST/cds X<tr> X<y>
1995 X<transliterate> X</c> X</d> X</s>, y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF
1996 X<here-doc> X<heredoc> X<here-document> X<<< << >>>
1998 =item Gory details of parsing quoted constructs
1999 X<quote, gory details>
2001 Finding the end, Removal of backslashes before delimiters, Interpolation
2002 X<interpolation>, C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>,
2003 C<q//>, C<"">, C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>,
2004 C</RE/>, C<m/RE/>, C<s/RE/foo/>,, Interpolation of regular expressions
2005 X<regexp, interpolation>, Optimization of regular expressions X<regexp,
2006 optimization>
2008 =item I/O Operators
2009 X<operator, i/o> X<operator, io> X<io> X<while> X<filehandle>
2010 X<< <> >> X<@ARGV>
2012 =item Constant Folding
2013 X<constant folding> X<folding>
2015 =item No-ops
2016 X<no-op> X<nop>
2018 =item Bitwise String Operators
2019 X<operator, bitwise, string>
2021 =item Integer Arithmetic
2022 X<integer>
2024 =item Floating-point Arithmetic
2025 X<floating-point> X<floating point> X<float> X<real>
2027 =item Bigger Numbers
2028 X<number, arbitrary precision>
2030 =back
2032 =back
2034 =head2 perlsub - Perl subroutines
2036 =over 4
2038 =item SYNOPSIS
2040 =item DESCRIPTION
2042 =over 4
2044 =item Private Variables via my()
2045 X<my> X<variable, lexical> X<lexical> X<lexical variable> X<scope, lexical>
2046 X<lexical scope> X<attributes, my>
2048 =item Persistent Private Variables
2049 X<static> X<variable, persistent> X<variable, static> X<closure>
2051 =item Temporary Values via local()
2052 X<local> X<scope, dynamic> X<dynamic scope> X<variable, local>
2053 X<variable, temporary>
2055 =item Lvalue subroutines
2056 X<lvalue> X<subroutine, lvalue>
2058 Lvalue subroutines are EXPERIMENTAL
2060 =item Passing Symbol Table Entries (typeglobs)
2061 X<typeglob> X<*>
2063 =item When to Still Use local()
2064 X<local> X<variable, local>
2066 =item Pass by Reference
2067 X<pass by reference> X<pass-by-reference> X<reference>
2069 =item Prototypes
2070 X<prototype> X<subroutine, prototype>
2072 =item Constant Functions
2073 X<constant>
2075 =item Overriding Built-in Functions
2076 X<built-in> X<override> X<CORE> X<CORE::GLOBAL>
2078 =item Autoloading
2079 X<autoloading> X<AUTOLOAD>
2081 =item Subroutine Attributes
2082 X<attribute> X<subroutine, attribute> X<attrs>
2084 =back
2086 =item SEE ALSO
2088 =back
2090 =head2 perlfunc - Perl builtin functions
2092 =over 4
2094 =item DESCRIPTION
2096 =over 4
2098 =item Perl Functions by Category
2099 X<function>
2101 Functions for SCALARs or strings X<scalar> X<string> X<character>, Regular
2102 expressions and pattern matching X<regular expression> X<regex> X<regexp>,
2103 Numeric functions X<numeric> X<number> X<trigonometric> X<trigonometry>,
2104 Functions for real @ARRAYs X<array>, Functions for list data X<list>,
2105 Functions for real %HASHes X<hash>, Input and output functions X<I/O>
2106 X<input> X<output> X<dbm>, Functions for fixed length data or records,
2107 Functions for filehandles, files, or directories X<file> X<filehandle>
2108 X<directory> X<pipe> X<link> X<symlink>, Keywords related to the control
2109 flow of your Perl program X<control flow>, Keywords related to scoping,
2110 Miscellaneous functions, Functions for processes and process groups
2111 X<process> X<pid> X<process id>, Keywords related to perl modules
2112 X<module>, Keywords related to classes and object-orientedness X<object>
2113 X<class> X<package>, Low-level socket functions X<socket> X<sock>, System V
2114 interprocess communication functions X<IPC> X<System V> X<semaphore>
2115 X<shared memory> X<memory> X<message>, Fetching user and group info X<user>
2116 X<group> X<password> X<uid> X<gid>  X<passwd> X</etc/passwd>, Fetching
2117 network info X<network> X<protocol> X<host> X<hostname> X<IP> X<address>
2118 X<service>, Time-related functions X<time> X<date>, Functions new in perl5
2119 X<perl5>, Functions obsoleted in perl5
2121 =item Portability
2122 X<portability> X<Unix> X<portable>
2124 =item Alphabetical Listing of Perl Functions
2126 -I<X> FILEHANDLE
2127 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>
2128 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,
2129 -I<X>, abs VALUE X<abs> X<absolute>, abs, accept NEWSOCKET,GENERICSOCKET
2130 X<accept>, alarm SECONDS X<alarm> X<SIGALRM> X<timer>, alarm, atan2 Y,X
2131 X<atan2> X<arctangent> X<tan> X<tangent>, bind SOCKET,NAME X<bind>, binmode
2132 FILEHANDLE, LAYER X<binmode> X<binary> X<text> X<DOS> X<Windows>, binmode
2133 FILEHANDLE, bless REF,CLASSNAME X<bless>, bless REF, caller EXPR X<caller>
2134 X<call stack> X<stack> X<stack trace>, caller, chdir EXPR X<chdir> X<cd>,
2135 chdir FILEHANDLE, chdir DIRHANDLE, chdir, chmod LIST X<chmod> X<permission>
2136 X<mode>, chomp VARIABLE X<chomp> X<INPUT_RECORD_SEPARATOR> X<$/> X<newline>
2137 X<eol>, chomp( LIST ), chomp, chop VARIABLE X<chop>, chop( LIST ), chop,
2138 chown LIST X<chown> X<owner> X<user> X<group>, chr NUMBER X<chr>
2139 X<character> X<ASCII> X<Unicode>, chr, chroot FILENAME X<chroot> X<root>,
2140 chroot, close FILEHANDLE X<close>, close, closedir DIRHANDLE X<closedir>,
2141 connect SOCKET,NAME X<connect>, continue BLOCK X<continue>, cos EXPR X<cos>
2142 X<cosine> X<acos> X<arccosine>, cos, crypt PLAINTEXT,SALT X<crypt>
2143 X<digest> X<hash> X<salt> X<plaintext> X<password> X<decrypt>
2144 X<cryptography> X<passwd>, dbmclose HASH X<dbmclose>, dbmopen
2145 HASH,DBNAME,MASK X<dbmopen> X<dbm> X<ndbm> X<sdbm> X<gdbm>, defined EXPR
2146 X<defined> X<undef> X<undefined>, defined, delete EXPR X<delete>, die LIST
2147 X<die> X<throw> X<exception> X<raise> X<$@> X<abort>, do BLOCK X<do>
2148 X<block>, do SUBROUTINE(LIST) X<do>, do EXPR X<do>, dump LABEL X<dump>
2149 X<core> X<undump>, dump, each HASH X<each> X<hash, iterator>, eof
2150 FILEHANDLE X<eof> X<end of file> X<end-of-file>, eof (), eof, eval EXPR
2151 X<eval> X<try> X<catch> X<evaluate> X<parse> X<execute>, eval BLOCK, eval,
2152 exec LIST X<exec> X<execute>, exec PROGRAM LIST, exists EXPR X<exists>
2153 X<autovivification>, exit EXPR X<exit> X<terminate> X<abort>, exit, exp
2154 EXPR X<exp> X<exponential> X<antilog> X<antilogarithm> X<e>, exp, fcntl
2155 FILEHANDLE,FUNCTION,SCALAR X<fcntl>, fileno FILEHANDLE X<fileno>, flock
2156 FILEHANDLE,OPERATION X<flock> X<lock> X<locking>, fork X<fork> X<child>
2157 X<parent>, format X<format>, formline PICTURE,LIST X<formline>, getc
2158 FILEHANDLE X<getc> X<getchar>, getc, getlogin X<getlogin> X<login>,
2159 getpeername SOCKET X<getpeername> X<peer>, getpgrp PID X<getpgrp> X<group>,
2160 getppid X<getppid> X<parent> X<pid>, getpriority WHICH,WHO X<getpriority>
2161 X<priority> X<nice>, getpwnam NAME X<getpwnam> X<getgrnam> X<gethostbyname>
2162 X<getnetbyname> X<getprotobyname> X<getpwuid> X<getgrgid> X<getservbyname>
2163 X<gethostbyaddr> X<getnetbyaddr> X<getprotobynumber> X<getservbyport>
2164 X<getpwent> X<getgrent> X<gethostent> X<getnetent> X<getprotoent>
2165 X<getservent> X<setpwent> X<setgrent> X<sethostent> X<setnetent>
2166 X<setprotoent> X<setservent> X<endpwent> X<endgrent> X<endhostent>
2167 X<endnetent> X<endprotoent> X<endservent>, getgrnam NAME, gethostbyname
2168 NAME, getnetbyname NAME, getprotobyname NAME, getpwuid UID, getgrgid GID,
2169 getservbyname NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE, getnetbyaddr
2170 ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent,
2171 getgrent, gethostent, getnetent, getprotoent, getservent, setpwent,
2172 setgrent, sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN,
2173 setservent STAYOPEN, endpwent, endgrent, endhostent, endnetent,
2174 endprotoent, endservent, getsockname SOCKET X<getsockname>, getsockopt
2175 SOCKET,LEVEL,OPTNAME X<getsockopt>, glob EXPR X<glob> X<wildcard>
2176 X<filename, expansion> X<expand>, glob, gmtime EXPR X<gmtime> X<UTC>
2177 X<Greenwich>, gmtime, goto LABEL X<goto> X<jump> X<jmp>, goto EXPR, goto
2178 &NAME, grep BLOCK LIST X<grep>, grep EXPR,LIST, hex EXPR X<hex>
2179 X<hexadecimal>, hex, import LIST X<import>, index STR,SUBSTR,POSITION
2180 X<index> X<indexOf> X<InStr>, index STR,SUBSTR, int EXPR X<int> X<integer>
2181 X<truncate> X<trunc>, int, ioctl FILEHANDLE,FUNCTION,SCALAR X<ioctl>, join
2182 EXPR,LIST X<join>, keys HASH X<keys> X<key>, kill SIGNAL, LIST X<kill>
2183 X<signal>, last LABEL X<last> X<break>, last, lc EXPR X<lc> X<lowercase>,
2184 lc, lcfirst EXPR X<lcfirst> X<lowercase>, lcfirst, length EXPR X<length>
2185 X<size>, length, link OLDFILE,NEWFILE X<link>, listen SOCKET,QUEUESIZE
2186 X<listen>, local EXPR X<local>, localtime EXPR X<localtime>, localtime,
2187 lock THING X<lock>, log EXPR X<log> X<logarithm> X<e> X<ln> X<base>, log,
2188 lstat EXPR X<lstat>, lstat, m//, map BLOCK LIST X<map>, map EXPR,LIST,
2189 mkdir FILENAME,MASK X<mkdir> X<md> X<directory, create>, mkdir FILENAME,
2190 msgctl ID,CMD,ARG X<msgctl>, msgget KEY,FLAGS X<msgget>, msgrcv
2191 ID,VAR,SIZE,TYPE,FLAGS X<msgrcv>, msgsnd ID,MSG,FLAGS X<msgsnd>, my EXPR
2192 X<my>, my TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL
2193 X<next> X<continue>, next, no Module VERSION LIST X<no>, no Module VERSION,
2194 no Module LIST, no Module, oct EXPR X<oct> X<octal> X<hex> X<hexadecimal>
2195 X<binary> X<bin>, oct, open FILEHANDLE,EXPR X<open> X<pipe> X<file, open>
2196 X<fopen>, open FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, open
2197 FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, opendir DIRHANDLE,EXPR
2198 X<opendir>, ord EXPR X<ord> X<encoding>, ord, our EXPR X<our> X<global>,
2199 our EXPR TYPE, our EXPR : ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST
2200 X<pack>, package NAMESPACE X<package> X<module> X<namespace>, package, pipe
2201 READHANDLE,WRITEHANDLE X<pipe>, pop ARRAY X<pop> X<stack>, pop, pos SCALAR
2202 X<pos> X<match, position>, pos, print FILEHANDLE LIST X<print>, print LIST,
2203 print, printf FILEHANDLE FORMAT, LIST X<printf>, printf FORMAT, LIST,
2204 prototype FUNCTION X<prototype>, push ARRAY,LIST X<push>, X<stack>,
2205 q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR
2206 X<quotemeta> X<metacharacter>, quotemeta, rand EXPR X<rand> X<random>,
2207 rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET X<read>, read
2208 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE X<readdir>, readline EXPR
2209 X<readline> X<gets> X<fgets>, readlink EXPR X<readlink>, readlink, readpipe
2210 EXPR X<readpipe>, recv SOCKET,SCALAR,LENGTH,FLAGS X<recv>, redo LABEL
2211 X<redo>, redo, ref EXPR X<ref> X<reference>, ref, rename OLDNAME,NEWNAME
2212 X<rename> X<move> X<mv> X<ren>, require VERSION X<require>, require EXPR,
2213 require, reset EXPR X<reset>, reset, return EXPR X<return>, return, reverse
2214 LIST X<reverse> X<rev> X<invert>, rewinddir DIRHANDLE X<rewinddir>, rindex
2215 STR,SUBSTR,POSITION X<rindex>, rindex STR,SUBSTR, rmdir FILENAME X<rmdir>
2216 X<rd> X<directory, remove>, rmdir, s///, scalar EXPR X<scalar> X<context>,
2217 seek FILEHANDLE,POSITION,WHENCE X<seek> X<fseek> X<filehandle, position>,
2218 seekdir DIRHANDLE,POS X<seekdir>, select FILEHANDLE X<select> X<filehandle,
2219 default>, select, select RBITS,WBITS,EBITS,TIMEOUT X<select>, semctl
2220 ID,SEMNUM,CMD,ARG X<semctl>, semget KEY,NSEMS,FLAGS X<semget>, semop
2221 KEY,OPSTRING X<semop>, send SOCKET,MSG,FLAGS,TO X<send>, send
2222 SOCKET,MSG,FLAGS, setpgrp PID,PGRP X<setpgrp> X<group>, setpriority
2223 WHICH,WHO,PRIORITY X<setpriority> X<priority> X<nice> X<renice>, setsockopt
2224 SOCKET,LEVEL,OPTNAME,OPTVAL X<setsockopt>, shift ARRAY X<shift>, shift,
2225 shmctl ID,CMD,ARG X<shmctl>, shmget KEY,SIZE,FLAGS X<shmget>, shmread
2226 ID,VAR,POS,SIZE X<shmread> X<shmwrite>, shmwrite ID,STRING,POS,SIZE,
2227 shutdown SOCKET,HOW X<shutdown>, sin EXPR X<sin> X<sine> X<asin>
2228 X<arcsine>, sin, sleep EXPR X<sleep> X<pause>, sleep, socket
2229 SOCKET,DOMAIN,TYPE,PROTOCOL X<socket>, socketpair
2230 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL X<socketpair>, sort SUBNAME LIST
2231 X<sort> X<qsort> X<quicksort> X<mergesort>, sort BLOCK LIST, sort LIST,
2232 splice ARRAY,OFFSET,LENGTH,LIST X<splice>, splice ARRAY,OFFSET,LENGTH,
2233 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT X<split>,
2234 split /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST
2235 X<sprintf>, format parameter index, flags, vector flag, (minimum) width,
2236 precision, or maximum width X<precision>, size, order of arguments, sqrt
2237 EXPR X<sqrt> X<root> X<square root>, sqrt, srand EXPR X<srand> X<seed>
2238 X<randseed>, srand, stat FILEHANDLE X<stat> X<file, status>, stat EXPR,
2239 stat, study SCALAR X<study>, study, sub NAME BLOCK X<sub>, sub NAME (PROTO)
2240 BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK, substr
2241 EXPR,OFFSET,LENGTH,REPLACEMENT X<substr> X<substring> X<mid> X<left>
2242 X<right>, substr EXPR,OFFSET,LENGTH, substr EXPR,OFFSET, symlink
2243 OLDFILE,NEWFILE X<symlink> X<link> X<symbolic link> X<link, symbolic>,
2244 syscall NUMBER, LIST X<syscall> X<system call>, sysopen
2245 FILEHANDLE,FILENAME,MODE X<sysopen>, sysopen
2246 FILEHANDLE,FILENAME,MODE,PERMS, sysread FILEHANDLE,SCALAR,LENGTH,OFFSET
2247 X<sysread>, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
2248 FILEHANDLE,POSITION,WHENCE X<sysseek> X<lseek>, system LIST X<system>
2249 X<shell>, system PROGRAM LIST, syswrite FILEHANDLE,SCALAR,LENGTH,OFFSET
2250 X<syswrite>, syswrite FILEHANDLE,SCALAR,LENGTH, syswrite FILEHANDLE,SCALAR,
2251 tell FILEHANDLE X<tell>, tell, telldir DIRHANDLE X<telldir>, tie
2252 VARIABLE,CLASSNAME,LIST X<tie>, tied VARIABLE X<tied>, time X<time>
2253 X<epoch>, times X<times>, tr///, truncate FILEHANDLE,LENGTH X<truncate>,
2254 truncate EXPR,LENGTH, uc EXPR X<uc> X<uppercase> X<toupper>, uc, ucfirst
2255 EXPR X<ucfirst> X<uppercase>, ucfirst, umask EXPR X<umask>, umask, undef
2256 EXPR X<undef> X<undefine>, undef, unlink LIST X<unlink> X<delete> X<remove>
2257 X<rm>, unlink, unpack TEMPLATE,EXPR X<unpack>, untie VARIABLE X<untie>,
2258 unshift ARRAY,LIST X<unshift>, use Module VERSION LIST X<use> X<module>
2259 X<import>, use Module VERSION, use Module LIST, use Module, use VERSION,
2260 utime LIST X<utime>, values HASH X<values>, vec EXPR,OFFSET,BITS X<vec>
2261 X<bit> X<bit vector>, wait X<wait>, waitpid PID,FLAGS X<waitpid>, wantarray
2262 X<wantarray> X<context>, warn LIST X<warn> X<warning> X<STDERR>, write
2263 FILEHANDLE X<write>, write EXPR, write, y///
2265 =back
2267 =back
2269 =head2 perlopentut - tutorial on opening things in Perl
2271 =over 4
2273 =item DESCRIPTION
2275 =item Open E<agrave> la shell
2277 =over 4
2279 =item Simple Opens
2281 =item Indirect Filehandles
2283 =item Pipe Opens
2285 =item The Minus File
2287 =item Mixing Reads and Writes
2289 =item Filters 
2291 =back
2293 =item Open E<agrave> la C
2295 =over 4
2297 =item Permissions E<agrave> la mode
2299 =back
2301 =item Obscure Open Tricks
2303 =over 4
2305 =item Re-Opening Files (dups)
2307 =item Dispelling the Dweomer
2309 =item Paths as Opens
2311 =item Single Argument Open
2313 =item Playing with STDIN and STDOUT
2315 =back
2317 =item Other I/O Issues
2319 =over 4
2321 =item Opening Non-File Files
2323 =item Opening Named Pipes
2325 =item Opening Sockets
2327 =item Binary Files
2329 =item File Locking
2331 =item IO Layers
2333 =back
2335 =item SEE ALSO 
2337 =item AUTHOR and COPYRIGHT
2339 =item HISTORY
2341 =back
2343 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
2345 =over 4
2347 =item DESCRIPTION
2349 =item The Basic Principle
2351 =item Packing Text
2353 =item Packing Numbers
2355 =over 4
2357 =item Integers
2359 =item Unpacking a Stack Frame
2361 =item How to Eat an Egg on a Net
2363 =item Floating point Numbers
2365 =back
2367 =item Exotic Templates
2369 =over 4
2371 =item Bit Strings
2373 =item Uuencoding
2375 =item Doing Sums
2377 =item  Unicode
2379 =item Another Portable Binary Encoding
2381 =back
2383 =item Template Grouping
2385 =item Lengths and Widths
2387 =over 4
2389 =item String Lengths
2391 =item Dynamic Templates
2393 =item Counting Repetitions
2395 =back
2397 =item Packing and Unpacking C Structures
2399 =over 4
2401 =item The Alignment Pit
2403 =item Alignment, Take 2
2405 =item Alignment, Take 3
2407 =item Pointers for How to Use Them
2409 =back
2411 =item Pack Recipes
2413 =item Funnies Section
2415 =item Authors
2417 =back
2419 =head2 perlpod - the Plain Old Documentation format
2421 =over 4
2423 =item DESCRIPTION
2425 =over 4
2427 =item Ordinary Paragraph
2428 X<POD, ordinary paragraph>
2430 =item Verbatim Paragraph
2431 X<POD, verbatim paragraph> X<verbatim>
2433 =item Command Paragraph
2434 X<POD, command>
2436 C<=head1 I<Heading Text>> X<=head1> X<=head2> X<=head3> X<=head4> X<head1>
2437 X<head2> X<head3> X<head4>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
2438 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>> X<=over>
2439 X<=item> X<=back> X<over> X<item> X<back>, C<=item I<stuff...>>, C<=back>,
2440 C<=cut> X<=cut> X<cut>, C<=pod> X<=pod> X<pod>, C<=begin I<formatname>>
2441 X<=begin> X<=end> X<=for> X<begin> X<end> X<for>, C<=end I<formatname>>,
2442 C<=for I<formatname> I<text...>>, C<=encoding I<encodingname>> X<=encoding>
2443 X<encoding>
2445 =item Formatting Codes
2446 X<POD, formatting code> X<formatting code>
2447 X<POD, interior sequence> X<interior sequence>
2449 C<IE<lt>textE<gt>> -- italic text X<I> X<< IZ<><> >> X<POD, formatting
2450 code, italic> X<italic>, C<BE<lt>textE<gt>> -- bold text X<B> X<< BZ<><> >>
2451 X<POD, formatting code, bold> X<bold>, C<CE<lt>codeE<gt>> -- code text X<C>
2452 X<< CZ<><> >> X<POD, formatting code, code> X<code>, C<LE<lt>nameE<gt>> --
2453 a hyperlink X<L> X<< LZ<><> >> X<POD, formatting code, hyperlink>
2454 X<hyperlink>, C<EE<lt>escapeE<gt>> -- a character escape X<E> X<< EZ<><> >>
2455 X<POD, formatting code, escape> X<escape>, C<FE<lt>filenameE<gt>> -- used
2456 for filenames X<F> X<< FZ<><> >> X<POD, formatting code, filename>
2457 X<filename>, C<SE<lt>textE<gt>> -- text contains non-breaking spaces X<S>
2458 X<< SZ<><> >> X<POD, formatting code, non-breaking space>  X<non-breaking
2459 space>, C<XE<lt>topic nameE<gt>> -- an index entry X<X> X<< XZ<><> >>
2460 X<POD, formatting code, index entry> X<index entry>, C<ZE<lt>E<gt>> -- a
2461 null (zero-effect) formatting code X<Z> X<< ZZ<><> >> X<POD, formatting
2462 code, null> X<null>
2464 =item The Intent
2465 X<POD, intent of>
2467 =item Embedding Pods in Perl Modules
2468 X<POD, embedding>
2470 =item Hints for Writing Pod
2472 X<podchecker> X<POD, validating>
2474 =back
2476 =item SEE ALSO
2478 =item AUTHOR
2480 =back
2482 =head2 perlpodspec - Plain Old Documentation: format specification and
2483 notes
2485 =over 4
2487 =item DESCRIPTION
2489 =item Pod Definitions
2491 =item Pod Commands
2493 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
2494 "=back", "=begin formatname", "=end formatname", "=for formatname text...",
2495 "=encoding encodingname"
2497 =item Pod Formatting Codes
2499 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2500 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
2501 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
2502 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
2503 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
2504 contains non-breaking spaces
2506 =item Notes on Implementing Pod Processors
2508 =item About LE<lt>...E<gt> Codes
2510 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
2512 =item About =over...=back Regions
2514 =item About Data Paragraphs and "=begin/=end" Regions
2516 =item SEE ALSO
2518 =item AUTHOR
2520 =back
2522 =head2 perlrun - how to execute the Perl interpreter
2524 =over 4
2526 =item SYNOPSIS
2528 =item DESCRIPTION
2530 =over 4
2532 =item #! and quoting on non-Unix systems
2533 X<hashbang> X<#!>
2535 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
2537 =item Location of Perl
2538 X<perl, location of interpreter>
2540 =item Command Switches
2541 X<perl, command switches> X<command switches>
2543 B<-0>[I<octal/hexadecimal>] X<-0> X<$/>, B<-a> X<-a> X<autosplit>, B<-C
2544 [I<number/list>]> X<-C>, B<-c> X<-c>, B<-d> X<-d> X<-dt>, B<-dt>,
2545 B<-d:>I<foo[=bar,baz]> X<-d> X<-dt>, B<-dt:>I<foo[=bar,baz]>,
2546 B<-D>I<letters> X<-D> X<DEBUGGING> X<-DDEBUGGING>, B<-D>I<number>, B<-e>
2547 I<commandline> X<-e>, B<-f> X<-f>, B<-F>I<pattern> X<-F>, B<-h> X<-h>,
2548 B<-i>[I<extension>] X<-i> X<in-place>, B<-I>I<directory> X<-I> X<@INC>,
2549 B<-l>[I<octnum>] X<-l> X<$/> X<$\>, B<-m>[B<->]I<module> X<-m> X<-M>,
2550 B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
2551 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n> X<-n>, B<-p> X<-p>, B<-P>
2552 X<-P>, B<-s> X<-s>, B<-S> X<-S>, B<-t> X<-t>, B<-T> X<-T>, B<-u> X<-u>,
2553 B<-U> X<-U>, B<-v> X<-v>, B<-V> X<-V>, B<-V:>I<configvar>, B<-w> X<-w>,
2554 B<-W> X<-W>, B<-X> X<-X>, B<-x> X<-x>, B<-x> I<directory>
2556 =back
2558 =item ENVIRONMENT
2559 X<perl, environment variables>
2561 HOME X<HOME>, LOGDIR X<LOGDIR>, PATH X<PATH>, PERL5LIB X<PERL5LIB>,
2562 PERL5OPT X<PERL5OPT>, PERLIO X<PERLIO>, :bytes X<:bytes>, :crlf X<:crlf>,
2563 :mmap X<:mmap>, :perlio X<:perlio>, :pop X<:pop>, :raw X<:raw>, :stdio
2564 X<:stdio>, :unix X<:unix>, :utf8 X<:utf8>, :win32 X<:win32>, PERLIO_DEBUG
2565 X<PERLIO_DEBUG>, PERLLIB X<PERLLIB>, PERL5DB X<PERL5DB>, PERL5DB_THREADED
2566 X<PERL5DB_THREADED>, PERL5SHELL (specific to the Win32 port) X<PERL5SHELL>,
2567 PERL_ALLOW_NON_IFS_LSP (specific to the Win32 port)
2568 X<PERL_ALLOW_NON_IFS_LSP>, PERL_DEBUG_MSTATS X<PERL_DEBUG_MSTATS>,
2569 PERL_DESTRUCT_LEVEL X<PERL_DESTRUCT_LEVEL>, PERL_DL_NONLAZY
2570 X<PERL_DL_NONLAZY>, PERL_ENCODING X<PERL_ENCODING>, PERL_HASH_SEED
2571 X<PERL_HASH_SEED>, PERL_HASH_SEED_DEBUG X<PERL_HASH_SEED_DEBUG>, PERL_ROOT
2572 (specific to the VMS port) X<PERL_ROOT>, PERL_SIGNALS X<PERL_SIGNALS>,
2573 PERL_UNICODE X<PERL_UNICODE>, SYS$LOGIN (specific to the VMS port)
2574 X<SYS$LOGIN>
2576 =back
2578 =head2 perldiag - various Perl diagnostics
2580 =over 4
2582 =item DESCRIPTION
2584 =back
2586 =head2 perllexwarn - Perl Lexical Warnings
2588 =over 4
2590 =item DESCRIPTION
2592 =over 4
2594 =item Default Warnings and Optional Warnings
2596 =item What's wrong with B<-w> and C<$^W>
2598 =item Controlling Warnings from the Command Line
2600 B<-w> X<-w>, B<-W> X<-W>, B<-X> X<-X>
2602 =item Backward Compatibility
2604 =item Category Hierarchy
2605 X<warning, categories>
2607 =item Fatal Warnings
2608 X<warning, fatal>
2610 =item Reporting Warnings from a Module
2611 X<warning, reporting> X<warning, registering>
2613 =back
2615 =item TODO
2617 =item SEE ALSO
2619 =item AUTHOR
2621 =back
2623 =head2 perldebug - Perl debugging
2625 =over 4
2627 =item DESCRIPTION
2629 =item The Perl Debugger
2631 =over 4
2633 =item Debugger Commands
2635 h X<debugger command, h>, h [command], h h, p expr X<debugger command, p>,
2636 x [maxdepth] expr X<debugger command, x>, V [pkg [vars]] X<debugger
2637 command, V>, X [vars] X<debugger command, X>, y [level [vars]] X<debugger
2638 command, y>, T X<debugger command, T> X<backtrace> X<stack, backtrace>, s
2639 [expr] X<debugger command, s> X<step>, n [expr] X<debugger command, n>, r
2640 X<debugger command, r>, <CR>, c [line|sub] X<debugger command, c>, l
2641 X<debugger command, l>, l min+incr, l min-max, l line, l subname, -
2642 X<debugger command, ->, v [line] X<debugger command, v>, . X<debugger
2643 command, .>, f filename X<debugger command, f>, /pattern/, ?pattern?, L
2644 [abw] X<debugger command, L>, S [[!]regex] X<debugger command, S>, t
2645 X<debugger command, t>, t expr X<debugger command, t>, b X<breakpoint>
2646 X<debugger command, b>, b [line] [condition] X<breakpoint> X<debugger
2647 command, b>, b subname [condition] X<breakpoint> X<debugger command, b>, b
2648 postpone subname [condition] X<breakpoint> X<debugger command, b>, b load
2649 filename X<breakpoint> X<debugger command, b>, b compile subname
2650 X<breakpoint> X<debugger command, b>, B line X<breakpoint> X<debugger
2651 command, B>, B * X<breakpoint> X<debugger command, B>, a [line] command
2652 X<debugger command, a>, A line X<debugger command, A>, A * X<debugger
2653 command, A>, w expr X<debugger command, w>, W expr X<debugger command, W>,
2654 W * X<debugger command, W>, o X<debugger command, o>, o booloption ...
2655 X<debugger command, o>, o anyoption? ... X<debugger command, o>, o
2656 option=value ... X<debugger command, o>, < ? X<< debugger command, < >>, <
2657 [ command ] X<< debugger command, < >>, < * X<< debugger command, < >>, <<
2658 command X<< debugger command, << >>, > ? X<< debugger command, > >>, >
2659 command X<< debugger command, > >>, > * X<< debugger command, > >>, >>
2660 command X<<< debugger command, >> >>>, { ? X<debugger command, {>, { [
2661 command ], { * X<debugger command, {>, {{ command X<debugger command, {{>,
2662 ! number X<debugger command, !>, ! -number X<debugger command, !>, !
2663 pattern X<debugger command, !>, !! cmd X<debugger command, !!>, source file
2664 X<debugger command, source>, H -number X<debugger command, H>, q or ^D
2665 X<debugger command, q> X<debugger command, ^D>, R X<debugger command, R>,
2666 |dbcmd X<debugger command, |>, ||dbcmd X<debugger command, ||>, command, m
2667 expr X<debugger command, m>, M X<debugger command, M>, man [manpage]
2668 X<debugger command, man>
2670 =item Configurable Options
2672 C<recallCommand>, C<ShellBang> X<debugger option, recallCommand> X<debugger
2673 option, ShellBang>, C<pager> X<debugger option, pager>, C<tkRunning>
2674 X<debugger option, tkRunning>, C<signalLevel>, C<warnLevel>, C<dieLevel>
2675 X<debugger option, signalLevel> X<debugger option, warnLevel> X<debugger
2676 option, dieLevel>, C<AutoTrace> X<debugger option, AutoTrace>, C<LineInfo>
2677 X<debugger option, LineInfo>, C<inhibit_exit> X<debugger option,
2678 inhibit_exit>, C<PrintRet> X<debugger option, PrintRet>, C<ornaments>
2679 X<debugger option, ornaments>, C<frame> X<debugger option, frame>,
2680 C<maxTraceLen> X<debugger option, maxTraceLen>, C<windowSize> X<debugger
2681 option, windowSize>, C<arrayDepth>, C<hashDepth> X<debugger option,
2682 arrayDepth> X<debugger option, hashDepth>, C<dumpDepth> X<debugger option,
2683 dumpDepth>, C<compactDump>, C<veryCompact> X<debugger option, compactDump>
2684 X<debugger option, veryCompact>, C<globPrint> X<debugger option,
2685 globPrint>, C<DumpDBFiles> X<debugger option, DumpDBFiles>, C<DumpPackages>
2686 X<debugger option, DumpPackages>, C<DumpReused> X<debugger option,
2687 DumpReused>, C<quote>, C<HighBit>, C<undefPrint> X<debugger option, quote>
2688 X<debugger option, HighBit> X<debugger option, undefPrint>, C<UsageOnly>
2689 X<debugger option, UsageOnly>, C<TTY> X<debugger option, TTY>, C<noTTY>
2690 X<debugger option, noTTY>, C<ReadLine> X<debugger option, ReadLine>,
2691 C<NonStop> X<debugger option, NonStop>
2693 =item Debugger input/output
2695 Prompt, Multiline commands, Stack backtrace X<backtrace> X<stack,
2696 backtrace>, Line Listing Format, Frame listing
2698 =item Debugging compile-time statements
2700 =item Debugger Customization
2702 =item Readline Support
2704 =item Editor Support for Debugging
2706 =item The Perl Profiler
2707 X<profile> X<profiling> X<profiler>
2709 =back
2711 =item Debugging regular expressions
2712 X<regular expression, debugging>
2713 X<regex, debugging> X<regexp, debugging>
2715 =item Debugging memory usage
2716 X<memory usage>
2718 =item SEE ALSO
2720 =item BUGS
2722 =back
2724 =head2 perlvar - Perl predefined variables
2726 =over 4
2728 =item DESCRIPTION
2730 =over 4
2732 =item Predefined Names
2734 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
2735 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+, $*,
2736 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
2737 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
2738 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
2739 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
2740 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
2741 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $#,
2742 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
2743 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
2744 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
2745 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
2746 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
2747 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
2748 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
2749 C<substr($var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
2750 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
2751 IO::Handle->format_line_break_characters EXPR,
2752 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
2753 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
2754 $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
2755 $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
2756 $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
2757 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
2758 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
2759 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
2760 0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R,
2761 $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, ${^UNICODE},
2762 ${^UTF8LOCALE}, $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS},
2763 $EXECUTABLE_NAME, $^X, ARGV, $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC,
2764 %ENV, $ENV{expr}, %SIG, $SIG{expr}
2766 =item Error Indicators
2768 =item Technical Note on the Syntax of Variable Names
2770 =back
2772 =item BUGS
2774 =back
2776 =head2 perlre - Perl regular expressions
2778 =over 4
2780 =item DESCRIPTION
2782 i X</i> X<regex, case-insensitive> X<regexp, case-insensitive> X<regular
2783 expression, case-insensitive>, m X</m> X<regex, multiline> X<regexp,
2784 multiline> X<regular expression, multiline>, s X</s> X<regex, single-line>
2785 X<regexp, single-line> X<regular expression, single-line>, x X</x>
2787 =over 4
2789 =item Regular Expressions
2791 [1], [2], [3], cntrl X<cntrl>, graph X<graph>, print X<print>, punct
2792 X<punct>, xdigit X<xdigit>
2794 =item Extended Patterns
2796 C<(?#text)> X<(?#)>, C<(?imsx-imsx)> X<(?)>, C<(?:pattern)> X<(?:)>,
2797 C<(?imsx-imsx:pattern)>, C<(?=pattern)> X<(?=)> X<look-ahead, positive>
2798 X<lookahead, positive>, C<(?!pattern)> X<(?!)> X<look-ahead, negative>
2799 X<lookahead, negative>, C<(?<=pattern)> X<(?<=)> X<look-behind, positive>
2800 X<lookbehind, positive>, C<(?<!pattern)> X<(?<!)> X<look-behind, negative>
2801 X<lookbehind, negative>, C<(?{ code })> X<(?{})> X<regex, code in>
2802 X<regexp, code in> X<regular expression, code in>, C<(??{ code })>
2803 X<(??{})> X<regex, postponed> X<regexp, postponed> X<regular expression,
2804 postponed> X<regex, recursive> X<regexp, recursive> X<regular expression,
2805 recursive>, C<< (?>pattern) >> X<backtrack> X<backtracking>,
2806 C<(?(condition)yes-pattern|no-pattern)> X<(?()>,
2807 C<(?(condition)yes-pattern)>
2809 =item Backtracking
2810 X<backtrack> X<backtracking>
2812 =item Version 8 Regular Expressions
2813 X<regular expression, version 8> X<regex, version 8> X<regexp, version 8>
2815 =item Warning on \1 vs $1
2817 =item Repeated patterns matching zero-length substring
2819 =item Combining pieces together
2821 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
2822 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
2823 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
2824 C<(?(condition)yes-pattern|no-pattern)>
2826 =item Creating custom RE engines
2828 =back
2830 =item BUGS
2832 =item SEE ALSO
2834 =back
2836 =head2 perlreref - Perl Regular Expressions Reference
2838 =over 4
2840 =item DESCRIPTION
2842 =over 4
2844 =item OPERATORS
2846 =item SYNTAX
2848 =item ESCAPE SEQUENCES
2850 =item CHARACTER CLASSES
2852 =item ANCHORS
2854 =item QUANTIFIERS
2856 =item EXTENDED CONSTRUCTS
2858 =item VARIABLES
2860 =item FUNCTIONS
2862 =item TERMINOLOGY
2864 =back
2866 =item AUTHOR
2868 =item SEE ALSO
2870 =item THANKS
2872 =back
2874 =head2 perlref - Perl references and nested data structures
2876 =over 4
2878 =item NOTE
2880 =item DESCRIPTION
2882 =over 4
2884 =item Making References
2885 X<reference, creation> X<referencing>
2887 1. X<\> X<backslash>, 2. X<array, anonymous> X<[> X<[]> X<square bracket>
2888 X<bracket, square> X<arrayref> X<array reference> X<reference, array>, 3.
2889 X<hash, anonymous> X<{> X<{}> X<curly bracket> X<bracket, curly> X<brace>
2890 X<hashref> X<hash reference> X<reference, hash>, 4. X<subroutine,
2891 anonymous> X<subroutine, reference> X<reference, subroutine> X<scope,
2892 lexical> X<closure> X<lexical> X<lexical scope>, 5. X<constructor> X<new>,
2893 6. X<autovivification>, 7. X<*foo{THING}> X<*>
2895 =item Using References
2896 X<reference, use> X<dereferencing> X<dereference>
2898 2. X<${}> X<@{}> X<%{}>, 3. X<autovivification> X<< -> >> X<arrow>, 4.
2899 X<encapsulation>
2901 =item Symbolic references
2902 X<reference, symbolic> X<reference, soft>
2903 X<symbolic reference> X<soft reference>
2905 =item Not-so-symbolic references
2907 =item Pseudo-hashes: Using an array as a hash
2908 X<pseudo-hash> X<pseudo hash> X<pseudohash>
2910 =item Function Templates
2911 X<scope, lexical> X<closure> X<lexical> X<lexical scope>
2912 X<subroutine, nested> X<sub, nested> X<subroutine, local> X<sub, local>
2914 =back
2916 =item WARNING
2917 X<reference, string context> X<reference, use as hash key>
2919 =item SEE ALSO
2921 =back
2923 =head2 perlform - Perl formats
2925 =over 4
2927 =item DESCRIPTION
2929 =over 4
2931 =item Text Fields
2932 X<format, text field>
2934 =item Numeric Fields
2935 X<#> X<format, numeric field>
2937 =item The Field @* for Variable Width Multi-Line Text
2938 X<@*>
2940 =item The Field ^* for Variable Width One-line-at-a-time Text
2941 X<^*>
2943 =item Specifying Values
2944 X<format, specifying values>
2946 =item Using Fill Mode
2947 X<format, fill mode>
2949 =item Suppressing Lines Where All Fields Are Void
2950 X<format, suppressing lines>
2952 =item Repeating Format Lines
2953 X<format, repeating lines>
2955 =item Top of Form Processing
2956 X<format, top of form> X<top> X<header>
2958 =item Format Variables
2959 X<format variables>
2960 X<format, variables>
2962 =back
2964 =item NOTES
2966 =over 4
2968 =item Footers
2969 X<format, footer> X<footer>
2971 =item Accessing Formatting Internals
2972 X<format, internals>
2974 =back
2976 =item WARNINGS
2978 =back
2980 =head2 perlobj - Perl objects
2982 =over 4
2984 =item DESCRIPTION
2986 =over 4
2988 =item An Object is Simply a Reference
2989 X<object> X<bless> X<constructor> X<new>
2991 =item A Class is Simply a Package
2992 X<class> X<package> X<@ISA> X<inheritance>
2994 =item A Method is Simply a Subroutine
2995 X<method>
2997 =item Method Invocation
2998 X<invocation> X<method> X<arrow> X<< -> >>
3000 =item Indirect Object Syntax
3001 X<indirect object syntax> X<invocation, indirect> X<indirect>
3003 =item Default UNIVERSAL methods
3004 X<UNIVERSAL>
3006 isa(CLASS) X<isa>, can(METHOD) X<can>, VERSION( [NEED] ) X<VERSION>
3008 =item Destructors
3009 X<destructor> X<DESTROY>
3011 =item Summary
3013 =item Two-Phased Garbage Collection
3014 X<garbage collection> X<GC> X<circular reference>
3015 X<reference, circular> X<DESTROY> X<destructor>
3017 =back
3019 =item SEE ALSO
3021 =back
3023 =head2 perltie - how to hide an object class in a simple variable
3025 =over 4
3027 =item SYNOPSIS
3029 =item DESCRIPTION
3031 =over 4
3033 =item Tying Scalars
3034 X<scalar, tying>
3036 TIESCALAR classname, LIST X<TIESCALAR>, FETCH this X<FETCH>, STORE this,
3037 value X<STORE>, UNTIE this X<UNTIE>, DESTROY this X<DESTROY>
3039 =item Tying Arrays
3040 X<array, tying>
3042 TIEARRAY classname, LIST X<TIEARRAY>, FETCH this, index X<FETCH>, STORE
3043 this, index, value X<STORE>, FETCHSIZE this X<FETCHSIZE>, STORESIZE this,
3044 count X<STORESIZE>, EXTEND this, count X<EXTEND>, EXISTS this, key
3045 X<EXISTS>, DELETE this, key X<DELETE>, CLEAR this X<CLEAR>, PUSH this, LIST
3046  X<PUSH>, POP this X<POP>, SHIFT this X<SHIFT>, UNSHIFT this, LIST 
3047 X<UNSHIFT>, SPLICE this, offset, length, LIST X<SPLICE>, UNTIE this
3048 X<UNTIE>, DESTROY this X<DESTROY>
3050 =item Tying Hashes
3051 X<hash, tying>
3053 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST X<TIEHASH>, FETCH this,
3054 key X<FETCH>, STORE this, key, value X<STORE>, DELETE this, key X<DELETE>,
3055 CLEAR this X<CLEAR>, EXISTS this, key X<EXISTS>, FIRSTKEY this X<FIRSTKEY>,
3056 NEXTKEY this, lastkey X<NEXTKEY>, SCALAR this X<SCALAR>, UNTIE this
3057 X<UNTIE>, DESTROY this X<DESTROY>
3059 =item Tying FileHandles
3060 X<filehandle, tying>
3062 TIEHANDLE classname, LIST X<TIEHANDLE>, WRITE this, LIST X<WRITE>, PRINT
3063 this, LIST X<PRINT>, PRINTF this, LIST X<PRINTF>, READ this, LIST X<READ>,
3064 READLINE this X<READLINE>, GETC this X<GETC>, CLOSE this X<CLOSE>, UNTIE
3065 this X<UNTIE>, DESTROY this X<DESTROY>
3067 =item UNTIE this
3068 X<UNTIE>
3070 =item The C<untie> Gotcha
3071 X<untie>
3073 =back
3075 =item SEE ALSO
3077 =item BUGS
3079 =item AUTHOR
3081 =back
3083 =head2 perldbmfilter - Perl DBM Filters
3085 =over 4
3087 =item SYNOPSIS
3089 =item DESCRIPTION
3091 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
3092 B<filter_fetch_value>
3094 =over 4
3096 =item The Filter
3098 =item An Example -- the NULL termination problem.
3100 =item Another Example -- Key is a C int.
3102 =back
3104 =item SEE ALSO
3106 =item AUTHOR
3108 =back
3110 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
3111 safe subprocesses, sockets, and semaphores)
3113 =over 4
3115 =item DESCRIPTION
3117 =item Signals
3119 =over 4
3121 =item Handling the SIGHUP Signal in Daemons
3123 =back
3125 =item Named Pipes
3127 =over 4
3129 =item Deferred Signals (Safe Signals)
3131 Long running opcodes, Interrupting IO, Restartable system calls, Signals as
3132 "faults", Signals triggered by operating system state
3134 =back
3136 =item Using open() for IPC
3138 =over 4
3140 =item Filehandles
3142 =item Background Processes
3144 =item Complete Dissociation of Child from Parent
3146 =item Safe Pipe Opens
3148 =item Bidirectional Communication with Another Process
3150 =item Bidirectional Communication with Yourself
3152 =back
3154 =item Sockets: Client/Server Communication
3156 =over 4
3158 =item Internet Line Terminators
3160 =item Internet TCP Clients and Servers
3162 =item Unix-Domain TCP Clients and Servers
3164 =back
3166 =item TCP Clients with IO::Socket
3168 =over 4
3170 =item A Simple Client
3172 C<Proto>, C<PeerAddr>, C<PeerPort>
3174 =item A Webget Client
3176 =item Interactive Client with IO::Socket
3178 =back
3180 =item TCP Servers with IO::Socket
3182 Proto, LocalPort, Listen, Reuse
3184 =item UDP: Message Passing
3186 =item SysV IPC
3188 =item NOTES
3190 =item BUGS
3192 =item AUTHOR
3194 =item SEE ALSO
3196 =back
3198 =head2 perlfork - Perl's fork() emulation
3200 =over 4
3202 =item SYNOPSIS
3204 =item DESCRIPTION
3206 =over 4
3208 =item Behavior of other Perl features in forked pseudo-processes
3210 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
3211 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
3212 files, directories and network sockets
3214 =item Resource limits
3216 =item Killing the parent process
3218 =item Lifetime of the parent process and pseudo-processes
3220 =item CAVEATS AND LIMITATIONS
3222 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
3223 Global state maintained by XSUBs, Interpreter embedded in larger
3224 application, Thread-safety of extensions
3226 =back
3228 =item BUGS
3230 =item AUTHOR
3232 =item SEE ALSO
3234 =back
3236 =head2 perlnumber - semantics of numbers and numeric operations in Perl
3238 =over 4
3240 =item SYNOPSIS
3242 =item DESCRIPTION
3244 =item Storing numbers
3246 =item Numeric operators and numeric conversions
3248 =item Flavors of Perl numeric operations
3250 Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other
3251 mathematical operators, Bitwise operators, Bitwise operators during C<use
3252 integer>, Operators which expect an integer, Operators which expect a
3253 string
3255 =item AUTHOR
3257 =item SEE ALSO
3259 =back
3261 =head2 perlthrtut - tutorial on threads in Perl
3263 =over 4
3265 =item DESCRIPTION
3267 =item Status
3269 =item What Is A Thread Anyway?
3271 =item Threaded Program Models
3273 =over 4
3275 =item Boss/Worker
3277 =item Work Crew
3279 =item Pipeline
3281 =back
3283 =item What kind of threads are Perl threads?
3285 =item Thread-Safe Modules
3287 =item Thread Basics
3289 =over 4
3291 =item Basic Thread Support
3293 =item A Note about the Examples
3295 =item Creating Threads
3297 =item Waiting For A Thread To Exit
3299 =item Ignoring A Thread
3301 =back
3303 =item Threads And Data
3305 =over 4
3307 =item Shared And Unshared Data
3309 =item Thread Pitfalls: Races
3311 =back
3313 =item Synchronization and control
3315 =over 4
3317 =item Controlling access: lock()
3319 =item A Thread Pitfall: Deadlocks
3321 =item Queues: Passing Data Around
3323 =item Semaphores: Synchronizing Data Access
3325 =item Basic semaphores
3327 =item Advanced Semaphores
3329 =item cond_wait() and cond_signal()
3331 =item Giving up control
3333 =back
3335 =item General Thread Utility Routines
3337 =over 4
3339 =item What Thread Am I In?
3341 =item Thread IDs
3343 =item Are These Threads The Same?
3345 =item What Threads Are Running?
3347 =back
3349 =item A Complete Example
3351 =item Different implementations of threads
3353 =item Performance considerations
3355 =item Process-scope Changes
3357 =item Thread-Safety of System Libraries
3359 =item Conclusion
3361 =item Bibliography
3363 =over 4
3365 =item Introductory Texts
3367 =item OS-Related References
3369 =item Other References
3371 =back
3373 =item Acknowledgements
3375 =item AUTHOR
3377 =item Copyrights
3379 =back
3381 =head2 perlothrtut - old tutorial on threads in Perl
3383 =over 4
3385 =item DESCRIPTION
3387 =item What Is A Thread Anyway?
3389 =item Threaded Program Models
3391 =over 4
3393 =item Boss/Worker
3395 =item Work Crew
3397 =item Pipeline
3399 =back
3401 =item Native threads
3403 =item What kind of threads are perl threads?
3405 =item Threadsafe Modules
3407 =item Thread Basics
3409 =over 4
3411 =item Basic Thread Support
3413 =item Creating Threads
3415 =item Giving up control
3417 =item Waiting For A Thread To Exit
3419 =item Errors In Threads
3421 =item Ignoring A Thread
3423 =back
3425 =item Threads And Data
3427 =over 4
3429 =item Shared And Unshared Data
3431 =item Thread Pitfall: Races
3433 =item Controlling access: lock()
3435 =item Thread Pitfall: Deadlocks
3437 =item Queues: Passing Data Around
3439 =back
3441 =item Threads And Code
3443 =over 4
3445 =item Semaphores: Synchronizing Data Access
3447 Basic semaphores, Advanced Semaphores
3449 =item Attributes: Restricting Access To Subroutines
3451 =item Subroutine Locks
3453 =item Methods
3455 =item Locking A Subroutine
3457 =back
3459 =item General Thread Utility Routines
3461 =over 4
3463 =item What Thread Am I In?
3465 =item Thread IDs
3467 =item Are These Threads The Same?
3469 =item What Threads Are Running?
3471 =back
3473 =item A Complete Example
3475 =item Conclusion
3477 =item Bibliography
3479 =over 4
3481 =item Introductory Texts
3483 =item OS-Related References
3485 =item Other References
3487 =back
3489 =item Acknowledgements
3491 =item AUTHOR
3493 =item Copyrights
3495 =back
3497 =head2 perlport - Writing portable Perl
3499 =over 4
3501 =item DESCRIPTION
3503 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
3504 portable
3506 =item ISSUES
3508 =over 4
3510 =item Newlines
3512 =item Numbers endianness and Width
3514 =item Files and Filesystems
3516 =item System Interaction
3518 =item Command names versus file pathnames
3520 =item Networking
3522 =item Interprocess Communication (IPC)
3524 =item External Subroutines (XS)
3526 =item Standard Modules
3528 =item Time and Date
3530 =item Character sets and character encoding
3532 =item Internationalisation
3534 =item System Resources
3536 =item Security
3538 =item Style
3540 =back
3542 =item CPAN Testers
3544 =item PLATFORMS
3546 =over 4
3548 =item Unix
3550 =item DOS and Derivatives
3552 =item S<Mac OS>
3554 =item VMS
3556 =item VOS
3558 =item EBCDIC Platforms
3560 =item Acorn RISC OS
3562 =item Other perls
3564 =back
3566 =item FUNCTION IMPLEMENTATIONS
3568 =over 4
3570 =item Alphabetical Listing of Perl Functions
3572 -I<X>, atan2 Y,X, atan2, binmode, chmod, chown, chroot, crypt, dbmclose,
3573 dbmopen, dump, exec, exit, fcntl, flock, fork, getlogin, getpgrp, getppid,
3574 getpriority, getpwnam, getgrnam, getnetbyname, getpwuid, getgrgid,
3575 getnetbyaddr, getprotobynumber, getservbyport, getpwent, getgrent,
3576 gethostbyname, gethostent, getnetent, getprotoent, getservent, sethostent,
3577 setnetent, setprotoent, setservent, endpwent, endgrent, endhostent,
3578 endnetent, endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob,
3579 gmtime, ioctl FILEHANDLE,FUNCTION,SCALAR, kill, link, localtime, lstat,
3580 msgctl, msgget, msgsnd, msgrcv, open, pipe, readlink, rename, select,
3581 semctl, semget, semop, setgrent, setpgrp, setpriority, setpwent,
3582 setsockopt, shmctl, shmget, shmread, shmwrite, sockatmark, socketpair,
3583 stat, symlink, syscall, sysopen, system, times, truncate, umask, utime,
3584 wait, waitpid
3586 =back
3588 =item Supported Platforms
3590 =item SEE ALSO
3592 =item AUTHORS / CONTRIBUTORS
3594 =back
3596 =head2 perllocale - Perl locale handling (internationalization and
3597 localization)
3599 =over 4
3601 =item DESCRIPTION
3603 =item PREPARING TO USE LOCALES
3605 =item USING LOCALES
3607 =over 4
3609 =item The use locale pragma
3611 =item The setlocale function
3613 =item Finding locales
3615 =item LOCALE PROBLEMS
3617 =item Temporarily fixing locale problems
3619 =item Permanently fixing locale problems
3621 =item Permanently fixing your system's locale configuration
3623 =item Fixing system locale configuration
3625 =item The localeconv function
3627 =item I18N::Langinfo
3629 =back
3631 =item LOCALE CATEGORIES
3633 =over 4
3635 =item Category LC_COLLATE: Collation
3637 =item Category LC_CTYPE: Character Types
3639 =item Category LC_NUMERIC: Numeric Formatting
3641 =item Category LC_MONETARY: Formatting of monetary amounts
3643 =item LC_TIME
3645 =item Other categories
3647 =back
3649 =item SECURITY
3651 =item ENVIRONMENT
3653 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
3654 LC_NUMERIC, LC_TIME, LANG
3656 =item NOTES
3658 =over 4
3660 =item Backward compatibility
3662 =item I18N:Collate obsolete
3664 =item Sort speed and memory use impacts
3666 =item write() and LC_NUMERIC
3668 =item Freely available locale definitions
3670 =item I18n and l10n
3672 =item An imperfect standard
3674 =back
3676 =item Unicode and UTF-8
3678 =item BUGS
3680 =over 4
3682 =item Broken systems
3684 =back
3686 =item SEE ALSO
3688 =item HISTORY
3690 =back
3692 =head2 perluniintro - Perl Unicode introduction
3694 =over 4
3696 =item DESCRIPTION
3698 =over 4
3700 =item Unicode
3702 =item Perl's Unicode Support
3704 =item Perl's Unicode Model
3706 =item Unicode and EBCDIC
3708 =item Creating Unicode
3710 =item Handling Unicode
3712 =item Legacy Encodings
3714 =item Unicode I/O
3716 =item Displaying Unicode As Text
3718 =item Special Cases
3720 =item Advanced Topics
3722 =item Miscellaneous
3724 =item Questions With Answers
3726 =item Hexadecimal Notation
3728 =item Further Resources
3730 =back
3732 =item UNICODE IN OLDER PERLS
3734 =item SEE ALSO
3736 =item ACKNOWLEDGMENTS
3738 =item AUTHOR, COPYRIGHT, AND LICENSE
3740 =back
3742 =head2 perlunicode - Unicode support in Perl
3744 =over 4
3746 =item DESCRIPTION
3748 =over 4
3750 =item Important Caveats
3752 Input and Output Layers, Regular Expressions, C<use utf8> still needed to
3753 enable UTF-8/UTF-EBCDIC in scripts, BOM-marked scripts and UTF-16 scripts
3754 autodetected, C<use encoding> needed to upgrade non-Latin-1 byte strings
3756 =item Byte and Character Semantics
3758 =item Effects of Character Semantics
3760 =item Scripts
3762 =item Blocks
3764 =item User-Defined Character Properties
3766 =item Character Encodings for Input and Output
3768 =item Unicode Regular Expression Support Level
3770 =item Unicode Encodings
3772 =item Security Implications of Unicode
3774 =item Unicode in Perl on EBCDIC
3776 =item Locales
3778 =item When Unicode Does Not Happen
3780 =item Forcing Unicode in Perl (Or Unforcing Unicode in Perl)
3782 =item Using Unicode in XS
3784 =back
3786 =item BUGS
3788 =over 4
3790 =item Interaction with Locales
3792 =item Interaction with Extensions
3794 =item Speed
3796 =item Porting code from perl-5.6.X
3798 =back
3800 =item SEE ALSO
3802 =back
3804 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
3806 =over 4
3808 =item DESCRIPTION
3810 =item COMMON CHARACTER CODE SETS
3812 =over 4
3814 =item ASCII
3816 =item ISO 8859
3818 =item Latin 1 (ISO 8859-1)
3820 =item EBCDIC
3822 =item 13 variant characters
3824 =item 0037
3826 =item 1047
3828 =item POSIX-BC
3830 =item Unicode code points versus EBCDIC code points
3832 =item Remaining Perl Unicode problems in EBCDIC
3834 =item Unicode and UTF
3836 =item Using Encode
3838 =back
3840 =item SINGLE OCTET TABLES
3842 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
3844 =item IDENTIFYING CHARACTER CODE SETS
3846 =item CONVERSIONS
3848 =over 4
3850 =item tr///
3852 =item iconv
3854 =item C RTL
3856 =back
3858 =item OPERATOR DIFFERENCES
3860 =item FUNCTION DIFFERENCES
3862 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
3864 =item REGULAR EXPRESSION DIFFERENCES
3866 =item SOCKETS
3868 =item SORTING
3870 =over 4
3872 =item Ignore ASCII vs. EBCDIC sort differences.
3874 =item MONO CASE then sort data.
3876 =item Convert, sort data, then re convert.
3878 =item Perform sorting on one type of machine only.
3880 =back
3882 =item TRANSFORMATION FORMATS
3884 =over 4
3886 =item URL decoding and encoding
3888 =item uu encoding and decoding
3890 =item Quoted-Printable encoding and decoding
3892 =item Caesarian ciphers
3894 =back
3896 =item Hashing order and checksums
3898 =item I18N AND L10N
3900 =item MULTI OCTET CHARACTER SETS
3902 =item OS ISSUES
3904 =over 4
3906 =item OS/400
3908 PASE, IFS access
3910 =item OS/390, z/OS
3912 chcp, dataset access, OS/390, z/OS iconv, locales
3914 =item VM/ESA?
3916 =item POSIX-BC?
3918 =back
3920 =item BUGS
3922 =item SEE ALSO
3924 =item REFERENCES
3926 =item HISTORY
3928 =item AUTHOR
3930 =back
3932 =head2 perlsec - Perl security
3934 =over 4
3936 =item DESCRIPTION
3938 =over 4
3940 =item Laundering and Detecting Tainted Data
3942 =item Switches On the "#!" Line
3944 =item Taint mode and @INC
3946 =item Cleaning Up Your Path
3948 =item Security Bugs
3950 =item Protecting Your Programs
3952 =item Unicode
3954 =item Algorithmic Complexity Attacks
3956 =back
3958 =item SEE ALSO
3960 =back
3962 =head2 perlmod - Perl modules (packages and symbol tables)
3964 =over 4
3966 =item DESCRIPTION
3968 =over 4
3970 =item Packages
3971 X<package> X<namespace> X<variable, global> X<global variable> X<global>
3973 =item Symbol Tables
3974 X<symbol table> X<stash> X<%::> X<%main::> X<typeglob> X<glob> X<alias>
3976 =item BEGIN, CHECK, INIT and END
3977 X<BEGIN> X<CHECK> X<INIT> X<END>
3979 =item Perl Classes
3980 X<class> X<@ISA>
3982 =item Perl Modules
3983 X<module>
3985 =item Making your module threadsafe
3986 X<threadsafe> X<thread safe>
3987 X<module, threadsafe> X<module, thread safe>
3988 X<CLONE> X<CLONE_SKIP> X<thread> X<threads> X<ithread>
3990 =back
3992 =item SEE ALSO
3994 =back
3996 =head2 perlmodlib - constructing new Perl modules and finding existing ones
3998 =over 4
4000 =item THE PERL MODULE LIBRARY
4002 =over 4
4004 =item Pragmatic Modules
4006 assertions::compat, attributes, attrs, autouse, base, bigint, bignum,
4007 bigrat, blib, bytes, charnames, constant, diagnostics, encoding, fields,
4008 filetest, if, integer, less, lib, locale, open, ops, overload, re, sigtrap,
4009 sort, strict, subs, threads, threads::shared, utf8, vars, vmsish, warnings,
4010 warnings::register
4012 =item Standard Modules
4014 AnyDBM_File, Archive::Tar, Archive::Tar::File, Attribute::Handlers,
4015 AutoLoader, AutoSplit, B, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode,
4016 B::C, B::CC, B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint,
4017 B::Showlex, B::Stackobj, B::Stash, B::Terse, B::Xref, Benchmark,
4018 ByteLoader, CGI, CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast,
4019 CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util, CPAN, CPAN::FirstTime,
4020 CPAN::Nox, Carp, Carp::Heavy, Class::ISA, Class::Struct, Compress::Zlib,
4021 Config, Cwd, DB, DB_File, Data::Dumper, Devel::DProf, Devel::PPPort,
4022 Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5, Digest::base,
4023 DirHandle, Dumpvalue, DynaLoader, Encode, Encode::Alias, Encode::Byte,
4024 Encode::CJKConstants, Encode::CN, Encode::CN::HZ, Encode::Config,
4025 Encode::EBCDIC, Encode::Encoder, Encode::Encoding, Encode::Guess,
4026 Encode::JP, Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR,
4027 Encode::KR::2022_KR, Encode::MIME::Header, Encode::PerlIO,
4028 Encode::Supported, Encode::Symbol, Encode::TW, Encode::Unicode,
4029 Encode::Unicode::UTF7, English, Env, Errno, Exporter, Exporter::Heavy,
4030 ExtUtils::CBuilder, ExtUtils::CBuilder::Platform::Windows,
4031 ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant,
4032 ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
4033 ExtUtils::MM, ExtUtils::MM_AIX, ExtUtils::MM_Any, ExtUtils::MM_BeOS,
4034 ExtUtils::MM_Cygwin, ExtUtils::MM_DOS, ExtUtils::MM_MacOS,
4035 ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_QNX, ExtUtils::MM_UWIN,
4036 ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_VOS, ExtUtils::MM_Win32,
4037 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker,
4038 ExtUtils::MakeMaker::Config, ExtUtils::MakeMaker::FAQ,
4039 ExtUtils::MakeMaker::Tutorial, ExtUtils::MakeMaker::bytes,
4040 ExtUtils::MakeMaker::vmsish, ExtUtils::Manifest, ExtUtils::Mkbootstrap,
4041 ExtUtils::Mksymlists, ExtUtils::Packlist, ExtUtils::ParseXS,
4042 ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree,
4043 File::Compare, File::Copy, File::DosGlob, File::Find, File::Glob,
4044 File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc,
4045 File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix,
4046 File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache,
4047 FileHandle, Filter::Simple, Filter::Util::Call, FindBin, GDBM_File,
4048 Getopt::Long, Getopt::Std, Hash::Util, I18N::Collate, I18N::LangTags,
4049 I18N::LangTags::List, I18N::Langinfo, IO, IO::Dir, IO::File, IO::Handle,
4050 IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET,
4051 IO::Socket::UNIX, IO::Zlib, IPC::Open2, IPC::Open3, IPC::SysV,
4052 IPC::SysV::Msg, IPC::SysV::Semaphore, List::Util, Locale::Constants,
4053 Locale::Country, Locale::Currency, Locale::Language, Locale::Maketext,
4054 Locale::Maketext::TPJ13, Locale::Script, MIME::Base64,
4055 MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt,
4056 Math::BigInt::Calc, Math::BigInt::FastCalc, Math::BigRat, Math::Complex,
4057 Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire,
4058 Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File,
4059 Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT, Net::Cmd,
4060 Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3,
4061 Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent,
4062 Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO,
4063 PerlIO::encoding, PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint,
4064 Pod::Checker, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects,
4065 Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser,
4066 Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff,
4067 Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText,
4068 Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer,
4069 Pod::Select, Pod::Text, Pod::Text::Color, Pod::Text::Overstrike,
4070 Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Scalar::Util,
4071 Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch,
4072 Symbol, Sys::Hostname, Sys::Syslog, Term::ANSIColor, Term::Cap,
4073 Term::Complete, Term::ReadLine, Test, Test::Builder, Test::Harness,
4074 Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Point,
4075 Test::Harness::Straps, Test::More, Test::Simple, Test::Tutorial,
4076 Text::Abbrev, Text::Balanced, Text::ParseWords, Text::Soundex, Text::Tabs,
4077 Text::Wrap, Thread, Thread::Queue, Thread::Semaphore, Thread::Signal,
4078 Thread::Specific, Tie::Array, Tie::File, Tie::Handle, Tie::Hash,
4079 Tie::Memoize, Tie::RefHash, Tie::Scalar, Tie::SubstrHash, Time::HiRes,
4080 Time::Local, Time::gmtime, Time::localtime, Time::tm, UNIVERSAL,
4081 Unicode::Collate, Unicode::Normalize, Unicode::UCD, User::grent,
4082 User::pwent, Win32, XS::APItest, XS::Typemap, XSLoader
4084 =item Extension Modules
4086 =back
4088 =item CPAN
4090 =over 4
4092 =item Africa
4094 South Africa
4096 =item Asia
4098 China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi
4099 Arabia, Singapore, South Korea, Taiwan, Thailand
4101 =item Central America
4103 Costa Rica
4105 =item Europe
4107 Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Czech
4108 Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary,
4109 Iceland, Ireland, Italy, Latvia, Lithuania, Netherlands, Norway, Poland,
4110 Portugal, Romania, Russia, Slovakia, Slovenia, Spain, Sweden, Switzerland,
4111 Turkey, Ukraine, United Kingdom
4113 =item North America
4115 Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States,
4116 Alabama, California, Colorado, Delaware, District of Columbia, Florida,
4117 Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey, New York,
4118 North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, Utah,
4119 Virginia, Washington, Wisconsin
4121 =item Oceania
4123 Australia, New Zealand, United States
4125 =item South America
4127 Argentina, Brazil, Chile
4129 =item RSYNC Mirrors
4131 =back
4133 =item Modules: Creation, Use, and Abuse
4135 =over 4
4137 =item Guidelines for Module Creation
4139 =item Guidelines for Converting Perl 4 Library Scripts into Modules
4141 =item Guidelines for Reusing Application Code
4143 =back
4145 =item NOTE
4147 =back
4149 =head2 perlmodstyle - Perl module style guide
4151 =over 4
4153 =item INTRODUCTION
4155 =item QUICK CHECKLIST
4157 =over 4
4159 =item Before you start
4161 =item The API
4163 =item Stability
4165 =item Documentation
4167 =item Release considerations
4169 =back
4171 =item BEFORE YOU START WRITING A MODULE
4173 =over 4
4175 =item Has it been done before?
4177 =item Do one thing and do it well
4179 =item What's in a name?
4181 =back
4183 =item DESIGNING AND WRITING YOUR MODULE
4185 =over 4
4187 =item To OO or not to OO?
4189 =item Designing your API
4191 Write simple routines to do simple things, Separate functionality from
4192 output, Provide sensible shortcuts and defaults, Naming conventions,
4193 Parameter passing
4195 =item Strictness and warnings
4197 =item Backwards compatibility
4199 =item Error handling and messages
4201 =back
4203 =item DOCUMENTING YOUR MODULE
4205 =over 4
4207 =item POD
4209 =item README, INSTALL, release notes, changelogs
4211 perl Makefile.PL, make, make test, make install, perl Build.PL, perl Build,
4212 perl Build test, perl Build install
4214 =back
4216 =item RELEASE CONSIDERATIONS
4218 =over 4
4220 =item Version numbering
4222 =item Pre-requisites
4224 =item Testing
4226 =item Packaging
4228 =item Licensing
4230 =back
4232 =item COMMON PITFALLS
4234 =over 4
4236 =item Reinventing the wheel
4238 =item Trying to do too much
4240 =item Inappropriate documentation
4242 =back
4244 =item SEE ALSO
4246 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Packaging Tools,
4247 Testing tools, http://pause.perl.org/, Any good book on software
4248 engineering
4250 =item AUTHOR
4252 =back
4254 =head2 perlmodinstall - Installing CPAN Modules
4256 =over 4
4258 =item DESCRIPTION
4260 =over 4
4262 =item PREAMBLE
4264 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
4265 module (sometimes unnecessary), B<INSTALL> the module
4267 =back
4269 =item PORTABILITY
4271 =item HEY
4273 =item AUTHOR
4275 =item COPYRIGHT
4277 =back
4279 =head2 perlnewmod - preparing a new module for distribution
4281 =over 4
4283 =item DESCRIPTION
4285 =over 4
4287 =item Warning
4289 =item What should I make into a module?
4291 =item Step-by-step: Preparing the ground
4293 Look around, Check it's new, Discuss the need, Choose a name, Check again
4295 =item Step-by-step: Making the module
4297 Start with F<module-starter> or F<h2xs>, Use L<strict|strict> and
4298 L<warnings|warnings>, Use L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!,
4299 Use L<plain old documentation|perlpod>, Write tests, Write the README
4301 =item Step-by-step: Distributing your module
4303 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
4304 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
4306 =back
4308 =item AUTHOR
4310 =item SEE ALSO
4312 =back
4314 =head2 perlutil - utilities packaged with the Perl distribution
4316 =over 4
4318 =item DESCRIPTION
4320 =over 4
4322 =item DOCUMENTATION
4324 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
4325 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
4326 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
4327 L<roffitall|roffitall>
4329 =item CONVERTORS
4331 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
4333 =item Administration
4335 L<libnetcfg|libnetcfg>
4337 =item Development
4339 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
4340 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
4342 =item SEE ALSO
4344 =back
4346 =back
4348 =head2 perlcompile - Introduction to the Perl Compiler-Translator 
4350 =over 4
4352 =item DESCRIPTION
4354 =over 4
4356 =item Layout
4358 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
4360 =back
4362 =item Using The Back Ends
4364 =over 4
4366 =item The Cross Referencing Back End
4368 i, &, s, r
4370 =item The Decompiling Back End
4372 =item The Lint Back End
4374 =item The Simple C Back End
4376 =item The Bytecode Back End
4378 =item The Optimized C Back End
4380 =back
4382 =item Module List for the Compiler Suite
4384 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
4385 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
4386 B::Stackobj, B::Stash, B::Terse, B::Xref
4388 =item KNOWN PROBLEMS
4390 =item AUTHOR
4392 =back
4394 =head2 perlfilter - Source Filters
4396 =over 4
4398 =item DESCRIPTION
4400 =item CONCEPTS
4402 =item USING FILTERS
4404 =item WRITING A SOURCE FILTER
4406 =item WRITING A SOURCE FILTER IN C
4408 B<Decryption Filters>
4410 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4412 =item WRITING A SOURCE FILTER IN PERL
4414 =item USING CONTEXT: THE DEBUG FILTER
4416 =item CONCLUSION
4418 =item THINGS TO LOOK OUT FOR
4420 Some Filters Clobber the C<DATA> Handle
4422 =item REQUIREMENTS
4424 =item AUTHOR
4426 =item Copyrights
4428 =back
4430 =head2 perlglossary - Perl Glossary
4432 =over 4
4434 =item DESCRIPTION
4436 =over 4
4438 =item A
4440 accessor methods, actual arguments, address operator, algorithm, alias,
4441 alternatives, anonymous, architecture, argument, ARGV, arithmetical
4442 operator, array, array context, ASCII, assertion, assignment, assignment
4443 operator, associative array, associativity, asynchronous, atom, atomic
4444 operation, attribute, autogeneration, autoincrement, autoload, autosplit,
4445 autovivification, AV, awk
4447 =item B
4449 backreference, backtracking, backward compatibility, bareword, base class,
4450 big-endian, binary, binary operator, bind, bit, bit shift, bit string,
4451 bless, block, BLOCK, block buffering, Boolean, Boolean context, breakpoint,
4452 broadcast, BSD, bucket, buffer, built-in, bundle, byte, bytecode
4454 =item C
4456 C, C preprocessor, call by reference, call by value, callback, canonical,
4457 capturing, character, character class, character property, circumfix
4458 operator, class, class method, client, cloister, closure, cluster, CODE,
4459 code generator, code subpattern, collating sequence, command, command
4460 buffering, command name, command-line arguments, comment, compilation unit,
4461 compile phase, compile time, compiler, composer, concatenation,
4462 conditional, connection, construct, constructor, context, continuation,
4463 core dump, CPAN, cracker, current package, current working directory,
4464 currently selected output channel, CV
4466 =item D
4468 dangling statement, data structure, data type, datagram, DBM, declaration,
4469 decrement, default, defined, delimiter, dereference, derived class,
4470 descriptor, destroy, destructor, device, directive, directory, directory
4471 handle, dispatch, distribution, dweomer, dwimmer, dynamic scoping
4473 =item E
4475 eclectic, element, embedding, empty subclass test, en passant,
4476 encapsulation, endian, environment, environment variable, EOF, errno,
4477 error, escape sequence, exception, exception handling, exec, executable
4478 file, execute, execute bit, exit status, export, expression, extension
4480 =item F
4482 false, FAQ, fatal error, field, FIFO, file, file descriptor, file test
4483 operator, fileglob, filehandle, filename, filesystem, filter, flag,
4484 floating point, flush, FMTEYEWTK, fork, formal arguments, format, freely
4485 available, freely redistributable, freeware, function, funny character,
4486 garbage collection
4488 =item G
4490 GID, glob, global, global destruction, glue language, granularity, greedy,
4491 grep, group, GV
4493 =item H
4495 hacker, handler, hard reference, hash, hash table, header file, here
4496 document, hexadecimal, home directory, host, hubris, HV
4498 =item I
4500 identifier, impatience, implementation, import, increment, indexing,
4501 indirect filehandle, indirect object, indirect object slot, indirection,
4502 infix, inheritance, instance, instance variable, integer, interface,
4503 interpolation, interpreter, invocant, invocation, I/O, IO, IP, IPC, is-a,
4504 iteration, iterator, IV
4506 =item J
4508 JAPH
4510 =item K
4512 key, keyword
4514 =item L
4516 label, laziness, left shift, leftmost longest, lexeme, lexer, lexical
4517 analysis, lexical scoping, lexical variable, library, LIFO, line, line
4518 buffering, line number, link, LIST, list, list context, list operator, list
4519 value, literal, little-endian, local, logical operator, lookahead,
4520 lookbehind, loop, loop control statement, loop label, lvaluable, lvalue,
4521 lvalue modifier
4523 =item M
4525 magic, magical increment, magical variables, Makefile, man, manpage,
4526 matching, member data, memory, metacharacter, metasymbol, method,
4527 minimalism, mode, modifier, module, modulus, monger, mortal,
4528 multidimensional array, multiple inheritance
4530 =item N
4532 named pipe, namespace, network address, newline, NFS, null character, null
4533 list, null string, numeric context, NV, nybble
4535 =item O
4537 object, octal, offset, one-liner, open source software, operand, operating
4538 system, operator, operator overloading, options, overloading, overriding,
4539 owner
4541 =item P
4543 package, pad, parameter, parent class, parse tree, parsing, patch, PATH,
4544 pathname, pattern, pattern matching, permission bits, Pern, pipe, pipeline,
4545 platform, pod, pointer, polymorphism, port, portable, porter, POSIX,
4546 postfix, pp, pragma, precedence, prefix, preprocessing, procedure, process,
4547 program generator, progressive matching, property, protocol, prototype,
4548 pseudofunction, pseudohash, pseudoliteral, public domain, pumpkin,
4549 pumpking, PV
4551 =item Q
4553 qualified, quantifier
4555 =item R
4557 readable, reaping, record, recursion, reference, referent, regex, regular
4558 expression, regular expression modifier, regular file, relational operator,
4559 reserved words, return value, RFC, right shift, root, RTFM, run phase, run
4560 time, run-time pattern, RV, rvalue
4562 =item S
4564 scalar, scalar context, scalar literal, scalar value, scalar variable,
4565 scope, scratchpad, script, script kiddie, sed, semaphore, separator,
4566 serialization, server, service, setgid, setuid, shared memory, shebang,
4567 shell, side effects, signal, signal handler, single inheritance, slice,
4568 slurp, socket, soft reference, source filter, stack, standard, standard
4569 error, standard I/O, standard input, standard output, stat structure,
4570 statement, statement modifier, static, static method, static scoping,
4571 static variable, status, STDERR, STDIN, STDIO, STDOUT, stream, string,
4572 string context, stringification, struct, structure, subclass, subpattern,
4573 subroutine, subscript, substitution, substring, superclass, superuser, SV,
4574 switch, switch cluster, switch statement, symbol, symbol table, symbolic
4575 debugger, symbolic link, symbolic reference, synchronous, syntactic sugar,
4576 syntax, syntax tree, syscall
4578 =item T
4580 tainted, TCP, term, terminator, ternary, text, thread, tie, TMTOWTDI,
4581 token, tokener, tokenizing, toolbox approach, transliterate, trigger,
4582 trinary, troff, true, truncating, type, type casting, typed lexical,
4583 typedef, typeglob, typemap
4585 =item U
4587 UDP, UID, umask, unary operator, Unicode, Unix
4589 =item V
4591 value, variable, variable interpolation, variadic, vector, virtual, void
4592 context, v-string
4594 =item W
4596 warning, watch expression, whitespace, word, working directory, wrapper,
4597 WYSIWYG
4599 =item X
4601 XS, XSUB
4603 =item Y
4605 yacc
4607 =item Z
4609 zero width, zombie
4611 =back
4613 =item AUTHOR AND COPYRIGHT
4615 =back
4617 =head2 perlembed - how to embed perl in your C program
4619 =over 4
4621 =item DESCRIPTION
4623 =over 4
4625 =item PREAMBLE
4627 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
4628 Perl?>, B<Use C from C?>, B<Use Perl from C?>
4630 =item ROADMAP
4632 =item Compiling your C program
4634 =item Adding a Perl interpreter to your C program
4636 =item Calling a Perl subroutine from your C program
4638 =item Evaluating a Perl statement from your C program
4640 =item Performing Perl pattern matches and substitutions from your C program
4642 =item Fiddling with the Perl stack from your C program
4644 =item Maintaining a persistent interpreter
4646 =item Execution of END blocks
4648 =item Maintaining multiple interpreter instances
4650 =item Using Perl modules, which themselves use C libraries, from your C
4651 program
4653 =back
4655 =item Embedding Perl under Win32
4657 =item Hiding Perl_
4659 =item MORAL
4661 =item AUTHOR
4663 =item COPYRIGHT
4665 =back
4667 =head2 perldebguts - Guts of Perl debugging 
4669 =over 4
4671 =item DESCRIPTION
4673 =item Debugger Internals
4675 =over 4
4677 =item Writing Your Own Debugger
4679 =back
4681 =item Frame Listing Output Examples
4683 =item Debugging regular expressions
4685 =over 4
4687 =item Compile-time output
4689 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
4690 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
4691 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
4692 C<anchored(TYPE)>
4694 =item Types of nodes
4696 =item Run-time output
4698 =back
4700 =item Debugging Perl memory usage
4702 =over 4
4704 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
4706 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
4707 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
4708 6144>
4710 =back
4712 =item SEE ALSO
4714 =back
4716 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
4718 =over 4
4720 =item DESCRIPTION
4722 =item SPECIAL NOTES
4724 =over 4
4726 =item make
4728 =item Version caveat
4730 =item Dynamic Loading versus Static Loading
4732 =back
4734 =item TUTORIAL
4736 =over 4
4738 =item EXAMPLE 1
4740 =item EXAMPLE 2
4742 =item What has gone on?
4744 =item Writing good test scripts
4746 =item EXAMPLE 3
4748 =item What's new here?
4750 =item Input and Output Parameters
4752 =item The XSUBPP Program
4754 =item The TYPEMAP file
4756 =item Warning about Output Arguments
4758 =item EXAMPLE 4
4760 =item What has happened here?
4762 =item Anatomy of .xs file
4764 =item Getting the fat out of XSUBs
4766 =item More about XSUB arguments
4768 =item The Argument Stack
4770 =item Extending your Extension
4772 =item Documenting your Extension
4774 =item Installing your Extension
4776 =item EXAMPLE 5
4778 =item New Things in this Example
4780 =item EXAMPLE 6
4782 =item New Things in this Example
4784 =item EXAMPLE 7 (Coming Soon)
4786 =item EXAMPLE 8 (Coming Soon)
4788 =item EXAMPLE 9 Passing open files to XSes
4790 =item Troubleshooting these Examples
4792 =back
4794 =item See also
4796 =item Author
4798 =over 4
4800 =item Last Changed
4802 =back
4804 =back
4806 =head2 perlxs - XS language reference manual
4808 =over 4
4810 =item DESCRIPTION
4812 =over 4
4814 =item Introduction
4816 =item On The Road
4818 =item The Anatomy of an XSUB
4820 =item The Argument Stack
4822 =item The RETVAL Variable
4824 =item Returning SVs, AVs and HVs through RETVAL
4826 =item The MODULE Keyword
4828 =item The PACKAGE Keyword
4830 =item The PREFIX Keyword
4832 =item The OUTPUT: Keyword
4834 =item The NO_OUTPUT Keyword
4836 =item The CODE: Keyword
4838 =item The INIT: Keyword
4840 =item The NO_INIT Keyword
4842 =item Initializing Function Parameters
4844 =item Default Parameter Values
4846 =item The PREINIT: Keyword
4848 =item The SCOPE: Keyword
4850 =item The INPUT: Keyword
4852 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
4854 =item The C<length(NAME)> Keyword
4856 =item Variable-length Parameter Lists
4858 =item The C_ARGS: Keyword
4860 =item The PPCODE: Keyword
4862 =item Returning Undef And Empty Lists
4864 =item The REQUIRE: Keyword
4866 =item The CLEANUP: Keyword
4868 =item The POSTCALL: Keyword
4870 =item The BOOT: Keyword
4872 =item The VERSIONCHECK: Keyword
4874 =item The PROTOTYPES: Keyword
4876 =item The PROTOTYPE: Keyword
4878 =item The ALIAS: Keyword
4880 =item The OVERLOAD: Keyword
4882 =item The FALLBACK: Keyword
4884 =item The INTERFACE: Keyword
4886 =item The INTERFACE_MACRO: Keyword
4888 =item The INCLUDE: Keyword
4890 =item The CASE: Keyword
4892 =item The & Unary Operator
4894 =item Inserting POD, Comments and C Preprocessor Directives
4896 =item Using XS With C++
4898 =item Interface Strategy
4900 =item Perl Objects And C Structures
4902 =item The Typemap
4904 =item Safely Storing Static Data in XS
4906 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4908 =back
4910 =item EXAMPLES
4912 =item XS VERSION
4914 =item AUTHOR
4916 =back
4918 =head2 perlclib - Internal replacements for standard C library functions
4920 =over 4
4922 =item DESCRIPTION
4924 =over 4
4926 =item Conventions
4928 C<t>, C<p>, C<n>, C<s>
4930 =item File Operations
4932 =item File Input and Output
4934 =item File Positioning
4936 =item Memory Management and String Handling
4938 =item Character Class Tests
4940 =item F<stdlib.h> functions
4942 =item Miscellaneous functions
4944 =back
4946 =item SEE ALSO
4948 =back
4950 =head2 perlguts - Introduction to the Perl API
4952 =over 4
4954 =item DESCRIPTION
4956 =item Variables
4958 =over 4
4960 =item Datatypes
4962 =item What is an "IV"?
4964 =item Working with SVs
4966 =item Offsets
4968 =item What's Really Stored in an SV?
4970 =item Working with AVs
4972 =item Working with HVs
4974 =item Hash API Extensions
4976 =item AVs, HVs and undefined values
4978 =item References
4980 =item Blessed References and Class Objects
4982 =item Creating New Variables
4984 GV_ADDMULTI, GV_ADDWARN
4986 =item Reference Counts and Mortality
4988 =item Stashes and Globs
4990 =item Double-Typed SVs
4992 =item Magic Variables
4994 =item Assigning Magic
4996 =item Magic Virtual Tables
4998 =item Finding Magic
5000 =item Understanding the Magic of Tied Hashes and Arrays
5002 =item Localizing changes
5004 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
5005 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
5006 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
5007 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
5008 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
5009 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
5010 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
5011 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
5012 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
5013 save_hptr(HV **hptr)>
5015 =back
5017 =item Subroutines
5019 =over 4
5021 =item XSUBs and the Argument Stack
5023 =item Calling Perl Routines from within C Programs
5025 =item Memory Allocation
5027 =item PerlIO
5029 =item Putting a C value on Perl stack
5031 =item Scratchpads
5033 =item Scratchpads and recursion
5035 =back
5037 =item Compiled code
5039 =over 4
5041 =item Code tree
5043 =item Examining the tree
5045 =item Compile pass 1: check routines
5047 =item Compile pass 1a: constant folding
5049 =item Compile pass 2: context propagation
5051 =item Compile pass 3: peephole optimization
5053 =item Pluggable runops
5055 =back
5057 =item Examining internal data structures with the C<dump> functions
5059 =item How multiple interpreters and concurrency are supported
5061 =over 4
5063 =item Background and PERL_IMPLICIT_CONTEXT
5065 =item So what happened to dTHR?
5067 =item How do I use all this in extensions?
5069 =item Should I do anything special if I call perl from multiple threads?
5071 =item Future Plans and PERL_IMPLICIT_SYS
5073 =back
5075 =item Internal Functions
5077 A, p, d, s, n, r, f, M, o, x, m, X, E, b
5079 =over 4
5081 =item Formatted Printing of IVs, UVs, and NVs
5083 =item Pointer-To-Integer and Integer-To-Pointer
5085 =item Source Documentation
5087 =item Backwards compatibility
5089 =back
5091 =item Unicode Support
5093 =over 4
5095 =item What B<is> Unicode, anyway?
5097 =item How can I recognise a UTF-8 string?
5099 =item How does UTF-8 represent Unicode characters?
5101 =item How does Perl store UTF-8 strings?
5103 =item How do I convert a string to UTF-8?
5105 =item Is there anything else I need to know?
5107 =back
5109 =item Custom Operators
5111 =item AUTHORS
5113 =item SEE ALSO
5115 =back
5117 =head2 perlcall - Perl calling conventions from C
5119 =over 4
5121 =item DESCRIPTION
5123 An Error Handler, An Event Driven Program
5125 =item THE CALL_ FUNCTIONS
5127 call_sv, call_pv, call_method, call_argv
5129 =item FLAG VALUES
5131 =over 4
5133 =item  G_VOID
5135 =item  G_SCALAR
5137 =item G_ARRAY
5139 =item G_DISCARD
5141 =item G_NOARGS
5143 =item G_EVAL
5145 =item G_KEEPERR
5147 =item Determining the Context
5149 =back
5151 =item EXAMPLES
5153 =over 4
5155 =item No Parameters, Nothing returned
5157 =item Passing Parameters
5159 =item Returning a Scalar
5161 =item Returning a list of values
5163 =item Returning a list in a scalar context
5165 =item Returning Data from Perl via the parameter list
5167 =item Using G_EVAL
5169 =item Using G_KEEPERR
5171 =item Using call_sv
5173 =item Using call_argv
5175 =item Using call_method
5177 =item Using GIMME_V
5179 =item Using Perl to dispose of temporaries
5181 =item Strategies for storing Callback Context Information
5183 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
5184 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
5185 callback
5187 =item Alternate Stack Manipulation
5189 =item Creating and calling an anonymous subroutine in C
5191 =back
5193 =item SEE ALSO
5195 =item AUTHOR
5197 =item DATE
5199 =back
5201 =head2 perlapi - autogenerated documentation for the perl public API
5203 =over 4
5205 =item DESCRIPTION
5206 X<Perl API> X<API> X<api>
5208 =item "Gimme" Values
5210 GIMME X<GIMME>, GIMME_V X<GIMME_V>, G_ARRAY X<G_ARRAY>, G_DISCARD
5211 X<G_DISCARD>, G_EVAL X<G_EVAL>, G_NOARGS X<G_NOARGS>, G_SCALAR X<G_SCALAR>,
5212 G_VOID X<G_VOID>
5214 =item Array Manipulation Functions
5216 AvFILL X<AvFILL>, av_clear X<av_clear>, av_delete X<av_delete>, av_exists
5217 X<av_exists>, av_extend X<av_extend>, av_fetch X<av_fetch>, av_fill
5218 X<av_fill>, av_len X<av_len>, av_make X<av_make>, av_pop X<av_pop>, av_push
5219 X<av_push>, av_shift X<av_shift>, av_store X<av_store>, av_undef
5220 X<av_undef>, av_unshift X<av_unshift>, get_av X<get_av>, newAV X<newAV>,
5221 sortsv X<sortsv>
5223 =item Callback Functions
5225 call_argv X<call_argv>, call_method X<call_method>, call_pv X<call_pv>,
5226 call_sv X<call_sv>, ENTER X<ENTER>, eval_pv X<eval_pv>, eval_sv X<eval_sv>,
5227 FREETMPS X<FREETMPS>, LEAVE X<LEAVE>, SAVETMPS X<SAVETMPS>
5229 =item Character classes
5231 isALNUM X<isALNUM>, isALPHA X<isALPHA>, isDIGIT X<isDIGIT>, isLOWER
5232 X<isLOWER>, isSPACE X<isSPACE>, isUPPER X<isUPPER>, toLOWER X<toLOWER>,
5233 toUPPER X<toUPPER>
5235 =item Cloning an interpreter
5237 perl_clone X<perl_clone>
5239 =item CV Manipulation Functions
5241 CvSTASH X<CvSTASH>, get_cv X<get_cv>
5243 =item Embedding Functions
5245 cv_undef X<cv_undef>, load_module X<load_module>, nothreadhook
5246 X<nothreadhook>, perl_alloc X<perl_alloc>, perl_construct
5247 X<perl_construct>, perl_destruct X<perl_destruct>, perl_free X<perl_free>,
5248 perl_parse X<perl_parse>, perl_run X<perl_run>, require_pv X<require_pv>
5250 =item Functions in file pp_pack.c
5252 packlist X<packlist>, pack_cat X<pack_cat>, unpackstring X<unpackstring>,
5253 unpack_str X<unpack_str>
5255 =item Global Variables
5257 PL_modglobal X<PL_modglobal>, PL_na X<PL_na>, PL_sv_no X<PL_sv_no>,
5258 PL_sv_undef X<PL_sv_undef>, PL_sv_yes X<PL_sv_yes>
5260 =item GV Functions
5262 GvSV X<GvSV>, gv_fetchmeth X<gv_fetchmeth>, gv_fetchmethod
5263 X<gv_fetchmethod>, gv_fetchmethod_autoload X<gv_fetchmethod_autoload>,
5264 gv_fetchmeth_autoload X<gv_fetchmeth_autoload>, gv_stashpv X<gv_stashpv>,
5265 gv_stashpvn X<gv_stashpvn>, gv_stashsv X<gv_stashsv>
5267 =item Handy Values
5269 Nullav X<Nullav>, Nullch X<Nullch>, Nullcv X<Nullcv>, Nullhv X<Nullhv>,
5270 Nullsv X<Nullsv>
5272 =item Hash Manipulation Functions
5274 get_hv X<get_hv>, HEf_SVKEY X<HEf_SVKEY>, HeHASH X<HeHASH>, HeKEY X<HeKEY>,
5275 HeKLEN X<HeKLEN>, HePV X<HePV>, HeSVKEY X<HeSVKEY>, HeSVKEY_force
5276 X<HeSVKEY_force>, HeSVKEY_set X<HeSVKEY_set>, HeVAL X<HeVAL>, HvNAME
5277 X<HvNAME>, hv_clear X<hv_clear>, hv_clear_placeholders
5278 X<hv_clear_placeholders>, hv_delete X<hv_delete>, hv_delete_ent
5279 X<hv_delete_ent>, hv_exists X<hv_exists>, hv_exists_ent X<hv_exists_ent>,
5280 hv_fetch X<hv_fetch>, hv_fetch_ent X<hv_fetch_ent>, hv_iterinit
5281 X<hv_iterinit>, hv_iterkey X<hv_iterkey>, hv_iterkeysv X<hv_iterkeysv>,
5282 hv_iternext X<hv_iternext>, hv_iternextsv X<hv_iternextsv>,
5283 hv_iternext_flags X<hv_iternext_flags>, hv_iterval X<hv_iterval>, hv_magic
5284 X<hv_magic>, hv_scalar X<hv_scalar>, hv_store X<hv_store>, hv_store_ent
5285 X<hv_store_ent>, hv_undef X<hv_undef>, newHV X<newHV>
5287 =item Magical Functions
5289 mg_clear X<mg_clear>, mg_copy X<mg_copy>, mg_find X<mg_find>, mg_free
5290 X<mg_free>, mg_get X<mg_get>, mg_length X<mg_length>, mg_magical
5291 X<mg_magical>, mg_set X<mg_set>, SvGETMAGIC X<SvGETMAGIC>, SvLOCK
5292 X<SvLOCK>, SvSETMAGIC X<SvSETMAGIC>, SvSetMagicSV X<SvSetMagicSV>,
5293 SvSetMagicSV_nosteal X<SvSetMagicSV_nosteal>, SvSetSV X<SvSetSV>,
5294 SvSetSV_nosteal X<SvSetSV_nosteal>, SvSHARE X<SvSHARE>, SvUNLOCK
5295 X<SvUNLOCK>
5297 =item Memory Management
5299 Copy X<Copy>, CopyD X<CopyD>, Move X<Move>, MoveD X<MoveD>, Newx X<Newx>,
5300 Newxc X<Newxc>, Newxz X<Newxz>, Poison X<Poison>, Renew X<Renew>, Renewc
5301 X<Renewc>, Safefree X<Safefree>, savepv X<savepv>, savepvn X<savepvn>,
5302 savesharedpv X<savesharedpv>, savesvpv X<savesvpv>, StructCopy
5303 X<StructCopy>, Zero X<Zero>, ZeroD X<ZeroD>
5305 =item Miscellaneous Functions
5307 fbm_compile X<fbm_compile>, fbm_instr X<fbm_instr>, form X<form>, getcwd_sv
5308 X<getcwd_sv>, strEQ X<strEQ>, strGE X<strGE>, strGT X<strGT>, strLE
5309 X<strLE>, strLT X<strLT>, strNE X<strNE>, strnEQ X<strnEQ>, strnNE
5310 X<strnNE>, sv_nolocking X<sv_nolocking>, sv_nosharing X<sv_nosharing>,
5311 sv_nounlocking X<sv_nounlocking>
5313 =item Numeric functions
5315 grok_bin X<grok_bin>, grok_hex X<grok_hex>, grok_number X<grok_number>,
5316 grok_numeric_radix X<grok_numeric_radix>, grok_oct X<grok_oct>, scan_bin
5317 X<scan_bin>, scan_hex X<scan_hex>, scan_oct X<scan_oct>
5319 =item Optree Manipulation Functions
5321 cv_const_sv X<cv_const_sv>, newCONSTSUB X<newCONSTSUB>, newXS X<newXS>
5323 =item Pad Data Structures
5325 pad_sv X<pad_sv>
5327 =item Stack Manipulation Macros
5329 dMARK X<dMARK>, dORIGMARK X<dORIGMARK>, dSP X<dSP>, EXTEND X<EXTEND>, MARK
5330 X<MARK>, mPUSHi X<mPUSHi>, mPUSHn X<mPUSHn>, mPUSHp X<mPUSHp>, mPUSHu
5331 X<mPUSHu>, mXPUSHi X<mXPUSHi>, mXPUSHn X<mXPUSHn>, mXPUSHp X<mXPUSHp>,
5332 mXPUSHu X<mXPUSHu>, ORIGMARK X<ORIGMARK>, POPi X<POPi>, POPl X<POPl>, POPn
5333 X<POPn>, POPp X<POPp>, POPpbytex X<POPpbytex>, POPpx X<POPpx>, POPs
5334 X<POPs>, PUSHi X<PUSHi>, PUSHMARK X<PUSHMARK>, PUSHmortal X<PUSHmortal>,
5335 PUSHn X<PUSHn>, PUSHp X<PUSHp>, PUSHs X<PUSHs>, PUSHu X<PUSHu>, PUTBACK
5336 X<PUTBACK>, SP X<SP>, SPAGAIN X<SPAGAIN>, XPUSHi X<XPUSHi>, XPUSHmortal
5337 X<XPUSHmortal>, XPUSHn X<XPUSHn>, XPUSHp X<XPUSHp>, XPUSHs X<XPUSHs>,
5338 XPUSHu X<XPUSHu>, XSRETURN X<XSRETURN>, XSRETURN_EMPTY X<XSRETURN_EMPTY>,
5339 XSRETURN_IV X<XSRETURN_IV>, XSRETURN_NO X<XSRETURN_NO>, XSRETURN_NV
5340 X<XSRETURN_NV>, XSRETURN_PV X<XSRETURN_PV>, XSRETURN_UNDEF
5341 X<XSRETURN_UNDEF>, XSRETURN_UV X<XSRETURN_UV>, XSRETURN_YES
5342 X<XSRETURN_YES>, XST_mIV X<XST_mIV>, XST_mNO X<XST_mNO>, XST_mNV
5343 X<XST_mNV>, XST_mPV X<XST_mPV>, XST_mUNDEF X<XST_mUNDEF>, XST_mYES
5344 X<XST_mYES>
5346 =item SV Flags
5348 svtype X<svtype>, SVt_IV X<SVt_IV>, SVt_NV X<SVt_NV>, SVt_PV X<SVt_PV>,
5349 SVt_PVAV X<SVt_PVAV>, SVt_PVCV X<SVt_PVCV>, SVt_PVHV X<SVt_PVHV>, SVt_PVMG
5350 X<SVt_PVMG>
5352 =item SV Manipulation Functions
5354 get_sv X<get_sv>, looks_like_number X<looks_like_number>, newRV_inc
5355 X<newRV_inc>, newRV_noinc X<newRV_noinc>, NEWSV X<NEWSV>, newSV X<newSV>,
5356 newSVhek X<newSVhek>, newSViv X<newSViv>, newSVnv X<newSVnv>, newSVpv
5357 X<newSVpv>, newSVpvf X<newSVpvf>, newSVpvn X<newSVpvn>, newSVpvn_share
5358 X<newSVpvn_share>, newSVrv X<newSVrv>, newSVsv X<newSVsv>, newSVuv
5359 X<newSVuv>, SvCUR X<SvCUR>, SvCUR_set X<SvCUR_set>, SvEND X<SvEND>, SvGROW
5360 X<SvGROW>, SvIOK X<SvIOK>, SvIOKp X<SvIOKp>, SvIOK_notUV X<SvIOK_notUV>,
5361 SvIOK_off X<SvIOK_off>, SvIOK_on X<SvIOK_on>, SvIOK_only X<SvIOK_only>,
5362 SvIOK_only_UV X<SvIOK_only_UV>, SvIOK_UV X<SvIOK_UV>, SvIsCOW X<SvIsCOW>,
5363 SvIsCOW_shared_hash X<SvIsCOW_shared_hash>, SvIV X<SvIV>, SvIVX X<SvIVX>,
5364 SvIVx X<SvIVx>, SvIV_set X<SvIV_set>, SvLEN X<SvLEN>, SvLEN_set
5365 X<SvLEN_set>, SvMAGIC_set X<SvMAGIC_set>, SvNIOK X<SvNIOK>, SvNIOKp
5366 X<SvNIOKp>, SvNIOK_off X<SvNIOK_off>, SvNOK X<SvNOK>, SvNOKp X<SvNOKp>,
5367 SvNOK_off X<SvNOK_off>, SvNOK_on X<SvNOK_on>, SvNOK_only X<SvNOK_only>,
5368 SvNV X<SvNV>, SvNVX X<SvNVX>, SvNVx X<SvNVx>, SvNV_set X<SvNV_set>, SvOK
5369 X<SvOK>, SvOOK X<SvOOK>, SvPOK X<SvPOK>, SvPOKp X<SvPOKp>, SvPOK_off
5370 X<SvPOK_off>, SvPOK_on X<SvPOK_on>, SvPOK_only X<SvPOK_only>,
5371 SvPOK_only_UTF8 X<SvPOK_only_UTF8>, SvPV X<SvPV>, SvPVbyte X<SvPVbyte>,
5372 SvPVbytex X<SvPVbytex>, SvPVbytex_force X<SvPVbytex_force>, SvPVbyte_force
5373 X<SvPVbyte_force>, SvPVbyte_nolen X<SvPVbyte_nolen>, SvPVutf8 X<SvPVutf8>,
5374 SvPVutf8x X<SvPVutf8x>, SvPVutf8x_force X<SvPVutf8x_force>, SvPVutf8_force
5375 X<SvPVutf8_force>, SvPVutf8_nolen X<SvPVutf8_nolen>, SvPVX X<SvPVX>, SvPVx
5376 X<SvPVx>, SvPV_force X<SvPV_force>, SvPV_force_nomg X<SvPV_force_nomg>,
5377 SvPV_nolen X<SvPV_nolen>, SvPV_set X<SvPV_set>, SvREFCNT X<SvREFCNT>,
5378 SvREFCNT_dec X<SvREFCNT_dec>, SvREFCNT_inc X<SvREFCNT_inc>, SvROK X<SvROK>,
5379 SvROK_off X<SvROK_off>, SvROK_on X<SvROK_on>, SvRV X<SvRV>, SvRV_set
5380 X<SvRV_set>, SvSTASH X<SvSTASH>, SvSTASH_set X<SvSTASH_set>, SvTAINT
5381 X<SvTAINT>, SvTAINTED X<SvTAINTED>, SvTAINTED_off X<SvTAINTED_off>,
5382 SvTAINTED_on X<SvTAINTED_on>, SvTRUE X<SvTRUE>, SvTYPE X<SvTYPE>, SvUOK
5383 X<SvUOK>, SvUPGRADE X<SvUPGRADE>, SvUTF8 X<SvUTF8>, SvUTF8_off
5384 X<SvUTF8_off>, SvUTF8_on X<SvUTF8_on>, SvUV X<SvUV>, SvUVX X<SvUVX>, SvUVx
5385 X<SvUVx>, SvUV_set X<SvUV_set>, sv_2bool X<sv_2bool>, sv_2cv X<sv_2cv>,
5386 sv_2io X<sv_2io>, sv_2iv X<sv_2iv>, sv_2mortal X<sv_2mortal>, sv_2nv
5387 X<sv_2nv>, sv_2pvbyte X<sv_2pvbyte>, sv_2pvbyte_nolen X<sv_2pvbyte_nolen>,
5388 sv_2pvutf8 X<sv_2pvutf8>, sv_2pvutf8_nolen X<sv_2pvutf8_nolen>,
5389 sv_2pv_flags X<sv_2pv_flags>, sv_2pv_nolen X<sv_2pv_nolen>, sv_2uv
5390 X<sv_2uv>, sv_backoff X<sv_backoff>, sv_bless X<sv_bless>, sv_catpv
5391 X<sv_catpv>, sv_catpvf X<sv_catpvf>, sv_catpvf_mg X<sv_catpvf_mg>,
5392 sv_catpvn X<sv_catpvn>, sv_catpvn_flags X<sv_catpvn_flags>, sv_catpvn_mg
5393 X<sv_catpvn_mg>, sv_catpvn_nomg X<sv_catpvn_nomg>, sv_catpv_mg
5394 X<sv_catpv_mg>, sv_catsv X<sv_catsv>, sv_catsv_flags X<sv_catsv_flags>,
5395 sv_catsv_mg X<sv_catsv_mg>, sv_catsv_nomg X<sv_catsv_nomg>, sv_chop
5396 X<sv_chop>, sv_clear X<sv_clear>, sv_cmp X<sv_cmp>, sv_cmp_locale
5397 X<sv_cmp_locale>, sv_collxfrm X<sv_collxfrm>, sv_copypv X<sv_copypv>,
5398 sv_dec X<sv_dec>, sv_derived_from X<sv_derived_from>, sv_eq X<sv_eq>,
5399 sv_force_normal X<sv_force_normal>, sv_force_normal_flags
5400 X<sv_force_normal_flags>, sv_free X<sv_free>, sv_gets X<sv_gets>, sv_grow
5401 X<sv_grow>, sv_inc X<sv_inc>, sv_insert X<sv_insert>, sv_isa X<sv_isa>,
5402 sv_isobject X<sv_isobject>, sv_iv X<sv_iv>, sv_len X<sv_len>, sv_len_utf8
5403 X<sv_len_utf8>, sv_magic X<sv_magic>, sv_magicext X<sv_magicext>,
5404 sv_mortalcopy X<sv_mortalcopy>, sv_newmortal X<sv_newmortal>, sv_newref
5405 X<sv_newref>, sv_nv X<sv_nv>, sv_pos_b2u X<sv_pos_b2u>, sv_pos_u2b
5406 X<sv_pos_u2b>, sv_pv X<sv_pv>, sv_pvbyte X<sv_pvbyte>, sv_pvbyten
5407 X<sv_pvbyten>, sv_pvbyten_force X<sv_pvbyten_force>, sv_pvn X<sv_pvn>,
5408 sv_pvn_force X<sv_pvn_force>, sv_pvn_force_flags X<sv_pvn_force_flags>,
5409 sv_pvutf8 X<sv_pvutf8>, sv_pvutf8n X<sv_pvutf8n>, sv_pvutf8n_force
5410 X<sv_pvutf8n_force>, sv_reftype X<sv_reftype>, sv_replace X<sv_replace>,
5411 sv_report_used X<sv_report_used>, sv_reset X<sv_reset>, sv_rvweaken
5412 X<sv_rvweaken>, sv_setiv X<sv_setiv>, sv_setiv_mg X<sv_setiv_mg>, sv_setnv
5413 X<sv_setnv>, sv_setnv_mg X<sv_setnv_mg>, sv_setpv X<sv_setpv>, sv_setpvf
5414 X<sv_setpvf>, sv_setpvf_mg X<sv_setpvf_mg>, sv_setpviv X<sv_setpviv>,
5415 sv_setpviv_mg X<sv_setpviv_mg>, sv_setpvn X<sv_setpvn>, sv_setpvn_mg
5416 X<sv_setpvn_mg>, sv_setpv_mg X<sv_setpv_mg>, sv_setref_iv X<sv_setref_iv>,
5417 sv_setref_nv X<sv_setref_nv>, sv_setref_pv X<sv_setref_pv>, sv_setref_pvn
5418 X<sv_setref_pvn>, sv_setref_uv X<sv_setref_uv>, sv_setsv X<sv_setsv>,
5419 sv_setsv_flags X<sv_setsv_flags>, sv_setsv_mg X<sv_setsv_mg>, sv_setsv_nomg
5420 X<sv_setsv_nomg>, sv_setuv X<sv_setuv>, sv_setuv_mg X<sv_setuv_mg>,
5421 sv_taint X<sv_taint>, sv_tainted X<sv_tainted>, sv_true X<sv_true>,
5422 sv_unmagic X<sv_unmagic>, sv_unref X<sv_unref>, sv_unref_flags
5423 X<sv_unref_flags>, sv_untaint X<sv_untaint>, sv_upgrade X<sv_upgrade>,
5424 sv_usepvn X<sv_usepvn>, sv_usepvn_mg X<sv_usepvn_mg>, sv_utf8_decode
5425 X<sv_utf8_decode>, sv_utf8_downgrade X<sv_utf8_downgrade>, sv_utf8_encode
5426 X<sv_utf8_encode>, sv_utf8_upgrade X<sv_utf8_upgrade>,
5427 sv_utf8_upgrade_flags X<sv_utf8_upgrade_flags>, sv_uv X<sv_uv>, sv_vcatpvf
5428 X<sv_vcatpvf>, sv_vcatpvfn X<sv_vcatpvfn>, sv_vcatpvf_mg X<sv_vcatpvf_mg>,
5429 sv_vsetpvf X<sv_vsetpvf>, sv_vsetpvfn X<sv_vsetpvfn>, sv_vsetpvf_mg
5430 X<sv_vsetpvf_mg>
5432 =item Unicode Support
5434 bytes_from_utf8 X<bytes_from_utf8>, bytes_to_utf8 X<bytes_to_utf8>,
5435 ibcmp_utf8 X<ibcmp_utf8>, is_utf8_char X<is_utf8_char>, is_utf8_string
5436 X<is_utf8_string>, is_utf8_string_loc X<is_utf8_string_loc>,
5437 is_utf8_string_loclen X<is_utf8_string_loclen>, pv_uni_display
5438 X<pv_uni_display>, sv_cat_decode X<sv_cat_decode>, sv_recode_to_utf8
5439 X<sv_recode_to_utf8>, sv_uni_display X<sv_uni_display>, to_utf8_case
5440 X<to_utf8_case>, to_utf8_fold X<to_utf8_fold>, to_utf8_lower
5441 X<to_utf8_lower>, to_utf8_title X<to_utf8_title>, to_utf8_upper
5442 X<to_utf8_upper>, utf8n_to_uvchr X<utf8n_to_uvchr>, utf8n_to_uvuni
5443 X<utf8n_to_uvuni>, utf8_distance X<utf8_distance>, utf8_hop X<utf8_hop>,
5444 utf8_length X<utf8_length>, utf8_to_bytes X<utf8_to_bytes>, utf8_to_uvchr
5445 X<utf8_to_uvchr>, utf8_to_uvuni X<utf8_to_uvuni>, uvchr_to_utf8
5446 X<uvchr_to_utf8>, uvuni_to_utf8_flags X<uvuni_to_utf8_flags>
5448 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
5450 ax X<ax>, CLASS X<CLASS>, dAX X<dAX>, dAXMARK X<dAXMARK>, dITEMS X<dITEMS>,
5451 dXSARGS X<dXSARGS>, dXSI32 X<dXSI32>, items X<items>, ix X<ix>, newXSproto
5452 X<newXSproto>, RETVAL X<RETVAL>, ST X<ST>, THIS X<THIS>, XS X<XS>,
5453 XS_VERSION X<XS_VERSION>, XS_VERSION_BOOTCHECK X<XS_VERSION_BOOTCHECK>
5455 =item Warning and Dieing
5457 croak X<croak>, warn X<warn>
5459 =item AUTHORS
5461 =item SEE ALSO
5463 =back
5465 =head2 perlintern - autogenerated documentation of purely B<internal>
5466                  Perl functions
5468 =over 4
5470 =item DESCRIPTION
5471 X<internal Perl functions> X<interpreter functions>
5473 =item CV reference counts and CvOUTSIDE
5475 CvWEAKOUTSIDE X<CvWEAKOUTSIDE>
5477 =item Functions in file pad.h
5479 CX_CURPAD_SAVE X<CX_CURPAD_SAVE>, CX_CURPAD_SV X<CX_CURPAD_SV>, PAD_BASE_SV
5480 X<PAD_BASE_SV>, PAD_CLONE_VARS X<PAD_CLONE_VARS>, PAD_COMPNAME_FLAGS
5481 X<PAD_COMPNAME_FLAGS>, PAD_COMPNAME_GEN X<PAD_COMPNAME_GEN>,
5482 PAD_COMPNAME_GEN_set X<PAD_COMPNAME_GEN_set>, PAD_COMPNAME_OURSTASH
5483 X<PAD_COMPNAME_OURSTASH>, PAD_COMPNAME_PV X<PAD_COMPNAME_PV>,
5484 PAD_COMPNAME_TYPE X<PAD_COMPNAME_TYPE>, PAD_DUP X<PAD_DUP>,
5485 PAD_RESTORE_LOCAL X<PAD_RESTORE_LOCAL>, PAD_SAVE_LOCAL X<PAD_SAVE_LOCAL>,
5486 PAD_SAVE_SETNULLPAD X<PAD_SAVE_SETNULLPAD>, PAD_SETSV X<PAD_SETSV>,
5487 PAD_SET_CUR X<PAD_SET_CUR>, PAD_SET_CUR_NOSAVE X<PAD_SET_CUR_NOSAVE>,
5488 PAD_SV X<PAD_SV>, PAD_SVl X<PAD_SVl>, SAVECLEARSV X<SAVECLEARSV>,
5489 SAVECOMPPAD X<SAVECOMPPAD>, SAVEPADSV X<SAVEPADSV>
5491 =item Functions in file pp_ctl.c
5493 find_runcv X<find_runcv>
5495 =item Global Variables
5497 PL_DBsingle X<PL_DBsingle>, PL_DBsub X<PL_DBsub>, PL_DBtrace X<PL_DBtrace>,
5498 PL_dowarn X<PL_dowarn>, PL_last_in_gv X<PL_last_in_gv>, PL_ofs_sv
5499 X<PL_ofs_sv>, PL_rs X<PL_rs>
5501 =item GV Functions
5503 is_gv_magical X<is_gv_magical>
5505 =item IO Functions
5507 start_glob X<start_glob>
5509 =item Pad Data Structures
5511 CvPADLIST X<CvPADLIST>, cv_clone X<cv_clone>, cv_dump X<cv_dump>,
5512 do_dump_pad X<do_dump_pad>, intro_my X<intro_my>, pad_add_anon
5513 X<pad_add_anon>, pad_add_name X<pad_add_name>, pad_alloc X<pad_alloc>,
5514 pad_block_start X<pad_block_start>, pad_check_dup X<pad_check_dup>,
5515 pad_findlex X<pad_findlex>, pad_findmy X<pad_findmy>, pad_fixup_inner_anons
5516 X<pad_fixup_inner_anons>, pad_free X<pad_free>, pad_leavemy X<pad_leavemy>,
5517 pad_new X<pad_new>, pad_push X<pad_push>, pad_reset X<pad_reset>, pad_setsv
5518 X<pad_setsv>, pad_swipe X<pad_swipe>, pad_tidy X<pad_tidy>, pad_undef
5519 X<pad_undef>
5521 =item Stack Manipulation Macros
5523 djSP X<djSP>, LVRET X<LVRET>
5525 =item SV Manipulation Functions
5527 report_uninit X<report_uninit>, sv_add_arena X<sv_add_arena>, sv_clean_all
5528 X<sv_clean_all>, sv_clean_objs X<sv_clean_objs>, sv_free_arenas
5529 X<sv_free_arenas>
5531 =item AUTHORS
5533 =item SEE ALSO
5535 =back
5537 =head2 perliol - C API for Perl's implementation of IO in Layers.
5539 =over 4
5541 =item SYNOPSIS
5543 =item DESCRIPTION
5545 =over 4
5547 =item History and Background
5549 =item Basic Structure
5551 =item Layers vs Disciplines
5553 =item Data Structures
5555 =item Functions and Attributes
5557 =item Per-instance Data
5559 =item Layers in action.
5561 =item Per-instance flag bits
5563 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
5564 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
5565 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
5566 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
5568 =item Methods in Detail
5570 fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF,
5571 PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode,
5572 Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof,
5573 Error,  Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
5574 Set_ptrcnt
5576 =item Utilities
5578 =item Implementing PerlIO Layers
5580 C implementations, Perl implementations
5582 =item Core Layers
5584 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
5586 =item Extension Layers
5588 ":encoding", ":scalar", ":via"
5590 =back
5592 =item TODO
5594 =back
5596 =head2 perlapio - perl's IO abstraction interface.
5598 =over 4
5600 =item SYNOPSIS
5602 =item DESCRIPTION
5604 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
5605 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
5606 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
5607 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
5608 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
5609 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
5610 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
5611 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
5612 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
5613 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
5614 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
5616 =over 4
5618 =item Co-existence with stdio
5620 B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
5621 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
5623 =item "Fast gets" Functions
5625 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
5626 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
5627 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
5628 B<PerlIO_get_bufsiz(f)>
5630 =item Other Functions
5632 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
5633 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
5635 =back
5637 =back
5639 =head2 perlhack - How to hack at the Perl internals
5641 =over 4
5643 =item DESCRIPTION
5645 Does concept match the general goals of Perl?, Where is the
5646 implementation?, Backwards compatibility, Could it be a module instead?, Is
5647 the feature generic enough?, Does it potentially introduce new bugs?, Does
5648 it preclude other desirable features?, Is the implementation robust?, Is
5649 the implementation generic enough to be portable?, Is the implementation
5650 tested?, Is there enough documentation?, Is there another way to do it?,
5651 Does it create too much work?, Patches speak louder than words
5653 =over 4
5655 =item Keeping in sync
5657 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
5658 NFS, rsync'ing the patches
5660 =item Why rsync the source tree
5662 It's easier to rsync the source tree, It's more reliable
5664 =item Why rsync the patches
5666 It's easier to rsync the patches, It's a good reference, Finding a start
5667 point, Finding how to fix a bug, Finding the source of misbehaviour
5669 =item Working with the source
5671 =item Perlbug administration
5673 =item Submitting patches
5675 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
5676 F<Porting/pumpkin.pod>, The perl5-porters FAQ
5678 =item Finding Your Way Around
5680 Core modules, Tests, Documentation, Configure, Interpreter
5682 =item Elements of the interpreter
5684 Startup, Parsing, Optimization, Running, Exception handing
5686 =item Internal Variable Types
5688 =item Op Trees
5690 =item Stacks
5692 Argument stack, Mark stack, Save stack
5694 =item Millions of Macros
5696 =item The .i Targets
5698 =item Poking at Perl
5700 =item Using a source-level debugger
5702 run [args], break function_name, break source.c:xxx, step, next, continue,
5703 finish, 'enter', print
5705 =item gdb macro support
5707 =item Dumping Perl Data Structures
5709 =item Patching
5711 =item Patching a core module
5713 =item Adding a new function to the core
5715 =item Writing a test
5717 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5718 F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base t/comp,
5719 t/cmd t/run t/io t/op, t/lib ext lib
5721 =item Special Make Test Targets
5723 coretest, test.deparse, test.taintwarn, minitest, test.valgrind
5724 check.valgrind utest.valgrind ucheck.valgrind, test.third check.third
5725 utest.third ucheck.third, test.torture torturetest, utest ucheck test.utf8
5726 check.utf8, minitest.utf16 test.utf16, test_harness, test-notty test_notty
5728 =item Running tests by hand
5730 -v, -torture, -re=PATTERN, -re LIST OF PATTERNS, PERL_CORE=1,
5731 PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST
5733 =back
5735 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5737 =over 4
5739 =item Rational Software's Purify
5741 =item Purify on Unix
5743 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5745 =item Purify on NT
5747 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5749 =item valgrind
5751 =item Compaq's/Digital's/HP's Third Degree
5753 =item PERL_DESTRUCT_LEVEL
5755 =item Profiling
5757 =item Gprof Profiling
5759 -a, -b, -e routine, -f routine, -s, -z
5761 =item GCC gcov Profiling
5763 =item Pixie Profiling
5765 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5766 -z[ero]
5768 =item Miscellaneous tricks
5770 =item CONCLUSION
5772 I<The Road goes ever on and on, down from the door where it began.>
5774 =back
5776 =item AUTHOR
5778 =back
5780 =head2 perlbook - Perl book information
5782 =over 4
5784 =item DESCRIPTION
5786 =back
5788 =head2 perltodo - Perl TO-DO List
5790 =over 4
5792 =item DESCRIPTION
5794 =item The roadmap to 5.10
5796 =over 4
5798 =item Needed for a 5.9.4 release
5800 =item Needed for a 5.9.5 release
5802 Implement L</_ prototype character>, Implement L</state variables>
5804 =item Needed for a 5.9.6 release
5806 =back
5808 =item Tasks that only need Perl knowledge
5810 =over 4
5812 =item common test code for timed bail out
5814 =item POD -> HTML conversion in the core still sucks
5816 =item Parallel testing
5818 =item Make Schwern poorer
5820 =item Improve the coverage of the core tests
5822 =item test B
5824 =item A decent benchmark
5826 =item fix tainting bugs
5828 =item Dual life everything
5830 =item Improving C<threads::shared>
5832 =item POSIX memory footprint
5834 =back
5836 =item Tasks that need a little sysadmin-type knowledge
5838 =over 4
5840 =item Relocatable perl
5842 =item make HTML install work
5844 =item compressed man pages
5846 =item Add a code coverage target to the Makefile
5848 =item Make Config.pm cope with differences between build and installed perl
5850 =item make parallel builds work
5852 =item linker specification files
5854 =back
5856 =item Tasks that need a little C knowledge
5858 =over 4
5860 =item Make it clear from -v if this is the exact official release
5862 =item Tidy up global variables
5864 =item Ordering of "global" variables.
5866 =item bincompat functions
5868 =item am I hot or not?
5870 =item emulate the per-thread memory pool on Unix
5872 =item reduce duplication in sv_setsv_flags
5874 =back
5876 =item Tasks that need a knowledge of XS
5878 =over 4
5880 =item IPv6
5882 =item shrink C<GV>s, C<CV>s
5884 =item merge Perl_sv_2[inpu]v
5886 =item UTF8 caching code
5888 =item Implicit Latin 1 => Unicode translation
5890 =item autovivification
5892 =item Unicode in Filenames
5894 =item Unicode in %ENV
5896 =item use less 'memory'
5898 =item Re-implement C<:unique> in a way that is actually thread-safe
5900 =item Make tainting consistent
5902 =item readpipe(LIST)
5904 =back
5906 =item Tasks that need a knowledge of the interpreter
5908 =over 4
5910 =item lexical pragmas
5912 =item Attach/detach debugger from running program
5914 =item Constant folding
5916 =item LVALUE functions for lists
5918 =item LVALUE functions in the debugger
5920 =item _ prototype character
5922 =item state variables
5924 =item @INC source filter to Filter::Simple
5926 =item regexp optimiser optional
5928 =item UNITCHECK
5930 =item optional optimizer
5932 =item You WANT *how* many
5934 =item lexical aliases
5936 =item entersub XS vs Perl
5938 =item Self ties
5940 =item Optimize away @_
5942 =item What hooks would assertions need?
5944 =back
5946 =item Big projects
5948 =over 4
5950 =item make ithreads more robust
5952 =item iCOW
5954 =item (?{...}) closures in regexps
5956 =item A re-entrant regexp engine
5958 =back
5960 =back
5962 =head2 perldoc - Look up Perl documentation in Pod format.
5964 =over 4
5966 =item SYNOPSIS
5968 =item DESCRIPTION
5970 =item OPTIONS
5972 B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
5973 I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
5974 I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
5975 B<-w> I<option:value> or B<-w> I<option>, B<-X>,
5976 B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
5977 B<-V>
5979 =item SECURITY
5981 =item ENVIRONMENT
5983 =item AUTHOR
5985 =back
5987 =head2 perlhist - the Perl history records
5989 =over 4
5991 =item DESCRIPTION
5993 =item INTRODUCTION
5995 =item THE KEEPERS OF THE PUMPKIN
5997 =over 4
5999 =item PUMPKIN?
6001 =back
6003 =item THE RECORDS
6005 =over 4
6007 =item SELECTED RELEASE SIZES
6009 =item SELECTED PATCH SIZES
6011 =back
6013 =item THE KEEPERS OF THE RECORDS
6015 =back
6017 =head2 perldelta - what is new for perl v5.8.8
6019 =over 4
6021 =item DESCRIPTION
6023 =item Incompatible Changes
6025 =item Core Enhancements
6027 =item Modules and Pragmata
6029 =item Utility Changes
6031 =item New Documentation
6033 =item Performance Enhancements
6035 =item Installation and Configuration Improvements
6037 =item Selected Bug Fixes
6039 =item New or Changed Diagnostics
6041 =item Changed Internals
6043 =item New Tests
6045 =item Known Problems
6047 =item Platform Specific Problems
6049 =item Reporting Bugs
6051 =item SEE ALSO
6053 =back
6055 =head2 perl588delta, perldelta - what is new for perl v5.8.8
6057 =over 4
6059 =item DESCRIPTION
6061 =item Incompatible Changes
6063 =item Core Enhancements
6065 =item Modules and Pragmata
6067 =item Utility Changes
6069 =item New Documentation
6071 =item Performance Enhancements
6073 =item Installation and Configuration Improvements
6075 =item Selected Bug Fixes
6077 =item New or Changed Diagnostics
6079 =item Changed Internals
6081 =item New Tests
6083 =item Known Problems
6085 =item Platform Specific Problems
6087 =item Reporting Bugs
6089 =item SEE ALSO
6091 =back
6093 =head2 perl587delta, perldelta - what is new for perl v5.8.7
6095 =over 4
6097 =item DESCRIPTION
6099 =item Incompatible Changes
6101 =item Core Enhancements
6103 =over 4
6105 =item Unicode Character Database 4.1.0
6107 =item suidperl less insecure
6109 =item Optional site customization script
6111 =item C<Config.pm> is now much smaller.
6113 =back
6115 =item Modules and Pragmata
6117 =item Utility Changes
6119 =over 4
6121 =item find2perl enhancements
6123 =back
6125 =item Performance Enhancements
6127 =item Installation and Configuration Improvements
6129 =item Selected Bug Fixes
6131 =item New or Changed Diagnostics
6133 =item Changed Internals
6135 =item Known Problems
6137 =item Platform Specific Problems
6139 =item Reporting Bugs
6141 =item SEE ALSO
6143 =back
6145 =head2 perl586delta - what is new for perl v5.8.6
6147 =over 4
6149 =item DESCRIPTION
6151 =item Incompatible Changes
6153 =item Core Enhancements
6155 =item Modules and Pragmata
6157 =item Utility Changes
6159 =item Performance Enhancements
6161 =item Selected Bug Fixes
6163 =item New or Changed Diagnostics
6165 =item Changed Internals
6167 =item New Tests
6169 =item Reporting Bugs
6171 =item SEE ALSO
6173 =back
6175 =head2 perl585delta - what is new for perl v5.8.5
6177 =over 4
6179 =item DESCRIPTION
6181 =item Incompatible Changes
6183 =item Core Enhancements
6185 =item Modules and Pragmata
6187 =item Utility Changes
6189 =over 4
6191 =item Perl's debugger
6193 =item h2ph
6195 =back
6197 =item Installation and Configuration Improvements
6199 =item Selected Bug Fixes
6201 =item New or Changed Diagnostics
6203 =item Changed Internals
6205 =item Known Problems
6207 =item Platform Specific Problems
6209 =item Reporting Bugs
6211 =item SEE ALSO
6213 =back
6215 =head2 perl584delta - what is new for perl v5.8.4
6217 =over 4
6219 =item DESCRIPTION
6221 =item Incompatible Changes
6223 =item Core Enhancements
6225 =over 4
6227 =item Malloc wrapping
6229 =item Unicode Character Database 4.0.1
6231 =item suidperl less insecure
6233 =item format
6235 =back
6237 =item Modules and Pragmata
6239 =over 4
6241 =item Updated modules
6243 Attribute::Handlers, B, Benchmark, CGI, Carp, Cwd, Exporter, File::Find,
6244 IO, IPC::Open3, Local::Maketext, Math::BigFloat, Math::BigInt,
6245 Math::BigRat, MIME::Base64, ODBM_File, POSIX, Shell, Socket, Storable,
6246 Switch, Sys::Syslog, Term::ANSIColor, Time::HiRes, Unicode::UCD, Win32,
6247 base, open, threads, utf8
6249 =back
6251 =item Performance Enhancements
6253 =item Utility Changes
6255 =item Installation and Configuration Improvements
6257 =item Selected Bug Fixes
6259 =item New or Changed Diagnostics
6261 =item Changed Internals
6263 =item Future Directions
6265 =item Platform Specific Problems
6267 =item Reporting Bugs
6269 =item SEE ALSO
6271 =back
6273 =head2 perl583delta - what is new for perl v5.8.3
6275 =over 4
6277 =item DESCRIPTION
6279 =item Incompatible Changes
6281 =item Core Enhancements
6283 =item Modules and Pragmata
6285 CGI, Cwd, Digest, Digest::MD5, Encode, File::Spec, FindBin, List::Util,
6286 Math::BigInt, PodParser, Pod::Perldoc, POSIX, Unicode::Collate,
6287 Unicode::Normalize, Test::Harness, threads::shared
6289 =item Utility Changes
6291 =item New Documentation
6293 =item Installation and Configuration Improvements
6295 =item Selected Bug Fixes
6297 =item New or Changed Diagnostics
6299 =item Changed Internals
6301 =item Configuration and Building
6303 =item Platform Specific Problems
6305 =item Known Problems
6307 =item Future Directions
6309 =item Obituary
6311 =item Reporting Bugs
6313 =item SEE ALSO
6315 =back
6317 =head2 perl582delta - what is new for perl v5.8.2
6319 =over 4
6321 =item DESCRIPTION
6323 =item Incompatible Changes
6325 =item Core Enhancements
6327 =over 4
6329 =item Hash Randomisation
6331 =item Threading
6333 =back
6335 =item Modules and Pragmata
6337 =over 4
6339 =item Updated Modules And Pragmata
6341 Devel::PPPort, Digest::MD5, I18N::LangTags, libnet, MIME::Base64,
6342 Pod::Perldoc, strict, Tie::Hash, Time::HiRes, Unicode::Collate,
6343 Unicode::Normalize, UNIVERSAL
6345 =back
6347 =item Selected Bug Fixes
6349 =item Changed Internals
6351 =item Platform Specific Problems
6353 =item Future Directions
6355 =item Reporting Bugs
6357 =item SEE ALSO
6359 =back
6361 =head2 perl581delta - what is new for perl v5.8.1
6363 =over 4
6365 =item DESCRIPTION
6367 =item Incompatible Changes
6369 =over 4
6371 =item Hash Randomisation
6373 =item UTF-8 On Filehandles No Longer Activated By Locale
6375 =item Single-number v-strings are no longer v-strings before "=>"
6377 =item (Win32) The -C Switch Has Been Repurposed
6379 =item (Win32) The /d Switch Of cmd.exe
6381 =back
6383 =item Core Enhancements
6385 =over 4
6387 =item UTF-8 no longer default under UTF-8 locales
6389 =item Unsafe signals again available
6391 =item Tied Arrays with Negative Array Indices
6393 =item local ${$x}
6395 =item Unicode Character Database 4.0.0
6397 =item Deprecation Warnings
6399 =item Miscellaneous Enhancements
6401 =back
6403 =item Modules and Pragmata
6405 =over 4
6407 =item Updated Modules And Pragmata
6409 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
6410 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
6411 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
6412 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
6413 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
6414 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
6415 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
6416 Win32::GetOSVersion
6418 =back
6420 =item Utility Changes
6422 =item New Documentation
6424 =item Installation and Configuration Improvements
6426 =over 4
6428 =item Platform-specific enhancements
6430 =back
6432 =item Selected Bug Fixes
6434 =over 4
6436 =item Closures, eval and lexicals
6438 =item Generic fixes
6440 =item Platform-specific fixes
6442 =back
6444 =item New or Changed Diagnostics
6446 =over 4
6448 =item Changed "A thread exited while %d threads were running"
6450 =item Removed "Attempt to clear a restricted hash"
6452 =item New "Illegal declaration of anonymous subroutine"
6454 =item Changed "Invalid range "%s" in transliteration operator"
6456 =item New "Missing control char name in \c"
6458 =item New "Newline in left-justified string for %s"
6460 =item New "Possible precedence problem on bitwise %c operator"
6462 =item New "Pseudo-hashes are deprecated"
6464 =item New "read() on %s filehandle %s"
6466 =item New "5.005 threads are deprecated"
6468 =item New "Tied variable freed while still in use"
6470 =item New "To%s: illegal mapping '%s'"
6472 =item New "Use of freed value in iteration"
6474 =back
6476 =item Changed Internals
6478 =item New Tests
6480 =item Known Problems
6482 =over 4
6484 =item Tied hashes in scalar context
6486 =item Net::Ping 450_service and 510_ping_udp failures
6488 =item B::C
6490 =back
6492 =item Platform Specific Problems
6494 =over 4
6496 =item EBCDIC Platforms
6498 =item Cygwin 1.5 problems
6500 =item HP-UX: HP cc warnings about sendfile and sendpath
6502 =item IRIX: t/uni/tr_7jis.t falsely failing
6504 =item Mac OS X: no usemymalloc
6506 =item Tru64: No threaded builds with GNU cc (gcc)
6508 =item Win32: sysopen, sysread, syswrite
6510 =back
6512 =item Future Directions
6514 =item Reporting Bugs
6516 =item SEE ALSO
6518 =back
6520 =head2 perl58delta - what is new for perl v5.8.0
6522 =over 4
6524 =item DESCRIPTION
6526 =item Highlights In 5.8.0
6528 =item Incompatible Changes
6530 =over 4
6532 =item Binary Incompatibility
6534 =item 64-bit platforms and malloc
6536 =item AIX Dynaloading
6538 =item Attributes for C<my> variables now handled at run-time
6540 =item Socket Extension Dynamic in VMS
6542 =item IEEE-format Floating Point Default on OpenVMS Alpha
6544 =item New Unicode Semantics (no more C<use utf8>, almost)
6546 =item New Unicode Properties
6548 =item REF(...) Instead Of SCALAR(...)
6550 =item pack/unpack D/F recycled
6552 =item glob() now returns filenames in alphabetical order
6554 =item Deprecations
6556 =back
6558 =item Core Enhancements
6560 =over 4
6562 =item Unicode Overhaul
6564 =item PerlIO is Now The Default
6566 =item ithreads
6568 =item Restricted Hashes
6570 =item Safe Signals
6572 =item Understanding of Numbers
6574 =item Arrays now always interpolate into double-quoted strings [561]
6576 =item Miscellaneous Changes
6578 =back
6580 =item Modules and Pragmata
6582 =over 4
6584 =item New Modules and Pragmata
6586 =item Updated And Improved Modules and Pragmata
6588 =back
6590 =item Utility Changes
6592 =item New Documentation
6594 =item Performance Enhancements
6596 =item Installation and Configuration Improvements
6598 =over 4
6600 =item Generic Improvements
6602 =item New Or Improved Platforms
6604 =back
6606 =item Selected Bug Fixes
6608 =over 4
6610 =item Platform Specific Changes and Fixes
6612 =back
6614 =item New or Changed Diagnostics
6616 =item Changed Internals
6618 =item Security Vulnerability Closed [561]
6620 =item New Tests
6622 =item Known Problems
6624 =over 4
6626 =item The Compiler Suite Is Still Very Experimental
6628 =item Localising Tied Arrays and Hashes Is Broken
6630 =item Building Extensions Can Fail Because Of Largefiles
6632 =item Modifying $_ Inside for(..)
6634 =item mod_perl 1.26 Doesn't Build With Threaded Perl
6636 =item lib/ftmp-security tests warn 'system possibly insecure'
6638 =item libwww-perl (LWP) fails base/date #51
6640 =item PDL failing some tests
6642 =item Perl_get_sv
6644 =item Self-tying Problems
6646 =item ext/threads/t/libc
6648 =item Failure of Thread (5.005-style) tests
6650 =item Timing problems
6652 =item Tied/Magical Array/Hash Elements Do Not Autovivify
6654 =item Unicode in package/class and subroutine names does not work
6656 =back
6658 =item Platform Specific Problems
6660 =over 4
6662 =item AIX
6664 =item Alpha systems with old gccs fail several tests
6666 =item AmigaOS
6668 =item BeOS
6670 =item Cygwin "unable to remap"
6672 =item Cygwin ndbm tests fail on FAT
6674 =item DJGPP Failures
6676 =item FreeBSD built with ithreads coredumps reading large directories
6678 =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
6680 =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
6682 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
6684 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
6686 =item Linux With Sfio Fails op/misc Test 48
6688 =item Mac OS X
6690 =item Mac OS X dyld undefined symbols
6692 =item OS/2 Test Failures
6694 =item op/sprintf tests 91, 129, and 130
6696 =item SCO
6698 =item Solaris 2.5
6700 =item Solaris x86 Fails Tests With -Duse64bitint
6702 =item SUPER-UX (NEC SX)
6704 =item Term::ReadKey not working on Win32
6706 =item UNICOS/mk
6708 =item UTS
6710 =item VOS (Stratus)
6712 =item VMS
6714 =item Win32
6716 =item XML::Parser not working
6718 =item z/OS (OS/390)
6720 =item Unicode Support on EBCDIC Still Spotty
6722 =item Seen In Perl 5.7 But Gone Now
6724 =back
6726 =item Reporting Bugs
6728 =item SEE ALSO
6730 =item HISTORY
6732 =back
6734 =head2 perl573delta - what's new for perl v5.7.3
6736 =over 4
6738 =item DESCRIPTION
6740 =item Changes
6742 =item Reporting Bugs
6744 =item SEE ALSO
6746 =item HISTORY
6748 =back
6750 =head2 perl572delta - what's new for perl v5.7.2
6752 =over 4
6754 =item DESCRIPTION
6756 =item Security Vulnerability Closed
6758 =item Incompatible Changes
6760 =over 4
6762 =item 64-bit platforms and malloc
6764 =item AIX Dynaloading
6766 =item Socket Extension Dynamic in VMS
6768 =item Different Definition of the Unicode Character Classes \p{In...}
6770 =item Deprecations
6772 =back
6774 =item Core Enhancements
6776 =item Modules and Pragmata
6778 =over 4
6780 =item New Modules and Distributions
6782 =item Updated And Improved Modules and Pragmata
6784 =back
6786 =item Utility Changes
6788 =item New Documentation
6790 =item Installation and Configuration Improvements
6792 =over 4
6794 =item New Or Improved Platforms
6796 =item Generic Improvements
6798 =back
6800 =item Selected Bug Fixes
6802 =over 4
6804 =item Platform Specific Changes and Fixes
6806 =back
6808 =item New or Changed Diagnostics
6810 =item Source Code Enhancements
6812 =over 4
6814 =item MAGIC constants
6816 =item Better commented code
6818 =item Regex pre-/post-compilation items matched up
6820 =item gcc -Wall
6822 =back
6824 =item New Tests
6826 =item Known Problems
6828 =over 4
6830 =item AIX
6832 =item Amiga Perl Invoking Mystery
6834 =item lib/ftmp-security tests warn 'system possibly insecure'
6836 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
6838 =item HP-UX lib/io_multihomed Fails When LP64-Configured
6840 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
6842 =item Linux With Sfio Fails op/misc Test 48
6844 =item OS/390
6846 =item op/sprintf tests 129 and 130
6848 =item  Failure of Thread tests
6850 =item UNICOS
6852 =item UTS
6854 =item VMS
6856 =item Win32
6858 =item Localising a Tied Variable Leaks Memory
6860 =item Self-tying of Arrays and Hashes Is Forbidden
6862 =item Variable Attributes are not Currently Usable for Tieing
6864 =item Building Extensions Can Fail Because Of Largefiles
6866 =item The Compiler Suite Is Still Experimental
6868 =item The Long Double Support is Still Experimental
6870 =back
6872 =item Reporting Bugs
6874 =item SEE ALSO
6876 =item HISTORY
6878 =back
6880 =head2 perl571delta - what's new for perl v5.7.1
6882 =over 4
6884 =item DESCRIPTION
6886 =item Security Vulnerability Closed
6888 =item Incompatible Changes
6890 =item Core Enhancements
6892 =over 4
6894 =item AUTOLOAD Is Now Lvaluable
6896 =item PerlIO is Now The Default
6898 =item Signals Are Now Safe
6900 =back
6902 =item Modules and Pragmata
6904 =over 4
6906 =item New Modules
6908 =item Updated And Improved Modules and Pragmata
6910 =back
6912 =item Performance Enhancements
6914 =item Utility Changes
6916 =item New Documentation
6918 =over 4
6920 =item perlclib
6922 =item perliol
6924 =item README.aix
6926 =item README.bs2000
6928 =item README.macos
6930 =item README.mpeix
6932 =item README.solaris
6934 =item README.vos
6936 =item Porting/repository.pod
6938 =back
6940 =item Installation and Configuration Improvements
6942 =over 4
6944 =item New Or Improved Platforms
6946 =item Generic Improvements
6948 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
6949 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
6950 d_strtoq, d_u32align, d_ualarm, d_usleep
6952 =back
6954 =item Selected Bug Fixes
6956 =over 4
6958 =item Platform Specific Changes and Fixes
6960 =back
6962 =item New or Changed Diagnostics
6964 =item Changed Internals
6966 =item New Tests
6968 =item Known Problems
6970 =over 4
6972 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
6974 =item lib/ftmp-security tests warn 'system possibly insecure'
6976 =item lib/io_multihomed Fails In LP64-Configured HP-UX
6978 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
6980 =item lib/b test 19
6982 =item Linux With Sfio Fails op/misc Test 48
6984 =item sigaction test 13 in VMS
6986 =item sprintf tests 129 and 130
6988 =item  Failure of Thread tests
6990 =item Localising a Tied Variable Leaks Memory
6992 =item Self-tying of Arrays and Hashes Is Forbidden
6994 =item Building Extensions Can Fail Because Of Largefiles
6996 =item The Compiler Suite Is Still Experimental
6998 =back
7000 =item Reporting Bugs
7002 =item SEE ALSO
7004 =item HISTORY
7006 =back
7008 =head2 perl570delta - what's new for perl v5.7.0
7010 =over 4
7012 =item DESCRIPTION
7014 =item Security Vulnerability Closed
7016 =item Incompatible Changes
7018 =item Core Enhancements
7020 =item Modules and Pragmata
7022 =over 4
7024 =item New Modules
7026 =item Updated And Improved Modules and Pragmata
7028 =back
7030 =item Utility Changes
7032 =item New Documentation
7034 =item Performance Enhancements
7036 =item Installation and Configuration Improvements
7038 =over 4
7040 =item Generic Improvements
7042 =back
7044 =item Selected Bug Fixes
7046 =over 4
7048 =item Platform Specific Changes and Fixes
7050 =back
7052 =item New or Changed Diagnostics
7054 =item Changed Internals
7056 =item Known Problems
7058 =over 4
7060 =item Unicode Support Still Far From Perfect
7062 =item EBCDIC Still A Lost Platform
7064 =item Building Extensions Can Fail Because Of Largefiles
7066 =item ftmp-security tests warn 'system possibly insecure'
7068 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
7070 =item Long Doubles Still Don't Work In Solaris
7072 =item Linux With Sfio Fails op/misc Test 48
7074 =item Storable tests fail in some platforms
7076 =item Threads Are Still Experimental
7078 =item The Compiler Suite Is Still Experimental
7080 =back
7082 =item Reporting Bugs
7084 =item SEE ALSO
7086 =item HISTORY
7088 =back
7090 =head2 perl561delta - what's new for perl v5.6.x
7092 =over 4
7094 =item DESCRIPTION
7096 =item Summary of changes between 5.6.0 and 5.6.1
7098 =over 4
7100 =item Security Issues
7102 =item Core bug fixes
7104 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
7105 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
7106 references to special variables, Lexical warnings, Spurious warnings and
7107 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
7108 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
7109 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
7110 Module;>, Tests
7112 =item Core features
7114 =item Configuration issues
7116 =item Documentation
7118 =item Bundled modules
7120 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
7121 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
7122 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
7123 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
7125 =item Platform-specific improvements
7127 NCR MP-RAS, NonStop-UX
7129 =back
7131 =item Core Enhancements
7133 =over 4
7135 =item Interpreter cloning, threads, and concurrency
7137 =item Lexically scoped warning categories
7139 =item Unicode and UTF-8 support
7141 =item Support for interpolating named characters
7143 =item "our" declarations
7145 =item Support for strings represented as a vector of ordinals
7147 =item Improved Perl version numbering system
7149 =item New syntax for declaring subroutine attributes
7151 =item File and directory handles can be autovivified
7153 =item open() with more than two arguments
7155 =item 64-bit support
7157 =item Large file support
7159 =item Long doubles
7161 =item "more bits"
7163 =item Enhanced support for sort() subroutines
7165 =item C<sort $coderef @foo> allowed
7167 =item File globbing implemented internally
7169 =item Support for CHECK blocks
7171 =item POSIX character class syntax [: :] supported
7173 =item Better pseudo-random number generator
7175 =item Improved C<qw//> operator
7177 =item Better worst-case behavior of hashes
7179 =item pack() format 'Z' supported
7181 =item pack() format modifier '!' supported
7183 =item pack() and unpack() support counted strings
7185 =item Comments in pack() templates
7187 =item Weak references
7189 =item Binary numbers supported
7191 =item Lvalue subroutines
7193 =item Some arrows may be omitted in calls through references
7195 =item Boolean assignment operators are legal lvalues
7197 =item exists() is supported on subroutine names
7199 =item exists() and delete() are supported on array elements
7201 =item Pseudo-hashes work better
7203 =item Automatic flushing of output buffers
7205 =item Better diagnostics on meaningless filehandle operations
7207 =item Where possible, buffered data discarded from duped input filehandle
7209 =item eof() has the same old magic as <>
7211 =item binmode() can be used to set :crlf and :raw modes
7213 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
7215 =item system(), backticks and pipe open now reflect exec() failure
7217 =item Improved diagnostics
7219 =item Diagnostics follow STDERR
7221 =item More consistent close-on-exec behavior
7223 =item syswrite() ease-of-use
7225 =item Better syntax checks on parenthesized unary operators
7227 =item Bit operators support full native integer width
7229 =item Improved security features
7231 =item More functional bareword prototype (*)
7233 =item C<require> and C<do> may be overridden
7235 =item $^X variables may now have names longer than one character
7237 =item New variable $^C reflects C<-c> switch
7239 =item New variable $^V contains Perl version as a string
7241 =item Optional Y2K warnings
7243 =item Arrays now always interpolate into double-quoted strings
7245 =item @- and @+ provide starting/ending offsets of regex submatches
7247 =back
7249 =item Modules and Pragmata
7251 =over 4
7253 =item Modules
7255 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
7256 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
7257 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
7258 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
7259 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
7260 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
7261 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
7262 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
7264 =item Pragmata
7266 =back
7268 =item Utility Changes
7270 =over 4
7272 =item dprofpp
7274 =item find2perl
7276 =item h2xs
7278 =item perlcc
7280 =item perldoc
7282 =item The Perl Debugger
7284 =back
7286 =item Improved Documentation
7288 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
7289 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
7290 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
7291 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
7293 =item Performance enhancements
7295 =over 4
7297 =item Simple sort() using { $a <=> $b } and the like are optimized
7299 =item Optimized assignments to lexical variables
7301 =item Faster subroutine calls
7303 =item delete(), each(), values() and hash iteration are faster
7305 =back
7307 =item Installation and Configuration Improvements
7309 =over 4
7311 =item -Dusethreads means something different
7313 =item New Configure flags
7315 =item Threadedness and 64-bitness now more daring
7317 =item Long Doubles
7319 =item -Dusemorebits
7321 =item -Duselargefiles
7323 =item installusrbinperl
7325 =item SOCKS support
7327 =item C<-A> flag
7329 =item Enhanced Installation Directories
7331 =item gcc automatically tried if 'cc' does not seem to be working
7333 =back
7335 =item Platform specific changes
7337 =over 4
7339 =item Supported platforms
7341 =item DOS
7343 =item OS390 (OpenEdition MVS)
7345 =item VMS
7347 =item Win32
7349 =back
7351 =item Significant bug fixes
7353 =over 4
7355 =item <HANDLE> on empty files
7357 =item C<eval '...'> improvements
7359 =item All compilation errors are true errors
7361 =item Implicitly closed filehandles are safer
7363 =item Behavior of list slices is more consistent
7365 =item C<(\$)> prototype and C<$foo{a}>
7367 =item C<goto &sub> and AUTOLOAD
7369 =item C<-bareword> allowed under C<use integer>
7371 =item Failures in DESTROY()
7373 =item Locale bugs fixed
7375 =item Memory leaks
7377 =item Spurious subroutine stubs after failed subroutine calls
7379 =item Taint failures under C<-U>
7381 =item END blocks and the C<-c> switch
7383 =item Potential to leak DATA filehandles
7385 =back
7387 =item New or Changed Diagnostics
7389 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
7390 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
7391 / cannot take a count, / must be followed by a, A or Z, / must be followed
7392 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
7393 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
7394 passed through, /%s/ should probably be written as "%s", %s() called too
7395 early to check prototype, %s argument is not a HASH or ARRAY element, %s
7396 argument is not a HASH or ARRAY element or slice, %s argument is not a
7397 subroutine name, %s package attribute may clash with future reserved word:
7398 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
7399 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
7400 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
7401 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
7402 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
7403 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
7404 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
7405 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
7406 weaken a nonreference, Character class [:%s:] unknown, Character class
7407 syntax [%s] belongs inside character classes, Constant is not %s reference,
7408 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
7409 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
7410 "local" instead of "our"?), Document contains no data, entering effective
7411 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
7412 output, flock() on closed filehandle %s, Global symbol "%s" requires
7413 explicit package name, Hexadecimal number > 0xffffffff non-portable,
7414 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
7415 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
7416 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
7417 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
7418 separator character %s in attribute list, Invalid separator character %s in
7419 subroutine attribute list, leaving effective %s failed, Lvalue subs
7420 returning %s not implemented yet, Method %s not permitted, Missing
7421 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
7422 No %s specified for -%c, No package name allowed for variable %s in "our",
7423 No space allowed after -%c, no UTC offset information; assuming local time
7424 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
7425 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
7426 around "%s" list, Possible unintended interpolation of %s in string,
7427 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
7428 instead, Premature end of script headers, Repeat count in pack overflows,
7429 Repeat count in unpack overflows, realloc() of freed memory ignored,
7430 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
7431 zero-length expression, switching effective %s is not implemented, This
7432 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
7433 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
7434 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
7435 escape \\%c passed through, Unterminated attribute parameter in attribute
7436 list, Unterminated attribute list, Unterminated attribute parameter in
7437 subroutine attribute list, Unterminated subroutine attribute list, Value of
7438 CLI symbol "%s" too long, Version number must be a constant number
7440 =item New tests
7442 =item Incompatible Changes
7444 =over 4
7446 =item Perl Source Incompatibilities
7448 CHECK is a new keyword, Treatment of list slices of undef has changed,
7449 Format of $English::PERL_VERSION is different, Literals of the form
7450 C<1.2.3> parse differently, Possibly changed pseudo-random number
7451 generator, Hashing function for hash keys has changed, C<undef> fails on
7452 read only values, Close-on-exec bit may be set on pipe and socket handles,
7453 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
7454 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
7455 Text of some diagnostic output has changed, C<%@> has been removed,
7456 Parenthesized not() behaves like a list operator, Semantics of bareword
7457 prototype C<(*)> have changed, Semantics of bit operators may have changed
7458 on 64-bit platforms, More builtins taint their results
7460 =item C Source Incompatibilities
7462 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
7464 =item Compatible C Source API Changes
7466 C<PATCHLEVEL> is now C<PERL_VERSION>
7468 =item Binary Incompatibilities
7470 =back
7472 =item Known Problems
7474 =over 4
7476 =item Localizing a tied hash element may leak memory
7478 =item Known test failures
7480 =item EBCDIC platforms not fully supported
7482 =item UNICOS/mk CC failures during Configure run
7484 =item Arrow operator and arrays
7486 =item Experimental features
7488 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
7489 pseudo-hash data type, The Compiler suite, Internal implementation of file
7490 globbing, The DB module, The regular expression code constructs:
7492 =back
7494 =item Obsolete Diagnostics
7496 Character class syntax [: :] is reserved for future extensions, Ill-formed
7497 logical name |%s| in prime_env_iter, In string, @%s now must be written as
7498 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
7499 to mean "${$}<digit>" is deprecated
7501 =item Reporting Bugs
7503 =item SEE ALSO
7505 =item HISTORY
7507 =back
7509 =head2 perl56delta - what's new for perl v5.6.0
7511 =over 4
7513 =item DESCRIPTION
7515 =item Core Enhancements
7517 =over 4
7519 =item Interpreter cloning, threads, and concurrency
7521 =item Lexically scoped warning categories
7523 =item Unicode and UTF-8 support
7525 =item Support for interpolating named characters
7527 =item "our" declarations
7529 =item Support for strings represented as a vector of ordinals
7531 =item Improved Perl version numbering system
7533 =item New syntax for declaring subroutine attributes
7535 =item File and directory handles can be autovivified
7537 =item open() with more than two arguments
7539 =item 64-bit support
7541 =item Large file support
7543 =item Long doubles
7545 =item "more bits"
7547 =item Enhanced support for sort() subroutines
7549 =item C<sort $coderef @foo> allowed
7551 =item File globbing implemented internally
7553 =item Support for CHECK blocks
7555 =item POSIX character class syntax [: :] supported
7557 =item Better pseudo-random number generator
7559 =item Improved C<qw//> operator
7561 =item Better worst-case behavior of hashes
7563 =item pack() format 'Z' supported
7565 =item pack() format modifier '!' supported
7567 =item pack() and unpack() support counted strings
7569 =item Comments in pack() templates
7571 =item Weak references
7573 =item Binary numbers supported
7575 =item Lvalue subroutines
7577 =item Some arrows may be omitted in calls through references
7579 =item Boolean assignment operators are legal lvalues
7581 =item exists() is supported on subroutine names
7583 =item exists() and delete() are supported on array elements
7585 =item Pseudo-hashes work better
7587 =item Automatic flushing of output buffers
7589 =item Better diagnostics on meaningless filehandle operations
7591 =item Where possible, buffered data discarded from duped input filehandle
7593 =item eof() has the same old magic as <>
7595 =item binmode() can be used to set :crlf and :raw modes
7597 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
7599 =item system(), backticks and pipe open now reflect exec() failure
7601 =item Improved diagnostics
7603 =item Diagnostics follow STDERR
7605 =item More consistent close-on-exec behavior
7607 =item syswrite() ease-of-use
7609 =item Better syntax checks on parenthesized unary operators
7611 =item Bit operators support full native integer width
7613 =item Improved security features
7615 =item More functional bareword prototype (*)
7617 =item C<require> and C<do> may be overridden
7619 =item $^X variables may now have names longer than one character
7621 =item New variable $^C reflects C<-c> switch
7623 =item New variable $^V contains Perl version as a string
7625 =item Optional Y2K warnings
7627 =item Arrays now always interpolate into double-quoted strings
7629 =item @- and @+ provide starting/ending offsets of regex matches
7631 =back
7633 =item Modules and Pragmata
7635 =over 4
7637 =item Modules
7639 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
7640 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
7641 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
7642 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
7643 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
7644 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
7645 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
7646 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
7648 =item Pragmata
7650 =back
7652 =item Utility Changes
7654 =over 4
7656 =item dprofpp
7658 =item find2perl
7660 =item h2xs
7662 =item perlcc
7664 =item perldoc
7666 =item The Perl Debugger
7668 =back
7670 =item Improved Documentation
7672 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
7673 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
7674 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
7675 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
7677 =item Performance enhancements
7679 =over 4
7681 =item Simple sort() using { $a <=> $b } and the like are optimized
7683 =item Optimized assignments to lexical variables
7685 =item Faster subroutine calls
7687 =item delete(), each(), values() and hash iteration are faster
7689 =back
7691 =item Installation and Configuration Improvements
7693 =over 4
7695 =item -Dusethreads means something different
7697 =item New Configure flags
7699 =item Threadedness and 64-bitness now more daring
7701 =item Long Doubles
7703 =item -Dusemorebits
7705 =item -Duselargefiles
7707 =item installusrbinperl
7709 =item SOCKS support
7711 =item C<-A> flag
7713 =item Enhanced Installation Directories
7715 =back
7717 =item Platform specific changes
7719 =over 4
7721 =item Supported platforms
7723 =item DOS
7725 =item OS390 (OpenEdition MVS)
7727 =item VMS
7729 =item Win32
7731 =back
7733 =item Significant bug fixes
7735 =over 4
7737 =item <HANDLE> on empty files
7739 =item C<eval '...'> improvements
7741 =item All compilation errors are true errors
7743 =item Implicitly closed filehandles are safer
7745 =item Behavior of list slices is more consistent
7747 =item C<(\$)> prototype and C<$foo{a}>
7749 =item C<goto &sub> and AUTOLOAD
7751 =item C<-bareword> allowed under C<use integer>
7753 =item Failures in DESTROY()
7755 =item Locale bugs fixed
7757 =item Memory leaks
7759 =item Spurious subroutine stubs after failed subroutine calls
7761 =item Taint failures under C<-U>
7763 =item END blocks and the C<-c> switch
7765 =item Potential to leak DATA filehandles
7767 =back
7769 =item New or Changed Diagnostics
7771 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
7772 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
7773 / cannot take a count, / must be followed by a, A or Z, / must be followed
7774 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
7775 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
7776 passed through, /%s/ should probably be written as "%s", %s() called too
7777 early to check prototype, %s argument is not a HASH or ARRAY element, %s
7778 argument is not a HASH or ARRAY element or slice, %s argument is not a
7779 subroutine name, %s package attribute may clash with future reserved word:
7780 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
7781 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
7782 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
7783 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
7784 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
7785 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
7786 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
7787 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
7788 weaken a nonreference, Character class [:%s:] unknown, Character class
7789 syntax [%s] belongs inside character classes, Constant is not %s reference,
7790 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
7791 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
7792 "local" instead of "our"?), Document contains no data, entering effective
7793 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
7794 output, flock() on closed filehandle %s, Global symbol "%s" requires
7795 explicit package name, Hexadecimal number > 0xffffffff non-portable,
7796 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
7797 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
7798 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
7799 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
7800 separator character %s in attribute list, Invalid separator character %s in
7801 subroutine attribute list, leaving effective %s failed, Lvalue subs
7802 returning %s not implemented yet, Method %s not permitted, Missing
7803 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
7804 No %s specified for -%c, No package name allowed for variable %s in "our",
7805 No space allowed after -%c, no UTC offset information; assuming local time
7806 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
7807 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
7808 around "%s" list, Possible unintended interpolation of %s in string,
7809 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
7810 instead, Premature end of script headers, Repeat count in pack overflows,
7811 Repeat count in unpack overflows, realloc() of freed memory ignored,
7812 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
7813 zero-length expression, switching effective %s is not implemented, This
7814 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
7815 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
7816 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
7817 escape \\%c passed through, Unterminated attribute parameter in attribute
7818 list, Unterminated attribute list, Unterminated attribute parameter in
7819 subroutine attribute list, Unterminated subroutine attribute list, Value of
7820 CLI symbol "%s" too long, Version number must be a constant number
7822 =item New tests
7824 =item Incompatible Changes
7826 =over 4
7828 =item Perl Source Incompatibilities
7830 CHECK is a new keyword, Treatment of list slices of undef has changed,
7831 Format of $English::PERL_VERSION is different, Literals of the form
7832 C<1.2.3> parse differently, Possibly changed pseudo-random number
7833 generator, Hashing function for hash keys has changed, C<undef> fails on
7834 read only values, Close-on-exec bit may be set on pipe and socket handles,
7835 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
7836 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
7837 Text of some diagnostic output has changed, C<%@> has been removed,
7838 Parenthesized not() behaves like a list operator, Semantics of bareword
7839 prototype C<(*)> have changed, Semantics of bit operators may have changed
7840 on 64-bit platforms, More builtins taint their results
7842 =item C Source Incompatibilities
7844 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
7846 =item Compatible C Source API Changes
7848 C<PATCHLEVEL> is now C<PERL_VERSION>
7850 =item Binary Incompatibilities
7852 =back
7854 =item Known Problems
7856 =over 4
7858 =item Thread test failures
7860 =item EBCDIC platforms not supported
7862 =item In 64-bit HP-UX the lib/io_multihomed test may hang
7864 =item NEXTSTEP 3.3 POSIX test failure
7866 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
7869 =item UNICOS/mk CC failures during Configure run
7871 =item Arrow operator and arrays
7873 =item Experimental features
7875 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
7876 pseudo-hash data type, The Compiler suite, Internal implementation of file
7877 globbing, The DB module, The regular expression code constructs:
7879 =back
7881 =item Obsolete Diagnostics
7883 Character class syntax [: :] is reserved for future extensions, Ill-formed
7884 logical name |%s| in prime_env_iter, In string, @%s now must be written as
7885 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
7886 to mean "${$}<digit>" is deprecated
7888 =item Reporting Bugs
7890 =item SEE ALSO
7892 =item HISTORY
7894 =back
7896 =head2 perl5005delta - what's new for perl5.005
7898 =over 4
7900 =item DESCRIPTION
7902 =item About the new versioning system
7904 =item Incompatible Changes
7906 =over 4
7908 =item WARNING:  This version is not binary compatible with Perl 5.004.
7910 =item Default installation structure has changed
7912 =item Perl Source Compatibility
7914 =item C Source Compatibility
7916 =item Binary Compatibility
7918 =item Security fixes may affect compatibility
7920 =item Relaxed new mandatory warnings introduced in 5.004
7922 =item Licensing
7924 =back
7926 =item Core Changes
7928 =over 4
7930 =item Threads
7932 =item Compiler
7934 =item Regular Expressions
7936 Many new and improved optimizations, Many bug fixes, New regular expression
7937 constructs, New operator for precompiled regular expressions, Other
7938 improvements, Incompatible changes
7940 =item   Improved malloc()
7942 =item Quicksort is internally implemented
7944 =item Reliable signals
7946 =item Reliable stack pointers
7948 =item More generous treatment of carriage returns
7950 =item Memory leaks
7952 =item Better support for multiple interpreters
7954 =item Behavior of local() on array and hash elements is now well-defined
7956 =item C<%!> is transparently tied to the L<Errno> module
7958 =item Pseudo-hashes are supported
7960 =item C<EXPR foreach EXPR> is supported
7962 =item Keywords can be globally overridden
7964 =item C<$^E> is meaningful on Win32
7966 =item C<foreach (1..1000000)> optimized
7968 =item C<Foo::> can be used as implicitly quoted package name
7970 =item C<exists $Foo::{Bar::}> tests existence of a package
7972 =item Better locale support
7974 =item Experimental support for 64-bit platforms
7976 =item prototype() returns useful results on builtins
7978 =item Extended support for exception handling
7980 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
7982 =item All C<printf> format conversions are handled internally
7984 =item New C<INIT> keyword
7986 =item New C<lock> keyword
7988 =item New C<qr//> operator
7990 =item C<our> is now a reserved word
7992 =item Tied arrays are now fully supported
7994 =item Tied handles support is better
7996 =item 4th argument to substr
7998 =item Negative LENGTH argument to splice
8000 =item Magic lvalues are now more magical
8002 =item <> now reads in records
8004 =back
8006 =item Supported Platforms
8008 =over 4
8010 =item New Platforms
8012 =item Changes in existing support
8014 =back
8016 =item Modules and Pragmata
8018 =over 4
8020 =item New Modules
8022 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
8023 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
8024 Thread, attrs, fields, re
8026 =item Changes in existing modules
8028 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
8029 MakeMaker, CPAN, Cwd
8031 =back
8033 =item Utility Changes
8035 =item Documentation Changes
8037 =item New Diagnostics
8039 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
8040 while coercing array into hash, Bareword "%s" refers to nonexistent
8041 package, Can't call method "%s" on an undefined value, Can't check
8042 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
8043 goto subroutine from an eval-string, Can't localize pseudo-hash element,
8044 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
8045 for "%s", Character class syntax [. .] is reserved for future extensions,
8046 Character class syntax [: :] is reserved for future extensions, Character
8047 class syntax [= =] is reserved for future extensions, %s: Eval-group in
8048 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
8049 Eval-group not allowed at run time, Explicit blessing to '' (assuming
8050 package main), Illegal hex digit ignored, No such array field, No such
8051 field "%s" in variable %s of type %s, Out of memory during ridiculously
8052 large request, Range iterator outside integer range, Recursive inheritance
8053 detected while looking for method '%s' %s, Reference found where even-sized
8054 list expected, Undefined value assigned to typeglob, Use of reserved word
8055 "%s" is deprecated, perl: warning: Setting locale failed
8057 =item Obsolete Diagnostics
8059 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
8060 temporary file, regexp too big
8062 =item Configuration Changes
8064 =item BUGS
8066 =item SEE ALSO
8068 =item HISTORY
8070 =back
8072 =head2 perl5004delta - what's new for perl5.004
8074 =over 4
8076 =item DESCRIPTION
8078 =item Supported Environments
8080 =item Core Changes
8082 =over 4
8084 =item List assignment to %ENV works
8086 =item Change to "Can't locate Foo.pm in @INC" error
8088 =item Compilation option: Binary compatibility with 5.003
8090 =item $PERL5OPT environment variable
8092 =item Limitations on B<-M>, B<-m>, and B<-T> options
8094 =item More precise warnings
8096 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
8098 =item Previously deprecated %OVERLOAD is no longer usable
8100 =item Subroutine arguments created only when they're modified
8102 =item Group vector changeable with C<$)>
8104 =item Fixed parsing of $$<digit>, &$<digit>, etc.
8106 =item Fixed localization of $<digit>, $&, etc.
8108 =item No resetting of $. on implicit close
8110 =item C<wantarray> may return undef
8112 =item C<eval EXPR> determines value of EXPR in scalar context
8114 =item Changes to tainting checks
8116 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
8117 spawning if tainted $TERM doesn't look like a terminal name
8119 =item New Opcode module and revised Safe module
8121 =item Embedding improvements
8123 =item Internal change: FileHandle class based on IO::* classes
8125 =item Internal change: PerlIO abstraction interface
8127 =item New and changed syntax
8129 $coderef->(PARAMS)
8131 =item New and changed builtin constants
8133 __PACKAGE__
8135 =item New and changed builtin variables
8137 $^E, $^H, $^M
8139 =item New and changed builtin functions
8141 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
8142 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
8143 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
8144 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
8145 nested C<sub{}> closures work now, formats work right on changing lexicals
8147 =item New builtin methods
8149 isa(CLASS), can(METHOD), VERSION( [NEED] )
8151 =item TIEHANDLE now supported
8153 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
8154 LIST, READLINE this, GETC this, DESTROY this
8156 =item Malloc enhancements
8158 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
8160 =item Miscellaneous efficiency enhancements
8162 =back
8164 =item Support for More Operating Systems
8166 =over 4
8168 =item Win32
8170 =item Plan 9
8172 =item QNX
8174 =item AmigaOS
8176 =back
8178 =item Pragmata
8180 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
8181 constant NAME => VALUE, use locale, use ops, use vmsish
8183 =item Modules
8185 =over 4
8187 =item Required Updates
8189 =item Installation directories
8191 =item Module information summary
8193 =item Fcntl
8195 =item IO
8197 =item Math::Complex
8199 =item Math::Trig
8201 =item DB_File
8203 =item Net::Ping
8205 =item Object-oriented overrides for builtin operators
8207 =back
8209 =item Utility Changes
8211 =over 4
8213 =item pod2html
8215 Sends converted HTML to standard output
8217 =item xsubpp
8219 C<void> XSUBs now default to returning nothing
8221 =back
8223 =item C Language API Changes
8225 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
8226 manipulating hashes
8228 =item Documentation Changes
8230 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
8231 L<perlmodlib>, L<perldebug>, L<perlsec>
8233 =item New Diagnostics
8235 "my" variable %s masks earlier declaration in same scope, %s argument is
8236 not a HASH element or slice, Allocation too large: %lx, Allocation too
8237 large, Applying %s to %s will act on scalar(%s), Attempt to free
8238 nonexistent shared string, Attempt to use reference as lvalue in substr,
8239 Bareword "%s" refers to nonexistent package, Can't redefine active sort
8240 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
8241 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
8242 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
8243 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
8244 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
8245 %s, Integer overflow in hex number, Integer overflow in octal number,
8246 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
8247 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
8248 possible typo, Null picture in formline, Offset outside string, Out of
8249 memory!, Out of memory during request for %s, panic: frexp, Possible
8250 attempt to put comments in qw() list, Possible attempt to separate words
8251 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
8252 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
8253 option, untie attempted while %d inner references still exist, Unrecognized
8254 character %s, Unsupported function fork, Use of "$$<digit>" to mean
8255 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
8256 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
8257 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
8258 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
8259 long, Process terminated by SIG%s
8261 =item BUGS
8263 =item SEE ALSO
8265 =item HISTORY
8267 =back
8269 =head2 perlartistic - the Perl Artistic License
8271 =over 4
8273 =item SYNOPSIS
8275 =item DESCRIPTION
8277 =item The "Artistic License"
8279 =over 4
8281 =item Preamble
8283 =item Definitions
8285 "Package", "Standard Version", "Copyright Holder", "You", "Reasonable
8286 copying fee", "Freely Available"
8288 =item Conditions
8290 a), b), c), d), a), b), c), d)
8292 =back
8294 =back
8296 =head2 perlgpl - the GNU General Public License, version 2
8298 =over 4
8300 =item SYNOPSIS
8302 =back
8304 =over 4
8306 =item DESCRIPTION
8308 =item GNU GENERAL PUBLIC LICENSE
8310 =back
8312 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
8314 =over 4
8316 =item DESCRIPTION
8318 =over 4
8320 =item Compiling Perl 5 on AIX
8322 =item OS level
8324 =item Building Dynamic Extensions on AIX
8326 =item The IBM ANSI C Compiler
8328 =item The usenm option
8330 =item Using GNU's gcc for building perl
8332 =item Using Large Files with Perl
8334 =item Threaded Perl
8336 =item 64-bit Perl
8338 =item AIX 4.2 and extensions using C++ with statics
8340 =back
8342 =item AUTHOR
8344 =item DATE
8346 =back
8348 =head2 perlamiga - Perl under Amiga OS
8350 =over 4
8352 =item NOTE
8354 =item SYNOPSIS
8356 =back
8358 =over 4
8360 =item DESCRIPTION
8362 =over 4
8364 =item Prerequisites for Compiling Perl on AmigaOS
8366 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
8368 =item Starting Perl programs under AmigaOS
8370 =item Shortcomings of Perl under AmigaOS
8372 =back
8374 =item INSTALLATION
8376 =item Accessing documentation
8378 =over 4
8380 =item Manpages for Perl on AmigaOS
8382 =item Perl HTML Documentation on AmigaOS
8384 =item Perl GNU Info Files on AmigaOS
8386 =item Perl LaTeX Documentation on AmigaOS
8388 =back
8390 =item BUILDING PERL ON AMIGAOS
8392 =over 4
8394 =item Build Prerequisites for Perl on AmigaOS
8396 =item Getting the Perl Source for AmigaOS
8398 =item Making Perl on AmigaOS
8400 =item Testing Perl on AmigaOS
8402 =item Installing the built Perl on AmigaOS
8404 =back
8406 =item PERL 5.8.0 BROKEN IN AMIGAOS
8408 =item AUTHORS
8410 =item SEE ALSO
8412 =back
8414 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
8416 =over 4
8418 =item DESCRIPTION
8420 =item AUTHOR
8422 =back
8424 =head2 perlbeos, README.beos - Perl version 5.8+ on BeOS
8426 =over 4
8428 =item DESCRIPTION
8430 =item BUILD AND INSTALL
8432 =over 4
8434 =item Requirements
8436 =item Configure
8438 =item Build
8440 =item Install
8442 =back
8444 =item KNOWN PROBLEMS
8446 =item CONTACT
8448 =back
8450 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
8452 =over 4
8454 =item SYNOPSIS
8456 =item DESCRIPTION
8458 =over 4
8460 =item gzip on BS2000
8462 =item bison on BS2000
8464 =item Unpacking Perl Distribution on BS2000
8466 =item Compiling Perl on BS2000
8468 =item Testing Perl on BS2000
8470 =item Installing Perl on BS2000
8472 =item Using Perl in the Posix-Shell of BS2000
8474 =item Using Perl in "native" BS2000
8476 =item Floating point anomalies on BS2000
8478 =item Using PerlIO and different encodings on ASCII and EBCDIC partitions
8480 =back
8482 =item AUTHORS
8484 =item SEE ALSO
8486 =over 4
8488 =item Mailing list
8490 =back
8492 =item HISTORY
8494 =back
8496 =head2 perlce - Perl for WinCE
8498 =over 4
8500 =item DESCRIPTION
8502 =item BUILD
8504 =over 4
8506 =item Tools & SDK
8508 Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's
8509 celib-sources, Rainer Keuchel's console-sources
8511 =item Make
8513 go to ./wince subdirectory, edit file compile.bat, run    compile.bat, run 
8514   compile.bat dist
8516 =back
8518 =item ACKNOWLEDGEMENTS
8520 =item AUTHORS
8522 =back
8524 =head2 perlcygwin, README.cygwin - Perl for Cygwin
8526 =over 4
8528 =item SYNOPSIS
8530 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
8532 =over 4
8534 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
8536 =item Cygwin Configuration
8538 C<PATH>, I<nroff>, Permissions
8540 =back
8542 =item CONFIGURE PERL ON CYGWIN
8544 =over 4
8546 =item Stripping Perl Binaries on Cygwin
8548 =item Optional Libraries for Perl on Cygwin
8550 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
8551 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
8553 =item Configure-time Options for Perl on Cygwin
8555 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
8556 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
8557 C<-Dmksymlinks>
8559 =item Suspicious Warnings on Cygwin
8561 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
8563 =back
8565 =item MAKE ON CYGWIN
8567 =over 4
8569 =item Errors on Cygwin
8571 =item ld2 on Cygwin
8573 =back
8575 =item TEST ON CYGWIN
8577 =over 4
8579 =item File Permissions on Cygwin
8581 =item NDBM_File and ODBM_File do not work on FAT filesystems
8583 =item C<fork()> failures in io_* tests
8585 =back
8587 =item Specific features of the Cygwin port
8589 =over 4
8591 =item Script Portability on Cygwin
8593 Pathnames, Text/Binary, PerlIO, F<.exe>, cygwin vs. windows process ids,
8594 C<chown()>, Miscellaneous
8596 =item Prebuilt methods:
8598 C<Cwd::cwd>, C<Cygwin::pid_to_winpid>, C<Cygwin::winpid_to_pid>
8600 =back
8602 =item INSTALL PERL ON CYGWIN
8604 =item MANIFEST ON CYGWIN
8606 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
8607 Source, Compiled Module Source, Perl Modules/Scripts
8609 =item BUGS ON CYGWIN
8611 =item AUTHORS
8613 =item HISTORY
8615 =back
8617 =head2 perldgux - Perl under DG/UX.
8619 =over 4
8621 =item SYNOPSIS
8623 =back
8625 =over 4
8627 =item DESCRIPTION
8629 =item BUILDING PERL ON DG/UX
8631 =over 4
8633 =item Non-threaded Perl on DG/UX
8635 =item Threaded Perl on DG/UX
8637 =item Testing Perl on DG/UX
8639 =item Installing the built perl on DG/UX
8641 =back
8643 =item AUTHOR
8645 =item SEE ALSO
8647 =back
8649 =head2 perldos - Perl under DOS, W31, W95.
8651 =over 4
8653 =item SYNOPSIS
8655 =item DESCRIPTION
8657 =over 4
8659 =item Prerequisites for Compiling Perl on DOS
8661 DJGPP, Pthreads
8663 =item Shortcomings of Perl under DOS
8665 =item Building Perl on DOS
8667 =item Testing Perl on DOS
8669 =item Installation of Perl on DOS
8671 =back
8673 =item BUILDING AND INSTALLING MODULES ON DOS
8675 =over 4
8677 =item Building Prerequisites for Perl on DOS
8679 =item Unpacking CPAN Modules on DOS
8681 =item Building Non-XS Modules on DOS
8683 =item Building XS Modules on DOS
8685 =back
8687 =item AUTHOR
8689 =item SEE ALSO
8691 =back
8693 =head2 perlepoc, README.epoc - Perl for EPOC
8695 =over 4
8697 =item SYNOPSIS
8699 =item INTRODUCTION
8701 =item INSTALLING PERL ON EPOC
8703 =item STARTING PERL ON EPOC
8705 =over 4
8707 =item Editors on Epoc
8709 =item Features of Perl on Epoc
8711 =item Restrictions of Perl on Epoc
8713 =item Compiling Perl 5 on the EPOC cross compiling environment
8715 =back
8717 =item SUPPORT STATUS OF PERL ON EPOC
8719 =item AUTHOR
8721 =item LAST UPDATE
8723 =back
8725 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
8727 =over 4
8729 =item DESCRIPTION
8731 =over 4
8733 =item FreeBSD core dumps from readdir_r with ithreads
8735 =item $^X doesn't always contain a full path in FreeBSD
8737 =item Perl will no longer be part of "base FreeBSD"
8739 =back
8741 =item AUTHOR
8743 =back
8745 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
8746 (HP-UX) systems
8748 =over 4
8750 =item DESCRIPTION
8752 =over 4
8754 =item Using perl as shipped with HP-UX
8756 =item Using perl from HP's porting centre
8758 =item Compiling Perl 5 on HP-UX
8760 =item PA-RISC
8762 =item Portability Between PA-RISC Versions
8764 =item PA-RISC 1.0
8766 =item PA-RISC 1.1
8768 =item PA-RISC 2.0
8770 =item Itanium Processor Family and HP-UX
8772 =item Itanium & Itanium 2
8774 =item Building Dynamic Extensions on HP-UX
8776 =item The HP ANSI C Compiler
8778 =item The GNU C Compiler
8780 =item Using Large Files with Perl on HP-UX
8782 =item Threaded Perl on HP-UX
8784 =item 64-bit Perl on HP-UX
8786 =item Oracle on HP-UX
8788 =item GDBM and Threads on HP-UX
8790 =item NFS filesystems and utime(2) on HP-UX
8792 =item perl -P and // and HP-UX
8794 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
8796 =back
8798 =item nss_delete core dump from op/pwent or op/grent
8800 =item AUTHOR
8802 =item DATE
8804 =back
8806 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
8808 =over 4
8810 =item DESCRIPTION
8812 =over 4
8814 =item Known Problems with Perl on Hurd 
8816 =back
8818 =item AUTHOR
8820 =back
8822 =head2 perlirix, README.irix - Perl version 5 on Irix systems
8824 =over 4
8826 =item DESCRIPTION
8828 =over 4
8830 =item Building 32-bit Perl in Irix
8832 =item Building 64-bit Perl in Irix
8834 =item About Compiler Versions of Irix
8836 =item Linker Problems in Irix
8838 =item Malloc in Irix
8840 =item Building with threads in Irix
8842 =item Irix 5.3
8844 =back
8846 =item AUTHOR
8848 =back
8850 =head2 perllinux, README.linux - Perl version 5 on Linux systems
8852 =over 4
8854 =item DESCRIPTION
8856 =over 4
8858 =item Experimental Support for Sun Studio Compilers for Linux OS
8860 =back
8862 =item AUTHOR
8864 =back
8866 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
8867 systems
8869 =over 4
8871 =item DESCRIPTION
8873 =over 4
8875 =item Perl version 5.8.x and greater not supported
8877 =item Compiling Perl 5.6.x on MachTen
8879 =item Failures during C<make test> on MachTen
8881 op/lexassign.t, pragma/warnings.t
8883 =item Building external modules on MachTen
8885 =back
8887 =item AUTHOR
8889 =item DATE
8891 =back
8893 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
8895 =over 4
8897 =item SYNOPSIS
8899 =item DESCRIPTION
8901 =item AUTHOR
8903 =item DATE
8905 =back
8907 =head2 perlmacosx, README.macosx - Perl under Mac OS X
8909 =over 4
8911 =item SYNOPSIS
8913 =item DESCRIPTION
8915 =over 4
8917 =item Installation Prefix
8919 =item libperl and Prebinding
8921 =item Updating Apple-supplied Perl
8923 =item 64-bit Perl
8925 =item Intel processor support
8927 =item  Universal binaries
8929 =item Known problems
8931 =item MacPerl
8933 =item Carbon
8935 =item Cocoa
8937 =back
8939 =item Starting From Scratch
8941 =item AUTHOR
8943 =item DATE
8945 =back
8947 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
8949 =over 4
8951 =item DESCRIPTION
8953 =item Known problems with Perl on MiNT
8955 =item AUTHOR
8957 =back
8959 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
8961 =over 4
8963 =item SYNOPSIS
8965 =item NOTE
8967 =item Binary distribution from HP
8969 =item What's New in Perl for MPE/iX
8971 =item Welcome to Perl/iX
8973 =item System Requirements for Perl/iX
8975 =item How to Obtain Perl/iX
8977 =item Perl/iX Distribution Contents Highlights
8979 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
8980 public_html/feedback.cgi, src/perl-5.6.0-mpe
8982 =item How to Compile Perl/iX
8984  4,  6
8986 =item Getting Started with Perl/iX
8988 =item MPE/iX Implementation Considerations
8990 =item Known Perl/iX Bugs Under Investigation
8992 =item Perl/iX To-Do List
8994 =item Perl/iX Change History
8996 =item AUTHOR
8998 =back
9000 =head2 perlnetware - Perl for NetWare
9002 =over 4
9004 =item DESCRIPTION
9006 =item BUILD
9008 =over 4
9010 =item Tools & SDK
9012 =item Setup
9014 SetNWBld.bat, Buildtype.bat
9016 =item Make
9018 =item Interpreter
9020 =item Extensions
9022 =back
9024 =item INSTALL
9026 =item BUILD NEW EXTENSIONS
9028 =item ACKNOWLEDGEMENTS
9030 =item AUTHORS
9032 =item DATE
9034 =back
9036 =head2 perlopenbsd, README.openbsd - Perl version 5 on OpenBSD systems
9038 =over 4
9040 =item DESCRIPTION
9042 =over 4
9044 =item OpenBSD core dumps from getprotobyname_r and getservbyname_r with
9045 ithreads
9047 =back
9049 =item AUTHOR
9051 =back
9053 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
9055 =over 4
9057 =item SYNOPSIS
9059 =back
9061 =over 4
9063 =item DESCRIPTION
9065 =over 4
9067 =item Target
9069 =item Other OSes
9071 =item Prerequisites
9073 EMX, RSX, HPFS, pdksh
9075 =item Starting Perl programs under OS/2 (and DOS and...)
9077 =item Starting OS/2 (and DOS) programs under Perl
9079 =back
9081 =item Frequently asked questions
9083 =over 4
9085 =item "It does not work"
9087 =item I cannot run external programs
9089 =item I cannot embed perl into my program, or use F<perl.dll> from my
9090 program. 
9092 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
9093 L<ExtUtils::Embed>?
9095 =item C<``> and pipe-C<open> do not work under DOS.
9097 =item Cannot start C<find.exe "pattern" file>
9099 =back
9101 =item INSTALLATION
9103 =over 4
9105 =item Automatic binary installation
9107 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
9109 =item Manual binary installation
9111 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
9112 (statically linked), Executables for Perl utilities, Main Perl library,
9113 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
9114 and utilities, Manpages for Perl modules, Source for Perl documentation,
9115 Perl manual in F<.INF> format, Pdksh
9117 =item B<Warning>
9119 =back
9121 =item Accessing documentation
9123 =over 4
9125 =item OS/2 F<.INF> file
9127 =item Plain text
9129 =item Manpages
9131 =item HTML
9133 =item GNU C<info> files
9135 =item F<PDF> files
9137 =item C<LaTeX> docs
9139 =back
9141 =item BUILD
9143 =over 4
9145 =item The short story
9147 =item Prerequisites
9149 =item Getting perl source
9151 =item Application of the patches
9153 =item Hand-editing
9155 =item Making
9157 =item Testing
9159 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
9160 F<op/stat.t>
9162 =item Installing the built perl
9164 =item C<a.out>-style build
9166 =back
9168 =item Building a binary distribution
9170 =item Building custom F<.EXE> files
9172 =over 4
9174 =item Making executables with a custom collection of statically loaded
9175 extensions
9177 =item Making executables with a custom search-paths
9179 =back
9181 =item Build FAQ
9183 =over 4
9185 =item Some C</> became C<\> in pdksh.
9187 =item C<'errno'> - unresolved external
9189 =item Problems with tr or sed
9191 =item Some problem (forget which ;-)
9193 =item Library ... not found
9195 =item Segfault in make
9197 =item op/sprintf test failure
9199 =back
9201 =item Specific (mis)features of OS/2 port
9203 =over 4
9205 =item C<setpriority>, C<getpriority>
9207 =item C<system()>
9209 =item C<extproc> on the first line
9211 =item Additional modules:
9213 =item Prebuilt methods:
9215 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
9216  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>, 
9217 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>, 
9218 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>, 
9219 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>, 
9220 C<Cwd::extLibpath_set( path [, type ] )>,
9221 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
9222 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
9223 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
9224 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
9225 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
9226 C<OS2::DLLname([how [, \&xsub]])>
9228 =item Prebuilt variables:
9230 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
9231 $OS2::nsyserror
9233 =item Misfeatures
9235 =item Modifications
9237 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
9238 C<flock>
9240 =item Identifying DLLs
9242 =item Centralized management of resources
9244 C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
9245 C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
9246 C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
9247 C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
9249 =back
9251 =item Perl flavors
9253 =over 4
9255 =item F<perl.exe>
9257 =item F<perl_.exe>
9259 =item F<perl__.exe>
9261 =item F<perl___.exe>
9263 =item Why strange names?
9265 =item Why dynamic linking?
9267 =item Why chimera build?
9269 =back
9271 =item ENVIRONMENT
9273 =over 4
9275 =item C<PERLLIB_PREFIX>
9277 =item C<PERL_BADLANG>
9279 =item C<PERL_BADFREE>
9281 =item C<PERL_SH_DIR>
9283 =item C<USE_PERL_FLOCK>
9285 =item C<TMP> or C<TEMP>
9287 =back
9289 =item Evolution
9291 =over 4
9293 =item Text-mode filehandles
9295 =item Priorities
9297 =item DLL name mangling: pre 5.6.2
9299 =item DLL name mangling: 5.6.2 and beyond
9301 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
9302 C<LIBPATH>
9304 =item DLL forwarder generation
9306 =item Threading
9308 =item Calls to external programs
9310 =item Memory allocation
9312 =item Threads
9314 C<COND_WAIT>, F<os2.c>
9316 =back
9318 =item BUGS
9320 =back
9322 =over 4
9324 =item AUTHOR
9326 =item SEE ALSO
9328 =back
9330 =head2 perlos390, README.os390 - building and installing Perl for OS/390
9331 and z/OS
9333 =over 4
9335 =item SYNOPSIS
9337 =item DESCRIPTION
9339 =over 4
9341 =item Tools
9343 =item Unpacking Perl distribution on OS/390
9345 =item Setup and utilities for Perl on OS/390
9347 =item Configure Perl on OS/390
9349 =item Build, Test, Install Perl on OS/390
9351 =item Build Anomalies with Perl on OS/390
9353 =item Testing Anomalies with Perl on OS/390
9355 =item Installation Anomalies with Perl on OS/390
9357 =item Usage Hints for Perl on OS/390
9359 =item Floating Point Anomalies with Perl on OS/390
9361 =item Modules and Extensions for Perl on OS/390
9363 =back
9365 =item AUTHORS
9367 =item SEE ALSO
9369 =over 4
9371 =item Mailing list for Perl on OS/390
9373 =back
9375 =item HISTORY
9377 =back
9379 =head2 perlos400, README.os400 - Perl version 5 on OS/400
9381 =over 4
9383 =item DESCRIPTION
9385 =over 4
9387 =item Compiling Perl for OS/400 PASE
9389 =item Installing Perl in OS/400 PASE
9391 =item Using Perl in OS/400 PASE
9393 =item Known Problems
9395 =item Perl on ILE
9397 =back
9399 =item AUTHORS
9401 =back
9403 =head2 perlplan9 - Plan 9-specific documentation for Perl
9405 =over 4
9407 =item DESCRIPTION
9409 =over 4
9411 =item Invoking Perl
9413 =item What's in Plan 9 Perl
9415 =item What's not in Plan 9 Perl
9417 =item Perl5 Functions not currently supported in Plan 9 Perl
9419 =item Signals in Plan 9 Perl
9421 =back
9423 =item COMPILING AND INSTALLING PERL ON PLAN 9
9425 =over 4
9427 =item Installing Perl Documentation on Plan 9
9429 =back
9431 =item BUGS
9433 =item Revision date
9435 =item AUTHOR
9437 =back
9439 =head2 perlqnx, README.qnx - Perl version 5 on QNX
9441 =over 4
9443 =item DESCRIPTION
9445 =over 4
9447 =item Required Software for Compiling Perl on QNX4
9449 /bin/sh, ar, nm, cpp, make
9451 =item Outstanding Issues with Perl on QNX4
9453 =item QNX auxiliary files
9455 qnx/ar, qnx/cpp
9457 =item Outstanding issues with perl under QNX6
9459 =back
9461 =item AUTHOR
9463 =back
9465 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
9467 =over 4
9469 =item DESCRIPTION
9471 =over 4
9473 =item Solaris Version Numbers.
9475 =back
9477 =item RESOURCES
9479 Solaris FAQ, Precompiled Binaries, Solaris Documentation
9481 =item SETTING UP
9483 =over 4
9485 =item File Extraction Problems on Solaris.
9487 =item Compiler and Related Tools on Solaris.
9489 =item Environment for Compiling perl on Solaris
9491 =back
9493 =item RUN CONFIGURE.
9495 =over 4
9497 =item 64-bit perl on Solaris.
9499 =item Threads in perl on Solaris.
9501 =item Malloc Issues with perl on Solaris.
9503 =back
9505 =item MAKE PROBLEMS.
9507 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
9508 relocation error:, dlopen: stub interception failed, #error "No
9509 DATAMODEL_NATIVE specified", sh: ar: not found, warning: dead part of
9510 constant expression is nonconstant
9512 =item MAKE TEST
9514 =over 4
9516 =item op/stat.t test 4 in Solaris
9518 =item nss_delete core dump from op/pwent or op/grent
9520 =back
9522 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
9524 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
9526 =over 4
9528 =item Limits on Numbers of Open Files on Solaris.
9530 =back
9532 =item SOLARIS-SPECIFIC MODULES.
9534 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
9536 =over 4
9538 =item Proc::ProcessTable on Solaris
9540 =item BSD::Resource on Solaris
9542 =item Net::SSLeay on Solaris
9544 =back
9546 =item SunOS 4.x
9548 =item AUTHOR
9550 =back
9552 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
9553 Digital UNIX formerly known as DEC OSF/1) systems
9555 =over 4
9557 =item DESCRIPTION
9559 =over 4
9561 =item Compiling Perl 5 on Tru64
9563 =item Using Large Files with Perl on Tru64
9565 =item Threaded Perl on Tru64
9567 =item Long Doubles on Tru64
9569 =item DB_File tests failing on Tru64
9571 =item 64-bit Perl on Tru64
9573 =item Warnings about floating-point overflow when compiling Perl on Tru64
9575 =back
9577 =item Testing Perl on Tru64
9579 =item ext/ODBM_File/odbm Test Failing With Static Builds
9581 =item Perl Fails Because Of Unresolved Symbol sockatmark
9583 =item AUTHOR
9585 =back
9587 =head2 perluts - Perl under UTS
9589 =over 4
9591 =item SYNOPSIS
9593 =item DESCRIPTION
9595 =item BUILDING PERL ON UTS
9597 =item Installing the built perl on UTS
9599 =item AUTHOR
9601 =back
9603 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
9605 =over 4
9607 =item SYNOPSIS
9609 =item DESCRIPTION
9611 =over 4
9613 =item Unpacking Perl Distribution on VM/ESA
9615 =item Setup Perl and utilities on VM/ESA
9617 =item Configure Perl on VM/ESA
9619 =item Testing Anomalies of Perl on VM/ESA
9621 =item Usage Hints for Perl on VM/ESA
9623 =back
9625 =item AUTHORS
9627 =item SEE ALSO
9629 =over 4
9631 =item Mailing list for Perl on VM/ESA
9633 =back
9635 =back
9637 =head2 perlvms - VMS-specific documentation for Perl
9639 =over 4
9641 =item DESCRIPTION
9643 =item Installation
9645 =item Organization of Perl Images
9647 =over 4
9649 =item Core Images
9651 =item Perl Extensions
9653 =item Installing static extensions
9655 =item Installing dynamic extensions
9657 =back
9659 =item File specifications
9661 =over 4
9663 =item Syntax
9665 =item Wildcard expansion
9667 =item Pipes
9669 =back
9671 =item PERL5LIB and PERLLIB
9673 =item Command line
9675 =over 4
9677 =item I/O redirection and backgrounding
9679 =item Command line switches
9681 -i, -S, -u
9683 =back
9685 =item Perl functions
9687 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
9688 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
9689 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
9690 LIST, waitpid PID,FLAGS
9692 =item Perl variables
9694 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
9696 =item Standard modules with VMS-specific differences
9698 =over 4
9700 =item SDBM_File
9702 =back
9704 =item Revision date
9706 =item AUTHOR
9708 =back
9710 =head2 perlvos, README.vos - Perl for Stratus VOS
9712 =over 4
9714 =item SYNOPSIS
9716 =over 4
9718 =item Multiple methods to build perl for VOS
9720 =item Stratus POSIX Support
9722 =back
9724 =item INSTALLING PERL IN VOS
9726 =over 4
9728 =item Compiling Perl 5 on VOS
9730 =item Installing Perl 5 on VOS
9732 =back
9734 =item USING PERL IN VOS
9736 =over 4
9738 =item Unimplemented Features of Perl on VOS
9740 =item Restrictions of Perl on VOS
9742 =item Handling of underflow and overflow
9744 =back
9746 =item TEST STATUS
9748 =item SUPPORT STATUS
9750 =item AUTHOR
9752 =item LAST UPDATE
9754 =back
9756 =head2 perlwin32 - Perl under Windows
9758 =over 4
9760 =item SYNOPSIS
9762 =item DESCRIPTION
9764 =over 4
9766 =item Setting Up Perl on Win32
9768 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Visual
9769 C++ Toolkit 2003, Microsoft Platform SDK 64-bit Compiler, MinGW release 3
9770 with gcc, MinGW release 1 with gcc
9772 =item Building
9774 =item Testing Perl on Win32
9776 =item Installation of Perl on Win32
9778 =item Usage Hints for Perl on Win32
9780 Environment Variables, File Globbing, Using perl from the command line,
9781 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
9782 Extensions, Notes on 64-bit Windows
9784 =item Running Perl Scripts
9786 =item Miscellaneous Things
9788 =back
9790 =item BUGS AND CAVEATS
9792 =item ACKNOWLEDGEMENTS
9794 =item AUTHORS
9796 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
9797 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
9798 E<lt>nick@ing-simmons.netE<gt>, Jan Dubois E<lt>jand@activestate.comE<gt>,
9799 Steve Hay E<lt>steve.hay@uk.radan.comE<gt>
9801 =item SEE ALSO
9803 =item HISTORY
9805 =back
9807 =head1 PRAGMA DOCUMENTATION
9809 =head2 attrs - set/get attributes of a subroutine (deprecated)
9811 =over 4
9813 =item SYNOPSIS
9815 =item DESCRIPTION
9817 method, locked
9819 =back
9821 =head2 re - Perl pragma to alter regular expression behaviour
9823 =over 4
9825 =item SYNOPSIS
9827 =item DESCRIPTION
9829 =back
9831 =head2 threadshared::shared, threads::shared - Perl extension for sharing
9832 data structures between threads
9834 =over 4
9836 =item SYNOPSIS
9838 =item DESCRIPTION
9840 =item EXPORT
9842 =item FUNCTIONS
9844 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
9845 LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
9846 ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
9848 =item NOTES
9850 =item BUGS
9852 =item AUTHOR
9854 =item SEE ALSO
9856 =back
9858 =head2 threads - Perl extension allowing use of interpreter based threads
9859 from perl
9861 =over 4
9863 =item SYNOPSIS
9865 =item DESCRIPTION
9867 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
9868 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
9869 threads->list();, async BLOCK;
9871 =item WARNINGS
9873 A thread exited while %d other threads were still running
9875 =item TODO
9877 =item BUGS
9879 Parent-Child threads, tid is I32, Returning objects, Creating threads
9880 inside BEGIN blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
9882 =item AUTHOR and COPYRIGHT
9884 =item SEE ALSO
9886 =back
9888 =head2 attributes - get/set subroutine or variable attributes
9890 =over 4
9892 =item SYNOPSIS
9894 =item DESCRIPTION
9896 =over 4
9898 =item Built-in Attributes
9900 locked, method, lvalue
9902 =item Available Subroutines
9904 get, reftype
9906 =item Package-specific Attribute Handling
9908 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
9910 =item Syntax of Attribute Lists
9912 =back
9914 =item EXPORTS
9916 =over 4
9918 =item Default exports
9920 =item Available exports
9922 =item Export tags defined
9924 =back
9926 =item EXAMPLES
9928 =item SEE ALSO
9930 =back
9932 =head2 autouse - postpone load of modules until a function is used
9934 =over 4
9936 =item SYNOPSIS
9938 =item DESCRIPTION
9940 =item WARNING
9942 =item AUTHOR
9944 =item SEE ALSO
9946 =back
9948 =head2 base - Establish IS-A relationship with base classes at compile time
9950 =over 4
9952 =item SYNOPSIS
9954 =item DESCRIPTION
9956 =item DIAGNOSTICS
9958 Base class package "%s" is empty
9960 =item HISTORY
9962 =item CAVEATS
9964 =item SEE ALSO
9966 =back
9968 =head2 bigint - Transparent BigInteger support for Perl
9970 =over 4
9972 =item SYNOPSIS
9974 =item DESCRIPTION
9976 =over 4
9978 =item Options
9980 a or accuracy, p or precision, t or trace, l or lib, v or version
9982 =item Math Library
9984 =item Internal Format
9986 =item Sign
9988 =item Methods
9990 =item Caveat
9992 =back
9994 =item MODULES USED
9996 =item EXAMPLES
9998 =item LICENSE
10000 =item SEE ALSO
10002 =item AUTHORS
10004 =back
10006 =head2 bignum - Transparent BigNumber support for Perl
10008 =over 4
10010 =item SYNOPSIS
10012 =item DESCRIPTION
10014 =over 4
10016 =item Options
10018 a or accuracy, p or precision, t or trace, l or lib, v or version
10020 =item Methods
10022 =item Caveat
10024 inf(), NaN(), upgrade()
10026 =item MATH LIBRARY
10028 =item INTERNAL FORMAT
10030 =item SIGN
10032 =back
10034 =item MODULES USED
10036 =item EXAMPLES
10038 =item LICENSE
10040 =item SEE ALSO
10042 =item AUTHORS
10044 =back
10046 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
10048 =over 4
10050 =item SYNOPSIS
10052 =item DESCRIPTION
10054 =over 4
10056 =item Modules Used
10058 =item Math Library
10060 =item Sign
10062 =item Methods
10064 =item Cavaet
10066 =item Options
10068 a or accuracy, p or precision, t or trace, l or lib, v or version
10070 =back
10072 =item EXAMPLES
10074         perl -Mbigrat -le 'print sqrt(33)'
10075         perl -Mbigrat -le 'print 2*255'
10076         perl -Mbigrat -le 'print 4.5+2*255'
10077         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'       
10078         perl -Mbigrat -le 'print 12->is_odd()';
10080 =item LICENSE
10082 =item SEE ALSO
10084 =item AUTHORS
10086 =back
10088 =head2 blib - Use MakeMaker's uninstalled version of a package
10090 =over 4
10092 =item SYNOPSIS
10094 =item DESCRIPTION
10096 =item BUGS
10098 =item AUTHOR
10100 =back
10102 =head2 bytes - Perl pragma to force byte semantics rather than character
10103 semantics
10105 =over 4
10107 =item SYNOPSIS
10109 =item DESCRIPTION
10111 =item LIMITATIONS
10113 =item SEE ALSO
10115 =back
10117 =head2 charnames - define character names for C<\N{named}> string literal
10118 escapes
10120 =over 4
10122 =item SYNOPSIS
10124 =item DESCRIPTION
10126 =item CUSTOM TRANSLATORS
10128 =item CUSTOM ALIASES
10130 =over 4
10132 =item Anonymous hashes
10134 =item Alias file
10136 =item Alias shortcut
10138 =back
10140 =item charnames::viacode(code)
10142 =item charnames::vianame(name)
10144 =item ALIASES
10146 =item ILLEGAL CHARACTERS
10148 =item BUGS
10150 =back
10152 =head2 constant - Perl pragma to declare constants
10154 =over 4
10156 =item SYNOPSIS
10158 =item DESCRIPTION
10160 =item NOTES
10162 =over 4
10164 =item List constants
10166 =item Defining multiple constants at once
10168 =item Magic constants
10170 =back
10172 =item TECHNICAL NOTES
10174 =item BUGS
10176 =item AUTHOR
10178 =item COPYRIGHT
10180 =back
10182 =head2 diagnostics, splain - produce verbose warning diagnostics
10184 =over 4
10186 =item SYNOPSIS
10188 =item DESCRIPTION
10190 =over 4
10192 =item The C<diagnostics> Pragma
10194 =item The I<splain> Program
10196 =back
10198 =item EXAMPLES
10200 =item INTERNALS
10202 =item BUGS
10204 =item AUTHOR
10206 =back
10208 =head2 encoding - allows you to write your script in non-ascii or non-utf8
10210 =over 4
10212 =item SYNOPSIS
10214 =item ABSTRACT
10216 =over 4
10218 =item Literal Conversions
10220 =item PerlIO layers for C<STD(IN|OUT)>
10222 =item Implicit upgrading for byte strings
10224 =back
10226 =item FEATURES THAT REQUIRE 5.8.1
10228 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
10230 =item USAGE
10232 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
10233 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
10235 =item The Filter Option
10237 =over 4
10239 =item Filter-related changes at Encode version 1.87
10241 =back
10243 =item CAVEATS
10245 =over 4
10247 =item NOT SCOPED
10249 =item DO NOT MIX MULTIPLE ENCODINGS
10251 =item tr/// with ranges
10253 Legend of characters above
10255 =back
10257 =item EXAMPLE - Greekperl
10259 =item KNOWN PROBLEMS
10261 literals in regex that are longer than 127 bytes, EBCDIC, format
10263 =over 4
10265 =item The Logic of :locale
10267 =back
10269 =item HISTORY
10271 =item SEE ALSO
10273 =back
10275 =head2 fields - compile-time class fields
10277 =over 4
10279 =item SYNOPSIS
10281 =item DESCRIPTION
10283 new, phash
10285 =item SEE ALSO
10287 =back
10289 =head2 filetest - Perl pragma to control the filetest permission operators
10291 =over 4
10293 =item SYNOPSIS
10295 =item DESCRIPTION
10297 =over 4
10299 =item subpragma access
10301 =back
10303 =back
10305 =head2 if - C<use> a Perl module if a condition holds
10307 =over 4
10309 =item SYNOPSIS
10311 =item DESCRIPTION
10313 =item BUGS
10315 =item AUTHOR
10317 =back
10319 =head2 integer - Perl pragma to use integer arithmetic instead of floating
10320 point
10322 =over 4
10324 =item SYNOPSIS
10326 =item DESCRIPTION
10328 =back
10330 =head2 less - perl pragma to request less of something from the compiler
10332 =over 4
10334 =item SYNOPSIS
10336 =item DESCRIPTION
10338 =back
10340 =head2 lib - manipulate @INC at compile time
10342 =over 4
10344 =item SYNOPSIS
10346 =item DESCRIPTION
10348 =over 4
10350 =item Adding directories to @INC
10352 =item Deleting directories from @INC
10354 =item Restoring original @INC
10356 =back
10358 =item CAVEATS
10360 =item NOTES
10362 =item SEE ALSO
10364 =item AUTHOR
10366 =back
10368 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
10369 operations
10371 =over 4
10373 =item SYNOPSIS
10375 =item DESCRIPTION
10377 =back
10379 =head2 open - perl pragma to set default PerlIO layers for input and output
10381 =over 4
10383 =item SYNOPSIS
10385 =item DESCRIPTION
10387 =item NONPERLIO FUNCTIONALITY
10389 =item IMPLEMENTATION DETAILS
10391 =item SEE ALSO
10393 =back
10395 =head2 ops - Perl pragma to restrict unsafe operations when compiling
10397 =over 4
10399 =item SYNOPSIS  
10401 =item DESCRIPTION
10403 =item SEE ALSO
10405 =back
10407 =head2 overload - Package for overloading Perl operations
10409 =over 4
10411 =item SYNOPSIS
10413 =item DESCRIPTION
10415 =over 4
10417 =item Declaration of overloaded functions
10419 =item Calling Conventions for Binary Operations
10421 FALSE, TRUE, C<undef>
10423 =item Calling Conventions for Unary Operations
10425 =item Calling Conventions for Mutators
10427 C<++> and C<-->, C<x=> and other assignment versions
10429 =item Overloadable Operations
10431 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
10432 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
10433 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
10435 =item Inheritance and overloading
10437 Strings as values of C<use overload> directive, Overloading of an operation
10438 is inherited by derived classes
10440 =back
10442 =item SPECIAL SYMBOLS FOR C<use overload>
10444 =over 4
10446 =item Last Resort
10448 =item Fallback
10450 C<undef>, TRUE, defined, but FALSE
10452 =item Copy Constructor
10454 B<Example>
10456 =back
10458 =item MAGIC AUTOGENERATION
10460 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
10461 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
10462 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
10463 I<Copy operator>
10465 =item Losing overloading
10467 =item Run-time Overloading
10469 =item Public functions
10471 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
10473 =item Overloading constants
10475 integer, float, binary, q, qr
10477 =item IMPLEMENTATION
10479 =item Metaphor clash
10481 =item Cookbook
10483 =over 4
10485 =item Two-face scalars
10487 =item Two-face references
10489 =item Symbolic calculator
10491 =item I<Really> symbolic calculator
10493 =back
10495 =item AUTHOR
10497 =item DIAGNOSTICS
10499 Odd number of arguments for overload::constant, `%s' is not an overloadable
10500 type, `%s' is not a code reference
10502 =item BUGS
10504 =back
10506 =head2 sigtrap - Perl pragma to enable simple signal handling
10508 =over 4
10510 =item SYNOPSIS
10512 =item DESCRIPTION
10514 =item OPTIONS
10516 =over 4
10518 =item SIGNAL HANDLERS
10520 B<stack-trace>, B<die>, B<handler> I<your-handler>
10522 =item SIGNAL LISTS
10524 B<normal-signals>, B<error-signals>, B<old-interface-signals>
10526 =item OTHER
10528 B<untrapped>, B<any>, I<signal>, I<number>
10530 =back
10532 =item EXAMPLES
10534 =back
10536 =head2 sort - perl pragma to control sort() behaviour
10538 =over 4
10540 =item SYNOPSIS
10542 =item DESCRIPTION
10544 =item CAVEATS
10546 =back
10548 =head2 strict - Perl pragma to restrict unsafe constructs
10550 =over 4
10552 =item SYNOPSIS
10554 =item DESCRIPTION
10556 C<strict refs>, C<strict vars>, C<strict subs>
10558 =item HISTORY
10560 =back
10562 =head2 subs - Perl pragma to predeclare sub names
10564 =over 4
10566 =item SYNOPSIS
10568 =item DESCRIPTION
10570 =back
10572 =head2 threadshared, threads::shared - Perl extension for sharing data
10573 structures between threads
10575 =over 4
10577 =item SYNOPSIS
10579 =item DESCRIPTION
10581 =item EXPORT
10583 =item FUNCTIONS
10585 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
10586 LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
10587 ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
10589 =item NOTES
10591 =item BUGS
10593 =item AUTHOR
10595 =item SEE ALSO
10597 =back
10599 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
10600 code
10602 =over 4
10604 =item SYNOPSIS
10606 =item DESCRIPTION
10608 =over 4
10610 =item Utility functions
10612 $num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[,
10613 FAIL_OK]), utf8::encode($string), utf8::decode($string), $flag =
10614 utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
10616 =back
10618 =item BUGS
10620 =item SEE ALSO
10622 =back
10624 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
10626 =over 4
10628 =item SYNOPSIS
10630 =item DESCRIPTION
10632 =back
10634 =head2 vmsish - Perl pragma to control VMS-specific language features
10636 =over 4
10638 =item SYNOPSIS
10640 =item DESCRIPTION
10642 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
10644 =back
10646 =head2 warnings - Perl pragma to control optional warnings
10648 =over 4
10650 =item SYNOPSIS
10652 =item DESCRIPTION
10654 use warnings::register, warnings::enabled(), warnings::enabled($category),
10655 warnings::enabled($object), warnings::warn($message),
10656 warnings::warn($category, $message), warnings::warn($object, $message),
10657 warnings::warnif($message), warnings::warnif($category, $message),
10658 warnings::warnif($object, $message)
10660 =back
10662 =head2 warnings::register - warnings import function
10664 =over 4
10666 =item SYNOPSIS
10668 =item DESCRIPTION
10670 =back
10672 =head1 MODULE DOCUMENTATION
10674 =head2 AnyDBM_File - provide framework for multiple DBMs
10676 =over 4
10678 =item SYNOPSIS
10680 =item DESCRIPTION
10682 =over 4
10684 =item DBM Comparisons
10686 [0], [1], [2], [3]
10688 =back
10690 =item SEE ALSO
10692 =back
10694 =head2 Attribute::Handlers - Simpler definition of attribute handlers
10696 =over 4
10698 =item VERSION
10700 =item SYNOPSIS
10702 =item DESCRIPTION
10704 [0], [1], [2], [3], [4], [5]
10706 =over 4
10708 =item Typed lexicals
10710 =item Type-specific attribute handlers
10712 =item Non-interpretive attribute handlers
10714 =item Phase-specific attribute handlers
10716 =item Attributes as C<tie> interfaces
10718 =back
10720 =item EXAMPLES
10722 =item DIAGNOSTICS
10724 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
10725 attributes>, C<Declaration of %s attribute in package %s may clash with
10726 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
10727 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
10728 be able to apply END handler>
10730 =item AUTHOR
10732 =item BUGS
10734 =item COPYRIGHT
10736 =back
10738 =head2 AutoLoader - load subroutines only on demand
10740 =over 4
10742 =item SYNOPSIS
10744 =item DESCRIPTION
10746 =over 4
10748 =item Subroutine Stubs
10750 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
10752 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
10754 =item Package Lexicals
10756 =item Not Using AutoLoader
10758 =item B<AutoLoader> vs. B<SelfLoader>
10760 =back
10762 =item CAVEATS
10764 =item SEE ALSO
10766 =back
10768 =head2 AutoSplit - split a package for autoloading
10770 =over 4
10772 =item SYNOPSIS
10774 =item DESCRIPTION
10776 $keep, $check, $modtime
10778 =over 4
10780 =item Multiple packages
10782 =back
10784 =item DIAGNOSTICS
10786 =back
10788 =head2 B - The Perl Compiler
10790 =over 4
10792 =item SYNOPSIS
10794 =item DESCRIPTION
10796 =item OVERVIEW
10798 =item Utility Functions
10800 =over 4
10802 =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV>
10803 objects
10805 sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av,
10806 check_av, begin_av, end_av, comppadlist, regex_padav, main_cv
10808 =item Functions for Examining the Symbol Table
10810 walksymtable(SYMREF, METHOD, RECURSE, PREFIX)
10812 =item Functions Returning C<B::OP> objects or for walking op trees
10814 main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG)
10816 =item Miscellaneous Utility Functions
10818 ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR),
10819 perlstring(STR), class(OBJ), threadsv_names
10821 =back
10823 =item OVERVIEW OF CLASSES
10825 =over 4
10827 =item SV-RELATED CLASSES
10829 =item B::SV Methods
10831 REFCNT, FLAGS, object_2svref
10833 =item B::IV Methods
10835 IV, IVX, UVX, int_value, needs64bits, packiv
10837 =item B::NV Methods
10839 NV, NVX
10841 =item B::RV Methods
10845 =item B::PV Methods
10847 PV, RV, PVX
10849 =item B::PVMG Methods
10851 MAGIC, SvSTASH
10853 =item B::MAGIC Methods
10855 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
10857 =item B::PVLV Methods
10859 TARGOFF, TARGLEN, TYPE, TARG
10861 =item B::BM Methods
10863 USEFUL, PREVIOUS, RARE, TABLE
10865 =item B::GV Methods
10867 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
10868 LINE, FILE, FILEGV, GvREFCNT, FLAGS
10870 =item B::IO Methods
10872 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
10873 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
10875 =item B::AV Methods
10877 FILL, MAX, OFF, ARRAY, ARRAYelt, AvFLAGS
10879 =item B::CV Methods
10881 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB,
10882 XSUBANY, CvFLAGS, const_sv
10884 =item B::HV Methods
10886 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
10888 =item OP-RELATED CLASSES
10890 =item B::OP Methods
10892 next, sibling, name, ppaddr, desc, targ, type, opt, static, flags, private,
10893 spare
10895 =item B::UNOP METHOD
10897 first
10899 =item B::BINOP METHOD
10901 last
10903 =item B::LOGOP METHOD
10905 other
10907 =item B::LISTOP METHOD
10909 children
10911 =item B::PMOP Methods
10913 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
10914 pmpermflags, precomp, pmoffset
10916 =item B::SVOP METHOD
10918 sv, gv
10920 =item B::PADOP METHOD
10922 padix
10924 =item B::PVOP METHOD
10928 =item B::LOOP Methods
10930 redoop, nextop, lastop
10932 =item B::COP Methods
10934 label, stash, stashpv, file, cop_seq, arybase, line, warnings, io
10936 =back
10938 =item AUTHOR
10940 =back
10942 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
10943 bytecode
10945 =over 4
10947 =item SYNOPSIS
10949 =item DESCRIPTION
10951 %insn_data, @insn_name, @optype, @specialsv_name
10953 =item AUTHOR
10955 =back
10957 =head2 B::Assembler - Assemble Perl bytecode
10959 =over 4
10961 =item SYNOPSIS
10963 =item DESCRIPTION
10965 =item AUTHORS
10967 =back
10969 =head2 B::Bblock - Walk basic blocks
10971 =over 4
10973 =item SYNOPSIS
10975 =item DESCRIPTION
10977 =over 4
10979 =item Functions
10981 B<find_leaders>
10983 =back
10985 =item AUTHOR
10987 =back
10989 =head2 B::Bytecode - Perl compiler's bytecode backend
10991 =over 4
10993 =item SYNOPSIS
10995 =item DESCRIPTION
10997 =item EXAMPLE
10999 =item OPTIONS
11001 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
11003 =item KNOWN BUGS
11005 =item NOTICE
11007 =item AUTHORS
11009 =back
11011 =head2 B::C - Perl compiler's C backend
11013 =over 4
11015 =item SYNOPSIS
11017 =item DESCRIPTION
11019 =item OPTIONS
11021 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
11022 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
11023 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
11024 B<-llimit>
11026 =item EXAMPLES
11028 =item BUGS
11030 =item AUTHOR
11032 =back
11034 =head2 B::CC - Perl compiler's optimized C translation backend
11036 =over 4
11038 =item SYNOPSIS
11040 =item DESCRIPTION
11042 =item OPTIONS
11044 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
11045 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
11046 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
11048 =item EXAMPLES
11050 =item BUGS
11052 =item DIFFERENCES
11054 =over 4
11056 =item Loops
11058 =item Context of ".."
11060 =item Arithmetic
11062 =item Deprecated features
11064 =back
11066 =item AUTHOR
11068 =back
11070 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
11072 =over 4
11074 =item SYNOPSIS
11076 =item DESCRIPTION
11078 =item EXAMPLE
11080 =item OPTIONS
11082 =over 4
11084 =item Options for Opcode Ordering
11086 B<-basic>, B<-exec>, B<-tree>
11088 =item Options for Line-Style
11090 B<-concise>, B<-terse>, B<-linenoise>, B<-debug>, B<-env>
11092 =item Options for tree-specific formatting
11094 B<-compact>, B<-loose>, B<-vt>, B<-ascii>
11096 =item Options controlling sequence numbering
11098 B<-base>I<n>, B<-bigendian>, B<-littleendian>
11100 =item Other options
11102 B<-main>, B<-nomain>, B<-nobanner>, B<-banner>, B<-banneris> => subref
11104 =item Option Stickiness
11106 =back
11108 =item ABBREVIATIONS
11110 =over 4
11112 =item OP class abbreviations
11114 =item OP flags abbreviations
11116 =back
11118 =item FORMATTING SPECIFICATIONS
11120 =over 4
11122 =item Special Patterns
11124 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
11125 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
11126 B<~>
11128 =item # Variables
11130 B<#>I<var>, B<#>I<var>I<N>, B<#>I<Var>, B<#addr>, B<#arg>, B<#class>,
11131 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
11132 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
11133 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
11134 B<#seq>, B<#seqnum>, B<#opt>, B<#static>, B<#sibaddr>, B<#svaddr>,
11135 B<#svclass>, B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
11137 =back
11139 =item Using B::Concise outside of the O framework
11141 =over 4
11143 =item Example: Altering Concise Renderings
11145 =item set_style()
11147 =item set_style_standard($name)
11149 =item add_style()
11151 =item add_callback()
11153 =item Running B::Concise::compile()
11155 =item B::Concise::reset_sequence()
11157 =item Errors
11159 =back
11161 =item AUTHOR
11163 =back
11165 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
11167 =over 4
11169 =item SYNOPSIS
11171 =item DESCRIPTION
11173 =item AUTHOR
11175 =back
11177 =head2 B::Deparse - Perl compiler backend to produce perl code
11179 =over 4
11181 =item SYNOPSIS
11183 =item DESCRIPTION
11185 =item OPTIONS
11187 B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>,
11188 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
11190 =item USING B::Deparse AS A MODULE
11192 =over 4
11194 =item Synopsis
11196 =item Description
11198 =item new
11200 =item ambient_pragmas
11202 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
11204 =item coderef2text
11206 =back
11208 =item BUGS
11210 =item AUTHOR
11212 =back
11214 =head2 B::Disassembler - Disassemble Perl bytecode
11216 =over 4
11218 =item SYNOPSIS
11220 =item DESCRIPTION
11222 =item AUTHOR
11224 =back
11226 =head2 B::Lint - Perl lint
11228 =over 4
11230 =item SYNOPSIS
11232 =item DESCRIPTION
11234 =item OPTIONS AND LINT CHECKS
11236 B<context>, B<implicit-read> and B<implicit-write>, B<bare-subs>,
11237 B<dollar-underscore>, B<private-names>, B<undefined-subs>,
11238 B<regexp-variables>, B<all>, B<none>
11240 =item NON LINT-CHECK OPTIONS
11242 B<-u Package>
11244 =item BUGS
11246 =item AUTHOR
11248 =back
11250 =head2 B::O, O - Generic interface to Perl Compiler backends
11252 =over 4
11254 =item SYNOPSIS
11256 =item DESCRIPTION
11258 =item CONVENTIONS
11260 =item IMPLEMENTATION
11262 =item BUGS
11264 =item AUTHOR
11266 =back
11268 =head2 B::Showlex - Show lexical variables used in functions or files
11270 =over 4
11272 =item SYNOPSIS
11274 =item DESCRIPTION
11276 =item EXAMPLES
11278 =over 4
11280 =item OPTIONS
11282 =back
11284 =item SEE ALSO
11286 =item TODO
11288 =item AUTHOR
11290 =back
11292 =head2 B::Stackobj - Helper module for CC backend
11294 =over 4
11296 =item SYNOPSIS
11298 =item DESCRIPTION
11300 =item AUTHOR
11302 =back
11304 =head2 B::Stash - show what stashes are loaded
11306 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
11308 =over 4
11310 =item SYNOPSIS
11312 =item DESCRIPTION
11314 =item AUTHOR
11316 =back
11318 =head2 B::Xref - Generates cross reference reports for Perl programs
11320 =over 4
11322 =item SYNOPSIS
11324 =item DESCRIPTION
11326 =item OPTIONS
11328 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
11330 =item BUGS
11332 =item AUTHOR
11334 =back
11336 =head2 Bblock, B::Bblock - Walk basic blocks
11338 =over 4
11340 =item SYNOPSIS
11342 =item DESCRIPTION
11344 =over 4
11346 =item Functions
11348 B<find_leaders>
11350 =back
11352 =item AUTHOR
11354 =back
11356 =head2 Benchmark - benchmark running times of Perl code
11358 =over 4
11360 =item SYNOPSIS
11362 =item DESCRIPTION
11364 =over 4
11366 =item Methods
11368 new, debug, iters
11370 =item Standard Exports
11372 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
11373 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
11374 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
11376 =item Optional Exports
11378 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [
11379 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
11380 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
11382 =item :hireswallclock
11384 =back
11386 =item NOTES
11388 =item EXAMPLES
11390 =item INHERITANCE
11392 =item CAVEATS
11394 =item SEE ALSO
11396 =item AUTHORS
11398 =item MODIFICATION HISTORY
11400 =back
11402 =head2 ByteLoader - load byte compiled perl code
11404 =over 4
11406 =item SYNOPSIS
11408 =item DESCRIPTION
11410 =item AUTHOR
11412 =item SEE ALSO
11414 =back
11416 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
11418 =over 4
11420 =item SYNOPSIS
11422 =item DESCRIPTION
11424 =item EXAMPLE
11426 =item OPTIONS
11428 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
11430 =item KNOWN BUGS
11432 =item NOTICE
11434 =item AUTHORS
11436 =back
11438 =head2 CGI - Simple Common Gateway Interface Class
11440 =over 4
11442 =item SYNOPSIS
11444 =item ABSTRACT
11446 =item DESCRIPTION
11448 =over 4
11450 =item PROGRAMMING STYLE
11452 =item CALLING CGI.PM ROUTINES
11454 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
11456 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
11458 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
11460 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
11462 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
11464 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
11466 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
11468 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
11470 =item DELETING A PARAMETER COMPLETELY:
11472 =item DELETING ALL PARAMETERS:
11474 =item HANDLING NON-URLENCODED ARGUMENTS
11476 =item DIRECT ACCESS TO THE PARAMETER LIST:
11478 =item FETCHING THE PARAMETER LIST AS A HASH:
11480 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
11482 =item RETRIEVING CGI ERRORS
11484 =item USING THE FUNCTION-ORIENTED INTERFACE
11486 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
11487 B<:standard>, B<:all>
11489 =item PRAGMAS
11491 -any, -compile, -nosticky, -tabindex, -no_undef_params, -no_xhtml, -nph,
11492 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
11493 -private_tempfiles
11495 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
11497 1. start_table() (generates a <table> tag), 2. end_table() (generates a
11498 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
11499 a </ul> tag)
11501 =back
11503 =item GENERATING DYNAMIC DOCUMENTS
11505 =over 4
11507 =item CREATING A STANDARD HTTP HEADER:
11509 =item GENERATING A REDIRECTION HEADER
11511 =item CREATING THE HTML DOCUMENT HEADER
11513 B<Parameters:>, 4, 5, 6..
11515 =item ENDING THE HTML DOCUMENT:
11517 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
11519 =item OBTAINING THE SCRIPT'S URL
11521 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
11522 (B<-query_string>), B<-base>, B<-rewrite>
11524 =item MIXING POST AND URL PARAMETERS
11526 =back
11528 =item CREATING STANDARD HTML ELEMENTS:
11530 =over 4
11532 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
11534 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
11536 =item HTML SHORTCUTS AND LIST INTERPOLATION
11538 =item NON-STANDARD HTML SHORTCUTS
11540 =item AUTOESCAPING HTML
11542 $escaped_string = escapeHTML("unescaped string");, $charset =
11543 charset([$charset]);, $flag = autoEscape([$flag]);
11545 =item PRETTY-PRINTING HTML
11547 =back
11549 =item CREATING FILL-OUT FORMS:
11551 =over 4
11553 =item CREATING AN ISINDEX TAG
11555 =item STARTING AND ENDING A FORM
11557 B<application/x-www-form-urlencoded>, B<multipart/form-data>
11559 =item FORM ELEMENTS
11561 B<-name>, B<-value>, B<-values>, B<-tabindex>, B<-id>, B<-override>,
11562 B<-onChange>, B<-onFocus>, B<-onBlur>, B<-onMouseOver>, B<-onMouseOut>,
11563 B<-onSelect>
11565 =item CREATING A TEXT FIELD
11567 B<Parameters>
11569 =item CREATING A BIG TEXT FIELD
11571 =item CREATING A PASSWORD FIELD
11573 =item CREATING A FILE UPLOAD FIELD
11575 B<Parameters>
11577 =item CREATING A POPUP MENU
11579 =item CREATING AN OPTION GROUP
11581 =item CREATING A SCROLLING LIST
11583 B<Parameters:>
11585 =item CREATING A GROUP OF RELATED CHECKBOXES
11587 B<Parameters:>
11589 =item CREATING A STANDALONE CHECKBOX
11591 B<Parameters:>
11593 =item CREATING A RADIO BUTTON GROUP
11595 B<Parameters:>
11597 =item CREATING A SUBMIT BUTTON 
11599 B<Parameters:>
11601 =item CREATING A RESET BUTTON
11603 =item CREATING A DEFAULT BUTTON
11605 =item CREATING A HIDDEN FIELD
11607 B<Parameters:>
11609 =item CREATING A CLICKABLE IMAGE BUTTON
11611 B<Parameters:>, 3. The third option (-align, optional) is an alignment
11612 type, and may be TOP, BOTTOM or MIDDLE
11614 =item CREATING A JAVASCRIPT ACTION BUTTON
11616 =back
11618 =item HTTP COOKIES
11620 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
11621 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
11623 =item WORKING WITH FRAMES
11625 1. Create a <Frameset> document, 2. Specify the destination for the
11626 document in the HTTP header, 3. Specify the destination for the document in
11627 the <form> tag
11629 =item SUPPORT FOR JAVASCRIPT
11631 B<onLoad>, B<onUnload>, B<onSubmit>, B<onClick>, B<onChange>, B<onFocus>,
11632 B<onBlur>, B<onSelect>, B<onMouseOver>, B<onMouseOut>
11634 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
11636 =item DEBUGGING
11638 =over 4
11640 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
11642 =back
11644 =item FETCHING ENVIRONMENT VARIABLES
11646 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
11647 B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
11648 name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
11649 ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
11650 B<virtual_port ()>, B<server_software ()>, B<remote_user ()>, B<user_name
11651 ()>, B<request_method()>, B<content_type()>, B<http()>, B<https()>
11653 =item USING NPH SCRIPTS
11655 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
11656 parameters
11658 =item Server Push
11660 multipart_init(), multipart_start(), multipart_end(), multipart_final()
11662 =item Avoiding Denial of Service Attacks
11664 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
11665 basis>, B<2. Globally for all scripts>
11667 =item COMPATIBILITY WITH CGI-LIB.PL
11669 =item AUTHOR INFORMATION
11671 =item CREDITS
11673 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
11674 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
11675 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
11676 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
11677 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
11678 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
11679 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
11680 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
11681 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
11682 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
11683 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
11684 ...and many many more..
11686 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
11688 =item BUGS
11690 =item SEE ALSO
11692 =back
11694 =head2 CGI::Apache - Backward compatibility module for CGI.pm
11696 =over 4
11698 =item SYNOPSIS
11700 =item ABSTRACT
11702 =item DESCRIPTION
11704 =item AUTHOR INFORMATION
11706 =item BUGS
11708 =item SEE ALSO
11710 =back
11712 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
11713 other) error log
11715 =over 4
11717 =item SYNOPSIS
11719 =item DESCRIPTION
11721 =item REDIRECTING ERROR MESSAGES
11723 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
11725 =over 4
11727 =item Changing the default message
11729 =back
11731 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
11733 =item OVERRIDING THE NAME OF THE PROGRAM
11735 =item AUTHORS
11737 =item SEE ALSO
11739 =back
11741 =head2 CGI::Cookie - Interface to Netscape Cookies
11743 =over 4
11745 =item SYNOPSIS
11747 =item DESCRIPTION
11749 =item USING CGI::Cookie
11751 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
11753 =over 4
11755 =item Creating New Cookies
11757 =item Sending the Cookie to the Browser
11759 =item Recovering Previous Cookies
11761 =item Manipulating Cookies
11763 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
11765 =back
11767 =item AUTHOR INFORMATION
11769 =item BUGS
11771 =item SEE ALSO
11773 =back
11775 =head2 CGI::Fast - CGI Interface for Fast CGI
11777 =over 4
11779 =item SYNOPSIS
11781 =item DESCRIPTION
11783 =item OTHER PIECES OF THE PUZZLE
11785 =item WRITING FASTCGI PERL SCRIPTS
11787 =item INSTALLING FASTCGI SCRIPTS
11789 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
11791 =item EXTERNAL FASTCGI SERVER INVOCATION
11793 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
11795 =item CAVEATS
11797 =item AUTHOR INFORMATION
11799 =item BUGS
11801 =item SEE ALSO
11803 =back
11805 =head2 CGI::Pretty - module to produce nicely formatted HTML code
11807 =over 4
11809 =item SYNOPSIS
11811 =item DESCRIPTION
11813 =over 4
11815 =item Tags that won't be formatted
11817 =item Customizing the Indenting
11819 =back
11821 =item BUGS
11823 =item AUTHOR
11825 =item SEE ALSO
11827 =back
11829 =head2 CGI::Push - Simple Interface to Server Push
11831 =over 4
11833 =item SYNOPSIS
11835 =item DESCRIPTION
11837 =item USING CGI::Push
11839 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
11841 =over 4
11843 =item Heterogeneous Pages
11845 =item Changing the Page Delay on the Fly
11847 =back
11849 =item INSTALLING CGI::Push SCRIPTS
11851 =item AUTHOR INFORMATION
11853 =item BUGS
11855 =item SEE ALSO
11857 =back
11859 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
11861 =over 4
11863 =item SYNOPSIS
11865 =item ABSTRACT
11867 =item DESCRIPTION
11869 =item AUTHOR INFORMATION
11871 =item BUGS
11873 =item SEE ALSO
11875 =back
11877 =head2 CGI::Util - Internal utilities used by CGI module
11879 =over 4
11881 =item SYNOPSIS
11883 =item DESCRIPTION
11885 =item AUTHOR INFORMATION
11887 =item SEE ALSO
11889 =back
11891 =head2 CPAN - query, download and build perl modules from CPAN sites
11893 =over 4
11895 =item SYNOPSIS
11897 =item STATUS
11899 =item DESCRIPTION
11901 =over 4
11903 =item Interactive Mode
11905 Searching for authors, bundles, distribution files and modules, make, test,
11906 install, clean  modules or distributions, get, readme, perldoc, look module
11907 or distribution, ls author, ls globbing_expresion, Signals
11909 =item CPAN::Shell
11911 =item autobundle
11913 =item recompile
11915 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
11917 =item Programmer's interface
11919 expand($type,@things), expandany(@things), Programming Examples
11921 =item Methods in the other Classes
11923 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
11924 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
11925 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
11926 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
11927 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
11928 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
11929 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
11930 CPAN::Bundle::readme(), CPAN::Bundle::test(),
11931 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
11932 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
11933 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
11934 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
11935 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
11936 CPAN::Distribution::look(), CPAN::Distribution::make(),
11937 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
11938 CPAN::Distribution::perldoc(), CPAN::Distribution::test(),
11939 CPAN::Distribution::uptodate(), CPAN::Index::force_reload(),
11940 CPAN::Index::reload(), CPAN::InfoObj::dump(), CPAN::Module::as_glimpse(),
11941 CPAN::Module::as_string(), CPAN::Module::clean(),
11942 CPAN::Module::cpan_file(), CPAN::Module::cpan_version(),
11943 CPAN::Module::cvs_import(), CPAN::Module::description(),
11944 CPAN::Module::force($method,@args), CPAN::Module::get(),
11945 CPAN::Module::inst_file(), CPAN::Module::inst_version(),
11946 CPAN::Module::install(), CPAN::Module::look(), CPAN::Module::make(),
11947 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
11948 CPAN::Module::perldoc(), CPAN::Module::test(), CPAN::Module::uptodate(),
11949 CPAN::Module::userid()
11951 =item Cache Manager
11953 =item Bundles
11955 =item Prerequisites
11957 =item Finding packages and VERSION
11959 =item Debugging
11961 =item Floppy, Zip, Offline Mode
11963 =back
11965 =item CONFIGURATION
11967 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
11968 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
11969 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
11970 [unshift|push|splice] E<lt>listE<gt>>
11972 =over 4
11974 =item Note on urllist parameter's format
11976 =item urllist parameter has CD-ROM support
11978 =back
11980 =item SECURITY
11982 =over 4
11984 =item Cryptographically signed modules
11986 =back
11988 =item EXPORT
11990 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
11992 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
11994 =over 4
11996 =item Three basic types of firewalls
11998 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
12000 =item Configuring lynx or ncftp for going through a firewall
12002 =back
12004 =item FAQ
12006 1), 2), 3), 4), 5), 6), 7), 8), 9), 10), 11)
12008 =item BUGS
12010 =item AUTHOR
12012 =item TRANSLATIONS
12014 =item SEE ALSO
12016 =back
12018 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
12020 =over 4
12022 =item SYNOPSIS
12024 =item DESCRIPTION
12026 =back
12028 =head2 CPAN::Version - utility functions to compare CPAN versions
12030 =over 4
12032 =item SYNOPSIS
12034 =item DESCRIPTION
12036 =back
12038 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
12039 module
12041 =over 4
12043 =item SYNOPSIS
12045 =item DESCRIPTION
12047 =item  SEE ALSO
12049 =back
12051 =head2 Carp, carp    - warn of errors (from perspective of caller)
12053 =over 4
12055 =item SYNOPSIS
12057 =item DESCRIPTION
12059 =over 4
12061 =item Forcing a Stack Trace
12063 =back
12065 =back
12067 =over 4
12069 =item GLOBAL VARIABLES
12071 =over 4
12073 =item $Carp::CarpLevel
12075 =item $Carp::MaxEvalLen
12077 =item $Carp::MaxArgLen
12079 =item $Carp::MaxArgNums
12081 =item $Carp::Verbose
12083 =back
12085 =back
12087 =over 4
12089 =item BUGS
12091 =back
12093 =head2 Carp::Heavy - heavy machinery, no user serviceable parts inside
12095 =head2 Class::ISA -- report the search path for a class's ISA tree
12097 =over 4
12099 =item SYNOPSIS
12101 =item DESCRIPTION
12103 =item FUNCTIONS
12105 the function Class::ISA::super_path($CLASS), the function
12106 Class::ISA::self_and_super_path($CLASS), the function
12107 Class::ISA::self_and_super_versions($CLASS)
12109 =item CAUTIONARY NOTES
12111 =item COPYRIGHT
12113 =item AUTHOR
12115 =back
12117 =head2 Class::Struct - declare struct-like datatypes as Perl classes
12119 =over 4
12121 =item SYNOPSIS
12123 =item DESCRIPTION
12125 =over 4
12127 =item The C<struct()> function
12129 =item Class Creation at Compile Time
12131 =item Element Types and Accessor Methods
12133 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
12134 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
12136 =item Initializing with C<new>
12138 =back
12140 =item EXAMPLES
12142 Example 1, Example 2, Example 3
12144 =item Author and Modification History
12146 =back
12148 =head2 Config - access Perl configuration information
12150 =over 4
12152 =item SYNOPSIS
12154 =item DESCRIPTION
12156 myconfig(), config_sh(), config_re($regex), config_vars(@names)
12158 =item EXAMPLE
12160 =item WARNING
12162 =item GLOSSARY
12164 =over 4
12166 =item _
12168 C<_a>, C<_exe>, C<_o>
12170 =item a
12172 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
12173 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
12174 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
12175 C<asctime_r_proto>, C<awk>
12177 =item b
12179 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
12181 =item c
12183 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
12184 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
12185 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
12186 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
12187 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
12188 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
12189 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
12191 =item d
12193 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>,
12194 C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>,
12195 C<d_attribute_format>, C<d_attribute_malloc>, C<d_attribute_nonnull>,
12196 C<d_attribute_noreturn>, C<d_attribute_pure>, C<d_attribute_unused>,
12197 C<d_attribute_warn_unused_result>, C<d_bcmp>, C<d_bcopy>, C<d_bsd>,
12198 C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>, C<d_casti32>, C<d_castneg>,
12199 C<d_charvspr>, C<d_chown>, C<d_chroot>, C<d_chsize>, C<d_class>,
12200 C<d_clearenv>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>, C<d_copysignl>,
12201 C<d_crypt>, C<d_crypt_r>, C<d_csh>, C<d_ctermid_r>, C<d_ctime_r>,
12202 C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>,
12203 C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>,
12204 C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>,
12205 C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>, C<d_endnent>,
12206 C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>, C<d_endpwent>,
12207 C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>, C<d_eofnblk>,
12208 C<d_eunice>, C<d_faststdio>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>,
12209 C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>,
12210 C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>,
12211 C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>,
12212 C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>,
12213 C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>,
12214 C<d_fsync>, C<d_ftello>, C<d_ftime>, C<d_futimes>, C<d_Gconvert>,
12215 C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>,
12216 C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>,
12217 C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
12218 C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>,
12219 C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>,
12220 C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>,
12221 C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>,
12222 C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
12223 C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
12224 C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>,
12225 C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
12226 C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>,
12227 C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>,
12228 C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>,
12229 C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
12230 C<d_htonl>, C<d_ilogbl>, C<d_index>, C<d_inetaton>, C<d_int64_t>,
12231 C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>,
12232 C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>,
12233 C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>,
12234 C<d_lstat>, C<d_madvise>, C<d_malloc_size>, C<d_malloc_good_size>,
12235 C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>,
12236 C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>,
12237 C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>,
12238 C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>, C<d_mprotect>, C<d_msg>,
12239 C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>,
12240 C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>,
12241 C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nanosleep>,
12242 C<d_nice>, C<d_nl_langinfo>, C<d_nv_preserves_uv>,
12243 C<d_nv_zero_is_allbits_zero>, C<d_off64_t>,
12244 C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
12245 C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
12246 C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
12247 C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
12248 C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>,
12249 C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, C<d_pthread_atfork>,
12250 C<d_pthread_attr_setscope>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
12251 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
12252 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
12253 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
12254 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
12255 C<d_sanemcmp>, C<d_sbrkproto>, C<d_scalbnl>, C<d_sched_yield>,
12256 C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>,
12257 C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>,
12258 C<d_semop>, C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>,
12259 C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>,
12260 C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>,
12261 C<d_setnent>, C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>,
12262 C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>,
12263 C<d_setpwent>, C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>,
12264 C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>,
12265 C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>,
12266 C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>,
12267 C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>,
12268 C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>,
12269 C<d_socks5_init>, C<d_sprintf_returns_strlen>, C<d_sqrtl>, C<d_srand48_r>,
12270 C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>,
12271 C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>,
12272 C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>,
12273 C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>,
12274 C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>,
12275 C<d_strerror>, C<d_strerror_r>, C<d_strftime>, C<d_strlcat>, C<d_strlcpy>,
12276 C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>, C<d_strtoq>,
12277 C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>,
12278 C<d_symlink>, C<d_syscall>, C<d_syscallproto>, C<d_sysconf>,
12279 C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>,
12280 C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>,
12281 C<d_tm_tm_gmtoff>, C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>,
12282 C<d_ttyname_r>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>,
12283 C<d_uname>, C<d_union_semun>, C<d_unordered>, C<d_unsetenv>, C<d_usleep>,
12284 C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>,
12285 C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>, C<d_void_closedir>,
12286 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
12287 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
12288 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
12289 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
12290 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
12292 =item e
12294 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
12295 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
12296 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
12297 C<expr>, C<extensions>, C<extras>
12299 =item f
12301 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
12302 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
12303 C<full_sed>
12305 =item g
12307 C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>,
12308 C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>,
12309 C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>,
12310 C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>,
12311 C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>,
12312 C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>,
12313 C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>,
12314 C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>,
12315 C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>,
12316 C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
12318 =item h
12320 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>,
12321 C<html3dir>, C<html3direxp>
12323 =item i
12325 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
12326 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
12327 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
12328 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
12329 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
12330 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
12331 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
12332 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
12333 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
12334 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
12335 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
12336 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
12337 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
12338 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
12339 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
12340 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
12341 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
12342 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
12343 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installhtml1dir>,
12344 C<installhtml3dir>, C<installman1dir>, C<installman3dir>, C<installprefix>,
12345 C<installprefixexp>, C<installprivlib>, C<installscript>,
12346 C<installsitearch>, C<installsitebin>, C<installsitehtml1dir>,
12347 C<installsitehtml3dir>, C<installsitelib>, C<installsiteman1dir>,
12348 C<installsiteman3dir>, C<installsitescript>, C<installstyle>,
12349 C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>,
12350 C<installvendorhtml1dir>, C<installvendorhtml3dir>, C<installvendorlib>,
12351 C<installvendorman1dir>, C<installvendorman3dir>, C<installvendorscript>,
12352 C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
12354 =item k
12356 C<known_extensions>, C<ksh>
12358 =item l
12360 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
12361 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
12362 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
12363 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
12364 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
12365 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
12366 C<lseektype>
12368 =item m
12370 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
12371 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
12372 C<man3direxp>, C<man3ext>
12374 =item M
12376 C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>,
12377 C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>,
12378 C<myuname>
12380 =item n
12382 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
12383 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
12384 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
12385 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
12386 C<nvsize>, C<nvtype>
12388 =item o
12390 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
12391 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
12393 =item p
12395 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
12396 C<perl>, C<perl_patchlevel>
12398 =item P
12400 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
12401 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
12402 C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>,
12403 C<procselfexe>, C<prototype>, C<ptrsize>
12405 =item q
12407 C<quadkind>, C<quadtype>
12409 =item r
12411 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
12412 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
12413 C<rmail>, C<run>, C<runnm>
12415 =item s
12417 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
12418 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
12419 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
12420 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
12421 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
12422 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
12423 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
12424 C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>,
12425 C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>,
12426 C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>,
12427 C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>,
12428 C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>,
12429 C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>,
12430 C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>,
12431 C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>,
12432 C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>,
12433 C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>,
12434 C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>,
12435 C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>,
12436 C<submit>, C<subversion>, C<sysman>
12438 =item t
12440 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
12441 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
12442 C<ttyname_r_proto>
12444 =item u
12446 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
12447 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
12448 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
12449 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>,
12450 C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemallocwrap>,
12451 C<usemorebits>, C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>,
12452 C<useperlio>, C<useposix>, C<usereentrant>, C<usesfio>, C<useshrplib>,
12453 C<usesocks>, C<usethreads>, C<usevendorprefix>, C<usevfork>, C<usrinc>,
12454 C<uuname>, C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>,
12455 C<uvXUformat>
12457 =item v
12459 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
12460 C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>,
12461 C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>,
12462 C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>,
12463 C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>,
12464 C<vendorscriptexp>, C<version>, C<version_patchlevel_string>,
12465 C<versiononly>, C<vi>, C<voidflags>
12467 =item x
12469 C<xlibpth>
12471 =item y
12473 C<yacc>, C<yaccflags>
12475 =item z
12477 C<zcat>, C<zip>
12479 =back
12481 =item NOTE
12483 =back
12485 =head2 Cwd - get pathname of current working directory
12487 =over 4
12489 =item SYNOPSIS
12491 =item DESCRIPTION
12493 =over 4
12495 =item getcwd and friends
12497 getcwd, cwd, fastcwd, fastgetcwd, getdcwd
12499 =item abs_path and friends
12501 abs_path, realpath, fast_abs_path
12503 =item $ENV{PWD}
12505 =back
12507 =item NOTES
12509 =item AUTHOR
12511 =item COPYRIGHT
12513 =item SEE ALSO
12515 =back
12517 =head2 DB - programmatic interface to the Perl debugging API (draft,
12518 subject to
12519 change)
12521 =over 4
12523 =item SYNOPSIS
12525 =item DESCRIPTION
12527 =over 4
12529 =item Global Variables
12531  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args, 
12532 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname, 
12533 $DB::lineno
12535 =item API Methods
12537 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
12538 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
12540 =item Client Callback Methods
12542 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
12543 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
12544 CLIENT->output(LIST)
12546 =back
12548 =item BUGS
12550 =item AUTHOR
12552 =back
12554 =head2 DBM_Filter -- Filter DBM keys/values 
12556 =over 4
12558 =item SYNOPSIS
12560 =item DESCRIPTION
12562 =item What is a DBM Filter?
12564 =over 4
12566 =item So what's new?
12568 =back
12570 =item METHODS
12572 =over 4
12574 =item $db->Filter_Push()
12576 =item $db->Filter_Key_Push()
12578 =item $db->Filter_Value_Push()
12580 Filter_Push, Filter_Key_Push, Filter_Value_Push
12582 =item $db->Filter_Pop()
12584 =item $db->Filtered()
12586 =back
12588 =item Writing a Filter
12590 =over 4
12592 =item Immediate Filters
12594 =item Canned Filters
12596 "name", params
12598 =back
12600 =item Filters Included
12602 utf8, encode, compress, int32, null
12604 =item NOTES
12606 =over 4
12608 =item Maintain Round Trip Integrity
12610 =item Don't mix filtered & non-filtered data in the same database file. 
12612 =back
12614 =item EXAMPLE
12616 =item SEE ALSO
12618 =item AUTHOR
12620 =back
12622 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
12624 =over 4
12626 =item SYNOPSIS
12628 =item DESCRIPTION
12630 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
12632 =over 4
12634 =item Using DB_File with Berkeley DB version 2 or greater
12636 =item Interface to Berkeley DB
12638 =item Opening a Berkeley DB Database File
12640 =item Default Parameters
12642 =item In Memory Databases
12644 =back
12646 =item DB_HASH
12648 =over 4
12650 =item A Simple Example
12652 =back
12654 =item DB_BTREE
12656 =over 4
12658 =item Changing the BTREE sort order
12660 =item Handling Duplicate Keys 
12662 =item The get_dup() Method
12664 =item The find_dup() Method
12666 =item The del_dup() Method
12668 =item Matching Partial Keys 
12670 =back
12672 =item DB_RECNO
12674 =over 4
12676 =item The 'bval' Option
12678 =item A Simple Example
12680 =item Extra RECNO Methods
12682 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
12683 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
12684 length, elements);>
12686 =item Another Example
12688 =back
12690 =item THE API INTERFACE
12692 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
12693 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
12694 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
12695 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
12697 =item DBM FILTERS
12699 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
12700 B<filter_fetch_value>
12702 =over 4
12704 =item The Filter
12706 =item An Example -- the NULL termination problem.
12708 =item Another Example -- Key is a C int.
12710 =back
12712 =item HINTS AND TIPS 
12714 =over 4
12716 =item Locking: The Trouble with fd
12718 =item Safe ways to lock a database
12720 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
12722 =item Sharing Databases With C Applications
12724 =item The untie() Gotcha
12726 =back
12728 =item COMMON QUESTIONS
12730 =over 4
12732 =item Why is there Perl source in my database?
12734 =item How do I store complex data structures with DB_File?
12736 =item What does "Invalid Argument" mean?
12738 =item What does "Bareword 'DB_File' not allowed" mean? 
12740 =back
12742 =item REFERENCES
12744 =item HISTORY
12746 =item BUGS
12748 =item AVAILABILITY
12750 =item COPYRIGHT
12752 =item SEE ALSO
12754 =item AUTHOR
12756 =back
12758 =head2 Data::Dumper - stringified perl data structures, suitable for both
12759 printing and C<eval>
12761 =over 4
12763 =item SYNOPSIS
12765 =item DESCRIPTION
12767 =over 4
12769 =item Methods
12771 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or> 
12772 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
12773 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
12774 I<$OBJ>->Reset
12776 =item Functions
12778 Dumper(I<LIST>)
12780 =item Configuration Variables or Methods
12782 =item Exports
12784 Dumper
12786 =back
12788 =item EXAMPLES
12790 =item BUGS
12792 =over 4
12794 =item NOTE
12796 =back
12798 =item AUTHOR
12800 =item VERSION
12802 =item SEE ALSO
12804 =back
12806 =head2 Devel::DProf - a Perl code profiler
12808 =over 4
12810 =item SYNOPSIS
12812 =item DESCRIPTION
12814 =item PROFILE FORMAT
12816 =item AUTOLOAD
12818 =item ENVIRONMENT
12820 =item BUGS
12822 =item SEE ALSO
12824 =back
12826 =head2 Devel::PPPort - Perl/Pollution/Portability
12828 =over 4
12830 =item SYNOPSIS
12832 =item DESCRIPTION
12834 =over 4
12836 =item Why use ppport.h?
12838 You should use F<ppport.h> in modern code so that your code will work
12839 with the widest range of Perl interpreters possible, without significant
12840 additional work.
12842 =item How to use ppport.h
12844 =item Running ppport.h
12846 =back
12848 =item FUNCTIONS
12850 =over 4
12852 =item WriteFile
12854 =back
12856 =item COMPATIBILITY
12858 =over 4
12860 =item Provided Perl compatibility API
12862 =item Perl API not supported by ppport.h
12864 perl 5.9.2, perl 5.9.1, perl 5.9.0, perl 5.8.3, perl 5.8.1, perl 5.8.0,
12865 perl 5.7.3, perl 5.7.2, perl 5.7.1, perl 5.6.1, perl 5.6.0, perl 5.005_03,
12866 perl 5.005, perl 5.004_05, perl 5.004_04, perl 5.004
12868 =back
12870 =item BUGS
12872 =item AUTHORS
12874 =item COPYRIGHT
12876 =item SEE ALSO
12878 =back
12880 =head2 Devel::Peek - A data debugging tool for the XS programmer
12882 =over 4
12884 =item SYNOPSIS
12886 =item DESCRIPTION
12888 =over 4
12890 =item Runtime debugging
12892 =item Memory footprint debugging
12894 =back
12896 =item EXAMPLES
12898 =over 4
12900 =item A simple scalar string
12902 =item A simple scalar number
12904 =item A simple scalar with an extra reference
12906 =item A reference to a simple scalar
12908 =item A reference to an array
12910 =item A reference to a hash
12912 =item Dumping a large array or hash
12914 =item A reference to an SV which holds a C pointer
12916 =item A reference to a subroutine
12918 =back
12920 =item EXPORTS
12922 =item BUGS
12924 =item AUTHOR
12926 =item SEE ALSO
12928 =back
12930 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
12932 =over 4
12934 =item SYNOPSIS
12936 =item DESCRIPTION
12938 =back
12940 =head2 Devel::Size - Perl extension for finding the memory usage of Perl
12941 variables
12943 =over 4
12945 =item SYNOPSIS
12947 =item DESCRIPTION
12949 =item FUNCTIONS
12951 =over 4
12953 =item size($ref)
12955 =item total_size($ref)
12957 =back
12959 =item EXPORT
12961 =item UNDERSTANDING MEMORY ALLOCATION
12963 =over 4
12965 =item The C library
12967 =item Perl
12969 =back
12971 =item DANGERS
12973 =item Messages: texts originating from this module.
12975 =over 4
12977 =item Errors
12979 =item warnings
12981 =back
12983 =item BUGS
12985 =item AUTHOR
12987 =item COPYRIGHT
12989 =item SEE ALSO
12991 =back
12993 =head2 Digest - Modules that calculate message digests
12995 =over 4
12997 =item SYNOPSIS
12999 =item DESCRIPTION
13001 I<binary>, I<hex>, I<base64>
13003 =item OO INTERFACE
13005 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
13006 Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset,
13007 $ctx->add( $data, ... ), $ctx->addfile( $io_handle ), $ctx->add_bits(
13008 $data, $nbits ), $ctx->add_bits( $bitstring ), $ctx->digest,
13009 $ctx->hexdigest, $ctx->b64digest
13011 =item Digest speed
13013 =item SEE ALSO
13015 =item AUTHOR
13017 =back
13019 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
13021 =over 4
13023 =item SYNOPSIS
13025 =item DESCRIPTION
13027 =item FUNCTIONS
13029 md5($data,...), md5_hex($data,...), md5_base64($data,...)
13031 =item METHODS
13033 $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...),
13034 $md5->addfile($io_handle), $md5->add_bits($data, $nbits),
13035 $md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest
13037 =item EXAMPLES
13039 =item SEE ALSO
13041 =item COPYRIGHT
13043 =item AUTHORS
13045 =back
13047 =head2 Digest::base - Digest base class
13049 =over 4
13051 =item SYNOPSIS
13053 =item DESCRIPTION
13055 =item SEE ALSO
13057 =back
13059 =head2 Digest::file - Calculate digests of files
13061 =over 4
13063 =item SYNOPSIS
13065 =item DESCRIPTION
13067 digest_file( $file, $algorithm, [$arg,...] ), digest_file_hex( $file,
13068 $algorithm, [$arg,...] ), digest_file_base64( $file, $algorithm, [$arg,...]
13071 =item SEE ALSO
13073 =back
13075 =head2 DirHandle - supply object methods for directory handles
13077 =over 4
13079 =item SYNOPSIS
13081 =item DESCRIPTION
13083 =item NOTES
13085 =back
13087 =head2 Dumpvalue - provides screen dump of Perl data.
13089 =over 4
13091 =item SYNOPSIS
13093 =item DESCRIPTION
13095 =over 4
13097 =item Creation
13099 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
13100 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
13101 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
13102 stopDbSignal
13104 =item Methods
13106 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
13107 compactDump, veryCompact, set, get
13109 =back
13111 =back
13113 =head2 DynaLoader - Dynamically load C libraries into Perl code
13115 =over 4
13117 =item SYNOPSIS
13119 =item DESCRIPTION
13121 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
13122 @dl_modules, @dl_shared_objects, dl_error(), $dl_debug, dl_findfile(),
13123 dl_expandspec(), dl_load_file(), dl_unload_file(), dl_load_flags(),
13124 dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(),
13125 dl_install_xsub(), bootstrap()
13127 =item AUTHOR
13129 =back
13131 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
13132 Perl code
13134 =over 4
13136 =item VERSION
13138 =item SYNOPSIS
13140 =item DESCRIPTION
13142 =over 4
13144 =item Migration from C<DynaLoader>
13146 =item Backward compatible boilerplate
13148 =back
13150 =item Order of initialization: early load()
13152 =over 4
13154 =item The most hairy case
13156 =back
13158 =item DIAGNOSTICS
13160 Can't find '%s' symbol in %s, Can't load '%s' for module %s: %s, Undefined
13161 symbols present after loading %s: %s, XSLoader::load('Your::Module',
13162 $Your::Module::VERSION)
13164 =item LIMITATIONS
13166 =item BUGS
13168 =item SEE ALSO
13170 =item AUTHORS
13172 =item COPYRIGHT
13174 =back
13176 =head2 Encode - character encodings
13178 =over 4
13180 =item SYNOPSIS
13182 =over 4
13184 =item Table of Contents
13186 =back
13188 =item DESCRIPTION
13190 =over 4
13192 =item TERMINOLOGY
13194 =back
13196 =item PERL ENCODING API
13198 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
13199 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
13200 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
13201 CHECK]);
13203 =over 4
13205 =item Listing available encodings
13207 =item Defining Aliases
13209 =back
13211 =item Encoding via PerlIO
13213 =item Handling Malformed Data
13215 B<NOTE:> Not all encoding support this feature, I<CHECK> =
13216 Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1), I<CHECK> =
13217 Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode (I<CHECK> =
13218 Encode::FB_PERLQQ), HTML charref mode (I<CHECK> = Encode::FB_HTMLCREF), XML
13219 charref mode (I<CHECK> = Encode::FB_XMLCREF), The bitmask
13221 =over 4
13223 =item coderef for CHECK
13225 =back
13227 =item Defining Encodings
13229 =item The UTF-8 flag
13231 Goal #1:, Goal #2:, Goal #3:, Goal #4:
13233 =over 4
13235 =item Messing with Perl's Internals
13237 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
13239 =back
13241 =item UTF-8 vs. utf8
13243 =item SEE ALSO
13245 =item MAINTAINER
13247 =back
13249 =head2 Encode::Alias - alias definitions to encodings
13251 =over 4
13253 =item SYNOPSIS
13255 =item DESCRIPTION
13257 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
13258 reference, e.g.:
13260 =over 4
13262 =item Alias overloading
13264 =back
13266 =item SEE ALSO
13268 =back
13270 =head2 Encode::Byte - Single Byte Encodings
13272 =over 4
13274 =item SYNOPSIS
13276 =item ABSTRACT
13278 =item DESCRIPTION
13280 =item SEE ALSO
13282 =back
13284 =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
13286 =head2 Encode::CN - China-based Chinese Encodings
13288 =over 4
13290 =item SYNOPSIS
13292 =item DESCRIPTION
13294 =item NOTES
13296 =item BUGS
13298 =item SEE ALSO
13300 =back
13302 =head2 Encode::CN::HZ -- internally used by Encode::CN
13304 =head2 Encode::Config -- internally used by Encode
13306 =head2 Encode::EBCDIC - EBCDIC Encodings
13308 =over 4
13310 =item SYNOPSIS
13312 =item ABSTRACT
13314 =item DESCRIPTION
13316 =item SEE ALSO
13318 =back
13320 =head2 Encode::Encoding - Encode Implementation Base Class
13322 =over 4
13324 =item SYNOPSIS
13326 =item DESCRIPTION
13328 =over 4
13330 =item Methods you should implement
13332 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
13333 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
13335 =item Other methods defined in Encode::Encodings
13337 -E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(),
13338 -E<gt>needs_lines()
13340 =item Example: Encode::ROT13
13342 =back
13344 =item Why the heck Encode API is different?
13346 =over 4
13348 =item Compiled Encodings
13350 =back
13352 =item SEE ALSO
13354 Scheme 1, Scheme 2, Other Schemes
13356 =back
13358 =head2 Encode::Guess -- Guesses encoding from data
13360 =over 4
13362 =item SYNOPSIS
13364 =item ABSTRACT
13366 =item DESCRIPTION
13368 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
13369 Encode::decode("Guess" ...), Encode::Guess->guess($data),
13370 guess_encoding($data, [, I<list of suspects>])
13372 =item CAVEATS
13374 =item TO DO
13376 =item SEE ALSO
13378 =back
13380 =head2 Encode::JP - Japanese Encodings
13382 =over 4
13384 =item SYNOPSIS
13386 =item ABSTRACT
13388 =item DESCRIPTION
13390 =item Note on ISO-2022-JP(-1)?
13392 =item BUGS
13394 =item SEE ALSO
13396 =back
13398 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
13400 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
13402 =head2 Encode::KR - Korean Encodings
13404 =over 4
13406 =item SYNOPSIS
13408 =item DESCRIPTION
13410 =item BUGS
13412 =item SEE ALSO
13414 =back
13416 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
13418 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
13420 =over 4
13422 =item SYNOPSIS
13424 =item ABSTRACT
13426 =item DESCRIPTION
13428 =item BUGS
13430 =item SEE ALSO
13432 =back
13434 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
13436 =over 4
13438 =item Overview
13440 =item How does it work?
13442 =item Line Buffering
13444 =over 4
13446 =item How can I tell whether my encoding fully supports PerlIO ?
13448 =back
13450 =item SEE ALSO
13452 =back
13454 =head2 Encode::Supported -- Encodings supported by Encode
13456 =over 4
13458 =item DESCRIPTION
13460 =over 4
13462 =item Encoding Names
13464 =back
13466 =item Supported Encodings
13468 =over 4
13470 =item Built-in Encodings
13472 =item Encode::Unicode -- other Unicode encodings
13474 =item Encode::Byte -- Extended ASCII
13476 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
13477 the Cyrillic world, gsm0338 - Hentai Latin 1
13479 =item CJK: Chinese, Japanese, Korean (Multibyte)
13481 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
13482 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
13483 Encode::JIS2K -- JIS X 0213 encodings via CPAN
13485 =item Miscellaneous encodings
13487 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
13489 =back
13491 =item Unsupported encodings
13493   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
13494 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
13495 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
13496 Various Mac encodings, (Mac) Indic encodings
13498 =item Encoding vs. Charset -- terminology
13500 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
13502 =over 4
13504 =item Microsoft-related naming mess
13506 KS_C_5601-1987, GB2312, Big5, Shift_JIS
13508 =back
13510 =item Glossary
13512 character repertoire, coded character set (CCS), character encoding scheme
13513 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
13514 UTF-16
13516 =item See Also
13518 =item References
13520 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
13521 RFC, UC, Unicode Glossary
13523 =over 4
13525 =item Other Notable Sites
13527 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
13528 "Introduction to i18n"
13530 =item Offline sources
13532 C<CJKV Information Processing> by Ken Lunde
13534 =back
13536 =back
13538 =head2 Encode::Symbol - Symbol Encodings
13540 =over 4
13542 =item SYNOPSIS
13544 =item ABSTRACT
13546 =item DESCRIPTION
13548 =item SEE ALSO
13550 =back
13552 =head2 Encode::TW - Taiwan-based Chinese Encodings
13554 =over 4
13556 =item SYNOPSIS
13558 =item DESCRIPTION
13560 =item NOTES
13562 =item BUGS
13564 =item SEE ALSO
13566 =back
13568 =head2 Encode::Unicode -- Various Unicode Transformation Formats
13570 =over 4
13572 =item SYNOPSIS
13574 =item ABSTRACT
13576 L<http://www.unicode.org/glossary/> says:, Quick Reference
13578 =item Size, Endianness, and BOM
13580 =over 4
13582 =item by size
13584 =item by endianness
13586 BOM as integer when fetched in network byte order
13588 =back
13590 =item Surrogate Pairs
13592 =item Error Checking
13594 =item SEE ALSO
13596 =back
13598 =head2 Encode::Unicode::UTF7 -- UTF-7 encoding
13600 =over 4
13602 =item SYNOPSIS
13604 =item ABSTRACT
13606 =item In Practice
13608 =item SEE ALSO
13610 =back
13612 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
13613 encodings
13615 =over 4
13617 =item SYNOPSIS
13619 =item DESCRIPTION
13621 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
13622 reference, e.g.:
13624 =over 4
13626 =item Alias overloading
13628 =back
13630 =item SEE ALSO
13632 =back
13634 =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm --
13635 Internally used by Encode::??::ISO_2022_*
13637 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
13638 Encode::CN
13640 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
13641 Encode
13643 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
13644 Implementation Base Class
13646 =over 4
13648 =item SYNOPSIS
13650 =item DESCRIPTION
13652 =over 4
13654 =item Methods you should implement
13656 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
13657 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
13659 =item Other methods defined in Encode::Encodings
13661 -E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(),
13662 -E<gt>needs_lines()
13664 =item Example: Encode::ROT13
13666 =back
13668 =item Why the heck Encode API is different?
13670 =over 4
13672 =item Compiled Encodings
13674 =back
13676 =item SEE ALSO
13678 Scheme 1, Scheme 2, Other Schemes
13680 =back
13682 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
13683 data
13685 =over 4
13687 =item SYNOPSIS
13689 =item ABSTRACT
13691 =item DESCRIPTION
13693 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
13694 Encode::decode("Guess" ...), Encode::Guess->guess($data),
13695 guess_encoding($data, [, I<list of suspects>])
13697 =item CAVEATS
13699 =item TO DO
13701 =item SEE ALSO
13703 =back
13705 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
13706 Encode::JP::2022_JP*
13708 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
13709 by Encode::JP
13711 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
13712 used by Encode::KR
13714 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
13715 and 'Q' header encoding
13717 =over 4
13719 =item SYNOPSIS
13721 =item ABSTRACT
13723 =item DESCRIPTION
13725 =item BUGS
13727 =item SEE ALSO
13729 =back
13731 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
13732 on Encode and PerlIO
13734 =over 4
13736 =item Overview
13738 =item How does it work?
13740 =item Line Buffering
13742 =over 4
13744 =item How can I tell whether my encoding fully supports PerlIO ?
13746 =back
13748 =item SEE ALSO
13750 =back
13752 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
13753 supported by Encode
13755 =over 4
13757 =item DESCRIPTION
13759 =over 4
13761 =item Encoding Names
13763 =back
13765 =item Supported Encodings
13767 =over 4
13769 =item Built-in Encodings
13771 =item Encode::Unicode -- other Unicode encodings
13773 =item Encode::Byte -- Extended ASCII
13775 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
13776 the Cyrillic world, gsm0338 - Hentai Latin 1
13778 =item CJK: Chinese, Japanese, Korean (Multibyte)
13780 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
13781 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
13782 Encode::JIS2K -- JIS X 0213 encodings via CPAN
13784 =item Miscellaneous encodings
13786 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
13788 =back
13790 =item Unsupported encodings
13792   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
13793 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
13794 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
13795 Various Mac encodings, (Mac) Indic encodings
13797 =item Encoding vs. Charset -- terminology
13799 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
13801 =over 4
13803 =item Microsoft-related naming mess
13805 KS_C_5601-1987, GB2312, Big5, Shift_JIS
13807 =back
13809 =item Glossary
13811 character repertoire, coded character set (CCS), character encoding scheme
13812 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
13813 UTF-16
13815 =item See Also
13817 =item References
13819 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
13820 RFC, UC, Unicode Glossary
13822 =over 4
13824 =item Other Notable Sites
13826 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
13827 "Introduction to i18n"
13829 =item Offline sources
13831 C<CJKV Information Processing> by Ken Lunde
13833 =back
13835 =back
13837 =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7
13838 encoding
13840 =over 4
13842 =item SYNOPSIS
13844 =item ABSTRACT
13846 =item In Practice
13848 =item SEE ALSO
13850 =back
13852 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
13854 =over 4
13856 =item SYNOPSIS
13858 =item ABSTRACT
13860 =item Description
13862 =over 4
13864 =item Predefined Methods
13866 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
13867 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
13868 $e-E<gt>bytes([$encoding])
13870 =item Example: base64 transcoder
13872 =item Operator Overloading
13874 =back
13876 =item SEE ALSO
13878 =back
13880 =head2 Encodencoding, encoding - allows you to write your script in
13881 non-ascii or non-utf8
13883 =over 4
13885 =item SYNOPSIS
13887 =item ABSTRACT
13889 =over 4
13891 =item Literal Conversions
13893 =item PerlIO layers for C<STD(IN|OUT)>
13895 =item Implicit upgrading for byte strings
13897 =back
13899 =item FEATURES THAT REQUIRE 5.8.1
13901 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
13903 =item USAGE
13905 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
13906 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
13908 =item The Filter Option
13910 =over 4
13912 =item Filter-related changes at Encode version 1.87
13914 =back
13916 =item CAVEATS
13918 =over 4
13920 =item NOT SCOPED
13922 =item DO NOT MIX MULTIPLE ENCODINGS
13924 =item tr/// with ranges
13926 Legend of characters above
13928 =back
13930 =item EXAMPLE - Greekperl
13932 =item KNOWN PROBLEMS
13934 literals in regex that are longer than 127 bytes, EBCDIC, format
13936 =over 4
13938 =item The Logic of :locale
13940 =back
13942 =item HISTORY
13944 =item SEE ALSO
13946 =back
13948 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
13950 =over 4
13952 =item SYNOPSIS
13954 =item ABSTRACT
13956 =item Description
13958 =over 4
13960 =item Predefined Methods
13962 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
13963 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
13964 $e-E<gt>bytes([$encoding])
13966 =item Example: base64 transcoder
13968 =item Operator Overloading
13970 =back
13972 =item SEE ALSO
13974 =back
13976 =head2 English - use nice English (or awk) names for ugly punctuation
13977 variables
13979 =over 4
13981 =item SYNOPSIS
13983 =item DESCRIPTION
13985 =item PERFORMANCE
13987 =back
13989 =head2 Env - perl module that imports environment variables as scalars or
13990 arrays
13992 =over 4
13994 =item SYNOPSIS
13996 =item DESCRIPTION
13998 =item LIMITATIONS
14000 =item AUTHOR
14002 =back
14004 =head2 Errno - System errno constants
14006 =over 4
14008 =item SYNOPSIS
14010 =item DESCRIPTION
14012 =item CAVEATS
14014 =item AUTHOR
14016 =item COPYRIGHT
14018 =back
14020 =head2 Exporter - Implements default import method for modules
14022 =over 4
14024 =item SYNOPSIS
14026 =item DESCRIPTION
14028 =over 4
14030 =item How to Export
14032 =item Selecting What To Export
14034 =item How to Import
14036 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
14038 =back
14040 =item Advanced features
14042 =over 4
14044 =item Specialised Import Lists
14046 =item Exporting without using Exporter's import method
14048 =item Exporting without inheriting from Exporter
14050 =item Module Version Checking
14052 =item Managing Unknown Symbols
14054 =item Tag Handling Utility Functions
14056 =item Generating combined tags
14058 =item C<AUTOLOAD>ed Constants
14060 =back
14062 =back
14064 =head2 Exporter::Heavy - Exporter guts
14066 =over 4
14068 =item SYNOPSIS
14070 =item DESCRIPTION
14072 =back
14074 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
14075 Makefiles etc.
14077 =over 4
14079 =item SYNOPSIS
14081 =item DESCRIPTION
14083 =back
14087 eqtime
14089 rm_rf
14091 rm_f
14093 touch
14099 chmod
14101 mkpath
14103 test_f
14105 dos2unix
14107 =over 4
14109 =item SEE ALSO 
14111 =item AUTHOR
14113 =back
14115 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
14117 =over 4
14119 =item SYNOPSIS
14121 =item DESCRIPTION
14123 B<test_harness>
14125 =back
14127 B<pod2man>
14129 B<warn_if_old_packlist>
14131 B<perllocal_install>
14133 B<uninstall>
14135 =head2 ExtUtils::Constant - generate XS code to import C header constants
14137 =over 4
14139 =item SYNOPSIS
14141 =item DESCRIPTION
14143 =item USAGE
14145 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
14147 =item FUNCTIONS
14149 =back
14151 constant_types
14153 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
14155 autoload PACKAGE, VERSION, AUTOLOADER
14157 WriteMakefileSnippet
14159 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
14160 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
14162 =over 4
14164 =item AUTHOR
14166 =back
14168 =head2 ExtUtils::Constant::Base - base class for ExtUtils::Constant objects
14170 =over 4
14172 =item SYNOPSIS
14174 =item DESCRIPTION
14176 =item USAGE
14178 =back
14180 header
14182 memEQ_clause args_hashref
14184 dump_names arg_hashref, ITEM..
14186 assign arg_hashref, VALUE..
14188 return_clause arg_hashref, ITEM
14190 switch_clause arg_hashref, NAMELEN, ITEMHASH, ITEM..
14192 params WHAT
14194 dogfood arg_hashref, ITEM..
14196 C_constant arg_hashref, ITEM.., name, type, value, macro, default, pre,
14197 post, def_pre, def_post, utf8, weight
14199 =over 4
14201 =item BUGS
14203 =item AUTHOR
14205 =back
14207 =head2 ExtUtils::Constant::Utils - helper functions for ExtUtils::Constant
14209 =over 4
14211 =item SYNOPSIS
14213 =item DESCRIPTION
14215 =item USAGE
14217 C_stringify NAME
14219 =back
14221 perl_stringify NAME
14223 =over 4
14225 =item AUTHOR
14227 =back
14229 =head2 ExtUtils::Constant::XS, ExtUtils::Constant::Base - base class for
14230 ExtUtils::Constant objects
14232 =over 4
14234 =item SYNOPSIS
14236 =item DESCRIPTION
14238 =item BUGS
14240 =item AUTHOR
14242 =back
14244 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
14246 =over 4
14248 =item SYNOPSIS
14250 =item DESCRIPTION
14252 =item @EXPORT
14254 =item FUNCTIONS
14256 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
14257 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
14259 =item EXAMPLES
14261 =item SEE ALSO
14263 =item AUTHOR
14265 =back
14267 =head2 ExtUtils::Install - install files from here to there
14269 =over 4
14271 =item SYNOPSIS
14273 =item DESCRIPTION
14275 =over 4
14277 =item Functions
14279 B<install>
14281 =back
14283 =back
14285 B<install_default> I<DISCOURAGED>
14287 B<uninstall>
14289 B<pm_to_blib>
14291 _autosplit
14293 =over 4
14295 =item ENVIRONMENT
14297 B<PERL_INSTALL_ROOT>
14299 =item AUTHOR
14301 =item LICENSE
14303 =back
14305 =head2 ExtUtils::Installed - Inventory management of installed modules
14307 =over 4
14309 =item SYNOPSIS
14311 =item DESCRIPTION
14313 =item USAGE
14315 =item FUNCTIONS
14317 new(), modules(), files(), directories(), directory_tree(), validate(),
14318 packlist(), version()
14320 =item EXAMPLE
14322 =item AUTHOR
14324 =back
14326 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
14328 =over 4
14330 =item SYNOPSIS
14332 =item DESCRIPTION
14334 For static extensions, For dynamic extensions at build/link time, For
14335 dynamic extensions at load time
14337 =over 4
14339 =item EXTRALIBS
14341 =item LDLOADLIBS and LD_RUN_PATH
14343 =item BSLOADLIBS
14345 =back
14347 =item PORTABILITY
14349 =over 4
14351 =item VMS implementation
14353 =item Win32 implementation
14355 =back
14357 =item SEE ALSO
14359 =back
14361 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
14363 =over 4
14365 =item SYNOPSIS
14367 =item DESCRIPTION
14369 =back
14371 =head2 ExtUtils::MM_AIX - AIX specific subclass of ExtUtils::MM_Unix
14373 =over 4
14375 =item SYNOPSIS
14377 =item DESCRIPTION
14379 =over 4
14381 =item Overridden methods
14383 =back
14385 =back
14387 =over 4
14389 =item AUTHOR
14391 =item SEE ALSO
14393 =back
14395 =head2 ExtUtils::MM_Any - Platform-agnostic MM methods
14397 =over 4
14399 =item SYNOPSIS
14401 =item DESCRIPTION
14403 =item METHODS
14405 =over 4
14407 =item Cross-platform helper methods
14409 =back
14411 =back
14413 =over 4
14415 =item Targets
14417 =back
14419 =over 4
14421 =item Init methods
14423 =back
14425 =over 4
14427 =item Tools
14429 =back
14431 =over 4
14433 =item File::Spec wrappers
14435 =back
14437 =over 4
14439 =item Misc
14441 =back
14443 =over 4
14445 =item AUTHOR
14447 =back
14449 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
14450 ExtUtils::MakeMaker
14452 =over 4
14454 =item SYNOPSIS
14456 =item DESCRIPTION
14458 =back
14460 os_flavor
14462 init_linker
14464 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
14465 ExtUtils::MakeMaker
14467 =over 4
14469 =item SYNOPSIS
14471 =item DESCRIPTION
14473 os_flavor
14475 =back
14477 cflags
14479 replace_manpage_separator
14481 init_linker
14483 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
14485 =over 4
14487 =item SYNOPSIS
14489 =item DESCRIPTION
14491 =over 4
14493 =item Overridden methods
14495 os_flavor
14497 =back
14499 =back
14501 B<replace_manpage_separator>
14503 =over 4
14505 =item AUTHOR
14507 =item SEE ALSO
14509 =back
14511 =head2 ExtUtils::MM_MacOS - once produced Makefiles for MacOS Classic
14513 =over 4
14515 =item SYNOPSIS
14517 =item DESCRIPTION
14519 =back
14521 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
14522 ExtUtils::MakeMaker
14524 =over 4
14526 =item SYNOPSIS
14528 =item DESCRIPTION
14530 =back
14532 os_flavor
14534 init_platform, platform_constants
14536 const_cccmd
14538 static_lib
14540 dynamic_lib
14542 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
14543 ExtUtils::MakeMaker
14545 =over 4
14547 =item SYNOPSIS
14549 =item DESCRIPTION
14551 =item METHODS
14553 init_dist
14555 =back
14557 init_linker
14559 os_flavor
14561 =head2 ExtUtils::MM_QNX - QNX specific subclass of ExtUtils::MM_Unix
14563 =over 4
14565 =item SYNOPSIS
14567 =item DESCRIPTION
14569 =over 4
14571 =item Overridden methods
14573 =back
14575 =back
14577 =over 4
14579 =item AUTHOR
14581 =item SEE ALSO
14583 =back
14585 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
14587 =over 4
14589 =item SYNOPSIS
14591 =item DESCRIPTION
14593 =over 4
14595 =item Overridden methods
14597 os_flavor
14599 =back
14601 =back
14603 B<replace_manpage_separator>
14605 =over 4
14607 =item AUTHOR
14609 =item SEE ALSO
14611 =back
14613 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
14615 =over 4
14617 =item SYNOPSIS
14619 =item DESCRIPTION
14621 =item METHODS
14623 =back
14625 =over 4
14627 =item Methods
14629 os_flavor
14631 =back
14633 c_o (o)
14635 cflags (o)
14637 const_cccmd (o)
14639 const_config (o)
14641 const_loadlibs (o)
14643 constants (o)
14645 depend (o)
14647 init_DEST
14649 init_dist
14651 dist (o)
14653 dist_basics (o)
14655 dist_ci (o)
14657 dist_core (o)
14659 B<dist_target>
14661 B<tardist_target>
14663 B<zipdist_target>
14665 B<tarfile_target>
14667 zipfile_target
14669 uutardist_target
14671 shdist_target
14673 dlsyms (o)
14675 dynamic_bs (o)
14677 dynamic_lib (o)
14679 exescan
14681 extliblist
14683 find_perl
14685 fixin
14687 force (o)
14689 guess_name
14691 has_link_code
14693 init_dirscan
14695 init_DIRFILESEP
14697 init_main
14699 init_others
14701 init_linker
14703 init_lib2arch
14705 init_PERL
14707 init_platform, platform_constants
14709 init_PERM
14711 init_xs
14713 install (o)
14715 installbin (o)
14717 linkext (o)
14719 lsdir
14721 macro (o)
14723 makeaperl (o)
14725 makefile (o)
14727 maybe_command
14729 needs_linking (o)
14731 nicetext
14733 parse_abstract
14735 parse_version
14737 pasthru (o)
14739 perl_script
14741 perldepend (o)
14743 perm_rw (o)
14745 perm_rwx (o)
14747 pm_to_blib
14749 post_constants (o)
14751 post_initialize (o)
14753 postamble (o)
14757 prefixify
14759 processPL (o)
14761 quote_paren
14763 replace_manpage_separator
14767 oneliner
14769 quote_literal
14771 escape_newlines
14773 max_exec_len
14775 static (o)
14777 static_lib (o)
14779 staticmake (o)
14781 subdir_x (o)
14783 subdirs (o)
14785 test (o)
14787 test_via_harness (override)
14789 test_via_script (override)
14791 tools_other (o)
14793 tool_xsubpp (o)
14795 all_target
14797 top_targets (o)
14799 writedoc
14801 xs_c (o)
14803 xs_cpp (o)
14805 xs_o (o)
14807 =over 4
14809 =item SEE ALSO
14811 =back
14813 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
14814 ExtUtils::MakeMaker
14816 =over 4
14818 =item SYNOPSIS
14820 =item DESCRIPTION
14822 =over 4
14824 =item Methods always loaded
14826 wraplist
14828 =back
14830 =back
14832 =over 4
14834 =item Methods
14836 guess_name (override)
14838 =back
14840 find_perl (override)
14842 maybe_command (override)
14844 pasthru (override)
14846 pm_to_blib (override)
14848 perl_script (override)
14850 replace_manpage_separator
14852 init_DEST
14854 init_DIRFILESEP
14856 init_main (override)
14858 init_others (override)
14860 init_platform (override)
14862 platform_constants
14864 init_VERSION (override)
14866 constants (override)
14868 special_targets
14870 cflags (override)
14872 const_cccmd (override)
14874 tools_other (override)
14876 init_dist (override)
14878 c_o (override)
14880 xs_c (override)
14882 xs_o (override)
14884 dlsyms (override)
14886 dynamic_lib (override)
14888 static_lib (override)
14890 extra_clean_files
14892 zipfile_target, tarfile_target, shdist_target
14894 install (override)
14896 perldepend (override)
14898 makeaperl (override)
14900 nicetext (override)
14902 prefixify (override)
14906 oneliner
14908 B<echo>
14910 quote_literal
14912 escape_newlines
14914 max_exec_len
14916 init_linker
14918 eliminate_macros
14920 fixpath
14922 os_flavor
14924 =over 4
14926 =item AUTHOR
14928 =back
14930 =head2 ExtUtils::MM_VOS - VOS specific subclass of ExtUtils::MM_Unix
14932 =over 4
14934 =item SYNOPSIS
14936 =item DESCRIPTION
14938 =over 4
14940 =item Overridden methods
14942 =back
14944 =back
14946 =over 4
14948 =item AUTHOR
14950 =item SEE ALSO
14952 =back
14954 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
14955 ExtUtils::MakeMaker
14957 =over 4
14959 =item SYNOPSIS
14961 =item DESCRIPTION
14963 =back
14965 =over 4
14967 =item Overridden methods
14969 B<dlsyms>
14971 =back
14973 replace_manpage_separator
14975 B<maybe_command>
14977 B<init_DIRFILESEP>
14979 B<init_others>
14981 init_platform, platform_constants
14983 special_targets
14985 static_lib
14987 dynamic_lib
14989 extra_clean_files
14991 init_linker
14993 perl_script
14995 xs_o
14997 pasthru
14999 oneliner
15003 max_exec_len
15005 os_flavor
15007 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
15009 =over 4
15011 =item SYNOPSIS
15013 =item DESCRIPTION
15015 =over 4
15017 =item Overriden methods
15019 xs_c
15021 =back
15023 =back
15025 xs_cpp
15027 xs_o
15029 max_exec_len
15031 os_flavor
15033 =over 4
15035 =item AUTHOR
15037 =back
15039 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
15041 =over 4
15043 =item SYNOPSIS
15045 =item DESCRIPTION
15047 =back
15049 =head2 ExtUtils::MakeMaker - Create a module Makefile
15051 =over 4
15053 =item SYNOPSIS
15055 =item DESCRIPTION
15057 =over 4
15059 =item How To Write A Makefile.PL
15061 =item Default Makefile Behaviour
15063 =item make test
15065 =item make testdb
15067 =item make install
15069 =item PREFIX and LIB attribute
15071 =item AFS users
15073 =item Static Linking of a new Perl Binary
15075 =item Determination of Perl Library and Installation Locations
15077 =item Which architecture dependent directory?
15079 =item Using Attributes and Parameters
15081 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
15082 CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS,
15083 EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN,
15084 FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB,
15085 INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
15086 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB,
15087 INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLVENDORARCH,
15088 INSTALLVENDORBIN, INSTALLVENDORLIB, INSTALLVENDORMAN1DIR,
15089 INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR,
15090 INST_MAN3DIR, INST_SCRIPT, LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS,
15091 LINKTYPE, MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET,
15092 MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT,
15093 OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB,
15094 PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW,
15095 PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
15096 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT,
15097 PRINT_PREREQ, SITEPREFIX, SIGN, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST,
15098 VERSION, VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION
15100 =item Additional lowercase attributes
15102 clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean,
15103 test, tool_autosplit
15105 =item Overriding MakeMaker Methods
15107 =item The End Of Cargo Cult Programming
15109 C<< MAN3PODS => ' ' >>
15111 =item Hintsfile support
15113 =item Distribution Support
15115    make distcheck,    make skipcheck,    make distclean,    make manifest, 
15116   make distdir,   make disttest,    make tardist,    make dist,    make
15117 uutardist,    make shdist,    make zipdist,    make ci
15119 =item Module Meta-Data
15121 =item Disabling an extension
15123 =item Other Handy Functions
15125 prompt
15127 =back
15129 =item ENVIRONMENT
15131 PERL_MM_OPT, PERL_MM_USE_DEFAULT, PERL_CORE
15133 =item SEE ALSO
15135 =item AUTHORS
15137 =item LICENSE
15139 =back
15141 =head2 ExtUtils::MakeMaker::Config - Wrapper around Config.pm
15143 =over 4
15145 =item SYNOPSIS
15147 =item DESCRIPTION
15149 =back
15151 =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About
15152 MakeMaker
15154 =over 4
15156 =item DESCRIPTION
15158 =over 4
15160 =item Module Installation
15162 How do I keep from installing man pages?, How do I use a module without
15163 installing it?
15165 =item Philosophy and History
15167 Why not just use <insert other build config tool here>?, What is
15168 Module::Build and how does it relate to MakeMaker?, pure perl.  no make, no
15169 shell commands, easier to customize, cleaner internals, less cruft
15171 =item Module Writing
15173 How do I keep my $VERSION up to date without resetting it manually?, What's
15174 this F<META.yml> thing and how did it get in my F<MANIFEST>?!
15176 =item XS
15178 How to I prevent "object version X.XX does not match bootstrap parameter
15179 Y.YY" errors?, How do I make two or more XS files coexist in the same
15180 directory?
15182 =back
15184 =item PATCHING
15186 =item AUTHOR
15188 =item SEE ALSO
15190 =back
15192 =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker
15194 =over 4
15196 =item SYNOPSIS
15198 =item DESCRIPTION
15200 =over 4
15202 =item The Mantra
15204 =item The Layout
15206 Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP,
15207 bin/
15209 =back
15211 =item SEE ALSO
15213 =back
15215 =head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm
15217 =over 4
15219 =item SYNOPSIS
15221 =item DESCRIPTION
15223 =back
15225 =head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm
15227 =over 4
15229 =item SYNOPSIS
15231 =item DESCRIPTION
15233 =back
15235 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
15237 =over 4
15239 =item SYNOPSIS
15241 =item DESCRIPTION
15243 =over 4
15245 =item Functions
15247 mkmanifest
15249 =back
15251 =back
15253 manifind
15255 manicheck
15257 filecheck
15259 fullcheck
15261 skipcheck
15263 maniread
15265 manicopy
15267 maniadd
15269 =over 4
15271 =item MANIFEST
15273 =item MANIFEST.SKIP
15275 =item EXPORT_OK
15277 =item GLOBAL VARIABLES
15279 =back
15281 =over 4
15283 =item DIAGNOSTICS
15285 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
15286 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
15288 =item ENVIRONMENT
15290 B<PERL_MM_MANIFEST_DEBUG>
15292 =item SEE ALSO
15294 =item AUTHOR
15296 =back
15298 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
15300 =over 4
15302 =item SYNOPSIS
15304 =item DESCRIPTION
15306 =item SEE ALSO
15308 =back
15310 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
15312 =over 4
15314 =item SYNOPSIS
15316 =item DESCRIPTION
15318 =back
15320 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
15321 extension
15323 =over 4
15325 =item SYNOPSIS
15327 =item DESCRIPTION
15329 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
15331 =item AUTHOR
15333 =item REVISION
15335 =back
15337 =head2 ExtUtils::Packlist - manage .packlist files
15339 =over 4
15341 =item SYNOPSIS
15343 =item DESCRIPTION
15345 =item USAGE
15347 =item FUNCTIONS
15349 new(), read(), write(), validate(), packlist_file()
15351 =item EXAMPLE
15353 =item AUTHOR
15355 =back
15357 =head2 ExtUtils::testlib - add blib/* directories to @INC
15359 =over 4
15361 =item SYNOPSIS
15363 =item DESCRIPTION
15365 =back
15367 =head2 Fatal - replace functions with equivalents which succeed or die
15369 =over 4
15371 =item SYNOPSIS
15373 =item DESCRIPTION
15375 =item AUTHOR
15377 =back
15379 =head2 Fcntl - load the C Fcntl.h defines
15381 =over 4
15383 =item SYNOPSIS
15385 =item DESCRIPTION
15387 =item NOTE
15389 =item EXPORTED SYMBOLS
15391 =back
15393 =head2 File::Basename - Parse file paths into directory, filename and
15394 suffix.
15396 =over 4
15398 =item SYNOPSIS
15400 =item DESCRIPTION
15402 =back
15404 C<fileparse>
15406 C<basename>
15408 C<dirname>
15410 C<fileparse_set_fstype>
15412 =over 4
15414 =item SEE ALSO
15416 =back
15418 =head2 File::CheckTree, validate - run many filetest checks on a tree
15420 =over 4
15422 =item SYNOPSIS
15424 =item DESCRIPTION
15426 =item AUTHOR
15428 =item HISTORY
15430 =back
15432 =head2 File::Compare - Compare files or filehandles
15434 =over 4
15436 =item SYNOPSIS
15438 =item DESCRIPTION
15440 =item RETURN
15442 =item AUTHOR
15444 =back
15446 =head2 File::Copy - Copy files or filehandles
15448 =over 4
15450 =item SYNOPSIS
15452 =item DESCRIPTION
15454 =over 4
15456 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
15458 rmscopy($from,$to[,$date_flag])
15460 =back
15462 =item RETURN
15464 =item NOTES
15466 =item AUTHOR
15468 =back
15470 =head2 File::DosGlob - DOS like globbing and then some
15472 =over 4
15474 =item SYNOPSIS
15476 =item DESCRIPTION
15478 =item NOTES
15480 =item EXPORTS (by request only)
15482 =item BUGS
15484 =item AUTHOR
15486 =item HISTORY
15488 =item SEE ALSO
15490 =back
15492 =head2 File::Find - Traverse a directory tree.
15494 =over 4
15496 =item SYNOPSIS
15498 =item DESCRIPTION
15500 B<find>, B<finddepth>
15502 =over 4
15504 =item %options
15506 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
15507 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
15508 C<untaint>, C<untaint_pattern>, C<untaint_skip>
15510 =item The wanted function
15512 C<$File::Find::dir> is the current directory name,, C<$_> is the current
15513 filename within that directory, C<$File::Find::name> is the complete
15514 pathname to the file
15516 =back
15518 =item WARNINGS
15520 =item CAVEAT
15522 $dont_use_nlink, symlinks
15524 =item NOTES
15526 =item BUGS AND CAVEATS
15528 =item HISTORY
15530 =back
15532 =head2 File::Glob - Perl extension for BSD glob routine
15534 =over 4
15536 =item SYNOPSIS
15538 =item DESCRIPTION
15540 =over 4
15542 =item META CHARACTERS
15544 =item POSIX FLAGS
15546 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
15547 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
15548 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
15550 =back
15552 =item DIAGNOSTICS
15554 C<GLOB_NOSPACE>, C<GLOB_ABEND>
15556 =item NOTES
15558 =item SEE ALSO
15560 =item AUTHOR
15562 =back
15564 =head2 File::Path - create or remove directory trees
15566 =over 4
15568 =item SYNOPSIS
15570 =item DESCRIPTION
15572 =item DIAGNOSTICS
15574 =item AUTHORS
15576 =back
15578 =head2 File::Spec - portably perform operations on file names
15580 =over 4
15582 =item SYNOPSIS
15584 =item DESCRIPTION
15586 =item METHODS
15588 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
15589 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
15590 splitdir, catpath(), abs2rel, rel2abs()
15592 =item SEE ALSO
15594 =item AUTHOR
15596 =item COPYRIGHT
15598 =back
15600 =head2 File::Spec::Cygwin - methods for Cygwin file specs
15602 =over 4
15604 =item SYNOPSIS
15606 =item DESCRIPTION
15608 =back
15610 canonpath
15612 file_name_is_absolute
15614 tmpdir (override)
15616 =over 4
15618 =item COPYRIGHT
15620 =back
15622 =head2 File::Spec::Epoc - methods for Epoc file specs
15624 =over 4
15626 =item SYNOPSIS
15628 =item DESCRIPTION
15630 =back
15632 canonpath()
15634 =over 4
15636 =item AUTHOR
15638 =item COPYRIGHT
15640 =item SEE ALSO
15642 =back
15644 =head2 File::Spec::Functions - portably perform operations on file names
15646 =over 4
15648 =item SYNOPSIS
15650 =item DESCRIPTION
15652 =over 4
15654 =item Exports
15656 =back
15658 =item COPYRIGHT
15660 =item SEE ALSO
15662 =back
15664 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
15666 =over 4
15668 =item SYNOPSIS
15670 =item DESCRIPTION
15672 =item METHODS
15674 canonpath
15676 =back
15678 catdir()
15680 catfile
15682 curdir
15684 devnull
15686 rootdir
15688 tmpdir
15690 updir
15692 file_name_is_absolute
15694 path
15696 splitpath
15698 splitdir
15700 catpath
15702 abs2rel
15704 rel2abs
15706 =over 4
15708 =item AUTHORS
15710 =item COPYRIGHT
15712 =item SEE ALSO
15714 =back
15716 =head2 File::Spec::OS2 - methods for OS/2 file specs
15718 =over 4
15720 =item SYNOPSIS
15722 =item DESCRIPTION
15724 tmpdir, splitpath
15726 =item COPYRIGHT
15728 =back
15730 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
15731 modules
15733 =over 4
15735 =item SYNOPSIS
15737 =item DESCRIPTION
15739 =item METHODS
15741 canonpath()
15743 =back
15745 catdir()
15747 catfile
15749 curdir
15751 devnull
15753 rootdir
15755 tmpdir
15757 updir
15759 no_upwards
15761 case_tolerant
15763 file_name_is_absolute
15765 path
15767 join
15769 splitpath
15771 splitdir
15773 catpath()
15775 abs2rel
15777 rel2abs()
15779 =over 4
15781 =item COPYRIGHT
15783 =item SEE ALSO
15785 =back
15787 =head2 File::Spec::VMS - methods for VMS file specs
15789 =over 4
15791 =item SYNOPSIS
15793 =item DESCRIPTION
15795 canonpath (override)
15797 =back
15799 catdir (override)
15801 catfile (override)
15803 curdir (override)
15805 devnull (override)
15807 rootdir (override)
15809 tmpdir (override)
15811 updir (override)
15813 case_tolerant (override)
15815 path (override)
15817 file_name_is_absolute (override)
15819 splitpath (override)
15821 splitdir (override)
15823 catpath (override)
15825 abs2rel (override)
15827 rel2abs (override)
15829 =over 4
15831 =item COPYRIGHT
15833 =item SEE ALSO
15835 =back
15837 =head2 File::Spec::Win32 - methods for Win32 file specs
15839 =over 4
15841 =item SYNOPSIS
15843 =item DESCRIPTION
15845 devnull
15847 =back
15849 tmpdir
15851 catfile
15853 canonpath
15855 splitpath
15857 splitdir
15859 catpath
15861 =over 4
15863 =item Note For File::Spec::Win32 Maintainers
15865 =back
15867 =over 4
15869 =item COPYRIGHT
15871 =item SEE ALSO
15873 =back
15875 =head2 File::Temp - return name and handle of a temporary file safely
15877 =over 4
15879 =item PORTABILITY
15881 =item SYNOPSIS
15883 =item DESCRIPTION
15885 =back
15887 =over 4
15889 =item OBJECT-ORIENTED INTERFACE
15891 B<new>
15893 =back
15895 B<filename>
15897 B<unlink_on_destroy>
15899 B<DESTROY>
15901 =over 4
15903 =item FUNCTIONS
15905 B<tempfile>
15907 =back
15909 B<tempdir>
15911 =over 4
15913 =item MKTEMP FUNCTIONS
15915 B<mkstemp>
15917 =back
15919 B<mkstemps>
15921 B<mkdtemp>
15923 B<mktemp>
15925 =over 4
15927 =item POSIX FUNCTIONS
15929 B<tmpnam>
15931 =back
15933 B<tmpfile>
15935 =over 4
15937 =item ADDITIONAL FUNCTIONS
15939 B<tempnam>
15941 =back
15943 =over 4
15945 =item UTILITY FUNCTIONS
15947 B<unlink0>
15949 =back
15951 B<cmpstat>
15953 B<unlink1>
15955 B<cleanup>
15957 =over 4
15959 =item PACKAGE VARIABLES
15961 B<safe_level>, STANDARD, MEDIUM, HIGH
15963 =back
15965 TopSystemUID
15967 B<$KEEP_ALL>, B<$DEBUG>
15969 =over 4
15971 =item WARNING
15973 =over 4
15975 =item Temporary files and NFS
15977 =item Forking
15979 =item BINMODE
15981 =back
15983 =item HISTORY
15985 =item SEE ALSO
15987 =item AUTHOR
15989 =back
15991 =head2 File::stat - by-name interface to Perl's built-in stat() functions
15993 =over 4
15995 =item SYNOPSIS
15997 =item DESCRIPTION
15999 =item BUGS
16001 =item NOTE
16003 =item AUTHOR
16005 =back
16007 =head2 FileCache - keep more files open than the system permits
16009 =over 4
16011 =item SYNOPSIS
16013 =item DESCRIPTION
16015 cacheout EXPR, cacheout MODE, EXPR
16017 =item CAVEATS
16019 =item BUGS
16021 =back
16023 =head2 FileHandle - supply object methods for filehandles
16025 =over 4
16027 =item SYNOPSIS
16029 =item DESCRIPTION
16031 $fh->print, $fh->printf, $fh->getline, $fh->getlines
16033 =item SEE ALSO
16035 =back
16037 =head2 Filter::Simple - Simplified source filtering
16039 =over 4
16041 =item SYNOPSIS
16043 =item DESCRIPTION
16045 =over 4
16047 =item The Problem
16049 =item A Solution
16051 =item Disabling or changing <no> behaviour
16053 =item All-in-one interface
16055 =item Filtering only specific components of source code
16057 C<"code">, C<"code_no_comments">, C<"executable">,
16058 C<"executable_no_comments">, C<"quotelike">, C<"string">, C<"regex">,
16059 C<"all">
16061 =item Filtering only the code parts of source code
16063 Most source code ceases to be grammatically correct when it is broken up
16064 into the pieces between string literals and regexes. So the C<'code'>
16065 and C<'code_no_comments'> component filter behave slightly differently
16066 from the other partial filters described in the previous section.
16068 =item Using Filter::Simple with an explicit C<import> subroutine
16070 =item Using Filter::Simple and Exporter together
16072 =item How it works
16074 =back
16076 =item AUTHOR
16078 =item COPYRIGHT
16080 =back
16082 =head2 Filter::Util::Call - Perl Source Filter Utility Module
16084 =over 4
16086 =item SYNOPSIS
16088 =item DESCRIPTION
16090 =over 4
16092 =item B<use Filter::Util::Call>
16094 =item B<import()>
16096 =item B<filter() and anonymous sub>
16098 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
16100 =back
16102 =item EXAMPLES
16104 =over 4
16106 =item Example 1: A simple filter.
16108 =item Example 2: Using the context
16110 =item Example 3: Using the context within the filter
16112 =item Example 4: Using filter_del
16114 =back
16116 =item Filter::Simple
16118 =item AUTHOR
16120 =item DATE
16122 =back
16124 =head2 FindBin - Locate directory of original perl script
16126 =over 4
16128 =item SYNOPSIS
16130 =item DESCRIPTION
16132 =item EXPORTABLE VARIABLES
16134 =item KNOWN ISSUES
16136 =item KNOWN BUGS
16138 =item AUTHORS
16140 =item COPYRIGHT
16142 =back
16144 =head2 GDBM_File - Perl5 access to the gdbm library.
16146 =over 4
16148 =item SYNOPSIS
16150 =item DESCRIPTION
16152 =item AVAILABILITY
16154 =item BUGS
16156 =item SEE ALSO
16158 =back
16160 =head2 Getopt::Long - Extended processing of command line options
16162 =over 4
16164 =item SYNOPSIS
16166 =item DESCRIPTION
16168 =item Command Line Options, an Introduction
16170 =item Getting Started with Getopt::Long
16172 =over 4
16174 =item Simple options
16176 =item A little bit less simple options
16178 =item Mixing command line option with other arguments
16180 =item Options with values
16182 =item Options with multiple values
16184 =item Options with hash values
16186 =item User-defined subroutines to handle options
16188 =item Options with multiple names
16190 =item Case and abbreviations
16192 =item Summary of Option Specifications
16194 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
16195 + [ I<desttype> ]
16197 =back
16199 =item Advanced Possibilities
16201 =over 4
16203 =item Object oriented interface
16205 =item Thread Safety
16207 =item Documentation and help texts
16209 =item Storing option values in a hash
16211 =item Bundling
16213 =item The lonesome dash
16215 =item Argument callback
16217 =back
16219 =item Configuring Getopt::Long
16221 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
16222 require_order, permute, bundling (default: disabled), bundling_override
16223 (default: disabled), ignore_case  (default: enabled), ignore_case_always
16224 (default: disabled), auto_version (default:disabled), auto_help
16225 (default:disabled), pass_through (default: disabled), prefix,
16226 prefix_pattern, long_prefix_pattern, debug (default: disabled)
16228 =item Exportable Methods
16230 VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage
16232 =item Return values and Errors
16234 =item Legacy
16236 =over 4
16238 =item Default destinations
16240 =item Alternative option starters
16242 =item Configuration variables
16244 =back
16246 =item Trouble Shooting
16248 =over 4
16250 =item GetOptions does not return a false result when an option is not
16251 supplied
16253 =item GetOptions does not split the command line correctly
16255 =item Undefined subroutine &main::GetOptions called
16257 =item How do I put a "-?" option into a Getopt::Long?
16259 =back
16261 =item AUTHOR
16263 =item COPYRIGHT AND DISCLAIMER
16265 =back
16267 =head2 Getopt::Std, getopt, getopts - Process single-character switches
16268 with switch clustering
16270 =over 4
16272 =item SYNOPSIS
16274 =item DESCRIPTION
16276 =item C<--help> and C<--version>
16278 =back
16280 =head2 Hash::Util - A selection of general-utility hash subroutines
16282 =over 4
16284 =item SYNOPSIS
16286 =item DESCRIPTION
16288 =over 4
16290 =item Restricted hashes
16292 lock_keys, unlock_keys
16294 =back
16296 =back
16298 lock_value, unlock_value
16300 B<lock_hash>, B<unlock_hash>
16302 B<hash_seed>
16304 =over 4
16306 =item CAVEATS
16308 =item AUTHOR
16310 =item SEE ALSO
16312 =back
16314 =head2 I18N::Collate - compare 8-bit scalar data according to the current
16315 locale
16317 =over 4
16319 =item SYNOPSIS
16321 =item DESCRIPTION
16323 =back
16325 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
16326 tags
16328 =over 4
16330 =item SYNOPSIS
16332 =item DESCRIPTION
16334 =back
16336 the function is_language_tag($lang1)
16338 the function extract_language_tags($whatever)
16340 the function same_language_tag($lang1, $lang2)
16342 the function similarity_language_tag($lang1, $lang2)
16344 the function is_dialect_of($lang1, $lang2)
16346 the function super_languages($lang1)
16348 the function locale2language_tag($locale_identifier)
16350 the function encode_language_tag($lang1)
16352 the function alternate_language_tags($lang1)
16354 the function @langs = panic_languages(@accept_languages)
16356 the function implicate_supers( ...languages... ), the function
16357 implicate_supers_strictly( ...languages... )
16359 =over 4
16361 =item ABOUT LOWERCASING
16363 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
16365 =item SEE ALSO
16367 =item COPYRIGHT
16369 =item AUTHOR
16371 =back
16373 =head2 I18N::LangTags::Detect - detect the user's language preferences
16375 =over 4
16377 =item SYNOPSIS
16379 =item DESCRIPTION
16381 =item FUNCTIONS
16383 =item ENVIRONMENT
16385 =item SEE ALSO
16387 =item COPYRIGHT
16389 =item AUTHOR
16391 =back
16393 =head2 I18N::LangTags::List -- tags and names for human languages
16395 =over 4
16397 =item SYNOPSIS
16399 =item DESCRIPTION
16401 =item ABOUT LANGUAGE TAGS
16403 =item LIST OF LANGUAGES
16405 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} :
16406 Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} :
16407 Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian,
16408 {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)],
16409 {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic,
16410 {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy}
16411 : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} :
16412 Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} :
16413 Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae}
16414 : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} :
16415 Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai}
16416 : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} :
16417 Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} :
16418 Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber
16419 (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini,
16420 {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} :
16421 Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} :
16422 Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian
16423 (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central
16424 American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages],
16425 {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb}
16426 : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} :
16427 Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} :
16428 Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree,
16429 {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf}
16430 : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based
16431 Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} :
16432 Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} :
16433 Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru)
16434 Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri,
16435 {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch,
16436 {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi}
16437 : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} :
16438 English, {enm} : Old English (1100-1500), {ang} : Old English
16439 (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} :
16440 Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat}
16441 : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} :
16442 Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French
16443 (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} :
16444 Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan,
16445 {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian,
16446 {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High
16447 German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon}
16448 : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient
16449 Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} :
16450 Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian,
16451 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
16452 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
16453 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo,
16454 {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European
16455 (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua
16456 (International Auxiliary Language Association), {ie} : Interlingue, {iu} :
16457 Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} :
16458 Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian
16459 languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} :
16460 Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle,
16461 {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} :
16462 Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar}
16463 : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh,
16464 {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese,
16465 {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz,
16466 {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} :
16467 Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama,
16468 {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} :
16469 Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} :
16470 Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} :
16471 Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban
16472 (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui}
16473 : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai,
16474 {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili,
16475 {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} :
16476 Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} :
16477 Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} :
16478 Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai,
16479 [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} :
16480 Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} :
16481 Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)],
16482 {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple
16483 languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan,
16484 {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele,
16485 {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
16486 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
16487 {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} :
16488 Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} :
16489 Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi}
16490 : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} :
16491 Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
16492 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
16493 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
16494 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
16495 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
16496 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
16497 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
16498 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
16499 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
16500 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
16501 languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} :
16502 Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami,
16503 [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} :
16504 Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak,
16505 {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian,
16506 {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign
16507 Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} :
16508 Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave
16509 (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian,
16510 {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} :
16511 Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} :
16512 South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} :
16513 Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati,
16514 {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} :
16515 Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao,
16516 {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} :
16517 Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} :
16518 Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau,
16519 {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian,
16520 {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} :
16521 Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh}
16522 : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} :
16523 Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian,
16524 {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} :
16525 Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak}
16526 : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was}
16527 : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private
16528 Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} :
16529 Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
16530 : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu,
16531 {zun} : Zuni
16533 =item SEE ALSO
16535 =item COPYRIGHT AND DISCLAIMER
16537 =item AUTHOR
16539 =back
16541 =head2 I18N::Langinfo - query locale information
16543 =over 4
16545 =item SYNOPSIS
16547 =item DESCRIPTION
16549 =over 4
16551 =item EXPORT
16553 =back
16555 =item SEE ALSO
16557 =item AUTHOR
16559 =item COPYRIGHT AND LICENSE
16561 =back
16563 =head2 IO - load various IO modules
16565 =over 4
16567 =item SYNOPSIS
16569 =item DESCRIPTION
16571 =item DEPRECATED
16573 =back
16575 =head2 IO::Dir - supply object methods for directory handles
16577 =over 4
16579 =item SYNOPSIS
16581 =item DESCRIPTION
16583 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
16584 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
16586 =item SEE ALSO
16588 =item AUTHOR
16590 =item COPYRIGHT
16592 =back
16594 =head2 IO::File - supply object methods for filehandles
16596 =over 4
16598 =item SYNOPSIS
16600 =item DESCRIPTION
16602 =item CONSTRUCTOR
16604 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
16606 =item METHODS
16608 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode(
16609 [LAYER] )
16611 =item NOTE
16613 =item SEE ALSO
16615 =item HISTORY
16617 =back
16619 =head2 IO::Handle - supply object methods for I/O handles
16621 =over 4
16623 =item SYNOPSIS
16625 =item DESCRIPTION
16627 =item CONSTRUCTOR
16629 new (), new_from_fd ( FD, MODE )
16631 =item METHODS
16633 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
16634 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
16635 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
16636 $io->blocking ( [ BOOL ] ), $io->untaint
16638 =item NOTE
16640 =item SEE ALSO
16642 =item BUGS
16644 =item HISTORY
16646 =back
16648 =head2 IO::Pipe - supply object methods for pipes
16650 =over 4
16652 =item SYNOPSIS
16654 =item DESCRIPTION
16656 =item CONSTRUCTOR
16658 new ( [READER, WRITER] )
16660 =item METHODS
16662 reader ([ARGS]), writer ([ARGS]), handles ()
16664 =item SEE ALSO
16666 =item AUTHOR
16668 =item COPYRIGHT
16670 =back
16672 =head2 IO::Poll - Object interface to system poll call
16674 =over 4
16676 =item SYNOPSIS
16678 =item DESCRIPTION
16680 =item METHODS
16682 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
16683 IO ), handles( [ EVENT_MASK ] )
16685 =item SEE ALSO
16687 =item AUTHOR
16689 =item COPYRIGHT
16691 =back
16693 =head2 IO::Seekable - supply seek based methods for I/O objects
16695 =over 4
16697 =item SYNOPSIS
16699 =item DESCRIPTION
16701 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
16702 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
16703 $io->tell
16705 =item SEE ALSO
16707 =item HISTORY
16709 =back
16711 =head2 IO::Select - OO interface to the select system call
16713 =over 4
16715 =item SYNOPSIS
16717 =item DESCRIPTION
16719 =item CONSTRUCTOR
16721 new ( [ HANDLES ] )
16723 =item METHODS
16725 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
16726 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
16727 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
16729 =item EXAMPLE
16731 =item AUTHOR
16733 =item COPYRIGHT
16735 =back
16737 =head2 IO::Socket - Object interface to socket communications
16739 =over 4
16741 =item SYNOPSIS
16743 =item DESCRIPTION
16745 =item CONSTRUCTOR
16747 new ( [ARGS] )
16749 =item METHODS
16751 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
16752 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
16754 =item SEE ALSO
16756 =item AUTHOR
16758 =item COPYRIGHT
16760 =back
16762 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
16764 =over 4
16766 =item SYNOPSIS
16768 =item DESCRIPTION
16770 =item CONSTRUCTOR
16772 new ( [ARGS] )
16774 =over 4
16776 =item METHODS
16778 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
16781 =back
16783 =item SEE ALSO
16785 =item AUTHOR
16787 =item COPYRIGHT
16789 =back
16791 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
16793 =over 4
16795 =item SYNOPSIS
16797 =item DESCRIPTION
16799 =item CONSTRUCTOR
16801 new ( [ARGS] )
16803 =item METHODS
16805 hostpath(), peerpath()
16807 =item SEE ALSO
16809 =item AUTHOR
16811 =item COPYRIGHT
16813 =back
16815 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
16816 handles
16818 =over 4
16820 =item SYNOPSIS
16822 =item DESCRIPTION
16824 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
16825 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
16827 =item SEE ALSO
16829 =item AUTHOR
16831 =item COPYRIGHT
16833 =back
16835 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
16837 =over 4
16839 =item SYNOPSIS
16841 =item DESCRIPTION
16843 =item CONSTRUCTOR
16845 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
16847 =item METHODS
16849 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode(
16850 [LAYER] )
16852 =item NOTE
16854 =item SEE ALSO
16856 =item HISTORY
16858 =back
16860 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
16861 handles
16863 =over 4
16865 =item SYNOPSIS
16867 =item DESCRIPTION
16869 =item CONSTRUCTOR
16871 new (), new_from_fd ( FD, MODE )
16873 =item METHODS
16875 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
16876 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
16877 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
16878 $io->blocking ( [ BOOL ] ), $io->untaint
16880 =item NOTE
16882 =item SEE ALSO
16884 =item BUGS
16886 =item HISTORY
16888 =back
16890 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
16892 =over 4
16894 =item SYNOPSIS
16896 =item DESCRIPTION
16898 =item CONSTRUCTOR
16900 new ( [READER, WRITER] )
16902 =item METHODS
16904 reader ([ARGS]), writer ([ARGS]), handles ()
16906 =item SEE ALSO
16908 =item AUTHOR
16910 =item COPYRIGHT
16912 =back
16914 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
16916 =over 4
16918 =item SYNOPSIS
16920 =item DESCRIPTION
16922 =item METHODS
16924 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
16925 IO ), handles( [ EVENT_MASK ] )
16927 =item SEE ALSO
16929 =item AUTHOR
16931 =item COPYRIGHT
16933 =back
16935 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
16936 I/O objects
16938 =over 4
16940 =item SYNOPSIS
16942 =item DESCRIPTION
16944 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
16945 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
16946 $io->tell
16948 =item SEE ALSO
16950 =item HISTORY
16952 =back
16954 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
16955 call
16957 =over 4
16959 =item SYNOPSIS
16961 =item DESCRIPTION
16963 =item CONSTRUCTOR
16965 new ( [ HANDLES ] )
16967 =item METHODS
16969 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
16970 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
16971 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
16973 =item EXAMPLE
16975 =item AUTHOR
16977 =item COPYRIGHT
16979 =back
16981 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
16982 communications
16984 =over 4
16986 =item SYNOPSIS
16988 =item DESCRIPTION
16990 =item CONSTRUCTOR
16992 new ( [ARGS] )
16994 =item METHODS
16996 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
16997 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
16999 =item SEE ALSO
17001 =item AUTHOR
17003 =item COPYRIGHT
17005 =back
17007 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
17008 AF_INET domain sockets
17010 =over 4
17012 =item SYNOPSIS
17014 =item DESCRIPTION
17016 =item CONSTRUCTOR
17018 new ( [ARGS] )
17020 =over 4
17022 =item METHODS
17024 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
17027 =back
17029 =item SEE ALSO
17031 =item AUTHOR
17033 =item COPYRIGHT
17035 =back
17037 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
17038 AF_UNIX domain sockets
17040 =over 4
17042 =item SYNOPSIS
17044 =item DESCRIPTION
17046 =item CONSTRUCTOR
17048 new ( [ARGS] )
17050 =item METHODS
17052 hostpath(), peerpath()
17054 =item SEE ALSO
17056 =item AUTHOR
17058 =item COPYRIGHT
17060 =back
17062 =head2 IPC::Msg - SysV Msg IPC object class
17064 =over 4
17066 =item SYNOPSIS
17068 =item DESCRIPTION
17070 =item METHODS
17072 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
17073 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
17074 FLAGS ] ), stat
17076 =item SEE ALSO
17078 =item AUTHOR
17080 =item COPYRIGHT
17082 =back
17084 =head2 IPC::Open2, open2 - open a process for both reading and writing
17086 =over 4
17088 =item SYNOPSIS
17090 =item DESCRIPTION
17092 =item WARNING 
17094 =item SEE ALSO
17096 =back
17098 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
17099 handling
17101 =over 4
17103 =item SYNOPSIS
17105 =item DESCRIPTION
17107 =item WARNING
17109 =back
17111 =head2 IPC::Semaphore - SysV Semaphore IPC object class
17113 =over 4
17115 =item SYNOPSIS
17117 =item DESCRIPTION
17119 =item METHODS
17121 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
17122 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
17123 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
17124 , VALUE ), stat
17126 =item SEE ALSO
17128 =item AUTHOR
17130 =item COPYRIGHT
17132 =back
17134 =head2 IPC::SysV - SysV IPC constants
17136 =over 4
17138 =item SYNOPSIS
17140 =item DESCRIPTION
17142 ftok( PATH, ID )
17144 =item SEE ALSO
17146 =item AUTHORS
17148 =item COPYRIGHT
17150 =back
17152 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
17154 =over 4
17156 =item SYNOPSIS
17158 =item DESCRIPTION
17160 =item METHODS
17162 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
17163 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
17164 FLAGS ] ), stat
17166 =item SEE ALSO
17168 =item AUTHOR
17170 =item COPYRIGHT
17172 =back
17174 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
17175 class
17177 =over 4
17179 =item SYNOPSIS
17181 =item DESCRIPTION
17183 =item METHODS
17185 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
17186 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
17187 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
17188 , VALUE ), stat
17190 =item SEE ALSO
17192 =item AUTHOR
17194 =item COPYRIGHT
17196 =back
17198 =head2 List::Util - A selection of general-utility list subroutines
17200 =over 4
17202 =item SYNOPSIS
17204 =item DESCRIPTION
17206 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
17207 BLOCK LIST, shuffle LIST, sum LIST
17209 =item KNOWN BUGS
17211 =item SUGGESTED ADDITIONS
17213 =item COPYRIGHT
17215 =back
17217 =head2 List::Utilib::List::Util, List::Util - A selection of
17218 general-utility list subroutines
17220 =over 4
17222 =item SYNOPSIS
17224 =item DESCRIPTION
17226 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
17227 BLOCK LIST, shuffle LIST, sum LIST
17229 =item KNOWN BUGS
17231 =item SUGGESTED ADDITIONS
17233 =item COPYRIGHT
17235 =back
17237 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
17238 general-utility scalar subroutines
17240 =over 4
17242 =item SYNOPSIS
17244 =item DESCRIPTION
17246 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
17247 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
17248 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
17250 =item KNOWN BUGS
17252 =item COPYRIGHT
17254 =item BLATANT PLUG
17256 =back
17258 =head2 Locale::Constants - constants for Locale codes
17260 =over 4
17262 =item SYNOPSIS
17264 =item DESCRIPTION
17266 =item KNOWN BUGS AND LIMITATIONS
17268 =item SEE ALSO
17270 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
17272 =item AUTHOR
17274 =item COPYRIGHT
17276 =back
17278 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
17280 =over 4
17282 =item SYNOPSIS
17284 =item DESCRIPTION
17286 B<alpha-2>, B<alpha-3>, B<numeric>
17288 =item CONVERSION ROUTINES
17290 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
17291 country_code2code( CODE, CODESET, CODESET )
17293 =item QUERY ROUTINES
17295 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
17297 =item SEMI-PRIVATE ROUTINES
17299 =over 4
17301 =item alias_code
17303 =item rename_country
17305 =back
17307 =item EXAMPLES
17309 =item DOMAIN NAMES
17311 =item KNOWN BUGS AND LIMITATIONS
17313 =item SEE ALSO
17315 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
17316 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
17317 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
17318 http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
17320 =item AUTHOR
17322 =item COPYRIGHT
17324 =back
17326 =head2 Locale::Currency - ISO three letter codes for currency
17327 identification (ISO 4217)
17329 =over 4
17331 =item SYNOPSIS
17333 =item DESCRIPTION
17335 XTS, XXX
17337 =item CONVERSION ROUTINES
17339 code2currency(), currency2code()
17341 =item QUERY ROUTINES
17343 C<all_currency_codes()>, C<all_currency_names()>
17345 =item EXAMPLES
17347 =item KNOWN BUGS AND LIMITATIONS
17349 =item SEE ALSO
17351 Locale::Country, Locale::Script, ISO 4217:1995,
17352 http://www.bsi-global.com/iso4217currency
17354 =item AUTHOR
17356 =item COPYRIGHT
17358 =back
17360 =head2 Locale::Language - ISO two letter codes for language identification
17361 (ISO 639)
17363 =over 4
17365 =item SYNOPSIS
17367 =item DESCRIPTION
17369 =item CONVERSION ROUTINES
17371 code2language(), language2code()
17373 =item QUERY ROUTINES
17375 C<all_language_codes()>, C<all_language_names()>
17377 =item EXAMPLES
17379 =item KNOWN BUGS AND LIMITATIONS
17381 =item SEE ALSO
17383 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
17384 http://lcweb.loc.gov/standards/iso639-2/langhome.html
17386 =item AUTHOR
17388 =item COPYRIGHT
17390 =back
17392 =head2 Locale::Maketext - framework for localization
17394 =over 4
17396 =item SYNOPSIS
17398 =item DESCRIPTION
17400 =item QUICK OVERVIEW
17402 =item METHODS
17404 =over 4
17406 =item Construction Methods
17408 =item The "maketext" Method
17410 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
17412 =item Utility Methods
17414 $language->quant($number, $singular), $language->quant($number, $singular,
17415 $plural), $language->quant($number, $singular, $plural, $negative),
17416 $language->numf($number), $language->sprintf($format, @items),
17417 $language->language_tag(), $language->encoding()
17419 =item Language Handle Attributes and Internals
17421 =back
17423 =item LANGUAGE CLASS HIERARCHIES
17425 =item ENTRIES IN EACH LEXICON
17427 =item BRACKET NOTATION
17429 =item AUTO LEXICONS
17431 =item CONTROLLING LOOKUP FAILURE
17433 =item HOW TO USE MAKETEXT
17435 =item SEE ALSO
17437 =item COPYRIGHT AND DISCLAIMER
17439 =item AUTHOR
17441 =back
17443 =head2 Locale::Maketext::TPJ13 -- article about software localization
17445 =over 4
17447 =item SYNOPSIS
17449 =item DESCRIPTION
17451 =item Localization and Perl: gettext breaks, Maketext fixes
17453 =over 4
17455 =item A Localization Horror Story: It Could Happen To You
17457 =item The Linguistic View
17459 =item Breaking gettext
17461 =item Replacing gettext
17463 =item Buzzwords: Abstraction and Encapsulation
17465 =item Buzzword: Isomorphism
17467 =item Buzzword: Inheritance
17469 =item Buzzword: Concision
17471 =item The Devil in the Details
17473 =item The Proof in the Pudding: Localizing Web Sites
17475 =item References
17477 =back
17479 =back
17481 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
17483 =over 4
17485 =item SYNOPSIS
17487 =item DESCRIPTION
17489 B<alpha-2>, B<alpha-3>, B<numeric>
17491 =over 4
17493 =item SPECIAL CODES
17495 =back
17497 =item CONVERSION ROUTINES
17499 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
17500 script_code2code( CODE, CODESET, CODESET )
17502 =item QUERY ROUTINES
17504 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
17506 =item EXAMPLES
17508 =item KNOWN BUGS AND LIMITATIONS
17510 =item SEE ALSO
17512 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
17513 http://www.evertype.com/standards/iso15924/
17515 =item AUTHOR
17517 =item COPYRIGHT
17519 =back
17521 =head2 MIME::Base64 - Encoding and decoding of base64 strings
17523 =over 4
17525 =item SYNOPSIS
17527 =item DESCRIPTION
17529 encode_base64($str), encode_base64($str, $eol);, decode_base64($str)
17531 =item DIAGNOSTICS
17533 Premature end of base64 data, Premature padding of base64 data, Wide
17534 character in subroutine entry
17536 =item EXAMPLES
17538 =item COPYRIGHT
17540 =item SEE ALSO
17542 =back
17544 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
17545 of quoted-printable strings
17547 =over 4
17549 =item SYNOPSIS
17551 =item DESCRIPTION
17553 encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode),
17554 decode_qp($str);
17556 =item COPYRIGHT
17558 =item SEE ALSO
17560 =back
17562 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
17563 strings
17565 =over 4
17567 =item SYNOPSIS
17569 =item DESCRIPTION
17571 encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode),
17572 decode_qp($str);
17574 =item COPYRIGHT
17576 =item SEE ALSO
17578 =back
17580 =head2 Math::BigFloat - Arbitrary size floating point math package
17582 =over 4
17584 =item SYNOPSIS
17586 =item DESCRIPTION
17588 =over 4
17590 =item Canonical notation
17592 =item Output
17594 =item C<mantissa()>, C<exponent()> and C<parts()>
17596 =item Accuracy vs. Precision
17598 =item Rounding
17600 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
17601 ), fround  ( -$scale ) and fround ( 0 )
17603 =back
17605 =item METHODS
17607 =over 4
17609 =item accuracy
17611 =item precision()
17613 =back
17615 =item Autocreating constants
17617 =over 4
17619 =item Math library
17621 =item Using Math::BigInt::Lite
17623 =back
17625 =item BUGS
17627 =item CAVEATS
17629 stringify, bstr(), bdiv, Modifying and =, bpow, precision() vs. accuracy()
17631 =item SEE ALSO
17633 =item LICENSE
17635 =item AUTHORS
17637 =back
17639 =head2 Math::BigInt - Arbitrary size integer/float math package
17641 =over 4
17643 =item SYNOPSIS
17645 =item DESCRIPTION
17647 Input, Output
17649 =item METHODS
17651 =over 4
17653 =item config
17655 =item accuracy
17657 =item precision
17659 =item brsft
17661 =item new
17663 =item bnan
17665 =item bzero
17667 =item binf
17669 =item bone
17671 =item is_one()/is_zero()/is_nan()/is_inf()
17673 =item is_pos()/is_neg()
17675         $x->is_pos();                   # true if > 0
17676         $x->is_neg();                   # true if < 0
17678 =item is_odd()/is_even()/is_int()
17680 =item bcmp
17682 =item bacmp
17684 =item sign
17686 =item digit
17688 =item bneg
17690 =item babs
17692 =item bnorm
17694 =item bnot
17696 =item binc
17698 =item bdec
17700 =item badd
17702 =item bsub
17704 =item bmul
17706 =item bdiv
17708 =item bmod
17710 =item bmodinv
17712 =item bmodpow
17714 =item bpow
17716 =item blsft
17718 =item brsft
17720 =item band
17722 =item bior
17724 =item bxor
17726 =item bnot
17728 =item bsqrt
17730 =item bfac
17732 =item round
17734 =item bround
17736 =item bfround
17738 =item bfloor
17740 =item bceil
17742 =item bgcd
17744 =item blcm
17746 =item exponent
17748 =item mantissa
17750 =item parts
17752 =item copy
17754 =item as_int
17756 =item bsstr
17758 =item as_hex
17760 =item as_bin
17762 =back
17764 =item ACCURACY and PRECISION
17766 =over 4
17768 =item Precision P
17770 =item Accuracy A
17772 =item Fallback F
17774 =item Rounding mode R
17776 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
17777 (significant digits), Setting/Accessing, Creating numbers, Usage,
17778 Precedence, Overriding globals, Local settings, Rounding, Default values,
17779 Remarks
17781 =back
17783 =item Infinity and Not a Number
17785 oct()/hex(), log(-inf), exp(), cos(), sin(), atan2()
17787 =item INTERNALS
17789 =over 4
17791 =item MATH LIBRARY
17793 =item SIGN
17795 =item mantissa(), exponent() and parts()
17797 =back
17799 =item EXAMPLES
17801   use Math::BigInt;
17803 =item Autocreating constants
17805 =item PERFORMANCE
17807 =over 4
17809 =item Alternative math libraries
17811 =item SUBCLASSING
17813 =back
17815 =item Subclassing Math::BigInt
17817 =item UPGRADING
17819 =over 4
17821 =item Auto-upgrade
17823 bsqrt(), div(), blog()
17825 =back
17827 =item BUGS
17829 broot() does not work, Out of Memory!, Fails to load Calc on Perl prior
17830 5.6.0
17832 =item CAVEATS
17834 bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling,
17835 Modifying and =, bpow, Overloading -$x, Mixing different object types,
17836 bsqrt(), brsft()
17838 =item LICENSE
17840 =item SEE ALSO
17842 =item AUTHORS
17844 =back
17846 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
17848 =over 4
17850 =item SYNOPSIS
17852 =item DESCRIPTION
17854 =item STORAGE
17856 =item METHODS
17858 =item WRAP YOUR OWN
17860 =item LICENSE
17862 This program is free software; you may redistribute it and/or modify it
17863 under
17864 the same terms as Perl itself. 
17866 =item AUTHORS
17868 =item SEE ALSO
17870 =back
17872 =head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code
17874 =over 4
17876 =item SYNOPSIS
17878 =item DESCRIPTION
17880 =item METHODS
17882 =over 4
17884 =item __emu_bxor
17886 =item __emu_band
17888 =item __emu_bior
17890 =back
17892 =item LICENSE
17894 This program is free software; you may redistribute it and/or modify it
17895 under
17896 the same terms as Perl itself. 
17898 =item AUTHORS
17900 =item SEE ALSO
17902 =back
17904 =head2 Math::BigRat - Arbitrary big rational numbers
17906 =over 4
17908 =item SYNOPSIS
17910 =item DESCRIPTION
17912 =over 4
17914 =item MATH LIBRARY
17916 =back
17918 =item METHODS
17920 =over 4
17922 =item new()
17924 =item numerator()
17926 =item denominator()
17928         $d = $x->denominator();
17930 =item parts()
17932 =item as_int()
17934 =item as_hex()
17936 =item as_bin()
17938 =item bfac()
17940 =item blog()
17942 =item bround()/round()/bfround()
17944 =item bmod()
17946 =item is_one()
17948 =item is_zero()
17950 =item is_pos()
17952 =item is_neg()
17954 =item is_int()
17956 =item is_odd()
17958 =item is_even()
17960 =item bceil()
17962 =item bfloor()
17964         $x->bfloor();
17966 =item bsqrt()
17968         $x->bsqrt();
17970 =item config
17972 =back
17974 =item BUGS
17976 inf handling (partial), NaN handling (partial), rounding (not implemented
17977 except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(),
17978 blog(), bmodinv() and bmodpow() (partial)
17980 =item LICENSE
17982 =item SEE ALSO
17984 =item AUTHORS
17986 =back
17988 =head2 Math::Complex - complex numbers and associated mathematical
17989 functions
17991 =over 4
17993 =item SYNOPSIS
17995 =item DESCRIPTION
17997 =item OPERATIONS
17999 =item CREATION
18001 =item DISPLAYING
18003 =over 4
18005 =item CHANGED IN PERL 5.6
18007 =back
18009 =item USAGE
18011 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
18013 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
18015 =item BUGS
18017 =item AUTHORS
18019 =back
18021 =head2 Math::Trig - trigonometric functions
18023 =over 4
18025 =item SYNOPSIS
18027 =item DESCRIPTION
18029 =item TRIGONOMETRIC FUNCTIONS
18031 B<tan>
18033 =over 4
18035 =item ERRORS DUE TO DIVISION BY ZERO
18037 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
18039 =back
18041 =item PLANE ANGLE CONVERSIONS
18043 =item RADIAL COORDINATE CONVERSIONS
18045 =over 4
18047 =item COORDINATE SYSTEMS
18049 =item 3-D ANGLE CONVERSIONS
18051 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
18052 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
18054 =back
18056 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
18058 =item EXAMPLES
18060 =over 4
18062 =item CAVEAT FOR GREAT CIRCLE FORMULAS
18064 =back
18066 =item BUGS
18068 =item AUTHORS
18070 =back
18072 =head2 Memoize - Make functions faster by trading space for time
18074 =over 4
18076 =item SYNOPSIS
18078 =item DESCRIPTION
18080 =item DETAILS
18082 =item OPTIONS
18084 =over 4
18086 =item INSTALL
18088 =item NORMALIZER
18090 =item C<SCALAR_CACHE>, C<LIST_CACHE>
18092 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
18094 =back
18096 =item OTHER FACILITIES
18098 =over 4
18100 =item C<unmemoize>
18102 =item C<flush_cache>
18104 =back
18106 =item CAVEATS
18108 =item PERSISTENT CACHE SUPPORT
18110 =item EXPIRATION SUPPORT
18112 =item BUGS
18114 =item MAILING LIST
18116 =item AUTHOR
18118 =item COPYRIGHT AND LICENSE
18120 =item THANK YOU
18122 =back
18124 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
18125 Storable use
18127 =over 4
18129 =item DESCRIPTION
18131 =back
18133 =head2 Memoize::Expire - Plug-in module for automatic expiration of
18134 memoized values
18136 =over 4
18138 =item SYNOPSIS
18140 =item DESCRIPTION
18142 =item INTERFACE
18144  TIEHASH,  EXISTS,  STORE
18146 =item ALTERNATIVES
18148 =item CAVEATS
18150 =item AUTHOR
18152 =item SEE ALSO
18154 =back
18156 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
18158 =over 4
18160 =item DESCRIPTION
18162 =back
18164 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
18166 =over 4
18168 =item DESCRIPTION
18170 =back
18172 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
18173 Storable use
18175 =over 4
18177 =item DESCRIPTION
18179 =back
18181 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
18182 Storable use
18184 =over 4
18186 =item DESCRIPTION
18188 =back
18190 =head2 Memoize::Storable - store Memoized data in Storable database
18192 =over 4
18194 =item DESCRIPTION
18196 =back
18198 =head2 NDBM_File - Tied access to ndbm files
18200 =over 4
18202 =item SYNOPSIS
18204 =item DESCRIPTION
18206 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
18208 =item DIAGNOSTICS
18210 =over 4
18212 =item C<ndbm store returned -1, errno 22, key "..." at ...>
18214 =back
18216 =item BUGS AND WARNINGS
18218 =back
18220 =head2 NEXT - Provide a pseudo-class NEXT (et al) that allows method
18221 redispatch
18223 =over 4
18225 =item SYNOPSIS
18227 =item DESCRIPTION
18229 =over 4
18231 =item Enforcing redispatch
18233 =item Avoiding repetitions
18235 =item Invoking all versions of a method with a single call
18237 =item Using C<EVERY> methods
18239 =back
18241 =item AUTHOR
18243 =item BUGS AND IRRITATIONS
18245 =item COPYRIGHT
18247 =back
18249 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
18251 =over 4
18253 =item SYNOPSIS
18255 =item DESCRIPTION
18257 =item USER METHODS
18259 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
18260 dataend ()
18262 =item CLASS METHODS
18264 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
18265 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
18266 ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh ()
18268 =item EXPORTS
18270 =item AUTHOR
18272 =item COPYRIGHT
18274 =back
18276 =head2 Net::Config - Local configuration data for libnet
18278 =over 4
18280 =item SYNOPSYS
18282 =item DESCRIPTION
18284 =item METHODS
18286 requires_firewall HOST
18288 =item NetConfig VALUES
18290 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
18291 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
18292 ftp_int_pasive, local_netmask, test_hosts, test_exists
18294 =back
18296 =head2 Net::Domain - Attempt to evaluate the current host's internet name
18297 and domain
18299 =over 4
18301 =item SYNOPSIS
18303 =item DESCRIPTION
18305 hostfqdn (), hostname (), hostdomain ()
18307 =item AUTHOR
18309 =item COPYRIGHT
18311 =back
18313 =head2 Net::FTP - FTP Client class
18315 =over 4
18317 =item SYNOPSIS
18319 =item DESCRIPTION
18321 =item OVERVIEW
18323 =item CONSTRUCTOR
18325 new ([ HOST ] [, OPTIONS ])
18327 =item METHODS
18329 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
18330 site (ARGS), ascii, binary, rename ( OLDNAME, NEWNAME ), delete ( FILENAME
18331 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR [,
18332 RECURSE ]), mkdir ( DIR [, RECURSE ]), alloc ( SIZE [, RECORD_SIZE] ), ls (
18333 [ DIR ] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ),
18334 put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE
18335 ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ),
18336 size ( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[
18337 BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ DIR ] ), retr ( FILE ),
18338 stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [ PORT ] ), pasv (),
18339 pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_xfer_unique (
18340 SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( NON_PASV_SERVER ),
18341 abort (), quit ()
18343 =over 4
18345 =item Methods for the adventurous
18347 quot (CMD [,ARGS])
18349 =back
18351 =item THE dataconn CLASS
18353 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
18354 bytes_read (), abort (), close ()
18356 =item UNIMPLEMENTED
18358 B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
18360 =item REPORTING BUGS
18362 =item AUTHOR
18364 =item SEE ALSO
18366 =item USE EXAMPLES
18368 http://www.csh.rit.edu/~adam/Progs/
18370 =item CREDITS
18372 =item COPYRIGHT
18374 =back
18376 =head2 Net::NNTP - NNTP Client class
18378 =over 4
18380 =item SYNOPSIS
18382 =item DESCRIPTION
18384 =item CONSTRUCTOR
18386 new ( [ HOST ] [, OPTIONS ])
18388 =item METHODS
18390 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
18391 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
18392 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
18393 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
18394 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
18395 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
18396 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
18398 =over 4
18400 =item Extension methods
18402 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
18403 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
18404 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
18405 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
18406 GROUP ] ), reader
18408 =back
18410 =item UNSUPPORTED
18412 =item DEFINITIONS
18414 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
18416 =item SEE ALSO
18418 =item AUTHOR
18420 =item COPYRIGHT
18422 =back
18424 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
18426 =over 4
18428 =item SYNOPSIS
18430 =item DESCRIPTION
18432 =item CONSTRUCTOR
18434 new ( [ HOST ] [, OPTIONS ] 0
18436 =item METHODS
18438 auth ( USERNAME, PASSWORD ), user ( USER ), pass ( PASS ), login ( [ USER
18439 [, PASS ]] ), apop ( [ USER [, PASS ]] ), banner (), capa (),  capabilities
18440 (), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [, FH ]
18441 ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ]
18442 ), delete ( MSGNUM ), reset (), quit ()
18444 =item NOTES
18446 =item SEE ALSO
18448 =item AUTHOR
18450 =item COPYRIGHT
18452 =back
18454 =head2 Net::Ping - check a remote host for reachability
18456 =over 4
18458 =item SYNOPSIS
18460 =item DESCRIPTION
18462 =over 4
18464 =item Functions
18466 Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos
18467 ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
18468 $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
18469 $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
18470 [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host
18471 [, $timeout]);
18473 =back
18475 =item NOTES
18477 =item INSTALL
18479 =item BUGS
18481 =item AUTHORS
18483 =item COPYRIGHT
18485 =back
18487 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
18489 =over 4
18491 =item SYNOPSIS
18493 =item DESCRIPTION
18495 =item EXAMPLES
18497 =item CONSTRUCTOR
18499 new ( [ HOST ] [, OPTIONS ] )
18501 =item METHODS
18503 banner (), domain (), hello ( DOMAIN ), host (), etrn ( DOMAIN ), auth (
18504 USERNAME, PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ),
18505 send_or_mail ( ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient (
18506 ADDRESS [, ADDRESS, [...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]]
18507 ), cc ( ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ),
18508 data ( [ DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [
18509 $subject ] ), quit ()
18511 =item ADDRESSES
18513 =item SEE ALSO
18515 =item AUTHOR
18517 =item COPYRIGHT
18519 =back
18521 =head2 Net::Time - time and daytime network client interface
18523 =over 4
18525 =item SYNOPSIS
18527 =item DESCRIPTION
18529 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
18530 PROTOCOL [, TIMEOUT]]])
18532 =item AUTHOR
18534 =item COPYRIGHT
18536 =back
18538 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
18539 functions
18541 =over 4
18543 =item SYNOPSIS
18545 =item DESCRIPTION
18547 =item EXAMPLES
18549 =item NOTE
18551 =item AUTHOR
18553 =back
18555 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
18557 =over 4
18559 =item DESCRIPTION
18561 =over 4
18563 =item Where to get this document
18565 =item How to contribute to this document
18567 =back
18569 =item Author and Copyright Information
18571 =over 4
18573 =item Disclaimer
18575 =back
18577 =item Obtaining and installing libnet
18579 =over 4
18581 =item What is libnet ?
18583 =item Which version of perl do I need ?
18585 =item What other modules do I need ?
18587 =item What machines support libnet ?
18589 =item Where can I get the latest libnet release
18591 =back
18593 =item Using Net::FTP
18595 =over 4
18597 =item How do I download files from an FTP server ?
18599 =item How do I transfer files in binary mode ?
18601 =item How can I get the size of a file on a remote FTP server ?
18603 =item How can I get the modification time of a file on a remote FTP server
18606 =item How can I change the permissions of a file on a remote server ?
18608 =item Can I do a reget operation like the ftp command ?
18610 =item How do I get a directory listing from an FTP server ?
18612 =item Changing directory to "" does not fail ?
18614 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
18616 =item I am behind an FTP proxy firewall, but cannot access machines outside
18619 =item My ftp proxy firewall does not listen on port 21
18621 =item Is it possible to change the file permissions of a file on an FTP
18622 server ?
18624 =item I have seen scripts call a method message, but cannot find it
18625 documented ?
18627 =item Why does Net::FTP not implement mput and mget methods
18629 =back
18631 =item Using Net::SMTP
18633 =over 4
18635 =item Why can't the part of an Email address after the @ be used as the
18636 hostname ?
18638 =item Why does Net::SMTP not do DNS MX lookups ?
18640 =item The verify method always returns true ?
18642 =back
18644 =item Debugging scripts
18646 =over 4
18648 =item How can I debug my scripts that use Net::* modules ?
18650 =back
18652 =item AUTHOR AND COPYRIGHT
18654 =back
18656 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
18657 functions
18659 =over 4
18661 =item SYNOPSIS
18663 =item DESCRIPTION
18665 =item EXAMPLES
18667 =item NOTE
18669 =item AUTHOR
18671 =back
18673 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
18674 functions
18676 =over 4
18678 =item SYNOPSIS
18680 =item DESCRIPTION
18682 =item NOTE
18684 =item AUTHOR
18686 =back
18688 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
18689 functions
18691 =over 4
18693 =item SYNOPSIS
18695 =item DESCRIPTION
18697 =item EXAMPLES
18699 =item NOTE
18701 =item AUTHOR
18703 =back
18705 =head2 Netrc, Net::Netrc - OO interface to users netrc file
18707 =over 4
18709 =item SYNOPSIS
18711 =item DESCRIPTION
18713 =item THE .netrc FILE
18715 machine name, default, login name, password string, account string, macdef
18716 name
18718 =item CONSTRUCTOR
18720 lookup ( MACHINE [, LOGIN ])
18722 =item METHODS
18724 login (), password (), account (), lpa ()
18726 =item AUTHOR
18728 =item SEE ALSO
18730 =item COPYRIGHT
18732 =back
18734 =head2 O - Generic interface to Perl Compiler backends
18736 =over 4
18738 =item SYNOPSIS
18740 =item DESCRIPTION
18742 =item CONVENTIONS
18744 =item IMPLEMENTATION
18746 =item BUGS
18748 =item AUTHOR
18750 =back
18752 =head2 ODBM_File - Tied access to odbm files
18754 =over 4
18756 =item SYNOPSIS
18758 =item DESCRIPTION
18760 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
18762 =item DIAGNOSTICS
18764 =over 4
18766 =item C<odbm store returned -1, errno 22, key "..." at ...>
18768 =back
18770 =item BUGS AND WARNINGS
18772 =back
18774 =head2 Opcode - Disable named opcodes when compiling perl code
18776 =over 4
18778 =item SYNOPSIS
18780 =item DESCRIPTION
18782 =item NOTE
18784 =item WARNING
18786 =item Operator Names and Operator Lists
18788 an operator name (opname), an operator tag name (optag), a negated opname
18789 or optag, an operator set (opset)
18791 =item Opcode Functions
18793 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
18794 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
18795 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
18796 opdump (PAT)
18798 =item Manipulating Opsets
18800 =item TO DO (maybe)
18802 =back
18804 =over 4
18806 =item Predefined Opcode Tags
18808 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
18809 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
18810 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
18811 :dangerous
18813 =item SEE ALSO
18815 =item AUTHORS
18817 =back
18819 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
18820 compartments
18822 =over 4
18824 =item SYNOPSIS
18826 =item DESCRIPTION
18828 a new namespace, an operator mask
18830 =item WARNING
18832 =over 4
18834 =item RECENT CHANGES
18836 =item Methods in class Safe
18838 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
18839 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
18840 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
18841 root (NAMESPACE), mask (MASK)
18843 =item Some Safety Issues
18845 Memory, CPU, Snooping, Signals, State Changes
18847 =item AUTHOR
18849 =back
18851 =back
18853 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
18854 compiling
18856 =over 4
18858 =item SYNOPSIS  
18860 =item DESCRIPTION
18862 =item SEE ALSO
18864 =back
18866 =head2 POSIX - Perl interface to IEEE Std 1003.1
18868 =over 4
18870 =item SYNOPSIS
18872 =item DESCRIPTION
18874 =item NOTE
18876 =item CAVEATS 
18878 =item FUNCTIONS
18880 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
18881 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
18882 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
18883 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
18884 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
18885 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
18886 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
18887 fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv,
18888 geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid,
18889 getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha,
18890 isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace,
18891 isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime,
18892 log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr,
18893 memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice,
18894 offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc,
18895 putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename,
18896 rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid,
18897 setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
18898 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
18899 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
18900 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
18901 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
18902 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
18903 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
18904 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
18905 wctomb, write
18907 =item CLASSES
18909 =over 4
18911 =item POSIX::SigAction
18913 new, handler, mask, flags, safe
18915 =item POSIX::SigSet
18917 new, addset, delset, emptyset, fillset, ismember
18919 =item POSIX::Termios
18921 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
18922 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
18923 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
18924 field values, c_cflag field values, c_iflag field values, c_lflag field
18925 values, c_oflag field values
18927 =back
18929 =item PATHNAME CONSTANTS
18931 Constants
18933 =item POSIX CONSTANTS
18935 Constants
18937 =item SYSTEM CONFIGURATION
18939 Constants
18941 =item ERRNO
18943 Constants
18945 =item FCNTL
18947 Constants
18949 =item FLOAT
18951 Constants
18953 =item LIMITS
18955 Constants
18957 =item LOCALE
18959 Constants
18961 =item MATH
18963 Constants
18965 =item SIGNAL
18967 Constants
18969 =item STAT
18971 Constants, Macros
18973 =item STDLIB
18975 Constants
18977 =item STDIO
18979 Constants
18981 =item TIME
18983 Constants
18985 =item UNISTD
18987 Constants
18989 =item WAIT
18991 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
18992 WTERMSIG, WIFSTOPPED, WSTOPSIG
18994 =back
18996 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
18997 name space
18999 =over 4
19001 =item SYNOPSIS
19003 =item DESCRIPTION
19005 :unix, :stdio, :perlio, :crlf, :mmap, :utf8, :bytes, :raw, :pop, :win32
19007 =over 4
19009 =item Custom Layers
19011 :encoding, :via
19013 =item Alternatives to raw
19015 =item Defaults and how to override them
19017 =item Querying the layers of filehandles
19019 =back
19021 =item AUTHOR
19023 =item SEE ALSO
19025 =back
19027 =head2 PerlIO::encoding - encoding layer
19029 =over 4
19031 =item SYNOPSIS
19033 =item DESCRIPTION
19035 =item SEE ALSO
19037 =back
19039 =head2 PerlIO::scalar - in-memory IO, scalar IO
19041 =over 4
19043 =item SYNOPSIS
19045 =item DESCRIPTION
19047 =item IMPLEMENTATION NOTE
19049 =back
19051 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
19053 =over 4
19055 =item SYNOPSIS
19057 =item DESCRIPTION
19059 =item EXPECTED METHODS
19061 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
19062 $obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]),
19063 $obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]),
19064 $obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh),
19065 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
19066 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
19067 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
19068 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
19070 =item EXAMPLES
19072 =over 4
19074 =item Example - a Hexadecimal Handle
19076 =back
19078 =back
19080 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
19082 =over 4
19084 =item SYNOPSIS
19086 =item DESCRIPTION
19088 =item REQUIRED MODULES
19090 =item SEE ALSO
19092 =item ACKNOWLEDGEMENTS
19094 =item COPYRIGHT
19096 =back
19098 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
19100 =over 4
19102 =item SYNOPSIS
19104 =item OPTIONS/ARGUMENTS
19106 =over 4
19108 =item podchecker()
19110 B<-warnings> =E<gt> I<val>
19112 =back
19114 =item DESCRIPTION
19116 =item DIAGNOSTICS
19118 =over 4
19120 =item Errors
19122 empty =headn, =over on line I<N> without closing =back, =item without
19123 previous =over, =back without previous =over, No argument for =begin, =end
19124 without =begin, Nested =begin's, =for without formatter specification,
19125 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
19126 interior-sequence "I<SEQ>", nested commands
19127 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
19128 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
19129 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
19130 after =back
19132 =item Warnings
19134 multiple occurrence of link target I<name>, line containing nothing but
19135 whitespace in paragraph, file does not start with =head, previous =item has
19136 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
19137 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
19138 items in =over, No argument for =item, empty section in previous paragraph,
19139 Verbatim paragraph in NAME section, =headI<n> without preceding higher
19140 level
19142 =item Hyperlinks
19144 ignoring leading/trailing whitespace in link, (section) in '$page'
19145 deprecated, alternative text/node '%s' contains non-escaped | or /
19147 =back
19149 =item RETURN VALUE
19151 =item EXAMPLES
19153 =item INTERFACE
19155 =back
19157 C<Pod::Checker-E<gt>new( %options )>
19159 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
19160 @args )>
19162 C<$checker-E<gt>num_errors()>
19164 C<$checker-E<gt>num_warnings()>
19166 C<$checker-E<gt>name()>
19168 C<$checker-E<gt>node()>
19170 C<$checker-E<gt>idx()>
19172 C<$checker-E<gt>hyperlink()>
19174 =over 4
19176 =item AUTHOR
19178 =back
19180 =head2 Pod::Find - find POD documents in directory trees
19182 =over 4
19184 =item SYNOPSIS
19186 =item DESCRIPTION
19188 =back
19190 =over 4
19192 =item C<pod_find( { %opts } , @directories )>
19194 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
19197 =back
19199 =over 4
19201 =item C<simplify_name( $str )>
19203 =back
19205 =over 4
19207 =item C<pod_where( { %opts }, $pod )>
19209 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
19212 =back
19214 =over 4
19216 =item C<contains_pod( $file , $verbose )>
19218 =back
19220 =over 4
19222 =item AUTHOR
19224 =item SEE ALSO
19226 =back
19228 =head2 Pod::Html - module to convert pod files to HTML
19230 =over 4
19232 =item SYNOPSIS
19234 =item DESCRIPTION
19236 =item ARGUMENTS
19238 backlink, cachedir, css, flush, header, help, hiddendirs, htmldir,
19239 htmlroot, index, infile, libpods, netscape, outfile, podpath, podroot,
19240 quiet, recurse, title, verbose
19242 =item EXAMPLE
19244 =item ENVIRONMENT
19246 =item AUTHOR
19248 =item SEE ALSO
19250 =item COPYRIGHT
19252 =back
19254 =head2 Pod::InputObjects - objects representing POD input paragraphs,
19255 commands, etc.
19257 =over 4
19259 =item SYNOPSIS
19261 =item REQUIRES
19263 =item EXPORTS
19265 =item DESCRIPTION
19267 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
19268 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
19270 =back
19272 =over 4
19274 =item B<Pod::InputSource>
19276 =back
19278 =over 4
19280 =item B<new()>
19282 =back
19284 =over 4
19286 =item B<name()>
19288 =back
19290 =over 4
19292 =item B<handle()>
19294 =back
19296 =over 4
19298 =item B<was_cutting()>
19300 =back
19302 =over 4
19304 =item B<Pod::Paragraph>
19306 =back
19308 =over 4
19310 =item Pod::Paragraph-E<gt>B<new()>
19312 =back
19314 =over 4
19316 =item $pod_para-E<gt>B<cmd_name()>
19318 =back
19320 =over 4
19322 =item $pod_para-E<gt>B<text()>
19324 =back
19326 =over 4
19328 =item $pod_para-E<gt>B<raw_text()>
19330 =back
19332 =over 4
19334 =item $pod_para-E<gt>B<cmd_prefix()>
19336 =back
19338 =over 4
19340 =item $pod_para-E<gt>B<cmd_separator()>
19342 =back
19344 =over 4
19346 =item $pod_para-E<gt>B<parse_tree()>
19348 =back
19350 =over 4
19352 =item $pod_para-E<gt>B<file_line()>
19354 =back
19356 =over 4
19358 =item B<Pod::InteriorSequence>
19360 =back
19362 =over 4
19364 =item Pod::InteriorSequence-E<gt>B<new()>
19366 =back
19368 =over 4
19370 =item $pod_seq-E<gt>B<cmd_name()>
19372 =back
19374 =over 4
19376 =item $pod_seq-E<gt>B<prepend()>
19378 =back
19380 =over 4
19382 =item $pod_seq-E<gt>B<append()>
19384 =back
19386 =over 4
19388 =item $pod_seq-E<gt>B<nested()>
19390 =back
19392 =over 4
19394 =item $pod_seq-E<gt>B<raw_text()>
19396 =back
19398 =over 4
19400 =item $pod_seq-E<gt>B<left_delimiter()>
19402 =back
19404 =over 4
19406 =item $pod_seq-E<gt>B<right_delimiter()>
19408 =back
19410 =over 4
19412 =item $pod_seq-E<gt>B<parse_tree()>
19414 =back
19416 =over 4
19418 =item $pod_seq-E<gt>B<file_line()>
19420 =back
19422 =over 4
19424 =item Pod::InteriorSequence::B<DESTROY()>
19426 =back
19428 =over 4
19430 =item B<Pod::ParseTree>
19432 =back
19434 =over 4
19436 =item Pod::ParseTree-E<gt>B<new()>
19438 =back
19440 =over 4
19442 =item $ptree-E<gt>B<top()>
19444 =back
19446 =over 4
19448 =item $ptree-E<gt>B<children()>
19450 =back
19452 =over 4
19454 =item $ptree-E<gt>B<prepend()>
19456 =back
19458 =over 4
19460 =item $ptree-E<gt>B<append()>
19462 =back
19464 =over 4
19466 =item $ptree-E<gt>B<raw_text()>
19468 =back
19470 =over 4
19472 =item Pod::ParseTree::B<DESTROY()>
19474 =back
19476 =over 4
19478 =item SEE ALSO
19480 =item AUTHOR
19482 =back
19484 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
19486 =over 4
19488 =item SYNOPSIS
19490 =item DESCRIPTION
19492 =back
19494 =over 4
19496 =item OBJECT METHODS
19498 C<initialize>
19500 =back
19502 =over 4
19504 =item Data Accessors
19506 B<AddPreamble>
19508 =back
19510 B<AddPostamble>
19512 B<Head1Level>
19514 B<Label>
19516 B<LevelNoNum>
19518 B<MakeIndex>
19520 B<ReplaceNAMEwithSection>
19522 B<StartWithNewPage>
19524 B<TableOfContents>
19526 B<UniqueLabels>
19528 B<UserPreamble>
19530 B<UserPostamble>
19532 B<Lists>
19534 =over 4
19536 =item Subclassed methods
19538 =back
19540 B<begin_pod>
19542 B<end_pod>
19544 B<command>
19546 B<verbatim>
19548 B<textblock>
19550 B<interior_sequence>
19552 =over 4
19554 =item List Methods
19556 B<begin_list>
19558 =back
19560 B<end_list>
19562 B<add_item>
19564 =over 4
19566 =item Methods for headings
19568 B<head>
19570 =back
19572 =over 4
19574 =item Internal methods
19576 B<_output>
19578 =back
19580 B<_replace_special_chars>
19582 B<_replace_special_chars_late>
19584 B<_create_label>
19586 B<_create_index>
19588 B<_clean_latex_commands>
19590 B<_split_delimited>
19592 =over 4
19594 =item NOTES
19596 =item SEE ALSO
19598 =item AUTHORS
19600 =item COPYRIGHT
19602 =item REVISION
19604 =back
19606 =head2 Pod::Man - Convert POD data to formatted *roff input
19608 =over 4
19610 =item SYNOPSIS
19612 =item DESCRIPTION
19614 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
19615 release, section
19617 =item DIAGNOSTICS
19619 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
19620 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
19621 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
19622 =back
19624 =item BUGS
19626 =item CAVEATS
19628 =item SEE ALSO
19630 =item AUTHOR
19632 =item COPYRIGHT AND LICENSE
19634 =back
19636 =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
19638 =over 4
19640 =item SYNOPSIS
19642 =item DESCRIPTION
19644 =item SEE ALSO
19646 =item AUTHOR
19648 =item COPYRIGHT AND LICENSE
19650 =back
19652 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
19654 =over 4
19656 =item SYNOPSIS
19658 =item DESCRIPTION
19660 =back
19662 =over 4
19664 =item Pod::List
19666 Pod::List-E<gt>new()
19668 =back
19670 $list-E<gt>file()
19672 $list-E<gt>start()
19674 $list-E<gt>indent()
19676 $list-E<gt>type()
19678 $list-E<gt>rx()
19680 $list-E<gt>item()
19682 $list-E<gt>parent()
19684 $list-E<gt>tag()
19686 =over 4
19688 =item Pod::Hyperlink
19690 Pod::Hyperlink-E<gt>new()
19692 =back
19694 $link-E<gt>parse($string)
19696 $link-E<gt>markup($string)
19698 $link-E<gt>text()
19700 $link-E<gt>warning()
19702 $link-E<gt>file(), $link-E<gt>line()
19704 $link-E<gt>page()
19706 $link-E<gt>node()
19708 $link-E<gt>alttext()
19710 $link-E<gt>type()
19712 $link-E<gt>link()
19714 =over 4
19716 =item Pod::Cache
19718 Pod::Cache-E<gt>new()
19720 =back
19722 $cache-E<gt>item()
19724 $cache-E<gt>find_page($name)
19726 =over 4
19728 =item Pod::Cache::Item
19730 Pod::Cache::Item-E<gt>new()
19732 =back
19734 $cacheitem-E<gt>page()
19736 $cacheitem-E<gt>description()
19738 $cacheitem-E<gt>path()
19740 $cacheitem-E<gt>file()
19742 $cacheitem-E<gt>nodes()
19744 $cacheitem-E<gt>find_node($name)
19746 $cacheitem-E<gt>idx()
19748 =over 4
19750 =item AUTHOR
19752 =item SEE ALSO
19754 =back
19756 =head2 Pod::Parser - base class for creating POD filters and translators
19758 =over 4
19760 =item SYNOPSIS
19762 =item REQUIRES
19764 =item EXPORTS
19766 =item DESCRIPTION
19768 =item QUICK OVERVIEW
19770 =item PARSING OPTIONS
19772 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
19773 B<-warnings> (default: unset)
19775 =back
19777 =over 4
19779 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
19781 =back
19783 =over 4
19785 =item B<command()>
19787 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
19789 =back
19791 =over 4
19793 =item B<verbatim()>
19795 C<$text>, C<$line_num>, C<$pod_para>
19797 =back
19799 =over 4
19801 =item B<textblock()>
19803 C<$text>, C<$line_num>, C<$pod_para>
19805 =back
19807 =over 4
19809 =item B<interior_sequence()>
19811 =back
19813 =over 4
19815 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
19817 =back
19819 =over 4
19821 =item B<new()>
19823 =back
19825 =over 4
19827 =item B<initialize()>
19829 =back
19831 =over 4
19833 =item B<begin_pod()>
19835 =back
19837 =over 4
19839 =item B<begin_input()>
19841 =back
19843 =over 4
19845 =item B<end_input()>
19847 =back
19849 =over 4
19851 =item B<end_pod()>
19853 =back
19855 =over 4
19857 =item B<preprocess_line()>
19859 =back
19861 =over 4
19863 =item B<preprocess_paragraph()>
19865 =back
19867 =over 4
19869 =item METHODS FOR PARSING AND PROCESSING
19871 =back
19873 =over 4
19875 =item B<parse_text()>
19877 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
19878 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
19879 I<code-ref>|I<method-name>
19881 =back
19883 =over 4
19885 =item B<interpolate()>
19887 =back
19889 =over 4
19891 =item B<parse_paragraph()>
19893 =back
19895 =over 4
19897 =item B<parse_from_filehandle()>
19899 =back
19901 =over 4
19903 =item B<parse_from_file()>
19905 =back
19907 =over 4
19909 =item ACCESSOR METHODS
19911 =back
19913 =over 4
19915 =item B<errorsub()>
19917 =back
19919 =over 4
19921 =item B<cutting()>
19923 =back
19925 =over 4
19927 =item B<parseopts()>
19929 =back
19931 =over 4
19933 =item B<output_file()>
19935 =back
19937 =over 4
19939 =item B<output_handle()>
19941 =back
19943 =over 4
19945 =item B<input_file()>
19947 =back
19949 =over 4
19951 =item B<input_handle()>
19953 =back
19955 =over 4
19957 =item B<input_streams()>
19959 =back
19961 =over 4
19963 =item B<top_stream()>
19965 =back
19967 =over 4
19969 =item PRIVATE METHODS AND DATA
19971 =back
19973 =over 4
19975 =item B<_push_input_stream()>
19977 =back
19979 =over 4
19981 =item B<_pop_input_stream()>
19983 =back
19985 =over 4
19987 =item TREE-BASED PARSING
19989 =item SEE ALSO
19991 =item AUTHOR
19993 =back
19995 =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors
19997 =over 4
19999 =item SYNOPSIS
20001 =item DESCRIPTION
20003 =item SEE ALSO
20005 =item COPYRIGHT AND DISCLAIMERS
20007 =item AUTHOR
20009 =back
20011 =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages
20013 =over 4
20015 =item SYNOPSIS
20017 =item DESCRIPTION
20019 =item CAVEAT
20021 =item SEE ALSO
20023 =item COPYRIGHT AND DISCLAIMERS
20025 =item AUTHOR
20027 =back
20029 =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff
20031 =over 4
20033 =item SYNOPSIS
20035 =item DESCRIPTION
20037 =item CAVEAT
20039 =item SEE ALSO
20041 =item COPYRIGHT AND DISCLAIMERS
20043 =item AUTHOR
20045 =back
20047 =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod!
20049 =over 4
20051 =item SYNOPSIS
20053 =item DESCRIPTION
20055 =item SEE ALSO
20057 =item COPYRIGHT AND DISCLAIMERS
20059 =item AUTHOR
20061 =back
20063 =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF
20065 =over 4
20067 =item SYNOPSIS
20069 =item DESCRIPTION
20071 =item SEE ALSO
20073 =item COPYRIGHT AND DISCLAIMERS
20075 =item AUTHOR
20077 =back
20079 =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext
20081 =over 4
20083 =item SYNOPSIS
20085 =item DESCRIPTION
20087 =item CAVEAT
20089 =item SEE ALSO
20091 =item COPYRIGHT AND DISCLAIMERS
20093 =item AUTHOR
20095 =back
20097 =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod
20099 =over 4
20101 =item SYNOPSIS
20103 =item DESCRIPTION
20105 =item SEE ALSO
20107 =item AUTHOR
20109 =back
20111 =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML
20113 =over 4
20115 =item SYNOPSIS
20117 =item DESCRIPTION
20119 =item SEE ALSO
20121 =item COPYRIGHT AND DISCLAIMERS
20123 =item AUTHOR
20125 =back
20127 =head2 Pod::PlainText - Convert POD data to formatted ASCII text
20129 =over 4
20131 =item SYNOPSIS
20133 =item DESCRIPTION
20135 alt, indent, loose, sentence, width
20137 =item DIAGNOSTICS
20139 Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
20140 Unknown sequence: %s, Unmatched =back
20142 =item RESTRICTIONS
20144 =item NOTES
20146 =item SEE ALSO
20148 =item AUTHOR
20150 =back
20152 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
20154 =over 4
20156 =item SYNOPSIS
20158 =item DESCRIPTION
20160 =over 4
20162 =item EXPORT
20164 =back
20166 =item AUTHOR
20168 =item SEE ALSO
20170 =back
20172 =head2 Pod::Select, podselect() - extract selected sections of POD from
20173 input
20175 =over 4
20177 =item SYNOPSIS
20179 =item REQUIRES
20181 =item EXPORTS
20183 =item DESCRIPTION
20185 =item SECTION SPECIFICATIONS
20187 =item RANGE SPECIFICATIONS
20189 =back
20191 =over 4
20193 =item OBJECT METHODS
20195 =back
20197 =over 4
20199 =item B<curr_headings()>
20201 =back
20203 =over 4
20205 =item B<select()>
20207 =back
20209 =over 4
20211 =item B<add_selection()>
20213 =back
20215 =over 4
20217 =item B<clear_selections()>
20219 =back
20221 =over 4
20223 =item B<match_section()>
20225 =back
20227 =over 4
20229 =item B<is_selected()>
20231 =back
20233 =over 4
20235 =item EXPORTED FUNCTIONS
20237 =back
20239 =over 4
20241 =item B<podselect()>
20243 B<-output>, B<-sections>, B<-ranges>
20245 =back
20247 =over 4
20249 =item PRIVATE METHODS AND DATA
20251 =back
20253 =over 4
20255 =item B<_compile_section_spec()>
20257 =back
20259 =over 4
20261 =item $self->{_SECTION_HEADINGS}
20263 =back
20265 =over 4
20267 =item $self->{_SELECTED_SECTIONS}
20269 =back
20271 =over 4
20273 =item SEE ALSO
20275 =item AUTHOR
20277 =back
20279 =head2 Pod::Text - Convert POD data to formatted ASCII text
20281 =over 4
20283 =item SYNOPSIS
20285 =item DESCRIPTION
20287 alt, code, indent, loose, margin, quotes, sentence, width
20289 =item DIAGNOSTICS
20291 Bizarre space in item, Item called without tag, Can't open %s for reading:
20292 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
20293 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
20294 Unmatched =back
20296 =item RESTRICTIONS
20298 =item NOTES
20300 =item SEE ALSO
20302 =item AUTHOR
20304 =item COPYRIGHT AND LICENSE
20306 =back
20308 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
20310 =over 4
20312 =item SYNOPSIS
20314 =item DESCRIPTION
20316 =item BUGS
20318 =item SEE ALSO
20320 =item AUTHOR
20322 =item COPYRIGHT AND LICENSE
20324 =back
20326 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
20327 text
20329 =over 4
20331 =item SYNOPSIS
20333 =item DESCRIPTION
20335 =item BUGS
20337 =item SEE ALSO
20339 =item AUTHOR
20341 =item COPYRIGHT AND LICENSE
20343 =back
20345 =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
20346 escapes
20348 =over 4
20350 =item SYNOPSIS
20352 =item DESCRIPTION
20354 =item NOTES
20356 =item SEE ALSO
20358 =item AUTHOR
20360 =item COPYRIGHT AND LICENSE
20362 =back
20364 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
20365 documentation
20367 =over 4
20369 =item SYNOPSIS
20371 =item ARGUMENTS
20373 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-section>, C<-output>,
20374 C<-input>, C<-pathlist>, C<-noperldoc>
20376 =item DESCRIPTION
20378 =item EXAMPLES
20380 =over 4
20382 =item Recommended Use
20384 =back
20386 =item CAVEATS
20388 =item AUTHOR
20390 =item ACKNOWLEDGEMENTS
20392 =back
20394 =head2 SDBM_File - Tied access to sdbm files
20396 =over 4
20398 =item SYNOPSIS
20400 =item DESCRIPTION
20402 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
20404 =item DIAGNOSTICS
20406 =over 4
20408 =item C<sdbm store returned -1, errno 22, key "..." at ...>
20410 =back
20412 =item BUGS AND WARNINGS
20414 =back
20416 =head2 Safe - Compile and execute code in restricted compartments
20418 =over 4
20420 =item SYNOPSIS
20422 =item DESCRIPTION
20424 a new namespace, an operator mask
20426 =item WARNING
20428 =over 4
20430 =item RECENT CHANGES
20432 =item Methods in class Safe
20434 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
20435 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
20436 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
20437 root (NAMESPACE), mask (MASK)
20439 =item Some Safety Issues
20441 Memory, CPU, Snooping, Signals, State Changes
20443 =item AUTHOR
20445 =back
20447 =back
20449 =head2 Scalar::Util - A selection of general-utility scalar subroutines
20451 =over 4
20453 =item SYNOPSIS
20455 =item DESCRIPTION
20457 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
20458 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
20459 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
20461 =item KNOWN BUGS
20463 =item COPYRIGHT
20465 =item BLATANT PLUG
20467 =back
20469 =head2 Search::Dict, look - search for key in dictionary file
20471 =over 4
20473 =item SYNOPSIS
20475 =item DESCRIPTION
20477 =back
20479 =head2 SelectSaver - save and restore selected file handle
20481 =over 4
20483 =item SYNOPSIS
20485 =item DESCRIPTION
20487 =back
20489 =head2 SelfLoader - load functions only on demand
20491 =over 4
20493 =item SYNOPSIS
20495 =item DESCRIPTION
20497 =over 4
20499 =item The __DATA__ token
20501 =item SelfLoader autoloading
20503 =item Autoloading and package lexicals
20505 =item SelfLoader and AutoLoader
20507 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
20509 =item Classes and inherited methods.
20511 =back
20513 =item Multiple packages and fully qualified subroutine names
20515 =back
20517 =head2 Shell - run shell commands transparently within perl
20519 =over 4
20521 =item SYNOPSIS
20523 =item DESCRIPTION
20525 =over 4
20527 =item Caveats
20529 =item Escaping Magic Characters
20531 =item Configuration
20533 =back
20535 =item BUGS
20537 =item AUTHOR
20539 =back
20541 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
20542 socket.h defines and structure manipulators 
20544 =over 4
20546 =item SYNOPSIS
20548 =item DESCRIPTION
20550 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
20551 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
20552 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
20553 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
20554 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
20556 =back
20558 =head2 Storable - persistence for Perl data structures
20560 =over 4
20562 =item SYNOPSIS
20564 =item DESCRIPTION
20566 =item MEMORY STORE
20568 =item ADVISORY LOCKING
20570 =item SPEED
20572 =item CANONICAL REPRESENTATION
20574 =item CODE REFERENCES
20576 =item FORWARD COMPATIBILITY
20578 utf8 data, restricted hashes, files from future versions of Storable
20580 =item ERROR REPORTING
20582 =item WIZARDS ONLY
20584 =over 4
20586 =item Hooks
20588 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
20589 I<serialized>, .., C<STORABLE_attach> I<class>, I<cloning>, I<serialized>
20591 =item Predicates
20593 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
20594 C<Storable::is_retrieving>
20596 =item Recursion
20598 =item Deep Cloning
20600 =back
20602 =item Storable magic
20604 =item EXAMPLES
20606 =item WARNING
20608 =item BUGS
20610 =over 4
20612 =item 64 bit data in perl 5.6.0 and 5.6.1
20614 =back
20616 =item CREDITS
20618 =item AUTHOR
20620 =item SEE ALSO
20622 =back
20624 =head2 Switch - A switch statement for Perl
20626 =over 4
20628 =item VERSION
20630 =item SYNOPSIS
20632 =item BACKGROUND
20634 =item DESCRIPTION
20636 =over 4
20638 =item Allowing fall-through
20640 =item Automating fall-through
20642 =item Alternative syntax
20644 =item Higher-order Operations
20646 =back
20648 =item DEPENDENCIES
20650 =item AUTHOR
20652 =item BUGS
20654 =item LIMITATIONS
20656 =item COPYRIGHT
20658 =back
20660 =head2 Symbol - manipulate Perl symbols and their names
20662 =over 4
20664 =item SYNOPSIS
20666 =item DESCRIPTION
20668 =item BUGS
20670 =back
20672 =head2 Sys::Hostname - Try every conceivable way to get hostname
20674 =over 4
20676 =item SYNOPSIS
20678 =item DESCRIPTION
20680 =item AUTHOR
20682 =back
20684 =head2 Syslog, Sys::Syslog - Perl interface to the UNIX syslog(3) calls
20686 =over 4
20688 =item VERSION
20690 =item SYNOPSIS
20692 =item DESCRIPTION
20694 =item EXPORTS
20696 =item FUNCTIONS
20698 B<openlog($ident, $logopt, $facility)>, B<syslog($priority, $message)>,
20699 B<syslog($priority, $format, @args)>, B<Note>,
20700 B<setlogmask($mask_priority)>, B<setlogsock($sock_type)>,
20701 B<setlogsock($sock_type, $stream_location)> (added in 5.004_02),
20702 B<closelog()>
20704 =item EXAMPLES
20706 =item CONSTANTS
20708 =over 4
20710 =item Facilities
20712 =item Levels
20714 =back
20716 =item DIAGNOSTICS
20718 Invalid argument passed to setlogsock, no connection to syslog available,
20719 stream passed to setlogsock, but %s is not writable, stream passed to
20720 setlogsock, but could not find any device, tcp passed to setlogsock, but
20721 tcp service unavailable, syslog: expecting argument %s, syslog: invalid
20722 level/facility: %s, syslog: too many levels given: %s, syslog: too many
20723 facilities given: %s, syslog: level must be given, udp passed to
20724 setlogsock, but udp service unavailable, unix passed to setlogsock, but
20725 path not available
20727 =item SEE ALSO
20729 =item AUTHOR
20731 =item BUGS
20733 =item SUPPORT
20735 AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request
20736 tracker, Search CPAN
20738 =item LICENSE
20740 =back
20742 =head2 Syslog::Syslog, Sys::Syslog - Perl interface to the UNIX syslog(3)
20743 calls
20745 =over 4
20747 =item VERSION
20749 =item SYNOPSIS
20751 =item DESCRIPTION
20753 =item EXPORTS
20755 =item FUNCTIONS
20757 B<openlog($ident, $logopt, $facility)>, B<syslog($priority, $message)>,
20758 B<syslog($priority, $format, @args)>, B<Note>,
20759 B<setlogmask($mask_priority)>, B<setlogsock($sock_type)>,
20760 B<setlogsock($sock_type, $stream_location)> (added in 5.004_02),
20761 B<closelog()>
20763 =item EXAMPLES
20765 =item CONSTANTS
20767 =over 4
20769 =item Facilities
20771 =item Levels
20773 =back
20775 =item DIAGNOSTICS
20777 Invalid argument passed to setlogsock, no connection to syslog available,
20778 stream passed to setlogsock, but %s is not writable, stream passed to
20779 setlogsock, but could not find any device, tcp passed to setlogsock, but
20780 tcp service unavailable, syslog: expecting argument %s, syslog: invalid
20781 level/facility: %s, syslog: too many levels given: %s, syslog: too many
20782 facilities given: %s, syslog: level must be given, udp passed to
20783 setlogsock, but udp service unavailable, unix passed to setlogsock, but
20784 path not available
20786 =item SEE ALSO
20788 =item AUTHOR
20790 =item BUGS
20792 =item SUPPORT
20794 AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request
20795 tracker, Search CPAN
20797 =item LICENSE
20799 =back
20801 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
20803 =over 4
20805 =item SYNOPSIS
20807 =item DESCRIPTION
20809 =item DIAGNOSTICS
20811 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
20812 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
20813 comma allowed after filehandle, No name for escape sequence %s
20815 =item ENVIRONMENT
20817 ANSI_COLORS_DISABLED
20819 =item RESTRICTIONS
20821 =item NOTES
20823 =item SEE ALSO
20825 =item AUTHORS
20827 =item COPYRIGHT AND LICENSE
20829 =back
20831 =head2 Term::Cap - Perl termcap interface
20833 =over 4
20835 =item SYNOPSIS
20837 =item DESCRIPTION
20839 =over 4
20841 =item METHODS
20843 =back
20845 =back
20847 B<Tgetent>, OSPEED, TERM
20849 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
20851 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
20853 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
20855 B<Trequire>
20857 =over 4
20859 =item EXAMPLES
20861 =item COPYRIGHT AND LICENSE
20863 =item AUTHOR
20865 =item SEE ALSO
20867 =back
20869 =head2 Term::Complete - Perl word completion module
20871 =over 4
20873 =item SYNOPSIS
20875 =item DESCRIPTION
20877 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
20879 =item DIAGNOSTICS
20881 =item BUGS
20883 =item AUTHOR
20885 =back
20887 =head2 Term::ReadLine - Perl interface to various C<readline> packages.
20888 If no real package is found, substitutes stubs instead of basic functions.
20890 =over 4
20892 =item SYNOPSIS
20894 =item DESCRIPTION
20896 =item Minimal set of supported functions
20898 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>,
20899 C<findConsole>, Attribs, C<Features>
20901 =item Additional supported functions
20903 C<tkRunning>, C<ornaments>, C<newTTY>
20905 =item EXPORTS
20907 =item ENVIRONMENT
20909 =item CAVEATS
20911 =back
20913 =head2 Test - provides a simple framework for writing test scripts
20915 =over 4
20917 =item SYNOPSIS
20919 =item DESCRIPTION
20921 =item QUICK START GUIDE
20923 =over 4
20925 =item Functions
20927 C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>,
20928 C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub>
20930 =back
20932 =back
20934 B<_to_value>
20936 C<ok(...)>
20938 C<skip(I<skip_if_true>, I<args...>)>
20940 =over 4
20942 =item TEST TYPES
20944 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
20946 =item ONFAIL
20948 =item BUGS and CAVEATS
20950 =item ENVIRONMENT
20952 =item NOTE
20954 =item SEE ALSO
20956 =item AUTHOR
20958 =back
20960 =head2 Test::Builder - Backend for building test libraries
20962 =over 4
20964 =item SYNOPSIS
20966 =item DESCRIPTION
20968 =over 4
20970 =item Construction
20972 B<new>
20974 =back
20976 =back
20978 B<create>
20980 B<reset>
20982 =over 4
20984 =item Setting up tests
20986 B<exported_to>
20988 =back
20990 B<plan>
20992 B<expected_tests>
20994 B<no_plan>
20996 B<has_plan>
20998 B<skip_all>
21000 =over 4
21002 =item Running tests
21004 B<ok>
21006 =back
21008 B<is_eq>, B<is_num>
21010 B<isnt_eq>, B<isnt_num>
21012 B<like>, B<unlike>
21014 B<maybe_regex>
21016 B<cmp_ok>
21018 B<BAIL_OUT>
21020 B<skip>
21022 B<todo_skip>
21024 B<skip_rest>
21026 =over 4
21028 =item Test style
21030 B<level>
21032 =back
21034 B<use_numbers>
21036 B<no_diag>, B<no_ending>, B<no_header>
21038 =over 4
21040 =item Output
21042 B<diag>
21044 =back
21046 B<_print>
21048 B<_print_diag>
21050 B<output>, B<failure_output>, B<todo_output>
21052 =over 4
21054 =item Test Status and Info
21056 B<current_test>
21058 =back
21060 B<summary>
21062 B<details>
21064 B<todo>
21066 B<caller>
21068 B<_sanity_check>
21070 B<_whoa>
21072 B<_my_exit>
21074 =over 4
21076 =item EXIT CODES
21078 =item THREADS
21080 =item EXAMPLES
21082 =item SEE ALSO
21084 =item AUTHORS
21086 =item COPYRIGHT
21088 =back
21090 =head2 Test::Builder::Module - Base class for test modules
21092 =over 4
21094 =item SYNOPSIS
21096 =item DESCRIPTION
21098 =over 4
21100 =item Importing
21102 =back
21104 =back
21106 =over 4
21108 =item Builder
21110 =back
21112 =head2 Test::Builder::Tester - test testsuites that have been built with
21113 Test::Builder
21115 =over 4
21117 =item SYNOPSIS
21119 =item DESCRIPTION
21121 =back
21123 =over 4
21125 =item Methods
21127 test_out, test_err
21129 =back
21131 test_fail
21133 test_diag
21135 test_test, title (synonym 'name', 'label'), skip_out, skip_err
21137 line_num
21139 color
21141 =over 4
21143 =item BUGS
21145 =item AUTHOR
21147 =item NOTES
21149 =item SEE ALSO
21151 =back
21153 =head2 Test::Builder::Tester::Color - turn on colour in
21154 Test::Builder::Tester
21156 =over 4
21158 =item SYNOPSIS
21160 =item DESCRIPTION
21162 =back
21164 =over 4
21166 =item AUTHOR
21168 =item BUGS
21170 =item SEE ALSO
21172 =back
21174 =head2 Test::Harness - Run Perl standard test scripts with statistics
21176 =over 4
21178 =item VERSION
21180 =back
21182 =over 4
21184 =item SYNOPSIS
21186 =item DESCRIPTION
21188 =over 4
21190 =item Taint mode
21192 =item Configuration variables.
21194 C<$Test::Harness::Verbose>, C<$Test::Harness::switches>,
21195 C<$Test::Harness::Timer>
21197 =item Failure
21199 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
21200 Failed>
21202 =item Functions
21204 B<runtests>
21206 =back
21208 =back
21210 B<_all_ok>
21212 B<_globdir>
21214 B<_run_all_tests>
21216 B<_mk_leader>
21218 B<_leader_width>
21220 =over 4
21222 =item EXPORT
21224 =item DIAGNOSTICS
21226 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
21227 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
21228 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
21229 %s>, C<FAILED--Further testing stopped: %s>
21231 =item ENVIRONMENT VARIABLES THAT TEST::HARNESS SETS
21233 C<HARNESS_ACTIVE>, C<HARNESS_VERSION>
21235 =item ENVIRONMENT VARIABLES THAT AFFECT TEST::HARNESS
21237 C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>, C<HARNESS_DEBUG>,
21238 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
21239 C<HARNESS_PERL>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
21241 =item EXAMPLE
21243 =item SEE ALSO
21245 =item TODO
21247 =item BUGS
21249 =item AUTHORS
21251 =item COPYRIGHT
21253 =back
21255 =head2 Test::Harness::Assert - simple assert
21257 =over 4
21259 =item SYNOPSIS
21261 =item DESCRIPTION
21263 =item FUNCTIONS
21265 =over 4
21267 =item C<assert()>
21269 =back
21271 =back
21273 =over 4
21275 =item AUTHOR
21277 =item SEE ALSO
21279 =back
21281 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
21283 =over 4
21285 =item SYNOPSIS
21287 =item DESCRIPTION
21289 =over 4
21291 =item new()
21293 =item next()
21295 =back
21297 =back
21299 =head2 Test::Harness::Point - object for tracking a single test point
21301 =over 4
21303 =item SYNOPSIS
21305 =item CONSTRUCTION
21307 =over 4
21309 =item new()
21311 =back
21313 =back
21315 =over 4
21317 =item from_test_line( $line )
21319 =back
21321 =over 4
21323 =item ACCESSORS
21325 ok, number
21327 =back
21329 =head2 Test::Harness::Straps - detailed analysis of test results
21331 =over 4
21333 =item SYNOPSIS
21335 =item DESCRIPTION
21337 =item CONSTRUCTION
21339 =over 4
21341 =item new()
21343 =back
21345 =back
21347 =over 4
21349 =item $strap->_init
21351 =back
21353 =over 4
21355 =item ANALYSIS
21357 =over 4
21359 =item $strap->analyze( $name, \@output_lines )
21361 =back
21363 =back
21365 =over 4
21367 =item $strap->analyze_fh( $name, $test_filehandle )
21369 =back
21371 =over 4
21373 =item $strap->analyze_file( $test_file )
21375 =back
21377 =over 4
21379 =item $strap->_command_line( $file )
21381 =back
21383 =over 4
21385 =item $strap->_command()
21387 =back
21389 =over 4
21391 =item $strap->_switches( $file )
21393 =back
21395 =over 4
21397 =item $strap->_cleaned_switches( @switches_from_user )
21399 =back
21401 =over 4
21403 =item $strap->_INC2PERL5LIB
21405 =back
21407 =over 4
21409 =item $strap->_filtered_INC()
21411 =back
21413 =over 4
21415 =item $strap->_restore_PERL5LIB()
21417 =back
21419 =over 4
21421 =item Parsing
21423 =over 4
21425 =item C<_is_diagnostic>
21427 =back
21429 =back
21431 =over 4
21433 =item C<_is_header>
21435 =back
21437 =over 4
21439 =item C<_is_bail_out>
21441 =back
21443 =over 4
21445 =item C<_reset_file_state>
21447 =back
21449 =over 4
21451 =item Results
21453 =item EXAMPLES
21455 =item AUTHOR
21457 =item SEE ALSO
21459 =back
21461 =head2 Test::Harness::TAP - Documentation for the TAP format
21463 =over 4
21465 =item SYNOPSIS
21467 =item TODO
21469 =item THE TAP FORMAT
21471 =item HARNESS BEHAVIOR
21473 =item TESTS LINES AND THE PLAN
21475 =over 4
21477 =item The plan
21479 =item The test line
21481 C<ok> or C<not ok>, Test number, Description, Directive, ok/not ok
21482 (required), Test number (recommended), Description (recommended), Directive
21483 (only when necessary)
21485 =back
21487 =item DIRECTIVES
21489 =over 4
21491 =item TODO tests
21493 =item Skipping tests
21495 =back
21497 =item OTHER LINES
21499 =over 4
21501 =item Bail out!
21503 =item Diagnostics
21505 =item Anything else
21507 =back
21509 =item EXAMPLES
21511 =over 4
21513 =item Common with explanation
21515 =item Unknown amount and failures
21517 =item Giving up
21519 =item Skipping a few
21521 =item Skipping everything
21523 =item Got spare tuits?
21525 =item Creative liberties
21527 =back
21529 =item AUTHORS
21531 =item ACKNOWLEDGEMENTS
21533 =item COPYRIGHT
21535 =back
21537 =head2 Test::More - yet another framework for writing test scripts
21539 =over 4
21541 =item SYNOPSIS
21543 =item DESCRIPTION
21545 =over 4
21547 =item I love it when a plan comes together
21549 =back
21551 =back
21553 =over 4
21555 =item Test names
21557 =item I'm ok, you're not ok.
21559 B<ok>
21561 =back
21563 B<is>, B<isnt>
21565 B<like>
21567 B<unlike>
21569 B<cmp_ok>
21571 B<can_ok>
21573 B<isa_ok>
21575 B<pass>, B<fail>
21577 =over 4
21579 =item Module tests
21581 B<use_ok>
21583 =back
21585 B<require_ok>
21587 =over 4
21589 =item Complex data structures
21591 B<is_deeply>
21593 =back
21595 =over 4
21597 =item Diagnostics
21599 B<diag>
21601 =back
21603 =over 4
21605 =item Conditional tests
21607 B<SKIP: BLOCK>
21609 =back
21611 B<TODO: BLOCK>, B<todo_skip>
21613 When do I use SKIP vs. TODO?
21615 =over 4
21617 =item Test control
21619 B<BAIL_OUT>
21621 =back
21623 =over 4
21625 =item Discouraged comparison functions
21627 B<eq_array>
21629 =back
21631 B<eq_hash>
21633 B<eq_set>
21635 =over 4
21637 =item Extending and Embedding Test::More
21639 B<builder>
21641 =back
21643 =over 4
21645 =item EXIT CODES
21647 =item CAVEATS and NOTES
21649 Backwards compatibility, Overloaded objects, Threads, Test::Harness upgrade
21651 =item HISTORY
21653 =item SEE ALSO
21655 =item AUTHORS
21657 =item BUGS
21659 =item COPYRIGHT
21661 =back
21663 =head2 Test::Simple - Basic utilities for writing tests.
21665 =over 4
21667 =item SYNOPSIS
21669 =item DESCRIPTION
21671 B<ok>
21673 =back
21675 =over 4
21677 =item EXAMPLE
21679 =item CAVEATS
21681 =item NOTES
21683 =item HISTORY
21685 =item SEE ALSO
21687 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
21688 L<Test::Harness>
21690 =item AUTHORS
21692 =item COPYRIGHT
21694 =back
21696 =head2 Test::Tutorial - A tutorial about writing really basic tests
21698 =over 4
21700 =item DESCRIPTION
21702 =over 4
21704 =item Nuts and bolts of testing.
21706 =item Where to start?
21708 =item Names
21710 =item Test the manual
21712 =item Sometimes the tests are wrong
21714 =item Testing lots of values
21716 =item Informative names
21718 =item Skipping tests
21720 =item Todo tests
21722 =item Testing with taint mode.
21724 =back
21726 =item FOOTNOTES
21728 =item AUTHORS
21730 =item COPYRIGHT
21732 =back
21734 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
21736 =over 4
21738 =item SYNOPSIS
21740 =item DESCRIPTION
21742 =item EXAMPLE
21744 =back
21746 =head2 Text::Balanced - Extract delimited text sequences from strings.
21748 =over 4
21750 =item SYNOPSIS
21752 =item DESCRIPTION
21754 =over 4
21756 =item General behaviour in list contexts
21758 [0], [1], [2]
21760 =item General behaviour in scalar and void contexts
21762 =item A note about prefixes
21764 =item C<extract_delimited>
21766 =item C<extract_bracketed>
21768 =item C<extract_variable>
21770 [0], [1], [2]
21772 =item C<extract_tagged>
21774 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
21775 [0], [1], [2], [3], [4], [5]
21777 =item C<gen_extract_tagged>
21779 =item C<extract_quotelike>
21781 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
21783 =item C<extract_quotelike> and "here documents"
21785 [0], [1], [2], [3], [4], [5], [6], [7..10]
21787 =item C<extract_codeblock>
21789 =item C<extract_multiple>
21791 =item C<gen_delimited_pat>
21793 =back
21795 =item DIAGNOSTICS
21797  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>, 
21798 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
21799 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">, 
21800 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
21801 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
21802 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
21803 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
21804 after dereferencer>, C<Did not find expected opening bracket at %s>,
21805 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
21806 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
21807 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
21808 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
21809 tag>
21811 =item AUTHOR
21813 =item BUGS AND IRRITATIONS
21815 =item COPYRIGHT
21817 =back
21819 =head2 Text::ParseWords - parse text into an array of tokens or array of
21820 arrays
21822 =over 4
21824 =item SYNOPSIS
21826 =item DESCRIPTION
21828 =item EXAMPLES
21830 =item AUTHORS
21832 =back
21834 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
21835 by Knuth
21837 =over 4
21839 =item SYNOPSIS
21841 =item DESCRIPTION
21843 =item EXAMPLES
21845 =item LIMITATIONS
21847 =item AUTHOR
21849 =back
21851 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
21852 unexpand(1)
21854 =over 4
21856 =item SYNOPSIS
21858 =item DESCRIPTION
21860 =item BUGS
21862 =item LICENSE
21864 =back
21866 =head2 Text::Wrap - line wrapping to form simple paragraphs
21868 =over 4
21870 =item SYNOPSIS 
21872 =item DESCRIPTION
21874 =item OVERRIDES
21876 =item EXAMPLE
21878 =item LICENSE
21880 =back
21882 =head2 Thread - manipulate threads in Perl (for old code only)
21884 =over 4
21886 =item CAVEAT
21888 =item SYNOPSIS
21890 =item DESCRIPTION
21892 =item FUNCTIONS
21894 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
21895 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
21896 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
21898 =item METHODS
21900 join, eval, detach, equal, tid, flags, done
21902 =item LIMITATIONS
21904 =item SEE ALSO
21906 =back
21908 =head2 Thread::Queue - thread-safe queues
21910 =over 4
21912 =item SYNOPSIS
21914 =item DESCRIPTION
21916 =item FUNCTIONS AND METHODS
21918 new, enqueue LIST, dequeue, dequeue_nb, pending
21920 =item SEE ALSO
21922 =back
21924 =head2 Thread::Semaphore - thread-safe semaphores
21926 =over 4
21928 =item SYNOPSIS
21930 =item DESCRIPTION
21932 =item FUNCTIONS AND METHODS
21934 new, new NUMBER, down, down NUMBER, up, up NUMBER
21936 =back
21938 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
21939 (for old code)
21941 =over 4
21943 =item CAVEAT
21945 =item SYNOPSIS
21947 =item DESCRIPTION
21949 =item BUGS
21951 =back
21953 =head2 Thread::Specific - thread-specific keys
21955 =over 4
21957 =item SYNOPSIS
21959 =item DESCRIPTION
21961 =back
21963 =head2 Tie::Array - base class for tied arrays
21965 =over 4
21967 =item SYNOPSIS
21969 =item DESCRIPTION
21971 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
21972 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
21973 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
21974 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
21976 =item CAVEATS
21978 =item AUTHOR
21980 =back
21982 =head2 Tie::File - Access the lines of a disk file via a Perl array
21984 =over 4
21986 =item SYNOPSIS
21988 =item DESCRIPTION
21990 =over 4
21992 =item C<recsep>
21994 =item C<autochomp>
21996 =item C<mode>
21998 =item C<memory>
22000 =item C<dw_size>
22002 =item Option Format
22004 =back
22006 =item Public Methods
22008 =over 4
22010 =item C<flock>
22012 =item C<autochomp>
22014 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
22016 =item C<offset>
22018 =back
22020 =item Tying to an already-opened filehandle
22022 =item Deferred Writing
22024 =over 4
22026 =item Autodeferring
22028 =back
22030 =item CONCURRENT ACCESS TO FILES
22032 =item CAVEATS
22034 =item SUBCLASSING
22036 =item WHAT ABOUT C<DB_File>?
22038 =item AUTHOR
22040 =item LICENSE
22042 =item WARRANTY
22044 =item THANKS
22046 =item TODO
22048 =back
22050 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
22051 handles
22053 =over 4
22055 =item SYNOPSIS
22057 =item DESCRIPTION
22059 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
22060 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
22061 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
22062 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
22064 =item MORE INFORMATION
22066 =item COMPATIBILITY
22068 =back
22070 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
22071 tied hashes
22073 =over 4
22075 =item SYNOPSIS
22077 =item DESCRIPTION
22079 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
22080 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR
22081 this, SCALAR this
22083 =item Inheriting from B<Tie::StdHash>
22085 =item Inheriting from B<Tie::ExtraHash>
22087 =item C<SCALAR>, C<UNTIE> and C<DESTROY>
22089 =item MORE INFORMATION
22091 =back
22093 =head2 Tie::Memoize - add data to hash when needed
22095 =over 4
22097 =item SYNOPSIS
22099 =item DESCRIPTION
22101 =item Inheriting from B<Tie::Memoize>
22103 =item EXAMPLE
22105 =item BUGS
22107 =item AUTHOR
22109 =back
22111 =head2 Tie::RefHash - use references as hash keys
22113 =over 4
22115 =item SYNOPSIS
22117 =item DESCRIPTION
22119 =item EXAMPLE
22121 =item AUTHOR
22123 =item VERSION
22125 =item SEE ALSO
22127 =back
22129 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
22130 scalars
22132 =over 4
22134 =item SYNOPSIS
22136 =item DESCRIPTION
22138 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
22140 =item MORE INFORMATION
22142 =back
22144 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
22146 =over 4
22148 =item SYNOPSIS
22150 =item DESCRIPTION
22152 =item CAVEATS
22154 =back
22156 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
22157 timers
22159 =over 4
22161 =item SYNOPSIS
22163 =item DESCRIPTION
22165 gettimeofday (), usleep ( $useconds ), nanosleep ( $nanoseconds ), ualarm (
22166 $useconds [, $interval_useconds ] ), tv_interval, time (), sleep (
22167 $floating_seconds ), alarm ( $floating_seconds [,
22168 $interval_floating_seconds ] ), setitimer ( $which, $floating_seconds [,
22169 $interval_floating_seconds ] ), getitimer ( $which ), clock_gettime (
22170 $which ), clock_getres ( $which ), clock_nanosleep ( $which, $seconds,
22171 $flags = 0), clock()
22173 =item EXAMPLES
22175 =item C API
22177 =item DIAGNOSTICS
22179 =over 4
22181 =item negative time not invented yet
22183 =item internal error: useconds < 0 (unsigned ... signed ...)
22185 =back
22187 =item CAVEATS
22189 =item SEE ALSO
22191 =item AUTHORS
22193 =item COPYRIGHT AND LICENSE
22195 =back
22197 =head2 Time::Local - efficiently compute time from local and GMT time
22199 =over 4
22201 =item SYNOPSIS
22203 =item DESCRIPTION
22205 =over 4
22207 =item Ambiguous Local Times (DST)
22209 =item Non-Existent Local Times (DST)
22211 =item Negative Epoch Values
22213 =back
22215 =item IMPLEMENTATION
22217 =item BUGS
22219 =item SUPPORT
22221 =item AUTHOR
22223 =back
22225 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
22226 function
22228 =over 4
22230 =item SYNOPSIS
22232 =item DESCRIPTION
22234 =item NOTE
22236 =item AUTHOR
22238 =back
22240 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
22241 function
22243 =over 4
22245 =item SYNOPSIS
22247 =item DESCRIPTION
22249 =item NOTE
22251 =item AUTHOR
22253 =back
22255 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
22257 =over 4
22259 =item SYNOPSIS
22261 =item DESCRIPTION
22263 =item AUTHOR
22265 =back
22267 =head2 UNIVERSAL - base class for ALL classes (blessed references)
22269 =over 4
22271 =item SYNOPSIS
22273 =item DESCRIPTION
22275 C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<isa( VAL, TYPE )>,
22276 C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD ) >>, C<<
22277 CLASS->can( METHOD ) >>, C<can( VAL, METHOD )>, C<VERSION ( [ REQUIRE ] )>
22279 =item EXPORTS
22281 =back
22283 =head2 Unicode::Collate - Unicode Collation Algorithm
22285 =over 4
22287 =item SYNOPSIS
22289 =item DESCRIPTION
22291 =over 4
22293 =item Constructor and Tailoring
22295 UCA_Version, alternate, backwards, entry, hangul_terminator, ignoreChar,
22296 ignoreName, katakana_before_hiragana, level, normalization, overrideCJK,
22297 overrideHangul, preprocess, rearrange, table, undefChar, undefName,
22298 upper_before_lower, variable
22300 =item Methods for Collation
22302 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
22303 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
22304 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
22305 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
22306 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
22307 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
22308 $Collator-E<gt>viewSortKey($string)>
22310 =item Methods for Searching
22312 C<$position = $Collator-E<gt>index($string, $substring[, $position])>,
22313 C<($position, $length) = $Collator-E<gt>index($string, $substring[,
22314 $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>,
22315 C<($match)   = $Collator-E<gt>match($string, $substring)>, C<@match =
22316 $Collator-E<gt>gmatch($string, $substring)>, C<$count =
22317 $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count =
22318 $Collator-E<gt>gsubst($string, $substring, $replacement)>
22320 =item Other Methods
22322 C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, C<$version =
22323 $Collator-E<gt>version()>, C<UCA_Version()>, C<Base_Unicode_Version()>
22325 =back
22327 =item EXPORT
22329 =item INSTALL
22331 =item CAVEATS
22333 Normalization, Conformance Test
22335 =item AUTHOR, COPYRIGHT AND LICENSE
22337 =item SEE ALSO
22339 Unicode Collation Algorithm - UTS #10, The Default Unicode Collation
22340 Element Table (DUCET), The conformance test for the UCA, Hangul Syllable
22341 Type, Unicode Normalization Forms - UAX #15
22343 =back
22345 =head2 Unicode::Normalize - Unicode Normalization Forms
22347 =over 4
22349 =item SYNOPSIS
22351 =item DESCRIPTION
22353 =over 4
22355 =item Normalization Forms
22357 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
22358 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
22359 C<$FCD_string = FCD($string)>, C<$FCC_string = FCC($string)>,
22360 C<$normalized_string = normalize($form_name, $string)>
22362 =item Decomposition and Composition
22364 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
22365 decompose($string, $useCompatMapping)>, C<$reordered_string  =
22366 reorder($string)>, C<$composed_string   = compose($string)>
22368 =item Quick Check
22370 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
22371 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
22372 checkFCD($string)>, C<$result = checkFCC($string)>, C<$result =
22373 check($form_name, $string)>
22375 =item Character Data
22377 C<$canonical_decomposed = getCanon($codepoint)>,
22378 C<$compatibility_decomposed = getCompat($codepoint)>,
22379 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
22380 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
22381 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
22382 C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>,
22383 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
22385 =back
22387 =item EXPORT
22389 =item CAVEATS
22391 Perl's version vs. Unicode version, Correction of decomposition mapping,
22392 Revised definition of canonical composition
22394 =item AUTHOR
22396 =item SEE ALSO
22398 http://www.unicode.org/reports/tr15/,
22399 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt,
22400 http://www.unicode.org/Public/UNIDATA/NormalizationCorrections.txt,
22401 http://www.unicode.org/review/pr-29.html, http://www.unicode.org/notes/tn5/
22403 =back
22405 =head2 Unicode::UCD - Unicode character database
22407 =over 4
22409 =item SYNOPSIS
22411 =item DESCRIPTION
22413 =back
22415 =over 4
22417 =item charinfo
22419 =back
22421 =over 4
22423 =item charblock
22425 =back
22427 =over 4
22429 =item charscript
22431 =back
22433 =over 4
22435 =item charblocks
22437 =back
22439 =over 4
22441 =item charscripts
22443 =back
22445 =over 4
22447 =item Blocks versus Scripts
22449 =item Matching Scripts and Blocks
22451 =item Code Point Arguments
22453 =item charinrange
22455 =back
22457 =over 4
22459 =item compexcl
22461 =back
22463 =over 4
22465 =item casefold
22467 =back
22469 =over 4
22471 =item casespec
22473 =back
22475 =over 4
22477 =item namedseq()
22479 =back
22481 =over 4
22483 =item Unicode::UCD::UnicodeVersion
22485 =back
22487 =over 4
22489 =item Implementation Note
22491 =back
22493 =over 4
22495 =item BUGS
22497 =item AUTHOR
22499 =back
22501 =head2 User::grent - by-name interface to Perl's built-in getgr*()
22502 functions
22504 =over 4
22506 =item SYNOPSIS
22508 =item DESCRIPTION
22510 =item NOTE
22512 =item AUTHOR
22514 =back
22516 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
22517 functions
22519 =over 4
22521 =item SYNOPSIS
22523 =item DESCRIPTION
22525 =over 4
22527 =item System Specifics
22529 =back
22531 =item NOTE
22533 =item AUTHOR
22535 =item HISTORY
22537 March 18th, 2000
22539 =back
22541 =head2 XSLoader - Dynamically load C libraries into Perl code
22543 =over 4
22545 =item VERSION
22547 =item SYNOPSIS
22549 =item DESCRIPTION
22551 =over 4
22553 =item Migration from C<DynaLoader>
22555 =item Backward compatible boilerplate
22557 =back
22559 =item Order of initialization: early load()
22561 =over 4
22563 =item The most hairy case
22565 =back
22567 =item DIAGNOSTICS
22569 Can't find '%s' symbol in %s, Can't load '%s' for module %s: %s, Undefined
22570 symbols present after loading %s: %s, XSLoader::load('Your::Module',
22571 $Your::Module::VERSION)
22573 =item LIMITATIONS
22575 =item BUGS
22577 =item SEE ALSO
22579 =item AUTHORS
22581 =item COPYRIGHT
22583 =back
22585 =head1 AUXILIARY DOCUMENTATION
22587 Here should be listed all the extra programs' documentation, but they
22588 don't all have manual pages yet:
22590 =over 4
22592 =item a2p
22594 =item c2ph
22596 =item dprofpp
22598 =item h2ph
22600 =item h2xs
22602 =item perlbug
22604 =item perldoc
22606 =item pl2pm
22608 =item pod2html
22610 =item pod2man
22612 =item s2p
22614 =item splain
22616 =item xsubpp
22618 =back
22620 =head1 AUTHOR
22622 Larry Wall <F<larry@wall.org>>, with the help of oodles
22623 of other folks.