b027c516cfbf237f67e4f9513545325d828a6118
[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: 2003/01/31
769 17:37:17 $)
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.14 $, $Date:
833 2003/11/23 08:02:29 $)
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 and perl5?
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.25 $,
882 $Date: 2003/10/16 04:57:38 $)
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.37 $, $Date: 2003/11/24
938 19:55:50 $)
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 Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl,
967 GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis, Vile, Vim, Codewright,
968 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
969
970 =item Where can I get Perl macros for vi?
971
972 =item Where can I get perl-mode for emacs?
973
974 =item How can I use curses with Perl?
975
976 =item How can I use X or Tk with Perl?
977
978 =item How can I generate simple menus without using CGI or Tk?
979
980 =item How can I make my Perl program run faster?
981
982 =item How can I make my Perl program take less memory?
983
984 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
985 stringification, Pass by reference, Tie large variables to disk
986
987 =item Is it safe to return a reference to local or lexical data?
988
989 =item How can I free an array or hash so my program shrinks?
990
991 =item How can I make my CGI script more efficient?
992
993 =item How can I hide the source for my Perl program?
994
995 =item How can I compile my Perl program into byte code or C?
996
997 =item How can I compile Perl into Java?
998
999 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
1000
1001 =item Can I write useful Perl programs on the command line?
1002
1003 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
1004
1005 =item Where can I learn about CGI or Web programming in Perl?
1006
1007 =item Where can I learn about object-oriented Perl programming?
1008
1009 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
1010
1011 =item I've read perlembed, perlguts, etc., but I can't embed perl in
1012 my C program; what am I doing wrong?
1013
1014 =item When I tried to run my script, I got this message. What does it mean?
1015
1016 =item What's MakeMaker?
1017
1018 =back
1019
1020 =item AUTHOR AND COPYRIGHT
1021
1022 =back
1023
1024 =head2 perlfaq4 - Data Manipulation ($Revision: 1.54 $, $Date: 2003/11/30
1025 00:50:08 $)
1026
1027 =over 4
1028
1029 =item DESCRIPTION
1030
1031 =item Data: Numbers
1032
1033 =over 4
1034
1035 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
1036 numbers I should be getting (eg, 19.95)?
1037
1038 =item Why is int() broken?
1039
1040 =item Why isn't my octal data interpreted correctly?
1041
1042 =item Does Perl have a round() function?  What about ceil() and floor()? 
1043 Trig functions?
1044
1045 =item How do I convert between numeric representations/bases/radixes?
1046
1047 How do I convert hexadecimal into decimal, How do I convert from decimal to
1048 hexadecimal, How do I convert from octal to decimal, How do I convert from
1049 decimal to octal, How do I convert from binary to decimal, How do I convert
1050 from decimal to binary
1051
1052 =item Why doesn't & work the way I want it to?
1053
1054 =item How do I multiply matrices?
1055
1056 =item How do I perform an operation on a series of integers?
1057
1058 =item How can I output Roman numerals?
1059
1060 =item Why aren't my random numbers random?
1061
1062 =item How do I get a random number between X and Y?
1063
1064 =back
1065
1066 =item Data: Dates
1067
1068 =over 4
1069
1070 =item How do I find the day or week of the year?
1071
1072 =item How do I find the current century or millennium?
1073
1074 =item How can I compare two dates and find the difference?
1075
1076 =item How can I take a string and turn it into epoch seconds?
1077
1078 =item How can I find the Julian Day?
1079
1080 =item How do I find yesterday's date?
1081
1082 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
1083
1084 =back
1085
1086 =item Data: Strings
1087
1088 =over 4
1089
1090 =item How do I validate input?
1091
1092 =item How do I unescape a string?
1093
1094 =item How do I remove consecutive pairs of characters?
1095
1096 =item How do I expand function calls in a string?
1097
1098 =item How do I find matching/nesting anything?
1099
1100 =item How do I reverse a string?
1101
1102 =item How do I expand tabs in a string?
1103
1104 =item How do I reformat a paragraph?
1105
1106 =item How can I access or change N characters of a string?
1107
1108 =item How do I change the Nth occurrence of something?
1109
1110 =item How can I count the number of occurrences of a substring within a
1111 string?
1112
1113 =item How do I capitalize all the words on one line?
1114
1115 =item How can I split a [character] delimited string except when inside
1116 [character]?
1117
1118 =item How do I strip blank space from the beginning/end of a string?
1119
1120 =item How do I pad a string with blanks or pad a number with zeroes?
1121
1122 =item How do I extract selected columns from a string?
1123
1124 =item How do I find the soundex value of a string?
1125
1126 =item How can I expand variables in text strings?
1127
1128 =item What's wrong with always quoting "$vars"?
1129
1130 =item Why don't my E<lt>E<lt>HERE documents work?
1131
1132 There must be no space after the E<lt>E<lt> part, There (probably) should
1133 be a semicolon at the end, You can't (easily) have any space in front of
1134 the tag
1135
1136 =back
1137
1138 =item Data: Arrays
1139
1140 =over 4
1141
1142 =item What is the difference between a list and an array?
1143
1144 =item What is the difference between $array[1] and @array[1]?
1145
1146 =item How can I remove duplicate elements from a list or array?
1147
1148 a), b), c), d), e)
1149
1150 =item How can I tell whether a certain element is contained in a list or
1151 array?
1152
1153 =item How do I compute the difference of two arrays?  How do I compute the
1154 intersection of two arrays?
1155
1156 =item How do I test whether two arrays or hashes are equal?
1157
1158 =item How do I find the first array element for which a condition is true?
1159
1160 =item How do I handle linked lists?
1161
1162 =item How do I handle circular lists?
1163
1164 =item How do I shuffle an array randomly?
1165
1166 =item How do I process/modify each element of an array?
1167
1168 =item How do I select a random element from an array?
1169
1170 =item How do I permute N elements of a list?
1171
1172 =item How do I sort an array by (anything)?
1173
1174 =item How do I manipulate arrays of bits?
1175
1176 =item Why does defined() return true on empty arrays and hashes?
1177
1178 =back
1179
1180 =item Data: Hashes (Associative Arrays)
1181
1182 =over 4
1183
1184 =item How do I process an entire hash?
1185
1186 =item What happens if I add or remove keys from a hash while iterating over
1187 it?
1188
1189 =item How do I look up a hash element by value?
1190
1191 =item How can I know how many entries are in a hash?
1192
1193 =item How do I sort a hash (optionally by value instead of key)?
1194
1195 =item How can I always keep my hash sorted?
1196
1197 =item What's the difference between "delete" and "undef" with hashes?
1198
1199 =item Why don't my tied hashes make the defined/exists distinction?
1200
1201 =item How do I reset an each() operation part-way through?
1202
1203 =item How can I get the unique keys from two hashes?
1204
1205 =item How can I store a multidimensional array in a DBM file?
1206
1207 =item How can I make my hash remember the order I put elements into it?
1208
1209 =item Why does passing a subroutine an undefined element in a hash create
1210 it?
1211
1212 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
1213 array of hashes or arrays?
1214
1215 =item How can I use a reference as a hash key?
1216
1217 =back
1218
1219 =item Data: Misc
1220
1221 =over 4
1222
1223 =item How do I handle binary data correctly?
1224
1225 =item How do I determine whether a scalar is a number/whole/integer/float?
1226
1227 =item How do I keep persistent data across program calls?
1228
1229 =item How do I print out or copy a recursive data structure?
1230
1231 =item How do I define methods for every class/object?
1232
1233 =item How do I verify a credit card checksum?
1234
1235 =item How do I pack arrays of doubles or floats for XS code?
1236
1237 =back
1238
1239 =item AUTHOR AND COPYRIGHT
1240
1241 =back
1242
1243 =head2 perlfaq5 - Files and Formats ($Revision: 1.30 $, $Date: 2003/11/23
1244 08:07:46 $)
1245
1246 =over 4
1247
1248 =item DESCRIPTION
1249
1250 =over 4
1251
1252 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
1253
1254 =item How do I change one line in a file/delete a line in a file/insert a
1255 line in the middle of a file/append to the beginning of a file?
1256
1257 =item How do I count the number of lines in a file?
1258
1259 =item How can I use Perl's C<-i> option from within a program?
1260
1261 =item How do I make a temporary file name?
1262
1263 =item How can I manipulate fixed-record-length files?
1264
1265 =item How can I make a filehandle local to a subroutine?  How do I pass
1266 filehandles between subroutines?  How do I make an array of filehandles?
1267
1268 =item How can I use a filehandle indirectly?
1269
1270 =item How can I set up a footer format to be used with write()?
1271
1272 =item How can I write() into a string?
1273
1274 =item How can I output my numbers with commas added?
1275
1276 =item How can I translate tildes (~) in a filename?
1277
1278 =item How come when I open a file read-write it wipes it out?
1279
1280 =item Why do I sometimes get an "Argument list too long" when I use
1281 E<lt>*E<gt>?
1282
1283 =item Is there a leak/bug in glob()?
1284
1285 =item How can I open a file with a leading ">" or trailing blanks?
1286
1287 =item How can I reliably rename a file?
1288
1289 =item How can I lock a file?
1290
1291 =item Why can't I just open(FH, "E<gt>file.lock")?
1292
1293 =item I still don't get locking.  I just want to increment the number in
1294 the file.  How can I do this?
1295
1296 =item All I want to do is append a small amount of text to the end of a
1297 file.  Do I still have to use locking?
1298
1299 =item How do I randomly update a binary file?
1300
1301 =item How do I get a file's timestamp in perl?
1302
1303 =item How do I set a file's timestamp in perl?
1304
1305 =item How do I print to more than one file at once?
1306
1307 =item How can I read in an entire file all at once?
1308
1309 =item How can I read in a file by paragraphs?
1310
1311 =item How can I read a single character from a file?  From the keyboard?
1312
1313 =item How can I tell whether there's a character waiting on a filehandle?
1314
1315 =item How do I do a C<tail -f> in perl?
1316
1317 =item How do I dup() a filehandle in Perl?
1318
1319 =item How do I close a file descriptor by number?
1320
1321 =item Why can't I use "C:\temp\foo" in DOS paths?  Why doesn't
1322 `C:\temp\foo.exe` work?
1323
1324 =item Why doesn't glob("*.*") get all the files?
1325
1326 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
1327 protected files?  Isn't this a bug in Perl?
1328
1329 =item How do I select a random line from a file?
1330
1331 =item Why do I get weird spaces when I print an array of lines?
1332
1333 =back
1334
1335 =item AUTHOR AND COPYRIGHT
1336
1337 =back
1338
1339 =head2 perlfaq6 - Regular Expressions ($Revision: 1.20 $, $Date: 2003/01/03
1340 20:05:28 $)
1341
1342 =over 4
1343
1344 =item DESCRIPTION
1345
1346 =over 4
1347
1348 =item How can I hope to use regular expressions without creating illegible
1349 and unmaintainable code?
1350
1351 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
1352
1353 =item I'm having trouble matching over more than one line.  What's wrong?
1354
1355 =item How can I pull out lines between two patterns that are themselves on
1356 different lines?
1357
1358 =item I put a regular expression into $/ but it didn't work. What's wrong?
1359
1360 =item How do I substitute case insensitively on the LHS while preserving
1361 case on the RHS?
1362
1363 =item How can I make C<\w> match national character sets?
1364
1365 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
1366
1367 =item How can I quote a variable to use in a regex?
1368
1369 =item What is C</o> really for?
1370
1371 =item How do I use a regular expression to strip C style comments from a
1372 file?
1373
1374 =item Can I use Perl regular expressions to match balanced text?
1375
1376 =item What does it mean that regexes are greedy?  How can I get around it?
1377
1378 =item How do I process each word on each line?
1379
1380 =item How can I print out a word-frequency or line-frequency summary?
1381
1382 =item How can I do approximate matching?
1383
1384 =item How do I efficiently match many regular expressions at once?
1385
1386 =item Why don't word-boundary searches with C<\b> work for me?
1387
1388 =item Why does using $&, $`, or $' slow my program down?
1389
1390 =item What good is C<\G> in a regular expression?
1391
1392 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
1393
1394 =item What's wrong with using grep in a void context?
1395
1396 =item How can I match strings with multibyte characters?
1397
1398 =item How do I match a pattern that is supplied by the user?
1399
1400 =back
1401
1402 =item AUTHOR AND COPYRIGHT
1403
1404 =back
1405
1406 =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.15 $, $Date:
1407 2003/07/24 02:17:21 $)
1408
1409 =over 4
1410
1411 =item DESCRIPTION
1412
1413 =over 4
1414
1415 =item Can I get a BNF/yacc/RE for the Perl language?
1416
1417 =item What are all these $@%&* punctuation signs, and how do I know when to
1418 use them?
1419
1420 =item Do I always/never have to quote my strings or use semicolons and
1421 commas?
1422
1423 =item How do I skip some return values?
1424
1425 =item How do I temporarily block warnings?
1426
1427 =item What's an extension?
1428
1429 =item Why do Perl operators have different precedence than C operators?
1430
1431 =item How do I declare/create a structure?
1432
1433 =item How do I create a module?
1434
1435 =item How do I create a class?
1436
1437 =item How can I tell if a variable is tainted?
1438
1439 =item What's a closure?
1440
1441 =item What is variable suicide and how can I prevent it?
1442
1443 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
1444 Regex}?
1445
1446 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
1447 Passing Methods
1448
1449 =item How do I create a static variable?
1450
1451 =item What's the difference between dynamic and lexical (static) scoping? 
1452 Between local() and my()?
1453
1454 =item How can I access a dynamic variable while a similarly named lexical
1455 is in scope?
1456
1457 =item What's the difference between deep and shallow binding?
1458
1459 =item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?
1460
1461 =item How do I redefine a builtin function, operator, or method?
1462
1463 =item What's the difference between calling a function as &foo and foo()?
1464
1465 =item How do I create a switch or case statement?
1466
1467 =item How can I catch accesses to undefined variables, functions, or
1468 methods?
1469
1470 =item Why can't a method included in this same file be found?
1471
1472 =item How can I find out my current package?
1473
1474 =item How can I comment out a large block of perl code?
1475
1476 =item How do I clear a package?
1477
1478 =item How can I use a variable as a variable name?
1479
1480 =item What does "bad interpreter" mean?
1481
1482 =back
1483
1484 =item AUTHOR AND COPYRIGHT
1485
1486 =back
1487
1488 =head2 perlfaq8 - System Interaction ($Revision: 1.17 $, $Date: 2003/01/26
1489 17:44:04 $)
1490
1491 =over 4
1492
1493 =item DESCRIPTION
1494
1495 =over 4
1496
1497 =item How do I find out which operating system I'm running under?
1498
1499 =item How come exec() doesn't return?
1500
1501 =item How do I do fancy stuff with the keyboard/screen/mouse?
1502
1503 Keyboard, Screen, Mouse
1504
1505 =item How do I print something out in color?
1506
1507 =item How do I read just one key without waiting for a return key?
1508
1509 =item How do I check whether input is ready on the keyboard?
1510
1511 =item How do I clear the screen?
1512
1513 =item How do I get the screen size?
1514
1515 =item How do I ask the user for a password?
1516
1517 =item How do I read and write the serial port?
1518
1519 lockfiles, open mode, end of line, flushing output, non-blocking input
1520
1521 =item How do I decode encrypted password files?
1522
1523 =item How do I start a process in the background?
1524
1525 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
1526
1527 =item How do I trap control characters/signals?
1528
1529 =item How do I modify the shadow password file on a Unix system?
1530
1531 =item How do I set the time and date?
1532
1533 =item How can I sleep() or alarm() for under a second?
1534
1535 =item How can I measure time under a second?
1536
1537 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
1538
1539 =item Why doesn't my sockets program work under System V (Solaris)?  What
1540 does the error message "Protocol not supported" mean?
1541
1542 =item How can I call my system's unique C functions from Perl?
1543
1544 =item Where do I get the include files to do ioctl() or syscall()?
1545
1546 =item Why do setuid perl scripts complain about kernel problems?
1547
1548 =item How can I open a pipe both to and from a command?
1549
1550 =item Why can't I get the output of a command with system()?
1551
1552 =item How can I capture STDERR from an external command?
1553
1554 =item Why doesn't open() return an error when a pipe open fails?
1555
1556 =item What's wrong with using backticks in a void context?
1557
1558 =item How can I call backticks without shell processing?
1559
1560 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
1561 ^Z on MS-DOS)?
1562
1563 =item How can I convert my shell script to perl?
1564
1565 =item Can I use perl to run a telnet or ftp session?
1566
1567 =item How can I write expect in Perl?
1568
1569 =item Is there a way to hide perl's command line from programs such as
1570 "ps"?
1571
1572 =item I {changed directory, modified my environment} in a perl script.  How
1573 come the change disappeared when I exited the script?  How do I get my
1574 changes to be visible?
1575
1576 Unix
1577
1578 =item How do I close a process's filehandle without waiting for it to
1579 complete?
1580
1581 =item How do I fork a daemon process?
1582
1583 =item How do I find out if I'm running interactively or not?
1584
1585 =item How do I timeout a slow event?
1586
1587 =item How do I set CPU limits?
1588
1589 =item How do I avoid zombies on a Unix system?
1590
1591 =item How do I use an SQL database?
1592
1593 =item How do I make a system() exit on control-C?
1594
1595 =item How do I open a file without blocking?
1596
1597 =item How do I install a module from CPAN?
1598
1599 =item What's the difference between require and use?
1600
1601 =item How do I keep my own module/library directory?
1602
1603 =item How do I add the directory my program lives in to the module/library
1604 search path?
1605
1606 =item How do I add a directory to my include path (@INC) at runtime?
1607
1608 =item What is socket.ph and where do I get it?
1609
1610 =back
1611
1612 =item AUTHOR AND COPYRIGHT
1613
1614 =back
1615
1616 =head2 perlfaq9 - Networking ($Revision: 1.15 $, $Date: 2003/01/31 17:36:57
1617 $)
1618
1619 =over 4
1620
1621 =item DESCRIPTION
1622
1623 =over 4
1624
1625 =item What is the correct form of response from a CGI script?
1626
1627 =item My CGI script runs from the command line but not the browser.  (500
1628 Server Error)
1629
1630 =item How can I get better error messages from a CGI program?
1631
1632 =item How do I remove HTML from a string?
1633
1634 =item How do I extract URLs?
1635
1636 =item How do I download a file from the user's machine?  How do I open a
1637 file on another machine?
1638
1639 =item How do I make a pop-up menu in HTML?
1640
1641 =item How do I fetch an HTML file?
1642
1643 =item How do I automate an HTML form submission?
1644
1645 =item How do I decode or create those %-encodings on the web?
1646
1647 =item How do I redirect to another page?
1648
1649 =item How do I put a password on my web pages?
1650
1651 =item How do I edit my .htpasswd and .htgroup files with Perl?
1652
1653 =item How do I make sure users can't enter values into a form that cause my
1654 CGI script to do bad things?
1655
1656 =item How do I parse a mail header?
1657
1658 =item How do I decode a CGI form?
1659
1660 =item How do I check a valid mail address?
1661
1662 =item How do I decode a MIME/BASE64 string?
1663
1664 =item How do I return the user's mail address?
1665
1666 =item How do I send mail?
1667
1668 =item How do I use MIME to make an attachment to a mail message?
1669
1670 =item How do I read mail?
1671
1672 =item How do I find out my hostname/domainname/IP address?
1673
1674 =item How do I fetch a news article or the active newsgroups?
1675
1676 =item How do I fetch/put an FTP file?
1677
1678 =item How can I do RPC in Perl?
1679
1680 =back
1681
1682 =item AUTHOR AND COPYRIGHT
1683
1684 =back
1685
1686 =head2 perlsyn - Perl syntax
1687
1688 =over 4
1689
1690 =item DESCRIPTION
1691
1692 =over 4
1693
1694 =item Declarations
1695
1696 =item Comments
1697
1698 =item Simple Statements
1699
1700 =item Truth and Falsehood
1701
1702 =item Statement Modifiers
1703
1704 =item Compound Statements
1705
1706 =item Loop Control
1707
1708 =item For Loops
1709
1710 =item Foreach Loops
1711
1712 =item Basic BLOCKs and Switch Statements
1713
1714 =item Goto
1715
1716 =item PODs: Embedded Documentation
1717
1718 =item Plain Old Comments (Not!)
1719
1720 =back
1721
1722 =back
1723
1724 =head2 perldata - Perl data types
1725
1726 =over 4
1727
1728 =item DESCRIPTION
1729
1730 =over 4
1731
1732 =item Variable names
1733
1734 =item Context
1735
1736 =item Scalar values
1737
1738 =item Scalar value constructors
1739
1740 =item List value constructors
1741
1742 =item Subscripts
1743
1744 =item Slices
1745
1746 =item Typeglobs and Filehandles
1747
1748 =back
1749
1750 =item SEE ALSO
1751
1752 =back
1753
1754 =head2 perlop - Perl operators and precedence
1755
1756 =over 4
1757
1758 =item DESCRIPTION
1759
1760 =over 4
1761
1762 =item Operator Precedence and Associativity
1763
1764 =item Terms and List Operators (Leftward)
1765
1766 =item The Arrow Operator
1767
1768 =item Auto-increment and Auto-decrement
1769
1770 =item Exponentiation
1771
1772 =item Symbolic Unary Operators
1773
1774 =item Binding Operators
1775
1776 =item Multiplicative Operators
1777
1778 =item Additive Operators
1779
1780 =item Shift Operators
1781
1782 =item Named Unary Operators
1783
1784 =item Relational Operators
1785
1786 =item Equality Operators
1787
1788 =item Bitwise And
1789
1790 =item Bitwise Or and Exclusive Or
1791
1792 =item C-style Logical And
1793
1794 =item C-style Logical Or
1795
1796 =item C-style Logical Defined-Or
1797
1798 =item Range Operators
1799
1800 =item Conditional Operator
1801
1802 =item Assignment Operators
1803
1804 =item Comma Operator
1805
1806 =item List Operators (Rightward)
1807
1808 =item Logical Not
1809
1810 =item Logical And
1811
1812 =item Logical or, Defined or, and Exclusive Or
1813
1814 =item C Operators Missing From Perl
1815
1816 unary &, unary *, (TYPE)
1817
1818 =item Quote and Quote-like Operators
1819
1820 =item Regexp Quote-Like Operators
1821
1822 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
1823 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
1824 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
1825 y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF
1826
1827 =item Gory details of parsing quoted constructs
1828
1829 Finding the end, Removal of backslashes before delimiters, Interpolation,
1830 C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
1831 C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>,
1832 C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
1833 regular expressions
1834
1835 =item I/O Operators
1836
1837 =item Constant Folding
1838
1839 =item Bitwise String Operators
1840
1841 =item Integer Arithmetic
1842
1843 =item Floating-point Arithmetic
1844
1845 =item Bigger Numbers
1846
1847 =back
1848
1849 =back
1850
1851 =head2 perlsub - Perl subroutines
1852
1853 =over 4
1854
1855 =item SYNOPSIS
1856
1857 =item DESCRIPTION
1858
1859 =over 4
1860
1861 =item Private Variables via my()
1862
1863 =item Persistent Private Variables
1864
1865 =item Temporary Values via local()
1866
1867 =item Lvalue subroutines
1868
1869 Lvalue subroutines are EXPERIMENTAL
1870
1871 =item Passing Symbol Table Entries (typeglobs)
1872
1873 =item When to Still Use local()
1874
1875 =item Pass by Reference
1876
1877 =item Prototypes
1878
1879 =item Constant Functions
1880
1881 =item Overriding Built-in Functions
1882
1883 =item Autoloading
1884
1885 =item Subroutine Attributes
1886
1887 =back
1888
1889 =item SEE ALSO
1890
1891 =back
1892
1893 =head2 perlfunc - Perl builtin functions
1894
1895 =over 4
1896
1897 =item DESCRIPTION
1898
1899 =over 4
1900
1901 =item Perl Functions by Category
1902
1903 Functions for SCALARs or strings, Regular expressions and pattern matching,
1904 Numeric functions, Functions for real @ARRAYs, Functions for list data,
1905 Functions for real %HASHes, Input and output functions, Functions for fixed
1906 length data or records, Functions for filehandles, files, or directories,
1907 Keywords related to the control flow of your perl program, Keywords related
1908 to scoping, Miscellaneous functions, Functions for processes and process
1909 groups, Keywords related to perl modules, Keywords related to classes and
1910 object-orientedness, Low-level socket functions, System V interprocess
1911 communication functions, Fetching user and group info, Fetching network
1912 info, Time-related functions, Functions new in perl5, Functions obsoleted
1913 in perl5
1914
1915 =item Portability
1916
1917 =item Alphabetical Listing of Perl Functions
1918
1919 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, abs VALUE, abs, accept
1920 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
1921 binmode FILEHANDLE, LAYER, binmode FILEHANDLE, bless REF,CLASSNAME, bless
1922 REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE, chomp(
1923 LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr NUMBER,
1924 chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE,
1925 connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT,
1926 dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete
1927 EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump,
1928 each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST,
1929 exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl
1930 FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION,
1931 fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin,
1932 getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam
1933 NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname
1934 NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr
1935 ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
1936 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
1937 getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent
1938 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
1939 endhostent, endnetent, endprotoent, endservent, getsockname SOCKET,
1940 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL,
1941 goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex,
1942 import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
1943 FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST,
1944 last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length,
1945 link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR,
1946 lock THING, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map
1947 EXPR,LIST, mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget
1948 KEY,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my
1949 TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL, next, no
1950 Module VERSION LIST, no Module VERSION, no Module LIST, no Module, oct
1951 EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open
1952 FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE,MODE,REFERENCE, open FILEHANDLE,
1953 opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR TYPE, our EXPR :
1954 ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST, package NAMESPACE,
1955 package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos,
1956 print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST,
1957 printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/,
1958 qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta,
1959 rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
1960 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
1961 readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
1962 ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR,
1963 require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir
1964 DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME,
1965 rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir
1966 DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT,
1967 semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
1968 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
1969 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
1970 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
1971 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
1972 EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
1973 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
1974 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
1975 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split
1976 /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, format
1977 parameter index, flags, vector flag, (minimum) width, precision, or maximum
1978 width, size, order of arguments, sqrt EXPR, sqrt, srand EXPR, srand, stat
1979 FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub NAME BLOCK, sub NAME
1980 (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK,
1981 substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
1982 EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall NUMBER, LIST, sysopen
1983 FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
1984 FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
1985 FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite
1986 FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH,
1987 syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie
1988 VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate
1989 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR,
1990 ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack
1991 TEMPLATE,EXPR, unpack TEMPLATE, untie VARIABLE, unshift ARRAY,LIST, use
1992 Module VERSION LIST, use Module VERSION, use Module LIST, use Module, use
1993 VERSION, utime LIST, values HASH, vec EXPR,OFFSET,BITS, wait, waitpid
1994 PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y///
1995
1996 =back
1997
1998 =back
1999
2000 =head2 perlopentut - tutorial on opening things in Perl
2001
2002 =over 4
2003
2004 =item DESCRIPTION
2005
2006 =item Open E<agrave> la shell
2007
2008 =over 4
2009
2010 =item Simple Opens
2011
2012 =item Indirect Filehandles
2013
2014 =item Pipe Opens
2015
2016 =item The Minus File
2017
2018 =item Mixing Reads and Writes
2019
2020 =item Filters 
2021
2022 =back
2023
2024 =item Open E<agrave> la C
2025
2026 =over 4
2027
2028 =item Permissions E<agrave> la mode
2029
2030 =back
2031
2032 =item Obscure Open Tricks
2033
2034 =over 4
2035
2036 =item Re-Opening Files (dups)
2037
2038 =item Dispelling the Dweomer
2039
2040 =item Paths as Opens
2041
2042 =item Single Argument Open
2043
2044 =item Playing with STDIN and STDOUT
2045
2046 =back
2047
2048 =item Other I/O Issues
2049
2050 =over 4
2051
2052 =item Opening Non-File Files
2053
2054 =item Opening Named Pipes
2055
2056 =item Opening Sockets
2057
2058 =item Binary Files
2059
2060 =item File Locking
2061
2062 =item IO Layers
2063
2064 =back
2065
2066 =item SEE ALSO 
2067
2068 =item AUTHOR and COPYRIGHT
2069
2070 =item HISTORY
2071
2072 =back
2073
2074 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
2075
2076 =over 4
2077
2078 =item DESCRIPTION
2079
2080 =item The Basic Principle
2081
2082 =item Packing Text
2083
2084 =item Packing Numbers
2085
2086 =over 4
2087
2088 =item Integers
2089
2090 =item Unpacking a Stack Frame
2091
2092 =item How to Eat an Egg on a Net
2093
2094 =item Floating point Numbers
2095
2096 =back
2097
2098 =item Exotic Templates
2099
2100 =over 4
2101
2102 =item Bit Strings
2103
2104 =item Uuencoding
2105
2106 =item Doing Sums
2107
2108 =item  Unicode
2109
2110 =item Another Portable Binary Encoding
2111
2112 =back
2113
2114 =item Template Grouping
2115
2116 =item Lengths and Widths
2117
2118 =over 4
2119
2120 =item String Lengths
2121
2122 =item Dynamic Templates
2123
2124 =item Counting Repetitions
2125
2126 =back
2127
2128 =item Packing and Unpacking C Structures
2129
2130 =over 4
2131
2132 =item The Alignment Pit
2133
2134 =item Alignment, Take 2
2135
2136 =item Alignment, Take 3
2137
2138 =item Pointers for How to Use Them
2139
2140 =back
2141
2142 =item Pack Recipes
2143
2144 =item Funnies Section
2145
2146 =item Authors
2147
2148 =back
2149
2150 =head2 perlpod - the Plain Old Documentation format
2151
2152 =over 4
2153
2154 =item DESCRIPTION
2155
2156 =over 4
2157
2158 =item Ordinary Paragraph
2159
2160 =item Verbatim Paragraph
2161
2162 =item Command Paragraph
2163
2164 C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
2165 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item
2166 I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end
2167 I<formatname>>, C<=for I<formatname> I<text...>>, C<=encoding
2168 I<encodingname>>
2169
2170 =item Formatting Codes
2171
2172 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2173 C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink,
2174 C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used
2175 for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces,
2176 C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null
2177 (zero-effect) formatting code
2178
2179 =item The Intent
2180
2181 =item Embedding Pods in Perl Modules
2182
2183 =item Hints for Writing Pod
2184
2185 =back
2186
2187 =item SEE ALSO
2188
2189 =item AUTHOR
2190
2191 =back
2192
2193 =head2 perlpodspec - Plain Old Documentation: format specification and
2194 notes
2195
2196 =over 4
2197
2198 =item DESCRIPTION
2199
2200 =item Pod Definitions
2201
2202 =item Pod Commands
2203
2204 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
2205 "=back", "=begin formatname", "=end formatname", "=for formatname text...",
2206 "=encoding encodingname"
2207
2208 =item Pod Formatting Codes
2209
2210 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2211 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
2212 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
2213 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
2214 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
2215 contains non-breaking spaces
2216
2217 =item Notes on Implementing Pod Processors
2218
2219 =item About LE<lt>...E<gt> Codes
2220
2221 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
2222
2223 =item About =over...=back Regions
2224
2225 =item About Data Paragraphs and "=begin/=end" Regions
2226
2227 =item SEE ALSO
2228
2229 =item AUTHOR
2230
2231 =back
2232
2233 =head2 perlrun - how to execute the Perl interpreter
2234
2235 =over 4
2236
2237 =item SYNOPSIS
2238
2239 =item DESCRIPTION
2240
2241 =over 4
2242
2243 =item #! and quoting on non-Unix systems
2244
2245 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
2246
2247 =item Location of Perl
2248
2249 =item Command Switches
2250
2251 B<-0>[I<octal/hexadecimal>], B<-A [I<assertions>]>, B<-a>, B<-C
2252 [I<number/list>]>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>, B<-D>I<letters>,
2253 B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>, B<-h>,
2254 B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
2255 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
2256 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
2257 B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>,
2258 B<-X>, B<-x> I<directory>
2259
2260 =back
2261
2262 =item ENVIRONMENT
2263
2264 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
2265 :perlio, :pop, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
2266 PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS,
2267 PERL_DESTRUCT_LEVEL, PERL_DL_NONLAZY, PERL_ENCODING, PERL_HASH_SEED,
2268 PERL_HASH_SEED_DEBUG, PERL_ROOT (specific to the VMS port), PERL_SIGNALS,
2269 PERL_UNICODE, SYS$LOGIN (specific to the VMS port)
2270
2271 =back
2272
2273 =head2 perldiag - various Perl diagnostics
2274
2275 =over 4
2276
2277 =item DESCRIPTION
2278
2279 =back
2280
2281 =head2 perllexwarn - Perl Lexical Warnings
2282
2283 =over 4
2284
2285 =item DESCRIPTION
2286
2287 =over 4
2288
2289 =item Default Warnings and Optional Warnings
2290
2291 =item What's wrong with B<-w> and C<$^W>
2292
2293 =item Controlling Warnings from the Command Line
2294
2295 B<-w>, B<-W>, B<-X>
2296
2297 =item Backward Compatibility
2298
2299 =item Category Hierarchy
2300
2301 =item Fatal Warnings
2302
2303 =item Reporting Warnings from a Module
2304
2305 =back
2306
2307 =item TODO
2308
2309 =item SEE ALSO
2310
2311 =item AUTHOR
2312
2313 =back
2314
2315 =head2 perldebug - Perl debugging
2316
2317 =over 4
2318
2319 =item DESCRIPTION
2320
2321 =item The Perl Debugger
2322
2323 =over 4
2324
2325 =item Debugger Commands
2326
2327 h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y
2328 [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l
2329 min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/,
2330 ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b
2331 subname [condition], b postpone subname [condition], b load filename, b
2332 compile subname, B line, B *, a [line] command, A line, A *, w expr, W
2333 expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [
2334 command ], < *, << command, > ?, > command, > *, >> command, { ?, { [
2335 command ], { *, {{ command, ! number, ! -number, ! pattern, !! cmd, source
2336 file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man
2337 [manpage]
2338
2339 =item Configurable Options
2340
2341 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
2342 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
2343 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
2344 C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
2345 C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
2346 C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
2347 C<NonStop>
2348
2349 =item Debugger input/output
2350
2351 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
2352 listing
2353
2354 =item Debugging compile-time statements
2355
2356 =item Debugger Customization
2357
2358 =item Readline Support
2359
2360 =item Editor Support for Debugging
2361
2362 =item The Perl Profiler
2363
2364 =back
2365
2366 =item Debugging regular expressions
2367
2368 =item Debugging memory usage
2369
2370 =item SEE ALSO
2371
2372 =item BUGS
2373
2374 =back
2375
2376 =head2 perlvar - Perl predefined variables
2377
2378 =over 4
2379
2380 =item DESCRIPTION
2381
2382 =over 4
2383
2384 =item Predefined Names
2385
2386 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
2387 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+,
2388 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
2389 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
2390 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
2391 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
2392 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
2393 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $#,
2394 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
2395 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
2396 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
2397 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
2398 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
2399 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
2400 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
2401 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
2402 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
2403 IO::Handle->format_line_break_characters EXPR,
2404 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
2405 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
2406 $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
2407 $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
2408 $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
2409 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
2410 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
2411 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
2412 0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R,
2413 $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, ${^UNICODE},
2414 $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, $EXECUTABLE_NAME, $^X,
2415 ARGV, $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG,
2416 $SIG{expr}
2417
2418 =item Error Indicators
2419
2420 =item Technical Note on the Syntax of Variable Names
2421
2422 =back
2423
2424 =item BUGS
2425
2426 =back
2427
2428 =head2 perlre - Perl regular expressions
2429
2430 =over 4
2431
2432 =item DESCRIPTION
2433
2434 i, m, s, x
2435
2436 =over 4
2437
2438 =item Regular Expressions
2439
2440 [1], [2], [3], cntrl, graph, print, punct, xdigit
2441
2442 =item Extended Patterns
2443
2444 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
2445 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
2446 code })>, C<(??{ code })>, C<< (?>pattern) >>,
2447 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
2448
2449 =item Backtracking
2450
2451 =item Version 8 Regular Expressions
2452
2453 =item Warning on \1 vs $1
2454
2455 =item Repeated patterns matching zero-length substring
2456
2457 =item Combining pieces together
2458
2459 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
2460 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
2461 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
2462 C<(?(condition)yes-pattern|no-pattern)>
2463
2464 =item Creating custom RE engines
2465
2466 =back
2467
2468 =item BUGS
2469
2470 =item SEE ALSO
2471
2472 =back
2473
2474 =head2 perlreref - Perl Regular Expressions Reference
2475
2476 =over 4
2477
2478 =item DESCRIPTION
2479
2480 =over 4
2481
2482 =item OPERATORS
2483
2484 =item SYNTAX
2485
2486 =item ESCAPE SEQUENCES
2487
2488 =item CHARACTER CLASSES
2489
2490 =item ANCHORS
2491
2492 =item QUANTIFIERS
2493
2494 =item EXTENDED CONSTRUCTS
2495
2496 =item VARIABLES
2497
2498 =item FUNCTIONS
2499
2500 =item TERMINOLOGY
2501
2502 =back
2503
2504 =item AUTHOR
2505
2506 =item SEE ALSO
2507
2508 =item THANKS
2509
2510 =back
2511
2512 =head2 perlref - Perl references and nested data structures
2513
2514 =over 4
2515
2516 =item NOTE
2517
2518 =item DESCRIPTION
2519
2520 =over 4
2521
2522 =item Making References
2523
2524 =item Using References
2525
2526 =item Symbolic references
2527
2528 =item Not-so-symbolic references
2529
2530 =item Pseudo-hashes: Using an array as a hash
2531
2532 =item Function Templates
2533
2534 =back
2535
2536 =item WARNING
2537
2538 =item SEE ALSO
2539
2540 =back
2541
2542 =head2 perlform - Perl formats
2543
2544 =over 4
2545
2546 =item DESCRIPTION
2547
2548 =over 4
2549
2550 =item Text Fields
2551
2552 =item Numeric Fields
2553
2554 =item The Field @* for Variable Width Multi-Line Text
2555
2556 =item The Field ^* for Variable Width One-line-at-a-time Text
2557
2558 =item Specifying Values
2559
2560 =item Using Fill Mode
2561
2562 =item Suppressing Lines Where All Fields Are Void
2563
2564 =item Repeating Format Lines
2565
2566 =item Top of Form Processing
2567
2568 =item Format Variables
2569
2570 =back
2571
2572 =item NOTES
2573
2574 =over 4
2575
2576 =item Footers
2577
2578 =item Accessing Formatting Internals
2579
2580 =back
2581
2582 =item WARNINGS
2583
2584 =back
2585
2586 =head2 perlobj - Perl objects
2587
2588 =over 4
2589
2590 =item DESCRIPTION
2591
2592 =over 4
2593
2594 =item An Object is Simply a Reference
2595
2596 =item A Class is Simply a Package
2597
2598 =item A Method is Simply a Subroutine
2599
2600 =item Method Invocation
2601
2602 =item Indirect Object Syntax
2603
2604 =item Default UNIVERSAL methods
2605
2606 isa(CLASS), can(METHOD), VERSION( [NEED] )
2607
2608 =item Destructors
2609
2610 =item Summary
2611
2612 =item Two-Phased Garbage Collection
2613
2614 =back
2615
2616 =item SEE ALSO
2617
2618 =back
2619
2620 =head2 perltie - how to hide an object class in a simple variable
2621
2622 =over 4
2623
2624 =item SYNOPSIS
2625
2626 =item DESCRIPTION
2627
2628 =over 4
2629
2630 =item Tying Scalars
2631
2632 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
2633 DESTROY this
2634
2635 =item Tying Arrays
2636
2637 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
2638 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
2639 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
2640 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
2641 this
2642
2643 =item Tying Hashes
2644
2645 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
2646 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
2647 this, NEXTKEY this, lastkey, SCALAR this, UNTIE this, DESTROY this
2648
2649 =item Tying FileHandles
2650
2651 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
2652 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
2653 DESTROY this
2654
2655 =item UNTIE this
2656
2657 =item The C<untie> Gotcha
2658
2659 =back
2660
2661 =item SEE ALSO
2662
2663 =item BUGS
2664
2665 =item AUTHOR
2666
2667 =back
2668
2669 =head2 perldbmfilter - Perl DBM Filters
2670
2671 =over 4
2672
2673 =item SYNOPSIS
2674
2675 =item DESCRIPTION
2676
2677 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
2678 B<filter_fetch_value>
2679
2680 =over 4
2681
2682 =item The Filter
2683
2684 =item An Example -- the NULL termination problem.
2685
2686 =item Another Example -- Key is a C int.
2687
2688 =back
2689
2690 =item SEE ALSO
2691
2692 =item AUTHOR
2693
2694 =back
2695
2696 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
2697 safe subprocesses, sockets, and semaphores)
2698
2699 =over 4
2700
2701 =item DESCRIPTION
2702
2703 =item Signals
2704
2705 =over 4
2706
2707 =item Handling the SIGHUP Signal in Daemons
2708
2709 =back
2710
2711 =item Named Pipes
2712
2713 =over 4
2714
2715 =item Deferred Signals (Safe Signals)
2716
2717 Long running opcodes, Interrupting IO, Restartable system calls, Signals as
2718 "faults", Signals triggered by operating system state
2719
2720 =back
2721
2722 =item Using open() for IPC
2723
2724 =over 4
2725
2726 =item Filehandles
2727
2728 =item Background Processes
2729
2730 =item Complete Dissociation of Child from Parent
2731
2732 =item Safe Pipe Opens
2733
2734 =item Bidirectional Communication with Another Process
2735
2736 =item Bidirectional Communication with Yourself
2737
2738 =back
2739
2740 =item Sockets: Client/Server Communication
2741
2742 =over 4
2743
2744 =item Internet Line Terminators
2745
2746 =item Internet TCP Clients and Servers
2747
2748 =item Unix-Domain TCP Clients and Servers
2749
2750 =back
2751
2752 =item TCP Clients with IO::Socket
2753
2754 =over 4
2755
2756 =item A Simple Client
2757
2758 C<Proto>, C<PeerAddr>, C<PeerPort>
2759
2760 =item A Webget Client
2761
2762 =item Interactive Client with IO::Socket
2763
2764 =back
2765
2766 =item TCP Servers with IO::Socket
2767
2768 Proto, LocalPort, Listen, Reuse
2769
2770 =item UDP: Message Passing
2771
2772 =item SysV IPC
2773
2774 =item NOTES
2775
2776 =item BUGS
2777
2778 =item AUTHOR
2779
2780 =item SEE ALSO
2781
2782 =back
2783
2784 =head2 perlfork - Perl's fork() emulation
2785
2786 =over 4
2787
2788 =item SYNOPSIS
2789
2790 =item DESCRIPTION
2791
2792 =over 4
2793
2794 =item Behavior of other Perl features in forked pseudo-processes
2795
2796 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
2797 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
2798 files, directories and network sockets
2799
2800 =item Resource limits
2801
2802 =item Killing the parent process
2803
2804 =item Lifetime of the parent process and pseudo-processes
2805
2806 =item CAVEATS AND LIMITATIONS
2807
2808 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
2809 Global state maintained by XSUBs, Interpreter embedded in larger
2810 application, Thread-safety of extensions
2811
2812 =back
2813
2814 =item BUGS
2815
2816 =item AUTHOR
2817
2818 =item SEE ALSO
2819
2820 =back
2821
2822 =head2 perlnumber - semantics of numbers and numeric operations in Perl
2823
2824 =over 4
2825
2826 =item SYNOPSIS
2827
2828 =item DESCRIPTION
2829
2830 =item Storing numbers
2831
2832 =item Numeric operators and numeric conversions
2833
2834 =item Flavors of Perl numeric operations
2835
2836 Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other
2837 mathematical operators, Bitwise operators, Bitwise operators during C<use
2838 integer>, Operators which expect an integer, Operators which expect a
2839 string
2840
2841 =item AUTHOR
2842
2843 =item SEE ALSO
2844
2845 =back
2846
2847 =head2 perlthrtut - tutorial on threads in Perl
2848
2849 =over 4
2850
2851 =item DESCRIPTION
2852
2853 =item Status
2854
2855 =item What Is A Thread Anyway?
2856
2857 =item Threaded Program Models
2858
2859 =over 4
2860
2861 =item Boss/Worker
2862
2863 =item Work Crew
2864
2865 =item Pipeline
2866
2867 =back
2868
2869 =item What kind of threads are Perl threads?
2870
2871 =item Thread-Safe Modules
2872
2873 =item Thread Basics
2874
2875 =over 4
2876
2877 =item Basic Thread Support
2878
2879 =item A Note about the Examples
2880
2881 =item Creating Threads
2882
2883 =item Waiting For A Thread To Exit
2884
2885 =item Ignoring A Thread
2886
2887 =back
2888
2889 =item Threads And Data
2890
2891 =over 4
2892
2893 =item Shared And Unshared Data
2894
2895 =item Thread Pitfalls: Races
2896
2897 =back
2898
2899 =item Synchronization and control
2900
2901 =over 4
2902
2903 =item Controlling access: lock()
2904
2905 =item A Thread Pitfall: Deadlocks
2906
2907 =item Queues: Passing Data Around
2908
2909 =item Semaphores: Synchronizing Data Access
2910
2911 =item Basic semaphores
2912
2913 =item Advanced Semaphores
2914
2915 =item cond_wait() and cond_signal()
2916
2917 =item Giving up control
2918
2919 =back
2920
2921 =item General Thread Utility Routines
2922
2923 =over 4
2924
2925 =item What Thread Am I In?
2926
2927 =item Thread IDs
2928
2929 =item Are These Threads The Same?
2930
2931 =item What Threads Are Running?
2932
2933 =back
2934
2935 =item A Complete Example
2936
2937 =item Different implementations of threads
2938
2939 =item Performance considerations
2940
2941 =item Process-scope Changes
2942
2943 =item Thread-Safety of System Libraries
2944
2945 =item Conclusion
2946
2947 =item Bibliography
2948
2949 =over 4
2950
2951 =item Introductory Texts
2952
2953 =item OS-Related References
2954
2955 =item Other References
2956
2957 =back
2958
2959 =item Acknowledgements
2960
2961 =item AUTHOR
2962
2963 =item Copyrights
2964
2965 =back
2966
2967 =head2 perlothrtut - old tutorial on threads in Perl
2968
2969 =over 4
2970
2971 =item DESCRIPTION
2972
2973 =item What Is A Thread Anyway?
2974
2975 =item Threaded Program Models
2976
2977 =over 4
2978
2979 =item Boss/Worker
2980
2981 =item Work Crew
2982
2983 =item Pipeline
2984
2985 =back
2986
2987 =item Native threads
2988
2989 =item What kind of threads are perl threads?
2990
2991 =item Threadsafe Modules
2992
2993 =item Thread Basics
2994
2995 =over 4
2996
2997 =item Basic Thread Support
2998
2999 =item Creating Threads
3000
3001 =item Giving up control
3002
3003 =item Waiting For A Thread To Exit
3004
3005 =item Errors In Threads
3006
3007 =item Ignoring A Thread
3008
3009 =back
3010
3011 =item Threads And Data
3012
3013 =over 4
3014
3015 =item Shared And Unshared Data
3016
3017 =item Thread Pitfall: Races
3018
3019 =item Controlling access: lock()
3020
3021 =item Thread Pitfall: Deadlocks
3022
3023 =item Queues: Passing Data Around
3024
3025 =back
3026
3027 =item Threads And Code
3028
3029 =over 4
3030
3031 =item Semaphores: Synchronizing Data Access
3032
3033 Basic semaphores, Advanced Semaphores
3034
3035 =item Attributes: Restricting Access To Subroutines
3036
3037 =item Subroutine Locks
3038
3039 =item Methods
3040
3041 =item Locking A Subroutine
3042
3043 =back
3044
3045 =item General Thread Utility Routines
3046
3047 =over 4
3048
3049 =item What Thread Am I In?
3050
3051 =item Thread IDs
3052
3053 =item Are These Threads The Same?
3054
3055 =item What Threads Are Running?
3056
3057 =back
3058
3059 =item A Complete Example
3060
3061 =item Conclusion
3062
3063 =item Bibliography
3064
3065 =over 4
3066
3067 =item Introductory Texts
3068
3069 =item OS-Related References
3070
3071 =item Other References
3072
3073 =back
3074
3075 =item Acknowledgements
3076
3077 =item AUTHOR
3078
3079 =item Copyrights
3080
3081 =back
3082
3083 =head2 perlport - Writing portable Perl
3084
3085 =over 4
3086
3087 =item DESCRIPTION
3088
3089 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
3090 portable
3091
3092 =item ISSUES
3093
3094 =over 4
3095
3096 =item Newlines
3097
3098 =item Numbers endianness and Width
3099
3100 =item Files and Filesystems
3101
3102 =item System Interaction
3103
3104 =item Command names versus file pathnames
3105
3106 =item Networking
3107
3108 =item Interprocess Communication (IPC)
3109
3110 =item External Subroutines (XS)
3111
3112 =item Standard Modules
3113
3114 =item Time and Date
3115
3116 =item Character sets and character encoding
3117
3118 =item Internationalisation
3119
3120 =item System Resources
3121
3122 =item Security
3123
3124 =item Style
3125
3126 =back
3127
3128 =item CPAN Testers
3129
3130 Mailing list: cpan-testers@perl.org, Testing results:
3131 http://testers.cpan.org/
3132
3133 =item PLATFORMS
3134
3135 =over 4
3136
3137 =item Unix
3138
3139 =item DOS and Derivatives
3140
3141 =item S<Mac OS>
3142
3143 =item VMS
3144
3145 =item VOS
3146
3147 =item EBCDIC Platforms
3148
3149 =item Acorn RISC OS
3150
3151 =item Other perls
3152
3153 =back
3154
3155 =item FUNCTION IMPLEMENTATIONS
3156
3157 =over 4
3158
3159 =item Alphabetical Listing of Perl Functions
3160
3161 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, binmode FILEHANDLE, chmod LIST, chown
3162 LIST, chroot FILENAME, chroot, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen
3163 HASH,DBNAME,MODE, dump LABEL, exec LIST, exit EXPR, exit, fcntl
3164 FILEHANDLE,FUNCTION,SCALAR, flock FILEHANDLE,OPERATION, fork, getlogin,
3165 getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME,
3166 getnetbyname NAME, getpwuid UID, getgrgid GID, getnetbyaddr ADDR,ADDRTYPE,
3167 getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, getgrent,
3168 gethostbyname, gethostent, getnetent, getprotoent, getservent, sethostent
3169 STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN,
3170 endpwent, endgrent, endhostent, endnetent, endprotoent, endservent,
3171 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl
3172 FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat
3173 FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd
3174 ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open
3175 FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select
3176 RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
3177 KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
3178 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
3179 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
3180 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
3181 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
3182 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
3183 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
3184 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
3185 wait, waitpid PID,FLAGS
3186
3187 =back
3188
3189 =item CHANGES
3190
3191 v1.49, 12 August 2002, v1.48, 02 February 2001, v1.47, 22 March 2000,
3192 v1.46, 12 February 2000, v1.45, 20 December 1999, v1.44, 19 July 1999,
3193 v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May 1999, v1.40, 11 April
3194 1999, v1.39, 11 February 1999, v1.38, 31 December 1998, v1.37, 19 December
3195 1998, v1.36, 9 September 1998, v1.35, 13 August 1998, v1.33, 06 August
3196 1998, v1.32, 05 August 1998, v1.30, 03 August 1998, v1.23, 10 July 1998
3197
3198 =item Supported Platforms
3199
3200 =item SEE ALSO
3201
3202 =item AUTHORS / CONTRIBUTORS
3203
3204 =back
3205
3206 =head2 perllocale - Perl locale handling (internationalization and
3207 localization)
3208
3209 =over 4
3210
3211 =item DESCRIPTION
3212
3213 =item PREPARING TO USE LOCALES
3214
3215 =item USING LOCALES
3216
3217 =over 4
3218
3219 =item The use locale pragma
3220
3221 =item The setlocale function
3222
3223 =item Finding locales
3224
3225 =item LOCALE PROBLEMS
3226
3227 =item Temporarily fixing locale problems
3228
3229 =item Permanently fixing locale problems
3230
3231 =item Permanently fixing your system's locale configuration
3232
3233 =item Fixing system locale configuration
3234
3235 =item The localeconv function
3236
3237 =item I18N::Langinfo
3238
3239 =back
3240
3241 =item LOCALE CATEGORIES
3242
3243 =over 4
3244
3245 =item Category LC_COLLATE: Collation
3246
3247 =item Category LC_CTYPE: Character Types
3248
3249 =item Category LC_NUMERIC: Numeric Formatting
3250
3251 =item Category LC_MONETARY: Formatting of monetary amounts
3252
3253 =item LC_TIME
3254
3255 =item Other categories
3256
3257 =back
3258
3259 =item SECURITY
3260
3261 =item ENVIRONMENT
3262
3263 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
3264 LC_NUMERIC, LC_TIME, LANG
3265
3266 =item NOTES
3267
3268 =over 4
3269
3270 =item Backward compatibility
3271
3272 =item I18N:Collate obsolete
3273
3274 =item Sort speed and memory use impacts
3275
3276 =item write() and LC_NUMERIC
3277
3278 =item Freely available locale definitions
3279
3280 =item I18n and l10n
3281
3282 =item An imperfect standard
3283
3284 =back
3285
3286 =item Unicode and UTF-8
3287
3288 =item BUGS
3289
3290 =over 4
3291
3292 =item Broken systems
3293
3294 =back
3295
3296 =item SEE ALSO
3297
3298 =item HISTORY
3299
3300 =back
3301
3302 =head2 perluniintro - Perl Unicode introduction
3303
3304 =over 4
3305
3306 =item DESCRIPTION
3307
3308 =over 4
3309
3310 =item Unicode
3311
3312 =item Perl's Unicode Support
3313
3314 =item Perl's Unicode Model
3315
3316 =item Unicode and EBCDIC
3317
3318 =item Creating Unicode
3319
3320 =item Handling Unicode
3321
3322 =item Legacy Encodings
3323
3324 =item Unicode I/O
3325
3326 =item Displaying Unicode As Text
3327
3328 =item Special Cases
3329
3330 =item Advanced Topics
3331
3332 =item Miscellaneous
3333
3334 =item Questions With Answers
3335
3336 =item Hexadecimal Notation
3337
3338 =item Further Resources
3339
3340 =back
3341
3342 =item UNICODE IN OLDER PERLS
3343
3344 =item SEE ALSO
3345
3346 =item ACKNOWLEDGMENTS
3347
3348 =item AUTHOR, COPYRIGHT, AND LICENSE
3349
3350 =back
3351
3352 =head2 perlunicode - Unicode support in Perl
3353
3354 =over 4
3355
3356 =item DESCRIPTION
3357
3358 =over 4
3359
3360 =item Important Caveats
3361
3362 Input and Output Layers, Regular Expressions, C<use utf8> still needed to
3363 enable UTF-8/UTF-EBCDIC in scripts, C<use encoding> needed to upgrade
3364 non-Latin-1 byte strings
3365
3366 =item Byte and Character Semantics
3367
3368 =item Effects of Character Semantics
3369
3370 =item Scripts
3371
3372 =item Blocks
3373
3374 =item User-Defined Character Properties
3375
3376 =item Character Encodings for Input and Output
3377
3378 =item Unicode Regular Expression Support Level
3379
3380 =item Unicode Encodings
3381
3382 =item Security Implications of Unicode
3383
3384 =item Unicode in Perl on EBCDIC
3385
3386 =item Locales
3387
3388 =item When Unicode Does Not Happen
3389
3390 =item Forcing Unicode in Perl (Or Unforcing Unicode in Perl)
3391
3392 =item Using Unicode in XS
3393
3394 =back
3395
3396 =item BUGS
3397
3398 =over 4
3399
3400 =item Interaction with Locales
3401
3402 =item Interaction with Extensions
3403
3404 =item Speed
3405
3406 =item Porting code from perl-5.6.X
3407
3408 =back
3409
3410 =item SEE ALSO
3411
3412 =back
3413
3414 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
3415
3416 =over 4
3417
3418 =item DESCRIPTION
3419
3420 =item COMMON CHARACTER CODE SETS
3421
3422 =over 4
3423
3424 =item ASCII
3425
3426 =item ISO 8859
3427
3428 =item Latin 1 (ISO 8859-1)
3429
3430 =item EBCDIC
3431
3432 =item 13 variant characters
3433
3434 =item 0037
3435
3436 =item 1047
3437
3438 =item POSIX-BC
3439
3440 =item Unicode code points versus EBCDIC code points
3441
3442 =item Remaining Perl Unicode problems in EBCDIC
3443
3444 =item Unicode and UTF
3445
3446 =item Using Encode
3447
3448 =back
3449
3450 =item SINGLE OCTET TABLES
3451
3452 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
3453
3454 =item IDENTIFYING CHARACTER CODE SETS
3455
3456 =item CONVERSIONS
3457
3458 =over 4
3459
3460 =item tr///
3461
3462 =item iconv
3463
3464 =item C RTL
3465
3466 =back
3467
3468 =item OPERATOR DIFFERENCES
3469
3470 =item FUNCTION DIFFERENCES
3471
3472 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
3473
3474 =item REGULAR EXPRESSION DIFFERENCES
3475
3476 =item SOCKETS
3477
3478 =item SORTING
3479
3480 =over 4
3481
3482 =item Ignore ASCII vs. EBCDIC sort differences.
3483
3484 =item MONO CASE then sort data.
3485
3486 =item Convert, sort data, then re convert.
3487
3488 =item Perform sorting on one type of machine only.
3489
3490 =back
3491
3492 =item TRANSFORMATION FORMATS
3493
3494 =over 4
3495
3496 =item URL decoding and encoding
3497
3498 =item uu encoding and decoding
3499
3500 =item Quoted-Printable encoding and decoding
3501
3502 =item Caesarian ciphers
3503
3504 =back
3505
3506 =item Hashing order and checksums
3507
3508 =item I18N AND L10N
3509
3510 =item MULTI OCTET CHARACTER SETS
3511
3512 =item OS ISSUES
3513
3514 =over 4
3515
3516 =item OS/400
3517
3518 PASE, IFS access
3519
3520 =item OS/390, z/OS
3521
3522 chcp, dataset access, OS/390, z/OS iconv, locales
3523
3524 =item VM/ESA?
3525
3526 =item POSIX-BC?
3527
3528 =back
3529
3530 =item BUGS
3531
3532 =item SEE ALSO
3533
3534 =item REFERENCES
3535
3536 =item HISTORY
3537
3538 =item AUTHOR
3539
3540 =back
3541
3542 =head2 perlsec - Perl security
3543
3544 =over 4
3545
3546 =item DESCRIPTION
3547
3548 =over 4
3549
3550 =item Laundering and Detecting Tainted Data
3551
3552 =item Switches On the "#!" Line
3553
3554 =item Taint mode and @INC
3555
3556 =item Cleaning Up Your Path
3557
3558 =item Security Bugs
3559
3560 =item Protecting Your Programs
3561
3562 =item Unicode
3563
3564 =item Algorithmic Complexity Attacks
3565
3566 =back
3567
3568 =item SEE ALSO
3569
3570 =back
3571
3572 =head2 perlmod - Perl modules (packages and symbol tables)
3573
3574 =over 4
3575
3576 =item DESCRIPTION
3577
3578 =over 4
3579
3580 =item Packages
3581
3582 =item Symbol Tables
3583
3584 =item BEGIN, CHECK, INIT and END
3585
3586 =item Perl Classes
3587
3588 =item Perl Modules
3589
3590 =item Making your module threadsafe
3591
3592 =back
3593
3594 =item SEE ALSO
3595
3596 =back
3597
3598 =head2 perlmodlib - constructing new Perl modules and finding existing ones
3599
3600 =over 4
3601
3602 =item THE PERL MODULE LIBRARY
3603
3604 =over 4
3605
3606 =item Pragmatic Modules
3607
3608 assertions, assertions::activate, attributes, attrs, autouse, base, bigint,
3609 bignum, bigrat, blib, bytes, charnames, constant, diagnostics, encoding,
3610 fields, filetest, if, integer, less, lib, locale, open, ops, overload, re,
3611 sigtrap, sort, strict, subs, threads, threads::shared, utf8, vars, version,
3612 vmsish, warnings, warnings::register
3613
3614 =item Standard Modules
3615
3616 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
3617 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
3618 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
3619 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
3620 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
3621 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
3622 Class::Struct, Config, Cwd, DB, DBM_Filter, DB_File, Data::Dumper,
3623 Devel::DProf, Devel::PPPort, Devel::Peek, Devel::SelfStubber, Digest,
3624 Digest::MD5, Digest::base, DirHandle, Dumpvalue, DynaLoader, Encode,
3625 Encode::Alias, Encode::Byte, Encode::CJKConstants, Encode::CN,
3626 Encode::CN::HZ, Encode::Config, Encode::EBCDIC, Encode::Encoder,
3627 Encode::Encoding, Encode::Guess, Encode::JP, Encode::JP::H2Z,
3628 Encode::JP::JIS7, Encode::KR, Encode::KR::2022_KR, Encode::MIME::Header,
3629 Encode::PerlIO, Encode::Supported, Encode::Symbol, Encode::TW,
3630 Encode::Unicode, Encode::Unicode::UTF7, English, Env, Errno, Exporter,
3631 Exporter::Heavy, ExtUtils::Command, ExtUtils::Command::MM,
3632 ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install,
3633 ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_Any,
3634 ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS,
3635 ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_UWIN,
3636 ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
3637 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker,
3638 ExtUtils::MakeMaker::FAQ, ExtUtils::MakeMaker::Tutorial,
3639 ExtUtils::MakeMaker::bytes, ExtUtils::MakeMaker::vmsish,
3640 ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists,
3641 ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename,
3642 File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find,
3643 File::Glob, File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc,
3644 File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix,
3645 File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache,
3646 FileHandle, Filter::Simple, Filter::Util::Call, FindBin, GDBM_File,
3647 Getopt::Long, Getopt::Std, Hash::Util, I18N::Collate, I18N::LangTags,
3648 I18N::LangTags::List, I18N::Langinfo, IO, IO::Dir, IO::File, IO::Handle,
3649 IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET,
3650 IO::Socket::UNIX, IPC::Open2, IPC::Open3, IPC::SysV, IPC::SysV::Msg,
3651 IPC::SysV::Semaphore, List::Util, Locale::Constants, Locale::Country,
3652 Locale::Currency, Locale::Language, Locale::Maketext,
3653 Locale::Maketext::TPJ13, Locale::Script, MIME::Base64,
3654 MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt,
3655 Math::BigInt::Calc, Math::BigInt::CalcEmu, Math::BigRat, Math::Complex,
3656 Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire,
3657 Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File,
3658 Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT, Net::Cmd,
3659 Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3,
3660 Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent,
3661 Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO,
3662 PerlIO::encoding, PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint,
3663 Pod::Checker, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects,
3664 Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser,
3665 Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff,
3666 Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText,
3667 Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer,
3668 Pod::Select, Pod::Text, Pod::Text::Color, Pod::Text::Overstrike,
3669 Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Scalar::Util,
3670 Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch,
3671 Symbol, Sys::Hostname, Sys::Syslog, Term::ANSIColor, Term::Cap,
3672 Term::Complete, Term::ReadLine, Test, Test::Builder, Test::Harness,
3673 Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Straps,
3674 Test::More, Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced,
3675 Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Thread,
3676 Thread::Queue, Thread::Semaphore, Thread::Signal, Thread::Specific,
3677 Tie::Array, Tie::File, Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash,
3678 Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::gmtime,
3679 Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate, Unicode::Normalize,
3680 Unicode::UCD, User::grent, User::pwent, Win32, XS::APItest, XS::Typemap,
3681 XSLoader
3682
3683 =item Extension Modules
3684
3685 =back
3686
3687 =item CPAN
3688
3689 =over 4
3690
3691 =item Africa
3692
3693 South Africa
3694
3695 =item Asia
3696
3697 China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi
3698 Arabia, Singapore, South Korea, Taiwan, Thailand
3699
3700 =item Central America
3701
3702 Costa Rica
3703
3704 =item Europe
3705
3706 Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Czech
3707 Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary,
3708 Iceland, Ireland, Italy, Latvia, Lithuania, Netherlands, Norway, Poland,
3709 Portugal, Romania, Russia, Slovakia, Slovenia, Spain, Sweden, Switzerland,
3710 Turkey, Ukraine, United Kingdom
3711
3712 =item North America
3713
3714 Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States,
3715 Alabama, California, Colorado, Delaware, District of Columbia, Florida,
3716 Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey, New York,
3717 North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, Utah,
3718 Virginia, Washington, Wisconsin
3719
3720 =item Oceania
3721
3722 Australia, New Zealand, United States
3723
3724 =item South America
3725
3726 Argentina, Brazil, Chile
3727
3728 =item RSYNC Mirrors
3729
3730 =back
3731
3732 =item Modules: Creation, Use, and Abuse
3733
3734 =over 4
3735
3736 =item Guidelines for Module Creation
3737
3738 =item Guidelines for Converting Perl 4 Library Scripts into Modules
3739
3740 =item Guidelines for Reusing Application Code
3741
3742 =back
3743
3744 =item NOTE
3745
3746 =back
3747
3748 =head2 perlmodstyle - Perl module style guide
3749
3750 =over 4
3751
3752 =item INTRODUCTION
3753
3754 =item QUICK CHECKLIST
3755
3756 =over 4
3757
3758 =item Before you start
3759
3760 =item The API
3761
3762 =item Stability
3763
3764 =item Documentation
3765
3766 =item Release considerations
3767
3768 =back
3769
3770 =item BEFORE YOU START WRITING A MODULE
3771
3772 =over 4
3773
3774 =item Has it been done before?
3775
3776 =item Do one thing and do it well
3777
3778 =item What's in a name?
3779
3780 =back
3781
3782 =item DESIGNING AND WRITING YOUR MODULE
3783
3784 =over 4
3785
3786 =item To OO or not to OO?
3787
3788 =item Designing your API
3789
3790 Write simple routines to do simple things, Separate functionality from
3791 output, Provide sensible shortcuts and defaults, Naming conventions,
3792 Parameter passing
3793
3794 =item Strictness and warnings
3795
3796 =item Backwards compatibility
3797
3798 =item Error handling and messages
3799
3800 =back
3801
3802 =item DOCUMENTING YOUR MODULE
3803
3804 =over 4
3805
3806 =item POD
3807
3808 =item README, INSTALL, release notes, changelogs
3809
3810 perl Makefile.PL, make, make test, make install, perl Build.PL, perl Build,
3811 perl Build test, perl Build install
3812
3813 =back
3814
3815 =item RELEASE CONSIDERATIONS
3816
3817 =over 4
3818
3819 =item Version numbering
3820
3821 =item Pre-requisites
3822
3823 =item Testing
3824
3825 =item Packaging
3826
3827 =item Licensing
3828
3829 =back
3830
3831 =item COMMON PITFALLS
3832
3833 =over 4
3834
3835 =item Reinventing the wheel
3836
3837 =item Trying to do too much
3838
3839 =item Inappropriate documentation
3840
3841 =back
3842
3843 =item SEE ALSO
3844
3845 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Packaging Tools,
3846 Testing tools, http://pause.perl.org/, Any good book on software
3847 engineering
3848
3849 =item AUTHOR
3850
3851 =back
3852
3853 =head2 perlmodinstall - Installing CPAN Modules
3854
3855 =over 4
3856
3857 =item DESCRIPTION
3858
3859 =over 4
3860
3861 =item PREAMBLE
3862
3863 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
3864 module (sometimes unnecessary), B<INSTALL> the module
3865
3866 =back
3867
3868 =item PORTABILITY
3869
3870 =item HEY
3871
3872 =item AUTHOR
3873
3874 =item COPYRIGHT
3875
3876 =back
3877
3878 =head2 perlnewmod - preparing a new module for distribution
3879
3880 =over 4
3881
3882 =item DESCRIPTION
3883
3884 =over 4
3885
3886 =item Warning
3887
3888 =item What should I make into a module?
3889
3890 =item Step-by-step: Preparing the ground
3891
3892 Look around, Check it's new, Discuss the need, Choose a name, Check again
3893
3894 =item Step-by-step: Making the module
3895
3896 Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
3897 L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
3898 documentation|perlpod>, Write tests, Write the README
3899
3900 =item Step-by-step: Distributing your module
3901
3902 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
3903 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
3904
3905 =back
3906
3907 =item AUTHOR
3908
3909 =item SEE ALSO
3910
3911 =back
3912
3913 =head2 perlutil - utilities packaged with the Perl distribution
3914
3915 =over 4
3916
3917 =item DESCRIPTION
3918
3919 =over 4
3920
3921 =item DOCUMENTATION
3922
3923 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
3924 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
3925 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
3926 L<roffitall|roffitall>
3927
3928 =item CONVERTORS
3929
3930 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
3931
3932 =item Administration
3933
3934 L<libnetcfg|libnetcfg>
3935
3936 =item Development
3937
3938 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
3939 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
3940
3941 =item SEE ALSO
3942
3943 =back
3944
3945 =back
3946
3947 =head2 perlcompile - Introduction to the Perl Compiler-Translator 
3948
3949 =over 4
3950
3951 =item DESCRIPTION
3952
3953 =over 4
3954
3955 =item Layout
3956
3957 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3958
3959 =back
3960
3961 =item Using The Back Ends
3962
3963 =over 4
3964
3965 =item The Cross Referencing Back End
3966
3967 i, &, s, r
3968
3969 =item The Decompiling Back End
3970
3971 =item The Lint Back End
3972
3973 =item The Simple C Back End
3974
3975 =item The Bytecode Back End
3976
3977 =item The Optimized C Back End
3978
3979 =back
3980
3981 =item Module List for the Compiler Suite
3982
3983 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3984 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
3985 B::Stackobj, B::Stash, B::Terse, B::Xref
3986
3987 =item KNOWN PROBLEMS
3988
3989 =item AUTHOR
3990
3991 =back
3992
3993 =head2 perlfilter - Source Filters
3994
3995 =over 4
3996
3997 =item DESCRIPTION
3998
3999 =item CONCEPTS
4000
4001 =item USING FILTERS
4002
4003 =item WRITING A SOURCE FILTER
4004
4005 =item WRITING A SOURCE FILTER IN C
4006
4007 B<Decryption Filters>
4008
4009 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4010
4011 =item WRITING A SOURCE FILTER IN PERL
4012
4013 =item USING CONTEXT: THE DEBUG FILTER
4014
4015 =item CONCLUSION
4016
4017 =item THINGS TO LOOK OUT FOR
4018
4019 Some Filters Clobber the C<DATA> Handle
4020
4021 =item REQUIREMENTS
4022
4023 =item AUTHOR
4024
4025 =item Copyrights
4026
4027 =back
4028
4029 =head2 perlembed - how to embed perl in your C program
4030
4031 =over 4
4032
4033 =item DESCRIPTION
4034
4035 =over 4
4036
4037 =item PREAMBLE
4038
4039 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
4040 Perl?>, B<Use C from C?>, B<Use Perl from C?>
4041
4042 =item ROADMAP
4043
4044 =item Compiling your C program
4045
4046 =item Adding a Perl interpreter to your C program
4047
4048 =item Calling a Perl subroutine from your C program
4049
4050 =item Evaluating a Perl statement from your C program
4051
4052 =item Performing Perl pattern matches and substitutions from your C program
4053
4054 =item Fiddling with the Perl stack from your C program
4055
4056 =item Maintaining a persistent interpreter
4057
4058 =item Execution of END blocks
4059
4060 =item Maintaining multiple interpreter instances
4061
4062 =item Using Perl modules, which themselves use C libraries, from your C
4063 program
4064
4065 =back
4066
4067 =item Embedding Perl under Win32
4068
4069 =item Hiding Perl_
4070
4071 =item MORAL
4072
4073 =item AUTHOR
4074
4075 =item COPYRIGHT
4076
4077 =back
4078
4079 =head2 perldebguts - Guts of Perl debugging 
4080
4081 =over 4
4082
4083 =item DESCRIPTION
4084
4085 =item Debugger Internals
4086
4087 =over 4
4088
4089 =item Writing Your Own Debugger
4090
4091 =back
4092
4093 =item Frame Listing Output Examples
4094
4095 =item Debugging regular expressions
4096
4097 =over 4
4098
4099 =item Compile-time output
4100
4101 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
4102 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
4103 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
4104 C<anchored(TYPE)>
4105
4106 =item Types of nodes
4107
4108 =item Run-time output
4109
4110 =back
4111
4112 =item Debugging Perl memory usage
4113
4114 =over 4
4115
4116 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
4117
4118 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
4119 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
4120 6144>
4121
4122 =item Example of using B<-DL> switch
4123
4124 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
4125
4126 =item B<-DL> details
4127
4128 C<!!!>, C<!!>, C<!>
4129
4130 =item Limitations of B<-DL> statistics
4131
4132 =back
4133
4134 =item SEE ALSO
4135
4136 =back
4137
4138 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
4139
4140 =over 4
4141
4142 =item DESCRIPTION
4143
4144 =item SPECIAL NOTES
4145
4146 =over 4
4147
4148 =item make
4149
4150 =item Version caveat
4151
4152 =item Dynamic Loading versus Static Loading
4153
4154 =back
4155
4156 =item TUTORIAL
4157
4158 =over 4
4159
4160 =item EXAMPLE 1
4161
4162 =item EXAMPLE 2
4163
4164 =item What has gone on?
4165
4166 =item Writing good test scripts
4167
4168 =item EXAMPLE 3
4169
4170 =item What's new here?
4171
4172 =item Input and Output Parameters
4173
4174 =item The XSUBPP Program
4175
4176 =item The TYPEMAP file
4177
4178 =item Warning about Output Arguments
4179
4180 =item EXAMPLE 4
4181
4182 =item What has happened here?
4183
4184 =item Anatomy of .xs file
4185
4186 =item Getting the fat out of XSUBs
4187
4188 =item More about XSUB arguments
4189
4190 =item The Argument Stack
4191
4192 =item Extending your Extension
4193
4194 =item Documenting your Extension
4195
4196 =item Installing your Extension
4197
4198 =item EXAMPLE 5
4199
4200 =item New Things in this Example
4201
4202 =item EXAMPLE 6
4203
4204 =item New Things in this Example
4205
4206 =item EXAMPLE 7 (Coming Soon)
4207
4208 =item EXAMPLE 8 (Coming Soon)
4209
4210 =item EXAMPLE 9 Passing open files to XSes
4211
4212 =item Troubleshooting these Examples
4213
4214 =back
4215
4216 =item See also
4217
4218 =item Author
4219
4220 =over 4
4221
4222 =item Last Changed
4223
4224 =back
4225
4226 =back
4227
4228 =head2 perlxs - XS language reference manual
4229
4230 =over 4
4231
4232 =item DESCRIPTION
4233
4234 =over 4
4235
4236 =item Introduction
4237
4238 =item On The Road
4239
4240 =item The Anatomy of an XSUB
4241
4242 =item The Argument Stack
4243
4244 =item The RETVAL Variable
4245
4246 =item Returning SVs, AVs and HVs through RETVAL
4247
4248 =item The MODULE Keyword
4249
4250 =item The PACKAGE Keyword
4251
4252 =item The PREFIX Keyword
4253
4254 =item The OUTPUT: Keyword
4255
4256 =item The NO_OUTPUT Keyword
4257
4258 =item The CODE: Keyword
4259
4260 =item The INIT: Keyword
4261
4262 =item The NO_INIT Keyword
4263
4264 =item Initializing Function Parameters
4265
4266 =item Default Parameter Values
4267
4268 =item The PREINIT: Keyword
4269
4270 =item The SCOPE: Keyword
4271
4272 =item The INPUT: Keyword
4273
4274 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
4275
4276 =item The C<length(NAME)> Keyword
4277
4278 =item Variable-length Parameter Lists
4279
4280 =item The C_ARGS: Keyword
4281
4282 =item The PPCODE: Keyword
4283
4284 =item Returning Undef And Empty Lists
4285
4286 =item The REQUIRE: Keyword
4287
4288 =item The CLEANUP: Keyword
4289
4290 =item The POSTCALL: Keyword
4291
4292 =item The BOOT: Keyword
4293
4294 =item The VERSIONCHECK: Keyword
4295
4296 =item The PROTOTYPES: Keyword
4297
4298 =item The PROTOTYPE: Keyword
4299
4300 =item The ALIAS: Keyword
4301
4302 =item The OVERLOAD: Keyword
4303
4304 =item The FALLBACK: Keyword
4305
4306 =item The INTERFACE: Keyword
4307
4308 =item The INTERFACE_MACRO: Keyword
4309
4310 =item The INCLUDE: Keyword
4311
4312 =item The CASE: Keyword
4313
4314 =item The & Unary Operator
4315
4316 =item Inserting POD, Comments and C Preprocessor Directives
4317
4318 =item Using XS With C++
4319
4320 =item Interface Strategy
4321
4322 =item Perl Objects And C Structures
4323
4324 =item The Typemap
4325
4326 =item Safely Storing Static Data in XS
4327
4328 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4329
4330 =back
4331
4332 =item EXAMPLES
4333
4334 =item XS VERSION
4335
4336 =item AUTHOR
4337
4338 =back
4339
4340 =head2 perlclib - Internal replacements for standard C library functions
4341
4342 =over 4
4343
4344 =item DESCRIPTION
4345
4346 =over 4
4347
4348 =item Conventions
4349
4350 C<t>, C<p>, C<n>, C<s>
4351
4352 =item File Operations
4353
4354 =item File Input and Output
4355
4356 =item File Positioning
4357
4358 =item Memory Management and String Handling
4359
4360 =item Character Class Tests
4361
4362 =item F<stdlib.h> functions
4363
4364 =item Miscellaneous functions
4365
4366 =back
4367
4368 =item SEE ALSO
4369
4370 =back
4371
4372 =head2 perlguts - Introduction to the Perl API
4373
4374 =over 4
4375
4376 =item DESCRIPTION
4377
4378 =item Variables
4379
4380 =over 4
4381
4382 =item Datatypes
4383
4384 =item What is an "IV"?
4385
4386 =item Working with SVs
4387
4388 =item Offsets
4389
4390 =item What's Really Stored in an SV?
4391
4392 =item Working with AVs
4393
4394 =item Working with HVs
4395
4396 =item Hash API Extensions
4397
4398 =item AVs, HVs and undefined values
4399
4400 =item References
4401
4402 =item Blessed References and Class Objects
4403
4404 =item Creating New Variables
4405
4406 GV_ADDMULTI, GV_ADDWARN
4407
4408 =item Reference Counts and Mortality
4409
4410 =item Stashes and Globs
4411
4412 =item Double-Typed SVs
4413
4414 =item Magic Variables
4415
4416 =item Assigning Magic
4417
4418 =item Magic Virtual Tables
4419
4420 =item Finding Magic
4421
4422 =item Understanding the Magic of Tied Hashes and Arrays
4423
4424 =item Localizing changes
4425
4426 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
4427 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
4428 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
4429 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
4430 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
4431 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
4432 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
4433 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
4434 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
4435 save_hptr(HV **hptr)>
4436
4437 =back
4438
4439 =item Subroutines
4440
4441 =over 4
4442
4443 =item XSUBs and the Argument Stack
4444
4445 =item Calling Perl Routines from within C Programs
4446
4447 =item Memory Allocation
4448
4449 =item PerlIO
4450
4451 =item Putting a C value on Perl stack
4452
4453 =item Scratchpads
4454
4455 =item Scratchpads and recursion
4456
4457 =back
4458
4459 =item Compiled code
4460
4461 =over 4
4462
4463 =item Code tree
4464
4465 =item Examining the tree
4466
4467 =item Compile pass 1: check routines
4468
4469 =item Compile pass 1a: constant folding
4470
4471 =item Compile pass 2: context propagation
4472
4473 =item Compile pass 3: peephole optimization
4474
4475 =item Pluggable runops
4476
4477 =back
4478
4479 =item Examining internal data structures with the C<dump> functions
4480
4481 =item How multiple interpreters and concurrency are supported
4482
4483 =over 4
4484
4485 =item Background and PERL_IMPLICIT_CONTEXT
4486
4487 =item So what happened to dTHR?
4488
4489 =item How do I use all this in extensions?
4490
4491 =item Should I do anything special if I call perl from multiple threads?
4492
4493 =item Future Plans and PERL_IMPLICIT_SYS
4494
4495 =back
4496
4497 =item Internal Functions
4498
4499 A, p, d, s, n, r, f, M, o, x, m, X, E, b
4500
4501 =over 4
4502
4503 =item Formatted Printing of IVs, UVs, and NVs
4504
4505 =item Pointer-To-Integer and Integer-To-Pointer
4506
4507 =item Source Documentation
4508
4509 =back
4510
4511 =item Unicode Support
4512
4513 =over 4
4514
4515 =item What B<is> Unicode, anyway?
4516
4517 =item How can I recognise a UTF-8 string?
4518
4519 =item How does UTF-8 represent Unicode characters?
4520
4521 =item How does Perl store UTF-8 strings?
4522
4523 =item How do I convert a string to UTF-8?
4524
4525 =item Is there anything else I need to know?
4526
4527 =back
4528
4529 =item Custom Operators
4530
4531 =item AUTHORS
4532
4533 =item SEE ALSO
4534
4535 =back
4536
4537 =head2 perlcall - Perl calling conventions from C
4538
4539 =over 4
4540
4541 =item DESCRIPTION
4542
4543 An Error Handler, An Event Driven Program
4544
4545 =item THE CALL_ FUNCTIONS
4546
4547 call_sv, call_pv, call_method, call_argv
4548
4549 =item FLAG VALUES
4550
4551 =over 4
4552
4553 =item  G_VOID
4554
4555 =item  G_SCALAR
4556
4557 =item G_ARRAY
4558
4559 =item G_DISCARD
4560
4561 =item G_NOARGS
4562
4563 =item G_EVAL
4564
4565 =item G_KEEPERR
4566
4567 =item Determining the Context
4568
4569 =back
4570
4571 =item KNOWN PROBLEMS
4572
4573 =item EXAMPLES
4574
4575 =over 4
4576
4577 =item No Parameters, Nothing returned
4578
4579 =item Passing Parameters
4580
4581 =item Returning a Scalar
4582
4583 =item Returning a list of values
4584
4585 =item Returning a list in a scalar context
4586
4587 =item Returning Data from Perl via the parameter list
4588
4589 =item Using G_EVAL
4590
4591 =item Using G_KEEPERR
4592
4593 =item Using call_sv
4594
4595 =item Using call_argv
4596
4597 =item Using call_method
4598
4599 =item Using GIMME_V
4600
4601 =item Using Perl to dispose of temporaries
4602
4603 =item Strategies for storing Callback Context Information
4604
4605 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
4606 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
4607 callback
4608
4609 =item Alternate Stack Manipulation
4610
4611 =item Creating and calling an anonymous subroutine in C
4612
4613 =back
4614
4615 =item SEE ALSO
4616
4617 =item AUTHOR
4618
4619 =item DATE
4620
4621 =back
4622
4623 =head2 perlapi - autogenerated documentation for the perl public API
4624
4625 =over 4
4626
4627 =item DESCRIPTION
4628
4629 =item "Gimme" Values
4630
4631 GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
4632
4633 =item Array Manipulation Functions
4634
4635 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4636 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4637 get_av, newAV, Nullav, sortsv
4638
4639 =item Callback Functions
4640
4641 call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
4642 FREETMPS, LEAVE, SAVETMPS
4643
4644 =item Character classes
4645
4646 isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
4647
4648 =item Cloning an interpreter
4649
4650 perl_clone
4651
4652 =item CV Manipulation Functions
4653
4654 CvSTASH, get_cv, Nullcv
4655
4656 =item Embedding Functions
4657
4658 cv_undef, load_module, nothreadhook, perl_alloc, perl_construct,
4659 perl_destruct, perl_free, perl_parse, perl_run, require_pv
4660
4661 =item Functions in file pp_pack.c
4662
4663 packlist, pack_cat, unpackstring, unpack_str
4664
4665 =item Global Variables
4666
4667 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
4668
4669 =item GV Functions
4670
4671 GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
4672 gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
4673
4674 =item Handy Values
4675
4676 HEf_SVKEY, Nullch, Nullsv
4677
4678 =item Hash Manipulation Functions
4679
4680 get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set,
4681 HeVAL, HvNAME, hv_assert, hv_clear, hv_clear_placeholders, hv_delete,
4682 hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
4683 hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv,
4684 hv_iternext_flags, hv_iterval, hv_magic, hv_scalar, hv_store, hv_store_ent,
4685 hv_undef, newHV, Nullhv
4686
4687 =item Magical Functions
4688
4689 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
4690 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
4691 SvSetSV, SvSetSV_nosteal, SvSHARE
4692
4693 =item Memory Management
4694
4695 Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree,
4696 savepv, savepvn, savesharedpv, StructCopy, Zero
4697
4698 =item Miscellaneous Functions
4699
4700 fbm_compile, fbm_instr, form, getcwd_sv, new_version, scan_version, strEQ,
4701 strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_nolocking,
4702 sv_nosharing, sv_nounlocking, upg_version, vcmp, vnormal, vnumify,
4703 vstringify
4704
4705 =item Numeric functions
4706
4707 grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
4708 scan_hex, scan_oct
4709
4710 =item Optree Manipulation Functions
4711
4712 cv_const_sv, newCONSTSUB, newXS
4713
4714 =item Pad Data Structures
4715
4716 pad_sv
4717
4718 =item Stack Manipulation Macros
4719
4720 dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp,
4721 POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
4722 PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN,
4723 XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
4724 XSRETURN_UV, XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF,
4725 XST_mYES
4726
4727 =item SV Flags
4728
4729 svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
4730
4731 =item SV Manipulation Functions
4732
4733 get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
4734 newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
4735 SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off,
4736 SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIsCOW,
4737 SvIsCOW_shared_hash, SvIV, SvIVx, SvIVX, SvIV_nomg, SvLEN, SvNIOK, SvNIOKp,
4738 SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX,
4739 SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only,
4740 SvPOK_only_UTF8, SvPV, SvPVbyte, SvPVbytex, SvPVbytex_force,
4741 SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, SvPVutf8x, SvPVutf8x_force,
4742 SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX, SvPV_force, SvPV_force_nomg,
4743 SvPV_nolen, SvPV_nomg, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK,
4744 SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off,
4745 SvTAINTED_on, SvTRUE, SvTYPE, SvUNLOCK, SvUOK, SvUPGRADE, SvUTF8,
4746 SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, SvUV_nomg, SvVOK, sv_2bool,
4747 sv_2cv, sv_2io, sv_2iv_flags, sv_2mortal, sv_2nv, sv_2pvbyte,
4748 sv_2pvbyte_nolen, sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen,
4749 sv_2uv_flags, sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg,
4750 sv_catpvn, sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv,
4751 sv_catsv_flags, sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale,
4752 sv_collxfrm, sv_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal,
4753 sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, sv_insert,
4754 sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, sv_magicext,
4755 sv_mortalcopy, sv_newmortal, sv_newref, sv_nv, sv_pos_b2u, sv_pos_u2b,
4756 sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force,
4757 sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype,
4758 sv_replace, sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg,
4759 sv_setnv, sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv,
4760 sv_setpviv_mg, sv_setpvn, sv_setpvn_mg, sv_setpv_mg, sv_setref_iv,
4761 sv_setref_nv, sv_setref_pv, sv_setref_pvn, sv_setref_uv, sv_setsv,
4762 sv_setsv_flags, sv_setsv_mg, sv_setuv, sv_setuv_mg, sv_taint, sv_tainted,
4763 sv_true, sv_unmagic, sv_unref, sv_unref_flags, sv_untaint, sv_upgrade,
4764 sv_usepvn, sv_usepvn_mg, sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode,
4765 sv_utf8_upgrade, sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn
4766
4767 =item Unicode Support
4768
4769 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
4770 is_utf8_string_loc, pv_uni_display, sv_cat_decode, sv_recode_to_utf8,
4771 sv_uni_display, to_utf8_case, to_utf8_fold, to_utf8_lower, to_utf8_title,
4772 to_utf8_upper, utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop,
4773 utf8_length, utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8,
4774 uvuni_to_utf8_flags
4775
4776 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
4777
4778 ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST,
4779 THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK
4780
4781 =item Warning and Dieing
4782
4783 croak, warn
4784
4785 =item AUTHORS
4786
4787 =item SEE ALSO
4788
4789 =back
4790
4791 =head2 perlintern - autogenerated documentation of purely B<internal>
4792                  Perl functions
4793
4794 =over 4
4795
4796 =item DESCRIPTION
4797
4798 =item CV reference counts and CvOUTSIDE
4799
4800 CvWEAKOUTSIDE
4801
4802 =item Functions in file pad.h
4803
4804 CX_CURPAD_SAVE, CX_CURPAD_SV, PAD_BASE_SV, PAD_CLONE_VARS,
4805 PAD_COMPNAME_FLAGS, PAD_COMPNAME_GEN, PAD_COMPNAME_OURSTASH,
4806 PAD_COMPNAME_PV, PAD_COMPNAME_TYPE, PAD_DUP, PAD_RESTORE_LOCAL,
4807 PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV, PAD_SET_CUR,
4808 PAD_SET_CUR_NOSAVE, PAD_SV, PAD_SVl, SAVECLEARSV, SAVECOMPPAD, SAVEPADSV
4809
4810 =item Functions in file pp_ctl.c
4811
4812 find_runcv
4813
4814 =item Global Variables
4815
4816 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
4817 PL_rs
4818
4819 =item GV Functions
4820
4821 is_gv_magical
4822
4823 =item IO Functions
4824
4825 start_glob
4826
4827 =item Pad Data Structures
4828
4829 CvPADLIST, cv_clone, cv_dump, do_dump_pad, intro_my, pad_add_anon,
4830 pad_add_name, pad_alloc, pad_block_start, pad_check_dup, pad_findlex,
4831 pad_findmy, pad_fixup_inner_anons, pad_free, pad_leavemy, pad_new,
4832 pad_push, pad_reset, pad_setsv, pad_swipe, pad_tidy, pad_undef
4833
4834 =item Stack Manipulation Macros
4835
4836 djSP, LVRET
4837
4838 =item SV Manipulation Functions
4839
4840 report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
4841
4842 =item AUTHORS
4843
4844 =item SEE ALSO
4845
4846 =back
4847
4848 =head2 perliol - C API for Perl's implementation of IO in Layers.
4849
4850 =over 4
4851
4852 =item SYNOPSIS
4853
4854 =item DESCRIPTION
4855
4856 =over 4
4857
4858 =item History and Background
4859
4860 =item Basic Structure
4861
4862 =item Layers vs Disciplines
4863
4864 =item Data Structures
4865
4866 =item Functions and Attributes
4867
4868 =item Per-instance Data
4869
4870 =item Layers in action.
4871
4872 =item Per-instance flag bits
4873
4874 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4875 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4876 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4877 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4878
4879 =item Methods in Detail
4880
4881 fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF,
4882 PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode,
4883 Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof,
4884 Error,  Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
4885 Set_ptrcnt
4886
4887 =item Utilities
4888
4889 =item Implementing PerlIO Layers
4890
4891 C implementations, Perl implementations
4892
4893 =item Core Layers
4894
4895 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4896
4897 =item Extension Layers
4898
4899 ":encoding", ":scalar", ":via"
4900
4901 =back
4902
4903 =item TODO
4904
4905 =back
4906
4907 =head2 perlapio - perl's IO abstraction interface.
4908
4909 =over 4
4910
4911 =item SYNOPSIS
4912
4913 =item DESCRIPTION
4914
4915 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4916 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4917 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4918 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4919 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4920 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4921 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4922 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4923 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4924 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4925 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4926
4927 =over 4
4928
4929 =item Co-existence with stdio
4930
4931 B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
4932 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
4933
4934 =item "Fast gets" Functions
4935
4936 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4937 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4938 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4939 B<PerlIO_get_bufsiz(f)>
4940
4941 =item Other Functions
4942
4943 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4944 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4945
4946 =back
4947
4948 =back
4949
4950 =head2 perlhack - How to hack at the Perl internals
4951
4952 =over 4
4953
4954 =item DESCRIPTION
4955
4956 Does concept match the general goals of Perl?, Where is the
4957 implementation?, Backwards compatibility, Could it be a module instead?, Is
4958 the feature generic enough?, Does it potentially introduce new bugs?, Does
4959 it preclude other desirable features?, Is the implementation robust?, Is
4960 the implementation generic enough to be portable?, Is the implementation
4961 tested?, Is there enough documentation?, Is there another way to do it?,
4962 Does it create too much work?, Patches speak louder than words
4963
4964 =over 4
4965
4966 =item Keeping in sync
4967
4968 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
4969 NFS, rsync'ing the patches
4970
4971 =item Why rsync the source tree
4972
4973 It's easier to rsync the source tree, It's more reliable
4974
4975 =item Why rsync the patches
4976
4977 It's easier to rsync the patches, It's a good reference, Finding a start
4978 point, Finding how to fix a bug, Finding the source of misbehaviour
4979
4980 =item Perlbug administration
4981
4982 =item Submitting patches
4983
4984 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
4985 F<Porting/pumpkin.pod>, The perl5-porters FAQ
4986
4987 =item Finding Your Way Around
4988
4989 Core modules, Tests, Documentation, Configure, Interpreter
4990
4991 =item Elements of the interpreter
4992
4993 Startup, Parsing, Optimization, Running
4994
4995 =item Internal Variable Types
4996
4997 =item Op Trees
4998
4999 =item Stacks
5000
5001 Argument stack, Mark stack, Save stack
5002
5003 =item Millions of Macros
5004
5005 =item The .i Targets
5006
5007 =item Poking at Perl
5008
5009 =item Using a source-level debugger
5010
5011 run [args], break function_name, break source.c:xxx, step, next, continue,
5012 finish, 'enter', print
5013
5014 =item gdb macro support
5015
5016 =item Dumping Perl Data Structures
5017
5018 =item Patching
5019
5020 =item Patching a core module
5021
5022 =item Adding a new function to the core
5023
5024 =item Writing a test
5025
5026 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5027 F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base t/comp,
5028 t/cmd t/run t/io t/op, t/lib ext lib
5029
5030 =item Special Make Test Targets
5031
5032 coretest, test.deparse, test.taintwarn, minitest, test.valgrind
5033 check.valgrind utest.valgrind ucheck.valgrind, test.third check.third
5034 utest.third ucheck.third, test.torture torturetest, utest ucheck test.utf8
5035 check.utf8, test_harness
5036
5037 =item Running tests by hand
5038
5039 PERL_CORE=1, PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST
5040
5041 =back
5042
5043 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5044
5045 =over 4
5046
5047 =item Rational Software's Purify
5048
5049 =item Purify on Unix
5050
5051 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5052
5053 =item Purify on NT
5054
5055 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5056
5057 =item valgrind
5058
5059 =item Compaq's/Digital's/HP's Third Degree
5060
5061 =item PERL_DESTRUCT_LEVEL
5062
5063 =item Profiling
5064
5065 =item Gprof Profiling
5066
5067 -a, -b, -e routine, -f routine, -s, -z
5068
5069 =item GCC gcov Profiling
5070
5071 =item Pixie Profiling
5072
5073 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5074 -z[ero]
5075
5076 =item Miscellaneous tricks
5077
5078 =item CONCLUSION
5079
5080 I<The Road goes ever on and on, down from the door where it began.>
5081
5082 =back
5083
5084 =item AUTHOR
5085
5086 =back
5087
5088 =head2 perlbook - Perl book information
5089
5090 =over 4
5091
5092 =item DESCRIPTION
5093
5094 =back
5095
5096 =head2 perltodo - Perl TO-DO List
5097
5098 =over 4
5099
5100 =item DESCRIPTION
5101
5102 =item To do during 5.6.x
5103
5104 =over 4
5105
5106 =item Support for I/O disciplines
5107
5108 =item Autoload bytes.pm
5109
5110 =item Make "\u{XXXX}" et al work
5111
5112 =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
5113
5114 =item Overloadable regex assertions
5115
5116 =item Unicode
5117
5118 =item Work out exit/die semantics for threads
5119
5120 =item Better support for nonpreemptive threading systems like GNU pth
5121
5122 =item Typed lexicals for compiler
5123
5124 =item Compiler workarounds for Win32
5125
5126 =item AUTOLOADing in the compiler
5127
5128 =item Fixing comppadlist when compiling
5129
5130 =item Cleaning up exported namespace
5131
5132 =item Complete signal handling
5133
5134 =item Out-of-source builds
5135
5136 =item POSIX realtime support
5137
5138 =item UNIX98 support
5139
5140 =item IPv6 Support
5141
5142 =item Long double conversion
5143
5144 =item Locales
5145
5146 =item Arithmetic on non-Arabic numerals
5147
5148 =item POSIX Unicode character classes
5149
5150 =item Factoring out common suffices/prefices in regexps (trie optimization)
5151
5152 =item Security audit shipped utilities
5153
5154 =item Sort out the uid-setting mess
5155
5156 =item Custom opcodes
5157
5158 =item DLL Versioning
5159
5160 =item Introduce @( and @)
5161
5162 =item Floating point handling
5163
5164 =item IV/UV preservation
5165
5166 =item Replace pod2html with something using Pod::Parser
5167
5168 =item Automate module testing on CPAN
5169
5170 =item sendmsg and recvmsg
5171
5172 =item Rewrite perlre documentation
5173
5174 =item Convert example code to IO::Handle filehandles
5175
5176 =item Document Win32 choices
5177
5178 =item Check new modules
5179
5180 =item Make roffitall find pods and libs itself
5181
5182 =back
5183
5184 =item To do at some point
5185
5186 =over 4
5187
5188 =item Remove regular expression recursion
5189
5190 =item Memory leaks after failed eval
5191
5192 =item bitfields in pack
5193
5194 =item Cross compilation
5195
5196 =item Perl preprocessor / macros
5197
5198 =item Perl lexer in Perl
5199
5200 =item Using POSIX calls internally
5201
5202 =item -i rename file when changed
5203
5204 =item All ARGV input should act like E<lt>E<gt>
5205
5206 =item Support for rerunning debugger
5207
5208 =item Test Suite for the Debugger
5209
5210 =item my sub foo { }
5211
5212 =item One-pass global destruction
5213
5214 =item Rewrite regexp parser
5215
5216 =item Cache recently used regexps
5217
5218 =item Cross-compilation support
5219
5220 =item Bit-shifting bitvectors
5221
5222 =item debugger pragma
5223
5224 =item use less pragma
5225
5226 =item switch structures
5227
5228 =item Cache eval tree
5229
5230 =item rcatmaybe
5231
5232 =item Shrink opcode tables
5233
5234 =item Optimize away @_
5235
5236 =item Prototypes versus indirect objects
5237
5238 =item Install HTML
5239
5240 =item Prototype method calls
5241
5242 =item Return context prototype declarations
5243
5244 =item magic_setisa
5245
5246 =item Garbage collection
5247
5248 =item IO tutorial
5249
5250 =item Rewrite perldoc
5251
5252 =item Install .3p manpages
5253
5254 =item Unicode tutorial
5255
5256 =item Update POSIX.pm for 1003.1-2
5257
5258 =item Retargetable installation
5259
5260 =item POSIX emulation on non-POSIX systems
5261
5262 =item Rename Win32 headers
5263
5264 =item Finish off lvalue functions
5265
5266 =item Update sprintf documentation
5267
5268 =item Use fchown/fchmod internally
5269
5270 =item Make v-strings overloaded objects
5271
5272 =item Allow restricted hash assignment
5273
5274 =item Should overload be inheritable?
5275
5276 =item Taint rethink
5277
5278 =item Perform correctly when XSUBs call subroutines that exit via
5279 goto(LABEL) and friends
5280
5281 =back
5282
5283 =item Vague ideas
5284
5285 =over 4
5286
5287 =item ref() in list context
5288
5289 =item Make tr/// return histogram of characters in list context
5290
5291 =item Compile to real threaded code
5292
5293 =item Structured types
5294
5295 =item Modifiable $1 et al.
5296
5297 =item Procedural interfaces for IO::*, etc.
5298
5299 =item RPC modules
5300
5301 =item Attach/detach debugger from running program
5302
5303 =item GUI::Native
5304
5305 =item foreach(reverse ...)
5306
5307 =item Constant function cache
5308
5309 =item Approximate regular expression matching
5310
5311 =back
5312
5313 =item Ongoing
5314
5315 =over 4
5316
5317 =item Update guts documentation
5318
5319 =item Add more tests
5320
5321 =item Update auxiliary tools
5322
5323 =item Create debugging macros
5324
5325 =item truncate to the people
5326
5327 =item Unicode in Filenames
5328
5329 =back
5330
5331 =item Unicode in %ENV
5332
5333 =item Recently done things
5334
5335 =over 4
5336
5337 =item Alternative RE syntax module
5338
5339 =item Safe signal handling
5340
5341 =item Tie Modules
5342
5343 =item gettimeofday
5344
5345 =item setitimer and getimiter
5346
5347 =item Testing __DIE__ hook
5348
5349 =item CPP equivalent in Perl
5350
5351 =item Explicit switch statements
5352
5353 =item autocroak
5354
5355 =item UTF/EBCDIC
5356
5357 =item UTF Regexes
5358
5359 =item perlcc to produce executable
5360
5361 =item END blocks saved in compiled output
5362
5363 =item Secure temporary file module
5364
5365 =item Integrate Time::HiRes
5366
5367 =item Turn Cwd into XS
5368
5369 =item Mmap for input
5370
5371 =item Byte to/from UTF-8 and UTF-8 to/from local conversion
5372
5373 =item Add sockatmark support
5374
5375 =item Mailing list archives
5376
5377 =item Bug tracking
5378
5379 =item Integrate MacPerl
5380
5381 =item Web "nerve center" for Perl
5382
5383 =item Regular expression tutorial
5384
5385 =item Debugging Tutorial
5386
5387 =item Integrate new modules
5388
5389 =item Integrate profiler
5390
5391 =item Y2K error detection
5392
5393 =item Regular expression debugger
5394
5395 =item POD checker
5396
5397 =item "Dynamic" lexicals
5398
5399 =item Cache precompiled modules
5400
5401 =back
5402
5403 =item Deprecated Wishes
5404
5405 =over 4
5406
5407 =item Loop control on do{}
5408
5409 =item Lexically scoped typeglobs
5410
5411 =item format BOTTOM
5412
5413 =item report HANDLE
5414
5415 =item Generalised want()/caller())
5416
5417 =item Named prototypes
5418
5419 =item Built-in globbing
5420
5421 =item Regression tests for suidperl
5422
5423 =item Cached hash values
5424
5425 =item Add compression modules
5426
5427 =item Reorganise documentation into tutorials/references
5428
5429 =item Remove distinction between functions and operators
5430
5431 =item Make XS easier to use
5432
5433 =item Make embedding easier to use
5434
5435 =item man for perl
5436
5437 =item my $Package::variable
5438
5439 =item "or" tests defined, not truth
5440
5441 =item "class"-based lexicals
5442
5443 =item byteperl
5444
5445 =item Lazy evaluation / tail recursion removal
5446
5447 =item Make "use utf8" the default
5448
5449 =item Unicode collation and normalization
5450
5451 =item pack/unpack tutorial
5452
5453 =back
5454
5455 =back
5456
5457 =head2 perldoc - Look up Perl documentation in Pod format.
5458
5459 =over 4
5460
5461 =item SYNOPSIS
5462
5463 =item DESCRIPTION
5464
5465 =item OPTIONS
5466
5467 B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
5468 I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
5469 I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
5470 B<-w> I<option:value> or B<-w> I<option>, B<-X>,
5471 B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
5472 B<-V>
5473
5474 =item SECURITY
5475
5476 =item ENVIRONMENT
5477
5478 =item AUTHOR
5479
5480 =back
5481
5482 =head2 perlhist - the Perl history records
5483
5484 =over 4
5485
5486 =item DESCRIPTION
5487
5488 =item INTRODUCTION
5489
5490 =item THE KEEPERS OF THE PUMPKIN
5491
5492 =over 4
5493
5494 =item PUMPKIN?
5495
5496 =back
5497
5498 =item THE RECORDS
5499
5500 =over 4
5501
5502 =item SELECTED RELEASE SIZES
5503
5504 =item SELECTED PATCH SIZES
5505
5506 =back
5507
5508 =item THE KEEPERS OF THE RECORDS
5509
5510 =back
5511
5512 =head2 perldelta - what is new for perl v5.9.2
5513
5514 =over 4
5515
5516 =item DESCRIPTION
5517
5518 =item Incompatible Changes
5519
5520 =item Core Enhancements
5521
5522 =item Modules and Pragmata
5523
5524 =item Utility Changes
5525
5526 =item Documentation
5527
5528 =item Performance Enhancements
5529
5530 =item Installation and Configuration Improvements
5531
5532 =item Selected Bug Fixes
5533
5534 =item New or Changed Diagnostics
5535
5536 =item Changed Internals
5537
5538 =item Known Problems
5539
5540 =over 4
5541
5542 =item Platform Specific Problems
5543
5544 =back
5545
5546 =item Reporting Bugs
5547
5548 =item SEE ALSO
5549
5550 =back
5551
5552 =head2 perl592delta, perldelta - what is new for perl v5.9.2
5553
5554 =over 4
5555
5556 =item DESCRIPTION
5557
5558 =item Incompatible Changes
5559
5560 =item Core Enhancements
5561
5562 =item Modules and Pragmata
5563
5564 =item Utility Changes
5565
5566 =item Documentation
5567
5568 =item Performance Enhancements
5569
5570 =item Installation and Configuration Improvements
5571
5572 =item Selected Bug Fixes
5573
5574 =item New or Changed Diagnostics
5575
5576 =item Changed Internals
5577
5578 =item Known Problems
5579
5580 =over 4
5581
5582 =item Platform Specific Problems
5583
5584 =back
5585
5586 =item Reporting Bugs
5587
5588 =item SEE ALSO
5589
5590 =back
5591
5592 =head2 perl591delta, perldelta - what is new for perl v5.9.1
5593
5594 =over 4
5595
5596 =item DESCRIPTION
5597
5598 =item Incompatible Changes
5599
5600 =over 4
5601
5602 =item substr() lvalues are no longer fixed-length
5603
5604 =item The C<:unique> attribute is only meaningful for globals
5605
5606 =back
5607
5608 =item Core Enhancements
5609
5610 =over 4
5611
5612 =item Lexical C<$_>
5613
5614 =item Tied hashes in scalar context
5615
5616 =item Formats
5617
5618 =item Stacked filetest operators
5619
5620 =back
5621
5622 =item Modules and Pragmata
5623
5624 Benchmark, Carp, Exporter, FindBin, List::Util, threads::shared
5625
5626 =item Utility Changes
5627
5628 =item Documentation
5629
5630 =item Performance Enhancements
5631
5632 =item Selected Bug Fixes
5633
5634 =over 4
5635
5636 =item UTF-8 bugs
5637
5638 =item Threading bugs
5639
5640 =item More bugs
5641
5642 =back
5643
5644 =item New or Changed Diagnostics
5645
5646 =item Changed Internals
5647
5648 =over 4
5649
5650 =item Reordering of SVt_* constants
5651
5652 =item Removal of CPP symbols
5653
5654 =item Less space is used by ops
5655
5656 =item New parser
5657
5658 =back
5659
5660 =item Configuration and Building
5661
5662 =item Known Problems
5663
5664 =over 4
5665
5666 =item Platform Specific Problems
5667
5668 =back
5669
5670 =item To-do for perl 5.10.0
5671
5672 =item Reporting Bugs
5673
5674 =item SEE ALSO
5675
5676 =back
5677
5678 =head2 perl590delta, perldelta - what is new for perl v5.9.0
5679
5680 =over 4
5681
5682 =item DESCRIPTION
5683
5684 =item Incompatible Changes
5685
5686 =over 4
5687
5688 =item Hash Randomisation
5689
5690 =item UTF-8 On Filehandles No Longer Activated By Locale
5691
5692 =item Single-number v-strings are no longer v-strings before "=>"
5693
5694 =item (Win32) The -C Switch Has Been Repurposed
5695
5696 =item (Win32) The /d Switch Of cmd.exe
5697
5698 =item The C<$*> variable has been removed
5699
5700 =back
5701
5702 =item Core Enhancements
5703
5704 =over 4
5705
5706 =item Assertions
5707
5708 =item Defined-or operators
5709
5710 =item UTF-8 no longer default under UTF-8 locales
5711
5712 =item Unsafe signals again available
5713
5714 =item Tied Arrays with Negative Array Indices
5715
5716 =item local ${$x}
5717
5718 =item Unicode Character Database 4.0.0
5719
5720 =item Miscellaneous Enhancements
5721
5722 =back
5723
5724 =item Modules and Pragmata
5725
5726 =over 4
5727
5728 =item Updated Modules And Pragmata
5729
5730 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
5731 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
5732 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
5733 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
5734 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
5735 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
5736 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
5737 Win32::GetOSVersion
5738
5739 =back
5740
5741 =item Utility Changes
5742
5743 =item New Documentation
5744
5745 =item Performance Enhancements
5746
5747 =item Installation and Configuration Improvements
5748
5749 =over 4
5750
5751 =item Platform-specific enhancements
5752
5753 =back
5754
5755 =item Selected Bug Fixes
5756
5757 =over 4
5758
5759 =item Closures, eval and lexicals
5760
5761 =item Generic fixes
5762
5763 =item Platform-specific fixes
5764
5765 =back
5766
5767 =item New or Changed Diagnostics
5768
5769 =over 4
5770
5771 =item Changed "A thread exited while %d threads were running"
5772
5773 =item Removed "Attempt to clear a restricted hash"
5774
5775 =item New "Illegal declaration of anonymous subroutine"
5776
5777 =item Changed "Invalid range "%s" in transliteration operator"
5778
5779 =item New "Missing control char name in \c"
5780
5781 =item New "Newline in left-justified string for %s"
5782
5783 =item New "Possible precedence problem on bitwise %c operator"
5784
5785 =item New "read() on %s filehandle %s"
5786
5787 =item New "Tied variable freed while still in use"
5788
5789 =item New "To%s: illegal mapping '%s'"
5790
5791 =item New "Use of freed value in iteration"
5792
5793 =back
5794
5795 =item Changed Internals
5796
5797 =item New Tests
5798
5799 =item Known Problems
5800
5801 =over 4
5802
5803 =item Tied hashes in scalar context
5804
5805 =item Net::Ping 450_service and 510_ping_udp failures
5806
5807 =item B::C
5808
5809 =back
5810
5811 =item Platform Specific Problems
5812
5813 =over 4
5814
5815 =item EBCDIC Platforms
5816
5817 =item Cygwin 1.5 problems
5818
5819 =item HP-UX: HP cc warnings about sendfile and sendpath
5820
5821 =item IRIX: t/uni/tr_7jis.t falsely failing
5822
5823 =item Mac OS X: no usemymalloc
5824
5825 =item Tru64: No threaded builds with GNU cc (gcc)
5826
5827 =item Win32: sysopen, sysread, syswrite
5828
5829 =back
5830
5831 =item TODO
5832
5833 =item Reporting Bugs
5834
5835 =item SEE ALSO
5836
5837 =back
5838
5839 =head2 perl584delta, perldelta - what is new for perl v5.8.4
5840
5841 =over 4
5842
5843 =item DESCRIPTION
5844
5845 =item Incompatible Changes
5846
5847 =item Core Enhancements
5848
5849 =over 4
5850
5851 =item Malloc wrapping
5852
5853 =item Unicode Character Database 4.0.1
5854
5855 =item suidperl less insecure
5856
5857 =item format
5858
5859 =back
5860
5861 =item Modules and Pragmata
5862
5863 =over 4
5864
5865 =item Updated modules
5866
5867 Attribute::Handlers, B, Benchmark, CGI, Carp, Cwd, Exporter, File::Find,
5868 IO, IPC::Open3, Local::Maketext, Math::BigFloat, Math::BigInt,
5869 Math::BigRat, MIME::Base64, ODBM_File, POSIX, Shell, Socket, Storable,
5870 Switch, Sys::Syslog, Term::ANSIColor, Time::HiRes, Unicode::UCD, Win32,
5871 base, open, threads, utf8
5872
5873 =back
5874
5875 =item Performance Enhancements
5876
5877 =item Utility Changes
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 Future Directions
5888
5889 =item Platform Specific Problems
5890
5891 =item Reporting Bugs
5892
5893 =item SEE ALSO
5894
5895 =back
5896
5897 =head2 perl583delta - what is new for perl v5.8.3
5898
5899 =over 4
5900
5901 =item DESCRIPTION
5902
5903 =item Incompatible Changes
5904
5905 =item Core Enhancements
5906
5907 =item Modules and Pragmata
5908
5909 CGI, Cwd, Digest, Digest::MD5, Encode, File::Spec, FindBin, List::Util,
5910 Math::BigInt, PodParser, Pod::Perldoc, POSIX, Unicode::Collate,
5911 Unicode::Normalize, Test::Harness, threads::shared
5912
5913 =item Utility Changes
5914
5915 =item New Documentation
5916
5917 =item Installation and Configuration Improvements
5918
5919 =item Selected Bug Fixes
5920
5921 =item New or Changed Diagnostics
5922
5923 =item Changed Internals
5924
5925 =item Configuration and Building
5926
5927 =item Platform Specific Problems
5928
5929 =item Known Problems
5930
5931 =item Future Directions
5932
5933 =item Obituary
5934
5935 =item Reporting Bugs
5936
5937 =item SEE ALSO
5938
5939 =back
5940
5941 =head2 perl582delta - what is new for perl v5.8.2
5942
5943 =over 4
5944
5945 =item DESCRIPTION
5946
5947 =item Incompatible Changes
5948
5949 =item Core Enhancements
5950
5951 =over 4
5952
5953 =item Hash Randomisation
5954
5955 =item Threading
5956
5957 =back
5958
5959 =item Modules and Pragmata
5960
5961 =over 4
5962
5963 =item Updated Modules And Pragmata
5964
5965 Devel::PPPort, Digest::MD5, I18N::LangTags, libnet, MIME::Base64,
5966 Pod::Perldoc, strict, Tie::Hash, Time::HiRes, Unicode::Collate,
5967 Unicode::Normalize, UNIVERSAL
5968
5969 =back
5970
5971 =item Selected Bug Fixes
5972
5973 =item Changed Internals
5974
5975 =item Platform Specific Problems
5976
5977 =item Future Directions
5978
5979 =item Reporting Bugs
5980
5981 =item SEE ALSO
5982
5983 =back
5984
5985 =head2 perl581delta - what is new for perl v5.8.1
5986
5987 =over 4
5988
5989 =item DESCRIPTION
5990
5991 =item Incompatible Changes
5992
5993 =over 4
5994
5995 =item Hash Randomisation
5996
5997 =item UTF-8 On Filehandles No Longer Activated By Locale
5998
5999 =item Single-number v-strings are no longer v-strings before "=>"
6000
6001 =item (Win32) The -C Switch Has Been Repurposed
6002
6003 =item (Win32) The /d Switch Of cmd.exe
6004
6005 =back
6006
6007 =item Core Enhancements
6008
6009 =over 4
6010
6011 =item UTF-8 no longer default under UTF-8 locales
6012
6013 =item Unsafe signals again available
6014
6015 =item Tied Arrays with Negative Array Indices
6016
6017 =item local ${$x}
6018
6019 =item Unicode Character Database 4.0.0
6020
6021 =item Deprecation Warnings
6022
6023 =item Miscellaneous Enhancements
6024
6025 =back
6026
6027 =item Modules and Pragmata
6028
6029 =over 4
6030
6031 =item Updated Modules And Pragmata
6032
6033 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
6034 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
6035 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
6036 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
6037 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
6038 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
6039 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
6040 Win32::GetOSVersion
6041
6042 =back
6043
6044 =item Utility Changes
6045
6046 =item New Documentation
6047
6048 =item Installation and Configuration Improvements
6049
6050 =over 4
6051
6052 =item Platform-specific enhancements
6053
6054 =back
6055
6056 =item Selected Bug Fixes
6057
6058 =over 4
6059
6060 =item Closures, eval and lexicals
6061
6062 =item Generic fixes
6063
6064 =item Platform-specific fixes
6065
6066 =back
6067
6068 =item New or Changed Diagnostics
6069
6070 =over 4
6071
6072 =item Changed "A thread exited while %d threads were running"
6073
6074 =item Removed "Attempt to clear a restricted hash"
6075
6076 =item New "Illegal declaration of anonymous subroutine"
6077
6078 =item Changed "Invalid range "%s" in transliteration operator"
6079
6080 =item New "Missing control char name in \c"
6081
6082 =item New "Newline in left-justified string for %s"
6083
6084 =item New "Possible precedence problem on bitwise %c operator"
6085
6086 =item New "Pseudo-hashes are deprecated"
6087
6088 =item New "read() on %s filehandle %s"
6089
6090 =item New "5.005 threads are deprecated"
6091
6092 =item New "Tied variable freed while still in use"
6093
6094 =item New "To%s: illegal mapping '%s'"
6095
6096 =item New "Use of freed value in iteration"
6097
6098 =back
6099
6100 =item Changed Internals
6101
6102 =item New Tests
6103
6104 =item Known Problems
6105
6106 =over 4
6107
6108 =item Tied hashes in scalar context
6109
6110 =item Net::Ping 450_service and 510_ping_udp failures
6111
6112 =item B::C
6113
6114 =back
6115
6116 =item Platform Specific Problems
6117
6118 =over 4
6119
6120 =item EBCDIC Platforms
6121
6122 =item Cygwin 1.5 problems
6123
6124 =item HP-UX: HP cc warnings about sendfile and sendpath
6125
6126 =item IRIX: t/uni/tr_7jis.t falsely failing
6127
6128 =item Mac OS X: no usemymalloc
6129
6130 =item Tru64: No threaded builds with GNU cc (gcc)
6131
6132 =item Win32: sysopen, sysread, syswrite
6133
6134 =back
6135
6136 =item Future Directions
6137
6138 =item Reporting Bugs
6139
6140 =item SEE ALSO
6141
6142 =back
6143
6144 =head2 perl58delta - what is new for perl v5.8.0
6145
6146 =over 4
6147
6148 =item DESCRIPTION
6149
6150 =item Highlights In 5.8.0
6151
6152 =item Incompatible Changes
6153
6154 =over 4
6155
6156 =item Binary Incompatibility
6157
6158 =item 64-bit platforms and malloc
6159
6160 =item AIX Dynaloading
6161
6162 =item Attributes for C<my> variables now handled at run-time
6163
6164 =item Socket Extension Dynamic in VMS
6165
6166 =item IEEE-format Floating Point Default on OpenVMS Alpha
6167
6168 =item New Unicode Semantics (no more C<use utf8>, almost)
6169
6170 =item New Unicode Properties
6171
6172 =item REF(...) Instead Of SCALAR(...)
6173
6174 =item pack/unpack D/F recycled
6175
6176 =item glob() now returns filenames in alphabetical order
6177
6178 =item Deprecations
6179
6180 =back
6181
6182 =item Core Enhancements
6183
6184 =over 4
6185
6186 =item Unicode Overhaul
6187
6188 =item PerlIO is Now The Default
6189
6190 =item ithreads
6191
6192 =item Restricted Hashes
6193
6194 =item Safe Signals
6195
6196 =item Understanding of Numbers
6197
6198 =item Arrays now always interpolate into double-quoted strings [561]
6199
6200 =item Miscellaneous Changes
6201
6202 =back
6203
6204 =item Modules and Pragmata
6205
6206 =over 4
6207
6208 =item New Modules and Pragmata
6209
6210 =item Updated And Improved Modules and Pragmata
6211
6212 =back
6213
6214 =item Utility Changes
6215
6216 =item New Documentation
6217
6218 =item Performance Enhancements
6219
6220 =item Installation and Configuration Improvements
6221
6222 =over 4
6223
6224 =item Generic Improvements
6225
6226 =item New Or Improved Platforms
6227
6228 =back
6229
6230 =item Selected Bug Fixes
6231
6232 =over 4
6233
6234 =item Platform Specific Changes and Fixes
6235
6236 =back
6237
6238 =item New or Changed Diagnostics
6239
6240 =item Changed Internals
6241
6242 =item Security Vulnerability Closed [561]
6243
6244 =item New Tests
6245
6246 =item Known Problems
6247
6248 =over 4
6249
6250 =item The Compiler Suite Is Still Very Experimental
6251
6252 =item Localising Tied Arrays and Hashes Is Broken
6253
6254 =item Building Extensions Can Fail Because Of Largefiles
6255
6256 =item Modifying $_ Inside for(..)
6257
6258 =item mod_perl 1.26 Doesn't Build With Threaded Perl
6259
6260 =item lib/ftmp-security tests warn 'system possibly insecure'
6261
6262 =item libwww-perl (LWP) fails base/date #51
6263
6264 =item PDL failing some tests
6265
6266 =item Perl_get_sv
6267
6268 =item Self-tying Problems
6269
6270 =item ext/threads/t/libc
6271
6272 =item Failure of Thread (5.005-style) tests
6273
6274 =item Timing problems
6275
6276 =item Tied/Magical Array/Hash Elements Do Not Autovivify
6277
6278 =item Unicode in package/class and subroutine names does not work
6279
6280 =back
6281
6282 =item Platform Specific Problems
6283
6284 =over 4
6285
6286 =item AIX
6287
6288 =item Alpha systems with old gccs fail several tests
6289
6290 =item AmigaOS
6291
6292 =item BeOS
6293
6294 =item Cygwin "unable to remap"
6295
6296 =item Cygwin ndbm tests fail on FAT
6297
6298 =item DJGPP Failures
6299
6300 =item FreeBSD built with ithreads coredumps reading large directories
6301
6302 =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
6303
6304 =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
6305
6306 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
6307
6308 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
6309
6310 =item Linux With Sfio Fails op/misc Test 48
6311
6312 =item Mac OS X
6313
6314 =item Mac OS X dyld undefined symbols
6315
6316 =item OS/2 Test Failures
6317
6318 =item op/sprintf tests 91, 129, and 130
6319
6320 =item SCO
6321
6322 =item Solaris 2.5
6323
6324 =item Solaris x86 Fails Tests With -Duse64bitint
6325
6326 =item SUPER-UX (NEC SX)
6327
6328 =item Term::ReadKey not working on Win32
6329
6330 =item UNICOS/mk
6331
6332 =item UTS
6333
6334 =item VOS (Stratus)
6335
6336 =item VMS
6337
6338 =item Win32
6339
6340 =item XML::Parser not working
6341
6342 =item z/OS (OS/390)
6343
6344 =item Unicode Support on EBCDIC Still Spotty
6345
6346 =item Seen In Perl 5.7 But Gone Now
6347
6348 =back
6349
6350 =item Reporting Bugs
6351
6352 =item SEE ALSO
6353
6354 =item HISTORY
6355
6356 =back
6357
6358 =head2 perl573delta - what's new for perl v5.7.3
6359
6360 =over 4
6361
6362 =item DESCRIPTION
6363
6364 =item Changes
6365
6366 =item Reporting Bugs
6367
6368 =item SEE ALSO
6369
6370 =item HISTORY
6371
6372 =back
6373
6374 =head2 perl572delta - what's new for perl v5.7.2
6375
6376 =over 4
6377
6378 =item DESCRIPTION
6379
6380 =item Security Vulnerability Closed
6381
6382 =item Incompatible Changes
6383
6384 =over 4
6385
6386 =item 64-bit platforms and malloc
6387
6388 =item AIX Dynaloading
6389
6390 =item Socket Extension Dynamic in VMS
6391
6392 =item Different Definition of the Unicode Character Classes \p{In...}
6393
6394 =item Deprecations
6395
6396 =back
6397
6398 =item Core Enhancements
6399
6400 =item Modules and Pragmata
6401
6402 =over 4
6403
6404 =item New Modules and Distributions
6405
6406 =item Updated And Improved Modules and Pragmata
6407
6408 =back
6409
6410 =item Utility Changes
6411
6412 =item New Documentation
6413
6414 =item Installation and Configuration Improvements
6415
6416 =over 4
6417
6418 =item New Or Improved Platforms
6419
6420 =item Generic Improvements
6421
6422 =back
6423
6424 =item Selected Bug Fixes
6425
6426 =over 4
6427
6428 =item Platform Specific Changes and Fixes
6429
6430 =back
6431
6432 =item New or Changed Diagnostics
6433
6434 =item Source Code Enhancements
6435
6436 =over 4
6437
6438 =item MAGIC constants
6439
6440 =item Better commented code
6441
6442 =item Regex pre-/post-compilation items matched up
6443
6444 =item gcc -Wall
6445
6446 =back
6447
6448 =item New Tests
6449
6450 =item Known Problems
6451
6452 =over 4
6453
6454 =item AIX
6455
6456 =item Amiga Perl Invoking Mystery
6457
6458 =item lib/ftmp-security tests warn 'system possibly insecure'
6459
6460 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
6461
6462 =item HP-UX lib/io_multihomed Fails When LP64-Configured
6463
6464 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
6465
6466 =item Linux With Sfio Fails op/misc Test 48
6467
6468 =item OS/390
6469
6470 =item op/sprintf tests 129 and 130
6471
6472 =item  Failure of Thread tests
6473
6474 =item UNICOS
6475
6476 =item UTS
6477
6478 =item VMS
6479
6480 =item Win32
6481
6482 =item Localising a Tied Variable Leaks Memory
6483
6484 =item Self-tying of Arrays and Hashes Is Forbidden
6485
6486 =item Variable Attributes are not Currently Usable for Tieing
6487
6488 =item Building Extensions Can Fail Because Of Largefiles
6489
6490 =item The Compiler Suite Is Still Experimental
6491
6492 =item The Long Double Support is Still Experimental
6493
6494 =back
6495
6496 =item Reporting Bugs
6497
6498 =item SEE ALSO
6499
6500 =item HISTORY
6501
6502 =back
6503
6504 =head2 perl571delta - what's new for perl v5.7.1
6505
6506 =over 4
6507
6508 =item DESCRIPTION
6509
6510 =item Security Vulnerability Closed
6511
6512 =item Incompatible Changes
6513
6514 =item Core Enhancements
6515
6516 =over 4
6517
6518 =item AUTOLOAD Is Now Lvaluable
6519
6520 =item PerlIO is Now The Default
6521
6522 =item Signals Are Now Safe
6523
6524 =back
6525
6526 =item Modules and Pragmata
6527
6528 =over 4
6529
6530 =item New Modules
6531
6532 =item Updated And Improved Modules and Pragmata
6533
6534 =back
6535
6536 =item Performance Enhancements
6537
6538 =item Utility Changes
6539
6540 =item New Documentation
6541
6542 =over 4
6543
6544 =item perlclib
6545
6546 =item perliol
6547
6548 =item README.aix
6549
6550 =item README.bs2000
6551
6552 =item README.macos
6553
6554 =item README.mpeix
6555
6556 =item README.solaris
6557
6558 =item README.vos
6559
6560 =item Porting/repository.pod
6561
6562 =back
6563
6564 =item Installation and Configuration Improvements
6565
6566 =over 4
6567
6568 =item New Or Improved Platforms
6569
6570 =item Generic Improvements
6571
6572 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
6573 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
6574 d_strtoq, d_u32align, d_ualarm, d_usleep
6575
6576 =back
6577
6578 =item Selected Bug Fixes
6579
6580 =over 4
6581
6582 =item Platform Specific Changes and Fixes
6583
6584 =back
6585
6586 =item New or Changed Diagnostics
6587
6588 =item Changed Internals
6589
6590 =item New Tests
6591
6592 =item Known Problems
6593
6594 =over 4
6595
6596 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
6597
6598 =item lib/ftmp-security tests warn 'system possibly insecure'
6599
6600 =item lib/io_multihomed Fails In LP64-Configured HP-UX
6601
6602 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
6603
6604 =item lib/b test 19
6605
6606 =item Linux With Sfio Fails op/misc Test 48
6607
6608 =item sigaction test 13 in VMS
6609
6610 =item sprintf tests 129 and 130
6611
6612 =item  Failure of Thread tests
6613
6614 =item Localising a Tied Variable Leaks Memory
6615
6616 =item Self-tying of Arrays and Hashes Is Forbidden
6617
6618 =item Building Extensions Can Fail Because Of Largefiles
6619
6620 =item The Compiler Suite Is Still Experimental
6621
6622 =back
6623
6624 =item Reporting Bugs
6625
6626 =item SEE ALSO
6627
6628 =item HISTORY
6629
6630 =back
6631
6632 =head2 perl570delta - what's new for perl v5.7.0
6633
6634 =over 4
6635
6636 =item DESCRIPTION
6637
6638 =item Security Vulnerability Closed
6639
6640 =item Incompatible Changes
6641
6642 =item Core Enhancements
6643
6644 =item Modules and Pragmata
6645
6646 =over 4
6647
6648 =item New Modules
6649
6650 =item Updated And Improved Modules and Pragmata
6651
6652 =back
6653
6654 =item Utility Changes
6655
6656 =item New Documentation
6657
6658 =item Performance Enhancements
6659
6660 =item Installation and Configuration Improvements
6661
6662 =over 4
6663
6664 =item Generic Improvements
6665
6666 =back
6667
6668 =item Selected Bug Fixes
6669
6670 =over 4
6671
6672 =item Platform Specific Changes and Fixes
6673
6674 =back
6675
6676 =item New or Changed Diagnostics
6677
6678 =item Changed Internals
6679
6680 =item Known Problems
6681
6682 =over 4
6683
6684 =item Unicode Support Still Far From Perfect
6685
6686 =item EBCDIC Still A Lost Platform
6687
6688 =item Building Extensions Can Fail Because Of Largefiles
6689
6690 =item ftmp-security tests warn 'system possibly insecure'
6691
6692 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
6693
6694 =item Long Doubles Still Don't Work In Solaris
6695
6696 =item Linux With Sfio Fails op/misc Test 48
6697
6698 =item Storable tests fail in some platforms
6699
6700 =item Threads Are Still Experimental
6701
6702 =item The Compiler Suite Is Still Experimental
6703
6704 =back
6705
6706 =item Reporting Bugs
6707
6708 =item SEE ALSO
6709
6710 =item HISTORY
6711
6712 =back
6713
6714 =head2 perl561delta - what's new for perl v5.6.x
6715
6716 =over 4
6717
6718 =item DESCRIPTION
6719
6720 =item Summary of changes between 5.6.0 and 5.6.1
6721
6722 =over 4
6723
6724 =item Security Issues
6725
6726 =item Core bug fixes
6727
6728 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
6729 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
6730 references to special variables, Lexical warnings, Spurious warnings and
6731 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
6732 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
6733 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
6734 Module;>, Tests
6735
6736 =item Core features
6737
6738 =item Configuration issues
6739
6740 =item Documentation
6741
6742 =item Bundled modules
6743
6744 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
6745 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
6746 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
6747 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
6748
6749 =item Platform-specific improvements
6750
6751 NCR MP-RAS, NonStop-UX
6752
6753 =back
6754
6755 =item Core Enhancements
6756
6757 =over 4
6758
6759 =item Interpreter cloning, threads, and concurrency
6760
6761 =item Lexically scoped warning categories
6762
6763 =item Unicode and UTF-8 support
6764
6765 =item Support for interpolating named characters
6766
6767 =item "our" declarations
6768
6769 =item Support for strings represented as a vector of ordinals
6770
6771 =item Improved Perl version numbering system
6772
6773 =item New syntax for declaring subroutine attributes
6774
6775 =item File and directory handles can be autovivified
6776
6777 =item open() with more than two arguments
6778
6779 =item 64-bit support
6780
6781 =item Large file support
6782
6783 =item Long doubles
6784
6785 =item "more bits"
6786
6787 =item Enhanced support for sort() subroutines
6788
6789 =item C<sort $coderef @foo> allowed
6790
6791 =item File globbing implemented internally
6792
6793 =item Support for CHECK blocks
6794
6795 =item POSIX character class syntax [: :] supported
6796
6797 =item Better pseudo-random number generator
6798
6799 =item Improved C<qw//> operator
6800
6801 =item Better worst-case behavior of hashes
6802
6803 =item pack() format 'Z' supported
6804
6805 =item pack() format modifier '!' supported
6806
6807 =item pack() and unpack() support counted strings
6808
6809 =item Comments in pack() templates
6810
6811 =item Weak references
6812
6813 =item Binary numbers supported
6814
6815 =item Lvalue subroutines
6816
6817 =item Some arrows may be omitted in calls through references
6818
6819 =item Boolean assignment operators are legal lvalues
6820
6821 =item exists() is supported on subroutine names
6822
6823 =item exists() and delete() are supported on array elements
6824
6825 =item Pseudo-hashes work better
6826
6827 =item Automatic flushing of output buffers
6828
6829 =item Better diagnostics on meaningless filehandle operations
6830
6831 =item Where possible, buffered data discarded from duped input filehandle
6832
6833 =item eof() has the same old magic as <>
6834
6835 =item binmode() can be used to set :crlf and :raw modes
6836
6837 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6838
6839 =item system(), backticks and pipe open now reflect exec() failure
6840
6841 =item Improved diagnostics
6842
6843 =item Diagnostics follow STDERR
6844
6845 =item More consistent close-on-exec behavior
6846
6847 =item syswrite() ease-of-use
6848
6849 =item Better syntax checks on parenthesized unary operators
6850
6851 =item Bit operators support full native integer width
6852
6853 =item Improved security features
6854
6855 =item More functional bareword prototype (*)
6856
6857 =item C<require> and C<do> may be overridden
6858
6859 =item $^X variables may now have names longer than one character
6860
6861 =item New variable $^C reflects C<-c> switch
6862
6863 =item New variable $^V contains Perl version as a string
6864
6865 =item Optional Y2K warnings
6866
6867 =item Arrays now always interpolate into double-quoted strings
6868
6869 =back
6870
6871 =item Modules and Pragmata
6872
6873 =over 4
6874
6875 =item Modules
6876
6877 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6878 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6879 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6880 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6881 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6882 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6883 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6884 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6885
6886 =item Pragmata
6887
6888 =back
6889
6890 =item Utility Changes
6891
6892 =over 4
6893
6894 =item dprofpp
6895
6896 =item find2perl
6897
6898 =item h2xs
6899
6900 =item perlcc
6901
6902 =item perldoc
6903
6904 =item The Perl Debugger
6905
6906 =back
6907
6908 =item Improved Documentation
6909
6910 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6911 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6912 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6913 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6914
6915 =item Performance enhancements
6916
6917 =over 4
6918
6919 =item Simple sort() using { $a <=> $b } and the like are optimized
6920
6921 =item Optimized assignments to lexical variables
6922
6923 =item Faster subroutine calls
6924
6925 =item delete(), each(), values() and hash iteration are faster
6926
6927 =back
6928
6929 =item Installation and Configuration Improvements
6930
6931 =over 4
6932
6933 =item -Dusethreads means something different
6934
6935 =item New Configure flags
6936
6937 =item Threadedness and 64-bitness now more daring
6938
6939 =item Long Doubles
6940
6941 =item -Dusemorebits
6942
6943 =item -Duselargefiles
6944
6945 =item installusrbinperl
6946
6947 =item SOCKS support
6948
6949 =item C<-A> flag
6950
6951 =item Enhanced Installation Directories
6952
6953 =item gcc automatically tried if 'cc' does not seem to be working
6954
6955 =back
6956
6957 =item Platform specific changes
6958
6959 =over 4
6960
6961 =item Supported platforms
6962
6963 =item DOS
6964
6965 =item OS390 (OpenEdition MVS)
6966
6967 =item VMS
6968
6969 =item Win32
6970
6971 =back
6972
6973 =item Significant bug fixes
6974
6975 =over 4
6976
6977 =item <HANDLE> on empty files
6978
6979 =item C<eval '...'> improvements
6980
6981 =item All compilation errors are true errors
6982
6983 =item Implicitly closed filehandles are safer
6984
6985 =item Behavior of list slices is more consistent
6986
6987 =item C<(\$)> prototype and C<$foo{a}>
6988
6989 =item C<goto &sub> and AUTOLOAD
6990
6991 =item C<-bareword> allowed under C<use integer>
6992
6993 =item Failures in DESTROY()
6994
6995 =item Locale bugs fixed
6996
6997 =item Memory leaks
6998
6999 =item Spurious subroutine stubs after failed subroutine calls
7000
7001 =item Taint failures under C<-U>
7002
7003 =item END blocks and the C<-c> switch
7004
7005 =item Potential to leak DATA filehandles
7006
7007 =back
7008
7009 =item New or Changed Diagnostics
7010
7011 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
7012 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
7013 / cannot take a count, / must be followed by a, A or Z, / must be followed
7014 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
7015 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
7016 passed through, /%s/ should probably be written as "%s", %s() called too
7017 early to check prototype, %s argument is not a HASH or ARRAY element, %s
7018 argument is not a HASH or ARRAY element or slice, %s argument is not a
7019 subroutine name, %s package attribute may clash with future reserved word:
7020 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
7021 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
7022 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
7023 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
7024 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
7025 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
7026 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
7027 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
7028 weaken a nonreference, Character class [:%s:] unknown, Character class
7029 syntax [%s] belongs inside character classes, Constant is not %s reference,
7030 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
7031 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
7032 "local" instead of "our"?), Document contains no data, entering effective
7033 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
7034 output, flock() on closed filehandle %s, Global symbol "%s" requires
7035 explicit package name, Hexadecimal number > 0xffffffff non-portable,
7036 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
7037 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
7038 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
7039 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
7040 separator character %s in attribute list, Invalid separator character %s in
7041 subroutine attribute list, leaving effective %s failed, Lvalue subs
7042 returning %s not implemented yet, Method %s not permitted, Missing
7043 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
7044 No %s specified for -%c, No package name allowed for variable %s in "our",
7045 No space allowed after -%c, no UTC offset information; assuming local time
7046 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
7047 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
7048 around "%s" list, Possible unintended interpolation of %s in string,
7049 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
7050 instead, Premature end of script headers, Repeat count in pack overflows,
7051 Repeat count in unpack overflows, realloc() of freed memory ignored,
7052 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
7053 zero-length expression, switching effective %s is not implemented, This
7054 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
7055 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
7056 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
7057 escape \\%c passed through, Unterminated attribute parameter in attribute
7058 list, Unterminated attribute list, Unterminated attribute parameter in
7059 subroutine attribute list, Unterminated subroutine attribute list, Value of
7060 CLI symbol "%s" too long, Version number must be a constant number
7061
7062 =item New tests
7063
7064 =item Incompatible Changes
7065
7066 =over 4
7067
7068 =item Perl Source Incompatibilities
7069
7070 CHECK is a new keyword, Treatment of list slices of undef has changed,
7071 Format of $English::PERL_VERSION is different, Literals of the form
7072 C<1.2.3> parse differently, Possibly changed pseudo-random number
7073 generator, Hashing function for hash keys has changed, C<undef> fails on
7074 read only values, Close-on-exec bit may be set on pipe and socket handles,
7075 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
7076 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
7077 Text of some diagnostic output has changed, C<%@> has been removed,
7078 Parenthesized not() behaves like a list operator, Semantics of bareword
7079 prototype C<(*)> have changed, Semantics of bit operators may have changed
7080 on 64-bit platforms, More builtins taint their results
7081
7082 =item C Source Incompatibilities
7083
7084 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
7085
7086 =item Compatible C Source API Changes
7087
7088 C<PATCHLEVEL> is now C<PERL_VERSION>
7089
7090 =item Binary Incompatibilities
7091
7092 =back
7093
7094 =item Known Problems
7095
7096 =over 4
7097
7098 =item Localizing a tied hash element may leak memory
7099
7100 =item Known test failures
7101
7102 =item EBCDIC platforms not fully supported
7103
7104 =item UNICOS/mk CC failures during Configure run
7105
7106 =item Arrow operator and arrays
7107
7108 =item Experimental features
7109
7110 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
7111 pseudo-hash data type, The Compiler suite, Internal implementation of file
7112 globbing, The DB module, The regular expression code constructs:
7113
7114 =back
7115
7116 =item Obsolete Diagnostics
7117
7118 Character class syntax [: :] is reserved for future extensions, Ill-formed
7119 logical name |%s| in prime_env_iter, In string, @%s now must be written as
7120 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
7121 to mean "${$}<digit>" is deprecated
7122
7123 =item Reporting Bugs
7124
7125 =item SEE ALSO
7126
7127 =item HISTORY
7128
7129 =back
7130
7131 =head2 perl56delta - what's new for perl v5.6.0
7132
7133 =over 4
7134
7135 =item DESCRIPTION
7136
7137 =item Core Enhancements
7138
7139 =over 4
7140
7141 =item Interpreter cloning, threads, and concurrency
7142
7143 =item Lexically scoped warning categories
7144
7145 =item Unicode and UTF-8 support
7146
7147 =item Support for interpolating named characters
7148
7149 =item "our" declarations
7150
7151 =item Support for strings represented as a vector of ordinals
7152
7153 =item Improved Perl version numbering system
7154
7155 =item New syntax for declaring subroutine attributes
7156
7157 =item File and directory handles can be autovivified
7158
7159 =item open() with more than two arguments
7160
7161 =item 64-bit support
7162
7163 =item Large file support
7164
7165 =item Long doubles
7166
7167 =item "more bits"
7168
7169 =item Enhanced support for sort() subroutines
7170
7171 =item C<sort $coderef @foo> allowed
7172
7173 =item File globbing implemented internally
7174
7175 =item Support for CHECK blocks
7176
7177 =item POSIX character class syntax [: :] supported
7178
7179 =item Better pseudo-random number generator
7180
7181 =item Improved C<qw//> operator
7182
7183 =item Better worst-case behavior of hashes
7184
7185 =item pack() format 'Z' supported
7186
7187 =item pack() format modifier '!' supported
7188
7189 =item pack() and unpack() support counted strings
7190
7191 =item Comments in pack() templates
7192
7193 =item Weak references
7194
7195 =item Binary numbers supported
7196
7197 =item Lvalue subroutines
7198
7199 =item Some arrows may be omitted in calls through references
7200
7201 =item Boolean assignment operators are legal lvalues
7202
7203 =item exists() is supported on subroutine names
7204
7205 =item exists() and delete() are supported on array elements
7206
7207 =item Pseudo-hashes work better
7208
7209 =item Automatic flushing of output buffers
7210
7211 =item Better diagnostics on meaningless filehandle operations
7212
7213 =item Where possible, buffered data discarded from duped input filehandle
7214
7215 =item eof() has the same old magic as <>
7216
7217 =item binmode() can be used to set :crlf and :raw modes
7218
7219 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
7220
7221 =item system(), backticks and pipe open now reflect exec() failure
7222
7223 =item Improved diagnostics
7224
7225 =item Diagnostics follow STDERR
7226
7227 =item More consistent close-on-exec behavior
7228
7229 =item syswrite() ease-of-use
7230
7231 =item Better syntax checks on parenthesized unary operators
7232
7233 =item Bit operators support full native integer width
7234
7235 =item Improved security features
7236
7237 =item More functional bareword prototype (*)
7238
7239 =item C<require> and C<do> may be overridden
7240
7241 =item $^X variables may now have names longer than one character
7242
7243 =item New variable $^C reflects C<-c> switch
7244
7245 =item New variable $^V contains Perl version as a string
7246
7247 =item Optional Y2K warnings
7248
7249 =item Arrays now always interpolate into double-quoted strings
7250
7251 =back
7252
7253 =item Modules and Pragmata
7254
7255 =over 4
7256
7257 =item Modules
7258
7259 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
7260 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
7261 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
7262 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
7263 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
7264 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
7265 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
7266 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
7267
7268 =item Pragmata
7269
7270 =back
7271
7272 =item Utility Changes
7273
7274 =over 4
7275
7276 =item dprofpp
7277
7278 =item find2perl
7279
7280 =item h2xs
7281
7282 =item perlcc
7283
7284 =item perldoc
7285
7286 =item The Perl Debugger
7287
7288 =back
7289
7290 =item Improved Documentation
7291
7292 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
7293 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
7294 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
7295 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
7296
7297 =item Performance enhancements
7298
7299 =over 4
7300
7301 =item Simple sort() using { $a <=> $b } and the like are optimized
7302
7303 =item Optimized assignments to lexical variables
7304
7305 =item Faster subroutine calls
7306
7307 =item delete(), each(), values() and hash iteration are faster
7308
7309 =back
7310
7311 =item Installation and Configuration Improvements
7312
7313 =over 4
7314
7315 =item -Dusethreads means something different
7316
7317 =item New Configure flags
7318
7319 =item Threadedness and 64-bitness now more daring
7320
7321 =item Long Doubles
7322
7323 =item -Dusemorebits
7324
7325 =item -Duselargefiles
7326
7327 =item installusrbinperl
7328
7329 =item SOCKS support
7330
7331 =item C<-A> flag
7332
7333 =item Enhanced Installation Directories
7334
7335 =back
7336
7337 =item Platform specific changes
7338
7339 =over 4
7340
7341 =item Supported platforms
7342
7343 =item DOS
7344
7345 =item OS390 (OpenEdition MVS)
7346
7347 =item VMS
7348
7349 =item Win32
7350
7351 =back
7352
7353 =item Significant bug fixes
7354
7355 =over 4
7356
7357 =item <HANDLE> on empty files
7358
7359 =item C<eval '...'> improvements
7360
7361 =item All compilation errors are true errors
7362
7363 =item Implicitly closed filehandles are safer
7364
7365 =item Behavior of list slices is more consistent
7366
7367 =item C<(\$)> prototype and C<$foo{a}>
7368
7369 =item C<goto &sub> and AUTOLOAD
7370
7371 =item C<-bareword> allowed under C<use integer>
7372
7373 =item Failures in DESTROY()
7374
7375 =item Locale bugs fixed
7376
7377 =item Memory leaks
7378
7379 =item Spurious subroutine stubs after failed subroutine calls
7380
7381 =item Taint failures under C<-U>
7382
7383 =item END blocks and the C<-c> switch
7384
7385 =item Potential to leak DATA filehandles
7386
7387 =back
7388
7389 =item New or Changed Diagnostics
7390
7391 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
7392 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
7393 / cannot take a count, / must be followed by a, A or Z, / must be followed
7394 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
7395 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
7396 passed through, /%s/ should probably be written as "%s", %s() called too
7397 early to check prototype, %s argument is not a HASH or ARRAY element, %s
7398 argument is not a HASH or ARRAY element or slice, %s argument is not a
7399 subroutine name, %s package attribute may clash with future reserved word:
7400 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
7401 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
7402 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
7403 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
7404 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
7405 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
7406 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
7407 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
7408 weaken a nonreference, Character class [:%s:] unknown, Character class
7409 syntax [%s] belongs inside character classes, Constant is not %s reference,
7410 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
7411 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
7412 "local" instead of "our"?), Document contains no data, entering effective
7413 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
7414 output, flock() on closed filehandle %s, Global symbol "%s" requires
7415 explicit package name, Hexadecimal number > 0xffffffff non-portable,
7416 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
7417 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
7418 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
7419 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
7420 separator character %s in attribute list, Invalid separator character %s in
7421 subroutine attribute list, leaving effective %s failed, Lvalue subs
7422 returning %s not implemented yet, Method %s not permitted, Missing
7423 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
7424 No %s specified for -%c, No package name allowed for variable %s in "our",
7425 No space allowed after -%c, no UTC offset information; assuming local time
7426 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
7427 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
7428 around "%s" list, Possible unintended interpolation of %s in string,
7429 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
7430 instead, Premature end of script headers, Repeat count in pack overflows,
7431 Repeat count in unpack overflows, realloc() of freed memory ignored,
7432 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
7433 zero-length expression, switching effective %s is not implemented, This
7434 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
7435 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
7436 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
7437 escape \\%c passed through, Unterminated attribute parameter in attribute
7438 list, Unterminated attribute list, Unterminated attribute parameter in
7439 subroutine attribute list, Unterminated subroutine attribute list, Value of
7440 CLI symbol "%s" too long, Version number must be a constant number
7441
7442 =item New tests
7443
7444 =item Incompatible Changes
7445
7446 =over 4
7447
7448 =item Perl Source Incompatibilities
7449
7450 CHECK is a new keyword, Treatment of list slices of undef has changed,
7451 Format of $English::PERL_VERSION is different, Literals of the form
7452 C<1.2.3> parse differently, Possibly changed pseudo-random number
7453 generator, Hashing function for hash keys has changed, C<undef> fails on
7454 read only values, Close-on-exec bit may be set on pipe and socket handles,
7455 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
7456 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
7457 Text of some diagnostic output has changed, C<%@> has been removed,
7458 Parenthesized not() behaves like a list operator, Semantics of bareword
7459 prototype C<(*)> have changed, Semantics of bit operators may have changed
7460 on 64-bit platforms, More builtins taint their results
7461
7462 =item C Source Incompatibilities
7463
7464 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
7465
7466 =item Compatible C Source API Changes
7467
7468 C<PATCHLEVEL> is now C<PERL_VERSION>
7469
7470 =item Binary Incompatibilities
7471
7472 =back
7473
7474 =item Known Problems
7475
7476 =over 4
7477
7478 =item Thread test failures
7479
7480 =item EBCDIC platforms not supported
7481
7482 =item In 64-bit HP-UX the lib/io_multihomed test may hang
7483
7484 =item NEXTSTEP 3.3 POSIX test failure
7485
7486 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
7487 gcc
7488
7489 =item UNICOS/mk CC failures during Configure run
7490
7491 =item Arrow operator and arrays
7492
7493 =item Experimental features
7494
7495 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
7496 pseudo-hash data type, The Compiler suite, Internal implementation of file
7497 globbing, The DB module, The regular expression code constructs:
7498
7499 =back
7500
7501 =item Obsolete Diagnostics
7502
7503 Character class syntax [: :] is reserved for future extensions, Ill-formed
7504 logical name |%s| in prime_env_iter, In string, @%s now must be written as
7505 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
7506 to mean "${$}<digit>" is deprecated
7507
7508 =item Reporting Bugs
7509
7510 =item SEE ALSO
7511
7512 =item HISTORY
7513
7514 =back
7515
7516 =head2 perl5005delta - what's new for perl5.005
7517
7518 =over 4
7519
7520 =item DESCRIPTION
7521
7522 =item About the new versioning system
7523
7524 =item Incompatible Changes
7525
7526 =over 4
7527
7528 =item WARNING:  This version is not binary compatible with Perl 5.004.
7529
7530 =item Default installation structure has changed
7531
7532 =item Perl Source Compatibility
7533
7534 =item C Source Compatibility
7535
7536 =item Binary Compatibility
7537
7538 =item Security fixes may affect compatibility
7539
7540 =item Relaxed new mandatory warnings introduced in 5.004
7541
7542 =item Licensing
7543
7544 =back
7545
7546 =item Core Changes
7547
7548 =over 4
7549
7550 =item Threads
7551
7552 =item Compiler
7553
7554 =item Regular Expressions
7555
7556 Many new and improved optimizations, Many bug fixes, New regular expression
7557 constructs, New operator for precompiled regular expressions, Other
7558 improvements, Incompatible changes
7559
7560 =item   Improved malloc()
7561
7562 =item Quicksort is internally implemented
7563
7564 =item Reliable signals
7565
7566 =item Reliable stack pointers
7567
7568 =item More generous treatment of carriage returns
7569
7570 =item Memory leaks
7571
7572 =item Better support for multiple interpreters
7573
7574 =item Behavior of local() on array and hash elements is now well-defined
7575
7576 =item C<%!> is transparently tied to the L<Errno> module
7577
7578 =item Pseudo-hashes are supported
7579
7580 =item C<EXPR foreach EXPR> is supported
7581
7582 =item Keywords can be globally overridden
7583
7584 =item C<$^E> is meaningful on Win32
7585
7586 =item C<foreach (1..1000000)> optimized
7587
7588 =item C<Foo::> can be used as implicitly quoted package name
7589
7590 =item C<exists $Foo::{Bar::}> tests existence of a package
7591
7592 =item Better locale support
7593
7594 =item Experimental support for 64-bit platforms
7595
7596 =item prototype() returns useful results on builtins
7597
7598 =item Extended support for exception handling
7599
7600 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
7601
7602 =item All C<printf> format conversions are handled internally
7603
7604 =item New C<INIT> keyword
7605
7606 =item New C<lock> keyword
7607
7608 =item New C<qr//> operator
7609
7610 =item C<our> is now a reserved word
7611
7612 =item Tied arrays are now fully supported
7613
7614 =item Tied handles support is better
7615
7616 =item 4th argument to substr
7617
7618 =item Negative LENGTH argument to splice
7619
7620 =item Magic lvalues are now more magical
7621
7622 =item <> now reads in records
7623
7624 =back
7625
7626 =item Supported Platforms
7627
7628 =over 4
7629
7630 =item New Platforms
7631
7632 =item Changes in existing support
7633
7634 =back
7635
7636 =item Modules and Pragmata
7637
7638 =over 4
7639
7640 =item New Modules
7641
7642 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
7643 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
7644 Thread, attrs, fields, re
7645
7646 =item Changes in existing modules
7647
7648 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
7649 MakeMaker, CPAN, Cwd
7650
7651 =back
7652
7653 =item Utility Changes
7654
7655 =item Documentation Changes
7656
7657 =item New Diagnostics
7658
7659 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
7660 while coercing array into hash, Bareword "%s" refers to nonexistent
7661 package, Can't call method "%s" on an undefined value, Can't check
7662 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
7663 goto subroutine from an eval-string, Can't localize pseudo-hash element,
7664 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
7665 for "%s", Character class syntax [. .] is reserved for future extensions,
7666 Character class syntax [: :] is reserved for future extensions, Character
7667 class syntax [= =] is reserved for future extensions, %s: Eval-group in
7668 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
7669 Eval-group not allowed at run time, Explicit blessing to '' (assuming
7670 package main), Illegal hex digit ignored, No such array field, No such
7671 field "%s" in variable %s of type %s, Out of memory during ridiculously
7672 large request, Range iterator outside integer range, Recursive inheritance
7673 detected while looking for method '%s' %s, Reference found where even-sized
7674 list expected, Undefined value assigned to typeglob, Use of reserved word
7675 "%s" is deprecated, perl: warning: Setting locale failed
7676
7677 =item Obsolete Diagnostics
7678
7679 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
7680 temporary file, regexp too big
7681
7682 =item Configuration Changes
7683
7684 =item BUGS
7685
7686 =item SEE ALSO
7687
7688 =item HISTORY
7689
7690 =back
7691
7692 =head2 perl5004delta - what's new for perl5.004
7693
7694 =over 4
7695
7696 =item DESCRIPTION
7697
7698 =item Supported Environments
7699
7700 =item Core Changes
7701
7702 =over 4
7703
7704 =item List assignment to %ENV works
7705
7706 =item Change to "Can't locate Foo.pm in @INC" error
7707
7708 =item Compilation option: Binary compatibility with 5.003
7709
7710 =item $PERL5OPT environment variable
7711
7712 =item Limitations on B<-M>, B<-m>, and B<-T> options
7713
7714 =item More precise warnings
7715
7716 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
7717
7718 =item Previously deprecated %OVERLOAD is no longer usable
7719
7720 =item Subroutine arguments created only when they're modified
7721
7722 =item Group vector changeable with C<$)>
7723
7724 =item Fixed parsing of $$<digit>, &$<digit>, etc.
7725
7726 =item Fixed localization of $<digit>, $&, etc.
7727
7728 =item No resetting of $. on implicit close
7729
7730 =item C<wantarray> may return undef
7731
7732 =item C<eval EXPR> determines value of EXPR in scalar context
7733
7734 =item Changes to tainting checks
7735
7736 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
7737 spawning if tainted $TERM doesn't look like a terminal name
7738
7739 =item New Opcode module and revised Safe module
7740
7741 =item Embedding improvements
7742
7743 =item Internal change: FileHandle class based on IO::* classes
7744
7745 =item Internal change: PerlIO abstraction interface
7746
7747 =item New and changed syntax
7748
7749 $coderef->(PARAMS)
7750
7751 =item New and changed builtin constants
7752
7753 __PACKAGE__
7754
7755 =item New and changed builtin variables
7756
7757 $^E, $^H, $^M
7758
7759 =item New and changed builtin functions
7760
7761 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
7762 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
7763 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
7764 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
7765 nested C<sub{}> closures work now, formats work right on changing lexicals
7766
7767 =item New builtin methods
7768
7769 isa(CLASS), can(METHOD), VERSION( [NEED] )
7770
7771 =item TIEHANDLE now supported
7772
7773 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
7774 LIST, READLINE this, GETC this, DESTROY this
7775
7776 =item Malloc enhancements
7777
7778 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
7779
7780 =item Miscellaneous efficiency enhancements
7781
7782 =back
7783
7784 =item Support for More Operating Systems
7785
7786 =over 4
7787
7788 =item Win32
7789
7790 =item Plan 9
7791
7792 =item QNX
7793
7794 =item AmigaOS
7795
7796 =back
7797
7798 =item Pragmata
7799
7800 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
7801 constant NAME => VALUE, use locale, use ops, use vmsish
7802
7803 =item Modules
7804
7805 =over 4
7806
7807 =item Required Updates
7808
7809 =item Installation directories
7810
7811 =item Module information summary
7812
7813 =item Fcntl
7814
7815 =item IO
7816
7817 =item Math::Complex
7818
7819 =item Math::Trig
7820
7821 =item DB_File
7822
7823 =item Net::Ping
7824
7825 =item Object-oriented overrides for builtin operators
7826
7827 =back
7828
7829 =item Utility Changes
7830
7831 =over 4
7832
7833 =item pod2html
7834
7835 Sends converted HTML to standard output
7836
7837 =item xsubpp
7838
7839 C<void> XSUBs now default to returning nothing
7840
7841 =back
7842
7843 =item C Language API Changes
7844
7845 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
7846 manipulating hashes
7847
7848 =item Documentation Changes
7849
7850 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
7851 L<perlmodlib>, L<perldebug>, L<perlsec>
7852
7853 =item New Diagnostics
7854
7855 "my" variable %s masks earlier declaration in same scope, %s argument is
7856 not a HASH element or slice, Allocation too large: %lx, Allocation too
7857 large, Applying %s to %s will act on scalar(%s), Attempt to free
7858 nonexistent shared string, Attempt to use reference as lvalue in substr,
7859 Bareword "%s" refers to nonexistent package, Can't redefine active sort
7860 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
7861 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
7862 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
7863 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
7864 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
7865 %s, Integer overflow in hex number, Integer overflow in octal number,
7866 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
7867 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
7868 possible typo, Null picture in formline, Offset outside string, Out of
7869 memory!, Out of memory during request for %s, panic: frexp, Possible
7870 attempt to put comments in qw() list, Possible attempt to separate words
7871 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
7872 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
7873 option, untie attempted while %d inner references still exist, Unrecognized
7874 character %s, Unsupported function fork, Use of "$$<digit>" to mean
7875 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
7876 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
7877 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
7878 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
7879 long, Process terminated by SIG%s
7880
7881 =item BUGS
7882
7883 =item SEE ALSO
7884
7885 =item HISTORY
7886
7887 =back
7888
7889 =head2 perlartistic - the Perl Artistic License
7890
7891 =over 4
7892
7893 =item SYNOPSIS
7894
7895 =item DESCRIPTION
7896
7897 =item The "Artistic License"
7898
7899 =over 4
7900
7901 =item Preamble
7902
7903 =item Definitions
7904
7905 "Package", "Standard Version", "Copyright Holder", "You", "Reasonable
7906 copying fee", "Freely Available"
7907
7908 =item Conditions
7909
7910 a), b), c), d), a), b), c), d)
7911
7912 =back
7913
7914 =back
7915
7916 =head2 perlgpl - the GNU General Public License, version 2
7917
7918 =over 4
7919
7920 =item SYNOPSIS
7921
7922 =back
7923
7924 =over 4
7925
7926 =item DESCRIPTION
7927
7928 =item GNU GENERAL PUBLIC LICENSE
7929
7930 =back
7931
7932 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
7933
7934 =over 4
7935
7936 =item DESCRIPTION
7937
7938 =over 4
7939
7940 =item Compiling Perl 5 on AIX
7941
7942 =item OS level
7943
7944 =item Building Dynamic Extensions on AIX
7945
7946 =item The IBM ANSI C Compiler
7947
7948 =item The usenm option
7949
7950 =item Using GNU's gcc for building perl
7951
7952 =item Using Large Files with Perl
7953
7954 =item Threaded Perl
7955
7956 =item 64-bit Perl
7957
7958 =item AIX 4.2 and extensions using C++ with statics
7959
7960 =back
7961
7962 =item AUTHOR
7963
7964 =item DATE
7965
7966 =back
7967
7968 =head2 perlamiga - Perl under Amiga OS
7969
7970 =over 4
7971
7972 =item NOTE
7973
7974 =item SYNOPSIS
7975
7976 =back
7977
7978 =over 4
7979
7980 =item DESCRIPTION
7981
7982 =over 4
7983
7984 =item Prerequisites for Compiling Perl on AmigaOS
7985
7986 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
7987
7988 =item Starting Perl programs under AmigaOS
7989
7990 =item Shortcomings of Perl under AmigaOS
7991
7992 =back
7993
7994 =item INSTALLATION
7995
7996 =item Accessing documentation
7997
7998 =over 4
7999
8000 =item Manpages for Perl on AmigaOS
8001
8002 =item Perl HTML Documentation on AmigaOS
8003
8004 =item Perl GNU Info Files on AmigaOS
8005
8006 =item Perl LaTeX Documentation on AmigaOS
8007
8008 =back
8009
8010 =item BUILDING PERL ON AMIGAOS
8011
8012 =over 4
8013
8014 =item Build Prerequisites for Perl on AmigaOS
8015
8016 =item Getting the Perl Source for AmigaOS
8017
8018 =item Making Perl on AmigaOS
8019
8020 =item Testing Perl on AmigaOS
8021
8022 =item Installing the built Perl on AmigaOS
8023
8024 =back
8025
8026 =item PERL 5.8.0 BROKEN IN AMIGAOS
8027
8028 =item AUTHORS
8029
8030 =item SEE ALSO
8031
8032 =back
8033
8034 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
8035
8036 =over 4
8037
8038 =item DESCRIPTION
8039
8040 =item AUTHOR
8041
8042 =back
8043
8044 =head2 perlbeos, README.beos - Perl version 5 on BeOS
8045
8046 =over 4
8047
8048 =item DESCRIPTION
8049
8050 =over 4
8051
8052 =item General Issues with Perl on BeOS
8053
8054 =item BeOS Release-specific Notes
8055
8056 R4 x86, R4 PPC
8057
8058 =item Contact Information
8059
8060 =item Update 2002-05-30
8061
8062 =back
8063
8064 =back
8065
8066 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
8067
8068 =over 4
8069
8070 =item SYNOPSIS
8071
8072 =item DESCRIPTION
8073
8074 =over 4
8075
8076 =item gzip on BS2000
8077
8078 =item bison on BS2000
8079
8080 =item Unpacking Perl Distribution on BS2000
8081
8082 =item Compiling Perl on BS2000
8083
8084 =item Testing Perl on BS2000
8085
8086 =item Installing Perl on BS2000
8087
8088 =item Using Perl in the Posix-Shell of BS2000
8089
8090 =item Using Perl in "native" BS2000
8091
8092 =item Floating point anomalies on BS2000
8093
8094 =item Using PerlIO and different encodings on ASCII and EBCDIC partitions
8095
8096 =back
8097
8098 =item AUTHORS
8099
8100 =item SEE ALSO
8101
8102 =over 4
8103
8104 =item Mailing list
8105
8106 =back
8107
8108 =item HISTORY
8109
8110 =back
8111
8112 =head2 perlce - Perl for WinCE
8113
8114 =over 4
8115
8116 =item DESCRIPTION
8117
8118 =item BUILD
8119
8120 =over 4
8121
8122 =item Tools & SDK
8123
8124 Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's
8125 celib-sources, Rainer Keuchel's console-sources
8126
8127 =item Make
8128
8129 go to ./wince subdirectory, edit file compile.bat, run    compile.bat, run 
8130   compile.bat dist
8131
8132 =back
8133
8134 =item ACKNOWLEDGEMENTS
8135
8136 =item AUTHORS
8137
8138 =back
8139
8140 =head2 perlcygwin, README.cygwin - Perl for Cygwin
8141
8142 =over 4
8143
8144 =item SYNOPSIS
8145
8146 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
8147
8148 =over 4
8149
8150 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
8151
8152 =item Cygwin Configuration
8153
8154 C<PATH>, I<nroff>, Permissions
8155
8156 =back
8157
8158 =item CONFIGURE PERL ON CYGWIN
8159
8160 =over 4
8161
8162 =item Stripping Perl Binaries on Cygwin
8163
8164 =item Optional Libraries for Perl on Cygwin
8165
8166 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
8167 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
8168
8169 =item Configure-time Options for Perl on Cygwin
8170
8171 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
8172 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
8173 C<-Dmksymlinks>
8174
8175 =item Suspicious Warnings on Cygwin
8176
8177 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
8178
8179 =back
8180
8181 =item MAKE ON CYGWIN
8182
8183 =over 4
8184
8185 =item Errors on Cygwin
8186
8187 =item ld2 on Cygwin
8188
8189 =back
8190
8191 =item TEST ON CYGWIN
8192
8193 =over 4
8194
8195 =item File Permissions on Cygwin
8196
8197 =item NDBM_File and ODBM_File do not work on FAT filesystems
8198
8199 =item C<fork()> failures in io_* tests
8200
8201 =item Script Portability on Cygwin
8202
8203 Pathnames, Text/Binary, PerlIO, F<.exe>, C<chown()>, Miscellaneous
8204
8205 =back
8206
8207 =item INSTALL PERL ON CYGWIN
8208
8209 =item MANIFEST ON CYGWIN
8210
8211 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
8212 Source, Compiled Module Source, Perl Modules/Scripts
8213
8214 =item BUGS ON CYGWIN
8215
8216 =item AUTHORS
8217
8218 =item HISTORY
8219
8220 =back
8221
8222 =head2 perldgux - Perl under DG/UX.
8223
8224 =over 4
8225
8226 =item SYNOPSIS
8227
8228 =back
8229
8230 =over 4
8231
8232 =item DESCRIPTION
8233
8234 =item BUILDING PERL ON DG/UX
8235
8236 =over 4
8237
8238 =item Non-threaded Perl on DG/UX
8239
8240 =item Threaded Perl on DG/UX
8241
8242 =item Testing Perl on DG/UX
8243
8244 =item Installing the built perl on DG/UX
8245
8246 =back
8247
8248 =item AUTHOR
8249
8250 =item SEE ALSO
8251
8252 =back
8253
8254 =head2 perldos - Perl under DOS, W31, W95.
8255
8256 =over 4
8257
8258 =item SYNOPSIS
8259
8260 =item DESCRIPTION
8261
8262 =over 4
8263
8264 =item Prerequisites for Compiling Perl on DOS
8265
8266 DJGPP, Pthreads
8267
8268 =item Shortcomings of Perl under DOS
8269
8270 =item Building Perl on DOS
8271
8272 =item Testing Perl on DOS
8273
8274 =item Installation of Perl on DOS
8275
8276 =back
8277
8278 =item BUILDING AND INSTALLING MODULES ON DOS
8279
8280 =over 4
8281
8282 =item Building Prerequisites for Perl on DOS
8283
8284 =item Unpacking CPAN Modules on DOS
8285
8286 =item Building Non-XS Modules on DOS
8287
8288 =item Building XS Modules on DOS
8289
8290 =back
8291
8292 =item AUTHOR
8293
8294 =item SEE ALSO
8295
8296 =back
8297
8298 =head2 perlepoc, README.epoc - Perl for EPOC
8299
8300 =over 4
8301
8302 =item SYNOPSIS
8303
8304 =item INTRODUCTION
8305
8306 =item INSTALLING PERL ON EPOC
8307
8308 =item STARTING PERL ON EPOC
8309
8310 =over 4
8311
8312 =item Editors on Epoc
8313
8314 =item Features of Perl on Epoc
8315
8316 =item Restrictions of Perl on Epoc
8317
8318 =item Compiling Perl 5 on the EPOC cross compiling environment
8319
8320 =back
8321
8322 =item SUPPORT STATUS OF PERL ON EPOC
8323
8324 =item AUTHOR
8325
8326 =item LAST UPDATE
8327
8328 =back
8329
8330 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
8331
8332 =over 4
8333
8334 =item DESCRIPTION
8335
8336 =over 4
8337
8338 =item FreeBSD core dumps from readdir_r with ithreads
8339
8340 =item $^X doesn't always contain a full path in FreeBSD
8341
8342 =item Perl will no longer be part of "base FreeBSD"
8343
8344 =back
8345
8346 =item AUTHOR
8347
8348 =back
8349
8350 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
8351 (HP-UX) systems
8352
8353 =over 4
8354
8355 =item DESCRIPTION
8356
8357 =over 4
8358
8359 =item Using perl as shipped with HP-UX
8360
8361 =item Using perl from HP's porting centre
8362
8363 =item Compiling Perl 5 on HP-UX
8364
8365 =item PA-RISC
8366
8367 =item PA-RISC 1.0
8368
8369 =item PA-RISC 1.1
8370
8371 =item PA-RISC 2.0
8372
8373 =item Itanium
8374
8375 =item Portability Between PA-RISC Versions
8376
8377 =item Itanium Processor Family and HP-UX
8378
8379 =item Building Dynamic Extensions on HP-UX
8380
8381 =item The HP ANSI C Compiler
8382
8383 =item The GNU C Compiler
8384
8385 =item Using Large Files with Perl on HP-UX
8386
8387 =item Threaded Perl on HP-UX
8388
8389 =item 64-bit Perl on HP-UX
8390
8391 =item Oracle on HP-UX
8392
8393 =item GDBM and Threads on HP-UX
8394
8395 =item NFS filesystems and utime(2) on HP-UX
8396
8397 =item perl -P and // and HP-UX
8398
8399 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
8400
8401 =back
8402
8403 =item nss_delete core dump from op/pwent or op/grent
8404
8405 =item AUTHOR
8406
8407 =item DATE
8408
8409 =back
8410
8411 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
8412
8413 =over 4
8414
8415 =item DESCRIPTION
8416
8417 =over 4
8418
8419 =item Known Problems with Perl on Hurd 
8420
8421 =back
8422
8423 =item AUTHOR
8424
8425 =back
8426
8427 =head2 perlirix, README.irix - Perl version 5 on Irix systems
8428
8429 =over 4
8430
8431 =item DESCRIPTION
8432
8433 =over 4
8434
8435 =item Building 32-bit Perl in Irix
8436
8437 =item Building 64-bit Perl in Irix
8438
8439 =item About Compiler Versions of Irix
8440
8441 =item Linker Problems in Irix
8442
8443 =item Malloc in Irix
8444
8445 =item Building with threads in Irix
8446
8447 =item Irix 5.3
8448
8449 =back
8450
8451 =item AUTHOR
8452
8453 =back
8454
8455 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
8456 systems
8457
8458 =over 4
8459
8460 =item DESCRIPTION
8461
8462 =over 4
8463
8464 =item Perl version 5.8.x and greater not supported
8465
8466 =item Compiling Perl 5.6.x on MachTen
8467
8468 =item Failures during C<make test> on MachTen
8469
8470 op/lexassign.t, pragma/warnings.t
8471
8472 =item Building external modules on MachTen
8473
8474 =back
8475
8476 =item AUTHOR
8477
8478 =item DATE
8479
8480 =back
8481
8482 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
8483
8484 =over 4
8485
8486 =item SYNOPSIS
8487
8488 =item DESCRIPTION
8489
8490 =item AUTHOR
8491
8492 =item DATE
8493
8494 =back
8495
8496 =head2 perlmacosx, README.macosx - Perl under Mac OS X
8497
8498 =over 4
8499
8500 =item SYNOPSIS
8501
8502 =item DESCRIPTION
8503
8504 =over 4
8505
8506 =item Installation Prefix
8507
8508 =item libperl and Prebinding
8509
8510 =item Updating Panther
8511
8512 =item Known problems
8513
8514 =item MacPerl
8515
8516 =item Carbon
8517
8518 =item Cocoa
8519
8520 =back
8521
8522 =item Starting From Scratch
8523
8524 =item AUTHOR
8525
8526 =item DATE
8527
8528 =back
8529
8530 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
8531
8532 =over 4
8533
8534 =item DESCRIPTION
8535
8536 =item Known problems with Perl on MiNT
8537
8538 =item AUTHOR
8539
8540 =back
8541
8542 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
8543
8544 =over 4
8545
8546 =item SYNOPSIS
8547
8548 =item NOTE
8549
8550 =item Binary distribution from HP
8551
8552 =item What's New in Perl for MPE/iX
8553
8554 =item Welcome to Perl/iX
8555
8556 =item System Requirements for Perl/iX
8557
8558 =item How to Obtain Perl/iX
8559
8560 =item Perl/iX Distribution Contents Highlights
8561
8562 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
8563 public_html/feedback.cgi, src/perl-5.6.0-mpe
8564
8565 =item How to Compile Perl/iX
8566
8567  4,  6
8568
8569 =item Getting Started with Perl/iX
8570
8571 =item MPE/iX Implementation Considerations
8572
8573 =item Known Perl/iX Bugs Under Investigation
8574
8575 =item Perl/iX To-Do List
8576
8577 =item Perl/iX Change History
8578
8579 =item AUTHOR
8580
8581 =back
8582
8583 =head2 perlnetware - Perl for NetWare
8584
8585 =over 4
8586
8587 =item DESCRIPTION
8588
8589 =item BUILD
8590
8591 =over 4
8592
8593 =item Tools & SDK
8594
8595 =item Setup
8596
8597 SetNWBld.bat, Buildtype.bat
8598
8599 =item Make
8600
8601 =item Interpreter
8602
8603 =item Extensions
8604
8605 =back
8606
8607 =item INSTALL
8608
8609 =item BUILD NEW EXTENSIONS
8610
8611 =item ACKNOWLEDGEMENTS
8612
8613 =item AUTHORS
8614
8615 =item DATE
8616
8617 =back
8618
8619 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
8620
8621 =over 4
8622
8623 =item SYNOPSIS
8624
8625 =back
8626
8627 =over 4
8628
8629 =item DESCRIPTION
8630
8631 =over 4
8632
8633 =item Target
8634
8635 =item Other OSes
8636
8637 =item Prerequisites
8638
8639 EMX, RSX, HPFS, pdksh
8640
8641 =item Starting Perl programs under OS/2 (and DOS and...)
8642
8643 =item Starting OS/2 (and DOS) programs under Perl
8644
8645 =back
8646
8647 =item Frequently asked questions
8648
8649 =over 4
8650
8651 =item "It does not work"
8652
8653 =item I cannot run external programs
8654
8655 =item I cannot embed perl into my program, or use F<perl.dll> from my
8656 program. 
8657
8658 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
8659 L<ExtUtils::Embed>?
8660
8661 =item C<``> and pipe-C<open> do not work under DOS.
8662
8663 =item Cannot start C<find.exe "pattern" file>
8664
8665 =back
8666
8667 =item INSTALLATION
8668
8669 =over 4
8670
8671 =item Automatic binary installation
8672
8673 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
8674
8675 =item Manual binary installation
8676
8677 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
8678 (statically linked), Executables for Perl utilities, Main Perl library,
8679 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
8680 and utilities, Manpages for Perl modules, Source for Perl documentation,
8681 Perl manual in F<.INF> format, Pdksh
8682
8683 =item B<Warning>
8684
8685 =back
8686
8687 =item Accessing documentation
8688
8689 =over 4
8690
8691 =item OS/2 F<.INF> file
8692
8693 =item Plain text
8694
8695 =item Manpages
8696
8697 =item HTML
8698
8699 =item GNU C<info> files
8700
8701 =item F<PDF> files
8702
8703 =item C<LaTeX> docs
8704
8705 =back
8706
8707 =item BUILD
8708
8709 =over 4
8710
8711 =item The short story
8712
8713 =item Prerequisites
8714
8715 =item Getting perl source
8716
8717 =item Application of the patches
8718
8719 =item Hand-editing
8720
8721 =item Making
8722
8723 =item Testing
8724
8725 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
8726 F<op/stat.t>
8727
8728 =item Installing the built perl
8729
8730 =item C<a.out>-style build
8731
8732 =back
8733
8734 =item Building a binary distribution
8735
8736 =item Building custom F<.EXE> files
8737
8738 =over 4
8739
8740 =item Making executables with a custom collection of statically loaded
8741 extensions
8742
8743 =item Making executables with a custom search-paths
8744
8745 =back
8746
8747 =item Build FAQ
8748
8749 =over 4
8750
8751 =item Some C</> became C<\> in pdksh.
8752
8753 =item C<'errno'> - unresolved external
8754
8755 =item Problems with tr or sed
8756
8757 =item Some problem (forget which ;-)
8758
8759 =item Library ... not found
8760
8761 =item Segfault in make
8762
8763 =item op/sprintf test failure
8764
8765 =back
8766
8767 =item Specific (mis)features of OS/2 port
8768
8769 =over 4
8770
8771 =item C<setpriority>, C<getpriority>
8772
8773 =item C<system()>
8774
8775 =item C<extproc> on the first line
8776
8777 =item Additional modules:
8778
8779 =item Prebuilt methods:
8780
8781 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
8782  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>, 
8783 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>, 
8784 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>, 
8785 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>, 
8786 C<Cwd::extLibpath_set( path [, type ] )>,
8787 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
8788 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
8789 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
8790 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
8791 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
8792 C<OS2::DLLname([how [, \&xsub]])>
8793
8794 =item Prebuilt variables:
8795
8796 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
8797 $OS2::nsyserror
8798
8799 =item Misfeatures
8800
8801 =item Modifications
8802
8803 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
8804 C<flock>
8805
8806 =item Identifying DLLs
8807
8808 =item Centralized management of resources
8809
8810 C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
8811 C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
8812 C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
8813 C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
8814
8815 =back
8816
8817 =item Perl flavors
8818
8819 =over 4
8820
8821 =item F<perl.exe>
8822
8823 =item F<perl_.exe>
8824
8825 =item F<perl__.exe>
8826
8827 =item F<perl___.exe>
8828
8829 =item Why strange names?
8830
8831 =item Why dynamic linking?
8832
8833 =item Why chimera build?
8834
8835 =back
8836
8837 =item ENVIRONMENT
8838
8839 =over 4
8840
8841 =item C<PERLLIB_PREFIX>
8842
8843 =item C<PERL_BADLANG>
8844
8845 =item C<PERL_BADFREE>
8846
8847 =item C<PERL_SH_DIR>
8848
8849 =item C<USE_PERL_FLOCK>
8850
8851 =item C<TMP> or C<TEMP>
8852
8853 =back
8854
8855 =item Evolution
8856
8857 =over 4
8858
8859 =item Text-mode filehandles
8860
8861 =item Priorities
8862
8863 =item DLL name mangling: pre 5.6.2
8864
8865 =item DLL name mangling: 5.6.2 and beyond
8866
8867 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
8868 C<LIBPATH>
8869
8870 =item DLL forwarder generation
8871
8872 =item Threading
8873
8874 =item Calls to external programs
8875
8876 =item Memory allocation
8877
8878 =item Threads
8879
8880 C<COND_WAIT>, F<os2.c>
8881
8882 =back
8883
8884 =item BUGS
8885
8886 =back
8887
8888 =over 4
8889
8890 =item AUTHOR
8891
8892 =item SEE ALSO
8893
8894 =back
8895
8896 =head2 perlos390, README.os390 - building and installing Perl for OS/390
8897 and z/OS
8898
8899 =over 4
8900
8901 =item SYNOPSIS
8902
8903 =item DESCRIPTION
8904
8905 =over 4
8906
8907 =item Tools
8908
8909 =item Unpacking Perl distribution on OS/390
8910
8911 =item Setup and utilities for Perl on OS/390
8912
8913 =item Configure Perl on OS/390
8914
8915 =item Build, Test, Install Perl on OS/390
8916
8917 =item Build Anomalies with Perl on OS/390
8918
8919 =item Testing Anomalies with Perl on OS/390
8920
8921 =item Installation Anomalies with Perl on OS/390
8922
8923 =item Usage Hints for Perl on OS/390
8924
8925 =item Floating Point Anomalies with Perl on OS/390
8926
8927 =item Modules and Extensions for Perl on OS/390
8928
8929 =back
8930
8931 =item AUTHORS
8932
8933 =item SEE ALSO
8934
8935 =over 4
8936
8937 =item Mailing list for Perl on OS/390
8938
8939 =back
8940
8941 =item HISTORY
8942
8943 =back
8944
8945 =head2 perlos400, README.os400 - Perl version 5 on OS/400
8946
8947 =over 4
8948
8949 =item DESCRIPTION
8950
8951 =over 4
8952
8953 =item Compiling Perl for OS/400 PASE
8954
8955 =item Installing Perl in OS/400 PASE
8956
8957 =item Using Perl in OS/400 PASE
8958
8959 =item Known Problems
8960
8961 =item Perl on ILE
8962
8963 =back
8964
8965 =item AUTHORS
8966
8967 =back
8968
8969 =head2 perlplan9 - Plan 9-specific documentation for Perl
8970
8971 =over 4
8972
8973 =item DESCRIPTION
8974
8975 =over 4
8976
8977 =item Invoking Perl
8978
8979 =item What's in Plan 9 Perl
8980
8981 =item What's not in Plan 9 Perl
8982
8983 =item Perl5 Functions not currently supported in Plan 9 Perl
8984
8985 =item Signals in Plan 9 Perl
8986
8987 =back
8988
8989 =item COMPILING AND INSTALLING PERL ON PLAN 9
8990
8991 =over 4
8992
8993 =item Installing Perl Documentation on Plan 9
8994
8995 =back
8996
8997 =item BUGS
8998
8999 =item Revision date
9000
9001 =item AUTHOR
9002
9003 =back
9004
9005 =head2 perlqnx, README.qnx - Perl version 5 on QNX
9006
9007 =over 4
9008
9009 =item DESCRIPTION
9010
9011 =over 4
9012
9013 =item Required Software for Compiling Perl on QNX4
9014
9015 /bin/sh, ar, nm, cpp, make
9016
9017 =item Outstanding Issues with Perl on QNX4
9018
9019 =item QNX auxiliary files
9020
9021 qnx/ar, qnx/cpp
9022
9023 =item Outstanding issues with perl under QNX6
9024
9025 =back
9026
9027 =item AUTHOR
9028
9029 =back
9030
9031 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
9032
9033 =over 4
9034
9035 =item DESCRIPTION
9036
9037 =over 4
9038
9039 =item Solaris Version Numbers.
9040
9041 =back
9042
9043 =item RESOURCES
9044
9045 Solaris FAQ, Precompiled Binaries, Solaris Documentation
9046
9047 =item SETTING UP
9048
9049 =over 4
9050
9051 =item File Extraction Problems on Solaris.
9052
9053 =item Compiler and Related Tools on Solaris.
9054
9055 =item Environment for Compiling perl on Solaris
9056
9057 =back
9058
9059 =item RUN CONFIGURE.
9060
9061 =over 4
9062
9063 =item 64-bit perl on Solaris.
9064
9065 =item Threads in perl on Solaris.
9066
9067 =item Malloc Issues with perl on Solaris.
9068
9069 =back
9070
9071 =item MAKE PROBLEMS.
9072
9073 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
9074 relocation error:, dlopen: stub interception failed, #error "No
9075 DATAMODEL_NATIVE specified", sh: ar: not found
9076
9077 =item MAKE TEST
9078
9079 =over 4
9080
9081 =item op/stat.t test 4 in Solaris
9082
9083 =item nss_delete core dump from op/pwent or op/grent
9084
9085 =back
9086
9087 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
9088
9089 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
9090
9091 =over 4
9092
9093 =item Limits on Numbers of Open Files on Solaris.
9094
9095 =back
9096
9097 =item SOLARIS-SPECIFIC MODULES.
9098
9099 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
9100
9101 =over 4
9102
9103 =item Proc::ProcessTable on Solaris
9104
9105 =item BSD::Resource on Solaris
9106
9107 =item Net::SSLeay on Solaris
9108
9109 =back
9110
9111 =item SunOS 4.x
9112
9113 =item AUTHOR
9114
9115 =item LAST MODIFIED
9116
9117 =back
9118
9119 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
9120 Digital UNIX formerly known as DEC OSF/1) systems
9121
9122 =over 4
9123
9124 =item DESCRIPTION
9125
9126 =over 4
9127
9128 =item Compiling Perl 5 on Tru64
9129
9130 =item Using Large Files with Perl on Tru64
9131
9132 =item Threaded Perl on Tru64
9133
9134 =item Long Doubles on Tru64
9135
9136 =item DB_File tests failing on Tru64
9137
9138 =item 64-bit Perl on Tru64
9139
9140 =item Warnings about floating-point overflow when compiling Perl on Tru64
9141
9142 =back
9143
9144 =item Testing Perl on Tru64
9145
9146 =item ext/ODBM_File/odbm Test Failing With Static Builds
9147
9148 =item Perl Fails Because Of Unresolved Symbol sockatmark
9149
9150 =item AUTHOR
9151
9152 =back
9153
9154 =head2 perluts - Perl under UTS
9155
9156 =over 4
9157
9158 =item SYNOPSIS
9159
9160 =item DESCRIPTION
9161
9162 =item BUILDING PERL ON UTS
9163
9164 =item Installing the built perl on UTS
9165
9166 =item AUTHOR
9167
9168 =back
9169
9170 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
9171
9172 =over 4
9173
9174 =item SYNOPSIS
9175
9176 =item DESCRIPTION
9177
9178 =over 4
9179
9180 =item Unpacking Perl Distribution on VM/ESA
9181
9182 =item Setup Perl and utilities on VM/ESA
9183
9184 =item Configure Perl on VM/ESA
9185
9186 =item Testing Anomalies of Perl on VM/ESA
9187
9188 =item Usage Hints for Perl on VM/ESA
9189
9190 =back
9191
9192 =item AUTHORS
9193
9194 =item SEE ALSO
9195
9196 =over 4
9197
9198 =item Mailing list for Perl on VM/ESA
9199
9200 =back
9201
9202 =back
9203
9204 =head2 perlvms - VMS-specific documentation for Perl
9205
9206 =over 4
9207
9208 =item DESCRIPTION
9209
9210 =item Installation
9211
9212 =item Organization of Perl Images
9213
9214 =over 4
9215
9216 =item Core Images
9217
9218 =item Perl Extensions
9219
9220 =item Installing static extensions
9221
9222 =item Installing dynamic extensions
9223
9224 =back
9225
9226 =item File specifications
9227
9228 =over 4
9229
9230 =item Syntax
9231
9232 =item Wildcard expansion
9233
9234 =item Pipes
9235
9236 =back
9237
9238 =item PERL5LIB and PERLLIB
9239
9240 =item Command line
9241
9242 =over 4
9243
9244 =item I/O redirection and backgrounding
9245
9246 =item Command line switches
9247
9248 -i, -S, -u
9249
9250 =back
9251
9252 =item Perl functions
9253
9254 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
9255 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
9256 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
9257 LIST, waitpid PID,FLAGS
9258
9259 =item Perl variables
9260
9261 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
9262
9263 =item Standard modules with VMS-specific differences
9264
9265 =over 4
9266
9267 =item SDBM_File
9268
9269 =back
9270
9271 =item Revision date
9272
9273 =item AUTHOR
9274
9275 =back
9276
9277 =head2 perlvos, README.vos - Perl for Stratus VOS
9278
9279 =over 4
9280
9281 =item SYNOPSIS
9282
9283 =item BUILDING PERL FOR VOS
9284
9285 =item INSTALLING PERL IN VOS
9286
9287 =item USING PERL IN VOS
9288
9289 =over 4
9290
9291 =item Restrictions of Perl on VOS
9292
9293 =item Handling of underflow and overflow
9294
9295 =back
9296
9297 =item TEST STATUS
9298
9299 =item SUPPORT STATUS
9300
9301 =item AUTHOR
9302
9303 =item LAST UPDATE
9304
9305 =back
9306
9307 =head2 perlwin32 - Perl under Windows
9308
9309 =over 4
9310
9311 =item SYNOPSIS
9312
9313 =item DESCRIPTION
9314
9315 =over 4
9316
9317 =item Setting Up Perl on Win32
9318
9319 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform
9320 SDK 64-bit Compiler, MinGW32 with gcc, MinGW release 1
9321
9322 =item Building
9323
9324 =item Testing Perl on Win32
9325
9326 =item Installation of Perl on Win32
9327
9328 =item Usage Hints for Perl on Win32
9329
9330 Environment Variables, File Globbing, Using perl from the command line,
9331 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
9332 Extensions, Notes on 64-bit Windows
9333
9334 =item Running Perl Scripts
9335
9336 Miscellaneous Things
9337
9338 =back
9339
9340 =item BUGS AND CAVEATS
9341
9342 =item ACKNOWLEDGEMENTS
9343
9344 =item AUTHORS
9345
9346 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
9347 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
9348 E<lt>nick@ing-simmons.netE<gt>
9349
9350 =item SEE ALSO
9351
9352 =item HISTORY
9353
9354 =back
9355
9356 =head1 PRAGMA DOCUMENTATION
9357
9358 =head2 attrs - set/get attributes of a subroutine (deprecated)
9359
9360 =over 4
9361
9362 =item SYNOPSIS
9363
9364 =item DESCRIPTION
9365
9366 method, locked
9367
9368 =back
9369
9370 =head2 re - Perl pragma to alter regular expression behaviour
9371
9372 =over 4
9373
9374 =item SYNOPSIS
9375
9376 =item DESCRIPTION
9377
9378 =back
9379
9380 =head2 threadshared::shared, threads::shared - Perl extension for sharing
9381 data structures between threads
9382
9383 =over 4
9384
9385 =item SYNOPSIS
9386
9387 =item DESCRIPTION
9388
9389 =item EXPORT
9390
9391 =item FUNCTIONS
9392
9393 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
9394 LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
9395 ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
9396
9397 =item NOTES
9398
9399 =item BUGS
9400
9401 =item AUTHOR
9402
9403 =item SEE ALSO
9404
9405 =back
9406
9407 =head2 threads - Perl extension allowing use of interpreter based threads
9408 from perl
9409
9410 =over 4
9411
9412 =item SYNOPSIS
9413
9414 =item DESCRIPTION
9415
9416 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
9417 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
9418 threads->list();, async BLOCK;
9419
9420 =item WARNINGS
9421
9422 A thread exited while %d other threads were still running
9423
9424 =item TODO
9425
9426 =item BUGS
9427
9428 Parent-Child threads, Returning objects, Creating threads inside BEGIN
9429 blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
9430
9431 =item AUTHOR and COPYRIGHT
9432
9433 =item SEE ALSO
9434
9435 =back
9436
9437 =head2 assertions - select assertions in blocks of code
9438
9439 =over 4
9440
9441 =item SYNOPSIS
9442
9443 =item DESCRIPTION
9444
9445 =item SEE ALSO
9446
9447 =item AUTHOR
9448
9449 =item COPYRIGHT AND LICENSE
9450
9451 =back
9452
9453 =head2 assertions::activate - activate assertions
9454
9455 =over 4
9456
9457 =item SYNOPSIS
9458
9459 =item DESCRIPTION
9460
9461 =item SEE ALSO
9462
9463 =item AUTHOR
9464
9465 =item COPYRIGHT AND LICENSE
9466
9467 =back
9468
9469 =head2 attributes - get/set subroutine or variable attributes
9470
9471 =over 4
9472
9473 =item SYNOPSIS
9474
9475 =item DESCRIPTION
9476
9477 =over 4
9478
9479 =item Built-in Attributes
9480
9481 locked, method, lvalue
9482
9483 =item Available Subroutines
9484
9485 get, reftype
9486
9487 =item Package-specific Attribute Handling
9488
9489 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
9490
9491 =item Syntax of Attribute Lists
9492
9493 =back
9494
9495 =item EXPORTS
9496
9497 =over 4
9498
9499 =item Default exports
9500
9501 =item Available exports
9502
9503 =item Export tags defined
9504
9505 =back
9506
9507 =item EXAMPLES
9508
9509 =item SEE ALSO
9510
9511 =back
9512
9513 =head2 autouse - postpone load of modules until a function is used
9514
9515 =over 4
9516
9517 =item SYNOPSIS
9518
9519 =item DESCRIPTION
9520
9521 =item WARNING
9522
9523 =item AUTHOR
9524
9525 =item SEE ALSO
9526
9527 =back
9528
9529 =head2 base - Establish IS-A relationship with base classes at compile time
9530
9531 =over 4
9532
9533 =item SYNOPSIS
9534
9535 =item DESCRIPTION
9536
9537 =item HISTORY
9538
9539 =item CAVEATS
9540
9541 =item SEE ALSO
9542
9543 =back
9544
9545 =head2 bigint - Transparent BigInteger support for Perl
9546
9547 =over 4
9548
9549 =item SYNOPSIS
9550
9551 =item DESCRIPTION
9552
9553 =over 4
9554
9555 =item OPTIONS
9556
9557 a or accuracy, p or precision, t or trace, l or lib, v or version
9558
9559 =item MATH LIBRARY
9560
9561 =item INTERNAL FORMAT
9562
9563 =item SIGN
9564
9565 =item METHODS
9566
9567 =item CAVEAT
9568
9569 =back
9570
9571 =item MODULES USED
9572
9573 =item EXAMPLES
9574
9575 =item LICENSE
9576
9577 =item SEE ALSO
9578
9579 =item AUTHORS
9580
9581 =back
9582
9583 =head2 bignum - Transparent BigNumber support for Perl
9584
9585 =over 4
9586
9587 =item SYNOPSIS
9588
9589 =item DESCRIPTION
9590
9591 =over 4
9592
9593 =item OPTIONS
9594
9595 a or accuracy, p or precision, t or trace, l or lib, v or version
9596
9597 =item METHODS
9598
9599 =item CAVEAT
9600
9601 inf(), NaN(), upgrade()
9602
9603 =item MATH LIBRARY
9604
9605 =item INTERNAL FORMAT
9606
9607 =item SIGN
9608
9609 =back
9610
9611 =item MODULES USED
9612
9613 =item EXAMPLES
9614
9615 =item LICENSE
9616
9617 =item SEE ALSO
9618
9619 =item AUTHORS
9620
9621 =back
9622
9623 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
9624
9625 =over 4
9626
9627 =item SYNOPSIS
9628
9629 =item DESCRIPTION
9630
9631 =over 4
9632
9633 =item MODULES USED
9634
9635 =item MATH LIBRARY
9636
9637 =item SIGN
9638
9639 =item METHODS
9640
9641 =item CAVEAT
9642
9643 =back
9644
9645 =item EXAMPLES
9646
9647         perl -Mbigrat -le 'print sqrt(33)'
9648         perl -Mbigrat -le 'print 2*255'
9649         perl -Mbigrat -le 'print 4.5+2*255'
9650         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'       
9651         perl -Mbigrat -le 'print 12->is_odd()';
9652
9653 =item LICENSE
9654
9655 =item SEE ALSO
9656
9657 =item AUTHORS
9658
9659 =back
9660
9661 =head2 blib - Use MakeMaker's uninstalled version of a package
9662
9663 =over 4
9664
9665 =item SYNOPSIS
9666
9667 =item DESCRIPTION
9668
9669 =item BUGS
9670
9671 =item AUTHOR
9672
9673 =back
9674
9675 =head2 bytes - Perl pragma to force byte semantics rather than character
9676 semantics
9677
9678 =over 4
9679
9680 =item SYNOPSIS
9681
9682 =item DESCRIPTION
9683
9684 =item LIMITATIONS
9685
9686 =item SEE ALSO
9687
9688 =back
9689
9690 =head2 charnames - define character names for C<\N{named}> string literal
9691 escapes
9692
9693 =over 4
9694
9695 =item SYNOPSIS
9696
9697 =item DESCRIPTION
9698
9699 =item CUSTOM TRANSLATORS
9700
9701 =item CUSTOM ALIASES
9702
9703 =over 4
9704
9705 =item Anonymous hashes
9706
9707 =item Alias file
9708
9709 =item Alias shortcut
9710
9711 =back
9712
9713 =item charnames::viacode(code)
9714
9715 =item charnames::vianame(name)
9716
9717 =item ALIASES
9718
9719 =item ILLEGAL CHARACTERS
9720
9721 =item BUGS
9722
9723 =back
9724
9725 =head2 constant - Perl pragma to declare constants
9726
9727 =over 4
9728
9729 =item SYNOPSIS
9730
9731 =item DESCRIPTION
9732
9733 =item NOTES
9734
9735 =over 4
9736
9737 =item List constants
9738
9739 =item Defining multiple constants at once
9740
9741 =item Magic constants
9742
9743 =back
9744
9745 =item TECHNICAL NOTES
9746
9747 =item BUGS
9748
9749 =item AUTHOR
9750
9751 =item COPYRIGHT
9752
9753 =back
9754
9755 =head2 diagnostics, splain - produce verbose warning diagnostics
9756
9757 =over 4
9758
9759 =item SYNOPSIS
9760
9761 =item DESCRIPTION
9762
9763 =over 4
9764
9765 =item The C<diagnostics> Pragma
9766
9767 =item The I<splain> Program
9768
9769 =back
9770
9771 =item EXAMPLES
9772
9773 =item INTERNALS
9774
9775 =item BUGS
9776
9777 =item AUTHOR
9778
9779 =back
9780
9781 =head2 encoding - allows you to write your script in non-ascii or non-utf8
9782
9783 =over 4
9784
9785 =item SYNOPSIS
9786
9787 =item ABSTRACT
9788
9789 =over 4
9790
9791 =item Literal Conversions
9792
9793 =item PerlIO layers for C<STD(IN|OUT)>
9794
9795 =item Implicit upgrading for byte strings
9796
9797 =back
9798
9799 =item FEATURES THAT REQUIRE 5.8.1
9800
9801 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
9802
9803 =item USAGE
9804
9805 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
9806 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
9807
9808 =item The Filter Option
9809
9810 =over 4
9811
9812 =item Filter-related changes at Encode version 1.87
9813
9814 =back
9815
9816 =item CAVEATS
9817
9818 =over 4
9819
9820 =item NOT SCOPED
9821
9822 =item DO NOT MIX MULTIPLE ENCODINGS
9823
9824 =item tr/// with ranges
9825
9826 Legend of characters above
9827
9828 =back
9829
9830 =item EXAMPLE - Greekperl
9831
9832 =item KNOWN PROBLEMS
9833
9834 literals in regex that are longer than 127 bytes, EBCDIC, format
9835
9836 =item HISTORY
9837
9838 =item SEE ALSO
9839
9840 =back
9841
9842 =head2 fields - compile-time class fields
9843
9844 =over 4
9845
9846 =item SYNOPSIS
9847
9848 =item DESCRIPTION
9849
9850 new, phash
9851
9852 =item SEE ALSO
9853
9854 =back
9855
9856 =head2 filetest - Perl pragma to control the filetest permission operators
9857
9858 =over 4
9859
9860 =item SYNOPSIS
9861
9862 =item DESCRIPTION
9863
9864 =over 4
9865
9866 =item subpragma access
9867
9868 =back
9869
9870 =back
9871
9872 =head2 if - C<use> a Perl module if a condition holds
9873
9874 =over 4
9875
9876 =item SYNOPSIS
9877
9878 =item DESCRIPTION
9879
9880 =item BUGS
9881
9882 =item AUTHOR
9883
9884 =back
9885
9886 =head2 integer - Perl pragma to use integer arithmetic instead of floating
9887 point
9888
9889 =over 4
9890
9891 =item SYNOPSIS
9892
9893 =item DESCRIPTION
9894
9895 =back
9896
9897 =head2 less - perl pragma to request less of something from the compiler
9898
9899 =over 4
9900
9901 =item SYNOPSIS
9902
9903 =item DESCRIPTION
9904
9905 =back
9906
9907 =head2 lib - manipulate @INC at compile time
9908
9909 =over 4
9910
9911 =item SYNOPSIS
9912
9913 =item DESCRIPTION
9914
9915 =over 4
9916
9917 =item Adding directories to @INC
9918
9919 =item Deleting directories from @INC
9920
9921 =item Restoring original @INC
9922
9923 =back
9924
9925 =item CAVEATS
9926
9927 =item NOTES
9928
9929 =item SEE ALSO
9930
9931 =item AUTHOR
9932
9933 =back
9934
9935 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
9936 operations
9937
9938 =over 4
9939
9940 =item SYNOPSIS
9941
9942 =item DESCRIPTION
9943
9944 =back
9945
9946 =head2 open - perl pragma to set default PerlIO layers for input and output
9947
9948 =over 4
9949
9950 =item SYNOPSIS
9951
9952 =item DESCRIPTION
9953
9954 =item NONPERLIO FUNCTIONALITY
9955
9956 =item IMPLEMENTATION DETAILS
9957
9958 =item SEE ALSO
9959
9960 =back
9961
9962 =head2 ops - Perl pragma to restrict unsafe operations when compiling
9963
9964 =over 4
9965
9966 =item SYNOPSIS  
9967
9968 =item DESCRIPTION
9969
9970 =item SEE ALSO
9971
9972 =back
9973
9974 =head2 overload - Package for overloading perl operations
9975
9976 =over 4
9977
9978 =item SYNOPSIS
9979
9980 =item DESCRIPTION
9981
9982 =over 4
9983
9984 =item Declaration of overloaded functions
9985
9986 =item Calling Conventions for Binary Operations
9987
9988 FALSE, TRUE, C<undef>
9989
9990 =item Calling Conventions for Unary Operations
9991
9992 =item Calling Conventions for Mutators
9993
9994 C<++> and C<-->, C<x=> and other assignment versions
9995
9996 =item Overloadable Operations
9997
9998 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
9999 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
10000 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
10001
10002 =item Inheritance and overloading
10003
10004 Strings as values of C<use overload> directive, Overloading of an operation
10005 is inherited by derived classes
10006
10007 =back
10008
10009 =item SPECIAL SYMBOLS FOR C<use overload>
10010
10011 =over 4
10012
10013 =item Last Resort
10014
10015 =item Fallback
10016
10017 C<undef>, TRUE, defined, but FALSE
10018
10019 =item Copy Constructor
10020
10021 B<Example>
10022
10023 =back
10024
10025 =item MAGIC AUTOGENERATION
10026
10027 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
10028 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
10029 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
10030 I<Copy operator>
10031
10032 =item Losing overloading
10033
10034 =item Run-time Overloading
10035
10036 =item Public functions
10037
10038 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
10039
10040 =item Overloading constants
10041
10042 integer, float, binary, q, qr
10043
10044 =item IMPLEMENTATION
10045
10046 =item Metaphor clash
10047
10048 =item Cookbook
10049
10050 =over 4
10051
10052 =item Two-face scalars
10053
10054 =item Two-face references
10055
10056 =item Symbolic calculator
10057
10058 =item I<Really> symbolic calculator
10059
10060 =back
10061
10062 =item AUTHOR
10063
10064 =item DIAGNOSTICS
10065
10066 Odd number of arguments for overload::constant, `%s' is not an overloadable
10067 type, `%s' is not a code reference
10068
10069 =item BUGS
10070
10071 =back
10072
10073 =head2 sigtrap - Perl pragma to enable simple signal handling
10074
10075 =over 4
10076
10077 =item SYNOPSIS
10078
10079 =item DESCRIPTION
10080
10081 =item OPTIONS
10082
10083 =over 4
10084
10085 =item SIGNAL HANDLERS
10086
10087 B<stack-trace>, B<die>, B<handler> I<your-handler>
10088
10089 =item SIGNAL LISTS
10090
10091 B<normal-signals>, B<error-signals>, B<old-interface-signals>
10092
10093 =item OTHER
10094
10095 B<untrapped>, B<any>, I<signal>, I<number>
10096
10097 =back
10098
10099 =item EXAMPLES
10100
10101 =back
10102
10103 =head2 sort - perl pragma to control sort() behaviour
10104
10105 =over 4
10106
10107 =item SYNOPSIS
10108
10109 =item DESCRIPTION
10110
10111 =item CAVEATS
10112
10113 =back
10114
10115 =head2 strict - Perl pragma to restrict unsafe constructs
10116
10117 =over 4
10118
10119 =item SYNOPSIS
10120
10121 =item DESCRIPTION
10122
10123 C<strict refs>, C<strict vars>, C<strict subs>
10124
10125 =item HISTORY
10126
10127 =back
10128
10129 =head2 subs - Perl pragma to predeclare sub names
10130
10131 =over 4
10132
10133 =item SYNOPSIS
10134
10135 =item DESCRIPTION
10136
10137 =back
10138
10139 =head2 threadshared, threads::shared - Perl extension for sharing data
10140 structures between threads
10141
10142 =over 4
10143
10144 =item SYNOPSIS
10145
10146 =item DESCRIPTION
10147
10148 =item EXPORT
10149
10150 =item FUNCTIONS
10151
10152 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
10153 LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
10154 ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
10155
10156 =item NOTES
10157
10158 =item BUGS
10159
10160 =item AUTHOR
10161
10162 =item SEE ALSO
10163
10164 =back
10165
10166 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
10167 code
10168
10169 =over 4
10170
10171 =item SYNOPSIS
10172
10173 =item DESCRIPTION
10174
10175 =over 4
10176
10177 =item Utility functions
10178
10179 $num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[,
10180 FAIL_OK]), utf8::encode($string), utf8::decode($string), $flag =
10181 utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
10182
10183 =back
10184
10185 =item BUGS
10186
10187 =item SEE ALSO
10188
10189 =back
10190
10191 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
10192
10193 =over 4
10194
10195 =item SYNOPSIS
10196
10197 =item DESCRIPTION
10198
10199 =back
10200
10201 =head2 version - Perl extension for Version Objects
10202
10203 =over 4
10204
10205 =item SYNOPSIS
10206
10207 =item DESCRIPTION
10208
10209 =over 4
10210
10211 =item What IS a version
10212
10213 Numeric Versions, Quoted Versions
10214
10215 =item What about v-strings?
10216
10217 =item Numeric Versions
10218
10219 =item Quoted Versions
10220
10221 =item Object Methods
10222
10223 New Operator, qv(), Normal Form, Numification, Stringification, Comparison
10224 operators, Logical Operators
10225
10226 =item Quoting
10227
10228 =item Types of Versions Objects
10229
10230 Ordinary versions, Alpha versions
10231
10232 =item Replacement UNIVERSAL::VERSION
10233
10234 =back
10235
10236 =item EXPORT
10237
10238 =item AUTHOR
10239
10240 =item SEE ALSO
10241
10242 =back
10243
10244 =head2 vmsish - Perl pragma to control VMS-specific language features
10245
10246 =over 4
10247
10248 =item SYNOPSIS
10249
10250 =item DESCRIPTION
10251
10252 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
10253
10254 =back
10255
10256 =head2 warnings - Perl pragma to control optional warnings
10257
10258 =over 4
10259
10260 =item SYNOPSIS
10261
10262 =item DESCRIPTION
10263
10264 use warnings::register, warnings::enabled(), warnings::enabled($category),
10265 warnings::enabled($object), warnings::warn($message),
10266 warnings::warn($category, $message), warnings::warn($object, $message),
10267 warnings::warnif($message), warnings::warnif($category, $message),
10268 warnings::warnif($object, $message)
10269
10270 =back
10271
10272 =head2 warnings::register - warnings import function
10273
10274 =over 4
10275
10276 =item SYNOPSIS
10277
10278 =item DESCRIPTION
10279
10280 =back
10281
10282 =head1 MODULE DOCUMENTATION
10283
10284 =head2 AnyDBM_File - provide framework for multiple DBMs
10285
10286 =over 4
10287
10288 =item SYNOPSIS
10289
10290 =item DESCRIPTION
10291
10292 =over 4
10293
10294 =item DBM Comparisons
10295
10296 [0], [1], [2], [3]
10297
10298 =back
10299
10300 =item SEE ALSO
10301
10302 =back
10303
10304 =head2 Attribute::Handlers - Simpler definition of attribute handlers
10305
10306 =over 4
10307
10308 =item VERSION
10309
10310 =item SYNOPSIS
10311
10312 =item DESCRIPTION
10313
10314 [0], [1], [2], [3], [4], [5]
10315
10316 =over 4
10317
10318 =item Typed lexicals
10319
10320 =item Type-specific attribute handlers
10321
10322 =item Non-interpretive attribute handlers
10323
10324 =item Phase-specific attribute handlers
10325
10326 =item Attributes as C<tie> interfaces
10327
10328 =back
10329
10330 =item EXAMPLES
10331
10332 =item DIAGNOSTICS
10333
10334 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
10335 attributes>, C<Declaration of %s attribute in package %s may clash with
10336 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
10337 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
10338 be able to apply END handler>
10339
10340 =item AUTHOR
10341
10342 =item BUGS
10343
10344 =item COPYRIGHT
10345
10346 =back
10347
10348 =head2 AutoLoader - load subroutines only on demand
10349
10350 =over 4
10351
10352 =item SYNOPSIS
10353
10354 =item DESCRIPTION
10355
10356 =over 4
10357
10358 =item Subroutine Stubs
10359
10360 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
10361
10362 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
10363
10364 =item Package Lexicals
10365
10366 =item Not Using AutoLoader
10367
10368 =item B<AutoLoader> vs. B<SelfLoader>
10369
10370 =back
10371
10372 =item CAVEATS
10373
10374 =item SEE ALSO
10375
10376 =back
10377
10378 =head2 AutoSplit - split a package for autoloading
10379
10380 =over 4
10381
10382 =item SYNOPSIS
10383
10384 =item DESCRIPTION
10385
10386 $keep, $check, $modtime
10387
10388 =over 4
10389
10390 =item Multiple packages
10391
10392 =back
10393
10394 =item DIAGNOSTICS
10395
10396 =back
10397
10398 =head2 B - The Perl Compiler
10399
10400 =over 4
10401
10402 =item SYNOPSIS
10403
10404 =item DESCRIPTION
10405
10406 =item OVERVIEW
10407
10408 =item Utility Functions
10409
10410 =over 4
10411
10412 =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV>
10413 objects
10414
10415 sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av,
10416 check_av, begin_av, end_av, comppadlist, regex_padav, main_cv
10417
10418 =item Functions for Examining the Symbol Table
10419
10420 walksymtable(SYMREF, METHOD, RECURSE, PREFIX)
10421
10422 =item Functions Returning C<B::OP> objects or for walking op trees
10423
10424 main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG)
10425
10426 =item Miscellaneous Utility Functions
10427
10428 ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR),
10429 perlstring(STR), class(OBJ), threadsv_names
10430
10431 =back
10432
10433 =item OVERVIEW OF CLASSES
10434
10435 =over 4
10436
10437 =item SV-RELATED CLASSES
10438
10439 =item B::SV Methods
10440
10441 REFCNT, FLAGS, object_2svref
10442
10443 =item B::IV Methods
10444
10445 IV, IVX, UVX, int_value, needs64bits, packiv
10446
10447 =item B::NV Methods
10448
10449 NV, NVX
10450
10451 =item B::RV Methods
10452
10453 RV
10454
10455 =item B::PV Methods
10456
10457 PV, RV, PVX
10458
10459 =item B::PVMG Methods
10460
10461 MAGIC, SvSTASH
10462
10463 =item B::MAGIC Methods
10464
10465 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
10466
10467 =item B::PVLV Methods
10468
10469 TARGOFF, TARGLEN, TYPE, TARG
10470
10471 =item B::BM Methods
10472
10473 USEFUL, PREVIOUS, RARE, TABLE
10474
10475 =item B::GV Methods
10476
10477 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
10478 LINE, FILE, FILEGV, GvREFCNT, FLAGS
10479
10480 =item B::IO Methods
10481
10482 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
10483 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
10484
10485 =item B::AV Methods
10486
10487 FILL, MAX, OFF, ARRAY, ARRAYelt, AvFLAGS
10488
10489 =item B::CV Methods
10490
10491 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB,
10492 XSUBANY, CvFLAGS, const_sv
10493
10494 =item B::HV Methods
10495
10496 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
10497
10498 =item OP-RELATED CLASSES
10499
10500 =item B::OP Methods
10501
10502 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
10503
10504 =item B::UNOP METHOD
10505
10506 first
10507
10508 =item B::BINOP METHOD
10509
10510 last
10511
10512 =item B::LOGOP METHOD
10513
10514 other
10515
10516 =item B::LISTOP METHOD
10517
10518 children
10519
10520 =item B::PMOP Methods
10521
10522 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
10523 pmpermflags, precomp, pmoffset
10524
10525 =item B::SVOP METHOD
10526
10527 sv, gv
10528
10529 =item B::PADOP METHOD
10530
10531 padix
10532
10533 =item B::PVOP METHOD
10534
10535 pv
10536
10537 =item B::LOOP Methods
10538
10539 redoop, nextop, lastop
10540
10541 =item B::COP Methods
10542
10543 label, stash, stashpv, file, cop_seq, arybase, line, warnings, io
10544
10545 =back
10546
10547 =item AUTHOR
10548
10549 =back
10550
10551 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
10552 bytecode
10553
10554 =over 4
10555
10556 =item SYNOPSIS
10557
10558 =item DESCRIPTION
10559
10560 %insn_data, @insn_name, @optype, @specialsv_name
10561
10562 =item AUTHOR
10563
10564 =back
10565
10566 =head2 B::Assembler - Assemble Perl bytecode
10567
10568 =over 4
10569
10570 =item SYNOPSIS
10571
10572 =item DESCRIPTION
10573
10574 =item AUTHORS
10575
10576 =back
10577
10578 =head2 B::Bblock - Walk basic blocks
10579
10580 =over 4
10581
10582 =item SYNOPSIS
10583
10584 =item DESCRIPTION
10585
10586 =over 4
10587
10588 =item Functions
10589
10590 B<find_leaders>
10591
10592 =back
10593
10594 =item AUTHOR
10595
10596 =back
10597
10598 =head2 B::Bytecode - Perl compiler's bytecode backend
10599
10600 =over 4
10601
10602 =item SYNOPSIS
10603
10604 =item DESCRIPTION
10605
10606 =item EXAMPLE
10607
10608 =item OPTIONS
10609
10610 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
10611
10612 =item KNOWN BUGS
10613
10614 =item NOTICE
10615
10616 =item AUTHORS
10617
10618 =back
10619
10620 =head2 B::C - Perl compiler's C backend
10621
10622 =over 4
10623
10624 =item SYNOPSIS
10625
10626 =item DESCRIPTION
10627
10628 =item OPTIONS
10629
10630 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
10631 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
10632 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
10633 B<-llimit>
10634
10635 =item EXAMPLES
10636
10637 =item BUGS
10638
10639 =item AUTHOR
10640
10641 =back
10642
10643 =head2 B::CC - Perl compiler's optimized C translation backend
10644
10645 =over 4
10646
10647 =item SYNOPSIS
10648
10649 =item DESCRIPTION
10650
10651 =item OPTIONS
10652
10653 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
10654 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
10655 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
10656
10657 =item EXAMPLES
10658
10659 =item BUGS
10660
10661 =item DIFFERENCES
10662
10663 =over 4
10664
10665 =item Loops
10666
10667 =item Context of ".."
10668
10669 =item Arithmetic
10670
10671 =item Deprecated features
10672
10673 =back
10674
10675 =item AUTHOR
10676
10677 =back
10678
10679 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
10680
10681 =over 4
10682
10683 =item SYNOPSIS
10684
10685 =item DESCRIPTION
10686
10687 =item EXAMPLE
10688
10689 =item OPTIONS
10690
10691 =over 4
10692
10693 =item Options for Opcode Ordering
10694
10695 B<-basic>, B<-exec>, B<-tree>
10696
10697 =item Options for Line-Style
10698
10699 B<-concise>, B<-terse>, B<-linenoise>, B<-debug>, B<-env>
10700
10701 =item Options for tree-specific formatting
10702
10703 B<-compact>, B<-loose>, B<-vt>, B<-ascii>
10704
10705 =item Options controlling sequence numbering
10706
10707 B<-base>I<n>, B<-bigendian>, B<-littleendian>
10708
10709 =item Other options
10710
10711 B<-main>, B<-banner>
10712
10713 =item Option Stickiness
10714
10715 =back
10716
10717 =item FORMATTING SPECIFICATIONS
10718
10719 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
10720 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
10721 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
10722 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
10723 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
10724 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
10725 B<#seq>, B<#opt>, B<#static>, B<#sibaddr>, B<#svaddr>, B<#svclass>,
10726 B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
10727
10728 =item ABBREVIATIONS
10729
10730 =over 4
10731
10732 =item OP flags abbreviations
10733
10734 =item OP class abbreviations
10735
10736 =back
10737
10738 =item Using B::Concise outside of the O framework
10739
10740 =over 4
10741
10742 =item Example: Altering Concise Renderings
10743
10744 =item set_style()
10745
10746 =item set_style_standard($name)
10747
10748 =item add_style()
10749
10750 =item add_callback()
10751
10752 =item Running B::Concise::compile()
10753
10754 =item B::Concise::reset_sequence()
10755
10756 =item Errors
10757
10758 =back
10759
10760 =item AUTHOR
10761
10762 =back
10763
10764 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
10765
10766 =over 4
10767
10768 =item SYNOPSIS
10769
10770 =item DESCRIPTION
10771
10772 =item AUTHOR
10773
10774 =back
10775
10776 =head2 B::Deparse - Perl compiler backend to produce perl code
10777
10778 =over 4
10779
10780 =item SYNOPSIS
10781
10782 =item DESCRIPTION
10783
10784 =item OPTIONS
10785
10786 B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>,
10787 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
10788
10789 =item USING B::Deparse AS A MODULE
10790
10791 =over 4
10792
10793 =item Synopsis
10794
10795 =item Description
10796
10797 =item new
10798
10799 =item ambient_pragmas
10800
10801 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
10802
10803 =item coderef2text
10804
10805 =back
10806
10807 =item BUGS
10808
10809 =item AUTHOR
10810
10811 =back
10812
10813 =head2 B::Disassembler - Disassemble Perl bytecode
10814
10815 =over 4
10816
10817 =item SYNOPSIS
10818
10819 =item DESCRIPTION
10820
10821 =item AUTHOR
10822
10823 =back
10824
10825 =head2 B::Lint - Perl lint
10826
10827 =over 4
10828
10829 =item SYNOPSIS
10830
10831 =item DESCRIPTION
10832
10833 =item OPTIONS AND LINT CHECKS
10834
10835 B<context>, B<implicit-read> and B<implicit-write>, B<bare-subs>,
10836 B<dollar-underscore>, B<private-names>, B<undefined-subs>,
10837 B<regexp-variables>, B<all>, B<none>
10838
10839 =item NON LINT-CHECK OPTIONS
10840
10841 B<-u Package>
10842
10843 =item BUGS
10844
10845 =item AUTHOR
10846
10847 =back
10848
10849 =head2 B::O, O - Generic interface to Perl Compiler backends
10850
10851 =over 4
10852
10853 =item SYNOPSIS
10854
10855 =item DESCRIPTION
10856
10857 =item CONVENTIONS
10858
10859 =item IMPLEMENTATION
10860
10861 =item BUGS
10862
10863 =item AUTHOR
10864
10865 =back
10866
10867 =head2 B::Showlex - Show lexical variables used in functions or files
10868
10869 =over 4
10870
10871 =item SYNOPSIS
10872
10873 =item DESCRIPTION
10874
10875 =item AUTHOR
10876
10877 =back
10878
10879 =head2 B::Stackobj - Helper module for CC backend
10880
10881 =over 4
10882
10883 =item SYNOPSIS
10884
10885 =item DESCRIPTION
10886
10887 =item AUTHOR
10888
10889 =back
10890
10891 =head2 B::Stash - show what stashes are loaded
10892
10893 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
10894
10895 =over 4
10896
10897 =item SYNOPSIS
10898
10899 =item DESCRIPTION
10900
10901 =item AUTHOR
10902
10903 =back
10904
10905 =head2 B::Xref - Generates cross reference reports for Perl programs
10906
10907 =over 4
10908
10909 =item SYNOPSIS
10910
10911 =item DESCRIPTION
10912
10913 =item OPTIONS
10914
10915 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
10916
10917 =item BUGS
10918
10919 =item AUTHOR
10920
10921 =back
10922
10923 =head2 Bblock, B::Bblock - Walk basic blocks
10924
10925 =over 4
10926
10927 =item SYNOPSIS
10928
10929 =item DESCRIPTION
10930
10931 =over 4
10932
10933 =item Functions
10934
10935 B<find_leaders>
10936
10937 =back
10938
10939 =item AUTHOR
10940
10941 =back
10942
10943 =head2 Benchmark - benchmark running times of Perl code
10944
10945 =over 4
10946
10947 =item SYNOPSIS
10948
10949 =item DESCRIPTION
10950
10951 =over 4
10952
10953 =item Methods
10954
10955 new, debug, iters
10956
10957 =item Standard Exports
10958
10959 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
10960 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
10961 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
10962
10963 =item Optional Exports
10964
10965 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [
10966 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
10967 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
10968
10969 =item :hireswallclock
10970
10971 =back
10972
10973 =item NOTES
10974
10975 =item EXAMPLES
10976
10977 =item INHERITANCE
10978
10979 =item CAVEATS
10980
10981 =item SEE ALSO
10982
10983 =item AUTHORS
10984
10985 =item MODIFICATION HISTORY
10986
10987 =back
10988
10989 =head2 ByteLoader - load byte compiled perl code
10990
10991 =over 4
10992
10993 =item SYNOPSIS
10994
10995 =item DESCRIPTION
10996
10997 =item AUTHOR
10998
10999 =item SEE ALSO
11000
11001 =back
11002
11003 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
11004
11005 =over 4
11006
11007 =item SYNOPSIS
11008
11009 =item DESCRIPTION
11010
11011 =item EXAMPLE
11012
11013 =item OPTIONS
11014
11015 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
11016
11017 =item KNOWN BUGS
11018
11019 =item NOTICE
11020
11021 =item AUTHORS
11022
11023 =back
11024
11025 =head2 CGI - Simple Common Gateway Interface Class
11026
11027 =over 4
11028
11029 =item SYNOPSIS
11030
11031 =item ABSTRACT
11032
11033 =item DESCRIPTION
11034
11035 =over 4
11036
11037 =item PROGRAMMING STYLE
11038
11039 =item CALLING CGI.PM ROUTINES
11040
11041 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
11042
11043 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
11044
11045 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
11046
11047 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
11048
11049 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
11050
11051 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
11052
11053 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
11054
11055 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
11056
11057 =item DELETING A PARAMETER COMPLETELY:
11058
11059 =item DELETING ALL PARAMETERS:
11060
11061 =item DIRECT ACCESS TO THE PARAMETER LIST:
11062
11063 =item FETCHING THE PARAMETER LIST AS A HASH:
11064
11065 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
11066
11067 =item RETRIEVING CGI ERRORS
11068
11069 =item USING THE FUNCTION-ORIENTED INTERFACE
11070
11071 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
11072 B<:standard>, B<:all>
11073
11074 =item PRAGMAS
11075
11076 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
11077 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
11078 -private_tempfiles
11079
11080 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
11081
11082 1. start_table() (generates a <table> tag), 2. end_table() (generates a
11083 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
11084 a </ul> tag)
11085
11086 =back
11087
11088 =item GENERATING DYNAMIC DOCUMENTS
11089
11090 =over 4
11091
11092 =item CREATING A STANDARD HTTP HEADER:
11093
11094 =item GENERATING A REDIRECTION HEADER
11095
11096 =item CREATING THE HTML DOCUMENT HEADER
11097
11098 B<Parameters:>, 4, 5, 6..
11099
11100 =item ENDING THE HTML DOCUMENT:
11101
11102 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
11103
11104 =item OBTAINING THE SCRIPT'S URL
11105
11106 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
11107 (B<-query_string>), B<-base>
11108
11109 =item MIXING POST AND URL PARAMETERS
11110
11111 =back
11112
11113 =item CREATING STANDARD HTML ELEMENTS:
11114
11115 =over 4
11116
11117 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
11118
11119 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
11120
11121 =item HTML SHORTCUTS AND LIST INTERPOLATION
11122
11123 =item NON-STANDARD HTML SHORTCUTS
11124
11125 =item AUTOESCAPING HTML
11126
11127 $escaped_string = escapeHTML("unescaped string");, $charset =
11128 charset([$charset]);, $flag = autoEscape([$flag]);
11129
11130 =item PRETTY-PRINTING HTML
11131
11132 =back
11133
11134 =item CREATING FILL-OUT FORMS:
11135
11136 =over 4
11137
11138 =item CREATING AN ISINDEX TAG
11139
11140 =item STARTING AND ENDING A FORM
11141
11142 B<application/x-www-form-urlencoded>, B<multipart/form-data>
11143
11144 =item CREATING A TEXT FIELD
11145
11146 B<Parameters>
11147
11148 =item CREATING A BIG TEXT FIELD
11149
11150 =item CREATING A PASSWORD FIELD
11151
11152 =item CREATING A FILE UPLOAD FIELD
11153
11154 B<Parameters>
11155
11156 =item CREATING A POPUP MENU
11157
11158 =item CREATING AN OPTION GROUP
11159
11160 =item CREATING A SCROLLING LIST
11161
11162 B<Parameters:>
11163
11164 =item CREATING A GROUP OF RELATED CHECKBOXES
11165
11166 B<Parameters:>
11167
11168 =item CREATING A STANDALONE CHECKBOX
11169
11170 B<Parameters:>
11171
11172 =item CREATING A RADIO BUTTON GROUP
11173
11174 B<Parameters:>
11175
11176 =item CREATING A SUBMIT BUTTON 
11177
11178 B<Parameters:>
11179
11180 =item CREATING A RESET BUTTON
11181
11182 =item CREATING A DEFAULT BUTTON
11183
11184 =item CREATING A HIDDEN FIELD
11185
11186 B<Parameters:>
11187
11188 =item CREATING A CLICKABLE IMAGE BUTTON
11189
11190 B<Parameters:>, 3. The third option (-align, optional) is an alignment
11191 type, and may be TOP, BOTTOM or MIDDLE
11192
11193 =item CREATING A JAVASCRIPT ACTION BUTTON
11194
11195 =back
11196
11197 =item HTTP COOKIES
11198
11199 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
11200 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
11201
11202 =item WORKING WITH FRAMES
11203
11204 1. Create a <Frameset> document, 2. Specify the destination for the
11205 document in the HTTP header, 3. Specify the destination for the document in
11206 the <form> tag
11207
11208 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
11209
11210 =item DEBUGGING
11211
11212 =over 4
11213
11214 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
11215
11216 =back
11217
11218 =item FETCHING ENVIRONMENT VARIABLES
11219
11220 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
11221 B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
11222 name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
11223 ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
11224 B<virtual_port ()>, B<server_software ()>, B<remote_user ()>, B<user_name
11225 ()>, B<request_method()>, B<content_type()>, B<http()>, B<https()>
11226
11227 =item USING NPH SCRIPTS
11228
11229 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
11230 parameters
11231
11232 =item Server Push
11233
11234 multipart_init(), multipart_start(), multipart_end(), multipart_final()
11235
11236 =item Avoiding Denial of Service Attacks
11237
11238 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
11239 basis>, B<2. Globally for all scripts>
11240
11241 =item COMPATIBILITY WITH CGI-LIB.PL
11242
11243 =item AUTHOR INFORMATION
11244
11245 =item CREDITS
11246
11247 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
11248 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
11249 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
11250 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
11251 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
11252 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
11253 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
11254 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
11255 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
11256 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
11257 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
11258 ...and many many more..
11259
11260 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
11261
11262 =item BUGS
11263
11264 =item SEE ALSO
11265
11266 =back
11267
11268 =head2 CGI::Apache - Backward compatibility module for CGI.pm
11269
11270 =over 4
11271
11272 =item SYNOPSIS
11273
11274 =item ABSTRACT
11275
11276 =item DESCRIPTION
11277
11278 =item AUTHOR INFORMATION
11279
11280 =item BUGS
11281
11282 =item SEE ALSO
11283
11284 =back
11285
11286 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
11287 other) error log
11288
11289 =over 4
11290
11291 =item SYNOPSIS
11292
11293 =item DESCRIPTION
11294
11295 =item REDIRECTING ERROR MESSAGES
11296
11297 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
11298
11299 =over 4
11300
11301 =item Changing the default message
11302
11303 =back
11304
11305 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
11306
11307 =item OVERRIDING THE NAME OF THE PROGRAM
11308
11309 =item AUTHORS
11310
11311 =item SEE ALSO
11312
11313 =back
11314
11315 =head2 CGI::Cookie - Interface to Netscape Cookies
11316
11317 =over 4
11318
11319 =item SYNOPSIS
11320
11321 =item DESCRIPTION
11322
11323 =item USING CGI::Cookie
11324
11325 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
11326
11327 =over 4
11328
11329 =item Creating New Cookies
11330
11331 =item Sending the Cookie to the Browser
11332
11333 =item Recovering Previous Cookies
11334
11335 =item Manipulating Cookies
11336
11337 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
11338
11339 =back
11340
11341 =item AUTHOR INFORMATION
11342
11343 =item BUGS
11344
11345 =item SEE ALSO
11346
11347 =back
11348
11349 =head2 CGI::Fast - CGI Interface for Fast CGI
11350
11351 =over 4
11352
11353 =item SYNOPSIS
11354
11355 =item DESCRIPTION
11356
11357 =item OTHER PIECES OF THE PUZZLE
11358
11359 =item WRITING FASTCGI PERL SCRIPTS
11360
11361 =item INSTALLING FASTCGI SCRIPTS
11362
11363 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
11364
11365 =item EXTERNAL FASTCGI SERVER INVOCATION
11366
11367 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
11368
11369 =item CAVEATS
11370
11371 =item AUTHOR INFORMATION
11372
11373 =item BUGS
11374
11375 =item SEE ALSO
11376
11377 =back
11378
11379 =head2 CGI::Pretty - module to produce nicely formatted HTML code
11380
11381 =over 4
11382
11383 =item SYNOPSIS
11384
11385 =item DESCRIPTION
11386
11387 =over 4
11388
11389 =item Tags that won't be formatted
11390
11391 =item Customizing the Indenting
11392
11393 =back
11394
11395 =item BUGS
11396
11397 =item AUTHOR
11398
11399 =item SEE ALSO
11400
11401 =back
11402
11403 =head2 CGI::Push - Simple Interface to Server Push
11404
11405 =over 4
11406
11407 =item SYNOPSIS
11408
11409 =item DESCRIPTION
11410
11411 =item USING CGI::Push
11412
11413 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
11414
11415 =over 4
11416
11417 =item Heterogeneous Pages
11418
11419 =item Changing the Page Delay on the Fly
11420
11421 =back
11422
11423 =item INSTALLING CGI::Push SCRIPTS
11424
11425 =item AUTHOR INFORMATION
11426
11427 =item BUGS
11428
11429 =item SEE ALSO
11430
11431 =back
11432
11433 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
11434
11435 =over 4
11436
11437 =item SYNOPSIS
11438
11439 =item ABSTRACT
11440
11441 =item DESCRIPTION
11442
11443 =item AUTHOR INFORMATION
11444
11445 =item BUGS
11446
11447 =item SEE ALSO
11448
11449 =back
11450
11451 =head2 CGI::Util - Internal utilities used by CGI module
11452
11453 =over 4
11454
11455 =item SYNOPSIS
11456
11457 =item DESCRIPTION
11458
11459 =item AUTHOR INFORMATION
11460
11461 =item SEE ALSO
11462
11463 =back
11464
11465 =head2 CPAN - query, download and build perl modules from CPAN sites
11466
11467 =over 4
11468
11469 =item SYNOPSIS
11470
11471 =item STATUS
11472
11473 =item DESCRIPTION
11474
11475 =over 4
11476
11477 =item Interactive Mode
11478
11479 Searching for authors, bundles, distribution files and modules, make, test,
11480 install, clean  modules or distributions, get, readme, look module or
11481 distribution, ls author, Signals
11482
11483 =item CPAN::Shell
11484
11485 =item autobundle
11486
11487 =item recompile
11488
11489 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
11490
11491 =item Programmer's interface
11492
11493 expand($type,@things), expandany(@things), Programming Examples
11494
11495 =item Methods in the other Classes
11496
11497 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
11498 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
11499 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
11500 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
11501 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
11502 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
11503 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
11504 CPAN::Bundle::readme(), CPAN::Bundle::test(),
11505 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
11506 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
11507 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
11508 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
11509 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
11510 CPAN::Distribution::look(), CPAN::Distribution::make(),
11511 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
11512 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
11513 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
11514 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
11515 CPAN::Module::clean(), CPAN::Module::cpan_file(),
11516 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
11517 CPAN::Module::description(), CPAN::Module::force($method,@args),
11518 CPAN::Module::get(), CPAN::Module::inst_file(),
11519 CPAN::Module::inst_version(), CPAN::Module::install(),
11520 CPAN::Module::look(), CPAN::Module::make(),
11521 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
11522 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
11523
11524 =item Cache Manager
11525
11526 =item Bundles
11527
11528 =item Prerequisites
11529
11530 =item Finding packages and VERSION
11531
11532 =item Debugging
11533
11534 =item Floppy, Zip, Offline Mode
11535
11536 =back
11537
11538 =item CONFIGURATION
11539
11540 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
11541 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
11542 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
11543 [unshift|push|splice] E<lt>listE<gt>>
11544
11545 =over 4
11546
11547 =item Note on urllist parameter's format
11548
11549 =item urllist parameter has CD-ROM support
11550
11551 =back
11552
11553 =item SECURITY
11554
11555 =item EXPORT
11556
11557 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
11558
11559 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
11560
11561 =over 4
11562
11563 =item Three basic types of firewalls
11564
11565 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
11566
11567 =item Configuring lynx or ncftp for going through a firewall
11568
11569 =back
11570
11571 =item FAQ
11572
11573 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
11574
11575 =item BUGS
11576
11577 =item AUTHOR
11578
11579 =item TRANSLATIONS
11580
11581 =item SEE ALSO
11582
11583 =back
11584
11585 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
11586
11587 =over 4
11588
11589 =item SYNOPSIS
11590
11591 =item DESCRIPTION
11592
11593 =back
11594
11595 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
11596 module
11597
11598 =over 4
11599
11600 =item SYNOPSIS
11601
11602 =item DESCRIPTION
11603
11604 =item  SEE ALSO
11605
11606 =back
11607
11608 =head2 Carp, carp    - warn of errors (from perspective of caller)
11609
11610 =over 4
11611
11612 =item SYNOPSIS
11613
11614 =item DESCRIPTION
11615
11616 =over 4
11617
11618 =item Forcing a Stack Trace
11619
11620 =back
11621
11622 =item BUGS
11623
11624 =back
11625
11626 =head2 Carp::Heavy - heavy machinery, no user serviceable parts inside
11627
11628 =head2 Class::ISA -- report the search path for a class's ISA tree
11629
11630 =over 4
11631
11632 =item SYNOPSIS
11633
11634 =item DESCRIPTION
11635
11636 =item FUNCTIONS
11637
11638 the function Class::ISA::super_path($CLASS), the function
11639 Class::ISA::self_and_super_path($CLASS), the function
11640 Class::ISA::self_and_super_versions($CLASS)
11641
11642 =item CAUTIONARY NOTES
11643
11644 =item COPYRIGHT
11645
11646 =item AUTHOR
11647
11648 =back
11649
11650 =head2 Class::Struct - declare struct-like datatypes as Perl classes
11651
11652 =over 4
11653
11654 =item SYNOPSIS
11655
11656 =item DESCRIPTION
11657
11658 =over 4
11659
11660 =item The C<struct()> function
11661
11662 =item Class Creation at Compile Time
11663
11664 =item Element Types and Accessor Methods
11665
11666 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
11667 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
11668
11669 =item Initializing with C<new>
11670
11671 =back
11672
11673 =item EXAMPLES
11674
11675 Example 1, Example 2, Example 3
11676
11677 =item Author and Modification History
11678
11679 =back
11680
11681 =head2 Config - access Perl configuration information
11682
11683 =over 4
11684
11685 =item SYNOPSIS
11686
11687 =item DESCRIPTION
11688
11689 myconfig(), config_sh(), config_re($regex), config_vars(@names)
11690
11691 =item EXAMPLE
11692
11693 =item WARNING
11694
11695 =item GLOSSARY
11696
11697 =over 4
11698
11699 =item _
11700
11701 C<_a>, C<_exe>, C<_o>
11702
11703 =item a
11704
11705 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
11706 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
11707 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
11708 C<asctime_r_proto>, C<awk>
11709
11710 =item b
11711
11712 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
11713
11714 =item c
11715
11716 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
11717 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
11718 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
11719 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
11720 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
11721 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
11722 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
11723
11724 =item d
11725
11726 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>,
11727 C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>,
11728 C<d_bcmp>, C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>,
11729 C<d_bzero>, C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>,
11730 C<d_chroot>, C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>,
11731 C<d_const>, C<d_copysignl>, C<d_crypt>, C<d_crypt_r>, C<d_csh>,
11732 C<d_ctermid_r>, C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>,
11733 C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>, C<d_dirnamlen>, C<d_dlerror>,
11734 C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, C<d_drand48_r>, C<d_drand48proto>,
11735 C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endgrent_r>, C<d_endhent>,
11736 C<d_endhostent_r>, C<d_endnent>, C<d_endnetent_r>, C<d_endpent>,
11737 C<d_endprotoent_r>, C<d_endpwent>, C<d_endpwent_r>, C<d_endsent>,
11738 C<d_endservent_r>, C<d_eofnblk>, C<d_eunice>, C<d_faststdio>, C<d_fchdir>,
11739 C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>,
11740 C<d_fd_set>, C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>,
11741 C<d_flexfnam>, C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>,
11742 C<d_fpathconf>, C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>,
11743 C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>,
11744 C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>, C<d_ftime>,
11745 C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>,
11746 C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>,
11747 C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
11748 C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>,
11749 C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>,
11750 C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>,
11751 C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>,
11752 C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
11753 C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
11754 C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>,
11755 C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
11756 C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>,
11757 C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>,
11758 C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>,
11759 C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
11760 C<d_htonl>, C<d_ilogbl>, C<d_index>, C<d_inetaton>, C<d_int64_t>,
11761 C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>,
11762 C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>,
11763 C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>,
11764 C<d_lstat>, C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>,
11765 C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>,
11766 C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>,
11767 C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>,
11768 C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>,
11769 C<d_msg_peek>, C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>,
11770 C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>,
11771 C<d_nice>, C<d_nl_langinfo>, C<d_nv_preserves_uv>, C<d_off64_t>,
11772 C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
11773 C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
11774 C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
11775 C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
11776 C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>,
11777 C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, C<d_pthread_atfork>,
11778 C<d_pthread_attr_setscope>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
11779 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
11780 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
11781 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
11782 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
11783 C<d_sanemcmp>, C<d_sbrkproto>, C<d_scalbnl>, C<d_sched_yield>,
11784 C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>,
11785 C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>,
11786 C<d_semop>, C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>,
11787 C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>,
11788 C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>,
11789 C<d_setnent>, C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>,
11790 C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>,
11791 C<d_setpwent>, C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>,
11792 C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>,
11793 C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>,
11794 C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>,
11795 C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>,
11796 C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>,
11797 C<d_socks5_init>, C<d_sqrtl>, C<d_srand48_r>, C<d_srandom_r>,
11798 C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>,
11799 C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
11800 C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>,
11801 C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>,
11802 C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strerror_r>,
11803 C<d_strftime>, C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>,
11804 C<d_strtoq>, C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>,
11805 C<d_suidsafe>, C<d_symlink>, C<d_syscall>, C<d_syscallproto>, C<d_sysconf>,
11806 C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>,
11807 C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>,
11808 C<d_tm_tm_gmtoff>, C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>,
11809 C<d_ttyname_r>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>,
11810 C<d_uname>, C<d_union_semun>, C<d_unordered>, C<d_usleep>,
11811 C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>,
11812 C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>, C<d_void_closedir>,
11813 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
11814 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
11815 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
11816 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
11817 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
11818
11819 =item e
11820
11821 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
11822 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
11823 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
11824 C<expr>, C<extensions>, C<extras>
11825
11826 =item f
11827
11828 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
11829 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
11830 C<full_sed>
11831
11832 =item g
11833
11834 C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>,
11835 C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>,
11836 C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>,
11837 C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>,
11838 C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>,
11839 C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>,
11840 C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>,
11841 C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>,
11842 C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>,
11843 C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
11844
11845 =item h
11846
11847 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>,
11848 C<html3dir>, C<html3direxp>
11849
11850 =item i
11851
11852 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
11853 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
11854 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
11855 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
11856 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
11857 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
11858 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
11859 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
11860 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
11861 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
11862 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
11863 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
11864 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
11865 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
11866 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
11867 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
11868 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
11869 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
11870 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installhtml1dir>,
11871 C<installhtml3dir>, C<installman1dir>, C<installman3dir>, C<installprefix>,
11872 C<installprefixexp>, C<installprivlib>, C<installscript>,
11873 C<installsitearch>, C<installsitebin>, C<installsitehtml1dir>,
11874 C<installsitehtml3dir>, C<installsitelib>, C<installsiteman1dir>,
11875 C<installsiteman3dir>, C<installsitescript>, C<installstyle>,
11876 C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>,
11877 C<installvendorhtml1dir>, C<installvendorhtml3dir>, C<installvendorlib>,
11878 C<installvendorman1dir>, C<installvendorman3dir>, C<installvendorscript>,
11879 C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
11880
11881 =item k
11882
11883 C<known_extensions>, C<ksh>
11884
11885 =item l
11886
11887 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
11888 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
11889 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
11890 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
11891 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
11892 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
11893 C<lseektype>
11894
11895 =item m
11896
11897 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
11898 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
11899 C<man3direxp>, C<man3ext>
11900
11901 =item M
11902
11903 C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>,
11904 C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>,
11905 C<myuname>
11906
11907 =item n
11908
11909 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
11910 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
11911 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
11912 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
11913 C<nvsize>, C<nvtype>
11914
11915 =item o
11916
11917 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
11918 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
11919
11920 =item p
11921
11922 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
11923 C<perl>, C<perl_patchlevel>
11924
11925 =item P
11926
11927 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
11928 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
11929 C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>,
11930 C<procselfexe>, C<prototype>, C<ptrsize>
11931
11932 =item q
11933
11934 C<quadkind>, C<quadtype>
11935
11936 =item r
11937
11938 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
11939 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
11940 C<rmail>, C<run>, C<runnm>
11941
11942 =item s
11943
11944 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
11945 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
11946 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
11947 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
11948 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
11949 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
11950 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
11951 C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>,
11952 C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>,
11953 C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>,
11954 C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>,
11955 C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>,
11956 C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>,
11957 C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>,
11958 C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>,
11959 C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>,
11960 C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>,
11961 C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>,
11962 C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>,
11963 C<submit>, C<subversion>, C<sysman>
11964
11965 =item t
11966
11967 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
11968 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
11969 C<ttyname_r_proto>
11970
11971 =item u
11972
11973 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
11974 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
11975 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
11976 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>,
11977 C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemorebits>,
11978 C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>,
11979 C<useposix>, C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>,
11980 C<usethreads>, C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>,
11981 C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>,
11982 C<uvXUformat>
11983
11984 =item v
11985
11986 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
11987 C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>,
11988 C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>,
11989 C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>,
11990 C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>,
11991 C<vendorscriptexp>, C<version>, C<version_patchlevel_string>,
11992 C<versiononly>, C<vi>, C<voidflags>
11993
11994 =item x
11995
11996 C<xlibpth>
11997
11998 =item y
11999
12000 C<yacc>, C<yaccflags>
12001
12002 =item z
12003
12004 C<zcat>, C<zip>
12005
12006 =back
12007
12008 =item NOTE
12009
12010 =back
12011
12012 =head2 Cwd - get pathname of current working directory
12013
12014 =over 4
12015
12016 =item SYNOPSIS
12017
12018 =item DESCRIPTION
12019
12020 =over 4
12021
12022 =item getcwd and friends
12023
12024 getcwd, cwd, fastcwd, fastgetcwd
12025
12026 =item abs_path and friends
12027
12028 abs_path, realpath, fast_abs_path
12029
12030 =item $ENV{PWD}
12031
12032 =back
12033
12034 =item NOTES
12035
12036 =item AUTHOR
12037
12038 =item SEE ALSO
12039
12040 =back
12041
12042 =head2 DB - programmatic interface to the Perl debugging API (draft,
12043 subject to
12044 change)
12045
12046 =over 4
12047
12048 =item SYNOPSIS
12049
12050 =item DESCRIPTION
12051
12052 =over 4
12053
12054 =item Global Variables
12055
12056  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args, 
12057 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname, 
12058 $DB::lineno
12059
12060 =item API Methods
12061
12062 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
12063 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
12064
12065 =item Client Callback Methods
12066
12067 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
12068 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
12069 CLIENT->output(LIST)
12070
12071 =back
12072
12073 =item BUGS
12074
12075 =item AUTHOR
12076
12077 =back
12078
12079 =head2 DBM_Filter -- Filter DBM keys/values 
12080
12081 =over 4
12082
12083 =item SYNOPSIS
12084
12085 =item DESCRIPTION
12086
12087 =item What is a DBM Filter?
12088
12089 =over 4
12090
12091 =item So what's new?
12092
12093 =back
12094
12095 =item METHODS
12096
12097 =over 4
12098
12099 =item $db->Filter_Push()
12100
12101 =item $db->Filter_Key_Push()
12102
12103 =item $db->Filter_Value_Push()
12104
12105 Filter_Push, Filter_Key_Push, Filter_Value_Push
12106
12107 =item $db->Filter_Pop()
12108
12109 =item $db->Filtered()
12110
12111 =back
12112
12113 =item Writing a Filter
12114
12115 =over 4
12116
12117 =item Immediate Filters
12118
12119 =item Canned Filters
12120
12121 "name", params
12122
12123 =back
12124
12125 =item Filters Included
12126
12127 utf8, encode, compress, int32, null
12128
12129 =item NOTES
12130
12131 =over 4
12132
12133 =item Maintain Round Trip Integrity
12134
12135 =item Don't mix filtered & non-filtered data in the same database file. 
12136
12137 =back
12138
12139 =item EXAMPLE
12140
12141 =item SEE ALSO
12142
12143 =item AUTHOR
12144
12145 =back
12146
12147 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
12148
12149 =over 4
12150
12151 =item SYNOPSIS
12152
12153 =item DESCRIPTION
12154
12155 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
12156
12157 =over 4
12158
12159 =item Using DB_File with Berkeley DB version 2 or greater
12160
12161 =item Interface to Berkeley DB
12162
12163 =item Opening a Berkeley DB Database File
12164
12165 =item Default Parameters
12166
12167 =item In Memory Databases
12168
12169 =back
12170
12171 =item DB_HASH
12172
12173 =over 4
12174
12175 =item A Simple Example
12176
12177 =back
12178
12179 =item DB_BTREE
12180
12181 =over 4
12182
12183 =item Changing the BTREE sort order
12184
12185 =item Handling Duplicate Keys 
12186
12187 =item The get_dup() Method
12188
12189 =item The find_dup() Method
12190
12191 =item The del_dup() Method
12192
12193 =item Matching Partial Keys 
12194
12195 =back
12196
12197 =item DB_RECNO
12198
12199 =over 4
12200
12201 =item The 'bval' Option
12202
12203 =item A Simple Example
12204
12205 =item Extra RECNO Methods
12206
12207 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
12208 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
12209 length, elements);>
12210
12211 =item Another Example
12212
12213 =back
12214
12215 =item THE API INTERFACE
12216
12217 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
12218 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
12219 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
12220 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
12221
12222 =item DBM FILTERS
12223
12224 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
12225 B<filter_fetch_value>
12226
12227 =over 4
12228
12229 =item The Filter
12230
12231 =item An Example -- the NULL termination problem.
12232
12233 =item Another Example -- Key is a C int.
12234
12235 =back
12236
12237 =item HINTS AND TIPS 
12238
12239 =over 4
12240
12241 =item Locking: The Trouble with fd
12242
12243 =item Safe ways to lock a database
12244
12245 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
12246
12247 =item Sharing Databases With C Applications
12248
12249 =item The untie() Gotcha
12250
12251 =back
12252
12253 =item COMMON QUESTIONS
12254
12255 =over 4
12256
12257 =item Why is there Perl source in my database?
12258
12259 =item How do I store complex data structures with DB_File?
12260
12261 =item What does "Invalid Argument" mean?
12262
12263 =item What does "Bareword 'DB_File' not allowed" mean? 
12264
12265 =back
12266
12267 =item REFERENCES
12268
12269 =item HISTORY
12270
12271 =item BUGS
12272
12273 =item AVAILABILITY
12274
12275 =item COPYRIGHT
12276
12277 =item SEE ALSO
12278
12279 =item AUTHOR
12280
12281 =back
12282
12283 =head2 Data::Dumper - stringified perl data structures, suitable for both
12284 printing and C<eval>
12285
12286 =over 4
12287
12288 =item SYNOPSIS
12289
12290 =item DESCRIPTION
12291
12292 =over 4
12293
12294 =item Methods
12295
12296 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or> 
12297 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
12298 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
12299 I<$OBJ>->Reset
12300
12301 =item Functions
12302
12303 Dumper(I<LIST>)
12304
12305 =item Configuration Variables or Methods
12306
12307 =item Exports
12308
12309 Dumper
12310
12311 =back
12312
12313 =item EXAMPLES
12314
12315 =item BUGS
12316
12317 =over 4
12318
12319 =item NOTE
12320
12321 =back
12322
12323 =item AUTHOR
12324
12325 =item VERSION
12326
12327 =item SEE ALSO
12328
12329 =back
12330
12331 =head2 Devel::DProf - a Perl code profiler
12332
12333 =over 4
12334
12335 =item SYNOPSIS
12336
12337 =item DESCRIPTION
12338
12339 =item PROFILE FORMAT
12340
12341 =item AUTOLOAD
12342
12343 =item ENVIRONMENT
12344
12345 =item BUGS
12346
12347 =item SEE ALSO
12348
12349 =back
12350
12351 =head2 Devel::PPPort - Perl/Pollution/Portability
12352
12353 =over 4
12354
12355 =item SYNOPSIS
12356
12357 =item DESCRIPTION
12358
12359 =over 4
12360
12361 =item WriteFile
12362
12363 =back
12364
12365 =item ppport.h
12366
12367 =item AUTHOR
12368
12369 =item SEE ALSO
12370
12371 =back
12372
12373 =head2 Devel::Peek - A data debugging tool for the XS programmer
12374
12375 =over 4
12376
12377 =item SYNOPSIS
12378
12379 =item DESCRIPTION
12380
12381 =over 4
12382
12383 =item Runtime debugging
12384
12385 =item Memory footprint debugging
12386
12387 =back
12388
12389 =item EXAMPLES
12390
12391 =over 4
12392
12393 =item A simple scalar string
12394
12395 =item A simple scalar number
12396
12397 =item A simple scalar with an extra reference
12398
12399 =item A reference to a simple scalar
12400
12401 =item A reference to an array
12402
12403 =item A reference to a hash
12404
12405 =item Dumping a large array or hash
12406
12407 =item A reference to an SV which holds a C pointer
12408
12409 =item A reference to a subroutine
12410
12411 =back
12412
12413 =item EXPORTS
12414
12415 =item BUGS
12416
12417 =item AUTHOR
12418
12419 =item SEE ALSO
12420
12421 =back
12422
12423 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
12424
12425 =over 4
12426
12427 =item SYNOPSIS
12428
12429 =item DESCRIPTION
12430
12431 =back
12432
12433 =head2 Digest - Modules that calculate message digests
12434
12435 =over 4
12436
12437 =item SYNOPSIS
12438
12439 =item DESCRIPTION
12440
12441 I<binary>, I<hex>, I<base64>
12442
12443 =item OO INTERFACE
12444
12445 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
12446 Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset,
12447 $ctx->add( $data, ... ), $ctx->addfile( $io_handle ), $ctx->add_bits(
12448 $data, $nbits ), $ctx->add_bits( $bitstring ), $ctx->digest,
12449 $ctx->hexdigest, $ctx->b64digest
12450
12451 =item Digest speed
12452
12453 =item SEE ALSO
12454
12455 =item AUTHOR
12456
12457 =back
12458
12459 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
12460
12461 =over 4
12462
12463 =item SYNOPSIS
12464
12465 =item DESCRIPTION
12466
12467 =item FUNCTIONS
12468
12469 md5($data,...), md5_hex($data,...), md5_base64($data,...)
12470
12471 =item METHODS
12472
12473 $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...),
12474 $md5->addfile($io_handle), $md5->add_bits($data, $nbits),
12475 $md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest
12476
12477 =item EXAMPLES
12478
12479 =item SEE ALSO
12480
12481 =item COPYRIGHT
12482
12483 =item AUTHORS
12484
12485 =back
12486
12487 =head2 Digest::base - Digest base class
12488
12489 =over 4
12490
12491 =item SYNPOSIS
12492
12493 =item DESCRIPTION
12494
12495 =item SEE ALSO
12496
12497 =back
12498
12499 =head2 DirHandle - supply object methods for directory handles
12500
12501 =over 4
12502
12503 =item SYNOPSIS
12504
12505 =item DESCRIPTION
12506
12507 =item NOTES
12508
12509 =back
12510
12511 =head2 Dumpvalue - provides screen dump of Perl data.
12512
12513 =over 4
12514
12515 =item SYNOPSIS
12516
12517 =item DESCRIPTION
12518
12519 =over 4
12520
12521 =item Creation
12522
12523 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
12524 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
12525 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
12526 stopDbSignal
12527
12528 =item Methods
12529
12530 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
12531 compactDump, veryCompact, set, get
12532
12533 =back
12534
12535 =back
12536
12537 =head2 DynaLoader - Dynamically load C libraries into Perl code
12538
12539 =over 4
12540
12541 =item SYNOPSIS
12542
12543 =item DESCRIPTION
12544
12545 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
12546 @dl_modules, @dl_shared_objects, dl_error(), $dl_debug, dl_findfile(),
12547 dl_expandspec(), dl_load_file(), dl_unload_file(), dl_load_flags(),
12548 dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(),
12549 dl_install_xsub(), bootstrap()
12550
12551 =item AUTHOR
12552
12553 =back
12554
12555 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
12556 Perl code
12557
12558 =over 4
12559
12560 =item SYNOPSIS
12561
12562 =item DESCRIPTION
12563
12564 =over 4
12565
12566 =item Migration from C<DynaLoader>
12567
12568 =item Backward compatible boilerplate
12569
12570 =back
12571
12572 =item Order of initialization: early load()
12573
12574 =over 4
12575
12576 =item The most hairy case
12577
12578 =back
12579
12580 =item LIMITATIONS
12581
12582 =item AUTHOR
12583
12584 =back
12585
12586 =head2 Encode - character encodings
12587
12588 =over 4
12589
12590 =item SYNOPSIS
12591
12592 =over 4
12593
12594 =item Table of Contents
12595
12596 =back
12597
12598 =item DESCRIPTION
12599
12600 =over 4
12601
12602 =item TERMINOLOGY
12603
12604 =back
12605
12606 =item PERL ENCODING API
12607
12608 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
12609 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
12610 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
12611 CHECK]);
12612
12613 =over 4
12614
12615 =item Listing available encodings
12616
12617 =item Defining Aliases
12618
12619 =back
12620
12621 =item Encoding via PerlIO
12622
12623 =item Handling Malformed Data
12624
12625 I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
12626 I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
12627 (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
12628 Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
12629 bitmask
12630
12631 =over 4
12632
12633 =item Unimplemented fallback schemes
12634
12635 =back
12636
12637 =item Defining Encodings
12638
12639 =item The UTF-8 flag
12640
12641 Goal #1:, Goal #2:, Goal #3:, Goal #4:
12642
12643 =over 4
12644
12645 =item Messing with Perl's Internals
12646
12647 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
12648
12649 =back
12650
12651 =item SEE ALSO
12652
12653 =item MAINTAINER
12654
12655 =back
12656
12657 =head2 Encode::Alias - alias definitions to encodings
12658
12659 =over 4
12660
12661 =item SYNOPSIS
12662
12663 =item DESCRIPTION
12664
12665 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
12666 reference, e.g.:
12667
12668 =over 4
12669
12670 =item Alias overloading
12671
12672 =back
12673
12674 =item SEE ALSO
12675
12676 =back
12677
12678 =head2 Encode::Byte - Single Byte Encodings
12679
12680 =over 4
12681
12682 =item SYNOPSIS
12683
12684 =item ABSTRACT
12685
12686 =item DESCRIPTION
12687
12688 =item SEE ALSO
12689
12690 =back
12691
12692 =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
12693
12694 =head2 Encode::CN - China-based Chinese Encodings
12695
12696 =over 4
12697
12698 =item SYNOPSIS
12699
12700 =item DESCRIPTION
12701
12702 =item NOTES
12703
12704 =item BUGS
12705
12706 =item SEE ALSO
12707
12708 =back
12709
12710 =head2 Encode::CN::HZ -- internally used by Encode::CN
12711
12712 =head2 Encode::Config -- internally used by Encode
12713
12714 =head2 Encode::EBCDIC - EBCDIC Encodings
12715
12716 =over 4
12717
12718 =item SYNOPSIS
12719
12720 =item ABSTRACT
12721
12722 =item DESCRIPTION
12723
12724 =item SEE ALSO
12725
12726 =back
12727
12728 =head2 Encode::Encoding - Encode Implementation Base Class
12729
12730 =over 4
12731
12732 =item SYNOPSIS
12733
12734 =item DESCRIPTION
12735
12736 =over 4
12737
12738 =item Methods you should implement
12739
12740 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
12741 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
12742
12743 =item Other methods defined in Encode::Encodings
12744
12745 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
12746
12747 =item Example: Encode::ROT13
12748
12749 =back
12750
12751 =item Why the heck Encode API is different?
12752
12753 =over 4
12754
12755 =item Compiled Encodings
12756
12757 =back
12758
12759 =item SEE ALSO
12760
12761 Scheme 1, Scheme 2, Other Schemes
12762
12763 =back
12764
12765 =head2 Encode::Guess -- Guesses encoding from data
12766
12767 =over 4
12768
12769 =item SYNOPSIS
12770
12771 =item ABSTRACT
12772
12773 =item DESCRIPTION
12774
12775 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
12776 Encode::decode("Guess" ...), Encode::Guess->guess($data),
12777 guess_encoding($data, [, I<list of suspects>])
12778
12779 =item CAVEATS
12780
12781 =item TO DO
12782
12783 =item SEE ALSO
12784
12785 =back
12786
12787 =head2 Encode::JP - Japanese Encodings
12788
12789 =over 4
12790
12791 =item SYNOPSIS
12792
12793 =item ABSTRACT
12794
12795 =item DESCRIPTION
12796
12797 =item Note on ISO-2022-JP(-1)?
12798
12799 =item BUGS
12800
12801 =item SEE ALSO
12802
12803 =back
12804
12805 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
12806
12807 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
12808
12809 =head2 Encode::KR - Korean Encodings
12810
12811 =over 4
12812
12813 =item SYNOPSIS
12814
12815 =item DESCRIPTION
12816
12817 =item BUGS
12818
12819 =item SEE ALSO
12820
12821 =back
12822
12823 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
12824
12825 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
12826
12827 =over 4
12828
12829 =item SYNOPSIS
12830
12831 =item ABSTRACT
12832
12833 =item DESCRIPTION
12834
12835 =item BUGS
12836
12837 =item SEE ALSO
12838
12839 =back
12840
12841 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
12842
12843 =over 4
12844
12845 =item Overview
12846
12847 =item How does it work?
12848
12849 =item Line Buffering
12850
12851 =over 4
12852
12853 =item How can I tell whether my encoding fully supports PerlIO ?
12854
12855 =back
12856
12857 =item SEE ALSO
12858
12859 =back
12860
12861 =head2 Encode::Supported -- Encodings supported by Encode
12862
12863 =over 4
12864
12865 =item DESCRIPTION
12866
12867 =over 4
12868
12869 =item Encoding Names
12870
12871 =back
12872
12873 =item Supported Encodings
12874
12875 =over 4
12876
12877 =item Built-in Encodings
12878
12879 =item Encode::Unicode -- other Unicode encodings
12880
12881 =item Encode::Byte -- Extended ASCII
12882
12883 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
12884 the Cyrillic world, gsm0338 - Hentai Latin 1
12885
12886 =item CJK: Chinese, Japanese, Korean (Multibyte)
12887
12888 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
12889 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
12890 Encode::JIS2K -- JIS X 0213 encodings via CPAN
12891
12892 =item Miscellaneous encodings
12893
12894 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
12895
12896 =back
12897
12898 =item Unsupported encodings
12899
12900   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
12901 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
12902 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
12903 Various Mac encodings, (Mac) Indic encodings
12904
12905 =item Encoding vs. Charset -- terminology
12906
12907 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
12908
12909 =over 4
12910
12911 =item Microsoft-related naming mess
12912
12913 KS_C_5601-1987, GB2312, Big5, Shift_JIS
12914
12915 =back
12916
12917 =item Glossary
12918
12919 character repertoire, coded character set (CCS), character encoding scheme
12920 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
12921 UTF-16
12922
12923 =item See Also
12924
12925 =item References
12926
12927 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
12928 RFC, UC, Unicode Glossary
12929
12930 =over 4
12931
12932 =item Other Notable Sites
12933
12934 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
12935 "Introduction to i18n"
12936
12937 =item Offline sources
12938
12939 C<CJKV Information Processing> by Ken Lunde
12940
12941 =back
12942
12943 =back
12944
12945 =head2 Encode::Symbol - Symbol Encodings
12946
12947 =over 4
12948
12949 =item SYNOPSIS
12950
12951 =item ABSTRACT
12952
12953 =item DESCRIPTION
12954
12955 =item SEE ALSO
12956
12957 =back
12958
12959 =head2 Encode::TW - Taiwan-based Chinese Encodings
12960
12961 =over 4
12962
12963 =item SYNOPSIS
12964
12965 =item DESCRIPTION
12966
12967 =item NOTES
12968
12969 =item BUGS
12970
12971 =item SEE ALSO
12972
12973 =back
12974
12975 =head2 Encode::Unicode -- Various Unicode Transformation Formats
12976
12977 =over 4
12978
12979 =item SYNOPSIS
12980
12981 =item ABSTRACT
12982
12983 L<http://www.unicode.org/glossary/> says:, Quick Reference
12984
12985 =item Size, Endianness, and BOM
12986
12987 =over 4
12988
12989 =item by size
12990
12991 =item by endianness
12992
12993 BOM as integer when fetched in network byte order
12994
12995 =back
12996
12997 =item Surrogate Pairs
12998
12999 =item SEE ALSO
13000
13001 =back
13002
13003 =head2 Encode::Unicode::UTF7 -- UTF-7 encoding
13004
13005 =over 4
13006
13007 =item SYNOPSIS
13008
13009 =item ABSTRACT
13010
13011 =item In Practice
13012
13013 =item SEE ALSO
13014
13015 =back
13016
13017 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
13018 encodings
13019
13020 =over 4
13021
13022 =item SYNOPSIS
13023
13024 =item DESCRIPTION
13025
13026 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
13027 reference, e.g.:
13028
13029 =over 4
13030
13031 =item Alias overloading
13032
13033 =back
13034
13035 =item SEE ALSO
13036
13037 =back
13038
13039 =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm --
13040 Internally used by Encode::??::ISO_2022_*
13041
13042 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
13043 Encode::CN
13044
13045 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
13046 Encode
13047
13048 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
13049 Implementation Base Class
13050
13051 =over 4
13052
13053 =item SYNOPSIS
13054
13055 =item DESCRIPTION
13056
13057 =over 4
13058
13059 =item Methods you should implement
13060
13061 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
13062 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
13063
13064 =item Other methods defined in Encode::Encodings
13065
13066 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
13067
13068 =item Example: Encode::ROT13
13069
13070 =back
13071
13072 =item Why the heck Encode API is different?
13073
13074 =over 4
13075
13076 =item Compiled Encodings
13077
13078 =back
13079
13080 =item SEE ALSO
13081
13082 Scheme 1, Scheme 2, Other Schemes
13083
13084 =back
13085
13086 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
13087 data
13088
13089 =over 4
13090
13091 =item SYNOPSIS
13092
13093 =item ABSTRACT
13094
13095 =item DESCRIPTION
13096
13097 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
13098 Encode::decode("Guess" ...), Encode::Guess->guess($data),
13099 guess_encoding($data, [, I<list of suspects>])
13100
13101 =item CAVEATS
13102
13103 =item TO DO
13104
13105 =item SEE ALSO
13106
13107 =back
13108
13109 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
13110 Encode::JP::2022_JP*
13111
13112 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
13113 by Encode::JP
13114
13115 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
13116 used by Encode::KR
13117
13118 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
13119 and 'Q' header encoding
13120
13121 =over 4
13122
13123 =item SYNOPSIS
13124
13125 =item ABSTRACT
13126
13127 =item DESCRIPTION
13128
13129 =item BUGS
13130
13131 =item SEE ALSO
13132
13133 =back
13134
13135 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
13136 on Encode and PerlIO
13137
13138 =over 4
13139
13140 =item Overview
13141
13142 =item How does it work?
13143
13144 =item Line Buffering
13145
13146 =over 4
13147
13148 =item How can I tell whether my encoding fully supports PerlIO ?
13149
13150 =back
13151
13152 =item SEE ALSO
13153
13154 =back
13155
13156 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
13157 supported by Encode
13158
13159 =over 4
13160
13161 =item DESCRIPTION
13162
13163 =over 4
13164
13165 =item Encoding Names
13166
13167 =back
13168
13169 =item Supported Encodings
13170
13171 =over 4
13172
13173 =item Built-in Encodings
13174
13175 =item Encode::Unicode -- other Unicode encodings
13176
13177 =item Encode::Byte -- Extended ASCII
13178
13179 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
13180 the Cyrillic world, gsm0338 - Hentai Latin 1
13181
13182 =item CJK: Chinese, Japanese, Korean (Multibyte)
13183
13184 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
13185 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
13186 Encode::JIS2K -- JIS X 0213 encodings via CPAN
13187
13188 =item Miscellaneous encodings
13189
13190 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
13191
13192 =back
13193
13194 =item Unsupported encodings
13195
13196   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
13197 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
13198 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
13199 Various Mac encodings, (Mac) Indic encodings
13200
13201 =item Encoding vs. Charset -- terminology
13202
13203 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
13204
13205 =over 4
13206
13207 =item Microsoft-related naming mess
13208
13209 KS_C_5601-1987, GB2312, Big5, Shift_JIS
13210
13211 =back
13212
13213 =item Glossary
13214
13215 character repertoire, coded character set (CCS), character encoding scheme
13216 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
13217 UTF-16
13218
13219 =item See Also
13220
13221 =item References
13222
13223 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
13224 RFC, UC, Unicode Glossary
13225
13226 =over 4
13227
13228 =item Other Notable Sites
13229
13230 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
13231 "Introduction to i18n"
13232
13233 =item Offline sources
13234
13235 C<CJKV Information Processing> by Ken Lunde
13236
13237 =back
13238
13239 =back
13240
13241 =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7
13242 encoding
13243
13244 =over 4
13245
13246 =item SYNOPSIS
13247
13248 =item ABSTRACT
13249
13250 =item In Practice
13251
13252 =item SEE ALSO
13253
13254 =back
13255
13256 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
13257
13258 =over 4
13259
13260 =item SYNOPSIS
13261
13262 =item ABSTRACT
13263
13264 =item Description
13265
13266 =over 4
13267
13268 =item Predefined Methods
13269
13270 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
13271 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
13272 $e-E<gt>bytes([$encoding])
13273
13274 =item Example: base64 transcoder
13275
13276 =item Operator Overloading
13277
13278 =back
13279
13280 =item SEE ALSO
13281
13282 =back
13283
13284 =head2 Encodencoding, encoding - allows you to write your script in
13285 non-ascii or non-utf8
13286
13287 =over 4
13288
13289 =item SYNOPSIS
13290
13291 =item ABSTRACT
13292
13293 =over 4
13294
13295 =item Literal Conversions
13296
13297 =item PerlIO layers for C<STD(IN|OUT)>
13298
13299 =item Implicit upgrading for byte strings
13300
13301 =back
13302
13303 =item FEATURES THAT REQUIRE 5.8.1
13304
13305 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
13306
13307 =item USAGE
13308
13309 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
13310 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
13311
13312 =item The Filter Option
13313
13314 =over 4
13315
13316 =item Filter-related changes at Encode version 1.87
13317
13318 =back
13319
13320 =item CAVEATS
13321
13322 =over 4
13323
13324 =item NOT SCOPED
13325
13326 =item DO NOT MIX MULTIPLE ENCODINGS
13327
13328 =item tr/// with ranges
13329
13330 Legend of characters above
13331
13332 =back
13333
13334 =item EXAMPLE - Greekperl
13335
13336 =item KNOWN PROBLEMS
13337
13338 literals in regex that are longer than 127 bytes, EBCDIC, format
13339
13340 =item HISTORY
13341
13342 =item SEE ALSO
13343
13344 =back
13345
13346 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
13347
13348 =over 4
13349
13350 =item SYNOPSIS
13351
13352 =item ABSTRACT
13353
13354 =item Description
13355
13356 =over 4
13357
13358 =item Predefined Methods
13359
13360 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
13361 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
13362 $e-E<gt>bytes([$encoding])
13363
13364 =item Example: base64 transcoder
13365
13366 =item Operator Overloading
13367
13368 =back
13369
13370 =item SEE ALSO
13371
13372 =back
13373
13374 =head2 English - use nice English (or awk) names for ugly punctuation
13375 variables
13376
13377 =over 4
13378
13379 =item SYNOPSIS
13380
13381 =item DESCRIPTION
13382
13383 =item PERFORMANCE
13384
13385 =back
13386
13387 =head2 Env - perl module that imports environment variables as scalars or
13388 arrays
13389
13390 =over 4
13391
13392 =item SYNOPSIS
13393
13394 =item DESCRIPTION
13395
13396 =item LIMITATIONS
13397
13398 =item AUTHOR
13399
13400 =back
13401
13402 =head2 Errno - System errno constants
13403
13404 =over 4
13405
13406 =item SYNOPSIS
13407
13408 =item DESCRIPTION
13409
13410 =item CAVEATS
13411
13412 =item AUTHOR
13413
13414 =item COPYRIGHT
13415
13416 =back
13417
13418 =head2 Exporter - Implements default import method for modules
13419
13420 =over 4
13421
13422 =item SYNOPSIS
13423
13424 =item DESCRIPTION
13425
13426 =over 4
13427
13428 =item How to Export
13429
13430 =item Selecting What To Export
13431
13432 =item How to Import
13433
13434 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
13435
13436 =back
13437
13438 =item Advanced features
13439
13440 =over 4
13441
13442 =item Specialised Import Lists
13443
13444 =item Exporting without using Exporter's import method
13445
13446 =item Exporting without inheriting from Exporter
13447
13448 =item Module Version Checking
13449
13450 =item Managing Unknown Symbols
13451
13452 =item Tag Handling Utility Functions
13453
13454 =item Generating combined tags
13455
13456 =item C<AUTOLOAD>ed Constants
13457
13458 =back
13459
13460 =back
13461
13462 =head2 Exporter::Heavy - Exporter guts
13463
13464 =over 4
13465
13466 =item SYNOPSIS
13467
13468 =item DESCRIPTION
13469
13470 =back
13471
13472 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
13473 Makefiles etc.
13474
13475 =over 4
13476
13477 =item SYNOPSIS
13478
13479 =item DESCRIPTION
13480
13481 =back
13482
13483 cat
13484
13485 eqtime src dst
13486
13487 rm_rf files...
13488
13489 rm_f files...
13490
13491 touch files ..
13492
13493 mv source... destination
13494
13495 cp source... destination
13496
13497 chmod mode files..
13498
13499 mkpath directory..
13500
13501 test_f file
13502
13503 dos2unix
13504
13505 =over 4
13506
13507 =item BUGS
13508
13509 =item SEE ALSO 
13510
13511 =item AUTHOR
13512
13513 =back
13514
13515 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
13516
13517 =over 4
13518
13519 =item SYNOPSIS
13520
13521 =item DESCRIPTION
13522
13523 B<test_harness>
13524
13525 =back
13526
13527 B<pod2man>
13528
13529 B<warn_if_old_packlist>
13530
13531 B<perllocal_install>
13532
13533 B<uninstall>
13534
13535 =head2 ExtUtils::Constant - generate XS code to import C header constants
13536
13537 =over 4
13538
13539 =item SYNOPSIS
13540
13541 =item DESCRIPTION
13542
13543 =item USAGE
13544
13545 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
13546
13547 =item FUNCTIONS
13548
13549 =back
13550
13551 C_stringify NAME
13552
13553 perl_stringify NAME
13554
13555 constant_types
13556
13557 memEQ_clause NAME, CHECKED_AT, INDENT
13558
13559 assign INDENT, TYPE, PRE, POST, VALUE..
13560
13561 return_clause
13562
13563 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
13564
13565 params WHAT
13566
13567 dump_names
13568
13569 dogfood
13570
13571 C_constant, name, type, value, macro, default, pre, post, def_pre =item
13572 def_post, utf8
13573
13574 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
13575
13576 autoload PACKAGE, VERSION, AUTOLOADER
13577
13578 WriteMakefileSnippet
13579
13580 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
13581 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
13582
13583 =over 4
13584
13585 =item AUTHOR
13586
13587 =back
13588
13589 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
13590
13591 =over 4
13592
13593 =item SYNOPSIS
13594
13595 =item DESCRIPTION
13596
13597 =item @EXPORT
13598
13599 =item FUNCTIONS
13600
13601 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
13602 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
13603
13604 =item EXAMPLES
13605
13606 =item SEE ALSO
13607
13608 =item AUTHOR
13609
13610 =back
13611
13612 =head2 ExtUtils::Install - install files from here to there
13613
13614 =over 4
13615
13616 =item SYNOPSIS
13617
13618 =item DESCRIPTION
13619
13620 =over 4
13621
13622 =item Functions
13623
13624 B<install>
13625
13626 =back
13627
13628 =back
13629
13630 B<install_default> I<DISCOURAGED>
13631
13632 B<uninstall>
13633
13634 B<pm_to_blib>
13635
13636 _autosplit
13637
13638 =over 4
13639
13640 =item ENVIRONMENT
13641
13642 B<PERL_INSTALL_ROOT>
13643
13644 =item AUTHOR
13645
13646 =item LICENSE
13647
13648 =back
13649
13650 =head2 ExtUtils::Installed - Inventory management of installed modules
13651
13652 =over 4
13653
13654 =item SYNOPSIS
13655
13656 =item DESCRIPTION
13657
13658 =item USAGE
13659
13660 =item FUNCTIONS
13661
13662 new(), modules(), files(), directories(), directory_tree(), validate(),
13663 packlist(), version()
13664
13665 =item EXAMPLE
13666
13667 =item AUTHOR
13668
13669 =back
13670
13671 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
13672
13673 =over 4
13674
13675 =item SYNOPSIS
13676
13677 =item DESCRIPTION
13678
13679 For static extensions, For dynamic extensions at build/link time, For
13680 dynamic extensions at load time
13681
13682 =over 4
13683
13684 =item EXTRALIBS
13685
13686 =item LDLOADLIBS and LD_RUN_PATH
13687
13688 =item BSLOADLIBS
13689
13690 =back
13691
13692 =item PORTABILITY
13693
13694 =over 4
13695
13696 =item VMS implementation
13697
13698 =item Win32 implementation
13699
13700 =back
13701
13702 =item SEE ALSO
13703
13704 =back
13705
13706 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
13707
13708 =over 4
13709
13710 =item SYNOPSIS
13711
13712 =item DESCRIPTION
13713
13714 =back
13715
13716 =head2 ExtUtils::MM_Any - Platform-agnostic MM methods
13717
13718 =over 4
13719
13720 =item SYNOPSIS
13721
13722 =item DESCRIPTION
13723
13724 =item Inherently Cross-Platform Methods
13725
13726 installvars
13727
13728 =back
13729
13730 os_flavor_is
13731
13732 blibdirs_target (o)
13733
13734 =over 4
13735
13736 =item File::Spec wrappers
13737
13738 catfile
13739
13740 =back
13741
13742 =over 4
13743
13744 =item Thought To Be Cross-Platform Methods
13745
13746 B<split_command>
13747
13748 =back
13749
13750 B<echo>
13751
13752 init_VERSION
13753
13754 wraplist
13755
13756 manifypods
13757
13758 manifypods_target
13759
13760 makemakerdflt_target
13761
13762 special_targets
13763
13764 POD2MAN_macro
13765
13766 test_via_harness
13767
13768 test_via_script
13769
13770 libscan
13771
13772 tool_autosplit
13773
13774 all_target
13775
13776 metafile_target
13777
13778 signature_target
13779
13780 metafile_addtomanifest_target
13781
13782 signature_addtomanifest_target
13783
13784 =over 4
13785
13786 =item Abstract methods
13787
13788 oneliner, B<quote_literal>, B<escape_newlines>, max_exec_len,
13789 B<init_others>, init_DIRFILESEP, init_linker, init_platform,
13790 platform_constants
13791
13792 =back
13793
13794 os_flavor
13795
13796 =over 4
13797
13798 =item AUTHOR
13799
13800 =back
13801
13802 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
13803 ExtUtils::MakeMaker
13804
13805 =over 4
13806
13807 =item SYNOPSIS
13808
13809 =item DESCRIPTION
13810
13811 =back
13812
13813 os_flavor (o)
13814
13815 init_linker
13816
13817 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
13818 ExtUtils::MakeMaker
13819
13820 =over 4
13821
13822 =item SYNOPSIS
13823
13824 =item DESCRIPTION
13825
13826 os_flavor (o)
13827
13828 =back
13829
13830 cflags (o)
13831
13832 replace_manpage_separator (o)
13833
13834 init_linker
13835
13836 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
13837
13838 =over 4
13839
13840 =item SYNOPSIS
13841
13842 =item DESCRIPTION
13843
13844 =over 4
13845
13846 =item Overridden methods
13847
13848 os_flavor
13849
13850 =back
13851
13852 =back
13853
13854 B<replace_manpage_separator>
13855
13856 =over 4
13857
13858 =item AUTHOR
13859
13860 =item SEE ALSO
13861
13862 =back
13863
13864 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
13865 ExtUtils::MakeMaker
13866
13867 =over 4
13868
13869 =item SYNOPSIS
13870
13871 =item DESCRIPTION
13872
13873 =back
13874
13875 maybe_command
13876
13877 guess_name
13878
13879 macify
13880
13881 patternify
13882
13883 init_main
13884
13885 init_others
13886
13887 init_platform, platform_constants
13888
13889 init_dirscan
13890
13891 init_VERSION (o)
13892
13893 special_targets (o)
13894
13895 static (o)
13896
13897 dlsyms (o)
13898
13899 dynamic (o)
13900
13901 clean (o)
13902
13903 clean_subdirs_target
13904
13905 realclean (o)
13906
13907 realclean_subdirs_target
13908
13909 rulez (o)
13910
13911 processPL (o)
13912
13913 os_flavor
13914
13915 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
13916 ExtUtils::MakeMaker
13917
13918 =over 4
13919
13920 =item SYNOPSIS
13921
13922 =item DESCRIPTION
13923
13924 =back
13925
13926 os_flavor
13927
13928 init_platform (o), platform_constants
13929
13930 const_cccmd (o)
13931
13932 static_lib (o)
13933
13934 dynamic_lib (o)
13935
13936 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
13937 ExtUtils::MakeMaker
13938
13939 =over 4
13940
13941 =item SYNOPSIS
13942
13943 =item DESCRIPTION
13944
13945 =item METHODS
13946
13947 init_dist (o)
13948
13949 =back
13950
13951 init_linker
13952
13953 os_flavor
13954
13955 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
13956
13957 =over 4
13958
13959 =item SYNOPSIS
13960
13961 =item DESCRIPTION
13962
13963 =over 4
13964
13965 =item Overridden methods
13966
13967 os_flavor
13968
13969 =back
13970
13971 =back
13972
13973 B<replace_manpage_separator>
13974
13975 =over 4
13976
13977 =item AUTHOR
13978
13979 =item SEE ALSO
13980
13981 =back
13982
13983 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
13984
13985 =over 4
13986
13987 =item SYNOPSIS
13988
13989 =item DESCRIPTION
13990
13991 =item METHODS
13992
13993 =back
13994
13995 =over 4
13996
13997 =item Methods
13998
13999 os_flavor (o)
14000
14001 =back
14002
14003 c_o (o)
14004
14005 cflags (o)
14006
14007 clean (o)
14008
14009 clean_subdirs_target
14010
14011 const_cccmd (o)
14012
14013 const_config (o)
14014
14015 const_loadlibs (o)
14016
14017 constants (o)
14018
14019 depend (o)
14020
14021 dir_target B<DEPRECATED>
14022
14023 init_DEST
14024
14025 init_dist
14026
14027 dist (o)
14028
14029 dist_basics (o)
14030
14031 dist_ci (o)
14032
14033 dist_core (o)
14034
14035 B<dist_target>
14036
14037 B<tardist_target>
14038
14039 B<zipdist_target>
14040
14041 B<tarfile_target>
14042
14043 zipfile_target
14044
14045 uutardist_target
14046
14047 shdist_target
14048
14049 distdir
14050
14051 dist_test
14052
14053 dlsyms (o)
14054
14055 dynamic (o)
14056
14057 dynamic_bs (o)
14058
14059 dynamic_lib (o)
14060
14061 exescan
14062
14063 extliblist
14064
14065 find_perl
14066
14067 find_tests
14068
14069 =over 4
14070
14071 =item Methods to actually produce chunks of text for the Makefile
14072
14073 fixin
14074
14075 =back
14076
14077 force (o)
14078
14079 guess_name
14080
14081 has_link_code
14082
14083 init_dirscan
14084
14085 init_DIRFILESEP
14086
14087 init_main
14088
14089 init_others
14090
14091 init_INST
14092
14093 init_INSTALL
14094
14095 init_linker
14096
14097 init_lib2arch
14098
14099 init_PERL
14100
14101 init_platform (o), platform_constants (o)
14102
14103 init_PERM
14104
14105 init_xs
14106
14107 install (o)
14108
14109 installbin (o)
14110
14111 linkext (o)
14112
14113 lsdir
14114
14115 macro (o)
14116
14117 makeaperl (o)
14118
14119 makefile (o)
14120
14121 maybe_command
14122
14123 needs_linking (o)
14124
14125 nicetext
14126
14127 parse_abstract
14128
14129 parse_version
14130
14131 pasthru (o)
14132
14133 perl_script
14134
14135 perldepend (o)
14136
14137 perm_rw (o)
14138
14139 perm_rwx (o)
14140
14141 pm_to_blib
14142
14143 post_constants (o)
14144
14145 post_initialize (o)
14146
14147 postamble (o)
14148
14149 ppd
14150
14151 prefixify
14152
14153 processPL (o)
14154
14155 quote_paren
14156
14157 realclean (o)
14158
14159 realclean_subdirs_target
14160
14161 replace_manpage_separator
14162
14163 oneliner (o)
14164
14165 quote_literal
14166
14167 escape_newlines
14168
14169 max_exec_len
14170
14171 static (o)
14172
14173 static_lib (o)
14174
14175 staticmake (o)
14176
14177 subdir_x (o)
14178
14179 subdirs (o)
14180
14181 test (o)
14182
14183 test_via_harness (override)
14184
14185 test_via_script (override)
14186
14187 tools_other (o)
14188
14189 tool_xsubpp (o)
14190
14191 all_target
14192
14193 top_targets (o)
14194
14195 writedoc
14196
14197 xs_c (o)
14198
14199 xs_cpp (o)
14200
14201 xs_o (o)
14202
14203 =over 4
14204
14205 =item SEE ALSO
14206
14207 =back
14208
14209 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
14210 ExtUtils::MakeMaker
14211
14212 =over 4
14213
14214 =item SYNOPSIS
14215
14216 =item DESCRIPTION
14217
14218 =over 4
14219
14220 =item Methods always loaded
14221
14222 wraplist
14223
14224 =back
14225
14226 =back
14227
14228 =over 4
14229
14230 =item Methods
14231
14232 guess_name (override)
14233
14234 =back
14235
14236 find_perl (override)
14237
14238 maybe_command (override)
14239
14240 perl_script (override)
14241
14242 replace_manpage_separator
14243
14244 init_DEST
14245
14246 init_DIRFILESEP
14247
14248 init_main (override)
14249
14250 init_others (override)
14251
14252 init_platform (override)
14253
14254 platform_constants
14255
14256 init_VERSION (override)
14257
14258 constants (override)
14259
14260 special_targets
14261
14262 cflags (override)
14263
14264 const_cccmd (override)
14265
14266 tool_sxubpp (override)
14267
14268 tools_other (override)
14269
14270 init_dist (override)
14271
14272 c_o (override)
14273
14274 xs_c (override)
14275
14276 xs_o (override)
14277
14278 dlsyms (override)
14279
14280 dynamic_lib (override)
14281
14282 dynamic_bs (override)
14283
14284 static_lib (override)
14285
14286 processPL (override)
14287
14288 installbin (override)
14289
14290 subdir_x (override)
14291
14292 clean (override)
14293
14294 clean_subdirs_target
14295
14296 realclean (override)
14297
14298 zipfile_target (o), tarfile_target (o), shdist_target (o)
14299
14300 dist_test (override)
14301
14302 install (override)
14303
14304 perldepend (override)
14305
14306 makefile (override)
14307
14308 find_tests (override)
14309
14310 test (override)
14311
14312 makeaperl (override)
14313
14314 nicetext (override)
14315
14316 prefixify (override)
14317
14318 oneliner (o)
14319
14320 B<echo> (o)
14321
14322 quote_literal
14323
14324 escape_newlines
14325
14326 max_exec_len
14327
14328 init_linker (o)
14329
14330 eliminate_macros
14331
14332 fixpath
14333
14334 os_flavor
14335
14336 blibdirs_target (override)
14337
14338 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
14339 ExtUtils::MakeMaker
14340
14341 =over 4
14342
14343 =item SYNOPSIS
14344
14345 =item DESCRIPTION
14346
14347 =back
14348
14349 =over 4
14350
14351 =item Overridden methods
14352
14353 B<dlsyms>
14354
14355 =back
14356
14357 replace_manpage_separator
14358
14359 B<maybe_command>
14360
14361 B<find_tests>
14362
14363 B<init_DIRFILESEP>
14364
14365 B<init_others>
14366
14367 init_platform (o), platform_constants (o)
14368
14369 special_targets (o)
14370
14371 static_lib (o)
14372
14373 dynamic_lib (o)
14374
14375 clean
14376
14377 init_linker
14378
14379 perl_script
14380
14381 xs_o (o)
14382
14383 pasthru (o)
14384
14385 oneliner (o)
14386
14387 max_exec_len
14388
14389 os_flavor
14390
14391 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
14392
14393 =over 4
14394
14395 =item SYNOPSIS
14396
14397 =item DESCRIPTION
14398
14399 =over 4
14400
14401 =item Overriden methods
14402
14403 dist_test
14404
14405 =back
14406
14407 =back
14408
14409 subdir_x
14410
14411 xs_c
14412
14413 xs_cpp
14414
14415 xs_o
14416
14417 clean_subdirs_target
14418
14419 realclean_subdirs_target
14420
14421 max_exec_len
14422
14423 os_flavor
14424
14425 =over 4
14426
14427 =item AUTHOR
14428
14429 =back
14430
14431 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
14432
14433 =over 4
14434
14435 =item SYNOPSIS
14436
14437 =item DESCRIPTION
14438
14439 =back
14440
14441 =head2 ExtUtils::MakeMaker - Create a module Makefile
14442
14443 =over 4
14444
14445 =item SYNOPSIS
14446
14447 =item DESCRIPTION
14448
14449 =over 4
14450
14451 =item How To Write A Makefile.PL
14452
14453 =item Default Makefile Behaviour
14454
14455 =item make test
14456
14457 =item make testdb
14458
14459 =item make install
14460
14461 =item PREFIX and LIB attribute
14462
14463 =item AFS users
14464
14465 =item Static Linking of a new Perl Binary
14466
14467 =item Determination of Perl Library and Installation Locations
14468
14469 =item Which architecture dependent directory?
14470
14471 =item Using Attributes and Parameters
14472
14473 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
14474 CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS,
14475 EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN,
14476 FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB,
14477 INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
14478 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB,
14479 INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLVENDORARCH,
14480 INSTALLVENDORBIN, INSTALLVENDORLIB, INSTALLVENDORMAN1DIR,
14481 INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR,
14482 INST_MAN3DIR, INST_SCRIPT, LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS,
14483 LINKTYPE, MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET,
14484 MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT,
14485 OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB,
14486 PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW,
14487 PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
14488 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT,
14489 PRINT_PREREQ, SITEPREFIX, SIGN, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST,
14490 VERSION, VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION
14491
14492 =item Additional lowercase attributes
14493
14494 clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean,
14495 test, tool_autosplit
14496
14497 =item Overriding MakeMaker Methods
14498
14499 =item The End Of Cargo Cult Programming
14500
14501 C<<MAN3PODS => ' '>>
14502
14503 =item Hintsfile support
14504
14505 =item Distribution Support
14506
14507    make distcheck,    make skipcheck,    make distclean,    make manifest, 
14508   make distdir,   make disttest,    make tardist,    make dist,    make
14509 uutardist,    make shdist,    make zipdist,    make ci
14510
14511 =item Module Meta-Data
14512
14513 =item Disabling an extension
14514
14515 =item Other Handy Functions
14516
14517 prompt
14518
14519 =back
14520
14521 =item ENVIRONMENT
14522
14523 PERL_MM_OPT, PERL_MM_USE_DEFAULT
14524
14525 =item SEE ALSO
14526
14527 =item AUTHORS
14528
14529 =item LICENSE
14530
14531 =back
14532
14533 =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About
14534 MakeMaker
14535
14536 =over 4
14537
14538 =item DESCRIPTION
14539
14540 =over 4
14541
14542 =item Module Installation
14543
14544 How do I keep from installing man pages?, How do I use a module without
14545 installing it?
14546
14547 =item Philosophy and History
14548
14549 Why not just use <insert other build config tool here>?, What is
14550 Module::Build and how does it relate to MakeMaker?, pure perl.  no make, no
14551 shell commands, easier to customize, cleaner internals, less cruft
14552
14553 =item Module Writing
14554
14555 How do I keep my $VERSION up to date without resetting it manually?, What's
14556 this F<META.yml> thing and how did it get in my F<MANIFEST>?!
14557
14558 =item XS
14559
14560 How to I prevent "object version X.XX does not match bootstrap parameter
14561 Y.YY" errors?, How do I make two or more XS files coexist in the same
14562 directory?
14563
14564 =back
14565
14566 =item PATCHING
14567
14568 =item AUTHOR
14569
14570 =item SEE ALSO
14571
14572 =back
14573
14574 =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker
14575
14576 =over 4
14577
14578 =item SYNOPSIS
14579
14580 =item DESCRIPTION
14581
14582 =over 4
14583
14584 =item The Mantra
14585
14586 =item The Layout
14587
14588 Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP,
14589 bin/
14590
14591 =back
14592
14593 =item SEE ALSO
14594
14595 =back
14596
14597 =head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm
14598
14599 =over 4
14600
14601 =item SYNOPSIS
14602
14603 =item DESCRIPTION
14604
14605 =back
14606
14607 =head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm
14608
14609 =over 4
14610
14611 =item SYNOPSIS
14612
14613 =item DESCRIPTION
14614
14615 =back
14616
14617 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
14618
14619 =over 4
14620
14621 =item SYNOPSIS
14622
14623 =item DESCRIPTION
14624
14625 =over 4
14626
14627 =item Functions
14628
14629 mkmanifest
14630
14631 =back
14632
14633 =back
14634
14635 manifind
14636
14637 manicheck
14638
14639 filecheck
14640
14641 fullcheck
14642
14643 skipcheck
14644
14645 maniread
14646
14647 manicopy
14648
14649 maniadd
14650
14651 =over 4
14652
14653 =item MANIFEST
14654
14655 =item MANIFEST.SKIP
14656
14657 =item EXPORT_OK
14658
14659 =item GLOBAL VARIABLES
14660
14661 =back
14662
14663 =over 4
14664
14665 =item DIAGNOSTICS
14666
14667 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
14668 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
14669
14670 =item ENVIRONMENT
14671
14672 B<PERL_MM_MANIFEST_DEBUG>
14673
14674 =item SEE ALSO
14675
14676 =item AUTHOR
14677
14678 =back
14679
14680 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
14681
14682 =over 4
14683
14684 =item SYNOPSIS
14685
14686 =item DESCRIPTION
14687
14688 =item SEE ALSO
14689
14690 =back
14691
14692 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
14693
14694 =over 4
14695
14696 =item SYNOPSIS
14697
14698 =item DESCRIPTION
14699
14700 =back
14701
14702 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
14703 extension
14704
14705 =over 4
14706
14707 =item SYNOPSIS
14708
14709 =item DESCRIPTION
14710
14711 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
14712
14713 =item AUTHOR
14714
14715 =item REVISION
14716
14717 =back
14718
14719 =head2 ExtUtils::Packlist - manage .packlist files
14720
14721 =over 4
14722
14723 =item SYNOPSIS
14724
14725 =item DESCRIPTION
14726
14727 =item USAGE
14728
14729 =item FUNCTIONS
14730
14731 new(), read(), write(), validate(), packlist_file()
14732
14733 =item EXAMPLE
14734
14735 =item AUTHOR
14736
14737 =back
14738
14739 =head2 ExtUtils::testlib - add blib/* directories to @INC
14740
14741 =over 4
14742
14743 =item SYNOPSIS
14744
14745 =item DESCRIPTION
14746
14747 =back
14748
14749 =head2 Fatal - replace functions with equivalents which succeed or die
14750
14751 =over 4
14752
14753 =item SYNOPSIS
14754
14755 =item DESCRIPTION
14756
14757 =item AUTHOR
14758
14759 =back
14760
14761 =head2 Fcntl - load the C Fcntl.h defines
14762
14763 =over 4
14764
14765 =item SYNOPSIS
14766
14767 =item DESCRIPTION
14768
14769 =item NOTE
14770
14771 =item EXPORTED SYMBOLS
14772
14773 =back
14774
14775 =head2 File::Basename, fileparse - split a pathname into pieces
14776
14777 =over 4
14778
14779 =item SYNOPSIS
14780
14781 =item DESCRIPTION
14782
14783 fileparse_set_fstype, fileparse
14784
14785 =item EXAMPLES
14786
14787 C<basename>, C<dirname>
14788
14789 =back
14790
14791 =head2 File::CheckTree, validate - run many filetest checks on a tree
14792
14793 =over 4
14794
14795 =item SYNOPSIS
14796
14797 =item DESCRIPTION
14798
14799 =item AUTHOR
14800
14801 =item HISTORY
14802
14803 =back
14804
14805 =head2 File::Compare - Compare files or filehandles
14806
14807 =over 4
14808
14809 =item SYNOPSIS
14810
14811 =item DESCRIPTION
14812
14813 =item RETURN
14814
14815 =item AUTHOR
14816
14817 =back
14818
14819 =head2 File::Copy - Copy files or filehandles
14820
14821 =over 4
14822
14823 =item SYNOPSIS
14824
14825 =item DESCRIPTION
14826
14827 =over 4
14828
14829 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
14830
14831 rmscopy($from,$to[,$date_flag])
14832
14833 =back
14834
14835 =item RETURN
14836
14837 =item NOTES
14838
14839 =item AUTHOR
14840
14841 =back
14842
14843 =head2 File::DosGlob - DOS like globbing and then some
14844
14845 =over 4
14846
14847 =item SYNOPSIS
14848
14849 =item DESCRIPTION
14850
14851 =item NOTES
14852
14853 =item EXPORTS (by request only)
14854
14855 =item BUGS
14856
14857 =item AUTHOR
14858
14859 =item HISTORY
14860
14861 =item SEE ALSO
14862
14863 =back
14864
14865 =head2 File::Find - Traverse a directory tree.
14866
14867 =over 4
14868
14869 =item SYNOPSIS
14870
14871 =item DESCRIPTION
14872
14873 B<find>, B<finddepth>
14874
14875 =over 4
14876
14877 =item %options
14878
14879 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
14880 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
14881 C<untaint>, C<untaint_pattern>, C<untaint_skip>
14882
14883 =item The wanted function
14884
14885 C<$File::Find::dir> is the current directory name,, C<$_> is the current
14886 filename within that directory, C<$File::Find::name> is the complete
14887 pathname to the file
14888
14889 =back
14890
14891 =item WARNINGS
14892
14893 =item CAVEAT
14894
14895 $dont_use_nlink, symlinks
14896
14897 =item NOTES
14898
14899 =item BUGS AND CAVEATS
14900
14901 =item HISTORY
14902
14903 =back
14904
14905 =head2 File::Glob - Perl extension for BSD glob routine
14906
14907 =over 4
14908
14909 =item SYNOPSIS
14910
14911 =item DESCRIPTION
14912
14913 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
14914 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
14915 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
14916
14917 =item DIAGNOSTICS
14918
14919 C<GLOB_NOSPACE>, C<GLOB_ABEND>
14920
14921 =item NOTES
14922
14923 =item AUTHOR
14924
14925 =back
14926
14927 =head2 File::Path - create or remove directory trees
14928
14929 =over 4
14930
14931 =item SYNOPSIS
14932
14933 =item DESCRIPTION
14934
14935 =item DIAGNOSTICS
14936
14937 =item AUTHORS
14938
14939 =back
14940
14941 =head2 File::Spec - portably perform operations on file names
14942
14943 =over 4
14944
14945 =item SYNOPSIS
14946
14947 =item DESCRIPTION
14948
14949 =item METHODS
14950
14951 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
14952 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
14953 splitdir, catpath(), abs2rel, rel2abs()
14954
14955 =item SEE ALSO
14956
14957 =item AUTHORS
14958
14959 =back
14960
14961 =head2 File::Spec::Cygwin - methods for Cygwin file specs
14962
14963 =over 4
14964
14965 =item SYNOPSIS
14966
14967 =item DESCRIPTION
14968
14969 =back
14970
14971 canonpath
14972
14973 file_name_is_absolute
14974
14975 tmpdir (override)
14976
14977 =head2 File::Spec::Epoc - methods for Epoc file specs
14978
14979 =over 4
14980
14981 =item SYNOPSIS
14982
14983 =item DESCRIPTION
14984
14985 =item AUTHORS
14986
14987 =back
14988
14989 canonpath()
14990
14991 =over 4
14992
14993 =item SEE ALSO
14994
14995 =back
14996
14997 =head2 File::Spec::Functions - portably perform operations on file names
14998
14999 =over 4
15000
15001 =item SYNOPSIS
15002
15003 =item DESCRIPTION
15004
15005 =over 4
15006
15007 =item Exports
15008
15009 =back
15010
15011 =item SEE ALSO
15012
15013 =back
15014
15015 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
15016
15017 =over 4
15018
15019 =item SYNOPSIS
15020
15021 =item DESCRIPTION
15022
15023 =item METHODS
15024
15025 canonpath
15026
15027 =back
15028
15029 catdir()
15030
15031 catfile
15032
15033 curdir
15034
15035 devnull
15036
15037 rootdir
15038
15039 tmpdir
15040
15041 updir
15042
15043 file_name_is_absolute
15044
15045 path
15046
15047 splitpath
15048
15049 splitdir
15050
15051 catpath
15052
15053 abs2rel
15054
15055 rel2abs
15056
15057 =over 4
15058
15059 =item AUTHORS
15060
15061 =item SEE ALSO
15062
15063 =back
15064
15065 =head2 File::Spec::OS2 - methods for OS/2 file specs
15066
15067 =over 4
15068
15069 =item SYNOPSIS
15070
15071 =item DESCRIPTION
15072
15073 tmpdir, splitpath
15074
15075 =back
15076
15077 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
15078 modules
15079
15080 =over 4
15081
15082 =item SYNOPSIS
15083
15084 =item DESCRIPTION
15085
15086 =item METHODS
15087
15088 canonpath()
15089
15090 =back
15091
15092 catdir()
15093
15094 catfile
15095
15096 curdir
15097
15098 devnull
15099
15100 rootdir
15101
15102 tmpdir
15103
15104 updir
15105
15106 no_upwards
15107
15108 case_tolerant
15109
15110 file_name_is_absolute
15111
15112 path
15113
15114 join
15115
15116 splitpath
15117
15118 splitdir
15119
15120 catpath()
15121
15122 abs2rel
15123
15124 rel2abs()
15125
15126 =over 4
15127
15128 =item SEE ALSO
15129
15130 =back
15131
15132 =head2 File::Spec::VMS - methods for VMS file specs
15133
15134 =over 4
15135
15136 =item SYNOPSIS
15137
15138 =item DESCRIPTION
15139
15140 eliminate_macros
15141
15142 =back
15143
15144 fixpath
15145
15146 =over 4
15147
15148 =item Methods always loaded
15149
15150 canonpath (override)
15151
15152 =back
15153
15154 catdir
15155
15156 catfile
15157
15158 curdir (override)
15159
15160 devnull (override)
15161
15162 rootdir (override)
15163
15164 tmpdir (override)
15165
15166 updir (override)
15167
15168 case_tolerant (override)
15169
15170 path (override)
15171
15172 file_name_is_absolute (override)
15173
15174 splitpath (override)
15175
15176 splitdir (override)
15177
15178 catpath (override)
15179
15180 abs2rel (override)
15181
15182 rel2abs (override)
15183
15184 =over 4
15185
15186 =item SEE ALSO
15187
15188 =back
15189
15190 =head2 File::Spec::Win32 - methods for Win32 file specs
15191
15192 =over 4
15193
15194 =item SYNOPSIS
15195
15196 =item DESCRIPTION
15197
15198 devnull
15199
15200 =back
15201
15202 tmpdir
15203
15204 catfile
15205
15206 canonpath
15207
15208 splitpath
15209
15210 splitdir
15211
15212 catpath
15213
15214 =over 4
15215
15216 =item Note For File::Spec::Win32 Maintainers
15217
15218 =back
15219
15220 =over 4
15221
15222 =item SEE ALSO
15223
15224 =back
15225
15226 =head2 File::Temp - return name and handle of a temporary file safely
15227
15228 =over 4
15229
15230 =item PORTABILITY
15231
15232 =item SYNOPSIS
15233
15234 =item DESCRIPTION
15235
15236 =back
15237
15238 =over 4
15239
15240 =item OO INTERFACE
15241
15242 B<new>
15243
15244 =back
15245
15246 B<filename>
15247
15248 B<DESTROY>
15249
15250 =over 4
15251
15252 =item FUNCTIONS
15253
15254 B<tempfile>
15255
15256 =back
15257
15258 B<tempdir>
15259
15260 =over 4
15261
15262 =item MKTEMP FUNCTIONS
15263
15264 B<mkstemp>
15265
15266 =back
15267
15268 B<mkstemps>
15269
15270 B<mkdtemp>
15271
15272 B<mktemp>
15273
15274 =over 4
15275
15276 =item POSIX FUNCTIONS
15277
15278 B<tmpnam>
15279
15280 =back
15281
15282 B<tmpfile>
15283
15284 =over 4
15285
15286 =item ADDITIONAL FUNCTIONS
15287
15288 B<tempnam>
15289
15290 =back
15291
15292 =over 4
15293
15294 =item UTILITY FUNCTIONS
15295
15296 B<unlink0>
15297
15298 =back
15299
15300 B<cmpstat>
15301
15302 B<unlink1>
15303
15304 =over 4
15305
15306 =item PACKAGE VARIABLES
15307
15308 B<safe_level>, STANDARD, MEDIUM, HIGH
15309
15310 =back
15311
15312 TopSystemUID
15313
15314 =over 4
15315
15316 =item WARNING
15317
15318 =over 4
15319
15320 =item Temporary files and NFS
15321
15322 =back
15323
15324 =item HISTORY
15325
15326 =item SEE ALSO
15327
15328 =item AUTHOR
15329
15330 =back
15331
15332 =head2 File::stat - by-name interface to Perl's built-in stat() functions
15333
15334 =over 4
15335
15336 =item SYNOPSIS
15337
15338 =item DESCRIPTION
15339
15340 =item BUGS
15341
15342 =item NOTE
15343
15344 =item AUTHOR
15345
15346 =back
15347
15348 =head2 FileCache - keep more files open than the system permits
15349
15350 =over 4
15351
15352 =item SYNOPSIS
15353
15354 =item DESCRIPTION
15355
15356 cacheout EXPR, cacheout MODE, EXPR
15357
15358 =item CAVEATS
15359
15360 =item BUGS
15361
15362 =item NOTES
15363
15364 =back
15365
15366 =head2 FileHandle - supply object methods for filehandles
15367
15368 =over 4
15369
15370 =item SYNOPSIS
15371
15372 =item DESCRIPTION
15373
15374 $fh->print, $fh->printf, $fh->getline, $fh->getlines
15375
15376 =item SEE ALSO
15377
15378 =back
15379
15380 =head2 Filter::Simple - Simplified source filtering
15381
15382 =over 4
15383
15384 =item SYNOPSIS
15385
15386 =item DESCRIPTION
15387
15388 =over 4
15389
15390 =item The Problem
15391
15392 =item A Solution
15393
15394 =item Disabling or changing <no> behaviour
15395
15396 =item All-in-one interface
15397
15398 =item Filtering only specific components of source code
15399
15400 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
15401 C<"all">
15402
15403 =item Filtering only the code parts of source code
15404
15405 Most source code ceases to be grammatically correct when it is broken up
15406 into the pieces between string literals and regexes. So the C<'code'>
15407 component filter behaves slightly differently from the other partial
15408 filters
15409 described in the previous section.
15410
15411 =item Using Filter::Simple with an explicit C<import> subroutine
15412
15413 =item Using Filter::Simple and Exporter together
15414
15415 =item How it works
15416
15417 =back
15418
15419 =item AUTHOR
15420
15421 =item COPYRIGHT
15422
15423 =back
15424
15425 =head2 Filter::Util::Call - Perl Source Filter Utility Module
15426
15427 =over 4
15428
15429 =item SYNOPSIS
15430
15431 =item DESCRIPTION
15432
15433 =over 4
15434
15435 =item B<use Filter::Util::Call>
15436
15437 =item B<import()>
15438
15439 =item B<filter() and anonymous sub>
15440
15441 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
15442
15443 =back
15444
15445 =item EXAMPLES
15446
15447 =over 4
15448
15449 =item Example 1: A simple filter.
15450
15451 =item Example 2: Using the context
15452
15453 =item Example 3: Using the context within the filter
15454
15455 =item Example 4: Using filter_del
15456
15457 =back
15458
15459 =item Filter::Simple
15460
15461 =item AUTHOR
15462
15463 =item DATE
15464
15465 =back
15466
15467 =head2 FindBin - Locate directory of original perl script
15468
15469 =over 4
15470
15471 =item SYNOPSIS
15472
15473 =item DESCRIPTION
15474
15475 =item EXPORTABLE VARIABLES
15476
15477 =item KNOWN ISSUES
15478
15479 =item KNOWN BUGS
15480
15481 =item AUTHORS
15482
15483 =item COPYRIGHT
15484
15485 =back
15486
15487 =head2 GDBM_File - Perl5 access to the gdbm library.
15488
15489 =over 4
15490
15491 =item SYNOPSIS
15492
15493 =item DESCRIPTION
15494
15495 =item AVAILABILITY
15496
15497 =item BUGS
15498
15499 =item SEE ALSO
15500
15501 =back
15502
15503 =head2 Getopt::Long - Extended processing of command line options
15504
15505 =over 4
15506
15507 =item SYNOPSIS
15508
15509 =item DESCRIPTION
15510
15511 =item Command Line Options, an Introduction
15512
15513 =item Getting Started with Getopt::Long
15514
15515 =over 4
15516
15517 =item Simple options
15518
15519 =item A little bit less simple options
15520
15521 =item Mixing command line option with other arguments
15522
15523 =item Options with values
15524
15525 =item Options with multiple values
15526
15527 =item Options with hash values
15528
15529 =item User-defined subroutines to handle options
15530
15531 =item Options with multiple names
15532
15533 =item Case and abbreviations
15534
15535 =item Summary of Option Specifications
15536
15537 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
15538 + [ I<desttype> ]
15539
15540 =back
15541
15542 =item Advanced Possibilities
15543
15544 =over 4
15545
15546 =item Object oriented interface
15547
15548 =item Thread Safety
15549
15550 =item Documentation and help texts
15551
15552 =item Storing options in a hash
15553
15554 =item Bundling
15555
15556 =item The lonesome dash
15557
15558 =item Argument callback
15559
15560 =back
15561
15562 =item Configuring Getopt::Long
15563
15564 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
15565 require_order, permute, bundling (default: disabled), bundling_override
15566 (default: disabled), ignore_case  (default: enabled), ignore_case_always
15567 (default: disabled), auto_version (default:disabled), auto_help
15568 (default:disabled), pass_through (default: disabled), prefix,
15569 prefix_pattern, debug (default: disabled)
15570
15571 =item Exportable Methods
15572
15573 VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage
15574
15575 =item Return values and Errors
15576
15577 =item Legacy
15578
15579 =over 4
15580
15581 =item Default destinations
15582
15583 =item Alternative option starters
15584
15585 =item Configuration variables
15586
15587 =back
15588
15589 =item Trouble Shooting
15590
15591 =over 4
15592
15593 =item GetOptions does not return a false result when an option is not
15594 supplied
15595
15596 =item GetOptions does not split the command line correctly
15597
15598 =item Undefined subroutine &main::GetOptions called
15599
15600 =item How do I put a "-?" option into a Getopt::Long?
15601
15602 =back
15603
15604 =item AUTHOR
15605
15606 =item COPYRIGHT AND DISCLAIMER
15607
15608 =back
15609
15610 =head2 Getopt::Std, getopt, getopts - Process single-character switches
15611 with switch clustering
15612
15613 =over 4
15614
15615 =item SYNOPSIS
15616
15617 =item DESCRIPTION
15618
15619 =item C<--help> and C<--version>
15620
15621 =back
15622
15623 =head2 Hash::Util - A selection of general-utility hash subroutines
15624
15625 =over 4
15626
15627 =item SYNOPSIS
15628
15629 =item DESCRIPTION
15630
15631 =over 4
15632
15633 =item Restricted hashes
15634
15635 lock_keys, unlock_keys
15636
15637 =back
15638
15639 =back
15640
15641 lock_value, unlock_value
15642
15643 B<lock_hash>, B<unlock_hash>
15644
15645 B<hash_seed>
15646
15647 =over 4
15648
15649 =item CAVEATS
15650
15651 =item AUTHOR
15652
15653 =item SEE ALSO
15654
15655 =back
15656
15657 =head2 I18N::Collate - compare 8-bit scalar data according to the current
15658 locale
15659
15660 =over 4
15661
15662 =item SYNOPSIS
15663
15664 =item DESCRIPTION
15665
15666 =back
15667
15668 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
15669 tags
15670
15671 =over 4
15672
15673 =item SYNOPSIS
15674
15675 =item DESCRIPTION
15676
15677 =back
15678
15679 the function is_language_tag($lang1)
15680
15681 the function extract_language_tags($whatever)
15682
15683 the function same_language_tag($lang1, $lang2)
15684
15685 the function similarity_language_tag($lang1, $lang2)
15686
15687 the function is_dialect_of($lang1, $lang2)
15688
15689 the function super_languages($lang1)
15690
15691 the function locale2language_tag($locale_identifier)
15692
15693 the function encode_language_tag($lang1)
15694
15695 the function alternate_language_tags($lang1)
15696
15697 the function @langs = panic_languages(@accept_languages)
15698
15699 =over 4
15700
15701 =item ABOUT LOWERCASING
15702
15703 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
15704
15705 =item SEE ALSO
15706
15707 =item COPYRIGHT
15708
15709 =item AUTHOR
15710
15711 =back
15712
15713 =head2 I18N::LangTags::List -- tags and names for human languages
15714
15715 =over 4
15716
15717 =item SYNOPSIS
15718
15719 =item DESCRIPTION
15720
15721 =item ABOUT LANGUAGE TAGS
15722
15723 =item LIST OF LANGUAGES
15724
15725 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} :
15726 Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} :
15727 Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian,
15728 {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)],
15729 {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic,
15730 {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy}
15731 : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} :
15732 Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} :
15733 Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae}
15734 : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} :
15735 Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai}
15736 : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} :
15737 Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} :
15738 Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber
15739 (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini,
15740 {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} :
15741 Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} :
15742 Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian
15743 (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central
15744 American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages],
15745 {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb}
15746 : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} :
15747 Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} :
15748 Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree,
15749 {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf}
15750 : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based
15751 Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} :
15752 Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} :
15753 Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru)
15754 Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri,
15755 {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch,
15756 {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi}
15757 : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} :
15758 English, {enm} : Old English (1100-1500), {ang} : Old English
15759 (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} :
15760 Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat}
15761 : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} :
15762 Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French
15763 (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} :
15764 Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan,
15765 {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian,
15766 {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High
15767 German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon}
15768 : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient
15769 Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} :
15770 Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian,
15771 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
15772 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
15773 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo,
15774 {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European
15775 (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua
15776 (International Auxiliary Language Association), {ie} : Interlingue, {iu} :
15777 Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} :
15778 Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian
15779 languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} :
15780 Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle,
15781 {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} :
15782 Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar}
15783 : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh,
15784 {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese,
15785 {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz,
15786 {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} :
15787 Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama,
15788 {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} :
15789 Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} :
15790 Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} :
15791 Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban
15792 (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui}
15793 : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai,
15794 {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili,
15795 {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} :
15796 Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} :
15797 Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} :
15798 Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai,
15799 [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} :
15800 Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} :
15801 Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)],
15802 {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple
15803 languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan,
15804 {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele,
15805 {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
15806 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
15807 {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} :
15808 Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} :
15809 Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi}
15810 : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} :
15811 Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
15812 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
15813 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
15814 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
15815 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
15816 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
15817 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
15818 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
15819 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
15820 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
15821 languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} :
15822 Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami,
15823 [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} :
15824 Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak,
15825 {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian,
15826 {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign
15827 Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} :
15828 Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave
15829 (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian,
15830 {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} :
15831 Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} :
15832 South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} :
15833 Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati,
15834 {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} :
15835 Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao,
15836 {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} :
15837 Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} :
15838 Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau,
15839 {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian,
15840 {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} :
15841 Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh}
15842 : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} :
15843 Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian,
15844 {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} :
15845 Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak}
15846 : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was}
15847 : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private
15848 Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} :
15849 Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
15850 : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu,
15851 {zun} : Zuni
15852
15853 =item SEE ALSO
15854
15855 =item COPYRIGHT AND DISCLAIMER
15856
15857 =item AUTHOR
15858
15859 =back
15860
15861 =head2 I18N::Langinfo - query locale information
15862
15863 =over 4
15864
15865 =item SYNOPSIS
15866
15867 =item DESCRIPTION
15868
15869 =over 4
15870
15871 =item EXPORT
15872
15873 =back
15874
15875 =item SEE ALSO
15876
15877 =item AUTHOR
15878
15879 =item COPYRIGHT AND LICENSE
15880
15881 =back
15882
15883 =head2 IO - load various IO modules
15884
15885 =over 4
15886
15887 =item SYNOPSIS
15888
15889 =item DESCRIPTION
15890
15891 =item DEPRECATED
15892
15893 =back
15894
15895 =head2 IO::Dir - supply object methods for directory handles
15896
15897 =over 4
15898
15899 =item SYNOPSIS
15900
15901 =item DESCRIPTION
15902
15903 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
15904 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
15905
15906 =item SEE ALSO
15907
15908 =item AUTHOR
15909
15910 =item COPYRIGHT
15911
15912 =back
15913
15914 =head2 IO::File - supply object methods for filehandles
15915
15916 =over 4
15917
15918 =item SYNOPSIS
15919
15920 =item DESCRIPTION
15921
15922 =item CONSTRUCTOR
15923
15924 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
15925
15926 =item METHODS
15927
15928 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
15929
15930 =item SEE ALSO
15931
15932 =item HISTORY
15933
15934 =back
15935
15936 =head2 IO::Handle - supply object methods for I/O handles
15937
15938 =over 4
15939
15940 =item SYNOPSIS
15941
15942 =item DESCRIPTION
15943
15944 =item CONSTRUCTOR
15945
15946 new (), new_from_fd ( FD, MODE )
15947
15948 =item METHODS
15949
15950 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
15951 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
15952 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
15953 $io->blocking ( [ BOOL ] ), $io->untaint
15954
15955 =item NOTE
15956
15957 =item SEE ALSO
15958
15959 =item BUGS
15960
15961 =item HISTORY
15962
15963 =back
15964
15965 =head2 IO::Pipe - supply object methods for pipes
15966
15967 =over 4
15968
15969 =item SYNOPSIS
15970
15971 =item DESCRIPTION
15972
15973 =item CONSTRUCTOR
15974
15975 new ( [READER, WRITER] )
15976
15977 =item METHODS
15978
15979 reader ([ARGS]), writer ([ARGS]), handles ()
15980
15981 =item SEE ALSO
15982
15983 =item AUTHOR
15984
15985 =item COPYRIGHT
15986
15987 =back
15988
15989 =head2 IO::Poll - Object interface to system poll call
15990
15991 =over 4
15992
15993 =item SYNOPSIS
15994
15995 =item DESCRIPTION
15996
15997 =item METHODS
15998
15999 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
16000 IO ), handles( [ EVENT_MASK ] )
16001
16002 =item SEE ALSO
16003
16004 =item AUTHOR
16005
16006 =item COPYRIGHT
16007
16008 =back
16009
16010 =head2 IO::Seekable - supply seek based methods for I/O objects
16011
16012 =over 4
16013
16014 =item SYNOPSIS
16015
16016 =item DESCRIPTION
16017
16018 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
16019 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
16020 $io->tell
16021
16022 =item SEE ALSO
16023
16024 =item HISTORY
16025
16026 =back
16027
16028 =head2 IO::Select - OO interface to the select system call
16029
16030 =over 4
16031
16032 =item SYNOPSIS
16033
16034 =item DESCRIPTION
16035
16036 =item CONSTRUCTOR
16037
16038 new ( [ HANDLES ] )
16039
16040 =item METHODS
16041
16042 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
16043 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
16044 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
16045
16046 =item EXAMPLE
16047
16048 =item AUTHOR
16049
16050 =item COPYRIGHT
16051
16052 =back
16053
16054 =head2 IO::Socket - Object interface to socket communications
16055
16056 =over 4
16057
16058 =item SYNOPSIS
16059
16060 =item DESCRIPTION
16061
16062 =item CONSTRUCTOR
16063
16064 new ( [ARGS] )
16065
16066 =item METHODS
16067
16068 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
16069 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
16070
16071 =item SEE ALSO
16072
16073 =item AUTHOR
16074
16075 =item COPYRIGHT
16076
16077 =back
16078
16079 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
16080
16081 =over 4
16082
16083 =item SYNOPSIS
16084
16085 =item DESCRIPTION
16086
16087 =item CONSTRUCTOR
16088
16089 new ( [ARGS] )
16090
16091 =over 4
16092
16093 =item METHODS
16094
16095 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
16096 ()
16097
16098 =back
16099
16100 =item SEE ALSO
16101
16102 =item AUTHOR
16103
16104 =item COPYRIGHT
16105
16106 =back
16107
16108 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
16109
16110 =over 4
16111
16112 =item SYNOPSIS
16113
16114 =item DESCRIPTION
16115
16116 =item CONSTRUCTOR
16117
16118 new ( [ARGS] )
16119
16120 =item METHODS
16121
16122 hostpath(), peerpath()
16123
16124 =item SEE ALSO
16125
16126 =item AUTHOR
16127
16128 =item COPYRIGHT
16129
16130 =back
16131
16132 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
16133 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::lib::IO::File, 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 )
16167
16168 =item SEE ALSO
16169
16170 =item HISTORY
16171
16172 =back
16173
16174 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
16175 handles
16176
16177 =over 4
16178
16179 =item SYNOPSIS
16180
16181 =item DESCRIPTION
16182
16183 =item CONSTRUCTOR
16184
16185 new (), new_from_fd ( FD, MODE )
16186
16187 =item METHODS
16188
16189 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
16190 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
16191 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
16192 $io->blocking ( [ BOOL ] ), $io->untaint
16193
16194 =item NOTE
16195
16196 =item SEE ALSO
16197
16198 =item BUGS
16199
16200 =item HISTORY
16201
16202 =back
16203
16204 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
16205
16206 =over 4
16207
16208 =item SYNOPSIS
16209
16210 =item DESCRIPTION
16211
16212 =item CONSTRUCTOR
16213
16214 new ( [READER, WRITER] )
16215
16216 =item METHODS
16217
16218 reader ([ARGS]), writer ([ARGS]), handles ()
16219
16220 =item SEE ALSO
16221
16222 =item AUTHOR
16223
16224 =item COPYRIGHT
16225
16226 =back
16227
16228 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
16229
16230 =over 4
16231
16232 =item SYNOPSIS
16233
16234 =item DESCRIPTION
16235
16236 =item METHODS
16237
16238 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
16239 IO ), handles( [ EVENT_MASK ] )
16240
16241 =item SEE ALSO
16242
16243 =item AUTHOR
16244
16245 =item COPYRIGHT
16246
16247 =back
16248
16249 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
16250 I/O objects
16251
16252 =over 4
16253
16254 =item SYNOPSIS
16255
16256 =item DESCRIPTION
16257
16258 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
16259 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
16260 $io->tell
16261
16262 =item SEE ALSO
16263
16264 =item HISTORY
16265
16266 =back
16267
16268 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
16269 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::lib::IO::Socket, IO::Socket - Object interface to socket
16296 communications
16297
16298 =over 4
16299
16300 =item SYNOPSIS
16301
16302 =item DESCRIPTION
16303
16304 =item CONSTRUCTOR
16305
16306 new ( [ARGS] )
16307
16308 =item METHODS
16309
16310 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
16311 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
16312
16313 =item SEE ALSO
16314
16315 =item AUTHOR
16316
16317 =item COPYRIGHT
16318
16319 =back
16320
16321 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
16322 AF_INET domain sockets
16323
16324 =over 4
16325
16326 =item SYNOPSIS
16327
16328 =item DESCRIPTION
16329
16330 =item CONSTRUCTOR
16331
16332 new ( [ARGS] )
16333
16334 =over 4
16335
16336 =item METHODS
16337
16338 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
16339 ()
16340
16341 =back
16342
16343 =item SEE ALSO
16344
16345 =item AUTHOR
16346
16347 =item COPYRIGHT
16348
16349 =back
16350
16351 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
16352 AF_UNIX domain sockets
16353
16354 =over 4
16355
16356 =item SYNOPSIS
16357
16358 =item DESCRIPTION
16359
16360 =item CONSTRUCTOR
16361
16362 new ( [ARGS] )
16363
16364 =item METHODS
16365
16366 hostpath(), peerpath()
16367
16368 =item SEE ALSO
16369
16370 =item AUTHOR
16371
16372 =item COPYRIGHT
16373
16374 =back
16375
16376 =head2 IPC::Msg - SysV Msg IPC object class
16377
16378 =over 4
16379
16380 =item SYNOPSIS
16381
16382 =item DESCRIPTION
16383
16384 =item METHODS
16385
16386 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
16387 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
16388 FLAGS ] ), stat
16389
16390 =item SEE ALSO
16391
16392 =item AUTHOR
16393
16394 =item COPYRIGHT
16395
16396 =back
16397
16398 =head2 IPC::Open2, open2 - open a process for both reading and writing
16399
16400 =over 4
16401
16402 =item SYNOPSIS
16403
16404 =item DESCRIPTION
16405
16406 =item WARNING 
16407
16408 =item SEE ALSO
16409
16410 =back
16411
16412 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
16413 handling
16414
16415 =over 4
16416
16417 =item SYNOPSIS
16418
16419 =item DESCRIPTION
16420
16421 =item WARNING
16422
16423 =back
16424
16425 =head2 IPC::Semaphore - SysV Semaphore IPC object class
16426
16427 =over 4
16428
16429 =item SYNOPSIS
16430
16431 =item DESCRIPTION
16432
16433 =item METHODS
16434
16435 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
16436 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
16437 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
16438 , VALUE ), stat
16439
16440 =item SEE ALSO
16441
16442 =item AUTHOR
16443
16444 =item COPYRIGHT
16445
16446 =back
16447
16448 =head2 IPC::SysV - SysV IPC constants
16449
16450 =over 4
16451
16452 =item SYNOPSIS
16453
16454 =item DESCRIPTION
16455
16456 ftok( PATH, ID )
16457
16458 =item SEE ALSO
16459
16460 =item AUTHORS
16461
16462 =item COPYRIGHT
16463
16464 =back
16465
16466 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
16467
16468 =over 4
16469
16470 =item SYNOPSIS
16471
16472 =item DESCRIPTION
16473
16474 =item METHODS
16475
16476 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
16477 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
16478 FLAGS ] ), stat
16479
16480 =item SEE ALSO
16481
16482 =item AUTHOR
16483
16484 =item COPYRIGHT
16485
16486 =back
16487
16488 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
16489 class
16490
16491 =over 4
16492
16493 =item SYNOPSIS
16494
16495 =item DESCRIPTION
16496
16497 =item METHODS
16498
16499 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
16500 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
16501 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
16502 , VALUE ), stat
16503
16504 =item SEE ALSO
16505
16506 =item AUTHOR
16507
16508 =item COPYRIGHT
16509
16510 =back
16511
16512 =head2 List::Util - A selection of general-utility list subroutines
16513
16514 =over 4
16515
16516 =item SYNOPSIS
16517
16518 =item DESCRIPTION
16519
16520 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
16521 BLOCK LIST, shuffle LIST, sum LIST
16522
16523 =item KNOWN BUGS
16524
16525 =item SUGGESTED ADDITIONS
16526
16527 =item COPYRIGHT
16528
16529 =back
16530
16531 =head2 List::Utilib::List::Util, List::Util - A selection of
16532 general-utility list subroutines
16533
16534 =over 4
16535
16536 =item SYNOPSIS
16537
16538 =item DESCRIPTION
16539
16540 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
16541 BLOCK LIST, shuffle LIST, sum LIST
16542
16543 =item KNOWN BUGS
16544
16545 =item SUGGESTED ADDITIONS
16546
16547 =item COPYRIGHT
16548
16549 =back
16550
16551 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
16552 general-utility scalar subroutines
16553
16554 =over 4
16555
16556 =item SYNOPSIS
16557
16558 =item DESCRIPTION
16559
16560 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
16561 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
16562 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
16563
16564 =item KNOWN BUGS
16565
16566 =item COPYRIGHT
16567
16568 =item BLATANT PLUG
16569
16570 =back
16571
16572 =head2 Locale::Constants - constants for Locale codes
16573
16574 =over 4
16575
16576 =item SYNOPSIS
16577
16578 =item DESCRIPTION
16579
16580 =item KNOWN BUGS AND LIMITATIONS
16581
16582 =item SEE ALSO
16583
16584 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
16585
16586 =item AUTHOR
16587
16588 =item COPYRIGHT
16589
16590 =back
16591
16592 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
16593
16594 =over 4
16595
16596 =item SYNOPSIS
16597
16598 =item DESCRIPTION
16599
16600 B<alpha-2>, B<alpha-3>, B<numeric>
16601
16602 =item CONVERSION ROUTINES
16603
16604 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
16605 country_code2code( CODE, CODESET, CODESET )
16606
16607 =item QUERY ROUTINES
16608
16609 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
16610
16611 =item SEMI-PRIVATE ROUTINES
16612
16613 =over 4
16614
16615 =item alias_code
16616
16617 =item rename_country
16618
16619 =back
16620
16621 =item EXAMPLES
16622
16623 =item DOMAIN NAMES
16624
16625 =item KNOWN BUGS AND LIMITATIONS
16626
16627 =item SEE ALSO
16628
16629 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
16630 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
16631 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
16632 http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
16633
16634 =item AUTHOR
16635
16636 =item COPYRIGHT
16637
16638 =back
16639
16640 =head2 Locale::Currency - ISO three letter codes for currency
16641 identification (ISO 4217)
16642
16643 =over 4
16644
16645 =item SYNOPSIS
16646
16647 =item DESCRIPTION
16648
16649 XTS, XXX
16650
16651 =item CONVERSION ROUTINES
16652
16653 code2currency(), currency2code()
16654
16655 =item QUERY ROUTINES
16656
16657 C<all_currency_codes()>, C<all_currency_names()>
16658
16659 =item EXAMPLES
16660
16661 =item KNOWN BUGS AND LIMITATIONS
16662
16663 =item SEE ALSO
16664
16665 Locale::Country, Locale::Script, ISO 4217:1995,
16666 http://www.bsi-global.com/iso4217currency
16667
16668 =item AUTHOR
16669
16670 =item COPYRIGHT
16671
16672 =back
16673
16674 =head2 Locale::Language - ISO two letter codes for language identification
16675 (ISO 639)
16676
16677 =over 4
16678
16679 =item SYNOPSIS
16680
16681 =item DESCRIPTION
16682
16683 =item CONVERSION ROUTINES
16684
16685 code2language(), language2code()
16686
16687 =item QUERY ROUTINES
16688
16689 C<all_language_codes()>, C<all_language_names()>
16690
16691 =item EXAMPLES
16692
16693 =item KNOWN BUGS AND LIMITATIONS
16694
16695 =item SEE ALSO
16696
16697 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
16698 http://lcweb.loc.gov/standards/iso639-2/langhome.html
16699
16700 =item AUTHOR
16701
16702 =item COPYRIGHT
16703
16704 =back
16705
16706 =head2 Locale::Maketext - framework for localization
16707
16708 =over 4
16709
16710 =item SYNOPSIS
16711
16712 =item DESCRIPTION
16713
16714 =item QUICK OVERVIEW
16715
16716 =item METHODS
16717
16718 =over 4
16719
16720 =item Construction Methods
16721
16722 =item The "maketext" Method
16723
16724 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
16725
16726 =item Utility Methods
16727
16728 $language->quant($number, $singular), $language->quant($number, $singular,
16729 $plural), $language->quant($number, $singular, $plural, $negative),
16730 $language->numf($number), $language->sprintf($format, @items),
16731 $language->language_tag(), $language->encoding()
16732
16733 =item Language Handle Attributes and Internals
16734
16735 =back
16736
16737 =item LANGUAGE CLASS HIERARCHIES
16738
16739 =item ENTRIES IN EACH LEXICON
16740
16741 =item BRACKET NOTATION
16742
16743 =item AUTO LEXICONS
16744
16745 =item CONTROLLING LOOKUP FAILURE
16746
16747 =item HOW TO USE MAKETEXT
16748
16749 =item SEE ALSO
16750
16751 =item COPYRIGHT AND DISCLAIMER
16752
16753 =item AUTHOR
16754
16755 =back
16756
16757 =head2 Locale::Maketext::TPJ13 -- article about software localization
16758
16759 =over 4
16760
16761 =item SYNOPSIS
16762
16763 =item DESCRIPTION
16764
16765 =item Localization and Perl: gettext breaks, Maketext fixes
16766
16767 =over 4
16768
16769 =item A Localization Horror Story: It Could Happen To You
16770
16771 =item The Linguistic View
16772
16773 =item Breaking gettext
16774
16775 =item Replacing gettext
16776
16777 =item Buzzwords: Abstraction and Encapsulation
16778
16779 =item Buzzword: Isomorphism
16780
16781 =item Buzzword: Inheritance
16782
16783 =item Buzzword: Concision
16784
16785 =item The Devil in the Details
16786
16787 =item The Proof in the Pudding: Localizing Web Sites
16788
16789 =item References
16790
16791 =back
16792
16793 =back
16794
16795 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
16796
16797 =over 4
16798
16799 =item SYNOPSIS
16800
16801 =item DESCRIPTION
16802
16803 B<alpha-2>, B<alpha-3>, B<numeric>
16804
16805 =over 4
16806
16807 =item SPECIAL CODES
16808
16809 =back
16810
16811 =item CONVERSION ROUTINES
16812
16813 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
16814 script_code2code( CODE, CODESET, CODESET )
16815
16816 =item QUERY ROUTINES
16817
16818 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
16819
16820 =item EXAMPLES
16821
16822 =item KNOWN BUGS AND LIMITATIONS
16823
16824 =item SEE ALSO
16825
16826 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
16827 http://www.evertype.com/standards/iso15924/
16828
16829 =item AUTHOR
16830
16831 =item COPYRIGHT
16832
16833 =back
16834
16835 =head2 MIME::Base64 - Encoding and decoding of base64 strings
16836
16837 =over 4
16838
16839 =item SYNOPSIS
16840
16841 =item DESCRIPTION
16842
16843 encode_base64($str), encode_base64($str, $eol);, decode_base64($str)
16844
16845 =item DIAGNOSTICS
16846
16847 Premature end of base64 data, Premature padding of base64 data
16848
16849 =item EXAMPLES
16850
16851 =item COPYRIGHT
16852
16853 =item SEE ALSO
16854
16855 =back
16856
16857 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
16858 of quoted-printable strings
16859
16860 =over 4
16861
16862 =item SYNOPSIS
16863
16864 =item DESCRIPTION
16865
16866 encode_qp($str), encode_qp($str, $eol), decode_qp($str);
16867
16868 =item COPYRIGHT
16869
16870 =item SEE ALSO
16871
16872 =back
16873
16874 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
16875 strings
16876
16877 =over 4
16878
16879 =item SYNOPSIS
16880
16881 =item DESCRIPTION
16882
16883 encode_qp($str), encode_qp($str, $eol), decode_qp($str);
16884
16885 =item COPYRIGHT
16886
16887 =item SEE ALSO
16888
16889 =back
16890
16891 =head2 Math::BigFloat - Arbitrary size floating point math package
16892
16893 =over 4
16894
16895 =item SYNOPSIS
16896
16897 =item DESCRIPTION
16898
16899 =over 4
16900
16901 =item Canonical notation
16902
16903 =item Output
16904
16905 =item C<mantissa()>, C<exponent()> and C<parts()>
16906
16907 =item Accuracy vs. Precision
16908
16909 =item Rounding
16910
16911 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
16912 ), fround  ( -$scale ) and fround ( 0 )
16913
16914 =back
16915
16916 =item EXAMPLES
16917
16918   # not ready yet
16919
16920 =item Autocreating constants
16921
16922 =over 4
16923
16924 =item Math library
16925
16926 =item Using Math::BigInt::Lite
16927
16928 =back
16929
16930 =item BUGS
16931
16932 =item CAVEATS
16933
16934 stringify, bstr(), bdiv, Modifying and =, bpow
16935
16936 =item SEE ALSO
16937
16938 =item LICENSE
16939
16940 =item AUTHORS
16941
16942 =back
16943
16944 =head2 Math::BigInt - Arbitrary size integer math package
16945
16946 =over 4
16947
16948 =item SYNOPSIS
16949
16950 =item DESCRIPTION
16951
16952 Input, Output
16953
16954 =item METHODS
16955
16956 =over 4
16957
16958 =item config
16959
16960 =item accuracy
16961
16962 =item precision
16963
16964 =item brsft
16965
16966 =item new
16967
16968 =item bnan
16969
16970 =item bzero
16971
16972 =item binf
16973
16974 =item bone
16975
16976 =item is_one()/is_zero()/is_nan()/is_inf()
16977
16978 =item is_pos()/is_neg()
16979
16980         $x->is_pos();                   # true if >= 0
16981         $x->is_neg();                   # true if <  0
16982
16983 =item is_odd()/is_even()/is_int()
16984
16985 =item bcmp
16986
16987 =item bacmp
16988
16989 =item sign
16990
16991 =item digit
16992
16993 =item bneg
16994
16995 =item babs
16996
16997 =item bnorm
16998
16999 =item bnot
17000
17001 =item binc
17002
17003 =item bdec
17004
17005 =item badd
17006
17007 =item bsub
17008
17009 =item bmul
17010
17011 =item bdiv
17012
17013 =item bmod
17014
17015 =item bmodinv
17016
17017 =item bmodpow
17018
17019 =item bpow
17020
17021 =item blsft
17022
17023 =item brsft
17024
17025 =item band
17026
17027 =item bior
17028
17029 =item bxor
17030
17031 =item bnot
17032
17033 =item bsqrt
17034
17035 =item bfac
17036
17037 =item round
17038
17039 =item bround
17040
17041 =item bfround
17042
17043 =item bfloor
17044
17045 =item bceil
17046
17047 =item bgcd
17048
17049 =item blcm
17050
17051 =item exponent
17052
17053 =item mantissa
17054
17055 =item parts
17056
17057 =item copy
17058
17059 =item as_int
17060
17061 =item bsstr
17062
17063 =item as_hex
17064
17065 =item as_bin
17066
17067 =back
17068
17069 =item ACCURACY and PRECISION
17070
17071 =over 4
17072
17073 =item Precision P
17074
17075 =item Accuracy A
17076
17077 =item Fallback F
17078
17079 =item Rounding mode R
17080
17081 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
17082 (significant digits), Setting/Accessing, Creating numbers, Usage,
17083 Precedence, Overriding globals, Local settings, Rounding, Default values,
17084 Remarks
17085
17086 =back
17087
17088 =item INTERNALS
17089
17090 =over 4
17091
17092 =item MATH LIBRARY
17093
17094 =item SIGN
17095
17096 =item mantissa(), exponent() and parts()
17097
17098 =back
17099
17100 =item EXAMPLES
17101
17102   use Math::BigInt;
17103
17104 =item Autocreating constants
17105
17106 =item PERFORMANCE
17107
17108 =over 4
17109
17110 =item Alternative math libraries
17111
17112 =item SUBCLASSING
17113
17114 =back
17115
17116 =item Subclassing Math::BigInt
17117
17118 =item UPGRADING
17119
17120 =over 4
17121
17122 =item Auto-upgrade
17123
17124 bsqrt(), div(), blog()
17125
17126 =back
17127
17128 =item BUGS
17129
17130 broot() does not work, Out of Memory!, Fails to load Calc on Perl prior
17131 5.6.0
17132
17133 =item CAVEATS
17134
17135 bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling,
17136 Modifying and =, bpow, Overloading -$x, Mixing different object types,
17137 bsqrt(), brsft()
17138
17139 =item LICENSE
17140
17141 =item SEE ALSO
17142
17143 =item AUTHORS
17144
17145 =back
17146
17147 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
17148
17149 =over 4
17150
17151 =item SYNOPSIS
17152
17153 =item DESCRIPTION
17154
17155 =item STORAGE
17156
17157 =item METHODS
17158
17159 =item WRAP YOUR OWN
17160
17161 =item LICENSE
17162
17163 This program is free software; you may redistribute it and/or modify it
17164 under
17165 the same terms as Perl itself. 
17166
17167 =item AUTHORS
17168
17169 =item SEE ALSO
17170
17171 =back
17172
17173 =head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code
17174
17175 =over 4
17176
17177 =item SYNOPSIS
17178
17179 =item DESCRIPTION
17180
17181 =item METHODS
17182
17183 =item LICENSE
17184
17185 This program is free software; you may redistribute it and/or modify it
17186 under
17187 the same terms as Perl itself. 
17188
17189 =item AUTHORS
17190
17191 =item SEE ALSO
17192
17193 =back
17194
17195 =head2 Math::BigRat - arbitrarily big rational numbers
17196
17197 =over 4
17198
17199 =item SYNOPSIS
17200
17201 =item DESCRIPTION
17202
17203 =over 4
17204
17205 =item MATH LIBRARY
17206
17207 =back
17208
17209 =item METHODS
17210
17211 =over 4
17212
17213 =item new()
17214
17215 =item numerator()
17216
17217 =item denominator()
17218
17219         $d = $x->denominator();
17220
17221 =item parts()
17222
17223 =item as_number()
17224
17225 =item bfac()
17226
17227 =item blog()
17228
17229 =item bround()/round()/bfround()
17230
17231 =item bmod()
17232
17233 =item is_one()
17234
17235 =item is_zero()
17236
17237 =item is_positive()
17238
17239 =item is_negative()
17240
17241 =item is_int()
17242
17243 =item is_odd()
17244
17245 =item is_even()
17246
17247 =item bceil()
17248
17249 =item bfloor()
17250
17251         $x->bfloor();
17252
17253 =item bsqrt()
17254
17255         $x->bsqrt();
17256
17257 =item config
17258
17259 =back
17260
17261 =item BUGS
17262
17263 inf handling (partial), NaN handling (partial), rounding (not implemented
17264 except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(),
17265 blog(), bmodinv() and bmodpow() (partial)
17266
17267 =item LICENSE
17268
17269 =item SEE ALSO
17270
17271 =item AUTHORS
17272
17273 =back
17274
17275 =head2 Math::Complex - complex numbers and associated mathematical
17276 functions
17277
17278 =over 4
17279
17280 =item SYNOPSIS
17281
17282 =item DESCRIPTION
17283
17284 =item OPERATIONS
17285
17286 =item CREATION
17287
17288 =item STRINGIFICATION
17289
17290 =over 4
17291
17292 =item CHANGED IN PERL 5.6
17293
17294 =back
17295
17296 =item USAGE
17297
17298 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
17299
17300 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
17301
17302 =item BUGS
17303
17304 =item AUTHORS
17305
17306 =back
17307
17308 =head2 Math::Trig - trigonometric functions
17309
17310 =over 4
17311
17312 =item SYNOPSIS
17313
17314 =item DESCRIPTION
17315
17316 =item TRIGONOMETRIC FUNCTIONS
17317
17318 B<tan>
17319
17320 =over 4
17321
17322 =item ERRORS DUE TO DIVISION BY ZERO
17323
17324 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
17325
17326 =back
17327
17328 =item PLANE ANGLE CONVERSIONS
17329
17330 =item RADIAL COORDINATE CONVERSIONS
17331
17332 =over 4
17333
17334 =item COORDINATE SYSTEMS
17335
17336 =item 3-D ANGLE CONVERSIONS
17337
17338 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
17339 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
17340
17341 =back
17342
17343 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
17344
17345 =item EXAMPLES
17346
17347 =over 4
17348
17349 =item CAVEAT FOR GREAT CIRCLE FORMULAS
17350
17351 =back
17352
17353 =item BUGS
17354
17355 =item AUTHORS
17356
17357 =back
17358
17359 =head2 Memoize - Make functions faster by trading space for time
17360
17361 =over 4
17362
17363 =item SYNOPSIS
17364
17365 =item DESCRIPTION
17366
17367 =item DETAILS
17368
17369 =item OPTIONS
17370
17371 =over 4
17372
17373 =item INSTALL
17374
17375 =item NORMALIZER
17376
17377 =item C<SCALAR_CACHE>, C<LIST_CACHE>
17378
17379 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
17380
17381 =back
17382
17383 =item OTHER FACILITIES
17384
17385 =over 4
17386
17387 =item C<unmemoize>
17388
17389 =item C<flush_cache>
17390
17391 =back
17392
17393 =item CAVEATS
17394
17395 =item PERSISTENT CACHE SUPPORT
17396
17397 =item EXPIRATION SUPPORT
17398
17399 =item BUGS
17400
17401 =item MAILING LIST
17402
17403 =item AUTHOR
17404
17405 =item COPYRIGHT AND LICENSE
17406
17407 =item THANK YOU
17408
17409 =back
17410
17411 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
17412 Storable use
17413
17414 =over 4
17415
17416 =item DESCRIPTION
17417
17418 =back
17419
17420 =head2 Memoize::Expire - Plug-in module for automatic expiration of
17421 memoized values
17422
17423 =over 4
17424
17425 =item SYNOPSIS
17426
17427 =item DESCRIPTION
17428
17429 =item INTERFACE
17430
17431  TIEHASH,  EXISTS,  STORE
17432
17433 =item ALTERNATIVES
17434
17435 =item CAVEATS
17436
17437 =item AUTHOR
17438
17439 =item SEE ALSO
17440
17441 =back
17442
17443 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
17444
17445 =over 4
17446
17447 =item DESCRIPTION
17448
17449 =back
17450
17451 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
17452
17453 =over 4
17454
17455 =item DESCRIPTION
17456
17457 =back
17458
17459 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
17460 Storable use
17461
17462 =over 4
17463
17464 =item DESCRIPTION
17465
17466 =back
17467
17468 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
17469 Storable use
17470
17471 =over 4
17472
17473 =item DESCRIPTION
17474
17475 =back
17476
17477 =head2 Memoize::Storable - store Memoized data in Storable database
17478
17479 =over 4
17480
17481 =item DESCRIPTION
17482
17483 =back
17484
17485 =head2 NDBM_File - Tied access to ndbm files
17486
17487 =over 4
17488
17489 =item SYNOPSIS
17490
17491 =item DESCRIPTION
17492
17493 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17494
17495 =item DIAGNOSTICS
17496
17497 =over 4
17498
17499 =item C<ndbm store returned -1, errno 22, key "..." at ...>
17500
17501 =back
17502
17503 =item BUGS AND WARNINGS
17504
17505 =back
17506
17507 =head2 NEXT - Provide a pseudo-class NEXT (et al) that allows method
17508 redispatch
17509
17510 =over 4
17511
17512 =item SYNOPSIS
17513
17514 =item DESCRIPTION
17515
17516 =over 4
17517
17518 =item Enforcing redispatch
17519
17520 =item Avoiding repetitions
17521
17522 =item Invoking all versions of a method with a single call
17523
17524 =item Using C<EVERY> methods
17525
17526 =back
17527
17528 =item AUTHOR
17529
17530 =item BUGS AND IRRITATIONS
17531
17532 =item COPYRIGHT
17533
17534 =back
17535
17536 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
17537
17538 =over 4
17539
17540 =item SYNOPSIS
17541
17542 =item DESCRIPTION
17543
17544 =item USER METHODS
17545
17546 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
17547 dataend ()
17548
17549 =item CLASS METHODS
17550
17551 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
17552 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
17553 ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh ()
17554
17555 =item EXPORTS
17556
17557 =item AUTHOR
17558
17559 =item COPYRIGHT
17560
17561 =back
17562
17563 =head2 Net::Config - Local configuration data for libnet
17564
17565 =over 4
17566
17567 =item SYNOPSYS
17568
17569 =item DESCRIPTION
17570
17571 =item METHODS
17572
17573 requires_firewall HOST
17574
17575 =item NetConfig VALUES
17576
17577 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
17578 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
17579 ftp_int_pasive, local_netmask, test_hosts, test_exists
17580
17581 =back
17582
17583 =head2 Net::Domain - Attempt to evaluate the current host's internet name
17584 and domain
17585
17586 =over 4
17587
17588 =item SYNOPSIS
17589
17590 =item DESCRIPTION
17591
17592 hostfqdn (), hostname (), hostdomain ()
17593
17594 =item AUTHOR
17595
17596 =item COPYRIGHT
17597
17598 =back
17599
17600 =head2 Net::FTP - FTP Client class
17601
17602 =over 4
17603
17604 =item SYNOPSIS
17605
17606 =item DESCRIPTION
17607
17608 =item OVERVIEW
17609
17610 =item CONSTRUCTOR
17611
17612 new ([ HOST ] [, OPTIONS ])
17613
17614 =item METHODS
17615
17616 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
17617 site (ARGS), ascii, binary, rename ( OLDNAME, NEWNAME ), delete ( FILENAME
17618 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR [,
17619 RECURSE ]), mkdir ( DIR [, RECURSE ]), alloc ( SIZE [, RECORD_SIZE] ), ls (
17620 [ DIR ] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ),
17621 put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE
17622 ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ),
17623 size ( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[
17624 BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ DIR ] ), retr ( FILE ),
17625 stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [ PORT ] ), pasv (),
17626 pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_xfer_unique (
17627 SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( NON_PASV_SERVER ),
17628 abort (), quit ()
17629
17630 =over 4
17631
17632 =item Methods for the adventurous
17633
17634 quot (CMD [,ARGS])
17635
17636 =back
17637
17638 =item THE dataconn CLASS
17639
17640 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
17641 bytes_read (), abort (), close ()
17642
17643 =item UNIMPLEMENTED
17644
17645 B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
17646
17647 =item REPORTING BUGS
17648
17649 =item AUTHOR
17650
17651 =item SEE ALSO
17652
17653 =item USE EXAMPLES
17654
17655 http://www.csh.rit.edu/~adam/Progs/
17656
17657 =item CREDITS
17658
17659 =item COPYRIGHT
17660
17661 =back
17662
17663 =head2 Net::NNTP - NNTP Client class
17664
17665 =over 4
17666
17667 =item SYNOPSIS
17668
17669 =item DESCRIPTION
17670
17671 =item CONSTRUCTOR
17672
17673 new ( [ HOST ] [, OPTIONS ])
17674
17675 =item METHODS
17676
17677 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
17678 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
17679 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
17680 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
17681 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
17682 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
17683 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
17684
17685 =over 4
17686
17687 =item Extension methods
17688
17689 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
17690 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
17691 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
17692 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
17693 GROUP ] ), reader
17694
17695 =back
17696
17697 =item UNSUPPORTED
17698
17699 =item DEFINITIONS
17700
17701 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
17702
17703 =item SEE ALSO
17704
17705 =item AUTHOR
17706
17707 =item COPYRIGHT
17708
17709 =back
17710
17711 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
17712
17713 =over 4
17714
17715 =item SYNOPSIS
17716
17717 =item DESCRIPTION
17718
17719 =item CONSTRUCTOR
17720
17721 new ( [ HOST ] [, OPTIONS ] 0
17722
17723 =item METHODS
17724
17725 auth ( USERNAME, PASSWORD ), user ( USER ), pass ( PASS ), login ( [ USER
17726 [, PASS ]] ), apop ( [ USER [, PASS ]] ), banner (), capa (),  capabilities
17727 (), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [, FH ]
17728 ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ]
17729 ), delete ( MSGNUM ), reset (), quit ()
17730
17731 =item NOTES
17732
17733 =item SEE ALSO
17734
17735 =item AUTHOR
17736
17737 =item COPYRIGHT
17738
17739 =back
17740
17741 =head2 Net::Ping - check a remote host for reachability
17742
17743 =over 4
17744
17745 =item SYNOPSIS
17746
17747 =item DESCRIPTION
17748
17749 =over 4
17750
17751 =item Functions
17752
17753 Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos
17754 ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
17755 $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
17756 $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
17757 [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host
17758 [, $timeout]);
17759
17760 =back
17761
17762 =item NOTES
17763
17764 =item INSTALL
17765
17766 =item BUGS
17767
17768 =item AUTHORS
17769
17770 =item COPYRIGHT
17771
17772 =back
17773
17774 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
17775
17776 =over 4
17777
17778 =item SYNOPSIS
17779
17780 =item DESCRIPTION
17781
17782 =item EXAMPLES
17783
17784 =item CONSTRUCTOR
17785
17786 new ( [ HOST ] [, OPTIONS ] )
17787
17788 =item METHODS
17789
17790 banner (), domain (), hello ( DOMAIN ), host (), etrn ( DOMAIN ), auth (
17791 USERNAME, PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ),
17792 send_or_mail ( ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient (
17793 ADDRESS [, ADDRESS, [...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]]
17794 ), cc ( ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ),
17795 data ( [ DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [
17796 $subject ] ), quit ()
17797
17798 =item ADDRESSES
17799
17800 =item SEE ALSO
17801
17802 =item AUTHOR
17803
17804 =item COPYRIGHT
17805
17806 =back
17807
17808 =head2 Net::Time - time and daytime network client interface
17809
17810 =over 4
17811
17812 =item SYNOPSIS
17813
17814 =item DESCRIPTION
17815
17816 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
17817 PROTOCOL [, TIMEOUT]]])
17818
17819 =item AUTHOR
17820
17821 =item COPYRIGHT
17822
17823 =back
17824
17825 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
17826 functions
17827
17828 =over 4
17829
17830 =item SYNOPSIS
17831
17832 =item DESCRIPTION
17833
17834 =item EXAMPLES
17835
17836 =item NOTE
17837
17838 =item AUTHOR
17839
17840 =back
17841
17842 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
17843
17844 =over 4
17845
17846 =item DESCRIPTION
17847
17848 =over 4
17849
17850 =item Where to get this document
17851
17852 =item How to contribute to this document
17853
17854 =back
17855
17856 =item Author and Copyright Information
17857
17858 =over 4
17859
17860 =item Disclaimer
17861
17862 =back
17863
17864 =item Obtaining and installing libnet
17865
17866 =over 4
17867
17868 =item What is libnet ?
17869
17870 =item Which version of perl do I need ?
17871
17872 =item What other modules do I need ?
17873
17874 =item What machines support libnet ?
17875
17876 =item Where can I get the latest libnet release
17877
17878 =back
17879
17880 =item Using Net::FTP
17881
17882 =over 4
17883
17884 =item How do I download files from an FTP server ?
17885
17886 =item How do I transfer files in binary mode ?
17887
17888 =item How can I get the size of a file on a remote FTP server ?
17889
17890 =item How can I get the modification time of a file on a remote FTP server
17891 ?
17892
17893 =item How can I change the permissions of a file on a remote server ?
17894
17895 =item Can I do a reget operation like the ftp command ?
17896
17897 =item How do I get a directory listing from an FTP server ?
17898
17899 =item Changing directory to "" does not fail ?
17900
17901 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
17902
17903 =item I am behind an FTP proxy firewall, but cannot access machines outside
17904 ?
17905
17906 =item My ftp proxy firewall does not listen on port 21
17907
17908 =item Is it possible to change the file permissions of a file on an FTP
17909 server ?
17910
17911 =item I have seen scripts call a method message, but cannot find it
17912 documented ?
17913
17914 =item Why does Net::FTP not implement mput and mget methods
17915
17916 =back
17917
17918 =item Using Net::SMTP
17919
17920 =over 4
17921
17922 =item Why can't the part of an Email address after the @ be used as the
17923 hostname ?
17924
17925 =item Why does Net::SMTP not do DNS MX lookups ?
17926
17927 =item The verify method always returns true ?
17928
17929 =back
17930
17931 =item Debugging scripts
17932
17933 =over 4
17934
17935 =item How can I debug my scripts that use Net::* modules ?
17936
17937 =back
17938
17939 =item AUTHOR AND COPYRIGHT
17940
17941 =back
17942
17943 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
17944 functions
17945
17946 =over 4
17947
17948 =item SYNOPSIS
17949
17950 =item DESCRIPTION
17951
17952 =item EXAMPLES
17953
17954 =item NOTE
17955
17956 =item AUTHOR
17957
17958 =back
17959
17960 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
17961 functions
17962
17963 =over 4
17964
17965 =item SYNOPSIS
17966
17967 =item DESCRIPTION
17968
17969 =item NOTE
17970
17971 =item AUTHOR
17972
17973 =back
17974
17975 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
17976 functions
17977
17978 =over 4
17979
17980 =item SYNOPSIS
17981
17982 =item DESCRIPTION
17983
17984 =item EXAMPLES
17985
17986 =item NOTE
17987
17988 =item AUTHOR
17989
17990 =back
17991
17992 =head2 Netrc, Net::Netrc - OO interface to users netrc file
17993
17994 =over 4
17995
17996 =item SYNOPSIS
17997
17998 =item DESCRIPTION
17999
18000 =item THE .netrc FILE
18001
18002 machine name, default, login name, password string, account string, macdef
18003 name
18004
18005 =item CONSTRUCTOR
18006
18007 lookup ( MACHINE [, LOGIN ])
18008
18009 =item METHODS
18010
18011 login (), password (), account (), lpa ()
18012
18013 =item AUTHOR
18014
18015 =item SEE ALSO
18016
18017 =item COPYRIGHT
18018
18019 =back
18020
18021 =head2 O - Generic interface to Perl Compiler backends
18022
18023 =over 4
18024
18025 =item SYNOPSIS
18026
18027 =item DESCRIPTION
18028
18029 =item CONVENTIONS
18030
18031 =item IMPLEMENTATION
18032
18033 =item BUGS
18034
18035 =item AUTHOR
18036
18037 =back
18038
18039 =head2 ODBM_File - Tied access to odbm files
18040
18041 =over 4
18042
18043 =item SYNOPSIS
18044
18045 =item DESCRIPTION
18046
18047 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
18048
18049 =item DIAGNOSTICS
18050
18051 =over 4
18052
18053 =item C<odbm store returned -1, errno 22, key "..." at ...>
18054
18055 =back
18056
18057 =item BUGS AND WARNINGS
18058
18059 =back
18060
18061 =head2 Opcode - Disable named opcodes when compiling perl code
18062
18063 =over 4
18064
18065 =item SYNOPSIS
18066
18067 =item DESCRIPTION
18068
18069 =item NOTE
18070
18071 =item WARNING
18072
18073 =item Operator Names and Operator Lists
18074
18075 an operator name (opname), an operator tag name (optag), a negated opname
18076 or optag, an operator set (opset)
18077
18078 =item Opcode Functions
18079
18080 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
18081 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
18082 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
18083 opdump (PAT)
18084
18085 =item Manipulating Opsets
18086
18087 =item TO DO (maybe)
18088
18089 =back
18090
18091 =over 4
18092
18093 =item Predefined Opcode Tags
18094
18095 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
18096 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
18097 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
18098 :dangerous
18099
18100 =item SEE ALSO
18101
18102 =item AUTHORS
18103
18104 =back
18105
18106 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
18107 compartments
18108
18109 =over 4
18110
18111 =item SYNOPSIS
18112
18113 =item DESCRIPTION
18114
18115 a new namespace, an operator mask
18116
18117 =item WARNING
18118
18119 =over 4
18120
18121 =item RECENT CHANGES
18122
18123 =item Methods in class Safe
18124
18125 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
18126 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
18127 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
18128 root (NAMESPACE), mask (MASK)
18129
18130 =item Some Safety Issues
18131
18132 Memory, CPU, Snooping, Signals, State Changes
18133
18134 =item AUTHOR
18135
18136 =back
18137
18138 =back
18139
18140 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
18141 compiling
18142
18143 =over 4
18144
18145 =item SYNOPSIS  
18146
18147 =item DESCRIPTION
18148
18149 =item SEE ALSO
18150
18151 =back
18152
18153 =head2 POSIX - Perl interface to IEEE Std 1003.1
18154
18155 =over 4
18156
18157 =item SYNOPSIS
18158
18159 =item DESCRIPTION
18160
18161 =item NOTE
18162
18163 =item CAVEATS 
18164
18165 =item FUNCTIONS
18166
18167 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
18168 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
18169 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
18170 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
18171 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
18172 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
18173 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
18174 fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv,
18175 geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid,
18176 getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha,
18177 isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace,
18178 isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime,
18179 log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr,
18180 memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice,
18181 offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc,
18182 putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename,
18183 rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid,
18184 setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
18185 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
18186 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
18187 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
18188 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
18189 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
18190 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
18191 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
18192 wctomb, write
18193
18194 =item CLASSES
18195
18196 =over 4
18197
18198 =item POSIX::SigAction
18199
18200 new, handler, mask, flags, safe
18201
18202 =item POSIX::SigSet
18203
18204 new, addset, delset, emptyset, fillset, ismember
18205
18206 =item POSIX::Termios
18207
18208 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
18209 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
18210 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
18211 field values, c_cflag field values, c_iflag field values, c_lflag field
18212 values, c_oflag field values
18213
18214 =back
18215
18216 =item PATHNAME CONSTANTS
18217
18218 Constants
18219
18220 =item POSIX CONSTANTS
18221
18222 Constants
18223
18224 =item SYSTEM CONFIGURATION
18225
18226 Constants
18227
18228 =item ERRNO
18229
18230 Constants
18231
18232 =item FCNTL
18233
18234 Constants
18235
18236 =item FLOAT
18237
18238 Constants
18239
18240 =item LIMITS
18241
18242 Constants
18243
18244 =item LOCALE
18245
18246 Constants
18247
18248 =item MATH
18249
18250 Constants
18251
18252 =item SIGNAL
18253
18254 Constants
18255
18256 =item STAT
18257
18258 Constants, Macros
18259
18260 =item STDLIB
18261
18262 Constants
18263
18264 =item STDIO
18265
18266 Constants
18267
18268 =item TIME
18269
18270 Constants
18271
18272 =item UNISTD
18273
18274 Constants
18275
18276 =item WAIT
18277
18278 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
18279 WTERMSIG, WIFSTOPPED, WSTOPSIG
18280
18281 =back
18282
18283 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
18284 name space
18285
18286 =over 4
18287
18288 =item SYNOPSIS
18289
18290 =item DESCRIPTION
18291
18292 :unix, :stdio, :perlio, :crlf, :mmap, :utf8, :bytes, :raw, :pop, :win32
18293
18294 =over 4
18295
18296 =item Custom Layers
18297
18298 :encoding, :via
18299
18300 =item Alternatives to raw
18301
18302 =item Defaults and how to override them
18303
18304 =item Querying the layers of filehandles
18305
18306 =back
18307
18308 =item AUTHOR
18309
18310 =item SEE ALSO
18311
18312 =back
18313
18314 =head2 PerlIO::encoding - encoding layer
18315
18316 =over 4
18317
18318 =item SYNOPSIS
18319
18320 =item DESCRIPTION
18321
18322 =item SEE ALSO
18323
18324 =back
18325
18326 =head2 PerlIO::scalar - in-memory IO, scalar IO
18327
18328 =over 4
18329
18330 =item SYNOPSIS
18331
18332 =item DESCRIPTION
18333
18334 =item IMPLEMENTATION NOTE
18335
18336 =back
18337
18338 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
18339
18340 =over 4
18341
18342 =item SYNOPSIS
18343
18344 =item DESCRIPTION
18345
18346 =item EXPECTED METHODS
18347
18348 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
18349 $obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]),
18350 $obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]),
18351 $obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh),
18352 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
18353 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
18354 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
18355 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
18356
18357 =item EXAMPLES
18358
18359 =over 4
18360
18361 =item Example - a Hexadecimal Handle
18362
18363 =back
18364
18365 =back
18366
18367 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
18368
18369 =over 4
18370
18371 =item SYNOPSIS
18372
18373 =item DESCRIPTION
18374
18375 =item REQUIRED MODULES
18376
18377 =item SEE ALSO
18378
18379 =item ACKNOWLEDGEMENTS
18380
18381 =item COPYRIGHT
18382
18383 =back
18384
18385 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
18386
18387 =over 4
18388
18389 =item SYNOPSIS
18390
18391 =item OPTIONS/ARGUMENTS
18392
18393 =over 4
18394
18395 =item podchecker()
18396
18397 B<-warnings> =E<gt> I<val>
18398
18399 =back
18400
18401 =item DESCRIPTION
18402
18403 =item DIAGNOSTICS
18404
18405 =over 4
18406
18407 =item Errors
18408
18409 empty =headn, =over on line I<N> without closing =back, =item without
18410 previous =over, =back without previous =over, No argument for =begin, =end
18411 without =begin, Nested =begin's, =for without formatter specification,
18412 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
18413 interior-sequence "I<SEQ>", nested commands
18414 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
18415 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
18416 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
18417 after =back
18418
18419 =item Warnings
18420
18421 multiple occurrence of link target I<name>, line containing nothing but
18422 whitespace in paragraph, file does not start with =head, previous =item has
18423 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
18424 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
18425 items in =over, No argument for =item, empty section in previous paragraph,
18426 Verbatim paragraph in NAME section, =headI<n> without preceding higher
18427 level
18428
18429 =item Hyperlinks
18430
18431 ignoring leading/trailing whitespace in link, (section) in '$page'
18432 deprecated, alternative text/node '%s' contains non-escaped | or /
18433
18434 =back
18435
18436 =item RETURN VALUE
18437
18438 =item EXAMPLES
18439
18440 =item INTERFACE
18441
18442 =back
18443
18444 C<Pod::Checker-E<gt>new( %options )>
18445
18446 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
18447 @args )>
18448
18449 C<$checker-E<gt>num_errors()>
18450
18451 C<$checker-E<gt>num_warnings()>
18452
18453 C<$checker-E<gt>name()>
18454
18455 C<$checker-E<gt>node()>
18456
18457 C<$checker-E<gt>idx()>
18458
18459 C<$checker-E<gt>hyperlink()>
18460
18461 =over 4
18462
18463 =item AUTHOR
18464
18465 =back
18466
18467 =head2 Pod::Find - find POD documents in directory trees
18468
18469 =over 4
18470
18471 =item SYNOPSIS
18472
18473 =item DESCRIPTION
18474
18475 =back
18476
18477 =over 4
18478
18479 =item C<pod_find( { %opts } , @directories )>
18480
18481 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
18482 1>
18483
18484 =back
18485
18486 =over 4
18487
18488 =item C<simplify_name( $str )>
18489
18490 =back
18491
18492 =over 4
18493
18494 =item C<pod_where( { %opts }, $pod )>
18495
18496 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
18497 1>
18498
18499 =back
18500
18501 =over 4
18502
18503 =item C<contains_pod( $file , $verbose )>
18504
18505 =back
18506
18507 =over 4
18508
18509 =item AUTHOR
18510
18511 =item SEE ALSO
18512
18513 =back
18514
18515 =head2 Pod::Html - module to convert pod files to HTML
18516
18517 =over 4
18518
18519 =item SYNOPSIS
18520
18521 =item DESCRIPTION
18522
18523 =item ARGUMENTS
18524
18525 backlink, cachedir, css, flush, header, help, hiddendirs, htmldir,
18526 htmlroot, index, infile, libpods, netscape, outfile, podpath, podroot,
18527 quiet, recurse, title, verbose
18528
18529 =item EXAMPLE
18530
18531 =item ENVIRONMENT
18532
18533 =item AUTHOR
18534
18535 =item SEE ALSO
18536
18537 =item COPYRIGHT
18538
18539 =back
18540
18541 =head2 Pod::InputObjects - objects representing POD input paragraphs,
18542 commands, etc.
18543
18544 =over 4
18545
18546 =item SYNOPSIS
18547
18548 =item REQUIRES
18549
18550 =item EXPORTS
18551
18552 =item DESCRIPTION
18553
18554 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
18555 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
18556
18557 =back
18558
18559 =over 4
18560
18561 =item B<Pod::InputSource>
18562
18563 =back
18564
18565 =over 4
18566
18567 =item B<new()>
18568
18569 =back
18570
18571 =over 4
18572
18573 =item B<name()>
18574
18575 =back
18576
18577 =over 4
18578
18579 =item B<handle()>
18580
18581 =back
18582
18583 =over 4
18584
18585 =item B<was_cutting()>
18586
18587 =back
18588
18589 =over 4
18590
18591 =item B<Pod::Paragraph>
18592
18593 =back
18594
18595 =over 4
18596
18597 =item Pod::Paragraph-E<gt>B<new()>
18598
18599 =back
18600
18601 =over 4
18602
18603 =item $pod_para-E<gt>B<cmd_name()>
18604
18605 =back
18606
18607 =over 4
18608
18609 =item $pod_para-E<gt>B<text()>
18610
18611 =back
18612
18613 =over 4
18614
18615 =item $pod_para-E<gt>B<raw_text()>
18616
18617 =back
18618
18619 =over 4
18620
18621 =item $pod_para-E<gt>B<cmd_prefix()>
18622
18623 =back
18624
18625 =over 4
18626
18627 =item $pod_para-E<gt>B<cmd_separator()>
18628
18629 =back
18630
18631 =over 4
18632
18633 =item $pod_para-E<gt>B<parse_tree()>
18634
18635 =back
18636
18637 =over 4
18638
18639 =item $pod_para-E<gt>B<file_line()>
18640
18641 =back
18642
18643 =over 4
18644
18645 =item B<Pod::InteriorSequence>
18646
18647 =back
18648
18649 =over 4
18650
18651 =item Pod::InteriorSequence-E<gt>B<new()>
18652
18653 =back
18654
18655 =over 4
18656
18657 =item $pod_seq-E<gt>B<cmd_name()>
18658
18659 =back
18660
18661 =over 4
18662
18663 =item $pod_seq-E<gt>B<prepend()>
18664
18665 =back
18666
18667 =over 4
18668
18669 =item $pod_seq-E<gt>B<append()>
18670
18671 =back
18672
18673 =over 4
18674
18675 =item $pod_seq-E<gt>B<nested()>
18676
18677 =back
18678
18679 =over 4
18680
18681 =item $pod_seq-E<gt>B<raw_text()>
18682
18683 =back
18684
18685 =over 4
18686
18687 =item $pod_seq-E<gt>B<left_delimiter()>
18688
18689 =back
18690
18691 =over 4
18692
18693 =item $pod_seq-E<gt>B<right_delimiter()>
18694
18695 =back
18696
18697 =over 4
18698
18699 =item $pod_seq-E<gt>B<parse_tree()>
18700
18701 =back
18702
18703 =over 4
18704
18705 =item $pod_seq-E<gt>B<file_line()>
18706
18707 =back
18708
18709 =over 4
18710
18711 =item Pod::InteriorSequence::B<DESTROY()>
18712
18713 =back
18714
18715 =over 4
18716
18717 =item B<Pod::ParseTree>
18718
18719 =back
18720
18721 =over 4
18722
18723 =item Pod::ParseTree-E<gt>B<new()>
18724
18725 =back
18726
18727 =over 4
18728
18729 =item $ptree-E<gt>B<top()>
18730
18731 =back
18732
18733 =over 4
18734
18735 =item $ptree-E<gt>B<children()>
18736
18737 =back
18738
18739 =over 4
18740
18741 =item $ptree-E<gt>B<prepend()>
18742
18743 =back
18744
18745 =over 4
18746
18747 =item $ptree-E<gt>B<append()>
18748
18749 =back
18750
18751 =over 4
18752
18753 =item $ptree-E<gt>B<raw_text()>
18754
18755 =back
18756
18757 =over 4
18758
18759 =item Pod::ParseTree::B<DESTROY()>
18760
18761 =back
18762
18763 =over 4
18764
18765 =item SEE ALSO
18766
18767 =item AUTHOR
18768
18769 =back
18770
18771 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
18772
18773 =over 4
18774
18775 =item SYNOPSIS
18776
18777 =item DESCRIPTION
18778
18779 =back
18780
18781 =over 4
18782
18783 =item OBJECT METHODS
18784
18785 C<initialize>
18786
18787 =back
18788
18789 =over 4
18790
18791 =item Data Accessors
18792
18793 B<AddPreamble>
18794
18795 =back
18796
18797 B<AddPostamble>
18798
18799 B<Head1Level>
18800
18801 B<Label>
18802
18803 B<LevelNoNum>
18804
18805 B<MakeIndex>
18806
18807 B<ReplaceNAMEwithSection>
18808
18809 B<StartWithNewPage>
18810
18811 B<TableOfContents>
18812
18813 B<UniqueLabels>
18814
18815 B<UserPreamble>
18816
18817 B<UserPostamble>
18818
18819 B<Lists>
18820
18821 =over 4
18822
18823 =item Subclassed methods
18824
18825 =back
18826
18827 B<begin_pod>
18828
18829 B<end_pod>
18830
18831 B<command>
18832
18833 B<verbatim>
18834
18835 B<textblock>
18836
18837 B<interior_sequence>
18838
18839 =over 4
18840
18841 =item List Methods
18842
18843 B<begin_list>
18844
18845 =back
18846
18847 B<end_list>
18848
18849 B<add_item>
18850
18851 =over 4
18852
18853 =item Methods for headings
18854
18855 B<head>
18856
18857 =back
18858
18859 =over 4
18860
18861 =item Internal methods
18862
18863 B<_output>
18864
18865 =back
18866
18867 B<_replace_special_chars>
18868
18869 B<_replace_special_chars_late>
18870
18871 B<_create_label>
18872
18873 B<_create_index>
18874
18875 B<_clean_latex_commands>
18876
18877 B<_split_delimited>
18878
18879 =over 4
18880
18881 =item NOTES
18882
18883 =item SEE ALSO
18884
18885 =item AUTHORS
18886
18887 =item COPYRIGHT
18888
18889 =item REVISION
18890
18891 =back
18892
18893 =head2 Pod::Man - Convert POD data to formatted *roff input
18894
18895 =over 4
18896
18897 =item SYNOPSIS
18898
18899 =item DESCRIPTION
18900
18901 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
18902 release, section
18903
18904 =item DIAGNOSTICS
18905
18906 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
18907 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
18908 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
18909 =back
18910
18911 =item BUGS
18912
18913 =item CAVEATS
18914
18915 =item SEE ALSO
18916
18917 =item AUTHOR
18918
18919 =item COPYRIGHT AND LICENSE
18920
18921 =back
18922
18923 =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
18924
18925 =over 4
18926
18927 =item SYNOPSIS
18928
18929 =item DESCRIPTION
18930
18931 =item SEE ALSO
18932
18933 =item AUTHOR
18934
18935 =item COPYRIGHT AND LICENSE
18936
18937 =back
18938
18939 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
18940
18941 =over 4
18942
18943 =item SYNOPSIS
18944
18945 =item DESCRIPTION
18946
18947 =back
18948
18949 =over 4
18950
18951 =item Pod::List
18952
18953 Pod::List-E<gt>new()
18954
18955 =back
18956
18957 $list-E<gt>file()
18958
18959 $list-E<gt>start()
18960
18961 $list-E<gt>indent()
18962
18963 $list-E<gt>type()
18964
18965 $list-E<gt>rx()
18966
18967 $list-E<gt>item()
18968
18969 $list-E<gt>parent()
18970
18971 $list-E<gt>tag()
18972
18973 =over 4
18974
18975 =item Pod::Hyperlink
18976
18977 Pod::Hyperlink-E<gt>new()
18978
18979 =back
18980
18981 $link-E<gt>parse($string)
18982
18983 $link-E<gt>markup($string)
18984
18985 $link-E<gt>text()
18986
18987 $link-E<gt>warning()
18988
18989 $link-E<gt>file(), $link-E<gt>line()
18990
18991 $link-E<gt>page()
18992
18993 $link-E<gt>node()
18994
18995 $link-E<gt>alttext()
18996
18997 $link-E<gt>type()
18998
18999 $link-E<gt>link()
19000
19001 =over 4
19002
19003 =item Pod::Cache
19004
19005 Pod::Cache-E<gt>new()
19006
19007 =back
19008
19009 $cache-E<gt>item()
19010
19011 $cache-E<gt>find_page($name)
19012
19013 =over 4
19014
19015 =item Pod::Cache::Item
19016
19017 Pod::Cache::Item-E<gt>new()
19018
19019 =back
19020
19021 $cacheitem-E<gt>page()
19022
19023 $cacheitem-E<gt>description()
19024
19025 $cacheitem-E<gt>path()
19026
19027 $cacheitem-E<gt>file()
19028
19029 $cacheitem-E<gt>nodes()
19030
19031 $cacheitem-E<gt>find_node($name)
19032
19033 $cacheitem-E<gt>idx()
19034
19035 =over 4
19036
19037 =item AUTHOR
19038
19039 =item SEE ALSO
19040
19041 =back
19042
19043 =head2 Pod::Parser - base class for creating POD filters and translators
19044
19045 =over 4
19046
19047 =item SYNOPSIS
19048
19049 =item REQUIRES
19050
19051 =item EXPORTS
19052
19053 =item DESCRIPTION
19054
19055 =item QUICK OVERVIEW
19056
19057 =item PARSING OPTIONS
19058
19059 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
19060 B<-warnings> (default: unset)
19061
19062 =back
19063
19064 =over 4
19065
19066 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
19067
19068 =back
19069
19070 =over 4
19071
19072 =item B<command()>
19073
19074 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
19075
19076 =back
19077
19078 =over 4
19079
19080 =item B<verbatim()>
19081
19082 C<$text>, C<$line_num>, C<$pod_para>
19083
19084 =back
19085
19086 =over 4
19087
19088 =item B<textblock()>
19089
19090 C<$text>, C<$line_num>, C<$pod_para>
19091
19092 =back
19093
19094 =over 4
19095
19096 =item B<interior_sequence()>
19097
19098 =back
19099
19100 =over 4
19101
19102 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
19103
19104 =back
19105
19106 =over 4
19107
19108 =item B<new()>
19109
19110 =back
19111
19112 =over 4
19113
19114 =item B<initialize()>
19115
19116 =back
19117
19118 =over 4
19119
19120 =item B<begin_pod()>
19121
19122 =back
19123
19124 =over 4
19125
19126 =item B<begin_input()>
19127
19128 =back
19129
19130 =over 4
19131
19132 =item B<end_input()>
19133
19134 =back
19135
19136 =over 4
19137
19138 =item B<end_pod()>
19139
19140 =back
19141
19142 =over 4
19143
19144 =item B<preprocess_line()>
19145
19146 =back
19147
19148 =over 4
19149
19150 =item B<preprocess_paragraph()>
19151
19152 =back
19153
19154 =over 4
19155
19156 =item METHODS FOR PARSING AND PROCESSING
19157
19158 =back
19159
19160 =over 4
19161
19162 =item B<parse_text()>
19163
19164 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
19165 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
19166 I<code-ref>|I<method-name>
19167
19168 =back
19169
19170 =over 4
19171
19172 =item B<interpolate()>
19173
19174 =back
19175
19176 =over 4
19177
19178 =item B<parse_paragraph()>
19179
19180 =back
19181
19182 =over 4
19183
19184 =item B<parse_from_filehandle()>
19185
19186 =back
19187
19188 =over 4
19189
19190 =item B<parse_from_file()>
19191
19192 =back
19193
19194 =over 4
19195
19196 =item ACCESSOR METHODS
19197
19198 =back
19199
19200 =over 4
19201
19202 =item B<errorsub()>
19203
19204 =back
19205
19206 =over 4
19207
19208 =item B<cutting()>
19209
19210 =back
19211
19212 =over 4
19213
19214 =item B<parseopts()>
19215
19216 =back
19217
19218 =over 4
19219
19220 =item B<output_file()>
19221
19222 =back
19223
19224 =over 4
19225
19226 =item B<output_handle()>
19227
19228 =back
19229
19230 =over 4
19231
19232 =item B<input_file()>
19233
19234 =back
19235
19236 =over 4
19237
19238 =item B<input_handle()>
19239
19240 =back
19241
19242 =over 4
19243
19244 =item B<input_streams()>
19245
19246 =back
19247
19248 =over 4
19249
19250 =item B<top_stream()>
19251
19252 =back
19253
19254 =over 4
19255
19256 =item PRIVATE METHODS AND DATA
19257
19258 =back
19259
19260 =over 4
19261
19262 =item B<_push_input_stream()>
19263
19264 =back
19265
19266 =over 4
19267
19268 =item B<_pop_input_stream()>
19269
19270 =back
19271
19272 =over 4
19273
19274 =item TREE-BASED PARSING
19275
19276 =item SEE ALSO
19277
19278 =item AUTHOR
19279
19280 =back
19281
19282 =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors
19283
19284 =over 4
19285
19286 =item SYNOPSIS
19287
19288 =item DESCRIPTION
19289
19290 =item SEE ALSO
19291
19292 =item COPYRIGHT AND DISCLAIMERS
19293
19294 =item AUTHOR
19295
19296 =back
19297
19298 =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages
19299
19300 =over 4
19301
19302 =item SYNOPSIS
19303
19304 =item DESCRIPTION
19305
19306 =item CAVEAT
19307
19308 =item SEE ALSO
19309
19310 =item COPYRIGHT AND DISCLAIMERS
19311
19312 =item AUTHOR
19313
19314 =back
19315
19316 =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff
19317
19318 =over 4
19319
19320 =item SYNOPSIS
19321
19322 =item DESCRIPTION
19323
19324 =item CAVEAT
19325
19326 =item SEE ALSO
19327
19328 =item COPYRIGHT AND DISCLAIMERS
19329
19330 =item AUTHOR
19331
19332 =back
19333
19334 =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod!
19335
19336 =over 4
19337
19338 =item SYNOPSIS
19339
19340 =item DESCRIPTION
19341
19342 =item SEE ALSO
19343
19344 =item COPYRIGHT AND DISCLAIMERS
19345
19346 =item AUTHOR
19347
19348 =back
19349
19350 =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF
19351
19352 =over 4
19353
19354 =item SYNOPSIS
19355
19356 =item DESCRIPTION
19357
19358 =item SEE ALSO
19359
19360 =item COPYRIGHT AND DISCLAIMERS
19361
19362 =item AUTHOR
19363
19364 =back
19365
19366 =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext
19367
19368 =over 4
19369
19370 =item SYNOPSIS
19371
19372 =item DESCRIPTION
19373
19374 =item CAVEAT
19375
19376 =item SEE ALSO
19377
19378 =item COPYRIGHT AND DISCLAIMERS
19379
19380 =item AUTHOR
19381
19382 =back
19383
19384 =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod
19385
19386 =over 4
19387
19388 =item SYNOPSIS
19389
19390 =item DESCRIPTION
19391
19392 =item SEE ALSO
19393
19394 =item AUTHOR
19395
19396 =back
19397
19398 =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML
19399
19400 =over 4
19401
19402 =item SYNOPSIS
19403
19404 =item DESCRIPTION
19405
19406 =item SEE ALSO
19407
19408 =item COPYRIGHT AND DISCLAIMERS
19409
19410 =item AUTHOR
19411
19412 =back
19413
19414 =head2 Pod::PlainText - Convert POD data to formatted ASCII text
19415
19416 =over 4
19417
19418 =item SYNOPSIS
19419
19420 =item DESCRIPTION
19421
19422 alt, indent, loose, sentence, width
19423
19424 =item DIAGNOSTICS
19425
19426 Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
19427 Unknown sequence: %s, Unmatched =back
19428
19429 =item RESTRICTIONS
19430
19431 =item NOTES
19432
19433 =item SEE ALSO
19434
19435 =item AUTHOR
19436
19437 =back
19438
19439 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
19440
19441 =over 4
19442
19443 =item SYNOPSIS
19444
19445 =item DESCRIPTION
19446
19447 =over 4
19448
19449 =item EXPORT
19450
19451 =back
19452
19453 =item AUTHOR
19454
19455 =item SEE ALSO
19456
19457 =back
19458
19459 =head2 Pod::Select, podselect() - extract selected sections of POD from
19460 input
19461
19462 =over 4
19463
19464 =item SYNOPSIS
19465
19466 =item REQUIRES
19467
19468 =item EXPORTS
19469
19470 =item DESCRIPTION
19471
19472 =item SECTION SPECIFICATIONS
19473
19474 =item RANGE SPECIFICATIONS
19475
19476 =back
19477
19478 =over 4
19479
19480 =item OBJECT METHODS
19481
19482 =back
19483
19484 =over 4
19485
19486 =item B<curr_headings()>
19487
19488 =back
19489
19490 =over 4
19491
19492 =item B<select()>
19493
19494 =back
19495
19496 =over 4
19497
19498 =item B<add_selection()>
19499
19500 =back
19501
19502 =over 4
19503
19504 =item B<clear_selections()>
19505
19506 =back
19507
19508 =over 4
19509
19510 =item B<match_section()>
19511
19512 =back
19513
19514 =over 4
19515
19516 =item B<is_selected()>
19517
19518 =back
19519
19520 =over 4
19521
19522 =item EXPORTED FUNCTIONS
19523
19524 =back
19525
19526 =over 4
19527
19528 =item B<podselect()>
19529
19530 B<-output>, B<-sections>, B<-ranges>
19531
19532 =back
19533
19534 =over 4
19535
19536 =item PRIVATE METHODS AND DATA
19537
19538 =back
19539
19540 =over 4
19541
19542 =item B<_compile_section_spec()>
19543
19544 =back
19545
19546 =over 4
19547
19548 =item $self->{_SECTION_HEADINGS}
19549
19550 =back
19551
19552 =over 4
19553
19554 =item $self->{_SELECTED_SECTIONS}
19555
19556 =back
19557
19558 =over 4
19559
19560 =item SEE ALSO
19561
19562 =item AUTHOR
19563
19564 =back
19565
19566 =head2 Pod::Text - Convert POD data to formatted ASCII text
19567
19568 =over 4
19569
19570 =item SYNOPSIS
19571
19572 =item DESCRIPTION
19573
19574 alt, code, indent, loose, margin, quotes, sentence, width
19575
19576 =item DIAGNOSTICS
19577
19578 Bizarre space in item, Item called without tag, Can't open %s for reading:
19579 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
19580 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
19581 Unmatched =back
19582
19583 =item RESTRICTIONS
19584
19585 =item NOTES
19586
19587 =item SEE ALSO
19588
19589 =item AUTHOR
19590
19591 =item COPYRIGHT AND LICENSE
19592
19593 =back
19594
19595 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
19596
19597 =over 4
19598
19599 =item SYNOPSIS
19600
19601 =item DESCRIPTION
19602
19603 =item BUGS
19604
19605 =item SEE ALSO
19606
19607 =item AUTHOR
19608
19609 =item COPYRIGHT AND LICENSE
19610
19611 =back
19612
19613 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
19614 text
19615
19616 =over 4
19617
19618 =item SYNOPSIS
19619
19620 =item DESCRIPTION
19621
19622 =item BUGS
19623
19624 =item SEE ALSO
19625
19626 =item AUTHOR
19627
19628 =item COPYRIGHT AND LICENSE
19629
19630 =back
19631
19632 =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
19633 escapes
19634
19635 =over 4
19636
19637 =item SYNOPSIS
19638
19639 =item DESCRIPTION
19640
19641 =item NOTES
19642
19643 =item SEE ALSO
19644
19645 =item AUTHOR
19646
19647 =item COPYRIGHT AND LICENSE
19648
19649 =back
19650
19651 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
19652 documentation
19653
19654 =over 4
19655
19656 =item SYNOPSIS
19657
19658 =item ARGUMENTS
19659
19660 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
19661 C<-pathlist>
19662
19663 =item DESCRIPTION
19664
19665 =item EXAMPLES
19666
19667 =over 4
19668
19669 =item Recommended Use
19670
19671 =back
19672
19673 =item CAVEATS
19674
19675 =item AUTHOR
19676
19677 =item ACKNOWLEDGEMENTS
19678
19679 =back
19680
19681 =head2 SDBM_File - Tied access to sdbm files
19682
19683 =over 4
19684
19685 =item SYNOPSIS
19686
19687 =item DESCRIPTION
19688
19689 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
19690
19691 =item DIAGNOSTICS
19692
19693 =over 4
19694
19695 =item C<sdbm store returned -1, errno 22, key "..." at ...>
19696
19697 =back
19698
19699 =item BUGS AND WARNINGS
19700
19701 =back
19702
19703 =head2 Safe - Compile and execute code in restricted compartments
19704
19705 =over 4
19706
19707 =item SYNOPSIS
19708
19709 =item DESCRIPTION
19710
19711 a new namespace, an operator mask
19712
19713 =item WARNING
19714
19715 =over 4
19716
19717 =item RECENT CHANGES
19718
19719 =item Methods in class Safe
19720
19721 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
19722 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
19723 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
19724 root (NAMESPACE), mask (MASK)
19725
19726 =item Some Safety Issues
19727
19728 Memory, CPU, Snooping, Signals, State Changes
19729
19730 =item AUTHOR
19731
19732 =back
19733
19734 =back
19735
19736 =head2 Scalar::Util - A selection of general-utility scalar subroutines
19737
19738 =over 4
19739
19740 =item SYNOPSIS
19741
19742 =item DESCRIPTION
19743
19744 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
19745 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
19746 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
19747
19748 =item KNOWN BUGS
19749
19750 =item COPYRIGHT
19751
19752 =item BLATANT PLUG
19753
19754 =back
19755
19756 =head2 Search::Dict, look - search for key in dictionary file
19757
19758 =over 4
19759
19760 =item SYNOPSIS
19761
19762 =item DESCRIPTION
19763
19764 =back
19765
19766 =head2 SelectSaver - save and restore selected file handle
19767
19768 =over 4
19769
19770 =item SYNOPSIS
19771
19772 =item DESCRIPTION
19773
19774 =back
19775
19776 =head2 SelfLoader - load functions only on demand
19777
19778 =over 4
19779
19780 =item SYNOPSIS
19781
19782 =item DESCRIPTION
19783
19784 =over 4
19785
19786 =item The __DATA__ token
19787
19788 =item SelfLoader autoloading
19789
19790 =item Autoloading and package lexicals
19791
19792 =item SelfLoader and AutoLoader
19793
19794 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
19795
19796 =item Classes and inherited methods.
19797
19798 =back
19799
19800 =item Multiple packages and fully qualified subroutine names
19801
19802 =back
19803
19804 =head2 Shell - run shell commands transparently within perl
19805
19806 =over 4
19807
19808 =item SYNOPSIS
19809
19810 =item DESCRIPTION
19811
19812 =over 4
19813
19814 =item OBJECT ORIENTED SYNTAX
19815
19816 =back
19817
19818 =item AUTHOR
19819
19820 =back
19821
19822 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
19823 socket.h defines and structure manipulators 
19824
19825 =over 4
19826
19827 =item SYNOPSIS
19828
19829 =item DESCRIPTION
19830
19831 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
19832 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
19833 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
19834 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
19835 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
19836
19837 =back
19838
19839 =head2 Storable - persistence for Perl data structures
19840
19841 =over 4
19842
19843 =item SYNOPSIS
19844
19845 =item DESCRIPTION
19846
19847 =item MEMORY STORE
19848
19849 =item ADVISORY LOCKING
19850
19851 =item SPEED
19852
19853 =item CANONICAL REPRESENTATION
19854
19855 =item CODE REFERENCES
19856
19857 =item FORWARD COMPATIBILITY
19858
19859 utf8 data, restricted hashes, files from future versions of Storable
19860
19861 =item ERROR REPORTING
19862
19863 =item WIZARDS ONLY
19864
19865 =over 4
19866
19867 =item Hooks
19868
19869 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
19870 I<serialized>, ..
19871
19872 =item Predicates
19873
19874 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
19875 C<Storable::is_retrieving>
19876
19877 =item Recursion
19878
19879 =item Deep Cloning
19880
19881 =back
19882
19883 =item Storable magic
19884
19885 =item EXAMPLES
19886
19887 =item WARNING
19888
19889 =item BUGS
19890
19891 =over 4
19892
19893 =item 64 bit data in perl 5.6.0 and 5.6.1
19894
19895 =back
19896
19897 =item CREDITS
19898
19899 =item AUTHOR
19900
19901 =item SEE ALSO
19902
19903 =back
19904
19905 =head2 Switch - A switch statement for Perl
19906
19907 =over 4
19908
19909 =item VERSION
19910
19911 =item SYNOPSIS
19912
19913 =item BACKGROUND
19914
19915 =item DESCRIPTION
19916
19917 =over 4
19918
19919 =item Allowing fall-through
19920
19921 =item Automating fall-through
19922
19923 =item Alternative syntax
19924
19925 =item Higher-order Operations
19926
19927 =back
19928
19929 =item DEPENDENCIES
19930
19931 =item AUTHOR
19932
19933 =item BUGS
19934
19935 =item LIMITATIONS
19936
19937 =item COPYRIGHT
19938
19939 =back
19940
19941 =head2 Symbol - manipulate Perl symbols and their names
19942
19943 =over 4
19944
19945 =item SYNOPSIS
19946
19947 =item DESCRIPTION
19948
19949 =item BUGS
19950
19951 =back
19952
19953 =head2 Sys::Hostname - Try every conceivable way to get hostname
19954
19955 =over 4
19956
19957 =item SYNOPSIS
19958
19959 =item DESCRIPTION
19960
19961 =item AUTHOR
19962
19963 =back
19964
19965 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
19966 interface to the UNIX syslog(3) calls
19967
19968 =over 4
19969
19970 =item SYNOPSIS
19971
19972 =item DESCRIPTION
19973
19974 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19975 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19976 in 5.004_02), closelog
19977
19978 =item EXAMPLES
19979
19980 =item SEE ALSO
19981
19982 =item AUTHOR
19983
19984 =back
19985
19986 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
19987 Perl interface to the UNIX syslog(3) calls
19988
19989 =over 4
19990
19991 =item SYNOPSIS
19992
19993 =item DESCRIPTION
19994
19995 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19996 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19997 in 5.004_02), closelog
19998
19999 =item EXAMPLES
20000
20001 =item SEE ALSO
20002
20003 =item AUTHOR
20004
20005 =back
20006
20007 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
20008
20009 =over 4
20010
20011 =item SYNOPSIS
20012
20013 =item DESCRIPTION
20014
20015 =item DIAGNOSTICS
20016
20017 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
20018 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
20019 comma allowed after filehandle, No name for escape sequence %s
20020
20021 =item ENVIRONMENT
20022
20023 ANSI_COLORS_DISABLED
20024
20025 =item RESTRICTIONS
20026
20027 =item NOTES
20028
20029 =item SEE ALSO
20030
20031 =item AUTHORS
20032
20033 =item COPYRIGHT AND LICENSE
20034
20035 =back
20036
20037 =head2 Term::Cap - Perl termcap interface
20038
20039 =over 4
20040
20041 =item SYNOPSIS
20042
20043 =item DESCRIPTION
20044
20045 =over 4
20046
20047 =item METHODS
20048
20049 =back
20050
20051 =back
20052
20053 B<Tgetent>, OSPEED, TERM
20054
20055 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
20056
20057 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
20058
20059 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
20060
20061 B<Trequire>
20062
20063 =over 4
20064
20065 =item EXAMPLES
20066
20067 =item COPYRIGHT AND LICENSE
20068
20069 =item AUTHOR
20070
20071 =item SEE ALSO
20072
20073 =back
20074
20075 =head2 Term::Complete - Perl word completion module
20076
20077 =over 4
20078
20079 =item SYNOPSIS
20080
20081 =item DESCRIPTION
20082
20083 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
20084
20085 =item DIAGNOSTICS
20086
20087 =item BUGS
20088
20089 =item AUTHOR
20090
20091 =back
20092
20093 =head2 Term::ReadLine - Perl interface to various C<readline> packages.
20094 If no real package is found, substitutes stubs instead of basic functions.
20095
20096 =over 4
20097
20098 =item SYNOPSIS
20099
20100 =item DESCRIPTION
20101
20102 =item Minimal set of supported functions
20103
20104 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>,
20105 C<findConsole>, Attribs, C<Features>
20106
20107 =item Additional supported functions
20108
20109 C<tkRunning>, C<ornaments>, C<newTTY>
20110
20111 =item EXPORTS
20112
20113 =item ENVIRONMENT
20114
20115 =item CAVEATS
20116
20117 =back
20118
20119 =head2 Test - provides a simple framework for writing test scripts
20120
20121 =over 4
20122
20123 =item SYNOPSIS
20124
20125 =item DESCRIPTION
20126
20127 =item QUICK START GUIDE
20128
20129 =over 4
20130
20131 =item Functions
20132
20133 C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>,
20134 C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub>
20135
20136 =back
20137
20138 =back
20139
20140 B<_to_value>
20141
20142 C<ok(...)>
20143
20144 C<skip(I<skip_if_true>, I<args...>)>
20145
20146 =over 4
20147
20148 =item TEST TYPES
20149
20150 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
20151
20152 =item ONFAIL
20153
20154 =item BUGS and CAVEATS
20155
20156 =item NOTE
20157
20158 =item SEE ALSO
20159
20160 =item AUTHOR
20161
20162 =back
20163
20164 =head2 Test::Builder - Backend for building test libraries
20165
20166 =over 4
20167
20168 =item SYNOPSIS
20169
20170 =item DESCRIPTION
20171
20172 =over 4
20173
20174 =item Construction
20175
20176 B<new>
20177
20178 =back
20179
20180 =back
20181
20182 =over 4
20183
20184 =item Setting up tests
20185
20186 B<exported_to>
20187
20188 =back
20189
20190 B<plan>
20191
20192 B<expected_tests>
20193
20194 B<no_plan>
20195
20196 B<has_plan>
20197
20198 B<skip_all>
20199
20200 =over 4
20201
20202 =item Running tests
20203
20204 B<ok>
20205
20206 =back
20207
20208 B<is_eq>, B<is_num>
20209
20210 B<isnt_eq>, B<isnt_num>
20211
20212 B<like>, B<unlike>
20213
20214 B<maybe_regex>
20215
20216 B<cmp_ok>
20217
20218 B<BAILOUT>
20219
20220 B<skip>
20221
20222 B<todo_skip>
20223
20224 B<skip_rest>
20225
20226 =over 4
20227
20228 =item Test style
20229
20230 B<level>
20231
20232 =back
20233
20234 B<use_numbers>
20235
20236 B<no_header>, B<no_ending>
20237
20238 =over 4
20239
20240 =item Output
20241
20242 B<diag>
20243
20244 =back
20245
20246 B<_print>
20247
20248 B<output>, B<failure_output>, B<todo_output>
20249
20250 =over 4
20251
20252 =item Test Status and Info
20253
20254 B<current_test>
20255
20256 =back
20257
20258 B<summary>
20259
20260 B<details>
20261
20262 B<todo>
20263
20264 B<caller>
20265
20266 B<_sanity_check>
20267
20268 B<_whoa>
20269
20270 B<_my_exit>
20271
20272 =over 4
20273
20274 =item THREADS
20275
20276 =item EXAMPLES
20277
20278 =item SEE ALSO
20279
20280 =item AUTHORS
20281
20282 =item COPYRIGHT
20283
20284 =back
20285
20286 =head2 Test::Harness - Run Perl standard test scripts with statistics
20287
20288 =over 4
20289
20290 =item VERSION
20291
20292 =back
20293
20294 =over 4
20295
20296 =item SYNOPSIS
20297
20298 =item DESCRIPTION
20299
20300 =over 4
20301
20302 =item The test script output
20303
20304 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
20305 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
20306 else>
20307
20308 =item Taint mode
20309
20310 =item Configuration variables.
20311
20312 B<$Test::Harness::Verbose>, B<$Test::Harness::switches>
20313
20314 =item Failure
20315
20316 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
20317 Failed>
20318
20319 =item Functions
20320
20321 B<runtests>
20322
20323 =back
20324
20325 =back
20326
20327 B<_all_ok>
20328
20329 B<_globdir>
20330
20331 B<_run_all_tests>
20332
20333 B<_mk_leader>
20334
20335 B<_leader_width>
20336
20337 =over 4
20338
20339 =item EXPORT
20340
20341 =item DIAGNOSTICS
20342
20343 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
20344 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
20345 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
20346 %s>, C<FAILED--Further testing stopped: %s>
20347
20348 =item ENVIRONMENT
20349
20350 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
20351 C<HARNESS_DEBUG>, C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>,
20352 C<HARNESS_NOTTY>, C<HARNESS_OK_SLOW>, C<HARNESS_PERL>,
20353 C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
20354
20355 =item EXAMPLE
20356
20357 =item SEE ALSO
20358
20359 =item AUTHORS
20360
20361 =item LICENSE
20362
20363 =item TODO
20364
20365 =item BUGS
20366
20367 =item AUTHORS
20368
20369 =item COPYRIGHT
20370
20371 =back
20372
20373 =head2 Test::Harness::Assert - simple assert
20374
20375 =over 4
20376
20377 =item SYNOPSIS
20378
20379 =item DESCRIPTION
20380
20381 =item FUNCTIONS
20382
20383 =over 4
20384
20385 =item C<assert()>
20386
20387 =back
20388
20389 =back
20390
20391 =over 4
20392
20393 =item AUTHOR
20394
20395 =item SEE ALSO
20396
20397 =back
20398
20399 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
20400
20401 =over 4
20402
20403 =item SYNOPSIS
20404
20405 =item DESCRIPTION
20406
20407 =over 4
20408
20409 =item new()
20410
20411 =item next()
20412
20413 =back
20414
20415 =back
20416
20417 =head2 Test::Harness::Straps - detailed analysis of test results
20418
20419 =over 4
20420
20421 =item SYNOPSIS
20422
20423 =item DESCRIPTION
20424
20425 =item Construction
20426
20427 =over 4
20428
20429 =item C<new>
20430
20431 =back
20432
20433 =back
20434
20435 =over 4
20436
20437 =item C<_init>
20438
20439 =back
20440
20441 =over 4
20442
20443 =item Analysis
20444
20445 =over 4
20446
20447 =item C<analyze>
20448
20449 =back
20450
20451 =back
20452
20453 =over 4
20454
20455 =item C<analyze_fh>
20456
20457 =back
20458
20459 =over 4
20460
20461 =item C<analyze_file>
20462
20463 =back
20464
20465 =over 4
20466
20467 =item C<_command_line( $file )>
20468
20469 =back
20470
20471 =over 4
20472
20473 =item C<_command>
20474
20475 =back
20476
20477 =over 4
20478
20479 =item C<_switches>
20480
20481 =back
20482
20483 =over 4
20484
20485 =item C<_cleaned_switches>
20486
20487 =back
20488
20489 =over 4
20490
20491 =item C<_INC2PERL5LIB>
20492
20493 =back
20494
20495 =over 4
20496
20497 =item C<_filtered_INC>
20498
20499 =back
20500
20501 =over 4
20502
20503 =item C<_restore_PERL5LIB>
20504
20505 =back
20506
20507 =over 4
20508
20509 =item Parsing
20510
20511 =over 4
20512
20513 =item C<_is_comment>
20514
20515 =back
20516
20517 =back
20518
20519 =over 4
20520
20521 =item C<_is_header>
20522
20523 =back
20524
20525 =over 4
20526
20527 =item C<_is_test>
20528
20529 =back
20530
20531 =over 4
20532
20533 =item C<_is_bail_out>
20534
20535 =back
20536
20537 =over 4
20538
20539 =item C<_reset_file_state>
20540
20541 =back
20542
20543 =over 4
20544
20545 =item Results
20546
20547 =over 4
20548
20549 =item C<_detailize>
20550
20551 =back
20552
20553 =back
20554
20555 =over 4
20556
20557 =item EXAMPLES
20558
20559 =item AUTHOR
20560
20561 =item SEE ALSO
20562
20563 =back
20564
20565 =head2 Test::More - yet another framework for writing test scripts
20566
20567 =over 4
20568
20569 =item SYNOPSIS
20570
20571 =item DESCRIPTION
20572
20573 =over 4
20574
20575 =item I love it when a plan comes together
20576
20577 =back
20578
20579 =back
20580
20581 =over 4
20582
20583 =item Test names
20584
20585 =item I'm ok, you're not ok.
20586
20587 B<ok>
20588
20589 =back
20590
20591 B<is>, B<isnt>
20592
20593 B<like>
20594
20595 B<unlike>
20596
20597 B<cmp_ok>
20598
20599 B<can_ok>
20600
20601 B<isa_ok>
20602
20603 B<pass>, B<fail>
20604
20605 =over 4
20606
20607 =item Diagnostics
20608
20609 B<diag>
20610
20611 =back
20612
20613 =over 4
20614
20615 =item Module tests
20616
20617 B<use_ok>
20618
20619 =back
20620
20621 B<require_ok>
20622
20623 =over 4
20624
20625 =item Conditional tests
20626
20627 B<SKIP: BLOCK>
20628
20629 =back
20630
20631 B<TODO: BLOCK>, B<todo_skip>
20632
20633 When do I use SKIP vs. TODO?
20634
20635 =over 4
20636
20637 =item Comparison functions
20638
20639 B<is_deeply>
20640
20641 =back
20642
20643 B<eq_array>
20644
20645 B<eq_hash>
20646
20647 B<eq_set>
20648
20649 =over 4
20650
20651 =item Extending and Embedding Test::More
20652
20653 B<builder>
20654
20655 =back
20656
20657 =over 4
20658
20659 =item NOTES
20660
20661 =item BUGS and CAVEATS
20662
20663 Making your own ok(), The eq_* family has some caveats, Test::Harness
20664 upgrades
20665
20666 =item HISTORY
20667
20668 =item SEE ALSO
20669
20670 =item AUTHORS
20671
20672 =item COPYRIGHT
20673
20674 =back
20675
20676 =head2 Test::Simple - Basic utilities for writing tests.
20677
20678 =over 4
20679
20680 =item SYNOPSIS
20681
20682 =item DESCRIPTION
20683
20684 B<ok>
20685
20686 =back
20687
20688 =over 4
20689
20690 =item EXAMPLE
20691
20692 =item CAVEATS
20693
20694 =item NOTES
20695
20696 =item HISTORY
20697
20698 =item SEE ALSO
20699
20700 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
20701 L<Test::Harness>
20702
20703 =item AUTHORS
20704
20705 =item COPYRIGHT
20706
20707 =back
20708
20709 =head2 Test::Tutorial - A tutorial about writing really basic tests
20710
20711 =over 4
20712
20713 =item DESCRIPTION
20714
20715 =over 4
20716
20717 =item Nuts and bolts of testing.
20718
20719 =item Where to start?
20720
20721 =item Names
20722
20723 =item Test the manual
20724
20725 =item Sometimes the tests are wrong
20726
20727 =item Testing lots of values
20728
20729 =item Informative names
20730
20731 =item Skipping tests
20732
20733 =item Todo tests
20734
20735 =item Testing with taint mode.
20736
20737 =back
20738
20739 =item FOOTNOTES
20740
20741 =item AUTHORS
20742
20743 =item COPYRIGHT
20744
20745 =back
20746
20747 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
20748
20749 =over 4
20750
20751 =item SYNOPSIS
20752
20753 =item DESCRIPTION
20754
20755 =item EXAMPLE
20756
20757 =back
20758
20759 =head2 Text::Balanced - Extract delimited text sequences from strings.
20760
20761 =over 4
20762
20763 =item SYNOPSIS
20764
20765 =item DESCRIPTION
20766
20767 =over 4
20768
20769 =item General behaviour in list contexts
20770
20771 [0], [1], [2]
20772
20773 =item General behaviour in scalar and void contexts
20774
20775 =item A note about prefixes
20776
20777 =item C<extract_delimited>
20778
20779 =item C<extract_bracketed>
20780
20781 =item C<extract_variable>
20782
20783 [0], [1], [2]
20784
20785 =item C<extract_tagged>
20786
20787 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
20788 [0], [1], [2], [3], [4], [5]
20789
20790 =item C<gen_extract_tagged>
20791
20792 =item C<extract_quotelike>
20793
20794 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
20795
20796 =item C<extract_quotelike> and "here documents"
20797
20798 [0], [1], [2], [3], [4], [5], [6], [7..10]
20799
20800 =item C<extract_codeblock>
20801
20802 =item C<extract_multiple>
20803
20804 =item C<gen_delimited_pat>
20805
20806 =back
20807
20808 =item DIAGNOSTICS
20809
20810  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>, 
20811 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
20812 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">, 
20813 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
20814 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
20815 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
20816 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
20817 after dereferencer>, C<Did not find expected opening bracket at %s>,
20818 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
20819 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
20820 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
20821 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
20822 tag>
20823
20824 =item AUTHOR
20825
20826 =item BUGS AND IRRITATIONS
20827
20828 =item COPYRIGHT
20829
20830 =back
20831
20832 =head2 Text::ParseWords - parse text into an array of tokens or array of
20833 arrays
20834
20835 =over 4
20836
20837 =item SYNOPSIS
20838
20839 =item DESCRIPTION
20840
20841 =item EXAMPLES
20842
20843 =item AUTHORS
20844
20845 =back
20846
20847 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
20848 by Knuth
20849
20850 =over 4
20851
20852 =item SYNOPSIS
20853
20854 =item DESCRIPTION
20855
20856 =item EXAMPLES
20857
20858 =item LIMITATIONS
20859
20860 =item AUTHOR
20861
20862 =back
20863
20864 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
20865 unexpand(1)
20866
20867 =over 4
20868
20869 =item SYNOPSIS
20870
20871 =item DESCRIPTION
20872
20873 =item BUGS
20874
20875 =item AUTHOR
20876
20877 =back
20878
20879 =head2 Text::Wrap - line wrapping to form simple paragraphs
20880
20881 =over 4
20882
20883 =item SYNOPSIS 
20884
20885 =item DESCRIPTION
20886
20887 =item OVERRIDES
20888
20889 =item EXAMPLE
20890
20891 =item AUTHOR
20892
20893 =back
20894
20895 =head2 Thread - manipulate threads in Perl (for old code only)
20896
20897 =over 4
20898
20899 =item CAVEAT
20900
20901 =item SYNOPSIS
20902
20903 =item DESCRIPTION
20904
20905 =item FUNCTIONS
20906
20907 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
20908 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
20909 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
20910
20911 =item METHODS
20912
20913 join, eval, detach, equal, tid, flags, done
20914
20915 =item LIMITATIONS
20916
20917 =item SEE ALSO
20918
20919 =back
20920
20921 =head2 Thread::Queue - thread-safe queues
20922
20923 =over 4
20924
20925 =item SYNOPSIS
20926
20927 =item DESCRIPTION
20928
20929 =item FUNCTIONS AND METHODS
20930
20931 new, enqueue LIST, dequeue, dequeue_nb, pending
20932
20933 =item SEE ALSO
20934
20935 =back
20936
20937 =head2 Thread::Semaphore - thread-safe semaphores
20938
20939 =over 4
20940
20941 =item SYNOPSIS
20942
20943 =item DESCRIPTION
20944
20945 =item FUNCTIONS AND METHODS
20946
20947 new, new NUMBER, down, down NUMBER, up, up NUMBER
20948
20949 =back
20950
20951 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
20952 (for old code)
20953
20954 =over 4
20955
20956 =item CAVEAT
20957
20958 =item SYNOPSIS
20959
20960 =item DESCRIPTION
20961
20962 =item BUGS
20963
20964 =back
20965
20966 =head2 Thread::Specific - thread-specific keys
20967
20968 =over 4
20969
20970 =item SYNOPSIS
20971
20972 =item DESCRIPTION
20973
20974 =back
20975
20976 =head2 Tie::Array - base class for tied arrays
20977
20978 =over 4
20979
20980 =item SYNOPSIS
20981
20982 =item DESCRIPTION
20983
20984 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
20985 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
20986 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
20987 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
20988
20989 =item CAVEATS
20990
20991 =item AUTHOR
20992
20993 =back
20994
20995 =head2 Tie::File - Access the lines of a disk file via a Perl array
20996
20997 =over 4
20998
20999 =item SYNOPSIS
21000
21001 =item DESCRIPTION
21002
21003 =over 4
21004
21005 =item C<recsep>
21006
21007 =item C<autochomp>
21008
21009 =item C<mode>
21010
21011 =item C<memory>
21012
21013 =item C<dw_size>
21014
21015 =item Option Format
21016
21017 =back
21018
21019 =item Public Methods
21020
21021 =over 4
21022
21023 =item C<flock>
21024
21025 =item C<autochomp>
21026
21027 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
21028
21029 =item C<offset>
21030
21031 =back
21032
21033 =item Tying to an already-opened filehandle
21034
21035 =item Deferred Writing
21036
21037 =over 4
21038
21039 =item Autodeferring
21040
21041 =back
21042
21043 =item CONCURRENT ACCESS TO FILES
21044
21045 =item CAVEATS
21046
21047 =item SUBCLASSING
21048
21049 =item WHAT ABOUT C<DB_File>?
21050
21051 =item AUTHOR
21052
21053 =item LICENSE
21054
21055 =item WARRANTY
21056
21057 =item THANKS
21058
21059 =item TODO
21060
21061 =back
21062
21063 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
21064 handles
21065
21066 =over 4
21067
21068 =item SYNOPSIS
21069
21070 =item DESCRIPTION
21071
21072 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
21073 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
21074 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
21075 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
21076
21077 =item MORE INFORMATION
21078
21079 =item COMPATIBILITY
21080
21081 =back
21082
21083 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
21084 tied hashes
21085
21086 =over 4
21087
21088 =item SYNOPSIS
21089
21090 =item DESCRIPTION
21091
21092 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
21093 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR
21094 this, SCALAR this
21095
21096 =item Inheriting from B<Tie::StdHash>
21097
21098 =item Inheriting from B<Tie::ExtraHash>
21099
21100 =item C<SCALAR>, C<UNTIE> and C<DESTROY>
21101
21102 =item MORE INFORMATION
21103
21104 =back
21105
21106 =head2 Tie::Memoize - add data to hash when needed
21107
21108 =over 4
21109
21110 =item SYNOPSIS
21111
21112 =item DESCRIPTION
21113
21114 =item Inheriting from B<Tie::Memoize>
21115
21116 =item EXAMPLE
21117
21118 =item BUGS
21119
21120 =item AUTHOR
21121
21122 =back
21123
21124 =head2 Tie::RefHash - use references as hash keys
21125
21126 =over 4
21127
21128 =item SYNOPSIS
21129
21130 =item DESCRIPTION
21131
21132 =item EXAMPLE
21133
21134 =item AUTHOR
21135
21136 =item VERSION
21137
21138 =item SEE ALSO
21139
21140 =back
21141
21142 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
21143 scalars
21144
21145 =over 4
21146
21147 =item SYNOPSIS
21148
21149 =item DESCRIPTION
21150
21151 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
21152
21153 =item MORE INFORMATION
21154
21155 =back
21156
21157 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
21158
21159 =over 4
21160
21161 =item SYNOPSIS
21162
21163 =item DESCRIPTION
21164
21165 =item CAVEATS
21166
21167 =back
21168
21169 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
21170 timers
21171
21172 =over 4
21173
21174 =item SYNOPSIS
21175
21176 =item DESCRIPTION
21177
21178 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
21179 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
21180 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer (
21181 $which, $floating_seconds [, $interval_floating_seconds ] ), getitimer (
21182 $which )
21183
21184 =item EXAMPLES
21185
21186 =item C API
21187
21188 =item DIAGNOSTICS
21189
21190 =over 4
21191
21192 =item negative time not invented yet
21193
21194 =item internal error: useconds < 0 (unsigned ... signed ...)
21195
21196 =back
21197
21198 =item CAVEATS
21199
21200 =item AUTHORS
21201
21202 =item COPYRIGHT AND LICENSE
21203
21204 =back
21205
21206 =head2 Time::Local - efficiently compute time from local and GMT time
21207
21208 =over 4
21209
21210 =item SYNOPSIS
21211
21212 =item DESCRIPTION
21213
21214 =over 4
21215
21216 =item Ambiguous Local Times (DST)
21217
21218 =item Non-Existent Local Times (DST)
21219
21220 =item Negative Epoch Values
21221
21222 =back
21223
21224 =item IMPLEMENTATION
21225
21226 =item BUGS
21227
21228 =item SUPPORT
21229
21230 =item AUTHOR
21231
21232 =back
21233
21234 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
21235 function
21236
21237 =over 4
21238
21239 =item SYNOPSIS
21240
21241 =item DESCRIPTION
21242
21243 =item NOTE
21244
21245 =item AUTHOR
21246
21247 =back
21248
21249 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
21250 function
21251
21252 =over 4
21253
21254 =item SYNOPSIS
21255
21256 =item DESCRIPTION
21257
21258 =item NOTE
21259
21260 =item AUTHOR
21261
21262 =back
21263
21264 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
21265
21266 =over 4
21267
21268 =item SYNOPSIS
21269
21270 =item DESCRIPTION
21271
21272 =item AUTHOR
21273
21274 =back
21275
21276 =head2 UNIVERSAL - base class for ALL classes (blessed references)
21277
21278 =over 4
21279
21280 =item SYNOPSIS
21281
21282 =item DESCRIPTION
21283
21284 C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<isa( VAL, TYPE )>,
21285 C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD ) >>, C<<
21286 CLASS->can( METHOD ) >>, C<can( VAL, METHOD )>, C<VERSION ( [ REQUIRE ] )>
21287
21288 =item EXPORTS
21289
21290 =back
21291
21292 =head2 Unicode::Collate - Unicode Collation Algorithm
21293
21294 =over 4
21295
21296 =item SYNOPSIS
21297
21298 =item DESCRIPTION
21299
21300 =over 4
21301
21302 =item Constructor and Tailoring
21303
21304 UCA_Version, backwards, entry, hangul_terminator, ignoreName, ignoreChar,
21305 level, normalization, overrideCJK, overrideHangul, preprocess, rearrange,
21306 table, undefName, undefChar, katakana_before_hiragana, upper_before_lower,
21307 variable, alternate
21308
21309 =item Methods for Collation
21310
21311 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
21312 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
21313 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
21314 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
21315 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
21316 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
21317 $Collator-E<gt>viewSortKey($string)>
21318
21319 =item Methods for Searching
21320
21321 C<$position = $Collator-E<gt>index($string, $substring[, $position])>,
21322 C<($position, $length) = $Collator-E<gt>index($string, $substring[,
21323 $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>,
21324 C<($match)   = $Collator-E<gt>match($string, $substring)>, C<@match =
21325 $Collator-E<gt>gmatch($string, $substring)>, C<$count =
21326 $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count =
21327 $Collator-E<gt>gsubst($string, $substring, $replacement)>
21328
21329 =item Other Methods
21330
21331 C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, C<$version =
21332 $Collator-E<gt>version()>, C<UCA_Version()>, C<Base_Unicode_Version()>
21333
21334 =item EXPORT
21335
21336 =item CAVEAT
21337
21338 =item Conformance Test
21339
21340 =back
21341
21342 =item AUTHOR
21343
21344 =item SEE ALSO
21345
21346 Unicode Collation Algorithm - UTS #10, The Default Unicode Collation
21347 Element Table (DUCET), The conformance test for the UCA, Hangul Syllable
21348 Type, Unicode Normalization Forms - UAX #15, L<Unicode::Normalize>
21349
21350 =back
21351
21352 =head2 Unicode::Normalize - Unicode Normalization Forms
21353
21354 =over 4
21355
21356 =item SYNOPSIS
21357
21358 =item DESCRIPTION
21359
21360 =over 4
21361
21362 =item Normalization Forms
21363
21364 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
21365 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
21366 C<$FCD_string = FCD($string)>, C<$FCC_string = FCC($string)>,
21367 C<$normalized_string = normalize($form_name, $string)>
21368
21369 =item Decomposition and Composition
21370
21371 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
21372 decompose($string, $useCompatMapping)>, C<$reordered_string  =
21373 reorder($string)>, C<$composed_string   = compose($string)>
21374
21375 =item Quick Check
21376
21377 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
21378 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
21379 checkFCD($string)>, C<$result = checkFCC($string)>, C<$result =
21380 check($form_name, $string)>
21381
21382 =item Character Data
21383
21384 C<$canonical_decomposed = getCanon($codepoint)>,
21385 C<$compatibility_decomposed = getCompat($codepoint)>,
21386 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
21387 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
21388 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
21389 C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>,
21390 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
21391
21392 =item EXPORT
21393
21394 =back
21395
21396 =item AUTHOR
21397
21398 =item SEE ALSO
21399
21400 http://www.unicode.org/reports/tr15/,
21401 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt,
21402 http://www.unicode.org/notes/tn5/
21403
21404 =back
21405
21406 =head2 Unicode::UCD - Unicode character database
21407
21408 =over 4
21409
21410 =item SYNOPSIS
21411
21412 =item DESCRIPTION
21413
21414 =back
21415
21416 =over 4
21417
21418 =item charinfo
21419
21420 =back
21421
21422 =over 4
21423
21424 =item charblock
21425
21426 =back
21427
21428 =over 4
21429
21430 =item charscript
21431
21432 =back
21433
21434 =over 4
21435
21436 =item charblocks
21437
21438 =back
21439
21440 =over 4
21441
21442 =item charscripts
21443
21444 =back
21445
21446 =over 4
21447
21448 =item Blocks versus Scripts
21449
21450 =item Matching Scripts and Blocks
21451
21452 =item Code Point Arguments
21453
21454 =item charinrange
21455
21456 =back
21457
21458 =over 4
21459
21460 =item compexcl
21461
21462 =back
21463
21464 =over 4
21465
21466 =item casefold
21467
21468 =back
21469
21470 =over 4
21471
21472 =item casespec
21473
21474 =back
21475
21476 =over 4
21477
21478 =item Unicode::UCD::UnicodeVersion
21479
21480 =back
21481
21482 =over 4
21483
21484 =item Implementation Note
21485
21486 =back
21487
21488 =over 4
21489
21490 =item BUGS
21491
21492 =item AUTHOR
21493
21494 =back
21495
21496 =head2 User::grent - by-name interface to Perl's built-in getgr*()
21497 functions
21498
21499 =over 4
21500
21501 =item SYNOPSIS
21502
21503 =item DESCRIPTION
21504
21505 =item NOTE
21506
21507 =item AUTHOR
21508
21509 =back
21510
21511 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
21512 functions
21513
21514 =over 4
21515
21516 =item SYNOPSIS
21517
21518 =item DESCRIPTION
21519
21520 =over 4
21521
21522 =item System Specifics
21523
21524 =back
21525
21526 =item NOTE
21527
21528 =item AUTHOR
21529
21530 =item HISTORY
21531
21532 March 18th, 2000
21533
21534 =back
21535
21536 =head2 XSLoader - Dynamically load C libraries into Perl code
21537
21538 =over 4
21539
21540 =item SYNOPSIS
21541
21542 =item DESCRIPTION
21543
21544 =over 4
21545
21546 =item Migration from C<DynaLoader>
21547
21548 =item Backward compatible boilerplate
21549
21550 =back
21551
21552 =item Order of initialization: early load()
21553
21554 =over 4
21555
21556 =item The most hairy case
21557
21558 =back
21559
21560 =item LIMITATIONS
21561
21562 =item AUTHOR
21563
21564 =back
21565
21566 =head1 AUXILIARY DOCUMENTATION
21567
21568 Here should be listed all the extra programs' documentation, but they
21569 don't all have manual pages yet:
21570
21571 =over 4
21572
21573 =item a2p
21574
21575 =item c2ph
21576
21577 =item dprofpp
21578
21579 =item h2ph
21580
21581 =item h2xs
21582
21583 =item perlbug
21584
21585 =item perldoc
21586
21587 =item pl2pm
21588
21589 =item pod2html
21590
21591 =item pod2man
21592
21593 =item s2p
21594
21595 =item splain
21596
21597 =item xsubpp
21598
21599 =back
21600
21601 =head1 AUTHOR
21602
21603 Larry Wall <F<larry@wall.org>>, with the help of oodles
21604 of other folks.
21605