6878ef8a555dc2bf73f1455f15d7b98014c0552b
[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 c, constant - Perl pragma to declare constants
10810
10811 =over 4
10812
10813 =item SYNOPSIS
10814
10815 =item DESCRIPTION
10816
10817 =item NOTES
10818
10819 =over 4
10820
10821 =item List constants
10822
10823 =item Defining multiple constants at once
10824
10825 =item Magic constants
10826
10827 =back
10828
10829 =item TECHNICAL NOTES
10830
10831 =item BUGS
10832
10833 =item AUTHOR
10834
10835 =item COPYRIGHT
10836
10837 =back
10838
10839 =head2 charnames - define character names for C<\N{named}> string literal
10840 escapes
10841
10842 =over 4
10843
10844 =item SYNOPSIS
10845
10846 =item DESCRIPTION
10847
10848 =item CUSTOM TRANSLATORS
10849
10850 =item CUSTOM ALIASES
10851
10852 =over 4
10853
10854 =item Anonymous hashes
10855
10856 =item Alias file
10857
10858 =item Alias shortcut
10859
10860 =back
10861
10862 =item charnames::viacode(code)
10863
10864 =item charnames::vianame(name)
10865
10866 =item ALIASES
10867
10868 =item ILLEGAL CHARACTERS
10869
10870 =item BUGS
10871
10872 =back
10873
10874 =head2 constant - Perl pragma to declare constants
10875
10876 =over 4
10877
10878 =item SYNOPSIS
10879
10880 =item DESCRIPTION
10881
10882 =item NOTES
10883
10884 =over 4
10885
10886 =item List constants
10887
10888 =item Defining multiple constants at once
10889
10890 =item Magic constants
10891
10892 =back
10893
10894 =item TECHNICAL NOTES
10895
10896 =item BUGS
10897
10898 =item AUTHOR
10899
10900 =item COPYRIGHT
10901
10902 =back
10903
10904 =head2 diagnostics, splain - produce verbose warning diagnostics
10905
10906 =over 4
10907
10908 =item SYNOPSIS
10909
10910 =item DESCRIPTION
10911
10912 =over 4
10913
10914 =item The C<diagnostics> Pragma
10915
10916 =item The I<splain> Program
10917
10918 =back
10919
10920 =item EXAMPLES
10921
10922 =item INTERNALS
10923
10924 =item BUGS
10925
10926 =item AUTHOR
10927
10928 =back
10929
10930 =head2 encoding - allows you to write your script in non-ascii or non-utf8
10931
10932 =over 4
10933
10934 =item SYNOPSIS
10935
10936 =item ABSTRACT
10937
10938 =over 4
10939
10940 =item Literal Conversions
10941
10942 =item PerlIO layers for C<STD(IN|OUT)>
10943
10944 =item Implicit upgrading for byte strings
10945
10946 =back
10947
10948 =item FEATURES THAT REQUIRE 5.8.1
10949
10950 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
10951
10952 =item USAGE
10953
10954 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
10955 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
10956
10957 =item The Filter Option
10958
10959 =over 4
10960
10961 =item Filter-related changes at Encode version 1.87
10962
10963 =back
10964
10965 =item CAVEATS
10966
10967 =over 4
10968
10969 =item NOT SCOPED
10970
10971 =item DO NOT MIX MULTIPLE ENCODINGS
10972
10973 =item tr/// with ranges
10974
10975 Legend of characters above
10976
10977 =back
10978
10979 =item EXAMPLE - Greekperl
10980
10981 =item KNOWN PROBLEMS
10982
10983 literals in regex that are longer than 127 bytes, EBCDIC, format
10984
10985 =over 4
10986
10987 =item The Logic of :locale
10988
10989 =back
10990
10991 =item HISTORY
10992
10993 =item SEE ALSO
10994
10995 =back
10996
10997 =head2 encoding::warnings - Warn on implicit encoding conversions
10998
10999 =over 4
11000
11001 =item VERSION
11002
11003 =item SYNOPSIS
11004
11005 =item DESCRIPTION
11006
11007 =over 4
11008
11009 =item Overview of the problem
11010
11011 =item Detecting the problem
11012
11013 =item Solving the problem
11014
11015 Upgrade both sides to unicode-strings, Downgrade both sides to
11016 byte-strings, Specify the encoding for implicit byte-string upgrading,
11017 PerlIO layers for B<STDIN> and B<STDOUT>, Literal conversions, Implicit
11018 upgrading for byte-strings
11019
11020 =back
11021
11022 =item CAVEATS
11023
11024 =back
11025
11026 =over 4
11027
11028 =item SEE ALSO
11029
11030 =item AUTHORS
11031
11032 =item COPYRIGHT
11033
11034 =back
11035
11036 =head2 feature - Perl pragma to enable new syntactic features
11037
11038 =over 4
11039
11040 =item SYNOPSIS
11041
11042 =item DESCRIPTION
11043
11044 =over 4
11045
11046 =item The 'switch' feature
11047
11048 =item The '~~' feature
11049
11050 =item The 'say' feature
11051
11052 =item the 'err' feature
11053
11054 =back
11055
11056 =item FEATURE BUNDLES
11057
11058 =back
11059
11060 =head2 fields - compile-time class fields
11061
11062 =over 4
11063
11064 =item SYNOPSIS
11065
11066 =item DESCRIPTION
11067
11068 new, phash
11069
11070 =item SEE ALSO
11071
11072 =back
11073
11074 =head2 filetest - Perl pragma to control the filetest permission operators
11075
11076 =over 4
11077
11078 =item SYNOPSIS
11079
11080 =item DESCRIPTION
11081
11082 =over 4
11083
11084 =item subpragma access
11085
11086 =back
11087
11088 =back
11089
11090 =head2 if - C<use> a Perl module if a condition holds
11091
11092 =over 4
11093
11094 =item SYNOPSIS
11095
11096 =item DESCRIPTION
11097
11098 =item BUGS
11099
11100 =item AUTHOR
11101
11102 =back
11103
11104 =head2 integer - Perl pragma to use integer arithmetic instead of floating
11105 point
11106
11107 =over 4
11108
11109 =item SYNOPSIS
11110
11111 =item DESCRIPTION
11112
11113 =back
11114
11115 =head2 less - perl pragma to request less of something from the compiler
11116
11117 =over 4
11118
11119 =item SYNOPSIS
11120
11121 =item DESCRIPTION
11122
11123 =back
11124
11125 =head2 lib - manipulate @INC at compile time
11126
11127 =over 4
11128
11129 =item SYNOPSIS
11130
11131 =item DESCRIPTION
11132
11133 =over 4
11134
11135 =item Adding directories to @INC
11136
11137 =item Deleting directories from @INC
11138
11139 =item Restoring original @INC
11140
11141 =back
11142
11143 =item CAVEATS
11144
11145 =item NOTES
11146
11147 =item SEE ALSO
11148
11149 =item AUTHOR
11150
11151 =back
11152
11153 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
11154 operations
11155
11156 =over 4
11157
11158 =item SYNOPSIS
11159
11160 =item DESCRIPTION
11161
11162 =back
11163
11164 =head2 open - perl pragma to set default PerlIO layers for input and output
11165
11166 =over 4
11167
11168 =item SYNOPSIS
11169
11170 =item DESCRIPTION
11171
11172 =item NONPERLIO FUNCTIONALITY
11173
11174 =item IMPLEMENTATION DETAILS
11175
11176 =item SEE ALSO
11177
11178 =back
11179
11180 =head2 ops - Perl pragma to restrict unsafe operations when compiling
11181
11182 =over 4
11183
11184 =item SYNOPSIS  
11185
11186 =item DESCRIPTION
11187
11188 =item SEE ALSO
11189
11190 =back
11191
11192 =head2 overload - Package for overloading Perl operations
11193
11194 =over 4
11195
11196 =item SYNOPSIS
11197
11198 =item DESCRIPTION
11199
11200 =over 4
11201
11202 =item Declaration of overloaded functions
11203
11204 =item Calling Conventions for Binary Operations
11205
11206 FALSE, TRUE, C<undef>
11207
11208 =item Calling Conventions for Unary Operations
11209
11210 =item Calling Conventions for Mutators
11211
11212 C<++> and C<-->, C<x=> and other assignment versions
11213
11214 =item Overloadable Operations
11215
11216 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
11217 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
11218 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
11219
11220 =item Inheritance and overloading
11221
11222 Strings as values of C<use overload> directive, Overloading of an operation
11223 is inherited by derived classes
11224
11225 =back
11226
11227 =item SPECIAL SYMBOLS FOR C<use overload>
11228
11229 =over 4
11230
11231 =item Last Resort
11232
11233 =item Fallback
11234
11235 =item Smart Match
11236
11237 C<undef>, TRUE, defined, but FALSE
11238
11239 =item Copy Constructor
11240
11241 B<Example>
11242
11243 =back
11244
11245 =item MAGIC AUTOGENERATION
11246
11247 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
11248 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
11249 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
11250 I<Copy operator>
11251
11252 =item Losing overloading
11253
11254 =item Run-time Overloading
11255
11256 =item Public functions
11257
11258 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
11259
11260 =item Overloading constants
11261
11262 integer, float, binary, q, qr
11263
11264 =item IMPLEMENTATION
11265
11266 =item Metaphor clash
11267
11268 =item Cookbook
11269
11270 =over 4
11271
11272 =item Two-face scalars
11273
11274 =item Two-face references
11275
11276 =item Symbolic calculator
11277
11278 =item I<Really> symbolic calculator
11279
11280 =back
11281
11282 =item AUTHOR
11283
11284 =item DIAGNOSTICS
11285
11286 Odd number of arguments for overload::constant, `%s' is not an overloadable
11287 type, `%s' is not a code reference
11288
11289 =item BUGS
11290
11291 =back
11292
11293 =head2 sigtrap - Perl pragma to enable simple signal handling
11294
11295 =over 4
11296
11297 =item SYNOPSIS
11298
11299 =item DESCRIPTION
11300
11301 =item OPTIONS
11302
11303 =over 4
11304
11305 =item SIGNAL HANDLERS
11306
11307 B<stack-trace>, B<die>, B<handler> I<your-handler>
11308
11309 =item SIGNAL LISTS
11310
11311 B<normal-signals>, B<error-signals>, B<old-interface-signals>
11312
11313 =item OTHER
11314
11315 B<untrapped>, B<any>, I<signal>, I<number>
11316
11317 =back
11318
11319 =item EXAMPLES
11320
11321 =back
11322
11323 =head2 sort - perl pragma to control sort() behaviour
11324
11325 =over 4
11326
11327 =item SYNOPSIS
11328
11329 =item DESCRIPTION
11330
11331 =item CAVEATS
11332
11333 =back
11334
11335 =head2 strict - Perl pragma to restrict unsafe constructs
11336
11337 =over 4
11338
11339 =item SYNOPSIS
11340
11341 =item DESCRIPTION
11342
11343 C<strict refs>, C<strict vars>, C<strict subs>
11344
11345 =item HISTORY
11346
11347 =back
11348
11349 =head2 subs - Perl pragma to predeclare sub names
11350
11351 =over 4
11352
11353 =item SYNOPSIS
11354
11355 =item DESCRIPTION
11356
11357 =back
11358
11359 =head2 threadshared, threads::shared - Perl extension for sharing data
11360 structures between threads
11361
11362 =over 4
11363
11364 =item SYNOPSIS
11365
11366 =item DESCRIPTION
11367
11368 =item EXPORT
11369
11370 =item FUNCTIONS
11371
11372 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
11373 LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
11374 ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
11375
11376 =item NOTES
11377
11378 =item BUGS
11379
11380 =item AUTHOR
11381
11382 =item SEE ALSO
11383
11384 =back
11385
11386 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
11387 code
11388
11389 =over 4
11390
11391 =item SYNOPSIS
11392
11393 =item DESCRIPTION
11394
11395 =over 4
11396
11397 =item Utility functions
11398
11399 $num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[,
11400 FAIL_OK]), utf8::encode($string), utf8::decode($string), $flag =
11401 utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
11402
11403 =back
11404
11405 =item BUGS
11406
11407 =item SEE ALSO
11408
11409 =back
11410
11411 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
11412
11413 =over 4
11414
11415 =item SYNOPSIS
11416
11417 =item DESCRIPTION
11418
11419 =back
11420
11421 =head2 version - Perl extension for Version Objects
11422
11423 =over 4
11424
11425 =item SYNOPSIS
11426
11427 =item DESCRIPTION
11428
11429 =over 4
11430
11431 =item BEST PRACTICES
11432
11433 Be consistent, Be careful
11434
11435 =item What IS a version
11436
11437 Numeric Versions, Extended Versions
11438
11439 =item Numeric Versions
11440
11441 =item Extended Versions
11442
11443 =item Numeric Alpha Versions
11444
11445 =item Object Methods
11446
11447 New Operator, qv(), Normal Form, Numification, Stringification, Comparison
11448 operators, Logical Operators
11449
11450 =item Quoting
11451
11452 =item What about v-strings?
11453
11454 =item Types of Versions Objects
11455
11456 Ordinary versions, Alpha Versions
11457
11458 =item Replacement UNIVERSAL::VERSION
11459
11460 =back
11461
11462 =item SUBCLASSING
11463
11464 =item EXPORT
11465
11466 =item AUTHOR
11467
11468 =item SEE ALSO
11469
11470 =back
11471
11472 =head2 vmsish - Perl pragma to control VMS-specific language features
11473
11474 =over 4
11475
11476 =item SYNOPSIS
11477
11478 =item DESCRIPTION
11479
11480 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
11481
11482 =back
11483
11484 =head2 warnings - Perl pragma to control optional warnings
11485
11486 =over 4
11487
11488 =item SYNOPSIS
11489
11490 =item DESCRIPTION
11491
11492 use warnings::register, warnings::enabled(), warnings::enabled($category),
11493 warnings::enabled($object), warnings::warn($message),
11494 warnings::warn($category, $message), warnings::warn($object, $message),
11495 warnings::warnif($message), warnings::warnif($category, $message),
11496 warnings::warnif($object, $message)
11497
11498 =back
11499
11500 =head2 warnings::register - warnings import function
11501
11502 =over 4
11503
11504 =item SYNOPSIS
11505
11506 =item DESCRIPTION
11507
11508 =back
11509
11510 =head1 MODULE DOCUMENTATION
11511
11512 =head2 AnyDBM_File - provide framework for multiple DBMs
11513
11514 =over 4
11515
11516 =item SYNOPSIS
11517
11518 =item DESCRIPTION
11519
11520 =over 4
11521
11522 =item DBM Comparisons
11523
11524 [0], [1], [2], [3]
11525
11526 =back
11527
11528 =item SEE ALSO
11529
11530 =back
11531
11532 =head2 Archive::Tar - module for manipulations of tar archives
11533
11534 =over 4
11535
11536 =item SYNOPSIS
11537
11538 =item DESCRIPTION
11539
11540 =item Object Methods
11541
11542 =over 4
11543
11544 =item Archive::Tar->new( [$file, $compressed] )
11545
11546 =back
11547
11548 =back
11549
11550 =over 4
11551
11552 =item $tar->read ( $filename|$handle, $compressed, {opt => 'val'} )
11553
11554 limit, extract
11555
11556 =back
11557
11558 =over 4
11559
11560 =item $tar->contains_file( $filename )
11561
11562 =back
11563
11564 =over 4
11565
11566 =item $tar->extract( [@filenames] )
11567
11568 =back
11569
11570 =over 4
11571
11572 =item $tar->extract_file( $file, [$extract_path] )
11573
11574 =back
11575
11576 =over 4
11577
11578 =item $tar->list_files( [\@properties] )
11579
11580 =back
11581
11582 =over 4
11583
11584 =item $tar->get_files( [@filenames] )
11585
11586 =back
11587
11588 =over 4
11589
11590 =item $tar->get_content( $file )
11591
11592 =back
11593
11594 =over 4
11595
11596 =item $tar->replace_content( $file, $content )
11597
11598 =back
11599
11600 =over 4
11601
11602 =item $tar->rename( $file, $new_name )
11603
11604 =back
11605
11606 =over 4
11607
11608 =item $tar->remove (@filenamelist)
11609
11610 =back
11611
11612 =over 4
11613
11614 =item $tar->clear
11615
11616 =back
11617
11618 =over 4
11619
11620 =item $tar->write ( [$file, $compressed, $prefix] )
11621
11622 =back
11623
11624 =over 4
11625
11626 =item $tar->add_files( @filenamelist )
11627
11628 =back
11629
11630 =over 4
11631
11632 =item $tar->add_data ( $filename, $data, [$opthashref] )
11633
11634 =back
11635
11636 =over 4
11637
11638 =item $tar->error( [$BOOL] )
11639
11640 =back
11641
11642 =over 4
11643
11644 =item $bool = $tar->has_io_string
11645
11646 =back
11647
11648 =over 4
11649
11650 =item $bool = $tar->has_perlio
11651
11652 =back
11653
11654 =over 4
11655
11656 =item Class Methods
11657
11658 =over 4
11659
11660 =item Archive::Tar->create_archive($file, $compression, @filelist)
11661
11662 =back
11663
11664 =back
11665
11666 =over 4
11667
11668 =item Archive::Tar->list_archive ($file, $compressed, [\@properties])
11669
11670 =back
11671
11672 =over 4
11673
11674 =item Archive::Tar->extract_archive ($file, $gzip)
11675
11676 =back
11677
11678 =over 4
11679
11680 =item Archive::Tar->can_handle_compressed_files
11681
11682 =back
11683
11684 =over 4
11685
11686 =item GLOBAL VARIABLES
11687
11688 =over 4
11689
11690 =item $Archive::Tar::FOLLOW_SYMLINK
11691
11692 =item $Archive::Tar::CHOWN
11693
11694 =item $Archive::Tar::CHMOD
11695
11696 =item $Archive::Tar::DO_NOT_USE_PREFIX
11697
11698 =item $Archive::Tar::DEBUG
11699
11700 =item $Archive::Tar::WARN
11701
11702 =item $Archive::Tar::error
11703
11704 =item $Archive::Tar::HAS_PERLIO
11705
11706 =item $Archive::Tar::HAS_IO_STRING
11707
11708 =back
11709
11710 =item FAQ
11711
11712 What's the minimum perl version required to run Archive::Tar?, Isn't
11713 Archive::Tar slow?, Isn't Archive::Tar heavier on memory than /bin/tar?,
11714 Can't you lazy-load data instead?, How much memory will an X kb tar file
11715 need?, What do you do with unsupported filetypes in an archive?, How do I
11716 access .tar.Z files?
11717
11718 =item TODO
11719
11720 Check if passed in handles are open for read/write
11721
11722 =item AUTHOR
11723
11724 =item ACKNOWLEDGEMENTS
11725
11726 =item COPYRIGHT
11727
11728 =back
11729
11730 =head2 Archive::Tar::File - a subclass for in-memory extracted file from
11731 Archive::Tar
11732
11733 =over 4
11734
11735 =item SYNOPSIS
11736
11737 =item DESCRIPTION
11738
11739 =over 4
11740
11741 =item Accessors
11742
11743 name, mode, uid, gid, size, mtime, chksum, type, linkname, magic, version,
11744 uname, gname, devmajor, devminor, prefix, raw
11745
11746 =back
11747
11748 =item Methods
11749
11750 =over 4
11751
11752 =item new( file => $path )
11753
11754 =item new( data => $path, $data, $opt )
11755
11756 =item new( chunk => $chunk )
11757
11758 =back
11759
11760 =back
11761
11762 =over 4
11763
11764 =item full_path
11765
11766 =back
11767
11768 =over 4
11769
11770 =item validate
11771
11772 =back
11773
11774 =over 4
11775
11776 =item has_content
11777
11778 =back
11779
11780 =over 4
11781
11782 =item get_content
11783
11784 =back
11785
11786 =over 4
11787
11788 =item get_content_by_ref
11789
11790 =back
11791
11792 =over 4
11793
11794 =item replace_content( $content )
11795
11796 =back
11797
11798 =over 4
11799
11800 =item rename( $new_name )
11801
11802 =back
11803
11804 =over 4
11805
11806 =item Convenience methods
11807
11808 is_file, is_dir, is_hardlink, is_symlink, is_chardev, is_blockdev, is_fifo,
11809 is_socket, is_longlink, is_label, is_unknown
11810
11811 =back
11812
11813 =head2 Attribute::Handlers - Simpler definition of attribute handlers
11814
11815 =over 4
11816
11817 =item VERSION
11818
11819 =item SYNOPSIS
11820
11821 =item DESCRIPTION
11822
11823 [0], [1], [2], [3], [4], [5]
11824
11825 =over 4
11826
11827 =item Typed lexicals
11828
11829 =item Type-specific attribute handlers
11830
11831 =item Non-interpretive attribute handlers
11832
11833 =item Phase-specific attribute handlers
11834
11835 =item Attributes as C<tie> interfaces
11836
11837 =back
11838
11839 =item EXAMPLES
11840
11841 =item DIAGNOSTICS
11842
11843 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
11844 attributes>, C<Declaration of %s attribute in package %s may clash with
11845 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
11846 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
11847 be able to apply END handler>
11848
11849 =item AUTHOR
11850
11851 =item BUGS
11852
11853 =item COPYRIGHT
11854
11855 =back
11856
11857 =head2 AutoLoader - load subroutines only on demand
11858
11859 =over 4
11860
11861 =item SYNOPSIS
11862
11863 =item DESCRIPTION
11864
11865 =over 4
11866
11867 =item Subroutine Stubs
11868
11869 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
11870
11871 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
11872
11873 =item Package Lexicals
11874
11875 =item Not Using AutoLoader
11876
11877 =item B<AutoLoader> vs. B<SelfLoader>
11878
11879 =back
11880
11881 =item CAVEATS
11882
11883 =item SEE ALSO
11884
11885 =back
11886
11887 =head2 AutoSplit - split a package for autoloading
11888
11889 =over 4
11890
11891 =item SYNOPSIS
11892
11893 =item DESCRIPTION
11894
11895 $keep, $check, $modtime
11896
11897 =over 4
11898
11899 =item Multiple packages
11900
11901 =back
11902
11903 =item DIAGNOSTICS
11904
11905 =back
11906
11907 =head2 B - The Perl Compiler
11908
11909 =over 4
11910
11911 =item SYNOPSIS
11912
11913 =item DESCRIPTION
11914
11915 =item OVERVIEW
11916
11917 =item Utility Functions
11918
11919 =over 4
11920
11921 =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV>
11922 objects
11923
11924 sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av,
11925 check_av, begin_av, end_av, comppadlist, regex_padav, main_cv
11926
11927 =item Functions for Examining the Symbol Table
11928
11929 walksymtable(SYMREF, METHOD, RECURSE, PREFIX)
11930
11931 =item Functions Returning C<B::OP> objects or for walking op trees
11932
11933 main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG)
11934
11935 =item Miscellaneous Utility Functions
11936
11937 ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR),
11938 perlstring(STR), class(OBJ), threadsv_names
11939
11940 =back
11941
11942 =item OVERVIEW OF CLASSES
11943
11944 =over 4
11945
11946 =item SV-RELATED CLASSES
11947
11948 =item B::SV Methods
11949
11950 REFCNT, FLAGS, object_2svref
11951
11952 =item B::IV Methods
11953
11954 IV, IVX, UVX, int_value, needs64bits, packiv
11955
11956 =item B::NV Methods
11957
11958 NV, NVX
11959
11960 =item B::RV Methods
11961
11962 RV
11963
11964 =item B::PV Methods
11965
11966 PV, RV, PVX
11967
11968 =item B::PVMG Methods
11969
11970 MAGIC, SvSTASH
11971
11972 =item B::MAGIC Methods
11973
11974 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
11975
11976 =item B::PVLV Methods
11977
11978 TARGOFF, TARGLEN, TYPE, TARG
11979
11980 =item B::BM Methods
11981
11982 USEFUL, PREVIOUS, RARE, TABLE
11983
11984 =item B::GV Methods
11985
11986 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
11987 LINE, FILE, FILEGV, GvREFCNT, FLAGS
11988
11989 =item B::IO Methods
11990
11991 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
11992 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
11993
11994 =item B::AV Methods
11995
11996 FILL, MAX, ARRAY, ARRAYelt, OFF, AvFLAGS
11997
11998 =item B::CV Methods
11999
12000 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB,
12001 XSUBANY, CvFLAGS, const_sv
12002
12003 =item B::HV Methods
12004
12005 FILL, MAX, KEYS, RITER, NAME, ARRAY, PMROOT
12006
12007 =item OP-RELATED CLASSES
12008
12009 =item B::OP Methods
12010
12011 next, sibling, name, ppaddr, desc, targ, type, opt, static, flags, private,
12012 spare
12013
12014 =item B::UNOP METHOD
12015
12016 first
12017
12018 =item B::BINOP METHOD
12019
12020 last
12021
12022 =item B::LOGOP METHOD
12023
12024 other
12025
12026 =item B::LISTOP METHOD
12027
12028 children
12029
12030 =item B::PMOP Methods
12031
12032 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
12033 pmpermflags, precomp, pmoffset
12034
12035 =item B::SVOP METHOD
12036
12037 sv, gv
12038
12039 =item B::PADOP METHOD
12040
12041 padix
12042
12043 =item B::PVOP METHOD
12044
12045 pv
12046
12047 =item B::LOOP Methods
12048
12049 redoop, nextop, lastop
12050
12051 =item B::COP Methods
12052
12053 label, stash, stashpv, file, cop_seq, arybase, line, warnings, io
12054
12055 =back
12056
12057 =item AUTHOR
12058
12059 =back
12060
12061 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
12062 bytecode
12063
12064 =over 4
12065
12066 =item SYNOPSIS
12067
12068 =item DESCRIPTION
12069
12070 %insn_data, @insn_name, @optype, @specialsv_name
12071
12072 =item AUTHOR
12073
12074 =back
12075
12076 =head2 B::Assembler - Assemble Perl bytecode
12077
12078 =over 4
12079
12080 =item SYNOPSIS
12081
12082 =item DESCRIPTION
12083
12084 =item AUTHORS
12085
12086 =back
12087
12088 =head2 B::Bblock - Walk basic blocks
12089
12090 =over 4
12091
12092 =item SYNOPSIS
12093
12094 =item DESCRIPTION
12095
12096 =over 4
12097
12098 =item Functions
12099
12100 B<find_leaders>
12101
12102 =back
12103
12104 =item AUTHOR
12105
12106 =back
12107
12108 =head2 B::Bytecode - Perl compiler's bytecode backend
12109
12110 =over 4
12111
12112 =item SYNOPSIS
12113
12114 =item DESCRIPTION
12115
12116 =item EXAMPLE
12117
12118 =item OPTIONS
12119
12120 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
12121
12122 =item KNOWN BUGS
12123
12124 =item NOTICE
12125
12126 =item AUTHORS
12127
12128 =back
12129
12130 =head2 B::C - Perl compiler's C backend
12131
12132 =over 4
12133
12134 =item SYNOPSIS
12135
12136 =item DESCRIPTION
12137
12138 =item OPTIONS
12139
12140 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
12141 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
12142 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
12143 B<-llimit>
12144
12145 =item EXAMPLES
12146
12147 =item BUGS
12148
12149 =item AUTHOR
12150
12151 =back
12152
12153 =head2 B::CC - Perl compiler's optimized C translation backend
12154
12155 =over 4
12156
12157 =item SYNOPSIS
12158
12159 =item DESCRIPTION
12160
12161 =item OPTIONS
12162
12163 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
12164 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
12165 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
12166
12167 =item EXAMPLES
12168
12169 =item BUGS
12170
12171 =item DIFFERENCES
12172
12173 =over 4
12174
12175 =item Loops
12176
12177 =item Context of ".."
12178
12179 =item Arithmetic
12180
12181 =item Deprecated features
12182
12183 =back
12184
12185 =item AUTHOR
12186
12187 =back
12188
12189 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
12190
12191 =over 4
12192
12193 =item SYNOPSIS
12194
12195 =item DESCRIPTION
12196
12197 =item EXAMPLE
12198
12199 =item OPTIONS
12200
12201 =over 4
12202
12203 =item Options for Opcode Ordering
12204
12205 B<-basic>, B<-exec>, B<-tree>
12206
12207 =item Options for Line-Style
12208
12209 B<-concise>, B<-terse>, B<-linenoise>, B<-debug>, B<-env>
12210
12211 =item Options for tree-specific formatting
12212
12213 B<-compact>, B<-loose>, B<-vt>, B<-ascii>
12214
12215 =item Options controlling sequence numbering
12216
12217 B<-base>I<n>, B<-bigendian>, B<-littleendian>
12218
12219 =item Other options
12220
12221 B<-main>, B<-nomain>, B<-nobanner>, B<-banner>, B<-banneris> => subref
12222
12223 =item Option Stickiness
12224
12225 =back
12226
12227 =item ABBREVIATIONS
12228
12229 =over 4
12230
12231 =item OP class abbreviations
12232
12233 =item OP flags abbreviations
12234
12235 =back
12236
12237 =item FORMATTING SPECIFICATIONS
12238
12239 =over 4
12240
12241 =item Special Patterns
12242
12243 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
12244 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
12245 B<~>
12246
12247 =item # Variables
12248
12249 B<#>I<var>, B<#>I<var>I<N>, B<#>I<Var>, B<#addr>, B<#arg>, B<#class>,
12250 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
12251 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
12252 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
12253 B<#seq>, B<#seqnum>, B<#opt>, B<#static>, B<#sibaddr>, B<#svaddr>,
12254 B<#svclass>, B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
12255
12256 =back
12257
12258 =item One-Liner Command tips
12259
12260 perl -MO=Concise,bar foo.pl, perl -MDigest::MD5=md5 -MO=Concise,md5 -e1,
12261 perl -MPOSIX -MO=Concise,_POSIX_ARG_MAX -e1, perl -MPOSIX -MO=Concise,a -e
12262 'print _POSIX_SAVED_IDS', perl -MPOSIX -MO=Concise,a -e 'sub
12263 a{_POSIX_SAVED_IDS}'
12264
12265 =item Using B::Concise outside of the O framework
12266
12267 =over 4
12268
12269 =item Example: Altering Concise Renderings
12270
12271 =item set_style()
12272
12273 =item set_style_standard($name)
12274
12275 =item add_style()
12276
12277 =item add_callback()
12278
12279 =item Running B::Concise::compile()
12280
12281 =item B::Concise::reset_sequence()
12282
12283 =item Errors
12284
12285 =back
12286
12287 =item AUTHOR
12288
12289 =back
12290
12291 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
12292
12293 =over 4
12294
12295 =item SYNOPSIS
12296
12297 =item DESCRIPTION
12298
12299 =item AUTHOR
12300
12301 =back
12302
12303 =head2 B::Deparse - Perl compiler backend to produce perl code
12304
12305 =over 4
12306
12307 =item SYNOPSIS
12308
12309 =item DESCRIPTION
12310
12311 =item OPTIONS
12312
12313 B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>,
12314 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
12315
12316 =item USING B::Deparse AS A MODULE
12317
12318 =over 4
12319
12320 =item Synopsis
12321
12322 =item Description
12323
12324 =item new
12325
12326 =item ambient_pragmas
12327
12328 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
12329
12330 =item coderef2text
12331
12332 =back
12333
12334 =item BUGS
12335
12336 =item AUTHOR
12337
12338 =back
12339
12340 =head2 B::Disassembler - Disassemble Perl bytecode
12341
12342 =over 4
12343
12344 =item SYNOPSIS
12345
12346 =item DESCRIPTION
12347
12348 =item AUTHOR
12349
12350 =back
12351
12352 =head2 B::Lint - Perl lint
12353
12354 =over 4
12355
12356 =item SYNOPSIS
12357
12358 =item DESCRIPTION
12359
12360 =item OPTIONS AND LINT CHECKS
12361
12362 B<context>, B<implicit-read> and B<implicit-write>, B<bare-subs>,
12363 B<dollar-underscore>, B<private-names>, B<undefined-subs>,
12364 B<regexp-variables>, B<all>, B<none>
12365
12366 =item NON LINT-CHECK OPTIONS
12367
12368 B<-u Package>
12369
12370 =item EXTENDING LINT
12371
12372 =item BUGS
12373
12374 =item AUTHOR
12375
12376 =back
12377
12378 =head2 B::O, O - Generic interface to Perl Compiler backends
12379
12380 =over 4
12381
12382 =item SYNOPSIS
12383
12384 =item DESCRIPTION
12385
12386 =item CONVENTIONS
12387
12388 =item IMPLEMENTATION
12389
12390 =item BUGS
12391
12392 =item AUTHOR
12393
12394 =back
12395
12396 =head2 B::Showlex - Show lexical variables used in functions or files
12397
12398 =over 4
12399
12400 =item SYNOPSIS
12401
12402 =item DESCRIPTION
12403
12404 =item EXAMPLES
12405
12406 =over 4
12407
12408 =item OPTIONS
12409
12410 =back
12411
12412 =item SEE ALSO
12413
12414 =item TODO
12415
12416 =item AUTHOR
12417
12418 =back
12419
12420 =head2 B::Stackobj - Helper module for CC backend
12421
12422 =over 4
12423
12424 =item SYNOPSIS
12425
12426 =item DESCRIPTION
12427
12428 =item AUTHOR
12429
12430 =back
12431
12432 =head2 B::Stash - show what stashes are loaded
12433
12434 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
12435
12436 =over 4
12437
12438 =item SYNOPSIS
12439
12440 =item DESCRIPTION
12441
12442 =item AUTHOR
12443
12444 =back
12445
12446 =head2 B::Xref - Generates cross reference reports for Perl programs
12447
12448 =over 4
12449
12450 =item SYNOPSIS
12451
12452 =item DESCRIPTION
12453
12454 =item OPTIONS
12455
12456 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
12457
12458 =item BUGS
12459
12460 =item AUTHOR
12461
12462 =back
12463
12464 =head2 Bblock, B::Bblock - Walk basic blocks
12465
12466 =over 4
12467
12468 =item SYNOPSIS
12469
12470 =item DESCRIPTION
12471
12472 =over 4
12473
12474 =item Functions
12475
12476 B<find_leaders>
12477
12478 =back
12479
12480 =item AUTHOR
12481
12482 =back
12483
12484 =head2 Benchmark - benchmark running times of Perl code
12485
12486 =over 4
12487
12488 =item SYNOPSIS
12489
12490 =item DESCRIPTION
12491
12492 =over 4
12493
12494 =item Methods
12495
12496 new, debug, iters
12497
12498 =item Standard Exports
12499
12500 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
12501 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
12502 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
12503
12504 =item Optional Exports
12505
12506 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [
12507 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
12508 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
12509
12510 =item :hireswallclock
12511
12512 =back
12513
12514 =item NOTES
12515
12516 =item EXAMPLES
12517
12518 =item INHERITANCE
12519
12520 =item CAVEATS
12521
12522 =item SEE ALSO
12523
12524 =item AUTHORS
12525
12526 =item MODIFICATION HISTORY
12527
12528 =back
12529
12530 =head2 ByteLoader - load byte compiled perl code
12531
12532 =over 4
12533
12534 =item SYNOPSIS
12535
12536 =item DESCRIPTION
12537
12538 =item AUTHOR
12539
12540 =item SEE ALSO
12541
12542 =back
12543
12544 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
12545
12546 =over 4
12547
12548 =item SYNOPSIS
12549
12550 =item DESCRIPTION
12551
12552 =item EXAMPLE
12553
12554 =item OPTIONS
12555
12556 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
12557
12558 =item KNOWN BUGS
12559
12560 =item NOTICE
12561
12562 =item AUTHORS
12563
12564 =back
12565
12566 =head2 CGI - Simple Common Gateway Interface Class
12567
12568 =over 4
12569
12570 =item SYNOPSIS
12571
12572 =item ABSTRACT
12573
12574 =item DESCRIPTION
12575
12576 =over 4
12577
12578 =item PROGRAMMING STYLE
12579
12580 =item CALLING CGI.PM ROUTINES
12581
12582 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
12583
12584 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
12585
12586 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
12587
12588 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
12589
12590 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
12591
12592 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
12593
12594 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
12595
12596 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
12597
12598 =item DELETING A PARAMETER COMPLETELY:
12599
12600 =item DELETING ALL PARAMETERS:
12601
12602 =item HANDLING NON-URLENCODED ARGUMENTS
12603
12604 =item DIRECT ACCESS TO THE PARAMETER LIST:
12605
12606 =item FETCHING THE PARAMETER LIST AS A HASH:
12607
12608 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
12609
12610 =item RETRIEVING CGI ERRORS
12611
12612 =item USING THE FUNCTION-ORIENTED INTERFACE
12613
12614 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
12615 B<:standard>, B<:all>
12616
12617 =item PRAGMAS
12618
12619 -any, -compile, -nosticky, -tabindex, -no_undef_params, -no_xhtml, -nph,
12620 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
12621 -private_tempfiles
12622
12623 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
12624
12625 1. start_table() (generates a <table> tag), 2. end_table() (generates a
12626 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
12627 a </ul> tag)
12628
12629 =back
12630
12631 =item GENERATING DYNAMIC DOCUMENTS
12632
12633 =over 4
12634
12635 =item CREATING A STANDARD HTTP HEADER:
12636
12637 =item GENERATING A REDIRECTION HEADER
12638
12639 =item CREATING THE HTML DOCUMENT HEADER
12640
12641 B<Parameters:>, 4, 5, 6..
12642
12643 =item ENDING THE HTML DOCUMENT:
12644
12645 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
12646
12647 =item OBTAINING THE SCRIPT'S URL
12648
12649 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
12650 (B<-query_string>), B<-base>, B<-rewrite>
12651
12652 =item MIXING POST AND URL PARAMETERS
12653
12654 =back
12655
12656 =item CREATING STANDARD HTML ELEMENTS:
12657
12658 =over 4
12659
12660 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
12661
12662 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
12663
12664 =item HTML SHORTCUTS AND LIST INTERPOLATION
12665
12666 =item NON-STANDARD HTML SHORTCUTS
12667
12668 =item AUTOESCAPING HTML
12669
12670 $escaped_string = escapeHTML("unescaped string");, $charset =
12671 charset([$charset]);, $flag = autoEscape([$flag]);
12672
12673 =item PRETTY-PRINTING HTML
12674
12675 =back
12676
12677 =item CREATING FILL-OUT FORMS:
12678
12679 =over 4
12680
12681 =item CREATING AN ISINDEX TAG
12682
12683 =item STARTING AND ENDING A FORM
12684
12685 B<application/x-www-form-urlencoded>, B<multipart/form-data>
12686
12687 =item FORM ELEMENTS
12688
12689 B<-name>, B<-value>, B<-values>, B<-tabindex>, B<-id>, B<-override>,
12690 B<-onChange>, B<-onFocus>, B<-onBlur>, B<-onMouseOver>, B<-onMouseOut>,
12691 B<-onSelect>
12692
12693 =item CREATING A TEXT FIELD
12694
12695 B<Parameters>
12696
12697 =item CREATING A BIG TEXT FIELD
12698
12699 =item CREATING A PASSWORD FIELD
12700
12701 =item CREATING A FILE UPLOAD FIELD
12702
12703 B<Parameters>
12704
12705 =item CREATING A POPUP MENU
12706
12707 =item CREATING AN OPTION GROUP
12708
12709 =item CREATING A SCROLLING LIST
12710
12711 B<Parameters:>
12712
12713 =item CREATING A GROUP OF RELATED CHECKBOXES
12714
12715 B<Parameters:>
12716
12717 =item CREATING A STANDALONE CHECKBOX
12718
12719 B<Parameters:>
12720
12721 =item CREATING A RADIO BUTTON GROUP
12722
12723 B<Parameters:>
12724
12725 =item CREATING A SUBMIT BUTTON 
12726
12727 B<Parameters:>
12728
12729 =item CREATING A RESET BUTTON
12730
12731 =item CREATING A DEFAULT BUTTON
12732
12733 =item CREATING A HIDDEN FIELD
12734
12735 B<Parameters:>
12736
12737 =item CREATING A CLICKABLE IMAGE BUTTON
12738
12739 B<Parameters:>, 3. The third option (-align, optional) is an alignment
12740 type, and may be TOP, BOTTOM or MIDDLE
12741
12742 =item CREATING A JAVASCRIPT ACTION BUTTON
12743
12744 =back
12745
12746 =item HTTP COOKIES
12747
12748 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
12749 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
12750
12751 =item WORKING WITH FRAMES
12752
12753 1. Create a <Frameset> document, 2. Specify the destination for the
12754 document in the HTTP header, 3. Specify the destination for the document in
12755 the <form> tag
12756
12757 =item SUPPORT FOR JAVASCRIPT
12758
12759 B<onLoad>, B<onUnload>, B<onSubmit>, B<onClick>, B<onChange>, B<onFocus>,
12760 B<onBlur>, B<onSelect>, B<onMouseOver>, B<onMouseOut>
12761
12762 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
12763
12764 =item DEBUGGING
12765
12766 =over 4
12767
12768 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
12769
12770 =back
12771
12772 =item FETCHING ENVIRONMENT VARIABLES
12773
12774 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
12775 B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
12776 name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
12777 ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
12778 B<virtual_port ()>, B<server_software ()>, B<remote_user ()>, B<user_name
12779 ()>, B<request_method()>, B<content_type()>, B<http()>, B<https()>
12780
12781 =item USING NPH SCRIPTS
12782
12783 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
12784 parameters
12785
12786 =item Server Push
12787
12788 multipart_init(), multipart_start(), multipart_end(), multipart_final()
12789
12790 =item Avoiding Denial of Service Attacks
12791
12792 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
12793 basis>, B<2. Globally for all scripts>
12794
12795 =item COMPATIBILITY WITH CGI-LIB.PL
12796
12797 =item AUTHOR INFORMATION
12798
12799 =item CREDITS
12800
12801 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
12802 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
12803 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
12804 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
12805 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
12806 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
12807 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
12808 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
12809 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
12810 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
12811 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
12812 ...and many many more..
12813
12814 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
12815
12816 =item BUGS
12817
12818 =item SEE ALSO
12819
12820 =back
12821
12822 =head2 CGI::Apache - Backward compatibility module for CGI.pm
12823
12824 =over 4
12825
12826 =item SYNOPSIS
12827
12828 =item ABSTRACT
12829
12830 =item DESCRIPTION
12831
12832 =item AUTHOR INFORMATION
12833
12834 =item BUGS
12835
12836 =item SEE ALSO
12837
12838 =back
12839
12840 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
12841 other) error log
12842
12843 =over 4
12844
12845 =item SYNOPSIS
12846
12847 =item DESCRIPTION
12848
12849 =item REDIRECTING ERROR MESSAGES
12850
12851 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
12852
12853 =over 4
12854
12855 =item Changing the default message
12856
12857 =back
12858
12859 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
12860
12861 =item OVERRIDING THE NAME OF THE PROGRAM
12862
12863 =item AUTHORS
12864
12865 =item SEE ALSO
12866
12867 =back
12868
12869 =head2 CGI::Cookie - Interface to Netscape Cookies
12870
12871 =over 4
12872
12873 =item SYNOPSIS
12874
12875 =item DESCRIPTION
12876
12877 =item USING CGI::Cookie
12878
12879 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
12880
12881 =over 4
12882
12883 =item Creating New Cookies
12884
12885 =item Sending the Cookie to the Browser
12886
12887 =item Recovering Previous Cookies
12888
12889 =item Manipulating Cookies
12890
12891 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
12892
12893 =back
12894
12895 =item AUTHOR INFORMATION
12896
12897 =item BUGS
12898
12899 =item SEE ALSO
12900
12901 =back
12902
12903 =head2 CGI::Fast - CGI Interface for Fast CGI
12904
12905 =over 4
12906
12907 =item SYNOPSIS
12908
12909 =item DESCRIPTION
12910
12911 =item OTHER PIECES OF THE PUZZLE
12912
12913 =item WRITING FASTCGI PERL SCRIPTS
12914
12915 =item INSTALLING FASTCGI SCRIPTS
12916
12917 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
12918
12919 =item EXTERNAL FASTCGI SERVER INVOCATION
12920
12921 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
12922
12923 =item CAVEATS
12924
12925 =item AUTHOR INFORMATION
12926
12927 =item BUGS
12928
12929 =item SEE ALSO
12930
12931 =back
12932
12933 =head2 CGI::Pretty - module to produce nicely formatted HTML code
12934
12935 =over 4
12936
12937 =item SYNOPSIS
12938
12939 =item DESCRIPTION
12940
12941 =over 4
12942
12943 =item Tags that won't be formatted
12944
12945 =item Customizing the Indenting
12946
12947 =back
12948
12949 =item BUGS
12950
12951 =item AUTHOR
12952
12953 =item SEE ALSO
12954
12955 =back
12956
12957 =head2 CGI::Push - Simple Interface to Server Push
12958
12959 =over 4
12960
12961 =item SYNOPSIS
12962
12963 =item DESCRIPTION
12964
12965 =item USING CGI::Push
12966
12967 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
12968
12969 =over 4
12970
12971 =item Heterogeneous Pages
12972
12973 =item Changing the Page Delay on the Fly
12974
12975 =back
12976
12977 =item INSTALLING CGI::Push SCRIPTS
12978
12979 =item AUTHOR INFORMATION
12980
12981 =item BUGS
12982
12983 =item SEE ALSO
12984
12985 =back
12986
12987 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
12988
12989 =over 4
12990
12991 =item SYNOPSIS
12992
12993 =item ABSTRACT
12994
12995 =item DESCRIPTION
12996
12997 =item AUTHOR INFORMATION
12998
12999 =item BUGS
13000
13001 =item SEE ALSO
13002
13003 =back
13004
13005 =head2 CGI::Util - Internal utilities used by CGI module
13006
13007 =over 4
13008
13009 =item SYNOPSIS
13010
13011 =item DESCRIPTION
13012
13013 =item AUTHOR INFORMATION
13014
13015 =item SEE ALSO
13016
13017 =back
13018
13019 =head2 CPAN - query, download and build perl modules from CPAN sites
13020
13021 =over 4
13022
13023 =item SYNOPSIS
13024
13025 =item STATUS
13026
13027 =item DESCRIPTION
13028
13029 =over 4
13030
13031 =item Interactive Mode
13032
13033 Searching for authors, bundles, distribution files and modules, make, test,
13034 install, clean  modules or distributions, get, readme, perldoc, look module
13035 or distribution, ls author, ls globbing_expresion, Signals
13036
13037 =item CPAN::Shell
13038
13039 =item autobundle
13040
13041 =item recompile
13042
13043 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
13044
13045 =item Programmer's interface
13046
13047 expand($type,@things), expandany(@things), Programming Examples
13048
13049 =item Methods in the other Classes
13050
13051 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
13052 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
13053 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
13054 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
13055 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
13056 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
13057 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
13058 CPAN::Bundle::readme(), CPAN::Bundle::test(),
13059 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
13060 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
13061 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
13062 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
13063 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
13064 CPAN::Distribution::look(), CPAN::Distribution::make(),
13065 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
13066 CPAN::Distribution::perldoc(), CPAN::Distribution::test(),
13067 CPAN::Distribution::uptodate(), CPAN::Index::force_reload(),
13068 CPAN::Index::reload(), CPAN::InfoObj::dump(), CPAN::Module::as_glimpse(),
13069 CPAN::Module::as_string(), CPAN::Module::clean(),
13070 CPAN::Module::cpan_file(), CPAN::Module::cpan_version(),
13071 CPAN::Module::cvs_import(), CPAN::Module::description(),
13072 CPAN::Module::force($method,@args), CPAN::Module::get(),
13073 CPAN::Module::inst_file(), CPAN::Module::inst_version(),
13074 CPAN::Module::install(), CPAN::Module::look(), CPAN::Module::make(),
13075 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
13076 CPAN::Module::perldoc(), CPAN::Module::test(), CPAN::Module::uptodate(),
13077 CPAN::Module::userid()
13078
13079 =item Cache Manager
13080
13081 =item Bundles
13082
13083 =item Prerequisites
13084
13085 =item Finding packages and VERSION
13086
13087 =item Debugging
13088
13089 =item Floppy, Zip, Offline Mode
13090
13091 =back
13092
13093 =item CONFIGURATION
13094
13095 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
13096 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
13097 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
13098 [unshift|push|splice] E<lt>listE<gt>>
13099
13100 =over 4
13101
13102 =item Note on urllist parameter's format
13103
13104 =item urllist parameter has CD-ROM support
13105
13106 =back
13107
13108 =item SECURITY
13109
13110 =over 4
13111
13112 =item Cryptographically signed modules
13113
13114 =back
13115
13116 =item EXPORT
13117
13118 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
13119
13120 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
13121
13122 =over 4
13123
13124 =item Three basic types of firewalls
13125
13126 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
13127
13128 =item Configuring lynx or ncftp for going through a firewall
13129
13130 =back
13131
13132 =item FAQ
13133
13134 1), 2), 3), 4), 5), 6), 7), 8), 9), 10), 11)
13135
13136 =item BUGS
13137
13138 =item AUTHOR
13139
13140 =item TRANSLATIONS
13141
13142 =item SEE ALSO
13143
13144 =back
13145
13146 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
13147
13148 =over 4
13149
13150 =item SYNOPSIS
13151
13152 =item DESCRIPTION
13153
13154 =back
13155
13156 =head2 CPAN::Version - utility functions to compare CPAN versions
13157
13158 =over 4
13159
13160 =item SYNOPSIS
13161
13162 =item DESCRIPTION
13163
13164 =back
13165
13166 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
13167 module
13168
13169 =over 4
13170
13171 =item SYNOPSIS
13172
13173 =item DESCRIPTION
13174
13175 =item  SEE ALSO
13176
13177 =back
13178
13179 =head2 Carp, carp    - warn of errors (from perspective of caller)
13180
13181 =over 4
13182
13183 =item SYNOPSIS
13184
13185 =item DESCRIPTION
13186
13187 =over 4
13188
13189 =item Forcing a Stack Trace
13190
13191 =back
13192
13193 =item GLOBAL VARIABLES
13194
13195 =over 4
13196
13197 =item $Carp::CarpLevel
13198
13199 =item $Carp::MaxEvalLen
13200
13201 =item $Carp::MaxArgLen
13202
13203 =item $Carp::MaxArgNums
13204
13205 =item $Carp::Verbose
13206
13207 =back
13208
13209 =item BUGS
13210
13211 =back
13212
13213 =head2 Carp::Heavy - heavy machinery, no user serviceable parts inside
13214
13215 =head2 Class::ISA -- report the search path for a class's ISA tree
13216
13217 =over 4
13218
13219 =item SYNOPSIS
13220
13221 =item DESCRIPTION
13222
13223 =item FUNCTIONS
13224
13225 the function Class::ISA::super_path($CLASS), the function
13226 Class::ISA::self_and_super_path($CLASS), the function
13227 Class::ISA::self_and_super_versions($CLASS)
13228
13229 =item CAUTIONARY NOTES
13230
13231 =item COPYRIGHT
13232
13233 =item AUTHOR
13234
13235 =back
13236
13237 =head2 Class::Struct - declare struct-like datatypes as Perl classes
13238
13239 =over 4
13240
13241 =item SYNOPSIS
13242
13243 =item DESCRIPTION
13244
13245 =over 4
13246
13247 =item The C<struct()> function
13248
13249 =item Class Creation at Compile Time
13250
13251 =item Element Types and Accessor Methods
13252
13253 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
13254 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
13255
13256 =item Initializing with C<new>
13257
13258 =back
13259
13260 =item EXAMPLES
13261
13262 Example 1, Example 2, Example 3
13263
13264 =item Author and Modification History
13265
13266 =back
13267
13268 =head2 Compress::Zlib - Interface to zlib compression library
13269
13270 =over 4
13271
13272 =item SYNOPSIS
13273
13274 =item DESCRIPTION
13275
13276 =item GZIP INTERFACE
13277
13278 B<$gz = gzopen($filename, $mode)>, B<$gz = gzopen($filehandle, $mode)>,
13279 B<$bytesread = $gz-E<gt>gzread($buffer [, $size]) ;>, B<$bytesread =
13280 $gz-E<gt>gzreadline($line) ;>, B<$byteswritten = $gz-E<gt>gzwrite($buffer)
13281 ;>, B<$status = $gz-E<gt>gzflush($flush_type) ;>, B<$offset =
13282 $gz-E<gt>gztell() ;>, B<$status = $gz-E<gt>gzseek($offset, $whence) ;>,
13283 B<$gz-E<gt>gzclose>, B<$gz-E<gt>gzsetparams($level, $strategy>, B<$level>,
13284 B<$strategy>, B<$gz-E<gt>gzerror>, B<$gzerrno>
13285
13286 =over 4
13287
13288 =item Examples
13289
13290 =item Compress::Zlib::memGzip
13291
13292 =item Compress::Zlib::memGunzip
13293
13294 =back
13295
13296 =item COMPRESS/UNCOMPRESS
13297
13298 B<$dest = compress($source [, $level] ) ;>, B<$dest = uncompress($source)
13299 ;>
13300
13301 =item CHECKSUM FUNCTIONS
13302
13303 =item Compress::Zlib::Deflate
13304
13305 =over 4
13306
13307 =item B<($d, $status) = new Compress::Zlib::Deflate( [OPT] ) >
13308
13309 B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>,
13310 B<-Dictionary>, B<-Bufsize>, B<-AppendOutput>, B<-CRC32>, B<-ADLER32>
13311
13312 =item B<$status = $d-E<gt>deflate($input, $output)>
13313
13314 =item B<$status = $d-E<gt>flush($output [, $flush_type]) >
13315
13316 =item B<$status = $d-E<gt>deflateParams([OPT])>
13317
13318 B<-Level>, B<-Strategy>, B<-BufSize>
13319
13320 =item B<$status = $d-E<gt>deflateTune($good_length, $max_lazy,
13321 $nice_length, $max_chain)>
13322
13323 =item B<$d-E<gt>dict_adler()>
13324
13325 =item B<$d-E<gt>crc32()>
13326
13327 =item B<$d-E<gt>adler32()>
13328
13329 =item B<$d-E<gt>msg()>
13330
13331 =item B<$d-E<gt>total_in()>
13332
13333 =item B<$d-E<gt>total_out()>
13334
13335 =item B<$d-E<gt>get_Strategy()>
13336
13337 =item B<$d-E<gt>get_Level()>
13338
13339 =item B<$d-E<gt>get_BufSize()>
13340
13341 =item Example
13342
13343 =back
13344
13345 =item Compress::Zlib::Inflate
13346
13347 =over 4
13348
13349 =item B< ($i, $status) = new Compress::Zlib::Inflate( [OPT] ) >
13350
13351 B<-WindowBits>, B<-Bufsize>, B<-Dictionary>, B<-AppendOutput>, B<-CRC32>,
13352 B<-ADLER32>, B<-ConsumeInput>
13353
13354 =item B< $status = $i-E<gt>inflate($input, $output) >
13355
13356 =item B<$status = $i-E<gt>inflateSync($input)>
13357
13358 =item B<$i-E<gt>dict_adler()>
13359
13360 =item B<$i-E<gt>crc32()>
13361
13362 =item B<$i-E<gt>adler32()>
13363
13364 =item B<$i-E<gt>msg()>
13365
13366 =item B<$i-E<gt>total_in()>
13367
13368 =item B<$i-E<gt>total_out()>
13369
13370 =item B<$d-E<gt>get_BufSize()>
13371
13372 =item Example
13373
13374 =back
13375
13376 =item Compress::Zlib 1.x Deflate Interface
13377
13378 =over 4
13379
13380 =item B<($d, $status) = deflateInit( [OPT] )>
13381
13382 B<-Level>, B<-Method>, B<-WindowBits>, B<-MemLevel>, B<-Strategy>,
13383 B<-Dictionary>, B<-Bufsize>
13384
13385 =item B<($out, $status) = $d-E<gt>deflate($buffer)>
13386
13387 =item B<($out, $status) = $d-E<gt>flush([flush_type])>
13388
13389 =item B<$status = $d-E<gt>deflateParams([OPT])>
13390
13391 B<-Level>, B<-Strategy>
13392
13393 =item B<$d-E<gt>dict_adler()>
13394
13395 =item B<$d-E<gt>msg()>
13396
13397 =item B<$d-E<gt>total_in()>
13398
13399 =item B<$d-E<gt>total_out()>
13400
13401 =item Example
13402
13403 =back
13404
13405 =item Compress::Zlib 1.x Inflate Interface
13406
13407 =over 4
13408
13409 =item B<($i, $status) = inflateInit()>
13410
13411 B<-WindowBits>, B<-Bufsize>, B<-Dictionary>
13412
13413 =item B<($out, $status) = $i-E<gt>inflate($buffer)>
13414
13415 =item B<$status = $i-E<gt>inflateSync($buffer)>
13416
13417 =item B<$i-E<gt>dict_adler()>
13418
13419 =item B<$i-E<gt>msg()>
13420
13421 =item B<$i-E<gt>total_in()>
13422
13423 =item B<$i-E<gt>total_out()>
13424
13425 =item Example
13426
13427 =back
13428
13429 =item ACCESSING ZIP FILES
13430
13431 =item CONSTANTS
13432
13433 =item SEE ALSO
13434
13435 =item AUTHOR
13436
13437 =item MODIFICATION HISTORY
13438
13439 =item COPYRIGHT AND LICENSE
13440
13441 =back
13442
13443 =head2 Compress::Zlib::File::GlobMapper, File::GlobMapper - Extend File
13444 Glob to Allow Input and Output Files
13445
13446 =over 4
13447
13448 =item SYNOPSIS
13449
13450 =item DESCRIPTION
13451
13452 This code is a work in progress, There are known bugs, The interface
13453 defined here is tentative, There are portability issues, Do not use in
13454 production code, Consider yourself warned!
13455
13456 =over 4
13457
13458 =item Behind The Scenes
13459
13460 =item Limitations
13461
13462 =item Input File Glob
13463
13464 B<~>, B<~user>, B<.>, B<*>, B<?>, B<\>,  B<[]>,  B<{,}>,  B<()>
13465
13466 =item Output File Glob
13467
13468 "*", #1
13469
13470 =item Returned Data
13471
13472 =back
13473
13474 =item EXAMPLES
13475
13476 =over 4
13477
13478 =item A Rename script
13479
13480 =item A few example globmaps
13481
13482 =back
13483
13484 =item SEE ALSO
13485
13486 =item AUTHOR
13487
13488 =item COPYRIGHT AND LICENSE
13489
13490 =back
13491
13492 =head2 Compress::Zlib::IO::Compress::Deflate, IO::Compress::Deflate     -
13493 Perl interface to write RFC 1950 files/buffers
13494
13495 =over 4
13496
13497 =item SYNOPSIS
13498
13499 =item DESCRIPTION
13500
13501 DO NOT use in production code, The documentation is incomplete in places,
13502 Parts of the interface defined here are tentative, Please report any
13503 problems you find
13504
13505 =item Functional Interface
13506
13507 =over 4
13508
13509 =item deflate $input => $output [, OPTS]
13510
13511 A filename, A filehandle, A scalar reference, An array reference, An Input
13512 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
13513 Reference, An Array Reference, An Output FileGlob
13514
13515 =item deflate \%hash [, OPTS]
13516
13517 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
13518 Array Reference
13519
13520 =item Notes
13521
13522 =item Optional Parameters
13523
13524 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
13525
13526 =item Examples
13527
13528 =back
13529
13530 =item OO Interface
13531
13532 =over 4
13533
13534 =item Constructor
13535
13536 A filename, A filehandle, A scalar reference
13537
13538 =item Constructor Options
13539
13540 -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1, A Buffer, A Filename, A
13541 Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1
13542
13543 =item Examples
13544
13545 =back
13546
13547 =item Methods 
13548
13549 =over 4
13550
13551 =item print
13552
13553 =item printf
13554
13555 =item syswrite
13556
13557 =item write
13558
13559 =item flush
13560
13561 =item tell
13562
13563 =item eof
13564
13565 =item seek
13566
13567 =item binmode
13568
13569 =item fileno
13570
13571 =item close
13572
13573 =item newStream
13574
13575 =item deflateParams
13576
13577 =back
13578
13579 =item Importing 
13580
13581 :all, :constants, :flush, :level, :strategy
13582
13583 =item EXAMPLES
13584
13585 =item SEE ALSO
13586
13587 =item AUTHOR
13588
13589 =item MODIFICATION HISTORY
13590
13591 =item COPYRIGHT AND LICENSE
13592
13593 =back
13594
13595 =head2 Compress::Zlib::IO::Compress::Gzip, IO::Compress::Gzip     - Perl
13596 interface to write RFC 1952 files/buffers
13597
13598 =over 4
13599
13600 =item SYNOPSIS
13601
13602 =item DESCRIPTION
13603
13604 DO NOT use in production code, The documentation is incomplete in places,
13605 Parts of the interface defined here are tentative, Please report any
13606 problems you find
13607
13608 =item Functional Interface
13609
13610 =over 4
13611
13612 =item gzip $input => $output [, OPTS]
13613
13614 A filename, A filehandle, A scalar reference, An array reference, An Input
13615 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
13616 Reference, An Array Reference, An Output FileGlob
13617
13618 =item gzip \%hash [, OPTS]
13619
13620 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
13621 Array Reference
13622
13623 =item Notes
13624
13625 =item Optional Parameters
13626
13627 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
13628
13629 =item Examples
13630
13631 =back
13632
13633 =item OO Interface
13634
13635 =over 4
13636
13637 =item Constructor
13638
13639 A filename, A filehandle, A scalar reference
13640
13641 =item Constructor Options
13642
13643 -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1, A Buffer, A Filename, A
13644 Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Mimimal =E<gt> 0|1,
13645 -Comment =E<gt> $comment, -Name =E<gt> $string, -Time =E<gt> $number,
13646 -TextFlag =E<gt> 0|1, -HeaderCRC =E<gt> 0|1, -OS_Code =E<gt> $value,
13647 -ExtraField =E<gt> $data, -ExtraFlags =E<gt> $value, -Strict =E<gt> 0|1
13648
13649 =item Examples
13650
13651 =back
13652
13653 =item Methods 
13654
13655 =over 4
13656
13657 =item print
13658
13659 =item printf
13660
13661 =item syswrite
13662
13663 =item write
13664
13665 =item flush
13666
13667 =item tell
13668
13669 =item eof
13670
13671 =item seek
13672
13673 =item binmode
13674
13675 =item fileno
13676
13677 =item close
13678
13679 =item newStream
13680
13681 =item deflateParams
13682
13683 =back
13684
13685 =item Importing 
13686
13687 :all, :constants, :flush, :level, :strategy
13688
13689 =item EXAMPLES
13690
13691 =item SEE ALSO
13692
13693 =item AUTHOR
13694
13695 =item MODIFICATION HISTORY
13696
13697 =item COPYRIGHT AND LICENSE
13698
13699 =back
13700
13701 =head2 Compress::Zlib::IO::Compress::RawDeflate, IO::Compress::RawDeflate  
13702   - Perl interface to write RFC 1951 files/buffers
13703
13704 =over 4
13705
13706 =item SYNOPSIS
13707
13708 =item DESCRIPTION
13709
13710 DO NOT use in production code, The documentation is incomplete in places,
13711 Parts of the interface defined here are tentative, Please report any
13712 problems you find
13713
13714 =item Functional Interface
13715
13716 =over 4
13717
13718 =item rawdeflate $input => $output [, OPTS]
13719
13720 A filename, A filehandle, A scalar reference, An array reference, An Input
13721 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
13722 Reference, An Array Reference, An Output FileGlob
13723
13724 =item rawdeflate \%hash [, OPTS]
13725
13726 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
13727 Array Reference
13728
13729 =item Notes
13730
13731 =item Optional Parameters
13732
13733 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
13734
13735 =item Examples
13736
13737 =back
13738
13739 =item OO Interface
13740
13741 =over 4
13742
13743 =item Constructor
13744
13745 A filename, A filehandle, A scalar reference
13746
13747 =item Constructor Options
13748
13749 -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1, A Buffer, A Filename, A
13750 Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1
13751
13752 =item Examples
13753
13754 =back
13755
13756 =item Methods 
13757
13758 =over 4
13759
13760 =item print
13761
13762 =item printf
13763
13764 =item syswrite
13765
13766 =item write
13767
13768 =item flush
13769
13770 =item tell
13771
13772 =item eof
13773
13774 =item seek
13775
13776 =item binmode
13777
13778 =item fileno
13779
13780 =item close
13781
13782 =item newStream
13783
13784 =item deflateParams
13785
13786 =back
13787
13788 =item Importing 
13789
13790 :all, :constants, :flush, :level, :strategy
13791
13792 =item EXAMPLES
13793
13794 =item SEE ALSO
13795
13796 =item AUTHOR
13797
13798 =item MODIFICATION HISTORY
13799
13800 =item COPYRIGHT AND LICENSE
13801
13802 =back
13803
13804 =head2 Compress::Zlib::IO::Uncompress::AnyInflate,
13805 IO::Uncompress::AnyInflate - Perl interface to read RFC 1950, 1951 & 1952
13806 files/buffers
13807
13808 =over 4
13809
13810 =item SYNOPSIS
13811
13812 =item DESCRIPTION
13813
13814 DO NOT use in production code, The documentation is incomplete in places,
13815 Parts of the interface defined here are tentative, Please report any
13816 problems you find
13817
13818 =item Functional Interface
13819
13820 =over 4
13821
13822 =item anyinflate $input => $output [, OPTS]
13823
13824 A filename, A filehandle, A scalar reference, An array reference, An Input
13825 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
13826 Reference, An Array Reference, An Output FileGlob
13827
13828 =item anyinflate \%hash [, OPTS]
13829
13830 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
13831 Array Reference
13832
13833 =item Notes
13834
13835 =item Optional Parameters
13836
13837 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
13838
13839 =item Examples
13840
13841 =back
13842
13843 =item OO Interface
13844
13845 =over 4
13846
13847 =item Constructor
13848
13849 A filename, A filehandle, A scalar reference
13850
13851 =item Constructor Options
13852
13853 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
13854 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
13855 -Append =E<gt> 0|1, -Strict =E<gt> 0|1, -ParseExtra =E<gt> 0|1
13856
13857 =item Examples
13858
13859 =back
13860
13861 =item Methods 
13862
13863 =over 4
13864
13865 =item read
13866
13867 =item read
13868
13869 =item getline
13870
13871 =item getc
13872
13873 =item ungetc
13874
13875 =item inflateSync
13876
13877 =item getHeaderInfo
13878
13879 =item tell
13880
13881 =item eof
13882
13883 =item seek
13884
13885 =item binmode
13886
13887 =item fileno
13888
13889 =item close
13890
13891 =back
13892
13893 =item Importing 
13894
13895 :all
13896
13897 =item EXAMPLES
13898
13899 =item SEE ALSO
13900
13901 =item AUTHOR
13902
13903 =item MODIFICATION HISTORY
13904
13905 =item COPYRIGHT AND LICENSE
13906
13907 =back
13908
13909 =head2 Compress::Zlib::IO::Uncompress::Gunzip, IO::Uncompress::Gunzip -
13910 Perl interface to read RFC 1952 files/buffers
13911
13912 =over 4
13913
13914 =item SYNOPSIS
13915
13916 =item DESCRIPTION
13917
13918 DO NOT use in production code, The documentation is incomplete in places,
13919 Parts of the interface defined here are tentative, Please report any
13920 problems you find
13921
13922 =item Functional Interface
13923
13924 =over 4
13925
13926 =item gunzip $input => $output [, OPTS]
13927
13928 A filename, A filehandle, A scalar reference, An array reference, An Input
13929 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
13930 Reference, An Array Reference, An Output FileGlob
13931
13932 =item gunzip \%hash [, OPTS]
13933
13934 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
13935 Array Reference
13936
13937 =item Notes
13938
13939 =item Optional Parameters
13940
13941 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
13942
13943 =item Examples
13944
13945 =back
13946
13947 =item OO Interface
13948
13949 =over 4
13950
13951 =item Constructor
13952
13953 A filename, A filehandle, A scalar reference
13954
13955 =item Constructor Options
13956
13957 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
13958 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
13959 -Append =E<gt> 0|1, -Strict =E<gt> 0|1, -ParseExtra =E<gt> 0|1
13960
13961 =item Examples
13962
13963 =back
13964
13965 =item Methods 
13966
13967 =over 4
13968
13969 =item read
13970
13971 =item read
13972
13973 =item getline
13974
13975 =item getc
13976
13977 =item ungetc
13978
13979 =item inflateSync
13980
13981 =item getHeaderInfo
13982
13983 Comment
13984
13985 =item tell
13986
13987 =item eof
13988
13989 =item seek
13990
13991 =item binmode
13992
13993 =item fileno
13994
13995 =item close
13996
13997 =back
13998
13999 =item Importing 
14000
14001 :all
14002
14003 =item EXAMPLES
14004
14005 =item SEE ALSO
14006
14007 =item AUTHOR
14008
14009 =item MODIFICATION HISTORY
14010
14011 =item COPYRIGHT AND LICENSE
14012
14013 =back
14014
14015 =head2 Compress::Zlib::IO::Uncompress::Inflate, IO::Uncompress::Inflate -
14016 Perl interface to read RFC 1950 files/buffers
14017
14018 =over 4
14019
14020 =item SYNOPSIS
14021
14022 =item DESCRIPTION
14023
14024 DO NOT use in production code, The documentation is incomplete in places,
14025 Parts of the interface defined here are tentative, Please report any
14026 problems you find
14027
14028 =item Functional Interface
14029
14030 =over 4
14031
14032 =item inflate $input => $output [, OPTS]
14033
14034 A filename, A filehandle, A scalar reference, An array reference, An Input
14035 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
14036 Reference, An Array Reference, An Output FileGlob
14037
14038 =item inflate \%hash [, OPTS]
14039
14040 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
14041 Array Reference
14042
14043 =item Notes
14044
14045 =item Optional Parameters
14046
14047 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
14048
14049 =item Examples
14050
14051 =back
14052
14053 =item OO Interface
14054
14055 =over 4
14056
14057 =item Constructor
14058
14059 A filename, A filehandle, A scalar reference
14060
14061 =item Constructor Options
14062
14063 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
14064 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
14065 -Append =E<gt> 0|1, -Strict =E<gt> 0|1
14066
14067 =item Examples
14068
14069 =back
14070
14071 =item Methods 
14072
14073 =over 4
14074
14075 =item read
14076
14077 =item read
14078
14079 =item getline
14080
14081 =item getc
14082
14083 =item ungetc
14084
14085 =item inflateSync
14086
14087 =item getHeaderInfo
14088
14089 =item tell
14090
14091 =item eof
14092
14093 =item seek
14094
14095 =item binmode
14096
14097 =item fileno
14098
14099 =item close
14100
14101 =back
14102
14103 =item Importing 
14104
14105 :all
14106
14107 =item EXAMPLES
14108
14109 =item SEE ALSO
14110
14111 =item AUTHOR
14112
14113 =item MODIFICATION HISTORY
14114
14115 =item COPYRIGHT AND LICENSE
14116
14117 =back
14118
14119 =head2 Compress::Zlib::IO::Uncompress::RawInflate,
14120 IO::Uncompress::RawInflate - Perl interface to read RFC 1951 files/buffers
14121
14122 =over 4
14123
14124 =item SYNOPSIS
14125
14126 =item DESCRIPTION
14127
14128 DO NOT use in production code, The documentation is incomplete in places,
14129 Parts of the interface defined here are tentative, Please report any
14130 problems you find
14131
14132 =item Functional Interface
14133
14134 =over 4
14135
14136 =item rawinflate $input => $output [, OPTS]
14137
14138 A filename, A filehandle, A scalar reference, An array reference, An Input
14139 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
14140 Reference, An Array Reference, An Output FileGlob
14141
14142 =item rawinflate \%hash [, OPTS]
14143
14144 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
14145 Array Reference
14146
14147 =item Notes
14148
14149 =item Optional Parameters
14150
14151 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
14152
14153 =item Examples
14154
14155 =back
14156
14157 =item OO Interface
14158
14159 =over 4
14160
14161 =item Constructor
14162
14163 A filename, A filehandle, A scalar reference
14164
14165 =item Constructor Options
14166
14167 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
14168 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
14169 -Append =E<gt> 0|1, -Strict =E<gt> 0|1
14170
14171 =item Examples
14172
14173 =back
14174
14175 =item Methods 
14176
14177 =over 4
14178
14179 =item read
14180
14181 =item read
14182
14183 =item getline
14184
14185 =item getc
14186
14187 =item ungetc
14188
14189 =item inflateSync
14190
14191 =item getHeaderInfo
14192
14193 =item tell
14194
14195 =item eof
14196
14197 =item seek
14198
14199 =item binmode
14200
14201 =item fileno
14202
14203 =item close
14204
14205 =back
14206
14207 =item Importing 
14208
14209 :all
14210
14211 =item EXAMPLES
14212
14213 =item SEE ALSO
14214
14215 =item AUTHOR
14216
14217 =item MODIFICATION HISTORY
14218
14219 =item COPYRIGHT AND LICENSE
14220
14221 =back
14222
14223 =head2 Compress::Zlib::pod::FAQ, Compress::Zlib::FAQ -- Frequently Asked
14224 Questions about Compress::Zlib 
14225
14226 =over 4
14227
14228 =item DESCRIPTION
14229
14230 =over 4
14231
14232 =item Compatibility with Unix compress/uncompress.
14233
14234 =item Accessing .tar.Z files
14235
14236 =item Accessing Zip Files
14237
14238 =item Zlib Library Version Support
14239
14240 =back
14241
14242 =item SEE ALSO
14243
14244 =item AUTHOR
14245
14246 =item MODIFICATION HISTORY
14247
14248 =item COPYRIGHT AND LICENSE
14249
14250 =back
14251
14252 =head2 Config - access Perl configuration information
14253
14254 =over 4
14255
14256 =item SYNOPSIS
14257
14258 =item DESCRIPTION
14259
14260 myconfig(), config_sh(), config_re($regex), config_vars(@names)
14261
14262 =item EXAMPLE
14263
14264 =item WARNING
14265
14266 =item GLOSSARY
14267
14268 =over 4
14269
14270 =item _
14271
14272 C<_a>, C<_exe>, C<_o>
14273
14274 =item a
14275
14276 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
14277 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
14278 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
14279 C<asctime_r_proto>, C<awk>
14280
14281 =item b
14282
14283 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
14284
14285 =item c
14286
14287 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
14288 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
14289 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
14290 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
14291 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
14292 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
14293 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
14294
14295 =item d
14296
14297 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>,
14298 C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>,
14299 C<d_attribute_format>, C<d_attribute_malloc>, C<d_attribute_nonnull>,
14300 C<d_attribute_noreturn>, C<d_attribute_pure>, C<d_attribute_unused>,
14301 C<d_attribute_warn_unused_result>, C<d_bcmp>, C<d_bcopy>, C<d_bsd>,
14302 C<d_bsdgetpgrp>, C<d_bsdsetpgrp>, C<d_bzero>, C<d_casti32>, C<d_castneg>,
14303 C<d_charvspr>, C<d_chown>, C<d_chroot>, C<d_chsize>, C<d_class>,
14304 C<d_clearenv>, C<d_closedir>, C<d_cmsghdr_s>, C<d_const>, C<d_copysignl>,
14305 C<d_crypt>, C<d_crypt_r>, C<d_csh>, C<d_ctermid_r>, C<d_ctime_r>,
14306 C<d_cuserid>, C<d_dbl_dig>, C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>,
14307 C<d_dirnamlen>, C<d_dlerror>, C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>,
14308 C<d_drand48_r>, C<d_drand48proto>, C<d_dup2>, C<d_eaccess>, C<d_endgrent>,
14309 C<d_endgrent_r>, C<d_endhent>, C<d_endhostent_r>, C<d_endnent>,
14310 C<d_endnetent_r>, C<d_endpent>, C<d_endprotoent_r>, C<d_endpwent>,
14311 C<d_endpwent_r>, C<d_endsent>, C<d_endservent_r>, C<d_eofnblk>,
14312 C<d_eunice>, C<d_faststdio>, C<d_fchdir>, C<d_fchmod>, C<d_fchown>,
14313 C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>, C<d_fd_set>,
14314 C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>, C<d_flexfnam>,
14315 C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>, C<d_fpathconf>,
14316 C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>, C<d_fpos64_t>, C<d_frexpl>,
14317 C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>, C<d_fstatfs>, C<d_fstatvfs>,
14318 C<d_fsync>, C<d_ftello>, C<d_ftime>, C<d_futimes>, C<d_Gconvert>,
14319 C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>,
14320 C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>,
14321 C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
14322 C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>,
14323 C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>,
14324 C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>,
14325 C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>,
14326 C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
14327 C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
14328 C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>,
14329 C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
14330 C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>,
14331 C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>,
14332 C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>,
14333 C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
14334 C<d_htonl>, C<d_ilogbl>, C<d_index>, C<d_inetaton>, C<d_int64_t>,
14335 C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>,
14336 C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>,
14337 C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>,
14338 C<d_lstat>, C<d_madvise>, C<d_malloc_size>, C<d_malloc_good_size>,
14339 C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>, C<d_memchr>, C<d_memcmp>,
14340 C<d_memcpy>, C<d_memmove>, C<d_memset>, C<d_mkdir>, C<d_mkdtemp>,
14341 C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>, C<d_mktime>, C<d_mmap>,
14342 C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>, C<d_mprotect>, C<d_msg>,
14343 C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>, C<d_msg_peek>,
14344 C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>, C<d_msgrcv>,
14345 C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>, C<d_nice>,
14346 C<d_nl_langinfo>, C<d_nv_preserves_uv>, C<d_nv_zero_is_allbits_zero>,
14347 C<d_off64_t>, C<d_old_pthread_create_joinable>, C<d_oldpthreads>,
14348 C<d_oldsock>, C<d_open3>, C<d_pathconf>, C<d_pause>,
14349 C<d_perl_otherlibdirs>, C<d_phostname>, C<d_pipe>, C<d_poll>,
14350 C<d_portable>, C<d_PRId64>, C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>,
14351 C<d_PRIFUldbl>, C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>,
14352 C<d_PRIu64>, C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>,
14353 C<d_pthread_atfork>, C<d_pthread_attr_setscope>, C<d_pthread_yield>,
14354 C<d_pwage>, C<d_pwchange>, C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>,
14355 C<d_pwgecos>, C<d_pwpasswd>, C<d_pwquota>, C<d_qgcvt>, C<d_quad>,
14356 C<d_random_r>, C<d_readdir64_r>, C<d_readdir>, C<d_readdir_r>,
14357 C<d_readlink>, C<d_readv>, C<d_recvmsg>, C<d_rename>, C<d_rewinddir>,
14358 C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>, C<d_sanemcmp>, C<d_sbrkproto>,
14359 C<d_scalbnl>, C<d_sched_yield>, C<d_scm_rights>, C<d_SCNfldbl>,
14360 C<d_seekdir>, C<d_select>, C<d_sem>, C<d_semctl>, C<d_semctl_semid_ds>,
14361 C<d_semctl_semun>, C<d_semget>, C<d_semop>, C<d_sendmsg>, C<d_setegid>,
14362 C<d_seteuid>, C<d_setgrent>, C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>,
14363 C<d_sethostent_r>, C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>,
14364 C<d_setlocale_r>, C<d_setnent>, C<d_setnetent_r>, C<d_setpent>,
14365 C<d_setpgid>, C<d_setpgrp2>, C<d_setpgrp>, C<d_setprior>,
14366 C<d_setproctitle>, C<d_setprotoent_r>, C<d_setpwent>, C<d_setpwent_r>,
14367 C<d_setregid>, C<d_setresgid>, C<d_setresuid>, C<d_setreuid>, C<d_setrgid>,
14368 C<d_setruid>, C<d_setsent>, C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>,
14369 C<d_sfio>, C<d_shm>, C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>,
14370 C<d_shmdt>, C<d_shmget>, C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>,
14371 C<d_sockatmark>, C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>,
14372 C<d_sockpair>, C<d_socks5_init>, C<d_sprintf_returns_strlen>, C<d_sqrtl>,
14373 C<d_srand48_r>, C<d_srandom_r>, C<d_sresgproto>, C<d_sresuproto>,
14374 C<d_statblks>, C<d_statfs_f_flags>, C<d_statfs_s>, C<d_statvfs>,
14375 C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>, C<d_stdio_ptr_lval_nochange_cnt>,
14376 C<d_stdio_ptr_lval_sets_cnt>, C<d_stdio_stream_array>, C<d_stdiobase>,
14377 C<d_stdstdio>, C<d_strchr>, C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>,
14378 C<d_strerror>, C<d_strerror_r>, C<d_strftime>, C<d_strlcat>, C<d_strlcpy>,
14379 C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>, C<d_strtoq>,
14380 C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>,
14381 C<d_symlink>, C<d_syscall>, C<d_syscallproto>, C<d_sysconf>,
14382 C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>,
14383 C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>,
14384 C<d_tm_tm_gmtoff>, C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>,
14385 C<d_ttyname_r>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>,
14386 C<d_uname>, C<d_union_semun>, C<d_unordered>, C<d_unsetenv>, C<d_usleep>,
14387 C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>,
14388 C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>, C<d_void_closedir>,
14389 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
14390 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
14391 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
14392 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
14393 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
14394
14395 =item e
14396
14397 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
14398 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
14399 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
14400 C<expr>, C<extensions>, C<extras>
14401
14402 =item f
14403
14404 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
14405 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
14406 C<full_sed>
14407
14408 =item g
14409
14410 C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>,
14411 C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>,
14412 C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>,
14413 C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>,
14414 C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>,
14415 C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>,
14416 C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>,
14417 C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>,
14418 C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>,
14419 C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
14420
14421 =item h
14422
14423 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>,
14424 C<html3dir>, C<html3direxp>
14425
14426 =item i
14427
14428 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
14429 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
14430 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
14431 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
14432 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
14433 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
14434 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
14435 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
14436 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
14437 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
14438 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
14439 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
14440 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
14441 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
14442 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
14443 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
14444 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
14445 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
14446 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installhtml1dir>,
14447 C<installhtml3dir>, C<installman1dir>, C<installman3dir>, C<installprefix>,
14448 C<installprefixexp>, C<installprivlib>, C<installscript>,
14449 C<installsitearch>, C<installsitebin>, C<installsitehtml1dir>,
14450 C<installsitehtml3dir>, C<installsitelib>, C<installsiteman1dir>,
14451 C<installsiteman3dir>, C<installsitescript>, C<installstyle>,
14452 C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>,
14453 C<installvendorhtml1dir>, C<installvendorhtml3dir>, C<installvendorlib>,
14454 C<installvendorman1dir>, C<installvendorman3dir>, C<installvendorscript>,
14455 C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
14456
14457 =item k
14458
14459 C<known_extensions>, C<ksh>
14460
14461 =item l
14462
14463 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
14464 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
14465 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
14466 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
14467 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
14468 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
14469 C<lseektype>
14470
14471 =item m
14472
14473 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
14474 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
14475 C<man3direxp>, C<man3ext>
14476
14477 =item M
14478
14479 C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>,
14480 C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>,
14481 C<myuname>
14482
14483 =item n
14484
14485 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
14486 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
14487 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
14488 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
14489 C<nvsize>, C<nvtype>
14490
14491 =item o
14492
14493 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
14494 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
14495
14496 =item p
14497
14498 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
14499 C<perl>, C<perl_patchlevel>
14500
14501 =item P
14502
14503 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
14504 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
14505 C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>,
14506 C<procselfexe>, C<prototype>, C<ptrsize>
14507
14508 =item q
14509
14510 C<quadkind>, C<quadtype>
14511
14512 =item r
14513
14514 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
14515 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
14516 C<rmail>, C<run>, C<runnm>
14517
14518 =item s
14519
14520 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
14521 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
14522 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
14523 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
14524 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
14525 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
14526 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
14527 C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>,
14528 C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>,
14529 C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>,
14530 C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>,
14531 C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>,
14532 C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>,
14533 C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>,
14534 C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>,
14535 C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>,
14536 C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>,
14537 C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>,
14538 C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>,
14539 C<submit>, C<subversion>, C<sysman>
14540
14541 =item t
14542
14543 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
14544 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
14545 C<ttyname_r_proto>
14546
14547 =item u
14548
14549 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
14550 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
14551 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
14552 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>,
14553 C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemallocwrap>,
14554 C<usemorebits>, C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>,
14555 C<useperlio>, C<useposix>, C<usereentrant>, C<userelocatableinc>,
14556 C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>, C<usevendorprefix>,
14557 C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>, C<uvsize>, C<uvtype>,
14558 C<uvuformat>, C<uvxformat>, C<uvXUformat>
14559
14560 =item v
14561
14562 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
14563 C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>,
14564 C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>,
14565 C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>,
14566 C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>,
14567 C<vendorscriptexp>, C<version>, C<version_patchlevel_string>,
14568 C<versiononly>, C<vi>, C<voidflags>
14569
14570 =item x
14571
14572 C<xlibpth>
14573
14574 =item y
14575
14576 C<yacc>, C<yaccflags>
14577
14578 =item z
14579
14580 C<zcat>, C<zip>
14581
14582 =back
14583
14584 =item NOTE
14585
14586 =back
14587
14588 =over 4
14589
14590 =item SYNOPSIS
14591
14592 =item DESCRIPTION
14593
14594 dynamic, nonxs, static
14595
14596 =item AUTHOR
14597
14598 =back
14599
14600 =head2 Cwd - get pathname of current working directory
14601
14602 =over 4
14603
14604 =item SYNOPSIS
14605
14606 =item DESCRIPTION
14607
14608 =over 4
14609
14610 =item getcwd and friends
14611
14612 getcwd, cwd, fastcwd, fastgetcwd, getdcwd
14613
14614 =item abs_path and friends
14615
14616 abs_path, realpath, fast_abs_path
14617
14618 =item $ENV{PWD}
14619
14620 =back
14621
14622 =item NOTES
14623
14624 =item AUTHOR
14625
14626 =item COPYRIGHT
14627
14628 =item SEE ALSO
14629
14630 =back
14631
14632 =head2 DB - programmatic interface to the Perl debugging API (draft,
14633 subject to
14634 change)
14635
14636 =over 4
14637
14638 =item SYNOPSIS
14639
14640 =item DESCRIPTION
14641
14642 =over 4
14643
14644 =item Global Variables
14645
14646  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args, 
14647 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname, 
14648 $DB::lineno
14649
14650 =item API Methods
14651
14652 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
14653 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
14654
14655 =item Client Callback Methods
14656
14657 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
14658 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
14659 CLIENT->output(LIST)
14660
14661 =back
14662
14663 =item BUGS
14664
14665 =item AUTHOR
14666
14667 =back
14668
14669 =head2 DBM_Filter -- Filter DBM keys/values 
14670
14671 =over 4
14672
14673 =item SYNOPSIS
14674
14675 =item DESCRIPTION
14676
14677 =item What is a DBM Filter?
14678
14679 =over 4
14680
14681 =item So what's new?
14682
14683 =back
14684
14685 =item METHODS
14686
14687 =over 4
14688
14689 =item $db->Filter_Push()
14690
14691 =item $db->Filter_Key_Push()
14692
14693 =item $db->Filter_Value_Push()
14694
14695 Filter_Push, Filter_Key_Push, Filter_Value_Push
14696
14697 =item $db->Filter_Pop()
14698
14699 =item $db->Filtered()
14700
14701 =back
14702
14703 =item Writing a Filter
14704
14705 =over 4
14706
14707 =item Immediate Filters
14708
14709 =item Canned Filters
14710
14711 "name", params
14712
14713 =back
14714
14715 =item Filters Included
14716
14717 utf8, encode, compress, int32, null
14718
14719 =item NOTES
14720
14721 =over 4
14722
14723 =item Maintain Round Trip Integrity
14724
14725 =item Don't mix filtered & non-filtered data in the same database file. 
14726
14727 =back
14728
14729 =item EXAMPLE
14730
14731 =item SEE ALSO
14732
14733 =item AUTHOR
14734
14735 =back
14736
14737 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
14738
14739 =over 4
14740
14741 =item SYNOPSIS
14742
14743 =item DESCRIPTION
14744
14745 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
14746
14747 =over 4
14748
14749 =item Using DB_File with Berkeley DB version 2 or greater
14750
14751 =item Interface to Berkeley DB
14752
14753 =item Opening a Berkeley DB Database File
14754
14755 =item Default Parameters
14756
14757 =item In Memory Databases
14758
14759 =back
14760
14761 =item DB_HASH
14762
14763 =over 4
14764
14765 =item A Simple Example
14766
14767 =back
14768
14769 =item DB_BTREE
14770
14771 =over 4
14772
14773 =item Changing the BTREE sort order
14774
14775 =item Handling Duplicate Keys 
14776
14777 =item The get_dup() Method
14778
14779 =item The find_dup() Method
14780
14781 =item The del_dup() Method
14782
14783 =item Matching Partial Keys 
14784
14785 =back
14786
14787 =item DB_RECNO
14788
14789 =over 4
14790
14791 =item The 'bval' Option
14792
14793 =item A Simple Example
14794
14795 =item Extra RECNO Methods
14796
14797 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
14798 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
14799 length, elements);>
14800
14801 =item Another Example
14802
14803 =back
14804
14805 =item THE API INTERFACE
14806
14807 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
14808 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
14809 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
14810 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
14811
14812 =item DBM FILTERS
14813
14814 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
14815 B<filter_fetch_value>
14816
14817 =over 4
14818
14819 =item The Filter
14820
14821 =item An Example -- the NULL termination problem.
14822
14823 =item Another Example -- Key is a C int.
14824
14825 =back
14826
14827 =item HINTS AND TIPS 
14828
14829 =over 4
14830
14831 =item Locking: The Trouble with fd
14832
14833 =item Safe ways to lock a database
14834
14835 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
14836
14837 =item Sharing Databases With C Applications
14838
14839 =item The untie() Gotcha
14840
14841 =back
14842
14843 =item COMMON QUESTIONS
14844
14845 =over 4
14846
14847 =item Why is there Perl source in my database?
14848
14849 =item How do I store complex data structures with DB_File?
14850
14851 =item What does "Invalid Argument" mean?
14852
14853 =item What does "Bareword 'DB_File' not allowed" mean? 
14854
14855 =back
14856
14857 =item REFERENCES
14858
14859 =item HISTORY
14860
14861 =item BUGS
14862
14863 =item AVAILABILITY
14864
14865 =item COPYRIGHT
14866
14867 =item SEE ALSO
14868
14869 =item AUTHOR
14870
14871 =back
14872
14873 =head2 Data::Dumper - stringified perl data structures, suitable for both
14874 printing and C<eval>
14875
14876 =over 4
14877
14878 =item SYNOPSIS
14879
14880 =item DESCRIPTION
14881
14882 =over 4
14883
14884 =item Methods
14885
14886 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or> 
14887 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
14888 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
14889 I<$OBJ>->Reset
14890
14891 =item Functions
14892
14893 Dumper(I<LIST>)
14894
14895 =item Configuration Variables or Methods
14896
14897 =item Exports
14898
14899 Dumper
14900
14901 =back
14902
14903 =item EXAMPLES
14904
14905 =item BUGS
14906
14907 =over 4
14908
14909 =item NOTE
14910
14911 =back
14912
14913 =item AUTHOR
14914
14915 =item VERSION
14916
14917 =item SEE ALSO
14918
14919 =back
14920
14921 =head2 Devel::DProf - a Perl code profiler
14922
14923 =over 4
14924
14925 =item SYNOPSIS
14926
14927 =item DESCRIPTION
14928
14929 =item PROFILE FORMAT
14930
14931 =item AUTOLOAD
14932
14933 =item ENVIRONMENT
14934
14935 =item BUGS
14936
14937 =item SEE ALSO
14938
14939 =back
14940
14941 =head2 Devel::PPPort - Perl/Pollution/Portability
14942
14943 =over 4
14944
14945 =item SYNOPSIS
14946
14947 =item DESCRIPTION
14948
14949 =over 4
14950
14951 =item Why use ppport.h?
14952
14953 You should use F<ppport.h> in modern code so that your code will work
14954 with the widest range of Perl interpreters possible, without significant
14955 additional work.
14956
14957 =item How to use ppport.h
14958
14959 =item Running ppport.h
14960
14961 =back
14962
14963 =item FUNCTIONS
14964
14965 =over 4
14966
14967 =item WriteFile
14968
14969 =back
14970
14971 =item COMPATIBILITY
14972
14973 =over 4
14974
14975 =item Provided Perl compatibility API
14976
14977 =item Perl API not supported by ppport.h
14978
14979 perl 5.9.2, perl 5.9.1, perl 5.9.0, perl 5.8.3, perl 5.8.1, perl 5.8.0,
14980 perl 5.7.3, perl 5.7.2, perl 5.7.1, perl 5.6.1, perl 5.6.0, perl 5.005_03,
14981 perl 5.005, perl 5.004_05, perl 5.004_04, perl 5.004
14982
14983 =back
14984
14985 =item BUGS
14986
14987 =item AUTHORS
14988
14989 =item COPYRIGHT
14990
14991 =item SEE ALSO
14992
14993 =back
14994
14995 =head2 Devel::Peek - A data debugging tool for the XS programmer
14996
14997 =over 4
14998
14999 =item SYNOPSIS
15000
15001 =item DESCRIPTION
15002
15003 =over 4
15004
15005 =item Runtime debugging
15006
15007 =item Memory footprint debugging
15008
15009 =back
15010
15011 =item EXAMPLES
15012
15013 =over 4
15014
15015 =item A simple scalar string
15016
15017 =item A simple scalar number
15018
15019 =item A simple scalar with an extra reference
15020
15021 =item A reference to a simple scalar
15022
15023 =item A reference to an array
15024
15025 =item A reference to a hash
15026
15027 =item Dumping a large array or hash
15028
15029 =item A reference to an SV which holds a C pointer
15030
15031 =item A reference to a subroutine
15032
15033 =back
15034
15035 =item EXPORTS
15036
15037 =item BUGS
15038
15039 =item AUTHOR
15040
15041 =item SEE ALSO
15042
15043 =back
15044
15045 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
15046
15047 =over 4
15048
15049 =item SYNOPSIS
15050
15051 =item DESCRIPTION
15052
15053 =back
15054
15055 =head2 Devel::Size - Perl extension for finding the memory usage of Perl
15056 variables
15057
15058 =over 4
15059
15060 =item SYNOPSIS
15061
15062 =item DESCRIPTION
15063
15064 =item FUNCTIONS
15065
15066 =over 4
15067
15068 =item size($ref)
15069
15070 =item total_size($ref)
15071
15072 =back
15073
15074 =item EXPORT
15075
15076 =item UNDERSTANDING MEMORY ALLOCATION
15077
15078 =over 4
15079
15080 =item The C library
15081
15082 =item Perl
15083
15084 =back
15085
15086 =item DANGERS
15087
15088 =item Messages: texts originating from this module.
15089
15090 =over 4
15091
15092 =item Errors
15093
15094 =item warnings
15095
15096 =back
15097
15098 =item BUGS
15099
15100 =item AUTHOR
15101
15102 =item COPYRIGHT
15103
15104 =item SEE ALSO
15105
15106 =back
15107
15108 =head2 Digest - Modules that calculate message digests
15109
15110 =over 4
15111
15112 =item SYNOPSIS
15113
15114 =item DESCRIPTION
15115
15116 I<binary>, I<hex>, I<base64>
15117
15118 =item OO INTERFACE
15119
15120 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
15121 Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset,
15122 $ctx->add( $data, ... ), $ctx->addfile( $io_handle ), $ctx->add_bits(
15123 $data, $nbits ), $ctx->add_bits( $bitstring ), $ctx->digest,
15124 $ctx->hexdigest, $ctx->b64digest
15125
15126 =item Digest speed
15127
15128 =item SEE ALSO
15129
15130 =item AUTHOR
15131
15132 =back
15133
15134 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
15135
15136 =over 4
15137
15138 =item SYNOPSIS
15139
15140 =item DESCRIPTION
15141
15142 =item FUNCTIONS
15143
15144 md5($data,...), md5_hex($data,...), md5_base64($data,...)
15145
15146 =item METHODS
15147
15148 $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...),
15149 $md5->addfile($io_handle), $md5->add_bits($data, $nbits),
15150 $md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest
15151
15152 =item EXAMPLES
15153
15154 =item SEE ALSO
15155
15156 =item COPYRIGHT
15157
15158 =item AUTHORS
15159
15160 =back
15161
15162 =head2 Digest::SHA - Perl extension for SHA-1/224/256/384/512
15163
15164 =over 4
15165
15166 =item SYNOPSIS (SHA)
15167
15168 =item SYNOPSIS (HMAC-SHA)
15169
15170 =item ABSTRACT
15171
15172 =item DESCRIPTION
15173
15174 =item NIST STATEMENT ON SHA-1
15175
15176 =item EXPORT
15177
15178 =item EXPORTABLE FUNCTIONS
15179
15180 B<sha1($data, ...)>, B<sha224($data, ...)>, B<sha256($data, ...)>,
15181 B<sha384($data, ...)>, B<sha512($data, ...)>, B<sha1_hex($data, ...)>,
15182 B<sha224_hex($data, ...)>, B<sha256_hex($data, ...)>, B<sha384_hex($data,
15183 ...)>, B<sha512_hex($data, ...)>, B<sha1_base64($data, ...)>,
15184 B<sha224_base64($data, ...)>, B<sha256_base64($data, ...)>,
15185 B<sha384_base64($data, ...)>, B<sha512_base64($data, ...)>, B<new($alg)>,
15186 B<reset($alg)>, B<hashsize>, B<algorithm>, B<clone>, B<add($data, ...)>,
15187 B<add_bits($data, $nbits)>, B<add_bits($bits)>, B<addfile(*FILE)>,
15188 B<dump($filename)>, B<load($filename)>, B<digest>, B<hexdigest>,
15189 B<b64digest>, B<hmac_sha1($data, $key)>, B<hmac_sha224($data, $key)>,
15190 B<hmac_sha256($data, $key)>, B<hmac_sha384($data, $key)>,
15191 B<hmac_sha512($data, $key)>, B<hmac_sha1_hex($data, $key)>,
15192 B<hmac_sha224_hex($data, $key)>, B<hmac_sha256_hex($data, $key)>,
15193 B<hmac_sha384_hex($data, $key)>, B<hmac_sha512_hex($data, $key)>,
15194 B<hmac_sha1_base64($data, $key)>, B<hmac_sha224_base64($data, $key)>,
15195 B<hmac_sha256_base64($data, $key)>, B<hmac_sha384_base64($data, $key)>,
15196 B<hmac_sha512_base64($data, $key)>
15197
15198 =item SEE ALSO
15199
15200 =item AUTHOR
15201
15202 =item ACKNOWLEDGMENTS
15203
15204 =item COPYRIGHT AND LICENSE
15205
15206 =back
15207
15208 =head2 Digest::base - Digest base class
15209
15210 =over 4
15211
15212 =item SYNOPSIS
15213
15214 =item DESCRIPTION
15215
15216 =item SEE ALSO
15217
15218 =back
15219
15220 =head2 Digest::file - Calculate digests of files
15221
15222 =over 4
15223
15224 =item SYNOPSIS
15225
15226 =item DESCRIPTION
15227
15228 digest_file( $file, $algorithm, [$arg,...] ), digest_file_hex( $file,
15229 $algorithm, [$arg,...] ), digest_file_base64( $file, $algorithm, [$arg,...]
15230 )
15231
15232 =item SEE ALSO
15233
15234 =back
15235
15236 =head2 DirHandle - supply object methods for directory handles
15237
15238 =over 4
15239
15240 =item SYNOPSIS
15241
15242 =item DESCRIPTION
15243
15244 =item NOTES
15245
15246 =back
15247
15248 =head2 Dumpvalue - provides screen dump of Perl data.
15249
15250 =over 4
15251
15252 =item SYNOPSIS
15253
15254 =item DESCRIPTION
15255
15256 =over 4
15257
15258 =item Creation
15259
15260 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
15261 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
15262 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
15263 stopDbSignal
15264
15265 =item Methods
15266
15267 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
15268 compactDump, veryCompact, set, get
15269
15270 =back
15271
15272 =back
15273
15274 =head2 DynaLoader - Dynamically load C libraries into Perl code
15275
15276 =over 4
15277
15278 =item SYNOPSIS
15279
15280 =item DESCRIPTION
15281
15282 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
15283 @dl_modules, @dl_shared_objects, dl_error(), $dl_debug, dl_findfile(),
15284 dl_expandspec(), dl_load_file(), dl_unload_file(), dl_load_flags(),
15285 dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(),
15286 dl_install_xsub(), bootstrap()
15287
15288 =item AUTHOR
15289
15290 =back
15291
15292 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
15293 Perl code
15294
15295 =over 4
15296
15297 =item VERSION
15298
15299 =item SYNOPSIS
15300
15301 =item DESCRIPTION
15302
15303 =over 4
15304
15305 =item Migration from C<DynaLoader>
15306
15307 =item Backward compatible boilerplate
15308
15309 =back
15310
15311 =item Order of initialization: early load()
15312
15313 =over 4
15314
15315 =item The most hairy case
15316
15317 =back
15318
15319 =item DIAGNOSTICS
15320
15321 Can't find '%s' symbol in %s, Can't load '%s' for module %s: %s, Undefined
15322 symbols present after loading %s: %s, XSLoader::load('Your::Module',
15323 $Your::Module::VERSION)
15324
15325 =item LIMITATIONS
15326
15327 =item BUGS
15328
15329 =item SEE ALSO
15330
15331 =item AUTHORS
15332
15333 =item COPYRIGHT
15334
15335 =back
15336
15337 =head2 Encode - character encodings
15338
15339 =over 4
15340
15341 =item SYNOPSIS
15342
15343 =over 4
15344
15345 =item Table of Contents
15346
15347 =back
15348
15349 =item DESCRIPTION
15350
15351 =over 4
15352
15353 =item TERMINOLOGY
15354
15355 =back
15356
15357 =item PERL ENCODING API
15358
15359 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
15360 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
15361 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
15362 CHECK]);
15363
15364 =over 4
15365
15366 =item Listing available encodings
15367
15368 =item Defining Aliases
15369
15370 =back
15371
15372 =item Encoding via PerlIO
15373
15374 =item Handling Malformed Data
15375
15376 B<NOTE:> Not all encoding support this feature, I<CHECK> =
15377 Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1), I<CHECK> =
15378 Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode (I<CHECK> =
15379 Encode::FB_PERLQQ), HTML charref mode (I<CHECK> = Encode::FB_HTMLCREF), XML
15380 charref mode (I<CHECK> = Encode::FB_XMLCREF), The bitmask
15381
15382 =over 4
15383
15384 =item coderef for CHECK
15385
15386 =back
15387
15388 =item Defining Encodings
15389
15390 =item The UTF-8 flag
15391
15392 Goal #1:, Goal #2:, Goal #3:, Goal #4:
15393
15394 =over 4
15395
15396 =item Messing with Perl's Internals
15397
15398 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
15399
15400 =back
15401
15402 =item UTF-8 vs. utf8
15403
15404 =item SEE ALSO
15405
15406 =item MAINTAINER
15407
15408 =back
15409
15410 =head2 Encode::Alias - alias definitions to encodings
15411
15412 =over 4
15413
15414 =item SYNOPSIS
15415
15416 =item DESCRIPTION
15417
15418 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
15419 reference, e.g.:
15420
15421 =over 4
15422
15423 =item Alias overloading
15424
15425 =back
15426
15427 =item SEE ALSO
15428
15429 =back
15430
15431 =head2 Encode::Byte - Single Byte Encodings
15432
15433 =over 4
15434
15435 =item SYNOPSIS
15436
15437 =item ABSTRACT
15438
15439 =item DESCRIPTION
15440
15441 =item SEE ALSO
15442
15443 =back
15444
15445 =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
15446
15447 =head2 Encode::CN - China-based Chinese Encodings
15448
15449 =over 4
15450
15451 =item SYNOPSIS
15452
15453 =item DESCRIPTION
15454
15455 =item NOTES
15456
15457 =item BUGS
15458
15459 =item SEE ALSO
15460
15461 =back
15462
15463 =head2 Encode::CN::HZ -- internally used by Encode::CN
15464
15465 =head2 Encode::Config -- internally used by Encode
15466
15467 =head2 Encode::EBCDIC - EBCDIC Encodings
15468
15469 =over 4
15470
15471 =item SYNOPSIS
15472
15473 =item ABSTRACT
15474
15475 =item DESCRIPTION
15476
15477 =item SEE ALSO
15478
15479 =back
15480
15481 =head2 Encode::Encoding - Encode Implementation Base Class
15482
15483 =over 4
15484
15485 =item SYNOPSIS
15486
15487 =item DESCRIPTION
15488
15489 =over 4
15490
15491 =item Methods you should implement
15492
15493 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
15494 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
15495
15496 =item Other methods defined in Encode::Encodings
15497
15498 -E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(),
15499 -E<gt>needs_lines()
15500
15501 =item Example: Encode::ROT13
15502
15503 =back
15504
15505 =item Why the heck Encode API is different?
15506
15507 =over 4
15508
15509 =item Compiled Encodings
15510
15511 =back
15512
15513 =item SEE ALSO
15514
15515 Scheme 1, Scheme 2, Other Schemes
15516
15517 =back
15518
15519 =head2 Encode::Guess -- Guesses encoding from data
15520
15521 =over 4
15522
15523 =item SYNOPSIS
15524
15525 =item ABSTRACT
15526
15527 =item DESCRIPTION
15528
15529 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
15530 Encode::decode("Guess" ...), Encode::Guess->guess($data),
15531 guess_encoding($data, [, I<list of suspects>])
15532
15533 =item CAVEATS
15534
15535 =item TO DO
15536
15537 =item SEE ALSO
15538
15539 =back
15540
15541 =head2 Encode::JP - Japanese Encodings
15542
15543 =over 4
15544
15545 =item SYNOPSIS
15546
15547 =item ABSTRACT
15548
15549 =item DESCRIPTION
15550
15551 =item Note on ISO-2022-JP(-1)?
15552
15553 =item BUGS
15554
15555 =item SEE ALSO
15556
15557 =back
15558
15559 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
15560
15561 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
15562
15563 =head2 Encode::KR - Korean Encodings
15564
15565 =over 4
15566
15567 =item SYNOPSIS
15568
15569 =item DESCRIPTION
15570
15571 =item BUGS
15572
15573 =item SEE ALSO
15574
15575 =back
15576
15577 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
15578
15579 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
15580
15581 =over 4
15582
15583 =item SYNOPSIS
15584
15585 =item ABSTRACT
15586
15587 =item DESCRIPTION
15588
15589 =item BUGS
15590
15591 =item SEE ALSO
15592
15593 =back
15594
15595 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
15596
15597 =over 4
15598
15599 =item Overview
15600
15601 =item How does it work?
15602
15603 =item Line Buffering
15604
15605 =over 4
15606
15607 =item How can I tell whether my encoding fully supports PerlIO ?
15608
15609 =back
15610
15611 =item SEE ALSO
15612
15613 =back
15614
15615 =head2 Encode::Supported -- Encodings supported by Encode
15616
15617 =over 4
15618
15619 =item DESCRIPTION
15620
15621 =over 4
15622
15623 =item Encoding Names
15624
15625 =back
15626
15627 =item Supported Encodings
15628
15629 =over 4
15630
15631 =item Built-in Encodings
15632
15633 =item Encode::Unicode -- other Unicode encodings
15634
15635 =item Encode::Byte -- Extended ASCII
15636
15637 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
15638 the Cyrillic world, gsm0338 - Hentai Latin 1
15639
15640 =item CJK: Chinese, Japanese, Korean (Multibyte)
15641
15642 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
15643 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
15644 Encode::JIS2K -- JIS X 0213 encodings via CPAN
15645
15646 =item Miscellaneous encodings
15647
15648 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
15649
15650 =back
15651
15652 =item Unsupported encodings
15653
15654   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
15655 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
15656 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
15657 Various Mac encodings, (Mac) Indic encodings
15658
15659 =item Encoding vs. Charset -- terminology
15660
15661 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
15662
15663 =over 4
15664
15665 =item Microsoft-related naming mess
15666
15667 KS_C_5601-1987, GB2312, Big5, Shift_JIS
15668
15669 =back
15670
15671 =item Glossary
15672
15673 character repertoire, coded character set (CCS), character encoding scheme
15674 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
15675 UTF-16
15676
15677 =item See Also
15678
15679 =item References
15680
15681 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
15682 RFC, UC, Unicode Glossary
15683
15684 =over 4
15685
15686 =item Other Notable Sites
15687
15688 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
15689 "Introduction to i18n"
15690
15691 =item Offline sources
15692
15693 C<CJKV Information Processing> by Ken Lunde
15694
15695 =back
15696
15697 =back
15698
15699 =head2 Encode::Symbol - Symbol Encodings
15700
15701 =over 4
15702
15703 =item SYNOPSIS
15704
15705 =item ABSTRACT
15706
15707 =item DESCRIPTION
15708
15709 =item SEE ALSO
15710
15711 =back
15712
15713 =head2 Encode::TW - Taiwan-based Chinese Encodings
15714
15715 =over 4
15716
15717 =item SYNOPSIS
15718
15719 =item DESCRIPTION
15720
15721 =item NOTES
15722
15723 =item BUGS
15724
15725 =item SEE ALSO
15726
15727 =back
15728
15729 =head2 Encode::Unicode -- Various Unicode Transformation Formats
15730
15731 =over 4
15732
15733 =item SYNOPSIS
15734
15735 =item ABSTRACT
15736
15737 L<http://www.unicode.org/glossary/> says:, Quick Reference
15738
15739 =item Size, Endianness, and BOM
15740
15741 =over 4
15742
15743 =item by size
15744
15745 =item by endianness
15746
15747 BOM as integer when fetched in network byte order
15748
15749 =back
15750
15751 =item Surrogate Pairs
15752
15753 =item Error Checking
15754
15755 =item SEE ALSO
15756
15757 =back
15758
15759 =head2 Encode::Unicode::UTF7 -- UTF-7 encoding
15760
15761 =over 4
15762
15763 =item SYNOPSIS
15764
15765 =item ABSTRACT
15766
15767 =item In Practice
15768
15769 =item SEE ALSO
15770
15771 =back
15772
15773 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
15774 encodings
15775
15776 =over 4
15777
15778 =item SYNOPSIS
15779
15780 =item DESCRIPTION
15781
15782 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
15783 reference, e.g.:
15784
15785 =over 4
15786
15787 =item Alias overloading
15788
15789 =back
15790
15791 =item SEE ALSO
15792
15793 =back
15794
15795 =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm --
15796 Internally used by Encode::??::ISO_2022_*
15797
15798 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
15799 Encode::CN
15800
15801 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
15802 Encode
15803
15804 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
15805 Implementation Base Class
15806
15807 =over 4
15808
15809 =item SYNOPSIS
15810
15811 =item DESCRIPTION
15812
15813 =over 4
15814
15815 =item Methods you should implement
15816
15817 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
15818 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
15819
15820 =item Other methods defined in Encode::Encodings
15821
15822 -E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(),
15823 -E<gt>needs_lines()
15824
15825 =item Example: Encode::ROT13
15826
15827 =back
15828
15829 =item Why the heck Encode API is different?
15830
15831 =over 4
15832
15833 =item Compiled Encodings
15834
15835 =back
15836
15837 =item SEE ALSO
15838
15839 Scheme 1, Scheme 2, Other Schemes
15840
15841 =back
15842
15843 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
15844 data
15845
15846 =over 4
15847
15848 =item SYNOPSIS
15849
15850 =item ABSTRACT
15851
15852 =item DESCRIPTION
15853
15854 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
15855 Encode::decode("Guess" ...), Encode::Guess->guess($data),
15856 guess_encoding($data, [, I<list of suspects>])
15857
15858 =item CAVEATS
15859
15860 =item TO DO
15861
15862 =item SEE ALSO
15863
15864 =back
15865
15866 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
15867 Encode::JP::2022_JP*
15868
15869 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
15870 by Encode::JP
15871
15872 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
15873 used by Encode::KR
15874
15875 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
15876 and 'Q' header encoding
15877
15878 =over 4
15879
15880 =item SYNOPSIS
15881
15882 =item ABSTRACT
15883
15884 =item DESCRIPTION
15885
15886 =item BUGS
15887
15888 =item SEE ALSO
15889
15890 =back
15891
15892 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
15893 on Encode and PerlIO
15894
15895 =over 4
15896
15897 =item Overview
15898
15899 =item How does it work?
15900
15901 =item Line Buffering
15902
15903 =over 4
15904
15905 =item How can I tell whether my encoding fully supports PerlIO ?
15906
15907 =back
15908
15909 =item SEE ALSO
15910
15911 =back
15912
15913 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
15914 supported by Encode
15915
15916 =over 4
15917
15918 =item DESCRIPTION
15919
15920 =over 4
15921
15922 =item Encoding Names
15923
15924 =back
15925
15926 =item Supported Encodings
15927
15928 =over 4
15929
15930 =item Built-in Encodings
15931
15932 =item Encode::Unicode -- other Unicode encodings
15933
15934 =item Encode::Byte -- Extended ASCII
15935
15936 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
15937 the Cyrillic world, gsm0338 - Hentai Latin 1
15938
15939 =item CJK: Chinese, Japanese, Korean (Multibyte)
15940
15941 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
15942 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
15943 Encode::JIS2K -- JIS X 0213 encodings via CPAN
15944
15945 =item Miscellaneous encodings
15946
15947 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
15948
15949 =back
15950
15951 =item Unsupported encodings
15952
15953   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
15954 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
15955 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
15956 Various Mac encodings, (Mac) Indic encodings
15957
15958 =item Encoding vs. Charset -- terminology
15959
15960 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
15961
15962 =over 4
15963
15964 =item Microsoft-related naming mess
15965
15966 KS_C_5601-1987, GB2312, Big5, Shift_JIS
15967
15968 =back
15969
15970 =item Glossary
15971
15972 character repertoire, coded character set (CCS), character encoding scheme
15973 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
15974 UTF-16
15975
15976 =item See Also
15977
15978 =item References
15979
15980 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
15981 RFC, UC, Unicode Glossary
15982
15983 =over 4
15984
15985 =item Other Notable Sites
15986
15987 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
15988 "Introduction to i18n"
15989
15990 =item Offline sources
15991
15992 C<CJKV Information Processing> by Ken Lunde
15993
15994 =back
15995
15996 =back
15997
15998 =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7
15999 encoding
16000
16001 =over 4
16002
16003 =item SYNOPSIS
16004
16005 =item ABSTRACT
16006
16007 =item In Practice
16008
16009 =item SEE ALSO
16010
16011 =back
16012
16013 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
16014
16015 =over 4
16016
16017 =item SYNOPSIS
16018
16019 =item ABSTRACT
16020
16021 =item Description
16022
16023 =over 4
16024
16025 =item Predefined Methods
16026
16027 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
16028 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
16029 $e-E<gt>bytes([$encoding])
16030
16031 =item Example: base64 transcoder
16032
16033 =item Operator Overloading
16034
16035 =back
16036
16037 =item SEE ALSO
16038
16039 =back
16040
16041 =head2 Encodencoding, encoding - allows you to write your script in
16042 non-ascii or non-utf8
16043
16044 =over 4
16045
16046 =item SYNOPSIS
16047
16048 =item ABSTRACT
16049
16050 =over 4
16051
16052 =item Literal Conversions
16053
16054 =item PerlIO layers for C<STD(IN|OUT)>
16055
16056 =item Implicit upgrading for byte strings
16057
16058 =back
16059
16060 =item FEATURES THAT REQUIRE 5.8.1
16061
16062 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
16063
16064 =item USAGE
16065
16066 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
16067 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
16068
16069 =item The Filter Option
16070
16071 =over 4
16072
16073 =item Filter-related changes at Encode version 1.87
16074
16075 =back
16076
16077 =item CAVEATS
16078
16079 =over 4
16080
16081 =item NOT SCOPED
16082
16083 =item DO NOT MIX MULTIPLE ENCODINGS
16084
16085 =item tr/// with ranges
16086
16087 Legend of characters above
16088
16089 =back
16090
16091 =item EXAMPLE - Greekperl
16092
16093 =item KNOWN PROBLEMS
16094
16095 literals in regex that are longer than 127 bytes, EBCDIC, format
16096
16097 =over 4
16098
16099 =item The Logic of :locale
16100
16101 =back
16102
16103 =item HISTORY
16104
16105 =item SEE ALSO
16106
16107 =back
16108
16109 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
16110
16111 =over 4
16112
16113 =item SYNOPSIS
16114
16115 =item ABSTRACT
16116
16117 =item Description
16118
16119 =over 4
16120
16121 =item Predefined Methods
16122
16123 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
16124 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
16125 $e-E<gt>bytes([$encoding])
16126
16127 =item Example: base64 transcoder
16128
16129 =item Operator Overloading
16130
16131 =back
16132
16133 =item SEE ALSO
16134
16135 =back
16136
16137 =head2 English - use nice English (or awk) names for ugly punctuation
16138 variables
16139
16140 =over 4
16141
16142 =item SYNOPSIS
16143
16144 =item DESCRIPTION
16145
16146 =item PERFORMANCE
16147
16148 =back
16149
16150 =head2 Env - perl module that imports environment variables as scalars or
16151 arrays
16152
16153 =over 4
16154
16155 =item SYNOPSIS
16156
16157 =item DESCRIPTION
16158
16159 =item LIMITATIONS
16160
16161 =item AUTHOR
16162
16163 =back
16164
16165 =head2 Errno - System errno constants
16166
16167 =over 4
16168
16169 =item SYNOPSIS
16170
16171 =item DESCRIPTION
16172
16173 =item CAVEATS
16174
16175 =item AUTHOR
16176
16177 =item COPYRIGHT
16178
16179 =back
16180
16181 =head2 Exporter - Implements default import method for modules
16182
16183 =over 4
16184
16185 =item SYNOPSIS
16186
16187 =item DESCRIPTION
16188
16189 =over 4
16190
16191 =item How to Export
16192
16193 =item Selecting What To Export
16194
16195 =item How to Import
16196
16197 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
16198
16199 =back
16200
16201 =item Advanced features
16202
16203 =over 4
16204
16205 =item Specialised Import Lists
16206
16207 =item Exporting without using Exporter's import method
16208
16209 =item Exporting without inheriting from Exporter
16210
16211 =item Module Version Checking
16212
16213 =item Managing Unknown Symbols
16214
16215 =item Tag Handling Utility Functions
16216
16217 =item Generating combined tags
16218
16219 =item C<AUTOLOAD>ed Constants
16220
16221 =back
16222
16223 =back
16224
16225 =head2 Exporter::Heavy - Exporter guts
16226
16227 =over 4
16228
16229 =item SYNOPSIS
16230
16231 =item DESCRIPTION
16232
16233 =back
16234
16235 =head2 ExtUtils::CBuilder - Compile and link C code for Perl modules
16236
16237 =over 4
16238
16239 =item SYNOPSIS
16240
16241 =item DESCRIPTION
16242
16243 =item METHODS
16244
16245 new, have_compiler, compile, C<object_file>, C<include_dirs>,
16246 C<extra_compiler_flags>, link, lib_file, module_name, extra_linker_flags,
16247 link_executable, exe_file, object_file, lib_file, exe_file, prelink,
16248 need_prelink, extra_link_args_after_prelink
16249
16250 =item TO DO
16251
16252 =item HISTORY
16253
16254 =item AUTHOR
16255
16256 =item COPYRIGHT
16257
16258 =item SEE ALSO
16259
16260 =back
16261
16262 =head2 ExtUtils::CBuilder::Platform::Windows - Builder class for Windows
16263 platforms
16264
16265 =over 4
16266
16267 =item DESCRIPTION
16268
16269 =item AUTHOR
16270
16271 =item SEE ALSO
16272
16273 =back
16274
16275 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
16276 Makefiles etc.
16277
16278 =over 4
16279
16280 =item SYNOPSIS
16281
16282 =item DESCRIPTION
16283
16284 =back
16285
16286 cat
16287
16288 eqtime
16289
16290 rm_rf
16291
16292 rm_f
16293
16294 touch
16295
16296 mv
16297
16298 cp
16299
16300 chmod
16301
16302 mkpath
16303
16304 test_f
16305
16306 dos2unix
16307
16308 =over 4
16309
16310 =item SEE ALSO 
16311
16312 =item AUTHOR
16313
16314 =back
16315
16316 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
16317
16318 =over 4
16319
16320 =item SYNOPSIS
16321
16322 =item DESCRIPTION
16323
16324 B<test_harness>
16325
16326 =back
16327
16328 B<pod2man>
16329
16330 B<warn_if_old_packlist>
16331
16332 B<perllocal_install>
16333
16334 B<uninstall>
16335
16336 =head2 ExtUtils::Constant - generate XS code to import C header constants
16337
16338 =over 4
16339
16340 =item SYNOPSIS
16341
16342 =item DESCRIPTION
16343
16344 =item USAGE
16345
16346 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
16347
16348 =item FUNCTIONS
16349
16350 =back
16351
16352 constant_types
16353
16354 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
16355
16356 autoload PACKAGE, VERSION, AUTOLOADER
16357
16358 WriteMakefileSnippet
16359
16360 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
16361 BREAKOUT_AT, NAMES, C_FH, C_FILE, XS_FH, XS_FILE, SUBNAME, C_SUBNAME
16362
16363 =over 4
16364
16365 =item AUTHOR
16366
16367 =back
16368
16369 =head2 ExtUtils::Constant::Base - base class for ExtUtils::Constant objects
16370
16371 =over 4
16372
16373 =item SYNOPSIS
16374
16375 =item DESCRIPTION
16376
16377 =item USAGE
16378
16379 =back
16380
16381 header
16382
16383 memEQ_clause args_hashref
16384
16385 dump_names arg_hashref, ITEM..
16386
16387 assign arg_hashref, VALUE..
16388
16389 return_clause arg_hashref, ITEM
16390
16391 switch_clause arg_hashref, NAMELEN, ITEMHASH, ITEM..
16392
16393 params WHAT
16394
16395 dogfood arg_hashref, ITEM..
16396
16397 normalise_items args, default_type, seen_types, seen_items, ITEM..
16398
16399 C_constant arg_hashref, ITEM.., name, type, value, macro, default, pre,
16400 post, def_pre, def_post, utf8, weight
16401
16402 =over 4
16403
16404 =item BUGS
16405
16406 =item AUTHOR
16407
16408 =back
16409
16410 =head2 ExtUtils::Constant::Utils - helper functions for ExtUtils::Constant
16411
16412 =over 4
16413
16414 =item SYNOPSIS
16415
16416 =item DESCRIPTION
16417
16418 =item USAGE
16419
16420 C_stringify NAME
16421
16422 =back
16423
16424 perl_stringify NAME
16425
16426 =over 4
16427
16428 =item AUTHOR
16429
16430 =back
16431
16432 =head2 ExtUtils::Constant::XS, ExtUtils::Constant::Base - base class for
16433 ExtUtils::Constant objects
16434
16435 =over 4
16436
16437 =item SYNOPSIS
16438
16439 =item DESCRIPTION
16440
16441 =item BUGS
16442
16443 =item AUTHOR
16444
16445 =back
16446
16447 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
16448
16449 =over 4
16450
16451 =item SYNOPSIS
16452
16453 =item DESCRIPTION
16454
16455 =item @EXPORT
16456
16457 =item FUNCTIONS
16458
16459 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
16460 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
16461
16462 =item EXAMPLES
16463
16464 =item SEE ALSO
16465
16466 =item AUTHOR
16467
16468 =back
16469
16470 =head2 ExtUtils::Install - install files from here to there
16471
16472 =over 4
16473
16474 =item SYNOPSIS
16475
16476 =item DESCRIPTION
16477
16478 =over 4
16479
16480 =item Functions
16481
16482 B<install>
16483
16484 =back
16485
16486 =back
16487
16488 B<install_default> I<DISCOURAGED>
16489
16490 B<uninstall>
16491
16492 B<pm_to_blib>
16493
16494 _autosplit
16495
16496 =over 4
16497
16498 =item ENVIRONMENT
16499
16500 B<PERL_INSTALL_ROOT>
16501
16502 =item AUTHOR
16503
16504 =item LICENSE
16505
16506 =back
16507
16508 =head2 ExtUtils::Installed - Inventory management of installed modules
16509
16510 =over 4
16511
16512 =item SYNOPSIS
16513
16514 =item DESCRIPTION
16515
16516 =item USAGE
16517
16518 =item FUNCTIONS
16519
16520 new(), modules(), files(), directories(), directory_tree(), validate(),
16521 packlist(), version()
16522
16523 =item EXAMPLE
16524
16525 =item AUTHOR
16526
16527 =back
16528
16529 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
16530
16531 =over 4
16532
16533 =item SYNOPSIS
16534
16535 =item DESCRIPTION
16536
16537 For static extensions, For dynamic extensions at build/link time, For
16538 dynamic extensions at load time
16539
16540 =over 4
16541
16542 =item EXTRALIBS
16543
16544 =item LDLOADLIBS and LD_RUN_PATH
16545
16546 =item BSLOADLIBS
16547
16548 =back
16549
16550 =item PORTABILITY
16551
16552 =over 4
16553
16554 =item VMS implementation
16555
16556 =item Win32 implementation
16557
16558 =back
16559
16560 =item SEE ALSO
16561
16562 =back
16563
16564 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
16565
16566 =over 4
16567
16568 =item SYNOPSIS
16569
16570 =item DESCRIPTION
16571
16572 =back
16573
16574 =head2 ExtUtils::MM_AIX - AIX specific subclass of ExtUtils::MM_Unix
16575
16576 =over 4
16577
16578 =item SYNOPSIS
16579
16580 =item DESCRIPTION
16581
16582 =over 4
16583
16584 =item Overridden methods
16585
16586 =back
16587
16588 =back
16589
16590 =over 4
16591
16592 =item AUTHOR
16593
16594 =item SEE ALSO
16595
16596 =back
16597
16598 =head2 ExtUtils::MM_Any - Platform-agnostic MM methods
16599
16600 =over 4
16601
16602 =item SYNOPSIS
16603
16604 =item DESCRIPTION
16605
16606 =item METHODS
16607
16608 =over 4
16609
16610 =item Cross-platform helper methods
16611
16612 =back
16613
16614 =back
16615
16616 =over 4
16617
16618 =item Targets
16619
16620 =back
16621
16622 =over 4
16623
16624 =item Init methods
16625
16626 =back
16627
16628 =over 4
16629
16630 =item Tools
16631
16632 =back
16633
16634 =over 4
16635
16636 =item File::Spec wrappers
16637
16638 =back
16639
16640 =over 4
16641
16642 =item Misc
16643
16644 =back
16645
16646 =over 4
16647
16648 =item AUTHOR
16649
16650 =back
16651
16652 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
16653 ExtUtils::MakeMaker
16654
16655 =over 4
16656
16657 =item SYNOPSIS
16658
16659 =item DESCRIPTION
16660
16661 =back
16662
16663 os_flavor
16664
16665 init_linker
16666
16667 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
16668 ExtUtils::MakeMaker
16669
16670 =over 4
16671
16672 =item SYNOPSIS
16673
16674 =item DESCRIPTION
16675
16676 os_flavor
16677
16678 =back
16679
16680 cflags
16681
16682 replace_manpage_separator
16683
16684 init_linker
16685
16686 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
16687
16688 =over 4
16689
16690 =item SYNOPSIS
16691
16692 =item DESCRIPTION
16693
16694 =over 4
16695
16696 =item Overridden methods
16697
16698 os_flavor
16699
16700 =back
16701
16702 =back
16703
16704 B<replace_manpage_separator>
16705
16706 =over 4
16707
16708 =item AUTHOR
16709
16710 =item SEE ALSO
16711
16712 =back
16713
16714 =head2 ExtUtils::MM_MacOS - once produced Makefiles for MacOS Classic
16715
16716 =over 4
16717
16718 =item SYNOPSIS
16719
16720 =item DESCRIPTION
16721
16722 =back
16723
16724 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
16725 ExtUtils::MakeMaker
16726
16727 =over 4
16728
16729 =item SYNOPSIS
16730
16731 =item DESCRIPTION
16732
16733 =back
16734
16735 os_flavor
16736
16737 init_platform, platform_constants
16738
16739 const_cccmd
16740
16741 static_lib
16742
16743 dynamic_lib
16744
16745 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
16746 ExtUtils::MakeMaker
16747
16748 =over 4
16749
16750 =item SYNOPSIS
16751
16752 =item DESCRIPTION
16753
16754 =item METHODS
16755
16756 init_dist
16757
16758 =back
16759
16760 init_linker
16761
16762 os_flavor
16763
16764 =head2 ExtUtils::MM_QNX - QNX specific subclass of ExtUtils::MM_Unix
16765
16766 =over 4
16767
16768 =item SYNOPSIS
16769
16770 =item DESCRIPTION
16771
16772 =over 4
16773
16774 =item Overridden methods
16775
16776 =back
16777
16778 =back
16779
16780 =over 4
16781
16782 =item AUTHOR
16783
16784 =item SEE ALSO
16785
16786 =back
16787
16788 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
16789
16790 =over 4
16791
16792 =item SYNOPSIS
16793
16794 =item DESCRIPTION
16795
16796 =over 4
16797
16798 =item Overridden methods
16799
16800 os_flavor
16801
16802 =back
16803
16804 =back
16805
16806 B<replace_manpage_separator>
16807
16808 =over 4
16809
16810 =item AUTHOR
16811
16812 =item SEE ALSO
16813
16814 =back
16815
16816 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
16817
16818 =over 4
16819
16820 =item SYNOPSIS
16821
16822 =item DESCRIPTION
16823
16824 =item METHODS
16825
16826 =back
16827
16828 =over 4
16829
16830 =item Methods
16831
16832 os_flavor
16833
16834 =back
16835
16836 c_o (o)
16837
16838 cflags (o)
16839
16840 const_cccmd (o)
16841
16842 const_config (o)
16843
16844 const_loadlibs (o)
16845
16846 constants (o)
16847
16848 depend (o)
16849
16850 init_DEST
16851
16852 init_dist
16853
16854 dist (o)
16855
16856 dist_basics (o)
16857
16858 dist_ci (o)
16859
16860 dist_core (o)
16861
16862 B<dist_target>
16863
16864 B<tardist_target>
16865
16866 B<zipdist_target>
16867
16868 B<tarfile_target>
16869
16870 zipfile_target
16871
16872 uutardist_target
16873
16874 shdist_target
16875
16876 dlsyms (o)
16877
16878 dynamic_bs (o)
16879
16880 dynamic_lib (o)
16881
16882 exescan
16883
16884 extliblist
16885
16886 find_perl
16887
16888 fixin
16889
16890 force (o)
16891
16892 guess_name
16893
16894 has_link_code
16895
16896 init_dirscan
16897
16898 init_DIRFILESEP
16899
16900 init_main
16901
16902 init_others
16903
16904 init_linker
16905
16906 init_lib2arch
16907
16908 init_PERL
16909
16910 init_platform, platform_constants
16911
16912 init_PERM
16913
16914 init_xs
16915
16916 install (o)
16917
16918 installbin (o)
16919
16920 linkext (o)
16921
16922 lsdir
16923
16924 macro (o)
16925
16926 makeaperl (o)
16927
16928 makefile (o)
16929
16930 maybe_command
16931
16932 needs_linking (o)
16933
16934 nicetext
16935
16936 parse_abstract
16937
16938 parse_version
16939
16940 pasthru (o)
16941
16942 perl_script
16943
16944 perldepend (o)
16945
16946 perm_rw (o)
16947
16948 perm_rwx (o)
16949
16950 pm_to_blib
16951
16952 post_constants (o)
16953
16954 post_initialize (o)
16955
16956 postamble (o)
16957
16958 ppd
16959
16960 prefixify
16961
16962 processPL (o)
16963
16964 quote_paren
16965
16966 replace_manpage_separator
16967
16968 cd
16969
16970 oneliner
16971
16972 quote_literal
16973
16974 escape_newlines
16975
16976 max_exec_len
16977
16978 static (o)
16979
16980 static_lib (o)
16981
16982 staticmake (o)
16983
16984 subdir_x (o)
16985
16986 subdirs (o)
16987
16988 test (o)
16989
16990 test_via_harness (override)
16991
16992 test_via_script (override)
16993
16994 tools_other (o)
16995
16996 tool_xsubpp (o)
16997
16998 all_target
16999
17000 top_targets (o)
17001
17002 writedoc
17003
17004 xs_c (o)
17005
17006 xs_cpp (o)
17007
17008 xs_o (o)
17009
17010 =over 4
17011
17012 =item SEE ALSO
17013
17014 =back
17015
17016 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
17017 ExtUtils::MakeMaker
17018
17019 =over 4
17020
17021 =item SYNOPSIS
17022
17023 =item DESCRIPTION
17024
17025 =over 4
17026
17027 =item Methods always loaded
17028
17029 wraplist
17030
17031 =back
17032
17033 =back
17034
17035 =over 4
17036
17037 =item Methods
17038
17039 guess_name (override)
17040
17041 =back
17042
17043 find_perl (override)
17044
17045 maybe_command (override)
17046
17047 pasthru (override)
17048
17049 pm_to_blib (override)
17050
17051 perl_script (override)
17052
17053 replace_manpage_separator
17054
17055 init_DEST
17056
17057 init_DIRFILESEP
17058
17059 init_main (override)
17060
17061 init_others (override)
17062
17063 init_platform (override)
17064
17065 platform_constants
17066
17067 init_VERSION (override)
17068
17069 constants (override)
17070
17071 special_targets
17072
17073 cflags (override)
17074
17075 const_cccmd (override)
17076
17077 tools_other (override)
17078
17079 init_dist (override)
17080
17081 c_o (override)
17082
17083 xs_c (override)
17084
17085 xs_o (override)
17086
17087 dlsyms (override)
17088
17089 dynamic_lib (override)
17090
17091 static_lib (override)
17092
17093 extra_clean_files
17094
17095 zipfile_target, tarfile_target, shdist_target
17096
17097 install (override)
17098
17099 perldepend (override)
17100
17101 makeaperl (override)
17102
17103 nicetext (override)
17104
17105 prefixify (override)
17106
17107 cd
17108
17109 oneliner
17110
17111 B<echo>
17112
17113 quote_literal
17114
17115 escape_newlines
17116
17117 max_exec_len
17118
17119 init_linker
17120
17121 eliminate_macros
17122
17123 fixpath
17124
17125 os_flavor
17126
17127 =over 4
17128
17129 =item AUTHOR
17130
17131 =back
17132
17133 =head2 ExtUtils::MM_VOS - VOS specific subclass of ExtUtils::MM_Unix
17134
17135 =over 4
17136
17137 =item SYNOPSIS
17138
17139 =item DESCRIPTION
17140
17141 =over 4
17142
17143 =item Overridden methods
17144
17145 =back
17146
17147 =back
17148
17149 =over 4
17150
17151 =item AUTHOR
17152
17153 =item SEE ALSO
17154
17155 =back
17156
17157 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
17158 ExtUtils::MakeMaker
17159
17160 =over 4
17161
17162 =item SYNOPSIS
17163
17164 =item DESCRIPTION
17165
17166 =back
17167
17168 =over 4
17169
17170 =item Overridden methods
17171
17172 B<dlsyms>
17173
17174 =back
17175
17176 replace_manpage_separator
17177
17178 B<maybe_command>
17179
17180 B<init_DIRFILESEP>
17181
17182 B<init_others>
17183
17184 init_platform, platform_constants
17185
17186 special_targets
17187
17188 static_lib
17189
17190 dynamic_lib
17191
17192 extra_clean_files
17193
17194 init_linker
17195
17196 perl_script
17197
17198 xs_o
17199
17200 pasthru
17201
17202 oneliner
17203
17204 cd
17205
17206 max_exec_len
17207
17208 os_flavor
17209
17210 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
17211
17212 =over 4
17213
17214 =item SYNOPSIS
17215
17216 =item DESCRIPTION
17217
17218 =over 4
17219
17220 =item Overridden methods
17221
17222 xs_c
17223
17224 =back
17225
17226 =back
17227
17228 xs_cpp
17229
17230 xs_o
17231
17232 max_exec_len
17233
17234 os_flavor
17235
17236 =over 4
17237
17238 =item AUTHOR
17239
17240 =back
17241
17242 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
17243
17244 =over 4
17245
17246 =item SYNOPSIS
17247
17248 =item DESCRIPTION
17249
17250 =back
17251
17252 =head2 ExtUtils::MakeMaker - Create a module Makefile
17253
17254 =over 4
17255
17256 =item SYNOPSIS
17257
17258 =item DESCRIPTION
17259
17260 =over 4
17261
17262 =item How To Write A Makefile.PL
17263
17264 =item Default Makefile Behaviour
17265
17266 =item make test
17267
17268 =item make testdb
17269
17270 =item make install
17271
17272 =item PREFIX and LIB attribute
17273
17274 =item AFS users
17275
17276 =item Static Linking of a new Perl Binary
17277
17278 =item Determination of Perl Library and Installation Locations
17279
17280 =item Which architecture dependent directory?
17281
17282 =item Using Attributes and Parameters
17283
17284 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
17285 CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS,
17286 EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN,
17287 FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB,
17288 INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
17289 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB,
17290 INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLSITESCRIPT,
17291 INSTALLVENDORARCH, INSTALLVENDORBIN, INSTALLVENDORLIB,
17292 INSTALLVENDORMAN1DIR, INSTALLVENDORMAN3DIR, INSTALLVENDORSCRIPT,
17293 INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR, INST_MAN3DIR, INST_SCRIPT,
17294 LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS, LINKTYPE, MAKEAPERL,
17295 MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET, MYEXTLIB, NAME,
17296 NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT, OPTIMIZE, PERL,
17297 PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB, PERL_MALLOC_OK, PERLPREFIX,
17298 PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW, PERM_RWX, PL_FILES, PM, PMLIBDIRS,
17299 PM_FILTER, POLLUTE, PPM_INSTALL_EXEC, PPM_INSTALL_SCRIPT, PREFIX,
17300 PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT, PRINT_PREREQ, SITEPREFIX, SIGN,
17301 SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION, VERSION_FROM, VERSION_SYM,
17302 XS, XSOPT, XSPROTOARG, XS_VERSION
17303
17304 =item Additional lowercase attributes
17305
17306 clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean,
17307 test, tool_autosplit
17308
17309 =item Overriding MakeMaker Methods
17310
17311 =item The End Of Cargo Cult Programming
17312
17313 C<< MAN3PODS => ' ' >>
17314
17315 =item Hintsfile support
17316
17317 =item Distribution Support
17318
17319    make distcheck,    make skipcheck,    make distclean,    make manifest, 
17320   make distdir,   make disttest,    make tardist,    make dist,    make
17321 uutardist,    make shdist,    make zipdist,    make ci
17322
17323 =item Module Meta-Data
17324
17325 =item Disabling an extension
17326
17327 =item Other Handy Functions
17328
17329 prompt
17330
17331 =back
17332
17333 =item ENVIRONMENT
17334
17335 PERL_MM_OPT, PERL_MM_USE_DEFAULT, PERL_CORE
17336
17337 =item SEE ALSO
17338
17339 =item AUTHORS
17340
17341 =item LICENSE
17342
17343 =back
17344
17345 =head2 ExtUtils::MakeMaker::Config - Wrapper around Config.pm
17346
17347 =over 4
17348
17349 =item SYNOPSIS
17350
17351 =item DESCRIPTION
17352
17353 =back
17354
17355 =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About
17356 MakeMaker
17357
17358 =over 4
17359
17360 =item DESCRIPTION
17361
17362 =over 4
17363
17364 =item Module Installation
17365
17366 How do I keep from installing man pages?, How do I use a module without
17367 installing it?
17368
17369 =item Philosophy and History
17370
17371 Why not just use <insert other build config tool here>?, What is
17372 Module::Build and how does it relate to MakeMaker?, pure perl.  no make, no
17373 shell commands, easier to customize, cleaner internals, less cruft
17374
17375 =item Module Writing
17376
17377 How do I keep my $VERSION up to date without resetting it manually?, What's
17378 this F<META.yml> thing and how did it get in my F<MANIFEST>?!
17379
17380 =item XS
17381
17382 How to I prevent "object version X.XX does not match bootstrap parameter
17383 Y.YY" errors?, How do I make two or more XS files coexist in the same
17384 directory?
17385
17386 =back
17387
17388 =item PATCHING
17389
17390 =item AUTHOR
17391
17392 =item SEE ALSO
17393
17394 =back
17395
17396 =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker
17397
17398 =over 4
17399
17400 =item SYNOPSIS
17401
17402 =item DESCRIPTION
17403
17404 =over 4
17405
17406 =item The Mantra
17407
17408 =item The Layout
17409
17410 Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP,
17411 bin/
17412
17413 =back
17414
17415 =item SEE ALSO
17416
17417 =back
17418
17419 =head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm
17420
17421 =over 4
17422
17423 =item SYNOPSIS
17424
17425 =item DESCRIPTION
17426
17427 =back
17428
17429 =head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm
17430
17431 =over 4
17432
17433 =item SYNOPSIS
17434
17435 =item DESCRIPTION
17436
17437 =back
17438
17439 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
17440
17441 =over 4
17442
17443 =item SYNOPSIS
17444
17445 =item DESCRIPTION
17446
17447 =over 4
17448
17449 =item Functions
17450
17451 mkmanifest
17452
17453 =back
17454
17455 =back
17456
17457 manifind
17458
17459 manicheck
17460
17461 filecheck
17462
17463 fullcheck
17464
17465 skipcheck
17466
17467 maniread
17468
17469 manicopy
17470
17471 maniadd
17472
17473 =over 4
17474
17475 =item MANIFEST
17476
17477 =item MANIFEST.SKIP
17478
17479 =item EXPORT_OK
17480
17481 =item GLOBAL VARIABLES
17482
17483 =back
17484
17485 =over 4
17486
17487 =item DIAGNOSTICS
17488
17489 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
17490 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
17491
17492 =item ENVIRONMENT
17493
17494 B<PERL_MM_MANIFEST_DEBUG>
17495
17496 =item SEE ALSO
17497
17498 =item AUTHOR
17499
17500 =back
17501
17502 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
17503
17504 =over 4
17505
17506 =item SYNOPSIS
17507
17508 =item DESCRIPTION
17509
17510 =item SEE ALSO
17511
17512 =back
17513
17514 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
17515
17516 =over 4
17517
17518 =item SYNOPSIS
17519
17520 =item DESCRIPTION
17521
17522 =back
17523
17524 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
17525 extension
17526
17527 =over 4
17528
17529 =item SYNOPSIS
17530
17531 =item DESCRIPTION
17532
17533 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
17534
17535 =item AUTHOR
17536
17537 =item REVISION
17538
17539 =back
17540
17541 =head2 ExtUtils::Packlist - manage .packlist files
17542
17543 =over 4
17544
17545 =item SYNOPSIS
17546
17547 =item DESCRIPTION
17548
17549 =item USAGE
17550
17551 =item FUNCTIONS
17552
17553 new(), read(), write(), validate(), packlist_file()
17554
17555 =item EXAMPLE
17556
17557 =item AUTHOR
17558
17559 =back
17560
17561 =head2 ExtUtils::ParseXS - converts Perl XS code into C code
17562
17563 =over 4
17564
17565 =item SYNOPSIS
17566
17567 =item EXPORT
17568
17569 =item FUNCTIONS
17570
17571 process_xs(), B<C++>, B<hiertype>, B<except>, B<typemap>, B<prototypes>,
17572 B<versioncheck>, B<linenumbers>, B<optimize>, B<inout>, B<argtypes>, B<s>,
17573 errors()
17574
17575 =item AUTHOR
17576
17577 =item COPYRIGHT
17578
17579 =item SEE ALSO
17580
17581 =back
17582
17583 =head2 ExtUtils::testlib - add blib/* directories to @INC
17584
17585 =over 4
17586
17587 =item SYNOPSIS
17588
17589 =item DESCRIPTION
17590
17591 =back
17592
17593 =head2 Fatal - replace functions with equivalents which succeed or die
17594
17595 =over 4
17596
17597 =item SYNOPSIS
17598
17599 =item DESCRIPTION
17600
17601 =item AUTHOR
17602
17603 =back
17604
17605 =head2 Fcntl - load the C Fcntl.h defines
17606
17607 =over 4
17608
17609 =item SYNOPSIS
17610
17611 =item DESCRIPTION
17612
17613 =item NOTE
17614
17615 =item EXPORTED SYMBOLS
17616
17617 =back
17618
17619 =head2 Fcntl2 - load the C Fcntl2.h defines
17620
17621 =over 4
17622
17623 =item SYNOPSIS
17624
17625 =item DESCRIPTION
17626
17627 =item NOTE
17628
17629 =item EXPORTED SYMBOLS
17630
17631 =back
17632
17633 =head2 File::Basename - Parse file paths into directory, filename and
17634 suffix.
17635
17636 =over 4
17637
17638 =item SYNOPSIS
17639
17640 =item DESCRIPTION
17641
17642 =back
17643
17644 C<fileparse>
17645
17646 C<basename>
17647
17648 C<dirname>
17649
17650 C<fileparse_set_fstype>
17651
17652 =over 4
17653
17654 =item SEE ALSO
17655
17656 =back
17657
17658 =head2 File::CheckTree, validate - run many filetest checks on a tree
17659
17660 =over 4
17661
17662 =item SYNOPSIS
17663
17664 =item DESCRIPTION
17665
17666 =item AUTHOR
17667
17668 =item HISTORY
17669
17670 =back
17671
17672 =head2 File::Compare - Compare files or filehandles
17673
17674 =over 4
17675
17676 =item SYNOPSIS
17677
17678 =item DESCRIPTION
17679
17680 =item RETURN
17681
17682 =item AUTHOR
17683
17684 =back
17685
17686 =head2 File::Copy - Copy files or filehandles
17687
17688 =over 4
17689
17690 =item SYNOPSIS
17691
17692 =item DESCRIPTION
17693
17694 =over 4
17695
17696 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
17697
17698 rmscopy($from,$to[,$date_flag])
17699
17700 =back
17701
17702 =item RETURN
17703
17704 =item NOTES
17705
17706 =item AUTHOR
17707
17708 =back
17709
17710 =head2 File::DosGlob - DOS like globbing and then some
17711
17712 =over 4
17713
17714 =item SYNOPSIS
17715
17716 =item DESCRIPTION
17717
17718 =item NOTES
17719
17720 =item EXPORTS (by request only)
17721
17722 =item BUGS
17723
17724 =item AUTHOR
17725
17726 =item HISTORY
17727
17728 =item SEE ALSO
17729
17730 =back
17731
17732 =head2 File::Find - Traverse a directory tree.
17733
17734 =over 4
17735
17736 =item SYNOPSIS
17737
17738 =item DESCRIPTION
17739
17740 B<find>, B<finddepth>
17741
17742 =over 4
17743
17744 =item %options
17745
17746 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
17747 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
17748 C<untaint>, C<untaint_pattern>, C<untaint_skip>
17749
17750 =item The wanted function
17751
17752 C<$File::Find::dir> is the current directory name,, C<$_> is the current
17753 filename within that directory, C<$File::Find::name> is the complete
17754 pathname to the file
17755
17756 =back
17757
17758 =item WARNINGS
17759
17760 =item CAVEAT
17761
17762 $dont_use_nlink, symlinks
17763
17764 =item NOTES
17765
17766 =item BUGS AND CAVEATS
17767
17768 =item HISTORY
17769
17770 =back
17771
17772 =head2 File::Glob - Perl extension for BSD glob routine
17773
17774 =over 4
17775
17776 =item SYNOPSIS
17777
17778 =item DESCRIPTION
17779
17780 =over 4
17781
17782 =item META CHARACTERS
17783
17784 =item POSIX FLAGS
17785
17786 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
17787 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
17788 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
17789
17790 =back
17791
17792 =item DIAGNOSTICS
17793
17794 C<GLOB_NOSPACE>, C<GLOB_ABEND>
17795
17796 =item NOTES
17797
17798 =item SEE ALSO
17799
17800 =item AUTHOR
17801
17802 =back
17803
17804 =head2 File::GlobMapper - Extend File Glob to Allow Input and Output Files
17805
17806 =over 4
17807
17808 =item SYNOPSIS
17809
17810 =item DESCRIPTION
17811
17812 This code is a work in progress, There are known bugs, The interface
17813 defined here is tentative, There are portability issues, Do not use in
17814 production code, Consider yourself warned!
17815
17816 =over 4
17817
17818 =item Behind The Scenes
17819
17820 =item Limitations
17821
17822 =item Input File Glob
17823
17824 B<~>, B<~user>, B<.>, B<*>, B<?>, B<\>,  B<[]>,  B<{,}>,  B<()>
17825
17826 =item Output File Glob
17827
17828 "*", #1
17829
17830 =item Returned Data
17831
17832 =back
17833
17834 =item EXAMPLES
17835
17836 =over 4
17837
17838 =item A Rename script
17839
17840 =item A few example globmaps
17841
17842 =back
17843
17844 =item SEE ALSO
17845
17846 =item AUTHOR
17847
17848 =item COPYRIGHT AND LICENSE
17849
17850 =back
17851
17852 =head2 File::Path - create or remove directory trees
17853
17854 =over 4
17855
17856 =item SYNOPSIS
17857
17858 =item DESCRIPTION
17859
17860 =item DIAGNOSTICS
17861
17862 =item AUTHORS
17863
17864 =back
17865
17866 =head2 File::Spec - portably perform operations on file names
17867
17868 =over 4
17869
17870 =item SYNOPSIS
17871
17872 =item DESCRIPTION
17873
17874 =item METHODS
17875
17876 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
17877 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
17878 splitdir, catpath(), abs2rel, rel2abs()
17879
17880 =item SEE ALSO
17881
17882 =item AUTHOR
17883
17884 =item COPYRIGHT
17885
17886 =back
17887
17888 =head2 File::Spec::Cygwin - methods for Cygwin file specs
17889
17890 =over 4
17891
17892 =item SYNOPSIS
17893
17894 =item DESCRIPTION
17895
17896 =back
17897
17898 canonpath
17899
17900 file_name_is_absolute
17901
17902 tmpdir (override)
17903
17904 =over 4
17905
17906 =item COPYRIGHT
17907
17908 =back
17909
17910 =head2 File::Spec::Epoc - methods for Epoc file specs
17911
17912 =over 4
17913
17914 =item SYNOPSIS
17915
17916 =item DESCRIPTION
17917
17918 =back
17919
17920 canonpath()
17921
17922 =over 4
17923
17924 =item AUTHOR
17925
17926 =item COPYRIGHT
17927
17928 =item SEE ALSO
17929
17930 =back
17931
17932 =head2 File::Spec::Functions - portably perform operations on file names
17933
17934 =over 4
17935
17936 =item SYNOPSIS
17937
17938 =item DESCRIPTION
17939
17940 =over 4
17941
17942 =item Exports
17943
17944 =back
17945
17946 =item COPYRIGHT
17947
17948 =item SEE ALSO
17949
17950 =back
17951
17952 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
17953
17954 =over 4
17955
17956 =item SYNOPSIS
17957
17958 =item DESCRIPTION
17959
17960 =item METHODS
17961
17962 canonpath
17963
17964 =back
17965
17966 catdir()
17967
17968 catfile
17969
17970 curdir
17971
17972 devnull
17973
17974 rootdir
17975
17976 tmpdir
17977
17978 updir
17979
17980 file_name_is_absolute
17981
17982 path
17983
17984 splitpath
17985
17986 splitdir
17987
17988 catpath
17989
17990 abs2rel
17991
17992 rel2abs
17993
17994 =over 4
17995
17996 =item AUTHORS
17997
17998 =item COPYRIGHT
17999
18000 =item SEE ALSO
18001
18002 =back
18003
18004 =head2 File::Spec::OS2 - methods for OS/2 file specs
18005
18006 =over 4
18007
18008 =item SYNOPSIS
18009
18010 =item DESCRIPTION
18011
18012 tmpdir, splitpath
18013
18014 =item COPYRIGHT
18015
18016 =back
18017
18018 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
18019 modules
18020
18021 =over 4
18022
18023 =item SYNOPSIS
18024
18025 =item DESCRIPTION
18026
18027 =item METHODS
18028
18029 canonpath()
18030
18031 =back
18032
18033 catdir()
18034
18035 catfile
18036
18037 curdir
18038
18039 devnull
18040
18041 rootdir
18042
18043 tmpdir
18044
18045 updir
18046
18047 no_upwards
18048
18049 case_tolerant
18050
18051 file_name_is_absolute
18052
18053 path
18054
18055 join
18056
18057 splitpath
18058
18059 splitdir
18060
18061 catpath()
18062
18063 abs2rel
18064
18065 rel2abs()
18066
18067 =over 4
18068
18069 =item COPYRIGHT
18070
18071 =item SEE ALSO
18072
18073 =back
18074
18075 =head2 File::Spec::VMS - methods for VMS file specs
18076
18077 =over 4
18078
18079 =item SYNOPSIS
18080
18081 =item DESCRIPTION
18082
18083 canonpath (override)
18084
18085 =back
18086
18087 catdir (override)
18088
18089 catfile (override)
18090
18091 curdir (override)
18092
18093 devnull (override)
18094
18095 rootdir (override)
18096
18097 tmpdir (override)
18098
18099 updir (override)
18100
18101 case_tolerant (override)
18102
18103 path (override)
18104
18105 file_name_is_absolute (override)
18106
18107 splitpath (override)
18108
18109 splitdir (override)
18110
18111 catpath (override)
18112
18113 abs2rel (override)
18114
18115 rel2abs (override)
18116
18117 =over 4
18118
18119 =item COPYRIGHT
18120
18121 =item SEE ALSO
18122
18123 =back
18124
18125 =head2 File::Spec::Win32 - methods for Win32 file specs
18126
18127 =over 4
18128
18129 =item SYNOPSIS
18130
18131 =item DESCRIPTION
18132
18133 devnull
18134
18135 =back
18136
18137 tmpdir
18138
18139 catfile
18140
18141 canonpath
18142
18143 splitpath
18144
18145 splitdir
18146
18147 catpath
18148
18149 =over 4
18150
18151 =item Note For File::Spec::Win32 Maintainers
18152
18153 =back
18154
18155 =over 4
18156
18157 =item COPYRIGHT
18158
18159 =item SEE ALSO
18160
18161 =back
18162
18163 =head2 File::Temp - return name and handle of a temporary file safely
18164
18165 =over 4
18166
18167 =item PORTABILITY
18168
18169 =item SYNOPSIS
18170
18171 =item DESCRIPTION
18172
18173 =back
18174
18175 =over 4
18176
18177 =item OBJECT-ORIENTED INTERFACE
18178
18179 B<new>
18180
18181 =back
18182
18183 B<filename>
18184
18185 B<unlink_on_destroy>
18186
18187 B<DESTROY>
18188
18189 =over 4
18190
18191 =item FUNCTIONS
18192
18193 B<tempfile>
18194
18195 =back
18196
18197 B<tempdir>
18198
18199 =over 4
18200
18201 =item MKTEMP FUNCTIONS
18202
18203 B<mkstemp>
18204
18205 =back
18206
18207 B<mkstemps>
18208
18209 B<mkdtemp>
18210
18211 B<mktemp>
18212
18213 =over 4
18214
18215 =item POSIX FUNCTIONS
18216
18217 B<tmpnam>
18218
18219 =back
18220
18221 B<tmpfile>
18222
18223 =over 4
18224
18225 =item ADDITIONAL FUNCTIONS
18226
18227 B<tempnam>
18228
18229 =back
18230
18231 =over 4
18232
18233 =item UTILITY FUNCTIONS
18234
18235 B<unlink0>
18236
18237 =back
18238
18239 B<cmpstat>
18240
18241 B<unlink1>
18242
18243 B<cleanup>
18244
18245 =over 4
18246
18247 =item PACKAGE VARIABLES
18248
18249 B<safe_level>, STANDARD, MEDIUM, HIGH
18250
18251 =back
18252
18253 TopSystemUID
18254
18255 B<$KEEP_ALL>, B<$DEBUG>
18256
18257 =over 4
18258
18259 =item WARNING
18260
18261 =over 4
18262
18263 =item Temporary files and NFS
18264
18265 =item Forking
18266
18267 =item BINMODE
18268
18269 =back
18270
18271 =item HISTORY
18272
18273 =item SEE ALSO
18274
18275 =item AUTHOR
18276
18277 =back
18278
18279 =head2 File::stat - by-name interface to Perl's built-in stat() functions
18280
18281 =over 4
18282
18283 =item SYNOPSIS
18284
18285 =item DESCRIPTION
18286
18287 =item BUGS
18288
18289 =item NOTE
18290
18291 =item AUTHOR
18292
18293 =back
18294
18295 =head2 FileCache - keep more files open than the system permits
18296
18297 =over 4
18298
18299 =item SYNOPSIS
18300
18301 =item DESCRIPTION
18302
18303 cacheout EXPR, cacheout MODE, EXPR
18304
18305 =item CAVEATS
18306
18307 =item BUGS
18308
18309 =back
18310
18311 =head2 FileHandle - supply object methods for filehandles
18312
18313 =over 4
18314
18315 =item SYNOPSIS
18316
18317 =item DESCRIPTION
18318
18319 $fh->print, $fh->printf, $fh->getline, $fh->getlines
18320
18321 =item SEE ALSO
18322
18323 =back
18324
18325 =head2 Filter::Simple - Simplified source filtering
18326
18327 =over 4
18328
18329 =item SYNOPSIS
18330
18331 =item DESCRIPTION
18332
18333 =over 4
18334
18335 =item The Problem
18336
18337 =item A Solution
18338
18339 =item Disabling or changing <no> behaviour
18340
18341 =item All-in-one interface
18342
18343 =item Filtering only specific components of source code
18344
18345 C<"code">, C<"code_no_comments">, C<"executable">,
18346 C<"executable_no_comments">, C<"quotelike">, C<"string">, C<"regex">,
18347 C<"all">
18348
18349 =item Filtering only the code parts of source code
18350
18351 Most source code ceases to be grammatically correct when it is broken up
18352 into the pieces between string literals and regexes. So the C<'code'>
18353 and C<'code_no_comments'> component filter behave slightly differently
18354 from the other partial filters described in the previous section.
18355
18356 =item Using Filter::Simple with an explicit C<import> subroutine
18357
18358 =item Using Filter::Simple and Exporter together
18359
18360 =item How it works
18361
18362 =back
18363
18364 =item AUTHOR
18365
18366 =item COPYRIGHT
18367
18368 =back
18369
18370 =head2 Filter::Util::Call - Perl Source Filter Utility Module
18371
18372 =over 4
18373
18374 =item SYNOPSIS
18375
18376 =item DESCRIPTION
18377
18378 =over 4
18379
18380 =item B<use Filter::Util::Call>
18381
18382 =item B<import()>
18383
18384 =item B<filter() and anonymous sub>
18385
18386 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
18387
18388 =back
18389
18390 =item EXAMPLES
18391
18392 =over 4
18393
18394 =item Example 1: A simple filter.
18395
18396 =item Example 2: Using the context
18397
18398 =item Example 3: Using the context within the filter
18399
18400 =item Example 4: Using filter_del
18401
18402 =back
18403
18404 =item Filter::Simple
18405
18406 =item AUTHOR
18407
18408 =item DATE
18409
18410 =back
18411
18412 =head2 FindBin - Locate directory of original perl script
18413
18414 =over 4
18415
18416 =item SYNOPSIS
18417
18418 =item DESCRIPTION
18419
18420 =item EXPORTABLE VARIABLES
18421
18422 =item KNOWN ISSUES
18423
18424 =item KNOWN BUGS
18425
18426 =item AUTHORS
18427
18428 =item COPYRIGHT
18429
18430 =back
18431
18432 =head2 GDBM_File - Perl5 access to the gdbm library.
18433
18434 =over 4
18435
18436 =item SYNOPSIS
18437
18438 =item DESCRIPTION
18439
18440 =item AVAILABILITY
18441
18442 =item BUGS
18443
18444 =item SEE ALSO
18445
18446 =back
18447
18448 =head2 Getopt::Long - Extended processing of command line options
18449
18450 =over 4
18451
18452 =item SYNOPSIS
18453
18454 =item DESCRIPTION
18455
18456 =item Command Line Options, an Introduction
18457
18458 =item Getting Started with Getopt::Long
18459
18460 =over 4
18461
18462 =item Simple options
18463
18464 =item A little bit less simple options
18465
18466 =item Mixing command line option with other arguments
18467
18468 =item Options with values
18469
18470 =item Options with multiple values
18471
18472 =item Options with hash values
18473
18474 =item User-defined subroutines to handle options
18475
18476 =item Options with multiple names
18477
18478 =item Case and abbreviations
18479
18480 =item Summary of Option Specifications
18481
18482 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
18483 + [ I<desttype> ]
18484
18485 =back
18486
18487 =item Advanced Possibilities
18488
18489 =over 4
18490
18491 =item Object oriented interface
18492
18493 =item Thread Safety
18494
18495 =item Documentation and help texts
18496
18497 =item Storing option values in a hash
18498
18499 =item Bundling
18500
18501 =item The lonesome dash
18502
18503 =item Argument callback
18504
18505 =back
18506
18507 =item Configuring Getopt::Long
18508
18509 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
18510 require_order, permute, bundling (default: disabled), bundling_override
18511 (default: disabled), ignore_case  (default: enabled), ignore_case_always
18512 (default: disabled), auto_version (default:disabled), auto_help
18513 (default:disabled), pass_through (default: disabled), prefix,
18514 prefix_pattern, long_prefix_pattern, debug (default: disabled)
18515
18516 =item Exportable Methods
18517
18518 VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage
18519
18520 =item Return values and Errors
18521
18522 =item Legacy
18523
18524 =over 4
18525
18526 =item Default destinations
18527
18528 =item Alternative option starters
18529
18530 =item Configuration variables
18531
18532 =back
18533
18534 =item Trouble Shooting
18535
18536 =over 4
18537
18538 =item GetOptions does not return a false result when an option is not
18539 supplied
18540
18541 =item GetOptions does not split the command line correctly
18542
18543 =item Undefined subroutine &main::GetOptions called
18544
18545 =item How do I put a "-?" option into a Getopt::Long?
18546
18547 =back
18548
18549 =item AUTHOR
18550
18551 =item COPYRIGHT AND DISCLAIMER
18552
18553 =back
18554
18555 =head2 Getopt::Std, getopt, getopts - Process single-character switches
18556 with switch clustering
18557
18558 =over 4
18559
18560 =item SYNOPSIS
18561
18562 =item DESCRIPTION
18563
18564 =item C<--help> and C<--version>
18565
18566 =back
18567
18568 =head2 Hash::Util - A selection of general-utility hash subroutines
18569
18570 =over 4
18571
18572 =item SYNOPSIS
18573
18574 =item DESCRIPTION
18575
18576 =over 4
18577
18578 =item Restricted hashes
18579
18580 lock_keys, unlock_keys
18581
18582 =back
18583
18584 =back
18585
18586 lock_value, unlock_value
18587
18588 B<lock_hash>, B<unlock_hash>
18589
18590 B<hash_seed>
18591
18592 =over 4
18593
18594 =item CAVEATS
18595
18596 =item AUTHOR
18597
18598 =item SEE ALSO
18599
18600 =back
18601
18602 =head2 I18N::Collate - compare 8-bit scalar data according to the current
18603 locale
18604
18605 =over 4
18606
18607 =item SYNOPSIS
18608
18609 =item DESCRIPTION
18610
18611 =back
18612
18613 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
18614 tags
18615
18616 =over 4
18617
18618 =item SYNOPSIS
18619
18620 =item DESCRIPTION
18621
18622 =back
18623
18624 the function is_language_tag($lang1)
18625
18626 the function extract_language_tags($whatever)
18627
18628 the function same_language_tag($lang1, $lang2)
18629
18630 the function similarity_language_tag($lang1, $lang2)
18631
18632 the function is_dialect_of($lang1, $lang2)
18633
18634 the function super_languages($lang1)
18635
18636 the function locale2language_tag($locale_identifier)
18637
18638 the function encode_language_tag($lang1)
18639
18640 the function alternate_language_tags($lang1)
18641
18642 the function @langs = panic_languages(@accept_languages)
18643
18644 the function implicate_supers( ...languages... ), the function
18645 implicate_supers_strictly( ...languages... )
18646
18647 =over 4
18648
18649 =item ABOUT LOWERCASING
18650
18651 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
18652
18653 =item SEE ALSO
18654
18655 =item COPYRIGHT
18656
18657 =item AUTHOR
18658
18659 =back
18660
18661 =head2 I18N::LangTags::Detect - detect the user's language preferences
18662
18663 =over 4
18664
18665 =item SYNOPSIS
18666
18667 =item DESCRIPTION
18668
18669 =item FUNCTIONS
18670
18671 =item ENVIRONMENT
18672
18673 =item SEE ALSO
18674
18675 =item COPYRIGHT
18676
18677 =item AUTHOR
18678
18679 =back
18680
18681 =head2 I18N::LangTags::List -- tags and names for human languages
18682
18683 =over 4
18684
18685 =item SYNOPSIS
18686
18687 =item DESCRIPTION
18688
18689 =item ABOUT LANGUAGE TAGS
18690
18691 =item LIST OF LANGUAGES
18692
18693 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} :
18694 Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} :
18695 Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian,
18696 {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)],
18697 {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic,
18698 {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy}
18699 : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} :
18700 Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} :
18701 Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae}
18702 : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} :
18703 Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai}
18704 : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} :
18705 Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} :
18706 Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber
18707 (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini,
18708 {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} :
18709 Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} :
18710 Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian
18711 (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central
18712 American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages],
18713 {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb}
18714 : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} :
18715 Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} :
18716 Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree,
18717 {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf}
18718 : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based
18719 Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} :
18720 Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} :
18721 Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru)
18722 Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri,
18723 {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch,
18724 {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi}
18725 : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} :
18726 English, {enm} : Old English (1100-1500), {ang} : Old English
18727 (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} :
18728 Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat}
18729 : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} :
18730 Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French
18731 (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} :
18732 Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan,
18733 {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian,
18734 {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High
18735 German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon}
18736 : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient
18737 Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} :
18738 Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian,
18739 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
18740 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
18741 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo,
18742 {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European
18743 (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua
18744 (International Auxiliary Language Association), {ie} : Interlingue, {iu} :
18745 Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} :
18746 Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian
18747 languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} :
18748 Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle,
18749 {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} :
18750 Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar}
18751 : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh,
18752 {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese,
18753 {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz,
18754 {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} :
18755 Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama,
18756 {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} :
18757 Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} :
18758 Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} :
18759 Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban
18760 (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui}
18761 : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai,
18762 {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili,
18763 {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} :
18764 Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} :
18765 Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} :
18766 Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai,
18767 [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} :
18768 Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} :
18769 Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)],
18770 {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple
18771 languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan,
18772 {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele,
18773 {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
18774 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
18775 {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} :
18776 Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} :
18777 Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi}
18778 : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} :
18779 Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
18780 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
18781 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
18782 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
18783 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
18784 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
18785 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
18786 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
18787 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
18788 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
18789 languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} :
18790 Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami,
18791 [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} :
18792 Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak,
18793 {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian,
18794 {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign
18795 Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} :
18796 Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave
18797 (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian,
18798 {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} :
18799 Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} :
18800 South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} :
18801 Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati,
18802 {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} :
18803 Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao,
18804 {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} :
18805 Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} :
18806 Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau,
18807 {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian,
18808 {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} :
18809 Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh}
18810 : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} :
18811 Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian,
18812 {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} :
18813 Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak}
18814 : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was}
18815 : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private
18816 Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} :
18817 Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
18818 : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu,
18819 {zun} : Zuni
18820
18821 =item SEE ALSO
18822
18823 =item COPYRIGHT AND DISCLAIMER
18824
18825 =item AUTHOR
18826
18827 =back
18828
18829 =head2 I18N::Langinfo - query locale information
18830
18831 =over 4
18832
18833 =item SYNOPSIS
18834
18835 =item DESCRIPTION
18836
18837 =over 4
18838
18839 =item EXPORT
18840
18841 =back
18842
18843 =item SEE ALSO
18844
18845 =item AUTHOR
18846
18847 =item COPYRIGHT AND LICENSE
18848
18849 =back
18850
18851 =head2 IO - load various IO modules
18852
18853 =over 4
18854
18855 =item SYNOPSIS
18856
18857 =item DESCRIPTION
18858
18859 =item DEPRECATED
18860
18861 =back
18862
18863 =head2 IO::Compress::Deflate     - Perl interface to write RFC 1950
18864 files/buffers
18865
18866 =over 4
18867
18868 =item SYNOPSIS
18869
18870 =item DESCRIPTION
18871
18872 DO NOT use in production code, The documentation is incomplete in places,
18873 Parts of the interface defined here are tentative, Please report any
18874 problems you find
18875
18876 =item Functional Interface
18877
18878 =over 4
18879
18880 =item deflate $input => $output [, OPTS]
18881
18882 A filename, A filehandle, A scalar reference, An array reference, An Input
18883 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
18884 Reference, An Array Reference, An Output FileGlob
18885
18886 =item deflate \%hash [, OPTS]
18887
18888 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
18889 Array Reference
18890
18891 =item Notes
18892
18893 =item Optional Parameters
18894
18895 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
18896
18897 =item Examples
18898
18899 =back
18900
18901 =item OO Interface
18902
18903 =over 4
18904
18905 =item Constructor
18906
18907 A filename, A filehandle, A scalar reference
18908
18909 =item Constructor Options
18910
18911 -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1, A Buffer, A Filename, A
18912 Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1
18913
18914 =item Examples
18915
18916 =back
18917
18918 =item Methods 
18919
18920 =over 4
18921
18922 =item print
18923
18924 =item printf
18925
18926 =item syswrite
18927
18928 =item write
18929
18930 =item flush
18931
18932 =item tell
18933
18934 =item eof
18935
18936 =item seek
18937
18938 =item binmode
18939
18940 =item fileno
18941
18942 =item close
18943
18944 =item newStream
18945
18946 =item deflateParams
18947
18948 =back
18949
18950 =item Importing 
18951
18952 :all, :constants, :flush, :level, :strategy
18953
18954 =item EXAMPLES
18955
18956 =item SEE ALSO
18957
18958 =item AUTHOR
18959
18960 =item MODIFICATION HISTORY
18961
18962 =item COPYRIGHT AND LICENSE
18963
18964 =back
18965
18966 =head2 IO::Compress::Gzip     - Perl interface to write RFC 1952
18967 files/buffers
18968
18969 =over 4
18970
18971 =item SYNOPSIS
18972
18973 =item DESCRIPTION
18974
18975 DO NOT use in production code, The documentation is incomplete in places,
18976 Parts of the interface defined here are tentative, Please report any
18977 problems you find
18978
18979 =item Functional Interface
18980
18981 =over 4
18982
18983 =item gzip $input => $output [, OPTS]
18984
18985 A filename, A filehandle, A scalar reference, An array reference, An Input
18986 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
18987 Reference, An Array Reference, An Output FileGlob
18988
18989 =item gzip \%hash [, OPTS]
18990
18991 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
18992 Array Reference
18993
18994 =item Notes
18995
18996 =item Optional Parameters
18997
18998 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
18999
19000 =item Examples
19001
19002 =back
19003
19004 =item OO Interface
19005
19006 =over 4
19007
19008 =item Constructor
19009
19010 A filename, A filehandle, A scalar reference
19011
19012 =item Constructor Options
19013
19014 -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1, A Buffer, A Filename, A
19015 Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Mimimal =E<gt> 0|1,
19016 -Comment =E<gt> $comment, -Name =E<gt> $string, -Time =E<gt> $number,
19017 -TextFlag =E<gt> 0|1, -HeaderCRC =E<gt> 0|1, -OS_Code =E<gt> $value,
19018 -ExtraField =E<gt> $data, -ExtraFlags =E<gt> $value, -Strict =E<gt> 0|1
19019
19020 =item Examples
19021
19022 =back
19023
19024 =item Methods 
19025
19026 =over 4
19027
19028 =item print
19029
19030 =item printf
19031
19032 =item syswrite
19033
19034 =item write
19035
19036 =item flush
19037
19038 =item tell
19039
19040 =item eof
19041
19042 =item seek
19043
19044 =item binmode
19045
19046 =item fileno
19047
19048 =item close
19049
19050 =item newStream
19051
19052 =item deflateParams
19053
19054 =back
19055
19056 =item Importing 
19057
19058 :all, :constants, :flush, :level, :strategy
19059
19060 =item EXAMPLES
19061
19062 =item SEE ALSO
19063
19064 =item AUTHOR
19065
19066 =item MODIFICATION HISTORY
19067
19068 =item COPYRIGHT AND LICENSE
19069
19070 =back
19071
19072 =head2 IO::Compress::RawDeflate     - Perl interface to write RFC 1951
19073 files/buffers
19074
19075 =over 4
19076
19077 =item SYNOPSIS
19078
19079 =item DESCRIPTION
19080
19081 DO NOT use in production code, The documentation is incomplete in places,
19082 Parts of the interface defined here are tentative, Please report any
19083 problems you find
19084
19085 =item Functional Interface
19086
19087 =over 4
19088
19089 =item rawdeflate $input => $output [, OPTS]
19090
19091 A filename, A filehandle, A scalar reference, An array reference, An Input
19092 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
19093 Reference, An Array Reference, An Output FileGlob
19094
19095 =item rawdeflate \%hash [, OPTS]
19096
19097 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
19098 Array Reference
19099
19100 =item Notes
19101
19102 =item Optional Parameters
19103
19104 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
19105
19106 =item Examples
19107
19108 =back
19109
19110 =item OO Interface
19111
19112 =over 4
19113
19114 =item Constructor
19115
19116 A filename, A filehandle, A scalar reference
19117
19118 =item Constructor Options
19119
19120 -AutoClose =E<gt> 0|1, -Append =E<gt> 0|1, A Buffer, A Filename, A
19121 Filehandle, -Merge =E<gt> 0|1, -Level, -Strategy, -Strict =E<gt> 0|1
19122
19123 =item Examples
19124
19125 =back
19126
19127 =item Methods 
19128
19129 =over 4
19130
19131 =item print
19132
19133 =item printf
19134
19135 =item syswrite
19136
19137 =item write
19138
19139 =item flush
19140
19141 =item tell
19142
19143 =item eof
19144
19145 =item seek
19146
19147 =item binmode
19148
19149 =item fileno
19150
19151 =item close
19152
19153 =item newStream
19154
19155 =item deflateParams
19156
19157 =back
19158
19159 =item Importing 
19160
19161 :all, :constants, :flush, :level, :strategy
19162
19163 =item EXAMPLES
19164
19165 =item SEE ALSO
19166
19167 =item AUTHOR
19168
19169 =item MODIFICATION HISTORY
19170
19171 =item COPYRIGHT AND LICENSE
19172
19173 =back
19174
19175 =head2 IO::Dir - supply object methods for directory handles
19176
19177 =over 4
19178
19179 =item SYNOPSIS
19180
19181 =item DESCRIPTION
19182
19183 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
19184 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
19185
19186 =item SEE ALSO
19187
19188 =item AUTHOR
19189
19190 =item COPYRIGHT
19191
19192 =back
19193
19194 =head2 IO::File - supply object methods for filehandles
19195
19196 =over 4
19197
19198 =item SYNOPSIS
19199
19200 =item DESCRIPTION
19201
19202 =item CONSTRUCTOR
19203
19204 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
19205
19206 =item METHODS
19207
19208 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode(
19209 [LAYER] )
19210
19211 =item NOTE
19212
19213 =item SEE ALSO
19214
19215 =item HISTORY
19216
19217 =back
19218
19219 =head2 IO::Handle - supply object methods for I/O handles
19220
19221 =over 4
19222
19223 =item SYNOPSIS
19224
19225 =item DESCRIPTION
19226
19227 =item CONSTRUCTOR
19228
19229 new (), new_from_fd ( FD, MODE )
19230
19231 =item METHODS
19232
19233 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
19234 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
19235 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
19236 $io->blocking ( [ BOOL ] ), $io->untaint
19237
19238 =item NOTE
19239
19240 =item SEE ALSO
19241
19242 =item BUGS
19243
19244 =item HISTORY
19245
19246 =back
19247
19248 =head2 IO::Pipe - supply object methods for pipes
19249
19250 =over 4
19251
19252 =item SYNOPSIS
19253
19254 =item DESCRIPTION
19255
19256 =item CONSTRUCTOR
19257
19258 new ( [READER, WRITER] )
19259
19260 =item METHODS
19261
19262 reader ([ARGS]), writer ([ARGS]), handles ()
19263
19264 =item SEE ALSO
19265
19266 =item AUTHOR
19267
19268 =item COPYRIGHT
19269
19270 =back
19271
19272 =head2 IO::Poll - Object interface to system poll call
19273
19274 =over 4
19275
19276 =item SYNOPSIS
19277
19278 =item DESCRIPTION
19279
19280 =item METHODS
19281
19282 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
19283 IO ), handles( [ EVENT_MASK ] )
19284
19285 =item SEE ALSO
19286
19287 =item AUTHOR
19288
19289 =item COPYRIGHT
19290
19291 =back
19292
19293 =head2 IO::Seekable - supply seek based methods for I/O objects
19294
19295 =over 4
19296
19297 =item SYNOPSIS
19298
19299 =item DESCRIPTION
19300
19301 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
19302 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
19303 $io->tell
19304
19305 =item SEE ALSO
19306
19307 =item HISTORY
19308
19309 =back
19310
19311 =head2 IO::Select - OO interface to the select system call
19312
19313 =over 4
19314
19315 =item SYNOPSIS
19316
19317 =item DESCRIPTION
19318
19319 =item CONSTRUCTOR
19320
19321 new ( [ HANDLES ] )
19322
19323 =item METHODS
19324
19325 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
19326 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
19327 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
19328
19329 =item EXAMPLE
19330
19331 =item AUTHOR
19332
19333 =item COPYRIGHT
19334
19335 =back
19336
19337 =head2 IO::Socket - Object interface to socket communications
19338
19339 =over 4
19340
19341 =item SYNOPSIS
19342
19343 =item DESCRIPTION
19344
19345 =item CONSTRUCTOR
19346
19347 new ( [ARGS] )
19348
19349 =item METHODS
19350
19351 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
19352 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
19353
19354 =item SEE ALSO
19355
19356 =item AUTHOR
19357
19358 =item COPYRIGHT
19359
19360 =back
19361
19362 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
19363
19364 =over 4
19365
19366 =item SYNOPSIS
19367
19368 =item DESCRIPTION
19369
19370 =item CONSTRUCTOR
19371
19372 new ( [ARGS] )
19373
19374 =over 4
19375
19376 =item METHODS
19377
19378 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
19379 ()
19380
19381 =back
19382
19383 =item SEE ALSO
19384
19385 =item AUTHOR
19386
19387 =item COPYRIGHT
19388
19389 =back
19390
19391 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
19392
19393 =over 4
19394
19395 =item SYNOPSIS
19396
19397 =item DESCRIPTION
19398
19399 =item CONSTRUCTOR
19400
19401 new ( [ARGS] )
19402
19403 =item METHODS
19404
19405 hostpath(), peerpath()
19406
19407 =item SEE ALSO
19408
19409 =item AUTHOR
19410
19411 =item COPYRIGHT
19412
19413 =back
19414
19415 =head2 IO::Uncompress::AnyInflate - Perl interface to read RFC 1950, 1951 &
19416 1952 files/buffers
19417
19418 =over 4
19419
19420 =item SYNOPSIS
19421
19422 =item DESCRIPTION
19423
19424 DO NOT use in production code, The documentation is incomplete in places,
19425 Parts of the interface defined here are tentative, Please report any
19426 problems you find
19427
19428 =item Functional Interface
19429
19430 =over 4
19431
19432 =item anyinflate $input => $output [, OPTS]
19433
19434 A filename, A filehandle, A scalar reference, An array reference, An Input
19435 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
19436 Reference, An Array Reference, An Output FileGlob
19437
19438 =item anyinflate \%hash [, OPTS]
19439
19440 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
19441 Array Reference
19442
19443 =item Notes
19444
19445 =item Optional Parameters
19446
19447 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
19448
19449 =item Examples
19450
19451 =back
19452
19453 =item OO Interface
19454
19455 =over 4
19456
19457 =item Constructor
19458
19459 A filename, A filehandle, A scalar reference
19460
19461 =item Constructor Options
19462
19463 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
19464 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
19465 -Append =E<gt> 0|1, -Strict =E<gt> 0|1, -ParseExtra =E<gt> 0|1
19466
19467 =item Examples
19468
19469 =back
19470
19471 =item Methods 
19472
19473 =over 4
19474
19475 =item read
19476
19477 =item read
19478
19479 =item getline
19480
19481 =item getc
19482
19483 =item ungetc
19484
19485 =item inflateSync
19486
19487 =item getHeaderInfo
19488
19489 =item tell
19490
19491 =item eof
19492
19493 =item seek
19494
19495 =item binmode
19496
19497 =item fileno
19498
19499 =item close
19500
19501 =back
19502
19503 =item Importing 
19504
19505 :all
19506
19507 =item EXAMPLES
19508
19509 =item SEE ALSO
19510
19511 =item AUTHOR
19512
19513 =item MODIFICATION HISTORY
19514
19515 =item COPYRIGHT AND LICENSE
19516
19517 =back
19518
19519 =head2 IO::Uncompress::Gunzip - Perl interface to read RFC 1952
19520 files/buffers
19521
19522 =over 4
19523
19524 =item SYNOPSIS
19525
19526 =item DESCRIPTION
19527
19528 DO NOT use in production code, The documentation is incomplete in places,
19529 Parts of the interface defined here are tentative, Please report any
19530 problems you find
19531
19532 =item Functional Interface
19533
19534 =over 4
19535
19536 =item gunzip $input => $output [, OPTS]
19537
19538 A filename, A filehandle, A scalar reference, An array reference, An Input
19539 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
19540 Reference, An Array Reference, An Output FileGlob
19541
19542 =item gunzip \%hash [, OPTS]
19543
19544 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
19545 Array Reference
19546
19547 =item Notes
19548
19549 =item Optional Parameters
19550
19551 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
19552
19553 =item Examples
19554
19555 =back
19556
19557 =item OO Interface
19558
19559 =over 4
19560
19561 =item Constructor
19562
19563 A filename, A filehandle, A scalar reference
19564
19565 =item Constructor Options
19566
19567 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
19568 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
19569 -Append =E<gt> 0|1, -Strict =E<gt> 0|1, -ParseExtra =E<gt> 0|1
19570
19571 =item Examples
19572
19573 =back
19574
19575 =item Methods 
19576
19577 =over 4
19578
19579 =item read
19580
19581 =item read
19582
19583 =item getline
19584
19585 =item getc
19586
19587 =item ungetc
19588
19589 =item inflateSync
19590
19591 =item getHeaderInfo
19592
19593 Comment
19594
19595 =item tell
19596
19597 =item eof
19598
19599 =item seek
19600
19601 =item binmode
19602
19603 =item fileno
19604
19605 =item close
19606
19607 =back
19608
19609 =item Importing 
19610
19611 :all
19612
19613 =item EXAMPLES
19614
19615 =item SEE ALSO
19616
19617 =item AUTHOR
19618
19619 =item MODIFICATION HISTORY
19620
19621 =item COPYRIGHT AND LICENSE
19622
19623 =back
19624
19625 =head2 IO::Uncompress::Inflate - Perl interface to read RFC 1950
19626 files/buffers
19627
19628 =over 4
19629
19630 =item SYNOPSIS
19631
19632 =item DESCRIPTION
19633
19634 DO NOT use in production code, The documentation is incomplete in places,
19635 Parts of the interface defined here are tentative, Please report any
19636 problems you find
19637
19638 =item Functional Interface
19639
19640 =over 4
19641
19642 =item inflate $input => $output [, OPTS]
19643
19644 A filename, A filehandle, A scalar reference, An array reference, An Input
19645 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
19646 Reference, An Array Reference, An Output FileGlob
19647
19648 =item inflate \%hash [, OPTS]
19649
19650 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
19651 Array Reference
19652
19653 =item Notes
19654
19655 =item Optional Parameters
19656
19657 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
19658
19659 =item Examples
19660
19661 =back
19662
19663 =item OO Interface
19664
19665 =over 4
19666
19667 =item Constructor
19668
19669 A filename, A filehandle, A scalar reference
19670
19671 =item Constructor Options
19672
19673 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
19674 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
19675 -Append =E<gt> 0|1, -Strict =E<gt> 0|1
19676
19677 =item Examples
19678
19679 =back
19680
19681 =item Methods 
19682
19683 =over 4
19684
19685 =item read
19686
19687 =item read
19688
19689 =item getline
19690
19691 =item getc
19692
19693 =item ungetc
19694
19695 =item inflateSync
19696
19697 =item getHeaderInfo
19698
19699 =item tell
19700
19701 =item eof
19702
19703 =item seek
19704
19705 =item binmode
19706
19707 =item fileno
19708
19709 =item close
19710
19711 =back
19712
19713 =item Importing 
19714
19715 :all
19716
19717 =item EXAMPLES
19718
19719 =item SEE ALSO
19720
19721 =item AUTHOR
19722
19723 =item MODIFICATION HISTORY
19724
19725 =item COPYRIGHT AND LICENSE
19726
19727 =back
19728
19729 =head2 IO::Uncompress::RawInflate - Perl interface to read RFC 1951
19730 files/buffers
19731
19732 =over 4
19733
19734 =item SYNOPSIS
19735
19736 =item DESCRIPTION
19737
19738 DO NOT use in production code, The documentation is incomplete in places,
19739 Parts of the interface defined here are tentative, Please report any
19740 problems you find
19741
19742 =item Functional Interface
19743
19744 =over 4
19745
19746 =item rawinflate $input => $output [, OPTS]
19747
19748 A filename, A filehandle, A scalar reference, An array reference, An Input
19749 FileGlob string, A filename, A filehandle, A scalar reference, A Hash
19750 Reference, An Array Reference, An Output FileGlob
19751
19752 =item rawinflate \%hash [, OPTS]
19753
19754 undef, A filename, A filehandle, A scalar reference, A Hash Reference, An
19755 Array Reference
19756
19757 =item Notes
19758
19759 =item Optional Parameters
19760
19761 AutoClose =E<gt> 0|1, -Append =E<gt> 0|1
19762
19763 =item Examples
19764
19765 =back
19766
19767 =item OO Interface
19768
19769 =over 4
19770
19771 =item Constructor
19772
19773 A filename, A filehandle, A scalar reference
19774
19775 =item Constructor Options
19776
19777 -AutoClose =E<gt> 0|1, -MultiStream =E<gt> 0|1, -Prime =E<gt> $string,
19778 -Transparent =E<gt> 0|1, -BlockSize =E<gt> $num, -InputLength =E<gt> $size,
19779 -Append =E<gt> 0|1, -Strict =E<gt> 0|1
19780
19781 =item Examples
19782
19783 =back
19784
19785 =item Methods 
19786
19787 =over 4
19788
19789 =item read
19790
19791 =item read
19792
19793 =item getline
19794
19795 =item getc
19796
19797 =item ungetc
19798
19799 =item inflateSync
19800
19801 =item getHeaderInfo
19802
19803 =item tell
19804
19805 =item eof
19806
19807 =item seek
19808
19809 =item binmode
19810
19811 =item fileno
19812
19813 =item close
19814
19815 =back
19816
19817 =item Importing 
19818
19819 :all
19820
19821 =item EXAMPLES
19822
19823 =item SEE ALSO
19824
19825 =item AUTHOR
19826
19827 =item MODIFICATION HISTORY
19828
19829 =item COPYRIGHT AND LICENSE
19830
19831 =back
19832
19833 =head2 IO::Zlib - IO:: style interface to L<Compress::Zlib>
19834
19835 =over 4
19836
19837 =item SYNOPSIS
19838
19839 =item DESCRIPTION
19840
19841 =item CONSTRUCTOR
19842
19843 new ( [ARGS] )
19844
19845 =item OBJECT METHODS
19846
19847 open ( FILENAME, MODE ), opened, close, getc, getline, getlines, print (
19848 ARGS... ), read ( BUF, NBYTES, [OFFSET] ), eof, seek ( OFFSET, WHENCE ),
19849 tell, setpos ( POS ), getpos ( POS )
19850
19851 =item USING THE EXTERNAL GZIP
19852
19853 =item CLASS METHODS
19854
19855 has_Compress_Zlib, gzip_external, gzip_used, gzip_read_open,
19856 gzip_write_open
19857
19858 =item DIAGNOSTICS
19859
19860 IO::Zlib::getlines: must be called in list context,
19861 IO::Zlib::gzopen_external: mode '...' is illegal, IO::Zlib::import: '...'
19862 is illegal, IO::Zlib::import: ':gzip_external' requires an argument,
19863 IO::Zlib::import: 'gzip_read_open' requires an argument, IO::Zlib::import:
19864 'gzip_read' '...' is illegal, IO::Zlib::import: 'gzip_write_open' requires
19865 an argument, IO::Zlib::import: 'gzip_write_open' '...' is illegal,
19866 IO::Zlib::import: no Compress::Zlib and no external gzip, IO::Zlib::open:
19867 needs a filename, IO::Zlib::READ: NBYTES must be specified, IO::Zlib::READ:
19868 OFFSET is not supported, IO::Zlib::WRITE: too long LENGTH, IO::Zlib::WRITE:
19869 OFFSET is not supported
19870
19871 =item SEE ALSO
19872
19873 =item HISTORY
19874
19875 =item COPYRIGHT
19876
19877 =back
19878
19879 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
19880 handles
19881
19882 =over 4
19883
19884 =item SYNOPSIS
19885
19886 =item DESCRIPTION
19887
19888 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
19889 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
19890
19891 =item SEE ALSO
19892
19893 =item AUTHOR
19894
19895 =item COPYRIGHT
19896
19897 =back
19898
19899 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
19900
19901 =over 4
19902
19903 =item SYNOPSIS
19904
19905 =item DESCRIPTION
19906
19907 =item CONSTRUCTOR
19908
19909 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
19910
19911 =item METHODS
19912
19913 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode(
19914 [LAYER] )
19915
19916 =item NOTE
19917
19918 =item SEE ALSO
19919
19920 =item HISTORY
19921
19922 =back
19923
19924 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
19925 handles
19926
19927 =over 4
19928
19929 =item SYNOPSIS
19930
19931 =item DESCRIPTION
19932
19933 =item CONSTRUCTOR
19934
19935 new (), new_from_fd ( FD, MODE )
19936
19937 =item METHODS
19938
19939 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
19940 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
19941 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
19942 $io->blocking ( [ BOOL ] ), $io->untaint
19943
19944 =item NOTE
19945
19946 =item SEE ALSO
19947
19948 =item BUGS
19949
19950 =item HISTORY
19951
19952 =back
19953
19954 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
19955
19956 =over 4
19957
19958 =item SYNOPSIS
19959
19960 =item DESCRIPTION
19961
19962 =item CONSTRUCTOR
19963
19964 new ( [READER, WRITER] )
19965
19966 =item METHODS
19967
19968 reader ([ARGS]), writer ([ARGS]), handles ()
19969
19970 =item SEE ALSO
19971
19972 =item AUTHOR
19973
19974 =item COPYRIGHT
19975
19976 =back
19977
19978 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
19979
19980 =over 4
19981
19982 =item SYNOPSIS
19983
19984 =item DESCRIPTION
19985
19986 =item METHODS
19987
19988 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
19989 IO ), handles( [ EVENT_MASK ] )
19990
19991 =item SEE ALSO
19992
19993 =item AUTHOR
19994
19995 =item COPYRIGHT
19996
19997 =back
19998
19999 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
20000 I/O objects
20001
20002 =over 4
20003
20004 =item SYNOPSIS
20005
20006 =item DESCRIPTION
20007
20008 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
20009 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
20010 $io->tell
20011
20012 =item SEE ALSO
20013
20014 =item HISTORY
20015
20016 =back
20017
20018 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
20019 call
20020
20021 =over 4
20022
20023 =item SYNOPSIS
20024
20025 =item DESCRIPTION
20026
20027 =item CONSTRUCTOR
20028
20029 new ( [ HANDLES ] )
20030
20031 =item METHODS
20032
20033 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
20034 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
20035 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
20036
20037 =item EXAMPLE
20038
20039 =item AUTHOR
20040
20041 =item COPYRIGHT
20042
20043 =back
20044
20045 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
20046 communications
20047
20048 =over 4
20049
20050 =item SYNOPSIS
20051
20052 =item DESCRIPTION
20053
20054 =item CONSTRUCTOR
20055
20056 new ( [ARGS] )
20057
20058 =item METHODS
20059
20060 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
20061 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
20062
20063 =item SEE ALSO
20064
20065 =item AUTHOR
20066
20067 =item COPYRIGHT
20068
20069 =back
20070
20071 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
20072 AF_INET domain sockets
20073
20074 =over 4
20075
20076 =item SYNOPSIS
20077
20078 =item DESCRIPTION
20079
20080 =item CONSTRUCTOR
20081
20082 new ( [ARGS] )
20083
20084 =over 4
20085
20086 =item METHODS
20087
20088 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
20089 ()
20090
20091 =back
20092
20093 =item SEE ALSO
20094
20095 =item AUTHOR
20096
20097 =item COPYRIGHT
20098
20099 =back
20100
20101 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
20102 AF_UNIX domain sockets
20103
20104 =over 4
20105
20106 =item SYNOPSIS
20107
20108 =item DESCRIPTION
20109
20110 =item CONSTRUCTOR
20111
20112 new ( [ARGS] )
20113
20114 =item METHODS
20115
20116 hostpath(), peerpath()
20117
20118 =item SEE ALSO
20119
20120 =item AUTHOR
20121
20122 =item COPYRIGHT
20123
20124 =back
20125
20126 =head2 IPC::Msg - SysV Msg IPC object class
20127
20128 =over 4
20129
20130 =item SYNOPSIS
20131
20132 =item DESCRIPTION
20133
20134 =item METHODS
20135
20136 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
20137 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
20138 FLAGS ] ), stat
20139
20140 =item SEE ALSO
20141
20142 =item AUTHOR
20143
20144 =item COPYRIGHT
20145
20146 =back
20147
20148 =head2 IPC::Open2, open2 - open a process for both reading and writing
20149
20150 =over 4
20151
20152 =item SYNOPSIS
20153
20154 =item DESCRIPTION
20155
20156 =item WARNING 
20157
20158 =item SEE ALSO
20159
20160 =back
20161
20162 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
20163 handling
20164
20165 =over 4
20166
20167 =item SYNOPSIS
20168
20169 =item DESCRIPTION
20170
20171 =item WARNING
20172
20173 =back
20174
20175 =head2 IPC::Semaphore - SysV Semaphore IPC object class
20176
20177 =over 4
20178
20179 =item SYNOPSIS
20180
20181 =item DESCRIPTION
20182
20183 =item METHODS
20184
20185 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
20186 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
20187 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
20188 , VALUE ), stat
20189
20190 =item SEE ALSO
20191
20192 =item AUTHOR
20193
20194 =item COPYRIGHT
20195
20196 =back
20197
20198 =head2 IPC::SysV - SysV IPC constants
20199
20200 =over 4
20201
20202 =item SYNOPSIS
20203
20204 =item DESCRIPTION
20205
20206 ftok( PATH, ID )
20207
20208 =item SEE ALSO
20209
20210 =item AUTHORS
20211
20212 =item COPYRIGHT
20213
20214 =back
20215
20216 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
20217
20218 =over 4
20219
20220 =item SYNOPSIS
20221
20222 =item DESCRIPTION
20223
20224 =item METHODS
20225
20226 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
20227 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
20228 FLAGS ] ), stat
20229
20230 =item SEE ALSO
20231
20232 =item AUTHOR
20233
20234 =item COPYRIGHT
20235
20236 =back
20237
20238 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
20239 class
20240
20241 =over 4
20242
20243 =item SYNOPSIS
20244
20245 =item DESCRIPTION
20246
20247 =item METHODS
20248
20249 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
20250 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
20251 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
20252 , VALUE ), stat
20253
20254 =item SEE ALSO
20255
20256 =item AUTHOR
20257
20258 =item COPYRIGHT
20259
20260 =back
20261
20262 =head2 List::Util - A selection of general-utility list subroutines
20263
20264 =over 4
20265
20266 =item SYNOPSIS
20267
20268 =item DESCRIPTION
20269
20270 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
20271 BLOCK LIST, shuffle LIST, sum LIST
20272
20273 =item KNOWN BUGS
20274
20275 =item SUGGESTED ADDITIONS
20276
20277 =item COPYRIGHT
20278
20279 =back
20280
20281 =head2 List::Utilib::List::Util, List::Util - A selection of
20282 general-utility list subroutines
20283
20284 =over 4
20285
20286 =item SYNOPSIS
20287
20288 =item DESCRIPTION
20289
20290 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
20291 BLOCK LIST, shuffle LIST, sum LIST
20292
20293 =item KNOWN BUGS
20294
20295 =item SUGGESTED ADDITIONS
20296
20297 =item COPYRIGHT
20298
20299 =back
20300
20301 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
20302 general-utility scalar subroutines
20303
20304 =over 4
20305
20306 =item SYNOPSIS
20307
20308 =item DESCRIPTION
20309
20310 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
20311 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
20312 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
20313
20314 =item KNOWN BUGS
20315
20316 =item COPYRIGHT
20317
20318 =item BLATANT PLUG
20319
20320 =back
20321
20322 =head2 Locale::Constants - constants for Locale codes
20323
20324 =over 4
20325
20326 =item SYNOPSIS
20327
20328 =item DESCRIPTION
20329
20330 =item KNOWN BUGS AND LIMITATIONS
20331
20332 =item SEE ALSO
20333
20334 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
20335
20336 =item AUTHOR
20337
20338 =item COPYRIGHT
20339
20340 =back
20341
20342 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
20343
20344 =over 4
20345
20346 =item SYNOPSIS
20347
20348 =item DESCRIPTION
20349
20350 B<alpha-2>, B<alpha-3>, B<numeric>
20351
20352 =item CONVERSION ROUTINES
20353
20354 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
20355 country_code2code( CODE, CODESET, CODESET )
20356
20357 =item QUERY ROUTINES
20358
20359 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
20360
20361 =item SEMI-PRIVATE ROUTINES
20362
20363 =over 4
20364
20365 =item alias_code
20366
20367 =item rename_country
20368
20369 =back
20370
20371 =item EXAMPLES
20372
20373 =item DOMAIN NAMES
20374
20375 =item KNOWN BUGS AND LIMITATIONS
20376
20377 =item SEE ALSO
20378
20379 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
20380 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
20381 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
20382 http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
20383
20384 =item AUTHOR
20385
20386 =item COPYRIGHT
20387
20388 =back
20389
20390 =head2 Locale::Currency - ISO three letter codes for currency
20391 identification (ISO 4217)
20392
20393 =over 4
20394
20395 =item SYNOPSIS
20396
20397 =item DESCRIPTION
20398
20399 XTS, XXX
20400
20401 =item CONVERSION ROUTINES
20402
20403 code2currency(), currency2code()
20404
20405 =item QUERY ROUTINES
20406
20407 C<all_currency_codes()>, C<all_currency_names()>
20408
20409 =item EXAMPLES
20410
20411 =item KNOWN BUGS AND LIMITATIONS
20412
20413 =item SEE ALSO
20414
20415 Locale::Country, Locale::Script, ISO 4217:1995,
20416 http://www.bsi-global.com/iso4217currency
20417
20418 =item AUTHOR
20419
20420 =item COPYRIGHT
20421
20422 =back
20423
20424 =head2 Locale::Language - ISO two letter codes for language identification
20425 (ISO 639)
20426
20427 =over 4
20428
20429 =item SYNOPSIS
20430
20431 =item DESCRIPTION
20432
20433 =item CONVERSION ROUTINES
20434
20435 code2language(), language2code()
20436
20437 =item QUERY ROUTINES
20438
20439 C<all_language_codes()>, C<all_language_names()>
20440
20441 =item EXAMPLES
20442
20443 =item KNOWN BUGS AND LIMITATIONS
20444
20445 =item SEE ALSO
20446
20447 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
20448 http://lcweb.loc.gov/standards/iso639-2/langhome.html
20449
20450 =item AUTHOR
20451
20452 =item COPYRIGHT
20453
20454 =back
20455
20456 =head2 Locale::Maketext - framework for localization
20457
20458 =over 4
20459
20460 =item SYNOPSIS
20461
20462 =item DESCRIPTION
20463
20464 =item QUICK OVERVIEW
20465
20466 =item METHODS
20467
20468 =over 4
20469
20470 =item Construction Methods
20471
20472 =item The "maketext" Method
20473
20474 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
20475
20476 =item Utility Methods
20477
20478 $language->quant($number, $singular), $language->quant($number, $singular,
20479 $plural), $language->quant($number, $singular, $plural, $negative),
20480 $language->numf($number), $language->sprintf($format, @items),
20481 $language->language_tag(), $language->encoding()
20482
20483 =item Language Handle Attributes and Internals
20484
20485 =back
20486
20487 =item LANGUAGE CLASS HIERARCHIES
20488
20489 =item ENTRIES IN EACH LEXICON
20490
20491 =item BRACKET NOTATION
20492
20493 =item AUTO LEXICONS
20494
20495 =item CONTROLLING LOOKUP FAILURE
20496
20497 =item HOW TO USE MAKETEXT
20498
20499 =item SEE ALSO
20500
20501 =item COPYRIGHT AND DISCLAIMER
20502
20503 =item AUTHOR
20504
20505 =back
20506
20507 =head2 Locale::Maketext::TPJ13 -- article about software localization
20508
20509 =over 4
20510
20511 =item SYNOPSIS
20512
20513 =item DESCRIPTION
20514
20515 =item Localization and Perl: gettext breaks, Maketext fixes
20516
20517 =over 4
20518
20519 =item A Localization Horror Story: It Could Happen To You
20520
20521 =item The Linguistic View
20522
20523 =item Breaking gettext
20524
20525 =item Replacing gettext
20526
20527 =item Buzzwords: Abstraction and Encapsulation
20528
20529 =item Buzzword: Isomorphism
20530
20531 =item Buzzword: Inheritance
20532
20533 =item Buzzword: Concision
20534
20535 =item The Devil in the Details
20536
20537 =item The Proof in the Pudding: Localizing Web Sites
20538
20539 =item References
20540
20541 =back
20542
20543 =back
20544
20545 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
20546
20547 =over 4
20548
20549 =item SYNOPSIS
20550
20551 =item DESCRIPTION
20552
20553 B<alpha-2>, B<alpha-3>, B<numeric>
20554
20555 =over 4
20556
20557 =item SPECIAL CODES
20558
20559 =back
20560
20561 =item CONVERSION ROUTINES
20562
20563 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
20564 script_code2code( CODE, CODESET, CODESET )
20565
20566 =item QUERY ROUTINES
20567
20568 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
20569
20570 =item EXAMPLES
20571
20572 =item KNOWN BUGS AND LIMITATIONS
20573
20574 =item SEE ALSO
20575
20576 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
20577 http://www.evertype.com/standards/iso15924/
20578
20579 =item AUTHOR
20580
20581 =item COPYRIGHT
20582
20583 =back
20584
20585 =head2 MIME::Base64 - Encoding and decoding of base64 strings
20586
20587 =over 4
20588
20589 =item SYNOPSIS
20590
20591 =item DESCRIPTION
20592
20593 encode_base64($str), encode_base64($str, $eol);, decode_base64($str)
20594
20595 =item DIAGNOSTICS
20596
20597 Premature end of base64 data, Premature padding of base64 data, Wide
20598 character in subroutine entry
20599
20600 =item EXAMPLES
20601
20602 =item COPYRIGHT
20603
20604 =item SEE ALSO
20605
20606 =back
20607
20608 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
20609 of quoted-printable strings
20610
20611 =over 4
20612
20613 =item SYNOPSIS
20614
20615 =item DESCRIPTION
20616
20617 encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode),
20618 decode_qp($str);
20619
20620 =item COPYRIGHT
20621
20622 =item SEE ALSO
20623
20624 =back
20625
20626 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
20627 strings
20628
20629 =over 4
20630
20631 =item SYNOPSIS
20632
20633 =item DESCRIPTION
20634
20635 encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode),
20636 decode_qp($str);
20637
20638 =item COPYRIGHT
20639
20640 =item SEE ALSO
20641
20642 =back
20643
20644 =head2 Math::BigFloat - Arbitrary size floating point math package
20645
20646 =over 4
20647
20648 =item SYNOPSIS
20649
20650 =item DESCRIPTION
20651
20652 =over 4
20653
20654 =item Canonical notation
20655
20656 =item Output
20657
20658 =item C<mantissa()>, C<exponent()> and C<parts()>
20659
20660 =item Accuracy vs. Precision
20661
20662 =item Rounding
20663
20664 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
20665 ), fround  ( -$scale ) and fround ( 0 )
20666
20667 =back
20668
20669 =item METHODS
20670
20671 =over 4
20672
20673 =item accuracy
20674
20675 =item precision()
20676
20677 =back
20678
20679 =item Autocreating constants
20680
20681 =over 4
20682
20683 =item Math library
20684
20685 =item Using Math::BigInt::Lite
20686
20687 =back
20688
20689 =item BUGS
20690
20691 =item CAVEATS
20692
20693 stringify, bstr(), bdiv, Modifying and =, bpow, precision() vs. accuracy()
20694
20695 =item SEE ALSO
20696
20697 =item LICENSE
20698
20699 =item AUTHORS
20700
20701 =back
20702
20703 =head2 Math::BigInt - Arbitrary size integer/float math package
20704
20705 =over 4
20706
20707 =item SYNOPSIS
20708
20709 =item DESCRIPTION
20710
20711 Input, Output
20712
20713 =item METHODS
20714
20715 =over 4
20716
20717 =item config
20718
20719 =item accuracy
20720
20721 =item precision
20722
20723 =item brsft
20724
20725 =item new
20726
20727 =item bnan
20728
20729 =item bzero
20730
20731 =item binf
20732
20733 =item bone
20734
20735 =item is_one()/is_zero()/is_nan()/is_inf()
20736
20737 =item is_pos()/is_neg()
20738
20739         $x->is_pos();                   # true if > 0
20740         $x->is_neg();                   # true if < 0
20741
20742 =item is_odd()/is_even()/is_int()
20743
20744 =item bcmp
20745
20746 =item bacmp
20747
20748 =item sign
20749
20750 =item digit
20751
20752 =item bneg
20753
20754 =item babs
20755
20756 =item bnorm
20757
20758 =item bnot
20759
20760 =item binc
20761
20762 =item bdec
20763
20764 =item badd
20765
20766 =item bsub
20767
20768 =item bmul
20769
20770 =item bdiv
20771
20772 =item bmod
20773
20774 =item bmodinv
20775
20776 =item bmodpow
20777
20778 =item bpow
20779
20780 =item blsft
20781
20782 =item brsft
20783
20784 =item band
20785
20786 =item bior
20787
20788 =item bxor
20789
20790 =item bnot
20791
20792 =item bsqrt
20793
20794 =item bfac
20795
20796 =item round
20797
20798 =item bround
20799
20800 =item bfround
20801
20802 =item bfloor
20803
20804 =item bceil
20805
20806 =item bgcd
20807
20808 =item blcm
20809
20810 =item exponent
20811
20812 =item mantissa
20813
20814 =item parts
20815
20816 =item copy
20817
20818 =item as_int
20819
20820 =item bsstr
20821
20822 =item as_hex
20823
20824 =item as_bin
20825
20826 =back
20827
20828 =item ACCURACY and PRECISION
20829
20830 =over 4
20831
20832 =item Precision P
20833
20834 =item Accuracy A
20835
20836 =item Fallback F
20837
20838 =item Rounding mode R
20839
20840 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
20841 (significant digits), Setting/Accessing, Creating numbers, Usage,
20842 Precedence, Overriding globals, Local settings, Rounding, Default values,
20843 Remarks
20844
20845 =back
20846
20847 =item Infinity and Not a Number
20848
20849 oct()/hex(), log(-inf), exp(), cos(), sin(), atan2()
20850
20851 =item INTERNALS
20852
20853 =over 4
20854
20855 =item MATH LIBRARY
20856
20857 =item SIGN
20858
20859 =item mantissa(), exponent() and parts()
20860
20861 =back
20862
20863 =item EXAMPLES
20864
20865   use Math::BigInt;
20866
20867 =item Autocreating constants
20868
20869 =item PERFORMANCE
20870
20871 =over 4
20872
20873 =item Alternative math libraries
20874
20875 =item SUBCLASSING
20876
20877 =back
20878
20879 =item Subclassing Math::BigInt
20880
20881 =item UPGRADING
20882
20883 =over 4
20884
20885 =item Auto-upgrade
20886
20887 bsqrt(), div(), blog()
20888
20889 =back
20890
20891 =item BUGS
20892
20893 broot() does not work, Out of Memory!, Fails to load Calc on Perl prior
20894 5.6.0
20895
20896 =item CAVEATS
20897
20898 bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling,
20899 Modifying and =, bpow, Overloading -$x, Mixing different object types,
20900 bsqrt(), brsft()
20901
20902 =item LICENSE
20903
20904 =item SEE ALSO
20905
20906 =item AUTHORS
20907
20908 =back
20909
20910 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
20911
20912 =over 4
20913
20914 =item SYNOPSIS
20915
20916 =item DESCRIPTION
20917
20918 =item STORAGE
20919
20920 =item METHODS
20921
20922 =item WRAP YOUR OWN
20923
20924 =item LICENSE
20925
20926 This program is free software; you may redistribute it and/or modify it
20927 under
20928 the same terms as Perl itself. 
20929
20930 =item AUTHORS
20931
20932 =item SEE ALSO
20933
20934 =back
20935
20936 =head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code
20937
20938 =over 4
20939
20940 =item SYNOPSIS
20941
20942 =item DESCRIPTION
20943
20944 =item METHODS
20945
20946 =over 4
20947
20948 =item __emu_bxor
20949
20950 =item __emu_band
20951
20952 =item __emu_bior
20953
20954 =back
20955
20956 =item LICENSE
20957
20958 This program is free software; you may redistribute it and/or modify it
20959 under
20960 the same terms as Perl itself. 
20961
20962 =item AUTHORS
20963
20964 =item SEE ALSO
20965
20966 =back
20967
20968 =head2 Math::BigInt::FastCalc - Math::BigInt::Calc with some XS for more
20969 speed
20970
20971 =over 4
20972
20973 =item SYNOPSIS
20974
20975 =item DESCRIPTION
20976
20977 =item STORAGE
20978
20979 =item METHODS
20980
20981 =item LICENSE
20982
20983 This program is free software; you may redistribute it and/or modify it
20984 under
20985 the same terms as Perl itself. 
20986
20987 =item AUTHORS
20988
20989 =item SEE ALSO
20990
20991 =back
20992
20993 =head2 Math::BigRat - Arbitrary big rational numbers
20994
20995 =over 4
20996
20997 =item SYNOPSIS
20998
20999 =item DESCRIPTION
21000
21001 =over 4
21002
21003 =item MATH LIBRARY
21004
21005 =back
21006
21007 =item METHODS
21008
21009 =over 4
21010
21011 =item new()
21012
21013 =item numerator()
21014
21015 =item denominator()
21016
21017         $d = $x->denominator();
21018
21019 =item parts()
21020
21021 =item as_int()
21022
21023 =item as_hex()
21024
21025 =item as_bin()
21026
21027 =item bfac()
21028
21029 =item blog()
21030
21031 =item bround()/round()/bfround()
21032
21033 =item bmod()
21034
21035 =item is_one()
21036
21037 =item is_zero()
21038
21039 =item is_pos()
21040
21041 =item is_neg()
21042
21043 =item is_int()
21044
21045 =item is_odd()
21046
21047 =item is_even()
21048
21049 =item bceil()
21050
21051 =item bfloor()
21052
21053         $x->bfloor();
21054
21055 =item bsqrt()
21056
21057         $x->bsqrt();
21058
21059 =item config
21060
21061 =back
21062
21063 =item BUGS
21064
21065 inf handling (partial), NaN handling (partial), rounding (not implemented
21066 except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(),
21067 blog(), bmodinv() and bmodpow() (partial)
21068
21069 =item LICENSE
21070
21071 =item SEE ALSO
21072
21073 =item AUTHORS
21074
21075 =back
21076
21077 =head2 Math::Complex - complex numbers and associated mathematical
21078 functions
21079
21080 =over 4
21081
21082 =item SYNOPSIS
21083
21084 =item DESCRIPTION
21085
21086 =item OPERATIONS
21087
21088 =item CREATION
21089
21090 =item DISPLAYING
21091
21092 =over 4
21093
21094 =item CHANGED IN PERL 5.6
21095
21096 =back
21097
21098 =item USAGE
21099
21100 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
21101
21102 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
21103
21104 =item BUGS
21105
21106 =item AUTHORS
21107
21108 =back
21109
21110 =head2 Math::Trig - trigonometric functions
21111
21112 =over 4
21113
21114 =item SYNOPSIS
21115
21116 =item DESCRIPTION
21117
21118 =item TRIGONOMETRIC FUNCTIONS
21119
21120 B<tan>
21121
21122 =over 4
21123
21124 =item ERRORS DUE TO DIVISION BY ZERO
21125
21126 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
21127
21128 =back
21129
21130 =item PLANE ANGLE CONVERSIONS
21131
21132 =item RADIAL COORDINATE CONVERSIONS
21133
21134 =over 4
21135
21136 =item COORDINATE SYSTEMS
21137
21138 =item 3-D ANGLE CONVERSIONS
21139
21140 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
21141 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
21142
21143 =back
21144
21145 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
21146
21147 =item EXAMPLES
21148
21149 =over 4
21150
21151 =item CAVEAT FOR GREAT CIRCLE FORMULAS
21152
21153 =back
21154
21155 =item BUGS
21156
21157 =item AUTHORS
21158
21159 =back
21160
21161 =head2 Memoize - Make functions faster by trading space for time
21162
21163 =over 4
21164
21165 =item SYNOPSIS
21166
21167 =item DESCRIPTION
21168
21169 =item DETAILS
21170
21171 =item OPTIONS
21172
21173 =over 4
21174
21175 =item INSTALL
21176
21177 =item NORMALIZER
21178
21179 =item C<SCALAR_CACHE>, C<LIST_CACHE>
21180
21181 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
21182
21183 =back
21184
21185 =item OTHER FACILITIES
21186
21187 =over 4
21188
21189 =item C<unmemoize>
21190
21191 =item C<flush_cache>
21192
21193 =back
21194
21195 =item CAVEATS
21196
21197 =item PERSISTENT CACHE SUPPORT
21198
21199 =item EXPIRATION SUPPORT
21200
21201 =item BUGS
21202
21203 =item MAILING LIST
21204
21205 =item AUTHOR
21206
21207 =item COPYRIGHT AND LICENSE
21208
21209 =item THANK YOU
21210
21211 =back
21212
21213 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
21214 Storable use
21215
21216 =over 4
21217
21218 =item DESCRIPTION
21219
21220 =back
21221
21222 =head2 Memoize::Expire - Plug-in module for automatic expiration of
21223 memoized values
21224
21225 =over 4
21226
21227 =item SYNOPSIS
21228
21229 =item DESCRIPTION
21230
21231 =item INTERFACE
21232
21233  TIEHASH,  EXISTS,  STORE
21234
21235 =item ALTERNATIVES
21236
21237 =item CAVEATS
21238
21239 =item AUTHOR
21240
21241 =item SEE ALSO
21242
21243 =back
21244
21245 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
21246
21247 =over 4
21248
21249 =item DESCRIPTION
21250
21251 =back
21252
21253 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
21254
21255 =over 4
21256
21257 =item DESCRIPTION
21258
21259 =back
21260
21261 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
21262 Storable use
21263
21264 =over 4
21265
21266 =item DESCRIPTION
21267
21268 =back
21269
21270 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
21271 Storable use
21272
21273 =over 4
21274
21275 =item DESCRIPTION
21276
21277 =back
21278
21279 =head2 Memoize::Storable - store Memoized data in Storable database
21280
21281 =over 4
21282
21283 =item DESCRIPTION
21284
21285 =back
21286
21287 =head2 Module::CoreList - what modules shipped with versions of perl
21288
21289 =over 4
21290
21291 =item SYNOPSIS
21292
21293 =item DESCRIPTION
21294
21295 =item CAVEATS
21296
21297 =item HISTORY
21298
21299 =item AUTHOR
21300
21301 =item COPYRIGHT
21302
21303 =item SEE ALSO
21304
21305 =back
21306
21307 =head2 NDBM_File - Tied access to ndbm files
21308
21309 =over 4
21310
21311 =item SYNOPSIS
21312
21313 =item DESCRIPTION
21314
21315 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
21316
21317 =item DIAGNOSTICS
21318
21319 =over 4
21320
21321 =item C<ndbm store returned -1, errno 22, key "..." at ...>
21322
21323 =back
21324
21325 =item BUGS AND WARNINGS
21326
21327 =back
21328
21329 =head2 NEXT - Provide a pseudo-class NEXT (et al) that allows method
21330 redispatch
21331
21332 =over 4
21333
21334 =item SYNOPSIS
21335
21336 =item DESCRIPTION
21337
21338 =over 4
21339
21340 =item Enforcing redispatch
21341
21342 =item Avoiding repetitions
21343
21344 =item Invoking all versions of a method with a single call
21345
21346 =item Using C<EVERY> methods
21347
21348 =back
21349
21350 =item AUTHOR
21351
21352 =item BUGS AND IRRITATIONS
21353
21354 =item COPYRIGHT
21355
21356 =back
21357
21358 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
21359
21360 =over 4
21361
21362 =item SYNOPSIS
21363
21364 =item DESCRIPTION
21365
21366 =item USER METHODS
21367
21368 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
21369 dataend ()
21370
21371 =item CLASS METHODS
21372
21373 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
21374 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
21375 ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh ()
21376
21377 =item EXPORTS
21378
21379 =item AUTHOR
21380
21381 =item COPYRIGHT
21382
21383 =back
21384
21385 =head2 Net::Config - Local configuration data for libnet
21386
21387 =over 4
21388
21389 =item SYNOPSYS
21390
21391 =item DESCRIPTION
21392
21393 =item METHODS
21394
21395 requires_firewall HOST
21396
21397 =item NetConfig VALUES
21398
21399 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
21400 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
21401 ftp_int_passive, local_netmask, test_hosts, test_exists
21402
21403 =back
21404
21405 =head2 Net::Domain - Attempt to evaluate the current host's internet name
21406 and domain
21407
21408 =over 4
21409
21410 =item SYNOPSIS
21411
21412 =item DESCRIPTION
21413
21414 hostfqdn (), domainname (), hostname (), hostdomain ()
21415
21416 =item AUTHOR
21417
21418 =item COPYRIGHT
21419
21420 =back
21421
21422 =head2 Net::FTP - FTP Client class
21423
21424 =over 4
21425
21426 =item SYNOPSIS
21427
21428 =item DESCRIPTION
21429
21430 =item OVERVIEW
21431
21432 =item CONSTRUCTOR
21433
21434 new ([ HOST ] [, OPTIONS ])
21435
21436 =item METHODS
21437
21438 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
21439 site (ARGS), ascii, binary, rename ( OLDNAME, NEWNAME ), delete ( FILENAME
21440 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR [,
21441 RECURSE ]), mkdir ( DIR [, RECURSE ]), alloc ( SIZE [, RECORD_SIZE] ), ls (
21442 [ DIR ] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ),
21443 put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE
21444 ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ),
21445 size ( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[
21446 BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ DIR ] ), retr ( FILE ),
21447 stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [ PORT ] ), pasv (),
21448 pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_xfer_unique (
21449 SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( NON_PASV_SERVER ),
21450 abort (), quit ()
21451
21452 =over 4
21453
21454 =item Methods for the adventurous
21455
21456 quot (CMD [,ARGS])
21457
21458 =back
21459
21460 =item THE dataconn CLASS
21461
21462 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
21463 bytes_read (), abort (), close ()
21464
21465 =item UNIMPLEMENTED
21466
21467 B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
21468
21469 =item REPORTING BUGS
21470
21471 =item AUTHOR
21472
21473 =item SEE ALSO
21474
21475 =item USE EXAMPLES
21476
21477 http://www.csh.rit.edu/~adam/Progs/
21478
21479 =item CREDITS
21480
21481 =item COPYRIGHT
21482
21483 =back
21484
21485 =head2 Net::NNTP - NNTP Client class
21486
21487 =over 4
21488
21489 =item SYNOPSIS
21490
21491 =item DESCRIPTION
21492
21493 =item CONSTRUCTOR
21494
21495 new ( [ HOST ] [, OPTIONS ])
21496
21497 =item METHODS
21498
21499 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
21500 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
21501 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
21502 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
21503 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
21504 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
21505 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
21506
21507 =over 4
21508
21509 =item Extension methods
21510
21511 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
21512 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
21513 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
21514 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
21515 GROUP ] ), reader
21516
21517 =back
21518
21519 =item UNSUPPORTED
21520
21521 =item DEFINITIONS
21522
21523 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
21524
21525 =item SEE ALSO
21526
21527 =item AUTHOR
21528
21529 =item COPYRIGHT
21530
21531 =back
21532
21533 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
21534
21535 =over 4
21536
21537 =item SYNOPSIS
21538
21539 =item DESCRIPTION
21540
21541 =item CONSTRUCTOR
21542
21543 new ( [ HOST ] [, OPTIONS ] 0
21544
21545 =item METHODS
21546
21547 auth ( USERNAME, PASSWORD ), user ( USER ), pass ( PASS ), login ( [ USER
21548 [, PASS ]] ), apop ( [ USER [, PASS ]] ), banner (), capa (),  capabilities
21549 (), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [, FH ]
21550 ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ]
21551 ), delete ( MSGNUM ), reset (), quit ()
21552
21553 =item NOTES
21554
21555 =item SEE ALSO
21556
21557 =item AUTHOR
21558
21559 =item COPYRIGHT
21560
21561 =back
21562
21563 =head2 Net::Ping - check a remote host for reachability
21564
21565 =over 4
21566
21567 =item SYNOPSIS
21568
21569 =item DESCRIPTION
21570
21571 =over 4
21572
21573 =item Functions
21574
21575 Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos
21576 ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
21577 $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
21578 $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
21579 [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host
21580 [, $timeout]);
21581
21582 =back
21583
21584 =item NOTES
21585
21586 =item INSTALL
21587
21588 =item BUGS
21589
21590 =item AUTHORS
21591
21592 =item COPYRIGHT
21593
21594 =back
21595
21596 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
21597
21598 =over 4
21599
21600 =item SYNOPSIS
21601
21602 =item DESCRIPTION
21603
21604 =item EXAMPLES
21605
21606 =item CONSTRUCTOR
21607
21608 new ( [ HOST ] [, OPTIONS ] )
21609
21610 =item METHODS
21611
21612 banner (), domain (), hello ( DOMAIN ), host (), etrn ( DOMAIN ), auth (
21613 USERNAME, PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ),
21614 send_or_mail ( ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient (
21615 ADDRESS [, ADDRESS, [...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]]
21616 ), cc ( ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ),
21617 data ( [ DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [
21618 $subject ] ), quit ()
21619
21620 =item ADDRESSES
21621
21622 =item SEE ALSO
21623
21624 =item AUTHOR
21625
21626 =item COPYRIGHT
21627
21628 =back
21629
21630 =head2 Net::Time - time and daytime network client interface
21631
21632 =over 4
21633
21634 =item SYNOPSIS
21635
21636 =item DESCRIPTION
21637
21638 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
21639 PROTOCOL [, TIMEOUT]]])
21640
21641 =item AUTHOR
21642
21643 =item COPYRIGHT
21644
21645 =back
21646
21647 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
21648 functions
21649
21650 =over 4
21651
21652 =item SYNOPSIS
21653
21654 =item DESCRIPTION
21655
21656 =item EXAMPLES
21657
21658 =item NOTE
21659
21660 =item AUTHOR
21661
21662 =back
21663
21664 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
21665
21666 =over 4
21667
21668 =item DESCRIPTION
21669
21670 =over 4
21671
21672 =item Where to get this document
21673
21674 =item How to contribute to this document
21675
21676 =back
21677
21678 =item Author and Copyright Information
21679
21680 =over 4
21681
21682 =item Disclaimer
21683
21684 =back
21685
21686 =item Obtaining and installing libnet
21687
21688 =over 4
21689
21690 =item What is libnet ?
21691
21692 =item Which version of perl do I need ?
21693
21694 =item What other modules do I need ?
21695
21696 =item What machines support libnet ?
21697
21698 =item Where can I get the latest libnet release
21699
21700 =back
21701
21702 =item Using Net::FTP
21703
21704 =over 4
21705
21706 =item How do I download files from an FTP server ?
21707
21708 =item How do I transfer files in binary mode ?
21709
21710 =item How can I get the size of a file on a remote FTP server ?
21711
21712 =item How can I get the modification time of a file on a remote FTP server
21713 ?
21714
21715 =item How can I change the permissions of a file on a remote server ?
21716
21717 =item Can I do a reget operation like the ftp command ?
21718
21719 =item How do I get a directory listing from an FTP server ?
21720
21721 =item Changing directory to "" does not fail ?
21722
21723 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
21724
21725 =item I am behind an FTP proxy firewall, but cannot access machines outside
21726 ?
21727
21728 =item My ftp proxy firewall does not listen on port 21
21729
21730 =item Is it possible to change the file permissions of a file on an FTP
21731 server ?
21732
21733 =item I have seen scripts call a method message, but cannot find it
21734 documented ?
21735
21736 =item Why does Net::FTP not implement mput and mget methods
21737
21738 =back
21739
21740 =item Using Net::SMTP
21741
21742 =over 4
21743
21744 =item Why can't the part of an Email address after the @ be used as the
21745 hostname ?
21746
21747 =item Why does Net::SMTP not do DNS MX lookups ?
21748
21749 =item The verify method always returns true ?
21750
21751 =back
21752
21753 =item Debugging scripts
21754
21755 =over 4
21756
21757 =item How can I debug my scripts that use Net::* modules ?
21758
21759 =back
21760
21761 =item AUTHOR AND COPYRIGHT
21762
21763 =back
21764
21765 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
21766 functions
21767
21768 =over 4
21769
21770 =item SYNOPSIS
21771
21772 =item DESCRIPTION
21773
21774 =item EXAMPLES
21775
21776 =item NOTE
21777
21778 =item AUTHOR
21779
21780 =back
21781
21782 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
21783 functions
21784
21785 =over 4
21786
21787 =item SYNOPSIS
21788
21789 =item DESCRIPTION
21790
21791 =item NOTE
21792
21793 =item AUTHOR
21794
21795 =back
21796
21797 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
21798 functions
21799
21800 =over 4
21801
21802 =item SYNOPSIS
21803
21804 =item DESCRIPTION
21805
21806 =item EXAMPLES
21807
21808 =item NOTE
21809
21810 =item AUTHOR
21811
21812 =back
21813
21814 =head2 Netrc, Net::Netrc - OO interface to users netrc file
21815
21816 =over 4
21817
21818 =item SYNOPSIS
21819
21820 =item DESCRIPTION
21821
21822 =item THE .netrc FILE
21823
21824 machine name, default, login name, password string, account string, macdef
21825 name
21826
21827 =item CONSTRUCTOR
21828
21829 lookup ( MACHINE [, LOGIN ])
21830
21831 =item METHODS
21832
21833 login (), password (), account (), lpa ()
21834
21835 =item AUTHOR
21836
21837 =item SEE ALSO
21838
21839 =item COPYRIGHT
21840
21841 =back
21842
21843 =head2 O - Generic interface to Perl Compiler backends
21844
21845 =over 4
21846
21847 =item SYNOPSIS
21848
21849 =item DESCRIPTION
21850
21851 =item CONVENTIONS
21852
21853 =item IMPLEMENTATION
21854
21855 =item BUGS
21856
21857 =item AUTHOR
21858
21859 =back
21860
21861 =head2 ODBM_File - Tied access to odbm files
21862
21863 =over 4
21864
21865 =item SYNOPSIS
21866
21867 =item DESCRIPTION
21868
21869 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
21870
21871 =item DIAGNOSTICS
21872
21873 =over 4
21874
21875 =item C<odbm store returned -1, errno 22, key "..." at ...>
21876
21877 =back
21878
21879 =item BUGS AND WARNINGS
21880
21881 =back
21882
21883 =head2 Opcode - Disable named opcodes when compiling perl code
21884
21885 =over 4
21886
21887 =item SYNOPSIS
21888
21889 =item DESCRIPTION
21890
21891 =item NOTE
21892
21893 =item WARNING
21894
21895 =item Operator Names and Operator Lists
21896
21897 an operator name (opname), an operator tag name (optag), a negated opname
21898 or optag, an operator set (opset)
21899
21900 =item Opcode Functions
21901
21902 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
21903 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
21904 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
21905 opdump (PAT)
21906
21907 =item Manipulating Opsets
21908
21909 =item TO DO (maybe)
21910
21911 =back
21912
21913 =over 4
21914
21915 =item Predefined Opcode Tags
21916
21917 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
21918 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
21919 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
21920 :dangerous
21921
21922 =item SEE ALSO
21923
21924 =item AUTHORS
21925
21926 =back
21927
21928 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
21929 compartments
21930
21931 =over 4
21932
21933 =item SYNOPSIS
21934
21935 =item DESCRIPTION
21936
21937 a new namespace, an operator mask
21938
21939 =item WARNING
21940
21941 =over 4
21942
21943 =item RECENT CHANGES
21944
21945 =item Methods in class Safe
21946
21947 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
21948 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
21949 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
21950 root (NAMESPACE), mask (MASK)
21951
21952 =item Some Safety Issues
21953
21954 Memory, CPU, Snooping, Signals, State Changes
21955
21956 =item AUTHOR
21957
21958 =back
21959
21960 =back
21961
21962 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
21963 compiling
21964
21965 =over 4
21966
21967 =item SYNOPSIS  
21968
21969 =item DESCRIPTION
21970
21971 =item SEE ALSO
21972
21973 =back
21974
21975 =head2 POSIX - Perl interface to IEEE Std 1003.1
21976
21977 =over 4
21978
21979 =item SYNOPSIS
21980
21981 =item DESCRIPTION
21982
21983 =item NOTE
21984
21985 =item CAVEATS
21986
21987 =item FUNCTIONS
21988
21989 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
21990 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
21991 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
21992 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
21993 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
21994 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
21995 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
21996 fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv,
21997 geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid,
21998 getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha,
21999 isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace,
22000 isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime,
22001 log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr,
22002 memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice,
22003 offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc,
22004 putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename,
22005 rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid,
22006 setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
22007 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
22008 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
22009 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
22010 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
22011 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
22012 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
22013 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
22014 wctomb, write
22015
22016 =item CLASSES
22017
22018 =over 4
22019
22020 =item POSIX::SigAction
22021
22022 new, handler, mask, flags, safe
22023
22024 =item POSIX::SigRt
22025
22026 %SIGRT, SIGRTMIN, SIGRTMAX
22027
22028 =item POSIX::SigSet
22029
22030 new, addset, delset, emptyset, fillset, ismember
22031
22032 =item POSIX::Termios
22033
22034 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
22035 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
22036 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
22037 field values, c_cflag field values, c_iflag field values, c_lflag field
22038 values, c_oflag field values
22039
22040 =back
22041
22042 =item PATHNAME CONSTANTS
22043
22044 Constants
22045
22046 =item POSIX CONSTANTS
22047
22048 Constants
22049
22050 =item SYSTEM CONFIGURATION
22051
22052 Constants
22053
22054 =item ERRNO
22055
22056 Constants
22057
22058 =item FCNTL
22059
22060 Constants
22061
22062 =item FLOAT
22063
22064 Constants
22065
22066 =item LIMITS
22067
22068 Constants
22069
22070 =item LOCALE
22071
22072 Constants
22073
22074 =item MATH
22075
22076 Constants
22077
22078 =item SIGNAL
22079
22080 Constants
22081
22082 =item STAT
22083
22084 Constants, Macros
22085
22086 =item STDLIB
22087
22088 Constants
22089
22090 =item STDIO
22091
22092 Constants
22093
22094 =item TIME
22095
22096 Constants
22097
22098 =item UNISTD
22099
22100 Constants
22101
22102 =item WAIT
22103
22104 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
22105 WTERMSIG, WIFSTOPPED, WSTOPSIG
22106
22107 =back
22108
22109 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
22110 name space
22111
22112 =over 4
22113
22114 =item SYNOPSIS
22115
22116 =item DESCRIPTION
22117
22118 :unix, :stdio, :perlio, :crlf, :mmap, :utf8, :bytes, :raw, :pop, :win32
22119
22120 =over 4
22121
22122 =item Custom Layers
22123
22124 :encoding, :via
22125
22126 =item Alternatives to raw
22127
22128 =item Defaults and how to override them
22129
22130 =item Querying the layers of filehandles
22131
22132 =back
22133
22134 =item AUTHOR
22135
22136 =item SEE ALSO
22137
22138 =back
22139
22140 =head2 PerlIO::encoding - encoding layer
22141
22142 =over 4
22143
22144 =item SYNOPSIS
22145
22146 =item DESCRIPTION
22147
22148 =item SEE ALSO
22149
22150 =back
22151
22152 =head2 PerlIO::scalar - in-memory IO, scalar IO
22153
22154 =over 4
22155
22156 =item SYNOPSIS
22157
22158 =item DESCRIPTION
22159
22160 =item IMPLEMENTATION NOTE
22161
22162 =back
22163
22164 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
22165
22166 =over 4
22167
22168 =item SYNOPSIS
22169
22170 =item DESCRIPTION
22171
22172 =item EXPECTED METHODS
22173
22174 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
22175 $obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]),
22176 $obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]),
22177 $obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh),
22178 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
22179 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
22180 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
22181 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
22182
22183 =item EXAMPLES
22184
22185 =over 4
22186
22187 =item Example - a Hexadecimal Handle
22188
22189 =back
22190
22191 =back
22192
22193 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
22194
22195 =over 4
22196
22197 =item SYNOPSIS
22198
22199 =item DESCRIPTION
22200
22201 =item REQUIRED MODULES
22202
22203 =item SEE ALSO
22204
22205 =item ACKNOWLEDGEMENTS
22206
22207 =item COPYRIGHT
22208
22209 =back
22210
22211 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
22212
22213 =over 4
22214
22215 =item SYNOPSIS
22216
22217 =item OPTIONS/ARGUMENTS
22218
22219 =over 4
22220
22221 =item podchecker()
22222
22223 B<-warnings> =E<gt> I<val>
22224
22225 =back
22226
22227 =item DESCRIPTION
22228
22229 =item DIAGNOSTICS
22230
22231 =over 4
22232
22233 =item Errors
22234
22235 empty =headn, =over on line I<N> without closing =back, =item without
22236 previous =over, =back without previous =over, No argument for =begin, =end
22237 without =begin, Nested =begin's, =for without formatter specification,
22238 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
22239 interior-sequence "I<SEQ>", nested commands
22240 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
22241 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
22242 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
22243 after =back
22244
22245 =item Warnings
22246
22247 multiple occurrence of link target I<name>, line containing nothing but
22248 whitespace in paragraph, file does not start with =head, previous =item has
22249 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
22250 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
22251 items in =over, No argument for =item, empty section in previous paragraph,
22252 Verbatim paragraph in NAME section, =headI<n> without preceding higher
22253 level
22254
22255 =item Hyperlinks
22256
22257 ignoring leading/trailing whitespace in link, (section) in '$page'
22258 deprecated, alternative text/node '%s' contains non-escaped | or /
22259
22260 =back
22261
22262 =item RETURN VALUE
22263
22264 =item EXAMPLES
22265
22266 =item INTERFACE
22267
22268 =back
22269
22270 C<Pod::Checker-E<gt>new( %options )>
22271
22272 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
22273 @args )>
22274
22275 C<$checker-E<gt>num_errors()>
22276
22277 C<$checker-E<gt>num_warnings()>
22278
22279 C<$checker-E<gt>name()>
22280
22281 C<$checker-E<gt>node()>
22282
22283 C<$checker-E<gt>idx()>
22284
22285 C<$checker-E<gt>hyperlink()>
22286
22287 =over 4
22288
22289 =item AUTHOR
22290
22291 =back
22292
22293 =head2 Pod::Escapes -- for resolving Pod EE<lt>...E<gt> sequences
22294
22295 =over 4
22296
22297 =item SYNOPSIS
22298
22299 =item DESCRIPTION
22300
22301 =item GOODIES
22302
22303 e2char($e_content), e2charnum($e_content), $Name2character{I<name>},
22304 $Name2character_number{I<name>}, $Latin1Code_to_fallback{I<integer>},
22305 $Latin1Char_to_fallback{I<character>}, $Code2USASCII{I<integer>}
22306
22307 =item CAVEATS
22308
22309 =item SEE ALSO
22310
22311 =item COPYRIGHT AND DISCLAIMERS
22312
22313 =item AUTHOR
22314
22315 =back
22316
22317 =head2 Pod::Find - find POD documents in directory trees
22318
22319 =over 4
22320
22321 =item SYNOPSIS
22322
22323 =item DESCRIPTION
22324
22325 =back
22326
22327 =over 4
22328
22329 =item C<pod_find( { %opts } , @directories )>
22330
22331 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
22332 1>
22333
22334 =back
22335
22336 =over 4
22337
22338 =item C<simplify_name( $str )>
22339
22340 =back
22341
22342 =over 4
22343
22344 =item C<pod_where( { %opts }, $pod )>
22345
22346 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
22347 1>
22348
22349 =back
22350
22351 =over 4
22352
22353 =item C<contains_pod( $file , $verbose )>
22354
22355 =back
22356
22357 =over 4
22358
22359 =item AUTHOR
22360
22361 =item SEE ALSO
22362
22363 =back
22364
22365 =head2 Pod::Html - module to convert pod files to HTML
22366
22367 =over 4
22368
22369 =item SYNOPSIS
22370
22371 =item DESCRIPTION
22372
22373 =item ARGUMENTS
22374
22375 backlink, cachedir, css, flush, header, help, hiddendirs, htmldir,
22376 htmlroot, index, infile, libpods, netscape, outfile, podpath, podroot,
22377 quiet, recurse, title, verbose
22378
22379 =item EXAMPLE
22380
22381 =item ENVIRONMENT
22382
22383 =item AUTHOR
22384
22385 =item SEE ALSO
22386
22387 =item COPYRIGHT
22388
22389 =back
22390
22391 =head2 Pod::InputObjects - objects representing POD input paragraphs,
22392 commands, etc.
22393
22394 =over 4
22395
22396 =item SYNOPSIS
22397
22398 =item REQUIRES
22399
22400 =item EXPORTS
22401
22402 =item DESCRIPTION
22403
22404 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
22405 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
22406
22407 =back
22408
22409 =over 4
22410
22411 =item B<Pod::InputSource>
22412
22413 =back
22414
22415 =over 4
22416
22417 =item B<new()>
22418
22419 =back
22420
22421 =over 4
22422
22423 =item B<name()>
22424
22425 =back
22426
22427 =over 4
22428
22429 =item B<handle()>
22430
22431 =back
22432
22433 =over 4
22434
22435 =item B<was_cutting()>
22436
22437 =back
22438
22439 =over 4
22440
22441 =item B<Pod::Paragraph>
22442
22443 =back
22444
22445 =over 4
22446
22447 =item Pod::Paragraph-E<gt>B<new()>
22448
22449 =back
22450
22451 =over 4
22452
22453 =item $pod_para-E<gt>B<cmd_name()>
22454
22455 =back
22456
22457 =over 4
22458
22459 =item $pod_para-E<gt>B<text()>
22460
22461 =back
22462
22463 =over 4
22464
22465 =item $pod_para-E<gt>B<raw_text()>
22466
22467 =back
22468
22469 =over 4
22470
22471 =item $pod_para-E<gt>B<cmd_prefix()>
22472
22473 =back
22474
22475 =over 4
22476
22477 =item $pod_para-E<gt>B<cmd_separator()>
22478
22479 =back
22480
22481 =over 4
22482
22483 =item $pod_para-E<gt>B<parse_tree()>
22484
22485 =back
22486
22487 =over 4
22488
22489 =item $pod_para-E<gt>B<file_line()>
22490
22491 =back
22492
22493 =over 4
22494
22495 =item B<Pod::InteriorSequence>
22496
22497 =back
22498
22499 =over 4
22500
22501 =item Pod::InteriorSequence-E<gt>B<new()>
22502
22503 =back
22504
22505 =over 4
22506
22507 =item $pod_seq-E<gt>B<cmd_name()>
22508
22509 =back
22510
22511 =over 4
22512
22513 =item $pod_seq-E<gt>B<prepend()>
22514
22515 =back
22516
22517 =over 4
22518
22519 =item $pod_seq-E<gt>B<append()>
22520
22521 =back
22522
22523 =over 4
22524
22525 =item $pod_seq-E<gt>B<nested()>
22526
22527 =back
22528
22529 =over 4
22530
22531 =item $pod_seq-E<gt>B<raw_text()>
22532
22533 =back
22534
22535 =over 4
22536
22537 =item $pod_seq-E<gt>B<left_delimiter()>
22538
22539 =back
22540
22541 =over 4
22542
22543 =item $pod_seq-E<gt>B<right_delimiter()>
22544
22545 =back
22546
22547 =over 4
22548
22549 =item $pod_seq-E<gt>B<parse_tree()>
22550
22551 =back
22552
22553 =over 4
22554
22555 =item $pod_seq-E<gt>B<file_line()>
22556
22557 =back
22558
22559 =over 4
22560
22561 =item Pod::InteriorSequence::B<DESTROY()>
22562
22563 =back
22564
22565 =over 4
22566
22567 =item B<Pod::ParseTree>
22568
22569 =back
22570
22571 =over 4
22572
22573 =item Pod::ParseTree-E<gt>B<new()>
22574
22575 =back
22576
22577 =over 4
22578
22579 =item $ptree-E<gt>B<top()>
22580
22581 =back
22582
22583 =over 4
22584
22585 =item $ptree-E<gt>B<children()>
22586
22587 =back
22588
22589 =over 4
22590
22591 =item $ptree-E<gt>B<prepend()>
22592
22593 =back
22594
22595 =over 4
22596
22597 =item $ptree-E<gt>B<append()>
22598
22599 =back
22600
22601 =over 4
22602
22603 =item $ptree-E<gt>B<raw_text()>
22604
22605 =back
22606
22607 =over 4
22608
22609 =item Pod::ParseTree::B<DESTROY()>
22610
22611 =back
22612
22613 =over 4
22614
22615 =item SEE ALSO
22616
22617 =item AUTHOR
22618
22619 =back
22620
22621 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
22622
22623 =over 4
22624
22625 =item SYNOPSIS
22626
22627 =item DESCRIPTION
22628
22629 =back
22630
22631 =over 4
22632
22633 =item OBJECT METHODS
22634
22635 C<initialize>
22636
22637 =back
22638
22639 =over 4
22640
22641 =item Data Accessors
22642
22643 B<AddPreamble>
22644
22645 =back
22646
22647 B<AddPostamble>
22648
22649 B<Head1Level>
22650
22651 B<Label>
22652
22653 B<LevelNoNum>
22654
22655 B<MakeIndex>
22656
22657 B<ReplaceNAMEwithSection>
22658
22659 B<StartWithNewPage>
22660
22661 B<TableOfContents>
22662
22663 B<UniqueLabels>
22664
22665 B<UserPreamble>
22666
22667 B<UserPostamble>
22668
22669 B<Lists>
22670
22671 =over 4
22672
22673 =item Subclassed methods
22674
22675 =back
22676
22677 B<begin_pod>
22678
22679 B<end_pod>
22680
22681 B<command>
22682
22683 B<verbatim>
22684
22685 B<textblock>
22686
22687 B<interior_sequence>
22688
22689 =over 4
22690
22691 =item List Methods
22692
22693 B<begin_list>
22694
22695 =back
22696
22697 B<end_list>
22698
22699 B<add_item>
22700
22701 =over 4
22702
22703 =item Methods for headings
22704
22705 B<head>
22706
22707 =back
22708
22709 =over 4
22710
22711 =item Internal methods
22712
22713 B<_output>
22714
22715 =back
22716
22717 B<_replace_special_chars>
22718
22719 B<_replace_special_chars_late>
22720
22721 B<_create_label>
22722
22723 B<_create_index>
22724
22725 B<_clean_latex_commands>
22726
22727 B<_split_delimited>
22728
22729 =over 4
22730
22731 =item NOTES
22732
22733 =item SEE ALSO
22734
22735 =item AUTHORS
22736
22737 =item COPYRIGHT
22738
22739 =item REVISION
22740
22741 =back
22742
22743 =head2 Pod::Man - Convert POD data to formatted *roff input
22744
22745 =over 4
22746
22747 =item SYNOPSIS
22748
22749 =item DESCRIPTION
22750
22751 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
22752 release, section
22753
22754 =item DIAGNOSTICS
22755
22756 roff font should be 1 or 2 chars, not "%s", Invalid quote specification
22757 "%s"
22758
22759 =item BUGS
22760
22761 =item CAVEATS
22762
22763 =item AUTHOR
22764
22765 =item COPYRIGHT AND LICENSE
22766
22767 =item SEE ALSO
22768
22769 =back
22770
22771 =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
22772
22773 =over 4
22774
22775 =item SYNOPSIS
22776
22777 =item DESCRIPTION
22778
22779 =item SEE ALSO
22780
22781 =item AUTHOR
22782
22783 =item COPYRIGHT AND LICENSE
22784
22785 =back
22786
22787 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
22788
22789 =over 4
22790
22791 =item SYNOPSIS
22792
22793 =item DESCRIPTION
22794
22795 =back
22796
22797 =over 4
22798
22799 =item Pod::List
22800
22801 Pod::List-E<gt>new()
22802
22803 =back
22804
22805 $list-E<gt>file()
22806
22807 $list-E<gt>start()
22808
22809 $list-E<gt>indent()
22810
22811 $list-E<gt>type()
22812
22813 $list-E<gt>rx()
22814
22815 $list-E<gt>item()
22816
22817 $list-E<gt>parent()
22818
22819 $list-E<gt>tag()
22820
22821 =over 4
22822
22823 =item Pod::Hyperlink
22824
22825 Pod::Hyperlink-E<gt>new()
22826
22827 =back
22828
22829 $link-E<gt>parse($string)
22830
22831 $link-E<gt>markup($string)
22832
22833 $link-E<gt>text()
22834
22835 $link-E<gt>warning()
22836
22837 $link-E<gt>file(), $link-E<gt>line()
22838
22839 $link-E<gt>page()
22840
22841 $link-E<gt>node()
22842
22843 $link-E<gt>alttext()
22844
22845 $link-E<gt>type()
22846
22847 $link-E<gt>link()
22848
22849 =over 4
22850
22851 =item Pod::Cache
22852
22853 Pod::Cache-E<gt>new()
22854
22855 =back
22856
22857 $cache-E<gt>item()
22858
22859 $cache-E<gt>find_page($name)
22860
22861 =over 4
22862
22863 =item Pod::Cache::Item
22864
22865 Pod::Cache::Item-E<gt>new()
22866
22867 =back
22868
22869 $cacheitem-E<gt>page()
22870
22871 $cacheitem-E<gt>description()
22872
22873 $cacheitem-E<gt>path()
22874
22875 $cacheitem-E<gt>file()
22876
22877 $cacheitem-E<gt>nodes()
22878
22879 $cacheitem-E<gt>find_node($name)
22880
22881 $cacheitem-E<gt>idx()
22882
22883 =over 4
22884
22885 =item AUTHOR
22886
22887 =item SEE ALSO
22888
22889 =back
22890
22891 =head2 Pod::Parser - base class for creating POD filters and translators
22892
22893 =over 4
22894
22895 =item SYNOPSIS
22896
22897 =item REQUIRES
22898
22899 =item EXPORTS
22900
22901 =item DESCRIPTION
22902
22903 =item QUICK OVERVIEW
22904
22905 =item PARSING OPTIONS
22906
22907 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
22908 B<-warnings> (default: unset)
22909
22910 =back
22911
22912 =over 4
22913
22914 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
22915
22916 =back
22917
22918 =over 4
22919
22920 =item B<command()>
22921
22922 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
22923
22924 =back
22925
22926 =over 4
22927
22928 =item B<verbatim()>
22929
22930 C<$text>, C<$line_num>, C<$pod_para>
22931
22932 =back
22933
22934 =over 4
22935
22936 =item B<textblock()>
22937
22938 C<$text>, C<$line_num>, C<$pod_para>
22939
22940 =back
22941
22942 =over 4
22943
22944 =item B<interior_sequence()>
22945
22946 =back
22947
22948 =over 4
22949
22950 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
22951
22952 =back
22953
22954 =over 4
22955
22956 =item B<new()>
22957
22958 =back
22959
22960 =over 4
22961
22962 =item B<initialize()>
22963
22964 =back
22965
22966 =over 4
22967
22968 =item B<begin_pod()>
22969
22970 =back
22971
22972 =over 4
22973
22974 =item B<begin_input()>
22975
22976 =back
22977
22978 =over 4
22979
22980 =item B<end_input()>
22981
22982 =back
22983
22984 =over 4
22985
22986 =item B<end_pod()>
22987
22988 =back
22989
22990 =over 4
22991
22992 =item B<preprocess_line()>
22993
22994 =back
22995
22996 =over 4
22997
22998 =item B<preprocess_paragraph()>
22999
23000 =back
23001
23002 =over 4
23003
23004 =item METHODS FOR PARSING AND PROCESSING
23005
23006 =back
23007
23008 =over 4
23009
23010 =item B<parse_text()>
23011
23012 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
23013 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
23014 I<code-ref>|I<method-name>
23015
23016 =back
23017
23018 =over 4
23019
23020 =item B<interpolate()>
23021
23022 =back
23023
23024 =over 4
23025
23026 =item B<parse_paragraph()>
23027
23028 =back
23029
23030 =over 4
23031
23032 =item B<parse_from_filehandle()>
23033
23034 =back
23035
23036 =over 4
23037
23038 =item B<parse_from_file()>
23039
23040 =back
23041
23042 =over 4
23043
23044 =item ACCESSOR METHODS
23045
23046 =back
23047
23048 =over 4
23049
23050 =item B<errorsub()>
23051
23052 =back
23053
23054 =over 4
23055
23056 =item B<cutting()>
23057
23058 =back
23059
23060 =over 4
23061
23062 =item B<parseopts()>
23063
23064 =back
23065
23066 =over 4
23067
23068 =item B<output_file()>
23069
23070 =back
23071
23072 =over 4
23073
23074 =item B<output_handle()>
23075
23076 =back
23077
23078 =over 4
23079
23080 =item B<input_file()>
23081
23082 =back
23083
23084 =over 4
23085
23086 =item B<input_handle()>
23087
23088 =back
23089
23090 =over 4
23091
23092 =item B<input_streams()>
23093
23094 =back
23095
23096 =over 4
23097
23098 =item B<top_stream()>
23099
23100 =back
23101
23102 =over 4
23103
23104 =item PRIVATE METHODS AND DATA
23105
23106 =back
23107
23108 =over 4
23109
23110 =item B<_push_input_stream()>
23111
23112 =back
23113
23114 =over 4
23115
23116 =item B<_pop_input_stream()>
23117
23118 =back
23119
23120 =over 4
23121
23122 =item TREE-BASED PARSING
23123
23124 =item SEE ALSO
23125
23126 =item AUTHOR
23127
23128 =back
23129
23130 =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors
23131
23132 =over 4
23133
23134 =item SYNOPSIS
23135
23136 =item DESCRIPTION
23137
23138 =item SEE ALSO
23139
23140 =item COPYRIGHT AND DISCLAIMERS
23141
23142 =item AUTHOR
23143
23144 =back
23145
23146 =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages
23147
23148 =over 4
23149
23150 =item SYNOPSIS
23151
23152 =item DESCRIPTION
23153
23154 =item CAVEAT
23155
23156 =item SEE ALSO
23157
23158 =item COPYRIGHT AND DISCLAIMERS
23159
23160 =item AUTHOR
23161
23162 =back
23163
23164 =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff
23165
23166 =over 4
23167
23168 =item SYNOPSIS
23169
23170 =item DESCRIPTION
23171
23172 =item CAVEAT
23173
23174 =item SEE ALSO
23175
23176 =item COPYRIGHT AND DISCLAIMERS
23177
23178 =item AUTHOR
23179
23180 =back
23181
23182 =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod!
23183
23184 =over 4
23185
23186 =item SYNOPSIS
23187
23188 =item DESCRIPTION
23189
23190 =item SEE ALSO
23191
23192 =item COPYRIGHT AND DISCLAIMERS
23193
23194 =item AUTHOR
23195
23196 =back
23197
23198 =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF
23199
23200 =over 4
23201
23202 =item SYNOPSIS
23203
23204 =item DESCRIPTION
23205
23206 =item SEE ALSO
23207
23208 =item COPYRIGHT AND DISCLAIMERS
23209
23210 =item AUTHOR
23211
23212 =back
23213
23214 =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext
23215
23216 =over 4
23217
23218 =item SYNOPSIS
23219
23220 =item DESCRIPTION
23221
23222 =item CAVEAT
23223
23224 =item SEE ALSO
23225
23226 =item COPYRIGHT AND DISCLAIMERS
23227
23228 =item AUTHOR
23229
23230 =back
23231
23232 =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod
23233
23234 =over 4
23235
23236 =item SYNOPSIS
23237
23238 =item DESCRIPTION
23239
23240 =item SEE ALSO
23241
23242 =item AUTHOR
23243
23244 =back
23245
23246 =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML
23247
23248 =over 4
23249
23250 =item SYNOPSIS
23251
23252 =item DESCRIPTION
23253
23254 =item SEE ALSO
23255
23256 =item COPYRIGHT AND DISCLAIMERS
23257
23258 =item AUTHOR
23259
23260 =back
23261
23262 =head2 Pod::PlainText - Convert POD data to formatted ASCII text
23263
23264 =over 4
23265
23266 =item SYNOPSIS
23267
23268 =item DESCRIPTION
23269
23270 alt, indent, loose, sentence, width
23271
23272 =item DIAGNOSTICS
23273
23274 Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
23275 Unknown sequence: %s, Unmatched =back
23276
23277 =item RESTRICTIONS
23278
23279 =item NOTES
23280
23281 =item SEE ALSO
23282
23283 =item AUTHOR
23284
23285 =back
23286
23287 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
23288
23289 =over 4
23290
23291 =item SYNOPSIS
23292
23293 =item DESCRIPTION
23294
23295 =over 4
23296
23297 =item EXPORT
23298
23299 =back
23300
23301 =item AUTHOR
23302
23303 =item SEE ALSO
23304
23305 =back
23306
23307 =head2 Pod::Select, podselect() - extract selected sections of POD from
23308 input
23309
23310 =over 4
23311
23312 =item SYNOPSIS
23313
23314 =item REQUIRES
23315
23316 =item EXPORTS
23317
23318 =item DESCRIPTION
23319
23320 =item SECTION SPECIFICATIONS
23321
23322 =item RANGE SPECIFICATIONS
23323
23324 =back
23325
23326 =over 4
23327
23328 =item OBJECT METHODS
23329
23330 =back
23331
23332 =over 4
23333
23334 =item B<curr_headings()>
23335
23336 =back
23337
23338 =over 4
23339
23340 =item B<select()>
23341
23342 =back
23343
23344 =over 4
23345
23346 =item B<add_selection()>
23347
23348 =back
23349
23350 =over 4
23351
23352 =item B<clear_selections()>
23353
23354 =back
23355
23356 =over 4
23357
23358 =item B<match_section()>
23359
23360 =back
23361
23362 =over 4
23363
23364 =item B<is_selected()>
23365
23366 =back
23367
23368 =over 4
23369
23370 =item EXPORTED FUNCTIONS
23371
23372 =back
23373
23374 =over 4
23375
23376 =item B<podselect()>
23377
23378 B<-output>, B<-sections>, B<-ranges>
23379
23380 =back
23381
23382 =over 4
23383
23384 =item PRIVATE METHODS AND DATA
23385
23386 =back
23387
23388 =over 4
23389
23390 =item B<_compile_section_spec()>
23391
23392 =back
23393
23394 =over 4
23395
23396 =item $self->{_SECTION_HEADINGS}
23397
23398 =back
23399
23400 =over 4
23401
23402 =item $self->{_SELECTED_SECTIONS}
23403
23404 =back
23405
23406 =over 4
23407
23408 =item SEE ALSO
23409
23410 =item AUTHOR
23411
23412 =back
23413
23414 =head2 Pod::Simple - framework for parsing Pod
23415
23416 =over 4
23417
23418 =item SYNOPSIS
23419
23420 =item DESCRIPTION
23421
23422 =item MAIN METHODS
23423
23424 C<< $parser = I<SomeClass>->new(); >>, C<< $parser->output_fh( *OUT ); >>,
23425 C<< $parser->output_string( \$somestring ); >>, C<< $parser->parse_file(
23426 I<$some_filename> ); >>, C<< $parser->parse_file( *INPUT_FH ); >>, C<<
23427 $parser->parse_string_document( I<$all_content> ); >>, C<<
23428 $parser->parse_lines( I<...@lines...>, undef ); >>, C<<
23429 $parser->content_seen >>, C<< I<SomeClass>->filter( I<$filename> ); >>, C<<
23430 I<SomeClass>->filter( I<*INPUT_FH> ); >>, C<< I<SomeClass>->filter(
23431 I<\$document_content> ); >>
23432
23433 =item SECONDARY METHODS
23434
23435 C<< $parser->no_whining( I<SOMEVALUE> ) >>, C<< $parser->no_errata_section(
23436 I<SOMEVALUE> ) >>, C<< $parser->complain_stderr( I<SOMEVALUE> ) >>, C<<
23437 $parser->source_filename >>, C<< $parser->doc_has_started >>, C<<
23438 $parser->source_dead >>
23439
23440 =item CAVEATS
23441
23442 =item SEE ALSO
23443
23444 =item COPYRIGHT AND DISCLAIMERS
23445
23446 =item AUTHOR
23447
23448 =back
23449
23450 =head2 Pod::Simple::Checker -- check the Pod syntax of a document
23451
23452 =over 4
23453
23454 =item SYNOPSIS
23455
23456 =item DESCRIPTION
23457
23458 =item SEE ALSO
23459
23460 =item COPYRIGHT AND DISCLAIMERS
23461
23462 =item AUTHOR
23463
23464 =back
23465
23466 =head2 Pod::Simple::Debug -- put Pod::Simple into trace/debug mode
23467
23468 =over 4
23469
23470 =item SYNOPSIS
23471
23472 =item DESCRIPTION
23473
23474 =item CAVEATS
23475
23476 =item GUTS
23477
23478 =item SEE ALSO
23479
23480 =item COPYRIGHT AND DISCLAIMERS
23481
23482 =item AUTHOR
23483
23484 =back
23485
23486 =head2 Pod::Simple::DumpAsText -- dump Pod-parsing events as text
23487
23488 =over 4
23489
23490 =item SYNOPSIS
23491
23492 =item DESCRIPTION
23493
23494 =item SEE ALSO
23495
23496 =item COPYRIGHT AND DISCLAIMERS
23497
23498 =item AUTHOR
23499
23500 =back
23501
23502 =head2 Pod::Simple::DumpAsXML -- turn Pod into XML
23503
23504 =over 4
23505
23506 =item SYNOPSIS
23507
23508 =item DESCRIPTION
23509
23510 =item SEE ALSO
23511
23512 =item COPYRIGHT AND DISCLAIMERS
23513
23514 =item AUTHOR
23515
23516 =back
23517
23518 =head2 Pod::Simple::HTML - convert Pod to HTML
23519
23520 =over 4
23521
23522 =item SYNOPSIS
23523
23524 =item DESCRIPTION
23525
23526 =item CALLING FROM THE COMMAND LINE
23527
23528 =item CALLING FROM PERL
23529
23530 =item METHODS
23531
23532 =item SUBCLASSING
23533
23534 =item SEE ALSO
23535
23536 =item COPYRIGHT AND DISCLAIMERS
23537
23538 =item AUTHOR
23539
23540 =back
23541
23542 =head2 Pod::Simple::HTMLBatch - convert several Pod files to several HTML
23543 files
23544
23545 =over 4
23546
23547 =item SYNOPSIS
23548
23549 =item DESCRIPTION
23550
23551 =over 4
23552
23553 =item FROM THE COMMAND LINE
23554
23555 =back
23556
23557 =item MAIN METHODS
23558
23559 $batchconv = Pod::Simple::HTMLBatch->new;, $batchconv->batch_convert(
23560 I<indirs>, I<outdir> );, $batchconv->batch_convert( undef    , ...);,
23561 $batchconv->batch_convert( q{@INC}, ...);, $batchconv->batch_convert(
23562 \@dirs , ...);, $batchconv->batch_convert( "somedir" , ...);,
23563 $batchconv->batch_convert( 'somedir:someother:also' , ...);,
23564 $batchconv->batch_convert( ... , undef );, $batchconv->batch_convert( ... ,
23565 'somedir' );
23566
23567 =over 4
23568
23569 =item ACCESSOR METHODS
23570
23571 $batchconv->verbose( I<nonnegative_integer> );, $batchconv->index(
23572 I<true-or-false> );, $batchconv->contents_file( I<filename> );,
23573 $batchconv->contents_page_start( I<HTML_string> );,
23574 $batchconv->contents_page_end( I<HTML_string> );, $batchconv->add_css( $url
23575 );, $batchconv->add_javascript( $url );, $batchconv->css_flurry(
23576 I<true-or-false> );, $batchconv->javascript_flurry( I<true-or-false> );,
23577 $batchconv->no_contents_links( I<true-or-false> );,
23578 $batchconv->html_render_class( I<classname> );
23579
23580 =back
23581
23582 =item NOTES ON CUSTOMIZATION
23583
23584 =item ASK ME!
23585
23586 =item SEE ALSO
23587
23588 =item COPYRIGHT AND DISCLAIMERS
23589
23590 =item AUTHOR
23591
23592 =back
23593
23594 =head2 Pod::Simple::LinkSection -- represent "section" attributes of L
23595 codes
23596
23597 =over 4
23598
23599 =item SYNOPSIS
23600
23601 =item DESCRIPTION
23602
23603 =item SEE ALSO
23604
23605 =item COPYRIGHT AND DISCLAIMERS
23606
23607 =item AUTHOR
23608
23609 =back
23610
23611 =head2 Pod::Simple::Methody -- turn Pod::Simple events into method calls
23612
23613 =over 4
23614
23615 =item SYNOPSIS
23616
23617 =item DESCRIPTION
23618
23619 =item METHOD CALLING
23620
23621 =item SEE ALSO
23622
23623 =item COPYRIGHT AND DISCLAIMERS
23624
23625 =item AUTHOR
23626
23627 =back
23628
23629 =head2 Pod::Simple::PullParser -- a pull-parser interface to parsing Pod
23630
23631 =over 4
23632
23633 =item SYNOPSIS
23634
23635 =item DESCRIPTION
23636
23637 =item METHODS
23638
23639 my $token = $parser->get_token, $parser->unget_token( $token ),
23640 $parser->unget_token( $token1, $token2, ... ), $parser->set_source(
23641 $filename ), $parser->set_source( $filehandle_object ),
23642 $parser->set_source( \$document_source ), $parser->set_source(
23643 \@document_lines ), $parser->parse_file(...),
23644 $parser->parse_string_document(...), $parser->filter(...),
23645 $parser->parse_from_file(...), my $title_string = $parser->get_title, my
23646 $title_string = $parser->get_short_title, $author_name   =
23647 $parser->get_author, $description_name = $parser->get_description,
23648 $version_block = $parser->get_version
23649
23650 =item NOTE
23651
23652 =item SEE ALSO
23653
23654 =item COPYRIGHT AND DISCLAIMERS
23655
23656 =item AUTHOR
23657
23658 =back
23659
23660 =head2 Pod::Simple::PullParserEndToken -- end-tokens from
23661 Pod::Simple::PullParser
23662
23663 =over 4
23664
23665 =item SYNOPSIS
23666
23667 =item DESCRIPTION
23668
23669 $token->tagname, $token->tagname(I<somestring>), $token->tag(...),
23670 $token->is_tag(I<somestring>) or $token->is_tagname(I<somestring>)
23671
23672 =item SEE ALSO
23673
23674 =item COPYRIGHT AND DISCLAIMERS
23675
23676 =item AUTHOR
23677
23678 =back
23679
23680 =head2 Pod::Simple::PullParserStartToken -- start-tokens from
23681 Pod::Simple::PullParser
23682
23683 =over 4
23684
23685 =item SYNOPSIS
23686
23687 =item DESCRIPTION
23688
23689 $token->tagname, $token->tagname(I<somestring>), $token->tag(...),
23690 $token->is_tag(I<somestring>) or $token->is_tagname(I<somestring>),
23691 $token->attr(I<attrname>), $token->attr(I<attrname>, I<newvalue>),
23692 $token->attr_hash
23693
23694 =item SEE ALSO
23695
23696 =item COPYRIGHT AND DISCLAIMERS
23697
23698 =item AUTHOR
23699
23700 =back
23701
23702 =head2 Pod::Simple::PullParserTextToken -- text-tokens from
23703 Pod::Simple::PullParser
23704
23705 =over 4
23706
23707 =item SYNOPSIS
23708
23709 =item DESCRIPTION
23710
23711 $token->text, $token->text(I<somestring>), $token->text_r()
23712
23713 =item SEE ALSO
23714
23715 =item COPYRIGHT AND DISCLAIMERS
23716
23717 =item AUTHOR
23718
23719 =back
23720
23721 =head2 Pod::Simple::PullParserToken -- tokens from Pod::Simple::PullParser
23722
23723 =over 4
23724
23725 =item SYNOPSIS
23726
23727 =item DESCRIPTION
23728
23729 $token->type, $token->is_start, $token->is_text, $token->is_end,
23730 $token->dump
23731
23732 =item SEE ALSO
23733
23734 =item COPYRIGHT AND DISCLAIMERS
23735
23736 =item AUTHOR
23737
23738 =back
23739
23740 =head2 Pod::Simple::RTF -- format Pod as RTF
23741
23742 =over 4
23743
23744 =item SYNOPSIS
23745
23746 =item DESCRIPTION
23747
23748 =item FORMAT CONTROL ATTRIBUTES
23749
23750 $parser->head1_halfpoint_size( I<halfpoint_integer> );,
23751 $parser->head2_halfpoint_size( I<halfpoint_integer> );,
23752 $parser->head3_halfpoint_size( I<halfpoint_integer> );,
23753 $parser->head4_halfpoint_size( I<halfpoint_integer> );,
23754 $parser->codeblock_halfpoint_size( I<halfpoint_integer> );,
23755 $parser->header_halfpoint_size( I<halfpoint_integer> );,
23756 $parser->normal_halfpoint_size( I<halfpoint_integer> );,
23757 $parser->no_proofing_exemptions( I<true_or_false> );, $parser->doc_lang(
23758 I<microsoft_decimal_language_code> )
23759
23760 =item SEE ALSO
23761
23762 =item COPYRIGHT AND DISCLAIMERS
23763
23764 =item AUTHOR
23765
23766 =back
23767
23768 =head2 Pod::Simple::Search - find POD documents in directory trees
23769
23770 =over 4
23771
23772 =item SYNOPSIS
23773
23774 =item DESCRIPTION
23775
23776 =item CONSTRUCTOR
23777
23778 =item ACCESSORS
23779
23780 $search->inc( I<true-or-false> );, $search->verbose( I<nonnegative-number>
23781 );, $search->limit_glob( I<some-glob-string> );, $search->callback(
23782 I<\&some_routine> );, $search->laborious( I<true-or-false> );,
23783 $search->shadows( I<true-or-false> );, $search->limit_re( I<some-regxp> );,
23784 $search->dir_prefix( I<some-string-value> );, $search->progress(
23785 I<some-progress-object> );, $name2path = $self->name2path;, $path2name =
23786 $self->path2name;
23787
23788 =item MAIN SEARCH METHODS
23789
23790 =over 4
23791
23792 =item C<< $search->survey( @directories ) >>
23793
23794 C<name2path>, C<path2name>
23795
23796 =item C<< $search->simplify_name( $str ) >>
23797
23798 =item C<< $search->find( $pod ) >>
23799
23800 =item C<< $search->find( $pod, @search_dirs ) >>
23801
23802 =item C<< $self->contains_pod( $file ) >>
23803
23804 =back
23805
23806 =item AUTHOR
23807
23808 =item SEE ALSO
23809
23810 =back
23811
23812 =head2 Pod::Simple::Subclassing -- write a formatter as a Pod::Simple
23813 subclass
23814
23815 =over 4
23816
23817 =item SYNOPSIS
23818
23819 =item DESCRIPTION
23820
23821 =item Events
23822
23823 C<< $parser->_handle_element_start( I<element_name>, I<attr_hashref> ) >>,
23824 C<< $parser->_handle_element_end( I<element_name>  ) >>, C<<
23825 $parser->_handle_text(  I<text_string>  ) >>, events with an element_name
23826 of Document, events with an element_name of Para, events with an
23827 element_name of B, C, F, or I, events with an element_name of S, events
23828 with an element_name of X, events with an element_name of L, events with an
23829 element_name of E or Z, events with an element_name of Verbatim, events
23830 with an element_name of head1 .. head4, events with an element_name of
23831 over-bullet, events with an element_name of over-number, events with an
23832 element_name of over-text, events with an element_name of over-block,
23833 events with an element_name of item-bullet, events with an element_name of
23834 item-number, events with an element_name of item-text, events with an
23835 element_name of for, events with an element_name of Data
23836
23837 =item More Pod::Simple Methods
23838
23839 C<< $parser->accept_targets( I<SOMEVALUE> ) >>, C<<
23840 $parser->accept_targets_as_text(  I<SOMEVALUE>  ) >>, C<<
23841 $parser->accept_codes( I<Codename>, I<Codename>...  ) >>, C<<
23842 $parser->accept_directive_as_data( I<directive_name> ) >>, C<<
23843 $parser->accept_directive_as_verbatim( I<directive_name> ) >>, C<<
23844 $parser->accept_directive_as_processed( I<directive_name> ) >>, C<<
23845 $parser->nbsp_for_S( I<BOOLEAN> ); >>, C<< $parser->version_report() >>,
23846 C<< $parser->pod_para_count() >>, C<< $parser->line_count() >>, C<<
23847 $parser->nix_X_codes(  I<SOMEVALUE>  ) >>, C<< $parser->merge_text( 
23848 I<SOMEVALUE>  ) >>, C<< $parser->code_handler(  I<CODE_REF>  ) >>, C<<
23849 $parser->cut_handler(  I<CODE_REF>  ) >>, C<< $parser->whine(
23850 I<linenumber>, I<complaint string> ) >>, C<< $parser->scream(
23851 I<linenumber>, I<complaint string> ) >>, C<< $parser->source_dead(1) >>,
23852 C<< $parser->hide_line_numbers( I<SOMEVALUE> ) >>, C<< $parser->no_whining(
23853 I<SOMEVALUE> ) >>, C<< $parser->no_errata_section( I<SOMEVALUE> ) >>, C<<
23854 $parser->complain_stderr( I<SOMEVALUE> ) >>, C<< $parser->bare_output(
23855 I<SOMEVALUE> ) >>, C<< $parser->preserve_whitespace( I<SOMEVALUE> ) >>
23856
23857 =item SEE ALSO
23858
23859 =item COPYRIGHT AND DISCLAIMERS
23860
23861 =item AUTHOR
23862
23863 =back
23864
23865 =head2 Pod::Simple::Text -- format Pod as plaintext
23866
23867 =over 4
23868
23869 =item SYNOPSIS
23870
23871 =item DESCRIPTION
23872
23873 =item SEE ALSO
23874
23875 =item COPYRIGHT AND DISCLAIMERS
23876
23877 =item AUTHOR
23878
23879 =back
23880
23881 =head2 Pod::Simple::TextContent -- get the text content of Pod
23882
23883 =over 4
23884
23885 =item SYNOPSIS
23886
23887 =item DESCRIPTION
23888
23889 =item SEE ALSO
23890
23891 =item COPYRIGHT AND DISCLAIMERS
23892
23893 =item AUTHOR
23894
23895 =back
23896
23897 =head2 Pod::Simple::XMLOutStream -- turn Pod into XML
23898
23899 =over 4
23900
23901 =item SYNOPSIS
23902
23903 =item DESCRIPTION
23904
23905 =item SEE ALSO
23906
23907 =item ABOUT EXTENDING POD
23908
23909 =item ASK ME!
23910
23911 =item COPYRIGHT AND DISCLAIMERS
23912
23913 =item AUTHOR
23914
23915 =back
23916
23917 =head2 Pod::SimpleTree, Pod::Simple::SimpleTree -- parse Pod into a simple
23918 parse tree 
23919
23920 =over 4
23921
23922 =item SYNOPSIS
23923
23924 =item DESCRIPTION
23925
23926 =item METHODS
23927
23928 =item Tree Contents
23929
23930 =item SEE ALSO
23931
23932 =item COPYRIGHT AND DISCLAIMERS
23933
23934 =item AUTHOR
23935
23936 =back
23937
23938 =head2 Pod::Text - Convert POD data to formatted ASCII text
23939
23940 =over 4
23941
23942 =item SYNOPSIS
23943
23944 =item DESCRIPTION
23945
23946 alt, code, indent, loose, margin, quotes, sentence, width
23947
23948 =item DIAGNOSTICS
23949
23950 Bizarre space in item, Item called without tag, Can't open %s for reading:
23951 %s, Invalid quote specification "%s"
23952
23953 =item NOTES
23954
23955 =item SEE ALSO
23956
23957 =item AUTHOR
23958
23959 =item COPYRIGHT AND LICENSE
23960
23961 =back
23962
23963 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
23964
23965 =over 4
23966
23967 =item SYNOPSIS
23968
23969 =item DESCRIPTION
23970
23971 =item BUGS
23972
23973 =item SEE ALSO
23974
23975 =item AUTHOR
23976
23977 =item COPYRIGHT AND LICENSE
23978
23979 =back
23980
23981 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
23982 text
23983
23984 =over 4
23985
23986 =item SYNOPSIS
23987
23988 =item DESCRIPTION
23989
23990 =item BUGS
23991
23992 =item SEE ALSO
23993
23994 =item AUTHOR
23995
23996 =item COPYRIGHT AND LICENSE
23997
23998 =back
23999
24000 =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
24001 escapes
24002
24003 =over 4
24004
24005 =item SYNOPSIS
24006
24007 =item DESCRIPTION
24008
24009 =item NOTES
24010
24011 =item SEE ALSO
24012
24013 =item AUTHOR
24014
24015 =item COPYRIGHT AND LICENSE
24016
24017 =back
24018
24019 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
24020 documentation
24021
24022 =over 4
24023
24024 =item SYNOPSIS
24025
24026 =item ARGUMENTS
24027
24028 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-sections>, C<-output>,
24029 C<-input>, C<-pathlist>, C<-noperldoc>
24030
24031 =item DESCRIPTION
24032
24033 =item EXAMPLES
24034
24035 =over 4
24036
24037 =item Recommended Use
24038
24039 =back
24040
24041 =item CAVEATS
24042
24043 =item AUTHOR
24044
24045 =item ACKNOWLEDGEMENTS
24046
24047 =back
24048
24049 =head2 SDBM_File - Tied access to sdbm files
24050
24051 =over 4
24052
24053 =item SYNOPSIS
24054
24055 =item DESCRIPTION
24056
24057 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
24058
24059 =item DIAGNOSTICS
24060
24061 =over 4
24062
24063 =item C<sdbm store returned -1, errno 22, key "..." at ...>
24064
24065 =back
24066
24067 =item BUGS AND WARNINGS
24068
24069 =back
24070
24071 =head2 Safe - Compile and execute code in restricted compartments
24072
24073 =over 4
24074
24075 =item SYNOPSIS
24076
24077 =item DESCRIPTION
24078
24079 a new namespace, an operator mask
24080
24081 =item WARNING
24082
24083 =over 4
24084
24085 =item RECENT CHANGES
24086
24087 =item Methods in class Safe
24088
24089 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
24090 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
24091 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
24092 root (NAMESPACE), mask (MASK)
24093
24094 =item Some Safety Issues
24095
24096 Memory, CPU, Snooping, Signals, State Changes
24097
24098 =item AUTHOR
24099
24100 =back
24101
24102 =back
24103
24104 =head2 Scalar::Util - A selection of general-utility scalar subroutines
24105
24106 =over 4
24107
24108 =item SYNOPSIS
24109
24110 =item DESCRIPTION
24111
24112 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
24113 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
24114 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
24115
24116 =item KNOWN BUGS
24117
24118 =item COPYRIGHT
24119
24120 =item BLATANT PLUG
24121
24122 =back
24123
24124 =head2 Search::Dict, look - search for key in dictionary file
24125
24126 =over 4
24127
24128 =item SYNOPSIS
24129
24130 =item DESCRIPTION
24131
24132 =back
24133
24134 =head2 SelectSaver - save and restore selected file handle
24135
24136 =over 4
24137
24138 =item SYNOPSIS
24139
24140 =item DESCRIPTION
24141
24142 =back
24143
24144 =head2 SelfLoader - load functions only on demand
24145
24146 =over 4
24147
24148 =item SYNOPSIS
24149
24150 =item DESCRIPTION
24151
24152 =over 4
24153
24154 =item The __DATA__ token
24155
24156 =item SelfLoader autoloading
24157
24158 =item Autoloading and package lexicals
24159
24160 =item SelfLoader and AutoLoader
24161
24162 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
24163
24164 =item Classes and inherited methods.
24165
24166 =back
24167
24168 =item Multiple packages and fully qualified subroutine names
24169
24170 =back
24171
24172 =head2 Shell - run shell commands transparently within perl
24173
24174 =over 4
24175
24176 =item SYNOPSIS
24177
24178 =item DESCRIPTION
24179
24180 =over 4
24181
24182 =item Caveats
24183
24184 =item Escaping Magic Characters
24185
24186 =item Configuration
24187
24188 =back
24189
24190 =item BUGS
24191
24192 =item AUTHOR
24193
24194 =back
24195
24196 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
24197 socket.h defines and structure manipulators 
24198
24199 =over 4
24200
24201 =item SYNOPSIS
24202
24203 =item DESCRIPTION
24204
24205 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
24206 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
24207 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
24208 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
24209 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
24210
24211 =back
24212
24213 =head2 Storable - persistence for Perl data structures
24214
24215 =over 4
24216
24217 =item SYNOPSIS
24218
24219 =item DESCRIPTION
24220
24221 =item MEMORY STORE
24222
24223 =item ADVISORY LOCKING
24224
24225 =item SPEED
24226
24227 =item CANONICAL REPRESENTATION
24228
24229 =item CODE REFERENCES
24230
24231 =item FORWARD COMPATIBILITY
24232
24233 utf8 data, restricted hashes, files from future versions of Storable
24234
24235 =item ERROR REPORTING
24236
24237 =item WIZARDS ONLY
24238
24239 =over 4
24240
24241 =item Hooks
24242
24243 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
24244 I<serialized>, .., C<STORABLE_attach> I<class>, I<cloning>, I<serialized>
24245
24246 =item Predicates
24247
24248 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
24249 C<Storable::is_retrieving>
24250
24251 =item Recursion
24252
24253 =item Deep Cloning
24254
24255 =back
24256
24257 =item Storable magic
24258
24259 $info = Storable::file_magic( $filename ), C<version>, C<version_nv>,
24260 C<major>, C<minor>, C<hdrsize>, C<netorder>, C<byteorder>, C<intsize>,
24261 C<longsize>, C<ptrsize>, C<nvsize>, C<file>, $info = Storable::read_magic(
24262 $buffer ), $info = Storable::read_magic( $buffer, $must_be_file )
24263
24264 =item EXAMPLES
24265
24266 =item WARNING
24267
24268 =item BUGS
24269
24270 =over 4
24271
24272 =item 64 bit data in perl 5.6.0 and 5.6.1
24273
24274 =back
24275
24276 =item CREDITS
24277
24278 =item AUTHOR
24279
24280 =item SEE ALSO
24281
24282 =back
24283
24284 =head2 Switch - A switch statement for Perl
24285
24286 =over 4
24287
24288 =item VERSION
24289
24290 =item SYNOPSIS
24291
24292 =item BACKGROUND
24293
24294 =item DESCRIPTION
24295
24296 =over 4
24297
24298 =item Allowing fall-through
24299
24300 =item Automating fall-through
24301
24302 =item Alternative syntax
24303
24304 =item Higher-order Operations
24305
24306 =back
24307
24308 =item DEPENDENCIES
24309
24310 =item AUTHOR
24311
24312 =item BUGS
24313
24314 =item LIMITATIONS
24315
24316 =item COPYRIGHT
24317
24318 =back
24319
24320 =head2 Symbol - manipulate Perl symbols and their names
24321
24322 =over 4
24323
24324 =item SYNOPSIS
24325
24326 =item DESCRIPTION
24327
24328 =item BUGS
24329
24330 =back
24331
24332 =head2 Sys::Hostname - Try every conceivable way to get hostname
24333
24334 =over 4
24335
24336 =item SYNOPSIS
24337
24338 =item DESCRIPTION
24339
24340 =item AUTHOR
24341
24342 =back
24343
24344 =head2 Syslog, Sys::Syslog - Perl interface to the UNIX syslog(3) calls
24345
24346 =over 4
24347
24348 =item VERSION
24349
24350 =item SYNOPSIS
24351
24352 =item DESCRIPTION
24353
24354 =item EXPORTS
24355
24356 =item FUNCTIONS
24357
24358 B<openlog($ident, $logopt, $facility)>, B<syslog($priority, $message)>,
24359 B<syslog($priority, $format, @args)>, B<Note>,
24360 B<setlogmask($mask_priority)>, B<setlogsock($sock_type)>,
24361 B<setlogsock($sock_type, $stream_location)> (added in 5.004_02),
24362 B<closelog()>
24363
24364 =item EXAMPLES
24365
24366 =item CONSTANTS
24367
24368 =over 4
24369
24370 =item Facilities
24371
24372 =item Levels
24373
24374 =back
24375
24376 =item DIAGNOSTICS
24377
24378 Invalid argument passed to setlogsock, no connection to syslog available,
24379 stream passed to setlogsock, but %s is not writable, stream passed to
24380 setlogsock, but could not find any device, tcp passed to setlogsock, but
24381 tcp service unavailable, syslog: expecting argument %s, syslog: invalid
24382 level/facility: %s, syslog: too many levels given: %s, syslog: too many
24383 facilities given: %s, syslog: level must be given, udp passed to
24384 setlogsock, but udp service unavailable, unix passed to setlogsock, but
24385 path not available
24386
24387 =item SEE ALSO
24388
24389 =item AUTHOR
24390
24391 =item BUGS
24392
24393 =item SUPPORT
24394
24395 AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request
24396 tracker, Search CPAN
24397
24398 =item LICENSE
24399
24400 =back
24401
24402 =head2 Syslog::Syslog, Sys::Syslog - Perl interface to the UNIX syslog(3)
24403 calls
24404
24405 =over 4
24406
24407 =item VERSION
24408
24409 =item SYNOPSIS
24410
24411 =item DESCRIPTION
24412
24413 =item EXPORTS
24414
24415 =item FUNCTIONS
24416
24417 B<openlog($ident, $logopt, $facility)>, B<syslog($priority, $message)>,
24418 B<syslog($priority, $format, @args)>, B<Note>,
24419 B<setlogmask($mask_priority)>, B<setlogsock($sock_type)>,
24420 B<setlogsock($sock_type, $stream_location)> (added in 5.004_02),
24421 B<closelog()>
24422
24423 =item EXAMPLES
24424
24425 =item CONSTANTS
24426
24427 =over 4
24428
24429 =item Facilities
24430
24431 =item Levels
24432
24433 =back
24434
24435 =item DIAGNOSTICS
24436
24437 Invalid argument passed to setlogsock, no connection to syslog available,
24438 stream passed to setlogsock, but %s is not writable, stream passed to
24439 setlogsock, but could not find any device, tcp passed to setlogsock, but
24440 tcp service unavailable, syslog: expecting argument %s, syslog: invalid
24441 level/facility: %s, syslog: too many levels given: %s, syslog: too many
24442 facilities given: %s, syslog: level must be given, udp passed to
24443 setlogsock, but udp service unavailable, unix passed to setlogsock, but
24444 path not available
24445
24446 =item SEE ALSO
24447
24448 =item AUTHOR
24449
24450 =item BUGS
24451
24452 =item SUPPORT
24453
24454 AnnoCPAN: Annotated CPAN documentation, CPAN Ratings, RT: CPAN's request
24455 tracker, Search CPAN
24456
24457 =item LICENSE
24458
24459 =back
24460
24461 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
24462
24463 =over 4
24464
24465 =item SYNOPSIS
24466
24467 =item DESCRIPTION
24468
24469 =item DIAGNOSTICS
24470
24471 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
24472 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
24473 comma allowed after filehandle, No name for escape sequence %s
24474
24475 =item ENVIRONMENT
24476
24477 ANSI_COLORS_DISABLED
24478
24479 =item RESTRICTIONS
24480
24481 =item NOTES
24482
24483 =item SEE ALSO
24484
24485 =item AUTHORS
24486
24487 =item COPYRIGHT AND LICENSE
24488
24489 =back
24490
24491 =head2 Term::Cap - Perl termcap interface
24492
24493 =over 4
24494
24495 =item SYNOPSIS
24496
24497 =item DESCRIPTION
24498
24499 =over 4
24500
24501 =item METHODS
24502
24503 =back
24504
24505 =back
24506
24507 B<Tgetent>, OSPEED, TERM
24508
24509 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
24510
24511 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
24512
24513 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
24514
24515 B<Trequire>
24516
24517 =over 4
24518
24519 =item EXAMPLES
24520
24521 =item COPYRIGHT AND LICENSE
24522
24523 =item AUTHOR
24524
24525 =item SEE ALSO
24526
24527 =back
24528
24529 =head2 Term::Complete - Perl word completion module
24530
24531 =over 4
24532
24533 =item SYNOPSIS
24534
24535 =item DESCRIPTION
24536
24537 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
24538
24539 =item DIAGNOSTICS
24540
24541 =item BUGS
24542
24543 =item AUTHOR
24544
24545 =back
24546
24547 =head2 Term::ReadLine - Perl interface to various C<readline> packages.
24548 If no real package is found, substitutes stubs instead of basic functions.
24549
24550 =over 4
24551
24552 =item SYNOPSIS
24553
24554 =item DESCRIPTION
24555
24556 =item Minimal set of supported functions
24557
24558 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>,
24559 C<findConsole>, Attribs, C<Features>
24560
24561 =item Additional supported functions
24562
24563 C<tkRunning>, C<ornaments>, C<newTTY>
24564
24565 =item EXPORTS
24566
24567 =item ENVIRONMENT
24568
24569 =item CAVEATS
24570
24571 =back
24572
24573 =head2 Test - provides a simple framework for writing test scripts
24574
24575 =over 4
24576
24577 =item SYNOPSIS
24578
24579 =item DESCRIPTION
24580
24581 =item QUICK START GUIDE
24582
24583 =over 4
24584
24585 =item Functions
24586
24587 C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>,
24588 C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub>
24589
24590 =back
24591
24592 =back
24593
24594 B<_to_value>
24595
24596 C<ok(...)>
24597
24598 C<skip(I<skip_if_true>, I<args...>)>
24599
24600 =over 4
24601
24602 =item TEST TYPES
24603
24604 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
24605
24606 =item ONFAIL
24607
24608 =item BUGS and CAVEATS
24609
24610 =item ENVIRONMENT
24611
24612 =item NOTE
24613
24614 =item SEE ALSO
24615
24616 =item AUTHOR
24617
24618 =back
24619
24620 =head2 Test::Builder - Backend for building test libraries
24621
24622 =over 4
24623
24624 =item SYNOPSIS
24625
24626 =item DESCRIPTION
24627
24628 =over 4
24629
24630 =item Construction
24631
24632 B<new>
24633
24634 =back
24635
24636 =back
24637
24638 B<create>
24639
24640 B<reset>
24641
24642 =over 4
24643
24644 =item Setting up tests
24645
24646 B<exported_to>
24647
24648 =back
24649
24650 B<plan>
24651
24652 B<expected_tests>
24653
24654 B<no_plan>
24655
24656 B<has_plan>
24657
24658 B<skip_all>
24659
24660 =over 4
24661
24662 =item Running tests
24663
24664 B<ok>
24665
24666 =back
24667
24668 B<is_eq>, B<is_num>
24669
24670 B<isnt_eq>, B<isnt_num>
24671
24672 B<like>, B<unlike>
24673
24674 B<maybe_regex>
24675
24676 B<cmp_ok>
24677
24678 B<BAIL_OUT>
24679
24680 B<skip>
24681
24682 B<todo_skip>
24683
24684 B<skip_rest>
24685
24686 =over 4
24687
24688 =item Test style
24689
24690 B<level>
24691
24692 =back
24693
24694 B<use_numbers>
24695
24696 B<no_diag>, B<no_ending>, B<no_header>
24697
24698 =over 4
24699
24700 =item Output
24701
24702 B<diag>
24703
24704 =back
24705
24706 B<_print>
24707
24708 B<_print_diag>
24709
24710 B<output>, B<failure_output>, B<todo_output>
24711
24712 =over 4
24713
24714 =item Test Status and Info
24715
24716 B<current_test>
24717
24718 =back
24719
24720 B<summary>
24721
24722 B<details>
24723
24724 B<todo>
24725
24726 B<caller>
24727
24728 B<_sanity_check>
24729
24730 B<_whoa>
24731
24732 B<_my_exit>
24733
24734 =over 4
24735
24736 =item EXIT CODES
24737
24738 =item THREADS
24739
24740 =item EXAMPLES
24741
24742 =item SEE ALSO
24743
24744 =item AUTHORS
24745
24746 =item COPYRIGHT
24747
24748 =back
24749
24750 =head2 Test::Builder::Module - Base class for test modules
24751
24752 =over 4
24753
24754 =item SYNOPSIS
24755
24756 =item DESCRIPTION
24757
24758 =over 4
24759
24760 =item Importing
24761
24762 =back
24763
24764 =back
24765
24766 =over 4
24767
24768 =item Builder
24769
24770 =back
24771
24772 =head2 Test::Builder::Tester - test testsuites that have been built with
24773 Test::Builder
24774
24775 =over 4
24776
24777 =item SYNOPSIS
24778
24779 =item DESCRIPTION
24780
24781 =back
24782
24783 =over 4
24784
24785 =item Methods
24786
24787 test_out, test_err
24788
24789 =back
24790
24791 test_fail
24792
24793 test_diag
24794
24795 test_test, title (synonym 'name', 'label'), skip_out, skip_err
24796
24797 line_num
24798
24799 color
24800
24801 =over 4
24802
24803 =item BUGS
24804
24805 =item AUTHOR
24806
24807 =item NOTES
24808
24809 =item SEE ALSO
24810
24811 =back
24812
24813 =head2 Test::Builder::Tester::Color - turn on colour in
24814 Test::Builder::Tester
24815
24816 =over 4
24817
24818 =item SYNOPSIS
24819
24820 =item DESCRIPTION
24821
24822 =back
24823
24824 =over 4
24825
24826 =item AUTHOR
24827
24828 =item BUGS
24829
24830 =item SEE ALSO
24831
24832 =back
24833
24834 =head2 Test::Harness - Run Perl standard test scripts with statistics
24835
24836 =over 4
24837
24838 =item VERSION
24839
24840 =back
24841
24842 =over 4
24843
24844 =item SYNOPSIS
24845
24846 =item DESCRIPTION
24847
24848 =over 4
24849
24850 =item Taint mode
24851
24852 =item Configuration variables.
24853
24854 C<$Test::Harness::Verbose>, C<$Test::Harness::switches>,
24855 C<$Test::Harness::Timer>
24856
24857 =item Failure
24858
24859 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
24860 Failed>
24861
24862 =item Functions
24863
24864 B<runtests>
24865
24866 =back
24867
24868 =back
24869
24870 B<_all_ok>
24871
24872 B<_globdir>
24873
24874 B<_run_all_tests>
24875
24876 B<_mk_leader>
24877
24878 B<_leader_width>
24879
24880 =over 4
24881
24882 =item EXPORT
24883
24884 =item DIAGNOSTICS
24885
24886 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
24887 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
24888 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
24889 %s>, C<FAILED--Further testing stopped: %s>
24890
24891 =item ENVIRONMENT VARIABLES THAT TEST::HARNESS SETS
24892
24893 C<HARNESS_ACTIVE>, C<HARNESS_VERSION>
24894
24895 =item ENVIRONMENT VARIABLES THAT AFFECT TEST::HARNESS
24896
24897 C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>, C<HARNESS_DEBUG>,
24898 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
24899 C<HARNESS_PERL>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
24900
24901 =item EXAMPLE
24902
24903 =item SEE ALSO
24904
24905 =item TODO
24906
24907 =item BUGS
24908
24909 =item AUTHORS
24910
24911 =item COPYRIGHT
24912
24913 =back
24914
24915 =head2 Test::Harness::Assert - simple assert
24916
24917 =over 4
24918
24919 =item SYNOPSIS
24920
24921 =item DESCRIPTION
24922
24923 =item FUNCTIONS
24924
24925 =over 4
24926
24927 =item C<assert()>
24928
24929 =back
24930
24931 =back
24932
24933 =over 4
24934
24935 =item AUTHOR
24936
24937 =item SEE ALSO
24938
24939 =back
24940
24941 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
24942
24943 =over 4
24944
24945 =item SYNOPSIS
24946
24947 =item DESCRIPTION
24948
24949 =over 4
24950
24951 =item new()
24952
24953 =item next()
24954
24955 =back
24956
24957 =back
24958
24959 =head2 Test::Harness::Point - object for tracking a single test point
24960
24961 =over 4
24962
24963 =item SYNOPSIS
24964
24965 =item CONSTRUCTION
24966
24967 =over 4
24968
24969 =item new()
24970
24971 =back
24972
24973 =back
24974
24975 =over 4
24976
24977 =item from_test_line( $line )
24978
24979 =back
24980
24981 =over 4
24982
24983 =item ACCESSORS
24984
24985 ok, number
24986
24987 =back
24988
24989 =head2 Test::Harness::Straps - detailed analysis of test results
24990
24991 =over 4
24992
24993 =item SYNOPSIS
24994
24995 =item DESCRIPTION
24996
24997 =item CONSTRUCTION
24998
24999 =over 4
25000
25001 =item new()
25002
25003 =back
25004
25005 =back
25006
25007 =over 4
25008
25009 =item $strap->_init
25010
25011 =back
25012
25013 =over 4
25014
25015 =item ANALYSIS
25016
25017 =over 4
25018
25019 =item $strap->analyze( $name, \@output_lines )
25020
25021 =back
25022
25023 =back
25024
25025 =over 4
25026
25027 =item $strap->analyze_fh( $name, $test_filehandle )
25028
25029 =back
25030
25031 =over 4
25032
25033 =item $strap->analyze_file( $test_file )
25034
25035 =back
25036
25037 =over 4
25038
25039 =item $strap->_command_line( $file )
25040
25041 =back
25042
25043 =over 4
25044
25045 =item $strap->_command()
25046
25047 =back
25048
25049 =over 4
25050
25051 =item $strap->_switches( $file )
25052
25053 =back
25054
25055 =over 4
25056
25057 =item $strap->_cleaned_switches( @switches_from_user )
25058
25059 =back
25060
25061 =over 4
25062
25063 =item $strap->_INC2PERL5LIB
25064
25065 =back
25066
25067 =over 4
25068
25069 =item $strap->_filtered_INC()
25070
25071 =back
25072
25073 =over 4
25074
25075 =item $strap->_restore_PERL5LIB()
25076
25077 =back
25078
25079 =over 4
25080
25081 =item Parsing
25082
25083 =over 4
25084
25085 =item C<_is_diagnostic>
25086
25087 =back
25088
25089 =back
25090
25091 =over 4
25092
25093 =item C<_is_header>
25094
25095 =back
25096
25097 =over 4
25098
25099 =item C<_is_bail_out>
25100
25101 =back
25102
25103 =over 4
25104
25105 =item C<_reset_file_state>
25106
25107 =back
25108
25109 =over 4
25110
25111 =item Results
25112
25113 =item EXAMPLES
25114
25115 =item AUTHOR
25116
25117 =item SEE ALSO
25118
25119 =back
25120
25121 =head2 Test::Harness::TAP - Documentation for the TAP format
25122
25123 =over 4
25124
25125 =item SYNOPSIS
25126
25127 =item TODO
25128
25129 =item THE TAP FORMAT
25130
25131 =item HARNESS BEHAVIOR
25132
25133 =item TESTS LINES AND THE PLAN
25134
25135 =over 4
25136
25137 =item The plan
25138
25139 =item The test line
25140
25141 C<ok> or C<not ok>, Test number, Description, Directive, ok/not ok
25142 (required), Test number (recommended), Description (recommended), Directive
25143 (only when necessary)
25144
25145 =back
25146
25147 =item DIRECTIVES
25148
25149 =over 4
25150
25151 =item TODO tests
25152
25153 =item Skipping tests
25154
25155 =back
25156
25157 =item OTHER LINES
25158
25159 =over 4
25160
25161 =item Bail out!
25162
25163 =item Diagnostics
25164
25165 =item Anything else
25166
25167 =back
25168
25169 =item EXAMPLES
25170
25171 =over 4
25172
25173 =item Common with explanation
25174
25175 =item Unknown amount and failures
25176
25177 =item Giving up
25178
25179 =item Skipping a few
25180
25181 =item Skipping everything
25182
25183 =item Got spare tuits?
25184
25185 =item Creative liberties
25186
25187 =back
25188
25189 =item AUTHORS
25190
25191 =item ACKNOWLEDGEMENTS
25192
25193 =item COPYRIGHT
25194
25195 =back
25196
25197 =head2 Test::More - yet another framework for writing test scripts
25198
25199 =over 4
25200
25201 =item SYNOPSIS
25202
25203 =item DESCRIPTION
25204
25205 =over 4
25206
25207 =item I love it when a plan comes together
25208
25209 =back
25210
25211 =back
25212
25213 =over 4
25214
25215 =item Test names
25216
25217 =item I'm ok, you're not ok.
25218
25219 B<ok>
25220
25221 =back
25222
25223 B<is>, B<isnt>
25224
25225 B<like>
25226
25227 B<unlike>
25228
25229 B<cmp_ok>
25230
25231 B<can_ok>
25232
25233 B<isa_ok>
25234
25235 B<pass>, B<fail>
25236
25237 =over 4
25238
25239 =item Module tests
25240
25241 B<use_ok>
25242
25243 =back
25244
25245 B<require_ok>
25246
25247 =over 4
25248
25249 =item Complex data structures
25250
25251 B<is_deeply>
25252
25253 =back
25254
25255 =over 4
25256
25257 =item Diagnostics
25258
25259 B<diag>
25260
25261 =back
25262
25263 =over 4
25264
25265 =item Conditional tests
25266
25267 B<SKIP: BLOCK>
25268
25269 =back
25270
25271 B<TODO: BLOCK>, B<todo_skip>
25272
25273 When do I use SKIP vs. TODO?
25274
25275 =over 4
25276
25277 =item Test control
25278
25279 B<BAIL_OUT>
25280
25281 =back
25282
25283 =over 4
25284
25285 =item Discouraged comparison functions
25286
25287 B<eq_array>
25288
25289 =back
25290
25291 B<eq_hash>
25292
25293 B<eq_set>
25294
25295 =over 4
25296
25297 =item Extending and Embedding Test::More
25298
25299 B<builder>
25300
25301 =back
25302
25303 =over 4
25304
25305 =item EXIT CODES
25306
25307 =item CAVEATS and NOTES
25308
25309 Backwards compatibility, Overloaded objects, Threads, Test::Harness upgrade
25310
25311 =item HISTORY
25312
25313 =item SEE ALSO
25314
25315 =item AUTHORS
25316
25317 =item BUGS
25318
25319 =item COPYRIGHT
25320
25321 =back
25322
25323 =head2 Test::Simple - Basic utilities for writing tests.
25324
25325 =over 4
25326
25327 =item SYNOPSIS
25328
25329 =item DESCRIPTION
25330
25331 B<ok>
25332
25333 =back
25334
25335 =over 4
25336
25337 =item EXAMPLE
25338
25339 =item CAVEATS
25340
25341 =item NOTES
25342
25343 =item HISTORY
25344
25345 =item SEE ALSO
25346
25347 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
25348 L<Test::Harness>
25349
25350 =item AUTHORS
25351
25352 =item COPYRIGHT
25353
25354 =back
25355
25356 =head2 Test::Tutorial - A tutorial about writing really basic tests
25357
25358 =over 4
25359
25360 =item DESCRIPTION
25361
25362 =over 4
25363
25364 =item Nuts and bolts of testing.
25365
25366 =item Where to start?
25367
25368 =item Names
25369
25370 =item Test the manual
25371
25372 =item Sometimes the tests are wrong
25373
25374 =item Testing lots of values
25375
25376 =item Informative names
25377
25378 =item Skipping tests
25379
25380 =item Todo tests
25381
25382 =item Testing with taint mode.
25383
25384 =back
25385
25386 =item FOOTNOTES
25387
25388 =item AUTHORS
25389
25390 =item COPYRIGHT
25391
25392 =back
25393
25394 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
25395
25396 =over 4
25397
25398 =item SYNOPSIS
25399
25400 =item DESCRIPTION
25401
25402 =item EXAMPLE
25403
25404 =back
25405
25406 =head2 Text::Balanced - Extract delimited text sequences from strings.
25407
25408 =over 4
25409
25410 =item SYNOPSIS
25411
25412 =item DESCRIPTION
25413
25414 =over 4
25415
25416 =item General behaviour in list contexts
25417
25418 [0], [1], [2]
25419
25420 =item General behaviour in scalar and void contexts
25421
25422 =item A note about prefixes
25423
25424 =item C<extract_delimited>
25425
25426 =item C<extract_bracketed>
25427
25428 =item C<extract_variable>
25429
25430 [0], [1], [2]
25431
25432 =item C<extract_tagged>
25433
25434 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
25435 [0], [1], [2], [3], [4], [5]
25436
25437 =item C<gen_extract_tagged>
25438
25439 =item C<extract_quotelike>
25440
25441 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
25442
25443 =item C<extract_quotelike> and "here documents"
25444
25445 [0], [1], [2], [3], [4], [5], [6], [7..10]
25446
25447 =item C<extract_codeblock>
25448
25449 =item C<extract_multiple>
25450
25451 =item C<gen_delimited_pat>
25452
25453 =back
25454
25455 =item DIAGNOSTICS
25456
25457  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>, 
25458 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
25459 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">, 
25460 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
25461 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
25462 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
25463 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
25464 after dereferencer>, C<Did not find expected opening bracket at %s>,
25465 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
25466 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
25467 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
25468 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
25469 tag>
25470
25471 =item AUTHOR
25472
25473 =item BUGS AND IRRITATIONS
25474
25475 =item COPYRIGHT
25476
25477 =back
25478
25479 =head2 Text::ParseWords - parse text into an array of tokens or array of
25480 arrays
25481
25482 =over 4
25483
25484 =item SYNOPSIS
25485
25486 =item DESCRIPTION
25487
25488 =item EXAMPLES
25489
25490 =item AUTHORS
25491
25492 =back
25493
25494 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
25495 by Knuth
25496
25497 =over 4
25498
25499 =item SYNOPSIS
25500
25501 =item DESCRIPTION
25502
25503 =item EXAMPLES
25504
25505 =item LIMITATIONS
25506
25507 =item AUTHOR
25508
25509 =back
25510
25511 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
25512 unexpand(1)
25513
25514 =over 4
25515
25516 =item SYNOPSIS
25517
25518 =item DESCRIPTION
25519
25520 =item BUGS
25521
25522 =item LICENSE
25523
25524 =back
25525
25526 =head2 Text::Wrap - line wrapping to form simple paragraphs
25527
25528 =over 4
25529
25530 =item SYNOPSIS 
25531
25532 =item DESCRIPTION
25533
25534 =item OVERRIDES
25535
25536 =item EXAMPLE
25537
25538 =item LICENSE
25539
25540 =back
25541
25542 =head2 Thread - manipulate threads in Perl (for old code only)
25543
25544 =over 4
25545
25546 =item CAVEAT
25547
25548 =item SYNOPSIS
25549
25550 =item DESCRIPTION
25551
25552 =item FUNCTIONS
25553
25554 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
25555 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
25556 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
25557
25558 =item METHODS
25559
25560 join, eval, detach, equal, tid, flags, done
25561
25562 =item LIMITATIONS
25563
25564 =item SEE ALSO
25565
25566 =back
25567
25568 =head2 Thread::Queue - thread-safe queues
25569
25570 =over 4
25571
25572 =item SYNOPSIS
25573
25574 =item DESCRIPTION
25575
25576 =item FUNCTIONS AND METHODS
25577
25578 new, enqueue LIST, dequeue, dequeue_nb, pending
25579
25580 =item SEE ALSO
25581
25582 =back
25583
25584 =head2 Thread::Semaphore - thread-safe semaphores
25585
25586 =over 4
25587
25588 =item SYNOPSIS
25589
25590 =item DESCRIPTION
25591
25592 =item FUNCTIONS AND METHODS
25593
25594 new, new NUMBER, down, down NUMBER, up, up NUMBER
25595
25596 =back
25597
25598 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
25599 (for old code)
25600
25601 =over 4
25602
25603 =item CAVEAT
25604
25605 =item SYNOPSIS
25606
25607 =item DESCRIPTION
25608
25609 =item BUGS
25610
25611 =back
25612
25613 =head2 Thread::Specific - thread-specific keys
25614
25615 =over 4
25616
25617 =item SYNOPSIS
25618
25619 =item DESCRIPTION
25620
25621 =back
25622
25623 =head2 Tie::Array - base class for tied arrays
25624
25625 =over 4
25626
25627 =item SYNOPSIS
25628
25629 =item DESCRIPTION
25630
25631 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
25632 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
25633 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
25634 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
25635
25636 =item CAVEATS
25637
25638 =item AUTHOR
25639
25640 =back
25641
25642 =head2 Tie::File - Access the lines of a disk file via a Perl array
25643
25644 =over 4
25645
25646 =item SYNOPSIS
25647
25648 =item DESCRIPTION
25649
25650 =over 4
25651
25652 =item C<recsep>
25653
25654 =item C<autochomp>
25655
25656 =item C<mode>
25657
25658 =item C<memory>
25659
25660 =item C<dw_size>
25661
25662 =item Option Format
25663
25664 =back
25665
25666 =item Public Methods
25667
25668 =over 4
25669
25670 =item C<flock>
25671
25672 =item C<autochomp>
25673
25674 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
25675
25676 =item C<offset>
25677
25678 =back
25679
25680 =item Tying to an already-opened filehandle
25681
25682 =item Deferred Writing
25683
25684 =over 4
25685
25686 =item Autodeferring
25687
25688 =back
25689
25690 =item CONCURRENT ACCESS TO FILES
25691
25692 =item CAVEATS
25693
25694 =item SUBCLASSING
25695
25696 =item WHAT ABOUT C<DB_File>?
25697
25698 =item AUTHOR
25699
25700 =item LICENSE
25701
25702 =item WARRANTY
25703
25704 =item THANKS
25705
25706 =item TODO
25707
25708 =back
25709
25710 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
25711 handles
25712
25713 =over 4
25714
25715 =item SYNOPSIS
25716
25717 =item DESCRIPTION
25718
25719 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
25720 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
25721 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
25722 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
25723
25724 =item MORE INFORMATION
25725
25726 =item COMPATIBILITY
25727
25728 =back
25729
25730 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
25731 tied hashes
25732
25733 =over 4
25734
25735 =item SYNOPSIS
25736
25737 =item DESCRIPTION
25738
25739 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
25740 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR
25741 this, SCALAR this
25742
25743 =item Inheriting from B<Tie::StdHash>
25744
25745 =item Inheriting from B<Tie::ExtraHash>
25746
25747 =item C<SCALAR>, C<UNTIE> and C<DESTROY>
25748
25749 =item MORE INFORMATION
25750
25751 =back
25752
25753 =head2 Tie::Memoize - add data to hash when needed
25754
25755 =over 4
25756
25757 =item SYNOPSIS
25758
25759 =item DESCRIPTION
25760
25761 =item Inheriting from B<Tie::Memoize>
25762
25763 =item EXAMPLE
25764
25765 =item BUGS
25766
25767 =item AUTHOR
25768
25769 =back
25770
25771 =head2 Tie::RefHash - use references as hash keys
25772
25773 =over 4
25774
25775 =item SYNOPSIS
25776
25777 =item DESCRIPTION
25778
25779 =item EXAMPLE
25780
25781 =item AUTHOR
25782
25783 =item VERSION
25784
25785 =item SEE ALSO
25786
25787 =back
25788
25789 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
25790 scalars
25791
25792 =over 4
25793
25794 =item SYNOPSIS
25795
25796 =item DESCRIPTION
25797
25798 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
25799
25800 =item MORE INFORMATION
25801
25802 =back
25803
25804 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
25805
25806 =over 4
25807
25808 =item SYNOPSIS
25809
25810 =item DESCRIPTION
25811
25812 =item CAVEATS
25813
25814 =back
25815
25816 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
25817 timers
25818
25819 =over 4
25820
25821 =item SYNOPSIS
25822
25823 =item DESCRIPTION
25824
25825 gettimeofday (), usleep ( $useconds ), nanosleep ( $nanoseconds ), ualarm (
25826 $useconds [, $interval_useconds ] ), tv_interval, time (), sleep (
25827 $floating_seconds ), alarm ( $floating_seconds [,
25828 $interval_floating_seconds ] ), setitimer ( $which, $floating_seconds [,
25829 $interval_floating_seconds ] ), getitimer ( $which ), clock_gettime (
25830 $which ), clock_getres ( $which ), clock_nanosleep ( $which, $seconds,
25831 $flags = 0), clock()
25832
25833 =item EXAMPLES
25834
25835 =item C API
25836
25837 =item DIAGNOSTICS
25838
25839 =over 4
25840
25841 =item negative time not invented yet
25842
25843 =item internal error: useconds < 0 (unsigned ... signed ...)
25844
25845 =back
25846
25847 =item CAVEATS
25848
25849 =item SEE ALSO
25850
25851 =item AUTHORS
25852
25853 =item COPYRIGHT AND LICENSE
25854
25855 =back
25856
25857 =head2 Time::Local - efficiently compute time from local and GMT time
25858
25859 =over 4
25860
25861 =item SYNOPSIS
25862
25863 =item DESCRIPTION
25864
25865 =over 4
25866
25867 =item Ambiguous Local Times (DST)
25868
25869 =item Non-Existent Local Times (DST)
25870
25871 =item Negative Epoch Values
25872
25873 =back
25874
25875 =item IMPLEMENTATION
25876
25877 =item BUGS
25878
25879 =item SUPPORT
25880
25881 =item AUTHOR
25882
25883 =back
25884
25885 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
25886 function
25887
25888 =over 4
25889
25890 =item SYNOPSIS
25891
25892 =item DESCRIPTION
25893
25894 =item NOTE
25895
25896 =item AUTHOR
25897
25898 =back
25899
25900 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
25901 function
25902
25903 =over 4
25904
25905 =item SYNOPSIS
25906
25907 =item DESCRIPTION
25908
25909 =item NOTE
25910
25911 =item AUTHOR
25912
25913 =back
25914
25915 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
25916
25917 =over 4
25918
25919 =item SYNOPSIS
25920
25921 =item DESCRIPTION
25922
25923 =item AUTHOR
25924
25925 =back
25926
25927 =head2 UNIVERSAL - base class for ALL classes (blessed references)
25928
25929 =over 4
25930
25931 =item SYNOPSIS
25932
25933 =item DESCRIPTION
25934
25935 C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<< eval { VAL->isa(
25936 TYPE ) } >>, C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD )
25937 >>, C<< CLASS->can( METHOD ) >>, C<< eval { VAL->can( METHOD ) } >>,
25938 C<VERSION ( [ REQUIRE ] )>
25939
25940 =item EXPORTS
25941
25942 =back
25943
25944 =head2 Unicode::Collate - Unicode Collation Algorithm
25945
25946 =over 4
25947
25948 =item SYNOPSIS
25949
25950 =item DESCRIPTION
25951
25952 =over 4
25953
25954 =item Constructor and Tailoring
25955
25956 UCA_Version, alternate, backwards, entry, hangul_terminator, ignoreChar,
25957 ignoreName, katakana_before_hiragana, level, normalization, overrideCJK,
25958 overrideHangul, preprocess, rearrange, table, undefChar, undefName,
25959 upper_before_lower, variable
25960
25961 =item Methods for Collation
25962
25963 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
25964 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
25965 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
25966 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
25967 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
25968 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
25969 $Collator-E<gt>viewSortKey($string)>
25970
25971 =item Methods for Searching
25972
25973 C<$position = $Collator-E<gt>index($string, $substring[, $position])>,
25974 C<($position, $length) = $Collator-E<gt>index($string, $substring[,
25975 $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>,
25976 C<($match)   = $Collator-E<gt>match($string, $substring)>, C<@match =
25977 $Collator-E<gt>gmatch($string, $substring)>, C<$count =
25978 $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count =
25979 $Collator-E<gt>gsubst($string, $substring, $replacement)>
25980
25981 =item Other Methods
25982
25983 C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, C<$version =
25984 $Collator-E<gt>version()>, C<UCA_Version()>, C<Base_Unicode_Version()>
25985
25986 =back
25987
25988 =item EXPORT
25989
25990 =item INSTALL
25991
25992 =item CAVEATS
25993
25994 Normalization, Conformance Test
25995
25996 =item AUTHOR, COPYRIGHT AND LICENSE
25997
25998 =item SEE ALSO
25999
26000 Unicode Collation Algorithm - UTS #10, The Default Unicode Collation
26001 Element Table (DUCET), The conformance test for the UCA, Hangul Syllable
26002 Type, Unicode Normalization Forms - UAX #15
26003
26004 =back
26005
26006 =head2 Unicode::Normalize - Unicode Normalization Forms
26007
26008 =over 4
26009
26010 =item SYNOPSIS
26011
26012 =item DESCRIPTION
26013
26014 =over 4
26015
26016 =item Normalization Forms
26017
26018 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
26019 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
26020 C<$FCD_string = FCD($string)>, C<$FCC_string = FCC($string)>,
26021 C<$normalized_string = normalize($form_name, $string)>
26022
26023 =item Decomposition and Composition
26024
26025 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
26026 decompose($string, $useCompatMapping)>, C<$reordered_string  =
26027 reorder($string)>, C<$composed_string   = compose($string)>
26028
26029 =item Quick Check
26030
26031 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
26032 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
26033 checkFCD($string)>, C<$result = checkFCC($string)>, C<$result =
26034 check($form_name, $string)>
26035
26036 =item Character Data
26037
26038 C<$canonical_decomposed = getCanon($codepoint)>,
26039 C<$compatibility_decomposed = getCompat($codepoint)>,
26040 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
26041 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
26042 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
26043 C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>,
26044 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
26045
26046 =back
26047
26048 =item EXPORT
26049
26050 =item CAVEATS
26051
26052 Perl's version vs. Unicode version, Correction of decomposition mapping,
26053 Revised definition of canonical composition
26054
26055 =item AUTHOR
26056
26057 =item SEE ALSO
26058
26059 http://www.unicode.org/reports/tr15/,
26060 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt,
26061 http://www.unicode.org/Public/UNIDATA/NormalizationCorrections.txt,
26062 http://www.unicode.org/review/pr-29.html, http://www.unicode.org/notes/tn5/
26063
26064 =back
26065
26066 =head2 Unicode::UCD - Unicode character database
26067
26068 =over 4
26069
26070 =item SYNOPSIS
26071
26072 =item DESCRIPTION
26073
26074 =back
26075
26076 =over 4
26077
26078 =item charinfo
26079
26080 =back
26081
26082 =over 4
26083
26084 =item charblock
26085
26086 =back
26087
26088 =over 4
26089
26090 =item charscript
26091
26092 =back
26093
26094 =over 4
26095
26096 =item charblocks
26097
26098 =back
26099
26100 =over 4
26101
26102 =item charscripts
26103
26104 =back
26105
26106 =over 4
26107
26108 =item Blocks versus Scripts
26109
26110 =item Matching Scripts and Blocks
26111
26112 =item Code Point Arguments
26113
26114 =item charinrange
26115
26116 =back
26117
26118 =over 4
26119
26120 =item compexcl
26121
26122 =back
26123
26124 =over 4
26125
26126 =item casefold
26127
26128 =back
26129
26130 =over 4
26131
26132 =item casespec
26133
26134 =back
26135
26136 =over 4
26137
26138 =item namedseq()
26139
26140 =back
26141
26142 =over 4
26143
26144 =item Unicode::UCD::UnicodeVersion
26145
26146 =back
26147
26148 =over 4
26149
26150 =item Implementation Note
26151
26152 =back
26153
26154 =over 4
26155
26156 =item BUGS
26157
26158 =item AUTHOR
26159
26160 =back
26161
26162 =head2 User::grent - by-name interface to Perl's built-in getgr*()
26163 functions
26164
26165 =over 4
26166
26167 =item SYNOPSIS
26168
26169 =item DESCRIPTION
26170
26171 =item NOTE
26172
26173 =item AUTHOR
26174
26175 =back
26176
26177 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
26178 functions
26179
26180 =over 4
26181
26182 =item SYNOPSIS
26183
26184 =item DESCRIPTION
26185
26186 =over 4
26187
26188 =item System Specifics
26189
26190 =back
26191
26192 =item NOTE
26193
26194 =item AUTHOR
26195
26196 =item HISTORY
26197
26198 March 18th, 2000
26199
26200 =back
26201
26202 =head2 XSLoader - Dynamically load C libraries into Perl code
26203
26204 =over 4
26205
26206 =item VERSION
26207
26208 =item SYNOPSIS
26209
26210 =item DESCRIPTION
26211
26212 =over 4
26213
26214 =item Migration from C<DynaLoader>
26215
26216 =item Backward compatible boilerplate
26217
26218 =back
26219
26220 =item Order of initialization: early load()
26221
26222 =over 4
26223
26224 =item The most hairy case
26225
26226 =back
26227
26228 =item DIAGNOSTICS
26229
26230 Can't find '%s' symbol in %s, Can't load '%s' for module %s: %s, Undefined
26231 symbols present after loading %s: %s, XSLoader::load('Your::Module',
26232 $Your::Module::VERSION)
26233
26234 =item LIMITATIONS
26235
26236 =item BUGS
26237
26238 =item SEE ALSO
26239
26240 =item AUTHORS
26241
26242 =item COPYRIGHT
26243
26244 =back
26245
26246 =head1 AUXILIARY DOCUMENTATION
26247
26248 Here should be listed all the extra programs' documentation, but they
26249 don't all have manual pages yet:
26250
26251 =over 4
26252
26253 =item a2p
26254
26255 =item c2ph
26256
26257 =item dprofpp
26258
26259 =item h2ph
26260
26261 =item h2xs
26262
26263 =item perlbug
26264
26265 =item perldoc
26266
26267 =item pl2pm
26268
26269 =item pod2html
26270
26271 =item pod2man
26272
26273 =item s2p
26274
26275 =item splain
26276
26277 =item xsubpp
26278
26279 =back
26280
26281 =head1 AUTHOR
26282
26283 Larry Wall <F<larry@wall.org>>, with the help of oodles
26284 of other folks.
26285