Add a note in perltodo about a potential extension of readpipe()
[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 Byte-order modifiers
2095
2096 =item Floating point Numbers
2097
2098 =back
2099
2100 =item Exotic Templates
2101
2102 =over 4
2103
2104 =item Bit Strings
2105
2106 =item Uuencoding
2107
2108 =item Doing Sums
2109
2110 =item  Unicode
2111
2112 =item Another Portable Binary Encoding
2113
2114 =back
2115
2116 =item Template Grouping
2117
2118 =item Lengths and Widths
2119
2120 =over 4
2121
2122 =item String Lengths
2123
2124 =item Dynamic Templates
2125
2126 =item Counting Repetitions
2127
2128 =back
2129
2130 =item Packing and Unpacking C Structures
2131
2132 =over 4
2133
2134 =item The Alignment Pit
2135
2136 =item Dealing with Endian-ness
2137
2138 =item Alignment, Take 2
2139
2140 =item Alignment, Take 3
2141
2142 =item Pointers for How to Use Them
2143
2144 =back
2145
2146 =item Pack Recipes
2147
2148 =item Funnies Section
2149
2150 =item Authors
2151
2152 =back
2153
2154 =head2 perlpod - the Plain Old Documentation format
2155
2156 =over 4
2157
2158 =item DESCRIPTION
2159
2160 =over 4
2161
2162 =item Ordinary Paragraph
2163
2164 =item Verbatim Paragraph
2165
2166 =item Command Paragraph
2167
2168 C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
2169 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item
2170 I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end
2171 I<formatname>>, C<=for I<formatname> I<text...>>, C<=encoding
2172 I<encodingname>>
2173
2174 =item Formatting Codes
2175
2176 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2177 C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink,
2178 C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used
2179 for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces,
2180 C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null
2181 (zero-effect) formatting code
2182
2183 =item The Intent
2184
2185 =item Embedding Pods in Perl Modules
2186
2187 =item Hints for Writing Pod
2188
2189 =back
2190
2191 =item SEE ALSO
2192
2193 =item AUTHOR
2194
2195 =back
2196
2197 =head2 perlpodspec - Plain Old Documentation: format specification and
2198 notes
2199
2200 =over 4
2201
2202 =item DESCRIPTION
2203
2204 =item Pod Definitions
2205
2206 =item Pod Commands
2207
2208 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
2209 "=back", "=begin formatname", "=end formatname", "=for formatname text...",
2210 "=encoding encodingname"
2211
2212 =item Pod Formatting Codes
2213
2214 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2215 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
2216 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
2217 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
2218 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
2219 contains non-breaking spaces
2220
2221 =item Notes on Implementing Pod Processors
2222
2223 =item About LE<lt>...E<gt> Codes
2224
2225 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
2226
2227 =item About =over...=back Regions
2228
2229 =item About Data Paragraphs and "=begin/=end" Regions
2230
2231 =item SEE ALSO
2232
2233 =item AUTHOR
2234
2235 =back
2236
2237 =head2 perlrun - how to execute the Perl interpreter
2238
2239 =over 4
2240
2241 =item SYNOPSIS
2242
2243 =item DESCRIPTION
2244
2245 =over 4
2246
2247 =item #! and quoting on non-Unix systems
2248
2249 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
2250
2251 =item Location of Perl
2252
2253 =item Command Switches
2254
2255 B<-0>[I<octal/hexadecimal>], B<-A [I<assertions>]>, B<-a>, B<-C
2256 [I<number/list>]>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>, B<-D>I<letters>,
2257 B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>, B<-h>,
2258 B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
2259 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
2260 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
2261 B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>,
2262 B<-X>, B<-x>, B<-x> I<directory>
2263
2264 =back
2265
2266 =item ENVIRONMENT
2267
2268 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
2269 :perlio, :pop, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
2270 PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS,
2271 PERL_DESTRUCT_LEVEL, PERL_DL_NONLAZY, PERL_ENCODING, PERL_HASH_SEED,
2272 PERL_HASH_SEED_DEBUG, PERL_ROOT (specific to the VMS port), PERL_SIGNALS,
2273 PERL_UNICODE, SYS$LOGIN (specific to the VMS port)
2274
2275 =back
2276
2277 =head2 perldiag - various Perl diagnostics
2278
2279 =over 4
2280
2281 =item DESCRIPTION
2282
2283 =back
2284
2285 =head2 perllexwarn - Perl Lexical Warnings
2286
2287 =over 4
2288
2289 =item DESCRIPTION
2290
2291 =over 4
2292
2293 =item Default Warnings and Optional Warnings
2294
2295 =item What's wrong with B<-w> and C<$^W>
2296
2297 =item Controlling Warnings from the Command Line
2298
2299 B<-w>, B<-W>, B<-X>
2300
2301 =item Backward Compatibility
2302
2303 =item Category Hierarchy
2304
2305 =item Fatal Warnings
2306
2307 =item Reporting Warnings from a Module
2308
2309 =back
2310
2311 =item TODO
2312
2313 =item SEE ALSO
2314
2315 =item AUTHOR
2316
2317 =back
2318
2319 =head2 perldebug - Perl debugging
2320
2321 =over 4
2322
2323 =item DESCRIPTION
2324
2325 =item The Perl Debugger
2326
2327 =over 4
2328
2329 =item Debugger Commands
2330
2331 h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y
2332 [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l
2333 min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/,
2334 ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b
2335 subname [condition], b postpone subname [condition], b load filename, b
2336 compile subname, B line, B *, a [line] command, A line, A *, w expr, W
2337 expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [
2338 command ], < *, << command, > ?, > command, > *, >> command, { ?, { [
2339 command ], { *, {{ command, ! number, ! -number, ! pattern, !! cmd, source
2340 file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man
2341 [manpage]
2342
2343 =item Configurable Options
2344
2345 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
2346 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
2347 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
2348 C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
2349 C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
2350 C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
2351 C<NonStop>
2352
2353 =item Debugger input/output
2354
2355 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
2356 listing
2357
2358 =item Debugging compile-time statements
2359
2360 =item Debugger Customization
2361
2362 =item Readline Support
2363
2364 =item Editor Support for Debugging
2365
2366 =item The Perl Profiler
2367
2368 =back
2369
2370 =item Debugging regular expressions
2371
2372 =item Debugging memory usage
2373
2374 =item SEE ALSO
2375
2376 =item BUGS
2377
2378 =back
2379
2380 =head2 perlvar - Perl predefined variables
2381
2382 =over 4
2383
2384 =item DESCRIPTION
2385
2386 =over 4
2387
2388 =item Predefined Names
2389
2390 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
2391 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+,
2392 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
2393 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
2394 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
2395 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
2396 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
2397 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $#,
2398 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
2399 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
2400 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
2401 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
2402 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
2403 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
2404 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
2405 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
2406 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
2407 IO::Handle->format_line_break_characters EXPR,
2408 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
2409 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
2410 $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
2411 $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
2412 $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
2413 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
2414 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
2415 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
2416 0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R,
2417 $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, ${^UNICODE},
2418 $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, $EXECUTABLE_NAME, $^X,
2419 ARGV, $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG,
2420 $SIG{expr}
2421
2422 =item Error Indicators
2423
2424 =item Technical Note on the Syntax of Variable Names
2425
2426 =back
2427
2428 =item BUGS
2429
2430 =back
2431
2432 =head2 perlre - Perl regular expressions
2433
2434 =over 4
2435
2436 =item DESCRIPTION
2437
2438 i, m, s, x
2439
2440 =over 4
2441
2442 =item Regular Expressions
2443
2444 [1], [2], [3], cntrl, graph, print, punct, xdigit
2445
2446 =item Extended Patterns
2447
2448 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
2449 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
2450 code })>, C<(??{ code })>, C<< (?>pattern) >>,
2451 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
2452
2453 =item Backtracking
2454
2455 =item Version 8 Regular Expressions
2456
2457 =item Warning on \1 vs $1
2458
2459 =item Repeated patterns matching zero-length substring
2460
2461 =item Combining pieces together
2462
2463 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
2464 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
2465 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
2466 C<(?(condition)yes-pattern|no-pattern)>
2467
2468 =item Creating custom RE engines
2469
2470 =back
2471
2472 =item BUGS
2473
2474 =item SEE ALSO
2475
2476 =back
2477
2478 =head2 perlreref - Perl Regular Expressions Reference
2479
2480 =over 4
2481
2482 =item DESCRIPTION
2483
2484 =over 4
2485
2486 =item OPERATORS
2487
2488 =item SYNTAX
2489
2490 =item ESCAPE SEQUENCES
2491
2492 =item CHARACTER CLASSES
2493
2494 =item ANCHORS
2495
2496 =item QUANTIFIERS
2497
2498 =item EXTENDED CONSTRUCTS
2499
2500 =item VARIABLES
2501
2502 =item FUNCTIONS
2503
2504 =item TERMINOLOGY
2505
2506 =back
2507
2508 =item AUTHOR
2509
2510 =item SEE ALSO
2511
2512 =item THANKS
2513
2514 =back
2515
2516 =head2 perlref - Perl references and nested data structures
2517
2518 =over 4
2519
2520 =item NOTE
2521
2522 =item DESCRIPTION
2523
2524 =over 4
2525
2526 =item Making References
2527
2528 =item Using References
2529
2530 =item Symbolic references
2531
2532 =item Not-so-symbolic references
2533
2534 =item Pseudo-hashes: Using an array as a hash
2535
2536 =item Function Templates
2537
2538 =back
2539
2540 =item WARNING
2541
2542 =item SEE ALSO
2543
2544 =back
2545
2546 =head2 perlform - Perl formats
2547
2548 =over 4
2549
2550 =item DESCRIPTION
2551
2552 =over 4
2553
2554 =item Text Fields
2555
2556 =item Numeric Fields
2557
2558 =item The Field @* for Variable Width Multi-Line Text
2559
2560 =item The Field ^* for Variable Width One-line-at-a-time Text
2561
2562 =item Specifying Values
2563
2564 =item Using Fill Mode
2565
2566 =item Suppressing Lines Where All Fields Are Void
2567
2568 =item Repeating Format Lines
2569
2570 =item Top of Form Processing
2571
2572 =item Format Variables
2573
2574 =back
2575
2576 =item NOTES
2577
2578 =over 4
2579
2580 =item Footers
2581
2582 =item Accessing Formatting Internals
2583
2584 =back
2585
2586 =item WARNINGS
2587
2588 =back
2589
2590 =head2 perlobj - Perl objects
2591
2592 =over 4
2593
2594 =item DESCRIPTION
2595
2596 =over 4
2597
2598 =item An Object is Simply a Reference
2599
2600 =item A Class is Simply a Package
2601
2602 =item A Method is Simply a Subroutine
2603
2604 =item Method Invocation
2605
2606 =item Indirect Object Syntax
2607
2608 =item Default UNIVERSAL methods
2609
2610 isa(CLASS), can(METHOD), VERSION( [NEED] )
2611
2612 =item Destructors
2613
2614 =item Summary
2615
2616 =item Two-Phased Garbage Collection
2617
2618 =back
2619
2620 =item SEE ALSO
2621
2622 =back
2623
2624 =head2 perltie - how to hide an object class in a simple variable
2625
2626 =over 4
2627
2628 =item SYNOPSIS
2629
2630 =item DESCRIPTION
2631
2632 =over 4
2633
2634 =item Tying Scalars
2635
2636 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
2637 DESTROY this
2638
2639 =item Tying Arrays
2640
2641 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
2642 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
2643 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
2644 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
2645 this
2646
2647 =item Tying Hashes
2648
2649 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
2650 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
2651 this, NEXTKEY this, lastkey, SCALAR this, UNTIE this, DESTROY this
2652
2653 =item Tying FileHandles
2654
2655 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
2656 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
2657 DESTROY this
2658
2659 =item UNTIE this
2660
2661 =item The C<untie> Gotcha
2662
2663 =back
2664
2665 =item SEE ALSO
2666
2667 =item BUGS
2668
2669 =item AUTHOR
2670
2671 =back
2672
2673 =head2 perldbmfilter - Perl DBM Filters
2674
2675 =over 4
2676
2677 =item SYNOPSIS
2678
2679 =item DESCRIPTION
2680
2681 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
2682 B<filter_fetch_value>
2683
2684 =over 4
2685
2686 =item The Filter
2687
2688 =item An Example -- the NULL termination problem.
2689
2690 =item Another Example -- Key is a C int.
2691
2692 =back
2693
2694 =item SEE ALSO
2695
2696 =item AUTHOR
2697
2698 =back
2699
2700 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
2701 safe subprocesses, sockets, and semaphores)
2702
2703 =over 4
2704
2705 =item DESCRIPTION
2706
2707 =item Signals
2708
2709 =over 4
2710
2711 =item Handling the SIGHUP Signal in Daemons
2712
2713 =back
2714
2715 =item Named Pipes
2716
2717 =over 4
2718
2719 =item Deferred Signals (Safe Signals)
2720
2721 Long running opcodes, Interrupting IO, Restartable system calls, Signals as
2722 "faults", Signals triggered by operating system state
2723
2724 =back
2725
2726 =item Using open() for IPC
2727
2728 =over 4
2729
2730 =item Filehandles
2731
2732 =item Background Processes
2733
2734 =item Complete Dissociation of Child from Parent
2735
2736 =item Safe Pipe Opens
2737
2738 =item Bidirectional Communication with Another Process
2739
2740 =item Bidirectional Communication with Yourself
2741
2742 =back
2743
2744 =item Sockets: Client/Server Communication
2745
2746 =over 4
2747
2748 =item Internet Line Terminators
2749
2750 =item Internet TCP Clients and Servers
2751
2752 =item Unix-Domain TCP Clients and Servers
2753
2754 =back
2755
2756 =item TCP Clients with IO::Socket
2757
2758 =over 4
2759
2760 =item A Simple Client
2761
2762 C<Proto>, C<PeerAddr>, C<PeerPort>
2763
2764 =item A Webget Client
2765
2766 =item Interactive Client with IO::Socket
2767
2768 =back
2769
2770 =item TCP Servers with IO::Socket
2771
2772 Proto, LocalPort, Listen, Reuse
2773
2774 =item UDP: Message Passing
2775
2776 =item SysV IPC
2777
2778 =item NOTES
2779
2780 =item BUGS
2781
2782 =item AUTHOR
2783
2784 =item SEE ALSO
2785
2786 =back
2787
2788 =head2 perlfork - Perl's fork() emulation
2789
2790 =over 4
2791
2792 =item SYNOPSIS
2793
2794 =item DESCRIPTION
2795
2796 =over 4
2797
2798 =item Behavior of other Perl features in forked pseudo-processes
2799
2800 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
2801 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
2802 files, directories and network sockets
2803
2804 =item Resource limits
2805
2806 =item Killing the parent process
2807
2808 =item Lifetime of the parent process and pseudo-processes
2809
2810 =item CAVEATS AND LIMITATIONS
2811
2812 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
2813 Global state maintained by XSUBs, Interpreter embedded in larger
2814 application, Thread-safety of extensions
2815
2816 =back
2817
2818 =item BUGS
2819
2820 =item AUTHOR
2821
2822 =item SEE ALSO
2823
2824 =back
2825
2826 =head2 perlnumber - semantics of numbers and numeric operations in Perl
2827
2828 =over 4
2829
2830 =item SYNOPSIS
2831
2832 =item DESCRIPTION
2833
2834 =item Storing numbers
2835
2836 =item Numeric operators and numeric conversions
2837
2838 =item Flavors of Perl numeric operations
2839
2840 Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other
2841 mathematical operators, Bitwise operators, Bitwise operators during C<use
2842 integer>, Operators which expect an integer, Operators which expect a
2843 string
2844
2845 =item AUTHOR
2846
2847 =item SEE ALSO
2848
2849 =back
2850
2851 =head2 perlthrtut - tutorial on threads in Perl
2852
2853 =over 4
2854
2855 =item DESCRIPTION
2856
2857 =item Status
2858
2859 =item What Is A Thread Anyway?
2860
2861 =item Threaded Program Models
2862
2863 =over 4
2864
2865 =item Boss/Worker
2866
2867 =item Work Crew
2868
2869 =item Pipeline
2870
2871 =back
2872
2873 =item What kind of threads are Perl threads?
2874
2875 =item Thread-Safe Modules
2876
2877 =item Thread Basics
2878
2879 =over 4
2880
2881 =item Basic Thread Support
2882
2883 =item A Note about the Examples
2884
2885 =item Creating Threads
2886
2887 =item Waiting For A Thread To Exit
2888
2889 =item Ignoring A Thread
2890
2891 =back
2892
2893 =item Threads And Data
2894
2895 =over 4
2896
2897 =item Shared And Unshared Data
2898
2899 =item Thread Pitfalls: Races
2900
2901 =back
2902
2903 =item Synchronization and control
2904
2905 =over 4
2906
2907 =item Controlling access: lock()
2908
2909 =item A Thread Pitfall: Deadlocks
2910
2911 =item Queues: Passing Data Around
2912
2913 =item Semaphores: Synchronizing Data Access
2914
2915 =item Basic semaphores
2916
2917 =item Advanced Semaphores
2918
2919 =item cond_wait() and cond_signal()
2920
2921 =item Giving up control
2922
2923 =back
2924
2925 =item General Thread Utility Routines
2926
2927 =over 4
2928
2929 =item What Thread Am I In?
2930
2931 =item Thread IDs
2932
2933 =item Are These Threads The Same?
2934
2935 =item What Threads Are Running?
2936
2937 =back
2938
2939 =item A Complete Example
2940
2941 =item Different implementations of threads
2942
2943 =item Performance considerations
2944
2945 =item Process-scope Changes
2946
2947 =item Thread-Safety of System Libraries
2948
2949 =item Conclusion
2950
2951 =item Bibliography
2952
2953 =over 4
2954
2955 =item Introductory Texts
2956
2957 =item OS-Related References
2958
2959 =item Other References
2960
2961 =back
2962
2963 =item Acknowledgements
2964
2965 =item AUTHOR
2966
2967 =item Copyrights
2968
2969 =back
2970
2971 =head2 perlothrtut - old tutorial on threads in Perl
2972
2973 =over 4
2974
2975 =item DESCRIPTION
2976
2977 =item What Is A Thread Anyway?
2978
2979 =item Threaded Program Models
2980
2981 =over 4
2982
2983 =item Boss/Worker
2984
2985 =item Work Crew
2986
2987 =item Pipeline
2988
2989 =back
2990
2991 =item Native threads
2992
2993 =item What kind of threads are perl threads?
2994
2995 =item Threadsafe Modules
2996
2997 =item Thread Basics
2998
2999 =over 4
3000
3001 =item Basic Thread Support
3002
3003 =item Creating Threads
3004
3005 =item Giving up control
3006
3007 =item Waiting For A Thread To Exit
3008
3009 =item Errors In Threads
3010
3011 =item Ignoring A Thread
3012
3013 =back
3014
3015 =item Threads And Data
3016
3017 =over 4
3018
3019 =item Shared And Unshared Data
3020
3021 =item Thread Pitfall: Races
3022
3023 =item Controlling access: lock()
3024
3025 =item Thread Pitfall: Deadlocks
3026
3027 =item Queues: Passing Data Around
3028
3029 =back
3030
3031 =item Threads And Code
3032
3033 =over 4
3034
3035 =item Semaphores: Synchronizing Data Access
3036
3037 Basic semaphores, Advanced Semaphores
3038
3039 =item Attributes: Restricting Access To Subroutines
3040
3041 =item Subroutine Locks
3042
3043 =item Methods
3044
3045 =item Locking A Subroutine
3046
3047 =back
3048
3049 =item General Thread Utility Routines
3050
3051 =over 4
3052
3053 =item What Thread Am I In?
3054
3055 =item Thread IDs
3056
3057 =item Are These Threads The Same?
3058
3059 =item What Threads Are Running?
3060
3061 =back
3062
3063 =item A Complete Example
3064
3065 =item Conclusion
3066
3067 =item Bibliography
3068
3069 =over 4
3070
3071 =item Introductory Texts
3072
3073 =item OS-Related References
3074
3075 =item Other References
3076
3077 =back
3078
3079 =item Acknowledgements
3080
3081 =item AUTHOR
3082
3083 =item Copyrights
3084
3085 =back
3086
3087 =head2 perlport - Writing portable Perl
3088
3089 =over 4
3090
3091 =item DESCRIPTION
3092
3093 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
3094 portable
3095
3096 =item ISSUES
3097
3098 =over 4
3099
3100 =item Newlines
3101
3102 =item Numbers endianness and Width
3103
3104 =item Files and Filesystems
3105
3106 =item System Interaction
3107
3108 =item Command names versus file pathnames
3109
3110 =item Networking
3111
3112 =item Interprocess Communication (IPC)
3113
3114 =item External Subroutines (XS)
3115
3116 =item Standard Modules
3117
3118 =item Time and Date
3119
3120 =item Character sets and character encoding
3121
3122 =item Internationalisation
3123
3124 =item System Resources
3125
3126 =item Security
3127
3128 =item Style
3129
3130 =back
3131
3132 =item CPAN Testers
3133
3134 Mailing list: cpan-testers@perl.org, Testing results:
3135 http://testers.cpan.org/
3136
3137 =item PLATFORMS
3138
3139 =over 4
3140
3141 =item Unix
3142
3143 =item DOS and Derivatives
3144
3145 =item S<Mac OS>
3146
3147 =item VMS
3148
3149 =item VOS
3150
3151 =item EBCDIC Platforms
3152
3153 =item Acorn RISC OS
3154
3155 =item Other perls
3156
3157 =back
3158
3159 =item FUNCTION IMPLEMENTATIONS
3160
3161 =over 4
3162
3163 =item Alphabetical Listing of Perl Functions
3164
3165 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, binmode FILEHANDLE, chmod LIST, chown
3166 LIST, chroot FILENAME, chroot, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen
3167 HASH,DBNAME,MODE, dump LABEL, exec LIST, exit EXPR, exit, fcntl
3168 FILEHANDLE,FUNCTION,SCALAR, flock FILEHANDLE,OPERATION, fork, getlogin,
3169 getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME,
3170 getnetbyname NAME, getpwuid UID, getgrgid GID, getnetbyaddr ADDR,ADDRTYPE,
3171 getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, getgrent,
3172 gethostbyname, gethostent, getnetent, getprotoent, getservent, sethostent
3173 STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN,
3174 endpwent, endgrent, endhostent, endnetent, endprotoent, endservent,
3175 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl
3176 FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat
3177 FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd
3178 ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open
3179 FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select
3180 RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
3181 KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
3182 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
3183 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
3184 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
3185 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
3186 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
3187 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
3188 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
3189 wait, waitpid PID,FLAGS
3190
3191 =back
3192
3193 =item CHANGES
3194
3195 v1.49, 12 August 2002, v1.48, 02 February 2001, v1.47, 22 March 2000,
3196 v1.46, 12 February 2000, v1.45, 20 December 1999, v1.44, 19 July 1999,
3197 v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May 1999, v1.40, 11 April
3198 1999, v1.39, 11 February 1999, v1.38, 31 December 1998, v1.37, 19 December
3199 1998, v1.36, 9 September 1998, v1.35, 13 August 1998, v1.33, 06 August
3200 1998, v1.32, 05 August 1998, v1.30, 03 August 1998, v1.23, 10 July 1998
3201
3202 =item Supported Platforms
3203
3204 =item SEE ALSO
3205
3206 =item AUTHORS / CONTRIBUTORS
3207
3208 =back
3209
3210 =head2 perllocale - Perl locale handling (internationalization and
3211 localization)
3212
3213 =over 4
3214
3215 =item DESCRIPTION
3216
3217 =item PREPARING TO USE LOCALES
3218
3219 =item USING LOCALES
3220
3221 =over 4
3222
3223 =item The use locale pragma
3224
3225 =item The setlocale function
3226
3227 =item Finding locales
3228
3229 =item LOCALE PROBLEMS
3230
3231 =item Temporarily fixing locale problems
3232
3233 =item Permanently fixing locale problems
3234
3235 =item Permanently fixing your system's locale configuration
3236
3237 =item Fixing system locale configuration
3238
3239 =item The localeconv function
3240
3241 =item I18N::Langinfo
3242
3243 =back
3244
3245 =item LOCALE CATEGORIES
3246
3247 =over 4
3248
3249 =item Category LC_COLLATE: Collation
3250
3251 =item Category LC_CTYPE: Character Types
3252
3253 =item Category LC_NUMERIC: Numeric Formatting
3254
3255 =item Category LC_MONETARY: Formatting of monetary amounts
3256
3257 =item LC_TIME
3258
3259 =item Other categories
3260
3261 =back
3262
3263 =item SECURITY
3264
3265 =item ENVIRONMENT
3266
3267 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
3268 LC_NUMERIC, LC_TIME, LANG
3269
3270 =item NOTES
3271
3272 =over 4
3273
3274 =item Backward compatibility
3275
3276 =item I18N:Collate obsolete
3277
3278 =item Sort speed and memory use impacts
3279
3280 =item write() and LC_NUMERIC
3281
3282 =item Freely available locale definitions
3283
3284 =item I18n and l10n
3285
3286 =item An imperfect standard
3287
3288 =back
3289
3290 =item Unicode and UTF-8
3291
3292 =item BUGS
3293
3294 =over 4
3295
3296 =item Broken systems
3297
3298 =back
3299
3300 =item SEE ALSO
3301
3302 =item HISTORY
3303
3304 =back
3305
3306 =head2 perluniintro - Perl Unicode introduction
3307
3308 =over 4
3309
3310 =item DESCRIPTION
3311
3312 =over 4
3313
3314 =item Unicode
3315
3316 =item Perl's Unicode Support
3317
3318 =item Perl's Unicode Model
3319
3320 =item Unicode and EBCDIC
3321
3322 =item Creating Unicode
3323
3324 =item Handling Unicode
3325
3326 =item Legacy Encodings
3327
3328 =item Unicode I/O
3329
3330 =item Displaying Unicode As Text
3331
3332 =item Special Cases
3333
3334 =item Advanced Topics
3335
3336 =item Miscellaneous
3337
3338 =item Questions With Answers
3339
3340 =item Hexadecimal Notation
3341
3342 =item Further Resources
3343
3344 =back
3345
3346 =item UNICODE IN OLDER PERLS
3347
3348 =item SEE ALSO
3349
3350 =item ACKNOWLEDGMENTS
3351
3352 =item AUTHOR, COPYRIGHT, AND LICENSE
3353
3354 =back
3355
3356 =head2 perlunicode - Unicode support in Perl
3357
3358 =over 4
3359
3360 =item DESCRIPTION
3361
3362 =over 4
3363
3364 =item Important Caveats
3365
3366 Input and Output Layers, Regular Expressions, C<use utf8> still needed to
3367 enable UTF-8/UTF-EBCDIC in scripts, BOM-marked scripts and UTF-16 scripts
3368 autodetected, C<use encoding> needed to upgrade non-Latin-1 byte strings
3369
3370 =item Byte and Character Semantics
3371
3372 =item Effects of Character Semantics
3373
3374 =item Scripts
3375
3376 =item Blocks
3377
3378 =item User-Defined Character Properties
3379
3380 =item Character Encodings for Input and Output
3381
3382 =item Unicode Regular Expression Support Level
3383
3384 =item Unicode Encodings
3385
3386 =item Security Implications of Unicode
3387
3388 =item Unicode in Perl on EBCDIC
3389
3390 =item Locales
3391
3392 =item When Unicode Does Not Happen
3393
3394 =item Forcing Unicode in Perl (Or Unforcing Unicode in Perl)
3395
3396 =item Using Unicode in XS
3397
3398 =back
3399
3400 =item BUGS
3401
3402 =over 4
3403
3404 =item Interaction with Locales
3405
3406 =item Interaction with Extensions
3407
3408 =item Speed
3409
3410 =item Porting code from perl-5.6.X
3411
3412 =back
3413
3414 =item SEE ALSO
3415
3416 =back
3417
3418 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
3419
3420 =over 4
3421
3422 =item DESCRIPTION
3423
3424 =item COMMON CHARACTER CODE SETS
3425
3426 =over 4
3427
3428 =item ASCII
3429
3430 =item ISO 8859
3431
3432 =item Latin 1 (ISO 8859-1)
3433
3434 =item EBCDIC
3435
3436 =item 13 variant characters
3437
3438 =item 0037
3439
3440 =item 1047
3441
3442 =item POSIX-BC
3443
3444 =item Unicode code points versus EBCDIC code points
3445
3446 =item Remaining Perl Unicode problems in EBCDIC
3447
3448 =item Unicode and UTF
3449
3450 =item Using Encode
3451
3452 =back
3453
3454 =item SINGLE OCTET TABLES
3455
3456 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
3457
3458 =item IDENTIFYING CHARACTER CODE SETS
3459
3460 =item CONVERSIONS
3461
3462 =over 4
3463
3464 =item tr///
3465
3466 =item iconv
3467
3468 =item C RTL
3469
3470 =back
3471
3472 =item OPERATOR DIFFERENCES
3473
3474 =item FUNCTION DIFFERENCES
3475
3476 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
3477
3478 =item REGULAR EXPRESSION DIFFERENCES
3479
3480 =item SOCKETS
3481
3482 =item SORTING
3483
3484 =over 4
3485
3486 =item Ignore ASCII vs. EBCDIC sort differences.
3487
3488 =item MONO CASE then sort data.
3489
3490 =item Convert, sort data, then re convert.
3491
3492 =item Perform sorting on one type of machine only.
3493
3494 =back
3495
3496 =item TRANSFORMATION FORMATS
3497
3498 =over 4
3499
3500 =item URL decoding and encoding
3501
3502 =item uu encoding and decoding
3503
3504 =item Quoted-Printable encoding and decoding
3505
3506 =item Caesarian ciphers
3507
3508 =back
3509
3510 =item Hashing order and checksums
3511
3512 =item I18N AND L10N
3513
3514 =item MULTI OCTET CHARACTER SETS
3515
3516 =item OS ISSUES
3517
3518 =over 4
3519
3520 =item OS/400
3521
3522 PASE, IFS access
3523
3524 =item OS/390, z/OS
3525
3526 chcp, dataset access, OS/390, z/OS iconv, locales
3527
3528 =item VM/ESA?
3529
3530 =item POSIX-BC?
3531
3532 =back
3533
3534 =item BUGS
3535
3536 =item SEE ALSO
3537
3538 =item REFERENCES
3539
3540 =item HISTORY
3541
3542 =item AUTHOR
3543
3544 =back
3545
3546 =head2 perlsec - Perl security
3547
3548 =over 4
3549
3550 =item DESCRIPTION
3551
3552 =over 4
3553
3554 =item Laundering and Detecting Tainted Data
3555
3556 =item Switches On the "#!" Line
3557
3558 =item Taint mode and @INC
3559
3560 =item Cleaning Up Your Path
3561
3562 =item Security Bugs
3563
3564 =item Protecting Your Programs
3565
3566 =item Unicode
3567
3568 =item Algorithmic Complexity Attacks
3569
3570 =back
3571
3572 =item SEE ALSO
3573
3574 =back
3575
3576 =head2 perlmod - Perl modules (packages and symbol tables)
3577
3578 =over 4
3579
3580 =item DESCRIPTION
3581
3582 =over 4
3583
3584 =item Packages
3585
3586 =item Symbol Tables
3587
3588 =item BEGIN, CHECK, INIT and END
3589
3590 =item Perl Classes
3591
3592 =item Perl Modules
3593
3594 =item Making your module threadsafe
3595
3596 =back
3597
3598 =item SEE ALSO
3599
3600 =back
3601
3602 =head2 perlmodlib - constructing new Perl modules and finding existing ones
3603
3604 =over 4
3605
3606 =item THE PERL MODULE LIBRARY
3607
3608 =over 4
3609
3610 =item Pragmatic Modules
3611
3612 assertions, assertions::activate, attributes, attrs, autouse, base, bigint,
3613 bignum, bigrat, blib, bytes, charnames, constant, diagnostics, encoding,
3614 fields, filetest, if, integer, less, lib, locale, open, ops, overload, re,
3615 sigtrap, sort, strict, subs, threads, threads::shared, utf8, vars, version,
3616 vmsish, warnings, warnings::register
3617
3618 =item Standard Modules
3619
3620 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
3621 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
3622 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
3623 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
3624 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
3625 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
3626 Class::Struct, Config, Cwd, DB, DBM_Filter, DB_File, Data::Dumper,
3627 Devel::DProf, Devel::PPPort, Devel::Peek, Devel::SelfStubber, Digest,
3628 Digest::MD5, Digest::base, DirHandle, Dumpvalue, DynaLoader, Encode,
3629 Encode::Alias, Encode::Byte, Encode::CJKConstants, Encode::CN,
3630 Encode::CN::HZ, Encode::Config, Encode::EBCDIC, Encode::Encoder,
3631 Encode::Encoding, Encode::Guess, Encode::JP, Encode::JP::H2Z,
3632 Encode::JP::JIS7, Encode::KR, Encode::KR::2022_KR, Encode::MIME::Header,
3633 Encode::PerlIO, Encode::Supported, Encode::Symbol, Encode::TW,
3634 Encode::Unicode, Encode::Unicode::UTF7, English, Env, Errno, Exporter,
3635 Exporter::Heavy, ExtUtils::Command, ExtUtils::Command::MM,
3636 ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install,
3637 ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_Any,
3638 ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS,
3639 ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_UWIN,
3640 ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
3641 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker,
3642 ExtUtils::MakeMaker::FAQ, ExtUtils::MakeMaker::Tutorial,
3643 ExtUtils::MakeMaker::bytes, ExtUtils::MakeMaker::vmsish,
3644 ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists,
3645 ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename,
3646 File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find,
3647 File::Glob, File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc,
3648 File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix,
3649 File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache,
3650 FileHandle, Filter::Simple, Filter::Util::Call, FindBin, GDBM_File,
3651 Getopt::Long, Getopt::Std, Hash::Util, I18N::Collate, I18N::LangTags,
3652 I18N::LangTags::List, I18N::Langinfo, IO, IO::Dir, IO::File, IO::Handle,
3653 IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET,
3654 IO::Socket::UNIX, IPC::Open2, IPC::Open3, IPC::SysV, IPC::SysV::Msg,
3655 IPC::SysV::Semaphore, List::Util, Locale::Constants, Locale::Country,
3656 Locale::Currency, Locale::Language, Locale::Maketext,
3657 Locale::Maketext::TPJ13, Locale::Script, MIME::Base64,
3658 MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt,
3659 Math::BigInt::Calc, Math::BigInt::CalcEmu, Math::BigRat, Math::Complex,
3660 Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire,
3661 Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File,
3662 Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT, Net::Cmd,
3663 Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3,
3664 Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent,
3665 Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO,
3666 PerlIO::encoding, PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint,
3667 Pod::Checker, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects,
3668 Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser,
3669 Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff,
3670 Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText,
3671 Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer,
3672 Pod::Select, Pod::Text, Pod::Text::Color, Pod::Text::Overstrike,
3673 Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Scalar::Util,
3674 Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch,
3675 Symbol, Sys::Hostname, Sys::Syslog, Term::ANSIColor, Term::Cap,
3676 Term::Complete, Term::ReadLine, Test, Test::Builder, Test::Harness,
3677 Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Straps,
3678 Test::More, Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced,
3679 Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Thread,
3680 Thread::Queue, Thread::Semaphore, Thread::Signal, Thread::Specific,
3681 Tie::Array, Tie::File, Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash,
3682 Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::gmtime,
3683 Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate, Unicode::Normalize,
3684 Unicode::UCD, User::grent, User::pwent, Win32, XS::APItest, XS::Typemap,
3685 XSLoader
3686
3687 =item Extension Modules
3688
3689 =back
3690
3691 =item CPAN
3692
3693 =over 4
3694
3695 =item Africa
3696
3697 South Africa
3698
3699 =item Asia
3700
3701 China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi
3702 Arabia, Singapore, South Korea, Taiwan, Thailand
3703
3704 =item Central America
3705
3706 Costa Rica
3707
3708 =item Europe
3709
3710 Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Czech
3711 Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary,
3712 Iceland, Ireland, Italy, Latvia, Lithuania, Netherlands, Norway, Poland,
3713 Portugal, Romania, Russia, Slovakia, Slovenia, Spain, Sweden, Switzerland,
3714 Turkey, Ukraine, United Kingdom
3715
3716 =item North America
3717
3718 Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States,
3719 Alabama, California, Colorado, Delaware, District of Columbia, Florida,
3720 Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey, New York,
3721 North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, Utah,
3722 Virginia, Washington, Wisconsin
3723
3724 =item Oceania
3725
3726 Australia, New Zealand, United States
3727
3728 =item South America
3729
3730 Argentina, Brazil, Chile
3731
3732 =item RSYNC Mirrors
3733
3734 =back
3735
3736 =item Modules: Creation, Use, and Abuse
3737
3738 =over 4
3739
3740 =item Guidelines for Module Creation
3741
3742 =item Guidelines for Converting Perl 4 Library Scripts into Modules
3743
3744 =item Guidelines for Reusing Application Code
3745
3746 =back
3747
3748 =item NOTE
3749
3750 =back
3751
3752 =head2 perlmodstyle - Perl module style guide
3753
3754 =over 4
3755
3756 =item INTRODUCTION
3757
3758 =item QUICK CHECKLIST
3759
3760 =over 4
3761
3762 =item Before you start
3763
3764 =item The API
3765
3766 =item Stability
3767
3768 =item Documentation
3769
3770 =item Release considerations
3771
3772 =back
3773
3774 =item BEFORE YOU START WRITING A MODULE
3775
3776 =over 4
3777
3778 =item Has it been done before?
3779
3780 =item Do one thing and do it well
3781
3782 =item What's in a name?
3783
3784 =back
3785
3786 =item DESIGNING AND WRITING YOUR MODULE
3787
3788 =over 4
3789
3790 =item To OO or not to OO?
3791
3792 =item Designing your API
3793
3794 Write simple routines to do simple things, Separate functionality from
3795 output, Provide sensible shortcuts and defaults, Naming conventions,
3796 Parameter passing
3797
3798 =item Strictness and warnings
3799
3800 =item Backwards compatibility
3801
3802 =item Error handling and messages
3803
3804 =back
3805
3806 =item DOCUMENTING YOUR MODULE
3807
3808 =over 4
3809
3810 =item POD
3811
3812 =item README, INSTALL, release notes, changelogs
3813
3814 perl Makefile.PL, make, make test, make install, perl Build.PL, perl Build,
3815 perl Build test, perl Build install
3816
3817 =back
3818
3819 =item RELEASE CONSIDERATIONS
3820
3821 =over 4
3822
3823 =item Version numbering
3824
3825 =item Pre-requisites
3826
3827 =item Testing
3828
3829 =item Packaging
3830
3831 =item Licensing
3832
3833 =back
3834
3835 =item COMMON PITFALLS
3836
3837 =over 4
3838
3839 =item Reinventing the wheel
3840
3841 =item Trying to do too much
3842
3843 =item Inappropriate documentation
3844
3845 =back
3846
3847 =item SEE ALSO
3848
3849 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Packaging Tools,
3850 Testing tools, http://pause.perl.org/, Any good book on software
3851 engineering
3852
3853 =item AUTHOR
3854
3855 =back
3856
3857 =head2 perlmodinstall - Installing CPAN Modules
3858
3859 =over 4
3860
3861 =item DESCRIPTION
3862
3863 =over 4
3864
3865 =item PREAMBLE
3866
3867 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
3868 module (sometimes unnecessary), B<INSTALL> the module
3869
3870 =back
3871
3872 =item PORTABILITY
3873
3874 =item HEY
3875
3876 =item AUTHOR
3877
3878 =item COPYRIGHT
3879
3880 =back
3881
3882 =head2 perlnewmod - preparing a new module for distribution
3883
3884 =over 4
3885
3886 =item DESCRIPTION
3887
3888 =over 4
3889
3890 =item Warning
3891
3892 =item What should I make into a module?
3893
3894 =item Step-by-step: Preparing the ground
3895
3896 Look around, Check it's new, Discuss the need, Choose a name, Check again
3897
3898 =item Step-by-step: Making the module
3899
3900 Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
3901 L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
3902 documentation|perlpod>, Write tests, Write the README
3903
3904 =item Step-by-step: Distributing your module
3905
3906 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
3907 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
3908
3909 =back
3910
3911 =item AUTHOR
3912
3913 =item SEE ALSO
3914
3915 =back
3916
3917 =head2 perlutil - utilities packaged with the Perl distribution
3918
3919 =over 4
3920
3921 =item DESCRIPTION
3922
3923 =over 4
3924
3925 =item DOCUMENTATION
3926
3927 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
3928 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
3929 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
3930 L<roffitall|roffitall>
3931
3932 =item CONVERTORS
3933
3934 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
3935
3936 =item Administration
3937
3938 L<libnetcfg|libnetcfg>
3939
3940 =item Development
3941
3942 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
3943 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
3944
3945 =item SEE ALSO
3946
3947 =back
3948
3949 =back
3950
3951 =head2 perlcompile - Introduction to the Perl Compiler-Translator 
3952
3953 =over 4
3954
3955 =item DESCRIPTION
3956
3957 =over 4
3958
3959 =item Layout
3960
3961 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3962
3963 =back
3964
3965 =item Using The Back Ends
3966
3967 =over 4
3968
3969 =item The Cross Referencing Back End
3970
3971 i, &, s, r
3972
3973 =item The Decompiling Back End
3974
3975 =item The Lint Back End
3976
3977 =item The Simple C Back End
3978
3979 =item The Bytecode Back End
3980
3981 =item The Optimized C Back End
3982
3983 =back
3984
3985 =item Module List for the Compiler Suite
3986
3987 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3988 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
3989 B::Stackobj, B::Stash, B::Terse, B::Xref
3990
3991 =item KNOWN PROBLEMS
3992
3993 =item AUTHOR
3994
3995 =back
3996
3997 =head2 perlfilter - Source Filters
3998
3999 =over 4
4000
4001 =item DESCRIPTION
4002
4003 =item CONCEPTS
4004
4005 =item USING FILTERS
4006
4007 =item WRITING A SOURCE FILTER
4008
4009 =item WRITING A SOURCE FILTER IN C
4010
4011 B<Decryption Filters>
4012
4013 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4014
4015 =item WRITING A SOURCE FILTER IN PERL
4016
4017 =item USING CONTEXT: THE DEBUG FILTER
4018
4019 =item CONCLUSION
4020
4021 =item THINGS TO LOOK OUT FOR
4022
4023 Some Filters Clobber the C<DATA> Handle
4024
4025 =item REQUIREMENTS
4026
4027 =item AUTHOR
4028
4029 =item Copyrights
4030
4031 =back
4032
4033 =head2 perlembed - how to embed perl in your C program
4034
4035 =over 4
4036
4037 =item DESCRIPTION
4038
4039 =over 4
4040
4041 =item PREAMBLE
4042
4043 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
4044 Perl?>, B<Use C from C?>, B<Use Perl from C?>
4045
4046 =item ROADMAP
4047
4048 =item Compiling your C program
4049
4050 =item Adding a Perl interpreter to your C program
4051
4052 =item Calling a Perl subroutine from your C program
4053
4054 =item Evaluating a Perl statement from your C program
4055
4056 =item Performing Perl pattern matches and substitutions from your C program
4057
4058 =item Fiddling with the Perl stack from your C program
4059
4060 =item Maintaining a persistent interpreter
4061
4062 =item Execution of END blocks
4063
4064 =item Maintaining multiple interpreter instances
4065
4066 =item Using Perl modules, which themselves use C libraries, from your C
4067 program
4068
4069 =back
4070
4071 =item Embedding Perl under Win32
4072
4073 =item Hiding Perl_
4074
4075 =item MORAL
4076
4077 =item AUTHOR
4078
4079 =item COPYRIGHT
4080
4081 =back
4082
4083 =head2 perldebguts - Guts of Perl debugging 
4084
4085 =over 4
4086
4087 =item DESCRIPTION
4088
4089 =item Debugger Internals
4090
4091 =over 4
4092
4093 =item Writing Your Own Debugger
4094
4095 =back
4096
4097 =item Frame Listing Output Examples
4098
4099 =item Debugging regular expressions
4100
4101 =over 4
4102
4103 =item Compile-time output
4104
4105 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
4106 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
4107 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
4108 C<anchored(TYPE)>
4109
4110 =item Types of nodes
4111
4112 =item Run-time output
4113
4114 =back
4115
4116 =item Debugging Perl memory usage
4117
4118 =over 4
4119
4120 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
4121
4122 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
4123 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
4124 6144>
4125
4126 =item Example of using B<-DL> switch
4127
4128 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
4129
4130 =item B<-DL> details
4131
4132 C<!!!>, C<!!>, C<!>
4133
4134 =item Limitations of B<-DL> statistics
4135
4136 =back
4137
4138 =item SEE ALSO
4139
4140 =back
4141
4142 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
4143
4144 =over 4
4145
4146 =item DESCRIPTION
4147
4148 =item SPECIAL NOTES
4149
4150 =over 4
4151
4152 =item make
4153
4154 =item Version caveat
4155
4156 =item Dynamic Loading versus Static Loading
4157
4158 =back
4159
4160 =item TUTORIAL
4161
4162 =over 4
4163
4164 =item EXAMPLE 1
4165
4166 =item EXAMPLE 2
4167
4168 =item What has gone on?
4169
4170 =item Writing good test scripts
4171
4172 =item EXAMPLE 3
4173
4174 =item What's new here?
4175
4176 =item Input and Output Parameters
4177
4178 =item The XSUBPP Program
4179
4180 =item The TYPEMAP file
4181
4182 =item Warning about Output Arguments
4183
4184 =item EXAMPLE 4
4185
4186 =item What has happened here?
4187
4188 =item Anatomy of .xs file
4189
4190 =item Getting the fat out of XSUBs
4191
4192 =item More about XSUB arguments
4193
4194 =item The Argument Stack
4195
4196 =item Extending your Extension
4197
4198 =item Documenting your Extension
4199
4200 =item Installing your Extension
4201
4202 =item EXAMPLE 5
4203
4204 =item New Things in this Example
4205
4206 =item EXAMPLE 6
4207
4208 =item New Things in this Example
4209
4210 =item EXAMPLE 7 (Coming Soon)
4211
4212 =item EXAMPLE 8 (Coming Soon)
4213
4214 =item EXAMPLE 9 Passing open files to XSes
4215
4216 =item Troubleshooting these Examples
4217
4218 =back
4219
4220 =item See also
4221
4222 =item Author
4223
4224 =over 4
4225
4226 =item Last Changed
4227
4228 =back
4229
4230 =back
4231
4232 =head2 perlxs - XS language reference manual
4233
4234 =over 4
4235
4236 =item DESCRIPTION
4237
4238 =over 4
4239
4240 =item Introduction
4241
4242 =item On The Road
4243
4244 =item The Anatomy of an XSUB
4245
4246 =item The Argument Stack
4247
4248 =item The RETVAL Variable
4249
4250 =item Returning SVs, AVs and HVs through RETVAL
4251
4252 =item The MODULE Keyword
4253
4254 =item The PACKAGE Keyword
4255
4256 =item The PREFIX Keyword
4257
4258 =item The OUTPUT: Keyword
4259
4260 =item The NO_OUTPUT Keyword
4261
4262 =item The CODE: Keyword
4263
4264 =item The INIT: Keyword
4265
4266 =item The NO_INIT Keyword
4267
4268 =item Initializing Function Parameters
4269
4270 =item Default Parameter Values
4271
4272 =item The PREINIT: Keyword
4273
4274 =item The SCOPE: Keyword
4275
4276 =item The INPUT: Keyword
4277
4278 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
4279
4280 =item The C<length(NAME)> Keyword
4281
4282 =item Variable-length Parameter Lists
4283
4284 =item The C_ARGS: Keyword
4285
4286 =item The PPCODE: Keyword
4287
4288 =item Returning Undef And Empty Lists
4289
4290 =item The REQUIRE: Keyword
4291
4292 =item The CLEANUP: Keyword
4293
4294 =item The POSTCALL: Keyword
4295
4296 =item The BOOT: Keyword
4297
4298 =item The VERSIONCHECK: Keyword
4299
4300 =item The PROTOTYPES: Keyword
4301
4302 =item The PROTOTYPE: Keyword
4303
4304 =item The ALIAS: Keyword
4305
4306 =item The OVERLOAD: Keyword
4307
4308 =item The FALLBACK: Keyword
4309
4310 =item The INTERFACE: Keyword
4311
4312 =item The INTERFACE_MACRO: Keyword
4313
4314 =item The INCLUDE: Keyword
4315
4316 =item The CASE: Keyword
4317
4318 =item The & Unary Operator
4319
4320 =item Inserting POD, Comments and C Preprocessor Directives
4321
4322 =item Using XS With C++
4323
4324 =item Interface Strategy
4325
4326 =item Perl Objects And C Structures
4327
4328 =item The Typemap
4329
4330 =item Safely Storing Static Data in XS
4331
4332 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4333
4334 =back
4335
4336 =item EXAMPLES
4337
4338 =item XS VERSION
4339
4340 =item AUTHOR
4341
4342 =back
4343
4344 =head2 perlclib - Internal replacements for standard C library functions
4345
4346 =over 4
4347
4348 =item DESCRIPTION
4349
4350 =over 4
4351
4352 =item Conventions
4353
4354 C<t>, C<p>, C<n>, C<s>
4355
4356 =item File Operations
4357
4358 =item File Input and Output
4359
4360 =item File Positioning
4361
4362 =item Memory Management and String Handling
4363
4364 =item Character Class Tests
4365
4366 =item F<stdlib.h> functions
4367
4368 =item Miscellaneous functions
4369
4370 =back
4371
4372 =item SEE ALSO
4373
4374 =back
4375
4376 =head2 perlguts - Introduction to the Perl API
4377
4378 =over 4
4379
4380 =item DESCRIPTION
4381
4382 =item Variables
4383
4384 =over 4
4385
4386 =item Datatypes
4387
4388 =item What is an "IV"?
4389
4390 =item Working with SVs
4391
4392 =item Offsets
4393
4394 =item What's Really Stored in an SV?
4395
4396 =item Working with AVs
4397
4398 =item Working with HVs
4399
4400 =item Hash API Extensions
4401
4402 =item AVs, HVs and undefined values
4403
4404 =item References
4405
4406 =item Blessed References and Class Objects
4407
4408 =item Creating New Variables
4409
4410 GV_ADDMULTI, GV_ADDWARN
4411
4412 =item Reference Counts and Mortality
4413
4414 =item Stashes and Globs
4415
4416 =item Double-Typed SVs
4417
4418 =item Magic Variables
4419
4420 =item Assigning Magic
4421
4422 =item Magic Virtual Tables
4423
4424 =item Finding Magic
4425
4426 =item Understanding the Magic of Tied Hashes and Arrays
4427
4428 =item Localizing changes
4429
4430 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
4431 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
4432 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
4433 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
4434 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
4435 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
4436 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
4437 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
4438 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
4439 save_hptr(HV **hptr)>
4440
4441 =back
4442
4443 =item Subroutines
4444
4445 =over 4
4446
4447 =item XSUBs and the Argument Stack
4448
4449 =item Calling Perl Routines from within C Programs
4450
4451 =item Memory Allocation
4452
4453 =item PerlIO
4454
4455 =item Putting a C value on Perl stack
4456
4457 =item Scratchpads
4458
4459 =item Scratchpads and recursion
4460
4461 =back
4462
4463 =item Compiled code
4464
4465 =over 4
4466
4467 =item Code tree
4468
4469 =item Examining the tree
4470
4471 =item Compile pass 1: check routines
4472
4473 =item Compile pass 1a: constant folding
4474
4475 =item Compile pass 2: context propagation
4476
4477 =item Compile pass 3: peephole optimization
4478
4479 =item Pluggable runops
4480
4481 =back
4482
4483 =item Examining internal data structures with the C<dump> functions
4484
4485 =item How multiple interpreters and concurrency are supported
4486
4487 =over 4
4488
4489 =item Background and PERL_IMPLICIT_CONTEXT
4490
4491 =item So what happened to dTHR?
4492
4493 =item How do I use all this in extensions?
4494
4495 =item Should I do anything special if I call perl from multiple threads?
4496
4497 =item Future Plans and PERL_IMPLICIT_SYS
4498
4499 =back
4500
4501 =item Internal Functions
4502
4503 A, p, d, s, n, r, f, M, o, x, m, X, E, b
4504
4505 =over 4
4506
4507 =item Formatted Printing of IVs, UVs, and NVs
4508
4509 =item Pointer-To-Integer and Integer-To-Pointer
4510
4511 =item Source Documentation
4512
4513 =back
4514
4515 =item Unicode Support
4516
4517 =over 4
4518
4519 =item What B<is> Unicode, anyway?
4520
4521 =item How can I recognise a UTF-8 string?
4522
4523 =item How does UTF-8 represent Unicode characters?
4524
4525 =item How does Perl store UTF-8 strings?
4526
4527 =item How do I convert a string to UTF-8?
4528
4529 =item Is there anything else I need to know?
4530
4531 =back
4532
4533 =item Custom Operators
4534
4535 =item AUTHORS
4536
4537 =item SEE ALSO
4538
4539 =back
4540
4541 =head2 perlcall - Perl calling conventions from C
4542
4543 =over 4
4544
4545 =item DESCRIPTION
4546
4547 An Error Handler, An Event Driven Program
4548
4549 =item THE CALL_ FUNCTIONS
4550
4551 call_sv, call_pv, call_method, call_argv
4552
4553 =item FLAG VALUES
4554
4555 =over 4
4556
4557 =item  G_VOID
4558
4559 =item  G_SCALAR
4560
4561 =item G_ARRAY
4562
4563 =item G_DISCARD
4564
4565 =item G_NOARGS
4566
4567 =item G_EVAL
4568
4569 =item G_KEEPERR
4570
4571 =item Determining the Context
4572
4573 =back
4574
4575 =item KNOWN PROBLEMS
4576
4577 =item EXAMPLES
4578
4579 =over 4
4580
4581 =item No Parameters, Nothing returned
4582
4583 =item Passing Parameters
4584
4585 =item Returning a Scalar
4586
4587 =item Returning a list of values
4588
4589 =item Returning a list in a scalar context
4590
4591 =item Returning Data from Perl via the parameter list
4592
4593 =item Using G_EVAL
4594
4595 =item Using G_KEEPERR
4596
4597 =item Using call_sv
4598
4599 =item Using call_argv
4600
4601 =item Using call_method
4602
4603 =item Using GIMME_V
4604
4605 =item Using Perl to dispose of temporaries
4606
4607 =item Strategies for storing Callback Context Information
4608
4609 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
4610 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
4611 callback
4612
4613 =item Alternate Stack Manipulation
4614
4615 =item Creating and calling an anonymous subroutine in C
4616
4617 =back
4618
4619 =item SEE ALSO
4620
4621 =item AUTHOR
4622
4623 =item DATE
4624
4625 =back
4626
4627 =head2 perlapi - autogenerated documentation for the perl public API
4628
4629 =over 4
4630
4631 =item DESCRIPTION
4632
4633 =item "Gimme" Values
4634
4635 GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
4636
4637 =item Array Manipulation Functions
4638
4639 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4640 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4641 get_av, newAV, sortsv
4642
4643 =item Callback Functions
4644
4645 call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
4646 FREETMPS, LEAVE, SAVETMPS
4647
4648 =item Character classes
4649
4650 isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
4651
4652 =item Cloning an interpreter
4653
4654 perl_clone
4655
4656 =item CV Manipulation Functions
4657
4658 CvSTASH, get_cv
4659
4660 =item Embedding Functions
4661
4662 cv_undef, load_module, nothreadhook, perl_alloc, perl_construct,
4663 perl_destruct, perl_free, perl_parse, perl_run, require_pv
4664
4665 =item Functions in file pp_pack.c
4666
4667 packlist, pack_cat, unpackstring, unpack_str
4668
4669 =item Global Variables
4670
4671 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
4672
4673 =item GV Functions
4674
4675 GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
4676 gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
4677
4678 =item Handy Values
4679
4680 Nullav, Nullch, Nullcv, Nullhv, Nullsv
4681
4682 =item Hash Manipulation Functions
4683
4684 get_hv, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force,
4685 HeSVKEY_set, HeVAL, HvNAME, hv_assert, hv_clear, hv_clear_placeholders,
4686 hv_delete, hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
4687 hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv,
4688 hv_iternext_flags, hv_iterval, hv_magic, hv_scalar, hv_store, hv_store_ent,
4689 hv_undef, newHV
4690
4691 =item Magical Functions
4692
4693 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
4694 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
4695 SvSetSV, SvSetSV_nosteal, SvSHARE, SvUNLOCK
4696
4697 =item Memory Management
4698
4699 Copy, CopyD, Move, MoveD, New, Newc, Newz, Poison, Renew, Renewc, Safefree,
4700 savepv, savepvn, savesharedpv, StructCopy, Zero, ZeroD
4701
4702 =item Miscellaneous Functions
4703
4704 fbm_compile, fbm_instr, form, getcwd_sv, new_version, scan_version, strEQ,
4705 strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_nolocking,
4706 sv_nosharing, sv_nounlocking, upg_version, vcmp, vnormal, vnumify,
4707 vstringify
4708
4709 =item Numeric functions
4710
4711 grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
4712 scan_hex, scan_oct
4713
4714 =item Optree Manipulation Functions
4715
4716 cv_const_sv, newCONSTSUB, newXS
4717
4718 =item Pad Data Structures
4719
4720 pad_sv
4721
4722 =item Stack Manipulation Macros
4723
4724 dMARK, dORIGMARK, dSP, EXTEND, MARK, mPUSHi, mPUSHn, mPUSHp, mPUSHu,
4725 mXPUSHi, mXPUSHn, mXPUSHp, mXPUSHu, ORIGMARK, POPi, POPl, POPn, POPp,
4726 POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHmortal, PUSHn, PUSHp, PUSHs,
4727 PUSHu, PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHmortal, XPUSHn, XPUSHp, XPUSHs,
4728 XPUSHu, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, XSRETURN_NV,
4729 XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_UV, XSRETURN_YES, XST_mIV, XST_mNO,
4730 XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
4731
4732 =item SV Flags
4733
4734 svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
4735
4736 =item SV Manipulation Functions
4737
4738 get_sv, looks_like_number, newRV_inc, newRV_noinc, NEWSV, newSV, newSViv,
4739 newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv,
4740 newSVuv, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV,
4741 SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIsCOW,
4742 SvIsCOW_shared_hash, SvIV, SvIVx, SvIVX, SvIV_nomg, SvLEN, SvNIOK, SvNIOKp,
4743 SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX,
4744 SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only,
4745 SvPOK_only_UTF8, SvPV, SvPVbyte, SvPVbytex, SvPVbytex_force,
4746 SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, SvPVutf8x, SvPVutf8x_force,
4747 SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX, SvPV_force, SvPV_force_nomg,
4748 SvPV_nolen, SvPV_nomg, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK,
4749 SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off,
4750 SvTAINTED_on, SvTRUE, SvTYPE, SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off,
4751 SvUTF8_on, SvUV, SvUVX, SvUVx, SvUV_nomg, SvVOK, sv_2bool, sv_2cv, sv_2io,
4752 sv_2iv_flags, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen, sv_2pvutf8,
4753 sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv_flags, sv_backoff,
4754 sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_flags,
4755 sv_catpvn_mg, sv_catpv_mg, sv_catsv, sv_catsv_flags, sv_catsv_mg, sv_chop,
4756 sv_clear, sv_cmp, sv_cmp_locale, sv_collxfrm, sv_copypv, sv_dec,
4757 sv_derived_from, sv_eq, sv_force_normal, sv_force_normal_flags, sv_free,
4758 sv_gets, sv_grow, sv_inc, sv_insert, sv_isa, sv_isobject, sv_iv, sv_len,
4759 sv_len_utf8, sv_magic, sv_magicext, sv_mortalcopy, sv_newmortal, sv_newref,
4760 sv_nv, sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, sv_pvbyten,
4761 sv_pvbyten_force, sv_pvn, sv_pvn_force, sv_pvn_force_flags, sv_pvutf8,
4762 sv_pvutf8n, sv_pvutf8n_force, sv_reftype, sv_replace, sv_report_used,
4763 sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg,
4764 sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn,
4765 sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv,
4766 sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg,
4767 sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref,
4768 sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg,
4769 sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade,
4770 sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn
4771
4772 =item Unicode Support
4773
4774 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
4775 is_utf8_string_loc, pv_uni_display, sv_cat_decode, sv_recode_to_utf8,
4776 sv_uni_display, to_utf8_case, to_utf8_fold, to_utf8_lower, to_utf8_title,
4777 to_utf8_upper, utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop,
4778 utf8_length, utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8,
4779 uvuni_to_utf8_flags
4780
4781 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
4782
4783 ax, CLASS, dAX, dITEMS, dUNDERBAR, dXSARGS, dXSI32, items, ix, newXSproto,
4784 RETVAL, ST, THIS, UNDERBAR, XS, XS_VERSION, XS_VERSION_BOOTCHECK
4785
4786 =item Warning and Dieing
4787
4788 croak, warn
4789
4790 =item AUTHORS
4791
4792 =item SEE ALSO
4793
4794 =back
4795
4796 =head2 perlintern - autogenerated documentation of purely B<internal>
4797                  Perl functions
4798
4799 =over 4
4800
4801 =item DESCRIPTION
4802
4803 =item CV reference counts and CvOUTSIDE
4804
4805 CvWEAKOUTSIDE
4806
4807 =item Functions in file pad.h
4808
4809 CX_CURPAD_SAVE, CX_CURPAD_SV, PAD_BASE_SV, PAD_CLONE_VARS,
4810 PAD_COMPNAME_FLAGS, PAD_COMPNAME_GEN, PAD_COMPNAME_OURSTASH,
4811 PAD_COMPNAME_PV, PAD_COMPNAME_TYPE, PAD_DUP, PAD_RESTORE_LOCAL,
4812 PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV, PAD_SET_CUR,
4813 PAD_SET_CUR_NOSAVE, PAD_SV, PAD_SVl, SAVECLEARSV, SAVECOMPPAD, SAVEPADSV
4814
4815 =item Functions in file pp_ctl.c
4816
4817 find_runcv
4818
4819 =item Global Variables
4820
4821 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
4822 PL_rs
4823
4824 =item GV Functions
4825
4826 is_gv_magical
4827
4828 =item IO Functions
4829
4830 start_glob
4831
4832 =item Pad Data Structures
4833
4834 CvPADLIST, cv_clone, cv_dump, do_dump_pad, intro_my, pad_add_anon,
4835 pad_add_name, pad_alloc, pad_block_start, pad_check_dup, pad_findlex,
4836 pad_findmy, pad_fixup_inner_anons, pad_free, pad_leavemy, pad_new,
4837 pad_push, pad_reset, pad_setsv, pad_swipe, pad_tidy, pad_undef
4838
4839 =item Stack Manipulation Macros
4840
4841 djSP, LVRET
4842
4843 =item SV Manipulation Functions
4844
4845 find_uninit_var, report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs,
4846 sv_free_arenas
4847
4848 =item AUTHORS
4849
4850 =item SEE ALSO
4851
4852 =back
4853
4854 =head2 perliol - C API for Perl's implementation of IO in Layers.
4855
4856 =over 4
4857
4858 =item SYNOPSIS
4859
4860 =item DESCRIPTION
4861
4862 =over 4
4863
4864 =item History and Background
4865
4866 =item Basic Structure
4867
4868 =item Layers vs Disciplines
4869
4870 =item Data Structures
4871
4872 =item Functions and Attributes
4873
4874 =item Per-instance Data
4875
4876 =item Layers in action.
4877
4878 =item Per-instance flag bits
4879
4880 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4881 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4882 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4883 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4884
4885 =item Methods in Detail
4886
4887 fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF,
4888 PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode,
4889 Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof,
4890 Error,  Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
4891 Set_ptrcnt
4892
4893 =item Utilities
4894
4895 =item Implementing PerlIO Layers
4896
4897 C implementations, Perl implementations
4898
4899 =item Core Layers
4900
4901 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4902
4903 =item Extension Layers
4904
4905 ":encoding", ":scalar", ":via"
4906
4907 =back
4908
4909 =item TODO
4910
4911 =back
4912
4913 =head2 perlapio - perl's IO abstraction interface.
4914
4915 =over 4
4916
4917 =item SYNOPSIS
4918
4919 =item DESCRIPTION
4920
4921 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4922 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4923 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4924 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4925 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4926 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4927 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4928 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4929 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4930 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4931 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4932
4933 =over 4
4934
4935 =item Co-existence with stdio
4936
4937 B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
4938 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
4939
4940 =item "Fast gets" Functions
4941
4942 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4943 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4944 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4945 B<PerlIO_get_bufsiz(f)>
4946
4947 =item Other Functions
4948
4949 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4950 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4951
4952 =back
4953
4954 =back
4955
4956 =head2 perlhack - How to hack at the Perl internals
4957
4958 =over 4
4959
4960 =item DESCRIPTION
4961
4962 Does concept match the general goals of Perl?, Where is the
4963 implementation?, Backwards compatibility, Could it be a module instead?, Is
4964 the feature generic enough?, Does it potentially introduce new bugs?, Does
4965 it preclude other desirable features?, Is the implementation robust?, Is
4966 the implementation generic enough to be portable?, Is the implementation
4967 tested?, Is there enough documentation?, Is there another way to do it?,
4968 Does it create too much work?, Patches speak louder than words
4969
4970 =over 4
4971
4972 =item Keeping in sync
4973
4974 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
4975 NFS, rsync'ing the patches
4976
4977 =item Why rsync the source tree
4978
4979 It's easier to rsync the source tree, It's more reliable
4980
4981 =item Why rsync the patches
4982
4983 It's easier to rsync the patches, It's a good reference, Finding a start
4984 point, Finding how to fix a bug, Finding the source of misbehaviour
4985
4986 =item Working with the source
4987
4988 =item Perlbug administration
4989
4990 =item Submitting patches
4991
4992 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
4993 F<Porting/pumpkin.pod>, The perl5-porters FAQ
4994
4995 =item Finding Your Way Around
4996
4997 Core modules, Tests, Documentation, Configure, Interpreter
4998
4999 =item Elements of the interpreter
5000
5001 Startup, Parsing, Optimization, Running
5002
5003 =item Internal Variable Types
5004
5005 =item Op Trees
5006
5007 =item Stacks
5008
5009 Argument stack, Mark stack, Save stack
5010
5011 =item Millions of Macros
5012
5013 =item The .i Targets
5014
5015 =item Poking at Perl
5016
5017 =item Using a source-level debugger
5018
5019 run [args], break function_name, break source.c:xxx, step, next, continue,
5020 finish, 'enter', print
5021
5022 =item gdb macro support
5023
5024 =item Dumping Perl Data Structures
5025
5026 =item Patching
5027
5028 =item Patching a core module
5029
5030 =item Adding a new function to the core
5031
5032 =item Writing a test
5033
5034 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5035 F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base t/comp,
5036 t/cmd t/run t/io t/op, t/lib ext lib
5037
5038 =item Special Make Test Targets
5039
5040 coretest, test.deparse, test.taintwarn, minitest, test.valgrind
5041 check.valgrind utest.valgrind ucheck.valgrind, test.third check.third
5042 utest.third ucheck.third, test.torture torturetest, utest ucheck test.utf8
5043 check.utf8, test_harness
5044
5045 =item Running tests by hand
5046
5047 PERL_CORE=1, PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST
5048
5049 =back
5050
5051 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5052
5053 =over 4
5054
5055 =item Rational Software's Purify
5056
5057 =item Purify on Unix
5058
5059 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5060
5061 =item Purify on NT
5062
5063 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5064
5065 =item valgrind
5066
5067 =item Compaq's/Digital's/HP's Third Degree
5068
5069 =item PERL_DESTRUCT_LEVEL
5070
5071 =item Profiling
5072
5073 =item Gprof Profiling
5074
5075 -a, -b, -e routine, -f routine, -s, -z
5076
5077 =item GCC gcov Profiling
5078
5079 =item Pixie Profiling
5080
5081 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5082 -z[ero]
5083
5084 =item Miscellaneous tricks
5085
5086 =item CONCLUSION
5087
5088 I<The Road goes ever on and on, down from the door where it began.>
5089
5090 =back
5091
5092 =item AUTHOR
5093
5094 =back
5095
5096 =head2 perlbook - Perl book information
5097
5098 =over 4
5099
5100 =item DESCRIPTION
5101
5102 =back
5103
5104 =head2 perltodo - Perl TO-DO List
5105
5106 =over 4
5107
5108 =item DESCRIPTION
5109
5110 =item assertions
5111
5112 =item iCOW
5113
5114 =item (?{...}) closures in regexps
5115
5116 =item A re-entrant regexp engine
5117
5118 =item pragmata
5119
5120 =over 4
5121
5122 =item lexical pragmas
5123
5124 =item use less 'memory'
5125
5126 =back
5127
5128 =item prototypes and functions
5129
5130 =over 4
5131
5132 =item _ prototype character
5133
5134 =item inlining autoloaded constants
5135
5136 =item Finish off lvalue functions
5137
5138 =back
5139
5140 =item Unicode and UTF8
5141
5142 =over 4
5143
5144 =item Implicit Latin 1 => Unicode translation
5145
5146 =item UTF8 caching code
5147
5148 =item Unicode in Filenames
5149
5150 =item Unicode in %ENV
5151
5152 =back
5153
5154 =item Regexps
5155
5156 =over 4
5157
5158 =item regexp optimiser optional
5159
5160 =item common suffices/prefices in regexps (trie optimization)
5161
5162 =back
5163
5164 =item POD
5165
5166 =over 4
5167
5168 =item POD -> HTML conversion still sucks
5169
5170 =back
5171
5172 =item Misc medium sized projects
5173
5174 =over 4
5175
5176 =item UNITCHECK
5177
5178 =item optional optimizer
5179
5180 =item You WANT *how* many
5181
5182 =item lexical aliases
5183
5184 =item no 6
5185
5186 =item IPv6
5187
5188 =item entersub XS vs Perl
5189
5190 =item @INC source filter to Filter::Simple
5191
5192 =item bincompat functions
5193
5194 =item Use fchown/fchmod internally
5195
5196 =back
5197
5198 =item Tests
5199
5200 =over 4
5201
5202 =item Make Schwern poorer
5203
5204 =item test B
5205
5206 =item Improve tests for Config.pm
5207
5208 =item common test code for timed bailout
5209
5210 =back
5211
5212 =item Installation
5213
5214 =over 4
5215
5216 =item compressed man pages
5217
5218 =item Make Config.pm cope with differences between build and installed perl
5219
5220 =item Relocatable perl
5221
5222 =item make HTML install work
5223
5224 =item put patchlevel in -v
5225
5226 =back
5227
5228 =item Incremental things
5229
5230 =over 4
5231
5232 =item autovivification
5233
5234 =item fix tainting bugs
5235
5236 =item Make tainting consistent
5237
5238 =item Dual life everything
5239
5240 =back
5241
5242 =item Vague things
5243
5244 =over 4
5245
5246 =item threads
5247
5248 =item POSIX memory footprint
5249
5250 =item Optimize away @_
5251
5252 =item switch ops
5253
5254 =item Attach/detach debugger from running program
5255
5256 =item A decent benchmark
5257
5258 =back
5259
5260 =back
5261
5262 =head2 perldoc - Look up Perl documentation in Pod format.
5263
5264 =over 4
5265
5266 =item SYNOPSIS
5267
5268 =item DESCRIPTION
5269
5270 =item OPTIONS
5271
5272 B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
5273 I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
5274 I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
5275 B<-w> I<option:value> or B<-w> I<option>, B<-X>,
5276 B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
5277 B<-V>
5278
5279 =item SECURITY
5280
5281 =item ENVIRONMENT
5282
5283 =item AUTHOR
5284
5285 =back
5286
5287 =head2 perlhist - the Perl history records
5288
5289 =over 4
5290
5291 =item DESCRIPTION
5292
5293 =item INTRODUCTION
5294
5295 =item THE KEEPERS OF THE PUMPKIN
5296
5297 =over 4
5298
5299 =item PUMPKIN?
5300
5301 =back
5302
5303 =item THE RECORDS
5304
5305 =over 4
5306
5307 =item SELECTED RELEASE SIZES
5308
5309 =item SELECTED PATCH SIZES
5310
5311 =back
5312
5313 =item THE KEEPERS OF THE RECORDS
5314
5315 =back
5316
5317 =head2 perldelta - what is new for perl v5.9.2
5318
5319 =over 4
5320
5321 =item DESCRIPTION
5322
5323 =item Incompatible Changes
5324
5325 =item Core Enhancements
5326
5327 =item Modules and Pragmata
5328
5329 =item Utility Changes
5330
5331 =item Documentation
5332
5333 =item Performance Enhancements
5334
5335 =item Installation and Configuration Improvements
5336
5337 =item Selected Bug Fixes
5338
5339 =item New or Changed Diagnostics
5340
5341 =item Changed Internals
5342
5343 =item Known Problems
5344
5345 =over 4
5346
5347 =item Platform Specific Problems
5348
5349 =back
5350
5351 =item Reporting Bugs
5352
5353 =item SEE ALSO
5354
5355 =back
5356
5357 =head2 perl592delta, perldelta - what is new for perl v5.9.2
5358
5359 =over 4
5360
5361 =item DESCRIPTION
5362
5363 =item Incompatible Changes
5364
5365 =item Core Enhancements
5366
5367 =item Modules and Pragmata
5368
5369 =item Utility Changes
5370
5371 =item Documentation
5372
5373 =item Performance Enhancements
5374
5375 =item Installation and Configuration Improvements
5376
5377 =item Selected Bug Fixes
5378
5379 =item New or Changed Diagnostics
5380
5381 =item Changed Internals
5382
5383 =item Known Problems
5384
5385 =over 4
5386
5387 =item Platform Specific Problems
5388
5389 =back
5390
5391 =item Reporting Bugs
5392
5393 =item SEE ALSO
5394
5395 =back
5396
5397 =head2 perl591delta, perldelta - what is new for perl v5.9.1
5398
5399 =over 4
5400
5401 =item DESCRIPTION
5402
5403 =item Incompatible Changes
5404
5405 =over 4
5406
5407 =item substr() lvalues are no longer fixed-length
5408
5409 =item The C<:unique> attribute is only meaningful for globals
5410
5411 =back
5412
5413 =item Core Enhancements
5414
5415 =over 4
5416
5417 =item Lexical C<$_>
5418
5419 =item Tied hashes in scalar context
5420
5421 =item Formats
5422
5423 =item Stacked filetest operators
5424
5425 =back
5426
5427 =item Modules and Pragmata
5428
5429 Benchmark, Carp, Exporter, FindBin, List::Util, threads::shared
5430
5431 =item Utility Changes
5432
5433 =item Documentation
5434
5435 =item Performance Enhancements
5436
5437 =item Selected Bug Fixes
5438
5439 =over 4
5440
5441 =item UTF-8 bugs
5442
5443 =item Threading bugs
5444
5445 =item More bugs
5446
5447 =back
5448
5449 =item New or Changed Diagnostics
5450
5451 =item Changed Internals
5452
5453 =over 4
5454
5455 =item Reordering of SVt_* constants
5456
5457 =item Removal of CPP symbols
5458
5459 =item Less space is used by ops
5460
5461 =item New parser
5462
5463 =back
5464
5465 =item Configuration and Building
5466
5467 =item Known Problems
5468
5469 =over 4
5470
5471 =item Platform Specific Problems
5472
5473 =back
5474
5475 =item To-do for perl 5.10.0
5476
5477 =item Reporting Bugs
5478
5479 =item SEE ALSO
5480
5481 =back
5482
5483 =head2 perl590delta, perldelta - what is new for perl v5.9.0
5484
5485 =over 4
5486
5487 =item DESCRIPTION
5488
5489 =item Incompatible Changes
5490
5491 =over 4
5492
5493 =item Hash Randomisation
5494
5495 =item UTF-8 On Filehandles No Longer Activated By Locale
5496
5497 =item Single-number v-strings are no longer v-strings before "=>"
5498
5499 =item (Win32) The -C Switch Has Been Repurposed
5500
5501 =item (Win32) The /d Switch Of cmd.exe
5502
5503 =item The C<$*> variable has been removed
5504
5505 =back
5506
5507 =item Core Enhancements
5508
5509 =over 4
5510
5511 =item Assertions
5512
5513 =item Defined-or operators
5514
5515 =item UTF-8 no longer default under UTF-8 locales
5516
5517 =item Unsafe signals again available
5518
5519 =item Tied Arrays with Negative Array Indices
5520
5521 =item local ${$x}
5522
5523 =item Unicode Character Database 4.0.0
5524
5525 =item Miscellaneous Enhancements
5526
5527 =back
5528
5529 =item Modules and Pragmata
5530
5531 =over 4
5532
5533 =item Updated Modules And Pragmata
5534
5535 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
5536 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
5537 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
5538 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
5539 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
5540 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
5541 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
5542 Win32::GetOSVersion
5543
5544 =back
5545
5546 =item Utility Changes
5547
5548 =item New Documentation
5549
5550 =item Performance Enhancements
5551
5552 =item Installation and Configuration Improvements
5553
5554 =over 4
5555
5556 =item Platform-specific enhancements
5557
5558 =back
5559
5560 =item Selected Bug Fixes
5561
5562 =over 4
5563
5564 =item Closures, eval and lexicals
5565
5566 =item Generic fixes
5567
5568 =item Platform-specific fixes
5569
5570 =back
5571
5572 =item New or Changed Diagnostics
5573
5574 =over 4
5575
5576 =item Changed "A thread exited while %d threads were running"
5577
5578 =item Removed "Attempt to clear a restricted hash"
5579
5580 =item New "Illegal declaration of anonymous subroutine"
5581
5582 =item Changed "Invalid range "%s" in transliteration operator"
5583
5584 =item New "Missing control char name in \c"
5585
5586 =item New "Newline in left-justified string for %s"
5587
5588 =item New "Possible precedence problem on bitwise %c operator"
5589
5590 =item New "read() on %s filehandle %s"
5591
5592 =item New "Tied variable freed while still in use"
5593
5594 =item New "To%s: illegal mapping '%s'"
5595
5596 =item New "Use of freed value in iteration"
5597
5598 =back
5599
5600 =item Changed Internals
5601
5602 =item New Tests
5603
5604 =item Known Problems
5605
5606 =over 4
5607
5608 =item Tied hashes in scalar context
5609
5610 =item Net::Ping 450_service and 510_ping_udp failures
5611
5612 =item B::C
5613
5614 =back
5615
5616 =item Platform Specific Problems
5617
5618 =over 4
5619
5620 =item EBCDIC Platforms
5621
5622 =item Cygwin 1.5 problems
5623
5624 =item HP-UX: HP cc warnings about sendfile and sendpath
5625
5626 =item IRIX: t/uni/tr_7jis.t falsely failing
5627
5628 =item Mac OS X: no usemymalloc
5629
5630 =item Tru64: No threaded builds with GNU cc (gcc)
5631
5632 =item Win32: sysopen, sysread, syswrite
5633
5634 =back
5635
5636 =item TODO
5637
5638 =item Reporting Bugs
5639
5640 =item SEE ALSO
5641
5642 =back
5643
5644 =head2 perl585delta - what is new for perl v5.8.5
5645
5646 =over 4
5647
5648 =item DESCRIPTION
5649
5650 =item Incompatible Changes
5651
5652 =item Core Enhancements
5653
5654 =item Modules and Pragmata
5655
5656 =item Utility Changes
5657
5658 =over 4
5659
5660 =item Perl's debugger
5661
5662 =item h2ph
5663
5664 =back
5665
5666 =item Installation and Configuration Improvements
5667
5668 =item Selected Bug Fixes
5669
5670 =item New or Changed Diagnostics
5671
5672 =item Changed Internals
5673
5674 =item Known Problems
5675
5676 =item Platform Specific Problems
5677
5678 =item Reporting Bugs
5679
5680 =item SEE ALSO
5681
5682 =back
5683
5684 =head2 perl584delta - what is new for perl v5.8.4
5685
5686 =over 4
5687
5688 =item DESCRIPTION
5689
5690 =item Incompatible Changes
5691
5692 =item Core Enhancements
5693
5694 =over 4
5695
5696 =item Malloc wrapping
5697
5698 =item Unicode Character Database 4.0.1
5699
5700 =item suidperl less insecure
5701
5702 =item format
5703
5704 =back
5705
5706 =item Modules and Pragmata
5707
5708 =over 4
5709
5710 =item Updated modules
5711
5712 Attribute::Handlers, B, Benchmark, CGI, Carp, Cwd, Exporter, File::Find,
5713 IO, IPC::Open3, Local::Maketext, Math::BigFloat, Math::BigInt,
5714 Math::BigRat, MIME::Base64, ODBM_File, POSIX, Shell, Socket, Storable,
5715 Switch, Sys::Syslog, Term::ANSIColor, Time::HiRes, Unicode::UCD, Win32,
5716 base, open, threads, utf8
5717
5718 =back
5719
5720 =item Performance Enhancements
5721
5722 =item Utility Changes
5723
5724 =item Installation and Configuration Improvements
5725
5726 =item Selected Bug Fixes
5727
5728 =item New or Changed Diagnostics
5729
5730 =item Changed Internals
5731
5732 =item Future Directions
5733
5734 =item Platform Specific Problems
5735
5736 =item Reporting Bugs
5737
5738 =item SEE ALSO
5739
5740 =back
5741
5742 =head2 perl583delta - what is new for perl v5.8.3
5743
5744 =over 4
5745
5746 =item DESCRIPTION
5747
5748 =item Incompatible Changes
5749
5750 =item Core Enhancements
5751
5752 =item Modules and Pragmata
5753
5754 CGI, Cwd, Digest, Digest::MD5, Encode, File::Spec, FindBin, List::Util,
5755 Math::BigInt, PodParser, Pod::Perldoc, POSIX, Unicode::Collate,
5756 Unicode::Normalize, Test::Harness, threads::shared
5757
5758 =item Utility Changes
5759
5760 =item New Documentation
5761
5762 =item Installation and Configuration Improvements
5763
5764 =item Selected Bug Fixes
5765
5766 =item New or Changed Diagnostics
5767
5768 =item Changed Internals
5769
5770 =item Configuration and Building
5771
5772 =item Platform Specific Problems
5773
5774 =item Known Problems
5775
5776 =item Future Directions
5777
5778 =item Obituary
5779
5780 =item Reporting Bugs
5781
5782 =item SEE ALSO
5783
5784 =back
5785
5786 =head2 perl582delta - what is new for perl v5.8.2
5787
5788 =over 4
5789
5790 =item DESCRIPTION
5791
5792 =item Incompatible Changes
5793
5794 =item Core Enhancements
5795
5796 =over 4
5797
5798 =item Hash Randomisation
5799
5800 =item Threading
5801
5802 =back
5803
5804 =item Modules and Pragmata
5805
5806 =over 4
5807
5808 =item Updated Modules And Pragmata
5809
5810 Devel::PPPort, Digest::MD5, I18N::LangTags, libnet, MIME::Base64,
5811 Pod::Perldoc, strict, Tie::Hash, Time::HiRes, Unicode::Collate,
5812 Unicode::Normalize, UNIVERSAL
5813
5814 =back
5815
5816 =item Selected Bug Fixes
5817
5818 =item Changed Internals
5819
5820 =item Platform Specific Problems
5821
5822 =item Future Directions
5823
5824 =item Reporting Bugs
5825
5826 =item SEE ALSO
5827
5828 =back
5829
5830 =head2 perl581delta - what is new for perl v5.8.1
5831
5832 =over 4
5833
5834 =item DESCRIPTION
5835
5836 =item Incompatible Changes
5837
5838 =over 4
5839
5840 =item Hash Randomisation
5841
5842 =item UTF-8 On Filehandles No Longer Activated By Locale
5843
5844 =item Single-number v-strings are no longer v-strings before "=>"
5845
5846 =item (Win32) The -C Switch Has Been Repurposed
5847
5848 =item (Win32) The /d Switch Of cmd.exe
5849
5850 =back
5851
5852 =item Core Enhancements
5853
5854 =over 4
5855
5856 =item UTF-8 no longer default under UTF-8 locales
5857
5858 =item Unsafe signals again available
5859
5860 =item Tied Arrays with Negative Array Indices
5861
5862 =item local ${$x}
5863
5864 =item Unicode Character Database 4.0.0
5865
5866 =item Deprecation Warnings
5867
5868 =item Miscellaneous Enhancements
5869
5870 =back
5871
5872 =item Modules and Pragmata
5873
5874 =over 4
5875
5876 =item Updated Modules And Pragmata
5877
5878 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
5879 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
5880 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
5881 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
5882 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
5883 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
5884 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
5885 Win32::GetOSVersion
5886
5887 =back
5888
5889 =item Utility Changes
5890
5891 =item New Documentation
5892
5893 =item Installation and Configuration Improvements
5894
5895 =over 4
5896
5897 =item Platform-specific enhancements
5898
5899 =back
5900
5901 =item Selected Bug Fixes
5902
5903 =over 4
5904
5905 =item Closures, eval and lexicals
5906
5907 =item Generic fixes
5908
5909 =item Platform-specific fixes
5910
5911 =back
5912
5913 =item New or Changed Diagnostics
5914
5915 =over 4
5916
5917 =item Changed "A thread exited while %d threads were running"
5918
5919 =item Removed "Attempt to clear a restricted hash"
5920
5921 =item New "Illegal declaration of anonymous subroutine"
5922
5923 =item Changed "Invalid range "%s" in transliteration operator"
5924
5925 =item New "Missing control char name in \c"
5926
5927 =item New "Newline in left-justified string for %s"
5928
5929 =item New "Possible precedence problem on bitwise %c operator"
5930
5931 =item New "Pseudo-hashes are deprecated"
5932
5933 =item New "read() on %s filehandle %s"
5934
5935 =item New "5.005 threads are deprecated"
5936
5937 =item New "Tied variable freed while still in use"
5938
5939 =item New "To%s: illegal mapping '%s'"
5940
5941 =item New "Use of freed value in iteration"
5942
5943 =back
5944
5945 =item Changed Internals
5946
5947 =item New Tests
5948
5949 =item Known Problems
5950
5951 =over 4
5952
5953 =item Tied hashes in scalar context
5954
5955 =item Net::Ping 450_service and 510_ping_udp failures
5956
5957 =item B::C
5958
5959 =back
5960
5961 =item Platform Specific Problems
5962
5963 =over 4
5964
5965 =item EBCDIC Platforms
5966
5967 =item Cygwin 1.5 problems
5968
5969 =item HP-UX: HP cc warnings about sendfile and sendpath
5970
5971 =item IRIX: t/uni/tr_7jis.t falsely failing
5972
5973 =item Mac OS X: no usemymalloc
5974
5975 =item Tru64: No threaded builds with GNU cc (gcc)
5976
5977 =item Win32: sysopen, sysread, syswrite
5978
5979 =back
5980
5981 =item Future Directions
5982
5983 =item Reporting Bugs
5984
5985 =item SEE ALSO
5986
5987 =back
5988
5989 =head2 perl58delta - what is new for perl v5.8.0
5990
5991 =over 4
5992
5993 =item DESCRIPTION
5994
5995 =item Highlights In 5.8.0
5996
5997 =item Incompatible Changes
5998
5999 =over 4
6000
6001 =item Binary Incompatibility
6002
6003 =item 64-bit platforms and malloc
6004
6005 =item AIX Dynaloading
6006
6007 =item Attributes for C<my> variables now handled at run-time
6008
6009 =item Socket Extension Dynamic in VMS
6010
6011 =item IEEE-format Floating Point Default on OpenVMS Alpha
6012
6013 =item New Unicode Semantics (no more C<use utf8>, almost)
6014
6015 =item New Unicode Properties
6016
6017 =item REF(...) Instead Of SCALAR(...)
6018
6019 =item pack/unpack D/F recycled
6020
6021 =item glob() now returns filenames in alphabetical order
6022
6023 =item Deprecations
6024
6025 =back
6026
6027 =item Core Enhancements
6028
6029 =over 4
6030
6031 =item Unicode Overhaul
6032
6033 =item PerlIO is Now The Default
6034
6035 =item ithreads
6036
6037 =item Restricted Hashes
6038
6039 =item Safe Signals
6040
6041 =item Understanding of Numbers
6042
6043 =item Arrays now always interpolate into double-quoted strings [561]
6044
6045 =item Miscellaneous Changes
6046
6047 =back
6048
6049 =item Modules and Pragmata
6050
6051 =over 4
6052
6053 =item New Modules and Pragmata
6054
6055 =item Updated And Improved Modules and Pragmata
6056
6057 =back
6058
6059 =item Utility Changes
6060
6061 =item New Documentation
6062
6063 =item Performance Enhancements
6064
6065 =item Installation and Configuration Improvements
6066
6067 =over 4
6068
6069 =item Generic Improvements
6070
6071 =item New Or Improved Platforms
6072
6073 =back
6074
6075 =item Selected Bug Fixes
6076
6077 =over 4
6078
6079 =item Platform Specific Changes and Fixes
6080
6081 =back
6082
6083 =item New or Changed Diagnostics
6084
6085 =item Changed Internals
6086
6087 =item Security Vulnerability Closed [561]
6088
6089 =item New Tests
6090
6091 =item Known Problems
6092
6093 =over 4
6094
6095 =item The Compiler Suite Is Still Very Experimental
6096
6097 =item Localising Tied Arrays and Hashes Is Broken
6098
6099 =item Building Extensions Can Fail Because Of Largefiles
6100
6101 =item Modifying $_ Inside for(..)
6102
6103 =item mod_perl 1.26 Doesn't Build With Threaded Perl
6104
6105 =item lib/ftmp-security tests warn 'system possibly insecure'
6106
6107 =item libwww-perl (LWP) fails base/date #51
6108
6109 =item PDL failing some tests
6110
6111 =item Perl_get_sv
6112
6113 =item Self-tying Problems
6114
6115 =item ext/threads/t/libc
6116
6117 =item Failure of Thread (5.005-style) tests
6118
6119 =item Timing problems
6120
6121 =item Tied/Magical Array/Hash Elements Do Not Autovivify
6122
6123 =item Unicode in package/class and subroutine names does not work
6124
6125 =back
6126
6127 =item Platform Specific Problems
6128
6129 =over 4
6130
6131 =item AIX
6132
6133 =item Alpha systems with old gccs fail several tests
6134
6135 =item AmigaOS
6136
6137 =item BeOS
6138
6139 =item Cygwin "unable to remap"
6140
6141 =item Cygwin ndbm tests fail on FAT
6142
6143 =item DJGPP Failures
6144
6145 =item FreeBSD built with ithreads coredumps reading large directories
6146
6147 =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
6148
6149 =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
6150
6151 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
6152
6153 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
6154
6155 =item Linux With Sfio Fails op/misc Test 48
6156
6157 =item Mac OS X
6158
6159 =item Mac OS X dyld undefined symbols
6160
6161 =item OS/2 Test Failures
6162
6163 =item op/sprintf tests 91, 129, and 130
6164
6165 =item SCO
6166
6167 =item Solaris 2.5
6168
6169 =item Solaris x86 Fails Tests With -Duse64bitint
6170
6171 =item SUPER-UX (NEC SX)
6172
6173 =item Term::ReadKey not working on Win32
6174
6175 =item UNICOS/mk
6176
6177 =item UTS
6178
6179 =item VOS (Stratus)
6180
6181 =item VMS
6182
6183 =item Win32
6184
6185 =item XML::Parser not working
6186
6187 =item z/OS (OS/390)
6188
6189 =item Unicode Support on EBCDIC Still Spotty
6190
6191 =item Seen In Perl 5.7 But Gone Now
6192
6193 =back
6194
6195 =item Reporting Bugs
6196
6197 =item SEE ALSO
6198
6199 =item HISTORY
6200
6201 =back
6202
6203 =head2 perl573delta - what's new for perl v5.7.3
6204
6205 =over 4
6206
6207 =item DESCRIPTION
6208
6209 =item Changes
6210
6211 =item Reporting Bugs
6212
6213 =item SEE ALSO
6214
6215 =item HISTORY
6216
6217 =back
6218
6219 =head2 perl572delta - what's new for perl v5.7.2
6220
6221 =over 4
6222
6223 =item DESCRIPTION
6224
6225 =item Security Vulnerability Closed
6226
6227 =item Incompatible Changes
6228
6229 =over 4
6230
6231 =item 64-bit platforms and malloc
6232
6233 =item AIX Dynaloading
6234
6235 =item Socket Extension Dynamic in VMS
6236
6237 =item Different Definition of the Unicode Character Classes \p{In...}
6238
6239 =item Deprecations
6240
6241 =back
6242
6243 =item Core Enhancements
6244
6245 =item Modules and Pragmata
6246
6247 =over 4
6248
6249 =item New Modules and Distributions
6250
6251 =item Updated And Improved Modules and Pragmata
6252
6253 =back
6254
6255 =item Utility Changes
6256
6257 =item New Documentation
6258
6259 =item Installation and Configuration Improvements
6260
6261 =over 4
6262
6263 =item New Or Improved Platforms
6264
6265 =item Generic Improvements
6266
6267 =back
6268
6269 =item Selected Bug Fixes
6270
6271 =over 4
6272
6273 =item Platform Specific Changes and Fixes
6274
6275 =back
6276
6277 =item New or Changed Diagnostics
6278
6279 =item Source Code Enhancements
6280
6281 =over 4
6282
6283 =item MAGIC constants
6284
6285 =item Better commented code
6286
6287 =item Regex pre-/post-compilation items matched up
6288
6289 =item gcc -Wall
6290
6291 =back
6292
6293 =item New Tests
6294
6295 =item Known Problems
6296
6297 =over 4
6298
6299 =item AIX
6300
6301 =item Amiga Perl Invoking Mystery
6302
6303 =item lib/ftmp-security tests warn 'system possibly insecure'
6304
6305 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
6306
6307 =item HP-UX lib/io_multihomed Fails When LP64-Configured
6308
6309 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
6310
6311 =item Linux With Sfio Fails op/misc Test 48
6312
6313 =item OS/390
6314
6315 =item op/sprintf tests 129 and 130
6316
6317 =item  Failure of Thread tests
6318
6319 =item UNICOS
6320
6321 =item UTS
6322
6323 =item VMS
6324
6325 =item Win32
6326
6327 =item Localising a Tied Variable Leaks Memory
6328
6329 =item Self-tying of Arrays and Hashes Is Forbidden
6330
6331 =item Variable Attributes are not Currently Usable for Tieing
6332
6333 =item Building Extensions Can Fail Because Of Largefiles
6334
6335 =item The Compiler Suite Is Still Experimental
6336
6337 =item The Long Double Support is Still Experimental
6338
6339 =back
6340
6341 =item Reporting Bugs
6342
6343 =item SEE ALSO
6344
6345 =item HISTORY
6346
6347 =back
6348
6349 =head2 perl571delta - what's new for perl v5.7.1
6350
6351 =over 4
6352
6353 =item DESCRIPTION
6354
6355 =item Security Vulnerability Closed
6356
6357 =item Incompatible Changes
6358
6359 =item Core Enhancements
6360
6361 =over 4
6362
6363 =item AUTOLOAD Is Now Lvaluable
6364
6365 =item PerlIO is Now The Default
6366
6367 =item Signals Are Now Safe
6368
6369 =back
6370
6371 =item Modules and Pragmata
6372
6373 =over 4
6374
6375 =item New Modules
6376
6377 =item Updated And Improved Modules and Pragmata
6378
6379 =back
6380
6381 =item Performance Enhancements
6382
6383 =item Utility Changes
6384
6385 =item New Documentation
6386
6387 =over 4
6388
6389 =item perlclib
6390
6391 =item perliol
6392
6393 =item README.aix
6394
6395 =item README.bs2000
6396
6397 =item README.macos
6398
6399 =item README.mpeix
6400
6401 =item README.solaris
6402
6403 =item README.vos
6404
6405 =item Porting/repository.pod
6406
6407 =back
6408
6409 =item Installation and Configuration Improvements
6410
6411 =over 4
6412
6413 =item New Or Improved Platforms
6414
6415 =item Generic Improvements
6416
6417 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
6418 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
6419 d_strtoq, d_u32align, d_ualarm, d_usleep
6420
6421 =back
6422
6423 =item Selected Bug Fixes
6424
6425 =over 4
6426
6427 =item Platform Specific Changes and Fixes
6428
6429 =back
6430
6431 =item New or Changed Diagnostics
6432
6433 =item Changed Internals
6434
6435 =item New Tests
6436
6437 =item Known Problems
6438
6439 =over 4
6440
6441 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
6442
6443 =item lib/ftmp-security tests warn 'system possibly insecure'
6444
6445 =item lib/io_multihomed Fails In LP64-Configured HP-UX
6446
6447 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
6448
6449 =item lib/b test 19
6450
6451 =item Linux With Sfio Fails op/misc Test 48
6452
6453 =item sigaction test 13 in VMS
6454
6455 =item sprintf tests 129 and 130
6456
6457 =item  Failure of Thread tests
6458
6459 =item Localising a Tied Variable Leaks Memory
6460
6461 =item Self-tying of Arrays and Hashes Is Forbidden
6462
6463 =item Building Extensions Can Fail Because Of Largefiles
6464
6465 =item The Compiler Suite Is Still Experimental
6466
6467 =back
6468
6469 =item Reporting Bugs
6470
6471 =item SEE ALSO
6472
6473 =item HISTORY
6474
6475 =back
6476
6477 =head2 perl570delta - what's new for perl v5.7.0
6478
6479 =over 4
6480
6481 =item DESCRIPTION
6482
6483 =item Security Vulnerability Closed
6484
6485 =item Incompatible Changes
6486
6487 =item Core Enhancements
6488
6489 =item Modules and Pragmata
6490
6491 =over 4
6492
6493 =item New Modules
6494
6495 =item Updated And Improved Modules and Pragmata
6496
6497 =back
6498
6499 =item Utility Changes
6500
6501 =item New Documentation
6502
6503 =item Performance Enhancements
6504
6505 =item Installation and Configuration Improvements
6506
6507 =over 4
6508
6509 =item Generic Improvements
6510
6511 =back
6512
6513 =item Selected Bug Fixes
6514
6515 =over 4
6516
6517 =item Platform Specific Changes and Fixes
6518
6519 =back
6520
6521 =item New or Changed Diagnostics
6522
6523 =item Changed Internals
6524
6525 =item Known Problems
6526
6527 =over 4
6528
6529 =item Unicode Support Still Far From Perfect
6530
6531 =item EBCDIC Still A Lost Platform
6532
6533 =item Building Extensions Can Fail Because Of Largefiles
6534
6535 =item ftmp-security tests warn 'system possibly insecure'
6536
6537 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
6538
6539 =item Long Doubles Still Don't Work In Solaris
6540
6541 =item Linux With Sfio Fails op/misc Test 48
6542
6543 =item Storable tests fail in some platforms
6544
6545 =item Threads Are Still Experimental
6546
6547 =item The Compiler Suite Is Still Experimental
6548
6549 =back
6550
6551 =item Reporting Bugs
6552
6553 =item SEE ALSO
6554
6555 =item HISTORY
6556
6557 =back
6558
6559 =head2 perl561delta - what's new for perl v5.6.x
6560
6561 =over 4
6562
6563 =item DESCRIPTION
6564
6565 =item Summary of changes between 5.6.0 and 5.6.1
6566
6567 =over 4
6568
6569 =item Security Issues
6570
6571 =item Core bug fixes
6572
6573 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
6574 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
6575 references to special variables, Lexical warnings, Spurious warnings and
6576 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
6577 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
6578 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
6579 Module;>, Tests
6580
6581 =item Core features
6582
6583 =item Configuration issues
6584
6585 =item Documentation
6586
6587 =item Bundled modules
6588
6589 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
6590 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
6591 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
6592 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
6593
6594 =item Platform-specific improvements
6595
6596 NCR MP-RAS, NonStop-UX
6597
6598 =back
6599
6600 =item Core Enhancements
6601
6602 =over 4
6603
6604 =item Interpreter cloning, threads, and concurrency
6605
6606 =item Lexically scoped warning categories
6607
6608 =item Unicode and UTF-8 support
6609
6610 =item Support for interpolating named characters
6611
6612 =item "our" declarations
6613
6614 =item Support for strings represented as a vector of ordinals
6615
6616 =item Improved Perl version numbering system
6617
6618 =item New syntax for declaring subroutine attributes
6619
6620 =item File and directory handles can be autovivified
6621
6622 =item open() with more than two arguments
6623
6624 =item 64-bit support
6625
6626 =item Large file support
6627
6628 =item Long doubles
6629
6630 =item "more bits"
6631
6632 =item Enhanced support for sort() subroutines
6633
6634 =item C<sort $coderef @foo> allowed
6635
6636 =item File globbing implemented internally
6637
6638 =item Support for CHECK blocks
6639
6640 =item POSIX character class syntax [: :] supported
6641
6642 =item Better pseudo-random number generator
6643
6644 =item Improved C<qw//> operator
6645
6646 =item Better worst-case behavior of hashes
6647
6648 =item pack() format 'Z' supported
6649
6650 =item pack() format modifier '!' supported
6651
6652 =item pack() and unpack() support counted strings
6653
6654 =item Comments in pack() templates
6655
6656 =item Weak references
6657
6658 =item Binary numbers supported
6659
6660 =item Lvalue subroutines
6661
6662 =item Some arrows may be omitted in calls through references
6663
6664 =item Boolean assignment operators are legal lvalues
6665
6666 =item exists() is supported on subroutine names
6667
6668 =item exists() and delete() are supported on array elements
6669
6670 =item Pseudo-hashes work better
6671
6672 =item Automatic flushing of output buffers
6673
6674 =item Better diagnostics on meaningless filehandle operations
6675
6676 =item Where possible, buffered data discarded from duped input filehandle
6677
6678 =item eof() has the same old magic as <>
6679
6680 =item binmode() can be used to set :crlf and :raw modes
6681
6682 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6683
6684 =item system(), backticks and pipe open now reflect exec() failure
6685
6686 =item Improved diagnostics
6687
6688 =item Diagnostics follow STDERR
6689
6690 =item More consistent close-on-exec behavior
6691
6692 =item syswrite() ease-of-use
6693
6694 =item Better syntax checks on parenthesized unary operators
6695
6696 =item Bit operators support full native integer width
6697
6698 =item Improved security features
6699
6700 =item More functional bareword prototype (*)
6701
6702 =item C<require> and C<do> may be overridden
6703
6704 =item $^X variables may now have names longer than one character
6705
6706 =item New variable $^C reflects C<-c> switch
6707
6708 =item New variable $^V contains Perl version as a string
6709
6710 =item Optional Y2K warnings
6711
6712 =item Arrays now always interpolate into double-quoted strings
6713
6714 =back
6715
6716 =item Modules and Pragmata
6717
6718 =over 4
6719
6720 =item Modules
6721
6722 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6723 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6724 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6725 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6726 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6727 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6728 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6729 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6730
6731 =item Pragmata
6732
6733 =back
6734
6735 =item Utility Changes
6736
6737 =over 4
6738
6739 =item dprofpp
6740
6741 =item find2perl
6742
6743 =item h2xs
6744
6745 =item perlcc
6746
6747 =item perldoc
6748
6749 =item The Perl Debugger
6750
6751 =back
6752
6753 =item Improved Documentation
6754
6755 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6756 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6757 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6758 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6759
6760 =item Performance enhancements
6761
6762 =over 4
6763
6764 =item Simple sort() using { $a <=> $b } and the like are optimized
6765
6766 =item Optimized assignments to lexical variables
6767
6768 =item Faster subroutine calls
6769
6770 =item delete(), each(), values() and hash iteration are faster
6771
6772 =back
6773
6774 =item Installation and Configuration Improvements
6775
6776 =over 4
6777
6778 =item -Dusethreads means something different
6779
6780 =item New Configure flags
6781
6782 =item Threadedness and 64-bitness now more daring
6783
6784 =item Long Doubles
6785
6786 =item -Dusemorebits
6787
6788 =item -Duselargefiles
6789
6790 =item installusrbinperl
6791
6792 =item SOCKS support
6793
6794 =item C<-A> flag
6795
6796 =item Enhanced Installation Directories
6797
6798 =item gcc automatically tried if 'cc' does not seem to be working
6799
6800 =back
6801
6802 =item Platform specific changes
6803
6804 =over 4
6805
6806 =item Supported platforms
6807
6808 =item DOS
6809
6810 =item OS390 (OpenEdition MVS)
6811
6812 =item VMS
6813
6814 =item Win32
6815
6816 =back
6817
6818 =item Significant bug fixes
6819
6820 =over 4
6821
6822 =item <HANDLE> on empty files
6823
6824 =item C<eval '...'> improvements
6825
6826 =item All compilation errors are true errors
6827
6828 =item Implicitly closed filehandles are safer
6829
6830 =item Behavior of list slices is more consistent
6831
6832 =item C<(\$)> prototype and C<$foo{a}>
6833
6834 =item C<goto &sub> and AUTOLOAD
6835
6836 =item C<-bareword> allowed under C<use integer>
6837
6838 =item Failures in DESTROY()
6839
6840 =item Locale bugs fixed
6841
6842 =item Memory leaks
6843
6844 =item Spurious subroutine stubs after failed subroutine calls
6845
6846 =item Taint failures under C<-U>
6847
6848 =item END blocks and the C<-c> switch
6849
6850 =item Potential to leak DATA filehandles
6851
6852 =back
6853
6854 =item New or Changed Diagnostics
6855
6856 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6857 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6858 / cannot take a count, / must be followed by a, A or Z, / must be followed
6859 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6860 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6861 passed through, /%s/ should probably be written as "%s", %s() called too
6862 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6863 argument is not a HASH or ARRAY element or slice, %s argument is not a
6864 subroutine name, %s package attribute may clash with future reserved word:
6865 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6866 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6867 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6868 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6869 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6870 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6871 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6872 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6873 weaken a nonreference, Character class [:%s:] unknown, Character class
6874 syntax [%s] belongs inside character classes, Constant is not %s reference,
6875 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6876 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6877 "local" instead of "our"?), Document contains no data, entering effective
6878 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6879 output, flock() on closed filehandle %s, Global symbol "%s" requires
6880 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6881 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6882 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6883 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6884 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6885 separator character %s in attribute list, Invalid separator character %s in
6886 subroutine attribute list, leaving effective %s failed, Lvalue subs
6887 returning %s not implemented yet, Method %s not permitted, Missing
6888 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6889 No %s specified for -%c, No package name allowed for variable %s in "our",
6890 No space allowed after -%c, no UTC offset information; assuming local time
6891 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6892 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6893 around "%s" list, Possible unintended interpolation of %s in string,
6894 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6895 instead, Premature end of script headers, Repeat count in pack overflows,
6896 Repeat count in unpack overflows, realloc() of freed memory ignored,
6897 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6898 zero-length expression, switching effective %s is not implemented, This
6899 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6900 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6901 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6902 escape \\%c passed through, Unterminated attribute parameter in attribute
6903 list, Unterminated attribute list, Unterminated attribute parameter in
6904 subroutine attribute list, Unterminated subroutine attribute list, Value of
6905 CLI symbol "%s" too long, Version number must be a constant number
6906
6907 =item New tests
6908
6909 =item Incompatible Changes
6910
6911 =over 4
6912
6913 =item Perl Source Incompatibilities
6914
6915 CHECK is a new keyword, Treatment of list slices of undef has changed,
6916 Format of $English::PERL_VERSION is different, Literals of the form
6917 C<1.2.3> parse differently, Possibly changed pseudo-random number
6918 generator, Hashing function for hash keys has changed, C<undef> fails on
6919 read only values, Close-on-exec bit may be set on pipe and socket handles,
6920 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6921 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6922 Text of some diagnostic output has changed, C<%@> has been removed,
6923 Parenthesized not() behaves like a list operator, Semantics of bareword
6924 prototype C<(*)> have changed, Semantics of bit operators may have changed
6925 on 64-bit platforms, More builtins taint their results
6926
6927 =item C Source Incompatibilities
6928
6929 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6930
6931 =item Compatible C Source API Changes
6932
6933 C<PATCHLEVEL> is now C<PERL_VERSION>
6934
6935 =item Binary Incompatibilities
6936
6937 =back
6938
6939 =item Known Problems
6940
6941 =over 4
6942
6943 =item Localizing a tied hash element may leak memory
6944
6945 =item Known test failures
6946
6947 =item EBCDIC platforms not fully supported
6948
6949 =item UNICOS/mk CC failures during Configure run
6950
6951 =item Arrow operator and arrays
6952
6953 =item Experimental features
6954
6955 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6956 pseudo-hash data type, The Compiler suite, Internal implementation of file
6957 globbing, The DB module, The regular expression code constructs:
6958
6959 =back
6960
6961 =item Obsolete Diagnostics
6962
6963 Character class syntax [: :] is reserved for future extensions, Ill-formed
6964 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6965 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6966 to mean "${$}<digit>" is deprecated
6967
6968 =item Reporting Bugs
6969
6970 =item SEE ALSO
6971
6972 =item HISTORY
6973
6974 =back
6975
6976 =head2 perl56delta - what's new for perl v5.6.0
6977
6978 =over 4
6979
6980 =item DESCRIPTION
6981
6982 =item Core Enhancements
6983
6984 =over 4
6985
6986 =item Interpreter cloning, threads, and concurrency
6987
6988 =item Lexically scoped warning categories
6989
6990 =item Unicode and UTF-8 support
6991
6992 =item Support for interpolating named characters
6993
6994 =item "our" declarations
6995
6996 =item Support for strings represented as a vector of ordinals
6997
6998 =item Improved Perl version numbering system
6999
7000 =item New syntax for declaring subroutine attributes
7001
7002 =item File and directory handles can be autovivified
7003
7004 =item open() with more than two arguments
7005
7006 =item 64-bit support
7007
7008 =item Large file support
7009
7010 =item Long doubles
7011
7012 =item "more bits"
7013
7014 =item Enhanced support for sort() subroutines
7015
7016 =item C<sort $coderef @foo> allowed
7017
7018 =item File globbing implemented internally
7019
7020 =item Support for CHECK blocks
7021
7022 =item POSIX character class syntax [: :] supported
7023
7024 =item Better pseudo-random number generator
7025
7026 =item Improved C<qw//> operator
7027
7028 =item Better worst-case behavior of hashes
7029
7030 =item pack() format 'Z' supported
7031
7032 =item pack() format modifier '!' supported
7033
7034 =item pack() and unpack() support counted strings
7035
7036 =item Comments in pack() templates
7037
7038 =item Weak references
7039
7040 =item Binary numbers supported
7041
7042 =item Lvalue subroutines
7043
7044 =item Some arrows may be omitted in calls through references
7045
7046 =item Boolean assignment operators are legal lvalues
7047
7048 =item exists() is supported on subroutine names
7049
7050 =item exists() and delete() are supported on array elements
7051
7052 =item Pseudo-hashes work better
7053
7054 =item Automatic flushing of output buffers
7055
7056 =item Better diagnostics on meaningless filehandle operations
7057
7058 =item Where possible, buffered data discarded from duped input filehandle
7059
7060 =item eof() has the same old magic as <>
7061
7062 =item binmode() can be used to set :crlf and :raw modes
7063
7064 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
7065
7066 =item system(), backticks and pipe open now reflect exec() failure
7067
7068 =item Improved diagnostics
7069
7070 =item Diagnostics follow STDERR
7071
7072 =item More consistent close-on-exec behavior
7073
7074 =item syswrite() ease-of-use
7075
7076 =item Better syntax checks on parenthesized unary operators
7077
7078 =item Bit operators support full native integer width
7079
7080 =item Improved security features
7081
7082 =item More functional bareword prototype (*)
7083
7084 =item C<require> and C<do> may be overridden
7085
7086 =item $^X variables may now have names longer than one character
7087
7088 =item New variable $^C reflects C<-c> switch
7089
7090 =item New variable $^V contains Perl version as a string
7091
7092 =item Optional Y2K warnings
7093
7094 =item Arrays now always interpolate into double-quoted strings
7095
7096 =back
7097
7098 =item Modules and Pragmata
7099
7100 =over 4
7101
7102 =item Modules
7103
7104 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
7105 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
7106 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
7107 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
7108 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
7109 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
7110 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
7111 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
7112
7113 =item Pragmata
7114
7115 =back
7116
7117 =item Utility Changes
7118
7119 =over 4
7120
7121 =item dprofpp
7122
7123 =item find2perl
7124
7125 =item h2xs
7126
7127 =item perlcc
7128
7129 =item perldoc
7130
7131 =item The Perl Debugger
7132
7133 =back
7134
7135 =item Improved Documentation
7136
7137 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
7138 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
7139 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
7140 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
7141
7142 =item Performance enhancements
7143
7144 =over 4
7145
7146 =item Simple sort() using { $a <=> $b } and the like are optimized
7147
7148 =item Optimized assignments to lexical variables
7149
7150 =item Faster subroutine calls
7151
7152 =item delete(), each(), values() and hash iteration are faster
7153
7154 =back
7155
7156 =item Installation and Configuration Improvements
7157
7158 =over 4
7159
7160 =item -Dusethreads means something different
7161
7162 =item New Configure flags
7163
7164 =item Threadedness and 64-bitness now more daring
7165
7166 =item Long Doubles
7167
7168 =item -Dusemorebits
7169
7170 =item -Duselargefiles
7171
7172 =item installusrbinperl
7173
7174 =item SOCKS support
7175
7176 =item C<-A> flag
7177
7178 =item Enhanced Installation Directories
7179
7180 =back
7181
7182 =item Platform specific changes
7183
7184 =over 4
7185
7186 =item Supported platforms
7187
7188 =item DOS
7189
7190 =item OS390 (OpenEdition MVS)
7191
7192 =item VMS
7193
7194 =item Win32
7195
7196 =back
7197
7198 =item Significant bug fixes
7199
7200 =over 4
7201
7202 =item <HANDLE> on empty files
7203
7204 =item C<eval '...'> improvements
7205
7206 =item All compilation errors are true errors
7207
7208 =item Implicitly closed filehandles are safer
7209
7210 =item Behavior of list slices is more consistent
7211
7212 =item C<(\$)> prototype and C<$foo{a}>
7213
7214 =item C<goto &sub> and AUTOLOAD
7215
7216 =item C<-bareword> allowed under C<use integer>
7217
7218 =item Failures in DESTROY()
7219
7220 =item Locale bugs fixed
7221
7222 =item Memory leaks
7223
7224 =item Spurious subroutine stubs after failed subroutine calls
7225
7226 =item Taint failures under C<-U>
7227
7228 =item END blocks and the C<-c> switch
7229
7230 =item Potential to leak DATA filehandles
7231
7232 =back
7233
7234 =item New or Changed Diagnostics
7235
7236 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
7237 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
7238 / cannot take a count, / must be followed by a, A or Z, / must be followed
7239 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
7240 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
7241 passed through, /%s/ should probably be written as "%s", %s() called too
7242 early to check prototype, %s argument is not a HASH or ARRAY element, %s
7243 argument is not a HASH or ARRAY element or slice, %s argument is not a
7244 subroutine name, %s package attribute may clash with future reserved word:
7245 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
7246 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
7247 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
7248 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
7249 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
7250 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
7251 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
7252 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
7253 weaken a nonreference, Character class [:%s:] unknown, Character class
7254 syntax [%s] belongs inside character classes, Constant is not %s reference,
7255 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
7256 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
7257 "local" instead of "our"?), Document contains no data, entering effective
7258 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
7259 output, flock() on closed filehandle %s, Global symbol "%s" requires
7260 explicit package name, Hexadecimal number > 0xffffffff non-portable,
7261 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
7262 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
7263 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
7264 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
7265 separator character %s in attribute list, Invalid separator character %s in
7266 subroutine attribute list, leaving effective %s failed, Lvalue subs
7267 returning %s not implemented yet, Method %s not permitted, Missing
7268 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
7269 No %s specified for -%c, No package name allowed for variable %s in "our",
7270 No space allowed after -%c, no UTC offset information; assuming local time
7271 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
7272 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
7273 around "%s" list, Possible unintended interpolation of %s in string,
7274 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
7275 instead, Premature end of script headers, Repeat count in pack overflows,
7276 Repeat count in unpack overflows, realloc() of freed memory ignored,
7277 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
7278 zero-length expression, switching effective %s is not implemented, This
7279 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
7280 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
7281 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
7282 escape \\%c passed through, Unterminated attribute parameter in attribute
7283 list, Unterminated attribute list, Unterminated attribute parameter in
7284 subroutine attribute list, Unterminated subroutine attribute list, Value of
7285 CLI symbol "%s" too long, Version number must be a constant number
7286
7287 =item New tests
7288
7289 =item Incompatible Changes
7290
7291 =over 4
7292
7293 =item Perl Source Incompatibilities
7294
7295 CHECK is a new keyword, Treatment of list slices of undef has changed,
7296 Format of $English::PERL_VERSION is different, Literals of the form
7297 C<1.2.3> parse differently, Possibly changed pseudo-random number
7298 generator, Hashing function for hash keys has changed, C<undef> fails on
7299 read only values, Close-on-exec bit may be set on pipe and socket handles,
7300 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
7301 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
7302 Text of some diagnostic output has changed, C<%@> has been removed,
7303 Parenthesized not() behaves like a list operator, Semantics of bareword
7304 prototype C<(*)> have changed, Semantics of bit operators may have changed
7305 on 64-bit platforms, More builtins taint their results
7306
7307 =item C Source Incompatibilities
7308
7309 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
7310
7311 =item Compatible C Source API Changes
7312
7313 C<PATCHLEVEL> is now C<PERL_VERSION>
7314
7315 =item Binary Incompatibilities
7316
7317 =back
7318
7319 =item Known Problems
7320
7321 =over 4
7322
7323 =item Thread test failures
7324
7325 =item EBCDIC platforms not supported
7326
7327 =item In 64-bit HP-UX the lib/io_multihomed test may hang
7328
7329 =item NEXTSTEP 3.3 POSIX test failure
7330
7331 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
7332 gcc
7333
7334 =item UNICOS/mk CC failures during Configure run
7335
7336 =item Arrow operator and arrays
7337
7338 =item Experimental features
7339
7340 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
7341 pseudo-hash data type, The Compiler suite, Internal implementation of file
7342 globbing, The DB module, The regular expression code constructs:
7343
7344 =back
7345
7346 =item Obsolete Diagnostics
7347
7348 Character class syntax [: :] is reserved for future extensions, Ill-formed
7349 logical name |%s| in prime_env_iter, In string, @%s now must be written as
7350 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
7351 to mean "${$}<digit>" is deprecated
7352
7353 =item Reporting Bugs
7354
7355 =item SEE ALSO
7356
7357 =item HISTORY
7358
7359 =back
7360
7361 =head2 perl5005delta - what's new for perl5.005
7362
7363 =over 4
7364
7365 =item DESCRIPTION
7366
7367 =item About the new versioning system
7368
7369 =item Incompatible Changes
7370
7371 =over 4
7372
7373 =item WARNING:  This version is not binary compatible with Perl 5.004.
7374
7375 =item Default installation structure has changed
7376
7377 =item Perl Source Compatibility
7378
7379 =item C Source Compatibility
7380
7381 =item Binary Compatibility
7382
7383 =item Security fixes may affect compatibility
7384
7385 =item Relaxed new mandatory warnings introduced in 5.004
7386
7387 =item Licensing
7388
7389 =back
7390
7391 =item Core Changes
7392
7393 =over 4
7394
7395 =item Threads
7396
7397 =item Compiler
7398
7399 =item Regular Expressions
7400
7401 Many new and improved optimizations, Many bug fixes, New regular expression
7402 constructs, New operator for precompiled regular expressions, Other
7403 improvements, Incompatible changes
7404
7405 =item   Improved malloc()
7406
7407 =item Quicksort is internally implemented
7408
7409 =item Reliable signals
7410
7411 =item Reliable stack pointers
7412
7413 =item More generous treatment of carriage returns
7414
7415 =item Memory leaks
7416
7417 =item Better support for multiple interpreters
7418
7419 =item Behavior of local() on array and hash elements is now well-defined
7420
7421 =item C<%!> is transparently tied to the L<Errno> module
7422
7423 =item Pseudo-hashes are supported
7424
7425 =item C<EXPR foreach EXPR> is supported
7426
7427 =item Keywords can be globally overridden
7428
7429 =item C<$^E> is meaningful on Win32
7430
7431 =item C<foreach (1..1000000)> optimized
7432
7433 =item C<Foo::> can be used as implicitly quoted package name
7434
7435 =item C<exists $Foo::{Bar::}> tests existence of a package
7436
7437 =item Better locale support
7438
7439 =item Experimental support for 64-bit platforms
7440
7441 =item prototype() returns useful results on builtins
7442
7443 =item Extended support for exception handling
7444
7445 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
7446
7447 =item All C<printf> format conversions are handled internally
7448
7449 =item New C<INIT> keyword
7450
7451 =item New C<lock> keyword
7452
7453 =item New C<qr//> operator
7454
7455 =item C<our> is now a reserved word
7456
7457 =item Tied arrays are now fully supported
7458
7459 =item Tied handles support is better
7460
7461 =item 4th argument to substr
7462
7463 =item Negative LENGTH argument to splice
7464
7465 =item Magic lvalues are now more magical
7466
7467 =item <> now reads in records
7468
7469 =back
7470
7471 =item Supported Platforms
7472
7473 =over 4
7474
7475 =item New Platforms
7476
7477 =item Changes in existing support
7478
7479 =back
7480
7481 =item Modules and Pragmata
7482
7483 =over 4
7484
7485 =item New Modules
7486
7487 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
7488 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
7489 Thread, attrs, fields, re
7490
7491 =item Changes in existing modules
7492
7493 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
7494 MakeMaker, CPAN, Cwd
7495
7496 =back
7497
7498 =item Utility Changes
7499
7500 =item Documentation Changes
7501
7502 =item New Diagnostics
7503
7504 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
7505 while coercing array into hash, Bareword "%s" refers to nonexistent
7506 package, Can't call method "%s" on an undefined value, Can't check
7507 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
7508 goto subroutine from an eval-string, Can't localize pseudo-hash element,
7509 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
7510 for "%s", Character class syntax [. .] is reserved for future extensions,
7511 Character class syntax [: :] is reserved for future extensions, Character
7512 class syntax [= =] is reserved for future extensions, %s: Eval-group in
7513 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
7514 Eval-group not allowed at run time, Explicit blessing to '' (assuming
7515 package main), Illegal hex digit ignored, No such array field, No such
7516 field "%s" in variable %s of type %s, Out of memory during ridiculously
7517 large request, Range iterator outside integer range, Recursive inheritance
7518 detected while looking for method '%s' %s, Reference found where even-sized
7519 list expected, Undefined value assigned to typeglob, Use of reserved word
7520 "%s" is deprecated, perl: warning: Setting locale failed
7521
7522 =item Obsolete Diagnostics
7523
7524 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
7525 temporary file, regexp too big
7526
7527 =item Configuration Changes
7528
7529 =item BUGS
7530
7531 =item SEE ALSO
7532
7533 =item HISTORY
7534
7535 =back
7536
7537 =head2 perl5004delta - what's new for perl5.004
7538
7539 =over 4
7540
7541 =item DESCRIPTION
7542
7543 =item Supported Environments
7544
7545 =item Core Changes
7546
7547 =over 4
7548
7549 =item List assignment to %ENV works
7550
7551 =item Change to "Can't locate Foo.pm in @INC" error
7552
7553 =item Compilation option: Binary compatibility with 5.003
7554
7555 =item $PERL5OPT environment variable
7556
7557 =item Limitations on B<-M>, B<-m>, and B<-T> options
7558
7559 =item More precise warnings
7560
7561 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
7562
7563 =item Previously deprecated %OVERLOAD is no longer usable
7564
7565 =item Subroutine arguments created only when they're modified
7566
7567 =item Group vector changeable with C<$)>
7568
7569 =item Fixed parsing of $$<digit>, &$<digit>, etc.
7570
7571 =item Fixed localization of $<digit>, $&, etc.
7572
7573 =item No resetting of $. on implicit close
7574
7575 =item C<wantarray> may return undef
7576
7577 =item C<eval EXPR> determines value of EXPR in scalar context
7578
7579 =item Changes to tainting checks
7580
7581 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
7582 spawning if tainted $TERM doesn't look like a terminal name
7583
7584 =item New Opcode module and revised Safe module
7585
7586 =item Embedding improvements
7587
7588 =item Internal change: FileHandle class based on IO::* classes
7589
7590 =item Internal change: PerlIO abstraction interface
7591
7592 =item New and changed syntax
7593
7594 $coderef->(PARAMS)
7595
7596 =item New and changed builtin constants
7597
7598 __PACKAGE__
7599
7600 =item New and changed builtin variables
7601
7602 $^E, $^H, $^M
7603
7604 =item New and changed builtin functions
7605
7606 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
7607 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
7608 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
7609 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
7610 nested C<sub{}> closures work now, formats work right on changing lexicals
7611
7612 =item New builtin methods
7613
7614 isa(CLASS), can(METHOD), VERSION( [NEED] )
7615
7616 =item TIEHANDLE now supported
7617
7618 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
7619 LIST, READLINE this, GETC this, DESTROY this
7620
7621 =item Malloc enhancements
7622
7623 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
7624
7625 =item Miscellaneous efficiency enhancements
7626
7627 =back
7628
7629 =item Support for More Operating Systems
7630
7631 =over 4
7632
7633 =item Win32
7634
7635 =item Plan 9
7636
7637 =item QNX
7638
7639 =item AmigaOS
7640
7641 =back
7642
7643 =item Pragmata
7644
7645 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
7646 constant NAME => VALUE, use locale, use ops, use vmsish
7647
7648 =item Modules
7649
7650 =over 4
7651
7652 =item Required Updates
7653
7654 =item Installation directories
7655
7656 =item Module information summary
7657
7658 =item Fcntl
7659
7660 =item IO
7661
7662 =item Math::Complex
7663
7664 =item Math::Trig
7665
7666 =item DB_File
7667
7668 =item Net::Ping
7669
7670 =item Object-oriented overrides for builtin operators
7671
7672 =back
7673
7674 =item Utility Changes
7675
7676 =over 4
7677
7678 =item pod2html
7679
7680 Sends converted HTML to standard output
7681
7682 =item xsubpp
7683
7684 C<void> XSUBs now default to returning nothing
7685
7686 =back
7687
7688 =item C Language API Changes
7689
7690 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
7691 manipulating hashes
7692
7693 =item Documentation Changes
7694
7695 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
7696 L<perlmodlib>, L<perldebug>, L<perlsec>
7697
7698 =item New Diagnostics
7699
7700 "my" variable %s masks earlier declaration in same scope, %s argument is
7701 not a HASH element or slice, Allocation too large: %lx, Allocation too
7702 large, Applying %s to %s will act on scalar(%s), Attempt to free
7703 nonexistent shared string, Attempt to use reference as lvalue in substr,
7704 Bareword "%s" refers to nonexistent package, Can't redefine active sort
7705 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
7706 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
7707 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
7708 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
7709 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
7710 %s, Integer overflow in hex number, Integer overflow in octal number,
7711 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
7712 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
7713 possible typo, Null picture in formline, Offset outside string, Out of
7714 memory!, Out of memory during request for %s, panic: frexp, Possible
7715 attempt to put comments in qw() list, Possible attempt to separate words
7716 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
7717 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
7718 option, untie attempted while %d inner references still exist, Unrecognized
7719 character %s, Unsupported function fork, Use of "$$<digit>" to mean
7720 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
7721 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
7722 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
7723 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
7724 long, Process terminated by SIG%s
7725
7726 =item BUGS
7727
7728 =item SEE ALSO
7729
7730 =item HISTORY
7731
7732 =back
7733
7734 =head2 perlartistic - the Perl Artistic License
7735
7736 =over 4
7737
7738 =item SYNOPSIS
7739
7740 =item DESCRIPTION
7741
7742 =item The "Artistic License"
7743
7744 =over 4
7745
7746 =item Preamble
7747
7748 =item Definitions
7749
7750 "Package", "Standard Version", "Copyright Holder", "You", "Reasonable
7751 copying fee", "Freely Available"
7752
7753 =item Conditions
7754
7755 a), b), c), d), a), b), c), d)
7756
7757 =back
7758
7759 =back
7760
7761 =head2 perlgpl - the GNU General Public License, version 2
7762
7763 =over 4
7764
7765 =item SYNOPSIS
7766
7767 =back
7768
7769 =over 4
7770
7771 =item DESCRIPTION
7772
7773 =item GNU GENERAL PUBLIC LICENSE
7774
7775 =back
7776
7777 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
7778
7779 =over 4
7780
7781 =item DESCRIPTION
7782
7783 =over 4
7784
7785 =item Compiling Perl 5 on AIX
7786
7787 =item OS level
7788
7789 =item Building Dynamic Extensions on AIX
7790
7791 =item The IBM ANSI C Compiler
7792
7793 =item The usenm option
7794
7795 =item Using GNU's gcc for building perl
7796
7797 =item Using Large Files with Perl
7798
7799 =item Threaded Perl
7800
7801 =item 64-bit Perl
7802
7803 =item AIX 4.2 and extensions using C++ with statics
7804
7805 =back
7806
7807 =item AUTHOR
7808
7809 =item DATE
7810
7811 =back
7812
7813 =head2 perlamiga - Perl under Amiga OS
7814
7815 =over 4
7816
7817 =item NOTE
7818
7819 =item SYNOPSIS
7820
7821 =back
7822
7823 =over 4
7824
7825 =item DESCRIPTION
7826
7827 =over 4
7828
7829 =item Prerequisites for Compiling Perl on AmigaOS
7830
7831 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
7832
7833 =item Starting Perl programs under AmigaOS
7834
7835 =item Shortcomings of Perl under AmigaOS
7836
7837 =back
7838
7839 =item INSTALLATION
7840
7841 =item Accessing documentation
7842
7843 =over 4
7844
7845 =item Manpages for Perl on AmigaOS
7846
7847 =item Perl HTML Documentation on AmigaOS
7848
7849 =item Perl GNU Info Files on AmigaOS
7850
7851 =item Perl LaTeX Documentation on AmigaOS
7852
7853 =back
7854
7855 =item BUILDING PERL ON AMIGAOS
7856
7857 =over 4
7858
7859 =item Build Prerequisites for Perl on AmigaOS
7860
7861 =item Getting the Perl Source for AmigaOS
7862
7863 =item Making Perl on AmigaOS
7864
7865 =item Testing Perl on AmigaOS
7866
7867 =item Installing the built Perl on AmigaOS
7868
7869 =back
7870
7871 =item PERL 5.8.0 BROKEN IN AMIGAOS
7872
7873 =item AUTHORS
7874
7875 =item SEE ALSO
7876
7877 =back
7878
7879 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
7880
7881 =over 4
7882
7883 =item DESCRIPTION
7884
7885 =item AUTHOR
7886
7887 =back
7888
7889 =head2 perlbeos, README.beos - Perl version 5 on BeOS
7890
7891 =over 4
7892
7893 =item DESCRIPTION
7894
7895 =over 4
7896
7897 =item General Issues with Perl on BeOS
7898
7899 =item BeOS Release-specific Notes
7900
7901 R4 x86, R4 PPC
7902
7903 =item Contact Information
7904
7905 =item Update 2002-05-30
7906
7907 =back
7908
7909 =back
7910
7911 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
7912
7913 =over 4
7914
7915 =item SYNOPSIS
7916
7917 =item DESCRIPTION
7918
7919 =over 4
7920
7921 =item gzip on BS2000
7922
7923 =item bison on BS2000
7924
7925 =item Unpacking Perl Distribution on BS2000
7926
7927 =item Compiling Perl on BS2000
7928
7929 =item Testing Perl on BS2000
7930
7931 =item Installing Perl on BS2000
7932
7933 =item Using Perl in the Posix-Shell of BS2000
7934
7935 =item Using Perl in "native" BS2000
7936
7937 =item Floating point anomalies on BS2000
7938
7939 =item Using PerlIO and different encodings on ASCII and EBCDIC partitions
7940
7941 =back
7942
7943 =item AUTHORS
7944
7945 =item SEE ALSO
7946
7947 =over 4
7948
7949 =item Mailing list
7950
7951 =back
7952
7953 =item HISTORY
7954
7955 =back
7956
7957 =head2 perlce - Perl for WinCE
7958
7959 =over 4
7960
7961 =item DESCRIPTION
7962
7963 =item BUILD
7964
7965 =over 4
7966
7967 =item Tools & SDK
7968
7969 Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's
7970 celib-sources, Rainer Keuchel's console-sources
7971
7972 =item Make
7973
7974 go to ./wince subdirectory, edit file compile.bat, run    compile.bat, run 
7975   compile.bat dist
7976
7977 =back
7978
7979 =item ACKNOWLEDGEMENTS
7980
7981 =item AUTHORS
7982
7983 =back
7984
7985 =head2 perlcygwin, README.cygwin - Perl for Cygwin
7986
7987 =over 4
7988
7989 =item SYNOPSIS
7990
7991 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
7992
7993 =over 4
7994
7995 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
7996
7997 =item Cygwin Configuration
7998
7999 C<PATH>, I<nroff>, Permissions
8000
8001 =back
8002
8003 =item CONFIGURE PERL ON CYGWIN
8004
8005 =over 4
8006
8007 =item Stripping Perl Binaries on Cygwin
8008
8009 =item Optional Libraries for Perl on Cygwin
8010
8011 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
8012 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
8013
8014 =item Configure-time Options for Perl on Cygwin
8015
8016 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
8017 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
8018 C<-Dmksymlinks>
8019
8020 =item Suspicious Warnings on Cygwin
8021
8022 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
8023
8024 =back
8025
8026 =item MAKE ON CYGWIN
8027
8028 =over 4
8029
8030 =item Errors on Cygwin
8031
8032 =item ld2 on Cygwin
8033
8034 =back
8035
8036 =item TEST ON CYGWIN
8037
8038 =over 4
8039
8040 =item File Permissions on Cygwin
8041
8042 =item NDBM_File and ODBM_File do not work on FAT filesystems
8043
8044 =item C<fork()> failures in io_* tests
8045
8046 =item Script Portability on Cygwin
8047
8048 Pathnames, Text/Binary, PerlIO, F<.exe>, C<chown()>, Miscellaneous
8049
8050 =back
8051
8052 =item INSTALL PERL ON CYGWIN
8053
8054 =item MANIFEST ON CYGWIN
8055
8056 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
8057 Source, Compiled Module Source, Perl Modules/Scripts
8058
8059 =item BUGS ON CYGWIN
8060
8061 =item AUTHORS
8062
8063 =item HISTORY
8064
8065 =back
8066
8067 =head2 perldgux - Perl under DG/UX.
8068
8069 =over 4
8070
8071 =item SYNOPSIS
8072
8073 =back
8074
8075 =over 4
8076
8077 =item DESCRIPTION
8078
8079 =item BUILDING PERL ON DG/UX
8080
8081 =over 4
8082
8083 =item Non-threaded Perl on DG/UX
8084
8085 =item Threaded Perl on DG/UX
8086
8087 =item Testing Perl on DG/UX
8088
8089 =item Installing the built perl on DG/UX
8090
8091 =back
8092
8093 =item AUTHOR
8094
8095 =item SEE ALSO
8096
8097 =back
8098
8099 =head2 perldos - Perl under DOS, W31, W95.
8100
8101 =over 4
8102
8103 =item SYNOPSIS
8104
8105 =item DESCRIPTION
8106
8107 =over 4
8108
8109 =item Prerequisites for Compiling Perl on DOS
8110
8111 DJGPP, Pthreads
8112
8113 =item Shortcomings of Perl under DOS
8114
8115 =item Building Perl on DOS
8116
8117 =item Testing Perl on DOS
8118
8119 =item Installation of Perl on DOS
8120
8121 =back
8122
8123 =item BUILDING AND INSTALLING MODULES ON DOS
8124
8125 =over 4
8126
8127 =item Building Prerequisites for Perl on DOS
8128
8129 =item Unpacking CPAN Modules on DOS
8130
8131 =item Building Non-XS Modules on DOS
8132
8133 =item Building XS Modules on DOS
8134
8135 =back
8136
8137 =item AUTHOR
8138
8139 =item SEE ALSO
8140
8141 =back
8142
8143 =head2 perlepoc, README.epoc - Perl for EPOC
8144
8145 =over 4
8146
8147 =item SYNOPSIS
8148
8149 =item INTRODUCTION
8150
8151 =item INSTALLING PERL ON EPOC
8152
8153 =item STARTING PERL ON EPOC
8154
8155 =over 4
8156
8157 =item Editors on Epoc
8158
8159 =item Features of Perl on Epoc
8160
8161 =item Restrictions of Perl on Epoc
8162
8163 =item Compiling Perl 5 on the EPOC cross compiling environment
8164
8165 =back
8166
8167 =item SUPPORT STATUS OF PERL ON EPOC
8168
8169 =item AUTHOR
8170
8171 =item LAST UPDATE
8172
8173 =back
8174
8175 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
8176
8177 =over 4
8178
8179 =item DESCRIPTION
8180
8181 =over 4
8182
8183 =item FreeBSD core dumps from readdir_r with ithreads
8184
8185 =item $^X doesn't always contain a full path in FreeBSD
8186
8187 =item Perl will no longer be part of "base FreeBSD"
8188
8189 =back
8190
8191 =item AUTHOR
8192
8193 =back
8194
8195 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
8196 (HP-UX) systems
8197
8198 =over 4
8199
8200 =item DESCRIPTION
8201
8202 =over 4
8203
8204 =item Using perl as shipped with HP-UX
8205
8206 =item Using perl from HP's porting centre
8207
8208 =item Compiling Perl 5 on HP-UX
8209
8210 =item PA-RISC
8211
8212 =item PA-RISC 1.0
8213
8214 =item PA-RISC 1.1
8215
8216 =item PA-RISC 2.0
8217
8218 =item Itanium & Itanium 2
8219
8220 =item Portability Between PA-RISC Versions
8221
8222 =item Itanium Processor Family and HP-UX
8223
8224 =item Building Dynamic Extensions on HP-UX
8225
8226 =item The HP ANSI C Compiler
8227
8228 =item The GNU C Compiler
8229
8230 =item Using Large Files with Perl on HP-UX
8231
8232 =item Threaded Perl on HP-UX
8233
8234 =item 64-bit Perl on HP-UX
8235
8236 =item Oracle on HP-UX
8237
8238 =item GDBM and Threads on HP-UX
8239
8240 =item NFS filesystems and utime(2) on HP-UX
8241
8242 =item perl -P and // and HP-UX
8243
8244 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
8245
8246 =back
8247
8248 =item nss_delete core dump from op/pwent or op/grent
8249
8250 =item AUTHOR
8251
8252 =item DATE
8253
8254 =back
8255
8256 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
8257
8258 =over 4
8259
8260 =item DESCRIPTION
8261
8262 =over 4
8263
8264 =item Known Problems with Perl on Hurd 
8265
8266 =back
8267
8268 =item AUTHOR
8269
8270 =back
8271
8272 =head2 perlirix, README.irix - Perl version 5 on Irix systems
8273
8274 =over 4
8275
8276 =item DESCRIPTION
8277
8278 =over 4
8279
8280 =item Building 32-bit Perl in Irix
8281
8282 =item Building 64-bit Perl in Irix
8283
8284 =item About Compiler Versions of Irix
8285
8286 =item Linker Problems in Irix
8287
8288 =item Malloc in Irix
8289
8290 =item Building with threads in Irix
8291
8292 =item Irix 5.3
8293
8294 =back
8295
8296 =item AUTHOR
8297
8298 =back
8299
8300 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
8301 systems
8302
8303 =over 4
8304
8305 =item DESCRIPTION
8306
8307 =over 4
8308
8309 =item Perl version 5.8.x and greater not supported
8310
8311 =item Compiling Perl 5.6.x on MachTen
8312
8313 =item Failures during C<make test> on MachTen
8314
8315 op/lexassign.t, pragma/warnings.t
8316
8317 =item Building external modules on MachTen
8318
8319 =back
8320
8321 =item AUTHOR
8322
8323 =item DATE
8324
8325 =back
8326
8327 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
8328
8329 =over 4
8330
8331 =item SYNOPSIS
8332
8333 =item DESCRIPTION
8334
8335 =item AUTHOR
8336
8337 =item DATE
8338
8339 =back
8340
8341 =head2 perlmacosx, README.macosx - Perl under Mac OS X
8342
8343 =over 4
8344
8345 =item SYNOPSIS
8346
8347 =item DESCRIPTION
8348
8349 =over 4
8350
8351 =item Installation Prefix
8352
8353 =item libperl and Prebinding
8354
8355 =item Updating Panther
8356
8357 =item Known problems
8358
8359 =item MacPerl
8360
8361 =item Carbon
8362
8363 =item Cocoa
8364
8365 =back
8366
8367 =item Starting From Scratch
8368
8369 =item AUTHOR
8370
8371 =item DATE
8372
8373 =back
8374
8375 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
8376
8377 =over 4
8378
8379 =item DESCRIPTION
8380
8381 =item Known problems with Perl on MiNT
8382
8383 =item AUTHOR
8384
8385 =back
8386
8387 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
8388
8389 =over 4
8390
8391 =item SYNOPSIS
8392
8393 =item NOTE
8394
8395 =item Binary distribution from HP
8396
8397 =item What's New in Perl for MPE/iX
8398
8399 =item Welcome to Perl/iX
8400
8401 =item System Requirements for Perl/iX
8402
8403 =item How to Obtain Perl/iX
8404
8405 =item Perl/iX Distribution Contents Highlights
8406
8407 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
8408 public_html/feedback.cgi, src/perl-5.6.0-mpe
8409
8410 =item How to Compile Perl/iX
8411
8412  4,  6
8413
8414 =item Getting Started with Perl/iX
8415
8416 =item MPE/iX Implementation Considerations
8417
8418 =item Known Perl/iX Bugs Under Investigation
8419
8420 =item Perl/iX To-Do List
8421
8422 =item Perl/iX Change History
8423
8424 =item AUTHOR
8425
8426 =back
8427
8428 =head2 perlnetware - Perl for NetWare
8429
8430 =over 4
8431
8432 =item DESCRIPTION
8433
8434 =item BUILD
8435
8436 =over 4
8437
8438 =item Tools & SDK
8439
8440 =item Setup
8441
8442 SetNWBld.bat, Buildtype.bat
8443
8444 =item Make
8445
8446 =item Interpreter
8447
8448 =item Extensions
8449
8450 =back
8451
8452 =item INSTALL
8453
8454 =item BUILD NEW EXTENSIONS
8455
8456 =item ACKNOWLEDGEMENTS
8457
8458 =item AUTHORS
8459
8460 =item DATE
8461
8462 =back
8463
8464 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
8465
8466 =over 4
8467
8468 =item SYNOPSIS
8469
8470 =back
8471
8472 =over 4
8473
8474 =item DESCRIPTION
8475
8476 =over 4
8477
8478 =item Target
8479
8480 =item Other OSes
8481
8482 =item Prerequisites
8483
8484 EMX, RSX, HPFS, pdksh
8485
8486 =item Starting Perl programs under OS/2 (and DOS and...)
8487
8488 =item Starting OS/2 (and DOS) programs under Perl
8489
8490 =back
8491
8492 =item Frequently asked questions
8493
8494 =over 4
8495
8496 =item "It does not work"
8497
8498 =item I cannot run external programs
8499
8500 =item I cannot embed perl into my program, or use F<perl.dll> from my
8501 program. 
8502
8503 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
8504 L<ExtUtils::Embed>?
8505
8506 =item C<``> and pipe-C<open> do not work under DOS.
8507
8508 =item Cannot start C<find.exe "pattern" file>
8509
8510 =back
8511
8512 =item INSTALLATION
8513
8514 =over 4
8515
8516 =item Automatic binary installation
8517
8518 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
8519
8520 =item Manual binary installation
8521
8522 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
8523 (statically linked), Executables for Perl utilities, Main Perl library,
8524 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
8525 and utilities, Manpages for Perl modules, Source for Perl documentation,
8526 Perl manual in F<.INF> format, Pdksh
8527
8528 =item B<Warning>
8529
8530 =back
8531
8532 =item Accessing documentation
8533
8534 =over 4
8535
8536 =item OS/2 F<.INF> file
8537
8538 =item Plain text
8539
8540 =item Manpages
8541
8542 =item HTML
8543
8544 =item GNU C<info> files
8545
8546 =item F<PDF> files
8547
8548 =item C<LaTeX> docs
8549
8550 =back
8551
8552 =item BUILD
8553
8554 =over 4
8555
8556 =item The short story
8557
8558 =item Prerequisites
8559
8560 =item Getting perl source
8561
8562 =item Application of the patches
8563
8564 =item Hand-editing
8565
8566 =item Making
8567
8568 =item Testing
8569
8570 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
8571 F<op/stat.t>
8572
8573 =item Installing the built perl
8574
8575 =item C<a.out>-style build
8576
8577 =back
8578
8579 =item Building a binary distribution
8580
8581 =item Building custom F<.EXE> files
8582
8583 =over 4
8584
8585 =item Making executables with a custom collection of statically loaded
8586 extensions
8587
8588 =item Making executables with a custom search-paths
8589
8590 =back
8591
8592 =item Build FAQ
8593
8594 =over 4
8595
8596 =item Some C</> became C<\> in pdksh.
8597
8598 =item C<'errno'> - unresolved external
8599
8600 =item Problems with tr or sed
8601
8602 =item Some problem (forget which ;-)
8603
8604 =item Library ... not found
8605
8606 =item Segfault in make
8607
8608 =item op/sprintf test failure
8609
8610 =back
8611
8612 =item Specific (mis)features of OS/2 port
8613
8614 =over 4
8615
8616 =item C<setpriority>, C<getpriority>
8617
8618 =item C<system()>
8619
8620 =item C<extproc> on the first line
8621
8622 =item Additional modules:
8623
8624 =item Prebuilt methods:
8625
8626 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
8627  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>, 
8628 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>, 
8629 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>, 
8630 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>, 
8631 C<Cwd::extLibpath_set( path [, type ] )>,
8632 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
8633 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
8634 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
8635 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
8636 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
8637 C<OS2::DLLname([how [, \&xsub]])>
8638
8639 =item Prebuilt variables:
8640
8641 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
8642 $OS2::nsyserror
8643
8644 =item Misfeatures
8645
8646 =item Modifications
8647
8648 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
8649 C<flock>
8650
8651 =item Identifying DLLs
8652
8653 =item Centralized management of resources
8654
8655 C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
8656 C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
8657 C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
8658 C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
8659
8660 =back
8661
8662 =item Perl flavors
8663
8664 =over 4
8665
8666 =item F<perl.exe>
8667
8668 =item F<perl_.exe>
8669
8670 =item F<perl__.exe>
8671
8672 =item F<perl___.exe>
8673
8674 =item Why strange names?
8675
8676 =item Why dynamic linking?
8677
8678 =item Why chimera build?
8679
8680 =back
8681
8682 =item ENVIRONMENT
8683
8684 =over 4
8685
8686 =item C<PERLLIB_PREFIX>
8687
8688 =item C<PERL_BADLANG>
8689
8690 =item C<PERL_BADFREE>
8691
8692 =item C<PERL_SH_DIR>
8693
8694 =item C<USE_PERL_FLOCK>
8695
8696 =item C<TMP> or C<TEMP>
8697
8698 =back
8699
8700 =item Evolution
8701
8702 =over 4
8703
8704 =item Text-mode filehandles
8705
8706 =item Priorities
8707
8708 =item DLL name mangling: pre 5.6.2
8709
8710 =item DLL name mangling: 5.6.2 and beyond
8711
8712 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
8713 C<LIBPATH>
8714
8715 =item DLL forwarder generation
8716
8717 =item Threading
8718
8719 =item Calls to external programs
8720
8721 =item Memory allocation
8722
8723 =item Threads
8724
8725 C<COND_WAIT>, F<os2.c>
8726
8727 =back
8728
8729 =item BUGS
8730
8731 =back
8732
8733 =over 4
8734
8735 =item AUTHOR
8736
8737 =item SEE ALSO
8738
8739 =back
8740
8741 =head2 perlos390, README.os390 - building and installing Perl for OS/390
8742 and z/OS
8743
8744 =over 4
8745
8746 =item SYNOPSIS
8747
8748 =item DESCRIPTION
8749
8750 =over 4
8751
8752 =item Tools
8753
8754 =item Unpacking Perl distribution on OS/390
8755
8756 =item Setup and utilities for Perl on OS/390
8757
8758 =item Configure Perl on OS/390
8759
8760 =item Build, Test, Install Perl on OS/390
8761
8762 =item Build Anomalies with Perl on OS/390
8763
8764 =item Testing Anomalies with Perl on OS/390
8765
8766 =item Installation Anomalies with Perl on OS/390
8767
8768 =item Usage Hints for Perl on OS/390
8769
8770 =item Floating Point Anomalies with Perl on OS/390
8771
8772 =item Modules and Extensions for Perl on OS/390
8773
8774 =back
8775
8776 =item AUTHORS
8777
8778 =item SEE ALSO
8779
8780 =over 4
8781
8782 =item Mailing list for Perl on OS/390
8783
8784 =back
8785
8786 =item HISTORY
8787
8788 =back
8789
8790 =head2 perlos400, README.os400 - Perl version 5 on OS/400
8791
8792 =over 4
8793
8794 =item DESCRIPTION
8795
8796 =over 4
8797
8798 =item Compiling Perl for OS/400 PASE
8799
8800 =item Installing Perl in OS/400 PASE
8801
8802 =item Using Perl in OS/400 PASE
8803
8804 =item Known Problems
8805
8806 =item Perl on ILE
8807
8808 =back
8809
8810 =item AUTHORS
8811
8812 =back
8813
8814 =head2 perlplan9 - Plan 9-specific documentation for Perl
8815
8816 =over 4
8817
8818 =item DESCRIPTION
8819
8820 =over 4
8821
8822 =item Invoking Perl
8823
8824 =item What's in Plan 9 Perl
8825
8826 =item What's not in Plan 9 Perl
8827
8828 =item Perl5 Functions not currently supported in Plan 9 Perl
8829
8830 =item Signals in Plan 9 Perl
8831
8832 =back
8833
8834 =item COMPILING AND INSTALLING PERL ON PLAN 9
8835
8836 =over 4
8837
8838 =item Installing Perl Documentation on Plan 9
8839
8840 =back
8841
8842 =item BUGS
8843
8844 =item Revision date
8845
8846 =item AUTHOR
8847
8848 =back
8849
8850 =head2 perlqnx, README.qnx - Perl version 5 on QNX
8851
8852 =over 4
8853
8854 =item DESCRIPTION
8855
8856 =over 4
8857
8858 =item Required Software for Compiling Perl on QNX4
8859
8860 /bin/sh, ar, nm, cpp, make
8861
8862 =item Outstanding Issues with Perl on QNX4
8863
8864 =item QNX auxiliary files
8865
8866 qnx/ar, qnx/cpp
8867
8868 =item Outstanding issues with perl under QNX6
8869
8870 =back
8871
8872 =item AUTHOR
8873
8874 =back
8875
8876 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
8877
8878 =over 4
8879
8880 =item DESCRIPTION
8881
8882 =over 4
8883
8884 =item Solaris Version Numbers.
8885
8886 =back
8887
8888 =item RESOURCES
8889
8890 Solaris FAQ, Precompiled Binaries, Solaris Documentation
8891
8892 =item SETTING UP
8893
8894 =over 4
8895
8896 =item File Extraction Problems on Solaris.
8897
8898 =item Compiler and Related Tools on Solaris.
8899
8900 =item Environment for Compiling perl on Solaris
8901
8902 =back
8903
8904 =item RUN CONFIGURE.
8905
8906 =over 4
8907
8908 =item 64-bit perl on Solaris.
8909
8910 =item Threads in perl on Solaris.
8911
8912 =item Malloc Issues with perl on Solaris.
8913
8914 =back
8915
8916 =item MAKE PROBLEMS.
8917
8918 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
8919 relocation error:, dlopen: stub interception failed, #error "No
8920 DATAMODEL_NATIVE specified", sh: ar: not found
8921
8922 =item MAKE TEST
8923
8924 =over 4
8925
8926 =item op/stat.t test 4 in Solaris
8927
8928 =item nss_delete core dump from op/pwent or op/grent
8929
8930 =back
8931
8932 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
8933
8934 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
8935
8936 =over 4
8937
8938 =item Limits on Numbers of Open Files on Solaris.
8939
8940 =back
8941
8942 =item SOLARIS-SPECIFIC MODULES.
8943
8944 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
8945
8946 =over 4
8947
8948 =item Proc::ProcessTable on Solaris
8949
8950 =item BSD::Resource on Solaris
8951
8952 =item Net::SSLeay on Solaris
8953
8954 =back
8955
8956 =item SunOS 4.x
8957
8958 =item AUTHOR
8959
8960 =item LAST MODIFIED
8961
8962 =back
8963
8964 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
8965 Digital UNIX formerly known as DEC OSF/1) systems
8966
8967 =over 4
8968
8969 =item DESCRIPTION
8970
8971 =over 4
8972
8973 =item Compiling Perl 5 on Tru64
8974
8975 =item Using Large Files with Perl on Tru64
8976
8977 =item Threaded Perl on Tru64
8978
8979 =item Long Doubles on Tru64
8980
8981 =item DB_File tests failing on Tru64
8982
8983 =item 64-bit Perl on Tru64
8984
8985 =item Warnings about floating-point overflow when compiling Perl on Tru64
8986
8987 =back
8988
8989 =item Testing Perl on Tru64
8990
8991 =item ext/ODBM_File/odbm Test Failing With Static Builds
8992
8993 =item Perl Fails Because Of Unresolved Symbol sockatmark
8994
8995 =item AUTHOR
8996
8997 =back
8998
8999 =head2 perluts - Perl under UTS
9000
9001 =over 4
9002
9003 =item SYNOPSIS
9004
9005 =item DESCRIPTION
9006
9007 =item BUILDING PERL ON UTS
9008
9009 =item Installing the built perl on UTS
9010
9011 =item AUTHOR
9012
9013 =back
9014
9015 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
9016
9017 =over 4
9018
9019 =item SYNOPSIS
9020
9021 =item DESCRIPTION
9022
9023 =over 4
9024
9025 =item Unpacking Perl Distribution on VM/ESA
9026
9027 =item Setup Perl and utilities on VM/ESA
9028
9029 =item Configure Perl on VM/ESA
9030
9031 =item Testing Anomalies of Perl on VM/ESA
9032
9033 =item Usage Hints for Perl on VM/ESA
9034
9035 =back
9036
9037 =item AUTHORS
9038
9039 =item SEE ALSO
9040
9041 =over 4
9042
9043 =item Mailing list for Perl on VM/ESA
9044
9045 =back
9046
9047 =back
9048
9049 =head2 perlvms - VMS-specific documentation for Perl
9050
9051 =over 4
9052
9053 =item DESCRIPTION
9054
9055 =item Installation
9056
9057 =item Organization of Perl Images
9058
9059 =over 4
9060
9061 =item Core Images
9062
9063 =item Perl Extensions
9064
9065 =item Installing static extensions
9066
9067 =item Installing dynamic extensions
9068
9069 =back
9070
9071 =item File specifications
9072
9073 =over 4
9074
9075 =item Syntax
9076
9077 =item Wildcard expansion
9078
9079 =item Pipes
9080
9081 =back
9082
9083 =item PERL5LIB and PERLLIB
9084
9085 =item Command line
9086
9087 =over 4
9088
9089 =item I/O redirection and backgrounding
9090
9091 =item Command line switches
9092
9093 -i, -S, -u
9094
9095 =back
9096
9097 =item Perl functions
9098
9099 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
9100 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
9101 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
9102 LIST, waitpid PID,FLAGS
9103
9104 =item Perl variables
9105
9106 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
9107
9108 =item Standard modules with VMS-specific differences
9109
9110 =over 4
9111
9112 =item SDBM_File
9113
9114 =back
9115
9116 =item Revision date
9117
9118 =item AUTHOR
9119
9120 =back
9121
9122 =head2 perlvos, README.vos - Perl for Stratus VOS
9123
9124 =over 4
9125
9126 =item SYNOPSIS
9127
9128 =item BUILDING PERL FOR VOS
9129
9130 =item INSTALLING PERL IN VOS
9131
9132 =item USING PERL IN VOS
9133
9134 =over 4
9135
9136 =item Restrictions of Perl on VOS
9137
9138 =item Handling of underflow and overflow
9139
9140 =back
9141
9142 =item TEST STATUS
9143
9144 =item SUPPORT STATUS
9145
9146 =item AUTHOR
9147
9148 =item LAST UPDATE
9149
9150 =back
9151
9152 =head2 perlwin32 - Perl under Windows
9153
9154 =over 4
9155
9156 =item SYNOPSIS
9157
9158 =item DESCRIPTION
9159
9160 =over 4
9161
9162 =item Setting Up Perl on Win32
9163
9164 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform
9165 SDK 64-bit Compiler, MinGW release 3 with gcc, MinGW release 1 with gcc
9166
9167 =item Building
9168
9169 =item Testing Perl on Win32
9170
9171 =item Installation of Perl on Win32
9172
9173 =item Usage Hints for Perl on Win32
9174
9175 Environment Variables, File Globbing, Using perl from the command line,
9176 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
9177 Extensions, Notes on 64-bit Windows
9178
9179 =item Running Perl Scripts
9180
9181 Miscellaneous Things
9182
9183 =back
9184
9185 =item BUGS AND CAVEATS
9186
9187 =item ACKNOWLEDGEMENTS
9188
9189 =item AUTHORS
9190
9191 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
9192 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
9193 E<lt>nick@ing-simmons.netE<gt>
9194
9195 =item SEE ALSO
9196
9197 =item HISTORY
9198
9199 =back
9200
9201 =head1 PRAGMA DOCUMENTATION
9202
9203 =head2 attrs - set/get attributes of a subroutine (deprecated)
9204
9205 =over 4
9206
9207 =item SYNOPSIS
9208
9209 =item DESCRIPTION
9210
9211 method, locked
9212
9213 =back
9214
9215 =head2 re - Perl pragma to alter regular expression behaviour
9216
9217 =over 4
9218
9219 =item SYNOPSIS
9220
9221 =item DESCRIPTION
9222
9223 =back
9224
9225 =head2 threadshared::shared, threads::shared - Perl extension for sharing
9226 data structures between threads
9227
9228 =over 4
9229
9230 =item SYNOPSIS
9231
9232 =item DESCRIPTION
9233
9234 =item EXPORT
9235
9236 =item FUNCTIONS
9237
9238 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
9239 LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
9240 ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
9241
9242 =item NOTES
9243
9244 =item BUGS
9245
9246 =item AUTHOR
9247
9248 =item SEE ALSO
9249
9250 =back
9251
9252 =head2 threads - Perl extension allowing use of interpreter based threads
9253 from perl
9254
9255 =over 4
9256
9257 =item SYNOPSIS
9258
9259 =item DESCRIPTION
9260
9261 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
9262 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
9263 threads->list();, async BLOCK;
9264
9265 =item WARNINGS
9266
9267 A thread exited while %d other threads were still running
9268
9269 =item TODO
9270
9271 =item BUGS
9272
9273 Parent-Child threads, Returning objects, Creating threads inside BEGIN
9274 blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
9275
9276 =item AUTHOR and COPYRIGHT
9277
9278 =item SEE ALSO
9279
9280 =back
9281
9282 =head2 assertions - select assertions in blocks of code
9283
9284 =over 4
9285
9286 =item SYNOPSIS
9287
9288 =item DESCRIPTION
9289
9290 =item SEE ALSO
9291
9292 =item AUTHOR
9293
9294 =item COPYRIGHT AND LICENSE
9295
9296 =back
9297
9298 =head2 assertions::activate - activate assertions
9299
9300 =over 4
9301
9302 =item SYNOPSIS
9303
9304 =item DESCRIPTION
9305
9306 =item SEE ALSO
9307
9308 =item AUTHOR
9309
9310 =item COPYRIGHT AND LICENSE
9311
9312 =back
9313
9314 =head2 attributes - get/set subroutine or variable attributes
9315
9316 =over 4
9317
9318 =item SYNOPSIS
9319
9320 =item DESCRIPTION
9321
9322 =over 4
9323
9324 =item Built-in Attributes
9325
9326 locked, method, lvalue
9327
9328 =item Available Subroutines
9329
9330 get, reftype
9331
9332 =item Package-specific Attribute Handling
9333
9334 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
9335
9336 =item Syntax of Attribute Lists
9337
9338 =back
9339
9340 =item EXPORTS
9341
9342 =over 4
9343
9344 =item Default exports
9345
9346 =item Available exports
9347
9348 =item Export tags defined
9349
9350 =back
9351
9352 =item EXAMPLES
9353
9354 =item SEE ALSO
9355
9356 =back
9357
9358 =head2 autouse - postpone load of modules until a function is used
9359
9360 =over 4
9361
9362 =item SYNOPSIS
9363
9364 =item DESCRIPTION
9365
9366 =item WARNING
9367
9368 =item AUTHOR
9369
9370 =item SEE ALSO
9371
9372 =back
9373
9374 =head2 base - Establish IS-A relationship with base classes at compile time
9375
9376 =over 4
9377
9378 =item SYNOPSIS
9379
9380 =item DESCRIPTION
9381
9382 =item DIAGNOSTICS
9383
9384 Base class package "%s" is empty
9385
9386 =item HISTORY
9387
9388 =item CAVEATS
9389
9390 =item SEE ALSO
9391
9392 =back
9393
9394 =head2 bigint - Transparent BigInteger support for Perl
9395
9396 =over 4
9397
9398 =item SYNOPSIS
9399
9400 =item DESCRIPTION
9401
9402 =over 4
9403
9404 =item OPTIONS
9405
9406 a or accuracy, p or precision, t or trace, l or lib, v or version
9407
9408 =item MATH LIBRARY
9409
9410 =item INTERNAL FORMAT
9411
9412 =item SIGN
9413
9414 =item METHODS
9415
9416 =item CAVEAT
9417
9418 =back
9419
9420 =item MODULES USED
9421
9422 =item EXAMPLES
9423
9424 =item LICENSE
9425
9426 =item SEE ALSO
9427
9428 =item AUTHORS
9429
9430 =back
9431
9432 =head2 bignum - Transparent BigNumber support for Perl
9433
9434 =over 4
9435
9436 =item SYNOPSIS
9437
9438 =item DESCRIPTION
9439
9440 =over 4
9441
9442 =item OPTIONS
9443
9444 a or accuracy, p or precision, t or trace, l or lib, v or version
9445
9446 =item METHODS
9447
9448 =item CAVEAT
9449
9450 inf(), NaN(), upgrade()
9451
9452 =item MATH LIBRARY
9453
9454 =item INTERNAL FORMAT
9455
9456 =item SIGN
9457
9458 =back
9459
9460 =item MODULES USED
9461
9462 =item EXAMPLES
9463
9464 =item LICENSE
9465
9466 =item SEE ALSO
9467
9468 =item AUTHORS
9469
9470 =back
9471
9472 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
9473
9474 =over 4
9475
9476 =item SYNOPSIS
9477
9478 =item DESCRIPTION
9479
9480 =over 4
9481
9482 =item MODULES USED
9483
9484 =item MATH LIBRARY
9485
9486 =item SIGN
9487
9488 =item METHODS
9489
9490 =item CAVEAT
9491
9492 =back
9493
9494 =item EXAMPLES
9495
9496         perl -Mbigrat -le 'print sqrt(33)'
9497         perl -Mbigrat -le 'print 2*255'
9498         perl -Mbigrat -le 'print 4.5+2*255'
9499         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'       
9500         perl -Mbigrat -le 'print 12->is_odd()';
9501
9502 =item LICENSE
9503
9504 =item SEE ALSO
9505
9506 =item AUTHORS
9507
9508 =back
9509
9510 =head2 blib - Use MakeMaker's uninstalled version of a package
9511
9512 =over 4
9513
9514 =item SYNOPSIS
9515
9516 =item DESCRIPTION
9517
9518 =item BUGS
9519
9520 =item AUTHOR
9521
9522 =back
9523
9524 =head2 bytes - Perl pragma to force byte semantics rather than character
9525 semantics
9526
9527 =over 4
9528
9529 =item SYNOPSIS
9530
9531 =item DESCRIPTION
9532
9533 =item LIMITATIONS
9534
9535 =item SEE ALSO
9536
9537 =back
9538
9539 =head2 charnames - define character names for C<\N{named}> string literal
9540 escapes
9541
9542 =over 4
9543
9544 =item SYNOPSIS
9545
9546 =item DESCRIPTION
9547
9548 =item CUSTOM TRANSLATORS
9549
9550 =item CUSTOM ALIASES
9551
9552 =over 4
9553
9554 =item Anonymous hashes
9555
9556 =item Alias file
9557
9558 =item Alias shortcut
9559
9560 =back
9561
9562 =item charnames::viacode(code)
9563
9564 =item charnames::vianame(name)
9565
9566 =item ALIASES
9567
9568 =item ILLEGAL CHARACTERS
9569
9570 =item BUGS
9571
9572 =back
9573
9574 =head2 constant - Perl pragma to declare constants
9575
9576 =over 4
9577
9578 =item SYNOPSIS
9579
9580 =item DESCRIPTION
9581
9582 =item NOTES
9583
9584 =over 4
9585
9586 =item List constants
9587
9588 =item Defining multiple constants at once
9589
9590 =item Magic constants
9591
9592 =back
9593
9594 =item TECHNICAL NOTES
9595
9596 =item BUGS
9597
9598 =item AUTHOR
9599
9600 =item COPYRIGHT
9601
9602 =back
9603
9604 =head2 diagnostics, splain - produce verbose warning diagnostics
9605
9606 =over 4
9607
9608 =item SYNOPSIS
9609
9610 =item DESCRIPTION
9611
9612 =over 4
9613
9614 =item The C<diagnostics> Pragma
9615
9616 =item The I<splain> Program
9617
9618 =back
9619
9620 =item EXAMPLES
9621
9622 =item INTERNALS
9623
9624 =item BUGS
9625
9626 =item AUTHOR
9627
9628 =back
9629
9630 =head2 encoding - allows you to write your script in non-ascii or non-utf8
9631
9632 =over 4
9633
9634 =item SYNOPSIS
9635
9636 =item ABSTRACT
9637
9638 =over 4
9639
9640 =item Literal Conversions
9641
9642 =item PerlIO layers for C<STD(IN|OUT)>
9643
9644 =item Implicit upgrading for byte strings
9645
9646 =back
9647
9648 =item FEATURES THAT REQUIRE 5.8.1
9649
9650 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
9651
9652 =item USAGE
9653
9654 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
9655 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
9656
9657 =item The Filter Option
9658
9659 =over 4
9660
9661 =item Filter-related changes at Encode version 1.87
9662
9663 =back
9664
9665 =item CAVEATS
9666
9667 =over 4
9668
9669 =item NOT SCOPED
9670
9671 =item DO NOT MIX MULTIPLE ENCODINGS
9672
9673 =item tr/// with ranges
9674
9675 Legend of characters above
9676
9677 =back
9678
9679 =item EXAMPLE - Greekperl
9680
9681 =item KNOWN PROBLEMS
9682
9683 literals in regex that are longer than 127 bytes, EBCDIC, format
9684
9685 =item HISTORY
9686
9687 =item SEE ALSO
9688
9689 =back
9690
9691 =head2 fields - compile-time class fields
9692
9693 =over 4
9694
9695 =item SYNOPSIS
9696
9697 =item DESCRIPTION
9698
9699 new, phash
9700
9701 =item SEE ALSO
9702
9703 =back
9704
9705 =head2 filetest - Perl pragma to control the filetest permission operators
9706
9707 =over 4
9708
9709 =item SYNOPSIS
9710
9711 =item DESCRIPTION
9712
9713 =over 4
9714
9715 =item subpragma access
9716
9717 =back
9718
9719 =back
9720
9721 =head2 if - C<use> a Perl module if a condition holds
9722
9723 =over 4
9724
9725 =item SYNOPSIS
9726
9727 =item DESCRIPTION
9728
9729 =item BUGS
9730
9731 =item AUTHOR
9732
9733 =back
9734
9735 =head2 integer - Perl pragma to use integer arithmetic instead of floating
9736 point
9737
9738 =over 4
9739
9740 =item SYNOPSIS
9741
9742 =item DESCRIPTION
9743
9744 =back
9745
9746 =head2 less - perl pragma to request less of something from the compiler
9747
9748 =over 4
9749
9750 =item SYNOPSIS
9751
9752 =item DESCRIPTION
9753
9754 =back
9755
9756 =head2 lib - manipulate @INC at compile time
9757
9758 =over 4
9759
9760 =item SYNOPSIS
9761
9762 =item DESCRIPTION
9763
9764 =over 4
9765
9766 =item Adding directories to @INC
9767
9768 =item Deleting directories from @INC
9769
9770 =item Restoring original @INC
9771
9772 =back
9773
9774 =item CAVEATS
9775
9776 =item NOTES
9777
9778 =item SEE ALSO
9779
9780 =item AUTHOR
9781
9782 =back
9783
9784 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
9785 operations
9786
9787 =over 4
9788
9789 =item SYNOPSIS
9790
9791 =item DESCRIPTION
9792
9793 =back
9794
9795 =head2 open - perl pragma to set default PerlIO layers for input and output
9796
9797 =over 4
9798
9799 =item SYNOPSIS
9800
9801 =item DESCRIPTION
9802
9803 =item NONPERLIO FUNCTIONALITY
9804
9805 =item IMPLEMENTATION DETAILS
9806
9807 =item SEE ALSO
9808
9809 =back
9810
9811 =head2 ops - Perl pragma to restrict unsafe operations when compiling
9812
9813 =over 4
9814
9815 =item SYNOPSIS  
9816
9817 =item DESCRIPTION
9818
9819 =item SEE ALSO
9820
9821 =back
9822
9823 =head2 overload - Package for overloading perl operations
9824
9825 =over 4
9826
9827 =item SYNOPSIS
9828
9829 =item DESCRIPTION
9830
9831 =over 4
9832
9833 =item Declaration of overloaded functions
9834
9835 =item Calling Conventions for Binary Operations
9836
9837 FALSE, TRUE, C<undef>
9838
9839 =item Calling Conventions for Unary Operations
9840
9841 =item Calling Conventions for Mutators
9842
9843 C<++> and C<-->, C<x=> and other assignment versions
9844
9845 =item Overloadable Operations
9846
9847 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
9848 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
9849 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
9850
9851 =item Inheritance and overloading
9852
9853 Strings as values of C<use overload> directive, Overloading of an operation
9854 is inherited by derived classes
9855
9856 =back
9857
9858 =item SPECIAL SYMBOLS FOR C<use overload>
9859
9860 =over 4
9861
9862 =item Last Resort
9863
9864 =item Fallback
9865
9866 C<undef>, TRUE, defined, but FALSE
9867
9868 =item Copy Constructor
9869
9870 B<Example>
9871
9872 =back
9873
9874 =item MAGIC AUTOGENERATION
9875
9876 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
9877 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
9878 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
9879 I<Copy operator>
9880
9881 =item Losing overloading
9882
9883 =item Run-time Overloading
9884
9885 =item Public functions
9886
9887 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
9888
9889 =item Overloading constants
9890
9891 integer, float, binary, q, qr
9892
9893 =item IMPLEMENTATION
9894
9895 =item Metaphor clash
9896
9897 =item Cookbook
9898
9899 =over 4
9900
9901 =item Two-face scalars
9902
9903 =item Two-face references
9904
9905 =item Symbolic calculator
9906
9907 =item I<Really> symbolic calculator
9908
9909 =back
9910
9911 =item AUTHOR
9912
9913 =item DIAGNOSTICS
9914
9915 Odd number of arguments for overload::constant, `%s' is not an overloadable
9916 type, `%s' is not a code reference
9917
9918 =item BUGS
9919
9920 =back
9921
9922 =head2 sigtrap - Perl pragma to enable simple signal handling
9923
9924 =over 4
9925
9926 =item SYNOPSIS
9927
9928 =item DESCRIPTION
9929
9930 =item OPTIONS
9931
9932 =over 4
9933
9934 =item SIGNAL HANDLERS
9935
9936 B<stack-trace>, B<die>, B<handler> I<your-handler>
9937
9938 =item SIGNAL LISTS
9939
9940 B<normal-signals>, B<error-signals>, B<old-interface-signals>
9941
9942 =item OTHER
9943
9944 B<untrapped>, B<any>, I<signal>, I<number>
9945
9946 =back
9947
9948 =item EXAMPLES
9949
9950 =back
9951
9952 =head2 sort - perl pragma to control sort() behaviour
9953
9954 =over 4
9955
9956 =item SYNOPSIS
9957
9958 =item DESCRIPTION
9959
9960 =item CAVEATS
9961
9962 =back
9963
9964 =head2 strict - Perl pragma to restrict unsafe constructs
9965
9966 =over 4
9967
9968 =item SYNOPSIS
9969
9970 =item DESCRIPTION
9971
9972 C<strict refs>, C<strict vars>, C<strict subs>
9973
9974 =item HISTORY
9975
9976 =back
9977
9978 =head2 subs - Perl pragma to predeclare sub names
9979
9980 =over 4
9981
9982 =item SYNOPSIS
9983
9984 =item DESCRIPTION
9985
9986 =back
9987
9988 =head2 threadshared, threads::shared - Perl extension for sharing data
9989 structures between threads
9990
9991 =over 4
9992
9993 =item SYNOPSIS
9994
9995 =item DESCRIPTION
9996
9997 =item EXPORT
9998
9999 =item FUNCTIONS
10000
10001 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
10002 LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
10003 ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
10004
10005 =item NOTES
10006
10007 =item BUGS
10008
10009 =item AUTHOR
10010
10011 =item SEE ALSO
10012
10013 =back
10014
10015 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
10016 code
10017
10018 =over 4
10019
10020 =item SYNOPSIS
10021
10022 =item DESCRIPTION
10023
10024 =over 4
10025
10026 =item Utility functions
10027
10028 $num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[,
10029 FAIL_OK]), utf8::encode($string), utf8::decode($string), $flag =
10030 utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
10031
10032 =back
10033
10034 =item BUGS
10035
10036 =item SEE ALSO
10037
10038 =back
10039
10040 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
10041
10042 =over 4
10043
10044 =item SYNOPSIS
10045
10046 =item DESCRIPTION
10047
10048 =back
10049
10050 =head2 version - Perl extension for Version Objects
10051
10052 =over 4
10053
10054 =item SYNOPSIS
10055
10056 =item DESCRIPTION
10057
10058 =over 4
10059
10060 =item What IS a version
10061
10062 Numeric Versions, Quoted Versions
10063
10064 =item What about v-strings?
10065
10066 =item Numeric Versions
10067
10068 =item Quoted Versions
10069
10070 =item Object Methods
10071
10072 New Operator, qv(), Normal Form, Numification, Stringification, Comparison
10073 operators, Logical Operators
10074
10075 =item Quoting
10076
10077 =item Types of Versions Objects
10078
10079 Ordinary versions, Alpha versions
10080
10081 =item Replacement UNIVERSAL::VERSION
10082
10083 =back
10084
10085 =item EXPORT
10086
10087 =item AUTHOR
10088
10089 =item SEE ALSO
10090
10091 =back
10092
10093 =head2 vmsish - Perl pragma to control VMS-specific language features
10094
10095 =over 4
10096
10097 =item SYNOPSIS
10098
10099 =item DESCRIPTION
10100
10101 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
10102
10103 =back
10104
10105 =head2 warnings - Perl pragma to control optional warnings
10106
10107 =over 4
10108
10109 =item SYNOPSIS
10110
10111 =item DESCRIPTION
10112
10113 use warnings::register, warnings::enabled(), warnings::enabled($category),
10114 warnings::enabled($object), warnings::warn($message),
10115 warnings::warn($category, $message), warnings::warn($object, $message),
10116 warnings::warnif($message), warnings::warnif($category, $message),
10117 warnings::warnif($object, $message)
10118
10119 =back
10120
10121 =head2 warnings::register - warnings import function
10122
10123 =over 4
10124
10125 =item SYNOPSIS
10126
10127 =item DESCRIPTION
10128
10129 =back
10130
10131 =head1 MODULE DOCUMENTATION
10132
10133 =head2 AnyDBM_File - provide framework for multiple DBMs
10134
10135 =over 4
10136
10137 =item SYNOPSIS
10138
10139 =item DESCRIPTION
10140
10141 =over 4
10142
10143 =item DBM Comparisons
10144
10145 [0], [1], [2], [3]
10146
10147 =back
10148
10149 =item SEE ALSO
10150
10151 =back
10152
10153 =head2 Attribute::Handlers - Simpler definition of attribute handlers
10154
10155 =over 4
10156
10157 =item VERSION
10158
10159 =item SYNOPSIS
10160
10161 =item DESCRIPTION
10162
10163 [0], [1], [2], [3], [4], [5]
10164
10165 =over 4
10166
10167 =item Typed lexicals
10168
10169 =item Type-specific attribute handlers
10170
10171 =item Non-interpretive attribute handlers
10172
10173 =item Phase-specific attribute handlers
10174
10175 =item Attributes as C<tie> interfaces
10176
10177 =back
10178
10179 =item EXAMPLES
10180
10181 =item DIAGNOSTICS
10182
10183 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
10184 attributes>, C<Declaration of %s attribute in package %s may clash with
10185 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
10186 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
10187 be able to apply END handler>
10188
10189 =item AUTHOR
10190
10191 =item BUGS
10192
10193 =item COPYRIGHT
10194
10195 =back
10196
10197 =head2 AutoLoader - load subroutines only on demand
10198
10199 =over 4
10200
10201 =item SYNOPSIS
10202
10203 =item DESCRIPTION
10204
10205 =over 4
10206
10207 =item Subroutine Stubs
10208
10209 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
10210
10211 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
10212
10213 =item Package Lexicals
10214
10215 =item Not Using AutoLoader
10216
10217 =item B<AutoLoader> vs. B<SelfLoader>
10218
10219 =back
10220
10221 =item CAVEATS
10222
10223 =item SEE ALSO
10224
10225 =back
10226
10227 =head2 AutoSplit - split a package for autoloading
10228
10229 =over 4
10230
10231 =item SYNOPSIS
10232
10233 =item DESCRIPTION
10234
10235 $keep, $check, $modtime
10236
10237 =over 4
10238
10239 =item Multiple packages
10240
10241 =back
10242
10243 =item DIAGNOSTICS
10244
10245 =back
10246
10247 =head2 B - The Perl Compiler
10248
10249 =over 4
10250
10251 =item SYNOPSIS
10252
10253 =item DESCRIPTION
10254
10255 =item OVERVIEW
10256
10257 =item Utility Functions
10258
10259 =over 4
10260
10261 =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV>
10262 objects
10263
10264 sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av,
10265 check_av, begin_av, end_av, comppadlist, regex_padav, main_cv
10266
10267 =item Functions for Examining the Symbol Table
10268
10269 walksymtable(SYMREF, METHOD, RECURSE, PREFIX)
10270
10271 =item Functions Returning C<B::OP> objects or for walking op trees
10272
10273 main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG)
10274
10275 =item Miscellaneous Utility Functions
10276
10277 ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR),
10278 perlstring(STR), class(OBJ), threadsv_names
10279
10280 =back
10281
10282 =item OVERVIEW OF CLASSES
10283
10284 =over 4
10285
10286 =item SV-RELATED CLASSES
10287
10288 =item B::SV Methods
10289
10290 REFCNT, FLAGS, object_2svref
10291
10292 =item B::IV Methods
10293
10294 IV, IVX, UVX, int_value, needs64bits, packiv
10295
10296 =item B::NV Methods
10297
10298 NV, NVX
10299
10300 =item B::RV Methods
10301
10302 RV
10303
10304 =item B::PV Methods
10305
10306 PV, RV, PVX
10307
10308 =item B::PVMG Methods
10309
10310 MAGIC, SvSTASH
10311
10312 =item B::MAGIC Methods
10313
10314 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
10315
10316 =item B::PVLV Methods
10317
10318 TARGOFF, TARGLEN, TYPE, TARG
10319
10320 =item B::BM Methods
10321
10322 USEFUL, PREVIOUS, RARE, TABLE
10323
10324 =item B::GV Methods
10325
10326 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
10327 LINE, FILE, FILEGV, GvREFCNT, FLAGS
10328
10329 =item B::IO Methods
10330
10331 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
10332 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
10333
10334 =item B::AV Methods
10335
10336 FILL, MAX, OFF, ARRAY, ARRAYelt, AvFLAGS
10337
10338 =item B::CV Methods
10339
10340 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB,
10341 XSUBANY, CvFLAGS, const_sv
10342
10343 =item B::HV Methods
10344
10345 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
10346
10347 =item OP-RELATED CLASSES
10348
10349 =item B::OP Methods
10350
10351 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
10352
10353 =item B::UNOP METHOD
10354
10355 first
10356
10357 =item B::BINOP METHOD
10358
10359 last
10360
10361 =item B::LOGOP METHOD
10362
10363 other
10364
10365 =item B::LISTOP METHOD
10366
10367 children
10368
10369 =item B::PMOP Methods
10370
10371 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
10372 pmpermflags, precomp, pmoffset
10373
10374 =item B::SVOP METHOD
10375
10376 sv, gv
10377
10378 =item B::PADOP METHOD
10379
10380 padix
10381
10382 =item B::PVOP METHOD
10383
10384 pv
10385
10386 =item B::LOOP Methods
10387
10388 redoop, nextop, lastop
10389
10390 =item B::COP Methods
10391
10392 label, stash, stashpv, file, cop_seq, arybase, line, warnings, io
10393
10394 =back
10395
10396 =item AUTHOR
10397
10398 =back
10399
10400 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
10401 bytecode
10402
10403 =over 4
10404
10405 =item SYNOPSIS
10406
10407 =item DESCRIPTION
10408
10409 %insn_data, @insn_name, @optype, @specialsv_name
10410
10411 =item AUTHOR
10412
10413 =back
10414
10415 =head2 B::Assembler - Assemble Perl bytecode
10416
10417 =over 4
10418
10419 =item SYNOPSIS
10420
10421 =item DESCRIPTION
10422
10423 =item AUTHORS
10424
10425 =back
10426
10427 =head2 B::Bblock - Walk basic blocks
10428
10429 =over 4
10430
10431 =item SYNOPSIS
10432
10433 =item DESCRIPTION
10434
10435 =over 4
10436
10437 =item Functions
10438
10439 B<find_leaders>
10440
10441 =back
10442
10443 =item AUTHOR
10444
10445 =back
10446
10447 =head2 B::Bytecode - Perl compiler's bytecode backend
10448
10449 =over 4
10450
10451 =item SYNOPSIS
10452
10453 =item DESCRIPTION
10454
10455 =item EXAMPLE
10456
10457 =item OPTIONS
10458
10459 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
10460
10461 =item KNOWN BUGS
10462
10463 =item NOTICE
10464
10465 =item AUTHORS
10466
10467 =back
10468
10469 =head2 B::C - Perl compiler's C backend
10470
10471 =over 4
10472
10473 =item SYNOPSIS
10474
10475 =item DESCRIPTION
10476
10477 =item OPTIONS
10478
10479 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
10480 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
10481 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
10482 B<-llimit>
10483
10484 =item EXAMPLES
10485
10486 =item BUGS
10487
10488 =item AUTHOR
10489
10490 =back
10491
10492 =head2 B::CC - Perl compiler's optimized C translation backend
10493
10494 =over 4
10495
10496 =item SYNOPSIS
10497
10498 =item DESCRIPTION
10499
10500 =item OPTIONS
10501
10502 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
10503 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
10504 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
10505
10506 =item EXAMPLES
10507
10508 =item BUGS
10509
10510 =item DIFFERENCES
10511
10512 =over 4
10513
10514 =item Loops
10515
10516 =item Context of ".."
10517
10518 =item Arithmetic
10519
10520 =item Deprecated features
10521
10522 =back
10523
10524 =item AUTHOR
10525
10526 =back
10527
10528 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
10529
10530 =over 4
10531
10532 =item SYNOPSIS
10533
10534 =item DESCRIPTION
10535
10536 =item EXAMPLE
10537
10538 =item OPTIONS
10539
10540 =over 4
10541
10542 =item Options for Opcode Ordering
10543
10544 B<-basic>, B<-exec>, B<-tree>
10545
10546 =item Options for Line-Style
10547
10548 B<-concise>, B<-terse>, B<-linenoise>, B<-debug>, B<-env>
10549
10550 =item Options for tree-specific formatting
10551
10552 B<-compact>, B<-loose>, B<-vt>, B<-ascii>
10553
10554 =item Options controlling sequence numbering
10555
10556 B<-base>I<n>, B<-bigendian>, B<-littleendian>
10557
10558 =item Other options
10559
10560 B<-main>, B<-nomain>, B<-nobanner>, B<-banner>, B<-banneris> => subref
10561
10562 =item Option Stickiness
10563
10564 =back
10565
10566 =item ABBREVIATIONS
10567
10568 =over 4
10569
10570 =item OP class abbreviations
10571
10572 =item OP flags abbreviations
10573
10574 =back
10575
10576 =item FORMATTING SPECIFICATIONS
10577
10578 =over 4
10579
10580 =item Special Patterns
10581
10582 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
10583 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
10584 B<~>
10585
10586 =item # Variables
10587
10588 B<#>I<var>, B<#>I<var>I<N>, B<#>I<Var>, B<#addr>, B<#arg>, B<#class>,
10589 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
10590 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
10591 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
10592 B<#seq>, B<#opt>, B<#static>, B<#sibaddr>, B<#svaddr>, B<#svclass>,
10593 B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
10594
10595 =back
10596
10597 =item Using B::Concise outside of the O framework
10598
10599 =over 4
10600
10601 =item Example: Altering Concise Renderings
10602
10603 =item set_style()
10604
10605 =item set_style_standard($name)
10606
10607 =item add_style()
10608
10609 =item add_callback()
10610
10611 =item Running B::Concise::compile()
10612
10613 =item B::Concise::reset_sequence()
10614
10615 =item Errors
10616
10617 =back
10618
10619 =item AUTHOR
10620
10621 =back
10622
10623 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
10624
10625 =over 4
10626
10627 =item SYNOPSIS
10628
10629 =item DESCRIPTION
10630
10631 =item AUTHOR
10632
10633 =back
10634
10635 =head2 B::Deparse - Perl compiler backend to produce perl code
10636
10637 =over 4
10638
10639 =item SYNOPSIS
10640
10641 =item DESCRIPTION
10642
10643 =item OPTIONS
10644
10645 B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>,
10646 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
10647
10648 =item USING B::Deparse AS A MODULE
10649
10650 =over 4
10651
10652 =item Synopsis
10653
10654 =item Description
10655
10656 =item new
10657
10658 =item ambient_pragmas
10659
10660 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
10661
10662 =item coderef2text
10663
10664 =back
10665
10666 =item BUGS
10667
10668 =item AUTHOR
10669
10670 =back
10671
10672 =head2 B::Disassembler - Disassemble Perl bytecode
10673
10674 =over 4
10675
10676 =item SYNOPSIS
10677
10678 =item DESCRIPTION
10679
10680 =item AUTHOR
10681
10682 =back
10683
10684 =head2 B::Lint - Perl lint
10685
10686 =over 4
10687
10688 =item SYNOPSIS
10689
10690 =item DESCRIPTION
10691
10692 =item OPTIONS AND LINT CHECKS
10693
10694 B<context>, B<implicit-read> and B<implicit-write>, B<bare-subs>,
10695 B<dollar-underscore>, B<private-names>, B<undefined-subs>,
10696 B<regexp-variables>, B<all>, B<none>
10697
10698 =item NON LINT-CHECK OPTIONS
10699
10700 B<-u Package>
10701
10702 =item BUGS
10703
10704 =item AUTHOR
10705
10706 =back
10707
10708 =head2 B::O, O - Generic interface to Perl Compiler backends
10709
10710 =over 4
10711
10712 =item SYNOPSIS
10713
10714 =item DESCRIPTION
10715
10716 =item CONVENTIONS
10717
10718 =item IMPLEMENTATION
10719
10720 =item BUGS
10721
10722 =item AUTHOR
10723
10724 =back
10725
10726 =head2 B::Showlex - Show lexical variables used in functions or files
10727
10728 =over 4
10729
10730 =item SYNOPSIS
10731
10732 =item DESCRIPTION
10733
10734 =item AUTHOR
10735
10736 =back
10737
10738 =head2 B::Stackobj - Helper module for CC backend
10739
10740 =over 4
10741
10742 =item SYNOPSIS
10743
10744 =item DESCRIPTION
10745
10746 =item AUTHOR
10747
10748 =back
10749
10750 =head2 B::Stash - show what stashes are loaded
10751
10752 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
10753
10754 =over 4
10755
10756 =item SYNOPSIS
10757
10758 =item DESCRIPTION
10759
10760 =item AUTHOR
10761
10762 =back
10763
10764 =head2 B::Xref - Generates cross reference reports for Perl programs
10765
10766 =over 4
10767
10768 =item SYNOPSIS
10769
10770 =item DESCRIPTION
10771
10772 =item OPTIONS
10773
10774 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
10775
10776 =item BUGS
10777
10778 =item AUTHOR
10779
10780 =back
10781
10782 =head2 Bblock, B::Bblock - Walk basic blocks
10783
10784 =over 4
10785
10786 =item SYNOPSIS
10787
10788 =item DESCRIPTION
10789
10790 =over 4
10791
10792 =item Functions
10793
10794 B<find_leaders>
10795
10796 =back
10797
10798 =item AUTHOR
10799
10800 =back
10801
10802 =head2 Benchmark - benchmark running times of Perl code
10803
10804 =over 4
10805
10806 =item SYNOPSIS
10807
10808 =item DESCRIPTION
10809
10810 =over 4
10811
10812 =item Methods
10813
10814 new, debug, iters
10815
10816 =item Standard Exports
10817
10818 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
10819 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
10820 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
10821
10822 =item Optional Exports
10823
10824 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [
10825 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
10826 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
10827
10828 =item :hireswallclock
10829
10830 =back
10831
10832 =item NOTES
10833
10834 =item EXAMPLES
10835
10836 =item INHERITANCE
10837
10838 =item CAVEATS
10839
10840 =item SEE ALSO
10841
10842 =item AUTHORS
10843
10844 =item MODIFICATION HISTORY
10845
10846 =back
10847
10848 =head2 ByteLoader - load byte compiled perl code
10849
10850 =over 4
10851
10852 =item SYNOPSIS
10853
10854 =item DESCRIPTION
10855
10856 =item AUTHOR
10857
10858 =item SEE ALSO
10859
10860 =back
10861
10862 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
10863
10864 =over 4
10865
10866 =item SYNOPSIS
10867
10868 =item DESCRIPTION
10869
10870 =item EXAMPLE
10871
10872 =item OPTIONS
10873
10874 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
10875
10876 =item KNOWN BUGS
10877
10878 =item NOTICE
10879
10880 =item AUTHORS
10881
10882 =back
10883
10884 =head2 CGI - Simple Common Gateway Interface Class
10885
10886 =over 4
10887
10888 =item SYNOPSIS
10889
10890 =item ABSTRACT
10891
10892 =item DESCRIPTION
10893
10894 =over 4
10895
10896 =item PROGRAMMING STYLE
10897
10898 =item CALLING CGI.PM ROUTINES
10899
10900 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
10901
10902 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
10903
10904 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
10905
10906 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
10907
10908 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
10909
10910 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
10911
10912 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
10913
10914 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
10915
10916 =item DELETING A PARAMETER COMPLETELY:
10917
10918 =item DELETING ALL PARAMETERS:
10919
10920 =item DIRECT ACCESS TO THE PARAMETER LIST:
10921
10922 =item FETCHING THE PARAMETER LIST AS A HASH:
10923
10924 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
10925
10926 =item RETRIEVING CGI ERRORS
10927
10928 =item USING THE FUNCTION-ORIENTED INTERFACE
10929
10930 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
10931 B<:standard>, B<:all>
10932
10933 =item PRAGMAS
10934
10935 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
10936 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
10937 -private_tempfiles
10938
10939 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
10940
10941 1. start_table() (generates a <table> tag), 2. end_table() (generates a
10942 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
10943 a </ul> tag)
10944
10945 =back
10946
10947 =item GENERATING DYNAMIC DOCUMENTS
10948
10949 =over 4
10950
10951 =item CREATING A STANDARD HTTP HEADER:
10952
10953 =item GENERATING A REDIRECTION HEADER
10954
10955 =item CREATING THE HTML DOCUMENT HEADER
10956
10957 B<Parameters:>, 4, 5, 6..
10958
10959 =item ENDING THE HTML DOCUMENT:
10960
10961 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
10962
10963 =item OBTAINING THE SCRIPT'S URL
10964
10965 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
10966 (B<-query_string>), B<-base>
10967
10968 =item MIXING POST AND URL PARAMETERS
10969
10970 =back
10971
10972 =item CREATING STANDARD HTML ELEMENTS:
10973
10974 =over 4
10975
10976 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
10977
10978 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
10979
10980 =item HTML SHORTCUTS AND LIST INTERPOLATION
10981
10982 =item NON-STANDARD HTML SHORTCUTS
10983
10984 =item AUTOESCAPING HTML
10985
10986 $escaped_string = escapeHTML("unescaped string");, $charset =
10987 charset([$charset]);, $flag = autoEscape([$flag]);
10988
10989 =item PRETTY-PRINTING HTML
10990
10991 =back
10992
10993 =item CREATING FILL-OUT FORMS:
10994
10995 =over 4
10996
10997 =item CREATING AN ISINDEX TAG
10998
10999 =item STARTING AND ENDING A FORM
11000
11001 B<application/x-www-form-urlencoded>, B<multipart/form-data>
11002
11003 =item CREATING A TEXT FIELD
11004
11005 B<Parameters>
11006
11007 =item CREATING A BIG TEXT FIELD
11008
11009 =item CREATING A PASSWORD FIELD
11010
11011 =item CREATING A FILE UPLOAD FIELD
11012
11013 B<Parameters>
11014
11015 =item CREATING A POPUP MENU
11016
11017 =item CREATING AN OPTION GROUP
11018
11019 =item CREATING A SCROLLING LIST
11020
11021 B<Parameters:>
11022
11023 =item CREATING A GROUP OF RELATED CHECKBOXES
11024
11025 B<Parameters:>
11026
11027 =item CREATING A STANDALONE CHECKBOX
11028
11029 B<Parameters:>
11030
11031 =item CREATING A RADIO BUTTON GROUP
11032
11033 B<Parameters:>
11034
11035 =item CREATING A SUBMIT BUTTON 
11036
11037 B<Parameters:>
11038
11039 =item CREATING A RESET BUTTON
11040
11041 =item CREATING A DEFAULT BUTTON
11042
11043 =item CREATING A HIDDEN FIELD
11044
11045 B<Parameters:>
11046
11047 =item CREATING A CLICKABLE IMAGE BUTTON
11048
11049 B<Parameters:>, 3. The third option (-align, optional) is an alignment
11050 type, and may be TOP, BOTTOM or MIDDLE
11051
11052 =item CREATING A JAVASCRIPT ACTION BUTTON
11053
11054 =back
11055
11056 =item HTTP COOKIES
11057
11058 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
11059 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
11060
11061 =item WORKING WITH FRAMES
11062
11063 1. Create a <Frameset> document, 2. Specify the destination for the
11064 document in the HTTP header, 3. Specify the destination for the document in
11065 the <form> tag
11066
11067 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
11068
11069 =item DEBUGGING
11070
11071 =over 4
11072
11073 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
11074
11075 =back
11076
11077 =item FETCHING ENVIRONMENT VARIABLES
11078
11079 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
11080 B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
11081 name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
11082 ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
11083 B<virtual_port ()>, B<server_software ()>, B<remote_user ()>, B<user_name
11084 ()>, B<request_method()>, B<content_type()>, B<http()>, B<https()>
11085
11086 =item USING NPH SCRIPTS
11087
11088 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
11089 parameters
11090
11091 =item Server Push
11092
11093 multipart_init(), multipart_start(), multipart_end(), multipart_final()
11094
11095 =item Avoiding Denial of Service Attacks
11096
11097 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
11098 basis>, B<2. Globally for all scripts>
11099
11100 =item COMPATIBILITY WITH CGI-LIB.PL
11101
11102 =item AUTHOR INFORMATION
11103
11104 =item CREDITS
11105
11106 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
11107 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
11108 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
11109 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
11110 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
11111 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
11112 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
11113 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
11114 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
11115 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
11116 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
11117 ...and many many more..
11118
11119 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
11120
11121 =item BUGS
11122
11123 =item SEE ALSO
11124
11125 =back
11126
11127 =head2 CGI::Apache - Backward compatibility module for CGI.pm
11128
11129 =over 4
11130
11131 =item SYNOPSIS
11132
11133 =item ABSTRACT
11134
11135 =item DESCRIPTION
11136
11137 =item AUTHOR INFORMATION
11138
11139 =item BUGS
11140
11141 =item SEE ALSO
11142
11143 =back
11144
11145 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
11146 other) error log
11147
11148 =over 4
11149
11150 =item SYNOPSIS
11151
11152 =item DESCRIPTION
11153
11154 =item REDIRECTING ERROR MESSAGES
11155
11156 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
11157
11158 =over 4
11159
11160 =item Changing the default message
11161
11162 =back
11163
11164 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
11165
11166 =item OVERRIDING THE NAME OF THE PROGRAM
11167
11168 =item AUTHORS
11169
11170 =item SEE ALSO
11171
11172 =back
11173
11174 =head2 CGI::Cookie - Interface to Netscape Cookies
11175
11176 =over 4
11177
11178 =item SYNOPSIS
11179
11180 =item DESCRIPTION
11181
11182 =item USING CGI::Cookie
11183
11184 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
11185
11186 =over 4
11187
11188 =item Creating New Cookies
11189
11190 =item Sending the Cookie to the Browser
11191
11192 =item Recovering Previous Cookies
11193
11194 =item Manipulating Cookies
11195
11196 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
11197
11198 =back
11199
11200 =item AUTHOR INFORMATION
11201
11202 =item BUGS
11203
11204 =item SEE ALSO
11205
11206 =back
11207
11208 =head2 CGI::Fast - CGI Interface for Fast CGI
11209
11210 =over 4
11211
11212 =item SYNOPSIS
11213
11214 =item DESCRIPTION
11215
11216 =item OTHER PIECES OF THE PUZZLE
11217
11218 =item WRITING FASTCGI PERL SCRIPTS
11219
11220 =item INSTALLING FASTCGI SCRIPTS
11221
11222 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
11223
11224 =item EXTERNAL FASTCGI SERVER INVOCATION
11225
11226 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
11227
11228 =item CAVEATS
11229
11230 =item AUTHOR INFORMATION
11231
11232 =item BUGS
11233
11234 =item SEE ALSO
11235
11236 =back
11237
11238 =head2 CGI::Pretty - module to produce nicely formatted HTML code
11239
11240 =over 4
11241
11242 =item SYNOPSIS
11243
11244 =item DESCRIPTION
11245
11246 =over 4
11247
11248 =item Tags that won't be formatted
11249
11250 =item Customizing the Indenting
11251
11252 =back
11253
11254 =item BUGS
11255
11256 =item AUTHOR
11257
11258 =item SEE ALSO
11259
11260 =back
11261
11262 =head2 CGI::Push - Simple Interface to Server Push
11263
11264 =over 4
11265
11266 =item SYNOPSIS
11267
11268 =item DESCRIPTION
11269
11270 =item USING CGI::Push
11271
11272 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
11273
11274 =over 4
11275
11276 =item Heterogeneous Pages
11277
11278 =item Changing the Page Delay on the Fly
11279
11280 =back
11281
11282 =item INSTALLING CGI::Push SCRIPTS
11283
11284 =item AUTHOR INFORMATION
11285
11286 =item BUGS
11287
11288 =item SEE ALSO
11289
11290 =back
11291
11292 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
11293
11294 =over 4
11295
11296 =item SYNOPSIS
11297
11298 =item ABSTRACT
11299
11300 =item DESCRIPTION
11301
11302 =item AUTHOR INFORMATION
11303
11304 =item BUGS
11305
11306 =item SEE ALSO
11307
11308 =back
11309
11310 =head2 CGI::Util - Internal utilities used by CGI module
11311
11312 =over 4
11313
11314 =item SYNOPSIS
11315
11316 =item DESCRIPTION
11317
11318 =item AUTHOR INFORMATION
11319
11320 =item SEE ALSO
11321
11322 =back
11323
11324 =head2 CPAN - query, download and build perl modules from CPAN sites
11325
11326 =over 4
11327
11328 =item SYNOPSIS
11329
11330 =item STATUS
11331
11332 =item DESCRIPTION
11333
11334 =over 4
11335
11336 =item Interactive Mode
11337
11338 Searching for authors, bundles, distribution files and modules, make, test,
11339 install, clean  modules or distributions, get, readme, look module or
11340 distribution, ls author, Signals
11341
11342 =item CPAN::Shell
11343
11344 =item autobundle
11345
11346 =item recompile
11347
11348 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
11349
11350 =item Programmer's interface
11351
11352 expand($type,@things), expandany(@things), Programming Examples
11353
11354 =item Methods in the other Classes
11355
11356 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
11357 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
11358 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
11359 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
11360 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
11361 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
11362 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
11363 CPAN::Bundle::readme(), CPAN::Bundle::test(),
11364 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
11365 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
11366 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
11367 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
11368 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
11369 CPAN::Distribution::look(), CPAN::Distribution::make(),
11370 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
11371 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
11372 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
11373 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
11374 CPAN::Module::clean(), CPAN::Module::cpan_file(),
11375 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
11376 CPAN::Module::description(), CPAN::Module::force($method,@args),
11377 CPAN::Module::get(), CPAN::Module::inst_file(),
11378 CPAN::Module::inst_version(), CPAN::Module::install(),
11379 CPAN::Module::look(), CPAN::Module::make(),
11380 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
11381 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
11382
11383 =item Cache Manager
11384
11385 =item Bundles
11386
11387 =item Prerequisites
11388
11389 =item Finding packages and VERSION
11390
11391 =item Debugging
11392
11393 =item Floppy, Zip, Offline Mode
11394
11395 =back
11396
11397 =item CONFIGURATION
11398
11399 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
11400 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
11401 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
11402 [unshift|push|splice] E<lt>listE<gt>>
11403
11404 =over 4
11405
11406 =item Note on urllist parameter's format
11407
11408 =item urllist parameter has CD-ROM support
11409
11410 =back
11411
11412 =item SECURITY
11413
11414 =item EXPORT
11415
11416 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
11417
11418 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
11419
11420 =over 4
11421
11422 =item Three basic types of firewalls
11423
11424 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
11425
11426 =item Configuring lynx or ncftp for going through a firewall
11427
11428 =back
11429
11430 =item FAQ
11431
11432 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
11433
11434 =item BUGS
11435
11436 =item AUTHOR
11437
11438 =item TRANSLATIONS
11439
11440 =item SEE ALSO
11441
11442 =back
11443
11444 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
11445
11446 =over 4
11447
11448 =item SYNOPSIS
11449
11450 =item DESCRIPTION
11451
11452 =back
11453
11454 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
11455 module
11456
11457 =over 4
11458
11459 =item SYNOPSIS
11460
11461 =item DESCRIPTION
11462
11463 =item  SEE ALSO
11464
11465 =back
11466
11467 =head2 Carp, carp    - warn of errors (from perspective of caller)
11468
11469 =over 4
11470
11471 =item SYNOPSIS
11472
11473 =item DESCRIPTION
11474
11475 =over 4
11476
11477 =item Forcing a Stack Trace
11478
11479 =back
11480
11481 =item BUGS
11482
11483 =back
11484
11485 =head2 Carp::Heavy - heavy machinery, no user serviceable parts inside
11486
11487 =head2 Class::ISA -- report the search path for a class's ISA tree
11488
11489 =over 4
11490
11491 =item SYNOPSIS
11492
11493 =item DESCRIPTION
11494
11495 =item FUNCTIONS
11496
11497 the function Class::ISA::super_path($CLASS), the function
11498 Class::ISA::self_and_super_path($CLASS), the function
11499 Class::ISA::self_and_super_versions($CLASS)
11500
11501 =item CAUTIONARY NOTES
11502
11503 =item COPYRIGHT
11504
11505 =item AUTHOR
11506
11507 =back
11508
11509 =head2 Class::Struct - declare struct-like datatypes as Perl classes
11510
11511 =over 4
11512
11513 =item SYNOPSIS
11514
11515 =item DESCRIPTION
11516
11517 =over 4
11518
11519 =item The C<struct()> function
11520
11521 =item Class Creation at Compile Time
11522
11523 =item Element Types and Accessor Methods
11524
11525 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
11526 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
11527
11528 =item Initializing with C<new>
11529
11530 =back
11531
11532 =item EXAMPLES
11533
11534 Example 1, Example 2, Example 3
11535
11536 =item Author and Modification History
11537
11538 =back
11539
11540 =head2 Config - access Perl configuration information
11541
11542 =over 4
11543
11544 =item SYNOPSIS
11545
11546 =item DESCRIPTION
11547
11548 myconfig(), config_sh(), config_re($regex), config_vars(@names)
11549
11550 =item EXAMPLE
11551
11552 =item WARNING
11553
11554 =item GLOSSARY
11555
11556 =over 4
11557
11558 =item _
11559
11560 C<_a>, C<_exe>, C<_o>
11561
11562 =item a
11563
11564 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
11565 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
11566 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
11567 C<asctime_r_proto>, C<awk>
11568
11569 =item b
11570
11571 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
11572
11573 =item c
11574
11575 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
11576 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
11577 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
11578 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
11579 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
11580 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
11581 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
11582
11583 =item d
11584
11585 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>,
11586 C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>,
11587 C<d_bcmp>, C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>,
11588 C<d_bzero>, C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>,
11589 C<d_chroot>, C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>,
11590 C<d_const>, C<d_copysignl>, C<d_crypt>, C<d_crypt_r>, C<d_csh>,
11591 C<d_ctermid_r>, C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>,
11592 C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>, C<d_dirnamlen>, C<d_dlerror>,
11593 C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, C<d_drand48_r>, C<d_drand48proto>,
11594 C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endgrent_r>, C<d_endhent>,
11595 C<d_endhostent_r>, C<d_endnent>, C<d_endnetent_r>, C<d_endpent>,
11596 C<d_endprotoent_r>, C<d_endpwent>, C<d_endpwent_r>, C<d_endsent>,
11597 C<d_endservent_r>, C<d_eofnblk>, C<d_eunice>, C<d_faststdio>, C<d_fchdir>,
11598 C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>,
11599 C<d_fd_set>, C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>,
11600 C<d_flexfnam>, C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>,
11601 C<d_fpathconf>, C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>,
11602 C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>,
11603 C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>, C<d_ftime>,
11604 C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>,
11605 C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>,
11606 C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
11607 C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>,
11608 C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>,
11609 C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>,
11610 C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>,
11611 C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
11612 C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
11613 C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>,
11614 C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
11615 C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>,
11616 C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>,
11617 C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>,
11618 C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
11619 C<d_htonl>, C<d_ilogbl>, C<d_index>, C<d_inetaton>, C<d_int64_t>,
11620 C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>,
11621 C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>,
11622 C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>,
11623 C<d_lstat>, C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>,
11624 C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>,
11625 C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>,
11626 C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>,
11627 C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>,
11628 C<d_msg_peek>, C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>,
11629 C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>,
11630 C<d_nice>, C<d_nl_langinfo>, C<d_nv_preserves_uv>, C<d_off64_t>,
11631 C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
11632 C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
11633 C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
11634 C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
11635 C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>,
11636 C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, C<d_pthread_atfork>,
11637 C<d_pthread_attr_setscope>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
11638 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
11639 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
11640 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
11641 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
11642 C<d_sanemcmp>, C<d_sbrkproto>, C<d_scalbnl>, C<d_sched_yield>,
11643 C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>,
11644 C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>,
11645 C<d_semop>, C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>,
11646 C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>,
11647 C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>,
11648 C<d_setnent>, C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>,
11649 C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>,
11650 C<d_setpwent>, C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>,
11651 C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>,
11652 C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>,
11653 C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>,
11654 C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>,
11655 C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>,
11656 C<d_socks5_init>, C<d_sqrtl>, C<d_srand48_r>, C<d_srandom_r>,
11657 C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>,
11658 C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
11659 C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>,
11660 C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>,
11661 C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strerror_r>,
11662 C<d_strftime>, C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>,
11663 C<d_strtoq>, C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>,
11664 C<d_suidsafe>, C<d_symlink>, C<d_syscall>, C<d_syscallproto>, C<d_sysconf>,
11665 C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>,
11666 C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>,
11667 C<d_tm_tm_gmtoff>, C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>,
11668 C<d_ttyname_r>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>,
11669 C<d_uname>, C<d_union_semun>, C<d_unordered>, C<d_usleep>,
11670 C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>,
11671 C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>, C<d_void_closedir>,
11672 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
11673 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
11674 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
11675 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
11676 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
11677
11678 =item e
11679
11680 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
11681 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
11682 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
11683 C<expr>, C<extensions>, C<extras>
11684
11685 =item f
11686
11687 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
11688 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
11689 C<full_sed>
11690
11691 =item g
11692
11693 C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>,
11694 C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>,
11695 C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>,
11696 C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>,
11697 C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>,
11698 C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>,
11699 C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>,
11700 C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>,
11701 C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>,
11702 C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
11703
11704 =item h
11705
11706 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>,
11707 C<html3dir>, C<html3direxp>
11708
11709 =item i
11710
11711 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
11712 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
11713 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
11714 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
11715 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
11716 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
11717 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
11718 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
11719 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
11720 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
11721 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
11722 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
11723 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
11724 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
11725 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
11726 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
11727 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
11728 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
11729 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installhtml1dir>,
11730 C<installhtml3dir>, C<installman1dir>, C<installman3dir>, C<installprefix>,
11731 C<installprefixexp>, C<installprivlib>, C<installscript>,
11732 C<installsitearch>, C<installsitebin>, C<installsitehtml1dir>,
11733 C<installsitehtml3dir>, C<installsitelib>, C<installsiteman1dir>,
11734 C<installsiteman3dir>, C<installsitescript>, C<installstyle>,
11735 C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>,
11736 C<installvendorhtml1dir>, C<installvendorhtml3dir>, C<installvendorlib>,
11737 C<installvendorman1dir>, C<installvendorman3dir>, C<installvendorscript>,
11738 C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
11739
11740 =item k
11741
11742 C<known_extensions>, C<ksh>
11743
11744 =item l
11745
11746 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
11747 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
11748 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
11749 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
11750 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
11751 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
11752 C<lseektype>
11753
11754 =item m
11755
11756 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
11757 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
11758 C<man3direxp>, C<man3ext>
11759
11760 =item M
11761
11762 C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>,
11763 C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>,
11764 C<myuname>
11765
11766 =item n
11767
11768 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
11769 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
11770 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
11771 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
11772 C<nvsize>, C<nvtype>
11773
11774 =item o
11775
11776 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
11777 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
11778
11779 =item p
11780
11781 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
11782 C<perl>, C<perl_patchlevel>
11783
11784 =item P
11785
11786 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
11787 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
11788 C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>,
11789 C<procselfexe>, C<prototype>, C<ptrsize>
11790
11791 =item q
11792
11793 C<quadkind>, C<quadtype>
11794
11795 =item r
11796
11797 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
11798 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
11799 C<rmail>, C<run>, C<runnm>
11800
11801 =item s
11802
11803 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
11804 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
11805 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
11806 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
11807 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
11808 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
11809 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
11810 C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>,
11811 C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>,
11812 C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>,
11813 C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>,
11814 C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>,
11815 C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>,
11816 C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>,
11817 C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>,
11818 C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>,
11819 C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>,
11820 C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>,
11821 C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>,
11822 C<submit>, C<subversion>, C<sysman>
11823
11824 =item t
11825
11826 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
11827 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
11828 C<ttyname_r_proto>
11829
11830 =item u
11831
11832 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
11833 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
11834 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
11835 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>,
11836 C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemorebits>,
11837 C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>,
11838 C<useposix>, C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>,
11839 C<usethreads>, C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>,
11840 C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>,
11841 C<uvXUformat>
11842
11843 =item v
11844
11845 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
11846 C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>,
11847 C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>,
11848 C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>,
11849 C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>,
11850 C<vendorscriptexp>, C<version>, C<version_patchlevel_string>,
11851 C<versiononly>, C<vi>, C<voidflags>
11852
11853 =item x
11854
11855 C<xlibpth>
11856
11857 =item y
11858
11859 C<yacc>, C<yaccflags>
11860
11861 =item z
11862
11863 C<zcat>, C<zip>
11864
11865 =back
11866
11867 =item NOTE
11868
11869 =back
11870
11871 =head2 Cwd - get pathname of current working directory
11872
11873 =over 4
11874
11875 =item SYNOPSIS
11876
11877 =item DESCRIPTION
11878
11879 =over 4
11880
11881 =item getcwd and friends
11882
11883 getcwd, cwd, fastcwd, fastgetcwd, getdcwd
11884
11885 =item abs_path and friends
11886
11887 abs_path, realpath, fast_abs_path
11888
11889 =item $ENV{PWD}
11890
11891 =back
11892
11893 =item NOTES
11894
11895 =item AUTHOR
11896
11897 =item SEE ALSO
11898
11899 =back
11900
11901 =head2 DB - programmatic interface to the Perl debugging API (draft,
11902 subject to
11903 change)
11904
11905 =over 4
11906
11907 =item SYNOPSIS
11908
11909 =item DESCRIPTION
11910
11911 =over 4
11912
11913 =item Global Variables
11914
11915  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args, 
11916 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname, 
11917 $DB::lineno
11918
11919 =item API Methods
11920
11921 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
11922 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
11923
11924 =item Client Callback Methods
11925
11926 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
11927 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
11928 CLIENT->output(LIST)
11929
11930 =back
11931
11932 =item BUGS
11933
11934 =item AUTHOR
11935
11936 =back
11937
11938 =head2 DBM_Filter -- Filter DBM keys/values 
11939
11940 =over 4
11941
11942 =item SYNOPSIS
11943
11944 =item DESCRIPTION
11945
11946 =item What is a DBM Filter?
11947
11948 =over 4
11949
11950 =item So what's new?
11951
11952 =back
11953
11954 =item METHODS
11955
11956 =over 4
11957
11958 =item $db->Filter_Push()
11959
11960 =item $db->Filter_Key_Push()
11961
11962 =item $db->Filter_Value_Push()
11963
11964 Filter_Push, Filter_Key_Push, Filter_Value_Push
11965
11966 =item $db->Filter_Pop()
11967
11968 =item $db->Filtered()
11969
11970 =back
11971
11972 =item Writing a Filter
11973
11974 =over 4
11975
11976 =item Immediate Filters
11977
11978 =item Canned Filters
11979
11980 "name", params
11981
11982 =back
11983
11984 =item Filters Included
11985
11986 utf8, encode, compress, int32, null
11987
11988 =item NOTES
11989
11990 =over 4
11991
11992 =item Maintain Round Trip Integrity
11993
11994 =item Don't mix filtered & non-filtered data in the same database file. 
11995
11996 =back
11997
11998 =item EXAMPLE
11999
12000 =item SEE ALSO
12001
12002 =item AUTHOR
12003
12004 =back
12005
12006 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
12007
12008 =over 4
12009
12010 =item SYNOPSIS
12011
12012 =item DESCRIPTION
12013
12014 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
12015
12016 =over 4
12017
12018 =item Using DB_File with Berkeley DB version 2 or greater
12019
12020 =item Interface to Berkeley DB
12021
12022 =item Opening a Berkeley DB Database File
12023
12024 =item Default Parameters
12025
12026 =item In Memory Databases
12027
12028 =back
12029
12030 =item DB_HASH
12031
12032 =over 4
12033
12034 =item A Simple Example
12035
12036 =back
12037
12038 =item DB_BTREE
12039
12040 =over 4
12041
12042 =item Changing the BTREE sort order
12043
12044 =item Handling Duplicate Keys 
12045
12046 =item The get_dup() Method
12047
12048 =item The find_dup() Method
12049
12050 =item The del_dup() Method
12051
12052 =item Matching Partial Keys 
12053
12054 =back
12055
12056 =item DB_RECNO
12057
12058 =over 4
12059
12060 =item The 'bval' Option
12061
12062 =item A Simple Example
12063
12064 =item Extra RECNO Methods
12065
12066 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
12067 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
12068 length, elements);>
12069
12070 =item Another Example
12071
12072 =back
12073
12074 =item THE API INTERFACE
12075
12076 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
12077 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
12078 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
12079 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
12080
12081 =item DBM FILTERS
12082
12083 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
12084 B<filter_fetch_value>
12085
12086 =over 4
12087
12088 =item The Filter
12089
12090 =item An Example -- the NULL termination problem.
12091
12092 =item Another Example -- Key is a C int.
12093
12094 =back
12095
12096 =item HINTS AND TIPS 
12097
12098 =over 4
12099
12100 =item Locking: The Trouble with fd
12101
12102 =item Safe ways to lock a database
12103
12104 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
12105
12106 =item Sharing Databases With C Applications
12107
12108 =item The untie() Gotcha
12109
12110 =back
12111
12112 =item COMMON QUESTIONS
12113
12114 =over 4
12115
12116 =item Why is there Perl source in my database?
12117
12118 =item How do I store complex data structures with DB_File?
12119
12120 =item What does "Invalid Argument" mean?
12121
12122 =item What does "Bareword 'DB_File' not allowed" mean? 
12123
12124 =back
12125
12126 =item REFERENCES
12127
12128 =item HISTORY
12129
12130 =item BUGS
12131
12132 =item AVAILABILITY
12133
12134 =item COPYRIGHT
12135
12136 =item SEE ALSO
12137
12138 =item AUTHOR
12139
12140 =back
12141
12142 =head2 Data::Dumper - stringified perl data structures, suitable for both
12143 printing and C<eval>
12144
12145 =over 4
12146
12147 =item SYNOPSIS
12148
12149 =item DESCRIPTION
12150
12151 =over 4
12152
12153 =item Methods
12154
12155 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or> 
12156 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
12157 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
12158 I<$OBJ>->Reset
12159
12160 =item Functions
12161
12162 Dumper(I<LIST>)
12163
12164 =item Configuration Variables or Methods
12165
12166 =item Exports
12167
12168 Dumper
12169
12170 =back
12171
12172 =item EXAMPLES
12173
12174 =item BUGS
12175
12176 =over 4
12177
12178 =item NOTE
12179
12180 =back
12181
12182 =item AUTHOR
12183
12184 =item VERSION
12185
12186 =item SEE ALSO
12187
12188 =back
12189
12190 =head2 Devel::DProf - a Perl code profiler
12191
12192 =over 4
12193
12194 =item SYNOPSIS
12195
12196 =item DESCRIPTION
12197
12198 =item PROFILE FORMAT
12199
12200 =item AUTOLOAD
12201
12202 =item ENVIRONMENT
12203
12204 =item BUGS
12205
12206 =item SEE ALSO
12207
12208 =back
12209
12210 =head2 Devel::PPPort - Perl/Pollution/Portability
12211
12212 =over 4
12213
12214 =item SYNOPSIS
12215
12216 =item DESCRIPTION
12217
12218 =over 4
12219
12220 =item WriteFile
12221
12222 =back
12223
12224 =item ppport.h
12225
12226 =item AUTHOR
12227
12228 =item SEE ALSO
12229
12230 =back
12231
12232 =head2 Devel::Peek - A data debugging tool for the XS programmer
12233
12234 =over 4
12235
12236 =item SYNOPSIS
12237
12238 =item DESCRIPTION
12239
12240 =over 4
12241
12242 =item Runtime debugging
12243
12244 =item Memory footprint debugging
12245
12246 =back
12247
12248 =item EXAMPLES
12249
12250 =over 4
12251
12252 =item A simple scalar string
12253
12254 =item A simple scalar number
12255
12256 =item A simple scalar with an extra reference
12257
12258 =item A reference to a simple scalar
12259
12260 =item A reference to an array
12261
12262 =item A reference to a hash
12263
12264 =item Dumping a large array or hash
12265
12266 =item A reference to an SV which holds a C pointer
12267
12268 =item A reference to a subroutine
12269
12270 =back
12271
12272 =item EXPORTS
12273
12274 =item BUGS
12275
12276 =item AUTHOR
12277
12278 =item SEE ALSO
12279
12280 =back
12281
12282 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
12283
12284 =over 4
12285
12286 =item SYNOPSIS
12287
12288 =item DESCRIPTION
12289
12290 =back
12291
12292 =head2 Digest - Modules that calculate message digests
12293
12294 =over 4
12295
12296 =item SYNOPSIS
12297
12298 =item DESCRIPTION
12299
12300 I<binary>, I<hex>, I<base64>
12301
12302 =item OO INTERFACE
12303
12304 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
12305 Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset,
12306 $ctx->add( $data, ... ), $ctx->addfile( $io_handle ), $ctx->add_bits(
12307 $data, $nbits ), $ctx->add_bits( $bitstring ), $ctx->digest,
12308 $ctx->hexdigest, $ctx->b64digest
12309
12310 =item Digest speed
12311
12312 =item SEE ALSO
12313
12314 =item AUTHOR
12315
12316 =back
12317
12318 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
12319
12320 =over 4
12321
12322 =item SYNOPSIS
12323
12324 =item DESCRIPTION
12325
12326 =item FUNCTIONS
12327
12328 md5($data,...), md5_hex($data,...), md5_base64($data,...)
12329
12330 =item METHODS
12331
12332 $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...),
12333 $md5->addfile($io_handle), $md5->add_bits($data, $nbits),
12334 $md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest
12335
12336 =item EXAMPLES
12337
12338 =item SEE ALSO
12339
12340 =item COPYRIGHT
12341
12342 =item AUTHORS
12343
12344 =back
12345
12346 =head2 Digest::base - Digest base class
12347
12348 =over 4
12349
12350 =item SYNPOSIS
12351
12352 =item DESCRIPTION
12353
12354 =item SEE ALSO
12355
12356 =back
12357
12358 =head2 DirHandle - supply object methods for directory handles
12359
12360 =over 4
12361
12362 =item SYNOPSIS
12363
12364 =item DESCRIPTION
12365
12366 =item NOTES
12367
12368 =back
12369
12370 =head2 Dumpvalue - provides screen dump of Perl data.
12371
12372 =over 4
12373
12374 =item SYNOPSIS
12375
12376 =item DESCRIPTION
12377
12378 =over 4
12379
12380 =item Creation
12381
12382 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
12383 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
12384 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
12385 stopDbSignal
12386
12387 =item Methods
12388
12389 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
12390 compactDump, veryCompact, set, get
12391
12392 =back
12393
12394 =back
12395
12396 =head2 DynaLoader - Dynamically load C libraries into Perl code
12397
12398 =over 4
12399
12400 =item SYNOPSIS
12401
12402 =item DESCRIPTION
12403
12404 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
12405 @dl_modules, @dl_shared_objects, dl_error(), $dl_debug, dl_findfile(),
12406 dl_expandspec(), dl_load_file(), dl_unload_file(), dl_load_flags(),
12407 dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(),
12408 dl_install_xsub(), bootstrap()
12409
12410 =item AUTHOR
12411
12412 =back
12413
12414 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
12415 Perl code
12416
12417 =over 4
12418
12419 =item SYNOPSIS
12420
12421 =item DESCRIPTION
12422
12423 =over 4
12424
12425 =item Migration from C<DynaLoader>
12426
12427 =item Backward compatible boilerplate
12428
12429 =back
12430
12431 =item Order of initialization: early load()
12432
12433 =over 4
12434
12435 =item The most hairy case
12436
12437 =back
12438
12439 =item LIMITATIONS
12440
12441 =item AUTHOR
12442
12443 =back
12444
12445 =head2 Encode - character encodings
12446
12447 =over 4
12448
12449 =item SYNOPSIS
12450
12451 =over 4
12452
12453 =item Table of Contents
12454
12455 =back
12456
12457 =item DESCRIPTION
12458
12459 =over 4
12460
12461 =item TERMINOLOGY
12462
12463 =back
12464
12465 =item PERL ENCODING API
12466
12467 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
12468 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
12469 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
12470 CHECK]);
12471
12472 =over 4
12473
12474 =item Listing available encodings
12475
12476 =item Defining Aliases
12477
12478 =back
12479
12480 =item Encoding via PerlIO
12481
12482 =item Handling Malformed Data
12483
12484 I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
12485 I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
12486 (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
12487 Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
12488 bitmask
12489
12490 =over 4
12491
12492 =item Unimplemented fallback schemes
12493
12494 =back
12495
12496 =item Defining Encodings
12497
12498 =item The UTF-8 flag
12499
12500 Goal #1:, Goal #2:, Goal #3:, Goal #4:
12501
12502 =over 4
12503
12504 =item Messing with Perl's Internals
12505
12506 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
12507
12508 =back
12509
12510 =item SEE ALSO
12511
12512 =item MAINTAINER
12513
12514 =back
12515
12516 =head2 Encode::Alias - alias definitions to encodings
12517
12518 =over 4
12519
12520 =item SYNOPSIS
12521
12522 =item DESCRIPTION
12523
12524 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
12525 reference, e.g.:
12526
12527 =over 4
12528
12529 =item Alias overloading
12530
12531 =back
12532
12533 =item SEE ALSO
12534
12535 =back
12536
12537 =head2 Encode::Byte - Single Byte Encodings
12538
12539 =over 4
12540
12541 =item SYNOPSIS
12542
12543 =item ABSTRACT
12544
12545 =item DESCRIPTION
12546
12547 =item SEE ALSO
12548
12549 =back
12550
12551 =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
12552
12553 =head2 Encode::CN - China-based Chinese Encodings
12554
12555 =over 4
12556
12557 =item SYNOPSIS
12558
12559 =item DESCRIPTION
12560
12561 =item NOTES
12562
12563 =item BUGS
12564
12565 =item SEE ALSO
12566
12567 =back
12568
12569 =head2 Encode::CN::HZ -- internally used by Encode::CN
12570
12571 =head2 Encode::Config -- internally used by Encode
12572
12573 =head2 Encode::EBCDIC - EBCDIC Encodings
12574
12575 =over 4
12576
12577 =item SYNOPSIS
12578
12579 =item ABSTRACT
12580
12581 =item DESCRIPTION
12582
12583 =item SEE ALSO
12584
12585 =back
12586
12587 =head2 Encode::Encoding - Encode Implementation Base Class
12588
12589 =over 4
12590
12591 =item SYNOPSIS
12592
12593 =item DESCRIPTION
12594
12595 =over 4
12596
12597 =item Methods you should implement
12598
12599 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
12600 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
12601
12602 =item Other methods defined in Encode::Encodings
12603
12604 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
12605
12606 =item Example: Encode::ROT13
12607
12608 =back
12609
12610 =item Why the heck Encode API is different?
12611
12612 =over 4
12613
12614 =item Compiled Encodings
12615
12616 =back
12617
12618 =item SEE ALSO
12619
12620 Scheme 1, Scheme 2, Other Schemes
12621
12622 =back
12623
12624 =head2 Encode::Guess -- Guesses encoding from data
12625
12626 =over 4
12627
12628 =item SYNOPSIS
12629
12630 =item ABSTRACT
12631
12632 =item DESCRIPTION
12633
12634 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
12635 Encode::decode("Guess" ...), Encode::Guess->guess($data),
12636 guess_encoding($data, [, I<list of suspects>])
12637
12638 =item CAVEATS
12639
12640 =item TO DO
12641
12642 =item SEE ALSO
12643
12644 =back
12645
12646 =head2 Encode::JP - Japanese Encodings
12647
12648 =over 4
12649
12650 =item SYNOPSIS
12651
12652 =item ABSTRACT
12653
12654 =item DESCRIPTION
12655
12656 =item Note on ISO-2022-JP(-1)?
12657
12658 =item BUGS
12659
12660 =item SEE ALSO
12661
12662 =back
12663
12664 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
12665
12666 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
12667
12668 =head2 Encode::KR - Korean Encodings
12669
12670 =over 4
12671
12672 =item SYNOPSIS
12673
12674 =item DESCRIPTION
12675
12676 =item BUGS
12677
12678 =item SEE ALSO
12679
12680 =back
12681
12682 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
12683
12684 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
12685
12686 =over 4
12687
12688 =item SYNOPSIS
12689
12690 =item ABSTRACT
12691
12692 =item DESCRIPTION
12693
12694 =item BUGS
12695
12696 =item SEE ALSO
12697
12698 =back
12699
12700 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
12701
12702 =over 4
12703
12704 =item Overview
12705
12706 =item How does it work?
12707
12708 =item Line Buffering
12709
12710 =over 4
12711
12712 =item How can I tell whether my encoding fully supports PerlIO ?
12713
12714 =back
12715
12716 =item SEE ALSO
12717
12718 =back
12719
12720 =head2 Encode::Supported -- Encodings supported by Encode
12721
12722 =over 4
12723
12724 =item DESCRIPTION
12725
12726 =over 4
12727
12728 =item Encoding Names
12729
12730 =back
12731
12732 =item Supported Encodings
12733
12734 =over 4
12735
12736 =item Built-in Encodings
12737
12738 =item Encode::Unicode -- other Unicode encodings
12739
12740 =item Encode::Byte -- Extended ASCII
12741
12742 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
12743 the Cyrillic world, gsm0338 - Hentai Latin 1
12744
12745 =item CJK: Chinese, Japanese, Korean (Multibyte)
12746
12747 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
12748 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
12749 Encode::JIS2K -- JIS X 0213 encodings via CPAN
12750
12751 =item Miscellaneous encodings
12752
12753 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
12754
12755 =back
12756
12757 =item Unsupported encodings
12758
12759   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
12760 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
12761 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
12762 Various Mac encodings, (Mac) Indic encodings
12763
12764 =item Encoding vs. Charset -- terminology
12765
12766 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
12767
12768 =over 4
12769
12770 =item Microsoft-related naming mess
12771
12772 KS_C_5601-1987, GB2312, Big5, Shift_JIS
12773
12774 =back
12775
12776 =item Glossary
12777
12778 character repertoire, coded character set (CCS), character encoding scheme
12779 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
12780 UTF-16
12781
12782 =item See Also
12783
12784 =item References
12785
12786 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
12787 RFC, UC, Unicode Glossary
12788
12789 =over 4
12790
12791 =item Other Notable Sites
12792
12793 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
12794 "Introduction to i18n"
12795
12796 =item Offline sources
12797
12798 C<CJKV Information Processing> by Ken Lunde
12799
12800 =back
12801
12802 =back
12803
12804 =head2 Encode::Symbol - Symbol Encodings
12805
12806 =over 4
12807
12808 =item SYNOPSIS
12809
12810 =item ABSTRACT
12811
12812 =item DESCRIPTION
12813
12814 =item SEE ALSO
12815
12816 =back
12817
12818 =head2 Encode::TW - Taiwan-based Chinese Encodings
12819
12820 =over 4
12821
12822 =item SYNOPSIS
12823
12824 =item DESCRIPTION
12825
12826 =item NOTES
12827
12828 =item BUGS
12829
12830 =item SEE ALSO
12831
12832 =back
12833
12834 =head2 Encode::Unicode -- Various Unicode Transformation Formats
12835
12836 =over 4
12837
12838 =item SYNOPSIS
12839
12840 =item ABSTRACT
12841
12842 L<http://www.unicode.org/glossary/> says:, Quick Reference
12843
12844 =item Size, Endianness, and BOM
12845
12846 =over 4
12847
12848 =item by size
12849
12850 =item by endianness
12851
12852 BOM as integer when fetched in network byte order
12853
12854 =back
12855
12856 =item Surrogate Pairs
12857
12858 =item SEE ALSO
12859
12860 =back
12861
12862 =head2 Encode::Unicode::UTF7 -- UTF-7 encoding
12863
12864 =over 4
12865
12866 =item SYNOPSIS
12867
12868 =item ABSTRACT
12869
12870 =item In Practice
12871
12872 =item SEE ALSO
12873
12874 =back
12875
12876 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
12877 encodings
12878
12879 =over 4
12880
12881 =item SYNOPSIS
12882
12883 =item DESCRIPTION
12884
12885 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
12886 reference, e.g.:
12887
12888 =over 4
12889
12890 =item Alias overloading
12891
12892 =back
12893
12894 =item SEE ALSO
12895
12896 =back
12897
12898 =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm --
12899 Internally used by Encode::??::ISO_2022_*
12900
12901 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
12902 Encode::CN
12903
12904 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
12905 Encode
12906
12907 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
12908 Implementation Base Class
12909
12910 =over 4
12911
12912 =item SYNOPSIS
12913
12914 =item DESCRIPTION
12915
12916 =over 4
12917
12918 =item Methods you should implement
12919
12920 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
12921 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
12922
12923 =item Other methods defined in Encode::Encodings
12924
12925 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
12926
12927 =item Example: Encode::ROT13
12928
12929 =back
12930
12931 =item Why the heck Encode API is different?
12932
12933 =over 4
12934
12935 =item Compiled Encodings
12936
12937 =back
12938
12939 =item SEE ALSO
12940
12941 Scheme 1, Scheme 2, Other Schemes
12942
12943 =back
12944
12945 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
12946 data
12947
12948 =over 4
12949
12950 =item SYNOPSIS
12951
12952 =item ABSTRACT
12953
12954 =item DESCRIPTION
12955
12956 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
12957 Encode::decode("Guess" ...), Encode::Guess->guess($data),
12958 guess_encoding($data, [, I<list of suspects>])
12959
12960 =item CAVEATS
12961
12962 =item TO DO
12963
12964 =item SEE ALSO
12965
12966 =back
12967
12968 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
12969 Encode::JP::2022_JP*
12970
12971 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
12972 by Encode::JP
12973
12974 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
12975 used by Encode::KR
12976
12977 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
12978 and 'Q' header encoding
12979
12980 =over 4
12981
12982 =item SYNOPSIS
12983
12984 =item ABSTRACT
12985
12986 =item DESCRIPTION
12987
12988 =item BUGS
12989
12990 =item SEE ALSO
12991
12992 =back
12993
12994 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
12995 on Encode and PerlIO
12996
12997 =over 4
12998
12999 =item Overview
13000
13001 =item How does it work?
13002
13003 =item Line Buffering
13004
13005 =over 4
13006
13007 =item How can I tell whether my encoding fully supports PerlIO ?
13008
13009 =back
13010
13011 =item SEE ALSO
13012
13013 =back
13014
13015 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
13016 supported by Encode
13017
13018 =over 4
13019
13020 =item DESCRIPTION
13021
13022 =over 4
13023
13024 =item Encoding Names
13025
13026 =back
13027
13028 =item Supported Encodings
13029
13030 =over 4
13031
13032 =item Built-in Encodings
13033
13034 =item Encode::Unicode -- other Unicode encodings
13035
13036 =item Encode::Byte -- Extended ASCII
13037
13038 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
13039 the Cyrillic world, gsm0338 - Hentai Latin 1
13040
13041 =item CJK: Chinese, Japanese, Korean (Multibyte)
13042
13043 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
13044 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
13045 Encode::JIS2K -- JIS X 0213 encodings via CPAN
13046
13047 =item Miscellaneous encodings
13048
13049 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
13050
13051 =back
13052
13053 =item Unsupported encodings
13054
13055   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
13056 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
13057 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
13058 Various Mac encodings, (Mac) Indic encodings
13059
13060 =item Encoding vs. Charset -- terminology
13061
13062 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
13063
13064 =over 4
13065
13066 =item Microsoft-related naming mess
13067
13068 KS_C_5601-1987, GB2312, Big5, Shift_JIS
13069
13070 =back
13071
13072 =item Glossary
13073
13074 character repertoire, coded character set (CCS), character encoding scheme
13075 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
13076 UTF-16
13077
13078 =item See Also
13079
13080 =item References
13081
13082 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
13083 RFC, UC, Unicode Glossary
13084
13085 =over 4
13086
13087 =item Other Notable Sites
13088
13089 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
13090 "Introduction to i18n"
13091
13092 =item Offline sources
13093
13094 C<CJKV Information Processing> by Ken Lunde
13095
13096 =back
13097
13098 =back
13099
13100 =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7
13101 encoding
13102
13103 =over 4
13104
13105 =item SYNOPSIS
13106
13107 =item ABSTRACT
13108
13109 =item In Practice
13110
13111 =item SEE ALSO
13112
13113 =back
13114
13115 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
13116
13117 =over 4
13118
13119 =item SYNOPSIS
13120
13121 =item ABSTRACT
13122
13123 =item Description
13124
13125 =over 4
13126
13127 =item Predefined Methods
13128
13129 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
13130 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
13131 $e-E<gt>bytes([$encoding])
13132
13133 =item Example: base64 transcoder
13134
13135 =item Operator Overloading
13136
13137 =back
13138
13139 =item SEE ALSO
13140
13141 =back
13142
13143 =head2 Encodencoding, encoding - allows you to write your script in
13144 non-ascii or non-utf8
13145
13146 =over 4
13147
13148 =item SYNOPSIS
13149
13150 =item ABSTRACT
13151
13152 =over 4
13153
13154 =item Literal Conversions
13155
13156 =item PerlIO layers for C<STD(IN|OUT)>
13157
13158 =item Implicit upgrading for byte strings
13159
13160 =back
13161
13162 =item FEATURES THAT REQUIRE 5.8.1
13163
13164 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
13165
13166 =item USAGE
13167
13168 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
13169 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
13170
13171 =item The Filter Option
13172
13173 =over 4
13174
13175 =item Filter-related changes at Encode version 1.87
13176
13177 =back
13178
13179 =item CAVEATS
13180
13181 =over 4
13182
13183 =item NOT SCOPED
13184
13185 =item DO NOT MIX MULTIPLE ENCODINGS
13186
13187 =item tr/// with ranges
13188
13189 Legend of characters above
13190
13191 =back
13192
13193 =item EXAMPLE - Greekperl
13194
13195 =item KNOWN PROBLEMS
13196
13197 literals in regex that are longer than 127 bytes, EBCDIC, format
13198
13199 =item HISTORY
13200
13201 =item SEE ALSO
13202
13203 =back
13204
13205 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
13206
13207 =over 4
13208
13209 =item SYNOPSIS
13210
13211 =item ABSTRACT
13212
13213 =item Description
13214
13215 =over 4
13216
13217 =item Predefined Methods
13218
13219 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
13220 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
13221 $e-E<gt>bytes([$encoding])
13222
13223 =item Example: base64 transcoder
13224
13225 =item Operator Overloading
13226
13227 =back
13228
13229 =item SEE ALSO
13230
13231 =back
13232
13233 =head2 English - use nice English (or awk) names for ugly punctuation
13234 variables
13235
13236 =over 4
13237
13238 =item SYNOPSIS
13239
13240 =item DESCRIPTION
13241
13242 =item PERFORMANCE
13243
13244 =back
13245
13246 =head2 Env - perl module that imports environment variables as scalars or
13247 arrays
13248
13249 =over 4
13250
13251 =item SYNOPSIS
13252
13253 =item DESCRIPTION
13254
13255 =item LIMITATIONS
13256
13257 =item AUTHOR
13258
13259 =back
13260
13261 =head2 Errno - System errno constants
13262
13263 =over 4
13264
13265 =item SYNOPSIS
13266
13267 =item DESCRIPTION
13268
13269 =item CAVEATS
13270
13271 =item AUTHOR
13272
13273 =item COPYRIGHT
13274
13275 =back
13276
13277 =head2 Exporter - Implements default import method for modules
13278
13279 =over 4
13280
13281 =item SYNOPSIS
13282
13283 =item DESCRIPTION
13284
13285 =over 4
13286
13287 =item How to Export
13288
13289 =item Selecting What To Export
13290
13291 =item How to Import
13292
13293 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
13294
13295 =back
13296
13297 =item Advanced features
13298
13299 =over 4
13300
13301 =item Specialised Import Lists
13302
13303 =item Exporting without using Exporter's import method
13304
13305 =item Exporting without inheriting from Exporter
13306
13307 =item Module Version Checking
13308
13309 =item Managing Unknown Symbols
13310
13311 =item Tag Handling Utility Functions
13312
13313 =item Generating combined tags
13314
13315 =item C<AUTOLOAD>ed Constants
13316
13317 =back
13318
13319 =back
13320
13321 =head2 Exporter::Heavy - Exporter guts
13322
13323 =over 4
13324
13325 =item SYNOPSIS
13326
13327 =item DESCRIPTION
13328
13329 =back
13330
13331 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
13332 Makefiles etc.
13333
13334 =over 4
13335
13336 =item SYNOPSIS
13337
13338 =item DESCRIPTION
13339
13340 =back
13341
13342 cat
13343
13344 eqtime src dst
13345
13346 rm_rf files...
13347
13348 rm_f files...
13349
13350 touch files ..
13351
13352 mv source... destination
13353
13354 cp source... destination
13355
13356 chmod mode files..
13357
13358 mkpath directory..
13359
13360 test_f file
13361
13362 dos2unix
13363
13364 =over 4
13365
13366 =item BUGS
13367
13368 =item SEE ALSO 
13369
13370 =item AUTHOR
13371
13372 =back
13373
13374 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
13375
13376 =over 4
13377
13378 =item SYNOPSIS
13379
13380 =item DESCRIPTION
13381
13382 B<test_harness>
13383
13384 =back
13385
13386 B<pod2man>
13387
13388 B<warn_if_old_packlist>
13389
13390 B<perllocal_install>
13391
13392 B<uninstall>
13393
13394 =head2 ExtUtils::Constant - generate XS code to import C header constants
13395
13396 =over 4
13397
13398 =item SYNOPSIS
13399
13400 =item DESCRIPTION
13401
13402 =item USAGE
13403
13404 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
13405
13406 =item FUNCTIONS
13407
13408 =back
13409
13410 C_stringify NAME
13411
13412 perl_stringify NAME
13413
13414 constant_types
13415
13416 memEQ_clause NAME, CHECKED_AT, INDENT
13417
13418 assign INDENT, TYPE, PRE, POST, VALUE..
13419
13420 return_clause
13421
13422 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
13423
13424 params WHAT
13425
13426 dump_names
13427
13428 dogfood
13429
13430 C_constant, name, type, value, macro, default, pre, post, def_pre =item
13431 def_post, utf8
13432
13433 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
13434
13435 autoload PACKAGE, VERSION, AUTOLOADER
13436
13437 WriteMakefileSnippet
13438
13439 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
13440 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
13441
13442 =over 4
13443
13444 =item AUTHOR
13445
13446 =back
13447
13448 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
13449
13450 =over 4
13451
13452 =item SYNOPSIS
13453
13454 =item DESCRIPTION
13455
13456 =item @EXPORT
13457
13458 =item FUNCTIONS
13459
13460 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
13461 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
13462
13463 =item EXAMPLES
13464
13465 =item SEE ALSO
13466
13467 =item AUTHOR
13468
13469 =back
13470
13471 =head2 ExtUtils::Install - install files from here to there
13472
13473 =over 4
13474
13475 =item SYNOPSIS
13476
13477 =item DESCRIPTION
13478
13479 =over 4
13480
13481 =item Functions
13482
13483 B<install>
13484
13485 =back
13486
13487 =back
13488
13489 B<install_default> I<DISCOURAGED>
13490
13491 B<uninstall>
13492
13493 B<pm_to_blib>
13494
13495 _autosplit
13496
13497 =over 4
13498
13499 =item ENVIRONMENT
13500
13501 B<PERL_INSTALL_ROOT>
13502
13503 =item AUTHOR
13504
13505 =item LICENSE
13506
13507 =back
13508
13509 =head2 ExtUtils::Installed - Inventory management of installed modules
13510
13511 =over 4
13512
13513 =item SYNOPSIS
13514
13515 =item DESCRIPTION
13516
13517 =item USAGE
13518
13519 =item FUNCTIONS
13520
13521 new(), modules(), files(), directories(), directory_tree(), validate(),
13522 packlist(), version()
13523
13524 =item EXAMPLE
13525
13526 =item AUTHOR
13527
13528 =back
13529
13530 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
13531
13532 =over 4
13533
13534 =item SYNOPSIS
13535
13536 =item DESCRIPTION
13537
13538 For static extensions, For dynamic extensions at build/link time, For
13539 dynamic extensions at load time
13540
13541 =over 4
13542
13543 =item EXTRALIBS
13544
13545 =item LDLOADLIBS and LD_RUN_PATH
13546
13547 =item BSLOADLIBS
13548
13549 =back
13550
13551 =item PORTABILITY
13552
13553 =over 4
13554
13555 =item VMS implementation
13556
13557 =item Win32 implementation
13558
13559 =back
13560
13561 =item SEE ALSO
13562
13563 =back
13564
13565 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
13566
13567 =over 4
13568
13569 =item SYNOPSIS
13570
13571 =item DESCRIPTION
13572
13573 =back
13574
13575 =head2 ExtUtils::MM_Any - Platform-agnostic MM methods
13576
13577 =over 4
13578
13579 =item SYNOPSIS
13580
13581 =item DESCRIPTION
13582
13583 =item Inherently Cross-Platform Methods
13584
13585 installvars
13586
13587 =back
13588
13589 os_flavor_is
13590
13591 blibdirs_target (o)
13592
13593 =over 4
13594
13595 =item File::Spec wrappers
13596
13597 catfile
13598
13599 =back
13600
13601 =over 4
13602
13603 =item Thought To Be Cross-Platform Methods
13604
13605 B<split_command>
13606
13607 =back
13608
13609 B<echo>
13610
13611 init_VERSION
13612
13613 wraplist
13614
13615 manifypods
13616
13617 manifypods_target
13618
13619 makemakerdflt_target
13620
13621 special_targets
13622
13623 POD2MAN_macro
13624
13625 test_via_harness
13626
13627 test_via_script
13628
13629 libscan
13630
13631 tool_autosplit
13632
13633 all_target
13634
13635 metafile_target
13636
13637 signature_target
13638
13639 metafile_addtomanifest_target
13640
13641 signature_addtomanifest_target
13642
13643 =over 4
13644
13645 =item Abstract methods
13646
13647 oneliner, B<quote_literal>, B<escape_newlines>, max_exec_len,
13648 B<init_others>, init_DIRFILESEP, init_linker, init_platform,
13649 platform_constants
13650
13651 =back
13652
13653 os_flavor
13654
13655 =over 4
13656
13657 =item AUTHOR
13658
13659 =back
13660
13661 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
13662 ExtUtils::MakeMaker
13663
13664 =over 4
13665
13666 =item SYNOPSIS
13667
13668 =item DESCRIPTION
13669
13670 =back
13671
13672 os_flavor (o)
13673
13674 init_linker
13675
13676 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
13677 ExtUtils::MakeMaker
13678
13679 =over 4
13680
13681 =item SYNOPSIS
13682
13683 =item DESCRIPTION
13684
13685 os_flavor (o)
13686
13687 =back
13688
13689 cflags (o)
13690
13691 replace_manpage_separator (o)
13692
13693 init_linker
13694
13695 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
13696
13697 =over 4
13698
13699 =item SYNOPSIS
13700
13701 =item DESCRIPTION
13702
13703 =over 4
13704
13705 =item Overridden methods
13706
13707 os_flavor
13708
13709 =back
13710
13711 =back
13712
13713 B<replace_manpage_separator>
13714
13715 =over 4
13716
13717 =item AUTHOR
13718
13719 =item SEE ALSO
13720
13721 =back
13722
13723 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
13724 ExtUtils::MakeMaker
13725
13726 =over 4
13727
13728 =item SYNOPSIS
13729
13730 =item DESCRIPTION
13731
13732 =back
13733
13734 maybe_command
13735
13736 guess_name
13737
13738 macify
13739
13740 patternify
13741
13742 init_main
13743
13744 init_others
13745
13746 init_platform, platform_constants
13747
13748 init_dirscan
13749
13750 init_VERSION (o)
13751
13752 special_targets (o)
13753
13754 static (o)
13755
13756 dlsyms (o)
13757
13758 dynamic (o)
13759
13760 clean (o)
13761
13762 clean_subdirs_target
13763
13764 realclean (o)
13765
13766 realclean_subdirs_target
13767
13768 rulez (o)
13769
13770 processPL (o)
13771
13772 os_flavor
13773
13774 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
13775 ExtUtils::MakeMaker
13776
13777 =over 4
13778
13779 =item SYNOPSIS
13780
13781 =item DESCRIPTION
13782
13783 =back
13784
13785 os_flavor
13786
13787 init_platform (o), platform_constants
13788
13789 const_cccmd (o)
13790
13791 static_lib (o)
13792
13793 dynamic_lib (o)
13794
13795 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
13796 ExtUtils::MakeMaker
13797
13798 =over 4
13799
13800 =item SYNOPSIS
13801
13802 =item DESCRIPTION
13803
13804 =item METHODS
13805
13806 init_dist (o)
13807
13808 =back
13809
13810 init_linker
13811
13812 os_flavor
13813
13814 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
13815
13816 =over 4
13817
13818 =item SYNOPSIS
13819
13820 =item DESCRIPTION
13821
13822 =over 4
13823
13824 =item Overridden methods
13825
13826 os_flavor
13827
13828 =back
13829
13830 =back
13831
13832 B<replace_manpage_separator>
13833
13834 =over 4
13835
13836 =item AUTHOR
13837
13838 =item SEE ALSO
13839
13840 =back
13841
13842 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
13843
13844 =over 4
13845
13846 =item SYNOPSIS
13847
13848 =item DESCRIPTION
13849
13850 =item METHODS
13851
13852 =back
13853
13854 =over 4
13855
13856 =item Methods
13857
13858 os_flavor (o)
13859
13860 =back
13861
13862 c_o (o)
13863
13864 cflags (o)
13865
13866 clean (o)
13867
13868 clean_subdirs_target
13869
13870 const_cccmd (o)
13871
13872 const_config (o)
13873
13874 const_loadlibs (o)
13875
13876 constants (o)
13877
13878 depend (o)
13879
13880 dir_target B<DEPRECATED>
13881
13882 init_DEST
13883
13884 init_dist
13885
13886 dist (o)
13887
13888 dist_basics (o)
13889
13890 dist_ci (o)
13891
13892 dist_core (o)
13893
13894 B<dist_target>
13895
13896 B<tardist_target>
13897
13898 B<zipdist_target>
13899
13900 B<tarfile_target>
13901
13902 zipfile_target
13903
13904 uutardist_target
13905
13906 shdist_target
13907
13908 distdir
13909
13910 dist_test
13911
13912 dlsyms (o)
13913
13914 dynamic (o)
13915
13916 dynamic_bs (o)
13917
13918 dynamic_lib (o)
13919
13920 exescan
13921
13922 extliblist
13923
13924 find_perl
13925
13926 find_tests
13927
13928 =over 4
13929
13930 =item Methods to actually produce chunks of text for the Makefile
13931
13932 fixin
13933
13934 =back
13935
13936 force (o)
13937
13938 guess_name
13939
13940 has_link_code
13941
13942 init_dirscan
13943
13944 init_DIRFILESEP
13945
13946 init_main
13947
13948 init_others
13949
13950 init_INST
13951
13952 init_INSTALL
13953
13954 init_linker
13955
13956 init_lib2arch
13957
13958 init_PERL
13959
13960 init_platform (o), platform_constants (o)
13961
13962 init_PERM
13963
13964 init_xs
13965
13966 install (o)
13967
13968 installbin (o)
13969
13970 linkext (o)
13971
13972 lsdir
13973
13974 macro (o)
13975
13976 makeaperl (o)
13977
13978 makefile (o)
13979
13980 maybe_command
13981
13982 needs_linking (o)
13983
13984 nicetext
13985
13986 parse_abstract
13987
13988 parse_version
13989
13990 pasthru (o)
13991
13992 perl_script
13993
13994 perldepend (o)
13995
13996 perm_rw (o)
13997
13998 perm_rwx (o)
13999
14000 pm_to_blib
14001
14002 post_constants (o)
14003
14004 post_initialize (o)
14005
14006 postamble (o)
14007
14008 ppd
14009
14010 prefixify
14011
14012 processPL (o)
14013
14014 quote_paren
14015
14016 realclean (o)
14017
14018 realclean_subdirs_target
14019
14020 replace_manpage_separator
14021
14022 oneliner (o)
14023
14024 quote_literal
14025
14026 escape_newlines
14027
14028 max_exec_len
14029
14030 static (o)
14031
14032 static_lib (o)
14033
14034 staticmake (o)
14035
14036 subdir_x (o)
14037
14038 subdirs (o)
14039
14040 test (o)
14041
14042 test_via_harness (override)
14043
14044 test_via_script (override)
14045
14046 tools_other (o)
14047
14048 tool_xsubpp (o)
14049
14050 all_target
14051
14052 top_targets (o)
14053
14054 writedoc
14055
14056 xs_c (o)
14057
14058 xs_cpp (o)
14059
14060 xs_o (o)
14061
14062 =over 4
14063
14064 =item SEE ALSO
14065
14066 =back
14067
14068 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
14069 ExtUtils::MakeMaker
14070
14071 =over 4
14072
14073 =item SYNOPSIS
14074
14075 =item DESCRIPTION
14076
14077 =over 4
14078
14079 =item Methods always loaded
14080
14081 wraplist
14082
14083 =back
14084
14085 =back
14086
14087 =over 4
14088
14089 =item Methods
14090
14091 guess_name (override)
14092
14093 =back
14094
14095 find_perl (override)
14096
14097 maybe_command (override)
14098
14099 perl_script (override)
14100
14101 replace_manpage_separator
14102
14103 init_DEST
14104
14105 init_DIRFILESEP
14106
14107 init_main (override)
14108
14109 init_others (override)
14110
14111 init_platform (override)
14112
14113 platform_constants
14114
14115 init_VERSION (override)
14116
14117 constants (override)
14118
14119 special_targets
14120
14121 cflags (override)
14122
14123 const_cccmd (override)
14124
14125 tool_sxubpp (override)
14126
14127 tools_other (override)
14128
14129 init_dist (override)
14130
14131 c_o (override)
14132
14133 xs_c (override)
14134
14135 xs_o (override)
14136
14137 dlsyms (override)
14138
14139 dynamic_lib (override)
14140
14141 dynamic_bs (override)
14142
14143 static_lib (override)
14144
14145 processPL (override)
14146
14147 installbin (override)
14148
14149 subdir_x (override)
14150
14151 clean (override)
14152
14153 clean_subdirs_target
14154
14155 realclean (override)
14156
14157 zipfile_target (o), tarfile_target (o), shdist_target (o)
14158
14159 dist_test (override)
14160
14161 install (override)
14162
14163 perldepend (override)
14164
14165 makefile (override)
14166
14167 find_tests (override)
14168
14169 test (override)
14170
14171 makeaperl (override)
14172
14173 nicetext (override)
14174
14175 prefixify (override)
14176
14177 oneliner (o)
14178
14179 B<echo> (o)
14180
14181 quote_literal
14182
14183 escape_newlines
14184
14185 max_exec_len
14186
14187 init_linker (o)
14188
14189 eliminate_macros
14190
14191 fixpath
14192
14193 os_flavor
14194
14195 blibdirs_target (override)
14196
14197 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
14198 ExtUtils::MakeMaker
14199
14200 =over 4
14201
14202 =item SYNOPSIS
14203
14204 =item DESCRIPTION
14205
14206 =back
14207
14208 =over 4
14209
14210 =item Overridden methods
14211
14212 B<dlsyms>
14213
14214 =back
14215
14216 replace_manpage_separator
14217
14218 B<maybe_command>
14219
14220 B<find_tests>
14221
14222 B<init_DIRFILESEP>
14223
14224 B<init_others>
14225
14226 init_platform (o), platform_constants (o)
14227
14228 special_targets (o)
14229
14230 static_lib (o)
14231
14232 dynamic_lib (o)
14233
14234 clean
14235
14236 init_linker
14237
14238 perl_script
14239
14240 xs_o (o)
14241
14242 pasthru (o)
14243
14244 oneliner (o)
14245
14246 max_exec_len
14247
14248 os_flavor
14249
14250 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
14251
14252 =over 4
14253
14254 =item SYNOPSIS
14255
14256 =item DESCRIPTION
14257
14258 =over 4
14259
14260 =item Overriden methods
14261
14262 dist_test
14263
14264 =back
14265
14266 =back
14267
14268 subdir_x
14269
14270 xs_c
14271
14272 xs_cpp
14273
14274 xs_o
14275
14276 clean_subdirs_target
14277
14278 realclean_subdirs_target
14279
14280 max_exec_len
14281
14282 os_flavor
14283
14284 =over 4
14285
14286 =item AUTHOR
14287
14288 =back
14289
14290 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
14291
14292 =over 4
14293
14294 =item SYNOPSIS
14295
14296 =item DESCRIPTION
14297
14298 =back
14299
14300 =head2 ExtUtils::MakeMaker - Create a module Makefile
14301
14302 =over 4
14303
14304 =item SYNOPSIS
14305
14306 =item DESCRIPTION
14307
14308 =over 4
14309
14310 =item How To Write A Makefile.PL
14311
14312 =item Default Makefile Behaviour
14313
14314 =item make test
14315
14316 =item make testdb
14317
14318 =item make install
14319
14320 =item PREFIX and LIB attribute
14321
14322 =item AFS users
14323
14324 =item Static Linking of a new Perl Binary
14325
14326 =item Determination of Perl Library and Installation Locations
14327
14328 =item Which architecture dependent directory?
14329
14330 =item Using Attributes and Parameters
14331
14332 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
14333 CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS,
14334 EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN,
14335 FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB,
14336 INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
14337 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB,
14338 INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLVENDORARCH,
14339 INSTALLVENDORBIN, INSTALLVENDORLIB, INSTALLVENDORMAN1DIR,
14340 INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR,
14341 INST_MAN3DIR, INST_SCRIPT, LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS,
14342 LINKTYPE, MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET,
14343 MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT,
14344 OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB,
14345 PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW,
14346 PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
14347 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT,
14348 PRINT_PREREQ, SITEPREFIX, SIGN, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST,
14349 VERSION, VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION
14350
14351 =item Additional lowercase attributes
14352
14353 clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean,
14354 test, tool_autosplit
14355
14356 =item Overriding MakeMaker Methods
14357
14358 =item The End Of Cargo Cult Programming
14359
14360 C<<MAN3PODS => ' '>>
14361
14362 =item Hintsfile support
14363
14364 =item Distribution Support
14365
14366    make distcheck,    make skipcheck,    make distclean,    make manifest, 
14367   make distdir,   make disttest,    make tardist,    make dist,    make
14368 uutardist,    make shdist,    make zipdist,    make ci
14369
14370 =item Module Meta-Data
14371
14372 =item Disabling an extension
14373
14374 =item Other Handy Functions
14375
14376 prompt
14377
14378 =back
14379
14380 =item ENVIRONMENT
14381
14382 PERL_MM_OPT, PERL_MM_USE_DEFAULT
14383
14384 =item SEE ALSO
14385
14386 =item AUTHORS
14387
14388 =item LICENSE
14389
14390 =back
14391
14392 =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About
14393 MakeMaker
14394
14395 =over 4
14396
14397 =item DESCRIPTION
14398
14399 =over 4
14400
14401 =item Module Installation
14402
14403 How do I keep from installing man pages?, How do I use a module without
14404 installing it?
14405
14406 =item Philosophy and History
14407
14408 Why not just use <insert other build config tool here>?, What is
14409 Module::Build and how does it relate to MakeMaker?, pure perl.  no make, no
14410 shell commands, easier to customize, cleaner internals, less cruft
14411
14412 =item Module Writing
14413
14414 How do I keep my $VERSION up to date without resetting it manually?, What's
14415 this F<META.yml> thing and how did it get in my F<MANIFEST>?!
14416
14417 =item XS
14418
14419 How to I prevent "object version X.XX does not match bootstrap parameter
14420 Y.YY" errors?, How do I make two or more XS files coexist in the same
14421 directory?
14422
14423 =back
14424
14425 =item PATCHING
14426
14427 =item AUTHOR
14428
14429 =item SEE ALSO
14430
14431 =back
14432
14433 =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker
14434
14435 =over 4
14436
14437 =item SYNOPSIS
14438
14439 =item DESCRIPTION
14440
14441 =over 4
14442
14443 =item The Mantra
14444
14445 =item The Layout
14446
14447 Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP,
14448 bin/
14449
14450 =back
14451
14452 =item SEE ALSO
14453
14454 =back
14455
14456 =head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm
14457
14458 =over 4
14459
14460 =item SYNOPSIS
14461
14462 =item DESCRIPTION
14463
14464 =back
14465
14466 =head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm
14467
14468 =over 4
14469
14470 =item SYNOPSIS
14471
14472 =item DESCRIPTION
14473
14474 =back
14475
14476 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
14477
14478 =over 4
14479
14480 =item SYNOPSIS
14481
14482 =item DESCRIPTION
14483
14484 =over 4
14485
14486 =item Functions
14487
14488 mkmanifest
14489
14490 =back
14491
14492 =back
14493
14494 manifind
14495
14496 manicheck
14497
14498 filecheck
14499
14500 fullcheck
14501
14502 skipcheck
14503
14504 maniread
14505
14506 manicopy
14507
14508 maniadd
14509
14510 =over 4
14511
14512 =item MANIFEST
14513
14514 =item MANIFEST.SKIP
14515
14516 =item EXPORT_OK
14517
14518 =item GLOBAL VARIABLES
14519
14520 =back
14521
14522 =over 4
14523
14524 =item DIAGNOSTICS
14525
14526 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
14527 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
14528
14529 =item ENVIRONMENT
14530
14531 B<PERL_MM_MANIFEST_DEBUG>
14532
14533 =item SEE ALSO
14534
14535 =item AUTHOR
14536
14537 =back
14538
14539 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
14540
14541 =over 4
14542
14543 =item SYNOPSIS
14544
14545 =item DESCRIPTION
14546
14547 =item SEE ALSO
14548
14549 =back
14550
14551 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
14552
14553 =over 4
14554
14555 =item SYNOPSIS
14556
14557 =item DESCRIPTION
14558
14559 =back
14560
14561 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
14562 extension
14563
14564 =over 4
14565
14566 =item SYNOPSIS
14567
14568 =item DESCRIPTION
14569
14570 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
14571
14572 =item AUTHOR
14573
14574 =item REVISION
14575
14576 =back
14577
14578 =head2 ExtUtils::Packlist - manage .packlist files
14579
14580 =over 4
14581
14582 =item SYNOPSIS
14583
14584 =item DESCRIPTION
14585
14586 =item USAGE
14587
14588 =item FUNCTIONS
14589
14590 new(), read(), write(), validate(), packlist_file()
14591
14592 =item EXAMPLE
14593
14594 =item AUTHOR
14595
14596 =back
14597
14598 =head2 ExtUtils::testlib - add blib/* directories to @INC
14599
14600 =over 4
14601
14602 =item SYNOPSIS
14603
14604 =item DESCRIPTION
14605
14606 =back
14607
14608 =head2 Fatal - replace functions with equivalents which succeed or die
14609
14610 =over 4
14611
14612 =item SYNOPSIS
14613
14614 =item DESCRIPTION
14615
14616 =item AUTHOR
14617
14618 =back
14619
14620 =head2 Fcntl - load the C Fcntl.h defines
14621
14622 =over 4
14623
14624 =item SYNOPSIS
14625
14626 =item DESCRIPTION
14627
14628 =item NOTE
14629
14630 =item EXPORTED SYMBOLS
14631
14632 =back
14633
14634 =head2 File::Basename, fileparse - split a pathname into pieces
14635
14636 =over 4
14637
14638 =item SYNOPSIS
14639
14640 =item DESCRIPTION
14641
14642 fileparse_set_fstype, fileparse
14643
14644 =item EXAMPLES
14645
14646 C<basename>, C<dirname>
14647
14648 =back
14649
14650 =head2 File::CheckTree, validate - run many filetest checks on a tree
14651
14652 =over 4
14653
14654 =item SYNOPSIS
14655
14656 =item DESCRIPTION
14657
14658 =item AUTHOR
14659
14660 =item HISTORY
14661
14662 =back
14663
14664 =head2 File::Compare - Compare files or filehandles
14665
14666 =over 4
14667
14668 =item SYNOPSIS
14669
14670 =item DESCRIPTION
14671
14672 =item RETURN
14673
14674 =item AUTHOR
14675
14676 =back
14677
14678 =head2 File::Copy - Copy files or filehandles
14679
14680 =over 4
14681
14682 =item SYNOPSIS
14683
14684 =item DESCRIPTION
14685
14686 =over 4
14687
14688 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
14689
14690 rmscopy($from,$to[,$date_flag])
14691
14692 =back
14693
14694 =item RETURN
14695
14696 =item NOTES
14697
14698 =item AUTHOR
14699
14700 =back
14701
14702 =head2 File::DosGlob - DOS like globbing and then some
14703
14704 =over 4
14705
14706 =item SYNOPSIS
14707
14708 =item DESCRIPTION
14709
14710 =item NOTES
14711
14712 =item EXPORTS (by request only)
14713
14714 =item BUGS
14715
14716 =item AUTHOR
14717
14718 =item HISTORY
14719
14720 =item SEE ALSO
14721
14722 =back
14723
14724 =head2 File::Find - Traverse a directory tree.
14725
14726 =over 4
14727
14728 =item SYNOPSIS
14729
14730 =item DESCRIPTION
14731
14732 B<find>, B<finddepth>
14733
14734 =over 4
14735
14736 =item %options
14737
14738 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
14739 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
14740 C<untaint>, C<untaint_pattern>, C<untaint_skip>
14741
14742 =item The wanted function
14743
14744 C<$File::Find::dir> is the current directory name,, C<$_> is the current
14745 filename within that directory, C<$File::Find::name> is the complete
14746 pathname to the file
14747
14748 =back
14749
14750 =item WARNINGS
14751
14752 =item CAVEAT
14753
14754 $dont_use_nlink, symlinks
14755
14756 =item NOTES
14757
14758 =item BUGS AND CAVEATS
14759
14760 =item HISTORY
14761
14762 =back
14763
14764 =head2 File::Glob - Perl extension for BSD glob routine
14765
14766 =over 4
14767
14768 =item SYNOPSIS
14769
14770 =item DESCRIPTION
14771
14772 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
14773 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
14774 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
14775
14776 =item DIAGNOSTICS
14777
14778 C<GLOB_NOSPACE>, C<GLOB_ABEND>
14779
14780 =item NOTES
14781
14782 =item AUTHOR
14783
14784 =back
14785
14786 =head2 File::Path - create or remove directory trees
14787
14788 =over 4
14789
14790 =item SYNOPSIS
14791
14792 =item DESCRIPTION
14793
14794 =item DIAGNOSTICS
14795
14796 =item AUTHORS
14797
14798 =back
14799
14800 =head2 File::Spec - portably perform operations on file names
14801
14802 =over 4
14803
14804 =item SYNOPSIS
14805
14806 =item DESCRIPTION
14807
14808 =item METHODS
14809
14810 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
14811 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
14812 splitdir, catpath(), abs2rel, rel2abs()
14813
14814 =item SEE ALSO
14815
14816 =item AUTHORS
14817
14818 =back
14819
14820 =head2 File::Spec::Cygwin - methods for Cygwin file specs
14821
14822 =over 4
14823
14824 =item SYNOPSIS
14825
14826 =item DESCRIPTION
14827
14828 =back
14829
14830 canonpath
14831
14832 file_name_is_absolute
14833
14834 tmpdir (override)
14835
14836 =head2 File::Spec::Epoc - methods for Epoc file specs
14837
14838 =over 4
14839
14840 =item SYNOPSIS
14841
14842 =item DESCRIPTION
14843
14844 =item AUTHORS
14845
14846 =back
14847
14848 canonpath()
14849
14850 =over 4
14851
14852 =item SEE ALSO
14853
14854 =back
14855
14856 =head2 File::Spec::Functions - portably perform operations on file names
14857
14858 =over 4
14859
14860 =item SYNOPSIS
14861
14862 =item DESCRIPTION
14863
14864 =over 4
14865
14866 =item Exports
14867
14868 =back
14869
14870 =item SEE ALSO
14871
14872 =back
14873
14874 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
14875
14876 =over 4
14877
14878 =item SYNOPSIS
14879
14880 =item DESCRIPTION
14881
14882 =item METHODS
14883
14884 canonpath
14885
14886 =back
14887
14888 catdir()
14889
14890 catfile
14891
14892 curdir
14893
14894 devnull
14895
14896 rootdir
14897
14898 tmpdir
14899
14900 updir
14901
14902 file_name_is_absolute
14903
14904 path
14905
14906 splitpath
14907
14908 splitdir
14909
14910 catpath
14911
14912 abs2rel
14913
14914 rel2abs
14915
14916 =over 4
14917
14918 =item AUTHORS
14919
14920 =item SEE ALSO
14921
14922 =back
14923
14924 =head2 File::Spec::OS2 - methods for OS/2 file specs
14925
14926 =over 4
14927
14928 =item SYNOPSIS
14929
14930 =item DESCRIPTION
14931
14932 tmpdir, splitpath
14933
14934 =back
14935
14936 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
14937 modules
14938
14939 =over 4
14940
14941 =item SYNOPSIS
14942
14943 =item DESCRIPTION
14944
14945 =item METHODS
14946
14947 canonpath()
14948
14949 =back
14950
14951 catdir()
14952
14953 catfile
14954
14955 curdir
14956
14957 devnull
14958
14959 rootdir
14960
14961 tmpdir
14962
14963 updir
14964
14965 no_upwards
14966
14967 case_tolerant
14968
14969 file_name_is_absolute
14970
14971 path
14972
14973 join
14974
14975 splitpath
14976
14977 splitdir
14978
14979 catpath()
14980
14981 abs2rel
14982
14983 rel2abs()
14984
14985 =over 4
14986
14987 =item SEE ALSO
14988
14989 =back
14990
14991 =head2 File::Spec::VMS - methods for VMS file specs
14992
14993 =over 4
14994
14995 =item SYNOPSIS
14996
14997 =item DESCRIPTION
14998
14999 eliminate_macros
15000
15001 =back
15002
15003 fixpath
15004
15005 =over 4
15006
15007 =item Methods always loaded
15008
15009 canonpath (override)
15010
15011 =back
15012
15013 catdir
15014
15015 catfile
15016
15017 curdir (override)
15018
15019 devnull (override)
15020
15021 rootdir (override)
15022
15023 tmpdir (override)
15024
15025 updir (override)
15026
15027 case_tolerant (override)
15028
15029 path (override)
15030
15031 file_name_is_absolute (override)
15032
15033 splitpath (override)
15034
15035 splitdir (override)
15036
15037 catpath (override)
15038
15039 abs2rel (override)
15040
15041 rel2abs (override)
15042
15043 =over 4
15044
15045 =item SEE ALSO
15046
15047 =back
15048
15049 =head2 File::Spec::Win32 - methods for Win32 file specs
15050
15051 =over 4
15052
15053 =item SYNOPSIS
15054
15055 =item DESCRIPTION
15056
15057 devnull
15058
15059 =back
15060
15061 tmpdir
15062
15063 catfile
15064
15065 canonpath
15066
15067 splitpath
15068
15069 splitdir
15070
15071 catpath
15072
15073 =over 4
15074
15075 =item Note For File::Spec::Win32 Maintainers
15076
15077 =back
15078
15079 =over 4
15080
15081 =item SEE ALSO
15082
15083 =back
15084
15085 =head2 File::Temp - return name and handle of a temporary file safely
15086
15087 =over 4
15088
15089 =item PORTABILITY
15090
15091 =item SYNOPSIS
15092
15093 =item DESCRIPTION
15094
15095 =back
15096
15097 =over 4
15098
15099 =item OO INTERFACE
15100
15101 B<new>
15102
15103 =back
15104
15105 B<filename>
15106
15107 B<DESTROY>
15108
15109 =over 4
15110
15111 =item FUNCTIONS
15112
15113 B<tempfile>
15114
15115 =back
15116
15117 B<tempdir>
15118
15119 =over 4
15120
15121 =item MKTEMP FUNCTIONS
15122
15123 B<mkstemp>
15124
15125 =back
15126
15127 B<mkstemps>
15128
15129 B<mkdtemp>
15130
15131 B<mktemp>
15132
15133 =over 4
15134
15135 =item POSIX FUNCTIONS
15136
15137 B<tmpnam>
15138
15139 =back
15140
15141 B<tmpfile>
15142
15143 =over 4
15144
15145 =item ADDITIONAL FUNCTIONS
15146
15147 B<tempnam>
15148
15149 =back
15150
15151 =over 4
15152
15153 =item UTILITY FUNCTIONS
15154
15155 B<unlink0>
15156
15157 =back
15158
15159 B<cmpstat>
15160
15161 B<unlink1>
15162
15163 =over 4
15164
15165 =item PACKAGE VARIABLES
15166
15167 B<safe_level>, STANDARD, MEDIUM, HIGH
15168
15169 =back
15170
15171 TopSystemUID
15172
15173 =over 4
15174
15175 =item WARNING
15176
15177 =over 4
15178
15179 =item Temporary files and NFS
15180
15181 =back
15182
15183 =item HISTORY
15184
15185 =item SEE ALSO
15186
15187 =item AUTHOR
15188
15189 =back
15190
15191 =head2 File::stat - by-name interface to Perl's built-in stat() functions
15192
15193 =over 4
15194
15195 =item SYNOPSIS
15196
15197 =item DESCRIPTION
15198
15199 =item BUGS
15200
15201 =item NOTE
15202
15203 =item AUTHOR
15204
15205 =back
15206
15207 =head2 FileCache - keep more files open than the system permits
15208
15209 =over 4
15210
15211 =item SYNOPSIS
15212
15213 =item DESCRIPTION
15214
15215 cacheout EXPR, cacheout MODE, EXPR
15216
15217 =item CAVEATS
15218
15219 =item BUGS
15220
15221 =back
15222
15223 =head2 FileHandle - supply object methods for filehandles
15224
15225 =over 4
15226
15227 =item SYNOPSIS
15228
15229 =item DESCRIPTION
15230
15231 $fh->print, $fh->printf, $fh->getline, $fh->getlines
15232
15233 =item SEE ALSO
15234
15235 =back
15236
15237 =head2 Filter::Simple - Simplified source filtering
15238
15239 =over 4
15240
15241 =item SYNOPSIS
15242
15243 =item DESCRIPTION
15244
15245 =over 4
15246
15247 =item The Problem
15248
15249 =item A Solution
15250
15251 =item Disabling or changing <no> behaviour
15252
15253 =item All-in-one interface
15254
15255 =item Filtering only specific components of source code
15256
15257 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
15258 C<"all">
15259
15260 =item Filtering only the code parts of source code
15261
15262 Most source code ceases to be grammatically correct when it is broken up
15263 into the pieces between string literals and regexes. So the C<'code'>
15264 component filter behaves slightly differently from the other partial
15265 filters
15266 described in the previous section.
15267
15268 =item Using Filter::Simple with an explicit C<import> subroutine
15269
15270 =item Using Filter::Simple and Exporter together
15271
15272 =item How it works
15273
15274 =back
15275
15276 =item AUTHOR
15277
15278 =item COPYRIGHT
15279
15280 =back
15281
15282 =head2 Filter::Util::Call - Perl Source Filter Utility Module
15283
15284 =over 4
15285
15286 =item SYNOPSIS
15287
15288 =item DESCRIPTION
15289
15290 =over 4
15291
15292 =item B<use Filter::Util::Call>
15293
15294 =item B<import()>
15295
15296 =item B<filter() and anonymous sub>
15297
15298 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
15299
15300 =back
15301
15302 =item EXAMPLES
15303
15304 =over 4
15305
15306 =item Example 1: A simple filter.
15307
15308 =item Example 2: Using the context
15309
15310 =item Example 3: Using the context within the filter
15311
15312 =item Example 4: Using filter_del
15313
15314 =back
15315
15316 =item Filter::Simple
15317
15318 =item AUTHOR
15319
15320 =item DATE
15321
15322 =back
15323
15324 =head2 FindBin - Locate directory of original perl script
15325
15326 =over 4
15327
15328 =item SYNOPSIS
15329
15330 =item DESCRIPTION
15331
15332 =item EXPORTABLE VARIABLES
15333
15334 =item KNOWN ISSUES
15335
15336 =item KNOWN BUGS
15337
15338 =item AUTHORS
15339
15340 =item COPYRIGHT
15341
15342 =back
15343
15344 =head2 GDBM_File - Perl5 access to the gdbm library.
15345
15346 =over 4
15347
15348 =item SYNOPSIS
15349
15350 =item DESCRIPTION
15351
15352 =item AVAILABILITY
15353
15354 =item BUGS
15355
15356 =item SEE ALSO
15357
15358 =back
15359
15360 =head2 Getopt::Long - Extended processing of command line options
15361
15362 =over 4
15363
15364 =item SYNOPSIS
15365
15366 =item DESCRIPTION
15367
15368 =item Command Line Options, an Introduction
15369
15370 =item Getting Started with Getopt::Long
15371
15372 =over 4
15373
15374 =item Simple options
15375
15376 =item A little bit less simple options
15377
15378 =item Mixing command line option with other arguments
15379
15380 =item Options with values
15381
15382 =item Options with multiple values
15383
15384 =item Options with hash values
15385
15386 =item User-defined subroutines to handle options
15387
15388 =item Options with multiple names
15389
15390 =item Case and abbreviations
15391
15392 =item Summary of Option Specifications
15393
15394 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
15395 + [ I<desttype> ]
15396
15397 =back
15398
15399 =item Advanced Possibilities
15400
15401 =over 4
15402
15403 =item Object oriented interface
15404
15405 =item Thread Safety
15406
15407 =item Documentation and help texts
15408
15409 =item Storing options in a hash
15410
15411 =item Bundling
15412
15413 =item The lonesome dash
15414
15415 =item Argument callback
15416
15417 =back
15418
15419 =item Configuring Getopt::Long
15420
15421 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
15422 require_order, permute, bundling (default: disabled), bundling_override
15423 (default: disabled), ignore_case  (default: enabled), ignore_case_always
15424 (default: disabled), auto_version (default:disabled), auto_help
15425 (default:disabled), pass_through (default: disabled), prefix,
15426 prefix_pattern, debug (default: disabled)
15427
15428 =item Exportable Methods
15429
15430 VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage
15431
15432 =item Return values and Errors
15433
15434 =item Legacy
15435
15436 =over 4
15437
15438 =item Default destinations
15439
15440 =item Alternative option starters
15441
15442 =item Configuration variables
15443
15444 =back
15445
15446 =item Trouble Shooting
15447
15448 =over 4
15449
15450 =item GetOptions does not return a false result when an option is not
15451 supplied
15452
15453 =item GetOptions does not split the command line correctly
15454
15455 =item Undefined subroutine &main::GetOptions called
15456
15457 =item How do I put a "-?" option into a Getopt::Long?
15458
15459 =back
15460
15461 =item AUTHOR
15462
15463 =item COPYRIGHT AND DISCLAIMER
15464
15465 =back
15466
15467 =head2 Getopt::Std, getopt, getopts - Process single-character switches
15468 with switch clustering
15469
15470 =over 4
15471
15472 =item SYNOPSIS
15473
15474 =item DESCRIPTION
15475
15476 =item C<--help> and C<--version>
15477
15478 =back
15479
15480 =head2 Hash::Util - A selection of general-utility hash subroutines
15481
15482 =over 4
15483
15484 =item SYNOPSIS
15485
15486 =item DESCRIPTION
15487
15488 =over 4
15489
15490 =item Restricted hashes
15491
15492 lock_keys, unlock_keys
15493
15494 =back
15495
15496 =back
15497
15498 lock_value, unlock_value
15499
15500 B<lock_hash>, B<unlock_hash>
15501
15502 B<hash_seed>
15503
15504 =over 4
15505
15506 =item CAVEATS
15507
15508 =item AUTHOR
15509
15510 =item SEE ALSO
15511
15512 =back
15513
15514 =head2 I18N::Collate - compare 8-bit scalar data according to the current
15515 locale
15516
15517 =over 4
15518
15519 =item SYNOPSIS
15520
15521 =item DESCRIPTION
15522
15523 =back
15524
15525 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
15526 tags
15527
15528 =over 4
15529
15530 =item SYNOPSIS
15531
15532 =item DESCRIPTION
15533
15534 =back
15535
15536 the function is_language_tag($lang1)
15537
15538 the function extract_language_tags($whatever)
15539
15540 the function same_language_tag($lang1, $lang2)
15541
15542 the function similarity_language_tag($lang1, $lang2)
15543
15544 the function is_dialect_of($lang1, $lang2)
15545
15546 the function super_languages($lang1)
15547
15548 the function locale2language_tag($locale_identifier)
15549
15550 the function encode_language_tag($lang1)
15551
15552 the function alternate_language_tags($lang1)
15553
15554 the function @langs = panic_languages(@accept_languages)
15555
15556 the function implicate_supers( ...languages... ), the function
15557 implicate_supers_strictly( ...languages... )
15558
15559 =over 4
15560
15561 =item ABOUT LOWERCASING
15562
15563 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
15564
15565 =item SEE ALSO
15566
15567 =item COPYRIGHT
15568
15569 =item AUTHOR
15570
15571 =back
15572
15573 =head2 I18N::LangTags::Detect - detect the user's language preferences
15574
15575 =over 4
15576
15577 =item SYNOPSIS
15578
15579 =item DESCRIPTION
15580
15581 =item FUNCTIONS
15582
15583 =item ENVIRONMENT
15584
15585 =item SEE ALSO
15586
15587 =item COPYRIGHT
15588
15589 =item AUTHOR
15590
15591 =back
15592
15593 =head2 I18N::LangTags::List -- tags and names for human languages
15594
15595 =over 4
15596
15597 =item SYNOPSIS
15598
15599 =item DESCRIPTION
15600
15601 =item ABOUT LANGUAGE TAGS
15602
15603 =item LIST OF LANGUAGES
15604
15605 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} :
15606 Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} :
15607 Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian,
15608 {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)],
15609 {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic,
15610 {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy}
15611 : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} :
15612 Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} :
15613 Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae}
15614 : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} :
15615 Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai}
15616 : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} :
15617 Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} :
15618 Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber
15619 (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini,
15620 {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} :
15621 Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} :
15622 Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian
15623 (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central
15624 American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages],
15625 {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb}
15626 : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} :
15627 Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} :
15628 Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree,
15629 {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf}
15630 : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based
15631 Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} :
15632 Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} :
15633 Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru)
15634 Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri,
15635 {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch,
15636 {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi}
15637 : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} :
15638 English, {enm} : Old English (1100-1500), {ang} : Old English
15639 (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} :
15640 Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat}
15641 : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} :
15642 Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French
15643 (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} :
15644 Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan,
15645 {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian,
15646 {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High
15647 German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon}
15648 : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient
15649 Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} :
15650 Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian,
15651 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
15652 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
15653 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo,
15654 {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European
15655 (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua
15656 (International Auxiliary Language Association), {ie} : Interlingue, {iu} :
15657 Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} :
15658 Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian
15659 languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} :
15660 Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle,
15661 {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} :
15662 Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar}
15663 : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh,
15664 {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese,
15665 {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz,
15666 {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} :
15667 Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama,
15668 {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} :
15669 Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} :
15670 Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} :
15671 Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban
15672 (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui}
15673 : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai,
15674 {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili,
15675 {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} :
15676 Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} :
15677 Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} :
15678 Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai,
15679 [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} :
15680 Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} :
15681 Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)],
15682 {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple
15683 languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan,
15684 {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele,
15685 {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
15686 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
15687 {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} :
15688 Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} :
15689 Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi}
15690 : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} :
15691 Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
15692 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
15693 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
15694 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
15695 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
15696 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
15697 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
15698 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
15699 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
15700 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
15701 languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} :
15702 Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami,
15703 [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} :
15704 Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak,
15705 {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian,
15706 {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign
15707 Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} :
15708 Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave
15709 (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian,
15710 {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} :
15711 Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} :
15712 South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} :
15713 Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati,
15714 {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} :
15715 Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao,
15716 {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} :
15717 Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} :
15718 Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau,
15719 {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian,
15720 {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} :
15721 Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh}
15722 : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} :
15723 Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian,
15724 {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} :
15725 Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak}
15726 : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was}
15727 : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private
15728 Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} :
15729 Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
15730 : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu,
15731 {zun} : Zuni
15732
15733 =item SEE ALSO
15734
15735 =item COPYRIGHT AND DISCLAIMER
15736
15737 =item AUTHOR
15738
15739 =back
15740
15741 =head2 I18N::Langinfo - query locale information
15742
15743 =over 4
15744
15745 =item SYNOPSIS
15746
15747 =item DESCRIPTION
15748
15749 =over 4
15750
15751 =item EXPORT
15752
15753 =back
15754
15755 =item SEE ALSO
15756
15757 =item AUTHOR
15758
15759 =item COPYRIGHT AND LICENSE
15760
15761 =back
15762
15763 =head2 IO - load various IO modules
15764
15765 =over 4
15766
15767 =item SYNOPSIS
15768
15769 =item DESCRIPTION
15770
15771 =item DEPRECATED
15772
15773 =back
15774
15775 =head2 IO::Dir - supply object methods for directory handles
15776
15777 =over 4
15778
15779 =item SYNOPSIS
15780
15781 =item DESCRIPTION
15782
15783 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
15784 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
15785
15786 =item SEE ALSO
15787
15788 =item AUTHOR
15789
15790 =item COPYRIGHT
15791
15792 =back
15793
15794 =head2 IO::File - supply object methods for filehandles
15795
15796 =over 4
15797
15798 =item SYNOPSIS
15799
15800 =item DESCRIPTION
15801
15802 =item CONSTRUCTOR
15803
15804 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
15805
15806 =item METHODS
15807
15808 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
15809
15810 =item SEE ALSO
15811
15812 =item HISTORY
15813
15814 =back
15815
15816 =head2 IO::Handle - supply object methods for I/O handles
15817
15818 =over 4
15819
15820 =item SYNOPSIS
15821
15822 =item DESCRIPTION
15823
15824 =item CONSTRUCTOR
15825
15826 new (), new_from_fd ( FD, MODE )
15827
15828 =item METHODS
15829
15830 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
15831 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
15832 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
15833 $io->blocking ( [ BOOL ] ), $io->untaint
15834
15835 =item NOTE
15836
15837 =item SEE ALSO
15838
15839 =item BUGS
15840
15841 =item HISTORY
15842
15843 =back
15844
15845 =head2 IO::Pipe - supply object methods for pipes
15846
15847 =over 4
15848
15849 =item SYNOPSIS
15850
15851 =item DESCRIPTION
15852
15853 =item CONSTRUCTOR
15854
15855 new ( [READER, WRITER] )
15856
15857 =item METHODS
15858
15859 reader ([ARGS]), writer ([ARGS]), handles ()
15860
15861 =item SEE ALSO
15862
15863 =item AUTHOR
15864
15865 =item COPYRIGHT
15866
15867 =back
15868
15869 =head2 IO::Poll - Object interface to system poll call
15870
15871 =over 4
15872
15873 =item SYNOPSIS
15874
15875 =item DESCRIPTION
15876
15877 =item METHODS
15878
15879 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
15880 IO ), handles( [ EVENT_MASK ] )
15881
15882 =item SEE ALSO
15883
15884 =item AUTHOR
15885
15886 =item COPYRIGHT
15887
15888 =back
15889
15890 =head2 IO::Seekable - supply seek based methods for I/O objects
15891
15892 =over 4
15893
15894 =item SYNOPSIS
15895
15896 =item DESCRIPTION
15897
15898 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
15899 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
15900 $io->tell
15901
15902 =item SEE ALSO
15903
15904 =item HISTORY
15905
15906 =back
15907
15908 =head2 IO::Select - OO interface to the select system call
15909
15910 =over 4
15911
15912 =item SYNOPSIS
15913
15914 =item DESCRIPTION
15915
15916 =item CONSTRUCTOR
15917
15918 new ( [ HANDLES ] )
15919
15920 =item METHODS
15921
15922 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
15923 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
15924 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
15925
15926 =item EXAMPLE
15927
15928 =item AUTHOR
15929
15930 =item COPYRIGHT
15931
15932 =back
15933
15934 =head2 IO::Socket - Object interface to socket communications
15935
15936 =over 4
15937
15938 =item SYNOPSIS
15939
15940 =item DESCRIPTION
15941
15942 =item CONSTRUCTOR
15943
15944 new ( [ARGS] )
15945
15946 =item METHODS
15947
15948 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
15949 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
15950
15951 =item SEE ALSO
15952
15953 =item AUTHOR
15954
15955 =item COPYRIGHT
15956
15957 =back
15958
15959 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
15960
15961 =over 4
15962
15963 =item SYNOPSIS
15964
15965 =item DESCRIPTION
15966
15967 =item CONSTRUCTOR
15968
15969 new ( [ARGS] )
15970
15971 =over 4
15972
15973 =item METHODS
15974
15975 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
15976 ()
15977
15978 =back
15979
15980 =item SEE ALSO
15981
15982 =item AUTHOR
15983
15984 =item COPYRIGHT
15985
15986 =back
15987
15988 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
15989
15990 =over 4
15991
15992 =item SYNOPSIS
15993
15994 =item DESCRIPTION
15995
15996 =item CONSTRUCTOR
15997
15998 new ( [ARGS] )
15999
16000 =item METHODS
16001
16002 hostpath(), peerpath()
16003
16004 =item SEE ALSO
16005
16006 =item AUTHOR
16007
16008 =item COPYRIGHT
16009
16010 =back
16011
16012 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
16013 handles
16014
16015 =over 4
16016
16017 =item SYNOPSIS
16018
16019 =item DESCRIPTION
16020
16021 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
16022 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
16023
16024 =item SEE ALSO
16025
16026 =item AUTHOR
16027
16028 =item COPYRIGHT
16029
16030 =back
16031
16032 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
16033
16034 =over 4
16035
16036 =item SYNOPSIS
16037
16038 =item DESCRIPTION
16039
16040 =item CONSTRUCTOR
16041
16042 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
16043
16044 =item METHODS
16045
16046 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
16047
16048 =item SEE ALSO
16049
16050 =item HISTORY
16051
16052 =back
16053
16054 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
16055 handles
16056
16057 =over 4
16058
16059 =item SYNOPSIS
16060
16061 =item DESCRIPTION
16062
16063 =item CONSTRUCTOR
16064
16065 new (), new_from_fd ( FD, MODE )
16066
16067 =item METHODS
16068
16069 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
16070 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
16071 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
16072 $io->blocking ( [ BOOL ] ), $io->untaint
16073
16074 =item NOTE
16075
16076 =item SEE ALSO
16077
16078 =item BUGS
16079
16080 =item HISTORY
16081
16082 =back
16083
16084 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
16085
16086 =over 4
16087
16088 =item SYNOPSIS
16089
16090 =item DESCRIPTION
16091
16092 =item CONSTRUCTOR
16093
16094 new ( [READER, WRITER] )
16095
16096 =item METHODS
16097
16098 reader ([ARGS]), writer ([ARGS]), handles ()
16099
16100 =item SEE ALSO
16101
16102 =item AUTHOR
16103
16104 =item COPYRIGHT
16105
16106 =back
16107
16108 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
16109
16110 =over 4
16111
16112 =item SYNOPSIS
16113
16114 =item DESCRIPTION
16115
16116 =item METHODS
16117
16118 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
16119 IO ), handles( [ EVENT_MASK ] )
16120
16121 =item SEE ALSO
16122
16123 =item AUTHOR
16124
16125 =item COPYRIGHT
16126
16127 =back
16128
16129 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
16130 I/O objects
16131
16132 =over 4
16133
16134 =item SYNOPSIS
16135
16136 =item DESCRIPTION
16137
16138 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
16139 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
16140 $io->tell
16141
16142 =item SEE ALSO
16143
16144 =item HISTORY
16145
16146 =back
16147
16148 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
16149 call
16150
16151 =over 4
16152
16153 =item SYNOPSIS
16154
16155 =item DESCRIPTION
16156
16157 =item CONSTRUCTOR
16158
16159 new ( [ HANDLES ] )
16160
16161 =item METHODS
16162
16163 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
16164 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
16165 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
16166
16167 =item EXAMPLE
16168
16169 =item AUTHOR
16170
16171 =item COPYRIGHT
16172
16173 =back
16174
16175 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
16176 communications
16177
16178 =over 4
16179
16180 =item SYNOPSIS
16181
16182 =item DESCRIPTION
16183
16184 =item CONSTRUCTOR
16185
16186 new ( [ARGS] )
16187
16188 =item METHODS
16189
16190 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
16191 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
16192
16193 =item SEE ALSO
16194
16195 =item AUTHOR
16196
16197 =item COPYRIGHT
16198
16199 =back
16200
16201 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
16202 AF_INET domain sockets
16203
16204 =over 4
16205
16206 =item SYNOPSIS
16207
16208 =item DESCRIPTION
16209
16210 =item CONSTRUCTOR
16211
16212 new ( [ARGS] )
16213
16214 =over 4
16215
16216 =item METHODS
16217
16218 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
16219 ()
16220
16221 =back
16222
16223 =item SEE ALSO
16224
16225 =item AUTHOR
16226
16227 =item COPYRIGHT
16228
16229 =back
16230
16231 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
16232 AF_UNIX domain sockets
16233
16234 =over 4
16235
16236 =item SYNOPSIS
16237
16238 =item DESCRIPTION
16239
16240 =item CONSTRUCTOR
16241
16242 new ( [ARGS] )
16243
16244 =item METHODS
16245
16246 hostpath(), peerpath()
16247
16248 =item SEE ALSO
16249
16250 =item AUTHOR
16251
16252 =item COPYRIGHT
16253
16254 =back
16255
16256 =head2 IPC::Msg - SysV Msg IPC object class
16257
16258 =over 4
16259
16260 =item SYNOPSIS
16261
16262 =item DESCRIPTION
16263
16264 =item METHODS
16265
16266 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
16267 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
16268 FLAGS ] ), stat
16269
16270 =item SEE ALSO
16271
16272 =item AUTHOR
16273
16274 =item COPYRIGHT
16275
16276 =back
16277
16278 =head2 IPC::Open2, open2 - open a process for both reading and writing
16279
16280 =over 4
16281
16282 =item SYNOPSIS
16283
16284 =item DESCRIPTION
16285
16286 =item WARNING 
16287
16288 =item SEE ALSO
16289
16290 =back
16291
16292 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
16293 handling
16294
16295 =over 4
16296
16297 =item SYNOPSIS
16298
16299 =item DESCRIPTION
16300
16301 =item WARNING
16302
16303 =back
16304
16305 =head2 IPC::Semaphore - SysV Semaphore IPC object class
16306
16307 =over 4
16308
16309 =item SYNOPSIS
16310
16311 =item DESCRIPTION
16312
16313 =item METHODS
16314
16315 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
16316 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
16317 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
16318 , VALUE ), stat
16319
16320 =item SEE ALSO
16321
16322 =item AUTHOR
16323
16324 =item COPYRIGHT
16325
16326 =back
16327
16328 =head2 IPC::SysV - SysV IPC constants
16329
16330 =over 4
16331
16332 =item SYNOPSIS
16333
16334 =item DESCRIPTION
16335
16336 ftok( PATH, ID )
16337
16338 =item SEE ALSO
16339
16340 =item AUTHORS
16341
16342 =item COPYRIGHT
16343
16344 =back
16345
16346 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
16347
16348 =over 4
16349
16350 =item SYNOPSIS
16351
16352 =item DESCRIPTION
16353
16354 =item METHODS
16355
16356 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
16357 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
16358 FLAGS ] ), stat
16359
16360 =item SEE ALSO
16361
16362 =item AUTHOR
16363
16364 =item COPYRIGHT
16365
16366 =back
16367
16368 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
16369 class
16370
16371 =over 4
16372
16373 =item SYNOPSIS
16374
16375 =item DESCRIPTION
16376
16377 =item METHODS
16378
16379 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
16380 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
16381 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
16382 , VALUE ), stat
16383
16384 =item SEE ALSO
16385
16386 =item AUTHOR
16387
16388 =item COPYRIGHT
16389
16390 =back
16391
16392 =head2 List::Util - A selection of general-utility list subroutines
16393
16394 =over 4
16395
16396 =item SYNOPSIS
16397
16398 =item DESCRIPTION
16399
16400 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
16401 BLOCK LIST, shuffle LIST, sum LIST
16402
16403 =item KNOWN BUGS
16404
16405 =item SUGGESTED ADDITIONS
16406
16407 =item COPYRIGHT
16408
16409 =back
16410
16411 =head2 List::Utilib::List::Util, List::Util - A selection of
16412 general-utility list subroutines
16413
16414 =over 4
16415
16416 =item SYNOPSIS
16417
16418 =item DESCRIPTION
16419
16420 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
16421 BLOCK LIST, shuffle LIST, sum LIST
16422
16423 =item KNOWN BUGS
16424
16425 =item SUGGESTED ADDITIONS
16426
16427 =item COPYRIGHT
16428
16429 =back
16430
16431 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
16432 general-utility scalar subroutines
16433
16434 =over 4
16435
16436 =item SYNOPSIS
16437
16438 =item DESCRIPTION
16439
16440 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
16441 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
16442 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
16443
16444 =item KNOWN BUGS
16445
16446 =item COPYRIGHT
16447
16448 =item BLATANT PLUG
16449
16450 =back
16451
16452 =head2 Locale::Constants - constants for Locale codes
16453
16454 =over 4
16455
16456 =item SYNOPSIS
16457
16458 =item DESCRIPTION
16459
16460 =item KNOWN BUGS AND LIMITATIONS
16461
16462 =item SEE ALSO
16463
16464 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
16465
16466 =item AUTHOR
16467
16468 =item COPYRIGHT
16469
16470 =back
16471
16472 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
16473
16474 =over 4
16475
16476 =item SYNOPSIS
16477
16478 =item DESCRIPTION
16479
16480 B<alpha-2>, B<alpha-3>, B<numeric>
16481
16482 =item CONVERSION ROUTINES
16483
16484 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
16485 country_code2code( CODE, CODESET, CODESET )
16486
16487 =item QUERY ROUTINES
16488
16489 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
16490
16491 =item SEMI-PRIVATE ROUTINES
16492
16493 =over 4
16494
16495 =item alias_code
16496
16497 =item rename_country
16498
16499 =back
16500
16501 =item EXAMPLES
16502
16503 =item DOMAIN NAMES
16504
16505 =item KNOWN BUGS AND LIMITATIONS
16506
16507 =item SEE ALSO
16508
16509 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
16510 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
16511 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
16512 http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
16513
16514 =item AUTHOR
16515
16516 =item COPYRIGHT
16517
16518 =back
16519
16520 =head2 Locale::Currency - ISO three letter codes for currency
16521 identification (ISO 4217)
16522
16523 =over 4
16524
16525 =item SYNOPSIS
16526
16527 =item DESCRIPTION
16528
16529 XTS, XXX
16530
16531 =item CONVERSION ROUTINES
16532
16533 code2currency(), currency2code()
16534
16535 =item QUERY ROUTINES
16536
16537 C<all_currency_codes()>, C<all_currency_names()>
16538
16539 =item EXAMPLES
16540
16541 =item KNOWN BUGS AND LIMITATIONS
16542
16543 =item SEE ALSO
16544
16545 Locale::Country, Locale::Script, ISO 4217:1995,
16546 http://www.bsi-global.com/iso4217currency
16547
16548 =item AUTHOR
16549
16550 =item COPYRIGHT
16551
16552 =back
16553
16554 =head2 Locale::Language - ISO two letter codes for language identification
16555 (ISO 639)
16556
16557 =over 4
16558
16559 =item SYNOPSIS
16560
16561 =item DESCRIPTION
16562
16563 =item CONVERSION ROUTINES
16564
16565 code2language(), language2code()
16566
16567 =item QUERY ROUTINES
16568
16569 C<all_language_codes()>, C<all_language_names()>
16570
16571 =item EXAMPLES
16572
16573 =item KNOWN BUGS AND LIMITATIONS
16574
16575 =item SEE ALSO
16576
16577 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
16578 http://lcweb.loc.gov/standards/iso639-2/langhome.html
16579
16580 =item AUTHOR
16581
16582 =item COPYRIGHT
16583
16584 =back
16585
16586 =head2 Locale::Maketext - framework for localization
16587
16588 =over 4
16589
16590 =item SYNOPSIS
16591
16592 =item DESCRIPTION
16593
16594 =item QUICK OVERVIEW
16595
16596 =item METHODS
16597
16598 =over 4
16599
16600 =item Construction Methods
16601
16602 =item The "maketext" Method
16603
16604 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
16605
16606 =item Utility Methods
16607
16608 $language->quant($number, $singular), $language->quant($number, $singular,
16609 $plural), $language->quant($number, $singular, $plural, $negative),
16610 $language->numf($number), $language->sprintf($format, @items),
16611 $language->language_tag(), $language->encoding()
16612
16613 =item Language Handle Attributes and Internals
16614
16615 =back
16616
16617 =item LANGUAGE CLASS HIERARCHIES
16618
16619 =item ENTRIES IN EACH LEXICON
16620
16621 =item BRACKET NOTATION
16622
16623 =item AUTO LEXICONS
16624
16625 =item CONTROLLING LOOKUP FAILURE
16626
16627 =item HOW TO USE MAKETEXT
16628
16629 =item SEE ALSO
16630
16631 =item COPYRIGHT AND DISCLAIMER
16632
16633 =item AUTHOR
16634
16635 =back
16636
16637 =head2 Locale::Maketext::TPJ13 -- article about software localization
16638
16639 =over 4
16640
16641 =item SYNOPSIS
16642
16643 =item DESCRIPTION
16644
16645 =item Localization and Perl: gettext breaks, Maketext fixes
16646
16647 =over 4
16648
16649 =item A Localization Horror Story: It Could Happen To You
16650
16651 =item The Linguistic View
16652
16653 =item Breaking gettext
16654
16655 =item Replacing gettext
16656
16657 =item Buzzwords: Abstraction and Encapsulation
16658
16659 =item Buzzword: Isomorphism
16660
16661 =item Buzzword: Inheritance
16662
16663 =item Buzzword: Concision
16664
16665 =item The Devil in the Details
16666
16667 =item The Proof in the Pudding: Localizing Web Sites
16668
16669 =item References
16670
16671 =back
16672
16673 =back
16674
16675 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
16676
16677 =over 4
16678
16679 =item SYNOPSIS
16680
16681 =item DESCRIPTION
16682
16683 B<alpha-2>, B<alpha-3>, B<numeric>
16684
16685 =over 4
16686
16687 =item SPECIAL CODES
16688
16689 =back
16690
16691 =item CONVERSION ROUTINES
16692
16693 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
16694 script_code2code( CODE, CODESET, CODESET )
16695
16696 =item QUERY ROUTINES
16697
16698 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
16699
16700 =item EXAMPLES
16701
16702 =item KNOWN BUGS AND LIMITATIONS
16703
16704 =item SEE ALSO
16705
16706 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
16707 http://www.evertype.com/standards/iso15924/
16708
16709 =item AUTHOR
16710
16711 =item COPYRIGHT
16712
16713 =back
16714
16715 =head2 MIME::Base64 - Encoding and decoding of base64 strings
16716
16717 =over 4
16718
16719 =item SYNOPSIS
16720
16721 =item DESCRIPTION
16722
16723 encode_base64($str), encode_base64($str, $eol);, decode_base64($str)
16724
16725 =item DIAGNOSTICS
16726
16727 Premature end of base64 data, Premature padding of base64 data
16728
16729 =item EXAMPLES
16730
16731 =item COPYRIGHT
16732
16733 =item SEE ALSO
16734
16735 =back
16736
16737 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
16738 of quoted-printable strings
16739
16740 =over 4
16741
16742 =item SYNOPSIS
16743
16744 =item DESCRIPTION
16745
16746 encode_qp($str), encode_qp($str, $eol), decode_qp($str);
16747
16748 =item COPYRIGHT
16749
16750 =item SEE ALSO
16751
16752 =back
16753
16754 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
16755 strings
16756
16757 =over 4
16758
16759 =item SYNOPSIS
16760
16761 =item DESCRIPTION
16762
16763 encode_qp($str), encode_qp($str, $eol), decode_qp($str);
16764
16765 =item COPYRIGHT
16766
16767 =item SEE ALSO
16768
16769 =back
16770
16771 =head2 Math::BigFloat - Arbitrary size floating point math package
16772
16773 =over 4
16774
16775 =item SYNOPSIS
16776
16777 =item DESCRIPTION
16778
16779 =over 4
16780
16781 =item Canonical notation
16782
16783 =item Output
16784
16785 =item C<mantissa()>, C<exponent()> and C<parts()>
16786
16787 =item Accuracy vs. Precision
16788
16789 =item Rounding
16790
16791 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
16792 ), fround  ( -$scale ) and fround ( 0 )
16793
16794 =back
16795
16796 =item EXAMPLES
16797
16798   # not ready yet
16799
16800 =item Autocreating constants
16801
16802 =over 4
16803
16804 =item Math library
16805
16806 =item Using Math::BigInt::Lite
16807
16808 =back
16809
16810 =item BUGS
16811
16812 =item CAVEATS
16813
16814 stringify, bstr(), bdiv, Modifying and =, bpow
16815
16816 =item SEE ALSO
16817
16818 =item LICENSE
16819
16820 =item AUTHORS
16821
16822 =back
16823
16824 =head2 Math::BigInt - Arbitrary size integer math package
16825
16826 =over 4
16827
16828 =item SYNOPSIS
16829
16830 =item DESCRIPTION
16831
16832 Input, Output
16833
16834 =item METHODS
16835
16836 =over 4
16837
16838 =item config
16839
16840 =item accuracy
16841
16842 =item precision
16843
16844 =item brsft
16845
16846 =item new
16847
16848 =item bnan
16849
16850 =item bzero
16851
16852 =item binf
16853
16854 =item bone
16855
16856 =item is_one()/is_zero()/is_nan()/is_inf()
16857
16858 =item is_pos()/is_neg()
16859
16860         $x->is_pos();                   # true if >= 0
16861         $x->is_neg();                   # true if <  0
16862
16863 =item is_odd()/is_even()/is_int()
16864
16865 =item bcmp
16866
16867 =item bacmp
16868
16869 =item sign
16870
16871 =item digit
16872
16873 =item bneg
16874
16875 =item babs
16876
16877 =item bnorm
16878
16879 =item bnot
16880
16881 =item binc
16882
16883 =item bdec
16884
16885 =item badd
16886
16887 =item bsub
16888
16889 =item bmul
16890
16891 =item bdiv
16892
16893 =item bmod
16894
16895 =item bmodinv
16896
16897 =item bmodpow
16898
16899 =item bpow
16900
16901 =item blsft
16902
16903 =item brsft
16904
16905 =item band
16906
16907 =item bior
16908
16909 =item bxor
16910
16911 =item bnot
16912
16913 =item bsqrt
16914
16915 =item bfac
16916
16917 =item round
16918
16919 =item bround
16920
16921 =item bfround
16922
16923 =item bfloor
16924
16925 =item bceil
16926
16927 =item bgcd
16928
16929 =item blcm
16930
16931 =item exponent
16932
16933 =item mantissa
16934
16935 =item parts
16936
16937 =item copy
16938
16939 =item as_int
16940
16941 =item bsstr
16942
16943 =item as_hex
16944
16945 =item as_bin
16946
16947 =back
16948
16949 =item ACCURACY and PRECISION
16950
16951 =over 4
16952
16953 =item Precision P
16954
16955 =item Accuracy A
16956
16957 =item Fallback F
16958
16959 =item Rounding mode R
16960
16961 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
16962 (significant digits), Setting/Accessing, Creating numbers, Usage,
16963 Precedence, Overriding globals, Local settings, Rounding, Default values,
16964 Remarks
16965
16966 =back
16967
16968 =item INTERNALS
16969
16970 =over 4
16971
16972 =item MATH LIBRARY
16973
16974 =item SIGN
16975
16976 =item mantissa(), exponent() and parts()
16977
16978 =back
16979
16980 =item EXAMPLES
16981
16982   use Math::BigInt;
16983
16984 =item Autocreating constants
16985
16986 =item PERFORMANCE
16987
16988 =over 4
16989
16990 =item Alternative math libraries
16991
16992 =item SUBCLASSING
16993
16994 =back
16995
16996 =item Subclassing Math::BigInt
16997
16998 =item UPGRADING
16999
17000 =over 4
17001
17002 =item Auto-upgrade
17003
17004 bsqrt(), div(), blog()
17005
17006 =back
17007
17008 =item BUGS
17009
17010 broot() does not work, Out of Memory!, Fails to load Calc on Perl prior
17011 5.6.0
17012
17013 =item CAVEATS
17014
17015 bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling,
17016 Modifying and =, bpow, Overloading -$x, Mixing different object types,
17017 bsqrt(), brsft()
17018
17019 =item LICENSE
17020
17021 =item SEE ALSO
17022
17023 =item AUTHORS
17024
17025 =back
17026
17027 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
17028
17029 =over 4
17030
17031 =item SYNOPSIS
17032
17033 =item DESCRIPTION
17034
17035 =item STORAGE
17036
17037 =item METHODS
17038
17039 =item WRAP YOUR OWN
17040
17041 =item LICENSE
17042
17043 This program is free software; you may redistribute it and/or modify it
17044 under
17045 the same terms as Perl itself. 
17046
17047 =item AUTHORS
17048
17049 =item SEE ALSO
17050
17051 =back
17052
17053 =head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code
17054
17055 =over 4
17056
17057 =item SYNOPSIS
17058
17059 =item DESCRIPTION
17060
17061 =item METHODS
17062
17063 =item LICENSE
17064
17065 This program is free software; you may redistribute it and/or modify it
17066 under
17067 the same terms as Perl itself. 
17068
17069 =item AUTHORS
17070
17071 =item SEE ALSO
17072
17073 =back
17074
17075 =head2 Math::BigRat - arbitrarily big rational numbers
17076
17077 =over 4
17078
17079 =item SYNOPSIS
17080
17081 =item DESCRIPTION
17082
17083 =over 4
17084
17085 =item MATH LIBRARY
17086
17087 =back
17088
17089 =item METHODS
17090
17091 =over 4
17092
17093 =item new()
17094
17095 =item numerator()
17096
17097 =item denominator()
17098
17099         $d = $x->denominator();
17100
17101 =item parts()
17102
17103 =item as_number()
17104
17105 =item bfac()
17106
17107 =item blog()
17108
17109 =item bround()/round()/bfround()
17110
17111 =item bmod()
17112
17113 =item is_one()
17114
17115 =item is_zero()
17116
17117 =item is_positive()
17118
17119 =item is_negative()
17120
17121 =item is_int()
17122
17123 =item is_odd()
17124
17125 =item is_even()
17126
17127 =item bceil()
17128
17129 =item bfloor()
17130
17131         $x->bfloor();
17132
17133 =item bsqrt()
17134
17135         $x->bsqrt();
17136
17137 =item config
17138
17139 =back
17140
17141 =item BUGS
17142
17143 inf handling (partial), NaN handling (partial), rounding (not implemented
17144 except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(),
17145 blog(), bmodinv() and bmodpow() (partial)
17146
17147 =item LICENSE
17148
17149 =item SEE ALSO
17150
17151 =item AUTHORS
17152
17153 =back
17154
17155 =head2 Math::Complex - complex numbers and associated mathematical
17156 functions
17157
17158 =over 4
17159
17160 =item SYNOPSIS
17161
17162 =item DESCRIPTION
17163
17164 =item OPERATIONS
17165
17166 =item CREATION
17167
17168 =item STRINGIFICATION
17169
17170 =over 4
17171
17172 =item CHANGED IN PERL 5.6
17173
17174 =back
17175
17176 =item USAGE
17177
17178 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
17179
17180 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
17181
17182 =item BUGS
17183
17184 =item AUTHORS
17185
17186 =back
17187
17188 =head2 Math::Trig - trigonometric functions
17189
17190 =over 4
17191
17192 =item SYNOPSIS
17193
17194 =item DESCRIPTION
17195
17196 =item TRIGONOMETRIC FUNCTIONS
17197
17198 B<tan>
17199
17200 =over 4
17201
17202 =item ERRORS DUE TO DIVISION BY ZERO
17203
17204 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
17205
17206 =back
17207
17208 =item PLANE ANGLE CONVERSIONS
17209
17210 =item RADIAL COORDINATE CONVERSIONS
17211
17212 =over 4
17213
17214 =item COORDINATE SYSTEMS
17215
17216 =item 3-D ANGLE CONVERSIONS
17217
17218 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
17219 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
17220
17221 =back
17222
17223 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
17224
17225 =item EXAMPLES
17226
17227 =over 4
17228
17229 =item CAVEAT FOR GREAT CIRCLE FORMULAS
17230
17231 =back
17232
17233 =item BUGS
17234
17235 =item AUTHORS
17236
17237 =back
17238
17239 =head2 Memoize - Make functions faster by trading space for time
17240
17241 =over 4
17242
17243 =item SYNOPSIS
17244
17245 =item DESCRIPTION
17246
17247 =item DETAILS
17248
17249 =item OPTIONS
17250
17251 =over 4
17252
17253 =item INSTALL
17254
17255 =item NORMALIZER
17256
17257 =item C<SCALAR_CACHE>, C<LIST_CACHE>
17258
17259 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
17260
17261 =back
17262
17263 =item OTHER FACILITIES
17264
17265 =over 4
17266
17267 =item C<unmemoize>
17268
17269 =item C<flush_cache>
17270
17271 =back
17272
17273 =item CAVEATS
17274
17275 =item PERSISTENT CACHE SUPPORT
17276
17277 =item EXPIRATION SUPPORT
17278
17279 =item BUGS
17280
17281 =item MAILING LIST
17282
17283 =item AUTHOR
17284
17285 =item COPYRIGHT AND LICENSE
17286
17287 =item THANK YOU
17288
17289 =back
17290
17291 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
17292 Storable use
17293
17294 =over 4
17295
17296 =item DESCRIPTION
17297
17298 =back
17299
17300 =head2 Memoize::Expire - Plug-in module for automatic expiration of
17301 memoized values
17302
17303 =over 4
17304
17305 =item SYNOPSIS
17306
17307 =item DESCRIPTION
17308
17309 =item INTERFACE
17310
17311  TIEHASH,  EXISTS,  STORE
17312
17313 =item ALTERNATIVES
17314
17315 =item CAVEATS
17316
17317 =item AUTHOR
17318
17319 =item SEE ALSO
17320
17321 =back
17322
17323 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
17324
17325 =over 4
17326
17327 =item DESCRIPTION
17328
17329 =back
17330
17331 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
17332
17333 =over 4
17334
17335 =item DESCRIPTION
17336
17337 =back
17338
17339 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
17340 Storable use
17341
17342 =over 4
17343
17344 =item DESCRIPTION
17345
17346 =back
17347
17348 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
17349 Storable use
17350
17351 =over 4
17352
17353 =item DESCRIPTION
17354
17355 =back
17356
17357 =head2 Memoize::Storable - store Memoized data in Storable database
17358
17359 =over 4
17360
17361 =item DESCRIPTION
17362
17363 =back
17364
17365 =head2 NDBM_File - Tied access to ndbm files
17366
17367 =over 4
17368
17369 =item SYNOPSIS
17370
17371 =item DESCRIPTION
17372
17373 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17374
17375 =item DIAGNOSTICS
17376
17377 =over 4
17378
17379 =item C<ndbm store returned -1, errno 22, key "..." at ...>
17380
17381 =back
17382
17383 =item BUGS AND WARNINGS
17384
17385 =back
17386
17387 =head2 NEXT - Provide a pseudo-class NEXT (et al) that allows method
17388 redispatch
17389
17390 =over 4
17391
17392 =item SYNOPSIS
17393
17394 =item DESCRIPTION
17395
17396 =over 4
17397
17398 =item Enforcing redispatch
17399
17400 =item Avoiding repetitions
17401
17402 =item Invoking all versions of a method with a single call
17403
17404 =item Using C<EVERY> methods
17405
17406 =back
17407
17408 =item AUTHOR
17409
17410 =item BUGS AND IRRITATIONS
17411
17412 =item COPYRIGHT
17413
17414 =back
17415
17416 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
17417
17418 =over 4
17419
17420 =item SYNOPSIS
17421
17422 =item DESCRIPTION
17423
17424 =item USER METHODS
17425
17426 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
17427 dataend ()
17428
17429 =item CLASS METHODS
17430
17431 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
17432 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
17433 ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh ()
17434
17435 =item EXPORTS
17436
17437 =item AUTHOR
17438
17439 =item COPYRIGHT
17440
17441 =back
17442
17443 =head2 Net::Config - Local configuration data for libnet
17444
17445 =over 4
17446
17447 =item SYNOPSYS
17448
17449 =item DESCRIPTION
17450
17451 =item METHODS
17452
17453 requires_firewall HOST
17454
17455 =item NetConfig VALUES
17456
17457 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
17458 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
17459 ftp_int_pasive, local_netmask, test_hosts, test_exists
17460
17461 =back
17462
17463 =head2 Net::Domain - Attempt to evaluate the current host's internet name
17464 and domain
17465
17466 =over 4
17467
17468 =item SYNOPSIS
17469
17470 =item DESCRIPTION
17471
17472 hostfqdn (), hostname (), hostdomain ()
17473
17474 =item AUTHOR
17475
17476 =item COPYRIGHT
17477
17478 =back
17479
17480 =head2 Net::FTP - FTP Client class
17481
17482 =over 4
17483
17484 =item SYNOPSIS
17485
17486 =item DESCRIPTION
17487
17488 =item OVERVIEW
17489
17490 =item CONSTRUCTOR
17491
17492 new ([ HOST ] [, OPTIONS ])
17493
17494 =item METHODS
17495
17496 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
17497 site (ARGS), ascii, binary, rename ( OLDNAME, NEWNAME ), delete ( FILENAME
17498 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR [,
17499 RECURSE ]), mkdir ( DIR [, RECURSE ]), alloc ( SIZE [, RECORD_SIZE] ), ls (
17500 [ DIR ] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ),
17501 put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE
17502 ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ),
17503 size ( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[
17504 BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ DIR ] ), retr ( FILE ),
17505 stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [ PORT ] ), pasv (),
17506 pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_xfer_unique (
17507 SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( NON_PASV_SERVER ),
17508 abort (), quit ()
17509
17510 =over 4
17511
17512 =item Methods for the adventurous
17513
17514 quot (CMD [,ARGS])
17515
17516 =back
17517
17518 =item THE dataconn CLASS
17519
17520 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
17521 bytes_read (), abort (), close ()
17522
17523 =item UNIMPLEMENTED
17524
17525 B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
17526
17527 =item REPORTING BUGS
17528
17529 =item AUTHOR
17530
17531 =item SEE ALSO
17532
17533 =item USE EXAMPLES
17534
17535 http://www.csh.rit.edu/~adam/Progs/
17536
17537 =item CREDITS
17538
17539 =item COPYRIGHT
17540
17541 =back
17542
17543 =head2 Net::NNTP - NNTP Client class
17544
17545 =over 4
17546
17547 =item SYNOPSIS
17548
17549 =item DESCRIPTION
17550
17551 =item CONSTRUCTOR
17552
17553 new ( [ HOST ] [, OPTIONS ])
17554
17555 =item METHODS
17556
17557 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
17558 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
17559 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
17560 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
17561 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
17562 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
17563 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
17564
17565 =over 4
17566
17567 =item Extension methods
17568
17569 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
17570 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
17571 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
17572 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
17573 GROUP ] ), reader
17574
17575 =back
17576
17577 =item UNSUPPORTED
17578
17579 =item DEFINITIONS
17580
17581 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
17582
17583 =item SEE ALSO
17584
17585 =item AUTHOR
17586
17587 =item COPYRIGHT
17588
17589 =back
17590
17591 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
17592
17593 =over 4
17594
17595 =item SYNOPSIS
17596
17597 =item DESCRIPTION
17598
17599 =item CONSTRUCTOR
17600
17601 new ( [ HOST ] [, OPTIONS ] 0
17602
17603 =item METHODS
17604
17605 auth ( USERNAME, PASSWORD ), user ( USER ), pass ( PASS ), login ( [ USER
17606 [, PASS ]] ), apop ( [ USER [, PASS ]] ), banner (), capa (),  capabilities
17607 (), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [, FH ]
17608 ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ]
17609 ), delete ( MSGNUM ), reset (), quit ()
17610
17611 =item NOTES
17612
17613 =item SEE ALSO
17614
17615 =item AUTHOR
17616
17617 =item COPYRIGHT
17618
17619 =back
17620
17621 =head2 Net::Ping - check a remote host for reachability
17622
17623 =over 4
17624
17625 =item SYNOPSIS
17626
17627 =item DESCRIPTION
17628
17629 =over 4
17630
17631 =item Functions
17632
17633 Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos
17634 ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
17635 $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
17636 $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
17637 [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host
17638 [, $timeout]);
17639
17640 =back
17641
17642 =item NOTES
17643
17644 =item INSTALL
17645
17646 =item BUGS
17647
17648 =item AUTHORS
17649
17650 =item COPYRIGHT
17651
17652 =back
17653
17654 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
17655
17656 =over 4
17657
17658 =item SYNOPSIS
17659
17660 =item DESCRIPTION
17661
17662 =item EXAMPLES
17663
17664 =item CONSTRUCTOR
17665
17666 new ( [ HOST ] [, OPTIONS ] )
17667
17668 =item METHODS
17669
17670 banner (), domain (), hello ( DOMAIN ), host (), etrn ( DOMAIN ), auth (
17671 USERNAME, PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ),
17672 send_or_mail ( ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient (
17673 ADDRESS [, ADDRESS, [...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]]
17674 ), cc ( ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ),
17675 data ( [ DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [
17676 $subject ] ), quit ()
17677
17678 =item ADDRESSES
17679
17680 =item SEE ALSO
17681
17682 =item AUTHOR
17683
17684 =item COPYRIGHT
17685
17686 =back
17687
17688 =head2 Net::Time - time and daytime network client interface
17689
17690 =over 4
17691
17692 =item SYNOPSIS
17693
17694 =item DESCRIPTION
17695
17696 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
17697 PROTOCOL [, TIMEOUT]]])
17698
17699 =item AUTHOR
17700
17701 =item COPYRIGHT
17702
17703 =back
17704
17705 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
17706 functions
17707
17708 =over 4
17709
17710 =item SYNOPSIS
17711
17712 =item DESCRIPTION
17713
17714 =item EXAMPLES
17715
17716 =item NOTE
17717
17718 =item AUTHOR
17719
17720 =back
17721
17722 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
17723
17724 =over 4
17725
17726 =item DESCRIPTION
17727
17728 =over 4
17729
17730 =item Where to get this document
17731
17732 =item How to contribute to this document
17733
17734 =back
17735
17736 =item Author and Copyright Information
17737
17738 =over 4
17739
17740 =item Disclaimer
17741
17742 =back
17743
17744 =item Obtaining and installing libnet
17745
17746 =over 4
17747
17748 =item What is libnet ?
17749
17750 =item Which version of perl do I need ?
17751
17752 =item What other modules do I need ?
17753
17754 =item What machines support libnet ?
17755
17756 =item Where can I get the latest libnet release
17757
17758 =back
17759
17760 =item Using Net::FTP
17761
17762 =over 4
17763
17764 =item How do I download files from an FTP server ?
17765
17766 =item How do I transfer files in binary mode ?
17767
17768 =item How can I get the size of a file on a remote FTP server ?
17769
17770 =item How can I get the modification time of a file on a remote FTP server
17771 ?
17772
17773 =item How can I change the permissions of a file on a remote server ?
17774
17775 =item Can I do a reget operation like the ftp command ?
17776
17777 =item How do I get a directory listing from an FTP server ?
17778
17779 =item Changing directory to "" does not fail ?
17780
17781 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
17782
17783 =item I am behind an FTP proxy firewall, but cannot access machines outside
17784 ?
17785
17786 =item My ftp proxy firewall does not listen on port 21
17787
17788 =item Is it possible to change the file permissions of a file on an FTP
17789 server ?
17790
17791 =item I have seen scripts call a method message, but cannot find it
17792 documented ?
17793
17794 =item Why does Net::FTP not implement mput and mget methods
17795
17796 =back
17797
17798 =item Using Net::SMTP
17799
17800 =over 4
17801
17802 =item Why can't the part of an Email address after the @ be used as the
17803 hostname ?
17804
17805 =item Why does Net::SMTP not do DNS MX lookups ?
17806
17807 =item The verify method always returns true ?
17808
17809 =back
17810
17811 =item Debugging scripts
17812
17813 =over 4
17814
17815 =item How can I debug my scripts that use Net::* modules ?
17816
17817 =back
17818
17819 =item AUTHOR AND COPYRIGHT
17820
17821 =back
17822
17823 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
17824 functions
17825
17826 =over 4
17827
17828 =item SYNOPSIS
17829
17830 =item DESCRIPTION
17831
17832 =item EXAMPLES
17833
17834 =item NOTE
17835
17836 =item AUTHOR
17837
17838 =back
17839
17840 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
17841 functions
17842
17843 =over 4
17844
17845 =item SYNOPSIS
17846
17847 =item DESCRIPTION
17848
17849 =item NOTE
17850
17851 =item AUTHOR
17852
17853 =back
17854
17855 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
17856 functions
17857
17858 =over 4
17859
17860 =item SYNOPSIS
17861
17862 =item DESCRIPTION
17863
17864 =item EXAMPLES
17865
17866 =item NOTE
17867
17868 =item AUTHOR
17869
17870 =back
17871
17872 =head2 Netrc, Net::Netrc - OO interface to users netrc file
17873
17874 =over 4
17875
17876 =item SYNOPSIS
17877
17878 =item DESCRIPTION
17879
17880 =item THE .netrc FILE
17881
17882 machine name, default, login name, password string, account string, macdef
17883 name
17884
17885 =item CONSTRUCTOR
17886
17887 lookup ( MACHINE [, LOGIN ])
17888
17889 =item METHODS
17890
17891 login (), password (), account (), lpa ()
17892
17893 =item AUTHOR
17894
17895 =item SEE ALSO
17896
17897 =item COPYRIGHT
17898
17899 =back
17900
17901 =head2 O - Generic interface to Perl Compiler backends
17902
17903 =over 4
17904
17905 =item SYNOPSIS
17906
17907 =item DESCRIPTION
17908
17909 =item CONVENTIONS
17910
17911 =item IMPLEMENTATION
17912
17913 =item BUGS
17914
17915 =item AUTHOR
17916
17917 =back
17918
17919 =head2 ODBM_File - Tied access to odbm files
17920
17921 =over 4
17922
17923 =item SYNOPSIS
17924
17925 =item DESCRIPTION
17926
17927 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17928
17929 =item DIAGNOSTICS
17930
17931 =over 4
17932
17933 =item C<odbm store returned -1, errno 22, key "..." at ...>
17934
17935 =back
17936
17937 =item BUGS AND WARNINGS
17938
17939 =back
17940
17941 =head2 Opcode - Disable named opcodes when compiling perl code
17942
17943 =over 4
17944
17945 =item SYNOPSIS
17946
17947 =item DESCRIPTION
17948
17949 =item NOTE
17950
17951 =item WARNING
17952
17953 =item Operator Names and Operator Lists
17954
17955 an operator name (opname), an operator tag name (optag), a negated opname
17956 or optag, an operator set (opset)
17957
17958 =item Opcode Functions
17959
17960 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
17961 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
17962 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
17963 opdump (PAT)
17964
17965 =item Manipulating Opsets
17966
17967 =item TO DO (maybe)
17968
17969 =back
17970
17971 =over 4
17972
17973 =item Predefined Opcode Tags
17974
17975 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
17976 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
17977 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
17978 :dangerous
17979
17980 =item SEE ALSO
17981
17982 =item AUTHORS
17983
17984 =back
17985
17986 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
17987 compartments
17988
17989 =over 4
17990
17991 =item SYNOPSIS
17992
17993 =item DESCRIPTION
17994
17995 a new namespace, an operator mask
17996
17997 =item WARNING
17998
17999 =over 4
18000
18001 =item RECENT CHANGES
18002
18003 =item Methods in class Safe
18004
18005 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
18006 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
18007 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
18008 root (NAMESPACE), mask (MASK)
18009
18010 =item Some Safety Issues
18011
18012 Memory, CPU, Snooping, Signals, State Changes
18013
18014 =item AUTHOR
18015
18016 =back
18017
18018 =back
18019
18020 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
18021 compiling
18022
18023 =over 4
18024
18025 =item SYNOPSIS  
18026
18027 =item DESCRIPTION
18028
18029 =item SEE ALSO
18030
18031 =back
18032
18033 =head2 POSIX - Perl interface to IEEE Std 1003.1
18034
18035 =over 4
18036
18037 =item SYNOPSIS
18038
18039 =item DESCRIPTION
18040
18041 =item NOTE
18042
18043 =item CAVEATS 
18044
18045 =item FUNCTIONS
18046
18047 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
18048 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
18049 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
18050 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
18051 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
18052 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
18053 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
18054 fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv,
18055 geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid,
18056 getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha,
18057 isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace,
18058 isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime,
18059 log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr,
18060 memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice,
18061 offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc,
18062 putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename,
18063 rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid,
18064 setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
18065 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
18066 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
18067 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
18068 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
18069 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
18070 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
18071 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
18072 wctomb, write
18073
18074 =item CLASSES
18075
18076 =over 4
18077
18078 =item POSIX::SigAction
18079
18080 new, handler, mask, flags, safe
18081
18082 =item POSIX::SigSet
18083
18084 new, addset, delset, emptyset, fillset, ismember
18085
18086 =item POSIX::Termios
18087
18088 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
18089 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
18090 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
18091 field values, c_cflag field values, c_iflag field values, c_lflag field
18092 values, c_oflag field values
18093
18094 =back
18095
18096 =item PATHNAME CONSTANTS
18097
18098 Constants
18099
18100 =item POSIX CONSTANTS
18101
18102 Constants
18103
18104 =item SYSTEM CONFIGURATION
18105
18106 Constants
18107
18108 =item ERRNO
18109
18110 Constants
18111
18112 =item FCNTL
18113
18114 Constants
18115
18116 =item FLOAT
18117
18118 Constants
18119
18120 =item LIMITS
18121
18122 Constants
18123
18124 =item LOCALE
18125
18126 Constants
18127
18128 =item MATH
18129
18130 Constants
18131
18132 =item SIGNAL
18133
18134 Constants
18135
18136 =item STAT
18137
18138 Constants, Macros
18139
18140 =item STDLIB
18141
18142 Constants
18143
18144 =item STDIO
18145
18146 Constants
18147
18148 =item TIME
18149
18150 Constants
18151
18152 =item UNISTD
18153
18154 Constants
18155
18156 =item WAIT
18157
18158 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
18159 WTERMSIG, WIFSTOPPED, WSTOPSIG
18160
18161 =back
18162
18163 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
18164 name space
18165
18166 =over 4
18167
18168 =item SYNOPSIS
18169
18170 =item DESCRIPTION
18171
18172 :unix, :stdio, :perlio, :crlf, :mmap, :utf8, :bytes, :raw, :pop, :win32
18173
18174 =over 4
18175
18176 =item Custom Layers
18177
18178 :encoding, :via
18179
18180 =item Alternatives to raw
18181
18182 =item Defaults and how to override them
18183
18184 =item Querying the layers of filehandles
18185
18186 =back
18187
18188 =item AUTHOR
18189
18190 =item SEE ALSO
18191
18192 =back
18193
18194 =head2 PerlIO::encoding - encoding layer
18195
18196 =over 4
18197
18198 =item SYNOPSIS
18199
18200 =item DESCRIPTION
18201
18202 =item SEE ALSO
18203
18204 =back
18205
18206 =head2 PerlIO::scalar - in-memory IO, scalar IO
18207
18208 =over 4
18209
18210 =item SYNOPSIS
18211
18212 =item DESCRIPTION
18213
18214 =item IMPLEMENTATION NOTE
18215
18216 =back
18217
18218 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
18219
18220 =over 4
18221
18222 =item SYNOPSIS
18223
18224 =item DESCRIPTION
18225
18226 =item EXPECTED METHODS
18227
18228 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
18229 $obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]),
18230 $obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]),
18231 $obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh),
18232 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
18233 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
18234 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
18235 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
18236
18237 =item EXAMPLES
18238
18239 =over 4
18240
18241 =item Example - a Hexadecimal Handle
18242
18243 =back
18244
18245 =back
18246
18247 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
18248
18249 =over 4
18250
18251 =item SYNOPSIS
18252
18253 =item DESCRIPTION
18254
18255 =item REQUIRED MODULES
18256
18257 =item SEE ALSO
18258
18259 =item ACKNOWLEDGEMENTS
18260
18261 =item COPYRIGHT
18262
18263 =back
18264
18265 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
18266
18267 =over 4
18268
18269 =item SYNOPSIS
18270
18271 =item OPTIONS/ARGUMENTS
18272
18273 =over 4
18274
18275 =item podchecker()
18276
18277 B<-warnings> =E<gt> I<val>
18278
18279 =back
18280
18281 =item DESCRIPTION
18282
18283 =item DIAGNOSTICS
18284
18285 =over 4
18286
18287 =item Errors
18288
18289 empty =headn, =over on line I<N> without closing =back, =item without
18290 previous =over, =back without previous =over, No argument for =begin, =end
18291 without =begin, Nested =begin's, =for without formatter specification,
18292 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
18293 interior-sequence "I<SEQ>", nested commands
18294 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
18295 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
18296 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
18297 after =back
18298
18299 =item Warnings
18300
18301 multiple occurrence of link target I<name>, line containing nothing but
18302 whitespace in paragraph, file does not start with =head, previous =item has
18303 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
18304 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
18305 items in =over, No argument for =item, empty section in previous paragraph,
18306 Verbatim paragraph in NAME section, =headI<n> without preceding higher
18307 level
18308
18309 =item Hyperlinks
18310
18311 ignoring leading/trailing whitespace in link, (section) in '$page'
18312 deprecated, alternative text/node '%s' contains non-escaped | or /
18313
18314 =back
18315
18316 =item RETURN VALUE
18317
18318 =item EXAMPLES
18319
18320 =item INTERFACE
18321
18322 =back
18323
18324 C<Pod::Checker-E<gt>new( %options )>
18325
18326 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
18327 @args )>
18328
18329 C<$checker-E<gt>num_errors()>
18330
18331 C<$checker-E<gt>num_warnings()>
18332
18333 C<$checker-E<gt>name()>
18334
18335 C<$checker-E<gt>node()>
18336
18337 C<$checker-E<gt>idx()>
18338
18339 C<$checker-E<gt>hyperlink()>
18340
18341 =over 4
18342
18343 =item AUTHOR
18344
18345 =back
18346
18347 =head2 Pod::Find - find POD documents in directory trees
18348
18349 =over 4
18350
18351 =item SYNOPSIS
18352
18353 =item DESCRIPTION
18354
18355 =back
18356
18357 =over 4
18358
18359 =item C<pod_find( { %opts } , @directories )>
18360
18361 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
18362 1>
18363
18364 =back
18365
18366 =over 4
18367
18368 =item C<simplify_name( $str )>
18369
18370 =back
18371
18372 =over 4
18373
18374 =item C<pod_where( { %opts }, $pod )>
18375
18376 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
18377 1>
18378
18379 =back
18380
18381 =over 4
18382
18383 =item C<contains_pod( $file , $verbose )>
18384
18385 =back
18386
18387 =over 4
18388
18389 =item AUTHOR
18390
18391 =item SEE ALSO
18392
18393 =back
18394
18395 =head2 Pod::Html - module to convert pod files to HTML
18396
18397 =over 4
18398
18399 =item SYNOPSIS
18400
18401 =item DESCRIPTION
18402
18403 =item ARGUMENTS
18404
18405 backlink, cachedir, css, flush, header, help, hiddendirs, htmldir,
18406 htmlroot, index, infile, libpods, netscape, outfile, podpath, podroot,
18407 quiet, recurse, title, verbose
18408
18409 =item EXAMPLE
18410
18411 =item ENVIRONMENT
18412
18413 =item AUTHOR
18414
18415 =item SEE ALSO
18416
18417 =item COPYRIGHT
18418
18419 =back
18420
18421 =head2 Pod::InputObjects - objects representing POD input paragraphs,
18422 commands, etc.
18423
18424 =over 4
18425
18426 =item SYNOPSIS
18427
18428 =item REQUIRES
18429
18430 =item EXPORTS
18431
18432 =item DESCRIPTION
18433
18434 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
18435 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
18436
18437 =back
18438
18439 =over 4
18440
18441 =item B<Pod::InputSource>
18442
18443 =back
18444
18445 =over 4
18446
18447 =item B<new()>
18448
18449 =back
18450
18451 =over 4
18452
18453 =item B<name()>
18454
18455 =back
18456
18457 =over 4
18458
18459 =item B<handle()>
18460
18461 =back
18462
18463 =over 4
18464
18465 =item B<was_cutting()>
18466
18467 =back
18468
18469 =over 4
18470
18471 =item B<Pod::Paragraph>
18472
18473 =back
18474
18475 =over 4
18476
18477 =item Pod::Paragraph-E<gt>B<new()>
18478
18479 =back
18480
18481 =over 4
18482
18483 =item $pod_para-E<gt>B<cmd_name()>
18484
18485 =back
18486
18487 =over 4
18488
18489 =item $pod_para-E<gt>B<text()>
18490
18491 =back
18492
18493 =over 4
18494
18495 =item $pod_para-E<gt>B<raw_text()>
18496
18497 =back
18498
18499 =over 4
18500
18501 =item $pod_para-E<gt>B<cmd_prefix()>
18502
18503 =back
18504
18505 =over 4
18506
18507 =item $pod_para-E<gt>B<cmd_separator()>
18508
18509 =back
18510
18511 =over 4
18512
18513 =item $pod_para-E<gt>B<parse_tree()>
18514
18515 =back
18516
18517 =over 4
18518
18519 =item $pod_para-E<gt>B<file_line()>
18520
18521 =back
18522
18523 =over 4
18524
18525 =item B<Pod::InteriorSequence>
18526
18527 =back
18528
18529 =over 4
18530
18531 =item Pod::InteriorSequence-E<gt>B<new()>
18532
18533 =back
18534
18535 =over 4
18536
18537 =item $pod_seq-E<gt>B<cmd_name()>
18538
18539 =back
18540
18541 =over 4
18542
18543 =item $pod_seq-E<gt>B<prepend()>
18544
18545 =back
18546
18547 =over 4
18548
18549 =item $pod_seq-E<gt>B<append()>
18550
18551 =back
18552
18553 =over 4
18554
18555 =item $pod_seq-E<gt>B<nested()>
18556
18557 =back
18558
18559 =over 4
18560
18561 =item $pod_seq-E<gt>B<raw_text()>
18562
18563 =back
18564
18565 =over 4
18566
18567 =item $pod_seq-E<gt>B<left_delimiter()>
18568
18569 =back
18570
18571 =over 4
18572
18573 =item $pod_seq-E<gt>B<right_delimiter()>
18574
18575 =back
18576
18577 =over 4
18578
18579 =item $pod_seq-E<gt>B<parse_tree()>
18580
18581 =back
18582
18583 =over 4
18584
18585 =item $pod_seq-E<gt>B<file_line()>
18586
18587 =back
18588
18589 =over 4
18590
18591 =item Pod::InteriorSequence::B<DESTROY()>
18592
18593 =back
18594
18595 =over 4
18596
18597 =item B<Pod::ParseTree>
18598
18599 =back
18600
18601 =over 4
18602
18603 =item Pod::ParseTree-E<gt>B<new()>
18604
18605 =back
18606
18607 =over 4
18608
18609 =item $ptree-E<gt>B<top()>
18610
18611 =back
18612
18613 =over 4
18614
18615 =item $ptree-E<gt>B<children()>
18616
18617 =back
18618
18619 =over 4
18620
18621 =item $ptree-E<gt>B<prepend()>
18622
18623 =back
18624
18625 =over 4
18626
18627 =item $ptree-E<gt>B<append()>
18628
18629 =back
18630
18631 =over 4
18632
18633 =item $ptree-E<gt>B<raw_text()>
18634
18635 =back
18636
18637 =over 4
18638
18639 =item Pod::ParseTree::B<DESTROY()>
18640
18641 =back
18642
18643 =over 4
18644
18645 =item SEE ALSO
18646
18647 =item AUTHOR
18648
18649 =back
18650
18651 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
18652
18653 =over 4
18654
18655 =item SYNOPSIS
18656
18657 =item DESCRIPTION
18658
18659 =back
18660
18661 =over 4
18662
18663 =item OBJECT METHODS
18664
18665 C<initialize>
18666
18667 =back
18668
18669 =over 4
18670
18671 =item Data Accessors
18672
18673 B<AddPreamble>
18674
18675 =back
18676
18677 B<AddPostamble>
18678
18679 B<Head1Level>
18680
18681 B<Label>
18682
18683 B<LevelNoNum>
18684
18685 B<MakeIndex>
18686
18687 B<ReplaceNAMEwithSection>
18688
18689 B<StartWithNewPage>
18690
18691 B<TableOfContents>
18692
18693 B<UniqueLabels>
18694
18695 B<UserPreamble>
18696
18697 B<UserPostamble>
18698
18699 B<Lists>
18700
18701 =over 4
18702
18703 =item Subclassed methods
18704
18705 =back
18706
18707 B<begin_pod>
18708
18709 B<end_pod>
18710
18711 B<command>
18712
18713 B<verbatim>
18714
18715 B<textblock>
18716
18717 B<interior_sequence>
18718
18719 =over 4
18720
18721 =item List Methods
18722
18723 B<begin_list>
18724
18725 =back
18726
18727 B<end_list>
18728
18729 B<add_item>
18730
18731 =over 4
18732
18733 =item Methods for headings
18734
18735 B<head>
18736
18737 =back
18738
18739 =over 4
18740
18741 =item Internal methods
18742
18743 B<_output>
18744
18745 =back
18746
18747 B<_replace_special_chars>
18748
18749 B<_replace_special_chars_late>
18750
18751 B<_create_label>
18752
18753 B<_create_index>
18754
18755 B<_clean_latex_commands>
18756
18757 B<_split_delimited>
18758
18759 =over 4
18760
18761 =item NOTES
18762
18763 =item SEE ALSO
18764
18765 =item AUTHORS
18766
18767 =item COPYRIGHT
18768
18769 =item REVISION
18770
18771 =back
18772
18773 =head2 Pod::Man - Convert POD data to formatted *roff input
18774
18775 =over 4
18776
18777 =item SYNOPSIS
18778
18779 =item DESCRIPTION
18780
18781 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
18782 release, section
18783
18784 =item DIAGNOSTICS
18785
18786 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
18787 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
18788 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
18789 =back
18790
18791 =item BUGS
18792
18793 =item CAVEATS
18794
18795 =item SEE ALSO
18796
18797 =item AUTHOR
18798
18799 =item COPYRIGHT AND LICENSE
18800
18801 =back
18802
18803 =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
18804
18805 =over 4
18806
18807 =item SYNOPSIS
18808
18809 =item DESCRIPTION
18810
18811 =item SEE ALSO
18812
18813 =item AUTHOR
18814
18815 =item COPYRIGHT AND LICENSE
18816
18817 =back
18818
18819 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
18820
18821 =over 4
18822
18823 =item SYNOPSIS
18824
18825 =item DESCRIPTION
18826
18827 =back
18828
18829 =over 4
18830
18831 =item Pod::List
18832
18833 Pod::List-E<gt>new()
18834
18835 =back
18836
18837 $list-E<gt>file()
18838
18839 $list-E<gt>start()
18840
18841 $list-E<gt>indent()
18842
18843 $list-E<gt>type()
18844
18845 $list-E<gt>rx()
18846
18847 $list-E<gt>item()
18848
18849 $list-E<gt>parent()
18850
18851 $list-E<gt>tag()
18852
18853 =over 4
18854
18855 =item Pod::Hyperlink
18856
18857 Pod::Hyperlink-E<gt>new()
18858
18859 =back
18860
18861 $link-E<gt>parse($string)
18862
18863 $link-E<gt>markup($string)
18864
18865 $link-E<gt>text()
18866
18867 $link-E<gt>warning()
18868
18869 $link-E<gt>file(), $link-E<gt>line()
18870
18871 $link-E<gt>page()
18872
18873 $link-E<gt>node()
18874
18875 $link-E<gt>alttext()
18876
18877 $link-E<gt>type()
18878
18879 $link-E<gt>link()
18880
18881 =over 4
18882
18883 =item Pod::Cache
18884
18885 Pod::Cache-E<gt>new()
18886
18887 =back
18888
18889 $cache-E<gt>item()
18890
18891 $cache-E<gt>find_page($name)
18892
18893 =over 4
18894
18895 =item Pod::Cache::Item
18896
18897 Pod::Cache::Item-E<gt>new()
18898
18899 =back
18900
18901 $cacheitem-E<gt>page()
18902
18903 $cacheitem-E<gt>description()
18904
18905 $cacheitem-E<gt>path()
18906
18907 $cacheitem-E<gt>file()
18908
18909 $cacheitem-E<gt>nodes()
18910
18911 $cacheitem-E<gt>find_node($name)
18912
18913 $cacheitem-E<gt>idx()
18914
18915 =over 4
18916
18917 =item AUTHOR
18918
18919 =item SEE ALSO
18920
18921 =back
18922
18923 =head2 Pod::Parser - base class for creating POD filters and translators
18924
18925 =over 4
18926
18927 =item SYNOPSIS
18928
18929 =item REQUIRES
18930
18931 =item EXPORTS
18932
18933 =item DESCRIPTION
18934
18935 =item QUICK OVERVIEW
18936
18937 =item PARSING OPTIONS
18938
18939 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
18940 B<-warnings> (default: unset)
18941
18942 =back
18943
18944 =over 4
18945
18946 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
18947
18948 =back
18949
18950 =over 4
18951
18952 =item B<command()>
18953
18954 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
18955
18956 =back
18957
18958 =over 4
18959
18960 =item B<verbatim()>
18961
18962 C<$text>, C<$line_num>, C<$pod_para>
18963
18964 =back
18965
18966 =over 4
18967
18968 =item B<textblock()>
18969
18970 C<$text>, C<$line_num>, C<$pod_para>
18971
18972 =back
18973
18974 =over 4
18975
18976 =item B<interior_sequence()>
18977
18978 =back
18979
18980 =over 4
18981
18982 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
18983
18984 =back
18985
18986 =over 4
18987
18988 =item B<new()>
18989
18990 =back
18991
18992 =over 4
18993
18994 =item B<initialize()>
18995
18996 =back
18997
18998 =over 4
18999
19000 =item B<begin_pod()>
19001
19002 =back
19003
19004 =over 4
19005
19006 =item B<begin_input()>
19007
19008 =back
19009
19010 =over 4
19011
19012 =item B<end_input()>
19013
19014 =back
19015
19016 =over 4
19017
19018 =item B<end_pod()>
19019
19020 =back
19021
19022 =over 4
19023
19024 =item B<preprocess_line()>
19025
19026 =back
19027
19028 =over 4
19029
19030 =item B<preprocess_paragraph()>
19031
19032 =back
19033
19034 =over 4
19035
19036 =item METHODS FOR PARSING AND PROCESSING
19037
19038 =back
19039
19040 =over 4
19041
19042 =item B<parse_text()>
19043
19044 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
19045 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
19046 I<code-ref>|I<method-name>
19047
19048 =back
19049
19050 =over 4
19051
19052 =item B<interpolate()>
19053
19054 =back
19055
19056 =over 4
19057
19058 =item B<parse_paragraph()>
19059
19060 =back
19061
19062 =over 4
19063
19064 =item B<parse_from_filehandle()>
19065
19066 =back
19067
19068 =over 4
19069
19070 =item B<parse_from_file()>
19071
19072 =back
19073
19074 =over 4
19075
19076 =item ACCESSOR METHODS
19077
19078 =back
19079
19080 =over 4
19081
19082 =item B<errorsub()>
19083
19084 =back
19085
19086 =over 4
19087
19088 =item B<cutting()>
19089
19090 =back
19091
19092 =over 4
19093
19094 =item B<parseopts()>
19095
19096 =back
19097
19098 =over 4
19099
19100 =item B<output_file()>
19101
19102 =back
19103
19104 =over 4
19105
19106 =item B<output_handle()>
19107
19108 =back
19109
19110 =over 4
19111
19112 =item B<input_file()>
19113
19114 =back
19115
19116 =over 4
19117
19118 =item B<input_handle()>
19119
19120 =back
19121
19122 =over 4
19123
19124 =item B<input_streams()>
19125
19126 =back
19127
19128 =over 4
19129
19130 =item B<top_stream()>
19131
19132 =back
19133
19134 =over 4
19135
19136 =item PRIVATE METHODS AND DATA
19137
19138 =back
19139
19140 =over 4
19141
19142 =item B<_push_input_stream()>
19143
19144 =back
19145
19146 =over 4
19147
19148 =item B<_pop_input_stream()>
19149
19150 =back
19151
19152 =over 4
19153
19154 =item TREE-BASED PARSING
19155
19156 =item SEE ALSO
19157
19158 =item AUTHOR
19159
19160 =back
19161
19162 =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors
19163
19164 =over 4
19165
19166 =item SYNOPSIS
19167
19168 =item DESCRIPTION
19169
19170 =item SEE ALSO
19171
19172 =item COPYRIGHT AND DISCLAIMERS
19173
19174 =item AUTHOR
19175
19176 =back
19177
19178 =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages
19179
19180 =over 4
19181
19182 =item SYNOPSIS
19183
19184 =item DESCRIPTION
19185
19186 =item CAVEAT
19187
19188 =item SEE ALSO
19189
19190 =item COPYRIGHT AND DISCLAIMERS
19191
19192 =item AUTHOR
19193
19194 =back
19195
19196 =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff
19197
19198 =over 4
19199
19200 =item SYNOPSIS
19201
19202 =item DESCRIPTION
19203
19204 =item CAVEAT
19205
19206 =item SEE ALSO
19207
19208 =item COPYRIGHT AND DISCLAIMERS
19209
19210 =item AUTHOR
19211
19212 =back
19213
19214 =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod!
19215
19216 =over 4
19217
19218 =item SYNOPSIS
19219
19220 =item DESCRIPTION
19221
19222 =item SEE ALSO
19223
19224 =item COPYRIGHT AND DISCLAIMERS
19225
19226 =item AUTHOR
19227
19228 =back
19229
19230 =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF
19231
19232 =over 4
19233
19234 =item SYNOPSIS
19235
19236 =item DESCRIPTION
19237
19238 =item SEE ALSO
19239
19240 =item COPYRIGHT AND DISCLAIMERS
19241
19242 =item AUTHOR
19243
19244 =back
19245
19246 =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext
19247
19248 =over 4
19249
19250 =item SYNOPSIS
19251
19252 =item DESCRIPTION
19253
19254 =item CAVEAT
19255
19256 =item SEE ALSO
19257
19258 =item COPYRIGHT AND DISCLAIMERS
19259
19260 =item AUTHOR
19261
19262 =back
19263
19264 =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod
19265
19266 =over 4
19267
19268 =item SYNOPSIS
19269
19270 =item DESCRIPTION
19271
19272 =item SEE ALSO
19273
19274 =item AUTHOR
19275
19276 =back
19277
19278 =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML
19279
19280 =over 4
19281
19282 =item SYNOPSIS
19283
19284 =item DESCRIPTION
19285
19286 =item SEE ALSO
19287
19288 =item COPYRIGHT AND DISCLAIMERS
19289
19290 =item AUTHOR
19291
19292 =back
19293
19294 =head2 Pod::PlainText - Convert POD data to formatted ASCII text
19295
19296 =over 4
19297
19298 =item SYNOPSIS
19299
19300 =item DESCRIPTION
19301
19302 alt, indent, loose, sentence, width
19303
19304 =item DIAGNOSTICS
19305
19306 Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
19307 Unknown sequence: %s, Unmatched =back
19308
19309 =item RESTRICTIONS
19310
19311 =item NOTES
19312
19313 =item SEE ALSO
19314
19315 =item AUTHOR
19316
19317 =back
19318
19319 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
19320
19321 =over 4
19322
19323 =item SYNOPSIS
19324
19325 =item DESCRIPTION
19326
19327 =over 4
19328
19329 =item EXPORT
19330
19331 =back
19332
19333 =item AUTHOR
19334
19335 =item SEE ALSO
19336
19337 =back
19338
19339 =head2 Pod::Select, podselect() - extract selected sections of POD from
19340 input
19341
19342 =over 4
19343
19344 =item SYNOPSIS
19345
19346 =item REQUIRES
19347
19348 =item EXPORTS
19349
19350 =item DESCRIPTION
19351
19352 =item SECTION SPECIFICATIONS
19353
19354 =item RANGE SPECIFICATIONS
19355
19356 =back
19357
19358 =over 4
19359
19360 =item OBJECT METHODS
19361
19362 =back
19363
19364 =over 4
19365
19366 =item B<curr_headings()>
19367
19368 =back
19369
19370 =over 4
19371
19372 =item B<select()>
19373
19374 =back
19375
19376 =over 4
19377
19378 =item B<add_selection()>
19379
19380 =back
19381
19382 =over 4
19383
19384 =item B<clear_selections()>
19385
19386 =back
19387
19388 =over 4
19389
19390 =item B<match_section()>
19391
19392 =back
19393
19394 =over 4
19395
19396 =item B<is_selected()>
19397
19398 =back
19399
19400 =over 4
19401
19402 =item EXPORTED FUNCTIONS
19403
19404 =back
19405
19406 =over 4
19407
19408 =item B<podselect()>
19409
19410 B<-output>, B<-sections>, B<-ranges>
19411
19412 =back
19413
19414 =over 4
19415
19416 =item PRIVATE METHODS AND DATA
19417
19418 =back
19419
19420 =over 4
19421
19422 =item B<_compile_section_spec()>
19423
19424 =back
19425
19426 =over 4
19427
19428 =item $self->{_SECTION_HEADINGS}
19429
19430 =back
19431
19432 =over 4
19433
19434 =item $self->{_SELECTED_SECTIONS}
19435
19436 =back
19437
19438 =over 4
19439
19440 =item SEE ALSO
19441
19442 =item AUTHOR
19443
19444 =back
19445
19446 =head2 Pod::Text - Convert POD data to formatted ASCII text
19447
19448 =over 4
19449
19450 =item SYNOPSIS
19451
19452 =item DESCRIPTION
19453
19454 alt, code, indent, loose, margin, quotes, sentence, width
19455
19456 =item DIAGNOSTICS
19457
19458 Bizarre space in item, Item called without tag, Can't open %s for reading:
19459 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
19460 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
19461 Unmatched =back
19462
19463 =item RESTRICTIONS
19464
19465 =item NOTES
19466
19467 =item SEE ALSO
19468
19469 =item AUTHOR
19470
19471 =item COPYRIGHT AND LICENSE
19472
19473 =back
19474
19475 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
19476
19477 =over 4
19478
19479 =item SYNOPSIS
19480
19481 =item DESCRIPTION
19482
19483 =item BUGS
19484
19485 =item SEE ALSO
19486
19487 =item AUTHOR
19488
19489 =item COPYRIGHT AND LICENSE
19490
19491 =back
19492
19493 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
19494 text
19495
19496 =over 4
19497
19498 =item SYNOPSIS
19499
19500 =item DESCRIPTION
19501
19502 =item BUGS
19503
19504 =item SEE ALSO
19505
19506 =item AUTHOR
19507
19508 =item COPYRIGHT AND LICENSE
19509
19510 =back
19511
19512 =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
19513 escapes
19514
19515 =over 4
19516
19517 =item SYNOPSIS
19518
19519 =item DESCRIPTION
19520
19521 =item NOTES
19522
19523 =item SEE ALSO
19524
19525 =item AUTHOR
19526
19527 =item COPYRIGHT AND LICENSE
19528
19529 =back
19530
19531 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
19532 documentation
19533
19534 =over 4
19535
19536 =item SYNOPSIS
19537
19538 =item ARGUMENTS
19539
19540 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
19541 C<-pathlist>
19542
19543 =item DESCRIPTION
19544
19545 =item EXAMPLES
19546
19547 =over 4
19548
19549 =item Recommended Use
19550
19551 =back
19552
19553 =item CAVEATS
19554
19555 =item AUTHOR
19556
19557 =item ACKNOWLEDGEMENTS
19558
19559 =back
19560
19561 =head2 SDBM_File - Tied access to sdbm files
19562
19563 =over 4
19564
19565 =item SYNOPSIS
19566
19567 =item DESCRIPTION
19568
19569 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
19570
19571 =item DIAGNOSTICS
19572
19573 =over 4
19574
19575 =item C<sdbm store returned -1, errno 22, key "..." at ...>
19576
19577 =back
19578
19579 =item BUGS AND WARNINGS
19580
19581 =back
19582
19583 =head2 Safe - Compile and execute code in restricted compartments
19584
19585 =over 4
19586
19587 =item SYNOPSIS
19588
19589 =item DESCRIPTION
19590
19591 a new namespace, an operator mask
19592
19593 =item WARNING
19594
19595 =over 4
19596
19597 =item RECENT CHANGES
19598
19599 =item Methods in class Safe
19600
19601 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
19602 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
19603 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
19604 root (NAMESPACE), mask (MASK)
19605
19606 =item Some Safety Issues
19607
19608 Memory, CPU, Snooping, Signals, State Changes
19609
19610 =item AUTHOR
19611
19612 =back
19613
19614 =back
19615
19616 =head2 Scalar::Util - A selection of general-utility scalar subroutines
19617
19618 =over 4
19619
19620 =item SYNOPSIS
19621
19622 =item DESCRIPTION
19623
19624 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
19625 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
19626 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
19627
19628 =item KNOWN BUGS
19629
19630 =item COPYRIGHT
19631
19632 =item BLATANT PLUG
19633
19634 =back
19635
19636 =head2 Search::Dict, look - search for key in dictionary file
19637
19638 =over 4
19639
19640 =item SYNOPSIS
19641
19642 =item DESCRIPTION
19643
19644 =back
19645
19646 =head2 SelectSaver - save and restore selected file handle
19647
19648 =over 4
19649
19650 =item SYNOPSIS
19651
19652 =item DESCRIPTION
19653
19654 =back
19655
19656 =head2 SelfLoader - load functions only on demand
19657
19658 =over 4
19659
19660 =item SYNOPSIS
19661
19662 =item DESCRIPTION
19663
19664 =over 4
19665
19666 =item The __DATA__ token
19667
19668 =item SelfLoader autoloading
19669
19670 =item Autoloading and package lexicals
19671
19672 =item SelfLoader and AutoLoader
19673
19674 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
19675
19676 =item Classes and inherited methods.
19677
19678 =back
19679
19680 =item Multiple packages and fully qualified subroutine names
19681
19682 =back
19683
19684 =head2 Shell - run shell commands transparently within perl
19685
19686 =over 4
19687
19688 =item SYNOPSIS
19689
19690 =item DESCRIPTION
19691
19692 =over 4
19693
19694 =item Caveats
19695
19696 =item Escaping Magic Characters
19697
19698 =item Configuration
19699
19700 =back
19701
19702 =item BUGS
19703
19704 =item AUTHOR
19705
19706 =back
19707
19708 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
19709 socket.h defines and structure manipulators 
19710
19711 =over 4
19712
19713 =item SYNOPSIS
19714
19715 =item DESCRIPTION
19716
19717 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
19718 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
19719 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
19720 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
19721 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
19722
19723 =back
19724
19725 =head2 Storable - persistence for Perl data structures
19726
19727 =over 4
19728
19729 =item SYNOPSIS
19730
19731 =item DESCRIPTION
19732
19733 =item MEMORY STORE
19734
19735 =item ADVISORY LOCKING
19736
19737 =item SPEED
19738
19739 =item CANONICAL REPRESENTATION
19740
19741 =item CODE REFERENCES
19742
19743 =item FORWARD COMPATIBILITY
19744
19745 utf8 data, restricted hashes, files from future versions of Storable
19746
19747 =item ERROR REPORTING
19748
19749 =item WIZARDS ONLY
19750
19751 =over 4
19752
19753 =item Hooks
19754
19755 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
19756 I<serialized>, ..
19757
19758 =item Predicates
19759
19760 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
19761 C<Storable::is_retrieving>
19762
19763 =item Recursion
19764
19765 =item Deep Cloning
19766
19767 =back
19768
19769 =item Storable magic
19770
19771 =item EXAMPLES
19772
19773 =item WARNING
19774
19775 =item BUGS
19776
19777 =over 4
19778
19779 =item 64 bit data in perl 5.6.0 and 5.6.1
19780
19781 =back
19782
19783 =item CREDITS
19784
19785 =item AUTHOR
19786
19787 =item SEE ALSO
19788
19789 =back
19790
19791 =head2 Switch - A switch statement for Perl
19792
19793 =over 4
19794
19795 =item VERSION
19796
19797 =item SYNOPSIS
19798
19799 =item BACKGROUND
19800
19801 =item DESCRIPTION
19802
19803 =over 4
19804
19805 =item Allowing fall-through
19806
19807 =item Automating fall-through
19808
19809 =item Alternative syntax
19810
19811 =item Higher-order Operations
19812
19813 =back
19814
19815 =item DEPENDENCIES
19816
19817 =item AUTHOR
19818
19819 =item BUGS
19820
19821 =item LIMITATIONS
19822
19823 =item COPYRIGHT
19824
19825 =back
19826
19827 =head2 Symbol - manipulate Perl symbols and their names
19828
19829 =over 4
19830
19831 =item SYNOPSIS
19832
19833 =item DESCRIPTION
19834
19835 =item BUGS
19836
19837 =back
19838
19839 =head2 Sys::Hostname - Try every conceivable way to get hostname
19840
19841 =over 4
19842
19843 =item SYNOPSIS
19844
19845 =item DESCRIPTION
19846
19847 =item AUTHOR
19848
19849 =back
19850
19851 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
19852 interface to the UNIX syslog(3) calls
19853
19854 =over 4
19855
19856 =item SYNOPSIS
19857
19858 =item DESCRIPTION
19859
19860 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19861 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19862 in 5.004_02), closelog
19863
19864 =item EXAMPLES
19865
19866 =item SEE ALSO
19867
19868 =item AUTHOR
19869
19870 =back
19871
19872 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
19873 Perl interface to the UNIX syslog(3) calls
19874
19875 =over 4
19876
19877 =item SYNOPSIS
19878
19879 =item DESCRIPTION
19880
19881 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19882 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19883 in 5.004_02), closelog
19884
19885 =item EXAMPLES
19886
19887 =item SEE ALSO
19888
19889 =item AUTHOR
19890
19891 =back
19892
19893 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
19894
19895 =over 4
19896
19897 =item SYNOPSIS
19898
19899 =item DESCRIPTION
19900
19901 =item DIAGNOSTICS
19902
19903 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
19904 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
19905 comma allowed after filehandle, No name for escape sequence %s
19906
19907 =item ENVIRONMENT
19908
19909 ANSI_COLORS_DISABLED
19910
19911 =item RESTRICTIONS
19912
19913 =item NOTES
19914
19915 =item SEE ALSO
19916
19917 =item AUTHORS
19918
19919 =item COPYRIGHT AND LICENSE
19920
19921 =back
19922
19923 =head2 Term::Cap - Perl termcap interface
19924
19925 =over 4
19926
19927 =item SYNOPSIS
19928
19929 =item DESCRIPTION
19930
19931 =over 4
19932
19933 =item METHODS
19934
19935 =back
19936
19937 =back
19938
19939 B<Tgetent>, OSPEED, TERM
19940
19941 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
19942
19943 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
19944
19945 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
19946
19947 B<Trequire>
19948
19949 =over 4
19950
19951 =item EXAMPLES
19952
19953 =item COPYRIGHT AND LICENSE
19954
19955 =item AUTHOR
19956
19957 =item SEE ALSO
19958
19959 =back
19960
19961 =head2 Term::Complete - Perl word completion module
19962
19963 =over 4
19964
19965 =item SYNOPSIS
19966
19967 =item DESCRIPTION
19968
19969 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
19970
19971 =item DIAGNOSTICS
19972
19973 =item BUGS
19974
19975 =item AUTHOR
19976
19977 =back
19978
19979 =head2 Term::ReadLine - Perl interface to various C<readline> packages.
19980 If no real package is found, substitutes stubs instead of basic functions.
19981
19982 =over 4
19983
19984 =item SYNOPSIS
19985
19986 =item DESCRIPTION
19987
19988 =item Minimal set of supported functions
19989
19990 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>,
19991 C<findConsole>, Attribs, C<Features>
19992
19993 =item Additional supported functions
19994
19995 C<tkRunning>, C<ornaments>, C<newTTY>
19996
19997 =item EXPORTS
19998
19999 =item ENVIRONMENT
20000
20001 =item CAVEATS
20002
20003 =back
20004
20005 =head2 Test - provides a simple framework for writing test scripts
20006
20007 =over 4
20008
20009 =item SYNOPSIS
20010
20011 =item DESCRIPTION
20012
20013 =item QUICK START GUIDE
20014
20015 =over 4
20016
20017 =item Functions
20018
20019 C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>,
20020 C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub>
20021
20022 =back
20023
20024 =back
20025
20026 B<_to_value>
20027
20028 C<ok(...)>
20029
20030 C<skip(I<skip_if_true>, I<args...>)>
20031
20032 =over 4
20033
20034 =item TEST TYPES
20035
20036 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
20037
20038 =item ONFAIL
20039
20040 =item BUGS and CAVEATS
20041
20042 =item ENVIRONMENT
20043
20044 =item NOTE
20045
20046 =item SEE ALSO
20047
20048 =item AUTHOR
20049
20050 =back
20051
20052 =head2 Test::Builder - Backend for building test libraries
20053
20054 =over 4
20055
20056 =item SYNOPSIS
20057
20058 =item DESCRIPTION
20059
20060 =over 4
20061
20062 =item Construction
20063
20064 B<new>
20065
20066 =back
20067
20068 =back
20069
20070 =over 4
20071
20072 =item Setting up tests
20073
20074 B<exported_to>
20075
20076 =back
20077
20078 B<plan>
20079
20080 B<expected_tests>
20081
20082 B<no_plan>
20083
20084 B<has_plan>
20085
20086 B<skip_all>
20087
20088 =over 4
20089
20090 =item Running tests
20091
20092 B<ok>
20093
20094 =back
20095
20096 B<is_eq>, B<is_num>
20097
20098 B<isnt_eq>, B<isnt_num>
20099
20100 B<like>, B<unlike>
20101
20102 B<maybe_regex>
20103
20104 B<cmp_ok>
20105
20106 B<BAILOUT>
20107
20108 B<skip>
20109
20110 B<todo_skip>
20111
20112 B<skip_rest>
20113
20114 =over 4
20115
20116 =item Test style
20117
20118 B<level>
20119
20120 =back
20121
20122 B<use_numbers>
20123
20124 B<no_header>, B<no_ending>
20125
20126 =over 4
20127
20128 =item Output
20129
20130 B<diag>
20131
20132 =back
20133
20134 B<_print>
20135
20136 B<output>, B<failure_output>, B<todo_output>
20137
20138 =over 4
20139
20140 =item Test Status and Info
20141
20142 B<current_test>
20143
20144 =back
20145
20146 B<summary>
20147
20148 B<details>
20149
20150 B<todo>
20151
20152 B<caller>
20153
20154 B<_sanity_check>
20155
20156 B<_whoa>
20157
20158 B<_my_exit>
20159
20160 =over 4
20161
20162 =item THREADS
20163
20164 =item EXAMPLES
20165
20166 =item SEE ALSO
20167
20168 =item AUTHORS
20169
20170 =item COPYRIGHT
20171
20172 =back
20173
20174 =head2 Test::Harness - Run Perl standard test scripts with statistics
20175
20176 =over 4
20177
20178 =item VERSION
20179
20180 =back
20181
20182 =over 4
20183
20184 =item SYNOPSIS
20185
20186 =item DESCRIPTION
20187
20188 =over 4
20189
20190 =item The test script output
20191
20192 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
20193 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
20194 else>
20195
20196 =item Taint mode
20197
20198 =item Configuration variables.
20199
20200 B<$Test::Harness::Verbose>, B<$Test::Harness::switches>
20201
20202 =item Failure
20203
20204 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
20205 Failed>
20206
20207 =item Functions
20208
20209 B<runtests>
20210
20211 =back
20212
20213 =back
20214
20215 B<_all_ok>
20216
20217 B<_globdir>
20218
20219 B<_run_all_tests>
20220
20221 B<_mk_leader>
20222
20223 B<_leader_width>
20224
20225 =over 4
20226
20227 =item EXPORT
20228
20229 =item DIAGNOSTICS
20230
20231 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
20232 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
20233 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
20234 %s>, C<FAILED--Further testing stopped: %s>
20235
20236 =item ENVIRONMENT
20237
20238 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
20239 C<HARNESS_DEBUG>, C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>,
20240 C<HARNESS_NOTTY>, C<HARNESS_OK_SLOW>, C<HARNESS_PERL>,
20241 C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
20242
20243 =item EXAMPLE
20244
20245 =item SEE ALSO
20246
20247 =item AUTHORS
20248
20249 =item LICENSE
20250
20251 =item TODO
20252
20253 =item BUGS
20254
20255 =item AUTHORS
20256
20257 =item COPYRIGHT
20258
20259 =back
20260
20261 =head2 Test::Harness::Assert - simple assert
20262
20263 =over 4
20264
20265 =item SYNOPSIS
20266
20267 =item DESCRIPTION
20268
20269 =item FUNCTIONS
20270
20271 =over 4
20272
20273 =item C<assert()>
20274
20275 =back
20276
20277 =back
20278
20279 =over 4
20280
20281 =item AUTHOR
20282
20283 =item SEE ALSO
20284
20285 =back
20286
20287 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
20288
20289 =over 4
20290
20291 =item SYNOPSIS
20292
20293 =item DESCRIPTION
20294
20295 =over 4
20296
20297 =item new()
20298
20299 =item next()
20300
20301 =back
20302
20303 =back
20304
20305 =head2 Test::Harness::Straps - detailed analysis of test results
20306
20307 =over 4
20308
20309 =item SYNOPSIS
20310
20311 =item DESCRIPTION
20312
20313 =item Construction
20314
20315 =over 4
20316
20317 =item C<new>
20318
20319 =back
20320
20321 =back
20322
20323 =over 4
20324
20325 =item C<_init>
20326
20327 =back
20328
20329 =over 4
20330
20331 =item Analysis
20332
20333 =over 4
20334
20335 =item C<analyze>
20336
20337 =back
20338
20339 =back
20340
20341 =over 4
20342
20343 =item C<analyze_fh>
20344
20345 =back
20346
20347 =over 4
20348
20349 =item C<analyze_file>
20350
20351 =back
20352
20353 =over 4
20354
20355 =item C<_command_line( $file )>
20356
20357 =back
20358
20359 =over 4
20360
20361 =item C<_command>
20362
20363 =back
20364
20365 =over 4
20366
20367 =item C<_switches>
20368
20369 =back
20370
20371 =over 4
20372
20373 =item C<_cleaned_switches>
20374
20375 =back
20376
20377 =over 4
20378
20379 =item C<_INC2PERL5LIB>
20380
20381 =back
20382
20383 =over 4
20384
20385 =item C<_filtered_INC>
20386
20387 =back
20388
20389 =over 4
20390
20391 =item C<_restore_PERL5LIB>
20392
20393 =back
20394
20395 =over 4
20396
20397 =item Parsing
20398
20399 =over 4
20400
20401 =item C<_is_comment>
20402
20403 =back
20404
20405 =back
20406
20407 =over 4
20408
20409 =item C<_is_header>
20410
20411 =back
20412
20413 =over 4
20414
20415 =item C<_is_test>
20416
20417 =back
20418
20419 =over 4
20420
20421 =item C<_is_bail_out>
20422
20423 =back
20424
20425 =over 4
20426
20427 =item C<_reset_file_state>
20428
20429 =back
20430
20431 =over 4
20432
20433 =item Results
20434
20435 =over 4
20436
20437 =item C<_detailize>
20438
20439 =back
20440
20441 =back
20442
20443 =over 4
20444
20445 =item EXAMPLES
20446
20447 =item AUTHOR
20448
20449 =item SEE ALSO
20450
20451 =back
20452
20453 =head2 Test::More - yet another framework for writing test scripts
20454
20455 =over 4
20456
20457 =item SYNOPSIS
20458
20459 =item DESCRIPTION
20460
20461 =over 4
20462
20463 =item I love it when a plan comes together
20464
20465 =back
20466
20467 =back
20468
20469 =over 4
20470
20471 =item Test names
20472
20473 =item I'm ok, you're not ok.
20474
20475 B<ok>
20476
20477 =back
20478
20479 B<is>, B<isnt>
20480
20481 B<like>
20482
20483 B<unlike>
20484
20485 B<cmp_ok>
20486
20487 B<can_ok>
20488
20489 B<isa_ok>
20490
20491 B<pass>, B<fail>
20492
20493 =over 4
20494
20495 =item Diagnostics
20496
20497 B<diag>
20498
20499 =back
20500
20501 =over 4
20502
20503 =item Module tests
20504
20505 B<use_ok>
20506
20507 =back
20508
20509 B<require_ok>
20510
20511 =over 4
20512
20513 =item Conditional tests
20514
20515 B<SKIP: BLOCK>
20516
20517 =back
20518
20519 B<TODO: BLOCK>, B<todo_skip>
20520
20521 When do I use SKIP vs. TODO?
20522
20523 =over 4
20524
20525 =item Comparison functions
20526
20527 B<is_deeply>
20528
20529 =back
20530
20531 B<eq_array>
20532
20533 B<eq_hash>
20534
20535 B<eq_set>
20536
20537 =over 4
20538
20539 =item Extending and Embedding Test::More
20540
20541 B<builder>
20542
20543 =back
20544
20545 =over 4
20546
20547 =item NOTES
20548
20549 =item BUGS and CAVEATS
20550
20551 Making your own ok(), The eq_* family has some caveats, Test::Harness
20552 upgrades
20553
20554 =item HISTORY
20555
20556 =item SEE ALSO
20557
20558 =item AUTHORS
20559
20560 =item COPYRIGHT
20561
20562 =back
20563
20564 =head2 Test::Simple - Basic utilities for writing tests.
20565
20566 =over 4
20567
20568 =item SYNOPSIS
20569
20570 =item DESCRIPTION
20571
20572 B<ok>
20573
20574 =back
20575
20576 =over 4
20577
20578 =item EXAMPLE
20579
20580 =item CAVEATS
20581
20582 =item NOTES
20583
20584 =item HISTORY
20585
20586 =item SEE ALSO
20587
20588 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
20589 L<Test::Harness>
20590
20591 =item AUTHORS
20592
20593 =item COPYRIGHT
20594
20595 =back
20596
20597 =head2 Test::Tutorial - A tutorial about writing really basic tests
20598
20599 =over 4
20600
20601 =item DESCRIPTION
20602
20603 =over 4
20604
20605 =item Nuts and bolts of testing.
20606
20607 =item Where to start?
20608
20609 =item Names
20610
20611 =item Test the manual
20612
20613 =item Sometimes the tests are wrong
20614
20615 =item Testing lots of values
20616
20617 =item Informative names
20618
20619 =item Skipping tests
20620
20621 =item Todo tests
20622
20623 =item Testing with taint mode.
20624
20625 =back
20626
20627 =item FOOTNOTES
20628
20629 =item AUTHORS
20630
20631 =item COPYRIGHT
20632
20633 =back
20634
20635 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
20636
20637 =over 4
20638
20639 =item SYNOPSIS
20640
20641 =item DESCRIPTION
20642
20643 =item EXAMPLE
20644
20645 =back
20646
20647 =head2 Text::Balanced - Extract delimited text sequences from strings.
20648
20649 =over 4
20650
20651 =item SYNOPSIS
20652
20653 =item DESCRIPTION
20654
20655 =over 4
20656
20657 =item General behaviour in list contexts
20658
20659 [0], [1], [2]
20660
20661 =item General behaviour in scalar and void contexts
20662
20663 =item A note about prefixes
20664
20665 =item C<extract_delimited>
20666
20667 =item C<extract_bracketed>
20668
20669 =item C<extract_variable>
20670
20671 [0], [1], [2]
20672
20673 =item C<extract_tagged>
20674
20675 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
20676 [0], [1], [2], [3], [4], [5]
20677
20678 =item C<gen_extract_tagged>
20679
20680 =item C<extract_quotelike>
20681
20682 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
20683
20684 =item C<extract_quotelike> and "here documents"
20685
20686 [0], [1], [2], [3], [4], [5], [6], [7..10]
20687
20688 =item C<extract_codeblock>
20689
20690 =item C<extract_multiple>
20691
20692 =item C<gen_delimited_pat>
20693
20694 =back
20695
20696 =item DIAGNOSTICS
20697
20698  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>, 
20699 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
20700 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">, 
20701 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
20702 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
20703 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
20704 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
20705 after dereferencer>, C<Did not find expected opening bracket at %s>,
20706 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
20707 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
20708 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
20709 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
20710 tag>
20711
20712 =item AUTHOR
20713
20714 =item BUGS AND IRRITATIONS
20715
20716 =item COPYRIGHT
20717
20718 =back
20719
20720 =head2 Text::ParseWords - parse text into an array of tokens or array of
20721 arrays
20722
20723 =over 4
20724
20725 =item SYNOPSIS
20726
20727 =item DESCRIPTION
20728
20729 =item EXAMPLES
20730
20731 =item AUTHORS
20732
20733 =back
20734
20735 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
20736 by Knuth
20737
20738 =over 4
20739
20740 =item SYNOPSIS
20741
20742 =item DESCRIPTION
20743
20744 =item EXAMPLES
20745
20746 =item LIMITATIONS
20747
20748 =item AUTHOR
20749
20750 =back
20751
20752 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
20753 unexpand(1)
20754
20755 =over 4
20756
20757 =item SYNOPSIS
20758
20759 =item DESCRIPTION
20760
20761 =item BUGS
20762
20763 =item AUTHOR
20764
20765 =back
20766
20767 =head2 Text::Wrap - line wrapping to form simple paragraphs
20768
20769 =over 4
20770
20771 =item SYNOPSIS 
20772
20773 =item DESCRIPTION
20774
20775 =item OVERRIDES
20776
20777 =item EXAMPLE
20778
20779 =item AUTHOR
20780
20781 =back
20782
20783 =head2 Thread - manipulate threads in Perl (for old code only)
20784
20785 =over 4
20786
20787 =item CAVEAT
20788
20789 =item SYNOPSIS
20790
20791 =item DESCRIPTION
20792
20793 =item FUNCTIONS
20794
20795 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
20796 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
20797 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
20798
20799 =item METHODS
20800
20801 join, eval, detach, equal, tid, flags, done
20802
20803 =item LIMITATIONS
20804
20805 =item SEE ALSO
20806
20807 =back
20808
20809 =head2 Thread::Queue - thread-safe queues
20810
20811 =over 4
20812
20813 =item SYNOPSIS
20814
20815 =item DESCRIPTION
20816
20817 =item FUNCTIONS AND METHODS
20818
20819 new, enqueue LIST, dequeue, dequeue_nb, pending
20820
20821 =item SEE ALSO
20822
20823 =back
20824
20825 =head2 Thread::Semaphore - thread-safe semaphores
20826
20827 =over 4
20828
20829 =item SYNOPSIS
20830
20831 =item DESCRIPTION
20832
20833 =item FUNCTIONS AND METHODS
20834
20835 new, new NUMBER, down, down NUMBER, up, up NUMBER
20836
20837 =back
20838
20839 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
20840 (for old code)
20841
20842 =over 4
20843
20844 =item CAVEAT
20845
20846 =item SYNOPSIS
20847
20848 =item DESCRIPTION
20849
20850 =item BUGS
20851
20852 =back
20853
20854 =head2 Thread::Specific - thread-specific keys
20855
20856 =over 4
20857
20858 =item SYNOPSIS
20859
20860 =item DESCRIPTION
20861
20862 =back
20863
20864 =head2 Tie::Array - base class for tied arrays
20865
20866 =over 4
20867
20868 =item SYNOPSIS
20869
20870 =item DESCRIPTION
20871
20872 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
20873 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
20874 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
20875 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
20876
20877 =item CAVEATS
20878
20879 =item AUTHOR
20880
20881 =back
20882
20883 =head2 Tie::File - Access the lines of a disk file via a Perl array
20884
20885 =over 4
20886
20887 =item SYNOPSIS
20888
20889 =item DESCRIPTION
20890
20891 =over 4
20892
20893 =item C<recsep>
20894
20895 =item C<autochomp>
20896
20897 =item C<mode>
20898
20899 =item C<memory>
20900
20901 =item C<dw_size>
20902
20903 =item Option Format
20904
20905 =back
20906
20907 =item Public Methods
20908
20909 =over 4
20910
20911 =item C<flock>
20912
20913 =item C<autochomp>
20914
20915 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
20916
20917 =item C<offset>
20918
20919 =back
20920
20921 =item Tying to an already-opened filehandle
20922
20923 =item Deferred Writing
20924
20925 =over 4
20926
20927 =item Autodeferring
20928
20929 =back
20930
20931 =item CONCURRENT ACCESS TO FILES
20932
20933 =item CAVEATS
20934
20935 =item SUBCLASSING
20936
20937 =item WHAT ABOUT C<DB_File>?
20938
20939 =item AUTHOR
20940
20941 =item LICENSE
20942
20943 =item WARRANTY
20944
20945 =item THANKS
20946
20947 =item TODO
20948
20949 =back
20950
20951 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
20952 handles
20953
20954 =over 4
20955
20956 =item SYNOPSIS
20957
20958 =item DESCRIPTION
20959
20960 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
20961 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
20962 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
20963 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
20964
20965 =item MORE INFORMATION
20966
20967 =item COMPATIBILITY
20968
20969 =back
20970
20971 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
20972 tied hashes
20973
20974 =over 4
20975
20976 =item SYNOPSIS
20977
20978 =item DESCRIPTION
20979
20980 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
20981 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR
20982 this, SCALAR this
20983
20984 =item Inheriting from B<Tie::StdHash>
20985
20986 =item Inheriting from B<Tie::ExtraHash>
20987
20988 =item C<SCALAR>, C<UNTIE> and C<DESTROY>
20989
20990 =item MORE INFORMATION
20991
20992 =back
20993
20994 =head2 Tie::Memoize - add data to hash when needed
20995
20996 =over 4
20997
20998 =item SYNOPSIS
20999
21000 =item DESCRIPTION
21001
21002 =item Inheriting from B<Tie::Memoize>
21003
21004 =item EXAMPLE
21005
21006 =item BUGS
21007
21008 =item AUTHOR
21009
21010 =back
21011
21012 =head2 Tie::RefHash - use references as hash keys
21013
21014 =over 4
21015
21016 =item SYNOPSIS
21017
21018 =item DESCRIPTION
21019
21020 =item EXAMPLE
21021
21022 =item AUTHOR
21023
21024 =item VERSION
21025
21026 =item SEE ALSO
21027
21028 =back
21029
21030 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
21031 scalars
21032
21033 =over 4
21034
21035 =item SYNOPSIS
21036
21037 =item DESCRIPTION
21038
21039 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
21040
21041 =item MORE INFORMATION
21042
21043 =back
21044
21045 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
21046
21047 =over 4
21048
21049 =item SYNOPSIS
21050
21051 =item DESCRIPTION
21052
21053 =item CAVEATS
21054
21055 =back
21056
21057 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
21058 timers
21059
21060 =over 4
21061
21062 =item SYNOPSIS
21063
21064 =item DESCRIPTION
21065
21066 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
21067 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
21068 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer (
21069 $which, $floating_seconds [, $interval_floating_seconds ] ), getitimer (
21070 $which )
21071
21072 =item EXAMPLES
21073
21074 =item C API
21075
21076 =item DIAGNOSTICS
21077
21078 =over 4
21079
21080 =item negative time not invented yet
21081
21082 =item internal error: useconds < 0 (unsigned ... signed ...)
21083
21084 =back
21085
21086 =item CAVEATS
21087
21088 =item AUTHORS
21089
21090 =item COPYRIGHT AND LICENSE
21091
21092 =back
21093
21094 =head2 Time::Local - efficiently compute time from local and GMT time
21095
21096 =over 4
21097
21098 =item SYNOPSIS
21099
21100 =item DESCRIPTION
21101
21102 =over 4
21103
21104 =item Ambiguous Local Times (DST)
21105
21106 =item Non-Existent Local Times (DST)
21107
21108 =item Negative Epoch Values
21109
21110 =back
21111
21112 =item IMPLEMENTATION
21113
21114 =item BUGS
21115
21116 =item SUPPORT
21117
21118 =item AUTHOR
21119
21120 =back
21121
21122 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
21123 function
21124
21125 =over 4
21126
21127 =item SYNOPSIS
21128
21129 =item DESCRIPTION
21130
21131 =item NOTE
21132
21133 =item AUTHOR
21134
21135 =back
21136
21137 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
21138 function
21139
21140 =over 4
21141
21142 =item SYNOPSIS
21143
21144 =item DESCRIPTION
21145
21146 =item NOTE
21147
21148 =item AUTHOR
21149
21150 =back
21151
21152 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
21153
21154 =over 4
21155
21156 =item SYNOPSIS
21157
21158 =item DESCRIPTION
21159
21160 =item AUTHOR
21161
21162 =back
21163
21164 =head2 UNIVERSAL - base class for ALL classes (blessed references)
21165
21166 =over 4
21167
21168 =item SYNOPSIS
21169
21170 =item DESCRIPTION
21171
21172 C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<isa( VAL, TYPE )>,
21173 C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD ) >>, C<<
21174 CLASS->can( METHOD ) >>, C<can( VAL, METHOD )>, C<VERSION ( [ REQUIRE ] )>
21175
21176 =item EXPORTS
21177
21178 =back
21179
21180 =head2 Unicode::Collate - Unicode Collation Algorithm
21181
21182 =over 4
21183
21184 =item SYNOPSIS
21185
21186 =item DESCRIPTION
21187
21188 =over 4
21189
21190 =item Constructor and Tailoring
21191
21192 UCA_Version, backwards, entry, hangul_terminator, ignoreName, ignoreChar,
21193 level, normalization, overrideCJK, overrideHangul, preprocess, rearrange,
21194 table, undefName, undefChar, katakana_before_hiragana, upper_before_lower,
21195 variable, alternate
21196
21197 =item Methods for Collation
21198
21199 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
21200 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
21201 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
21202 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
21203 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
21204 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
21205 $Collator-E<gt>viewSortKey($string)>
21206
21207 =item Methods for Searching
21208
21209 C<$position = $Collator-E<gt>index($string, $substring[, $position])>,
21210 C<($position, $length) = $Collator-E<gt>index($string, $substring[,
21211 $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>,
21212 C<($match)   = $Collator-E<gt>match($string, $substring)>, C<@match =
21213 $Collator-E<gt>gmatch($string, $substring)>, C<$count =
21214 $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count =
21215 $Collator-E<gt>gsubst($string, $substring, $replacement)>
21216
21217 =item Other Methods
21218
21219 C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, C<$version =
21220 $Collator-E<gt>version()>, C<UCA_Version()>, C<Base_Unicode_Version()>
21221
21222 =item EXPORT
21223
21224 =item CAVEAT
21225
21226 =item Conformance Test
21227
21228 =back
21229
21230 =item AUTHOR
21231
21232 =item SEE ALSO
21233
21234 Unicode Collation Algorithm - UTS #10, The Default Unicode Collation
21235 Element Table (DUCET), The conformance test for the UCA, Hangul Syllable
21236 Type, Unicode Normalization Forms - UAX #15, L<Unicode::Normalize>
21237
21238 =back
21239
21240 =head2 Unicode::Normalize - Unicode Normalization Forms
21241
21242 =over 4
21243
21244 =item SYNOPSIS
21245
21246 =item DESCRIPTION
21247
21248 =over 4
21249
21250 =item Normalization Forms
21251
21252 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
21253 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
21254 C<$FCD_string = FCD($string)>, C<$FCC_string = FCC($string)>,
21255 C<$normalized_string = normalize($form_name, $string)>
21256
21257 =item Decomposition and Composition
21258
21259 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
21260 decompose($string, $useCompatMapping)>, C<$reordered_string  =
21261 reorder($string)>, C<$composed_string   = compose($string)>
21262
21263 =item Quick Check
21264
21265 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
21266 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
21267 checkFCD($string)>, C<$result = checkFCC($string)>, C<$result =
21268 check($form_name, $string)>
21269
21270 =item Character Data
21271
21272 C<$canonical_decomposed = getCanon($codepoint)>,
21273 C<$compatibility_decomposed = getCompat($codepoint)>,
21274 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
21275 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
21276 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
21277 C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>,
21278 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
21279
21280 =item EXPORT
21281
21282 =back
21283
21284 =item AUTHOR
21285
21286 =item SEE ALSO
21287
21288 http://www.unicode.org/reports/tr15/,
21289 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt,
21290 http://www.unicode.org/notes/tn5/
21291
21292 =back
21293
21294 =head2 Unicode::UCD - Unicode character database
21295
21296 =over 4
21297
21298 =item SYNOPSIS
21299
21300 =item DESCRIPTION
21301
21302 =back
21303
21304 =over 4
21305
21306 =item charinfo
21307
21308 =back
21309
21310 =over 4
21311
21312 =item charblock
21313
21314 =back
21315
21316 =over 4
21317
21318 =item charscript
21319
21320 =back
21321
21322 =over 4
21323
21324 =item charblocks
21325
21326 =back
21327
21328 =over 4
21329
21330 =item charscripts
21331
21332 =back
21333
21334 =over 4
21335
21336 =item Blocks versus Scripts
21337
21338 =item Matching Scripts and Blocks
21339
21340 =item Code Point Arguments
21341
21342 =item charinrange
21343
21344 =back
21345
21346 =over 4
21347
21348 =item compexcl
21349
21350 =back
21351
21352 =over 4
21353
21354 =item casefold
21355
21356 =back
21357
21358 =over 4
21359
21360 =item casespec
21361
21362 =back
21363
21364 =over 4
21365
21366 =item Unicode::UCD::UnicodeVersion
21367
21368 =back
21369
21370 =over 4
21371
21372 =item Implementation Note
21373
21374 =back
21375
21376 =over 4
21377
21378 =item BUGS
21379
21380 =item AUTHOR
21381
21382 =back
21383
21384 =head2 User::grent - by-name interface to Perl's built-in getgr*()
21385 functions
21386
21387 =over 4
21388
21389 =item SYNOPSIS
21390
21391 =item DESCRIPTION
21392
21393 =item NOTE
21394
21395 =item AUTHOR
21396
21397 =back
21398
21399 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
21400 functions
21401
21402 =over 4
21403
21404 =item SYNOPSIS
21405
21406 =item DESCRIPTION
21407
21408 =over 4
21409
21410 =item System Specifics
21411
21412 =back
21413
21414 =item NOTE
21415
21416 =item AUTHOR
21417
21418 =item HISTORY
21419
21420 March 18th, 2000
21421
21422 =back
21423
21424 =head2 XSLoader - Dynamically load C libraries into Perl code
21425
21426 =over 4
21427
21428 =item SYNOPSIS
21429
21430 =item DESCRIPTION
21431
21432 =over 4
21433
21434 =item Migration from C<DynaLoader>
21435
21436 =item Backward compatible boilerplate
21437
21438 =back
21439
21440 =item Order of initialization: early load()
21441
21442 =over 4
21443
21444 =item The most hairy case
21445
21446 =back
21447
21448 =item LIMITATIONS
21449
21450 =item AUTHOR
21451
21452 =back
21453
21454 =head1 AUXILIARY DOCUMENTATION
21455
21456 Here should be listed all the extra programs' documentation, but they
21457 don't all have manual pages yet:
21458
21459 =over 4
21460
21461 =item a2p
21462
21463 =item c2ph
21464
21465 =item dprofpp
21466
21467 =item h2ph
21468
21469 =item h2xs
21470
21471 =item perlbug
21472
21473 =item perldoc
21474
21475 =item pl2pm
21476
21477 =item pod2html
21478
21479 =item pod2man
21480
21481 =item s2p
21482
21483 =item splain
21484
21485 =item xsubpp
21486
21487 =back
21488
21489 =head1 AUTHOR
21490
21491 Larry Wall <F<larry@wall.org>>, with the help of oodles
21492 of other folks.
21493