With VMS moving from [lib.pod] to [lib.pods] then pod/buildtoc needs
[p5sagit/p5-mst-13.2.git] / pod / perltoc.pod
1
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.
5
6 =head1 NAME
7
8 perltoc - perl documentation table of contents
9
10 =head1 DESCRIPTION
11
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.
15
16 =head1 BASIC DOCUMENTATION
17
18 =head2 perl - Practical Extraction and Report Language
19
20 =over 4
21
22 =item SYNOPSIS
23
24 =over 4
25
26 =item Overview
27
28 =item Tutorials
29
30 =item Reference Manual
31
32 =item Internals and C Language Interface
33
34 =item Miscellaneous
35
36 =item Language-Specific
37
38 =item Platform-Specific
39
40 =back
41
42 =item DESCRIPTION
43
44 =item AVAILABILITY
45
46 =item ENVIRONMENT
47
48 =item AUTHOR
49
50 =item FILES
51
52 =item SEE ALSO
53
54 =item DIAGNOSTICS
55
56 =item BUGS
57
58 =item NOTES
59
60 =back
61
62 =head2 perlintro -- a brief introduction and overview of Perl
63
64 =over 4
65
66 =item DESCRIPTION
67
68 =over 4
69
70 =item What is Perl?
71
72 =item Running Perl programs
73
74 =item Basic syntax overview
75
76 =item Perl variable types
77
78 Scalars, Arrays, Hashes
79
80 =item Variable scoping
81
82 =item Conditional and looping constructs
83
84 if, while, for, foreach
85
86 =item Builtin operators and functions
87
88 Arithmetic, Numeric comparison, String comparison, Boolean logic,
89 Miscellaneous
90
91 =item Files and I/O
92
93 =item Regular expressions
94
95 Simple matching, Simple substitution, More complex regular expressions,
96 Parentheses for capturing, Other regexp features
97
98 =item Writing subroutines
99
100 =item OO Perl
101
102 =item Using Perl modules
103
104 =back
105
106 =item AUTHOR
107
108 =back
109
110 =head2 perlreftut - Mark's very short tutorial about references
111
112 =over 4
113
114 =item DESCRIPTION
115
116 =item Who Needs Complicated Data Structures?
117
118 =item The Solution
119
120 =item Syntax
121
122 =over 4
123
124 =item Making References
125
126 =item Using References
127
128 =item An Example
129
130 =item Arrow Rule
131
132 =back
133
134 =item Solution
135
136 =item The Rest
137
138 =item Summary
139
140 =item Credits
141
142 =over 4
143
144 =item Distribution Conditions
145
146 =back
147
148 =back
149
150 =head2 perldsc - Perl Data Structures Cookbook
151
152 =over 4
153
154 =item DESCRIPTION
155
156 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
157 more elaborate constructs
158
159 =item REFERENCES
160 X<reference> X<dereference> X<dereferencing> X<pointer>
161
162 =item COMMON MISTAKES
163
164 =item CAVEAT ON PRECEDENCE
165 X<dereference, precedence> X<dereferencing, precedence>
166
167 =item WHY YOU SHOULD ALWAYS C<use strict>
168
169 =item DEBUGGING
170 X<data structure, debugging> X<complex data structure, debugging>
171 X<AoA, debugging> X<HoA, debugging> X<AoH, debugging> X<HoH, debugging>
172 X<array of arrays, debugging> X<hash of arrays, debugging>
173 X<array of hashes, debugging> X<hash of hashes, debugging>
174
175 =item CODE EXAMPLES
176
177 =item ARRAYS OF ARRAYS
178 X<array of arrays> X<AoA>
179
180 =over 4
181
182 =item Declaration of an ARRAY OF ARRAYS
183
184 =item Generation of an ARRAY OF ARRAYS
185
186 =item Access and Printing of an ARRAY OF ARRAYS
187
188 =back
189
190 =item HASHES OF ARRAYS
191 X<hash of arrays> X<HoA>
192
193 =over 4
194
195 =item Declaration of a HASH OF ARRAYS
196
197 =item Generation of a HASH OF ARRAYS
198
199 =item Access and Printing of a HASH OF ARRAYS
200
201 =back
202
203 =item ARRAYS OF HASHES
204 X<array of hashes> X<AoH>
205
206 =over 4
207
208 =item Declaration of an ARRAY OF HASHES
209
210 =item Generation of an ARRAY OF HASHES
211
212 =item Access and Printing of an ARRAY OF HASHES
213
214 =back
215
216 =item HASHES OF HASHES
217 X<hass of hashes> X<HoH>
218
219 =over 4
220
221 =item Declaration of a HASH OF HASHES
222
223 =item Generation of a HASH OF HASHES
224
225 =item Access and Printing of a HASH OF HASHES
226
227 =back
228
229 =item MORE ELABORATE RECORDS
230 X<record> X<structure> X<struct>
231
232 =over 4
233
234 =item Declaration of MORE ELABORATE RECORDS
235
236 =item Declaration of a HASH OF COMPLEX RECORDS
237
238 =item Generation of a HASH OF COMPLEX RECORDS
239
240 =back
241
242 =item Database Ties
243
244 =item SEE ALSO
245
246 =item AUTHOR
247
248 =back
249
250 =head2 perllol - Manipulating Arrays of Arrays in Perl
251
252 =over 4
253
254 =item DESCRIPTION
255
256 =over 4
257
258 =item Declaration and Access of Arrays of Arrays
259
260 =item Growing Your Own
261
262 =item Access and Printing
263
264 =item Slices
265
266 =back
267
268 =item SEE ALSO
269
270 =item AUTHOR
271
272 =back
273
274 =head2 perlrequick - Perl regular expressions quick start
275
276 =over 4
277
278 =item DESCRIPTION
279
280 =item The Guide
281
282 =over 4
283
284 =item Simple word matching
285
286 =item Using character classes
287
288 =item Matching this or that
289
290 =item Grouping things and hierarchical matching
291
292 =item Extracting matches
293
294 =item Matching repetitions
295
296 =item More matching
297
298 =item Search and replace
299
300 =item The split operator
301
302 =back
303
304 =item BUGS
305
306 =item SEE ALSO
307
308 =item AUTHOR AND COPYRIGHT
309
310 =over 4
311
312 =item Acknowledgments
313
314 =back
315
316 =back
317
318 =head2 perlretut - Perl regular expressions tutorial
319
320 =over 4
321
322 =item DESCRIPTION
323
324 =item Part 1: The basics
325
326 =over 4
327
328 =item Simple word matching
329
330 =item Using character classes
331
332 =item Matching this or that
333
334 =item Grouping things and hierarchical matching
335
336 =item Extracting matches
337
338 =item Matching repetitions
339
340 =item Building a regexp
341
342 =item Using regular expressions in Perl
343
344 =back
345
346 =item Part 2: Power tools
347
348 =over 4
349
350 =item More on characters, strings, and character classes
351
352 =item Compiling and saving regular expressions
353
354 =item Embedding comments and modifiers in a regular expression
355
356 =item Non-capturing groupings
357
358 =item Looking ahead and looking behind
359
360 =item Using independent subexpressions to prevent backtracking
361
362 =item Conditional expressions
363
364 =item A bit of magic: executing Perl code in a regular expression
365
366 =item Pragmas and debugging
367
368 =back
369
370 =item BUGS
371
372 =item SEE ALSO
373
374 =item AUTHOR AND COPYRIGHT
375
376 =over 4
377
378 =item Acknowledgments
379
380 =back
381
382 =back
383
384 =head2 perlboot - Beginner's Object-Oriented Tutorial
385
386 =over 4
387
388 =item DESCRIPTION
389
390 =over 4
391
392 =item If we could talk to the animals...
393
394 =item Introducing the method invocation arrow
395
396 =item Invoking a barnyard
397
398 =item The extra parameter of method invocation
399
400 =item Calling a second method to simplify things
401
402 =item Inheriting the windpipes
403
404 =item A few notes about @ISA
405
406 =item Overriding the methods
407
408 =item Starting the search from a different place
409
410 =item The SUPER way of doing things
411
412 =item Where we're at so far...
413
414 =item A horse is a horse, of course of course -- or is it?
415
416 =item Invoking an instance method
417
418 =item Accessing the instance data
419
420 =item How to build a horse
421
422 =item Inheriting the constructor
423
424 =item Making a method work with either classes or instances
425
426 =item Adding parameters to a method
427
428 =item More interesting instances
429
430 =item A horse of a different color
431
432 =item Summary
433
434 =back
435
436 =item SEE ALSO
437
438 =item COPYRIGHT
439
440 =back
441
442 =head2 perltoot - Tom's object-oriented tutorial for perl
443
444 =over 4
445
446 =item DESCRIPTION
447
448 =item Creating a Class
449
450 =over 4
451
452 =item Object Representation
453
454 =item Class Interface
455
456 =item Constructors and Instance Methods
457
458 =item Planning for the Future: Better Constructors
459
460 =item Destructors
461
462 =item Other Object Methods
463
464 =back
465
466 =item Class Data
467
468 =over 4
469
470 =item Accessing Class Data
471
472 =item Debugging Methods
473
474 =item Class Destructors
475
476 =item Documenting the Interface
477
478 =back
479
480 =item Aggregation
481
482 =item Inheritance
483
484 =over 4
485
486 =item Overridden Methods
487
488 =item Multiple Inheritance
489
490 =item UNIVERSAL: The Root of All Objects
491
492 =back
493
494 =item Alternate Object Representations
495
496 =over 4
497
498 =item Arrays as Objects
499
500 =item Closures as Objects
501
502 =back
503
504 =item AUTOLOAD: Proxy Methods
505
506 =over 4
507
508 =item Autoloaded Data Methods
509
510 =item Inherited Autoloaded Data Methods
511
512 =back
513
514 =item Metaclassical Tools
515
516 =over 4
517
518 =item Class::Struct
519
520 =item Data Members as Variables
521
522 =back
523
524 =item NOTES
525
526 =over 4
527
528 =item Object Terminology
529
530 =back
531
532 =item SEE ALSO
533
534 =item AUTHOR AND COPYRIGHT
535
536 =item COPYRIGHT
537
538 =over 4
539
540 =item Acknowledgments
541
542 =back
543
544 =back
545
546 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
547
548 =over 4
549
550 =item DESCRIPTION
551
552 =item Class Data in a Can
553
554 =item Class Data as Package Variables
555
556 =over 4
557
558 =item Putting All Your Eggs in One Basket
559
560 =item Inheritance Concerns
561
562 =item The Eponymous Meta-Object
563
564 =item Indirect References to Class Data
565
566 =item Monadic Classes
567
568 =item Translucent Attributes
569
570 =back
571
572 =item Class Data as Lexical Variables
573
574 =over 4
575
576 =item Privacy and Responsibility 
577
578 =item File-Scoped Lexicals
579
580 =item More Inheritance Concerns
581
582 =item Locking the Door and Throwing Away the Key
583
584 =item Translucency Revisited
585
586 =back
587
588 =item NOTES
589
590 =item SEE ALSO
591
592 =item AUTHOR AND COPYRIGHT
593
594 =item ACKNOWLEDGEMENTS
595
596 =item HISTORY
597
598 =back
599
600 =head2 perlbot - Bag'o Object Tricks (the BOT)
601
602 =over 4
603
604 =item DESCRIPTION
605
606 =item OO SCALING TIPS
607
608 =item INSTANCE VARIABLES
609
610 =item SCALAR INSTANCE VARIABLES
611
612 =item INSTANCE VARIABLE INHERITANCE
613
614 =item OBJECT RELATIONSHIPS
615
616 =item OVERRIDING SUPERCLASS METHODS
617
618 =item USING RELATIONSHIP WITH SDBM
619
620 =item THINKING OF CODE REUSE
621
622 =item CLASS CONTEXT AND THE OBJECT
623
624 =item INHERITING A CONSTRUCTOR
625
626 =item DELEGATION
627
628 =item SEE ALSO
629
630 =back
631
632 =head2 perlstyle - Perl style guide
633
634 =over 4
635
636 =item DESCRIPTION
637
638 =back
639
640 =head2 perlcheat - Perl 5 Cheat Sheet
641
642 =over 4
643
644 =item DESCRIPTION
645
646 =over 4
647
648 =item The sheet
649
650 =back
651
652 =item ACKNOWLEDGEMENTS
653
654 =item AUTHOR
655
656 =item SEE ALSO
657
658 =back
659
660 =head2 perltrap - Perl traps for the unwary
661
662 =over 4
663
664 =item DESCRIPTION
665
666 =over 4
667
668 =item Awk Traps
669
670 =item C/C++ Traps
671
672 =item Sed Traps
673
674 =item Shell Traps
675
676 =item Perl Traps
677
678 =item Perl4 to Perl5 Traps
679
680 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
681 Traps, General data type traps, Context Traps - scalar, list contexts,
682 Precedence Traps, General Regular Expression Traps using s///, etc,
683 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
684
685 =item Discontinuance, Deprecation, and BugFix traps
686
687 Symbols starting with "_" no longer forced into main, Double-colon valid
688 package separator in variable name, 2nd and 3rd args to C<splice()> are now
689 in scalar context, Can't do C<goto> into a block that is optimized away,
690 Can't use whitespace as variable name or quote delimiter, C<while/if BLOCK
691 BLOCK> gone, C<**> binds tighter than unary minus, C<foreach> changed when
692 iterating over a list, C<split> with no args behavior changed, B<-e>
693 behavior fixed, C<push> returns number of elements in resulting list, Some
694 error messages differ, C<split()> honors subroutine args, Bugs removed
695
696 =item Parsing Traps
697
698 Space between . and = triggers syntax error, Better parsing in perl 5,
699 Function parsing, String interpolation of C<$#array> differs, Perl guesses
700 on C<map>, C<grep> followed by C<{> if it starts BLOCK or hash ref
701
702 =item Numerical Traps
703
704 Formatted output and significant digits, Auto-increment operator over
705 signed int limit deleted, Assignment of return values from numeric equality
706 tests doesn't work, Bitwise string ops
707
708 =item General data type traps
709
710 Negative array subscripts now count from the end of array, Setting
711 C<$#array> lower now discards array elements, Hashes get defined before
712 use, Glob assignment from localized variable to variable, Assigning
713 C<undef> to glob, Changes in unary negation (of strings), Modifying of
714 constants prohibited, C<defined $var> behavior changed, Variable Suicide
715
716 =item Context Traps - scalar, list contexts
717
718 Elements of argument lists for formats evaluated in list context,
719 C<caller()> returns false value in scalar context if no caller present,
720 Comma operator in scalar context gives scalar context to args, C<sprintf()>
721 prototyped as C<($;@)>
722
723 =item Precedence Traps
724
725 LHS vs. RHS of any assignment operator, Semantic errors introduced due to
726 precedence, Precedence of assignment operators same as the precedence of
727 assignment, C<open> requires parentheses around filehandle, C<$:>
728 precedence over C<$::> gone, Precedence of file test operators documented,
729 C<keys>, C<each>, C<values> are regular named unary operators
730
731 =item General Regular Expression Traps using s///, etc.
732
733 C<s'$lhs'$rhs'> interpolates on either side, C<m//g> attaches its state to
734 the searched string, C<m//o> used within an anonymous sub, C<$+> isn't set
735 to whole match, Substitution now returns null string if it fails,
736 C<s`lhs`rhs`> is now a normal substitution, Stricter parsing of variables
737 in regular expressions, C<m?x?> matches only once, Failed matches don't
738 reset the match variables
739
740 =item Subroutine, Signal, Sorting Traps
741
742 Barewords that used to look like strings look like subroutine calls,
743 Reverse is no longer allowed as the name of a sort subroutine, C<warn()>
744 won't let you specify a filehandle
745
746 =item OS Traps
747
748 SysV resets signal handler correctly, SysV C<seek()> appends correctly
749
750 =item Interpolation Traps
751
752 C<@> always interpolates an array in double-quotish strings, Double-quoted
753 strings may no longer end with an unescaped $, Arbitrary expressions are
754 evaluated inside braces within double quotes, C<$$x> now tries to
755 dereference $x, Creation of hashes on the fly with C<eval "EXPR"> requires
756 protection, Bugs in earlier perl versions, Array and hash brackets during
757 interpolation, Interpolation of C<\$$foo{bar}>, C<qq()> string passed to
758 C<eval> will not find string terminator
759
760 =item DBM Traps
761
762 Perl5 must have been linked with same dbm/ndbm as the default for
763 C<dbmopen()>, DBM exceeding limit on the key/value size will cause perl5 to
764 exit immediately
765
766 =item Unclassified Traps
767
768 C<require>/C<do> trap using returned value, C<split> on empty string with
769 LIMIT specified
770
771 =back
772
773 =back
774
775 =head2 perldebtut - Perl debugging tutorial
776
777 =over 4
778
779 =item DESCRIPTION
780
781 =item use strict
782
783 =item Looking at data and -w and v
784
785 =item help
786
787 =item Stepping through code
788
789 =item Placeholder for a, w, t, T
790
791 =item REGULAR EXPRESSIONS
792
793 =item OUTPUT TIPS
794
795 =item CGI
796
797 =item GUIs
798
799 =item SUMMARY
800
801 =item SEE ALSO
802
803 =item AUTHOR
804
805 =item CONTRIBUTORS
806
807 =back
808
809 =head2 perlfaq - frequently asked questions about Perl ($Date: 2005/12/30
810 15:04:07 $)
811
812 =over 4
813
814 =item DESCRIPTION
815
816 =over 4
817
818 =item Where to get the perlfaq
819
820 =item How to contribute to the perlfaq
821
822 =item What will happen if you mail your Perl programming problems to the
823 authors
824
825 =back
826
827 =item Credits
828
829 =item Author and Copyright Information
830
831 =over 4
832
833 =item Bundled Distributions
834
835 =item Disclaimer
836
837 =back
838
839 =item Table of Contents
840
841 perlfaq  - this document, perlfaq1 - General Questions About Perl, perlfaq2
842 - Obtaining and Learning about Perl, perlfaq3 - Programming Tools, perlfaq4
843 - Data Manipulation, perlfaq5 - Files and Formats, perlfaq6 - Regular
844 Expressions, perlfaq7 - General Perl Language Issues, perlfaq8 - System
845 Interaction, perlfaq9 - Networking
846
847 =item The Questions
848
849 =over 4
850
851 =item L<perlfaq1>: General Questions About Perl
852
853 =item L<perlfaq2>: Obtaining and Learning about Perl
854
855 =item L<perlfaq3>: Programming Tools
856
857 =item L<perlfaq4>: Data Manipulation
858
859 =item L<perlfaq5>: Files and Formats
860
861 =item L<perlfaq6>: Regular Expressions
862
863 =item L<perlfaq7>: General Perl Language Issues
864
865 =item L<perlfaq8>: System Interaction
866
867 =item L<perlfaq9>: Networking
868
869 =back
870
871 =back
872
873 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.19 $, $Date:
874 2005/12/31 00:54:37 $)
875
876 =over 4
877
878 =item DESCRIPTION
879
880 =over 4
881
882 =item What is Perl?
883
884 =item Who supports Perl?  Who develops it?  Why is it free?
885
886 =item Which version of Perl should I use?
887
888 =item What are perl4, perl5, or perl6?
889
890 =item What is Ponie?
891
892 =item What is perl6?
893
894 =item How stable is Perl?
895
896 =item Is Perl difficult to learn?
897
898 =item How does Perl compare with other languages like Java, Python, REXX,
899 Scheme, or Tcl?
900
901 =item Can I do [task] in Perl?
902
903 =item When shouldn't I program in Perl?
904
905 =item What's the difference between "perl" and "Perl"?
906
907 =item Is it a Perl program or a Perl script?
908
909 =item What is a JAPH?
910
911 =item Where can I get a list of Larry Wall witticisms?
912
913 =item How can I convince my sysadmin/supervisor/employees to use version
914 5/5.6.1/Perl instead of some other language?
915
916 =back
917
918 =item AUTHOR AND COPYRIGHT
919
920 =back
921
922 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.38 $,
923 $Date: 2005/12/31 00:54:37 $)
924
925 =over 4
926
927 =item DESCRIPTION
928
929 =over 4
930
931 =item What machines support perl?  Where do I get it?
932
933 =item How can I get a binary version of perl?
934
935 =item I don't have a C compiler. How can I build my own Perl interpreter?
936
937 =item I copied the perl binary from one machine to another, but scripts
938 don't work.
939
940 =item I grabbed the sources and tried to compile but gdbm/dynamic
941 loading/malloc/linking/... failed.  How do I make it work?
942
943 =item What modules and extensions are available for Perl?  What is CPAN? 
944 What does CPAN/src/... mean?
945
946 =item Is there an ISO or ANSI certified version of Perl?
947
948 =item Where can I get information on Perl?
949
950 =item What are the Perl newsgroups on Usenet?  Where do I post questions?
951
952 =item Where should I post source code?
953
954 =item Perl Books
955
956 References, Tutorials, Task-Oriented, Special Topics
957
958 =item Perl in Magazines
959
960 =item Perl on the Net: FTP and WWW Access
961
962 =item What mailing lists are there for Perl?
963
964 =item Archives of comp.lang.perl.misc
965
966 =item Where can I buy a commercial version of perl?
967
968 =item Where do I send bug reports?
969
970 =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
971
972 =back
973
974 =item AUTHOR AND COPYRIGHT
975
976 =back
977
978 =head2 perlfaq3 - Programming Tools ($Revision: 1.56 $, $Date: 2005/12/31
979 00:54:37 $)
980
981 =over 4
982
983 =item DESCRIPTION
984
985 =over 4
986
987 =item How do I do (anything)?
988
989 =item How can I use Perl interactively?
990
991 =item Is there a Perl shell?
992
993 =item How do I find which modules are installed on my system?
994
995 =item How do I debug my Perl programs?
996
997 =item How do I profile my Perl programs?
998
999 =item How do I cross-reference my Perl programs?
1000
1001 =item Is there a pretty-printer (formatter) for Perl?
1002
1003 =item Is there a ctags for Perl?
1004
1005 =item Is there an IDE or Windows Perl Editor?
1006
1007 Eclipse, Enginsite, Komodo, Open Perl IDE, OptiPerl, PerlBuilder,
1008 visiPerl+, Visual Perl, Zeus, GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis,
1009 Vile, Vim, Codewright, MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, Affrus,
1010 Alpha, BBEdit and BBEdit Lite
1011
1012 =item Where can I get Perl macros for vi?
1013
1014 =item Where can I get perl-mode for emacs?
1015
1016 =item How can I use curses with Perl?
1017
1018 =item How can I use X or Tk with Perl?
1019
1020 =item How can I make my Perl program run faster?
1021
1022 =item How can I make my Perl program take less memory?
1023
1024 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
1025 stringification, Pass by reference, Tie large variables to disk
1026
1027 =item Is it safe to return a reference to local or lexical data?
1028
1029 =item How can I free an array or hash so my program shrinks?
1030
1031 =item How can I make my CGI script more efficient?
1032
1033 =item How can I hide the source for my Perl program?
1034
1035 =item How can I compile my Perl program into byte code or C?
1036
1037 =item How can I compile Perl into Java?
1038
1039 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
1040
1041 =item Can I write useful Perl programs on the command line?
1042
1043 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
1044
1045 =item Where can I learn about CGI or Web programming in Perl?
1046
1047 =item Where can I learn about object-oriented Perl programming?
1048
1049 =item Where can I learn about linking C with Perl?
1050
1051 =item I've read perlembed, perlguts, etc., but I can't embed perl in my C
1052 program; what am I doing wrong?
1053
1054 =item When I tried to run my script, I got this message. What does it mean?
1055
1056 =item What's MakeMaker?
1057
1058 =back
1059
1060 =item AUTHOR AND COPYRIGHT
1061
1062 =back
1063
1064 =head2 perlfaq4 - Data Manipulation ($Revision: 1.73 $, $Date: 2005/12/31
1065 00:54:37 $)
1066
1067 =over 4
1068
1069 =item DESCRIPTION
1070
1071 =item Data: Numbers
1072
1073 =over 4
1074
1075 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
1076 numbers I should be getting (eg, 19.95)?
1077
1078 =item Why is int() broken?
1079
1080 =item Why isn't my octal data interpreted correctly?
1081
1082 =item Does Perl have a round() function?  What about ceil() and floor()? 
1083 Trig functions?
1084
1085 =item How do I convert between numeric representations/bases/radixes?
1086
1087 How do I convert hexadecimal into decimal, How do I convert from decimal to
1088 hexadecimal, How do I convert from octal to decimal, How do I convert from
1089 decimal to octal, How do I convert from binary to decimal, How do I convert
1090 from decimal to binary
1091
1092 =item Why doesn't & work the way I want it to?
1093
1094 =item How do I multiply matrices?
1095
1096 =item How do I perform an operation on a series of integers?
1097
1098 =item How can I output Roman numerals?
1099
1100 =item Why aren't my random numbers random?
1101
1102 =item How do I get a random number between X and Y?
1103
1104 =back
1105
1106 =item Data: Dates
1107
1108 =over 4
1109
1110 =item How do I find the day or week of the year?
1111
1112 =item How do I find the current century or millennium?
1113
1114 =item How can I compare two dates and find the difference?
1115
1116 =item How can I take a string and turn it into epoch seconds?
1117
1118 =item How can I find the Julian Day?
1119
1120 =item How do I find yesterday's date?
1121
1122 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
1123
1124 =back
1125
1126 =item Data: Strings
1127
1128 =over 4
1129
1130 =item How do I validate input?
1131
1132 =item How do I unescape a string?
1133
1134 =item How do I remove consecutive pairs of characters?
1135
1136 =item How do I expand function calls in a string?
1137
1138 =item How do I find matching/nesting anything?
1139
1140 =item How do I reverse a string?
1141
1142 =item How do I expand tabs in a string?
1143
1144 =item How do I reformat a paragraph?
1145
1146 =item How can I access or change N characters of a string?
1147
1148 =item How do I change the Nth occurrence of something?
1149
1150 =item How can I count the number of occurrences of a substring within a
1151 string?
1152
1153 =item How do I capitalize all the words on one line?
1154
1155 =item How can I split a [character] delimited string except when inside
1156 [character]?
1157
1158 =item How do I strip blank space from the beginning/end of a string?
1159
1160 =item How do I pad a string with blanks or pad a number with zeroes?
1161
1162 =item How do I extract selected columns from a string?
1163
1164 =item How do I find the soundex value of a string?
1165
1166 =item How can I expand variables in text strings?
1167
1168 =item What's wrong with always quoting "$vars"?
1169
1170 =item Why don't my E<lt>E<lt>HERE documents work?
1171
1172 There must be no space after the E<lt>E<lt> part, There (probably) should
1173 be a semicolon at the end, You can't (easily) have any space in front of
1174 the tag
1175
1176 =back
1177
1178 =item Data: Arrays
1179
1180 =over 4
1181
1182 =item What is the difference between a list and an array?
1183
1184 =item What is the difference between $array[1] and @array[1]?
1185
1186 =item How can I remove duplicate elements from a list or array?
1187
1188 =item How can I tell whether a certain element is contained in a list or
1189 array?
1190
1191 =item How do I compute the difference of two arrays?  How do I compute the
1192 intersection of two arrays?
1193
1194 =item How do I test whether two arrays or hashes are equal?
1195
1196 =item How do I find the first array element for which a condition is true?
1197
1198 =item How do I handle linked lists?
1199
1200 =item How do I handle circular lists?
1201
1202 =item How do I shuffle an array randomly?
1203
1204 =item How do I process/modify each element of an array?
1205
1206 =item How do I select a random element from an array?
1207
1208 =item How do I permute N elements of a list?
1209
1210 =item How do I sort an array by (anything)?
1211
1212 =item How do I manipulate arrays of bits?
1213
1214 =item Why does defined() return true on empty arrays and hashes?
1215
1216 =back
1217
1218 =item Data: Hashes (Associative Arrays)
1219
1220 =over 4
1221
1222 =item How do I process an entire hash?
1223
1224 =item What happens if I add or remove keys from a hash while iterating over
1225 it?
1226
1227 =item How do I look up a hash element by value?
1228
1229 =item How can I know how many entries are in a hash?
1230
1231 =item How do I sort a hash (optionally by value instead of key)?
1232
1233 =item How can I always keep my hash sorted?
1234
1235 =item What's the difference between "delete" and "undef" with hashes?
1236
1237 =item Why don't my tied hashes make the defined/exists distinction?
1238
1239 =item How do I reset an each() operation part-way through?
1240
1241 =item How can I get the unique keys from two hashes?
1242
1243 =item How can I store a multidimensional array in a DBM file?
1244
1245 =item How can I make my hash remember the order I put elements into it?
1246
1247 =item Why does passing a subroutine an undefined element in a hash create
1248 it?
1249
1250 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
1251 array of hashes or arrays?
1252
1253 =item How can I use a reference as a hash key?
1254
1255 =back
1256
1257 =item Data: Misc
1258
1259 =over 4
1260
1261 =item How do I handle binary data correctly?
1262
1263 =item How do I determine whether a scalar is a number/whole/integer/float?
1264
1265 =item How do I keep persistent data across program calls?
1266
1267 =item How do I print out or copy a recursive data structure?
1268
1269 =item How do I define methods for every class/object?
1270
1271 =item How do I verify a credit card checksum?
1272
1273 =item How do I pack arrays of doubles or floats for XS code?
1274
1275 =back
1276
1277 =item AUTHOR AND COPYRIGHT
1278
1279 =back
1280
1281 =head2 perlfaq5 - Files and Formats ($Revision: 1.42 $, $Date: 2005/12/31
1282 00:54:37 $)
1283
1284 =over 4
1285
1286 =item DESCRIPTION
1287
1288 =over 4
1289
1290 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
1291 X<flush> X<buffer> X<unbuffer> X<autoflush>
1292
1293 =item How do I change one line in a file/delete a line in a file/insert a
1294 line in the middle of a file/append to the beginning of a file?
1295 X<file, editing>
1296
1297 =item How do I count the number of lines in a file?
1298 X<file, counting lines> X<lines> X<line>
1299
1300 =item How can I use Perl's C<-i> option from within a program?
1301 X<-i> X<in-place>
1302
1303 =item How can I copy a file?
1304 X<copy> X<file, copy>
1305
1306 =item How do I make a temporary file name?
1307 X<file, temporary>
1308
1309 =item How can I manipulate fixed-record-length files?
1310 X<fixed-length> X<file, fixed-length records>
1311
1312 =item How can I make a filehandle local to a subroutine?  How do I pass
1313 filehandles between subroutines?  How do I make an array of filehandles?
1314 X<filehandle, local> X<filehandle, passing> X<filehandle, reference>
1315
1316 =item How can I use a filehandle indirectly?
1317 X<filehandle, indirect>
1318
1319 =item How can I set up a footer format to be used with write()?
1320 X<footer>
1321
1322 =item How can I write() into a string?
1323 X<write, into a string>
1324
1325 =item How can I output my numbers with commas added?
1326 X<number, commify>
1327
1328 =item How can I translate tildes (~) in a filename?
1329 X<tilde> X<tilde expansion>
1330
1331 =item How come when I open a file read-write it wipes it out?
1332 X<clobber> X<read-write> X<clobbering> X<truncate> X<truncating>
1333
1334 =item Why do I sometimes get an "Argument list too long" when I use
1335 E<lt>*E<gt>?
1336 X<argument list too long>
1337
1338 =item Is there a leak/bug in glob()?
1339 X<glob>
1340
1341 =item How can I open a file with a leading ">" or trailing blanks?
1342 X<filename, special characters>
1343
1344 =item How can I reliably rename a file?
1345 X<rename> X<mv> X<move> X<file, rename> X<ren>
1346
1347 =item How can I lock a file?
1348 X<lock> X<file, lock> X<flock>
1349
1350 =item Why can't I just open(FH, "E<gt>file.lock")?
1351 X<lock, lockfile race condition>
1352
1353 =item I still don't get locking.  I just want to increment the number in
1354 the file.  How can I do this?
1355 X<counter> X<file, counter>
1356
1357 =item All I want to do is append a small amount of text to the end of a
1358 file.  Do I still have to use locking?
1359 X<append> X<file, append>
1360
1361 =item How do I randomly update a binary file?
1362 X<file, binary patch>
1363
1364 =item How do I get a file's timestamp in perl?
1365 X<timestamp> X<file, timestamp>
1366
1367 =item How do I set a file's timestamp in perl?
1368 X<timestamp> X<file, timestamp>
1369
1370 =item How do I print to more than one file at once?
1371 X<print, to multiple files>
1372
1373 =item How can I read in an entire file all at once?
1374 X<slurp> X<file, slurping>
1375
1376 =item How can I read in a file by paragraphs?
1377 X<file, reading by paragraphs>
1378
1379 =item How can I read a single character from a file?  From the keyboard?
1380 X<getc> X<file, reading one character at a time>
1381
1382 =item How can I tell whether there's a character waiting on a filehandle?
1383
1384 =item How do I do a C<tail -f> in perl?
1385 X<tail>
1386
1387 =item How do I dup() a filehandle in Perl?
1388 X<dup>
1389
1390 =item How do I close a file descriptor by number?
1391 X<file, closing file descriptors>
1392
1393 =item Why can't I use "C:\temp\foo" in DOS paths?  Why doesn't
1394 `C:\temp\foo.exe` work?
1395 X<filename, DOS issues>
1396
1397 =item Why doesn't glob("*.*") get all the files?
1398 X<glob>
1399
1400 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
1401 protected files?  Isn't this a bug in Perl?
1402
1403 =item How do I select a random line from a file?
1404 X<file, selecting a random line>
1405
1406 =item Why do I get weird spaces when I print an array of lines?
1407
1408 =back
1409
1410 =item AUTHOR AND COPYRIGHT
1411
1412 =back
1413
1414 =head2 perlfaq6 - Regular Expressions ($Revision: 1.38 $, $Date: 2005/12/31
1415 00:54:37 $)
1416
1417 =over 4
1418
1419 =item DESCRIPTION
1420
1421 =over 4
1422
1423 =item How can I hope to use regular expressions without creating illegible
1424 and unmaintainable code?
1425 X<regex, legibility> X<regexp, legibility>
1426 X<regular expression, legibility> X</x>
1427
1428 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
1429
1430 =item I'm having trouble matching over more than one line.  What's wrong?
1431 X<regex, multiline> X<regexp, multiline> X<regular expression, multiline>
1432
1433 =item How can I pull out lines between two patterns that are themselves on
1434 different lines?
1435 X<..>
1436
1437 =item I put a regular expression into $/ but it didn't work. What's wrong?
1438 X<$/, regexes in> X<$INPUT_RECORD_SEPARATOR, regexes in>
1439 X<$RS, regexes in>
1440
1441 =item How do I substitute case insensitively on the LHS while preserving
1442 case on the RHS?
1443 X<replace, case preserving> X<substitute, case preserving>
1444 X<substitution, case preserving> X<s, case preserving>
1445
1446 =item How can I make C<\w> match national character sets?
1447 X<\w>
1448
1449 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
1450 X<alpha>
1451
1452 =item How can I quote a variable to use in a regex?
1453 X<regex, escaping> X<regexp, escaping> X<regular expression, escaping>
1454
1455 =item What is C</o> really for?
1456 X</o>
1457
1458 =item How do I use a regular expression to strip C style comments from a
1459 file?
1460
1461 =item Can I use Perl regular expressions to match balanced text?
1462 X<regex, matching balanced test> X<regexp, matching balanced test>
1463 X<regular expression, matching balanced test>
1464
1465 =item What does it mean that regexes are greedy?  How can I get around it?
1466 X<greedy> X<greediness>
1467
1468 =item How do I process each word on each line?
1469 X<word>
1470
1471 =item How can I print out a word-frequency or line-frequency summary?
1472
1473 =item How can I do approximate matching?
1474 X<match, approximate> X<matching, approximate>
1475
1476 =item How do I efficiently match many regular expressions at once?
1477 X<regex, efficiency> X<regexp, efficiency>
1478 X<regular expression, efficiency>
1479
1480 =item Why don't word-boundary searches with C<\b> work for me?
1481 X<\b>
1482
1483 =item Why does using $&, $`, or $' slow my program down?
1484 X<$MATCH> X<$&> X<$POSTMATCH> X<$'> X<$PREMATCH> X<$`>
1485
1486 =item What good is C<\G> in a regular expression?
1487 X<\G>
1488
1489 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
1490 X<DFA> X<NFA> X<POSIX>
1491
1492 =item What's wrong with using grep in a void context?
1493 X<grep>
1494
1495 =item How can I match strings with multibyte characters?
1496 X<regex, and multibyte characters> X<regexp, and multibyte characters>
1497 X<regular expression, and multibyte characters>
1498
1499 =item How do I match a pattern that is supplied by the user?
1500
1501 =back
1502
1503 =item AUTHOR AND COPYRIGHT
1504
1505 =back
1506
1507 =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.28 $, $Date:
1508 2005/12/31 00:54:37 $)
1509
1510 =over 4
1511
1512 =item DESCRIPTION
1513
1514 =over 4
1515
1516 =item Can I get a BNF/yacc/RE for the Perl language?
1517
1518 =item What are all these $@%&* punctuation signs, and how do I know when to
1519 use them?
1520
1521 =item Do I always/never have to quote my strings or use semicolons and
1522 commas?
1523
1524 =item How do I skip some return values?
1525
1526 =item How do I temporarily block warnings?
1527
1528 =item What's an extension?
1529
1530 =item Why do Perl operators have different precedence than C operators?
1531
1532 =item How do I declare/create a structure?
1533
1534 =item How do I create a module?
1535
1536 =item How do I create a class?
1537
1538 =item How can I tell if a variable is tainted?
1539
1540 =item What's a closure?
1541
1542 =item What is variable suicide and how can I prevent it?
1543
1544 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
1545 Regex}?
1546
1547 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
1548 Passing Methods
1549
1550 =item How do I create a static variable?
1551
1552 =item What's the difference between dynamic and lexical (static) scoping? 
1553 Between local() and my()?
1554
1555 =item How can I access a dynamic variable while a similarly named lexical
1556 is in scope?
1557
1558 =item What's the difference between deep and shallow binding?
1559
1560 =item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?
1561
1562 =item How do I redefine a builtin function, operator, or method?
1563
1564 =item What's the difference between calling a function as &foo and foo()?
1565
1566 =item How do I create a switch or case statement?
1567
1568 =item How can I catch accesses to undefined variables, functions, or
1569 methods?
1570
1571 =item Why can't a method included in this same file be found?
1572
1573 =item How can I find out my current package?
1574
1575 =item How can I comment out a large block of perl code?
1576
1577 =item How do I clear a package?
1578
1579 =item How can I use a variable as a variable name?
1580
1581 =item What does "bad interpreter" mean?
1582
1583 =back
1584
1585 =item AUTHOR AND COPYRIGHT
1586
1587 =back
1588
1589 =head2 perlfaq8 - System Interaction ($Revision: 1.27 $, $Date: 2005/12/31
1590 00:54:37 $)
1591
1592 =over 4
1593
1594 =item DESCRIPTION
1595
1596 =over 4
1597
1598 =item How do I find out which operating system I'm running under?
1599
1600 =item How come exec() doesn't return?
1601
1602 =item How do I do fancy stuff with the keyboard/screen/mouse?
1603
1604 Keyboard, Screen, Mouse
1605
1606 =item How do I print something out in color?
1607
1608 =item How do I read just one key without waiting for a return key?
1609
1610 =item How do I check whether input is ready on the keyboard?
1611
1612 =item How do I clear the screen?
1613
1614 =item How do I get the screen size?
1615
1616 =item How do I ask the user for a password?
1617
1618 =item How do I read and write the serial port?
1619
1620 lockfiles, open mode, end of line, flushing output, non-blocking input
1621
1622 =item How do I decode encrypted password files?
1623
1624 =item How do I start a process in the background?
1625
1626 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
1627
1628 =item How do I trap control characters/signals?
1629
1630 =item How do I modify the shadow password file on a Unix system?
1631
1632 =item How do I set the time and date?
1633
1634 =item How can I sleep() or alarm() for under a second?
1635
1636 =item How can I measure time under a second?
1637
1638 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
1639
1640 =item Why doesn't my sockets program work under System V (Solaris)?  What
1641 does the error message "Protocol not supported" mean?
1642
1643 =item How can I call my system's unique C functions from Perl?
1644
1645 =item Where do I get the include files to do ioctl() or syscall()?
1646
1647 =item Why do setuid perl scripts complain about kernel problems?
1648
1649 =item How can I open a pipe both to and from a command?
1650
1651 =item Why can't I get the output of a command with system()?
1652
1653 =item How can I capture STDERR from an external command?
1654
1655 =item Why doesn't open() return an error when a pipe open fails?
1656
1657 =item What's wrong with using backticks in a void context?
1658
1659 =item How can I call backticks without shell processing?
1660
1661 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
1662 ^Z on MS-DOS)?
1663
1664 =item How can I convert my shell script to perl?
1665
1666 =item Can I use perl to run a telnet or ftp session?
1667
1668 =item How can I write expect in Perl?
1669
1670 =item Is there a way to hide perl's command line from programs such as
1671 "ps"?
1672
1673 =item I {changed directory, modified my environment} in a perl script.  How
1674 come the change disappeared when I exited the script?  How do I get my
1675 changes to be visible?
1676
1677 Unix
1678
1679 =item How do I close a process's filehandle without waiting for it to
1680 complete?
1681
1682 =item How do I fork a daemon process?
1683
1684 =item How do I find out if I'm running interactively or not?
1685
1686 =item How do I timeout a slow event?
1687
1688 =item How do I set CPU limits?
1689
1690 =item How do I avoid zombies on a Unix system?
1691
1692 =item How do I use an SQL database?
1693
1694 =item How do I make a system() exit on control-C?
1695
1696 =item How do I open a file without blocking?
1697
1698 =item How do I tell the difference between errors from the shell and perl?
1699
1700 =item How do I install a module from CPAN?
1701
1702 =item What's the difference between require and use?
1703
1704 =item How do I keep my own module/library directory?
1705
1706 =item How do I add the directory my program lives in to the module/library
1707 search path?
1708
1709 =item How do I add a directory to my include path (@INC) at runtime?
1710
1711 =item What is socket.ph and where do I get it?
1712
1713 =back
1714
1715 =item AUTHOR AND COPYRIGHT
1716
1717 =back
1718
1719 =head2 perlfaq9 - Networking ($Revision: 1.28 $, $Date: 2005/12/31 00:54:37
1720 $)
1721
1722 =over 4
1723
1724 =item DESCRIPTION
1725
1726 =over 4
1727
1728 =item What is the correct form of response from a CGI script?
1729
1730 =item My CGI script runs from the command line but not the browser.  (500
1731 Server Error)
1732
1733 =item How can I get better error messages from a CGI program?
1734
1735 =item How do I remove HTML from a string?
1736
1737 =item How do I extract URLs?
1738
1739 =item How do I download a file from the user's machine?  How do I open a
1740 file on another machine?
1741
1742 =item How do I make a pop-up menu in HTML?
1743
1744 =item How do I fetch an HTML file?
1745
1746 =item How do I automate an HTML form submission?
1747
1748 =item How do I decode or create those %-encodings on the web?
1749
1750 =item How do I redirect to another page?
1751
1752 =item How do I put a password on my web pages?
1753
1754 =item How do I edit my .htpasswd and .htgroup files with Perl?
1755
1756 =item How do I make sure users can't enter values into a form that cause my
1757 CGI script to do bad things?
1758
1759 =item How do I parse a mail header?
1760
1761 =item How do I decode a CGI form?
1762
1763 =item How do I check a valid mail address?
1764
1765 =item How do I decode a MIME/BASE64 string?
1766
1767 =item How do I return the user's mail address?
1768
1769 =item How do I send mail?
1770
1771 =item How do I use MIME to make an attachment to a mail message?
1772
1773 =item How do I read mail?
1774
1775 =item How do I find out my hostname, domainname, or IP address?
1776 X<hostname, domainname, IP address, host, domain, hostfqdn, inet_ntoa,
1777 gethostbyname, Socket, Net::Domain, Sys::Hostname>
1778
1779 =item How do I fetch a news article or the active newsgroups?
1780
1781 =item How do I fetch/put an FTP file?
1782
1783 =item How can I do RPC in Perl?
1784
1785 =back
1786
1787 =item AUTHOR AND COPYRIGHT
1788
1789 =back
1790
1791 =head2 perlsyn - Perl syntax
1792
1793 =over 4
1794
1795 =item DESCRIPTION
1796
1797 =over 4
1798
1799 =item Declarations
1800 X<declaration> X<undef> X<undefined> X<uninitialized>
1801
1802 =item Comments
1803 X<comment> X<#>
1804
1805 =item Simple Statements
1806 X<statement> X<semicolon> X<expression> X<;>
1807
1808 =item Truth and Falsehood
1809 X<truth> X<falsehood> X<true> X<false> X<!> X<not> X<negation> X<0>
1810
1811 =item Statement Modifiers
1812 X<statement modifier> X<modifier> X<if> X<unless> X<while>
1813 X<until> X<foreach> X<for>
1814
1815 =item Compound Statements
1816 X<statement, compound> X<block> X<bracket, curly> X<curly bracket> X<brace>
1817 X<{> X<}> X<if> X<unless> X<while> X<until> X<foreach> X<for> X<continue>
1818
1819 =item Loop Control
1820 X<loop control> X<loop, control> X<next> X<last> X<redo> X<continue>
1821
1822 =item For Loops
1823 X<for> X<foreach>
1824
1825 =item Foreach Loops
1826 X<for> X<foreach>
1827
1828 =item Basic BLOCKs
1829 X<block>
1830
1831 =item Switch statements
1832 X<switch> X<case> X<given> X<when> X<default>
1833
1834 o, o, o, o, o, o, o
1835
1836 =item Goto
1837 X<goto>
1838
1839 =item PODs: Embedded Documentation
1840 X<POD> X<documentation>
1841
1842 =item Plain Old Comments (Not!)
1843 X<comment> X<line> X<#> X<preprocessor> X<eval>
1844
1845 =back
1846
1847 =back
1848
1849 =head2 perldata - Perl data types
1850
1851 =over 4
1852
1853 =item DESCRIPTION
1854
1855 =over 4
1856
1857 =item Variable names
1858 X<variable, name> X<variable name> X<data type> X<type>
1859
1860 =item Context
1861 X<context> X<scalar context> X<list context>
1862
1863 =item Scalar values
1864 X<scalar> X<number> X<string> X<reference>
1865
1866 =item Scalar value constructors
1867 X<scalar, literal> X<scalar, constant>
1868
1869 =item List value constructors
1870 X<list>
1871
1872 =item Subscripts
1873
1874 =item Slices
1875 X<slice> X<array, slice> X<hash, slice>
1876
1877 =item Typeglobs and Filehandles
1878 X<typeglob> X<filehandle> X<*>
1879
1880 =back
1881
1882 =item SEE ALSO
1883
1884 =back
1885
1886 =head2 perlop - Perl operators and precedence
1887
1888 =over 4
1889
1890 =item DESCRIPTION
1891
1892 =over 4
1893
1894 =item Operator Precedence and Associativity 
1895 X<operator, precedence> X<precedence> X<associativity>
1896
1897 =item Terms and List Operators (Leftward)
1898 X<list operator> X<operator, list> X<term>
1899
1900 =item The Arrow Operator
1901 X<arrow> X<dereference> X<< -> >>
1902
1903 =item Auto-increment and Auto-decrement
1904 X<increment> X<auto-increment> X<++> X<decrement> X<auto-decrement> X<-->
1905
1906 =item Exponentiation
1907 X<**> X<exponentiation> X<power>
1908
1909 =item Symbolic Unary Operators
1910 X<unary operator> X<operator, unary>
1911
1912 =item Binding Operators
1913 X<binding> X<operator, binding> X<=~> X<!~>
1914
1915 =item Multiplicative Operators
1916 X<operator, multiplicative>
1917
1918 =item Additive Operators
1919 X<operator, additive>
1920
1921 =item Shift Operators
1922 X<shift operator> X<operator, shift> X<<< << >>>
1923 X<<< >> >>> X<right shift> X<left shift> X<bitwise shift>
1924 X<shl> X<shr> X<shift, right> X<shift, left>
1925
1926 =item Named Unary Operators
1927 X<operator, named unary>
1928
1929 =item Relational Operators
1930 X<relational operator> X<operator, relational>
1931
1932 =item Equality Operators
1933 X<equality> X<equal> X<equals> X<operator, equality>
1934
1935 =item Bitwise And
1936 X<operator, bitwise, and> X<bitwise and> X<&>
1937
1938 =item Bitwise Or and Exclusive Or
1939 X<operator, bitwise, or> X<bitwise or> X<|> X<operator, bitwise, xor>
1940 X<bitwise xor> X<^>
1941
1942 =item C-style Logical And
1943 X<&&> X<logical and> X<operator, logical, and>
1944
1945 =item C-style Logical Or
1946 X<||> X<operator, logical, or>
1947
1948 =item C-style Logical Defined-Or
1949 X<//> X<operator, logical, defined-or>
1950
1951 =item Range Operators
1952 X<operator, range> X<range> X<..> X<...>
1953
1954 =item Conditional Operator
1955 X<operator, conditional> X<operator, ternary> X<ternary> X<?:>
1956
1957 =item Assignment Operators
1958 X<assignment> X<operator, assignment> X<=> X<**=> X<+=> X<*=> X<&=>
1959 X<<< <<= >>> X<&&=> X<-=> X</=> X<|=> X<<< >>= >>> X<||=> X<//=> X<.=>
1960 X<%=> X<^=> X<x=>
1961
1962 =item Comma Operator
1963 X<comma> X<operator, comma> X<,>
1964
1965 =item List Operators (Rightward)
1966 X<operator, list, rightward> X<list operator>
1967
1968 =item Logical Not
1969 X<operator, logical, not> X<not>
1970
1971 =item Logical And
1972 X<operator, logical, and> X<and>
1973
1974 =item Logical or, Defined or, and Exclusive Or
1975 X<operator, logical, or> X<operator, logical, xor> X<operator, logical,
1976 err>
1977 X<operator, logical, defined or> X<operator, logical, exclusive or>
1978 X<or> X<xor> X<err>
1979
1980 =item C Operators Missing From Perl
1981 X<operator, missing from perl> X<&> X<*>
1982 X<typecasting> X<(TYPE)>
1983
1984 unary &, unary *, (TYPE)
1985
1986 =item Quote and Quote-like Operators
1987 X<operator, quote> X<operator, quote-like> X<q> X<qq> X<qx> X<qw> X<m> 
1988 X<qr> X<s> X<tr> X<'> X<''> X<"> X<""> X<//> X<`> X<``> X<<< << >>>
1989 X<escape sequence> X<escape>
1990
1991 =item Regexp Quote-Like Operators
1992 X<operator, regexp>
1993
1994 ?PATTERN? X<?>, m/PATTERN/cgimosx X<m> X<operator, match>  X<regexp,
1995 options> X<regexp> X<regex, options> X<regex>  X</c> X</i> X</m> X</o>
1996 X</s> X</x>, /PATTERN/cgimosx, q/STRING/ X<q> X<quote, double> X<'> X<''>,
1997 C<'STRING'>, qq/STRING/ X<qq> X<quote, double> X<"> X<"">, "STRING",
1998 qr/STRING/imosx X<qr> X</i> X</m> X</o> X</s> X</x>, qx/STRING/ X<qx> X<`>
1999 X<``> X<backtick>, `STRING`, qw/STRING/ X<qw> X<quote, list> X<quote,
2000 words>, s/PATTERN/REPLACEMENT/egimosx X<substitute> X<substitution>
2001 X<replace> X<regexp, replace> X<regexp, substitute> X</e> X</g> X</i> X</m>
2002 X</o> X</s> X</x>, tr/SEARCHLIST/REPLACEMENTLIST/cds X<tr> X<y>
2003 X<transliterate> X</c> X</d> X</s>, y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF
2004 X<here-doc> X<heredoc> X<here-document> X<<< << >>>
2005
2006 =item Gory details of parsing quoted constructs
2007 X<quote, gory details>
2008
2009 Finding the end, Removal of backslashes before delimiters, Interpolation
2010 X<interpolation>, C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>,
2011 C<q//>, C<"">, C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>,
2012 C</RE/>, C<m/RE/>, C<s/RE/foo/>,, Interpolation of regular expressions
2013 X<regexp, interpolation>, Optimization of regular expressions X<regexp,
2014 optimization>
2015
2016 =item I/O Operators
2017 X<operator, i/o> X<operator, io> X<io> X<while> X<filehandle>
2018 X<< <> >> X<@ARGV>
2019
2020 =item Constant Folding
2021 X<constant folding> X<folding>
2022
2023 =item No-ops
2024 X<no-op> X<nop>
2025
2026 =item Bitwise String Operators
2027 X<operator, bitwise, string>
2028
2029 =item Integer Arithmetic
2030 X<integer>
2031
2032 =item Floating-point Arithmetic
2033 X<floating-point> X<floating point> X<float> X<real>
2034
2035 =item Bigger Numbers
2036 X<number, arbitrary precision>
2037
2038 =back
2039
2040 =back
2041
2042 =head2 perlsub - Perl subroutines
2043
2044 =over 4
2045
2046 =item SYNOPSIS
2047
2048 =item DESCRIPTION
2049
2050 =over 4
2051
2052 =item Private Variables via my()
2053 X<my> X<variable, lexical> X<lexical> X<lexical variable> X<scope, lexical>
2054 X<lexical scope> X<attributes, my>
2055
2056 =item Persistent Private Variables
2057 X<static> X<variable, persistent> X<variable, static> X<closure>
2058
2059 =item Temporary Values via local()
2060 X<local> X<scope, dynamic> X<dynamic scope> X<variable, local>
2061 X<variable, temporary>
2062
2063 =item Lvalue subroutines
2064 X<lvalue> X<subroutine, lvalue>
2065
2066 Lvalue subroutines are EXPERIMENTAL
2067
2068 =item Passing Symbol Table Entries (typeglobs)
2069 X<typeglob> X<*>
2070
2071 =item When to Still Use local()
2072 X<local> X<variable, local>
2073
2074 =item Pass by Reference
2075 X<pass by reference> X<pass-by-reference> X<reference>
2076
2077 =item Prototypes
2078 X<prototype> X<subroutine, prototype>
2079
2080 =item Constant Functions
2081 X<constant>
2082
2083 =item Overriding Built-in Functions
2084 X<built-in> X<override> X<CORE> X<CORE::GLOBAL>
2085
2086 =item Autoloading
2087 X<autoloading> X<AUTOLOAD>
2088
2089 =item Subroutine Attributes
2090 X<attribute> X<subroutine, attribute> X<attrs>
2091
2092 =back
2093
2094 =item SEE ALSO
2095
2096 =back
2097
2098 =head2 perlfunc - Perl builtin functions
2099
2100 =over 4
2101
2102 =item DESCRIPTION
2103
2104 =over 4
2105
2106 =item Perl Functions by Category
2107 X<function>
2108
2109 Functions for SCALARs or strings X<scalar> X<string> X<character>, Regular
2110 expressions and pattern matching X<regular expression> X<regex> X<regexp>,
2111 Numeric functions X<numeric> X<number> X<trigonometric> X<trigonometry>,
2112 Functions for real @ARRAYs X<array>, Functions for list data X<list>,
2113 Functions for real %HASHes X<hash>, Input and output functions X<I/O>
2114 X<input> X<output> X<dbm>, Functions for fixed length data or records,
2115 Functions for filehandles, files, or directories X<file> X<filehandle>
2116 X<directory> X<pipe> X<link> X<symlink>, Keywords related to the control
2117 flow of your Perl program X<control flow>, Keywords related to switch,
2118 Keywords related to scoping, Miscellaneous functions, Functions for
2119 processes and process groups X<process> X<pid> X<process id>, Keywords
2120 related to perl modules X<module>, Keywords related to classes and
2121 object-orientedness X<object> X<class> X<package>, Low-level socket
2122 functions X<socket> X<sock>, System V interprocess communication functions
2123 X<IPC> X<System V> X<semaphore> X<shared memory> X<memory> X<message>,
2124 Fetching user and group info X<user> X<group> X<password> X<uid> X<gid> 
2125 X<passwd> X</etc/passwd>, Fetching network info X<network> X<protocol>
2126 X<host> X<hostname> X<IP> X<address> X<service>, Time-related functions
2127 X<time> X<date>, Functions new in perl5 X<perl5>, Functions obsoleted in
2128 perl5
2129
2130 =item Portability
2131 X<portability> X<Unix> X<portable>
2132
2133 =item Alphabetical Listing of Perl Functions
2134
2135 -I<X> FILEHANDLE
2136 X<-r>X<-w>X<-x>X<-o>X<-R>X<-W>X<-X>X<-O>X<-e>X<-z>X<-s>X<-f>X<-d>X<-l>X<-p>
2137 X<-S>X<-b>X<-c>X<-t>X<-u>X<-g>X<-k>X<-T>X<-B>X<-M>X<-A>X<-C>, -I<X> EXPR,
2138 -I<X>, abs VALUE X<abs> X<absolute>, abs, accept NEWSOCKET,GENERICSOCKET
2139 X<accept>, alarm SECONDS X<alarm> X<SIGALRM> X<timer>, alarm, atan2 Y,X
2140 X<atan2> X<arctangent> X<tan> X<tangent>, bind SOCKET,NAME X<bind>, binmode
2141 FILEHANDLE, LAYER X<binmode> X<binary> X<text> X<DOS> X<Windows>, binmode
2142 FILEHANDLE, bless REF,CLASSNAME X<bless>, bless REF, break, caller EXPR
2143 X<caller> X<call stack> X<stack> X<stack trace>, caller, chdir EXPR
2144 X<chdir> X<cd>, chdir FILEHANDLE, chdir DIRHANDLE, chdir, chmod LIST
2145 X<chmod> X<permission> X<mode>, chomp VARIABLE X<chomp>
2146 X<INPUT_RECORD_SEPARATOR> X<$/> X<newline> X<eol>, chomp( LIST ), chomp,
2147 chop VARIABLE X<chop>, chop( LIST ), chop, chown LIST X<chown> X<owner>
2148 X<user> X<group>, chr NUMBER X<chr> X<character> X<ASCII> X<Unicode>, chr,
2149 chroot FILENAME X<chroot> X<root>, chroot, close FILEHANDLE X<close>,
2150 close, closedir DIRHANDLE X<closedir>, connect SOCKET,NAME X<connect>,
2151 continue BLOCK X<continue>, continue, cos EXPR X<cos> X<cosine> X<acos>
2152 X<arccosine>, cos, crypt PLAINTEXT,SALT X<crypt> X<digest> X<hash> X<salt>
2153 X<plaintext> X<password> X<decrypt> X<cryptography> X<passwd>, dbmclose
2154 HASH X<dbmclose>, dbmopen HASH,DBNAME,MASK X<dbmopen> X<dbm> X<ndbm>
2155 X<sdbm> X<gdbm>, defined EXPR X<defined> X<undef> X<undefined>, defined,
2156 delete EXPR X<delete>, die LIST X<die> X<throw> X<exception> X<raise> X<$@>
2157 X<abort>, do BLOCK X<do> X<block>, do SUBROUTINE(LIST) X<do>, do EXPR
2158 X<do>, dump LABEL X<dump> X<core> X<undump>, dump, each HASH X<each>
2159 X<hash, iterator>, eof FILEHANDLE X<eof> X<end of file> X<end-of-file>, eof
2160 (), eof, eval EXPR X<eval> X<try> X<catch> X<evaluate> X<parse> X<execute>,
2161 eval BLOCK, eval, exec LIST X<exec> X<execute>, exec PROGRAM LIST, exists
2162 EXPR X<exists> X<autovivification>, exit EXPR X<exit> X<terminate>
2163 X<abort>, exit, exp EXPR X<exp> X<exponential> X<antilog> X<antilogarithm>
2164 X<e>, exp, fcntl FILEHANDLE,FUNCTION,SCALAR X<fcntl>, fileno FILEHANDLE
2165 X<fileno>, flock FILEHANDLE,OPERATION X<flock> X<lock> X<locking>, fork
2166 X<fork> X<child> X<parent>, format X<format>, formline PICTURE,LIST
2167 X<formline>, getc FILEHANDLE X<getc> X<getchar>, getc, getlogin X<getlogin>
2168 X<login>, getpeername SOCKET X<getpeername> X<peer>, getpgrp PID X<getpgrp>
2169 X<group>, getppid X<getppid> X<parent> X<pid>, getpriority WHICH,WHO
2170 X<getpriority> X<priority> X<nice>, getpwnam NAME X<getpwnam> X<getgrnam>
2171 X<gethostbyname> X<getnetbyname> X<getprotobyname> X<getpwuid> X<getgrgid>
2172 X<getservbyname> X<gethostbyaddr> X<getnetbyaddr> X<getprotobynumber>
2173 X<getservbyport> X<getpwent> X<getgrent> X<gethostent> X<getnetent>
2174 X<getprotoent> X<getservent> X<setpwent> X<setgrent> X<sethostent>
2175 X<setnetent> X<setprotoent> X<setservent> X<endpwent> X<endgrent>
2176 X<endhostent> X<endnetent> X<endprotoent> X<endservent>, getgrnam NAME,
2177 gethostbyname NAME, getnetbyname NAME, getprotobyname NAME, getpwuid UID,
2178 getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr ADDR,ADDRTYPE,
2179 getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER, getservbyport
2180 PORT,PROTO, getpwent, getgrent, gethostent, getnetent, getprotoent,
2181 getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent STAYOPEN,
2182 setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent, endhostent,
2183 endnetent, endprotoent, endservent, getsockname SOCKET X<getsockname>,
2184 getsockopt SOCKET,LEVEL,OPTNAME X<getsockopt>, glob EXPR X<glob>
2185 X<wildcard> X<filename, expansion> X<expand>, glob, gmtime EXPR X<gmtime>
2186 X<UTC> X<Greenwich>, gmtime, goto LABEL X<goto> X<jump> X<jmp>, goto EXPR,
2187 goto &NAME, grep BLOCK LIST X<grep>, grep EXPR,LIST, hex EXPR X<hex>
2188 X<hexadecimal>, hex, import LIST X<import>, index STR,SUBSTR,POSITION
2189 X<index> X<indexOf> X<InStr>, index STR,SUBSTR, int EXPR X<int> X<integer>
2190 X<truncate> X<trunc>, int, ioctl FILEHANDLE,FUNCTION,SCALAR X<ioctl>, join
2191 EXPR,LIST X<join>, keys HASH X<keys> X<key>, kill SIGNAL, LIST X<kill>
2192 X<signal>, last LABEL X<last> X<break>, last, lc EXPR X<lc> X<lowercase>,
2193 lc, lcfirst EXPR X<lcfirst> X<lowercase>, lcfirst, length EXPR X<length>
2194 X<size>, length, link OLDFILE,NEWFILE X<link>, listen SOCKET,QUEUESIZE
2195 X<listen>, local EXPR X<local>, localtime EXPR X<localtime>, localtime,
2196 lock THING X<lock>, log EXPR X<log> X<logarithm> X<e> X<ln> X<base>, log,
2197 lstat EXPR X<lstat>, lstat, m//, map BLOCK LIST X<map>, map EXPR,LIST,
2198 mkdir FILENAME,MASK X<mkdir> X<md> X<directory, create>, mkdir FILENAME,
2199 mkdir, msgctl ID,CMD,ARG X<msgctl>, msgget KEY,FLAGS X<msgget>, msgrcv
2200 ID,VAR,SIZE,TYPE,FLAGS X<msgrcv>, msgsnd ID,MSG,FLAGS X<msgsnd>, my EXPR
2201 X<my>, my TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL
2202 X<next> X<continue>, next, no Module VERSION LIST X<no>, no Module VERSION,
2203 no Module LIST, no Module, oct EXPR X<oct> X<octal> X<hex> X<hexadecimal>
2204 X<binary> X<bin>, oct, open FILEHANDLE,EXPR X<open> X<pipe> X<file, open>
2205 X<fopen>, open FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, open
2206 FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, opendir DIRHANDLE,EXPR
2207 X<opendir>, ord EXPR X<ord> X<encoding>, ord, our EXPR X<our> X<global>,
2208 our EXPR TYPE, our EXPR : ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST
2209 X<pack>, package NAMESPACE X<package> X<module> X<namespace>, package, pipe
2210 READHANDLE,WRITEHANDLE X<pipe>, pop ARRAY X<pop> X<stack>, pop, pos SCALAR
2211 X<pos> X<match, position>, pos, print FILEHANDLE LIST X<print>, print LIST,
2212 print, printf FILEHANDLE FORMAT, LIST X<printf>, printf FORMAT, LIST,
2213 prototype FUNCTION X<prototype>, push ARRAY,LIST X<push>, X<stack>,
2214 q/STRING/, qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR
2215 X<quotemeta> X<metacharacter>, quotemeta, rand EXPR X<rand> X<random>,
2216 rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET X<read>, read
2217 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE X<readdir>, readline EXPR
2218 X<readline> X<gets> X<fgets>, readlink EXPR X<readlink>, readlink, readpipe
2219 EXPR X<readpipe>, recv SOCKET,SCALAR,LENGTH,FLAGS X<recv>, redo LABEL
2220 X<redo>, redo, ref EXPR X<ref> X<reference>, ref, rename OLDNAME,NEWNAME
2221 X<rename> X<move> X<mv> X<ren>, require VERSION X<require>, require EXPR,
2222 require, reset EXPR X<reset>, reset, return EXPR X<return>, return, reverse
2223 LIST X<reverse> X<rev> X<invert>, rewinddir DIRHANDLE X<rewinddir>, rindex
2224 STR,SUBSTR,POSITION X<rindex>, rindex STR,SUBSTR, rmdir FILENAME X<rmdir>
2225 X<rd> X<directory, remove>, rmdir, s///, say FILEHANDLE LIST X<say>, say
2226 LIST, say, scalar EXPR X<scalar> X<context>, seek
2227 FILEHANDLE,POSITION,WHENCE X<seek> X<fseek> X<filehandle, position>,
2228 seekdir DIRHANDLE,POS X<seekdir>, select FILEHANDLE X<select> X<filehandle,
2229 default>, select, select RBITS,WBITS,EBITS,TIMEOUT X<select>, semctl
2230 ID,SEMNUM,CMD,ARG X<semctl>, semget KEY,NSEMS,FLAGS X<semget>, semop
2231 KEY,OPSTRING X<semop>, send SOCKET,MSG,FLAGS,TO X<send>, send
2232 SOCKET,MSG,FLAGS, setpgrp PID,PGRP X<setpgrp> X<group>, setpriority
2233 WHICH,WHO,PRIORITY X<setpriority> X<priority> X<nice> X<renice>, setsockopt
2234 SOCKET,LEVEL,OPTNAME,OPTVAL X<setsockopt>, shift ARRAY X<shift>, shift,
2235 shmctl ID,CMD,ARG X<shmctl>, shmget KEY,SIZE,FLAGS X<shmget>, shmread
2236 ID,VAR,POS,SIZE X<shmread> X<shmwrite>, shmwrite ID,STRING,POS,SIZE,
2237 shutdown SOCKET,HOW X<shutdown>, sin EXPR X<sin> X<sine> X<asin>
2238 X<arcsine>, sin, sleep EXPR X<sleep> X<pause>, sleep, socket
2239 SOCKET,DOMAIN,TYPE,PROTOCOL X<socket>, socketpair
2240 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL X<socketpair>, sort SUBNAME LIST
2241 X<sort> X<qsort> X<quicksort> X<mergesort>, sort BLOCK LIST, sort LIST,
2242 splice ARRAY,OFFSET,LENGTH,LIST X<splice>, splice ARRAY,OFFSET,LENGTH,
2243 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT X<split>,
2244 split /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST
2245 X<sprintf>, format parameter index, flags, vector flag, (minimum) width,
2246 precision, or maximum width X<precision>, size, order of arguments, sqrt
2247 EXPR X<sqrt> X<root> X<square root>, sqrt, srand EXPR X<srand> X<seed>
2248 X<randseed>, srand, stat FILEHANDLE X<stat> X<file, status>, stat EXPR,
2249 stat, study SCALAR X<study>, study, sub NAME BLOCK X<sub>, sub NAME (PROTO)
2250 BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK, substr
2251 EXPR,OFFSET,LENGTH,REPLACEMENT X<substr> X<substring> X<mid> X<left>
2252 X<right>, substr EXPR,OFFSET,LENGTH, substr EXPR,OFFSET, symlink
2253 OLDFILE,NEWFILE X<symlink> X<link> X<symbolic link> X<link, symbolic>,
2254 syscall NUMBER, LIST X<syscall> X<system call>, sysopen
2255 FILEHANDLE,FILENAME,MODE X<sysopen>, sysopen
2256 FILEHANDLE,FILENAME,MODE,PERMS, sysread FILEHANDLE,SCALAR,LENGTH,OFFSET
2257 X<sysread>, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
2258 FILEHANDLE,POSITION,WHENCE X<sysseek> X<lseek>, system LIST X<system>
2259 X<shell>, system PROGRAM LIST, syswrite FILEHANDLE,SCALAR,LENGTH,OFFSET
2260 X<syswrite>, syswrite FILEHANDLE,SCALAR,LENGTH, syswrite FILEHANDLE,SCALAR,
2261 tell FILEHANDLE X<tell>, tell, telldir DIRHANDLE X<telldir>, tie
2262 VARIABLE,CLASSNAME,LIST X<tie>, tied VARIABLE X<tied>, time X<time>
2263 X<epoch>, times X<times>, tr///, truncate FILEHANDLE,LENGTH X<truncate>,
2264 truncate EXPR,LENGTH, uc EXPR X<uc> X<uppercase> X<toupper>, uc, ucfirst
2265 EXPR X<ucfirst> X<uppercase>, ucfirst, umask EXPR X<umask>, umask, undef
2266 EXPR X<undef> X<undefine>, undef, unlink LIST X<unlink> X<delete> X<remove>
2267 X<rm>, unlink, unpack TEMPLATE,EXPR X<unpack>, unpack TEMPLATE, untie
2268 VARIABLE X<untie>, unshift ARRAY,LIST X<unshift>, use Module VERSION LIST
2269 X<use> X<module> X<import>, use Module VERSION, use Module LIST, use
2270 Module, use VERSION, utime LIST X<utime>, values HASH X<values>, vec
2271 EXPR,OFFSET,BITS X<vec> X<bit> X<bit vector>, wait X<wait>, waitpid
2272 PID,FLAGS X<waitpid>, wantarray X<wantarray> X<context>, warn LIST X<warn>
2273 X<warning> X<STDERR>, write FILEHANDLE X<write>, write EXPR, write, y///
2274
2275 =back
2276
2277 =back
2278
2279 =head2 perlopentut - tutorial on opening things in Perl
2280
2281 =over 4
2282
2283 =item DESCRIPTION
2284
2285 =item Open E<agrave> la shell
2286
2287 =over 4
2288
2289 =item Simple Opens
2290
2291 =item Indirect Filehandles
2292
2293 =item Pipe Opens
2294
2295 =item The Minus File
2296
2297 =item Mixing Reads and Writes
2298
2299 =item Filters 
2300
2301 =back
2302
2303 =item Open E<agrave> la C
2304
2305 =over 4
2306
2307 =item Permissions E<agrave> la mode
2308
2309 =back
2310
2311 =item Obscure Open Tricks
2312
2313 =over 4
2314
2315 =item Re-Opening Files (dups)
2316
2317 =item Dispelling the Dweomer
2318
2319 =item Paths as Opens
2320
2321 =item Single Argument Open
2322
2323 =item Playing with STDIN and STDOUT
2324
2325 =back
2326
2327 =item Other I/O Issues
2328
2329 =over 4
2330
2331 =item Opening Non-File Files
2332
2333 =item Opening Named Pipes
2334
2335 =item Opening Sockets
2336
2337 =item Binary Files
2338
2339 =item File Locking
2340
2341 =item IO Layers
2342
2343 =back
2344
2345 =item SEE ALSO 
2346
2347 =item AUTHOR and COPYRIGHT
2348
2349 =item HISTORY
2350
2351 =back
2352
2353 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
2354
2355 =over 4
2356
2357 =item DESCRIPTION
2358
2359 =item The Basic Principle
2360
2361 =item Packing Text
2362
2363 =item Packing Numbers
2364
2365 =over 4
2366
2367 =item Integers
2368
2369 =item Unpacking a Stack Frame
2370
2371 =item How to Eat an Egg on a Net
2372
2373 =item Byte-order modifiers
2374
2375 =item Floating point Numbers
2376
2377 =back
2378
2379 =item Exotic Templates
2380
2381 =over 4
2382
2383 =item Bit Strings
2384
2385 =item Uuencoding
2386
2387 =item Doing Sums
2388
2389 =item  Unicode
2390
2391 =item Another Portable Binary Encoding
2392
2393 =back
2394
2395 =item Template Grouping
2396
2397 =item Lengths and Widths
2398
2399 =over 4
2400
2401 =item String Lengths
2402
2403 =item Dynamic Templates
2404
2405 =item Counting Repetitions
2406
2407 =back
2408
2409 =item Packing and Unpacking C Structures
2410
2411 =over 4
2412
2413 =item The Alignment Pit
2414
2415 =item Dealing with Endian-ness
2416
2417 =item Alignment, Take 2
2418
2419 =item Alignment, Take 3
2420
2421 =item Pointers for How to Use Them
2422
2423 =back
2424
2425 =item Pack Recipes
2426
2427 =item Funnies Section
2428
2429 =item Authors
2430
2431 =back
2432
2433 =head2 perlpod - the Plain Old Documentation format
2434
2435 =over 4
2436
2437 =item DESCRIPTION
2438
2439 =over 4
2440
2441 =item Ordinary Paragraph
2442 X<POD, ordinary paragraph>
2443
2444 =item Verbatim Paragraph
2445 X<POD, verbatim paragraph> X<verbatim>
2446
2447 =item Command Paragraph
2448 X<POD, command>
2449
2450 C<=head1 I<Heading Text>> X<=head1> X<=head2> X<=head3> X<=head4> X<head1>
2451 X<head2> X<head3> X<head4>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
2452 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>> X<=over>
2453 X<=item> X<=back> X<over> X<item> X<back>, C<=item I<stuff...>>, C<=back>,
2454 C<=cut> X<=cut> X<cut>, C<=pod> X<=pod> X<pod>, C<=begin I<formatname>>
2455 X<=begin> X<=end> X<=for> X<begin> X<end> X<for>, C<=end I<formatname>>,
2456 C<=for I<formatname> I<text...>>, C<=encoding I<encodingname>> X<=encoding>
2457 X<encoding>
2458
2459 =item Formatting Codes
2460 X<POD, formatting code> X<formatting code>
2461 X<POD, interior sequence> X<interior sequence>
2462
2463 C<IE<lt>textE<gt>> -- italic text X<I> X<< IZ<><> >> X<POD, formatting
2464 code, italic> X<italic>, C<BE<lt>textE<gt>> -- bold text X<B> X<< BZ<><> >>
2465 X<POD, formatting code, bold> X<bold>, C<CE<lt>codeE<gt>> -- code text X<C>
2466 X<< CZ<><> >> X<POD, formatting code, code> X<code>, C<LE<lt>nameE<gt>> --
2467 a hyperlink X<L> X<< LZ<><> >> X<POD, formatting code, hyperlink>
2468 X<hyperlink>, C<EE<lt>escapeE<gt>> -- a character escape X<E> X<< EZ<><> >>
2469 X<POD, formatting code, escape> X<escape>, C<FE<lt>filenameE<gt>> -- used
2470 for filenames X<F> X<< FZ<><> >> X<POD, formatting code, filename>
2471 X<filename>, C<SE<lt>textE<gt>> -- text contains non-breaking spaces X<S>
2472 X<< SZ<><> >> X<POD, formatting code, non-breaking space>  X<non-breaking
2473 space>, C<XE<lt>topic nameE<gt>> -- an index entry X<X> X<< XZ<><> >>
2474 X<POD, formatting code, index entry> X<index entry>, C<ZE<lt>E<gt>> -- a
2475 null (zero-effect) formatting code X<Z> X<< ZZ<><> >> X<POD, formatting
2476 code, null> X<null>
2477
2478 =item The Intent
2479 X<POD, intent of>
2480
2481 =item Embedding Pods in Perl Modules
2482 X<POD, embedding>
2483
2484 =item Hints for Writing Pod
2485
2486 X<podchecker> X<POD, validating>
2487
2488 =back
2489
2490 =item SEE ALSO
2491
2492 =item AUTHOR
2493
2494 =back
2495
2496 =head2 perlpodspec - Plain Old Documentation: format specification and
2497 notes
2498
2499 =over 4
2500
2501 =item DESCRIPTION
2502
2503 =item Pod Definitions
2504
2505 =item Pod Commands
2506
2507 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
2508 "=back", "=begin formatname", "=end formatname", "=for formatname text...",
2509 "=encoding encodingname"
2510
2511 =item Pod Formatting Codes
2512
2513 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2514 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
2515 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
2516 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
2517 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
2518 contains non-breaking spaces
2519
2520 =item Notes on Implementing Pod Processors
2521
2522 =item About LE<lt>...E<gt> Codes
2523
2524 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
2525
2526 =item About =over...=back Regions
2527
2528 =item About Data Paragraphs and "=begin/=end" Regions
2529
2530 =item SEE ALSO
2531
2532 =item AUTHOR
2533
2534 =back
2535
2536 =head2 perlrun - how to execute the Perl interpreter
2537
2538 =over 4
2539
2540 =item SYNOPSIS
2541
2542 =item DESCRIPTION
2543
2544 =over 4
2545
2546 =item #! and quoting on non-Unix systems
2547 X<hashbang> X<#!>
2548
2549 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
2550
2551 =item Location of Perl
2552 X<perl, location of interpreter>
2553
2554 =item Command Switches
2555 X<perl, command switches> X<command switches>
2556
2557 B<-0>[I<octal/hexadecimal>] X<-0> X<$/>, B<-A[I<module>][=I<assertions>]>
2558 X<-A>, B<-a> X<-a> X<autosplit>, B<-C [I<number/list>]> X<-C>, B<-c> X<-c>,
2559 B<-d> X<-d> X<-dt>, B<-dt>, B<-d:>I<foo[=bar,baz]> X<-d> X<-dt>,
2560 B<-dt:>I<foo[=bar,baz]>, B<-D>I<letters> X<-D> X<DEBUGGING> X<-DDEBUGGING>,
2561 B<-D>I<number>, B<-e> I<commandline> X<-e>, B<-E> I<commandline> X<-E>,
2562 B<-f> X<-f>, B<-F>I<pattern> X<-F>, B<-h> X<-h>, B<-i>[I<extension>] X<-i>
2563 X<in-place>, B<-I>I<directory> X<-I> X<@INC>, B<-l>[I<octnum>] X<-l> X<$/>
2564 X<$\>, B<-m>[B<->]I<module> X<-m> X<-M>, B<-M>[B<->]I<module>,
2565 B<-M>[B<->]I<'module ...'>, B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>
2566 X<-n>, B<-p> X<-p>, B<-P> X<-P>, B<-s> X<-s>, B<-S> X<-S>, B<-t> X<-t>,
2567 B<-T> X<-T>, B<-u> X<-u>, B<-U> X<-U>, B<-v> X<-v>, B<-V> X<-V>,
2568 B<-V:>I<configvar>, B<-w> X<-w>, B<-W> X<-W>, B<-X> X<-X>, B<-x> X<-x>,
2569 B<-x> I<directory>
2570
2571 =back
2572
2573 =item ENVIRONMENT
2574 X<perl, environment variables>
2575
2576 HOME X<HOME>, LOGDIR X<LOGDIR>, PATH X<PATH>, PERL5LIB X<PERL5LIB>,
2577 PERL5OPT X<PERL5OPT>, PERLIO X<PERLIO>, :bytes X<:bytes>, :crlf X<:crlf>,
2578 :mmap X<:mmap>, :perlio X<:perlio>, :pop X<:pop>, :raw X<:raw>, :stdio
2579 X<:stdio>, :unix X<:unix>, :utf8 X<:utf8>, :win32 X<:win32>, PERLIO_DEBUG
2580 X<PERLIO_DEBUG>, PERLLIB X<PERLLIB>, PERL5DB X<PERL5DB>, PERL5DB_THREADED
2581 X<PERL5DB_THREADED>, PERL5SHELL (specific to the Win32 port) X<PERL5SHELL>,
2582 PERL_ALLOW_NON_IFS_LSP (specific to the Win32 port)
2583 X<PERL_ALLOW_NON_IFS_LSP>, PERL_DEBUG_MSTATS X<PERL_DEBUG_MSTATS>,
2584 PERL_DESTRUCT_LEVEL X<PERL_DESTRUCT_LEVEL>, PERL_DL_NONLAZY
2585 X<PERL_DL_NONLAZY>, PERL_ENCODING X<PERL_ENCODING>, PERL_HASH_SEED
2586 X<PERL_HASH_SEED>, PERL_HASH_SEED_DEBUG X<PERL_HASH_SEED_DEBUG>, PERL_ROOT
2587 (specific to the VMS port) X<PERL_ROOT>, PERL_SIGNALS X<PERL_SIGNALS>,
2588 PERL_UNICODE X<PERL_UNICODE>, SYS$LOGIN (specific to the VMS port)
2589 X<SYS$LOGIN>
2590
2591 =back
2592
2593 =head2 perldiag - various Perl diagnostics
2594
2595 =over 4
2596
2597 =item DESCRIPTION
2598
2599 =back
2600
2601 =head2 perllexwarn - Perl Lexical Warnings
2602
2603 =over 4
2604
2605 =item DESCRIPTION
2606
2607 =over 4
2608
2609 =item Default Warnings and Optional Warnings
2610
2611 =item What's wrong with B<-w> and C<$^W>
2612
2613 =item Controlling Warnings from the Command Line
2614
2615 B<-w> X<-w>, B<-W> X<-W>, B<-X> X<-X>
2616
2617 =item Backward Compatibility
2618
2619 =item Category Hierarchy
2620 X<warning, categories>
2621
2622 =item Fatal Warnings
2623 X<warning, fatal>
2624
2625 =item Reporting Warnings from a Module
2626 X<warning, reporting> X<warning, registering>
2627
2628 =back
2629
2630 =item TODO
2631
2632 =item SEE ALSO
2633
2634 =item AUTHOR
2635
2636 =back
2637
2638 =head2 perldebug - Perl debugging
2639
2640 =over 4
2641
2642 =item DESCRIPTION
2643
2644 =item The Perl Debugger
2645
2646 =over 4
2647
2648 =item Debugger Commands
2649
2650 h X<debugger command, h>, h [command], h h, p expr X<debugger command, p>,
2651 x [maxdepth] expr X<debugger command, x>, V [pkg [vars]] X<debugger
2652 command, V>, X [vars] X<debugger command, X>, y [level [vars]] X<debugger
2653 command, y>, T X<debugger command, T> X<backtrace> X<stack, backtrace>, s
2654 [expr] X<debugger command, s> X<step>, n [expr] X<debugger command, n>, r
2655 X<debugger command, r>, <CR>, c [line|sub] X<debugger command, c>, l
2656 X<debugger command, l>, l min+incr, l min-max, l line, l subname, -
2657 X<debugger command, ->, v [line] X<debugger command, v>, . X<debugger
2658 command, .>, f filename X<debugger command, f>, /pattern/, ?pattern?, L
2659 [abw] X<debugger command, L>, S [[!]regex] X<debugger command, S>, t
2660 X<debugger command, t>, t expr X<debugger command, t>, b X<breakpoint>
2661 X<debugger command, b>, b [line] [condition] X<breakpoint> X<debugger
2662 command, b>, b subname [condition] X<breakpoint> X<debugger command, b>, b
2663 postpone subname [condition] X<breakpoint> X<debugger command, b>, b load
2664 filename X<breakpoint> X<debugger command, b>, b compile subname
2665 X<breakpoint> X<debugger command, b>, B line X<breakpoint> X<debugger
2666 command, B>, B * X<breakpoint> X<debugger command, B>, a [line] command
2667 X<debugger command, a>, A line X<debugger command, A>, A * X<debugger
2668 command, A>, w expr X<debugger command, w>, W expr X<debugger command, W>,
2669 W * X<debugger command, W>, o X<debugger command, o>, o booloption ...
2670 X<debugger command, o>, o anyoption? ... X<debugger command, o>, o
2671 option=value ... X<debugger command, o>, < ? X<< debugger command, < >>, <
2672 [ command ] X<< debugger command, < >>, < * X<< debugger command, < >>, <<
2673 command X<< debugger command, << >>, > ? X<< debugger command, > >>, >
2674 command X<< debugger command, > >>, > * X<< debugger command, > >>, >>
2675 command X<<< debugger command, >> >>>, { ? X<debugger command, {>, { [
2676 command ], { * X<debugger command, {>, {{ command X<debugger command, {{>,
2677 ! number X<debugger command, !>, ! -number X<debugger command, !>, !
2678 pattern X<debugger command, !>, !! cmd X<debugger command, !!>, source file
2679 X<debugger command, source>, H -number X<debugger command, H>, q or ^D
2680 X<debugger command, q> X<debugger command, ^D>, R X<debugger command, R>,
2681 |dbcmd X<debugger command, |>, ||dbcmd X<debugger command, ||>, command, m
2682 expr X<debugger command, m>, M X<debugger command, M>, man [manpage]
2683 X<debugger command, man>
2684
2685 =item Configurable Options
2686
2687 C<recallCommand>, C<ShellBang> X<debugger option, recallCommand> X<debugger
2688 option, ShellBang>, C<pager> X<debugger option, pager>, C<tkRunning>
2689 X<debugger option, tkRunning>, C<signalLevel>, C<warnLevel>, C<dieLevel>
2690 X<debugger option, signalLevel> X<debugger option, warnLevel> X<debugger
2691 option, dieLevel>, C<AutoTrace> X<debugger option, AutoTrace>, C<LineInfo>
2692 X<debugger option, LineInfo>, C<inhibit_exit> X<debugger option,
2693 inhibit_exit>, C<PrintRet> X<debugger option, PrintRet>, C<ornaments>
2694 X<debugger option, ornaments>, C<frame> X<debugger option, frame>,
2695 C<maxTraceLen> X<debugger option, maxTraceLen>, C<windowSize> X<debugger
2696 option, windowSize>, C<arrayDepth>, C<hashDepth> X<debugger option,
2697 arrayDepth> X<debugger option, hashDepth>, C<dumpDepth> X<debugger option,
2698 dumpDepth>, C<compactDump>, C<veryCompact> X<debugger option, compactDump>
2699 X<debugger option, veryCompact>, C<globPrint> X<debugger option,
2700 globPrint>, C<DumpDBFiles> X<debugger option, DumpDBFiles>, C<DumpPackages>
2701 X<debugger option, DumpPackages>, C<DumpReused> X<debugger option,
2702 DumpReused>, C<quote>, C<HighBit>, C<undefPrint> X<debugger option, quote>
2703 X<debugger option, HighBit> X<debugger option, undefPrint>, C<UsageOnly>
2704 X<debugger option, UsageOnly>, C<TTY> X<debugger option, TTY>, C<noTTY>
2705 X<debugger option, noTTY>, C<ReadLine> X<debugger option, ReadLine>,
2706 C<NonStop> X<debugger option, NonStop>
2707
2708 =item Debugger input/output
2709
2710 Prompt, Multiline commands, Stack backtrace X<backtrace> X<stack,
2711 backtrace>, Line Listing Format, Frame listing
2712
2713 =item Debugging compile-time statements
2714
2715 =item Debugger Customization
2716
2717 =item Readline Support
2718
2719 =item Editor Support for Debugging
2720
2721 =item The Perl Profiler
2722 X<profile> X<profiling> X<profiler>
2723
2724 =back
2725
2726 =item Debugging regular expressions
2727 X<regular expression, debugging>
2728 X<regex, debugging> X<regexp, debugging>
2729
2730 =item Debugging memory usage
2731 X<memory usage>
2732
2733 =item SEE ALSO
2734
2735 =item BUGS
2736
2737 =back
2738
2739 =head2 perlvar - Perl predefined variables
2740
2741 =over 4
2742
2743 =item DESCRIPTION
2744
2745 =over 4
2746
2747 =item Predefined Names
2748
2749 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
2750 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+,
2751 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
2752 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
2753 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
2754 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
2755 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
2756 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;,
2757 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
2758 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
2759 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
2760 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
2761 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
2762 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
2763 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
2764 C<substr($var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
2765 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
2766 IO::Handle->format_line_break_characters EXPR,
2767 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
2768 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?,
2769 ${^CHILD_ERROR_NATIVE}, ${^ENCODING}, $OS_ERROR, $ERRNO, $!, %!,
2770 $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@, $PROCESS_ID, $PID, $$,
2771 $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID, $>, $REAL_GROUP_ID,
2772 $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $), $PROGRAM_NAME, $0, $[, $],
2773 $COMPILING, $^C, $DEBUGGING, $^D, ${^RE_DEBUG_FLAGS}, ${^RE_TRIE_MAXBUF},
2774 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
2775 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
2776 0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R,
2777 $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, ${^UNICODE},
2778 ${^UTF8LOCALE}, $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS},
2779 $EXECUTABLE_NAME, $^X, ARGV, $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC,
2780 %ENV, $ENV{expr}, %SIG, $SIG{expr}
2781
2782 =item Error Indicators
2783
2784 =item Technical Note on the Syntax of Variable Names
2785
2786 =back
2787
2788 =item BUGS
2789
2790 =back
2791
2792 =head2 perlre - Perl regular expressions
2793
2794 =over 4
2795
2796 =item DESCRIPTION
2797
2798 i X</i> X<regex, case-insensitive> X<regexp, case-insensitive> X<regular
2799 expression, case-insensitive>, m X</m> X<regex, multiline> X<regexp,
2800 multiline> X<regular expression, multiline>, s X</s> X<regex, single-line>
2801 X<regexp, single-line> X<regular expression, single-line>, x X</x>
2802
2803 =over 4
2804
2805 =item Regular Expressions
2806
2807 [1], [2], [3], cntrl X<cntrl>, graph X<graph>, print X<print>, punct
2808 X<punct>, xdigit X<xdigit>
2809
2810 =item Extended Patterns
2811
2812 C<(?#text)> X<(?#)>, C<(?imsx-imsx)> X<(?)>, C<(?:pattern)> X<(?:)>,
2813 C<(?imsx-imsx:pattern)>, C<(?=pattern)> X<(?=)> X<look-ahead, positive>
2814 X<lookahead, positive>, C<(?!pattern)> X<(?!)> X<look-ahead, negative>
2815 X<lookahead, negative>, C<(?<=pattern)> X<(?<=)> X<look-behind, positive>
2816 X<lookbehind, positive>, C<(?<!pattern)> X<(?<!)> X<look-behind, negative>
2817 X<lookbehind, negative>, C<(?{ code })> X<(?{})> X<regex, code in>
2818 X<regexp, code in> X<regular expression, code in>, C<(??{ code })>
2819 X<(??{})> X<regex, postponed> X<regexp, postponed> X<regular expression,
2820 postponed> X<regex, recursive> X<regexp, recursive> X<regular expression,
2821 recursive>, C<< (?>pattern) >> X<backtrack> X<backtracking>,
2822 C<(?(condition)yes-pattern|no-pattern)> X<(?()>,
2823 C<(?(condition)yes-pattern)>
2824
2825 =item Backtracking
2826 X<backtrack> X<backtracking>
2827
2828 =item Version 8 Regular Expressions
2829 X<regular expression, version 8> X<regex, version 8> X<regexp, version 8>
2830
2831 =item Warning on \1 vs $1
2832
2833 =item Repeated patterns matching zero-length substring
2834
2835 =item Combining pieces together
2836
2837 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
2838 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
2839 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
2840 C<(?(condition)yes-pattern|no-pattern)>
2841
2842 =item Creating custom RE engines
2843
2844 =back
2845
2846 =item BUGS
2847
2848 =item SEE ALSO
2849
2850 =back
2851
2852 =head2 perlreref - Perl Regular Expressions Reference
2853
2854 =over 4
2855
2856 =item DESCRIPTION
2857
2858 =over 4
2859
2860 =item OPERATORS
2861
2862 =item SYNTAX
2863
2864 =item ESCAPE SEQUENCES
2865
2866 =item CHARACTER CLASSES
2867
2868 =item ANCHORS
2869
2870 =item QUANTIFIERS
2871
2872 =item EXTENDED CONSTRUCTS
2873
2874 =item VARIABLES
2875
2876 =item FUNCTIONS
2877
2878 =item TERMINOLOGY
2879
2880 =back
2881
2882 =item AUTHOR
2883
2884 =item SEE ALSO
2885
2886 =item THANKS
2887
2888 =back
2889
2890 =head2 perlref - Perl references and nested data structures
2891
2892 =over 4
2893
2894 =item NOTE
2895
2896 =item DESCRIPTION
2897
2898 =over 4
2899
2900 =item Making References
2901 X<reference, creation> X<referencing>
2902
2903 1. X<\> X<backslash>, 2. X<array, anonymous> X<[> X<[]> X<square bracket>
2904 X<bracket, square> X<arrayref> X<array reference> X<reference, array>, 3.
2905 X<hash, anonymous> X<{> X<{}> X<curly bracket> X<bracket, curly> X<brace>
2906 X<hashref> X<hash reference> X<reference, hash>, 4. X<subroutine,
2907 anonymous> X<subroutine, reference> X<reference, subroutine> X<scope,
2908 lexical> X<closure> X<lexical> X<lexical scope>, 5. X<constructor> X<new>,
2909 6. X<autovivification>, 7. X<*foo{THING}> X<*>
2910
2911 =item Using References
2912 X<reference, use> X<dereferencing> X<dereference>
2913
2914 2. X<${}> X<@{}> X<%{}>, 3. X<autovivification> X<< -> >> X<arrow>, 4.
2915 X<encapsulation>
2916
2917 =item Symbolic references
2918 X<reference, symbolic> X<reference, soft>
2919 X<symbolic reference> X<soft reference>
2920
2921 =item Not-so-symbolic references
2922
2923 =item Pseudo-hashes: Using an array as a hash
2924 X<pseudo-hash> X<pseudo hash> X<pseudohash>
2925
2926 =item Function Templates
2927 X<scope, lexical> X<closure> X<lexical> X<lexical scope>
2928 X<subroutine, nested> X<sub, nested> X<subroutine, local> X<sub, local>
2929
2930 =back
2931
2932 =item WARNING
2933 X<reference, string context> X<reference, use as hash key>
2934
2935 =item SEE ALSO
2936
2937 =back
2938
2939 =head2 perlform - Perl formats
2940
2941 =over 4
2942
2943 =item DESCRIPTION
2944
2945 =over 4
2946
2947 =item Text Fields
2948 X<format, text field>
2949
2950 =item Numeric Fields
2951 X<#> X<format, numeric field>
2952
2953 =item The Field @* for Variable Width Multi-Line Text
2954 X<@*>
2955
2956 =item The Field ^* for Variable Width One-line-at-a-time Text
2957 X<^*>
2958
2959 =item Specifying Values
2960 X<format, specifying values>
2961
2962 =item Using Fill Mode
2963 X<format, fill mode>
2964
2965 =item Suppressing Lines Where All Fields Are Void
2966 X<format, suppressing lines>
2967
2968 =item Repeating Format Lines
2969 X<format, repeating lines>
2970
2971 =item Top of Form Processing
2972 X<format, top of form> X<top> X<header>
2973
2974 =item Format Variables
2975 X<format variables>
2976 X<format, variables>
2977
2978 =back
2979
2980 =item NOTES
2981
2982 =over 4
2983
2984 =item Footers
2985 X<format, footer> X<footer>
2986
2987 =item Accessing Formatting Internals
2988 X<format, internals>
2989
2990 =back
2991
2992 =item WARNINGS
2993
2994 =back
2995
2996 =head2 perlobj - Perl objects
2997
2998 =over 4
2999
3000 =item DESCRIPTION
3001
3002 =over 4
3003
3004 =item An Object is Simply a Reference
3005 X<object> X<bless> X<constructor> X<new>
3006
3007 =item A Class is Simply a Package
3008 X<class> X<package> X<@ISA> X<inheritance>
3009
3010 =item A Method is Simply a Subroutine
3011 X<method>
3012
3013 =item Method Invocation
3014 X<invocation> X<method> X<arrow> X<< -> >>
3015
3016 =item Indirect Object Syntax
3017 X<indirect object syntax> X<invocation, indirect> X<indirect>
3018
3019 =item Default UNIVERSAL methods
3020 X<UNIVERSAL>
3021
3022 isa(CLASS) X<isa>, can(METHOD) X<can>, VERSION( [NEED] ) X<VERSION>
3023
3024 =item Destructors
3025 X<destructor> X<DESTROY>
3026
3027 =item Summary
3028
3029 =item Two-Phased Garbage Collection
3030 X<garbage collection> X<GC> X<circular reference>
3031 X<reference, circular> X<DESTROY> X<destructor>
3032
3033 =back
3034
3035 =item SEE ALSO
3036
3037 =back
3038
3039 =head2 perltie - how to hide an object class in a simple variable
3040
3041 =over 4
3042
3043 =item SYNOPSIS
3044
3045 =item DESCRIPTION
3046
3047 =over 4
3048
3049 =item Tying Scalars
3050 X<scalar, tying>
3051
3052 TIESCALAR classname, LIST X<TIESCALAR>, FETCH this X<FETCH>, STORE this,
3053 value X<STORE>, UNTIE this X<UNTIE>, DESTROY this X<DESTROY>
3054
3055 =item Tying Arrays
3056 X<array, tying>
3057
3058 TIEARRAY classname, LIST X<TIEARRAY>, FETCH this, index X<FETCH>, STORE
3059 this, index, value X<STORE>, FETCHSIZE this X<FETCHSIZE>, STORESIZE this,
3060 count X<STORESIZE>, EXTEND this, count X<EXTEND>, EXISTS this, key
3061 X<EXISTS>, DELETE this, key X<DELETE>, CLEAR this X<CLEAR>, PUSH this, LIST
3062  X<PUSH>, POP this X<POP>, SHIFT this X<SHIFT>, UNSHIFT this, LIST 
3063 X<UNSHIFT>, SPLICE this, offset, length, LIST X<SPLICE>, UNTIE this
3064 X<UNTIE>, DESTROY this X<DESTROY>
3065
3066 =item Tying Hashes
3067 X<hash, tying>
3068
3069 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST X<TIEHASH>, FETCH this,
3070 key X<FETCH>, STORE this, key, value X<STORE>, DELETE this, key X<DELETE>,
3071 CLEAR this X<CLEAR>, EXISTS this, key X<EXISTS>, FIRSTKEY this X<FIRSTKEY>,
3072 NEXTKEY this, lastkey X<NEXTKEY>, SCALAR this X<SCALAR>, UNTIE this
3073 X<UNTIE>, DESTROY this X<DESTROY>
3074
3075 =item Tying FileHandles
3076 X<filehandle, tying>
3077
3078 TIEHANDLE classname, LIST X<TIEHANDLE>, WRITE this, LIST X<WRITE>, PRINT
3079 this, LIST X<PRINT>, PRINTF this, LIST X<PRINTF>, READ this, LIST X<READ>,
3080 READLINE this X<READLINE>, GETC this X<GETC>, CLOSE this X<CLOSE>, UNTIE
3081 this X<UNTIE>, DESTROY this X<DESTROY>
3082
3083 =item UNTIE this
3084 X<UNTIE>
3085
3086 =item The C<untie> Gotcha
3087 X<untie>
3088
3089 =back
3090
3091 =item SEE ALSO
3092
3093 =item BUGS
3094
3095 =item AUTHOR
3096
3097 =back
3098
3099 =head2 perldbmfilter - Perl DBM Filters
3100
3101 =over 4
3102
3103 =item SYNOPSIS
3104
3105 =item DESCRIPTION
3106
3107 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
3108 B<filter_fetch_value>
3109
3110 =over 4
3111
3112 =item The Filter
3113
3114 =item An Example -- the NULL termination problem.
3115
3116 =item Another Example -- Key is a C int.
3117
3118 =back
3119
3120 =item SEE ALSO
3121
3122 =item AUTHOR
3123
3124 =back
3125
3126 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
3127 safe subprocesses, sockets, and semaphores)
3128
3129 =over 4
3130
3131 =item DESCRIPTION
3132
3133 =item Signals
3134
3135 =over 4
3136
3137 =item Handling the SIGHUP Signal in Daemons
3138
3139 =back
3140
3141 =item Named Pipes
3142
3143 =over 4
3144
3145 =item Deferred Signals (Safe Signals)
3146
3147 Long running opcodes, Interrupting IO, Restartable system calls, Signals as
3148 "faults", Signals triggered by operating system state
3149
3150 =back
3151
3152 =item Using open() for IPC
3153
3154 =over 4
3155
3156 =item Filehandles
3157
3158 =item Background Processes
3159
3160 =item Complete Dissociation of Child from Parent
3161
3162 =item Safe Pipe Opens
3163
3164 =item Bidirectional Communication with Another Process
3165
3166 =item Bidirectional Communication with Yourself
3167
3168 =back
3169
3170 =item Sockets: Client/Server Communication
3171
3172 =over 4
3173
3174 =item Internet Line Terminators
3175
3176 =item Internet TCP Clients and Servers
3177
3178 =item Unix-Domain TCP Clients and Servers
3179
3180 =back
3181
3182 =item TCP Clients with IO::Socket
3183
3184 =over 4
3185
3186 =item A Simple Client
3187
3188 C<Proto>, C<PeerAddr>, C<PeerPort>
3189
3190 =item A Webget Client
3191
3192 =item Interactive Client with IO::Socket
3193
3194 =back
3195
3196 =item TCP Servers with IO::Socket
3197
3198 Proto, LocalPort, Listen, Reuse
3199
3200 =item UDP: Message Passing
3201
3202 =item SysV IPC
3203
3204 =item NOTES
3205
3206 =item BUGS
3207
3208 =item AUTHOR
3209
3210 =item SEE ALSO
3211
3212 =back
3213
3214 =head2 perlfork - Perl's fork() emulation
3215
3216 =over 4
3217
3218 =item SYNOPSIS
3219
3220 =item DESCRIPTION
3221
3222 =over 4
3223
3224 =item Behavior of other Perl features in forked pseudo-processes
3225
3226 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
3227 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
3228 files, directories and network sockets
3229
3230 =item Resource limits
3231
3232 =item Killing the parent process
3233
3234 =item Lifetime of the parent process and pseudo-processes
3235
3236 =item CAVEATS AND LIMITATIONS
3237
3238 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
3239 Global state maintained by XSUBs, Interpreter embedded in larger
3240 application, Thread-safety of extensions
3241
3242 =back
3243
3244 =item BUGS
3245
3246 =item AUTHOR
3247
3248 =item SEE ALSO
3249
3250 =back
3251
3252 =head2 perlnumber - semantics of numbers and numeric operations in Perl
3253
3254 =over 4
3255
3256 =item SYNOPSIS
3257
3258 =item DESCRIPTION
3259
3260 =item Storing numbers
3261
3262 =item Numeric operators and numeric conversions
3263
3264 =item Flavors of Perl numeric operations
3265
3266 Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other
3267 mathematical operators, Bitwise operators, Bitwise operators during C<use
3268 integer>, Operators which expect an integer, Operators which expect a
3269 string
3270
3271 =item AUTHOR
3272
3273 =item SEE ALSO
3274
3275 =back
3276
3277 =head2 perlthrtut - tutorial on threads in Perl
3278
3279 =over 4
3280
3281 =item DESCRIPTION
3282
3283 =item Status
3284
3285 =item What Is A Thread Anyway?
3286
3287 =item Threaded Program Models
3288
3289 =over 4
3290
3291 =item Boss/Worker
3292
3293 =item Work Crew
3294
3295 =item Pipeline
3296
3297 =back
3298
3299 =item What kind of threads are Perl threads?
3300
3301 =item Thread-Safe Modules
3302
3303 =item Thread Basics
3304
3305 =over 4
3306
3307 =item Basic Thread Support
3308
3309 =item A Note about the Examples
3310
3311 =item Creating Threads
3312
3313 =item Waiting For A Thread To Exit
3314
3315 =item Ignoring A Thread
3316
3317 =back
3318
3319 =item Threads And Data
3320
3321 =over 4
3322
3323 =item Shared And Unshared Data
3324
3325 =item Thread Pitfalls: Races
3326
3327 =back
3328
3329 =item Synchronization and control
3330
3331 =over 4
3332
3333 =item Controlling access: lock()
3334
3335 =item A Thread Pitfall: Deadlocks
3336
3337 =item Queues: Passing Data Around
3338
3339 =item Semaphores: Synchronizing Data Access
3340
3341 =item Basic semaphores
3342
3343 =item Advanced Semaphores
3344
3345 =item cond_wait() and cond_signal()
3346
3347 =item Giving up control
3348
3349 =back
3350
3351 =item General Thread Utility Routines
3352
3353 =over 4
3354
3355 =item What Thread Am I In?
3356
3357 =item Thread IDs
3358
3359 =item Are These Threads The Same?
3360
3361 =item What Threads Are Running?
3362
3363 =back
3364
3365 =item A Complete Example
3366
3367 =item Different implementations of threads
3368
3369 =item Performance considerations
3370
3371 =item Process-scope Changes
3372
3373 =item Thread-Safety of System Libraries
3374
3375 =item Conclusion
3376
3377 =item Bibliography
3378
3379 =over 4
3380
3381 =item Introductory Texts
3382
3383 =item OS-Related References
3384
3385 =item Other References
3386
3387 =back
3388
3389 =item Acknowledgements
3390
3391 =item AUTHOR
3392
3393 =item Copyrights
3394
3395 =back
3396
3397 =head2 perlothrtut - old tutorial on threads in Perl
3398
3399 =over 4
3400
3401 =item DESCRIPTION
3402
3403 =item What Is A Thread Anyway?
3404
3405 =item Threaded Program Models
3406
3407 =over 4
3408
3409 =item Boss/Worker
3410
3411 =item Work Crew
3412
3413 =item Pipeline
3414
3415 =back
3416
3417 =item Native threads
3418
3419 =item What kind of threads are perl threads?
3420
3421 =item Threadsafe Modules
3422
3423 =item Thread Basics
3424
3425 =over 4
3426
3427 =item Basic Thread Support
3428
3429 =item Creating Threads
3430
3431 =item Giving up control
3432
3433 =item Waiting For A Thread To Exit
3434
3435 =item Errors In Threads
3436
3437 =item Ignoring A Thread
3438
3439 =back
3440
3441 =item Threads And Data
3442
3443 =over 4
3444
3445 =item Shared And Unshared Data
3446
3447 =item Thread Pitfall: Races
3448
3449 =item Controlling access: lock()
3450
3451 =item Thread Pitfall: Deadlocks
3452
3453 =item Queues: Passing Data Around
3454
3455 =back
3456
3457 =item Threads And Code
3458
3459 =over 4
3460
3461 =item Semaphores: Synchronizing Data Access
3462
3463 Basic semaphores, Advanced Semaphores
3464
3465 =item Attributes: Restricting Access To Subroutines
3466
3467 =item Subroutine Locks
3468
3469 =item Methods
3470
3471 =item Locking A Subroutine
3472
3473 =back
3474
3475 =item General Thread Utility Routines
3476
3477 =over 4
3478
3479 =item What Thread Am I In?
3480
3481 =item Thread IDs
3482
3483 =item Are These Threads The Same?
3484
3485 =item What Threads Are Running?
3486
3487 =back
3488
3489 =item A Complete Example
3490
3491 =item Conclusion
3492
3493 =item Bibliography
3494
3495 =over 4
3496
3497 =item Introductory Texts
3498
3499 =item OS-Related References
3500
3501 =item Other References
3502
3503 =back
3504
3505 =item Acknowledgements
3506
3507 =item AUTHOR
3508
3509 =item Copyrights
3510
3511 =back
3512
3513 =head2 perlport - Writing portable Perl
3514
3515 =over 4
3516
3517 =item DESCRIPTION
3518
3519 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
3520 portable
3521
3522 =item ISSUES
3523
3524 =over 4
3525
3526 =item Newlines
3527
3528 =item Numbers endianness and Width
3529
3530 =item Files and Filesystems
3531
3532 =item System Interaction
3533
3534 =item Command names versus file pathnames
3535
3536 =item Networking
3537
3538 =item Interprocess Communication (IPC)
3539
3540 =item External Subroutines (XS)
3541
3542 =item Standard Modules
3543
3544 =item Time and Date
3545
3546 =item Character sets and character encoding
3547
3548 =item Internationalisation
3549
3550 =item System Resources
3551
3552 =item Security
3553
3554 =item Style
3555
3556 =back
3557
3558 =item CPAN Testers
3559
3560 =item PLATFORMS
3561
3562 =over 4
3563
3564 =item Unix
3565
3566 =item DOS and Derivatives
3567
3568 =item S<Mac OS>
3569
3570 =item VMS
3571
3572 =item VOS
3573
3574 =item EBCDIC Platforms
3575
3576 =item Acorn RISC OS
3577
3578 =item Other perls
3579
3580 =back
3581
3582 =item FUNCTION IMPLEMENTATIONS
3583
3584 =over 4
3585
3586 =item Alphabetical Listing of Perl Functions
3587
3588 -I<X>, atan2, binmode, chmod, chown, chroot, crypt, dbmclose, dbmopen,
3589 dump, exec, exit, fcntl, flock, fork, getlogin, getpgrp, getppid,
3590 getpriority, getpwnam, getgrnam, getnetbyname, getpwuid, getgrgid,
3591 getnetbyaddr, getprotobynumber, getservbyport, getpwent, getgrent,
3592 gethostbyname, gethostent, getnetent, getprotoent, getservent, sethostent,
3593 setnetent, setprotoent, setservent, endpwent, endgrent, endhostent,
3594 endnetent, endprotoent, endservent, getsockopt SOCKET,LEVEL,OPTNAME, glob,
3595 gmtime, ioctl FILEHANDLE,FUNCTION,SCALAR, kill, link, localtime, lstat,
3596 msgctl, msgget, msgsnd, msgrcv, open, pipe, readlink, rename, select,
3597 semctl, semget, semop, setgrent, setpgrp, setpriority, setpwent,
3598 setsockopt, shmctl, shmget, shmread, shmwrite, sockatmark, socketpair,
3599 stat, symlink, syscall, sysopen, system, times, truncate, umask, utime,
3600 wait, waitpid
3601
3602 =back
3603
3604 =item Supported Platforms
3605
3606 =item SEE ALSO
3607
3608 =item AUTHORS / CONTRIBUTORS
3609
3610 =back
3611
3612 =head2 perllocale - Perl locale handling (internationalization and
3613 localization)
3614
3615 =over 4
3616
3617 =item DESCRIPTION
3618
3619 =item PREPARING TO USE LOCALES
3620
3621 =item USING LOCALES
3622
3623 =over 4
3624
3625 =item The use locale pragma
3626
3627 =item The setlocale function
3628
3629 =item Finding locales
3630
3631 =item LOCALE PROBLEMS
3632
3633 =item Temporarily fixing locale problems
3634
3635 =item Permanently fixing locale problems
3636
3637 =item Permanently fixing your system's locale configuration
3638
3639 =item Fixing system locale configuration
3640
3641 =item The localeconv function
3642
3643 =item I18N::Langinfo
3644
3645 =back
3646
3647 =item LOCALE CATEGORIES
3648
3649 =over 4
3650
3651 =item Category LC_COLLATE: Collation
3652
3653 =item Category LC_CTYPE: Character Types
3654
3655 =item Category LC_NUMERIC: Numeric Formatting
3656
3657 =item Category LC_MONETARY: Formatting of monetary amounts
3658
3659 =item LC_TIME
3660
3661 =item Other categories
3662
3663 =back
3664
3665 =item SECURITY
3666
3667 =item ENVIRONMENT
3668
3669 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
3670 LC_NUMERIC, LC_TIME, LANG
3671
3672 =item NOTES
3673
3674 =over 4
3675
3676 =item Backward compatibility
3677
3678 =item I18N:Collate obsolete
3679
3680 =item Sort speed and memory use impacts
3681
3682 =item write() and LC_NUMERIC
3683
3684 =item Freely available locale definitions
3685
3686 =item I18n and l10n
3687
3688 =item An imperfect standard
3689
3690 =back
3691
3692 =item Unicode and UTF-8
3693
3694 =item BUGS
3695
3696 =over 4
3697
3698 =item Broken systems
3699
3700 =back
3701
3702 =item SEE ALSO
3703
3704 =item HISTORY
3705
3706 =back
3707
3708 =head2 perluniintro - Perl Unicode introduction
3709
3710 =over 4
3711
3712 =item DESCRIPTION
3713
3714 =over 4
3715
3716 =item Unicode
3717
3718 =item Perl's Unicode Support
3719
3720 =item Perl's Unicode Model
3721
3722 =item Unicode and EBCDIC
3723
3724 =item Creating Unicode
3725
3726 =item Handling Unicode
3727
3728 =item Legacy Encodings
3729
3730 =item Unicode I/O
3731
3732 =item Displaying Unicode As Text
3733
3734 =item Special Cases
3735
3736 =item Advanced Topics
3737
3738 =item Miscellaneous
3739
3740 =item Questions With Answers
3741
3742 =item Hexadecimal Notation
3743
3744 =item Further Resources
3745
3746 =back
3747
3748 =item UNICODE IN OLDER PERLS
3749
3750 =item SEE ALSO
3751
3752 =item ACKNOWLEDGMENTS
3753
3754 =item AUTHOR, COPYRIGHT, AND LICENSE
3755
3756 =back
3757
3758 =head2 perlunicode - Unicode support in Perl
3759
3760 =over 4
3761
3762 =item DESCRIPTION
3763
3764 =over 4
3765
3766 =item Important Caveats
3767
3768 Input and Output Layers, Regular Expressions, C<use utf8> still needed to
3769 enable UTF-8/UTF-EBCDIC in scripts, BOM-marked scripts and UTF-16 scripts
3770 autodetected, C<use encoding> needed to upgrade non-Latin-1 byte strings
3771
3772 =item Byte and Character Semantics
3773
3774 =item Effects of Character Semantics
3775
3776 =item Scripts
3777
3778 =item Blocks
3779
3780 =item User-Defined Character Properties
3781
3782 =item Character Encodings for Input and Output
3783
3784 =item Unicode Regular Expression Support Level
3785
3786 =item Unicode Encodings
3787
3788 =item Security Implications of Unicode
3789
3790 =item Unicode in Perl on EBCDIC
3791
3792 =item Locales
3793
3794 =item When Unicode Does Not Happen
3795
3796 =item Forcing Unicode in Perl (Or Unforcing Unicode in Perl)
3797
3798 =item Using Unicode in XS
3799
3800 =back
3801
3802 =item BUGS
3803
3804 =over 4
3805
3806 =item Interaction with Locales
3807
3808 =item Interaction with Extensions
3809
3810 =item Speed
3811
3812 =item Porting code from perl-5.6.X
3813
3814 =back
3815
3816 =item SEE ALSO
3817
3818 =back
3819
3820 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
3821
3822 =over 4
3823
3824 =item DESCRIPTION
3825
3826 =item COMMON CHARACTER CODE SETS
3827
3828 =over 4
3829
3830 =item ASCII
3831
3832 =item ISO 8859
3833
3834 =item Latin 1 (ISO 8859-1)
3835
3836 =item EBCDIC
3837
3838 =item 13 variant characters
3839
3840 =item 0037
3841
3842 =item 1047
3843
3844 =item POSIX-BC
3845
3846 =item Unicode code points versus EBCDIC code points
3847
3848 =item Remaining Perl Unicode problems in EBCDIC
3849
3850 =item Unicode and UTF
3851
3852 =item Using Encode
3853
3854 =back
3855
3856 =item SINGLE OCTET TABLES
3857
3858 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
3859
3860 =item IDENTIFYING CHARACTER CODE SETS
3861
3862 =item CONVERSIONS
3863
3864 =over 4
3865
3866 =item tr///
3867
3868 =item iconv
3869
3870 =item C RTL
3871
3872 =back
3873
3874 =item OPERATOR DIFFERENCES
3875
3876 =item FUNCTION DIFFERENCES
3877
3878 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
3879
3880 =item REGULAR EXPRESSION DIFFERENCES
3881
3882 =item SOCKETS
3883
3884 =item SORTING
3885
3886 =over 4
3887
3888 =item Ignore ASCII vs. EBCDIC sort differences.
3889
3890 =item MONO CASE then sort data.
3891
3892 =item Convert, sort data, then re convert.
3893
3894 =item Perform sorting on one type of machine only.
3895
3896 =back
3897
3898 =item TRANSFORMATION FORMATS
3899
3900 =over 4
3901
3902 =item URL decoding and encoding
3903
3904 =item uu encoding and decoding
3905
3906 =item Quoted-Printable encoding and decoding
3907
3908 =item Caesarian ciphers
3909
3910 =back
3911
3912 =item Hashing order and checksums
3913
3914 =item I18N AND L10N
3915
3916 =item MULTI OCTET CHARACTER SETS
3917
3918 =item OS ISSUES
3919
3920 =over 4
3921
3922 =item OS/400
3923
3924 PASE, IFS access
3925
3926 =item OS/390, z/OS
3927
3928 chcp, dataset access, OS/390, z/OS iconv, locales
3929
3930 =item VM/ESA?
3931
3932 =item POSIX-BC?
3933
3934 =back
3935
3936 =item BUGS
3937
3938 =item SEE ALSO
3939
3940 =item REFERENCES
3941
3942 =item HISTORY
3943
3944 =item AUTHOR
3945
3946 =back
3947
3948 =head2 perlsec - Perl security
3949
3950 =over 4
3951
3952 =item DESCRIPTION
3953
3954 =over 4
3955
3956 =item Laundering and Detecting Tainted Data
3957
3958 =item Switches On the "#!" Line
3959
3960 =item Taint mode and @INC
3961
3962 =item Cleaning Up Your Path
3963
3964 =item Security Bugs
3965
3966 =item Protecting Your Programs
3967
3968 =item Unicode
3969
3970 =item Algorithmic Complexity Attacks
3971
3972 =back
3973
3974 =item SEE ALSO
3975
3976 =back
3977
3978 =head2 perlmod - Perl modules (packages and symbol tables)
3979
3980 =over 4
3981
3982 =item DESCRIPTION
3983
3984 =over 4
3985
3986 =item Packages
3987 X<package> X<namespace> X<variable, global> X<global variable> X<global>
3988
3989 =item Symbol Tables
3990 X<symbol table> X<stash> X<%::> X<%main::> X<typeglob> X<glob> X<alias>
3991
3992 =item BEGIN, CHECK, INIT and END
3993 X<BEGIN> X<CHECK> X<INIT> X<END>
3994
3995 =item Perl Classes
3996 X<class> X<@ISA>
3997
3998 =item Perl Modules
3999 X<module>
4000
4001 =item Making your module threadsafe
4002 X<threadsafe> X<thread safe>
4003 X<module, threadsafe> X<module, thread safe>
4004 X<CLONE> X<CLONE_SKIP> X<thread> X<threads> X<ithread>
4005
4006 =back
4007
4008 =item SEE ALSO
4009
4010 =back
4011
4012 =head2 perlmodlib - constructing new Perl modules and finding existing ones
4013
4014 =over 4
4015
4016 =item THE PERL MODULE LIBRARY
4017
4018 =over 4
4019
4020 =item Pragmatic Modules
4021
4022 assertions, assertions::activate, assertions::compat, attributes, attrs,
4023 autouse, base, bigint, bignum, bigrat, blib, bytes, charnames, constant,
4024 diagnostics, encoding, encoding::warnings, feature, fields, filetest, if,
4025 integer, less, lib, locale, open, ops, overload, re, sigtrap, sort, strict,
4026 subs, threads, threads::shared, utf8, vars, version, vmsish, warnings,
4027 warnings::register
4028
4029 =item Standard Modules
4030
4031 AnyDBM_File, Archive::Tar, Archive::Tar::File, Attribute::Handlers,
4032 AutoLoader, AutoSplit, B, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode,
4033 B::C, B::CC, B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint,
4034 B::Showlex, B::Stackobj, B::Stash, B::Terse, B::Xref, Benchmark,
4035 ByteLoader, CGI, CGI::Apache, CGI::Carp, CGI::Cookie, CGI::Fast,
4036 CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util, CPAN, CPAN::FirstTime,
4037 CPAN::Nox, CPAN::Version, Carp, Carp::Heavy, Class::ISA, Class::Struct,
4038 Compress::Zlib, Compress::Zlib::pod::FAQ, Config, Cwd, DB, DBM_Filter,
4039 DB_File, Data::Dumper, Devel::DProf, Devel::PPPort, Devel::Peek,
4040 Devel::SelfStubber, Digest, Digest::MD5, Digest::base, Digest::file,
4041 DirHandle, Dumpvalue, DynaLoader, Encode, Encode::Alias, Encode::Byte,
4042 Encode::CJKConstants, Encode::CN, Encode::CN::HZ, Encode::Config,
4043 Encode::EBCDIC, Encode::Encoder, Encode::Encoding, Encode::Guess,
4044 Encode::JP, Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR,
4045 Encode::KR::2022_KR, Encode::MIME::Header, Encode::PerlIO,
4046 Encode::Supported, Encode::Symbol, Encode::TW, Encode::Unicode,
4047 Encode::Unicode::UTF7, English, Env, Errno, Exporter, Exporter::Heavy,
4048 ExtUtils::CBuilder, ExtUtils::CBuilder::Platform::Windows,
4049 ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant,
4050 ExtUtils::Constant::Base, ExtUtils::Constant::Utils,
4051 ExtUtils::Constant::XS, ExtUtils::Embed, ExtUtils::Install,
4052 ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_AIX,
4053 ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS,
4054 ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_QNX,
4055 ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_VOS,
4056 ExtUtils::MM_Win32, ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker,
4057 ExtUtils::MakeMaker::Config, ExtUtils::MakeMaker::FAQ,
4058 ExtUtils::MakeMaker::Tutorial, ExtUtils::MakeMaker::bytes,
4059 ExtUtils::MakeMaker::vmsish, ExtUtils::Manifest, ExtUtils::Mkbootstrap,
4060 ExtUtils::Mksymlists, ExtUtils::Packlist, ExtUtils::ParseXS,
4061 ExtUtils::testlib, Fatal, Fcntl, File::Basename, File::CheckTree,
4062 File::Compare, File::Copy, File::DosGlob, File::Find, File::Glob,
4063 File::GlobMapper, File::Path, File::Spec, File::Spec::Cygwin,
4064 File::Spec::Epoc, File::Spec::Functions, File::Spec::Mac, File::Spec::OS2,
4065 File::Spec::Unix, File::Spec::VMS, File::Spec::Win32, File::Temp,
4066 File::stat, FileCache, FileHandle, Filter::Simple, Filter::Util::Call,
4067 FindBin, GDBM_File, Getopt::Long, Getopt::Std, Hash::Util, I18N::Collate,
4068 I18N::LangTags, I18N::LangTags::Detect, I18N::LangTags::List,
4069 I18N::Langinfo, IO, IO::Compress::Deflate, IO::Compress::Gzip,
4070 IO::Compress::RawDeflate, IO::Dir, IO::File, IO::Handle, IO::Pipe,
4071 IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET,
4072 IO::Socket::UNIX, IO::Uncompress::AnyInflate, IO::Uncompress::Gunzip,
4073 IO::Uncompress::Inflate, IO::Uncompress::RawInflate, IO::Zlib, IPC::Open2,
4074 IPC::Open3, IPC::SysV, IPC::SysV::Msg, IPC::SysV::Semaphore, List::Util,
4075 Locale::Constants, Locale::Country, Locale::Currency, Locale::Language,
4076 Locale::Maketext, Locale::Maketext::TPJ13, Locale::Script, MIME::Base64,
4077 MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt,
4078 Math::BigInt::Calc, Math::BigInt::CalcEmu, Math::BigInt::FastCalc,
4079 Math::BigRat, Math::Complex, Math::Trig, Memoize, Memoize::AnyDBM_File,
4080 Memoize::Expire, Memoize::ExpireFile, Memoize::ExpireTest,
4081 Memoize::NDBM_File, Memoize::SDBM_File, Memoize::Storable,
4082 Module::CoreList, NDBM_File, NEXT, Net::Cmd, Net::Config, Net::Domain,
4083 Net::FTP, Net::NNTP, Net::Netrc, Net::POP3, Net::Ping, Net::SMTP,
4084 Net::Time, Net::hostent, Net::libnetFAQ, Net::netent, Net::protoent,
4085 Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO, PerlIO::encoding,
4086 PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint, Pod::Checker,
4087 Pod::Escapes, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects,
4088 Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser,
4089 Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff,
4090 Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText,
4091 Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer,
4092 Pod::Select, Pod::Simple, Pod::Simple::Checker, Pod::Simple::Debug,
4093 Pod::Simple::DumpAsText, Pod::Simple::DumpAsXML, Pod::Simple::HTML,
4094 Pod::Simple::HTMLBatch, Pod::Simple::LinkSection, Pod::Simple::Methody,
4095 Pod::Simple::PullParser, Pod::Simple::PullParserEndToken,
4096 Pod::Simple::PullParserStartToken, Pod::Simple::PullParserTextToken,
4097 Pod::Simple::PullParserToken, Pod::Simple::RTF, Pod::Simple::Search,
4098 Pod::Simple::SimpleTree, Pod::Simple::Subclassing, Pod::Simple::Text,
4099 Pod::Simple::TextContent, Pod::Simple::XMLOutStream, Pod::Text,
4100 Pod::Text::Color, Pod::Text::Overstrike, Pod::Text::Termcap, Pod::Usage,
4101 SDBM_File, Safe, Scalar::Util, Search::Dict, SelectSaver, SelfLoader,
4102 Shell, Socket, Storable, Switch, Symbol, Sys::Hostname, Sys::Syslog,
4103 Term::ANSIColor, Term::Cap, Term::Complete, Term::ReadLine, Test,
4104 Test::Builder, Test::Builder::Module, Test::Builder::Tester,
4105 Test::Builder::Tester::Color, Test::Harness, Test::Harness::Assert,
4106 Test::Harness::Iterator, Test::Harness::Point, Test::Harness::Straps,
4107 Test::Harness::TAP, Test::More, Test::Simple, Test::Tutorial, Text::Abbrev,
4108 Text::Balanced, Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap,
4109 Thread, Thread::Queue, Thread::Semaphore, Thread::Signal, Thread::Specific,
4110 Tie::Array, Tie::File, Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash,
4111 Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::gmtime,
4112 Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate, Unicode::Normalize,
4113 Unicode::UCD, User::grent, User::pwent, XS::APItest, XS::Typemap, XSLoader
4114
4115 =item Extension Modules
4116
4117 =back
4118
4119 =item CPAN
4120
4121 =over 4
4122
4123 =item Africa
4124
4125 South Africa
4126
4127 =item Asia
4128
4129 China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi
4130 Arabia, Singapore, South Korea, Taiwan, Thailand
4131
4132 =item Central America
4133
4134 Costa Rica
4135
4136 =item Europe
4137
4138 Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Czech
4139 Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary,
4140 Iceland, Ireland, Italy, Latvia, Lithuania, Netherlands, Norway, Poland,
4141 Portugal, Romania, Russia, Slovakia, Slovenia, Spain, Sweden, Switzerland,
4142 Turkey, Ukraine, United Kingdom
4143
4144 =item North America
4145
4146 Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States,
4147 Alabama, California, Colorado, Delaware, District of Columbia, Florida,
4148 Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey, New York,
4149 North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, Utah,
4150 Virginia, Washington, Wisconsin
4151
4152 =item Oceania
4153
4154 Australia, New Zealand, United States
4155
4156 =item South America
4157
4158 Argentina, Brazil, Chile
4159
4160 =item RSYNC Mirrors
4161
4162 =back
4163
4164 =item Modules: Creation, Use, and Abuse
4165
4166 =over 4
4167
4168 =item Guidelines for Module Creation
4169
4170 =item Guidelines for Converting Perl 4 Library Scripts into Modules
4171
4172 =item Guidelines for Reusing Application Code
4173
4174 =back
4175
4176 =item NOTE
4177
4178 =back
4179
4180 =head2 perlmodstyle - Perl module style guide
4181
4182 =over 4
4183
4184 =item INTRODUCTION
4185
4186 =item QUICK CHECKLIST
4187
4188 =over 4
4189
4190 =item Before you start
4191
4192 =item The API
4193
4194 =item Stability
4195
4196 =item Documentation
4197
4198 =item Release considerations
4199
4200 =back
4201
4202 =item BEFORE YOU START WRITING A MODULE
4203
4204 =over 4
4205
4206 =item Has it been done before?
4207
4208 =item Do one thing and do it well
4209
4210 =item What's in a name?
4211
4212 =back
4213
4214 =item DESIGNING AND WRITING YOUR MODULE
4215
4216 =over 4
4217
4218 =item To OO or not to OO?
4219
4220 =item Designing your API
4221
4222 Write simple routines to do simple things, Separate functionality from
4223 output, Provide sensible shortcuts and defaults, Naming conventions,
4224 Parameter passing
4225
4226 =item Strictness and warnings
4227
4228 =item Backwards compatibility
4229
4230 =item Error handling and messages
4231
4232 =back
4233
4234 =item DOCUMENTING YOUR MODULE
4235
4236 =over 4
4237
4238 =item POD
4239
4240 =item README, INSTALL, release notes, changelogs
4241
4242 perl Makefile.PL, make, make test, make install, perl Build.PL, perl Build,
4243 perl Build test, perl Build install
4244
4245 =back
4246
4247 =item RELEASE CONSIDERATIONS
4248
4249 =over 4
4250
4251 =item Version numbering
4252
4253 =item Pre-requisites
4254
4255 =item Testing
4256
4257 =item Packaging
4258
4259 =item Licensing
4260
4261 =back
4262
4263 =item COMMON PITFALLS
4264
4265 =over 4
4266
4267 =item Reinventing the wheel
4268
4269 =item Trying to do too much
4270
4271 =item Inappropriate documentation
4272
4273 =back
4274
4275 =item SEE ALSO
4276
4277 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Packaging Tools,
4278 Testing tools, http://pause.perl.org/, Any good book on software
4279 engineering
4280
4281 =item AUTHOR
4282
4283 =back
4284
4285 =head2 perlmodinstall - Installing CPAN Modules
4286
4287 =over 4
4288
4289 =item DESCRIPTION
4290
4291 =over 4
4292
4293 =item PREAMBLE
4294
4295 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
4296 module (sometimes unnecessary), B<INSTALL> the module
4297
4298 =back
4299
4300 =item PORTABILITY
4301
4302 =item HEY
4303
4304 =item AUTHOR
4305
4306 =item COPYRIGHT
4307
4308 =back
4309
4310 =head2 perlnewmod - preparing a new module for distribution
4311
4312 =over 4
4313
4314 =item DESCRIPTION
4315
4316 =over 4
4317
4318 =item Warning
4319
4320 =item What should I make into a module?
4321
4322 =item Step-by-step: Preparing the ground
4323
4324 Look around, Check it's new, Discuss the need, Choose a name, Check again
4325
4326 =item Step-by-step: Making the module
4327
4328 Start with F<module-starter> or F<h2xs>, Use L<strict|strict> and
4329 L<warnings|warnings>, Use L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!,
4330 Use L<plain old documentation|perlpod>, Write tests, Write the README
4331
4332 =item Step-by-step: Distributing your module
4333
4334 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
4335 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
4336
4337 =back
4338
4339 =item AUTHOR
4340
4341 =item SEE ALSO
4342
4343 =back
4344
4345 =head2 perlutil - utilities packaged with the Perl distribution
4346
4347 =over 4
4348
4349 =item DESCRIPTION
4350
4351 =over 4
4352
4353 =item DOCUMENTATION
4354
4355 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
4356 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
4357 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
4358 L<roffitall|roffitall>
4359
4360 =item CONVERTORS
4361
4362 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
4363
4364 =item Administration
4365
4366 L<libnetcfg|libnetcfg>
4367
4368 =item Development
4369
4370 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
4371 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
4372
4373 =item SEE ALSO
4374
4375 =back
4376
4377 =back
4378
4379 =head2 perlcompile - Introduction to the Perl Compiler-Translator 
4380
4381 =over 4
4382
4383 =item DESCRIPTION
4384
4385 =over 4
4386
4387 =item Layout
4388
4389 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
4390
4391 =back
4392
4393 =item Using The Back Ends
4394
4395 =over 4
4396
4397 =item The Cross Referencing Back End
4398
4399 i, &, s, r
4400
4401 =item The Decompiling Back End
4402
4403 =item The Lint Back End
4404
4405 =item The Simple C Back End
4406
4407 =item The Bytecode Back End
4408
4409 =item The Optimized C Back End
4410
4411 =back
4412
4413 =item Module List for the Compiler Suite
4414
4415 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
4416 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
4417 B::Stackobj, B::Stash, B::Terse, B::Xref
4418
4419 =item KNOWN PROBLEMS
4420
4421 =item AUTHOR
4422
4423 =back
4424
4425 =head2 perlfilter - Source Filters
4426
4427 =over 4
4428
4429 =item DESCRIPTION
4430
4431 =item CONCEPTS
4432
4433 =item USING FILTERS
4434
4435 =item WRITING A SOURCE FILTER
4436
4437 =item WRITING A SOURCE FILTER IN C
4438
4439 B<Decryption Filters>
4440
4441 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4442
4443 =item WRITING A SOURCE FILTER IN PERL
4444
4445 =item USING CONTEXT: THE DEBUG FILTER
4446
4447 =item CONCLUSION
4448
4449 =item THINGS TO LOOK OUT FOR
4450
4451 Some Filters Clobber the C<DATA> Handle
4452
4453 =item REQUIREMENTS
4454
4455 =item AUTHOR
4456
4457 =item Copyrights
4458
4459 =back
4460
4461 =head2 perlglossary - Perl Glossary
4462
4463 =over 4
4464
4465 =item DESCRIPTION
4466
4467 =over 4
4468
4469 =item A
4470
4471 accessor methods, actual arguments, address operator, algorithm, alias,
4472 alternatives, anonymous, architecture, argument, ARGV, arithmetical
4473 operator, array, array context, ASCII, assertion, assignment, assignment
4474 operator, associative array, associativity, asynchronous, atom, atomic
4475 operation, attribute, autogeneration, autoincrement, autoload, autosplit,
4476 autovivification, AV, awk
4477
4478 =item B
4479
4480 backreference, backtracking, backward compatibility, bareword, base class,
4481 big-endian, binary, binary operator, bind, bit, bit shift, bit string,
4482 bless, block, BLOCK, block buffering, Boolean, Boolean context, breakpoint,
4483 broadcast, BSD, bucket, buffer, built-in, bundle, byte, bytecode
4484
4485 =item C
4486
4487 C, C preprocessor, call by reference, call by value, callback, canonical,
4488 capturing, character, character class, character property, circumfix
4489 operator, class, class method, client, cloister, closure, cluster, CODE,
4490 code generator, code subpattern, collating sequence, command, command
4491 buffering, command name, command-line arguments, comment, compilation unit,
4492 compile phase, compile time, compiler, composer, concatenation,
4493 conditional, connection, construct, constructor, context, continuation,
4494 core dump, CPAN, cracker, current package, current working directory,
4495 currently selected output channel, CV
4496
4497 =item D
4498
4499 dangling statement, data structure, data type, datagram, DBM, declaration,
4500 decrement, default, defined, delimiter, dereference, derived class,
4501 descriptor, destroy, destructor, device, directive, directory, directory
4502 handle, dispatch, distribution, dweomer, dwimmer, dynamic scoping
4503
4504 =item E
4505
4506 eclectic, element, embedding, empty subclass test, en passant,
4507 encapsulation, endian, environment, environment variable, EOF, errno,
4508 error, escape sequence, exception, exception handling, exec, executable
4509 file, execute, execute bit, exit status, export, expression, extension
4510
4511 =item F
4512
4513 false, FAQ, fatal error, field, FIFO, file, file descriptor, file test
4514 operator, fileglob, filehandle, filename, filesystem, filter, flag,
4515 floating point, flush, FMTEYEWTK, fork, formal arguments, format, freely
4516 available, freely redistributable, freeware, function, funny character,
4517 garbage collection
4518
4519 =item G
4520
4521 GID, glob, global, global destruction, glue language, granularity, greedy,
4522 grep, group, GV
4523
4524 =item H
4525
4526 hacker, handler, hard reference, hash, hash table, header file, here
4527 document, hexadecimal, home directory, host, hubris, HV
4528
4529 =item I
4530
4531 identifier, impatience, implementation, import, increment, indexing,
4532 indirect filehandle, indirect object, indirect object slot, indirection,
4533 infix, inheritance, instance, instance variable, integer, interface,
4534 interpolation, interpreter, invocant, invocation, I/O, IO, IP, IPC, is-a,
4535 iteration, iterator, IV
4536
4537 =item J
4538
4539 JAPH
4540
4541 =item K
4542
4543 key, keyword
4544
4545 =item L
4546
4547 label, laziness, left shift, leftmost longest, lexeme, lexer, lexical
4548 analysis, lexical scoping, lexical variable, library, LIFO, line, line
4549 buffering, line number, link, LIST, list, list context, list operator, list
4550 value, literal, little-endian, local, logical operator, lookahead,
4551 lookbehind, loop, loop control statement, loop label, lvaluable, lvalue,
4552 lvalue modifier
4553
4554 =item M
4555
4556 magic, magical increment, magical variables, Makefile, man, manpage,
4557 matching, member data, memory, metacharacter, metasymbol, method,
4558 minimalism, mode, modifier, module, modulus, monger, mortal,
4559 multidimensional array, multiple inheritance
4560
4561 =item N
4562
4563 named pipe, namespace, network address, newline, NFS, null character, null
4564 list, null string, numeric context, NV, nybble
4565
4566 =item O
4567
4568 object, octal, offset, one-liner, open source software, operand, operating
4569 system, operator, operator overloading, options, overloading, overriding,
4570 owner
4571
4572 =item P
4573
4574 package, pad, parameter, parent class, parse tree, parsing, patch, PATH,
4575 pathname, pattern, pattern matching, permission bits, Pern, pipe, pipeline,
4576 platform, pod, pointer, polymorphism, port, portable, porter, POSIX,
4577 postfix, pp, pragma, precedence, prefix, preprocessing, procedure, process,
4578 program generator, progressive matching, property, protocol, prototype,
4579 pseudofunction, pseudohash, pseudoliteral, public domain, pumpkin,
4580 pumpking, PV
4581
4582 =item Q
4583
4584 qualified, quantifier
4585
4586 =item R
4587
4588 readable, reaping, record, recursion, reference, referent, regex, regular
4589 expression, regular expression modifier, regular file, relational operator,
4590 reserved words, return value, RFC, right shift, root, RTFM, run phase, run
4591 time, run-time pattern, RV, rvalue
4592
4593 =item S
4594
4595 scalar, scalar context, scalar literal, scalar value, scalar variable,
4596 scope, scratchpad, script, script kiddie, sed, semaphore, separator,
4597 serialization, server, service, setgid, setuid, shared memory, shebang,
4598 shell, side effects, signal, signal handler, single inheritance, slice,
4599 slurp, socket, soft reference, source filter, stack, standard, standard
4600 error, standard I/O, standard input, standard output, stat structure,
4601 statement, statement modifier, static, static method, static scoping,
4602 static variable, status, STDERR, STDIN, STDIO, STDOUT, stream, string,
4603 string context, stringification, struct, structure, subclass, subpattern,
4604 subroutine, subscript, substitution, substring, superclass, superuser, SV,
4605 switch, switch cluster, switch statement, symbol, symbol table, symbolic
4606 debugger, symbolic link, symbolic reference, synchronous, syntactic sugar,
4607 syntax, syntax tree, syscall
4608
4609 =item T
4610
4611 tainted, TCP, term, terminator, ternary, text, thread, tie, TMTOWTDI,
4612 token, tokener, tokenizing, toolbox approach, transliterate, trigger,
4613 trinary, troff, true, truncating, type, type casting, typed lexical,
4614 typedef, typeglob, typemap
4615
4616 =item U
4617
4618 UDP, UID, umask, unary operator, Unicode, Unix
4619
4620 =item V
4621
4622 value, variable, variable interpolation, variadic, vector, virtual, void
4623 context, v-string
4624
4625 =item W
4626
4627 warning, watch expression, whitespace, word, working directory, wrapper,
4628 WYSIWYG
4629
4630 =item X
4631
4632 XS, XSUB
4633
4634 =item Y
4635
4636 yacc
4637
4638 =item Z
4639
4640 zero width, zombie
4641
4642 =back
4643
4644 =item AUTHOR AND COPYRIGHT
4645
4646 =back
4647
4648 =head2 perlembed - how to embed perl in your C program
4649
4650 =over 4
4651
4652 =item DESCRIPTION
4653
4654 =over 4
4655
4656 =item PREAMBLE
4657
4658 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
4659 Perl?>, B<Use C from C?>, B<Use Perl from C?>
4660
4661 =item ROADMAP
4662
4663 =item Compiling your C program
4664
4665 =item Adding a Perl interpreter to your C program
4666
4667 =item Calling a Perl subroutine from your C program
4668
4669 =item Evaluating a Perl statement from your C program
4670
4671 =item Performing Perl pattern matches and substitutions from your C program
4672
4673 =item Fiddling with the Perl stack from your C program
4674
4675 =item Maintaining a persistent interpreter
4676
4677 =item Execution of END blocks
4678
4679 =item Maintaining multiple interpreter instances
4680
4681 =item Using Perl modules, which themselves use C libraries, from your C
4682 program
4683
4684 =back
4685
4686 =item Embedding Perl under Win32
4687
4688 =item Hiding Perl_
4689
4690 =item MORAL
4691
4692 =item AUTHOR
4693
4694 =item COPYRIGHT
4695
4696 =back
4697
4698 =head2 perldebguts - Guts of Perl debugging 
4699
4700 =over 4
4701
4702 =item DESCRIPTION
4703
4704 =item Debugger Internals
4705
4706 =over 4
4707
4708 =item Writing Your Own Debugger
4709
4710 =back
4711
4712 =item Frame Listing Output Examples
4713
4714 =item Debugging regular expressions
4715
4716 =over 4
4717
4718 =item Compile-time output
4719
4720 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
4721 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
4722 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
4723 C<anchored(TYPE)>
4724
4725 =item Types of nodes
4726
4727 =item Run-time output
4728
4729 =back
4730
4731 =item Debugging Perl memory usage
4732
4733 =over 4
4734
4735 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
4736
4737 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
4738 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
4739 6144>
4740
4741 =back
4742
4743 =item SEE ALSO
4744
4745 =back
4746
4747 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
4748
4749 =over 4
4750
4751 =item DESCRIPTION
4752
4753 =item SPECIAL NOTES
4754
4755 =over 4
4756
4757 =item make
4758
4759 =item Version caveat
4760
4761 =item Dynamic Loading versus Static Loading
4762
4763 =back
4764
4765 =item TUTORIAL
4766
4767 =over 4
4768
4769 =item EXAMPLE 1
4770
4771 =item EXAMPLE 2
4772
4773 =item What has gone on?
4774
4775 =item Writing good test scripts
4776
4777 =item EXAMPLE 3
4778
4779 =item What's new here?
4780
4781 =item Input and Output Parameters
4782
4783 =item The XSUBPP Program
4784
4785 =item The TYPEMAP file
4786
4787 =item Warning about Output Arguments
4788
4789 =item EXAMPLE 4
4790
4791 =item What has happened here?
4792
4793 =item Anatomy of .xs file
4794
4795 =item Getting the fat out of XSUBs
4796
4797 =item More about XSUB arguments
4798
4799 =item The Argument Stack
4800
4801 =item Extending your Extension
4802
4803 =item Documenting your Extension
4804
4805 =item Installing your Extension
4806
4807 =item EXAMPLE 5
4808
4809 =item New Things in this Example
4810
4811 =item EXAMPLE 6
4812
4813 =item New Things in this Example
4814
4815 =item EXAMPLE 7 (Coming Soon)
4816
4817 =item EXAMPLE 8 (Coming Soon)
4818
4819 =item EXAMPLE 9 Passing open files to XSes
4820
4821 =item Troubleshooting these Examples
4822
4823 =back
4824
4825 =item See also
4826
4827 =item Author
4828
4829 =over 4
4830
4831 =item Last Changed
4832
4833 =back
4834
4835 =back
4836
4837 =head2 perlxs - XS language reference manual
4838
4839 =over 4
4840
4841 =item DESCRIPTION
4842
4843 =over 4
4844
4845 =item Introduction
4846
4847 =item On The Road
4848
4849 =item The Anatomy of an XSUB
4850
4851 =item The Argument Stack
4852
4853 =item The RETVAL Variable
4854
4855 =item Returning SVs, AVs and HVs through RETVAL
4856
4857 =item The MODULE Keyword
4858
4859 =item The PACKAGE Keyword
4860
4861 =item The PREFIX Keyword
4862
4863 =item The OUTPUT: Keyword
4864
4865 =item The NO_OUTPUT Keyword
4866
4867 =item The CODE: Keyword
4868
4869 =item The INIT: Keyword
4870
4871 =item The NO_INIT Keyword
4872
4873 =item Initializing Function Parameters
4874
4875 =item Default Parameter Values
4876
4877 =item The PREINIT: Keyword
4878
4879 =item The SCOPE: Keyword
4880
4881 =item The INPUT: Keyword
4882
4883 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
4884
4885 =item The C<length(NAME)> Keyword
4886
4887 =item Variable-length Parameter Lists
4888
4889 =item The C_ARGS: Keyword
4890
4891 =item The PPCODE: Keyword
4892
4893 =item Returning Undef And Empty Lists
4894
4895 =item The REQUIRE: Keyword
4896
4897 =item The CLEANUP: Keyword
4898
4899 =item The POSTCALL: Keyword
4900
4901 =item The BOOT: Keyword
4902
4903 =item The VERSIONCHECK: Keyword
4904
4905 =item The PROTOTYPES: Keyword
4906
4907 =item The PROTOTYPE: Keyword
4908
4909 =item The ALIAS: Keyword
4910
4911 =item The OVERLOAD: Keyword
4912
4913 =item The FALLBACK: Keyword
4914
4915 =item The INTERFACE: Keyword
4916
4917 =item The INTERFACE_MACRO: Keyword
4918
4919 =item The INCLUDE: Keyword
4920
4921 =item The CASE: Keyword
4922
4923 =item The & Unary Operator
4924
4925 =item Inserting POD, Comments and C Preprocessor Directives
4926
4927 =item Using XS With C++
4928
4929 =item Interface Strategy
4930
4931 =item Perl Objects And C Structures
4932
4933 =item The Typemap
4934
4935 =item Safely Storing Static Data in XS
4936
4937 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT,
4938 aMY_CXT/pMY_CXT, MY_CXT_CLONE, MY_CXT_INIT_INTERP(my_perl),
4939 dMY_CXT_INTERP(my_perl)
4940
4941 =back
4942
4943 =item EXAMPLES
4944
4945 =item XS VERSION
4946
4947 =item AUTHOR
4948
4949 =back
4950
4951 =head2 perlclib - Internal replacements for standard C library functions
4952
4953 =over 4
4954
4955 =item DESCRIPTION
4956
4957 =over 4
4958
4959 =item Conventions
4960
4961 C<t>, C<p>, C<n>, C<s>
4962
4963 =item File Operations
4964
4965 =item File Input and Output
4966
4967 =item File Positioning
4968
4969 =item Memory Management and String Handling
4970
4971 =item Character Class Tests
4972
4973 =item F<stdlib.h> functions
4974
4975 =item Miscellaneous functions
4976
4977 =back
4978
4979 =item SEE ALSO
4980
4981 =back
4982
4983 =head2 perlguts - Introduction to the Perl API
4984
4985 =over 4
4986
4987 =item DESCRIPTION
4988
4989 =item Variables
4990
4991 =over 4
4992
4993 =item Datatypes
4994
4995 =item What is an "IV"?
4996
4997 =item Working with SVs
4998
4999 =item Offsets
5000
5001 =item What's Really Stored in an SV?
5002
5003 =item Working with AVs
5004
5005 =item Working with HVs
5006
5007 =item Hash API Extensions
5008
5009 =item AVs, HVs and undefined values
5010
5011 =item References
5012
5013 =item Blessed References and Class Objects
5014
5015 =item Creating New Variables
5016
5017 GV_ADDMULTI, GV_ADDWARN
5018
5019 =item Reference Counts and Mortality
5020
5021 =item Stashes and Globs
5022
5023 =item Double-Typed SVs
5024
5025 =item Magic Variables
5026
5027 =item Assigning Magic
5028
5029 =item Magic Virtual Tables
5030
5031 =item Finding Magic
5032
5033 =item Understanding the Magic of Tied Hashes and Arrays
5034
5035 =item Localizing changes
5036
5037 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
5038 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
5039 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
5040 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
5041 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
5042 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
5043 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
5044 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
5045 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
5046 save_hptr(HV **hptr)>
5047
5048 =back
5049
5050 =item Subroutines
5051
5052 =over 4
5053
5054 =item XSUBs and the Argument Stack
5055
5056 =item Calling Perl Routines from within C Programs
5057
5058 =item Memory Allocation
5059
5060 =item PerlIO
5061
5062 =item Putting a C value on Perl stack
5063
5064 =item Scratchpads
5065
5066 =item Scratchpads and recursion
5067
5068 =back
5069
5070 =item Compiled code
5071
5072 =over 4
5073
5074 =item Code tree
5075
5076 =item Examining the tree
5077
5078 =item Compile pass 1: check routines
5079
5080 =item Compile pass 1a: constant folding
5081
5082 =item Compile pass 2: context propagation
5083
5084 =item Compile pass 3: peephole optimization
5085
5086 =item Pluggable runops
5087
5088 =back
5089
5090 =item Examining internal data structures with the C<dump> functions
5091
5092 =item How multiple interpreters and concurrency are supported
5093
5094 =over 4
5095
5096 =item Background and PERL_IMPLICIT_CONTEXT
5097
5098 =item So what happened to dTHR?
5099
5100 =item How do I use all this in extensions?
5101
5102 =item Should I do anything special if I call perl from multiple threads?
5103
5104 =item Future Plans and PERL_IMPLICIT_SYS
5105
5106 =back
5107
5108 =item Internal Functions
5109
5110 A, p, d, s, n, r, f, M, o, x, m, X, E, b
5111
5112 =over 4
5113
5114 =item Formatted Printing of IVs, UVs, and NVs
5115
5116 =item Pointer-To-Integer and Integer-To-Pointer
5117
5118 =item Exception Handling
5119
5120 =item Source Documentation
5121
5122 =item Backwards compatibility
5123
5124 =back
5125
5126 =item Unicode Support
5127
5128 =over 4
5129
5130 =item What B<is> Unicode, anyway?
5131
5132 =item How can I recognise a UTF-8 string?
5133
5134 =item How does UTF-8 represent Unicode characters?
5135
5136 =item How does Perl store UTF-8 strings?
5137
5138 =item How do I convert a string to UTF-8?
5139
5140 =item Is there anything else I need to know?
5141
5142 =back
5143
5144 =item Custom Operators
5145
5146 =item AUTHORS
5147
5148 =item SEE ALSO
5149
5150 =back
5151
5152 =head2 perlcall - Perl calling conventions from C
5153
5154 =over 4
5155
5156 =item DESCRIPTION
5157
5158 An Error Handler, An Event Driven Program
5159
5160 =item THE CALL_ FUNCTIONS
5161
5162 call_sv, call_pv, call_method, call_argv
5163
5164 =item FLAG VALUES
5165
5166 =over 4
5167
5168 =item  G_VOID
5169
5170 =item  G_SCALAR
5171
5172 =item G_ARRAY
5173
5174 =item G_DISCARD
5175
5176 =item G_NOARGS
5177
5178 =item G_EVAL
5179
5180 =item G_KEEPERR
5181
5182 =item Determining the Context
5183
5184 =back
5185
5186 =item EXAMPLES
5187
5188 =over 4
5189
5190 =item No Parameters, Nothing returned
5191
5192 =item Passing Parameters
5193
5194 =item Returning a Scalar
5195
5196 =item Returning a list of values
5197
5198 =item Returning a list in a scalar context
5199
5200 =item Returning Data from Perl via the parameter list
5201
5202 =item Using G_EVAL
5203
5204 =item Using G_KEEPERR
5205
5206 =item Using call_sv
5207
5208 =item Using call_argv
5209
5210 =item Using call_method
5211
5212 =item Using GIMME_V
5213
5214 =item Using Perl to dispose of temporaries
5215
5216 =item Strategies for storing Callback Context Information
5217
5218 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
5219 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
5220 callback
5221
5222 =item Alternate Stack Manipulation
5223
5224 =item Creating and calling an anonymous subroutine in C
5225
5226 =back
5227
5228 =item LIGHTWEIGHT CALLBACKS
5229
5230 =item SEE ALSO
5231
5232 =item AUTHOR
5233
5234 =item DATE
5235
5236 =back
5237
5238 =head2 perlapi - autogenerated documentation for the perl public API
5239
5240 =over 4
5241
5242 =item DESCRIPTION
5243 X<Perl API> X<API> X<api>
5244
5245 =item "Gimme" Values
5246
5247 GIMME X<GIMME>, GIMME_V X<GIMME_V>, G_ARRAY X<G_ARRAY>, G_DISCARD
5248 X<G_DISCARD>, G_EVAL X<G_EVAL>, G_NOARGS X<G_NOARGS>, G_SCALAR X<G_SCALAR>,
5249 G_VOID X<G_VOID>
5250
5251 =item Array Manipulation Functions
5252
5253 AvFILL X<AvFILL>, av_clear X<av_clear>, av_delete X<av_delete>, av_exists
5254 X<av_exists>, av_extend X<av_extend>, av_fetch X<av_fetch>, av_fill
5255 X<av_fill>, av_len X<av_len>, av_make X<av_make>, av_pop X<av_pop>, av_push
5256 X<av_push>, av_shift X<av_shift>, av_store X<av_store>, av_undef
5257 X<av_undef>, av_unshift X<av_unshift>, get_av X<get_av>, newAV X<newAV>,
5258 sortsv X<sortsv>, sortsv_flags X<sortsv_flags>
5259
5260 =item Callback Functions
5261
5262 call_argv X<call_argv>, call_method X<call_method>, call_pv X<call_pv>,
5263 call_sv X<call_sv>, ENTER X<ENTER>, eval_pv X<eval_pv>, eval_sv X<eval_sv>,
5264 FREETMPS X<FREETMPS>, LEAVE X<LEAVE>, SAVETMPS X<SAVETMPS>
5265
5266 =item Character classes
5267
5268 isALNUM X<isALNUM>, isALPHA X<isALPHA>, isDIGIT X<isDIGIT>, isLOWER
5269 X<isLOWER>, isSPACE X<isSPACE>, isUPPER X<isUPPER>, toLOWER X<toLOWER>,
5270 toUPPER X<toUPPER>
5271
5272 =item Cloning an interpreter
5273
5274 perl_clone X<perl_clone>
5275
5276 =item CV Manipulation Functions
5277
5278 CvSTASH X<CvSTASH>, get_cv X<get_cv>
5279
5280 =item Embedding Functions
5281
5282 cv_undef X<cv_undef>, load_module X<load_module>, nothreadhook
5283 X<nothreadhook>, perl_alloc X<perl_alloc>, perl_construct
5284 X<perl_construct>, perl_destruct X<perl_destruct>, perl_free X<perl_free>,
5285 perl_parse X<perl_parse>, perl_run X<perl_run>, require_pv X<require_pv>
5286
5287 =item Functions in file mathoms.c
5288
5289 gv_fetchmethod X<gv_fetchmethod>, sv_2pvbyte_nolen X<sv_2pvbyte_nolen>,
5290 sv_2pvutf8_nolen X<sv_2pvutf8_nolen>, sv_2pv_nolen X<sv_2pv_nolen>,
5291 sv_catpvn_mg X<sv_catpvn_mg>, sv_catsv_mg X<sv_catsv_mg>, sv_force_normal
5292 X<sv_force_normal>, sv_iv X<sv_iv>, sv_nolocking X<sv_nolocking>,
5293 sv_nounlocking X<sv_nounlocking>, sv_nv X<sv_nv>, sv_pv X<sv_pv>, sv_pvbyte
5294 X<sv_pvbyte>, sv_pvbyten X<sv_pvbyten>, sv_pvn X<sv_pvn>, sv_pvutf8
5295 X<sv_pvutf8>, sv_pvutf8n X<sv_pvutf8n>, sv_taint X<sv_taint>, sv_unref
5296 X<sv_unref>, sv_uv X<sv_uv>
5297
5298 =item Functions in file pp_pack.c
5299
5300 packlist X<packlist>, pack_cat X<pack_cat>, unpackstring X<unpackstring>,
5301 unpack_str X<unpack_str>
5302
5303 =item Global Variables
5304
5305 PL_modglobal X<PL_modglobal>, PL_na X<PL_na>, PL_sv_no X<PL_sv_no>,
5306 PL_sv_undef X<PL_sv_undef>, PL_sv_yes X<PL_sv_yes>
5307
5308 =item GV Functions
5309
5310 GvSV X<GvSV>, gv_const_sv X<gv_const_sv>, gv_fetchmeth X<gv_fetchmeth>,
5311 gv_fetchmethod_autoload X<gv_fetchmethod_autoload>, gv_fetchmeth_autoload
5312 X<gv_fetchmeth_autoload>, gv_stashpv X<gv_stashpv>, gv_stashpvn
5313 X<gv_stashpvn>, gv_stashsv X<gv_stashsv>
5314
5315 =item Handy Values
5316
5317 Nullav X<Nullav>, Nullch X<Nullch>, Nullcv X<Nullcv>, Nullhv X<Nullhv>,
5318 Nullsv X<Nullsv>
5319
5320 =item Hash Manipulation Functions
5321
5322 get_hv X<get_hv>, HEf_SVKEY X<HEf_SVKEY>, HeHASH X<HeHASH>, HeKEY X<HeKEY>,
5323 HeKLEN X<HeKLEN>, HePV X<HePV>, HeSVKEY X<HeSVKEY>, HeSVKEY_force
5324 X<HeSVKEY_force>, HeSVKEY_set X<HeSVKEY_set>, HeVAL X<HeVAL>, HvNAME
5325 X<HvNAME>, hv_assert X<hv_assert>, hv_clear X<hv_clear>,
5326 hv_clear_placeholders X<hv_clear_placeholders>, hv_delete X<hv_delete>,
5327 hv_delete_ent X<hv_delete_ent>, hv_exists X<hv_exists>, hv_exists_ent
5328 X<hv_exists_ent>, hv_fetch X<hv_fetch>, hv_fetch_ent X<hv_fetch_ent>,
5329 hv_iterinit X<hv_iterinit>, hv_iterkey X<hv_iterkey>, hv_iterkeysv
5330 X<hv_iterkeysv>, hv_iternext X<hv_iternext>, hv_iternextsv
5331 X<hv_iternextsv>, hv_iternext_flags X<hv_iternext_flags>, hv_iterval
5332 X<hv_iterval>, hv_magic X<hv_magic>, hv_scalar X<hv_scalar>, hv_store
5333 X<hv_store>, hv_store_ent X<hv_store_ent>, hv_undef X<hv_undef>, newHV
5334 X<newHV>
5335
5336 =item Magical Functions
5337
5338 mg_clear X<mg_clear>, mg_copy X<mg_copy>, mg_find X<mg_find>, mg_free
5339 X<mg_free>, mg_get X<mg_get>, mg_length X<mg_length>, mg_magical
5340 X<mg_magical>, mg_set X<mg_set>, SvGETMAGIC X<SvGETMAGIC>, SvLOCK
5341 X<SvLOCK>, SvSETMAGIC X<SvSETMAGIC>, SvSetMagicSV X<SvSetMagicSV>,
5342 SvSetMagicSV_nosteal X<SvSetMagicSV_nosteal>, SvSetSV X<SvSetSV>,
5343 SvSetSV_nosteal X<SvSetSV_nosteal>, SvSHARE X<SvSHARE>, SvUNLOCK
5344 X<SvUNLOCK>
5345
5346 =item Memory Management
5347
5348 Copy X<Copy>, CopyD X<CopyD>, Move X<Move>, MoveD X<MoveD>, Newx X<Newx>,
5349 Newxc X<Newxc>, Newxz X<Newxz>, Poison X<Poison>, Renew X<Renew>, Renewc
5350 X<Renewc>, Safefree X<Safefree>, savepv X<savepv>, savepvn X<savepvn>,
5351 savesharedpv X<savesharedpv>, savesvpv X<savesvpv>, StructCopy
5352 X<StructCopy>, Zero X<Zero>, ZeroD X<ZeroD>
5353
5354 =item Miscellaneous Functions
5355
5356 fbm_compile X<fbm_compile>, fbm_instr X<fbm_instr>, form X<form>, getcwd_sv
5357 X<getcwd_sv>, my_sprintf X<my_sprintf>, new_version X<new_version>,
5358 scan_version X<scan_version>, strEQ X<strEQ>, strGE X<strGE>, strGT
5359 X<strGT>, strLE X<strLE>, strLT X<strLT>, strNE X<strNE>, strnEQ X<strnEQ>,
5360 strnNE X<strnNE>, sv_nosharing X<sv_nosharing>, upg_version X<upg_version>,
5361 vcmp X<vcmp>, vnormal X<vnormal>, vnumify X<vnumify>, vstringify
5362 X<vstringify>, vverify X<vverify>
5363
5364 =item Multicall Functions
5365
5366 dMULTICALL X<dMULTICALL>, MULTICALL X<MULTICALL>, POP_MULTICALL
5367 X<POP_MULTICALL>, PUSH_MULTICALL X<PUSH_MULTICALL>
5368
5369 =item Numeric functions
5370
5371 grok_bin X<grok_bin>, grok_hex X<grok_hex>, grok_number X<grok_number>,
5372 grok_numeric_radix X<grok_numeric_radix>, grok_oct X<grok_oct>, scan_bin
5373 X<scan_bin>, scan_hex X<scan_hex>, scan_oct X<scan_oct>
5374
5375 =item Optree Manipulation Functions
5376
5377 cv_const_sv X<cv_const_sv>, newCONSTSUB X<newCONSTSUB>, newXS X<newXS>
5378
5379 =item Pad Data Structures
5380
5381 pad_sv X<pad_sv>
5382
5383 =item Simple Exception Handling Macros
5384
5385 dXCPT X<dXCPT>, XCPT_CATCH X<XCPT_CATCH>, XCPT_RETHROW X<XCPT_RETHROW>,
5386 XCPT_TRY_END X<XCPT_TRY_END>, XCPT_TRY_START X<XCPT_TRY_START>
5387
5388 =item Stack Manipulation Macros
5389
5390 dMARK X<dMARK>, dORIGMARK X<dORIGMARK>, dSP X<dSP>, EXTEND X<EXTEND>, MARK
5391 X<MARK>, mPUSHi X<mPUSHi>, mPUSHn X<mPUSHn>, mPUSHp X<mPUSHp>, mPUSHu
5392 X<mPUSHu>, mXPUSHi X<mXPUSHi>, mXPUSHn X<mXPUSHn>, mXPUSHp X<mXPUSHp>,
5393 mXPUSHu X<mXPUSHu>, ORIGMARK X<ORIGMARK>, POPi X<POPi>, POPl X<POPl>, POPn
5394 X<POPn>, POPp X<POPp>, POPpbytex X<POPpbytex>, POPpx X<POPpx>, POPs
5395 X<POPs>, PUSHi X<PUSHi>, PUSHMARK X<PUSHMARK>, PUSHmortal X<PUSHmortal>,
5396 PUSHn X<PUSHn>, PUSHp X<PUSHp>, PUSHs X<PUSHs>, PUSHu X<PUSHu>, PUTBACK
5397 X<PUTBACK>, SP X<SP>, SPAGAIN X<SPAGAIN>, XPUSHi X<XPUSHi>, XPUSHmortal
5398 X<XPUSHmortal>, XPUSHn X<XPUSHn>, XPUSHp X<XPUSHp>, XPUSHs X<XPUSHs>,
5399 XPUSHu X<XPUSHu>, XSRETURN X<XSRETURN>, XSRETURN_EMPTY X<XSRETURN_EMPTY>,
5400 XSRETURN_IV X<XSRETURN_IV>, XSRETURN_NO X<XSRETURN_NO>, XSRETURN_NV
5401 X<XSRETURN_NV>, XSRETURN_PV X<XSRETURN_PV>, XSRETURN_UNDEF
5402 X<XSRETURN_UNDEF>, XSRETURN_UV X<XSRETURN_UV>, XSRETURN_YES
5403 X<XSRETURN_YES>, XST_mIV X<XST_mIV>, XST_mNO X<XST_mNO>, XST_mNV
5404 X<XST_mNV>, XST_mPV X<XST_mPV>, XST_mUNDEF X<XST_mUNDEF>, XST_mYES
5405 X<XST_mYES>
5406
5407 =item SV Flags
5408
5409 svtype X<svtype>, SVt_IV X<SVt_IV>, SVt_NV X<SVt_NV>, SVt_PV X<SVt_PV>,
5410 SVt_PVAV X<SVt_PVAV>, SVt_PVCV X<SVt_PVCV>, SVt_PVHV X<SVt_PVHV>, SVt_PVMG
5411 X<SVt_PVMG>
5412
5413 =item SV Manipulation Functions
5414
5415 get_sv X<get_sv>, looks_like_number X<looks_like_number>, newRV_inc
5416 X<newRV_inc>, newRV_noinc X<newRV_noinc>, NEWSV X<NEWSV>, newSV X<newSV>,
5417 newSVhek X<newSVhek>, newSViv X<newSViv>, newSVnv X<newSVnv>, newSVpv
5418 X<newSVpv>, newSVpvf X<newSVpvf>, newSVpvn X<newSVpvn>, newSVpvn_share
5419 X<newSVpvn_share>, newSVrv X<newSVrv>, newSVsv X<newSVsv>, newSVuv
5420 X<newSVuv>, SvCUR X<SvCUR>, SvCUR_set X<SvCUR_set>, SvEND X<SvEND>, SvGROW
5421 X<SvGROW>, SvIOK X<SvIOK>, SvIOKp X<SvIOKp>, SvIOK_notUV X<SvIOK_notUV>,
5422 SvIOK_off X<SvIOK_off>, SvIOK_on X<SvIOK_on>, SvIOK_only X<SvIOK_only>,
5423 SvIOK_only_UV X<SvIOK_only_UV>, SvIOK_UV X<SvIOK_UV>, SvIsCOW X<SvIsCOW>,
5424 SvIsCOW_shared_hash X<SvIsCOW_shared_hash>, SvIV X<SvIV>, SvIVX X<SvIVX>,
5425 SvIVx X<SvIVx>, SvIV_nomg X<SvIV_nomg>, SvIV_set X<SvIV_set>, SvLEN
5426 X<SvLEN>, SvLEN_set X<SvLEN_set>, SvMAGIC_set X<SvMAGIC_set>, SvNIOK
5427 X<SvNIOK>, SvNIOKp X<SvNIOKp>, SvNIOK_off X<SvNIOK_off>, SvNOK X<SvNOK>,
5428 SvNOKp X<SvNOKp>, SvNOK_off X<SvNOK_off>, SvNOK_on X<SvNOK_on>, SvNOK_only
5429 X<SvNOK_only>, SvNV X<SvNV>, SvNVX X<SvNVX>, SvNVx X<SvNVx>, SvNV_set
5430 X<SvNV_set>, SvOK X<SvOK>, SvOOK X<SvOOK>, SvPOK X<SvPOK>, SvPOKp
5431 X<SvPOKp>, SvPOK_off X<SvPOK_off>, SvPOK_on X<SvPOK_on>, SvPOK_only
5432 X<SvPOK_only>, SvPOK_only_UTF8 X<SvPOK_only_UTF8>, SvPV X<SvPV>, SvPVbyte
5433 X<SvPVbyte>, SvPVbytex X<SvPVbytex>, SvPVbytex_force X<SvPVbytex_force>,
5434 SvPVbyte_force X<SvPVbyte_force>, SvPVbyte_nolen X<SvPVbyte_nolen>,
5435 SvPVutf8 X<SvPVutf8>, SvPVutf8x X<SvPVutf8x>, SvPVutf8x_force
5436 X<SvPVutf8x_force>, SvPVutf8_force X<SvPVutf8_force>, SvPVutf8_nolen
5437 X<SvPVutf8_nolen>, SvPVX X<SvPVX>, SvPVx X<SvPVx>, SvPV_force
5438 X<SvPV_force>, SvPV_force_nomg X<SvPV_force_nomg>, SvPV_nolen
5439 X<SvPV_nolen>, SvPV_nomg X<SvPV_nomg>, SvPV_set X<SvPV_set>, SvREFCNT
5440 X<SvREFCNT>, SvREFCNT_dec X<SvREFCNT_dec>, SvREFCNT_inc X<SvREFCNT_inc>,
5441 SvROK X<SvROK>, SvROK_off X<SvROK_off>, SvROK_on X<SvROK_on>, SvRV X<SvRV>,
5442 SvRV_set X<SvRV_set>, SvSTASH X<SvSTASH>, SvSTASH_set X<SvSTASH_set>,
5443 SvTAINT X<SvTAINT>, SvTAINTED X<SvTAINTED>, SvTAINTED_off X<SvTAINTED_off>,
5444 SvTAINTED_on X<SvTAINTED_on>, SvTRUE X<SvTRUE>, SvTYPE X<SvTYPE>, SvUOK
5445 X<SvUOK>, SvUPGRADE X<SvUPGRADE>, SvUTF8 X<SvUTF8>, SvUTF8_off
5446 X<SvUTF8_off>, SvUTF8_on X<SvUTF8_on>, SvUV X<SvUV>, SvUVX X<SvUVX>, SvUVx
5447 X<SvUVx>, SvUV_nomg X<SvUV_nomg>, SvUV_set X<SvUV_set>, SvVOK X<SvVOK>,
5448 sv_2bool X<sv_2bool>, sv_2cv X<sv_2cv>, sv_2io X<sv_2io>, sv_2iv_flags
5449 X<sv_2iv_flags>, sv_2mortal X<sv_2mortal>, sv_2nv X<sv_2nv>, sv_2pvbyte
5450 X<sv_2pvbyte>, sv_2pvutf8 X<sv_2pvutf8>, sv_2pv_flags X<sv_2pv_flags>,
5451 sv_2uv_flags X<sv_2uv_flags>, sv_backoff X<sv_backoff>, sv_bless
5452 X<sv_bless>, sv_catpv X<sv_catpv>, sv_catpvf X<sv_catpvf>, sv_catpvf_mg
5453 X<sv_catpvf_mg>, sv_catpvn X<sv_catpvn>, sv_catpvn_flags
5454 X<sv_catpvn_flags>, sv_catpvn_nomg X<sv_catpvn_nomg>, sv_catpv_mg
5455 X<sv_catpv_mg>, sv_catsv X<sv_catsv>, sv_catsv_flags X<sv_catsv_flags>,
5456 sv_catsv_nomg X<sv_catsv_nomg>, sv_chop X<sv_chop>, sv_clear X<sv_clear>,
5457 sv_cmp X<sv_cmp>, sv_cmp_locale X<sv_cmp_locale>, sv_collxfrm
5458 X<sv_collxfrm>, sv_copypv X<sv_copypv>, sv_dec X<sv_dec>, sv_derived_from
5459 X<sv_derived_from>, sv_eq X<sv_eq>, sv_force_normal_flags
5460 X<sv_force_normal_flags>, sv_free X<sv_free>, sv_gets X<sv_gets>, sv_grow
5461 X<sv_grow>, sv_inc X<sv_inc>, sv_insert X<sv_insert>, sv_isa X<sv_isa>,
5462 sv_isobject X<sv_isobject>, sv_len X<sv_len>, sv_len_utf8 X<sv_len_utf8>,
5463 sv_magic X<sv_magic>, sv_magicext X<sv_magicext>, sv_mortalcopy
5464 X<sv_mortalcopy>, sv_newmortal X<sv_newmortal>, sv_newref X<sv_newref>,
5465 sv_pos_b2u X<sv_pos_b2u>, sv_pos_u2b X<sv_pos_u2b>, sv_pvbyten_force
5466 X<sv_pvbyten_force>, sv_pvn_force X<sv_pvn_force>, sv_pvn_force_flags
5467 X<sv_pvn_force_flags>, sv_pvutf8n_force X<sv_pvutf8n_force>, sv_reftype
5468 X<sv_reftype>, sv_replace X<sv_replace>, sv_report_used X<sv_report_used>,
5469 sv_reset X<sv_reset>, sv_rvweaken X<sv_rvweaken>, sv_setiv X<sv_setiv>,
5470 sv_setiv_mg X<sv_setiv_mg>, sv_setnv X<sv_setnv>, sv_setnv_mg
5471 X<sv_setnv_mg>, sv_setpv X<sv_setpv>, sv_setpvf X<sv_setpvf>, sv_setpvf_mg
5472 X<sv_setpvf_mg>, sv_setpviv X<sv_setpviv>, sv_setpviv_mg X<sv_setpviv_mg>,
5473 sv_setpvn X<sv_setpvn>, sv_setpvn_mg X<sv_setpvn_mg>, sv_setpv_mg
5474 X<sv_setpv_mg>, sv_setref_iv X<sv_setref_iv>, sv_setref_nv X<sv_setref_nv>,
5475 sv_setref_pv X<sv_setref_pv>, sv_setref_pvn X<sv_setref_pvn>, sv_setref_uv
5476 X<sv_setref_uv>, sv_setsv X<sv_setsv>, sv_setsv_flags X<sv_setsv_flags>,
5477 sv_setsv_mg X<sv_setsv_mg>, sv_setsv_nomg X<sv_setsv_nomg>, sv_setuv
5478 X<sv_setuv>, sv_setuv_mg X<sv_setuv_mg>, sv_tainted X<sv_tainted>, sv_true
5479 X<sv_true>, sv_unmagic X<sv_unmagic>, sv_unref_flags X<sv_unref_flags>,
5480 sv_untaint X<sv_untaint>, sv_upgrade X<sv_upgrade>, sv_usepvn X<sv_usepvn>,
5481 sv_usepvn_mg X<sv_usepvn_mg>, sv_utf8_decode X<sv_utf8_decode>,
5482 sv_utf8_downgrade X<sv_utf8_downgrade>, sv_utf8_encode X<sv_utf8_encode>,
5483 sv_utf8_upgrade X<sv_utf8_upgrade>, sv_utf8_upgrade_flags
5484 X<sv_utf8_upgrade_flags>, sv_vcatpvf X<sv_vcatpvf>, sv_vcatpvfn
5485 X<sv_vcatpvfn>, sv_vcatpvf_mg X<sv_vcatpvf_mg>, sv_vsetpvf X<sv_vsetpvf>,
5486 sv_vsetpvfn X<sv_vsetpvfn>, sv_vsetpvf_mg X<sv_vsetpvf_mg>
5487
5488 =item Unicode Support
5489
5490 bytes_from_utf8 X<bytes_from_utf8>, bytes_to_utf8 X<bytes_to_utf8>,
5491 ibcmp_utf8 X<ibcmp_utf8>, is_utf8_char X<is_utf8_char>, is_utf8_string
5492 X<is_utf8_string>, is_utf8_string_loc X<is_utf8_string_loc>,
5493 is_utf8_string_loclen X<is_utf8_string_loclen>, pv_uni_display
5494 X<pv_uni_display>, sv_cat_decode X<sv_cat_decode>, sv_recode_to_utf8
5495 X<sv_recode_to_utf8>, sv_uni_display X<sv_uni_display>, to_utf8_case
5496 X<to_utf8_case>, to_utf8_fold X<to_utf8_fold>, to_utf8_lower
5497 X<to_utf8_lower>, to_utf8_title X<to_utf8_title>, to_utf8_upper
5498 X<to_utf8_upper>, utf8n_to_uvchr X<utf8n_to_uvchr>, utf8n_to_uvuni
5499 X<utf8n_to_uvuni>, utf8_distance X<utf8_distance>, utf8_hop X<utf8_hop>,
5500 utf8_length X<utf8_length>, utf8_to_bytes X<utf8_to_bytes>, utf8_to_uvchr
5501 X<utf8_to_uvchr>, utf8_to_uvuni X<utf8_to_uvuni>, uvchr_to_utf8
5502 X<uvchr_to_utf8>, uvuni_to_utf8_flags X<uvuni_to_utf8_flags>
5503
5504 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
5505
5506 ax X<ax>, CLASS X<CLASS>, dAX X<dAX>, dAXMARK X<dAXMARK>, dITEMS X<dITEMS>,
5507 dUNDERBAR X<dUNDERBAR>, dXSARGS X<dXSARGS>, dXSI32 X<dXSI32>, items
5508 X<items>, ix X<ix>, newXSproto X<newXSproto>, RETVAL X<RETVAL>, ST X<ST>,
5509 THIS X<THIS>, UNDERBAR X<UNDERBAR>, XS X<XS>, XS_VERSION X<XS_VERSION>,
5510 XS_VERSION_BOOTCHECK X<XS_VERSION_BOOTCHECK>
5511
5512 =item Warning and Dieing
5513
5514 croak X<croak>, warn X<warn>
5515
5516 =item AUTHORS
5517
5518 =item SEE ALSO
5519
5520 =back
5521
5522 =head2 perlintern - autogenerated documentation of purely B<internal>
5523                  Perl functions
5524
5525 =over 4
5526
5527 =item DESCRIPTION
5528 X<internal Perl functions> X<interpreter functions>
5529
5530 =item CV reference counts and CvOUTSIDE
5531
5532 CvWEAKOUTSIDE X<CvWEAKOUTSIDE>
5533
5534 =item Functions in file pad.h
5535
5536 CX_CURPAD_SAVE X<CX_CURPAD_SAVE>, CX_CURPAD_SV X<CX_CURPAD_SV>, PAD_BASE_SV
5537 X<PAD_BASE_SV>, PAD_CLONE_VARS X<PAD_CLONE_VARS>, PAD_COMPNAME_FLAGS
5538 X<PAD_COMPNAME_FLAGS>, PAD_COMPNAME_GEN X<PAD_COMPNAME_GEN>,
5539 PAD_COMPNAME_GEN_set X<PAD_COMPNAME_GEN_set>, PAD_COMPNAME_OURSTASH
5540 X<PAD_COMPNAME_OURSTASH>, PAD_COMPNAME_PV X<PAD_COMPNAME_PV>,
5541 PAD_COMPNAME_TYPE X<PAD_COMPNAME_TYPE>, PAD_DUP X<PAD_DUP>,
5542 PAD_RESTORE_LOCAL X<PAD_RESTORE_LOCAL>, PAD_SAVE_LOCAL X<PAD_SAVE_LOCAL>,
5543 PAD_SAVE_SETNULLPAD X<PAD_SAVE_SETNULLPAD>, PAD_SETSV X<PAD_SETSV>,
5544 PAD_SET_CUR X<PAD_SET_CUR>, PAD_SET_CUR_NOSAVE X<PAD_SET_CUR_NOSAVE>,
5545 PAD_SV X<PAD_SV>, PAD_SVl X<PAD_SVl>, SAVECLEARSV X<SAVECLEARSV>,
5546 SAVECOMPPAD X<SAVECOMPPAD>, SAVEPADSV X<SAVEPADSV>
5547
5548 =item Functions in file pp_ctl.c
5549
5550 find_runcv X<find_runcv>
5551
5552 =item Global Variables
5553
5554 PL_DBsingle X<PL_DBsingle>, PL_DBsub X<PL_DBsub>, PL_DBtrace X<PL_DBtrace>,
5555 PL_dowarn X<PL_dowarn>, PL_last_in_gv X<PL_last_in_gv>, PL_ofs_sv
5556 X<PL_ofs_sv>, PL_rs X<PL_rs>
5557
5558 =item GV Functions
5559
5560 is_gv_magical X<is_gv_magical>, is_gv_magical_sv X<is_gv_magical_sv>
5561
5562 =item IO Functions
5563
5564 start_glob X<start_glob>
5565
5566 =item Magical Functions
5567
5568 mg_localize X<mg_localize>
5569
5570 =item Pad Data Structures
5571
5572 CvPADLIST X<CvPADLIST>, cv_clone X<cv_clone>, cv_dump X<cv_dump>,
5573 do_dump_pad X<do_dump_pad>, intro_my X<intro_my>, pad_add_anon
5574 X<pad_add_anon>, pad_add_name X<pad_add_name>, pad_alloc X<pad_alloc>,
5575 pad_block_start X<pad_block_start>, pad_check_dup X<pad_check_dup>,
5576 pad_findlex X<pad_findlex>, pad_findmy X<pad_findmy>, pad_fixup_inner_anons
5577 X<pad_fixup_inner_anons>, pad_free X<pad_free>, pad_leavemy X<pad_leavemy>,
5578 pad_new X<pad_new>, pad_push X<pad_push>, pad_reset X<pad_reset>, pad_setsv
5579 X<pad_setsv>, pad_swipe X<pad_swipe>, pad_tidy X<pad_tidy>, pad_undef
5580 X<pad_undef>
5581
5582 =item Stack Manipulation Macros
5583
5584 djSP X<djSP>, LVRET X<LVRET>
5585
5586 =item SV Manipulation Functions
5587
5588 sv_add_arena X<sv_add_arena>, sv_clean_all X<sv_clean_all>, sv_clean_objs
5589 X<sv_clean_objs>, sv_free_arenas X<sv_free_arenas>
5590
5591 =item Unicode Support
5592
5593 find_uninit_var X<find_uninit_var>, report_uninit X<report_uninit>
5594
5595 =item AUTHORS
5596
5597 =item SEE ALSO
5598
5599 =back
5600
5601 =head2 perliol - C API for Perl's implementation of IO in Layers.
5602
5603 =over 4
5604
5605 =item SYNOPSIS
5606
5607 =item DESCRIPTION
5608
5609 =over 4
5610
5611 =item History and Background
5612
5613 =item Basic Structure
5614
5615 =item Layers vs Disciplines
5616
5617 =item Data Structures
5618
5619 =item Functions and Attributes
5620
5621 =item Per-instance Data
5622
5623 =item Layers in action.
5624
5625 =item Per-instance flag bits
5626
5627 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
5628 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
5629 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
5630 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
5631
5632 =item Methods in Detail
5633
5634 fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF,
5635 PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode,
5636 Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof,
5637 Error,  Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
5638 Set_ptrcnt
5639
5640 =item Utilities
5641
5642 =item Implementing PerlIO Layers
5643
5644 C implementations, Perl implementations
5645
5646 =item Core Layers
5647
5648 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
5649
5650 =item Extension Layers
5651
5652 ":encoding", ":scalar", ":via"
5653
5654 =back
5655
5656 =item TODO
5657
5658 =back
5659
5660 =head2 perlapio - perl's IO abstraction interface.
5661
5662 =over 4
5663
5664 =item SYNOPSIS
5665
5666 =item DESCRIPTION
5667
5668 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
5669 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
5670 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
5671 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
5672 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
5673 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
5674 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
5675 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
5676 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
5677 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
5678 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
5679
5680 =over 4
5681
5682 =item Co-existence with stdio
5683
5684 B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
5685 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
5686
5687 =item "Fast gets" Functions
5688
5689 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
5690 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
5691 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
5692 B<PerlIO_get_bufsiz(f)>
5693
5694 =item Other Functions
5695
5696 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
5697 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
5698
5699 =back
5700
5701 =back
5702
5703 =head2 perlhack - How to hack at the Perl internals
5704
5705 =over 4
5706
5707 =item DESCRIPTION
5708
5709 Does concept match the general goals of Perl?, Where is the
5710 implementation?, Backwards compatibility, Could it be a module instead?, Is
5711 the feature generic enough?, Does it potentially introduce new bugs?, Does
5712 it preclude other desirable features?, Is the implementation robust?, Is
5713 the implementation generic enough to be portable?, Is the implementation
5714 tested?, Is there enough documentation?, Is there another way to do it?,
5715 Does it create too much work?, Patches speak louder than words
5716
5717 =over 4
5718
5719 =item Keeping in sync
5720
5721 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
5722 NFS, rsync'ing the patches
5723
5724 =item Why rsync the source tree
5725
5726 It's easier to rsync the source tree, It's more reliable
5727
5728 =item Why rsync the patches
5729
5730 It's easier to rsync the patches, It's a good reference, Finding a start
5731 point, Finding how to fix a bug, Finding the source of misbehaviour
5732
5733 =item Working with the source
5734
5735 =item Perlbug administration
5736
5737 =item Submitting patches
5738
5739 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
5740 F<Porting/pumpkin.pod>, The perl5-porters FAQ
5741
5742 =item Finding Your Way Around
5743
5744 Core modules, Tests, Documentation, Configure, Interpreter
5745
5746 =item Elements of the interpreter
5747
5748 Startup, Parsing, Optimization, Running, Exception handing
5749
5750 =item Internal Variable Types
5751
5752 =item Op Trees
5753
5754 =item Stacks
5755
5756 Argument stack, Mark stack, Save stack
5757
5758 =item Millions of Macros
5759
5760 =item The .i Targets
5761
5762 =item Poking at Perl
5763
5764 =item Using a source-level debugger
5765
5766 run [args], break function_name, break source.c:xxx, step, next, continue,
5767 finish, 'enter', print
5768
5769 =item gdb macro support
5770
5771 =item Dumping Perl Data Structures
5772
5773 =item Patching
5774
5775 =item Patching a core module
5776
5777 =item Adding a new function to the core
5778
5779 =item Writing a test
5780
5781 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5782 F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base t/comp,
5783 t/cmd t/run t/io t/op, t/lib ext lib
5784
5785 =item Special Make Test Targets
5786
5787 coretest, test.deparse, test.taintwarn, minitest, test.valgrind
5788 check.valgrind utest.valgrind ucheck.valgrind, test.third check.third
5789 utest.third ucheck.third, test.torture torturetest, utest ucheck test.utf8
5790 check.utf8, minitest.utf16 test.utf16, test_harness, test-notty test_notty
5791
5792 =item Running tests by hand
5793
5794 -v, -torture, -re=PATTERN, -re LIST OF PATTERNS, PERL_CORE=1,
5795 PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST
5796
5797 =back
5798
5799 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5800
5801 =over 4
5802
5803 =item Rational Software's Purify
5804
5805 =item Purify on Unix
5806
5807 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5808
5809 =item Purify on NT
5810
5811 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5812
5813 =item valgrind
5814
5815 =item Compaq's/Digital's/HP's Third Degree
5816
5817 =item PERL_DESTRUCT_LEVEL
5818
5819 =item PERL_MEM_LOG
5820
5821 =item Profiling
5822
5823 =item Gprof Profiling
5824
5825 -a, -b, -e routine, -f routine, -s, -z
5826
5827 =item GCC gcov Profiling
5828
5829 =item Pixie Profiling
5830
5831 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5832 -z[ero]
5833
5834 =item Miscellaneous tricks
5835
5836 =item CONCLUSION
5837
5838 I<The Road goes ever on and on, down from the door where it began.>
5839
5840 =back
5841
5842 =item AUTHOR
5843
5844 =back
5845
5846 =head2 perlbook - Perl book information
5847
5848 =over 4
5849
5850 =item DESCRIPTION
5851
5852 =back
5853
5854 =head2 perltodo - Perl TO-DO List
5855
5856 =over 4
5857
5858 =item DESCRIPTION
5859
5860 =item The roadmap to 5.10
5861
5862 =over 4
5863
5864 =item Needed for a 5.9.4 release
5865
5866 =item Needed for a 5.9.5 release
5867
5868 Implement L</_ prototype character>, Implement L</state variables>
5869
5870 =item Needed for a 5.9.6 release
5871
5872 =back
5873
5874 =item Tasks that only need Perl knowledge
5875
5876 =over 4
5877
5878 =item common test code for timed bail out
5879
5880 =item POD -> HTML conversion in the core still sucks
5881
5882 =item Parallel testing
5883
5884 =item Make Schwern poorer
5885
5886 =item Improve the coverage of the core tests
5887
5888 =item test B
5889
5890 =item A decent benchmark
5891
5892 =item fix tainting bugs
5893
5894 =item Dual life everything
5895
5896 =item Improving C<threads::shared>
5897
5898 =item POSIX memory footprint
5899
5900 =back
5901
5902 =item Tasks that need a little sysadmin-type knowledge
5903
5904 =over 4
5905
5906 =item Relocatable perl
5907
5908 =item make HTML install work
5909
5910 =item compressed man pages
5911
5912 =item Add a code coverage target to the Makefile
5913
5914 =item Make Config.pm cope with differences between build and installed perl
5915
5916 =item make parallel builds work
5917
5918 =item linker specification files
5919
5920 =back
5921
5922 =item Tasks that need a little C knowledge
5923
5924 =over 4
5925
5926 =item Make it clear from -v if this is the exact official release
5927
5928 =item Tidy up global variables
5929
5930 =item Ordering of "global" variables.
5931
5932 =item bincompat functions
5933
5934 =item am I hot or not?
5935
5936 =item emulate the per-thread memory pool on Unix
5937
5938 =item reduce duplication in sv_setsv_flags
5939
5940 =back
5941
5942 =item Tasks that need a knowledge of XS
5943
5944 =over 4
5945
5946 =item IPv6
5947
5948 =item shrink C<GV>s, C<CV>s
5949
5950 =item merge Perl_sv_2[inpu]v
5951
5952 =item UTF8 caching code
5953
5954 =item Implicit Latin 1 => Unicode translation
5955
5956 =item autovivification
5957
5958 =item Unicode in Filenames
5959
5960 =item Unicode in %ENV
5961
5962 =item use less 'memory'
5963
5964 =item Re-implement C<:unique> in a way that is actually thread-safe
5965
5966 =item Make tainting consistent
5967
5968 =item readpipe(LIST)
5969
5970 =back
5971
5972 =item Tasks that need a knowledge of the interpreter
5973
5974 =over 4
5975
5976 =item lexical pragmas
5977
5978 =item Attach/detach debugger from running program
5979
5980 =item Constant folding
5981
5982 =item LVALUE functions for lists
5983
5984 =item LVALUE functions in the debugger
5985
5986 =item _ prototype character
5987
5988 =item state variables
5989
5990 =item @INC source filter to Filter::Simple
5991
5992 =item regexp optimiser optional
5993
5994 =item UNITCHECK
5995
5996 =item optional optimizer
5997
5998 =item You WANT *how* many
5999
6000 =item lexical aliases
6001
6002 =item entersub XS vs Perl
6003
6004 =item Self ties
6005
6006 =item Optimize away @_
6007
6008 =item What hooks would assertions need?
6009
6010 =back
6011
6012 =item Big projects
6013
6014 =over 4
6015
6016 =item make ithreads more robust
6017
6018 =item iCOW
6019
6020 =item (?{...}) closures in regexps
6021
6022 =item A re-entrant regexp engine
6023
6024 =back
6025
6026 =back
6027
6028 =head2 perldoc - Look up Perl documentation in Pod format.
6029
6030 =over 4
6031
6032 =item SYNOPSIS
6033
6034 =item DESCRIPTION
6035
6036 =item OPTIONS
6037
6038 B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
6039 I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
6040 I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
6041 B<-w> I<option:value> or B<-w> I<option>, B<-X>, B<-L> I<language_code>,
6042 B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
6043 B<-V>
6044
6045 =item SECURITY
6046
6047 =item ENVIRONMENT
6048
6049 =item AUTHOR
6050
6051 =back
6052
6053 =head2 perlhist - the Perl history records
6054
6055 =over 4
6056
6057 =item DESCRIPTION
6058
6059 =item INTRODUCTION
6060
6061 =item THE KEEPERS OF THE PUMPKIN
6062
6063 =over 4
6064
6065 =item PUMPKIN?
6066
6067 =back
6068
6069 =item THE RECORDS
6070
6071 =over 4
6072
6073 =item SELECTED RELEASE SIZES
6074
6075 =item SELECTED PATCH SIZES
6076
6077 =back
6078
6079 =item THE KEEPERS OF THE RECORDS
6080
6081 =back
6082
6083 =head2 perldelta - what is new for perl v5.9.3
6084
6085 =over 4
6086
6087 =item DESCRIPTION
6088
6089 =item Incompatible Changes
6090
6091 =over 4
6092
6093 =item Parsing of C<-f _>
6094
6095 =item C<mkdir()>
6096
6097 =item Magic goto and eval
6098
6099 =item C<$#> has been removed
6100
6101 =item C<:unique>
6102
6103 =back
6104
6105 =item Core Enhancements
6106
6107 =over 4
6108
6109 =item Switch and Smart Match operator
6110
6111 =item C<say()>
6112
6113 =item C<CLONE_SKIP()>
6114
6115 =item C<${^CHILD_ERROR_NATIVE}>
6116
6117 =item Assertions
6118
6119 =item Unicode Character Database 4.1.0
6120
6121 =item C<no VERSION>
6122
6123 =back
6124
6125 =item Modules and Pragmata
6126
6127 =over 4
6128
6129 =item C<feature>
6130
6131 =item C<assertions::compat>
6132
6133 =item C<Math::BigInt::FastCalc>
6134
6135 =item C<Compress::Zlib>
6136
6137 =item C<IO::Zlib>
6138
6139 =item C<Archive::Tar>
6140
6141 =back
6142
6143 =item Utility Changes
6144
6145 =over 4
6146
6147 =item C<ptar>
6148
6149 =back
6150
6151 =item Documentation
6152
6153 =over 4
6154
6155 =item Perl Glossary
6156
6157 =back
6158
6159 =item Performance Enhancements
6160
6161 =item Installation and Configuration Improvements
6162
6163 =over 4
6164
6165 =item New Or Improved Platforms
6166
6167 =item Module auxiliary files
6168
6169 =back
6170
6171 =item Selected Bug Fixes
6172
6173 =over 4
6174
6175 =item C<defined $$x>
6176
6177 =item Smaller fixes
6178
6179 =item More Unicode Fixes
6180
6181 =back
6182
6183 =item New or Changed Diagnostics
6184
6185 =over 4
6186
6187 =item Attempt to set length of freed array
6188
6189 =item Search pattern not terminated or ternary operator parsed as search
6190 pattern
6191
6192 =item "%s" variable %s masks earlier declaration
6193
6194 =back
6195
6196 =item Changed Internals
6197
6198 =over 4
6199
6200 =item B:: modules inheritance changed
6201
6202 =back
6203
6204 =item Known Problems
6205
6206 =over 4
6207
6208 =item Platform Specific Problems
6209
6210 =back
6211
6212 =item Reporting Bugs
6213
6214 =item SEE ALSO
6215
6216 =back
6217
6218 =head2 perl593delta, perldelta - what is new for perl v5.9.3
6219
6220 =over 4
6221
6222 =item DESCRIPTION
6223
6224 =item Incompatible Changes
6225
6226 =over 4
6227
6228 =item Parsing of C<-f _>
6229
6230 =item C<mkdir()>
6231
6232 =item Magic goto and eval
6233
6234 =item C<$#> has been removed
6235
6236 =item C<:unique>
6237
6238 =back
6239
6240 =item Core Enhancements
6241
6242 =over 4
6243
6244 =item Switch and Smart Match operator
6245
6246 =item C<say()>
6247
6248 =item C<CLONE_SKIP()>
6249
6250 =item C<${^CHILD_ERROR_NATIVE}>
6251
6252 =item Assertions
6253
6254 =item Unicode Character Database 4.1.0
6255
6256 =item C<no VERSION>
6257
6258 =back
6259
6260 =item Modules and Pragmata
6261
6262 =over 4
6263
6264 =item C<feature>
6265
6266 =item C<assertions::compat>
6267
6268 =item C<Math::BigInt::FastCalc>
6269
6270 =item C<Compress::Zlib>
6271
6272 =item C<IO::Zlib>
6273
6274 =item C<Archive::Tar>
6275
6276 =back
6277
6278 =item Utility Changes
6279
6280 =over 4
6281
6282 =item C<ptar>
6283
6284 =back
6285
6286 =item Documentation
6287
6288 =over 4
6289
6290 =item Perl Glossary
6291
6292 =back
6293
6294 =item Performance Enhancements
6295
6296 =item Installation and Configuration Improvements
6297
6298 =over 4
6299
6300 =item New Or Improved Platforms
6301
6302 =item Module auxiliary files
6303
6304 =back
6305
6306 =item Selected Bug Fixes
6307
6308 =over 4
6309
6310 =item C<defined $$x>
6311
6312 =item Smaller fixes
6313
6314 =item More Unicode Fixes
6315
6316 =back
6317
6318 =item New or Changed Diagnostics
6319
6320 =over 4
6321
6322 =item Attempt to set length of freed array
6323
6324 =item Search pattern not terminated or ternary operator parsed as search
6325 pattern
6326
6327 =item "%s" variable %s masks earlier declaration
6328
6329 =back
6330
6331 =item Changed Internals
6332
6333 =over 4
6334
6335 =item B:: modules inheritance changed
6336
6337 =back
6338
6339 =item Known Problems
6340
6341 =over 4
6342
6343 =item Platform Specific Problems
6344
6345 =back
6346
6347 =item Reporting Bugs
6348
6349 =item SEE ALSO
6350
6351 =back
6352
6353 =head2 perl592delta, perldelta - what is new for perl v5.9.2
6354
6355 =over 4
6356
6357 =item DESCRIPTION
6358
6359 =item Incompatible Changes
6360
6361 =over 4
6362
6363 =item Packing and UTF-8 strings
6364
6365 =item Miscellaneous
6366
6367 =back
6368
6369 =item Core Enhancements
6370
6371 =over 4
6372
6373 =item Malloc wrapping
6374
6375 =item Unicode Character Database 4.0.1
6376
6377 =item suidperl less insecure
6378
6379 =item PERLIO_DEBUG
6380
6381 =item Formats
6382
6383 =item Unicode Character Classes
6384
6385 =item Byte-order modifiers for pack() and unpack()
6386
6387 =item Byte count feature in pack()
6388
6389 =item New variables
6390
6391 =back
6392
6393 =item Modules and Pragmata
6394
6395 =over 4
6396
6397 =item New modules
6398
6399 =item Updated And Improved Modules and Pragmata
6400
6401 B::Concise, Socket, Sys::Syslog, threads
6402
6403 =back
6404
6405 =item Utility Changes
6406
6407 =item Performance Enhancements
6408
6409 =item Installation and Configuration Improvements
6410
6411 =item Selected Bug Fixes
6412
6413 =item New or Changed Diagnostics
6414
6415 =item Changed Internals
6416
6417 =item Known Problems
6418
6419 =item Plans for the next release
6420
6421 =item Reporting Bugs
6422
6423 =item SEE ALSO
6424
6425 =back
6426
6427 =head2 perl591delta, perldelta - what is new for perl v5.9.1
6428
6429 =over 4
6430
6431 =item DESCRIPTION
6432
6433 =item Incompatible Changes
6434
6435 =over 4
6436
6437 =item substr() lvalues are no longer fixed-length
6438
6439 =item The C<:unique> attribute is only meaningful for globals
6440
6441 =back
6442
6443 =item Core Enhancements
6444
6445 =over 4
6446
6447 =item Lexical C<$_>
6448
6449 =item Tied hashes in scalar context
6450
6451 =item Formats
6452
6453 =item Stacked filetest operators
6454
6455 =back
6456
6457 =item Modules and Pragmata
6458
6459 Benchmark, Carp, Exporter, FindBin, List::Util, threads::shared
6460
6461 =item Utility Changes
6462
6463 =item Documentation
6464
6465 =item Performance Enhancements
6466
6467 =item Selected Bug Fixes
6468
6469 =over 4
6470
6471 =item UTF-8 bugs
6472
6473 =item Threading bugs
6474
6475 =item More bugs
6476
6477 =back
6478
6479 =item New or Changed Diagnostics
6480
6481 =item Changed Internals
6482
6483 =over 4
6484
6485 =item Reordering of SVt_* constants
6486
6487 =item Removal of CPP symbols
6488
6489 =item Less space is used by ops
6490
6491 =item New parser
6492
6493 =back
6494
6495 =item Configuration and Building
6496
6497 =item Known Problems
6498
6499 =over 4
6500
6501 =item Platform Specific Problems
6502
6503 =back
6504
6505 =item To-do for perl 5.10.0
6506
6507 =item Reporting Bugs
6508
6509 =item SEE ALSO
6510
6511 =back
6512
6513 =head2 perl590delta, perldelta - what is new for perl v5.9.0
6514
6515 =over 4
6516
6517 =item DESCRIPTION
6518
6519 =item Incompatible Changes
6520
6521 =over 4
6522
6523 =item Hash Randomisation
6524
6525 =item UTF-8 On Filehandles No Longer Activated By Locale
6526
6527 =item Single-number v-strings are no longer v-strings before "=>"
6528
6529 =item (Win32) The -C Switch Has Been Repurposed
6530
6531 =item (Win32) The /d Switch Of cmd.exe
6532
6533 =item The C<$*> variable has been removed
6534
6535 =back
6536
6537 =item Core Enhancements
6538
6539 =over 4
6540
6541 =item Assertions
6542
6543 =item Defined-or operators
6544
6545 =item UTF-8 no longer default under UTF-8 locales
6546
6547 =item Unsafe signals again available
6548
6549 =item Tied Arrays with Negative Array Indices
6550
6551 =item local ${$x}
6552
6553 =item Unicode Character Database 4.0.0
6554
6555 =item Miscellaneous Enhancements
6556
6557 =back
6558
6559 =item Modules and Pragmata
6560
6561 =over 4
6562
6563 =item Updated Modules And Pragmata
6564
6565 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
6566 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
6567 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
6568 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
6569 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
6570 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
6571 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
6572 Win32::GetOSVersion
6573
6574 =back
6575
6576 =item Utility Changes
6577
6578 =item New Documentation
6579
6580 =item Performance Enhancements
6581
6582 =item Installation and Configuration Improvements
6583
6584 =over 4
6585
6586 =item Platform-specific enhancements
6587
6588 =back
6589
6590 =item Selected Bug Fixes
6591
6592 =over 4
6593
6594 =item Closures, eval and lexicals
6595
6596 =item Generic fixes
6597
6598 =item Platform-specific fixes
6599
6600 =back
6601
6602 =item New or Changed Diagnostics
6603
6604 =over 4
6605
6606 =item Changed "A thread exited while %d threads were running"
6607
6608 =item Removed "Attempt to clear a restricted hash"
6609
6610 =item New "Illegal declaration of anonymous subroutine"
6611
6612 =item Changed "Invalid range "%s" in transliteration operator"
6613
6614 =item New "Missing control char name in \c"
6615
6616 =item New "Newline in left-justified string for %s"
6617
6618 =item New "Possible precedence problem on bitwise %c operator"
6619
6620 =item New "read() on %s filehandle %s"
6621
6622 =item New "Tied variable freed while still in use"
6623
6624 =item New "To%s: illegal mapping '%s'"
6625
6626 =item New "Use of freed value in iteration"
6627
6628 =back
6629
6630 =item Changed Internals
6631
6632 =item New Tests
6633
6634 =item Known Problems
6635
6636 =over 4
6637
6638 =item Tied hashes in scalar context
6639
6640 =item Net::Ping 450_service and 510_ping_udp failures
6641
6642 =item B::C
6643
6644 =back
6645
6646 =item Platform Specific Problems
6647
6648 =over 4
6649
6650 =item EBCDIC Platforms
6651
6652 =item Cygwin 1.5 problems
6653
6654 =item HP-UX: HP cc warnings about sendfile and sendpath
6655
6656 =item IRIX: t/uni/tr_7jis.t falsely failing
6657
6658 =item Mac OS X: no usemymalloc
6659
6660 =item Tru64: No threaded builds with GNU cc (gcc)
6661
6662 =item Win32: sysopen, sysread, syswrite
6663
6664 =back
6665
6666 =item TODO
6667
6668 =item Reporting Bugs
6669
6670 =item SEE ALSO
6671
6672 =back
6673
6674 =head2 perl587delta, perldelta - what is new for perl v5.8.7
6675
6676 =over 4
6677
6678 =item DESCRIPTION
6679
6680 =item Incompatible Changes
6681
6682 =item Core Enhancements
6683
6684 =over 4
6685
6686 =item Unicode Character Database 4.1.0
6687
6688 =item suidperl less insecure
6689
6690 =item Optional site customization script
6691
6692 =item C<Config.pm> is now much smaller.
6693
6694 =back
6695
6696 =item Modules and Pragmata
6697
6698 =item Utility Changes
6699
6700 =over 4
6701
6702 =item find2perl enhancements
6703
6704 =back
6705
6706 =item Performance Enhancements
6707
6708 =item Installation and Configuration Improvements
6709
6710 =item Selected Bug Fixes
6711
6712 =item New or Changed Diagnostics
6713
6714 =item Changed Internals
6715
6716 =item Known Problems
6717
6718 =item Platform Specific Problems
6719
6720 =item Reporting Bugs
6721
6722 =item SEE ALSO
6723
6724 =back
6725
6726 =head2 perl586delta - what is new for perl v5.8.6
6727
6728 =over 4
6729
6730 =item DESCRIPTION
6731
6732 =item Incompatible Changes
6733
6734 =item Core Enhancements
6735
6736 =item Modules and Pragmata
6737
6738 =item Utility Changes
6739
6740 =item Performance Enhancements
6741
6742 =item Selected Bug Fixes
6743
6744 =item New or Changed Diagnostics
6745
6746 =item Changed Internals
6747
6748 =item New Tests
6749
6750 =item Reporting Bugs
6751
6752 =item SEE ALSO
6753
6754 =back
6755
6756 =head2 perl585delta - what is new for perl v5.8.5
6757
6758 =over 4
6759
6760 =item DESCRIPTION
6761
6762 =item Incompatible Changes
6763
6764 =item Core Enhancements
6765
6766 =item Modules and Pragmata
6767
6768 =item Utility Changes
6769
6770 =over 4
6771
6772 =item Perl's debugger
6773
6774 =item h2ph
6775
6776 =back
6777
6778 =item Installation and Configuration Improvements
6779
6780 =item Selected Bug Fixes
6781
6782 =item New or Changed Diagnostics
6783
6784 =item Changed Internals
6785
6786 =item Known Problems
6787
6788 =item Platform Specific Problems
6789
6790 =item Reporting Bugs
6791
6792 =item SEE ALSO
6793
6794 =back
6795
6796 =head2 perl584delta - what is new for perl v5.8.4
6797
6798 =over 4
6799
6800 =item DESCRIPTION
6801
6802 =item Incompatible Changes
6803
6804 =item Core Enhancements
6805
6806 =over 4
6807
6808 =item Malloc wrapping
6809
6810 =item Unicode Character Database 4.0.1
6811
6812 =item suidperl less insecure
6813
6814 =item format
6815
6816 =back
6817
6818 =item Modules and Pragmata
6819
6820 =over 4
6821
6822 =item Updated modules
6823
6824 Attribute::Handlers, B, Benchmark, CGI, Carp, Cwd, Exporter, File::Find,
6825 IO, IPC::Open3, Local::Maketext, Math::BigFloat, Math::BigInt,
6826 Math::BigRat, MIME::Base64, ODBM_File, POSIX, Shell, Socket, Storable,
6827 Switch, Sys::Syslog, Term::ANSIColor, Time::HiRes, Unicode::UCD, Win32,
6828 base, open, threads, utf8
6829
6830 =back
6831
6832 =item Performance Enhancements
6833
6834 =item Utility Changes
6835
6836 =item Installation and Configuration Improvements
6837
6838 =item Selected Bug Fixes
6839
6840 =item New or Changed Diagnostics
6841
6842 =item Changed Internals
6843
6844 =item Future Directions
6845
6846 =item Platform Specific Problems
6847
6848 =item Reporting Bugs
6849
6850 =item SEE ALSO
6851
6852 =back
6853
6854 =head2 perl583delta - what is new for perl v5.8.3
6855
6856 =over 4
6857
6858 =item DESCRIPTION
6859
6860 =item Incompatible Changes
6861
6862 =item Core Enhancements
6863
6864 =item Modules and Pragmata
6865
6866 CGI, Cwd, Digest, Digest::MD5, Encode, File::Spec, FindBin, List::Util,
6867 Math::BigInt, PodParser, Pod::Perldoc, POSIX, Unicode::Collate,
6868 Unicode::Normalize, Test::Harness, threads::shared
6869
6870 =item Utility Changes
6871
6872 =item New Documentation
6873
6874 =item Installation and Configuration Improvements
6875
6876 =item Selected Bug Fixes
6877
6878 =item New or Changed Diagnostics
6879
6880 =item Changed Internals
6881
6882 =item Configuration and Building
6883
6884 =item Platform Specific Problems
6885
6886 =item Known Problems
6887
6888 =item Future Directions
6889
6890 =item Obituary
6891
6892 =item Reporting Bugs
6893
6894 =item SEE ALSO
6895
6896 =back
6897
6898 =head2 perl582delta - what is new for perl v5.8.2
6899
6900 =over 4
6901
6902 =item DESCRIPTION
6903
6904 =item Incompatible Changes
6905
6906 =item Core Enhancements
6907
6908 =over 4
6909
6910 =item Hash Randomisation
6911
6912 =item Threading
6913
6914 =back
6915
6916 =item Modules and Pragmata
6917
6918 =over 4
6919
6920 =item Updated Modules And Pragmata
6921
6922 Devel::PPPort, Digest::MD5, I18N::LangTags, libnet, MIME::Base64,
6923 Pod::Perldoc, strict, Tie::Hash, Time::HiRes, Unicode::Collate,
6924 Unicode::Normalize, UNIVERSAL
6925
6926 =back
6927
6928 =item Selected Bug Fixes
6929
6930 =item Changed Internals
6931
6932 =item Platform Specific Problems
6933
6934 =item Future Directions
6935
6936 =item Reporting Bugs
6937
6938 =item SEE ALSO
6939
6940 =back
6941
6942 =head2 perl581delta - what is new for perl v5.8.1
6943
6944 =over 4
6945
6946 =item DESCRIPTION
6947
6948 =item Incompatible Changes
6949
6950 =over 4
6951
6952 =item Hash Randomisation
6953
6954 =item UTF-8 On Filehandles No Longer Activated By Locale
6955
6956 =item Single-number v-strings are no longer v-strings before "=>"
6957
6958 =item (Win32) The -C Switch Has Been Repurposed
6959
6960 =item (Win32) The /d Switch Of cmd.exe
6961
6962 =back
6963
6964 =item Core Enhancements
6965
6966 =over 4
6967
6968 =item UTF-8 no longer default under UTF-8 locales
6969
6970 =item Unsafe signals again available
6971
6972 =item Tied Arrays with Negative Array Indices
6973
6974 =item local ${$x}
6975
6976 =item Unicode Character Database 4.0.0
6977
6978 =item Deprecation Warnings
6979
6980 =item Miscellaneous Enhancements
6981
6982 =back
6983
6984 =item Modules and Pragmata
6985
6986 =over 4
6987
6988 =item Updated Modules And Pragmata
6989
6990 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
6991 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
6992 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
6993 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
6994 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
6995 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
6996 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
6997 Win32::GetOSVersion
6998
6999 =back
7000
7001 =item Utility Changes
7002
7003 =item New Documentation
7004
7005 =item Installation and Configuration Improvements
7006
7007 =over 4
7008
7009 =item Platform-specific enhancements
7010
7011 =back
7012
7013 =item Selected Bug Fixes
7014
7015 =over 4
7016
7017 =item Closures, eval and lexicals
7018
7019 =item Generic fixes
7020
7021 =item Platform-specific fixes
7022
7023 =back
7024
7025 =item New or Changed Diagnostics
7026
7027 =over 4
7028
7029 =item Changed "A thread exited while %d threads were running"
7030
7031 =item Removed "Attempt to clear a restricted hash"
7032
7033 =item New "Illegal declaration of anonymous subroutine"
7034
7035 =item Changed "Invalid range "%s" in transliteration operator"
7036
7037 =item New "Missing control char name in \c"
7038
7039 =item New "Newline in left-justified string for %s"
7040
7041 =item New "Possible precedence problem on bitwise %c operator"
7042
7043 =item New "Pseudo-hashes are deprecated"
7044
7045 =item New "read() on %s filehandle %s"
7046
7047 =item New "5.005 threads are deprecated"
7048
7049 =item New "Tied variable freed while still in use"
7050
7051 =item New "To%s: illegal mapping '%s'"
7052
7053 =item New "Use of freed value in iteration"
7054
7055 =back
7056
7057 =item Changed Internals
7058
7059 =item New Tests
7060
7061 =item Known Problems
7062
7063 =over 4
7064
7065 =item Tied hashes in scalar context
7066
7067 =item Net::Ping 450_service and 510_ping_udp failures
7068
7069 =item B::C
7070
7071 =back
7072
7073 =item Platform Specific Problems
7074
7075 =over 4
7076
7077 =item EBCDIC Platforms
7078
7079 =item Cygwin 1.5 problems
7080
7081 =item HP-UX: HP cc warnings about sendfile and sendpath
7082
7083 =item IRIX: t/uni/tr_7jis.t falsely failing
7084
7085 =item Mac OS X: no usemymalloc
7086
7087 =item Tru64: No threaded builds with GNU cc (gcc)
7088
7089 =item Win32: sysopen, sysread, syswrite
7090
7091 =back
7092
7093 =item Future Directions
7094
7095 =item Reporting Bugs
7096
7097 =item SEE ALSO
7098
7099 =back
7100
7101 =head2 perl58delta - what is new for perl v5.8.0
7102
7103 =over 4
7104
7105 =item DESCRIPTION
7106
7107 =item Highlights In 5.8.0
7108
7109 =item Incompatible Changes
7110
7111 =over 4
7112
7113 =item Binary Incompatibility
7114
7115 =item 64-bit platforms and malloc
7116
7117 =item AIX Dynaloading
7118
7119 =item Attributes for C<my> variables now handled at run-time
7120
7121 =item Socket Extension Dynamic in VMS
7122
7123 =item IEEE-format Floating Point Default on OpenVMS Alpha
7124
7125 =item New Unicode Semantics (no more C<use utf8>, almost)
7126
7127 =item New Unicode Properties
7128
7129 =item REF(...) Instead Of SCALAR(...)
7130
7131 =item pack/unpack D/F recycled
7132
7133 =item glob() now returns filenames in alphabetical order
7134
7135 =item Deprecations
7136
7137 =back
7138
7139 =item Core Enhancements
7140
7141 =over 4
7142
7143 =item Unicode Overhaul
7144
7145 =item PerlIO is Now The Default
7146
7147 =item ithreads
7148
7149 =item Restricted Hashes
7150
7151 =item Safe Signals
7152
7153 =item Understanding of Numbers
7154
7155 =item Arrays now always interpolate into double-quoted strings [561]
7156
7157 =item Miscellaneous Changes
7158
7159 =back
7160
7161 =item Modules and Pragmata
7162
7163 =over 4
7164
7165 =item New Modules and Pragmata
7166
7167 =item Updated And Improved Modules and Pragmata
7168
7169 =back
7170
7171 =item Utility Changes
7172
7173 =item New Documentation
7174
7175 =item Performance Enhancements
7176
7177 =item Installation and Configuration Improvements
7178
7179 =over 4
7180
7181 =item Generic Improvements
7182
7183 =item New Or Improved Platforms
7184
7185 =back
7186
7187 =item Selected Bug Fixes
7188
7189 =over 4
7190
7191 =item Platform Specific Changes and Fixes
7192
7193 =back
7194
7195 =item New or Changed Diagnostics
7196
7197 =item Changed Internals
7198
7199 =item Security Vulnerability Closed [561]
7200
7201 =item New Tests
7202
7203 =item Known Problems
7204
7205 =over 4
7206
7207 =item The Compiler Suite Is Still Very Experimental
7208
7209 =item Localising Tied Arrays and Hashes Is Broken
7210
7211 =item Building Extensions Can Fail Because Of Largefiles
7212
7213 =item Modifying $_ Inside for(..)
7214
7215 =item mod_perl 1.26 Doesn't Build With Threaded Perl
7216
7217 =item lib/ftmp-security tests warn 'system possibly insecure'
7218
7219 =item libwww-perl (LWP) fails base/date #51
7220
7221 =item PDL failing some tests
7222
7223 =item Perl_get_sv
7224
7225 =item Self-tying Problems
7226
7227 =item ext/threads/t/libc
7228
7229 =item Failure of Thread (5.005-style) tests
7230
7231 =item Timing problems
7232
7233 =item Tied/Magical Array/Hash Elements Do Not Autovivify
7234
7235 =item Unicode in package/class and subroutine names does not work
7236
7237 =back
7238
7239 =item Platform Specific Problems
7240
7241 =over 4
7242
7243 =item AIX
7244
7245 =item Alpha systems with old gccs fail several tests
7246
7247 =item AmigaOS
7248
7249 =item BeOS
7250
7251 =item Cygwin "unable to remap"
7252
7253 =item Cygwin ndbm tests fail on FAT
7254
7255 =item DJGPP Failures
7256
7257 =item FreeBSD built with ithreads coredumps reading large directories
7258
7259 =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
7260
7261 =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
7262
7263 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
7264
7265 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
7266
7267 =item Linux With Sfio Fails op/misc Test 48
7268
7269 =item Mac OS X
7270
7271 =item Mac OS X dyld undefined symbols
7272
7273 =item OS/2 Test Failures
7274
7275 =item op/sprintf tests 91, 129, and 130
7276
7277 =item SCO
7278
7279 =item Solaris 2.5
7280
7281 =item Solaris x86 Fails Tests With -Duse64bitint
7282
7283 =item SUPER-UX (NEC SX)
7284
7285 =item Term::ReadKey not working on Win32
7286
7287 =item UNICOS/mk
7288
7289 =item UTS
7290
7291 =item VOS (Stratus)
7292
7293 =item VMS
7294
7295 =item Win32
7296
7297 =item XML::Parser not working
7298
7299 =item z/OS (OS/390)
7300
7301 =item Unicode Support on EBCDIC Still Spotty
7302
7303 =item Seen In Perl 5.7 But Gone Now
7304
7305 =back
7306
7307 =item Reporting Bugs
7308
7309 =item SEE ALSO
7310
7311 =item HISTORY
7312
7313 =back
7314
7315 =head2 perl573delta - what's new for perl v5.7.3
7316
7317 =over 4
7318
7319 =item DESCRIPTION
7320
7321 =item Changes
7322
7323 =item Reporting Bugs
7324
7325 =item SEE ALSO
7326
7327 =item HISTORY
7328
7329 =back
7330
7331 =head2 perl572delta - what's new for perl v5.7.2
7332
7333 =over 4
7334
7335 =item DESCRIPTION
7336
7337 =item Security Vulnerability Closed
7338
7339 =item Incompatible Changes
7340
7341 =over 4
7342
7343 =item 64-bit platforms and malloc
7344
7345 =item AIX Dynaloading
7346
7347 =item Socket Extension Dynamic in VMS
7348
7349 =item Different Definition of the Unicode Character Classes \p{In...}
7350
7351 =item Deprecations
7352
7353 =back
7354
7355 =item Core Enhancements
7356
7357 =item Modules and Pragmata
7358
7359 =over 4
7360
7361 =item New Modules and Distributions
7362
7363 =item Updated And Improved Modules and Pragmata
7364
7365 =back
7366
7367 =item Utility Changes
7368
7369 =item New Documentation
7370
7371 =item Installation and Configuration Improvements
7372
7373 =over 4
7374
7375 =item New Or Improved Platforms
7376
7377 =item Generic Improvements
7378
7379 =back
7380
7381 =item Selected Bug Fixes
7382
7383 =over 4
7384
7385 =item Platform Specific Changes and Fixes
7386
7387 =back
7388
7389 =item New or Changed Diagnostics
7390
7391 =item Source Code Enhancements
7392
7393 =over 4
7394
7395 =item MAGIC constants
7396
7397 =item Better commented code
7398
7399 =item Regex pre-/post-compilation items matched up
7400
7401 =item gcc -Wall
7402
7403 =back
7404
7405 =item New Tests
7406
7407 =item Known Problems
7408
7409 =over 4
7410
7411 =item AIX
7412
7413 =item Amiga Perl Invoking Mystery
7414
7415 =item lib/ftmp-security tests warn 'system possibly insecure'
7416
7417 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
7418
7419 =item HP-UX lib/io_multihomed Fails When LP64-Configured
7420
7421 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
7422
7423 =item Linux With Sfio Fails op/misc Test 48
7424
7425 =item OS/390
7426
7427 =item op/sprintf tests 129 and 130
7428
7429 =item  Failure of Thread tests
7430
7431 =item UNICOS
7432
7433 =item UTS
7434
7435 =item VMS
7436
7437 =item Win32
7438
7439 =item Localising a Tied Variable Leaks Memory
7440
7441 =item Self-tying of Arrays and Hashes Is Forbidden
7442
7443 =item Variable Attributes are not Currently Usable for Tieing
7444
7445 =item Building Extensions Can Fail Because Of Largefiles
7446
7447 =item The Compiler Suite Is Still Experimental
7448
7449 =item The Long Double Support is Still Experimental
7450
7451 =back
7452
7453 =item Reporting Bugs
7454
7455 =item SEE ALSO
7456
7457 =item HISTORY
7458
7459 =back
7460
7461 =head2 perl571delta - what's new for perl v5.7.1
7462
7463 =over 4
7464
7465 =item DESCRIPTION
7466
7467 =item Security Vulnerability Closed
7468
7469 =item Incompatible Changes
7470
7471 =item Core Enhancements
7472
7473 =over 4
7474
7475 =item AUTOLOAD Is Now Lvaluable
7476
7477 =item PerlIO is Now The Default
7478
7479 =item Signals Are Now Safe
7480
7481 =back
7482
7483 =item Modules and Pragmata
7484
7485 =over 4
7486
7487 =item New Modules
7488
7489 =item Updated And Improved Modules and Pragmata
7490
7491 =back
7492
7493 =item Performance Enhancements
7494
7495 =item Utility Changes
7496
7497 =item New Documentation
7498
7499 =over 4
7500
7501 =item perlclib
7502
7503 =item perliol
7504
7505 =item README.aix
7506
7507 =item README.bs2000
7508
7509 =item README.macos
7510
7511 =item README.mpeix
7512
7513 =item README.solaris
7514
7515 =item README.vos
7516
7517 =item Porting/repository.pod
7518
7519 =back
7520
7521 =item Installation and Configuration Improvements
7522
7523 =over 4
7524
7525 =item New Or Improved Platforms
7526
7527 =item Generic Improvements
7528
7529 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
7530 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
7531 d_strtoq, d_u32align, d_ualarm, d_usleep
7532
7533 =back
7534
7535 =item Selected Bug Fixes
7536
7537 =over 4
7538
7539 =item Platform Specific Changes and Fixes
7540
7541 =back
7542
7543 =item New or Changed Diagnostics
7544
7545 =item Changed Internals
7546
7547 =item New Tests
7548
7549 =item Known Problems
7550
7551 =over 4
7552
7553 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
7554
7555 =item lib/ftmp-security tests warn 'system possibly insecure'
7556
7557 =item lib/io_multihomed Fails In LP64-Configured HP-UX
7558
7559 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
7560
7561 =item lib/b test 19
7562
7563 =item Linux With Sfio Fails op/misc Test 48
7564
7565 =item sigaction test 13 in VMS
7566
7567 =item sprintf tests 129 and 130
7568
7569 =item  Failure of Thread tests
7570
7571 =item Localising a Tied Variable Leaks Memory
7572
7573 =item Self-tying of Arrays and Hashes Is Forbidden
7574
7575 =item Building Extensions Can Fail Because Of Largefiles
7576
7577 =item The Compiler Suite Is Still Experimental
7578
7579 =back
7580
7581 =item Reporting Bugs
7582
7583 =item SEE ALSO
7584
7585 =item HISTORY
7586
7587 =back
7588
7589 =head2 perl570delta - what's new for perl v5.7.0
7590
7591 =over 4
7592
7593 =item DESCRIPTION
7594
7595 =item Security Vulnerability Closed
7596
7597 =item Incompatible Changes
7598
7599 =item Core Enhancements
7600
7601 =item Modules and Pragmata
7602
7603 =over 4
7604
7605 =item New Modules
7606
7607 =item Updated And Improved Modules and Pragmata
7608
7609 =back
7610
7611 =item Utility Changes
7612
7613 =item New Documentation
7614
7615 =item Performance Enhancements
7616
7617 =item Installation and Configuration Improvements
7618
7619 =over 4
7620
7621 =item Generic Improvements
7622
7623 =back
7624
7625 =item Selected Bug Fixes
7626
7627 =over 4
7628
7629 =item Platform Specific Changes and Fixes
7630
7631 =back
7632
7633 =item New or Changed Diagnostics
7634
7635 =item Changed Internals
7636
7637 =item Known Problems
7638
7639 =over 4
7640
7641 =item Unicode Support Still Far From Perfect
7642
7643 =item EBCDIC Still A Lost Platform
7644
7645 =item Building Extensions Can Fail Because Of Largefiles
7646
7647 =item ftmp-security tests warn 'system possibly insecure'
7648
7649 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
7650
7651 =item Long Doubles Still Don't Work In Solaris
7652
7653 =item Linux With Sfio Fails op/misc Test 48
7654
7655 =item Storable tests fail in some platforms
7656
7657 =item Threads Are Still Experimental
7658
7659 =item The Compiler Suite Is Still Experimental
7660
7661 =back
7662
7663 =item Reporting Bugs
7664
7665 =item SEE ALSO
7666
7667 =item HISTORY
7668
7669 =back
7670
7671 =head2 perl561delta - what's new for perl v5.6.x
7672
7673 =over 4
7674
7675 =item DESCRIPTION
7676
7677 =item Summary of changes between 5.6.0 and 5.6.1
7678
7679 =over 4
7680
7681 =item Security Issues
7682
7683 =item Core bug fixes
7684
7685 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
7686 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
7687 references to special variables, Lexical warnings, Spurious warnings and
7688 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
7689 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
7690 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
7691 Module;>, Tests
7692
7693 =item Core features
7694
7695 =item Configuration issues
7696
7697 =item Documentation
7698
7699 =item Bundled modules
7700
7701 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
7702 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
7703 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
7704 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
7705
7706 =item Platform-specific improvements
7707
7708 NCR MP-RAS, NonStop-UX
7709
7710 =back
7711
7712 =item Core Enhancements
7713
7714 =over 4
7715
7716 =item Interpreter cloning, threads, and concurrency
7717
7718 =item Lexically scoped warning categories
7719
7720 =item Unicode and UTF-8 support
7721
7722 =item Support for interpolating named characters
7723
7724 =item "our" declarations
7725
7726 =item Support for strings represented as a vector of ordinals
7727
7728 =item Improved Perl version numbering system
7729
7730 =item New syntax for declaring subroutine attributes
7731
7732 =item File and directory handles can be autovivified
7733
7734 =item open() with more than two arguments
7735
7736 =item 64-bit support
7737
7738 =item Large file support
7739
7740 =item Long doubles
7741
7742 =item "more bits"
7743
7744 =item Enhanced support for sort() subroutines
7745
7746 =item C<sort $coderef @foo> allowed
7747
7748 =item File globbing implemented internally
7749
7750 =item Support for CHECK blocks
7751
7752 =item POSIX character class syntax [: :] supported
7753
7754 =item Better pseudo-random number generator
7755
7756 =item Improved C<qw//> operator
7757
7758 =item Better worst-case behavior of hashes
7759
7760 =item pack() format 'Z' supported
7761
7762 =item pack() format modifier '!' supported
7763
7764 =item pack() and unpack() support counted strings
7765
7766 =item Comments in pack() templates
7767
7768 =item Weak references
7769
7770 =item Binary numbers supported
7771
7772 =item Lvalue subroutines
7773
7774 =item Some arrows may be omitted in calls through references
7775
7776 =item Boolean assignment operators are legal lvalues
7777
7778 =item exists() is supported on subroutine names
7779
7780 =item exists() and delete() are supported on array elements
7781
7782 =item Pseudo-hashes work better
7783
7784 =item Automatic flushing of output buffers
7785
7786 =item Better diagnostics on meaningless filehandle operations
7787
7788 =item Where possible, buffered data discarded from duped input filehandle
7789
7790 =item eof() has the same old magic as <>
7791
7792 =item binmode() can be used to set :crlf and :raw modes
7793
7794 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
7795
7796 =item system(), backticks and pipe open now reflect exec() failure
7797
7798 =item Improved diagnostics
7799
7800 =item Diagnostics follow STDERR
7801
7802 =item More consistent close-on-exec behavior
7803
7804 =item syswrite() ease-of-use
7805
7806 =item Better syntax checks on parenthesized unary operators
7807
7808 =item Bit operators support full native integer width
7809
7810 =item Improved security features
7811
7812 =item More functional bareword prototype (*)
7813
7814 =item C<require> and C<do> may be overridden
7815
7816 =item $^X variables may now have names longer than one character
7817
7818 =item New variable $^C reflects C<-c> switch
7819
7820 =item New variable $^V contains Perl version as a string
7821
7822 =item Optional Y2K warnings
7823
7824 =item Arrays now always interpolate into double-quoted strings
7825
7826 =item @- and @+ provide starting/ending offsets of regex submatches
7827
7828 =back
7829
7830 =item Modules and Pragmata
7831
7832 =over 4
7833
7834 =item Modules
7835
7836 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
7837 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
7838 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
7839 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
7840 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
7841 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
7842 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
7843 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
7844
7845 =item Pragmata
7846
7847 =back
7848
7849 =item Utility Changes
7850
7851 =over 4
7852
7853 =item dprofpp
7854
7855 =item find2perl
7856
7857 =item h2xs
7858
7859 =item perlcc
7860
7861 =item perldoc
7862
7863 =item The Perl Debugger
7864
7865 =back
7866
7867 =item Improved Documentation
7868
7869 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
7870 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
7871 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
7872 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
7873
7874 =item Performance enhancements
7875
7876 =over 4
7877
7878 =item Simple sort() using { $a <=> $b } and the like are optimized
7879
7880 =item Optimized assignments to lexical variables
7881
7882 =item Faster subroutine calls
7883
7884 =item delete(), each(), values() and hash iteration are faster
7885
7886 =back
7887
7888 =item Installation and Configuration Improvements
7889
7890 =over 4
7891
7892 =item -Dusethreads means something different
7893
7894 =item New Configure flags
7895
7896 =item Threadedness and 64-bitness now more daring
7897
7898 =item Long Doubles
7899
7900 =item -Dusemorebits
7901
7902 =item -Duselargefiles
7903
7904 =item installusrbinperl
7905
7906 =item SOCKS support
7907
7908 =item C<-A> flag
7909
7910 =item Enhanced Installation Directories
7911
7912 =item gcc automatically tried if 'cc' does not seem to be working
7913
7914 =back
7915
7916 =item Platform specific changes
7917
7918 =over 4
7919
7920 =item Supported platforms
7921
7922 =item DOS
7923
7924 =item OS390 (OpenEdition MVS)
7925
7926 =item VMS
7927
7928 =item Win32
7929
7930 =back
7931
7932 =item Significant bug fixes
7933
7934 =over 4
7935
7936 =item <HANDLE> on empty files
7937
7938 =item C<eval '...'> improvements
7939
7940 =item All compilation errors are true errors
7941
7942 =item Implicitly closed filehandles are safer
7943
7944 =item Behavior of list slices is more consistent
7945
7946 =item C<(\$)> prototype and C<$foo{a}>
7947
7948 =item C<goto &sub> and AUTOLOAD
7949
7950 =item C<-bareword> allowed under C<use integer>
7951
7952 =item Failures in DESTROY()
7953
7954 =item Locale bugs fixed
7955
7956 =item Memory leaks
7957
7958 =item Spurious subroutine stubs after failed subroutine calls
7959
7960 =item Taint failures under C<-U>
7961
7962 =item END blocks and the C<-c> switch
7963
7964 =item Potential to leak DATA filehandles
7965
7966 =back
7967
7968 =item New or Changed Diagnostics
7969
7970 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
7971 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
7972 / cannot take a count, / must be followed by a, A or Z, / must be followed
7973 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
7974 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
7975 passed through, /%s/ should probably be written as "%s", %s() called too
7976 early to check prototype, %s argument is not a HASH or ARRAY element, %s
7977 argument is not a HASH or ARRAY element or slice, %s argument is not a
7978 subroutine name, %s package attribute may clash with future reserved word:
7979 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
7980 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
7981 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
7982 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
7983 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
7984 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
7985 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
7986 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
7987 weaken a nonreference, Character class [:%s:] unknown, Character class
7988 syntax [%s] belongs inside character classes, Constant is not %s reference,
7989 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
7990 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
7991 "local" instead of "our"?), Document contains no data, entering effective
7992 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
7993 output, flock() on closed filehandle %s, Global symbol "%s" requires
7994 explicit package name, Hexadecimal number > 0xffffffff non-portable,
7995 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
7996 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
7997 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
7998 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
7999 separator character %s in attribute list, Invalid separator character %s in
8000 subroutine attribute list, leaving effective %s failed, Lvalue subs
8001 returning %s not implemented yet, Method %s not permitted, Missing
8002 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
8003 No %s specified for -%c, No package name allowed for variable %s in "our",
8004 No space allowed after -%c, no UTC offset information; assuming local time
8005 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
8006 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
8007 around "%s" list, Possible unintended interpolation of %s in string,
8008 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
8009 instead, Premature end of script headers, Repeat count in pack overflows,
8010 Repeat count in unpack overflows, realloc() of freed memory ignored,
8011 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
8012 zero-length expression, switching effective %s is not implemented, This
8013 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
8014 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
8015 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
8016 escape \\%c passed through, Unterminated attribute parameter in attribute
8017 list, Unterminated attribute list, Unterminated attribute parameter in
8018 subroutine attribute list, Unterminated subroutine attribute list, Value of
8019 CLI symbol "%s" too long, Version number must be a constant number
8020
8021 =item New tests
8022
8023 =item Incompatible Changes
8024
8025 =over 4
8026
8027 =item Perl Source Incompatibilities
8028
8029 CHECK is a new keyword, Treatment of list slices of undef has changed,
8030 Format of $English::PERL_VERSION is different, Literals of the form
8031 C<1.2.3> parse differently, Possibly changed pseudo-random number
8032 generator, Hashing function for hash keys has changed, C<undef> fails on
8033 read only values, Close-on-exec bit may be set on pipe and socket handles,
8034 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
8035 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
8036 Text of some diagnostic output has changed, C<%@> has been removed,
8037 Parenthesized not() behaves like a list operator, Semantics of bareword
8038 prototype C<(*)> have changed, Semantics of bit operators may have changed
8039 on 64-bit platforms, More builtins taint their results
8040
8041 =item C Source Incompatibilities
8042
8043 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
8044
8045 =item Compatible C Source API Changes
8046
8047 C<PATCHLEVEL> is now C<PERL_VERSION>
8048
8049 =item Binary Incompatibilities
8050
8051 =back
8052
8053 =item Known Problems
8054
8055 =over 4
8056
8057 =item Localizing a tied hash element may leak memory
8058
8059 =item Known test failures
8060
8061 =item EBCDIC platforms not fully supported
8062
8063 =item UNICOS/mk CC failures during Configure run
8064
8065 =item Arrow operator and arrays
8066
8067 =item Experimental features
8068
8069 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
8070 pseudo-hash data type, The Compiler suite, Internal implementation of file
8071 globbing, The DB module, The regular expression code constructs:
8072
8073 =back
8074
8075 =item Obsolete Diagnostics
8076
8077 Character class syntax [: :] is reserved for future extensions, Ill-formed
8078 logical name |%s| in prime_env_iter, In string, @%s now must be written as
8079 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
8080 to mean "${$}<digit>" is deprecated
8081
8082 =item Reporting Bugs
8083
8084 =item SEE ALSO
8085
8086 =item HISTORY
8087
8088 =back
8089
8090 =head2 perl56delta - what's new for perl v5.6.0
8091
8092 =over 4
8093
8094 =item DESCRIPTION
8095
8096 =item Core Enhancements
8097
8098 =over 4
8099
8100 =item Interpreter cloning, threads, and concurrency
8101
8102 =item Lexically scoped warning categories
8103
8104 =item Unicode and UTF-8 support
8105
8106 =item Support for interpolating named characters
8107
8108 =item "our" declarations
8109
8110 =item Support for strings represented as a vector of ordinals
8111
8112 =item Improved Perl version numbering system
8113
8114 =item New syntax for declaring subroutine attributes
8115
8116 =item File and directory handles can be autovivified
8117
8118 =item open() with more than two arguments
8119
8120 =item 64-bit support
8121
8122 =item Large file support
8123
8124 =item Long doubles
8125
8126 =item "more bits"
8127
8128 =item Enhanced support for sort() subroutines
8129
8130 =item C<sort $coderef @foo> allowed
8131
8132 =item File globbing implemented internally
8133
8134 =item Support for CHECK blocks
8135
8136 =item POSIX character class syntax [: :] supported
8137
8138 =item Better pseudo-random number generator
8139
8140 =item Improved C<qw//> operator
8141
8142 =item Better worst-case behavior of hashes
8143
8144 =item pack() format 'Z' supported
8145
8146 =item pack() format modifier '!' supported
8147
8148 =item pack() and unpack() support counted strings
8149
8150 =item Comments in pack() templates
8151
8152 =item Weak references
8153
8154 =item Binary numbers supported
8155
8156 =item Lvalue subroutines
8157
8158 =item Some arrows may be omitted in calls through references
8159
8160 =item Boolean assignment operators are legal lvalues
8161
8162 =item exists() is supported on subroutine names
8163
8164 =item exists() and delete() are supported on array elements
8165
8166 =item Pseudo-hashes work better
8167
8168 =item Automatic flushing of output buffers
8169
8170 =item Better diagnostics on meaningless filehandle operations
8171
8172 =item Where possible, buffered data discarded from duped input filehandle
8173
8174 =item eof() has the same old magic as <>
8175
8176 =item binmode() can be used to set :crlf and :raw modes
8177
8178 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
8179
8180 =item system(), backticks and pipe open now reflect exec() failure
8181
8182 =item Improved diagnostics
8183
8184 =item Diagnostics follow STDERR
8185
8186 =item More consistent close-on-exec behavior
8187
8188 =item syswrite() ease-of-use
8189
8190 =item Better syntax checks on parenthesized unary operators
8191
8192 =item Bit operators support full native integer width
8193
8194 =item Improved security features
8195
8196 =item More functional bareword prototype (*)
8197
8198 =item C<require> and C<do> may be overridden
8199
8200 =item $^X variables may now have names longer than one character
8201
8202 =item New variable $^C reflects C<-c> switch
8203
8204 =item New variable $^V contains Perl version as a string
8205
8206 =item Optional Y2K warnings
8207
8208 =item Arrays now always interpolate into double-quoted strings
8209
8210 =item @- and @+ provide starting/ending offsets of regex matches
8211
8212 =back
8213
8214 =item Modules and Pragmata
8215
8216 =over 4
8217
8218 =item Modules
8219
8220 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
8221 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
8222 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
8223 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
8224 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
8225 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
8226 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
8227 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
8228
8229 =item Pragmata
8230
8231 =back
8232
8233 =item Utility Changes
8234
8235 =over 4
8236
8237 =item dprofpp
8238
8239 =item find2perl
8240
8241 =item h2xs
8242
8243 =item perlcc
8244
8245 =item perldoc
8246
8247 =item The Perl Debugger
8248
8249 =back
8250
8251 =item Improved Documentation
8252
8253 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
8254 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
8255 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
8256 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
8257
8258 =item Performance enhancements
8259
8260 =over 4
8261
8262 =item Simple sort() using { $a <=> $b } and the like are optimized
8263
8264 =item Optimized assignments to lexical variables
8265
8266 =item Faster subroutine calls
8267
8268 =item delete(), each(), values() and hash iteration are faster
8269
8270 =back
8271
8272 =item Installation and Configuration Improvements
8273
8274 =over 4
8275
8276 =item -Dusethreads means something different
8277
8278 =item New Configure flags
8279
8280 =item Threadedness and 64-bitness now more daring
8281
8282 =item Long Doubles
8283
8284 =item -Dusemorebits
8285
8286 =item -Duselargefiles
8287
8288 =item installusrbinperl
8289
8290 =item SOCKS support
8291
8292 =item C<-A> flag
8293
8294 =item Enhanced Installation Directories
8295
8296 =back
8297
8298 =item Platform specific changes
8299
8300 =over 4
8301
8302 =item Supported platforms
8303
8304 =item DOS
8305
8306 =item OS390 (OpenEdition MVS)
8307
8308 =item VMS
8309
8310 =item Win32
8311
8312 =back
8313
8314 =item Significant bug fixes
8315
8316 =over 4
8317
8318 =item <HANDLE> on empty files
8319
8320 =item C<eval '...'> improvements
8321
8322 =item All compilation errors are true errors
8323
8324 =item Implicitly closed filehandles are safer
8325
8326 =item Behavior of list slices is more consistent
8327
8328 =item C<(\$)> prototype and C<$foo{a}>
8329
8330 =item C<goto &sub> and AUTOLOAD
8331
8332 =item C<-bareword> allowed under C<use integer>
8333
8334 =item Failures in DESTROY()
8335
8336 =item Locale bugs fixed
8337
8338 =item Memory leaks
8339
8340 =item Spurious subroutine stubs after failed subroutine calls
8341
8342 =item Taint failures under C<-U>
8343
8344 =item END blocks and the C<-c> switch
8345
8346 =item Potential to leak DATA filehandles
8347
8348 =back
8349
8350 =item New or Changed Diagnostics
8351
8352 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
8353 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
8354 / cannot take a count, / must be followed by a, A or Z, / must be followed
8355 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
8356 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
8357 passed through, /%s/ should probably be written as "%s", %s() called too
8358 early to check prototype, %s argument is not a HASH or ARRAY element, %s
8359 argument is not a HASH or ARRAY element or slice, %s argument is not a
8360 subroutine name, %s package attribute may clash with future reserved word:
8361 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
8362 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
8363 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
8364 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
8365 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
8366 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
8367 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
8368 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
8369 weaken a nonreference, Character class [:%s:] unknown, Character class
8370 syntax [%s] belongs inside character classes, Constant is not %s reference,
8371 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
8372 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
8373 "local" instead of "our"?), Document contains no data, entering effective
8374 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
8375 output, flock() on closed filehandle %s, Global symbol "%s" requires
8376 explicit package name, Hexadecimal number > 0xffffffff non-portable,
8377 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
8378 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
8379 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
8380 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
8381 separator character %s in attribute list, Invalid separator character %s in
8382 subroutine attribute list, leaving effective %s failed, Lvalue subs
8383 returning %s not implemented yet, Method %s not permitted, Missing
8384 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
8385 No %s specified for -%c, No package name allowed for variable %s in "our",
8386 No space allowed after -%c, no UTC offset information; assuming local time
8387 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
8388 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
8389 around "%s" list, Possible unintended interpolation of %s in string,
8390 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
8391 instead, Premature end of script headers, Repeat count in pack overflows,
8392 Repeat count in unpack overflows, realloc() of freed memory ignored,
8393 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
8394 zero-length expression, switching effective %s is not implemented, This
8395 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
8396 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
8397 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
8398 escape \\%c passed through, Unterminated attribute parameter in attribute
8399 list, Unterminated attribute list, Unterminated attribute parameter in
8400 subroutine attribute list, Unterminated subroutine attribute list, Value of
8401 CLI symbol "%s" too long, Version number must be a constant number
8402
8403 =item New tests
8404
8405 =item Incompatible Changes
8406
8407 =over 4
8408
8409 =item Perl Source Incompatibilities
8410
8411 CHECK is a new keyword, Treatment of list slices of undef has changed,
8412 Format of $English::PERL_VERSION is different, Literals of the form
8413 C<1.2.3> parse differently, Possibly changed pseudo-random number
8414 generator, Hashing function for hash keys has changed, C<undef> fails on
8415 read only values, Close-on-exec bit may be set on pipe and socket handles,
8416 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
8417 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
8418 Text of some diagnostic output has changed, C<%@> has been removed,
8419 Parenthesized not() behaves like a list operator, Semantics of bareword
8420 prototype C<(*)> have changed, Semantics of bit operators may have changed
8421 on 64-bit platforms, More builtins taint their results
8422
8423 =item C Source Incompatibilities
8424
8425 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
8426
8427 =item Compatible C Source API Changes
8428
8429 C<PATCHLEVEL> is now C<PERL_VERSION>
8430
8431 =item Binary Incompatibilities
8432
8433 =back
8434
8435 =item Known Problems
8436
8437 =over 4
8438
8439 =item Thread test failures
8440
8441 =item EBCDIC platforms not supported
8442
8443 =item In 64-bit HP-UX the lib/io_multihomed test may hang
8444
8445 =item NEXTSTEP 3.3 POSIX test failure
8446
8447 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
8448 gcc
8449
8450 =item UNICOS/mk CC failures during Configure run
8451
8452 =item Arrow operator and arrays
8453
8454 =item Experimental features
8455
8456 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
8457 pseudo-hash data type, The Compiler suite, Internal implementation of file
8458 globbing, The DB module, The regular expression code constructs:
8459
8460 =back
8461
8462 =item Obsolete Diagnostics
8463
8464 Character class syntax [: :] is reserved for future extensions, Ill-formed
8465 logical name |%s| in prime_env_iter, In string, @%s now must be written as
8466 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
8467 to mean "${$}<digit>" is deprecated
8468
8469 =item Reporting Bugs
8470
8471 =item SEE ALSO
8472
8473 =item HISTORY
8474
8475 =back
8476
8477 =head2 perl5005delta - what's new for perl5.005
8478
8479 =over 4
8480
8481 =item DESCRIPTION
8482
8483 =item About the new versioning system
8484
8485 =item Incompatible Changes
8486
8487 =over 4
8488
8489 =item WARNING:  This version is not binary compatible with Perl 5.004.
8490
8491 =item Default installation structure has changed
8492
8493 =item Perl Source Compatibility
8494
8495 =item C Source Compatibility
8496
8497 =item Binary Compatibility
8498
8499 =item Security fixes may affect compatibility
8500
8501 =item Relaxed new mandatory warnings introduced in 5.004
8502
8503 =item Licensing
8504
8505 =back
8506
8507 =item Core Changes
8508
8509 =over 4
8510
8511 =item Threads
8512
8513 =item Compiler
8514
8515 =item Regular Expressions
8516
8517 Many new and improved optimizations, Many bug fixes, New regular expression
8518 constructs, New operator for precompiled regular expressions, Other
8519 improvements, Incompatible changes
8520
8521 =item   Improved malloc()
8522
8523 =item Quicksort is internally implemented
8524
8525 =item Reliable signals
8526
8527 =item Reliable stack pointers
8528
8529 =item More generous treatment of carriage returns
8530
8531 =item Memory leaks
8532
8533 =item Better support for multiple interpreters
8534
8535 =item Behavior of local() on array and hash elements is now well-defined
8536
8537 =item C<%!> is transparently tied to the L<Errno> module
8538
8539 =item Pseudo-hashes are supported
8540
8541 =item C<EXPR foreach EXPR> is supported
8542
8543 =item Keywords can be globally overridden
8544
8545 =item C<$^E> is meaningful on Win32
8546
8547 =item C<foreach (1..1000000)> optimized
8548
8549 =item C<Foo::> can be used as implicitly quoted package name
8550
8551 =item C<exists $Foo::{Bar::}> tests existence of a package
8552
8553 =item Better locale support
8554
8555 =item Experimental support for 64-bit platforms
8556
8557 =item prototype() returns useful results on builtins
8558
8559 =item Extended support for exception handling
8560
8561 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
8562
8563 =item All C<printf> format conversions are handled internally
8564
8565 =item New C<INIT> keyword
8566
8567 =item New C<lock> keyword
8568
8569 =item New C<qr//> operator
8570
8571 =item C<our> is now a reserved word
8572
8573 =item Tied arrays are now fully supported
8574
8575 =item Tied handles support is better
8576
8577 =item 4th argument to substr
8578
8579 =item Negative LENGTH argument to splice
8580
8581 =item Magic lvalues are now more magical
8582
8583 =item <> now reads in records
8584
8585 =back
8586
8587 =item Supported Platforms
8588
8589 =over 4
8590
8591 =item New Platforms
8592
8593 =item Changes in existing support
8594
8595 =back
8596
8597 =item Modules and Pragmata
8598
8599 =over 4
8600
8601 =item New Modules
8602
8603 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
8604 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
8605 Thread, attrs, fields, re
8606
8607 =item Changes in existing modules
8608
8609 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
8610 MakeMaker, CPAN, Cwd
8611
8612 =back
8613
8614 =item Utility Changes
8615
8616 =item Documentation Changes
8617
8618 =item New Diagnostics
8619
8620 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
8621 while coercing array into hash, Bareword "%s" refers to nonexistent
8622 package, Can't call method "%s" on an undefined value, Can't check
8623 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
8624 goto subroutine from an eval-string, Can't localize pseudo-hash element,
8625 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
8626 for "%s", Character class syntax [. .] is reserved for future extensions,
8627 Character class syntax [: :] is reserved for future extensions, Character
8628 class syntax [= =] is reserved for future extensions, %s: Eval-group in
8629 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
8630 Eval-group not allowed at run time, Explicit blessing to '' (assuming
8631 package main), Illegal hex digit ignored, No such array field, No such
8632 field "%s" in variable %s of type %s, Out of memory during ridiculously
8633 large request, Range iterator outside integer range, Recursive inheritance
8634 detected while looking for method '%s' %s, Reference found where even-sized
8635 list expected, Undefined value assigned to typeglob, Use of reserved word
8636 "%s" is deprecated, perl: warning: Setting locale failed
8637
8638 =item Obsolete Diagnostics
8639
8640 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
8641 temporary file, regexp too big
8642
8643 =item Configuration Changes
8644
8645 =item BUGS
8646
8647 =item SEE ALSO
8648
8649 =item HISTORY
8650
8651 =back
8652
8653 =head2 perl5004delta - what's new for perl5.004
8654
8655 =over 4
8656
8657 =item DESCRIPTION
8658
8659 =item Supported Environments
8660
8661 =item Core Changes
8662
8663 =over 4
8664
8665 =item List assignment to %ENV works
8666
8667 =item Change to "Can't locate Foo.pm in @INC" error
8668
8669 =item Compilation option: Binary compatibility with 5.003
8670
8671 =item $PERL5OPT environment variable
8672
8673 =item Limitations on B<-M>, B<-m>, and B<-T> options
8674
8675 =item More precise warnings
8676
8677 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
8678
8679 =item Previously deprecated %OVERLOAD is no longer usable
8680
8681 =item Subroutine arguments created only when they're modified
8682
8683 =item Group vector changeable with C<$)>
8684
8685 =item Fixed parsing of $$<digit>, &$<digit>, etc.
8686
8687 =item Fixed localization of $<digit>, $&, etc.
8688
8689 =item No resetting of $. on implicit close
8690
8691 =item C<wantarray> may return undef
8692
8693 =item C<eval EXPR> determines value of EXPR in scalar context
8694
8695 =item Changes to tainting checks
8696
8697 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
8698 spawning if tainted $TERM doesn't look like a terminal name
8699
8700 =item New Opcode module and revised Safe module
8701
8702 =item Embedding improvements
8703
8704 =item Internal change: FileHandle class based on IO::* classes
8705
8706 =item Internal change: PerlIO abstraction interface
8707
8708 =item New and changed syntax
8709
8710 $coderef->(PARAMS)
8711
8712 =item New and changed builtin constants
8713
8714 __PACKAGE__
8715
8716 =item New and changed builtin variables
8717
8718 $^E, $^H, $^M
8719
8720 =item New and changed builtin functions
8721
8722 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
8723 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
8724 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
8725 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
8726 nested C<sub{}> closures work now, formats work right on changing lexicals
8727
8728 =item New builtin methods
8729
8730 isa(CLASS), can(METHOD), VERSION( [NEED] )
8731
8732 =item TIEHANDLE now supported
8733
8734 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
8735 LIST, READLINE this, GETC this, DESTROY this
8736
8737 =item Malloc enhancements
8738
8739 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
8740
8741 =item Miscellaneous efficiency enhancements
8742
8743 =back
8744
8745 =item Support for More Operating Systems
8746
8747 =over 4
8748
8749 =item Win32
8750
8751 =item Plan 9
8752
8753 =item QNX
8754
8755 =item AmigaOS
8756
8757 =back
8758
8759 =item Pragmata
8760
8761 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
8762 constant NAME => VALUE, use locale, use ops, use vmsish
8763
8764 =item Modules
8765
8766 =over 4
8767
8768 =item Required Updates
8769
8770 =item Installation directories
8771
8772 =item Module information summary
8773
8774 =item Fcntl
8775
8776 =item IO
8777
8778 =item Math::Complex
8779
8780 =item Math::Trig
8781
8782 =item DB_File
8783
8784 =item Net::Ping
8785
8786 =item Object-oriented overrides for builtin operators
8787
8788 =back
8789
8790 =item Utility Changes
8791
8792 =over 4
8793
8794 =item pod2html
8795
8796 Sends converted HTML to standard output
8797
8798 =item xsubpp
8799
8800 C<void> XSUBs now default to returning nothing
8801
8802 =back
8803
8804 =item C Language API Changes
8805
8806 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
8807 manipulating hashes
8808
8809 =item Documentation Changes
8810
8811 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
8812 L<perlmodlib>, L<perldebug>, L<perlsec>
8813
8814 =item New Diagnostics
8815
8816 "my" variable %s masks earlier declaration in same scope, %s argument is
8817 not a HASH element or slice, Allocation too large: %lx, Allocation too
8818 large, Applying %s to %s will act on scalar(%s), Attempt to free
8819 nonexistent shared string, Attempt to use reference as lvalue in substr,
8820 Bareword "%s" refers to nonexistent package, Can't redefine active sort
8821 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
8822 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
8823 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
8824 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
8825 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
8826 %s, Integer overflow in hex number, Integer overflow in octal number,
8827 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
8828 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
8829 possible typo, Null picture in formline, Offset outside string, Out of
8830 memory!, Out of memory during request for %s, panic: frexp, Possible
8831 attempt to put comments in qw() list, Possible attempt to separate words
8832 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
8833 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
8834 option, untie attempted while %d inner references still exist, Unrecognized
8835 character %s, Unsupported function fork, Use of "$$<digit>" to mean
8836 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
8837 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
8838 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
8839 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
8840 long, Process terminated by SIG%s
8841
8842 =item BUGS
8843
8844 =item SEE ALSO
8845
8846 =item HISTORY
8847
8848 =back
8849
8850 =head2 perlartistic - the Perl Artistic License
8851
8852 =over 4
8853
8854 =item SYNOPSIS
8855
8856 =item DESCRIPTION
8857
8858 =item The "Artistic License"
8859
8860 =over 4
8861
8862 =item Preamble
8863
8864 =item Definitions
8865
8866 "Package", "Standard Version", "Copyright Holder", "You", "Reasonable
8867 copying fee", "Freely Available"
8868
8869 =item Conditions
8870
8871 a), b), c), d), a), b), c), d)
8872
8873 =back
8874
8875 =back
8876
8877 =head2 perlgpl - the GNU General Public License, version 2
8878
8879 =over 4
8880
8881 =item SYNOPSIS
8882
8883 =back
8884
8885 =over 4
8886
8887 =item DESCRIPTION
8888
8889 =item GNU GENERAL PUBLIC LICENSE
8890
8891 =back
8892
8893 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
8894
8895 =over 4
8896
8897 =item DESCRIPTION
8898
8899 =over 4
8900
8901 =item Compiling Perl 5 on AIX
8902
8903 =item OS level
8904
8905 =item Building Dynamic Extensions on AIX
8906
8907 =item The IBM ANSI C Compiler
8908
8909 =item The usenm option
8910
8911 =item Using GNU's gcc for building perl
8912
8913 =item Using Large Files with Perl
8914
8915 =item Threaded Perl
8916
8917 =item 64-bit Perl
8918
8919 =item AIX 4.2 and extensions using C++ with statics
8920
8921 =back
8922
8923 =item AUTHOR
8924
8925 =item DATE
8926
8927 =back
8928
8929 =head2 perlamiga - Perl under Amiga OS
8930
8931 =over 4
8932
8933 =item NOTE
8934
8935 =item SYNOPSIS
8936
8937 =back
8938
8939 =over 4
8940
8941 =item DESCRIPTION
8942
8943 =over 4
8944
8945 =item Prerequisites for Compiling Perl on AmigaOS
8946
8947 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
8948
8949 =item Starting Perl programs under AmigaOS
8950
8951 =item Shortcomings of Perl under AmigaOS
8952
8953 =back
8954
8955 =item INSTALLATION
8956
8957 =item Accessing documentation
8958
8959 =over 4
8960
8961 =item Manpages for Perl on AmigaOS
8962
8963 =item Perl HTML Documentation on AmigaOS
8964
8965 =item Perl GNU Info Files on AmigaOS
8966
8967 =item Perl LaTeX Documentation on AmigaOS
8968
8969 =back
8970
8971 =item BUILDING PERL ON AMIGAOS
8972
8973 =over 4
8974
8975 =item Build Prerequisites for Perl on AmigaOS
8976
8977 =item Getting the Perl Source for AmigaOS
8978
8979 =item Making Perl on AmigaOS
8980
8981 =item Testing Perl on AmigaOS
8982
8983 =item Installing the built Perl on AmigaOS
8984
8985 =back
8986
8987 =item PERL 5.8.0 BROKEN IN AMIGAOS
8988
8989 =item AUTHORS
8990
8991 =item SEE ALSO
8992
8993 =back
8994
8995 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
8996
8997 =over 4
8998
8999 =item DESCRIPTION
9000
9001 =item AUTHOR
9002
9003 =back
9004
9005 =head2 perlbeos, README.beos - Perl version 5.8+ on BeOS
9006
9007 =over 4
9008
9009 =item DESCRIPTION
9010
9011 =item BUILD AND INSTALL
9012
9013 =over 4
9014
9015 =item Requirements
9016
9017 =item Configure
9018
9019 =item Build
9020
9021 =item Install
9022
9023 =back
9024
9025 =item KNOWN PROBLEMS
9026
9027 =item CONTACT
9028
9029 =back
9030
9031 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
9032
9033 =over 4
9034
9035 =item SYNOPSIS
9036
9037 =item DESCRIPTION
9038
9039 =over 4
9040
9041 =item gzip on BS2000
9042
9043 =item bison on BS2000
9044
9045 =item Unpacking Perl Distribution on BS2000
9046
9047 =item Compiling Perl on BS2000
9048
9049 =item Testing Perl on BS2000
9050
9051 =item Installing Perl on BS2000
9052
9053 =item Using Perl in the Posix-Shell of BS2000
9054
9055 =item Using Perl in "native" BS2000
9056
9057 =item Floating point anomalies on BS2000
9058
9059 =item Using PerlIO and different encodings on ASCII and EBCDIC partitions
9060
9061 =back
9062
9063 =item AUTHORS
9064
9065 =item SEE ALSO
9066
9067 =over 4
9068
9069 =item Mailing list
9070
9071 =back
9072
9073 =item HISTORY
9074
9075 =back
9076
9077 =head2 perlce - Perl for WinCE
9078
9079 =over 4
9080
9081 =item Building Perl for WinCE
9082
9083 =over 4
9084
9085 =item DESCRIPTION
9086
9087 =item General explanations on cross-compiling WinCE
9088
9089 =item BUILD
9090
9091 Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's
9092 celib-sources, Rainer Keuchel's console-sources, go to ./wince
9093 subdirectory, edit file compile.bat, run    compile.bat, run    compile.bat
9094 dist
9095
9096 =back
9097
9098 =item Using Perl on WinCE
9099
9100 =over 4
9101
9102 =item DESCRIPTION
9103
9104 =item LIMITATIONS
9105
9106 =item ENVIRONMENT
9107
9108 =item REGISTRY
9109
9110 =item PERLFILES
9111
9112 =item XS
9113
9114 =item BUGS
9115
9116 =item INSTALLATION
9117
9118 =back
9119
9120 =item ACKNOWLEDGEMENTS
9121
9122 =item AUTHORS
9123
9124 Rainer Keuchel <coyxc@rainer-keuchel.de>, Vadim Konovalov
9125
9126 =back
9127
9128 =head2 perlcygwin, README.cygwin - Perl for Cygwin
9129
9130 =over 4
9131
9132 =item SYNOPSIS
9133
9134 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
9135
9136 =over 4
9137
9138 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
9139
9140 =item Cygwin Configuration
9141
9142 C<PATH>, I<nroff>, Permissions
9143
9144 =back
9145
9146 =item CONFIGURE PERL ON CYGWIN
9147
9148 =over 4
9149
9150 =item Stripping Perl Binaries on Cygwin
9151
9152 =item Optional Libraries for Perl on Cygwin
9153
9154 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
9155 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
9156
9157 =item Configure-time Options for Perl on Cygwin
9158
9159 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
9160 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
9161 C<-Dmksymlinks>
9162
9163 =item Suspicious Warnings on Cygwin
9164
9165 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
9166
9167 =back
9168
9169 =item MAKE ON CYGWIN
9170
9171 =over 4
9172
9173 =item Errors on Cygwin
9174
9175 =item ld2 on Cygwin
9176
9177 =back
9178
9179 =item TEST ON CYGWIN
9180
9181 =over 4
9182
9183 =item File Permissions on Cygwin
9184
9185 =item NDBM_File and ODBM_File do not work on FAT filesystems
9186
9187 =item C<fork()> failures in io_* tests
9188
9189 =back
9190
9191 =item Specific features of the Cygwin port
9192
9193 =over 4
9194
9195 =item Script Portability on Cygwin
9196
9197 Pathnames, Text/Binary, PerlIO, F<.exe>, cygwin vs. windows process ids,
9198 C<chown()>, Miscellaneous
9199
9200 =item Prebuilt methods:
9201
9202 C<Cwd::cwd>, C<Cygwin::pid_to_winpid>, C<Cygwin::winpid_to_pid>
9203
9204 =back
9205
9206 =item INSTALL PERL ON CYGWIN
9207
9208 =item MANIFEST ON CYGWIN
9209
9210 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
9211 Source, Compiled Module Source, Perl Modules/Scripts
9212
9213 =item BUGS ON CYGWIN
9214
9215 =item AUTHORS
9216
9217 =item HISTORY
9218
9219 =back
9220
9221 =head2 perldgux - Perl under DG/UX.
9222
9223 =over 4
9224
9225 =item SYNOPSIS
9226
9227 =back
9228
9229 =over 4
9230
9231 =item DESCRIPTION
9232
9233 =item BUILDING PERL ON DG/UX
9234
9235 =over 4
9236
9237 =item Non-threaded Perl on DG/UX
9238
9239 =item Threaded Perl on DG/UX
9240
9241 =item Testing Perl on DG/UX
9242
9243 =item Installing the built perl on DG/UX
9244
9245 =back
9246
9247 =item AUTHOR
9248
9249 =item SEE ALSO
9250
9251 =back
9252
9253 =head2 perldos - Perl under DOS, W31, W95.
9254
9255 =over 4
9256
9257 =item SYNOPSIS
9258
9259 =item DESCRIPTION
9260
9261 =over 4
9262
9263 =item Prerequisites for Compiling Perl on DOS
9264
9265 DJGPP, Pthreads
9266
9267 =item Shortcomings of Perl under DOS
9268
9269 =item Building Perl on DOS
9270
9271 =item Testing Perl on DOS
9272
9273 =item Installation of Perl on DOS
9274
9275 =back
9276
9277 =item BUILDING AND INSTALLING MODULES ON DOS
9278
9279 =over 4
9280
9281 =item Building Prerequisites for Perl on DOS
9282
9283 =item Unpacking CPAN Modules on DOS
9284
9285 =item Building Non-XS Modules on DOS
9286
9287 =item Building XS Modules on DOS
9288
9289 =back
9290
9291 =item AUTHOR
9292
9293 =item SEE ALSO
9294
9295 =back
9296
9297 =head2 perlepoc, README.epoc - Perl for EPOC
9298
9299 =over 4
9300
9301 =item SYNOPSIS
9302
9303 =item INTRODUCTION
9304
9305 =item INSTALLING PERL ON EPOC
9306
9307 =item STARTING PERL ON EPOC
9308
9309 =over 4
9310
9311 =item Editors on Epoc
9312
9313 =item Features of Perl on Epoc
9314
9315 =item Restrictions of Perl on Epoc
9316
9317 =item Compiling Perl 5 on the EPOC cross compiling environment
9318
9319 =back
9320
9321 =item SUPPORT STATUS OF PERL ON EPOC
9322
9323 =item AUTHOR
9324
9325 =item LAST UPDATE
9326
9327 =back
9328
9329 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
9330
9331 =over 4
9332
9333 =item DESCRIPTION
9334
9335 =over 4
9336
9337 =item FreeBSD core dumps from readdir_r with ithreads
9338
9339 =item $^X doesn't always contain a full path in FreeBSD
9340
9341 =item Perl will no longer be part of "base FreeBSD"
9342
9343 =back
9344
9345 =item AUTHOR
9346
9347 =back
9348
9349 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
9350 (HP-UX) systems
9351
9352 =over 4
9353
9354 =item DESCRIPTION
9355
9356 =over 4
9357
9358 =item Using perl as shipped with HP-UX
9359
9360 =item Using perl from HP's porting centre
9361
9362 =item Compiling Perl 5 on HP-UX
9363
9364 =item PA-RISC
9365
9366 =item Portability Between PA-RISC Versions
9367
9368 =item PA-RISC 1.0
9369
9370 =item PA-RISC 1.1
9371
9372 =item PA-RISC 2.0
9373
9374 =item Itanium Processor Family and HP-UX
9375
9376 =item Itanium & Itanium 2
9377
9378 =item Building Dynamic Extensions on HP-UX
9379
9380 =item The HP ANSI C Compiler
9381
9382 =item The GNU C Compiler
9383
9384 =item Using Large Files with Perl on HP-UX
9385
9386 =item Threaded Perl on HP-UX
9387
9388 =item 64-bit Perl on HP-UX
9389
9390 =item Oracle on HP-UX
9391
9392 =item GDBM and Threads on HP-UX
9393
9394 =item NFS filesystems and utime(2) on HP-UX
9395
9396 =item perl -P and // and HP-UX
9397
9398 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
9399
9400 =back
9401
9402 =item nss_delete core dump from op/pwent or op/grent
9403
9404 =item AUTHOR
9405
9406 =item DATE
9407
9408 =back
9409
9410 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
9411
9412 =over 4
9413
9414 =item DESCRIPTION
9415
9416 =over 4
9417
9418 =item Known Problems with Perl on Hurd 
9419
9420 =back
9421
9422 =item AUTHOR
9423
9424 =back
9425
9426 =head2 perlirix, README.irix - Perl version 5 on Irix systems
9427
9428 =over 4
9429
9430 =item DESCRIPTION
9431
9432 =over 4
9433
9434 =item Building 32-bit Perl in Irix
9435
9436 =item Building 64-bit Perl in Irix
9437
9438 =item About Compiler Versions of Irix
9439
9440 =item Linker Problems in Irix
9441
9442 =item Malloc in Irix
9443
9444 =item Building with threads in Irix
9445
9446 =item Irix 5.3
9447
9448 =back
9449
9450 =item AUTHOR
9451
9452 =back
9453
9454 =head2 perllinux, README.linux - Perl version 5 on Linux systems
9455
9456 =over 4
9457
9458 =item DESCRIPTION
9459
9460 =over 4
9461
9462 =item Experimental Support for Sun Studio Compilers for Linux OS
9463
9464 =back
9465
9466 =item AUTHOR
9467
9468 =back
9469
9470 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
9471 systems
9472
9473 =over 4
9474
9475 =item DESCRIPTION
9476
9477 =over 4
9478
9479 =item Perl version 5.8.x and greater not supported
9480
9481 =item Compiling Perl 5.6.x on MachTen
9482
9483 =item Failures during C<make test> on MachTen
9484
9485 op/lexassign.t, pragma/warnings.t
9486
9487 =item Building external modules on MachTen
9488
9489 =back
9490
9491 =item AUTHOR
9492
9493 =item DATE
9494
9495 =back
9496
9497 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
9498
9499 =over 4
9500
9501 =item SYNOPSIS
9502
9503 =item DESCRIPTION
9504
9505 =item AUTHOR
9506
9507 =item DATE
9508
9509 =back
9510
9511 =head2 perlmacosx, README.macosx - Perl under Mac OS X
9512
9513 =over 4
9514
9515 =item SYNOPSIS
9516
9517 =item DESCRIPTION
9518
9519 =over 4
9520
9521 =item Installation Prefix
9522
9523 =item libperl and Prebinding
9524
9525 =item Updating Apple-supplied Perl
9526
9527 =item 64-bit Perl
9528
9529 =item Intel processor support
9530
9531 =item  Universal binaries
9532
9533 =item Known problems
9534
9535 =item MacPerl
9536
9537 =item Carbon
9538
9539 =item Cocoa
9540
9541 =back
9542
9543 =item Starting From Scratch
9544
9545 =item AUTHOR
9546
9547 =item DATE
9548
9549 =back
9550
9551 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
9552
9553 =over 4
9554
9555 =item DESCRIPTION
9556
9557 =item Known problems with Perl on MiNT
9558
9559 =item AUTHOR
9560
9561 =back
9562
9563 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
9564
9565 =over 4
9566
9567 =item SYNOPSIS
9568
9569 =item NOTE
9570
9571 =item Binary distribution from HP
9572
9573 =item What's New in Perl for MPE/iX
9574
9575 =item Welcome to Perl/iX
9576
9577 =item System Requirements for Perl/iX
9578
9579 =item How to Obtain Perl/iX
9580
9581 =item Perl/iX Distribution Contents Highlights
9582
9583 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
9584 public_html/feedback.cgi, src/perl-5.6.0-mpe
9585
9586 =item How to Compile Perl/iX
9587
9588  4,  6
9589
9590 =item Getting Started with Perl/iX
9591
9592 =item MPE/iX Implementation Considerations
9593
9594 =item Known Perl/iX Bugs Under Investigation
9595
9596 =item Perl/iX To-Do List
9597
9598 =item Perl/iX Change History
9599
9600 =item AUTHOR
9601
9602 =back
9603
9604 =head2 perlnetware - Perl for NetWare
9605
9606 =over 4
9607
9608 =item DESCRIPTION
9609
9610 =item BUILD
9611
9612 =over 4
9613
9614 =item Tools & SDK
9615
9616 =item Setup
9617
9618 SetNWBld.bat, Buildtype.bat
9619
9620 =item Make
9621
9622 =item Interpreter
9623
9624 =item Extensions
9625
9626 =back
9627
9628 =item INSTALL
9629
9630 =item BUILD NEW EXTENSIONS
9631
9632 =item ACKNOWLEDGEMENTS
9633
9634 =item AUTHORS
9635
9636 =item DATE
9637
9638 =back
9639
9640 =head2 perlopenbsd, README.openbsd - Perl version 5 on OpenBSD systems
9641
9642 =over 4
9643
9644 =item DESCRIPTION
9645
9646 =over 4
9647
9648 =item OpenBSD core dumps from getprotobyname_r and getservbyname_r with
9649 ithreads
9650
9651 =back
9652
9653 =item AUTHOR
9654
9655 =back
9656
9657 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
9658
9659 =over 4
9660
9661 =item SYNOPSIS
9662
9663 =back
9664
9665 =over 4
9666
9667 =item DESCRIPTION
9668
9669 =over 4
9670
9671 =item Target
9672
9673 =item Other OSes
9674
9675 =item Prerequisites
9676
9677 EMX, RSX, HPFS, pdksh
9678
9679 =item Starting Perl programs under OS/2 (and DOS and...)
9680
9681 =item Starting OS/2 (and DOS) programs under Perl
9682
9683 =back
9684
9685 =item Frequently asked questions
9686
9687 =over 4
9688
9689 =item "It does not work"
9690
9691 =item I cannot run external programs
9692
9693 =item I cannot embed perl into my program, or use F<perl.dll> from my
9694 program. 
9695
9696 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
9697 L<ExtUtils::Embed>?
9698
9699 =item C<``> and pipe-C<open> do not work under DOS.
9700
9701 =item Cannot start C<find.exe "pattern" file>
9702
9703 =back
9704
9705 =item INSTALLATION
9706
9707 =over 4
9708
9709 =item Automatic binary installation
9710
9711 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
9712
9713 =item Manual binary installation
9714
9715 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
9716 (statically linked), Executables for Perl utilities, Main Perl library,
9717 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
9718 and utilities, Manpages for Perl modules, Source for Perl documentation,
9719 Perl manual in F<.INF> format, Pdksh
9720
9721 =item B<Warning>
9722
9723 =back
9724
9725 =item Accessing documentation
9726
9727 =over 4
9728
9729 =item OS/2 F<.INF> file
9730
9731 =item Plain text
9732
9733 =item Manpages
9734
9735 =item HTML
9736
9737 =item GNU C<info> files
9738
9739 =item F<PDF> files
9740
9741 =item C<LaTeX> docs
9742
9743 =back
9744
9745 =item BUILD
9746
9747 =over 4
9748
9749 =item The short story
9750
9751 =item Prerequisites
9752
9753 =item Getting perl source
9754
9755 =item Application of the patches
9756
9757 =item Hand-editing
9758
9759 =item Making
9760
9761 =item Testing
9762
9763 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
9764 F<op/stat.t>
9765
9766 =item Installing the built perl
9767
9768 =item C<a.out>-style build
9769
9770 =back
9771
9772 =item Building a binary distribution
9773
9774 =item Building custom F<.EXE> files
9775
9776 =over 4
9777
9778 =item Making executables with a custom collection of statically loaded
9779 extensions
9780
9781 =item Making executables with a custom search-paths
9782
9783 =back
9784
9785 =item Build FAQ
9786
9787 =over 4
9788
9789 =item Some C</> became C<\> in pdksh.
9790
9791 =item C<'errno'> - unresolved external
9792
9793 =item Problems with tr or sed
9794
9795 =item Some problem (forget which ;-)
9796
9797 =item Library ... not found
9798
9799 =item Segfault in make
9800
9801 =item op/sprintf test failure
9802
9803 =back
9804
9805 =item Specific (mis)features of OS/2 port
9806
9807 =over 4
9808
9809 =item C<setpriority>, C<getpriority>
9810
9811 =item C<system()>
9812
9813 =item C<extproc> on the first line
9814
9815 =item Additional modules:
9816
9817 =item Prebuilt methods:
9818
9819 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
9820  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>, 
9821 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>, 
9822 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>, 
9823 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>, 
9824 C<Cwd::extLibpath_set( path [, type ] )>,
9825 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
9826 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
9827 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
9828 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
9829 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
9830 C<OS2::DLLname([how [, \&xsub]])>
9831
9832 =item Prebuilt variables:
9833
9834 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
9835 $OS2::nsyserror
9836
9837 =item Misfeatures
9838
9839 =item Modifications
9840
9841 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
9842 C<flock>
9843
9844 =item Identifying DLLs
9845
9846 =item Centralized management of resources
9847
9848 C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
9849 C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
9850 C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
9851 C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
9852
9853 =back
9854
9855 =item Perl flavors
9856
9857 =over 4
9858
9859 =item F<perl.exe>
9860
9861 =item F<perl_.exe>
9862
9863 =item F<perl__.exe>
9864
9865 =item F<perl___.exe>
9866
9867 =item Why strange names?
9868
9869 =item Why dynamic linking?
9870
9871 =item Why chimera build?
9872
9873 =back
9874
9875 =item ENVIRONMENT
9876
9877 =over 4
9878
9879 =item C<PERLLIB_PREFIX>
9880
9881 =item C<PERL_BADLANG>
9882
9883 =item C<PERL_BADFREE>
9884
9885 =item C<PERL_SH_DIR>
9886
9887 =item C<USE_PERL_FLOCK>
9888
9889 =item C<TMP> or C<TEMP>
9890
9891 =back
9892
9893 =item Evolution
9894
9895 =over 4
9896
9897 =item Text-mode filehandles
9898
9899 =item Priorities
9900
9901 =item DLL name mangling: pre 5.6.2
9902
9903 =item DLL name mangling: 5.6.2 and beyond
9904
9905 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
9906 C<LIBPATH>
9907
9908 =item DLL forwarder generation
9909
9910 =item Threading
9911
9912 =item Calls to external programs
9913
9914 =item Memory allocation
9915
9916 =item Threads
9917
9918 C<COND_WAIT>, F<os2.c>
9919
9920 =back
9921
9922 =item BUGS
9923
9924 =back
9925
9926 =over 4
9927
9928 =item AUTHOR
9929
9930 =item SEE ALSO
9931
9932 =back
9933
9934 =head2 perlos390, README.os390 - building and installing Perl for OS/390
9935 and z/OS
9936
9937 =over 4
9938
9939 =item SYNOPSIS
9940
9941 =item DESCRIPTION
9942
9943 =over 4
9944
9945 =item Tools
9946
9947 =item Unpacking Perl distribution on OS/390
9948
9949 =item Setup and utilities for Perl on OS/390
9950
9951 =item Configure Perl on OS/390
9952
9953 =item Build, Test, Install Perl on OS/390
9954
9955 =item Build Anomalies with Perl on OS/390
9956
9957 =item Testing Anomalies with Perl on OS/390
9958
9959 =item Installation Anomalies with Perl on OS/390
9960
9961 =item Usage Hints for Perl on OS/390
9962
9963 =item Floating Point Anomalies with Perl on OS/390
9964
9965 =item Modules and Extensions for Perl on OS/390
9966
9967 =back
9968
9969 =item AUTHORS
9970
9971 =item SEE ALSO
9972
9973 =over 4
9974
9975 =item Mailing list for Perl on OS/390
9976
9977 =back
9978
9979 =item HISTORY
9980
9981 =back
9982
9983 =head2 perlos400, README.os400 - Perl version 5 on OS/400
9984
9985 =over 4
9986
9987 =item DESCRIPTION
9988
9989 =over 4
9990
9991 =item Compiling Perl for OS/400 PASE
9992
9993 =item Installing Perl in OS/400 PASE
9994
9995 =item Using Perl in OS/400 PASE
9996
9997 =item Known Problems
9998
9999 =item Perl on ILE
10000
10001 =back
10002
10003 =item AUTHORS
10004
10005 =back
10006
10007 =head2 perlplan9 - Plan 9-specific documentation for Perl
10008
10009 =over 4
10010
10011 =item DESCRIPTION
10012
10013 =over 4
10014
10015 =item Invoking Perl
10016
10017 =item What's in Plan 9 Perl
10018
10019 =item What's not in Plan 9 Perl
10020
10021 =item Perl5 Functions not currently supported in Plan 9 Perl
10022
10023 =item Signals in Plan 9 Perl
10024
10025 =back
10026
10027 =item COMPILING AND INSTALLING PERL ON PLAN 9
10028
10029 =over 4
10030
10031 =item Installing Perl Documentation on Plan 9
10032
10033 =back
10034
10035 =item BUGS
10036
10037 =item Revision date
10038
10039 =item AUTHOR
10040
10041 =back
10042
10043 =head2 perlqnx, README.qnx - Perl version 5 on QNX
10044
10045 =over 4
10046
10047 =item DESCRIPTION
10048
10049 =over 4
10050
10051 =item Required Software for Compiling Perl on QNX4
10052
10053 /bin/sh, ar, nm, cpp, make
10054
10055 =item Outstanding Issues with Perl on QNX4
10056
10057 =item QNX auxiliary files
10058
10059 qnx/ar, qnx/cpp
10060
10061 =item Outstanding issues with perl under QNX6
10062
10063 =back
10064
10065 =item AUTHOR
10066
10067 =back
10068
10069 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
10070
10071 =over 4
10072
10073 =item DESCRIPTION
10074
10075 =over 4
10076
10077 =item Solaris Version Numbers.
10078
10079 =back
10080
10081 =item RESOURCES
10082
10083 Solaris FAQ, Precompiled Binaries, Solaris Documentation
10084
10085 =item SETTING UP
10086
10087 =over 4
10088
10089 =item File Extraction Problems on Solaris.
10090
10091 =item Compiler and Related Tools on Solaris.
10092
10093 =item Environment for Compiling perl on Solaris
10094
10095 =back
10096
10097 =item RUN CONFIGURE.
10098
10099 =over 4
10100
10101 =item 64-bit perl on Solaris.
10102
10103 =item Threads in perl on Solaris.
10104
10105 =item Malloc Issues with perl on Solaris.
10106
10107 =back
10108
10109 =item MAKE PROBLEMS.
10110
10111 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
10112 relocation error:, dlopen: stub interception failed, #error "No
10113 DATAMODEL_NATIVE specified", sh: ar: not found, warning: dead part of
10114 constant expression is nonconstant
10115
10116 =item MAKE TEST
10117
10118 =over 4
10119
10120 =item op/stat.t test 4 in Solaris
10121
10122 =item nss_delete core dump from op/pwent or op/grent
10123
10124 =back
10125
10126 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
10127
10128 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
10129
10130 =over 4
10131
10132 =item Limits on Numbers of Open Files on Solaris.
10133
10134 =back
10135
10136 =item SOLARIS-SPECIFIC MODULES.
10137
10138 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
10139
10140 =over 4
10141
10142 =item Proc::ProcessTable on Solaris
10143
10144 =item BSD::Resource on Solaris
10145
10146 =item Net::SSLeay on Solaris
10147
10148 =back
10149
10150 =item SunOS 4.x
10151
10152 =item AUTHOR
10153
10154 =back
10155
10156 =head2 perlsymbian, README.symbian - Perl version 5 on Symbian OS
10157
10158 =over 4
10159
10160 =item DESCRIPTION
10161
10162 =over 4
10163
10164 =item Compiling Perl on Symbian
10165
10166 =item Compilation problems
10167
10168 =item PerlApp
10169
10170 =item sisify.pl
10171
10172 =item Using Perl in Symbian
10173
10174 =back
10175
10176 =item TO DO
10177
10178 =item WARNING
10179
10180 =item NOTE
10181
10182 =item AUTHOR
10183
10184 =item COPYRIGHT
10185
10186 =item LICENSE
10187
10188 =item HISTORY
10189
10190 =back
10191
10192 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
10193 Digital UNIX formerly known as DEC OSF/1) systems
10194
10195 =over 4
10196
10197 =item DESCRIPTION
10198
10199 =over 4
10200
10201 =item Compiling Perl 5 on Tru64
10202
10203 =item Using Large Files with Perl on Tru64
10204
10205 =item Threaded Perl on Tru64
10206
10207 =item Long Doubles on Tru64
10208
10209 =item DB_File tests failing on Tru64
10210
10211 =item 64-bit Perl on Tru64
10212
10213 =item Warnings about floating-point overflow when compiling Perl on Tru64
10214
10215 =back
10216
10217 =item Testing Perl on Tru64
10218
10219 =item ext/ODBM_File/odbm Test Failing With Static Builds
10220
10221 =item Perl Fails Because Of Unresolved Symbol sockatmark
10222
10223 =item AUTHOR
10224
10225 =back
10226
10227 =head2 perluts - Perl under UTS
10228
10229 =over 4
10230
10231 =item SYNOPSIS
10232
10233 =item DESCRIPTION
10234
10235 =item BUILDING PERL ON UTS
10236
10237 =item Installing the built perl on UTS
10238
10239 =item AUTHOR
10240
10241 =back
10242
10243 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
10244
10245 =over 4
10246
10247 =item SYNOPSIS
10248
10249 =item DESCRIPTION
10250
10251 =over 4
10252
10253 =item Unpacking Perl Distribution on VM/ESA
10254
10255 =item Setup Perl and utilities on VM/ESA
10256
10257 =item Configure Perl on VM/ESA
10258
10259 =item Testing Anomalies of Perl on VM/ESA
10260
10261 =item Usage Hints for Perl on VM/ESA
10262
10263 =back
10264
10265 =item AUTHORS
10266
10267 =item SEE ALSO
10268
10269 =over 4
10270
10271 =item Mailing list for Perl on VM/ESA
10272
10273 =back
10274
10275 =back
10276
10277 =head2 perlvms - VMS-specific documentation for Perl
10278
10279 =over 4
10280
10281 =item DESCRIPTION
10282
10283 =item Installation
10284
10285 =item Organization of Perl Images
10286
10287 =over 4
10288
10289 =item Core Images
10290
10291 =item Perl Extensions
10292
10293 =item Installing static extensions
10294
10295 =item Installing dynamic extensions
10296
10297 =back
10298
10299 =item File specifications
10300
10301 =over 4
10302
10303 =item Syntax
10304
10305 =item Wildcard expansion
10306
10307 =item Pipes
10308
10309 =back
10310
10311 =item PERL5LIB and PERLLIB
10312
10313 =item Command line
10314
10315 =over 4
10316
10317 =item I/O redirection and backgrounding
10318
10319 =item Command line switches
10320
10321 -i, -S, -u
10322
10323 =back
10324
10325 =item Perl functions
10326
10327 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, die,
10328 dump, exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//,
10329 select (system call), stat EXPR, system LIST, time, times, unlink LIST,
10330 utime LIST, waitpid PID,FLAGS
10331
10332 =item Perl variables
10333
10334 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
10335
10336 =item Standard modules with VMS-specific differences
10337
10338 =over 4
10339
10340 =item SDBM_File
10341
10342 =back
10343
10344 =item Revision date
10345
10346 =item AUTHOR
10347
10348 =back
10349
10350 =head2 perlvos, README.vos - Perl for Stratus VOS
10351
10352 =over 4
10353
10354 =item SYNOPSIS
10355
10356 =item BUILDING PERL FOR VOS
10357
10358 =item INSTALLING PERL IN VOS
10359
10360 =item USING PERL IN VOS
10361
10362 =over 4
10363
10364 =item Restrictions of Perl on VOS
10365
10366 =item Handling of underflow and overflow
10367
10368 =back
10369
10370 =item TEST STATUS
10371
10372 =item SUPPORT STATUS
10373
10374 =item AUTHOR
10375
10376 =item LAST UPDATE
10377
10378 =back
10379
10380 =head2 perlwin32 - Perl under Windows
10381
10382 =over 4
10383
10384 =item SYNOPSIS
10385
10386 =item DESCRIPTION
10387
10388 =over 4
10389
10390 =item Setting Up Perl on Win32
10391
10392 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Visual
10393 C++ Toolkit 2003, Microsoft Platform SDK 64-bit Compiler, MinGW release 3
10394 with gcc, MinGW release 1 with gcc
10395
10396 =item Building
10397
10398 =item Testing Perl on Win32
10399
10400 =item Installation of Perl on Win32
10401
10402 =item Usage Hints for Perl on Win32
10403
10404 Environment Variables, File Globbing, Using perl from the command line,
10405 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
10406 Extensions, Notes on 64-bit Windows
10407
10408 =item Running Perl Scripts
10409
10410 =item Miscellaneous Things
10411
10412 =back
10413
10414 =item BUGS AND CAVEATS
10415
10416 =item ACKNOWLEDGEMENTS
10417
10418 =item AUTHORS
10419
10420 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
10421 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
10422 E<lt>nick@ing-simmons.netE<gt>, Jan Dubois E<lt>jand@activestate.comE<gt>,
10423 Steve Hay E<lt>steve.hay@uk.radan.comE<gt>
10424
10425 =item SEE ALSO
10426
10427 =item HISTORY
10428
10429 =back
10430
10431 =head1 PRAGMA DOCUMENTATION
10432
10433 =head2 attrs - set/get attributes of a subroutine (deprecated)
10434
10435 =over 4
10436
10437 =item SYNOPSIS
10438
10439 =item DESCRIPTION
10440
10441 method, locked
10442
10443 =back
10444
10445 =head2 re - Perl pragma to alter regular expression behaviour
10446
10447 =over 4
10448
10449 =item SYNOPSIS
10450
10451 =item DESCRIPTION
10452
10453 =back
10454
10455 =head2 threadshared::shared, threads::shared - Perl extension for sharing
10456 data structures between threads
10457
10458 =over 4
10459
10460 =item SYNOPSIS
10461
10462 =item DESCRIPTION
10463
10464 =item EXPORT
10465
10466 =item FUNCTIONS
10467
10468 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
10469 LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
10470 ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
10471
10472 =item NOTES
10473
10474 =item BUGS
10475
10476 =item AUTHOR
10477
10478 =item SEE ALSO
10479
10480 =back
10481
10482 =head2 threads - Perl extension allowing use of interpreter based threads
10483 from perl
10484
10485 =over 4
10486
10487 =item SYNOPSIS
10488
10489 =item DESCRIPTION
10490
10491 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
10492 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
10493 threads->list();, async BLOCK;
10494
10495 =item WARNINGS
10496
10497 A thread exited while %d other threads were still running
10498
10499 =item TODO
10500
10501 =item BUGS
10502
10503 Parent-Child threads, tid is I32, Returning objects, Creating threads
10504 inside BEGIN blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
10505
10506 =item AUTHOR and COPYRIGHT
10507
10508 =item SEE ALSO
10509
10510 =back
10511
10512 =head2 assertions - select assertions in blocks of code
10513
10514 =over 4
10515
10516 =item SYNOPSIS
10517
10518 =item DESCRIPTION
10519
10520 =over 4
10521
10522 =item Selecting assertions
10523
10524 =item Handling assertions your own way
10525
10526 enabled($on), enabled(), seen($on), seen()
10527
10528 =back
10529
10530 =item COMPATIBILITY
10531
10532 =item SEE ALSO
10533
10534 =item AUTHOR
10535
10536 =item COPYRIGHT AND LICENSE
10537
10538 =back
10539
10540 =head2 assertions::activate - activate assertions
10541
10542 =over 4
10543
10544 =item SYNOPSIS
10545
10546 =item DESCRIPTION
10547
10548 =item SEE ALSO
10549
10550 =item AUTHOR
10551
10552 =item COPYRIGHT AND LICENSE
10553
10554 =back
10555
10556 =head2 assertions::compat - assertions for pre-5.9 versions of perl
10557
10558 =over 4
10559
10560 =item SYNOPSIS
10561
10562 =item DESCRIPTION
10563
10564 =over 4
10565
10566 =item The C<assertion> attribute handler
10567
10568 =item Assertion execution status as a constant
10569
10570 =back
10571
10572 =item SEE ALSO
10573
10574 =item AUTHOR
10575
10576 =item COPYRIGHT AND LICENSE
10577
10578 =back
10579
10580 =head2 attributes - get/set subroutine or variable attributes
10581
10582 =over 4
10583
10584 =item SYNOPSIS
10585
10586 =item DESCRIPTION
10587
10588 =over 4
10589
10590 =item Built-in Attributes
10591
10592 locked, method, lvalue
10593
10594 =item Available Subroutines
10595
10596 get, reftype
10597
10598 =item Package-specific Attribute Handling
10599
10600 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
10601
10602 =item Syntax of Attribute Lists
10603
10604 =back
10605
10606 =item EXPORTS
10607
10608 =over 4
10609
10610 =item Default exports
10611
10612 =item Available exports
10613
10614 =item Export tags defined
10615
10616 =back
10617
10618 =item EXAMPLES
10619
10620 =item SEE ALSO
10621
10622 =back
10623
10624 =head2 autouse - postpone load of modules until a function is used
10625
10626 =over 4
10627
10628 =item SYNOPSIS
10629
10630 =item DESCRIPTION
10631
10632 =item WARNING
10633
10634 =item AUTHOR
10635
10636 =item SEE ALSO
10637
10638 =back
10639
10640 =head2 base - Establish IS-A relationship with base classes at compile time
10641
10642 =over 4
10643
10644 =item SYNOPSIS
10645
10646 =item DESCRIPTION
10647
10648 =item DIAGNOSTICS
10649
10650 Base class package "%s" is empty
10651
10652 =item HISTORY
10653
10654 =item CAVEATS
10655
10656 =item SEE ALSO
10657
10658 =back
10659
10660 =head2 bigint - Transparent BigInteger support for Perl
10661
10662 =over 4
10663
10664 =item SYNOPSIS
10665
10666 =item DESCRIPTION
10667
10668 =over 4
10669
10670 =item Options
10671
10672 a or accuracy, p or precision, t or trace, l or lib, v or version
10673
10674 =item Math Library
10675
10676 =item Internal Format
10677
10678 =item Sign
10679
10680 =item Methods
10681
10682 =item Caveat
10683
10684 =back
10685
10686 =item MODULES USED
10687
10688 =item EXAMPLES
10689
10690 =item LICENSE
10691
10692 =item SEE ALSO
10693
10694 =item AUTHORS
10695
10696 =back
10697
10698 =head2 bignum - Transparent BigNumber support for Perl
10699
10700 =over 4
10701
10702 =item SYNOPSIS
10703
10704 =item DESCRIPTION
10705
10706 =over 4
10707
10708 =item Options
10709
10710 a or accuracy, p or precision, t or trace, l or lib, v or version
10711
10712 =item Methods
10713
10714 =item Caveat
10715
10716 inf(), NaN(), upgrade()
10717
10718 =item MATH LIBRARY
10719
10720 =item INTERNAL FORMAT
10721
10722 =item SIGN
10723
10724 =back
10725
10726 =item MODULES USED
10727
10728 =item EXAMPLES
10729
10730 =item LICENSE
10731
10732 =item SEE ALSO
10733
10734 =item AUTHORS
10735
10736 =back
10737
10738 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
10739
10740 =over 4
10741
10742 =item SYNOPSIS
10743
10744 =item DESCRIPTION
10745
10746 =over 4
10747
10748 =item Modules Used
10749
10750 =item Math Library
10751
10752 =item Sign
10753
10754 =item Methods
10755
10756 =item Caveat
10757
10758 =item Options
10759
10760 a or accuracy, p or precision, t or trace, l or lib, v or version
10761
10762 =back
10763
10764 =item EXAMPLES
10765
10766         perl -Mbigrat -le 'print sqrt(33)'
10767         perl -Mbigrat -le 'print 2*255'
10768         perl -Mbigrat -le 'print 4.5+2*255'
10769         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'       
10770         perl -Mbigrat -le 'print 12->is_odd()';
10771
10772 =item LICENSE
10773
10774 =item SEE ALSO
10775
10776 =item AUTHORS
10777
10778 =back
10779
10780 =head2 blib - Use MakeMaker's uninstalled version of a package
10781
10782 =over 4
10783
10784 =item SYNOPSIS
10785
10786 =item DESCRIPTION
10787
10788 =item BUGS
10789
10790 =item AUTHOR
10791
10792 =back
10793
10794 =head2 bytes - Perl pragma to force byte semantics rather than character
10795 semantics
10796
10797 =over 4
10798
10799 =item SYNOPSIS
10800
10801 =item DESCRIPTION
10802
10803 =item LIMITATIONS
10804
10805 =item SEE ALSO
10806
10807 =back
10808
10809 =head2 charnames - define character names for C<\N{named}> string literal
10810 escapes
10811
10812 =over 4
10813
10814 =item SYNOPSIS
10815
10816 =item DESCRIPTION
10817
10818 =item CUSTOM TRANSLATORS
10819
10820 =item CUSTOM ALIASES
10821
10822 =over 4
10823
10824 =item Anonymous hashes
10825
10826 =item Alias file
10827
10828 =item Alias shortcut
10829
10830 =back
10831
10832 =item charnames::viacode(code)
10833
10834 =item charnames::vianame(name)
10835
10836 =item ALIASES
10837
10838 =item ILLEGAL CHARACTERS
10839
10840 =item BUGS
10841
10842 =back
10843
10844 =head2 constant - Perl pragma to declare constants
10845
10846 =over 4
10847
10848 =item SYNOPSIS
10849
10850 =item DESCRIPTION
10851
10852 =item NOTES
10853
10854 =over 4
10855
10856 =item List constants
10857
10858 =item Defining multiple constants at once
10859
10860 =item Magic constants
10861
10862 =back
10863
10864 =item TECHNICAL NOTES
10865
10866 =item BUGS
10867
10868 =item AUTHOR
10869
10870 =item COPYRIGHT
10871
10872 =back
10873
10874 =head2 diagnostics, splain - produce verbose warning diagnostics
10875
10876 =over 4
10877
10878 =item SYNOPSIS
10879
10880 =item DESCRIPTION
10881
10882 =over 4
10883
10884 =item The C<diagnostics> Pragma
10885
10886 =item The I<splain> Program
10887
10888 =back
10889
10890 =item EXAMPLES
10891
10892 =item INTERNALS
10893
10894 =item BUGS
10895
10896 =item AUTHOR
10897
10898 =back
10899
10900 =head2 encoding - allows you to write your script in non-ascii or non-utf8
10901
10902 =over 4
10903
10904 =item SYNOPSIS
10905
10906 =item ABSTRACT
10907
10908 =over 4
10909
10910 =item Literal Conversions
10911
10912 =item PerlIO layers for C<STD(IN|OUT)>
10913
10914 =item Implicit upgrading for byte strings
10915
10916 =back
10917
10918 =item FEATURES THAT REQUIRE 5.8.1
10919
10920 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
10921
10922 =item USAGE
10923
10924 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
10925 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
10926
10927 =item The Filter Option
10928
10929 =over 4
10930
10931 =item Filter-related changes at Encode version 1.87
10932
10933 =back
10934
10935 =item CAVEATS
10936
10937 =over 4
10938
10939 =item NOT SCOPED
10940
10941 =item DO NOT MIX MULTIPLE ENCODINGS
10942
10943 =item tr/// with ranges
10944
10945 Legend of characters above
10946
10947 =back
10948
10949 =item EXAMPLE - Greekperl
10950
10951 =item KNOWN PROBLEMS
10952
10953 literals in regex that are longer than 127 bytes, EBCDIC, format
10954
10955 =over 4
10956
10957 =item The Logic of :locale
10958
10959 =back
10960
10961 =item HISTORY
10962
10963 =item SEE ALSO
10964
10965 =back
10966
10967 =head2 encoding::warnings - Warn on implicit encoding conversions
10968
10969 =over 4
10970
10971 =item VERSION
10972
10973 =item SYNOPSIS
10974
10975 =item DESCRIPTION
10976
10977 =over 4
10978
10979 =item Overview of the problem
10980
10981 =item Detecting the problem
10982
10983 =item Solving the problem
10984
10985 Upgrade both sides to unicode-strings, Downgrade both sides to
10986 byte-strings, Specify the encoding for implicit byte-string upgrading,
10987 PerlIO layers for B<STDIN> and B<STDOUT>, Literal conversions, Implicit
10988 upgrading for byte-strings
10989
10990 =back
10991
10992 =item CAVEATS
10993
10994 =back
10995
10996 =over 4
10997
10998 =item SEE ALSO
10999
11000 =item AUTHORS
11001
11002 =item COPYRIGHT
11003
11004 =back
11005
11006 =head2 feature - Perl pragma to enable new syntactic features
11007
11008 =over 4
11009
11010 =item SYNOPSIS
11011
11012 =item DESCRIPTION
11013
11014 =over 4
11015
11016 =item The 'switch' feature
11017
11018 =item The '~~' feature
11019
11020 =item The 'say' feature
11021
11022 =item the 'err' feature
11023
11024 =back
11025
11026 =item FEATURE BUNDLES
11027
11028 =back
11029
11030 =head2 fields - compile-time class fields
11031
11032 =over 4
11033
11034 =item SYNOPSIS
11035
11036 =item DESCRIPTION
11037
11038 new, phash
11039
11040 =item SEE ALSO
11041
11042 =back
11043
11044 =head2 filetest - Perl pragma to control the filetest permission operators
11045
11046 =over 4
11047
11048 =item SYNOPSIS
11049
11050 =item DESCRIPTION
11051
11052 =over 4
11053
11054 =item subpragma access
11055
11056 =back
11057
11058 =back
11059
11060 =head2 if - C<use> a Perl module if a condition holds
11061
11062 =over 4
11063
11064 =item SYNOPSIS
11065
11066 =item DESCRIPTION
11067
11068 =item BUGS
11069
11070 =item AUTHOR
11071
11072 =back
11073
11074 =head2 integer - Perl pragma to use integer arithmetic instead of floating
11075 point
11076
11077 =over 4
11078
11079 =item SYNOPSIS
11080
11081 =item DESCRIPTION
11082
11083 =back
11084
11085 =head2 less - perl pragma to request less of something from the compiler
11086
11087 =over 4
11088
11089 =item SYNOPSIS
11090
11091 =item DESCRIPTION
11092
11093 =back
11094
11095 =head2 lib - manipulate @INC at compile time
11096
11097 =over 4
11098
11099 =item SYNOPSIS
11100
11101 =item DESCRIPTION
11102
11103 =over 4
11104
11105 =item Adding directories to @INC
11106
11107 =item Deleting directories from @INC
11108
11109 =item Restoring original @INC
11110
11111 =back
11112
11113 =item CAVEATS
11114
11115 =item NOTES
11116
11117 =item SEE ALSO
11118
11119 =item AUTHOR
11120
11121 =back
11122
11123 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
11124 operations
11125
11126 =over 4
11127
11128 =item SYNOPSIS
11129
11130 =item DESCRIPTION
11131
11132 =back
11133
11134 =head2 open - perl pragma to set default PerlIO layers for input and output
11135
11136 =over 4
11137
11138 =item SYNOPSIS
11139
11140 =item DESCRIPTION
11141
11142 =item NONPERLIO FUNCTIONALITY
11143
11144 =item IMPLEMENTATION DETAILS
11145
11146 =item SEE ALSO
11147
11148 =back
11149
11150 =head2 ops - Perl pragma to restrict unsafe operations when compiling
11151
11152 =over 4
11153
11154 =item SYNOPSIS  
11155
11156 =item DESCRIPTION
11157
11158 =item SEE ALSO
11159
11160 =back
11161
11162 =head2 overload - Package for overloading Perl operations
11163
11164 =over 4
11165
11166 =item SYNOPSIS
11167
11168 =item DESCRIPTION
11169
11170 =over 4
11171
11172 =item Declaration of overloaded functions
11173
11174 =item Calling Conventions for Binary Operations
11175
11176 FALSE, TRUE, C<undef>
11177
11178 =item Calling Conventions for Unary Operations
11179
11180 =item Calling Conventions for Mutators
11181
11182 C<++> and C<-->, C<x=> and other assignment versions
11183
11184 =item Overloadable Operations
11185
11186 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
11187 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
11188 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
11189
11190 =item Inheritance and overloading
11191
11192 Strings as values of C<use overload> directive, Overloading of an operation
11193 is inherited by derived classes
11194
11195 =back
11196
11197 =item SPECIAL SYMBOLS FOR C<use overload>
11198
11199 =over 4
11200
11201 =item Last Resort
11202
11203 =item Fallback
11204
11205 =item Smart Match
11206
11207 C<undef>, TRUE, defined, but FALSE
11208
11209 =item Copy Constructor
11210
11211 B<Example>
11212
11213 =back
11214
11215 =item MAGIC AUTOGENERATION
11216
11217 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
11218 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
11219 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
11220 I<Copy operator>
11221
11222 =item Losing overloading
11223
11224 =item Run-time Overloading
11225
11226 =item Public functions
11227
11228 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
11229
11230 =item Overloading constants
11231
11232 integer, float, binary, q, qr
11233
11234 =item IMPLEMENTATION
11235
11236 =item Metaphor clash
11237
11238 =item Cookbook
11239
11240 =over 4
11241
11242 =item Two-face scalars
11243
11244 =item Two-face references
11245
11246 =item Symbolic calculator
11247
11248 =item I<Really> symbolic calculator
11249
11250 =back
11251
11252 =item AUTHOR
11253
11254 =item DIAGNOSTICS
11255
11256 Odd number of arguments for overload::constant, `%s' is not an overloadable
11257 type, `%s' is not a code reference
11258
11259 =item BUGS
11260
11261 =back
11262
11263 =head2 sigtrap - Perl pragma to enable simple signal handling
11264
11265 =over 4
11266
11267 =item SYNOPSIS
11268
11269 =item DESCRIPTION
11270
11271 =item OPTIONS
11272
11273 =over 4
11274
11275 =item SIGNAL HANDLERS
11276
11277 B<stack-trace>, B<die>, B<handler> I<your-handler>
11278
11279 =item SIGNAL LISTS
11280
11281 B<normal-signals>, B<error-signals>, B<old-interface-signals>
11282
11283 =item OTHER
11284
11285 B<untrapped>, B<any>, I<signal>, I<number>
11286
11287 =back
11288
11289 =item EXAMPLES
11290
11291 =back
11292
11293 =head2 sort - perl pragma to control sort() behaviour
11294
11295 =over 4
11296
11297 =item SYNOPSIS
11298
11299 =item DESCRIPTION
11300
11301 =item CAVEATS
11302
11303 =back
11304
11305 =head2 strict - Perl pragma to restrict unsafe constructs
11306
11307 =over 4
11308
11309 =item SYNOPSIS
11310
11311 =item DESCRIPTION
11312
11313 C<strict refs>, C<strict vars>, C<strict subs>
11314
11315 =item HISTORY
11316
11317 =back
11318
11319 =head2 subs - Perl pragma to predeclare sub names
11320
11321 =over 4
11322
11323 =item SYNOPSIS
11324
11325 =item DESCRIPTION
11326
11327 =back
11328
11329 =head2 threadshared, threads::shared - Perl extension for sharing data
11330 structures between threads
11331
11332 =over 4
11333
11334 =item SYNOPSIS
11335
11336 =item DESCRIPTION
11337
11338 =item EXPORT
11339
11340 =item FUNCTIONS
11341
11342 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
11343 LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
11344 ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
11345
11346 =item NOTES
11347
11348 =item BUGS
11349
11350 =item AUTHOR
11351
11352 =item SEE ALSO
11353
11354 =back
11355
11356 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
11357 code
11358
11359 =over 4
11360
11361 =item SYNOPSIS
11362
11363 =item DESCRIPTION
11364
11365 =over 4
11366
11367 =item Utility functions
11368
11369 $num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[,
11370 FAIL_OK]), utf8::encode($string), utf8::decode($string), $flag =
11371 utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
11372
11373 =back
11374
11375 =item BUGS
11376
11377 =item SEE ALSO
11378
11379 =back
11380
11381 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
11382
11383 =over 4
11384
11385 =item SYNOPSIS
11386
11387 =item DESCRIPTION
11388
11389 =back
11390
11391 =head2 version - Perl extension for Version Objects
11392
11393 =over 4
11394
11395 =item SYNOPSIS
11396
11397 =item DESCRIPTION
11398
11399 =over 4
11400
11401 =item BEST PRACTICES
11402
11403 Be consistent, Be careful
11404
11405 =item What IS a version
11406
11407 Numeric Versions, Extended Versions
11408
11409 =item Numeric Versions
11410
11411 =item Extended Versions
11412
11413 =item Numeric Alpha Versions
11414
11415 =item Object Methods
11416
11417 New Operator, qv(), Normal Form, Numification, Stringification, Comparison
11418 operators, Logical Operators
11419
11420 =item Quoting
11421
11422 =item What about v-strings?
11423
11424 =item Types of Versions Objects
11425
11426 Ordinary versions, Alpha Versions
11427
11428 =item Replacement UNIVERSAL::VERSION
11429
11430 =back
11431
11432 =item SUBCLASSING
11433
11434 =item EXPORT
11435
11436 =item AUTHOR
11437
11438 =item SEE ALSO
11439
11440 =back
11441
11442 =head2 vmsish - Perl pragma to control VMS-specific language features
11443
11444 =over 4
11445
11446 =item SYNOPSIS
11447
11448 =item DESCRIPTION
11449
11450 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
11451
11452 =back
11453
11454 =head2 warnings - Perl pragma to control optional warnings
11455
11456 =over 4
11457
11458 =item SYNOPSIS
11459
11460 =item DESCRIPTION
11461
11462 use warnings::register, warnings::enabled(), warnings::enabled($category),
11463 warnings::enabled($object), warnings::warn($message),
11464 warnings::warn($category, $message), warnings::warn($object, $message),
11465 warnings::warnif($message), warnings::warnif($category, $message),
11466 warnings::warnif($object, $message)
11467
11468 =back
11469
11470 =head2 warnings::register - warnings import function
11471
11472 =over 4
11473
11474 =item SYNOPSIS
11475
11476 =item DESCRIPTION
11477
11478 =back
11479
11480 =head1 MODULE DOCUMENTATION
11481
11482 =head2 AnyDBM_File - provide framework for multiple DBMs
11483
11484 =over 4
11485
11486 =item SYNOPSIS
11487
11488 =item DESCRIPTION
11489
11490 =over 4
11491
11492 =item DBM Comparisons
11493
11494 [0], [1], [2], [3]
11495
11496 =back
11497
11498 =item SEE ALSO
11499
11500 =back
11501
11502 =head2 Archive::Tar - module for manipulations of tar archives
11503
11504 =over 4
11505
11506 =item SYNOPSIS
11507
11508 =item DESCRIPTION
11509
11510 =item Object Methods
11511
11512 =over 4
11513
11514 =item Archive::Tar->new( [$file, $compressed] )
11515
11516 =back
11517
11518 =back
11519
11520 =over 4
11521
11522 =item $tar->read ( $filename|$handle, $compressed, {opt => 'val'} )
11523
11524 limit, extract
11525
11526 =back
11527
11528 =over 4
11529
11530 =item $tar->contains_file( $filename )
11531
11532 =back
11533
11534 =over 4
11535
11536 =item $tar->extract( [@filenames] )
11537
11538 =back
11539
11540 =over 4
11541
11542 =item $tar->extract_file( $file, [$extract_path] )
11543
11544 =back
11545
11546 =over 4
11547
11548 =item $tar->list_files( [\@properties] )
11549
11550 =back
11551
11552 =over 4
11553
11554 =item $tar->get_files( [@filenames] )
11555
11556 =back
11557
11558 =over 4
11559
11560 =item $tar->get_content( $file )
11561
11562 =back
11563
11564 =over 4
11565
11566 =item $tar->replace_content( $file, $content )
11567
11568 =back
11569
11570 =over 4
11571
11572 =item $tar->rename( $file, $new_name )
11573
11574 =back
11575
11576 =over 4
11577
11578 =item $tar->remove (@filenamelist)
11579
11580 =back
11581
11582 =over 4
11583
11584 =item $tar->clear
11585
11586 =back
11587
11588 =over 4
11589
11590 =item $tar->write ( [$file, $compressed, $prefix] )
11591
11592 =back
11593
11594 =over 4
11595
11596 =item $tar->add_files( @filenamelist )
11597
11598 =back
11599
11600 =over 4
11601
11602 =item $tar->add_data ( $filename, $data, [$opthashref] )
11603
11604 =back
11605
11606 =over 4
11607
11608 =item $tar->error( [$BOOL] )
11609
11610 =back
11611
11612 =over 4
11613
11614 =item $bool = $tar->has_io_string
11615
11616 =back
11617
11618 =over 4
11619
11620 =item $bool = $tar->has_perlio
11621
11622 =back
11623
11624 =over 4
11625
11626 =item Class Methods
11627
11628 =over 4
11629
11630 =item Archive::Tar->create_archive($file, $compression, @filelist)
11631
11632 =back
11633
11634 =back
11635
11636 =over 4
11637
11638 =item Archive::Tar->list_archive ($file, $compressed, [\@properties])
11639
11640 =back
11641
11642 =over 4
11643
11644 =item Archive::Tar->extract_archive ($file, $gzip)
11645
11646 =back
11647
11648 =over 4
11649
11650 =item Archive::Tar->can_handle_compressed_files
11651
11652 =back
11653
11654 =over 4
11655
11656 =item GLOBAL VARIABLES
11657
11658 =over 4
11659
11660 =item $Archive::Tar::FOLLOW_SYMLINK
11661
11662 =item $Archive::Tar::CHOWN
11663
11664 =item $Archive::Tar::CHMOD
11665
11666 =item $Archive::Tar::DO_NOT_USE_PREFIX
11667
11668 =item $Archive::Tar::DEBUG
11669
11670 =item $Archive::Tar::WARN
11671
11672 =item $Archive::Tar::error
11673
11674 =item $Archive::Tar::HAS_PERLIO
11675
11676 =item $Archive::Tar::HAS_IO_STRING
11677
11678 =back
11679
11680 =item FAQ
11681
11682 What's the minimum perl version required to run Archive::Tar?, Isn't
11683 Archive::Tar slow?, Isn't Archive::Tar heavier on memory than /bin/tar?,
11684 Can't you lazy-load data instead?, How much memory will an X kb tar file
11685 need?, What do you do with unsupported filetypes in an archive?, How do I
11686 access .tar.Z files?
11687
11688 =item TODO
11689
11690 Check if passed in handles are open for read/write
11691
11692 =item AUTHOR
11693
11694 =item ACKNOWLEDGEMENTS
11695
11696 =item COPYRIGHT
11697
11698 =back
11699
11700 =head2 Archive::Tar::File - a subclass for in-memory extracted file from
11701 Archive::Tar
11702
11703 =over 4
11704
11705 =item SYNOPSIS
11706
11707 =item DESCRIPTION
11708
11709 =over 4
11710
11711 =item Accessors
11712
11713 name, mode, uid, gid, size, mtime, chksum, type, linkname, magic, version,
11714 uname, gname, devmajor, devminor, prefix, raw
11715
11716 =back
11717
11718 =item Methods
11719
11720 =over 4
11721
11722 =item new( file => $path )
11723
11724 =item new( data => $path, $data, $opt )
11725
11726 =item new( chunk => $chunk )
11727
11728 =back
11729
11730 =back
11731
11732 =over 4
11733
11734 =item full_path
11735
11736 =back
11737
11738 =over 4
11739
11740 =item validate
11741
11742 =back
11743
11744 =over 4
11745
11746 =item has_content
11747
11748 =back
11749
11750 =over 4
11751
11752 =item get_content
11753
11754 =back
11755
11756 =over 4
11757
11758 =item get_content_by_ref
11759
11760 =back
11761
11762 =over 4
11763
11764 =item replace_content( $content )
11765
11766 =back
11767
11768 =over 4
11769
11770 =item rename( $new_name )
11771
11772 =back
11773
11774 =over 4
11775
11776 =item Convenience methods
11777
11778 is_file, is_dir, is_hardlink, is_symlink, is_chardev, is_blockdev, is_fifo,
11779 is_socket, is_longlink, is_label, is_unknown
11780
11781 =back
11782
11783 =head2 Attribute::Handlers - Simpler definition of attribute handlers
11784
11785 =over 4
11786
11787 =item VERSION
11788
11789 =item SYNOPSIS
11790
11791 =item DESCRIPTION
11792
11793 [0], [1], [2], [3], [4], [5]
11794
11795 =over 4
11796
11797 =item Typed lexicals
11798
11799 =item Type-specific attribute handlers
11800
11801 =item Non-interpretive attribute handlers
11802
11803 =item Phase-specific attribute handlers
11804
11805 =item Attributes as C<tie> interfaces
11806
11807 =back
11808
11809 =item EXAMPLES
11810
11811 =item DIAGNOSTICS
11812
11813 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
11814 attributes>, C<Declaration of %s attribute in package %s may clash with
11815 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
11816 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
11817 be able to apply END handler>
11818
11819 =item AUTHOR
11820
11821 =item BUGS
11822
11823 =item COPYRIGHT
11824
11825 =back
11826
11827 =head2 AutoLoader - load subroutines only on demand
11828
11829 =over 4
11830
11831 =item SYNOPSIS
11832
11833 =item DESCRIPTION
11834
11835 =over 4
11836
11837 =item Subroutine Stubs
11838
11839 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
11840
11841 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
11842
11843 =item Package Lexicals
11844
11845 =item Not Using AutoLoader
11846
11847 =item B<AutoLoader> vs. B<SelfLoader>
11848
11849 =back
11850
11851 =item CAVEATS
11852
11853 =item SEE ALSO
11854
11855 =back
11856
11857 =head2 AutoSplit - split a package for autoloading
11858
11859 =over 4
11860
11861 =item SYNOPSIS
11862
11863 =item DESCRIPTION
11864
11865 $keep, $check, $modtime
11866
11867 =over 4
11868
11869 =item Multiple packages
11870
11871 =back
11872
11873 =item DIAGNOSTICS
11874
11875 =back
11876
11877 =head2 B - The Perl Compiler
11878
11879 =over 4
11880
11881 =item SYNOPSIS
11882
11883 =item DESCRIPTION
11884
11885 =item OVERVIEW
11886
11887 =item Utility Functions
11888
11889 =over 4
11890
11891 =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV>
11892 objects
11893
11894 sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av,
11895 check_av, begin_av, end_av, comppadlist, regex_padav, main_cv
11896
11897 =item Functions for Examining the Symbol Table
11898
11899 walksymtable(SYMREF, METHOD, RECURSE, PREFIX)
11900
11901 =item Functions Returning C<B::OP> objects or for walking op trees
11902
11903 main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG)
11904
11905 =item Miscellaneous Utility Functions
11906
11907 ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR),
11908 perlstring(STR), class(OBJ), threadsv_names
11909
11910 =back
11911
11912 =item OVERVIEW OF CLASSES
11913
11914 =over 4
11915
11916 =item SV-RELATED CLASSES
11917
11918 =item B::SV Methods
11919
11920 REFCNT, FLAGS, object_2svref
11921
11922 =item B::IV Methods
11923
11924 IV, IVX, UVX, int_value, needs64bits, packiv
11925
11926 =item B::NV Methods
11927
11928 NV, NVX
11929
11930 =item B::RV Methods
11931
11932 RV
11933
11934 =item B::PV Methods
11935
11936 PV, RV, PVX
11937
11938 =item B::PVMG Methods
11939
11940 MAGIC, SvSTASH
11941
11942 =item B::MAGIC Methods
11943
11944 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
11945
11946 =item B::PVLV Methods
11947
11948 TARGOFF, TARGLEN, TYPE, TARG
11949
11950 =item B::BM Methods
11951
11952 USEFUL, PREVIOUS, RARE, TABLE
11953
11954 =item B::GV Methods
11955
11956 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
11957 LINE, FILE, FILEGV, GvREFCNT, FLAGS
11958
11959 =item B::IO Methods
11960
11961 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
11962 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
11963
11964 =item B::AV Methods
11965
11966 FILL, MAX, ARRAY, ARRAYelt, OFF, AvFLAGS
11967
11968 =item B::CV Methods
11969
11970 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB,
11971 XSUBANY, CvFLAGS, const_sv
11972
11973 =item B::HV Methods
11974
11975 FILL, MAX, KEYS, RITER, NAME, ARRAY, PMROOT
11976
11977 =item OP-RELATED CLASSES
11978
11979 =item B::OP Methods
11980
11981 next, sibling, name, ppaddr, desc, targ, type, opt, static, flags, private,
11982 spare
11983
11984 =item B::UNOP METHOD
11985
11986 first
11987
11988 =item B::BINOP METHOD
11989
11990 last
11991
11992 =item B::LOGOP METHOD
11993
11994 other
11995
11996 =item B::LISTOP METHOD
11997
11998 children
11999
12000 =item B::PMOP Methods
12001
12002 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
12003 pmpermflags, precomp, pmoffset
12004
12005 =item B::SVOP METHOD
12006
12007 sv, gv
12008
12009 =item B::PADOP METHOD
12010
12011 padix
12012
12013 =item B::PVOP METHOD
12014
12015 pv
12016
12017 =item B::LOOP Methods
12018
12019 redoop, nextop, lastop
12020
12021 =item B::COP Methods
12022
12023 label, stash, stashpv, file, cop_seq, arybase, line, warnings, io
12024
12025 =back
12026
12027 =item AUTHOR
12028
12029 =back
12030
12031 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
12032 bytecode
12033
12034 =over 4
12035
12036 =item SYNOPSIS
12037
12038 =item DESCRIPTION
12039
12040 %insn_data, @insn_name, @optype, @specialsv_name
12041
12042 =item AUTHOR
12043
12044 =back
12045
12046 =head2 B::Assembler - Assemble Perl bytecode
12047
12048 =over 4
12049
12050 =item SYNOPSIS
12051
12052 =item DESCRIPTION
12053
12054 =item AUTHORS
12055
12056 =back
12057
12058 =head2 B::Bblock - Walk basic blocks
12059
12060 =over 4
12061
12062 =item SYNOPSIS
12063
12064 =item DESCRIPTION
12065
12066 =over 4
12067
12068 =item Functions
12069
12070 B<find_leaders>
12071
12072 =back
12073
12074 =item AUTHOR
12075
12076 =back
12077
12078 =head2 B::Bytecode - Perl compiler's bytecode backend
12079
12080 =over 4
12081
12082 =item SYNOPSIS
12083
12084 =item DESCRIPTION
12085
12086 =item EXAMPLE
12087
12088 =item OPTIONS
12089
12090 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
12091
12092 =item KNOWN BUGS
12093
12094 =item NOTICE
12095
12096 =item AUTHORS
12097
12098 =back
12099
12100 =head2 B::C - Perl compiler's C backend
12101
12102 =over 4
12103
12104 =item SYNOPSIS
12105
12106 =item DESCRIPTION
12107
12108 =item OPTIONS
12109
12110 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
12111 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
12112 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
12113 B<-llimit>
12114
12115 =item EXAMPLES
12116
12117 =item BUGS
12118
12119 =item AUTHOR
12120
12121 =back
12122
12123 =head2 B::CC - Perl compiler's optimized C translation backend
12124
12125 =over 4
12126
12127 =item SYNOPSIS
12128
12129 =item DESCRIPTION
12130
12131 =item OPTIONS
12132
12133 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
12134 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
12135 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
12136
12137 =item EXAMPLES
12138
12139 =item BUGS
12140
12141 =item DIFFERENCES
12142
12143 =over 4
12144
12145 =item Loops
12146
12147 =item Context of ".."
12148
12149 =item Arithmetic
12150
12151 =item Deprecated features
12152
12153 =back
12154
12155 =item AUTHOR
12156
12157 =back
12158
12159 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
12160
12161 =over 4
12162
12163 =item SYNOPSIS
12164
12165 =item DESCRIPTION
12166
12167 =item EXAMPLE
12168
12169 =item OPTIONS
12170
12171 =over 4
12172
12173 =item Options for Opcode Ordering
12174
12175 B<-basic>, B<-exec>, B<-tree>
12176
12177 =item Options for Line-Style
12178
12179 B<-concise>, B<-terse>, B<-linenoise>, B<-debug>, B<-env>
12180
12181 =item Options for tree-specific formatting
12182
12183 B<-compact>, B<-loose>, B<-vt>, B<-ascii>
12184
12185 =item Options controlling sequence numbering
12186
12187 B<-base>I<n>, B<-bigendian>, B<-littleendian>
12188
12189 =item Other options
12190
12191 B<-main>, B<-nomain>, B<-nobanner>, B<-banner>, B<-banneris> => subref
12192
12193 =item Option Stickiness
12194
12195 =back
12196
12197 =item ABBREVIATIONS
12198
12199 =over 4
12200
12201 =item OP class abbreviations
12202
12203 =item OP flags abbreviations
12204
12205 =back
12206
12207 =item FORMATTING SPECIFICATIONS
12208
12209 =over 4
12210
12211 =item Special Patterns
12212
12213 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
12214 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
12215 B<~>
12216
12217 =item # Variables
12218
12219 B<#>I<var>, B<#>I<var>I<N>, B<#>I<Var>, B<#addr>, B<#arg>, B<#class>,
12220 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
12221 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
12222 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
12223 B<#seq>, B<#seqnum>, B<#opt>, B<#static>, B<#sibaddr>, B<#svaddr>,
12224 B<#svclass>, B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
12225
12226 =back
12227
12228 =item One-Liner Command tips
12229
12230 perl -MO=Concise,bar foo.pl, perl -MDigest::MD5=md5 -MO=Concise,md5 -e1,
12231 perl -MPOSIX -MO=Concise,_POSIX_ARG_MAX -e1, perl -MPOSIX -MO=Concise,a -e
12232 'print _POSIX_SAVED_IDS', perl -MPOSIX -MO=Concise,a -e 'sub
12233 a{_POSIX_SAVED_IDS}'
12234
12235 =item Using B::Concise outside of the O framework
12236
12237 =over 4
12238
12239 =item Example: Altering Concise Renderings
12240
12241 =item set_style()
12242
12243 =item set_style_standard($name)
12244
12245 =item add_style()
12246
12247 =item add_callback()
12248
12249 =item Running B::Concise::compile()
12250
12251 =item B::Concise::reset_sequence()
12252
12253 =item Errors
12254
12255 =back
12256
12257 =item AUTHOR
12258
12259 =back
12260
12261 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
12262
12263 =over 4
12264
12265 =item SYNOPSIS
12266
12267 =item DESCRIPTION
12268
12269 =item AUTHOR
12270
12271 =back
12272
12273 =head2 B::Deparse - Perl compiler backend to produce perl code
12274
12275 =over 4
12276
12277 =item SYNOPSIS
12278
12279 =item DESCRIPTION
12280
12281 =item OPTIONS
12282
12283 B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>,
12284 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
12285
12286 =item USING B::Deparse AS A MODULE
12287
12288 =over 4
12289
12290 =item Synopsis
12291
12292 =item Description
12293
12294 =item new
12295
12296 =item ambient_pragmas
12297
12298 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
12299
12300 =item coderef2text
12301
12302 =back
12303
12304 =item BUGS
12305
12306 =item AUTHOR
12307
12308 =back
12309
12310 =head2 B::Disassembler - Disassemble Perl bytecode
12311
12312 =over 4
12313
12314 =item SYNOPSIS
12315
12316 =item DESCRIPTION
12317
12318 =item AUTHOR
12319
12320 =back
12321
12322 =head2 B::Lint - Perl lint
12323
12324 =over 4
12325
12326 =item SYNOPSIS
12327
12328 =item DESCRIPTION
12329
12330 =item OPTIONS AND LINT CHECKS
12331
12332 B<context>, B<implicit-read> and B<implicit-write>, B<bare-subs>,
12333 B<dollar-underscore>, B<private-names>, B<undefined-subs>,
12334 B<regexp-variables>, B<all>, B<none>
12335
12336 =item NON LINT-CHECK OPTIONS
12337
12338 B<-u Package>
12339
12340 =item EXTENDING LINT
12341
12342 =item BUGS
12343
12344 =item AUTHOR
12345
12346 =back
12347
12348 =head2 B::O, O - Generic interface to Perl Compiler backends
12349
12350 =over 4
12351
12352 =item SYNOPSIS
12353
12354 =item DESCRIPTION
12355
12356 =item CONVENTIONS
12357
12358 =item IMPLEMENTATION
12359
12360 =item BUGS
12361
12362 =item AUTHOR
12363
12364 =back
12365
12366 =head2 B::Showlex - Show lexical variables used in functions or files
12367
12368 =over 4
12369
12370 =item SYNOPSIS
12371
12372 =item DESCRIPTION
12373
12374 =item EXAMPLES
12375
12376 =over 4
12377
12378 =item OPTIONS
12379
12380 =back
12381
12382 =item SEE ALSO
12383
12384 =item TODO
12385
12386 =item AUTHOR
12387
12388 =back
12389
12390 =head2 B::Stackobj - Helper module for CC backend
12391
12392 =over 4
12393
12394 =item SYNOPSIS
12395
12396 =item DESCRIPTION
12397
12398 =item AUTHOR
12399
12400 =back
12401
12402 =head2 B::Stash - show what stashes are loaded
12403
12404 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
12405
12406 =over 4
12407
12408 =item SYNOPSIS
12409
12410 =item DESCRIPTION
12411
12412 =item AUTHOR
12413
12414 =back
12415
12416 =head2 B::Xref - Generates cross reference reports for Perl programs
12417
12418 =over 4
12419
12420 =item SYNOPSIS
12421
12422 =item DESCRIPTION
12423
12424 =item OPTIONS
12425
12426 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
12427
12428 =item BUGS
12429
12430 =item AUTHOR
12431
12432 =back
12433
12434 =head2 Bblock, B::Bblock - Walk basic blocks
12435
12436 =over 4
12437
12438 =item SYNOPSIS
12439
12440 =item DESCRIPTION
12441
12442 =over 4
12443
12444 =item Functions
12445
12446 B<find_leaders>
12447
12448 =back
12449
12450 =item AUTHOR
12451
12452 =back
12453
12454 =head2 Benchmark - benchmark running times of Perl code
12455
12456 =over 4
12457
12458 =item SYNOPSIS
12459
12460 =item DESCRIPTION
12461
12462 =over 4
12463
12464 =item Methods
12465
12466 new, debug, iters
12467
12468 =item Standard Exports
12469
12470 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
12471 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
12472 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
12473
12474 =item Optional Exports
12475
12476 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [
12477 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
12478 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
12479
12480 =item :hireswallclock
12481
12482 =back
12483
12484 =item NOTES
12485
12486 =item EXAMPLES
12487
12488 =item INHERITANCE
12489
12490 =item CAVEATS
12491
12492 =item SEE ALSO
12493
12494 =item AUTHORS
12495
12496 =item MODIFICATION HISTORY
12497
12498 =back
12499
12500 =head2 ByteLoader - load byte compiled perl code
12501
12502 =over 4
12503
12504 =item SYNOPSIS
12505
12506 =item DESCRIPTION
12507
12508 =item AUTHOR
12509
12510 =item SEE ALSO
12511
12512 =back
12513
12514 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
12515
12516 =over 4
12517
12518 =item SYNOPSIS
12519
12520 =item DESCRIPTION
12521
12522 =item EXAMPLE
12523
12524 =item OPTIONS
12525
12526 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
12527
12528 =item KNOWN BUGS
12529
12530 =item NOTICE
12531
12532 =item AUTHORS
12533
12534 =back
12535
12536 =head2 CGI - Simple Common Gateway Interface Class
12537
12538 =over 4
12539
12540 =item SYNOPSIS
12541
12542 =item ABSTRACT
12543
12544 =item DESCRIPTION
12545
12546 =over 4
12547
12548 =item PROGRAMMING STYLE
12549
12550 =item CALLING CGI.PM ROUTINES
12551
12552 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
12553
12554 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
12555
12556 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
12557
12558 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
12559
12560 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
12561
12562 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
12563
12564 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
12565
12566 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
12567
12568 =item DELETING A PARAMETER COMPLETELY:
12569
12570 =item DELETING ALL PARAMETERS:
12571
12572 =item HANDLING NON-URLENCODED ARGUMENTS
12573
12574 =item DIRECT ACCESS TO THE PARAMETER LIST:
12575
12576 =item FETCHING THE PARAMETER LIST AS A HASH:
12577
12578 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
12579
12580 =item RETRIEVING CGI ERRORS
12581
12582 =item USING THE FUNCTION-ORIENTED INTERFACE
12583
12584 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
12585 B<:standard>, B<:all>
12586
12587 =item PRAGMAS
12588
12589 -any, -compile, -nosticky, -tabindex, -no_undef_params, -no_xhtml, -nph,
12590 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
12591 -private_tempfiles
12592
12593 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
12594
12595 1. start_table() (generates a <table> tag), 2. end_table() (generates a
12596 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
12597 a </ul> tag)
12598
12599 =back
12600
12601 =item GENERATING DYNAMIC DOCUMENTS
12602
12603 =over 4
12604
12605 =item CREATING A STANDARD HTTP HEADER:
12606
12607 =item GENERATING A REDIRECTION HEADER
12608
12609 =item CREATING THE HTML DOCUMENT HEADER
12610
12611 B<Parameters:>, 4, 5, 6..
12612
12613 =item ENDING THE HTML DOCUMENT:
12614
12615 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
12616
12617 =item OBTAINING THE SCRIPT'S URL
12618
12619 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
12620 (B<-query_string>), B<-base>, B<-rewrite>
12621
12622 =item MIXING POST AND URL PARAMETERS
12623
12624 =back
12625
12626 =item CREATING STANDARD HTML ELEMENTS:
12627
12628 =over 4
12629
12630 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
12631
12632 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
12633
12634 =item HTML SHORTCUTS AND LIST INTERPOLATION
12635
12636 =item NON-STANDARD HTML SHORTCUTS
12637
12638 =item AUTOESCAPING HTML
12639
12640 $escaped_string = escapeHTML("unescaped string");, $charset =
12641 charset([$charset]);, $flag = autoEscape([$flag]);
12642
12643 =item PRETTY-PRINTING HTML
12644
12645 =back
12646
12647 =item CREATING FILL-OUT FORMS:
12648
12649 =over 4
12650
12651 =item CREATING AN ISINDEX TAG
12652
12653 =item STARTING AND ENDING A FORM
12654
12655 B<application/x-www-form-urlencoded>, B<multipart/form-data>
12656
12657 =item FORM ELEMENTS
12658
12659 B<-name>, B<-value>, B<-values>, B<-tabindex>, B<-id>, B<-override>,
12660 B<-onChange>, B<-onFocus>, B<-onBlur>, B<-onMouseOver>, B<-onMouseOut>,
12661 B<-onSelect>
12662
12663 =item CREATING A TEXT FIELD
12664
12665 B<Parameters>
12666
12667 =item CREATING A BIG TEXT FIELD
12668
12669 =item CREATING A PASSWORD FIELD
12670
12671 =item CREATING A FILE UPLOAD FIELD
12672
12673 B<Parameters>
12674
12675 =item CREATING A POPUP MENU
12676
12677 =item CREATING AN OPTION GROUP
12678
12679 =item CREATING A SCROLLING LIST
12680
12681 B<Parameters:>
12682
12683 =item CREATING A GROUP OF RELATED CHECKBOXES
12684
12685 B<Parameters:>
12686
12687 =item CREATING A STANDALONE CHECKBOX
12688
12689 B<Parameters:>
12690
12691 =item CREATING A RADIO BUTTON GROUP
12692
12693 B<Parameters:>
12694
12695 =item CREATING A SUBMIT BUTTON 
12696
12697 B<Parameters:>
12698
12699 =item CREATING A RESET BUTTON
12700
12701 =item CREATING A DEFAULT BUTTON
12702
12703 =item CREATING A HIDDEN FIELD
12704
12705 B<Parameters:>
12706
12707 =item CREATING A CLICKABLE IMAGE BUTTON
12708
12709 B<Parameters:>, 3. The third option (-align, optional) is an alignment
12710 type, and may be TOP, BOTTOM or MIDDLE
12711
12712 =item CREATING A JAVASCRIPT ACTION BUTTON
12713
12714 =back
12715
12716 =item HTTP COOKIES
12717
12718 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
12719 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
12720
12721 =item WORKING WITH FRAMES
12722
12723 1. Create a <Frameset> document, 2. Specify the destination for the
12724 document in the HTTP header, 3. Specify the destination for the document in
12725 the <form> tag
12726
12727 =item SUPPORT FOR JAVASCRIPT
12728
12729 B<onLoad>, B<onUnload>, B<onSubmit>, B<onClick>, B<onChange>, B<onFocus>,
12730 B<onBlur>, B<onSelect>, B<onMouseOver>, B<onMouseOut>
12731
12732 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
12733
12734 =item DEBUGGING
12735
12736 =over 4
12737
12738 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
12739
12740 =back
12741
12742 =item FETCHING ENVIRONMENT VARIABLES
12743
12744 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
12745 B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
12746 name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
12747 ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
12748 B<virtual_port ()>, B<server_software ()>, B<remote_user ()>, B<user_name
12749 ()>, B<request_method()>, B<content_type()>, B<http()>, B<https()>
12750
12751 =item USING NPH SCRIPTS
12752
12753 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
12754 parameters
12755
12756 =item Server Push
12757
12758 multipart_init(), multipart_start(), multipart_end(), multipart_final()
12759
12760 =item Avoiding Denial of Service Attacks
12761
12762 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
12763 basis>, B<2. Globally for all scripts>
12764
12765 =item COMPATIBILITY WITH CGI-LIB.PL
12766
12767 =item AUTHOR INFORMATION
12768
12769 =item CREDITS
12770
12771 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
12772 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
12773 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
12774 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
12775 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
12776 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
12777 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
12778 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
12779 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
12780 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
12781 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
12782 ...and many many more..
12783
12784 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
12785
12786 =item BUGS
12787
12788 =item SEE ALSO
12789
12790 =back
12791
12792 =head2 CGI::Apache - Backward compatibility module for CGI.pm
12793
12794 =over 4
12795
12796 =item SYNOPSIS
12797
12798 =item ABSTRACT
12799
12800 =item DESCRIPTION
12801
12802 =item AUTHOR INFORMATION
12803
12804 =item BUGS
12805
12806 =item SEE ALSO
12807
12808 =back
12809
12810 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
12811 other) error log
12812
12813 =over 4
12814
12815 =item SYNOPSIS
12816
12817 =item DESCRIPTION
12818
12819 =item REDIRECTING ERROR MESSAGES
12820
12821 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
12822
12823 =over 4
12824
12825 =item Changing the default message
12826
12827 =back
12828
12829 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
12830
12831 =item OVERRIDING THE NAME OF THE PROGRAM
12832
12833 =item AUTHORS
12834
12835 =item SEE ALSO
12836
12837 =back
12838
12839 =head2 CGI::Cookie - Interface to Netscape Cookies
12840
12841 =over 4
12842
12843 =item SYNOPSIS
12844
12845 =item DESCRIPTION
12846
12847 =item USING CGI::Cookie
12848
12849 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
12850
12851 =over 4
12852
12853 =item Creating New Cookies
12854
12855 =item Sending the Cookie to the Browser
12856
12857 =item Recovering Previous Cookies
12858
12859 =item Manipulating Cookies
12860
12861 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
12862
12863 =back
12864
12865 =item AUTHOR INFORMATION
12866
12867 =item BUGS
12868
12869 =item SEE ALSO
12870
12871 =back
12872
12873 =head2 CGI::Fast - CGI Interface for Fast CGI
12874
12875 =over 4
12876
12877 =item SYNOPSIS
12878
12879 =item DESCRIPTION
12880
12881 =item OTHER PIECES OF THE PUZZLE
12882
12883 =item WRITING FASTCGI PERL SCRIPTS
12884
12885 =item INSTALLING FASTCGI SCRIPTS
12886
12887 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
12888
12889 =item EXTERNAL FASTCGI SERVER INVOCATION
12890
12891 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
12892
12893 =item CAVEATS
12894
12895 =item AUTHOR INFORMATION
12896
12897 =item BUGS
12898
12899 =item SEE ALSO
12900
12901 =back
12902
12903 =head2 CGI::Pretty - module to produce nicely formatted HTML code
12904
12905 =over 4
12906
12907 =item SYNOPSIS
12908
12909 =item DESCRIPTION
12910
12911 =over 4
12912
12913 =item Tags that won't be formatted
12914
12915 =item Customizing the Indenting
12916
12917 =back
12918
12919 =item BUGS
12920
12921 =item AUTHOR
12922
12923 =item SEE ALSO
12924
12925 =back
12926
12927 =head2 CGI::Push - Simple Interface to Server Push
12928
12929 =over 4
12930
12931 =item SYNOPSIS
12932
12933 =item DESCRIPTION
12934
12935 =item USING CGI::Push
12936
12937 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
12938
12939 =over 4
12940
12941 =item Heterogeneous Pages
12942
12943 =item Changing the Page Delay on the Fly
12944
12945 =back
12946
12947 =item INSTALLING CGI::Push SCRIPTS
12948
12949 =item AUTHOR INFORMATION
12950
12951 =item BUGS
12952
12953 =item SEE ALSO
12954
12955 =back
12956
12957 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
12958
12959 =over 4
12960
12961 =item SYNOPSIS
12962
12963 =item ABSTRACT
12964
12965 =item DESCRIPTION
12966
12967 =item AUTHOR INFORMATION
12968
12969 =item BUGS
12970
12971 =item SEE ALSO
12972
12973 =back
12974
12975 =head2 CGI::Util - Internal utilities used by CGI module
12976
12977 =over 4
12978
12979 =item SYNOPSIS
12980
12981 =item DESCRIPTION
12982
12983 =item AUTHOR INFORMATION
12984
12985 =item SEE ALSO
12986
12987 =back
12988
12989 =head2 CPAN - query, download and build perl modules from CPAN sites
12990
12991 =over 4
12992
12993 =item SYNOPSIS
12994
12995 =item STATUS
12996
12997 =item DESCRIPTION
12998
12999 =over 4
13000
13001 =item Interactive Mode
13002
13003 Searching for authors, bundles, distribution files and modules, make, test,
13004 install, clean  modules or distributions, get, readme, perldoc, look module
13005 or distribution, ls author, ls globbing_expresion, Signals
13006
13007 =item CPAN::Shell
13008
13009 =item autobundle
13010
13011 =item recompile
13012
13013 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
13014
13015 =item Programmer's interface
13016
13017 expand($type,@things), expandany(@things), Programming Examples
13018
13019 =item Methods in the other Classes
13020
13021 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
13022 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
13023 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
13024 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
13025 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
13026 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
13027 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
13028 CPAN::Bundle::readme(), CPAN::Bundle::test(),
13029 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
13030 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
13031 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
13032 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
13033 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
13034 CPAN::Distribution::look(), CPAN::Distribution::make(),
13035 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
13036 CPAN::Distribution::perldoc(), CPAN::Distribution::test(),
13037 CPAN::Distribution::uptodate(), CPAN::Index::force_reload(),
13038 CPAN::Index::reload(), CPAN::InfoObj::dump(), CPAN::Module::as_glimpse(),
13039 CPAN::Module::as_string(), CPAN::Module::clean(),
13040 CPAN::Module::cpan_file(), CPAN::Module::cpan_version(),
13041 CPAN::Module::cvs_import(), CPAN::Module::description(),
13042 CPAN::Module::force($method,@args), CPAN::Module::get(),
13043 CPAN::Module::inst_file(), CPAN::Module::inst_version(),
13044 CPAN::Module::install(), CPAN::Module::look(), CPAN::Module::make(),
13045 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
13046 CPAN::Module::perldoc(), CPAN::Module::test(), CPAN::Module::uptodate(),
13047 CPAN::Module::userid()
13048
13049 =item Cache Manager
13050
13051 =item Bundles
13052
13053 =item Prerequisites
13054
13055 =item Finding packages and VERSION
13056
13057 =item Debugging
13058
13059 =item Floppy, Zip, Offline Mode
13060
13061 =back
13062
13063 =item CONFIGURATION
13064
13065 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
13066 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
13067 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
13068 [unshift|push|splice] E<lt>listE<gt>>
13069
13070 =over 4
13071
13072 =item Note on urllist parameter's format
13073
13074 =item urllist parameter has CD-ROM support
13075
13076 =back
13077
13078 =item SECURITY
13079
13080 =over 4
13081
13082 =item Cryptographically signed modules
13083
13084 =back
13085
13086 =item EXPORT
13087
13088 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
13089
13090 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
13091
13092 =over 4
13093
13094 =item Three basic types of firewalls
13095
13096 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
13097
13098 =item Configuring lynx or ncftp for going through a firewall
13099
13100 =back
13101
13102 =item FAQ
13103
13104 1), 2), 3), 4), 5), 6), 7), 8), 9), 10), 11)
13105
13106 =item BUGS
13107
13108 =item AUTHOR
13109
13110 =item TRANSLATIONS
13111
13112 =item SEE ALSO
13113
13114 =back
13115
13116 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
13117
13118 =over 4
13119
13120 =item SYNOPSIS
13121
13122 =item DESCRIPTION
13123
13124 =back
13125
13126 =head2 CPAN::Version - utility functions to compare CPAN versions
13127
13128 =over 4
13129
13130 =item SYNOPSIS
13131
13132 =item DESCRIPTION
13133
13134 =back
13135
13136 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
13137 module
13138
13139 =over 4
13140
13141 =item SYNOPSIS
13142
13143 =item DESCRIPTION
13144
13145 =item  SEE ALSO
13146
13147 =back
13148
13149 =head2 Carp, carp    - warn of errors (from perspective of caller)
13150
13151 =over 4
13152
13153 =item SYNOPSIS
13154
13155 =item DESCRIPTION
13156
13157 =over 4
13158
13159 =item Forcing a Stack Trace
13160
13161 =back
13162
13163 =item GLOBAL VARIABLES
13164
13165 =over 4
13166
13167 =item $Carp::CarpLevel
13168
13169 =item $Carp::MaxEvalLen
13170
13171 =item $Carp::MaxArgLen
13172
13173 =item $Carp::MaxArgNums
13174
13175 =item $Carp::Verbose
13176
13177 =back
13178
13179 =item BUGS
13180
13181 =back
13182
13183 =head2 Carp::Heavy - heavy machinery, no user serviceable parts inside
13184
13185 =head2 Class::ISA -- report the search path for a class's ISA tree
13186
13187 =over 4
13188
13189 =item SYNOPSIS
13190
13191 =item DESCRIPTION
13192
13193 =item FUNCTIONS
13194
13195 the function Class::ISA::super_path($CLASS), the function
13196 Class::ISA::self_and_super_path($CLASS), the function
13197 Class::ISA::self_and_super_versions($CLASS)
13198
13199 =item CAUTIONARY NOTES
13200
13201 =item COPYRIGHT
13202
13203 =item AUTHOR
13204
13205 =back
13206
13207 =head2 Class::Struct - declare struct-like datatypes as Perl classes
13208
13209 =over 4
13210
13211 =item SYNOPSIS
13212
13213 =item DESCRIPTION
13214
13215 =over 4
13216
13217 =item The C<struct()> function
13218
13219 =item Class Creation at Compile Time
13220
13221 =item Element Types and Accessor Methods
13222
13223 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
13224 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
13225
13226 =item Initializing with C<new>
13227
13228 =back
13229
13230 =item EXAMPLES
13231
13232 Example 1, Example 2, Example 3
13233
13234 =item Author and Modification History
13235
13236 =back
13237
13238 =head2 Compress::Zlib - Interface to zlib compression library
13239
13240 =over 4
13241
13242 =item SYNOPSIS
13243
13244 =item DESCRIPTION
13245
13246 =item GZIP INTERFACE
13247
13248 B<$gz = gzopen($filename, $mode)>, B<$gz = gzopen($filehandle, $mode)>,
13249 B<$bytesread = $gz-E<gt>gzread($buffer [, $size]) ;>, B<$bytesread =
13250 $gz-E<gt>gzreadline($line) ;>, B<$byteswritten = $gz-E<gt>gzwrite($buffer)
13251 ;>, B<$status = $gz-E<gt>gzflush($flush_type) ;>, B<$offset =
13252 $gz-E<gt>gztell() ;>, B<$status = $gz-E<gt>gzseek($offset, $whence) ;>,
13253 B<$gz-E<gt>gzclose>, B<$gz-E<gt>gzsetparams($level, $strategy>, B<$level>,
13254 B<$strategy>, B<$gz-E<gt>gzerror>, B<$gzerrno>
13255
13256 =over 4
13257
13258 =item Examples
13259
13260 =item Compress::Zlib::memGzip
13261
13262 =item Compress::Zlib::memGunzip
13263
13264 =back
13265
13266 =item COMPRESS/UNCOMPRESS
13267
13268 B<$dest = compress($source [, $level] ) ;>, B<$dest = uncompress($source)
13269 ;>
13270
13271 =item CHECKSUM FUNCTIONS
13272
13273 =item Compress::Zlib::Deflate
13274
13275 =over 4
13276
13277 =item B<($d, $status) = new Compress::Zlib::Deflate( [OPT] ) >
13278
13279 B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>,
13280 B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32>
13281
13282 =item B<$status = $d-E<gt>deflate($input, $output)>
13283
13284 =item B<$status = $d-E<gt>flush($output [, $flush_type]) >
13285
13286 =item B<$status = $d-E<gt>deflateParams([OPT])>
13287
13288 B<-Level>, B<-Strategy>, B<-BufSize>
13289
13290 =item B<$status = $d-E<gt>deflateTune($good_length, $max_lazy,
13291 $nice_length, $max_chain)>
13292
13293 =item B<$d-E<gt>dict_adler()>
13294
13295 =item B<$d-E<gt>crc32()>
13296
13297 =item B<$d-E<gt>adler32()>
13298
13299 =item B<$d-E<gt>msg()>
13300
13301 =item B<$d-E<gt>total_in()>
13302
13303 =item B<$d-E<gt>total_out()>
13304
13305 =item B<$d-E<gt>get_Strategy()>
13306
13307 =item B<$d-E<gt>get_Level()>
13308
13309 =item B<$d-E<gt>get_BufSize()>
13310
13311 =item Example
13312
13313 =back
13314
13315 =item Compress::Zlib::Inflate
13316
13317 =over 4
13318
13319 =item B< ($i, $status) = new Compress::Zlib::Inflate( [OPT] ) >
13320
13321 B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>,
13322 B<-ADLER32>, B<-ConsumeInput>
13323
13324 =item B< $status = $i-E<gt>inflate($input, $output) >
13325
13326 =item B<$status = $i-E<gt>inflateSync($input)>
13327
13328 =item B<$i-E<gt>dict_adler()>
13329
13330 =item B<$i-E<gt>crc32()>
13331
13332 =item B<$i-E<gt>adler32()>
13333
13334 =item B<$i-E<gt>msg()>
13335
13336 =item B<$i-E<gt>total_in()>
13337
13338 =item B<$i-E<gt>total_out()>
13339
13340 =item B<$d-E<gt>get_BufSize()>
13341
13342 =item Example
13343
13344 =back
13345
13346 =item Compress::Zlib 1.x Deflate Interface
13347
13348 =over 4
13349
13350 =item B<($d, $status) = deflateInit( [OPT] )>
13351
13352 B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>,
13353 B<-Dictionary>, B<-Bufsize>
13354
13355 =item B<($out, $status) = $d-E<gt>deflate($buffer)>
13356
13357 =item B<($out, $status) = $d-E<gt>flush([flush_type])>
13358
13359 =item B<$status = $d-E<gt>deflateParams([OPT])>
13360
13361 B<-Level>, B<-Strategy>
13362
13363 =item B<$d-E<gt>dict_adler()>
13364
13365 =item B<$d-E<gt>msg()>
13366
13367 =item B<$d-E<gt>total_in()>
13368
13369 =item B<$d-E<gt>total_out()>
13370
13371 =item Example
13372
13373 =back
13374
13375 =item Compress::Zlib 1.x Inflate Interface
13376
13377 =over 4
13378
13379 =item B<($i, $status) = inflateInit()>
13380
13381 B<-WindowBits>, B<-Bufsize>, B<-Dictionary>
13382
13383 =item B<($out, $status) = $i-E<gt>inflate($buffer)>
13384
13385 =item B<$status = $i-E<gt>inflateSync($buffer)>
13386
13387 =item B<$i-E<gt>dict_adler()>
13388
13389 =item B<$i-E<gt>msg()>
13390
13391 =item B<$i-E<gt>total_in()>
13392
13393 =item B<$i-E<gt>total_out()>
13394
13395 =item Example
13396
13397 =back
13398
13399 =item ACCESSING ZIP FILES
13400
13401 =item CONSTANTS
13402
13403 =item SEE ALSO
13404
13405 =item AUTHOR
13406
13407 =item MODIFICATION HISTORY
13408
13409 =item COPYRIGHT AND LICENSE
13410
13411 =back
13412
13413 =head2 Compress::Zlib::File::GlobMapper, File::GlobMapper - Extend File
13414 Glob to Allow Input and Output Files
13415
13416 =over 4
13417
13418 =item SYNOPSIS
13419
13420 =item DESCRIPTION
13421
13422 This code is a work in progress, There are known bugs, The interface
13423 defined here is tentative, There are portability issues, Do not use in
13424 production code, Consider yourself warned!
13425
13426 =over 4
13427
13428 =item Behind The Scenes
13429
13430 =item Limitations
13431
13432 =item Input File Glob
13433
13434 B<~>, B<~user>, B<.>, B<*>, B<?>, B<\>,  B<[]>,  B<{,}>,  B<()>
13435
13436 =item Output File Glob
13437
13438 "*", #1
13439
13440 =item Returned Data
13441
13442 =back
13443
13444 =item EXAMPLES
13445
13446 =over 4
13447
13448 =item A Rename script
13449
13450 =item A few example globmaps
13451
13452 =back
13453
13454 =item SEE ALSO
13455
13456 =item AUTHOR
13457
13458 =item COPYRIGHT AND LICENSE
13459
13460 =back
13461
13462 =head2 Compress::Zlib::IO::Compress::Deflate, IO::Compress::Deflate     -
13463 Perl interface to write RFC 1950 files/buffers
13464
13465 =over 4
13466
13467 =item SYNOPSIS
13468
13469 =item DESCRIPTION
13470
13471 DO NOT use in production code, The documentation is incomplete in places,
13472 Parts of the interface defined here are tentative, Please report any
13473 problems you find
13474
13475 =item Functional Interface
13476
13477 =over 4
13478
13479 =item deflate $input => $output [, OPTS]
13480
13481 A filename, A filehandle, A scalar reference, An array reference, An Input
13482 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
13483 Reference, An Array Reference, An Output FileGlob
13484
13485 =item deflate \%hash [, OPTS]
13486
13487 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
13488 Array Reference
13489
13490 =item Notes
13491
13492 =item Optional Parameters
13493
13494 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
13495
13496 =item Examples
13497
13498 =back
13499
13500 =item OO Interface
13501
13502 =over 4
13503
13504 =item Constructor
13505
13506 A filename, A filehandle, A scalar reference
13507
13508 =item Constructor Options
13509
13510 -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1, A Buffer, A Filename, A
13511 Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1
13512
13513 =item Examples
13514
13515 =back
13516
13517 =item Methods 
13518
13519 =over 4
13520
13521 =item print
13522
13523 =item printf
13524
13525 =item syswrite
13526
13527 =item write
13528
13529 =item flush
13530
13531 =item tell
13532
13533 =item eof
13534
13535 =item seek
13536
13537 =item binmode
13538
13539 =item fileno
13540
13541 =item close
13542
13543 =item newStream
13544
13545 =item deflateParams
13546
13547 =back
13548
13549 =item Importing 
13550
13551 :all, :constants, :flush, :level, :strategy
13552
13553 =item EXAMPLES
13554
13555 =item SEE ALSO
13556
13557 =item AUTHOR
13558
13559 =item MODIFICATION HISTORY
13560
13561 =item COPYRIGHT AND LICENSE
13562
13563 =back
13564
13565 =head2 Compress::Zlib::IO::Compress::Gzip, IO::Compress::Gzip     - Perl
13566 interface to write RFC 1952 files/buffers
13567
13568 =over 4
13569
13570 =item SYNOPSIS
13571
13572 =item DESCRIPTION
13573
13574 DO NOT use in production code, The documentation is incomplete in places,
13575 Parts of the interface defined here are tentative, Please report any
13576 problems you find
13577
13578 =item Functional Interface
13579
13580 =over 4
13581
13582 =item gzip $input => $output [, OPTS]
13583
13584 A filename, A filehandle, A scalar reference, An array reference, An Input
13585 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
13586 Reference, An Array Reference, An Output FileGlob
13587
13588 =item gzip \%hash [, OPTS]
13589
13590 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
13591 Array Reference
13592
13593 =item Notes
13594
13595 =item Optional Parameters
13596
13597 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
13598
13599 =item Examples
13600
13601 =back
13602
13603 =item OO Interface
13604
13605 =over 4
13606
13607 =item Constructor
13608
13609 A filename, A filehandle, A scalar reference
13610
13611 =item Constructor Options
13612
13613 -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1, A Buffer, A Filename, A
13614 Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Mimimal =E<gt> 0|1,
13615 -Comment =E<gt> $comment, -Name =E<gt> $string, -Time =E<gt> $number,
13616 -TextFlag =E<gt> 0|1, -HeaderCRC =E<gt> 0|1, -OS_Code =E<gt> $value,
13617 -ExtraField =E<gt> $data, -ExtraFlags =E<gt> $value, -Strict =E<gt> 0|1
13618
13619 =item Examples
13620
13621 =back
13622
13623 =item Methods 
13624
13625 =over 4
13626
13627 =item print
13628
13629 =item printf
13630
13631 =item syswrite
13632
13633 =item write
13634
13635 =item flush
13636
13637 =item tell
13638
13639 =item eof
13640
13641 =item seek
13642
13643 =item binmode
13644
13645 =item fileno
13646
13647 =item close
13648
13649 =item newStream
13650
13651 =item deflateParams
13652
13653 =back
13654
13655 =item Importing 
13656
13657 :all, :constants, :flush, :level, :strategy
13658
13659 =item EXAMPLES
13660
13661 =item SEE ALSO
13662
13663 =item AUTHOR
13664
13665 =item MODIFICATION HISTORY
13666
13667 =item COPYRIGHT AND LICENSE
13668
13669 =back
13670
13671 =head2 Compress::Zlib::IO::Compress::RawDeflate, IO::Compress::RawDeflate  
13672   - Perl interface to write RFC 1951 files/buffers
13673
13674 =over 4
13675
13676 =item SYNOPSIS
13677
13678 =item DESCRIPTION
13679
13680 DO NOT use in production code, The documentation is incomplete in places,
13681 Parts of the interface defined here are tentative, Please report any
13682 problems you find
13683
13684 =item Functional Interface
13685
13686 =over 4
13687
13688 =item rawdeflate $input => $output [, OPTS]
13689
13690 A filename, A filehandle, A scalar reference, An array reference, An Input
13691 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
13692 Reference, An Array Reference, An Output FileGlob
13693
13694 =item rawdeflate \%hash [, OPTS]
13695
13696 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
13697 Array Reference
13698
13699 =item Notes
13700
13701 =item Optional Parameters
13702
13703 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
13704
13705 =item Examples
13706
13707 =back
13708
13709 =item OO Interface
13710
13711 =over 4
13712
13713 =item Constructor
13714
13715 A filename, A filehandle, A scalar reference
13716
13717 =item Constructor Options
13718
13719 -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1, A Buffer, A Filename, A
13720 Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1
13721
13722 =item Examples
13723
13724 =back
13725
13726 =item Methods 
13727
13728 =over 4
13729
13730 =item print
13731
13732 =item printf
13733
13734 =item syswrite
13735
13736 =item write
13737
13738 =item flush
13739
13740 =item tell
13741
13742 =item eof
13743
13744 =item seek
13745
13746 =item binmode
13747
13748 =item fileno
13749
13750 =item close
13751
13752 =item newStream
13753
13754 =item deflateParams
13755
13756 =back
13757
13758 =item Importing 
13759
13760 :all, :constants, :flush, :level, :strategy
13761
13762 =item EXAMPLES
13763
13764 =item SEE ALSO
13765
13766 =item AUTHOR
13767
13768 =item MODIFICATION HISTORY
13769
13770 =item COPYRIGHT AND LICENSE
13771
13772 =back
13773
13774 =head2 Compress::Zlib::IO::Uncompress::AnyInflate,
13775 IO::Uncompress::AnyInflate - Perl interface to read RFC 1950, 1951 & 1952
13776 files/buffers
13777
13778 =over 4
13779
13780 =item SYNOPSIS
13781
13782 =item DESCRIPTION
13783
13784 DO NOT use in production code, The documentation is incomplete in places,
13785 Parts of the interface defined here are tentative, Please report any
13786 problems you find
13787
13788 =item Functional Interface
13789
13790 =over 4
13791
13792 =item anyinflate $input => $output [, OPTS]
13793
13794 A filename, A filehandle, A scalar reference, An array reference, An Input
13795 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
13796 Reference, An Array Reference, An Output FileGlob
13797
13798 =item anyinflate \%hash [, OPTS]
13799
13800 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
13801 Array Reference
13802
13803 =item Notes
13804
13805 =item Optional Parameters
13806
13807 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
13808
13809 =item Examples
13810
13811 =back
13812
13813 =item OO Interface
13814
13815 =over 4
13816
13817 =item Constructor
13818
13819 A filename, A filehandle, A scalar reference
13820
13821 =item Constructor Options
13822
13823 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
13824 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
13825 -Append =E<gt> 0|1, -Strict =E<gt> 0|1, -ParseExtra =E<gt> 0|1
13826
13827 =item Examples
13828
13829 =back
13830
13831 =item Methods 
13832
13833 =over 4
13834
13835 =item read
13836
13837 =item read
13838
13839 =item getline
13840
13841 =item getc
13842
13843 =item ungetc
13844
13845 =item inflateSync
13846
13847 =item getHeaderInfo
13848
13849 =item tell
13850
13851 =item eof
13852
13853 =item seek
13854
13855 =item binmode
13856
13857 =item fileno
13858
13859 =item close
13860
13861 =back
13862
13863 =item Importing 
13864
13865 :all
13866
13867 =item EXAMPLES
13868
13869 =item SEE ALSO
13870
13871 =item AUTHOR
13872
13873 =item MODIFICATION HISTORY
13874
13875 =item COPYRIGHT AND LICENSE
13876
13877 =back
13878
13879 =head2 Compress::Zlib::IO::Uncompress::Gunzip, IO::Uncompress::Gunzip -
13880 Perl interface to read RFC 1952 files/buffers
13881
13882 =over 4
13883
13884 =item SYNOPSIS
13885
13886 =item DESCRIPTION
13887
13888 DO NOT use in production code, The documentation is incomplete in places,
13889 Parts of the interface defined here are tentative, Please report any
13890 problems you find
13891
13892 =item Functional Interface
13893
13894 =over 4
13895
13896 =item gunzip $input => $output [, OPTS]
13897
13898 A filename, A filehandle, A scalar reference, An array reference, An Input
13899 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
13900 Reference, An Array Reference, An Output FileGlob
13901
13902 =item gunzip \%hash [, OPTS]
13903
13904 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
13905 Array Reference
13906
13907 =item Notes
13908
13909 =item Optional Parameters
13910
13911 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
13912
13913 =item Examples
13914
13915 =back
13916
13917 =item OO Interface
13918
13919 =over 4
13920
13921 =item Constructor
13922
13923 A filename, A filehandle, A scalar reference
13924
13925 =item Constructor Options
13926
13927 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
13928 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
13929 -Append =E<gt> 0|1, -Strict =E<gt> 0|1, -ParseExtra =E<gt> 0|1
13930
13931 =item Examples
13932
13933 =back
13934
13935 =item Methods 
13936
13937 =over 4
13938
13939 =item read
13940
13941 =item read
13942
13943 =item getline
13944
13945 =item getc
13946
13947 =item ungetc
13948
13949 =item inflateSync
13950
13951 =item getHeaderInfo
13952
13953 Comment
13954
13955 =item tell
13956
13957 =item eof
13958
13959 =item seek
13960
13961 =item binmode
13962
13963 =item fileno
13964
13965 =item close
13966
13967 =back
13968
13969 =item Importing 
13970
13971 :all
13972
13973 =item EXAMPLES
13974
13975 =item SEE ALSO
13976
13977 =item AUTHOR
13978
13979 =item MODIFICATION HISTORY
13980
13981 =item COPYRIGHT AND LICENSE
13982
13983 =back
13984
13985 =head2 Compress::Zlib::IO::Uncompress::Inflate, IO::Uncompress::Inflate -
13986 Perl interface to read RFC 1950 files/buffers
13987
13988 =over 4
13989
13990 =item SYNOPSIS
13991
13992 =item DESCRIPTION
13993
13994 DO NOT use in production code, The documentation is incomplete in places,
13995 Parts of the interface defined here are tentative, Please report any
13996 problems you find
13997
13998 =item Functional Interface
13999
14000 =over 4
14001
14002 =item inflate $input => $output [, OPTS]
14003
14004 A filename, A filehandle, A scalar reference, An array reference, An Input
14005 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
14006 Reference, An Array Reference, An Output FileGlob
14007
14008 =item inflate \%hash [, OPTS]
14009
14010 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
14011 Array Reference
14012
14013 =item Notes
14014
14015 =item Optional Parameters
14016
14017 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
14018
14019 =item Examples
14020
14021 =back
14022
14023 =item OO Interface
14024
14025 =over 4
14026
14027 =item Constructor
14028
14029 A filename, A filehandle, A scalar reference
14030
14031 =item Constructor Options
14032
14033 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
14034 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
14035 -Append =E<gt> 0|1, -Strict =E<gt> 0|1
14036
14037 =item Examples
14038
14039 =back
14040
14041 =item Methods 
14042
14043 =over 4
14044
14045 =item read
14046
14047 =item read
14048
14049 =item getline
14050
14051 =item getc
14052
14053 =item ungetc
14054
14055 =item inflateSync
14056
14057 =item getHeaderInfo
14058
14059 =item tell
14060
14061 =item eof
14062
14063 =item seek
14064
14065 =item binmode
14066
14067 =item fileno
14068
14069 =item close
14070
14071 =back
14072
14073 =item Importing 
14074
14075 :all
14076
14077 =item EXAMPLES
14078
14079 =item SEE ALSO
14080
14081 =item AUTHOR
14082
14083 =item MODIFICATION HISTORY
14084
14085 =item COPYRIGHT AND LICENSE
14086
14087 =back
14088
14089 =head2 Compress::Zlib::IO::Uncompress::RawInflate,
14090 IO::Uncompress::RawInflate - Perl interface to read RFC 1951 files/buffers
14091
14092 =over 4
14093
14094 =item SYNOPSIS
14095
14096 =item DESCRIPTION
14097
14098 DO NOT use in production code, The documentation is incomplete in places,
14099 Parts of the interface defined here are tentative, Please report any
14100 problems you find
14101
14102 =item Functional Interface
14103
14104 =over 4
14105
14106 =item rawinflate $input => $output [, OPTS]
14107
14108 A filename, A filehandle, A scalar reference, An array reference, An Input
14109 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
14110 Reference, An Array Reference, An Output FileGlob
14111
14112 =item rawinflate \%hash [, OPTS]
14113
14114 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
14115 Array Reference
14116
14117 =item Notes
14118
14119 =item Optional Parameters
14120
14121 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
14122
14123 =item Examples
14124
14125 =back
14126
14127 =item OO Interface
14128
14129 =over 4
14130
14131 =item Constructor
14132
14133 A filename, A filehandle, A scalar reference
14134
14135 =item Constructor Options
14136
14137 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
14138 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
14139 -Append =E<gt> 0|1, -Strict =E<gt> 0|1
14140
14141 =item Examples
14142
14143 =back
14144
14145 =item Methods 
14146
14147 =over 4
14148
14149 =item read
14150
14151 =item read
14152
14153 =item getline
14154
14155 =item getc
14156
14157 =item ungetc
14158
14159 =item inflateSync
14160
14161 =item getHeaderInfo
14162
14163 =item tell
14164
14165 =item eof
14166
14167 =item seek
14168
14169 =item binmode
14170
14171 =item fileno
14172
14173 =item close
14174
14175 =back
14176
14177 =item Importing 
14178
14179 :all
14180
14181 =item EXAMPLES
14182
14183 =item SEE ALSO
14184
14185 =item AUTHOR
14186
14187 =item MODIFICATION HISTORY
14188
14189 =item COPYRIGHT AND LICENSE
14190
14191 =back
14192
14193 =head2 Compress::Zlib::pod::FAQ, Compress::Zlib::FAQ -- Frequently Asked
14194 Questions about Compress::Zlib 
14195
14196 =over 4
14197
14198 =item DESCRIPTION
14199
14200 =over 4
14201
14202 =item Compatibility with Unix compress/uncompress.
14203
14204 =item Accessing .tar.Z files
14205
14206 =item Accessing Zip Files
14207
14208 =item Zlib Library Version Support
14209
14210 =back
14211
14212 =item SEE ALSO
14213
14214 =item AUTHOR
14215
14216 =item MODIFICATION HISTORY
14217
14218 =item COPYRIGHT AND LICENSE
14219
14220 =back
14221
14222 =head2 Config - access Perl configuration information
14223
14224 =over 4
14225
14226 =item SYNOPSIS
14227
14228 =item DESCRIPTION
14229
14230 myconfig(), config_sh(), config_re($regex), config_vars(@names)
14231
14232 =item EXAMPLE
14233
14234 =item WARNING
14235
14236 =item GLOSSARY
14237
14238 =over 4
14239
14240 =item _
14241
14242 C<_a>, C<_exe>, C<_o>
14243
14244 =item a
14245
14246 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
14247 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
14248 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
14249 C<asctime_r_proto>, C<awk>
14250
14251 =item b
14252
14253 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
14254
14255 =item c
14256
14257 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
14258 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
14259 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
14260 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
14261 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
14262 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
14263 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
14264
14265 =item d
14266
14267 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>,
14268 C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>,
14269 C<d_attribute_format>, C<d_attribute_malloc>, C<d_attribute_nonnull>,
14270 C<d_attribute_noreturn>, C<d_attribute_pure>, C<d_attribute_unused>,
14271 C<d_attribute_warn_unused_result>, C<d_bcmp>, C<d_bcopy>, C<d_bsd>,
14272 C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>, C<d_casti32>, C<d_castneg>,
14273 C<d_charvspr>, C<d_chown>, C<d_chroot>, C<d_chsize>, C<d_class>,
14274 C<d_clearenv>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>, C<d_copysignl>,
14275 C<d_crypt>, C<d_crypt_r>, C<d_csh>, C<d_ctermid_r>, C<d_ctime_r>,
14276 C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>,
14277 C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>,
14278 C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>,
14279 C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>, C<d_endnent>,
14280 C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>, C<d_endpwent>,
14281 C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>, C<d_eofnblk>,
14282 C<d_eunice>, C<d_faststdio>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>,
14283 C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>,
14284 C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>,
14285 C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>,
14286 C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>,
14287 C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>,
14288 C<d_fsync>, C<d_ftello>, C<d_ftime>, C<d_futimes>, C<d_Gconvert>,
14289 C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>,
14290 C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>,
14291 C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
14292 C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>,
14293 C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>,
14294 C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>,
14295 C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>,
14296 C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
14297 C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
14298 C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>,
14299 C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
14300 C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>,
14301 C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>,
14302 C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>,
14303 C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
14304 C<d_htonl>, C<d_ilogbl>, C<d_index>, C<d_inetaton>, C<d_int64_t>,
14305 C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>,
14306 C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>,
14307 C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>,
14308 C<d_lstat>, C<d_madvise>, C<d_malloc_size>, C<d_malloc_good_size>,
14309 C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>,
14310 C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>,
14311 C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>,
14312 C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>, C<d_mprotect>, C<d_msg>,
14313 C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>,
14314 C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>,
14315 C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>,
14316 C<d_nl_langinfo>, C<d_nv_preserves_uv>, C<d_nv_zero_is_allbits_zero>,
14317 C<d_off64_t>, C<d_old_pthread_create_joinable>, C<d_oldpthreads>,
14318 C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>,
14319 C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>,
14320 C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>,
14321 C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>,
14322 C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>,
14323 C<d_pthread_atfork>, C<d_pthread_attr_setscope>, C<d_pthread_yield>,
14324 C<d_pwage>, C<d_pwchange>, C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>,
14325 C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>, C<d_qgcvt>, C<d_quad>,
14326 C<d_random_r>, C<d_readdir64_r>, C<d_readdir>, C<d_readdir_r>,
14327 C<d_readlink>, C<d_readv>, C<d_recvmsg>, C<d_rename>, C<d_rewinddir>,
14328 C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>, C<d_sbrkproto>,
14329 C<d_scalbnl>, C<d_sched_yield>, C<d_scm_rights>, C<d_SCNfldbl>,
14330 C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>, C<d_semctl_semid_ds>,
14331 C<d_semctl_semun>, C<d_semget>, C<d_semop>, C<d_sendmsg>, C<d_setegid>,
14332 C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>,
14333 C<d_sethostent_r>, C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>,
14334 C<d_setlocale_r>, C<d_setnent>, C<d_setnetent_r>, C<d_setpent>,
14335 C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>, C<d_setprior>,
14336 C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>, C<d_setpwent_r>,
14337 C<d_setregid>, C<d_setresgid>, C<d_setresuid>, C<d_setreuid>, C<d_setrgid>,
14338 C<d_setruid>, C<d_setsent>, C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>,
14339 C<d_sfio>, C<d_shm>, C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>,
14340 C<d_shmdt>, C<d_shmget>, C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>,
14341 C<d_sockatmark>, C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>,
14342 C<d_sockpair>, C<d_socks5_init>, C<d_sprintf_returns_strlen>, C<d_sqrtl>,
14343 C<d_srand48_r>, C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>,
14344 C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>,
14345 C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>,
14346 C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>,
14347 C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>,
14348 C<d_strerror>, C<d_strerror_r>, C<d_strftime>, C<d_strlcat>, C<d_strlcpy>,
14349 C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>, C<d_strtoq>,
14350 C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>,
14351 C<d_symlink>, C<d_syscall>, C<d_syscallproto>, C<d_sysconf>,
14352 C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>,
14353 C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>,
14354 C<d_tm_tm_gmtoff>, C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>,
14355 C<d_ttyname_r>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>,
14356 C<d_uname>, C<d_union_semun>, C<d_unordered>, C<d_unsetenv>, C<d_usleep>,
14357 C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>,
14358 C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>, C<d_void_closedir>,
14359 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
14360 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
14361 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
14362 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
14363 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
14364
14365 =item e
14366
14367 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
14368 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
14369 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
14370 C<expr>, C<extensions>, C<extras>
14371
14372 =item f
14373
14374 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
14375 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
14376 C<full_sed>
14377
14378 =item g
14379
14380 C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>,
14381 C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>,
14382 C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>,
14383 C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>,
14384 C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>,
14385 C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>,
14386 C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>,
14387 C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>,
14388 C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>,
14389 C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
14390
14391 =item h
14392
14393 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>,
14394 C<html3dir>, C<html3direxp>
14395
14396 =item i
14397
14398 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
14399 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
14400 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
14401 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
14402 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
14403 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
14404 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
14405 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
14406 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
14407 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
14408 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
14409 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
14410 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
14411 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
14412 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
14413 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
14414 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
14415 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
14416 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installhtml1dir>,
14417 C<installhtml3dir>, C<installman1dir>, C<installman3dir>, C<installprefix>,
14418 C<installprefixexp>, C<installprivlib>, C<installscript>,
14419 C<installsitearch>, C<installsitebin>, C<installsitehtml1dir>,
14420 C<installsitehtml3dir>, C<installsitelib>, C<installsiteman1dir>,
14421 C<installsiteman3dir>, C<installsitescript>, C<installstyle>,
14422 C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>,
14423 C<installvendorhtml1dir>, C<installvendorhtml3dir>, C<installvendorlib>,
14424 C<installvendorman1dir>, C<installvendorman3dir>, C<installvendorscript>,
14425 C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
14426
14427 =item k
14428
14429 C<known_extensions>, C<ksh>
14430
14431 =item l
14432
14433 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
14434 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
14435 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
14436 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
14437 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
14438 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
14439 C<lseektype>
14440
14441 =item m
14442
14443 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
14444 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
14445 C<man3direxp>, C<man3ext>
14446
14447 =item M
14448
14449 C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>,
14450 C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>,
14451 C<myuname>
14452
14453 =item n
14454
14455 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
14456 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
14457 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
14458 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
14459 C<nvsize>, C<nvtype>
14460
14461 =item o
14462
14463 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
14464 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
14465
14466 =item p
14467
14468 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
14469 C<perl>, C<perl_patchlevel>
14470
14471 =item P
14472
14473 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
14474 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
14475 C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>,
14476 C<procselfexe>, C<prototype>, C<ptrsize>
14477
14478 =item q
14479
14480 C<quadkind>, C<quadtype>
14481
14482 =item r
14483
14484 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
14485 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
14486 C<rmail>, C<run>, C<runnm>
14487
14488 =item s
14489
14490 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
14491 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
14492 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
14493 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
14494 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
14495 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
14496 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
14497 C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>,
14498 C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>,
14499 C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>,
14500 C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>,
14501 C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>,
14502 C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>,
14503 C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>,
14504 C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>,
14505 C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>,
14506 C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>,
14507 C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>,
14508 C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>,
14509 C<submit>, C<subversion>, C<sysman>
14510
14511 =item t
14512
14513 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
14514 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
14515 C<ttyname_r_proto>
14516
14517 =item u
14518
14519 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
14520 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
14521 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
14522 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>,
14523 C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemallocwrap>,
14524 C<usemorebits>, C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>,
14525 C<useperlio>, C<useposix>, C<usereentrant>, C<userelocatableinc>,
14526 C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>, C<usevendorprefix>,
14527 C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>, C<uvsize>, C<uvtype>,
14528 C<uvuformat>, C<uvxformat>, C<uvXUformat>
14529
14530 =item v
14531
14532 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
14533 C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>,
14534 C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>,
14535 C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>,
14536 C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>,
14537 C<vendorscriptexp>, C<version>, C<version_patchlevel_string>,
14538 C<versiononly>, C<vi>, C<voidflags>
14539
14540 =item x
14541
14542 C<xlibpth>
14543
14544 =item y
14545
14546 C<yacc>, C<yaccflags>
14547
14548 =item z
14549
14550 C<zcat>, C<zip>
14551
14552 =back
14553
14554 =item NOTE
14555
14556 =back
14557
14558 =over 4
14559
14560 =item SYNOPSIS
14561
14562 =item DESCRIPTION
14563
14564 dynamic, nonxs, static
14565
14566 =item AUTHOR
14567
14568 =back
14569
14570 =head2 Cwd - get pathname of current working directory
14571
14572 =over 4
14573
14574 =item SYNOPSIS
14575
14576 =item DESCRIPTION
14577
14578 =over 4
14579
14580 =item getcwd and friends
14581
14582 getcwd, cwd, fastcwd, fastgetcwd, getdcwd
14583
14584 =item abs_path and friends
14585
14586 abs_path, realpath, fast_abs_path
14587
14588 =item $ENV{PWD}
14589
14590 =back
14591
14592 =item NOTES
14593
14594 =item AUTHOR
14595
14596 =item COPYRIGHT
14597
14598 =item SEE ALSO
14599
14600 =back
14601
14602 =head2 DB - programmatic interface to the Perl debugging API (draft,
14603 subject to
14604 change)
14605
14606 =over 4
14607
14608 =item SYNOPSIS
14609
14610 =item DESCRIPTION
14611
14612 =over 4
14613
14614 =item Global Variables
14615
14616  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args, 
14617 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname, 
14618 $DB::lineno
14619
14620 =item API Methods
14621
14622 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
14623 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
14624
14625 =item Client Callback Methods
14626
14627 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
14628 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
14629 CLIENT->output(LIST)
14630
14631 =back
14632
14633 =item BUGS
14634
14635 =item AUTHOR
14636
14637 =back
14638
14639 =head2 DBM_Filter -- Filter DBM keys/values 
14640
14641 =over 4
14642
14643 =item SYNOPSIS
14644
14645 =item DESCRIPTION
14646
14647 =item What is a DBM Filter?
14648
14649 =over 4
14650
14651 =item So what's new?
14652
14653 =back
14654
14655 =item METHODS
14656
14657 =over 4
14658
14659 =item $db->Filter_Push()
14660
14661 =item $db->Filter_Key_Push()
14662
14663 =item $db->Filter_Value_Push()
14664
14665 Filter_Push, Filter_Key_Push, Filter_Value_Push
14666
14667 =item $db->Filter_Pop()
14668
14669 =item $db->Filtered()
14670
14671 =back
14672
14673 =item Writing a Filter
14674
14675 =over 4
14676
14677 =item Immediate Filters
14678
14679 =item Canned Filters
14680
14681 "name", params
14682
14683 =back
14684
14685 =item Filters Included
14686
14687 utf8, encode, compress, int32, null
14688
14689 =item NOTES
14690
14691 =over 4
14692
14693 =item Maintain Round Trip Integrity
14694
14695 =item Don't mix filtered & non-filtered data in the same database file. 
14696
14697 =back
14698
14699 =item EXAMPLE
14700
14701 =item SEE ALSO
14702
14703 =item AUTHOR
14704
14705 =back
14706
14707 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
14708
14709 =over 4
14710
14711 =item SYNOPSIS
14712
14713 =item DESCRIPTION
14714
14715 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
14716
14717 =over 4
14718
14719 =item Using DB_File with Berkeley DB version 2 or greater
14720
14721 =item Interface to Berkeley DB
14722
14723 =item Opening a Berkeley DB Database File
14724
14725 =item Default Parameters
14726
14727 =item In Memory Databases
14728
14729 =back
14730
14731 =item DB_HASH
14732
14733 =over 4
14734
14735 =item A Simple Example
14736
14737 =back
14738
14739 =item DB_BTREE
14740
14741 =over 4
14742
14743 =item Changing the BTREE sort order
14744
14745 =item Handling Duplicate Keys 
14746
14747 =item The get_dup() Method
14748
14749 =item The find_dup() Method
14750
14751 =item The del_dup() Method
14752
14753 =item Matching Partial Keys 
14754
14755 =back
14756
14757 =item DB_RECNO
14758
14759 =over 4
14760
14761 =item The 'bval' Option
14762
14763 =item A Simple Example
14764
14765 =item Extra RECNO Methods
14766
14767 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
14768 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
14769 length, elements);>
14770
14771 =item Another Example
14772
14773 =back
14774
14775 =item THE API INTERFACE
14776
14777 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
14778 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
14779 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
14780 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
14781
14782 =item DBM FILTERS
14783
14784 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
14785 B<filter_fetch_value>
14786
14787 =over 4
14788
14789 =item The Filter
14790
14791 =item An Example -- the NULL termination problem.
14792
14793 =item Another Example -- Key is a C int.
14794
14795 =back
14796
14797 =item HINTS AND TIPS 
14798
14799 =over 4
14800
14801 =item Locking: The Trouble with fd
14802
14803 =item Safe ways to lock a database
14804
14805 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
14806
14807 =item Sharing Databases With C Applications
14808
14809 =item The untie() Gotcha
14810
14811 =back
14812
14813 =item COMMON QUESTIONS
14814
14815 =over 4
14816
14817 =item Why is there Perl source in my database?
14818
14819 =item How do I store complex data structures with DB_File?
14820
14821 =item What does "Invalid Argument" mean?
14822
14823 =item What does "Bareword 'DB_File' not allowed" mean? 
14824
14825 =back
14826
14827 =item REFERENCES
14828
14829 =item HISTORY
14830
14831 =item BUGS
14832
14833 =item AVAILABILITY
14834
14835 =item COPYRIGHT
14836
14837 =item SEE ALSO
14838
14839 =item AUTHOR
14840
14841 =back
14842
14843 =head2 Data::Dumper - stringified perl data structures, suitable for both
14844 printing and C<eval>
14845
14846 =over 4
14847
14848 =item SYNOPSIS
14849
14850 =item DESCRIPTION
14851
14852 =over 4
14853
14854 =item Methods
14855
14856 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or> 
14857 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
14858 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
14859 I<$OBJ>->Reset
14860
14861 =item Functions
14862
14863 Dumper(I<LIST>)
14864
14865 =item Configuration Variables or Methods
14866
14867 =item Exports
14868
14869 Dumper
14870
14871 =back
14872
14873 =item EXAMPLES
14874
14875 =item BUGS
14876
14877 =over 4
14878
14879 =item NOTE
14880
14881 =back
14882
14883 =item AUTHOR
14884
14885 =item VERSION
14886
14887 =item SEE ALSO
14888
14889 =back
14890
14891 =head2 Devel::DProf - a Perl code profiler
14892
14893 =over 4
14894
14895 =item SYNOPSIS
14896
14897 =item DESCRIPTION
14898
14899 =item PROFILE FORMAT
14900
14901 =item AUTOLOAD
14902
14903 =item ENVIRONMENT
14904
14905 =item BUGS
14906
14907 =item SEE ALSO
14908
14909 =back
14910
14911 =head2 Devel::PPPort - Perl/Pollution/Portability
14912
14913 =over 4
14914
14915 =item SYNOPSIS
14916
14917 =item DESCRIPTION
14918
14919 =over 4
14920
14921 =item Why use ppport.h?
14922
14923 You should use F<ppport.h> in modern code so that your code will work
14924 with the widest range of Perl interpreters possible, without significant
14925 additional work.
14926
14927 =item How to use ppport.h
14928
14929 =item Running ppport.h
14930
14931 =back
14932
14933 =item FUNCTIONS
14934
14935 =over 4
14936
14937 =item WriteFile
14938
14939 =back
14940
14941 =item COMPATIBILITY
14942
14943 =over 4
14944
14945 =item Provided Perl compatibility API
14946
14947 =item Perl API not supported by ppport.h
14948
14949 perl 5.9.2, perl 5.9.1, perl 5.9.0, perl 5.8.3, perl 5.8.1, perl 5.8.0,
14950 perl 5.7.3, perl 5.7.2, perl 5.7.1, perl 5.6.1, perl 5.6.0, perl 5.005_03,
14951 perl 5.005, perl 5.004_05, perl 5.004_04, perl 5.004
14952
14953 =back
14954
14955 =item BUGS
14956
14957 =item AUTHORS
14958
14959 =item COPYRIGHT
14960
14961 =item SEE ALSO
14962
14963 =back
14964
14965 =head2 Devel::Peek - A data debugging tool for the XS programmer
14966
14967 =over 4
14968
14969 =item SYNOPSIS
14970
14971 =item DESCRIPTION
14972
14973 =over 4
14974
14975 =item Runtime debugging
14976
14977 =item Memory footprint debugging
14978
14979 =back
14980
14981 =item EXAMPLES
14982
14983 =over 4
14984
14985 =item A simple scalar string
14986
14987 =item A simple scalar number
14988
14989 =item A simple scalar with an extra reference
14990
14991 =item A reference to a simple scalar
14992
14993 =item A reference to an array
14994
14995 =item A reference to a hash
14996
14997 =item Dumping a large array or hash
14998
14999 =item A reference to an SV which holds a C pointer
15000
15001 =item A reference to a subroutine
15002
15003 =back
15004
15005 =item EXPORTS
15006
15007 =item BUGS
15008
15009 =item AUTHOR
15010
15011 =item SEE ALSO
15012
15013 =back
15014
15015 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
15016
15017 =over 4
15018
15019 =item SYNOPSIS
15020
15021 =item DESCRIPTION
15022
15023 =back
15024
15025 =head2 Digest - Modules that calculate message digests
15026
15027 =over 4
15028
15029 =item SYNOPSIS
15030
15031 =item DESCRIPTION
15032
15033 I<binary>, I<hex>, I<base64>
15034
15035 =item OO INTERFACE
15036
15037 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
15038 Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset,
15039 $ctx->add( $data, ... ), $ctx->addfile( $io_handle ), $ctx->add_bits(
15040 $data, $nbits ), $ctx->add_bits( $bitstring ), $ctx->digest,
15041 $ctx->hexdigest, $ctx->b64digest
15042
15043 =item Digest speed
15044
15045 =item SEE ALSO
15046
15047 =item AUTHOR
15048
15049 =back
15050
15051 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
15052
15053 =over 4
15054
15055 =item SYNOPSIS
15056
15057 =item DESCRIPTION
15058
15059 =item FUNCTIONS
15060
15061 md5($data,...), md5_hex($data,...), md5_base64($data,...)
15062
15063 =item METHODS
15064
15065 $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...),
15066 $md5->addfile($io_handle), $md5->add_bits($data, $nbits),
15067 $md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest
15068
15069 =item EXAMPLES
15070
15071 =item SEE ALSO
15072
15073 =item COPYRIGHT
15074
15075 =item AUTHORS
15076
15077 =back
15078
15079 =head2 Digest::base - Digest base class
15080
15081 =over 4
15082
15083 =item SYNOPSIS
15084
15085 =item DESCRIPTION
15086
15087 =item SEE ALSO
15088
15089 =back
15090
15091 =head2 Digest::file - Calculate digests of files
15092
15093 =over 4
15094
15095 =item SYNOPSIS
15096
15097 =item DESCRIPTION
15098
15099 digest_file( $file, $algorithm, [$arg,...] ), digest_file_hex( $file,
15100 $algorithm, [$arg,...] ), digest_file_base64( $file, $algorithm, [$arg,...]
15101 )
15102
15103 =item SEE ALSO
15104
15105 =back
15106
15107 =head2 DirHandle - supply object methods for directory handles
15108
15109 =over 4
15110
15111 =item SYNOPSIS
15112
15113 =item DESCRIPTION
15114
15115 =item NOTES
15116
15117 =back
15118
15119 =head2 Dumpvalue - provides screen dump of Perl data.
15120
15121 =over 4
15122
15123 =item SYNOPSIS
15124
15125 =item DESCRIPTION
15126
15127 =over 4
15128
15129 =item Creation
15130
15131 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
15132 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
15133 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
15134 stopDbSignal
15135
15136 =item Methods
15137
15138 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
15139 compactDump, veryCompact, set, get
15140
15141 =back
15142
15143 =back
15144
15145 =head2 DynaLoader - Dynamically load C libraries into Perl code
15146
15147 =over 4
15148
15149 =item SYNOPSIS
15150
15151 =item DESCRIPTION
15152
15153 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
15154 @dl_modules, @dl_shared_objects, dl_error(), $dl_debug, dl_findfile(),
15155 dl_expandspec(), dl_load_file(), dl_unload_file(), dl_load_flags(),
15156 dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(),
15157 dl_install_xsub(), bootstrap()
15158
15159 =item AUTHOR
15160
15161 =back
15162
15163 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
15164 Perl code
15165
15166 =over 4
15167
15168 =item VERSION
15169
15170 =item SYNOPSIS
15171
15172 =item DESCRIPTION
15173
15174 =over 4
15175
15176 =item Migration from C<DynaLoader>
15177
15178 =item Backward compatible boilerplate
15179
15180 =back
15181
15182 =item Order of initialization: early load()
15183
15184 =over 4
15185
15186 =item The most hairy case
15187
15188 =back
15189
15190 =item DIAGNOSTICS
15191
15192 Can't find '%s' symbol in %s, Can't load '%s' for module %s: %s, Undefined
15193 symbols present after loading %s: %s, XSLoader::load('Your::Module',
15194 $Your::Module::VERSION)
15195
15196 =item LIMITATIONS
15197
15198 =item BUGS
15199
15200 =item SEE ALSO
15201
15202 =item AUTHORS
15203
15204 =item COPYRIGHT
15205
15206 =back
15207
15208 =head2 Encode - character encodings
15209
15210 =over 4
15211
15212 =item SYNOPSIS
15213
15214 =over 4
15215
15216 =item Table of Contents
15217
15218 =back
15219
15220 =item DESCRIPTION
15221
15222 =over 4
15223
15224 =item TERMINOLOGY
15225
15226 =back
15227
15228 =item PERL ENCODING API
15229
15230 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
15231 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
15232 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
15233 CHECK]);
15234
15235 =over 4
15236
15237 =item Listing available encodings
15238
15239 =item Defining Aliases
15240
15241 =back
15242
15243 =item Encoding via PerlIO
15244
15245 =item Handling Malformed Data
15246
15247 B<NOTE:> Not all encoding support this feature, I<CHECK> =
15248 Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1), I<CHECK> =
15249 Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode (I<CHECK> =
15250 Encode::FB_PERLQQ), HTML charref mode (I<CHECK> = Encode::FB_HTMLCREF), XML
15251 charref mode (I<CHECK> = Encode::FB_XMLCREF), The bitmask
15252
15253 =over 4
15254
15255 =item coderef for CHECK
15256
15257 =back
15258
15259 =item Defining Encodings
15260
15261 =item The UTF-8 flag
15262
15263 Goal #1:, Goal #2:, Goal #3:, Goal #4:
15264
15265 =over 4
15266
15267 =item Messing with Perl's Internals
15268
15269 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
15270
15271 =back
15272
15273 =item UTF-8 vs. utf8
15274
15275 =item SEE ALSO
15276
15277 =item MAINTAINER
15278
15279 =back
15280
15281 =head2 Encode::Alias - alias definitions to encodings
15282
15283 =over 4
15284
15285 =item SYNOPSIS
15286
15287 =item DESCRIPTION
15288
15289 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
15290 reference, e.g.:
15291
15292 =over 4
15293
15294 =item Alias overloading
15295
15296 =back
15297
15298 =item SEE ALSO
15299
15300 =back
15301
15302 =head2 Encode::Byte - Single Byte Encodings
15303
15304 =over 4
15305
15306 =item SYNOPSIS
15307
15308 =item ABSTRACT
15309
15310 =item DESCRIPTION
15311
15312 =item SEE ALSO
15313
15314 =back
15315
15316 =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
15317
15318 =head2 Encode::CN - China-based Chinese Encodings
15319
15320 =over 4
15321
15322 =item SYNOPSIS
15323
15324 =item DESCRIPTION
15325
15326 =item NOTES
15327
15328 =item BUGS
15329
15330 =item SEE ALSO
15331
15332 =back
15333
15334 =head2 Encode::CN::HZ -- internally used by Encode::CN
15335
15336 =head2 Encode::Config -- internally used by Encode
15337
15338 =head2 Encode::EBCDIC - EBCDIC Encodings
15339
15340 =over 4
15341
15342 =item SYNOPSIS
15343
15344 =item ABSTRACT
15345
15346 =item DESCRIPTION
15347
15348 =item SEE ALSO
15349
15350 =back
15351
15352 =head2 Encode::Encoding - Encode Implementation Base Class
15353
15354 =over 4
15355
15356 =item SYNOPSIS
15357
15358 =item DESCRIPTION
15359
15360 =over 4
15361
15362 =item Methods you should implement
15363
15364 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
15365 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
15366
15367 =item Other methods defined in Encode::Encodings
15368
15369 -E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(),
15370 -E<gt>needs_lines()
15371
15372 =item Example: Encode::ROT13
15373
15374 =back
15375
15376 =item Why the heck Encode API is different?
15377
15378 =over 4
15379
15380 =item Compiled Encodings
15381
15382 =back
15383
15384 =item SEE ALSO
15385
15386 Scheme 1, Scheme 2, Other Schemes
15387
15388 =back
15389
15390 =head2 Encode::Guess -- Guesses encoding from data
15391
15392 =over 4
15393
15394 =item SYNOPSIS
15395
15396 =item ABSTRACT
15397
15398 =item DESCRIPTION
15399
15400 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
15401 Encode::decode("Guess" ...), Encode::Guess->guess($data),
15402 guess_encoding($data, [, I<list of suspects>])
15403
15404 =item CAVEATS
15405
15406 =item TO DO
15407
15408 =item SEE ALSO
15409
15410 =back
15411
15412 =head2 Encode::JP - Japanese Encodings
15413
15414 =over 4
15415
15416 =item SYNOPSIS
15417
15418 =item ABSTRACT
15419
15420 =item DESCRIPTION
15421
15422 =item Note on ISO-2022-JP(-1)?
15423
15424 =item BUGS
15425
15426 =item SEE ALSO
15427
15428 =back
15429
15430 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
15431
15432 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
15433
15434 =head2 Encode::KR - Korean Encodings
15435
15436 =over 4
15437
15438 =item SYNOPSIS
15439
15440 =item DESCRIPTION
15441
15442 =item BUGS
15443
15444 =item SEE ALSO
15445
15446 =back
15447
15448 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
15449
15450 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
15451
15452 =over 4
15453
15454 =item SYNOPSIS
15455
15456 =item ABSTRACT
15457
15458 =item DESCRIPTION
15459
15460 =item BUGS
15461
15462 =item SEE ALSO
15463
15464 =back
15465
15466 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
15467
15468 =over 4
15469
15470 =item Overview
15471
15472 =item How does it work?
15473
15474 =item Line Buffering
15475
15476 =over 4
15477
15478 =item How can I tell whether my encoding fully supports PerlIO ?
15479
15480 =back
15481
15482 =item SEE ALSO
15483
15484 =back
15485
15486 =head2 Encode::Supported -- Encodings supported by Encode
15487
15488 =over 4
15489
15490 =item DESCRIPTION
15491
15492 =over 4
15493
15494 =item Encoding Names
15495
15496 =back
15497
15498 =item Supported Encodings
15499
15500 =over 4
15501
15502 =item Built-in Encodings
15503
15504 =item Encode::Unicode -- other Unicode encodings
15505
15506 =item Encode::Byte -- Extended ASCII
15507
15508 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
15509 the Cyrillic world, gsm0338 - Hentai Latin 1
15510
15511 =item CJK: Chinese, Japanese, Korean (Multibyte)
15512
15513 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
15514 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
15515 Encode::JIS2K -- JIS X 0213 encodings via CPAN
15516
15517 =item Miscellaneous encodings
15518
15519 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
15520
15521 =back
15522
15523 =item Unsupported encodings
15524
15525   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
15526 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
15527 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
15528 Various Mac encodings, (Mac) Indic encodings
15529
15530 =item Encoding vs. Charset -- terminology
15531
15532 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
15533
15534 =over 4
15535
15536 =item Microsoft-related naming mess
15537
15538 KS_C_5601-1987, GB2312, Big5, Shift_JIS
15539
15540 =back
15541
15542 =item Glossary
15543
15544 character repertoire, coded character set (CCS), character encoding scheme
15545 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
15546 UTF-16
15547
15548 =item See Also
15549
15550 =item References
15551
15552 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
15553 RFC, UC, Unicode Glossary
15554
15555 =over 4
15556
15557 =item Other Notable Sites
15558
15559 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
15560 "Introduction to i18n"
15561
15562 =item Offline sources
15563
15564 C<CJKV Information Processing> by Ken Lunde
15565
15566 =back
15567
15568 =back
15569
15570 =head2 Encode::Symbol - Symbol Encodings
15571
15572 =over 4
15573
15574 =item SYNOPSIS
15575
15576 =item ABSTRACT
15577
15578 =item DESCRIPTION
15579
15580 =item SEE ALSO
15581
15582 =back
15583
15584 =head2 Encode::TW - Taiwan-based Chinese Encodings
15585
15586 =over 4
15587
15588 =item SYNOPSIS
15589
15590 =item DESCRIPTION
15591
15592 =item NOTES
15593
15594 =item BUGS
15595
15596 =item SEE ALSO
15597
15598 =back
15599
15600 =head2 Encode::Unicode -- Various Unicode Transformation Formats
15601
15602 =over 4
15603
15604 =item SYNOPSIS
15605
15606 =item ABSTRACT
15607
15608 L<http://www.unicode.org/glossary/> says:, Quick Reference
15609
15610 =item Size, Endianness, and BOM
15611
15612 =over 4
15613
15614 =item by size
15615
15616 =item by endianness
15617
15618 BOM as integer when fetched in network byte order
15619
15620 =back
15621
15622 =item Surrogate Pairs
15623
15624 =item Error Checking
15625
15626 =item SEE ALSO
15627
15628 =back
15629
15630 =head2 Encode::Unicode::UTF7 -- UTF-7 encoding
15631
15632 =over 4
15633
15634 =item SYNOPSIS
15635
15636 =item ABSTRACT
15637
15638 =item In Practice
15639
15640 =item SEE ALSO
15641
15642 =back
15643
15644 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
15645 encodings
15646
15647 =over 4
15648
15649 =item SYNOPSIS
15650
15651 =item DESCRIPTION
15652
15653 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
15654 reference, e.g.:
15655
15656 =over 4
15657
15658 =item Alias overloading
15659
15660 =back
15661
15662 =item SEE ALSO
15663
15664 =back
15665
15666 =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm --
15667 Internally used by Encode::??::ISO_2022_*
15668
15669 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
15670 Encode::CN
15671
15672 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
15673 Encode
15674
15675 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
15676 Implementation Base Class
15677
15678 =over 4
15679
15680 =item SYNOPSIS
15681
15682 =item DESCRIPTION
15683
15684 =over 4
15685
15686 =item Methods you should implement
15687
15688 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
15689 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
15690
15691 =item Other methods defined in Encode::Encodings
15692
15693 -E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(),
15694 -E<gt>needs_lines()
15695
15696 =item Example: Encode::ROT13
15697
15698 =back
15699
15700 =item Why the heck Encode API is different?
15701
15702 =over 4
15703
15704 =item Compiled Encodings
15705
15706 =back
15707
15708 =item SEE ALSO
15709
15710 Scheme 1, Scheme 2, Other Schemes
15711
15712 =back
15713
15714 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
15715 data
15716
15717 =over 4
15718
15719 =item SYNOPSIS
15720
15721 =item ABSTRACT
15722
15723 =item DESCRIPTION
15724
15725 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
15726 Encode::decode("Guess" ...), Encode::Guess->guess($data),
15727 guess_encoding($data, [, I<list of suspects>])
15728
15729 =item CAVEATS
15730
15731 =item TO DO
15732
15733 =item SEE ALSO
15734
15735 =back
15736
15737 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
15738 Encode::JP::2022_JP*
15739
15740 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
15741 by Encode::JP
15742
15743 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
15744 used by Encode::KR
15745
15746 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
15747 and 'Q' header encoding
15748
15749 =over 4
15750
15751 =item SYNOPSIS
15752
15753 =item ABSTRACT
15754
15755 =item DESCRIPTION
15756
15757 =item BUGS
15758
15759 =item SEE ALSO
15760
15761 =back
15762
15763 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
15764 on Encode and PerlIO
15765
15766 =over 4
15767
15768 =item Overview
15769
15770 =item How does it work?
15771
15772 =item Line Buffering
15773
15774 =over 4
15775
15776 =item How can I tell whether my encoding fully supports PerlIO ?
15777
15778 =back
15779
15780 =item SEE ALSO
15781
15782 =back
15783
15784 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
15785 supported by Encode
15786
15787 =over 4
15788
15789 =item DESCRIPTION
15790
15791 =over 4
15792
15793 =item Encoding Names
15794
15795 =back
15796
15797 =item Supported Encodings
15798
15799 =over 4
15800
15801 =item Built-in Encodings
15802
15803 =item Encode::Unicode -- other Unicode encodings
15804
15805 =item Encode::Byte -- Extended ASCII
15806
15807 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
15808 the Cyrillic world, gsm0338 - Hentai Latin 1
15809
15810 =item CJK: Chinese, Japanese, Korean (Multibyte)
15811
15812 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
15813 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
15814 Encode::JIS2K -- JIS X 0213 encodings via CPAN
15815
15816 =item Miscellaneous encodings
15817
15818 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
15819
15820 =back
15821
15822 =item Unsupported encodings
15823
15824   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
15825 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
15826 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
15827 Various Mac encodings, (Mac) Indic encodings
15828
15829 =item Encoding vs. Charset -- terminology
15830
15831 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
15832
15833 =over 4
15834
15835 =item Microsoft-related naming mess
15836
15837 KS_C_5601-1987, GB2312, Big5, Shift_JIS
15838
15839 =back
15840
15841 =item Glossary
15842
15843 character repertoire, coded character set (CCS), character encoding scheme
15844 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
15845 UTF-16
15846
15847 =item See Also
15848
15849 =item References
15850
15851 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
15852 RFC, UC, Unicode Glossary
15853
15854 =over 4
15855
15856 =item Other Notable Sites
15857
15858 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
15859 "Introduction to i18n"
15860
15861 =item Offline sources
15862
15863 C<CJKV Information Processing> by Ken Lunde
15864
15865 =back
15866
15867 =back
15868
15869 =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7
15870 encoding
15871
15872 =over 4
15873
15874 =item SYNOPSIS
15875
15876 =item ABSTRACT
15877
15878 =item In Practice
15879
15880 =item SEE ALSO
15881
15882 =back
15883
15884 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
15885
15886 =over 4
15887
15888 =item SYNOPSIS
15889
15890 =item ABSTRACT
15891
15892 =item Description
15893
15894 =over 4
15895
15896 =item Predefined Methods
15897
15898 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
15899 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
15900 $e-E<gt>bytes([$encoding])
15901
15902 =item Example: base64 transcoder
15903
15904 =item Operator Overloading
15905
15906 =back
15907
15908 =item SEE ALSO
15909
15910 =back
15911
15912 =head2 Encodencoding, encoding - allows you to write your script in
15913 non-ascii or non-utf8
15914
15915 =over 4
15916
15917 =item SYNOPSIS
15918
15919 =item ABSTRACT
15920
15921 =over 4
15922
15923 =item Literal Conversions
15924
15925 =item PerlIO layers for C<STD(IN|OUT)>
15926
15927 =item Implicit upgrading for byte strings
15928
15929 =back
15930
15931 =item FEATURES THAT REQUIRE 5.8.1
15932
15933 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
15934
15935 =item USAGE
15936
15937 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
15938 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
15939
15940 =item The Filter Option
15941
15942 =over 4
15943
15944 =item Filter-related changes at Encode version 1.87
15945
15946 =back
15947
15948 =item CAVEATS
15949
15950 =over 4
15951
15952 =item NOT SCOPED
15953
15954 =item DO NOT MIX MULTIPLE ENCODINGS
15955
15956 =item tr/// with ranges
15957
15958 Legend of characters above
15959
15960 =back
15961
15962 =item EXAMPLE - Greekperl
15963
15964 =item KNOWN PROBLEMS
15965
15966 literals in regex that are longer than 127 bytes, EBCDIC, format
15967
15968 =over 4
15969
15970 =item The Logic of :locale
15971
15972 =back
15973
15974 =item HISTORY
15975
15976 =item SEE ALSO
15977
15978 =back
15979
15980 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
15981
15982 =over 4
15983
15984 =item SYNOPSIS
15985
15986 =item ABSTRACT
15987
15988 =item Description
15989
15990 =over 4
15991
15992 =item Predefined Methods
15993
15994 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
15995 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
15996 $e-E<gt>bytes([$encoding])
15997
15998 =item Example: base64 transcoder
15999
16000 =item Operator Overloading
16001
16002 =back
16003
16004 =item SEE ALSO
16005
16006 =back
16007
16008 =head2 English - use nice English (or awk) names for ugly punctuation
16009 variables
16010
16011 =over 4
16012
16013 =item SYNOPSIS
16014
16015 =item DESCRIPTION
16016
16017 =item PERFORMANCE
16018
16019 =back
16020
16021 =head2 Env - perl module that imports environment variables as scalars or
16022 arrays
16023
16024 =over 4
16025
16026 =item SYNOPSIS
16027
16028 =item DESCRIPTION
16029
16030 =item LIMITATIONS
16031
16032 =item AUTHOR
16033
16034 =back
16035
16036 =head2 Errno - System errno constants
16037
16038 =over 4
16039
16040 =item SYNOPSIS
16041
16042 =item DESCRIPTION
16043
16044 =item CAVEATS
16045
16046 =item AUTHOR
16047
16048 =item COPYRIGHT
16049
16050 =back
16051
16052 =head2 Exporter - Implements default import method for modules
16053
16054 =over 4
16055
16056 =item SYNOPSIS
16057
16058 =item DESCRIPTION
16059
16060 =over 4
16061
16062 =item How to Export
16063
16064 =item Selecting What To Export
16065
16066 =item How to Import
16067
16068 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
16069
16070 =back
16071
16072 =item Advanced features
16073
16074 =over 4
16075
16076 =item Specialised Import Lists
16077
16078 =item Exporting without using Exporter's import method
16079
16080 =item Exporting without inheriting from Exporter
16081
16082 =item Module Version Checking
16083
16084 =item Managing Unknown Symbols
16085
16086 =item Tag Handling Utility Functions
16087
16088 =item Generating combined tags
16089
16090 =item C<AUTOLOAD>ed Constants
16091
16092 =back
16093
16094 =back
16095
16096 =head2 Exporter::Heavy - Exporter guts
16097
16098 =over 4
16099
16100 =item SYNOPSIS
16101
16102 =item DESCRIPTION
16103
16104 =back
16105
16106 =head2 ExtUtils::CBuilder - Compile and link C code for Perl modules
16107
16108 =over 4
16109
16110 =item SYNOPSIS
16111
16112 =item DESCRIPTION
16113
16114 =item METHODS
16115
16116 new, have_compiler, compile, C<object_file>, C<include_dirs>,
16117 C<extra_compiler_flags>, link, lib_file, module_name, extra_linker_flags,
16118 link_executable, exe_file, object_file, lib_file, exe_file, prelink,
16119 need_prelink, extra_link_args_after_prelink
16120
16121 =item TO DO
16122
16123 =item HISTORY
16124
16125 =item AUTHOR
16126
16127 =item COPYRIGHT
16128
16129 =item SEE ALSO
16130
16131 =back
16132
16133 =head2 ExtUtils::CBuilder::Platform::Windows - Builder class for Windows
16134 platforms
16135
16136 =over 4
16137
16138 =item DESCRIPTION
16139
16140 =item AUTHOR
16141
16142 =item SEE ALSO
16143
16144 =back
16145
16146 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
16147 Makefiles etc.
16148
16149 =over 4
16150
16151 =item SYNOPSIS
16152
16153 =item DESCRIPTION
16154
16155 =back
16156
16157 cat
16158
16159 eqtime
16160
16161 rm_rf
16162
16163 rm_f
16164
16165 touch
16166
16167 mv
16168
16169 cp
16170
16171 chmod
16172
16173 mkpath
16174
16175 test_f
16176
16177 dos2unix
16178
16179 =over 4
16180
16181 =item SEE ALSO 
16182
16183 =item AUTHOR
16184
16185 =back
16186
16187 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
16188
16189 =over 4
16190
16191 =item SYNOPSIS
16192
16193 =item DESCRIPTION
16194
16195 B<test_harness>
16196
16197 =back
16198
16199 B<pod2man>
16200
16201 B<warn_if_old_packlist>
16202
16203 B<perllocal_install>
16204
16205 B<uninstall>
16206
16207 =head2 ExtUtils::Constant - generate XS code to import C header constants
16208
16209 =over 4
16210
16211 =item SYNOPSIS
16212
16213 =item DESCRIPTION
16214
16215 =item USAGE
16216
16217 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
16218
16219 =item FUNCTIONS
16220
16221 =back
16222
16223 constant_types
16224
16225 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
16226
16227 autoload PACKAGE, VERSION, AUTOLOADER
16228
16229 WriteMakefileSnippet
16230
16231 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
16232 BREAKOUT_AT, NAMES, C_FH, C_FILE, XS_FH, XS_FILE, SUBNAME, C_SUBNAME
16233
16234 =over 4
16235
16236 =item AUTHOR
16237
16238 =back
16239
16240 =head2 ExtUtils::Constant::Base - base class for ExtUtils::Constant objects
16241
16242 =over 4
16243
16244 =item SYNOPSIS
16245
16246 =item DESCRIPTION
16247
16248 =item USAGE
16249
16250 =back
16251
16252 header
16253
16254 memEQ_clause args_hashref
16255
16256 dump_names arg_hashref, ITEM..
16257
16258 assign arg_hashref, VALUE..
16259
16260 return_clause arg_hashref, ITEM
16261
16262 switch_clause arg_hashref, NAMELEN, ITEMHASH, ITEM..
16263
16264 params WHAT
16265
16266 dogfood arg_hashref, ITEM..
16267
16268 normalise_items args, default_type, seen_types, seen_items, ITEM..
16269
16270 C_constant arg_hashref, ITEM.., name, type, value, macro, default, pre,
16271 post, def_pre, def_post, utf8, weight
16272
16273 =over 4
16274
16275 =item BUGS
16276
16277 =item AUTHOR
16278
16279 =back
16280
16281 =head2 ExtUtils::Constant::Utils - helper functions for ExtUtils::Constant
16282
16283 =over 4
16284
16285 =item SYNOPSIS
16286
16287 =item DESCRIPTION
16288
16289 =item USAGE
16290
16291 C_stringify NAME
16292
16293 =back
16294
16295 perl_stringify NAME
16296
16297 =over 4
16298
16299 =item AUTHOR
16300
16301 =back
16302
16303 =head2 ExtUtils::Constant::XS, ExtUtils::Constant::Base - base class for
16304 ExtUtils::Constant objects
16305
16306 =over 4
16307
16308 =item SYNOPSIS
16309
16310 =item DESCRIPTION
16311
16312 =item BUGS
16313
16314 =item AUTHOR
16315
16316 =back
16317
16318 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
16319
16320 =over 4
16321
16322 =item SYNOPSIS
16323
16324 =item DESCRIPTION
16325
16326 =item @EXPORT
16327
16328 =item FUNCTIONS
16329
16330 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
16331 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
16332
16333 =item EXAMPLES
16334
16335 =item SEE ALSO
16336
16337 =item AUTHOR
16338
16339 =back
16340
16341 =head2 ExtUtils::Install - install files from here to there
16342
16343 =over 4
16344
16345 =item SYNOPSIS
16346
16347 =item DESCRIPTION
16348
16349 =over 4
16350
16351 =item Functions
16352
16353 B<install>
16354
16355 =back
16356
16357 =back
16358
16359 B<install_default> I<DISCOURAGED>
16360
16361 B<uninstall>
16362
16363 B<pm_to_blib>
16364
16365 _autosplit
16366
16367 =over 4
16368
16369 =item ENVIRONMENT
16370
16371 B<PERL_INSTALL_ROOT>
16372
16373 =item AUTHOR
16374
16375 =item LICENSE
16376
16377 =back
16378
16379 =head2 ExtUtils::Installed - Inventory management of installed modules
16380
16381 =over 4
16382
16383 =item SYNOPSIS
16384
16385 =item DESCRIPTION
16386
16387 =item USAGE
16388
16389 =item FUNCTIONS
16390
16391 new(), modules(), files(), directories(), directory_tree(), validate(),
16392 packlist(), version()
16393
16394 =item EXAMPLE
16395
16396 =item AUTHOR
16397
16398 =back
16399
16400 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
16401
16402 =over 4
16403
16404 =item SYNOPSIS
16405
16406 =item DESCRIPTION
16407
16408 For static extensions, For dynamic extensions at build/link time, For
16409 dynamic extensions at load time
16410
16411 =over 4
16412
16413 =item EXTRALIBS
16414
16415 =item LDLOADLIBS and LD_RUN_PATH
16416
16417 =item BSLOADLIBS
16418
16419 =back
16420
16421 =item PORTABILITY
16422
16423 =over 4
16424
16425 =item VMS implementation
16426
16427 =item Win32 implementation
16428
16429 =back
16430
16431 =item SEE ALSO
16432
16433 =back
16434
16435 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
16436
16437 =over 4
16438
16439 =item SYNOPSIS
16440
16441 =item DESCRIPTION
16442
16443 =back
16444
16445 =head2 ExtUtils::MM_AIX - AIX specific subclass of ExtUtils::MM_Unix
16446
16447 =over 4
16448
16449 =item SYNOPSIS
16450
16451 =item DESCRIPTION
16452
16453 =over 4
16454
16455 =item Overridden methods
16456
16457 =back
16458
16459 =back
16460
16461 =over 4
16462
16463 =item AUTHOR
16464
16465 =item SEE ALSO
16466
16467 =back
16468
16469 =head2 ExtUtils::MM_Any - Platform-agnostic MM methods
16470
16471 =over 4
16472
16473 =item SYNOPSIS
16474
16475 =item DESCRIPTION
16476
16477 =item METHODS
16478
16479 =over 4
16480
16481 =item Cross-platform helper methods
16482
16483 =back
16484
16485 =back
16486
16487 =over 4
16488
16489 =item Targets
16490
16491 =back
16492
16493 =over 4
16494
16495 =item Init methods
16496
16497 =back
16498
16499 =over 4
16500
16501 =item Tools
16502
16503 =back
16504
16505 =over 4
16506
16507 =item File::Spec wrappers
16508
16509 =back
16510
16511 =over 4
16512
16513 =item Misc
16514
16515 =back
16516
16517 =over 4
16518
16519 =item AUTHOR
16520
16521 =back
16522
16523 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
16524 ExtUtils::MakeMaker
16525
16526 =over 4
16527
16528 =item SYNOPSIS
16529
16530 =item DESCRIPTION
16531
16532 =back
16533
16534 os_flavor
16535
16536 init_linker
16537
16538 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
16539 ExtUtils::MakeMaker
16540
16541 =over 4
16542
16543 =item SYNOPSIS
16544
16545 =item DESCRIPTION
16546
16547 os_flavor
16548
16549 =back
16550
16551 cflags
16552
16553 replace_manpage_separator
16554
16555 init_linker
16556
16557 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
16558
16559 =over 4
16560
16561 =item SYNOPSIS
16562
16563 =item DESCRIPTION
16564
16565 =over 4
16566
16567 =item Overridden methods
16568
16569 os_flavor
16570
16571 =back
16572
16573 =back
16574
16575 B<replace_manpage_separator>
16576
16577 =over 4
16578
16579 =item AUTHOR
16580
16581 =item SEE ALSO
16582
16583 =back
16584
16585 =head2 ExtUtils::MM_MacOS - once produced Makefiles for MacOS Classic
16586
16587 =over 4
16588
16589 =item SYNOPSIS
16590
16591 =item DESCRIPTION
16592
16593 =back
16594
16595 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
16596 ExtUtils::MakeMaker
16597
16598 =over 4
16599
16600 =item SYNOPSIS
16601
16602 =item DESCRIPTION
16603
16604 =back
16605
16606 os_flavor
16607
16608 init_platform, platform_constants
16609
16610 const_cccmd
16611
16612 static_lib
16613
16614 dynamic_lib
16615
16616 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
16617 ExtUtils::MakeMaker
16618
16619 =over 4
16620
16621 =item SYNOPSIS
16622
16623 =item DESCRIPTION
16624
16625 =item METHODS
16626
16627 init_dist
16628
16629 =back
16630
16631 init_linker
16632
16633 os_flavor
16634
16635 =head2 ExtUtils::MM_QNX - QNX specific subclass of ExtUtils::MM_Unix
16636
16637 =over 4
16638
16639 =item SYNOPSIS
16640
16641 =item DESCRIPTION
16642
16643 =over 4
16644
16645 =item Overridden methods
16646
16647 =back
16648
16649 =back
16650
16651 =over 4
16652
16653 =item AUTHOR
16654
16655 =item SEE ALSO
16656
16657 =back
16658
16659 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
16660
16661 =over 4
16662
16663 =item SYNOPSIS
16664
16665 =item DESCRIPTION
16666
16667 =over 4
16668
16669 =item Overridden methods
16670
16671 os_flavor
16672
16673 =back
16674
16675 =back
16676
16677 B<replace_manpage_separator>
16678
16679 =over 4
16680
16681 =item AUTHOR
16682
16683 =item SEE ALSO
16684
16685 =back
16686
16687 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
16688
16689 =over 4
16690
16691 =item SYNOPSIS
16692
16693 =item DESCRIPTION
16694
16695 =item METHODS
16696
16697 =back
16698
16699 =over 4
16700
16701 =item Methods
16702
16703 os_flavor
16704
16705 =back
16706
16707 c_o (o)
16708
16709 cflags (o)
16710
16711 const_cccmd (o)
16712
16713 const_config (o)
16714
16715 const_loadlibs (o)
16716
16717 constants (o)
16718
16719 depend (o)
16720
16721 init_DEST
16722
16723 init_dist
16724
16725 dist (o)
16726
16727 dist_basics (o)
16728
16729 dist_ci (o)
16730
16731 dist_core (o)
16732
16733 B<dist_target>
16734
16735 B<tardist_target>
16736
16737 B<zipdist_target>
16738
16739 B<tarfile_target>
16740
16741 zipfile_target
16742
16743 uutardist_target
16744
16745 shdist_target
16746
16747 dlsyms (o)
16748
16749 dynamic_bs (o)
16750
16751 dynamic_lib (o)
16752
16753 exescan
16754
16755 extliblist
16756
16757 find_perl
16758
16759 fixin
16760
16761 force (o)
16762
16763 guess_name
16764
16765 has_link_code
16766
16767 init_dirscan
16768
16769 init_DIRFILESEP
16770
16771 init_main
16772
16773 init_others
16774
16775 init_linker
16776
16777 init_lib2arch
16778
16779 init_PERL
16780
16781 init_platform, platform_constants
16782
16783 init_PERM
16784
16785 init_xs
16786
16787 install (o)
16788
16789 installbin (o)
16790
16791 linkext (o)
16792
16793 lsdir
16794
16795 macro (o)
16796
16797 makeaperl (o)
16798
16799 makefile (o)
16800
16801 maybe_command
16802
16803 needs_linking (o)
16804
16805 nicetext
16806
16807 parse_abstract
16808
16809 parse_version
16810
16811 pasthru (o)
16812
16813 perl_script
16814
16815 perldepend (o)
16816
16817 perm_rw (o)
16818
16819 perm_rwx (o)
16820
16821 pm_to_blib
16822
16823 post_constants (o)
16824
16825 post_initialize (o)
16826
16827 postamble (o)
16828
16829 ppd
16830
16831 prefixify
16832
16833 processPL (o)
16834
16835 quote_paren
16836
16837 replace_manpage_separator
16838
16839 cd
16840
16841 oneliner
16842
16843 quote_literal
16844
16845 escape_newlines
16846
16847 max_exec_len
16848
16849 static (o)
16850
16851 static_lib (o)
16852
16853 staticmake (o)
16854
16855 subdir_x (o)
16856
16857 subdirs (o)
16858
16859 test (o)
16860
16861 test_via_harness (override)
16862
16863 test_via_script (override)
16864
16865 tools_other (o)
16866
16867 tool_xsubpp (o)
16868
16869 all_target
16870
16871 top_targets (o)
16872
16873 writedoc
16874
16875 xs_c (o)
16876
16877 xs_cpp (o)
16878
16879 xs_o (o)
16880
16881 =over 4
16882
16883 =item SEE ALSO
16884
16885 =back
16886
16887 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
16888 ExtUtils::MakeMaker
16889
16890 =over 4
16891
16892 =item SYNOPSIS
16893
16894 =item DESCRIPTION
16895
16896 =over 4
16897
16898 =item Methods always loaded
16899
16900 wraplist
16901
16902 =back
16903
16904 =back
16905
16906 =over 4
16907
16908 =item Methods
16909
16910 guess_name (override)
16911
16912 =back
16913
16914 find_perl (override)
16915
16916 maybe_command (override)
16917
16918 pasthru (override)
16919
16920 pm_to_blib (override)
16921
16922 perl_script (override)
16923
16924 replace_manpage_separator
16925
16926 init_DEST
16927
16928 init_DIRFILESEP
16929
16930 init_main (override)
16931
16932 init_others (override)
16933
16934 init_platform (override)
16935
16936 platform_constants
16937
16938 init_VERSION (override)
16939
16940 constants (override)
16941
16942 special_targets
16943
16944 cflags (override)
16945
16946 const_cccmd (override)
16947
16948 tools_other (override)
16949
16950 init_dist (override)
16951
16952 c_o (override)
16953
16954 xs_c (override)
16955
16956 xs_o (override)
16957
16958 dlsyms (override)
16959
16960 dynamic_lib (override)
16961
16962 static_lib (override)
16963
16964 extra_clean_files
16965
16966 zipfile_target, tarfile_target, shdist_target
16967
16968 install (override)
16969
16970 perldepend (override)
16971
16972 makeaperl (override)
16973
16974 nicetext (override)
16975
16976 prefixify (override)
16977
16978 cd
16979
16980 oneliner
16981
16982 B<echo>
16983
16984 quote_literal
16985
16986 escape_newlines
16987
16988 max_exec_len
16989
16990 init_linker
16991
16992 eliminate_macros
16993
16994 fixpath
16995
16996 os_flavor
16997
16998 =over 4
16999
17000 =item AUTHOR
17001
17002 =back
17003
17004 =head2 ExtUtils::MM_VOS - VOS specific subclass of ExtUtils::MM_Unix
17005
17006 =over 4
17007
17008 =item SYNOPSIS
17009
17010 =item DESCRIPTION
17011
17012 =over 4
17013
17014 =item Overridden methods
17015
17016 =back
17017
17018 =back
17019
17020 =over 4
17021
17022 =item AUTHOR
17023
17024 =item SEE ALSO
17025
17026 =back
17027
17028 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
17029 ExtUtils::MakeMaker
17030
17031 =over 4
17032
17033 =item SYNOPSIS
17034
17035 =item DESCRIPTION
17036
17037 =back
17038
17039 =over 4
17040
17041 =item Overridden methods
17042
17043 B<dlsyms>
17044
17045 =back
17046
17047 replace_manpage_separator
17048
17049 B<maybe_command>
17050
17051 B<init_DIRFILESEP>
17052
17053 B<init_others>
17054
17055 init_platform, platform_constants
17056
17057 special_targets
17058
17059 static_lib
17060
17061 dynamic_lib
17062
17063 extra_clean_files
17064
17065 init_linker
17066
17067 perl_script
17068
17069 xs_o
17070
17071 pasthru
17072
17073 oneliner
17074
17075 cd
17076
17077 max_exec_len
17078
17079 os_flavor
17080
17081 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
17082
17083 =over 4
17084
17085 =item SYNOPSIS
17086
17087 =item DESCRIPTION
17088
17089 =over 4
17090
17091 =item Overridden methods
17092
17093 xs_c
17094
17095 =back
17096
17097 =back
17098
17099 xs_cpp
17100
17101 xs_o
17102
17103 max_exec_len
17104
17105 os_flavor
17106
17107 =over 4
17108
17109 =item AUTHOR
17110
17111 =back
17112
17113 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
17114
17115 =over 4
17116
17117 =item SYNOPSIS
17118
17119 =item DESCRIPTION
17120
17121 =back
17122
17123 =head2 ExtUtils::MakeMaker - Create a module Makefile
17124
17125 =over 4
17126
17127 =item SYNOPSIS
17128
17129 =item DESCRIPTION
17130
17131 =over 4
17132
17133 =item How To Write A Makefile.PL
17134
17135 =item Default Makefile Behaviour
17136
17137 =item make test
17138
17139 =item make testdb
17140
17141 =item make install
17142
17143 =item PREFIX and LIB attribute
17144
17145 =item AFS users
17146
17147 =item Static Linking of a new Perl Binary
17148
17149 =item Determination of Perl Library and Installation Locations
17150
17151 =item Which architecture dependent directory?
17152
17153 =item Using Attributes and Parameters
17154
17155 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
17156 CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS,
17157 EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN,
17158 FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB,
17159 INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
17160 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB,
17161 INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLSITESCRIPT,
17162 INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB,
17163 INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INSTALLVENDORSCRIPT,
17164 INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT,
17165 LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE, MAKEAPERL,
17166 MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME,
17167 NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT, OPTIMIZE, PERL,
17168 PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLPREFIX,
17169 PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM, PMLIBDIRS,
17170 PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, PREFIX,
17171 PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT, PRINT_PREREQ, SITEPREFIX, SIGN,
17172 SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, VERSION_FROM, VERSION_SYM,
17173 XS, XSOPT, XSPROTOARG, XS_VERSION
17174
17175 =item Additional lowercase attributes
17176
17177 clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean,
17178 test, tool_autosplit
17179
17180 =item Overriding MakeMaker Methods
17181
17182 =item The End Of Cargo Cult Programming
17183
17184 C<< MAN3PODS => ' ' >>
17185
17186 =item Hintsfile support
17187
17188 =item Distribution Support
17189
17190    make distcheck,    make skipcheck,    make distclean,    make manifest, 
17191   make distdir,   make disttest,    make tardist,    make dist,    make
17192 uutardist,    make shdist,    make zipdist,    make ci
17193
17194 =item Module Meta-Data
17195
17196 =item Disabling an extension
17197
17198 =item Other Handy Functions
17199
17200 prompt
17201
17202 =back
17203
17204 =item ENVIRONMENT
17205
17206 PERL_MM_OPT, PERL_MM_USE_DEFAULT, PERL_CORE
17207
17208 =item SEE ALSO
17209
17210 =item AUTHORS
17211
17212 =item LICENSE
17213
17214 =back
17215
17216 =head2 ExtUtils::MakeMaker::Config - Wrapper around Config.pm
17217
17218 =over 4
17219
17220 =item SYNOPSIS
17221
17222 =item DESCRIPTION
17223
17224 =back
17225
17226 =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About
17227 MakeMaker
17228
17229 =over 4
17230
17231 =item DESCRIPTION
17232
17233 =over 4
17234
17235 =item Module Installation
17236
17237 How do I keep from installing man pages?, How do I use a module without
17238 installing it?
17239
17240 =item Philosophy and History
17241
17242 Why not just use <insert other build config tool here>?, What is
17243 Module::Build and how does it relate to MakeMaker?, pure perl.  no make, no
17244 shell commands, easier to customize, cleaner internals, less cruft
17245
17246 =item Module Writing
17247
17248 How do I keep my $VERSION up to date without resetting it manually?, What's
17249 this F<META.yml> thing and how did it get in my F<MANIFEST>?!
17250
17251 =item XS
17252
17253 How to I prevent "object version X.XX does not match bootstrap parameter
17254 Y.YY" errors?, How do I make two or more XS files coexist in the same
17255 directory?
17256
17257 =back
17258
17259 =item PATCHING
17260
17261 =item AUTHOR
17262
17263 =item SEE ALSO
17264
17265 =back
17266
17267 =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker
17268
17269 =over 4
17270
17271 =item SYNOPSIS
17272
17273 =item DESCRIPTION
17274
17275 =over 4
17276
17277 =item The Mantra
17278
17279 =item The Layout
17280
17281 Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP,
17282 bin/
17283
17284 =back
17285
17286 =item SEE ALSO
17287
17288 =back
17289
17290 =head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm
17291
17292 =over 4
17293
17294 =item SYNOPSIS
17295
17296 =item DESCRIPTION
17297
17298 =back
17299
17300 =head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm
17301
17302 =over 4
17303
17304 =item SYNOPSIS
17305
17306 =item DESCRIPTION
17307
17308 =back
17309
17310 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
17311
17312 =over 4
17313
17314 =item SYNOPSIS
17315
17316 =item DESCRIPTION
17317
17318 =over 4
17319
17320 =item Functions
17321
17322 mkmanifest
17323
17324 =back
17325
17326 =back
17327
17328 manifind
17329
17330 manicheck
17331
17332 filecheck
17333
17334 fullcheck
17335
17336 skipcheck
17337
17338 maniread
17339
17340 manicopy
17341
17342 maniadd
17343
17344 =over 4
17345
17346 =item MANIFEST
17347
17348 =item MANIFEST.SKIP
17349
17350 =item EXPORT_OK
17351
17352 =item GLOBAL VARIABLES
17353
17354 =back
17355
17356 =over 4
17357
17358 =item DIAGNOSTICS
17359
17360 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
17361 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
17362
17363 =item ENVIRONMENT
17364
17365 B<PERL_MM_MANIFEST_DEBUG>
17366
17367 =item SEE ALSO
17368
17369 =item AUTHOR
17370
17371 =back
17372
17373 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
17374
17375 =over 4
17376
17377 =item SYNOPSIS
17378
17379 =item DESCRIPTION
17380
17381 =item SEE ALSO
17382
17383 =back
17384
17385 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
17386
17387 =over 4
17388
17389 =item SYNOPSIS
17390
17391 =item DESCRIPTION
17392
17393 =back
17394
17395 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
17396 extension
17397
17398 =over 4
17399
17400 =item SYNOPSIS
17401
17402 =item DESCRIPTION
17403
17404 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
17405
17406 =item AUTHOR
17407
17408 =item REVISION
17409
17410 =back
17411
17412 =head2 ExtUtils::Packlist - manage .packlist files
17413
17414 =over 4
17415
17416 =item SYNOPSIS
17417
17418 =item DESCRIPTION
17419
17420 =item USAGE
17421
17422 =item FUNCTIONS
17423
17424 new(), read(), write(), validate(), packlist_file()
17425
17426 =item EXAMPLE
17427
17428 =item AUTHOR
17429
17430 =back
17431
17432 =head2 ExtUtils::ParseXS - converts Perl XS code into C code
17433
17434 =over 4
17435
17436 =item SYNOPSIS
17437
17438 =item EXPORT
17439
17440 =item FUNCTIONS
17441
17442 process_xs(), B<C++>, B<hiertype>, B<except>, B<typemap>, B<prototypes>,
17443 B<versioncheck>, B<linenumbers>, B<optimize>, B<inout>, B<argtypes>, B<s>,
17444 errors()
17445
17446 =item AUTHOR
17447
17448 =item COPYRIGHT
17449
17450 =item SEE ALSO
17451
17452 =back
17453
17454 =head2 ExtUtils::testlib - add blib/* directories to @INC
17455
17456 =over 4
17457
17458 =item SYNOPSIS
17459
17460 =item DESCRIPTION
17461
17462 =back
17463
17464 =head2 Fatal - replace functions with equivalents which succeed or die
17465
17466 =over 4
17467
17468 =item SYNOPSIS
17469
17470 =item DESCRIPTION
17471
17472 =item AUTHOR
17473
17474 =back
17475
17476 =head2 Fcntl - load the C Fcntl.h defines
17477
17478 =over 4
17479
17480 =item SYNOPSIS
17481
17482 =item DESCRIPTION
17483
17484 =item NOTE
17485
17486 =item EXPORTED SYMBOLS
17487
17488 =back
17489
17490 =head2 File::Basename - Parse file paths into directory, filename and
17491 suffix.
17492
17493 =over 4
17494
17495 =item SYNOPSIS
17496
17497 =item DESCRIPTION
17498
17499 =back
17500
17501 C<fileparse>
17502
17503 C<basename>
17504
17505 C<dirname>
17506
17507 C<fileparse_set_fstype>
17508
17509 =over 4
17510
17511 =item SEE ALSO
17512
17513 =back
17514
17515 =head2 File::CheckTree, validate - run many filetest checks on a tree
17516
17517 =over 4
17518
17519 =item SYNOPSIS
17520
17521 =item DESCRIPTION
17522
17523 =item AUTHOR
17524
17525 =item HISTORY
17526
17527 =back
17528
17529 =head2 File::Compare - Compare files or filehandles
17530
17531 =over 4
17532
17533 =item SYNOPSIS
17534
17535 =item DESCRIPTION
17536
17537 =item RETURN
17538
17539 =item AUTHOR
17540
17541 =back
17542
17543 =head2 File::Copy - Copy files or filehandles
17544
17545 =over 4
17546
17547 =item SYNOPSIS
17548
17549 =item DESCRIPTION
17550
17551 =over 4
17552
17553 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
17554
17555 rmscopy($from,$to[,$date_flag])
17556
17557 =back
17558
17559 =item RETURN
17560
17561 =item NOTES
17562
17563 =item AUTHOR
17564
17565 =back
17566
17567 =head2 File::DosGlob - DOS like globbing and then some
17568
17569 =over 4
17570
17571 =item SYNOPSIS
17572
17573 =item DESCRIPTION
17574
17575 =item NOTES
17576
17577 =item EXPORTS (by request only)
17578
17579 =item BUGS
17580
17581 =item AUTHOR
17582
17583 =item HISTORY
17584
17585 =item SEE ALSO
17586
17587 =back
17588
17589 =head2 File::Find - Traverse a directory tree.
17590
17591 =over 4
17592
17593 =item SYNOPSIS
17594
17595 =item DESCRIPTION
17596
17597 B<find>, B<finddepth>
17598
17599 =over 4
17600
17601 =item %options
17602
17603 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
17604 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
17605 C<untaint>, C<untaint_pattern>, C<untaint_skip>
17606
17607 =item The wanted function
17608
17609 C<$File::Find::dir> is the current directory name,, C<$_> is the current
17610 filename within that directory, C<$File::Find::name> is the complete
17611 pathname to the file
17612
17613 =back
17614
17615 =item WARNINGS
17616
17617 =item CAVEAT
17618
17619 $dont_use_nlink, symlinks
17620
17621 =item NOTES
17622
17623 =item BUGS AND CAVEATS
17624
17625 =item HISTORY
17626
17627 =back
17628
17629 =head2 File::Glob - Perl extension for BSD glob routine
17630
17631 =over 4
17632
17633 =item SYNOPSIS
17634
17635 =item DESCRIPTION
17636
17637 =over 4
17638
17639 =item META CHARACTERS
17640
17641 =item POSIX FLAGS
17642
17643 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
17644 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
17645 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
17646
17647 =back
17648
17649 =item DIAGNOSTICS
17650
17651 C<GLOB_NOSPACE>, C<GLOB_ABEND>
17652
17653 =item NOTES
17654
17655 =item SEE ALSO
17656
17657 =item AUTHOR
17658
17659 =back
17660
17661 =head2 File::GlobMapper - Extend File Glob to Allow Input and Output Files
17662
17663 =over 4
17664
17665 =item SYNOPSIS
17666
17667 =item DESCRIPTION
17668
17669 This code is a work in progress, There are known bugs, The interface
17670 defined here is tentative, There are portability issues, Do not use in
17671 production code, Consider yourself warned!
17672
17673 =over 4
17674
17675 =item Behind The Scenes
17676
17677 =item Limitations
17678
17679 =item Input File Glob
17680
17681 B<~>, B<~user>, B<.>, B<*>, B<?>, B<\>,  B<[]>,  B<{,}>,  B<()>
17682
17683 =item Output File Glob
17684
17685 "*", #1
17686
17687 =item Returned Data
17688
17689 =back
17690
17691 =item EXAMPLES
17692
17693 =over 4
17694
17695 =item A Rename script
17696
17697 =item A few example globmaps
17698
17699 =back
17700
17701 =item SEE ALSO
17702
17703 =item AUTHOR
17704
17705 =item COPYRIGHT AND LICENSE
17706
17707 =back
17708
17709 =head2 File::Path - create or remove directory trees
17710
17711 =over 4
17712
17713 =item SYNOPSIS
17714
17715 =item DESCRIPTION
17716
17717 =item DIAGNOSTICS
17718
17719 =item AUTHORS
17720
17721 =back
17722
17723 =head2 File::Spec - portably perform operations on file names
17724
17725 =over 4
17726
17727 =item SYNOPSIS
17728
17729 =item DESCRIPTION
17730
17731 =item METHODS
17732
17733 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
17734 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
17735 splitdir, catpath(), abs2rel, rel2abs()
17736
17737 =item SEE ALSO
17738
17739 =item AUTHOR
17740
17741 =item COPYRIGHT
17742
17743 =back
17744
17745 =head2 File::Spec::Cygwin - methods for Cygwin file specs
17746
17747 =over 4
17748
17749 =item SYNOPSIS
17750
17751 =item DESCRIPTION
17752
17753 =back
17754
17755 canonpath
17756
17757 file_name_is_absolute
17758
17759 tmpdir (override)
17760
17761 =over 4
17762
17763 =item COPYRIGHT
17764
17765 =back
17766
17767 =head2 File::Spec::Epoc - methods for Epoc file specs
17768
17769 =over 4
17770
17771 =item SYNOPSIS
17772
17773 =item DESCRIPTION
17774
17775 =back
17776
17777 canonpath()
17778
17779 =over 4
17780
17781 =item AUTHOR
17782
17783 =item COPYRIGHT
17784
17785 =item SEE ALSO
17786
17787 =back
17788
17789 =head2 File::Spec::Functions - portably perform operations on file names
17790
17791 =over 4
17792
17793 =item SYNOPSIS
17794
17795 =item DESCRIPTION
17796
17797 =over 4
17798
17799 =item Exports
17800
17801 =back
17802
17803 =item COPYRIGHT
17804
17805 =item SEE ALSO
17806
17807 =back
17808
17809 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
17810
17811 =over 4
17812
17813 =item SYNOPSIS
17814
17815 =item DESCRIPTION
17816
17817 =item METHODS
17818
17819 canonpath
17820
17821 =back
17822
17823 catdir()
17824
17825 catfile
17826
17827 curdir
17828
17829 devnull
17830
17831 rootdir
17832
17833 tmpdir
17834
17835 updir
17836
17837 file_name_is_absolute
17838
17839 path
17840
17841 splitpath
17842
17843 splitdir
17844
17845 catpath
17846
17847 abs2rel
17848
17849 rel2abs
17850
17851 =over 4
17852
17853 =item AUTHORS
17854
17855 =item COPYRIGHT
17856
17857 =item SEE ALSO
17858
17859 =back
17860
17861 =head2 File::Spec::OS2 - methods for OS/2 file specs
17862
17863 =over 4
17864
17865 =item SYNOPSIS
17866
17867 =item DESCRIPTION
17868
17869 tmpdir, splitpath
17870
17871 =item COPYRIGHT
17872
17873 =back
17874
17875 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
17876 modules
17877
17878 =over 4
17879
17880 =item SYNOPSIS
17881
17882 =item DESCRIPTION
17883
17884 =item METHODS
17885
17886 canonpath()
17887
17888 =back
17889
17890 catdir()
17891
17892 catfile
17893
17894 curdir
17895
17896 devnull
17897
17898 rootdir
17899
17900 tmpdir
17901
17902 updir
17903
17904 no_upwards
17905
17906 case_tolerant
17907
17908 file_name_is_absolute
17909
17910 path
17911
17912 join
17913
17914 splitpath
17915
17916 splitdir
17917
17918 catpath()
17919
17920 abs2rel
17921
17922 rel2abs()
17923
17924 =over 4
17925
17926 =item COPYRIGHT
17927
17928 =item SEE ALSO
17929
17930 =back
17931
17932 =head2 File::Spec::VMS - methods for VMS file specs
17933
17934 =over 4
17935
17936 =item SYNOPSIS
17937
17938 =item DESCRIPTION
17939
17940 canonpath (override)
17941
17942 =back
17943
17944 catdir (override)
17945
17946 catfile (override)
17947
17948 curdir (override)
17949
17950 devnull (override)
17951
17952 rootdir (override)
17953
17954 tmpdir (override)
17955
17956 updir (override)
17957
17958 case_tolerant (override)
17959
17960 path (override)
17961
17962 file_name_is_absolute (override)
17963
17964 splitpath (override)
17965
17966 splitdir (override)
17967
17968 catpath (override)
17969
17970 abs2rel (override)
17971
17972 rel2abs (override)
17973
17974 =over 4
17975
17976 =item COPYRIGHT
17977
17978 =item SEE ALSO
17979
17980 =back
17981
17982 =head2 File::Spec::Win32 - methods for Win32 file specs
17983
17984 =over 4
17985
17986 =item SYNOPSIS
17987
17988 =item DESCRIPTION
17989
17990 devnull
17991
17992 =back
17993
17994 tmpdir
17995
17996 catfile
17997
17998 canonpath
17999
18000 splitpath
18001
18002 splitdir
18003
18004 catpath
18005
18006 =over 4
18007
18008 =item Note For File::Spec::Win32 Maintainers
18009
18010 =back
18011
18012 =over 4
18013
18014 =item COPYRIGHT
18015
18016 =item SEE ALSO
18017
18018 =back
18019
18020 =head2 File::Temp - return name and handle of a temporary file safely
18021
18022 =over 4
18023
18024 =item PORTABILITY
18025
18026 =item SYNOPSIS
18027
18028 =item DESCRIPTION
18029
18030 =back
18031
18032 =over 4
18033
18034 =item OBJECT-ORIENTED INTERFACE
18035
18036 B<new>
18037
18038 =back
18039
18040 B<filename>
18041
18042 B<unlink_on_destroy>
18043
18044 B<DESTROY>
18045
18046 =over 4
18047
18048 =item FUNCTIONS
18049
18050 B<tempfile>
18051
18052 =back
18053
18054 B<tempdir>
18055
18056 =over 4
18057
18058 =item MKTEMP FUNCTIONS
18059
18060 B<mkstemp>
18061
18062 =back
18063
18064 B<mkstemps>
18065
18066 B<mkdtemp>
18067
18068 B<mktemp>
18069
18070 =over 4
18071
18072 =item POSIX FUNCTIONS
18073
18074 B<tmpnam>
18075
18076 =back
18077
18078 B<tmpfile>
18079
18080 =over 4
18081
18082 =item ADDITIONAL FUNCTIONS
18083
18084 B<tempnam>
18085
18086 =back
18087
18088 =over 4
18089
18090 =item UTILITY FUNCTIONS
18091
18092 B<unlink0>
18093
18094 =back
18095
18096 B<cmpstat>
18097
18098 B<unlink1>
18099
18100 B<cleanup>
18101
18102 =over 4
18103
18104 =item PACKAGE VARIABLES
18105
18106 B<safe_level>, STANDARD, MEDIUM, HIGH
18107
18108 =back
18109
18110 TopSystemUID
18111
18112 B<$KEEP_ALL>, B<$DEBUG>
18113
18114 =over 4
18115
18116 =item WARNING
18117
18118 =over 4
18119
18120 =item Temporary files and NFS
18121
18122 =item Forking
18123
18124 =item BINMODE
18125
18126 =back
18127
18128 =item HISTORY
18129
18130 =item SEE ALSO
18131
18132 =item AUTHOR
18133
18134 =back
18135
18136 =head2 File::stat - by-name interface to Perl's built-in stat() functions
18137
18138 =over 4
18139
18140 =item SYNOPSIS
18141
18142 =item DESCRIPTION
18143
18144 =item BUGS
18145
18146 =item NOTE
18147
18148 =item AUTHOR
18149
18150 =back
18151
18152 =head2 FileCache - keep more files open than the system permits
18153
18154 =over 4
18155
18156 =item SYNOPSIS
18157
18158 =item DESCRIPTION
18159
18160 cacheout EXPR, cacheout MODE, EXPR
18161
18162 =item CAVEATS
18163
18164 =item BUGS
18165
18166 =back
18167
18168 =head2 FileHandle - supply object methods for filehandles
18169
18170 =over 4
18171
18172 =item SYNOPSIS
18173
18174 =item DESCRIPTION
18175
18176 $fh->print, $fh->printf, $fh->getline, $fh->getlines
18177
18178 =item SEE ALSO
18179
18180 =back
18181
18182 =head2 Filter::Simple - Simplified source filtering
18183
18184 =over 4
18185
18186 =item SYNOPSIS
18187
18188 =item DESCRIPTION
18189
18190 =over 4
18191
18192 =item The Problem
18193
18194 =item A Solution
18195
18196 =item Disabling or changing <no> behaviour
18197
18198 =item All-in-one interface
18199
18200 =item Filtering only specific components of source code
18201
18202 C<"code">, C<"code_no_comments">, C<"executable">,
18203 C<"executable_no_comments">, C<"quotelike">, C<"string">, C<"regex">,
18204 C<"all">
18205
18206 =item Filtering only the code parts of source code
18207
18208 Most source code ceases to be grammatically correct when it is broken up
18209 into the pieces between string literals and regexes. So the C<'code'>
18210 and C<'code_no_comments'> component filter behave slightly differently
18211 from the other partial filters described in the previous section.
18212
18213 =item Using Filter::Simple with an explicit C<import> subroutine
18214
18215 =item Using Filter::Simple and Exporter together
18216
18217 =item How it works
18218
18219 =back
18220
18221 =item AUTHOR
18222
18223 =item COPYRIGHT
18224
18225 =back
18226
18227 =head2 Filter::Util::Call - Perl Source Filter Utility Module
18228
18229 =over 4
18230
18231 =item SYNOPSIS
18232
18233 =item DESCRIPTION
18234
18235 =over 4
18236
18237 =item B<use Filter::Util::Call>
18238
18239 =item B<import()>
18240
18241 =item B<filter() and anonymous sub>
18242
18243 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
18244
18245 =back
18246
18247 =item EXAMPLES
18248
18249 =over 4
18250
18251 =item Example 1: A simple filter.
18252
18253 =item Example 2: Using the context
18254
18255 =item Example 3: Using the context within the filter
18256
18257 =item Example 4: Using filter_del
18258
18259 =back
18260
18261 =item Filter::Simple
18262
18263 =item AUTHOR
18264
18265 =item DATE
18266
18267 =back
18268
18269 =head2 FindBin - Locate directory of original perl script
18270
18271 =over 4
18272
18273 =item SYNOPSIS
18274
18275 =item DESCRIPTION
18276
18277 =item EXPORTABLE VARIABLES
18278
18279 =item KNOWN ISSUES
18280
18281 =item KNOWN BUGS
18282
18283 =item AUTHORS
18284
18285 =item COPYRIGHT
18286
18287 =back
18288
18289 =head2 GDBM_File - Perl5 access to the gdbm library.
18290
18291 =over 4
18292
18293 =item SYNOPSIS
18294
18295 =item DESCRIPTION
18296
18297 =item AVAILABILITY
18298
18299 =item BUGS
18300
18301 =item SEE ALSO
18302
18303 =back
18304
18305 =head2 Getopt::Long - Extended processing of command line options
18306
18307 =over 4
18308
18309 =item SYNOPSIS
18310
18311 =item DESCRIPTION
18312
18313 =item Command Line Options, an Introduction
18314
18315 =item Getting Started with Getopt::Long
18316
18317 =over 4
18318
18319 =item Simple options
18320
18321 =item A little bit less simple options
18322
18323 =item Mixing command line option with other arguments
18324
18325 =item Options with values
18326
18327 =item Options with multiple values
18328
18329 =item Options with hash values
18330
18331 =item User-defined subroutines to handle options
18332
18333 =item Options with multiple names
18334
18335 =item Case and abbreviations
18336
18337 =item Summary of Option Specifications
18338
18339 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
18340 + [ I<desttype> ]
18341
18342 =back
18343
18344 =item Advanced Possibilities
18345
18346 =over 4
18347
18348 =item Object oriented interface
18349
18350 =item Thread Safety
18351
18352 =item Documentation and help texts
18353
18354 =item Storing option values in a hash
18355
18356 =item Bundling
18357
18358 =item The lonesome dash
18359
18360 =item Argument callback
18361
18362 =back
18363
18364 =item Configuring Getopt::Long
18365
18366 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
18367 require_order, permute, bundling (default: disabled), bundling_override
18368 (default: disabled), ignore_case  (default: enabled), ignore_case_always
18369 (default: disabled), auto_version (default:disabled), auto_help
18370 (default:disabled), pass_through (default: disabled), prefix,
18371 prefix_pattern, long_prefix_pattern, debug (default: disabled)
18372
18373 =item Exportable Methods
18374
18375 VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage
18376
18377 =item Return values and Errors
18378
18379 =item Legacy
18380
18381 =over 4
18382
18383 =item Default destinations
18384
18385 =item Alternative option starters
18386
18387 =item Configuration variables
18388
18389 =back
18390
18391 =item Trouble Shooting
18392
18393 =over 4
18394
18395 =item GetOptions does not return a false result when an option is not
18396 supplied
18397
18398 =item GetOptions does not split the command line correctly
18399
18400 =item Undefined subroutine &main::GetOptions called
18401
18402 =item How do I put a "-?" option into a Getopt::Long?
18403
18404 =back
18405
18406 =item AUTHOR
18407
18408 =item COPYRIGHT AND DISCLAIMER
18409
18410 =back
18411
18412 =head2 Getopt::Std, getopt, getopts - Process single-character switches
18413 with switch clustering
18414
18415 =over 4
18416
18417 =item SYNOPSIS
18418
18419 =item DESCRIPTION
18420
18421 =item C<--help> and C<--version>
18422
18423 =back
18424
18425 =head2 Hash::Util - A selection of general-utility hash subroutines
18426
18427 =over 4
18428
18429 =item SYNOPSIS
18430
18431 =item DESCRIPTION
18432
18433 =over 4
18434
18435 =item Restricted hashes
18436
18437 lock_keys, unlock_keys
18438
18439 =back
18440
18441 =back
18442
18443 lock_value, unlock_value
18444
18445 B<lock_hash>, B<unlock_hash>
18446
18447 B<hash_seed>
18448
18449 =over 4
18450
18451 =item CAVEATS
18452
18453 =item AUTHOR
18454
18455 =item SEE ALSO
18456
18457 =back
18458
18459 =head2 I18N::Collate - compare 8-bit scalar data according to the current
18460 locale
18461
18462 =over 4
18463
18464 =item SYNOPSIS
18465
18466 =item DESCRIPTION
18467
18468 =back
18469
18470 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
18471 tags
18472
18473 =over 4
18474
18475 =item SYNOPSIS
18476
18477 =item DESCRIPTION
18478
18479 =back
18480
18481 the function is_language_tag($lang1)
18482
18483 the function extract_language_tags($whatever)
18484
18485 the function same_language_tag($lang1, $lang2)
18486
18487 the function similarity_language_tag($lang1, $lang2)
18488
18489 the function is_dialect_of($lang1, $lang2)
18490
18491 the function super_languages($lang1)
18492
18493 the function locale2language_tag($locale_identifier)
18494
18495 the function encode_language_tag($lang1)
18496
18497 the function alternate_language_tags($lang1)
18498
18499 the function @langs = panic_languages(@accept_languages)
18500
18501 the function implicate_supers( ...languages... ), the function
18502 implicate_supers_strictly( ...languages... )
18503
18504 =over 4
18505
18506 =item ABOUT LOWERCASING
18507
18508 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
18509
18510 =item SEE ALSO
18511
18512 =item COPYRIGHT
18513
18514 =item AUTHOR
18515
18516 =back
18517
18518 =head2 I18N::LangTags::Detect - detect the user's language preferences
18519
18520 =over 4
18521
18522 =item SYNOPSIS
18523
18524 =item DESCRIPTION
18525
18526 =item FUNCTIONS
18527
18528 =item ENVIRONMENT
18529
18530 =item SEE ALSO
18531
18532 =item COPYRIGHT
18533
18534 =item AUTHOR
18535
18536 =back
18537
18538 =head2 I18N::LangTags::List -- tags and names for human languages
18539
18540 =over 4
18541
18542 =item SYNOPSIS
18543
18544 =item DESCRIPTION
18545
18546 =item ABOUT LANGUAGE TAGS
18547
18548 =item LIST OF LANGUAGES
18549
18550 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} :
18551 Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} :
18552 Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian,
18553 {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)],
18554 {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic,
18555 {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy}
18556 : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} :
18557 Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} :
18558 Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae}
18559 : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} :
18560 Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai}
18561 : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} :
18562 Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} :
18563 Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber
18564 (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini,
18565 {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} :
18566 Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} :
18567 Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian
18568 (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central
18569 American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages],
18570 {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb}
18571 : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} :
18572 Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} :
18573 Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree,
18574 {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf}
18575 : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based
18576 Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} :
18577 Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} :
18578 Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru)
18579 Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri,
18580 {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch,
18581 {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi}
18582 : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} :
18583 English, {enm} : Old English (1100-1500), {ang} : Old English
18584 (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} :
18585 Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat}
18586 : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} :
18587 Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French
18588 (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} :
18589 Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan,
18590 {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian,
18591 {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High
18592 German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon}
18593 : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient
18594 Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} :
18595 Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian,
18596 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
18597 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
18598 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo,
18599 {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European
18600 (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua
18601 (International Auxiliary Language Association), {ie} : Interlingue, {iu} :
18602 Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} :
18603 Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian
18604 languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} :
18605 Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle,
18606 {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} :
18607 Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar}
18608 : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh,
18609 {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese,
18610 {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz,
18611 {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} :
18612 Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama,
18613 {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} :
18614 Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} :
18615 Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} :
18616 Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban
18617 (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui}
18618 : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai,
18619 {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili,
18620 {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} :
18621 Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} :
18622 Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} :
18623 Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai,
18624 [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} :
18625 Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} :
18626 Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)],
18627 {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple
18628 languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan,
18629 {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele,
18630 {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
18631 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
18632 {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} :
18633 Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} :
18634 Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi}
18635 : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} :
18636 Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
18637 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
18638 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
18639 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
18640 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
18641 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
18642 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
18643 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
18644 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
18645 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
18646 languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} :
18647 Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami,
18648 [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} :
18649 Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak,
18650 {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian,
18651 {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign
18652 Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} :
18653 Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave
18654 (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian,
18655 {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} :
18656 Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} :
18657 South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} :
18658 Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati,
18659 {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} :
18660 Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao,
18661 {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} :
18662 Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} :
18663 Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau,
18664 {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian,
18665 {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} :
18666 Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh}
18667 : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} :
18668 Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian,
18669 {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} :
18670 Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak}
18671 : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was}
18672 : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private
18673 Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} :
18674 Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
18675 : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu,
18676 {zun} : Zuni
18677
18678 =item SEE ALSO
18679
18680 =item COPYRIGHT AND DISCLAIMER
18681
18682 =item AUTHOR
18683
18684 =back
18685
18686 =head2 I18N::Langinfo - query locale information
18687
18688 =over 4
18689
18690 =item SYNOPSIS
18691
18692 =item DESCRIPTION
18693
18694 =over 4
18695
18696 =item EXPORT
18697
18698 =back
18699
18700 =item SEE ALSO
18701
18702 =item AUTHOR
18703
18704 =item COPYRIGHT AND LICENSE
18705
18706 =back
18707
18708 =head2 IO - load various IO modules
18709
18710 =over 4
18711
18712 =item SYNOPSIS
18713
18714 =item DESCRIPTION
18715
18716 =item DEPRECATED
18717
18718 =back
18719
18720 =head2 IO::Compress::Deflate     - Perl interface to write RFC 1950
18721 files/buffers
18722
18723 =over 4
18724
18725 =item SYNOPSIS
18726
18727 =item DESCRIPTION
18728
18729 DO NOT use in production code, The documentation is incomplete in places,
18730 Parts of the interface defined here are tentative, Please report any
18731 problems you find
18732
18733 =item Functional Interface
18734
18735 =over 4
18736
18737 =item deflate $input => $output [, OPTS]
18738
18739 A filename, A filehandle, A scalar reference, An array reference, An Input
18740 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
18741 Reference, An Array Reference, An Output FileGlob
18742
18743 =item deflate \%hash [, OPTS]
18744
18745 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
18746 Array Reference
18747
18748 =item Notes
18749
18750 =item Optional Parameters
18751
18752 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
18753
18754 =item Examples
18755
18756 =back
18757
18758 =item OO Interface
18759
18760 =over 4
18761
18762 =item Constructor
18763
18764 A filename, A filehandle, A scalar reference
18765
18766 =item Constructor Options
18767
18768 -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1, A Buffer, A Filename, A
18769 Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1
18770
18771 =item Examples
18772
18773 =back
18774
18775 =item Methods 
18776
18777 =over 4
18778
18779 =item print
18780
18781 =item printf
18782
18783 =item syswrite
18784
18785 =item write
18786
18787 =item flush
18788
18789 =item tell
18790
18791 =item eof
18792
18793 =item seek
18794
18795 =item binmode
18796
18797 =item fileno
18798
18799 =item close
18800
18801 =item newStream
18802
18803 =item deflateParams
18804
18805 =back
18806
18807 =item Importing 
18808
18809 :all, :constants, :flush, :level, :strategy
18810
18811 =item EXAMPLES
18812
18813 =item SEE ALSO
18814
18815 =item AUTHOR
18816
18817 =item MODIFICATION HISTORY
18818
18819 =item COPYRIGHT AND LICENSE
18820
18821 =back
18822
18823 =head2 IO::Compress::Gzip     - Perl interface to write RFC 1952
18824 files/buffers
18825
18826 =over 4
18827
18828 =item SYNOPSIS
18829
18830 =item DESCRIPTION
18831
18832 DO NOT use in production code, The documentation is incomplete in places,
18833 Parts of the interface defined here are tentative, Please report any
18834 problems you find
18835
18836 =item Functional Interface
18837
18838 =over 4
18839
18840 =item gzip $input => $output [, OPTS]
18841
18842 A filename, A filehandle, A scalar reference, An array reference, An Input
18843 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
18844 Reference, An Array Reference, An Output FileGlob
18845
18846 =item gzip \%hash [, OPTS]
18847
18848 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
18849 Array Reference
18850
18851 =item Notes
18852
18853 =item Optional Parameters
18854
18855 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
18856
18857 =item Examples
18858
18859 =back
18860
18861 =item OO Interface
18862
18863 =over 4
18864
18865 =item Constructor
18866
18867 A filename, A filehandle, A scalar reference
18868
18869 =item Constructor Options
18870
18871 -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1, A Buffer, A Filename, A
18872 Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Mimimal =E<gt> 0|1,
18873 -Comment =E<gt> $comment, -Name =E<gt> $string, -Time =E<gt> $number,
18874 -TextFlag =E<gt> 0|1, -HeaderCRC =E<gt> 0|1, -OS_Code =E<gt> $value,
18875 -ExtraField =E<gt> $data, -ExtraFlags =E<gt> $value, -Strict =E<gt> 0|1
18876
18877 =item Examples
18878
18879 =back
18880
18881 =item Methods 
18882
18883 =over 4
18884
18885 =item print
18886
18887 =item printf
18888
18889 =item syswrite
18890
18891 =item write
18892
18893 =item flush
18894
18895 =item tell
18896
18897 =item eof
18898
18899 =item seek
18900
18901 =item binmode
18902
18903 =item fileno
18904
18905 =item close
18906
18907 =item newStream
18908
18909 =item deflateParams
18910
18911 =back
18912
18913 =item Importing 
18914
18915 :all, :constants, :flush, :level, :strategy
18916
18917 =item EXAMPLES
18918
18919 =item SEE ALSO
18920
18921 =item AUTHOR
18922
18923 =item MODIFICATION HISTORY
18924
18925 =item COPYRIGHT AND LICENSE
18926
18927 =back
18928
18929 =head2 IO::Compress::RawDeflate     - Perl interface to write RFC 1951
18930 files/buffers
18931
18932 =over 4
18933
18934 =item SYNOPSIS
18935
18936 =item DESCRIPTION
18937
18938 DO NOT use in production code, The documentation is incomplete in places,
18939 Parts of the interface defined here are tentative, Please report any
18940 problems you find
18941
18942 =item Functional Interface
18943
18944 =over 4
18945
18946 =item rawdeflate $input => $output [, OPTS]
18947
18948 A filename, A filehandle, A scalar reference, An array reference, An Input
18949 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
18950 Reference, An Array Reference, An Output FileGlob
18951
18952 =item rawdeflate \%hash [, OPTS]
18953
18954 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
18955 Array Reference
18956
18957 =item Notes
18958
18959 =item Optional Parameters
18960
18961 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
18962
18963 =item Examples
18964
18965 =back
18966
18967 =item OO Interface
18968
18969 =over 4
18970
18971 =item Constructor
18972
18973 A filename, A filehandle, A scalar reference
18974
18975 =item Constructor Options
18976
18977 -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1, A Buffer, A Filename, A
18978 Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1
18979
18980 =item Examples
18981
18982 =back
18983
18984 =item Methods 
18985
18986 =over 4
18987
18988 =item print
18989
18990 =item printf
18991
18992 =item syswrite
18993
18994 =item write
18995
18996 =item flush
18997
18998 =item tell
18999
19000 =item eof
19001
19002 =item seek
19003
19004 =item binmode
19005
19006 =item fileno
19007
19008 =item close
19009
19010 =item newStream
19011
19012 =item deflateParams
19013
19014 =back
19015
19016 =item Importing 
19017
19018 :all, :constants, :flush, :level, :strategy
19019
19020 =item EXAMPLES
19021
19022 =item SEE ALSO
19023
19024 =item AUTHOR
19025
19026 =item MODIFICATION HISTORY
19027
19028 =item COPYRIGHT AND LICENSE
19029
19030 =back
19031
19032 =head2 IO::Dir - supply object methods for directory handles
19033
19034 =over 4
19035
19036 =item SYNOPSIS
19037
19038 =item DESCRIPTION
19039
19040 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
19041 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
19042
19043 =item SEE ALSO
19044
19045 =item AUTHOR
19046
19047 =item COPYRIGHT
19048
19049 =back
19050
19051 =head2 IO::File - supply object methods for filehandles
19052
19053 =over 4
19054
19055 =item SYNOPSIS
19056
19057 =item DESCRIPTION
19058
19059 =item CONSTRUCTOR
19060
19061 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
19062
19063 =item METHODS
19064
19065 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode(
19066 [LAYER] )
19067
19068 =item NOTE
19069
19070 =item SEE ALSO
19071
19072 =item HISTORY
19073
19074 =back
19075
19076 =head2 IO::Handle - supply object methods for I/O handles
19077
19078 =over 4
19079
19080 =item SYNOPSIS
19081
19082 =item DESCRIPTION
19083
19084 =item CONSTRUCTOR
19085
19086 new (), new_from_fd ( FD, MODE )
19087
19088 =item METHODS
19089
19090 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
19091 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
19092 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
19093 $io->blocking ( [ BOOL ] ), $io->untaint
19094
19095 =item NOTE
19096
19097 =item SEE ALSO
19098
19099 =item BUGS
19100
19101 =item HISTORY
19102
19103 =back
19104
19105 =head2 IO::Pipe - supply object methods for pipes
19106
19107 =over 4
19108
19109 =item SYNOPSIS
19110
19111 =item DESCRIPTION
19112
19113 =item CONSTRUCTOR
19114
19115 new ( [READER, WRITER] )
19116
19117 =item METHODS
19118
19119 reader ([ARGS]), writer ([ARGS]), handles ()
19120
19121 =item SEE ALSO
19122
19123 =item AUTHOR
19124
19125 =item COPYRIGHT
19126
19127 =back
19128
19129 =head2 IO::Poll - Object interface to system poll call
19130
19131 =over 4
19132
19133 =item SYNOPSIS
19134
19135 =item DESCRIPTION
19136
19137 =item METHODS
19138
19139 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
19140 IO ), handles( [ EVENT_MASK ] )
19141
19142 =item SEE ALSO
19143
19144 =item AUTHOR
19145
19146 =item COPYRIGHT
19147
19148 =back
19149
19150 =head2 IO::Seekable - supply seek based methods for I/O objects
19151
19152 =over 4
19153
19154 =item SYNOPSIS
19155
19156 =item DESCRIPTION
19157
19158 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
19159 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
19160 $io->tell
19161
19162 =item SEE ALSO
19163
19164 =item HISTORY
19165
19166 =back
19167
19168 =head2 IO::Select - OO interface to the select system call
19169
19170 =over 4
19171
19172 =item SYNOPSIS
19173
19174 =item DESCRIPTION
19175
19176 =item CONSTRUCTOR
19177
19178 new ( [ HANDLES ] )
19179
19180 =item METHODS
19181
19182 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
19183 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
19184 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
19185
19186 =item EXAMPLE
19187
19188 =item AUTHOR
19189
19190 =item COPYRIGHT
19191
19192 =back
19193
19194 =head2 IO::Socket - Object interface to socket communications
19195
19196 =over 4
19197
19198 =item SYNOPSIS
19199
19200 =item DESCRIPTION
19201
19202 =item CONSTRUCTOR
19203
19204 new ( [ARGS] )
19205
19206 =item METHODS
19207
19208 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
19209 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
19210
19211 =item SEE ALSO
19212
19213 =item AUTHOR
19214
19215 =item COPYRIGHT
19216
19217 =back
19218
19219 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
19220
19221 =over 4
19222
19223 =item SYNOPSIS
19224
19225 =item DESCRIPTION
19226
19227 =item CONSTRUCTOR
19228
19229 new ( [ARGS] )
19230
19231 =over 4
19232
19233 =item METHODS
19234
19235 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
19236 ()
19237
19238 =back
19239
19240 =item SEE ALSO
19241
19242 =item AUTHOR
19243
19244 =item COPYRIGHT
19245
19246 =back
19247
19248 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
19249
19250 =over 4
19251
19252 =item SYNOPSIS
19253
19254 =item DESCRIPTION
19255
19256 =item CONSTRUCTOR
19257
19258 new ( [ARGS] )
19259
19260 =item METHODS
19261
19262 hostpath(), peerpath()
19263
19264 =item SEE ALSO
19265
19266 =item AUTHOR
19267
19268 =item COPYRIGHT
19269
19270 =back
19271
19272 =head2 IO::Uncompress::AnyInflate - Perl interface to read RFC 1950, 1951 &
19273 1952 files/buffers
19274
19275 =over 4
19276
19277 =item SYNOPSIS
19278
19279 =item DESCRIPTION
19280
19281 DO NOT use in production code, The documentation is incomplete in places,
19282 Parts of the interface defined here are tentative, Please report any
19283 problems you find
19284
19285 =item Functional Interface
19286
19287 =over 4
19288
19289 =item anyinflate $input => $output [, OPTS]
19290
19291 A filename, A filehandle, A scalar reference, An array reference, An Input
19292 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
19293 Reference, An Array Reference, An Output FileGlob
19294
19295 =item anyinflate \%hash [, OPTS]
19296
19297 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
19298 Array Reference
19299
19300 =item Notes
19301
19302 =item Optional Parameters
19303
19304 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
19305
19306 =item Examples
19307
19308 =back
19309
19310 =item OO Interface
19311
19312 =over 4
19313
19314 =item Constructor
19315
19316 A filename, A filehandle, A scalar reference
19317
19318 =item Constructor Options
19319
19320 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
19321 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
19322 -Append =E<gt> 0|1, -Strict =E<gt> 0|1, -ParseExtra =E<gt> 0|1
19323
19324 =item Examples
19325
19326 =back
19327
19328 =item Methods 
19329
19330 =over 4
19331
19332 =item read
19333
19334 =item read
19335
19336 =item getline
19337
19338 =item getc
19339
19340 =item ungetc
19341
19342 =item inflateSync
19343
19344 =item getHeaderInfo
19345
19346 =item tell
19347
19348 =item eof
19349
19350 =item seek
19351
19352 =item binmode
19353
19354 =item fileno
19355
19356 =item close
19357
19358 =back
19359
19360 =item Importing 
19361
19362 :all
19363
19364 =item EXAMPLES
19365
19366 =item SEE ALSO
19367
19368 =item AUTHOR
19369
19370 =item MODIFICATION HISTORY
19371
19372 =item COPYRIGHT AND LICENSE
19373
19374 =back
19375
19376 =head2 IO::Uncompress::Gunzip - Perl interface to read RFC 1952
19377 files/buffers
19378
19379 =over 4
19380
19381 =item SYNOPSIS
19382
19383 =item DESCRIPTION
19384
19385 DO NOT use in production code, The documentation is incomplete in places,
19386 Parts of the interface defined here are tentative, Please report any
19387 problems you find
19388
19389 =item Functional Interface
19390
19391 =over 4
19392
19393 =item gunzip $input => $output [, OPTS]
19394
19395 A filename, A filehandle, A scalar reference, An array reference, An Input
19396 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
19397 Reference, An Array Reference, An Output FileGlob
19398
19399 =item gunzip \%hash [, OPTS]
19400
19401 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
19402 Array Reference
19403
19404 =item Notes
19405
19406 =item Optional Parameters
19407
19408 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
19409
19410 =item Examples
19411
19412 =back
19413
19414 =item OO Interface
19415
19416 =over 4
19417
19418 =item Constructor
19419
19420 A filename, A filehandle, A scalar reference
19421
19422 =item Constructor Options
19423
19424 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
19425 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
19426 -Append =E<gt> 0|1, -Strict =E<gt> 0|1, -ParseExtra =E<gt> 0|1
19427
19428 =item Examples
19429
19430 =back
19431
19432 =item Methods 
19433
19434 =over 4
19435
19436 =item read
19437
19438 =item read
19439
19440 =item getline
19441
19442 =item getc
19443
19444 =item ungetc
19445
19446 =item inflateSync
19447
19448 =item getHeaderInfo
19449
19450 Comment
19451
19452 =item tell
19453
19454 =item eof
19455
19456 =item seek
19457
19458 =item binmode
19459
19460 =item fileno
19461
19462 =item close
19463
19464 =back
19465
19466 =item Importing 
19467
19468 :all
19469
19470 =item EXAMPLES
19471
19472 =item SEE ALSO
19473
19474 =item AUTHOR
19475
19476 =item MODIFICATION HISTORY
19477
19478 =item COPYRIGHT AND LICENSE
19479
19480 =back
19481
19482 =head2 IO::Uncompress::Inflate - Perl interface to read RFC 1950
19483 files/buffers
19484
19485 =over 4
19486
19487 =item SYNOPSIS
19488
19489 =item DESCRIPTION
19490
19491 DO NOT use in production code, The documentation is incomplete in places,
19492 Parts of the interface defined here are tentative, Please report any
19493 problems you find
19494
19495 =item Functional Interface
19496
19497 =over 4
19498
19499 =item inflate $input => $output [, OPTS]
19500
19501 A filename, A filehandle, A scalar reference, An array reference, An Input
19502 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
19503 Reference, An Array Reference, An Output FileGlob
19504
19505 =item inflate \%hash [, OPTS]
19506
19507 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
19508 Array Reference
19509
19510 =item Notes
19511
19512 =item Optional Parameters
19513
19514 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
19515
19516 =item Examples
19517
19518 =back
19519
19520 =item OO Interface
19521
19522 =over 4
19523
19524 =item Constructor
19525
19526 A filename, A filehandle, A scalar reference
19527
19528 =item Constructor Options
19529
19530 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
19531 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
19532 -Append =E<gt> 0|1, -Strict =E<gt> 0|1
19533
19534 =item Examples
19535
19536 =back
19537
19538 =item Methods 
19539
19540 =over 4
19541
19542 =item read
19543
19544 =item read
19545
19546 =item getline
19547
19548 =item getc
19549
19550 =item ungetc
19551
19552 =item inflateSync
19553
19554 =item getHeaderInfo
19555
19556 =item tell
19557
19558 =item eof
19559
19560 =item seek
19561
19562 =item binmode
19563
19564 =item fileno
19565
19566 =item close
19567
19568 =back
19569
19570 =item Importing 
19571
19572 :all
19573
19574 =item EXAMPLES
19575
19576 =item SEE ALSO
19577
19578 =item AUTHOR
19579
19580 =item MODIFICATION HISTORY
19581
19582 =item COPYRIGHT AND LICENSE
19583
19584 =back
19585
19586 =head2 IO::Uncompress::RawInflate - Perl interface to read RFC 1951
19587 files/buffers
19588
19589 =over 4
19590
19591 =item SYNOPSIS
19592
19593 =item DESCRIPTION
19594
19595 DO NOT use in production code, The documentation is incomplete in places,
19596 Parts of the interface defined here are tentative, Please report any
19597 problems you find
19598
19599 =item Functional Interface
19600
19601 =over 4
19602
19603 =item rawinflate $input => $output [, OPTS]
19604
19605 A filename, A filehandle, A scalar reference, An array reference, An Input
19606 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
19607 Reference, An Array Reference, An Output FileGlob
19608
19609 =item rawinflate \%hash [, OPTS]
19610
19611 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
19612 Array Reference
19613
19614 =item Notes
19615
19616 =item Optional Parameters
19617
19618 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
19619
19620 =item Examples
19621
19622 =back
19623
19624 =item OO Interface
19625
19626 =over 4
19627
19628 =item Constructor
19629
19630 A filename, A filehandle, A scalar reference
19631
19632 =item Constructor Options
19633
19634 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
19635 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
19636 -Append =E<gt> 0|1, -Strict =E<gt> 0|1
19637
19638 =item Examples
19639
19640 =back
19641
19642 =item Methods 
19643
19644 =over 4
19645
19646 =item read
19647
19648 =item read
19649
19650 =item getline
19651
19652 =item getc
19653
19654 =item ungetc
19655
19656 =item inflateSync
19657
19658 =item getHeaderInfo
19659
19660 =item tell
19661
19662 =item eof
19663
19664 =item seek
19665
19666 =item binmode
19667
19668 =item fileno
19669
19670 =item close
19671
19672 =back
19673
19674 =item Importing 
19675
19676 :all
19677
19678 =item EXAMPLES
19679
19680 =item SEE ALSO
19681
19682 =item AUTHOR
19683
19684 =item MODIFICATION HISTORY
19685
19686 =item COPYRIGHT AND LICENSE
19687
19688 =back
19689
19690 =head2 IO::Zlib - IO:: style interface to L<Compress::Zlib>
19691
19692 =over 4
19693
19694 =item SYNOPSIS
19695
19696 =item DESCRIPTION
19697
19698 =item CONSTRUCTOR
19699
19700 new ( [ARGS] )
19701
19702 =item OBJECT METHODS
19703
19704 open ( FILENAME, MODE ), opened, close, getc, getline, getlines, print (
19705 ARGS... ), read ( BUF, NBYTES, [OFFSET] ), eof, seek ( OFFSET, WHENCE ),
19706 tell, setpos ( POS ), getpos ( POS )
19707
19708 =item USING THE EXTERNAL GZIP
19709
19710 =item CLASS METHODS
19711
19712 has_Compress_Zlib, gzip_external, gzip_used, gzip_read_open,
19713 gzip_write_open
19714
19715 =item DIAGNOSTICS
19716
19717 IO::Zlib::getlines: must be called in list context,
19718 IO::Zlib::gzopen_external: mode '...' is illegal, IO::Zlib::import: '...'
19719 is illegal, IO::Zlib::import: ':gzip_external' requires an argument,
19720 IO::Zlib::import: 'gzip_read_open' requires an argument, IO::Zlib::import:
19721 'gzip_read' '...' is illegal, IO::Zlib::import: 'gzip_write_open' requires
19722 an argument, IO::Zlib::import: 'gzip_write_open' '...' is illegal,
19723 IO::Zlib::import: no Compress::Zlib and no external gzip, IO::Zlib::open:
19724 needs a filename, IO::Zlib::READ: NBYTES must be specified, IO::Zlib::READ:
19725 OFFSET is not supported, IO::Zlib::WRITE: too long LENGTH, IO::Zlib::WRITE:
19726 OFFSET is not supported
19727
19728 =item SEE ALSO
19729
19730 =item HISTORY
19731
19732 =item COPYRIGHT
19733
19734 =back
19735
19736 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
19737 handles
19738
19739 =over 4
19740
19741 =item SYNOPSIS
19742
19743 =item DESCRIPTION
19744
19745 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
19746 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
19747
19748 =item SEE ALSO
19749
19750 =item AUTHOR
19751
19752 =item COPYRIGHT
19753
19754 =back
19755
19756 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
19757
19758 =over 4
19759
19760 =item SYNOPSIS
19761
19762 =item DESCRIPTION
19763
19764 =item CONSTRUCTOR
19765
19766 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
19767
19768 =item METHODS
19769
19770 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode(
19771 [LAYER] )
19772
19773 =item NOTE
19774
19775 =item SEE ALSO
19776
19777 =item HISTORY
19778
19779 =back
19780
19781 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
19782 handles
19783
19784 =over 4
19785
19786 =item SYNOPSIS
19787
19788 =item DESCRIPTION
19789
19790 =item CONSTRUCTOR
19791
19792 new (), new_from_fd ( FD, MODE )
19793
19794 =item METHODS
19795
19796 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
19797 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
19798 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
19799 $io->blocking ( [ BOOL ] ), $io->untaint
19800
19801 =item NOTE
19802
19803 =item SEE ALSO
19804
19805 =item BUGS
19806
19807 =item HISTORY
19808
19809 =back
19810
19811 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
19812
19813 =over 4
19814
19815 =item SYNOPSIS
19816
19817 =item DESCRIPTION
19818
19819 =item CONSTRUCTOR
19820
19821 new ( [READER, WRITER] )
19822
19823 =item METHODS
19824
19825 reader ([ARGS]), writer ([ARGS]), handles ()
19826
19827 =item SEE ALSO
19828
19829 =item AUTHOR
19830
19831 =item COPYRIGHT
19832
19833 =back
19834
19835 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
19836
19837 =over 4
19838
19839 =item SYNOPSIS
19840
19841 =item DESCRIPTION
19842
19843 =item METHODS
19844
19845 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
19846 IO ), handles( [ EVENT_MASK ] )
19847
19848 =item SEE ALSO
19849
19850 =item AUTHOR
19851
19852 =item COPYRIGHT
19853
19854 =back
19855
19856 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
19857 I/O objects
19858
19859 =over 4
19860
19861 =item SYNOPSIS
19862
19863 =item DESCRIPTION
19864
19865 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
19866 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
19867 $io->tell
19868
19869 =item SEE ALSO
19870
19871 =item HISTORY
19872
19873 =back
19874
19875 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
19876 call
19877
19878 =over 4
19879
19880 =item SYNOPSIS
19881
19882 =item DESCRIPTION
19883
19884 =item CONSTRUCTOR
19885
19886 new ( [ HANDLES ] )
19887
19888 =item METHODS
19889
19890 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
19891 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
19892 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
19893
19894 =item EXAMPLE
19895
19896 =item AUTHOR
19897
19898 =item COPYRIGHT
19899
19900 =back
19901
19902 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
19903 communications
19904
19905 =over 4
19906
19907 =item SYNOPSIS
19908
19909 =item DESCRIPTION
19910
19911 =item CONSTRUCTOR
19912
19913 new ( [ARGS] )
19914
19915 =item METHODS
19916
19917 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
19918 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
19919
19920 =item SEE ALSO
19921
19922 =item AUTHOR
19923
19924 =item COPYRIGHT
19925
19926 =back
19927
19928 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
19929 AF_INET domain sockets
19930
19931 =over 4
19932
19933 =item SYNOPSIS
19934
19935 =item DESCRIPTION
19936
19937 =item CONSTRUCTOR
19938
19939 new ( [ARGS] )
19940
19941 =over 4
19942
19943 =item METHODS
19944
19945 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
19946 ()
19947
19948 =back
19949
19950 =item SEE ALSO
19951
19952 =item AUTHOR
19953
19954 =item COPYRIGHT
19955
19956 =back
19957
19958 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
19959 AF_UNIX domain sockets
19960
19961 =over 4
19962
19963 =item SYNOPSIS
19964
19965 =item DESCRIPTION
19966
19967 =item CONSTRUCTOR
19968
19969 new ( [ARGS] )
19970
19971 =item METHODS
19972
19973 hostpath(), peerpath()
19974
19975 =item SEE ALSO
19976
19977 =item AUTHOR
19978
19979 =item COPYRIGHT
19980
19981 =back
19982
19983 =head2 IPC::Msg - SysV Msg IPC object class
19984
19985 =over 4
19986
19987 =item SYNOPSIS
19988
19989 =item DESCRIPTION
19990
19991 =item METHODS
19992
19993 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
19994 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
19995 FLAGS ] ), stat
19996
19997 =item SEE ALSO
19998
19999 =item AUTHOR
20000
20001 =item COPYRIGHT
20002
20003 =back
20004
20005 =head2 IPC::Open2, open2 - open a process for both reading and writing
20006
20007 =over 4
20008
20009 =item SYNOPSIS
20010
20011 =item DESCRIPTION
20012
20013 =item WARNING 
20014
20015 =item SEE ALSO
20016
20017 =back
20018
20019 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
20020 handling
20021
20022 =over 4
20023
20024 =item SYNOPSIS
20025
20026 =item DESCRIPTION
20027
20028 =item WARNING
20029
20030 =back
20031
20032 =head2 IPC::Semaphore - SysV Semaphore IPC object class
20033
20034 =over 4
20035
20036 =item SYNOPSIS
20037
20038 =item DESCRIPTION
20039
20040 =item METHODS
20041
20042 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
20043 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
20044 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
20045 , VALUE ), stat
20046
20047 =item SEE ALSO
20048
20049 =item AUTHOR
20050
20051 =item COPYRIGHT
20052
20053 =back
20054
20055 =head2 IPC::SysV - SysV IPC constants
20056
20057 =over 4
20058
20059 =item SYNOPSIS
20060
20061 =item DESCRIPTION
20062
20063 ftok( PATH, ID )
20064
20065 =item SEE ALSO
20066
20067 =item AUTHORS
20068
20069 =item COPYRIGHT
20070
20071 =back
20072
20073 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
20074
20075 =over 4
20076
20077 =item SYNOPSIS
20078
20079 =item DESCRIPTION
20080
20081 =item METHODS
20082
20083 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
20084 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
20085 FLAGS ] ), stat
20086
20087 =item SEE ALSO
20088
20089 =item AUTHOR
20090
20091 =item COPYRIGHT
20092
20093 =back
20094
20095 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
20096 class
20097
20098 =over 4
20099
20100 =item SYNOPSIS
20101
20102 =item DESCRIPTION
20103
20104 =item METHODS
20105
20106 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
20107 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
20108 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
20109 , VALUE ), stat
20110
20111 =item SEE ALSO
20112
20113 =item AUTHOR
20114
20115 =item COPYRIGHT
20116
20117 =back
20118
20119 =head2 List::Util - A selection of general-utility list subroutines
20120
20121 =over 4
20122
20123 =item SYNOPSIS
20124
20125 =item DESCRIPTION
20126
20127 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
20128 BLOCK LIST, shuffle LIST, sum LIST
20129
20130 =item KNOWN BUGS
20131
20132 =item SUGGESTED ADDITIONS
20133
20134 =item COPYRIGHT
20135
20136 =back
20137
20138 =head2 List::Utilib::List::Util, List::Util - A selection of
20139 general-utility list subroutines
20140
20141 =over 4
20142
20143 =item SYNOPSIS
20144
20145 =item DESCRIPTION
20146
20147 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
20148 BLOCK LIST, shuffle LIST, sum LIST
20149
20150 =item KNOWN BUGS
20151
20152 =item SUGGESTED ADDITIONS
20153
20154 =item COPYRIGHT
20155
20156 =back
20157
20158 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
20159 general-utility scalar subroutines
20160
20161 =over 4
20162
20163 =item SYNOPSIS
20164
20165 =item DESCRIPTION
20166
20167 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
20168 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
20169 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
20170
20171 =item KNOWN BUGS
20172
20173 =item COPYRIGHT
20174
20175 =item BLATANT PLUG
20176
20177 =back
20178
20179 =head2 Locale::Constants - constants for Locale codes
20180
20181 =over 4
20182
20183 =item SYNOPSIS
20184
20185 =item DESCRIPTION
20186
20187 =item KNOWN BUGS AND LIMITATIONS
20188
20189 =item SEE ALSO
20190
20191 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
20192
20193 =item AUTHOR
20194
20195 =item COPYRIGHT
20196
20197 =back
20198
20199 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
20200
20201 =over 4
20202
20203 =item SYNOPSIS
20204
20205 =item DESCRIPTION
20206
20207 B<alpha-2>, B<alpha-3>, B<numeric>
20208
20209 =item CONVERSION ROUTINES
20210
20211 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
20212 country_code2code( CODE, CODESET, CODESET )
20213
20214 =item QUERY ROUTINES
20215
20216 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
20217
20218 =item SEMI-PRIVATE ROUTINES
20219
20220 =over 4
20221
20222 =item alias_code
20223
20224 =item rename_country
20225
20226 =back
20227
20228 =item EXAMPLES
20229
20230 =item DOMAIN NAMES
20231
20232 =item KNOWN BUGS AND LIMITATIONS
20233
20234 =item SEE ALSO
20235
20236 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
20237 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
20238 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
20239 http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
20240
20241 =item AUTHOR
20242
20243 =item COPYRIGHT
20244
20245 =back
20246
20247 =head2 Locale::Currency - ISO three letter codes for currency
20248 identification (ISO 4217)
20249
20250 =over 4
20251
20252 =item SYNOPSIS
20253
20254 =item DESCRIPTION
20255
20256 XTS, XXX
20257
20258 =item CONVERSION ROUTINES
20259
20260 code2currency(), currency2code()
20261
20262 =item QUERY ROUTINES
20263
20264 C<all_currency_codes()>, C<all_currency_names()>
20265
20266 =item EXAMPLES
20267
20268 =item KNOWN BUGS AND LIMITATIONS
20269
20270 =item SEE ALSO
20271
20272 Locale::Country, Locale::Script, ISO 4217:1995,
20273 http://www.bsi-global.com/iso4217currency
20274
20275 =item AUTHOR
20276
20277 =item COPYRIGHT
20278
20279 =back
20280
20281 =head2 Locale::Language - ISO two letter codes for language identification
20282 (ISO 639)
20283
20284 =over 4
20285
20286 =item SYNOPSIS
20287
20288 =item DESCRIPTION
20289
20290 =item CONVERSION ROUTINES
20291
20292 code2language(), language2code()
20293
20294 =item QUERY ROUTINES
20295
20296 C<all_language_codes()>, C<all_language_names()>
20297
20298 =item EXAMPLES
20299
20300 =item KNOWN BUGS AND LIMITATIONS
20301
20302 =item SEE ALSO
20303
20304 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
20305 http://lcweb.loc.gov/standards/iso639-2/langhome.html
20306
20307 =item AUTHOR
20308
20309 =item COPYRIGHT
20310
20311 =back
20312
20313 =head2 Locale::Maketext - framework for localization
20314
20315 =over 4
20316
20317 =item SYNOPSIS
20318
20319 =item DESCRIPTION
20320
20321 =item QUICK OVERVIEW
20322
20323 =item METHODS
20324
20325 =over 4
20326
20327 =item Construction Methods
20328
20329 =item The "maketext" Method
20330
20331 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
20332
20333 =item Utility Methods
20334
20335 $language->quant($number, $singular), $language->quant($number, $singular,
20336 $plural), $language->quant($number, $singular, $plural, $negative),
20337 $language->numf($number), $language->sprintf($format, @items),
20338 $language->language_tag(), $language->encoding()
20339
20340 =item Language Handle Attributes and Internals
20341
20342 =back
20343
20344 =item LANGUAGE CLASS HIERARCHIES
20345
20346 =item ENTRIES IN EACH LEXICON
20347
20348 =item BRACKET NOTATION
20349
20350 =item AUTO LEXICONS
20351
20352 =item CONTROLLING LOOKUP FAILURE
20353
20354 =item HOW TO USE MAKETEXT
20355
20356 =item SEE ALSO
20357
20358 =item COPYRIGHT AND DISCLAIMER
20359
20360 =item AUTHOR
20361
20362 =back
20363
20364 =head2 Locale::Maketext::TPJ13 -- article about software localization
20365
20366 =over 4
20367
20368 =item SYNOPSIS
20369
20370 =item DESCRIPTION
20371
20372 =item Localization and Perl: gettext breaks, Maketext fixes
20373
20374 =over 4
20375
20376 =item A Localization Horror Story: It Could Happen To You
20377
20378 =item The Linguistic View
20379
20380 =item Breaking gettext
20381
20382 =item Replacing gettext
20383
20384 =item Buzzwords: Abstraction and Encapsulation
20385
20386 =item Buzzword: Isomorphism
20387
20388 =item Buzzword: Inheritance
20389
20390 =item Buzzword: Concision
20391
20392 =item The Devil in the Details
20393
20394 =item The Proof in the Pudding: Localizing Web Sites
20395
20396 =item References
20397
20398 =back
20399
20400 =back
20401
20402 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
20403
20404 =over 4
20405
20406 =item SYNOPSIS
20407
20408 =item DESCRIPTION
20409
20410 B<alpha-2>, B<alpha-3>, B<numeric>
20411
20412 =over 4
20413
20414 =item SPECIAL CODES
20415
20416 =back
20417
20418 =item CONVERSION ROUTINES
20419
20420 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
20421 script_code2code( CODE, CODESET, CODESET )
20422
20423 =item QUERY ROUTINES
20424
20425 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
20426
20427 =item EXAMPLES
20428
20429 =item KNOWN BUGS AND LIMITATIONS
20430
20431 =item SEE ALSO
20432
20433 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
20434 http://www.evertype.com/standards/iso15924/
20435
20436 =item AUTHOR
20437
20438 =item COPYRIGHT
20439
20440 =back
20441
20442 =head2 MIME::Base64 - Encoding and decoding of base64 strings
20443
20444 =over 4
20445
20446 =item SYNOPSIS
20447
20448 =item DESCRIPTION
20449
20450 encode_base64($str), encode_base64($str, $eol);, decode_base64($str)
20451
20452 =item DIAGNOSTICS
20453
20454 Premature end of base64 data, Premature padding of base64 data, Wide
20455 character in subroutine entry
20456
20457 =item EXAMPLES
20458
20459 =item COPYRIGHT
20460
20461 =item SEE ALSO
20462
20463 =back
20464
20465 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
20466 of quoted-printable strings
20467
20468 =over 4
20469
20470 =item SYNOPSIS
20471
20472 =item DESCRIPTION
20473
20474 encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode),
20475 decode_qp($str);
20476
20477 =item COPYRIGHT
20478
20479 =item SEE ALSO
20480
20481 =back
20482
20483 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
20484 strings
20485
20486 =over 4
20487
20488 =item SYNOPSIS
20489
20490 =item DESCRIPTION
20491
20492 encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode),
20493 decode_qp($str);
20494
20495 =item COPYRIGHT
20496
20497 =item SEE ALSO
20498
20499 =back
20500
20501 =head2 Math::BigFloat - Arbitrary size floating point math package
20502
20503 =over 4
20504
20505 =item SYNOPSIS
20506
20507 =item DESCRIPTION
20508
20509 =over 4
20510
20511 =item Canonical notation
20512
20513 =item Output
20514
20515 =item C<mantissa()>, C<exponent()> and C<parts()>
20516
20517 =item Accuracy vs. Precision
20518
20519 =item Rounding
20520
20521 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
20522 ), fround  ( -$scale ) and fround ( 0 )
20523
20524 =back
20525
20526 =item METHODS
20527
20528 =over 4
20529
20530 =item accuracy
20531
20532 =item precision()
20533
20534 =back
20535
20536 =item Autocreating constants
20537
20538 =over 4
20539
20540 =item Math library
20541
20542 =item Using Math::BigInt::Lite
20543
20544 =back
20545
20546 =item BUGS
20547
20548 =item CAVEATS
20549
20550 stringify, bstr(), bdiv, Modifying and =, bpow, precision() vs. accuracy()
20551
20552 =item SEE ALSO
20553
20554 =item LICENSE
20555
20556 =item AUTHORS
20557
20558 =back
20559
20560 =head2 Math::BigInt - Arbitrary size integer/float math package
20561
20562 =over 4
20563
20564 =item SYNOPSIS
20565
20566 =item DESCRIPTION
20567
20568 Input, Output
20569
20570 =item METHODS
20571
20572 =over 4
20573
20574 =item config
20575
20576 =item accuracy
20577
20578 =item precision
20579
20580 =item brsft
20581
20582 =item new
20583
20584 =item bnan
20585
20586 =item bzero
20587
20588 =item binf
20589
20590 =item bone
20591
20592 =item is_one()/is_zero()/is_nan()/is_inf()
20593
20594 =item is_pos()/is_neg()
20595
20596         $x->is_pos();                   # true if > 0
20597         $x->is_neg();                   # true if < 0
20598
20599 =item is_odd()/is_even()/is_int()
20600
20601 =item bcmp
20602
20603 =item bacmp
20604
20605 =item sign
20606
20607 =item digit
20608
20609 =item bneg
20610
20611 =item babs
20612
20613 =item bnorm
20614
20615 =item bnot
20616
20617 =item binc
20618
20619 =item bdec
20620
20621 =item badd
20622
20623 =item bsub
20624
20625 =item bmul
20626
20627 =item bdiv
20628
20629 =item bmod
20630
20631 =item bmodinv
20632
20633 =item bmodpow
20634
20635 =item bpow
20636
20637 =item blsft
20638
20639 =item brsft
20640
20641 =item band
20642
20643 =item bior
20644
20645 =item bxor
20646
20647 =item bnot
20648
20649 =item bsqrt
20650
20651 =item bfac
20652
20653 =item round
20654
20655 =item bround
20656
20657 =item bfround
20658
20659 =item bfloor
20660
20661 =item bceil
20662
20663 =item bgcd
20664
20665 =item blcm
20666
20667 =item exponent
20668
20669 =item mantissa
20670
20671 =item parts
20672
20673 =item copy
20674
20675 =item as_int
20676
20677 =item bsstr
20678
20679 =item as_hex
20680
20681 =item as_bin
20682
20683 =back
20684
20685 =item ACCURACY and PRECISION
20686
20687 =over 4
20688
20689 =item Precision P
20690
20691 =item Accuracy A
20692
20693 =item Fallback F
20694
20695 =item Rounding mode R
20696
20697 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
20698 (significant digits), Setting/Accessing, Creating numbers, Usage,
20699 Precedence, Overriding globals, Local settings, Rounding, Default values,
20700 Remarks
20701
20702 =back
20703
20704 =item Infinity and Not a Number
20705
20706 oct()/hex(), log(-inf), exp(), cos(), sin(), atan2()
20707
20708 =item INTERNALS
20709
20710 =over 4
20711
20712 =item MATH LIBRARY
20713
20714 =item SIGN
20715
20716 =item mantissa(), exponent() and parts()
20717
20718 =back
20719
20720 =item EXAMPLES
20721
20722   use Math::BigInt;
20723
20724 =item Autocreating constants
20725
20726 =item PERFORMANCE
20727
20728 =over 4
20729
20730 =item Alternative math libraries
20731
20732 =item SUBCLASSING
20733
20734 =back
20735
20736 =item Subclassing Math::BigInt
20737
20738 =item UPGRADING
20739
20740 =over 4
20741
20742 =item Auto-upgrade
20743
20744 bsqrt(), div(), blog()
20745
20746 =back
20747
20748 =item BUGS
20749
20750 broot() does not work, Out of Memory!, Fails to load Calc on Perl prior
20751 5.6.0
20752
20753 =item CAVEATS
20754
20755 bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling,
20756 Modifying and =, bpow, Overloading -$x, Mixing different object types,
20757 bsqrt(), brsft()
20758
20759 =item LICENSE
20760
20761 =item SEE ALSO
20762
20763 =item AUTHORS
20764
20765 =back
20766
20767 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
20768
20769 =over 4
20770
20771 =item SYNOPSIS
20772
20773 =item DESCRIPTION
20774
20775 =item STORAGE
20776
20777 =item METHODS
20778
20779 =item WRAP YOUR OWN
20780
20781 =item LICENSE
20782
20783 This program is free software; you may redistribute it and/or modify it
20784 under
20785 the same terms as Perl itself. 
20786
20787 =item AUTHORS
20788
20789 =item SEE ALSO
20790
20791 =back
20792
20793 =head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code
20794
20795 =over 4
20796
20797 =item SYNOPSIS
20798
20799 =item DESCRIPTION
20800
20801 =item METHODS
20802
20803 =over 4
20804
20805 =item __emu_bxor
20806
20807 =item __emu_band
20808
20809 =item __emu_bior
20810
20811 =back
20812
20813 =item LICENSE
20814
20815 This program is free software; you may redistribute it and/or modify it
20816 under
20817 the same terms as Perl itself. 
20818
20819 =item AUTHORS
20820
20821 =item SEE ALSO
20822
20823 =back
20824
20825 =head2 Math::BigInt::FastCalc - Math::BigInt::Calc with some XS for more
20826 speed
20827
20828 =over 4
20829
20830 =item SYNOPSIS
20831
20832 =item DESCRIPTION
20833
20834 =item STORAGE
20835
20836 =item METHODS
20837
20838 =item LICENSE
20839
20840 This program is free software; you may redistribute it and/or modify it
20841 under
20842 the same terms as Perl itself. 
20843
20844 =item AUTHORS
20845
20846 =item SEE ALSO
20847
20848 =back
20849
20850 =head2 Math::BigRat - Arbitrary big rational numbers
20851
20852 =over 4
20853
20854 =item SYNOPSIS
20855
20856 =item DESCRIPTION
20857
20858 =over 4
20859
20860 =item MATH LIBRARY
20861
20862 =back
20863
20864 =item METHODS
20865
20866 =over 4
20867
20868 =item new()
20869
20870 =item numerator()
20871
20872 =item denominator()
20873
20874         $d = $x->denominator();
20875
20876 =item parts()
20877
20878 =item as_int()
20879
20880 =item as_hex()
20881
20882 =item as_bin()
20883
20884 =item bfac()
20885
20886 =item blog()
20887
20888 =item bround()/round()/bfround()
20889
20890 =item bmod()
20891
20892 =item is_one()
20893
20894 =item is_zero()
20895
20896 =item is_pos()
20897
20898 =item is_neg()
20899
20900 =item is_int()
20901
20902 =item is_odd()
20903
20904 =item is_even()
20905
20906 =item bceil()
20907
20908 =item bfloor()
20909
20910         $x->bfloor();
20911
20912 =item bsqrt()
20913
20914         $x->bsqrt();
20915
20916 =item config
20917
20918 =back
20919
20920 =item BUGS
20921
20922 inf handling (partial), NaN handling (partial), rounding (not implemented
20923 except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(),
20924 blog(), bmodinv() and bmodpow() (partial)
20925
20926 =item LICENSE
20927
20928 =item SEE ALSO
20929
20930 =item AUTHORS
20931
20932 =back
20933
20934 =head2 Math::Complex - complex numbers and associated mathematical
20935 functions
20936
20937 =over 4
20938
20939 =item SYNOPSIS
20940
20941 =item DESCRIPTION
20942
20943 =item OPERATIONS
20944
20945 =item CREATION
20946
20947 =item DISPLAYING
20948
20949 =over 4
20950
20951 =item CHANGED IN PERL 5.6
20952
20953 =back
20954
20955 =item USAGE
20956
20957 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
20958
20959 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
20960
20961 =item BUGS
20962
20963 =item AUTHORS
20964
20965 =back
20966
20967 =head2 Math::Trig - trigonometric functions
20968
20969 =over 4
20970
20971 =item SYNOPSIS
20972
20973 =item DESCRIPTION
20974
20975 =item TRIGONOMETRIC FUNCTIONS
20976
20977 B<tan>
20978
20979 =over 4
20980
20981 =item ERRORS DUE TO DIVISION BY ZERO
20982
20983 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
20984
20985 =back
20986
20987 =item PLANE ANGLE CONVERSIONS
20988
20989 =item RADIAL COORDINATE CONVERSIONS
20990
20991 =over 4
20992
20993 =item COORDINATE SYSTEMS
20994
20995 =item 3-D ANGLE CONVERSIONS
20996
20997 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
20998 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
20999
21000 =back
21001
21002 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
21003
21004 =item EXAMPLES
21005
21006 =over 4
21007
21008 =item CAVEAT FOR GREAT CIRCLE FORMULAS
21009
21010 =back
21011
21012 =item BUGS
21013
21014 =item AUTHORS
21015
21016 =back
21017
21018 =head2 Memoize - Make functions faster by trading space for time
21019
21020 =over 4
21021
21022 =item SYNOPSIS
21023
21024 =item DESCRIPTION
21025
21026 =item DETAILS
21027
21028 =item OPTIONS
21029
21030 =over 4
21031
21032 =item INSTALL
21033
21034 =item NORMALIZER
21035
21036 =item C<SCALAR_CACHE>, C<LIST_CACHE>
21037
21038 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
21039
21040 =back
21041
21042 =item OTHER FACILITIES
21043
21044 =over 4
21045
21046 =item C<unmemoize>
21047
21048 =item C<flush_cache>
21049
21050 =back
21051
21052 =item CAVEATS
21053
21054 =item PERSISTENT CACHE SUPPORT
21055
21056 =item EXPIRATION SUPPORT
21057
21058 =item BUGS
21059
21060 =item MAILING LIST
21061
21062 =item AUTHOR
21063
21064 =item COPYRIGHT AND LICENSE
21065
21066 =item THANK YOU
21067
21068 =back
21069
21070 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
21071 Storable use
21072
21073 =over 4
21074
21075 =item DESCRIPTION
21076
21077 =back
21078
21079 =head2 Memoize::Expire - Plug-in module for automatic expiration of
21080 memoized values
21081
21082 =over 4
21083
21084 =item SYNOPSIS
21085
21086 =item DESCRIPTION
21087
21088 =item INTERFACE
21089
21090  TIEHASH,  EXISTS,  STORE
21091
21092 =item ALTERNATIVES
21093
21094 =item CAVEATS
21095
21096 =item AUTHOR
21097
21098 =item SEE ALSO
21099
21100 =back
21101
21102 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
21103
21104 =over 4
21105
21106 =item DESCRIPTION
21107
21108 =back
21109
21110 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
21111
21112 =over 4
21113
21114 =item DESCRIPTION
21115
21116 =back
21117
21118 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
21119 Storable use
21120
21121 =over 4
21122
21123 =item DESCRIPTION
21124
21125 =back
21126
21127 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
21128 Storable use
21129
21130 =over 4
21131
21132 =item DESCRIPTION
21133
21134 =back
21135
21136 =head2 Memoize::Storable - store Memoized data in Storable database
21137
21138 =over 4
21139
21140 =item DESCRIPTION
21141
21142 =back
21143
21144 =head2 Module::CoreList - what modules shipped with versions of perl
21145
21146 =over 4
21147
21148 =item SYNOPSIS
21149
21150 =item DESCRIPTION
21151
21152 =item CAVEATS
21153
21154 =item HISTORY
21155
21156 =item AUTHOR
21157
21158 =item COPYRIGHT
21159
21160 =item SEE ALSO
21161
21162 =back
21163
21164 =head2 NDBM_File - Tied access to ndbm files
21165
21166 =over 4
21167
21168 =item SYNOPSIS
21169
21170 =item DESCRIPTION
21171
21172 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
21173
21174 =item DIAGNOSTICS
21175
21176 =over 4
21177
21178 =item C<ndbm store returned -1, errno 22, key "..." at ...>
21179
21180 =back
21181
21182 =item BUGS AND WARNINGS
21183
21184 =back
21185
21186 =head2 NEXT - Provide a pseudo-class NEXT (et al) that allows method
21187 redispatch
21188
21189 =over 4
21190
21191 =item SYNOPSIS
21192
21193 =item DESCRIPTION
21194
21195 =over 4
21196
21197 =item Enforcing redispatch
21198
21199 =item Avoiding repetitions
21200
21201 =item Invoking all versions of a method with a single call
21202
21203 =item Using C<EVERY> methods
21204
21205 =back
21206
21207 =item AUTHOR
21208
21209 =item BUGS AND IRRITATIONS
21210
21211 =item COPYRIGHT
21212
21213 =back
21214
21215 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
21216
21217 =over 4
21218
21219 =item SYNOPSIS
21220
21221 =item DESCRIPTION
21222
21223 =item USER METHODS
21224
21225 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
21226 dataend ()
21227
21228 =item CLASS METHODS
21229
21230 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
21231 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
21232 ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh ()
21233
21234 =item EXPORTS
21235
21236 =item AUTHOR
21237
21238 =item COPYRIGHT
21239
21240 =back
21241
21242 =head2 Net::Config - Local configuration data for libnet
21243
21244 =over 4
21245
21246 =item SYNOPSYS
21247
21248 =item DESCRIPTION
21249
21250 =item METHODS
21251
21252 requires_firewall HOST
21253
21254 =item NetConfig VALUES
21255
21256 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
21257 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
21258 ftp_int_passive, local_netmask, test_hosts, test_exists
21259
21260 =back
21261
21262 =head2 Net::Domain - Attempt to evaluate the current host's internet name
21263 and domain
21264
21265 =over 4
21266
21267 =item SYNOPSIS
21268
21269 =item DESCRIPTION
21270
21271 hostfqdn (), domainname (), hostname (), hostdomain ()
21272
21273 =item AUTHOR
21274
21275 =item COPYRIGHT
21276
21277 =back
21278
21279 =head2 Net::FTP - FTP Client class
21280
21281 =over 4
21282
21283 =item SYNOPSIS
21284
21285 =item DESCRIPTION
21286
21287 =item OVERVIEW
21288
21289 =item CONSTRUCTOR
21290
21291 new ([ HOST ] [, OPTIONS ])
21292
21293 =item METHODS
21294
21295 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
21296 site (ARGS), ascii, binary, rename ( OLDNAME, NEWNAME ), delete ( FILENAME
21297 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR [,
21298 RECURSE ]), mkdir ( DIR [, RECURSE ]), alloc ( SIZE [, RECORD_SIZE] ), ls (
21299 [ DIR ] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ),
21300 put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE
21301 ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ),
21302 size ( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[
21303 BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ DIR ] ), retr ( FILE ),
21304 stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [ PORT ] ), pasv (),
21305 pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_xfer_unique (
21306 SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( NON_PASV_SERVER ),
21307 abort (), quit ()
21308
21309 =over 4
21310
21311 =item Methods for the adventurous
21312
21313 quot (CMD [,ARGS])
21314
21315 =back
21316
21317 =item THE dataconn CLASS
21318
21319 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
21320 bytes_read (), abort (), close ()
21321
21322 =item UNIMPLEMENTED
21323
21324 B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
21325
21326 =item REPORTING BUGS
21327
21328 =item AUTHOR
21329
21330 =item SEE ALSO
21331
21332 =item USE EXAMPLES
21333
21334 http://www.csh.rit.edu/~adam/Progs/
21335
21336 =item CREDITS
21337
21338 =item COPYRIGHT
21339
21340 =back
21341
21342 =head2 Net::NNTP - NNTP Client class
21343
21344 =over 4
21345
21346 =item SYNOPSIS
21347
21348 =item DESCRIPTION
21349
21350 =item CONSTRUCTOR
21351
21352 new ( [ HOST ] [, OPTIONS ])
21353
21354 =item METHODS
21355
21356 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
21357 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
21358 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
21359 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
21360 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
21361 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
21362 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
21363
21364 =over 4
21365
21366 =item Extension methods
21367
21368 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
21369 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
21370 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
21371 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
21372 GROUP ] ), reader
21373
21374 =back
21375
21376 =item UNSUPPORTED
21377
21378 =item DEFINITIONS
21379
21380 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
21381
21382 =item SEE ALSO
21383
21384 =item AUTHOR
21385
21386 =item COPYRIGHT
21387
21388 =back
21389
21390 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
21391
21392 =over 4
21393
21394 =item SYNOPSIS
21395
21396 =item DESCRIPTION
21397
21398 =item CONSTRUCTOR
21399
21400 new ( [ HOST ] [, OPTIONS ] 0
21401
21402 =item METHODS
21403
21404 auth ( USERNAME, PASSWORD ), user ( USER ), pass ( PASS ), login ( [ USER
21405 [, PASS ]] ), apop ( [ USER [, PASS ]] ), banner (), capa (),  capabilities
21406 (), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [, FH ]
21407 ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ]
21408 ), delete ( MSGNUM ), reset (), quit ()
21409
21410 =item NOTES
21411
21412 =item SEE ALSO
21413
21414 =item AUTHOR
21415
21416 =item COPYRIGHT
21417
21418 =back
21419
21420 =head2 Net::Ping - check a remote host for reachability
21421
21422 =over 4
21423
21424 =item SYNOPSIS
21425
21426 =item DESCRIPTION
21427
21428 =over 4
21429
21430 =item Functions
21431
21432 Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos
21433 ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
21434 $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
21435 $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
21436 [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host
21437 [, $timeout]);
21438
21439 =back
21440
21441 =item NOTES
21442
21443 =item INSTALL
21444
21445 =item BUGS
21446
21447 =item AUTHORS
21448
21449 =item COPYRIGHT
21450
21451 =back
21452
21453 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
21454
21455 =over 4
21456
21457 =item SYNOPSIS
21458
21459 =item DESCRIPTION
21460
21461 =item EXAMPLES
21462
21463 =item CONSTRUCTOR
21464
21465 new ( [ HOST ] [, OPTIONS ] )
21466
21467 =item METHODS
21468
21469 banner (), domain (), hello ( DOMAIN ), host (), etrn ( DOMAIN ), auth (
21470 USERNAME, PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ),
21471 send_or_mail ( ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient (
21472 ADDRESS [, ADDRESS, [...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]]
21473 ), cc ( ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ),
21474 data ( [ DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [
21475 $subject ] ), quit ()
21476
21477 =item ADDRESSES
21478
21479 =item SEE ALSO
21480
21481 =item AUTHOR
21482
21483 =item COPYRIGHT
21484
21485 =back
21486
21487 =head2 Net::Time - time and daytime network client interface
21488
21489 =over 4
21490
21491 =item SYNOPSIS
21492
21493 =item DESCRIPTION
21494
21495 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
21496 PROTOCOL [, TIMEOUT]]])
21497
21498 =item AUTHOR
21499
21500 =item COPYRIGHT
21501
21502 =back
21503
21504 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
21505 functions
21506
21507 =over 4
21508
21509 =item SYNOPSIS
21510
21511 =item DESCRIPTION
21512
21513 =item EXAMPLES
21514
21515 =item NOTE
21516
21517 =item AUTHOR
21518
21519 =back
21520
21521 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
21522
21523 =over 4
21524
21525 =item DESCRIPTION
21526
21527 =over 4
21528
21529 =item Where to get this document
21530
21531 =item How to contribute to this document
21532
21533 =back
21534
21535 =item Author and Copyright Information
21536
21537 =over 4
21538
21539 =item Disclaimer
21540
21541 =back
21542
21543 =item Obtaining and installing libnet
21544
21545 =over 4
21546
21547 =item What is libnet ?
21548
21549 =item Which version of perl do I need ?
21550
21551 =item What other modules do I need ?
21552
21553 =item What machines support libnet ?
21554
21555 =item Where can I get the latest libnet release
21556
21557 =back
21558
21559 =item Using Net::FTP
21560
21561 =over 4
21562
21563 =item How do I download files from an FTP server ?
21564
21565 =item How do I transfer files in binary mode ?
21566
21567 =item How can I get the size of a file on a remote FTP server ?
21568
21569 =item How can I get the modification time of a file on a remote FTP server
21570 ?
21571
21572 =item How can I change the permissions of a file on a remote server ?
21573
21574 =item Can I do a reget operation like the ftp command ?
21575
21576 =item How do I get a directory listing from an FTP server ?
21577
21578 =item Changing directory to "" does not fail ?
21579
21580 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
21581
21582 =item I am behind an FTP proxy firewall, but cannot access machines outside
21583 ?
21584
21585 =item My ftp proxy firewall does not listen on port 21
21586
21587 =item Is it possible to change the file permissions of a file on an FTP
21588 server ?
21589
21590 =item I have seen scripts call a method message, but cannot find it
21591 documented ?
21592
21593 =item Why does Net::FTP not implement mput and mget methods
21594
21595 =back
21596
21597 =item Using Net::SMTP
21598
21599 =over 4
21600
21601 =item Why can't the part of an Email address after the @ be used as the
21602 hostname ?
21603
21604 =item Why does Net::SMTP not do DNS MX lookups ?
21605
21606 =item The verify method always returns true ?
21607
21608 =back
21609
21610 =item Debugging scripts
21611
21612 =over 4
21613
21614 =item How can I debug my scripts that use Net::* modules ?
21615
21616 =back
21617
21618 =item AUTHOR AND COPYRIGHT
21619
21620 =back
21621
21622 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
21623 functions
21624
21625 =over 4
21626
21627 =item SYNOPSIS
21628
21629 =item DESCRIPTION
21630
21631 =item EXAMPLES
21632
21633 =item NOTE
21634
21635 =item AUTHOR
21636
21637 =back
21638
21639 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
21640 functions
21641
21642 =over 4
21643
21644 =item SYNOPSIS
21645
21646 =item DESCRIPTION
21647
21648 =item NOTE
21649
21650 =item AUTHOR
21651
21652 =back
21653
21654 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
21655 functions
21656
21657 =over 4
21658
21659 =item SYNOPSIS
21660
21661 =item DESCRIPTION
21662
21663 =item EXAMPLES
21664
21665 =item NOTE
21666
21667 =item AUTHOR
21668
21669 =back
21670
21671 =head2 Netrc, Net::Netrc - OO interface to users netrc file
21672
21673 =over 4
21674
21675 =item SYNOPSIS
21676
21677 =item DESCRIPTION
21678
21679 =item THE .netrc FILE
21680
21681 machine name, default, login name, password string, account string, macdef
21682 name
21683
21684 =item CONSTRUCTOR
21685
21686 lookup ( MACHINE [, LOGIN ])
21687
21688 =item METHODS
21689
21690 login (), password (), account (), lpa ()
21691
21692 =item AUTHOR
21693
21694 =item SEE ALSO
21695
21696 =item COPYRIGHT
21697
21698 =back
21699
21700 =head2 O - Generic interface to Perl Compiler backends
21701
21702 =over 4
21703
21704 =item SYNOPSIS
21705
21706 =item DESCRIPTION
21707
21708 =item CONVENTIONS
21709
21710 =item IMPLEMENTATION
21711
21712 =item BUGS
21713
21714 =item AUTHOR
21715
21716 =back
21717
21718 =head2 ODBM_File - Tied access to odbm files
21719
21720 =over 4
21721
21722 =item SYNOPSIS
21723
21724 =item DESCRIPTION
21725
21726 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
21727
21728 =item DIAGNOSTICS
21729
21730 =over 4
21731
21732 =item C<odbm store returned -1, errno 22, key "..." at ...>
21733
21734 =back
21735
21736 =item BUGS AND WARNINGS
21737
21738 =back
21739
21740 =head2 Opcode - Disable named opcodes when compiling perl code
21741
21742 =over 4
21743
21744 =item SYNOPSIS
21745
21746 =item DESCRIPTION
21747
21748 =item NOTE
21749
21750 =item WARNING
21751
21752 =item Operator Names and Operator Lists
21753
21754 an operator name (opname), an operator tag name (optag), a negated opname
21755 or optag, an operator set (opset)
21756
21757 =item Opcode Functions
21758
21759 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
21760 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
21761 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
21762 opdump (PAT)
21763
21764 =item Manipulating Opsets
21765
21766 =item TO DO (maybe)
21767
21768 =back
21769
21770 =over 4
21771
21772 =item Predefined Opcode Tags
21773
21774 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
21775 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
21776 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
21777 :dangerous
21778
21779 =item SEE ALSO
21780
21781 =item AUTHORS
21782
21783 =back
21784
21785 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
21786 compartments
21787
21788 =over 4
21789
21790 =item SYNOPSIS
21791
21792 =item DESCRIPTION
21793
21794 a new namespace, an operator mask
21795
21796 =item WARNING
21797
21798 =over 4
21799
21800 =item RECENT CHANGES
21801
21802 =item Methods in class Safe
21803
21804 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
21805 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
21806 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
21807 root (NAMESPACE), mask (MASK)
21808
21809 =item Some Safety Issues
21810
21811 Memory, CPU, Snooping, Signals, State Changes
21812
21813 =item AUTHOR
21814
21815 =back
21816
21817 =back
21818
21819 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
21820 compiling
21821
21822 =over 4
21823
21824 =item SYNOPSIS  
21825
21826 =item DESCRIPTION
21827
21828 =item SEE ALSO
21829
21830 =back
21831
21832 =head2 POSIX - Perl interface to IEEE Std 1003.1
21833
21834 =over 4
21835
21836 =item SYNOPSIS
21837
21838 =item DESCRIPTION
21839
21840 =item NOTE
21841
21842 =item CAVEATS
21843
21844 =item FUNCTIONS
21845
21846 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
21847 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
21848 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
21849 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
21850 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
21851 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
21852 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
21853 fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv,
21854 geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid,
21855 getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha,
21856 isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace,
21857 isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime,
21858 log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr,
21859 memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice,
21860 offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc,
21861 putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename,
21862 rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid,
21863 setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
21864 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
21865 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
21866 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
21867 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
21868 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
21869 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
21870 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
21871 wctomb, write
21872
21873 =item CLASSES
21874
21875 =over 4
21876
21877 =item POSIX::SigAction
21878
21879 new, handler, mask, flags, safe
21880
21881 =item POSIX::SigRt
21882
21883 %SIGRT, SIGRTMIN, SIGRTMAX
21884
21885 =item POSIX::SigSet
21886
21887 new, addset, delset, emptyset, fillset, ismember
21888
21889 =item POSIX::Termios
21890
21891 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
21892 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
21893 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
21894 field values, c_cflag field values, c_iflag field values, c_lflag field
21895 values, c_oflag field values
21896
21897 =back
21898
21899 =item PATHNAME CONSTANTS
21900
21901 Constants
21902
21903 =item POSIX CONSTANTS
21904
21905 Constants
21906
21907 =item SYSTEM CONFIGURATION
21908
21909 Constants
21910
21911 =item ERRNO
21912
21913 Constants
21914
21915 =item FCNTL
21916
21917 Constants
21918
21919 =item FLOAT
21920
21921 Constants
21922
21923 =item LIMITS
21924
21925 Constants
21926
21927 =item LOCALE
21928
21929 Constants
21930
21931 =item MATH
21932
21933 Constants
21934
21935 =item SIGNAL
21936
21937 Constants
21938
21939 =item STAT
21940
21941 Constants, Macros
21942
21943 =item STDLIB
21944
21945 Constants
21946
21947 =item STDIO
21948
21949 Constants
21950
21951 =item TIME
21952
21953 Constants
21954
21955 =item UNISTD
21956
21957 Constants
21958
21959 =item WAIT
21960
21961 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
21962 WTERMSIG, WIFSTOPPED, WSTOPSIG
21963
21964 =back
21965
21966 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
21967 name space
21968
21969 =over 4
21970
21971 =item SYNOPSIS
21972
21973 =item DESCRIPTION
21974
21975 :unix, :stdio, :perlio, :crlf, :mmap, :utf8, :bytes, :raw, :pop, :win32
21976
21977 =over 4
21978
21979 =item Custom Layers
21980
21981 :encoding, :via
21982
21983 =item Alternatives to raw
21984
21985 =item Defaults and how to override them
21986
21987 =item Querying the layers of filehandles
21988
21989 =back
21990
21991 =item AUTHOR
21992
21993 =item SEE ALSO
21994
21995 =back
21996
21997 =head2 PerlIO::encoding - encoding layer
21998
21999 =over 4
22000
22001 =item SYNOPSIS
22002
22003 =item DESCRIPTION
22004
22005 =item SEE ALSO
22006
22007 =back
22008
22009 =head2 PerlIO::scalar - in-memory IO, scalar IO
22010
22011 =over 4
22012
22013 =item SYNOPSIS
22014
22015 =item DESCRIPTION
22016
22017 =item IMPLEMENTATION NOTE
22018
22019 =back
22020
22021 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
22022
22023 =over 4
22024
22025 =item SYNOPSIS
22026
22027 =item DESCRIPTION
22028
22029 =item EXPECTED METHODS
22030
22031 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
22032 $obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]),
22033 $obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]),
22034 $obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh),
22035 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
22036 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
22037 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
22038 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
22039
22040 =item EXAMPLES
22041
22042 =over 4
22043
22044 =item Example - a Hexadecimal Handle
22045
22046 =back
22047
22048 =back
22049
22050 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
22051
22052 =over 4
22053
22054 =item SYNOPSIS
22055
22056 =item DESCRIPTION
22057
22058 =item REQUIRED MODULES
22059
22060 =item SEE ALSO
22061
22062 =item ACKNOWLEDGEMENTS
22063
22064 =item COPYRIGHT
22065
22066 =back
22067
22068 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
22069
22070 =over 4
22071
22072 =item SYNOPSIS
22073
22074 =item OPTIONS/ARGUMENTS
22075
22076 =over 4
22077
22078 =item podchecker()
22079
22080 B<-warnings> =E<gt> I<val>
22081
22082 =back
22083
22084 =item DESCRIPTION
22085
22086 =item DIAGNOSTICS
22087
22088 =over 4
22089
22090 =item Errors
22091
22092 empty =headn, =over on line I<N> without closing =back, =item without
22093 previous =over, =back without previous =over, No argument for =begin, =end
22094 without =begin, Nested =begin's, =for without formatter specification,
22095 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
22096 interior-sequence "I<SEQ>", nested commands
22097 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
22098 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
22099 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
22100 after =back
22101
22102 =item Warnings
22103
22104 multiple occurrence of link target I<name>, line containing nothing but
22105 whitespace in paragraph, file does not start with =head, previous =item has
22106 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
22107 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
22108 items in =over, No argument for =item, empty section in previous paragraph,
22109 Verbatim paragraph in NAME section, =headI<n> without preceding higher
22110 level
22111
22112 =item Hyperlinks
22113
22114 ignoring leading/trailing whitespace in link, (section) in '$page'
22115 deprecated, alternative text/node '%s' contains non-escaped | or /
22116
22117 =back
22118
22119 =item RETURN VALUE
22120
22121 =item EXAMPLES
22122
22123 =item INTERFACE
22124
22125 =back
22126
22127 C<Pod::Checker-E<gt>new( %options )>
22128
22129 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
22130 @args )>
22131
22132 C<$checker-E<gt>num_errors()>
22133
22134 C<$checker-E<gt>num_warnings()>
22135
22136 C<$checker-E<gt>name()>
22137
22138 C<$checker-E<gt>node()>
22139
22140 C<$checker-E<gt>idx()>
22141
22142 C<$checker-E<gt>hyperlink()>
22143
22144 =over 4
22145
22146 =item AUTHOR
22147
22148 =back
22149
22150 =head2 Pod::Escapes -- for resolving Pod EE<lt>...E<gt> sequences
22151
22152 =over 4
22153
22154 =item SYNOPSIS
22155
22156 =item DESCRIPTION
22157
22158 =item GOODIES
22159
22160 e2char($e_content), e2charnum($e_content), $Name2character{I<name>},
22161 $Name2character_number{I<name>}, $Latin1Code_to_fallback{I<integer>},
22162 $Latin1Char_to_fallback{I<character>}, $Code2USASCII{I<integer>}
22163
22164 =item CAVEATS
22165
22166 =item SEE ALSO
22167
22168 =item COPYRIGHT AND DISCLAIMERS
22169
22170 =item AUTHOR
22171
22172 =back
22173
22174 =head2 Pod::Find - find POD documents in directory trees
22175
22176 =over 4
22177
22178 =item SYNOPSIS
22179
22180 =item DESCRIPTION
22181
22182 =back
22183
22184 =over 4
22185
22186 =item C<pod_find( { %opts } , @directories )>
22187
22188 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
22189 1>
22190
22191 =back
22192
22193 =over 4
22194
22195 =item C<simplify_name( $str )>
22196
22197 =back
22198
22199 =over 4
22200
22201 =item C<pod_where( { %opts }, $pod )>
22202
22203 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
22204 1>
22205
22206 =back
22207
22208 =over 4
22209
22210 =item C<contains_pod( $file , $verbose )>
22211
22212 =back
22213
22214 =over 4
22215
22216 =item AUTHOR
22217
22218 =item SEE ALSO
22219
22220 =back
22221
22222 =head2 Pod::Html - module to convert pod files to HTML
22223
22224 =over 4
22225
22226 =item SYNOPSIS
22227
22228 =item DESCRIPTION
22229
22230 =item ARGUMENTS
22231
22232 backlink, cachedir, css, flush, header, help, hiddendirs, htmldir,
22233 htmlroot, index, infile, libpods, netscape, outfile, podpath, podroot,
22234 quiet, recurse, title, verbose
22235
22236 =item EXAMPLE
22237
22238 =item ENVIRONMENT
22239
22240 =item AUTHOR
22241
22242 =item SEE ALSO
22243
22244 =item COPYRIGHT
22245
22246 =back
22247
22248 =head2 Pod::InputObjects - objects representing POD input paragraphs,
22249 commands, etc.
22250
22251 =over 4
22252
22253 =item SYNOPSIS
22254
22255 =item REQUIRES
22256
22257 =item EXPORTS
22258
22259 =item DESCRIPTION
22260
22261 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
22262 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
22263
22264 =back
22265
22266 =over 4
22267
22268 =item B<Pod::InputSource>
22269
22270 =back
22271
22272 =over 4
22273
22274 =item B<new()>
22275
22276 =back
22277
22278 =over 4
22279
22280 =item B<name()>
22281
22282 =back
22283
22284 =over 4
22285
22286 =item B<handle()>
22287
22288 =back
22289
22290 =over 4
22291
22292 =item B<was_cutting()>
22293
22294 =back
22295
22296 =over 4
22297
22298 =item B<Pod::Paragraph>
22299
22300 =back
22301
22302 =over 4
22303
22304 =item Pod::Paragraph-E<gt>B<new()>
22305
22306 =back
22307
22308 =over 4
22309
22310 =item $pod_para-E<gt>B<cmd_name()>
22311
22312 =back
22313
22314 =over 4
22315
22316 =item $pod_para-E<gt>B<text()>
22317
22318 =back
22319
22320 =over 4
22321
22322 =item $pod_para-E<gt>B<raw_text()>
22323
22324 =back
22325
22326 =over 4
22327
22328 =item $pod_para-E<gt>B<cmd_prefix()>
22329
22330 =back
22331
22332 =over 4
22333
22334 =item $pod_para-E<gt>B<cmd_separator()>
22335
22336 =back
22337
22338 =over 4
22339
22340 =item $pod_para-E<gt>B<parse_tree()>
22341
22342 =back
22343
22344 =over 4
22345
22346 =item $pod_para-E<gt>B<file_line()>
22347
22348 =back
22349
22350 =over 4
22351
22352 =item B<Pod::InteriorSequence>
22353
22354 =back
22355
22356 =over 4
22357
22358 =item Pod::InteriorSequence-E<gt>B<new()>
22359
22360 =back
22361
22362 =over 4
22363
22364 =item $pod_seq-E<gt>B<cmd_name()>
22365
22366 =back
22367
22368 =over 4
22369
22370 =item $pod_seq-E<gt>B<prepend()>
22371
22372 =back
22373
22374 =over 4
22375
22376 =item $pod_seq-E<gt>B<append()>
22377
22378 =back
22379
22380 =over 4
22381
22382 =item $pod_seq-E<gt>B<nested()>
22383
22384 =back
22385
22386 =over 4
22387
22388 =item $pod_seq-E<gt>B<raw_text()>
22389
22390 =back
22391
22392 =over 4
22393
22394 =item $pod_seq-E<gt>B<left_delimiter()>
22395
22396 =back
22397
22398 =over 4
22399
22400 =item $pod_seq-E<gt>B<right_delimiter()>
22401
22402 =back
22403
22404 =over 4
22405
22406 =item $pod_seq-E<gt>B<parse_tree()>
22407
22408 =back
22409
22410 =over 4
22411
22412 =item $pod_seq-E<gt>B<file_line()>
22413
22414 =back
22415
22416 =over 4
22417
22418 =item Pod::InteriorSequence::B<DESTROY()>
22419
22420 =back
22421
22422 =over 4
22423
22424 =item B<Pod::ParseTree>
22425
22426 =back
22427
22428 =over 4
22429
22430 =item Pod::ParseTree-E<gt>B<new()>
22431
22432 =back
22433
22434 =over 4
22435
22436 =item $ptree-E<gt>B<top()>
22437
22438 =back
22439
22440 =over 4
22441
22442 =item $ptree-E<gt>B<children()>
22443
22444 =back
22445
22446 =over 4
22447
22448 =item $ptree-E<gt>B<prepend()>
22449
22450 =back
22451
22452 =over 4
22453
22454 =item $ptree-E<gt>B<append()>
22455
22456 =back
22457
22458 =over 4
22459
22460 =item $ptree-E<gt>B<raw_text()>
22461
22462 =back
22463
22464 =over 4
22465
22466 =item Pod::ParseTree::B<DESTROY()>
22467
22468 =back
22469
22470 =over 4
22471
22472 =item SEE ALSO
22473
22474 =item AUTHOR
22475
22476 =back
22477
22478 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
22479
22480 =over 4
22481
22482 =item SYNOPSIS
22483
22484 =item DESCRIPTION
22485
22486 =back
22487
22488 =over 4
22489
22490 =item OBJECT METHODS
22491
22492 C<initialize>
22493
22494 =back
22495
22496 =over 4
22497
22498 =item Data Accessors
22499
22500 B<AddPreamble>
22501
22502 =back
22503
22504 B<AddPostamble>
22505
22506 B<Head1Level>
22507
22508 B<Label>
22509
22510 B<LevelNoNum>
22511
22512 B<MakeIndex>
22513
22514 B<ReplaceNAMEwithSection>
22515
22516 B<StartWithNewPage>
22517
22518 B<TableOfContents>
22519
22520 B<UniqueLabels>
22521
22522 B<UserPreamble>
22523
22524 B<UserPostamble>
22525
22526 B<Lists>
22527
22528 =over 4
22529
22530 =item Subclassed methods
22531
22532 =back
22533
22534 B<begin_pod>
22535
22536 B<end_pod>
22537
22538 B<command>
22539
22540 B<verbatim>
22541
22542 B<textblock>
22543
22544 B<interior_sequence>
22545
22546 =over 4
22547
22548 =item List Methods
22549
22550 B<begin_list>
22551
22552 =back
22553
22554 B<end_list>
22555
22556 B<add_item>
22557
22558 =over 4
22559
22560 =item Methods for headings
22561
22562 B<head>
22563
22564 =back
22565
22566 =over 4
22567
22568 =item Internal methods
22569
22570 B<_output>
22571
22572 =back
22573
22574 B<_replace_special_chars>
22575
22576 B<_replace_special_chars_late>
22577
22578 B<_create_label>
22579
22580 B<_create_index>
22581
22582 B<_clean_latex_commands>
22583
22584 B<_split_delimited>
22585
22586 =over 4
22587
22588 =item NOTES
22589
22590 =item SEE ALSO
22591
22592 =item AUTHORS
22593
22594 =item COPYRIGHT
22595
22596 =item REVISION
22597
22598 =back
22599
22600 =head2 Pod::Man - Convert POD data to formatted *roff input
22601
22602 =over 4
22603
22604 =item SYNOPSIS
22605
22606 =item DESCRIPTION
22607
22608 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
22609 release, section
22610
22611 =item DIAGNOSTICS
22612
22613 roff font should be 1 or 2 chars, not "%s", Invalid quote specification
22614 "%s"
22615
22616 =item BUGS
22617
22618 =item CAVEATS
22619
22620 =item AUTHOR
22621
22622 =item COPYRIGHT AND LICENSE
22623
22624 =item SEE ALSO
22625
22626 =back
22627
22628 =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
22629
22630 =over 4
22631
22632 =item SYNOPSIS
22633
22634 =item DESCRIPTION
22635
22636 =item SEE ALSO
22637
22638 =item AUTHOR
22639
22640 =item COPYRIGHT AND LICENSE
22641
22642 =back
22643
22644 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
22645
22646 =over 4
22647
22648 =item SYNOPSIS
22649
22650 =item DESCRIPTION
22651
22652 =back
22653
22654 =over 4
22655
22656 =item Pod::List
22657
22658 Pod::List-E<gt>new()
22659
22660 =back
22661
22662 $list-E<gt>file()
22663
22664 $list-E<gt>start()
22665
22666 $list-E<gt>indent()
22667
22668 $list-E<gt>type()
22669
22670 $list-E<gt>rx()
22671
22672 $list-E<gt>item()
22673
22674 $list-E<gt>parent()
22675
22676 $list-E<gt>tag()
22677
22678 =over 4
22679
22680 =item Pod::Hyperlink
22681
22682 Pod::Hyperlink-E<gt>new()
22683
22684 =back
22685
22686 $link-E<gt>parse($string)
22687
22688 $link-E<gt>markup($string)
22689
22690 $link-E<gt>text()
22691
22692 $link-E<gt>warning()
22693
22694 $link-E<gt>file(), $link-E<gt>line()
22695
22696 $link-E<gt>page()
22697
22698 $link-E<gt>node()
22699
22700 $link-E<gt>alttext()
22701
22702 $link-E<gt>type()
22703
22704 $link-E<gt>link()
22705
22706 =over 4
22707
22708 =item Pod::Cache
22709
22710 Pod::Cache-E<gt>new()
22711
22712 =back
22713
22714 $cache-E<gt>item()
22715
22716 $cache-E<gt>find_page($name)
22717
22718 =over 4
22719
22720 =item Pod::Cache::Item
22721
22722 Pod::Cache::Item-E<gt>new()
22723
22724 =back
22725
22726 $cacheitem-E<gt>page()
22727
22728 $cacheitem-E<gt>description()
22729
22730 $cacheitem-E<gt>path()
22731
22732 $cacheitem-E<gt>file()
22733
22734 $cacheitem-E<gt>nodes()
22735
22736 $cacheitem-E<gt>find_node($name)
22737
22738 $cacheitem-E<gt>idx()
22739
22740 =over 4
22741
22742 =item AUTHOR
22743
22744 =item SEE ALSO
22745
22746 =back
22747
22748 =head2 Pod::Parser - base class for creating POD filters and translators
22749
22750 =over 4
22751
22752 =item SYNOPSIS
22753
22754 =item REQUIRES
22755
22756 =item EXPORTS
22757
22758 =item DESCRIPTION
22759
22760 =item QUICK OVERVIEW
22761
22762 =item PARSING OPTIONS
22763
22764 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
22765 B<-warnings> (default: unset)
22766
22767 =back
22768
22769 =over 4
22770
22771 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
22772
22773 =back
22774
22775 =over 4
22776
22777 =item B<command()>
22778
22779 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
22780
22781 =back
22782
22783 =over 4
22784
22785 =item B<verbatim()>
22786
22787 C<$text>, C<$line_num>, C<$pod_para>
22788
22789 =back
22790
22791 =over 4
22792
22793 =item B<textblock()>
22794
22795 C<$text>, C<$line_num>, C<$pod_para>
22796
22797 =back
22798
22799 =over 4
22800
22801 =item B<interior_sequence()>
22802
22803 =back
22804
22805 =over 4
22806
22807 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
22808
22809 =back
22810
22811 =over 4
22812
22813 =item B<new()>
22814
22815 =back
22816
22817 =over 4
22818
22819 =item B<initialize()>
22820
22821 =back
22822
22823 =over 4
22824
22825 =item B<begin_pod()>
22826
22827 =back
22828
22829 =over 4
22830
22831 =item B<begin_input()>
22832
22833 =back
22834
22835 =over 4
22836
22837 =item B<end_input()>
22838
22839 =back
22840
22841 =over 4
22842
22843 =item B<end_pod()>
22844
22845 =back
22846
22847 =over 4
22848
22849 =item B<preprocess_line()>
22850
22851 =back
22852
22853 =over 4
22854
22855 =item B<preprocess_paragraph()>
22856
22857 =back
22858
22859 =over 4
22860
22861 =item METHODS FOR PARSING AND PROCESSING
22862
22863 =back
22864
22865 =over 4
22866
22867 =item B<parse_text()>
22868
22869 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
22870 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
22871 I<code-ref>|I<method-name>
22872
22873 =back
22874
22875 =over 4
22876
22877 =item B<interpolate()>
22878
22879 =back
22880
22881 =over 4
22882
22883 =item B<parse_paragraph()>
22884
22885 =back
22886
22887 =over 4
22888
22889 =item B<parse_from_filehandle()>
22890
22891 =back
22892
22893 =over 4
22894
22895 =item B<parse_from_file()>
22896
22897 =back
22898
22899 =over 4
22900
22901 =item ACCESSOR METHODS
22902
22903 =back
22904
22905 =over 4
22906
22907 =item B<errorsub()>
22908
22909 =back
22910
22911 =over 4
22912
22913 =item B<cutting()>
22914
22915 =back
22916
22917 =over 4
22918
22919 =item B<parseopts()>
22920
22921 =back
22922
22923 =over 4
22924
22925 =item B<output_file()>
22926
22927 =back
22928
22929 =over 4
22930
22931 =item B<output_handle()>
22932
22933 =back
22934
22935 =over 4
22936
22937 =item B<input_file()>
22938
22939 =back
22940
22941 =over 4
22942
22943 =item B<input_handle()>
22944
22945 =back
22946
22947 =over 4
22948
22949 =item B<input_streams()>
22950
22951 =back
22952
22953 =over 4
22954
22955 =item B<top_stream()>
22956
22957 =back
22958
22959 =over 4
22960
22961 =item PRIVATE METHODS AND DATA
22962
22963 =back
22964
22965 =over 4
22966
22967 =item B<_push_input_stream()>
22968
22969 =back
22970
22971 =over 4
22972
22973 =item B<_pop_input_stream()>
22974
22975 =back
22976
22977 =over 4
22978
22979 =item TREE-BASED PARSING
22980
22981 =item SEE ALSO
22982
22983 =item AUTHOR
22984
22985 =back
22986
22987 =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors
22988
22989 =over 4
22990
22991 =item SYNOPSIS
22992
22993 =item DESCRIPTION
22994
22995 =item SEE ALSO
22996
22997 =item COPYRIGHT AND DISCLAIMERS
22998
22999 =item AUTHOR
23000
23001 =back
23002
23003 =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages
23004
23005 =over 4
23006
23007 =item SYNOPSIS
23008
23009 =item DESCRIPTION
23010
23011 =item CAVEAT
23012
23013 =item SEE ALSO
23014
23015 =item COPYRIGHT AND DISCLAIMERS
23016
23017 =item AUTHOR
23018
23019 =back
23020
23021 =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff
23022
23023 =over 4
23024
23025 =item SYNOPSIS
23026
23027 =item DESCRIPTION
23028
23029 =item CAVEAT
23030
23031 =item SEE ALSO
23032
23033 =item COPYRIGHT AND DISCLAIMERS
23034
23035 =item AUTHOR
23036
23037 =back
23038
23039 =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod!
23040
23041 =over 4
23042
23043 =item SYNOPSIS
23044
23045 =item DESCRIPTION
23046
23047 =item SEE ALSO
23048
23049 =item COPYRIGHT AND DISCLAIMERS
23050
23051 =item AUTHOR
23052
23053 =back
23054
23055 =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF
23056
23057 =over 4
23058
23059 =item SYNOPSIS
23060
23061 =item DESCRIPTION
23062
23063 =item SEE ALSO
23064
23065 =item COPYRIGHT AND DISCLAIMERS
23066
23067 =item AUTHOR
23068
23069 =back
23070
23071 =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext
23072
23073 =over 4
23074
23075 =item SYNOPSIS
23076
23077 =item DESCRIPTION
23078
23079 =item CAVEAT
23080
23081 =item SEE ALSO
23082
23083 =item COPYRIGHT AND DISCLAIMERS
23084
23085 =item AUTHOR
23086
23087 =back
23088
23089 =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod
23090
23091 =over 4
23092
23093 =item SYNOPSIS
23094
23095 =item DESCRIPTION
23096
23097 =item SEE ALSO
23098
23099 =item AUTHOR
23100
23101 =back
23102
23103 =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML
23104
23105 =over 4
23106
23107 =item SYNOPSIS
23108
23109 =item DESCRIPTION
23110
23111 =item SEE ALSO
23112
23113 =item COPYRIGHT AND DISCLAIMERS
23114
23115 =item AUTHOR
23116
23117 =back
23118
23119 =head2 Pod::PlainText - Convert POD data to formatted ASCII text
23120
23121 =over 4
23122
23123 =item SYNOPSIS
23124
23125 =item DESCRIPTION
23126
23127 alt, indent, loose, sentence, width
23128
23129 =item DIAGNOSTICS
23130
23131 Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
23132 Unknown sequence: %s, Unmatched =back
23133
23134 =item RESTRICTIONS
23135
23136 =item NOTES
23137
23138 =item SEE ALSO
23139
23140 =item AUTHOR
23141
23142 =back
23143
23144 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
23145
23146 =over 4
23147
23148 =item SYNOPSIS
23149
23150 =item DESCRIPTION
23151
23152 =over 4
23153
23154 =item EXPORT
23155
23156 =back
23157
23158 =item AUTHOR
23159
23160 =item SEE ALSO
23161
23162 =back
23163
23164 =head2 Pod::Select, podselect() - extract selected sections of POD from
23165 input
23166
23167 =over 4
23168
23169 =item SYNOPSIS
23170
23171 =item REQUIRES
23172
23173 =item EXPORTS
23174
23175 =item DESCRIPTION
23176
23177 =item SECTION SPECIFICATIONS
23178
23179 =item RANGE SPECIFICATIONS
23180
23181 =back
23182
23183 =over 4
23184
23185 =item OBJECT METHODS
23186
23187 =back
23188
23189 =over 4
23190
23191 =item B<curr_headings()>
23192
23193 =back
23194
23195 =over 4
23196
23197 =item B<select()>
23198
23199 =back
23200
23201 =over 4
23202
23203 =item B<add_selection()>
23204
23205 =back
23206
23207 =over 4
23208
23209 =item B<clear_selections()>
23210
23211 =back
23212
23213 =over 4
23214
23215 =item B<match_section()>
23216
23217 =back
23218
23219 =over 4
23220
23221 =item B<is_selected()>
23222
23223 =back
23224
23225 =over 4
23226
23227 =item EXPORTED FUNCTIONS
23228
23229 =back
23230
23231 =over 4
23232
23233 =item B<podselect()>
23234
23235 B<-output>, B<-sections>, B<-ranges>
23236
23237 =back
23238
23239 =over 4
23240
23241 =item PRIVATE METHODS AND DATA
23242
23243 =back
23244
23245 =over 4
23246
23247 =item B<_compile_section_spec()>
23248
23249 =back
23250
23251 =over 4
23252
23253 =item $self->{_SECTION_HEADINGS}
23254
23255 =back
23256
23257 =over 4
23258
23259 =item $self->{_SELECTED_SECTIONS}
23260
23261 =back
23262
23263 =over 4
23264
23265 =item SEE ALSO
23266
23267 =item AUTHOR
23268
23269 =back
23270
23271 =head2 Pod::Simple - framework for parsing Pod
23272
23273 =over 4
23274
23275 =item SYNOPSIS
23276
23277 =item DESCRIPTION
23278
23279 =item MAIN METHODS
23280
23281 C<< $parser = I<SomeClass>->new(); >>, C<< $parser->output_fh( *OUT ); >>,
23282 C<< $parser->output_string( \$somestring ); >>, C<< $parser->parse_file(
23283 I<$some_filename> ); >>, C<< $parser->parse_file( *INPUT_FH ); >>, C<<
23284 $parser->parse_string_document( I<$all_content> ); >>, C<<
23285 $parser->parse_lines( I<...@lines...>, undef ); >>, C<<
23286 $parser->content_seen >>, C<< I<SomeClass>->filter( I<$filename> ); >>, C<<
23287 I<SomeClass>->filter( I<*INPUT_FH> ); >>, C<< I<SomeClass>->filter(
23288 I<\$document_content> ); >>
23289
23290 =item SECONDARY METHODS
23291
23292 C<< $parser->no_whining( I<SOMEVALUE> ) >>, C<< $parser->no_errata_section(
23293 I<SOMEVALUE> ) >>, C<< $parser->complain_stderr( I<SOMEVALUE> ) >>, C<<
23294 $parser->source_filename >>, C<< $parser->doc_has_started >>, C<<
23295 $parser->source_dead >>
23296
23297 =item CAVEATS
23298
23299 =item SEE ALSO
23300
23301 =item COPYRIGHT AND DISCLAIMERS
23302
23303 =item AUTHOR
23304
23305 =back
23306
23307 =head2 Pod::Simple::Checker -- check the Pod syntax of a document
23308
23309 =over 4
23310
23311 =item SYNOPSIS
23312
23313 =item DESCRIPTION
23314
23315 =item SEE ALSO
23316
23317 =item COPYRIGHT AND DISCLAIMERS
23318
23319 =item AUTHOR
23320
23321 =back
23322
23323 =head2 Pod::Simple::Debug -- put Pod::Simple into trace/debug mode
23324
23325 =over 4
23326
23327 =item SYNOPSIS
23328
23329 =item DESCRIPTION
23330
23331 =item CAVEATS
23332
23333 =item GUTS
23334
23335 =item SEE ALSO
23336
23337 =item COPYRIGHT AND DISCLAIMERS
23338
23339 =item AUTHOR
23340
23341 =back
23342
23343 =head2 Pod::Simple::DumpAsText -- dump Pod-parsing events as text
23344
23345 =over 4
23346
23347 =item SYNOPSIS
23348
23349 =item DESCRIPTION
23350
23351 =item SEE ALSO
23352
23353 =item COPYRIGHT AND DISCLAIMERS
23354
23355 =item AUTHOR
23356
23357 =back
23358
23359 =head2 Pod::Simple::DumpAsXML -- turn Pod into XML
23360
23361 =over 4
23362
23363 =item SYNOPSIS
23364
23365 =item DESCRIPTION
23366
23367 =item SEE ALSO
23368
23369 =item COPYRIGHT AND DISCLAIMERS
23370
23371 =item AUTHOR
23372
23373 =back
23374
23375 =head2 Pod::Simple::HTML - convert Pod to HTML
23376
23377 =over 4
23378
23379 =item SYNOPSIS
23380
23381 =item DESCRIPTION
23382
23383 =item CALLING FROM THE COMMAND LINE
23384
23385 =item CALLING FROM PERL
23386
23387 =item METHODS
23388
23389 =item SUBCLASSING
23390
23391 =item SEE ALSO
23392
23393 =item COPYRIGHT AND DISCLAIMERS
23394
23395 =item AUTHOR
23396
23397 =back
23398
23399 =head2 Pod::Simple::HTMLBatch - convert several Pod files to several HTML
23400 files
23401
23402 =over 4
23403
23404 =item SYNOPSIS
23405
23406 =item DESCRIPTION
23407
23408 =over 4
23409
23410 =item FROM THE COMMAND LINE
23411
23412 =back
23413
23414 =item MAIN METHODS
23415
23416 $batchconv = Pod::Simple::HTMLBatch->new;, $batchconv->batch_convert(
23417 I<indirs>, I<outdir> );, $batchconv->batch_convert( undef    , ...);,
23418 $batchconv->batch_convert( q{@INC}, ...);, $batchconv->batch_convert(
23419 \@dirs , ...);, $batchconv->batch_convert( "somedir" , ...);,
23420 $batchconv->batch_convert( 'somedir:someother:also' , ...);,
23421 $batchconv->batch_convert( ... , undef );, $batchconv->batch_convert( ... ,
23422 'somedir' );
23423
23424 =over 4
23425
23426 =item ACCESSOR METHODS
23427
23428 $batchconv->verbose( I<nonnegative_integer> );, $batchconv->index(
23429 I<true-or-false> );, $batchconv->contents_file( I<filename> );,
23430 $batchconv->contents_page_start( I<HTML_string> );,
23431 $batchconv->contents_page_end( I<HTML_string> );, $batchconv->add_css( $url
23432 );, $batchconv->add_javascript( $url );, $batchconv->css_flurry(
23433 I<true-or-false> );, $batchconv->javascript_flurry( I<true-or-false> );,
23434 $batchconv->no_contents_links( I<true-or-false> );,
23435 $batchconv->html_render_class( I<classname> );
23436
23437 =back
23438
23439 =item NOTES ON CUSTOMIZATION
23440
23441 =item ASK ME!
23442
23443 =item SEE ALSO
23444
23445 =item COPYRIGHT AND DISCLAIMERS
23446
23447 =item AUTHOR
23448
23449 =back
23450
23451 =head2 Pod::Simple::LinkSection -- represent "section" attributes of L
23452 codes
23453
23454 =over 4
23455
23456 =item SYNOPSIS
23457
23458 =item DESCRIPTION
23459
23460 =item SEE ALSO
23461
23462 =item COPYRIGHT AND DISCLAIMERS
23463
23464 =item AUTHOR
23465
23466 =back
23467
23468 =head2 Pod::Simple::Methody -- turn Pod::Simple events into method calls
23469
23470 =over 4
23471
23472 =item SYNOPSIS
23473
23474 =item DESCRIPTION
23475
23476 =item METHOD CALLING
23477
23478 =item SEE ALSO
23479
23480 =item COPYRIGHT AND DISCLAIMERS
23481
23482 =item AUTHOR
23483
23484 =back
23485
23486 =head2 Pod::Simple::PullParser -- a pull-parser interface to parsing Pod
23487
23488 =over 4
23489
23490 =item SYNOPSIS
23491
23492 =item DESCRIPTION
23493
23494 =item METHODS
23495
23496 my $token = $parser->get_token, $parser->unget_token( $token ),
23497 $parser->unget_token( $token1, $token2, ... ), $parser->set_source(
23498 $filename ), $parser->set_source( $filehandle_object ),
23499 $parser->set_source( \$document_source ), $parser->set_source(
23500 \@document_lines ), $parser->parse_file(...),
23501 $parser->parse_string_document(...), $parser->filter(...),
23502 $parser->parse_from_file(...), my $title_string = $parser->get_title, my
23503 $title_string = $parser->get_short_title, $author_name   =
23504 $parser->get_author, $description_name = $parser->get_description,
23505 $version_block = $parser->get_version
23506
23507 =item NOTE
23508
23509 =item SEE ALSO
23510
23511 =item COPYRIGHT AND DISCLAIMERS
23512
23513 =item AUTHOR
23514
23515 =back
23516
23517 =head2 Pod::Simple::PullParserEndToken -- end-tokens from
23518 Pod::Simple::PullParser
23519
23520 =over 4
23521
23522 =item SYNOPSIS
23523
23524 =item DESCRIPTION
23525
23526 $token->tagname, $token->tagname(I<somestring>), $token->tag(...),
23527 $token->is_tag(I<somestring>) or $token->is_tagname(I<somestring>)
23528
23529 =item SEE ALSO
23530
23531 =item COPYRIGHT AND DISCLAIMERS
23532
23533 =item AUTHOR
23534
23535 =back
23536
23537 =head2 Pod::Simple::PullParserStartToken -- start-tokens from
23538 Pod::Simple::PullParser
23539
23540 =over 4
23541
23542 =item SYNOPSIS
23543
23544 =item DESCRIPTION
23545
23546 $token->tagname, $token->tagname(I<somestring>), $token->tag(...),
23547 $token->is_tag(I<somestring>) or $token->is_tagname(I<somestring>),
23548 $token->attr(I<attrname>), $token->attr(I<attrname>, I<newvalue>),
23549 $token->attr_hash
23550
23551 =item SEE ALSO
23552
23553 =item COPYRIGHT AND DISCLAIMERS
23554
23555 =item AUTHOR
23556
23557 =back
23558
23559 =head2 Pod::Simple::PullParserTextToken -- text-tokens from
23560 Pod::Simple::PullParser
23561
23562 =over 4
23563
23564 =item SYNOPSIS
23565
23566 =item DESCRIPTION
23567
23568 $token->text, $token->text(I<somestring>), $token->text_r()
23569
23570 =item SEE ALSO
23571
23572 =item COPYRIGHT AND DISCLAIMERS
23573
23574 =item AUTHOR
23575
23576 =back
23577
23578 =head2 Pod::Simple::PullParserToken -- tokens from Pod::Simple::PullParser
23579
23580 =over 4
23581
23582 =item SYNOPSIS
23583
23584 =item DESCRIPTION
23585
23586 $token->type, $token->is_start, $token->is_text, $token->is_end,
23587 $token->dump
23588
23589 =item SEE ALSO
23590
23591 =item COPYRIGHT AND DISCLAIMERS
23592
23593 =item AUTHOR
23594
23595 =back
23596
23597 =head2 Pod::Simple::RTF -- format Pod as RTF
23598
23599 =over 4
23600
23601 =item SYNOPSIS
23602
23603 =item DESCRIPTION
23604
23605 =item FORMAT CONTROL ATTRIBUTES
23606
23607 $parser->head1_halfpoint_size( I<halfpoint_integer> );,
23608 $parser->head2_halfpoint_size( I<halfpoint_integer> );,
23609 $parser->head3_halfpoint_size( I<halfpoint_integer> );,
23610 $parser->head4_halfpoint_size( I<halfpoint_integer> );,
23611 $parser->codeblock_halfpoint_size( I<halfpoint_integer> );,
23612 $parser->header_halfpoint_size( I<halfpoint_integer> );,
23613 $parser->normal_halfpoint_size( I<halfpoint_integer> );,
23614 $parser->no_proofing_exemptions( I<true_or_false> );, $parser->doc_lang(
23615 I<microsoft_decimal_language_code> )
23616
23617 =item SEE ALSO
23618
23619 =item COPYRIGHT AND DISCLAIMERS
23620
23621 =item AUTHOR
23622
23623 =back
23624
23625 =head2 Pod::Simple::Search - find POD documents in directory trees
23626
23627 =over 4
23628
23629 =item SYNOPSIS
23630
23631 =item DESCRIPTION
23632
23633 =item CONSTRUCTOR
23634
23635 =item ACCESSORS
23636
23637 $search->inc( I<true-or-false> );, $search->verbose( I<nonnegative-number>
23638 );, $search->limit_glob( I<some-glob-string> );, $search->callback(
23639 I<\&some_routine> );, $search->laborious( I<true-or-false> );,
23640 $search->shadows( I<true-or-false> );, $search->limit_re( I<some-regxp> );,
23641 $search->dir_prefix( I<some-string-value> );, $search->progress(
23642 I<some-progress-object> );, $name2path = $self->name2path;, $path2name =
23643 $self->path2name;
23644
23645 =item MAIN SEARCH METHODS
23646
23647 =over 4
23648
23649 =item C<< $search->survey( @directories ) >>
23650
23651 C<name2path>, C<path2name>
23652
23653 =item C<< $search->simplify_name( $str ) >>
23654
23655 =item C<< $search->find( $pod ) >>
23656
23657 =item C<< $search->find( $pod, @search_dirs ) >>
23658
23659 =item C<< $self->contains_pod( $file ) >>
23660
23661 =back
23662
23663 =item AUTHOR
23664
23665 =item SEE ALSO
23666
23667 =back
23668
23669 =head2 Pod::Simple::Subclassing -- write a formatter as a Pod::Simple
23670 subclass
23671
23672 =over 4
23673
23674 =item SYNOPSIS
23675
23676 =item DESCRIPTION
23677
23678 =item Events
23679
23680 C<< $parser->_handle_element_start( I<element_name>, I<attr_hashref> ) >>,
23681 C<< $parser->_handle_element_end( I<element_name>  ) >>, C<<
23682 $parser->_handle_text(  I<text_string>  ) >>, events with an element_name
23683 of Document, events with an element_name of Para, events with an
23684 element_name of B, C, F, or I, events with an element_name of S, events
23685 with an element_name of X, events with an element_name of L, events with an
23686 element_name of E or Z, events with an element_name of Verbatim, events
23687 with an element_name of head1 .. head4, events with an element_name of
23688 over-bullet, events with an element_name of over-number, events with an
23689 element_name of over-text, events with an element_name of over-block,
23690 events with an element_name of item-bullet, events with an element_name of
23691 item-number, events with an element_name of item-text, events with an
23692 element_name of for, events with an element_name of Data
23693
23694 =item More Pod::Simple Methods
23695
23696 C<< $parser->accept_targets( I<SOMEVALUE> ) >>, C<<
23697 $parser->accept_targets_as_text(  I<SOMEVALUE>  ) >>, C<<
23698 $parser->accept_codes( I<Codename>, I<Codename>...  ) >>, C<<
23699 $parser->accept_directive_as_data( I<directive_name> ) >>, C<<
23700 $parser->accept_directive_as_verbatim( I<directive_name> ) >>, C<<
23701 $parser->accept_directive_as_processed( I<directive_name> ) >>, C<<
23702 $parser->nbsp_for_S( I<BOOLEAN> ); >>, C<< $parser->version_report() >>,
23703 C<< $parser->pod_para_count() >>, C<< $parser->line_count() >>, C<<
23704 $parser->nix_X_codes(  I<SOMEVALUE>  ) >>, C<< $parser->merge_text( 
23705 I<SOMEVALUE>  ) >>, C<< $parser->code_handler(  I<CODE_REF>  ) >>, C<<
23706 $parser->cut_handler(  I<CODE_REF>  ) >>, C<< $parser->whine(
23707 I<linenumber>, I<complaint string> ) >>, C<< $parser->scream(
23708 I<linenumber>, I<complaint string> ) >>, C<< $parser->source_dead(1) >>,
23709 C<< $parser->hide_line_numbers( I<SOMEVALUE> ) >>, C<< $parser->no_whining(
23710 I<SOMEVALUE> ) >>, C<< $parser->no_errata_section( I<SOMEVALUE> ) >>, C<<
23711 $parser->complain_stderr( I<SOMEVALUE> ) >>, C<< $parser->bare_output(
23712 I<SOMEVALUE> ) >>, C<< $parser->preserve_whitespace( I<SOMEVALUE> ) >>
23713
23714 =item SEE ALSO
23715
23716 =item COPYRIGHT AND DISCLAIMERS
23717
23718 =item AUTHOR
23719
23720 =back
23721
23722 =head2 Pod::Simple::Text -- format Pod as plaintext
23723
23724 =over 4
23725
23726 =item SYNOPSIS
23727
23728 =item DESCRIPTION
23729
23730 =item SEE ALSO
23731
23732 =item COPYRIGHT AND DISCLAIMERS
23733
23734 =item AUTHOR
23735
23736 =back
23737
23738 =head2 Pod::Simple::TextContent -- get the text content of Pod
23739
23740 =over 4
23741
23742 =item SYNOPSIS
23743
23744 =item DESCRIPTION
23745
23746 =item SEE ALSO
23747
23748 =item COPYRIGHT AND DISCLAIMERS
23749
23750 =item AUTHOR
23751
23752 =back
23753
23754 =head2 Pod::Simple::XMLOutStream -- turn Pod into XML
23755
23756 =over 4
23757
23758 =item SYNOPSIS
23759
23760 =item DESCRIPTION
23761
23762 =item SEE ALSO
23763
23764 =item ABOUT EXTENDING POD
23765
23766 =item ASK ME!
23767
23768 =item COPYRIGHT AND DISCLAIMERS
23769
23770 =item AUTHOR
23771
23772 =back
23773
23774 =head2 Pod::SimpleTree, Pod::Simple::SimpleTree -- parse Pod into a simple
23775 parse tree 
23776
23777 =over 4
23778
23779 =item SYNOPSIS
23780
23781 =item DESCRIPTION
23782
23783 =item METHODS
23784
23785 =item Tree Contents
23786
23787 =item SEE ALSO
23788
23789 =item COPYRIGHT AND DISCLAIMERS
23790
23791 =item AUTHOR
23792
23793 =back
23794
23795 =head2 Pod::Text - Convert POD data to formatted ASCII text
23796
23797 =over 4
23798
23799 =item SYNOPSIS
23800
23801 =item DESCRIPTION
23802
23803 alt, code, indent, loose, margin, quotes, sentence, width
23804
23805 =item DIAGNOSTICS
23806
23807 Bizarre space in item, Item called without tag, Can't open %s for reading:
23808 %s, Invalid quote specification "%s"
23809
23810 =item NOTES
23811
23812 =item SEE ALSO
23813
23814 =item AUTHOR
23815
23816 =item COPYRIGHT AND LICENSE
23817
23818 =back
23819
23820 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
23821
23822 =over 4
23823
23824 =item SYNOPSIS
23825
23826 =item DESCRIPTION
23827
23828 =item BUGS
23829
23830 =item SEE ALSO
23831
23832 =item AUTHOR
23833
23834 =item COPYRIGHT AND LICENSE
23835
23836 =back
23837
23838 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
23839 text
23840
23841 =over 4
23842
23843 =item SYNOPSIS
23844
23845 =item DESCRIPTION
23846
23847 =item BUGS
23848
23849 =item SEE ALSO
23850
23851 =item AUTHOR
23852
23853 =item COPYRIGHT AND LICENSE
23854
23855 =back
23856
23857 =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
23858 escapes
23859
23860 =over 4
23861
23862 =item SYNOPSIS
23863
23864 =item DESCRIPTION
23865
23866 =item NOTES
23867
23868 =item SEE ALSO
23869
23870 =item AUTHOR
23871
23872 =item COPYRIGHT AND LICENSE
23873
23874 =back
23875
23876 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
23877 documentation
23878
23879 =over 4
23880
23881 =item SYNOPSIS
23882
23883 =item ARGUMENTS
23884
23885 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-sections>, C<-output>,
23886 C<-input>, C<-pathlist>, C<-noperldoc>
23887
23888 =item DESCRIPTION
23889
23890 =item EXAMPLES
23891
23892 =over 4
23893
23894 =item Recommended Use
23895
23896 =back
23897
23898 =item CAVEATS
23899
23900 =item AUTHOR
23901
23902 =item ACKNOWLEDGEMENTS
23903
23904 =back
23905
23906 =head2 SDBM_File - Tied access to sdbm files
23907
23908 =over 4
23909
23910 =item SYNOPSIS
23911
23912 =item DESCRIPTION
23913
23914 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
23915
23916 =item DIAGNOSTICS
23917
23918 =over 4
23919
23920 =item C<sdbm store returned -1, errno 22, key "..." at ...>
23921
23922 =back
23923
23924 =item BUGS AND WARNINGS
23925
23926 =back
23927
23928 =head2 Safe - Compile and execute code in restricted compartments
23929
23930 =over 4
23931
23932 =item SYNOPSIS
23933
23934 =item DESCRIPTION
23935
23936 a new namespace, an operator mask
23937
23938 =item WARNING
23939
23940 =over 4
23941
23942 =item RECENT CHANGES
23943
23944 =item Methods in class Safe
23945
23946 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
23947 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
23948 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
23949 root (NAMESPACE), mask (MASK)
23950
23951 =item Some Safety Issues
23952
23953 Memory, CPU, Snooping, Signals, State Changes
23954
23955 =item AUTHOR
23956
23957 =back
23958
23959 =back
23960
23961 =head2 Scalar::Util - A selection of general-utility scalar subroutines
23962
23963 =over 4
23964
23965 =item SYNOPSIS
23966
23967 =item DESCRIPTION
23968
23969 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
23970 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
23971 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
23972
23973 =item KNOWN BUGS
23974
23975 =item COPYRIGHT
23976
23977 =item BLATANT PLUG
23978
23979 =back
23980
23981 =head2 Search::Dict, look - search for key in dictionary file
23982
23983 =over 4
23984
23985 =item SYNOPSIS
23986
23987 =item DESCRIPTION
23988
23989 =back
23990
23991 =head2 SelectSaver - save and restore selected file handle
23992
23993 =over 4
23994
23995 =item SYNOPSIS
23996
23997 =item DESCRIPTION
23998
23999 =back
24000
24001 =head2 SelfLoader - load functions only on demand
24002
24003 =over 4
24004
24005 =item SYNOPSIS
24006
24007 =item DESCRIPTION
24008
24009 =over 4
24010
24011 =item The __DATA__ token
24012
24013 =item SelfLoader autoloading
24014
24015 =item Autoloading and package lexicals
24016
24017 =item SelfLoader and AutoLoader
24018
24019 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
24020
24021 =item Classes and inherited methods.
24022
24023 =back
24024
24025 =item Multiple packages and fully qualified subroutine names
24026
24027 =back
24028
24029 =head2 Shell - run shell commands transparently within perl
24030
24031 =over 4
24032
24033 =item SYNOPSIS
24034
24035 =item DESCRIPTION
24036
24037 =over 4
24038
24039 =item Caveats
24040
24041 =item Escaping Magic Characters
24042
24043 =item Configuration
24044
24045 =back
24046
24047 =item BUGS
24048
24049 =item AUTHOR
24050
24051 =back
24052
24053 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
24054 socket.h defines and structure manipulators 
24055
24056 =over 4
24057
24058 =item SYNOPSIS
24059
24060 =item DESCRIPTION
24061
24062 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
24063 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
24064 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
24065 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
24066 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
24067
24068 =back
24069
24070 =head2 Storable - persistence for Perl data structures
24071
24072 =over 4
24073
24074 =item SYNOPSIS
24075
24076 =item DESCRIPTION
24077
24078 =item MEMORY STORE
24079
24080 =item ADVISORY LOCKING
24081
24082 =item SPEED
24083
24084 =item CANONICAL REPRESENTATION
24085
24086 =item CODE REFERENCES
24087
24088 =item FORWARD COMPATIBILITY
24089
24090 utf8 data, restricted hashes, files from future versions of Storable
24091
24092 =item ERROR REPORTING
24093
24094 =item WIZARDS ONLY
24095
24096 =over 4
24097
24098 =item Hooks
24099
24100 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
24101 I<serialized>, .., C<STORABLE_attach> I<class>, I<cloning>, I<serialized>
24102
24103 =item Predicates
24104
24105 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
24106 C<Storable::is_retrieving>
24107
24108 =item Recursion
24109
24110 =item Deep Cloning
24111
24112 =back
24113
24114 =item Storable magic
24115
24116 $info = Storable::file_magic( $filename ), C<version>, C<version_nv>,
24117 C<major>, C<minor>, C<hdrsize>, C<netorder>, C<byteorder>, C<intsize>,
24118 C<longsize>, C<ptrsize>, C<nvsize>, C<file>, $info = Storable::read_magic(
24119 $buffer ), $info = Storable::read_magic( $buffer, $must_be_file )
24120
24121 =item EXAMPLES
24122
24123 =item WARNING
24124
24125 =item BUGS
24126
24127 =over 4
24128
24129 =item 64 bit data in perl 5.6.0 and 5.6.1
24130
24131 =back
24132
24133 =item CREDITS
24134
24135 =item AUTHOR
24136
24137 =item SEE ALSO
24138
24139 =back
24140
24141 =head2 Switch - A switch statement for Perl
24142
24143 =over 4
24144
24145 =item VERSION
24146
24147 =item SYNOPSIS
24148
24149 =item BACKGROUND
24150
24151 =item DESCRIPTION
24152
24153 =over 4
24154
24155 =item Allowing fall-through
24156
24157 =item Automating fall-through
24158
24159 =item Alternative syntax
24160
24161 =item Higher-order Operations
24162
24163 =back
24164
24165 =item DEPENDENCIES
24166
24167 =item AUTHOR
24168
24169 =item BUGS
24170
24171 =item LIMITATIONS
24172
24173 =item COPYRIGHT
24174
24175 =back
24176
24177 =head2 Symbol - manipulate Perl symbols and their names
24178
24179 =over 4
24180
24181 =item SYNOPSIS
24182
24183 =item DESCRIPTION
24184
24185 =item BUGS
24186
24187 =back
24188
24189 =head2 Sys::Hostname - Try every conceivable way to get hostname
24190
24191 =over 4
24192
24193 =item SYNOPSIS
24194
24195 =item DESCRIPTION
24196
24197 =item AUTHOR
24198
24199 =back
24200
24201 =head2 Syslog, Sys::Syslog - Perl interface to the UNIX syslog(3) calls
24202
24203 =over 4
24204
24205 =item VERSION
24206
24207 =item SYNOPSIS
24208
24209 =item DESCRIPTION
24210
24211 =item EXPORTS
24212
24213 =item FUNCTIONS
24214
24215 B<openlog($ident, $logopt, $facility)>, B<syslog($priority, $message)>,
24216 B<syslog($priority, $format, @args)>, B<Note>,
24217 B<setlogmask($mask_priority)>, B<setlogsock($sock_type)>,
24218 B<setlogsock($sock_type, $stream_location)> (added in 5.004_02),
24219 B<closelog()>
24220
24221 =item EXAMPLES
24222
24223 =item CONSTANTS
24224
24225 =over 4
24226
24227 =item Facilities
24228
24229 =item Levels
24230
24231 =back
24232
24233 =item DIAGNOSTICS
24234
24235 Invalid argument passed to setlogsock, no connection to syslog available,
24236 stream passed to setlogsock, but %s is not writable, stream passed to
24237 setlogsock, but could not find any device, tcp passed to setlogsock, but
24238 tcp service unavailable, syslog: expecting argument %s, syslog: invalid
24239 level/facility: %s, syslog: too many levels given: %s, syslog: too many
24240 facilities given: %s, syslog: level must be given, udp passed to
24241 setlogsock, but udp service unavailable, unix passed to setlogsock, but
24242 path not available
24243
24244 =item SEE ALSO
24245
24246 =item AUTHOR
24247
24248 =item BUGS
24249
24250 =item SUPPORT
24251
24252 AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request
24253 tracker, Search CPAN
24254
24255 =item LICENSE
24256
24257 =back
24258
24259 =head2 Syslog::Syslog, Sys::Syslog - Perl interface to the UNIX syslog(3)
24260 calls
24261
24262 =over 4
24263
24264 =item VERSION
24265
24266 =item SYNOPSIS
24267
24268 =item DESCRIPTION
24269
24270 =item EXPORTS
24271
24272 =item FUNCTIONS
24273
24274 B<openlog($ident, $logopt, $facility)>, B<syslog($priority, $message)>,
24275 B<syslog($priority, $format, @args)>, B<Note>,
24276 B<setlogmask($mask_priority)>, B<setlogsock($sock_type)>,
24277 B<setlogsock($sock_type, $stream_location)> (added in 5.004_02),
24278 B<closelog()>
24279
24280 =item EXAMPLES
24281
24282 =item CONSTANTS
24283
24284 =over 4
24285
24286 =item Facilities
24287
24288 =item Levels
24289
24290 =back
24291
24292 =item DIAGNOSTICS
24293
24294 Invalid argument passed to setlogsock, no connection to syslog available,
24295 stream passed to setlogsock, but %s is not writable, stream passed to
24296 setlogsock, but could not find any device, tcp passed to setlogsock, but
24297 tcp service unavailable, syslog: expecting argument %s, syslog: invalid
24298 level/facility: %s, syslog: too many levels given: %s, syslog: too many
24299 facilities given: %s, syslog: level must be given, udp passed to
24300 setlogsock, but udp service unavailable, unix passed to setlogsock, but
24301 path not available
24302
24303 =item SEE ALSO
24304
24305 =item AUTHOR
24306
24307 =item BUGS
24308
24309 =item SUPPORT
24310
24311 AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request
24312 tracker, Search CPAN
24313
24314 =item LICENSE
24315
24316 =back
24317
24318 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
24319
24320 =over 4
24321
24322 =item SYNOPSIS
24323
24324 =item DESCRIPTION
24325
24326 =item DIAGNOSTICS
24327
24328 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
24329 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
24330 comma allowed after filehandle, No name for escape sequence %s
24331
24332 =item ENVIRONMENT
24333
24334 ANSI_COLORS_DISABLED
24335
24336 =item RESTRICTIONS
24337
24338 =item NOTES
24339
24340 =item SEE ALSO
24341
24342 =item AUTHORS
24343
24344 =item COPYRIGHT AND LICENSE
24345
24346 =back
24347
24348 =head2 Term::Cap - Perl termcap interface
24349
24350 =over 4
24351
24352 =item SYNOPSIS
24353
24354 =item DESCRIPTION
24355
24356 =over 4
24357
24358 =item METHODS
24359
24360 =back
24361
24362 =back
24363
24364 B<Tgetent>, OSPEED, TERM
24365
24366 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
24367
24368 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
24369
24370 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
24371
24372 B<Trequire>
24373
24374 =over 4
24375
24376 =item EXAMPLES
24377
24378 =item COPYRIGHT AND LICENSE
24379
24380 =item AUTHOR
24381
24382 =item SEE ALSO
24383
24384 =back
24385
24386 =head2 Term::Complete - Perl word completion module
24387
24388 =over 4
24389
24390 =item SYNOPSIS
24391
24392 =item DESCRIPTION
24393
24394 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
24395
24396 =item DIAGNOSTICS
24397
24398 =item BUGS
24399
24400 =item AUTHOR
24401
24402 =back
24403
24404 =head2 Term::ReadLine - Perl interface to various C<readline> packages.
24405 If no real package is found, substitutes stubs instead of basic functions.
24406
24407 =over 4
24408
24409 =item SYNOPSIS
24410
24411 =item DESCRIPTION
24412
24413 =item Minimal set of supported functions
24414
24415 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>,
24416 C<findConsole>, Attribs, C<Features>
24417
24418 =item Additional supported functions
24419
24420 C<tkRunning>, C<ornaments>, C<newTTY>
24421
24422 =item EXPORTS
24423
24424 =item ENVIRONMENT
24425
24426 =item CAVEATS
24427
24428 =back
24429
24430 =head2 Test - provides a simple framework for writing test scripts
24431
24432 =over 4
24433
24434 =item SYNOPSIS
24435
24436 =item DESCRIPTION
24437
24438 =item QUICK START GUIDE
24439
24440 =over 4
24441
24442 =item Functions
24443
24444 C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>,
24445 C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub>
24446
24447 =back
24448
24449 =back
24450
24451 B<_to_value>
24452
24453 C<ok(...)>
24454
24455 C<skip(I<skip_if_true>, I<args...>)>
24456
24457 =over 4
24458
24459 =item TEST TYPES
24460
24461 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
24462
24463 =item ONFAIL
24464
24465 =item BUGS and CAVEATS
24466
24467 =item ENVIRONMENT
24468
24469 =item NOTE
24470
24471 =item SEE ALSO
24472
24473 =item AUTHOR
24474
24475 =back
24476
24477 =head2 Test::Builder - Backend for building test libraries
24478
24479 =over 4
24480
24481 =item SYNOPSIS
24482
24483 =item DESCRIPTION
24484
24485 =over 4
24486
24487 =item Construction
24488
24489 B<new>
24490
24491 =back
24492
24493 =back
24494
24495 B<create>
24496
24497 B<reset>
24498
24499 =over 4
24500
24501 =item Setting up tests
24502
24503 B<exported_to>
24504
24505 =back
24506
24507 B<plan>
24508
24509 B<expected_tests>
24510
24511 B<no_plan>
24512
24513 B<has_plan>
24514
24515 B<skip_all>
24516
24517 =over 4
24518
24519 =item Running tests
24520
24521 B<ok>
24522
24523 =back
24524
24525 B<is_eq>, B<is_num>
24526
24527 B<isnt_eq>, B<isnt_num>
24528
24529 B<like>, B<unlike>
24530
24531 B<maybe_regex>
24532
24533 B<cmp_ok>
24534
24535 B<BAIL_OUT>
24536
24537 B<skip>
24538
24539 B<todo_skip>
24540
24541 B<skip_rest>
24542
24543 =over 4
24544
24545 =item Test style
24546
24547 B<level>
24548
24549 =back
24550
24551 B<use_numbers>
24552
24553 B<no_diag>, B<no_ending>, B<no_header>
24554
24555 =over 4
24556
24557 =item Output
24558
24559 B<diag>
24560
24561 =back
24562
24563 B<_print>
24564
24565 B<_print_diag>
24566
24567 B<output>, B<failure_output>, B<todo_output>
24568
24569 =over 4
24570
24571 =item Test Status and Info
24572
24573 B<current_test>
24574
24575 =back
24576
24577 B<summary>
24578
24579 B<details>
24580
24581 B<todo>
24582
24583 B<caller>
24584
24585 B<_sanity_check>
24586
24587 B<_whoa>
24588
24589 B<_my_exit>
24590
24591 =over 4
24592
24593 =item EXIT CODES
24594
24595 =item THREADS
24596
24597 =item EXAMPLES
24598
24599 =item SEE ALSO
24600
24601 =item AUTHORS
24602
24603 =item COPYRIGHT
24604
24605 =back
24606
24607 =head2 Test::Builder::Module - Base class for test modules
24608
24609 =over 4
24610
24611 =item SYNOPSIS
24612
24613 =item DESCRIPTION
24614
24615 =over 4
24616
24617 =item Importing
24618
24619 =back
24620
24621 =back
24622
24623 =over 4
24624
24625 =item Builder
24626
24627 =back
24628
24629 =head2 Test::Builder::Tester - test testsuites that have been built with
24630 Test::Builder
24631
24632 =over 4
24633
24634 =item SYNOPSIS
24635
24636 =item DESCRIPTION
24637
24638 =back
24639
24640 =over 4
24641
24642 =item Methods
24643
24644 test_out, test_err
24645
24646 =back
24647
24648 test_fail
24649
24650 test_diag
24651
24652 test_test, title (synonym 'name', 'label'), skip_out, skip_err
24653
24654 line_num
24655
24656 color
24657
24658 =over 4
24659
24660 =item BUGS
24661
24662 =item AUTHOR
24663
24664 =item NOTES
24665
24666 =item SEE ALSO
24667
24668 =back
24669
24670 =head2 Test::Builder::Tester::Color - turn on colour in
24671 Test::Builder::Tester
24672
24673 =over 4
24674
24675 =item SYNOPSIS
24676
24677 =item DESCRIPTION
24678
24679 =back
24680
24681 =over 4
24682
24683 =item AUTHOR
24684
24685 =item BUGS
24686
24687 =item SEE ALSO
24688
24689 =back
24690
24691 =head2 Test::Harness - Run Perl standard test scripts with statistics
24692
24693 =over 4
24694
24695 =item VERSION
24696
24697 =back
24698
24699 =over 4
24700
24701 =item SYNOPSIS
24702
24703 =item DESCRIPTION
24704
24705 =over 4
24706
24707 =item Taint mode
24708
24709 =item Configuration variables.
24710
24711 C<$Test::Harness::Verbose>, C<$Test::Harness::switches>,
24712 C<$Test::Harness::Timer>
24713
24714 =item Failure
24715
24716 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
24717 Failed>
24718
24719 =item Functions
24720
24721 B<runtests>
24722
24723 =back
24724
24725 =back
24726
24727 B<_all_ok>
24728
24729 B<_globdir>
24730
24731 B<_run_all_tests>
24732
24733 B<_mk_leader>
24734
24735 B<_leader_width>
24736
24737 =over 4
24738
24739 =item EXPORT
24740
24741 =item DIAGNOSTICS
24742
24743 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
24744 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
24745 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
24746 %s>, C<FAILED--Further testing stopped: %s>
24747
24748 =item ENVIRONMENT VARIABLES THAT TEST::HARNESS SETS
24749
24750 C<HARNESS_ACTIVE>, C<HARNESS_VERSION>
24751
24752 =item ENVIRONMENT VARIABLES THAT AFFECT TEST::HARNESS
24753
24754 C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>, C<HARNESS_DEBUG>,
24755 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
24756 C<HARNESS_PERL>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
24757
24758 =item EXAMPLE
24759
24760 =item SEE ALSO
24761
24762 =item TODO
24763
24764 =item BUGS
24765
24766 =item AUTHORS
24767
24768 =item COPYRIGHT
24769
24770 =back
24771
24772 =head2 Test::Harness::Assert - simple assert
24773
24774 =over 4
24775
24776 =item SYNOPSIS
24777
24778 =item DESCRIPTION
24779
24780 =item FUNCTIONS
24781
24782 =over 4
24783
24784 =item C<assert()>
24785
24786 =back
24787
24788 =back
24789
24790 =over 4
24791
24792 =item AUTHOR
24793
24794 =item SEE ALSO
24795
24796 =back
24797
24798 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
24799
24800 =over 4
24801
24802 =item SYNOPSIS
24803
24804 =item DESCRIPTION
24805
24806 =over 4
24807
24808 =item new()
24809
24810 =item next()
24811
24812 =back
24813
24814 =back
24815
24816 =head2 Test::Harness::Point - object for tracking a single test point
24817
24818 =over 4
24819
24820 =item SYNOPSIS
24821
24822 =item CONSTRUCTION
24823
24824 =over 4
24825
24826 =item new()
24827
24828 =back
24829
24830 =back
24831
24832 =over 4
24833
24834 =item from_test_line( $line )
24835
24836 =back
24837
24838 =over 4
24839
24840 =item ACCESSORS
24841
24842 ok, number
24843
24844 =back
24845
24846 =head2 Test::Harness::Straps - detailed analysis of test results
24847
24848 =over 4
24849
24850 =item SYNOPSIS
24851
24852 =item DESCRIPTION
24853
24854 =item CONSTRUCTION
24855
24856 =over 4
24857
24858 =item new()
24859
24860 =back
24861
24862 =back
24863
24864 =over 4
24865
24866 =item $strap->_init
24867
24868 =back
24869
24870 =over 4
24871
24872 =item ANALYSIS
24873
24874 =over 4
24875
24876 =item $strap->analyze( $name, \@output_lines )
24877
24878 =back
24879
24880 =back
24881
24882 =over 4
24883
24884 =item $strap->analyze_fh( $name, $test_filehandle )
24885
24886 =back
24887
24888 =over 4
24889
24890 =item $strap->analyze_file( $test_file )
24891
24892 =back
24893
24894 =over 4
24895
24896 =item $strap->_command_line( $file )
24897
24898 =back
24899
24900 =over 4
24901
24902 =item $strap->_command()
24903
24904 =back
24905
24906 =over 4
24907
24908 =item $strap->_switches( $file )
24909
24910 =back
24911
24912 =over 4
24913
24914 =item $strap->_cleaned_switches( @switches_from_user )
24915
24916 =back
24917
24918 =over 4
24919
24920 =item $strap->_INC2PERL5LIB
24921
24922 =back
24923
24924 =over 4
24925
24926 =item $strap->_filtered_INC()
24927
24928 =back
24929
24930 =over 4
24931
24932 =item $strap->_restore_PERL5LIB()
24933
24934 =back
24935
24936 =over 4
24937
24938 =item Parsing
24939
24940 =over 4
24941
24942 =item C<_is_diagnostic>
24943
24944 =back
24945
24946 =back
24947
24948 =over 4
24949
24950 =item C<_is_header>
24951
24952 =back
24953
24954 =over 4
24955
24956 =item C<_is_bail_out>
24957
24958 =back
24959
24960 =over 4
24961
24962 =item C<_reset_file_state>
24963
24964 =back
24965
24966 =over 4
24967
24968 =item Results
24969
24970 =item EXAMPLES
24971
24972 =item AUTHOR
24973
24974 =item SEE ALSO
24975
24976 =back
24977
24978 =head2 Test::Harness::TAP - Documentation for the TAP format
24979
24980 =over 4
24981
24982 =item SYNOPSIS
24983
24984 =item TODO
24985
24986 =item THE TAP FORMAT
24987
24988 =item HARNESS BEHAVIOR
24989
24990 =item TESTS LINES AND THE PLAN
24991
24992 =over 4
24993
24994 =item The plan
24995
24996 =item The test line
24997
24998 C<ok> or C<not ok>, Test number, Description, Directive, ok/not ok
24999 (required), Test number (recommended), Description (recommended), Directive
25000 (only when necessary)
25001
25002 =back
25003
25004 =item DIRECTIVES
25005
25006 =over 4
25007
25008 =item TODO tests
25009
25010 =item Skipping tests
25011
25012 =back
25013
25014 =item OTHER LINES
25015
25016 =over 4
25017
25018 =item Bail out!
25019
25020 =item Diagnostics
25021
25022 =item Anything else
25023
25024 =back
25025
25026 =item EXAMPLES
25027
25028 =over 4
25029
25030 =item Common with explanation
25031
25032 =item Unknown amount and failures
25033
25034 =item Giving up
25035
25036 =item Skipping a few
25037
25038 =item Skipping everything
25039
25040 =item Got spare tuits?
25041
25042 =item Creative liberties
25043
25044 =back
25045
25046 =item AUTHORS
25047
25048 =item ACKNOWLEDGEMENTS
25049
25050 =item COPYRIGHT
25051
25052 =back
25053
25054 =head2 Test::More - yet another framework for writing test scripts
25055
25056 =over 4
25057
25058 =item SYNOPSIS
25059
25060 =item DESCRIPTION
25061
25062 =over 4
25063
25064 =item I love it when a plan comes together
25065
25066 =back
25067
25068 =back
25069
25070 =over 4
25071
25072 =item Test names
25073
25074 =item I'm ok, you're not ok.
25075
25076 B<ok>
25077
25078 =back
25079
25080 B<is>, B<isnt>
25081
25082 B<like>
25083
25084 B<unlike>
25085
25086 B<cmp_ok>
25087
25088 B<can_ok>
25089
25090 B<isa_ok>
25091
25092 B<pass>, B<fail>
25093
25094 =over 4
25095
25096 =item Module tests
25097
25098 B<use_ok>
25099
25100 =back
25101
25102 B<require_ok>
25103
25104 =over 4
25105
25106 =item Complex data structures
25107
25108 B<is_deeply>
25109
25110 =back
25111
25112 =over 4
25113
25114 =item Diagnostics
25115
25116 B<diag>
25117
25118 =back
25119
25120 =over 4
25121
25122 =item Conditional tests
25123
25124 B<SKIP: BLOCK>
25125
25126 =back
25127
25128 B<TODO: BLOCK>, B<todo_skip>
25129
25130 When do I use SKIP vs. TODO?
25131
25132 =over 4
25133
25134 =item Test control
25135
25136 B<BAIL_OUT>
25137
25138 =back
25139
25140 =over 4
25141
25142 =item Discouraged comparison functions
25143
25144 B<eq_array>
25145
25146 =back
25147
25148 B<eq_hash>
25149
25150 B<eq_set>
25151
25152 =over 4
25153
25154 =item Extending and Embedding Test::More
25155
25156 B<builder>
25157
25158 =back
25159
25160 =over 4
25161
25162 =item EXIT CODES
25163
25164 =item CAVEATS and NOTES
25165
25166 Backwards compatibility, Overloaded objects, Threads, Test::Harness upgrade
25167
25168 =item HISTORY
25169
25170 =item SEE ALSO
25171
25172 =item AUTHORS
25173
25174 =item BUGS
25175
25176 =item COPYRIGHT
25177
25178 =back
25179
25180 =head2 Test::Simple - Basic utilities for writing tests.
25181
25182 =over 4
25183
25184 =item SYNOPSIS
25185
25186 =item DESCRIPTION
25187
25188 B<ok>
25189
25190 =back
25191
25192 =over 4
25193
25194 =item EXAMPLE
25195
25196 =item CAVEATS
25197
25198 =item NOTES
25199
25200 =item HISTORY
25201
25202 =item SEE ALSO
25203
25204 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
25205 L<Test::Harness>
25206
25207 =item AUTHORS
25208
25209 =item COPYRIGHT
25210
25211 =back
25212
25213 =head2 Test::Tutorial - A tutorial about writing really basic tests
25214
25215 =over 4
25216
25217 =item DESCRIPTION
25218
25219 =over 4
25220
25221 =item Nuts and bolts of testing.
25222
25223 =item Where to start?
25224
25225 =item Names
25226
25227 =item Test the manual
25228
25229 =item Sometimes the tests are wrong
25230
25231 =item Testing lots of values
25232
25233 =item Informative names
25234
25235 =item Skipping tests
25236
25237 =item Todo tests
25238
25239 =item Testing with taint mode.
25240
25241 =back
25242
25243 =item FOOTNOTES
25244
25245 =item AUTHORS
25246
25247 =item COPYRIGHT
25248
25249 =back
25250
25251 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
25252
25253 =over 4
25254
25255 =item SYNOPSIS
25256
25257 =item DESCRIPTION
25258
25259 =item EXAMPLE
25260
25261 =back
25262
25263 =head2 Text::Balanced - Extract delimited text sequences from strings.
25264
25265 =over 4
25266
25267 =item SYNOPSIS
25268
25269 =item DESCRIPTION
25270
25271 =over 4
25272
25273 =item General behaviour in list contexts
25274
25275 [0], [1], [2]
25276
25277 =item General behaviour in scalar and void contexts
25278
25279 =item A note about prefixes
25280
25281 =item C<extract_delimited>
25282
25283 =item C<extract_bracketed>
25284
25285 =item C<extract_variable>
25286
25287 [0], [1], [2]
25288
25289 =item C<extract_tagged>
25290
25291 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
25292 [0], [1], [2], [3], [4], [5]
25293
25294 =item C<gen_extract_tagged>
25295
25296 =item C<extract_quotelike>
25297
25298 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
25299
25300 =item C<extract_quotelike> and "here documents"
25301
25302 [0], [1], [2], [3], [4], [5], [6], [7..10]
25303
25304 =item C<extract_codeblock>
25305
25306 =item C<extract_multiple>
25307
25308 =item C<gen_delimited_pat>
25309
25310 =back
25311
25312 =item DIAGNOSTICS
25313
25314  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>, 
25315 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
25316 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">, 
25317 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
25318 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
25319 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
25320 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
25321 after dereferencer>, C<Did not find expected opening bracket at %s>,
25322 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
25323 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
25324 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
25325 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
25326 tag>
25327
25328 =item AUTHOR
25329
25330 =item BUGS AND IRRITATIONS
25331
25332 =item COPYRIGHT
25333
25334 =back
25335
25336 =head2 Text::ParseWords - parse text into an array of tokens or array of
25337 arrays
25338
25339 =over 4
25340
25341 =item SYNOPSIS
25342
25343 =item DESCRIPTION
25344
25345 =item EXAMPLES
25346
25347 =item AUTHORS
25348
25349 =back
25350
25351 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
25352 by Knuth
25353
25354 =over 4
25355
25356 =item SYNOPSIS
25357
25358 =item DESCRIPTION
25359
25360 =item EXAMPLES
25361
25362 =item LIMITATIONS
25363
25364 =item AUTHOR
25365
25366 =back
25367
25368 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
25369 unexpand(1)
25370
25371 =over 4
25372
25373 =item SYNOPSIS
25374
25375 =item DESCRIPTION
25376
25377 =item BUGS
25378
25379 =item LICENSE
25380
25381 =back
25382
25383 =head2 Text::Wrap - line wrapping to form simple paragraphs
25384
25385 =over 4
25386
25387 =item SYNOPSIS 
25388
25389 =item DESCRIPTION
25390
25391 =item OVERRIDES
25392
25393 =item EXAMPLE
25394
25395 =item LICENSE
25396
25397 =back
25398
25399 =head2 Thread - manipulate threads in Perl (for old code only)
25400
25401 =over 4
25402
25403 =item CAVEAT
25404
25405 =item SYNOPSIS
25406
25407 =item DESCRIPTION
25408
25409 =item FUNCTIONS
25410
25411 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
25412 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
25413 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
25414
25415 =item METHODS
25416
25417 join, eval, detach, equal, tid, flags, done
25418
25419 =item LIMITATIONS
25420
25421 =item SEE ALSO
25422
25423 =back
25424
25425 =head2 Thread::Queue - thread-safe queues
25426
25427 =over 4
25428
25429 =item SYNOPSIS
25430
25431 =item DESCRIPTION
25432
25433 =item FUNCTIONS AND METHODS
25434
25435 new, enqueue LIST, dequeue, dequeue_nb, pending
25436
25437 =item SEE ALSO
25438
25439 =back
25440
25441 =head2 Thread::Semaphore - thread-safe semaphores
25442
25443 =over 4
25444
25445 =item SYNOPSIS
25446
25447 =item DESCRIPTION
25448
25449 =item FUNCTIONS AND METHODS
25450
25451 new, new NUMBER, down, down NUMBER, up, up NUMBER
25452
25453 =back
25454
25455 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
25456 (for old code)
25457
25458 =over 4
25459
25460 =item CAVEAT
25461
25462 =item SYNOPSIS
25463
25464 =item DESCRIPTION
25465
25466 =item BUGS
25467
25468 =back
25469
25470 =head2 Thread::Specific - thread-specific keys
25471
25472 =over 4
25473
25474 =item SYNOPSIS
25475
25476 =item DESCRIPTION
25477
25478 =back
25479
25480 =head2 Tie::Array - base class for tied arrays
25481
25482 =over 4
25483
25484 =item SYNOPSIS
25485
25486 =item DESCRIPTION
25487
25488 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
25489 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
25490 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
25491 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
25492
25493 =item CAVEATS
25494
25495 =item AUTHOR
25496
25497 =back
25498
25499 =head2 Tie::File - Access the lines of a disk file via a Perl array
25500
25501 =over 4
25502
25503 =item SYNOPSIS
25504
25505 =item DESCRIPTION
25506
25507 =over 4
25508
25509 =item C<recsep>
25510
25511 =item C<autochomp>
25512
25513 =item C<mode>
25514
25515 =item C<memory>
25516
25517 =item C<dw_size>
25518
25519 =item Option Format
25520
25521 =back
25522
25523 =item Public Methods
25524
25525 =over 4
25526
25527 =item C<flock>
25528
25529 =item C<autochomp>
25530
25531 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
25532
25533 =item C<offset>
25534
25535 =back
25536
25537 =item Tying to an already-opened filehandle
25538
25539 =item Deferred Writing
25540
25541 =over 4
25542
25543 =item Autodeferring
25544
25545 =back
25546
25547 =item CONCURRENT ACCESS TO FILES
25548
25549 =item CAVEATS
25550
25551 =item SUBCLASSING
25552
25553 =item WHAT ABOUT C<DB_File>?
25554
25555 =item AUTHOR
25556
25557 =item LICENSE
25558
25559 =item WARRANTY
25560
25561 =item THANKS
25562
25563 =item TODO
25564
25565 =back
25566
25567 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
25568 handles
25569
25570 =over 4
25571
25572 =item SYNOPSIS
25573
25574 =item DESCRIPTION
25575
25576 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
25577 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
25578 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
25579 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
25580
25581 =item MORE INFORMATION
25582
25583 =item COMPATIBILITY
25584
25585 =back
25586
25587 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
25588 tied hashes
25589
25590 =over 4
25591
25592 =item SYNOPSIS
25593
25594 =item DESCRIPTION
25595
25596 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
25597 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR
25598 this, SCALAR this
25599
25600 =item Inheriting from B<Tie::StdHash>
25601
25602 =item Inheriting from B<Tie::ExtraHash>
25603
25604 =item C<SCALAR>, C<UNTIE> and C<DESTROY>
25605
25606 =item MORE INFORMATION
25607
25608 =back
25609
25610 =head2 Tie::Memoize - add data to hash when needed
25611
25612 =over 4
25613
25614 =item SYNOPSIS
25615
25616 =item DESCRIPTION
25617
25618 =item Inheriting from B<Tie::Memoize>
25619
25620 =item EXAMPLE
25621
25622 =item BUGS
25623
25624 =item AUTHOR
25625
25626 =back
25627
25628 =head2 Tie::RefHash - use references as hash keys
25629
25630 =over 4
25631
25632 =item SYNOPSIS
25633
25634 =item DESCRIPTION
25635
25636 =item EXAMPLE
25637
25638 =item AUTHOR
25639
25640 =item VERSION
25641
25642 =item SEE ALSO
25643
25644 =back
25645
25646 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
25647 scalars
25648
25649 =over 4
25650
25651 =item SYNOPSIS
25652
25653 =item DESCRIPTION
25654
25655 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
25656
25657 =item MORE INFORMATION
25658
25659 =back
25660
25661 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
25662
25663 =over 4
25664
25665 =item SYNOPSIS
25666
25667 =item DESCRIPTION
25668
25669 =item CAVEATS
25670
25671 =back
25672
25673 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
25674 timers
25675
25676 =over 4
25677
25678 =item SYNOPSIS
25679
25680 =item DESCRIPTION
25681
25682 gettimeofday (), usleep ( $useconds ), nanosleep ( $nanoseconds ), ualarm (
25683 $useconds [, $interval_useconds ] ), tv_interval, time (), sleep (
25684 $floating_seconds ), alarm ( $floating_seconds [,
25685 $interval_floating_seconds ] ), setitimer ( $which, $floating_seconds [,
25686 $interval_floating_seconds ] ), getitimer ( $which ), clock_gettime (
25687 $which ), clock_getres ( $which ), clock_nanosleep ( $which, $seconds,
25688 $flags = 0), clock()
25689
25690 =item EXAMPLES
25691
25692 =item C API
25693
25694 =item DIAGNOSTICS
25695
25696 =over 4
25697
25698 =item negative time not invented yet
25699
25700 =item internal error: useconds < 0 (unsigned ... signed ...)
25701
25702 =back
25703
25704 =item CAVEATS
25705
25706 =item SEE ALSO
25707
25708 =item AUTHORS
25709
25710 =item COPYRIGHT AND LICENSE
25711
25712 =back
25713
25714 =head2 Time::Local - efficiently compute time from local and GMT time
25715
25716 =over 4
25717
25718 =item SYNOPSIS
25719
25720 =item DESCRIPTION
25721
25722 =over 4
25723
25724 =item Ambiguous Local Times (DST)
25725
25726 =item Non-Existent Local Times (DST)
25727
25728 =item Negative Epoch Values
25729
25730 =back
25731
25732 =item IMPLEMENTATION
25733
25734 =item BUGS
25735
25736 =item SUPPORT
25737
25738 =item AUTHOR
25739
25740 =back
25741
25742 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
25743 function
25744
25745 =over 4
25746
25747 =item SYNOPSIS
25748
25749 =item DESCRIPTION
25750
25751 =item NOTE
25752
25753 =item AUTHOR
25754
25755 =back
25756
25757 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
25758 function
25759
25760 =over 4
25761
25762 =item SYNOPSIS
25763
25764 =item DESCRIPTION
25765
25766 =item NOTE
25767
25768 =item AUTHOR
25769
25770 =back
25771
25772 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
25773
25774 =over 4
25775
25776 =item SYNOPSIS
25777
25778 =item DESCRIPTION
25779
25780 =item AUTHOR
25781
25782 =back
25783
25784 =head2 UNIVERSAL - base class for ALL classes (blessed references)
25785
25786 =over 4
25787
25788 =item SYNOPSIS
25789
25790 =item DESCRIPTION
25791
25792 C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<< eval { VAL->isa(
25793 TYPE ) } >>, C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD )
25794 >>, C<< CLASS->can( METHOD ) >>, C<< eval { VAL->can( METHOD ) } >>,
25795 C<VERSION ( [ REQUIRE ] )>
25796
25797 =item EXPORTS
25798
25799 =back
25800
25801 =head2 Unicode::Collate - Unicode Collation Algorithm
25802
25803 =over 4
25804
25805 =item SYNOPSIS
25806
25807 =item DESCRIPTION
25808
25809 =over 4
25810
25811 =item Constructor and Tailoring
25812
25813 UCA_Version, alternate, backwards, entry, hangul_terminator, ignoreChar,
25814 ignoreName, katakana_before_hiragana, level, normalization, overrideCJK,
25815 overrideHangul, preprocess, rearrange, table, undefChar, undefName,
25816 upper_before_lower, variable
25817
25818 =item Methods for Collation
25819
25820 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
25821 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
25822 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
25823 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
25824 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
25825 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
25826 $Collator-E<gt>viewSortKey($string)>
25827
25828 =item Methods for Searching
25829
25830 C<$position = $Collator-E<gt>index($string, $substring[, $position])>,
25831 C<($position, $length) = $Collator-E<gt>index($string, $substring[,
25832 $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>,
25833 C<($match)   = $Collator-E<gt>match($string, $substring)>, C<@match =
25834 $Collator-E<gt>gmatch($string, $substring)>, C<$count =
25835 $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count =
25836 $Collator-E<gt>gsubst($string, $substring, $replacement)>
25837
25838 =item Other Methods
25839
25840 C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, C<$version =
25841 $Collator-E<gt>version()>, C<UCA_Version()>, C<Base_Unicode_Version()>
25842
25843 =back
25844
25845 =item EXPORT
25846
25847 =item INSTALL
25848
25849 =item CAVEATS
25850
25851 Normalization, Conformance Test
25852
25853 =item AUTHOR, COPYRIGHT AND LICENSE
25854
25855 =item SEE ALSO
25856
25857 Unicode Collation Algorithm - UTS #10, The Default Unicode Collation
25858 Element Table (DUCET), The conformance test for the UCA, Hangul Syllable
25859 Type, Unicode Normalization Forms - UAX #15
25860
25861 =back
25862
25863 =head2 Unicode::Normalize - Unicode Normalization Forms
25864
25865 =over 4
25866
25867 =item SYNOPSIS
25868
25869 =item DESCRIPTION
25870
25871 =over 4
25872
25873 =item Normalization Forms
25874
25875 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
25876 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
25877 C<$FCD_string = FCD($string)>, C<$FCC_string = FCC($string)>,
25878 C<$normalized_string = normalize($form_name, $string)>
25879
25880 =item Decomposition and Composition
25881
25882 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
25883 decompose($string, $useCompatMapping)>, C<$reordered_string  =
25884 reorder($string)>, C<$composed_string   = compose($string)>
25885
25886 =item Quick Check
25887
25888 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
25889 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
25890 checkFCD($string)>, C<$result = checkFCC($string)>, C<$result =
25891 check($form_name, $string)>
25892
25893 =item Character Data
25894
25895 C<$canonical_decomposed = getCanon($codepoint)>,
25896 C<$compatibility_decomposed = getCompat($codepoint)>,
25897 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
25898 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
25899 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
25900 C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>,
25901 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
25902
25903 =back
25904
25905 =item EXPORT
25906
25907 =item CAVEATS
25908
25909 Perl's version vs. Unicode version, Correction of decomposition mapping,
25910 Revised definition of canonical composition
25911
25912 =item AUTHOR
25913
25914 =item SEE ALSO
25915
25916 http://www.unicode.org/reports/tr15/,
25917 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt,
25918 http://www.unicode.org/Public/UNIDATA/NormalizationCorrections.txt,
25919 http://www.unicode.org/review/pr-29.html, http://www.unicode.org/notes/tn5/
25920
25921 =back
25922
25923 =head2 Unicode::UCD - Unicode character database
25924
25925 =over 4
25926
25927 =item SYNOPSIS
25928
25929 =item DESCRIPTION
25930
25931 =back
25932
25933 =over 4
25934
25935 =item charinfo
25936
25937 =back
25938
25939 =over 4
25940
25941 =item charblock
25942
25943 =back
25944
25945 =over 4
25946
25947 =item charscript
25948
25949 =back
25950
25951 =over 4
25952
25953 =item charblocks
25954
25955 =back
25956
25957 =over 4
25958
25959 =item charscripts
25960
25961 =back
25962
25963 =over 4
25964
25965 =item Blocks versus Scripts
25966
25967 =item Matching Scripts and Blocks
25968
25969 =item Code Point Arguments
25970
25971 =item charinrange
25972
25973 =back
25974
25975 =over 4
25976
25977 =item compexcl
25978
25979 =back
25980
25981 =over 4
25982
25983 =item casefold
25984
25985 =back
25986
25987 =over 4
25988
25989 =item casespec
25990
25991 =back
25992
25993 =over 4
25994
25995 =item namedseq()
25996
25997 =back
25998
25999 =over 4
26000
26001 =item Unicode::UCD::UnicodeVersion
26002
26003 =back
26004
26005 =over 4
26006
26007 =item Implementation Note
26008
26009 =back
26010
26011 =over 4
26012
26013 =item BUGS
26014
26015 =item AUTHOR
26016
26017 =back
26018
26019 =head2 User::grent - by-name interface to Perl's built-in getgr*()
26020 functions
26021
26022 =over 4
26023
26024 =item SYNOPSIS
26025
26026 =item DESCRIPTION
26027
26028 =item NOTE
26029
26030 =item AUTHOR
26031
26032 =back
26033
26034 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
26035 functions
26036
26037 =over 4
26038
26039 =item SYNOPSIS
26040
26041 =item DESCRIPTION
26042
26043 =over 4
26044
26045 =item System Specifics
26046
26047 =back
26048
26049 =item NOTE
26050
26051 =item AUTHOR
26052
26053 =item HISTORY
26054
26055 March 18th, 2000
26056
26057 =back
26058
26059 =head2 XSLoader - Dynamically load C libraries into Perl code
26060
26061 =over 4
26062
26063 =item VERSION
26064
26065 =item SYNOPSIS
26066
26067 =item DESCRIPTION
26068
26069 =over 4
26070
26071 =item Migration from C<DynaLoader>
26072
26073 =item Backward compatible boilerplate
26074
26075 =back
26076
26077 =item Order of initialization: early load()
26078
26079 =over 4
26080
26081 =item The most hairy case
26082
26083 =back
26084
26085 =item DIAGNOSTICS
26086
26087 Can't find '%s' symbol in %s, Can't load '%s' for module %s: %s, Undefined
26088 symbols present after loading %s: %s, XSLoader::load('Your::Module',
26089 $Your::Module::VERSION)
26090
26091 =item LIMITATIONS
26092
26093 =item BUGS
26094
26095 =item SEE ALSO
26096
26097 =item AUTHORS
26098
26099 =item COPYRIGHT
26100
26101 =back
26102
26103 =head1 AUXILIARY DOCUMENTATION
26104
26105 Here should be listed all the extra programs' documentation, but they
26106 don't all have manual pages yet:
26107
26108 =over 4
26109
26110 =item a2p
26111
26112 =item c2ph
26113
26114 =item dprofpp
26115
26116 =item h2ph
26117
26118 =item h2xs
26119
26120 =item perlbug
26121
26122 =item perldoc
26123
26124 =item pl2pm
26125
26126 =item pod2html
26127
26128 =item pod2man
26129
26130 =item s2p
26131
26132 =item splain
26133
26134 =item xsubpp
26135
26136 =back
26137
26138 =head1 AUTHOR
26139
26140 Larry Wall <F<larry@wall.org>>, with the help of oodles
26141 of other folks.
26142