Force RVALUE macros when in PERL_DEBUG_COW
[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
161 =item COMMON MISTAKES
162
163 =item CAVEAT ON PRECEDENCE
164
165 =item WHY YOU SHOULD ALWAYS C<use strict>
166
167 =item DEBUGGING
168
169 =item CODE EXAMPLES
170
171 =item ARRAYS OF ARRAYS
172
173 =over 4
174
175 =item Declaration of an ARRAY OF ARRAYS
176
177 =item Generation of an ARRAY OF ARRAYS
178
179 =item Access and Printing of an ARRAY OF ARRAYS
180
181 =back
182
183 =item HASHES OF ARRAYS
184
185 =over 4
186
187 =item Declaration of a HASH OF ARRAYS
188
189 =item Generation of a HASH OF ARRAYS
190
191 =item Access and Printing of a HASH OF ARRAYS
192
193 =back
194
195 =item ARRAYS OF HASHES
196
197 =over 4
198
199 =item Declaration of an ARRAY OF HASHES
200
201 =item Generation of an ARRAY OF HASHES
202
203 =item Access and Printing of an ARRAY OF HASHES
204
205 =back
206
207 =item HASHES OF HASHES
208
209 =over 4
210
211 =item Declaration of a HASH OF HASHES
212
213 =item Generation of a HASH OF HASHES
214
215 =item Access and Printing of a HASH OF HASHES
216
217 =back
218
219 =item MORE ELABORATE RECORDS
220
221 =over 4
222
223 =item Declaration of MORE ELABORATE RECORDS
224
225 =item Declaration of a HASH OF COMPLEX RECORDS
226
227 =item Generation of a HASH OF COMPLEX RECORDS
228
229 =back
230
231 =item Database Ties
232
233 =item SEE ALSO
234
235 =item AUTHOR
236
237 =back
238
239 =head2 perllol - Manipulating Arrays of Arrays in Perl
240
241 =over 4
242
243 =item DESCRIPTION
244
245 =over 4
246
247 =item Declaration and Access of Arrays of Arrays
248
249 =item Growing Your Own
250
251 =item Access and Printing
252
253 =item Slices
254
255 =back
256
257 =item SEE ALSO
258
259 =item AUTHOR
260
261 =back
262
263 =head2 perlrequick - Perl regular expressions quick start
264
265 =over 4
266
267 =item DESCRIPTION
268
269 =item The Guide
270
271 =over 4
272
273 =item Simple word matching
274
275 =item Using character classes
276
277 =item Matching this or that
278
279 =item Grouping things and hierarchical matching
280
281 =item Extracting matches
282
283 =item Matching repetitions
284
285 =item More matching
286
287 =item Search and replace
288
289 =item The split operator
290
291 =back
292
293 =item BUGS
294
295 =item SEE ALSO
296
297 =item AUTHOR AND COPYRIGHT
298
299 =over 4
300
301 =item Acknowledgments
302
303 =back
304
305 =back
306
307 =head2 perlretut - Perl regular expressions tutorial
308
309 =over 4
310
311 =item DESCRIPTION
312
313 =item Part 1: The basics
314
315 =over 4
316
317 =item Simple word matching
318
319 =item Using character classes
320
321 =item Matching this or that
322
323 =item Grouping things and hierarchical matching
324
325 =item Extracting matches
326
327 =item Matching repetitions
328
329 =item Building a regexp
330
331 =item Using regular expressions in Perl
332
333 =back
334
335 =item Part 2: Power tools
336
337 =over 4
338
339 =item More on characters, strings, and character classes
340
341 =item Compiling and saving regular expressions
342
343 =item Embedding comments and modifiers in a regular expression
344
345 =item Non-capturing groupings
346
347 =item Looking ahead and looking behind
348
349 =item Using independent subexpressions to prevent backtracking
350
351 =item Conditional expressions
352
353 =item A bit of magic: executing Perl code in a regular expression
354
355 =item Pragmas and debugging
356
357 =back
358
359 =item BUGS
360
361 =item SEE ALSO
362
363 =item AUTHOR AND COPYRIGHT
364
365 =over 4
366
367 =item Acknowledgments
368
369 =back
370
371 =back
372
373 =head2 perlboot - Beginner's Object-Oriented Tutorial
374
375 =over 4
376
377 =item DESCRIPTION
378
379 =over 4
380
381 =item If we could talk to the animals...
382
383 =item Introducing the method invocation arrow
384
385 =item Invoking a barnyard
386
387 =item The extra parameter of method invocation
388
389 =item Calling a second method to simplify things
390
391 =item Inheriting the windpipes
392
393 =item A few notes about @ISA
394
395 =item Overriding the methods
396
397 =item Starting the search from a different place
398
399 =item The SUPER way of doing things
400
401 =item Where we're at so far...
402
403 =item A horse is a horse, of course of course -- or is it?
404
405 =item Invoking an instance method
406
407 =item Accessing the instance data
408
409 =item How to build a horse
410
411 =item Inheriting the constructor
412
413 =item Making a method work with either classes or instances
414
415 =item Adding parameters to a method
416
417 =item More interesting instances
418
419 =item A horse of a different color
420
421 =item Summary
422
423 =back
424
425 =item SEE ALSO
426
427 =item COPYRIGHT
428
429 =back
430
431 =head2 perltoot - Tom's object-oriented tutorial for perl
432
433 =over 4
434
435 =item DESCRIPTION
436
437 =item Creating a Class
438
439 =over 4
440
441 =item Object Representation
442
443 =item Class Interface
444
445 =item Constructors and Instance Methods
446
447 =item Planning for the Future: Better Constructors
448
449 =item Destructors
450
451 =item Other Object Methods
452
453 =back
454
455 =item Class Data
456
457 =over 4
458
459 =item Accessing Class Data
460
461 =item Debugging Methods
462
463 =item Class Destructors
464
465 =item Documenting the Interface
466
467 =back
468
469 =item Aggregation
470
471 =item Inheritance
472
473 =over 4
474
475 =item Overridden Methods
476
477 =item Multiple Inheritance
478
479 =item UNIVERSAL: The Root of All Objects
480
481 =back
482
483 =item Alternate Object Representations
484
485 =over 4
486
487 =item Arrays as Objects
488
489 =item Closures as Objects
490
491 =back
492
493 =item AUTOLOAD: Proxy Methods
494
495 =over 4
496
497 =item Autoloaded Data Methods
498
499 =item Inherited Autoloaded Data Methods
500
501 =back
502
503 =item Metaclassical Tools
504
505 =over 4
506
507 =item Class::Struct
508
509 =item Data Members as Variables
510
511 =back
512
513 =item NOTES
514
515 =over 4
516
517 =item Object Terminology
518
519 =back
520
521 =item SEE ALSO
522
523 =item AUTHOR AND COPYRIGHT
524
525 =item COPYRIGHT
526
527 =over 4
528
529 =item Acknowledgments
530
531 =back
532
533 =back
534
535 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
536
537 =over 4
538
539 =item DESCRIPTION
540
541 =item Class Data in a Can
542
543 =item Class Data as Package Variables
544
545 =over 4
546
547 =item Putting All Your Eggs in One Basket
548
549 =item Inheritance Concerns
550
551 =item The Eponymous Meta-Object
552
553 =item Indirect References to Class Data
554
555 =item Monadic Classes
556
557 =item Translucent Attributes
558
559 =back
560
561 =item Class Data as Lexical Variables
562
563 =over 4
564
565 =item Privacy and Responsibility 
566
567 =item File-Scoped Lexicals
568
569 =item More Inheritance Concerns
570
571 =item Locking the Door and Throwing Away the Key
572
573 =item Translucency Revisited
574
575 =back
576
577 =item NOTES
578
579 =item SEE ALSO
580
581 =item AUTHOR AND COPYRIGHT
582
583 =item ACKNOWLEDGEMENTS
584
585 =item HISTORY
586
587 =back
588
589 =head2 perlbot - Bag'o Object Tricks (the BOT)
590
591 =over 4
592
593 =item DESCRIPTION
594
595 =item OO SCALING TIPS
596
597 =item INSTANCE VARIABLES
598
599 =item SCALAR INSTANCE VARIABLES
600
601 =item INSTANCE VARIABLE INHERITANCE
602
603 =item OBJECT RELATIONSHIPS
604
605 =item OVERRIDING SUPERCLASS METHODS
606
607 =item USING RELATIONSHIP WITH SDBM
608
609 =item THINKING OF CODE REUSE
610
611 =item CLASS CONTEXT AND THE OBJECT
612
613 =item INHERITING A CONSTRUCTOR
614
615 =item DELEGATION
616
617 =item SEE ALSO
618
619 =back
620
621 =head2 perlstyle - Perl style guide
622
623 =over 4
624
625 =item DESCRIPTION
626
627 =back
628
629 =head2 perlcheat - Perl 5 Cheat Sheet
630
631 =over 4
632
633 =item DESCRIPTION
634
635 =over 4
636
637 =item The sheet
638
639 =back
640
641 =item ACKNOWLEDGEMENTS
642
643 =item AUTHOR
644
645 =item SEE ALSO
646
647 =back
648
649 =head2 perltrap - Perl traps for the unwary
650
651 =over 4
652
653 =item DESCRIPTION
654
655 =over 4
656
657 =item Awk Traps
658
659 =item C/C++ Traps
660
661 =item Sed Traps
662
663 =item Shell Traps
664
665 =item Perl Traps
666
667 =item Perl4 to Perl5 Traps
668
669 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
670 Traps, General data type traps, Context Traps - scalar, list contexts,
671 Precedence Traps, General Regular Expression Traps using s///, etc,
672 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
673
674 =item Discontinuance, Deprecation, and BugFix traps
675
676 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
677 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
678 Discontinuance, Deprecation, Discontinuance, Discontinuance
679
680 =item Parsing Traps
681
682 Parsing, Parsing, Parsing, Parsing, Parsing
683
684 =item Numerical Traps
685
686 Numerical, Numerical, Numerical, Bitwise string ops
687
688 =item General data type traps
689
690 (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
691 (Constants), (Scalars), (Variable Suicide)
692
693 =item Context Traps - scalar, list contexts
694
695 (list context), (scalar context), (scalar context), (list, builtin)
696
697 =item Precedence Traps
698
699 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
700 Precedence
701
702 =item General Regular Expression Traps using s///, etc.
703
704 Regular Expression, Regular Expression, Regular Expression, Regular
705 Expression, Regular Expression, Regular Expression, Regular Expression,
706 Regular Expression, Regular Expression
707
708 =item Subroutine, Signal, Sorting Traps
709
710 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
711
712 =item OS Traps
713
714 (SysV), (SysV)
715
716 =item Interpolation Traps
717
718 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
719 Interpolation, Interpolation, Interpolation, Interpolation
720
721 =item DBM Traps
722
723 DBM, DBM
724
725 =item Unclassified Traps
726
727 C<require>/C<do> trap using returned value, C<split> on empty string with
728 LIMIT specified
729
730 =back
731
732 =back
733
734 =head2 perldebtut - Perl debugging tutorial
735
736 =over 4
737
738 =item DESCRIPTION
739
740 =item use strict
741
742 =item Looking at data and -w and v
743
744 =item help
745
746 =item Stepping through code
747
748 =item Placeholder for a, w, t, T
749
750 =item REGULAR EXPRESSIONS
751
752 =item OUTPUT TIPS
753
754 =item CGI
755
756 =item GUIs
757
758 =item SUMMARY
759
760 =item SEE ALSO
761
762 =item AUTHOR
763
764 =item CONTRIBUTORS
765
766 =back
767
768 =head2 perlfaq - frequently asked questions about Perl ($Date: 2005/03/27
769 07:21:21 $)
770
771 =over 4
772
773 =item DESCRIPTION
774
775 =over 4
776
777 =item Where to get the perlfaq
778
779 =item How to contribute to the perlfaq
780
781 =item What will happen if you mail your Perl programming problems to the
782 authors
783
784 =back
785
786 =item Credits
787
788 =item Author and Copyright Information
789
790 =over 4
791
792 =item Bundled Distributions
793
794 =item Disclaimer
795
796 =back
797
798 =item Table of Contents
799
800 perlfaq  - this document, perlfaq1 - General Questions About Perl, perlfaq2
801 - Obtaining and Learning about Perl, perlfaq3 - Programming Tools, perlfaq4
802 - Data Manipulation, perlfaq5 - Files and Formats, perlfaq6 - Regular
803 Expressions, perlfaq7 - General Perl Language Issues, perlfaq8 - System
804 Interaction, perlfaq9 - Networking
805
806 =item The Questions
807
808 =over 4
809
810 =item L<perlfaq1>: General Questions About Perl
811
812 =item L<perlfaq2>: Obtaining and Learning about Perl
813
814 =item L<perlfaq3>: Programming Tools
815
816 =item L<perlfaq4>: Data Manipulation
817
818 =item L<perlfaq5>: Files and Formats
819
820 =item L<perlfaq6>: Regular Expressions
821
822 =item L<perlfaq7>: General Perl Language Issues
823
824 =item L<perlfaq8>: System Interaction
825
826 =item L<perlfaq9>: Networking
827
828 =back
829
830 =back
831
832 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.17 $, $Date:
833 2005/01/31 15:52:15 $)
834
835 =over 4
836
837 =item DESCRIPTION
838
839 =over 4
840
841 =item What is Perl?
842
843 =item Who supports Perl?  Who develops it?  Why is it free?
844
845 =item Which version of Perl should I use?
846
847 =item What are perl4, perl5, or perl6?
848
849 =item What is Ponie?
850
851 =item What is perl6?
852
853 =item How stable is Perl?
854
855 =item Is Perl difficult to learn?
856
857 =item How does Perl compare with other languages like Java, Python, REXX,
858 Scheme, or Tcl?
859
860 =item Can I do [task] in Perl?
861
862 =item When shouldn't I program in Perl?
863
864 =item What's the difference between "perl" and "Perl"?
865
866 =item Is it a Perl program or a Perl script?
867
868 =item What is a JAPH?
869
870 =item Where can I get a list of Larry Wall witticisms?
871
872 =item How can I convince my sysadmin/supervisor/employees to use version
873 5/5.6.1/Perl instead of some other language?
874
875 =back
876
877 =item AUTHOR AND COPYRIGHT
878
879 =back
880
881 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.31 $,
882 $Date: 2005/01/31 15:54:44 $)
883
884 =over 4
885
886 =item DESCRIPTION
887
888 =over 4
889
890 =item What machines support Perl?  Where do I get it?
891
892 =item How can I get a binary version of Perl?
893
894 =item I don't have a C compiler on my system.  How can I compile perl?
895
896 =item I copied the Perl binary from one machine to another, but scripts
897 don't work.
898
899 =item I grabbed the sources and tried to compile but gdbm/dynamic
900 loading/malloc/linking/... failed.  How do I make it work?
901
902 =item What modules and extensions are available for Perl?  What is CPAN? 
903 What does CPAN/src/... mean?
904
905 =item Is there an ISO or ANSI certified version of Perl?
906
907 =item Where can I get information on Perl?
908
909 =item What are the Perl newsgroups on Usenet?  Where do I post questions?
910
911 =item Where should I post source code?
912
913 =item Perl Books
914
915 References, Tutorials, Task-Oriented, Special Topics
916
917 =item Perl in Magazines
918
919 =item Perl on the Net: FTP and WWW Access
920
921 =item What mailing lists are there for Perl?
922
923 =item Archives of comp.lang.perl.misc
924
925 =item Where can I buy a commercial version of Perl?
926
927 =item Where do I send bug reports?
928
929 =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
930
931 =back
932
933 =item AUTHOR AND COPYRIGHT
934
935 =back
936
937 =head2 perlfaq3 - Programming Tools ($Revision: 1.47 $, $Date: 2005/03/27
938 07:21:22 $)
939
940 =over 4
941
942 =item DESCRIPTION
943
944 =over 4
945
946 =item How do I do (anything)?
947
948 =item How can I use Perl interactively?
949
950 =item Is there a Perl shell?
951
952 =item How do I find which modules are installed on my system?
953
954 =item How do I debug my Perl programs?
955
956 =item How do I profile my Perl programs?
957
958 =item How do I cross-reference my Perl programs?
959
960 =item Is there a pretty-printer (formatter) for Perl?
961
962 =item Is there a ctags for Perl?
963
964 =item Is there an IDE or Windows Perl Editor?
965
966 Eclipse, Komodo, Open Perl IDE, OptiPerl, PerlBuilder, visiPerl+, Visual
967 Perl, GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis, Vile, Vim, Codewright,
968 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, Affrus, Alpha, BBEdit and
969 BBEdit Lite
970
971 =item Where can I get Perl macros for vi?
972
973 =item Where can I get perl-mode for emacs?
974
975 =item How can I use curses with Perl?
976
977 =item How can I use X or Tk with Perl?
978
979 =item How can I make my Perl program run faster?
980
981 =item How can I make my Perl program take less memory?
982
983 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
984 stringification, Pass by reference, Tie large variables to disk
985
986 =item Is it safe to return a reference to local or lexical data?
987
988 =item How can I free an array or hash so my program shrinks?
989
990 =item How can I make my CGI script more efficient?
991
992 =item How can I hide the source for my Perl program?
993
994 =item How can I compile my Perl program into byte code or C?
995
996 =item How can I compile Perl into Java?
997
998 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
999
1000 =item Can I write useful Perl programs on the command line?
1001
1002 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
1003
1004 =item Where can I learn about CGI or Web programming in Perl?
1005
1006 =item Where can I learn about object-oriented Perl programming?
1007
1008 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
1009
1010 =item I've read perlembed, perlguts, etc., but I can't embed perl in my C
1011 program; what am I doing wrong?
1012
1013 =item When I tried to run my script, I got this message. What does it mean?
1014
1015 =item What's MakeMaker?
1016
1017 =back
1018
1019 =item AUTHOR AND COPYRIGHT
1020
1021 =back
1022
1023 =head2 perlfaq4 - Data Manipulation ($Revision: 1.61 $, $Date: 2005/03/11
1024 16:27:53 $)
1025
1026 =over 4
1027
1028 =item DESCRIPTION
1029
1030 =item Data: Numbers
1031
1032 =over 4
1033
1034 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
1035 numbers I should be getting (eg, 19.95)?
1036
1037 =item Why is int() broken?
1038
1039 =item Why isn't my octal data interpreted correctly?
1040
1041 =item Does Perl have a round() function?  What about ceil() and floor()? 
1042 Trig functions?
1043
1044 =item How do I convert between numeric representations/bases/radixes?
1045
1046 How do I convert hexadecimal into decimal, How do I convert from decimal to
1047 hexadecimal, How do I convert from octal to decimal, How do I convert from
1048 decimal to octal, How do I convert from binary to decimal, How do I convert
1049 from decimal to binary
1050
1051 =item Why doesn't & work the way I want it to?
1052
1053 =item How do I multiply matrices?
1054
1055 =item How do I perform an operation on a series of integers?
1056
1057 =item How can I output Roman numerals?
1058
1059 =item Why aren't my random numbers random?
1060
1061 =item How do I get a random number between X and Y?
1062
1063 =back
1064
1065 =item Data: Dates
1066
1067 =over 4
1068
1069 =item How do I find the day or week of the year?
1070
1071 =item How do I find the current century or millennium?
1072
1073 =item How can I compare two dates and find the difference?
1074
1075 =item How can I take a string and turn it into epoch seconds?
1076
1077 =item How can I find the Julian Day?
1078
1079 =item How do I find yesterday's date?
1080
1081 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
1082
1083 =back
1084
1085 =item Data: Strings
1086
1087 =over 4
1088
1089 =item How do I validate input?
1090
1091 =item How do I unescape a string?
1092
1093 =item How do I remove consecutive pairs of characters?
1094
1095 =item How do I expand function calls in a string?
1096
1097 =item How do I find matching/nesting anything?
1098
1099 =item How do I reverse a string?
1100
1101 =item How do I expand tabs in a string?
1102
1103 =item How do I reformat a paragraph?
1104
1105 =item How can I access or change N characters of a string?
1106
1107 =item How do I change the Nth occurrence of something?
1108
1109 =item How can I count the number of occurrences of a substring within a
1110 string?
1111
1112 =item How do I capitalize all the words on one line?
1113
1114 =item How can I split a [character] delimited string except when inside
1115 [character]?
1116
1117 =item How do I strip blank space from the beginning/end of a string?
1118
1119 =item How do I pad a string with blanks or pad a number with zeroes?
1120
1121 =item How do I extract selected columns from a string?
1122
1123 =item How do I find the soundex value of a string?
1124
1125 =item How can I expand variables in text strings?
1126
1127 =item What's wrong with always quoting "$vars"?
1128
1129 =item Why don't my E<lt>E<lt>HERE documents work?
1130
1131 There must be no space after the E<lt>E<lt> part, There (probably) should
1132 be a semicolon at the end, You can't (easily) have any space in front of
1133 the tag
1134
1135 =back
1136
1137 =item Data: Arrays
1138
1139 =over 4
1140
1141 =item What is the difference between a list and an array?
1142
1143 =item What is the difference between $array[1] and @array[1]?
1144
1145 =item How can I remove duplicate elements from a list or array?
1146
1147 a), b), c), d), e)
1148
1149 =item How can I tell whether a certain element is contained in a list or
1150 array?
1151
1152 =item How do I compute the difference of two arrays?  How do I compute the
1153 intersection of two arrays?
1154
1155 =item How do I test whether two arrays or hashes are equal?
1156
1157 =item How do I find the first array element for which a condition is true?
1158
1159 =item How do I handle linked lists?
1160
1161 =item How do I handle circular lists?
1162
1163 =item How do I shuffle an array randomly?
1164
1165 =item How do I process/modify each element of an array?
1166
1167 =item How do I select a random element from an array?
1168
1169 =item How do I permute N elements of a list?
1170
1171 =item How do I sort an array by (anything)?
1172
1173 =item How do I manipulate arrays of bits?
1174
1175 =item Why does defined() return true on empty arrays and hashes?
1176
1177 =back
1178
1179 =item Data: Hashes (Associative Arrays)
1180
1181 =over 4
1182
1183 =item How do I process an entire hash?
1184
1185 =item What happens if I add or remove keys from a hash while iterating over
1186 it?
1187
1188 =item How do I look up a hash element by value?
1189
1190 =item How can I know how many entries are in a hash?
1191
1192 =item How do I sort a hash (optionally by value instead of key)?
1193
1194 =item How can I always keep my hash sorted?
1195
1196 =item What's the difference between "delete" and "undef" with hashes?
1197
1198 =item Why don't my tied hashes make the defined/exists distinction?
1199
1200 =item How do I reset an each() operation part-way through?
1201
1202 =item How can I get the unique keys from two hashes?
1203
1204 =item How can I store a multidimensional array in a DBM file?
1205
1206 =item How can I make my hash remember the order I put elements into it?
1207
1208 =item Why does passing a subroutine an undefined element in a hash create
1209 it?
1210
1211 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
1212 array of hashes or arrays?
1213
1214 =item How can I use a reference as a hash key?
1215
1216 =back
1217
1218 =item Data: Misc
1219
1220 =over 4
1221
1222 =item How do I handle binary data correctly?
1223
1224 =item How do I determine whether a scalar is a number/whole/integer/float?
1225
1226 =item How do I keep persistent data across program calls?
1227
1228 =item How do I print out or copy a recursive data structure?
1229
1230 =item How do I define methods for every class/object?
1231
1232 =item How do I verify a credit card checksum?
1233
1234 =item How do I pack arrays of doubles or floats for XS code?
1235
1236 =back
1237
1238 =item AUTHOR AND COPYRIGHT
1239
1240 =back
1241
1242 =head2 perlfaq5 - Files and Formats ($Revision: 1.35 $, $Date: 2005/01/21
1243 12:26:11 $)
1244
1245 =over 4
1246
1247 =item DESCRIPTION
1248
1249 =over 4
1250
1251 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
1252
1253 =item How do I change one line in a file/delete a line in a file/insert a
1254 line in the middle of a file/append to the beginning of a file?
1255
1256 =item How do I count the number of lines in a file?
1257
1258 =item How can I use Perl's C<-i> option from within a program?
1259
1260 =item How can I copy a file?
1261
1262 =item How do I make a temporary file name?
1263
1264 =item How can I manipulate fixed-record-length files?
1265
1266 =item How can I make a filehandle local to a subroutine?  How do I pass
1267 filehandles between subroutines?  How do I make an array of filehandles?
1268
1269 =item How can I use a filehandle indirectly?
1270
1271 =item How can I set up a footer format to be used with write()?
1272
1273 =item How can I write() into a string?
1274
1275 =item How can I output my numbers with commas added?
1276
1277 =item How can I translate tildes (~) in a filename?
1278
1279 =item How come when I open a file read-write it wipes it out?
1280
1281 =item Why do I sometimes get an "Argument list too long" when I use
1282 E<lt>*E<gt>?
1283
1284 =item Is there a leak/bug in glob()?
1285
1286 =item How can I open a file with a leading ">" or trailing blanks?
1287
1288 =item How can I reliably rename a file?
1289
1290 =item How can I lock a file?
1291
1292 =item Why can't I just open(FH, "E<gt>file.lock")?
1293
1294 =item I still don't get locking.  I just want to increment the number in
1295 the file.  How can I do this?
1296
1297 =item All I want to do is append a small amount of text to the end of a
1298 file.  Do I still have to use locking?
1299
1300 =item How do I randomly update a binary file?
1301
1302 =item How do I get a file's timestamp in perl?
1303
1304 =item How do I set a file's timestamp in perl?
1305
1306 =item How do I print to more than one file at once?
1307
1308 =item How can I read in an entire file all at once?
1309
1310 =item How can I read in a file by paragraphs?
1311
1312 =item How can I read a single character from a file?  From the keyboard?
1313
1314 =item How can I tell whether there's a character waiting on a filehandle?
1315
1316 =item How do I do a C<tail -f> in perl?
1317
1318 =item How do I dup() a filehandle in Perl?
1319
1320 =item How do I close a file descriptor by number?
1321
1322 =item Why can't I use "C:\temp\foo" in DOS paths?  Why doesn't
1323 `C:\temp\foo.exe` work?
1324
1325 =item Why doesn't glob("*.*") get all the files?
1326
1327 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
1328 protected files?  Isn't this a bug in Perl?
1329
1330 =item How do I select a random line from a file?
1331
1332 =item Why do I get weird spaces when I print an array of lines?
1333
1334 =back
1335
1336 =item AUTHOR AND COPYRIGHT
1337
1338 =back
1339
1340 =head2 perlfaq6 - Regular Expressions ($Revision: 1.31 $, $Date: 2005/03/27
1341 07:17:28 $)
1342
1343 =over 4
1344
1345 =item DESCRIPTION
1346
1347 =over 4
1348
1349 =item How can I hope to use regular expressions without creating illegible
1350 and unmaintainable code?
1351
1352 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
1353
1354 =item I'm having trouble matching over more than one line.  What's wrong?
1355
1356 =item How can I pull out lines between two patterns that are themselves on
1357 different lines?
1358
1359 =item I put a regular expression into $/ but it didn't work. What's wrong?
1360
1361 =item How do I substitute case insensitively on the LHS while preserving
1362 case on the RHS?
1363
1364 =item How can I make C<\w> match national character sets?
1365
1366 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
1367
1368 =item How can I quote a variable to use in a regex?
1369
1370 =item What is C</o> really for?
1371
1372 =item How do I use a regular expression to strip C style comments from a
1373 file?
1374
1375 =item Can I use Perl regular expressions to match balanced text?
1376
1377 =item What does it mean that regexes are greedy?  How can I get around it?
1378
1379 =item How do I process each word on each line?
1380
1381 =item How can I print out a word-frequency or line-frequency summary?
1382
1383 =item How can I do approximate matching?
1384
1385 =item How do I efficiently match many regular expressions at once?
1386
1387 =item Why don't word-boundary searches with C<\b> work for me?
1388
1389 =item Why does using $&, $`, or $' slow my program down?
1390
1391 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
1392
1393 =item What's wrong with using grep in a void context?
1394
1395 =item How can I match strings with multibyte characters?
1396
1397 =item How do I match a pattern that is supplied by the user?
1398
1399 =back
1400
1401 =item AUTHOR AND COPYRIGHT
1402
1403 =back
1404
1405 =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.22 $, $Date:
1406 2005/03/27 07:19:01 $)
1407
1408 =over 4
1409
1410 =item DESCRIPTION
1411
1412 =over 4
1413
1414 =item Can I get a BNF/yacc/RE for the Perl language?
1415
1416 =item What are all these $@%&* punctuation signs, and how do I know when to
1417 use them?
1418
1419 =item Do I always/never have to quote my strings or use semicolons and
1420 commas?
1421
1422 =item How do I skip some return values?
1423
1424 =item How do I temporarily block warnings?
1425
1426 =item What's an extension?
1427
1428 =item Why do Perl operators have different precedence than C operators?
1429
1430 =item How do I declare/create a structure?
1431
1432 =item How do I create a module?
1433
1434 =item How do I create a class?
1435
1436 =item How can I tell if a variable is tainted?
1437
1438 =item What's a closure?
1439
1440 =item What is variable suicide and how can I prevent it?
1441
1442 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
1443 Regex}?
1444
1445 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
1446 Passing Methods
1447
1448 =item How do I create a static variable?
1449
1450 =item What's the difference between dynamic and lexical (static) scoping? 
1451 Between local() and my()?
1452
1453 =item How can I access a dynamic variable while a similarly named lexical
1454 is in scope?
1455
1456 =item What's the difference between deep and shallow binding?
1457
1458 =item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?
1459
1460 =item How do I redefine a builtin function, operator, or method?
1461
1462 =item What's the difference between calling a function as &foo and foo()?
1463
1464 =item How do I create a switch or case statement?
1465
1466 =item How can I catch accesses to undefined variables, functions, or
1467 methods?
1468
1469 =item Why can't a method included in this same file be found?
1470
1471 =item How can I find out my current package?
1472
1473 =item How can I comment out a large block of perl code?
1474
1475 =item How do I clear a package?
1476
1477 =item How can I use a variable as a variable name?
1478
1479 =item What does "bad interpreter" mean?
1480
1481 =back
1482
1483 =item AUTHOR AND COPYRIGHT
1484
1485 =back
1486
1487 =head2 perlfaq8 - System Interaction ($Revision: 1.23 $, $Date: 2005/01/03
1488 18:43:37 $)
1489
1490 =over 4
1491
1492 =item DESCRIPTION
1493
1494 =over 4
1495
1496 =item How do I find out which operating system I'm running under?
1497
1498 =item How come exec() doesn't return?
1499
1500 =item How do I do fancy stuff with the keyboard/screen/mouse?
1501
1502 Keyboard, Screen, Mouse
1503
1504 =item How do I print something out in color?
1505
1506 =item How do I read just one key without waiting for a return key?
1507
1508 =item How do I check whether input is ready on the keyboard?
1509
1510 =item How do I clear the screen?
1511
1512 =item How do I get the screen size?
1513
1514 =item How do I ask the user for a password?
1515
1516 =item How do I read and write the serial port?
1517
1518 lockfiles, open mode, end of line, flushing output, non-blocking input
1519
1520 =item How do I decode encrypted password files?
1521
1522 =item How do I start a process in the background?
1523
1524 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
1525
1526 =item How do I trap control characters/signals?
1527
1528 =item How do I modify the shadow password file on a Unix system?
1529
1530 =item How do I set the time and date?
1531
1532 =item How can I sleep() or alarm() for under a second?
1533
1534 =item How can I measure time under a second?
1535
1536 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
1537
1538 =item Why doesn't my sockets program work under System V (Solaris)?  What
1539 does the error message "Protocol not supported" mean?
1540
1541 =item How can I call my system's unique C functions from Perl?
1542
1543 =item Where do I get the include files to do ioctl() or syscall()?
1544
1545 =item Why do setuid perl scripts complain about kernel problems?
1546
1547 =item How can I open a pipe both to and from a command?
1548
1549 =item Why can't I get the output of a command with system()?
1550
1551 =item How can I capture STDERR from an external command?
1552
1553 =item Why doesn't open() return an error when a pipe open fails?
1554
1555 =item What's wrong with using backticks in a void context?
1556
1557 =item How can I call backticks without shell processing?
1558
1559 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
1560 ^Z on MS-DOS)?
1561
1562 =item How can I convert my shell script to perl?
1563
1564 =item Can I use perl to run a telnet or ftp session?
1565
1566 =item How can I write expect in Perl?
1567
1568 =item Is there a way to hide perl's command line from programs such as
1569 "ps"?
1570
1571 =item I {changed directory, modified my environment} in a perl script.  How
1572 come the change disappeared when I exited the script?  How do I get my
1573 changes to be visible?
1574
1575 Unix
1576
1577 =item How do I close a process's filehandle without waiting for it to
1578 complete?
1579
1580 =item How do I fork a daemon process?
1581
1582 =item How do I find out if I'm running interactively or not?
1583
1584 =item How do I timeout a slow event?
1585
1586 =item How do I set CPU limits?
1587
1588 =item How do I avoid zombies on a Unix system?
1589
1590 =item How do I use an SQL database?
1591
1592 =item How do I make a system() exit on control-C?
1593
1594 =item How do I open a file without blocking?
1595
1596 =item How do I tell the difference between errors from the shell and perl?
1597
1598 =item How do I install a module from CPAN?
1599
1600 =item What's the difference between require and use?
1601
1602 =item How do I keep my own module/library directory?
1603
1604 =item How do I add the directory my program lives in to the module/library
1605 search path?
1606
1607 =item How do I add a directory to my include path (@INC) at runtime?
1608
1609 =item What is socket.ph and where do I get it?
1610
1611 =back
1612
1613 =item AUTHOR AND COPYRIGHT
1614
1615 =back
1616
1617 =head2 perlfaq9 - Networking ($Revision: 1.19 $, $Date: 2005/01/21 12:14:12
1618 $)
1619
1620 =over 4
1621
1622 =item DESCRIPTION
1623
1624 =over 4
1625
1626 =item What is the correct form of response from a CGI script?
1627
1628 =item My CGI script runs from the command line but not the browser.  (500
1629 Server Error)
1630
1631 =item How can I get better error messages from a CGI program?
1632
1633 =item How do I remove HTML from a string?
1634
1635 =item How do I extract URLs?
1636
1637 =item How do I download a file from the user's machine?  How do I open a
1638 file on another machine?
1639
1640 =item How do I make a pop-up menu in HTML?
1641
1642 =item How do I fetch an HTML file?
1643
1644 =item How do I automate an HTML form submission?
1645
1646 =item How do I decode or create those %-encodings on the web?
1647
1648 =item How do I redirect to another page?
1649
1650 =item How do I put a password on my web pages?
1651
1652 =item How do I edit my .htpasswd and .htgroup files with Perl?
1653
1654 =item How do I make sure users can't enter values into a form that cause my
1655 CGI script to do bad things?
1656
1657 =item How do I parse a mail header?
1658
1659 =item How do I decode a CGI form?
1660
1661 =item How do I check a valid mail address?
1662
1663 =item How do I decode a MIME/BASE64 string?
1664
1665 =item How do I return the user's mail address?
1666
1667 =item How do I send mail?
1668
1669 =item How do I use MIME to make an attachment to a mail message?
1670
1671 =item How do I read mail?
1672
1673 =item How do I find out my hostname/domainname/IP address?
1674
1675 =item How do I fetch a news article or the active newsgroups?
1676
1677 =item How do I fetch/put an FTP file?
1678
1679 =item How can I do RPC in Perl?
1680
1681 =back
1682
1683 =item AUTHOR AND COPYRIGHT
1684
1685 =back
1686
1687 =head2 perlsyn - Perl syntax
1688
1689 =over 4
1690
1691 =item DESCRIPTION
1692
1693 =over 4
1694
1695 =item Declarations
1696
1697 =item Comments
1698
1699 =item Simple Statements
1700
1701 =item Truth and Falsehood
1702
1703 =item Statement Modifiers
1704
1705 =item Compound Statements
1706
1707 =item Loop Control
1708
1709 =item For Loops
1710
1711 =item Foreach Loops
1712
1713 =item Basic BLOCKs and Switch Statements
1714
1715 =item Goto
1716
1717 =item PODs: Embedded Documentation
1718
1719 =item Plain Old Comments (Not!)
1720
1721 =back
1722
1723 =back
1724
1725 =head2 perldata - Perl data types
1726
1727 =over 4
1728
1729 =item DESCRIPTION
1730
1731 =over 4
1732
1733 =item Variable names
1734
1735 =item Context
1736
1737 =item Scalar values
1738
1739 =item Scalar value constructors
1740
1741 =item List value constructors
1742
1743 =item Subscripts
1744
1745 =item Slices
1746
1747 =item Typeglobs and Filehandles
1748
1749 =back
1750
1751 =item SEE ALSO
1752
1753 =back
1754
1755 =head2 perlop - Perl operators and precedence
1756
1757 =over 4
1758
1759 =item DESCRIPTION
1760
1761 =over 4
1762
1763 =item Operator Precedence and Associativity
1764
1765 =item Terms and List Operators (Leftward)
1766
1767 =item The Arrow Operator
1768
1769 =item Auto-increment and Auto-decrement
1770
1771 =item Exponentiation
1772
1773 =item Symbolic Unary Operators
1774
1775 =item Binding Operators
1776
1777 =item Multiplicative Operators
1778
1779 =item Additive Operators
1780
1781 =item Shift Operators
1782
1783 =item Named Unary Operators
1784
1785 =item Relational Operators
1786
1787 =item Equality Operators
1788
1789 =item Bitwise And
1790
1791 =item Bitwise Or and Exclusive Or
1792
1793 =item C-style Logical And
1794
1795 =item C-style Logical Or
1796
1797 =item C-style Logical Defined-Or
1798
1799 =item Range Operators
1800
1801 =item Conditional Operator
1802
1803 =item Assignment Operators
1804
1805 =item Comma Operator
1806
1807 =item List Operators (Rightward)
1808
1809 =item Logical Not
1810
1811 =item Logical And
1812
1813 =item Logical or, Defined or, and Exclusive Or
1814
1815 =item C Operators Missing From Perl
1816
1817 unary &, unary *, (TYPE)
1818
1819 =item Quote and Quote-like Operators
1820
1821 =item Regexp Quote-Like Operators
1822
1823 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
1824 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
1825 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
1826 y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF
1827
1828 =item Gory details of parsing quoted constructs
1829
1830 Finding the end, Removal of backslashes before delimiters, Interpolation,
1831 C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
1832 C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>,
1833 C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
1834 regular expressions
1835
1836 =item I/O Operators
1837
1838 =item Constant Folding
1839
1840 =item No-ops
1841
1842 =item Bitwise String Operators
1843
1844 =item Integer Arithmetic
1845
1846 =item Floating-point Arithmetic
1847
1848 =item Bigger Numbers
1849
1850 =back
1851
1852 =back
1853
1854 =head2 perlsub - Perl subroutines
1855
1856 =over 4
1857
1858 =item SYNOPSIS
1859
1860 =item DESCRIPTION
1861
1862 =over 4
1863
1864 =item Private Variables via my()
1865
1866 =item Persistent Private Variables
1867
1868 =item Temporary Values via local()
1869
1870 =item Lvalue subroutines
1871
1872 Lvalue subroutines are EXPERIMENTAL
1873
1874 =item Passing Symbol Table Entries (typeglobs)
1875
1876 =item When to Still Use local()
1877
1878 =item Pass by Reference
1879
1880 =item Prototypes
1881
1882 =item Constant Functions
1883
1884 =item Overriding Built-in Functions
1885
1886 =item Autoloading
1887
1888 =item Subroutine Attributes
1889
1890 =back
1891
1892 =item SEE ALSO
1893
1894 =back
1895
1896 =head2 perlfunc - Perl builtin functions
1897
1898 =over 4
1899
1900 =item DESCRIPTION
1901
1902 =over 4
1903
1904 =item Perl Functions by Category
1905
1906 Functions for SCALARs or strings, Regular expressions and pattern matching,
1907 Numeric functions, Functions for real @ARRAYs, Functions for list data,
1908 Functions for real %HASHes, Input and output functions, Functions for fixed
1909 length data or records, Functions for filehandles, files, or directories,
1910 Keywords related to the control flow of your perl program, Keywords related
1911 to scoping, Miscellaneous functions, Functions for processes and process
1912 groups, Keywords related to perl modules, Keywords related to classes and
1913 object-orientedness, Low-level socket functions, System V interprocess
1914 communication functions, Fetching user and group info, Fetching network
1915 info, Time-related functions, Functions new in perl5, Functions obsoleted
1916 in perl5
1917
1918 =item Portability
1919
1920 =item Alphabetical Listing of Perl Functions
1921
1922 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, abs VALUE, abs, accept
1923 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
1924 binmode FILEHANDLE, LAYER, binmode FILEHANDLE, bless REF,CLASSNAME, bless
1925 REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE, chomp(
1926 LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr NUMBER,
1927 chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE,
1928 connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT,
1929 dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete
1930 EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump,
1931 each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST,
1932 exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl
1933 FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION,
1934 fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin,
1935 getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam
1936 NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname
1937 NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr
1938 ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
1939 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
1940 getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent
1941 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
1942 endhostent, endnetent, endprotoent, endservent, getsockname SOCKET,
1943 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL,
1944 goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex,
1945 import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
1946 FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST,
1947 last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length,
1948 link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR,
1949 localtime, lock THING, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK
1950 LIST, map EXPR,LIST, mkdir FILENAME,MASK, mkdir FILENAME, msgctl
1951 ID,CMD,ARG, msgget KEY,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd
1952 ID,MSG,FLAGS, my EXPR, my TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS,
1953 next LABEL, next, no Module VERSION LIST, no Module VERSION, no Module
1954 LIST, no Module, oct EXPR, oct, open FILEHANDLE,EXPR, open
1955 FILEHANDLE,MODE,EXPR, open FILEHANDLE,MODE,EXPR,LIST, open
1956 FILEHANDLE,MODE,REFERENCE, open FILEHANDLE, opendir DIRHANDLE,EXPR, ord
1957 EXPR, ord, our EXPR, our EXPR TYPE, our EXPR : ATTRS, our TYPE EXPR :
1958 ATTRS, pack TEMPLATE,LIST, package NAMESPACE, package, pipe
1959 READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos, print FILEHANDLE
1960 LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST, printf FORMAT,
1961 LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/, qq/STRING/,
1962 qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta, rand EXPR,
1963 rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read FILEHANDLE,SCALAR,LENGTH,
1964 readdir DIRHANDLE, readline EXPR, readlink EXPR, readlink, readpipe EXPR,
1965 recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo, ref EXPR, ref, rename
1966 OLDNAME,NEWNAME, require VERSION, require EXPR, require, reset EXPR, reset,
1967 return EXPR, return, reverse LIST, rewinddir DIRHANDLE, rindex
1968 STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME, rmdir, s///, scalar
1969 EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir DIRHANDLE,POS, select
1970 FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT, semctl
1971 ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
1972 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
1973 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
1974 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
1975 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
1976 EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
1977 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
1978 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
1979 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split
1980 /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, format
1981 parameter index, flags, vector flag, (minimum) width, precision, or maximum
1982 width, size, order of arguments, sqrt EXPR, sqrt, srand EXPR, srand, stat
1983 FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub NAME BLOCK, sub NAME
1984 (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK,
1985 substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
1986 EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall NUMBER, LIST, sysopen
1987 FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
1988 FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
1989 FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite
1990 FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH,
1991 syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie
1992 VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate
1993 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR,
1994 ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack
1995 TEMPLATE,EXPR, unpack TEMPLATE, untie VARIABLE, unshift ARRAY,LIST, use
1996 Module VERSION LIST, use Module VERSION, use Module LIST, use Module, use
1997 VERSION, utime LIST, values HASH, vec EXPR,OFFSET,BITS, wait, waitpid
1998 PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y///
1999
2000 =back
2001
2002 =back
2003
2004 =head2 perlopentut - tutorial on opening things in Perl
2005
2006 =over 4
2007
2008 =item DESCRIPTION
2009
2010 =item Open E<agrave> la shell
2011
2012 =over 4
2013
2014 =item Simple Opens
2015
2016 =item Indirect Filehandles
2017
2018 =item Pipe Opens
2019
2020 =item The Minus File
2021
2022 =item Mixing Reads and Writes
2023
2024 =item Filters 
2025
2026 =back
2027
2028 =item Open E<agrave> la C
2029
2030 =over 4
2031
2032 =item Permissions E<agrave> la mode
2033
2034 =back
2035
2036 =item Obscure Open Tricks
2037
2038 =over 4
2039
2040 =item Re-Opening Files (dups)
2041
2042 =item Dispelling the Dweomer
2043
2044 =item Paths as Opens
2045
2046 =item Single Argument Open
2047
2048 =item Playing with STDIN and STDOUT
2049
2050 =back
2051
2052 =item Other I/O Issues
2053
2054 =over 4
2055
2056 =item Opening Non-File Files
2057
2058 =item Opening Named Pipes
2059
2060 =item Opening Sockets
2061
2062 =item Binary Files
2063
2064 =item File Locking
2065
2066 =item IO Layers
2067
2068 =back
2069
2070 =item SEE ALSO 
2071
2072 =item AUTHOR and COPYRIGHT
2073
2074 =item HISTORY
2075
2076 =back
2077
2078 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
2079
2080 =over 4
2081
2082 =item DESCRIPTION
2083
2084 =item The Basic Principle
2085
2086 =item Packing Text
2087
2088 =item Packing Numbers
2089
2090 =over 4
2091
2092 =item Integers
2093
2094 =item Unpacking a Stack Frame
2095
2096 =item How to Eat an Egg on a Net
2097
2098 =item Byte-order modifiers
2099
2100 =item Floating point Numbers
2101
2102 =back
2103
2104 =item Exotic Templates
2105
2106 =over 4
2107
2108 =item Bit Strings
2109
2110 =item Uuencoding
2111
2112 =item Doing Sums
2113
2114 =item  Unicode
2115
2116 =item Another Portable Binary Encoding
2117
2118 =back
2119
2120 =item Template Grouping
2121
2122 =item Lengths and Widths
2123
2124 =over 4
2125
2126 =item String Lengths
2127
2128 =item Dynamic Templates
2129
2130 =item Counting Repetitions
2131
2132 =back
2133
2134 =item Packing and Unpacking C Structures
2135
2136 =over 4
2137
2138 =item The Alignment Pit
2139
2140 =item Dealing with Endian-ness
2141
2142 =item Alignment, Take 2
2143
2144 =item Alignment, Take 3
2145
2146 =item Pointers for How to Use Them
2147
2148 =back
2149
2150 =item Pack Recipes
2151
2152 =item Funnies Section
2153
2154 =item Authors
2155
2156 =back
2157
2158 =head2 perlpod - the Plain Old Documentation format
2159
2160 =over 4
2161
2162 =item DESCRIPTION
2163
2164 =over 4
2165
2166 =item Ordinary Paragraph
2167
2168 =item Verbatim Paragraph
2169
2170 =item Command Paragraph
2171
2172 C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
2173 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item
2174 I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end
2175 I<formatname>>, C<=for I<formatname> I<text...>>, C<=encoding
2176 I<encodingname>>
2177
2178 =item Formatting Codes
2179
2180 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2181 C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink,
2182 C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used
2183 for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces,
2184 C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null
2185 (zero-effect) formatting code
2186
2187 =item The Intent
2188
2189 =item Embedding Pods in Perl Modules
2190
2191 =item Hints for Writing Pod
2192
2193 =back
2194
2195 =item SEE ALSO
2196
2197 =item AUTHOR
2198
2199 =back
2200
2201 =head2 perlpodspec - Plain Old Documentation: format specification and
2202 notes
2203
2204 =over 4
2205
2206 =item DESCRIPTION
2207
2208 =item Pod Definitions
2209
2210 =item Pod Commands
2211
2212 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
2213 "=back", "=begin formatname", "=end formatname", "=for formatname text...",
2214 "=encoding encodingname"
2215
2216 =item Pod Formatting Codes
2217
2218 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2219 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
2220 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
2221 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
2222 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
2223 contains non-breaking spaces
2224
2225 =item Notes on Implementing Pod Processors
2226
2227 =item About LE<lt>...E<gt> Codes
2228
2229 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
2230
2231 =item About =over...=back Regions
2232
2233 =item About Data Paragraphs and "=begin/=end" Regions
2234
2235 =item SEE ALSO
2236
2237 =item AUTHOR
2238
2239 =back
2240
2241 =head2 perlrun - how to execute the Perl interpreter
2242
2243 =over 4
2244
2245 =item SYNOPSIS
2246
2247 =item DESCRIPTION
2248
2249 =over 4
2250
2251 =item #! and quoting on non-Unix systems
2252
2253 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
2254
2255 =item Location of Perl
2256
2257 =item Command Switches
2258
2259 B<-0>[I<octal/hexadecimal>], B<-A [I<assertions>]>, B<-a>, B<-C
2260 [I<number/list>]>, B<-c>, B<-d>, B<-dt>, B<-d:>I<foo[=bar,baz]>,
2261 B<-dt:>I<foo[=bar,baz]>, B<-D>I<letters>, B<-D>I<number>, B<-e>
2262 I<commandline>, B<-f>, B<-F>I<pattern>, B<-h>, B<-i>[I<extension>],
2263 B<-I>I<directory>, B<-l>[I<octnum>], B<-m>[B<->]I<module>,
2264 B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
2265 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
2266 B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<configvar>, B<-w>, B<-W>,
2267 B<-X>, B<-x>, B<-x> I<directory>
2268
2269 =back
2270
2271 =item ENVIRONMENT
2272
2273 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
2274 :perlio, :pop, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
2275 PERL5DB, PERL5DB_THREADED, PERL5SHELL (specific to the Win32 port),
2276 PERL_ALLOW_NON_IFS_LSP (specific to the Win32 port), PERL_DEBUG_MSTATS,
2277 PERL_DESTRUCT_LEVEL, PERL_DL_NONLAZY, PERL_ENCODING, PERL_HASH_SEED,
2278 PERL_HASH_SEED_DEBUG, PERL_ROOT (specific to the VMS port), PERL_SIGNALS,
2279 PERL_UNICODE, SYS$LOGIN (specific to the VMS port)
2280
2281 =back
2282
2283 =head2 perldiag - various Perl diagnostics
2284
2285 =over 4
2286
2287 =item DESCRIPTION
2288
2289 =back
2290
2291 =head2 perllexwarn - Perl Lexical Warnings
2292
2293 =over 4
2294
2295 =item DESCRIPTION
2296
2297 =over 4
2298
2299 =item Default Warnings and Optional Warnings
2300
2301 =item What's wrong with B<-w> and C<$^W>
2302
2303 =item Controlling Warnings from the Command Line
2304
2305 B<-w>, B<-W>, B<-X>
2306
2307 =item Backward Compatibility
2308
2309 =item Category Hierarchy
2310
2311 =item Fatal Warnings
2312
2313 =item Reporting Warnings from a Module
2314
2315 =back
2316
2317 =item TODO
2318
2319 =item SEE ALSO
2320
2321 =item AUTHOR
2322
2323 =back
2324
2325 =head2 perldebug - Perl debugging
2326
2327 =over 4
2328
2329 =item DESCRIPTION
2330
2331 =item The Perl Debugger
2332
2333 =over 4
2334
2335 =item Debugger Commands
2336
2337 h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y
2338 [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l
2339 min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/,
2340 ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b
2341 subname [condition], b postpone subname [condition], b load filename, b
2342 compile subname, B line, B *, a [line] command, A line, A *, w expr, W
2343 expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [
2344 command ], < *, << command, > ?, > command, > *, >> command, { ?, { [
2345 command ], { *, {{ command, ! number, ! -number, ! pattern, !! cmd, source
2346 file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man
2347 [manpage]
2348
2349 =item Configurable Options
2350
2351 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
2352 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
2353 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
2354 C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
2355 C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
2356 C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
2357 C<NonStop>
2358
2359 =item Debugger input/output
2360
2361 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
2362 listing
2363
2364 =item Debugging compile-time statements
2365
2366 =item Debugger Customization
2367
2368 =item Readline Support
2369
2370 =item Editor Support for Debugging
2371
2372 =item The Perl Profiler
2373
2374 =back
2375
2376 =item Debugging regular expressions
2377
2378 =item Debugging memory usage
2379
2380 =item SEE ALSO
2381
2382 =item BUGS
2383
2384 =back
2385
2386 =head2 perlvar - Perl predefined variables
2387
2388 =over 4
2389
2390 =item DESCRIPTION
2391
2392 =over 4
2393
2394 =item Predefined Names
2395
2396 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
2397 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+,
2398 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
2399 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
2400 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
2401 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
2402 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
2403 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $#,
2404 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
2405 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
2406 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
2407 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
2408 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
2409 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
2410 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
2411 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
2412 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
2413 IO::Handle->format_line_break_characters EXPR,
2414 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
2415 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
2416 $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
2417 $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
2418 $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
2419 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
2420 ${^RE_DEBUG_FLAGS}, ${^RE_TRIE_MAXBUF}, $SYSTEM_FD_MAX, $^F, $^H, %^H,
2421 $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O, ${^OPEN}, $PERLDB, $^P, 0x01, 0x02,
2422 0x04, 0x08, 0x10, 0x20, 0x40, 0x80, 0x100, 0x200, 0x400,
2423 $LAST_REGEXP_CODE_RESULT, $^R, $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME,
2424 $^T, ${^TAINT}, ${^UNICODE}, $PERL_VERSION, $^V, $WARNING, $^W,
2425 ${^WARNING_BITS}, $EXECUTABLE_NAME, $^X, ARGV, $ARGV, @ARGV, ARGVOUT, @F,
2426 @INC, @_, %INC, %ENV, $ENV{expr}, %SIG, $SIG{expr}
2427
2428 =item Error Indicators
2429
2430 =item Technical Note on the Syntax of Variable Names
2431
2432 =back
2433
2434 =item BUGS
2435
2436 =back
2437
2438 =head2 perlre - Perl regular expressions
2439
2440 =over 4
2441
2442 =item DESCRIPTION
2443
2444 i, m, s, x
2445
2446 =over 4
2447
2448 =item Regular Expressions
2449
2450 [1], [2], [3], cntrl, graph, print, punct, xdigit
2451
2452 =item Extended Patterns
2453
2454 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
2455 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
2456 code })>, C<(??{ code })>, C<< (?>pattern) >>,
2457 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
2458
2459 =item Backtracking
2460
2461 =item Version 8 Regular Expressions
2462
2463 =item Warning on \1 vs $1
2464
2465 =item Repeated patterns matching zero-length substring
2466
2467 =item Combining pieces together
2468
2469 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
2470 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
2471 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
2472 C<(?(condition)yes-pattern|no-pattern)>
2473
2474 =item Creating custom RE engines
2475
2476 =back
2477
2478 =item BUGS
2479
2480 =item SEE ALSO
2481
2482 =back
2483
2484 =head2 perlreref - Perl Regular Expressions Reference
2485
2486 =over 4
2487
2488 =item DESCRIPTION
2489
2490 =over 4
2491
2492 =item OPERATORS
2493
2494 =item SYNTAX
2495
2496 =item ESCAPE SEQUENCES
2497
2498 =item CHARACTER CLASSES
2499
2500 =item ANCHORS
2501
2502 =item QUANTIFIERS
2503
2504 =item EXTENDED CONSTRUCTS
2505
2506 =item VARIABLES
2507
2508 =item FUNCTIONS
2509
2510 =item TERMINOLOGY
2511
2512 =back
2513
2514 =item AUTHOR
2515
2516 =item SEE ALSO
2517
2518 =item THANKS
2519
2520 =back
2521
2522 =head2 perlref - Perl references and nested data structures
2523
2524 =over 4
2525
2526 =item NOTE
2527
2528 =item DESCRIPTION
2529
2530 =over 4
2531
2532 =item Making References
2533
2534 =item Using References
2535
2536 =item Symbolic references
2537
2538 =item Not-so-symbolic references
2539
2540 =item Pseudo-hashes: Using an array as a hash
2541
2542 =item Function Templates
2543
2544 =back
2545
2546 =item WARNING
2547
2548 =item SEE ALSO
2549
2550 =back
2551
2552 =head2 perlform - Perl formats
2553
2554 =over 4
2555
2556 =item DESCRIPTION
2557
2558 =over 4
2559
2560 =item Text Fields
2561
2562 =item Numeric Fields
2563
2564 =item The Field @* for Variable Width Multi-Line Text
2565
2566 =item The Field ^* for Variable Width One-line-at-a-time Text
2567
2568 =item Specifying Values
2569
2570 =item Using Fill Mode
2571
2572 =item Suppressing Lines Where All Fields Are Void
2573
2574 =item Repeating Format Lines
2575
2576 =item Top of Form Processing
2577
2578 =item Format Variables
2579
2580 =back
2581
2582 =item NOTES
2583
2584 =over 4
2585
2586 =item Footers
2587
2588 =item Accessing Formatting Internals
2589
2590 =back
2591
2592 =item WARNINGS
2593
2594 =back
2595
2596 =head2 perlobj - Perl objects
2597
2598 =over 4
2599
2600 =item DESCRIPTION
2601
2602 =over 4
2603
2604 =item An Object is Simply a Reference
2605
2606 =item A Class is Simply a Package
2607
2608 =item A Method is Simply a Subroutine
2609
2610 =item Method Invocation
2611
2612 =item Indirect Object Syntax
2613
2614 =item Default UNIVERSAL methods
2615
2616 isa(CLASS), can(METHOD), VERSION( [NEED] )
2617
2618 =item Destructors
2619
2620 =item Summary
2621
2622 =item Two-Phased Garbage Collection
2623
2624 =back
2625
2626 =item SEE ALSO
2627
2628 =back
2629
2630 =head2 perltie - how to hide an object class in a simple variable
2631
2632 =over 4
2633
2634 =item SYNOPSIS
2635
2636 =item DESCRIPTION
2637
2638 =over 4
2639
2640 =item Tying Scalars
2641
2642 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
2643 DESTROY this
2644
2645 =item Tying Arrays
2646
2647 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
2648 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
2649 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
2650 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
2651 this
2652
2653 =item Tying Hashes
2654
2655 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
2656 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
2657 this, NEXTKEY this, lastkey, SCALAR this, UNTIE this, DESTROY this
2658
2659 =item Tying FileHandles
2660
2661 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
2662 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
2663 DESTROY this
2664
2665 =item UNTIE this
2666
2667 =item The C<untie> Gotcha
2668
2669 =back
2670
2671 =item SEE ALSO
2672
2673 =item BUGS
2674
2675 =item AUTHOR
2676
2677 =back
2678
2679 =head2 perldbmfilter - Perl DBM Filters
2680
2681 =over 4
2682
2683 =item SYNOPSIS
2684
2685 =item DESCRIPTION
2686
2687 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
2688 B<filter_fetch_value>
2689
2690 =over 4
2691
2692 =item The Filter
2693
2694 =item An Example -- the NULL termination problem.
2695
2696 =item Another Example -- Key is a C int.
2697
2698 =back
2699
2700 =item SEE ALSO
2701
2702 =item AUTHOR
2703
2704 =back
2705
2706 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
2707 safe subprocesses, sockets, and semaphores)
2708
2709 =over 4
2710
2711 =item DESCRIPTION
2712
2713 =item Signals
2714
2715 =over 4
2716
2717 =item Handling the SIGHUP Signal in Daemons
2718
2719 =back
2720
2721 =item Named Pipes
2722
2723 =over 4
2724
2725 =item Deferred Signals (Safe Signals)
2726
2727 Long running opcodes, Interrupting IO, Restartable system calls, Signals as
2728 "faults", Signals triggered by operating system state
2729
2730 =back
2731
2732 =item Using open() for IPC
2733
2734 =over 4
2735
2736 =item Filehandles
2737
2738 =item Background Processes
2739
2740 =item Complete Dissociation of Child from Parent
2741
2742 =item Safe Pipe Opens
2743
2744 =item Bidirectional Communication with Another Process
2745
2746 =item Bidirectional Communication with Yourself
2747
2748 =back
2749
2750 =item Sockets: Client/Server Communication
2751
2752 =over 4
2753
2754 =item Internet Line Terminators
2755
2756 =item Internet TCP Clients and Servers
2757
2758 =item Unix-Domain TCP Clients and Servers
2759
2760 =back
2761
2762 =item TCP Clients with IO::Socket
2763
2764 =over 4
2765
2766 =item A Simple Client
2767
2768 C<Proto>, C<PeerAddr>, C<PeerPort>
2769
2770 =item A Webget Client
2771
2772 =item Interactive Client with IO::Socket
2773
2774 =back
2775
2776 =item TCP Servers with IO::Socket
2777
2778 Proto, LocalPort, Listen, Reuse
2779
2780 =item UDP: Message Passing
2781
2782 =item SysV IPC
2783
2784 =item NOTES
2785
2786 =item BUGS
2787
2788 =item AUTHOR
2789
2790 =item SEE ALSO
2791
2792 =back
2793
2794 =head2 perlfork - Perl's fork() emulation
2795
2796 =over 4
2797
2798 =item SYNOPSIS
2799
2800 =item DESCRIPTION
2801
2802 =over 4
2803
2804 =item Behavior of other Perl features in forked pseudo-processes
2805
2806 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
2807 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
2808 files, directories and network sockets
2809
2810 =item Resource limits
2811
2812 =item Killing the parent process
2813
2814 =item Lifetime of the parent process and pseudo-processes
2815
2816 =item CAVEATS AND LIMITATIONS
2817
2818 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
2819 Global state maintained by XSUBs, Interpreter embedded in larger
2820 application, Thread-safety of extensions
2821
2822 =back
2823
2824 =item BUGS
2825
2826 =item AUTHOR
2827
2828 =item SEE ALSO
2829
2830 =back
2831
2832 =head2 perlnumber - semantics of numbers and numeric operations in Perl
2833
2834 =over 4
2835
2836 =item SYNOPSIS
2837
2838 =item DESCRIPTION
2839
2840 =item Storing numbers
2841
2842 =item Numeric operators and numeric conversions
2843
2844 =item Flavors of Perl numeric operations
2845
2846 Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other
2847 mathematical operators, Bitwise operators, Bitwise operators during C<use
2848 integer>, Operators which expect an integer, Operators which expect a
2849 string
2850
2851 =item AUTHOR
2852
2853 =item SEE ALSO
2854
2855 =back
2856
2857 =head2 perlthrtut - tutorial on threads in Perl
2858
2859 =over 4
2860
2861 =item DESCRIPTION
2862
2863 =item Status
2864
2865 =item What Is A Thread Anyway?
2866
2867 =item Threaded Program Models
2868
2869 =over 4
2870
2871 =item Boss/Worker
2872
2873 =item Work Crew
2874
2875 =item Pipeline
2876
2877 =back
2878
2879 =item What kind of threads are Perl threads?
2880
2881 =item Thread-Safe Modules
2882
2883 =item Thread Basics
2884
2885 =over 4
2886
2887 =item Basic Thread Support
2888
2889 =item A Note about the Examples
2890
2891 =item Creating Threads
2892
2893 =item Waiting For A Thread To Exit
2894
2895 =item Ignoring A Thread
2896
2897 =back
2898
2899 =item Threads And Data
2900
2901 =over 4
2902
2903 =item Shared And Unshared Data
2904
2905 =item Thread Pitfalls: Races
2906
2907 =back
2908
2909 =item Synchronization and control
2910
2911 =over 4
2912
2913 =item Controlling access: lock()
2914
2915 =item A Thread Pitfall: Deadlocks
2916
2917 =item Queues: Passing Data Around
2918
2919 =item Semaphores: Synchronizing Data Access
2920
2921 =item Basic semaphores
2922
2923 =item Advanced Semaphores
2924
2925 =item cond_wait() and cond_signal()
2926
2927 =item Giving up control
2928
2929 =back
2930
2931 =item General Thread Utility Routines
2932
2933 =over 4
2934
2935 =item What Thread Am I In?
2936
2937 =item Thread IDs
2938
2939 =item Are These Threads The Same?
2940
2941 =item What Threads Are Running?
2942
2943 =back
2944
2945 =item A Complete Example
2946
2947 =item Different implementations of threads
2948
2949 =item Performance considerations
2950
2951 =item Process-scope Changes
2952
2953 =item Thread-Safety of System Libraries
2954
2955 =item Conclusion
2956
2957 =item Bibliography
2958
2959 =over 4
2960
2961 =item Introductory Texts
2962
2963 =item OS-Related References
2964
2965 =item Other References
2966
2967 =back
2968
2969 =item Acknowledgements
2970
2971 =item AUTHOR
2972
2973 =item Copyrights
2974
2975 =back
2976
2977 =head2 perlothrtut - old tutorial on threads in Perl
2978
2979 =over 4
2980
2981 =item DESCRIPTION
2982
2983 =item What Is A Thread Anyway?
2984
2985 =item Threaded Program Models
2986
2987 =over 4
2988
2989 =item Boss/Worker
2990
2991 =item Work Crew
2992
2993 =item Pipeline
2994
2995 =back
2996
2997 =item Native threads
2998
2999 =item What kind of threads are perl threads?
3000
3001 =item Threadsafe Modules
3002
3003 =item Thread Basics
3004
3005 =over 4
3006
3007 =item Basic Thread Support
3008
3009 =item Creating Threads
3010
3011 =item Giving up control
3012
3013 =item Waiting For A Thread To Exit
3014
3015 =item Errors In Threads
3016
3017 =item Ignoring A Thread
3018
3019 =back
3020
3021 =item Threads And Data
3022
3023 =over 4
3024
3025 =item Shared And Unshared Data
3026
3027 =item Thread Pitfall: Races
3028
3029 =item Controlling access: lock()
3030
3031 =item Thread Pitfall: Deadlocks
3032
3033 =item Queues: Passing Data Around
3034
3035 =back
3036
3037 =item Threads And Code
3038
3039 =over 4
3040
3041 =item Semaphores: Synchronizing Data Access
3042
3043 Basic semaphores, Advanced Semaphores
3044
3045 =item Attributes: Restricting Access To Subroutines
3046
3047 =item Subroutine Locks
3048
3049 =item Methods
3050
3051 =item Locking A Subroutine
3052
3053 =back
3054
3055 =item General Thread Utility Routines
3056
3057 =over 4
3058
3059 =item What Thread Am I In?
3060
3061 =item Thread IDs
3062
3063 =item Are These Threads The Same?
3064
3065 =item What Threads Are Running?
3066
3067 =back
3068
3069 =item A Complete Example
3070
3071 =item Conclusion
3072
3073 =item Bibliography
3074
3075 =over 4
3076
3077 =item Introductory Texts
3078
3079 =item OS-Related References
3080
3081 =item Other References
3082
3083 =back
3084
3085 =item Acknowledgements
3086
3087 =item AUTHOR
3088
3089 =item Copyrights
3090
3091 =back
3092
3093 =head2 perlport - Writing portable Perl
3094
3095 =over 4
3096
3097 =item DESCRIPTION
3098
3099 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
3100 portable
3101
3102 =item ISSUES
3103
3104 =over 4
3105
3106 =item Newlines
3107
3108 =item Numbers endianness and Width
3109
3110 =item Files and Filesystems
3111
3112 =item System Interaction
3113
3114 =item Command names versus file pathnames
3115
3116 =item Networking
3117
3118 =item Interprocess Communication (IPC)
3119
3120 =item External Subroutines (XS)
3121
3122 =item Standard Modules
3123
3124 =item Time and Date
3125
3126 =item Character sets and character encoding
3127
3128 =item Internationalisation
3129
3130 =item System Resources
3131
3132 =item Security
3133
3134 =item Style
3135
3136 =back
3137
3138 =item CPAN Testers
3139
3140 Mailing list: cpan-testers@perl.org, Testing results:
3141 http://testers.cpan.org/
3142
3143 =item PLATFORMS
3144
3145 =over 4
3146
3147 =item Unix
3148
3149 =item DOS and Derivatives
3150
3151 =item S<Mac OS>
3152
3153 =item VMS
3154
3155 =item VOS
3156
3157 =item EBCDIC Platforms
3158
3159 =item Acorn RISC OS
3160
3161 =item Other perls
3162
3163 =back
3164
3165 =item FUNCTION IMPLEMENTATIONS
3166
3167 =over 4
3168
3169 =item Alphabetical Listing of Perl Functions
3170
3171 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, binmode FILEHANDLE, chmod LIST, chown
3172 LIST, chroot FILENAME, chroot, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen
3173 HASH,DBNAME,MODE, dump LABEL, exec LIST, exit EXPR, exit, fcntl
3174 FILEHANDLE,FUNCTION,SCALAR, flock FILEHANDLE,OPERATION, fork, getlogin,
3175 getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME,
3176 getnetbyname NAME, getpwuid UID, getgrgid GID, getnetbyaddr ADDR,ADDRTYPE,
3177 getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, getgrent,
3178 gethostbyname, gethostent, getnetent, getprotoent, getservent, sethostent
3179 STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN,
3180 endpwent, endgrent, endhostent, endnetent, endprotoent, endservent,
3181 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl
3182 FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat
3183 FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd
3184 ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open
3185 FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select
3186 RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
3187 KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
3188 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
3189 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
3190 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
3191 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
3192 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
3193 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
3194 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
3195 wait, waitpid PID,FLAGS
3196
3197 =back
3198
3199 =item CHANGES
3200
3201 v1.49, 12 August 2002, v1.48, 02 February 2001, v1.47, 22 March 2000,
3202 v1.46, 12 February 2000, v1.45, 20 December 1999, v1.44, 19 July 1999,
3203 v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May 1999, v1.40, 11 April
3204 1999, v1.39, 11 February 1999, v1.38, 31 December 1998, v1.37, 19 December
3205 1998, v1.36, 9 September 1998, v1.35, 13 August 1998, v1.33, 06 August
3206 1998, v1.32, 05 August 1998, v1.30, 03 August 1998, v1.23, 10 July 1998
3207
3208 =item Supported Platforms
3209
3210 =item SEE ALSO
3211
3212 =item AUTHORS / CONTRIBUTORS
3213
3214 =back
3215
3216 =head2 perllocale - Perl locale handling (internationalization and
3217 localization)
3218
3219 =over 4
3220
3221 =item DESCRIPTION
3222
3223 =item PREPARING TO USE LOCALES
3224
3225 =item USING LOCALES
3226
3227 =over 4
3228
3229 =item The use locale pragma
3230
3231 =item The setlocale function
3232
3233 =item Finding locales
3234
3235 =item LOCALE PROBLEMS
3236
3237 =item Temporarily fixing locale problems
3238
3239 =item Permanently fixing locale problems
3240
3241 =item Permanently fixing your system's locale configuration
3242
3243 =item Fixing system locale configuration
3244
3245 =item The localeconv function
3246
3247 =item I18N::Langinfo
3248
3249 =back
3250
3251 =item LOCALE CATEGORIES
3252
3253 =over 4
3254
3255 =item Category LC_COLLATE: Collation
3256
3257 =item Category LC_CTYPE: Character Types
3258
3259 =item Category LC_NUMERIC: Numeric Formatting
3260
3261 =item Category LC_MONETARY: Formatting of monetary amounts
3262
3263 =item LC_TIME
3264
3265 =item Other categories
3266
3267 =back
3268
3269 =item SECURITY
3270
3271 =item ENVIRONMENT
3272
3273 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
3274 LC_NUMERIC, LC_TIME, LANG
3275
3276 =item NOTES
3277
3278 =over 4
3279
3280 =item Backward compatibility
3281
3282 =item I18N:Collate obsolete
3283
3284 =item Sort speed and memory use impacts
3285
3286 =item write() and LC_NUMERIC
3287
3288 =item Freely available locale definitions
3289
3290 =item I18n and l10n
3291
3292 =item An imperfect standard
3293
3294 =back
3295
3296 =item Unicode and UTF-8
3297
3298 =item BUGS
3299
3300 =over 4
3301
3302 =item Broken systems
3303
3304 =back
3305
3306 =item SEE ALSO
3307
3308 =item HISTORY
3309
3310 =back
3311
3312 =head2 perluniintro - Perl Unicode introduction
3313
3314 =over 4
3315
3316 =item DESCRIPTION
3317
3318 =over 4
3319
3320 =item Unicode
3321
3322 =item Perl's Unicode Support
3323
3324 =item Perl's Unicode Model
3325
3326 =item Unicode and EBCDIC
3327
3328 =item Creating Unicode
3329
3330 =item Handling Unicode
3331
3332 =item Legacy Encodings
3333
3334 =item Unicode I/O
3335
3336 =item Displaying Unicode As Text
3337
3338 =item Special Cases
3339
3340 =item Advanced Topics
3341
3342 =item Miscellaneous
3343
3344 =item Questions With Answers
3345
3346 =item Hexadecimal Notation
3347
3348 =item Further Resources
3349
3350 =back
3351
3352 =item UNICODE IN OLDER PERLS
3353
3354 =item SEE ALSO
3355
3356 =item ACKNOWLEDGMENTS
3357
3358 =item AUTHOR, COPYRIGHT, AND LICENSE
3359
3360 =back
3361
3362 =head2 perlunicode - Unicode support in Perl
3363
3364 =over 4
3365
3366 =item DESCRIPTION
3367
3368 =over 4
3369
3370 =item Important Caveats
3371
3372 Input and Output Layers, Regular Expressions, C<use utf8> still needed to
3373 enable UTF-8/UTF-EBCDIC in scripts, BOM-marked scripts and UTF-16 scripts
3374 autodetected, C<use encoding> needed to upgrade non-Latin-1 byte strings
3375
3376 =item Byte and Character Semantics
3377
3378 =item Effects of Character Semantics
3379
3380 =item Scripts
3381
3382 =item Blocks
3383
3384 =item User-Defined Character Properties
3385
3386 =item Character Encodings for Input and Output
3387
3388 =item Unicode Regular Expression Support Level
3389
3390 =item Unicode Encodings
3391
3392 =item Security Implications of Unicode
3393
3394 =item Unicode in Perl on EBCDIC
3395
3396 =item Locales
3397
3398 =item When Unicode Does Not Happen
3399
3400 =item Forcing Unicode in Perl (Or Unforcing Unicode in Perl)
3401
3402 =item Using Unicode in XS
3403
3404 =back
3405
3406 =item BUGS
3407
3408 =over 4
3409
3410 =item Interaction with Locales
3411
3412 =item Interaction with Extensions
3413
3414 =item Speed
3415
3416 =item Porting code from perl-5.6.X
3417
3418 =back
3419
3420 =item SEE ALSO
3421
3422 =back
3423
3424 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
3425
3426 =over 4
3427
3428 =item DESCRIPTION
3429
3430 =item COMMON CHARACTER CODE SETS
3431
3432 =over 4
3433
3434 =item ASCII
3435
3436 =item ISO 8859
3437
3438 =item Latin 1 (ISO 8859-1)
3439
3440 =item EBCDIC
3441
3442 =item 13 variant characters
3443
3444 =item 0037
3445
3446 =item 1047
3447
3448 =item POSIX-BC
3449
3450 =item Unicode code points versus EBCDIC code points
3451
3452 =item Remaining Perl Unicode problems in EBCDIC
3453
3454 =item Unicode and UTF
3455
3456 =item Using Encode
3457
3458 =back
3459
3460 =item SINGLE OCTET TABLES
3461
3462 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
3463
3464 =item IDENTIFYING CHARACTER CODE SETS
3465
3466 =item CONVERSIONS
3467
3468 =over 4
3469
3470 =item tr///
3471
3472 =item iconv
3473
3474 =item C RTL
3475
3476 =back
3477
3478 =item OPERATOR DIFFERENCES
3479
3480 =item FUNCTION DIFFERENCES
3481
3482 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
3483
3484 =item REGULAR EXPRESSION DIFFERENCES
3485
3486 =item SOCKETS
3487
3488 =item SORTING
3489
3490 =over 4
3491
3492 =item Ignore ASCII vs. EBCDIC sort differences.
3493
3494 =item MONO CASE then sort data.
3495
3496 =item Convert, sort data, then re convert.
3497
3498 =item Perform sorting on one type of machine only.
3499
3500 =back
3501
3502 =item TRANSFORMATION FORMATS
3503
3504 =over 4
3505
3506 =item URL decoding and encoding
3507
3508 =item uu encoding and decoding
3509
3510 =item Quoted-Printable encoding and decoding
3511
3512 =item Caesarian ciphers
3513
3514 =back
3515
3516 =item Hashing order and checksums
3517
3518 =item I18N AND L10N
3519
3520 =item MULTI OCTET CHARACTER SETS
3521
3522 =item OS ISSUES
3523
3524 =over 4
3525
3526 =item OS/400
3527
3528 PASE, IFS access
3529
3530 =item OS/390, z/OS
3531
3532 chcp, dataset access, OS/390, z/OS iconv, locales
3533
3534 =item VM/ESA?
3535
3536 =item POSIX-BC?
3537
3538 =back
3539
3540 =item BUGS
3541
3542 =item SEE ALSO
3543
3544 =item REFERENCES
3545
3546 =item HISTORY
3547
3548 =item AUTHOR
3549
3550 =back
3551
3552 =head2 perlsec - Perl security
3553
3554 =over 4
3555
3556 =item DESCRIPTION
3557
3558 =over 4
3559
3560 =item Laundering and Detecting Tainted Data
3561
3562 =item Switches On the "#!" Line
3563
3564 =item Taint mode and @INC
3565
3566 =item Cleaning Up Your Path
3567
3568 =item Security Bugs
3569
3570 =item Protecting Your Programs
3571
3572 =item Unicode
3573
3574 =item Algorithmic Complexity Attacks
3575
3576 =back
3577
3578 =item SEE ALSO
3579
3580 =back
3581
3582 =head2 perlmod - Perl modules (packages and symbol tables)
3583
3584 =over 4
3585
3586 =item DESCRIPTION
3587
3588 =over 4
3589
3590 =item Packages
3591
3592 =item Symbol Tables
3593
3594 =item BEGIN, CHECK, INIT and END
3595
3596 =item Perl Classes
3597
3598 =item Perl Modules
3599
3600 =item Making your module threadsafe
3601
3602 =back
3603
3604 =item SEE ALSO
3605
3606 =back
3607
3608 =head2 perlmodlib - constructing new Perl modules and finding existing ones
3609
3610 =over 4
3611
3612 =item THE PERL MODULE LIBRARY
3613
3614 =over 4
3615
3616 =item Pragmatic Modules
3617
3618 assertions, assertions::activate, attributes, attrs, autouse, base, bigint,
3619 bignum, bigrat, blib, bytes, charnames, constant, diagnostics, encoding,
3620 fields, filetest, if, integer, less, lib, locale, open, ops, overload, re,
3621 sigtrap, sort, strict, subs, threads, threads::shared, utf8, vars, version,
3622 vmsish, warnings, warnings::register
3623
3624 =item Standard Modules
3625
3626 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
3627 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
3628 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
3629 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
3630 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
3631 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
3632 Class::Struct, Config, Cwd, DB, DBM_Filter, DB_File, Data::Dumper,
3633 Devel::DProf, Devel::PPPort, Devel::Peek, Devel::SelfStubber, Digest,
3634 Digest::MD5, Digest::base, DirHandle, Dumpvalue, DynaLoader, Encode,
3635 Encode::Alias, Encode::Byte, Encode::CJKConstants, Encode::CN,
3636 Encode::CN::HZ, Encode::Config, Encode::EBCDIC, Encode::Encoder,
3637 Encode::Encoding, Encode::Guess, Encode::JP, Encode::JP::H2Z,
3638 Encode::JP::JIS7, Encode::KR, Encode::KR::2022_KR, Encode::MIME::Header,
3639 Encode::PerlIO, Encode::Supported, Encode::Symbol, Encode::TW,
3640 Encode::Unicode, Encode::Unicode::UTF7, English, Env, Errno, Exporter,
3641 Exporter::Heavy, ExtUtils::Command, ExtUtils::Command::MM,
3642 ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install,
3643 ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_Any,
3644 ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS,
3645 ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_UWIN,
3646 ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
3647 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker,
3648 ExtUtils::MakeMaker::FAQ, ExtUtils::MakeMaker::Tutorial,
3649 ExtUtils::MakeMaker::bytes, ExtUtils::MakeMaker::vmsish,
3650 ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists,
3651 ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename,
3652 File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find,
3653 File::Glob, File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc,
3654 File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix,
3655 File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache,
3656 FileHandle, Filter::Simple, Filter::Util::Call, FindBin, GDBM_File,
3657 Getopt::Long, Getopt::Std, Hash::Util, I18N::Collate, I18N::LangTags,
3658 I18N::LangTags::List, I18N::Langinfo, IO, IO::Dir, IO::File, IO::Handle,
3659 IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET,
3660 IO::Socket::UNIX, IPC::Open2, IPC::Open3, IPC::SysV, IPC::SysV::Msg,
3661 IPC::SysV::Semaphore, List::Util, Locale::Constants, Locale::Country,
3662 Locale::Currency, Locale::Language, Locale::Maketext,
3663 Locale::Maketext::TPJ13, Locale::Script, MIME::Base64,
3664 MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt,
3665 Math::BigInt::Calc, Math::BigInt::CalcEmu, Math::BigRat, Math::Complex,
3666 Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire,
3667 Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File,
3668 Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT, Net::Cmd,
3669 Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3,
3670 Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent,
3671 Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO,
3672 PerlIO::encoding, PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint,
3673 Pod::Checker, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects,
3674 Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser,
3675 Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff,
3676 Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText,
3677 Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer,
3678 Pod::Select, Pod::Text, Pod::Text::Color, Pod::Text::Overstrike,
3679 Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Scalar::Util,
3680 Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch,
3681 Symbol, Sys::Hostname, Sys::Syslog, Term::ANSIColor, Term::Cap,
3682 Term::Complete, Term::ReadLine, Test, Test::Builder, Test::Harness,
3683 Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Straps,
3684 Test::More, Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced,
3685 Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Thread,
3686 Thread::Queue, Thread::Semaphore, Thread::Signal, Thread::Specific,
3687 Tie::Array, Tie::File, Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash,
3688 Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::gmtime,
3689 Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate, Unicode::Normalize,
3690 Unicode::UCD, User::grent, User::pwent, Win32, XS::APItest, XS::Typemap,
3691 XSLoader
3692
3693 =item Extension Modules
3694
3695 =back
3696
3697 =item CPAN
3698
3699 =over 4
3700
3701 =item Africa
3702
3703 South Africa
3704
3705 =item Asia
3706
3707 China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi
3708 Arabia, Singapore, South Korea, Taiwan, Thailand
3709
3710 =item Central America
3711
3712 Costa Rica
3713
3714 =item Europe
3715
3716 Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Czech
3717 Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary,
3718 Iceland, Ireland, Italy, Latvia, Lithuania, Netherlands, Norway, Poland,
3719 Portugal, Romania, Russia, Slovakia, Slovenia, Spain, Sweden, Switzerland,
3720 Turkey, Ukraine, United Kingdom
3721
3722 =item North America
3723
3724 Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States,
3725 Alabama, California, Colorado, Delaware, District of Columbia, Florida,
3726 Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey, New York,
3727 North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, Utah,
3728 Virginia, Washington, Wisconsin
3729
3730 =item Oceania
3731
3732 Australia, New Zealand, United States
3733
3734 =item South America
3735
3736 Argentina, Brazil, Chile
3737
3738 =item RSYNC Mirrors
3739
3740 =back
3741
3742 =item Modules: Creation, Use, and Abuse
3743
3744 =over 4
3745
3746 =item Guidelines for Module Creation
3747
3748 =item Guidelines for Converting Perl 4 Library Scripts into Modules
3749
3750 =item Guidelines for Reusing Application Code
3751
3752 =back
3753
3754 =item NOTE
3755
3756 =back
3757
3758 =head2 perlmodstyle - Perl module style guide
3759
3760 =over 4
3761
3762 =item INTRODUCTION
3763
3764 =item QUICK CHECKLIST
3765
3766 =over 4
3767
3768 =item Before you start
3769
3770 =item The API
3771
3772 =item Stability
3773
3774 =item Documentation
3775
3776 =item Release considerations
3777
3778 =back
3779
3780 =item BEFORE YOU START WRITING A MODULE
3781
3782 =over 4
3783
3784 =item Has it been done before?
3785
3786 =item Do one thing and do it well
3787
3788 =item What's in a name?
3789
3790 =back
3791
3792 =item DESIGNING AND WRITING YOUR MODULE
3793
3794 =over 4
3795
3796 =item To OO or not to OO?
3797
3798 =item Designing your API
3799
3800 Write simple routines to do simple things, Separate functionality from
3801 output, Provide sensible shortcuts and defaults, Naming conventions,
3802 Parameter passing
3803
3804 =item Strictness and warnings
3805
3806 =item Backwards compatibility
3807
3808 =item Error handling and messages
3809
3810 =back
3811
3812 =item DOCUMENTING YOUR MODULE
3813
3814 =over 4
3815
3816 =item POD
3817
3818 =item README, INSTALL, release notes, changelogs
3819
3820 perl Makefile.PL, make, make test, make install, perl Build.PL, perl Build,
3821 perl Build test, perl Build install
3822
3823 =back
3824
3825 =item RELEASE CONSIDERATIONS
3826
3827 =over 4
3828
3829 =item Version numbering
3830
3831 =item Pre-requisites
3832
3833 =item Testing
3834
3835 =item Packaging
3836
3837 =item Licensing
3838
3839 =back
3840
3841 =item COMMON PITFALLS
3842
3843 =over 4
3844
3845 =item Reinventing the wheel
3846
3847 =item Trying to do too much
3848
3849 =item Inappropriate documentation
3850
3851 =back
3852
3853 =item SEE ALSO
3854
3855 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Packaging Tools,
3856 Testing tools, http://pause.perl.org/, Any good book on software
3857 engineering
3858
3859 =item AUTHOR
3860
3861 =back
3862
3863 =head2 perlmodinstall - Installing CPAN Modules
3864
3865 =over 4
3866
3867 =item DESCRIPTION
3868
3869 =over 4
3870
3871 =item PREAMBLE
3872
3873 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
3874 module (sometimes unnecessary), B<INSTALL> the module
3875
3876 =back
3877
3878 =item PORTABILITY
3879
3880 =item HEY
3881
3882 =item AUTHOR
3883
3884 =item COPYRIGHT
3885
3886 =back
3887
3888 =head2 perlnewmod - preparing a new module for distribution
3889
3890 =over 4
3891
3892 =item DESCRIPTION
3893
3894 =over 4
3895
3896 =item Warning
3897
3898 =item What should I make into a module?
3899
3900 =item Step-by-step: Preparing the ground
3901
3902 Look around, Check it's new, Discuss the need, Choose a name, Check again
3903
3904 =item Step-by-step: Making the module
3905
3906 Start with F<module-starter> or F<h2xs>, Use L<strict|strict> and
3907 L<warnings|warnings>, Use L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!,
3908 Use L<plain old documentation|perlpod>, Write tests, Write the README
3909
3910 =item Step-by-step: Distributing your module
3911
3912 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
3913 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
3914
3915 =back
3916
3917 =item AUTHOR
3918
3919 =item SEE ALSO
3920
3921 =back
3922
3923 =head2 perlutil - utilities packaged with the Perl distribution
3924
3925 =over 4
3926
3927 =item DESCRIPTION
3928
3929 =over 4
3930
3931 =item DOCUMENTATION
3932
3933 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
3934 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
3935 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
3936 L<roffitall|roffitall>
3937
3938 =item CONVERTORS
3939
3940 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
3941
3942 =item Administration
3943
3944 L<libnetcfg|libnetcfg>
3945
3946 =item Development
3947
3948 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
3949 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
3950
3951 =item SEE ALSO
3952
3953 =back
3954
3955 =back
3956
3957 =head2 perlcompile - Introduction to the Perl Compiler-Translator 
3958
3959 =over 4
3960
3961 =item DESCRIPTION
3962
3963 =over 4
3964
3965 =item Layout
3966
3967 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3968
3969 =back
3970
3971 =item Using The Back Ends
3972
3973 =over 4
3974
3975 =item The Cross Referencing Back End
3976
3977 i, &, s, r
3978
3979 =item The Decompiling Back End
3980
3981 =item The Lint Back End
3982
3983 =item The Simple C Back End
3984
3985 =item The Bytecode Back End
3986
3987 =item The Optimized C Back End
3988
3989 =back
3990
3991 =item Module List for the Compiler Suite
3992
3993 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3994 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
3995 B::Stackobj, B::Stash, B::Terse, B::Xref
3996
3997 =item KNOWN PROBLEMS
3998
3999 =item AUTHOR
4000
4001 =back
4002
4003 =head2 perlfilter - Source Filters
4004
4005 =over 4
4006
4007 =item DESCRIPTION
4008
4009 =item CONCEPTS
4010
4011 =item USING FILTERS
4012
4013 =item WRITING A SOURCE FILTER
4014
4015 =item WRITING A SOURCE FILTER IN C
4016
4017 B<Decryption Filters>
4018
4019 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4020
4021 =item WRITING A SOURCE FILTER IN PERL
4022
4023 =item USING CONTEXT: THE DEBUG FILTER
4024
4025 =item CONCLUSION
4026
4027 =item THINGS TO LOOK OUT FOR
4028
4029 Some Filters Clobber the C<DATA> Handle
4030
4031 =item REQUIREMENTS
4032
4033 =item AUTHOR
4034
4035 =item Copyrights
4036
4037 =back
4038
4039 =head2 perlembed - how to embed perl in your C program
4040
4041 =over 4
4042
4043 =item DESCRIPTION
4044
4045 =over 4
4046
4047 =item PREAMBLE
4048
4049 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
4050 Perl?>, B<Use C from C?>, B<Use Perl from C?>
4051
4052 =item ROADMAP
4053
4054 =item Compiling your C program
4055
4056 =item Adding a Perl interpreter to your C program
4057
4058 =item Calling a Perl subroutine from your C program
4059
4060 =item Evaluating a Perl statement from your C program
4061
4062 =item Performing Perl pattern matches and substitutions from your C program
4063
4064 =item Fiddling with the Perl stack from your C program
4065
4066 =item Maintaining a persistent interpreter
4067
4068 =item Execution of END blocks
4069
4070 =item Maintaining multiple interpreter instances
4071
4072 =item Using Perl modules, which themselves use C libraries, from your C
4073 program
4074
4075 =back
4076
4077 =item Embedding Perl under Win32
4078
4079 =item Hiding Perl_
4080
4081 =item MORAL
4082
4083 =item AUTHOR
4084
4085 =item COPYRIGHT
4086
4087 =back
4088
4089 =head2 perldebguts - Guts of Perl debugging 
4090
4091 =over 4
4092
4093 =item DESCRIPTION
4094
4095 =item Debugger Internals
4096
4097 =over 4
4098
4099 =item Writing Your Own Debugger
4100
4101 =back
4102
4103 =item Frame Listing Output Examples
4104
4105 =item Debugging regular expressions
4106
4107 =over 4
4108
4109 =item Compile-time output
4110
4111 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
4112 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
4113 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
4114 C<anchored(TYPE)>
4115
4116 =item Types of nodes
4117
4118 =item Run-time output
4119
4120 =back
4121
4122 =item Debugging Perl memory usage
4123
4124 =over 4
4125
4126 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
4127
4128 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
4129 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
4130 6144>
4131
4132 =item Example of using B<-DL> switch
4133
4134 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
4135
4136 =item B<-DL> details
4137
4138 C<!!!>, C<!!>, C<!>
4139
4140 =item Limitations of B<-DL> statistics
4141
4142 =back
4143
4144 =item SEE ALSO
4145
4146 =back
4147
4148 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
4149
4150 =over 4
4151
4152 =item DESCRIPTION
4153
4154 =item SPECIAL NOTES
4155
4156 =over 4
4157
4158 =item make
4159
4160 =item Version caveat
4161
4162 =item Dynamic Loading versus Static Loading
4163
4164 =back
4165
4166 =item TUTORIAL
4167
4168 =over 4
4169
4170 =item EXAMPLE 1
4171
4172 =item EXAMPLE 2
4173
4174 =item What has gone on?
4175
4176 =item Writing good test scripts
4177
4178 =item EXAMPLE 3
4179
4180 =item What's new here?
4181
4182 =item Input and Output Parameters
4183
4184 =item The XSUBPP Program
4185
4186 =item The TYPEMAP file
4187
4188 =item Warning about Output Arguments
4189
4190 =item EXAMPLE 4
4191
4192 =item What has happened here?
4193
4194 =item Anatomy of .xs file
4195
4196 =item Getting the fat out of XSUBs
4197
4198 =item More about XSUB arguments
4199
4200 =item The Argument Stack
4201
4202 =item Extending your Extension
4203
4204 =item Documenting your Extension
4205
4206 =item Installing your Extension
4207
4208 =item EXAMPLE 5
4209
4210 =item New Things in this Example
4211
4212 =item EXAMPLE 6
4213
4214 =item New Things in this Example
4215
4216 =item EXAMPLE 7 (Coming Soon)
4217
4218 =item EXAMPLE 8 (Coming Soon)
4219
4220 =item EXAMPLE 9 Passing open files to XSes
4221
4222 =item Troubleshooting these Examples
4223
4224 =back
4225
4226 =item See also
4227
4228 =item Author
4229
4230 =over 4
4231
4232 =item Last Changed
4233
4234 =back
4235
4236 =back
4237
4238 =head2 perlxs - XS language reference manual
4239
4240 =over 4
4241
4242 =item DESCRIPTION
4243
4244 =over 4
4245
4246 =item Introduction
4247
4248 =item On The Road
4249
4250 =item The Anatomy of an XSUB
4251
4252 =item The Argument Stack
4253
4254 =item The RETVAL Variable
4255
4256 =item Returning SVs, AVs and HVs through RETVAL
4257
4258 =item The MODULE Keyword
4259
4260 =item The PACKAGE Keyword
4261
4262 =item The PREFIX Keyword
4263
4264 =item The OUTPUT: Keyword
4265
4266 =item The NO_OUTPUT Keyword
4267
4268 =item The CODE: Keyword
4269
4270 =item The INIT: Keyword
4271
4272 =item The NO_INIT Keyword
4273
4274 =item Initializing Function Parameters
4275
4276 =item Default Parameter Values
4277
4278 =item The PREINIT: Keyword
4279
4280 =item The SCOPE: Keyword
4281
4282 =item The INPUT: Keyword
4283
4284 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
4285
4286 =item The C<length(NAME)> Keyword
4287
4288 =item Variable-length Parameter Lists
4289
4290 =item The C_ARGS: Keyword
4291
4292 =item The PPCODE: Keyword
4293
4294 =item Returning Undef And Empty Lists
4295
4296 =item The REQUIRE: Keyword
4297
4298 =item The CLEANUP: Keyword
4299
4300 =item The POSTCALL: Keyword
4301
4302 =item The BOOT: Keyword
4303
4304 =item The VERSIONCHECK: Keyword
4305
4306 =item The PROTOTYPES: Keyword
4307
4308 =item The PROTOTYPE: Keyword
4309
4310 =item The ALIAS: Keyword
4311
4312 =item The OVERLOAD: Keyword
4313
4314 =item The FALLBACK: Keyword
4315
4316 =item The INTERFACE: Keyword
4317
4318 =item The INTERFACE_MACRO: Keyword
4319
4320 =item The INCLUDE: Keyword
4321
4322 =item The CASE: Keyword
4323
4324 =item The & Unary Operator
4325
4326 =item Inserting POD, Comments and C Preprocessor Directives
4327
4328 =item Using XS With C++
4329
4330 =item Interface Strategy
4331
4332 =item Perl Objects And C Structures
4333
4334 =item The Typemap
4335
4336 =item Safely Storing Static Data in XS
4337
4338 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4339
4340 =back
4341
4342 =item EXAMPLES
4343
4344 =item XS VERSION
4345
4346 =item AUTHOR
4347
4348 =back
4349
4350 =head2 perlclib - Internal replacements for standard C library functions
4351
4352 =over 4
4353
4354 =item DESCRIPTION
4355
4356 =over 4
4357
4358 =item Conventions
4359
4360 C<t>, C<p>, C<n>, C<s>
4361
4362 =item File Operations
4363
4364 =item File Input and Output
4365
4366 =item File Positioning
4367
4368 =item Memory Management and String Handling
4369
4370 =item Character Class Tests
4371
4372 =item F<stdlib.h> functions
4373
4374 =item Miscellaneous functions
4375
4376 =back
4377
4378 =item SEE ALSO
4379
4380 =back
4381
4382 =head2 perlguts - Introduction to the Perl API
4383
4384 =over 4
4385
4386 =item DESCRIPTION
4387
4388 =item Variables
4389
4390 =over 4
4391
4392 =item Datatypes
4393
4394 =item What is an "IV"?
4395
4396 =item Working with SVs
4397
4398 =item Offsets
4399
4400 =item What's Really Stored in an SV?
4401
4402 =item Working with AVs
4403
4404 =item Working with HVs
4405
4406 =item Hash API Extensions
4407
4408 =item AVs, HVs and undefined values
4409
4410 =item References
4411
4412 =item Blessed References and Class Objects
4413
4414 =item Creating New Variables
4415
4416 GV_ADDMULTI, GV_ADDWARN
4417
4418 =item Reference Counts and Mortality
4419
4420 =item Stashes and Globs
4421
4422 =item Double-Typed SVs
4423
4424 =item Magic Variables
4425
4426 =item Assigning Magic
4427
4428 =item Magic Virtual Tables
4429
4430 =item Finding Magic
4431
4432 =item Understanding the Magic of Tied Hashes and Arrays
4433
4434 =item Localizing changes
4435
4436 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
4437 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
4438 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
4439 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
4440 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
4441 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
4442 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
4443 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
4444 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
4445 save_hptr(HV **hptr)>
4446
4447 =back
4448
4449 =item Subroutines
4450
4451 =over 4
4452
4453 =item XSUBs and the Argument Stack
4454
4455 =item Calling Perl Routines from within C Programs
4456
4457 =item Memory Allocation
4458
4459 =item PerlIO
4460
4461 =item Putting a C value on Perl stack
4462
4463 =item Scratchpads
4464
4465 =item Scratchpads and recursion
4466
4467 =back
4468
4469 =item Compiled code
4470
4471 =over 4
4472
4473 =item Code tree
4474
4475 =item Examining the tree
4476
4477 =item Compile pass 1: check routines
4478
4479 =item Compile pass 1a: constant folding
4480
4481 =item Compile pass 2: context propagation
4482
4483 =item Compile pass 3: peephole optimization
4484
4485 =item Pluggable runops
4486
4487 =back
4488
4489 =item Examining internal data structures with the C<dump> functions
4490
4491 =item How multiple interpreters and concurrency are supported
4492
4493 =over 4
4494
4495 =item Background and PERL_IMPLICIT_CONTEXT
4496
4497 =item So what happened to dTHR?
4498
4499 =item How do I use all this in extensions?
4500
4501 =item Should I do anything special if I call perl from multiple threads?
4502
4503 =item Future Plans and PERL_IMPLICIT_SYS
4504
4505 =back
4506
4507 =item Internal Functions
4508
4509 A, p, d, s, n, r, f, M, o, x, m, X, E, b
4510
4511 =over 4
4512
4513 =item Formatted Printing of IVs, UVs, and NVs
4514
4515 =item Pointer-To-Integer and Integer-To-Pointer
4516
4517 =item Exception Handling
4518
4519 =item Source Documentation
4520
4521 =item Backwards compatibility
4522
4523 =back
4524
4525 =item Unicode Support
4526
4527 =over 4
4528
4529 =item What B<is> Unicode, anyway?
4530
4531 =item How can I recognise a UTF-8 string?
4532
4533 =item How does UTF-8 represent Unicode characters?
4534
4535 =item How does Perl store UTF-8 strings?
4536
4537 =item How do I convert a string to UTF-8?
4538
4539 =item Is there anything else I need to know?
4540
4541 =back
4542
4543 =item Custom Operators
4544
4545 =item AUTHORS
4546
4547 =item SEE ALSO
4548
4549 =back
4550
4551 =head2 perlcall - Perl calling conventions from C
4552
4553 =over 4
4554
4555 =item DESCRIPTION
4556
4557 An Error Handler, An Event Driven Program
4558
4559 =item THE CALL_ FUNCTIONS
4560
4561 call_sv, call_pv, call_method, call_argv
4562
4563 =item FLAG VALUES
4564
4565 =over 4
4566
4567 =item  G_VOID
4568
4569 =item  G_SCALAR
4570
4571 =item G_ARRAY
4572
4573 =item G_DISCARD
4574
4575 =item G_NOARGS
4576
4577 =item G_EVAL
4578
4579 =item G_KEEPERR
4580
4581 =item Determining the Context
4582
4583 =back
4584
4585 =item KNOWN PROBLEMS
4586
4587 =item EXAMPLES
4588
4589 =over 4
4590
4591 =item No Parameters, Nothing returned
4592
4593 =item Passing Parameters
4594
4595 =item Returning a Scalar
4596
4597 =item Returning a list of values
4598
4599 =item Returning a list in a scalar context
4600
4601 =item Returning Data from Perl via the parameter list
4602
4603 =item Using G_EVAL
4604
4605 =item Using G_KEEPERR
4606
4607 =item Using call_sv
4608
4609 =item Using call_argv
4610
4611 =item Using call_method
4612
4613 =item Using GIMME_V
4614
4615 =item Using Perl to dispose of temporaries
4616
4617 =item Strategies for storing Callback Context Information
4618
4619 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
4620 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
4621 callback
4622
4623 =item Alternate Stack Manipulation
4624
4625 =item Creating and calling an anonymous subroutine in C
4626
4627 =back
4628
4629 =item SEE ALSO
4630
4631 =item AUTHOR
4632
4633 =item DATE
4634
4635 =back
4636
4637 =head2 perlapi - autogenerated documentation for the perl public API
4638
4639 =over 4
4640
4641 =item DESCRIPTION
4642
4643 =item "Gimme" Values
4644
4645 GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
4646
4647 =item Array Manipulation Functions
4648
4649 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4650 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4651 get_av, newAV, sortsv
4652
4653 =item Callback Functions
4654
4655 call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
4656 FREETMPS, LEAVE, SAVETMPS
4657
4658 =item Character classes
4659
4660 isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
4661
4662 =item Cloning an interpreter
4663
4664 perl_clone
4665
4666 =item CV Manipulation Functions
4667
4668 CvSTASH, get_cv
4669
4670 =item Embedding Functions
4671
4672 cv_undef, load_module, nothreadhook, perl_alloc, perl_construct,
4673 perl_destruct, perl_free, perl_parse, perl_run, require_pv
4674
4675 =item Functions in file pp_pack.c
4676
4677 packlist, pack_cat, unpackstring, unpack_str
4678
4679 =item Global Variables
4680
4681 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
4682
4683 =item GV Functions
4684
4685 GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
4686 gv_fetchmeth_autoload, gv_stashpv, gv_stashpvn, gv_stashsv
4687
4688 =item Handy Values
4689
4690 Nullav, Nullch, Nullcv, Nullhv, Nullsv
4691
4692 =item Hash Manipulation Functions
4693
4694 get_hv, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force,
4695 HeSVKEY_set, HeVAL, HvNAME, hv_assert, hv_clear, hv_clear_placeholders,
4696 hv_delete, hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
4697 hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv,
4698 hv_iternext_flags, hv_iterval, hv_magic, hv_scalar, hv_store, hv_store_ent,
4699 hv_undef, newHV
4700
4701 =item Magical Functions
4702
4703 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
4704 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
4705 SvSetSV, SvSetSV_nosteal, SvSHARE, SvUNLOCK
4706
4707 =item Memory Management
4708
4709 Copy, CopyD, Move, MoveD, New, Newc, Newz, Poison, Renew, Renewc, Safefree,
4710 savepv, savepvn, savesharedpv, savesvpv, StructCopy, Zero, ZeroD
4711
4712 =item Miscellaneous Functions
4713
4714 fbm_compile, fbm_instr, form, getcwd_sv, new_version, scan_version, strEQ,
4715 strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_nolocking,
4716 sv_nosharing, sv_nounlocking, upg_version, vcmp, vnormal, vnumify,
4717 vstringify
4718
4719 =item Numeric functions
4720
4721 grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
4722 scan_hex, scan_oct
4723
4724 =item Optree Manipulation Functions
4725
4726 cv_const_sv, newCONSTSUB, newXS
4727
4728 =item Pad Data Structures
4729
4730 pad_sv
4731
4732 =item Simple Exception Handling Macros
4733
4734 dXCPT, XCPT_CATCH, XCPT_RETHROW, XCPT_TRY_END, XCPT_TRY_START
4735
4736 =item Stack Manipulation Macros
4737
4738 dMARK, dORIGMARK, dSP, EXTEND, MARK, mPUSHi, mPUSHn, mPUSHp, mPUSHu,
4739 mXPUSHi, mXPUSHn, mXPUSHp, mXPUSHu, ORIGMARK, POPi, POPl, POPn, POPp,
4740 POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHmortal, PUSHn, PUSHp, PUSHs,
4741 PUSHu, PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHmortal, XPUSHn, XPUSHp, XPUSHs,
4742 XPUSHu, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, XSRETURN_NV,
4743 XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_UV, XSRETURN_YES, XST_mIV, XST_mNO,
4744 XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
4745
4746 =item SV Flags
4747
4748 svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
4749
4750 =item SV Manipulation Functions
4751
4752 get_sv, looks_like_number, newRV_inc, newRV_noinc, NEWSV, newSV, newSViv,
4753 newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv,
4754 newSVuv, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV,
4755 SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIsCOW,
4756 SvIsCOW_shared_hash, SvIV, SvIVX, SvIVx, SvIV_nomg, SvLEN, SvNIOK, SvNIOKp,
4757 SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX,
4758 SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only,
4759 SvPOK_only_UTF8, SvPV, SvPVbyte, SvPVbytex, SvPVbytex_force,
4760 SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, SvPVutf8x, SvPVutf8x_force,
4761 SvPVutf8_force, SvPVutf8_nolen, SvPVX, SvPVx, SvPV_force, SvPV_force_nomg,
4762 SvPV_nolen, SvPV_nomg, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK,
4763 SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off,
4764 SvTAINTED_on, SvTRUE, SvTYPE, SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off,
4765 SvUTF8_on, SvUV, SvUVX, SvUVx, SvUV_nomg, SvVOK, sv_2bool, sv_2cv, sv_2io,
4766 sv_2iv_flags, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen, sv_2pvutf8,
4767 sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv_flags, sv_backoff,
4768 sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_flags,
4769 sv_catpvn_mg, sv_catpvn_nomg, sv_catpv_mg, sv_catsv, sv_catsv_flags,
4770 sv_catsv_mg, sv_catsv_nomg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale,
4771 sv_collxfrm, sv_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal,
4772 sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, sv_insert,
4773 sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, sv_magicext,
4774 sv_mortalcopy, sv_newmortal, sv_newref, sv_nv, sv_pos_b2u, sv_pos_u2b,
4775 sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force,
4776 sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype,
4777 sv_replace, sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg,
4778 sv_setnv, sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv,
4779 sv_setpviv_mg, sv_setpvn, sv_setpvn_mg, sv_setpv_mg, sv_setref_iv,
4780 sv_setref_nv, sv_setref_pv, sv_setref_pvn, sv_setref_uv, sv_setsv,
4781 sv_setsv_flags, sv_setsv_mg, sv_setsv_nomg, sv_setuv, sv_setuv_mg,
4782 sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref, sv_unref_flags,
4783 sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_utf8_decode,
4784 sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, sv_utf8_upgrade_flags,
4785 sv_uv, sv_vcatpvf, sv_vcatpvfn, sv_vcatpvf_mg, sv_vsetpvf, sv_vsetpvfn,
4786 sv_vsetpvf_mg
4787
4788 =item Unicode Support
4789
4790 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
4791 is_utf8_string_loc, pv_uni_display, sv_cat_decode, sv_recode_to_utf8,
4792 sv_uni_display, to_utf8_case, to_utf8_fold, to_utf8_lower, to_utf8_title,
4793 to_utf8_upper, utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop,
4794 utf8_length, utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8,
4795 uvuni_to_utf8_flags
4796
4797 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
4798
4799 ax, CLASS, dAX, dITEMS, dUNDERBAR, dXSARGS, dXSI32, items, ix, newXSproto,
4800 RETVAL, ST, THIS, UNDERBAR, XS, XS_VERSION, XS_VERSION_BOOTCHECK
4801
4802 =item Warning and Dieing
4803
4804 croak, warn
4805
4806 =item AUTHORS
4807
4808 =item SEE ALSO
4809
4810 =back
4811
4812 =head2 perlintern - autogenerated documentation of purely B<internal>
4813                  Perl functions
4814
4815 =over 4
4816
4817 =item DESCRIPTION
4818
4819 =item CV reference counts and CvOUTSIDE
4820
4821 CvWEAKOUTSIDE
4822
4823 =item Functions in file pad.h
4824
4825 CX_CURPAD_SAVE, CX_CURPAD_SV, PAD_BASE_SV, PAD_CLONE_VARS,
4826 PAD_COMPNAME_FLAGS, PAD_COMPNAME_GEN, PAD_COMPNAME_OURSTASH,
4827 PAD_COMPNAME_PV, PAD_COMPNAME_TYPE, PAD_DUP, PAD_RESTORE_LOCAL,
4828 PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV, PAD_SET_CUR,
4829 PAD_SET_CUR_NOSAVE, PAD_SV, PAD_SVl, SAVECLEARSV, SAVECOMPPAD, SAVEPADSV
4830
4831 =item Functions in file pp_ctl.c
4832
4833 find_runcv
4834
4835 =item Global Variables
4836
4837 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
4838 PL_rs
4839
4840 =item GV Functions
4841
4842 is_gv_magical, is_gv_magical_sv
4843
4844 =item IO Functions
4845
4846 start_glob
4847
4848 =item Pad Data Structures
4849
4850 CvPADLIST, cv_clone, cv_dump, do_dump_pad, intro_my, pad_add_anon,
4851 pad_add_name, pad_alloc, pad_block_start, pad_check_dup, pad_findlex,
4852 pad_findmy, pad_fixup_inner_anons, pad_free, pad_leavemy, pad_new,
4853 pad_push, pad_reset, pad_setsv, pad_swipe, pad_tidy, pad_undef
4854
4855 =item Stack Manipulation Macros
4856
4857 djSP, LVRET
4858
4859 =item SV Manipulation Functions
4860
4861 find_uninit_var, report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs,
4862 sv_free_arenas
4863
4864 =item AUTHORS
4865
4866 =item SEE ALSO
4867
4868 =back
4869
4870 =head2 perliol - C API for Perl's implementation of IO in Layers.
4871
4872 =over 4
4873
4874 =item SYNOPSIS
4875
4876 =item DESCRIPTION
4877
4878 =over 4
4879
4880 =item History and Background
4881
4882 =item Basic Structure
4883
4884 =item Layers vs Disciplines
4885
4886 =item Data Structures
4887
4888 =item Functions and Attributes
4889
4890 =item Per-instance Data
4891
4892 =item Layers in action.
4893
4894 =item Per-instance flag bits
4895
4896 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4897 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4898 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4899 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4900
4901 =item Methods in Detail
4902
4903 fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF,
4904 PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode,
4905 Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof,
4906 Error,  Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
4907 Set_ptrcnt
4908
4909 =item Utilities
4910
4911 =item Implementing PerlIO Layers
4912
4913 C implementations, Perl implementations
4914
4915 =item Core Layers
4916
4917 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4918
4919 =item Extension Layers
4920
4921 ":encoding", ":scalar", ":via"
4922
4923 =back
4924
4925 =item TODO
4926
4927 =back
4928
4929 =head2 perlapio - perl's IO abstraction interface.
4930
4931 =over 4
4932
4933 =item SYNOPSIS
4934
4935 =item DESCRIPTION
4936
4937 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4938 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4939 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4940 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4941 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4942 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4943 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4944 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4945 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4946 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4947 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4948
4949 =over 4
4950
4951 =item Co-existence with stdio
4952
4953 B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
4954 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
4955
4956 =item "Fast gets" Functions
4957
4958 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4959 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4960 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4961 B<PerlIO_get_bufsiz(f)>
4962
4963 =item Other Functions
4964
4965 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4966 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4967
4968 =back
4969
4970 =back
4971
4972 =head2 perlhack - How to hack at the Perl internals
4973
4974 =over 4
4975
4976 =item DESCRIPTION
4977
4978 Does concept match the general goals of Perl?, Where is the
4979 implementation?, Backwards compatibility, Could it be a module instead?, Is
4980 the feature generic enough?, Does it potentially introduce new bugs?, Does
4981 it preclude other desirable features?, Is the implementation robust?, Is
4982 the implementation generic enough to be portable?, Is the implementation
4983 tested?, Is there enough documentation?, Is there another way to do it?,
4984 Does it create too much work?, Patches speak louder than words
4985
4986 =over 4
4987
4988 =item Keeping in sync
4989
4990 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
4991 NFS, rsync'ing the patches
4992
4993 =item Why rsync the source tree
4994
4995 It's easier to rsync the source tree, It's more reliable
4996
4997 =item Why rsync the patches
4998
4999 It's easier to rsync the patches, It's a good reference, Finding a start
5000 point, Finding how to fix a bug, Finding the source of misbehaviour
5001
5002 =item Working with the source
5003
5004 =item Perlbug administration
5005
5006 =item Submitting patches
5007
5008 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
5009 F<Porting/pumpkin.pod>, The perl5-porters FAQ
5010
5011 =item Finding Your Way Around
5012
5013 Core modules, Tests, Documentation, Configure, Interpreter
5014
5015 =item Elements of the interpreter
5016
5017 Startup, Parsing, Optimization, Running
5018
5019 =item Internal Variable Types
5020
5021 =item Op Trees
5022
5023 =item Stacks
5024
5025 Argument stack, Mark stack, Save stack
5026
5027 =item Millions of Macros
5028
5029 =item The .i Targets
5030
5031 =item Poking at Perl
5032
5033 =item Using a source-level debugger
5034
5035 run [args], break function_name, break source.c:xxx, step, next, continue,
5036 finish, 'enter', print
5037
5038 =item gdb macro support
5039
5040 =item Dumping Perl Data Structures
5041
5042 =item Patching
5043
5044 =item Patching a core module
5045
5046 =item Adding a new function to the core
5047
5048 =item Writing a test
5049
5050 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5051 F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base t/comp,
5052 t/cmd t/run t/io t/op, t/lib ext lib
5053
5054 =item Special Make Test Targets
5055
5056 coretest, test.deparse, test.taintwarn, minitest, test.valgrind
5057 check.valgrind utest.valgrind ucheck.valgrind, test.third check.third
5058 utest.third ucheck.third, test.torture torturetest, utest ucheck test.utf8
5059 check.utf8, minitest.utf16 test.utf16, test_harness, test-notty test_notty
5060
5061 =item Running tests by hand
5062
5063 -v, -torture, -re=PATTERN, -re LIST OF PATTERNS, PERL_CORE=1,
5064 PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST
5065
5066 =back
5067
5068 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5069
5070 =over 4
5071
5072 =item Rational Software's Purify
5073
5074 =item Purify on Unix
5075
5076 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5077
5078 =item Purify on NT
5079
5080 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5081
5082 =item valgrind
5083
5084 =item Compaq's/Digital's/HP's Third Degree
5085
5086 =item PERL_DESTRUCT_LEVEL
5087
5088 =item Profiling
5089
5090 =item Gprof Profiling
5091
5092 -a, -b, -e routine, -f routine, -s, -z
5093
5094 =item GCC gcov Profiling
5095
5096 =item Pixie Profiling
5097
5098 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5099 -z[ero]
5100
5101 =item Miscellaneous tricks
5102
5103 =item CONCLUSION
5104
5105 I<The Road goes ever on and on, down from the door where it began.>
5106
5107 =back
5108
5109 =item AUTHOR
5110
5111 =back
5112
5113 =head2 perlbook - Perl book information
5114
5115 =over 4
5116
5117 =item DESCRIPTION
5118
5119 =back
5120
5121 =head2 perltodo - Perl TO-DO List
5122
5123 =over 4
5124
5125 =item DESCRIPTION
5126
5127 =item assertions
5128
5129 =item iCOW
5130
5131 =item (?{...}) closures in regexps
5132
5133 =item A re-entrant regexp engine
5134
5135 =item pragmata
5136
5137 =over 4
5138
5139 =item lexical pragmas
5140
5141 =item use less 'memory'
5142
5143 =back
5144
5145 =item prototypes and functions
5146
5147 =over 4
5148
5149 =item _ prototype character
5150
5151 =item inlining autoloaded constants
5152
5153 =item Finish off lvalue functions
5154
5155 =back
5156
5157 =item Unicode and UTF8
5158
5159 =over 4
5160
5161 =item Implicit Latin 1 => Unicode translation
5162
5163 =item UTF8 caching code
5164
5165 =item Unicode in Filenames
5166
5167 =item Unicode in %ENV
5168
5169 =back
5170
5171 =item Regexps
5172
5173 =over 4
5174
5175 =item regexp optimiser optional
5176
5177 =back
5178
5179 =item POD
5180
5181 =over 4
5182
5183 =item POD -> HTML conversion still sucks
5184
5185 =back
5186
5187 =item Misc medium sized projects
5188
5189 =over 4
5190
5191 =item UNITCHECK
5192
5193 =item optional optimizer
5194
5195 =item You WANT *how* many
5196
5197 =item lexical aliases
5198
5199 =item no 6
5200
5201 =item IPv6
5202
5203 =item entersub XS vs Perl
5204
5205 =item @INC source filter to Filter::Simple
5206
5207 =item bincompat functions
5208
5209 =item Use fchown/fchmod internally
5210
5211 =item Constant folding
5212
5213 =back
5214
5215 =item Tests
5216
5217 =over 4
5218
5219 =item Make Schwern poorer
5220
5221 =item test B
5222
5223 =item common test code for timed bailout
5224
5225 =back
5226
5227 =item Installation
5228
5229 =over 4
5230
5231 =item compressed man pages
5232
5233 =item Make Config.pm cope with differences between build and installed perl
5234
5235 =item Relocatable perl
5236
5237 =item make HTML install work
5238
5239 =item put patchlevel in -v
5240
5241 =back
5242
5243 =item Incremental things
5244
5245 =over 4
5246
5247 =item autovivification
5248
5249 =item fix tainting bugs
5250
5251 =item Make tainting consistent
5252
5253 =item Dual life everything
5254
5255 =back
5256
5257 =item Vague things
5258
5259 =over 4
5260
5261 =item threads
5262
5263 =item POSIX memory footprint
5264
5265 =item Optimize away @_
5266
5267 =item switch ops
5268
5269 =item Attach/detach debugger from running program
5270
5271 =item A decent benchmark
5272
5273 =item readpipe(LIST)
5274
5275 =item Self ties
5276
5277 =back
5278
5279 =back
5280
5281 =head2 perldoc - Look up Perl documentation in Pod format.
5282
5283 =over 4
5284
5285 =item SYNOPSIS
5286
5287 =item DESCRIPTION
5288
5289 =item OPTIONS
5290
5291 B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
5292 I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
5293 I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
5294 B<-w> I<option:value> or B<-w> I<option>, B<-X>,
5295 B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
5296 B<-V>
5297
5298 =item SECURITY
5299
5300 =item ENVIRONMENT
5301
5302 =item AUTHOR
5303
5304 =back
5305
5306 =head2 perlhist - the Perl history records
5307
5308 =over 4
5309
5310 =item DESCRIPTION
5311
5312 =item INTRODUCTION
5313
5314 =item THE KEEPERS OF THE PUMPKIN
5315
5316 =over 4
5317
5318 =item PUMPKIN?
5319
5320 =back
5321
5322 =item THE RECORDS
5323
5324 =over 4
5325
5326 =item SELECTED RELEASE SIZES
5327
5328 =item SELECTED PATCH SIZES
5329
5330 =back
5331
5332 =item THE KEEPERS OF THE RECORDS
5333
5334 =back
5335
5336 =head2 perldelta - what is new for perl v5.9.2
5337
5338 =over 4
5339
5340 =item DESCRIPTION
5341
5342 =item Incompatible Changes
5343
5344 =over 4
5345
5346 =item Packing and UTF-8 strings
5347
5348 =item Miscellaneous
5349
5350 =back
5351
5352 =item Core Enhancements
5353
5354 =over 4
5355
5356 =item Malloc wrapping
5357
5358 =item Unicode Character Database 4.0.1
5359
5360 =item suidperl less insecure
5361
5362 =item PERLIO_DEBUG
5363
5364 =item Formats
5365
5366 =item Unicode Character Classes
5367
5368 =item Byte-order modifiers for pack() and unpack()
5369
5370 =item Byte count feature in pack()
5371
5372 =item New variables
5373
5374 =back
5375
5376 =item Modules and Pragmata
5377
5378 =over 4
5379
5380 =item New modules
5381
5382 =item Updated And Improved Modules and Pragmata
5383
5384 B::Concise, Socket, Sys::Syslog, threads
5385
5386 =back
5387
5388 =item Utility Changes
5389
5390 =item Performance Enhancements
5391
5392 =item Installation and Configuration Improvements
5393
5394 =item Selected Bug Fixes
5395
5396 =item New or Changed Diagnostics
5397
5398 =item Changed Internals
5399
5400 =item Known Problems
5401
5402 =item Plans for the next release
5403
5404 =item Reporting Bugs
5405
5406 =item SEE ALSO
5407
5408 =back
5409
5410 =head2 perl592delta, perldelta - what is new for perl v5.9.2
5411
5412 =over 4
5413
5414 =item DESCRIPTION
5415
5416 =item Incompatible Changes
5417
5418 =over 4
5419
5420 =item Packing and UTF-8 strings
5421
5422 =item Miscellaneous
5423
5424 =back
5425
5426 =item Core Enhancements
5427
5428 =over 4
5429
5430 =item Malloc wrapping
5431
5432 =item Unicode Character Database 4.0.1
5433
5434 =item suidperl less insecure
5435
5436 =item PERLIO_DEBUG
5437
5438 =item Formats
5439
5440 =item Unicode Character Classes
5441
5442 =item Byte-order modifiers for pack() and unpack()
5443
5444 =item Byte count feature in pack()
5445
5446 =item New variables
5447
5448 =back
5449
5450 =item Modules and Pragmata
5451
5452 =over 4
5453
5454 =item New modules
5455
5456 =item Updated And Improved Modules and Pragmata
5457
5458 B::Concise, Socket, Sys::Syslog, threads
5459
5460 =back
5461
5462 =item Utility Changes
5463
5464 =item Performance Enhancements
5465
5466 =item Installation and Configuration Improvements
5467
5468 =item Selected Bug Fixes
5469
5470 =item New or Changed Diagnostics
5471
5472 =item Changed Internals
5473
5474 =item Known Problems
5475
5476 =item Plans for the next release
5477
5478 =item Reporting Bugs
5479
5480 =item SEE ALSO
5481
5482 =back
5483
5484 =head2 perl591delta, perldelta - what is new for perl v5.9.1
5485
5486 =over 4
5487
5488 =item DESCRIPTION
5489
5490 =item Incompatible Changes
5491
5492 =over 4
5493
5494 =item substr() lvalues are no longer fixed-length
5495
5496 =item The C<:unique> attribute is only meaningful for globals
5497
5498 =back
5499
5500 =item Core Enhancements
5501
5502 =over 4
5503
5504 =item Lexical C<$_>
5505
5506 =item Tied hashes in scalar context
5507
5508 =item Formats
5509
5510 =item Stacked filetest operators
5511
5512 =back
5513
5514 =item Modules and Pragmata
5515
5516 Benchmark, Carp, Exporter, FindBin, List::Util, threads::shared
5517
5518 =item Utility Changes
5519
5520 =item Documentation
5521
5522 =item Performance Enhancements
5523
5524 =item Selected Bug Fixes
5525
5526 =over 4
5527
5528 =item UTF-8 bugs
5529
5530 =item Threading bugs
5531
5532 =item More bugs
5533
5534 =back
5535
5536 =item New or Changed Diagnostics
5537
5538 =item Changed Internals
5539
5540 =over 4
5541
5542 =item Reordering of SVt_* constants
5543
5544 =item Removal of CPP symbols
5545
5546 =item Less space is used by ops
5547
5548 =item New parser
5549
5550 =back
5551
5552 =item Configuration and Building
5553
5554 =item Known Problems
5555
5556 =over 4
5557
5558 =item Platform Specific Problems
5559
5560 =back
5561
5562 =item To-do for perl 5.10.0
5563
5564 =item Reporting Bugs
5565
5566 =item SEE ALSO
5567
5568 =back
5569
5570 =head2 perl590delta, perldelta - what is new for perl v5.9.0
5571
5572 =over 4
5573
5574 =item DESCRIPTION
5575
5576 =item Incompatible Changes
5577
5578 =over 4
5579
5580 =item Hash Randomisation
5581
5582 =item UTF-8 On Filehandles No Longer Activated By Locale
5583
5584 =item Single-number v-strings are no longer v-strings before "=>"
5585
5586 =item (Win32) The -C Switch Has Been Repurposed
5587
5588 =item (Win32) The /d Switch Of cmd.exe
5589
5590 =item The C<$*> variable has been removed
5591
5592 =back
5593
5594 =item Core Enhancements
5595
5596 =over 4
5597
5598 =item Assertions
5599
5600 =item Defined-or operators
5601
5602 =item UTF-8 no longer default under UTF-8 locales
5603
5604 =item Unsafe signals again available
5605
5606 =item Tied Arrays with Negative Array Indices
5607
5608 =item local ${$x}
5609
5610 =item Unicode Character Database 4.0.0
5611
5612 =item Miscellaneous Enhancements
5613
5614 =back
5615
5616 =item Modules and Pragmata
5617
5618 =over 4
5619
5620 =item Updated Modules And Pragmata
5621
5622 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
5623 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
5624 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
5625 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
5626 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
5627 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
5628 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
5629 Win32::GetOSVersion
5630
5631 =back
5632
5633 =item Utility Changes
5634
5635 =item New Documentation
5636
5637 =item Performance Enhancements
5638
5639 =item Installation and Configuration Improvements
5640
5641 =over 4
5642
5643 =item Platform-specific enhancements
5644
5645 =back
5646
5647 =item Selected Bug Fixes
5648
5649 =over 4
5650
5651 =item Closures, eval and lexicals
5652
5653 =item Generic fixes
5654
5655 =item Platform-specific fixes
5656
5657 =back
5658
5659 =item New or Changed Diagnostics
5660
5661 =over 4
5662
5663 =item Changed "A thread exited while %d threads were running"
5664
5665 =item Removed "Attempt to clear a restricted hash"
5666
5667 =item New "Illegal declaration of anonymous subroutine"
5668
5669 =item Changed "Invalid range "%s" in transliteration operator"
5670
5671 =item New "Missing control char name in \c"
5672
5673 =item New "Newline in left-justified string for %s"
5674
5675 =item New "Possible precedence problem on bitwise %c operator"
5676
5677 =item New "read() on %s filehandle %s"
5678
5679 =item New "Tied variable freed while still in use"
5680
5681 =item New "To%s: illegal mapping '%s'"
5682
5683 =item New "Use of freed value in iteration"
5684
5685 =back
5686
5687 =item Changed Internals
5688
5689 =item New Tests
5690
5691 =item Known Problems
5692
5693 =over 4
5694
5695 =item Tied hashes in scalar context
5696
5697 =item Net::Ping 450_service and 510_ping_udp failures
5698
5699 =item B::C
5700
5701 =back
5702
5703 =item Platform Specific Problems
5704
5705 =over 4
5706
5707 =item EBCDIC Platforms
5708
5709 =item Cygwin 1.5 problems
5710
5711 =item HP-UX: HP cc warnings about sendfile and sendpath
5712
5713 =item IRIX: t/uni/tr_7jis.t falsely failing
5714
5715 =item Mac OS X: no usemymalloc
5716
5717 =item Tru64: No threaded builds with GNU cc (gcc)
5718
5719 =item Win32: sysopen, sysread, syswrite
5720
5721 =back
5722
5723 =item TODO
5724
5725 =item Reporting Bugs
5726
5727 =item SEE ALSO
5728
5729 =back
5730
5731 =head2 perl586delta - what is new for perl v5.8.6
5732
5733 =over 4
5734
5735 =item DESCRIPTION
5736
5737 =item Incompatible Changes
5738
5739 =item Core Enhancements
5740
5741 =item Modules and Pragmata
5742
5743 =item Utility Changes
5744
5745 =item Performance Enhancements
5746
5747 =item Selected Bug Fixes
5748
5749 =item New or Changed Diagnostics
5750
5751 =item Changed Internals
5752
5753 =item New Tests
5754
5755 =item Reporting Bugs
5756
5757 =item SEE ALSO
5758
5759 =back
5760
5761 =head2 perl585delta - what is new for perl v5.8.5
5762
5763 =over 4
5764
5765 =item DESCRIPTION
5766
5767 =item Incompatible Changes
5768
5769 =item Core Enhancements
5770
5771 =item Modules and Pragmata
5772
5773 =item Utility Changes
5774
5775 =over 4
5776
5777 =item Perl's debugger
5778
5779 =item h2ph
5780
5781 =back
5782
5783 =item Installation and Configuration Improvements
5784
5785 =item Selected Bug Fixes
5786
5787 =item New or Changed Diagnostics
5788
5789 =item Changed Internals
5790
5791 =item Known Problems
5792
5793 =item Platform Specific Problems
5794
5795 =item Reporting Bugs
5796
5797 =item SEE ALSO
5798
5799 =back
5800
5801 =head2 perl584delta - what is new for perl v5.8.4
5802
5803 =over 4
5804
5805 =item DESCRIPTION
5806
5807 =item Incompatible Changes
5808
5809 =item Core Enhancements
5810
5811 =over 4
5812
5813 =item Malloc wrapping
5814
5815 =item Unicode Character Database 4.0.1
5816
5817 =item suidperl less insecure
5818
5819 =item format
5820
5821 =back
5822
5823 =item Modules and Pragmata
5824
5825 =over 4
5826
5827 =item Updated modules
5828
5829 Attribute::Handlers, B, Benchmark, CGI, Carp, Cwd, Exporter, File::Find,
5830 IO, IPC::Open3, Local::Maketext, Math::BigFloat, Math::BigInt,
5831 Math::BigRat, MIME::Base64, ODBM_File, POSIX, Shell, Socket, Storable,
5832 Switch, Sys::Syslog, Term::ANSIColor, Time::HiRes, Unicode::UCD, Win32,
5833 base, open, threads, utf8
5834
5835 =back
5836
5837 =item Performance Enhancements
5838
5839 =item Utility Changes
5840
5841 =item Installation and Configuration Improvements
5842
5843 =item Selected Bug Fixes
5844
5845 =item New or Changed Diagnostics
5846
5847 =item Changed Internals
5848
5849 =item Future Directions
5850
5851 =item Platform Specific Problems
5852
5853 =item Reporting Bugs
5854
5855 =item SEE ALSO
5856
5857 =back
5858
5859 =head2 perl583delta - what is new for perl v5.8.3
5860
5861 =over 4
5862
5863 =item DESCRIPTION
5864
5865 =item Incompatible Changes
5866
5867 =item Core Enhancements
5868
5869 =item Modules and Pragmata
5870
5871 CGI, Cwd, Digest, Digest::MD5, Encode, File::Spec, FindBin, List::Util,
5872 Math::BigInt, PodParser, Pod::Perldoc, POSIX, Unicode::Collate,
5873 Unicode::Normalize, Test::Harness, threads::shared
5874
5875 =item Utility Changes
5876
5877 =item New Documentation
5878
5879 =item Installation and Configuration Improvements
5880
5881 =item Selected Bug Fixes
5882
5883 =item New or Changed Diagnostics
5884
5885 =item Changed Internals
5886
5887 =item Configuration and Building
5888
5889 =item Platform Specific Problems
5890
5891 =item Known Problems
5892
5893 =item Future Directions
5894
5895 =item Obituary
5896
5897 =item Reporting Bugs
5898
5899 =item SEE ALSO
5900
5901 =back
5902
5903 =head2 perl582delta - what is new for perl v5.8.2
5904
5905 =over 4
5906
5907 =item DESCRIPTION
5908
5909 =item Incompatible Changes
5910
5911 =item Core Enhancements
5912
5913 =over 4
5914
5915 =item Hash Randomisation
5916
5917 =item Threading
5918
5919 =back
5920
5921 =item Modules and Pragmata
5922
5923 =over 4
5924
5925 =item Updated Modules And Pragmata
5926
5927 Devel::PPPort, Digest::MD5, I18N::LangTags, libnet, MIME::Base64,
5928 Pod::Perldoc, strict, Tie::Hash, Time::HiRes, Unicode::Collate,
5929 Unicode::Normalize, UNIVERSAL
5930
5931 =back
5932
5933 =item Selected Bug Fixes
5934
5935 =item Changed Internals
5936
5937 =item Platform Specific Problems
5938
5939 =item Future Directions
5940
5941 =item Reporting Bugs
5942
5943 =item SEE ALSO
5944
5945 =back
5946
5947 =head2 perl581delta - what is new for perl v5.8.1
5948
5949 =over 4
5950
5951 =item DESCRIPTION
5952
5953 =item Incompatible Changes
5954
5955 =over 4
5956
5957 =item Hash Randomisation
5958
5959 =item UTF-8 On Filehandles No Longer Activated By Locale
5960
5961 =item Single-number v-strings are no longer v-strings before "=>"
5962
5963 =item (Win32) The -C Switch Has Been Repurposed
5964
5965 =item (Win32) The /d Switch Of cmd.exe
5966
5967 =back
5968
5969 =item Core Enhancements
5970
5971 =over 4
5972
5973 =item UTF-8 no longer default under UTF-8 locales
5974
5975 =item Unsafe signals again available
5976
5977 =item Tied Arrays with Negative Array Indices
5978
5979 =item local ${$x}
5980
5981 =item Unicode Character Database 4.0.0
5982
5983 =item Deprecation Warnings
5984
5985 =item Miscellaneous Enhancements
5986
5987 =back
5988
5989 =item Modules and Pragmata
5990
5991 =over 4
5992
5993 =item Updated Modules And Pragmata
5994
5995 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
5996 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
5997 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
5998 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
5999 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
6000 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
6001 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
6002 Win32::GetOSVersion
6003
6004 =back
6005
6006 =item Utility Changes
6007
6008 =item New Documentation
6009
6010 =item Installation and Configuration Improvements
6011
6012 =over 4
6013
6014 =item Platform-specific enhancements
6015
6016 =back
6017
6018 =item Selected Bug Fixes
6019
6020 =over 4
6021
6022 =item Closures, eval and lexicals
6023
6024 =item Generic fixes
6025
6026 =item Platform-specific fixes
6027
6028 =back
6029
6030 =item New or Changed Diagnostics
6031
6032 =over 4
6033
6034 =item Changed "A thread exited while %d threads were running"
6035
6036 =item Removed "Attempt to clear a restricted hash"
6037
6038 =item New "Illegal declaration of anonymous subroutine"
6039
6040 =item Changed "Invalid range "%s" in transliteration operator"
6041
6042 =item New "Missing control char name in \c"
6043
6044 =item New "Newline in left-justified string for %s"
6045
6046 =item New "Possible precedence problem on bitwise %c operator"
6047
6048 =item New "Pseudo-hashes are deprecated"
6049
6050 =item New "read() on %s filehandle %s"
6051
6052 =item New "5.005 threads are deprecated"
6053
6054 =item New "Tied variable freed while still in use"
6055
6056 =item New "To%s: illegal mapping '%s'"
6057
6058 =item New "Use of freed value in iteration"
6059
6060 =back
6061
6062 =item Changed Internals
6063
6064 =item New Tests
6065
6066 =item Known Problems
6067
6068 =over 4
6069
6070 =item Tied hashes in scalar context
6071
6072 =item Net::Ping 450_service and 510_ping_udp failures
6073
6074 =item B::C
6075
6076 =back
6077
6078 =item Platform Specific Problems
6079
6080 =over 4
6081
6082 =item EBCDIC Platforms
6083
6084 =item Cygwin 1.5 problems
6085
6086 =item HP-UX: HP cc warnings about sendfile and sendpath
6087
6088 =item IRIX: t/uni/tr_7jis.t falsely failing
6089
6090 =item Mac OS X: no usemymalloc
6091
6092 =item Tru64: No threaded builds with GNU cc (gcc)
6093
6094 =item Win32: sysopen, sysread, syswrite
6095
6096 =back
6097
6098 =item Future Directions
6099
6100 =item Reporting Bugs
6101
6102 =item SEE ALSO
6103
6104 =back
6105
6106 =head2 perl58delta - what is new for perl v5.8.0
6107
6108 =over 4
6109
6110 =item DESCRIPTION
6111
6112 =item Highlights In 5.8.0
6113
6114 =item Incompatible Changes
6115
6116 =over 4
6117
6118 =item Binary Incompatibility
6119
6120 =item 64-bit platforms and malloc
6121
6122 =item AIX Dynaloading
6123
6124 =item Attributes for C<my> variables now handled at run-time
6125
6126 =item Socket Extension Dynamic in VMS
6127
6128 =item IEEE-format Floating Point Default on OpenVMS Alpha
6129
6130 =item New Unicode Semantics (no more C<use utf8>, almost)
6131
6132 =item New Unicode Properties
6133
6134 =item REF(...) Instead Of SCALAR(...)
6135
6136 =item pack/unpack D/F recycled
6137
6138 =item glob() now returns filenames in alphabetical order
6139
6140 =item Deprecations
6141
6142 =back
6143
6144 =item Core Enhancements
6145
6146 =over 4
6147
6148 =item Unicode Overhaul
6149
6150 =item PerlIO is Now The Default
6151
6152 =item ithreads
6153
6154 =item Restricted Hashes
6155
6156 =item Safe Signals
6157
6158 =item Understanding of Numbers
6159
6160 =item Arrays now always interpolate into double-quoted strings [561]
6161
6162 =item Miscellaneous Changes
6163
6164 =back
6165
6166 =item Modules and Pragmata
6167
6168 =over 4
6169
6170 =item New Modules and Pragmata
6171
6172 =item Updated And Improved Modules and Pragmata
6173
6174 =back
6175
6176 =item Utility Changes
6177
6178 =item New Documentation
6179
6180 =item Performance Enhancements
6181
6182 =item Installation and Configuration Improvements
6183
6184 =over 4
6185
6186 =item Generic Improvements
6187
6188 =item New Or Improved Platforms
6189
6190 =back
6191
6192 =item Selected Bug Fixes
6193
6194 =over 4
6195
6196 =item Platform Specific Changes and Fixes
6197
6198 =back
6199
6200 =item New or Changed Diagnostics
6201
6202 =item Changed Internals
6203
6204 =item Security Vulnerability Closed [561]
6205
6206 =item New Tests
6207
6208 =item Known Problems
6209
6210 =over 4
6211
6212 =item The Compiler Suite Is Still Very Experimental
6213
6214 =item Localising Tied Arrays and Hashes Is Broken
6215
6216 =item Building Extensions Can Fail Because Of Largefiles
6217
6218 =item Modifying $_ Inside for(..)
6219
6220 =item mod_perl 1.26 Doesn't Build With Threaded Perl
6221
6222 =item lib/ftmp-security tests warn 'system possibly insecure'
6223
6224 =item libwww-perl (LWP) fails base/date #51
6225
6226 =item PDL failing some tests
6227
6228 =item Perl_get_sv
6229
6230 =item Self-tying Problems
6231
6232 =item ext/threads/t/libc
6233
6234 =item Failure of Thread (5.005-style) tests
6235
6236 =item Timing problems
6237
6238 =item Tied/Magical Array/Hash Elements Do Not Autovivify
6239
6240 =item Unicode in package/class and subroutine names does not work
6241
6242 =back
6243
6244 =item Platform Specific Problems
6245
6246 =over 4
6247
6248 =item AIX
6249
6250 =item Alpha systems with old gccs fail several tests
6251
6252 =item AmigaOS
6253
6254 =item BeOS
6255
6256 =item Cygwin "unable to remap"
6257
6258 =item Cygwin ndbm tests fail on FAT
6259
6260 =item DJGPP Failures
6261
6262 =item FreeBSD built with ithreads coredumps reading large directories
6263
6264 =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
6265
6266 =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
6267
6268 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
6269
6270 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
6271
6272 =item Linux With Sfio Fails op/misc Test 48
6273
6274 =item Mac OS X
6275
6276 =item Mac OS X dyld undefined symbols
6277
6278 =item OS/2 Test Failures
6279
6280 =item op/sprintf tests 91, 129, and 130
6281
6282 =item SCO
6283
6284 =item Solaris 2.5
6285
6286 =item Solaris x86 Fails Tests With -Duse64bitint
6287
6288 =item SUPER-UX (NEC SX)
6289
6290 =item Term::ReadKey not working on Win32
6291
6292 =item UNICOS/mk
6293
6294 =item UTS
6295
6296 =item VOS (Stratus)
6297
6298 =item VMS
6299
6300 =item Win32
6301
6302 =item XML::Parser not working
6303
6304 =item z/OS (OS/390)
6305
6306 =item Unicode Support on EBCDIC Still Spotty
6307
6308 =item Seen In Perl 5.7 But Gone Now
6309
6310 =back
6311
6312 =item Reporting Bugs
6313
6314 =item SEE ALSO
6315
6316 =item HISTORY
6317
6318 =back
6319
6320 =head2 perl573delta - what's new for perl v5.7.3
6321
6322 =over 4
6323
6324 =item DESCRIPTION
6325
6326 =item Changes
6327
6328 =item Reporting Bugs
6329
6330 =item SEE ALSO
6331
6332 =item HISTORY
6333
6334 =back
6335
6336 =head2 perl572delta - what's new for perl v5.7.2
6337
6338 =over 4
6339
6340 =item DESCRIPTION
6341
6342 =item Security Vulnerability Closed
6343
6344 =item Incompatible Changes
6345
6346 =over 4
6347
6348 =item 64-bit platforms and malloc
6349
6350 =item AIX Dynaloading
6351
6352 =item Socket Extension Dynamic in VMS
6353
6354 =item Different Definition of the Unicode Character Classes \p{In...}
6355
6356 =item Deprecations
6357
6358 =back
6359
6360 =item Core Enhancements
6361
6362 =item Modules and Pragmata
6363
6364 =over 4
6365
6366 =item New Modules and Distributions
6367
6368 =item Updated And Improved Modules and Pragmata
6369
6370 =back
6371
6372 =item Utility Changes
6373
6374 =item New Documentation
6375
6376 =item Installation and Configuration Improvements
6377
6378 =over 4
6379
6380 =item New Or Improved Platforms
6381
6382 =item Generic Improvements
6383
6384 =back
6385
6386 =item Selected Bug Fixes
6387
6388 =over 4
6389
6390 =item Platform Specific Changes and Fixes
6391
6392 =back
6393
6394 =item New or Changed Diagnostics
6395
6396 =item Source Code Enhancements
6397
6398 =over 4
6399
6400 =item MAGIC constants
6401
6402 =item Better commented code
6403
6404 =item Regex pre-/post-compilation items matched up
6405
6406 =item gcc -Wall
6407
6408 =back
6409
6410 =item New Tests
6411
6412 =item Known Problems
6413
6414 =over 4
6415
6416 =item AIX
6417
6418 =item Amiga Perl Invoking Mystery
6419
6420 =item lib/ftmp-security tests warn 'system possibly insecure'
6421
6422 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
6423
6424 =item HP-UX lib/io_multihomed Fails When LP64-Configured
6425
6426 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
6427
6428 =item Linux With Sfio Fails op/misc Test 48
6429
6430 =item OS/390
6431
6432 =item op/sprintf tests 129 and 130
6433
6434 =item  Failure of Thread tests
6435
6436 =item UNICOS
6437
6438 =item UTS
6439
6440 =item VMS
6441
6442 =item Win32
6443
6444 =item Localising a Tied Variable Leaks Memory
6445
6446 =item Self-tying of Arrays and Hashes Is Forbidden
6447
6448 =item Variable Attributes are not Currently Usable for Tieing
6449
6450 =item Building Extensions Can Fail Because Of Largefiles
6451
6452 =item The Compiler Suite Is Still Experimental
6453
6454 =item The Long Double Support is Still Experimental
6455
6456 =back
6457
6458 =item Reporting Bugs
6459
6460 =item SEE ALSO
6461
6462 =item HISTORY
6463
6464 =back
6465
6466 =head2 perl571delta - what's new for perl v5.7.1
6467
6468 =over 4
6469
6470 =item DESCRIPTION
6471
6472 =item Security Vulnerability Closed
6473
6474 =item Incompatible Changes
6475
6476 =item Core Enhancements
6477
6478 =over 4
6479
6480 =item AUTOLOAD Is Now Lvaluable
6481
6482 =item PerlIO is Now The Default
6483
6484 =item Signals Are Now Safe
6485
6486 =back
6487
6488 =item Modules and Pragmata
6489
6490 =over 4
6491
6492 =item New Modules
6493
6494 =item Updated And Improved Modules and Pragmata
6495
6496 =back
6497
6498 =item Performance Enhancements
6499
6500 =item Utility Changes
6501
6502 =item New Documentation
6503
6504 =over 4
6505
6506 =item perlclib
6507
6508 =item perliol
6509
6510 =item README.aix
6511
6512 =item README.bs2000
6513
6514 =item README.macos
6515
6516 =item README.mpeix
6517
6518 =item README.solaris
6519
6520 =item README.vos
6521
6522 =item Porting/repository.pod
6523
6524 =back
6525
6526 =item Installation and Configuration Improvements
6527
6528 =over 4
6529
6530 =item New Or Improved Platforms
6531
6532 =item Generic Improvements
6533
6534 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
6535 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
6536 d_strtoq, d_u32align, d_ualarm, d_usleep
6537
6538 =back
6539
6540 =item Selected Bug Fixes
6541
6542 =over 4
6543
6544 =item Platform Specific Changes and Fixes
6545
6546 =back
6547
6548 =item New or Changed Diagnostics
6549
6550 =item Changed Internals
6551
6552 =item New Tests
6553
6554 =item Known Problems
6555
6556 =over 4
6557
6558 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
6559
6560 =item lib/ftmp-security tests warn 'system possibly insecure'
6561
6562 =item lib/io_multihomed Fails In LP64-Configured HP-UX
6563
6564 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
6565
6566 =item lib/b test 19
6567
6568 =item Linux With Sfio Fails op/misc Test 48
6569
6570 =item sigaction test 13 in VMS
6571
6572 =item sprintf tests 129 and 130
6573
6574 =item  Failure of Thread tests
6575
6576 =item Localising a Tied Variable Leaks Memory
6577
6578 =item Self-tying of Arrays and Hashes Is Forbidden
6579
6580 =item Building Extensions Can Fail Because Of Largefiles
6581
6582 =item The Compiler Suite Is Still Experimental
6583
6584 =back
6585
6586 =item Reporting Bugs
6587
6588 =item SEE ALSO
6589
6590 =item HISTORY
6591
6592 =back
6593
6594 =head2 perl570delta - what's new for perl v5.7.0
6595
6596 =over 4
6597
6598 =item DESCRIPTION
6599
6600 =item Security Vulnerability Closed
6601
6602 =item Incompatible Changes
6603
6604 =item Core Enhancements
6605
6606 =item Modules and Pragmata
6607
6608 =over 4
6609
6610 =item New Modules
6611
6612 =item Updated And Improved Modules and Pragmata
6613
6614 =back
6615
6616 =item Utility Changes
6617
6618 =item New Documentation
6619
6620 =item Performance Enhancements
6621
6622 =item Installation and Configuration Improvements
6623
6624 =over 4
6625
6626 =item Generic Improvements
6627
6628 =back
6629
6630 =item Selected Bug Fixes
6631
6632 =over 4
6633
6634 =item Platform Specific Changes and Fixes
6635
6636 =back
6637
6638 =item New or Changed Diagnostics
6639
6640 =item Changed Internals
6641
6642 =item Known Problems
6643
6644 =over 4
6645
6646 =item Unicode Support Still Far From Perfect
6647
6648 =item EBCDIC Still A Lost Platform
6649
6650 =item Building Extensions Can Fail Because Of Largefiles
6651
6652 =item ftmp-security tests warn 'system possibly insecure'
6653
6654 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
6655
6656 =item Long Doubles Still Don't Work In Solaris
6657
6658 =item Linux With Sfio Fails op/misc Test 48
6659
6660 =item Storable tests fail in some platforms
6661
6662 =item Threads Are Still Experimental
6663
6664 =item The Compiler Suite Is Still Experimental
6665
6666 =back
6667
6668 =item Reporting Bugs
6669
6670 =item SEE ALSO
6671
6672 =item HISTORY
6673
6674 =back
6675
6676 =head2 perl561delta - what's new for perl v5.6.x
6677
6678 =over 4
6679
6680 =item DESCRIPTION
6681
6682 =item Summary of changes between 5.6.0 and 5.6.1
6683
6684 =over 4
6685
6686 =item Security Issues
6687
6688 =item Core bug fixes
6689
6690 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
6691 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
6692 references to special variables, Lexical warnings, Spurious warnings and
6693 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
6694 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
6695 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
6696 Module;>, Tests
6697
6698 =item Core features
6699
6700 =item Configuration issues
6701
6702 =item Documentation
6703
6704 =item Bundled modules
6705
6706 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
6707 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
6708 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
6709 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
6710
6711 =item Platform-specific improvements
6712
6713 NCR MP-RAS, NonStop-UX
6714
6715 =back
6716
6717 =item Core Enhancements
6718
6719 =over 4
6720
6721 =item Interpreter cloning, threads, and concurrency
6722
6723 =item Lexically scoped warning categories
6724
6725 =item Unicode and UTF-8 support
6726
6727 =item Support for interpolating named characters
6728
6729 =item "our" declarations
6730
6731 =item Support for strings represented as a vector of ordinals
6732
6733 =item Improved Perl version numbering system
6734
6735 =item New syntax for declaring subroutine attributes
6736
6737 =item File and directory handles can be autovivified
6738
6739 =item open() with more than two arguments
6740
6741 =item 64-bit support
6742
6743 =item Large file support
6744
6745 =item Long doubles
6746
6747 =item "more bits"
6748
6749 =item Enhanced support for sort() subroutines
6750
6751 =item C<sort $coderef @foo> allowed
6752
6753 =item File globbing implemented internally
6754
6755 =item Support for CHECK blocks
6756
6757 =item POSIX character class syntax [: :] supported
6758
6759 =item Better pseudo-random number generator
6760
6761 =item Improved C<qw//> operator
6762
6763 =item Better worst-case behavior of hashes
6764
6765 =item pack() format 'Z' supported
6766
6767 =item pack() format modifier '!' supported
6768
6769 =item pack() and unpack() support counted strings
6770
6771 =item Comments in pack() templates
6772
6773 =item Weak references
6774
6775 =item Binary numbers supported
6776
6777 =item Lvalue subroutines
6778
6779 =item Some arrows may be omitted in calls through references
6780
6781 =item Boolean assignment operators are legal lvalues
6782
6783 =item exists() is supported on subroutine names
6784
6785 =item exists() and delete() are supported on array elements
6786
6787 =item Pseudo-hashes work better
6788
6789 =item Automatic flushing of output buffers
6790
6791 =item Better diagnostics on meaningless filehandle operations
6792
6793 =item Where possible, buffered data discarded from duped input filehandle
6794
6795 =item eof() has the same old magic as <>
6796
6797 =item binmode() can be used to set :crlf and :raw modes
6798
6799 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6800
6801 =item system(), backticks and pipe open now reflect exec() failure
6802
6803 =item Improved diagnostics
6804
6805 =item Diagnostics follow STDERR
6806
6807 =item More consistent close-on-exec behavior
6808
6809 =item syswrite() ease-of-use
6810
6811 =item Better syntax checks on parenthesized unary operators
6812
6813 =item Bit operators support full native integer width
6814
6815 =item Improved security features
6816
6817 =item More functional bareword prototype (*)
6818
6819 =item C<require> and C<do> may be overridden
6820
6821 =item $^X variables may now have names longer than one character
6822
6823 =item New variable $^C reflects C<-c> switch
6824
6825 =item New variable $^V contains Perl version as a string
6826
6827 =item Optional Y2K warnings
6828
6829 =item Arrays now always interpolate into double-quoted strings
6830
6831 =back
6832
6833 =item Modules and Pragmata
6834
6835 =over 4
6836
6837 =item Modules
6838
6839 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6840 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6841 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6842 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6843 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6844 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6845 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6846 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6847
6848 =item Pragmata
6849
6850 =back
6851
6852 =item Utility Changes
6853
6854 =over 4
6855
6856 =item dprofpp
6857
6858 =item find2perl
6859
6860 =item h2xs
6861
6862 =item perlcc
6863
6864 =item perldoc
6865
6866 =item The Perl Debugger
6867
6868 =back
6869
6870 =item Improved Documentation
6871
6872 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6873 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6874 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6875 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6876
6877 =item Performance enhancements
6878
6879 =over 4
6880
6881 =item Simple sort() using { $a <=> $b } and the like are optimized
6882
6883 =item Optimized assignments to lexical variables
6884
6885 =item Faster subroutine calls
6886
6887 =item delete(), each(), values() and hash iteration are faster
6888
6889 =back
6890
6891 =item Installation and Configuration Improvements
6892
6893 =over 4
6894
6895 =item -Dusethreads means something different
6896
6897 =item New Configure flags
6898
6899 =item Threadedness and 64-bitness now more daring
6900
6901 =item Long Doubles
6902
6903 =item -Dusemorebits
6904
6905 =item -Duselargefiles
6906
6907 =item installusrbinperl
6908
6909 =item SOCKS support
6910
6911 =item C<-A> flag
6912
6913 =item Enhanced Installation Directories
6914
6915 =item gcc automatically tried if 'cc' does not seem to be working
6916
6917 =back
6918
6919 =item Platform specific changes
6920
6921 =over 4
6922
6923 =item Supported platforms
6924
6925 =item DOS
6926
6927 =item OS390 (OpenEdition MVS)
6928
6929 =item VMS
6930
6931 =item Win32
6932
6933 =back
6934
6935 =item Significant bug fixes
6936
6937 =over 4
6938
6939 =item <HANDLE> on empty files
6940
6941 =item C<eval '...'> improvements
6942
6943 =item All compilation errors are true errors
6944
6945 =item Implicitly closed filehandles are safer
6946
6947 =item Behavior of list slices is more consistent
6948
6949 =item C<(\$)> prototype and C<$foo{a}>
6950
6951 =item C<goto &sub> and AUTOLOAD
6952
6953 =item C<-bareword> allowed under C<use integer>
6954
6955 =item Failures in DESTROY()
6956
6957 =item Locale bugs fixed
6958
6959 =item Memory leaks
6960
6961 =item Spurious subroutine stubs after failed subroutine calls
6962
6963 =item Taint failures under C<-U>
6964
6965 =item END blocks and the C<-c> switch
6966
6967 =item Potential to leak DATA filehandles
6968
6969 =back
6970
6971 =item New or Changed Diagnostics
6972
6973 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6974 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6975 / cannot take a count, / must be followed by a, A or Z, / must be followed
6976 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6977 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6978 passed through, /%s/ should probably be written as "%s", %s() called too
6979 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6980 argument is not a HASH or ARRAY element or slice, %s argument is not a
6981 subroutine name, %s package attribute may clash with future reserved word:
6982 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6983 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6984 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6985 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6986 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6987 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6988 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6989 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6990 weaken a nonreference, Character class [:%s:] unknown, Character class
6991 syntax [%s] belongs inside character classes, Constant is not %s reference,
6992 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6993 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6994 "local" instead of "our"?), Document contains no data, entering effective
6995 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6996 output, flock() on closed filehandle %s, Global symbol "%s" requires
6997 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6998 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6999 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
7000 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
7001 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
7002 separator character %s in attribute list, Invalid separator character %s in
7003 subroutine attribute list, leaving effective %s failed, Lvalue subs
7004 returning %s not implemented yet, Method %s not permitted, Missing
7005 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
7006 No %s specified for -%c, No package name allowed for variable %s in "our",
7007 No space allowed after -%c, no UTC offset information; assuming local time
7008 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
7009 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
7010 around "%s" list, Possible unintended interpolation of %s in string,
7011 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
7012 instead, Premature end of script headers, Repeat count in pack overflows,
7013 Repeat count in unpack overflows, realloc() of freed memory ignored,
7014 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
7015 zero-length expression, switching effective %s is not implemented, This
7016 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
7017 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
7018 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
7019 escape \\%c passed through, Unterminated attribute parameter in attribute
7020 list, Unterminated attribute list, Unterminated attribute parameter in
7021 subroutine attribute list, Unterminated subroutine attribute list, Value of
7022 CLI symbol "%s" too long, Version number must be a constant number
7023
7024 =item New tests
7025
7026 =item Incompatible Changes
7027
7028 =over 4
7029
7030 =item Perl Source Incompatibilities
7031
7032 CHECK is a new keyword, Treatment of list slices of undef has changed,
7033 Format of $English::PERL_VERSION is different, Literals of the form
7034 C<1.2.3> parse differently, Possibly changed pseudo-random number
7035 generator, Hashing function for hash keys has changed, C<undef> fails on
7036 read only values, Close-on-exec bit may be set on pipe and socket handles,
7037 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
7038 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
7039 Text of some diagnostic output has changed, C<%@> has been removed,
7040 Parenthesized not() behaves like a list operator, Semantics of bareword
7041 prototype C<(*)> have changed, Semantics of bit operators may have changed
7042 on 64-bit platforms, More builtins taint their results
7043
7044 =item C Source Incompatibilities
7045
7046 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
7047
7048 =item Compatible C Source API Changes
7049
7050 C<PATCHLEVEL> is now C<PERL_VERSION>
7051
7052 =item Binary Incompatibilities
7053
7054 =back
7055
7056 =item Known Problems
7057
7058 =over 4
7059
7060 =item Localizing a tied hash element may leak memory
7061
7062 =item Known test failures
7063
7064 =item EBCDIC platforms not fully supported
7065
7066 =item UNICOS/mk CC failures during Configure run
7067
7068 =item Arrow operator and arrays
7069
7070 =item Experimental features
7071
7072 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
7073 pseudo-hash data type, The Compiler suite, Internal implementation of file
7074 globbing, The DB module, The regular expression code constructs:
7075
7076 =back
7077
7078 =item Obsolete Diagnostics
7079
7080 Character class syntax [: :] is reserved for future extensions, Ill-formed
7081 logical name |%s| in prime_env_iter, In string, @%s now must be written as
7082 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
7083 to mean "${$}<digit>" is deprecated
7084
7085 =item Reporting Bugs
7086
7087 =item SEE ALSO
7088
7089 =item HISTORY
7090
7091 =back
7092
7093 =head2 perl56delta - what's new for perl v5.6.0
7094
7095 =over 4
7096
7097 =item DESCRIPTION
7098
7099 =item Core Enhancements
7100
7101 =over 4
7102
7103 =item Interpreter cloning, threads, and concurrency
7104
7105 =item Lexically scoped warning categories
7106
7107 =item Unicode and UTF-8 support
7108
7109 =item Support for interpolating named characters
7110
7111 =item "our" declarations
7112
7113 =item Support for strings represented as a vector of ordinals
7114
7115 =item Improved Perl version numbering system
7116
7117 =item New syntax for declaring subroutine attributes
7118
7119 =item File and directory handles can be autovivified
7120
7121 =item open() with more than two arguments
7122
7123 =item 64-bit support
7124
7125 =item Large file support
7126
7127 =item Long doubles
7128
7129 =item "more bits"
7130
7131 =item Enhanced support for sort() subroutines
7132
7133 =item C<sort $coderef @foo> allowed
7134
7135 =item File globbing implemented internally
7136
7137 =item Support for CHECK blocks
7138
7139 =item POSIX character class syntax [: :] supported
7140
7141 =item Better pseudo-random number generator
7142
7143 =item Improved C<qw//> operator
7144
7145 =item Better worst-case behavior of hashes
7146
7147 =item pack() format 'Z' supported
7148
7149 =item pack() format modifier '!' supported
7150
7151 =item pack() and unpack() support counted strings
7152
7153 =item Comments in pack() templates
7154
7155 =item Weak references
7156
7157 =item Binary numbers supported
7158
7159 =item Lvalue subroutines
7160
7161 =item Some arrows may be omitted in calls through references
7162
7163 =item Boolean assignment operators are legal lvalues
7164
7165 =item exists() is supported on subroutine names
7166
7167 =item exists() and delete() are supported on array elements
7168
7169 =item Pseudo-hashes work better
7170
7171 =item Automatic flushing of output buffers
7172
7173 =item Better diagnostics on meaningless filehandle operations
7174
7175 =item Where possible, buffered data discarded from duped input filehandle
7176
7177 =item eof() has the same old magic as <>
7178
7179 =item binmode() can be used to set :crlf and :raw modes
7180
7181 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
7182
7183 =item system(), backticks and pipe open now reflect exec() failure
7184
7185 =item Improved diagnostics
7186
7187 =item Diagnostics follow STDERR
7188
7189 =item More consistent close-on-exec behavior
7190
7191 =item syswrite() ease-of-use
7192
7193 =item Better syntax checks on parenthesized unary operators
7194
7195 =item Bit operators support full native integer width
7196
7197 =item Improved security features
7198
7199 =item More functional bareword prototype (*)
7200
7201 =item C<require> and C<do> may be overridden
7202
7203 =item $^X variables may now have names longer than one character
7204
7205 =item New variable $^C reflects C<-c> switch
7206
7207 =item New variable $^V contains Perl version as a string
7208
7209 =item Optional Y2K warnings
7210
7211 =item Arrays now always interpolate into double-quoted strings
7212
7213 =back
7214
7215 =item Modules and Pragmata
7216
7217 =over 4
7218
7219 =item Modules
7220
7221 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
7222 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
7223 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
7224 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
7225 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
7226 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
7227 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
7228 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
7229
7230 =item Pragmata
7231
7232 =back
7233
7234 =item Utility Changes
7235
7236 =over 4
7237
7238 =item dprofpp
7239
7240 =item find2perl
7241
7242 =item h2xs
7243
7244 =item perlcc
7245
7246 =item perldoc
7247
7248 =item The Perl Debugger
7249
7250 =back
7251
7252 =item Improved Documentation
7253
7254 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
7255 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
7256 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
7257 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
7258
7259 =item Performance enhancements
7260
7261 =over 4
7262
7263 =item Simple sort() using { $a <=> $b } and the like are optimized
7264
7265 =item Optimized assignments to lexical variables
7266
7267 =item Faster subroutine calls
7268
7269 =item delete(), each(), values() and hash iteration are faster
7270
7271 =back
7272
7273 =item Installation and Configuration Improvements
7274
7275 =over 4
7276
7277 =item -Dusethreads means something different
7278
7279 =item New Configure flags
7280
7281 =item Threadedness and 64-bitness now more daring
7282
7283 =item Long Doubles
7284
7285 =item -Dusemorebits
7286
7287 =item -Duselargefiles
7288
7289 =item installusrbinperl
7290
7291 =item SOCKS support
7292
7293 =item C<-A> flag
7294
7295 =item Enhanced Installation Directories
7296
7297 =back
7298
7299 =item Platform specific changes
7300
7301 =over 4
7302
7303 =item Supported platforms
7304
7305 =item DOS
7306
7307 =item OS390 (OpenEdition MVS)
7308
7309 =item VMS
7310
7311 =item Win32
7312
7313 =back
7314
7315 =item Significant bug fixes
7316
7317 =over 4
7318
7319 =item <HANDLE> on empty files
7320
7321 =item C<eval '...'> improvements
7322
7323 =item All compilation errors are true errors
7324
7325 =item Implicitly closed filehandles are safer
7326
7327 =item Behavior of list slices is more consistent
7328
7329 =item C<(\$)> prototype and C<$foo{a}>
7330
7331 =item C<goto &sub> and AUTOLOAD
7332
7333 =item C<-bareword> allowed under C<use integer>
7334
7335 =item Failures in DESTROY()
7336
7337 =item Locale bugs fixed
7338
7339 =item Memory leaks
7340
7341 =item Spurious subroutine stubs after failed subroutine calls
7342
7343 =item Taint failures under C<-U>
7344
7345 =item END blocks and the C<-c> switch
7346
7347 =item Potential to leak DATA filehandles
7348
7349 =back
7350
7351 =item New or Changed Diagnostics
7352
7353 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
7354 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
7355 / cannot take a count, / must be followed by a, A or Z, / must be followed
7356 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
7357 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
7358 passed through, /%s/ should probably be written as "%s", %s() called too
7359 early to check prototype, %s argument is not a HASH or ARRAY element, %s
7360 argument is not a HASH or ARRAY element or slice, %s argument is not a
7361 subroutine name, %s package attribute may clash with future reserved word:
7362 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
7363 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
7364 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
7365 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
7366 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
7367 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
7368 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
7369 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
7370 weaken a nonreference, Character class [:%s:] unknown, Character class
7371 syntax [%s] belongs inside character classes, Constant is not %s reference,
7372 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
7373 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
7374 "local" instead of "our"?), Document contains no data, entering effective
7375 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
7376 output, flock() on closed filehandle %s, Global symbol "%s" requires
7377 explicit package name, Hexadecimal number > 0xffffffff non-portable,
7378 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
7379 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
7380 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
7381 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
7382 separator character %s in attribute list, Invalid separator character %s in
7383 subroutine attribute list, leaving effective %s failed, Lvalue subs
7384 returning %s not implemented yet, Method %s not permitted, Missing
7385 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
7386 No %s specified for -%c, No package name allowed for variable %s in "our",
7387 No space allowed after -%c, no UTC offset information; assuming local time
7388 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
7389 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
7390 around "%s" list, Possible unintended interpolation of %s in string,
7391 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
7392 instead, Premature end of script headers, Repeat count in pack overflows,
7393 Repeat count in unpack overflows, realloc() of freed memory ignored,
7394 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
7395 zero-length expression, switching effective %s is not implemented, This
7396 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
7397 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
7398 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
7399 escape \\%c passed through, Unterminated attribute parameter in attribute
7400 list, Unterminated attribute list, Unterminated attribute parameter in
7401 subroutine attribute list, Unterminated subroutine attribute list, Value of
7402 CLI symbol "%s" too long, Version number must be a constant number
7403
7404 =item New tests
7405
7406 =item Incompatible Changes
7407
7408 =over 4
7409
7410 =item Perl Source Incompatibilities
7411
7412 CHECK is a new keyword, Treatment of list slices of undef has changed,
7413 Format of $English::PERL_VERSION is different, Literals of the form
7414 C<1.2.3> parse differently, Possibly changed pseudo-random number
7415 generator, Hashing function for hash keys has changed, C<undef> fails on
7416 read only values, Close-on-exec bit may be set on pipe and socket handles,
7417 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
7418 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
7419 Text of some diagnostic output has changed, C<%@> has been removed,
7420 Parenthesized not() behaves like a list operator, Semantics of bareword
7421 prototype C<(*)> have changed, Semantics of bit operators may have changed
7422 on 64-bit platforms, More builtins taint their results
7423
7424 =item C Source Incompatibilities
7425
7426 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
7427
7428 =item Compatible C Source API Changes
7429
7430 C<PATCHLEVEL> is now C<PERL_VERSION>
7431
7432 =item Binary Incompatibilities
7433
7434 =back
7435
7436 =item Known Problems
7437
7438 =over 4
7439
7440 =item Thread test failures
7441
7442 =item EBCDIC platforms not supported
7443
7444 =item In 64-bit HP-UX the lib/io_multihomed test may hang
7445
7446 =item NEXTSTEP 3.3 POSIX test failure
7447
7448 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
7449 gcc
7450
7451 =item UNICOS/mk CC failures during Configure run
7452
7453 =item Arrow operator and arrays
7454
7455 =item Experimental features
7456
7457 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
7458 pseudo-hash data type, The Compiler suite, Internal implementation of file
7459 globbing, The DB module, The regular expression code constructs:
7460
7461 =back
7462
7463 =item Obsolete Diagnostics
7464
7465 Character class syntax [: :] is reserved for future extensions, Ill-formed
7466 logical name |%s| in prime_env_iter, In string, @%s now must be written as
7467 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
7468 to mean "${$}<digit>" is deprecated
7469
7470 =item Reporting Bugs
7471
7472 =item SEE ALSO
7473
7474 =item HISTORY
7475
7476 =back
7477
7478 =head2 perl5005delta - what's new for perl5.005
7479
7480 =over 4
7481
7482 =item DESCRIPTION
7483
7484 =item About the new versioning system
7485
7486 =item Incompatible Changes
7487
7488 =over 4
7489
7490 =item WARNING:  This version is not binary compatible with Perl 5.004.
7491
7492 =item Default installation structure has changed
7493
7494 =item Perl Source Compatibility
7495
7496 =item C Source Compatibility
7497
7498 =item Binary Compatibility
7499
7500 =item Security fixes may affect compatibility
7501
7502 =item Relaxed new mandatory warnings introduced in 5.004
7503
7504 =item Licensing
7505
7506 =back
7507
7508 =item Core Changes
7509
7510 =over 4
7511
7512 =item Threads
7513
7514 =item Compiler
7515
7516 =item Regular Expressions
7517
7518 Many new and improved optimizations, Many bug fixes, New regular expression
7519 constructs, New operator for precompiled regular expressions, Other
7520 improvements, Incompatible changes
7521
7522 =item   Improved malloc()
7523
7524 =item Quicksort is internally implemented
7525
7526 =item Reliable signals
7527
7528 =item Reliable stack pointers
7529
7530 =item More generous treatment of carriage returns
7531
7532 =item Memory leaks
7533
7534 =item Better support for multiple interpreters
7535
7536 =item Behavior of local() on array and hash elements is now well-defined
7537
7538 =item C<%!> is transparently tied to the L<Errno> module
7539
7540 =item Pseudo-hashes are supported
7541
7542 =item C<EXPR foreach EXPR> is supported
7543
7544 =item Keywords can be globally overridden
7545
7546 =item C<$^E> is meaningful on Win32
7547
7548 =item C<foreach (1..1000000)> optimized
7549
7550 =item C<Foo::> can be used as implicitly quoted package name
7551
7552 =item C<exists $Foo::{Bar::}> tests existence of a package
7553
7554 =item Better locale support
7555
7556 =item Experimental support for 64-bit platforms
7557
7558 =item prototype() returns useful results on builtins
7559
7560 =item Extended support for exception handling
7561
7562 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
7563
7564 =item All C<printf> format conversions are handled internally
7565
7566 =item New C<INIT> keyword
7567
7568 =item New C<lock> keyword
7569
7570 =item New C<qr//> operator
7571
7572 =item C<our> is now a reserved word
7573
7574 =item Tied arrays are now fully supported
7575
7576 =item Tied handles support is better
7577
7578 =item 4th argument to substr
7579
7580 =item Negative LENGTH argument to splice
7581
7582 =item Magic lvalues are now more magical
7583
7584 =item <> now reads in records
7585
7586 =back
7587
7588 =item Supported Platforms
7589
7590 =over 4
7591
7592 =item New Platforms
7593
7594 =item Changes in existing support
7595
7596 =back
7597
7598 =item Modules and Pragmata
7599
7600 =over 4
7601
7602 =item New Modules
7603
7604 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
7605 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
7606 Thread, attrs, fields, re
7607
7608 =item Changes in existing modules
7609
7610 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
7611 MakeMaker, CPAN, Cwd
7612
7613 =back
7614
7615 =item Utility Changes
7616
7617 =item Documentation Changes
7618
7619 =item New Diagnostics
7620
7621 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
7622 while coercing array into hash, Bareword "%s" refers to nonexistent
7623 package, Can't call method "%s" on an undefined value, Can't check
7624 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
7625 goto subroutine from an eval-string, Can't localize pseudo-hash element,
7626 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
7627 for "%s", Character class syntax [. .] is reserved for future extensions,
7628 Character class syntax [: :] is reserved for future extensions, Character
7629 class syntax [= =] is reserved for future extensions, %s: Eval-group in
7630 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
7631 Eval-group not allowed at run time, Explicit blessing to '' (assuming
7632 package main), Illegal hex digit ignored, No such array field, No such
7633 field "%s" in variable %s of type %s, Out of memory during ridiculously
7634 large request, Range iterator outside integer range, Recursive inheritance
7635 detected while looking for method '%s' %s, Reference found where even-sized
7636 list expected, Undefined value assigned to typeglob, Use of reserved word
7637 "%s" is deprecated, perl: warning: Setting locale failed
7638
7639 =item Obsolete Diagnostics
7640
7641 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
7642 temporary file, regexp too big
7643
7644 =item Configuration Changes
7645
7646 =item BUGS
7647
7648 =item SEE ALSO
7649
7650 =item HISTORY
7651
7652 =back
7653
7654 =head2 perl5004delta - what's new for perl5.004
7655
7656 =over 4
7657
7658 =item DESCRIPTION
7659
7660 =item Supported Environments
7661
7662 =item Core Changes
7663
7664 =over 4
7665
7666 =item List assignment to %ENV works
7667
7668 =item Change to "Can't locate Foo.pm in @INC" error
7669
7670 =item Compilation option: Binary compatibility with 5.003
7671
7672 =item $PERL5OPT environment variable
7673
7674 =item Limitations on B<-M>, B<-m>, and B<-T> options
7675
7676 =item More precise warnings
7677
7678 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
7679
7680 =item Previously deprecated %OVERLOAD is no longer usable
7681
7682 =item Subroutine arguments created only when they're modified
7683
7684 =item Group vector changeable with C<$)>
7685
7686 =item Fixed parsing of $$<digit>, &$<digit>, etc.
7687
7688 =item Fixed localization of $<digit>, $&, etc.
7689
7690 =item No resetting of $. on implicit close
7691
7692 =item C<wantarray> may return undef
7693
7694 =item C<eval EXPR> determines value of EXPR in scalar context
7695
7696 =item Changes to tainting checks
7697
7698 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
7699 spawning if tainted $TERM doesn't look like a terminal name
7700
7701 =item New Opcode module and revised Safe module
7702
7703 =item Embedding improvements
7704
7705 =item Internal change: FileHandle class based on IO::* classes
7706
7707 =item Internal change: PerlIO abstraction interface
7708
7709 =item New and changed syntax
7710
7711 $coderef->(PARAMS)
7712
7713 =item New and changed builtin constants
7714
7715 __PACKAGE__
7716
7717 =item New and changed builtin variables
7718
7719 $^E, $^H, $^M
7720
7721 =item New and changed builtin functions
7722
7723 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
7724 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
7725 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
7726 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
7727 nested C<sub{}> closures work now, formats work right on changing lexicals
7728
7729 =item New builtin methods
7730
7731 isa(CLASS), can(METHOD), VERSION( [NEED] )
7732
7733 =item TIEHANDLE now supported
7734
7735 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
7736 LIST, READLINE this, GETC this, DESTROY this
7737
7738 =item Malloc enhancements
7739
7740 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
7741
7742 =item Miscellaneous efficiency enhancements
7743
7744 =back
7745
7746 =item Support for More Operating Systems
7747
7748 =over 4
7749
7750 =item Win32
7751
7752 =item Plan 9
7753
7754 =item QNX
7755
7756 =item AmigaOS
7757
7758 =back
7759
7760 =item Pragmata
7761
7762 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
7763 constant NAME => VALUE, use locale, use ops, use vmsish
7764
7765 =item Modules
7766
7767 =over 4
7768
7769 =item Required Updates
7770
7771 =item Installation directories
7772
7773 =item Module information summary
7774
7775 =item Fcntl
7776
7777 =item IO
7778
7779 =item Math::Complex
7780
7781 =item Math::Trig
7782
7783 =item DB_File
7784
7785 =item Net::Ping
7786
7787 =item Object-oriented overrides for builtin operators
7788
7789 =back
7790
7791 =item Utility Changes
7792
7793 =over 4
7794
7795 =item pod2html
7796
7797 Sends converted HTML to standard output
7798
7799 =item xsubpp
7800
7801 C<void> XSUBs now default to returning nothing
7802
7803 =back
7804
7805 =item C Language API Changes
7806
7807 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
7808 manipulating hashes
7809
7810 =item Documentation Changes
7811
7812 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
7813 L<perlmodlib>, L<perldebug>, L<perlsec>
7814
7815 =item New Diagnostics
7816
7817 "my" variable %s masks earlier declaration in same scope, %s argument is
7818 not a HASH element or slice, Allocation too large: %lx, Allocation too
7819 large, Applying %s to %s will act on scalar(%s), Attempt to free
7820 nonexistent shared string, Attempt to use reference as lvalue in substr,
7821 Bareword "%s" refers to nonexistent package, Can't redefine active sort
7822 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
7823 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
7824 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
7825 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
7826 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
7827 %s, Integer overflow in hex number, Integer overflow in octal number,
7828 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
7829 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
7830 possible typo, Null picture in formline, Offset outside string, Out of
7831 memory!, Out of memory during request for %s, panic: frexp, Possible
7832 attempt to put comments in qw() list, Possible attempt to separate words
7833 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
7834 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
7835 option, untie attempted while %d inner references still exist, Unrecognized
7836 character %s, Unsupported function fork, Use of "$$<digit>" to mean
7837 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
7838 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
7839 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
7840 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
7841 long, Process terminated by SIG%s
7842
7843 =item BUGS
7844
7845 =item SEE ALSO
7846
7847 =item HISTORY
7848
7849 =back
7850
7851 =head2 perlartistic - the Perl Artistic License
7852
7853 =over 4
7854
7855 =item SYNOPSIS
7856
7857 =item DESCRIPTION
7858
7859 =item The "Artistic License"
7860
7861 =over 4
7862
7863 =item Preamble
7864
7865 =item Definitions
7866
7867 "Package", "Standard Version", "Copyright Holder", "You", "Reasonable
7868 copying fee", "Freely Available"
7869
7870 =item Conditions
7871
7872 a), b), c), d), a), b), c), d)
7873
7874 =back
7875
7876 =back
7877
7878 =head2 perlgpl - the GNU General Public License, version 2
7879
7880 =over 4
7881
7882 =item SYNOPSIS
7883
7884 =back
7885
7886 =over 4
7887
7888 =item DESCRIPTION
7889
7890 =item GNU GENERAL PUBLIC LICENSE
7891
7892 =back
7893
7894 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
7895
7896 =over 4
7897
7898 =item DESCRIPTION
7899
7900 =over 4
7901
7902 =item Compiling Perl 5 on AIX
7903
7904 =item OS level
7905
7906 =item Building Dynamic Extensions on AIX
7907
7908 =item The IBM ANSI C Compiler
7909
7910 =item The usenm option
7911
7912 =item Using GNU's gcc for building perl
7913
7914 =item Using Large Files with Perl
7915
7916 =item Threaded Perl
7917
7918 =item 64-bit Perl
7919
7920 =item AIX 4.2 and extensions using C++ with statics
7921
7922 =back
7923
7924 =item AUTHOR
7925
7926 =item DATE
7927
7928 =back
7929
7930 =head2 perlamiga - Perl under Amiga OS
7931
7932 =over 4
7933
7934 =item NOTE
7935
7936 =item SYNOPSIS
7937
7938 =back
7939
7940 =over 4
7941
7942 =item DESCRIPTION
7943
7944 =over 4
7945
7946 =item Prerequisites for Compiling Perl on AmigaOS
7947
7948 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
7949
7950 =item Starting Perl programs under AmigaOS
7951
7952 =item Shortcomings of Perl under AmigaOS
7953
7954 =back
7955
7956 =item INSTALLATION
7957
7958 =item Accessing documentation
7959
7960 =over 4
7961
7962 =item Manpages for Perl on AmigaOS
7963
7964 =item Perl HTML Documentation on AmigaOS
7965
7966 =item Perl GNU Info Files on AmigaOS
7967
7968 =item Perl LaTeX Documentation on AmigaOS
7969
7970 =back
7971
7972 =item BUILDING PERL ON AMIGAOS
7973
7974 =over 4
7975
7976 =item Build Prerequisites for Perl on AmigaOS
7977
7978 =item Getting the Perl Source for AmigaOS
7979
7980 =item Making Perl on AmigaOS
7981
7982 =item Testing Perl on AmigaOS
7983
7984 =item Installing the built Perl on AmigaOS
7985
7986 =back
7987
7988 =item PERL 5.8.0 BROKEN IN AMIGAOS
7989
7990 =item AUTHORS
7991
7992 =item SEE ALSO
7993
7994 =back
7995
7996 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
7997
7998 =over 4
7999
8000 =item DESCRIPTION
8001
8002 =item AUTHOR
8003
8004 =back
8005
8006 =head2 perlbeos, README.beos - Perl version 5.8+ on BeOS
8007
8008 =over 4
8009
8010 =item DESCRIPTION
8011
8012 =item BUILD AND INSTALL
8013
8014 =over 4
8015
8016 =item Requirements
8017
8018 =item Configure
8019
8020 =item Build
8021
8022 =item Install
8023
8024 =back
8025
8026 =item KNOWN PROBLEMS
8027
8028 =item CONTACT
8029
8030 =back
8031
8032 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
8033
8034 =over 4
8035
8036 =item SYNOPSIS
8037
8038 =item DESCRIPTION
8039
8040 =over 4
8041
8042 =item gzip on BS2000
8043
8044 =item bison on BS2000
8045
8046 =item Unpacking Perl Distribution on BS2000
8047
8048 =item Compiling Perl on BS2000
8049
8050 =item Testing Perl on BS2000
8051
8052 =item Installing Perl on BS2000
8053
8054 =item Using Perl in the Posix-Shell of BS2000
8055
8056 =item Using Perl in "native" BS2000
8057
8058 =item Floating point anomalies on BS2000
8059
8060 =item Using PerlIO and different encodings on ASCII and EBCDIC partitions
8061
8062 =back
8063
8064 =item AUTHORS
8065
8066 =item SEE ALSO
8067
8068 =over 4
8069
8070 =item Mailing list
8071
8072 =back
8073
8074 =item HISTORY
8075
8076 =back
8077
8078 =head2 perlce - Perl for WinCE
8079
8080 =over 4
8081
8082 =item DESCRIPTION
8083
8084 =item BUILD
8085
8086 =over 4
8087
8088 =item Tools & SDK
8089
8090 Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's
8091 celib-sources, Rainer Keuchel's console-sources
8092
8093 =item Make
8094
8095 go to ./wince subdirectory, edit file compile.bat, run    compile.bat, run 
8096   compile.bat dist
8097
8098 =back
8099
8100 =item ACKNOWLEDGEMENTS
8101
8102 =item AUTHORS
8103
8104 =back
8105
8106 =head2 perlcygwin, README.cygwin - Perl for Cygwin
8107
8108 =over 4
8109
8110 =item SYNOPSIS
8111
8112 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
8113
8114 =over 4
8115
8116 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
8117
8118 =item Cygwin Configuration
8119
8120 C<PATH>, I<nroff>, Permissions
8121
8122 =back
8123
8124 =item CONFIGURE PERL ON CYGWIN
8125
8126 =over 4
8127
8128 =item Stripping Perl Binaries on Cygwin
8129
8130 =item Optional Libraries for Perl on Cygwin
8131
8132 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
8133 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
8134
8135 =item Configure-time Options for Perl on Cygwin
8136
8137 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
8138 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
8139 C<-Dmksymlinks>
8140
8141 =item Suspicious Warnings on Cygwin
8142
8143 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
8144
8145 =back
8146
8147 =item MAKE ON CYGWIN
8148
8149 =over 4
8150
8151 =item Errors on Cygwin
8152
8153 =item ld2 on Cygwin
8154
8155 =back
8156
8157 =item TEST ON CYGWIN
8158
8159 =over 4
8160
8161 =item File Permissions on Cygwin
8162
8163 =item NDBM_File and ODBM_File do not work on FAT filesystems
8164
8165 =item C<fork()> failures in io_* tests
8166
8167 =back
8168
8169 =item Specific features of the Cygwin port
8170
8171 =over 4
8172
8173 =item Script Portability on Cygwin
8174
8175 Pathnames, Text/Binary, PerlIO, F<.exe>, cygwin vs. windows process ids,
8176 C<chown()>, Miscellaneous
8177
8178 =item Prebuilt methods:
8179
8180 C<Cwd::cwd>, C<Cygwin::pid_to_winpid>, C<Cygwin::winpid_to_pid>
8181
8182 =back
8183
8184 =item INSTALL PERL ON CYGWIN
8185
8186 =item MANIFEST ON CYGWIN
8187
8188 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
8189 Source, Compiled Module Source, Perl Modules/Scripts
8190
8191 =item BUGS ON CYGWIN
8192
8193 =item AUTHORS
8194
8195 =item HISTORY
8196
8197 =back
8198
8199 =head2 perldgux - Perl under DG/UX.
8200
8201 =over 4
8202
8203 =item SYNOPSIS
8204
8205 =back
8206
8207 =over 4
8208
8209 =item DESCRIPTION
8210
8211 =item BUILDING PERL ON DG/UX
8212
8213 =over 4
8214
8215 =item Non-threaded Perl on DG/UX
8216
8217 =item Threaded Perl on DG/UX
8218
8219 =item Testing Perl on DG/UX
8220
8221 =item Installing the built perl on DG/UX
8222
8223 =back
8224
8225 =item AUTHOR
8226
8227 =item SEE ALSO
8228
8229 =back
8230
8231 =head2 perldos - Perl under DOS, W31, W95.
8232
8233 =over 4
8234
8235 =item SYNOPSIS
8236
8237 =item DESCRIPTION
8238
8239 =over 4
8240
8241 =item Prerequisites for Compiling Perl on DOS
8242
8243 DJGPP, Pthreads
8244
8245 =item Shortcomings of Perl under DOS
8246
8247 =item Building Perl on DOS
8248
8249 =item Testing Perl on DOS
8250
8251 =item Installation of Perl on DOS
8252
8253 =back
8254
8255 =item BUILDING AND INSTALLING MODULES ON DOS
8256
8257 =over 4
8258
8259 =item Building Prerequisites for Perl on DOS
8260
8261 =item Unpacking CPAN Modules on DOS
8262
8263 =item Building Non-XS Modules on DOS
8264
8265 =item Building XS Modules on DOS
8266
8267 =back
8268
8269 =item AUTHOR
8270
8271 =item SEE ALSO
8272
8273 =back
8274
8275 =head2 perlepoc, README.epoc - Perl for EPOC
8276
8277 =over 4
8278
8279 =item SYNOPSIS
8280
8281 =item INTRODUCTION
8282
8283 =item INSTALLING PERL ON EPOC
8284
8285 =item STARTING PERL ON EPOC
8286
8287 =over 4
8288
8289 =item Editors on Epoc
8290
8291 =item Features of Perl on Epoc
8292
8293 =item Restrictions of Perl on Epoc
8294
8295 =item Compiling Perl 5 on the EPOC cross compiling environment
8296
8297 =back
8298
8299 =item SUPPORT STATUS OF PERL ON EPOC
8300
8301 =item AUTHOR
8302
8303 =item LAST UPDATE
8304
8305 =back
8306
8307 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
8308
8309 =over 4
8310
8311 =item DESCRIPTION
8312
8313 =over 4
8314
8315 =item FreeBSD core dumps from readdir_r with ithreads
8316
8317 =item $^X doesn't always contain a full path in FreeBSD
8318
8319 =item Perl will no longer be part of "base FreeBSD"
8320
8321 =back
8322
8323 =item AUTHOR
8324
8325 =back
8326
8327 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
8328 (HP-UX) systems
8329
8330 =over 4
8331
8332 =item DESCRIPTION
8333
8334 =over 4
8335
8336 =item Using perl as shipped with HP-UX
8337
8338 =item Using perl from HP's porting centre
8339
8340 =item Compiling Perl 5 on HP-UX
8341
8342 =item PA-RISC
8343
8344 =item Portability Between PA-RISC Versions
8345
8346 =item PA-RISC 1.0
8347
8348 =item PA-RISC 1.1
8349
8350 =item PA-RISC 2.0
8351
8352 =item Itanium Processor Family and HP-UX
8353
8354 =item Itanium & Itanium 2
8355
8356 =item Building Dynamic Extensions on HP-UX
8357
8358 =item The HP ANSI C Compiler
8359
8360 =item The GNU C Compiler
8361
8362 =item Using Large Files with Perl on HP-UX
8363
8364 =item Threaded Perl on HP-UX
8365
8366 =item 64-bit Perl on HP-UX
8367
8368 =item Oracle on HP-UX
8369
8370 =item GDBM and Threads on HP-UX
8371
8372 =item NFS filesystems and utime(2) on HP-UX
8373
8374 =item perl -P and // and HP-UX
8375
8376 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
8377
8378 =back
8379
8380 =item nss_delete core dump from op/pwent or op/grent
8381
8382 =item AUTHOR
8383
8384 =item DATE
8385
8386 =back
8387
8388 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
8389
8390 =over 4
8391
8392 =item DESCRIPTION
8393
8394 =over 4
8395
8396 =item Known Problems with Perl on Hurd 
8397
8398 =back
8399
8400 =item AUTHOR
8401
8402 =back
8403
8404 =head2 perlirix, README.irix - Perl version 5 on Irix systems
8405
8406 =over 4
8407
8408 =item DESCRIPTION
8409
8410 =over 4
8411
8412 =item Building 32-bit Perl in Irix
8413
8414 =item Building 64-bit Perl in Irix
8415
8416 =item About Compiler Versions of Irix
8417
8418 =item Linker Problems in Irix
8419
8420 =item Malloc in Irix
8421
8422 =item Building with threads in Irix
8423
8424 =item Irix 5.3
8425
8426 =back
8427
8428 =item AUTHOR
8429
8430 =back
8431
8432 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
8433 systems
8434
8435 =over 4
8436
8437 =item DESCRIPTION
8438
8439 =over 4
8440
8441 =item Perl version 5.8.x and greater not supported
8442
8443 =item Compiling Perl 5.6.x on MachTen
8444
8445 =item Failures during C<make test> on MachTen
8446
8447 op/lexassign.t, pragma/warnings.t
8448
8449 =item Building external modules on MachTen
8450
8451 =back
8452
8453 =item AUTHOR
8454
8455 =item DATE
8456
8457 =back
8458
8459 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
8460
8461 =over 4
8462
8463 =item SYNOPSIS
8464
8465 =item DESCRIPTION
8466
8467 =item AUTHOR
8468
8469 =item DATE
8470
8471 =back
8472
8473 =head2 perlmacosx, README.macosx - Perl under Mac OS X
8474
8475 =over 4
8476
8477 =item SYNOPSIS
8478
8479 =item DESCRIPTION
8480
8481 =over 4
8482
8483 =item Installation Prefix
8484
8485 =item libperl and Prebinding
8486
8487 =item Updating Panther
8488
8489 =item Known problems
8490
8491 =item MacPerl
8492
8493 =item Carbon
8494
8495 =item Cocoa
8496
8497 =back
8498
8499 =item Starting From Scratch
8500
8501 =item AUTHOR
8502
8503 =item DATE
8504
8505 =back
8506
8507 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
8508
8509 =over 4
8510
8511 =item DESCRIPTION
8512
8513 =item Known problems with Perl on MiNT
8514
8515 =item AUTHOR
8516
8517 =back
8518
8519 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
8520
8521 =over 4
8522
8523 =item SYNOPSIS
8524
8525 =item NOTE
8526
8527 =item Binary distribution from HP
8528
8529 =item What's New in Perl for MPE/iX
8530
8531 =item Welcome to Perl/iX
8532
8533 =item System Requirements for Perl/iX
8534
8535 =item How to Obtain Perl/iX
8536
8537 =item Perl/iX Distribution Contents Highlights
8538
8539 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
8540 public_html/feedback.cgi, src/perl-5.6.0-mpe
8541
8542 =item How to Compile Perl/iX
8543
8544  4,  6
8545
8546 =item Getting Started with Perl/iX
8547
8548 =item MPE/iX Implementation Considerations
8549
8550 =item Known Perl/iX Bugs Under Investigation
8551
8552 =item Perl/iX To-Do List
8553
8554 =item Perl/iX Change History
8555
8556 =item AUTHOR
8557
8558 =back
8559
8560 =head2 perlnetware - Perl for NetWare
8561
8562 =over 4
8563
8564 =item DESCRIPTION
8565
8566 =item BUILD
8567
8568 =over 4
8569
8570 =item Tools & SDK
8571
8572 =item Setup
8573
8574 SetNWBld.bat, Buildtype.bat
8575
8576 =item Make
8577
8578 =item Interpreter
8579
8580 =item Extensions
8581
8582 =back
8583
8584 =item INSTALL
8585
8586 =item BUILD NEW EXTENSIONS
8587
8588 =item ACKNOWLEDGEMENTS
8589
8590 =item AUTHORS
8591
8592 =item DATE
8593
8594 =back
8595
8596 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
8597
8598 =over 4
8599
8600 =item SYNOPSIS
8601
8602 =back
8603
8604 =over 4
8605
8606 =item DESCRIPTION
8607
8608 =over 4
8609
8610 =item Target
8611
8612 =item Other OSes
8613
8614 =item Prerequisites
8615
8616 EMX, RSX, HPFS, pdksh
8617
8618 =item Starting Perl programs under OS/2 (and DOS and...)
8619
8620 =item Starting OS/2 (and DOS) programs under Perl
8621
8622 =back
8623
8624 =item Frequently asked questions
8625
8626 =over 4
8627
8628 =item "It does not work"
8629
8630 =item I cannot run external programs
8631
8632 =item I cannot embed perl into my program, or use F<perl.dll> from my
8633 program. 
8634
8635 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
8636 L<ExtUtils::Embed>?
8637
8638 =item C<``> and pipe-C<open> do not work under DOS.
8639
8640 =item Cannot start C<find.exe "pattern" file>
8641
8642 =back
8643
8644 =item INSTALLATION
8645
8646 =over 4
8647
8648 =item Automatic binary installation
8649
8650 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
8651
8652 =item Manual binary installation
8653
8654 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
8655 (statically linked), Executables for Perl utilities, Main Perl library,
8656 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
8657 and utilities, Manpages for Perl modules, Source for Perl documentation,
8658 Perl manual in F<.INF> format, Pdksh
8659
8660 =item B<Warning>
8661
8662 =back
8663
8664 =item Accessing documentation
8665
8666 =over 4
8667
8668 =item OS/2 F<.INF> file
8669
8670 =item Plain text
8671
8672 =item Manpages
8673
8674 =item HTML
8675
8676 =item GNU C<info> files
8677
8678 =item F<PDF> files
8679
8680 =item C<LaTeX> docs
8681
8682 =back
8683
8684 =item BUILD
8685
8686 =over 4
8687
8688 =item The short story
8689
8690 =item Prerequisites
8691
8692 =item Getting perl source
8693
8694 =item Application of the patches
8695
8696 =item Hand-editing
8697
8698 =item Making
8699
8700 =item Testing
8701
8702 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
8703 F<op/stat.t>
8704
8705 =item Installing the built perl
8706
8707 =item C<a.out>-style build
8708
8709 =back
8710
8711 =item Building a binary distribution
8712
8713 =item Building custom F<.EXE> files
8714
8715 =over 4
8716
8717 =item Making executables with a custom collection of statically loaded
8718 extensions
8719
8720 =item Making executables with a custom search-paths
8721
8722 =back
8723
8724 =item Build FAQ
8725
8726 =over 4
8727
8728 =item Some C</> became C<\> in pdksh.
8729
8730 =item C<'errno'> - unresolved external
8731
8732 =item Problems with tr or sed
8733
8734 =item Some problem (forget which ;-)
8735
8736 =item Library ... not found
8737
8738 =item Segfault in make
8739
8740 =item op/sprintf test failure
8741
8742 =back
8743
8744 =item Specific (mis)features of OS/2 port
8745
8746 =over 4
8747
8748 =item C<setpriority>, C<getpriority>
8749
8750 =item C<system()>
8751
8752 =item C<extproc> on the first line
8753
8754 =item Additional modules:
8755
8756 =item Prebuilt methods:
8757
8758 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
8759  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>, 
8760 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>, 
8761 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>, 
8762 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>, 
8763 C<Cwd::extLibpath_set( path [, type ] )>,
8764 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
8765 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
8766 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
8767 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
8768 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
8769 C<OS2::DLLname([how [, \&xsub]])>
8770
8771 =item Prebuilt variables:
8772
8773 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
8774 $OS2::nsyserror
8775
8776 =item Misfeatures
8777
8778 =item Modifications
8779
8780 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
8781 C<flock>
8782
8783 =item Identifying DLLs
8784
8785 =item Centralized management of resources
8786
8787 C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
8788 C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
8789 C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
8790 C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
8791
8792 =back
8793
8794 =item Perl flavors
8795
8796 =over 4
8797
8798 =item F<perl.exe>
8799
8800 =item F<perl_.exe>
8801
8802 =item F<perl__.exe>
8803
8804 =item F<perl___.exe>
8805
8806 =item Why strange names?
8807
8808 =item Why dynamic linking?
8809
8810 =item Why chimera build?
8811
8812 =back
8813
8814 =item ENVIRONMENT
8815
8816 =over 4
8817
8818 =item C<PERLLIB_PREFIX>
8819
8820 =item C<PERL_BADLANG>
8821
8822 =item C<PERL_BADFREE>
8823
8824 =item C<PERL_SH_DIR>
8825
8826 =item C<USE_PERL_FLOCK>
8827
8828 =item C<TMP> or C<TEMP>
8829
8830 =back
8831
8832 =item Evolution
8833
8834 =over 4
8835
8836 =item Text-mode filehandles
8837
8838 =item Priorities
8839
8840 =item DLL name mangling: pre 5.6.2
8841
8842 =item DLL name mangling: 5.6.2 and beyond
8843
8844 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
8845 C<LIBPATH>
8846
8847 =item DLL forwarder generation
8848
8849 =item Threading
8850
8851 =item Calls to external programs
8852
8853 =item Memory allocation
8854
8855 =item Threads
8856
8857 C<COND_WAIT>, F<os2.c>
8858
8859 =back
8860
8861 =item BUGS
8862
8863 =back
8864
8865 =over 4
8866
8867 =item AUTHOR
8868
8869 =item SEE ALSO
8870
8871 =back
8872
8873 =head2 perlos390, README.os390 - building and installing Perl for OS/390
8874 and z/OS
8875
8876 =over 4
8877
8878 =item SYNOPSIS
8879
8880 =item DESCRIPTION
8881
8882 =over 4
8883
8884 =item Tools
8885
8886 =item Unpacking Perl distribution on OS/390
8887
8888 =item Setup and utilities for Perl on OS/390
8889
8890 =item Configure Perl on OS/390
8891
8892 =item Build, Test, Install Perl on OS/390
8893
8894 =item Build Anomalies with Perl on OS/390
8895
8896 =item Testing Anomalies with Perl on OS/390
8897
8898 =item Installation Anomalies with Perl on OS/390
8899
8900 =item Usage Hints for Perl on OS/390
8901
8902 =item Floating Point Anomalies with Perl on OS/390
8903
8904 =item Modules and Extensions for Perl on OS/390
8905
8906 =back
8907
8908 =item AUTHORS
8909
8910 =item SEE ALSO
8911
8912 =over 4
8913
8914 =item Mailing list for Perl on OS/390
8915
8916 =back
8917
8918 =item HISTORY
8919
8920 =back
8921
8922 =head2 perlos400, README.os400 - Perl version 5 on OS/400
8923
8924 =over 4
8925
8926 =item DESCRIPTION
8927
8928 =over 4
8929
8930 =item Compiling Perl for OS/400 PASE
8931
8932 =item Installing Perl in OS/400 PASE
8933
8934 =item Using Perl in OS/400 PASE
8935
8936 =item Known Problems
8937
8938 =item Perl on ILE
8939
8940 =back
8941
8942 =item AUTHORS
8943
8944 =back
8945
8946 =head2 perlplan9 - Plan 9-specific documentation for Perl
8947
8948 =over 4
8949
8950 =item DESCRIPTION
8951
8952 =over 4
8953
8954 =item Invoking Perl
8955
8956 =item What's in Plan 9 Perl
8957
8958 =item What's not in Plan 9 Perl
8959
8960 =item Perl5 Functions not currently supported in Plan 9 Perl
8961
8962 =item Signals in Plan 9 Perl
8963
8964 =back
8965
8966 =item COMPILING AND INSTALLING PERL ON PLAN 9
8967
8968 =over 4
8969
8970 =item Installing Perl Documentation on Plan 9
8971
8972 =back
8973
8974 =item BUGS
8975
8976 =item Revision date
8977
8978 =item AUTHOR
8979
8980 =back
8981
8982 =head2 perlqnx, README.qnx - Perl version 5 on QNX
8983
8984 =over 4
8985
8986 =item DESCRIPTION
8987
8988 =over 4
8989
8990 =item Required Software for Compiling Perl on QNX4
8991
8992 /bin/sh, ar, nm, cpp, make
8993
8994 =item Outstanding Issues with Perl on QNX4
8995
8996 =item QNX auxiliary files
8997
8998 qnx/ar, qnx/cpp
8999
9000 =item Outstanding issues with perl under QNX6
9001
9002 =back
9003
9004 =item AUTHOR
9005
9006 =back
9007
9008 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
9009
9010 =over 4
9011
9012 =item DESCRIPTION
9013
9014 =over 4
9015
9016 =item Solaris Version Numbers.
9017
9018 =back
9019
9020 =item RESOURCES
9021
9022 Solaris FAQ, Precompiled Binaries, Solaris Documentation
9023
9024 =item SETTING UP
9025
9026 =over 4
9027
9028 =item File Extraction Problems on Solaris.
9029
9030 =item Compiler and Related Tools on Solaris.
9031
9032 =item Environment for Compiling perl on Solaris
9033
9034 =back
9035
9036 =item RUN CONFIGURE.
9037
9038 =over 4
9039
9040 =item 64-bit perl on Solaris.
9041
9042 =item Threads in perl on Solaris.
9043
9044 =item Malloc Issues with perl on Solaris.
9045
9046 =back
9047
9048 =item MAKE PROBLEMS.
9049
9050 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
9051 relocation error:, dlopen: stub interception failed, #error "No
9052 DATAMODEL_NATIVE specified", sh: ar: not found
9053
9054 =item MAKE TEST
9055
9056 =over 4
9057
9058 =item op/stat.t test 4 in Solaris
9059
9060 =item nss_delete core dump from op/pwent or op/grent
9061
9062 =back
9063
9064 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
9065
9066 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
9067
9068 =over 4
9069
9070 =item Limits on Numbers of Open Files on Solaris.
9071
9072 =back
9073
9074 =item SOLARIS-SPECIFIC MODULES.
9075
9076 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
9077
9078 =over 4
9079
9080 =item Proc::ProcessTable on Solaris
9081
9082 =item BSD::Resource on Solaris
9083
9084 =item Net::SSLeay on Solaris
9085
9086 =back
9087
9088 =item SunOS 4.x
9089
9090 =item AUTHOR
9091
9092 =item LAST MODIFIED
9093
9094 =back
9095
9096 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
9097 Digital UNIX formerly known as DEC OSF/1) systems
9098
9099 =over 4
9100
9101 =item DESCRIPTION
9102
9103 =over 4
9104
9105 =item Compiling Perl 5 on Tru64
9106
9107 =item Using Large Files with Perl on Tru64
9108
9109 =item Threaded Perl on Tru64
9110
9111 =item Long Doubles on Tru64
9112
9113 =item DB_File tests failing on Tru64
9114
9115 =item 64-bit Perl on Tru64
9116
9117 =item Warnings about floating-point overflow when compiling Perl on Tru64
9118
9119 =back
9120
9121 =item Testing Perl on Tru64
9122
9123 =item ext/ODBM_File/odbm Test Failing With Static Builds
9124
9125 =item Perl Fails Because Of Unresolved Symbol sockatmark
9126
9127 =item AUTHOR
9128
9129 =back
9130
9131 =head2 perluts - Perl under UTS
9132
9133 =over 4
9134
9135 =item SYNOPSIS
9136
9137 =item DESCRIPTION
9138
9139 =item BUILDING PERL ON UTS
9140
9141 =item Installing the built perl on UTS
9142
9143 =item AUTHOR
9144
9145 =back
9146
9147 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
9148
9149 =over 4
9150
9151 =item SYNOPSIS
9152
9153 =item DESCRIPTION
9154
9155 =over 4
9156
9157 =item Unpacking Perl Distribution on VM/ESA
9158
9159 =item Setup Perl and utilities on VM/ESA
9160
9161 =item Configure Perl on VM/ESA
9162
9163 =item Testing Anomalies of Perl on VM/ESA
9164
9165 =item Usage Hints for Perl on VM/ESA
9166
9167 =back
9168
9169 =item AUTHORS
9170
9171 =item SEE ALSO
9172
9173 =over 4
9174
9175 =item Mailing list for Perl on VM/ESA
9176
9177 =back
9178
9179 =back
9180
9181 =head2 perlvms - VMS-specific documentation for Perl
9182
9183 =over 4
9184
9185 =item DESCRIPTION
9186
9187 =item Installation
9188
9189 =item Organization of Perl Images
9190
9191 =over 4
9192
9193 =item Core Images
9194
9195 =item Perl Extensions
9196
9197 =item Installing static extensions
9198
9199 =item Installing dynamic extensions
9200
9201 =back
9202
9203 =item File specifications
9204
9205 =over 4
9206
9207 =item Syntax
9208
9209 =item Wildcard expansion
9210
9211 =item Pipes
9212
9213 =back
9214
9215 =item PERL5LIB and PERLLIB
9216
9217 =item Command line
9218
9219 =over 4
9220
9221 =item I/O redirection and backgrounding
9222
9223 =item Command line switches
9224
9225 -i, -S, -u
9226
9227 =back
9228
9229 =item Perl functions
9230
9231 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
9232 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
9233 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
9234 LIST, waitpid PID,FLAGS
9235
9236 =item Perl variables
9237
9238 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
9239
9240 =item Standard modules with VMS-specific differences
9241
9242 =over 4
9243
9244 =item SDBM_File
9245
9246 =back
9247
9248 =item Revision date
9249
9250 =item AUTHOR
9251
9252 =back
9253
9254 =head2 perlvos, README.vos - Perl for Stratus VOS
9255
9256 =over 4
9257
9258 =item SYNOPSIS
9259
9260 =item BUILDING PERL FOR VOS
9261
9262 =item INSTALLING PERL IN VOS
9263
9264 =item USING PERL IN VOS
9265
9266 =over 4
9267
9268 =item Restrictions of Perl on VOS
9269
9270 =item Handling of underflow and overflow
9271
9272 =back
9273
9274 =item TEST STATUS
9275
9276 =item SUPPORT STATUS
9277
9278 =item AUTHOR
9279
9280 =item LAST UPDATE
9281
9282 =back
9283
9284 =head2 perlwin32 - Perl under Windows
9285
9286 =over 4
9287
9288 =item SYNOPSIS
9289
9290 =item DESCRIPTION
9291
9292 =over 4
9293
9294 =item Setting Up Perl on Win32
9295
9296 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Visual
9297 C++ Toolkit 2003, Microsoft Platform SDK 64-bit Compiler, MinGW release 3
9298 with gcc, MinGW release 1 with gcc
9299
9300 =item Building
9301
9302 =item Testing Perl on Win32
9303
9304 =item Installation of Perl on Win32
9305
9306 =item Usage Hints for Perl on Win32
9307
9308 Environment Variables, File Globbing, Using perl from the command line,
9309 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
9310 Extensions, Notes on 64-bit Windows
9311
9312 =item Running Perl Scripts
9313
9314 =item Miscellaneous Things
9315
9316 =back
9317
9318 =item BUGS AND CAVEATS
9319
9320 =item ACKNOWLEDGEMENTS
9321
9322 =item AUTHORS
9323
9324 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
9325 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
9326 E<lt>nick@ing-simmons.netE<gt>, Jan Dubois E<lt>jand@activestate.comE<gt>,
9327 Steve Hay E<lt>steve.hay@uk.radan.comE<gt>
9328
9329 =item SEE ALSO
9330
9331 =item HISTORY
9332
9333 =back
9334
9335 =head1 PRAGMA DOCUMENTATION
9336
9337 =head2 attrs - set/get attributes of a subroutine (deprecated)
9338
9339 =over 4
9340
9341 =item SYNOPSIS
9342
9343 =item DESCRIPTION
9344
9345 method, locked
9346
9347 =back
9348
9349 =head2 re - Perl pragma to alter regular expression behaviour
9350
9351 =over 4
9352
9353 =item SYNOPSIS
9354
9355 =item DESCRIPTION
9356
9357 =back
9358
9359 =head2 threadshared::shared, threads::shared - Perl extension for sharing
9360 data structures between threads
9361
9362 =over 4
9363
9364 =item SYNOPSIS
9365
9366 =item DESCRIPTION
9367
9368 =item EXPORT
9369
9370 =item FUNCTIONS
9371
9372 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
9373 LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
9374 ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
9375
9376 =item NOTES
9377
9378 =item BUGS
9379
9380 =item AUTHOR
9381
9382 =item SEE ALSO
9383
9384 =back
9385
9386 =head2 threads - Perl extension allowing use of interpreter based threads
9387 from perl
9388
9389 =over 4
9390
9391 =item SYNOPSIS
9392
9393 =item DESCRIPTION
9394
9395 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
9396 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
9397 threads->list();, async BLOCK;
9398
9399 =item WARNINGS
9400
9401 A thread exited while %d other threads were still running
9402
9403 =item TODO
9404
9405 =item BUGS
9406
9407 Parent-Child threads, Returning objects, Creating threads inside BEGIN
9408 blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
9409
9410 =item AUTHOR and COPYRIGHT
9411
9412 =item SEE ALSO
9413
9414 =back
9415
9416 =head2 assertions - select assertions in blocks of code
9417
9418 =over 4
9419
9420 =item SYNOPSIS
9421
9422 =item DESCRIPTION
9423
9424 =item SEE ALSO
9425
9426 =item AUTHOR
9427
9428 =item COPYRIGHT AND LICENSE
9429
9430 =back
9431
9432 =head2 assertions::activate - activate assertions
9433
9434 =over 4
9435
9436 =item SYNOPSIS
9437
9438 =item DESCRIPTION
9439
9440 =item SEE ALSO
9441
9442 =item AUTHOR
9443
9444 =item COPYRIGHT AND LICENSE
9445
9446 =back
9447
9448 =head2 attributes - get/set subroutine or variable attributes
9449
9450 =over 4
9451
9452 =item SYNOPSIS
9453
9454 =item DESCRIPTION
9455
9456 =over 4
9457
9458 =item Built-in Attributes
9459
9460 locked, method, lvalue
9461
9462 =item Available Subroutines
9463
9464 get, reftype
9465
9466 =item Package-specific Attribute Handling
9467
9468 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
9469
9470 =item Syntax of Attribute Lists
9471
9472 =back
9473
9474 =item EXPORTS
9475
9476 =over 4
9477
9478 =item Default exports
9479
9480 =item Available exports
9481
9482 =item Export tags defined
9483
9484 =back
9485
9486 =item EXAMPLES
9487
9488 =item SEE ALSO
9489
9490 =back
9491
9492 =head2 autouse - postpone load of modules until a function is used
9493
9494 =over 4
9495
9496 =item SYNOPSIS
9497
9498 =item DESCRIPTION
9499
9500 =item WARNING
9501
9502 =item AUTHOR
9503
9504 =item SEE ALSO
9505
9506 =back
9507
9508 =head2 base - Establish IS-A relationship with base classes at compile time
9509
9510 =over 4
9511
9512 =item SYNOPSIS
9513
9514 =item DESCRIPTION
9515
9516 =item DIAGNOSTICS
9517
9518 Base class package "%s" is empty
9519
9520 =item HISTORY
9521
9522 =item CAVEATS
9523
9524 =item SEE ALSO
9525
9526 =back
9527
9528 =head2 bigint - Transparent BigInteger support for Perl
9529
9530 =over 4
9531
9532 =item SYNOPSIS
9533
9534 =item DESCRIPTION
9535
9536 =over 4
9537
9538 =item Options
9539
9540 a or accuracy, p or precision, t or trace, l or lib, v or version
9541
9542 =item Math Library
9543
9544 =item Internal Format
9545
9546 =item Sign
9547
9548 =item Methods
9549
9550 =item Caveat
9551
9552 =back
9553
9554 =item MODULES USED
9555
9556 =item EXAMPLES
9557
9558 =item LICENSE
9559
9560 =item SEE ALSO
9561
9562 =item AUTHORS
9563
9564 =back
9565
9566 =head2 bignum - Transparent BigNumber support for Perl
9567
9568 =over 4
9569
9570 =item SYNOPSIS
9571
9572 =item DESCRIPTION
9573
9574 =over 4
9575
9576 =item Options
9577
9578 a or accuracy, p or precision, t or trace, l or lib, v or version
9579
9580 =item Methods
9581
9582 =item Caveat
9583
9584 inf(), NaN(), upgrade()
9585
9586 =item MATH LIBRARY
9587
9588 =item INTERNAL FORMAT
9589
9590 =item SIGN
9591
9592 =back
9593
9594 =item MODULES USED
9595
9596 =item EXAMPLES
9597
9598 =item LICENSE
9599
9600 =item SEE ALSO
9601
9602 =item AUTHORS
9603
9604 =back
9605
9606 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
9607
9608 =over 4
9609
9610 =item SYNOPSIS
9611
9612 =item DESCRIPTION
9613
9614 =over 4
9615
9616 =item Modules Used
9617
9618 =item Math Library
9619
9620 =item Sign
9621
9622 =item Methods
9623
9624 =item Cavaet
9625
9626 =item Options
9627
9628 a or accuracy, p or precision, t or trace, l or lib, v or version
9629
9630 =back
9631
9632 =item EXAMPLES
9633
9634         perl -Mbigrat -le 'print sqrt(33)'
9635         perl -Mbigrat -le 'print 2*255'
9636         perl -Mbigrat -le 'print 4.5+2*255'
9637         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'       
9638         perl -Mbigrat -le 'print 12->is_odd()';
9639
9640 =item LICENSE
9641
9642 =item SEE ALSO
9643
9644 =item AUTHORS
9645
9646 =back
9647
9648 =head2 blib - Use MakeMaker's uninstalled version of a package
9649
9650 =over 4
9651
9652 =item SYNOPSIS
9653
9654 =item DESCRIPTION
9655
9656 =item BUGS
9657
9658 =item AUTHOR
9659
9660 =back
9661
9662 =head2 bytes - Perl pragma to force byte semantics rather than character
9663 semantics
9664
9665 =over 4
9666
9667 =item SYNOPSIS
9668
9669 =item DESCRIPTION
9670
9671 =item LIMITATIONS
9672
9673 =item SEE ALSO
9674
9675 =back
9676
9677 =head2 charnames - define character names for C<\N{named}> string literal
9678 escapes
9679
9680 =over 4
9681
9682 =item SYNOPSIS
9683
9684 =item DESCRIPTION
9685
9686 =item CUSTOM TRANSLATORS
9687
9688 =item CUSTOM ALIASES
9689
9690 =over 4
9691
9692 =item Anonymous hashes
9693
9694 =item Alias file
9695
9696 =item Alias shortcut
9697
9698 =back
9699
9700 =item charnames::viacode(code)
9701
9702 =item charnames::vianame(name)
9703
9704 =item ALIASES
9705
9706 =item ILLEGAL CHARACTERS
9707
9708 =item BUGS
9709
9710 =back
9711
9712 =head2 constant - Perl pragma to declare constants
9713
9714 =over 4
9715
9716 =item SYNOPSIS
9717
9718 =item DESCRIPTION
9719
9720 =item NOTES
9721
9722 =over 4
9723
9724 =item List constants
9725
9726 =item Defining multiple constants at once
9727
9728 =item Magic constants
9729
9730 =back
9731
9732 =item TECHNICAL NOTES
9733
9734 =item BUGS
9735
9736 =item AUTHOR
9737
9738 =item COPYRIGHT
9739
9740 =back
9741
9742 =head2 diagnostics, splain - produce verbose warning diagnostics
9743
9744 =over 4
9745
9746 =item SYNOPSIS
9747
9748 =item DESCRIPTION
9749
9750 =over 4
9751
9752 =item The C<diagnostics> Pragma
9753
9754 =item The I<splain> Program
9755
9756 =back
9757
9758 =item EXAMPLES
9759
9760 =item INTERNALS
9761
9762 =item BUGS
9763
9764 =item AUTHOR
9765
9766 =back
9767
9768 =head2 encoding - allows you to write your script in non-ascii or non-utf8
9769
9770 =over 4
9771
9772 =item SYNOPSIS
9773
9774 =item ABSTRACT
9775
9776 =over 4
9777
9778 =item Literal Conversions
9779
9780 =item PerlIO layers for C<STD(IN|OUT)>
9781
9782 =item Implicit upgrading for byte strings
9783
9784 =back
9785
9786 =item FEATURES THAT REQUIRE 5.8.1
9787
9788 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
9789
9790 =item USAGE
9791
9792 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
9793 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
9794
9795 =item The Filter Option
9796
9797 =over 4
9798
9799 =item Filter-related changes at Encode version 1.87
9800
9801 =back
9802
9803 =item CAVEATS
9804
9805 =over 4
9806
9807 =item NOT SCOPED
9808
9809 =item DO NOT MIX MULTIPLE ENCODINGS
9810
9811 =item tr/// with ranges
9812
9813 Legend of characters above
9814
9815 =back
9816
9817 =item EXAMPLE - Greekperl
9818
9819 =item KNOWN PROBLEMS
9820
9821 literals in regex that are longer than 127 bytes, EBCDIC, format
9822
9823 =over 4
9824
9825 =item The Logic of :locale
9826
9827 =back
9828
9829 =item HISTORY
9830
9831 =item SEE ALSO
9832
9833 =back
9834
9835 =head2 encoding::warnings - Warn on implicit encoding conversions
9836
9837 =over 4
9838
9839 =item VERSION
9840
9841 =item SYNOPSIS
9842
9843 =item DESCRIPTION
9844
9845 =over 4
9846
9847 =item Overview of the problem
9848
9849 =item Detecting the problem
9850
9851 =item Solving the problem
9852
9853 Upgrade both sides to unicode-strings, Downgrade both sides to
9854 byte-strings, Specify the encoding for implicit byte-string upgrading,
9855 PerlIO layers for B<STDIN> and B<STDOUT>, Literal conversions, Implicit
9856 upgrading for byte-strings
9857
9858 =back
9859
9860 =item CAVEATS
9861
9862 =back
9863
9864 =over 4
9865
9866 =item SEE ALSO
9867
9868 =item AUTHORS
9869
9870 =item COPYRIGHT
9871
9872 =back
9873
9874 =head2 fields - compile-time class fields
9875
9876 =over 4
9877
9878 =item SYNOPSIS
9879
9880 =item DESCRIPTION
9881
9882 new, phash
9883
9884 =item SEE ALSO
9885
9886 =back
9887
9888 =head2 filetest - Perl pragma to control the filetest permission operators
9889
9890 =over 4
9891
9892 =item SYNOPSIS
9893
9894 =item DESCRIPTION
9895
9896 =over 4
9897
9898 =item subpragma access
9899
9900 =back
9901
9902 =back
9903
9904 =head2 if - C<use> a Perl module if a condition holds
9905
9906 =over 4
9907
9908 =item SYNOPSIS
9909
9910 =item DESCRIPTION
9911
9912 =item BUGS
9913
9914 =item AUTHOR
9915
9916 =back
9917
9918 =head2 integer - Perl pragma to use integer arithmetic instead of floating
9919 point
9920
9921 =over 4
9922
9923 =item SYNOPSIS
9924
9925 =item DESCRIPTION
9926
9927 =back
9928
9929 =head2 less - perl pragma to request less of something from the compiler
9930
9931 =over 4
9932
9933 =item SYNOPSIS
9934
9935 =item DESCRIPTION
9936
9937 =back
9938
9939 =head2 lib - manipulate @INC at compile time
9940
9941 =over 4
9942
9943 =item SYNOPSIS
9944
9945 =item DESCRIPTION
9946
9947 =over 4
9948
9949 =item Adding directories to @INC
9950
9951 =item Deleting directories from @INC
9952
9953 =item Restoring original @INC
9954
9955 =back
9956
9957 =item CAVEATS
9958
9959 =item NOTES
9960
9961 =item SEE ALSO
9962
9963 =item AUTHOR
9964
9965 =back
9966
9967 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
9968 operations
9969
9970 =over 4
9971
9972 =item SYNOPSIS
9973
9974 =item DESCRIPTION
9975
9976 =back
9977
9978 =head2 open - perl pragma to set default PerlIO layers for input and output
9979
9980 =over 4
9981
9982 =item SYNOPSIS
9983
9984 =item DESCRIPTION
9985
9986 =item NONPERLIO FUNCTIONALITY
9987
9988 =item IMPLEMENTATION DETAILS
9989
9990 =item SEE ALSO
9991
9992 =back
9993
9994 =head2 ops - Perl pragma to restrict unsafe operations when compiling
9995
9996 =over 4
9997
9998 =item SYNOPSIS  
9999
10000 =item DESCRIPTION
10001
10002 =item SEE ALSO
10003
10004 =back
10005
10006 =head2 overload - Package for overloading perl operations
10007
10008 =over 4
10009
10010 =item SYNOPSIS
10011
10012 =item DESCRIPTION
10013
10014 =over 4
10015
10016 =item Declaration of overloaded functions
10017
10018 =item Calling Conventions for Binary Operations
10019
10020 FALSE, TRUE, C<undef>
10021
10022 =item Calling Conventions for Unary Operations
10023
10024 =item Calling Conventions for Mutators
10025
10026 C<++> and C<-->, C<x=> and other assignment versions
10027
10028 =item Overloadable Operations
10029
10030 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
10031 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
10032 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
10033
10034 =item Inheritance and overloading
10035
10036 Strings as values of C<use overload> directive, Overloading of an operation
10037 is inherited by derived classes
10038
10039 =back
10040
10041 =item SPECIAL SYMBOLS FOR C<use overload>
10042
10043 =over 4
10044
10045 =item Last Resort
10046
10047 =item Fallback
10048
10049 C<undef>, TRUE, defined, but FALSE
10050
10051 =item Copy Constructor
10052
10053 B<Example>
10054
10055 =back
10056
10057 =item MAGIC AUTOGENERATION
10058
10059 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
10060 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
10061 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
10062 I<Copy operator>
10063
10064 =item Losing overloading
10065
10066 =item Run-time Overloading
10067
10068 =item Public functions
10069
10070 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
10071
10072 =item Overloading constants
10073
10074 integer, float, binary, q, qr
10075
10076 =item IMPLEMENTATION
10077
10078 =item Metaphor clash
10079
10080 =item Cookbook
10081
10082 =over 4
10083
10084 =item Two-face scalars
10085
10086 =item Two-face references
10087
10088 =item Symbolic calculator
10089
10090 =item I<Really> symbolic calculator
10091
10092 =back
10093
10094 =item AUTHOR
10095
10096 =item DIAGNOSTICS
10097
10098 Odd number of arguments for overload::constant, `%s' is not an overloadable
10099 type, `%s' is not a code reference
10100
10101 =item BUGS
10102
10103 =back
10104
10105 =head2 sigtrap - Perl pragma to enable simple signal handling
10106
10107 =over 4
10108
10109 =item SYNOPSIS
10110
10111 =item DESCRIPTION
10112
10113 =item OPTIONS
10114
10115 =over 4
10116
10117 =item SIGNAL HANDLERS
10118
10119 B<stack-trace>, B<die>, B<handler> I<your-handler>
10120
10121 =item SIGNAL LISTS
10122
10123 B<normal-signals>, B<error-signals>, B<old-interface-signals>
10124
10125 =item OTHER
10126
10127 B<untrapped>, B<any>, I<signal>, I<number>
10128
10129 =back
10130
10131 =item EXAMPLES
10132
10133 =back
10134
10135 =head2 sort - perl pragma to control sort() behaviour
10136
10137 =over 4
10138
10139 =item SYNOPSIS
10140
10141 =item DESCRIPTION
10142
10143 =item CAVEATS
10144
10145 =back
10146
10147 =head2 strict - Perl pragma to restrict unsafe constructs
10148
10149 =over 4
10150
10151 =item SYNOPSIS
10152
10153 =item DESCRIPTION
10154
10155 C<strict refs>, C<strict vars>, C<strict subs>
10156
10157 =item HISTORY
10158
10159 =back
10160
10161 =head2 subs - Perl pragma to predeclare sub names
10162
10163 =over 4
10164
10165 =item SYNOPSIS
10166
10167 =item DESCRIPTION
10168
10169 =back
10170
10171 =head2 threadshared, threads::shared - Perl extension for sharing data
10172 structures between threads
10173
10174 =over 4
10175
10176 =item SYNOPSIS
10177
10178 =item DESCRIPTION
10179
10180 =item EXPORT
10181
10182 =item FUNCTIONS
10183
10184 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
10185 LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
10186 ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
10187
10188 =item NOTES
10189
10190 =item BUGS
10191
10192 =item AUTHOR
10193
10194 =item SEE ALSO
10195
10196 =back
10197
10198 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
10199 code
10200
10201 =over 4
10202
10203 =item SYNOPSIS
10204
10205 =item DESCRIPTION
10206
10207 =over 4
10208
10209 =item Utility functions
10210
10211 $num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[,
10212 FAIL_OK]), utf8::encode($string), utf8::decode($string), $flag =
10213 utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
10214
10215 =back
10216
10217 =item BUGS
10218
10219 =item SEE ALSO
10220
10221 =back
10222
10223 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
10224
10225 =over 4
10226
10227 =item SYNOPSIS
10228
10229 =item DESCRIPTION
10230
10231 =back
10232
10233 =head2 version - Perl extension for Version Objects
10234
10235 =over 4
10236
10237 =item SYNOPSIS
10238
10239 =item DESCRIPTION
10240
10241 =over 4
10242
10243 =item What IS a version
10244
10245 Numeric Versions, Quoted Versions
10246
10247 =item What about v-strings?
10248
10249 =item Numeric Versions
10250
10251 =item Quoted Versions
10252
10253 =item Object Methods
10254
10255 New Operator, qv(), Normal Form, Numification, Stringification, Comparison
10256 operators, Logical Operators
10257
10258 =item Quoting
10259
10260 =item Types of Versions Objects
10261
10262 Ordinary versions, Alpha versions
10263
10264 =item Replacement UNIVERSAL::VERSION
10265
10266 =back
10267
10268 =item EXPORT
10269
10270 =item AUTHOR
10271
10272 =item SEE ALSO
10273
10274 =back
10275
10276 =head2 vmsish - Perl pragma to control VMS-specific language features
10277
10278 =over 4
10279
10280 =item SYNOPSIS
10281
10282 =item DESCRIPTION
10283
10284 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
10285
10286 =back
10287
10288 =head2 warnings - Perl pragma to control optional warnings
10289
10290 =over 4
10291
10292 =item SYNOPSIS
10293
10294 =item DESCRIPTION
10295
10296 use warnings::register, warnings::enabled(), warnings::enabled($category),
10297 warnings::enabled($object), warnings::warn($message),
10298 warnings::warn($category, $message), warnings::warn($object, $message),
10299 warnings::warnif($message), warnings::warnif($category, $message),
10300 warnings::warnif($object, $message)
10301
10302 =back
10303
10304 =head2 warnings::register - warnings import function
10305
10306 =over 4
10307
10308 =item SYNOPSIS
10309
10310 =item DESCRIPTION
10311
10312 =back
10313
10314 =head1 MODULE DOCUMENTATION
10315
10316 =head2 AnyDBM_File - provide framework for multiple DBMs
10317
10318 =over 4
10319
10320 =item SYNOPSIS
10321
10322 =item DESCRIPTION
10323
10324 =over 4
10325
10326 =item DBM Comparisons
10327
10328 [0], [1], [2], [3]
10329
10330 =back
10331
10332 =item SEE ALSO
10333
10334 =back
10335
10336 =head2 Attribute::Handlers - Simpler definition of attribute handlers
10337
10338 =over 4
10339
10340 =item VERSION
10341
10342 =item SYNOPSIS
10343
10344 =item DESCRIPTION
10345
10346 [0], [1], [2], [3], [4], [5]
10347
10348 =over 4
10349
10350 =item Typed lexicals
10351
10352 =item Type-specific attribute handlers
10353
10354 =item Non-interpretive attribute handlers
10355
10356 =item Phase-specific attribute handlers
10357
10358 =item Attributes as C<tie> interfaces
10359
10360 =back
10361
10362 =item EXAMPLES
10363
10364 =item DIAGNOSTICS
10365
10366 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
10367 attributes>, C<Declaration of %s attribute in package %s may clash with
10368 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
10369 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
10370 be able to apply END handler>
10371
10372 =item AUTHOR
10373
10374 =item BUGS
10375
10376 =item COPYRIGHT
10377
10378 =back
10379
10380 =head2 AutoLoader - load subroutines only on demand
10381
10382 =over 4
10383
10384 =item SYNOPSIS
10385
10386 =item DESCRIPTION
10387
10388 =over 4
10389
10390 =item Subroutine Stubs
10391
10392 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
10393
10394 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
10395
10396 =item Package Lexicals
10397
10398 =item Not Using AutoLoader
10399
10400 =item B<AutoLoader> vs. B<SelfLoader>
10401
10402 =back
10403
10404 =item CAVEATS
10405
10406 =item SEE ALSO
10407
10408 =back
10409
10410 =head2 AutoSplit - split a package for autoloading
10411
10412 =over 4
10413
10414 =item SYNOPSIS
10415
10416 =item DESCRIPTION
10417
10418 $keep, $check, $modtime
10419
10420 =over 4
10421
10422 =item Multiple packages
10423
10424 =back
10425
10426 =item DIAGNOSTICS
10427
10428 =back
10429
10430 =head2 B - The Perl Compiler
10431
10432 =over 4
10433
10434 =item SYNOPSIS
10435
10436 =item DESCRIPTION
10437
10438 =item OVERVIEW
10439
10440 =item Utility Functions
10441
10442 =over 4
10443
10444 =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV>
10445 objects
10446
10447 sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av,
10448 check_av, begin_av, end_av, comppadlist, regex_padav, main_cv
10449
10450 =item Functions for Examining the Symbol Table
10451
10452 walksymtable(SYMREF, METHOD, RECURSE, PREFIX)
10453
10454 =item Functions Returning C<B::OP> objects or for walking op trees
10455
10456 main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG)
10457
10458 =item Miscellaneous Utility Functions
10459
10460 ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR),
10461 perlstring(STR), class(OBJ), threadsv_names
10462
10463 =back
10464
10465 =item OVERVIEW OF CLASSES
10466
10467 =over 4
10468
10469 =item SV-RELATED CLASSES
10470
10471 =item B::SV Methods
10472
10473 REFCNT, FLAGS, object_2svref
10474
10475 =item B::IV Methods
10476
10477 IV, IVX, UVX, int_value, needs64bits, packiv
10478
10479 =item B::NV Methods
10480
10481 NV, NVX
10482
10483 =item B::RV Methods
10484
10485 RV
10486
10487 =item B::PV Methods
10488
10489 PV, RV, PVX
10490
10491 =item B::PVMG Methods
10492
10493 MAGIC, SvSTASH
10494
10495 =item B::MAGIC Methods
10496
10497 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
10498
10499 =item B::PVLV Methods
10500
10501 TARGOFF, TARGLEN, TYPE, TARG
10502
10503 =item B::BM Methods
10504
10505 USEFUL, PREVIOUS, RARE, TABLE
10506
10507 =item B::GV Methods
10508
10509 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
10510 LINE, FILE, FILEGV, GvREFCNT, FLAGS
10511
10512 =item B::IO Methods
10513
10514 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
10515 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
10516
10517 =item B::AV Methods
10518
10519 FILL, MAX, OFF, ARRAY, ARRAYelt, AvFLAGS
10520
10521 =item B::CV Methods
10522
10523 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB,
10524 XSUBANY, CvFLAGS, const_sv
10525
10526 =item B::HV Methods
10527
10528 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
10529
10530 =item OP-RELATED CLASSES
10531
10532 =item B::OP Methods
10533
10534 next, sibling, name, ppaddr, desc, targ, type, opt, static, flags, private,
10535 spare
10536
10537 =item B::UNOP METHOD
10538
10539 first
10540
10541 =item B::BINOP METHOD
10542
10543 last
10544
10545 =item B::LOGOP METHOD
10546
10547 other
10548
10549 =item B::LISTOP METHOD
10550
10551 children
10552
10553 =item B::PMOP Methods
10554
10555 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
10556 pmpermflags, precomp, pmoffset
10557
10558 =item B::SVOP METHOD
10559
10560 sv, gv
10561
10562 =item B::PADOP METHOD
10563
10564 padix
10565
10566 =item B::PVOP METHOD
10567
10568 pv
10569
10570 =item B::LOOP Methods
10571
10572 redoop, nextop, lastop
10573
10574 =item B::COP Methods
10575
10576 label, stash, stashpv, file, cop_seq, arybase, line, warnings, io
10577
10578 =back
10579
10580 =item AUTHOR
10581
10582 =back
10583
10584 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
10585 bytecode
10586
10587 =over 4
10588
10589 =item SYNOPSIS
10590
10591 =item DESCRIPTION
10592
10593 %insn_data, @insn_name, @optype, @specialsv_name
10594
10595 =item AUTHOR
10596
10597 =back
10598
10599 =head2 B::Assembler - Assemble Perl bytecode
10600
10601 =over 4
10602
10603 =item SYNOPSIS
10604
10605 =item DESCRIPTION
10606
10607 =item AUTHORS
10608
10609 =back
10610
10611 =head2 B::Bblock - Walk basic blocks
10612
10613 =over 4
10614
10615 =item SYNOPSIS
10616
10617 =item DESCRIPTION
10618
10619 =over 4
10620
10621 =item Functions
10622
10623 B<find_leaders>
10624
10625 =back
10626
10627 =item AUTHOR
10628
10629 =back
10630
10631 =head2 B::Bytecode - Perl compiler's bytecode backend
10632
10633 =over 4
10634
10635 =item SYNOPSIS
10636
10637 =item DESCRIPTION
10638
10639 =item EXAMPLE
10640
10641 =item OPTIONS
10642
10643 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
10644
10645 =item KNOWN BUGS
10646
10647 =item NOTICE
10648
10649 =item AUTHORS
10650
10651 =back
10652
10653 =head2 B::C - Perl compiler's C backend
10654
10655 =over 4
10656
10657 =item SYNOPSIS
10658
10659 =item DESCRIPTION
10660
10661 =item OPTIONS
10662
10663 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
10664 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
10665 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
10666 B<-llimit>
10667
10668 =item EXAMPLES
10669
10670 =item BUGS
10671
10672 =item AUTHOR
10673
10674 =back
10675
10676 =head2 B::CC - Perl compiler's optimized C translation backend
10677
10678 =over 4
10679
10680 =item SYNOPSIS
10681
10682 =item DESCRIPTION
10683
10684 =item OPTIONS
10685
10686 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
10687 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
10688 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
10689
10690 =item EXAMPLES
10691
10692 =item BUGS
10693
10694 =item DIFFERENCES
10695
10696 =over 4
10697
10698 =item Loops
10699
10700 =item Context of ".."
10701
10702 =item Arithmetic
10703
10704 =item Deprecated features
10705
10706 =back
10707
10708 =item AUTHOR
10709
10710 =back
10711
10712 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
10713
10714 =over 4
10715
10716 =item SYNOPSIS
10717
10718 =item DESCRIPTION
10719
10720 =item EXAMPLE
10721
10722 =item OPTIONS
10723
10724 =over 4
10725
10726 =item Options for Opcode Ordering
10727
10728 B<-basic>, B<-exec>, B<-tree>
10729
10730 =item Options for Line-Style
10731
10732 B<-concise>, B<-terse>, B<-linenoise>, B<-debug>, B<-env>
10733
10734 =item Options for tree-specific formatting
10735
10736 B<-compact>, B<-loose>, B<-vt>, B<-ascii>
10737
10738 =item Options controlling sequence numbering
10739
10740 B<-base>I<n>, B<-bigendian>, B<-littleendian>
10741
10742 =item Other options
10743
10744 B<-main>, B<-nomain>, B<-nobanner>, B<-banner>, B<-banneris> => subref
10745
10746 =item Option Stickiness
10747
10748 =back
10749
10750 =item ABBREVIATIONS
10751
10752 =over 4
10753
10754 =item OP class abbreviations
10755
10756 =item OP flags abbreviations
10757
10758 =back
10759
10760 =item FORMATTING SPECIFICATIONS
10761
10762 =over 4
10763
10764 =item Special Patterns
10765
10766 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
10767 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
10768 B<~>
10769
10770 =item # Variables
10771
10772 B<#>I<var>, B<#>I<var>I<N>, B<#>I<Var>, B<#addr>, B<#arg>, B<#class>,
10773 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
10774 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
10775 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
10776 B<#seq>, B<#seqnum>, B<#opt>, B<#static>, B<#sibaddr>, B<#svaddr>,
10777 B<#svclass>, B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
10778
10779 =back
10780
10781 =item Using B::Concise outside of the O framework
10782
10783 =over 4
10784
10785 =item Example: Altering Concise Renderings
10786
10787 =item set_style()
10788
10789 =item set_style_standard($name)
10790
10791 =item add_style()
10792
10793 =item add_callback()
10794
10795 =item Running B::Concise::compile()
10796
10797 =item B::Concise::reset_sequence()
10798
10799 =item Errors
10800
10801 =back
10802
10803 =item AUTHOR
10804
10805 =back
10806
10807 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
10808
10809 =over 4
10810
10811 =item SYNOPSIS
10812
10813 =item DESCRIPTION
10814
10815 =item AUTHOR
10816
10817 =back
10818
10819 =head2 B::Deparse - Perl compiler backend to produce perl code
10820
10821 =over 4
10822
10823 =item SYNOPSIS
10824
10825 =item DESCRIPTION
10826
10827 =item OPTIONS
10828
10829 B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>,
10830 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
10831
10832 =item USING B::Deparse AS A MODULE
10833
10834 =over 4
10835
10836 =item Synopsis
10837
10838 =item Description
10839
10840 =item new
10841
10842 =item ambient_pragmas
10843
10844 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
10845
10846 =item coderef2text
10847
10848 =back
10849
10850 =item BUGS
10851
10852 =item AUTHOR
10853
10854 =back
10855
10856 =head2 B::Disassembler - Disassemble Perl bytecode
10857
10858 =over 4
10859
10860 =item SYNOPSIS
10861
10862 =item DESCRIPTION
10863
10864 =item AUTHOR
10865
10866 =back
10867
10868 =head2 B::Lint - Perl lint
10869
10870 =over 4
10871
10872 =item SYNOPSIS
10873
10874 =item DESCRIPTION
10875
10876 =item OPTIONS AND LINT CHECKS
10877
10878 B<context>, B<implicit-read> and B<implicit-write>, B<bare-subs>,
10879 B<dollar-underscore>, B<private-names>, B<undefined-subs>,
10880 B<regexp-variables>, B<all>, B<none>
10881
10882 =item NON LINT-CHECK OPTIONS
10883
10884 B<-u Package>
10885
10886 =item BUGS
10887
10888 =item AUTHOR
10889
10890 =back
10891
10892 =head2 B::O, O - Generic interface to Perl Compiler backends
10893
10894 =over 4
10895
10896 =item SYNOPSIS
10897
10898 =item DESCRIPTION
10899
10900 =item CONVENTIONS
10901
10902 =item IMPLEMENTATION
10903
10904 =item BUGS
10905
10906 =item AUTHOR
10907
10908 =back
10909
10910 =head2 B::Showlex - Show lexical variables used in functions or files
10911
10912 =over 4
10913
10914 =item SYNOPSIS
10915
10916 =item DESCRIPTION
10917
10918 =item EXAMPLES
10919
10920 =over 4
10921
10922 =item OPTIONS
10923
10924 =back
10925
10926 =item SEE ALSO
10927
10928 =item TODO
10929
10930 =item AUTHOR
10931
10932 =back
10933
10934 =head2 B::Stackobj - Helper module for CC backend
10935
10936 =over 4
10937
10938 =item SYNOPSIS
10939
10940 =item DESCRIPTION
10941
10942 =item AUTHOR
10943
10944 =back
10945
10946 =head2 B::Stash - show what stashes are loaded
10947
10948 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
10949
10950 =over 4
10951
10952 =item SYNOPSIS
10953
10954 =item DESCRIPTION
10955
10956 =item AUTHOR
10957
10958 =back
10959
10960 =head2 B::Xref - Generates cross reference reports for Perl programs
10961
10962 =over 4
10963
10964 =item SYNOPSIS
10965
10966 =item DESCRIPTION
10967
10968 =item OPTIONS
10969
10970 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
10971
10972 =item BUGS
10973
10974 =item AUTHOR
10975
10976 =back
10977
10978 =head2 Bblock, B::Bblock - Walk basic blocks
10979
10980 =over 4
10981
10982 =item SYNOPSIS
10983
10984 =item DESCRIPTION
10985
10986 =over 4
10987
10988 =item Functions
10989
10990 B<find_leaders>
10991
10992 =back
10993
10994 =item AUTHOR
10995
10996 =back
10997
10998 =head2 Benchmark - benchmark running times of Perl code
10999
11000 =over 4
11001
11002 =item SYNOPSIS
11003
11004 =item DESCRIPTION
11005
11006 =over 4
11007
11008 =item Methods
11009
11010 new, debug, iters
11011
11012 =item Standard Exports
11013
11014 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
11015 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
11016 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
11017
11018 =item Optional Exports
11019
11020 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [
11021 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
11022 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
11023
11024 =item :hireswallclock
11025
11026 =back
11027
11028 =item NOTES
11029
11030 =item EXAMPLES
11031
11032 =item INHERITANCE
11033
11034 =item CAVEATS
11035
11036 =item SEE ALSO
11037
11038 =item AUTHORS
11039
11040 =item MODIFICATION HISTORY
11041
11042 =back
11043
11044 =head2 ByteLoader - load byte compiled perl code
11045
11046 =over 4
11047
11048 =item SYNOPSIS
11049
11050 =item DESCRIPTION
11051
11052 =item AUTHOR
11053
11054 =item SEE ALSO
11055
11056 =back
11057
11058 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
11059
11060 =over 4
11061
11062 =item SYNOPSIS
11063
11064 =item DESCRIPTION
11065
11066 =item EXAMPLE
11067
11068 =item OPTIONS
11069
11070 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
11071
11072 =item KNOWN BUGS
11073
11074 =item NOTICE
11075
11076 =item AUTHORS
11077
11078 =back
11079
11080 =head2 CGI - Simple Common Gateway Interface Class
11081
11082 =over 4
11083
11084 =item SYNOPSIS
11085
11086 =item ABSTRACT
11087
11088 =item DESCRIPTION
11089
11090 =over 4
11091
11092 =item PROGRAMMING STYLE
11093
11094 =item CALLING CGI.PM ROUTINES
11095
11096 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
11097
11098 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
11099
11100 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
11101
11102 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
11103
11104 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
11105
11106 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
11107
11108 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
11109
11110 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
11111
11112 =item DELETING A PARAMETER COMPLETELY:
11113
11114 =item DELETING ALL PARAMETERS:
11115
11116 =item DIRECT ACCESS TO THE PARAMETER LIST:
11117
11118 =item FETCHING THE PARAMETER LIST AS A HASH:
11119
11120 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
11121
11122 =item RETRIEVING CGI ERRORS
11123
11124 =item USING THE FUNCTION-ORIENTED INTERFACE
11125
11126 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
11127 B<:standard>, B<:all>
11128
11129 =item PRAGMAS
11130
11131 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
11132 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
11133 -private_tempfiles
11134
11135 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
11136
11137 1. start_table() (generates a <table> tag), 2. end_table() (generates a
11138 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
11139 a </ul> tag)
11140
11141 =back
11142
11143 =item GENERATING DYNAMIC DOCUMENTS
11144
11145 =over 4
11146
11147 =item CREATING A STANDARD HTTP HEADER:
11148
11149 =item GENERATING A REDIRECTION HEADER
11150
11151 =item CREATING THE HTML DOCUMENT HEADER
11152
11153 B<Parameters:>, 4, 5, 6..
11154
11155 =item ENDING THE HTML DOCUMENT:
11156
11157 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
11158
11159 =item OBTAINING THE SCRIPT'S URL
11160
11161 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
11162 (B<-query_string>), B<-base>
11163
11164 =item MIXING POST AND URL PARAMETERS
11165
11166 =back
11167
11168 =item CREATING STANDARD HTML ELEMENTS:
11169
11170 =over 4
11171
11172 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
11173
11174 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
11175
11176 =item HTML SHORTCUTS AND LIST INTERPOLATION
11177
11178 =item NON-STANDARD HTML SHORTCUTS
11179
11180 =item AUTOESCAPING HTML
11181
11182 $escaped_string = escapeHTML("unescaped string");, $charset =
11183 charset([$charset]);, $flag = autoEscape([$flag]);
11184
11185 =item PRETTY-PRINTING HTML
11186
11187 =back
11188
11189 =item CREATING FILL-OUT FORMS:
11190
11191 =over 4
11192
11193 =item CREATING AN ISINDEX TAG
11194
11195 =item STARTING AND ENDING A FORM
11196
11197 B<application/x-www-form-urlencoded>, B<multipart/form-data>
11198
11199 =item FORM ELEMENTS
11200
11201 B<-name>, B<-value>, B<-values>, B<-tabindex>, B<-id>, B<-override>,
11202 B<-onChange>, B<-onFocus>, B<-onBlur>, B<-onMouseOver>, B<-onMouseOut>,
11203 B<-onSelect>
11204
11205 =item CREATING A TEXT FIELD
11206
11207 B<Parameters>
11208
11209 =item CREATING A BIG TEXT FIELD
11210
11211 =item CREATING A PASSWORD FIELD
11212
11213 =item CREATING A FILE UPLOAD FIELD
11214
11215 B<Parameters>
11216
11217 =item CREATING A POPUP MENU
11218
11219 =item CREATING AN OPTION GROUP
11220
11221 =item CREATING A SCROLLING LIST
11222
11223 B<Parameters:>
11224
11225 =item CREATING A GROUP OF RELATED CHECKBOXES
11226
11227 B<Parameters:>
11228
11229 =item CREATING A STANDALONE CHECKBOX
11230
11231 B<Parameters:>
11232
11233 =item CREATING A RADIO BUTTON GROUP
11234
11235 B<Parameters:>
11236
11237 =item CREATING A SUBMIT BUTTON 
11238
11239 B<Parameters:>
11240
11241 =item CREATING A RESET BUTTON
11242
11243 =item CREATING A DEFAULT BUTTON
11244
11245 =item CREATING A HIDDEN FIELD
11246
11247 B<Parameters:>
11248
11249 =item CREATING A CLICKABLE IMAGE BUTTON
11250
11251 B<Parameters:>, 3. The third option (-align, optional) is an alignment
11252 type, and may be TOP, BOTTOM or MIDDLE
11253
11254 =item CREATING A JAVASCRIPT ACTION BUTTON
11255
11256 =back
11257
11258 =item HTTP COOKIES
11259
11260 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
11261 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
11262
11263 =item WORKING WITH FRAMES
11264
11265 1. Create a <Frameset> document, 2. Specify the destination for the
11266 document in the HTTP header, 3. Specify the destination for the document in
11267 the <form> tag
11268
11269 =item SUPPORT FOR JAVASCRIPT
11270
11271 B<onLoad>, B<onUnload>, B<onSubmit>, B<onClick>, B<onChange>, B<onFocus>,
11272 B<onBlur>, B<onSelect>, B<onMouseOver>, B<onMouseOut>
11273
11274 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
11275
11276 =item DEBUGGING
11277
11278 =over 4
11279
11280 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
11281
11282 =back
11283
11284 =item FETCHING ENVIRONMENT VARIABLES
11285
11286 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
11287 B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
11288 name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
11289 ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
11290 B<virtual_port ()>, B<server_software ()>, B<remote_user ()>, B<user_name
11291 ()>, B<request_method()>, B<content_type()>, B<http()>, B<https()>
11292
11293 =item USING NPH SCRIPTS
11294
11295 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
11296 parameters
11297
11298 =item Server Push
11299
11300 multipart_init(), multipart_start(), multipart_end(), multipart_final()
11301
11302 =item Avoiding Denial of Service Attacks
11303
11304 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
11305 basis>, B<2. Globally for all scripts>
11306
11307 =item COMPATIBILITY WITH CGI-LIB.PL
11308
11309 =item AUTHOR INFORMATION
11310
11311 =item CREDITS
11312
11313 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
11314 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
11315 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
11316 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
11317 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
11318 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
11319 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
11320 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
11321 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
11322 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
11323 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
11324 ...and many many more..
11325
11326 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
11327
11328 =item BUGS
11329
11330 =item SEE ALSO
11331
11332 =back
11333
11334 =head2 CGI::Apache - Backward compatibility module for CGI.pm
11335
11336 =over 4
11337
11338 =item SYNOPSIS
11339
11340 =item ABSTRACT
11341
11342 =item DESCRIPTION
11343
11344 =item AUTHOR INFORMATION
11345
11346 =item BUGS
11347
11348 =item SEE ALSO
11349
11350 =back
11351
11352 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
11353 other) error log
11354
11355 =over 4
11356
11357 =item SYNOPSIS
11358
11359 =item DESCRIPTION
11360
11361 =item REDIRECTING ERROR MESSAGES
11362
11363 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
11364
11365 =over 4
11366
11367 =item Changing the default message
11368
11369 =back
11370
11371 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
11372
11373 =item OVERRIDING THE NAME OF THE PROGRAM
11374
11375 =item AUTHORS
11376
11377 =item SEE ALSO
11378
11379 =back
11380
11381 =head2 CGI::Cookie - Interface to Netscape Cookies
11382
11383 =over 4
11384
11385 =item SYNOPSIS
11386
11387 =item DESCRIPTION
11388
11389 =item USING CGI::Cookie
11390
11391 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
11392
11393 =over 4
11394
11395 =item Creating New Cookies
11396
11397 =item Sending the Cookie to the Browser
11398
11399 =item Recovering Previous Cookies
11400
11401 =item Manipulating Cookies
11402
11403 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
11404
11405 =back
11406
11407 =item AUTHOR INFORMATION
11408
11409 =item BUGS
11410
11411 =item SEE ALSO
11412
11413 =back
11414
11415 =head2 CGI::Fast - CGI Interface for Fast CGI
11416
11417 =over 4
11418
11419 =item SYNOPSIS
11420
11421 =item DESCRIPTION
11422
11423 =item OTHER PIECES OF THE PUZZLE
11424
11425 =item WRITING FASTCGI PERL SCRIPTS
11426
11427 =item INSTALLING FASTCGI SCRIPTS
11428
11429 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
11430
11431 =item EXTERNAL FASTCGI SERVER INVOCATION
11432
11433 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
11434
11435 =item CAVEATS
11436
11437 =item AUTHOR INFORMATION
11438
11439 =item BUGS
11440
11441 =item SEE ALSO
11442
11443 =back
11444
11445 =head2 CGI::Pretty - module to produce nicely formatted HTML code
11446
11447 =over 4
11448
11449 =item SYNOPSIS
11450
11451 =item DESCRIPTION
11452
11453 =over 4
11454
11455 =item Tags that won't be formatted
11456
11457 =item Customizing the Indenting
11458
11459 =back
11460
11461 =item BUGS
11462
11463 =item AUTHOR
11464
11465 =item SEE ALSO
11466
11467 =back
11468
11469 =head2 CGI::Push - Simple Interface to Server Push
11470
11471 =over 4
11472
11473 =item SYNOPSIS
11474
11475 =item DESCRIPTION
11476
11477 =item USING CGI::Push
11478
11479 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
11480
11481 =over 4
11482
11483 =item Heterogeneous Pages
11484
11485 =item Changing the Page Delay on the Fly
11486
11487 =back
11488
11489 =item INSTALLING CGI::Push SCRIPTS
11490
11491 =item AUTHOR INFORMATION
11492
11493 =item BUGS
11494
11495 =item SEE ALSO
11496
11497 =back
11498
11499 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
11500
11501 =over 4
11502
11503 =item SYNOPSIS
11504
11505 =item ABSTRACT
11506
11507 =item DESCRIPTION
11508
11509 =item AUTHOR INFORMATION
11510
11511 =item BUGS
11512
11513 =item SEE ALSO
11514
11515 =back
11516
11517 =head2 CGI::Util - Internal utilities used by CGI module
11518
11519 =over 4
11520
11521 =item SYNOPSIS
11522
11523 =item DESCRIPTION
11524
11525 =item AUTHOR INFORMATION
11526
11527 =item SEE ALSO
11528
11529 =back
11530
11531 =head2 CPAN - query, download and build perl modules from CPAN sites
11532
11533 =over 4
11534
11535 =item SYNOPSIS
11536
11537 =item STATUS
11538
11539 =item DESCRIPTION
11540
11541 =over 4
11542
11543 =item Interactive Mode
11544
11545 Searching for authors, bundles, distribution files and modules, make, test,
11546 install, clean  modules or distributions, get, readme, look module or
11547 distribution, ls author, Signals
11548
11549 =item CPAN::Shell
11550
11551 =item autobundle
11552
11553 =item recompile
11554
11555 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
11556
11557 =item Programmer's interface
11558
11559 expand($type,@things), expandany(@things), Programming Examples
11560
11561 =item Methods in the other Classes
11562
11563 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
11564 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
11565 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
11566 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
11567 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
11568 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
11569 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
11570 CPAN::Bundle::readme(), CPAN::Bundle::test(),
11571 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
11572 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
11573 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
11574 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
11575 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
11576 CPAN::Distribution::look(), CPAN::Distribution::make(),
11577 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
11578 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
11579 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
11580 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
11581 CPAN::Module::clean(), CPAN::Module::cpan_file(),
11582 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
11583 CPAN::Module::description(), CPAN::Module::force($method,@args),
11584 CPAN::Module::get(), CPAN::Module::inst_file(),
11585 CPAN::Module::inst_version(), CPAN::Module::install(),
11586 CPAN::Module::look(), CPAN::Module::make(),
11587 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
11588 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
11589
11590 =item Cache Manager
11591
11592 =item Bundles
11593
11594 =item Prerequisites
11595
11596 =item Finding packages and VERSION
11597
11598 =item Debugging
11599
11600 =item Floppy, Zip, Offline Mode
11601
11602 =back
11603
11604 =item CONFIGURATION
11605
11606 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
11607 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
11608 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
11609 [unshift|push|splice] E<lt>listE<gt>>
11610
11611 =over 4
11612
11613 =item Note on urllist parameter's format
11614
11615 =item urllist parameter has CD-ROM support
11616
11617 =back
11618
11619 =item SECURITY
11620
11621 =item EXPORT
11622
11623 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
11624
11625 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
11626
11627 =over 4
11628
11629 =item Three basic types of firewalls
11630
11631 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
11632
11633 =item Configuring lynx or ncftp for going through a firewall
11634
11635 =back
11636
11637 =item FAQ
11638
11639 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
11640
11641 =item BUGS
11642
11643 =item AUTHOR
11644
11645 =item TRANSLATIONS
11646
11647 =item SEE ALSO
11648
11649 =back
11650
11651 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
11652
11653 =over 4
11654
11655 =item SYNOPSIS
11656
11657 =item DESCRIPTION
11658
11659 =back
11660
11661 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
11662 module
11663
11664 =over 4
11665
11666 =item SYNOPSIS
11667
11668 =item DESCRIPTION
11669
11670 =item  SEE ALSO
11671
11672 =back
11673
11674 =head2 Carp, carp    - warn of errors (from perspective of caller)
11675
11676 =over 4
11677
11678 =item SYNOPSIS
11679
11680 =item DESCRIPTION
11681
11682 =over 4
11683
11684 =item Forcing a Stack Trace
11685
11686 =back
11687
11688 =back
11689
11690 =over 4
11691
11692 =item GLOBAL VARIABLES
11693
11694 =over 4
11695
11696 =item $Carp::CarpLevel
11697
11698 =item $Carp::MaxEvalLen
11699
11700 =item $Carp::MaxArgLen
11701
11702 =item $Carp::MaxArgNums
11703
11704 =item $Carp::Verbose
11705
11706 =back
11707
11708 =back
11709
11710 =over 4
11711
11712 =item BUGS
11713
11714 =back
11715
11716 =head2 Carp::Heavy - heavy machinery, no user serviceable parts inside
11717
11718 =head2 Class::ISA -- report the search path for a class's ISA tree
11719
11720 =over 4
11721
11722 =item SYNOPSIS
11723
11724 =item DESCRIPTION
11725
11726 =item FUNCTIONS
11727
11728 the function Class::ISA::super_path($CLASS), the function
11729 Class::ISA::self_and_super_path($CLASS), the function
11730 Class::ISA::self_and_super_versions($CLASS)
11731
11732 =item CAUTIONARY NOTES
11733
11734 =item COPYRIGHT
11735
11736 =item AUTHOR
11737
11738 =back
11739
11740 =head2 Class::Struct - declare struct-like datatypes as Perl classes
11741
11742 =over 4
11743
11744 =item SYNOPSIS
11745
11746 =item DESCRIPTION
11747
11748 =over 4
11749
11750 =item The C<struct()> function
11751
11752 =item Class Creation at Compile Time
11753
11754 =item Element Types and Accessor Methods
11755
11756 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
11757 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
11758
11759 =item Initializing with C<new>
11760
11761 =back
11762
11763 =item EXAMPLES
11764
11765 Example 1, Example 2, Example 3
11766
11767 =item Author and Modification History
11768
11769 =back
11770
11771 =head2 Config - access Perl configuration information
11772
11773 =over 4
11774
11775 =item SYNOPSIS
11776
11777 =item DESCRIPTION
11778
11779 myconfig(), config_sh(), config_re($regex), config_vars(@names)
11780
11781 =item EXAMPLE
11782
11783 =item WARNING
11784
11785 =item GLOSSARY
11786
11787 =over 4
11788
11789 =item _
11790
11791 C<_a>, C<_exe>, C<_o>
11792
11793 =item a
11794
11795 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
11796 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
11797 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
11798 C<asctime_r_proto>, C<awk>
11799
11800 =item b
11801
11802 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
11803
11804 =item c
11805
11806 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
11807 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
11808 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
11809 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
11810 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
11811 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
11812 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
11813
11814 =item d
11815
11816 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>,
11817 C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>,
11818 C<d_bcmp>, C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>,
11819 C<d_bzero>, C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>,
11820 C<d_chroot>, C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>,
11821 C<d_const>, C<d_copysignl>, C<d_crypt>, C<d_crypt_r>, C<d_csh>,
11822 C<d_ctermid_r>, C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>,
11823 C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>, C<d_dirnamlen>, C<d_dlerror>,
11824 C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, C<d_drand48_r>, C<d_drand48proto>,
11825 C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endgrent_r>, C<d_endhent>,
11826 C<d_endhostent_r>, C<d_endnent>, C<d_endnetent_r>, C<d_endpent>,
11827 C<d_endprotoent_r>, C<d_endpwent>, C<d_endpwent_r>, C<d_endsent>,
11828 C<d_endservent_r>, C<d_eofnblk>, C<d_eunice>, C<d_faststdio>, C<d_fchdir>,
11829 C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>,
11830 C<d_fd_set>, C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>,
11831 C<d_flexfnam>, C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>,
11832 C<d_fpathconf>, C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>,
11833 C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>,
11834 C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>, C<d_ftime>,
11835 C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>,
11836 C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>,
11837 C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
11838 C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>,
11839 C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>,
11840 C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>,
11841 C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>,
11842 C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
11843 C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
11844 C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>,
11845 C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
11846 C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>,
11847 C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>,
11848 C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>,
11849 C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
11850 C<d_htonl>, C<d_ilogbl>, C<d_index>, C<d_inetaton>, C<d_int64_t>,
11851 C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>,
11852 C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>,
11853 C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>,
11854 C<d_lstat>, C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>,
11855 C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>,
11856 C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>,
11857 C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>,
11858 C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>,
11859 C<d_msg_peek>, C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>,
11860 C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>,
11861 C<d_nice>, C<d_nl_langinfo>, C<d_nv_preserves_uv>, C<d_off64_t>,
11862 C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
11863 C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
11864 C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
11865 C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
11866 C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>,
11867 C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, C<d_pthread_atfork>,
11868 C<d_pthread_attr_setscope>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
11869 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
11870 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
11871 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
11872 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
11873 C<d_sanemcmp>, C<d_sbrkproto>, C<d_scalbnl>, C<d_sched_yield>,
11874 C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>,
11875 C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>,
11876 C<d_semop>, C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>,
11877 C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>,
11878 C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>,
11879 C<d_setnent>, C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>,
11880 C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>,
11881 C<d_setpwent>, C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>,
11882 C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>,
11883 C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>,
11884 C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>,
11885 C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>,
11886 C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>,
11887 C<d_socks5_init>, C<d_sqrtl>, C<d_srand48_r>, C<d_srandom_r>,
11888 C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>,
11889 C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
11890 C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>,
11891 C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>,
11892 C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strerror_r>,
11893 C<d_strftime>, C<d_strlcat>, C<d_strlcpy>, C<d_strtod>, C<d_strtol>,
11894 C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>,
11895 C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>,
11896 C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
11897 C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
11898 C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>,
11899 C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>,
11900 C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
11901 C<d_unordered>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>,
11902 C<d_vendorbin>, C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>,
11903 C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>, C<d_volatile>,
11904 C<d_vprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>,
11905 C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>, C<db_prefixtype>,
11906 C<db_version_major>, C<db_version_minor>, C<db_version_patch>,
11907 C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>, C<doublesize>,
11908 C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
11909
11910 =item e
11911
11912 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
11913 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
11914 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
11915 C<expr>, C<extensions>, C<extras>
11916
11917 =item f
11918
11919 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
11920 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
11921 C<full_sed>
11922
11923 =item g
11924
11925 C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>,
11926 C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>,
11927 C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>,
11928 C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>,
11929 C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>,
11930 C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>,
11931 C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>,
11932 C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>,
11933 C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>,
11934 C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
11935
11936 =item h
11937
11938 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>,
11939 C<html3dir>, C<html3direxp>
11940
11941 =item i
11942
11943 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
11944 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
11945 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
11946 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
11947 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
11948 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
11949 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
11950 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
11951 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
11952 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
11953 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
11954 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
11955 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
11956 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
11957 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
11958 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
11959 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
11960 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
11961 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installhtml1dir>,
11962 C<installhtml3dir>, C<installman1dir>, C<installman3dir>, C<installprefix>,
11963 C<installprefixexp>, C<installprivlib>, C<installscript>,
11964 C<installsitearch>, C<installsitebin>, C<installsitehtml1dir>,
11965 C<installsitehtml3dir>, C<installsitelib>, C<installsiteman1dir>,
11966 C<installsiteman3dir>, C<installsitescript>, C<installstyle>,
11967 C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>,
11968 C<installvendorhtml1dir>, C<installvendorhtml3dir>, C<installvendorlib>,
11969 C<installvendorman1dir>, C<installvendorman3dir>, C<installvendorscript>,
11970 C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
11971
11972 =item k
11973
11974 C<known_extensions>, C<ksh>
11975
11976 =item l
11977
11978 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
11979 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
11980 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
11981 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
11982 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
11983 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
11984 C<lseektype>
11985
11986 =item m
11987
11988 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
11989 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
11990 C<man3direxp>, C<man3ext>
11991
11992 =item M
11993
11994 C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>,
11995 C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>,
11996 C<myuname>
11997
11998 =item n
11999
12000 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
12001 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
12002 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
12003 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
12004 C<nvsize>, C<nvtype>
12005
12006 =item o
12007
12008 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
12009 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
12010
12011 =item p
12012
12013 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
12014 C<perl>, C<perl_patchlevel>
12015
12016 =item P
12017
12018 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
12019 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
12020 C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>,
12021 C<procselfexe>, C<prototype>, C<ptrsize>
12022
12023 =item q
12024
12025 C<quadkind>, C<quadtype>
12026
12027 =item r
12028
12029 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
12030 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
12031 C<rmail>, C<run>, C<runnm>
12032
12033 =item s
12034
12035 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
12036 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
12037 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
12038 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
12039 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
12040 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
12041 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
12042 C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>,
12043 C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>,
12044 C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>,
12045 C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>,
12046 C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>,
12047 C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>,
12048 C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>,
12049 C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>,
12050 C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>,
12051 C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>,
12052 C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>,
12053 C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>,
12054 C<submit>, C<subversion>, C<sysman>
12055
12056 =item t
12057
12058 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
12059 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
12060 C<ttyname_r_proto>
12061
12062 =item u
12063
12064 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
12065 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
12066 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
12067 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>,
12068 C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemallocwrap>,
12069 C<usemorebits>, C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>,
12070 C<useperlio>, C<useposix>, C<usereentrant>, C<userelocatableinc>,
12071 C<usesfio>, C<useshrplib>, C<usesocks>, C<usethreads>, C<usevendorprefix>,
12072 C<usevfork>, C<usrinc>, C<uuname>, C<uvoformat>, C<uvsize>, C<uvtype>,
12073 C<uvuformat>, C<uvxformat>, C<uvXUformat>
12074
12075 =item v
12076
12077 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
12078 C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>,
12079 C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>,
12080 C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>,
12081 C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>,
12082 C<vendorscriptexp>, C<version>, C<version_patchlevel_string>,
12083 C<versiononly>, C<vi>, C<voidflags>
12084
12085 =item x
12086
12087 C<xlibpth>
12088
12089 =item y
12090
12091 C<yacc>, C<yaccflags>
12092
12093 =item z
12094
12095 C<zcat>, C<zip>
12096
12097 =back
12098
12099 =item NOTE
12100
12101 =back
12102
12103 =over 4
12104
12105 =item SYNOPSIS
12106
12107 =item DESCRIPTION
12108
12109 dynamic, nonxs, static
12110
12111 =item AUTHOR
12112
12113 =back
12114
12115 =head2 Cwd - get pathname of current working directory
12116
12117 =over 4
12118
12119 =item SYNOPSIS
12120
12121 =item DESCRIPTION
12122
12123 =over 4
12124
12125 =item getcwd and friends
12126
12127 getcwd, cwd, fastcwd, fastgetcwd, getdcwd
12128
12129 =item abs_path and friends
12130
12131 abs_path, realpath, fast_abs_path
12132
12133 =item $ENV{PWD}
12134
12135 =back
12136
12137 =item NOTES
12138
12139 =item AUTHOR
12140
12141 =item COPYRIGHT
12142
12143 =item SEE ALSO
12144
12145 =back
12146
12147 =head2 DB - programmatic interface to the Perl debugging API (draft,
12148 subject to
12149 change)
12150
12151 =over 4
12152
12153 =item SYNOPSIS
12154
12155 =item DESCRIPTION
12156
12157 =over 4
12158
12159 =item Global Variables
12160
12161  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args, 
12162 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname, 
12163 $DB::lineno
12164
12165 =item API Methods
12166
12167 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
12168 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
12169
12170 =item Client Callback Methods
12171
12172 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
12173 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
12174 CLIENT->output(LIST)
12175
12176 =back
12177
12178 =item BUGS
12179
12180 =item AUTHOR
12181
12182 =back
12183
12184 =head2 DBM_Filter -- Filter DBM keys/values 
12185
12186 =over 4
12187
12188 =item SYNOPSIS
12189
12190 =item DESCRIPTION
12191
12192 =item What is a DBM Filter?
12193
12194 =over 4
12195
12196 =item So what's new?
12197
12198 =back
12199
12200 =item METHODS
12201
12202 =over 4
12203
12204 =item $db->Filter_Push()
12205
12206 =item $db->Filter_Key_Push()
12207
12208 =item $db->Filter_Value_Push()
12209
12210 Filter_Push, Filter_Key_Push, Filter_Value_Push
12211
12212 =item $db->Filter_Pop()
12213
12214 =item $db->Filtered()
12215
12216 =back
12217
12218 =item Writing a Filter
12219
12220 =over 4
12221
12222 =item Immediate Filters
12223
12224 =item Canned Filters
12225
12226 "name", params
12227
12228 =back
12229
12230 =item Filters Included
12231
12232 utf8, encode, compress, int32, null
12233
12234 =item NOTES
12235
12236 =over 4
12237
12238 =item Maintain Round Trip Integrity
12239
12240 =item Don't mix filtered & non-filtered data in the same database file. 
12241
12242 =back
12243
12244 =item EXAMPLE
12245
12246 =item SEE ALSO
12247
12248 =item AUTHOR
12249
12250 =back
12251
12252 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
12253
12254 =over 4
12255
12256 =item SYNOPSIS
12257
12258 =item DESCRIPTION
12259
12260 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
12261
12262 =over 4
12263
12264 =item Using DB_File with Berkeley DB version 2 or greater
12265
12266 =item Interface to Berkeley DB
12267
12268 =item Opening a Berkeley DB Database File
12269
12270 =item Default Parameters
12271
12272 =item In Memory Databases
12273
12274 =back
12275
12276 =item DB_HASH
12277
12278 =over 4
12279
12280 =item A Simple Example
12281
12282 =back
12283
12284 =item DB_BTREE
12285
12286 =over 4
12287
12288 =item Changing the BTREE sort order
12289
12290 =item Handling Duplicate Keys 
12291
12292 =item The get_dup() Method
12293
12294 =item The find_dup() Method
12295
12296 =item The del_dup() Method
12297
12298 =item Matching Partial Keys 
12299
12300 =back
12301
12302 =item DB_RECNO
12303
12304 =over 4
12305
12306 =item The 'bval' Option
12307
12308 =item A Simple Example
12309
12310 =item Extra RECNO Methods
12311
12312 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
12313 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
12314 length, elements);>
12315
12316 =item Another Example
12317
12318 =back
12319
12320 =item THE API INTERFACE
12321
12322 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
12323 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
12324 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
12325 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
12326
12327 =item DBM FILTERS
12328
12329 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
12330 B<filter_fetch_value>
12331
12332 =over 4
12333
12334 =item The Filter
12335
12336 =item An Example -- the NULL termination problem.
12337
12338 =item Another Example -- Key is a C int.
12339
12340 =back
12341
12342 =item HINTS AND TIPS 
12343
12344 =over 4
12345
12346 =item Locking: The Trouble with fd
12347
12348 =item Safe ways to lock a database
12349
12350 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
12351
12352 =item Sharing Databases With C Applications
12353
12354 =item The untie() Gotcha
12355
12356 =back
12357
12358 =item COMMON QUESTIONS
12359
12360 =over 4
12361
12362 =item Why is there Perl source in my database?
12363
12364 =item How do I store complex data structures with DB_File?
12365
12366 =item What does "Invalid Argument" mean?
12367
12368 =item What does "Bareword 'DB_File' not allowed" mean? 
12369
12370 =back
12371
12372 =item REFERENCES
12373
12374 =item HISTORY
12375
12376 =item BUGS
12377
12378 =item AVAILABILITY
12379
12380 =item COPYRIGHT
12381
12382 =item SEE ALSO
12383
12384 =item AUTHOR
12385
12386 =back
12387
12388 =head2 Data::Dumper - stringified perl data structures, suitable for both
12389 printing and C<eval>
12390
12391 =over 4
12392
12393 =item SYNOPSIS
12394
12395 =item DESCRIPTION
12396
12397 =over 4
12398
12399 =item Methods
12400
12401 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or> 
12402 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
12403 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
12404 I<$OBJ>->Reset
12405
12406 =item Functions
12407
12408 Dumper(I<LIST>)
12409
12410 =item Configuration Variables or Methods
12411
12412 =item Exports
12413
12414 Dumper
12415
12416 =back
12417
12418 =item EXAMPLES
12419
12420 =item BUGS
12421
12422 =over 4
12423
12424 =item NOTE
12425
12426 =back
12427
12428 =item AUTHOR
12429
12430 =item VERSION
12431
12432 =item SEE ALSO
12433
12434 =back
12435
12436 =head2 Devel::DProf - a Perl code profiler
12437
12438 =over 4
12439
12440 =item SYNOPSIS
12441
12442 =item DESCRIPTION
12443
12444 =item PROFILE FORMAT
12445
12446 =item AUTOLOAD
12447
12448 =item ENVIRONMENT
12449
12450 =item BUGS
12451
12452 =item SEE ALSO
12453
12454 =back
12455
12456 =head2 Devel::PPPort - Perl/Pollution/Portability
12457
12458 =over 4
12459
12460 =item SYNOPSIS
12461
12462 =item DESCRIPTION
12463
12464 =over 4
12465
12466 =item Why use ppport.h?
12467
12468 You should use F<ppport.h> in modern code so that your code will work
12469 with the widest range of Perl interpreters possible, without significant
12470 additional work.
12471
12472 =item How to use ppport.h
12473
12474 =item Running ppport.h
12475
12476 =back
12477
12478 =item FUNCTIONS
12479
12480 =over 4
12481
12482 =item WriteFile
12483
12484 =back
12485
12486 =item COMPATIBILITY
12487
12488 =over 4
12489
12490 =item Provided Perl compatibility API
12491
12492 =item Perl API not supported by ppport.h
12493
12494 perl 5.9.2, perl 5.9.1, perl 5.9.0, perl 5.8.3, perl 5.8.1, perl 5.8.0,
12495 perl 5.7.3, perl 5.7.2, perl 5.7.1, perl 5.6.1, perl 5.6.0, perl 5.005_03,
12496 perl 5.005, perl 5.004_05, perl 5.004_04, perl 5.004
12497
12498 =back
12499
12500 =item BUGS
12501
12502 =item AUTHORS
12503
12504 =item COPYRIGHT
12505
12506 =item SEE ALSO
12507
12508 =back
12509
12510 =head2 Devel::Peek - A data debugging tool for the XS programmer
12511
12512 =over 4
12513
12514 =item SYNOPSIS
12515
12516 =item DESCRIPTION
12517
12518 =over 4
12519
12520 =item Runtime debugging
12521
12522 =item Memory footprint debugging
12523
12524 =back
12525
12526 =item EXAMPLES
12527
12528 =over 4
12529
12530 =item A simple scalar string
12531
12532 =item A simple scalar number
12533
12534 =item A simple scalar with an extra reference
12535
12536 =item A reference to a simple scalar
12537
12538 =item A reference to an array
12539
12540 =item A reference to a hash
12541
12542 =item Dumping a large array or hash
12543
12544 =item A reference to an SV which holds a C pointer
12545
12546 =item A reference to a subroutine
12547
12548 =back
12549
12550 =item EXPORTS
12551
12552 =item BUGS
12553
12554 =item AUTHOR
12555
12556 =item SEE ALSO
12557
12558 =back
12559
12560 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
12561
12562 =over 4
12563
12564 =item SYNOPSIS
12565
12566 =item DESCRIPTION
12567
12568 =back
12569
12570 =head2 Digest - Modules that calculate message digests
12571
12572 =over 4
12573
12574 =item SYNOPSIS
12575
12576 =item DESCRIPTION
12577
12578 I<binary>, I<hex>, I<base64>
12579
12580 =item OO INTERFACE
12581
12582 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
12583 Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset,
12584 $ctx->add( $data, ... ), $ctx->addfile( $io_handle ), $ctx->add_bits(
12585 $data, $nbits ), $ctx->add_bits( $bitstring ), $ctx->digest,
12586 $ctx->hexdigest, $ctx->b64digest
12587
12588 =item Digest speed
12589
12590 =item SEE ALSO
12591
12592 =item AUTHOR
12593
12594 =back
12595
12596 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
12597
12598 =over 4
12599
12600 =item SYNOPSIS
12601
12602 =item DESCRIPTION
12603
12604 =item FUNCTIONS
12605
12606 md5($data,...), md5_hex($data,...), md5_base64($data,...)
12607
12608 =item METHODS
12609
12610 $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...),
12611 $md5->addfile($io_handle), $md5->add_bits($data, $nbits),
12612 $md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest
12613
12614 =item EXAMPLES
12615
12616 =item SEE ALSO
12617
12618 =item COPYRIGHT
12619
12620 =item AUTHORS
12621
12622 =back
12623
12624 =head2 Digest::base - Digest base class
12625
12626 =over 4
12627
12628 =item SYNOPSIS
12629
12630 =item DESCRIPTION
12631
12632 =item SEE ALSO
12633
12634 =back
12635
12636 =head2 Digest::file - Calculate digests of files
12637
12638 =over 4
12639
12640 =item SYNOPSIS
12641
12642 =item DESCRIPTION
12643
12644 digest_file( $file, $algorithm, [$arg,...] ), digest_file_hex( $file,
12645 $algorithm, [$arg,...] ), digest_file_base64( $file, $algorithm, [$arg,...]
12646 )
12647
12648 =item SEE ALSO
12649
12650 =back
12651
12652 =head2 DirHandle - supply object methods for directory handles
12653
12654 =over 4
12655
12656 =item SYNOPSIS
12657
12658 =item DESCRIPTION
12659
12660 =item NOTES
12661
12662 =back
12663
12664 =head2 Dumpvalue - provides screen dump of Perl data.
12665
12666 =over 4
12667
12668 =item SYNOPSIS
12669
12670 =item DESCRIPTION
12671
12672 =over 4
12673
12674 =item Creation
12675
12676 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
12677 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
12678 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
12679 stopDbSignal
12680
12681 =item Methods
12682
12683 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
12684 compactDump, veryCompact, set, get
12685
12686 =back
12687
12688 =back
12689
12690 =head2 DynaLoader - Dynamically load C libraries into Perl code
12691
12692 =over 4
12693
12694 =item SYNOPSIS
12695
12696 =item DESCRIPTION
12697
12698 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
12699 @dl_modules, @dl_shared_objects, dl_error(), $dl_debug, dl_findfile(),
12700 dl_expandspec(), dl_load_file(), dl_unload_file(), dl_load_flags(),
12701 dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(),
12702 dl_install_xsub(), bootstrap()
12703
12704 =item AUTHOR
12705
12706 =back
12707
12708 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
12709 Perl code
12710
12711 =over 4
12712
12713 =item SYNOPSIS
12714
12715 =item DESCRIPTION
12716
12717 =over 4
12718
12719 =item Migration from C<DynaLoader>
12720
12721 =item Backward compatible boilerplate
12722
12723 =back
12724
12725 =item Order of initialization: early load()
12726
12727 =over 4
12728
12729 =item The most hairy case
12730
12731 =back
12732
12733 =item LIMITATIONS
12734
12735 =item AUTHOR
12736
12737 =back
12738
12739 =head2 Encode - character encodings
12740
12741 =over 4
12742
12743 =item SYNOPSIS
12744
12745 =over 4
12746
12747 =item Table of Contents
12748
12749 =back
12750
12751 =item DESCRIPTION
12752
12753 =over 4
12754
12755 =item TERMINOLOGY
12756
12757 =back
12758
12759 =item PERL ENCODING API
12760
12761 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
12762 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
12763 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
12764 CHECK]);
12765
12766 =over 4
12767
12768 =item Listing available encodings
12769
12770 =item Defining Aliases
12771
12772 =back
12773
12774 =item Encoding via PerlIO
12775
12776 =item Handling Malformed Data
12777
12778 B<NOTE:> Not all encoding suppport this feature, I<CHECK> =
12779 Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1), I<CHECK> =
12780 Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode (I<CHECK> =
12781 Encode::FB_PERLQQ), HTML charref mode (I<CHECK> = Encode::FB_HTMLCREF), XML
12782 charref mode (I<CHECK> = Encode::FB_XMLCREF), The bitmask
12783
12784 =over 4
12785
12786 =item Unimplemented fallback schemes
12787
12788 =back
12789
12790 =item Defining Encodings
12791
12792 =item The UTF-8 flag
12793
12794 Goal #1:, Goal #2:, Goal #3:, Goal #4:
12795
12796 =over 4
12797
12798 =item Messing with Perl's Internals
12799
12800 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
12801
12802 =back
12803
12804 =item SEE ALSO
12805
12806 =item MAINTAINER
12807
12808 =back
12809
12810 =head2 Encode::Alias - alias definitions to encodings
12811
12812 =over 4
12813
12814 =item SYNOPSIS
12815
12816 =item DESCRIPTION
12817
12818 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
12819 reference, e.g.:
12820
12821 =over 4
12822
12823 =item Alias overloading
12824
12825 =back
12826
12827 =item SEE ALSO
12828
12829 =back
12830
12831 =head2 Encode::Byte - Single Byte Encodings
12832
12833 =over 4
12834
12835 =item SYNOPSIS
12836
12837 =item ABSTRACT
12838
12839 =item DESCRIPTION
12840
12841 =item SEE ALSO
12842
12843 =back
12844
12845 =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
12846
12847 =head2 Encode::CN - China-based Chinese Encodings
12848
12849 =over 4
12850
12851 =item SYNOPSIS
12852
12853 =item DESCRIPTION
12854
12855 =item NOTES
12856
12857 =item BUGS
12858
12859 =item SEE ALSO
12860
12861 =back
12862
12863 =head2 Encode::CN::HZ -- internally used by Encode::CN
12864
12865 =head2 Encode::Config -- internally used by Encode
12866
12867 =head2 Encode::EBCDIC - EBCDIC Encodings
12868
12869 =over 4
12870
12871 =item SYNOPSIS
12872
12873 =item ABSTRACT
12874
12875 =item DESCRIPTION
12876
12877 =item SEE ALSO
12878
12879 =back
12880
12881 =head2 Encode::Encoding - Encode Implementation Base Class
12882
12883 =over 4
12884
12885 =item SYNOPSIS
12886
12887 =item DESCRIPTION
12888
12889 =over 4
12890
12891 =item Methods you should implement
12892
12893 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
12894 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
12895
12896 =item Other methods defined in Encode::Encodings
12897
12898 -E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(),
12899 -E<gt>needs_lines()
12900
12901 =item Example: Encode::ROT13
12902
12903 =back
12904
12905 =item Why the heck Encode API is different?
12906
12907 =over 4
12908
12909 =item Compiled Encodings
12910
12911 =back
12912
12913 =item SEE ALSO
12914
12915 Scheme 1, Scheme 2, Other Schemes
12916
12917 =back
12918
12919 =head2 Encode::Guess -- Guesses encoding from data
12920
12921 =over 4
12922
12923 =item SYNOPSIS
12924
12925 =item ABSTRACT
12926
12927 =item DESCRIPTION
12928
12929 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
12930 Encode::decode("Guess" ...), Encode::Guess->guess($data),
12931 guess_encoding($data, [, I<list of suspects>])
12932
12933 =item CAVEATS
12934
12935 =item TO DO
12936
12937 =item SEE ALSO
12938
12939 =back
12940
12941 =head2 Encode::JP - Japanese Encodings
12942
12943 =over 4
12944
12945 =item SYNOPSIS
12946
12947 =item ABSTRACT
12948
12949 =item DESCRIPTION
12950
12951 =item Note on ISO-2022-JP(-1)?
12952
12953 =item BUGS
12954
12955 =item SEE ALSO
12956
12957 =back
12958
12959 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
12960
12961 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
12962
12963 =head2 Encode::KR - Korean Encodings
12964
12965 =over 4
12966
12967 =item SYNOPSIS
12968
12969 =item DESCRIPTION
12970
12971 =item BUGS
12972
12973 =item SEE ALSO
12974
12975 =back
12976
12977 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
12978
12979 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
12980
12981 =over 4
12982
12983 =item SYNOPSIS
12984
12985 =item ABSTRACT
12986
12987 =item DESCRIPTION
12988
12989 =item BUGS
12990
12991 =item SEE ALSO
12992
12993 =back
12994
12995 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
12996
12997 =over 4
12998
12999 =item Overview
13000
13001 =item How does it work?
13002
13003 =item Line Buffering
13004
13005 =over 4
13006
13007 =item How can I tell whether my encoding fully supports PerlIO ?
13008
13009 =back
13010
13011 =item SEE ALSO
13012
13013 =back
13014
13015 =head2 Encode::Supported -- Encodings supported by Encode
13016
13017 =over 4
13018
13019 =item DESCRIPTION
13020
13021 =over 4
13022
13023 =item Encoding Names
13024
13025 =back
13026
13027 =item Supported Encodings
13028
13029 =over 4
13030
13031 =item Built-in Encodings
13032
13033 =item Encode::Unicode -- other Unicode encodings
13034
13035 =item Encode::Byte -- Extended ASCII
13036
13037 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
13038 the Cyrillic world, gsm0338 - Hentai Latin 1
13039
13040 =item CJK: Chinese, Japanese, Korean (Multibyte)
13041
13042 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
13043 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
13044 Encode::JIS2K -- JIS X 0213 encodings via CPAN
13045
13046 =item Miscellaneous encodings
13047
13048 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
13049
13050 =back
13051
13052 =item Unsupported encodings
13053
13054   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
13055 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
13056 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
13057 Various Mac encodings, (Mac) Indic encodings
13058
13059 =item Encoding vs. Charset -- terminology
13060
13061 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
13062
13063 =over 4
13064
13065 =item Microsoft-related naming mess
13066
13067 KS_C_5601-1987, GB2312, Big5, Shift_JIS
13068
13069 =back
13070
13071 =item Glossary
13072
13073 character repertoire, coded character set (CCS), character encoding scheme
13074 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
13075 UTF-16
13076
13077 =item See Also
13078
13079 =item References
13080
13081 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
13082 RFC, UC, Unicode Glossary
13083
13084 =over 4
13085
13086 =item Other Notable Sites
13087
13088 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
13089 "Introduction to i18n"
13090
13091 =item Offline sources
13092
13093 C<CJKV Information Processing> by Ken Lunde
13094
13095 =back
13096
13097 =back
13098
13099 =head2 Encode::Symbol - Symbol Encodings
13100
13101 =over 4
13102
13103 =item SYNOPSIS
13104
13105 =item ABSTRACT
13106
13107 =item DESCRIPTION
13108
13109 =item SEE ALSO
13110
13111 =back
13112
13113 =head2 Encode::TW - Taiwan-based Chinese Encodings
13114
13115 =over 4
13116
13117 =item SYNOPSIS
13118
13119 =item DESCRIPTION
13120
13121 =item NOTES
13122
13123 =item BUGS
13124
13125 =item SEE ALSO
13126
13127 =back
13128
13129 =head2 Encode::Unicode -- Various Unicode Transformation Formats
13130
13131 =over 4
13132
13133 =item SYNOPSIS
13134
13135 =item ABSTRACT
13136
13137 L<http://www.unicode.org/glossary/> says:, Quick Reference
13138
13139 =item Size, Endianness, and BOM
13140
13141 =over 4
13142
13143 =item by size
13144
13145 =item by endianness
13146
13147 BOM as integer when fetched in network byte order
13148
13149 =back
13150
13151 =item Surrogate Pairs
13152
13153 =item Error Checking
13154
13155 =item SEE ALSO
13156
13157 =back
13158
13159 =head2 Encode::Unicode::UTF7 -- UTF-7 encoding
13160
13161 =over 4
13162
13163 =item SYNOPSIS
13164
13165 =item ABSTRACT
13166
13167 =item In Practice
13168
13169 =item SEE ALSO
13170
13171 =back
13172
13173 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
13174 encodings
13175
13176 =over 4
13177
13178 =item SYNOPSIS
13179
13180 =item DESCRIPTION
13181
13182 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
13183 reference, e.g.:
13184
13185 =over 4
13186
13187 =item Alias overloading
13188
13189 =back
13190
13191 =item SEE ALSO
13192
13193 =back
13194
13195 =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm --
13196 Internally used by Encode::??::ISO_2022_*
13197
13198 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
13199 Encode::CN
13200
13201 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
13202 Encode
13203
13204 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
13205 Implementation Base Class
13206
13207 =over 4
13208
13209 =item SYNOPSIS
13210
13211 =item DESCRIPTION
13212
13213 =over 4
13214
13215 =item Methods you should implement
13216
13217 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
13218 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
13219
13220 =item Other methods defined in Encode::Encodings
13221
13222 -E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(),
13223 -E<gt>needs_lines()
13224
13225 =item Example: Encode::ROT13
13226
13227 =back
13228
13229 =item Why the heck Encode API is different?
13230
13231 =over 4
13232
13233 =item Compiled Encodings
13234
13235 =back
13236
13237 =item SEE ALSO
13238
13239 Scheme 1, Scheme 2, Other Schemes
13240
13241 =back
13242
13243 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
13244 data
13245
13246 =over 4
13247
13248 =item SYNOPSIS
13249
13250 =item ABSTRACT
13251
13252 =item DESCRIPTION
13253
13254 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
13255 Encode::decode("Guess" ...), Encode::Guess->guess($data),
13256 guess_encoding($data, [, I<list of suspects>])
13257
13258 =item CAVEATS
13259
13260 =item TO DO
13261
13262 =item SEE ALSO
13263
13264 =back
13265
13266 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
13267 Encode::JP::2022_JP*
13268
13269 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
13270 by Encode::JP
13271
13272 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
13273 used by Encode::KR
13274
13275 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
13276 and 'Q' header encoding
13277
13278 =over 4
13279
13280 =item SYNOPSIS
13281
13282 =item ABSTRACT
13283
13284 =item DESCRIPTION
13285
13286 =item BUGS
13287
13288 =item SEE ALSO
13289
13290 =back
13291
13292 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
13293 on Encode and PerlIO
13294
13295 =over 4
13296
13297 =item Overview
13298
13299 =item How does it work?
13300
13301 =item Line Buffering
13302
13303 =over 4
13304
13305 =item How can I tell whether my encoding fully supports PerlIO ?
13306
13307 =back
13308
13309 =item SEE ALSO
13310
13311 =back
13312
13313 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
13314 supported by Encode
13315
13316 =over 4
13317
13318 =item DESCRIPTION
13319
13320 =over 4
13321
13322 =item Encoding Names
13323
13324 =back
13325
13326 =item Supported Encodings
13327
13328 =over 4
13329
13330 =item Built-in Encodings
13331
13332 =item Encode::Unicode -- other Unicode encodings
13333
13334 =item Encode::Byte -- Extended ASCII
13335
13336 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
13337 the Cyrillic world, gsm0338 - Hentai Latin 1
13338
13339 =item CJK: Chinese, Japanese, Korean (Multibyte)
13340
13341 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
13342 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
13343 Encode::JIS2K -- JIS X 0213 encodings via CPAN
13344
13345 =item Miscellaneous encodings
13346
13347 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
13348
13349 =back
13350
13351 =item Unsupported encodings
13352
13353   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
13354 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
13355 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
13356 Various Mac encodings, (Mac) Indic encodings
13357
13358 =item Encoding vs. Charset -- terminology
13359
13360 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
13361
13362 =over 4
13363
13364 =item Microsoft-related naming mess
13365
13366 KS_C_5601-1987, GB2312, Big5, Shift_JIS
13367
13368 =back
13369
13370 =item Glossary
13371
13372 character repertoire, coded character set (CCS), character encoding scheme
13373 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
13374 UTF-16
13375
13376 =item See Also
13377
13378 =item References
13379
13380 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
13381 RFC, UC, Unicode Glossary
13382
13383 =over 4
13384
13385 =item Other Notable Sites
13386
13387 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
13388 "Introduction to i18n"
13389
13390 =item Offline sources
13391
13392 C<CJKV Information Processing> by Ken Lunde
13393
13394 =back
13395
13396 =back
13397
13398 =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7
13399 encoding
13400
13401 =over 4
13402
13403 =item SYNOPSIS
13404
13405 =item ABSTRACT
13406
13407 =item In Practice
13408
13409 =item SEE ALSO
13410
13411 =back
13412
13413 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
13414
13415 =over 4
13416
13417 =item SYNOPSIS
13418
13419 =item ABSTRACT
13420
13421 =item Description
13422
13423 =over 4
13424
13425 =item Predefined Methods
13426
13427 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
13428 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
13429 $e-E<gt>bytes([$encoding])
13430
13431 =item Example: base64 transcoder
13432
13433 =item Operator Overloading
13434
13435 =back
13436
13437 =item SEE ALSO
13438
13439 =back
13440
13441 =head2 Encodencoding, encoding - allows you to write your script in
13442 non-ascii or non-utf8
13443
13444 =over 4
13445
13446 =item SYNOPSIS
13447
13448 =item ABSTRACT
13449
13450 =over 4
13451
13452 =item Literal Conversions
13453
13454 =item PerlIO layers for C<STD(IN|OUT)>
13455
13456 =item Implicit upgrading for byte strings
13457
13458 =back
13459
13460 =item FEATURES THAT REQUIRE 5.8.1
13461
13462 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
13463
13464 =item USAGE
13465
13466 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
13467 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
13468
13469 =item The Filter Option
13470
13471 =over 4
13472
13473 =item Filter-related changes at Encode version 1.87
13474
13475 =back
13476
13477 =item CAVEATS
13478
13479 =over 4
13480
13481 =item NOT SCOPED
13482
13483 =item DO NOT MIX MULTIPLE ENCODINGS
13484
13485 =item tr/// with ranges
13486
13487 Legend of characters above
13488
13489 =back
13490
13491 =item EXAMPLE - Greekperl
13492
13493 =item KNOWN PROBLEMS
13494
13495 literals in regex that are longer than 127 bytes, EBCDIC, format
13496
13497 =over 4
13498
13499 =item The Logic of :locale
13500
13501 =back
13502
13503 =item HISTORY
13504
13505 =item SEE ALSO
13506
13507 =back
13508
13509 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
13510
13511 =over 4
13512
13513 =item SYNOPSIS
13514
13515 =item ABSTRACT
13516
13517 =item Description
13518
13519 =over 4
13520
13521 =item Predefined Methods
13522
13523 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
13524 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
13525 $e-E<gt>bytes([$encoding])
13526
13527 =item Example: base64 transcoder
13528
13529 =item Operator Overloading
13530
13531 =back
13532
13533 =item SEE ALSO
13534
13535 =back
13536
13537 =head2 English - use nice English (or awk) names for ugly punctuation
13538 variables
13539
13540 =over 4
13541
13542 =item SYNOPSIS
13543
13544 =item DESCRIPTION
13545
13546 =item PERFORMANCE
13547
13548 =back
13549
13550 =head2 Env - perl module that imports environment variables as scalars or
13551 arrays
13552
13553 =over 4
13554
13555 =item SYNOPSIS
13556
13557 =item DESCRIPTION
13558
13559 =item LIMITATIONS
13560
13561 =item AUTHOR
13562
13563 =back
13564
13565 =head2 Errno - System errno constants
13566
13567 =over 4
13568
13569 =item SYNOPSIS
13570
13571 =item DESCRIPTION
13572
13573 =item CAVEATS
13574
13575 =item AUTHOR
13576
13577 =item COPYRIGHT
13578
13579 =back
13580
13581 =head2 Exporter - Implements default import method for modules
13582
13583 =over 4
13584
13585 =item SYNOPSIS
13586
13587 =item DESCRIPTION
13588
13589 =over 4
13590
13591 =item How to Export
13592
13593 =item Selecting What To Export
13594
13595 =item How to Import
13596
13597 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
13598
13599 =back
13600
13601 =item Advanced features
13602
13603 =over 4
13604
13605 =item Specialised Import Lists
13606
13607 =item Exporting without using Exporter's import method
13608
13609 =item Exporting without inheriting from Exporter
13610
13611 =item Module Version Checking
13612
13613 =item Managing Unknown Symbols
13614
13615 =item Tag Handling Utility Functions
13616
13617 =item Generating combined tags
13618
13619 =item C<AUTOLOAD>ed Constants
13620
13621 =back
13622
13623 =back
13624
13625 =head2 Exporter::Heavy - Exporter guts
13626
13627 =over 4
13628
13629 =item SYNOPSIS
13630
13631 =item DESCRIPTION
13632
13633 =back
13634
13635 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
13636 Makefiles etc.
13637
13638 =over 4
13639
13640 =item SYNOPSIS
13641
13642 =item DESCRIPTION
13643
13644 =back
13645
13646 cat
13647
13648 eqtime src dst
13649
13650 rm_rf files...
13651
13652 rm_f files...
13653
13654 touch files ..
13655
13656 mv source... destination
13657
13658 cp source... destination
13659
13660 chmod mode files..
13661
13662 mkpath directory..
13663
13664 test_f file
13665
13666 dos2unix
13667
13668 =over 4
13669
13670 =item BUGS
13671
13672 =item SEE ALSO 
13673
13674 =item AUTHOR
13675
13676 =back
13677
13678 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
13679
13680 =over 4
13681
13682 =item SYNOPSIS
13683
13684 =item DESCRIPTION
13685
13686 B<test_harness>
13687
13688 =back
13689
13690 B<pod2man>
13691
13692 B<warn_if_old_packlist>
13693
13694 B<perllocal_install>
13695
13696 B<uninstall>
13697
13698 =head2 ExtUtils::Constant - generate XS code to import C header constants
13699
13700 =over 4
13701
13702 =item SYNOPSIS
13703
13704 =item DESCRIPTION
13705
13706 =item USAGE
13707
13708 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
13709
13710 =item FUNCTIONS
13711
13712 =back
13713
13714 constant_types
13715
13716 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
13717
13718 autoload PACKAGE, VERSION, AUTOLOADER
13719
13720 WriteMakefileSnippet
13721
13722 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
13723 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
13724
13725 =over 4
13726
13727 =item AUTHOR
13728
13729 =back
13730
13731 =head2 ExtUtils::Constant::Base - base class for ExtUtils::Constant objects
13732
13733 =over 4
13734
13735 =item SYNOPSIS
13736
13737 =item DESCRIPTION
13738
13739 =item USAGE
13740
13741 =back
13742
13743 header
13744
13745 memEQ_clause args_hashref
13746
13747 dump_names arg_hashref, ITEM..
13748
13749 assign arg_hashref, VALUE..
13750
13751 return_clause arg_hashref, ITEM
13752
13753 switch_clause arg_hashref, NAMELEN, ITEMHASH, ITEM..
13754
13755 params WHAT
13756
13757 dogfood arg_hashref, ITEM..
13758
13759 C_constant arg_hashref, ITEM.., name, type, value, macro, default, pre,
13760 post, def_pre, def_post, utf8, weight
13761
13762 =over 4
13763
13764 =item BUGS
13765
13766 =item AUTHOR
13767
13768 =back
13769
13770 =head2 ExtUtils::Constant::Utils - helper functions for ExtUtils::Constant
13771
13772 =over 4
13773
13774 =item SYNOPSIS
13775
13776 =item DESCRIPTION
13777
13778 =item USAGE
13779
13780 C_stringify NAME
13781
13782 =back
13783
13784 perl_stringify NAME
13785
13786 =over 4
13787
13788 =item AUTHOR
13789
13790 =back
13791
13792 =head2 ExtUtils::Constant::XS, ExtUtils::Constant::Base - base class for
13793 ExtUtils::Constant objects
13794
13795 =over 4
13796
13797 =item SYNOPSIS
13798
13799 =item DESCRIPTION
13800
13801 =item BUGS
13802
13803 =item AUTHOR
13804
13805 =back
13806
13807 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
13808
13809 =over 4
13810
13811 =item SYNOPSIS
13812
13813 =item DESCRIPTION
13814
13815 =item @EXPORT
13816
13817 =item FUNCTIONS
13818
13819 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
13820 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
13821
13822 =item EXAMPLES
13823
13824 =item SEE ALSO
13825
13826 =item AUTHOR
13827
13828 =back
13829
13830 =head2 ExtUtils::Install - install files from here to there
13831
13832 =over 4
13833
13834 =item SYNOPSIS
13835
13836 =item DESCRIPTION
13837
13838 =over 4
13839
13840 =item Functions
13841
13842 B<install>
13843
13844 =back
13845
13846 =back
13847
13848 B<install_default> I<DISCOURAGED>
13849
13850 B<uninstall>
13851
13852 B<pm_to_blib>
13853
13854 _autosplit
13855
13856 =over 4
13857
13858 =item ENVIRONMENT
13859
13860 B<PERL_INSTALL_ROOT>
13861
13862 =item AUTHOR
13863
13864 =item LICENSE
13865
13866 =back
13867
13868 =head2 ExtUtils::Installed - Inventory management of installed modules
13869
13870 =over 4
13871
13872 =item SYNOPSIS
13873
13874 =item DESCRIPTION
13875
13876 =item USAGE
13877
13878 =item FUNCTIONS
13879
13880 new(), modules(), files(), directories(), directory_tree(), validate(),
13881 packlist(), version()
13882
13883 =item EXAMPLE
13884
13885 =item AUTHOR
13886
13887 =back
13888
13889 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
13890
13891 =over 4
13892
13893 =item SYNOPSIS
13894
13895 =item DESCRIPTION
13896
13897 For static extensions, For dynamic extensions at build/link time, For
13898 dynamic extensions at load time
13899
13900 =over 4
13901
13902 =item EXTRALIBS
13903
13904 =item LDLOADLIBS and LD_RUN_PATH
13905
13906 =item BSLOADLIBS
13907
13908 =back
13909
13910 =item PORTABILITY
13911
13912 =over 4
13913
13914 =item VMS implementation
13915
13916 =item Win32 implementation
13917
13918 =back
13919
13920 =item SEE ALSO
13921
13922 =back
13923
13924 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
13925
13926 =over 4
13927
13928 =item SYNOPSIS
13929
13930 =item DESCRIPTION
13931
13932 =back
13933
13934 =head2 ExtUtils::MM_Any - Platform-agnostic MM methods
13935
13936 =over 4
13937
13938 =item SYNOPSIS
13939
13940 =item DESCRIPTION
13941
13942 =item Inherently Cross-Platform Methods
13943
13944 installvars
13945
13946 =back
13947
13948 os_flavor_is
13949
13950 dir_target B<DEPRECATED>
13951
13952 blibdirs_target (o)
13953
13954 =over 4
13955
13956 =item File::Spec wrappers
13957
13958 catfile
13959
13960 =back
13961
13962 =over 4
13963
13964 =item Thought To Be Cross-Platform Methods
13965
13966 B<split_command>
13967
13968 =back
13969
13970 B<echo>
13971
13972 init_VERSION
13973
13974 wraplist
13975
13976 manifypods
13977
13978 manifypods_target
13979
13980 makemakerdflt_target
13981
13982 special_targets
13983
13984 POD2MAN_macro
13985
13986 test_via_harness
13987
13988 test_via_script
13989
13990 libscan
13991
13992 tool_autosplit
13993
13994 all_target
13995
13996 metafile_target
13997
13998 signature_target
13999
14000 metafile_addtomanifest_target
14001
14002 signature_addtomanifest_target
14003
14004 =over 4
14005
14006 =item Abstract methods
14007
14008 oneliner, B<quote_literal>, B<escape_newlines>, max_exec_len,
14009 B<init_others>, init_DIRFILESEP, init_linker, init_platform,
14010 platform_constants
14011
14012 =back
14013
14014 os_flavor
14015
14016 =over 4
14017
14018 =item AUTHOR
14019
14020 =back
14021
14022 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
14023 ExtUtils::MakeMaker
14024
14025 =over 4
14026
14027 =item SYNOPSIS
14028
14029 =item DESCRIPTION
14030
14031 =back
14032
14033 os_flavor (o)
14034
14035 init_linker
14036
14037 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
14038 ExtUtils::MakeMaker
14039
14040 =over 4
14041
14042 =item SYNOPSIS
14043
14044 =item DESCRIPTION
14045
14046 os_flavor (o)
14047
14048 =back
14049
14050 cflags (o)
14051
14052 replace_manpage_separator (o)
14053
14054 init_linker
14055
14056 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
14057
14058 =over 4
14059
14060 =item SYNOPSIS
14061
14062 =item DESCRIPTION
14063
14064 =over 4
14065
14066 =item Overridden methods
14067
14068 os_flavor
14069
14070 =back
14071
14072 =back
14073
14074 B<replace_manpage_separator>
14075
14076 =over 4
14077
14078 =item AUTHOR
14079
14080 =item SEE ALSO
14081
14082 =back
14083
14084 =head2 ExtUtils::MM_MacOS - once produced Makefiles for MacOS Classic
14085
14086 =over 4
14087
14088 =item SYNOPSIS
14089
14090 =item DESCRIPTION
14091
14092 =back
14093
14094 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
14095 ExtUtils::MakeMaker
14096
14097 =over 4
14098
14099 =item SYNOPSIS
14100
14101 =item DESCRIPTION
14102
14103 =back
14104
14105 os_flavor
14106
14107 init_platform (o), platform_constants
14108
14109 const_cccmd (o)
14110
14111 static_lib (o)
14112
14113 dynamic_lib (o)
14114
14115 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
14116 ExtUtils::MakeMaker
14117
14118 =over 4
14119
14120 =item SYNOPSIS
14121
14122 =item DESCRIPTION
14123
14124 =item METHODS
14125
14126 init_dist (o)
14127
14128 =back
14129
14130 init_linker
14131
14132 os_flavor
14133
14134 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
14135
14136 =over 4
14137
14138 =item SYNOPSIS
14139
14140 =item DESCRIPTION
14141
14142 =over 4
14143
14144 =item Overridden methods
14145
14146 os_flavor
14147
14148 =back
14149
14150 =back
14151
14152 B<replace_manpage_separator>
14153
14154 =over 4
14155
14156 =item AUTHOR
14157
14158 =item SEE ALSO
14159
14160 =back
14161
14162 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
14163
14164 =over 4
14165
14166 =item SYNOPSIS
14167
14168 =item DESCRIPTION
14169
14170 =item METHODS
14171
14172 =back
14173
14174 =over 4
14175
14176 =item Methods
14177
14178 os_flavor (o)
14179
14180 =back
14181
14182 c_o (o)
14183
14184 cflags (o)
14185
14186 clean (o)
14187
14188 clean_subdirs_target
14189
14190 const_cccmd (o)
14191
14192 const_config (o)
14193
14194 const_loadlibs (o)
14195
14196 constants (o)
14197
14198 depend (o)
14199
14200 init_DEST
14201
14202 init_dist
14203
14204 dist (o)
14205
14206 dist_basics (o)
14207
14208 dist_ci (o)
14209
14210 dist_core (o)
14211
14212 B<dist_target>
14213
14214 B<tardist_target>
14215
14216 B<zipdist_target>
14217
14218 B<tarfile_target>
14219
14220 zipfile_target
14221
14222 uutardist_target
14223
14224 shdist_target
14225
14226 distdir
14227
14228 dist_test
14229
14230 dlsyms (o)
14231
14232 dynamic (o)
14233
14234 dynamic_bs (o)
14235
14236 dynamic_lib (o)
14237
14238 exescan
14239
14240 extliblist
14241
14242 find_perl
14243
14244 find_tests
14245
14246 =over 4
14247
14248 =item Methods to actually produce chunks of text for the Makefile
14249
14250 fixin
14251
14252 =back
14253
14254 force (o)
14255
14256 guess_name
14257
14258 has_link_code
14259
14260 init_dirscan
14261
14262 init_DIRFILESEP
14263
14264 init_main
14265
14266 init_others
14267
14268 init_INST
14269
14270 init_INSTALL
14271
14272 init_linker
14273
14274 init_lib2arch
14275
14276 init_PERL
14277
14278 init_platform (o), platform_constants (o)
14279
14280 init_PERM
14281
14282 init_xs
14283
14284 install (o)
14285
14286 installbin (o)
14287
14288 linkext (o)
14289
14290 lsdir
14291
14292 macro (o)
14293
14294 makeaperl (o)
14295
14296 makefile (o)
14297
14298 maybe_command
14299
14300 needs_linking (o)
14301
14302 nicetext
14303
14304 parse_abstract
14305
14306 parse_version
14307
14308 pasthru (o)
14309
14310 perl_script
14311
14312 perldepend (o)
14313
14314 perm_rw (o)
14315
14316 perm_rwx (o)
14317
14318 pm_to_blib
14319
14320 post_constants (o)
14321
14322 post_initialize (o)
14323
14324 postamble (o)
14325
14326 ppd
14327
14328 prefixify
14329
14330 processPL (o)
14331
14332 quote_paren
14333
14334 realclean (o)
14335
14336 realclean_subdirs_target
14337
14338 replace_manpage_separator
14339
14340 oneliner (o)
14341
14342 quote_literal
14343
14344 escape_newlines
14345
14346 max_exec_len
14347
14348 static (o)
14349
14350 static_lib (o)
14351
14352 staticmake (o)
14353
14354 subdir_x (o)
14355
14356 subdirs (o)
14357
14358 test (o)
14359
14360 test_via_harness (override)
14361
14362 test_via_script (override)
14363
14364 tools_other (o)
14365
14366 tool_xsubpp (o)
14367
14368 all_target
14369
14370 top_targets (o)
14371
14372 writedoc
14373
14374 xs_c (o)
14375
14376 xs_cpp (o)
14377
14378 xs_o (o)
14379
14380 =over 4
14381
14382 =item SEE ALSO
14383
14384 =back
14385
14386 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
14387 ExtUtils::MakeMaker
14388
14389 =over 4
14390
14391 =item SYNOPSIS
14392
14393 =item DESCRIPTION
14394
14395 =over 4
14396
14397 =item Methods always loaded
14398
14399 wraplist
14400
14401 =back
14402
14403 =back
14404
14405 =over 4
14406
14407 =item Methods
14408
14409 guess_name (override)
14410
14411 =back
14412
14413 find_perl (override)
14414
14415 maybe_command (override)
14416
14417 perl_script (override)
14418
14419 replace_manpage_separator
14420
14421 init_DEST
14422
14423 init_DIRFILESEP
14424
14425 init_main (override)
14426
14427 init_others (override)
14428
14429 init_platform (override)
14430
14431 platform_constants
14432
14433 init_VERSION (override)
14434
14435 constants (override)
14436
14437 special_targets
14438
14439 cflags (override)
14440
14441 const_cccmd (override)
14442
14443 tool_sxubpp (override)
14444
14445 tools_other (override)
14446
14447 init_dist (override)
14448
14449 c_o (override)
14450
14451 xs_c (override)
14452
14453 xs_o (override)
14454
14455 dlsyms (override)
14456
14457 dynamic_lib (override)
14458
14459 dynamic_bs (override)
14460
14461 static_lib (override)
14462
14463 processPL (override)
14464
14465 installbin (override)
14466
14467 subdir_x (override)
14468
14469 clean (override)
14470
14471 clean_subdirs_target
14472
14473 realclean (override)
14474
14475 zipfile_target (o), tarfile_target (o), shdist_target (o)
14476
14477 dist_test (override)
14478
14479 install (override)
14480
14481 perldepend (override)
14482
14483 makefile (override)
14484
14485 find_tests (override)
14486
14487 test (override)
14488
14489 makeaperl (override)
14490
14491 nicetext (override)
14492
14493 prefixify (override)
14494
14495 oneliner (o)
14496
14497 B<echo> (o)
14498
14499 quote_literal
14500
14501 escape_newlines
14502
14503 max_exec_len
14504
14505 init_linker (o)
14506
14507 eliminate_macros
14508
14509 fixpath
14510
14511 os_flavor
14512
14513 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
14514 ExtUtils::MakeMaker
14515
14516 =over 4
14517
14518 =item SYNOPSIS
14519
14520 =item DESCRIPTION
14521
14522 =back
14523
14524 =over 4
14525
14526 =item Overridden methods
14527
14528 B<dlsyms>
14529
14530 =back
14531
14532 replace_manpage_separator
14533
14534 B<maybe_command>
14535
14536 B<find_tests>
14537
14538 B<init_DIRFILESEP>
14539
14540 B<init_others>
14541
14542 init_platform (o), platform_constants (o)
14543
14544 special_targets (o)
14545
14546 static_lib (o)
14547
14548 dynamic_lib (o)
14549
14550 clean
14551
14552 init_linker
14553
14554 perl_script
14555
14556 xs_o (o)
14557
14558 pasthru (o)
14559
14560 oneliner (o)
14561
14562 max_exec_len
14563
14564 os_flavor
14565
14566 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
14567
14568 =over 4
14569
14570 =item SYNOPSIS
14571
14572 =item DESCRIPTION
14573
14574 =over 4
14575
14576 =item Overriden methods
14577
14578 dist_test
14579
14580 =back
14581
14582 =back
14583
14584 subdir_x
14585
14586 xs_c
14587
14588 xs_cpp
14589
14590 xs_o
14591
14592 clean_subdirs_target
14593
14594 realclean_subdirs_target
14595
14596 max_exec_len
14597
14598 os_flavor
14599
14600 =over 4
14601
14602 =item AUTHOR
14603
14604 =back
14605
14606 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
14607
14608 =over 4
14609
14610 =item SYNOPSIS
14611
14612 =item DESCRIPTION
14613
14614 =back
14615
14616 =head2 ExtUtils::MakeMaker - Create a module Makefile
14617
14618 =over 4
14619
14620 =item SYNOPSIS
14621
14622 =item DESCRIPTION
14623
14624 =over 4
14625
14626 =item How To Write A Makefile.PL
14627
14628 =item Default Makefile Behaviour
14629
14630 =item make test
14631
14632 =item make testdb
14633
14634 =item make install
14635
14636 =item PREFIX and LIB attribute
14637
14638 =item AFS users
14639
14640 =item Static Linking of a new Perl Binary
14641
14642 =item Determination of Perl Library and Installation Locations
14643
14644 =item Which architecture dependent directory?
14645
14646 =item Using Attributes and Parameters
14647
14648 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
14649 CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS,
14650 EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN,
14651 FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB,
14652 INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
14653 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB,
14654 INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLVENDORARCH,
14655 INSTALLVENDORBIN, INSTALLVENDORLIB, INSTALLVENDORMAN1DIR,
14656 INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR,
14657 INST_MAN3DIR, INST_SCRIPT, LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS,
14658 LINKTYPE, MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET,
14659 MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT,
14660 OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB,
14661 PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW,
14662 PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
14663 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT,
14664 PRINT_PREREQ, SITEPREFIX, SIGN, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST,
14665 VERSION, VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION
14666
14667 =item Additional lowercase attributes
14668
14669 clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean,
14670 test, tool_autosplit
14671
14672 =item Overriding MakeMaker Methods
14673
14674 =item The End Of Cargo Cult Programming
14675
14676 C<<MAN3PODS => ' '>>
14677
14678 =item Hintsfile support
14679
14680 =item Distribution Support
14681
14682    make distcheck,    make skipcheck,    make distclean,    make manifest, 
14683   make distdir,   make disttest,    make tardist,    make dist,    make
14684 uutardist,    make shdist,    make zipdist,    make ci
14685
14686 =item Module Meta-Data
14687
14688 =item Disabling an extension
14689
14690 =item Other Handy Functions
14691
14692 prompt
14693
14694 =back
14695
14696 =item ENVIRONMENT
14697
14698 PERL_MM_OPT, PERL_MM_USE_DEFAULT
14699
14700 =item SEE ALSO
14701
14702 =item AUTHORS
14703
14704 =item LICENSE
14705
14706 =back
14707
14708 =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About
14709 MakeMaker
14710
14711 =over 4
14712
14713 =item DESCRIPTION
14714
14715 =over 4
14716
14717 =item Module Installation
14718
14719 How do I keep from installing man pages?, How do I use a module without
14720 installing it?
14721
14722 =item Philosophy and History
14723
14724 Why not just use <insert other build config tool here>?, What is
14725 Module::Build and how does it relate to MakeMaker?, pure perl.  no make, no
14726 shell commands, easier to customize, cleaner internals, less cruft
14727
14728 =item Module Writing
14729
14730 How do I keep my $VERSION up to date without resetting it manually?, What's
14731 this F<META.yml> thing and how did it get in my F<MANIFEST>?!
14732
14733 =item XS
14734
14735 How to I prevent "object version X.XX does not match bootstrap parameter
14736 Y.YY" errors?, How do I make two or more XS files coexist in the same
14737 directory?
14738
14739 =back
14740
14741 =item PATCHING
14742
14743 =item AUTHOR
14744
14745 =item SEE ALSO
14746
14747 =back
14748
14749 =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker
14750
14751 =over 4
14752
14753 =item SYNOPSIS
14754
14755 =item DESCRIPTION
14756
14757 =over 4
14758
14759 =item The Mantra
14760
14761 =item The Layout
14762
14763 Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP,
14764 bin/
14765
14766 =back
14767
14768 =item SEE ALSO
14769
14770 =back
14771
14772 =head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm
14773
14774 =over 4
14775
14776 =item SYNOPSIS
14777
14778 =item DESCRIPTION
14779
14780 =back
14781
14782 =head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm
14783
14784 =over 4
14785
14786 =item SYNOPSIS
14787
14788 =item DESCRIPTION
14789
14790 =back
14791
14792 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
14793
14794 =over 4
14795
14796 =item SYNOPSIS
14797
14798 =item DESCRIPTION
14799
14800 =over 4
14801
14802 =item Functions
14803
14804 mkmanifest
14805
14806 =back
14807
14808 =back
14809
14810 manifind
14811
14812 manicheck
14813
14814 filecheck
14815
14816 fullcheck
14817
14818 skipcheck
14819
14820 maniread
14821
14822 manicopy
14823
14824 maniadd
14825
14826 =over 4
14827
14828 =item MANIFEST
14829
14830 =item MANIFEST.SKIP
14831
14832 =item EXPORT_OK
14833
14834 =item GLOBAL VARIABLES
14835
14836 =back
14837
14838 =over 4
14839
14840 =item DIAGNOSTICS
14841
14842 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
14843 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
14844
14845 =item ENVIRONMENT
14846
14847 B<PERL_MM_MANIFEST_DEBUG>
14848
14849 =item SEE ALSO
14850
14851 =item AUTHOR
14852
14853 =back
14854
14855 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
14856
14857 =over 4
14858
14859 =item SYNOPSIS
14860
14861 =item DESCRIPTION
14862
14863 =item SEE ALSO
14864
14865 =back
14866
14867 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
14868
14869 =over 4
14870
14871 =item SYNOPSIS
14872
14873 =item DESCRIPTION
14874
14875 =back
14876
14877 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
14878 extension
14879
14880 =over 4
14881
14882 =item SYNOPSIS
14883
14884 =item DESCRIPTION
14885
14886 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
14887
14888 =item AUTHOR
14889
14890 =item REVISION
14891
14892 =back
14893
14894 =head2 ExtUtils::Packlist - manage .packlist files
14895
14896 =over 4
14897
14898 =item SYNOPSIS
14899
14900 =item DESCRIPTION
14901
14902 =item USAGE
14903
14904 =item FUNCTIONS
14905
14906 new(), read(), write(), validate(), packlist_file()
14907
14908 =item EXAMPLE
14909
14910 =item AUTHOR
14911
14912 =back
14913
14914 =head2 ExtUtils::testlib - add blib/* directories to @INC
14915
14916 =over 4
14917
14918 =item SYNOPSIS
14919
14920 =item DESCRIPTION
14921
14922 =back
14923
14924 =head2 Fatal - replace functions with equivalents which succeed or die
14925
14926 =over 4
14927
14928 =item SYNOPSIS
14929
14930 =item DESCRIPTION
14931
14932 =item AUTHOR
14933
14934 =back
14935
14936 =head2 Fcntl - load the C Fcntl.h defines
14937
14938 =over 4
14939
14940 =item SYNOPSIS
14941
14942 =item DESCRIPTION
14943
14944 =item NOTE
14945
14946 =item EXPORTED SYMBOLS
14947
14948 =back
14949
14950 =head2 File::Basename, fileparse - split a pathname into pieces
14951
14952 =over 4
14953
14954 =item SYNOPSIS
14955
14956 =item DESCRIPTION
14957
14958 fileparse_set_fstype, fileparse
14959
14960 =item EXAMPLES
14961
14962 C<basename>, C<dirname>
14963
14964 =back
14965
14966 =head2 File::CheckTree, validate - run many filetest checks on a tree
14967
14968 =over 4
14969
14970 =item SYNOPSIS
14971
14972 =item DESCRIPTION
14973
14974 =item AUTHOR
14975
14976 =item HISTORY
14977
14978 =back
14979
14980 =head2 File::Compare - Compare files or filehandles
14981
14982 =over 4
14983
14984 =item SYNOPSIS
14985
14986 =item DESCRIPTION
14987
14988 =item RETURN
14989
14990 =item AUTHOR
14991
14992 =back
14993
14994 =head2 File::Copy - Copy files or filehandles
14995
14996 =over 4
14997
14998 =item SYNOPSIS
14999
15000 =item DESCRIPTION
15001
15002 =over 4
15003
15004 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
15005
15006 rmscopy($from,$to[,$date_flag])
15007
15008 =back
15009
15010 =item RETURN
15011
15012 =item NOTES
15013
15014 =item AUTHOR
15015
15016 =back
15017
15018 =head2 File::DosGlob - DOS like globbing and then some
15019
15020 =over 4
15021
15022 =item SYNOPSIS
15023
15024 =item DESCRIPTION
15025
15026 =item NOTES
15027
15028 =item EXPORTS (by request only)
15029
15030 =item BUGS
15031
15032 =item AUTHOR
15033
15034 =item HISTORY
15035
15036 =item SEE ALSO
15037
15038 =back
15039
15040 =head2 File::Find - Traverse a directory tree.
15041
15042 =over 4
15043
15044 =item SYNOPSIS
15045
15046 =item DESCRIPTION
15047
15048 B<find>, B<finddepth>
15049
15050 =over 4
15051
15052 =item %options
15053
15054 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
15055 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
15056 C<untaint>, C<untaint_pattern>, C<untaint_skip>
15057
15058 =item The wanted function
15059
15060 C<$File::Find::dir> is the current directory name,, C<$_> is the current
15061 filename within that directory, C<$File::Find::name> is the complete
15062 pathname to the file
15063
15064 =back
15065
15066 =item WARNINGS
15067
15068 =item CAVEAT
15069
15070 $dont_use_nlink, symlinks
15071
15072 =item NOTES
15073
15074 =item BUGS AND CAVEATS
15075
15076 =item HISTORY
15077
15078 =back
15079
15080 =head2 File::Glob - Perl extension for BSD glob routine
15081
15082 =over 4
15083
15084 =item SYNOPSIS
15085
15086 =item DESCRIPTION
15087
15088 =over 4
15089
15090 =item META CHARACTERS
15091
15092 =item POSIX FLAGS
15093
15094 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
15095 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
15096 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
15097
15098 =back
15099
15100 =item DIAGNOSTICS
15101
15102 C<GLOB_NOSPACE>, C<GLOB_ABEND>
15103
15104 =item NOTES
15105
15106 =item SEE ALSO
15107
15108 =item AUTHOR
15109
15110 =back
15111
15112 =head2 File::Path - create or remove directory trees
15113
15114 =over 4
15115
15116 =item SYNOPSIS
15117
15118 =item DESCRIPTION
15119
15120 =item DIAGNOSTICS
15121
15122 =item AUTHORS
15123
15124 =back
15125
15126 =head2 File::Spec - portably perform operations on file names
15127
15128 =over 4
15129
15130 =item SYNOPSIS
15131
15132 =item DESCRIPTION
15133
15134 =item METHODS
15135
15136 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
15137 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
15138 splitdir, catpath(), abs2rel, rel2abs()
15139
15140 =item SEE ALSO
15141
15142 =item AUTHOR
15143
15144 =item COPYRIGHT
15145
15146 =back
15147
15148 =head2 File::Spec::Cygwin - methods for Cygwin file specs
15149
15150 =over 4
15151
15152 =item SYNOPSIS
15153
15154 =item DESCRIPTION
15155
15156 =back
15157
15158 canonpath
15159
15160 file_name_is_absolute
15161
15162 tmpdir (override)
15163
15164 =over 4
15165
15166 =item COPYRIGHT
15167
15168 =back
15169
15170 =head2 File::Spec::Epoc - methods for Epoc file specs
15171
15172 =over 4
15173
15174 =item SYNOPSIS
15175
15176 =item DESCRIPTION
15177
15178 =back
15179
15180 canonpath()
15181
15182 =over 4
15183
15184 =item AUTHOR
15185
15186 =item COPYRIGHT
15187
15188 =item SEE ALSO
15189
15190 =back
15191
15192 =head2 File::Spec::Functions - portably perform operations on file names
15193
15194 =over 4
15195
15196 =item SYNOPSIS
15197
15198 =item DESCRIPTION
15199
15200 =over 4
15201
15202 =item Exports
15203
15204 =back
15205
15206 =item COPYRIGHT
15207
15208 =item SEE ALSO
15209
15210 =back
15211
15212 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
15213
15214 =over 4
15215
15216 =item SYNOPSIS
15217
15218 =item DESCRIPTION
15219
15220 =item METHODS
15221
15222 canonpath
15223
15224 =back
15225
15226 catdir()
15227
15228 catfile
15229
15230 curdir
15231
15232 devnull
15233
15234 rootdir
15235
15236 tmpdir
15237
15238 updir
15239
15240 file_name_is_absolute
15241
15242 path
15243
15244 splitpath
15245
15246 splitdir
15247
15248 catpath
15249
15250 abs2rel
15251
15252 rel2abs
15253
15254 =over 4
15255
15256 =item AUTHORS
15257
15258 =item COPYRIGHT
15259
15260 =item SEE ALSO
15261
15262 =back
15263
15264 =head2 File::Spec::OS2 - methods for OS/2 file specs
15265
15266 =over 4
15267
15268 =item SYNOPSIS
15269
15270 =item DESCRIPTION
15271
15272 tmpdir, splitpath
15273
15274 =item COPYRIGHT
15275
15276 =back
15277
15278 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
15279 modules
15280
15281 =over 4
15282
15283 =item SYNOPSIS
15284
15285 =item DESCRIPTION
15286
15287 =item METHODS
15288
15289 canonpath()
15290
15291 =back
15292
15293 catdir()
15294
15295 catfile
15296
15297 curdir
15298
15299 devnull
15300
15301 rootdir
15302
15303 tmpdir
15304
15305 updir
15306
15307 no_upwards
15308
15309 case_tolerant
15310
15311 file_name_is_absolute
15312
15313 path
15314
15315 join
15316
15317 splitpath
15318
15319 splitdir
15320
15321 catpath()
15322
15323 abs2rel
15324
15325 rel2abs()
15326
15327 =over 4
15328
15329 =item COPYRIGHT
15330
15331 =item SEE ALSO
15332
15333 =back
15334
15335 =head2 File::Spec::VMS - methods for VMS file specs
15336
15337 =over 4
15338
15339 =item SYNOPSIS
15340
15341 =item DESCRIPTION
15342
15343 eliminate_macros
15344
15345 =back
15346
15347 fixpath
15348
15349 =over 4
15350
15351 =item Methods always loaded
15352
15353 canonpath (override)
15354
15355 =back
15356
15357 catdir
15358
15359 catfile
15360
15361 curdir (override)
15362
15363 devnull (override)
15364
15365 rootdir (override)
15366
15367 tmpdir (override)
15368
15369 updir (override)
15370
15371 case_tolerant (override)
15372
15373 path (override)
15374
15375 file_name_is_absolute (override)
15376
15377 splitpath (override)
15378
15379 splitdir (override)
15380
15381 catpath (override)
15382
15383 abs2rel (override)
15384
15385 rel2abs (override)
15386
15387 =over 4
15388
15389 =item COPYRIGHT
15390
15391 =item SEE ALSO
15392
15393 =back
15394
15395 =head2 File::Spec::Win32 - methods for Win32 file specs
15396
15397 =over 4
15398
15399 =item SYNOPSIS
15400
15401 =item DESCRIPTION
15402
15403 devnull
15404
15405 =back
15406
15407 tmpdir
15408
15409 catfile
15410
15411 canonpath
15412
15413 splitpath
15414
15415 splitdir
15416
15417 catpath
15418
15419 =over 4
15420
15421 =item Note For File::Spec::Win32 Maintainers
15422
15423 =back
15424
15425 =over 4
15426
15427 =item COPYRIGHT
15428
15429 =item SEE ALSO
15430
15431 =back
15432
15433 =head2 File::Temp - return name and handle of a temporary file safely
15434
15435 =over 4
15436
15437 =item PORTABILITY
15438
15439 =item SYNOPSIS
15440
15441 =item DESCRIPTION
15442
15443 =back
15444
15445 =over 4
15446
15447 =item OBJECT-ORIENTED INTERFACE
15448
15449 B<new>
15450
15451 =back
15452
15453 B<filename>
15454
15455 B<unlink_on_destroy>
15456
15457 B<DESTROY>
15458
15459 =over 4
15460
15461 =item FUNCTIONS
15462
15463 B<tempfile>
15464
15465 =back
15466
15467 B<tempdir>
15468
15469 =over 4
15470
15471 =item MKTEMP FUNCTIONS
15472
15473 B<mkstemp>
15474
15475 =back
15476
15477 B<mkstemps>
15478
15479 B<mkdtemp>
15480
15481 B<mktemp>
15482
15483 =over 4
15484
15485 =item POSIX FUNCTIONS
15486
15487 B<tmpnam>
15488
15489 =back
15490
15491 B<tmpfile>
15492
15493 =over 4
15494
15495 =item ADDITIONAL FUNCTIONS
15496
15497 B<tempnam>
15498
15499 =back
15500
15501 =over 4
15502
15503 =item UTILITY FUNCTIONS
15504
15505 B<unlink0>
15506
15507 =back
15508
15509 B<cmpstat>
15510
15511 B<unlink1>
15512
15513 B<cleanup>
15514
15515 =over 4
15516
15517 =item PACKAGE VARIABLES
15518
15519 B<safe_level>, STANDARD, MEDIUM, HIGH
15520
15521 =back
15522
15523 TopSystemUID
15524
15525 B<$KEEP_ALL>, B<$DEBUG>
15526
15527 =over 4
15528
15529 =item WARNING
15530
15531 =over 4
15532
15533 =item Temporary files and NFS
15534
15535 =item Forking
15536
15537 =item BINMODE
15538
15539 =back
15540
15541 =item HISTORY
15542
15543 =item SEE ALSO
15544
15545 =item AUTHOR
15546
15547 =back
15548
15549 =head2 File::stat - by-name interface to Perl's built-in stat() functions
15550
15551 =over 4
15552
15553 =item SYNOPSIS
15554
15555 =item DESCRIPTION
15556
15557 =item BUGS
15558
15559 =item NOTE
15560
15561 =item AUTHOR
15562
15563 =back
15564
15565 =head2 FileCache - keep more files open than the system permits
15566
15567 =over 4
15568
15569 =item SYNOPSIS
15570
15571 =item DESCRIPTION
15572
15573 cacheout EXPR, cacheout MODE, EXPR
15574
15575 =item CAVEATS
15576
15577 =item BUGS
15578
15579 =back
15580
15581 =head2 FileHandle - supply object methods for filehandles
15582
15583 =over 4
15584
15585 =item SYNOPSIS
15586
15587 =item DESCRIPTION
15588
15589 $fh->print, $fh->printf, $fh->getline, $fh->getlines
15590
15591 =item SEE ALSO
15592
15593 =back
15594
15595 =head2 Filter::Simple - Simplified source filtering
15596
15597 =over 4
15598
15599 =item SYNOPSIS
15600
15601 =item DESCRIPTION
15602
15603 =over 4
15604
15605 =item The Problem
15606
15607 =item A Solution
15608
15609 =item Disabling or changing <no> behaviour
15610
15611 =item All-in-one interface
15612
15613 =item Filtering only specific components of source code
15614
15615 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
15616 C<"all">
15617
15618 =item Filtering only the code parts of source code
15619
15620 Most source code ceases to be grammatically correct when it is broken up
15621 into the pieces between string literals and regexes. So the C<'code'>
15622 component filter behaves slightly differently from the other partial
15623 filters
15624 described in the previous section.
15625
15626 =item Using Filter::Simple with an explicit C<import> subroutine
15627
15628 =item Using Filter::Simple and Exporter together
15629
15630 =item How it works
15631
15632 =back
15633
15634 =item AUTHOR
15635
15636 =item COPYRIGHT
15637
15638 =back
15639
15640 =head2 Filter::Util::Call - Perl Source Filter Utility Module
15641
15642 =over 4
15643
15644 =item SYNOPSIS
15645
15646 =item DESCRIPTION
15647
15648 =over 4
15649
15650 =item B<use Filter::Util::Call>
15651
15652 =item B<import()>
15653
15654 =item B<filter() and anonymous sub>
15655
15656 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
15657
15658 =back
15659
15660 =item EXAMPLES
15661
15662 =over 4
15663
15664 =item Example 1: A simple filter.
15665
15666 =item Example 2: Using the context
15667
15668 =item Example 3: Using the context within the filter
15669
15670 =item Example 4: Using filter_del
15671
15672 =back
15673
15674 =item Filter::Simple
15675
15676 =item AUTHOR
15677
15678 =item DATE
15679
15680 =back
15681
15682 =head2 FindBin - Locate directory of original perl script
15683
15684 =over 4
15685
15686 =item SYNOPSIS
15687
15688 =item DESCRIPTION
15689
15690 =item EXPORTABLE VARIABLES
15691
15692 =item KNOWN ISSUES
15693
15694 =item KNOWN BUGS
15695
15696 =item AUTHORS
15697
15698 =item COPYRIGHT
15699
15700 =back
15701
15702 =head2 GDBM_File - Perl5 access to the gdbm library.
15703
15704 =over 4
15705
15706 =item SYNOPSIS
15707
15708 =item DESCRIPTION
15709
15710 =item AVAILABILITY
15711
15712 =item BUGS
15713
15714 =item SEE ALSO
15715
15716 =back
15717
15718 =head2 Getopt::Long - Extended processing of command line options
15719
15720 =over 4
15721
15722 =item SYNOPSIS
15723
15724 =item DESCRIPTION
15725
15726 =item Command Line Options, an Introduction
15727
15728 =item Getting Started with Getopt::Long
15729
15730 =over 4
15731
15732 =item Simple options
15733
15734 =item A little bit less simple options
15735
15736 =item Mixing command line option with other arguments
15737
15738 =item Options with values
15739
15740 =item Options with multiple values
15741
15742 =item Options with hash values
15743
15744 =item User-defined subroutines to handle options
15745
15746 =item Options with multiple names
15747
15748 =item Case and abbreviations
15749
15750 =item Summary of Option Specifications
15751
15752 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
15753 + [ I<desttype> ]
15754
15755 =back
15756
15757 =item Advanced Possibilities
15758
15759 =over 4
15760
15761 =item Object oriented interface
15762
15763 =item Thread Safety
15764
15765 =item Documentation and help texts
15766
15767 =item Storing options in a hash
15768
15769 =item Bundling
15770
15771 =item The lonesome dash
15772
15773 =item Argument callback
15774
15775 =back
15776
15777 =item Configuring Getopt::Long
15778
15779 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
15780 require_order, permute, bundling (default: disabled), bundling_override
15781 (default: disabled), ignore_case  (default: enabled), ignore_case_always
15782 (default: disabled), auto_version (default:disabled), auto_help
15783 (default:disabled), pass_through (default: disabled), prefix,
15784 prefix_pattern, debug (default: disabled)
15785
15786 =item Exportable Methods
15787
15788 VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage
15789
15790 =item Return values and Errors
15791
15792 =item Legacy
15793
15794 =over 4
15795
15796 =item Default destinations
15797
15798 =item Alternative option starters
15799
15800 =item Configuration variables
15801
15802 =back
15803
15804 =item Trouble Shooting
15805
15806 =over 4
15807
15808 =item GetOptions does not return a false result when an option is not
15809 supplied
15810
15811 =item GetOptions does not split the command line correctly
15812
15813 =item Undefined subroutine &main::GetOptions called
15814
15815 =item How do I put a "-?" option into a Getopt::Long?
15816
15817 =back
15818
15819 =item AUTHOR
15820
15821 =item COPYRIGHT AND DISCLAIMER
15822
15823 =back
15824
15825 =head2 Getopt::Std, getopt, getopts - Process single-character switches
15826 with switch clustering
15827
15828 =over 4
15829
15830 =item SYNOPSIS
15831
15832 =item DESCRIPTION
15833
15834 =item C<--help> and C<--version>
15835
15836 =back
15837
15838 =head2 Hash::Util - A selection of general-utility hash subroutines
15839
15840 =over 4
15841
15842 =item SYNOPSIS
15843
15844 =item DESCRIPTION
15845
15846 =over 4
15847
15848 =item Restricted hashes
15849
15850 lock_keys, unlock_keys
15851
15852 =back
15853
15854 =back
15855
15856 lock_value, unlock_value
15857
15858 B<lock_hash>, B<unlock_hash>
15859
15860 B<hash_seed>
15861
15862 =over 4
15863
15864 =item CAVEATS
15865
15866 =item AUTHOR
15867
15868 =item SEE ALSO
15869
15870 =back
15871
15872 =head2 I18N::Collate - compare 8-bit scalar data according to the current
15873 locale
15874
15875 =over 4
15876
15877 =item SYNOPSIS
15878
15879 =item DESCRIPTION
15880
15881 =back
15882
15883 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
15884 tags
15885
15886 =over 4
15887
15888 =item SYNOPSIS
15889
15890 =item DESCRIPTION
15891
15892 =back
15893
15894 the function is_language_tag($lang1)
15895
15896 the function extract_language_tags($whatever)
15897
15898 the function same_language_tag($lang1, $lang2)
15899
15900 the function similarity_language_tag($lang1, $lang2)
15901
15902 the function is_dialect_of($lang1, $lang2)
15903
15904 the function super_languages($lang1)
15905
15906 the function locale2language_tag($locale_identifier)
15907
15908 the function encode_language_tag($lang1)
15909
15910 the function alternate_language_tags($lang1)
15911
15912 the function @langs = panic_languages(@accept_languages)
15913
15914 the function implicate_supers( ...languages... ), the function
15915 implicate_supers_strictly( ...languages... )
15916
15917 =over 4
15918
15919 =item ABOUT LOWERCASING
15920
15921 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
15922
15923 =item SEE ALSO
15924
15925 =item COPYRIGHT
15926
15927 =item AUTHOR
15928
15929 =back
15930
15931 =head2 I18N::LangTags::Detect - detect the user's language preferences
15932
15933 =over 4
15934
15935 =item SYNOPSIS
15936
15937 =item DESCRIPTION
15938
15939 =item FUNCTIONS
15940
15941 =item ENVIRONMENT
15942
15943 =item SEE ALSO
15944
15945 =item COPYRIGHT
15946
15947 =item AUTHOR
15948
15949 =back
15950
15951 =head2 I18N::LangTags::List -- tags and names for human languages
15952
15953 =over 4
15954
15955 =item SYNOPSIS
15956
15957 =item DESCRIPTION
15958
15959 =item ABOUT LANGUAGE TAGS
15960
15961 =item LIST OF LANGUAGES
15962
15963 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} :
15964 Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} :
15965 Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian,
15966 {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)],
15967 {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic,
15968 {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy}
15969 : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} :
15970 Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} :
15971 Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae}
15972 : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} :
15973 Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai}
15974 : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} :
15975 Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} :
15976 Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber
15977 (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini,
15978 {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} :
15979 Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} :
15980 Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian
15981 (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central
15982 American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages],
15983 {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb}
15984 : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} :
15985 Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} :
15986 Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree,
15987 {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf}
15988 : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based
15989 Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} :
15990 Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} :
15991 Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru)
15992 Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri,
15993 {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch,
15994 {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi}
15995 : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} :
15996 English, {enm} : Old English (1100-1500), {ang} : Old English
15997 (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} :
15998 Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat}
15999 : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} :
16000 Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French
16001 (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} :
16002 Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan,
16003 {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian,
16004 {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High
16005 German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon}
16006 : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient
16007 Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} :
16008 Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian,
16009 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
16010 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
16011 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo,
16012 {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European
16013 (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua
16014 (International Auxiliary Language Association), {ie} : Interlingue, {iu} :
16015 Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} :
16016 Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian
16017 languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} :
16018 Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle,
16019 {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} :
16020 Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar}
16021 : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh,
16022 {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese,
16023 {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz,
16024 {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} :
16025 Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama,
16026 {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} :
16027 Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} :
16028 Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} :
16029 Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban
16030 (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui}
16031 : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai,
16032 {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili,
16033 {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} :
16034 Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} :
16035 Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} :
16036 Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai,
16037 [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} :
16038 Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} :
16039 Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)],
16040 {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple
16041 languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan,
16042 {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele,
16043 {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
16044 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
16045 {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} :
16046 Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} :
16047 Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi}
16048 : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} :
16049 Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
16050 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
16051 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
16052 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
16053 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
16054 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
16055 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
16056 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
16057 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
16058 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
16059 languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} :
16060 Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami,
16061 [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} :
16062 Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak,
16063 {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian,
16064 {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign
16065 Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} :
16066 Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave
16067 (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian,
16068 {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} :
16069 Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} :
16070 South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} :
16071 Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati,
16072 {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} :
16073 Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao,
16074 {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} :
16075 Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} :
16076 Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau,
16077 {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian,
16078 {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} :
16079 Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh}
16080 : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} :
16081 Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian,
16082 {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} :
16083 Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak}
16084 : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was}
16085 : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private
16086 Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} :
16087 Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
16088 : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu,
16089 {zun} : Zuni
16090
16091 =item SEE ALSO
16092
16093 =item COPYRIGHT AND DISCLAIMER
16094
16095 =item AUTHOR
16096
16097 =back
16098
16099 =head2 I18N::Langinfo - query locale information
16100
16101 =over 4
16102
16103 =item SYNOPSIS
16104
16105 =item DESCRIPTION
16106
16107 =over 4
16108
16109 =item EXPORT
16110
16111 =back
16112
16113 =item SEE ALSO
16114
16115 =item AUTHOR
16116
16117 =item COPYRIGHT AND LICENSE
16118
16119 =back
16120
16121 =head2 IO - load various IO modules
16122
16123 =over 4
16124
16125 =item SYNOPSIS
16126
16127 =item DESCRIPTION
16128
16129 =item DEPRECATED
16130
16131 =back
16132
16133 =head2 IO::Dir - supply object methods for directory handles
16134
16135 =over 4
16136
16137 =item SYNOPSIS
16138
16139 =item DESCRIPTION
16140
16141 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
16142 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
16143
16144 =item SEE ALSO
16145
16146 =item AUTHOR
16147
16148 =item COPYRIGHT
16149
16150 =back
16151
16152 =head2 IO::File - supply object methods for filehandles
16153
16154 =over 4
16155
16156 =item SYNOPSIS
16157
16158 =item DESCRIPTION
16159
16160 =item CONSTRUCTOR
16161
16162 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
16163
16164 =item METHODS
16165
16166 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode(
16167 [LAYER] )
16168
16169 =item NOTE
16170
16171 =item SEE ALSO
16172
16173 =item HISTORY
16174
16175 =back
16176
16177 =head2 IO::Handle - supply object methods for I/O handles
16178
16179 =over 4
16180
16181 =item SYNOPSIS
16182
16183 =item DESCRIPTION
16184
16185 =item CONSTRUCTOR
16186
16187 new (), new_from_fd ( FD, MODE )
16188
16189 =item METHODS
16190
16191 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
16192 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
16193 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
16194 $io->blocking ( [ BOOL ] ), $io->untaint
16195
16196 =item NOTE
16197
16198 =item SEE ALSO
16199
16200 =item BUGS
16201
16202 =item HISTORY
16203
16204 =back
16205
16206 =head2 IO::Pipe - supply object methods for pipes
16207
16208 =over 4
16209
16210 =item SYNOPSIS
16211
16212 =item DESCRIPTION
16213
16214 =item CONSTRUCTOR
16215
16216 new ( [READER, WRITER] )
16217
16218 =item METHODS
16219
16220 reader ([ARGS]), writer ([ARGS]), handles ()
16221
16222 =item SEE ALSO
16223
16224 =item AUTHOR
16225
16226 =item COPYRIGHT
16227
16228 =back
16229
16230 =head2 IO::Poll - Object interface to system poll call
16231
16232 =over 4
16233
16234 =item SYNOPSIS
16235
16236 =item DESCRIPTION
16237
16238 =item METHODS
16239
16240 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
16241 IO ), handles( [ EVENT_MASK ] )
16242
16243 =item SEE ALSO
16244
16245 =item AUTHOR
16246
16247 =item COPYRIGHT
16248
16249 =back
16250
16251 =head2 IO::Seekable - supply seek based methods for I/O objects
16252
16253 =over 4
16254
16255 =item SYNOPSIS
16256
16257 =item DESCRIPTION
16258
16259 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
16260 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
16261 $io->tell
16262
16263 =item SEE ALSO
16264
16265 =item HISTORY
16266
16267 =back
16268
16269 =head2 IO::Select - OO interface to the select system call
16270
16271 =over 4
16272
16273 =item SYNOPSIS
16274
16275 =item DESCRIPTION
16276
16277 =item CONSTRUCTOR
16278
16279 new ( [ HANDLES ] )
16280
16281 =item METHODS
16282
16283 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
16284 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
16285 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
16286
16287 =item EXAMPLE
16288
16289 =item AUTHOR
16290
16291 =item COPYRIGHT
16292
16293 =back
16294
16295 =head2 IO::Socket - Object interface to socket communications
16296
16297 =over 4
16298
16299 =item SYNOPSIS
16300
16301 =item DESCRIPTION
16302
16303 =item CONSTRUCTOR
16304
16305 new ( [ARGS] )
16306
16307 =item METHODS
16308
16309 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
16310 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
16311
16312 =item SEE ALSO
16313
16314 =item AUTHOR
16315
16316 =item COPYRIGHT
16317
16318 =back
16319
16320 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
16321
16322 =over 4
16323
16324 =item SYNOPSIS
16325
16326 =item DESCRIPTION
16327
16328 =item CONSTRUCTOR
16329
16330 new ( [ARGS] )
16331
16332 =over 4
16333
16334 =item METHODS
16335
16336 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
16337 ()
16338
16339 =back
16340
16341 =item SEE ALSO
16342
16343 =item AUTHOR
16344
16345 =item COPYRIGHT
16346
16347 =back
16348
16349 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
16350
16351 =over 4
16352
16353 =item SYNOPSIS
16354
16355 =item DESCRIPTION
16356
16357 =item CONSTRUCTOR
16358
16359 new ( [ARGS] )
16360
16361 =item METHODS
16362
16363 hostpath(), peerpath()
16364
16365 =item SEE ALSO
16366
16367 =item AUTHOR
16368
16369 =item COPYRIGHT
16370
16371 =back
16372
16373 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
16374 handles
16375
16376 =over 4
16377
16378 =item SYNOPSIS
16379
16380 =item DESCRIPTION
16381
16382 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
16383 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
16384
16385 =item SEE ALSO
16386
16387 =item AUTHOR
16388
16389 =item COPYRIGHT
16390
16391 =back
16392
16393 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
16394
16395 =over 4
16396
16397 =item SYNOPSIS
16398
16399 =item DESCRIPTION
16400
16401 =item CONSTRUCTOR
16402
16403 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
16404
16405 =item METHODS
16406
16407 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode(
16408 [LAYER] )
16409
16410 =item NOTE
16411
16412 =item SEE ALSO
16413
16414 =item HISTORY
16415
16416 =back
16417
16418 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
16419 handles
16420
16421 =over 4
16422
16423 =item SYNOPSIS
16424
16425 =item DESCRIPTION
16426
16427 =item CONSTRUCTOR
16428
16429 new (), new_from_fd ( FD, MODE )
16430
16431 =item METHODS
16432
16433 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
16434 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
16435 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
16436 $io->blocking ( [ BOOL ] ), $io->untaint
16437
16438 =item NOTE
16439
16440 =item SEE ALSO
16441
16442 =item BUGS
16443
16444 =item HISTORY
16445
16446 =back
16447
16448 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
16449
16450 =over 4
16451
16452 =item SYNOPSIS
16453
16454 =item DESCRIPTION
16455
16456 =item CONSTRUCTOR
16457
16458 new ( [READER, WRITER] )
16459
16460 =item METHODS
16461
16462 reader ([ARGS]), writer ([ARGS]), handles ()
16463
16464 =item SEE ALSO
16465
16466 =item AUTHOR
16467
16468 =item COPYRIGHT
16469
16470 =back
16471
16472 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
16473
16474 =over 4
16475
16476 =item SYNOPSIS
16477
16478 =item DESCRIPTION
16479
16480 =item METHODS
16481
16482 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
16483 IO ), handles( [ EVENT_MASK ] )
16484
16485 =item SEE ALSO
16486
16487 =item AUTHOR
16488
16489 =item COPYRIGHT
16490
16491 =back
16492
16493 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
16494 I/O objects
16495
16496 =over 4
16497
16498 =item SYNOPSIS
16499
16500 =item DESCRIPTION
16501
16502 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
16503 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
16504 $io->tell
16505
16506 =item SEE ALSO
16507
16508 =item HISTORY
16509
16510 =back
16511
16512 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
16513 call
16514
16515 =over 4
16516
16517 =item SYNOPSIS
16518
16519 =item DESCRIPTION
16520
16521 =item CONSTRUCTOR
16522
16523 new ( [ HANDLES ] )
16524
16525 =item METHODS
16526
16527 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
16528 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
16529 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
16530
16531 =item EXAMPLE
16532
16533 =item AUTHOR
16534
16535 =item COPYRIGHT
16536
16537 =back
16538
16539 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
16540 communications
16541
16542 =over 4
16543
16544 =item SYNOPSIS
16545
16546 =item DESCRIPTION
16547
16548 =item CONSTRUCTOR
16549
16550 new ( [ARGS] )
16551
16552 =item METHODS
16553
16554 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
16555 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
16556
16557 =item SEE ALSO
16558
16559 =item AUTHOR
16560
16561 =item COPYRIGHT
16562
16563 =back
16564
16565 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
16566 AF_INET domain sockets
16567
16568 =over 4
16569
16570 =item SYNOPSIS
16571
16572 =item DESCRIPTION
16573
16574 =item CONSTRUCTOR
16575
16576 new ( [ARGS] )
16577
16578 =over 4
16579
16580 =item METHODS
16581
16582 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
16583 ()
16584
16585 =back
16586
16587 =item SEE ALSO
16588
16589 =item AUTHOR
16590
16591 =item COPYRIGHT
16592
16593 =back
16594
16595 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
16596 AF_UNIX domain sockets
16597
16598 =over 4
16599
16600 =item SYNOPSIS
16601
16602 =item DESCRIPTION
16603
16604 =item CONSTRUCTOR
16605
16606 new ( [ARGS] )
16607
16608 =item METHODS
16609
16610 hostpath(), peerpath()
16611
16612 =item SEE ALSO
16613
16614 =item AUTHOR
16615
16616 =item COPYRIGHT
16617
16618 =back
16619
16620 =head2 IPC::Msg - SysV Msg IPC object class
16621
16622 =over 4
16623
16624 =item SYNOPSIS
16625
16626 =item DESCRIPTION
16627
16628 =item METHODS
16629
16630 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
16631 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
16632 FLAGS ] ), stat
16633
16634 =item SEE ALSO
16635
16636 =item AUTHOR
16637
16638 =item COPYRIGHT
16639
16640 =back
16641
16642 =head2 IPC::Open2, open2 - open a process for both reading and writing
16643
16644 =over 4
16645
16646 =item SYNOPSIS
16647
16648 =item DESCRIPTION
16649
16650 =item WARNING 
16651
16652 =item SEE ALSO
16653
16654 =back
16655
16656 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
16657 handling
16658
16659 =over 4
16660
16661 =item SYNOPSIS
16662
16663 =item DESCRIPTION
16664
16665 =item WARNING
16666
16667 =back
16668
16669 =head2 IPC::Semaphore - SysV Semaphore IPC object class
16670
16671 =over 4
16672
16673 =item SYNOPSIS
16674
16675 =item DESCRIPTION
16676
16677 =item METHODS
16678
16679 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
16680 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
16681 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
16682 , VALUE ), stat
16683
16684 =item SEE ALSO
16685
16686 =item AUTHOR
16687
16688 =item COPYRIGHT
16689
16690 =back
16691
16692 =head2 IPC::SysV - SysV IPC constants
16693
16694 =over 4
16695
16696 =item SYNOPSIS
16697
16698 =item DESCRIPTION
16699
16700 ftok( PATH, ID )
16701
16702 =item SEE ALSO
16703
16704 =item AUTHORS
16705
16706 =item COPYRIGHT
16707
16708 =back
16709
16710 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
16711
16712 =over 4
16713
16714 =item SYNOPSIS
16715
16716 =item DESCRIPTION
16717
16718 =item METHODS
16719
16720 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
16721 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
16722 FLAGS ] ), stat
16723
16724 =item SEE ALSO
16725
16726 =item AUTHOR
16727
16728 =item COPYRIGHT
16729
16730 =back
16731
16732 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
16733 class
16734
16735 =over 4
16736
16737 =item SYNOPSIS
16738
16739 =item DESCRIPTION
16740
16741 =item METHODS
16742
16743 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
16744 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
16745 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
16746 , VALUE ), stat
16747
16748 =item SEE ALSO
16749
16750 =item AUTHOR
16751
16752 =item COPYRIGHT
16753
16754 =back
16755
16756 =head2 List::Util - A selection of general-utility list subroutines
16757
16758 =over 4
16759
16760 =item SYNOPSIS
16761
16762 =item DESCRIPTION
16763
16764 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
16765 BLOCK LIST, shuffle LIST, sum LIST
16766
16767 =item KNOWN BUGS
16768
16769 =item SUGGESTED ADDITIONS
16770
16771 =item COPYRIGHT
16772
16773 =back
16774
16775 =head2 List::Utilib::List::Util, List::Util - A selection of
16776 general-utility list subroutines
16777
16778 =over 4
16779
16780 =item SYNOPSIS
16781
16782 =item DESCRIPTION
16783
16784 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
16785 BLOCK LIST, shuffle LIST, sum LIST
16786
16787 =item KNOWN BUGS
16788
16789 =item SUGGESTED ADDITIONS
16790
16791 =item COPYRIGHT
16792
16793 =back
16794
16795 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
16796 general-utility scalar subroutines
16797
16798 =over 4
16799
16800 =item SYNOPSIS
16801
16802 =item DESCRIPTION
16803
16804 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
16805 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
16806 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
16807
16808 =item KNOWN BUGS
16809
16810 =item COPYRIGHT
16811
16812 =item BLATANT PLUG
16813
16814 =back
16815
16816 =head2 Locale::Constants - constants for Locale codes
16817
16818 =over 4
16819
16820 =item SYNOPSIS
16821
16822 =item DESCRIPTION
16823
16824 =item KNOWN BUGS AND LIMITATIONS
16825
16826 =item SEE ALSO
16827
16828 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
16829
16830 =item AUTHOR
16831
16832 =item COPYRIGHT
16833
16834 =back
16835
16836 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
16837
16838 =over 4
16839
16840 =item SYNOPSIS
16841
16842 =item DESCRIPTION
16843
16844 B<alpha-2>, B<alpha-3>, B<numeric>
16845
16846 =item CONVERSION ROUTINES
16847
16848 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
16849 country_code2code( CODE, CODESET, CODESET )
16850
16851 =item QUERY ROUTINES
16852
16853 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
16854
16855 =item SEMI-PRIVATE ROUTINES
16856
16857 =over 4
16858
16859 =item alias_code
16860
16861 =item rename_country
16862
16863 =back
16864
16865 =item EXAMPLES
16866
16867 =item DOMAIN NAMES
16868
16869 =item KNOWN BUGS AND LIMITATIONS
16870
16871 =item SEE ALSO
16872
16873 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
16874 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
16875 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
16876 http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
16877
16878 =item AUTHOR
16879
16880 =item COPYRIGHT
16881
16882 =back
16883
16884 =head2 Locale::Currency - ISO three letter codes for currency
16885 identification (ISO 4217)
16886
16887 =over 4
16888
16889 =item SYNOPSIS
16890
16891 =item DESCRIPTION
16892
16893 XTS, XXX
16894
16895 =item CONVERSION ROUTINES
16896
16897 code2currency(), currency2code()
16898
16899 =item QUERY ROUTINES
16900
16901 C<all_currency_codes()>, C<all_currency_names()>
16902
16903 =item EXAMPLES
16904
16905 =item KNOWN BUGS AND LIMITATIONS
16906
16907 =item SEE ALSO
16908
16909 Locale::Country, Locale::Script, ISO 4217:1995,
16910 http://www.bsi-global.com/iso4217currency
16911
16912 =item AUTHOR
16913
16914 =item COPYRIGHT
16915
16916 =back
16917
16918 =head2 Locale::Language - ISO two letter codes for language identification
16919 (ISO 639)
16920
16921 =over 4
16922
16923 =item SYNOPSIS
16924
16925 =item DESCRIPTION
16926
16927 =item CONVERSION ROUTINES
16928
16929 code2language(), language2code()
16930
16931 =item QUERY ROUTINES
16932
16933 C<all_language_codes()>, C<all_language_names()>
16934
16935 =item EXAMPLES
16936
16937 =item KNOWN BUGS AND LIMITATIONS
16938
16939 =item SEE ALSO
16940
16941 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
16942 http://lcweb.loc.gov/standards/iso639-2/langhome.html
16943
16944 =item AUTHOR
16945
16946 =item COPYRIGHT
16947
16948 =back
16949
16950 =head2 Locale::Maketext - framework for localization
16951
16952 =over 4
16953
16954 =item SYNOPSIS
16955
16956 =item DESCRIPTION
16957
16958 =item QUICK OVERVIEW
16959
16960 =item METHODS
16961
16962 =over 4
16963
16964 =item Construction Methods
16965
16966 =item The "maketext" Method
16967
16968 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
16969
16970 =item Utility Methods
16971
16972 $language->quant($number, $singular), $language->quant($number, $singular,
16973 $plural), $language->quant($number, $singular, $plural, $negative),
16974 $language->numf($number), $language->sprintf($format, @items),
16975 $language->language_tag(), $language->encoding()
16976
16977 =item Language Handle Attributes and Internals
16978
16979 =back
16980
16981 =item LANGUAGE CLASS HIERARCHIES
16982
16983 =item ENTRIES IN EACH LEXICON
16984
16985 =item BRACKET NOTATION
16986
16987 =item AUTO LEXICONS
16988
16989 =item CONTROLLING LOOKUP FAILURE
16990
16991 =item HOW TO USE MAKETEXT
16992
16993 =item SEE ALSO
16994
16995 =item COPYRIGHT AND DISCLAIMER
16996
16997 =item AUTHOR
16998
16999 =back
17000
17001 =head2 Locale::Maketext::TPJ13 -- article about software localization
17002
17003 =over 4
17004
17005 =item SYNOPSIS
17006
17007 =item DESCRIPTION
17008
17009 =item Localization and Perl: gettext breaks, Maketext fixes
17010
17011 =over 4
17012
17013 =item A Localization Horror Story: It Could Happen To You
17014
17015 =item The Linguistic View
17016
17017 =item Breaking gettext
17018
17019 =item Replacing gettext
17020
17021 =item Buzzwords: Abstraction and Encapsulation
17022
17023 =item Buzzword: Isomorphism
17024
17025 =item Buzzword: Inheritance
17026
17027 =item Buzzword: Concision
17028
17029 =item The Devil in the Details
17030
17031 =item The Proof in the Pudding: Localizing Web Sites
17032
17033 =item References
17034
17035 =back
17036
17037 =back
17038
17039 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
17040
17041 =over 4
17042
17043 =item SYNOPSIS
17044
17045 =item DESCRIPTION
17046
17047 B<alpha-2>, B<alpha-3>, B<numeric>
17048
17049 =over 4
17050
17051 =item SPECIAL CODES
17052
17053 =back
17054
17055 =item CONVERSION ROUTINES
17056
17057 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
17058 script_code2code( CODE, CODESET, CODESET )
17059
17060 =item QUERY ROUTINES
17061
17062 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
17063
17064 =item EXAMPLES
17065
17066 =item KNOWN BUGS AND LIMITATIONS
17067
17068 =item SEE ALSO
17069
17070 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
17071 http://www.evertype.com/standards/iso15924/
17072
17073 =item AUTHOR
17074
17075 =item COPYRIGHT
17076
17077 =back
17078
17079 =head2 MIME::Base64 - Encoding and decoding of base64 strings
17080
17081 =over 4
17082
17083 =item SYNOPSIS
17084
17085 =item DESCRIPTION
17086
17087 encode_base64($str), encode_base64($str, $eol);, decode_base64($str)
17088
17089 =item DIAGNOSTICS
17090
17091 Premature end of base64 data, Premature padding of base64 data
17092
17093 =item EXAMPLES
17094
17095 =item COPYRIGHT
17096
17097 =item SEE ALSO
17098
17099 =back
17100
17101 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
17102 of quoted-printable strings
17103
17104 =over 4
17105
17106 =item SYNOPSIS
17107
17108 =item DESCRIPTION
17109
17110 encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode),
17111 decode_qp($str);
17112
17113 =item COPYRIGHT
17114
17115 =item SEE ALSO
17116
17117 =back
17118
17119 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
17120 strings
17121
17122 =over 4
17123
17124 =item SYNOPSIS
17125
17126 =item DESCRIPTION
17127
17128 encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode),
17129 decode_qp($str);
17130
17131 =item COPYRIGHT
17132
17133 =item SEE ALSO
17134
17135 =back
17136
17137 =head2 Math::BigFloat - Arbitrary size floating point math package
17138
17139 =over 4
17140
17141 =item SYNOPSIS
17142
17143 =item DESCRIPTION
17144
17145 =over 4
17146
17147 =item Canonical notation
17148
17149 =item Output
17150
17151 =item C<mantissa()>, C<exponent()> and C<parts()>
17152
17153 =item Accuracy vs. Precision
17154
17155 =item Rounding
17156
17157 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
17158 ), fround  ( -$scale ) and fround ( 0 )
17159
17160 =back
17161
17162 =item EXAMPLES
17163
17164   # not ready yet
17165
17166 =item Autocreating constants
17167
17168 =over 4
17169
17170 =item Math library
17171
17172 =item Using Math::BigInt::Lite
17173
17174 =back
17175
17176 =item BUGS
17177
17178 =item CAVEATS
17179
17180 stringify, bstr(), bdiv, Modifying and =, bpow
17181
17182 =item SEE ALSO
17183
17184 =item LICENSE
17185
17186 =item AUTHORS
17187
17188 =back
17189
17190 =head2 Math::BigInt - Arbitrary size integer math package
17191
17192 =over 4
17193
17194 =item SYNOPSIS
17195
17196 =item DESCRIPTION
17197
17198 Input, Output
17199
17200 =item METHODS
17201
17202 =over 4
17203
17204 =item config
17205
17206 =item accuracy
17207
17208 =item precision
17209
17210 =item brsft
17211
17212 =item new
17213
17214 =item bnan
17215
17216 =item bzero
17217
17218 =item binf
17219
17220 =item bone
17221
17222 =item is_one()/is_zero()/is_nan()/is_inf()
17223
17224 =item is_pos()/is_neg()
17225
17226         $x->is_pos();                   # true if > 0
17227         $x->is_neg();                   # true if < 0
17228
17229 =item is_odd()/is_even()/is_int()
17230
17231 =item bcmp
17232
17233 =item bacmp
17234
17235 =item sign
17236
17237 =item digit
17238
17239 =item bneg
17240
17241 =item babs
17242
17243 =item bnorm
17244
17245 =item bnot
17246
17247 =item binc
17248
17249 =item bdec
17250
17251 =item badd
17252
17253 =item bsub
17254
17255 =item bmul
17256
17257 =item bdiv
17258
17259 =item bmod
17260
17261 =item bmodinv
17262
17263 =item bmodpow
17264
17265 =item bpow
17266
17267 =item blsft
17268
17269 =item brsft
17270
17271 =item band
17272
17273 =item bior
17274
17275 =item bxor
17276
17277 =item bnot
17278
17279 =item bsqrt
17280
17281 =item bfac
17282
17283 =item round
17284
17285 =item bround
17286
17287 =item bfround
17288
17289 =item bfloor
17290
17291 =item bceil
17292
17293 =item bgcd
17294
17295 =item blcm
17296
17297 =item exponent
17298
17299 =item mantissa
17300
17301 =item parts
17302
17303 =item copy
17304
17305 =item as_int
17306
17307 =item bsstr
17308
17309 =item as_hex
17310
17311 =item as_bin
17312
17313 =back
17314
17315 =item ACCURACY and PRECISION
17316
17317 =over 4
17318
17319 =item Precision P
17320
17321 =item Accuracy A
17322
17323 =item Fallback F
17324
17325 =item Rounding mode R
17326
17327 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
17328 (significant digits), Setting/Accessing, Creating numbers, Usage,
17329 Precedence, Overriding globals, Local settings, Rounding, Default values,
17330 Remarks
17331
17332 =back
17333
17334 =item Infinity and Not a Number
17335
17336 oct()/hex(), log(-inf), exp(), cos(), sin(), atan2()
17337
17338 =item INTERNALS
17339
17340 =over 4
17341
17342 =item MATH LIBRARY
17343
17344 =item SIGN
17345
17346 =item mantissa(), exponent() and parts()
17347
17348 =back
17349
17350 =item EXAMPLES
17351
17352   use Math::BigInt;
17353
17354 =item Autocreating constants
17355
17356 =item PERFORMANCE
17357
17358 =over 4
17359
17360 =item Alternative math libraries
17361
17362 =item SUBCLASSING
17363
17364 =back
17365
17366 =item Subclassing Math::BigInt
17367
17368 =item UPGRADING
17369
17370 =over 4
17371
17372 =item Auto-upgrade
17373
17374 bsqrt(), div(), blog()
17375
17376 =back
17377
17378 =item BUGS
17379
17380 broot() does not work, Out of Memory!, Fails to load Calc on Perl prior
17381 5.6.0
17382
17383 =item CAVEATS
17384
17385 bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling,
17386 Modifying and =, bpow, Overloading -$x, Mixing different object types,
17387 bsqrt(), brsft()
17388
17389 =item LICENSE
17390
17391 =item SEE ALSO
17392
17393 =item AUTHORS
17394
17395 =back
17396
17397 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
17398
17399 =over 4
17400
17401 =item SYNOPSIS
17402
17403 =item DESCRIPTION
17404
17405 =item STORAGE
17406
17407 =item METHODS
17408
17409 =item WRAP YOUR OWN
17410
17411 =item LICENSE
17412
17413 This program is free software; you may redistribute it and/or modify it
17414 under
17415 the same terms as Perl itself. 
17416
17417 =item AUTHORS
17418
17419 =item SEE ALSO
17420
17421 =back
17422
17423 =head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code
17424
17425 =over 4
17426
17427 =item SYNOPSIS
17428
17429 =item DESCRIPTION
17430
17431 =item METHODS
17432
17433 =over 4
17434
17435 =item __emu_bxor
17436
17437 =item __emu_band
17438
17439 =item __emu_bior
17440
17441 =back
17442
17443 =item LICENSE
17444
17445 This program is free software; you may redistribute it and/or modify it
17446 under
17447 the same terms as Perl itself. 
17448
17449 =item AUTHORS
17450
17451 =item SEE ALSO
17452
17453 =back
17454
17455 =head2 Math::BigRat - Arbitrary big rational numbers
17456
17457 =over 4
17458
17459 =item SYNOPSIS
17460
17461 =item DESCRIPTION
17462
17463 =over 4
17464
17465 =item MATH LIBRARY
17466
17467 =back
17468
17469 =item METHODS
17470
17471 =over 4
17472
17473 =item new()
17474
17475 =item numerator()
17476
17477 =item denominator()
17478
17479         $d = $x->denominator();
17480
17481 =item parts()
17482
17483 =item as_int()
17484
17485 =item as_hex()
17486
17487 =item as_bin()
17488
17489 =item bfac()
17490
17491 =item blog()
17492
17493 =item bround()/round()/bfround()
17494
17495 =item bmod()
17496
17497 =item is_one()
17498
17499 =item is_zero()
17500
17501 =item is_pos()
17502
17503 =item is_neg()
17504
17505 =item is_int()
17506
17507 =item is_odd()
17508
17509 =item is_even()
17510
17511 =item bceil()
17512
17513 =item bfloor()
17514
17515         $x->bfloor();
17516
17517 =item bsqrt()
17518
17519         $x->bsqrt();
17520
17521 =item config
17522
17523 =back
17524
17525 =item BUGS
17526
17527 inf handling (partial), NaN handling (partial), rounding (not implemented
17528 except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(),
17529 blog(), bmodinv() and bmodpow() (partial)
17530
17531 =item LICENSE
17532
17533 =item SEE ALSO
17534
17535 =item AUTHORS
17536
17537 =back
17538
17539 =head2 Math::Complex - complex numbers and associated mathematical
17540 functions
17541
17542 =over 4
17543
17544 =item SYNOPSIS
17545
17546 =item DESCRIPTION
17547
17548 =item OPERATIONS
17549
17550 =item CREATION
17551
17552 =item STRINGIFICATION
17553
17554 =over 4
17555
17556 =item CHANGED IN PERL 5.6
17557
17558 =back
17559
17560 =item USAGE
17561
17562 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
17563
17564 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
17565
17566 =item BUGS
17567
17568 =item AUTHORS
17569
17570 =back
17571
17572 =head2 Math::Trig - trigonometric functions
17573
17574 =over 4
17575
17576 =item SYNOPSIS
17577
17578 =item DESCRIPTION
17579
17580 =item TRIGONOMETRIC FUNCTIONS
17581
17582 B<tan>
17583
17584 =over 4
17585
17586 =item ERRORS DUE TO DIVISION BY ZERO
17587
17588 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
17589
17590 =back
17591
17592 =item PLANE ANGLE CONVERSIONS
17593
17594 =item RADIAL COORDINATE CONVERSIONS
17595
17596 =over 4
17597
17598 =item COORDINATE SYSTEMS
17599
17600 =item 3-D ANGLE CONVERSIONS
17601
17602 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
17603 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
17604
17605 =back
17606
17607 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
17608
17609 =item EXAMPLES
17610
17611 =over 4
17612
17613 =item CAVEAT FOR GREAT CIRCLE FORMULAS
17614
17615 =back
17616
17617 =item BUGS
17618
17619 =item AUTHORS
17620
17621 =back
17622
17623 =head2 Memoize - Make functions faster by trading space for time
17624
17625 =over 4
17626
17627 =item SYNOPSIS
17628
17629 =item DESCRIPTION
17630
17631 =item DETAILS
17632
17633 =item OPTIONS
17634
17635 =over 4
17636
17637 =item INSTALL
17638
17639 =item NORMALIZER
17640
17641 =item C<SCALAR_CACHE>, C<LIST_CACHE>
17642
17643 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
17644
17645 =back
17646
17647 =item OTHER FACILITIES
17648
17649 =over 4
17650
17651 =item C<unmemoize>
17652
17653 =item C<flush_cache>
17654
17655 =back
17656
17657 =item CAVEATS
17658
17659 =item PERSISTENT CACHE SUPPORT
17660
17661 =item EXPIRATION SUPPORT
17662
17663 =item BUGS
17664
17665 =item MAILING LIST
17666
17667 =item AUTHOR
17668
17669 =item COPYRIGHT AND LICENSE
17670
17671 =item THANK YOU
17672
17673 =back
17674
17675 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
17676 Storable use
17677
17678 =over 4
17679
17680 =item DESCRIPTION
17681
17682 =back
17683
17684 =head2 Memoize::Expire - Plug-in module for automatic expiration of
17685 memoized values
17686
17687 =over 4
17688
17689 =item SYNOPSIS
17690
17691 =item DESCRIPTION
17692
17693 =item INTERFACE
17694
17695  TIEHASH,  EXISTS,  STORE
17696
17697 =item ALTERNATIVES
17698
17699 =item CAVEATS
17700
17701 =item AUTHOR
17702
17703 =item SEE ALSO
17704
17705 =back
17706
17707 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
17708
17709 =over 4
17710
17711 =item DESCRIPTION
17712
17713 =back
17714
17715 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
17716
17717 =over 4
17718
17719 =item DESCRIPTION
17720
17721 =back
17722
17723 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
17724 Storable use
17725
17726 =over 4
17727
17728 =item DESCRIPTION
17729
17730 =back
17731
17732 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
17733 Storable use
17734
17735 =over 4
17736
17737 =item DESCRIPTION
17738
17739 =back
17740
17741 =head2 Memoize::Storable - store Memoized data in Storable database
17742
17743 =over 4
17744
17745 =item DESCRIPTION
17746
17747 =back
17748
17749 =head2 Module::CoreList - what modules shipped with versions of perl
17750
17751 =over 4
17752
17753 =item SYNOPSIS
17754
17755 =item DESCRIPTION
17756
17757 =item CAVEATS
17758
17759 =item HISTORY
17760
17761 =item AUTHOR
17762
17763 =item COPYRIGHT
17764
17765 =item SEE ALSO
17766
17767 =back
17768
17769 =head2 NDBM_File - Tied access to ndbm files
17770
17771 =over 4
17772
17773 =item SYNOPSIS
17774
17775 =item DESCRIPTION
17776
17777 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17778
17779 =item DIAGNOSTICS
17780
17781 =over 4
17782
17783 =item C<ndbm store returned -1, errno 22, key "..." at ...>
17784
17785 =back
17786
17787 =item BUGS AND WARNINGS
17788
17789 =back
17790
17791 =head2 NEXT - Provide a pseudo-class NEXT (et al) that allows method
17792 redispatch
17793
17794 =over 4
17795
17796 =item SYNOPSIS
17797
17798 =item DESCRIPTION
17799
17800 =over 4
17801
17802 =item Enforcing redispatch
17803
17804 =item Avoiding repetitions
17805
17806 =item Invoking all versions of a method with a single call
17807
17808 =item Using C<EVERY> methods
17809
17810 =back
17811
17812 =item AUTHOR
17813
17814 =item BUGS AND IRRITATIONS
17815
17816 =item COPYRIGHT
17817
17818 =back
17819
17820 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
17821
17822 =over 4
17823
17824 =item SYNOPSIS
17825
17826 =item DESCRIPTION
17827
17828 =item USER METHODS
17829
17830 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
17831 dataend ()
17832
17833 =item CLASS METHODS
17834
17835 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
17836 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
17837 ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh ()
17838
17839 =item EXPORTS
17840
17841 =item AUTHOR
17842
17843 =item COPYRIGHT
17844
17845 =back
17846
17847 =head2 Net::Config - Local configuration data for libnet
17848
17849 =over 4
17850
17851 =item SYNOPSYS
17852
17853 =item DESCRIPTION
17854
17855 =item METHODS
17856
17857 requires_firewall HOST
17858
17859 =item NetConfig VALUES
17860
17861 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
17862 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
17863 ftp_int_pasive, local_netmask, test_hosts, test_exists
17864
17865 =back
17866
17867 =head2 Net::Domain - Attempt to evaluate the current host's internet name
17868 and domain
17869
17870 =over 4
17871
17872 =item SYNOPSIS
17873
17874 =item DESCRIPTION
17875
17876 hostfqdn (), hostname (), hostdomain ()
17877
17878 =item AUTHOR
17879
17880 =item COPYRIGHT
17881
17882 =back
17883
17884 =head2 Net::FTP - FTP Client class
17885
17886 =over 4
17887
17888 =item SYNOPSIS
17889
17890 =item DESCRIPTION
17891
17892 =item OVERVIEW
17893
17894 =item CONSTRUCTOR
17895
17896 new ([ HOST ] [, OPTIONS ])
17897
17898 =item METHODS
17899
17900 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
17901 site (ARGS), ascii, binary, rename ( OLDNAME, NEWNAME ), delete ( FILENAME
17902 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR [,
17903 RECURSE ]), mkdir ( DIR [, RECURSE ]), alloc ( SIZE [, RECORD_SIZE] ), ls (
17904 [ DIR ] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ),
17905 put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE
17906 ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ),
17907 size ( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[
17908 BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ DIR ] ), retr ( FILE ),
17909 stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [ PORT ] ), pasv (),
17910 pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_xfer_unique (
17911 SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( NON_PASV_SERVER ),
17912 abort (), quit ()
17913
17914 =over 4
17915
17916 =item Methods for the adventurous
17917
17918 quot (CMD [,ARGS])
17919
17920 =back
17921
17922 =item THE dataconn CLASS
17923
17924 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
17925 bytes_read (), abort (), close ()
17926
17927 =item UNIMPLEMENTED
17928
17929 B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
17930
17931 =item REPORTING BUGS
17932
17933 =item AUTHOR
17934
17935 =item SEE ALSO
17936
17937 =item USE EXAMPLES
17938
17939 http://www.csh.rit.edu/~adam/Progs/
17940
17941 =item CREDITS
17942
17943 =item COPYRIGHT
17944
17945 =back
17946
17947 =head2 Net::NNTP - NNTP Client class
17948
17949 =over 4
17950
17951 =item SYNOPSIS
17952
17953 =item DESCRIPTION
17954
17955 =item CONSTRUCTOR
17956
17957 new ( [ HOST ] [, OPTIONS ])
17958
17959 =item METHODS
17960
17961 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
17962 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
17963 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
17964 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
17965 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
17966 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
17967 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
17968
17969 =over 4
17970
17971 =item Extension methods
17972
17973 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
17974 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
17975 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
17976 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
17977 GROUP ] ), reader
17978
17979 =back
17980
17981 =item UNSUPPORTED
17982
17983 =item DEFINITIONS
17984
17985 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
17986
17987 =item SEE ALSO
17988
17989 =item AUTHOR
17990
17991 =item COPYRIGHT
17992
17993 =back
17994
17995 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
17996
17997 =over 4
17998
17999 =item SYNOPSIS
18000
18001 =item DESCRIPTION
18002
18003 =item CONSTRUCTOR
18004
18005 new ( [ HOST ] [, OPTIONS ] 0
18006
18007 =item METHODS
18008
18009 auth ( USERNAME, PASSWORD ), user ( USER ), pass ( PASS ), login ( [ USER
18010 [, PASS ]] ), apop ( [ USER [, PASS ]] ), banner (), capa (),  capabilities
18011 (), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [, FH ]
18012 ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ]
18013 ), delete ( MSGNUM ), reset (), quit ()
18014
18015 =item NOTES
18016
18017 =item SEE ALSO
18018
18019 =item AUTHOR
18020
18021 =item COPYRIGHT
18022
18023 =back
18024
18025 =head2 Net::Ping - check a remote host for reachability
18026
18027 =over 4
18028
18029 =item SYNOPSIS
18030
18031 =item DESCRIPTION
18032
18033 =over 4
18034
18035 =item Functions
18036
18037 Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos
18038 ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
18039 $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
18040 $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
18041 [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host
18042 [, $timeout]);
18043
18044 =back
18045
18046 =item NOTES
18047
18048 =item INSTALL
18049
18050 =item BUGS
18051
18052 =item AUTHORS
18053
18054 =item COPYRIGHT
18055
18056 =back
18057
18058 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
18059
18060 =over 4
18061
18062 =item SYNOPSIS
18063
18064 =item DESCRIPTION
18065
18066 =item EXAMPLES
18067
18068 =item CONSTRUCTOR
18069
18070 new ( [ HOST ] [, OPTIONS ] )
18071
18072 =item METHODS
18073
18074 banner (), domain (), hello ( DOMAIN ), host (), etrn ( DOMAIN ), auth (
18075 USERNAME, PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ),
18076 send_or_mail ( ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient (
18077 ADDRESS [, ADDRESS, [...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]]
18078 ), cc ( ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ),
18079 data ( [ DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [
18080 $subject ] ), quit ()
18081
18082 =item ADDRESSES
18083
18084 =item SEE ALSO
18085
18086 =item AUTHOR
18087
18088 =item COPYRIGHT
18089
18090 =back
18091
18092 =head2 Net::Time - time and daytime network client interface
18093
18094 =over 4
18095
18096 =item SYNOPSIS
18097
18098 =item DESCRIPTION
18099
18100 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
18101 PROTOCOL [, TIMEOUT]]])
18102
18103 =item AUTHOR
18104
18105 =item COPYRIGHT
18106
18107 =back
18108
18109 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
18110 functions
18111
18112 =over 4
18113
18114 =item SYNOPSIS
18115
18116 =item DESCRIPTION
18117
18118 =item EXAMPLES
18119
18120 =item NOTE
18121
18122 =item AUTHOR
18123
18124 =back
18125
18126 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
18127
18128 =over 4
18129
18130 =item DESCRIPTION
18131
18132 =over 4
18133
18134 =item Where to get this document
18135
18136 =item How to contribute to this document
18137
18138 =back
18139
18140 =item Author and Copyright Information
18141
18142 =over 4
18143
18144 =item Disclaimer
18145
18146 =back
18147
18148 =item Obtaining and installing libnet
18149
18150 =over 4
18151
18152 =item What is libnet ?
18153
18154 =item Which version of perl do I need ?
18155
18156 =item What other modules do I need ?
18157
18158 =item What machines support libnet ?
18159
18160 =item Where can I get the latest libnet release
18161
18162 =back
18163
18164 =item Using Net::FTP
18165
18166 =over 4
18167
18168 =item How do I download files from an FTP server ?
18169
18170 =item How do I transfer files in binary mode ?
18171
18172 =item How can I get the size of a file on a remote FTP server ?
18173
18174 =item How can I get the modification time of a file on a remote FTP server
18175 ?
18176
18177 =item How can I change the permissions of a file on a remote server ?
18178
18179 =item Can I do a reget operation like the ftp command ?
18180
18181 =item How do I get a directory listing from an FTP server ?
18182
18183 =item Changing directory to "" does not fail ?
18184
18185 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
18186
18187 =item I am behind an FTP proxy firewall, but cannot access machines outside
18188 ?
18189
18190 =item My ftp proxy firewall does not listen on port 21
18191
18192 =item Is it possible to change the file permissions of a file on an FTP
18193 server ?
18194
18195 =item I have seen scripts call a method message, but cannot find it
18196 documented ?
18197
18198 =item Why does Net::FTP not implement mput and mget methods
18199
18200 =back
18201
18202 =item Using Net::SMTP
18203
18204 =over 4
18205
18206 =item Why can't the part of an Email address after the @ be used as the
18207 hostname ?
18208
18209 =item Why does Net::SMTP not do DNS MX lookups ?
18210
18211 =item The verify method always returns true ?
18212
18213 =back
18214
18215 =item Debugging scripts
18216
18217 =over 4
18218
18219 =item How can I debug my scripts that use Net::* modules ?
18220
18221 =back
18222
18223 =item AUTHOR AND COPYRIGHT
18224
18225 =back
18226
18227 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
18228 functions
18229
18230 =over 4
18231
18232 =item SYNOPSIS
18233
18234 =item DESCRIPTION
18235
18236 =item EXAMPLES
18237
18238 =item NOTE
18239
18240 =item AUTHOR
18241
18242 =back
18243
18244 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
18245 functions
18246
18247 =over 4
18248
18249 =item SYNOPSIS
18250
18251 =item DESCRIPTION
18252
18253 =item NOTE
18254
18255 =item AUTHOR
18256
18257 =back
18258
18259 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
18260 functions
18261
18262 =over 4
18263
18264 =item SYNOPSIS
18265
18266 =item DESCRIPTION
18267
18268 =item EXAMPLES
18269
18270 =item NOTE
18271
18272 =item AUTHOR
18273
18274 =back
18275
18276 =head2 Netrc, Net::Netrc - OO interface to users netrc file
18277
18278 =over 4
18279
18280 =item SYNOPSIS
18281
18282 =item DESCRIPTION
18283
18284 =item THE .netrc FILE
18285
18286 machine name, default, login name, password string, account string, macdef
18287 name
18288
18289 =item CONSTRUCTOR
18290
18291 lookup ( MACHINE [, LOGIN ])
18292
18293 =item METHODS
18294
18295 login (), password (), account (), lpa ()
18296
18297 =item AUTHOR
18298
18299 =item SEE ALSO
18300
18301 =item COPYRIGHT
18302
18303 =back
18304
18305 =head2 O - Generic interface to Perl Compiler backends
18306
18307 =over 4
18308
18309 =item SYNOPSIS
18310
18311 =item DESCRIPTION
18312
18313 =item CONVENTIONS
18314
18315 =item IMPLEMENTATION
18316
18317 =item BUGS
18318
18319 =item AUTHOR
18320
18321 =back
18322
18323 =head2 ODBM_File - Tied access to odbm files
18324
18325 =over 4
18326
18327 =item SYNOPSIS
18328
18329 =item DESCRIPTION
18330
18331 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
18332
18333 =item DIAGNOSTICS
18334
18335 =over 4
18336
18337 =item C<odbm store returned -1, errno 22, key "..." at ...>
18338
18339 =back
18340
18341 =item BUGS AND WARNINGS
18342
18343 =back
18344
18345 =head2 Opcode - Disable named opcodes when compiling perl code
18346
18347 =over 4
18348
18349 =item SYNOPSIS
18350
18351 =item DESCRIPTION
18352
18353 =item NOTE
18354
18355 =item WARNING
18356
18357 =item Operator Names and Operator Lists
18358
18359 an operator name (opname), an operator tag name (optag), a negated opname
18360 or optag, an operator set (opset)
18361
18362 =item Opcode Functions
18363
18364 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
18365 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
18366 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
18367 opdump (PAT)
18368
18369 =item Manipulating Opsets
18370
18371 =item TO DO (maybe)
18372
18373 =back
18374
18375 =over 4
18376
18377 =item Predefined Opcode Tags
18378
18379 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
18380 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
18381 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
18382 :dangerous
18383
18384 =item SEE ALSO
18385
18386 =item AUTHORS
18387
18388 =back
18389
18390 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
18391 compartments
18392
18393 =over 4
18394
18395 =item SYNOPSIS
18396
18397 =item DESCRIPTION
18398
18399 a new namespace, an operator mask
18400
18401 =item WARNING
18402
18403 =over 4
18404
18405 =item RECENT CHANGES
18406
18407 =item Methods in class Safe
18408
18409 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
18410 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
18411 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
18412 root (NAMESPACE), mask (MASK)
18413
18414 =item Some Safety Issues
18415
18416 Memory, CPU, Snooping, Signals, State Changes
18417
18418 =item AUTHOR
18419
18420 =back
18421
18422 =back
18423
18424 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
18425 compiling
18426
18427 =over 4
18428
18429 =item SYNOPSIS  
18430
18431 =item DESCRIPTION
18432
18433 =item SEE ALSO
18434
18435 =back
18436
18437 =head2 POSIX - Perl interface to IEEE Std 1003.1
18438
18439 =over 4
18440
18441 =item SYNOPSIS
18442
18443 =item DESCRIPTION
18444
18445 =item NOTE
18446
18447 =item CAVEATS 
18448
18449 =item FUNCTIONS
18450
18451 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
18452 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
18453 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
18454 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
18455 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
18456 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
18457 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
18458 fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv,
18459 geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid,
18460 getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha,
18461 isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace,
18462 isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime,
18463 log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr,
18464 memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice,
18465 offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc,
18466 putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename,
18467 rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid,
18468 setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
18469 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
18470 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
18471 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
18472 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
18473 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
18474 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
18475 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
18476 wctomb, write
18477
18478 =item CLASSES
18479
18480 =over 4
18481
18482 =item POSIX::SigAction
18483
18484 new, handler, mask, flags, safe
18485
18486 =item POSIX::SigSet
18487
18488 new, addset, delset, emptyset, fillset, ismember
18489
18490 =item POSIX::Termios
18491
18492 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
18493 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
18494 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
18495 field values, c_cflag field values, c_iflag field values, c_lflag field
18496 values, c_oflag field values
18497
18498 =back
18499
18500 =item PATHNAME CONSTANTS
18501
18502 Constants
18503
18504 =item POSIX CONSTANTS
18505
18506 Constants
18507
18508 =item SYSTEM CONFIGURATION
18509
18510 Constants
18511
18512 =item ERRNO
18513
18514 Constants
18515
18516 =item FCNTL
18517
18518 Constants
18519
18520 =item FLOAT
18521
18522 Constants
18523
18524 =item LIMITS
18525
18526 Constants
18527
18528 =item LOCALE
18529
18530 Constants
18531
18532 =item MATH
18533
18534 Constants
18535
18536 =item SIGNAL
18537
18538 Constants
18539
18540 =item STAT
18541
18542 Constants, Macros
18543
18544 =item STDLIB
18545
18546 Constants
18547
18548 =item STDIO
18549
18550 Constants
18551
18552 =item TIME
18553
18554 Constants
18555
18556 =item UNISTD
18557
18558 Constants
18559
18560 =item WAIT
18561
18562 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
18563 WTERMSIG, WIFSTOPPED, WSTOPSIG
18564
18565 =back
18566
18567 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
18568 name space
18569
18570 =over 4
18571
18572 =item SYNOPSIS
18573
18574 =item DESCRIPTION
18575
18576 :unix, :stdio, :perlio, :crlf, :mmap, :utf8, :bytes, :raw, :pop, :win32
18577
18578 =over 4
18579
18580 =item Custom Layers
18581
18582 :encoding, :via
18583
18584 =item Alternatives to raw
18585
18586 =item Defaults and how to override them
18587
18588 =item Querying the layers of filehandles
18589
18590 =back
18591
18592 =item AUTHOR
18593
18594 =item SEE ALSO
18595
18596 =back
18597
18598 =head2 PerlIO::encoding - encoding layer
18599
18600 =over 4
18601
18602 =item SYNOPSIS
18603
18604 =item DESCRIPTION
18605
18606 =item SEE ALSO
18607
18608 =back
18609
18610 =head2 PerlIO::scalar - in-memory IO, scalar IO
18611
18612 =over 4
18613
18614 =item SYNOPSIS
18615
18616 =item DESCRIPTION
18617
18618 =item IMPLEMENTATION NOTE
18619
18620 =back
18621
18622 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
18623
18624 =over 4
18625
18626 =item SYNOPSIS
18627
18628 =item DESCRIPTION
18629
18630 =item EXPECTED METHODS
18631
18632 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
18633 $obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]),
18634 $obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]),
18635 $obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh),
18636 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
18637 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
18638 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
18639 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
18640
18641 =item EXAMPLES
18642
18643 =over 4
18644
18645 =item Example - a Hexadecimal Handle
18646
18647 =back
18648
18649 =back
18650
18651 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
18652
18653 =over 4
18654
18655 =item SYNOPSIS
18656
18657 =item DESCRIPTION
18658
18659 =item REQUIRED MODULES
18660
18661 =item SEE ALSO
18662
18663 =item ACKNOWLEDGEMENTS
18664
18665 =item COPYRIGHT
18666
18667 =back
18668
18669 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
18670
18671 =over 4
18672
18673 =item SYNOPSIS
18674
18675 =item OPTIONS/ARGUMENTS
18676
18677 =over 4
18678
18679 =item podchecker()
18680
18681 B<-warnings> =E<gt> I<val>
18682
18683 =back
18684
18685 =item DESCRIPTION
18686
18687 =item DIAGNOSTICS
18688
18689 =over 4
18690
18691 =item Errors
18692
18693 empty =headn, =over on line I<N> without closing =back, =item without
18694 previous =over, =back without previous =over, No argument for =begin, =end
18695 without =begin, Nested =begin's, =for without formatter specification,
18696 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
18697 interior-sequence "I<SEQ>", nested commands
18698 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
18699 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
18700 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
18701 after =back
18702
18703 =item Warnings
18704
18705 multiple occurrence of link target I<name>, line containing nothing but
18706 whitespace in paragraph, file does not start with =head, previous =item has
18707 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
18708 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
18709 items in =over, No argument for =item, empty section in previous paragraph,
18710 Verbatim paragraph in NAME section, =headI<n> without preceding higher
18711 level
18712
18713 =item Hyperlinks
18714
18715 ignoring leading/trailing whitespace in link, (section) in '$page'
18716 deprecated, alternative text/node '%s' contains non-escaped | or /
18717
18718 =back
18719
18720 =item RETURN VALUE
18721
18722 =item EXAMPLES
18723
18724 =item INTERFACE
18725
18726 =back
18727
18728 C<Pod::Checker-E<gt>new( %options )>
18729
18730 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
18731 @args )>
18732
18733 C<$checker-E<gt>num_errors()>
18734
18735 C<$checker-E<gt>num_warnings()>
18736
18737 C<$checker-E<gt>name()>
18738
18739 C<$checker-E<gt>node()>
18740
18741 C<$checker-E<gt>idx()>
18742
18743 C<$checker-E<gt>hyperlink()>
18744
18745 =over 4
18746
18747 =item AUTHOR
18748
18749 =back
18750
18751 =head2 Pod::Find - find POD documents in directory trees
18752
18753 =over 4
18754
18755 =item SYNOPSIS
18756
18757 =item DESCRIPTION
18758
18759 =back
18760
18761 =over 4
18762
18763 =item C<pod_find( { %opts } , @directories )>
18764
18765 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
18766 1>
18767
18768 =back
18769
18770 =over 4
18771
18772 =item C<simplify_name( $str )>
18773
18774 =back
18775
18776 =over 4
18777
18778 =item C<pod_where( { %opts }, $pod )>
18779
18780 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
18781 1>
18782
18783 =back
18784
18785 =over 4
18786
18787 =item C<contains_pod( $file , $verbose )>
18788
18789 =back
18790
18791 =over 4
18792
18793 =item AUTHOR
18794
18795 =item SEE ALSO
18796
18797 =back
18798
18799 =head2 Pod::Html - module to convert pod files to HTML
18800
18801 =over 4
18802
18803 =item SYNOPSIS
18804
18805 =item DESCRIPTION
18806
18807 =item ARGUMENTS
18808
18809 backlink, cachedir, css, flush, header, help, hiddendirs, htmldir,
18810 htmlroot, index, infile, libpods, netscape, outfile, podpath, podroot,
18811 quiet, recurse, title, verbose
18812
18813 =item EXAMPLE
18814
18815 =item ENVIRONMENT
18816
18817 =item AUTHOR
18818
18819 =item SEE ALSO
18820
18821 =item COPYRIGHT
18822
18823 =back
18824
18825 =head2 Pod::InputObjects - objects representing POD input paragraphs,
18826 commands, etc.
18827
18828 =over 4
18829
18830 =item SYNOPSIS
18831
18832 =item REQUIRES
18833
18834 =item EXPORTS
18835
18836 =item DESCRIPTION
18837
18838 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
18839 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
18840
18841 =back
18842
18843 =over 4
18844
18845 =item B<Pod::InputSource>
18846
18847 =back
18848
18849 =over 4
18850
18851 =item B<new()>
18852
18853 =back
18854
18855 =over 4
18856
18857 =item B<name()>
18858
18859 =back
18860
18861 =over 4
18862
18863 =item B<handle()>
18864
18865 =back
18866
18867 =over 4
18868
18869 =item B<was_cutting()>
18870
18871 =back
18872
18873 =over 4
18874
18875 =item B<Pod::Paragraph>
18876
18877 =back
18878
18879 =over 4
18880
18881 =item Pod::Paragraph-E<gt>B<new()>
18882
18883 =back
18884
18885 =over 4
18886
18887 =item $pod_para-E<gt>B<cmd_name()>
18888
18889 =back
18890
18891 =over 4
18892
18893 =item $pod_para-E<gt>B<text()>
18894
18895 =back
18896
18897 =over 4
18898
18899 =item $pod_para-E<gt>B<raw_text()>
18900
18901 =back
18902
18903 =over 4
18904
18905 =item $pod_para-E<gt>B<cmd_prefix()>
18906
18907 =back
18908
18909 =over 4
18910
18911 =item $pod_para-E<gt>B<cmd_separator()>
18912
18913 =back
18914
18915 =over 4
18916
18917 =item $pod_para-E<gt>B<parse_tree()>
18918
18919 =back
18920
18921 =over 4
18922
18923 =item $pod_para-E<gt>B<file_line()>
18924
18925 =back
18926
18927 =over 4
18928
18929 =item B<Pod::InteriorSequence>
18930
18931 =back
18932
18933 =over 4
18934
18935 =item Pod::InteriorSequence-E<gt>B<new()>
18936
18937 =back
18938
18939 =over 4
18940
18941 =item $pod_seq-E<gt>B<cmd_name()>
18942
18943 =back
18944
18945 =over 4
18946
18947 =item $pod_seq-E<gt>B<prepend()>
18948
18949 =back
18950
18951 =over 4
18952
18953 =item $pod_seq-E<gt>B<append()>
18954
18955 =back
18956
18957 =over 4
18958
18959 =item $pod_seq-E<gt>B<nested()>
18960
18961 =back
18962
18963 =over 4
18964
18965 =item $pod_seq-E<gt>B<raw_text()>
18966
18967 =back
18968
18969 =over 4
18970
18971 =item $pod_seq-E<gt>B<left_delimiter()>
18972
18973 =back
18974
18975 =over 4
18976
18977 =item $pod_seq-E<gt>B<right_delimiter()>
18978
18979 =back
18980
18981 =over 4
18982
18983 =item $pod_seq-E<gt>B<parse_tree()>
18984
18985 =back
18986
18987 =over 4
18988
18989 =item $pod_seq-E<gt>B<file_line()>
18990
18991 =back
18992
18993 =over 4
18994
18995 =item Pod::InteriorSequence::B<DESTROY()>
18996
18997 =back
18998
18999 =over 4
19000
19001 =item B<Pod::ParseTree>
19002
19003 =back
19004
19005 =over 4
19006
19007 =item Pod::ParseTree-E<gt>B<new()>
19008
19009 =back
19010
19011 =over 4
19012
19013 =item $ptree-E<gt>B<top()>
19014
19015 =back
19016
19017 =over 4
19018
19019 =item $ptree-E<gt>B<children()>
19020
19021 =back
19022
19023 =over 4
19024
19025 =item $ptree-E<gt>B<prepend()>
19026
19027 =back
19028
19029 =over 4
19030
19031 =item $ptree-E<gt>B<append()>
19032
19033 =back
19034
19035 =over 4
19036
19037 =item $ptree-E<gt>B<raw_text()>
19038
19039 =back
19040
19041 =over 4
19042
19043 =item Pod::ParseTree::B<DESTROY()>
19044
19045 =back
19046
19047 =over 4
19048
19049 =item SEE ALSO
19050
19051 =item AUTHOR
19052
19053 =back
19054
19055 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
19056
19057 =over 4
19058
19059 =item SYNOPSIS
19060
19061 =item DESCRIPTION
19062
19063 =back
19064
19065 =over 4
19066
19067 =item OBJECT METHODS
19068
19069 C<initialize>
19070
19071 =back
19072
19073 =over 4
19074
19075 =item Data Accessors
19076
19077 B<AddPreamble>
19078
19079 =back
19080
19081 B<AddPostamble>
19082
19083 B<Head1Level>
19084
19085 B<Label>
19086
19087 B<LevelNoNum>
19088
19089 B<MakeIndex>
19090
19091 B<ReplaceNAMEwithSection>
19092
19093 B<StartWithNewPage>
19094
19095 B<TableOfContents>
19096
19097 B<UniqueLabels>
19098
19099 B<UserPreamble>
19100
19101 B<UserPostamble>
19102
19103 B<Lists>
19104
19105 =over 4
19106
19107 =item Subclassed methods
19108
19109 =back
19110
19111 B<begin_pod>
19112
19113 B<end_pod>
19114
19115 B<command>
19116
19117 B<verbatim>
19118
19119 B<textblock>
19120
19121 B<interior_sequence>
19122
19123 =over 4
19124
19125 =item List Methods
19126
19127 B<begin_list>
19128
19129 =back
19130
19131 B<end_list>
19132
19133 B<add_item>
19134
19135 =over 4
19136
19137 =item Methods for headings
19138
19139 B<head>
19140
19141 =back
19142
19143 =over 4
19144
19145 =item Internal methods
19146
19147 B<_output>
19148
19149 =back
19150
19151 B<_replace_special_chars>
19152
19153 B<_replace_special_chars_late>
19154
19155 B<_create_label>
19156
19157 B<_create_index>
19158
19159 B<_clean_latex_commands>
19160
19161 B<_split_delimited>
19162
19163 =over 4
19164
19165 =item NOTES
19166
19167 =item SEE ALSO
19168
19169 =item AUTHORS
19170
19171 =item COPYRIGHT
19172
19173 =item REVISION
19174
19175 =back
19176
19177 =head2 Pod::Man - Convert POD data to formatted *roff input
19178
19179 =over 4
19180
19181 =item SYNOPSIS
19182
19183 =item DESCRIPTION
19184
19185 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
19186 release, section
19187
19188 =item DIAGNOSTICS
19189
19190 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
19191 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
19192 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
19193 =back
19194
19195 =item BUGS
19196
19197 =item CAVEATS
19198
19199 =item SEE ALSO
19200
19201 =item AUTHOR
19202
19203 =item COPYRIGHT AND LICENSE
19204
19205 =back
19206
19207 =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
19208
19209 =over 4
19210
19211 =item SYNOPSIS
19212
19213 =item DESCRIPTION
19214
19215 =item SEE ALSO
19216
19217 =item AUTHOR
19218
19219 =item COPYRIGHT AND LICENSE
19220
19221 =back
19222
19223 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
19224
19225 =over 4
19226
19227 =item SYNOPSIS
19228
19229 =item DESCRIPTION
19230
19231 =back
19232
19233 =over 4
19234
19235 =item Pod::List
19236
19237 Pod::List-E<gt>new()
19238
19239 =back
19240
19241 $list-E<gt>file()
19242
19243 $list-E<gt>start()
19244
19245 $list-E<gt>indent()
19246
19247 $list-E<gt>type()
19248
19249 $list-E<gt>rx()
19250
19251 $list-E<gt>item()
19252
19253 $list-E<gt>parent()
19254
19255 $list-E<gt>tag()
19256
19257 =over 4
19258
19259 =item Pod::Hyperlink
19260
19261 Pod::Hyperlink-E<gt>new()
19262
19263 =back
19264
19265 $link-E<gt>parse($string)
19266
19267 $link-E<gt>markup($string)
19268
19269 $link-E<gt>text()
19270
19271 $link-E<gt>warning()
19272
19273 $link-E<gt>file(), $link-E<gt>line()
19274
19275 $link-E<gt>page()
19276
19277 $link-E<gt>node()
19278
19279 $link-E<gt>alttext()
19280
19281 $link-E<gt>type()
19282
19283 $link-E<gt>link()
19284
19285 =over 4
19286
19287 =item Pod::Cache
19288
19289 Pod::Cache-E<gt>new()
19290
19291 =back
19292
19293 $cache-E<gt>item()
19294
19295 $cache-E<gt>find_page($name)
19296
19297 =over 4
19298
19299 =item Pod::Cache::Item
19300
19301 Pod::Cache::Item-E<gt>new()
19302
19303 =back
19304
19305 $cacheitem-E<gt>page()
19306
19307 $cacheitem-E<gt>description()
19308
19309 $cacheitem-E<gt>path()
19310
19311 $cacheitem-E<gt>file()
19312
19313 $cacheitem-E<gt>nodes()
19314
19315 $cacheitem-E<gt>find_node($name)
19316
19317 $cacheitem-E<gt>idx()
19318
19319 =over 4
19320
19321 =item AUTHOR
19322
19323 =item SEE ALSO
19324
19325 =back
19326
19327 =head2 Pod::Parser - base class for creating POD filters and translators
19328
19329 =over 4
19330
19331 =item SYNOPSIS
19332
19333 =item REQUIRES
19334
19335 =item EXPORTS
19336
19337 =item DESCRIPTION
19338
19339 =item QUICK OVERVIEW
19340
19341 =item PARSING OPTIONS
19342
19343 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
19344 B<-warnings> (default: unset)
19345
19346 =back
19347
19348 =over 4
19349
19350 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
19351
19352 =back
19353
19354 =over 4
19355
19356 =item B<command()>
19357
19358 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
19359
19360 =back
19361
19362 =over 4
19363
19364 =item B<verbatim()>
19365
19366 C<$text>, C<$line_num>, C<$pod_para>
19367
19368 =back
19369
19370 =over 4
19371
19372 =item B<textblock()>
19373
19374 C<$text>, C<$line_num>, C<$pod_para>
19375
19376 =back
19377
19378 =over 4
19379
19380 =item B<interior_sequence()>
19381
19382 =back
19383
19384 =over 4
19385
19386 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
19387
19388 =back
19389
19390 =over 4
19391
19392 =item B<new()>
19393
19394 =back
19395
19396 =over 4
19397
19398 =item B<initialize()>
19399
19400 =back
19401
19402 =over 4
19403
19404 =item B<begin_pod()>
19405
19406 =back
19407
19408 =over 4
19409
19410 =item B<begin_input()>
19411
19412 =back
19413
19414 =over 4
19415
19416 =item B<end_input()>
19417
19418 =back
19419
19420 =over 4
19421
19422 =item B<end_pod()>
19423
19424 =back
19425
19426 =over 4
19427
19428 =item B<preprocess_line()>
19429
19430 =back
19431
19432 =over 4
19433
19434 =item B<preprocess_paragraph()>
19435
19436 =back
19437
19438 =over 4
19439
19440 =item METHODS FOR PARSING AND PROCESSING
19441
19442 =back
19443
19444 =over 4
19445
19446 =item B<parse_text()>
19447
19448 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
19449 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
19450 I<code-ref>|I<method-name>
19451
19452 =back
19453
19454 =over 4
19455
19456 =item B<interpolate()>
19457
19458 =back
19459
19460 =over 4
19461
19462 =item B<parse_paragraph()>
19463
19464 =back
19465
19466 =over 4
19467
19468 =item B<parse_from_filehandle()>
19469
19470 =back
19471
19472 =over 4
19473
19474 =item B<parse_from_file()>
19475
19476 =back
19477
19478 =over 4
19479
19480 =item ACCESSOR METHODS
19481
19482 =back
19483
19484 =over 4
19485
19486 =item B<errorsub()>
19487
19488 =back
19489
19490 =over 4
19491
19492 =item B<cutting()>
19493
19494 =back
19495
19496 =over 4
19497
19498 =item B<parseopts()>
19499
19500 =back
19501
19502 =over 4
19503
19504 =item B<output_file()>
19505
19506 =back
19507
19508 =over 4
19509
19510 =item B<output_handle()>
19511
19512 =back
19513
19514 =over 4
19515
19516 =item B<input_file()>
19517
19518 =back
19519
19520 =over 4
19521
19522 =item B<input_handle()>
19523
19524 =back
19525
19526 =over 4
19527
19528 =item B<input_streams()>
19529
19530 =back
19531
19532 =over 4
19533
19534 =item B<top_stream()>
19535
19536 =back
19537
19538 =over 4
19539
19540 =item PRIVATE METHODS AND DATA
19541
19542 =back
19543
19544 =over 4
19545
19546 =item B<_push_input_stream()>
19547
19548 =back
19549
19550 =over 4
19551
19552 =item B<_pop_input_stream()>
19553
19554 =back
19555
19556 =over 4
19557
19558 =item TREE-BASED PARSING
19559
19560 =item SEE ALSO
19561
19562 =item AUTHOR
19563
19564 =back
19565
19566 =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors
19567
19568 =over 4
19569
19570 =item SYNOPSIS
19571
19572 =item DESCRIPTION
19573
19574 =item SEE ALSO
19575
19576 =item COPYRIGHT AND DISCLAIMERS
19577
19578 =item AUTHOR
19579
19580 =back
19581
19582 =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages
19583
19584 =over 4
19585
19586 =item SYNOPSIS
19587
19588 =item DESCRIPTION
19589
19590 =item CAVEAT
19591
19592 =item SEE ALSO
19593
19594 =item COPYRIGHT AND DISCLAIMERS
19595
19596 =item AUTHOR
19597
19598 =back
19599
19600 =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff
19601
19602 =over 4
19603
19604 =item SYNOPSIS
19605
19606 =item DESCRIPTION
19607
19608 =item CAVEAT
19609
19610 =item SEE ALSO
19611
19612 =item COPYRIGHT AND DISCLAIMERS
19613
19614 =item AUTHOR
19615
19616 =back
19617
19618 =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod!
19619
19620 =over 4
19621
19622 =item SYNOPSIS
19623
19624 =item DESCRIPTION
19625
19626 =item SEE ALSO
19627
19628 =item COPYRIGHT AND DISCLAIMERS
19629
19630 =item AUTHOR
19631
19632 =back
19633
19634 =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF
19635
19636 =over 4
19637
19638 =item SYNOPSIS
19639
19640 =item DESCRIPTION
19641
19642 =item SEE ALSO
19643
19644 =item COPYRIGHT AND DISCLAIMERS
19645
19646 =item AUTHOR
19647
19648 =back
19649
19650 =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext
19651
19652 =over 4
19653
19654 =item SYNOPSIS
19655
19656 =item DESCRIPTION
19657
19658 =item CAVEAT
19659
19660 =item SEE ALSO
19661
19662 =item COPYRIGHT AND DISCLAIMERS
19663
19664 =item AUTHOR
19665
19666 =back
19667
19668 =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod
19669
19670 =over 4
19671
19672 =item SYNOPSIS
19673
19674 =item DESCRIPTION
19675
19676 =item SEE ALSO
19677
19678 =item AUTHOR
19679
19680 =back
19681
19682 =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML
19683
19684 =over 4
19685
19686 =item SYNOPSIS
19687
19688 =item DESCRIPTION
19689
19690 =item SEE ALSO
19691
19692 =item COPYRIGHT AND DISCLAIMERS
19693
19694 =item AUTHOR
19695
19696 =back
19697
19698 =head2 Pod::PlainText - Convert POD data to formatted ASCII text
19699
19700 =over 4
19701
19702 =item SYNOPSIS
19703
19704 =item DESCRIPTION
19705
19706 alt, indent, loose, sentence, width
19707
19708 =item DIAGNOSTICS
19709
19710 Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
19711 Unknown sequence: %s, Unmatched =back
19712
19713 =item RESTRICTIONS
19714
19715 =item NOTES
19716
19717 =item SEE ALSO
19718
19719 =item AUTHOR
19720
19721 =back
19722
19723 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
19724
19725 =over 4
19726
19727 =item SYNOPSIS
19728
19729 =item DESCRIPTION
19730
19731 =over 4
19732
19733 =item EXPORT
19734
19735 =back
19736
19737 =item AUTHOR
19738
19739 =item SEE ALSO
19740
19741 =back
19742
19743 =head2 Pod::Select, podselect() - extract selected sections of POD from
19744 input
19745
19746 =over 4
19747
19748 =item SYNOPSIS
19749
19750 =item REQUIRES
19751
19752 =item EXPORTS
19753
19754 =item DESCRIPTION
19755
19756 =item SECTION SPECIFICATIONS
19757
19758 =item RANGE SPECIFICATIONS
19759
19760 =back
19761
19762 =over 4
19763
19764 =item OBJECT METHODS
19765
19766 =back
19767
19768 =over 4
19769
19770 =item B<curr_headings()>
19771
19772 =back
19773
19774 =over 4
19775
19776 =item B<select()>
19777
19778 =back
19779
19780 =over 4
19781
19782 =item B<add_selection()>
19783
19784 =back
19785
19786 =over 4
19787
19788 =item B<clear_selections()>
19789
19790 =back
19791
19792 =over 4
19793
19794 =item B<match_section()>
19795
19796 =back
19797
19798 =over 4
19799
19800 =item B<is_selected()>
19801
19802 =back
19803
19804 =over 4
19805
19806 =item EXPORTED FUNCTIONS
19807
19808 =back
19809
19810 =over 4
19811
19812 =item B<podselect()>
19813
19814 B<-output>, B<-sections>, B<-ranges>
19815
19816 =back
19817
19818 =over 4
19819
19820 =item PRIVATE METHODS AND DATA
19821
19822 =back
19823
19824 =over 4
19825
19826 =item B<_compile_section_spec()>
19827
19828 =back
19829
19830 =over 4
19831
19832 =item $self->{_SECTION_HEADINGS}
19833
19834 =back
19835
19836 =over 4
19837
19838 =item $self->{_SELECTED_SECTIONS}
19839
19840 =back
19841
19842 =over 4
19843
19844 =item SEE ALSO
19845
19846 =item AUTHOR
19847
19848 =back
19849
19850 =head2 Pod::Text - Convert POD data to formatted ASCII text
19851
19852 =over 4
19853
19854 =item SYNOPSIS
19855
19856 =item DESCRIPTION
19857
19858 alt, code, indent, loose, margin, quotes, sentence, width
19859
19860 =item DIAGNOSTICS
19861
19862 Bizarre space in item, Item called without tag, Can't open %s for reading:
19863 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
19864 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
19865 Unmatched =back
19866
19867 =item RESTRICTIONS
19868
19869 =item NOTES
19870
19871 =item SEE ALSO
19872
19873 =item AUTHOR
19874
19875 =item COPYRIGHT AND LICENSE
19876
19877 =back
19878
19879 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
19880
19881 =over 4
19882
19883 =item SYNOPSIS
19884
19885 =item DESCRIPTION
19886
19887 =item BUGS
19888
19889 =item SEE ALSO
19890
19891 =item AUTHOR
19892
19893 =item COPYRIGHT AND LICENSE
19894
19895 =back
19896
19897 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
19898 text
19899
19900 =over 4
19901
19902 =item SYNOPSIS
19903
19904 =item DESCRIPTION
19905
19906 =item BUGS
19907
19908 =item SEE ALSO
19909
19910 =item AUTHOR
19911
19912 =item COPYRIGHT AND LICENSE
19913
19914 =back
19915
19916 =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
19917 escapes
19918
19919 =over 4
19920
19921 =item SYNOPSIS
19922
19923 =item DESCRIPTION
19924
19925 =item NOTES
19926
19927 =item SEE ALSO
19928
19929 =item AUTHOR
19930
19931 =item COPYRIGHT AND LICENSE
19932
19933 =back
19934
19935 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
19936 documentation
19937
19938 =over 4
19939
19940 =item SYNOPSIS
19941
19942 =item ARGUMENTS
19943
19944 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-section>, C<-output>,
19945 C<-input>, C<-pathlist>
19946
19947 =item DESCRIPTION
19948
19949 =item EXAMPLES
19950
19951 =over 4
19952
19953 =item Recommended Use
19954
19955 =back
19956
19957 =item CAVEATS
19958
19959 =item AUTHOR
19960
19961 =item ACKNOWLEDGEMENTS
19962
19963 =back
19964
19965 =head2 SDBM_File - Tied access to sdbm files
19966
19967 =over 4
19968
19969 =item SYNOPSIS
19970
19971 =item DESCRIPTION
19972
19973 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
19974
19975 =item DIAGNOSTICS
19976
19977 =over 4
19978
19979 =item C<sdbm store returned -1, errno 22, key "..." at ...>
19980
19981 =back
19982
19983 =item BUGS AND WARNINGS
19984
19985 =back
19986
19987 =head2 Safe - Compile and execute code in restricted compartments
19988
19989 =over 4
19990
19991 =item SYNOPSIS
19992
19993 =item DESCRIPTION
19994
19995 a new namespace, an operator mask
19996
19997 =item WARNING
19998
19999 =over 4
20000
20001 =item RECENT CHANGES
20002
20003 =item Methods in class Safe
20004
20005 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
20006 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
20007 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
20008 root (NAMESPACE), mask (MASK)
20009
20010 =item Some Safety Issues
20011
20012 Memory, CPU, Snooping, Signals, State Changes
20013
20014 =item AUTHOR
20015
20016 =back
20017
20018 =back
20019
20020 =head2 Scalar::Util - A selection of general-utility scalar subroutines
20021
20022 =over 4
20023
20024 =item SYNOPSIS
20025
20026 =item DESCRIPTION
20027
20028 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
20029 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
20030 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
20031
20032 =item KNOWN BUGS
20033
20034 =item COPYRIGHT
20035
20036 =item BLATANT PLUG
20037
20038 =back
20039
20040 =head2 Search::Dict, look - search for key in dictionary file
20041
20042 =over 4
20043
20044 =item SYNOPSIS
20045
20046 =item DESCRIPTION
20047
20048 =back
20049
20050 =head2 SelectSaver - save and restore selected file handle
20051
20052 =over 4
20053
20054 =item SYNOPSIS
20055
20056 =item DESCRIPTION
20057
20058 =back
20059
20060 =head2 SelfLoader - load functions only on demand
20061
20062 =over 4
20063
20064 =item SYNOPSIS
20065
20066 =item DESCRIPTION
20067
20068 =over 4
20069
20070 =item The __DATA__ token
20071
20072 =item SelfLoader autoloading
20073
20074 =item Autoloading and package lexicals
20075
20076 =item SelfLoader and AutoLoader
20077
20078 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
20079
20080 =item Classes and inherited methods.
20081
20082 =back
20083
20084 =item Multiple packages and fully qualified subroutine names
20085
20086 =back
20087
20088 =head2 Shell - run shell commands transparently within perl
20089
20090 =over 4
20091
20092 =item SYNOPSIS
20093
20094 =item DESCRIPTION
20095
20096 =over 4
20097
20098 =item Caveats
20099
20100 =item Escaping Magic Characters
20101
20102 =item Configuration
20103
20104 =back
20105
20106 =item BUGS
20107
20108 =item AUTHOR
20109
20110 =back
20111
20112 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
20113 socket.h defines and structure manipulators 
20114
20115 =over 4
20116
20117 =item SYNOPSIS
20118
20119 =item DESCRIPTION
20120
20121 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
20122 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
20123 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
20124 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
20125 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
20126
20127 =back
20128
20129 =head2 Storable - persistence for Perl data structures
20130
20131 =over 4
20132
20133 =item SYNOPSIS
20134
20135 =item DESCRIPTION
20136
20137 =item MEMORY STORE
20138
20139 =item ADVISORY LOCKING
20140
20141 =item SPEED
20142
20143 =item CANONICAL REPRESENTATION
20144
20145 =item CODE REFERENCES
20146
20147 =item FORWARD COMPATIBILITY
20148
20149 utf8 data, restricted hashes, files from future versions of Storable
20150
20151 =item ERROR REPORTING
20152
20153 =item WIZARDS ONLY
20154
20155 =over 4
20156
20157 =item Hooks
20158
20159 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
20160 I<serialized>, ..
20161
20162 =item Predicates
20163
20164 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
20165 C<Storable::is_retrieving>
20166
20167 =item Recursion
20168
20169 =item Deep Cloning
20170
20171 =back
20172
20173 =item Storable magic
20174
20175 =item EXAMPLES
20176
20177 =item WARNING
20178
20179 =item BUGS
20180
20181 =over 4
20182
20183 =item 64 bit data in perl 5.6.0 and 5.6.1
20184
20185 =back
20186
20187 =item CREDITS
20188
20189 =item AUTHOR
20190
20191 =item SEE ALSO
20192
20193 =back
20194
20195 =head2 Switch - A switch statement for Perl
20196
20197 =over 4
20198
20199 =item VERSION
20200
20201 =item SYNOPSIS
20202
20203 =item BACKGROUND
20204
20205 =item DESCRIPTION
20206
20207 =over 4
20208
20209 =item Allowing fall-through
20210
20211 =item Automating fall-through
20212
20213 =item Alternative syntax
20214
20215 =item Higher-order Operations
20216
20217 =back
20218
20219 =item DEPENDENCIES
20220
20221 =item AUTHOR
20222
20223 =item BUGS
20224
20225 =item LIMITATIONS
20226
20227 =item COPYRIGHT
20228
20229 =back
20230
20231 =head2 Symbol - manipulate Perl symbols and their names
20232
20233 =over 4
20234
20235 =item SYNOPSIS
20236
20237 =item DESCRIPTION
20238
20239 =item BUGS
20240
20241 =back
20242
20243 =head2 Sys::Hostname - Try every conceivable way to get hostname
20244
20245 =over 4
20246
20247 =item SYNOPSIS
20248
20249 =item DESCRIPTION
20250
20251 =item AUTHOR
20252
20253 =back
20254
20255 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
20256 interface to the UNIX syslog(3) calls
20257
20258 =over 4
20259
20260 =item SYNOPSIS
20261
20262 =item DESCRIPTION
20263
20264 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
20265 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
20266 in 5.004_02), closelog
20267
20268 =item EXAMPLES
20269
20270 =item SEE ALSO
20271
20272 =item AUTHOR
20273
20274 =back
20275
20276 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
20277 Perl interface to the UNIX syslog(3) calls
20278
20279 =over 4
20280
20281 =item SYNOPSIS
20282
20283 =item DESCRIPTION
20284
20285 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
20286 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
20287 in 5.004_02), closelog
20288
20289 =item EXAMPLES
20290
20291 =item SEE ALSO
20292
20293 =item AUTHOR
20294
20295 =back
20296
20297 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
20298
20299 =over 4
20300
20301 =item SYNOPSIS
20302
20303 =item DESCRIPTION
20304
20305 =item DIAGNOSTICS
20306
20307 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
20308 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
20309 comma allowed after filehandle, No name for escape sequence %s
20310
20311 =item ENVIRONMENT
20312
20313 ANSI_COLORS_DISABLED
20314
20315 =item RESTRICTIONS
20316
20317 =item NOTES
20318
20319 =item SEE ALSO
20320
20321 =item AUTHORS
20322
20323 =item COPYRIGHT AND LICENSE
20324
20325 =back
20326
20327 =head2 Term::Cap - Perl termcap interface
20328
20329 =over 4
20330
20331 =item SYNOPSIS
20332
20333 =item DESCRIPTION
20334
20335 =over 4
20336
20337 =item METHODS
20338
20339 =back
20340
20341 =back
20342
20343 B<Tgetent>, OSPEED, TERM
20344
20345 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
20346
20347 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
20348
20349 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
20350
20351 B<Trequire>
20352
20353 =over 4
20354
20355 =item EXAMPLES
20356
20357 =item COPYRIGHT AND LICENSE
20358
20359 =item AUTHOR
20360
20361 =item SEE ALSO
20362
20363 =back
20364
20365 =head2 Term::Complete - Perl word completion module
20366
20367 =over 4
20368
20369 =item SYNOPSIS
20370
20371 =item DESCRIPTION
20372
20373 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
20374
20375 =item DIAGNOSTICS
20376
20377 =item BUGS
20378
20379 =item AUTHOR
20380
20381 =back
20382
20383 =head2 Term::ReadLine - Perl interface to various C<readline> packages.
20384 If no real package is found, substitutes stubs instead of basic functions.
20385
20386 =over 4
20387
20388 =item SYNOPSIS
20389
20390 =item DESCRIPTION
20391
20392 =item Minimal set of supported functions
20393
20394 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>,
20395 C<findConsole>, Attribs, C<Features>
20396
20397 =item Additional supported functions
20398
20399 C<tkRunning>, C<ornaments>, C<newTTY>
20400
20401 =item EXPORTS
20402
20403 =item ENVIRONMENT
20404
20405 =item CAVEATS
20406
20407 =back
20408
20409 =head2 Test - provides a simple framework for writing test scripts
20410
20411 =over 4
20412
20413 =item SYNOPSIS
20414
20415 =item DESCRIPTION
20416
20417 =item QUICK START GUIDE
20418
20419 =over 4
20420
20421 =item Functions
20422
20423 C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>,
20424 C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub>
20425
20426 =back
20427
20428 =back
20429
20430 B<_to_value>
20431
20432 C<ok(...)>
20433
20434 C<skip(I<skip_if_true>, I<args...>)>
20435
20436 =over 4
20437
20438 =item TEST TYPES
20439
20440 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
20441
20442 =item ONFAIL
20443
20444 =item BUGS and CAVEATS
20445
20446 =item ENVIRONMENT
20447
20448 =item NOTE
20449
20450 =item SEE ALSO
20451
20452 =item AUTHOR
20453
20454 =back
20455
20456 =head2 Test::Builder - Backend for building test libraries
20457
20458 =over 4
20459
20460 =item SYNOPSIS
20461
20462 =item DESCRIPTION
20463
20464 =over 4
20465
20466 =item Construction
20467
20468 B<new>
20469
20470 =back
20471
20472 =back
20473
20474 B<reset>
20475
20476 =over 4
20477
20478 =item Setting up tests
20479
20480 B<exported_to>
20481
20482 =back
20483
20484 B<plan>
20485
20486 B<expected_tests>
20487
20488 B<no_plan>
20489
20490 B<has_plan>
20491
20492 B<skip_all>
20493
20494 =over 4
20495
20496 =item Running tests
20497
20498 B<ok>
20499
20500 =back
20501
20502 B<is_eq>, B<is_num>
20503
20504 B<isnt_eq>, B<isnt_num>
20505
20506 B<like>, B<unlike>
20507
20508 B<maybe_regex>
20509
20510 B<cmp_ok>
20511
20512 B<BAILOUT>
20513
20514 B<skip>
20515
20516 B<todo_skip>
20517
20518 B<skip_rest>
20519
20520 =over 4
20521
20522 =item Test style
20523
20524 B<level>
20525
20526 =back
20527
20528 B<use_numbers>
20529
20530 B<no_header>, B<no_ending>
20531
20532 =over 4
20533
20534 =item Output
20535
20536 B<diag>
20537
20538 =back
20539
20540 B<_print>
20541
20542 B<_print_diag>
20543
20544 B<output>, B<failure_output>, B<todo_output>
20545
20546 =over 4
20547
20548 =item Test Status and Info
20549
20550 B<current_test>
20551
20552 =back
20553
20554 B<summary>
20555
20556 B<details>
20557
20558 B<todo>
20559
20560 B<caller>
20561
20562 B<_sanity_check>
20563
20564 B<_whoa>
20565
20566 B<_my_exit>
20567
20568 =over 4
20569
20570 =item EXIT CODES
20571
20572 =item THREADS
20573
20574 =item EXAMPLES
20575
20576 =item SEE ALSO
20577
20578 =item AUTHORS
20579
20580 =item COPYRIGHT
20581
20582 =back
20583
20584 =head2 Test::Harness - Run Perl standard test scripts with statistics
20585
20586 =over 4
20587
20588 =item VERSION
20589
20590 =back
20591
20592 =over 4
20593
20594 =item SYNOPSIS
20595
20596 =item DESCRIPTION
20597
20598 =over 4
20599
20600 =item Taint mode
20601
20602 =item Configuration variables.
20603
20604 C<$Test::Harness::Verbose>, C<$Test::Harness::switches>
20605
20606 =item Failure
20607
20608 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
20609 Failed>
20610
20611 =item Functions
20612
20613 B<runtests>
20614
20615 =back
20616
20617 =back
20618
20619 B<_all_ok>
20620
20621 B<_globdir>
20622
20623 B<_run_all_tests>
20624
20625 B<_mk_leader>
20626
20627 B<_leader_width>
20628
20629 =over 4
20630
20631 =item EXPORT
20632
20633 =item DIAGNOSTICS
20634
20635 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
20636 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
20637 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
20638 %s>, C<FAILED--Further testing stopped: %s>
20639
20640 =item ENVIRONMENT
20641
20642 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
20643 C<HARNESS_DEBUG>, C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>,
20644 C<HARNESS_NOTTY>, C<HARNESS_PERL>, C<HARNESS_PERL_SWITCHES>,
20645 C<HARNESS_VERBOSE>
20646
20647 =item EXAMPLE
20648
20649 =item SEE ALSO
20650
20651 =item TODO
20652
20653 =item BUGS
20654
20655 =item AUTHORS
20656
20657 =item COPYRIGHT
20658
20659 =back
20660
20661 =head2 Test::Harness::Assert - simple assert
20662
20663 =over 4
20664
20665 =item SYNOPSIS
20666
20667 =item DESCRIPTION
20668
20669 =item FUNCTIONS
20670
20671 =over 4
20672
20673 =item C<assert()>
20674
20675 =back
20676
20677 =back
20678
20679 =over 4
20680
20681 =item AUTHOR
20682
20683 =item SEE ALSO
20684
20685 =back
20686
20687 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
20688
20689 =over 4
20690
20691 =item SYNOPSIS
20692
20693 =item DESCRIPTION
20694
20695 =over 4
20696
20697 =item new()
20698
20699 =item next()
20700
20701 =back
20702
20703 =back
20704
20705 =head2 Test::Harness::Straps - detailed analysis of test results
20706
20707 =over 4
20708
20709 =item SYNOPSIS
20710
20711 =item DESCRIPTION
20712
20713 =item Construction
20714
20715 =over 4
20716
20717 =item C<new>
20718
20719 =back
20720
20721 =back
20722
20723 =over 4
20724
20725 =item C<_init>
20726
20727 =back
20728
20729 =over 4
20730
20731 =item Analysis
20732
20733 =over 4
20734
20735 =item $strap->analyze( $name, \@output_lines )
20736
20737 =back
20738
20739 =back
20740
20741 =over 4
20742
20743 =item C<analyze_fh>
20744
20745 =back
20746
20747 =over 4
20748
20749 =item C<analyze_file>
20750
20751 =back
20752
20753 =over 4
20754
20755 =item C<_command_line( $file )>
20756
20757 =back
20758
20759 =over 4
20760
20761 =item C<_command>
20762
20763 =back
20764
20765 =over 4
20766
20767 =item C<_switches>
20768
20769 =back
20770
20771 =over 4
20772
20773 =item C<_cleaned_switches>
20774
20775 =back
20776
20777 =over 4
20778
20779 =item C<_INC2PERL5LIB>
20780
20781 =back
20782
20783 =over 4
20784
20785 =item C<_filtered_INC>
20786
20787 =back
20788
20789 =over 4
20790
20791 =item C<_restore_PERL5LIB>
20792
20793 =back
20794
20795 =over 4
20796
20797 =item Parsing
20798
20799 =over 4
20800
20801 =item C<_is_comment>
20802
20803 =back
20804
20805 =back
20806
20807 =over 4
20808
20809 =item C<_is_header>
20810
20811 =back
20812
20813 =over 4
20814
20815 =item C<_is_test>
20816
20817 =back
20818
20819 =over 4
20820
20821 =item C<_is_bail_out>
20822
20823 =back
20824
20825 =over 4
20826
20827 =item C<_reset_file_state>
20828
20829 =back
20830
20831 =over 4
20832
20833 =item Results
20834
20835 =item EXAMPLES
20836
20837 =item AUTHOR
20838
20839 =item SEE ALSO
20840
20841 =back
20842
20843 =head2 Test::Harness::TAP - Documentation for the TAP format
20844
20845 =over 4
20846
20847 =item SYNOPSIS
20848
20849 =item TERMINOLOGY
20850
20851 =item THE TAP FORMAT
20852
20853 =over 4
20854
20855 =item The test script output
20856
20857 B<"1..M">, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test labels>,
20858 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
20859 else>
20860
20861 =back
20862
20863 =item DESCRIPTION
20864
20865 =item RATIONALE
20866
20867 =item ACKNOWLEDGEMENTS
20868
20869 =item AUTHORS
20870
20871 =item COPYRIGHT
20872
20873 =back
20874
20875 =head2 Test::More - yet another framework for writing test scripts
20876
20877 =over 4
20878
20879 =item SYNOPSIS
20880
20881 =item DESCRIPTION
20882
20883 =over 4
20884
20885 =item I love it when a plan comes together
20886
20887 =back
20888
20889 =back
20890
20891 =over 4
20892
20893 =item Test names
20894
20895 =item I'm ok, you're not ok.
20896
20897 B<ok>
20898
20899 =back
20900
20901 B<is>, B<isnt>
20902
20903 B<like>
20904
20905 B<unlike>
20906
20907 B<cmp_ok>
20908
20909 B<can_ok>
20910
20911 B<isa_ok>
20912
20913 B<pass>, B<fail>
20914
20915 =over 4
20916
20917 =item Diagnostics
20918
20919 B<diag>
20920
20921 =back
20922
20923 =over 4
20924
20925 =item Module tests
20926
20927 B<use_ok>
20928
20929 =back
20930
20931 B<require_ok>
20932
20933 =over 4
20934
20935 =item Conditional tests
20936
20937 B<SKIP: BLOCK>
20938
20939 =back
20940
20941 B<TODO: BLOCK>, B<todo_skip>
20942
20943 When do I use SKIP vs. TODO?
20944
20945 =over 4
20946
20947 =item Comparison functions
20948
20949 B<is_deeply>
20950
20951 =back
20952
20953 B<eq_array>
20954
20955 B<eq_hash>
20956
20957 B<eq_set>
20958
20959 =over 4
20960
20961 =item Extending and Embedding Test::More
20962
20963 B<builder>
20964
20965 =back
20966
20967 =over 4
20968
20969 =item EXIT CODES
20970
20971 =item CAVEATS and NOTES
20972
20973 Backwards compatibility, Overloaded objects, Threads, Test::Harness upgrade
20974
20975 =item HISTORY
20976
20977 =item SEE ALSO
20978
20979 =item AUTHORS
20980
20981 =item BUGS
20982
20983 =item COPYRIGHT
20984
20985 =back
20986
20987 =head2 Test::Simple - Basic utilities for writing tests.
20988
20989 =over 4
20990
20991 =item SYNOPSIS
20992
20993 =item DESCRIPTION
20994
20995 B<ok>
20996
20997 =back
20998
20999 =over 4
21000
21001 =item EXAMPLE
21002
21003 =item CAVEATS
21004
21005 =item NOTES
21006
21007 =item HISTORY
21008
21009 =item SEE ALSO
21010
21011 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
21012 L<Test::Harness>
21013
21014 =item AUTHORS
21015
21016 =item COPYRIGHT
21017
21018 =back
21019
21020 =head2 Test::Tutorial - A tutorial about writing really basic tests
21021
21022 =over 4
21023
21024 =item DESCRIPTION
21025
21026 =over 4
21027
21028 =item Nuts and bolts of testing.
21029
21030 =item Where to start?
21031
21032 =item Names
21033
21034 =item Test the manual
21035
21036 =item Sometimes the tests are wrong
21037
21038 =item Testing lots of values
21039
21040 =item Informative names
21041
21042 =item Skipping tests
21043
21044 =item Todo tests
21045
21046 =item Testing with taint mode.
21047
21048 =back
21049
21050 =item FOOTNOTES
21051
21052 =item AUTHORS
21053
21054 =item COPYRIGHT
21055
21056 =back
21057
21058 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
21059
21060 =over 4
21061
21062 =item SYNOPSIS
21063
21064 =item DESCRIPTION
21065
21066 =item EXAMPLE
21067
21068 =back
21069
21070 =head2 Text::Balanced - Extract delimited text sequences from strings.
21071
21072 =over 4
21073
21074 =item SYNOPSIS
21075
21076 =item DESCRIPTION
21077
21078 =over 4
21079
21080 =item General behaviour in list contexts
21081
21082 [0], [1], [2]
21083
21084 =item General behaviour in scalar and void contexts
21085
21086 =item A note about prefixes
21087
21088 =item C<extract_delimited>
21089
21090 =item C<extract_bracketed>
21091
21092 =item C<extract_variable>
21093
21094 [0], [1], [2]
21095
21096 =item C<extract_tagged>
21097
21098 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
21099 [0], [1], [2], [3], [4], [5]
21100
21101 =item C<gen_extract_tagged>
21102
21103 =item C<extract_quotelike>
21104
21105 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
21106
21107 =item C<extract_quotelike> and "here documents"
21108
21109 [0], [1], [2], [3], [4], [5], [6], [7..10]
21110
21111 =item C<extract_codeblock>
21112
21113 =item C<extract_multiple>
21114
21115 =item C<gen_delimited_pat>
21116
21117 =back
21118
21119 =item DIAGNOSTICS
21120
21121  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>, 
21122 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
21123 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">, 
21124 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
21125 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
21126 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
21127 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
21128 after dereferencer>, C<Did not find expected opening bracket at %s>,
21129 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
21130 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
21131 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
21132 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
21133 tag>
21134
21135 =item AUTHOR
21136
21137 =item BUGS AND IRRITATIONS
21138
21139 =item COPYRIGHT
21140
21141 =back
21142
21143 =head2 Text::ParseWords - parse text into an array of tokens or array of
21144 arrays
21145
21146 =over 4
21147
21148 =item SYNOPSIS
21149
21150 =item DESCRIPTION
21151
21152 =item EXAMPLES
21153
21154 =item AUTHORS
21155
21156 =back
21157
21158 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
21159 by Knuth
21160
21161 =over 4
21162
21163 =item SYNOPSIS
21164
21165 =item DESCRIPTION
21166
21167 =item EXAMPLES
21168
21169 =item LIMITATIONS
21170
21171 =item AUTHOR
21172
21173 =back
21174
21175 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
21176 unexpand(1)
21177
21178 =over 4
21179
21180 =item SYNOPSIS
21181
21182 =item DESCRIPTION
21183
21184 =item BUGS
21185
21186 =item AUTHOR
21187
21188 =back
21189
21190 =head2 Text::Wrap - line wrapping to form simple paragraphs
21191
21192 =over 4
21193
21194 =item SYNOPSIS 
21195
21196 =item DESCRIPTION
21197
21198 =item OVERRIDES
21199
21200 =item EXAMPLE
21201
21202 =item AUTHOR
21203
21204 =back
21205
21206 =head2 Thread - manipulate threads in Perl (for old code only)
21207
21208 =over 4
21209
21210 =item CAVEAT
21211
21212 =item SYNOPSIS
21213
21214 =item DESCRIPTION
21215
21216 =item FUNCTIONS
21217
21218 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
21219 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
21220 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
21221
21222 =item METHODS
21223
21224 join, eval, detach, equal, tid, flags, done
21225
21226 =item LIMITATIONS
21227
21228 =item SEE ALSO
21229
21230 =back
21231
21232 =head2 Thread::Queue - thread-safe queues
21233
21234 =over 4
21235
21236 =item SYNOPSIS
21237
21238 =item DESCRIPTION
21239
21240 =item FUNCTIONS AND METHODS
21241
21242 new, enqueue LIST, dequeue, dequeue_nb, pending
21243
21244 =item SEE ALSO
21245
21246 =back
21247
21248 =head2 Thread::Semaphore - thread-safe semaphores
21249
21250 =over 4
21251
21252 =item SYNOPSIS
21253
21254 =item DESCRIPTION
21255
21256 =item FUNCTIONS AND METHODS
21257
21258 new, new NUMBER, down, down NUMBER, up, up NUMBER
21259
21260 =back
21261
21262 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
21263 (for old code)
21264
21265 =over 4
21266
21267 =item CAVEAT
21268
21269 =item SYNOPSIS
21270
21271 =item DESCRIPTION
21272
21273 =item BUGS
21274
21275 =back
21276
21277 =head2 Thread::Specific - thread-specific keys
21278
21279 =over 4
21280
21281 =item SYNOPSIS
21282
21283 =item DESCRIPTION
21284
21285 =back
21286
21287 =head2 Tie::Array - base class for tied arrays
21288
21289 =over 4
21290
21291 =item SYNOPSIS
21292
21293 =item DESCRIPTION
21294
21295 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
21296 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
21297 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
21298 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
21299
21300 =item CAVEATS
21301
21302 =item AUTHOR
21303
21304 =back
21305
21306 =head2 Tie::File - Access the lines of a disk file via a Perl array
21307
21308 =over 4
21309
21310 =item SYNOPSIS
21311
21312 =item DESCRIPTION
21313
21314 =over 4
21315
21316 =item C<recsep>
21317
21318 =item C<autochomp>
21319
21320 =item C<mode>
21321
21322 =item C<memory>
21323
21324 =item C<dw_size>
21325
21326 =item Option Format
21327
21328 =back
21329
21330 =item Public Methods
21331
21332 =over 4
21333
21334 =item C<flock>
21335
21336 =item C<autochomp>
21337
21338 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
21339
21340 =item C<offset>
21341
21342 =back
21343
21344 =item Tying to an already-opened filehandle
21345
21346 =item Deferred Writing
21347
21348 =over 4
21349
21350 =item Autodeferring
21351
21352 =back
21353
21354 =item CONCURRENT ACCESS TO FILES
21355
21356 =item CAVEATS
21357
21358 =item SUBCLASSING
21359
21360 =item WHAT ABOUT C<DB_File>?
21361
21362 =item AUTHOR
21363
21364 =item LICENSE
21365
21366 =item WARRANTY
21367
21368 =item THANKS
21369
21370 =item TODO
21371
21372 =back
21373
21374 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
21375 handles
21376
21377 =over 4
21378
21379 =item SYNOPSIS
21380
21381 =item DESCRIPTION
21382
21383 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
21384 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
21385 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
21386 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
21387
21388 =item MORE INFORMATION
21389
21390 =item COMPATIBILITY
21391
21392 =back
21393
21394 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
21395 tied hashes
21396
21397 =over 4
21398
21399 =item SYNOPSIS
21400
21401 =item DESCRIPTION
21402
21403 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
21404 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR
21405 this, SCALAR this
21406
21407 =item Inheriting from B<Tie::StdHash>
21408
21409 =item Inheriting from B<Tie::ExtraHash>
21410
21411 =item C<SCALAR>, C<UNTIE> and C<DESTROY>
21412
21413 =item MORE INFORMATION
21414
21415 =back
21416
21417 =head2 Tie::Memoize - add data to hash when needed
21418
21419 =over 4
21420
21421 =item SYNOPSIS
21422
21423 =item DESCRIPTION
21424
21425 =item Inheriting from B<Tie::Memoize>
21426
21427 =item EXAMPLE
21428
21429 =item BUGS
21430
21431 =item AUTHOR
21432
21433 =back
21434
21435 =head2 Tie::RefHash - use references as hash keys
21436
21437 =over 4
21438
21439 =item SYNOPSIS
21440
21441 =item DESCRIPTION
21442
21443 =item EXAMPLE
21444
21445 =item AUTHOR
21446
21447 =item VERSION
21448
21449 =item SEE ALSO
21450
21451 =back
21452
21453 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
21454 scalars
21455
21456 =over 4
21457
21458 =item SYNOPSIS
21459
21460 =item DESCRIPTION
21461
21462 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
21463
21464 =item MORE INFORMATION
21465
21466 =back
21467
21468 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
21469
21470 =over 4
21471
21472 =item SYNOPSIS
21473
21474 =item DESCRIPTION
21475
21476 =item CAVEATS
21477
21478 =back
21479
21480 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
21481 timers
21482
21483 =over 4
21484
21485 =item SYNOPSIS
21486
21487 =item DESCRIPTION
21488
21489 gettimeofday (), usleep ( $useconds ), nanosleep ( $nanoseconds ), ualarm (
21490 $useconds [, $interval_useconds ] ), tv_interval, time (), sleep (
21491 $floating_seconds ), alarm ( $floating_seconds [,
21492 $interval_floating_seconds ] ), setitimer ( $which, $floating_seconds [,
21493 $interval_floating_seconds ] ), getitimer ( $which )
21494
21495 =item EXAMPLES
21496
21497 =item C API
21498
21499 =item DIAGNOSTICS
21500
21501 =over 4
21502
21503 =item negative time not invented yet
21504
21505 =item internal error: useconds < 0 (unsigned ... signed ...)
21506
21507 =back
21508
21509 =item CAVEATS
21510
21511 =item AUTHORS
21512
21513 =item COPYRIGHT AND LICENSE
21514
21515 =back
21516
21517 =head2 Time::Local - efficiently compute time from local and GMT time
21518
21519 =over 4
21520
21521 =item SYNOPSIS
21522
21523 =item DESCRIPTION
21524
21525 =over 4
21526
21527 =item Ambiguous Local Times (DST)
21528
21529 =item Non-Existent Local Times (DST)
21530
21531 =item Negative Epoch Values
21532
21533 =back
21534
21535 =item IMPLEMENTATION
21536
21537 =item BUGS
21538
21539 =item SUPPORT
21540
21541 =item AUTHOR
21542
21543 =back
21544
21545 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
21546 function
21547
21548 =over 4
21549
21550 =item SYNOPSIS
21551
21552 =item DESCRIPTION
21553
21554 =item NOTE
21555
21556 =item AUTHOR
21557
21558 =back
21559
21560 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
21561 function
21562
21563 =over 4
21564
21565 =item SYNOPSIS
21566
21567 =item DESCRIPTION
21568
21569 =item NOTE
21570
21571 =item AUTHOR
21572
21573 =back
21574
21575 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
21576
21577 =over 4
21578
21579 =item SYNOPSIS
21580
21581 =item DESCRIPTION
21582
21583 =item AUTHOR
21584
21585 =back
21586
21587 =head2 UNIVERSAL - base class for ALL classes (blessed references)
21588
21589 =over 4
21590
21591 =item SYNOPSIS
21592
21593 =item DESCRIPTION
21594
21595 C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<isa( VAL, TYPE )>,
21596 C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD ) >>, C<<
21597 CLASS->can( METHOD ) >>, C<can( VAL, METHOD )>, C<VERSION ( [ REQUIRE ] )>
21598
21599 =item EXPORTS
21600
21601 =back
21602
21603 =head2 Unicode::Collate - Unicode Collation Algorithm
21604
21605 =over 4
21606
21607 =item SYNOPSIS
21608
21609 =item DESCRIPTION
21610
21611 =over 4
21612
21613 =item Constructor and Tailoring
21614
21615 UCA_Version, backwards, entry, hangul_terminator, ignoreName, ignoreChar,
21616 level, normalization, overrideCJK, overrideHangul, preprocess, rearrange,
21617 table, undefName, undefChar, katakana_before_hiragana, upper_before_lower,
21618 variable, alternate
21619
21620 =item Methods for Collation
21621
21622 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
21623 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
21624 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
21625 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
21626 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
21627 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
21628 $Collator-E<gt>viewSortKey($string)>
21629
21630 =item Methods for Searching
21631
21632 C<$position = $Collator-E<gt>index($string, $substring[, $position])>,
21633 C<($position, $length) = $Collator-E<gt>index($string, $substring[,
21634 $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>,
21635 C<($match)   = $Collator-E<gt>match($string, $substring)>, C<@match =
21636 $Collator-E<gt>gmatch($string, $substring)>, C<$count =
21637 $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count =
21638 $Collator-E<gt>gsubst($string, $substring, $replacement)>
21639
21640 =item Other Methods
21641
21642 C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, C<$version =
21643 $Collator-E<gt>version()>, C<UCA_Version()>, C<Base_Unicode_Version()>
21644
21645 =item EXPORT
21646
21647 =item CAVEAT
21648
21649 =item Conformance Test
21650
21651 =back
21652
21653 =item AUTHOR
21654
21655 =item SEE ALSO
21656
21657 Unicode Collation Algorithm - UTS #10, The Default Unicode Collation
21658 Element Table (DUCET), The conformance test for the UCA, Hangul Syllable
21659 Type, Unicode Normalization Forms - UAX #15, L<Unicode::Normalize>
21660
21661 =back
21662
21663 =head2 Unicode::Normalize - Unicode Normalization Forms
21664
21665 =over 4
21666
21667 =item SYNOPSIS
21668
21669 =item DESCRIPTION
21670
21671 =over 4
21672
21673 =item Normalization Forms
21674
21675 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
21676 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
21677 C<$FCD_string = FCD($string)>, C<$FCC_string = FCC($string)>,
21678 C<$normalized_string = normalize($form_name, $string)>
21679
21680 =item Decomposition and Composition
21681
21682 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
21683 decompose($string, $useCompatMapping)>, C<$reordered_string  =
21684 reorder($string)>, C<$composed_string   = compose($string)>
21685
21686 =item Quick Check
21687
21688 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
21689 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
21690 checkFCD($string)>, C<$result = checkFCC($string)>, C<$result =
21691 check($form_name, $string)>
21692
21693 =item Character Data
21694
21695 C<$canonical_decomposed = getCanon($codepoint)>,
21696 C<$compatibility_decomposed = getCompat($codepoint)>,
21697 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
21698 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
21699 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
21700 C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>,
21701 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
21702
21703 =item EXPORT
21704
21705 =back
21706
21707 =item AUTHOR
21708
21709 =item SEE ALSO
21710
21711 http://www.unicode.org/reports/tr15/,
21712 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt,
21713 http://www.unicode.org/notes/tn5/
21714
21715 =back
21716
21717 =head2 Unicode::UCD - Unicode character database
21718
21719 =over 4
21720
21721 =item SYNOPSIS
21722
21723 =item DESCRIPTION
21724
21725 =back
21726
21727 =over 4
21728
21729 =item charinfo
21730
21731 =back
21732
21733 =over 4
21734
21735 =item charblock
21736
21737 =back
21738
21739 =over 4
21740
21741 =item charscript
21742
21743 =back
21744
21745 =over 4
21746
21747 =item charblocks
21748
21749 =back
21750
21751 =over 4
21752
21753 =item charscripts
21754
21755 =back
21756
21757 =over 4
21758
21759 =item Blocks versus Scripts
21760
21761 =item Matching Scripts and Blocks
21762
21763 =item Code Point Arguments
21764
21765 =item charinrange
21766
21767 =back
21768
21769 =over 4
21770
21771 =item compexcl
21772
21773 =back
21774
21775 =over 4
21776
21777 =item casefold
21778
21779 =back
21780
21781 =over 4
21782
21783 =item casespec
21784
21785 =back
21786
21787 =over 4
21788
21789 =item Unicode::UCD::UnicodeVersion
21790
21791 =back
21792
21793 =over 4
21794
21795 =item Implementation Note
21796
21797 =back
21798
21799 =over 4
21800
21801 =item BUGS
21802
21803 =item AUTHOR
21804
21805 =back
21806
21807 =head2 User::grent - by-name interface to Perl's built-in getgr*()
21808 functions
21809
21810 =over 4
21811
21812 =item SYNOPSIS
21813
21814 =item DESCRIPTION
21815
21816 =item NOTE
21817
21818 =item AUTHOR
21819
21820 =back
21821
21822 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
21823 functions
21824
21825 =over 4
21826
21827 =item SYNOPSIS
21828
21829 =item DESCRIPTION
21830
21831 =over 4
21832
21833 =item System Specifics
21834
21835 =back
21836
21837 =item NOTE
21838
21839 =item AUTHOR
21840
21841 =item HISTORY
21842
21843 March 18th, 2000
21844
21845 =back
21846
21847 =head2 XSLoader - Dynamically load C libraries into Perl code
21848
21849 =over 4
21850
21851 =item SYNOPSIS
21852
21853 =item DESCRIPTION
21854
21855 =over 4
21856
21857 =item Migration from C<DynaLoader>
21858
21859 =item Backward compatible boilerplate
21860
21861 =back
21862
21863 =item Order of initialization: early load()
21864
21865 =over 4
21866
21867 =item The most hairy case
21868
21869 =back
21870
21871 =item LIMITATIONS
21872
21873 =item AUTHOR
21874
21875 =back
21876
21877 =head1 AUXILIARY DOCUMENTATION
21878
21879 Here should be listed all the extra programs' documentation, but they
21880 don't all have manual pages yet:
21881
21882 =over 4
21883
21884 =item a2p
21885
21886 =item c2ph
21887
21888 =item dprofpp
21889
21890 =item h2ph
21891
21892 =item h2xs
21893
21894 =item perlbug
21895
21896 =item perldoc
21897
21898 =item pl2pm
21899
21900 =item pod2html
21901
21902 =item pod2man
21903
21904 =item s2p
21905
21906 =item splain
21907
21908 =item xsubpp
21909
21910 =back
21911
21912 =head1 AUTHOR
21913
21914 Larry Wall <F<larry@wall.org>>, with the help of oodles
21915 of other folks.
21916