2 # !!!!!!! DO NOT EDIT THIS FILE !!!!!!!
3 # This file is autogenerated by buildtoc from all the other pods.
4 # Edit those files and run buildtoc --build-toc to effect changes.
8 perltoc - perl documentation table of contents
12 This page provides a brief table of contents for the rest of the Perl
13 documentation set. It is meant to be scanned quickly or grepped
14 through to locate the proper section you're looking for.
16 =head1 BASIC DOCUMENTATION
18 =head2 perl - Practical Extraction and Report Language
30 =item Reference Manual
32 =item Internals and C Language Interface
36 =item Language-Specific
38 =item Platform-Specific
62 =head2 perlintro -- a brief introduction and overview of Perl
72 =item Running Perl programs
74 =item Basic syntax overview
76 =item Perl variable types
78 Scalars, Arrays, Hashes
80 =item Variable scoping
82 =item Conditional and looping constructs
84 if, while, for, foreach
86 =item Builtin operators and functions
88 Arithmetic, Numeric comparison, String comparison, Boolean logic,
93 =item Regular expressions
95 Simple matching, Simple substitution, More complex regular expressions,
96 Parentheses for capturing, Other regexp features
98 =item Writing subroutines
102 =item Using Perl modules
110 =head2 perlreftut - Mark's very short tutorial about references
116 =item Who Needs Complicated Data Structures?
124 =item Making References
126 =item Using References
144 =item Distribution Conditions
150 =head2 perldsc - Perl Data Structures Cookbook
156 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
157 more elaborate constructs
161 =item COMMON MISTAKES
163 =item CAVEAT ON PRECEDENCE
165 =item WHY YOU SHOULD ALWAYS C<use strict>
171 =item ARRAYS OF ARRAYS
175 =item Declaration of an ARRAY OF ARRAYS
177 =item Generation of an ARRAY OF ARRAYS
179 =item Access and Printing of an ARRAY OF ARRAYS
183 =item HASHES OF ARRAYS
187 =item Declaration of a HASH OF ARRAYS
189 =item Generation of a HASH OF ARRAYS
191 =item Access and Printing of a HASH OF ARRAYS
195 =item ARRAYS OF HASHES
199 =item Declaration of an ARRAY OF HASHES
201 =item Generation of an ARRAY OF HASHES
203 =item Access and Printing of an ARRAY OF HASHES
207 =item HASHES OF HASHES
211 =item Declaration of a HASH OF HASHES
213 =item Generation of a HASH OF HASHES
215 =item Access and Printing of a HASH OF HASHES
219 =item MORE ELABORATE RECORDS
223 =item Declaration of MORE ELABORATE RECORDS
225 =item Declaration of a HASH OF COMPLEX RECORDS
227 =item Generation of a HASH OF COMPLEX RECORDS
239 =head2 perllol - Manipulating Arrays of Arrays in Perl
247 =item Declaration and Access of Arrays of Arrays
249 =item Growing Your Own
251 =item Access and Printing
263 =head2 perlrequick - Perl regular expressions quick start
273 =item Simple word matching
275 =item Using character classes
277 =item Matching this or that
279 =item Grouping things and hierarchical matching
281 =item Extracting matches
283 =item Matching repetitions
287 =item Search and replace
289 =item The split operator
297 =item AUTHOR AND COPYRIGHT
301 =item Acknowledgments
307 =head2 perlretut - Perl regular expressions tutorial
313 =item Part 1: The basics
317 =item Simple word matching
319 =item Using character classes
321 =item Matching this or that
323 =item Grouping things and hierarchical matching
325 =item Extracting matches
327 =item Matching repetitions
329 =item Building a regexp
331 =item Using regular expressions in Perl
335 =item Part 2: Power tools
339 =item More on characters, strings, and character classes
341 =item Compiling and saving regular expressions
343 =item Embedding comments and modifiers in a regular expression
345 =item Non-capturing groupings
347 =item Looking ahead and looking behind
349 =item Using independent subexpressions to prevent backtracking
351 =item Conditional expressions
353 =item A bit of magic: executing Perl code in a regular expression
355 =item Pragmas and debugging
363 =item AUTHOR AND COPYRIGHT
367 =item Acknowledgments
373 =head2 perlboot - Beginner's Object-Oriented Tutorial
381 =item If we could talk to the animals...
383 =item Introducing the method invocation arrow
385 =item Invoking a barnyard
387 =item The extra parameter of method invocation
389 =item Calling a second method to simplify things
391 =item Inheriting the windpipes
393 =item A few notes about @ISA
395 =item Overriding the methods
397 =item Starting the search from a different place
399 =item The SUPER way of doing things
401 =item Where we're at so far...
403 =item A horse is a horse, of course of course -- or is it?
405 =item Invoking an instance method
407 =item Accessing the instance data
409 =item How to build a horse
411 =item Inheriting the constructor
413 =item Making a method work with either classes or instances
415 =item Adding parameters to a method
417 =item More interesting instances
419 =item A horse of a different color
431 =head2 perltoot - Tom's object-oriented tutorial for perl
437 =item Creating a Class
441 =item Object Representation
443 =item Class Interface
445 =item Constructors and Instance Methods
447 =item Planning for the Future: Better Constructors
451 =item Other Object Methods
459 =item Accessing Class Data
461 =item Debugging Methods
463 =item Class Destructors
465 =item Documenting the Interface
475 =item Overridden Methods
477 =item Multiple Inheritance
479 =item UNIVERSAL: The Root of All Objects
483 =item Alternate Object Representations
487 =item Arrays as Objects
489 =item Closures as Objects
493 =item AUTOLOAD: Proxy Methods
497 =item Autoloaded Data Methods
499 =item Inherited Autoloaded Data Methods
503 =item Metaclassical Tools
509 =item Data Members as Variables
517 =item Object Terminology
523 =item AUTHOR AND COPYRIGHT
529 =item Acknowledgments
535 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
541 =item Class Data in a Can
543 =item Class Data as Package Variables
547 =item Putting All Your Eggs in One Basket
549 =item Inheritance Concerns
551 =item The Eponymous Meta-Object
553 =item Indirect References to Class Data
555 =item Monadic Classes
557 =item Translucent Attributes
561 =item Class Data as Lexical Variables
565 =item Privacy and Responsibility
567 =item File-Scoped Lexicals
569 =item More Inheritance Concerns
571 =item Locking the Door and Throwing Away the Key
573 =item Translucency Revisited
581 =item AUTHOR AND COPYRIGHT
583 =item ACKNOWLEDGEMENTS
589 =head2 perlbot - Bag'o Object Tricks (the BOT)
595 =item OO SCALING TIPS
597 =item INSTANCE VARIABLES
599 =item SCALAR INSTANCE VARIABLES
601 =item INSTANCE VARIABLE INHERITANCE
603 =item OBJECT RELATIONSHIPS
605 =item OVERRIDING SUPERCLASS METHODS
607 =item USING RELATIONSHIP WITH SDBM
609 =item THINKING OF CODE REUSE
611 =item CLASS CONTEXT AND THE OBJECT
613 =item INHERITING A CONSTRUCTOR
621 =head2 perlstyle - Perl style guide
629 =head2 perlcheat - Perl 5 Cheat Sheet
641 =item ACKNOWLEDGEMENTS
649 =head2 perltrap - Perl traps for the unwary
667 =item Perl4 to Perl5 Traps
669 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
670 Traps, General data type traps, Context Traps - scalar, list contexts,
671 Precedence Traps, General Regular Expression Traps using s///, etc,
672 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
674 =item Discontinuance, Deprecation, and BugFix traps
676 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
677 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
678 Discontinuance, Deprecation, Discontinuance, Discontinuance
682 Parsing, Parsing, Parsing, Parsing, Parsing
684 =item Numerical Traps
686 Numerical, Numerical, Numerical, Bitwise string ops
688 =item General data type traps
690 (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
691 (Constants), (Scalars), (Variable Suicide)
693 =item Context Traps - scalar, list contexts
695 (list context), (scalar context), (scalar context), (list, builtin)
697 =item Precedence Traps
699 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
702 =item General Regular Expression Traps using s///, etc.
704 Regular Expression, Regular Expression, Regular Expression, Regular
705 Expression, Regular Expression, Regular Expression, Regular Expression,
706 Regular Expression, Regular Expression
708 =item Subroutine, Signal, Sorting Traps
710 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
716 =item Interpolation Traps
718 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
719 Interpolation, Interpolation, Interpolation, Interpolation
725 =item Unclassified Traps
727 C<require>/C<do> trap using returned value, C<split> on empty string with
734 =head2 perldebtut - Perl debugging tutorial
742 =item Looking at data and -w and v
746 =item Stepping through code
748 =item Placeholder for a, w, t, T
750 =item REGULAR EXPRESSIONS
768 =head2 perlfaq - frequently asked questions about Perl ($Date: 2003/01/31
777 =item Where to get the perlfaq
779 =item How to contribute to the perlfaq
781 =item What will happen if you mail your Perl programming problems to the
788 =item Author and Copyright Information
792 =item Bundled Distributions
798 =item Table of Contents
800 perlfaq - this document, perlfaq1 - General Questions About Perl, perlfaq2
801 - Obtaining and Learning about Perl, perlfaq3 - Programming Tools, perlfaq4
802 - Data Manipulation, perlfaq5 - Files and Formats, perlfaq6 - Regular
803 Expressions, perlfaq7 - General Perl Language Issues, perlfaq8 - System
804 Interaction, perlfaq9 - Networking
810 =item L<perlfaq1>: General Questions About Perl
812 =item L<perlfaq2>: Obtaining and Learning about Perl
814 =item L<perlfaq3>: Programming Tools
816 =item L<perlfaq4>: Data Manipulation
818 =item L<perlfaq5>: Files and Formats
820 =item L<perlfaq6>: Regular Expressions
822 =item L<perlfaq7>: General Perl Language Issues
824 =item L<perlfaq8>: System Interaction
826 =item L<perlfaq9>: Networking
832 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.12 $, $Date:
833 2003/07/09 15:47:28 $)
843 =item Who supports Perl? Who develops it? Why is it free?
845 =item Which version of Perl should I use?
847 =item What are perl4 and perl5?
853 =item How stable is Perl?
855 =item Is Perl difficult to learn?
857 =item How does Perl compare with other languages like Java, Python, REXX,
860 =item Can I do [task] in Perl?
862 =item When shouldn't I program in Perl?
864 =item What's the difference between "perl" and "Perl"?
866 =item Is it a Perl program or a Perl script?
868 =item What is a JAPH?
870 =item Where can I get a list of Larry Wall witticisms?
872 =item How can I convince my sysadmin/supervisor/employees to use version
873 5/5.6.1/Perl instead of some other language?
877 =item AUTHOR AND COPYRIGHT
881 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.20 $,
882 $Date: 2003/01/26 17:50:56 $)
890 =item What machines support Perl? Where do I get it?
892 =item How can I get a binary version of Perl?
894 =item I don't have a C compiler on my system. How can I compile perl?
896 =item I copied the Perl binary from one machine to another, but scripts
899 =item I grabbed the sources and tried to compile but gdbm/dynamic
900 loading/malloc/linking/... failed. How do I make it work?
902 =item What modules and extensions are available for Perl? What is CPAN?
903 What does CPAN/src/... mean?
905 =item Is there an ISO or ANSI certified version of Perl?
907 =item Where can I get information on Perl?
909 =item What are the Perl newsgroups on Usenet? Where do I post questions?
911 =item Where should I post source code?
915 References, Tutorials, Task-Oriented, Special Topics
917 =item Perl in Magazines
919 =item Perl on the Net: FTP and WWW Access
921 =item What mailing lists are there for Perl?
923 =item Archives of comp.lang.perl.misc
925 =item Where can I buy a commercial version of Perl?
927 =item Where do I send bug reports?
929 =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
933 =item AUTHOR AND COPYRIGHT
937 =head2 perlfaq3 - Programming Tools ($Revision: 1.33 $, $Date: 2003/01/31
946 =item How do I do (anything)?
948 =item How can I use Perl interactively?
950 =item Is there a Perl shell?
952 =item How do I find which modules are installed on my system?
954 =item How do I debug my Perl programs?
956 =item How do I profile my Perl programs?
958 =item How do I cross-reference my Perl programs?
960 =item Is there a pretty-printer (formatter) for Perl?
962 =item Is there a ctags for Perl?
964 =item Is there an IDE or Windows Perl Editor?
966 Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl,
967 GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis, Vile, Vim, Codewright,
968 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
970 =item Where can I get Perl macros for vi?
972 =item Where can I get perl-mode for emacs?
974 =item How can I use curses with Perl?
976 =item How can I use X or Tk with Perl?
978 =item How can I generate simple menus without using CGI or Tk?
980 =item How can I make my Perl program run faster?
982 =item How can I make my Perl program take less memory?
984 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
985 stringification, Pass by reference, Tie large variables to disk
987 =item Is it safe to return a reference to local or lexical data?
989 =item How can I free an array or hash so my program shrinks?
991 =item How can I make my CGI script more efficient?
993 =item How can I hide the source for my Perl program?
995 =item How can I compile my Perl program into byte code or C?
997 =item How can I compile Perl into Java?
999 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
1001 =item Can I write useful Perl programs on the command line?
1003 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
1005 =item Where can I learn about CGI or Web programming in Perl?
1007 =item Where can I learn about object-oriented Perl programming?
1009 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
1011 =item I've read perlembed, perlguts, etc., but I can't embed perl in
1012 my C program; what am I doing wrong?
1014 =item When I tried to run my script, I got this message. What does it mean?
1016 =item What's MakeMaker?
1020 =item AUTHOR AND COPYRIGHT
1024 =head2 perlfaq4 - Data Manipulation ($Revision: 1.44 $, $Date: 2003/07/28
1035 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
1036 numbers I should be getting (eg, 19.95)?
1038 =item Why isn't my octal data interpreted correctly?
1040 =item Does Perl have a round() function? What about ceil() and floor()?
1043 =item How do I convert between numeric representations?
1045 How do I convert hexadecimal into decimal, How do I convert from decimal to
1046 hexadecimal, How do I convert from octal to decimal, How do I convert from
1047 decimal to octal, How do I convert from binary to decimal, How do I convert
1048 from decimal to binary
1050 =item Why doesn't & work the way I want it to?
1052 =item How do I multiply matrices?
1054 =item How do I perform an operation on a series of integers?
1056 =item How can I output Roman numerals?
1058 =item Why aren't my random numbers random?
1060 =item How do I get a random number between X and Y?
1068 =item How do I find the day or week of the year?
1070 =item How do I find the current century or millennium?
1072 =item How can I compare two dates and find the difference?
1074 =item How can I take a string and turn it into epoch seconds?
1076 =item How can I find the Julian Day?
1078 =item How do I find yesterday's date?
1080 =item Does Perl have a Year 2000 problem? Is Perl Y2K compliant?
1088 =item How do I validate input?
1090 =item How do I unescape a string?
1092 =item How do I remove consecutive pairs of characters?
1094 =item How do I expand function calls in a string?
1096 =item How do I find matching/nesting anything?
1098 =item How do I reverse a string?
1100 =item How do I expand tabs in a string?
1102 =item How do I reformat a paragraph?
1104 =item How can I access or change N characters of a string?
1106 =item How do I change the Nth occurrence of something?
1108 =item How can I count the number of occurrences of a substring within a
1111 =item How do I capitalize all the words on one line?
1113 =item How can I split a [character] delimited string except when inside
1116 =item How do I strip blank space from the beginning/end of a string?
1118 =item How do I pad a string with blanks or pad a number with zeroes?
1120 =item How do I extract selected columns from a string?
1122 =item How do I find the soundex value of a string?
1124 =item How can I expand variables in text strings?
1126 =item What's wrong with always quoting "$vars"?
1128 =item Why don't my E<lt>E<lt>HERE documents work?
1130 There must be no space after the E<lt>E<lt> part, There (probably) should
1131 be a semicolon at the end, You can't (easily) have any space in front of
1140 =item What is the difference between a list and an array?
1142 =item What is the difference between $array[1] and @array[1]?
1144 =item How can I remove duplicate elements from a list or array?
1148 =item How can I tell whether a certain element is contained in a list or
1151 =item How do I compute the difference of two arrays? How do I compute the
1152 intersection of two arrays?
1154 =item How do I test whether two arrays or hashes are equal?
1156 =item How do I find the first array element for which a condition is true?
1158 =item How do I handle linked lists?
1160 =item How do I handle circular lists?
1162 =item How do I shuffle an array randomly?
1164 =item How do I process/modify each element of an array?
1166 =item How do I select a random element from an array?
1168 =item How do I permute N elements of a list?
1170 =item How do I sort an array by (anything)?
1172 =item How do I manipulate arrays of bits?
1174 =item Why does defined() return true on empty arrays and hashes?
1178 =item Data: Hashes (Associative Arrays)
1182 =item How do I process an entire hash?
1184 =item What happens if I add or remove keys from a hash while iterating over
1187 =item How do I look up a hash element by value?
1189 =item How can I know how many entries are in a hash?
1191 =item How do I sort a hash (optionally by value instead of key)?
1193 =item How can I always keep my hash sorted?
1195 =item What's the difference between "delete" and "undef" with hashes?
1197 =item Why don't my tied hashes make the defined/exists distinction?
1199 =item How do I reset an each() operation part-way through?
1201 =item How can I get the unique keys from two hashes?
1203 =item How can I store a multidimensional array in a DBM file?
1205 =item How can I make my hash remember the order I put elements into it?
1207 =item Why does passing a subroutine an undefined element in a hash create
1210 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
1211 array of hashes or arrays?
1213 =item How can I use a reference as a hash key?
1221 =item How do I handle binary data correctly?
1223 =item How do I determine whether a scalar is a number/whole/integer/float?
1225 =item How do I keep persistent data across program calls?
1227 =item How do I print out or copy a recursive data structure?
1229 =item How do I define methods for every class/object?
1231 =item How do I verify a credit card checksum?
1233 =item How do I pack arrays of doubles or floats for XS code?
1237 =item AUTHOR AND COPYRIGHT
1241 =head2 perlfaq5 - Files and Formats ($Revision: 1.28 $, $Date: 2003/01/26
1250 =item How do I flush/unbuffer an output filehandle? Why must I do this?
1252 =item How do I change one line in a file/delete a line in a file/insert a
1253 line in the middle of a file/append to the beginning of a file?
1255 =item How do I count the number of lines in a file?
1257 =item How can I use Perl's C<-i> option from within a program?
1259 =item How do I make a temporary file name?
1261 =item How can I manipulate fixed-record-length files?
1263 =item How can I make a filehandle local to a subroutine? How do I pass
1264 filehandles between subroutines? How do I make an array of filehandles?
1266 =item How can I use a filehandle indirectly?
1268 =item How can I set up a footer format to be used with write()?
1270 =item How can I write() into a string?
1272 =item How can I output my numbers with commas added?
1274 =item How can I translate tildes (~) in a filename?
1276 =item How come when I open a file read-write it wipes it out?
1278 =item Why do I sometimes get an "Argument list too long" when I use
1281 =item Is there a leak/bug in glob()?
1283 =item How can I open a file with a leading ">" or trailing blanks?
1285 =item How can I reliably rename a file?
1287 =item How can I lock a file?
1289 =item Why can't I just open(FH, "E<gt>file.lock")?
1291 =item I still don't get locking. I just want to increment the number in
1292 the file. How can I do this?
1294 =item All I want to do is append a small amount of text to the end of a
1295 file. Do I still have to use locking?
1297 =item How do I randomly update a binary file?
1299 =item How do I get a file's timestamp in perl?
1301 =item How do I set a file's timestamp in perl?
1303 =item How do I print to more than one file at once?
1305 =item How can I read in an entire file all at once?
1307 =item How can I read in a file by paragraphs?
1309 =item How can I read a single character from a file? From the keyboard?
1311 =item How can I tell whether there's a character waiting on a filehandle?
1313 =item How do I do a C<tail -f> in perl?
1315 =item How do I dup() a filehandle in Perl?
1317 =item How do I close a file descriptor by number?
1319 =item Why can't I use "C:\temp\foo" in DOS paths? Why doesn't
1320 `C:\temp\foo.exe` work?
1322 =item Why doesn't glob("*.*") get all the files?
1324 =item Why does Perl let me delete read-only files? Why does C<-i> clobber
1325 protected files? Isn't this a bug in Perl?
1327 =item How do I select a random line from a file?
1329 =item Why do I get weird spaces when I print an array of lines?
1333 =item AUTHOR AND COPYRIGHT
1337 =head2 perlfaq6 - Regular Expressions ($Revision: 1.20 $, $Date: 2003/01/03
1346 =item How can I hope to use regular expressions without creating illegible
1347 and unmaintainable code?
1349 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
1351 =item I'm having trouble matching over more than one line. What's wrong?
1353 =item How can I pull out lines between two patterns that are themselves on
1356 =item I put a regular expression into $/ but it didn't work. What's wrong?
1358 =item How do I substitute case insensitively on the LHS while preserving
1361 =item How can I make C<\w> match national character sets?
1363 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
1365 =item How can I quote a variable to use in a regex?
1367 =item What is C</o> really for?
1369 =item How do I use a regular expression to strip C style comments from a
1372 =item Can I use Perl regular expressions to match balanced text?
1374 =item What does it mean that regexes are greedy? How can I get around it?
1376 =item How do I process each word on each line?
1378 =item How can I print out a word-frequency or line-frequency summary?
1380 =item How can I do approximate matching?
1382 =item How do I efficiently match many regular expressions at once?
1384 =item Why don't word-boundary searches with C<\b> work for me?
1386 =item Why does using $&, $`, or $' slow my program down?
1388 =item What good is C<\G> in a regular expression?
1390 =item Are Perl regexes DFAs or NFAs? Are they POSIX compliant?
1392 =item What's wrong with using grep or map in a void context?
1394 =item How can I match strings with multibyte characters?
1396 =item How do I match a pattern that is supplied by the user?
1400 =item AUTHOR AND COPYRIGHT
1404 =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.15 $, $Date:
1405 2003/07/24 02:17:21 $)
1413 =item Can I get a BNF/yacc/RE for the Perl language?
1415 =item What are all these $@%&* punctuation signs, and how do I know when to
1418 =item Do I always/never have to quote my strings or use semicolons and
1421 =item How do I skip some return values?
1423 =item How do I temporarily block warnings?
1425 =item What's an extension?
1427 =item Why do Perl operators have different precedence than C operators?
1429 =item How do I declare/create a structure?
1431 =item How do I create a module?
1433 =item How do I create a class?
1435 =item How can I tell if a variable is tainted?
1437 =item What's a closure?
1439 =item What is variable suicide and how can I prevent it?
1441 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
1444 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
1447 =item How do I create a static variable?
1449 =item What's the difference between dynamic and lexical (static) scoping?
1450 Between local() and my()?
1452 =item How can I access a dynamic variable while a similarly named lexical
1455 =item What's the difference between deep and shallow binding?
1457 =item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?
1459 =item How do I redefine a builtin function, operator, or method?
1461 =item What's the difference between calling a function as &foo and foo()?
1463 =item How do I create a switch or case statement?
1465 =item How can I catch accesses to undefined variables, functions, or
1468 =item Why can't a method included in this same file be found?
1470 =item How can I find out my current package?
1472 =item How can I comment out a large block of perl code?
1474 =item How do I clear a package?
1476 =item How can I use a variable as a variable name?
1478 =item What does "bad interpreter" mean?
1482 =item AUTHOR AND COPYRIGHT
1486 =head2 perlfaq8 - System Interaction ($Revision: 1.17 $, $Date: 2003/01/26
1495 =item How do I find out which operating system I'm running under?
1497 =item How come exec() doesn't return?
1499 =item How do I do fancy stuff with the keyboard/screen/mouse?
1501 Keyboard, Screen, Mouse
1503 =item How do I print something out in color?
1505 =item How do I read just one key without waiting for a return key?
1507 =item How do I check whether input is ready on the keyboard?
1509 =item How do I clear the screen?
1511 =item How do I get the screen size?
1513 =item How do I ask the user for a password?
1515 =item How do I read and write the serial port?
1517 lockfiles, open mode, end of line, flushing output, non-blocking input
1519 =item How do I decode encrypted password files?
1521 =item How do I start a process in the background?
1523 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
1525 =item How do I trap control characters/signals?
1527 =item How do I modify the shadow password file on a Unix system?
1529 =item How do I set the time and date?
1531 =item How can I sleep() or alarm() for under a second?
1533 =item How can I measure time under a second?
1535 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
1537 =item Why doesn't my sockets program work under System V (Solaris)? What
1538 does the error message "Protocol not supported" mean?
1540 =item How can I call my system's unique C functions from Perl?
1542 =item Where do I get the include files to do ioctl() or syscall()?
1544 =item Why do setuid perl scripts complain about kernel problems?
1546 =item How can I open a pipe both to and from a command?
1548 =item Why can't I get the output of a command with system()?
1550 =item How can I capture STDERR from an external command?
1552 =item Why doesn't open() return an error when a pipe open fails?
1554 =item What's wrong with using backticks in a void context?
1556 =item How can I call backticks without shell processing?
1558 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
1561 =item How can I convert my shell script to perl?
1563 =item Can I use perl to run a telnet or ftp session?
1565 =item How can I write expect in Perl?
1567 =item Is there a way to hide perl's command line from programs such as
1570 =item I {changed directory, modified my environment} in a perl script. How
1571 come the change disappeared when I exited the script? How do I get my
1572 changes to be visible?
1576 =item How do I close a process's filehandle without waiting for it to
1579 =item How do I fork a daemon process?
1581 =item How do I find out if I'm running interactively or not?
1583 =item How do I timeout a slow event?
1585 =item How do I set CPU limits?
1587 =item How do I avoid zombies on a Unix system?
1589 =item How do I use an SQL database?
1591 =item How do I make a system() exit on control-C?
1593 =item How do I open a file without blocking?
1595 =item How do I install a module from CPAN?
1597 =item What's the difference between require and use?
1599 =item How do I keep my own module/library directory?
1601 =item How do I add the directory my program lives in to the module/library
1604 =item How do I add a directory to my include path at runtime?
1606 =item What is socket.ph and where do I get it?
1610 =item AUTHOR AND COPYRIGHT
1614 =head2 perlfaq9 - Networking ($Revision: 1.15 $, $Date: 2003/01/31 17:36:57
1623 =item What is the correct form of response from a CGI script?
1625 =item My CGI script runs from the command line but not the browser. (500
1628 =item How can I get better error messages from a CGI program?
1630 =item How do I remove HTML from a string?
1632 =item How do I extract URLs?
1634 =item How do I download a file from the user's machine? How do I open a
1635 file on another machine?
1637 =item How do I make a pop-up menu in HTML?
1639 =item How do I fetch an HTML file?
1641 =item How do I automate an HTML form submission?
1643 =item How do I decode or create those %-encodings on the web?
1645 =item How do I redirect to another page?
1647 =item How do I put a password on my web pages?
1649 =item How do I edit my .htpasswd and .htgroup files with Perl?
1651 =item How do I make sure users can't enter values into a form that cause my
1652 CGI script to do bad things?
1654 =item How do I parse a mail header?
1656 =item How do I decode a CGI form?
1658 =item How do I check a valid mail address?
1660 =item How do I decode a MIME/BASE64 string?
1662 =item How do I return the user's mail address?
1664 =item How do I send mail?
1666 =item How do I use MIME to make an attachment to a mail message?
1668 =item How do I read mail?
1670 =item How do I find out my hostname/domainname/IP address?
1672 =item How do I fetch a news article or the active newsgroups?
1674 =item How do I fetch/put an FTP file?
1676 =item How can I do RPC in Perl?
1680 =item AUTHOR AND COPYRIGHT
1684 =head2 perlsyn - Perl syntax
1696 =item Simple Statements
1698 =item Compound Statements
1706 =item Basic BLOCKs and Switch Statements
1710 =item PODs: Embedded Documentation
1712 =item Plain Old Comments (Not!)
1718 =head2 perldata - Perl data types
1726 =item Variable names
1732 =item Scalar value constructors
1734 =item List value constructors
1740 =item Typeglobs and Filehandles
1748 =head2 perlop - Perl operators and precedence
1758 =item Terms and List Operators (Leftward)
1760 =item The Arrow Operator
1762 =item Auto-increment and Auto-decrement
1764 =item Exponentiation
1766 =item Symbolic Unary Operators
1768 =item Binding Operators
1770 =item Multiplicative Operators
1772 =item Additive Operators
1774 =item Shift Operators
1776 =item Named Unary Operators
1778 =item Relational Operators
1780 =item Equality Operators
1784 =item Bitwise Or and Exclusive Or
1786 =item C-style Logical And
1788 =item C-style Logical Or
1790 =item C-style Logical Defined-Or
1792 =item Range Operators
1794 =item Conditional Operator
1796 =item Assignment Operators
1798 =item Comma Operator
1800 =item List Operators (Rightward)
1806 =item Logical or, Defined or, and Exclusive Or
1808 =item C Operators Missing From Perl
1810 unary &, unary *, (TYPE)
1812 =item Quote and Quote-like Operators
1814 =item Regexp Quote-Like Operators
1816 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
1817 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
1818 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
1819 y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF
1821 =item Gory details of parsing quoted constructs
1823 Finding the end, Removal of backslashes before delimiters, Interpolation,
1824 C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
1825 C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>,
1826 C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
1831 =item Constant Folding
1833 =item Bitwise String Operators
1835 =item Integer Arithmetic
1837 =item Floating-point Arithmetic
1839 =item Bigger Numbers
1845 =head2 perlsub - Perl subroutines
1855 =item Private Variables via my()
1857 =item Persistent Private Variables
1859 =item Temporary Values via local()
1861 =item Lvalue subroutines
1863 Lvalue subroutines are EXPERIMENTAL
1865 =item Passing Symbol Table Entries (typeglobs)
1867 =item When to Still Use local()
1869 =item Pass by Reference
1873 =item Constant Functions
1875 =item Overriding Built-in Functions
1879 =item Subroutine Attributes
1887 =head2 perlfunc - Perl builtin functions
1895 =item Perl Functions by Category
1897 Functions for SCALARs or strings, Regular expressions and pattern matching,
1898 Numeric functions, Functions for real @ARRAYs, Functions for list data,
1899 Functions for real %HASHes, Input and output functions, Functions for fixed
1900 length data or records, Functions for filehandles, files, or directories,
1901 Keywords related to the control flow of your perl program, Keywords related
1902 to scoping, Miscellaneous functions, Functions for processes and process
1903 groups, Keywords related to perl modules, Keywords related to classes and
1904 object-orientedness, Low-level socket functions, System V interprocess
1905 communication functions, Fetching user and group info, Fetching network
1906 info, Time-related functions, Functions new in perl5, Functions obsoleted
1911 =item Alphabetical Listing of Perl Functions
1913 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, abs VALUE, abs, accept
1914 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
1915 binmode FILEHANDLE, LAYER, binmode FILEHANDLE, bless REF,CLASSNAME, bless
1916 REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE, chomp(
1917 LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr NUMBER,
1918 chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE,
1919 connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT,
1920 dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete
1921 EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump,
1922 each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST,
1923 exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl
1924 FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION,
1925 fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin,
1926 getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam
1927 NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname
1928 NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr
1929 ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
1930 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
1931 getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent
1932 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
1933 endhostent, endnetent, endprotoent, endservent, getsockname SOCKET,
1934 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL,
1935 goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex,
1936 import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
1937 FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST,
1938 last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length,
1939 link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR,
1940 lock THING, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map
1941 EXPR,LIST, mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget
1942 KEY,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my
1943 TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL, next, no
1944 Module VERSION LIST, no Module VERSION, no Module LIST, no Module, oct
1945 EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open
1946 FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE,MODE,REFERENCE, open FILEHANDLE,
1947 opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR TYPE, our EXPR :
1948 ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST, package NAMESPACE,
1949 package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos,
1950 print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST,
1951 printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/,
1952 qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta,
1953 rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
1954 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
1955 readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
1956 ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR,
1957 require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir
1958 DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME,
1959 rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir
1960 DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT,
1961 semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
1962 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
1963 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
1964 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
1965 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
1966 EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
1967 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
1968 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
1969 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split
1970 /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, format
1971 parameter index, flags, vector flag, (minimum) width, precision, or maximum
1972 width, size, order of arguments, sqrt EXPR, sqrt, srand EXPR, srand, stat
1973 FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub NAME BLOCK, sub NAME
1974 (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK,
1975 substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
1976 EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
1977 FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
1978 FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
1979 FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite
1980 FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH,
1981 syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie
1982 VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate
1983 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR,
1984 ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack
1985 TEMPLATE,EXPR, unpack TEMPLATE, untie VARIABLE, unshift ARRAY,LIST, use
1986 Module VERSION LIST, use Module VERSION, use Module LIST, use Module, use
1987 VERSION, utime LIST, values HASH, vec EXPR,OFFSET,BITS, wait, waitpid
1988 PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y///
1994 =head2 perlopentut - tutorial on opening things in Perl
2000 =item Open E<agrave> la shell
2006 =item Indirect Filehandles
2010 =item The Minus File
2012 =item Mixing Reads and Writes
2018 =item Open E<agrave> la C
2022 =item Permissions E<agrave> la mode
2026 =item Obscure Open Tricks
2030 =item Re-Opening Files (dups)
2032 =item Dispelling the Dweomer
2034 =item Paths as Opens
2036 =item Single Argument Open
2038 =item Playing with STDIN and STDOUT
2042 =item Other I/O Issues
2046 =item Opening Non-File Files
2048 =item Opening Named Pipes
2050 =item Opening Sockets
2062 =item AUTHOR and COPYRIGHT
2068 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
2074 =item The Basic Principle
2078 =item Packing Numbers
2084 =item Unpacking a Stack Frame
2086 =item How to Eat an Egg on a Net
2088 =item Floating point Numbers
2092 =item Exotic Templates
2104 =item Another Portable Binary Encoding
2108 =item Template Grouping
2110 =item Lengths and Widths
2114 =item String Lengths
2116 =item Dynamic Templates
2118 =item Counting Repetitions
2122 =item Packing and Unpacking C Structures
2126 =item The Alignment Pit
2128 =item Alignment, Take 2
2130 =item Alignment, Take 3
2132 =item Pointers for How to Use Them
2138 =item Funnies Section
2144 =head2 perlpod - the Plain Old Documentation format
2152 =item Ordinary Paragraph
2154 =item Verbatim Paragraph
2156 =item Command Paragraph
2158 C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
2159 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item
2160 I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end
2161 I<formatname>>, C<=for I<formatname> I<text...>>
2163 =item Formatting Codes
2165 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2166 C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink,
2167 C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used
2168 for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces,
2169 C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null
2170 (zero-effect) formatting code
2174 =item Embedding Pods in Perl Modules
2176 =item Hints for Writing Pod
2186 =head2 perlpodspec - Plain Old Documentation: format specification and
2193 =item Pod Definitions
2197 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
2198 "=back", "=begin formatname", "=end formatname", "=for formatname text..."
2200 =item Pod Formatting Codes
2202 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2203 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
2204 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
2205 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
2206 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
2207 contains non-breaking spaces
2209 =item Notes on Implementing Pod Processors
2211 =item About LE<lt>...E<gt> Codes
2213 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
2215 =item About =over...=back Regions
2217 =item About Data Paragraphs and "=begin/=end" Regions
2225 =head2 perlrun - how to execute the Perl interpreter
2235 =item #! and quoting on non-Unix systems
2237 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
2239 =item Location of Perl
2241 =item Command Switches
2243 B<-0>[I<octal/hexadecimal>], B<-A [I<assertions>]>, B<-a>, B<-C
2244 [I<number/list>]>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>, B<-D>I<letters>,
2245 B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>, B<-h>,
2246 B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
2247 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
2248 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
2249 B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>,
2250 B<-X>, B<-x> I<directory>
2256 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
2257 :perlio, :pop, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
2258 PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS,
2259 PERL_DESTRUCT_LEVEL, PERL_ENCODING, PERL_HASH_SEED, PERL_HASH_SEED_DEBUG,
2260 PERL_ROOT (specific to the VMS port), PERL_SIGNALS, PERL_UNICODE, SYS$LOGIN
2261 (specific to the VMS port)
2265 =head2 perldiag - various Perl diagnostics
2273 =head2 perllexwarn - Perl Lexical Warnings
2281 =item Default Warnings and Optional Warnings
2283 =item What's wrong with B<-w> and C<$^W>
2285 =item Controlling Warnings from the Command Line
2289 =item Backward Compatibility
2291 =item Category Hierarchy
2293 =item Fatal Warnings
2295 =item Reporting Warnings from a Module
2307 =head2 perldebug - Perl debugging
2313 =item The Perl Debugger
2317 =item Debugger Commands
2319 h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y
2320 [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l
2321 min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/,
2322 ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b
2323 subname [condition], b postpone subname [condition], b load filename, b
2324 compile subname, B line, B *, a [line] command, A line, A *, w expr, W
2325 expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [
2326 command ], < *, << command, > ?, > command, > *, >> command, { ?, { [
2327 command ], { *, {{ command, ! number, ! -number, ! pattern, !! cmd, source
2328 file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man
2331 =item Configurable Options
2333 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
2334 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
2335 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
2336 C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
2337 C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
2338 C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
2341 =item Debugger input/output
2343 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
2346 =item Debugging compile-time statements
2348 =item Debugger Customization
2350 =item Readline Support
2352 =item Editor Support for Debugging
2354 =item The Perl Profiler
2358 =item Debugging regular expressions
2360 =item Debugging memory usage
2368 =head2 perlvar - Perl predefined variables
2376 =item Predefined Names
2378 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
2379 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+,
2380 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
2381 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
2382 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
2383 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
2384 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
2385 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#,
2386 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
2387 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
2388 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
2389 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
2390 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
2391 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
2392 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
2393 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
2394 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
2395 IO::Handle->format_line_break_characters EXPR,
2396 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
2397 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
2398 $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
2399 $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
2400 $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
2401 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
2402 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
2403 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
2404 0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R,
2405 $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, ${^UNICODE},
2406 $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, $EXECUTABLE_NAME, $^X,
2407 ARGV, $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG,
2410 =item Error Indicators
2412 =item Technical Note on the Syntax of Variable Names
2420 =head2 perlre - Perl regular expressions
2430 =item Regular Expressions
2432 [1], [2], [3], cntrl, graph, print, punct, xdigit
2434 =item Extended Patterns
2436 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
2437 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
2438 code })>, C<(??{ code })>, C<< (?>pattern) >>,
2439 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
2443 =item Version 8 Regular Expressions
2445 =item Warning on \1 vs $1
2447 =item Repeated patterns matching zero-length substring
2449 =item Combining pieces together
2451 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
2452 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
2453 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
2454 C<(?(condition)yes-pattern|no-pattern)>
2456 =item Creating custom RE engines
2466 =head2 perlreref - Perl Regular Expressions Reference
2478 =item ESCAPE SEQUENCES
2480 =item CHARACTER CLASSES
2486 =item EXTENDED CONSTRUCTS
2504 =head2 perlref - Perl references and nested data structures
2514 =item Making References
2516 =item Using References
2518 =item Symbolic references
2520 =item Not-so-symbolic references
2522 =item Pseudo-hashes: Using an array as a hash
2524 =item Function Templates
2534 =head2 perlform - Perl formats
2542 =item Format Variables
2552 =item Accessing Formatting Internals
2560 =head2 perlobj - Perl objects
2568 =item An Object is Simply a Reference
2570 =item A Class is Simply a Package
2572 =item A Method is Simply a Subroutine
2574 =item Method Invocation
2576 =item Indirect Object Syntax
2578 =item Default UNIVERSAL methods
2580 isa(CLASS), can(METHOD), VERSION( [NEED] )
2586 =item Two-Phased Garbage Collection
2594 =head2 perltie - how to hide an object class in a simple variable
2606 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
2611 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
2612 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
2613 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
2614 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
2619 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
2620 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
2621 this, NEXTKEY this, lastkey, UNTIE this, DESTROY this
2623 =item Tying FileHandles
2625 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
2626 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
2631 =item The C<untie> Gotcha
2643 =head2 perldbmfilter - Perl DBM Filters
2651 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
2652 B<filter_fetch_value>
2658 =item An Example -- the NULL termination problem.
2660 =item Another Example -- Key is a C int.
2670 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
2671 safe subprocesses, sockets, and semaphores)
2681 =item Handling the SIGHUP Signal in Daemons
2689 =item Deferred Signals (Safe Signals)
2691 Long running opcodes, Interrupting IO, Restartable system calls, Signals as
2692 "faults", Signals triggered by operating system state
2696 =item Using open() for IPC
2702 =item Background Processes
2704 =item Complete Dissociation of Child from Parent
2706 =item Safe Pipe Opens
2708 =item Bidirectional Communication with Another Process
2710 =item Bidirectional Communication with Yourself
2714 =item Sockets: Client/Server Communication
2718 =item Internet Line Terminators
2720 =item Internet TCP Clients and Servers
2722 =item Unix-Domain TCP Clients and Servers
2726 =item TCP Clients with IO::Socket
2730 =item A Simple Client
2732 C<Proto>, C<PeerAddr>, C<PeerPort>
2734 =item A Webget Client
2736 =item Interactive Client with IO::Socket
2740 =item TCP Servers with IO::Socket
2742 Proto, LocalPort, Listen, Reuse
2744 =item UDP: Message Passing
2758 =head2 perlfork - Perl's fork() emulation
2768 =item Behavior of other Perl features in forked pseudo-processes
2770 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
2771 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
2772 files, directories and network sockets
2774 =item Resource limits
2776 =item Killing the parent process
2778 =item Lifetime of the parent process and pseudo-processes
2780 =item CAVEATS AND LIMITATIONS
2782 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
2783 Global state maintained by XSUBs, Interpreter embedded in larger
2784 application, Thread-safety of extensions
2796 =head2 perlnumber - semantics of numbers and numeric operations in Perl
2804 =item Storing numbers
2806 =item Numeric operators and numeric conversions
2808 =item Flavors of Perl numeric operations
2810 Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other
2811 mathematical operators, Bitwise operators, Bitwise operators during C<use
2812 integer>, Operators which expect an integer, Operators which expect a
2821 =head2 perlthrtut - tutorial on threads in Perl
2829 =item What Is A Thread Anyway?
2831 =item Threaded Program Models
2843 =item What kind of threads are Perl threads?
2845 =item Thread-Safe Modules
2851 =item Basic Thread Support
2853 =item A Note about the Examples
2855 =item Creating Threads
2857 =item Waiting For A Thread To Exit
2859 =item Ignoring A Thread
2863 =item Threads And Data
2867 =item Shared And Unshared Data
2869 =item Thread Pitfalls: Races
2873 =item Synchronization and control
2877 =item Controlling access: lock()
2879 =item A Thread Pitfall: Deadlocks
2881 =item Queues: Passing Data Around
2883 =item Semaphores: Synchronizing Data Access
2885 =item Basic semaphores
2887 =item Advanced Semaphores
2889 =item cond_wait() and cond_signal()
2891 =item Giving up control
2895 =item General Thread Utility Routines
2899 =item What Thread Am I In?
2903 =item Are These Threads The Same?
2905 =item What Threads Are Running?
2909 =item A Complete Example
2911 =item Different implementations of threads
2913 =item Performance considerations
2915 =item Process-scope Changes
2917 =item Thread-Safety of System Libraries
2925 =item Introductory Texts
2927 =item OS-Related References
2929 =item Other References
2933 =item Acknowledgements
2941 =head2 perlothrtut - old tutorial on threads in Perl
2947 =item What Is A Thread Anyway?
2949 =item Threaded Program Models
2961 =item Native threads
2963 =item What kind of threads are perl threads?
2965 =item Threadsafe Modules
2971 =item Basic Thread Support
2973 =item Creating Threads
2975 =item Giving up control
2977 =item Waiting For A Thread To Exit
2979 =item Errors In Threads
2981 =item Ignoring A Thread
2985 =item Threads And Data
2989 =item Shared And Unshared Data
2991 =item Thread Pitfall: Races
2993 =item Controlling access: lock()
2995 =item Thread Pitfall: Deadlocks
2997 =item Queues: Passing Data Around
3001 =item Threads And Code
3005 =item Semaphores: Synchronizing Data Access
3007 Basic semaphores, Advanced Semaphores
3009 =item Attributes: Restricting Access To Subroutines
3011 =item Subroutine Locks
3015 =item Locking A Subroutine
3019 =item General Thread Utility Routines
3023 =item What Thread Am I In?
3027 =item Are These Threads The Same?
3029 =item What Threads Are Running?
3033 =item A Complete Example
3041 =item Introductory Texts
3043 =item OS-Related References
3045 =item Other References
3049 =item Acknowledgements
3057 =head2 perlport - Writing portable Perl
3063 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
3072 =item Numbers endianness and Width
3074 =item Files and Filesystems
3076 =item System Interaction
3078 =item Command names versus file pathnames
3082 =item Interprocess Communication (IPC)
3084 =item External Subroutines (XS)
3086 =item Standard Modules
3090 =item Character sets and character encoding
3092 =item Internationalisation
3094 =item System Resources
3104 Mailing list: cpan-testers@perl.org, Testing results:
3105 http://testers.cpan.org/
3113 =item DOS and Derivatives
3121 =item EBCDIC Platforms
3129 =item FUNCTION IMPLEMENTATIONS
3133 =item Alphabetical Listing of Perl Functions
3135 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
3136 FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
3137 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
3138 LIST, exit EXPR, exit, fcntl FILEHANDLE,FUNCTION,SCALAR, flock
3139 FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, getpriority
3140 WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, getpwuid UID,
3141 getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
3142 getservbyport PORT,PROTO, getpwent, getgrent, gethostbyname, gethostent,
3143 getnetent, getprotoent, getservent, sethostent STAYOPEN, setnetent
3144 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
3145 endhostent, endnetent, endprotoent, endservent, getsockopt
3146 SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR,
3147 kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR,
3148 lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv
3149 ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open FILEHANDLE, pipe
3150 READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select
3151 RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
3152 KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
3153 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
3154 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
3155 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
3156 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
3157 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
3158 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
3159 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
3160 wait, waitpid PID,FLAGS
3166 v1.49, 12 August 2002, v1.48, 02 February 2001, v1.47, 22 March 2000,
3167 v1.46, 12 February 2000, v1.45, 20 December 1999, v1.44, 19 July 1999,
3168 v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May 1999, v1.40, 11 April
3169 1999, v1.39, 11 February 1999, v1.38, 31 December 1998, v1.37, 19 December
3170 1998, v1.36, 9 September 1998, v1.35, 13 August 1998, v1.33, 06 August
3171 1998, v1.32, 05 August 1998, v1.30, 03 August 1998, v1.23, 10 July 1998
3173 =item Supported Platforms
3177 =item AUTHORS / CONTRIBUTORS
3181 =head2 perllocale - Perl locale handling (internationalization and
3188 =item PREPARING TO USE LOCALES
3194 =item The use locale pragma
3196 =item The setlocale function
3198 =item Finding locales
3200 =item LOCALE PROBLEMS
3202 =item Temporarily fixing locale problems
3204 =item Permanently fixing locale problems
3206 =item Permanently fixing your system's locale configuration
3208 =item Fixing system locale configuration
3210 =item The localeconv function
3212 =item I18N::Langinfo
3216 =item LOCALE CATEGORIES
3220 =item Category LC_COLLATE: Collation
3222 =item Category LC_CTYPE: Character Types
3224 =item Category LC_NUMERIC: Numeric Formatting
3226 =item Category LC_MONETARY: Formatting of monetary amounts
3230 =item Other categories
3238 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
3239 LC_NUMERIC, LC_TIME, LANG
3245 =item Backward compatibility
3247 =item I18N:Collate obsolete
3249 =item Sort speed and memory use impacts
3251 =item write() and LC_NUMERIC
3253 =item Freely available locale definitions
3257 =item An imperfect standard
3261 =item Unicode and UTF-8
3267 =item Broken systems
3277 =head2 perluniintro - Perl Unicode introduction
3287 =item Perl's Unicode Support
3289 =item Perl's Unicode Model
3291 =item Unicode and EBCDIC
3293 =item Creating Unicode
3295 =item Handling Unicode
3297 =item Legacy Encodings
3301 =item Displaying Unicode As Text
3305 =item Advanced Topics
3309 =item Questions With Answers
3311 =item Hexadecimal Notation
3313 =item Further Resources
3317 =item UNICODE IN OLDER PERLS
3321 =item ACKNOWLEDGMENTS
3323 =item AUTHOR, COPYRIGHT, AND LICENSE
3327 =head2 perlunicode - Unicode support in Perl
3335 =item Important Caveats
3337 Input and Output Layers, Regular Expressions, C<use utf8> still needed to
3338 enable UTF-8/UTF-EBCDIC in scripts
3340 =item Byte and Character Semantics
3342 =item Effects of Character Semantics
3348 =item User-Defined Character Properties
3350 =item Character Encodings for Input and Output
3352 =item Unicode Regular Expression Support Level
3354 =item Unicode Encodings
3356 =item Security Implications of Unicode
3358 =item Unicode in Perl on EBCDIC
3362 =item When Unicode Does Not Happen
3364 =item Forcing Unicode in Perl (Or Unforcing Unicode in Perl)
3366 =item Using Unicode in XS
3374 =item Interaction with Locales
3376 =item Interaction with Extensions
3380 =item Porting code from perl-5.6.X
3388 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
3394 =item COMMON CHARACTER CODE SETS
3402 =item Latin 1 (ISO 8859-1)
3406 =item 13 variant characters
3414 =item Unicode code points versus EBCDIC code points
3416 =item Remaining Perl Unicode problems in EBCDIC
3418 =item Unicode and UTF
3424 =item SINGLE OCTET TABLES
3426 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
3428 =item IDENTIFYING CHARACTER CODE SETS
3442 =item OPERATOR DIFFERENCES
3444 =item FUNCTION DIFFERENCES
3446 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
3448 =item REGULAR EXPRESSION DIFFERENCES
3456 =item Ignore ASCII vs. EBCDIC sort differences.
3458 =item MONO CASE then sort data.
3460 =item Convert, sort data, then re convert.
3462 =item Perform sorting on one type of machine only.
3466 =item TRANSFORMATION FORMATS
3470 =item URL decoding and encoding
3472 =item uu encoding and decoding
3474 =item Quoted-Printable encoding and decoding
3476 =item Caesarian ciphers
3480 =item Hashing order and checksums
3484 =item MULTI OCTET CHARACTER SETS
3496 chcp, dataset access, OS/390, z/OS iconv, locales
3516 =head2 perlsec - Perl security
3524 =item Laundering and Detecting Tainted Data
3526 =item Switches On the "#!" Line
3528 =item Cleaning Up Your Path
3532 =item Protecting Your Programs
3536 =item Algorithmic Complexity Attacks
3544 =head2 perlmod - Perl modules (packages and symbol tables)
3556 =item Package Constructors and Destructors
3562 =item Making your module threadsafe
3570 =head2 perlmodlib - constructing new Perl modules and finding existing ones
3574 =item THE PERL MODULE LIBRARY
3578 =item Pragmatic Modules
3580 assertions, assertions::activate, attributes, attrs, autouse, base, bigint,
3581 bignum, bigrat, blib, bytes, charnames, constant, diagnostics, encoding,
3582 fields, filetest, if, integer, less, lib, locale, open, ops, overload, re,
3583 sigtrap, sort, strict, subs, threads, threads::shared, utf8, vars, version,
3584 vmsish, warnings, warnings::register
3586 =item Standard Modules
3588 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
3589 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
3590 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
3591 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
3592 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
3593 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
3594 Class::Struct, Config, Cwd, DB, DB_File, Data::Dumper, Devel::DProf,
3595 Devel::PPPort, Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5,
3596 DirHandle, Dumpvalue, DynaLoader, Encode, Encode::Alias, Encode::Byte,
3597 Encode::CJKConstants, Encode::CN, Encode::CN::HZ, Encode::Config,
3598 Encode::EBCDIC, Encode::Encoder, Encode::Encoding, Encode::Guess,
3599 Encode::JP, Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR,
3600 Encode::KR::2022_KR, Encode::MIME::Header, Encode::PerlIO,
3601 Encode::Supported, Encode::Symbol, Encode::TW, Encode::Unicode,
3602 Encode::Unicode::UTF7, English, Env, Errno, Exporter, Exporter::Heavy,
3603 ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant,
3604 ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
3605 ExtUtils::MM, ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin,
3606 ExtUtils::MM_DOS, ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2,
3607 ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
3608 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker,
3609 ExtUtils::MakeMaker::FAQ, ExtUtils::MakeMaker::Tutorial,
3610 ExtUtils::MakeMaker::bytes, ExtUtils::MakeMaker::vmsish,
3611 ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists,
3612 ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename,
3613 File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find,
3614 File::Glob, File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc,
3615 File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix,
3616 File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache,
3617 FileHandle, Filter::Simple, Filter::Util::Call, FindBin, GDBM_File,
3618 Getopt::Long, Getopt::Std, Hash::Util, I18N::Collate, I18N::LangTags,
3619 I18N::LangTags::List, I18N::Langinfo, IO, IO::Dir, IO::File, IO::Handle,
3620 IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET,
3621 IO::Socket::UNIX, IPC::Open2, IPC::Open3, IPC::SysV, IPC::SysV::Msg,
3622 IPC::SysV::Semaphore, List::Util, Locale::Constants, Locale::Country,
3623 Locale::Currency, Locale::Language, Locale::Maketext,
3624 Locale::Maketext::TPJ13, Locale::Script, MIME::Base64,
3625 MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt,
3626 Math::BigInt::Calc, Math::BigInt::Scalar, Math::BigRat, Math::Complex,
3627 Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire,
3628 Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File,
3629 Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT, Net::Cmd,
3630 Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3,
3631 Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent,
3632 Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO,
3633 PerlIO::encoding, PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint,
3634 Pod::Checker, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects,
3635 Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser,
3636 Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff,
3637 Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText,
3638 Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer,
3639 Pod::Select, Pod::Text, Pod::Text::Color, Pod::Text::Overstrike,
3640 Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Scalar::Util,
3641 Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch,
3642 Symbol, Sys::Hostname, Sys::Syslog, Term::ANSIColor, Term::Cap,
3643 Term::Complete, Term::ReadLine, Test, Test::Builder, Test::Harness,
3644 Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Straps,
3645 Test::More, Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced,
3646 Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Thread,
3647 Thread::Queue, Thread::Semaphore, Thread::Signal, Thread::Specific,
3648 Tie::Array, Tie::File, Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash,
3649 Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::gmtime,
3650 Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate, Unicode::Normalize,
3651 Unicode::UCD, User::grent, User::pwent, Win32, XS::APItest, XS::Typemap,
3654 =item Extension Modules
3668 China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi
3669 Arabia, Singapore, South Korea, Taiwan, Thailand
3671 =item Central America
3677 Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Czech
3678 Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary,
3679 Iceland, Ireland, Italy, Latvia, Lithuania, Netherlands, Norway, Poland,
3680 Portugal, Romania, Russia, Slovakia, Slovenia, Spain, Sweden, Switzerland,
3681 Turkey, Ukraine, United Kingdom
3685 Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States,
3686 Alabama, California, Colorado, Delaware, District of Columbia, Florida,
3687 Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey, New York,
3688 North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, Utah,
3689 Virginia, Washington, Wisconsin
3693 Australia, New Zealand, United States
3697 Argentina, Brazil, Chile
3703 =item Modules: Creation, Use, and Abuse
3707 =item Guidelines for Module Creation
3709 =item Guidelines for Converting Perl 4 Library Scripts into Modules
3711 =item Guidelines for Reusing Application Code
3719 =head2 perlmodstyle - Perl module style guide
3725 =item QUICK CHECKLIST
3729 =item Before you start
3737 =item Release considerations
3741 =item BEFORE YOU START WRITING A MODULE
3745 =item Has it been done before?
3747 =item Do one thing and do it well
3749 =item What's in a name?
3753 =item DESIGNING AND WRITING YOUR MODULE
3757 =item To OO or not to OO?
3759 =item Designing your API
3761 Write simple routines to do simple things, Separate functionality from
3762 output, Provide sensible shortcuts and defaults, Naming conventions,
3765 =item Strictness and warnings
3767 =item Backwards compatibility
3769 =item Error handling and messages
3773 =item DOCUMENTING YOUR MODULE
3779 =item README, INSTALL, release notes, changelogs
3781 perl Makefile.PL, make, make test, make install, perl Build.PL, perl Build,
3782 perl Build test, perl Build install
3786 =item RELEASE CONSIDERATIONS
3790 =item Version numbering
3792 =item Pre-requisites
3802 =item COMMON PITFALLS
3806 =item Reinventing the wheel
3808 =item Trying to do too much
3810 =item Inappropriate documentation
3816 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Packaging Tools,
3817 Testing tools, http://pause.perl.org/, Any good book on software
3824 =head2 perlmodinstall - Installing CPAN Modules
3834 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
3835 module (sometimes unnecessary), B<INSTALL> the module
3849 =head2 perlnewmod - preparing a new module for distribution
3859 =item What should I make into a module?
3861 =item Step-by-step: Preparing the ground
3863 Look around, Check it's new, Discuss the need, Choose a name, Check again
3865 =item Step-by-step: Making the module
3867 Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
3868 L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
3869 documentation|perlpod>, Write tests, Write the README
3871 =item Step-by-step: Distributing your module
3873 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
3874 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
3884 =head2 perlutil - utilities packaged with the Perl distribution
3894 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
3895 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
3896 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
3897 L<roffitall|roffitall>
3901 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
3903 =item Administration
3905 L<libnetcfg|libnetcfg>
3909 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
3910 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
3918 =head2 perlcompile - Introduction to the Perl Compiler-Translator
3928 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3932 =item Using The Back Ends
3936 =item The Cross Referencing Back End
3940 =item The Decompiling Back End
3942 =item The Lint Back End
3944 =item The Simple C Back End
3946 =item The Bytecode Back End
3948 =item The Optimized C Back End
3952 =item Module List for the Compiler Suite
3954 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3955 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
3956 B::Stackobj, B::Stash, B::Terse, B::Xref
3958 =item KNOWN PROBLEMS
3964 =head2 perlfilter - Source Filters
3974 =item WRITING A SOURCE FILTER
3976 =item WRITING A SOURCE FILTER IN C
3978 B<Decryption Filters>
3980 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
3982 =item WRITING A SOURCE FILTER IN PERL
3984 =item USING CONTEXT: THE DEBUG FILTER
3988 =item THINGS TO LOOK OUT FOR
3990 Some Filters Clobber the C<DATA> Handle
4000 =head2 perlembed - how to embed perl in your C program
4010 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
4011 Perl?>, B<Use C from C?>, B<Use Perl from C?>
4015 =item Compiling your C program
4017 =item Adding a Perl interpreter to your C program
4019 =item Calling a Perl subroutine from your C program
4021 =item Evaluating a Perl statement from your C program
4023 =item Performing Perl pattern matches and substitutions from your C program
4025 =item Fiddling with the Perl stack from your C program
4027 =item Maintaining a persistent interpreter
4029 =item Execution of END blocks
4031 =item Maintaining multiple interpreter instances
4033 =item Using Perl modules, which themselves use C libraries, from your C
4038 =item Embedding Perl under Win32
4050 =head2 perldebguts - Guts of Perl debugging
4056 =item Debugger Internals
4060 =item Writing Your Own Debugger
4064 =item Frame Listing Output Examples
4066 =item Debugging regular expressions
4070 =item Compile-time output
4072 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
4073 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
4074 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
4077 =item Types of nodes
4079 =item Run-time output
4083 =item Debugging Perl memory usage
4087 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
4089 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
4090 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
4093 =item Example of using B<-DL> switch
4095 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
4097 =item B<-DL> details
4101 =item Limitations of B<-DL> statistics
4109 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
4121 =item Version caveat
4123 =item Dynamic Loading versus Static Loading
4135 =item What has gone on?
4137 =item Writing good test scripts
4141 =item What's new here?
4143 =item Input and Output Parameters
4145 =item The XSUBPP Program
4147 =item The TYPEMAP file
4149 =item Warning about Output Arguments
4153 =item What has happened here?
4155 =item Anatomy of .xs file
4157 =item Getting the fat out of XSUBs
4159 =item More about XSUB arguments
4161 =item The Argument Stack
4163 =item Extending your Extension
4165 =item Documenting your Extension
4167 =item Installing your Extension
4171 =item New Things in this Example
4175 =item New Things in this Example
4177 =item EXAMPLE 7 (Coming Soon)
4179 =item EXAMPLE 8 (Coming Soon)
4181 =item EXAMPLE 9 Passing open files to XSes
4183 =item Troubleshooting these Examples
4199 =head2 perlxs - XS language reference manual
4211 =item The Anatomy of an XSUB
4213 =item The Argument Stack
4215 =item The RETVAL Variable
4217 =item The MODULE Keyword
4219 =item The PACKAGE Keyword
4221 =item The PREFIX Keyword
4223 =item The OUTPUT: Keyword
4225 =item The NO_OUTPUT Keyword
4227 =item The CODE: Keyword
4229 =item The INIT: Keyword
4231 =item The NO_INIT Keyword
4233 =item Initializing Function Parameters
4235 =item Default Parameter Values
4237 =item The PREINIT: Keyword
4239 =item The SCOPE: Keyword
4241 =item The INPUT: Keyword
4243 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
4245 =item The C<length(NAME)> Keyword
4247 =item Variable-length Parameter Lists
4249 =item The C_ARGS: Keyword
4251 =item The PPCODE: Keyword
4253 =item Returning Undef And Empty Lists
4255 =item The REQUIRE: Keyword
4257 =item The CLEANUP: Keyword
4259 =item The POSTCALL: Keyword
4261 =item The BOOT: Keyword
4263 =item The VERSIONCHECK: Keyword
4265 =item The PROTOTYPES: Keyword
4267 =item The PROTOTYPE: Keyword
4269 =item The ALIAS: Keyword
4271 =item The OVERLOAD: Keyword
4273 =item The FALLBACK: Keyword
4275 =item The INTERFACE: Keyword
4277 =item The INTERFACE_MACRO: Keyword
4279 =item The INCLUDE: Keyword
4281 =item The CASE: Keyword
4283 =item The & Unary Operator
4285 =item Inserting POD, Comments and C Preprocessor Directives
4287 =item Using XS With C++
4289 =item Interface Strategy
4291 =item Perl Objects And C Structures
4295 =item Safely Storing Static Data in XS
4297 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4309 =head2 perlclib - Internal replacements for standard C library functions
4319 C<t>, C<p>, C<n>, C<s>
4321 =item File Operations
4323 =item File Input and Output
4325 =item File Positioning
4327 =item Memory Management and String Handling
4329 =item Character Class Tests
4331 =item F<stdlib.h> functions
4333 =item Miscellaneous functions
4341 =head2 perlguts - Introduction to the Perl API
4353 =item What is an "IV"?
4355 =item Working with SVs
4359 =item What's Really Stored in an SV?
4361 =item Working with AVs
4363 =item Working with HVs
4365 =item Hash API Extensions
4367 =item AVs, HVs and undefined values
4371 =item Blessed References and Class Objects
4373 =item Creating New Variables
4375 GV_ADDMULTI, GV_ADDWARN
4377 =item Reference Counts and Mortality
4379 =item Stashes and Globs
4381 =item Double-Typed SVs
4383 =item Magic Variables
4385 =item Assigning Magic
4387 =item Magic Virtual Tables
4391 =item Understanding the Magic of Tied Hashes and Arrays
4393 =item Localizing changes
4395 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
4396 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
4397 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
4398 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
4399 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
4400 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
4401 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
4402 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
4403 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
4404 save_hptr(HV **hptr)>
4412 =item XSUBs and the Argument Stack
4414 =item Calling Perl Routines from within C Programs
4416 =item Memory Allocation
4420 =item Putting a C value on Perl stack
4424 =item Scratchpads and recursion
4434 =item Examining the tree
4436 =item Compile pass 1: check routines
4438 =item Compile pass 1a: constant folding
4440 =item Compile pass 2: context propagation
4442 =item Compile pass 3: peephole optimization
4444 =item Pluggable runops
4448 =item Examining internal data structures with the C<dump> functions
4450 =item How multiple interpreters and concurrency are supported
4454 =item Background and PERL_IMPLICIT_CONTEXT
4456 =item So what happened to dTHR?
4458 =item How do I use all this in extensions?
4460 =item Should I do anything special if I call perl from multiple threads?
4462 =item Future Plans and PERL_IMPLICIT_SYS
4466 =item Internal Functions
4468 A, p, d, s, n, r, f, M, o, j, x
4472 =item Formatted Printing of IVs, UVs, and NVs
4474 =item Pointer-To-Integer and Integer-To-Pointer
4476 =item Source Documentation
4480 =item Unicode Support
4484 =item What B<is> Unicode, anyway?
4486 =item How can I recognise a UTF8 string?
4488 =item How does UTF8 represent Unicode characters?
4490 =item How does Perl store UTF8 strings?
4492 =item How do I convert a string to UTF8?
4494 =item Is there anything else I need to know?
4498 =item Custom Operators
4506 =head2 perlcall - Perl calling conventions from C
4512 An Error Handler, An Event Driven Program
4514 =item THE CALL_ FUNCTIONS
4516 call_sv, call_pv, call_method, call_argv
4536 =item Determining the Context
4540 =item KNOWN PROBLEMS
4546 =item No Parameters, Nothing returned
4548 =item Passing Parameters
4550 =item Returning a Scalar
4552 =item Returning a list of values
4554 =item Returning a list in a scalar context
4556 =item Returning Data from Perl via the parameter list
4560 =item Using G_KEEPERR
4564 =item Using call_argv
4566 =item Using call_method
4570 =item Using Perl to dispose of temporaries
4572 =item Strategies for storing Callback Context Information
4574 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
4575 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
4578 =item Alternate Stack Manipulation
4580 =item Creating and calling an anonymous subroutine in C
4592 =head2 perlapi - autogenerated documentation for the perl public API
4598 =item "Gimme" Values
4600 GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
4602 =item Array Manipulation Functions
4604 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4605 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4606 get_av, newAV, Nullav, sortsv
4608 =item Callback Functions
4610 call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
4611 FREETMPS, LEAVE, SAVETMPS
4613 =item Character classes
4615 isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
4617 =item Cloning an interpreter
4621 =item CV Manipulation Functions
4623 CvSTASH, get_cv, Nullcv
4625 =item Embedding Functions
4627 cv_undef, load_module, nothreadhook, perl_alloc, perl_construct,
4628 perl_destruct, perl_free, perl_parse, perl_run, require_pv
4630 =item Functions in file pp_pack.c
4632 packlist, pack_cat, unpackstring, unpack_str
4634 =item Global Variables
4636 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
4640 GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
4641 gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
4645 HEf_SVKEY, Nullch, Nullsv
4647 =item Hash Manipulation Functions
4649 get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set,
4650 HeVAL, HvNAME, hv_clear, hv_delete, hv_delete_ent, hv_exists,
4651 hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey,
4652 hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iternext_flags, hv_iterval,
4653 hv_magic, hv_store, hv_store_ent, hv_undef, newHV, Nullhv
4655 =item Magical Functions
4657 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
4658 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
4659 SvSetSV, SvSetSV_nosteal, SvSHARE
4661 =item Memory Management
4663 Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree,
4664 savepv, savepvn, savesharedpv, StructCopy, Zero
4666 =item Miscellaneous Functions
4668 fbm_compile, fbm_instr, form, getcwd_sv, new_version, scan_version, strEQ,
4669 strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_nolocking,
4670 sv_nosharing, sv_nounlocking, upg_version, vcmp, vnumify, vstringify
4672 =item Numeric functions
4674 grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
4677 =item Optree Manipulation Functions
4679 cv_const_sv, newCONSTSUB, newXS
4681 =item Pad Data Structures
4685 =item Stack Manipulation Macros
4687 dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp,
4688 POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
4689 PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN,
4690 XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
4691 XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
4695 svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
4697 =item SV Manipulation Functions
4699 get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
4700 newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
4701 SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off,
4702 SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIsCOW,
4703 SvIsCOW_shared_hash, SvIV, SvIVx, SvIVX, SvLEN, SvNIOK, SvNIOKp,
4704 SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX,
4705 SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only,
4706 SvPOK_only_UTF8, SvPV, SvPVbyte, SvPVbytex, SvPVbytex_force,
4707 SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, SvPVutf8x, SvPVutf8x_force,
4708 SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX, SvPV_force, SvPV_force_nomg,
4709 SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off,
4710 SvROK_on, SvRV, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on,
4711 SvTRUE, SvTYPE, SvUNLOCK, SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on,
4712 SvUV, SvUVX, SvUVx, SvVOK, sv_2bool, sv_2cv, sv_2io, sv_2iv, sv_2mortal,
4713 sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen, sv_2pvutf8, sv_2pvutf8_nolen,
4714 sv_2pv_flags, sv_2pv_nolen, sv_2uv, sv_backoff, sv_bless, sv_catpv,
4715 sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_flags, sv_catpvn_mg,
4716 sv_catpv_mg, sv_catsv, sv_catsv_flags, sv_catsv_mg, sv_chop, sv_clear,
4717 sv_cmp, sv_cmp_locale, sv_collxfrm, sv_copypv, sv_dec, sv_derived_from,
4718 sv_eq, sv_force_normal, sv_force_normal_flags, sv_free, sv_gets, sv_grow,
4719 sv_inc, sv_insert, sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8,
4720 sv_magic, sv_magicext, sv_mortalcopy, sv_newmortal, sv_newref, sv_nv,
4721 sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force,
4722 sv_pvn, sv_pvn_force, sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n,
4723 sv_pvutf8n_force, sv_reftype, sv_replace, sv_report_used, sv_reset,
4724 sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv,
4725 sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn,
4726 sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv,
4727 sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg,
4728 sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref,
4729 sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg,
4730 sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade,
4731 sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn
4733 =item Unicode Support
4735 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
4736 pv_uni_display, sv_cat_decode, sv_recode_to_utf8, sv_uni_display,
4737 to_utf8_case, to_utf8_fold, to_utf8_lower, to_utf8_title, to_utf8_upper,
4738 utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length,
4739 utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8,
4742 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
4744 ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST,
4745 THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK
4747 =item Warning and Dieing
4757 =head2 perlintern - autogenerated documentation of purely B<internal>
4764 =item CV reference counts and CvOUTSIDE
4768 =item Functions in file pad.h
4770 CX_CURPAD_SAVE, CX_CURPAD_SV, PAD_BASE_SV, PAD_CLONE_VARS,
4771 PAD_COMPNAME_FLAGS, PAD_COMPNAME_GEN, PAD_COMPNAME_OURSTASH,
4772 PAD_COMPNAME_PV, PAD_COMPNAME_TYPE, PAD_DUP, PAD_RESTORE_LOCAL,
4773 PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV, PAD_SET_CUR, PAD_SV,
4774 PAD_SVl, SAVECLEARSV, SAVECOMPPAD, SAVEPADSV
4776 =item Functions in file pp_ctl.c
4780 =item Global Variables
4782 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
4793 =item Pad Data Structures
4795 CvPADLIST, cv_clone, cv_dump, do_dump_pad, intro_my, pad_add_anon,
4796 pad_add_name, pad_alloc, pad_block_start, pad_check_dup, pad_findlex,
4797 pad_findmy, pad_fixup_inner_anons, pad_free, pad_leavemy, pad_new,
4798 pad_push, pad_reset, pad_setsv, pad_swipe, pad_tidy, pad_undef
4800 =item Stack Manipulation Macros
4804 =item SV Manipulation Functions
4806 report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
4814 =head2 perliol - C API for Perl's implementation of IO in Layers.
4824 =item History and Background
4826 =item Layers vs Disciplines
4828 =item Data Structures
4830 =item Functions and Attributes
4832 =item Per-instance Data
4834 =item Layers in action.
4836 =item Per-instance flag bits
4838 PERLIO_F_EOF, PERLIO_F_CANWRITE, PERLIO_F_CANREAD, PERLIO_F_ERROR,
4839 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4840 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4841 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4843 =item Methods in Detail
4845 fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF,
4846 PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode,
4847 Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof,
4848 Error, Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
4851 =item Implementing PerlIO Layers
4853 C implementations, Perl implementations
4857 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4859 =item Extension Layers
4861 ":encoding", ":scalar", ":via"
4869 =head2 perlapio - perl's IO abstraction interface.
4877 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4878 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4879 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4880 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4881 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4882 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4883 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4884 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4885 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4886 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4887 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4891 =item Co-existence with stdio
4893 B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
4894 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
4896 =item "Fast gets" Functions
4898 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4899 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4900 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4901 B<PerlIO_get_bufsiz(f)>
4903 =item Other Functions
4905 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4906 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4912 =head2 perlhack - How to hack at the Perl internals
4918 Does concept match the general goals of Perl?, Where is the
4919 implementation?, Backwards compatibility, Could it be a module instead?, Is
4920 the feature generic enough?, Does it potentially introduce new bugs?, Does
4921 it preclude other desirable features?, Is the implementation robust?, Is
4922 the implementation generic enough to be portable?, Is the implementation
4923 tested?, Is there enough documentation?, Is there another way to do it?,
4924 Does it create too much work?, Patches speak louder than words
4928 =item Keeping in sync
4930 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
4931 NFS, rsync'ing the patches
4933 =item Why rsync the source tree
4935 It's easier to rsync the source tree, It's more reliable
4937 =item Why rsync the patches
4939 It's easier to rsync the patches, It's a good reference, Finding a start
4940 point, Finding how to fix a bug, Finding the source of misbehaviour
4942 =item Perlbug administration
4944 =item Submitting patches
4946 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
4947 F<Porting/pumpkin.pod>, The perl5-porters FAQ
4949 =item Finding Your Way Around
4951 Core modules, Tests, Documentation, Configure, Interpreter
4953 =item Elements of the interpreter
4955 Startup, Parsing, Optimization, Running
4957 =item Internal Variable Types
4963 Argument stack, Mark stack, Save stack
4965 =item Millions of Macros
4967 =item The .i Targets
4969 =item Poking at Perl
4971 =item Using a source-level debugger
4973 run [args], break function_name, break source.c:xxx, step, next, continue,
4974 finish, 'enter', print
4976 =item gdb macro support
4978 =item Dumping Perl Data Structures
4982 =item Patching a core module
4984 =item Adding a new function to the core
4986 =item Writing a test
4988 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
4989 F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base t/comp,
4990 t/cmd t/run t/io t/op, t/lib ext lib
4992 =item Special Make Test Targets
4994 coretest, test.deparse, minitest, test.valgrind check.valgrind
4995 utest.valgrind ucheck.valgrind, test.third check.third utest.third
4996 ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8,
4999 =item Running tests by hand
5001 PERL_CORE=1, PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST
5005 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5009 =item Rational Software's Purify
5011 =item Purify on Unix
5013 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5017 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5021 =item Compaq's/Digital's/HP's Third Degree
5023 =item PERL_DESTRUCT_LEVEL
5027 =item Gprof Profiling
5029 -a, -b, -e routine, -f routine, -s, -z
5031 =item GCC gcov Profiling
5033 =item Pixie Profiling
5035 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5038 =item Miscellaneous tricks
5042 I<The Road goes ever on and on, down from the door where it began.>
5050 =head2 perlbook - Perl book information
5058 =head2 perltodo - Perl TO-DO List
5064 =item To do during 5.6.x
5068 =item Support for I/O disciplines
5070 =item Autoload bytes.pm
5072 =item Make "\u{XXXX}" et al work
5074 =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
5076 =item Overloadable regex assertions
5080 =item Work out exit/die semantics for threads
5082 =item Better support for nonpreemptive threading systems like GNU pth
5084 =item Typed lexicals for compiler
5086 =item Compiler workarounds for Win32
5088 =item AUTOLOADing in the compiler
5090 =item Fixing comppadlist when compiling
5092 =item Cleaning up exported namespace
5094 =item Complete signal handling
5096 =item Out-of-source builds
5098 =item POSIX realtime support
5100 =item UNIX98 support
5104 =item Long double conversion
5108 =item Arithmetic on non-Arabic numerals
5110 =item POSIX Unicode character classes
5112 =item Factoring out common suffices/prefices in regexps (trie optimization)
5114 =item Security audit shipped utilities
5116 =item Sort out the uid-setting mess
5118 =item Custom opcodes
5120 =item DLL Versioning
5122 =item Introduce @( and @)
5124 =item Floating point handling
5126 =item IV/UV preservation
5128 =item Replace pod2html with something using Pod::Parser
5130 =item Automate module testing on CPAN
5132 =item sendmsg and recvmsg
5134 =item Rewrite perlre documentation
5136 =item Convert example code to IO::Handle filehandles
5138 =item Document Win32 choices
5140 =item Check new modules
5142 =item Make roffitall find pods and libs itself
5146 =item To do at some point
5150 =item Remove regular expression recursion
5152 =item Memory leaks after failed eval
5154 =item bitfields in pack
5156 =item Cross compilation
5158 =item Perl preprocessor / macros
5160 =item Perl lexer in Perl
5162 =item Using POSIX calls internally
5164 =item -i rename file when changed
5166 =item All ARGV input should act like E<lt>E<gt>
5168 =item Support for rerunning debugger
5170 =item Test Suite for the Debugger
5172 =item my sub foo { }
5174 =item One-pass global destruction
5176 =item Rewrite regexp parser
5178 =item Cache recently used regexps
5180 =item Cross-compilation support
5182 =item Bit-shifting bitvectors
5184 =item debugger pragma
5186 =item use less pragma
5188 =item switch structures
5190 =item Cache eval tree
5194 =item Shrink opcode tables
5196 =item Optimize away @_
5198 =item Prototypes versus indirect objects
5202 =item Prototype method calls
5204 =item Return context prototype declarations
5208 =item Garbage collection
5212 =item Rewrite perldoc
5214 =item Install .3p manpages
5216 =item Unicode tutorial
5218 =item Update POSIX.pm for 1003.1-2
5220 =item Retargetable installation
5222 =item POSIX emulation on non-POSIX systems
5224 =item Rename Win32 headers
5226 =item Finish off lvalue functions
5228 =item Update sprintf documentation
5230 =item Use fchown/fchmod internally
5232 =item Make v-strings overloaded objects
5234 =item Allow restricted hash assignment
5236 =item Should overload be inheritable?
5240 =item Perform correctly when XSUBs call subroutines that exit via
5241 goto(LABEL) and friends
5249 =item ref() in list context
5251 =item Make tr/// return histogram of characters in list context
5253 =item Compile to real threaded code
5255 =item Structured types
5257 =item Modifiable $1 et al.
5259 =item Procedural interfaces for IO::*, etc.
5263 =item Attach/detach debugger from running program
5267 =item foreach(reverse ...)
5269 =item Constant function cache
5271 =item Approximate regular expression matching
5279 =item Update guts documentation
5281 =item Add more tests
5283 =item Update auxiliary tools
5285 =item Create debugging macros
5287 =item truncate to the people
5289 =item Unicode in Filenames
5293 =item Unicode in %ENV
5295 =item Recently done things
5299 =item Alternative RE syntax module
5301 =item Safe signal handling
5307 =item setitimer and getimiter
5309 =item Testing __DIE__ hook
5311 =item CPP equivalent in Perl
5313 =item Explicit switch statements
5321 =item perlcc to produce executable
5323 =item END blocks saved in compiled output
5325 =item Secure temporary file module
5327 =item Integrate Time::HiRes
5329 =item Turn Cwd into XS
5331 =item Mmap for input
5333 =item Byte to/from UTF8 and UTF8 to/from local conversion
5335 =item Add sockatmark support
5337 =item Mailing list archives
5341 =item Integrate MacPerl
5343 =item Web "nerve center" for Perl
5345 =item Regular expression tutorial
5347 =item Debugging Tutorial
5349 =item Integrate new modules
5351 =item Integrate profiler
5353 =item Y2K error detection
5355 =item Regular expression debugger
5359 =item "Dynamic" lexicals
5361 =item Cache precompiled modules
5365 =item Deprecated Wishes
5369 =item Loop control on do{}
5371 =item Lexically scoped typeglobs
5377 =item Generalised want()/caller())
5379 =item Named prototypes
5381 =item Built-in globbing
5383 =item Regression tests for suidperl
5385 =item Cached hash values
5387 =item Add compression modules
5389 =item Reorganise documentation into tutorials/references
5391 =item Remove distinction between functions and operators
5393 =item Make XS easier to use
5395 =item Make embedding easier to use
5399 =item my $Package::variable
5401 =item "or" tests defined, not truth
5403 =item "class"-based lexicals
5407 =item Lazy evaluation / tail recursion removal
5409 =item Make "use utf8" the default
5411 =item Unicode collation and normalization
5413 =item pack/unpack tutorial
5419 =head2 perldoc - Look up Perl documentation in Pod format.
5429 B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
5430 I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
5431 I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
5432 B<-w> I<option:value> or B<-w> I<option>, B<-X>,
5433 B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
5444 =head2 perlhist - the Perl history records
5452 =item THE KEEPERS OF THE PUMPKIN
5464 =item SELECTED RELEASE SIZES
5466 =item SELECTED PATCH SIZES
5470 =item THE KEEPERS OF THE RECORDS
5474 =head2 perldelta - what is new for perl v5.9.0
5480 =item Incompatible Changes
5484 =item The C<$*> variable has been removed
5488 =item Core Enhancements
5492 =item Tied Arrays with Negative Array Indices
5496 =item Modules and Pragmata
5498 =item Utility Changes
5500 =item New Documentation
5502 =item Performance Enhancements
5504 =item Installation and Configuration Improvements
5506 =item Selected Bug Fixes
5508 =item New or Changed Diagnostics
5510 =item Changed Internals
5514 =item Known Problems
5516 =item Platform Specific Problems
5518 =item Reporting Bugs
5524 =head2 perl58delta, perldelta - what is new for perl v5.8.0
5530 =item Highlights In 5.8.0
5532 =item Incompatible Changes
5536 =item Binary Incompatibility
5538 =item 64-bit platforms and malloc
5540 =item AIX Dynaloading
5542 =item Attributes for C<my> variables now handled at run-time
5544 =item Socket Extension Dynamic in VMS
5546 =item IEEE-format Floating Point Default on OpenVMS Alpha
5548 =item New Unicode Semantics (no more C<use utf8>, almost)
5550 =item New Unicode Properties
5552 =item REF(...) Instead Of SCALAR(...)
5554 =item pack/unpack D/F recycled
5556 =item glob() now returns filenames in alphabetical order
5562 =item Core Enhancements
5566 =item Unicode Overhaul
5568 =item PerlIO is Now The Default
5572 =item Restricted Hashes
5576 =item Understanding of Numbers
5578 =item Arrays now always interpolate into double-quoted strings [561]
5580 =item Miscellaneous Changes
5584 =item Modules and Pragmata
5588 =item New Modules and Pragmata
5590 =item Updated And Improved Modules and Pragmata
5594 =item Utility Changes
5596 =item New Documentation
5598 =item Performance Enhancements
5600 =item Installation and Configuration Improvements
5604 =item Generic Improvements
5606 =item New Or Improved Platforms
5610 =item Selected Bug Fixes
5614 =item Platform Specific Changes and Fixes
5618 =item New or Changed Diagnostics
5620 =item Changed Internals
5622 =item Security Vulnerability Closed [561]
5626 =item Known Problems
5630 =item The Compiler Suite Is Still Very Experimental
5632 =item Localising Tied Arrays and Hashes Is Broken
5634 =item Building Extensions Can Fail Because Of Largefiles
5636 =item Modifying $_ Inside for(..)
5638 =item mod_perl 1.26 Doesn't Build With Threaded Perl
5640 =item lib/ftmp-security tests warn 'system possibly insecure'
5642 =item libwww-perl (LWP) fails base/date #51
5644 =item PDL failing some tests
5648 =item Self-tying Problems
5650 =item ext/threads/t/libc
5652 =item Failure of Thread (5.005-style) tests
5654 =item Timing problems
5656 =item Tied/Magical Array/Hash Elements Do Not Autovivify
5658 =item Unicode in package/class and subroutine names does not work
5662 =item Platform Specific Problems
5668 =item Alpha systems with old gccs fail several tests
5674 =item Cygwin "unable to remap"
5676 =item Cygwin ndbm tests fail on FAT
5678 =item DJGPP Failures
5680 =item FreeBSD built with ithreads coredumps reading large directories
5682 =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
5684 =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
5686 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5688 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
5690 =item Linux With Sfio Fails op/misc Test 48
5694 =item Mac OS X dyld undefined symbols
5696 =item OS/2 Test Failures
5698 =item op/sprintf tests 91, 129, and 130
5704 =item Solaris x86 Fails Tests With -Duse64bitint
5706 =item SUPER-UX (NEC SX)
5708 =item Term::ReadKey not working on Win32
5720 =item XML::Parser not working
5724 =item Unicode Support on EBCDIC Still Spotty
5726 =item Seen In Perl 5.7 But Gone Now
5730 =item Reporting Bugs
5738 =head2 perl573delta - what's new for perl v5.7.3
5746 =item Reporting Bugs
5754 =head2 perl572delta - what's new for perl v5.7.2
5760 =item Security Vulnerability Closed
5762 =item Incompatible Changes
5766 =item 64-bit platforms and malloc
5768 =item AIX Dynaloading
5770 =item Socket Extension Dynamic in VMS
5772 =item Different Definition of the Unicode Character Classes \p{In...}
5778 =item Core Enhancements
5780 =item Modules and Pragmata
5784 =item New Modules and Distributions
5786 =item Updated And Improved Modules and Pragmata
5790 =item Utility Changes
5792 =item New Documentation
5794 =item Installation and Configuration Improvements
5798 =item New Or Improved Platforms
5800 =item Generic Improvements
5804 =item Selected Bug Fixes
5808 =item Platform Specific Changes and Fixes
5812 =item New or Changed Diagnostics
5814 =item Source Code Enhancements
5818 =item MAGIC constants
5820 =item Better commented code
5822 =item Regex pre-/post-compilation items matched up
5830 =item Known Problems
5836 =item Amiga Perl Invoking Mystery
5838 =item lib/ftmp-security tests warn 'system possibly insecure'
5840 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
5842 =item HP-UX lib/io_multihomed Fails When LP64-Configured
5844 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5846 =item Linux With Sfio Fails op/misc Test 48
5850 =item op/sprintf tests 129 and 130
5852 =item Failure of Thread tests
5862 =item Localising a Tied Variable Leaks Memory
5864 =item Self-tying of Arrays and Hashes Is Forbidden
5866 =item Variable Attributes are not Currently Usable for Tieing
5868 =item Building Extensions Can Fail Because Of Largefiles
5870 =item The Compiler Suite Is Still Experimental
5872 =item The Long Double Support is Still Experimental
5876 =item Reporting Bugs
5884 =head2 perl571delta - what's new for perl v5.7.1
5890 =item Security Vulnerability Closed
5892 =item Incompatible Changes
5894 =item Core Enhancements
5898 =item AUTOLOAD Is Now Lvaluable
5900 =item PerlIO is Now The Default
5902 =item Signals Are Now Safe
5906 =item Modules and Pragmata
5912 =item Updated And Improved Modules and Pragmata
5916 =item Performance Enhancements
5918 =item Utility Changes
5920 =item New Documentation
5936 =item README.solaris
5940 =item Porting/repository.pod
5944 =item Installation and Configuration Improvements
5948 =item New Or Improved Platforms
5950 =item Generic Improvements
5952 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
5953 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
5954 d_strtoq, d_u32align, d_ualarm, d_usleep
5958 =item Selected Bug Fixes
5962 =item Platform Specific Changes and Fixes
5966 =item New or Changed Diagnostics
5968 =item Changed Internals
5972 =item Known Problems
5976 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
5978 =item lib/ftmp-security tests warn 'system possibly insecure'
5980 =item lib/io_multihomed Fails In LP64-Configured HP-UX
5982 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5986 =item Linux With Sfio Fails op/misc Test 48
5988 =item sigaction test 13 in VMS
5990 =item sprintf tests 129 and 130
5992 =item Failure of Thread tests
5994 =item Localising a Tied Variable Leaks Memory
5996 =item Self-tying of Arrays and Hashes Is Forbidden
5998 =item Building Extensions Can Fail Because Of Largefiles
6000 =item The Compiler Suite Is Still Experimental
6004 =item Reporting Bugs
6012 =head2 perl570delta - what's new for perl v5.7.0
6018 =item Security Vulnerability Closed
6020 =item Incompatible Changes
6022 =item Core Enhancements
6024 =item Modules and Pragmata
6030 =item Updated And Improved Modules and Pragmata
6034 =item Utility Changes
6036 =item New Documentation
6038 =item Performance Enhancements
6040 =item Installation and Configuration Improvements
6044 =item Generic Improvements
6048 =item Selected Bug Fixes
6052 =item Platform Specific Changes and Fixes
6056 =item New or Changed Diagnostics
6058 =item Changed Internals
6060 =item Known Problems
6064 =item Unicode Support Still Far From Perfect
6066 =item EBCDIC Still A Lost Platform
6068 =item Building Extensions Can Fail Because Of Largefiles
6070 =item ftmp-security tests warn 'system possibly insecure'
6072 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
6074 =item Long Doubles Still Don't Work In Solaris
6076 =item Linux With Sfio Fails op/misc Test 48
6078 =item Storable tests fail in some platforms
6080 =item Threads Are Still Experimental
6082 =item The Compiler Suite Is Still Experimental
6086 =item Reporting Bugs
6094 =head2 perl561delta - what's new for perl v5.6.x
6100 =item Summary of changes between 5.6.0 and 5.6.1
6104 =item Security Issues
6106 =item Core bug fixes
6108 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
6109 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
6110 references to special variables, Lexical warnings, Spurious warnings and
6111 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
6112 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
6113 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
6118 =item Configuration issues
6122 =item Bundled modules
6124 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
6125 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
6126 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
6127 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
6129 =item Platform-specific improvements
6131 NCR MP-RAS, NonStop-UX
6135 =item Core Enhancements
6139 =item Interpreter cloning, threads, and concurrency
6141 =item Lexically scoped warning categories
6143 =item Unicode and UTF-8 support
6145 =item Support for interpolating named characters
6147 =item "our" declarations
6149 =item Support for strings represented as a vector of ordinals
6151 =item Improved Perl version numbering system
6153 =item New syntax for declaring subroutine attributes
6155 =item File and directory handles can be autovivified
6157 =item open() with more than two arguments
6159 =item 64-bit support
6161 =item Large file support
6167 =item Enhanced support for sort() subroutines
6169 =item C<sort $coderef @foo> allowed
6171 =item File globbing implemented internally
6173 =item Support for CHECK blocks
6175 =item POSIX character class syntax [: :] supported
6177 =item Better pseudo-random number generator
6179 =item Improved C<qw//> operator
6181 =item Better worst-case behavior of hashes
6183 =item pack() format 'Z' supported
6185 =item pack() format modifier '!' supported
6187 =item pack() and unpack() support counted strings
6189 =item Comments in pack() templates
6191 =item Weak references
6193 =item Binary numbers supported
6195 =item Lvalue subroutines
6197 =item Some arrows may be omitted in calls through references
6199 =item Boolean assignment operators are legal lvalues
6201 =item exists() is supported on subroutine names
6203 =item exists() and delete() are supported on array elements
6205 =item Pseudo-hashes work better
6207 =item Automatic flushing of output buffers
6209 =item Better diagnostics on meaningless filehandle operations
6211 =item Where possible, buffered data discarded from duped input filehandle
6213 =item eof() has the same old magic as <>
6215 =item binmode() can be used to set :crlf and :raw modes
6217 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6219 =item system(), backticks and pipe open now reflect exec() failure
6221 =item Improved diagnostics
6223 =item Diagnostics follow STDERR
6225 =item More consistent close-on-exec behavior
6227 =item syswrite() ease-of-use
6229 =item Better syntax checks on parenthesized unary operators
6231 =item Bit operators support full native integer width
6233 =item Improved security features
6235 =item More functional bareword prototype (*)
6237 =item C<require> and C<do> may be overridden
6239 =item $^X variables may now have names longer than one character
6241 =item New variable $^C reflects C<-c> switch
6243 =item New variable $^V contains Perl version as a string
6245 =item Optional Y2K warnings
6247 =item Arrays now always interpolate into double-quoted strings
6251 =item Modules and Pragmata
6257 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6258 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6259 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6260 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6261 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6262 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6263 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6264 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6270 =item Utility Changes
6284 =item The Perl Debugger
6288 =item Improved Documentation
6290 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6291 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6292 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6293 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6295 =item Performance enhancements
6299 =item Simple sort() using { $a <=> $b } and the like are optimized
6301 =item Optimized assignments to lexical variables
6303 =item Faster subroutine calls
6305 =item delete(), each(), values() and hash iteration are faster
6309 =item Installation and Configuration Improvements
6313 =item -Dusethreads means something different
6315 =item New Configure flags
6317 =item Threadedness and 64-bitness now more daring
6323 =item -Duselargefiles
6325 =item installusrbinperl
6331 =item Enhanced Installation Directories
6333 =item gcc automatically tried if 'cc' does not seem to be working
6337 =item Platform specific changes
6341 =item Supported platforms
6345 =item OS390 (OpenEdition MVS)
6353 =item Significant bug fixes
6357 =item <HANDLE> on empty files
6359 =item C<eval '...'> improvements
6361 =item All compilation errors are true errors
6363 =item Implicitly closed filehandles are safer
6365 =item Behavior of list slices is more consistent
6367 =item C<(\$)> prototype and C<$foo{a}>
6369 =item C<goto &sub> and AUTOLOAD
6371 =item C<-bareword> allowed under C<use integer>
6373 =item Failures in DESTROY()
6375 =item Locale bugs fixed
6379 =item Spurious subroutine stubs after failed subroutine calls
6381 =item Taint failures under C<-U>
6383 =item END blocks and the C<-c> switch
6385 =item Potential to leak DATA filehandles
6389 =item New or Changed Diagnostics
6391 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6392 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6393 / cannot take a count, / must be followed by a, A or Z, / must be followed
6394 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6395 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6396 passed through, /%s/ should probably be written as "%s", %s() called too
6397 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6398 argument is not a HASH or ARRAY element or slice, %s argument is not a
6399 subroutine name, %s package attribute may clash with future reserved word:
6400 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6401 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6402 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6403 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6404 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6405 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6406 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6407 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6408 weaken a nonreference, Character class [:%s:] unknown, Character class
6409 syntax [%s] belongs inside character classes, Constant is not %s reference,
6410 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6411 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6412 "local" instead of "our"?), Document contains no data, entering effective
6413 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6414 output, flock() on closed filehandle %s, Global symbol "%s" requires
6415 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6416 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6417 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6418 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6419 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6420 separator character %s in attribute list, Invalid separator character %s in
6421 subroutine attribute list, leaving effective %s failed, Lvalue subs
6422 returning %s not implemented yet, Method %s not permitted, Missing
6423 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6424 No %s specified for -%c, No package name allowed for variable %s in "our",
6425 No space allowed after -%c, no UTC offset information; assuming local time
6426 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6427 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6428 around "%s" list, Possible unintended interpolation of %s in string,
6429 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6430 instead, Premature end of script headers, Repeat count in pack overflows,
6431 Repeat count in unpack overflows, realloc() of freed memory ignored,
6432 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6433 zero-length expression, switching effective %s is not implemented, This
6434 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6435 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6436 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6437 escape \\%c passed through, Unterminated attribute parameter in attribute
6438 list, Unterminated attribute list, Unterminated attribute parameter in
6439 subroutine attribute list, Unterminated subroutine attribute list, Value of
6440 CLI symbol "%s" too long, Version number must be a constant number
6444 =item Incompatible Changes
6448 =item Perl Source Incompatibilities
6450 CHECK is a new keyword, Treatment of list slices of undef has changed,
6451 Format of $English::PERL_VERSION is different, Literals of the form
6452 C<1.2.3> parse differently, Possibly changed pseudo-random number
6453 generator, Hashing function for hash keys has changed, C<undef> fails on
6454 read only values, Close-on-exec bit may be set on pipe and socket handles,
6455 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6456 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6457 Text of some diagnostic output has changed, C<%@> has been removed,
6458 Parenthesized not() behaves like a list operator, Semantics of bareword
6459 prototype C<(*)> have changed, Semantics of bit operators may have changed
6460 on 64-bit platforms, More builtins taint their results
6462 =item C Source Incompatibilities
6464 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6466 =item Compatible C Source API Changes
6468 C<PATCHLEVEL> is now C<PERL_VERSION>
6470 =item Binary Incompatibilities
6474 =item Known Problems
6478 =item Localizing a tied hash element may leak memory
6480 =item Known test failures
6482 =item EBCDIC platforms not fully supported
6484 =item UNICOS/mk CC failures during Configure run
6486 =item Arrow operator and arrays
6488 =item Experimental features
6490 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6491 pseudo-hash data type, The Compiler suite, Internal implementation of file
6492 globbing, The DB module, The regular expression code constructs:
6496 =item Obsolete Diagnostics
6498 Character class syntax [: :] is reserved for future extensions, Ill-formed
6499 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6500 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6501 to mean "${$}<digit>" is deprecated
6503 =item Reporting Bugs
6511 =head2 perl56delta - what's new for perl v5.6.0
6517 =item Core Enhancements
6521 =item Interpreter cloning, threads, and concurrency
6523 =item Lexically scoped warning categories
6525 =item Unicode and UTF-8 support
6527 =item Support for interpolating named characters
6529 =item "our" declarations
6531 =item Support for strings represented as a vector of ordinals
6533 =item Improved Perl version numbering system
6535 =item New syntax for declaring subroutine attributes
6537 =item File and directory handles can be autovivified
6539 =item open() with more than two arguments
6541 =item 64-bit support
6543 =item Large file support
6549 =item Enhanced support for sort() subroutines
6551 =item C<sort $coderef @foo> allowed
6553 =item File globbing implemented internally
6555 =item Support for CHECK blocks
6557 =item POSIX character class syntax [: :] supported
6559 =item Better pseudo-random number generator
6561 =item Improved C<qw//> operator
6563 =item Better worst-case behavior of hashes
6565 =item pack() format 'Z' supported
6567 =item pack() format modifier '!' supported
6569 =item pack() and unpack() support counted strings
6571 =item Comments in pack() templates
6573 =item Weak references
6575 =item Binary numbers supported
6577 =item Lvalue subroutines
6579 =item Some arrows may be omitted in calls through references
6581 =item Boolean assignment operators are legal lvalues
6583 =item exists() is supported on subroutine names
6585 =item exists() and delete() are supported on array elements
6587 =item Pseudo-hashes work better
6589 =item Automatic flushing of output buffers
6591 =item Better diagnostics on meaningless filehandle operations
6593 =item Where possible, buffered data discarded from duped input filehandle
6595 =item eof() has the same old magic as <>
6597 =item binmode() can be used to set :crlf and :raw modes
6599 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6601 =item system(), backticks and pipe open now reflect exec() failure
6603 =item Improved diagnostics
6605 =item Diagnostics follow STDERR
6607 =item More consistent close-on-exec behavior
6609 =item syswrite() ease-of-use
6611 =item Better syntax checks on parenthesized unary operators
6613 =item Bit operators support full native integer width
6615 =item Improved security features
6617 =item More functional bareword prototype (*)
6619 =item C<require> and C<do> may be overridden
6621 =item $^X variables may now have names longer than one character
6623 =item New variable $^C reflects C<-c> switch
6625 =item New variable $^V contains Perl version as a string
6627 =item Optional Y2K warnings
6629 =item Arrays now always interpolate into double-quoted strings
6633 =item Modules and Pragmata
6639 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6640 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6641 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6642 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6643 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6644 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6645 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6646 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6652 =item Utility Changes
6666 =item The Perl Debugger
6670 =item Improved Documentation
6672 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6673 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6674 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6675 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6677 =item Performance enhancements
6681 =item Simple sort() using { $a <=> $b } and the like are optimized
6683 =item Optimized assignments to lexical variables
6685 =item Faster subroutine calls
6687 =item delete(), each(), values() and hash iteration are faster
6691 =item Installation and Configuration Improvements
6695 =item -Dusethreads means something different
6697 =item New Configure flags
6699 =item Threadedness and 64-bitness now more daring
6705 =item -Duselargefiles
6707 =item installusrbinperl
6713 =item Enhanced Installation Directories
6717 =item Platform specific changes
6721 =item Supported platforms
6725 =item OS390 (OpenEdition MVS)
6733 =item Significant bug fixes
6737 =item <HANDLE> on empty files
6739 =item C<eval '...'> improvements
6741 =item All compilation errors are true errors
6743 =item Implicitly closed filehandles are safer
6745 =item Behavior of list slices is more consistent
6747 =item C<(\$)> prototype and C<$foo{a}>
6749 =item C<goto &sub> and AUTOLOAD
6751 =item C<-bareword> allowed under C<use integer>
6753 =item Failures in DESTROY()
6755 =item Locale bugs fixed
6759 =item Spurious subroutine stubs after failed subroutine calls
6761 =item Taint failures under C<-U>
6763 =item END blocks and the C<-c> switch
6765 =item Potential to leak DATA filehandles
6769 =item New or Changed Diagnostics
6771 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6772 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6773 / cannot take a count, / must be followed by a, A or Z, / must be followed
6774 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6775 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6776 passed through, /%s/ should probably be written as "%s", %s() called too
6777 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6778 argument is not a HASH or ARRAY element or slice, %s argument is not a
6779 subroutine name, %s package attribute may clash with future reserved word:
6780 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6781 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6782 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6783 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6784 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6785 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6786 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6787 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6788 weaken a nonreference, Character class [:%s:] unknown, Character class
6789 syntax [%s] belongs inside character classes, Constant is not %s reference,
6790 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6791 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6792 "local" instead of "our"?), Document contains no data, entering effective
6793 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6794 output, flock() on closed filehandle %s, Global symbol "%s" requires
6795 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6796 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6797 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6798 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6799 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6800 separator character %s in attribute list, Invalid separator character %s in
6801 subroutine attribute list, leaving effective %s failed, Lvalue subs
6802 returning %s not implemented yet, Method %s not permitted, Missing
6803 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6804 No %s specified for -%c, No package name allowed for variable %s in "our",
6805 No space allowed after -%c, no UTC offset information; assuming local time
6806 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6807 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6808 around "%s" list, Possible unintended interpolation of %s in string,
6809 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6810 instead, Premature end of script headers, Repeat count in pack overflows,
6811 Repeat count in unpack overflows, realloc() of freed memory ignored,
6812 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6813 zero-length expression, switching effective %s is not implemented, This
6814 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6815 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6816 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6817 escape \\%c passed through, Unterminated attribute parameter in attribute
6818 list, Unterminated attribute list, Unterminated attribute parameter in
6819 subroutine attribute list, Unterminated subroutine attribute list, Value of
6820 CLI symbol "%s" too long, Version number must be a constant number
6824 =item Incompatible Changes
6828 =item Perl Source Incompatibilities
6830 CHECK is a new keyword, Treatment of list slices of undef has changed,
6831 Format of $English::PERL_VERSION is different, Literals of the form
6832 C<1.2.3> parse differently, Possibly changed pseudo-random number
6833 generator, Hashing function for hash keys has changed, C<undef> fails on
6834 read only values, Close-on-exec bit may be set on pipe and socket handles,
6835 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6836 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6837 Text of some diagnostic output has changed, C<%@> has been removed,
6838 Parenthesized not() behaves like a list operator, Semantics of bareword
6839 prototype C<(*)> have changed, Semantics of bit operators may have changed
6840 on 64-bit platforms, More builtins taint their results
6842 =item C Source Incompatibilities
6844 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6846 =item Compatible C Source API Changes
6848 C<PATCHLEVEL> is now C<PERL_VERSION>
6850 =item Binary Incompatibilities
6854 =item Known Problems
6858 =item Thread test failures
6860 =item EBCDIC platforms not supported
6862 =item In 64-bit HP-UX the lib/io_multihomed test may hang
6864 =item NEXTSTEP 3.3 POSIX test failure
6866 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
6869 =item UNICOS/mk CC failures during Configure run
6871 =item Arrow operator and arrays
6873 =item Experimental features
6875 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6876 pseudo-hash data type, The Compiler suite, Internal implementation of file
6877 globbing, The DB module, The regular expression code constructs:
6881 =item Obsolete Diagnostics
6883 Character class syntax [: :] is reserved for future extensions, Ill-formed
6884 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6885 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6886 to mean "${$}<digit>" is deprecated
6888 =item Reporting Bugs
6896 =head2 perl5005delta - what's new for perl5.005
6902 =item About the new versioning system
6904 =item Incompatible Changes
6908 =item WARNING: This version is not binary compatible with Perl 5.004.
6910 =item Default installation structure has changed
6912 =item Perl Source Compatibility
6914 =item C Source Compatibility
6916 =item Binary Compatibility
6918 =item Security fixes may affect compatibility
6920 =item Relaxed new mandatory warnings introduced in 5.004
6934 =item Regular Expressions
6936 Many new and improved optimizations, Many bug fixes, New regular expression
6937 constructs, New operator for precompiled regular expressions, Other
6938 improvements, Incompatible changes
6940 =item Improved malloc()
6942 =item Quicksort is internally implemented
6944 =item Reliable signals
6946 =item Reliable stack pointers
6948 =item More generous treatment of carriage returns
6952 =item Better support for multiple interpreters
6954 =item Behavior of local() on array and hash elements is now well-defined
6956 =item C<%!> is transparently tied to the L<Errno> module
6958 =item Pseudo-hashes are supported
6960 =item C<EXPR foreach EXPR> is supported
6962 =item Keywords can be globally overridden
6964 =item C<$^E> is meaningful on Win32
6966 =item C<foreach (1..1000000)> optimized
6968 =item C<Foo::> can be used as implicitly quoted package name
6970 =item C<exists $Foo::{Bar::}> tests existence of a package
6972 =item Better locale support
6974 =item Experimental support for 64-bit platforms
6976 =item prototype() returns useful results on builtins
6978 =item Extended support for exception handling
6980 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
6982 =item All C<printf> format conversions are handled internally
6984 =item New C<INIT> keyword
6986 =item New C<lock> keyword
6988 =item New C<qr//> operator
6990 =item C<our> is now a reserved word
6992 =item Tied arrays are now fully supported
6994 =item Tied handles support is better
6996 =item 4th argument to substr
6998 =item Negative LENGTH argument to splice
7000 =item Magic lvalues are now more magical
7002 =item <> now reads in records
7006 =item Supported Platforms
7012 =item Changes in existing support
7016 =item Modules and Pragmata
7022 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
7023 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
7024 Thread, attrs, fields, re
7026 =item Changes in existing modules
7028 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
7029 MakeMaker, CPAN, Cwd
7033 =item Utility Changes
7035 =item Documentation Changes
7037 =item New Diagnostics
7039 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
7040 while coercing array into hash, Bareword "%s" refers to nonexistent
7041 package, Can't call method "%s" on an undefined value, Can't check
7042 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
7043 goto subroutine from an eval-string, Can't localize pseudo-hash element,
7044 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
7045 for "%s", Character class syntax [. .] is reserved for future extensions,
7046 Character class syntax [: :] is reserved for future extensions, Character
7047 class syntax [= =] is reserved for future extensions, %s: Eval-group in
7048 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
7049 Eval-group not allowed at run time, Explicit blessing to '' (assuming
7050 package main), Illegal hex digit ignored, No such array field, No such
7051 field "%s" in variable %s of type %s, Out of memory during ridiculously
7052 large request, Range iterator outside integer range, Recursive inheritance
7053 detected while looking for method '%s' %s, Reference found where even-sized
7054 list expected, Undefined value assigned to typeglob, Use of reserved word
7055 "%s" is deprecated, perl: warning: Setting locale failed
7057 =item Obsolete Diagnostics
7059 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
7060 temporary file, regexp too big
7062 =item Configuration Changes
7072 =head2 perl5004delta - what's new for perl5.004
7078 =item Supported Environments
7084 =item List assignment to %ENV works
7086 =item Change to "Can't locate Foo.pm in @INC" error
7088 =item Compilation option: Binary compatibility with 5.003
7090 =item $PERL5OPT environment variable
7092 =item Limitations on B<-M>, B<-m>, and B<-T> options
7094 =item More precise warnings
7096 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
7098 =item Previously deprecated %OVERLOAD is no longer usable
7100 =item Subroutine arguments created only when they're modified
7102 =item Group vector changeable with C<$)>
7104 =item Fixed parsing of $$<digit>, &$<digit>, etc.
7106 =item Fixed localization of $<digit>, $&, etc.
7108 =item No resetting of $. on implicit close
7110 =item C<wantarray> may return undef
7112 =item C<eval EXPR> determines value of EXPR in scalar context
7114 =item Changes to tainting checks
7116 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
7117 spawning if tainted $TERM doesn't look like a terminal name
7119 =item New Opcode module and revised Safe module
7121 =item Embedding improvements
7123 =item Internal change: FileHandle class based on IO::* classes
7125 =item Internal change: PerlIO abstraction interface
7127 =item New and changed syntax
7131 =item New and changed builtin constants
7135 =item New and changed builtin variables
7139 =item New and changed builtin functions
7141 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
7142 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
7143 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
7144 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
7145 nested C<sub{}> closures work now, formats work right on changing lexicals
7147 =item New builtin methods
7149 isa(CLASS), can(METHOD), VERSION( [NEED] )
7151 =item TIEHANDLE now supported
7153 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
7154 LIST, READLINE this, GETC this, DESTROY this
7156 =item Malloc enhancements
7158 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
7160 =item Miscellaneous efficiency enhancements
7164 =item Support for More Operating Systems
7180 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
7181 constant NAME => VALUE, use locale, use ops, use vmsish
7187 =item Required Updates
7189 =item Installation directories
7191 =item Module information summary
7205 =item Object-oriented overrides for builtin operators
7209 =item Utility Changes
7215 Sends converted HTML to standard output
7219 C<void> XSUBs now default to returning nothing
7223 =item C Language API Changes
7225 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
7228 =item Documentation Changes
7230 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
7231 L<perlmodlib>, L<perldebug>, L<perlsec>
7233 =item New Diagnostics
7235 "my" variable %s masks earlier declaration in same scope, %s argument is
7236 not a HASH element or slice, Allocation too large: %lx, Allocation too
7237 large, Applying %s to %s will act on scalar(%s), Attempt to free
7238 nonexistent shared string, Attempt to use reference as lvalue in substr,
7239 Bareword "%s" refers to nonexistent package, Can't redefine active sort
7240 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
7241 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
7242 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
7243 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
7244 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
7245 %s, Integer overflow in hex number, Integer overflow in octal number,
7246 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
7247 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
7248 possible typo, Null picture in formline, Offset outside string, Out of
7249 memory!, Out of memory during request for %s, panic: frexp, Possible
7250 attempt to put comments in qw() list, Possible attempt to separate words
7251 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
7252 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
7253 option, untie attempted while %d inner references still exist, Unrecognized
7254 character %s, Unsupported function fork, Use of "$$<digit>" to mean
7255 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
7256 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
7257 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
7258 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
7259 long, Process terminated by SIG%s
7269 =head2 perlartistic - the Perl Artistic License
7277 =item The "Artistic License"
7285 "Package", "Standard Version", "Copyright Holder", "You", "Reasonable
7286 copying fee", "Freely Available"
7290 a), b), c), d), a), b), c), d)
7296 =head2 perlgpl - the GNU General Public License, version 2
7308 =item GNU GENERAL PUBLIC LICENSE
7312 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
7320 =item Compiling Perl 5 on AIX
7324 =item Building Dynamic Extensions on AIX
7326 =item The IBM ANSI C Compiler
7328 =item Using GNU's gcc for building perl
7330 =item Using Large Files with Perl
7336 =item AIX 4.2 and extensions using C++ with statics
7346 =head2 perlamiga - Perl under Amiga OS
7362 =item Prerequisites for Compiling Perl on AmigaOS
7364 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
7366 =item Starting Perl programs under AmigaOS
7368 =item Shortcomings of Perl under AmigaOS
7374 =item Accessing documentation
7378 =item Manpages for Perl on AmigaOS
7380 =item Perl HTML Documentation on AmigaOS
7382 =item Perl GNU Info Files on AmigaOS
7384 =item Perl LaTeX Documentation on AmigaOS
7388 =item BUILDING PERL ON AMIGAOS
7392 =item Build Prerequisites for Perl on AmigaOS
7394 =item Getting the Perl Source for AmigaOS
7396 =item Making Perl on AmigaOS
7398 =item Testing Perl on AmigaOS
7400 =item Installing the built Perl on AmigaOS
7404 =item PERL 5.8.0 BROKEN IN AMIGAOS
7412 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
7422 =head2 perlbeos, README.beos - Perl version 5 on BeOS
7430 =item General Issues with Perl on BeOS
7432 =item BeOS Release-specific Notes
7436 =item Contact Information
7438 =item Update 2002-05-30
7444 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
7454 =item gzip on BS2000
7456 =item bison on BS2000
7458 =item Unpacking Perl Distribution on BS2000
7460 =item Compiling Perl on BS2000
7462 =item Testing Perl on BS2000
7464 =item Installing Perl on BS2000
7466 =item Using Perl in the Posix-Shell of BS2000
7468 =item Using Perl in "native" BS2000
7470 =item Floating point anomalies on BS2000
7500 Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's
7501 celib-sources, Rainer Keuchel's console-sources
7505 go to ./wince subdirectory, edit file compile.bat, run compile.bat, run
7510 =item Acknowledgements
7516 =head2 perlcygwin, README.cygwin - Perl for Cygwin
7522 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
7526 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
7528 =item Cygwin Configuration
7530 C<PATH>, I<nroff>, Permissions
7534 =item CONFIGURE PERL ON CYGWIN
7538 =item Stripping Perl Binaries on Cygwin
7540 =item Optional Libraries for Perl on Cygwin
7542 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
7543 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
7545 =item Configure-time Options for Perl on Cygwin
7547 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
7548 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
7551 =item Suspicious Warnings on Cygwin
7553 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
7557 =item MAKE ON CYGWIN
7561 =item Errors on Cygwin
7567 =item TEST ON CYGWIN
7571 =item File Permissions on Cygwin
7573 =item NDBM_File and ODBM_File do not work on FAT filesystems
7575 =item C<fork()> failures in io_* tests
7577 =item Script Portability on Cygwin
7579 Pathnames, Text/Binary, PerlIO, F<.exe>, C<chown()>, Miscellaneous
7583 =item INSTALL PERL ON CYGWIN
7585 =item MANIFEST ON CYGWIN
7587 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
7588 Source, Compiled Module Source, Perl Modules/Scripts
7590 =item BUGS ON CYGWIN
7598 =head2 perldgux - Perl under DG/UX.
7610 =item BUILDING PERL ON DG/UX
7614 =item Non-threaded Perl on DG/UX
7616 =item Threaded Perl on DG/UX
7618 =item Testing Perl on DG/UX
7620 =item Installing the built perl on DG/UX
7630 =head2 perldos - Perl under DOS, W31, W95.
7640 =item Prerequisites for Compiling Perl on DOS
7644 =item Shortcomings of Perl under DOS
7646 =item Building Perl on DOS
7648 =item Testing Perl on DOS
7650 =item Installation of Perl on DOS
7654 =item BUILDING AND INSTALLING MODULES ON DOS
7658 =item Building Prerequisites for Perl on DOS
7660 =item Unpacking CPAN Modules on DOS
7662 =item Building Non-XS Modules on DOS
7664 =item Building XS Modules on DOS
7674 =head2 perlepoc, README.epoc - Perl for EPOC
7682 =item INSTALLING PERL ON EPOC
7684 =item STARTING PERL ON EPOC
7688 =item Editors on Epoc
7690 =item Features of Perl on Epoc
7692 =item Restrictions of Perl on Epoc
7694 =item Compiling Perl 5 on the EPOC cross compiling environment
7698 =item SUPPORT STATUS OF PERL ON EPOC
7706 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
7714 =item FreeBSD core dumps from readdir_r with ithreads
7716 =item $^X doesn't always contain a full path in FreeBSD
7718 =item Perl will no longer be part of "base FreeBSD"
7726 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
7735 =item Using perl as shipped with HP-UX
7737 =item Using perl from HP's porting centre
7739 =item Compiling Perl 5 on HP-UX
7751 =item Portability Between PA-RISC Versions
7753 =item Itanium Processor Family and HP-UX
7755 =item Building Dynamic Extensions on HP-UX
7757 =item The HP ANSI C Compiler
7759 =item The GNU C Compiler
7761 =item Using Large Files with Perl on HP-UX
7763 =item Threaded Perl on HP-UX
7765 =item 64-bit Perl on HP-UX
7767 =item Oracle on HP-UX
7769 =item GDBM and Threads on HP-UX
7771 =item NFS filesystems and utime(2) on HP-UX
7773 =item perl -P and // and HP-UX
7775 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
7779 =item nss_delete core dump from op/pwent or op/grent
7787 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
7795 =item Known Problems with Perl on Hurd
7803 =head2 perlirix, README.irix - Perl version 5 on Irix systems
7811 =item Building 32-bit Perl in Irix
7813 =item Building 64-bit Perl in Irix
7815 =item About Compiler Versions of Irix
7817 =item Linker Problems in Irix
7819 =item Malloc in Irix
7821 =item Building with threads in Irix
7831 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
7840 =item Compiling Perl 5 on MachTen
7842 =item Failures during C<make test> on MachTen
7844 op/lexassign.t, pragma/warnings.t
7846 =item Building external modules on MachTen
7856 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
7870 =head2 perlmacosx, README.macosx - Perl under Mac OS X
7880 =item Installation Prefix
7882 =item libperl and Prebinding
7884 =item Updating Panther
7886 =item Known problems
7902 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
7908 =item Known problems with Perl on MiNT
7914 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
7922 =item Binary distribution from HP
7924 =item What's New in Perl for MPE/iX
7926 =item Welcome to Perl/iX
7928 =item System Requirements for Perl/iX
7930 =item How to Obtain Perl/iX
7932 =item Perl/iX Distribution Contents Highlights
7934 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
7935 public_html/feedback.cgi, src/perl-5.6.0-mpe
7937 =item How to Compile Perl/iX
7941 =item Getting Started with Perl/iX
7943 =item MPE/iX Implementation Considerations
7945 =item Known Perl/iX Bugs Under Investigation
7947 =item Perl/iX To-Do List
7949 =item Perl/iX Change History
7965 SetNWBld.bat, Buildtype.bat
7977 =item Build new extensions
7979 =item Acknowledgements
7987 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
8007 EMX, RSX, HPFS, pdksh
8009 =item Starting Perl programs under OS/2 (and DOS and...)
8011 =item Starting OS/2 (and DOS) programs under Perl
8015 =item Frequently asked questions
8019 =item "It does not work"
8021 =item I cannot run external programs
8023 =item I cannot embed perl into my program, or use F<perl.dll> from my
8026 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
8029 =item C<``> and pipe-C<open> do not work under DOS.
8031 =item Cannot start C<find.exe "pattern" file>
8039 =item Automatic binary installation
8041 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
8043 =item Manual binary installation
8045 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
8046 (statically linked), Executables for Perl utilities, Main Perl library,
8047 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
8048 and utilities, Manpages for Perl modules, Source for Perl documentation,
8049 Perl manual in F<.INF> format, Pdksh
8055 =item Accessing documentation
8059 =item OS/2 F<.INF> file
8067 =item GNU C<info> files
8079 =item The short story
8083 =item Getting perl source
8085 =item Application of the patches
8093 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
8096 =item Installing the built perl
8098 =item C<a.out>-style build
8106 =item Some C</> became C<\> in pdksh.
8108 =item C<'errno'> - unresolved external
8110 =item Problems with tr or sed
8112 =item Some problem (forget which ;-)
8114 =item Library ... not found
8116 =item Segfault in make
8118 =item op/sprintf test failure
8122 =item Specific (mis)features of OS/2 port
8126 =item C<setpriority>, C<getpriority>
8130 =item C<extproc> on the first line
8132 =item Additional modules:
8134 =item Prebuilt methods:
8136 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>, C<Cwd::current_drive()>,
8137 C<Cwd::sys_chdir(name)>, C<Cwd::change_drive(name)>,
8138 C<Cwd::sys_is_absolute(name)>, C<Cwd::sys_is_rooted(name)>,
8139 C<Cwd::sys_is_relative(name)>, C<Cwd::sys_cwd(name)>,
8140 C<Cwd::sys_abspath(name, dir)>, C<Cwd::extLibpath([type])>,
8141 C<Cwd::extLibpath_set( path [, type ] )>,
8142 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
8143 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
8144 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
8145 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
8146 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
8147 C<OS2::DLLname([how [, \&xsub]])>
8149 =item Prebuilt variables:
8151 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
8158 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
8161 =item Identifying DLLs
8163 =item Centralized management of resources
8165 C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
8166 C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
8167 C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
8168 C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
8182 =item F<perl___.exe>
8184 =item Why strange names?
8186 =item Why dynamic linking?
8188 =item Why chimera build?
8196 =item C<PERLLIB_PREFIX>
8198 =item C<PERL_BADLANG>
8200 =item C<PERL_BADFREE>
8202 =item C<PERL_SH_DIR>
8204 =item C<USE_PERL_FLOCK>
8206 =item C<TMP> or C<TEMP>
8214 =item Text-mode filehandles
8218 =item DLL name mangling: pre 5.6.2
8220 =item DLL name mangling: 5.6.2 and beyond
8222 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
8225 =item DLL forwarder generation
8229 =item Calls to external programs
8231 =item Memory allocation
8235 C<COND_WAIT>, F<os2.c>
8251 =head2 perlos390, README.os390 - building and installing Perl for OS/390
8264 =item Unpacking Perl distribution on OS/390
8266 =item Setup and utilities for Perl on OS/390
8268 =item Configure Perl on OS/390
8270 =item Build, Test, Install Perl on OS/390
8272 =item Build Anomalies with Perl on OS/390
8274 =item Testing Anomalies with Perl on OS/390
8276 =item Installation Anomalies with Perl on OS/390
8278 =item Usage Hints for Perl on OS/390
8280 =item Floating Point Anomalies with Perl on OS/390
8282 =item Modules and Extensions for Perl on OS/390
8292 =item Mailing list for Perl on OS/390
8300 =head2 perlos400, README.os400 - Perl version 5 on OS/400
8308 =item Compiling Perl for OS/400 PASE
8310 =item Installing Perl in OS/400 PASE
8312 =item Using Perl in OS/400 PASE
8314 =item Known Problems
8324 =head2 perlplan9 - Plan 9-specific documentation for Perl
8334 =item What's in Plan 9 Perl
8336 =item What's not in Plan 9 Perl
8338 =item Perl5 Functions not currently supported in Plan 9 Perl
8340 =item Signals in Plan 9 Perl
8344 =item COMPILING AND INSTALLING PERL ON PLAN 9
8348 =item Installing Perl Documentation on Plan 9
8360 =head2 perlqnx, README.qnx - Perl version 5 on QNX
8368 =item Required Software for Compiling Perl on QNX4
8370 /bin/sh, ar, nm, cpp, make
8372 =item Outstanding Issues with Perl on QNX4
8374 =item QNX auxiliary files
8378 =item Outstanding issues with perl under QNX6
8386 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
8394 =item Solaris Version Numbers.
8400 Solaris FAQ, Precompiled Binaries, Solaris Documentation
8406 =item File Extraction Problems on Solaris.
8408 =item Compiler and Related Tools on Solaris.
8410 =item Environment for Compiling perl on Solaris
8414 =item RUN CONFIGURE.
8418 =item 64-bit perl on Solaris.
8420 =item Threads in perl on Solaris.
8422 =item Malloc Issues with perl on Solaris.
8426 =item MAKE PROBLEMS.
8428 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
8429 relocation error:, dlopen: stub interception failed, #error "No
8430 DATAMODEL_NATIVE specified", sh: ar: not found
8436 =item op/stat.t test 4 in Solaris
8438 =item nss_delete core dump from op/pwent or op/grent
8442 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
8444 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
8448 =item Limits on Numbers of Open Files on Solaris.
8452 =item SOLARIS-SPECIFIC MODULES.
8454 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
8458 =item Proc::ProcessTable on Solaris
8460 =item BSD::Resource on Solaris
8462 =item Net::SSLeay on Solaris
8472 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
8473 Digital UNIX formerly known as DEC OSF/1) systems
8481 =item Compiling Perl 5 on Tru64
8483 =item Using Large Files with Perl on Tru64
8485 =item Threaded Perl on Tru64
8487 =item Long Doubles on Tru64
8489 =item DB_File tests failing on Tru64
8491 =item 64-bit Perl on Tru64
8493 =item Warnings about floating-point overflow when compiling Perl on Tru64
8497 =item Testing Perl on Tru64
8499 =item ext/ODBM_File/odbm Test Failing With Static Builds
8501 =item Perl Fails Because Of Unresolved Symbol sockatmark
8507 =head2 perluts - Perl under UTS
8515 =item BUILDING PERL ON UTS
8517 =item Installing the built perl on UTS
8523 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
8533 =item Unpacking Perl Distribution on VM/ESA
8535 =item Setup Perl and utilities on VM/ESA
8537 =item Configure Perl on VM/ESA
8539 =item Testing Anomalies of Perl on VM/ESA
8541 =item Usage Hints for Perl on VM/ESA
8551 =item Mailing list for Perl on VM/ESA
8557 =head2 perlvms - VMS-specific documentation for Perl
8565 =item Organization of Perl Images
8571 =item Perl Extensions
8573 =item Installing static extensions
8575 =item Installing dynamic extensions
8579 =item File specifications
8585 =item Wildcard expansion
8591 =item PERL5LIB and PERLLIB
8597 =item I/O redirection and backgrounding
8599 =item Command line switches
8605 =item Perl functions
8607 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
8608 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
8609 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
8610 LIST, waitpid PID,FLAGS
8612 =item Perl variables
8614 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
8616 =item Standard modules with VMS-specific differences
8630 =head2 perlvos, README.vos - Perl for Stratus VOS
8636 =item BUILDING PERL FOR VOS
8638 =item INSTALLING PERL IN VOS
8640 =item USING PERL IN VOS
8644 =item Restrictions of Perl on VOS
8646 =item Handling of underflow and overflow
8652 =item SUPPORT STATUS
8660 =head2 perlwin32 - Perl under Windows
8670 =item Setting Up Perl on Win32
8672 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform
8673 SDK 64-bit Compiler, MinGW32 with gcc, MinGW release 1
8677 =item Testing Perl on Win32
8679 =item Installation of Perl on Win32
8681 =item Usage Hints for Perl on Win32
8683 Environment Variables, File Globbing, Using perl from the command line,
8684 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
8685 Extensions, Notes on 64-bit Windows
8687 =item Running Perl Scripts
8689 Miscellaneous Things
8693 =item BUGS AND CAVEATS
8697 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
8698 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
8699 E<lt>nick@ing-simmons.netE<gt>
8707 =head1 PRAGMA DOCUMENTATION
8709 =head2 attrs - set/get attributes of a subroutine (deprecated)
8721 =head2 re - Perl pragma to alter regular expression behaviour
8731 =head2 threadshared::shared, threads::shared - Perl extension for sharing
8732 data structures between threads
8744 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
8745 cond_broadcast VARIABLE
8757 =head2 threads - Perl extension allowing use of interpreter based threads
8766 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
8767 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
8768 threads->list();, async BLOCK;
8772 A thread exited while %d other threads were still running
8778 Parent-Child threads, Returning objects, Creating threads inside BEGIN
8779 blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
8781 =item AUTHOR and COPYRIGHT
8787 =head2 assertions - select assertions in blocks of code
8799 =item COPYRIGHT AND LICENSE
8803 =head2 assertions::activate - activate assertions
8815 =item COPYRIGHT AND LICENSE
8819 =head2 attributes - get/set subroutine or variable attributes
8829 =item Built-in Attributes
8831 locked, method, lvalue
8833 =item Available Subroutines
8837 =item Package-specific Attribute Handling
8839 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
8841 =item Syntax of Attribute Lists
8849 =item Default exports
8851 =item Available exports
8853 =item Export tags defined
8863 =head2 autouse - postpone load of modules until a function is used
8879 =head2 base - Establish IS-A relationship with base class at compile time
8893 =head2 bigint - Transparent BigInteger support for Perl
8905 a or accuracy, p or precision, t or trace, l or lib, v or version
8909 =item INTERNAL FORMAT
8931 =head2 bignum - Transparent BigNumber support for Perl
8943 a or accuracy, p or precision, t or trace, l or lib, v or version
8949 inf(), NaN(), upgrade()
8953 =item INTERNAL FORMAT
8971 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
8995 perl -Mbigrat -le 'print sqrt(33)'
8996 perl -Mbigrat -le 'print 2*255'
8997 perl -Mbigrat -le 'print 4.5+2*255'
8998 perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'
8999 perl -Mbigrat -le 'print 12->is_odd()';
9009 =head2 blib - Use MakeMaker's uninstalled version of a package
9023 =head2 bytes - Perl pragma to force byte semantics rather than character
9036 =head2 charnames - define character names for C<\N{named}> string literal
9045 =item CUSTOM TRANSLATORS
9047 =item CUSTOM ALIASES
9051 =item Anonymous hashes
9055 =item Alias shortcut
9059 =item charnames::viacode(code)
9061 =item charnames::vianame(name)
9065 =item ILLEGAL CHARACTERS
9071 =head2 constant - Perl pragma to declare constants
9083 =item List constants
9085 =item Defining multiple constants at once
9087 =item Magic constants
9091 =item TECHNICAL NOTES
9101 =head2 diagnostics - Perl compiler pragma to force verbose warning
9112 =item The C<diagnostics> Pragma
9114 =item The I<splain> Program
9128 =head2 encoding - allows you to write your script in non-ascii or non-utf8
9138 =item Literal Conversions
9140 =item PerlIO layers for C<STD(IN|OUT)>
9144 =item FEATURES THAT REQUIRE 5.8.1
9146 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
9150 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
9151 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
9153 =item The Filter Option
9157 =item Filter-related changes at Encode version 1.87
9167 =item DO NOT MIX MULTIPLE ENCODINGS
9169 =item tr/// with ranges
9171 Legend of characters above
9175 =item EXAMPLE - Greekperl
9177 =item KNOWN PROBLEMS
9179 literals in regex that are longer than 127 bytes, EBCDIC, format
9187 =head2 fields - compile-time class fields
9201 =head2 filetest - Perl pragma to control the filetest permission operators
9211 =item subpragma access
9217 =head2 if - C<use> a Perl module if a condition holds
9231 =head2 integer - Perl pragma to use integer arithmetic instead of floating
9242 =head2 less - perl pragma to request less of something from the compiler
9252 =head2 lib - manipulate @INC at compile time
9262 =item Adding directories to @INC
9264 =item Deleting directories from @INC
9266 =item Restoring original @INC
9280 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
9291 =head2 open - perl pragma to set default PerlIO layers for input and output
9299 =item NONPERLIO FUNCTIONALITY
9301 =item IMPLEMENTATION DETAILS
9307 =head2 ops - Perl pragma to restrict unsafe operations when compiling
9319 =head2 overload - Package for overloading perl operations
9329 =item Declaration of overloaded functions
9331 =item Calling Conventions for Binary Operations
9333 FALSE, TRUE, C<undef>
9335 =item Calling Conventions for Unary Operations
9337 =item Calling Conventions for Mutators
9339 C<++> and C<-->, C<x=> and other assignment versions
9341 =item Overloadable Operations
9343 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
9344 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
9345 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
9347 =item Inheritance and overloading
9349 Strings as values of C<use overload> directive, Overloading of an operation
9350 is inherited by derived classes
9354 =item SPECIAL SYMBOLS FOR C<use overload>
9362 C<undef>, TRUE, defined, but FALSE
9364 =item Copy Constructor
9370 =item MAGIC AUTOGENERATION
9372 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
9373 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
9374 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
9377 =item Losing overloading
9379 =item Run-time Overloading
9381 =item Public functions
9383 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
9385 =item Overloading constants
9387 integer, float, binary, q, qr
9389 =item IMPLEMENTATION
9391 =item Metaphor clash
9397 =item Two-face scalars
9399 =item Two-face references
9401 =item Symbolic calculator
9403 =item I<Really> symbolic calculator
9411 Odd number of arguments for overload::constant, `%s' is not an overloadable
9412 type, `%s' is not a code reference
9418 =head2 sigtrap - Perl pragma to enable simple signal handling
9430 =item SIGNAL HANDLERS
9432 B<stack-trace>, B<die>, B<handler> I<your-handler>
9436 B<normal-signals>, B<error-signals>, B<old-interface-signals>
9440 B<untrapped>, B<any>, I<signal>, I<number>
9448 =head2 sort - perl pragma to control sort() behaviour
9460 =head2 strict - Perl pragma to restrict unsafe constructs
9468 C<strict refs>, C<strict vars>, C<strict subs>
9474 =head2 subs - Perl pragma to predeclare sub names
9484 =head2 threadshared, threads::shared - Perl extension for sharing data
9485 structures between threads
9497 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
9498 cond_broadcast VARIABLE
9510 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
9521 =item Utility functions
9523 $num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[,
9524 FAIL_OK]), utf8::encode($string), utf8::decode($string), $flag =
9525 utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
9535 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
9545 =head2 version - Perl extension for Version Objects
9555 =item What IS a version
9557 Numeric Versions, V-String Versions
9559 =item Numeric Versions
9561 =item V-String Versions
9563 =item Object Methods
9565 New Operator, Stringification, Numification, Comparison operators, Logical
9570 =item Types of Versions Objects
9572 Ordinary versions, alpha versions
9574 =item Replacement UNIVERSAL::VERSION
9586 =head2 vmsish - Perl pragma to control VMS-specific language features
9594 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
9598 =head2 warnings - Perl pragma to control optional warnings
9606 use warnings::register, warnings::enabled(), warnings::enabled($category),
9607 warnings::enabled($object), warnings::warn($message),
9608 warnings::warn($category, $message), warnings::warn($object, $message),
9609 warnings::warnif($message), warnings::warnif($category, $message),
9610 warnings::warnif($object, $message)
9614 =head2 warnings::register - warnings import function
9624 =head1 MODULE DOCUMENTATION
9626 =head2 AnyDBM_File - provide framework for multiple DBMs
9636 =item DBM Comparisons
9646 =head2 Attribute::Handlers - Simpler definition of attribute handlers
9656 [0], [1], [2], [3], [4], [5]
9660 =item Typed lexicals
9662 =item Type-specific attribute handlers
9664 =item Non-interpretive attribute handlers
9666 =item Phase-specific attribute handlers
9668 =item Attributes as C<tie> interfaces
9676 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
9677 attributes>, C<Declaration of %s attribute in package %s may clash with
9678 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
9679 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
9680 be able to apply END handler>
9690 =head2 AutoLoader - load subroutines only on demand
9700 =item Subroutine Stubs
9702 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
9704 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
9706 =item Package Lexicals
9708 =item Not Using AutoLoader
9710 =item B<AutoLoader> vs. B<SelfLoader>
9720 =head2 AutoSplit - split a package for autoloading
9728 $keep, $check, $modtime
9732 =item Multiple packages
9740 =head2 B - The Perl Compiler
9750 =item Utility Functions
9754 =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV>
9757 sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av,
9758 check_av, begin_av, end_av, comppadlist, regex_padav, main_cv
9760 =item Functions for Examining the Symbol Table
9762 walksymtable(SYMREF, METHOD, RECURSE, PREFIX)
9764 =item Functions Returning C<B::OP> objects or for walking op trees
9766 main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG)
9768 =item Miscellaneous Utility Functions
9770 ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR),
9771 perlstring(STR), class(OBJ), threadsv_names
9775 =item OVERVIEW OF CLASSES
9779 =item SV-RELATED CLASSES
9783 REFCNT, FLAGS, object_2svref
9787 IV, IVX, UVX, int_value, needs64bits, packiv
9801 =item B::PVMG Methods
9805 =item B::MAGIC Methods
9807 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
9809 =item B::PVLV Methods
9811 TARGOFF, TARGLEN, TYPE, TARG
9815 USEFUL, PREVIOUS, RARE, TABLE
9819 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
9820 LINE, FILE, FILEGV, GvREFCNT, FLAGS
9824 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
9825 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
9829 FILL, MAX, OFF, ARRAY, ARRAYelt, AvFLAGS
9833 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB,
9834 XSUBANY, CvFLAGS, const_sv
9838 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
9840 =item OP-RELATED CLASSES
9844 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
9846 =item B::UNOP METHOD
9850 =item B::BINOP METHOD
9854 =item B::LOGOP METHOD
9858 =item B::LISTOP METHOD
9862 =item B::PMOP Methods
9864 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
9865 pmpermflags, precomp, pmoffset
9867 =item B::SVOP METHOD
9871 =item B::PADOP METHOD
9875 =item B::PVOP METHOD
9879 =item B::LOOP Methods
9881 redoop, nextop, lastop
9883 =item B::COP Methods
9885 label, stash, stashpv, file, cop_seq, arybase, line, warnings, io
9893 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
9902 %insn_data, @insn_name, @optype, @specialsv_name
9908 =head2 B::Assembler - Assemble Perl bytecode
9920 =head2 B::Bblock - Walk basic blocks
9940 =head2 B::Bytecode - Perl compiler's bytecode backend
9952 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
9962 =head2 B::C - Perl compiler's C backend
9972 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
9973 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
9974 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
9985 =head2 B::CC - Perl compiler's optimized C translation backend
9995 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
9996 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
9997 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
10009 =item Context of ".."
10013 =item Deprecated features
10021 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
10033 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
10034 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
10035 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
10037 =item FORMATTING SPECIFICATIONS
10039 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
10040 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
10041 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
10042 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
10043 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
10044 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
10045 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
10046 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
10048 =item ABBREVIATIONS
10052 =item OP flags abbreviations
10054 =item OP class abbreviations
10058 =item Using B::Concise outside of the O framework
10064 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
10076 =head2 B::Deparse - Perl compiler backend to produce perl code
10086 B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>,
10087 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
10089 =item USING B::Deparse AS A MODULE
10099 =item ambient_pragmas
10101 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
10113 =head2 B::Disassembler - Disassemble Perl bytecode
10125 =head2 B::Lint - Perl lint
10133 =item OPTIONS AND LINT CHECKS
10135 B<context>, B<implicit-read> and B<implicit-write>, B<bare-subs>,
10136 B<dollar-underscore>, B<private-names>, B<undefined-subs>,
10137 B<regexp-variables>, B<all>, B<none>
10139 =item NON LINT-CHECK OPTIONS
10149 =head2 B::O, O - Generic interface to Perl Compiler backends
10159 =item IMPLEMENTATION
10167 =head2 B::Showlex - Show lexical variables used in functions or files
10179 =head2 B::Stackobj - Helper module for CC backend
10191 =head2 B::Stash - show what stashes are loaded
10193 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
10205 =head2 B::Xref - Generates cross reference reports for Perl programs
10215 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
10223 =head2 Bblock, B::Bblock - Walk basic blocks
10243 =head2 Benchmark - benchmark running times of Perl code
10257 =item Standard Exports
10259 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
10260 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
10261 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
10263 =item Optional Exports
10265 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [
10266 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
10267 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
10269 =item :hireswallclock
10285 =item MODIFICATION HISTORY
10289 =head2 ByteLoader - load byte compiled perl code
10303 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
10315 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
10325 =head2 CGI - Simple Common Gateway Interface Class
10337 =item PROGRAMMING STYLE
10339 =item CALLING CGI.PM ROUTINES
10341 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
10343 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
10345 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
10347 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
10349 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
10351 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
10353 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
10355 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
10357 =item DELETING A PARAMETER COMPLETELY:
10359 =item DELETING ALL PARAMETERS:
10361 =item DIRECT ACCESS TO THE PARAMETER LIST:
10363 =item FETCHING THE PARAMETER LIST AS A HASH:
10365 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
10367 =item RETRIEVING CGI ERRORS
10369 =item USING THE FUNCTION-ORIENTED INTERFACE
10371 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
10372 B<:standard>, B<:all>
10376 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
10377 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
10380 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
10382 1. start_table() (generates a <table> tag), 2. end_table() (generates a
10383 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
10388 =item GENERATING DYNAMIC DOCUMENTS
10392 =item CREATING A STANDARD HTTP HEADER:
10394 =item GENERATING A REDIRECTION HEADER
10396 =item CREATING THE HTML DOCUMENT HEADER
10398 B<Parameters:>, 4, 5, 6..
10400 =item ENDING THE HTML DOCUMENT:
10402 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
10404 =item OBTAINING THE SCRIPT'S URL
10406 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
10407 (B<-query_string>), B<-base>
10409 =item MIXING POST AND URL PARAMETERS
10413 =item CREATING STANDARD HTML ELEMENTS:
10417 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
10419 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
10421 =item HTML SHORTCUTS AND LIST INTERPOLATION
10423 =item NON-STANDARD HTML SHORTCUTS
10425 =item AUTOESCAPING HTML
10427 $escaped_string = escapeHTML("unescaped string");, $charset =
10428 charset([$charset]);, $flag = autoEscape([$flag]);
10430 =item PRETTY-PRINTING HTML
10434 =item CREATING FILL-OUT FORMS:
10438 =item CREATING AN ISINDEX TAG
10440 =item STARTING AND ENDING A FORM
10442 B<application/x-www-form-urlencoded>, B<multipart/form-data>
10444 =item CREATING A TEXT FIELD
10448 =item CREATING A BIG TEXT FIELD
10450 =item CREATING A PASSWORD FIELD
10452 =item CREATING A FILE UPLOAD FIELD
10456 =item CREATING A POPUP MENU
10458 =item CREATING AN OPTION GROUP
10460 =item CREATING A SCROLLING LIST
10464 =item CREATING A GROUP OF RELATED CHECKBOXES
10468 =item CREATING A STANDALONE CHECKBOX
10472 =item CREATING A RADIO BUTTON GROUP
10476 =item CREATING A SUBMIT BUTTON
10480 =item CREATING A RESET BUTTON
10482 =item CREATING A DEFAULT BUTTON
10484 =item CREATING A HIDDEN FIELD
10488 =item CREATING A CLICKABLE IMAGE BUTTON
10490 B<Parameters:>, 3. The third option (-align, optional) is an alignment
10491 type, and may be TOP, BOTTOM or MIDDLE
10493 =item CREATING A JAVASCRIPT ACTION BUTTON
10499 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
10500 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
10502 =item WORKING WITH FRAMES
10504 1. Create a <Frameset> document, 2. Specify the destination for the
10505 document in the HTTP header, 3. Specify the destination for the document in
10508 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
10514 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
10518 =item FETCHING ENVIRONMENT VARIABLES
10520 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
10521 B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
10522 name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
10523 ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
10524 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
10525 B<request_method()>, B<content_type()>, B<http()>, B<https()>
10527 =item USING NPH SCRIPTS
10529 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
10534 multipart_init(), multipart_start(), multipart_end(), multipart_final()
10536 =item Avoiding Denial of Service Attacks
10538 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
10539 basis>, B<2. Globally for all scripts>
10541 =item COMPATIBILITY WITH CGI-LIB.PL
10543 =item AUTHOR INFORMATION
10547 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
10548 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
10549 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
10550 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
10551 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
10552 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
10553 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
10554 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
10555 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
10556 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
10557 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
10558 ...and many many more..
10560 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
10568 =head2 CGI::Apache - Backward compatibility module for CGI.pm
10578 =item AUTHOR INFORMATION
10586 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
10595 =item REDIRECTING ERROR MESSAGES
10597 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
10601 =item Changing the default message
10605 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
10607 =item OVERRIDING THE NAME OF THE PROGRAM
10615 =head2 CGI::Cookie - Interface to Netscape Cookies
10623 =item USING CGI::Cookie
10625 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
10629 =item Creating New Cookies
10631 =item Sending the Cookie to the Browser
10633 =item Recovering Previous Cookies
10635 =item Manipulating Cookies
10637 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
10641 =item AUTHOR INFORMATION
10649 =head2 CGI::Fast - CGI Interface for Fast CGI
10657 =item OTHER PIECES OF THE PUZZLE
10659 =item WRITING FASTCGI PERL SCRIPTS
10661 =item INSTALLING FASTCGI SCRIPTS
10663 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
10665 =item EXTERNAL FASTCGI SERVER INVOCATION
10667 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
10671 =item AUTHOR INFORMATION
10679 =head2 CGI::Pretty - module to produce nicely formatted HTML code
10689 =item Tags that won't be formatted
10691 =item Customizing the Indenting
10703 =head2 CGI::Push - Simple Interface to Server Push
10711 =item USING CGI::Push
10713 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
10717 =item Heterogeneous Pages
10719 =item Changing the Page Delay on the Fly
10723 =item INSTALLING CGI::Push SCRIPTS
10725 =item AUTHOR INFORMATION
10733 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
10743 =item AUTHOR INFORMATION
10751 =head2 CGI::Util - Internal utilities used by CGI module
10759 =item AUTHOR INFORMATION
10765 =head2 CPAN - query, download and build perl modules from CPAN sites
10777 =item Interactive Mode
10779 Searching for authors, bundles, distribution files and modules, make, test,
10780 install, clean modules or distributions, get, readme, look module or
10781 distribution, ls author, Signals
10789 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
10791 =item Programmer's interface
10793 expand($type,@things), expandany(@things), Programming Examples
10795 =item Methods in the other Classes
10797 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
10798 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
10799 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
10800 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
10801 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
10802 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
10803 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
10804 CPAN::Bundle::readme(), CPAN::Bundle::test(),
10805 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
10806 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
10807 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
10808 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
10809 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
10810 CPAN::Distribution::look(), CPAN::Distribution::make(),
10811 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
10812 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
10813 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
10814 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
10815 CPAN::Module::clean(), CPAN::Module::cpan_file(),
10816 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
10817 CPAN::Module::description(), CPAN::Module::force($method,@args),
10818 CPAN::Module::get(), CPAN::Module::inst_file(),
10819 CPAN::Module::inst_version(), CPAN::Module::install(),
10820 CPAN::Module::look(), CPAN::Module::make(),
10821 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
10822 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
10824 =item Cache Manager
10828 =item Prerequisites
10830 =item Finding packages and VERSION
10834 =item Floppy, Zip, Offline Mode
10838 =item CONFIGURATION
10840 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
10841 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
10842 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
10843 [unshift|push|splice] E<lt>listE<gt>>
10847 =item Note on urllist parameter's format
10849 =item urllist parameter has CD-ROM support
10857 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
10859 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
10863 =item Three basic types of firewalls
10865 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
10867 =item Configuring lynx or ncftp for going through a firewall
10873 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
10885 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
10895 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
10908 =head2 Carp, carp - warn of errors (from perspective of caller)
10918 =item Forcing a Stack Trace
10926 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
10928 =head2 Class::ISA -- report the search path for a class's ISA tree
10938 the function Class::ISA::super_path($CLASS), the function
10939 Class::ISA::self_and_super_path($CLASS), the function
10940 Class::ISA::self_and_super_versions($CLASS)
10942 =item CAUTIONARY NOTES
10950 =head2 Class::Struct - declare struct-like datatypes as Perl classes
10960 =item The C<struct()> function
10962 =item Class Creation at Compile Time
10964 =item Element Types and Accessor Methods
10966 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
10967 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
10969 =item Initializing with C<new>
10975 Example 1, Example 2, Example 3
10977 =item Author and Modification History
10981 =head2 Config - access Perl configuration information
10989 myconfig(), config_sh(), config_re($regex), config_vars(@names)
11001 C<_a>, C<_exe>, C<_o>
11005 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
11006 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
11007 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
11008 C<asctime_r_proto>, C<awk>
11012 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
11016 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
11017 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
11018 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
11019 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
11020 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
11021 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
11022 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
11026 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>,
11027 C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>,
11028 C<d_bcmp>, C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>,
11029 C<d_bzero>, C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>,
11030 C<d_chroot>, C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>,
11031 C<d_const>, C<d_copysignl>, C<d_crypt>, C<d_crypt_r>, C<d_csh>,
11032 C<d_ctermid_r>, C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>,
11033 C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>, C<d_dirnamlen>, C<d_dlerror>,
11034 C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, C<d_drand48_r>, C<d_drand48proto>,
11035 C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endgrent_r>, C<d_endhent>,
11036 C<d_endhostent_r>, C<d_endnent>, C<d_endnetent_r>, C<d_endpent>,
11037 C<d_endprotoent_r>, C<d_endpwent>, C<d_endpwent_r>, C<d_endsent>,
11038 C<d_endservent_r>, C<d_eofnblk>, C<d_eunice>, C<d_faststdio>, C<d_fchdir>,
11039 C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>,
11040 C<d_fd_set>, C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>,
11041 C<d_flexfnam>, C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>,
11042 C<d_fpathconf>, C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>,
11043 C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>,
11044 C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>, C<d_ftime>,
11045 C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>,
11046 C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>,
11047 C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
11048 C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>,
11049 C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>,
11050 C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>,
11051 C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>,
11052 C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
11053 C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
11054 C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>,
11055 C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
11056 C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>,
11057 C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>,
11058 C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>,
11059 C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
11060 C<d_htonl>, C<d_ilogbl>, C<d_index>, C<d_inetaton>, C<d_int64_t>,
11061 C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>,
11062 C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>,
11063 C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>,
11064 C<d_lstat>, C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>,
11065 C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>,
11066 C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>,
11067 C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>,
11068 C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>,
11069 C<d_msg_peek>, C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>,
11070 C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>,
11071 C<d_nice>, C<d_nl_langinfo>, C<d_nv_preserves_uv>, C<d_off64_t>,
11072 C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
11073 C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
11074 C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
11075 C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
11076 C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>,
11077 C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, C<d_pthread_atfork>,
11078 C<d_pthread_attr_setscope>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
11079 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
11080 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
11081 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
11082 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
11083 C<d_sanemcmp>, C<d_sbrkproto>, C<d_scalbnl>, C<d_sched_yield>,
11084 C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>,
11085 C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>,
11086 C<d_semop>, C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>,
11087 C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>,
11088 C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>,
11089 C<d_setnent>, C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>,
11090 C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>,
11091 C<d_setpwent>, C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>,
11092 C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>,
11093 C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>,
11094 C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>,
11095 C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>,
11096 C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>,
11097 C<d_socks5_init>, C<d_sqrtl>, C<d_srand48_r>, C<d_srandom_r>,
11098 C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>,
11099 C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
11100 C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>,
11101 C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>,
11102 C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strerror_r>,
11103 C<d_strftime>, C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>,
11104 C<d_strtoq>, C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>,
11105 C<d_suidsafe>, C<d_symlink>, C<d_syscall>, C<d_syscallproto>, C<d_sysconf>,
11106 C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>,
11107 C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>,
11108 C<d_tm_tm_gmtoff>, C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>,
11109 C<d_ttyname_r>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>,
11110 C<d_uname>, C<d_union_semun>, C<d_unordered>, C<d_usleep>,
11111 C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>,
11112 C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>, C<d_void_closedir>,
11113 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
11114 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
11115 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
11116 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
11117 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
11121 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
11122 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
11123 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
11124 C<expr>, C<extensions>, C<extras>
11128 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
11129 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
11134 C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>,
11135 C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>,
11136 C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>,
11137 C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>,
11138 C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>,
11139 C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>,
11140 C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>,
11141 C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>,
11142 C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>,
11143 C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
11147 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>,
11148 C<html3dir>, C<html3direxp>
11152 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
11153 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
11154 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
11155 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
11156 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
11157 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
11158 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
11159 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
11160 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
11161 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
11162 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
11163 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
11164 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
11165 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
11166 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
11167 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
11168 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
11169 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
11170 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installhtml1dir>,
11171 C<installhtml3dir>, C<installman1dir>, C<installman3dir>, C<installprefix>,
11172 C<installprefixexp>, C<installprivlib>, C<installscript>,
11173 C<installsitearch>, C<installsitebin>, C<installsitehtml1dir>,
11174 C<installsitehtml3dir>, C<installsitelib>, C<installsiteman1dir>,
11175 C<installsiteman3dir>, C<installsitescript>, C<installstyle>,
11176 C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>,
11177 C<installvendorhtml1dir>, C<installvendorhtml3dir>, C<installvendorlib>,
11178 C<installvendorman1dir>, C<installvendorman3dir>, C<installvendorscript>,
11179 C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
11183 C<known_extensions>, C<ksh>
11187 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
11188 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
11189 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
11190 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
11191 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
11192 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
11197 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
11198 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
11199 C<man3direxp>, C<man3ext>
11203 C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>,
11204 C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>,
11209 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
11210 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
11211 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
11212 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
11213 C<nvsize>, C<nvtype>
11217 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
11218 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
11222 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
11223 C<perl>, C<perl_patchlevel>
11227 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
11228 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
11229 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
11230 C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
11234 C<quadkind>, C<quadtype>
11238 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
11239 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
11240 C<rmail>, C<run>, C<runnm>
11244 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
11245 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
11246 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
11247 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
11248 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
11249 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
11250 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
11251 C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>,
11252 C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>,
11253 C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>,
11254 C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>,
11255 C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>,
11256 C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>,
11257 C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>,
11258 C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>,
11259 C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>,
11260 C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>,
11261 C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>,
11262 C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>,
11263 C<submit>, C<subversion>, C<sysman>
11267 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
11268 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
11273 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
11274 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
11275 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
11276 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>,
11277 C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemorebits>,
11278 C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>,
11279 C<useposix>, C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>,
11280 C<usethreads>, C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>,
11281 C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>,
11286 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
11287 C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>,
11288 C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>,
11289 C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>,
11290 C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>,
11291 C<vendorscriptexp>, C<version>, C<version_patchlevel_string>,
11292 C<versiononly>, C<vi>, C<voidflags>
11296 C<xlibpth>, C<xs_apiversion>
11300 C<yacc>, C<yaccflags>
11312 =head2 Cwd - get pathname of current working directory
11322 =item getcwd and friends
11324 getcwd, cwd, fastcwd, fastgetcwd
11326 =item abs_path and friends
11328 abs_path, realpath, fast_abs_path
11340 =head2 DB - programmatic interface to the Perl debugging API (draft,
11352 =item Global Variables
11354 $DB::sub, %DB::sub, $DB::single, $DB::signal, $DB::trace, @DB::args,
11355 @DB::dbline, %DB::dbline, $DB::package, $DB::filename, $DB::subname,
11360 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
11361 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
11363 =item Client Callback Methods
11365 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
11366 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
11367 CLIENT->output(LIST)
11377 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
11385 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
11389 =item Using DB_File with Berkeley DB version 2 or greater
11391 =item Interface to Berkeley DB
11393 =item Opening a Berkeley DB Database File
11395 =item Default Parameters
11397 =item In Memory Databases
11405 =item A Simple Example
11413 =item Changing the BTREE sort order
11415 =item Handling Duplicate Keys
11417 =item The get_dup() Method
11419 =item The find_dup() Method
11421 =item The del_dup() Method
11423 =item Matching Partial Keys
11431 =item The 'bval' Option
11433 =item A Simple Example
11435 =item Extra RECNO Methods
11437 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
11438 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
11439 length, elements);>
11441 =item Another Example
11445 =item THE API INTERFACE
11447 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
11448 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
11449 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
11450 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
11454 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
11455 B<filter_fetch_value>
11461 =item An Example -- the NULL termination problem.
11463 =item Another Example -- Key is a C int.
11467 =item HINTS AND TIPS
11471 =item Locking: The Trouble with fd
11473 =item Safe ways to lock a database
11475 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
11477 =item Sharing Databases With C Applications
11479 =item The untie() Gotcha
11483 =item COMMON QUESTIONS
11487 =item Why is there Perl source in my database?
11489 =item How do I store complex data structures with DB_File?
11491 =item What does "Invalid Argument" mean?
11493 =item What does "Bareword 'DB_File' not allowed" mean?
11513 =head2 Data::Dumper - stringified perl data structures, suitable for both
11514 printing and C<eval>
11526 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump I<or>
11527 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
11528 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
11535 =item Configuration Variables or Methods
11561 =head2 Devel::DProf - a Perl code profiler
11569 =item PROFILE FORMAT
11581 =head2 Devel::PPPort - Perl/Pollution/Portability
11603 =head2 Devel::Peek - A data debugging tool for the XS programmer
11613 =item Runtime debugging
11615 =item Memory footprint debugging
11623 =item A simple scalar string
11625 =item A simple scalar number
11627 =item A simple scalar with an extra reference
11629 =item A reference to a simple scalar
11631 =item A reference to an array
11633 =item A reference to a hash
11635 =item Dumping a large array or hash
11637 =item A reference to an SV which holds a C pointer
11639 =item A reference to a subroutine
11653 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
11663 =head2 Digest:: - Modules that calculate message digests
11671 I<binary>, I<hex>, I<base64>
11675 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
11676 Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset,
11677 $ctx->add($data,...), $ctx->addfile($io_handle), $ctx->digest,
11678 $ctx->hexdigest, $ctx->b64digest
11686 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
11696 md5($data,...), md5_hex($data,...), md5_base64($data,...)
11700 $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...),
11701 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
11713 =head2 DirHandle - supply object methods for directory handles
11725 =head2 Dumpvalue - provides screen dump of Perl data.
11737 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
11738 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
11739 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
11744 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
11745 compactDump, veryCompact, set, get
11751 =head2 DynaLoader - Dynamically load C libraries into Perl code
11759 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
11760 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
11761 dl_load_file(), dl_unload_file(), dl_load_flags(), dl_find_symbol(),
11762 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
11769 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
11780 =item Migration from C<DynaLoader>
11782 =item Backward compatible boilerplate
11786 =item Order of initialization: early load()
11790 =item The most hairy case
11800 =head2 Encode - character encodings
11808 =item Table of Contents
11820 =item PERL ENCODING API
11822 $octets = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
11823 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
11824 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
11829 =item Listing available encodings
11831 =item Defining Aliases
11835 =item Encoding via PerlIO
11837 =item Handling Malformed Data
11839 I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
11840 I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
11841 (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
11842 Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
11847 =item Unimplemented fallback schemes
11851 =item Defining Encodings
11853 =item The UTF-8 flag
11855 Goal #1:, Goal #2:, Goal #3:, Goal #4:
11859 =item Messing with Perl's Internals
11861 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
11871 =head2 Encode::Alias - alias definitions to encodings
11879 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11884 =item Alias overloading
11892 =head2 Encode::Byte - Single Byte Encodings
11906 =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
11908 =head2 Encode::CN - China-based Chinese Encodings
11924 =head2 Encode::CN::HZ -- internally used by Encode::CN
11926 =head2 Encode::Config -- internally used by Encode
11928 =head2 Encode::EBCDIC - EBCDIC Encodings
11942 =head2 Encode::Encoding - Encode Implementation Base Class
11952 =item Methods you should implement
11954 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
11955 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
11957 =item Other methods defined in Encode::Encodings
11959 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
11961 =item Example: Encode::ROT13
11965 =item Why the heck Encode API is different?
11969 =item Compiled Encodings
11975 Scheme 1, Scheme 2, Other Schemes
11979 =head2 Encode::Guess -- Guesses encoding from data
11989 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11990 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11991 guess_encoding($data, [, I<list of suspects>])
12001 =head2 Encode::JP - Japanese Encodings
12011 =item Note on ISO-2022-JP(-1)?
12019 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
12021 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
12023 =head2 Encode::KR - Korean Encodings
12037 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
12039 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
12055 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
12061 =item How does it work?
12063 =item Line Buffering
12067 =item How can I tell whether my encoding fully supports PerlIO ?
12075 =head2 Encode::Supported -- Encodings supported by Encode
12083 =item Encoding Names
12087 =item Supported Encodings
12091 =item Built-in Encodings
12093 =item Encode::Unicode -- other Unicode encodings
12095 =item Encode::Byte -- Extended ASCII
12097 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
12098 the Cyrillic world, gsm0338 - Hentai Latin 1
12100 =item CJK: Chinese, Japanese, Korean (Multibyte)
12102 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
12103 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
12104 Encode::JIS2K -- JIS X 0213 encodings via CPAN
12106 =item Miscellaneous encodings
12108 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
12112 =item Unsupported encodings
12114 ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
12115 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
12116 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
12117 Various Mac encodings, (Mac) Indic encodings
12119 =item Encoding vs. Charset -- terminology
12121 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
12125 =item Microsoft-related naming mess
12127 KS_C_5601-1987, GB2312, Big5, Shift_JIS
12133 character repertoire, coded character set (CCS), character encoding scheme
12134 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
12141 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
12142 RFC, UC, Unicode Glossary
12146 =item Other Notable Sites
12148 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
12149 "Introduction to i18n"
12151 =item Offline sources
12153 C<CJKV Information Processing> by Ken Lunde
12159 =head2 Encode::Symbol - Symbol Encodings
12173 =head2 Encode::TW - Taiwan-based Chinese Encodings
12189 =head2 Encode::Unicode -- Various Unicode Transformation Formats
12197 L<http://www.unicode.org/glossary/> says:, Quick Reference
12199 =item Size, Endianness, and BOM
12205 =item by endianness
12207 BOM as integer when fetched in network byte order
12211 =item Surrogate Pairs
12217 =head2 Encode::Unicode::UTF7 -- UTF-7 encoding
12231 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
12240 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
12245 =item Alias overloading
12253 =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm --
12254 Internally used by Encode::??::ISO_2022_*
12256 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
12259 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
12262 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
12263 Implementation Base Class
12273 =item Methods you should implement
12275 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
12276 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
12278 =item Other methods defined in Encode::Encodings
12280 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
12282 =item Example: Encode::ROT13
12286 =item Why the heck Encode API is different?
12290 =item Compiled Encodings
12296 Scheme 1, Scheme 2, Other Schemes
12300 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
12311 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
12312 Encode::decode("Guess" ...), Encode::Guess->guess($data),
12313 guess_encoding($data, [, I<list of suspects>])
12323 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
12324 Encode::JP::2022_JP*
12326 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
12329 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
12332 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
12333 and 'Q' header encoding
12349 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
12350 on Encode and PerlIO
12356 =item How does it work?
12358 =item Line Buffering
12362 =item How can I tell whether my encoding fully supports PerlIO ?
12370 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
12371 supported by Encode
12379 =item Encoding Names
12383 =item Supported Encodings
12387 =item Built-in Encodings
12389 =item Encode::Unicode -- other Unicode encodings
12391 =item Encode::Byte -- Extended ASCII
12393 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
12394 the Cyrillic world, gsm0338 - Hentai Latin 1
12396 =item CJK: Chinese, Japanese, Korean (Multibyte)
12398 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
12399 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
12400 Encode::JIS2K -- JIS X 0213 encodings via CPAN
12402 =item Miscellaneous encodings
12404 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
12408 =item Unsupported encodings
12410 ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
12411 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
12412 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
12413 Various Mac encodings, (Mac) Indic encodings
12415 =item Encoding vs. Charset -- terminology
12417 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
12421 =item Microsoft-related naming mess
12423 KS_C_5601-1987, GB2312, Big5, Shift_JIS
12429 character repertoire, coded character set (CCS), character encoding scheme
12430 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
12437 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
12438 RFC, UC, Unicode Glossary
12442 =item Other Notable Sites
12444 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
12445 "Introduction to i18n"
12447 =item Offline sources
12449 C<CJKV Information Processing> by Ken Lunde
12455 =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7
12470 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
12482 =item Predefined Methods
12484 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12485 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12486 $e-E<gt>bytes([$encoding])
12488 =item Example: base64 transcoder
12490 =item Operator Overloading
12498 =head2 Encodencoding, encoding - allows you to write your script in
12499 non-ascii or non-utf8
12509 =item Literal Conversions
12511 =item PerlIO layers for C<STD(IN|OUT)>
12515 =item FEATURES THAT REQUIRE 5.8.1
12517 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
12521 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
12522 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
12524 =item The Filter Option
12528 =item Filter-related changes at Encode version 1.87
12538 =item DO NOT MIX MULTIPLE ENCODINGS
12540 =item tr/// with ranges
12542 Legend of characters above
12546 =item EXAMPLE - Greekperl
12548 =item KNOWN PROBLEMS
12550 literals in regex that are longer than 127 bytes, EBCDIC, format
12558 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
12570 =item Predefined Methods
12572 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12573 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12574 $e-E<gt>bytes([$encoding])
12576 =item Example: base64 transcoder
12578 =item Operator Overloading
12586 =head2 English - use nice English (or awk) names for ugly punctuation
12599 =head2 Env - perl module that imports environment variables as scalars or
12614 =head2 Errno - System errno constants
12630 =head2 Exporter - Implements default import method for modules
12640 =item How to Export
12642 =item Selecting What To Export
12644 =item How to Import
12646 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
12650 =item Advanced features
12654 =item Specialised Import Lists
12656 =item Exporting without using Exporter's import method
12658 =item Module Version Checking
12660 =item Managing Unknown Symbols
12662 =item Tag Handling Utility Functions
12664 =item Generating combined tags
12666 =item C<AUTOLOAD>ed Constants
12672 =head2 Exporter::Heavy - Exporter guts
12682 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
12703 mv source... destination
12705 cp source... destination
12723 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
12737 B<warn_if_old_packlist>
12739 B<perllocal_install>
12743 =head2 ExtUtils::Constant - generate XS code to import C header constants
12753 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
12761 perl_stringify NAME
12765 memEQ_clause NAME, CHECKED_AT, INDENT
12767 assign INDENT, TYPE, PRE, POST, VALUE..
12771 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
12779 C_constant, name, type, value, macro, default, pre, post, def_pre =item
12782 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
12784 autoload PACKAGE, VERSION, AUTOLOADER
12786 WriteMakefileSnippet
12788 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
12789 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
12797 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
12809 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
12810 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
12820 =head2 ExtUtils::Install - install files from here to there
12838 B<install_default> I<DISCOURAGED>
12850 B<PERL_INSTALL_ROOT>
12858 =head2 ExtUtils::Installed - Inventory management of installed modules
12870 new(), modules(), files(), directories(), directory_tree(), validate(),
12871 packlist(), version()
12879 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
12887 For static extensions, For dynamic extensions at build/link time, For
12888 dynamic extensions at load time
12894 =item LDLOADLIBS and LD_RUN_PATH
12904 =item VMS implementation
12906 =item Win32 implementation
12914 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
12924 =head2 ExtUtils::MM_Any - Platform agnostic MM methods
12932 =item Inherently Cross-Platform Methods
12942 =item File::Spec wrappers
12950 =item Thought To Be Cross-Platform Methods
12966 makemakerdflt_target
12984 metafile_addtomanifest_target
12988 =item Abstract methods
12990 oneliner, B<quote_literal>, B<escape_newlines>, max_exec_len,
12991 B<init_others>, init_DIRFILESEP, init_linker, init_platform,
13004 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
13005 ExtUtils::MakeMaker
13019 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
13020 ExtUtils::MakeMaker
13034 replace_manpage_separator (o)
13038 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
13048 =item Overridden methods
13056 B<replace_manpage_separator>
13066 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
13067 ExtUtils::MakeMaker
13089 init_platform, platform_constants
13095 special_targets (o)
13105 clean_subdirs_target
13109 realclean_subdirs_target
13117 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
13118 ExtUtils::MakeMaker
13130 init_platform (o), platform_constants
13138 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
13139 ExtUtils::MakeMaker
13157 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
13167 =item Overridden methods
13175 B<replace_manpage_separator>
13185 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
13211 clean_subdirs_target
13273 =item Methods to actually produce chunks of text for the Makefile
13303 init_platform (o), platform_constants (o)
13347 post_initialize (o)
13361 realclean_subdirs_target
13363 replace_manpage_separator
13385 test_via_harness (override)
13387 test_via_script (override)
13411 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
13412 ExtUtils::MakeMaker
13422 =item Methods always loaded
13434 guess_name (override)
13438 find_perl (override)
13440 maybe_command (override)
13442 perl_script (override)
13444 replace_manpage_separator
13450 init_main (override)
13452 init_others (override)
13454 init_platform (override)
13458 init_VERSION (override)
13460 constants (override)
13466 const_cccmd (override)
13468 tool_sxubpp (override)
13470 tools_other (override)
13472 init_dist (override)
13482 dynamic_lib (override)
13484 dynamic_bs (override)
13486 static_lib (override)
13488 processPL (override)
13490 installbin (override)
13492 subdir_x (override)
13496 clean_subdirs_target
13498 realclean (override)
13500 zipfile_target (o), tarfile_target (o), shdist_target (o)
13502 dist_test (override)
13506 perldepend (override)
13508 makefile (override)
13510 find_tests (override)
13514 makeaperl (override)
13516 nicetext (override)
13518 prefixify (override)
13538 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
13539 ExtUtils::MakeMaker
13551 =item Overridden methods
13557 replace_manpage_separator
13567 init_platform (o), platform_constants (o)
13569 special_targets (o)
13591 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
13601 =item Overriden methods
13617 clean_subdirs_target
13619 realclean_subdirs_target
13629 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
13639 =head2 ExtUtils::MakeMaker - Create a module Makefile
13649 =item How To Write A Makefile.PL
13651 =item Default Makefile Behaviour
13659 =item PREFIX and LIB attribute
13663 =item Static Linking of a new Perl Binary
13665 =item Determination of Perl Library and Installation Locations
13667 =item Which architecture dependent directory?
13669 =item Using Attributes and Parameters
13671 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
13672 CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS,
13673 EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN,
13674 FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB,
13675 INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
13676 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB,
13677 INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLVENDORARCH,
13678 INSTALLVENDORBIN, INSTALLVENDORLIB, INSTALLVENDORMAN1DIR,
13679 INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR,
13680 INST_MAN3DIR, INST_SCRIPT, LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS,
13681 LINKTYPE, MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET,
13682 MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT,
13683 OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB,
13684 PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW,
13685 PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
13686 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT,
13687 PRINT_PREREQ, SITEPREFIX, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION,
13688 VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION
13690 =item Additional lowercase attributes
13692 clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean,
13693 test, tool_autosplit
13695 =item Overriding MakeMaker Methods
13697 =item The End Of Cargo Cult Programming
13699 C<<MAN3PODS => ' '>>
13701 =item Hintsfile support
13703 =item Distribution Support
13705 make distcheck, make skipcheck, make distclean, make manifest,
13706 make distdir, make disttest, make tardist, make dist, make
13707 uutardist, make shdist, make zipdist, make ci
13709 =item Module Meta-Data
13711 =item Disabling an extension
13713 =item Other Handy Functions
13721 PERL_MM_OPT, PERL_MM_USE_DEFAULT
13731 =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About
13740 =item Philosophy and History
13742 Why not just use <insert other build config tool here>?, What's
13743 Module::Build and how does it relate to MakeMaker?, pure perl. no make, no
13744 shell commands, easier to customize, cleaner internals, less cruft
13746 =item Module Writing
13748 How do I keep my $VERSION up to date without resetting it manually?, What's
13749 this F<META.yml> thing and how did it get in my F<MANIFEST>?!
13753 How to I prevent "object version X.XX does not match bootstrap parameter
13754 Y.YY" errors?, How do I make two or more XS files coexist in the same
13767 =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker
13781 Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP,
13790 =head2 ExtUtils::MakeMaker::bytes - Version agnostic bytes.pm
13800 =head2 ExtUtils::MakeMaker::vmsish - Platform agnostic vmsish.pm
13810 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
13848 =item MANIFEST.SKIP
13852 =item GLOBAL VARIABLES
13860 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
13861 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
13865 B<PERL_MM_MANIFEST_DEBUG>
13873 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
13885 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
13895 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
13904 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
13912 =head2 ExtUtils::Packlist - manage .packlist files
13924 new(), read(), write(), validate(), packlist_file()
13932 =head2 ExtUtils::testlib - add blib/* directories to @INC
13942 =head2 Fatal - replace functions with equivalents which succeed or die
13954 =head2 Fcntl - load the C Fcntl.h defines
13964 =item EXPORTED SYMBOLS
13968 =head2 File::Basename, fileparse - split a pathname into pieces
13976 fileparse_set_fstype, fileparse
13980 C<basename>, C<dirname>
13984 =head2 File::CheckTree, validate - run many filetest checks on a tree
13998 =head2 File::Compare - Compare files or filehandles
14012 =head2 File::Copy - Copy files or filehandles
14022 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
14024 rmscopy($from,$to[,$date_flag])
14036 =head2 File::DosGlob - DOS like globbing and then some
14046 =item EXPORTS (by request only)
14058 =head2 File::Find - Traverse a directory tree.
14066 B<find>, B<finddepth>
14072 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
14073 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
14074 C<untaint>, C<untaint_pattern>, C<untaint_skip>
14076 =item The wanted function
14078 C<$File::Find::dir> is the current directory name,, C<$_> is the current
14079 filename within that directory, C<$File::Find::name> is the complete
14080 pathname to the file
14088 $dont_use_nlink, symlinks
14096 =head2 File::Glob - Perl extension for BSD glob routine
14104 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
14105 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
14106 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
14110 C<GLOB_NOSPACE>, C<GLOB_ABEND>
14118 =head2 File::Path - create or remove directory trees
14132 =head2 File::Spec - portably perform operations on file names
14142 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
14143 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
14144 splitdir, catpath(), abs2rel, rel2abs()
14152 =head2 File::Spec::Cygwin - methods for Cygwin file specs
14164 file_name_is_absolute
14168 =head2 File::Spec::Epoc - methods for Epoc file specs
14188 =head2 File::Spec::Functions - portably perform operations on file names
14206 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
14234 file_name_is_absolute
14256 =head2 File::Spec::OS2 - methods for OS/2 file specs
14268 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
14301 file_name_is_absolute
14323 =head2 File::Spec::VMS - methods for VMS file specs
14339 =item Methods always loaded
14341 canonpath (override)
14359 case_tolerant (override)
14363 file_name_is_absolute (override)
14365 splitpath (override)
14367 splitdir (override)
14381 =head2 File::Spec::Win32 - methods for Win32 file specs
14407 =item Note For File::Spec::Win32 Maintainers
14417 =head2 File::Temp - return name and handle of a temporary file safely
14453 =item MKTEMP FUNCTIONS
14467 =item POSIX FUNCTIONS
14477 =item ADDITIONAL FUNCTIONS
14485 =item UTILITY FUNCTIONS
14497 =item PACKAGE VARIABLES
14499 B<safe_level>, STANDARD, MEDIUM, HIGH
14511 =item Temporary files and NFS
14523 =head2 File::stat - by-name interface to Perl's built-in stat() functions
14539 =head2 FileCache - keep more files open than the system permits
14547 cacheout EXPR, cacheout MODE, EXPR
14557 =head2 FileHandle - supply object methods for filehandles
14565 $fh->print, $fh->printf, $fh->getline, $fh->getlines
14571 =head2 Filter::Simple - Simplified source filtering
14585 =item Disabling or changing <no> behaviour
14587 =item All-in-one interface
14589 =item Filtering only specific components of source code
14591 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
14594 =item Filtering only the code parts of source code
14596 Most source code ceases to be grammatically correct when it is broken up
14597 into the pieces between string literals and regexes. So the C<'code'>
14598 component filter behaves slightly differently from the other partial
14600 described in the previous section.
14602 =item Using Filter::Simple with an explicit C<import> subroutine
14604 =item Using Filter::Simple and Exporter together
14616 =head2 Filter::Util::Call - Perl Source Filter Utility Module
14626 =item B<use Filter::Util::Call>
14630 =item B<filter() and anonymous sub>
14632 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
14640 =item Example 1: A simple filter.
14642 =item Example 2: Using the context
14644 =item Example 3: Using the context within the filter
14646 =item Example 4: Using filter_del
14650 =item Filter::Simple
14658 =head2 FindBin - Locate directory of original perl script
14666 =item EXPORTABLE VARIABLES
14678 =head2 GDBM_File - Perl5 access to the gdbm library.
14694 =head2 Getopt::Long - Extended processing of command line options
14702 =item Command Line Options, an Introduction
14704 =item Getting Started with Getopt::Long
14708 =item Simple options
14710 =item A little bit less simple options
14712 =item Mixing command line option with other arguments
14714 =item Options with values
14716 =item Options with multiple values
14718 =item Options with hash values
14720 =item User-defined subroutines to handle options
14722 =item Options with multiple names
14724 =item Case and abbreviations
14726 =item Summary of Option Specifications
14728 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
14733 =item Advanced Possibilities
14737 =item Object oriented interface
14739 =item Thread Safety
14741 =item Documentation and help texts
14743 =item Storing options in a hash
14747 =item The lonesome dash
14749 =item Argument callback
14753 =item Configuring Getopt::Long
14755 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
14756 require_order, permute, bundling (default: disabled), bundling_override
14757 (default: disabled), ignore_case (default: enabled), ignore_case_always
14758 (default: disabled), auto_version (default:disabled), auto_help
14759 (default:disabled), pass_through (default: disabled), prefix,
14760 prefix_pattern, debug (default: disabled)
14762 =item Exportable Methods
14764 VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage
14766 =item Return values and Errors
14772 =item Default destinations
14774 =item Alternative option starters
14776 =item Configuration variables
14780 =item Trouble Shooting
14784 =item Warning: Ignoring '!' modifier for short option
14786 =item GetOptions does not return a false result when an option is not
14789 =item GetOptions does not split the command line correctly
14791 =item Undefined subroutine &main::GetOptions called
14793 =item How do I put a "-?" option into a Getopt::Long?
14799 =item COPYRIGHT AND DISCLAIMER
14803 =head2 Getopt::Std, getopt - Process single-character switches with switch
14812 =item C<--help> and C<--version>
14816 =head2 Hash::Util - A selection of general-utility hash subroutines
14826 =item Restricted hashes
14828 lock_keys, unlock_keys
14834 lock_value, unlock_value
14836 B<lock_hash>, B<unlock_hash>
14848 =head2 I18N::Collate - compare 8-bit scalar data according to the current
14859 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
14870 the function is_language_tag($lang1)
14872 the function extract_language_tags($whatever)
14874 the function same_language_tag($lang1, $lang2)
14876 the function similarity_language_tag($lang1, $lang2)
14878 the function is_dialect_of($lang1, $lang2)
14880 the function super_languages($lang1)
14882 the function locale2language_tag($locale_identifier)
14884 the function encode_language_tag($lang1)
14886 the function alternate_language_tags($lang1)
14888 the function @langs = panic_languages(@accept_languages)
14892 =item ABOUT LOWERCASING
14894 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
14904 =head2 I18N::LangTags::List -- tags and names for human languages
14912 =item ABOUT LANGUAGE TAGS
14914 =item LIST OF LANGUAGES
14916 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} :
14917 Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} :
14918 Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian,
14919 {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)],
14920 {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic,
14921 {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy}
14922 : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} :
14923 Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} :
14924 Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae}
14925 : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} :
14926 Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai}
14927 : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} :
14928 Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} :
14929 Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber
14930 (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini,
14931 {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} :
14932 Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} :
14933 Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian
14934 (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central
14935 American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages],
14936 {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb}
14937 : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} :
14938 Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} :
14939 Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree,
14940 {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf}
14941 : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based
14942 Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} :
14943 Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} :
14944 Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru)
14945 Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri,
14946 {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch,
14947 {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi}
14948 : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} :
14949 English, {enm} : Old English (1100-1500), {ang} : Old English
14950 (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} :
14951 Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat}
14952 : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} :
14953 Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French
14954 (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} :
14955 Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan,
14956 {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian,
14957 {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High
14958 German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon}
14959 : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient
14960 Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} :
14961 Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian,
14962 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
14963 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
14964 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo,
14965 {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European
14966 (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua
14967 (International Auxiliary Language Association), {ie} : Interlingue, {iu} :
14968 Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} :
14969 Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian
14970 languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} :
14971 Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle,
14972 {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} :
14973 Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar}
14974 : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh,
14975 {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese,
14976 {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz,
14977 {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} :
14978 Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama,
14979 {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} :
14980 Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} :
14981 Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} :
14982 Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban
14983 (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui}
14984 : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai,
14985 {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili,
14986 {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} :
14987 Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} :
14988 Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} :
14989 Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai,
14990 [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} :
14991 Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} :
14992 Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)],
14993 {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple
14994 languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan,
14995 {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele,
14996 {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
14997 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
14998 {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} :
14999 Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} :
15000 Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi}
15001 : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} :
15002 Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
15003 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
15004 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
15005 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
15006 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
15007 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
15008 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
15009 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
15010 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
15011 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
15012 languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} :
15013 Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami,
15014 [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} :
15015 Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak,
15016 {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian,
15017 {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign
15018 Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} :
15019 Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave
15020 (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian,
15021 {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} :
15022 Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} :
15023 South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} :
15024 Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati,
15025 {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} :
15026 Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao,
15027 {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} :
15028 Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} :
15029 Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau,
15030 {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian,
15031 {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} :
15032 Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh}
15033 : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} :
15034 Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian,
15035 {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} :
15036 Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak}
15037 : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was}
15038 : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private
15039 Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} :
15040 Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
15041 : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu,
15046 =item COPYRIGHT AND DISCLAIMER
15052 =head2 I18N::Langinfo - query locale information
15070 =item COPYRIGHT AND LICENSE
15074 =head2 IO - load various IO modules
15086 =head2 IO::Dir - supply object methods for directory handles
15094 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
15095 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
15105 =head2 IO::File - supply object methods for filehandles
15115 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
15119 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
15127 =head2 IO::Handle - supply object methods for I/O handles
15137 new (), new_from_fd ( FD, MODE )
15141 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
15142 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
15143 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
15144 $io->blocking ( [ BOOL ] ), $io->untaint
15156 =head2 IO::Pipe - supply object methods for pipes
15166 new ( [READER, WRITER] )
15170 reader ([ARGS]), writer ([ARGS]), handles ()
15180 =head2 IO::Poll - Object interface to system poll call
15190 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
15191 IO ), handles( [ EVENT_MASK ] )
15201 =head2 IO::Seekable - supply seek based methods for I/O objects
15209 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
15210 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
15219 =head2 IO::Select - OO interface to the select system call
15229 new ( [ HANDLES ] )
15233 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
15234 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
15235 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
15245 =head2 IO::Socket - Object interface to socket communications
15259 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
15260 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
15270 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
15286 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
15299 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
15313 hostpath(), peerpath()
15323 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
15332 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
15333 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
15343 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
15353 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
15357 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
15365 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
15376 new (), new_from_fd ( FD, MODE )
15380 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
15381 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
15382 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
15383 $io->blocking ( [ BOOL ] ), $io->untaint
15395 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
15405 new ( [READER, WRITER] )
15409 reader ([ARGS]), writer ([ARGS]), handles ()
15419 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
15429 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
15430 IO ), handles( [ EVENT_MASK ] )
15440 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
15449 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
15450 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
15459 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
15470 new ( [ HANDLES ] )
15474 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
15475 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
15476 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
15486 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
15501 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
15502 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
15512 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
15513 AF_INET domain sockets
15529 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
15542 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
15543 AF_UNIX domain sockets
15557 hostpath(), peerpath()
15567 =head2 IPC::Msg - SysV Msg IPC object class
15577 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
15578 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
15589 =head2 IPC::Open2, open2 - open a process for both reading and writing
15603 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
15616 =head2 IPC::Semaphore - SysV Semaphore IPC object class
15626 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
15627 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
15628 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
15639 =head2 IPC::SysV - SysV IPC constants
15657 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
15667 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
15668 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
15679 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
15690 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
15691 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
15692 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
15703 =head2 List::Util - A selection of general-utility list subroutines
15711 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
15712 BLOCK LIST, shuffle LIST, sum LIST
15716 =item SUGGESTED ADDITIONS
15722 =head2 List::Utilib::List::Util, List::Util - A selection of
15723 general-utility list subroutines
15731 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
15732 BLOCK LIST, shuffle LIST, sum LIST
15736 =item SUGGESTED ADDITIONS
15742 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
15743 general-utility scalar subroutines
15751 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
15752 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
15753 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
15763 =head2 Locale::Constants - constants for Locale codes
15771 =item KNOWN BUGS AND LIMITATIONS
15775 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
15783 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
15791 B<alpha-2>, B<alpha-3>, B<numeric>
15793 =item CONVERSION ROUTINES
15795 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
15796 country_code2code( CODE, CODESET, CODESET )
15798 =item QUERY ROUTINES
15800 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
15802 =item SEMI-PRIVATE ROUTINES
15808 =item rename_country
15816 =item KNOWN BUGS AND LIMITATIONS
15820 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
15821 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
15822 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
15823 http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
15831 =head2 Locale::Currency - ISO three letter codes for currency
15832 identification (ISO 4217)
15842 =item CONVERSION ROUTINES
15844 code2currency(), currency2code()
15846 =item QUERY ROUTINES
15848 C<all_currency_codes()>, C<all_currency_names()>
15852 =item KNOWN BUGS AND LIMITATIONS
15856 Locale::Country, Locale::Script, ISO 4217:1995,
15857 http://www.bsi-global.com/iso4217currency
15865 =head2 Locale::Language - ISO two letter codes for language identification
15874 =item CONVERSION ROUTINES
15876 code2language(), language2code()
15878 =item QUERY ROUTINES
15880 C<all_language_codes()>, C<all_language_names()>
15884 =item KNOWN BUGS AND LIMITATIONS
15888 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
15889 http://lcweb.loc.gov/standards/iso639-2/langhome.html
15897 =head2 Locale::Maketext - framework for localization
15905 =item QUICK OVERVIEW
15911 =item Construction Methods
15913 =item The "maketext" Method
15915 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
15917 =item Utility Methods
15919 $language->quant($number, $singular), $language->quant($number, $singular,
15920 $plural), $language->quant($number, $singular, $plural, $negative),
15921 $language->numf($number), $language->sprintf($format, @items),
15922 $language->language_tag(), $language->encoding()
15924 =item Language Handle Attributes and Internals
15928 =item LANGUAGE CLASS HIERARCHIES
15930 =item ENTRIES IN EACH LEXICON
15932 =item BRACKET NOTATION
15934 =item AUTO LEXICONS
15936 =item CONTROLLING LOOKUP FAILURE
15938 =item HOW TO USE MAKETEXT
15942 =item COPYRIGHT AND DISCLAIMER
15948 =head2 Locale::Maketext::TPJ13 -- article about software localization
15956 =item Localization and Perl: gettext breaks, Maketext fixes
15960 =item A Localization Horror Story: It Could Happen To You
15962 =item The Linguistic View
15964 =item Breaking gettext
15966 =item Replacing gettext
15968 =item Buzzwords: Abstraction and Encapsulation
15970 =item Buzzword: Isomorphism
15972 =item Buzzword: Inheritance
15974 =item Buzzword: Concision
15976 =item The Devil in the Details
15978 =item The Proof in the Pudding: Localizing Web Sites
15986 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
15994 B<alpha-2>, B<alpha-3>, B<numeric>
15998 =item SPECIAL CODES
16002 =item CONVERSION ROUTINES
16004 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
16005 script_code2code( CODE, CODESET, CODESET )
16007 =item QUERY ROUTINES
16009 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
16013 =item KNOWN BUGS AND LIMITATIONS
16017 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
16018 http://www.evertype.com/standards/iso15924/
16026 =head2 MIME::Base64 - Encoding and decoding of base64 strings
16034 encode_base64($str), encode_base64($str, $eol);, decode_base64($str)
16038 Premature end of base64 data, Premature padding of base64 data
16046 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
16047 of quoted-printable strings
16055 encode_qp($str), encode_qp($str, $eol), decode_qp($str);
16061 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
16070 encode_qp($str), encode_qp($str, $eol), decode_qp($str);
16076 =head2 Math::BigFloat - Arbitrary size floating point math package
16086 =item Canonical notation
16090 =item C<mantissa()>, C<exponent()> and C<parts()>
16092 =item Accuracy vs. Precision
16096 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround ( +$scale
16097 ), fround ( -$scale ) and fround ( 0 )
16105 =item Autocreating constants
16111 =item Using Math::BigInt::Lite
16119 stringify, bstr(), bdiv, Modifying and =, bpow
16129 =head2 Math::BigInt - Arbitrary size integer math package
16137 Canonical notation, Input, Output
16161 =item is_one()/is_zero()/is_nan()/is_inf()
16163 =item is_positive()/is_negative()
16165 $x->is_positive(); # true if >= 0
16166 $x->is_negative(); # true if < 0
16168 =item is_odd()/is_even()/is_int()
16254 =item ACCURACY and PRECISION
16264 =item Rounding mode R
16266 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
16267 (significant digits), Setting/Accessing, Creating numbers, Usage,
16268 Precedence, Overriding globals, Local settings, Rounding, Default values,
16281 =item mantissa(), exponent() and parts()
16289 =item Autocreating constants
16295 =item Alternative math libraries
16301 =item Subclassing Math::BigInt
16309 bsqrt(), div(), blog()
16315 broot() does not work, Out of Memory!, Fails to load Calc on Perl prior
16320 stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
16321 handling, Modifying and =, bpow, Overloading -$x, Mixing different object
16322 types, bsqrt(), brsft()
16332 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
16344 =item WRAP YOUR OWN
16348 This program is free software; you may redistribute it and/or modify it
16350 the same terms as Perl itself.
16358 =head2 Math::BigInt::Scalar - Pure Perl module to test Math::BigInt with
16369 This program is free software; you may redistribute it and/or modify it
16371 the same terms as Perl itself.
16379 =head2 Math::BigRat - arbitrarily big rationals
16401 =item denominator()
16403 $d = $x->denominator();
16413 =item bround()/round()/bfround()
16421 =item is_positive()
16423 =item is_negative()
16443 inf handling (partial), NaN handling (partial), rounding (not implemented
16444 except for bceil/bfloor), $x ** $y where $y is not an integer
16454 =head2 Math::Complex - complex numbers and associated mathematical
16467 =item STRINGIFICATION
16471 =item CHANGED IN PERL 5.6
16477 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
16479 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
16487 =head2 Math::Trig - trigonometric functions
16495 =item TRIGONOMETRIC FUNCTIONS
16501 =item ERRORS DUE TO DIVISION BY ZERO
16503 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
16507 =item PLANE ANGLE CONVERSIONS
16509 =item RADIAL COORDINATE CONVERSIONS
16513 =item COORDINATE SYSTEMS
16515 =item 3-D ANGLE CONVERSIONS
16517 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
16518 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
16522 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
16528 =item CAVEAT FOR GREAT CIRCLE FORMULAS
16538 =head2 Memoize - Make functions faster by trading space for time
16556 =item C<SCALAR_CACHE>, C<LIST_CACHE>
16558 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
16562 =item OTHER FACILITIES
16568 =item C<flush_cache>
16574 =item PERSISTENT CACHE SUPPORT
16576 =item EXPIRATION SUPPORT
16584 =item COPYRIGHT AND LICENSE
16590 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
16599 =head2 Memoize::Expire - Plug-in module for automatic expiration of
16610 TIEHASH, EXISTS, STORE
16622 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
16630 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
16638 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
16647 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
16656 =head2 Memoize::Storable - store Memoized data in Storable database
16664 =head2 NDBM_File - Tied access to ndbm files
16672 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
16678 =item C<ndbm store returned -1, errno 22, key "..." at ...>
16682 =item BUGS AND WARNINGS
16686 =head2 NEXT - Provide a pseudo-class NEXT (et al) that allows method
16697 =item Enforcing redispatch
16699 =item Avoiding repetitions
16701 =item Invoking all versions of a method with a single call
16703 =item Using C<EVERY> methods
16709 =item BUGS AND IRRITATIONS
16715 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
16725 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
16728 =item CLASS METHODS
16730 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
16731 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
16732 ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh ()
16742 =head2 Net::Config - Local configuration data for libnet
16752 requires_firewall HOST
16754 =item NetConfig VALUES
16756 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
16757 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
16758 ftp_int_pasive, local_netmask, test_hosts, test_exists
16762 =head2 Net::Domain - Attempt to evaluate the current host's internet name
16771 hostfqdn (), hostname (), hostdomain ()
16779 =head2 Net::FTP - FTP Client class
16791 new (HOST [,OPTIONS])
16795 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
16796 site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS])
16797 ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME
16798 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ),
16799 mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), alloc ( SIZE [, RECORD_SIZE] ),
16800 dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put (
16801 LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ),
16802 append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size
16803 ( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[
16804 BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ DIR ] ), retr ( FILE ),
16805 stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [ PORT ] ), pasv (),
16806 pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_xfer_unique (
16807 SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( NON_PASV_SERVER ),
16812 =item Methods for the adventurous
16818 =item THE dataconn CLASS
16820 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
16821 bytes_read (), abort (), close ()
16823 =item UNIMPLEMENTED
16825 B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
16827 =item REPORTING BUGS
16835 http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
16843 =head2 Net::NNTP - NNTP Client class
16853 new ( [ HOST ] [, OPTIONS ])
16857 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
16858 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
16859 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
16860 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
16861 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
16862 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
16863 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
16867 =item Extension methods
16869 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
16870 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
16871 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
16872 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
16881 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
16891 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
16901 new ( [ HOST, ] [ OPTIONS ] )
16905 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
16906 PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
16907 [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
16908 MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
16920 =head2 Net::Ping - check a remote host for reachability
16932 Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos
16933 ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
16934 $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
16935 $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
16936 [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host
16953 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
16965 new Net::SMTP [ HOST, ] [ OPTIONS ]
16969 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
16970 PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
16971 ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
16972 ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
16973 ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
16974 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
16987 =head2 Net::Time - time and daytime network client interface
16995 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
16996 PROTOCOL [, TIMEOUT]]])
17004 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
17021 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
17029 =item Where to get this document
17031 =item How to contribute to this document
17035 =item Author and Copyright Information
17043 =item Obtaining and installing libnet
17047 =item What is libnet ?
17049 =item Which version of perl do I need ?
17051 =item What other modules do I need ?
17053 =item What machines support libnet ?
17055 =item Where can I get the latest libnet release
17059 =item Using Net::FTP
17063 =item How do I download files from an FTP server ?
17065 =item How do I transfer files in binary mode ?
17067 =item How can I get the size of a file on a remote FTP server ?
17069 =item How can I get the modification time of a file on a remote FTP server
17072 =item How can I change the permissions of a file on a remote server ?
17074 =item Can I do a reget operation like the ftp command ?
17076 =item How do I get a directory listing from an FTP server ?
17078 =item Changing directory to "" does not fail ?
17080 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
17082 =item I am behind an FTP proxy firewall, but cannot access machines outside
17085 =item My ftp proxy firewall does not listen on port 21
17087 =item Is it possible to change the file permissions of a file on an FTP
17090 =item I have seen scripts call a method message, but cannot find it
17093 =item Why does Net::FTP not implement mput and mget methods
17097 =item Using Net::SMTP
17101 =item Why can't the part of an Email address after the @ be used as the
17104 =item Why does Net::SMTP not do DNS MX lookups ?
17106 =item The verify method always returns true ?
17110 =item Debugging scripts
17114 =item How can I debug my scripts that use Net::* modules ?
17118 =item AUTHOR AND COPYRIGHT
17122 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
17139 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
17154 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
17171 =head2 Netrc, Net::Netrc - OO interface to users netrc file
17179 =item THE .netrc FILE
17181 machine name, default, login name, password string, account string, macdef
17186 lookup ( MACHINE [, LOGIN ])
17190 login (), password (), account (), lpa ()
17200 =head2 O - Generic interface to Perl Compiler backends
17210 =item IMPLEMENTATION
17218 =head2 ODBM_File - Tied access to odbm files
17226 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17232 =item C<odbm store returned -1, errno 22, key "..." at ...>
17236 =item BUGS AND WARNINGS
17240 =head2 Opcode - Disable named opcodes when compiling perl code
17252 =item Operator Names and Operator Lists
17254 an operator name (opname), an operator tag name (optag), a negated opname
17255 or optag, an operator set (opset)
17257 =item Opcode Functions
17259 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
17260 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
17261 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
17264 =item Manipulating Opsets
17266 =item TO DO (maybe)
17272 =item Predefined Opcode Tags
17274 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
17275 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
17276 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
17285 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
17294 a new namespace, an operator mask
17300 =item RECENT CHANGES
17302 =item Methods in class Safe
17304 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
17305 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
17306 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
17307 root (NAMESPACE), mask (MASK)
17309 =item Some Safety Issues
17311 Memory, CPU, Snooping, Signals, State Changes
17319 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
17332 =head2 POSIX - Perl interface to IEEE Std 1003.1
17346 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
17347 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
17348 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
17349 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
17350 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
17351 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
17352 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
17353 fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv,
17354 geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid,
17355 getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha,
17356 isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace,
17357 isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime,
17358 log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr,
17359 memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice,
17360 offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc,
17361 putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename,
17362 rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid,
17363 setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
17364 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
17365 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
17366 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
17367 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
17368 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
17369 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
17370 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
17377 =item POSIX::SigAction
17379 new, handler, mask, flags, safe
17381 =item POSIX::SigSet
17383 new, addset, delset, emptyset, fillset, ismember
17385 =item POSIX::Termios
17387 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
17388 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
17389 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
17390 field values, c_cflag field values, c_iflag field values, c_lflag field
17391 values, c_oflag field values
17395 =item PATHNAME CONSTANTS
17399 =item POSIX CONSTANTS
17403 =item SYSTEM CONFIGURATION
17457 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
17458 WTERMSIG, WIFSTOPPED, WSTOPSIG
17462 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
17471 unix, stdio, perlio, crlf, utf8, bytes, raw, pop
17475 =item Custom Layers
17479 =item Alternatives to raw
17481 =item Defaults and how to override them
17483 =item Querying the layers of filehandle
17493 =head2 PerlIO::encoding - encoding layer
17505 =head2 PerlIO::scalar - support module for in-memory IO.
17515 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
17523 =item EXPECTED METHODS
17525 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
17526 $obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]),
17527 $obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]),
17528 $obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh),
17529 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
17530 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
17531 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
17532 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
17538 =item Example - a Hexadecimal Handle
17544 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
17554 =item ACKNOWLEDGEMENTS
17560 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
17566 =item OPTIONS/ARGUMENTS
17572 B<-warnings> =E<gt> I<val>
17584 empty =headn, =over on line I<N> without closing =back, =item without
17585 previous =over, =back without previous =over, No argument for =begin, =end
17586 without =begin, Nested =begin's, =for without formatter specification,
17587 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
17588 interior-sequence "I<SEQ>", nested commands
17589 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
17590 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
17591 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
17596 multiple occurrence of link target I<name>, line containing nothing but
17597 whitespace in paragraph, file does not start with =head, previous =item has
17598 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
17599 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
17600 items in =over, No argument for =item, empty section in previous paragraph,
17601 Verbatim paragraph in NAME section, =headI<n> without preceding higher
17606 ignoring leading/trailing whitespace in link, (section) in '$page'
17607 deprecated, alternative text/node '%s' contains non-escaped | or /
17619 C<Pod::Checker-E<gt>new( %options )>
17621 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
17624 C<$checker-E<gt>num_errors()>
17626 C<$checker-E<gt>num_warnings()>
17628 C<$checker-E<gt>name()>
17630 C<$checker-E<gt>node()>
17632 C<$checker-E<gt>idx()>
17634 C<$checker-E<gt>hyperlink()>
17642 =head2 Pod::Find - find POD documents in directory trees
17654 =item C<pod_find( { %opts } , @directories )>
17656 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
17663 =item C<simplify_name( $str )>
17669 =item C<pod_where( { %opts }, $pod )>
17671 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
17678 =item C<contains_pod( $file , $verbose )>
17690 =head2 Pod::Html - module to convert pod files to HTML
17700 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
17701 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
17716 =head2 Pod::InputObjects - objects representing POD input paragraphs,
17729 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
17730 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
17736 =item B<Pod::InputSource>
17760 =item B<was_cutting()>
17766 =item B<Pod::Paragraph>
17772 =item Pod::Paragraph-E<gt>B<new()>
17778 =item $pod_para-E<gt>B<cmd_name()>
17784 =item $pod_para-E<gt>B<text()>
17790 =item $pod_para-E<gt>B<raw_text()>
17796 =item $pod_para-E<gt>B<cmd_prefix()>
17802 =item $pod_para-E<gt>B<cmd_separator()>
17808 =item $pod_para-E<gt>B<parse_tree()>
17814 =item $pod_para-E<gt>B<file_line()>
17820 =item B<Pod::InteriorSequence>
17826 =item Pod::InteriorSequence-E<gt>B<new()>
17832 =item $pod_seq-E<gt>B<cmd_name()>
17838 =item $pod_seq-E<gt>B<prepend()>
17844 =item $pod_seq-E<gt>B<append()>
17850 =item $pod_seq-E<gt>B<nested()>
17856 =item $pod_seq-E<gt>B<raw_text()>
17862 =item $pod_seq-E<gt>B<left_delimiter()>
17868 =item $pod_seq-E<gt>B<right_delimiter()>
17874 =item $pod_seq-E<gt>B<parse_tree()>
17880 =item $pod_seq-E<gt>B<file_line()>
17886 =item Pod::InteriorSequence::B<DESTROY()>
17892 =item B<Pod::ParseTree>
17898 =item Pod::ParseTree-E<gt>B<new()>
17904 =item $ptree-E<gt>B<top()>
17910 =item $ptree-E<gt>B<children()>
17916 =item $ptree-E<gt>B<prepend()>
17922 =item $ptree-E<gt>B<append()>
17928 =item $ptree-E<gt>B<raw_text()>
17934 =item Pod::ParseTree::B<DESTROY()>
17946 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
17958 =item OBJECT METHODS
17966 =item Data Accessors
17982 B<ReplaceNAMEwithSection>
17984 B<StartWithNewPage>
17998 =item Subclassed methods
18012 B<interior_sequence>
18028 =item Methods for headings
18036 =item Internal methods
18042 B<_replace_special_chars>
18044 B<_replace_special_chars_late>
18050 B<_clean_latex_commands>
18052 B<_split_delimited>
18068 =head2 Pod::Man - Convert POD data to formatted *roff input
18076 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
18081 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
18082 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
18083 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
18094 =item COPYRIGHT AND LICENSE
18098 =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
18110 =item COPYRIGHT AND LICENSE
18114 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
18128 Pod::List-E<gt>new()
18136 $list-E<gt>indent()
18144 $list-E<gt>parent()
18150 =item Pod::Hyperlink
18152 Pod::Hyperlink-E<gt>new()
18156 $link-E<gt>parse($string)
18158 $link-E<gt>markup($string)
18162 $link-E<gt>warning()
18164 $link-E<gt>file(), $link-E<gt>line()
18170 $link-E<gt>alttext()
18180 Pod::Cache-E<gt>new()
18186 $cache-E<gt>find_page($name)
18190 =item Pod::Cache::Item
18192 Pod::Cache::Item-E<gt>new()
18196 $cacheitem-E<gt>page()
18198 $cacheitem-E<gt>description()
18200 $cacheitem-E<gt>path()
18202 $cacheitem-E<gt>file()
18204 $cacheitem-E<gt>nodes()
18206 $cacheitem-E<gt>find_node($name)
18208 $cacheitem-E<gt>idx()
18218 =head2 Pod::Parser - base class for creating POD filters and translators
18230 =item QUICK OVERVIEW
18232 =item PARSING OPTIONS
18234 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
18235 B<-warnings> (default: unset)
18241 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
18249 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
18255 =item B<verbatim()>
18257 C<$text>, C<$line_num>, C<$pod_para>
18263 =item B<textblock()>
18265 C<$text>, C<$line_num>, C<$pod_para>
18271 =item B<interior_sequence()>
18277 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
18289 =item B<initialize()>
18295 =item B<begin_pod()>
18301 =item B<begin_input()>
18307 =item B<end_input()>
18319 =item B<preprocess_line()>
18325 =item B<preprocess_paragraph()>
18331 =item METHODS FOR PARSING AND PROCESSING
18337 =item B<parse_text()>
18339 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
18340 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
18341 I<code-ref>|I<method-name>
18347 =item B<interpolate()>
18353 =item B<parse_paragraph()>
18359 =item B<parse_from_filehandle()>
18365 =item B<parse_from_file()>
18371 =item ACCESSOR METHODS
18377 =item B<errorsub()>
18389 =item B<parseopts()>
18395 =item B<output_file()>
18401 =item B<output_handle()>
18407 =item B<input_file()>
18413 =item B<input_handle()>
18419 =item B<input_streams()>
18425 =item B<top_stream()>
18431 =item PRIVATE METHODS AND DATA
18437 =item B<_push_input_stream()>
18443 =item B<_pop_input_stream()>
18449 =item TREE-BASED PARSING
18457 =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors
18467 =item COPYRIGHT AND DISCLAIMERS
18473 =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages
18485 =item COPYRIGHT AND DISCLAIMERS
18491 =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff
18503 =item COPYRIGHT AND DISCLAIMERS
18509 =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod!
18519 =item COPYRIGHT AND DISCLAIMERS
18525 =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF
18535 =item COPYRIGHT AND DISCLAIMERS
18541 =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext
18553 =item COPYRIGHT AND DISCLAIMERS
18559 =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod
18573 =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML
18583 =item COPYRIGHT AND DISCLAIMERS
18589 =head2 Pod::PlainText - Convert POD data to formatted ASCII text
18597 alt, indent, loose, sentence, width
18601 Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
18602 Unknown sequence: %s, Unmatched =back
18614 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
18634 =head2 Pod::Select, podselect() - extract selected sections of POD from
18647 =item SECTION SPECIFICATIONS
18649 =item RANGE SPECIFICATIONS
18655 =item OBJECT METHODS
18661 =item B<curr_headings()>
18673 =item B<add_selection()>
18679 =item B<clear_selections()>
18685 =item B<match_section()>
18691 =item B<is_selected()>
18697 =item EXPORTED FUNCTIONS
18703 =item B<podselect()>
18705 B<-output>, B<-sections>, B<-ranges>
18711 =item PRIVATE METHODS AND DATA
18717 =item B<_compile_section_spec()>
18723 =item $self->{_SECTION_HEADINGS}
18729 =item $self->{_SELECTED_SECTIONS}
18741 =head2 Pod::Text - Convert POD data to formatted ASCII text
18749 alt, code, indent, loose, margin, quotes, sentence, width
18753 Bizarre space in item, Item called without tag, Can't open %s for reading:
18754 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
18755 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
18766 =item COPYRIGHT AND LICENSE
18770 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
18784 =item COPYRIGHT AND LICENSE
18788 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
18803 =item COPYRIGHT AND LICENSE
18807 =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
18822 =item COPYRIGHT AND LICENSE
18826 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
18835 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
18844 =item Recommended Use
18852 =item ACKNOWLEDGEMENTS
18856 =head2 SDBM_File - Tied access to sdbm files
18864 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
18870 =item C<sdbm store returned -1, errno 22, key "..." at ...>
18874 =item BUGS AND WARNINGS
18878 =head2 Safe - Compile and execute code in restricted compartments
18886 a new namespace, an operator mask
18892 =item RECENT CHANGES
18894 =item Methods in class Safe
18896 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
18897 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
18898 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
18899 root (NAMESPACE), mask (MASK)
18901 =item Some Safety Issues
18903 Memory, CPU, Snooping, Signals, State Changes
18911 =head2 Scalar::Util - A selection of general-utility scalar subroutines
18919 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
18920 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
18921 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
18931 =head2 Search::Dict, look - search for key in dictionary file
18941 =head2 SelectSaver - save and restore selected file handle
18951 =head2 SelfLoader - load functions only on demand
18961 =item The __DATA__ token
18963 =item SelfLoader autoloading
18965 =item Autoloading and package lexicals
18967 =item SelfLoader and AutoLoader
18969 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
18971 =item Classes and inherited methods.
18975 =item Multiple packages and fully qualified subroutine names
18979 =head2 Shell - run shell commands transparently within perl
18989 =item OBJECT ORIENTED SYNTAX
18997 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
18998 socket.h defines and structure manipulators
19006 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
19007 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
19008 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
19009 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
19010 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
19014 =head2 Storable - persistence for Perl data structures
19024 =item ADVISORY LOCKING
19028 =item CANONICAL REPRESENTATION
19030 =item CODE REFERENCES
19032 =item FORWARD COMPATIBILITY
19034 utf8 data, restricted hashes, files from future versions of Storable
19036 =item ERROR REPORTING
19044 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
19049 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
19050 C<Storable::is_retrieving>
19058 =item Storable magic
19068 =item 64 bit data in perl 5.6.0 and 5.6.1
19080 =head2 Switch - A switch statement for Perl
19094 =item Allowing fall-through
19096 =item Automating fall-through
19098 =item Alternative syntax
19100 =item Higher-order Operations
19116 =head2 Symbol - manipulate Perl symbols and their names
19126 =head2 Sys::Hostname - Try every conceivable way to get hostname
19138 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
19139 interface to the UNIX syslog(3) calls
19147 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19148 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19149 in 5.004_02), closelog
19159 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
19160 Perl interface to the UNIX syslog(3) calls
19168 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19169 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19170 in 5.004_02), closelog
19180 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
19190 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
19191 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
19192 comma allowed after filehandle, No name for escape sequence %s
19196 ANSI_COLORS_DISABLED
19206 =item COPYRIGHT AND LICENSE
19210 =head2 Term::Cap - Perl termcap interface
19226 B<Tgetent>, OSPEED, TERM
19228 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
19230 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
19232 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
19240 =item COPYRIGHT AND LICENSE
19248 =head2 Term::Complete - Perl word completion module
19256 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
19266 =head2 Term::ReadLine - Perl interface to various C<readline> packages.
19267 If no real package is found, substitutes stubs instead of basic functions.
19275 =item Minimal set of supported functions
19277 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>,
19278 C<findConsole>, Attribs, C<Features>
19280 =item Additional supported functions
19282 C<tkRunning>, C<ornaments>, C<newTTY>
19292 =head2 Test - provides a simple framework for writing test scripts
19300 =item QUICK START GUIDE
19306 C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>,
19307 C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub>
19317 C<skip(I<skip_if_true>, I<args...>)>
19323 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
19327 =item BUGS and CAVEATS
19337 =head2 Test::Builder - Backend for building test libraries
19357 =item Setting up tests
19375 =item Running tests
19381 B<is_eq>, B<is_num>
19383 B<isnt_eq>, B<isnt_num>
19409 B<no_header>, B<no_ending>
19421 B<output>, B<failure_output>, B<todo_output>
19425 =item Test Status and Info
19459 =head2 Test::Harness - run perl standard test scripts with statistics
19469 =item The test script output
19471 B<'1..M'>, B<'ok', 'not ok'. Ok?>, B<test numbers>, B<test names>,
19472 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
19477 =item Configuration variables.
19479 B<$Test::Harness::verbose>, B<$Test::Harness::switches>
19483 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
19510 C<All tests successful.\nFiles=%d, Tests=%d, %s>, C<FAILED tests
19511 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
19512 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
19513 %s>, C<FAILED--Further testing stopped: %s>
19517 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
19518 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
19519 C<HARNESS_OK_SLOW>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
19535 =head2 Test::Harness::Assert - simple assert
19561 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
19571 =head2 Test::Harness::Straps - detailed analysis of test results
19609 =item C<analyze_fh>
19615 =item C<analyze_file>
19627 =item C<_INC2PERL5LIB>
19633 =item C<_filtered_INC>
19639 =item C<_restore_PERL5LIB>
19649 =item C<_is_comment>
19657 =item C<_is_header>
19669 =item C<_is_bail_out>
19675 =item C<_reset_file_state>
19685 =item C<_detailize>
19701 =head2 Test::More - yet another framework for writing test scripts
19711 =item I love it when a plan comes together
19721 =item I'm ok, you're not ok.
19761 =item Conditional tests
19767 B<TODO: BLOCK>, B<todo_skip>
19769 When do I use SKIP vs. TODO?
19773 =item Comparison functions
19787 =item Extending and Embedding Test::More
19797 =item BUGS and CAVEATS
19799 Making your own ok(), The eq_* family has some caveats, Test::Harness
19812 =head2 Test::Simple - Basic utilities for writing tests.
19836 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
19845 =head2 Test::Tutorial - A tutorial about writing really basic tests
19853 =item Nuts and bolts of testing.
19855 =item Where to start?
19859 =item Test the manual
19861 =item Sometimes the tests are wrong
19863 =item Testing lots of values
19865 =item Informative names
19867 =item Skipping tests
19871 =item Testing with taint mode.
19883 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
19895 =head2 Text::Balanced - Extract delimited text sequences from strings.
19905 =item General behaviour in list contexts
19909 =item General behaviour in scalar and void contexts
19911 =item A note about prefixes
19913 =item C<extract_delimited>
19915 =item C<extract_bracketed>
19917 =item C<extract_variable>
19921 =item C<extract_tagged>
19923 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
19924 [0], [1], [2], [3], [4], [5]
19926 =item C<gen_extract_tagged>
19928 =item C<extract_quotelike>
19930 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
19932 =item C<extract_quotelike> and "here documents"
19934 [0], [1], [2], [3], [4], [5], [6], [7..10]
19936 =item C<extract_codeblock>
19938 =item C<extract_multiple>
19940 =item C<gen_delimited_pat>
19946 C<Did not find a suitable bracket: "%s">, C<Did not find prefix: /%s/>,
19947 C<Did not find opening bracket after prefix: "%s">, C<No quotelike
19948 operator found after prefix: "%s">, C<Unmatched closing bracket: "%c">,
19949 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
19950 C<Did not find closing delimiter to match '%s'>, C<Mismatched closing
19951 bracket: expected "%c" but found "%s">, C<No block delimiter found after
19952 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
19953 after dereferencer>, C<Did not find expected opening bracket at %s>,
19954 C<Improperly nested codeblock at %s>, C<Missing second block for quotelike
19955 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
19956 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
19957 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
19962 =item BUGS AND IRRITATIONS
19968 =head2 Text::ParseWords - parse text into an array of tokens or array of
19983 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
20000 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
20015 =head2 Text::Wrap - line wrapping to form simple paragraphs
20031 =head2 Thread - manipulate threads in Perl (for old code only)
20043 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
20044 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
20045 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
20049 join, eval, detach, equal, tid, flags, done
20057 =head2 Thread::Queue - thread-safe queues
20065 =item FUNCTIONS AND METHODS
20067 new, enqueue LIST, dequeue, dequeue_nb, pending
20073 =head2 Thread::Semaphore - thread-safe semaphores
20081 =item FUNCTIONS AND METHODS
20083 new, new NUMBER, down, down NUMBER, up, up NUMBER
20087 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
20102 =head2 Thread::Specific - thread-specific keys
20112 =head2 Tie::Array - base class for tied arrays
20120 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
20121 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
20122 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
20123 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
20131 =head2 Tie::File - Access the lines of a disk file via a Perl array
20151 =item Option Format
20155 =item Public Methods
20163 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
20169 =item Tying to an already-opened filehandle
20171 =item Deferred Writing
20175 =item Autodeferring
20179 =item CONCURRENT ACCESS TO FILES
20185 =item WHAT ABOUT C<DB_File>?
20199 =head2 Tie::Handle, Tie::StdHandle - base class definitions for tied
20208 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
20209 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
20210 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
20211 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
20213 =item MORE INFORMATION
20215 =item COMPATIBILITY
20219 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
20228 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
20229 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
20231 =item Inheriting from B<Tie::StdHash>
20233 =item Inheriting from B<Tie::ExtraHash>
20235 =item C<UNTIE> and C<DESTROY>
20237 =item MORE INFORMATION
20241 =head2 Tie::Memoize - add data to hash when needed
20249 =item Inheriting from B<Tie::Memoize>
20259 =head2 Tie::RefHash - use references as hash keys
20277 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
20286 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
20288 =item MORE INFORMATION
20292 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
20304 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
20313 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
20314 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
20315 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer (
20316 $which, $floating_seconds [, $interval_floating_seconds ] ), getitimer (
20327 =item negative time not invented yet
20329 =item internal error: useconds < 0 (unsigned ... signed ...)
20337 =item COPYRIGHT AND LICENSE
20341 =head2 Time::Local - efficiently compute time from local and GMT time
20349 =item IMPLEMENTATION
20359 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
20374 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
20389 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
20401 =head2 UNIVERSAL - base class for ALL classes (blessed references)
20409 C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<isa( VAL, TYPE )>,
20410 C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD ) >>, C<<
20411 CLASS->can( METHOD ) >>, C<can( VAL, METHOD )>, C<VERSION ( [ REQUIRE ] )>
20417 =head2 Unicode::Collate - Unicode Collation Algorithm
20427 =item Constructor and Tailoring
20429 UCA_Version, alternate, backwards, entry, ignoreName, ignoreChar, level,
20430 normalization, overrideCJK, overrideHangul, preprocess, rearrange, table,
20431 undefName, undefChar, katakana_before_hiragana, upper_before_lower
20433 =item Methods for Collation
20435 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
20436 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
20437 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
20438 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
20439 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
20440 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
20441 $Collator-E<gt>viewSortKey($string)>
20443 =item Methods for Searching
20445 C<$position = $Collator-E<gt>index($string, $substring[, $position])>,
20446 C<($position, $length) = $Collator-E<gt>index($string, $substring[,
20447 $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>,
20448 C<($match) = $Collator-E<gt>match($string, $substring)>, C<@match =
20449 $Collator-E<gt>gmatch($string, $substring)>, C<$count =
20450 $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count =
20451 $Collator-E<gt>gsubst($string, $substring, $replacement)>
20453 =item Other Methods
20455 C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, UCA_Version,
20456 Base_Unicode_Version
20462 =item Conformance Test
20470 http://www.unicode.org/reports/tr10/,
20471 http://www.unicode.org/reports/tr10/allkeys.txt,
20472 http://www.unicode.org/reports/tr10/CollationTest.html
20473 http://www.unicode.org/reports/tr10/CollationTest.zip,
20474 http://www.unicode.org/reports/tr15/, L<Unicode::Normalize>
20478 =head2 Unicode::Normalize - Unicode Normalization Forms
20488 =item Normalization Forms
20490 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
20491 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
20492 C<$normalized_string = normalize($form_name, $string)>
20494 =item Decomposition and Composition
20496 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
20497 decompose($string, $useCompatMapping)>, C<$reordered_string =
20498 reorder($string)>, C<$composed_string = compose($string)>
20502 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
20503 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
20504 check($form_name, $string)>
20506 =item Character Data
20508 C<$canonical_decomposed = getCanon($codepoint)>,
20509 C<$compatibility_decomposed = getCompat($codepoint)>,
20510 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
20511 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
20512 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
20513 C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>,
20514 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
20524 http://www.unicode.org/unicode/reports/tr15/,
20525 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt
20529 =head2 Unicode::UCD - Unicode character database
20571 =item Blocks versus Scripts
20573 =item Matching Scripts and Blocks
20575 =item Code Point Arguments
20601 =item Unicode::UCD::UnicodeVersion
20607 =item Implementation Note
20619 =head2 User::grent - by-name interface to Perl's built-in getgr*()
20634 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
20645 =item System Specifics
20659 =head2 Win32 - Interfaces to some Win32 API Functions
20667 =item Alphabetical Listing of Win32 Functions
20669 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
20670 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
20671 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
20672 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
20673 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFolderPath(FOLDER [,
20674 CREATE]), Win32::GetFullPathName(FILENAME), Win32::GetLastError(),
20675 Win32::GetLongPathName(PATHNAME), Win32::GetNextAvailDrive(),
20676 Win32::GetOSVersion(), Win32::GetOSName(),
20677 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
20678 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
20679 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
20680 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
20681 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
20682 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
20683 Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
20684 Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
20685 Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
20686 Win32::UnregisterServer(LIBRARYNAME)
20692 =head2 XSLoader - Dynamically load C libraries into Perl code
20702 =item Migration from C<DynaLoader>
20704 =item Backward compatible boilerplate
20708 =item Order of initialization: early load()
20712 =item The most hairy case
20722 =head1 AUXILIARY DOCUMENTATION
20724 Here should be listed all the extra programs' documentation, but they
20725 don't all have manual pages yet:
20759 Larry Wall <F<larry@wall.org>>, with the help of oodles