2 # !!!!!!! DO NOT EDIT THIS FILE !!!!!!!
3 # This file is autogenerated by buildtoc from all the other pods.
4 # Edit those files and run buildtoc --build-toc to effect changes.
8 perltoc - perl documentation table of contents
12 This page provides a brief table of contents for the rest of the Perl
13 documentation set. It is meant to be scanned quickly or grepped
14 through to locate the proper section you're looking for.
16 =head1 BASIC DOCUMENTATION
18 =head2 perl - Practical Extraction and Report Language
30 =item Reference Manual
32 =item Internals and C Language Interface
36 =item Language-Specific
38 =item Platform-Specific
62 =head2 perlintro -- a brief introduction and overview of Perl
72 =item Running Perl programs
76 =item Basic syntax overview
78 =item Perl variable types
80 Scalars, Arrays, Hashes
82 =item Variable scoping
84 =item Conditional and looping constructs
86 if, while, for, foreach
88 =item Builtin operators and functions
90 Arithmetic, Numeric comparison, String comparison, Boolean logic,
95 =item Regular expressions
97 Simple matching, Simple substitution, More complex regular expressions,
98 Parentheses for capturing, Other regexp features
100 =item Writing subroutines
104 =item Using Perl modules
112 =head2 perlreftut - Mark's very short tutorial about references
118 =item Who Needs Complicated Data Structures?
126 =item Making References
128 =item Using References
146 =item Distribution Conditions
152 =head2 perldsc - Perl Data Structures Cookbook
158 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
159 more elaborate constructs
162 X<reference> X<dereference> X<dereferencing> X<pointer>
164 =item COMMON MISTAKES
166 =item CAVEAT ON PRECEDENCE
167 X<dereference, precedence> X<dereferencing, precedence>
169 =item WHY YOU SHOULD ALWAYS C<use strict>
172 X<data structure, debugging> X<complex data structure, debugging>
173 X<AoA, debugging> X<HoA, debugging> X<AoH, debugging> X<HoH, debugging>
174 X<array of arrays, debugging> X<hash of arrays, debugging>
175 X<array of hashes, debugging> X<hash of hashes, debugging>
179 =item ARRAYS OF ARRAYS
180 X<array of arrays> X<AoA>
184 =item Declaration of an ARRAY OF ARRAYS
186 =item Generation of an ARRAY OF ARRAYS
188 =item Access and Printing of an ARRAY OF ARRAYS
192 =item HASHES OF ARRAYS
193 X<hash of arrays> X<HoA>
197 =item Declaration of a HASH OF ARRAYS
199 =item Generation of a HASH OF ARRAYS
201 =item Access and Printing of a HASH OF ARRAYS
205 =item ARRAYS OF HASHES
206 X<array of hashes> X<AoH>
210 =item Declaration of an ARRAY OF HASHES
212 =item Generation of an ARRAY OF HASHES
214 =item Access and Printing of an ARRAY OF HASHES
218 =item HASHES OF HASHES
219 X<hass of hashes> X<HoH>
223 =item Declaration of a HASH OF HASHES
225 =item Generation of a HASH OF HASHES
227 =item Access and Printing of a HASH OF HASHES
231 =item MORE ELABORATE RECORDS
232 X<record> X<structure> X<struct>
236 =item Declaration of MORE ELABORATE RECORDS
238 =item Declaration of a HASH OF COMPLEX RECORDS
240 =item Generation of a HASH OF COMPLEX RECORDS
252 =head2 perllol - Manipulating Arrays of Arrays in Perl
260 =item Declaration and Access of Arrays of Arrays
262 =item Growing Your Own
264 =item Access and Printing
276 =head2 perlrequick - Perl regular expressions quick start
286 =item Simple word matching
288 =item Using character classes
290 =item Matching this or that
292 =item Grouping things and hierarchical matching
294 =item Extracting matches
296 =item Matching repetitions
300 =item Search and replace
302 =item The split operator
310 =item AUTHOR AND COPYRIGHT
314 =item Acknowledgments
320 =head2 perlretut - Perl regular expressions tutorial
326 =item Part 1: The basics
330 =item Simple word matching
332 =item Using character classes
334 =item Matching this or that
336 =item Grouping things and hierarchical matching
338 =item Extracting matches
342 =item Relative backreferences
344 =item Named backreferences
346 =item Alternative capture group numbering
348 =item Position information
350 =item Non-capturing groupings
352 =item Matching repetitions
354 =item Possessive quantifiers
356 =item Building a regexp
358 =item Using regular expressions in Perl
362 =item Part 2: Power tools
366 =item More on characters, strings, and character classes
368 =item Compiling and saving regular expressions
370 =item Composing regular expressions at runtime
372 =item Embedding comments and modifiers in a regular expression
374 =item Looking ahead and looking behind
376 =item Using independent subexpressions to prevent backtracking
378 =item Conditional expressions
380 =item Defining named patterns
382 =item Recursive patterns
384 =item A bit of magic: executing Perl code in a regular expression
386 =item Backtracking control verbs
388 =item Pragmas and debugging
396 =item AUTHOR AND COPYRIGHT
400 =item Acknowledgments
406 =head2 perlboot - Beginner's Object-Oriented Tutorial
414 =item If we could talk to the animals...
416 =item Introducing the method invocation arrow
418 =item Invoking a barnyard
420 =item The extra parameter of method invocation
422 =item Calling a second method to simplify things
424 =item Inheriting the windpipes
426 =item A few notes about @ISA
428 =item Overriding the methods
430 =item Starting the search from a different place
432 =item The SUPER way of doing things
434 =item Where we're at so far...
436 =item A horse is a horse, of course of course -- or is it?
438 =item Invoking an instance method
440 =item Accessing the instance data
442 =item How to build a horse
444 =item Inheriting the constructor
446 =item Making a method work with either classes or instances
448 =item Adding parameters to a method
450 =item More interesting instances
452 =item A horse of a different color
464 =head2 perltoot - Tom's object-oriented tutorial for perl
470 =item Creating a Class
474 =item Object Representation
476 =item Class Interface
478 =item Constructors and Instance Methods
480 =item Planning for the Future: Better Constructors
484 =item Other Object Methods
492 =item Accessing Class Data
494 =item Debugging Methods
496 =item Class Destructors
498 =item Documenting the Interface
508 =item Overridden Methods
510 =item Multiple Inheritance
512 =item UNIVERSAL: The Root of All Objects
516 =item Alternate Object Representations
520 =item Arrays as Objects
522 =item Closures as Objects
526 =item AUTOLOAD: Proxy Methods
530 =item Autoloaded Data Methods
532 =item Inherited Autoloaded Data Methods
536 =item Metaclassical Tools
542 =item Data Members as Variables
550 =item Object Terminology
556 =item AUTHOR AND COPYRIGHT
562 =item Acknowledgments
568 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
574 =item Class Data in a Can
576 =item Class Data as Package Variables
580 =item Putting All Your Eggs in One Basket
582 =item Inheritance Concerns
584 =item The Eponymous Meta-Object
586 =item Indirect References to Class Data
588 =item Monadic Classes
590 =item Translucent Attributes
594 =item Class Data as Lexical Variables
598 =item Privacy and Responsibility
600 =item File-Scoped Lexicals
602 =item More Inheritance Concerns
604 =item Locking the Door and Throwing Away the Key
606 =item Translucency Revisited
614 =item AUTHOR AND COPYRIGHT
616 =item ACKNOWLEDGEMENTS
622 =head2 perlbot - Bag'o Object Tricks (the BOT)
628 =item OO SCALING TIPS
630 =item INSTANCE VARIABLES
632 =item SCALAR INSTANCE VARIABLES
634 =item INSTANCE VARIABLE INHERITANCE
636 =item OBJECT RELATIONSHIPS
638 =item OVERRIDING SUPERCLASS METHODS
640 =item USING RELATIONSHIP WITH SDBM
642 =item THINKING OF CODE REUSE
644 =item CLASS CONTEXT AND THE OBJECT
646 =item INHERITING A CONSTRUCTOR
654 =head2 perlstyle - Perl style guide
662 =head2 perlcheat - Perl 5 Cheat Sheet
674 =item ACKNOWLEDGEMENTS
682 =head2 perltrap - Perl traps for the unwary
700 =item Perl4 to Perl5 Traps
702 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
703 Traps, General data type traps, Context Traps - scalar, list contexts,
704 Precedence Traps, General Regular Expression Traps using s///, etc,
705 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
707 =item Discontinuance, Deprecation, and BugFix traps
709 Symbols starting with "_" no longer forced into main, Double-colon valid
710 package separator in variable name, 2nd and 3rd args to C<splice()> are now
711 in scalar context, Can't do C<goto> into a block that is optimized away,
712 Can't use whitespace as variable name or quote delimiter, C<while/if BLOCK
713 BLOCK> gone, C<**> binds tighter than unary minus, C<foreach> changed when
714 iterating over a list, C<split> with no args behavior changed, B<-e>
715 behavior fixed, C<push> returns number of elements in resulting list, Some
716 error messages differ, C<split()> honors subroutine args, Bugs removed
720 Space between . and = triggers syntax error, Better parsing in perl 5,
721 Function parsing, String interpolation of C<$#array> differs, Perl guesses
722 on C<map>, C<grep> followed by C<{> if it starts BLOCK or hash ref
724 =item Numerical Traps
726 Formatted output and significant digits, Auto-increment operator over
727 signed int limit deleted, Assignment of return values from numeric equality
728 tests doesn't work, Bitwise string ops
730 =item General data type traps
732 Negative array subscripts now count from the end of array, Setting
733 C<$#array> lower now discards array elements, Hashes get defined before
734 use, Glob assignment from localized variable to variable, Assigning
735 C<undef> to glob, Changes in unary negation (of strings), Modifying of
736 constants prohibited, C<defined $var> behavior changed, Variable Suicide
738 =item Context Traps - scalar, list contexts
740 Elements of argument lists for formats evaluated in list context,
741 C<caller()> returns false value in scalar context if no caller present,
742 Comma operator in scalar context gives scalar context to args, C<sprintf()>
743 prototyped as C<($;@)>
745 =item Precedence Traps
747 LHS vs. RHS of any assignment operator, Semantic errors introduced due to
748 precedence, Precedence of assignment operators same as the precedence of
749 assignment, C<open> requires parentheses around filehandle, C<$:>
750 precedence over C<$::> gone, Precedence of file test operators documented,
751 C<keys>, C<each>, C<values> are regular named unary operators
753 =item General Regular Expression Traps using s///, etc.
755 C<s'$lhs'$rhs'> interpolates on either side, C<m//g> attaches its state to
756 the searched string, C<m//o> used within an anonymous sub, C<$+> isn't set
757 to whole match, Substitution now returns null string if it fails,
758 C<s`lhs`rhs`> is now a normal substitution, Stricter parsing of variables
759 in regular expressions, C<m?x?> matches only once, Failed matches don't
760 reset the match variables
762 =item Subroutine, Signal, Sorting Traps
764 Barewords that used to look like strings look like subroutine calls,
765 Reverse is no longer allowed as the name of a sort subroutine, C<warn()>
766 won't let you specify a filehandle
770 SysV resets signal handler correctly, SysV C<seek()> appends correctly
772 =item Interpolation Traps
774 C<@> always interpolates an array in double-quotish strings, Double-quoted
775 strings may no longer end with an unescaped $, Arbitrary expressions are
776 evaluated inside braces within double quotes, C<$$x> now tries to
777 dereference $x, Creation of hashes on the fly with C<eval "EXPR"> requires
778 protection, Bugs in earlier perl versions, Array and hash brackets during
779 interpolation, Interpolation of C<\$$foo{bar}>, C<qq()> string passed to
780 C<eval> will not find string terminator
784 Perl5 must have been linked with same dbm/ndbm as the default for
785 C<dbmopen()>, DBM exceeding limit on the key/value size will cause perl5 to
788 =item Unclassified Traps
790 C<require>/C<do> trap using returned value, C<split> on empty string with
797 =head2 perldebtut - Perl debugging tutorial
805 =item Looking at data and -w and v
809 =item Stepping through code
811 =item Placeholder for a, w, t, T
813 =item REGULAR EXPRESSIONS
831 =head2 perlfaq - frequently asked questions about Perl
839 =item Where to get the perlfaq
841 =item How to contribute to the perlfaq
843 =item What will happen if you mail your Perl programming problems to the
850 =item AUTHOR AND COPYRIGHT
852 =item Table of Contents
854 perlfaq - this document, perlfaq1 - General Questions About Perl, perlfaq2
855 - Obtaining and Learning about Perl, perlfaq3 - Programming Tools, perlfaq4
856 - Data Manipulation, perlfaq5 - Files and Formats, perlfaq6 - Regular
857 Expressions, perlfaq7 - General Perl Language Issues, perlfaq8 - System
858 Interaction, perlfaq9 - Networking
864 =item L<perlfaq1>: General Questions About Perl
866 =item L<perlfaq2>: Obtaining and Learning about Perl
868 =item L<perlfaq3>: Programming Tools
870 =item L<perlfaq4>: Data Manipulation
872 =item L<perlfaq5>: Files and Formats
874 =item L<perlfaq6>: Regular Expressions
876 =item L<perlfaq7>: General Perl Language Issues
878 =item L<perlfaq8>: System Interaction
880 =item L<perlfaq9>: Networking
886 =head2 perlfaq1 - General Questions About Perl ($Revision: 8539 $)
896 =item Who supports Perl? Who develops it? Why is it free?
898 =item Which version of Perl should I use?
900 =item What are perl4, perl5, or perl6?
902 =item What was Ponie?
906 =item How stable is Perl?
908 =item Is Perl difficult to learn?
910 =item How does Perl compare with other languages like Java, Python, REXX,
913 =item Can I do [task] in Perl?
915 =item When shouldn't I program in Perl?
917 =item What's the difference between "perl" and "Perl"?
919 =item Is it a Perl program or a Perl script?
921 =item What is a JAPH?
923 =item Where can I get a list of Larry Wall witticisms?
925 =item How can I convince others to use Perl?
927 http://perltraining.com.au/whyperl.html,
928 http://www.perl.org/advocacy/whyperl.html
934 =item AUTHOR AND COPYRIGHT
938 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 8539 $)
946 =item What machines support perl? Where do I get it?
948 =item How can I get a binary version of perl?
950 =item I don't have a C compiler. How can I build my own Perl interpreter?
952 =item I copied the perl binary from one machine to another, but scripts
955 =item I grabbed the sources and tried to compile but gdbm/dynamic
956 loading/malloc/linking/... failed. How do I make it work?
958 =item What modules and extensions are available for Perl? What is CPAN?
959 What does CPAN/src/... mean?
961 =item Is there an ISO or ANSI certified version of Perl?
963 =item Where can I get information on Perl?
965 =item What are the Perl newsgroups on Usenet? Where do I post questions?
967 =item Where should I post source code?
971 References, Tutorials, Task-Oriented, Special Topics
973 =item Which magazines have Perl content?
975 =item What mailing lists are there for Perl?
977 =item Where are the archives for comp.lang.perl.misc?
979 =item Where can I buy a commercial version of perl?
981 =item Where do I send bug reports?
983 =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
989 =item AUTHOR AND COPYRIGHT
993 =head2 perlfaq3 - Programming Tools ($Revision: 8539 $)
1001 =item How do I do (anything)?
1003 =item How can I use Perl interactively?
1005 =item Is there a Perl shell?
1007 =item How do I find which modules are installed on my system?
1009 =item How do I debug my Perl programs?
1011 =item How do I profile my Perl programs?
1013 =item How do I cross-reference my Perl programs?
1015 =item Is there a pretty-printer (formatter) for Perl?
1017 =item Is there a ctags for Perl?
1019 =item Is there an IDE or Windows Perl Editor?
1021 Eclipse, Enginsite, Komodo, Open Perl IDE, OptiPerl, PerlBuilder,
1022 visiPerl+, Visual Perl, Zeus, GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis,
1023 Vile, Vim, Codewright, MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, Affrus,
1024 Alpha, BBEdit and BBEdit Lite
1026 =item Where can I get Perl macros for vi?
1028 =item Where can I get perl-mode for emacs?
1030 =item How can I use curses with Perl?
1032 =item How can I use X or Tk with Perl?
1034 =item How can I make my Perl program run faster?
1036 =item How can I make my Perl program take less memory?
1038 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
1039 stringification, Pass by reference, Tie large variables to disk
1041 =item Is it safe to return a reference to local or lexical data?
1043 =item How can I free an array or hash so my program shrinks?
1045 =item How can I make my CGI script more efficient?
1047 =item How can I hide the source for my Perl program?
1049 =item How can I compile my Perl program into byte code or C?
1051 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
1053 =item Can I write useful Perl programs on the command line?
1055 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
1057 =item Where can I learn about CGI or Web programming in Perl?
1059 =item Where can I learn about object-oriented Perl programming?
1061 =item Where can I learn about linking C with Perl?
1063 =item I've read perlembed, perlguts, etc., but I can't embed perl in my C
1064 program; what am I doing wrong?
1066 =item When I tried to run my script, I got this message. What does it mean?
1068 =item What's MakeMaker?
1074 =item AUTHOR AND COPYRIGHT
1078 =head2 perlfaq4 - Data Manipulation ($Revision: 8539 $)
1088 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
1089 numbers I should be getting (eg, 19.95)?
1091 =item Why is int() broken?
1093 =item Why isn't my octal data interpreted correctly?
1095 =item Does Perl have a round() function? What about ceil() and floor()?
1098 =item How do I convert between numeric representations/bases/radixes?
1100 How do I convert hexadecimal into decimal, How do I convert from decimal to
1101 hexadecimal, How do I convert from octal to decimal, How do I convert from
1102 decimal to octal, How do I convert from binary to decimal, How do I convert
1103 from decimal to binary
1105 =item Why doesn't & work the way I want it to?
1107 =item How do I multiply matrices?
1109 =item How do I perform an operation on a series of integers?
1111 =item How can I output Roman numerals?
1113 =item Why aren't my random numbers random?
1115 =item How do I get a random number between X and Y?
1123 =item How do I find the day or week of the year?
1125 =item How do I find the current century or millennium?
1127 =item How can I compare two dates and find the difference?
1129 =item How can I take a string and turn it into epoch seconds?
1131 =item How can I find the Julian Day?
1133 =item How do I find yesterday's date?
1135 =item Does Perl have a Year 2000 problem? Is Perl Y2K compliant?
1143 =item How do I validate input?
1145 =item How do I unescape a string?
1147 =item How do I remove consecutive pairs of characters?
1149 =item How do I expand function calls in a string?
1151 =item How do I find matching/nesting anything?
1153 =item How do I reverse a string?
1155 =item How do I expand tabs in a string?
1157 =item How do I reformat a paragraph?
1159 =item How can I access or change N characters of a string?
1161 =item How do I change the Nth occurrence of something?
1163 =item How can I count the number of occurrences of a substring within a
1166 =item How do I capitalize all the words on one line?
1168 =item How can I split a [character] delimited string except when inside
1171 =item How do I strip blank space from the beginning/end of a string?
1173 =item How do I pad a string with blanks or pad a number with zeroes?
1175 =item How do I extract selected columns from a string?
1177 =item How do I find the soundex value of a string?
1179 =item How can I expand variables in text strings?
1181 =item What's wrong with always quoting "$vars"?
1183 =item Why don't my E<lt>E<lt>HERE documents work?
1185 There must be no space after the E<lt>E<lt> part, There (probably) should
1186 be a semicolon at the end, You can't (easily) have any space in front of
1195 =item What is the difference between a list and an array?
1197 =item What is the difference between $array[1] and @array[1]?
1199 =item How can I remove duplicate elements from a list or array?
1201 =item How can I tell whether a certain element is contained in a list or
1204 =item How do I compute the difference of two arrays? How do I compute the
1205 intersection of two arrays?
1207 =item How do I test whether two arrays or hashes are equal?
1209 =item How do I find the first array element for which a condition is true?
1211 =item How do I handle linked lists?
1213 =item How do I handle circular lists?
1215 =item How do I shuffle an array randomly?
1217 =item How do I process/modify each element of an array?
1219 =item How do I select a random element from an array?
1221 =item How do I permute N elements of a list?
1223 =item How do I sort an array by (anything)?
1225 =item How do I manipulate arrays of bits?
1227 =item Why does defined() return true on empty arrays and hashes?
1231 =item Data: Hashes (Associative Arrays)
1235 =item How do I process an entire hash?
1237 =item What happens if I add or remove keys from a hash while iterating over
1240 =item How do I look up a hash element by value?
1242 =item How can I know how many entries are in a hash?
1244 =item How do I sort a hash (optionally by value instead of key)?
1246 =item How can I always keep my hash sorted?
1247 X<hash tie sort DB_File Tie::IxHash>
1249 =item What's the difference between "delete" and "undef" with hashes?
1251 =item Why don't my tied hashes make the defined/exists distinction?
1253 =item How do I reset an each() operation part-way through?
1255 =item How can I get the unique keys from two hashes?
1257 =item How can I store a multidimensional array in a DBM file?
1259 =item How can I make my hash remember the order I put elements into it?
1261 =item Why does passing a subroutine an undefined element in a hash create
1264 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
1265 array of hashes or arrays?
1267 =item How can I use a reference as a hash key?
1275 =item How do I handle binary data correctly?
1277 =item How do I determine whether a scalar is a number/whole/integer/float?
1279 =item How do I keep persistent data across program calls?
1281 =item How do I print out or copy a recursive data structure?
1283 =item How do I define methods for every class/object?
1285 =item How do I verify a credit card checksum?
1287 =item How do I pack arrays of doubles or floats for XS code?
1293 =item AUTHOR AND COPYRIGHT
1297 =head2 perlfaq5 - Files and Formats ($Revision: 8579 $)
1305 =item How do I flush/unbuffer an output filehandle? Why must I do this?
1306 X<flush> X<buffer> X<unbuffer> X<autoflush>
1308 =item How do I change, delete, or insert a line in a file, or append to the
1309 beginning of a file?
1312 =item How do I count the number of lines in a file?
1313 X<file, counting lines> X<lines> X<line>
1315 =item How can I use Perl's C<-i> option from within a program?
1318 =item How can I copy a file?
1319 X<copy> X<file, copy>
1321 =item How do I make a temporary file name?
1324 =item How can I manipulate fixed-record-length files?
1325 X<fixed-length> X<file, fixed-length records>
1327 =item How can I make a filehandle local to a subroutine? How do I pass
1328 filehandles between subroutines? How do I make an array of filehandles?
1329 X<filehandle, local> X<filehandle, passing> X<filehandle, reference>
1331 =item How can I use a filehandle indirectly?
1332 X<filehandle, indirect>
1334 =item How can I set up a footer format to be used with write()?
1337 =item How can I write() into a string?
1338 X<write, into a string>
1340 =item How can I output my numbers with commas added?
1343 =item How can I translate tildes (~) in a filename?
1344 X<tilde> X<tilde expansion>
1346 =item How come when I open a file read-write it wipes it out?
1347 X<clobber> X<read-write> X<clobbering> X<truncate> X<truncating>
1349 =item Why do I sometimes get an "Argument list too long" when I use
1351 X<argument list too long>
1353 =item Is there a leak/bug in glob()?
1356 =item How can I open a file with a leading ">" or trailing blanks?
1357 X<filename, special characters>
1359 =item How can I reliably rename a file?
1360 X<rename> X<mv> X<move> X<file, rename> X<ren>
1362 =item How can I lock a file?
1363 X<lock> X<file, lock> X<flock>
1365 =item Why can't I just open(FH, "E<gt>file.lock")?
1366 X<lock, lockfile race condition>
1368 =item I still don't get locking. I just want to increment the number in
1369 the file. How can I do this?
1370 X<counter> X<file, counter>
1372 =item All I want to do is append a small amount of text to the end of a
1373 file. Do I still have to use locking?
1374 X<append> X<file, append>
1376 =item How do I randomly update a binary file?
1377 X<file, binary patch>
1379 =item How do I get a file's timestamp in perl?
1380 X<timestamp> X<file, timestamp>
1382 =item How do I set a file's timestamp in perl?
1383 X<timestamp> X<file, timestamp>
1385 =item How do I print to more than one file at once?
1386 X<print, to multiple files>
1388 =item How can I read in an entire file all at once?
1389 X<slurp> X<file, slurping>
1391 =item How can I read in a file by paragraphs?
1392 X<file, reading by paragraphs>
1394 =item How can I read a single character from a file? From the keyboard?
1395 X<getc> X<file, reading one character at a time>
1397 =item How can I tell whether there's a character waiting on a filehandle?
1399 =item How do I do a C<tail -f> in perl?
1400 X<tail> X<IO::Handle> X<File::Tail> X<clearerr>
1402 =item How do I dup() a filehandle in Perl?
1405 =item How do I close a file descriptor by number?
1406 X<file, closing file descriptors> X<POSIX> X<close>
1408 =item Why can't I use "C:\temp\foo" in DOS paths? Why doesn't
1409 `C:\temp\foo.exe` work?
1410 X<filename, DOS issues>
1412 =item Why doesn't glob("*.*") get all the files?
1415 =item Why does Perl let me delete read-only files? Why does C<-i> clobber
1416 protected files? Isn't this a bug in Perl?
1418 =item How do I select a random line from a file?
1419 X<file, selecting a random line>
1421 =item Why do I get weird spaces when I print an array of lines?
1427 =item AUTHOR AND COPYRIGHT
1431 =head2 perlfaq6 - Regular Expressions ($Revision: 8539 $)
1439 =item How can I hope to use regular expressions without creating illegible
1440 and unmaintainable code?
1441 X<regex, legibility> X<regexp, legibility>
1442 X<regular expression, legibility> X</x>
1444 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
1446 =item I'm having trouble matching over more than one line. What's wrong?
1447 X<regex, multiline> X<regexp, multiline> X<regular expression, multiline>
1449 =item How can I pull out lines between two patterns that are themselves on
1453 =item I put a regular expression into $/ but it didn't work. What's wrong?
1454 X<$/, regexes in> X<$INPUT_RECORD_SEPARATOR, regexes in>
1457 =item How do I substitute case insensitively on the LHS while preserving
1459 X<replace, case preserving> X<substitute, case preserving>
1460 X<substitution, case preserving> X<s, case preserving>
1462 =item How can I make C<\w> match national character sets?
1465 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
1468 =item How can I quote a variable to use in a regex?
1469 X<regex, escaping> X<regexp, escaping> X<regular expression, escaping>
1471 =item What is C</o> really for?
1472 X</o, regular expressions> X<compile, regular expressions>
1474 =item How do I use a regular expression to strip C style comments from a
1477 =item Can I use Perl regular expressions to match balanced text?
1478 X<regex, matching balanced test> X<regexp, matching balanced test>
1479 X<regular expression, matching balanced test>
1481 =item What does it mean that regexes are greedy? How can I get around it?
1482 X<greedy> X<greediness>
1484 =item How do I process each word on each line?
1487 =item How can I print out a word-frequency or line-frequency summary?
1489 =item How can I do approximate matching?
1490 X<match, approximate> X<matching, approximate>
1492 =item How do I efficiently match many regular expressions at once?
1493 X<regex, efficiency> X<regexp, efficiency>
1494 X<regular expression, efficiency>
1496 =item Why don't word-boundary searches with C<\b> work for me?
1499 =item Why does using $&, $`, or $' slow my program down?
1500 X<$MATCH> X<$&> X<$POSTMATCH> X<$'> X<$PREMATCH> X<$`>
1502 =item What good is C<\G> in a regular expression?
1505 =item Are Perl regexes DFAs or NFAs? Are they POSIX compliant?
1506 X<DFA> X<NFA> X<POSIX>
1508 =item What's wrong with using grep in a void context?
1511 =item How can I match strings with multibyte characters?
1512 X<regex, and multibyte characters> X<regexp, and multibyte characters>
1513 X<regular expression, and multibyte characters> X<martian> X<encoding,
1516 =item How do I match a regular expression that's in a variable?
1517 X<regex, in variable> X<eval> X<regex> X<quotemeta> X<\Q, regex>
1518 X<\E, regex>, X<qr//>
1524 =item AUTHOR AND COPYRIGHT
1528 =head2 perlfaq7 - General Perl Language Issues ($Revision: 9309 $)
1536 =item Can I get a BNF/yacc/RE for the Perl language?
1538 =item What are all these $@%&* punctuation signs, and how do I know when to
1541 =item Do I always/never have to quote my strings or use semicolons and
1544 =item How do I skip some return values?
1546 =item How do I temporarily block warnings?
1548 =item What's an extension?
1550 =item Why do Perl operators have different precedence than C operators?
1552 =item How do I declare/create a structure?
1554 =item How do I create a module?
1556 =item How do I create a class?
1558 =item How can I tell if a variable is tainted?
1560 =item What's a closure?
1562 =item What is variable suicide and how can I prevent it?
1564 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
1567 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
1570 =item How do I create a static variable?
1572 =item What's the difference between dynamic and lexical (static) scoping?
1573 Between local() and my()?
1575 =item How can I access a dynamic variable while a similarly named lexical
1578 =item What's the difference between deep and shallow binding?
1580 =item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?
1582 =item How do I redefine a builtin function, operator, or method?
1584 =item What's the difference between calling a function as &foo and foo()?
1586 =item How do I create a switch or case statement?
1588 =item How can I catch accesses to undefined variables, functions, or
1591 =item Why can't a method included in this same file be found?
1593 =item How can I find out my current package?
1595 =item How can I comment out a large block of perl code?
1597 =item How do I clear a package?
1599 =item How can I use a variable as a variable name?
1601 =item What does "bad interpreter" mean?
1607 =item AUTHOR AND COPYRIGHT
1611 =head2 perlfaq8 - System Interaction ($Revision: 8539 $)
1619 =item How do I find out which operating system I'm running under?
1621 =item How come exec() doesn't return?
1623 =item How do I do fancy stuff with the keyboard/screen/mouse?
1625 Keyboard, Screen, Mouse
1627 =item How do I print something out in color?
1629 =item How do I read just one key without waiting for a return key?
1631 =item How do I check whether input is ready on the keyboard?
1633 =item How do I clear the screen?
1635 =item How do I get the screen size?
1637 =item How do I ask the user for a password?
1639 =item How do I read and write the serial port?
1641 lockfiles, open mode, end of line, flushing output, non-blocking input
1643 =item How do I decode encrypted password files?
1645 =item How do I start a process in the background?
1647 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
1649 =item How do I trap control characters/signals?
1651 =item How do I modify the shadow password file on a Unix system?
1653 =item How do I set the time and date?
1655 =item How can I sleep() or alarm() for under a second?
1657 =item How can I measure time under a second?
1659 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
1661 =item Why doesn't my sockets program work under System V (Solaris)? What
1662 does the error message "Protocol not supported" mean?
1664 =item How can I call my system's unique C functions from Perl?
1666 =item Where do I get the include files to do ioctl() or syscall()?
1668 =item Why do setuid perl scripts complain about kernel problems?
1670 =item How can I open a pipe both to and from a command?
1672 =item Why can't I get the output of a command with system()?
1674 =item How can I capture STDERR from an external command?
1676 =item Why doesn't open() return an error when a pipe open fails?
1678 =item What's wrong with using backticks in a void context?
1680 =item How can I call backticks without shell processing?
1682 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
1685 =item How can I convert my shell script to perl?
1687 =item Can I use perl to run a telnet or ftp session?
1689 =item How can I write expect in Perl?
1691 =item Is there a way to hide perl's command line from programs such as
1694 =item I {changed directory, modified my environment} in a perl script. How
1695 come the change disappeared when I exited the script? How do I get my
1696 changes to be visible?
1700 =item How do I close a process's filehandle without waiting for it to
1703 =item How do I fork a daemon process?
1705 =item How do I find out if I'm running interactively or not?
1707 =item How do I timeout a slow event?
1709 =item How do I set CPU limits?
1711 =item How do I avoid zombies on a Unix system?
1713 =item How do I use an SQL database?
1715 =item How do I make a system() exit on control-C?
1717 =item How do I open a file without blocking?
1719 =item How do I tell the difference between errors from the shell and perl?
1721 =item How do I install a module from CPAN?
1723 =item What's the difference between require and use?
1725 =item How do I keep my own module/library directory?
1727 =item How do I add the directory my program lives in to the module/library
1730 =item How do I add a directory to my include path (@INC) at runtime?
1732 =item What is socket.ph and where do I get it?
1738 =item AUTHOR AND COPYRIGHT
1742 =head2 perlfaq9 - Networking ($Revision: 8539 $)
1750 =item What is the correct form of response from a CGI script?
1752 =item My CGI script runs from the command line but not the browser. (500
1755 =item How can I get better error messages from a CGI program?
1757 =item How do I remove HTML from a string?
1759 =item How do I extract URLs?
1761 =item How do I download a file from the user's machine? How do I open a
1762 file on another machine?
1764 =item How do I make an HTML pop-up menu with Perl?
1766 =item How do I fetch an HTML file?
1768 =item How do I automate an HTML form submission?
1770 =item How do I decode or create those %-encodings on the web?
1772 =item How do I redirect to another page?
1774 =item How do I put a password on my web pages?
1776 =item How do I edit my .htpasswd and .htgroup files with Perl?
1778 =item How do I make sure users can't enter values into a form that cause my
1779 CGI script to do bad things?
1781 =item How do I parse a mail header?
1783 =item How do I decode a CGI form?
1785 =item How do I check a valid mail address?
1787 =item How do I decode a MIME/BASE64 string?
1789 =item How do I return the user's mail address?
1791 =item How do I send mail?
1793 =item How do I use MIME to make an attachment to a mail message?
1795 =item How do I read mail?
1797 =item How do I find out my hostname, domainname, or IP address?
1798 X<hostname, domainname, IP address, host, domain, hostfqdn, inet_ntoa,
1799 gethostbyname, Socket, Net::Domain, Sys::Hostname>
1801 =item How do I fetch a news article or the active newsgroups?
1803 =item How do I fetch/put an FTP file?
1805 =item How can I do RPC in Perl?
1811 =item AUTHOR AND COPYRIGHT
1815 =head2 perlsyn - Perl syntax
1824 X<declaration> X<undef> X<undefined> X<uninitialized>
1829 =item Simple Statements
1830 X<statement> X<semicolon> X<expression> X<;>
1832 =item Truth and Falsehood
1833 X<truth> X<falsehood> X<true> X<false> X<!> X<not> X<negation> X<0>
1835 =item Statement Modifiers
1836 X<statement modifier> X<modifier> X<if> X<unless> X<while>
1837 X<until> X<foreach> X<for>
1839 =item Compound Statements
1840 X<statement, compound> X<block> X<bracket, curly> X<curly bracket> X<brace>
1841 X<{> X<}> X<if> X<unless> X<while> X<until> X<foreach> X<for> X<continue>
1844 X<loop control> X<loop, control> X<next> X<last> X<redo> X<continue>
1855 =item Switch statements
1856 X<switch> X<case> X<given> X<when> X<default>
1863 =item PODs: Embedded Documentation
1864 X<POD> X<documentation>
1866 =item Plain Old Comments (Not!)
1867 X<comment> X<line> X<#> X<preprocessor> X<eval>
1873 =head2 perldata - Perl data types
1881 =item Variable names
1882 X<variable, name> X<variable name> X<data type> X<type>
1885 X<context> X<scalar context> X<list context>
1888 X<scalar> X<number> X<string> X<reference>
1890 =item Scalar value constructors
1891 X<scalar, literal> X<scalar, constant>
1893 =item List value constructors
1899 X<slice> X<array, slice> X<hash, slice>
1901 =item Typeglobs and Filehandles
1902 X<typeglob> X<filehandle> X<*>
1910 =head2 perlop - Perl operators and precedence
1918 =item Operator Precedence and Associativity
1919 X<operator, precedence> X<precedence> X<associativity>
1921 =item Terms and List Operators (Leftward)
1922 X<list operator> X<operator, list> X<term>
1924 =item The Arrow Operator
1925 X<arrow> X<dereference> X<< -> >>
1927 =item Auto-increment and Auto-decrement
1928 X<increment> X<auto-increment> X<++> X<decrement> X<auto-decrement> X<-->
1930 =item Exponentiation
1931 X<**> X<exponentiation> X<power>
1933 =item Symbolic Unary Operators
1934 X<unary operator> X<operator, unary>
1936 =item Binding Operators
1937 X<binding> X<operator, binding> X<=~> X<!~>
1939 =item Multiplicative Operators
1940 X<operator, multiplicative>
1942 =item Additive Operators
1943 X<operator, additive>
1945 =item Shift Operators
1946 X<shift operator> X<operator, shift> X<<< << >>>
1947 X<<< >> >>> X<right shift> X<left shift> X<bitwise shift>
1948 X<shl> X<shr> X<shift, right> X<shift, left>
1950 =item Named Unary Operators
1951 X<operator, named unary>
1953 =item Relational Operators
1954 X<relational operator> X<operator, relational>
1956 =item Equality Operators
1957 X<equality> X<equal> X<equals> X<operator, equality>
1960 X<operator, bitwise, and> X<bitwise and> X<&>
1962 =item Bitwise Or and Exclusive Or
1963 X<operator, bitwise, or> X<bitwise or> X<|> X<operator, bitwise, xor>
1966 =item C-style Logical And
1967 X<&&> X<logical and> X<operator, logical, and>
1969 =item C-style Logical Or
1970 X<||> X<operator, logical, or>
1972 =item C-style Logical Defined-Or
1973 X<//> X<operator, logical, defined-or>
1975 =item Range Operators
1976 X<operator, range> X<range> X<..> X<...>
1978 =item Conditional Operator
1979 X<operator, conditional> X<operator, ternary> X<ternary> X<?:>
1981 =item Assignment Operators
1982 X<assignment> X<operator, assignment> X<=> X<**=> X<+=> X<*=> X<&=>
1983 X<<< <<= >>> X<&&=> X<-=> X</=> X<|=> X<<< >>= >>> X<||=> X<//=> X<.=>
1986 =item Comma Operator
1987 X<comma> X<operator, comma> X<,>
1989 =item List Operators (Rightward)
1990 X<operator, list, rightward> X<list operator>
1993 X<operator, logical, not> X<not>
1996 X<operator, logical, and> X<and>
1998 =item Logical or, Defined or, and Exclusive Or
1999 X<operator, logical, or> X<operator, logical, xor> X<operator, logical,
2001 X<operator, logical, defined or> X<operator, logical, exclusive or>
2004 =item C Operators Missing From Perl
2005 X<operator, missing from perl> X<&> X<*>
2006 X<typecasting> X<(TYPE)>
2008 unary &, unary *, (TYPE)
2010 =item Quote and Quote-like Operators
2011 X<operator, quote> X<operator, quote-like> X<q> X<qq> X<qx> X<qw> X<m>
2012 X<qr> X<s> X<tr> X<'> X<''> X<"> X<""> X<//> X<`> X<``> X<<< << >>>
2013 X<escape sequence> X<escape>
2015 =item Regexp Quote-Like Operators
2018 qr/STRING/msixpo X<qr> X</i> X</m> X</o> X</s> X</x> X</p>,
2019 m/PATTERN/msixpogc X<m> X<operator, match> X<regexp, options> X<regexp>
2020 X<regex, options> X<regex> X</m> X</s> X</i> X</x> X</p> X</o> X</g> X</c>,
2021 /PATTERN/msixpogc, ?PATTERN? X<?>, s/PATTERN/REPLACEMENT/msixpogce
2022 X<substitute> X<substitution> X<replace> X<regexp, replace> X<regexp,
2023 substitute> X</m> X</s> X</i> X</x> X</p> X</o> X</g> X</c> X</e>
2025 =item Quote-Like Operators
2026 X<operator, quote-like>
2028 q/STRING/ X<q> X<quote, single> X<'> X<''>, 'STRING', qq/STRING/ X<qq>
2029 X<quote, double> X<"> X<"">, "STRING", qx/STRING/ X<qx> X<`> X<``>
2030 X<backtick>, `STRING`, qw/STRING/ X<qw> X<quote, list> X<quote, words>,
2031 tr/SEARCHLIST/REPLACEMENTLIST/cds X<tr> X<y> X<transliterate> X</c> X</d>
2032 X</s>, y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF X<here-doc> X<heredoc>
2033 X<here-document> X<<< << >>>, Double Quotes, Single Quotes, Backticks
2035 =item Gory details of parsing quoted constructs
2036 X<quote, gory details>
2038 Finding the end, Interpolation X<interpolation>, C<<<'EOF'>, C<m''>, the
2039 pattern of C<s'''>, C<''>, C<q//>, C<tr'''>, C<y'''>, the replacement of
2040 C<s'''>, C<tr///>, C<y///>, C<"">, C<``>, C<qq//>, C<qx//>, C<< <file*glob>
2041 >>, C<<<"EOF">, the replacement of C<s///>, C<RE> in C<?RE?>, C</RE/>,
2042 C<m/RE/>, C<s/RE/foo/>,, parsing regular expressions X<regexp, parse>,
2043 Optimization of regular expressions X<regexp, optimization>
2046 X<operator, i/o> X<operator, io> X<io> X<while> X<filehandle>
2049 =item Constant Folding
2050 X<constant folding> X<folding>
2055 =item Bitwise String Operators
2056 X<operator, bitwise, string>
2058 =item Integer Arithmetic
2061 =item Floating-point Arithmetic
2062 X<floating-point> X<floating point> X<float> X<real>
2064 =item Bigger Numbers
2065 X<number, arbitrary precision>
2071 =head2 perlsub - Perl subroutines
2081 =item Private Variables via my()
2082 X<my> X<variable, lexical> X<lexical> X<lexical variable> X<scope, lexical>
2083 X<lexical scope> X<attributes, my>
2085 =item Persistent Private Variables
2086 X<state> X<state variable> X<static> X<variable, persistent> X<variable,
2089 =item Temporary Values via local()
2090 X<local> X<scope, dynamic> X<dynamic scope> X<variable, local>
2091 X<variable, temporary>
2093 =item Lvalue subroutines
2094 X<lvalue> X<subroutine, lvalue>
2096 Lvalue subroutines are EXPERIMENTAL
2098 =item Passing Symbol Table Entries (typeglobs)
2101 =item When to Still Use local()
2102 X<local> X<variable, local>
2104 =item Pass by Reference
2105 X<pass by reference> X<pass-by-reference> X<reference>
2108 X<prototype> X<subroutine, prototype>
2110 =item Constant Functions
2113 =item Overriding Built-in Functions
2114 X<built-in> X<override> X<CORE> X<CORE::GLOBAL>
2117 X<autoloading> X<AUTOLOAD>
2119 =item Subroutine Attributes
2120 X<attribute> X<subroutine, attribute> X<attrs>
2128 =head2 perlfunc - Perl builtin functions
2136 =item Perl Functions by Category
2139 Functions for SCALARs or strings X<scalar> X<string> X<character>, Regular
2140 expressions and pattern matching X<regular expression> X<regex> X<regexp>,
2141 Numeric functions X<numeric> X<number> X<trigonometric> X<trigonometry>,
2142 Functions for real @ARRAYs X<array>, Functions for list data X<list>,
2143 Functions for real %HASHes X<hash>, Input and output functions X<I/O>
2144 X<input> X<output> X<dbm>, Functions for fixed length data or records,
2145 Functions for filehandles, files, or directories X<file> X<filehandle>
2146 X<directory> X<pipe> X<link> X<symlink>, Keywords related to the control
2147 flow of your Perl program X<control flow>, Keywords related to switch,
2148 Keywords related to scoping, Miscellaneous functions, Functions for
2149 processes and process groups X<process> X<pid> X<process id>, Keywords
2150 related to perl modules X<module>, Keywords related to classes and
2151 object-orientedness X<object> X<class> X<package>, Low-level socket
2152 functions X<socket> X<sock>, System V interprocess communication functions
2153 X<IPC> X<System V> X<semaphore> X<shared memory> X<memory> X<message>,
2154 Fetching user and group info X<user> X<group> X<password> X<uid> X<gid>
2155 X<passwd> X</etc/passwd>, Fetching network info X<network> X<protocol>
2156 X<host> X<hostname> X<IP> X<address> X<service>, Time-related functions
2157 X<time> X<date>, Functions new in perl5 X<perl5>, Functions obsoleted in
2161 X<portability> X<Unix> X<portable>
2163 =item Alphabetical Listing of Perl Functions
2166 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>
2167 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,
2168 -I<X> DIRHANDLE, -I<X>, abs VALUE X<abs> X<absolute>, abs, accept
2169 NEWSOCKET,GENERICSOCKET X<accept>, alarm SECONDS X<alarm> X<SIGALRM>
2170 X<timer>, alarm, atan2 Y,X X<atan2> X<arctangent> X<tan> X<tangent>, bind
2171 SOCKET,NAME X<bind>, binmode FILEHANDLE, LAYER X<binmode> X<binary> X<text>
2172 X<DOS> X<Windows>, binmode FILEHANDLE, bless REF,CLASSNAME X<bless>, bless
2173 REF, break, caller EXPR X<caller> X<call stack> X<stack> X<stack trace>,
2174 caller, chdir EXPR X<chdir> X<cd> X<directory, change>, chdir FILEHANDLE,
2175 chdir DIRHANDLE, chdir, chmod LIST X<chmod> X<permission> X<mode>, chomp
2176 VARIABLE X<chomp> X<INPUT_RECORD_SEPARATOR> X<$/> X<newline> X<eol>, chomp(
2177 LIST ), chomp, chop VARIABLE X<chop>, chop( LIST ), chop, chown LIST
2178 X<chown> X<owner> X<user> X<group>, chr NUMBER X<chr> X<character> X<ASCII>
2179 X<Unicode>, chr, chroot FILENAME X<chroot> X<root>, chroot, close
2180 FILEHANDLE X<close>, close, closedir DIRHANDLE X<closedir>, connect
2181 SOCKET,NAME X<connect>, continue BLOCK X<continue>, continue, cos EXPR
2182 X<cos> X<cosine> X<acos> X<arccosine>, cos, crypt PLAINTEXT,SALT X<crypt>
2183 X<digest> X<hash> X<salt> X<plaintext> X<password> X<decrypt>
2184 X<cryptography> X<passwd> X<encrypt>, dbmclose HASH X<dbmclose>, dbmopen
2185 HASH,DBNAME,MASK X<dbmopen> X<dbm> X<ndbm> X<sdbm> X<gdbm>, defined EXPR
2186 X<defined> X<undef> X<undefined>, defined, delete EXPR X<delete>, die LIST
2187 X<die> X<throw> X<exception> X<raise> X<$@> X<abort>, do BLOCK X<do>
2188 X<block>, do SUBROUTINE(LIST) X<do>, do EXPR X<do>, dump LABEL X<dump>
2189 X<core> X<undump>, dump, each HASH X<each> X<hash, iterator>, eof
2190 FILEHANDLE X<eof> X<end of file> X<end-of-file>, eof (), eof, eval EXPR
2191 X<eval> X<try> X<catch> X<evaluate> X<parse> X<execute> X<error, handling>
2192 X<exception, handling>, eval BLOCK, eval, exec LIST X<exec> X<execute>,
2193 exec PROGRAM LIST, exists EXPR X<exists> X<autovivification>, exit EXPR
2194 X<exit> X<terminate> X<abort>, exit, exp EXPR X<exp> X<exponential>
2195 X<antilog> X<antilogarithm> X<e>, exp, fcntl FILEHANDLE,FUNCTION,SCALAR
2196 X<fcntl>, fileno FILEHANDLE X<fileno>, flock FILEHANDLE,OPERATION X<flock>
2197 X<lock> X<locking>, fork X<fork> X<child> X<parent>, format X<format>,
2198 formline PICTURE,LIST X<formline>, getc FILEHANDLE X<getc> X<getchar>
2199 X<character> X<file, read>, getc, getlogin X<getlogin> X<login>,
2200 getpeername SOCKET X<getpeername> X<peer>, getpgrp PID X<getpgrp> X<group>,
2201 getppid X<getppid> X<parent> X<pid>, getpriority WHICH,WHO X<getpriority>
2202 X<priority> X<nice>, getpwnam NAME X<getpwnam> X<getgrnam> X<gethostbyname>
2203 X<getnetbyname> X<getprotobyname> X<getpwuid> X<getgrgid> X<getservbyname>
2204 X<gethostbyaddr> X<getnetbyaddr> X<getprotobynumber> X<getservbyport>
2205 X<getpwent> X<getgrent> X<gethostent> X<getnetent> X<getprotoent>
2206 X<getservent> X<setpwent> X<setgrent> X<sethostent> X<setnetent>
2207 X<setprotoent> X<setservent> X<endpwent> X<endgrent> X<endhostent>
2208 X<endnetent> X<endprotoent> X<endservent>, getgrnam NAME, gethostbyname
2209 NAME, getnetbyname NAME, getprotobyname NAME, getpwuid UID, getgrgid GID,
2210 getservbyname NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE, getnetbyaddr
2211 ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent,
2212 getgrent, gethostent, getnetent, getprotoent, getservent, setpwent,
2213 setgrent, sethostent STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN,
2214 setservent STAYOPEN, endpwent, endgrent, endhostent, endnetent,
2215 endprotoent, endservent, getsockname SOCKET X<getsockname>, getsockopt
2216 SOCKET,LEVEL,OPTNAME X<getsockopt>, glob EXPR X<glob> X<wildcard>
2217 X<filename, expansion> X<expand>, glob, gmtime EXPR X<gmtime> X<UTC>
2218 X<Greenwich>, gmtime, goto LABEL X<goto> X<jump> X<jmp>, goto EXPR, goto
2219 &NAME, grep BLOCK LIST X<grep>, grep EXPR,LIST, hex EXPR X<hex>
2220 X<hexadecimal>, hex, import LIST X<import>, index STR,SUBSTR,POSITION
2221 X<index> X<indexOf> X<InStr>, index STR,SUBSTR, int EXPR X<int> X<integer>
2222 X<truncate> X<trunc> X<floor>, int, ioctl FILEHANDLE,FUNCTION,SCALAR
2223 X<ioctl>, join EXPR,LIST X<join>, keys HASH X<keys> X<key>, kill SIGNAL,
2224 LIST X<kill> X<signal>, last LABEL X<last> X<break>, last, lc EXPR X<lc>
2225 X<lowercase>, lc, lcfirst EXPR X<lcfirst> X<lowercase>, lcfirst, length
2226 EXPR X<length> X<size>, length, link OLDFILE,NEWFILE X<link>, listen
2227 SOCKET,QUEUESIZE X<listen>, local EXPR X<local>, localtime EXPR
2228 X<localtime> X<ctime>, localtime, lock THING X<lock>, log EXPR X<log>
2229 X<logarithm> X<e> X<ln> X<base>, log, lstat EXPR X<lstat>, lstat, m//, map
2230 BLOCK LIST X<map>, map EXPR,LIST, mkdir FILENAME,MASK X<mkdir> X<md>
2231 X<directory, create>, mkdir FILENAME, mkdir, msgctl ID,CMD,ARG X<msgctl>,
2232 msgget KEY,FLAGS X<msgget>, msgrcv ID,VAR,SIZE,TYPE,FLAGS X<msgrcv>, msgsnd
2233 ID,MSG,FLAGS X<msgsnd>, my EXPR X<my>, my TYPE EXPR, my EXPR : ATTRS, my
2234 TYPE EXPR : ATTRS, next LABEL X<next> X<continue>, next, no Module VERSION
2235 LIST X<no>, no Module VERSION, no Module LIST, no Module, no VERSION, oct
2236 EXPR X<oct> X<octal> X<hex> X<hexadecimal> X<binary> X<bin>, oct, open
2237 FILEHANDLE,EXPR X<open> X<pipe> X<file, open> X<fopen>, open
2238 FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, open
2239 FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, opendir DIRHANDLE,EXPR
2240 X<opendir>, ord EXPR X<ord> X<encoding>, ord, our EXPR X<our> X<global>,
2241 our TYPE EXPR, our EXPR : ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST
2242 X<pack>, package NAMESPACE X<package> X<module> X<namespace>, package, pipe
2243 READHANDLE,WRITEHANDLE X<pipe>, pop ARRAY X<pop> X<stack>, pop, pos SCALAR
2244 X<pos> X<match, position>, pos, print FILEHANDLE LIST X<print>, print LIST,
2245 print, printf FILEHANDLE FORMAT, LIST X<printf>, printf FORMAT, LIST,
2246 prototype FUNCTION X<prototype>, push ARRAY,LIST X<push> X<stack>,
2247 q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR
2248 X<quotemeta> X<metacharacter>, quotemeta, rand EXPR X<rand> X<random>,
2249 rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET X<read> X<file, read>, read
2250 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE X<readdir>, readline EXPR,
2251 readline X<readline> X<gets> X<fgets>, readlink EXPR X<readlink>, readlink,
2252 readpipe EXPR, readpipe X<readpipe>, recv SOCKET,SCALAR,LENGTH,FLAGS
2253 X<recv>, redo LABEL X<redo>, redo, ref EXPR X<ref> X<reference>, ref,
2254 rename OLDNAME,NEWNAME X<rename> X<move> X<mv> X<ren>, require VERSION
2255 X<require>, require EXPR, require, reset EXPR X<reset>, reset, return EXPR
2256 X<return>, return, reverse LIST X<reverse> X<rev> X<invert>, rewinddir
2257 DIRHANDLE X<rewinddir>, rindex STR,SUBSTR,POSITION X<rindex>, rindex
2258 STR,SUBSTR, rmdir FILENAME X<rmdir> X<rd> X<directory, remove>, rmdir,
2259 s///, say FILEHANDLE LIST X<say>, say LIST, say, scalar EXPR X<scalar>
2260 X<context>, seek FILEHANDLE,POSITION,WHENCE X<seek> X<fseek> X<filehandle,
2261 position>, seekdir DIRHANDLE,POS X<seekdir>, select FILEHANDLE X<select>
2262 X<filehandle, default>, select, select RBITS,WBITS,EBITS,TIMEOUT X<select>,
2263 semctl ID,SEMNUM,CMD,ARG X<semctl>, semget KEY,NSEMS,FLAGS X<semget>, semop
2264 KEY,OPSTRING X<semop>, send SOCKET,MSG,FLAGS,TO X<send>, send
2265 SOCKET,MSG,FLAGS, setpgrp PID,PGRP X<setpgrp> X<group>, setpriority
2266 WHICH,WHO,PRIORITY X<setpriority> X<priority> X<nice> X<renice>, setsockopt
2267 SOCKET,LEVEL,OPTNAME,OPTVAL X<setsockopt>, shift ARRAY X<shift>, shift,
2268 shmctl ID,CMD,ARG X<shmctl>, shmget KEY,SIZE,FLAGS X<shmget>, shmread
2269 ID,VAR,POS,SIZE X<shmread> X<shmwrite>, shmwrite ID,STRING,POS,SIZE,
2270 shutdown SOCKET,HOW X<shutdown>, sin EXPR X<sin> X<sine> X<asin>
2271 X<arcsine>, sin, sleep EXPR X<sleep> X<pause>, sleep, socket
2272 SOCKET,DOMAIN,TYPE,PROTOCOL X<socket>, socketpair
2273 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL X<socketpair>, sort SUBNAME LIST
2274 X<sort> X<qsort> X<quicksort> X<mergesort>, sort BLOCK LIST, sort LIST,
2275 splice ARRAY,OFFSET,LENGTH,LIST X<splice>, splice ARRAY,OFFSET,LENGTH,
2276 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT X<split>,
2277 split /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST
2278 X<sprintf>, format parameter index, flags, vector flag, (minimum) width,
2279 precision, or maximum width X<precision>, size, order of arguments, sqrt
2280 EXPR X<sqrt> X<root> X<square root>, sqrt, srand EXPR X<srand> X<seed>
2281 X<randseed>, srand, stat FILEHANDLE X<stat> X<file, status> X<ctime>, stat
2282 EXPR, stat DIRHANDLE, stat, state EXPR X<state>, state TYPE EXPR, state
2283 EXPR : ATTRS, state TYPE EXPR : ATTRS, study SCALAR X<study>, study, sub
2284 NAME BLOCK X<sub>, sub NAME (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub NAME
2285 (PROTO) : ATTRS BLOCK, substr EXPR,OFFSET,LENGTH,REPLACEMENT X<substr>
2286 X<substring> X<mid> X<left> X<right>, substr EXPR,OFFSET,LENGTH, substr
2287 EXPR,OFFSET, symlink OLDFILE,NEWFILE X<symlink> X<link> X<symbolic link>
2288 X<link, symbolic>, syscall NUMBER, LIST X<syscall> X<system call>, sysopen
2289 FILEHANDLE,FILENAME,MODE X<sysopen>, sysopen
2290 FILEHANDLE,FILENAME,MODE,PERMS, sysread FILEHANDLE,SCALAR,LENGTH,OFFSET
2291 X<sysread>, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
2292 FILEHANDLE,POSITION,WHENCE X<sysseek> X<lseek>, system LIST X<system>
2293 X<shell>, system PROGRAM LIST, syswrite FILEHANDLE,SCALAR,LENGTH,OFFSET
2294 X<syswrite>, syswrite FILEHANDLE,SCALAR,LENGTH, syswrite FILEHANDLE,SCALAR,
2295 tell FILEHANDLE X<tell>, tell, telldir DIRHANDLE X<telldir>, tie
2296 VARIABLE,CLASSNAME,LIST X<tie>, tied VARIABLE X<tied>, time X<time>
2297 X<epoch>, times X<times>, tr///, truncate FILEHANDLE,LENGTH X<truncate>,
2298 truncate EXPR,LENGTH, uc EXPR X<uc> X<uppercase> X<toupper>, uc, ucfirst
2299 EXPR X<ucfirst> X<uppercase>, ucfirst, umask EXPR X<umask>, umask, undef
2300 EXPR X<undef> X<undefine>, undef, unlink LIST X<unlink> X<delete> X<remove>
2301 X<rm> X<del>, unlink, unpack TEMPLATE,EXPR X<unpack>, unpack TEMPLATE,
2302 untie VARIABLE X<untie>, unshift ARRAY,LIST X<unshift>, use Module VERSION
2303 LIST X<use> X<module> X<import>, use Module VERSION, use Module LIST, use
2304 Module, use VERSION, utime LIST X<utime>, values HASH X<values>, vec
2305 EXPR,OFFSET,BITS X<vec> X<bit> X<bit vector>, wait X<wait>, waitpid
2306 PID,FLAGS X<waitpid>, wantarray X<wantarray> X<context>, warn LIST X<warn>
2307 X<warning> X<STDERR>, write FILEHANDLE X<write>, write EXPR, write, y///
2313 =head2 perlopentut - tutorial on opening things in Perl
2319 =item Open E<agrave> la shell
2325 =item Indirect Filehandles
2329 =item The Minus File
2331 =item Mixing Reads and Writes
2337 =item Open E<agrave> la C
2341 =item Permissions E<agrave> la mode
2345 =item Obscure Open Tricks
2349 =item Re-Opening Files (dups)
2351 =item Dispelling the Dweomer
2353 =item Paths as Opens
2355 =item Single Argument Open
2357 =item Playing with STDIN and STDOUT
2361 =item Other I/O Issues
2365 =item Opening Non-File Files
2367 =item Opening Named Pipes
2369 =item Opening Sockets
2381 =item AUTHOR and COPYRIGHT
2387 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
2393 =item The Basic Principle
2397 =item Packing Numbers
2403 =item Unpacking a Stack Frame
2405 =item How to Eat an Egg on a Net
2407 =item Byte-order modifiers
2409 =item Floating point Numbers
2413 =item Exotic Templates
2425 =item Another Portable Binary Encoding
2429 =item Template Grouping
2431 =item Lengths and Widths
2435 =item String Lengths
2437 =item Dynamic Templates
2439 =item Counting Repetitions
2443 =item Packing and Unpacking C Structures
2447 =item The Alignment Pit
2449 =item Dealing with Endian-ness
2451 =item Alignment, Take 2
2453 =item Alignment, Take 3
2455 =item Pointers for How to Use Them
2461 =item Funnies Section
2467 =head2 perlpod - the Plain Old Documentation format
2475 =item Ordinary Paragraph
2476 X<POD, ordinary paragraph>
2478 =item Verbatim Paragraph
2479 X<POD, verbatim paragraph> X<verbatim>
2481 =item Command Paragraph
2484 C<=head1 I<Heading Text>> X<=head1> X<=head2> X<=head3> X<=head4> X<head1>
2485 X<head2> X<head3> X<head4>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
2486 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>> X<=over>
2487 X<=item> X<=back> X<over> X<item> X<back>, C<=item I<stuff...>>, C<=back>,
2488 C<=cut> X<=cut> X<cut>, C<=pod> X<=pod> X<pod>, C<=begin I<formatname>>
2489 X<=begin> X<=end> X<=for> X<begin> X<end> X<for>, C<=end I<formatname>>,
2490 C<=for I<formatname> I<text...>>, C<=encoding I<encodingname>> X<=encoding>
2493 =item Formatting Codes
2494 X<POD, formatting code> X<formatting code>
2495 X<POD, interior sequence> X<interior sequence>
2497 C<IE<lt>textE<gt>> -- italic text X<I> X<< IZ<><> >> X<POD, formatting
2498 code, italic> X<italic>, C<BE<lt>textE<gt>> -- bold text X<B> X<< BZ<><> >>
2499 X<POD, formatting code, bold> X<bold>, C<CE<lt>codeE<gt>> -- code text X<C>
2500 X<< CZ<><> >> X<POD, formatting code, code> X<code>, C<LE<lt>nameE<gt>> --
2501 a hyperlink X<L> X<< LZ<><> >> X<POD, formatting code, hyperlink>
2502 X<hyperlink>, C<EE<lt>escapeE<gt>> -- a character escape X<E> X<< EZ<><> >>
2503 X<POD, formatting code, escape> X<escape>, C<FE<lt>filenameE<gt>> -- used
2504 for filenames X<F> X<< FZ<><> >> X<POD, formatting code, filename>
2505 X<filename>, C<SE<lt>textE<gt>> -- text contains non-breaking spaces X<S>
2506 X<< SZ<><> >> X<POD, formatting code, non-breaking space> X<non-breaking
2507 space>, C<XE<lt>topic nameE<gt>> -- an index entry X<X> X<< XZ<><> >>
2508 X<POD, formatting code, index entry> X<index entry>, C<ZE<lt>E<gt>> -- a
2509 null (zero-effect) formatting code X<Z> X<< ZZ<><> >> X<POD, formatting
2515 =item Embedding Pods in Perl Modules
2518 =item Hints for Writing Pod
2520 X<podchecker> X<POD, validating>
2530 =head2 perlpodspec - Plain Old Documentation: format specification and
2537 =item Pod Definitions
2541 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
2542 "=back", "=begin formatname", "=end formatname", "=for formatname text...",
2543 "=encoding encodingname"
2545 =item Pod Formatting Codes
2547 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2548 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
2549 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
2550 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
2551 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
2552 contains non-breaking spaces
2554 =item Notes on Implementing Pod Processors
2556 =item About LE<lt>...E<gt> Codes
2558 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
2560 =item About =over...=back Regions
2562 =item About Data Paragraphs and "=begin/=end" Regions
2570 =head2 perlrun - how to execute the Perl interpreter
2580 =item #! and quoting on non-Unix systems
2583 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
2585 =item Location of Perl
2586 X<perl, location of interpreter>
2588 =item Command Switches
2589 X<perl, command switches> X<command switches>
2591 B<-0>[I<octal/hexadecimal>] X<-0> X<$/>, B<-A[I<module>][=I<assertions>]>
2592 X<-A>, B<-a> X<-a> X<autosplit>, B<-C [I<number/list>]> X<-C>, B<-c> X<-c>,
2593 B<-d> X<-d> X<-dt>, B<-dt>, B<-d:>I<foo[=bar,baz]> X<-d> X<-dt>,
2594 B<-dt:>I<foo[=bar,baz]>, B<-D>I<letters> X<-D> X<DEBUGGING> X<-DDEBUGGING>,
2595 B<-D>I<number>, B<-e> I<commandline> X<-e>, B<-E> I<commandline> X<-E>,
2596 B<-f> X<-f>, B<-F>I<pattern> X<-F>, B<-h> X<-h>, B<-i>[I<extension>] X<-i>
2597 X<in-place>, B<-I>I<directory> X<-I> X<@INC>, B<-l>[I<octnum>] X<-l> X<$/>
2598 X<$\>, B<-m>[B<->]I<module> X<-m> X<-M>, B<-M>[B<->]I<module>,
2599 B<-M>[B<->]I<'module ...'>, B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>
2600 X<-n>, B<-p> X<-p>, B<-P> X<-P>, B<-s> X<-s>, B<-S> X<-S>, B<-t> X<-t>,
2601 B<-T> X<-T>, B<-u> X<-u>, B<-U> X<-U>, B<-v> X<-v>, B<-V> X<-V>,
2602 B<-V:>I<configvar>, B<-w> X<-w>, B<-W> X<-W>, B<-X> X<-X>, B<-x> X<-x>,
2608 X<perl, environment variables>
2610 HOME X<HOME>, LOGDIR X<LOGDIR>, PATH X<PATH>, PERL5LIB X<PERL5LIB>,
2611 PERL5OPT X<PERL5OPT>, PERLIO X<PERLIO>, :bytes X<:bytes>, :crlf X<:crlf>,
2612 :mmap X<:mmap>, :perlio X<:perlio>, :pop X<:pop>, :raw X<:raw>, :stdio
2613 X<:stdio>, :unix X<:unix>, :utf8 X<:utf8>, :win32 X<:win32>, PERLIO_DEBUG
2614 X<PERLIO_DEBUG>, PERLLIB X<PERLLIB>, PERL5DB X<PERL5DB>, PERL5DB_THREADED
2615 X<PERL5DB_THREADED>, PERL5SHELL (specific to the Win32 port) X<PERL5SHELL>,
2616 PERL_ALLOW_NON_IFS_LSP (specific to the Win32 port)
2617 X<PERL_ALLOW_NON_IFS_LSP>, PERL_DEBUG_MSTATS X<PERL_DEBUG_MSTATS>,
2618 PERL_DESTRUCT_LEVEL X<PERL_DESTRUCT_LEVEL>, PERL_DL_NONLAZY
2619 X<PERL_DL_NONLAZY>, PERL_ENCODING X<PERL_ENCODING>, PERL_HASH_SEED
2620 X<PERL_HASH_SEED>, PERL_HASH_SEED_DEBUG X<PERL_HASH_SEED_DEBUG>, PERL_ROOT
2621 (specific to the VMS port) X<PERL_ROOT>, PERL_SIGNALS X<PERL_SIGNALS>,
2622 PERL_UNICODE X<PERL_UNICODE>, SYS$LOGIN (specific to the VMS port)
2627 =head2 perldiag - various Perl diagnostics
2635 =head2 perllexwarn - Perl Lexical Warnings
2643 =item Default Warnings and Optional Warnings
2645 =item What's wrong with B<-w> and C<$^W>
2647 =item Controlling Warnings from the Command Line
2649 B<-w> X<-w>, B<-W> X<-W>, B<-X> X<-X>
2651 =item Backward Compatibility
2653 =item Category Hierarchy
2654 X<warning, categories>
2656 =item Fatal Warnings
2659 =item Reporting Warnings from a Module
2660 X<warning, reporting> X<warning, registering>
2672 =head2 perldebug - Perl debugging
2678 =item The Perl Debugger
2682 =item Debugger Commands
2684 h X<debugger command, h>, h [command], h h, p expr X<debugger command, p>,
2685 x [maxdepth] expr X<debugger command, x>, V [pkg [vars]] X<debugger
2686 command, V>, X [vars] X<debugger command, X>, y [level [vars]] X<debugger
2687 command, y>, T X<debugger command, T> X<backtrace> X<stack, backtrace>, s
2688 [expr] X<debugger command, s> X<step>, n [expr] X<debugger command, n>, r
2689 X<debugger command, r>, <CR>, c [line|sub] X<debugger command, c>, l
2690 X<debugger command, l>, l min+incr, l min-max, l line, l subname, -
2691 X<debugger command, ->, v [line] X<debugger command, v>, . X<debugger
2692 command, .>, f filename X<debugger command, f>, /pattern/, ?pattern?, L
2693 [abw] X<debugger command, L>, S [[!]regex] X<debugger command, S>, t
2694 X<debugger command, t>, t expr X<debugger command, t>, b X<breakpoint>
2695 X<debugger command, b>, b [line] [condition] X<breakpoint> X<debugger
2696 command, b>, b subname [condition] X<breakpoint> X<debugger command, b>, b
2697 postpone subname [condition] X<breakpoint> X<debugger command, b>, b load
2698 filename X<breakpoint> X<debugger command, b>, b compile subname
2699 X<breakpoint> X<debugger command, b>, B line X<breakpoint> X<debugger
2700 command, B>, B * X<breakpoint> X<debugger command, B>, a [line] command
2701 X<debugger command, a>, A line X<debugger command, A>, A * X<debugger
2702 command, A>, w expr X<debugger command, w>, W expr X<debugger command, W>,
2703 W * X<debugger command, W>, o X<debugger command, o>, o booloption ...
2704 X<debugger command, o>, o anyoption? ... X<debugger command, o>, o
2705 option=value ... X<debugger command, o>, < ? X<< debugger command, < >>, <
2706 [ command ] X<< debugger command, < >>, < * X<< debugger command, < >>, <<
2707 command X<< debugger command, << >>, > ? X<< debugger command, > >>, >
2708 command X<< debugger command, > >>, > * X<< debugger command, > >>, >>
2709 command X<<< debugger command, >> >>>, { ? X<debugger command, {>, { [
2710 command ], { * X<debugger command, {>, {{ command X<debugger command, {{>,
2711 ! number X<debugger command, !>, ! -number X<debugger command, !>, !
2712 pattern X<debugger command, !>, !! cmd X<debugger command, !!>, source file
2713 X<debugger command, source>, H -number X<debugger command, H>, q or ^D
2714 X<debugger command, q> X<debugger command, ^D>, R X<debugger command, R>,
2715 |dbcmd X<debugger command, |>, ||dbcmd X<debugger command, ||>, command, m
2716 expr X<debugger command, m>, M X<debugger command, M>, man [manpage]
2717 X<debugger command, man>
2719 =item Configurable Options
2721 C<recallCommand>, C<ShellBang> X<debugger option, recallCommand> X<debugger
2722 option, ShellBang>, C<pager> X<debugger option, pager>, C<tkRunning>
2723 X<debugger option, tkRunning>, C<signalLevel>, C<warnLevel>, C<dieLevel>
2724 X<debugger option, signalLevel> X<debugger option, warnLevel> X<debugger
2725 option, dieLevel>, C<AutoTrace> X<debugger option, AutoTrace>, C<LineInfo>
2726 X<debugger option, LineInfo>, C<inhibit_exit> X<debugger option,
2727 inhibit_exit>, C<PrintRet> X<debugger option, PrintRet>, C<ornaments>
2728 X<debugger option, ornaments>, C<frame> X<debugger option, frame>,
2729 C<maxTraceLen> X<debugger option, maxTraceLen>, C<windowSize> X<debugger
2730 option, windowSize>, C<arrayDepth>, C<hashDepth> X<debugger option,
2731 arrayDepth> X<debugger option, hashDepth>, C<dumpDepth> X<debugger option,
2732 dumpDepth>, C<compactDump>, C<veryCompact> X<debugger option, compactDump>
2733 X<debugger option, veryCompact>, C<globPrint> X<debugger option,
2734 globPrint>, C<DumpDBFiles> X<debugger option, DumpDBFiles>, C<DumpPackages>
2735 X<debugger option, DumpPackages>, C<DumpReused> X<debugger option,
2736 DumpReused>, C<quote>, C<HighBit>, C<undefPrint> X<debugger option, quote>
2737 X<debugger option, HighBit> X<debugger option, undefPrint>, C<UsageOnly>
2738 X<debugger option, UsageOnly>, C<TTY> X<debugger option, TTY>, C<noTTY>
2739 X<debugger option, noTTY>, C<ReadLine> X<debugger option, ReadLine>,
2740 C<NonStop> X<debugger option, NonStop>
2742 =item Debugger input/output
2744 Prompt, Multiline commands, Stack backtrace X<backtrace> X<stack,
2745 backtrace>, Line Listing Format, Frame listing
2747 =item Debugging compile-time statements
2749 =item Debugger Customization
2751 =item Readline Support
2753 =item Editor Support for Debugging
2755 =item The Perl Profiler
2756 X<profile> X<profiling> X<profiler>
2760 =item Debugging regular expressions
2761 X<regular expression, debugging>
2762 X<regex, debugging> X<regexp, debugging>
2764 =item Debugging memory usage
2773 =head2 perlvar - Perl predefined variables
2781 =item Predefined Names
2783 $ARG, $_ X<$_> X<$ARG>, $a, $b X<$a> X<$b>, $<I<digits>> X<$1> X<$2> X<$3>,
2784 $MATCH, $& X<$&> X<$MATCH>, ${^MATCH} X<${^MATCH}>, $PREMATCH, $` X<$`>
2785 X<$PREMATCH>, ${^PREMATCH} X<${^PREMATCH}>, $POSTMATCH, $' X<$'>
2786 X<$POSTMATCH>, ${^POSTMATCH} X<${^POSTMATCH}>, $LAST_PAREN_MATCH, $+ X<$+>
2787 X<$LAST_PAREN_MATCH>, $^N X<$^N>, @LAST_MATCH_END, @+ X<@+>
2788 X<@LAST_MATCH_END>, %+ X<%+>, HANDLE->input_line_number(EXPR),
2789 $INPUT_LINE_NUMBER, $NR, $. X<$.> X<$NR> X<$INPUT_LINE_NUMBER> X<line
2790 number>, IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR,
2791 $RS, $/ X<$/> X<$RS> X<$INPUT_RECORD_SEPARATOR>, HANDLE->autoflush(EXPR),
2792 $OUTPUT_AUTOFLUSH, $| X<$|> X<autoflush> X<flush> X<$OUTPUT_AUTOFLUSH>,
2793 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,
2794 X<$,> X<$OFS> X<$OUTPUT_FIELD_SEPARATOR>,
2795 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
2796 $\ X<$\> X<$ORS> X<$OUTPUT_RECORD_SEPARATOR>, $LIST_SEPARATOR, $" X<$">
2797 X<$LIST_SEPARATOR>, $SUBSCRIPT_SEPARATOR, $SUBSEP, $; X<$;> X<$SUBSEP>
2798 X<SUBSCRIPT_SEPARATOR>, HANDLE->format_page_number(EXPR),
2799 $FORMAT_PAGE_NUMBER, $% X<$%> X<$FORMAT_PAGE_NUMBER>,
2800 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $= X<$=>
2801 X<$FORMAT_LINES_PER_PAGE>, HANDLE->format_lines_left(EXPR),
2802 $FORMAT_LINES_LEFT, $- X<$-> X<$FORMAT_LINES_LEFT>, @LAST_MATCH_START, @-
2803 X<@-> X<@LAST_MATCH_START>, C<$`> is the same as C<substr($var, 0, $-[0])>,
2804 C<$&> is the same as C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the
2805 same as C<substr($var, $+[0])>, C<$1> is the same as C<substr($var, $-[1],
2806 $+[1] - $-[1])>, C<$2> is the same as C<substr($var, $-[2], $+[2] -
2807 $-[2])>, C<$3> is the same as C<substr($var, $-[3], $+[3] - $-[3])>, %-
2808 X<%->, HANDLE->format_name(EXPR), $FORMAT_NAME, $~ X<$~> X<$FORMAT_NAME>,
2809 HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^ X<$^>
2810 X<$FORMAT_TOP_NAME>, IO::Handle->format_line_break_characters EXPR,
2811 $FORMAT_LINE_BREAK_CHARACTERS, $: X<$:> X<FORMAT_LINE_BREAK_CHARACTERS>,
2812 IO::Handle->format_formfeed EXPR, $FORMAT_FORMFEED, $^L X<$^L>
2813 X<$FORMAT_FORMFEED>, $ACCUMULATOR, $^A X<$^A> X<$ACCUMULATOR>,
2814 $CHILD_ERROR, $? X<$?> X<$CHILD_ERROR>, ${^CHILD_ERROR_NATIVE}
2815 X<$^CHILD_ERROR_NATIVE>, ${^ENCODING} X<$^ENCODING>, $OS_ERROR, $ERRNO, $!
2816 X<$!> X<$ERRNO> X<$OS_ERROR>, %! X<%!>, $EXTENDED_OS_ERROR, $^E X<$^E>
2817 X<$EXTENDED_OS_ERROR>, $EVAL_ERROR, $@ X<$@> X<$EVAL_ERROR>, $PROCESS_ID,
2818 $PID, $$ X<$$> X<$PID> X<$PROCESS_ID>, $REAL_USER_ID, $UID, $< X<< $< >>
2819 X<$UID> X<$REAL_USER_ID>, $EFFECTIVE_USER_ID, $EUID, $> X<< $> >> X<$EUID>
2820 X<$EFFECTIVE_USER_ID>, $REAL_GROUP_ID, $GID, $( X<$(> X<$GID>
2821 X<$REAL_GROUP_ID>, $EFFECTIVE_GROUP_ID, $EGID, $) X<$)> X<$EGID>
2822 X<$EFFECTIVE_GROUP_ID>, $PROGRAM_NAME, $0 X<$0> X<$PROGRAM_NAME>, $[ X<$[>,
2823 $] X<$]>, $COMPILING, $^C X<$^C> X<$COMPILING>, $DEBUGGING, $^D X<$^D>
2824 X<$DEBUGGING>, ${^RE_DEBUG_FLAGS}, ${^RE_TRIE_MAXBUF}, $SYSTEM_FD_MAX, $^F
2825 X<$^F> X<$SYSTEM_FD_MAX>, $^H, %^H, $INPLACE_EDIT, $^I X<$^I>
2826 X<$INPLACE_EDIT>, $^M X<$^M>, $OSNAME, $^O X<$^O> X<$OSNAME>, ${^OPEN},
2827 $PERLDB, $^P X<$^P> X<$PERLDB>, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40,
2828 0x80, 0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R X<$^R>
2829 X<$LAST_REGEXP_CODE_RESULT>, $EXCEPTIONS_BEING_CAUGHT, $^S X<$^S>
2830 X<$EXCEPTIONS_BEING_CAUGHT>, $BASETIME, $^T X<$^T> X<$BASETIME>, ${^TAINT},
2831 ${^UNICODE}, ${^UTF8CACHE}, ${^UTF8LOCALE}, $PERL_VERSION, $^V X<$^V>
2832 X<$PERL_VERSION>, $WARNING, $^W X<$^W> X<$WARNING>, ${^WARNING_BITS},
2833 ${^WIN32_SLOPPY_STAT}, $EXECUTABLE_NAME, $^X X<$^X> X<$EXECUTABLE_NAME>,
2834 ARGV X<ARGV>, $ARGV X<$ARGV>, @ARGV X<@ARGV>, ARGVOUT X<ARGVOUT>, @F X<@F>,
2835 @INC X<@INC>, @ARG, @_ X<@_> X<@ARG>, %INC X<%INC>, %ENV, $ENV{expr}
2836 X<%ENV>, %SIG, $SIG{expr} X<%SIG>
2838 =item Error Indicators
2839 X<error> X<exception>
2841 =item Technical Note on the Syntax of Variable Names
2849 =head2 perlre - Perl regular expressions
2859 m X</m> X<regex, multiline> X<regexp, multiline> X<regular expression,
2860 multiline>, s X</s> X<regex, single-line> X<regexp, single-line> X<regular
2861 expression, single-line>, i X</i> X<regex, case-insensitive> X<regexp,
2862 case-insensitive> X<regular expression, case-insensitive>, x X</x>, p X</p>
2863 X<regex, preserve> X<regexp, preserve>
2865 =item Regular Expressions
2867 [1], [2], [3], cntrl X<cntrl>, graph X<graph>, print X<print>, punct
2868 X<punct>, xdigit X<xdigit>
2870 =item Extended Patterns
2872 C<(?#text)> X<(?#)>, C<(?kimsx-imsx)> X<(?)>, C<(?:pattern)> X<(?:)>,
2873 C<(?imsx-imsx:pattern)>, C<(?|pattern)> X<(?|)> X<Branch reset>,
2874 Look-Around Assertions X<look-around assertion> X<lookaround assertion>
2875 X<look-around> X<lookaround>, C<(?=pattern)> X<(?=)> X<look-ahead,
2876 positive> X<lookahead, positive>, C<(?!pattern)> X<(?!)> X<look-ahead,
2877 negative> X<lookahead, negative>, C<(?<=pattern)> C<\K> X<(?<=)>
2878 X<look-behind, positive> X<lookbehind, positive> X<\K>, C<(?<!pattern)>
2879 X<(?<!)> X<look-behind, negative> X<lookbehind, negative>,
2880 C<(?'NAME'pattern)>, C<< (?<NAME>pattern) >> X<< (?<NAME>) >> X<(?'NAME')>
2881 X<named capture> X<capture>, C<< \k<NAME> >>, C<< \k'NAME' >>, C<(?{ code
2882 })> X<(?{})> X<regex, code in> X<regexp, code in> X<regular expression,
2883 code in>, C<(??{ code })> X<(??{})> X<regex, postponed> X<regexp,
2884 postponed> X<regular expression, postponed>, C<(?PARNO)> C<(?-PARNO)>
2885 C<(?+PARNO)> C<(?R)> C<(?0)> X<(?PARNO)> X<(?1)> X<(?R)> X<(?0)> X<(?-1)>
2886 X<(?+1)> X<(?-PARNO)> X<(?+PARNO)> X<regex, recursive> X<regexp, recursive>
2887 X<regular expression, recursive> X<regex, relative recursion>, C<(?&NAME)>
2888 X<(?&NAME)>, C<(?(condition)yes-pattern|no-pattern)> X<(?()>,
2889 C<(?(condition)yes-pattern)>, (1) (2) .., (<NAME>) ('NAME'), (?{ CODE }),
2890 (R), (R1) (R2) .., (R&NAME), (DEFINE), C<< (?>pattern) >> X<backtrack>
2891 X<backtracking> X<atomic> X<possessive>
2893 =item Special Backtracking Control Verbs
2895 Verbs that take an argument, C<(*PRUNE)> C<(*PRUNE:NAME)> X<(*PRUNE)>
2896 X<(*PRUNE:NAME)> X<\v>, C<(*SKIP)> C<(*SKIP:NAME)> X<(*SKIP)>,
2897 C<(*MARK:NAME)> C<(*:NAME)> X<(*MARK)> C<(*MARK:NAME)> C<(*:NAME)>,
2898 C<(*THEN)> C<(*THEN:NAME)>, C<(*COMMIT)> X<(*COMMIT)>, Verbs without an
2899 argument, C<(*FAIL)> C<(*F)> X<(*FAIL)> X<(*F)>, C<(*ACCEPT)> X<(*ACCEPT)>
2902 X<backtrack> X<backtracking>
2904 =item Version 8 Regular Expressions
2905 X<regular expression, version 8> X<regex, version 8> X<regexp, version 8>
2907 =item Warning on \1 Instead of $1
2909 =item Repeated Patterns Matching a Zero-length Substring
2911 =item Combining RE Pieces
2913 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
2914 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
2915 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>, C<(?PARNO)>,
2916 C<(?(condition)yes-pattern|no-pattern)>
2918 =item Creating Custom RE Engines
2922 =item PCRE/Python Support
2924 C<< (?PE<lt>NAMEE<gt>pattern) >>, C<< (?P=NAME) >>, C<< (?P>NAME) >>
2932 =head2 perlreref - Perl Regular Expressions Reference
2944 =item ESCAPE SEQUENCES
2946 =item CHARACTER CLASSES
2952 =item EXTENDED CONSTRUCTS
2970 =head2 perlref - Perl references and nested data structures
2980 =item Making References
2981 X<reference, creation> X<referencing>
2983 1. X<\> X<backslash>, 2. X<array, anonymous> X<[> X<[]> X<square bracket>
2984 X<bracket, square> X<arrayref> X<array reference> X<reference, array>, 3.
2985 X<hash, anonymous> X<{> X<{}> X<curly bracket> X<bracket, curly> X<brace>
2986 X<hashref> X<hash reference> X<reference, hash>, 4. X<subroutine,
2987 anonymous> X<subroutine, reference> X<reference, subroutine> X<scope,
2988 lexical> X<closure> X<lexical> X<lexical scope>, 5. X<constructor> X<new>,
2989 6. X<autovivification>, 7. X<*foo{THING}> X<*>
2991 =item Using References
2992 X<reference, use> X<dereferencing> X<dereference>
2994 =item Symbolic references
2995 X<reference, symbolic> X<reference, soft>
2996 X<symbolic reference> X<soft reference>
2998 =item Not-so-symbolic references
3000 =item Pseudo-hashes: Using an array as a hash
3001 X<pseudo-hash> X<pseudo hash> X<pseudohash>
3003 =item Function Templates
3004 X<scope, lexical> X<closure> X<lexical> X<lexical scope>
3005 X<subroutine, nested> X<sub, nested> X<subroutine, local> X<sub, local>
3010 X<reference, string context> X<reference, use as hash key>
3016 =head2 perlform - Perl formats
3025 X<format, text field>
3027 =item Numeric Fields
3028 X<#> X<format, numeric field>
3030 =item The Field @* for Variable Width Multi-Line Text
3033 =item The Field ^* for Variable Width One-line-at-a-time Text
3036 =item Specifying Values
3037 X<format, specifying values>
3039 =item Using Fill Mode
3040 X<format, fill mode>
3042 =item Suppressing Lines Where All Fields Are Void
3043 X<format, suppressing lines>
3045 =item Repeating Format Lines
3046 X<format, repeating lines>
3048 =item Top of Form Processing
3049 X<format, top of form> X<top> X<header>
3051 =item Format Variables
3053 X<format, variables>
3062 X<format, footer> X<footer>
3064 =item Accessing Formatting Internals
3065 X<format, internals>
3073 =head2 perlobj - Perl objects
3081 =item An Object is Simply a Reference
3082 X<object> X<bless> X<constructor> X<new>
3084 =item A Class is Simply a Package
3085 X<class> X<package> X<@ISA> X<inheritance>
3087 =item A Method is Simply a Subroutine
3090 =item Method Invocation
3091 X<invocation> X<method> X<arrow> X<< -> >>
3093 =item Indirect Object Syntax
3094 X<indirect object syntax> X<invocation, indirect> X<indirect>
3096 =item Default UNIVERSAL methods
3099 isa(CLASS) X<isa>, can(METHOD) X<can>, VERSION( [NEED] ) X<VERSION>
3102 X<destructor> X<DESTROY>
3106 =item Two-Phased Garbage Collection
3107 X<garbage collection> X<GC> X<circular reference>
3108 X<reference, circular> X<DESTROY> X<destructor>
3116 =head2 perltie - how to hide an object class in a simple variable
3129 TIESCALAR classname, LIST X<TIESCALAR>, FETCH this X<FETCH>, STORE this,
3130 value X<STORE>, UNTIE this X<UNTIE>, DESTROY this X<DESTROY>
3135 TIEARRAY classname, LIST X<TIEARRAY>, FETCH this, index X<FETCH>, STORE
3136 this, index, value X<STORE>, FETCHSIZE this X<FETCHSIZE>, STORESIZE this,
3137 count X<STORESIZE>, EXTEND this, count X<EXTEND>, EXISTS this, key
3138 X<EXISTS>, DELETE this, key X<DELETE>, CLEAR this X<CLEAR>, PUSH this, LIST
3139 X<PUSH>, POP this X<POP>, SHIFT this X<SHIFT>, UNSHIFT this, LIST
3140 X<UNSHIFT>, SPLICE this, offset, length, LIST X<SPLICE>, UNTIE this
3141 X<UNTIE>, DESTROY this X<DESTROY>
3146 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST X<TIEHASH>, FETCH this,
3147 key X<FETCH>, STORE this, key, value X<STORE>, DELETE this, key X<DELETE>,
3148 CLEAR this X<CLEAR>, EXISTS this, key X<EXISTS>, FIRSTKEY this X<FIRSTKEY>,
3149 NEXTKEY this, lastkey X<NEXTKEY>, SCALAR this X<SCALAR>, UNTIE this
3150 X<UNTIE>, DESTROY this X<DESTROY>
3152 =item Tying FileHandles
3153 X<filehandle, tying>
3155 TIEHANDLE classname, LIST X<TIEHANDLE>, WRITE this, LIST X<WRITE>, PRINT
3156 this, LIST X<PRINT>, PRINTF this, LIST X<PRINTF>, READ this, LIST X<READ>,
3157 READLINE this X<READLINE>, GETC this X<GETC>, CLOSE this X<CLOSE>, UNTIE
3158 this X<UNTIE>, DESTROY this X<DESTROY>
3163 =item The C<untie> Gotcha
3176 =head2 perldbmfilter - Perl DBM Filters
3184 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
3185 B<filter_fetch_value>
3191 =item An Example -- the NULL termination problem.
3193 =item Another Example -- Key is a C int.
3203 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
3204 safe subprocesses, sockets, and semaphores)
3214 =item Handling the SIGHUP Signal in Daemons
3222 =item Deferred Signals (Safe Signals)
3224 Long-running opcodes, Interrupting IO, Restartable system calls, Signals as
3225 "faults", Signals triggered by operating system state
3229 =item Using open() for IPC
3235 =item Background Processes
3237 =item Complete Dissociation of Child from Parent
3239 =item Safe Pipe Opens
3241 =item Bidirectional Communication with Another Process
3243 =item Bidirectional Communication with Yourself
3247 =item Sockets: Client/Server Communication
3251 =item Internet Line Terminators
3253 =item Internet TCP Clients and Servers
3255 =item Unix-Domain TCP Clients and Servers
3259 =item TCP Clients with IO::Socket
3263 =item A Simple Client
3265 C<Proto>, C<PeerAddr>, C<PeerPort>
3267 =item A Webget Client
3269 =item Interactive Client with IO::Socket
3273 =item TCP Servers with IO::Socket
3275 Proto, LocalPort, Listen, Reuse
3277 =item UDP: Message Passing
3291 =head2 perlfork - Perl's fork() emulation
3301 =item Behavior of other Perl features in forked pseudo-processes
3303 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
3304 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
3305 files, directories and network sockets
3307 =item Resource limits
3309 =item Killing the parent process
3311 =item Lifetime of the parent process and pseudo-processes
3313 =item CAVEATS AND LIMITATIONS
3315 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
3316 Global state maintained by XSUBs, Interpreter embedded in larger
3317 application, Thread-safety of extensions
3329 =head2 perlnumber - semantics of numbers and numeric operations in Perl
3337 =item Storing numbers
3339 =item Numeric operators and numeric conversions
3341 =item Flavors of Perl numeric operations
3343 Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other
3344 mathematical operators, Bitwise operators, Bitwise operators during C<use
3345 integer>, Operators which expect an integer, Operators which expect a
3354 =head2 perlthrtut - Tutorial on threads in Perl
3360 =item What Is A Thread Anyway?
3362 =item Threaded Program Models
3374 =item What kind of threads are Perl threads?
3376 =item Thread-Safe Modules
3382 =item Basic Thread Support
3384 =item A Note about the Examples
3386 =item Creating Threads
3388 =item Waiting For A Thread To Exit
3390 =item Ignoring A Thread
3394 =item Threads And Data
3398 =item Shared And Unshared Data
3400 =item Thread Pitfalls: Races
3404 =item Synchronization and control
3408 =item Controlling access: lock()
3410 =item A Thread Pitfall: Deadlocks
3412 =item Queues: Passing Data Around
3414 =item Semaphores: Synchronizing Data Access
3416 =item Basic semaphores
3418 =item Advanced Semaphores
3420 =item Waiting for a Condition
3422 =item Giving up control
3426 =item General Thread Utility Routines
3430 =item What Thread Am I In?
3434 =item Are These Threads The Same?
3436 =item What Threads Are Running?
3440 =item A Complete Example
3442 =item Different implementations of threads
3444 =item Performance considerations
3446 =item Process-scope Changes
3448 =item Thread-Safety of System Libraries
3458 =item Introductory Texts
3460 =item OS-Related References
3462 =item Other References
3466 =item Acknowledgements
3474 =head2 perlothrtut - old tutorial on threads in Perl
3480 =item What Is A Thread Anyway?
3482 =item Threaded Program Models
3494 =item Native threads
3496 =item What kind of threads are perl threads?
3498 =item Threadsafe Modules
3504 =item Basic Thread Support
3506 =item Creating Threads
3508 =item Giving up control
3510 =item Waiting For A Thread To Exit
3512 =item Errors In Threads
3514 =item Ignoring A Thread
3518 =item Threads And Data
3522 =item Shared And Unshared Data
3524 =item Thread Pitfall: Races
3526 =item Controlling access: lock()
3528 =item Thread Pitfall: Deadlocks
3530 =item Queues: Passing Data Around
3534 =item Threads And Code
3538 =item Semaphores: Synchronizing Data Access
3540 Basic semaphores, Advanced Semaphores
3542 =item Attributes: Restricting Access To Subroutines
3544 =item Subroutine Locks
3548 =item Locking A Subroutine
3552 =item General Thread Utility Routines
3556 =item What Thread Am I In?
3560 =item Are These Threads The Same?
3562 =item What Threads Are Running?
3566 =item A Complete Example
3574 =item Introductory Texts
3576 =item OS-Related References
3578 =item Other References
3582 =item Acknowledgements
3590 =head2 perlport - Writing portable Perl
3596 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
3605 =item Numbers endianness and Width
3607 =item Files and Filesystems
3609 =item System Interaction
3611 =item Command names versus file pathnames
3615 =item Interprocess Communication (IPC)
3617 =item External Subroutines (XS)
3619 =item Standard Modules
3623 =item Character sets and character encoding
3625 =item Internationalisation
3627 =item System Resources
3643 =item DOS and Derivatives
3651 =item EBCDIC Platforms
3659 =item FUNCTION IMPLEMENTATIONS
3663 =item Alphabetical Listing of Perl Functions
3665 -I<X>, atan2, binmode, chmod, chown, chroot, crypt, dbmclose, dbmopen,
3666 dump, exec, exit, fcntl, flock, fork, getlogin, getpgrp, getppid,
3667 getpriority, getpwnam, getgrnam, getnetbyname, getpwuid, getgrgid,
3668 getnetbyaddr, getprotobynumber, getservbyport, getpwent, getgrent,
3669 gethostbyname, gethostent, getnetent, getprotoent, getservent, sethostent,
3670 setnetent, setprotoent, setservent, endpwent, endgrent, endhostent,
3671 endnetent, endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob,
3672 gmtime, ioctl FILEHANDLE,FUNCTION,SCALAR, kill, link, localtime, lstat,
3673 msgctl, msgget, msgsnd, msgrcv, open, pipe, readlink, rename, select,
3674 semctl, semget, semop, setgrent, setpgrp, setpriority, setpwent,
3675 setsockopt, shmctl, shmget, shmread, shmwrite, sockatmark, socketpair,
3676 stat, symlink, syscall, sysopen, system, times, truncate, umask, utime,
3681 =item Supported Platforms
3685 =item AUTHORS / CONTRIBUTORS
3689 =head2 perllocale - Perl locale handling (internationalization and
3696 =item PREPARING TO USE LOCALES
3702 =item The use locale pragma
3704 =item The setlocale function
3706 =item Finding locales
3708 =item LOCALE PROBLEMS
3710 =item Temporarily fixing locale problems
3712 =item Permanently fixing locale problems
3714 =item Permanently fixing your system's locale configuration
3716 =item Fixing system locale configuration
3718 =item The localeconv function
3720 =item I18N::Langinfo
3724 =item LOCALE CATEGORIES
3728 =item Category LC_COLLATE: Collation
3730 =item Category LC_CTYPE: Character Types
3732 =item Category LC_NUMERIC: Numeric Formatting
3734 =item Category LC_MONETARY: Formatting of monetary amounts
3738 =item Other categories
3746 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
3747 LC_NUMERIC, LC_TIME, LANG
3759 =item Backward compatibility
3761 =item I18N:Collate obsolete
3763 =item Sort speed and memory use impacts
3765 =item write() and LC_NUMERIC
3767 =item Freely available locale definitions
3771 =item An imperfect standard
3775 =item Unicode and UTF-8
3781 =item Broken systems
3791 =head2 perluniintro - Perl Unicode introduction
3801 =item Perl's Unicode Support
3803 =item Perl's Unicode Model
3805 =item Unicode and EBCDIC
3807 =item Creating Unicode
3809 =item Handling Unicode
3811 =item Legacy Encodings
3815 =item Displaying Unicode As Text
3819 =item Advanced Topics
3823 =item Questions With Answers
3825 =item Hexadecimal Notation
3827 =item Further Resources
3831 =item UNICODE IN OLDER PERLS
3835 =item ACKNOWLEDGMENTS
3837 =item AUTHOR, COPYRIGHT, AND LICENSE
3841 =head2 perlunicode - Unicode support in Perl
3849 =item Important Caveats
3851 Input and Output Layers, Regular Expressions, C<use utf8> still needed to
3852 enable UTF-8/UTF-EBCDIC in scripts, BOM-marked scripts and UTF-16 scripts
3853 autodetected, C<use encoding> needed to upgrade non-Latin-1 byte strings
3855 =item Byte and Character Semantics
3857 =item Effects of Character Semantics
3859 =item Unicode Character Properties
3861 General Category, Bidirectional Character Types, Scripts, Extended property
3862 classes, Use of "Is" Prefix, Blocks
3864 =item User-Defined Character Properties
3866 =item User-Defined Case Mappings
3868 =item Character Encodings for Input and Output
3870 =item Unicode Regular Expression Support Level
3872 =item Unicode Encodings
3874 =item Security Implications of Unicode
3876 =item Unicode in Perl on EBCDIC
3880 =item When Unicode Does Not Happen
3882 =item Forcing Unicode in Perl (Or Unforcing Unicode in Perl)
3884 =item Using Unicode in XS
3892 =item Interaction with Locales
3894 =item Interaction with Extensions
3898 =item Porting code from perl-5.6.X
3906 =head2 perlunifaq - Perl Unicode FAQ
3914 =item perlunitut isn't really a Unicode tutorial, is it?
3916 =item What about binary data, like images?
3918 =item What about the UTF8 flag?
3920 =item When should I decode or encode?
3922 =item What if I don't decode?
3924 =item What if I don't encode?
3926 =item Is there a way to automatically decode or encode?
3928 =item Cheat?! Tell me, how can I cheat?
3930 =item What if I don't know which encoding was used?
3932 =item Can I use Unicode in my Perl sources?
3934 =item Data::Dumper doesn't restore the UTF8 flag; is it broken?
3936 =item How can I determine if a string is a text string or a binary string?
3938 =item How do I convert from encoding FOO to encoding BAR?
3940 =item What about the C<use bytes> pragma?
3942 =item What are C<decode_utf8> and C<encode_utf8>?
3944 =item What's the difference between C<UTF-8> and C<utf8>?
3946 =item I lost track; what encoding is the internal format really?
3948 =item What character encodings does Perl support?
3950 =item Which version of perl should I use?
3960 =head2 perlunitut - Perl Unicode Tutorial
3970 =item Your new toolkit
3972 =item I/O flow (the actual 5 minute tutorial)
3978 =item Q and A (or FAQ)
3980 =item ACKNOWLEDGEMENTS
3988 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
3994 =item COMMON CHARACTER CODE SETS
4002 =item Latin 1 (ISO 8859-1)
4006 =item 13 variant characters
4014 =item Unicode code points versus EBCDIC code points
4016 =item Remaining Perl Unicode problems in EBCDIC
4018 =item Unicode and UTF
4024 =item SINGLE OCTET TABLES
4026 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
4028 =item IDENTIFYING CHARACTER CODE SETS
4042 =item OPERATOR DIFFERENCES
4044 =item FUNCTION DIFFERENCES
4046 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
4048 =item REGULAR EXPRESSION DIFFERENCES
4056 =item Ignore ASCII vs. EBCDIC sort differences.
4058 =item MONO CASE then sort data.
4060 =item Convert, sort data, then re convert.
4062 =item Perform sorting on one type of machine only.
4066 =item TRANSFORMATION FORMATS
4070 =item URL decoding and encoding
4072 =item uu encoding and decoding
4074 =item Quoted-Printable encoding and decoding
4076 =item Caesarian ciphers
4080 =item Hashing order and checksums
4084 =item MULTI OCTET CHARACTER SETS
4096 chcp, dataset access, OS/390, z/OS iconv, locales
4116 =head2 perlsec - Perl security
4124 =item Laundering and Detecting Tainted Data
4126 =item Switches On the "#!" Line
4128 =item Taint mode and @INC
4130 =item Cleaning Up Your Path
4134 =item Protecting Your Programs
4138 =item Algorithmic Complexity Attacks
4146 =head2 perlmod - Perl modules (packages and symbol tables)
4155 X<package> X<namespace> X<variable, global> X<global variable> X<global>
4158 X<symbol table> X<stash> X<%::> X<%main::> X<typeglob> X<glob> X<alias>
4160 =item BEGIN, UNITCHECK, CHECK, INIT and END
4161 X<BEGIN> X<UNITCHECK> X<CHECK> X<INIT> X<END>
4169 =item Making your module threadsafe
4170 X<threadsafe> X<thread safe>
4171 X<module, threadsafe> X<module, thread safe>
4172 X<CLONE> X<CLONE_SKIP> X<thread> X<threads> X<ithread>
4180 =head2 perlmodlib - constructing new Perl modules and finding existing ones
4184 =item THE PERL MODULE LIBRARY
4188 =item Pragmatic Modules
4190 assertions, assertions::activate, assertions::compat, attributes, attrs,
4191 autouse, base, bigint, bignum, bigrat, blib, bytes, charnames, constant,
4192 diagnostics, encoding, encoding::warnings, feature, fields, filetest, if,
4193 integer, less, lib, locale, open, ops, overload, re, sigtrap, sort, strict,
4194 subs, threads, threads::shared, utf8, vars, version, vmsish, warnings,
4197 =item Standard Modules
4199 AnyDBM_File, Archive::Tar, Archive::Tar::File, Attribute::Handlers,
4200 AutoLoader, AutoSplit, B, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode,
4201 B::C, B::CC, B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint,
4202 B::Showlex, B::Stackobj, B::Stash, B::Terse, B::Xref, Benchmark,
4203 ByteLoader, CGI, CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast,
4204 CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util, CPAN, CPAN::FirstTime,
4205 CPAN::Nox, CPAN::Version, Carp, Carp::Heavy, Class::ISA, Class::Struct,
4206 Compress::Raw::Zlib, Compress::Zlib, Config, Cwd, DB, DBM_Filter,
4207 DBM_Filter::compress, DBM_Filter::encode, DBM_Filter::int32,
4208 DBM_Filter::null, DBM_Filter::utf8, DB_File, Data::Dumper, Devel::DProf,
4209 Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5, Digest::SHA,
4210 Digest::base, Digest::file, DirHandle, Dumpvalue, DynaLoader, Encode,
4211 Encode::Alias, Encode::Byte, Encode::CJKConstants, Encode::CN,
4212 Encode::CN::HZ, Encode::Config, Encode::EBCDIC, Encode::Encoder,
4213 Encode::Encoding, Encode::Guess, Encode::JP, Encode::JP::H2Z,
4214 Encode::JP::JIS7, Encode::KR, Encode::KR::2022_KR, Encode::MIME::Header,
4215 Encode::PerlIO, Encode::Supported, Encode::Symbol, Encode::TW,
4216 Encode::Unicode, Encode::Unicode::UTF7, English, Env, Errno, Exporter,
4217 Exporter::Heavy, ExtUtils::CBuilder, ExtUtils::CBuilder::Platform::Windows,
4218 ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant,
4219 ExtUtils::Constant::Base, ExtUtils::Constant::Utils,
4220 ExtUtils::Constant::XS, ExtUtils::Embed, ExtUtils::Install,
4221 ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_AIX,
4222 ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS,
4223 ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_QNX,
4224 ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_VOS,
4225 ExtUtils::MM_Win32, ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker,
4226 ExtUtils::MakeMaker::Config, ExtUtils::MakeMaker::FAQ,
4227 ExtUtils::MakeMaker::Tutorial, ExtUtils::MakeMaker::bytes,
4228 ExtUtils::MakeMaker::vmsish, ExtUtils::Manifest, ExtUtils::Mkbootstrap,
4229 ExtUtils::Mksymlists, ExtUtils::Packlist, ExtUtils::ParseXS,
4230 ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree,
4231 File::Compare, File::Copy, File::DosGlob, File::Find, File::Glob,
4232 File::GlobMapper, File::Path, File::Spec, File::Spec::Cygwin,
4233 File::Spec::Epoc, File::Spec::Functions, File::Spec::Mac, File::Spec::OS2,
4234 File::Spec::Unix, File::Spec::VMS, File::Spec::Win32, File::Temp,
4235 File::stat, FileCache, FileHandle, Filter::Simple, Filter::Util::Call,
4236 FindBin, GDBM_File, Getopt::Long, Getopt::Std, Hash::Util,
4237 Hash::Util::FieldHash, I18N::Collate, I18N::LangTags,
4238 I18N::LangTags::Detect, I18N::LangTags::List, I18N::Langinfo, IO,
4239 IO::Compress::Base, IO::Compress::Deflate, IO::Compress::Gzip,
4240 IO::Compress::RawDeflate, IO::Compress::Zip, IO::Dir, IO::File, IO::Handle,
4241 IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET,
4242 IO::Socket::UNIX, IO::Uncompress::AnyInflate,
4243 IO::Uncompress::AnyUncompress, IO::Uncompress::Base,
4244 IO::Uncompress::Gunzip, IO::Uncompress::Inflate,
4245 IO::Uncompress::RawInflate, IO::Uncompress::Unzip, IO::Zlib, IPC::Open2,
4246 IPC::Open3, IPC::SysV, IPC::SysV::Msg, IPC::SysV::Semaphore, List::Util,
4247 Locale::Constants, Locale::Country, Locale::Currency, Locale::Language,
4248 Locale::Maketext, Locale::Maketext::TPJ13, Locale::Script, MIME::Base64,
4249 MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt,
4250 Math::BigInt::Calc, Math::BigInt::CalcEmu, Math::BigInt::FastCalc,
4251 Math::BigRat, Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File,
4252 Memoize::Expire, Memoize::ExpireFile, Memoize::ExpireTest,
4253 Memoize::NDBM_File, Memoize::SDBM_File, Memoize::Storable, Module::Build,
4254 Module::Build::API, Module::Build::Authoring, Module::Build::Base,
4255 Module::Build::Compat, Module::Build::ConfigData, Module::Build::Cookbook,
4256 Module::Build::ModuleInfo, Module::Build::Notes, Module::Build::PPMMaker,
4257 Module::Build::Platform::Amiga, Module::Build::Platform::Default,
4258 Module::Build::Platform::EBCDIC, Module::Build::Platform::MPEiX,
4259 Module::Build::Platform::MacOS, Module::Build::Platform::RiscOS,
4260 Module::Build::Platform::Unix, Module::Build::Platform::VMS,
4261 Module::Build::Platform::VOS, Module::Build::Platform::Windows,
4262 Module::Build::Platform::aix, Module::Build::Platform::cygwin,
4263 Module::Build::Platform::darwin, Module::Build::Platform::os2,
4264 Module::Build::YAML, Module::CoreList, Module::Load, Module::Loaded,
4265 NDBM_File, NEXT, Net::Cmd, Net::Config, Net::Domain, Net::FTP, Net::NNTP,
4266 Net::Netrc, Net::POP3, Net::Ping, Net::SMTP, Net::Time, Net::hostent,
4267 Net::libnetFAQ, Net::netent, Net::protoent, Net::servent, O, ODBM_File,
4268 Opcode, POSIX, Package::Constants, PerlIO, PerlIO::encoding,
4269 PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint, Pod::Checker,
4270 Pod::Escapes, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects,
4271 Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser,
4272 Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff,
4273 Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText,
4274 Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer,
4275 Pod::Select, Pod::Simple, Pod::Simple::Checker, Pod::Simple::Debug,
4276 Pod::Simple::DumpAsText, Pod::Simple::DumpAsXML, Pod::Simple::HTML,
4277 Pod::Simple::HTMLBatch, Pod::Simple::LinkSection, Pod::Simple::Methody,
4278 Pod::Simple::PullParser, Pod::Simple::PullParserEndToken,
4279 Pod::Simple::PullParserStartToken, Pod::Simple::PullParserTextToken,
4280 Pod::Simple::PullParserToken, Pod::Simple::RTF, Pod::Simple::Search,
4281 Pod::Simple::SimpleTree, Pod::Simple::Subclassing, Pod::Simple::Text,
4282 Pod::Simple::TextContent, Pod::Simple::XMLOutStream, Pod::Text,
4283 Pod::Text::Color, Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage,
4284 SDBM_File, Safe, Scalar::Util, Search::Dict, SelectSaver, SelfLoader,
4285 Shell, Socket, Storable, Switch, Symbol, Sys::Hostname, Sys::Syslog,
4286 Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine, Test,
4287 Test::Builder, Test::Builder::Module, Test::Builder::Tester,
4288 Test::Builder::Tester::Color, Test::Harness, Test::Harness::Assert,
4289 Test::Harness::Iterator, Test::Harness::Point, Test::Harness::Straps,
4290 Test::Harness::TAP, Test::Harness::Util, Test::More, Test::Simple,
4291 Test::Tutorial, Text::Abbrev, Text::Balanced, Text::ParseWords,
4292 Text::Soundex, Text::Tabs, Text::Wrap, Thread, Thread::Queue,
4293 Thread::Semaphore, Thread::Signal, Thread::Specific, Tie::Array, Tie::File,
4294 Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash, Tie::Scalar,
4295 Tie::SubstrHash, Time::HiRes, Time::Local, Time::gmtime, Time::localtime,
4296 Time::tm, UNIVERSAL, Unicode::Collate, Unicode::Normalize, Unicode::UCD,
4297 User::grent, User::pwent, XS::APItest, XS::Typemap, XSLoader
4299 =item Extension Modules
4313 China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi
4314 Arabia, Singapore, South Korea, Taiwan, Thailand
4316 =item Central America
4322 Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Czech
4323 Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary,
4324 Iceland, Ireland, Italy, Latvia, Lithuania, Netherlands, Norway, Poland,
4325 Portugal, Romania, Russia, Slovakia, Slovenia, Spain, Sweden, Switzerland,
4326 Turkey, Ukraine, United Kingdom
4330 Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States,
4331 Alabama, California, Colorado, Delaware, District of Columbia, Florida,
4332 Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey, New York,
4333 North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, Utah,
4334 Virginia, Washington, Wisconsin
4338 Australia, New Zealand, United States
4342 Argentina, Brazil, Chile
4348 =item Modules: Creation, Use, and Abuse
4352 =item Guidelines for Module Creation
4354 =item Guidelines for Converting Perl 4 Library Scripts into Modules
4356 =item Guidelines for Reusing Application Code
4364 =head2 perlmodstyle - Perl module style guide
4370 =item QUICK CHECKLIST
4374 =item Before you start
4382 =item Release considerations
4386 =item BEFORE YOU START WRITING A MODULE
4390 =item Has it been done before?
4392 =item Do one thing and do it well
4394 =item What's in a name?
4398 =item DESIGNING AND WRITING YOUR MODULE
4402 =item To OO or not to OO?
4404 =item Designing your API
4406 Write simple routines to do simple things, Separate functionality from
4407 output, Provide sensible shortcuts and defaults, Naming conventions,
4410 =item Strictness and warnings
4412 =item Backwards compatibility
4414 =item Error handling and messages
4418 =item DOCUMENTING YOUR MODULE
4424 =item README, INSTALL, release notes, changelogs
4426 perl Makefile.PL, make, make test, make install, perl Build.PL, perl Build,
4427 perl Build test, perl Build install
4431 =item RELEASE CONSIDERATIONS
4435 =item Version numbering
4437 =item Pre-requisites
4447 =item COMMON PITFALLS
4451 =item Reinventing the wheel
4453 =item Trying to do too much
4455 =item Inappropriate documentation
4461 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Packaging Tools,
4462 Testing tools, http://pause.perl.org/, Any good book on software
4469 =head2 perlmodinstall - Installing CPAN Modules
4479 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
4480 module (sometimes unnecessary), B<INSTALL> the module
4494 =head2 perlnewmod - preparing a new module for distribution
4504 =item What should I make into a module?
4506 =item Step-by-step: Preparing the ground
4508 Look around, Check it's new, Discuss the need, Choose a name, Check again
4510 =item Step-by-step: Making the module
4512 Start with F<module-starter> or F<h2xs>, Use L<strict|strict> and
4513 L<warnings|warnings>, Use L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!,
4514 Use L<plain old documentation|perlpod>, Write tests, Write the README
4516 =item Step-by-step: Distributing your module
4518 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
4519 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
4529 =head2 perlpragma - how to write a user pragma
4535 =item A basic example
4537 =item Implementation details
4541 =head2 perlutil - utilities packaged with the Perl distribution
4547 =item LIST OF UTILITIES
4553 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
4554 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
4555 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
4556 L<roffitall|roffitall>
4560 L<a2p|a2p>, L<s2p|s2p> and L<psed>, L<find2perl|find2perl>
4562 =item Administration
4564 L<config_data|config_data>, L<libnetcfg|libnetcfg>, L<perlivp>
4568 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
4569 L<h2xs|h2xs>, L<enc2xs>, L<xsubpp>, L<dprofpp|dprofpp>, L<prove>,
4574 L<piconv>, L<ptar>, L<ptardiff>, L<shasum>
4578 L<cpan>, L<instmodsh>
4586 =head2 perlcompile - Introduction to the Perl Compiler-Translator
4596 B::Lint, B::Deparse, B::Xref
4600 =item Using The Back Ends
4604 =item The Cross Referencing Back End
4608 =item The Decompiling Back End
4610 =item The Lint Back End
4614 =item Module List for the Compiler Suite
4616 B, O, B::Concise, B::Debug, B::Deparse, B::Lint, B::Showlex, B::Terse,
4619 =item KNOWN PROBLEMS
4625 =head2 perlfilter - Source Filters
4635 =item WRITING A SOURCE FILTER
4637 =item WRITING A SOURCE FILTER IN C
4639 B<Decryption Filters>
4641 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4643 =item WRITING A SOURCE FILTER IN PERL
4645 =item USING CONTEXT: THE DEBUG FILTER
4649 =item THINGS TO LOOK OUT FOR
4651 Some Filters Clobber the C<DATA> Handle
4661 =head2 perlglossary - Perl Glossary
4671 accessor methods, actual arguments, address operator, algorithm, alias,
4672 alternatives, anonymous, architecture, argument, ARGV, arithmetical
4673 operator, array, array context, ASCII, assertion, assignment, assignment
4674 operator, associative array, associativity, asynchronous, atom, atomic
4675 operation, attribute, autogeneration, autoincrement, autoload, autosplit,
4676 autovivification, AV, awk
4680 backreference, backtracking, backward compatibility, bareword, base class,
4681 big-endian, binary, binary operator, bind, bit, bit shift, bit string,
4682 bless, block, BLOCK, block buffering, Boolean, Boolean context, breakpoint,
4683 broadcast, BSD, bucket, buffer, built-in, bundle, byte, bytecode
4687 C, C preprocessor, call by reference, call by value, callback, canonical,
4688 capturing, character, character class, character property, circumfix
4689 operator, class, class method, client, cloister, closure, cluster, CODE,
4690 code generator, code subpattern, collating sequence, command, command
4691 buffering, command name, command-line arguments, comment, compilation unit,
4692 compile phase, compile time, compiler, composer, concatenation,
4693 conditional, connection, construct, constructor, context, continuation,
4694 core dump, CPAN, cracker, current package, current working directory,
4695 currently selected output channel, CV
4699 dangling statement, data structure, data type, datagram, DBM, declaration,
4700 decrement, default, defined, delimiter, dereference, derived class,
4701 descriptor, destroy, destructor, device, directive, directory, directory
4702 handle, dispatch, distribution, dweomer, dwimmer, dynamic scoping
4706 eclectic, element, embedding, empty subclass test, en passant,
4707 encapsulation, endian, environment, environment variable, EOF, errno,
4708 error, escape sequence, exception, exception handling, exec, executable
4709 file, execute, execute bit, exit status, export, expression, extension
4713 false, FAQ, fatal error, field, FIFO, file, file descriptor, file test
4714 operator, fileglob, filehandle, filename, filesystem, filter, flag,
4715 floating point, flush, FMTEYEWTK, fork, formal arguments, format, freely
4716 available, freely redistributable, freeware, function, funny character,
4721 GID, glob, global, global destruction, glue language, granularity, greedy,
4726 hacker, handler, hard reference, hash, hash table, header file, here
4727 document, hexadecimal, home directory, host, hubris, HV
4731 identifier, impatience, implementation, import, increment, indexing,
4732 indirect filehandle, indirect object, indirect object slot, indirection,
4733 infix, inheritance, instance, instance variable, integer, interface,
4734 interpolation, interpreter, invocant, invocation, I/O, IO, IP, IPC, is-a,
4735 iteration, iterator, IV
4747 label, laziness, left shift, leftmost longest, lexeme, lexer, lexical
4748 analysis, lexical scoping, lexical variable, library, LIFO, line, line
4749 buffering, line number, link, LIST, list, list context, list operator, list
4750 value, literal, little-endian, local, logical operator, lookahead,
4751 lookbehind, loop, loop control statement, loop label, lvaluable, lvalue,
4756 magic, magical increment, magical variables, Makefile, man, manpage,
4757 matching, member data, memory, metacharacter, metasymbol, method,
4758 minimalism, mode, modifier, module, modulus, monger, mortal,
4759 multidimensional array, multiple inheritance
4763 named pipe, namespace, network address, newline, NFS, null character, null
4764 list, null string, numeric context, NV, nybble
4768 object, octal, offset, one-liner, open source software, operand, operating
4769 system, operator, operator overloading, options, overloading, overriding,
4774 package, pad, parameter, parent class, parse tree, parsing, patch, PATH,
4775 pathname, pattern, pattern matching, permission bits, Pern, pipe, pipeline,
4776 platform, pod, pointer, polymorphism, port, portable, porter, POSIX,
4777 postfix, pp, pragma, precedence, prefix, preprocessing, procedure, process,
4778 program generator, progressive matching, property, protocol, prototype,
4779 pseudofunction, pseudohash, pseudoliteral, public domain, pumpkin,
4784 qualified, quantifier
4788 readable, reaping, record, recursion, reference, referent, regex, regular
4789 expression, regular expression modifier, regular file, relational operator,
4790 reserved words, return value, RFC, right shift, root, RTFM, run phase, run
4791 time, run-time pattern, RV, rvalue
4795 scalar, scalar context, scalar literal, scalar value, scalar variable,
4796 scope, scratchpad, script, script kiddie, sed, semaphore, separator,
4797 serialization, server, service, setgid, setuid, shared memory, shebang,
4798 shell, side effects, signal, signal handler, single inheritance, slice,
4799 slurp, socket, soft reference, source filter, stack, standard, standard
4800 error, standard I/O, standard input, standard output, stat structure,
4801 statement, statement modifier, static, static method, static scoping,
4802 static variable, status, STDERR, STDIN, STDIO, STDOUT, stream, string,
4803 string context, stringification, struct, structure, subclass, subpattern,
4804 subroutine, subscript, substitution, substring, superclass, superuser, SV,
4805 switch, switch cluster, switch statement, symbol, symbol table, symbolic
4806 debugger, symbolic link, symbolic reference, synchronous, syntactic sugar,
4807 syntax, syntax tree, syscall
4811 tainted, TCP, term, terminator, ternary, text, thread, tie, TMTOWTDI,
4812 token, tokener, tokenizing, toolbox approach, transliterate, trigger,
4813 trinary, troff, true, truncating, type, type casting, typed lexical,
4814 typedef, typeglob, typemap
4818 UDP, UID, umask, unary operator, Unicode, Unix
4822 value, variable, variable interpolation, variadic, vector, virtual, void
4827 warning, watch expression, whitespace, word, working directory, wrapper,
4844 =item AUTHOR AND COPYRIGHT
4848 =head2 perlembed - how to embed perl in your C program
4858 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
4859 Perl?>, B<Use C from C?>, B<Use Perl from C?>
4863 =item Compiling your C program
4865 =item Adding a Perl interpreter to your C program
4867 =item Calling a Perl subroutine from your C program
4869 =item Evaluating a Perl statement from your C program
4871 =item Performing Perl pattern matches and substitutions from your C program
4873 =item Fiddling with the Perl stack from your C program
4875 =item Maintaining a persistent interpreter
4877 =item Execution of END blocks
4879 =item $0 assignments
4881 =item Maintaining multiple interpreter instances
4883 =item Using Perl modules, which themselves use C libraries, from your C
4888 =item Embedding Perl under Win32
4900 =head2 perldebguts - Guts of Perl debugging
4906 =item Debugger Internals
4910 =item Writing Your Own Debugger
4914 =item Frame Listing Output Examples
4916 =item Debugging regular expressions
4920 =item Compile-time output
4922 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
4923 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
4924 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
4927 =item Types of nodes
4929 =item Run-time output
4933 =item Debugging Perl memory usage
4937 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
4939 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
4940 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
4949 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
4961 =item Version caveat
4963 =item Dynamic Loading versus Static Loading
4975 =item What has gone on?
4977 =item Writing good test scripts
4981 =item What's new here?
4983 =item Input and Output Parameters
4985 =item The XSUBPP Program
4987 =item The TYPEMAP file
4989 =item Warning about Output Arguments
4993 =item What has happened here?
4995 =item Anatomy of .xs file
4997 =item Getting the fat out of XSUBs
4999 =item More about XSUB arguments
5001 =item The Argument Stack
5003 =item Extending your Extension
5005 =item Documenting your Extension
5007 =item Installing your Extension
5011 =item New Things in this Example
5015 =item New Things in this Example
5017 =item EXAMPLE 7 (Coming Soon)
5019 =item EXAMPLE 8 (Coming Soon)
5021 =item EXAMPLE 9 Passing open files to XSes
5023 =item Troubleshooting these Examples
5039 =head2 perlxs - XS language reference manual
5051 =item The Anatomy of an XSUB
5053 =item The Argument Stack
5055 =item The RETVAL Variable
5057 =item Returning SVs, AVs and HVs through RETVAL
5059 =item The MODULE Keyword
5061 =item The PACKAGE Keyword
5063 =item The PREFIX Keyword
5065 =item The OUTPUT: Keyword
5067 =item The NO_OUTPUT Keyword
5069 =item The CODE: Keyword
5071 =item The INIT: Keyword
5073 =item The NO_INIT Keyword
5075 =item Initializing Function Parameters
5077 =item Default Parameter Values
5079 =item The PREINIT: Keyword
5081 =item The SCOPE: Keyword
5083 =item The INPUT: Keyword
5085 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
5087 =item The C<length(NAME)> Keyword
5089 =item Variable-length Parameter Lists
5091 =item The C_ARGS: Keyword
5093 =item The PPCODE: Keyword
5095 =item Returning Undef And Empty Lists
5097 =item The REQUIRE: Keyword
5099 =item The CLEANUP: Keyword
5101 =item The POSTCALL: Keyword
5103 =item The BOOT: Keyword
5105 =item The VERSIONCHECK: Keyword
5107 =item The PROTOTYPES: Keyword
5109 =item The PROTOTYPE: Keyword
5111 =item The ALIAS: Keyword
5113 =item The OVERLOAD: Keyword
5115 =item The FALLBACK: Keyword
5117 =item The INTERFACE: Keyword
5119 =item The INTERFACE_MACRO: Keyword
5121 =item The INCLUDE: Keyword
5123 =item The CASE: Keyword
5125 =item The & Unary Operator
5127 =item Inserting POD, Comments and C Preprocessor Directives
5129 =item Using XS With C++
5131 =item Interface Strategy
5133 =item Perl Objects And C Structures
5137 =item Safely Storing Static Data in XS
5139 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT,
5140 aMY_CXT/pMY_CXT, MY_CXT_CLONE, MY_CXT_INIT_INTERP(my_perl),
5141 dMY_CXT_INTERP(my_perl)
5143 =item Thread-aware system interfaces
5155 =head2 perlclib - Internal replacements for standard C library functions
5165 C<t>, C<p>, C<n>, C<s>
5167 =item File Operations
5169 =item File Input and Output
5171 =item File Positioning
5173 =item Memory Management and String Handling
5175 =item Character Class Tests
5177 =item F<stdlib.h> functions
5179 =item Miscellaneous functions
5187 =head2 perlguts - Introduction to the Perl API
5199 =item What is an "IV"?
5201 =item Working with SVs
5205 =item What's Really Stored in an SV?
5207 =item Working with AVs
5209 =item Working with HVs
5211 =item Hash API Extensions
5213 =item AVs, HVs and undefined values
5217 =item Blessed References and Class Objects
5219 =item Creating New Variables
5221 GV_ADDMULTI, GV_ADDWARN
5223 =item Reference Counts and Mortality
5225 =item Stashes and Globs
5227 =item Double-Typed SVs
5229 =item Magic Variables
5231 =item Assigning Magic
5233 =item Magic Virtual Tables
5237 =item Understanding the Magic of Tied Hashes and Arrays
5239 =item Localizing changes
5241 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
5242 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
5243 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
5244 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
5245 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
5246 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
5247 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
5248 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
5249 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
5250 save_hptr(HV **hptr)>
5258 =item XSUBs and the Argument Stack
5260 =item Calling Perl Routines from within C Programs
5262 =item Memory Allocation
5266 =item Putting a C value on Perl stack
5270 =item Scratchpads and recursion
5280 =item Examining the tree
5282 =item Compile pass 1: check routines
5284 =item Compile pass 1a: constant folding
5286 =item Compile pass 2: context propagation
5288 =item Compile pass 3: peephole optimization
5290 =item Pluggable runops
5294 =item Examining internal data structures with the C<dump> functions
5296 =item How multiple interpreters and concurrency are supported
5300 =item Background and PERL_IMPLICIT_CONTEXT
5302 =item So what happened to dTHR?
5304 =item How do I use all this in extensions?
5306 =item Should I do anything special if I call perl from multiple threads?
5308 =item Future Plans and PERL_IMPLICIT_SYS
5312 =item Internal Functions
5314 A, p, d, s, n, r, f, M, o, x, m, X, E, b, others
5318 =item Formatted Printing of IVs, UVs, and NVs
5320 =item Pointer-To-Integer and Integer-To-Pointer
5322 =item Exception Handling
5324 =item Source Documentation
5326 =item Backwards compatibility
5330 =item Unicode Support
5334 =item What B<is> Unicode, anyway?
5336 =item How can I recognise a UTF-8 string?
5338 =item How does UTF-8 represent Unicode characters?
5340 =item How does Perl store UTF-8 strings?
5342 =item How do I convert a string to UTF-8?
5344 =item Is there anything else I need to know?
5348 =item Custom Operators
5356 =head2 perlcall - Perl calling conventions from C
5362 An Error Handler, An Event Driven Program
5364 =item THE CALL_ FUNCTIONS
5366 call_sv, call_pv, call_method, call_argv
5386 =item Determining the Context
5394 =item No Parameters, Nothing returned
5396 =item Passing Parameters
5398 =item Returning a Scalar
5400 =item Returning a list of values
5402 =item Returning a list in a scalar context
5404 =item Returning Data from Perl via the parameter list
5408 =item Using G_KEEPERR
5412 =item Using call_argv
5414 =item Using call_method
5418 =item Using Perl to dispose of temporaries
5420 =item Strategies for storing Callback Context Information
5422 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
5423 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
5426 =item Alternate Stack Manipulation
5428 =item Creating and calling an anonymous subroutine in C
5432 =item LIGHTWEIGHT CALLBACKS
5442 =head2 perlreapi - perl regular expression plugin interface
5452 RXf_SKIPWHITE, RXf_START_ONLY, RXf_WHITE, RXf_PMf_LOCALE,
5453 RXf_PMf_MULTILINE, RXf_PMf_SINGLELINE, RXf_PMf_FOLD, RXf_PMf_EXTENDED,
5454 RXf_PMf_KEEPCOPY, RXf_UTF8
5464 =item numbered_buff_get
5466 =item named_buff_get
5474 =item The REGEXP structure
5476 C<engine>, C<mother_re>, C<extflags>, C<minlen> C<minlenret>, C<gofs>,
5477 C<substrs>, C<nparens>, C<lasparen>, and C<lastcloseparen>, C<intflags>,
5478 C<pprivate>, C<swap>, C<offs>, C<precomp> C<prelen>, C<paren_names>,
5479 C<reg_substr_data>, C<startp>, C<endp>, C<subbeg> C<sublen> C<saved_copy>,
5480 C<wrapped> C<wraplen>, C<seen_evals>, C<refcnt>
5484 =item De-allocation and Cloning
5496 =head2 perlreguts - Description of the Perl regular expression engine.
5506 =item A quick note on terms
5508 =item What is a regular expression engine?
5510 =item Structure of a Regexp Program
5512 C<regnode_1>, C<regnode_2>, C<regnode_string>, C<regnode_charclass>,
5513 C<regnode_charclass_class>
5517 =item Process Overview
5519 A. Compilation, 1. Parsing for size, 2. Parsing for construction, 3.
5520 Peep-hole optimisation and analysis, B. Execution, 4. Start position and
5521 no-match optimisations, 5. Program execution
5527 anchored fixed strings, floating fixed strings, minimum and maximum length
5528 requirements, start class, Beginning/End of line positions
5538 =item Unicode and Localisation Support
5540 =item Base Structures
5542 C<swap>, C<offsets>, C<regstclass>, C<data>, C<program>
5556 =head2 perlapi - autogenerated documentation for the perl public API
5561 X<Perl API> X<API> X<api>
5563 =item "Gimme" Values
5565 GIMME X<GIMME>, GIMME_V X<GIMME_V>, G_ARRAY X<G_ARRAY>, G_DISCARD
5566 X<G_DISCARD>, G_EVAL X<G_EVAL>, G_NOARGS X<G_NOARGS>, G_SCALAR X<G_SCALAR>,
5569 =item Array Manipulation Functions
5571 AvFILL X<AvFILL>, av_clear X<av_clear>, av_create_and_push
5572 X<av_create_and_push>, av_create_and_unshift_one
5573 X<av_create_and_unshift_one>, av_delete X<av_delete>, av_exists
5574 X<av_exists>, av_extend X<av_extend>, av_fetch X<av_fetch>, av_fill
5575 X<av_fill>, av_len X<av_len>, av_make X<av_make>, av_pop X<av_pop>, av_push
5576 X<av_push>, av_shift X<av_shift>, av_store X<av_store>, av_undef
5577 X<av_undef>, av_unshift X<av_unshift>, get_av X<get_av>, newAV X<newAV>,
5578 sortsv X<sortsv>, sortsv_flags X<sortsv_flags>
5580 =item Callback Functions
5582 call_argv X<call_argv>, call_method X<call_method>, call_pv X<call_pv>,
5583 call_sv X<call_sv>, ENTER X<ENTER>, eval_pv X<eval_pv>, eval_sv X<eval_sv>,
5584 FREETMPS X<FREETMPS>, LEAVE X<LEAVE>, SAVETMPS X<SAVETMPS>
5586 =item Character classes
5588 isALNUM X<isALNUM>, isALPHA X<isALPHA>, isDIGIT X<isDIGIT>, isLOWER
5589 X<isLOWER>, isSPACE X<isSPACE>, isUPPER X<isUPPER>, toLOWER X<toLOWER>,
5592 =item Cloning an interpreter
5594 perl_clone X<perl_clone>
5596 =item CV Manipulation Functions
5598 CvSTASH X<CvSTASH>, get_cv X<get_cv>, get_cvn_flags X<get_cvn_flags>
5600 =item Embedding Functions
5602 cv_undef X<cv_undef>, load_module X<load_module>, nothreadhook
5603 X<nothreadhook>, perl_alloc X<perl_alloc>, perl_construct
5604 X<perl_construct>, perl_destruct X<perl_destruct>, perl_free X<perl_free>,
5605 perl_parse X<perl_parse>, perl_run X<perl_run>, require_pv X<require_pv>
5607 =item Functions in file dump.c
5609 pv_display X<pv_display>, pv_escape X<pv_escape>, pv_pretty X<pv_pretty>
5611 =item Functions in file mathoms.c
5613 gv_fetchmethod X<gv_fetchmethod>, pack_cat X<pack_cat>, sv_2pvbyte_nolen
5614 X<sv_2pvbyte_nolen>, sv_2pvutf8_nolen X<sv_2pvutf8_nolen>, sv_2pv_nolen
5615 X<sv_2pv_nolen>, sv_catpvn_mg X<sv_catpvn_mg>, sv_catsv_mg X<sv_catsv_mg>,
5616 sv_force_normal X<sv_force_normal>, sv_iv X<sv_iv>, sv_nolocking
5617 X<sv_nolocking>, sv_nounlocking X<sv_nounlocking>, sv_nv X<sv_nv>, sv_pv
5618 X<sv_pv>, sv_pvbyte X<sv_pvbyte>, sv_pvbyten X<sv_pvbyten>, sv_pvn
5619 X<sv_pvn>, sv_pvutf8 X<sv_pvutf8>, sv_pvutf8n X<sv_pvutf8n>, sv_taint
5620 X<sv_taint>, sv_unref X<sv_unref>, sv_usepvn X<sv_usepvn>, sv_usepvn_mg
5621 X<sv_usepvn_mg>, sv_uv X<sv_uv>, unpack_str X<unpack_str>
5623 =item Functions in file pp_pack.c
5625 packlist X<packlist>, unpackstring X<unpackstring>
5627 =item Global Variables
5629 PL_modglobal X<PL_modglobal>, PL_na X<PL_na>, PL_sv_no X<PL_sv_no>,
5630 PL_sv_undef X<PL_sv_undef>, PL_sv_yes X<PL_sv_yes>
5634 GvSV X<GvSV>, gv_const_sv X<gv_const_sv>, gv_fetchmeth X<gv_fetchmeth>,
5635 gv_fetchmethod_autoload X<gv_fetchmethod_autoload>, gv_fetchmeth_autoload
5636 X<gv_fetchmeth_autoload>, gv_stashpv X<gv_stashpv>, gv_stashpvn
5637 X<gv_stashpvn>, gv_stashpvs X<gv_stashpvs>, gv_stashsv X<gv_stashsv>
5641 Nullav X<Nullav>, Nullch X<Nullch>, Nullcv X<Nullcv>, Nullhv X<Nullhv>,
5644 =item Hash Manipulation Functions
5646 get_hv X<get_hv>, HEf_SVKEY X<HEf_SVKEY>, HeHASH X<HeHASH>, HeKEY X<HeKEY>,
5647 HeKLEN X<HeKLEN>, HePV X<HePV>, HeSVKEY X<HeSVKEY>, HeSVKEY_force
5648 X<HeSVKEY_force>, HeSVKEY_set X<HeSVKEY_set>, HeVAL X<HeVAL>, HvNAME
5649 X<HvNAME>, hv_assert X<hv_assert>, hv_clear X<hv_clear>,
5650 hv_clear_placeholders X<hv_clear_placeholders>, hv_delete X<hv_delete>,
5651 hv_delete_ent X<hv_delete_ent>, hv_exists X<hv_exists>, hv_exists_ent
5652 X<hv_exists_ent>, hv_fetch X<hv_fetch>, hv_fetchs X<hv_fetchs>,
5653 hv_fetch_ent X<hv_fetch_ent>, hv_iterinit X<hv_iterinit>, hv_iterkey
5654 X<hv_iterkey>, hv_iterkeysv X<hv_iterkeysv>, hv_iternext X<hv_iternext>,
5655 hv_iternextsv X<hv_iternextsv>, hv_iternext_flags X<hv_iternext_flags>,
5656 hv_iterval X<hv_iterval>, hv_magic X<hv_magic>, hv_scalar X<hv_scalar>,
5657 hv_store X<hv_store>, hv_stores X<hv_stores>, hv_store_ent X<hv_store_ent>,
5658 hv_undef X<hv_undef>, newHV X<newHV>
5660 =item Magical Functions
5662 mg_clear X<mg_clear>, mg_copy X<mg_copy>, mg_find X<mg_find>, mg_free
5663 X<mg_free>, mg_get X<mg_get>, mg_length X<mg_length>, mg_magical
5664 X<mg_magical>, mg_set X<mg_set>, SvGETMAGIC X<SvGETMAGIC>, SvLOCK
5665 X<SvLOCK>, SvSETMAGIC X<SvSETMAGIC>, SvSetMagicSV X<SvSetMagicSV>,
5666 SvSetMagicSV_nosteal X<SvSetMagicSV_nosteal>, SvSetSV X<SvSetSV>,
5667 SvSetSV_nosteal X<SvSetSV_nosteal>, SvSHARE X<SvSHARE>, SvUNLOCK
5670 =item Memory Management
5672 Copy X<Copy>, CopyD X<CopyD>, Move X<Move>, MoveD X<MoveD>, Newx X<Newx>,
5673 Newxc X<Newxc>, Newxz X<Newxz>, Poison X<Poison>, PoisonFree X<PoisonFree>,
5674 PoisonNew X<PoisonNew>, PoisonWith X<PoisonWith>, Renew X<Renew>, Renewc
5675 X<Renewc>, Safefree X<Safefree>, savepv X<savepv>, savepvn X<savepvn>,
5676 savepvs X<savepvs>, savesharedpv X<savesharedpv>, savesharedpvn
5677 X<savesharedpvn>, savesvpv X<savesvpv>, StructCopy X<StructCopy>, Zero
5678 X<Zero>, ZeroD X<ZeroD>
5680 =item Miscellaneous Functions
5682 fbm_compile X<fbm_compile>, fbm_instr X<fbm_instr>, form X<form>, getcwd_sv
5683 X<getcwd_sv>, my_snprintf X<my_snprintf>, my_sprintf X<my_sprintf>,
5684 my_vsnprintf X<my_vsnprintf>, new_version X<new_version>, scan_version
5685 X<scan_version>, strEQ X<strEQ>, strGE X<strGE>, strGT X<strGT>, strLE
5686 X<strLE>, strLT X<strLT>, strNE X<strNE>, strnEQ X<strnEQ>, strnNE
5687 X<strnNE>, sv_nosharing X<sv_nosharing>, upg_version X<upg_version>, vcmp
5688 X<vcmp>, vnormal X<vnormal>, vnumify X<vnumify>, vstringify X<vstringify>,
5691 =item Multicall Functions
5693 dMULTICALL X<dMULTICALL>, MULTICALL X<MULTICALL>, POP_MULTICALL
5694 X<POP_MULTICALL>, PUSH_MULTICALL X<PUSH_MULTICALL>
5696 =item Numeric functions
5698 grok_bin X<grok_bin>, grok_hex X<grok_hex>, grok_number X<grok_number>,
5699 grok_numeric_radix X<grok_numeric_radix>, grok_oct X<grok_oct>,
5700 Perl_signbit X<Perl_signbit>, scan_bin X<scan_bin>, scan_hex X<scan_hex>,
5701 scan_oct X<scan_oct>
5703 =item Optree Manipulation Functions
5705 cv_const_sv X<cv_const_sv>, newCONSTSUB X<newCONSTSUB>, newXS X<newXS>
5707 =item Pad Data Structures
5711 =item Simple Exception Handling Macros
5713 dXCPT X<dXCPT>, XCPT_CATCH X<XCPT_CATCH>, XCPT_RETHROW X<XCPT_RETHROW>,
5714 XCPT_TRY_END X<XCPT_TRY_END>, XCPT_TRY_START X<XCPT_TRY_START>
5716 =item Stack Manipulation Macros
5718 dMARK X<dMARK>, dORIGMARK X<dORIGMARK>, dSP X<dSP>, EXTEND X<EXTEND>, MARK
5719 X<MARK>, mPUSHi X<mPUSHi>, mPUSHn X<mPUSHn>, mPUSHp X<mPUSHp>, mPUSHu
5720 X<mPUSHu>, mXPUSHi X<mXPUSHi>, mXPUSHn X<mXPUSHn>, mXPUSHp X<mXPUSHp>,
5721 mXPUSHu X<mXPUSHu>, ORIGMARK X<ORIGMARK>, POPi X<POPi>, POPl X<POPl>, POPn
5722 X<POPn>, POPp X<POPp>, POPpbytex X<POPpbytex>, POPpx X<POPpx>, POPs
5723 X<POPs>, PUSHi X<PUSHi>, PUSHMARK X<PUSHMARK>, PUSHmortal X<PUSHmortal>,
5724 PUSHn X<PUSHn>, PUSHp X<PUSHp>, PUSHs X<PUSHs>, PUSHu X<PUSHu>, PUTBACK
5725 X<PUTBACK>, SP X<SP>, SPAGAIN X<SPAGAIN>, XPUSHi X<XPUSHi>, XPUSHmortal
5726 X<XPUSHmortal>, XPUSHn X<XPUSHn>, XPUSHp X<XPUSHp>, XPUSHs X<XPUSHs>,
5727 XPUSHu X<XPUSHu>, XSRETURN X<XSRETURN>, XSRETURN_EMPTY X<XSRETURN_EMPTY>,
5728 XSRETURN_IV X<XSRETURN_IV>, XSRETURN_NO X<XSRETURN_NO>, XSRETURN_NV
5729 X<XSRETURN_NV>, XSRETURN_PV X<XSRETURN_PV>, XSRETURN_UNDEF
5730 X<XSRETURN_UNDEF>, XSRETURN_UV X<XSRETURN_UV>, XSRETURN_YES
5731 X<XSRETURN_YES>, XST_mIV X<XST_mIV>, XST_mNO X<XST_mNO>, XST_mNV
5732 X<XST_mNV>, XST_mPV X<XST_mPV>, XST_mUNDEF X<XST_mUNDEF>, XST_mYES
5737 svtype X<svtype>, SVt_IV X<SVt_IV>, SVt_NV X<SVt_NV>, SVt_PV X<SVt_PV>,
5738 SVt_PVAV X<SVt_PVAV>, SVt_PVCV X<SVt_PVCV>, SVt_PVHV X<SVt_PVHV>, SVt_PVMG
5741 =item SV Manipulation Functions
5743 get_sv X<get_sv>, newRV_inc X<newRV_inc>, SvCUR X<SvCUR>, SvCUR_set
5744 X<SvCUR_set>, SvEND X<SvEND>, SvGAMAGIC X<SvGAMAGIC>, SvGROW X<SvGROW>,
5745 SvIOK X<SvIOK>, SvIOKp X<SvIOKp>, SvIOK_notUV X<SvIOK_notUV>, SvIOK_off
5746 X<SvIOK_off>, SvIOK_on X<SvIOK_on>, SvIOK_only X<SvIOK_only>, SvIOK_only_UV
5747 X<SvIOK_only_UV>, SvIOK_UV X<SvIOK_UV>, SvIsCOW X<SvIsCOW>,
5748 SvIsCOW_shared_hash X<SvIsCOW_shared_hash>, SvIV X<SvIV>, SvIVX X<SvIVX>,
5749 SvIVx X<SvIVx>, SvIV_nomg X<SvIV_nomg>, SvIV_set X<SvIV_set>, SvLEN
5750 X<SvLEN>, SvLEN_set X<SvLEN_set>, SvMAGIC_set X<SvMAGIC_set>, SvNIOK
5751 X<SvNIOK>, SvNIOKp X<SvNIOKp>, SvNIOK_off X<SvNIOK_off>, SvNOK X<SvNOK>,
5752 SvNOKp X<SvNOKp>, SvNOK_off X<SvNOK_off>, SvNOK_on X<SvNOK_on>, SvNOK_only
5753 X<SvNOK_only>, SvNV X<SvNV>, SvNVX X<SvNVX>, SvNVx X<SvNVx>, SvNV_set
5754 X<SvNV_set>, SvOK X<SvOK>, SvOOK X<SvOOK>, SvPOK X<SvPOK>, SvPOKp
5755 X<SvPOKp>, SvPOK_off X<SvPOK_off>, SvPOK_on X<SvPOK_on>, SvPOK_only
5756 X<SvPOK_only>, SvPOK_only_UTF8 X<SvPOK_only_UTF8>, SvPV X<SvPV>, SvPVbyte
5757 X<SvPVbyte>, SvPVbytex X<SvPVbytex>, SvPVbytex_force X<SvPVbytex_force>,
5758 SvPVbyte_force X<SvPVbyte_force>, SvPVbyte_nolen X<SvPVbyte_nolen>,
5759 SvPVutf8 X<SvPVutf8>, SvPVutf8x X<SvPVutf8x>, SvPVutf8x_force
5760 X<SvPVutf8x_force>, SvPVutf8_force X<SvPVutf8_force>, SvPVutf8_nolen
5761 X<SvPVutf8_nolen>, SvPVX X<SvPVX>, SvPVx X<SvPVx>, SvPV_force
5762 X<SvPV_force>, SvPV_force_nomg X<SvPV_force_nomg>, SvPV_nolen
5763 X<SvPV_nolen>, SvPV_nomg X<SvPV_nomg>, SvPV_set X<SvPV_set>, SvREFCNT
5764 X<SvREFCNT>, SvREFCNT_dec X<SvREFCNT_dec>, SvREFCNT_inc X<SvREFCNT_inc>,
5765 SvREFCNT_inc_NN X<SvREFCNT_inc_NN>, SvREFCNT_inc_simple
5766 X<SvREFCNT_inc_simple>, SvREFCNT_inc_simple_NN X<SvREFCNT_inc_simple_NN>,
5767 SvREFCNT_inc_simple_void X<SvREFCNT_inc_simple_void>,
5768 SvREFCNT_inc_simple_void_NN X<SvREFCNT_inc_simple_void_NN>,
5769 SvREFCNT_inc_void X<SvREFCNT_inc_void>, SvREFCNT_inc_void_NN
5770 X<SvREFCNT_inc_void_NN>, SvROK X<SvROK>, SvROK_off X<SvROK_off>, SvROK_on
5771 X<SvROK_on>, SvRV X<SvRV>, SvRV_set X<SvRV_set>, SvSTASH X<SvSTASH>,
5772 SvSTASH_set X<SvSTASH_set>, SvTAINT X<SvTAINT>, SvTAINTED X<SvTAINTED>,
5773 SvTAINTED_off X<SvTAINTED_off>, SvTAINTED_on X<SvTAINTED_on>, SvTRUE
5774 X<SvTRUE>, SvTYPE X<SvTYPE>, SvUOK X<SvUOK>, SvUPGRADE X<SvUPGRADE>, SvUTF8
5775 X<SvUTF8>, SvUTF8_off X<SvUTF8_off>, SvUTF8_on X<SvUTF8_on>, SvUV X<SvUV>,
5776 SvUVX X<SvUVX>, SvUVx X<SvUVx>, SvUV_nomg X<SvUV_nomg>, SvUV_set
5777 X<SvUV_set>, SvVOK X<SvVOK>, sv_catpvn_nomg X<sv_catpvn_nomg>,
5778 sv_catsv_nomg X<sv_catsv_nomg>, sv_derived_from X<sv_derived_from>, sv_does
5779 X<sv_does>, sv_report_used X<sv_report_used>, sv_setsv_nomg
5782 =item SV-Body Allocation
5784 looks_like_number X<looks_like_number>, newRV_noinc X<newRV_noinc>, newSV
5785 X<newSV>, newSVhek X<newSVhek>, newSViv X<newSViv>, newSVnv X<newSVnv>,
5786 newSVpv X<newSVpv>, newSVpvf X<newSVpvf>, newSVpvn X<newSVpvn>,
5787 newSVpvn_share X<newSVpvn_share>, newSVpvs X<newSVpvs>, newSVpvs_share
5788 X<newSVpvs_share>, newSVrv X<newSVrv>, newSVsv X<newSVsv>, newSVuv
5789 X<newSVuv>, newSV_type X<newSV_type>, sv_2bool X<sv_2bool>, sv_2cv
5790 X<sv_2cv>, sv_2io X<sv_2io>, sv_2iv_flags X<sv_2iv_flags>, sv_2mortal
5791 X<sv_2mortal>, sv_2nv X<sv_2nv>, sv_2pvbyte X<sv_2pvbyte>, sv_2pvutf8
5792 X<sv_2pvutf8>, sv_2pv_flags X<sv_2pv_flags>, sv_2uv_flags X<sv_2uv_flags>,
5793 sv_backoff X<sv_backoff>, sv_bless X<sv_bless>, sv_catpv X<sv_catpv>,
5794 sv_catpvf X<sv_catpvf>, sv_catpvf_mg X<sv_catpvf_mg>, sv_catpvn
5795 X<sv_catpvn>, sv_catpvn_flags X<sv_catpvn_flags>, sv_catpvs X<sv_catpvs>,
5796 sv_catpv_mg X<sv_catpv_mg>, sv_catsv X<sv_catsv>, sv_catsv_flags
5797 X<sv_catsv_flags>, sv_chop X<sv_chop>, sv_clear X<sv_clear>, sv_cmp
5798 X<sv_cmp>, sv_cmp_locale X<sv_cmp_locale>, sv_collxfrm X<sv_collxfrm>,
5799 sv_copypv X<sv_copypv>, sv_dec X<sv_dec>, sv_eq X<sv_eq>,
5800 sv_force_normal_flags X<sv_force_normal_flags>, sv_free X<sv_free>, sv_gets
5801 X<sv_gets>, sv_grow X<sv_grow>, sv_inc X<sv_inc>, sv_insert X<sv_insert>,
5802 sv_isa X<sv_isa>, sv_isobject X<sv_isobject>, sv_len X<sv_len>, sv_len_utf8
5803 X<sv_len_utf8>, sv_magic X<sv_magic>, sv_magicext X<sv_magicext>,
5804 sv_mortalcopy X<sv_mortalcopy>, sv_newmortal X<sv_newmortal>, sv_newref
5805 X<sv_newref>, sv_pos_b2u X<sv_pos_b2u>, sv_pos_u2b X<sv_pos_u2b>,
5806 sv_pvbyten_force X<sv_pvbyten_force>, sv_pvn_force X<sv_pvn_force>,
5807 sv_pvn_force_flags X<sv_pvn_force_flags>, sv_pvutf8n_force
5808 X<sv_pvutf8n_force>, sv_reftype X<sv_reftype>, sv_replace X<sv_replace>,
5809 sv_reset X<sv_reset>, sv_rvweaken X<sv_rvweaken>, sv_setiv X<sv_setiv>,
5810 sv_setiv_mg X<sv_setiv_mg>, sv_setnv X<sv_setnv>, sv_setnv_mg
5811 X<sv_setnv_mg>, sv_setpv X<sv_setpv>, sv_setpvf X<sv_setpvf>, sv_setpvf_mg
5812 X<sv_setpvf_mg>, sv_setpviv X<sv_setpviv>, sv_setpviv_mg X<sv_setpviv_mg>,
5813 sv_setpvn X<sv_setpvn>, sv_setpvn_mg X<sv_setpvn_mg>, sv_setpvs
5814 X<sv_setpvs>, sv_setpv_mg X<sv_setpv_mg>, sv_setref_iv X<sv_setref_iv>,
5815 sv_setref_nv X<sv_setref_nv>, sv_setref_pv X<sv_setref_pv>, sv_setref_pvn
5816 X<sv_setref_pvn>, sv_setref_uv X<sv_setref_uv>, sv_setsv X<sv_setsv>,
5817 sv_setsv_flags X<sv_setsv_flags>, sv_setsv_mg X<sv_setsv_mg>, sv_setuv
5818 X<sv_setuv>, sv_setuv_mg X<sv_setuv_mg>, sv_tainted X<sv_tainted>, sv_true
5819 X<sv_true>, sv_unmagic X<sv_unmagic>, sv_unref_flags X<sv_unref_flags>,
5820 sv_untaint X<sv_untaint>, sv_upgrade X<sv_upgrade>, sv_usepvn_flags
5821 X<sv_usepvn_flags>, sv_utf8_decode X<sv_utf8_decode>, sv_utf8_downgrade
5822 X<sv_utf8_downgrade>, sv_utf8_encode X<sv_utf8_encode>, sv_utf8_upgrade
5823 X<sv_utf8_upgrade>, sv_utf8_upgrade_flags X<sv_utf8_upgrade_flags>,
5824 sv_vcatpvf X<sv_vcatpvf>, sv_vcatpvfn X<sv_vcatpvfn>, sv_vcatpvf_mg
5825 X<sv_vcatpvf_mg>, sv_vsetpvf X<sv_vsetpvf>, sv_vsetpvfn X<sv_vsetpvfn>,
5826 sv_vsetpvf_mg X<sv_vsetpvf_mg>
5828 =item Unicode Support
5830 bytes_from_utf8 X<bytes_from_utf8>, bytes_to_utf8 X<bytes_to_utf8>,
5831 ibcmp_utf8 X<ibcmp_utf8>, is_utf8_char X<is_utf8_char>, is_utf8_string
5832 X<is_utf8_string>, is_utf8_string_loc X<is_utf8_string_loc>,
5833 is_utf8_string_loclen X<is_utf8_string_loclen>, pv_uni_display
5834 X<pv_uni_display>, sv_cat_decode X<sv_cat_decode>, sv_recode_to_utf8
5835 X<sv_recode_to_utf8>, sv_uni_display X<sv_uni_display>, to_utf8_case
5836 X<to_utf8_case>, to_utf8_fold X<to_utf8_fold>, to_utf8_lower
5837 X<to_utf8_lower>, to_utf8_title X<to_utf8_title>, to_utf8_upper
5838 X<to_utf8_upper>, utf8n_to_uvchr X<utf8n_to_uvchr>, utf8n_to_uvuni
5839 X<utf8n_to_uvuni>, utf8_distance X<utf8_distance>, utf8_hop X<utf8_hop>,
5840 utf8_length X<utf8_length>, utf8_to_bytes X<utf8_to_bytes>, utf8_to_uvchr
5841 X<utf8_to_uvchr>, utf8_to_uvuni X<utf8_to_uvuni>, uvchr_to_utf8
5842 X<uvchr_to_utf8>, uvuni_to_utf8_flags X<uvuni_to_utf8_flags>
5844 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
5846 ax X<ax>, CLASS X<CLASS>, dAX X<dAX>, dAXMARK X<dAXMARK>, dITEMS X<dITEMS>,
5847 dUNDERBAR X<dUNDERBAR>, dXSARGS X<dXSARGS>, dXSI32 X<dXSI32>, items
5848 X<items>, ix X<ix>, newXSproto X<newXSproto>, RETVAL X<RETVAL>, ST X<ST>,
5849 THIS X<THIS>, UNDERBAR X<UNDERBAR>, XS X<XS>, XS_VERSION X<XS_VERSION>,
5850 XS_VERSION_BOOTCHECK X<XS_VERSION_BOOTCHECK>
5852 =item Warning and Dieing
5854 croak X<croak>, warn X<warn>
5862 =head2 perlintern - autogenerated documentation of purely B<internal>
5868 X<internal Perl functions> X<interpreter functions>
5870 =item CV reference counts and CvOUTSIDE
5872 CvWEAKOUTSIDE X<CvWEAKOUTSIDE>
5874 =item Functions in file pad.h
5876 CX_CURPAD_SAVE X<CX_CURPAD_SAVE>, CX_CURPAD_SV X<CX_CURPAD_SV>, PAD_BASE_SV
5877 X<PAD_BASE_SV>, PAD_CLONE_VARS X<PAD_CLONE_VARS>, PAD_COMPNAME_FLAGS
5878 X<PAD_COMPNAME_FLAGS>, PAD_COMPNAME_GEN X<PAD_COMPNAME_GEN>,
5879 PAD_COMPNAME_GEN_set X<PAD_COMPNAME_GEN_set>, PAD_COMPNAME_OURSTASH
5880 X<PAD_COMPNAME_OURSTASH>, PAD_COMPNAME_PV X<PAD_COMPNAME_PV>,
5881 PAD_COMPNAME_TYPE X<PAD_COMPNAME_TYPE>, PAD_DUP X<PAD_DUP>,
5882 PAD_RESTORE_LOCAL X<PAD_RESTORE_LOCAL>, PAD_SAVE_LOCAL X<PAD_SAVE_LOCAL>,
5883 PAD_SAVE_SETNULLPAD X<PAD_SAVE_SETNULLPAD>, PAD_SETSV X<PAD_SETSV>,
5884 PAD_SET_CUR X<PAD_SET_CUR>, PAD_SET_CUR_NOSAVE X<PAD_SET_CUR_NOSAVE>,
5885 PAD_SV X<PAD_SV>, PAD_SVl X<PAD_SVl>, SAVECLEARSV X<SAVECLEARSV>,
5886 SAVECOMPPAD X<SAVECOMPPAD>, SAVEPADSV X<SAVEPADSV>
5888 =item Functions in file pp_ctl.c
5890 find_runcv X<find_runcv>
5892 =item Global Variables
5894 PL_DBsingle X<PL_DBsingle>, PL_DBsub X<PL_DBsub>, PL_DBtrace X<PL_DBtrace>,
5895 PL_dowarn X<PL_dowarn>, PL_last_in_gv X<PL_last_in_gv>, PL_ofs_sv
5896 X<PL_ofs_sv>, PL_rs X<PL_rs>
5900 is_gv_magical X<is_gv_magical>, is_gv_magical_sv X<is_gv_magical_sv>
5902 =item Hash Manipulation Functions
5904 refcounted_he_chain_2hv X<refcounted_he_chain_2hv>, refcounted_he_free
5905 X<refcounted_he_free>, refcounted_he_new X<refcounted_he_new>
5909 start_glob X<start_glob>
5911 =item Magical Functions
5913 magic_sethint X<magic_sethint>, mg_localize X<mg_localize>
5915 =item Pad Data Structures
5917 CvPADLIST X<CvPADLIST>, cv_clone X<cv_clone>, cv_dump X<cv_dump>,
5918 do_dump_pad X<do_dump_pad>, intro_my X<intro_my>, pad_add_anon
5919 X<pad_add_anon>, pad_add_name X<pad_add_name>, pad_alloc X<pad_alloc>,
5920 pad_block_start X<pad_block_start>, pad_check_dup X<pad_check_dup>,
5921 pad_findlex X<pad_findlex>, pad_findmy X<pad_findmy>, pad_fixup_inner_anons
5922 X<pad_fixup_inner_anons>, pad_free X<pad_free>, pad_leavemy X<pad_leavemy>,
5923 pad_new X<pad_new>, pad_push X<pad_push>, pad_reset X<pad_reset>, pad_setsv
5924 X<pad_setsv>, pad_swipe X<pad_swipe>, pad_tidy X<pad_tidy>, pad_undef
5927 =item Stack Manipulation Macros
5929 djSP X<djSP>, LVRET X<LVRET>
5931 =item SV Manipulation Functions
5933 sv_add_arena X<sv_add_arena>, sv_clean_all X<sv_clean_all>, sv_clean_objs
5934 X<sv_clean_objs>, sv_free_arenas X<sv_free_arenas>
5936 =item Unicode Support
5938 find_uninit_var X<find_uninit_var>, report_uninit X<report_uninit>
5946 =head2 perliol - C API for Perl's implementation of IO in Layers.
5956 =item History and Background
5958 =item Basic Structure
5960 =item Layers vs Disciplines
5962 =item Data Structures
5964 =item Functions and Attributes
5966 =item Per-instance Data
5968 =item Layers in action.
5970 =item Per-instance flag bits
5972 PERLIO_F_EOF, PERLIO_F_CANWRITE, PERLIO_F_CANREAD, PERLIO_F_ERROR,
5973 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
5974 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
5975 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
5977 =item Methods in Detail
5979 fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF,
5980 PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode,
5981 Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof,
5982 Error, Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
5987 =item Implementing PerlIO Layers
5989 C implementations, Perl implementations
5993 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
5995 =item Extension Layers
5997 ":encoding", ":scalar", ":via"
6005 =head2 perlapio - perl's IO abstraction interface.
6013 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
6014 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
6015 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
6016 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
6017 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
6018 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
6019 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
6020 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
6021 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
6022 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
6023 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
6027 =item Co-existence with stdio
6029 B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
6030 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
6032 =item "Fast gets" Functions
6034 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
6035 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
6036 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
6037 B<PerlIO_get_bufsiz(f)>
6039 =item Other Functions
6041 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
6042 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
6048 =head2 perlhack - How to hack at the Perl internals
6054 Does concept match the general goals of Perl?, Where is the
6055 implementation?, Backwards compatibility, Could it be a module instead?, Is
6056 the feature generic enough?, Does it potentially introduce new bugs?, Does
6057 it preclude other desirable features?, Is the implementation robust?, Is
6058 the implementation generic enough to be portable?, Is the implementation
6059 tested?, Is there enough documentation?, Is there another way to do it?,
6060 Does it create too much work?, Patches speak louder than words
6064 =item Keeping in sync
6066 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
6067 NFS, rsync'ing the patches
6069 =item Why rsync the source tree
6071 It's easier to rsync the source tree, It's more reliable
6073 =item Why rsync the patches
6075 It's easier to rsync the patches, It's a good reference, Finding a start
6076 point, Finding how to fix a bug, Finding the source of misbehaviour
6078 =item Working with the source
6080 =item Perlbug administration
6082 =item Submitting patches
6084 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
6085 F<Porting/pumpkin.pod>, The perl5-porters FAQ
6087 =item Finding Your Way Around
6089 Core modules, Tests, Documentation, Configure, Interpreter
6091 =item Elements of the interpreter
6093 Startup, Parsing, Optimization, Running, Exception handing
6095 =item Internal Variable Types
6101 Argument stack, Mark stack, Save stack
6103 =item Millions of Macros
6105 =item The .i Targets
6109 =item SOURCE CODE STATIC ANALYSIS
6117 =item cpd (cut-and-paste detector)
6121 =item Warnings of other C compilers
6125 =item Poking at Perl
6127 =item Using a source-level debugger
6129 run [args], break function_name, break source.c:xxx, step, next, continue,
6130 finish, 'enter', print
6132 =item gdb macro support
6134 =item Dumping Perl Data Structures
6138 =item Patching a core module
6140 =item Adding a new function to the core
6142 =item Writing a test
6144 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
6145 F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base t/comp,
6146 t/cmd t/run t/io t/op, t/lib ext lib
6148 =item Special Make Test Targets
6150 coretest, test.deparse, test.taintwarn, minitest, test.valgrind
6151 check.valgrind utest.valgrind ucheck.valgrind, test.third check.third
6152 utest.third ucheck.third, test.torture torturetest, utest ucheck test.utf8
6153 check.utf8, minitest.utf16 test.utf16, test_harness, test-notty test_notty
6155 =item Running tests by hand
6157 -v, -torture, -re=PATTERN, -re LIST OF PATTERNS, PERL_CORE=1,
6158 PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST
6160 =item Common problems when patching Perl source code
6162 =item Perl environment problems
6164 =item Portability problems
6166 =item Problematic System Interfaces
6168 =item Security problems
6172 =item EXTERNAL TOOLS FOR DEBUGGING PERL
6176 =item Rational Software's Purify
6178 =item Purify on Unix
6180 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
6184 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
6188 =item Compaq's/Digital's/HP's Third Degree
6190 =item PERL_DESTRUCT_LEVEL
6196 =item Gprof Profiling
6198 -a, -b, -e routine, -f routine, -s, -z
6200 =item GCC gcov Profiling
6202 =item Pixie Profiling
6204 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
6207 =item Miscellaneous tricks
6213 I<The Road goes ever on and on, down from the door where it began.>
6219 =head2 perlbook - Perl book information
6227 =head2 perltodo - Perl TO-DO List
6233 =item The roadmap to 5.10
6237 =item Needed for the final 5.10.0 release
6241 =item Tasks that only need Perl knowledge
6245 =item common test code for timed bail out
6247 =item POD -> HTML conversion in the core still sucks
6249 =item Parallel testing
6251 =item Make Schwern poorer
6253 =item Improve the coverage of the core tests
6257 =item A decent benchmark
6259 =item fix tainting bugs
6261 =item Dual life everything
6263 =item Improving C<threads::shared>
6265 =item POSIX memory footprint
6267 =item embed.pl/makedef.pl
6269 =item use strict; and AutoLoad
6273 =item Tasks that need a little sysadmin-type knowledge
6277 =item make HTML install work
6279 =item compressed man pages
6281 =item Add a code coverage target to the Makefile
6283 =item Make Config.pm cope with differences between built and installed perl
6285 =item linker specification files
6287 =item Cross-compile support
6291 =item Tasks that need a little C knowledge
6295 =item Make it clear from -v if this is the exact official release
6297 =item Ordering of "global" variables.
6299 =item Profile Perl - am I hot or not?
6301 =item Allocate OPs from arenas
6303 =item Improve win32/wince.c
6305 =item Use secure CRT functions when building with VC8 on Win32
6309 =item Tasks that need a knowledge of XS
6313 =item autovivification
6315 =item Unicode in Filenames
6317 =item Unicode in %ENV
6319 =item Unicode and glob()
6321 =item use less 'memory'
6323 =item Re-implement C<:unique> in a way that is actually thread-safe
6325 =item Make tainting consistent
6327 =item readpipe(LIST)
6329 =item strcat(), strcpy(), strncat(), strncpy(), sprintf(), vsprintf()
6331 =item Audit the code for destruction ordering assumptions
6333 =item Extend PerlIO and PerlIO::Scalar
6335 =item -C on the #! line
6339 =item Tasks that need a knowledge of the interpreter
6343 =item Implement $value ~~ 0 .. $range
6345 =item Attach/detach debugger from running program
6347 =item LVALUE functions for lists
6349 =item LVALUE functions in the debugger
6351 =item regexp optimiser optional
6353 =item delete &function
6355 =item C</w> regex modifier
6357 =item optional optimizer
6359 =item You WANT *how* many
6361 =item lexical aliases
6363 =item entersub XS vs Perl
6367 =item Optimize away @_
6369 =item What hooks would assertions need?
6371 =item Properly Unicode safe tokeniser and pads.
6373 =item The yada yada yada operators
6381 =item make ithreads more robust
6385 =item (?{...}) closures in regexps
6387 =item A re-entrant regexp engine
6389 =item Add class set operations to regexp engine
6395 =head2 perldoc - Look up Perl documentation in Pod format.
6405 B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
6406 I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
6407 I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
6408 B<-w> I<option:value> or B<-w> I<option>, B<-X>, B<-L> I<language_code>,
6409 B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
6420 =head2 perlhist - the Perl history records
6428 =item THE KEEPERS OF THE PUMPKIN
6440 =item SELECTED RELEASE SIZES
6442 =item SELECTED PATCH SIZES
6446 =item THE KEEPERS OF THE RECORDS
6450 =head2 perldelta - what is new for perl v5.9.5
6456 =item Incompatible Changes
6460 =item Tainting and printf
6462 =item undef and signal handlers
6464 =item strictures and array/hash dereferencing in defined()
6466 =item Removal of the bytecode compiler and of perlcc
6468 =item Removal of the JPL
6472 =item Core Enhancements
6476 =item Regular expressions
6478 Recursive Patterns, Named Capture Buffers, Possessive Quantifiers,
6479 Backtracking control verbs, Relative backreferences, C<\K> escape
6481 =item The C<_> prototype
6483 =item UNITCHECK blocks
6485 =item readpipe() is now overridable
6493 =item Modules and Pragmas
6497 =item New Core Modules
6499 =item Module changes
6501 C<base>, C<warnings>, C<less>, C<Attribute::Handlers>, C<B::Lint>, C<B>
6505 =item Utility Changes
6509 =item Performance Enhancements
6511 =item Installation and Configuration Improvements
6515 =item C++ compatibility
6517 =item Static build on Win32
6523 =item Selected Bug Fixes
6525 =item New or Changed Diagnostics
6527 =item Changed Internals
6529 =item Known Problems
6533 =item Platform Specific Problems
6537 =item Reporting Bugs
6543 =head2 perl595delta, perldelta - what is new for perl v5.9.5
6549 =item Incompatible Changes
6553 =item Tainting and printf
6555 =item undef and signal handlers
6557 =item strictures and array/hash dereferencing in defined()
6559 =item Removal of the bytecode compiler and of perlcc
6561 =item Removal of the JPL
6565 =item Core Enhancements
6569 =item Regular expressions
6571 Recursive Patterns, Named Capture Buffers, Possessive Quantifiers,
6572 Backtracking control verbs, Relative backreferences, C<\K> escape
6574 =item The C<_> prototype
6576 =item UNITCHECK blocks
6578 =item readpipe() is now overridable
6586 =item Modules and Pragmas
6590 =item New Core Modules
6592 =item Module changes
6594 C<base>, C<warnings>, C<less>, C<Attribute::Handlers>, C<B::Lint>, C<B>
6598 =item Utility Changes
6602 =item Performance Enhancements
6604 =item Installation and Configuration Improvements
6608 =item C++ compatibility
6610 =item Static build on Win32
6616 =item Selected Bug Fixes
6618 =item New or Changed Diagnostics
6620 =item Changed Internals
6622 =item Known Problems
6626 =item Platform Specific Problems
6630 =item Reporting Bugs
6636 =head2 perl594delta, perldelta - what is new for perl v5.9.4
6642 =item Incompatible Changes
6648 =item Handling of pmc files
6650 =item @- and @+ in patterns
6652 =item $AUTOLOAD can now be tainted
6656 =item Core Enhancements
6660 =item state() variables
6662 =item UNIVERSAL::DOES()
6664 =item Exceptions in constant folding
6666 =item Source filters in @INC
6672 =item Modules and Pragmas
6676 =item New Core Modules
6680 =item Utility Changes
6692 =item New manpage, perlpragma
6694 =item New manpage, perlreguts
6696 =item New manpage, perlunitut
6700 =item Performance Enhancements
6704 =item Memory optimisations
6706 =item UTF-8 cache optimisation
6708 =item Regular expressions
6710 Engine de-recursivised, Single char char-classes treated as literals, Trie
6711 optimisation of literal string alternations, Aho-Corasick start-point
6714 =item Sloppy stat on Windows
6718 =item Installation and Configuration Improvements
6722 =item Relocatable installations
6726 =item Compilation improvements
6730 =item Windows build improvements
6732 Building XS extensions, Support for 64-bit compiler
6736 =item Selected Bug Fixes
6740 =item PERL5SHELL and tainting
6742 =item Using *FILE{IO}
6744 =item Overloading and reblessing
6746 =item Overloading and UTF-8
6748 =item eval memory leaks fixed
6750 =item Random device on Windows
6754 =item New or Changed Diagnostics
6756 State variable %s will be reinitialized
6758 =item Changed Internals
6760 =item Known Problems
6762 =item Reporting Bugs
6768 =head2 perl593delta, perldelta - what is new for perl v5.9.3
6774 =item Incompatible Changes
6778 =item Parsing of C<-f _>
6782 =item Magic goto and eval
6784 =item C<$#> has been removed
6788 =item Scoping of the C<sort> pragma
6792 =item Core Enhancements
6796 =item The C<feature> pragma
6798 =item Switch and Smart Match operator
6802 =item C<CLONE_SKIP()>
6804 =item C<${^CHILD_ERROR_NATIVE}>
6808 =item Unicode Character Database 4.1.0
6812 =item Recursive sort subs
6814 =item Effect of pragmas in eval
6816 =item New B<-E> command-line switch
6818 =item C<chdir>, C<chmod> and C<chown> on filehandles
6824 =item Modules and Pragmata
6828 =item New Core Modules
6832 =item Utility Changes
6842 =item C<h2xs> enhancements
6844 =item C<perlivp> enhancements
6856 =item Performance Enhancements
6860 =item XS-assisted SWASHGET
6862 =item Constant subroutines
6864 =item C<PERL_DONT_CREATE_GVSV>
6866 =item Weak references are cheaper
6868 =item sort() enhancements
6872 =item Installation and Configuration Improvements
6876 =item Compilation improvements
6878 =item New Or Improved Platforms
6882 =item Module auxiliary files
6886 =item Selected Bug Fixes
6890 =item C<defined $$x>
6892 =item Calling CORE::require()
6894 =item Subscripts of slices
6896 =item Remove over-optimisation
6898 =item sprintf() fixes
6900 =item no warnings 'category' works correctly with -w
6904 =item More Unicode Fixes
6908 =item New or Changed Diagnostics
6912 =item Attempt to set length of freed array
6914 =item Non-string passed as bitmask
6916 =item Search pattern not terminated or ternary operator parsed as search
6919 =item "%s" variable %s masks earlier declaration
6921 =item readdir()/closedir()/etc. attempted on invalid dirhandle
6925 =item Changed Internals
6929 =item B:: modules inheritance changed
6933 =item Reporting Bugs
6939 =head2 perl592delta, perldelta - what is new for perl v5.9.2
6945 =item Incompatible Changes
6949 =item Packing and UTF-8 strings
6955 =item Core Enhancements
6959 =item Malloc wrapping
6961 =item Unicode Character Database 4.0.1
6963 =item suidperl less insecure
6969 =item Unicode Character Classes
6971 =item Byte-order modifiers for pack() and unpack()
6973 =item Byte count feature in pack()
6979 =item Modules and Pragmata
6985 =item Updated And Improved Modules and Pragmata
6987 B::Concise, Socket, Sys::Syslog, threads
6991 =item Utility Changes
6993 =item Performance Enhancements
6995 =item Installation and Configuration Improvements
6997 =item Selected Bug Fixes
6999 =item New or Changed Diagnostics
7001 =item Changed Internals
7003 =item Known Problems
7005 =item Plans for the next release
7007 =item Reporting Bugs
7013 =head2 perl591delta, perldelta - what is new for perl v5.9.1
7019 =item Incompatible Changes
7023 =item substr() lvalues are no longer fixed-length
7025 =item The C<:unique> attribute is only meaningful for globals
7029 =item Core Enhancements
7035 =item Tied hashes in scalar context
7039 =item Stacked filetest operators
7043 =item Modules and Pragmata
7045 Benchmark, Carp, Exporter, FindBin, List::Util, threads::shared
7047 =item Utility Changes
7051 =item Performance Enhancements
7053 =item Selected Bug Fixes
7059 =item Threading bugs
7065 =item New or Changed Diagnostics
7067 =item Changed Internals
7071 =item Reordering of SVt_* constants
7073 =item Removal of CPP symbols
7075 =item Less space is used by ops
7081 =item Configuration and Building
7083 =item Known Problems
7087 =item Platform Specific Problems
7091 =item To-do for perl 5.10.0
7093 =item Reporting Bugs
7099 =head2 perl590delta, perldelta - what is new for perl v5.9.0
7105 =item Incompatible Changes
7109 =item Hash Randomisation
7111 =item UTF-8 On Filehandles No Longer Activated By Locale
7113 =item Single-number v-strings are no longer v-strings before "=>"
7115 =item (Win32) The -C Switch Has Been Repurposed
7117 =item (Win32) The /d Switch Of cmd.exe
7119 =item The C<$*> variable has been removed
7123 =item Core Enhancements
7129 =item Defined-or operators
7131 =item UTF-8 no longer default under UTF-8 locales
7133 =item Unsafe signals again available
7135 =item Tied Arrays with Negative Array Indices
7139 =item Unicode Character Database 4.0.0
7141 =item Miscellaneous Enhancements
7145 =item Modules and Pragmata
7149 =item Updated Modules And Pragmata
7151 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
7152 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
7153 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
7154 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
7155 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
7156 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
7157 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
7162 =item Utility Changes
7164 =item New Documentation
7166 =item Performance Enhancements
7168 =item Installation and Configuration Improvements
7172 =item Platform-specific enhancements
7176 =item Selected Bug Fixes
7180 =item Closures, eval and lexicals
7184 =item Platform-specific fixes
7188 =item New or Changed Diagnostics
7192 =item Changed "A thread exited while %d threads were running"
7194 =item Removed "Attempt to clear a restricted hash"
7196 =item New "Illegal declaration of anonymous subroutine"
7198 =item Changed "Invalid range "%s" in transliteration operator"
7200 =item New "Missing control char name in \c"
7202 =item New "Newline in left-justified string for %s"
7204 =item New "Possible precedence problem on bitwise %c operator"
7206 =item New "read() on %s filehandle %s"
7208 =item New "Tied variable freed while still in use"
7210 =item New "To%s: illegal mapping '%s'"
7212 =item New "Use of freed value in iteration"
7216 =item Changed Internals
7220 =item Known Problems
7224 =item Tied hashes in scalar context
7226 =item Net::Ping 450_service and 510_ping_udp failures
7232 =item Platform Specific Problems
7236 =item EBCDIC Platforms
7238 =item Cygwin 1.5 problems
7240 =item HP-UX: HP cc warnings about sendfile and sendpath
7242 =item IRIX: t/uni/tr_7jis.t falsely failing
7244 =item Mac OS X: no usemymalloc
7246 =item Tru64: No threaded builds with GNU cc (gcc)
7248 =item Win32: sysopen, sysread, syswrite
7254 =item Reporting Bugs
7260 =head2 perl588delta, perldelta - what is new for perl v5.8.8
7266 =item Incompatible Changes
7268 =item Core Enhancements
7270 =item Modules and Pragmata
7272 =item Utility Changes
7276 =item C<h2xs> enhancements
7278 =item C<perlivp> enhancements
7282 =item New Documentation
7284 =item Performance Enhancements
7286 =item Installation and Configuration Improvements
7288 =item Selected Bug Fixes
7292 =item no warnings 'category' works correctly with -w
7294 =item Remove over-optimisation
7296 =item sprintf() fixes
7298 =item Debugger and Unicode slowdown
7304 =item New or Changed Diagnostics
7308 =item Attempt to set length of freed array
7310 =item Non-string passed as bitmask
7312 =item Search pattern not terminated or ternary operator parsed as search
7317 =item Changed Internals
7319 =item Platform Specific Problems
7321 =item Reporting Bugs
7327 =head2 perl587delta, perldelta - what is new for perl v5.8.7
7333 =item Incompatible Changes
7335 =item Core Enhancements
7339 =item Unicode Character Database 4.1.0
7341 =item suidperl less insecure
7343 =item Optional site customization script
7345 =item C<Config.pm> is now much smaller.
7349 =item Modules and Pragmata
7351 =item Utility Changes
7355 =item find2perl enhancements
7359 =item Performance Enhancements
7361 =item Installation and Configuration Improvements
7363 =item Selected Bug Fixes
7365 =item New or Changed Diagnostics
7367 =item Changed Internals
7369 =item Known Problems
7371 =item Platform Specific Problems
7373 =item Reporting Bugs
7379 =head2 perl586delta - what is new for perl v5.8.6
7385 =item Incompatible Changes
7387 =item Core Enhancements
7389 =item Modules and Pragmata
7391 =item Utility Changes
7393 =item Performance Enhancements
7395 =item Selected Bug Fixes
7397 =item New or Changed Diagnostics
7399 =item Changed Internals
7403 =item Reporting Bugs
7409 =head2 perl585delta - what is new for perl v5.8.5
7415 =item Incompatible Changes
7417 =item Core Enhancements
7419 =item Modules and Pragmata
7421 =item Utility Changes
7425 =item Perl's debugger
7431 =item Installation and Configuration Improvements
7433 =item Selected Bug Fixes
7435 =item New or Changed Diagnostics
7437 =item Changed Internals
7439 =item Known Problems
7441 =item Platform Specific Problems
7443 =item Reporting Bugs
7449 =head2 perl584delta - what is new for perl v5.8.4
7455 =item Incompatible Changes
7457 =item Core Enhancements
7461 =item Malloc wrapping
7463 =item Unicode Character Database 4.0.1
7465 =item suidperl less insecure
7471 =item Modules and Pragmata
7475 =item Updated modules
7477 Attribute::Handlers, B, Benchmark, CGI, Carp, Cwd, Exporter, File::Find,
7478 IO, IPC::Open3, Local::Maketext, Math::BigFloat, Math::BigInt,
7479 Math::BigRat, MIME::Base64, ODBM_File, POSIX, Shell, Socket, Storable,
7480 Switch, Sys::Syslog, Term::ANSIColor, Time::HiRes, Unicode::UCD, Win32,
7481 base, open, threads, utf8
7485 =item Performance Enhancements
7487 =item Utility Changes
7489 =item Installation and Configuration Improvements
7491 =item Selected Bug Fixes
7493 =item New or Changed Diagnostics
7495 =item Changed Internals
7497 =item Future Directions
7499 =item Platform Specific Problems
7501 =item Reporting Bugs
7507 =head2 perl583delta - what is new for perl v5.8.3
7513 =item Incompatible Changes
7515 =item Core Enhancements
7517 =item Modules and Pragmata
7519 CGI, Cwd, Digest, Digest::MD5, Encode, File::Spec, FindBin, List::Util,
7520 Math::BigInt, PodParser, Pod::Perldoc, POSIX, Unicode::Collate,
7521 Unicode::Normalize, Test::Harness, threads::shared
7523 =item Utility Changes
7525 =item New Documentation
7527 =item Installation and Configuration Improvements
7529 =item Selected Bug Fixes
7531 =item New or Changed Diagnostics
7533 =item Changed Internals
7535 =item Configuration and Building
7537 =item Platform Specific Problems
7539 =item Known Problems
7541 =item Future Directions
7545 =item Reporting Bugs
7551 =head2 perl582delta - what is new for perl v5.8.2
7557 =item Incompatible Changes
7559 =item Core Enhancements
7563 =item Hash Randomisation
7569 =item Modules and Pragmata
7573 =item Updated Modules And Pragmata
7575 Devel::PPPort, Digest::MD5, I18N::LangTags, libnet, MIME::Base64,
7576 Pod::Perldoc, strict, Tie::Hash, Time::HiRes, Unicode::Collate,
7577 Unicode::Normalize, UNIVERSAL
7581 =item Selected Bug Fixes
7583 =item Changed Internals
7585 =item Platform Specific Problems
7587 =item Future Directions
7589 =item Reporting Bugs
7595 =head2 perl581delta - what is new for perl v5.8.1
7601 =item Incompatible Changes
7605 =item Hash Randomisation
7607 =item UTF-8 On Filehandles No Longer Activated By Locale
7609 =item Single-number v-strings are no longer v-strings before "=>"
7611 =item (Win32) The -C Switch Has Been Repurposed
7613 =item (Win32) The /d Switch Of cmd.exe
7617 =item Core Enhancements
7621 =item UTF-8 no longer default under UTF-8 locales
7623 =item Unsafe signals again available
7625 =item Tied Arrays with Negative Array Indices
7629 =item Unicode Character Database 4.0.0
7631 =item Deprecation Warnings
7633 =item Miscellaneous Enhancements
7637 =item Modules and Pragmata
7641 =item Updated Modules And Pragmata
7643 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
7644 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
7645 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
7646 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
7647 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
7648 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
7649 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
7654 =item Utility Changes
7656 =item New Documentation
7658 =item Installation and Configuration Improvements
7662 =item Platform-specific enhancements
7666 =item Selected Bug Fixes
7670 =item Closures, eval and lexicals
7674 =item Platform-specific fixes
7678 =item New or Changed Diagnostics
7682 =item Changed "A thread exited while %d threads were running"
7684 =item Removed "Attempt to clear a restricted hash"
7686 =item New "Illegal declaration of anonymous subroutine"
7688 =item Changed "Invalid range "%s" in transliteration operator"
7690 =item New "Missing control char name in \c"
7692 =item New "Newline in left-justified string for %s"
7694 =item New "Possible precedence problem on bitwise %c operator"
7696 =item New "Pseudo-hashes are deprecated"
7698 =item New "read() on %s filehandle %s"
7700 =item New "5.005 threads are deprecated"
7702 =item New "Tied variable freed while still in use"
7704 =item New "To%s: illegal mapping '%s'"
7706 =item New "Use of freed value in iteration"
7710 =item Changed Internals
7714 =item Known Problems
7718 =item Tied hashes in scalar context
7720 =item Net::Ping 450_service and 510_ping_udp failures
7726 =item Platform Specific Problems
7730 =item EBCDIC Platforms
7732 =item Cygwin 1.5 problems
7734 =item HP-UX: HP cc warnings about sendfile and sendpath
7736 =item IRIX: t/uni/tr_7jis.t falsely failing
7738 =item Mac OS X: no usemymalloc
7740 =item Tru64: No threaded builds with GNU cc (gcc)
7742 =item Win32: sysopen, sysread, syswrite
7746 =item Future Directions
7748 =item Reporting Bugs
7754 =head2 perl58delta - what is new for perl v5.8.0
7760 =item Highlights In 5.8.0
7762 =item Incompatible Changes
7766 =item Binary Incompatibility
7768 =item 64-bit platforms and malloc
7770 =item AIX Dynaloading
7772 =item Attributes for C<my> variables now handled at run-time
7774 =item Socket Extension Dynamic in VMS
7776 =item IEEE-format Floating Point Default on OpenVMS Alpha
7778 =item New Unicode Semantics (no more C<use utf8>, almost)
7780 =item New Unicode Properties
7782 =item REF(...) Instead Of SCALAR(...)
7784 =item pack/unpack D/F recycled
7786 =item glob() now returns filenames in alphabetical order
7792 =item Core Enhancements
7796 =item Unicode Overhaul
7798 =item PerlIO is Now The Default
7802 =item Restricted Hashes
7806 =item Understanding of Numbers
7808 =item Arrays now always interpolate into double-quoted strings [561]
7810 =item Miscellaneous Changes
7814 =item Modules and Pragmata
7818 =item New Modules and Pragmata
7820 =item Updated And Improved Modules and Pragmata
7824 =item Utility Changes
7826 =item New Documentation
7828 =item Performance Enhancements
7830 =item Installation and Configuration Improvements
7834 =item Generic Improvements
7836 =item New Or Improved Platforms
7840 =item Selected Bug Fixes
7844 =item Platform Specific Changes and Fixes
7848 =item New or Changed Diagnostics
7850 =item Changed Internals
7852 =item Security Vulnerability Closed [561]
7856 =item Known Problems
7860 =item The Compiler Suite Is Still Very Experimental
7862 =item Localising Tied Arrays and Hashes Is Broken
7864 =item Building Extensions Can Fail Because Of Largefiles
7866 =item Modifying $_ Inside for(..)
7868 =item mod_perl 1.26 Doesn't Build With Threaded Perl
7870 =item lib/ftmp-security tests warn 'system possibly insecure'
7872 =item libwww-perl (LWP) fails base/date #51
7874 =item PDL failing some tests
7878 =item Self-tying Problems
7880 =item ext/threads/t/libc
7882 =item Failure of Thread (5.005-style) tests
7884 =item Timing problems
7886 =item Tied/Magical Array/Hash Elements Do Not Autovivify
7888 =item Unicode in package/class and subroutine names does not work
7892 =item Platform Specific Problems
7898 =item Alpha systems with old gccs fail several tests
7904 =item Cygwin "unable to remap"
7906 =item Cygwin ndbm tests fail on FAT
7908 =item DJGPP Failures
7910 =item FreeBSD built with ithreads coredumps reading large directories
7912 =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
7914 =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
7916 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
7918 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
7920 =item Linux With Sfio Fails op/misc Test 48
7924 =item Mac OS X dyld undefined symbols
7926 =item OS/2 Test Failures
7928 =item op/sprintf tests 91, 129, and 130
7934 =item Solaris x86 Fails Tests With -Duse64bitint
7936 =item SUPER-UX (NEC SX)
7938 =item Term::ReadKey not working on Win32
7950 =item XML::Parser not working
7954 =item Unicode Support on EBCDIC Still Spotty
7956 =item Seen In Perl 5.7 But Gone Now
7960 =item Reporting Bugs
7968 =head2 perl573delta - what's new for perl v5.7.3
7976 =item Reporting Bugs
7984 =head2 perl572delta - what's new for perl v5.7.2
7990 =item Security Vulnerability Closed
7992 =item Incompatible Changes
7996 =item 64-bit platforms and malloc
7998 =item AIX Dynaloading
8000 =item Socket Extension Dynamic in VMS
8002 =item Different Definition of the Unicode Character Classes \p{In...}
8008 =item Core Enhancements
8010 =item Modules and Pragmata
8014 =item New Modules and Distributions
8016 =item Updated And Improved Modules and Pragmata
8020 =item Utility Changes
8022 =item New Documentation
8024 =item Installation and Configuration Improvements
8028 =item New Or Improved Platforms
8030 =item Generic Improvements
8034 =item Selected Bug Fixes
8038 =item Platform Specific Changes and Fixes
8042 =item New or Changed Diagnostics
8044 =item Source Code Enhancements
8048 =item MAGIC constants
8050 =item Better commented code
8052 =item Regex pre-/post-compilation items matched up
8060 =item Known Problems
8066 =item Amiga Perl Invoking Mystery
8068 =item lib/ftmp-security tests warn 'system possibly insecure'
8070 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
8072 =item HP-UX lib/io_multihomed Fails When LP64-Configured
8074 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
8076 =item Linux With Sfio Fails op/misc Test 48
8080 =item op/sprintf tests 129 and 130
8082 =item Failure of Thread tests
8092 =item Localising a Tied Variable Leaks Memory
8094 =item Self-tying of Arrays and Hashes Is Forbidden
8096 =item Variable Attributes are not Currently Usable for Tieing
8098 =item Building Extensions Can Fail Because Of Largefiles
8100 =item The Compiler Suite Is Still Experimental
8102 =item The Long Double Support is Still Experimental
8106 =item Reporting Bugs
8114 =head2 perl571delta - what's new for perl v5.7.1
8120 =item Security Vulnerability Closed
8122 =item Incompatible Changes
8124 =item Core Enhancements
8128 =item AUTOLOAD Is Now Lvaluable
8130 =item PerlIO is Now The Default
8132 =item Signals Are Now Safe
8136 =item Modules and Pragmata
8142 =item Updated And Improved Modules and Pragmata
8146 =item Performance Enhancements
8148 =item Utility Changes
8150 =item New Documentation
8166 =item README.solaris
8170 =item Porting/repository.pod
8174 =item Installation and Configuration Improvements
8178 =item New Or Improved Platforms
8180 =item Generic Improvements
8182 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
8183 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
8184 d_strtoq, d_u32align, d_ualarm, d_usleep
8188 =item Selected Bug Fixes
8192 =item Platform Specific Changes and Fixes
8196 =item New or Changed Diagnostics
8198 =item Changed Internals
8202 =item Known Problems
8206 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
8208 =item lib/ftmp-security tests warn 'system possibly insecure'
8210 =item lib/io_multihomed Fails In LP64-Configured HP-UX
8212 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
8216 =item Linux With Sfio Fails op/misc Test 48
8218 =item sigaction test 13 in VMS
8220 =item sprintf tests 129 and 130
8222 =item Failure of Thread tests
8224 =item Localising a Tied Variable Leaks Memory
8226 =item Self-tying of Arrays and Hashes Is Forbidden
8228 =item Building Extensions Can Fail Because Of Largefiles
8230 =item The Compiler Suite Is Still Experimental
8234 =item Reporting Bugs
8242 =head2 perl570delta - what's new for perl v5.7.0
8248 =item Security Vulnerability Closed
8250 =item Incompatible Changes
8252 =item Core Enhancements
8254 =item Modules and Pragmata
8260 =item Updated And Improved Modules and Pragmata
8264 =item Utility Changes
8266 =item New Documentation
8268 =item Performance Enhancements
8270 =item Installation and Configuration Improvements
8274 =item Generic Improvements
8278 =item Selected Bug Fixes
8282 =item Platform Specific Changes and Fixes
8286 =item New or Changed Diagnostics
8288 =item Changed Internals
8290 =item Known Problems
8294 =item Unicode Support Still Far From Perfect
8296 =item EBCDIC Still A Lost Platform
8298 =item Building Extensions Can Fail Because Of Largefiles
8300 =item ftmp-security tests warn 'system possibly insecure'
8302 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
8304 =item Long Doubles Still Don't Work In Solaris
8306 =item Linux With Sfio Fails op/misc Test 48
8308 =item Storable tests fail in some platforms
8310 =item Threads Are Still Experimental
8312 =item The Compiler Suite Is Still Experimental
8316 =item Reporting Bugs
8324 =head2 perl561delta - what's new for perl v5.6.x
8330 =item Summary of changes between 5.6.0 and 5.6.1
8334 =item Security Issues
8336 =item Core bug fixes
8338 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
8339 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
8340 references to special variables, Lexical warnings, Spurious warnings and
8341 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
8342 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
8343 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
8348 =item Configuration issues
8352 =item Bundled modules
8354 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
8355 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
8356 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
8357 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
8359 =item Platform-specific improvements
8361 NCR MP-RAS, NonStop-UX
8365 =item Core Enhancements
8369 =item Interpreter cloning, threads, and concurrency
8371 =item Lexically scoped warning categories
8373 =item Unicode and UTF-8 support
8375 =item Support for interpolating named characters
8377 =item "our" declarations
8379 =item Support for strings represented as a vector of ordinals
8381 =item Improved Perl version numbering system
8383 =item New syntax for declaring subroutine attributes
8385 =item File and directory handles can be autovivified
8387 =item open() with more than two arguments
8389 =item 64-bit support
8391 =item Large file support
8397 =item Enhanced support for sort() subroutines
8399 =item C<sort $coderef @foo> allowed
8401 =item File globbing implemented internally
8403 =item Support for CHECK blocks
8405 =item POSIX character class syntax [: :] supported
8407 =item Better pseudo-random number generator
8409 =item Improved C<qw//> operator
8411 =item Better worst-case behavior of hashes
8413 =item pack() format 'Z' supported
8415 =item pack() format modifier '!' supported
8417 =item pack() and unpack() support counted strings
8419 =item Comments in pack() templates
8421 =item Weak references
8423 =item Binary numbers supported
8425 =item Lvalue subroutines
8427 =item Some arrows may be omitted in calls through references
8429 =item Boolean assignment operators are legal lvalues
8431 =item exists() is supported on subroutine names
8433 =item exists() and delete() are supported on array elements
8435 =item Pseudo-hashes work better
8437 =item Automatic flushing of output buffers
8439 =item Better diagnostics on meaningless filehandle operations
8441 =item Where possible, buffered data discarded from duped input filehandle
8443 =item eof() has the same old magic as <>
8445 =item binmode() can be used to set :crlf and :raw modes
8447 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
8449 =item system(), backticks and pipe open now reflect exec() failure
8451 =item Improved diagnostics
8453 =item Diagnostics follow STDERR
8455 =item More consistent close-on-exec behavior
8457 =item syswrite() ease-of-use
8459 =item Better syntax checks on parenthesized unary operators
8461 =item Bit operators support full native integer width
8463 =item Improved security features
8465 =item More functional bareword prototype (*)
8467 =item C<require> and C<do> may be overridden
8469 =item $^X variables may now have names longer than one character
8471 =item New variable $^C reflects C<-c> switch
8473 =item New variable $^V contains Perl version as a string
8475 =item Optional Y2K warnings
8477 =item Arrays now always interpolate into double-quoted strings
8479 =item @- and @+ provide starting/ending offsets of regex submatches
8483 =item Modules and Pragmata
8489 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
8490 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
8491 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
8492 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
8493 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
8494 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
8495 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
8496 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
8502 =item Utility Changes
8516 =item The Perl Debugger
8520 =item Improved Documentation
8522 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
8523 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
8524 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
8525 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
8527 =item Performance enhancements
8531 =item Simple sort() using { $a <=> $b } and the like are optimized
8533 =item Optimized assignments to lexical variables
8535 =item Faster subroutine calls
8537 =item delete(), each(), values() and hash iteration are faster
8541 =item Installation and Configuration Improvements
8545 =item -Dusethreads means something different
8547 =item New Configure flags
8549 =item Threadedness and 64-bitness now more daring
8555 =item -Duselargefiles
8557 =item installusrbinperl
8563 =item Enhanced Installation Directories
8565 =item gcc automatically tried if 'cc' does not seem to be working
8569 =item Platform specific changes
8573 =item Supported platforms
8577 =item OS390 (OpenEdition MVS)
8585 =item Significant bug fixes
8589 =item <HANDLE> on empty files
8591 =item C<eval '...'> improvements
8593 =item All compilation errors are true errors
8595 =item Implicitly closed filehandles are safer
8597 =item Behavior of list slices is more consistent
8599 =item C<(\$)> prototype and C<$foo{a}>
8601 =item C<goto &sub> and AUTOLOAD
8603 =item C<-bareword> allowed under C<use integer>
8605 =item Failures in DESTROY()
8607 =item Locale bugs fixed
8611 =item Spurious subroutine stubs after failed subroutine calls
8613 =item Taint failures under C<-U>
8615 =item END blocks and the C<-c> switch
8617 =item Potential to leak DATA filehandles
8621 =item New or Changed Diagnostics
8623 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
8624 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
8625 / cannot take a count, / must be followed by a, A or Z, / must be followed
8626 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
8627 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
8628 passed through, /%s/ should probably be written as "%s", %s() called too
8629 early to check prototype, %s argument is not a HASH or ARRAY element, %s
8630 argument is not a HASH or ARRAY element or slice, %s argument is not a
8631 subroutine name, %s package attribute may clash with future reserved word:
8632 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
8633 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
8634 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
8635 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
8636 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
8637 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
8638 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
8639 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
8640 weaken a nonreference, Character class [:%s:] unknown, Character class
8641 syntax [%s] belongs inside character classes, Constant is not %s reference,
8642 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
8643 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
8644 "local" instead of "our"?), Document contains no data, entering effective
8645 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
8646 output, flock() on closed filehandle %s, Global symbol "%s" requires
8647 explicit package name, Hexadecimal number > 0xffffffff non-portable,
8648 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
8649 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
8650 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
8651 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
8652 separator character %s in attribute list, Invalid separator character %s in
8653 subroutine attribute list, leaving effective %s failed, Lvalue subs
8654 returning %s not implemented yet, Method %s not permitted, Missing
8655 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
8656 No %s specified for -%c, No package name allowed for variable %s in "our",
8657 No space allowed after -%c, no UTC offset information; assuming local time
8658 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
8659 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
8660 around "%s" list, Possible unintended interpolation of %s in string,
8661 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
8662 instead, Premature end of script headers, Repeat count in pack overflows,
8663 Repeat count in unpack overflows, realloc() of freed memory ignored,
8664 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
8665 zero-length expression, switching effective %s is not implemented, This
8666 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
8667 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
8668 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
8669 escape \\%c passed through, Unterminated attribute parameter in attribute
8670 list, Unterminated attribute list, Unterminated attribute parameter in
8671 subroutine attribute list, Unterminated subroutine attribute list, Value of
8672 CLI symbol "%s" too long, Version number must be a constant number
8676 =item Incompatible Changes
8680 =item Perl Source Incompatibilities
8682 CHECK is a new keyword, Treatment of list slices of undef has changed,
8683 Format of $English::PERL_VERSION is different, Literals of the form
8684 C<1.2.3> parse differently, Possibly changed pseudo-random number
8685 generator, Hashing function for hash keys has changed, C<undef> fails on
8686 read only values, Close-on-exec bit may be set on pipe and socket handles,
8687 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
8688 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
8689 Text of some diagnostic output has changed, C<%@> has been removed,
8690 Parenthesized not() behaves like a list operator, Semantics of bareword
8691 prototype C<(*)> have changed, Semantics of bit operators may have changed
8692 on 64-bit platforms, More builtins taint their results
8694 =item C Source Incompatibilities
8696 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
8698 =item Compatible C Source API Changes
8700 C<PATCHLEVEL> is now C<PERL_VERSION>
8702 =item Binary Incompatibilities
8706 =item Known Problems
8710 =item Localizing a tied hash element may leak memory
8712 =item Known test failures
8714 =item EBCDIC platforms not fully supported
8716 =item UNICOS/mk CC failures during Configure run
8718 =item Arrow operator and arrays
8720 =item Experimental features
8722 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
8723 pseudo-hash data type, The Compiler suite, Internal implementation of file
8724 globbing, The DB module, The regular expression code constructs:
8728 =item Obsolete Diagnostics
8730 Character class syntax [: :] is reserved for future extensions, Ill-formed
8731 logical name |%s| in prime_env_iter, In string, @%s now must be written as
8732 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
8733 to mean "${$}<digit>" is deprecated
8735 =item Reporting Bugs
8743 =head2 perl56delta - what's new for perl v5.6.0
8749 =item Core Enhancements
8753 =item Interpreter cloning, threads, and concurrency
8755 =item Lexically scoped warning categories
8757 =item Unicode and UTF-8 support
8759 =item Support for interpolating named characters
8761 =item "our" declarations
8763 =item Support for strings represented as a vector of ordinals
8765 =item Improved Perl version numbering system
8767 =item New syntax for declaring subroutine attributes
8769 =item File and directory handles can be autovivified
8771 =item open() with more than two arguments
8773 =item 64-bit support
8775 =item Large file support
8781 =item Enhanced support for sort() subroutines
8783 =item C<sort $coderef @foo> allowed
8785 =item File globbing implemented internally
8787 =item Support for CHECK blocks
8789 =item POSIX character class syntax [: :] supported
8791 =item Better pseudo-random number generator
8793 =item Improved C<qw//> operator
8795 =item Better worst-case behavior of hashes
8797 =item pack() format 'Z' supported
8799 =item pack() format modifier '!' supported
8801 =item pack() and unpack() support counted strings
8803 =item Comments in pack() templates
8805 =item Weak references
8807 =item Binary numbers supported
8809 =item Lvalue subroutines
8811 =item Some arrows may be omitted in calls through references
8813 =item Boolean assignment operators are legal lvalues
8815 =item exists() is supported on subroutine names
8817 =item exists() and delete() are supported on array elements
8819 =item Pseudo-hashes work better
8821 =item Automatic flushing of output buffers
8823 =item Better diagnostics on meaningless filehandle operations
8825 =item Where possible, buffered data discarded from duped input filehandle
8827 =item eof() has the same old magic as <>
8829 =item binmode() can be used to set :crlf and :raw modes
8831 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
8833 =item system(), backticks and pipe open now reflect exec() failure
8835 =item Improved diagnostics
8837 =item Diagnostics follow STDERR
8839 =item More consistent close-on-exec behavior
8841 =item syswrite() ease-of-use
8843 =item Better syntax checks on parenthesized unary operators
8845 =item Bit operators support full native integer width
8847 =item Improved security features
8849 =item More functional bareword prototype (*)
8851 =item C<require> and C<do> may be overridden
8853 =item $^X variables may now have names longer than one character
8855 =item New variable $^C reflects C<-c> switch
8857 =item New variable $^V contains Perl version as a string
8859 =item Optional Y2K warnings
8861 =item Arrays now always interpolate into double-quoted strings
8863 =item @- and @+ provide starting/ending offsets of regex matches
8867 =item Modules and Pragmata
8873 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
8874 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
8875 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
8876 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
8877 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
8878 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
8879 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
8880 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
8886 =item Utility Changes
8900 =item The Perl Debugger
8904 =item Improved Documentation
8906 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
8907 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
8908 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
8909 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
8911 =item Performance enhancements
8915 =item Simple sort() using { $a <=> $b } and the like are optimized
8917 =item Optimized assignments to lexical variables
8919 =item Faster subroutine calls
8921 =item delete(), each(), values() and hash iteration are faster
8925 =item Installation and Configuration Improvements
8929 =item -Dusethreads means something different
8931 =item New Configure flags
8933 =item Threadedness and 64-bitness now more daring
8939 =item -Duselargefiles
8941 =item installusrbinperl
8947 =item Enhanced Installation Directories
8951 =item Platform specific changes
8955 =item Supported platforms
8959 =item OS390 (OpenEdition MVS)
8967 =item Significant bug fixes
8971 =item <HANDLE> on empty files
8973 =item C<eval '...'> improvements
8975 =item All compilation errors are true errors
8977 =item Implicitly closed filehandles are safer
8979 =item Behavior of list slices is more consistent
8981 =item C<(\$)> prototype and C<$foo{a}>
8983 =item C<goto &sub> and AUTOLOAD
8985 =item C<-bareword> allowed under C<use integer>
8987 =item Failures in DESTROY()
8989 =item Locale bugs fixed
8993 =item Spurious subroutine stubs after failed subroutine calls
8995 =item Taint failures under C<-U>
8997 =item END blocks and the C<-c> switch
8999 =item Potential to leak DATA filehandles
9003 =item New or Changed Diagnostics
9005 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
9006 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
9007 / cannot take a count, / must be followed by a, A or Z, / must be followed
9008 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
9009 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
9010 passed through, /%s/ should probably be written as "%s", %s() called too
9011 early to check prototype, %s argument is not a HASH or ARRAY element, %s
9012 argument is not a HASH or ARRAY element or slice, %s argument is not a
9013 subroutine name, %s package attribute may clash with future reserved word:
9014 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
9015 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
9016 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
9017 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
9018 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
9019 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
9020 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
9021 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
9022 weaken a nonreference, Character class [:%s:] unknown, Character class
9023 syntax [%s] belongs inside character classes, Constant is not %s reference,
9024 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
9025 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
9026 "local" instead of "our"?), Document contains no data, entering effective
9027 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
9028 output, flock() on closed filehandle %s, Global symbol "%s" requires
9029 explicit package name, Hexadecimal number > 0xffffffff non-portable,
9030 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
9031 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
9032 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
9033 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
9034 separator character %s in attribute list, Invalid separator character %s in
9035 subroutine attribute list, leaving effective %s failed, Lvalue subs
9036 returning %s not implemented yet, Method %s not permitted, Missing
9037 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
9038 No %s specified for -%c, No package name allowed for variable %s in "our",
9039 No space allowed after -%c, no UTC offset information; assuming local time
9040 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
9041 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
9042 around "%s" list, Possible unintended interpolation of %s in string,
9043 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
9044 instead, Premature end of script headers, Repeat count in pack overflows,
9045 Repeat count in unpack overflows, realloc() of freed memory ignored,
9046 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
9047 zero-length expression, switching effective %s is not implemented, This
9048 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
9049 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
9050 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
9051 escape \\%c passed through, Unterminated attribute parameter in attribute
9052 list, Unterminated attribute list, Unterminated attribute parameter in
9053 subroutine attribute list, Unterminated subroutine attribute list, Value of
9054 CLI symbol "%s" too long, Version number must be a constant number
9058 =item Incompatible Changes
9062 =item Perl Source Incompatibilities
9064 CHECK is a new keyword, Treatment of list slices of undef has changed,
9065 Format of $English::PERL_VERSION is different, Literals of the form
9066 C<1.2.3> parse differently, Possibly changed pseudo-random number
9067 generator, Hashing function for hash keys has changed, C<undef> fails on
9068 read only values, Close-on-exec bit may be set on pipe and socket handles,
9069 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
9070 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
9071 Text of some diagnostic output has changed, C<%@> has been removed,
9072 Parenthesized not() behaves like a list operator, Semantics of bareword
9073 prototype C<(*)> have changed, Semantics of bit operators may have changed
9074 on 64-bit platforms, More builtins taint their results
9076 =item C Source Incompatibilities
9078 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
9080 =item Compatible C Source API Changes
9082 C<PATCHLEVEL> is now C<PERL_VERSION>
9084 =item Binary Incompatibilities
9088 =item Known Problems
9092 =item Thread test failures
9094 =item EBCDIC platforms not supported
9096 =item In 64-bit HP-UX the lib/io_multihomed test may hang
9098 =item NEXTSTEP 3.3 POSIX test failure
9100 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
9103 =item UNICOS/mk CC failures during Configure run
9105 =item Arrow operator and arrays
9107 =item Experimental features
9109 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
9110 pseudo-hash data type, The Compiler suite, Internal implementation of file
9111 globbing, The DB module, The regular expression code constructs:
9115 =item Obsolete Diagnostics
9117 Character class syntax [: :] is reserved for future extensions, Ill-formed
9118 logical name |%s| in prime_env_iter, In string, @%s now must be written as
9119 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
9120 to mean "${$}<digit>" is deprecated
9122 =item Reporting Bugs
9130 =head2 perl5005delta - what's new for perl5.005
9136 =item About the new versioning system
9138 =item Incompatible Changes
9142 =item WARNING: This version is not binary compatible with Perl 5.004.
9144 =item Default installation structure has changed
9146 =item Perl Source Compatibility
9148 =item C Source Compatibility
9150 =item Binary Compatibility
9152 =item Security fixes may affect compatibility
9154 =item Relaxed new mandatory warnings introduced in 5.004
9168 =item Regular Expressions
9170 Many new and improved optimizations, Many bug fixes, New regular expression
9171 constructs, New operator for precompiled regular expressions, Other
9172 improvements, Incompatible changes
9174 =item Improved malloc()
9176 =item Quicksort is internally implemented
9178 =item Reliable signals
9180 =item Reliable stack pointers
9182 =item More generous treatment of carriage returns
9186 =item Better support for multiple interpreters
9188 =item Behavior of local() on array and hash elements is now well-defined
9190 =item C<%!> is transparently tied to the L<Errno> module
9192 =item Pseudo-hashes are supported
9194 =item C<EXPR foreach EXPR> is supported
9196 =item Keywords can be globally overridden
9198 =item C<$^E> is meaningful on Win32
9200 =item C<foreach (1..1000000)> optimized
9202 =item C<Foo::> can be used as implicitly quoted package name
9204 =item C<exists $Foo::{Bar::}> tests existence of a package
9206 =item Better locale support
9208 =item Experimental support for 64-bit platforms
9210 =item prototype() returns useful results on builtins
9212 =item Extended support for exception handling
9214 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
9216 =item All C<printf> format conversions are handled internally
9218 =item New C<INIT> keyword
9220 =item New C<lock> keyword
9222 =item New C<qr//> operator
9224 =item C<our> is now a reserved word
9226 =item Tied arrays are now fully supported
9228 =item Tied handles support is better
9230 =item 4th argument to substr
9232 =item Negative LENGTH argument to splice
9234 =item Magic lvalues are now more magical
9236 =item <> now reads in records
9240 =item Supported Platforms
9246 =item Changes in existing support
9250 =item Modules and Pragmata
9256 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
9257 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
9258 Thread, attrs, fields, re
9260 =item Changes in existing modules
9262 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
9263 MakeMaker, CPAN, Cwd
9267 =item Utility Changes
9269 =item Documentation Changes
9271 =item New Diagnostics
9273 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
9274 while coercing array into hash, Bareword "%s" refers to nonexistent
9275 package, Can't call method "%s" on an undefined value, Can't check
9276 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
9277 goto subroutine from an eval-string, Can't localize pseudo-hash element,
9278 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
9279 for "%s", Character class syntax [. .] is reserved for future extensions,
9280 Character class syntax [: :] is reserved for future extensions, Character
9281 class syntax [= =] is reserved for future extensions, %s: Eval-group in
9282 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
9283 Eval-group not allowed at run time, Explicit blessing to '' (assuming
9284 package main), Illegal hex digit ignored, No such array field, No such
9285 field "%s" in variable %s of type %s, Out of memory during ridiculously
9286 large request, Range iterator outside integer range, Recursive inheritance
9287 detected while looking for method '%s' %s, Reference found where even-sized
9288 list expected, Undefined value assigned to typeglob, Use of reserved word
9289 "%s" is deprecated, perl: warning: Setting locale failed
9291 =item Obsolete Diagnostics
9293 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
9294 temporary file, regexp too big
9296 =item Configuration Changes
9306 =head2 perl5004delta - what's new for perl5.004
9312 =item Supported Environments
9318 =item List assignment to %ENV works
9320 =item Change to "Can't locate Foo.pm in @INC" error
9322 =item Compilation option: Binary compatibility with 5.003
9324 =item $PERL5OPT environment variable
9326 =item Limitations on B<-M>, B<-m>, and B<-T> options
9328 =item More precise warnings
9330 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
9332 =item Previously deprecated %OVERLOAD is no longer usable
9334 =item Subroutine arguments created only when they're modified
9336 =item Group vector changeable with C<$)>
9338 =item Fixed parsing of $$<digit>, &$<digit>, etc.
9340 =item Fixed localization of $<digit>, $&, etc.
9342 =item No resetting of $. on implicit close
9344 =item C<wantarray> may return undef
9346 =item C<eval EXPR> determines value of EXPR in scalar context
9348 =item Changes to tainting checks
9350 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
9351 spawning if tainted $TERM doesn't look like a terminal name
9353 =item New Opcode module and revised Safe module
9355 =item Embedding improvements
9357 =item Internal change: FileHandle class based on IO::* classes
9359 =item Internal change: PerlIO abstraction interface
9361 =item New and changed syntax
9365 =item New and changed builtin constants
9369 =item New and changed builtin variables
9373 =item New and changed builtin functions
9375 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
9376 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
9377 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
9378 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
9379 nested C<sub{}> closures work now, formats work right on changing lexicals
9381 =item New builtin methods
9383 isa(CLASS), can(METHOD), VERSION( [NEED] )
9385 =item TIEHANDLE now supported
9387 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
9388 LIST, READLINE this, GETC this, DESTROY this
9390 =item Malloc enhancements
9392 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
9394 =item Miscellaneous efficiency enhancements
9398 =item Support for More Operating Systems
9414 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
9415 constant NAME => VALUE, use locale, use ops, use vmsish
9421 =item Required Updates
9423 =item Installation directories
9425 =item Module information summary
9439 =item Object-oriented overrides for builtin operators
9443 =item Utility Changes
9449 Sends converted HTML to standard output
9453 C<void> XSUBs now default to returning nothing
9457 =item C Language API Changes
9459 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
9462 =item Documentation Changes
9464 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
9465 L<perlmodlib>, L<perldebug>, L<perlsec>
9467 =item New Diagnostics
9469 "my" variable %s masks earlier declaration in same scope, %s argument is
9470 not a HASH element or slice, Allocation too large: %lx, Allocation too
9471 large, Applying %s to %s will act on scalar(%s), Attempt to free
9472 nonexistent shared string, Attempt to use reference as lvalue in substr,
9473 Bareword "%s" refers to nonexistent package, Can't redefine active sort
9474 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
9475 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
9476 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
9477 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
9478 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
9479 %s, Integer overflow in hex number, Integer overflow in octal number,
9480 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
9481 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
9482 possible typo, Null picture in formline, Offset outside string, Out of
9483 memory!, Out of memory during request for %s, panic: frexp, Possible
9484 attempt to put comments in qw() list, Possible attempt to separate words
9485 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
9486 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
9487 option, untie attempted while %d inner references still exist, Unrecognized
9488 character %s, Unsupported function fork, Use of "$$<digit>" to mean
9489 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
9490 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
9491 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
9492 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
9493 long, Process terminated by SIG%s
9503 =head2 perlartistic - the Perl Artistic License
9511 =item The "Artistic License"
9519 "Package", "Standard Version", "Copyright Holder", "You", "Reasonable
9520 copying fee", "Freely Available"
9524 a), b), c), d), a), b), c), d)
9530 =head2 perlgpl - the GNU General Public License, version 2
9542 =item GNU GENERAL PUBLIC LICENSE
9546 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
9554 =item Compiling Perl 5 on AIX
9558 =item Building Dynamic Extensions on AIX
9560 =item The IBM ANSI C Compiler
9562 =item The usenm option
9564 =item Using GNU's gcc for building perl
9566 =item Using Large Files with Perl
9572 =item AIX 4.2 and extensions using C++ with statics
9582 =head2 perlamiga - Perl under Amiga OS
9598 =item Prerequisites for Compiling Perl on AmigaOS
9600 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
9602 =item Starting Perl programs under AmigaOS
9604 =item Shortcomings of Perl under AmigaOS
9610 =item Accessing documentation
9614 =item Manpages for Perl on AmigaOS
9616 =item Perl HTML Documentation on AmigaOS
9618 =item Perl GNU Info Files on AmigaOS
9620 =item Perl LaTeX Documentation on AmigaOS
9624 =item BUILDING PERL ON AMIGAOS
9628 =item Build Prerequisites for Perl on AmigaOS
9630 =item Getting the Perl Source for AmigaOS
9632 =item Making Perl on AmigaOS
9634 =item Testing Perl on AmigaOS
9636 =item Installing the built Perl on AmigaOS
9640 =item PERL 5.8.0 BROKEN IN AMIGAOS
9648 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
9658 =head2 perlbeos, README.beos - Perl version 5.8+ on BeOS
9664 =item BUILD AND INSTALL
9678 =item KNOWN PROBLEMS
9684 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
9694 =item gzip on BS2000
9696 =item bison on BS2000
9698 =item Unpacking Perl Distribution on BS2000
9700 =item Compiling Perl on BS2000
9702 =item Testing Perl on BS2000
9704 =item Installing Perl on BS2000
9706 =item Using Perl in the Posix-Shell of BS2000
9708 =item Using Perl in "native" BS2000
9710 =item Floating point anomalies on BS2000
9712 =item Using PerlIO and different encodings on ASCII and EBCDIC partitions
9730 =head2 perlce - Perl for WinCE
9734 =item Building Perl for WinCE
9740 =item General explanations on cross-compiling WinCE
9744 Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's
9745 celib-sources, Rainer Keuchel's console-sources, go to C<./win32>
9746 subdirectory, edit file C<./win32/ce-helpers/compile.bat>, run
9747 compile.bat, run compile.bat dist
9751 =item Using Perl on WinCE
9761 PERL5LIB, PATH, TMP, UNIXROOTPATH, ROWS/COLS, HOME, CONSOLEFONTSIZE
9773 =item ACKNOWLEDGEMENTS
9775 =item History of WinCE port
9779 Rainer Keuchel <coyxc@rainer-keuchel.de>, Vadim Konovalov
9783 =head2 perlcygwin, README.cygwin - Perl for Cygwin
9789 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
9793 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
9795 =item Cygwin Configuration
9797 C<PATH>, I<nroff>, Permissions
9801 =item CONFIGURE PERL ON CYGWIN
9805 =item Stripping Perl Binaries on Cygwin
9807 =item Optional Libraries for Perl on Cygwin
9809 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
9810 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
9812 =item Configure-time Options for Perl on Cygwin
9814 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
9815 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
9818 =item Suspicious Warnings on Cygwin
9820 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
9824 =item MAKE ON CYGWIN
9828 =item Errors on Cygwin
9834 =item TEST ON CYGWIN
9838 =item File Permissions on Cygwin
9840 =item NDBM_File and ODBM_File do not work on FAT filesystems
9842 =item C<fork()> failures in io_* tests
9846 =item Specific features of the Cygwin port
9850 =item Script Portability on Cygwin
9852 Pathnames, Text/Binary, PerlIO, F<.exe>, cygwin vs. windows process ids,
9853 C<chown()>, Miscellaneous
9855 =item Prebuilt methods:
9857 C<Cwd::cwd>, C<Cygwin::pid_to_winpid>, C<Cygwin::winpid_to_pid>
9861 =item INSTALL PERL ON CYGWIN
9863 =item MANIFEST ON CYGWIN
9865 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
9866 Source, Compiled Module Source, Perl Modules/Scripts
9868 =item BUGS ON CYGWIN
9876 =head2 perldgux - Perl under DG/UX.
9888 =item BUILDING PERL ON DG/UX
9892 =item Non-threaded Perl on DG/UX
9894 =item Threaded Perl on DG/UX
9896 =item Testing Perl on DG/UX
9898 =item Installing the built perl on DG/UX
9908 =head2 perldos - Perl under DOS, W31, W95.
9918 =item Prerequisites for Compiling Perl on DOS
9922 =item Shortcomings of Perl under DOS
9924 =item Building Perl on DOS
9926 =item Testing Perl on DOS
9928 =item Installation of Perl on DOS
9932 =item BUILDING AND INSTALLING MODULES ON DOS
9936 =item Building Prerequisites for Perl on DOS
9938 =item Unpacking CPAN Modules on DOS
9940 =item Building Non-XS Modules on DOS
9942 =item Building XS Modules on DOS
9952 =head2 perlepoc, README.epoc - Perl for EPOC
9960 =item INSTALLING PERL ON EPOC
9962 =item STARTING PERL ON EPOC
9966 =item Editors on Epoc
9968 =item Features of Perl on Epoc
9970 =item Restrictions of Perl on Epoc
9972 =item Compiling Perl 5 on the EPOC cross compiling environment
9976 =item SUPPORT STATUS OF PERL ON EPOC
9984 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
9992 =item FreeBSD core dumps from readdir_r with ithreads
9994 =item $^X doesn't always contain a full path in FreeBSD
9996 =item Perl will no longer be part of "base FreeBSD"
10004 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
10013 =item Using perl as shipped with HP-UX
10015 =item Using perl from HP's porting centre
10017 =item Compiling Perl 5 on HP-UX
10021 =item Portability Between PA-RISC Versions
10029 =item Itanium Processor Family (IPF) and HP-UX
10031 =item Itanium, Itanium 2 & Madison 6
10033 =item Building Dynamic Extensions on HP-UX
10035 =item The HP ANSI C Compiler
10037 =item The GNU C Compiler
10039 =item Using Large Files with Perl on HP-UX
10041 =item Threaded Perl on HP-UX
10043 =item 64-bit Perl on HP-UX
10045 =item Oracle on HP-UX
10047 =item GDBM and Threads on HP-UX
10049 =item NFS filesystems and utime(2) on HP-UX
10051 =item perl -P and // and HP-UX
10053 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
10057 =item nss_delete core dump from op/pwent or op/grent
10065 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
10073 =item Known Problems with Perl on Hurd
10081 =head2 perlirix, README.irix - Perl version 5 on Irix systems
10089 =item Building 32-bit Perl in Irix
10091 =item Building 64-bit Perl in Irix
10093 =item About Compiler Versions of Irix
10095 =item Linker Problems in Irix
10097 =item Malloc in Irix
10099 =item Building with threads in Irix
10109 =head2 perllinux, README.linux - Perl version 5 on Linux systems
10117 =item Experimental Support for Sun Studio Compilers for Linux OS
10125 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
10134 =item Perl version 5.8.x and greater not supported
10136 =item Compiling Perl 5.6.x on MachTen
10138 =item Failures during C<make test> on MachTen
10140 op/lexassign.t, pragma/warnings.t
10142 =item Building external modules on MachTen
10152 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
10166 =head2 perlmacosx, README.macosx - Perl under Mac OS X
10176 =item Installation Prefix
10180 =item Universal Binary support
10182 =item 64-bit PPC support
10184 =item libperl and Prebinding
10186 =item Updating Apple's Perl
10188 =item Known problems
10198 =item Starting From Scratch
10206 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
10212 =item Known problems with Perl on MiNT
10218 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
10226 =item Binary distribution from HP
10228 =item What's New in Perl for MPE/iX
10230 =item Welcome to Perl/iX
10232 =item System Requirements for Perl/iX
10234 =item How to Obtain Perl/iX
10236 =item Perl/iX Distribution Contents Highlights
10238 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
10239 public_html/feedback.cgi, src/perl-5.6.0-mpe
10241 =item How to Compile Perl/iX
10245 =item Getting Started with Perl/iX
10247 =item MPE/iX Implementation Considerations
10249 =item Known Perl/iX Bugs Under Investigation
10251 =item Perl/iX To-Do List
10253 =item Perl/iX Change History
10259 =head2 perlnetware - Perl for NetWare
10273 SetNWBld.bat, Buildtype.bat
10285 =item BUILD NEW EXTENSIONS
10287 =item ACKNOWLEDGEMENTS
10295 =head2 perlopenbsd, README.openbsd - Perl version 5 on OpenBSD systems
10303 =item OpenBSD core dumps from getprotobyname_r and getservbyname_r with
10312 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
10330 =item Prerequisites
10332 EMX, RSX, HPFS, pdksh
10334 =item Starting Perl programs under OS/2 (and DOS and...)
10336 =item Starting OS/2 (and DOS) programs under Perl
10340 =item Frequently asked questions
10344 =item "It does not work"
10346 =item I cannot run external programs
10348 =item I cannot embed perl into my program, or use F<perl.dll> from my
10351 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
10352 L<ExtUtils::Embed>?
10354 =item C<``> and pipe-C<open> do not work under DOS.
10356 =item Cannot start C<find.exe "pattern" file>
10364 =item Automatic binary installation
10366 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
10368 =item Manual binary installation
10370 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
10371 (statically linked), Executables for Perl utilities, Main Perl library,
10372 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
10373 and utilities, Manpages for Perl modules, Source for Perl documentation,
10374 Perl manual in F<.INF> format, Pdksh
10380 =item Accessing documentation
10384 =item OS/2 F<.INF> file
10392 =item GNU C<info> files
10396 =item C<LaTeX> docs
10404 =item The short story
10406 =item Prerequisites
10408 =item Getting perl source
10410 =item Application of the patches
10418 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
10421 =item Installing the built perl
10423 =item C<a.out>-style build
10427 =item Building a binary distribution
10429 =item Building custom F<.EXE> files
10433 =item Making executables with a custom collection of statically loaded
10436 =item Making executables with a custom search-paths
10444 =item Some C</> became C<\> in pdksh.
10446 =item C<'errno'> - unresolved external
10448 =item Problems with tr or sed
10450 =item Some problem (forget which ;-)
10452 =item Library ... not found
10454 =item Segfault in make
10456 =item op/sprintf test failure
10460 =item Specific (mis)features of OS/2 port
10464 =item C<setpriority>, C<getpriority>
10468 =item C<extproc> on the first line
10470 =item Additional modules:
10472 =item Prebuilt methods:
10474 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>, C<Cwd::current_drive()>,
10475 C<Cwd::sys_chdir(name)>, C<Cwd::change_drive(name)>,
10476 C<Cwd::sys_is_absolute(name)>, C<Cwd::sys_is_rooted(name)>,
10477 C<Cwd::sys_is_relative(name)>, C<Cwd::sys_cwd(name)>,
10478 C<Cwd::sys_abspath(name, dir)>, C<Cwd::extLibpath([type])>,
10479 C<Cwd::extLibpath_set( path [, type ] )>,
10480 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
10481 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
10482 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
10483 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
10484 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
10485 C<OS2::DLLname([how [, \&xsub]])>
10487 =item Prebuilt variables:
10489 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
10494 =item Modifications
10496 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
10499 =item Identifying DLLs
10501 =item Centralized management of resources
10503 C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
10504 C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
10505 C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
10506 C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
10518 =item F<perl__.exe>
10520 =item F<perl___.exe>
10522 =item Why strange names?
10524 =item Why dynamic linking?
10526 =item Why chimera build?
10534 =item C<PERLLIB_PREFIX>
10536 =item C<PERL_BADLANG>
10538 =item C<PERL_BADFREE>
10540 =item C<PERL_SH_DIR>
10542 =item C<USE_PERL_FLOCK>
10544 =item C<TMP> or C<TEMP>
10552 =item Text-mode filehandles
10556 =item DLL name mangling: pre 5.6.2
10558 =item DLL name mangling: 5.6.2 and beyond
10560 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
10563 =item DLL forwarder generation
10567 =item Calls to external programs
10569 =item Memory allocation
10573 C<COND_WAIT>, F<os2.c>
10589 =head2 perlos390, README.os390 - building and installing Perl for OS/390
10602 =item Unpacking Perl distribution on OS/390
10604 =item Setup and utilities for Perl on OS/390
10606 =item Configure Perl on OS/390
10608 =item Build, Test, Install Perl on OS/390
10610 =item Build Anomalies with Perl on OS/390
10612 =item Testing Anomalies with Perl on OS/390
10614 =item Installation Anomalies with Perl on OS/390
10616 =item Usage Hints for Perl on OS/390
10618 =item Floating Point Anomalies with Perl on OS/390
10620 =item Modules and Extensions for Perl on OS/390
10630 =item Mailing list for Perl on OS/390
10638 =head2 perlos400, README.os400 - Perl version 5 on OS/400
10646 =item Compiling Perl for OS/400 PASE
10648 =item Installing Perl in OS/400 PASE
10650 =item Using Perl in OS/400 PASE
10652 =item Known Problems
10662 =head2 perlplan9 - Plan 9-specific documentation for Perl
10670 =item Invoking Perl
10672 =item What's in Plan 9 Perl
10674 =item What's not in Plan 9 Perl
10676 =item Perl5 Functions not currently supported in Plan 9 Perl
10678 =item Signals in Plan 9 Perl
10682 =item COMPILING AND INSTALLING PERL ON PLAN 9
10686 =item Installing Perl Documentation on Plan 9
10692 =item Revision date
10698 =head2 perlqnx, README.qnx - Perl version 5 on QNX
10706 =item Required Software for Compiling Perl on QNX4
10708 /bin/sh, ar, nm, cpp, make
10710 =item Outstanding Issues with Perl on QNX4
10712 =item QNX auxiliary files
10716 =item Outstanding issues with perl under QNX6
10724 =head2 perlriscos, README.riscos - Perl version 5 for RISC OS
10736 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
10744 =item Solaris Version Numbers.
10750 Solaris FAQ, Precompiled Binaries, Solaris Documentation
10756 =item File Extraction Problems on Solaris.
10758 =item Compiler and Related Tools on Solaris.
10760 =item Environment for Compiling perl on Solaris
10764 =item RUN CONFIGURE.
10768 =item 64-bit perl on Solaris.
10770 =item Threads in perl on Solaris.
10772 =item Malloc Issues with perl on Solaris.
10776 =item MAKE PROBLEMS.
10778 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
10779 relocation error:, dlopen: stub interception failed, #error "No
10780 DATAMODEL_NATIVE specified", sh: ar: not found
10786 =item op/stat.t test 4 in Solaris
10788 =item nss_delete core dump from op/pwent or op/grent
10792 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
10794 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
10798 =item Limits on Numbers of Open Files on Solaris.
10802 =item SOLARIS-SPECIFIC MODULES.
10804 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
10808 =item Proc::ProcessTable on Solaris
10810 =item BSD::Resource on Solaris
10812 =item Net::SSLeay on Solaris
10822 =head2 perlsymbian, README.symbian - Perl version 5 on Symbian OS
10830 =item Compiling Perl on Symbian
10832 =item Compilation problems
10838 =item Using Perl in Symbian
10858 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
10859 Digital UNIX formerly known as DEC OSF/1) systems
10867 =item Compiling Perl 5 on Tru64
10869 =item Using Large Files with Perl on Tru64
10871 =item Threaded Perl on Tru64
10873 =item Long Doubles on Tru64
10875 =item DB_File tests failing on Tru64
10877 =item 64-bit Perl on Tru64
10879 =item Warnings about floating-point overflow when compiling Perl on Tru64
10883 =item Testing Perl on Tru64
10885 =item ext/ODBM_File/odbm Test Failing With Static Builds
10887 =item Perl Fails Because Of Unresolved Symbol sockatmark
10893 =head2 perluts - Perl under UTS
10901 =item BUILDING PERL ON UTS
10903 =item Installing the built perl on UTS
10909 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
10919 =item Unpacking Perl Distribution on VM/ESA
10921 =item Setup Perl and utilities on VM/ESA
10923 =item Configure Perl on VM/ESA
10925 =item Testing Anomalies of Perl on VM/ESA
10927 =item Usage Hints for Perl on VM/ESA
10937 =item Mailing list for Perl on VM/ESA
10943 =head2 perlvms - VMS-specific documentation for Perl
10951 =item Organization of Perl Images
10957 =item Perl Extensions
10959 =item Installing static extensions
10961 =item Installing dynamic extensions
10965 =item File specifications
10971 =item Wildcard expansion
10977 =item PERL5LIB and PERLLIB
10979 =item PERL_VMS_EXCEPTION_DEBUG
10985 =item I/O redirection and backgrounding
10987 =item Command line switches
10993 =item Perl functions
10995 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, die,
10996 dump, exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//,
10997 select (system call), stat EXPR, system LIST, time, times, unlink LIST,
10998 utime LIST, waitpid PID,FLAGS
11000 =item Perl variables
11002 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
11004 =item Standard modules with VMS-specific differences
11012 =item Revision date
11018 =head2 perlvos, README.vos - Perl for Stratus VOS
11024 =item BUILDING PERL FOR VOS
11026 =item INSTALLING PERL IN VOS
11028 =item USING PERL IN VOS
11032 =item Restrictions of Perl on VOS
11034 =item Handling of underflow and overflow
11040 =item SUPPORT STATUS
11048 =head2 perlwin32 - Perl under Windows
11058 =item Setting Up Perl on Win32
11060 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Visual
11061 C++ 2005 Express Edition, Microsoft Visual C++ Toolkit 2003, Microsoft
11062 Platform SDK 64-bit Compiler, MinGW release 3 with gcc, MinGW release 1
11067 =item Testing Perl on Win32
11069 =item Installation of Perl on Win32
11071 =item Usage Hints for Perl on Win32
11073 Environment Variables, File Globbing, Using perl from the command line,
11074 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
11075 Extensions, Notes on 64-bit Windows
11077 =item Running Perl Scripts
11079 =item Miscellaneous Things
11083 =item BUGS AND CAVEATS
11085 =item ACKNOWLEDGEMENTS
11089 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
11090 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
11091 E<lt>nick@ing-simmons.netE<gt>, Jan Dubois E<lt>jand@activestate.comE<gt>,
11092 Steve Hay E<lt>steve.hay@uk.radan.comE<gt>
11100 =head1 PRAGMA DOCUMENTATION
11102 =head2 attrs - set/get attributes of a subroutine (deprecated)
11114 =head2 re - Perl pragma to alter regular expression behaviour
11132 Compile related options, COMPILE, PARSE, OPTIMISE, TRIEC, DUMP, Execute
11133 related options, EXECUTE, MATCH, TRIEE, INTUIT, Extra debugging options,
11134 EXTRA, BUFFERS, TRIEM, STATE, STACK, OPTIMISEM, OFFSETS, OFFSETSDBG, Other
11135 useful flags, ALL, All, MORE, More
11137 =item Exportable Functions
11139 is_regexp($ref), regexp_pattern($ref), regmust($ref), regname($name,$all),
11140 regnames($all), regnames_iterinit(), regnames_iternext($all),
11149 =head2 threadshared::shared, threads::shared - Perl extension for sharing
11150 data structures between threads
11164 share VARIABLE, is_shared VARIABLE, lock VARIABLE, cond_wait VARIABLE,
11165 cond_wait CONDVAR, LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT,
11166 cond_timedwait CONDVAR, ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE,
11167 cond_broadcast VARIABLE
11173 =item BUGS AND LIMITATIONS
11181 =head2 threads - Perl interpreter-based threads
11191 $thr = threads->create(FUNCTION, ARGS), $thr->join(), $thr->detach(),
11192 threads->detach(), threads->self(), $thr->tid(), threads->tid(), "$thr",
11193 threads->object($tid), threads->yield(), threads->list(),
11194 threads->list(threads::all), threads->list(threads::running),
11195 threads->list(threads::joinable), $thr1->equal($thr2), async BLOCK;,
11196 $thr->error(), $thr->_handle(), threads->_handle()
11198 =item EXITING A THREAD
11200 threads->exit(), threads->exit(status), die(), exit(status), use threads
11201 'exit' => 'threads_only', threads->create({'exit' => 'thread_only'}, ...),
11202 $thr->set_thread_exit_only(boolean), threads->set_thread_exit_only(boolean)
11206 $thr->is_running(), $thr->is_joinable(), $thr->is_detached(),
11207 threads->is_detached()
11209 =item THREAD CONTEXT
11213 =item Explicit context
11215 =item Implicit context
11217 =item $thr->wantarray()
11219 =item threads->wantarray()
11223 =item THREAD STACK SIZE
11225 threads->get_stack_size();, $size = $thr->get_stack_size();, $old_size =
11226 threads->set_stack_size($new_size);, use threads ('stack_size' => VALUE);,
11227 $ENV{'PERL5_ITHREADS_STACK_SIZE'}, threads->create({'stack_size' => VALUE},
11228 FUNCTION, ARGS), $thr2 = $thr1->create(FUNCTION, ARGS)
11230 =item THREAD SIGNALLING
11232 $thr->kill('SIG...');
11236 Perl exited with active threads:, Thread creation failed: pthread_create
11237 returned #, Thread # terminated abnormally: .., Using minimum thread stack
11238 size of #, Thread creation failed: pthread_attr_setstacksize(I<SIZE>)
11243 This Perl not built to support threads, Cannot change stack size of an
11244 existing thread, Cannot signal threads without safe signals, Unrecognized
11247 =item BUGS AND LIMITATIONS
11249 Using non-threadsafe modules, Parent-child threads, Creating threads inside
11250 special blocks, Unsafe signals, Perl has been built with
11251 C<PERL_OLD_SIGNALS> (see C<perl -V>), The environment variable
11252 C<PERL_SIGNALS> is set to C<unsafe> (see L<perlrun/"PERL_SIGNALS">), The
11253 module L<Perl::Unsafe::Signals> is used, Returning closures from threads,
11254 Returning objects from threads, Perl Bugs and the CPAN Version of
11263 =item ACKNOWLEDGEMENTS
11267 =head2 assertions - select assertions in blocks of code
11277 =item Selecting assertions
11279 =item Handling assertions your own way
11281 enabled($on), enabled(), seen($on), seen()
11285 =item COMPATIBILITY
11291 =item COPYRIGHT AND LICENSE
11295 =head2 assertions::activate - activate assertions
11307 =item COPYRIGHT AND LICENSE
11311 =head2 assertions::compat - assertions for pre-5.9 versions of perl
11321 =item The C<assertion> attribute handler
11323 =item Assertion execution status as a constant
11331 =item COPYRIGHT AND LICENSE
11335 =head2 attributes - get/set subroutine or variable attributes
11345 =item Built-in Attributes
11347 locked, method, lvalue
11349 =item Available Subroutines
11353 =item Package-specific Attribute Handling
11355 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
11357 =item Syntax of Attribute Lists
11365 =item Default exports
11367 =item Available exports
11369 =item Export tags defined
11379 =head2 autouse - postpone load of modules until a function is used
11395 =head2 base - Establish IS-A relationship with base classes at compile time
11405 Base class package "%s" is empty
11415 =head2 bigint - Transparent BigInteger support for Perl
11427 a or accuracy, p or precision, t or trace, l or lib, v or version
11431 =item Internal Format
11437 inf(), NaN(), upgrade()
11457 =head2 bignum - Transparent BigNumber support for Perl
11469 a or accuracy, p or precision, t or trace, l or lib, v or version
11475 inf(), NaN(), upgrade()
11479 =item INTERNAL FORMAT
11497 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
11515 inf(), NaN(), upgrade()
11523 a or accuracy, p or precision, t or trace, l or lib, v or version
11529 perl -Mbigrat -le 'print sqrt(33)'
11530 perl -Mbigrat -le 'print 2*255'
11531 perl -Mbigrat -le 'print 4.5+2*255'
11532 perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'
11533 perl -Mbigrat -le 'print 12->is_odd()';
11534 perl -Mbignum=l,GMP -le 'print 7 ** 7777'
11544 =head2 blib - Use MakeMaker's uninstalled version of a package
11558 =head2 bytes - Perl pragma to force byte semantics rather than character
11573 =head2 charnames - define character names for C<\N{named}> string literal
11582 =item CUSTOM TRANSLATORS
11584 =item CUSTOM ALIASES
11588 =item Anonymous hashes
11592 =item Alias shortcut
11596 =item charnames::viacode(code)
11598 =item charnames::vianame(name)
11602 =item ILLEGAL CHARACTERS
11608 =head2 constant - Perl pragma to declare constants
11620 =item List constants
11622 =item Defining multiple constants at once
11624 =item Magic constants
11628 =item TECHNICAL NOTES
11638 =head2 diagnostics, splain - produce verbose warning diagnostics
11648 =item The C<diagnostics> Pragma
11650 =item The I<splain> Program
11664 =head2 encoding - allows you to write your script in non-ascii or non-utf8
11674 =item Literal Conversions
11676 =item PerlIO layers for C<STD(IN|OUT)>
11678 =item Implicit upgrading for byte strings
11686 =item FEATURES THAT REQUIRE 5.8.1
11688 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
11692 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
11693 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
11695 =item The Filter Option
11699 =item Filter-related changes at Encode version 1.87
11709 =item DO NOT MIX MULTIPLE ENCODINGS
11711 =item tr/// with ranges
11713 Legend of characters above
11717 =item EXAMPLE - Greekperl
11719 =item KNOWN PROBLEMS
11721 literals in regex that are longer than 127 bytes, EBCDIC, format
11725 =item The Logic of :locale
11735 =head2 encoding::warnings - Warn on implicit encoding conversions
11747 =item Overview of the problem
11749 =item Detecting the problem
11751 =item Solving the problem
11753 Upgrade both sides to unicode-strings, Downgrade both sides to
11754 byte-strings, Specify the encoding for implicit byte-string upgrading,
11755 PerlIO layers for B<STDIN> and B<STDOUT>, Literal conversions, Implicit
11756 upgrading for byte-strings
11774 =head2 feature - Perl pragma to enable new syntactic features
11784 =item Lexical effect
11786 =item C<no feature>
11788 =item The 'switch' feature
11790 =item The 'say' feature
11792 =item the 'err' feature
11794 =item the 'state' feature
11798 =item FEATURE BUNDLES
11800 =item IMPLICIT LOADING
11804 =head2 fields - compile-time class fields
11818 =head2 filetest - Perl pragma to control the filetest permission operators
11828 =item subpragma access
11834 =head2 if - C<use> a Perl module if a condition holds
11848 =head2 integer - Perl pragma to use integer arithmetic instead of floating
11859 =head2 less - perl pragma to request less of something
11867 =item FOR MODULE AUTHORS
11871 =item C<< BOOLEAN = less->of( FEATURE ) >>
11873 =item C<< FEATURES = less->of() >>
11879 This probably does nothing, This works only on 5.10+
11883 =head2 lib - manipulate @INC at compile time
11893 =item Adding directories to @INC
11895 =item Deleting directories from @INC
11897 =item Restoring original @INC
11911 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
11922 =head2 open - perl pragma to set default PerlIO layers for input and output
11930 =item NONPERLIO FUNCTIONALITY
11932 =item IMPLEMENTATION DETAILS
11938 =head2 ops - Perl pragma to restrict unsafe operations when compiling
11950 =head2 overload - Package for overloading Perl operations
11960 =item Declaration of overloaded functions
11962 =item Calling Conventions for Binary Operations
11964 FALSE, TRUE, C<undef>
11966 =item Calling Conventions for Unary Operations
11968 =item Calling Conventions for Mutators
11970 C<++> and C<-->, C<x=> and other assignment versions
11972 =item Overloadable Operations
11974 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
11975 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
11976 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
11978 =item Inheritance and overloading
11980 Strings as values of C<use overload> directive, Overloading of an operation
11981 is inherited by derived classes
11985 =item SPECIAL SYMBOLS FOR C<use overload>
11993 C<undef>, TRUE, defined, but FALSE
11997 =item Copy Constructor
12003 =item MAGIC AUTOGENERATION
12005 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
12006 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
12007 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
12010 =item Minimal set of overloaded operations
12012 =item Losing overloading
12014 =item Run-time Overloading
12016 =item Public functions
12018 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
12020 =item Overloading constants
12022 integer, float, binary, q, qr
12024 =item IMPLEMENTATION
12026 =item Metaphor clash
12032 =item Two-face scalars
12034 =item Two-face references
12036 =item Symbolic calculator
12038 =item I<Really> symbolic calculator
12046 Odd number of arguments for overload::constant, `%s' is not an overloadable
12047 type, `%s' is not a code reference
12053 =head2 sigtrap - Perl pragma to enable simple signal handling
12065 =item SIGNAL HANDLERS
12067 B<stack-trace>, B<die>, B<handler> I<your-handler>
12071 B<normal-signals>, B<error-signals>, B<old-interface-signals>
12075 B<untrapped>, B<any>, I<signal>, I<number>
12083 =head2 sort - perl pragma to control sort() behaviour
12095 =head2 strict - Perl pragma to restrict unsafe constructs
12103 C<strict refs>, C<strict vars>, C<strict subs>
12109 =head2 subs - Perl pragma to predeclare sub names
12119 =head2 threadshared, threads::shared - Perl extension for sharing data
12120 structures between threads
12134 share VARIABLE, is_shared VARIABLE, lock VARIABLE, cond_wait VARIABLE,
12135 cond_wait CONDVAR, LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT,
12136 cond_timedwait CONDVAR, ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE,
12137 cond_broadcast VARIABLE
12143 =item BUGS AND LIMITATIONS
12151 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
12162 =item Utility functions
12164 $num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[,
12165 FAIL_OK]), utf8::encode($string), $success = utf8::decode($string), $flag =
12166 utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
12176 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
12186 =head2 version - Perl extension for Version Objects
12196 =item BEST PRACTICES
12198 Be consistent, Be careful
12200 =item Using modules that use version.pm
12202 Numeric versions always work, Extended version work sometimes
12204 =item What IS a version
12206 Numeric Versions, Extended Versions
12208 =item Numeric Versions
12210 =item Extended Versions
12212 =item Numeric Alpha Versions
12214 =item Object Methods
12216 New Operator, qv(), Normal Form, Numification, Stringification, Comparison
12217 operators, Logical Operators
12221 =item What about v-strings?
12223 =item Types of Versions Objects
12225 Ordinary versions, Alpha Versions
12227 =item Replacement UNIVERSAL::VERSION
12241 =head2 vmsish - Perl pragma to control VMS-specific language features
12249 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
12253 =head2 warnings - Perl pragma to control optional warnings
12261 use warnings::register, warnings::enabled(), warnings::enabled($category),
12262 warnings::enabled($object), warnings::warn($message),
12263 warnings::warn($category, $message), warnings::warn($object, $message),
12264 warnings::warnif($message), warnings::warnif($category, $message),
12265 warnings::warnif($object, $message)
12269 =head2 warnings::register - warnings import function
12279 =head1 MODULE DOCUMENTATION
12281 =head2 AnyDBM_File - provide framework for multiple DBMs
12291 =item DBM Comparisons
12301 =head2 Archive::Extract - A generic archive extracting mechanism
12317 =item $ae = Archive::Extract->new(archive => '/path/to/archive',[type =>
12320 tar, tgz, gz, zip, bz2, tbz
12328 =item $ae->extract( [to => '/output/path'] )
12330 $ae->extract_path, $ae->files
12340 =item $ae->error([BOOL])
12342 =item $ae->extract_path
12372 =item $ae->bin_gzip
12374 =item $ae->bin_unzip
12386 =item File Extensions
12388 =item Bzip2 Support
12392 =item GLOBAL VARIABLES
12396 =item $Archive::Extract::DEBUG
12398 =item $Archive::Extract::WARN
12400 =item $Archive::Extract::PREFER_BIN
12416 =head2 Archive::Tar - module for manipulations of tar archives
12424 =item Object Methods
12428 =item Archive::Tar->new( [$file, $compressed] )
12436 =item $tar->read ( $filename|$handle, $compressed, {opt => 'val'} )
12444 =item $tar->contains_file( $filename )
12450 =item $tar->extract( [@filenames] )
12456 =item $tar->extract_file( $file, [$extract_path] )
12462 =item $tar->list_files( [\@properties] )
12468 =item $tar->get_files( [@filenames] )
12474 =item $tar->get_content( $file )
12480 =item $tar->replace_content( $file, $content )
12486 =item $tar->rename( $file, $new_name )
12492 =item $tar->remove (@filenamelist)
12504 =item $tar->write ( [$file, $compressed, $prefix] )
12510 =item $tar->add_files( @filenamelist )
12516 =item $tar->add_data ( $filename, $data, [$opthashref] )
12518 FILE, HARDLINK, SYMLINK, CHARDEV, BLOCKDEV, DIR, FIFO, SOCKET
12524 =item $tar->error( [$BOOL] )
12530 =item $tar->setcwd( $cwd );
12536 =item $bool = $tar->has_io_string
12542 =item $bool = $tar->has_perlio
12548 =item Class Methods
12552 =item Archive::Tar->create_archive($file, $compression, @filelist)
12560 =item Archive::Tar->list_archive ($file, $compressed, [\@properties])
12566 =item Archive::Tar->extract_archive ($file, $gzip)
12572 =item Archive::Tar->can_handle_compressed_files
12578 =item GLOBAL VARIABLES
12582 =item $Archive::Tar::FOLLOW_SYMLINK
12584 =item $Archive::Tar::CHOWN
12586 =item $Archive::Tar::CHMOD
12588 =item $Archive::Tar::DO_NOT_USE_PREFIX
12590 =item $Archive::Tar::DEBUG
12592 =item $Archive::Tar::WARN
12594 =item $Archive::Tar::error
12596 =item $Archive::Tar::HAS_PERLIO
12598 =item $Archive::Tar::HAS_IO_STRING
12604 What's the minimum perl version required to run Archive::Tar?, Isn't
12605 Archive::Tar slow?, Isn't Archive::Tar heavier on memory than /bin/tar?,
12606 Can't you lazy-load data instead?, How much memory will an X kb tar file
12607 need?, What do you do with unsupported filetypes in an archive?, I'm using
12608 WinZip, or some other non-POSIX client, and files are not being extracted
12609 properly!, How do I extract only files that have property X from an
12610 archive?, How do I access .tar.Z files?
12614 Check if passed in handles are open for read/write, Allow archives to be
12615 passed in as string, Facilitate processing an opened filehandle of a
12620 The GNU tar specification, The PAX format specication, A comparison of GNU
12621 and POSIX tar standards;
12622 C<http://www.delorie.com/gnu/docs/tar/tar_114.html>, GNU tar intends to
12623 switch to POSIX compatibility, A Comparison between various tar
12628 =item ACKNOWLEDGEMENTS
12634 =head2 Archive::Tar::File - a subclass for in-memory extracted file from
12647 name, mode, uid, gid, size, mtime, chksum, type, linkname, magic, version,
12648 uname, gname, devmajor, devminor, prefix, raw
12656 =item new( file => $path )
12658 =item new( data => $path, $data, $opt )
12660 =item new( chunk => $chunk )
12692 =item get_content_by_ref
12698 =item replace_content( $content )
12704 =item rename( $new_name )
12710 =item Convenience methods
12712 is_file, is_dir, is_hardlink, is_symlink, is_chardev, is_blockdev, is_fifo,
12713 is_socket, is_longlink, is_label, is_unknown
12717 =head2 Attribute::Handlers - Simpler definition of attribute handlers
12727 [0], [1], [2], [3], [4], [5], [6], [7]
12731 =item Typed lexicals
12733 =item Type-specific attribute handlers
12735 =item Non-interpretive attribute handlers
12737 =item Phase-specific attribute handlers
12739 =item Attributes as C<tie> interfaces
12747 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
12748 attributes>, C<Declaration of %s attribute in package %s may clash with
12749 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
12750 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
12751 be able to apply END handler>
12761 =head2 AutoLoader - load subroutines only on demand
12771 =item Subroutine Stubs
12773 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
12775 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
12777 =item Package Lexicals
12779 =item Not Using AutoLoader
12781 =item B<AutoLoader> vs. B<SelfLoader>
12791 =head2 AutoSplit - split a package for autoloading
12799 $keep, $check, $modtime
12803 =item Multiple packages
12811 =head2 B - The Perl Compiler
12821 =item Utility Functions
12825 =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV>
12828 sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av,
12829 check_av, unitcheck_av, begin_av, end_av, comppadlist, regex_padav, main_cv
12831 =item Functions for Examining the Symbol Table
12833 walksymtable(SYMREF, METHOD, RECURSE, PREFIX)
12835 =item Functions Returning C<B::OP> objects or for walking op trees
12837 main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG)
12839 =item Miscellaneous Utility Functions
12841 ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR),
12842 perlstring(STR), class(OBJ), threadsv_names
12846 =item OVERVIEW OF CLASSES
12850 =item SV-RELATED CLASSES
12852 =item B::SV Methods
12854 REFCNT, FLAGS, object_2svref
12856 =item B::IV Methods
12858 IV, IVX, UVX, int_value, needs64bits, packiv
12860 =item B::NV Methods
12864 =item B::RV Methods
12868 =item B::PV Methods
12872 =item B::PVMG Methods
12876 =item B::MAGIC Methods
12878 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
12880 =item B::PVLV Methods
12882 TARGOFF, TARGLEN, TYPE, TARG
12884 =item B::BM Methods
12886 USEFUL, PREVIOUS, RARE, TABLE
12888 =item B::GV Methods
12890 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
12891 LINE, FILE, FILEGV, GvREFCNT, FLAGS
12893 =item B::IO Methods
12895 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
12896 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
12898 =item B::AV Methods
12900 FILL, MAX, ARRAY, ARRAYelt, OFF, AvFLAGS
12902 =item B::CV Methods
12904 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB,
12905 XSUBANY, CvFLAGS, const_sv
12907 =item B::HV Methods
12909 FILL, MAX, KEYS, RITER, NAME, ARRAY, PMROOT
12911 =item OP-RELATED CLASSES
12913 =item B::OP Methods
12915 next, sibling, name, ppaddr, desc, targ, type, opt, static, flags, private,
12918 =item B::UNOP METHOD
12922 =item B::BINOP METHOD
12926 =item B::LOGOP METHOD
12930 =item B::LISTOP METHOD
12934 =item B::PMOP Methods
12936 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, extflags, precomp,
12939 =item B::SVOP METHOD
12943 =item B::PADOP METHOD
12947 =item B::PVOP METHOD
12951 =item B::LOOP Methods
12953 redoop, nextop, lastop
12955 =item B::COP Methods
12957 label, stash, stashpv, file, cop_seq, arybase, line, warnings, io, hints
12965 =head2 B::Asmdata - Autogenerated data about Perl ops
12973 %insn_data, @insn_name, @optype, @specialsv_name
12979 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
12993 =item Options for Opcode Ordering
12995 B<-basic>, B<-exec>, B<-tree>
12997 =item Options for Line-Style
12999 B<-concise>, B<-terse>, B<-linenoise>, B<-debug>, B<-env>
13001 =item Options for tree-specific formatting
13003 B<-compact>, B<-loose>, B<-vt>, B<-ascii>
13005 =item Options controlling sequence numbering
13007 B<-base>I<n>, B<-bigendian>, B<-littleendian>
13009 =item Other options
13011 B<-main>, B<-nomain>, B<-nobanner>, B<-banner>, B<-banneris> => subref
13013 =item Option Stickiness
13017 =item ABBREVIATIONS
13021 =item OP class abbreviations
13023 =item OP flags abbreviations
13027 =item FORMATTING SPECIFICATIONS
13031 =item Special Patterns
13033 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
13034 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
13039 B<#>I<var>, B<#>I<var>I<N>, B<#>I<Var>, B<#addr>, B<#arg>, B<#class>,
13040 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
13041 B<#flags>, B<#flagval>, B<#hints>, B<#hintsval>, B<#hyphseq>, B<#label>,
13042 B<#lastaddr>, B<#name>, B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>,
13043 B<#private>, B<#privval>, B<#seq>, B<#seqnum>, B<#opt>, B<#static>,
13044 B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>, B<#targ>, B<#targarg>,
13045 B<#targarglife>, B<#typenum>
13049 =item One-Liner Command tips
13051 perl -MO=Concise,bar foo.pl, perl -MDigest::MD5=md5 -MO=Concise,md5 -e1,
13052 perl -MPOSIX -MO=Concise,_POSIX_ARG_MAX -e1, perl -MPOSIX -MO=Concise,a -e
13053 'print _POSIX_SAVED_IDS', perl -MPOSIX -MO=Concise,a -e 'sub
13054 a{_POSIX_SAVED_IDS}'
13056 =item Using B::Concise outside of the O framework
13060 =item Example: Altering Concise Renderings
13064 =item set_style_standard($name)
13068 =item add_callback()
13070 =item Running B::Concise::compile()
13072 =item B::Concise::reset_sequence()
13082 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
13094 =head2 B::Deparse - Perl compiler backend to produce perl code
13104 B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>,
13105 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
13107 =item USING B::Deparse AS A MODULE
13117 =item ambient_pragmas
13119 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
13131 =head2 B::Lint - Perl lint
13139 =item OPTIONS AND LINT CHECKS
13141 B<magic-diamond>, B<context>, B<implicit-read> and B<implicit-write>,
13142 B<bare-subs>, B<dollar-underscore>, B<private-names>, B<undefined-subs>,
13143 B<regexp-variables>, B<all>, B<none>
13145 =item NON LINT-CHECK OPTIONS
13149 =item EXTENDING LINT
13153 while(<FH>) stomps $_, strict oo, unchecked system calls, more tests,
13154 validate against older perls
13162 =head2 B::O, O - Generic interface to Perl Compiler backends
13172 =item IMPLEMENTATION
13180 =head2 B::Showlex - Show lexical variables used in functions or files
13204 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
13216 =head2 B::Xref - Generates cross reference reports for Perl programs
13226 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
13234 =head2 Benchmark - benchmark running times of Perl code
13248 =item Standard Exports
13250 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
13251 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
13252 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
13254 =item Optional Exports
13256 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [
13257 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
13258 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
13260 =item :hireswallclock
13276 =item MODIFICATION HISTORY
13280 =head2 CGI - Simple Common Gateway Interface Class
13292 =item PROGRAMMING STYLE
13294 =item CALLING CGI.PM ROUTINES
13296 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
13298 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
13300 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
13302 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
13304 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
13306 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
13308 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
13310 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
13312 =item DELETING A PARAMETER COMPLETELY:
13314 =item DELETING ALL PARAMETERS:
13316 =item HANDLING NON-URLENCODED ARGUMENTS
13318 =item DIRECT ACCESS TO THE PARAMETER LIST:
13320 =item FETCHING THE PARAMETER LIST AS A HASH:
13322 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
13324 =item RETRIEVING CGI ERRORS
13326 =item USING THE FUNCTION-ORIENTED INTERFACE
13328 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
13329 B<:standard>, B<:all>
13333 -any, -compile, -nosticky, -tabindex, -no_undef_params, -no_xhtml, -nph,
13334 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
13337 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
13339 1. start_table() (generates a <table> tag), 2. end_table() (generates a
13340 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
13345 =item GENERATING DYNAMIC DOCUMENTS
13349 =item CREATING A STANDARD HTTP HEADER:
13351 =item GENERATING A REDIRECTION HEADER
13353 =item CREATING THE HTML DOCUMENT HEADER
13355 B<Parameters:>, 4, 5, 6..
13357 =item ENDING THE HTML DOCUMENT:
13359 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
13361 =item OBTAINING THE SCRIPT'S URL
13363 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
13364 (B<-query_string>), B<-base>, B<-rewrite>
13366 =item MIXING POST AND URL PARAMETERS
13370 =item CREATING STANDARD HTML ELEMENTS:
13374 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
13376 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
13378 =item HTML SHORTCUTS AND LIST INTERPOLATION
13380 =item NON-STANDARD HTML SHORTCUTS
13382 =item AUTOESCAPING HTML
13384 $escaped_string = escapeHTML("unescaped string");, $charset =
13385 charset([$charset]);, $flag = autoEscape([$flag]);
13387 =item PRETTY-PRINTING HTML
13391 =item CREATING FILL-OUT FORMS:
13395 =item CREATING AN ISINDEX TAG
13397 =item STARTING AND ENDING A FORM
13399 B<application/x-www-form-urlencoded>, B<multipart/form-data>
13401 =item FORM ELEMENTS
13403 B<-name>, B<-value>, B<-values>, B<-tabindex>, B<-id>, B<-override>,
13404 B<-onChange>, B<-onFocus>, B<-onBlur>, B<-onMouseOver>, B<-onMouseOut>,
13407 =item CREATING A TEXT FIELD
13411 =item CREATING A BIG TEXT FIELD
13413 =item CREATING A PASSWORD FIELD
13415 =item CREATING A FILE UPLOAD FIELD
13419 =item CREATING A POPUP MENU
13421 =item CREATING AN OPTION GROUP
13423 =item CREATING A SCROLLING LIST
13427 =item CREATING A GROUP OF RELATED CHECKBOXES
13431 =item CREATING A STANDALONE CHECKBOX
13435 =item CREATING A RADIO BUTTON GROUP
13439 =item CREATING A SUBMIT BUTTON
13443 =item CREATING A RESET BUTTON
13445 =item CREATING A DEFAULT BUTTON
13447 =item CREATING A HIDDEN FIELD
13451 =item CREATING A CLICKABLE IMAGE BUTTON
13453 B<Parameters:>, 3. The third option (-align, optional) is an alignment
13454 type, and may be TOP, BOTTOM or MIDDLE
13456 =item CREATING A JAVASCRIPT ACTION BUTTON
13462 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
13463 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
13465 =item WORKING WITH FRAMES
13467 1. Create a <Frameset> document, 2. Specify the destination for the
13468 document in the HTTP header, 3. Specify the destination for the document in
13471 =item SUPPORT FOR JAVASCRIPT
13473 B<onLoad>, B<onUnload>, B<onSubmit>, B<onClick>, B<onChange>, B<onFocus>,
13474 B<onBlur>, B<onSelect>, B<onMouseOver>, B<onMouseOut>
13476 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
13482 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
13486 =item FETCHING ENVIRONMENT VARIABLES
13488 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
13489 B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
13490 name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
13491 ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
13492 B<virtual_port ()>, B<server_software ()>, B<remote_user ()>, B<user_name
13493 ()>, B<request_method()>, B<content_type()>, B<http()>, B<https()>
13495 =item USING NPH SCRIPTS
13497 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
13502 multipart_init(), multipart_start(), multipart_end(), multipart_final()
13504 =item Avoiding Denial of Service Attacks
13506 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
13507 basis>, B<2. Globally for all scripts>
13509 =item COMPATIBILITY WITH CGI-LIB.PL
13511 =item AUTHOR INFORMATION
13515 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
13516 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
13517 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
13518 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
13519 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
13520 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
13521 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
13522 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
13523 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
13524 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
13525 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
13526 ...and many many more..
13528 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
13536 =head2 CGI::Apache - Backward compatibility module for CGI.pm
13546 =item AUTHOR INFORMATION
13554 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
13563 =item REDIRECTING ERROR MESSAGES
13565 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
13569 =item Changing the default message
13573 =item DOING MORE THAN PRINTING A MESSAGE IN THE EVENT OF PERL ERRORS
13575 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
13577 =item OVERRIDING THE NAME OF THE PROGRAM
13585 =head2 CGI::Cookie - Interface to Netscape Cookies
13593 =item USING CGI::Cookie
13595 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>, B<4.
13600 =item Creating New Cookies
13602 =item Sending the Cookie to the Browser
13604 =item Recovering Previous Cookies
13606 =item Manipulating Cookies
13608 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
13612 =item AUTHOR INFORMATION
13620 =head2 CGI::Fast - CGI Interface for Fast CGI
13628 =item OTHER PIECES OF THE PUZZLE
13630 =item WRITING FASTCGI PERL SCRIPTS
13632 =item INSTALLING FASTCGI SCRIPTS
13634 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
13636 =item EXTERNAL FASTCGI SERVER INVOCATION
13638 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
13642 =item AUTHOR INFORMATION
13650 =head2 CGI::Pretty - module to produce nicely formatted HTML code
13660 =item Tags that won't be formatted
13662 =item Customizing the Indenting
13674 =head2 CGI::Push - Simple Interface to Server Push
13682 =item USING CGI::Push
13684 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
13688 =item Heterogeneous Pages
13690 =item Changing the Page Delay on the Fly
13694 =item INSTALLING CGI::Push SCRIPTS
13696 =item AUTHOR INFORMATION
13704 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
13714 =item AUTHOR INFORMATION
13722 =head2 CGI::Util - Internal utilities used by CGI module
13730 =item AUTHOR INFORMATION
13736 =head2 CPAN - query, download and build perl modules from CPAN sites
13746 =item CPAN::shell([$prompt, $command]) Starting Interactive Mode
13748 Searching for authors, bundles, distribution files and modules, C<get>,
13749 C<make>, C<test>, C<install>, C<clean> modules or distributions, C<readme>,
13750 C<perldoc>, C<look> module or distribution, C<ls> author, C<ls>
13751 globbing_expression, C<failed>, Persistence between sessions, The C<force>
13752 and the C<fforce> pragma, Lockfile, Signals
13764 =item report Bundle|Distribution|Module
13766 =item upgrade [Module|/Regex/]...
13768 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
13770 =item Integrating local directories
13774 =item CONFIGURATION
13776 completion support, displaying some help: o conf help, displaying current
13777 values: o conf [KEY], changing of scalar values: o conf KEY VALUE, changing
13778 of list values: o conf KEY SHIFT|UNSHIFT|PUSH|POP|SPLICE|LIST, reverting to
13779 saved: o conf defaults, saving the config: o conf commit
13783 =item Config Variables
13785 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
13786 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
13787 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
13788 [unshift|push|splice] E<lt>listE<gt>>, interactive editing: o conf init
13791 =item CPAN::anycwd($path): Note on config variable getcwd
13793 cwd, getcwd, fastcwd, backtickcwd
13795 =item Note on the format of the urllist parameter
13797 =item The urllist parameter has CD-ROM support
13799 =item Maintaining the urllist parameter
13801 =item The C<requires> and C<build_requires> dependency declarations
13803 =item Configuration for individual distributions (I<Distroprefs>)
13807 =item Fallback Data::Dumper and Storable
13811 =item Language Specs
13813 comment [scalar], cpanconfig [hash], disabled [boolean], goto [string],
13814 install [hash], make [hash], match [hash], patches [array], pl [hash], test
13817 =item Processing Instructions
13819 args [array], commandline, eexpect [hash], env [hash], expect [array]
13821 =item Schema verification with C<Kwalify>
13823 =item Example Distroprefs Files
13827 =item PROGRAMMER'S INTERFACE
13829 expand($type,@things), expandany(@things), Programming Examples
13833 =item Methods in the other Classes
13835 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
13836 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
13837 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
13838 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
13839 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
13840 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
13841 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
13842 CPAN::Bundle::readme(), CPAN::Bundle::test(),
13843 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
13844 CPAN::Distribution::author, CPAN::Distribution::clean(),
13845 CPAN::Distribution::containsmods(), CPAN::Distribution::cvs_import(),
13846 CPAN::Distribution::dir(), CPAN::Distribution::force($method,@args),
13847 CPAN::Distribution::get(), CPAN::Distribution::install(),
13848 CPAN::Distribution::install_tested(), CPAN::Distribution::isa_perl(),
13849 CPAN::Distribution::is_tested(), CPAN::Distribution::look(),
13850 CPAN::Distribution::make(), CPAN::Distribution::perldoc(),
13851 CPAN::Distribution::prefs(), CPAN::Distribution::prereq_pm(),
13852 CPAN::Distribution::readme(), CPAN::Distribution::read_yaml(),
13853 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
13854 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
13855 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
13856 CPAN::Module::clean(), CPAN::Module::cpan_file(),
13857 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
13858 CPAN::Module::description(), CPAN::Module::distribution(),
13859 CPAN::Module::dslip_status(), CPAN::Module::force($method,@args),
13860 CPAN::Module::get(), CPAN::Module::inst_file(),
13861 CPAN::Module::available_file(), CPAN::Module::inst_version(),
13862 CPAN::Module::available_version(), CPAN::Module::install(),
13863 CPAN::Module::look(), CPAN::Module::make(),
13864 CPAN::Module::manpage_headline(), CPAN::Module::perldoc(),
13865 CPAN::Module::readme(), CPAN::Module::test(), CPAN::Module::uptodate(),
13866 CPAN::Module::userid()
13868 =item Cache Manager
13874 =item PREREQUISITES
13880 =item Finding packages and VERSION
13884 o debug package.., o debug -package.., o debug all, o debug number
13886 =item Floppy, Zip, Offline Mode
13888 =item Basic Utilities for Programmers
13890 has_inst($module), has_usable($module), instance($module)
13898 =item Cryptographically signed modules
13906 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
13908 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
13912 =item Three basic types of firewalls
13914 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
13916 =item Configuring lynx or ncftp for going through a firewall
13922 1), 2), 3), 4), 5), 6), 7), 8), 9), 10), 11), 12), 13), 14), 15)
13924 =item COMPATIBILITY
13928 =item OLD PERL VERSIONS
13934 =item SECURITY ADVICE
13948 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
13960 =head2 CPAN::Kwalify - Interface between CPAN.pm and Kwalify.pm
13968 _validate($schema_name, $data, $file, $doc), yaml($schema_name)
13976 =head2 CPAN::Version - utility functions to compare CPAN versions
13988 =head2 CPANPLUS - API & CLI access to the CPAN mirrors
13994 =item GUIDE TO DOCUMENTATION
13998 =item GENERAL USAGE
14000 =item API REFERENCE
14008 =item COMMANDLINE TOOLS
14012 =item STARTING AN INTERACTIVE SHELL
14014 =item BUILDING PACKAGES
14016 =item $bool = install( Module::Name | /A/AU/AUTHOR/Module-Name-1.tgz )
14018 =item $where = fetch( Module::Name | /A/AU/AUTHOR/Module-Name-1.tgz )
14020 =item $where = get( Module::Name | /A/AU/AUTHOR/Module-Name-1.tgz )
14036 =item CONTACT INFORMATION
14038 Bug reporting: I<bug-cpanplus@rt.cpan.org>, Questions & suggestions:
14039 I<cpanplus-devel@lists.sourceforge.net>
14043 =head2 CPANPLUS::Backend
14057 =item $cb = CPANPLUS::Backend->new( [CONFIGURE_OBJ] )
14059 Provide a valid C<CPANPLUS::Configure> object, No arguments
14067 =item $href = $cb->module_tree( [@modules_names_list] )
14073 =item $href = $cb->author_tree( [@author_names_list] )
14079 =item $conf = $cb->configure_object ()
14085 =item $su = $cb->selfupdate_object;
14091 =item @mods = $cb->search( type => TYPE, allow => AREF, [data => AREF,
14098 =item $backend_rv = $cb->fetch( modules => \@mods )
14100 =item $backend_rv = $cb->extract( modules => \@mods )
14102 =item $backend_rv = $cb->install( modules => \@mods )
14104 =item $backend_rv = $cb->readme( modules => \@mods )
14106 =item $backend_rv = $cb->files( modules => \@mods )
14108 =item $backend_rv = $cb->distributions( modules => \@mods )
14114 =item $mod_obj = $cb->parse_module( module => $modname|$distname|$modobj )
14116 Text::Bastardize, Text-Bastardize, Text-Bastardize-1.06,
14117 AYRNIEU/Text-Bastardize, AYRNIEU/Text-Bastardize-1.06,
14118 AYRNIEU/Text-Bastardize-1.06.tar.gz,
14119 http://example.com/Text-Bastardize-1.06.tar.gz,
14120 file:///tmp/Text-Bastardize-1.06.tar.gz
14126 =item $bool = $cb->reload_indices( [update_source => BOOL, verbose => BOOL]
14133 =item $bool = $cb->flush(CACHE_NAME)
14135 C<methods>, C<hosts>, C<modules>, C<lib>, C<load>, C<all>
14141 =item @mods = $cb->installed()
14147 =item $bool = $cb->local_mirror([path => '/dir/to/save/to', index_files =>
14148 BOOL, force => BOOL, verbose => BOOL] )
14150 path, index_files, force, verbose
14156 =item $file = $cb->autobundle([path => OUTPUT_PATH, force => BOOL, verbose
14173 =head2 CPANPLUS::Backend::RV
14185 =item new( ok => BOOL, args => DATA, rv => DATA, [function => $method_name]
14188 ok, args, rv, function
14204 =head2 CPANPLUS::Configure
14216 =item $Configure = CPANPLUS::Configure->new( load_configs => BOOL )
14224 =item $bool = $Configure->init( [rescan => BOOL])
14230 =item can_save( [$config_location] )
14236 =item $file = $conf->save( [$package_name] )
14242 =item options( type => TYPE )
14252 =item get_SOMETHING( ITEM, [ITEM, ITEM, ... ] );
14254 =item set_SOMETHING( ITEM => VAL, [ITEM => VAL, ITEM => VAL, ... ] );
14256 =item add_SOMETHING( ITEM => VAL, [ITEM => VAL, ITEM => VAL, ... ] );
14258 set|get_conf, set|get_program, _set|_get_build, _set|_get_source,
14259 _set|_get_mirror, _set|_get_dist, _set|_get_fetch, _set|_get_daemon
14277 =head2 CPANPLUS::Dist
14289 =item STATUS ACCESSORS
14291 created(), installed(), uninstalled(), dist()
14297 =item $dist = CPANPLUS::Dist->new( module => MODOBJ, [format => DIST_TYPE]
14304 =item @dists = CPANPLUS::Dist->dist_types;
14310 =item prereq_satisfied( modobj => $modobj, version => $version_spec )
14316 =item _resolve_prereqs
14320 =head2 CPANPLUS::Dist::Base - Base class for custom distribution classes
14336 =item $bool = $Class->format_available
14342 =item $bool = $dist->init
14348 =item $bool = $dist->prepare
14354 =item $bool = $dist->create
14360 =item $bool = $dist->install
14366 =item $bool = $dist->uninstall
14370 =head2 CPANPLUS::Dist::MM
14380 =item STATUS ACCESSORS
14382 makefile (), make (), test (), prepared (), distdir (), created (),
14383 installed (), uninstalled (), _create_args (), _install_args ()
14393 =item $bool = $dist->format_available();
14401 =item $href = $dist->_find_prereqs( file => '/path/to/Makefile', [verbose
14408 =item $bool = $dist->create([perl => '/path/to/perl', make =>
14409 '/path/to/make', makeflags => 'EXTRA=FLAGS', prereq_target => TARGET,
14410 skiptest => BOOL, force => BOOL, verbose => BOOL])
14416 =item $bool = $dist->install([make => '/path/to/make', makemakerflags =>
14417 'EXTRA=FLAGS', force => BOOL, verbose => BOOL])
14423 =item $bool = $dist->write_makefile_pl([force => BOOL, verbose => BOOL])
14427 =head2 CPANPLUS::Dist::Sample -- Sample code to create your own Dist::*
14436 =head2 CPANPLUS::Error
14448 =item cp_msg("message string" [,VERBOSE])
14452 =item cp_error("error string" [,VERBOSE])
14458 =item CLASS METHODS
14462 =item CPANPLUS::Error->stack()
14464 =item CPANPLUS::Error->stack_as_string([TRACE])
14466 =item CPANPLUS::Error->flush()
14474 =item GLOBAL VARIABLES
14480 =head2 CPANPLUS::FAQ
14494 =head2 CPANPLUS::Hacking
14500 =item OBTAINING CPANPLUS
14502 =item INSTALLING CPANPLUS
14504 =item CONFIGURING CPANPLUS
14506 =item RUNNING CPANPLUS FROM DEVELOPMENT ENVIRONMENT
14508 =item RUNNING CPANPLUS TESTS
14512 Problem description, Program demonstrating the bug, [OPTIONAL] A patch to
14513 the test suite to test for the bug, [OPTIONAL] A patch to the code + tests
14516 =item SUPPLYING PATCHES
14518 In C<diff -u> or C<diff -c> format, From the root of the snapshot,
14519 Including patches for code + tests + docs, Sent per mail to
14520 cpanplus-devel@lists.sourceforge.net, With subject containing C<[PATCH]> +
14521 description of the patch
14525 =head2 CPANPLUS::Internals
14535 _conf, _id, _lib, _perl5lib
14545 =item $internals = CPANPLUS::Internals->_init( _conf => CONFIG_OBJ )
14553 =item $bool = $internals->_flush( list => \@caches )
14559 =item $bool = $internals->_register_callback( name => CALLBACK_NAME, code
14562 install_prerequisite, send_test_report, munge_test_report, edit_test_report
14568 =item $bool = $internals->_add_to_includepath( directories => \@dirs )
14574 =item $id = CPANPLUS::Internals->_last_id
14576 =item $id = CPANPLUS::Internals->_store_id( $internals )
14578 =item $obj = CPANPLUS::Internals->_retrieve_id( $ID )
14580 =item CPANPLUS::Internals->_remove_id( $ID )
14582 =item @objs = CPANPLUS::Internals->_return_all_objects
14586 =head2 CPANPLUS::Internals::Extract
14596 =item $dir = _extract( module => $modobj, [perl => '/path/to/perl',
14597 extractdir => '/path/to/extract/to', prefer_bin => BOOL, verbose => BOOL,
14600 module, extractdir, prefer_bin, perl, verbose, force
14606 =head2 CPANPLUS::Internals::Fetch
14620 =item $path = _fetch( module => $modobj, [fetchdir => '/path/to/save/to',
14621 fetch_from => 'scheme://path/to/fetch/from', verbose => BOOL, force =>
14622 BOOL, prefer_bin => BOOL] )
14628 =item _add_fail_host( host => $host_hashref )
14630 =item _host_ok( host => $host_hashref )
14634 =head2 CPANPLUS::Internals::Report
14646 =item $bool = $cb->_have_query_report_modules
14648 =item $bool = $cb->_have_send_report_modules
14656 =item @list = $cb->_query_report( module => $modobj, [all_versions => BOOL,
14663 =item $bool = $cb->_send_report( module => $modobj, buffer => $make_output,
14664 failed => BOOL, [save => BOOL, address => $email_to, dontcc => BOOL,
14665 verbose => BOOL, force => BOOL]);
14667 module, buffer, failed, save, address, dontcc, verbose, force
14671 =head2 CPANPLUS::Internals::Search
14683 =item _search_module_tree( type => TYPE, allow => \@regexex, [data =>
14684 \@previous_results ] )
14694 =item _search_author_tree( type => TYPE, allow => \@regexex, [data =>
14695 \@previous_results ] )
14703 =item _all_installed()
14707 =head2 CPANPLUS::Internals::Source
14721 =item $cb->_check_trees( [update_source => BOOL, path => PATH, verbose =>
14724 update_source, path, verbose
14730 =item $cb->__check_uptodate( file => $file, name => $name, [update_source
14731 => BOOL, verbose => BOOL] )
14733 file, name, update_source, verbose
14739 =item $cb->_update_source( name => $name, [path => $path, verbose => BOOL]
14742 name, path, verbose
14748 =item $cb->_build_trees( uptodate => BOOL, [use_stored => BOOL, path =>
14749 $path, verbose => BOOL] )
14751 uptodate, path, verbose, use_stored
14757 =item $cb->__retrieve_source(name => $name, [path => $path, uptodate =>
14758 BOOL, verbose => BOOL])
14760 name, uptodate, path, verbose
14766 =item $cb->_save_source([verbose => BOOL, path => $path])
14774 =item $cb->__create_author_tree([path => $path, uptodate => BOOL, verbose
14777 uptodate, path, verbose
14783 =item $cb->_create_mod_tree([path => $path, uptodate => BOOL, verbose =>
14786 uptodate, path, verbose
14792 =item $cb->__create_dslip_tree([path => $path, uptodate => BOOL, verbose =>
14795 uptodate, path, verbose
14801 =item $cb->_dslip_defs ()
14805 =head2 CPANPLUS::Internals::Utils
14817 =item $cb->_mkdir( dir => '/some/dir' )
14825 =item $cb->_chdir( dir => '/some/dir' )
14831 =item $cb->_rmdir( dir => '/some/dir' );
14837 =item $cb->_perl_version ( perl => 'some/perl/binary' );
14843 =item $cb->_version_to_number( version => $version );
14855 =item _get_file_contents( file => $file );
14861 =item $cb->_mode_plus_w( file => '/path/to/file' );
14867 =item $uri = $cb->_host_to_uri( scheme => SCHEME, host => HOST, path =>
14874 =item $cb->_vcmp( VERSION, VERSION );
14880 =item $cb->_home_dir
14886 =item $path = $cb->_safe_path( path => $path );
14892 =item ($pkg, $version, $ext) = $cb->_split_package_string( package =>
14897 =head2 CPANPLUS::Module
14909 =item CLASS METHODS
14923 name, module, version, path, comment, package, description, dslip, status,
14930 =item STATUS ACCESSORS
14932 installer_type, dist_cpan, dist, prereqs, signature, extract, fetch,
14933 readme, uninstall, created, installed, checksums, checksum_ok,
14940 =item $self = CPANPLUS::Module::new( OPTIONS )
14948 =item $mod->package_name
14950 =item $mod->package_version
14952 =item $mod->package_extension
14954 =item $mod->package_is_perl_core
14956 =item $mod->module_is_supplied_with_perl_core( [version => $]] )
14958 =item $mod->is_bundle
14960 =item $mod->is_third_party
14962 =item $mod->third_party_information
14968 =item $clone = $self->clone
14974 =item $where = $self->fetch
14980 =item $path = $self->extract
14986 =item $type = $self->get_installer_type([prefer_makefile => BOOL])
14992 =item $dist = $self->dist([target => 'prepare|create', format =>
14993 DISTRIBUTION_TYPE, args => {key => val}]);
14999 =item $bool = $mod->prepare( )
15001 Convenience method around C<install()> that prepares a module
15002 without actually building it. This is equivalent to invoking C<install>
15003 with C<target> set to C<prepare>
15009 =item $bool = $mod->create( )
15015 =item $bool = $mod->test( )
15021 =item $bool = $self->install([ target => 'prepare|create|install', format
15022 => FORMAT_TYPE, extractdir => DIRECTORY, fetchdir => DIRECTORY, prefer_bin
15023 => BOOL, force => BOOL, verbose => BOOL, ..... ]);
15029 =item $text = $self->readme
15035 =item $version = $self->installed_version()
15037 =item $where = $self->installed_file()
15039 =item $bool = $self->is_uptodate([version => VERSION_NUMBER])
15045 =item $href = $self->details()
15051 =item @list = $self->contains()
15057 =item @list_of_hrefs = $self->fetch_report()
15063 =item $bool = $self->uninstall([type => [all|man|prog])
15069 =item @modobj = $self->distributions()
15075 =item @list = $self->files ()
15081 =item @list = $self->directory_tree ()
15087 =item @list = $self->packlist ()
15093 =item @list = $self->validate ()
15099 =item $bool = $self->add_to_includepath;
15101 =item $path = $self->best_path_to_module_build();
15115 =head2 CPANPLUS::Module::Author
15125 author, cpanid, email, parent
15135 =item $auth = CPANPLUS::Module::Author->new( author => AUTHOR_NAME, cpanid
15136 => CPAN_ID, _id => INTERNALS_ID [, email => AUTHOR_EMAIL] )
15144 =item @mod_objs = $auth->modules()
15150 =item @dists = $auth->distributions()
15156 =item CLASS METHODS
15166 =head2 CPANPLUS::Module::Author::Fake
15178 =item new( _id => DIGIT )
15184 =head2 CPANPLUS::Module::Checksums
15196 =item $mod->checksums
15202 =head2 CPANPLUS::Module::Fake
15214 =item new( module => $mod, path => $path, package => $pkg, [_id => DIGIT] )
15220 =head2 CPANPLUS::inc
15228 =head2 CPANPLUS::inc - runtime inclusion of privately bundled modules
15236 Put a coderef at the beginning of C<@INC>, Add the full path to the
15237 C<CPANPLUS/inc> directory to C<$ENV{PERL5LIB>
15243 =item CPANPLUS::inc->inc_path()
15245 =item CPANPLUS::inc->my_path()
15247 =item CPANPLUS::inc->installer_path()
15255 =item CPANPLUS::inc->original_perl5lib
15257 =item CPANPLUS::inc->original_perl5opt
15259 =item CPANPLUS::inc->original_inc
15261 =item CPANPLUS::inc->limited_perl5opt(@modules);
15267 =item CPANPLUS::inc->interesting_modules()
15273 =item INTERESTING MODULES
15275 Loop over your @INC, Check the version on every suitable module found in
15286 On multiple C<use lib> calls, our coderef may not be the first in @INC,
15287 Non-directories in @INC
15291 =head2 CPANPLUSelfupdate, CPANPLUS::Selfupdate
15305 =item $self = CPANPLUS::Selfupdate->new( $backend_object );
15313 =item $bool = $self->selfupdate( update =>
15314 "core|dependencies|enabled_features|features|all", latest => BOOL )
15320 =item @features = $self->list_features
15326 =item @features = $self->list_enabled_features
15332 =item @mods = $self->modules_for_feature( FEATURE [,AS_HASH] )
15338 =item @mods = $self->list_core_dependencies( [AS_HASH] )
15344 =item @mods = $self->list_core_modules( [AS_HASH] )
15350 =item CPANPLUS::Selfupdate::Module
15356 =item $version = $mod->version_required
15362 =item $bool = $mod->is_installed_version_sufficient
15376 =head2 CPANPLUShell, CPANPLUS::Shell
15398 =head2 CPANPLUShell::Classic, CPANPLUS::Shell::Classic - CPAN.pm emulation
15421 =head2 CPANPLUShell::Default, CPANPLUS::Shell::Default
15443 =head2 CPANPLUShell::Default::Plugins::HOWTO,
15444 CPANPLUS::Shell::Default::Plugins::HOWTO -- documentation on how to write
15455 =item Registering Plugin Modules
15457 =item Registering Plugin Commands
15459 =item Registering Plugin Help
15461 =item Arguments to Plugin Commands
15463 Classname -- The name of your plugin class, Shell -- The
15464 CPANPLUS::Shell::Default object, Backend -- The CPANPLUS::Backend object,
15465 Command -- The command issued by the user, Input -- The input string
15466 from the user, Options -- A hashref of options provided by the user
15480 =head2 CPANPLUShell::Default::Plugins::Remote,
15481 CPANPLUS::Shell::Default::Plugins::Remote
15503 =head2 CPANPLUShell::Default::Plugins::Source,
15504 CPANPLUS::Shell::Default::Plugins::Source
15526 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
15541 =head2 Carp, carp - warn of errors (from perspective of caller)
15551 =item Forcing a Stack Trace
15555 =item GLOBAL VARIABLES
15559 =item $Carp::MaxEvalLen
15561 =item $Carp::MaxArgLen
15563 =item $Carp::MaxArgNums
15565 =item $Carp::Verbose
15567 =item %Carp::Internal
15569 =item %Carp::CarpInternal
15571 =item $Carp::CarpLevel
15579 =head2 Carp::Heavy - heavy machinery, no user serviceable parts inside
15581 =head2 Class::ISA -- report the search path for a class's ISA tree
15591 the function Class::ISA::super_path($CLASS), the function
15592 Class::ISA::self_and_super_path($CLASS), the function
15593 Class::ISA::self_and_super_versions($CLASS)
15595 =item CAUTIONARY NOTES
15603 =head2 Class::Struct - declare struct-like datatypes as Perl classes
15613 =item The C<struct()> function
15615 =item Class Creation at Compile Time
15617 =item Element Types and Accessor Methods
15619 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
15620 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
15622 =item Initializing with C<new>
15628 Example 1, Example 2, Example 3
15630 =item Author and Modification History
15634 =head2 Compress::Raw::Zlib - Low-Level Interface to zlib compression
15643 =item Compress::Raw::Zlib::Deflate
15647 =item B<($d, $status) = new Compress::Raw::Zlib::Deflate( [OPT] ) >
15649 B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>,
15650 B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32>
15652 =item B<$status = $d-E<gt>deflate($input, $output)>
15654 =item B<$status = $d-E<gt>flush($output [, $flush_type]) >
15656 =item B<$status = $d-E<gt>deflateParams([OPT])>
15658 B<-Level>, B<-Strategy>, B<-BufSize>
15660 =item B<$status = $d-E<gt>deflateTune($good_length, $max_lazy,
15661 $nice_length, $max_chain)>
15663 =item B<$d-E<gt>dict_adler()>
15665 =item B<$d-E<gt>crc32()>
15667 =item B<$d-E<gt>adler32()>
15669 =item B<$d-E<gt>msg()>
15671 =item B<$d-E<gt>total_in()>
15673 =item B<$d-E<gt>total_out()>
15675 =item B<$d-E<gt>get_Strategy()>
15677 =item B<$d-E<gt>get_Level()>
15679 =item B<$d-E<gt>get_BufSize()>
15685 =item Compress::Raw::Zlib::Inflate
15689 =item B< ($i, $status) = new Compress::Raw::Zlib::Inflate( [OPT] ) >
15691 B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>,
15692 B<-ADLER32>, B<-ConsumeInput>
15694 =item B< $status = $i-E<gt>inflate($input, $output [,$eof]) >
15696 =item B<$status = $i-E<gt>inflateSync($input)>
15698 =item B<$i-E<gt>dict_adler()>
15700 =item B<$i-E<gt>crc32()>
15702 =item B<$i-E<gt>adler32()>
15704 =item B<$i-E<gt>msg()>
15706 =item B<$i-E<gt>total_in()>
15708 =item B<$i-E<gt>total_out()>
15710 =item B<$d-E<gt>get_BufSize()>
15716 =item CHECKSUM FUNCTIONS
15718 =item ACCESSING ZIP FILES
15726 =item MODIFICATION HISTORY
15728 =item COPYRIGHT AND LICENSE
15732 =head2 Compress::Raw::Zlib::Compress::Raw::Zlib, Compress::Raw::Zlib -
15733 Low-Level Interface to zlib compression library
15741 =item Compress::Raw::Zlib::Deflate
15745 =item B<($d, $status) = new Compress::Raw::Zlib::Deflate( [OPT] ) >
15747 B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>,
15748 B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32>
15750 =item B<$status = $d-E<gt>deflate($input, $output)>
15752 =item B<$status = $d-E<gt>flush($output [, $flush_type]) >
15754 =item B<$status = $d-E<gt>deflateParams([OPT])>
15756 B<-Level>, B<-Strategy>, B<-BufSize>
15758 =item B<$status = $d-E<gt>deflateTune($good_length, $max_lazy,
15759 $nice_length, $max_chain)>
15761 =item B<$d-E<gt>dict_adler()>
15763 =item B<$d-E<gt>crc32()>
15765 =item B<$d-E<gt>adler32()>
15767 =item B<$d-E<gt>msg()>
15769 =item B<$d-E<gt>total_in()>
15771 =item B<$d-E<gt>total_out()>
15773 =item B<$d-E<gt>get_Strategy()>
15775 =item B<$d-E<gt>get_Level()>
15777 =item B<$d-E<gt>get_BufSize()>
15783 =item Compress::Raw::Zlib::Inflate
15787 =item B< ($i, $status) = new Compress::Raw::Zlib::Inflate( [OPT] ) >
15789 B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>,
15790 B<-ADLER32>, B<-ConsumeInput>
15792 =item B< $status = $i-E<gt>inflate($input, $output [,$eof]) >
15794 =item B<$status = $i-E<gt>inflateSync($input)>
15796 =item B<$i-E<gt>dict_adler()>
15798 =item B<$i-E<gt>crc32()>
15800 =item B<$i-E<gt>adler32()>
15802 =item B<$i-E<gt>msg()>
15804 =item B<$i-E<gt>total_in()>
15806 =item B<$i-E<gt>total_out()>
15808 =item B<$d-E<gt>get_BufSize()>
15814 =item CHECKSUM FUNCTIONS
15816 =item ACCESSING ZIP FILES
15824 =item MODIFICATION HISTORY
15826 =item COPYRIGHT AND LICENSE
15830 =head2 Compress::Zlib - Interface to zlib compression library
15840 =item Notes for users of Compress::Zlib version 1
15844 =item GZIP INTERFACE
15846 B<$gz = gzopen($filename, $mode)>, B<$gz = gzopen($filehandle, $mode)>,
15847 B<$bytesread = $gz-E<gt>gzread($buffer [, $size]) ;>, B<$bytesread =
15848 $gz-E<gt>gzreadline($line) ;>, B<$byteswritten = $gz-E<gt>gzwrite($buffer)
15849 ;>, B<$status = $gz-E<gt>gzflush($flush_type) ;>, B<$offset =
15850 $gz-E<gt>gztell() ;>, B<$status = $gz-E<gt>gzseek($offset, $whence) ;>,
15851 B<$gz-E<gt>gzclose>, B<$gz-E<gt>gzsetparams($level, $strategy>, B<$level>,
15852 B<$strategy>, B<$gz-E<gt>gzerror>, B<$gzerrno>
15858 =item Compress::Zlib::memGzip
15860 =item Compress::Zlib::memGunzip
15864 =item COMPRESS/UNCOMPRESS
15866 B<$dest = compress($source [, $level] ) ;>, B<$dest = uncompress($source)
15869 =item Deflate Interface
15873 =item B<($d, $status) = deflateInit( [OPT] )>
15875 B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>,
15876 B<-Dictionary>, B<-Bufsize>
15878 =item B<($out, $status) = $d-E<gt>deflate($buffer)>
15880 =item B<($out, $status) = $d-E<gt>flush([flush_type])>
15882 =item B<$status = $d-E<gt>deflateParams([OPT])>
15884 B<-Level>, B<-Strategy>
15886 =item B<$d-E<gt>dict_adler()>
15888 =item B<$d-E<gt>msg()>
15890 =item B<$d-E<gt>total_in()>
15892 =item B<$d-E<gt>total_out()>
15898 =item Inflate Interface
15902 =item B<($i, $status) = inflateInit()>
15904 B<-WindowBits>, B<-Bufsize>, B<-Dictionary>
15906 =item B<($out, $status) = $i-E<gt>inflate($buffer)>
15908 =item B<$status = $i-E<gt>inflateSync($buffer)>
15910 =item B<$i-E<gt>dict_adler()>
15912 =item B<$i-E<gt>msg()>
15914 =item B<$i-E<gt>total_in()>
15916 =item B<$i-E<gt>total_out()>
15922 =item CHECKSUM FUNCTIONS
15930 =item MODIFICATION HISTORY
15932 =item COPYRIGHT AND LICENSE
15936 =head2 Compress::Zlib::Compress::Zlib, Compress::Zlib - Interface to zlib
15937 compression library
15947 =item Notes for users of Compress::Zlib version 1
15951 =item GZIP INTERFACE
15953 B<$gz = gzopen($filename, $mode)>, B<$gz = gzopen($filehandle, $mode)>,
15954 B<$bytesread = $gz-E<gt>gzread($buffer [, $size]) ;>, B<$bytesread =
15955 $gz-E<gt>gzreadline($line) ;>, B<$byteswritten = $gz-E<gt>gzwrite($buffer)
15956 ;>, B<$status = $gz-E<gt>gzflush($flush_type) ;>, B<$offset =
15957 $gz-E<gt>gztell() ;>, B<$status = $gz-E<gt>gzseek($offset, $whence) ;>,
15958 B<$gz-E<gt>gzclose>, B<$gz-E<gt>gzsetparams($level, $strategy>, B<$level>,
15959 B<$strategy>, B<$gz-E<gt>gzerror>, B<$gzerrno>
15965 =item Compress::Zlib::memGzip
15967 =item Compress::Zlib::memGunzip
15971 =item COMPRESS/UNCOMPRESS
15973 B<$dest = compress($source [, $level] ) ;>, B<$dest = uncompress($source)
15976 =item Deflate Interface
15980 =item B<($d, $status) = deflateInit( [OPT] )>
15982 B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>,
15983 B<-Dictionary>, B<-Bufsize>
15985 =item B<($out, $status) = $d-E<gt>deflate($buffer)>
15987 =item B<($out, $status) = $d-E<gt>flush([flush_type])>
15989 =item B<$status = $d-E<gt>deflateParams([OPT])>
15991 B<-Level>, B<-Strategy>
15993 =item B<$d-E<gt>dict_adler()>
15995 =item B<$d-E<gt>msg()>
15997 =item B<$d-E<gt>total_in()>
15999 =item B<$d-E<gt>total_out()>
16005 =item Inflate Interface
16009 =item B<($i, $status) = inflateInit()>
16011 B<-WindowBits>, B<-Bufsize>, B<-Dictionary>
16013 =item B<($out, $status) = $i-E<gt>inflate($buffer)>
16015 =item B<$status = $i-E<gt>inflateSync($buffer)>
16017 =item B<$i-E<gt>dict_adler()>
16019 =item B<$i-E<gt>msg()>
16021 =item B<$i-E<gt>total_in()>
16023 =item B<$i-E<gt>total_out()>
16029 =item CHECKSUM FUNCTIONS
16037 =item MODIFICATION HISTORY
16039 =item COPYRIGHT AND LICENSE
16043 =head2 Config - access Perl configuration information
16051 myconfig(), config_sh(), config_re($regex), config_vars(@names)
16063 C<_a>, C<_exe>, C<_o>
16067 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
16068 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
16069 C<ar>, C<archlib>, C<archlibexp>, C<archname>, C<archname64>, C<archobjs>,
16070 C<asctime_r_proto>, C<awk>
16074 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
16078 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
16079 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
16080 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
16081 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
16082 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
16083 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
16084 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
16088 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>,
16089 C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>,
16090 C<d_attribute_format>, C<d_attribute_malloc>, C<d_attribute_nonnull>,
16091 C<d_attribute_noreturn>, C<d_attribute_pure>, C<d_attribute_unused>,
16092 C<d_attribute_warn_unused_result>, C<d_bcmp>, C<d_bcopy>, C<d_bsd>,
16093 C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_builtin_choose_expr>,
16094 C<d_builtin_expect>, C<d_bzero>, C<d_c99_variadic_macros>, C<d_casti32>,
16095 C<d_castneg>, C<d_charvspr>, C<d_chown>, C<d_chroot>, C<d_chsize>,
16096 C<d_class>, C<d_clearenv>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>,
16097 C<d_copysignl>, C<d_cplusplus>, C<d_crypt>, C<d_crypt_r>, C<d_csh>,
16098 C<d_ctermid>, C<d_ctermid_r>, C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>,
16099 C<d_dbminitproto>, C<d_difftime>, C<d_dir_dd_fd>, C<d_dirfd>,
16100 C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>,
16101 C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>,
16102 C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>, C<d_endnent>,
16103 C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>, C<d_endpwent>,
16104 C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>, C<d_eofnblk>,
16105 C<d_eunice>, C<d_faststdio>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>,
16106 C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>,
16107 C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>,
16108 C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>,
16109 C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>,
16110 C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>,
16111 C<d_fsync>, C<d_ftello>, C<d_ftime>, C<d_futimes>, C<d_Gconvert>,
16112 C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>,
16113 C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>,
16114 C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
16115 C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>,
16116 C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>,
16117 C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>,
16118 C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>,
16119 C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
16120 C<d_getpent>, C<d_getpgid>, C<d_getpgrp>, C<d_getpgrp2>, C<d_getppid>,
16121 C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>,
16122 C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
16123 C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>,
16124 C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>,
16125 C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>,
16126 C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
16127 C<d_htonl>, C<d_ilogbl>, C<d_inc_version_list>, C<d_index>, C<d_inetaton>,
16128 C<d_int64_t>, C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>,
16129 C<d_isnanl>, C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>,
16130 C<d_libm_lib_version>, C<d_link>, C<d_localtime_r>,
16131 C<d_localtime_r_needs_tzset>, C<d_locconv>, C<d_lockf>, C<d_longdbl>,
16132 C<d_longlong>, C<d_lseekproto>, C<d_lstat>, C<d_madvise>,
16133 C<d_malloc_good_size>, C<d_malloc_size>, C<d_mblen>, C<d_mbstowcs>,
16134 C<d_mbtowc>, C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>,
16135 C<d_memset>, C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>,
16136 C<d_mkstemps>, C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>,
16137 C<d_modflproto>, C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>,
16138 C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>, C<d_msg_proxy>,
16139 C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>, C<d_msgsnd>,
16140 C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>, C<d_nl_langinfo>,
16141 C<d_nv_preserves_uv>, C<d_nv_zero_is_allbits_zero>, C<d_off64_t>,
16142 C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
16143 C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
16144 C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
16145 C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
16146 C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_printf_format_null>,
16147 C<d_PRIo64>, C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>,
16148 C<d_pseudofork>, C<d_pthread_atfork>, C<d_pthread_attr_setscope>,
16149 C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>, C<d_pwclass>,
16150 C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>,
16151 C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir>, C<d_readdir64_r>,
16152 C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>, C<d_rename>,
16153 C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>,
16154 C<d_sbrkproto>, C<d_scalbnl>, C<d_sched_yield>, C<d_scm_rights>,
16155 C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>,
16156 C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>, C<d_semop>,
16157 C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>,
16158 C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>, C<d_setitimer>,
16159 C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>, C<d_setnent>,
16160 C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp>, C<d_setpgrp2>,
16161 C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>,
16162 C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>, C<d_setresuid>,
16163 C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>, C<d_setservent_r>,
16164 C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>, C<d_shmat>,
16165 C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>, C<d_sigaction>,
16166 C<d_signbit>, C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sitearch>,
16167 C<d_snprintf>, C<d_sockatmark>, C<d_sockatmarkproto>, C<d_socket>,
16168 C<d_socklen_t>, C<d_sockpair>, C<d_socks5_init>,
16169 C<d_sprintf_returns_strlen>, C<d_sqrtl>, C<d_srand48_r>, C<d_srandom_r>,
16170 C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>,
16171 C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
16172 C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>,
16173 C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>,
16174 C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strerror_r>,
16175 C<d_strftime>, C<d_strlcat>, C<d_strlcpy>, C<d_strtod>, C<d_strtol>,
16176 C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>,
16177 C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>,
16178 C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
16179 C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
16180 C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>,
16181 C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>,
16182 C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
16183 C<d_unordered>, C<d_unsetenv>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>,
16184 C<d_vendorarch>, C<d_vendorbin>, C<d_vendorlib>, C<d_vendorscript>,
16185 C<d_vfork>, C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>, C<d_volatile>,
16186 C<d_vprintf>, C<d_vsnprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>,
16187 C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>,
16188 C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
16189 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
16190 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
16194 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
16195 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
16196 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
16197 C<expr>, C<extensions>, C<extras>
16201 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
16202 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
16207 C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>,
16208 C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>,
16209 C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>,
16210 C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>,
16211 C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>,
16212 C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>,
16213 C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>,
16214 C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>,
16215 C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>,
16216 C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
16220 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>,
16221 C<html3dir>, C<html3direxp>
16225 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
16226 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
16227 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
16228 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
16229 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
16230 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
16231 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
16232 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
16233 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
16234 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
16235 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
16236 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
16237 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
16238 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
16239 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
16240 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
16241 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
16242 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
16243 C<incpath>, C<inews>, C<initialinstalllocation>, C<installarchlib>,
16244 C<installbin>, C<installhtml1dir>, C<installhtml3dir>, C<installman1dir>,
16245 C<installman3dir>, C<installprefix>, C<installprefixexp>,
16246 C<installprivlib>, C<installscript>, C<installsitearch>, C<installsitebin>,
16247 C<installsitehtml1dir>, C<installsitehtml3dir>, C<installsitelib>,
16248 C<installsiteman1dir>, C<installsiteman3dir>, C<installsitescript>,
16249 C<installstyle>, C<installusrbinperl>, C<installvendorarch>,
16250 C<installvendorbin>, C<installvendorhtml1dir>, C<installvendorhtml3dir>,
16251 C<installvendorlib>, C<installvendorman1dir>, C<installvendorman3dir>,
16252 C<installvendorscript>, C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>,
16257 C<known_extensions>, C<ksh>
16261 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
16262 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
16263 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
16264 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
16265 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
16266 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
16271 C<mad>, C<madlyh>, C<madlyobj>, C<madlysrc>, C<mail>, C<mailx>, C<make>,
16272 C<make_set_make>, C<mallocobj>, C<mallocsrc>, C<malloctype>, C<man1dir>,
16273 C<man1direxp>, C<man1ext>, C<man3dir>, C<man3direxp>, C<man3ext>
16277 C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>,
16278 C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>,
16283 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
16284 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
16285 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
16286 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
16287 C<nvsize>, C<nvtype>
16291 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
16292 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
16296 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl>,
16301 C<PERL_API_REVISION>, C<PERL_API_SUBVERSION>, C<PERL_API_VERSION>,
16302 C<PERL_CONFIG_SH>, C<PERL_PATCHLEVEL>, C<perl_patchlevel>,
16303 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
16304 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
16305 C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>,
16306 C<procselfexe>, C<prototype>, C<ptrsize>
16310 C<quadkind>, C<quadtype>
16314 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
16315 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
16316 C<rmail>, C<run>, C<runnm>
16320 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
16321 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
16322 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
16323 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
16324 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
16325 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
16326 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
16327 C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>,
16328 C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>,
16329 C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>,
16330 C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>,
16331 C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>,
16332 C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>,
16333 C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>,
16334 C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>,
16335 C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>,
16336 C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>,
16337 C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>,
16338 C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>,
16339 C<submit>, C<subversion>, C<sysman>
16343 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
16344 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
16349 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
16350 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
16351 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
16352 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>,
16353 C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemallocwrap>,
16354 C<usemorebits>, C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>,
16355 C<useperlio>, C<useposix>, C<usereentrant>, C<userelocatableinc>,
16356 C<usesfio>, C<useshrplib>, C<usesitecustomize>, C<usesocks>, C<usethreads>,
16357 C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>,
16358 C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>, C<uvXUformat>
16362 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
16363 C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>,
16364 C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>,
16365 C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>,
16366 C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>,
16367 C<vendorscriptexp>, C<version>, C<version_patchlevel_string>,
16368 C<versiononly>, C<vi>, C<voidflags>
16376 C<yacc>, C<yaccflags>
16394 dynamic, nonxs, static
16400 =head2 Cwd - get pathname of current working directory
16410 =item getcwd and friends
16412 getcwd, cwd, fastcwd, fastgetcwd, getdcwd
16414 =item abs_path and friends
16416 abs_path, realpath, fast_abs_path
16432 =head2 DB - programmatic interface to the Perl debugging API (draft,
16444 =item Global Variables
16446 $DB::sub, %DB::sub, $DB::single, $DB::signal, $DB::trace, @DB::args,
16447 @DB::dbline, %DB::dbline, $DB::package, $DB::filename, $DB::subname,
16452 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
16453 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
16455 =item Client Callback Methods
16457 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
16458 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
16459 CLIENT->output(LIST)
16469 =head2 DBM_Filter -- Filter DBM keys/values
16477 =item What is a DBM Filter?
16481 =item So what's new?
16489 =item $db->Filter_Push()
16491 =item $db->Filter_Key_Push()
16493 =item $db->Filter_Value_Push()
16495 Filter_Push, Filter_Key_Push, Filter_Value_Push
16497 =item $db->Filter_Pop()
16499 =item $db->Filtered()
16503 =item Writing a Filter
16507 =item Immediate Filters
16509 =item Canned Filters
16515 =item Filters Included
16517 utf8, encode, compress, int32, null
16523 =item Maintain Round Trip Integrity
16525 =item Don't mix filtered & non-filtered data in the same database file.
16537 =head2 DBM_Filter::compress - filter for DBM_Filter
16551 =head2 DBM_Filter::encode - filter for DBM_Filter
16565 =head2 DBM_Filter::int32 - filter for DBM_Filter
16579 =head2 DBM_Filter::null - filter for DBM_Filter
16593 =head2 DBM_Filter::utf8 - filter for DBM_Filter
16607 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
16615 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
16619 =item Using DB_File with Berkeley DB version 2 or greater
16621 =item Interface to Berkeley DB
16623 =item Opening a Berkeley DB Database File
16625 =item Default Parameters
16627 =item In Memory Databases
16635 =item A Simple Example
16643 =item Changing the BTREE sort order
16645 =item Handling Duplicate Keys
16647 =item The get_dup() Method
16649 =item The find_dup() Method
16651 =item The del_dup() Method
16653 =item Matching Partial Keys
16661 =item The 'bval' Option
16663 =item A Simple Example
16665 =item Extra RECNO Methods
16667 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
16668 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
16669 length, elements);>
16671 =item Another Example
16675 =item THE API INTERFACE
16677 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
16678 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
16679 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
16680 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
16684 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
16685 B<filter_fetch_value>
16691 =item An Example -- the NULL termination problem.
16693 =item Another Example -- Key is a C int.
16697 =item HINTS AND TIPS
16701 =item Locking: The Trouble with fd
16703 =item Safe ways to lock a database
16705 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
16707 =item Sharing Databases With C Applications
16709 =item The untie() Gotcha
16713 =item COMMON QUESTIONS
16717 =item Why is there Perl source in my database?
16719 =item How do I store complex data structures with DB_File?
16721 =item What does "Invalid Argument" mean?
16723 =item What does "Bareword 'DB_File' not allowed" mean?
16743 =head2 Data::Dumper - stringified perl data structures, suitable for both
16744 printing and C<eval>
16756 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump I<or>
16757 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
16758 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
16765 =item Configuration Variables or Methods
16791 =head2 Devel::DProf - a Perl code profiler
16799 =item PROFILE FORMAT
16811 =head2 Devel::InnerPackage - find all the inner packages of a package
16823 =item list_packages <package name>
16839 =head2 Devel::PPPort - Perl/Pollution/Portability
16849 =item Why use ppport.h?
16851 =item How to use ppport.h
16853 =item Running ppport.h
16865 =item COMPATIBILITY
16869 =item Provided Perl compatibility API
16871 =item Perl API not supported by ppport.h
16873 perl 5.9.5, perl 5.9.4, perl 5.9.3, perl 5.9.2, perl 5.9.1, perl 5.9.0,
16874 perl 5.8.3, perl 5.8.1, perl 5.8.0, perl 5.7.3, perl 5.7.2, perl 5.7.1,
16875 perl 5.6.1, perl 5.6.0, perl 5.005_03, perl 5.005, perl 5.004_05, perl
16890 =head2 Devel::Peek - A data debugging tool for the XS programmer
16900 =item Runtime debugging
16902 =item Memory footprint debugging
16910 =item A simple scalar string
16912 =item A simple scalar number
16914 =item A simple scalar with an extra reference
16916 =item A reference to a simple scalar
16918 =item A reference to an array
16920 =item A reference to a hash
16922 =item Dumping a large array or hash
16924 =item A reference to an SV which holds a C pointer
16926 =item A reference to a subroutine
16940 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
16950 =head2 Digest - Modules that calculate message digests
16958 I<binary>, I<hex>, I<base64>
16962 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
16963 Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset,
16964 $ctx->add( $data ), $ctx->add( $chunk1, $chunk2, ... ), $ctx->addfile(
16965 $io_handle ), $ctx->add_bits( $data, $nbits ), $ctx->add_bits( $bitstring
16966 ), $ctx->digest, $ctx->hexdigest, $ctx->b64digest
16976 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
16986 md5($data,...), md5_hex($data,...), md5_base64($data,...)
16990 $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...),
16991 $md5->addfile($io_handle), $md5->add_bits($data, $nbits),
16992 $md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest
17004 =head2 Digest::SHA - Perl extension for SHA-1/224/256/384/512
17008 =item SYNOPSIS (SHA)
17010 =item SYNOPSIS (HMAC-SHA)
17016 =item NIST STATEMENT ON SHA-1
17018 =item PADDING OF BASE64 DIGESTS
17022 =item EXPORTABLE FUNCTIONS
17024 B<sha1($data, ...)>, B<sha224($data, ...)>, B<sha256($data, ...)>,
17025 B<sha384($data, ...)>, B<sha512($data, ...)>, B<sha1_hex($data, ...)>,
17026 B<sha224_hex($data, ...)>, B<sha256_hex($data, ...)>, B<sha384_hex($data,
17027 ...)>, B<sha512_hex($data, ...)>, B<sha1_base64($data, ...)>,
17028 B<sha224_base64($data, ...)>, B<sha256_base64($data, ...)>,
17029 B<sha384_base64($data, ...)>, B<sha512_base64($data, ...)>, B<new($alg)>,
17030 B<reset($alg)>, B<hashsize>, B<algorithm>, B<clone>, B<add($data, ...)>,
17031 B<add_bits($data, $nbits)>, B<add_bits($bits)>, B<addfile(*FILE)>,
17032 B<addfile($filename [, $mode])>, B<dump($filename)>, B<load($filename)>,
17033 B<digest>, B<hexdigest>, B<b64digest>, B<hmac_sha1($data, $key)>,
17034 B<hmac_sha224($data, $key)>, B<hmac_sha256($data, $key)>,
17035 B<hmac_sha384($data, $key)>, B<hmac_sha512($data, $key)>,
17036 B<hmac_sha1_hex($data, $key)>, B<hmac_sha224_hex($data, $key)>,
17037 B<hmac_sha256_hex($data, $key)>, B<hmac_sha384_hex($data, $key)>,
17038 B<hmac_sha512_hex($data, $key)>, B<hmac_sha1_base64($data, $key)>,
17039 B<hmac_sha224_base64($data, $key)>, B<hmac_sha256_base64($data, $key)>,
17040 B<hmac_sha384_base64($data, $key)>, B<hmac_sha512_base64($data, $key)>
17046 =item ACKNOWLEDGMENTS
17048 =item COPYRIGHT AND LICENSE
17052 =head2 Digest::base - Digest base class
17064 =head2 Digest::file - Calculate digests of files
17072 digest_file( $file, $algorithm, [$arg,...] ), digest_file_hex( $file,
17073 $algorithm, [$arg,...] ), digest_file_base64( $file, $algorithm, [$arg,...]
17080 =head2 DirHandle - supply object methods for directory handles
17092 =head2 Dumpvalue - provides screen dump of Perl data.
17104 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
17105 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
17106 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
17111 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
17112 compactDump, veryCompact, set, get
17118 =head2 DynaLoader - Dynamically load C libraries into Perl code
17126 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
17127 @dl_modules, @dl_shared_objects, dl_error(), $dl_debug, dl_findfile(),
17128 dl_expandspec(), dl_load_file(), dl_unload_file(), dl_load_flags(),
17129 dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(),
17130 dl_install_xsub(), bootstrap()
17136 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
17149 =item Migration from C<DynaLoader>
17151 =item Backward compatible boilerplate
17155 =item Order of initialization: early load()
17159 =item The most hairy case
17165 C<Can't find '%s' symbol in %s>, C<Can't load '%s' for module %s: %s>,
17166 C<Undefined symbols present after loading %s: %s>,
17167 C<XSLoader::load('Your::Module', $Your::Module::VERSION)>
17181 =head2 Encode - character encodings
17189 =item Table of Contents
17201 =item PERL ENCODING API
17203 $octets = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
17204 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
17205 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
17210 =item Listing available encodings
17212 =item Defining Aliases
17216 =item Encoding via PerlIO
17218 =item Handling Malformed Data
17220 B<NOTE:> Not all encoding support this feature, I<CHECK> =
17221 Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1), I<CHECK> =
17222 Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode (I<CHECK> =
17223 Encode::FB_PERLQQ), HTML charref mode (I<CHECK> = Encode::FB_HTMLCREF), XML
17224 charref mode (I<CHECK> = Encode::FB_XMLCREF), The bitmask,
17229 =item coderef for CHECK
17233 =item Defining Encodings
17235 =item The UTF8 flag
17237 Goal #1:, Goal #2:, Goal #3:, Goal #4:
17241 =item Messing with Perl's Internals
17243 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
17247 =item UTF-8 vs. utf8 vs. UTF8
17257 =head2 Encode::Alias - alias definitions to encodings
17265 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
17270 =item Alias overloading
17278 =head2 Encode::Byte - Single Byte Encodings
17292 =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
17294 =head2 Encode::CN - China-based Chinese Encodings
17310 =head2 Encode::CN::HZ -- internally used by Encode::CN
17312 =head2 Encode::Config -- internally used by Encode
17314 =head2 Encode::EBCDIC - EBCDIC Encodings
17328 =head2 Encode::Encoding - Encode Implementation Base Class
17338 =item Methods you should implement
17340 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
17341 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
17343 =item Other methods defined in Encode::Encodings
17345 -E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(),
17346 -E<gt>needs_lines()
17348 =item Example: Encode::ROT13
17352 =item Why the heck Encode API is different?
17356 =item Compiled Encodings
17362 Scheme 1, Scheme 2, Other Schemes
17366 =head2 Encode::Guess -- Guesses encoding from data
17376 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
17377 Encode::decode("Guess" ...), Encode::Guess->guess($data),
17378 guess_encoding($data, [, I<list of suspects>])
17388 =head2 Encode::JP - Japanese Encodings
17398 =item Note on ISO-2022-JP(-1)?
17406 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
17408 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
17410 =head2 Encode::KR - Korean Encodings
17424 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
17426 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
17442 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
17448 =item How does it work?
17450 =item Line Buffering
17454 =item How can I tell whether my encoding fully supports PerlIO ?
17462 =head2 Encode::Supported -- Encodings supported by Encode
17470 =item Encoding Names
17474 =item Supported Encodings
17478 =item Built-in Encodings
17480 =item Encode::Unicode -- other Unicode encodings
17482 =item Encode::Byte -- Extended ASCII
17484 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
17485 the Cyrillic world, gsm0338 - Hentai Latin 1
17487 =item CJK: Chinese, Japanese, Korean (Multibyte)
17489 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
17490 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
17491 Encode::JIS2K -- JIS X 0213 encodings via CPAN
17493 =item Miscellaneous encodings
17495 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
17499 =item Unsupported encodings
17501 ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
17502 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
17503 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
17504 Various Mac encodings, (Mac) Indic encodings
17506 =item Encoding vs. Charset -- terminology
17508 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
17512 =item Microsoft-related naming mess
17514 KS_C_5601-1987, GB2312, Big5, Shift_JIS
17520 character repertoire, coded character set (CCS), character encoding scheme
17521 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
17528 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
17529 RFC, UC, Unicode Glossary
17533 =item Other Notable Sites
17535 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
17536 "Introduction to i18n"
17538 =item Offline sources
17540 C<CJKV Information Processing> by Ken Lunde
17546 =head2 Encode::Symbol - Symbol Encodings
17560 =head2 Encode::TW - Taiwan-based Chinese Encodings
17576 =head2 Encode::Unicode -- Various Unicode Transformation Formats
17584 L<http://www.unicode.org/glossary/> says:, Quick Reference
17586 =item Size, Endianness, and BOM
17592 =item by endianness
17594 BOM as integer when fetched in network byte order
17598 =item Surrogate Pairs
17600 =item Error Checking
17606 =head2 Encode::Unicode::UTF7 -- UTF-7 encoding
17620 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
17629 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
17634 =item Alias overloading
17642 =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm --
17643 Internally used by Encode::??::ISO_2022_*
17645 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
17648 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
17651 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
17652 Implementation Base Class
17662 =item Methods you should implement
17664 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
17665 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
17667 =item Other methods defined in Encode::Encodings
17669 -E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(),
17670 -E<gt>needs_lines()
17672 =item Example: Encode::ROT13
17676 =item Why the heck Encode API is different?
17680 =item Compiled Encodings
17686 Scheme 1, Scheme 2, Other Schemes
17690 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
17701 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
17702 Encode::decode("Guess" ...), Encode::Guess->guess($data),
17703 guess_encoding($data, [, I<list of suspects>])
17713 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
17714 Encode::JP::2022_JP*
17716 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
17719 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
17722 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
17723 and 'Q' header encoding
17739 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
17740 on Encode and PerlIO
17746 =item How does it work?
17748 =item Line Buffering
17752 =item How can I tell whether my encoding fully supports PerlIO ?
17760 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
17761 supported by Encode
17769 =item Encoding Names
17773 =item Supported Encodings
17777 =item Built-in Encodings
17779 =item Encode::Unicode -- other Unicode encodings
17781 =item Encode::Byte -- Extended ASCII
17783 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
17784 the Cyrillic world, gsm0338 - Hentai Latin 1
17786 =item CJK: Chinese, Japanese, Korean (Multibyte)
17788 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
17789 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
17790 Encode::JIS2K -- JIS X 0213 encodings via CPAN
17792 =item Miscellaneous encodings
17794 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
17798 =item Unsupported encodings
17800 ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
17801 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
17802 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
17803 Various Mac encodings, (Mac) Indic encodings
17805 =item Encoding vs. Charset -- terminology
17807 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
17811 =item Microsoft-related naming mess
17813 KS_C_5601-1987, GB2312, Big5, Shift_JIS
17819 character repertoire, coded character set (CCS), character encoding scheme
17820 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
17827 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
17828 RFC, UC, Unicode Glossary
17832 =item Other Notable Sites
17834 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
17835 "Introduction to i18n"
17837 =item Offline sources
17839 C<CJKV Information Processing> by Ken Lunde
17845 =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7
17860 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
17872 =item Predefined Methods
17874 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
17875 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
17876 $e-E<gt>bytes([$encoding])
17878 =item Example: base64 transcoder
17880 =item Operator Overloading
17888 =head2 Encodencoding, encoding - allows you to write your script in
17889 non-ascii or non-utf8
17899 =item Literal Conversions
17901 =item PerlIO layers for C<STD(IN|OUT)>
17903 =item Implicit upgrading for byte strings
17911 =item FEATURES THAT REQUIRE 5.8.1
17913 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
17917 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
17918 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
17920 =item The Filter Option
17924 =item Filter-related changes at Encode version 1.87
17934 =item DO NOT MIX MULTIPLE ENCODINGS
17936 =item tr/// with ranges
17938 Legend of characters above
17942 =item EXAMPLE - Greekperl
17944 =item KNOWN PROBLEMS
17946 literals in regex that are longer than 127 bytes, EBCDIC, format
17950 =item The Logic of :locale
17960 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
17972 =item Predefined Methods
17974 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
17975 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
17976 $e-E<gt>bytes([$encoding])
17978 =item Example: base64 transcoder
17980 =item Operator Overloading
17988 =head2 English - use nice English (or awk) names for ugly punctuation
18001 =head2 Env - perl module that imports environment variables as scalars or
18016 =head2 Errno - System errno constants
18032 =head2 Exporter - Implements default import method for modules
18042 =item How to Export
18044 =item Selecting What To Export
18046 =item How to Import
18048 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
18052 =item Advanced features
18056 =item Specialised Import Lists
18058 =item Exporting without using Exporter's import method
18060 =item Exporting without inheriting from Exporter
18062 =item Module Version Checking
18064 =item Managing Unknown Symbols
18066 =item Tag Handling Utility Functions
18068 =item Generating combined tags
18070 =item C<AUTOLOAD>ed Constants
18076 =head2 Exporter::Heavy - Exporter guts
18086 =head2 ExtUtils::CBuilder - Compile and link C code for Perl modules
18096 new, have_compiler, compile, C<object_file>, C<include_dirs>,
18097 C<extra_compiler_flags>, link, lib_file, module_name, extra_linker_flags,
18098 link_executable, exe_file, object_file, lib_file, exe_file, prelink,
18099 need_prelink, extra_link_args_after_prelink
18113 =head2 ExtUtils::CBuilder::Platform::Windows - Builder class for Windows
18126 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
18175 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
18189 B<warn_if_old_packlist>
18191 B<perllocal_install>
18195 =head2 ExtUtils::Constant - generate XS code to import C header constants
18205 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
18213 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
18215 autoload PACKAGE, VERSION, AUTOLOADER
18217 WriteMakefileSnippet
18219 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
18220 BREAKOUT_AT, NAMES, C_FH, C_FILE, XS_FH, XS_FILE, SUBNAME, C_SUBNAME
18228 =head2 ExtUtils::Constant::Base - base class for ExtUtils::Constant objects
18242 memEQ_clause args_hashref
18244 dump_names arg_hashref, ITEM..
18246 assign arg_hashref, VALUE..
18248 return_clause arg_hashref, ITEM
18250 switch_clause arg_hashref, NAMELEN, ITEMHASH, ITEM..
18254 dogfood arg_hashref, ITEM..
18256 normalise_items args, default_type, seen_types, seen_items, ITEM..
18258 C_constant arg_hashref, ITEM.., name, type, value, macro, default, pre,
18259 post, def_pre, def_post, utf8, weight
18269 =head2 ExtUtils::Constant::Utils - helper functions for ExtUtils::Constant
18283 perl_stringify NAME
18291 =head2 ExtUtils::Constant::XS, ExtUtils::Constant::Base - base class for
18292 ExtUtils::Constant objects
18306 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
18318 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
18319 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
18329 =head2 ExtUtils::Install - install files from here to there
18337 _chmod($$;$), _warnonce(@), _choke(@)
18341 _move_file_at_boot( $file, $target, $moan )
18343 _unlink_or_rename( $file, $tryhard, $installing )
18357 _can_write_dir(C<$dir>)
18359 _mkpath($dir,$show,$mode,$verbose,$fake)
18361 _copy($from,$to,$verbose,$fake)
18367 install_rooted_file( $file ), install_rooted_dir( $dir )
18369 forceunlink( $file, $tryhard )
18371 directory_not_empty( $dir )
18373 B<install_default> I<DISCOURAGED>
18377 inc_uninstall($filepath,$libdir,$verbose,$nonono,$ignore)
18379 run_filter($cmd,$src,$dest)
18391 B<PERL_INSTALL_ROOT>, B<EU_INSTALL_IGNORE_SKIP>,
18392 B<EU_INSTALL_SITE_SKIPFILE>
18400 =head2 ExtUtils::Installed - Inventory management of installed modules
18412 new(), modules(), files(), directories(), directory_tree(), validate(),
18413 packlist(), version()
18421 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
18429 For static extensions, For dynamic extensions at build/link time, For
18430 dynamic extensions at load time
18436 =item LDLOADLIBS and LD_RUN_PATH
18446 =item VMS implementation
18448 =item Win32 implementation
18456 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
18466 =head2 ExtUtils::MM_AIX - AIX specific subclass of ExtUtils::MM_Unix
18476 =item Overridden methods
18490 =head2 ExtUtils::MM_Any - Platform-agnostic MM methods
18502 =item Cross-platform helper methods
18528 =item File::Spec wrappers
18544 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
18545 ExtUtils::MakeMaker
18559 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
18560 ExtUtils::MakeMaker
18574 replace_manpage_separator
18578 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
18588 =item Overridden methods
18596 B<replace_manpage_separator>
18606 =head2 ExtUtils::MM_MacOS - once produced Makefiles for MacOS Classic
18616 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
18617 ExtUtils::MakeMaker
18629 init_platform, platform_constants
18637 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
18638 ExtUtils::MakeMaker
18656 =head2 ExtUtils::MM_QNX - QNX specific subclass of ExtUtils::MM_Unix
18666 =item Overridden methods
18680 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
18690 =item Overridden methods
18698 B<replace_manpage_separator>
18708 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
18810 init_platform, platform_constants
18854 post_initialize (o)
18866 replace_manpage_separator
18890 test_via_harness (override)
18892 test_via_script (override)
18916 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
18917 ExtUtils::MakeMaker
18927 =item Methods always loaded
18939 guess_name (override)
18943 find_perl (override)
18945 maybe_command (override)
18949 pm_to_blib (override)
18951 perl_script (override)
18953 replace_manpage_separator
18959 init_main (override)
18961 init_others (override)
18963 init_platform (override)
18967 init_VERSION (override)
18969 constants (override)
18975 const_cccmd (override)
18977 tools_other (override)
18979 init_dist (override)
18989 dynamic_lib (override)
18991 static_lib (override)
18995 zipfile_target, tarfile_target, shdist_target
18999 perldepend (override)
19001 makeaperl (override)
19003 nicetext (override)
19005 prefixify (override)
19033 =head2 ExtUtils::MM_VOS - VOS specific subclass of ExtUtils::MM_Unix
19043 =item Overridden methods
19057 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
19058 ExtUtils::MakeMaker
19070 =item Overridden methods
19076 replace_manpage_separator
19084 init_platform, platform_constants
19110 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
19120 =item Overridden methods
19142 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
19152 =head2 ExtUtils::MakeMaker - Create a module Makefile
19162 =item How To Write A Makefile.PL
19164 =item Default Makefile Behaviour
19174 =item PREFIX and LIB attribute
19178 =item Static Linking of a new Perl Binary
19180 =item Determination of Perl Library and Installation Locations
19182 =item Which architecture dependent directory?
19184 =item Using Attributes and Parameters
19186 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
19187 CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS,
19188 EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN,
19189 FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB,
19190 INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
19191 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB,
19192 INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLSITESCRIPT,
19193 INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB,
19194 INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INSTALLVENDORSCRIPT,
19195 INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT,
19196 LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS, LICENSE, LINKTYPE, MAKE,
19197 MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME,
19198 NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT, OPTIMIZE, PERL,
19199 PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLPREFIX,
19200 PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM, PMLIBDIRS,
19201 PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, PREFIX,
19202 PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT, PRINT_PREREQ, SITEPREFIX, SIGN,
19203 SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, VERSION_FROM, VERSION_SYM,
19204 XS, XSOPT, XSPROTOARG, XS_VERSION
19206 =item Additional lowercase attributes
19208 clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean,
19209 test, tool_autosplit
19211 =item Overriding MakeMaker Methods
19213 =item The End Of Cargo Cult Programming
19215 C<< MAN3PODS => ' ' >>
19217 =item Hintsfile support
19219 =item Distribution Support
19221 make distcheck, make skipcheck, make distclean, make manifest,
19222 make distdir, make disttest, make tardist, make dist, make
19223 uutardist, make shdist, make zipdist, make ci
19225 =item Module Meta-Data
19227 =item Disabling an extension
19229 =item Other Handy Functions
19237 PERL_MM_OPT, PERL_MM_USE_DEFAULT, PERL_CORE
19247 =head2 ExtUtils::MakeMaker::Config - Wrapper around Config.pm
19257 =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About
19266 =item Module Installation
19268 How do I install a module into my home directory?, How do I get MakeMaker
19269 and Module::Build to install to the same place?, How do I keep from
19270 installing man pages?, How do I use a module without installing it?
19272 =item Philosophy and History
19274 Why not just use <insert other build config tool here>?, What is
19275 Module::Build and how does it relate to MakeMaker?, pure perl. no make, no
19276 shell commands, easier to customize, cleaner internals, less cruft
19278 =item Module Writing
19280 How do I keep my $VERSION up to date without resetting it manually?, What's
19281 this F<META.yml> thing and how did it get in my F<MANIFEST>?!, How do I
19282 delete everything not in my F<MANIFEST>?
19286 How to I prevent "object version X.XX does not match bootstrap parameter
19287 Y.YY" errors?, How do I make two or more XS files coexist in the same
19300 =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker
19314 Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP,
19323 =head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm
19333 =head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm
19343 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
19381 =item MANIFEST.SKIP
19383 #!include_default, #!include /Path/to/another/manifest.skip
19387 =item GLOBAL VARIABLES
19395 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
19396 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
19400 B<PERL_MM_MANIFEST_DEBUG>
19408 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
19420 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
19430 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
19439 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
19451 =head2 ExtUtils::Packlist - manage .packlist files
19463 new(), read(), write(), validate(), packlist_file()
19471 =head2 ExtUtils::ParseXS - converts Perl XS code into C code
19481 process_xs(), B<C++>, B<hiertype>, B<except>, B<typemap>, B<prototypes>,
19482 B<versioncheck>, B<linenumbers>, B<optimize>, B<inout>, B<argtypes>, B<s>,
19493 =head2 ExtUtils::testlib - add blib/* directories to @INC
19503 =head2 Fatal - replace functions with equivalents which succeed or die
19517 =head2 Fcntl - load the C Fcntl.h defines
19527 =item EXPORTED SYMBOLS
19531 =head2 File::Basename - Parse file paths into directory, filename and
19542 C<fileparse> X<fileparse>
19544 C<basename> X<basename> X<filename>
19546 C<dirname> X<dirname>
19548 C<fileparse_set_fstype> X<filesystem>
19556 =head2 File::CheckTree, validate - run many filetest checks on a tree
19570 =head2 File::Compare - Compare files or filehandles
19584 =head2 File::Copy - Copy files or filehandles
19592 copy X<copy> X<cp>, move X<move> X<mv> X<rename>, syscopy X<syscopy>,
19593 rmscopy($from,$to[,$date_flag]) X<rmscopy>
19603 =head2 File::DosGlob - DOS like globbing and then some
19613 =item EXPORTS (by request only)
19625 =head2 File::Fetch - A generic file fetching mechanism
19635 $ff->uri, $ff->scheme, $ff->host, $ff->path, $ff->file
19647 =item $ff = File::Fetch->new( uri => 'http://some.where.com/dir/file.txt'
19656 =item $ff->fetch( [to => /my/output/dir/] )
19662 =item $ff->error([BOOL])
19670 =item GLOBAL VARIABLES
19674 =item $File::Fetch::FROM_EMAIL
19676 =item $File::Fetch::USER_AGENT
19678 =item $File::Fetch::FTP_PASSIVE
19680 =item $File::Fetch::TIMEOUT
19682 =item $File::Fetch::WARN
19684 =item $File::Fetch::DEBUG
19686 =item $File::Fetch::BLACKLIST
19688 =item $File::Fetch::METHOD_FAIL
19694 =item FREQUENTLY ASKED QUESTIONS
19698 =item So how do I use a proxy with File::Fetch?
19700 =item I used 'lynx' to fetch a file, but its contents is all wrong!
19702 =item Files I'm trying to fetch have reserved characters or non-ASCII
19703 characters in them. What do I do?
19709 Implement $PREFER_BIN
19717 =head2 File::Find - Traverse a directory tree.
19725 B<find>, B<finddepth>
19731 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
19732 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
19733 C<untaint>, C<untaint_pattern>, C<untaint_skip>
19735 =item The wanted function
19737 C<$File::Find::dir> is the current directory name,, C<$_> is the current
19738 filename within that directory, C<$File::Find::name> is the complete
19739 pathname to the file
19747 $dont_use_nlink, symlinks
19751 =item BUGS AND CAVEATS
19757 =head2 File::Glob - Perl extension for BSD glob routine
19767 =item META CHARACTERS
19771 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
19772 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
19773 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
19779 C<GLOB_NOSPACE>, C<GLOB_ABEND>
19789 =head2 File::GlobMapper - Extend File Glob to Allow Input and Output Files
19797 This code is a work in progress, There are known bugs, The interface
19798 defined here is tentative, There are portability issues, Do not use in
19799 production code, Consider yourself warned!
19803 =item Behind The Scenes
19807 =item Input File Glob
19809 B<~>, B<~user>, B<.>, B<*>, B<?>, B<\>, B<[]>, B<{,}>, B<()>
19811 =item Output File Glob
19815 =item Returned Data
19823 =item A Rename script
19825 =item A few example globmaps
19833 =item COPYRIGHT AND LICENSE
19837 =head2 File::Path - create or remove directory trees
19851 =head2 File::Spec - portably perform operations on file names
19861 canonpath X<canonpath>, catdir X<catdir>, catfile X<catfile>, curdir
19862 X<curdir>, devnull X<devnull>, rootdir X<rootdir>, tmpdir X<tmpdir>, updir
19863 X<updir>, no_upwards, case_tolerant, file_name_is_absolute, path X<path>,
19864 join X<join, path>, splitpath X<splitpath> X<split, path>, splitdir
19865 X<splitdir> X<split, dir>, catpath(), abs2rel X<abs2rel> X<absolute, path>
19866 X<relative, path>, rel2abs() X<rel2abs> X<absolute, path> X<relative, path>
19876 =head2 File::Spec::Cygwin - methods for Cygwin file specs
19888 file_name_is_absolute
19898 =head2 File::Spec::Epoc - methods for Epoc file specs
19920 =head2 File::Spec::Functions - portably perform operations on file names
19940 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
19968 file_name_is_absolute
19992 =head2 File::Spec::OS2 - methods for OS/2 file specs
20006 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
20039 file_name_is_absolute
20063 =head2 File::Spec::VMS - methods for VMS file specs
20071 canonpath (override)
20089 case_tolerant (override)
20093 file_name_is_absolute (override)
20095 splitpath (override)
20097 splitdir (override)
20113 =head2 File::Spec::Win32 - methods for Win32 file specs
20139 =item Note For File::Spec::Win32 Maintainers
20151 =head2 File::Temp - return name and handle of a temporary file safely
20165 =item OBJECT-ORIENTED INTERFACE
20173 B<unlink_on_destroy>
20189 =item MKTEMP FUNCTIONS
20203 =item POSIX FUNCTIONS
20213 =item ADDITIONAL FUNCTIONS
20221 =item UTILITY FUNCTIONS
20235 =item PACKAGE VARIABLES
20237 B<safe_level>, STANDARD, MEDIUM, HIGH
20243 B<$KEEP_ALL>, B<$DEBUG>
20251 =item Temporary files and NFS
20267 =head2 File::stat - by-name interface to Perl's built-in stat() functions
20283 =head2 FileCache - keep more files open than the system permits
20291 cacheout EXPR, cacheout MODE, EXPR
20299 =head2 FileHandle - supply object methods for filehandles
20307 $fh->print, $fh->printf, $fh->getline, $fh->getlines
20313 =head2 Filter::Simple - Simplified source filtering
20327 =item Disabling or changing <no> behaviour
20329 =item All-in-one interface
20331 =item Filtering only specific components of source code
20333 C<"code">, C<"code_no_comments">, C<"executable">,
20334 C<"executable_no_comments">, C<"quotelike">, C<"string">, C<"regex">,
20337 =item Filtering only the code parts of source code
20339 Most source code ceases to be grammatically correct when it is broken up
20340 into the pieces between string literals and regexes. So the C<'code'>
20341 and C<'code_no_comments'> component filter behave slightly differently
20342 from the other partial filters described in the previous section.
20344 =item Using Filter::Simple with an explicit C<import> subroutine
20346 =item Using Filter::Simple and Exporter together
20358 =head2 Filter::Util::Call - Perl Source Filter Utility Module
20368 =item B<use Filter::Util::Call>
20372 =item B<filter() and anonymous sub>
20374 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
20382 =item Example 1: A simple filter.
20384 =item Example 2: Using the context
20386 =item Example 3: Using the context within the filter
20388 =item Example 4: Using filter_del
20392 =item Filter::Simple
20400 =head2 FindBin - Locate directory of original perl script
20408 =item EXPORTABLE VARIABLES
20420 =head2 GDBM_File - Perl5 access to the gdbm library.
20436 =head2 Getopt::Long - Extended processing of command line options
20444 =item Command Line Options, an Introduction
20446 =item Getting Started with Getopt::Long
20450 =item Simple options
20452 =item A little bit less simple options
20454 =item Mixing command line option with other arguments
20456 =item Options with values
20458 =item Options with multiple values
20460 =item Options with hash values
20462 =item User-defined subroutines to handle options
20464 =item Options with multiple names
20466 =item Case and abbreviations
20468 =item Summary of Option Specifications
20470 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
20475 =item Advanced Possibilities
20479 =item Object oriented interface
20481 =item Thread Safety
20483 =item Documentation and help texts
20485 =item Parsing options from an arbitrary array
20487 =item Parsing options from an arbitrary string
20489 =item Storing options values in a hash
20493 =item The lonesome dash
20495 =item Argument callback
20499 =item Configuring Getopt::Long
20501 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
20502 require_order, permute, bundling (default: disabled), bundling_override
20503 (default: disabled), ignore_case (default: enabled), ignore_case_always
20504 (default: disabled), auto_version (default:disabled), auto_help
20505 (default:disabled), pass_through (default: disabled), prefix,
20506 prefix_pattern, long_prefix_pattern, debug (default: disabled)
20508 =item Exportable Methods
20510 VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage
20512 =item Return values and Errors
20518 =item Default destinations
20520 =item Alternative option starters
20522 =item Configuration variables
20526 =item Tips and Techniques
20530 =item Pushing multiple values in a hash option
20534 =item Trouble Shooting
20538 =item GetOptions does not return a false result when an option is not
20541 =item GetOptions does not split the command line correctly
20543 =item Undefined subroutine &main::GetOptions called
20545 =item How do I put a "-?" option into a Getopt::Long?
20551 =item COPYRIGHT AND DISCLAIMER
20555 =head2 Getopt::Std, getopt, getopts - Process single-character switches
20556 with switch clustering
20564 =item C<--help> and C<--version>
20568 =head2 Hash::Util - A selection of general-utility hash subroutines
20580 =item Restricted hashes
20582 B<lock_keys>, B<unlock_keys>
20590 B<lock_value>, B<unlock_value>
20592 B<lock_hash>, B<unlock_hash>
20594 B<lock_hash_recurse>, B<unlock_hash_recurse>
20598 b<legal_keys>, B<hidden_keys>, B<all_keys>, B<hash_seed>
20604 =item Operating on references to hashes.
20606 lock_ref_keys, unlock_ref_keys, lock_ref_keys_plus, lock_ref_value,
20607 unlock_ref_value, lock_hashref, unlock_hashref, lock_hashref_recurse,
20608 unlock_hashref_recurse, hash_ref_unlocked, legal_ref_keys, hidden_ref_keys
20624 =head2 Hash::Util::FieldHash - Associate references with data
20632 fieldhash, fieldhashes
20640 Key exchange, Thread support, Garbage collection
20644 Stringification, Thread Dependency, Garbage Collection
20650 =item Garbage-Collected Hashes
20658 =item The C<PERL_MAGIC_uvar> interface for hashes
20660 =item Weakrefs call uvar magic
20662 =item How field hashes work
20664 =item Internal function Hash::Util::FieldHash::_fieldhash
20670 =item COPYRIGHT AND LICENSE
20674 =head2 Hash::Util::FieldHash::lib::Hash::Util::FieldHash,
20675 Hash::Util::FieldHash - Associate references with data
20683 fieldhash, fieldhashes
20691 Key exchange, Thread support, Garbage collection
20695 Stringification, Thread Dependency, Garbage Collection
20701 =item Garbage-Collected Hashes
20709 =item The C<PERL_MAGIC_uvar> interface for hashes
20711 =item Weakrefs call uvar magic
20713 =item How field hashes work
20715 =item Internal function Hash::Util::FieldHash::_fieldhash
20721 =item COPYRIGHT AND LICENSE
20725 =head2 Hash::Utilib::Hash::Util, Hash::Util - A selection of
20726 general-utility hash subroutines
20738 =item Restricted hashes
20740 B<lock_keys>, B<unlock_keys>
20748 B<lock_value>, B<unlock_value>
20750 B<lock_hash>, B<unlock_hash>
20752 B<lock_hash_recurse>, B<unlock_hash_recurse>
20756 b<legal_keys>, B<hidden_keys>, B<all_keys>, B<hash_seed>
20762 =item Operating on references to hashes.
20764 lock_ref_keys, unlock_ref_keys, lock_ref_keys_plus, lock_ref_value,
20765 unlock_ref_value, lock_hashref, unlock_hashref, lock_hashref_recurse,
20766 unlock_hashref_recurse, hash_ref_unlocked, legal_ref_keys, hidden_ref_keys
20782 =head2 I18N::Collate - compare 8-bit scalar data according to the current
20793 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
20804 the function is_language_tag($lang1)
20806 the function extract_language_tags($whatever)
20808 the function same_language_tag($lang1, $lang2)
20810 the function similarity_language_tag($lang1, $lang2)
20812 the function is_dialect_of($lang1, $lang2)
20814 the function super_languages($lang1)
20816 the function locale2language_tag($locale_identifier)
20818 the function encode_language_tag($lang1)
20820 the function alternate_language_tags($lang1)
20822 the function @langs = panic_languages(@accept_languages)
20824 the function implicate_supers( ...languages... ), the function
20825 implicate_supers_strictly( ...languages... )
20829 =item ABOUT LOWERCASING
20831 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
20841 =head2 I18N::LangTags::Detect - detect the user's language preferences
20861 =head2 I18N::LangTags::List -- tags and names for human languages
20869 =item ABOUT LANGUAGE TAGS
20871 =item LIST OF LANGUAGES
20873 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} :
20874 Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} :
20875 Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian,
20876 {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)],
20877 {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic,
20878 {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy}
20879 : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} :
20880 Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} :
20881 Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae}
20882 : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} :
20883 Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai}
20884 : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} :
20885 Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} :
20886 Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber
20887 (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini,
20888 {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} :
20889 Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} :
20890 Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian
20891 (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central
20892 American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages],
20893 {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb}
20894 : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} :
20895 Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} :
20896 Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree,
20897 {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf}
20898 : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based
20899 Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} :
20900 Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} :
20901 Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru)
20902 Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri,
20903 {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch,
20904 {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi}
20905 : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} :
20906 English, {enm} : Old English (1100-1500), {ang} : Old English
20907 (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} :
20908 Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat}
20909 : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} :
20910 Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French
20911 (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} :
20912 Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan,
20913 {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian,
20914 {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High
20915 German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon}
20916 : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient
20917 Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} :
20918 Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian,
20919 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
20920 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
20921 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo,
20922 {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European
20923 (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua
20924 (International Auxiliary Language Association), {ie} : Interlingue, {iu} :
20925 Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} :
20926 Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian
20927 languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} :
20928 Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle,
20929 {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} :
20930 Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar}
20931 : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh,
20932 {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese,
20933 {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz,
20934 {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} :
20935 Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama,
20936 {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} :
20937 Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} :
20938 Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} :
20939 Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban
20940 (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui}
20941 : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai,
20942 {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili,
20943 {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} :
20944 Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} :
20945 Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} :
20946 Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai,
20947 [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} :
20948 Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} :
20949 Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)],
20950 {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple
20951 languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan,
20952 {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele,
20953 {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
20954 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
20955 {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} :
20956 Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} :
20957 Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi}
20958 : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} :
20959 Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
20960 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
20961 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
20962 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
20963 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
20964 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
20965 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
20966 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
20967 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
20968 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
20969 languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} :
20970 Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami,
20971 [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} :
20972 Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak,
20973 {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian,
20974 {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign
20975 Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} :
20976 Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave
20977 (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian,
20978 {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} :
20979 Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} :
20980 South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} :
20981 Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati,
20982 {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} :
20983 Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao,
20984 {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} :
20985 Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} :
20986 Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau,
20987 {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian,
20988 {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} :
20989 Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh}
20990 : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} :
20991 Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian,
20992 {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} :
20993 Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak}
20994 : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was}
20995 : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private
20996 Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} :
20997 Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
20998 : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu,
21003 =item COPYRIGHT AND DISCLAIMER
21009 =head2 I18N::Langinfo - query locale information
21027 =item COPYRIGHT AND LICENSE
21031 =head2 IO - load various IO modules
21043 =head2 IO::Compress::Base - Base Class for IO::Compress modules
21055 =item MODIFICATION HISTORY
21057 =item COPYRIGHT AND LICENSE
21061 =head2 IO::Compress::Base::lib::File::GlobMapper, File::GlobMapper - Extend
21062 File Glob to Allow Input and Output Files
21070 This code is a work in progress, There are known bugs, The interface
21071 defined here is tentative, There are portability issues, Do not use in
21072 production code, Consider yourself warned!
21076 =item Behind The Scenes
21080 =item Input File Glob
21082 B<~>, B<~user>, B<.>, B<*>, B<?>, B<\>, B<[]>, B<{,}>, B<()>
21084 =item Output File Glob
21088 =item Returned Data
21096 =item A Rename script
21098 =item A few example globmaps
21106 =item COPYRIGHT AND LICENSE
21110 =head2 IO::Compress::Base::lib::IO::Compress::Base, IO::Compress::Base -
21111 Base Class for IO::Compress modules
21123 =item MODIFICATION HISTORY
21125 =item COPYRIGHT AND LICENSE
21129 =head2 IO::Compress::Base::lib::IO::Uncompress::AnyUncompress,
21130 IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop
21139 RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip, bzip2, lzop, lzf
21141 =item Functional Interface
21145 =item anyuncompress $input => $output [, OPTS]
21147 A filename, A filehandle, A scalar reference, An array reference, An Input
21148 FileGlob string, A filename, A filehandle, A scalar reference, An Array
21149 Reference, An Output FileGlob
21153 =item Optional Parameters
21155 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
21156 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
21168 A filename, A filehandle, A scalar reference
21170 =item Constructor Options
21172 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
21173 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
21174 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1
21195 =item getHeaderInfo
21209 =item input_line_number
21231 =item MODIFICATION HISTORY
21233 =item COPYRIGHT AND LICENSE
21237 =head2 IO::Compress::Base::lib::IO::Uncompress::Base, IO::Uncompress::Base
21238 - Base Class for IO::Uncompress modules
21250 =item MODIFICATION HISTORY
21252 =item COPYRIGHT AND LICENSE
21256 =head2 IO::Compress::Deflate - Write RFC 1950 files/buffers
21264 =item Functional Interface
21268 =item deflate $input => $output [, OPTS]
21270 A filename, A filehandle, A scalar reference, An array reference, An Input
21271 FileGlob string, A filename, A filehandle, A scalar reference, An Array
21272 Reference, An Output FileGlob
21276 =item Optional Parameters
21278 C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
21290 A filename, A filehandle, A scalar reference
21292 =item Constructor Options
21294 C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
21295 Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >>
21327 =item input_line_number
21333 =item newStream([OPTS])
21335 =item deflateParams
21341 :all, :constants, :flush, :level, :strategy
21349 =item MODIFICATION HISTORY
21351 =item COPYRIGHT AND LICENSE
21355 =head2 IO::Compress::Gzip - Write RFC 1952 files/buffers
21363 =item Functional Interface
21367 =item gzip $input => $output [, OPTS]
21369 A filename, A filehandle, A scalar reference, An array reference, An Input
21370 FileGlob string, A filename, A filehandle, A scalar reference, An Array
21371 Reference, An Output FileGlob
21375 =item Optional Parameters
21377 C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
21389 A filename, A filehandle, A scalar reference
21391 =item Constructor Options
21393 C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
21394 Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Minimal => 0|1 >>,
21395 C<< Comment => $comment >>, C<< Name => $string >>, C<< Time => $number >>,
21396 C<< TextFlag => 0|1 >>, C<< HeaderCRC => 0|1 >>, C<< OS_Code => $value >>,
21397 C<< ExtraField => $data >>, C<< ExtraFlags => $value >>, C<< Strict => 0|1
21430 =item input_line_number
21436 =item newStream([OPTS])
21438 =item deflateParams
21444 :all, :constants, :flush, :level, :strategy
21452 =item MODIFICATION HISTORY
21454 =item COPYRIGHT AND LICENSE
21458 =head2 IO::Compress::RawDeflate - Write RFC 1951 files/buffers
21466 =item Functional Interface
21470 =item rawdeflate $input => $output [, OPTS]
21472 A filename, A filehandle, A scalar reference, An array reference, An Input
21473 FileGlob string, A filename, A filehandle, A scalar reference, An Array
21474 Reference, An Output FileGlob
21478 =item Optional Parameters
21480 C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
21492 A filename, A filehandle, A scalar reference
21494 =item Constructor Options
21496 C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
21497 Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >>
21529 =item input_line_number
21535 =item newStream([OPTS])
21537 =item deflateParams
21543 :all, :constants, :flush, :level, :strategy
21551 =item MODIFICATION HISTORY
21553 =item COPYRIGHT AND LICENSE
21557 =head2 IO::Compress::Zip - Write zip files/buffers
21565 =item Functional Interface
21569 =item zip $input => $output [, OPTS]
21571 A filename, A filehandle, A scalar reference, An array reference, An Input
21572 FileGlob string, A filename, A filehandle, A scalar reference, An Array
21573 Reference, An Output FileGlob
21577 =item Optional Parameters
21579 C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
21591 A filename, A filehandle, A scalar reference
21593 =item Constructor Options
21595 C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
21596 Filehandle, C<< Name => $string >>, C<< Time => $number >>, C<< ExtAttr =>
21597 $attr >>, C<< exTime => [$atime, $mtime, $ctime] >>, C<< Comment =>
21598 $comment >>, C<< ZipComment => $comment >>, C<< Method => $method >>, C<<
21599 Stream => 0|1 >>, C<< Zip64 => 0|1 >>, C<< TextFlag => 0|1 >>, C<<
21600 ExtraFieldLocal => $data >> =item C<< ExtraFieldCentral => $data >>, C<<
21601 Minimal => 1|0 >>, C<< BlockSize100K => number >>, C<< WorkFactor => number
21602 >>, -Level, -Strategy, C<< Strict => 0|1 >>
21634 =item input_line_number
21640 =item newStream([OPTS])
21642 =item deflateParams
21648 :all, :constants, :flush, :level, :strategy, :zip_method
21656 =item MODIFICATION HISTORY
21658 =item COPYRIGHT AND LICENSE
21662 =head2 IO::Compress::Zlib::IO::Compress::Deflate, IO::Compress::Deflate -
21663 Write RFC 1950 files/buffers
21671 =item Functional Interface
21675 =item deflate $input => $output [, OPTS]
21677 A filename, A filehandle, A scalar reference, An array reference, An Input
21678 FileGlob string, A filename, A filehandle, A scalar reference, An Array
21679 Reference, An Output FileGlob
21683 =item Optional Parameters
21685 C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
21697 A filename, A filehandle, A scalar reference
21699 =item Constructor Options
21701 C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
21702 Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >>
21734 =item input_line_number
21740 =item newStream([OPTS])
21742 =item deflateParams
21748 :all, :constants, :flush, :level, :strategy
21756 =item MODIFICATION HISTORY
21758 =item COPYRIGHT AND LICENSE
21762 =head2 IO::Compress::Zlib::IO::Compress::Gzip, IO::Compress::Gzip - Write
21763 RFC 1952 files/buffers
21771 =item Functional Interface
21775 =item gzip $input => $output [, OPTS]
21777 A filename, A filehandle, A scalar reference, An array reference, An Input
21778 FileGlob string, A filename, A filehandle, A scalar reference, An Array
21779 Reference, An Output FileGlob
21783 =item Optional Parameters
21785 C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
21797 A filename, A filehandle, A scalar reference
21799 =item Constructor Options
21801 C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
21802 Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Minimal => 0|1 >>,
21803 C<< Comment => $comment >>, C<< Name => $string >>, C<< Time => $number >>,
21804 C<< TextFlag => 0|1 >>, C<< HeaderCRC => 0|1 >>, C<< OS_Code => $value >>,
21805 C<< ExtraField => $data >>, C<< ExtraFlags => $value >>, C<< Strict => 0|1
21838 =item input_line_number
21844 =item newStream([OPTS])
21846 =item deflateParams
21852 :all, :constants, :flush, :level, :strategy
21860 =item MODIFICATION HISTORY
21862 =item COPYRIGHT AND LICENSE
21866 =head2 IO::Compress::Zlib::IO::Compress::RawDeflate,
21867 IO::Compress::RawDeflate - Write RFC 1951 files/buffers
21875 =item Functional Interface
21879 =item rawdeflate $input => $output [, OPTS]
21881 A filename, A filehandle, A scalar reference, An array reference, An Input
21882 FileGlob string, A filename, A filehandle, A scalar reference, An Array
21883 Reference, An Output FileGlob
21887 =item Optional Parameters
21889 C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
21901 A filename, A filehandle, A scalar reference
21903 =item Constructor Options
21905 C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
21906 Filehandle, C<< Merge => 0|1 >>, -Level, -Strategy, C<< Strict => 0|1 >>
21938 =item input_line_number
21944 =item newStream([OPTS])
21946 =item deflateParams
21952 :all, :constants, :flush, :level, :strategy
21960 =item MODIFICATION HISTORY
21962 =item COPYRIGHT AND LICENSE
21966 =head2 IO::Compress::Zlib::IO::Compress::Zip, IO::Compress::Zip - Write zip
21975 =item Functional Interface
21979 =item zip $input => $output [, OPTS]
21981 A filename, A filehandle, A scalar reference, An array reference, An Input
21982 FileGlob string, A filename, A filehandle, A scalar reference, An Array
21983 Reference, An Output FileGlob
21987 =item Optional Parameters
21989 C<< AutoClose => 0|1 >>, C<< BinModeIn => 0|1 >>, C<< Append => 0|1 >>
22001 A filename, A filehandle, A scalar reference
22003 =item Constructor Options
22005 C<< AutoClose => 0|1 >>, C<< Append => 0|1 >>, A Buffer, A Filename, A
22006 Filehandle, C<< Name => $string >>, C<< Time => $number >>, C<< ExtAttr =>
22007 $attr >>, C<< exTime => [$atime, $mtime, $ctime] >>, C<< Comment =>
22008 $comment >>, C<< ZipComment => $comment >>, C<< Method => $method >>, C<<
22009 Stream => 0|1 >>, C<< Zip64 => 0|1 >>, C<< TextFlag => 0|1 >>, C<<
22010 ExtraFieldLocal => $data >> =item C<< ExtraFieldCentral => $data >>, C<<
22011 Minimal => 1|0 >>, C<< BlockSize100K => number >>, C<< WorkFactor => number
22012 >>, -Level, -Strategy, C<< Strict => 0|1 >>
22044 =item input_line_number
22050 =item newStream([OPTS])
22052 =item deflateParams
22058 :all, :constants, :flush, :level, :strategy, :zip_method
22066 =item MODIFICATION HISTORY
22068 =item COPYRIGHT AND LICENSE
22072 =head2 IO::Compress::Zlib::IO::Uncompress::AnyInflate,
22073 IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip) file/buffer
22081 RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip
22083 =item Functional Interface
22087 =item anyinflate $input => $output [, OPTS]
22089 A filename, A filehandle, A scalar reference, An array reference, An Input
22090 FileGlob string, A filename, A filehandle, A scalar reference, An Array
22091 Reference, An Output FileGlob
22095 =item Optional Parameters
22097 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
22098 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
22110 A filename, A filehandle, A scalar reference
22112 =item Constructor Options
22114 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
22115 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
22116 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1
22117 >>, C<< ParseExtra => 0|1 >> If the gzip FEXTRA header field is present and
22118 this option is set, it will force the module to check that it conforms to
22119 the sub-field structure as defined in RFC 1952
22141 =item getHeaderInfo
22155 =item input_line_number
22177 =item MODIFICATION HISTORY
22179 =item COPYRIGHT AND LICENSE
22183 =head2 IO::Compress::Zlib::IO::Uncompress::Gunzip, IO::Uncompress::Gunzip -
22184 Read RFC 1952 files/buffers
22192 =item Functional Interface
22196 =item gunzip $input => $output [, OPTS]
22198 A filename, A filehandle, A scalar reference, An array reference, An Input
22199 FileGlob string, A filename, A filehandle, A scalar reference, An Array
22200 Reference, An Output FileGlob
22204 =item Optional Parameters
22206 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
22207 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
22219 A filename, A filehandle, A scalar reference
22221 =item Constructor Options
22223 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
22224 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
22225 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< ParseExtra => 0|1
22226 >> If the gzip FEXTRA header field is present and this option is set, it
22227 will force the module to check that it conforms to the sub-field structure
22228 as defined in RFC 1952
22250 =item getHeaderInfo
22266 =item input_line_number
22288 =item MODIFICATION HISTORY
22290 =item COPYRIGHT AND LICENSE
22294 =head2 IO::Compress::Zlib::IO::Uncompress::Inflate, IO::Uncompress::Inflate
22295 - Read RFC 1950 files/buffers
22303 =item Functional Interface
22307 =item inflate $input => $output [, OPTS]
22309 A filename, A filehandle, A scalar reference, An array reference, An Input
22310 FileGlob string, A filename, A filehandle, A scalar reference, An Array
22311 Reference, An Output FileGlob
22315 =item Optional Parameters
22317 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
22318 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
22330 A filename, A filehandle, A scalar reference
22332 =item Constructor Options
22334 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
22335 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
22336 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>
22358 =item getHeaderInfo
22372 =item input_line_number
22394 =item MODIFICATION HISTORY
22396 =item COPYRIGHT AND LICENSE
22400 =head2 IO::Compress::Zlib::IO::Uncompress::RawInflate,
22401 IO::Uncompress::RawInflate - Read RFC 1951 files/buffers
22409 =item Functional Interface
22413 =item rawinflate $input => $output [, OPTS]
22415 A filename, A filehandle, A scalar reference, An array reference, An Input
22416 FileGlob string, A filename, A filehandle, A scalar reference, An Array
22417 Reference, An Output FileGlob
22421 =item Optional Parameters
22423 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
22424 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
22436 A filename, A filehandle, A scalar reference
22438 =item Constructor Options
22440 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
22441 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
22442 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>
22464 =item getHeaderInfo
22478 =item input_line_number
22500 =item MODIFICATION HISTORY
22502 =item COPYRIGHT AND LICENSE
22506 =head2 IO::Compress::Zlib::IO::Uncompress::Unzip, IO::Uncompress::Unzip -
22507 Read zip files/buffers
22515 =item Functional Interface
22519 =item unzip $input => $output [, OPTS]
22521 A filename, A filehandle, A scalar reference, An array reference, An Input
22522 FileGlob string, A filename, A filehandle, A scalar reference, An Array
22523 Reference, An Output FileGlob
22527 =item Optional Parameters
22529 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
22530 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
22542 A filename, A filehandle, A scalar reference
22544 =item Constructor Options
22546 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
22547 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
22548 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>
22570 =item getHeaderInfo
22584 =item input_line_number
22606 =item MODIFICATION HISTORY
22608 =item COPYRIGHT AND LICENSE
22612 =head2 IO::Dir - supply object methods for directory handles
22620 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
22621 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
22631 =head2 IO::File - supply object methods for filehandles
22641 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
22645 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode(
22656 =head2 IO::Handle - supply object methods for I/O handles
22666 new (), new_from_fd ( FD, MODE )
22670 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
22671 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
22672 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
22673 $io->blocking ( [ BOOL ] ), $io->untaint
22685 =head2 IO::Pipe - supply object methods for pipes
22695 new ( [READER, WRITER] )
22699 reader ([ARGS]), writer ([ARGS]), handles ()
22709 =head2 IO::Poll - Object interface to system poll call
22719 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
22720 IO ), handles( [ EVENT_MASK ] )
22730 =head2 IO::Seekable - supply seek based methods for I/O objects
22738 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
22739 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
22748 =head2 IO::Select - OO interface to the select system call
22758 new ( [ HANDLES ] )
22762 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
22763 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
22764 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
22774 =head2 IO::Socket - Object interface to socket communications
22788 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
22789 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
22799 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
22815 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
22828 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
22842 hostpath(), peerpath()
22852 =head2 IO::Uncompress::AnyInflate - Uncompress zlib-based (zip, gzip)
22861 RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip
22863 =item Functional Interface
22867 =item anyinflate $input => $output [, OPTS]
22869 A filename, A filehandle, A scalar reference, An array reference, An Input
22870 FileGlob string, A filename, A filehandle, A scalar reference, An Array
22871 Reference, An Output FileGlob
22875 =item Optional Parameters
22877 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
22878 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
22890 A filename, A filehandle, A scalar reference
22892 =item Constructor Options
22894 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
22895 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
22896 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1
22897 >>, C<< ParseExtra => 0|1 >> If the gzip FEXTRA header field is present and
22898 this option is set, it will force the module to check that it conforms to
22899 the sub-field structure as defined in RFC 1952
22921 =item getHeaderInfo
22935 =item input_line_number
22957 =item MODIFICATION HISTORY
22959 =item COPYRIGHT AND LICENSE
22963 =head2 IO::Uncompress::AnyUncompress - Uncompress gzip, zip, bzip2 or lzop
22972 RFC 1950, RFC 1951 (optionally), gzip (RFC 1952), zip, bzip2, lzop, lzf
22974 =item Functional Interface
22978 =item anyuncompress $input => $output [, OPTS]
22980 A filename, A filehandle, A scalar reference, An array reference, An Input
22981 FileGlob string, A filename, A filehandle, A scalar reference, An Array
22982 Reference, An Output FileGlob
22986 =item Optional Parameters
22988 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
22989 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
23001 A filename, A filehandle, A scalar reference
23003 =item Constructor Options
23005 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
23006 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
23007 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< RawInflate => 0|1
23028 =item getHeaderInfo
23042 =item input_line_number
23064 =item MODIFICATION HISTORY
23066 =item COPYRIGHT AND LICENSE
23070 =head2 IO::Uncompress::Base - Base Class for IO::Uncompress modules
23082 =item MODIFICATION HISTORY
23084 =item COPYRIGHT AND LICENSE
23088 =head2 IO::Uncompress::Gunzip - Read RFC 1952 files/buffers
23096 =item Functional Interface
23100 =item gunzip $input => $output [, OPTS]
23102 A filename, A filehandle, A scalar reference, An array reference, An Input
23103 FileGlob string, A filename, A filehandle, A scalar reference, An Array
23104 Reference, An Output FileGlob
23108 =item Optional Parameters
23110 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
23111 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
23123 A filename, A filehandle, A scalar reference
23125 =item Constructor Options
23127 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
23128 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
23129 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>, C<< ParseExtra => 0|1
23130 >> If the gzip FEXTRA header field is present and this option is set, it
23131 will force the module to check that it conforms to the sub-field structure
23132 as defined in RFC 1952
23154 =item getHeaderInfo
23170 =item input_line_number
23192 =item MODIFICATION HISTORY
23194 =item COPYRIGHT AND LICENSE
23198 =head2 IO::Uncompress::Inflate - Read RFC 1950 files/buffers
23206 =item Functional Interface
23210 =item inflate $input => $output [, OPTS]
23212 A filename, A filehandle, A scalar reference, An array reference, An Input
23213 FileGlob string, A filename, A filehandle, A scalar reference, An Array
23214 Reference, An Output FileGlob
23218 =item Optional Parameters
23220 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
23221 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
23233 A filename, A filehandle, A scalar reference
23235 =item Constructor Options
23237 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
23238 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
23239 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>
23261 =item getHeaderInfo
23275 =item input_line_number
23297 =item MODIFICATION HISTORY
23299 =item COPYRIGHT AND LICENSE
23303 =head2 IO::Uncompress::RawInflate - Read RFC 1951 files/buffers
23311 =item Functional Interface
23315 =item rawinflate $input => $output [, OPTS]
23317 A filename, A filehandle, A scalar reference, An array reference, An Input
23318 FileGlob string, A filename, A filehandle, A scalar reference, An Array
23319 Reference, An Output FileGlob
23323 =item Optional Parameters
23325 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
23326 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
23338 A filename, A filehandle, A scalar reference
23340 =item Constructor Options
23342 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
23343 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
23344 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>
23366 =item getHeaderInfo
23380 =item input_line_number
23402 =item MODIFICATION HISTORY
23404 =item COPYRIGHT AND LICENSE
23408 =head2 IO::Uncompress::Unzip - Read zip files/buffers
23416 =item Functional Interface
23420 =item unzip $input => $output [, OPTS]
23422 A filename, A filehandle, A scalar reference, An array reference, An Input
23423 FileGlob string, A filename, A filehandle, A scalar reference, An Array
23424 Reference, An Output FileGlob
23428 =item Optional Parameters
23430 C<< AutoClose => 0|1 >>, C<< BinModeOut => 0|1 >>, C<< Append => 0|1 >>,
23431 C<< MultiStream => 0|1 >>, C<< TrailingData => $scalar >>
23443 A filename, A filehandle, A scalar reference
23445 =item Constructor Options
23447 C<< AutoClose => 0|1 >>, C<< MultiStream => 0|1 >>, C<< Prime => $string
23448 >>, C<< Transparent => 0|1 >>, C<< BlockSize => $num >>, C<< InputLength =>
23449 $size >>, C<< Append => 0|1 >>, C<< Strict => 0|1 >>
23471 =item getHeaderInfo
23485 =item input_line_number
23507 =item MODIFICATION HISTORY
23509 =item COPYRIGHT AND LICENSE
23513 =head2 IO::Zlib - IO:: style interface to L<Compress::Zlib>
23525 =item OBJECT METHODS
23527 open ( FILENAME, MODE ), opened, close, getc, getline, getlines, print (
23528 ARGS... ), read ( BUF, NBYTES, [OFFSET] ), eof, seek ( OFFSET, WHENCE ),
23529 tell, setpos ( POS ), getpos ( POS )
23531 =item USING THE EXTERNAL GZIP
23533 =item CLASS METHODS
23535 has_Compress_Zlib, gzip_external, gzip_used, gzip_read_open,
23540 IO::Zlib::getlines: must be called in list context,
23541 IO::Zlib::gzopen_external: mode '...' is illegal, IO::Zlib::import: '...'
23542 is illegal, IO::Zlib::import: ':gzip_external' requires an argument,
23543 IO::Zlib::import: 'gzip_read_open' requires an argument, IO::Zlib::import:
23544 'gzip_read' '...' is illegal, IO::Zlib::import: 'gzip_write_open' requires
23545 an argument, IO::Zlib::import: 'gzip_write_open' '...' is illegal,
23546 IO::Zlib::import: no Compress::Zlib and no external gzip, IO::Zlib::open:
23547 needs a filename, IO::Zlib::READ: NBYTES must be specified,
23548 IO::Zlib::WRITE: too long LENGTH, IO::Zlib::WRITE: OFFSET is not supported
23558 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
23567 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
23568 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
23578 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
23588 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
23592 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode(
23603 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
23614 new (), new_from_fd ( FD, MODE )
23618 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
23619 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
23620 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
23621 $io->blocking ( [ BOOL ] ), $io->untaint
23633 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
23643 new ( [READER, WRITER] )
23647 reader ([ARGS]), writer ([ARGS]), handles ()
23657 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
23667 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
23668 IO ), handles( [ EVENT_MASK ] )
23678 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
23687 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
23688 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
23697 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
23708 new ( [ HANDLES ] )
23712 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
23713 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
23714 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
23724 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
23739 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
23740 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
23750 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
23751 AF_INET domain sockets
23767 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
23780 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
23781 AF_UNIX domain sockets
23795 hostpath(), peerpath()
23805 =head2 IPC::Msg - SysV Msg IPC object class
23815 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
23816 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
23827 =head2 IPC::Open2, open2 - open a process for both reading and writing
23841 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
23852 L<IPC::Open2>, L<IPC::Run>
23858 =head2 IPC::Semaphore - SysV Semaphore IPC object class
23868 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
23869 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
23870 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
23881 =head2 IPC::SysV - SysV IPC constants
23899 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
23909 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
23910 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
23921 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
23932 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
23933 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
23934 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
23945 =head2 IPCmd, IPC::Cmd - finding and running system commands made easy
23953 =item CLASS METHODS
23957 =item $bool = IPC::Cmd->can_use_ipc_run( [VERBOSE] )
23965 =item $bool = IPC::Cmd->can_use_ipc_open3( [VERBOSE] )
23971 =item $bool = IPC::Cmd->can_capture_buffer
23981 =item $path = can_run( PROGRAM );
23989 =item $ok | ($ok, $err, $full_buf, $stdout_buff, $stderr_buff) = run(
23990 command => COMMAND, [verbose => BOOL, buffer => \$SCALAR] );
23992 command, verbose, buffer, success, errorcode, full_buffer, out_buffer,
24001 =item Global Variables
24005 =item $IPC::Cmd::VERBOSE
24007 =item $IPC::Cmd::USE_IPC_RUN
24009 =item $IPC::Cmd::USE_IPC_OPEN3
24011 =item $IPC::Cmd::WARN
24017 Whitespace, IO Redirect
24023 =item ACKNOWLEDGEMENTS
24029 =head2 List::Util - A selection of general-utility list subroutines
24037 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
24038 BLOCK LIST, shuffle LIST, sum LIST
24042 =item SUGGESTED ADDITIONS
24050 =head2 List::Utilib::List::Util, List::Util - A selection of
24051 general-utility list subroutines
24059 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
24060 BLOCK LIST, shuffle LIST, sum LIST
24064 =item SUGGESTED ADDITIONS
24072 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
24073 general-utility scalar subroutines
24081 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
24082 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
24083 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
24095 =head2 Locale::Constants - constants for Locale codes
24103 =item KNOWN BUGS AND LIMITATIONS
24107 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
24115 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
24123 B<alpha-2>, B<alpha-3>, B<numeric>
24125 =item CONVERSION ROUTINES
24127 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
24128 country_code2code( CODE, CODESET, CODESET )
24130 =item QUERY ROUTINES
24132 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
24134 =item SEMI-PRIVATE ROUTINES
24140 =item rename_country
24148 =item KNOWN BUGS AND LIMITATIONS
24152 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
24153 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
24154 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
24155 http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
24163 =head2 Locale::Currency - ISO three letter codes for currency
24164 identification (ISO 4217)
24174 =item CONVERSION ROUTINES
24176 code2currency(), currency2code()
24178 =item QUERY ROUTINES
24180 C<all_currency_codes()>, C<all_currency_names()>
24184 =item KNOWN BUGS AND LIMITATIONS
24188 Locale::Country, Locale::Script, ISO 4217:1995,
24189 http://www.bsi-global.com/iso4217currency
24197 =head2 Locale::Language - ISO two letter codes for language identification
24206 =item CONVERSION ROUTINES
24208 code2language(), language2code()
24210 =item QUERY ROUTINES
24212 C<all_language_codes()>, C<all_language_names()>
24216 =item KNOWN BUGS AND LIMITATIONS
24220 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
24221 http://lcweb.loc.gov/standards/iso639-2/langhome.html
24229 =head2 Locale::Maketext - framework for localization
24237 =item QUICK OVERVIEW
24243 =item Construction Methods
24245 =item The "maketext" Method
24247 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
24249 =item Utility Methods
24251 $language->quant($number, $singular), $language->quant($number, $singular,
24252 $plural), $language->quant($number, $singular, $plural, $negative),
24253 $language->numf($number), $language->sprintf($format, @items),
24254 $language->language_tag(), $language->encoding()
24256 =item Language Handle Attributes and Internals
24260 =item LANGUAGE CLASS HIERARCHIES
24262 =item ENTRIES IN EACH LEXICON
24264 =item BRACKET NOTATION
24266 =item AUTO LEXICONS
24268 =item CONTROLLING LOOKUP FAILURE
24270 =item HOW TO USE MAKETEXT
24274 =item COPYRIGHT AND DISCLAIMER
24280 =head2 Locale::Maketext::Simple - Simple interface to
24281 Locale::Maketext::Lexicon
24315 =item ACKNOWLEDGMENTS
24325 =item The "MIT" License
24331 =head2 Locale::Maketext::TPJ13 -- article about software localization
24339 =item Localization and Perl: gettext breaks, Maketext fixes
24343 =item A Localization Horror Story: It Could Happen To You
24345 =item The Linguistic View
24347 =item Breaking gettext
24349 =item Replacing gettext
24351 =item Buzzwords: Abstraction and Encapsulation
24353 =item Buzzword: Isomorphism
24355 =item Buzzword: Inheritance
24357 =item Buzzword: Concision
24359 =item The Devil in the Details
24361 =item The Proof in the Pudding: Localizing Web Sites
24369 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
24377 B<alpha-2>, B<alpha-3>, B<numeric>
24381 =item SPECIAL CODES
24385 =item CONVERSION ROUTINES
24387 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
24388 script_code2code( CODE, CODESET, CODESET )
24390 =item QUERY ROUTINES
24392 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
24396 =item KNOWN BUGS AND LIMITATIONS
24400 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
24401 http://www.evertype.com/standards/iso15924/
24409 =head2 Log::Message - A generic message storing mechanism;
24419 Log::Message, Log::Message::Item, Log::Message::Handlers,
24420 Log::Message::Config
24424 config, private, verbose, tag, level, remove, chrono
24444 message, tag, level, extra
24452 tag, level, message, amount, chrono, remove
24480 =item Acknowledgements
24486 =head2 Log::Message::Config - Configuration options for Log::Message
24498 =item Acknowledgements
24504 =head2 Log::Message::Handlers - Message handlers for Log::Message
24512 =item Default Handlers
24566 =item Custom Handlers
24572 =item Acknowledgements
24578 =head2 Log::Message::Item - Message objects for Log::Message
24586 =item Methods and Accessors
24614 =item Acknowledgements
24620 =head2 Log::Message::Simple
24632 =item msg("message string" [,VERBOSE])
24634 =item debug("message string" [,VERBOSE])
24636 =item error("error string" [,VERBOSE])
24656 =item CLASS METHODS
24660 =item Log::Message::Simple->stack()
24662 =item Log::Message::Simple->stack_as_string([TRACE])
24664 =item Log::Message::Simple->flush()
24672 =item GLOBAL VARIABLES
24674 $ERROR_FH, $MSG_FH, $DEBUG_FH, $STACKTRACE_ON_ERROR
24678 =head2 MIME::Base64 - Encoding and decoding of base64 strings
24686 encode_base64($str), encode_base64($str, $eol);, decode_base64($str)
24690 Premature end of base64 data, Premature padding of base64 data, Wide
24691 character in subroutine entry
24701 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
24702 of quoted-printable strings
24710 encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode),
24719 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
24728 encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode),
24737 =head2 Math::BigFloat - Arbitrary size floating point math package
24747 =item Canonical notation
24751 =item C<mantissa()>, C<exponent()> and C<parts()>
24753 =item Accuracy vs. Precision
24757 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround ( +$scale
24758 ), fround ( -$scale ) and fround ( 0 )
24772 =item Autocreating constants
24778 =item Using Math::BigInt::Lite
24786 stringify, bstr(), bdiv, brsft, Modifying and =, bpow, precision() vs.
24797 =head2 Math::BigInt - Arbitrary size integer/float math package
24835 =item is_one()/is_zero()/is_nan()/is_inf()
24837 =item is_pos()/is_neg()/is_positive()/is_negative()
24839 $x->is_pos(); # true if > 0
24840 $x->is_neg(); # true if < 0
24842 =item is_odd()/is_even()/is_int()
24922 =item as_int()/as_number()
24936 =item upgrade()/downgrade()
24944 =item ACCURACY and PRECISION
24954 =item Rounding mode R
24956 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', 'common', Precision,
24957 Accuracy (significant digits), Setting/Accessing, Creating numbers, Usage,
24958 Precedence, Overriding globals, Local settings, Rounding, Default values,
24963 =item Infinity and Not a Number
24965 oct()/hex(), log(-inf), exp(), cos(), sin(), atan2()
24975 =item mantissa(), exponent() and parts()
24983 =item Autocreating constants
24989 =item Alternative math libraries
24995 =item Subclassing Math::BigInt
25003 bsqrt(), div(), blog(), bexp()
25009 broot() does not work, Out of Memory!, Fails to load Calc on Perl prior
25014 bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling,
25015 Modifying and =, bpow, Overloading -$x, Mixing different object types,
25026 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
25038 =item WRAP YOUR OWN
25042 This program is free software; you may redistribute it and/or modify it
25044 the same terms as Perl itself.
25052 =head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code
25074 This program is free software; you may redistribute it and/or modify it
25076 the same terms as Perl itself.
25084 =head2 Math::BigInt::FastCalc - Math::BigInt::Calc with some XS for more
25099 This program is free software; you may redistribute it and/or modify it
25101 the same terms as Perl itself.
25109 =head2 Math::BigRat - Arbitrary big rational numbers
25131 =item denominator()
25133 $d = $x->denominator();
25139 =item as_int()/as_number()
25147 =item from_hex()/from_bin()/from_oct()
25159 =item bround()/round()/bfround()
25169 =item is_pos()/is_positive()
25171 =item is_neg()/is_negative()
25193 =item badd()/bmul()/bsub()/bdiv()/bdec()/binc()
25197 =item bstr()/bsstr()
25199 =item bacmp()/bcmp()
25201 =item blsft()/brsft()
25211 inf handling (partial), NaN handling (partial), rounding (not implemented
25212 except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(),
25213 blog(), bmodinv() and bmodpow() (partial)
25223 =head2 Math::Complex - complex numbers and associated mathematical
25240 =item CHANGED IN PERL 5.6
25252 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
25254 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
25262 =head2 Math::Trig - trigonometric functions
25270 =item TRIGONOMETRIC FUNCTIONS
25276 =item ERRORS DUE TO DIVISION BY ZERO
25278 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
25282 =item PLANE ANGLE CONVERSIONS
25284 deg2rad, grad2rad, rad2deg, grad2deg, deg2grad, rad2grad, rad2rad, deg2deg,
25287 =item RADIAL COORDINATE CONVERSIONS
25291 =item COORDINATE SYSTEMS
25293 =item 3-D ANGLE CONVERSIONS
25295 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
25296 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
25300 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
25304 =item great_circle_distance
25306 =item great_circle_direction
25308 =item great_circle_bearing
25310 =item great_circle_destination
25312 =item great_circle_midpoint
25314 =item great_circle_waypoint
25322 =item CAVEAT FOR GREAT CIRCLE FORMULAS
25332 =head2 Memoize - Make functions faster by trading space for time
25350 =item C<SCALAR_CACHE>, C<LIST_CACHE>
25352 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
25356 =item OTHER FACILITIES
25362 =item C<flush_cache>
25368 =item PERSISTENT CACHE SUPPORT
25370 =item EXPIRATION SUPPORT
25378 =item COPYRIGHT AND LICENSE
25384 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
25393 =head2 Memoize::Expire - Plug-in module for automatic expiration of
25404 TIEHASH, EXISTS, STORE
25416 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
25424 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
25432 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
25441 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
25450 =head2 Memoize::Storable - store Memoized data in Storable database
25458 =head2 Module::Build - Build and install Perl modules
25466 =item GUIDE TO DOCUMENTATION
25468 General Usage (L<Module::Build>), Authoring Reference
25469 (L<Module::Build::Authoring>), API Reference (L<Module::Build::API>),
25470 Cookbook (L<Module::Build::Cookbook>)
25474 build, clean, code, config_data, diff, dist, distcheck, distclean, distdir,
25475 distmeta, distsign, disttest, docs, fakeinstall, help, html, install,
25476 manifest, manpages, pardist, ppd, ppmdist, prereq_report, pure_install,
25477 realclean, retest, skipcheck, test, testall, testcover, testdb, testpod,
25478 testpodcoverage, versioninstall
25484 =item Command Line Options
25486 quiet, use_rcfile, verbose, allow_mb_mismatch
25488 =item Default Options File (F<.modulebuildrc>)
25492 =item INSTALL PATHS
25494 lib, arch, script, bin, bindoc, libdoc, binhtml, libhtml, installdirs,
25495 install_path, install_base, destdir, prefix
25511 =head2 Module::Build::API - API Reference for Module Authors
25521 current(), new(), add_to_cleanup, auto_features, autosplit, build_class,
25522 build_requires, create_packlist, c_source, conflicts, create_makefile_pl,
25523 create_readme, dist_abstract, dist_author, dist_name, dist_version,
25524 dist_version_from, dynamic_config, extra_compiler_flags,
25525 extra_linker_flags, get_options, type, store, default, include_dirs,
25526 install_path, installdirs, license, apache, artistic, bsd, gpl, lgpl, mit,
25527 mozilla, open_source, perl, restrictive, unrestricted, meta_add,
25528 meta_merge, module_name, PL_files, pm_files, pod_files, recommends,
25529 recursive_test_files, requires, script_files, sign, test_files, xs_files,
25530 new_from_context(%args), resume(), subclass()
25534 add_build_element($type), add_to_cleanup(@files), args(),
25535 autosplit_file($from, $to), base_dir(), build_requires(),
25536 check_installed_status($module, $version), check_installed_version($module,
25537 $version), compare_versions($v1, $op, $v2), config($key), config($key,
25538 $value), config() [deprecated], config_data($name), config_data($name =>
25539 $value), conflicts(), contains_pod($file), copy_if_modified(%parameters),
25540 create_build_script(), current_action(), depends_on(@actions),
25541 dir_contains($first_dir, $second_dir), dispatch($action, %args),
25542 dist_dir(), dist_name(), dist_version(), do_system($cmd, @args),
25543 feature($name), feature($name => $value), have_c_compiler(),
25544 install_base_relpaths(), install_base_relpaths($type),
25545 install_base_relpaths($type => $path), install_destination($type),
25546 install_path(), install_path($type), install_path($type => $path),
25547 install_types(), invoked_action(), notes(), notes($key), notes($key =>
25548 $value), orig_dir(), os_type(), prefix_relpaths(),
25549 prefix_relpaths($installdirs), prefix_relpaths($installdirs, $type),
25550 prefix_relpaths($installdirs, $type => $path), prepare_metadata(),
25551 prereq_failures(), prereq_report(), prompt($message, $default),
25552 recommends(), requires(), rscan_dir($dir, $pattern), runtime_params(),
25553 runtime_params($key), script_files(), up_to_date($source_file,
25554 $derived_file), up_to_date(\@source_files, \@derived_files), y_n($message,
25557 =item Autogenerated Accessors
25559 PL_files(), allow_mb_mismatch(), autosplit(), base_dir(), bindoc_dirs(),
25560 blib(), build_bat(), build_class(), build_elements(), build_requires(),
25561 build_script(), c_source(), config_dir(), conflicts(),
25562 create_makefile_pl(), create_packlist(), create_readme(), debugger(),
25563 destdir(), get_options(), html_css(), include_dirs(), install_base(),
25564 install_sets(), installdirs(), libdoc_dirs(), license(), magic_number(),
25565 mb_version(), meta_add(), meta_merge(), metafile(), module_name(),
25566 orig_dir(), original_prefix(), perl(), pm_files(), pod_files(), pollute(),
25567 prefix(), prereq_action_types(), quiet(), recommends(), recurse_into(),
25568 recursive_test_files(), requires(), scripts(), use_rcfile(), verbose(),
25581 =head2 Module::Build::Authoring - Authoring Module::Build modules
25591 =item PREREQUISITES
25595 =item Format of prerequisites
25599 =item SAVING CONFIGURATION INFORMATION
25601 =item STARTING MODULE DEVELOPMENT
25613 =head2 Module::Build::Base - Default methods for Module::Build
25629 =head2 Module::Build::Compat - Compatibility with ExtUtils::MakeMaker
25639 create_makefile_pl($style, $build), small, passthrough, traditional,
25640 run_build_pl(args => \@ARGV), args, script, write_makefile(), makefile
25652 =head2 Module::Build::ConfigData - Configuration for Module::Build
25662 config($name), feature($name), set_config($name, $value),
25663 set_feature($name, $value), config_names(), feature_names(),
25664 auto_feature_names(), write()
25670 =head2 Module::Build::Cookbook - Examples of Module::Build Usage
25676 =item BASIC RECIPES
25680 =item The basic installation recipe for modules that use Module::Build
25682 =item Making a CPAN.pm-compatible distribution
25684 =item Installing modules using the programmatic interface
25686 =item Installing to a temporary directory
25688 =item Installing to a non-standard directory
25690 =item Installing in the same location as ExtUtils::MakeMaker
25692 =item Running a single test file
25696 =item ADVANCED RECIPES
25700 =item Changing the order of the build process
25702 =item Adding new file types to the build process
25704 =item Adding new elements to the install process
25708 =item EXAMPLES ON CPAN
25712 =item SVN-Notify-Mirror
25714 1. Using C<auto_features>, I check to see whether two optional modules are
25715 available - SVN::Notify::Config and Net::SSH;, 2. If the S::N::Config
25716 module is loaded, I automatically generate testfiles for it during Build
25717 (using the C<PL_files> property), 3. If the C<ssh_feature> is available, I
25718 ask if the user wishes to perform the ssh tests (since it requires a little
25719 preliminary setup);, 4. Only if the user has C<ssh_feature> and answers yes
25720 to the testing, do I generate a test file
25722 =item Modifying an action
25734 =head2 Module::Build::ModuleInfo, ModuleInfo - Gather package and POD
25735 information from a perl module files
25741 new_from_file($filename, collect_pod => 1), new_from_module($module,
25742 collect_pod => 1, inc => \@dirs), name(), version($package), filename(),
25743 packages_inside(), pod_inside(), contains_pod(), pod($section),
25744 find_module_by_name($module, \@dirs), find_module_dir_by_name($module,
25755 =head2 Module::Build::Notes, $notes_name - Configuration for $module_name
25765 config(\$name), feature(\$name), set_config(\$name, \$value),
25766 set_feature(\$name, \$value), config_names(), feature_names(),
25767 auto_feature_names(), write()
25773 =head2 Module::Build::PPMMaker - Perl Package Manager file creation
25789 =head2 Module::Build::Platform::Amiga - Builder class for Amiga platforms
25801 =head2 Module::Build::Platform::Default - Stub class for unknown platforms
25813 =head2 Module::Build::Platform::EBCDIC - Builder class for EBCDIC platforms
25825 =head2 Module::Build::Platform::MPEiX - Builder class for MPEiX platforms
25837 =head2 Module::Build::Platform::MacOS - Builder class for MacOS platforms
25845 =item Overriden Methods
25847 new(), make_executable(), dispatch(), ACTION_realclean()
25857 =head2 Module::Build::Platform::RiscOS - Builder class for RiscOS platforms
25869 =head2 Module::Build::Platform::Unix - Builder class for Unix platforms
25881 =head2 Module::Build::Platform::VMS - Builder class for VMS platforms
25889 =item Overridden Methods
25921 =head2 Module::Build::Platform::VOS - Builder class for VOS platforms
25933 =head2 Module::Build::Platform::Windows - Builder class for Windows
25946 =head2 Module::Build::Platform::aix - Builder class for AIX platform
25958 =head2 Module::Build::Platform::cygwin - Builder class for Cygwin platform
25970 =head2 Module::Build::Platform::darwin - Builder class for Mac OS X
25983 =head2 Module::Build::Platform::os2 - Builder class for OS/2 platform
25995 =head2 Module::Build::YAML - Provides just enough YAML support so that
25996 Module::Build works even if YAML.pm is not installed
26010 =head2 Module::CoreList - what modules shipped with versions of perl
26030 =head2 Module::Load - runtime require of both modules and files
26048 =head2 Module::Load::Conditional - Looking up module information / loading
26059 =item $href = check_install( module => NAME [, version => VERSION, verbose
26062 module, version, verbose, file, version, uptodate
26068 =item $bool = can_load( modules => { NAME => VERSION [,NAME => VERSION] },
26069 [verbose => BOOL, nocache => BOOL] )
26071 modules, verbose, nocache
26077 =item @list = requires( MODULE );
26083 =item Global Variables
26087 =item $Module::Load::Conditional::VERBOSE
26089 =item $Module::Load::Conditional::FIND_VERSION
26091 =item $Module::Load::Conditional::CHECK_INC_HASH
26093 =item $Module::Load::Conditional::CACHE
26095 =item $Module::Load::Conditional::ERROR
26107 =head2 Module::Loaded - mark modules as loaded or unloaded
26119 =item $bool = mark_as_loaded( PACKAGE );
26127 =item $bool = mark_as_unloaded( PACKAGE );
26133 =item $loc = is_loaded( PACKAGE );
26145 =head2 Module::Pluggable - automatically give your module the ability to
26156 =item ADVANCED USAGE
26158 =item INNER PACKAGES
26206 =head2 Module::Pluggable::Object - automatically give your module the
26207 ability to have plugins
26225 =head2 NDBM_File - Tied access to ndbm files
26233 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
26239 =item C<ndbm store returned -1, errno 22, key "..." at ...>
26243 =item BUGS AND WARNINGS
26247 =head2 NEXT - Provide a pseudo-class NEXT (et al) that allows method
26258 =item Enforcing redispatch
26260 =item Avoiding repetitions
26262 =item Invoking all versions of a method with a single call
26264 =item Using C<EVERY> methods
26270 =item BUGS AND IRRITATIONS
26276 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
26286 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
26289 =item CLASS METHODS
26291 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
26292 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
26293 ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh ()
26303 =head2 Net::Config - Local configuration data for libnet
26313 requires_firewall HOST
26315 =item NetConfig VALUES
26317 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
26318 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
26319 ftp_int_passive, local_netmask, test_hosts, test_exists
26323 =head2 Net::Domain - Attempt to evaluate the current host's internet name
26332 hostfqdn (), domainname (), hostname (), hostdomain ()
26340 =head2 Net::FTP - FTP Client class
26352 new ([ HOST ] [, OPTIONS ])
26356 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
26357 site (ARGS), ascii, binary, rename ( OLDNAME, NEWNAME ), delete ( FILENAME
26358 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR [,
26359 RECURSE ]), mkdir ( DIR [, RECURSE ]), alloc ( SIZE [, RECORD_SIZE] ), ls (
26360 [ DIR ] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ),
26361 put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE
26362 ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ),
26363 size ( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[
26364 BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ DIR ] ), retr ( FILE ),
26365 stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [ PORT ] ), pasv (),
26366 pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_xfer_unique (
26367 SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( NON_PASV_SERVER ),
26372 =item Methods for the adventurous
26378 =item THE dataconn CLASS
26380 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
26381 bytes_read (), abort (), close ()
26383 =item UNIMPLEMENTED
26385 B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
26387 =item REPORTING BUGS
26395 http://www.csh.rit.edu/~adam/Progs/
26403 =head2 Net::NNTP - NNTP Client class
26413 new ( [ HOST ] [, OPTIONS ])
26417 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
26418 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
26419 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
26420 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
26421 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
26422 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
26423 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
26427 =item Extension methods
26429 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
26430 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
26431 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
26432 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
26441 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
26451 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
26461 new ( [ HOST ] [, OPTIONS ] 0
26465 auth ( USERNAME, PASSWORD ), user ( USER ), pass ( PASS ), login ( [ USER
26466 [, PASS ]] ), apop ( [ USER [, PASS ]] ), banner (), capa (), capabilities
26467 (), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [, FH ]
26468 ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ]
26469 ), delete ( MSGNUM ), reset (), quit ()
26481 =head2 Net::Ping - check a remote host for reachability
26493 Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos
26494 ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
26495 $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
26496 $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
26497 [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host
26514 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
26526 new ( [ HOST ] [, OPTIONS ] )
26530 banner (), domain (), hello ( DOMAIN ), host (), etrn ( DOMAIN ), auth (
26531 USERNAME, PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ),
26532 send_or_mail ( ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient (
26533 ADDRESS [, ADDRESS, [...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]]
26534 ), cc ( ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ),
26535 data ( [ DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [
26536 $subject ] ), quit ()
26548 =head2 Net::Time - time and daytime network client interface
26556 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
26557 PROTOCOL [, TIMEOUT]]])
26565 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
26582 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
26590 =item Where to get this document
26592 =item How to contribute to this document
26596 =item Author and Copyright Information
26604 =item Obtaining and installing libnet
26608 =item What is libnet ?
26610 =item Which version of perl do I need ?
26612 =item What other modules do I need ?
26614 =item What machines support libnet ?
26616 =item Where can I get the latest libnet release
26620 =item Using Net::FTP
26624 =item How do I download files from an FTP server ?
26626 =item How do I transfer files in binary mode ?
26628 =item How can I get the size of a file on a remote FTP server ?
26630 =item How can I get the modification time of a file on a remote FTP server
26633 =item How can I change the permissions of a file on a remote server ?
26635 =item Can I do a reget operation like the ftp command ?
26637 =item How do I get a directory listing from an FTP server ?
26639 =item Changing directory to "" does not fail ?
26641 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
26643 =item I am behind an FTP proxy firewall, but cannot access machines outside
26646 =item My ftp proxy firewall does not listen on port 21
26648 =item Is it possible to change the file permissions of a file on an FTP
26651 =item I have seen scripts call a method message, but cannot find it
26654 =item Why does Net::FTP not implement mput and mget methods
26658 =item Using Net::SMTP
26662 =item Why can't the part of an Email address after the @ be used as the
26665 =item Why does Net::SMTP not do DNS MX lookups ?
26667 =item The verify method always returns true ?
26671 =item Debugging scripts
26675 =item How can I debug my scripts that use Net::* modules ?
26679 =item AUTHOR AND COPYRIGHT
26683 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
26700 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
26715 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
26732 =head2 Netrc, Net::Netrc - OO interface to users netrc file
26740 =item THE .netrc FILE
26742 machine name, default, login name, password string, account string, macdef
26747 lookup ( MACHINE [, LOGIN ])
26751 login (), password (), account (), lpa ()
26761 =head2 O - Generic interface to Perl Compiler backends
26771 =item IMPLEMENTATION
26779 =head2 ODBM_File - Tied access to odbm files
26787 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
26793 =item C<odbm store returned -1, errno 22, key "..." at ...>
26797 =item BUGS AND WARNINGS
26801 =head2 Object::Accessor
26813 =item $object = Object::Accessor->new( [ARGS] );
26821 =item $bool = $object->mk_accessors( @ACCESSORS | \%ACCESSOR_MAP );
26827 =item @list = $self->ls_accessors;
26833 =item $ref = $self->ls_allow(KEY)
26839 =item $clone = $self->mk_clone;
26845 =item $bool = $self->mk_flush;
26851 =item $bool = $self->mk_verify;
26857 =item $bool = $self->register_callback( sub { ... } );
26863 =item $bool = $self->can( METHOD_NAME )
26869 =item $val = $self->___get( METHOD_NAME );
26875 =item $bool = $self->___set( METHOD_NAME => VALUE );
26881 =item LVALUE ACCESSORS
26887 Allow handlers, Callbacks
26895 =item GLOBAL VARIABLES
26899 =item $Object::Accessor::FATAL
26901 =item $Object::Accessor::DEBUG
26909 =item Create read-only accessors
26921 =head2 Opcode - Disable named opcodes when compiling perl code
26933 =item Operator Names and Operator Lists
26935 an operator name (opname), an operator tag name (optag), a negated opname
26936 or optag, an operator set (opset)
26938 =item Opcode Functions
26940 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
26941 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
26942 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
26945 =item Manipulating Opsets
26947 =item TO DO (maybe)
26953 =item Predefined Opcode Tags
26955 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
26956 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
26957 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
26966 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
26975 a new namespace, an operator mask
26981 =item RECENT CHANGES
26983 =item Methods in class Safe
26985 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
26986 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
26987 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
26988 root (NAMESPACE), mask (MASK)
26990 =item Some Safety Issues
26992 Memory, CPU, Snooping, Signals, State Changes
27000 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
27013 =head2 POSIX - Perl interface to IEEE Std 1003.1
27027 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
27028 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
27029 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
27030 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
27031 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
27032 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
27033 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
27034 fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv,
27035 geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid,
27036 getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha,
27037 isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace,
27038 isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime,
27039 log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr,
27040 memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice,
27041 offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc,
27042 putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename,
27043 rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid,
27044 setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
27045 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
27046 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
27047 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
27048 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
27049 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
27050 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
27051 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
27058 =item POSIX::SigAction
27060 new, handler, mask, flags, safe
27064 %SIGRT, SIGRTMIN, SIGRTMAX
27066 =item POSIX::SigSet
27068 new, addset, delset, emptyset, fillset, ismember
27070 =item POSIX::Termios
27072 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
27073 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
27074 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
27075 field values, c_cflag field values, c_iflag field values, c_lflag field
27076 values, c_oflag field values
27080 =item PATHNAME CONSTANTS
27084 =item POSIX CONSTANTS
27088 =item SYSTEM CONFIGURATION
27142 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
27143 WTERMSIG, WIFSTOPPED, WSTOPSIG
27147 =head2 Package::Constants - List all constants declared in a package
27155 =item CLASS METHODS
27159 =item @const = Package::Constants->list( PACKAGE_NAME );
27167 =item GLOBAL VARIABLES
27171 =item $Package::Constants::DEBUG
27185 =head2 Params::Check - A generic input parsing/checking mechanism.
27195 default, required, strict_type, defined, no_override, store, allow
27201 =item check( \%tmpl, \%args, [$verbose] );
27203 Template, Arguments, Verbose
27211 =item allow( $test_me, \@criteria );
27213 string, regexp, subroutine, array ref
27225 =item Global Variables
27229 =item $Params::Check::VERBOSE
27231 =item $Params::Check::STRICT_TYPE
27233 =item $Params::Check::ALLOW_UNKNOWN
27235 =item $Params::Check::STRIP_LEADING_DASHES
27237 =item $Params::Check::NO_DUPLICATES
27239 =item $Params::Check::PRESERVE_CASE
27241 =item $Params::Check::ONLY_ALLOW_DEFINED
27243 =item $Params::Check::SANITY_CHECK_TEMPLATE
27245 =item $Params::Check::WARNINGS_FATAL
27247 =item $Params::Check::CALLER_DEPTH
27253 =item Acknowledgements
27259 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
27268 :unix, :stdio, :perlio, :crlf, :mmap, :utf8, :bytes, :raw, :pop, :win32
27272 =item Custom Layers
27276 =item Alternatives to raw
27278 =item Defaults and how to override them
27280 =item Querying the layers of filehandles
27290 =head2 PerlIO::encoding - encoding layer
27302 =head2 PerlIO::scalar - in-memory IO, scalar IO
27310 =item IMPLEMENTATION NOTE
27314 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
27322 =item EXPECTED METHODS
27324 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
27325 $obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]),
27326 $obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]),
27327 $obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh),
27328 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
27329 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
27330 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
27331 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
27337 =item Example - a Hexadecimal Handle
27343 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
27351 =item REQUIRED MODULES
27355 =item ACKNOWLEDGEMENTS
27361 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
27367 =item OPTIONS/ARGUMENTS
27373 B<-warnings> =E<gt> I<val>
27385 empty =headn, =over on line I<N> without closing =back, =item without
27386 previous =over, =back without previous =over, No argument for =begin, =end
27387 without =begin, Nested =begin's, =for without formatter specification,
27388 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
27389 interior-sequence "I<SEQ>", nested commands
27390 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
27391 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
27392 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
27397 multiple occurrence of link target I<name>, line containing nothing but
27398 whitespace in paragraph, file does not start with =head, previous =item has
27399 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
27400 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
27401 items in =over, No argument for =item, empty section in previous paragraph,
27402 Verbatim paragraph in NAME section, =headI<n> without preceding higher
27407 ignoring leading/trailing whitespace in link, (section) in '$page'
27408 deprecated, alternative text/node '%s' contains non-escaped | or /
27420 C<Pod::Checker-E<gt>new( %options )>
27422 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
27425 C<$checker-E<gt>num_errors()>
27427 C<$checker-E<gt>num_warnings()>
27429 C<$checker-E<gt>name()>
27431 C<$checker-E<gt>node()>
27433 C<$checker-E<gt>idx()>
27435 C<$checker-E<gt>hyperlink()>
27443 =head2 Pod::Escapes -- for resolving Pod EE<lt>...E<gt> sequences
27453 e2char($e_content), e2charnum($e_content), $Name2character{I<name>},
27454 $Name2character_number{I<name>}, $Latin1Code_to_fallback{I<integer>},
27455 $Latin1Char_to_fallback{I<character>}, $Code2USASCII{I<integer>}
27461 =item COPYRIGHT AND DISCLAIMERS
27467 =head2 Pod::Find - find POD documents in directory trees
27479 =item C<pod_find( { %opts } , @directories )>
27481 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
27488 =item C<simplify_name( $str )>
27494 =item C<pod_where( { %opts }, $pod )>
27496 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
27503 =item C<contains_pod( $file , $verbose )>
27515 =head2 Pod::Html - module to convert pod files to HTML
27529 backlink, cachedir, css, flush, header, help, hiddendirs, htmldir,
27530 htmlroot, index, infile, libpods, netscape, outfile, podpath, podroot,
27531 quiet, recurse, title, verbose
27549 =head2 Pod::InputObjects - objects representing POD input paragraphs,
27562 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
27563 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
27569 =item B<Pod::InputSource>
27593 =item B<was_cutting()>
27599 =item B<Pod::Paragraph>
27605 =item Pod::Paragraph-E<gt>B<new()>
27611 =item $pod_para-E<gt>B<cmd_name()>
27617 =item $pod_para-E<gt>B<text()>
27623 =item $pod_para-E<gt>B<raw_text()>
27629 =item $pod_para-E<gt>B<cmd_prefix()>
27635 =item $pod_para-E<gt>B<cmd_separator()>
27641 =item $pod_para-E<gt>B<parse_tree()>
27647 =item $pod_para-E<gt>B<file_line()>
27653 =item B<Pod::InteriorSequence>
27659 =item Pod::InteriorSequence-E<gt>B<new()>
27665 =item $pod_seq-E<gt>B<cmd_name()>
27671 =item $pod_seq-E<gt>B<prepend()>
27677 =item $pod_seq-E<gt>B<append()>
27683 =item $pod_seq-E<gt>B<nested()>
27689 =item $pod_seq-E<gt>B<raw_text()>
27695 =item $pod_seq-E<gt>B<left_delimiter()>
27701 =item $pod_seq-E<gt>B<right_delimiter()>
27707 =item $pod_seq-E<gt>B<parse_tree()>
27713 =item $pod_seq-E<gt>B<file_line()>
27719 =item Pod::InteriorSequence::B<DESTROY()>
27725 =item B<Pod::ParseTree>
27731 =item Pod::ParseTree-E<gt>B<new()>
27737 =item $ptree-E<gt>B<top()>
27743 =item $ptree-E<gt>B<children()>
27749 =item $ptree-E<gt>B<prepend()>
27755 =item $ptree-E<gt>B<append()>
27761 =item $ptree-E<gt>B<raw_text()>
27767 =item Pod::ParseTree::B<DESTROY()>
27779 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
27791 =item OBJECT METHODS
27799 =item Data Accessors
27815 B<ReplaceNAMEwithSection>
27817 B<StartWithNewPage>
27831 =item Subclassed methods
27845 B<interior_sequence>
27861 =item Methods for headings
27869 =item Internal methods
27875 B<_replace_special_chars>
27877 B<_replace_special_chars_late>
27883 B<_clean_latex_commands>
27885 B<_split_delimited>
27901 =head2 Pod::Man - Convert POD data to formatted *roff input
27909 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
27914 roff font should be 1 or 2 chars, not "%s", Invalid quote specification
27923 =item COPYRIGHT AND LICENSE
27929 =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
27941 =item COPYRIGHT AND LICENSE
27945 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
27959 Pod::List-E<gt>new()
27967 $list-E<gt>indent()
27975 $list-E<gt>parent()
27981 =item Pod::Hyperlink
27983 Pod::Hyperlink-E<gt>new()
27987 $link-E<gt>parse($string)
27989 $link-E<gt>markup($string)
27993 $link-E<gt>warning()
27995 $link-E<gt>file(), $link-E<gt>line()
28001 $link-E<gt>alttext()
28011 Pod::Cache-E<gt>new()
28017 $cache-E<gt>find_page($name)
28021 =item Pod::Cache::Item
28023 Pod::Cache::Item-E<gt>new()
28027 $cacheitem-E<gt>page()
28029 $cacheitem-E<gt>description()
28031 $cacheitem-E<gt>path()
28033 $cacheitem-E<gt>file()
28035 $cacheitem-E<gt>nodes()
28037 $cacheitem-E<gt>find_node($name)
28039 $cacheitem-E<gt>idx()
28049 =head2 Pod::Parser - base class for creating POD filters and translators
28061 =item QUICK OVERVIEW
28063 =item PARSING OPTIONS
28065 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
28066 B<-warnings> (default: unset)
28072 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
28080 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
28086 =item B<verbatim()>
28088 C<$text>, C<$line_num>, C<$pod_para>
28094 =item B<textblock()>
28096 C<$text>, C<$line_num>, C<$pod_para>
28102 =item B<interior_sequence()>
28108 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
28120 =item B<initialize()>
28126 =item B<begin_pod()>
28132 =item B<begin_input()>
28138 =item B<end_input()>
28150 =item B<preprocess_line()>
28156 =item B<preprocess_paragraph()>
28162 =item METHODS FOR PARSING AND PROCESSING
28168 =item B<parse_text()>
28170 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
28171 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
28172 I<code-ref>|I<method-name>
28178 =item B<interpolate()>
28184 =item B<parse_paragraph()>
28190 =item B<parse_from_filehandle()>
28196 =item B<parse_from_file()>
28202 =item ACCESSOR METHODS
28208 =item B<errorsub()>
28220 =item B<parseopts()>
28226 =item B<output_file()>
28232 =item B<output_handle()>
28238 =item B<input_file()>
28244 =item B<input_handle()>
28250 =item B<input_streams()>
28256 =item B<top_stream()>
28262 =item PRIVATE METHODS AND DATA
28268 =item B<_push_input_stream()>
28274 =item B<_pop_input_stream()>
28280 =item TREE-BASED PARSING
28290 =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors
28300 =item COPYRIGHT AND DISCLAIMERS
28306 =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages
28318 =item COPYRIGHT AND DISCLAIMERS
28324 =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff
28336 =item COPYRIGHT AND DISCLAIMERS
28342 =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod!
28352 =item COPYRIGHT AND DISCLAIMERS
28358 =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF
28368 =item COPYRIGHT AND DISCLAIMERS
28374 =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext
28386 =item COPYRIGHT AND DISCLAIMERS
28392 =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod
28406 =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML
28416 =item COPYRIGHT AND DISCLAIMERS
28422 =head2 Pod::PlainText - Convert POD data to formatted ASCII text
28430 alt, indent, loose, sentence, width
28434 Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
28435 Unknown sequence: %s, Unmatched =back
28447 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
28467 =head2 Pod::Select, podselect() - extract selected sections of POD from
28480 =item SECTION SPECIFICATIONS
28482 =item RANGE SPECIFICATIONS
28488 =item OBJECT METHODS
28494 =item B<curr_headings()>
28506 =item B<add_selection()>
28512 =item B<clear_selections()>
28518 =item B<match_section()>
28524 =item B<is_selected()>
28530 =item EXPORTED FUNCTIONS
28536 =item B<podselect()>
28538 B<-output>, B<-sections>, B<-ranges>
28544 =item PRIVATE METHODS AND DATA
28550 =item B<_compile_section_spec()>
28556 =item $self->{_SECTION_HEADINGS}
28562 =item $self->{_SELECTED_SECTIONS}
28574 =head2 Pod::Simple - framework for parsing Pod
28584 C<< $parser = I<SomeClass>->new(); >>, C<< $parser->output_fh( *OUT ); >>,
28585 C<< $parser->output_string( \$somestring ); >>, C<< $parser->parse_file(
28586 I<$some_filename> ); >>, C<< $parser->parse_file( *INPUT_FH ); >>, C<<
28587 $parser->parse_string_document( I<$all_content> ); >>, C<<
28588 $parser->parse_lines( I<...@lines...>, undef ); >>, C<<
28589 $parser->content_seen >>, C<< I<SomeClass>->filter( I<$filename> ); >>, C<<
28590 I<SomeClass>->filter( I<*INPUT_FH> ); >>, C<< I<SomeClass>->filter(
28591 I<\$document_content> ); >>
28593 =item SECONDARY METHODS
28595 C<< $parser->no_whining( I<SOMEVALUE> ) >>, C<< $parser->no_errata_section(
28596 I<SOMEVALUE> ) >>, C<< $parser->complain_stderr( I<SOMEVALUE> ) >>, C<<
28597 $parser->source_filename >>, C<< $parser->doc_has_started >>, C<<
28598 $parser->source_dead >>
28604 =item COPYRIGHT AND DISCLAIMERS
28610 =head2 Pod::Simple::Checker -- check the Pod syntax of a document
28620 =item COPYRIGHT AND DISCLAIMERS
28626 =head2 Pod::Simple::Debug -- put Pod::Simple into trace/debug mode
28640 =item COPYRIGHT AND DISCLAIMERS
28646 =head2 Pod::Simple::DumpAsText -- dump Pod-parsing events as text
28656 =item COPYRIGHT AND DISCLAIMERS
28662 =head2 Pod::Simple::DumpAsXML -- turn Pod into XML
28672 =item COPYRIGHT AND DISCLAIMERS
28678 =head2 Pod::Simple::HTML - convert Pod to HTML
28686 =item CALLING FROM THE COMMAND LINE
28688 =item CALLING FROM PERL
28696 =item COPYRIGHT AND DISCLAIMERS
28702 =head2 Pod::Simple::HTMLBatch - convert several Pod files to several HTML
28713 =item FROM THE COMMAND LINE
28719 $batchconv = Pod::Simple::HTMLBatch->new;, $batchconv->batch_convert(
28720 I<indirs>, I<outdir> );, $batchconv->batch_convert( undef , ...);,
28721 $batchconv->batch_convert( q{@INC}, ...);, $batchconv->batch_convert(
28722 \@dirs , ...);, $batchconv->batch_convert( "somedir" , ...);,
28723 $batchconv->batch_convert( 'somedir:someother:also' , ...);,
28724 $batchconv->batch_convert( ... , undef );, $batchconv->batch_convert( ... ,
28729 =item ACCESSOR METHODS
28731 $batchconv->verbose( I<nonnegative_integer> );, $batchconv->index(
28732 I<true-or-false> );, $batchconv->contents_file( I<filename> );,
28733 $batchconv->contents_page_start( I<HTML_string> );,
28734 $batchconv->contents_page_end( I<HTML_string> );, $batchconv->add_css( $url
28735 );, $batchconv->add_javascript( $url );, $batchconv->css_flurry(
28736 I<true-or-false> );, $batchconv->javascript_flurry( I<true-or-false> );,
28737 $batchconv->no_contents_links( I<true-or-false> );,
28738 $batchconv->html_render_class( I<classname> );
28742 =item NOTES ON CUSTOMIZATION
28748 =item COPYRIGHT AND DISCLAIMERS
28754 =head2 Pod::Simple::LinkSection -- represent "section" attributes of L
28765 =item COPYRIGHT AND DISCLAIMERS
28771 =head2 Pod::Simple::Methody -- turn Pod::Simple events into method calls
28779 =item METHOD CALLING
28783 =item COPYRIGHT AND DISCLAIMERS
28789 =head2 Pod::Simple::PullParser -- a pull-parser interface to parsing Pod
28799 my $token = $parser->get_token, $parser->unget_token( $token ),
28800 $parser->unget_token( $token1, $token2, ... ), $parser->set_source(
28801 $filename ), $parser->set_source( $filehandle_object ),
28802 $parser->set_source( \$document_source ), $parser->set_source(
28803 \@document_lines ), $parser->parse_file(...),
28804 $parser->parse_string_document(...), $parser->filter(...),
28805 $parser->parse_from_file(...), my $title_string = $parser->get_title, my
28806 $title_string = $parser->get_short_title, $author_name =
28807 $parser->get_author, $description_name = $parser->get_description,
28808 $version_block = $parser->get_version
28814 =item COPYRIGHT AND DISCLAIMERS
28820 =head2 Pod::Simple::PullParserEndToken -- end-tokens from
28821 Pod::Simple::PullParser
28829 $token->tagname, $token->tagname(I<somestring>), $token->tag(...),
28830 $token->is_tag(I<somestring>) or $token->is_tagname(I<somestring>)
28834 =item COPYRIGHT AND DISCLAIMERS
28840 =head2 Pod::Simple::PullParserStartToken -- start-tokens from
28841 Pod::Simple::PullParser
28849 $token->tagname, $token->tagname(I<somestring>), $token->tag(...),
28850 $token->is_tag(I<somestring>) or $token->is_tagname(I<somestring>),
28851 $token->attr(I<attrname>), $token->attr(I<attrname>, I<newvalue>),
28856 =item COPYRIGHT AND DISCLAIMERS
28862 =head2 Pod::Simple::PullParserTextToken -- text-tokens from
28863 Pod::Simple::PullParser
28871 $token->text, $token->text(I<somestring>), $token->text_r()
28875 =item COPYRIGHT AND DISCLAIMERS
28881 =head2 Pod::Simple::PullParserToken -- tokens from Pod::Simple::PullParser
28889 $token->type, $token->is_start, $token->is_text, $token->is_end,
28894 =item COPYRIGHT AND DISCLAIMERS
28900 =head2 Pod::Simple::RTF -- format Pod as RTF
28908 =item FORMAT CONTROL ATTRIBUTES
28910 $parser->head1_halfpoint_size( I<halfpoint_integer> );,
28911 $parser->head2_halfpoint_size( I<halfpoint_integer> );,
28912 $parser->head3_halfpoint_size( I<halfpoint_integer> );,
28913 $parser->head4_halfpoint_size( I<halfpoint_integer> );,
28914 $parser->codeblock_halfpoint_size( I<halfpoint_integer> );,
28915 $parser->header_halfpoint_size( I<halfpoint_integer> );,
28916 $parser->normal_halfpoint_size( I<halfpoint_integer> );,
28917 $parser->no_proofing_exemptions( I<true_or_false> );, $parser->doc_lang(
28918 I<microsoft_decimal_language_code> )
28922 =item COPYRIGHT AND DISCLAIMERS
28928 =head2 Pod::Simple::Search - find POD documents in directory trees
28940 $search->inc( I<true-or-false> );, $search->verbose( I<nonnegative-number>
28941 );, $search->limit_glob( I<some-glob-string> );, $search->callback(
28942 I<\&some_routine> );, $search->laborious( I<true-or-false> );,
28943 $search->shadows( I<true-or-false> );, $search->limit_re( I<some-regxp> );,
28944 $search->dir_prefix( I<some-string-value> );, $search->progress(
28945 I<some-progress-object> );, $name2path = $self->name2path;, $path2name =
28948 =item MAIN SEARCH METHODS
28952 =item C<< $search->survey( @directories ) >>
28954 C<name2path>, C<path2name>
28956 =item C<< $search->simplify_name( $str ) >>
28958 =item C<< $search->find( $pod ) >>
28960 =item C<< $search->find( $pod, @search_dirs ) >>
28962 =item C<< $self->contains_pod( $file ) >>
28972 =head2 Pod::Simple::Subclassing -- write a formatter as a Pod::Simple
28983 C<< $parser->_handle_element_start( I<element_name>, I<attr_hashref> ) >>,
28984 C<< $parser->_handle_element_end( I<element_name> ) >>, C<<
28985 $parser->_handle_text( I<text_string> ) >>, events with an element_name
28986 of Document, events with an element_name of Para, events with an
28987 element_name of B, C, F, or I, events with an element_name of S, events
28988 with an element_name of X, events with an element_name of L, events with an
28989 element_name of E or Z, events with an element_name of Verbatim, events
28990 with an element_name of head1 .. head4, events with an element_name of
28991 over-bullet, events with an element_name of over-number, events with an
28992 element_name of over-text, events with an element_name of over-block,
28993 events with an element_name of item-bullet, events with an element_name of
28994 item-number, events with an element_name of item-text, events with an
28995 element_name of for, events with an element_name of Data
28997 =item More Pod::Simple Methods
28999 C<< $parser->accept_targets( I<SOMEVALUE> ) >>, C<<
29000 $parser->accept_targets_as_text( I<SOMEVALUE> ) >>, C<<
29001 $parser->accept_codes( I<Codename>, I<Codename>... ) >>, C<<
29002 $parser->accept_directive_as_data( I<directive_name> ) >>, C<<
29003 $parser->accept_directive_as_verbatim( I<directive_name> ) >>, C<<
29004 $parser->accept_directive_as_processed( I<directive_name> ) >>, C<<
29005 $parser->nbsp_for_S( I<BOOLEAN> ); >>, C<< $parser->version_report() >>,
29006 C<< $parser->pod_para_count() >>, C<< $parser->line_count() >>, C<<
29007 $parser->nix_X_codes( I<SOMEVALUE> ) >>, C<< $parser->merge_text(
29008 I<SOMEVALUE> ) >>, C<< $parser->code_handler( I<CODE_REF> ) >>, C<<
29009 $parser->cut_handler( I<CODE_REF> ) >>, C<< $parser->whine(
29010 I<linenumber>, I<complaint string> ) >>, C<< $parser->scream(
29011 I<linenumber>, I<complaint string> ) >>, C<< $parser->source_dead(1) >>,
29012 C<< $parser->hide_line_numbers( I<SOMEVALUE> ) >>, C<< $parser->no_whining(
29013 I<SOMEVALUE> ) >>, C<< $parser->no_errata_section( I<SOMEVALUE> ) >>, C<<
29014 $parser->complain_stderr( I<SOMEVALUE> ) >>, C<< $parser->bare_output(
29015 I<SOMEVALUE> ) >>, C<< $parser->preserve_whitespace( I<SOMEVALUE> ) >>
29019 =item COPYRIGHT AND DISCLAIMERS
29025 =head2 Pod::Simple::Text -- format Pod as plaintext
29035 =item COPYRIGHT AND DISCLAIMERS
29041 =head2 Pod::Simple::TextContent -- get the text content of Pod
29051 =item COPYRIGHT AND DISCLAIMERS
29057 =head2 Pod::Simple::XMLOutStream -- turn Pod into XML
29067 =item ABOUT EXTENDING POD
29071 =item COPYRIGHT AND DISCLAIMERS
29077 =head2 Pod::SimpleTree, Pod::Simple::SimpleTree -- parse Pod into a simple
29088 =item Tree Contents
29092 =item COPYRIGHT AND DISCLAIMERS
29098 =head2 Pod::Text - Convert POD data to formatted ASCII text
29106 alt, code, indent, loose, margin, quotes, sentence, width
29110 Bizarre space in item, Item called without tag, Can't open %s for reading:
29111 %s, Invalid quote specification "%s"
29119 =item COPYRIGHT AND LICENSE
29123 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
29137 =item COPYRIGHT AND LICENSE
29141 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
29156 =item COPYRIGHT AND LICENSE
29160 =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
29175 =item COPYRIGHT AND LICENSE
29179 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
29188 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-sections>, C<-output>,
29189 C<-input>, C<-pathlist>, C<-noperldoc>
29197 =item Recommended Use
29205 =item ACKNOWLEDGMENTS
29209 =head2 SDBM_File - Tied access to sdbm files
29217 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
29223 =item C<sdbm store returned -1, errno 22, key "..." at ...>
29227 =item BUGS AND WARNINGS
29231 =head2 Safe - Compile and execute code in restricted compartments
29239 a new namespace, an operator mask
29245 =item RECENT CHANGES
29247 =item Methods in class Safe
29249 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
29250 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
29251 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
29252 root (NAMESPACE), mask (MASK)
29254 =item Some Safety Issues
29256 Memory, CPU, Snooping, Signals, State Changes
29264 =head2 Scalar::Util - A selection of general-utility scalar subroutines
29272 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
29273 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
29274 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
29286 =head2 Search::Dict, look - search for key in dictionary file
29296 =head2 SelectSaver - save and restore selected file handle
29306 =head2 SelfLoader - load functions only on demand
29316 =item The __DATA__ token
29318 =item SelfLoader autoloading
29320 =item Autoloading and package lexicals
29322 =item SelfLoader and AutoLoader
29324 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
29326 =item Classes and inherited methods.
29330 =item Multiple packages and fully qualified subroutine names
29336 =head2 Shell - run shell commands transparently within perl
29348 =item Escaping Magic Characters
29350 =item Configuration
29360 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
29361 socket.h defines and structure manipulators
29369 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
29370 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
29371 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
29372 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
29373 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
29377 =head2 Storable - persistence for Perl data structures
29387 =item ADVISORY LOCKING
29391 =item CANONICAL REPRESENTATION
29393 =item CODE REFERENCES
29395 =item FORWARD COMPATIBILITY
29397 utf8 data, restricted hashes, files from future versions of Storable
29399 =item ERROR REPORTING
29407 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
29408 I<serialized>, .., C<STORABLE_attach> I<class>, I<cloning>, I<serialized>
29412 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
29413 C<Storable::is_retrieving>
29421 =item Storable magic
29423 $info = Storable::file_magic( $filename ), C<version>, C<version_nv>,
29424 C<major>, C<minor>, C<hdrsize>, C<netorder>, C<byteorder>, C<intsize>,
29425 C<longsize>, C<ptrsize>, C<nvsize>, C<file>, $info = Storable::read_magic(
29426 $buffer ), $info = Storable::read_magic( $buffer, $must_be_file )
29436 =item 64 bit data in perl 5.6.0 and 5.6.1
29448 =head2 Switch - A switch statement for Perl
29462 =item Allowing fall-through
29464 =item Automating fall-through
29466 =item Alternative syntax
29468 =item Higher-order Operations
29484 =head2 Symbol - manipulate Perl symbols and their names
29496 =head2 Sys::Hostname - Try every conceivable way to get hostname
29508 =head2 Syslog, Sys::Syslog - Perl interface to the UNIX syslog(3) calls
29522 B<openlog($ident, $logopt, $facility)>, B<syslog($priority, $message)>,
29523 B<syslog($priority, $format, @args)>, B<Note>,
29524 B<setlogmask($mask_priority)>, B<setlogsock($sock_type)>,
29525 B<setlogsock($sock_type, $stream_location)> (added in Perl 5.004_02),
29526 B<Note>, B<closelog()>
29542 Invalid argument passed to setlogsock, no connection to syslog available,
29543 stream passed to setlogsock, but %s is not writable, stream passed to
29544 setlogsock, but could not find any device, tcp passed to setlogsock, but
29545 tcp service unavailable, syslog: expecting argument %s, syslog: invalid
29546 level/facility: %s, syslog: too many levels given: %s, syslog: too many
29547 facilities given: %s, syslog: level must be given, udp passed to
29548 setlogsock, but udp service unavailable, unix passed to setlogsock, but
29559 AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request
29560 tracker, Search CPAN, Kobes' CPAN Search, Perl Documentation
29566 =head2 Syslog::Syslog, Sys::Syslog - Perl interface to the UNIX syslog(3)
29581 B<openlog($ident, $logopt, $facility)>, B<syslog($priority, $message)>,
29582 B<syslog($priority, $format, @args)>, B<Note>,
29583 B<setlogmask($mask_priority)>, B<setlogsock($sock_type)>,
29584 B<setlogsock($sock_type, $stream_location)> (added in Perl 5.004_02),
29585 B<Note>, B<closelog()>
29601 Invalid argument passed to setlogsock, no connection to syslog available,
29602 stream passed to setlogsock, but %s is not writable, stream passed to
29603 setlogsock, but could not find any device, tcp passed to setlogsock, but
29604 tcp service unavailable, syslog: expecting argument %s, syslog: invalid
29605 level/facility: %s, syslog: too many levels given: %s, syslog: too many
29606 facilities given: %s, syslog: level must be given, udp passed to
29607 setlogsock, but udp service unavailable, unix passed to setlogsock, but
29618 AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request
29619 tracker, Search CPAN, Kobes' CPAN Search, Perl Documentation
29625 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
29635 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
29636 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
29637 comma allowed after filehandle, No name for escape sequence %s
29641 ANSI_COLORS_DISABLED
29651 =item COPYRIGHT AND LICENSE
29655 =head2 Term::Cap - Perl termcap interface
29671 B<Tgetent>, OSPEED, TERM
29673 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
29675 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
29677 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
29685 =item COPYRIGHT AND LICENSE
29693 =head2 Term::Complete - Perl word completion module
29701 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
29711 =head2 Term::ReadLine - Perl interface to various C<readline> packages.
29712 If no real package is found, substitutes stubs instead of basic functions.
29720 =item Minimal set of supported functions
29722 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>,
29723 C<findConsole>, Attribs, C<Features>
29725 =item Additional supported functions
29727 C<tkRunning>, C<ornaments>, C<newTTY>
29737 =head2 Term::UI - Term::ReadLine UI made easy
29751 =item $reply = $term->get_reply( prompt => 'question?', [choices => \@list,
29752 default => $list[0], multi => BOOL, print_me => "extra text to print &
29753 record", allow => $ref] );
29761 =item $bool = $term->ask_yn( prompt => "your question", [default =>
29762 (y|1,n|0), print_me => "extra text to print & record"] )
29768 =item ($opts, $munged) = $term->parse_options( STRING );
29774 =item $str = $term->history_as_string
29780 =item GLOBAL VARIABLES
29784 =item $Term::UI::VERBOSE
29786 =item $Term::UI::AUTOREPLY
29788 =item $Term::UI::INVALID
29790 =item $Term::UI::History::HISTORY_FH
29798 =item Basic get_reply sample
29800 =item get_reply with choices
29802 =item get_reply with choices and default
29804 =item get_reply using print_me & multi
29806 =item get_reply & allow
29808 =item an elaborate ask_yn sample
29820 =head2 Term::UI::History, Log::Message::Simple
29832 =item history("message string" [,VERBOSE])
29840 =item GLOBAL VARIABLES
29852 =head2 Test - provides a simple framework for writing test scripts
29860 =item QUICK START GUIDE
29866 C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>,
29867 C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub>
29877 C<skip(I<skip_if_true>, I<args...>)>
29883 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
29887 =item BUGS and CAVEATS
29899 =head2 Test::Builder - Backend for building test libraries
29923 =item Setting up tests
29941 =item Running tests
29947 B<is_eq>, B<is_num>
29949 B<isnt_eq>, B<isnt_num>
29957 =item Other Testing Methods
29971 =item Test building utility methods
29991 B<no_diag>, B<no_ending>, B<no_header>
30005 B<output>, B<failure_output>, B<todo_output>
30011 =item Test Status and Info
30047 =head2 Test::Builder::Module - Base class for test modules
30069 =head2 Test::Builder::Tester - test testsuites that have been built with
30092 test_test, title (synonym 'name', 'label'), skip_out, skip_err
30110 =head2 Test::Builder::Tester::Color - turn on colour in
30111 Test::Builder::Tester
30131 =head2 Test::Harness - Run Perl standard test scripts with statistics
30149 =item Configuration variables.
30151 C<$Test::Harness::Verbose>, C<$Test::Harness::switches>,
30152 C<$Test::Harness::Timer>
30156 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<List of Failed>
30164 =item runtests( @test_files )
30172 =item execute_tests( tests => \@test_files, out => \*FH )
30182 C<All tests successful.\nFiles=%d, Tests=%d, %s>, C<FAILED tests
30183 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
30184 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
30185 %s>, C<FAILED--Further testing stopped: %s>
30187 =item ENVIRONMENT VARIABLES THAT TEST::HARNESS SETS
30189 C<HARNESS_ACTIVE>, C<HARNESS_VERSION>
30191 =item ENVIRONMENT VARIABLES THAT AFFECT TEST::HARNESS
30193 C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>, C<HARNESS_DEBUG>,
30194 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_NOTTY>, C<HARNESS_PERL>,
30195 C<HARNESS_PERL_SWITCHES>, C<HARNESS_TIMER>, C<HARNESS_VERBOSE>,
30196 C<HARNESS_STRAP_CLASS>
30208 AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request
30209 tracker, Search CPAN
30219 =head2 Test::Harness::Assert - simple assert
30245 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
30263 =head2 Test::Harness::Point - object for tracking a single test point
30281 =item from_test_line( $line )
30293 =head2 Test::Harness::Results - object for tracking results from a single
30318 =head2 Test::Harness::Straps - detailed analysis of test results
30342 =item $strap->analyze( $name, \@output_lines )
30350 =item $strap->analyze_file( $test_file )
30370 =head2 Test::Harness::TAP - Documentation for the TAP format
30378 =item THE TAP FORMAT
30380 =item HARNESS BEHAVIOR
30382 =item TESTS LINES AND THE PLAN
30388 =item The test line
30390 C<ok> or C<not ok>, Test number, Description, Directive, ok/not ok
30391 (required), Test number (recommended), Description (recommended), Directive
30392 (only when necessary)
30402 =item Skipping tests
30414 =item Anything else
30422 =item Common with explanation
30424 =item Unknown amount and failures
30428 =item Skipping a few
30430 =item Skipping everything
30432 =item Got spare tuits?
30434 =item Creative liberties
30444 Specify a test plan, Run tests, Skip tests in certain situations, Have TODO
30445 tests, Produce TAP compatible diagnostics
30453 phpt, PHPUnit, SimpleTest, Apache-Test
30459 =item ACKNOWLEDGEMENTS
30465 =head2 Test::Harness::Util - Utility functions for Test::Harness::*
30471 =item PUBLIC FUNCTIONS
30475 =item all_in( {parm => value, parm => value} )
30485 =item shuffle( @list )
30495 =head2 Test::More - yet another framework for writing test scripts
30505 =item I love it when a plan comes together
30515 =item I'm ok, you're not ok.
30547 =item Complex data structures
30563 =item Conditional tests
30569 B<TODO: BLOCK>, B<todo_skip>
30571 When do I use SKIP vs. TODO?
30583 =item Discouraged comparison functions
30595 =item Extending and Embedding Test::More
30605 =item CAVEATS and NOTES
30607 Backwards compatibility, Overloaded objects, Threads, Test::Harness upgrade
30621 =head2 Test::Simple - Basic utilities for writing tests.
30645 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
30654 =head2 Test::Tutorial - A tutorial about writing really basic tests
30662 =item Nuts and bolts of testing.
30664 =item Where to start?
30668 =item Test the manual
30670 =item Sometimes the tests are wrong
30672 =item Testing lots of values
30674 =item Informative names
30676 =item Skipping tests
30680 =item Testing with taint mode.
30692 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
30704 =head2 Text::Balanced - Extract delimited text sequences from strings.
30714 =item General behaviour in list contexts
30718 =item General behaviour in scalar and void contexts
30720 =item A note about prefixes
30722 =item C<extract_delimited>
30724 =item C<extract_bracketed>
30726 =item C<extract_variable>
30730 =item C<extract_tagged>
30732 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
30733 [0], [1], [2], [3], [4], [5]
30735 =item C<gen_extract_tagged>
30737 =item C<extract_quotelike>
30739 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
30741 =item C<extract_quotelike> and "here documents"
30743 [0], [1], [2], [3], [4], [5], [6], [7..10]
30745 =item C<extract_codeblock>
30747 =item C<extract_multiple>
30749 =item C<gen_delimited_pat>
30751 =item C<delimited_pat>
30757 C<Did not find a suitable bracket: "%s">, C<Did not find prefix: /%s/>,
30758 C<Did not find opening bracket after prefix: "%s">, C<No quotelike
30759 operator found after prefix: "%s">, C<Unmatched closing bracket: "%c">,
30760 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
30761 C<Did not find closing delimiter to match '%s'>, C<Mismatched closing
30762 bracket: expected "%c" but found "%s">, C<No block delimiter found after
30763 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
30764 after dereferencer>, C<Did not find expected opening bracket at %s>,
30765 C<Improperly nested codeblock at %s>, C<Missing second block for quotelike
30766 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
30767 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
30768 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
30773 =item BUGS AND IRRITATIONS
30779 =head2 Text::ParseWords - parse text into an array of tokens or array of
30794 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
30813 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
30828 =head2 Text::Wrap - line wrapping to form simple paragraphs
30844 =head2 Thread - manipulate threads in Perl (for old code only)
30856 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
30857 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
30858 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
30862 join, eval, detach, equal, tid, flags, done
30870 =head2 Thread::Queue - thread-safe queues
30878 =item FUNCTIONS AND METHODS
30880 new, enqueue LIST, dequeue, dequeue_nb, pending
30886 =head2 Thread::Semaphore - thread-safe semaphores
30894 =item FUNCTIONS AND METHODS
30896 new, new NUMBER, down, down NUMBER, up, up NUMBER
30900 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
30915 =head2 Thread::Specific - thread-specific keys
30925 =head2 Tie::Array - base class for tied arrays
30933 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
30934 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
30935 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
30936 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
30944 =head2 Tie::File - Access the lines of a disk file via a Perl array
30964 =item Option Format
30968 =item Public Methods
30976 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
30982 =item Tying to an already-opened filehandle
30984 =item Deferred Writing
30988 =item Autodeferring
30992 =item CONCURRENT ACCESS TO FILES
30998 =item WHAT ABOUT C<DB_File>?
31012 =head2 Tie::Handle, Tie::StdHandle - base class definitions for tied
31021 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
31022 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
31023 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
31024 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
31026 =item MORE INFORMATION
31028 =item COMPATIBILITY
31032 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
31041 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
31042 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR
31045 =item Inheriting from B<Tie::StdHash>
31047 =item Inheriting from B<Tie::ExtraHash>
31049 =item C<SCALAR>, C<UNTIE> and C<DESTROY>
31051 =item MORE INFORMATION
31055 =head2 Tie::Hash::NamedCapture - Named regexp capture buffers
31067 =head2 Tie::Memoize - add data to hash when needed
31075 =item Inheriting from B<Tie::Memoize>
31085 =head2 Tie::RefHash - use references as hash keys
31095 =item THREAD SUPPORT
31097 =item STORABLE SUPPORT
31099 =item RELIC SUPPORT
31109 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
31118 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
31120 =item MORE INFORMATION
31124 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
31136 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
31145 gettimeofday (), usleep ( $useconds ), nanosleep ( $nanoseconds ), ualarm (
31146 $useconds [, $interval_useconds ] ), tv_interval, time (), sleep (
31147 $floating_seconds ), alarm ( $floating_seconds [,
31148 $interval_floating_seconds ] ), setitimer ( $which, $floating_seconds [,
31149 $interval_floating_seconds ] ), getitimer ( $which ), clock_gettime (
31150 $which ), clock_getres ( $which ), clock_nanosleep ( $which, $nanoseconds,
31151 $flags = 0), clock(), stat, stat FH, stat EXPR
31161 =item useconds or interval more than ...
31163 =item negative time not invented yet
31165 =item internal error: useconds < 0 (unsigned ... signed ...)
31175 =item COPYRIGHT AND LICENSE
31179 =head2 Time::Local - efficiently compute time from local and GMT time
31191 =item Year Value Interpretation
31193 =item Limits of time_t
31195 =item Ambiguous Local Times (DST)
31197 =item Non-Existent Local Times (DST)
31199 =item Negative Epoch Values
31203 =item IMPLEMENTATION
31213 =head2 Time::Piece - Object Oriented time objects
31225 =item Local Locales
31227 =item Date Calculations
31229 =item Date Comparisons
31233 =item YYYY-MM-DDThh:mm:ss
31237 =item Global Overriding
31251 =head2 Time::Piece::Seconds, Time::Seconds - a simple API to convert
31252 seconds to other date values
31270 =head2 Time::Seconds - a simple API to convert seconds to other date values
31288 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
31303 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
31318 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
31330 =head2 UNIVERSAL - base class for ALL classes (blessed references)
31338 C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<< eval { VAL->isa(
31339 TYPE ) } >>, C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->DOES( ROLE ) >>,
31340 C<< CLASS->DOES( ROLE ) >>, C<< $obj->can( METHOD ) >>, C<< CLASS->can(
31341 METHOD ) >>, C<< eval { VAL->can( METHOD ) } >>, C<VERSION ( [ REQUIRE ] )>
31347 =head2 Unicode::Collate - Unicode Collation Algorithm
31357 =item Constructor and Tailoring
31359 UCA_Version, alternate, backwards, entry, hangul_terminator, ignoreChar,
31360 ignoreName, katakana_before_hiragana, level, normalization, overrideCJK,
31361 overrideHangul, preprocess, rearrange, table, undefChar, undefName,
31362 upper_before_lower, variable
31364 =item Methods for Collation
31366 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
31367 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
31368 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
31369 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
31370 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
31371 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
31372 $Collator-E<gt>viewSortKey($string)>
31374 =item Methods for Searching
31376 C<$position = $Collator-E<gt>index($string, $substring[, $position])>,
31377 C<($position, $length) = $Collator-E<gt>index($string, $substring[,
31378 $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>,
31379 C<($match) = $Collator-E<gt>match($string, $substring)>, C<@match =
31380 $Collator-E<gt>gmatch($string, $substring)>, C<$count =
31381 $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count =
31382 $Collator-E<gt>gsubst($string, $substring, $replacement)>
31384 =item Other Methods
31386 C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, C<$version =
31387 $Collator-E<gt>version()>, C<UCA_Version()>, C<Base_Unicode_Version()>
31397 Normalization, Conformance Test
31399 =item AUTHOR, COPYRIGHT AND LICENSE
31403 Unicode Collation Algorithm - UTS #10, The Default Unicode Collation
31404 Element Table (DUCET), The conformance test for the UCA, Hangul Syllable
31405 Type, Unicode Normalization Forms - UAX #15
31409 =head2 Unicode::Normalize - Unicode Normalization Forms
31419 =item Normalization Forms
31421 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
31422 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
31423 C<$FCD_string = FCD($string)>, C<$FCC_string = FCC($string)>,
31424 C<$normalized_string = normalize($form_name, $string)>
31426 =item Decomposition and Composition
31428 C<$decomposed_string = decompose($string [, $useCompatMapping])>,
31429 C<$reordered_string = reorder($string)>, C<$composed_string =
31434 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
31435 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
31436 checkFCD($string)>, C<$result = checkFCC($string)>, C<$result =
31437 check($form_name, $string)>
31439 =item Character Data
31441 C<$canonical_decomposition = getCanon($code_point)>,
31442 C<$compatibility_decomposition = getCompat($code_point)>,
31443 C<$code_point_composite = getComposite($code_point_here,
31444 $code_point_next)>, C<$combining_class = getCombinClass($code_point)>,
31445 C<$may_be_composed_with_prev_char = isComp2nd($code_point)>,
31446 C<$is_exclusion = isExclusion($code_point)>, C<$is_singleton =
31447 isSingleton($code_point)>, C<$is_non_starter_decomposition =
31448 isNonStDecomp($code_point)>, C<$is_Full_Composition_Exclusion =
31449 isComp_Ex($code_point)>, C<$NFD_is_NO = isNFD_NO($code_point)>,
31450 C<$NFC_is_NO = isNFC_NO($code_point)>, C<$NFC_is_MAYBE =
31451 isNFC_MAYBE($code_point)>, C<$NFKD_is_NO = isNFKD_NO($code_point)>,
31452 C<$NFKC_is_NO = isNFKC_NO($code_point)>, C<$NFKC_is_MAYBE =
31453 isNFKC_MAYBE($code_point)>
31461 Perl's version vs. Unicode version, Correction of decomposition mapping,
31462 Revised definition of canonical composition
31468 http://www.unicode.org/reports/tr15/,
31469 http://www.unicode.org/Public/UNIDATA/CompositionExclusions.txt,
31470 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt,
31471 http://www.unicode.org/Public/UNIDATA/NormalizationCorrections.txt,
31472 http://www.unicode.org/review/pr-29.html, http://www.unicode.org/notes/tn5/
31476 =head2 Unicode::UCD - Unicode character database
31518 =item Blocks versus Scripts
31520 =item Matching Scripts and Blocks
31522 =item Code Point Arguments
31554 =item Unicode::UCD::UnicodeVersion
31560 =item Implementation Note
31572 =head2 User::grent - by-name interface to Perl's built-in getgr*()
31587 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
31598 =item System Specifics
31612 =head2 Win32 - Interfaces to some Win32 API Functions
31620 =item Alphabetical Listing of Win32 Functions
31622 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
31623 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
31624 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
31625 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
31626 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFileVersion(FILENAME),
31627 Win32::GetFolderPath(FOLDER [, CREATE]), Win32::GetFullPathName(FILENAME),
31628 Win32::GetLastError(), Win32::GetLongPathName(PATHNAME),
31629 Win32::GetNextAvailDrive(), Win32::GetOSVersion(), Win32::GetOSName(),
31630 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
31631 PROCNAME), Win32::GetTickCount(), Win32::GuidGen(), Win32::IsAdminUser(),
31632 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
31633 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
31634 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
31635 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
31636 Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
31637 Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
31638 Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
31639 Win32::UnregisterServer(LIBRARYNAME)
31645 =head2 Win32API::File - Low-level access to Win32 system API calls for
31656 =item Object Oriented/Tied Handle Interface
31660 C<":Func">, attrLetsToBits, C<$uBits= attrLetsToBits( $sAttributeLetters
31661 )>, C<"a">, C<"c">, C<"h">, C<"o">, C<"r">, C<"s">, C<"t">, createFile,
31662 C<$hObject= createFile( $sPath )>, C<$hObject= createFile( $sPath,
31663 $rvhvOptions )>, C<$hObject= createFile( $sPath, $svAccess )>, C<$hObject=
31664 createFile( $sPath, $svAccess, $rvhvOptions )>, C<$hObject= createFile(
31665 $sPath, $svAccess, $svShare )>, C<$hObject= createFile( $sPath, $svAccess,
31666 $svShare, $rvhvOptions )>, C<"q">, C<"r">, C<"w">, C<"k">, C<"t">, C<"n">,
31667 C<"c">, C<"e">, C<"kc">, C<"ke">, C<"tc">, C<"te">, C<"nc">, C<"ne">, Flags
31668 => $uFlags, Attributes => $sAttributes, Security => $pSecurityAttributes,
31669 Model => $hModelFile, Access => $sAccess, Access => $uAccess, Create =>
31670 $sCreate, Create => $uCreate, Share => $sShare, Share => $uShare,
31671 getLogicalDrives, C<@roots= getLogicalDrives()>, CloseHandle,
31672 C<CloseHandle( $hObject )>, CopyFile, C<CopyFile( $sOldFileName,
31673 $sNewFileName, $bFailIfExists )>, CreateFile, C<$hObject= CreateFile(
31674 $sPath, $uAccess, $uShare, $pSecAttr, $uCreate, $uFlags, $hModel )>,
31675 C<"//./PhysicalDrive0">, C<"//./C:">, C<"//./A:">, C<"//./PIPE/PipeName">,
31676 DefineDosDevice, C<DefineDosDevice( $uFlags, $sDosDeviceName, $sTargetPath
31677 )>, C<DDD_RAW_TARGET_PATH>, C<DDD_REMOVE_DEFINITION>,
31678 C<DDD_EXACT_MATCH_ON_REMOVE>, DeleteFile, C<DeleteFile( $sFileName )>,
31679 DeviceIoControl, C<DeviceIoControl( $hDevice, $uIoControlCode, $pInBuf,
31680 $lInBuf, $opOutBuf, $lOutBuf, $olRetBytes, $pOverlapped )>, FdGetOsFHandle,
31681 C<$hNativeHandle= FdGetOsFHandle( $ivFd )>, fileConstant, C<$value=
31682 fileConstant( $sConstantName )>, fileLastError, C<$svError=
31683 fileLastError();>, C<fileLastError( $uError );>, GetDriveType,
31684 C<$uDriveType= GetDriveType( $sRootPath )>, C<DRIVE_UNKNOWN>,
31685 C<DRIVE_NO_ROOT_DIR>, C<DRIVE_REMOVABLE>, C<DRIVE_FIXED>, C<DRIVE_REMOTE>,
31686 C<DRIVE_CDROM>, C<DRIVE_RAMDISK>, GetFileAttributes, C<$uAttrs =
31687 GetFileAttributes( $sPath )>, C<FILE_ATTRIBUTE_ARCHIVE>,
31688 C<FILE_ATTRIBUTE_COMPRESSED>, C<FILE_ATTRIBUTE_DEVICE>,
31689 C<FILE_ATTRIBUTE_DIRECTORY>, C<FILE_ATTRIBUTE_ENCRYPTED>,
31690 C<FILE_ATTRIBUTE_HIDDEN>, C<FILE_ATTRIBUTE_NORMAL>,
31691 C<FILE_ATTRIBUTE_NOT_CONTENT_INDEXED>, C<FILE_ATTRIBUTE_OFFLINE>,
31692 C<FILE_ATTRIBUTE_READONLY>, C<FILE_ATTRIBUTE_REPARSE_POINT>,
31693 C<FILE_ATTRIBUTE_SPARSE_FILE>, C<FILE_ATTRIBUTE_SYSTEM>,
31694 C<FILE_ATTRIBUTE_TEMPORARY>, GetFileType, C<$uFileType= GetFileType( $hFile
31695 )>, C<FILE_TYPE_UNKNOWN>, C<FILE_TYPE_DISK>, C<FILE_TYPE_CHAR>,
31696 C<FILE_TYPE_PIPE>, getFileSize, C<$size= getFileSize( $hFile )>,
31697 GetFileSize, C<$iSizeLow= GetFileSize($win32Handle, $iSizeHigh)>,
31698 GetOverlappedResult, C<$bRetval= GetOverlappedResult( $win32Handle,
31699 $pOverlapped, $numBytesTransferred, $bWait )>, GetLogicalDrives,
31700 C<$uDriveBits= GetLogicalDrives()>, GetLogicalDriveStrings, C<$olOutLength=
31701 GetLogicalDriveStrings( $lBufSize, $osBuffer )>, GetHandleInformation,
31702 C<GetHandleInformation( $hObject, $ouFlags )>, GetOsFHandle,
31703 C<$hNativeHandle= GetOsFHandle( FILE )>, GetVolumeInformation,
31704 C<GetVolumeInformation( $sRootPath, $osVolName, $lVolName, $ouSerialNum,
31705 $ouMaxNameLen, $ouFsFlags, $osFsType, $lFsType )>, C<FS_CASE_IS_PRESERVED>,
31706 C<FS_CASE_SENSITIVE>, C<FS_UNICODE_STORED_ON_DISK>, C<FS_PERSISTENT_ACLS>,
31707 C<FS_FILE_COMPRESSION>, C<FS_VOL_IS_COMPRESSED>, IsRecognizedPartition,
31708 C<IsRecognizedPartition( $ivPartitionType )>, IsContainerPartition,
31709 C<IsContainerPartition( $ivPartitionType )>, MoveFile, C<MoveFile(
31710 $sOldName, $sNewName )>, MoveFileEx, C<MoveFileEx( $sOldName, $sNewName,
31711 $uFlags )>, C<MOVEFILE_REPLACE_EXISTING>, C<MOVEFILE_COPY_ALLOWED>,
31712 C<MOVEFILE_DELAY_UNTIL_REBOOT>, C<MOVEFILE_WRITE_THROUGH>, OsFHandleOpen,
31713 C<OsFHandleOpen( FILE, $hNativeHandle, $sMode )>, OsFHandleOpenFd, C<$ivFD=
31714 OsFHandleOpenFd( $hNativeHandle, $uMode )>, QueryDosDevice, C<$olTargetLen=
31715 QueryDosDevice( $sDosDeviceName, $osTargetPath, $lTargetBuf )>, ReadFile,
31716 C<ReadFile( $hFile, $opBuffer, $lBytes, $olBytesRead, $pOverlapped )>,
31717 SetErrorMode, C<$uOldMode= SetErrorMode( $uNewMode )>,
31718 C<SEM_FAILCRITICALERRORS>, C<SEM_NOALIGNMENTFAULTEXCEPT>,
31719 C<SEM_NOGPFAULTERRORBOX>, C<SEM_NOOPENFILEERRORBOX>, setFilePointer,
31720 C<$uNewPos = setFilePointer( $hFile, $ivOffset, $uFromWhere )>,
31721 SetFilePointer, C<$uNewPos = SetFilePointer( $hFile, $ivOffset,
31722 $ioivOffsetHigh, $uFromWhere )>, SetHandleInformation,
31723 C<SetHandleInformation( $hObject, $uMask, $uFlags )>, WriteFile,
31724 C<WriteFile( $hFile, $pBuffer, $lBytes, $ouBytesWritten, $pOverlapped )>,
31725 C<":FuncA">, C<":FuncW">, CopyFileW, C<CopyFileW( $swOldFileName,
31726 $swNewFileName, $bFailIfExists )>, CreateFileW, C<$hObject= CreateFileW(
31727 $swPath, $uAccess, $uShare, $pSecAttr, $uCreate, $uFlags, $hModel )>,
31728 DefineDosDeviceW, C<DefineDosDeviceW( $uFlags, $swDosDeviceName,
31729 $swTargetPath )>, DeleteFileW, C<DeleteFileW( $swFileName )>,
31730 GetDriveTypeW, C<$uDriveType= GetDriveTypeW( $swRootPath )>,
31731 GetFileAttributesW, C<$uAttrs= GetFileAttributesW( $swPath )>,
31732 GetLogicalDriveStringsW, C<$olwOutLength= GetLogicalDriveStringsW(
31733 $lwBufSize, $oswBuffer )>, GetVolumeInformationW, C<GetVolumeInformationW(
31734 $swRootPath, $oswVolName, $lwVolName, $ouSerialNum, $ouMaxNameLen,
31735 $ouFsFlags, $oswFsType, $lwFsType )>, MoveFileW, C<MoveFileW( $swOldName,
31736 $swNewName )>, MoveFileExW, C<MoveFileExW( $swOldName, $swNewName, $uFlags
31737 )>, QueryDosDeviceW, C<$olwTargetLen= QueryDosDeviceW( $swDeviceName,
31738 $oswTargetPath, $lwTargetBuf )>, C<":Misc">, C<":DDD_">, C<":DRIVE_">,
31739 C<":FILE_">, C<":FILE_ATTRIBUTE_">, C<":FILE_FLAG_">, C<":FILE_SHARE_">,
31740 C<":FILE_TYPE_">, C<":FS_">, C<":HANDLE_FLAG_">, HANDLE_FLAG_INHERIT,
31741 HANDLE_FLAG_PROTECT_FROM_CLOSE, C<":IOCTL_STORAGE_">,
31742 C<IOCTL_STORAGE_CHECK_VERIFY>, C<IOCTL_STORAGE_MEDIA_REMOVAL>,
31743 C<IOCTL_STORAGE_EJECT_MEDIA>, C<IOCTL_STORAGE_LOAD_MEDIA>,
31744 C<IOCTL_STORAGE_RESERVE>, C<IOCTL_STORAGE_RELEASE>,
31745 C<IOCTL_STORAGE_FIND_NEW_DEVICES>, C<IOCTL_STORAGE_GET_MEDIA_TYPES>,
31746 C<$ucCylsLow[$i]>, C<$ivcCylsHigh[$i]>, C<$uMediaType[$i]>,
31747 C<$uTracksPerCyl[$i]>, C<$uSectsPerTrack[$i]>, C<$uBytesPerSect[$i]>,
31748 C<":IOCTL_DISK_">, C<IOCTL_DISK_GET_DRIVE_GEOMETRY>, C<$ucCylsLow>,
31749 C<$ivcCylsHigh>, C<$uMediaType>, C<$uTracksPerCyl>, C<$uSectsPerTrack>,
31750 C<$uBytesPerSect>, C<IOCTL_DISK_GET_PARTITION_INFO>, C<$uStartLow> and
31751 C<$ivStartHigh>, C<$ucHiddenSects>, C<$uPartitionSeqNumber>,
31752 C<$uPartitionType>, C<$bActive>, C<$bRecognized>, C<$bToRewrite>,
31753 C<IOCTL_DISK_SET_PARTITION_INFO>, C<IOCTL_DISK_GET_DRIVE_LAYOUT>,
31754 C<$cPartitions>, C<$uDiskSignature>, C<IOCTL_DISK_GET_MEDIA_TYPES>,
31755 C<IOCTL_DISK_SET_DRIVE_LAYOUT>, C<IOCTL_DISK_VERIFY>, C<$uStartOffsetLow>
31756 and C<$ivStartOffsetHigh>, C<$uLength>, C<IOCTL_DISK_FORMAT_TRACKS>,
31757 C<IOCTL_DISK_REASSIGN_BLOCKS>, C<IOCTL_DISK_PERFORMANCE>,
31758 C<IOCTL_DISK_IS_WRITABLE>, C<IOCTL_DISK_LOGGING>, DISK_LOGGING_START,
31759 DISK_LOGGING_STOP, DISK_LOGGING_DUMP, DISK_LOGGING_BINNING,
31760 C<IOCTL_DISK_FORMAT_TRACKS_EX>, C<IOCTL_DISK_HISTOGRAM_STRUCTURE>,
31761 C<IOCTL_DISK_HISTOGRAM_DATA>, C<IOCTL_DISK_HISTOGRAM_RESET>,
31762 C<IOCTL_DISK_REQUEST_STRUCTURE>, C<IOCTL_DISK_REQUEST_DATA>, C<":FSCTL_">,
31763 C<FSCTL_SET_REPARSE_POINT>, C<FSCTL_GET_REPARSE_POINT>,
31764 C<FSCTL_DELETE_REPARSE_POINT>, C<":GENERIC_">, C<":MEDIA_TYPE">,
31765 C<Unknown>, C<F5_1Pt2_512>, C<F3_1Pt44_512>, C<F3_2Pt88_512>,
31766 C<F3_20Pt8_512>, C<F3_720_512>, C<F5_360_512>, C<F5_320_512>,
31767 C<F5_320_1024>, C<F5_180_512>, C<F5_160_512>, C<RemovableMedia>,
31768 C<FixedMedia>, C<F3_120M_512>, C<":MOVEFILE_">, C<":SECURITY_">,
31769 C<":SEM_">, C<":PARTITION_">, C<":ALL">
31789 =head2 XSLoader - Dynamically load C libraries into Perl code
31801 =item Migration from C<DynaLoader>
31803 =item Backward compatible boilerplate
31807 =item Order of initialization: early load()
31811 =item The most hairy case
31817 C<Can't find '%s' symbol in %s>, C<Can't load '%s' for module %s: %s>,
31818 C<Undefined symbols present after loading %s: %s>,
31819 C<XSLoader::load('Your::Module', $Your::Module::VERSION)>
31833 =head1 AUXILIARY DOCUMENTATION
31835 Here should be listed all the extra programs' documentation, but they
31836 don't all have manual pages yet:
31870 Larry Wall <F<larry@wall.org>>, with the help of oodles