Add a perl592delta.pod man page.
[p5sagit/p5-mst-13.2.git] / pod / perltoc.pod
1
2 # !!!!!!!   DO NOT EDIT THIS FILE   !!!!!!!
3 # This file is autogenerated by buildtoc from all the other pods.
4 # Edit those files and run buildtoc --build-toc to effect changes.
5
6 =head1 NAME
7
8 perltoc - perl documentation table of contents
9
10 =head1 DESCRIPTION
11
12 This page provides a brief table of contents for the rest of the Perl
13 documentation set.  It is meant to be scanned quickly or grepped
14 through to locate the proper section you're looking for.
15
16 =head1 BASIC DOCUMENTATION
17
18 =head2 perl - Practical Extraction and Report Language
19
20 =over 4
21
22 =item SYNOPSIS
23
24 =over 4
25
26 =item Overview
27
28 =item Tutorials
29
30 =item Reference Manual
31
32 =item Internals and C Language Interface
33
34 =item Miscellaneous
35
36 =item Language-Specific
37
38 =item Platform-Specific
39
40 =back
41
42 =item DESCRIPTION
43
44 =item AVAILABILITY
45
46 =item ENVIRONMENT
47
48 =item AUTHOR
49
50 =item FILES
51
52 =item SEE ALSO
53
54 =item DIAGNOSTICS
55
56 =item BUGS
57
58 =item NOTES
59
60 =back
61
62 =head2 perlintro -- a brief introduction and overview of Perl
63
64 =over 4
65
66 =item DESCRIPTION
67
68 =over 4
69
70 =item What is Perl?
71
72 =item Running Perl programs
73
74 =item Basic syntax overview
75
76 =item Perl variable types
77
78 Scalars, Arrays, Hashes
79
80 =item Variable scoping
81
82 =item Conditional and looping constructs
83
84 if, while, for, foreach
85
86 =item Builtin operators and functions
87
88 Arithmetic, Numeric comparison, String comparison, Boolean logic,
89 Miscellaneous
90
91 =item Files and I/O
92
93 =item Regular expressions
94
95 Simple matching, Simple substitution, More complex regular expressions,
96 Parentheses for capturing, Other regexp features
97
98 =item Writing subroutines
99
100 =item OO Perl
101
102 =item Using Perl modules
103
104 =back
105
106 =item AUTHOR
107
108 =back
109
110 =head2 perlreftut - Mark's very short tutorial about references
111
112 =over 4
113
114 =item DESCRIPTION
115
116 =item Who Needs Complicated Data Structures?
117
118 =item The Solution
119
120 =item Syntax
121
122 =over 4
123
124 =item Making References
125
126 =item Using References
127
128 =item An Example
129
130 =item Arrow Rule
131
132 =back
133
134 =item Solution
135
136 =item The Rest
137
138 =item Summary
139
140 =item Credits
141
142 =over 4
143
144 =item Distribution Conditions
145
146 =back
147
148 =back
149
150 =head2 perldsc - Perl Data Structures Cookbook
151
152 =over 4
153
154 =item DESCRIPTION
155
156 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
157 more elaborate constructs
158
159 =item REFERENCES
160
161 =item COMMON MISTAKES
162
163 =item CAVEAT ON PRECEDENCE
164
165 =item WHY YOU SHOULD ALWAYS C<use strict>
166
167 =item DEBUGGING
168
169 =item CODE EXAMPLES
170
171 =item ARRAYS OF ARRAYS
172
173 =over 4
174
175 =item Declaration of an ARRAY OF ARRAYS
176
177 =item Generation of an ARRAY OF ARRAYS
178
179 =item Access and Printing of an ARRAY OF ARRAYS
180
181 =back
182
183 =item HASHES OF ARRAYS
184
185 =over 4
186
187 =item Declaration of a HASH OF ARRAYS
188
189 =item Generation of a HASH OF ARRAYS
190
191 =item Access and Printing of a HASH OF ARRAYS
192
193 =back
194
195 =item ARRAYS OF HASHES
196
197 =over 4
198
199 =item Declaration of an ARRAY OF HASHES
200
201 =item Generation of an ARRAY OF HASHES
202
203 =item Access and Printing of an ARRAY OF HASHES
204
205 =back
206
207 =item HASHES OF HASHES
208
209 =over 4
210
211 =item Declaration of a HASH OF HASHES
212
213 =item Generation of a HASH OF HASHES
214
215 =item Access and Printing of a HASH OF HASHES
216
217 =back
218
219 =item MORE ELABORATE RECORDS
220
221 =over 4
222
223 =item Declaration of MORE ELABORATE RECORDS
224
225 =item Declaration of a HASH OF COMPLEX RECORDS
226
227 =item Generation of a HASH OF COMPLEX RECORDS
228
229 =back
230
231 =item Database Ties
232
233 =item SEE ALSO
234
235 =item AUTHOR
236
237 =back
238
239 =head2 perllol - Manipulating Arrays of Arrays in Perl
240
241 =over 4
242
243 =item DESCRIPTION
244
245 =over 4
246
247 =item Declaration and Access of Arrays of Arrays
248
249 =item Growing Your Own
250
251 =item Access and Printing
252
253 =item Slices
254
255 =back
256
257 =item SEE ALSO
258
259 =item AUTHOR
260
261 =back
262
263 =head2 perlrequick - Perl regular expressions quick start
264
265 =over 4
266
267 =item DESCRIPTION
268
269 =item The Guide
270
271 =over 4
272
273 =item Simple word matching
274
275 =item Using character classes
276
277 =item Matching this or that
278
279 =item Grouping things and hierarchical matching
280
281 =item Extracting matches
282
283 =item Matching repetitions
284
285 =item More matching
286
287 =item Search and replace
288
289 =item The split operator
290
291 =back
292
293 =item BUGS
294
295 =item SEE ALSO
296
297 =item AUTHOR AND COPYRIGHT
298
299 =over 4
300
301 =item Acknowledgments
302
303 =back
304
305 =back
306
307 =head2 perlretut - Perl regular expressions tutorial
308
309 =over 4
310
311 =item DESCRIPTION
312
313 =item Part 1: The basics
314
315 =over 4
316
317 =item Simple word matching
318
319 =item Using character classes
320
321 =item Matching this or that
322
323 =item Grouping things and hierarchical matching
324
325 =item Extracting matches
326
327 =item Matching repetitions
328
329 =item Building a regexp
330
331 =item Using regular expressions in Perl
332
333 =back
334
335 =item Part 2: Power tools
336
337 =over 4
338
339 =item More on characters, strings, and character classes
340
341 =item Compiling and saving regular expressions
342
343 =item Embedding comments and modifiers in a regular expression
344
345 =item Non-capturing groupings
346
347 =item Looking ahead and looking behind
348
349 =item Using independent subexpressions to prevent backtracking
350
351 =item Conditional expressions
352
353 =item A bit of magic: executing Perl code in a regular expression
354
355 =item Pragmas and debugging
356
357 =back
358
359 =item BUGS
360
361 =item SEE ALSO
362
363 =item AUTHOR AND COPYRIGHT
364
365 =over 4
366
367 =item Acknowledgments
368
369 =back
370
371 =back
372
373 =head2 perlboot - Beginner's Object-Oriented Tutorial
374
375 =over 4
376
377 =item DESCRIPTION
378
379 =over 4
380
381 =item If we could talk to the animals...
382
383 =item Introducing the method invocation arrow
384
385 =item Invoking a barnyard
386
387 =item The extra parameter of method invocation
388
389 =item Calling a second method to simplify things
390
391 =item Inheriting the windpipes
392
393 =item A few notes about @ISA
394
395 =item Overriding the methods
396
397 =item Starting the search from a different place
398
399 =item The SUPER way of doing things
400
401 =item Where we're at so far...
402
403 =item A horse is a horse, of course of course -- or is it?
404
405 =item Invoking an instance method
406
407 =item Accessing the instance data
408
409 =item How to build a horse
410
411 =item Inheriting the constructor
412
413 =item Making a method work with either classes or instances
414
415 =item Adding parameters to a method
416
417 =item More interesting instances
418
419 =item A horse of a different color
420
421 =item Summary
422
423 =back
424
425 =item SEE ALSO
426
427 =item COPYRIGHT
428
429 =back
430
431 =head2 perltoot - Tom's object-oriented tutorial for perl
432
433 =over 4
434
435 =item DESCRIPTION
436
437 =item Creating a Class
438
439 =over 4
440
441 =item Object Representation
442
443 =item Class Interface
444
445 =item Constructors and Instance Methods
446
447 =item Planning for the Future: Better Constructors
448
449 =item Destructors
450
451 =item Other Object Methods
452
453 =back
454
455 =item Class Data
456
457 =over 4
458
459 =item Accessing Class Data
460
461 =item Debugging Methods
462
463 =item Class Destructors
464
465 =item Documenting the Interface
466
467 =back
468
469 =item Aggregation
470
471 =item Inheritance
472
473 =over 4
474
475 =item Overridden Methods
476
477 =item Multiple Inheritance
478
479 =item UNIVERSAL: The Root of All Objects
480
481 =back
482
483 =item Alternate Object Representations
484
485 =over 4
486
487 =item Arrays as Objects
488
489 =item Closures as Objects
490
491 =back
492
493 =item AUTOLOAD: Proxy Methods
494
495 =over 4
496
497 =item Autoloaded Data Methods
498
499 =item Inherited Autoloaded Data Methods
500
501 =back
502
503 =item Metaclassical Tools
504
505 =over 4
506
507 =item Class::Struct
508
509 =item Data Members as Variables
510
511 =back
512
513 =item NOTES
514
515 =over 4
516
517 =item Object Terminology
518
519 =back
520
521 =item SEE ALSO
522
523 =item AUTHOR AND COPYRIGHT
524
525 =item COPYRIGHT
526
527 =over 4
528
529 =item Acknowledgments
530
531 =back
532
533 =back
534
535 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
536
537 =over 4
538
539 =item DESCRIPTION
540
541 =item Class Data in a Can
542
543 =item Class Data as Package Variables
544
545 =over 4
546
547 =item Putting All Your Eggs in One Basket
548
549 =item Inheritance Concerns
550
551 =item The Eponymous Meta-Object
552
553 =item Indirect References to Class Data
554
555 =item Monadic Classes
556
557 =item Translucent Attributes
558
559 =back
560
561 =item Class Data as Lexical Variables
562
563 =over 4
564
565 =item Privacy and Responsibility 
566
567 =item File-Scoped Lexicals
568
569 =item More Inheritance Concerns
570
571 =item Locking the Door and Throwing Away the Key
572
573 =item Translucency Revisited
574
575 =back
576
577 =item NOTES
578
579 =item SEE ALSO
580
581 =item AUTHOR AND COPYRIGHT
582
583 =item ACKNOWLEDGEMENTS
584
585 =item HISTORY
586
587 =back
588
589 =head2 perlbot - Bag'o Object Tricks (the BOT)
590
591 =over 4
592
593 =item DESCRIPTION
594
595 =item OO SCALING TIPS
596
597 =item INSTANCE VARIABLES
598
599 =item SCALAR INSTANCE VARIABLES
600
601 =item INSTANCE VARIABLE INHERITANCE
602
603 =item OBJECT RELATIONSHIPS
604
605 =item OVERRIDING SUPERCLASS METHODS
606
607 =item USING RELATIONSHIP WITH SDBM
608
609 =item THINKING OF CODE REUSE
610
611 =item CLASS CONTEXT AND THE OBJECT
612
613 =item INHERITING A CONSTRUCTOR
614
615 =item DELEGATION
616
617 =item SEE ALSO
618
619 =back
620
621 =head2 perlstyle - Perl style guide
622
623 =over 4
624
625 =item DESCRIPTION
626
627 =back
628
629 =head2 perlcheat - Perl 5 Cheat Sheet
630
631 =over 4
632
633 =item DESCRIPTION
634
635 =over 4
636
637 =item The sheet
638
639 =back
640
641 =item ACKNOWLEDGEMENTS
642
643 =item AUTHOR
644
645 =item SEE ALSO
646
647 =back
648
649 =head2 perltrap - Perl traps for the unwary
650
651 =over 4
652
653 =item DESCRIPTION
654
655 =over 4
656
657 =item Awk Traps
658
659 =item C/C++ Traps
660
661 =item Sed Traps
662
663 =item Shell Traps
664
665 =item Perl Traps
666
667 =item Perl4 to Perl5 Traps
668
669 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
670 Traps, General data type traps, Context Traps - scalar, list contexts,
671 Precedence Traps, General Regular Expression Traps using s///, etc,
672 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
673
674 =item Discontinuance, Deprecation, and BugFix traps
675
676 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
677 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
678 Discontinuance, Deprecation, Discontinuance, Discontinuance
679
680 =item Parsing Traps
681
682 Parsing, Parsing, Parsing, Parsing, Parsing
683
684 =item Numerical Traps
685
686 Numerical, Numerical, Numerical, Bitwise string ops
687
688 =item General data type traps
689
690 (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
691 (Constants), (Scalars), (Variable Suicide)
692
693 =item Context Traps - scalar, list contexts
694
695 (list context), (scalar context), (scalar context), (list, builtin)
696
697 =item Precedence Traps
698
699 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
700 Precedence
701
702 =item General Regular Expression Traps using s///, etc.
703
704 Regular Expression, Regular Expression, Regular Expression, Regular
705 Expression, Regular Expression, Regular Expression, Regular Expression,
706 Regular Expression, Regular Expression
707
708 =item Subroutine, Signal, Sorting Traps
709
710 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
711
712 =item OS Traps
713
714 (SysV), (SysV)
715
716 =item Interpolation Traps
717
718 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
719 Interpolation, Interpolation, Interpolation, Interpolation
720
721 =item DBM Traps
722
723 DBM, DBM
724
725 =item Unclassified Traps
726
727 C<require>/C<do> trap using returned value, C<split> on empty string with
728 LIMIT specified
729
730 =back
731
732 =back
733
734 =head2 perldebtut - Perl debugging tutorial
735
736 =over 4
737
738 =item DESCRIPTION
739
740 =item use strict
741
742 =item Looking at data and -w and v
743
744 =item help
745
746 =item Stepping through code
747
748 =item Placeholder for a, w, t, T
749
750 =item REGULAR EXPRESSIONS
751
752 =item OUTPUT TIPS
753
754 =item CGI
755
756 =item GUIs
757
758 =item SUMMARY
759
760 =item SEE ALSO
761
762 =item AUTHOR
763
764 =item CONTRIBUTORS
765
766 =back
767
768 =head2 perlfaq - frequently asked questions about Perl ($Date: 2003/01/31
769 17:37:17 $)
770
771 =over 4
772
773 =item DESCRIPTION
774
775 =over 4
776
777 =item Where to get the perlfaq
778
779 =item How to contribute to the perlfaq
780
781 =item What will happen if you mail your Perl programming problems to the
782 authors
783
784 =back
785
786 =item Credits
787
788 =item Author and Copyright Information
789
790 =over 4
791
792 =item Bundled Distributions
793
794 =item Disclaimer
795
796 =back
797
798 =item Table of Contents
799
800 perlfaq  - this document, perlfaq1 - General Questions About Perl, perlfaq2
801 - Obtaining and Learning about Perl, perlfaq3 - Programming Tools, perlfaq4
802 - Data Manipulation, perlfaq5 - Files and Formats, perlfaq6 - Regular
803 Expressions, perlfaq7 - General Perl Language Issues, perlfaq8 - System
804 Interaction, perlfaq9 - Networking
805
806 =item The Questions
807
808 =over 4
809
810 =item L<perlfaq1>: General Questions About Perl
811
812 =item L<perlfaq2>: Obtaining and Learning about Perl
813
814 =item L<perlfaq3>: Programming Tools
815
816 =item L<perlfaq4>: Data Manipulation
817
818 =item L<perlfaq5>: Files and Formats
819
820 =item L<perlfaq6>: Regular Expressions
821
822 =item L<perlfaq7>: General Perl Language Issues
823
824 =item L<perlfaq8>: System Interaction
825
826 =item L<perlfaq9>: Networking
827
828 =back
829
830 =back
831
832 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.14 $, $Date:
833 2003/11/23 08:02:29 $)
834
835 =over 4
836
837 =item DESCRIPTION
838
839 =over 4
840
841 =item What is Perl?
842
843 =item Who supports Perl?  Who develops it?  Why is it free?
844
845 =item Which version of Perl should I use?
846
847 =item What are perl4 and perl5?
848
849 =item What is Ponie?
850
851 =item What is perl6?
852
853 =item How stable is Perl?
854
855 =item Is Perl difficult to learn?
856
857 =item How does Perl compare with other languages like Java, Python, REXX,
858 Scheme, or Tcl?
859
860 =item Can I do [task] in Perl?
861
862 =item When shouldn't I program in Perl?
863
864 =item What's the difference between "perl" and "Perl"?
865
866 =item Is it a Perl program or a Perl script?
867
868 =item What is a JAPH?
869
870 =item Where can I get a list of Larry Wall witticisms?
871
872 =item How can I convince my sysadmin/supervisor/employees to use version
873 5/5.6.1/Perl instead of some other language?
874
875 =back
876
877 =item AUTHOR AND COPYRIGHT
878
879 =back
880
881 =head2 perlfaq2 - Obtaining and Learning about Perl ($Revision: 1.25 $,
882 $Date: 2003/10/16 04:57:38 $)
883
884 =over 4
885
886 =item DESCRIPTION
887
888 =over 4
889
890 =item What machines support Perl?  Where do I get it?
891
892 =item How can I get a binary version of Perl?
893
894 =item I don't have a C compiler on my system.  How can I compile perl?
895
896 =item I copied the Perl binary from one machine to another, but scripts
897 don't work.
898
899 =item I grabbed the sources and tried to compile but gdbm/dynamic
900 loading/malloc/linking/... failed.  How do I make it work?
901
902 =item What modules and extensions are available for Perl?  What is CPAN? 
903 What does CPAN/src/... mean?
904
905 =item Is there an ISO or ANSI certified version of Perl?
906
907 =item Where can I get information on Perl?
908
909 =item What are the Perl newsgroups on Usenet?  Where do I post questions?
910
911 =item Where should I post source code?
912
913 =item Perl Books
914
915 References, Tutorials, Task-Oriented, Special Topics
916
917 =item Perl in Magazines
918
919 =item Perl on the Net: FTP and WWW Access
920
921 =item What mailing lists are there for Perl?
922
923 =item Archives of comp.lang.perl.misc
924
925 =item Where can I buy a commercial version of Perl?
926
927 =item Where do I send bug reports?
928
929 =item What is perl.com? Perl Mongers? pm.org? perl.org? cpan.org?
930
931 =back
932
933 =item AUTHOR AND COPYRIGHT
934
935 =back
936
937 =head2 perlfaq3 - Programming Tools ($Revision: 1.37 $, $Date: 2003/11/24
938 19:55:50 $)
939
940 =over 4
941
942 =item DESCRIPTION
943
944 =over 4
945
946 =item How do I do (anything)?
947
948 =item How can I use Perl interactively?
949
950 =item Is there a Perl shell?
951
952 =item How do I find which modules are installed on my system?
953
954 =item How do I debug my Perl programs?
955
956 =item How do I profile my Perl programs?
957
958 =item How do I cross-reference my Perl programs?
959
960 =item Is there a pretty-printer (formatter) for Perl?
961
962 =item Is there a ctags for Perl?
963
964 =item Is there an IDE or Windows Perl Editor?
965
966 Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl,
967 GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis, Vile, Vim, Codewright,
968 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
969
970 =item Where can I get Perl macros for vi?
971
972 =item Where can I get perl-mode for emacs?
973
974 =item How can I use curses with Perl?
975
976 =item How can I use X or Tk with Perl?
977
978 =item How can I generate simple menus without using CGI or Tk?
979
980 =item How can I make my Perl program run faster?
981
982 =item How can I make my Perl program take less memory?
983
984 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
985 stringification, Pass by reference, Tie large variables to disk
986
987 =item Is it safe to return a reference to local or lexical data?
988
989 =item How can I free an array or hash so my program shrinks?
990
991 =item How can I make my CGI script more efficient?
992
993 =item How can I hide the source for my Perl program?
994
995 =item How can I compile my Perl program into byte code or C?
996
997 =item How can I compile Perl into Java?
998
999 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
1000
1001 =item Can I write useful Perl programs on the command line?
1002
1003 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
1004
1005 =item Where can I learn about CGI or Web programming in Perl?
1006
1007 =item Where can I learn about object-oriented Perl programming?
1008
1009 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
1010
1011 =item I've read perlembed, perlguts, etc., but I can't embed perl in
1012 my C program; what am I doing wrong?
1013
1014 =item When I tried to run my script, I got this message. What does it mean?
1015
1016 =item What's MakeMaker?
1017
1018 =back
1019
1020 =item AUTHOR AND COPYRIGHT
1021
1022 =back
1023
1024 =head2 perlfaq4 - Data Manipulation ($Revision: 1.54 $, $Date: 2003/11/30
1025 00:50:08 $)
1026
1027 =over 4
1028
1029 =item DESCRIPTION
1030
1031 =item Data: Numbers
1032
1033 =over 4
1034
1035 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
1036 numbers I should be getting (eg, 19.95)?
1037
1038 =item Why is int() broken?
1039
1040 =item Why isn't my octal data interpreted correctly?
1041
1042 =item Does Perl have a round() function?  What about ceil() and floor()? 
1043 Trig functions?
1044
1045 =item How do I convert between numeric representations/bases/radixes?
1046
1047 How do I convert hexadecimal into decimal, How do I convert from decimal to
1048 hexadecimal, How do I convert from octal to decimal, How do I convert from
1049 decimal to octal, How do I convert from binary to decimal, How do I convert
1050 from decimal to binary
1051
1052 =item Why doesn't & work the way I want it to?
1053
1054 =item How do I multiply matrices?
1055
1056 =item How do I perform an operation on a series of integers?
1057
1058 =item How can I output Roman numerals?
1059
1060 =item Why aren't my random numbers random?
1061
1062 =item How do I get a random number between X and Y?
1063
1064 =back
1065
1066 =item Data: Dates
1067
1068 =over 4
1069
1070 =item How do I find the day or week of the year?
1071
1072 =item How do I find the current century or millennium?
1073
1074 =item How can I compare two dates and find the difference?
1075
1076 =item How can I take a string and turn it into epoch seconds?
1077
1078 =item How can I find the Julian Day?
1079
1080 =item How do I find yesterday's date?
1081
1082 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
1083
1084 =back
1085
1086 =item Data: Strings
1087
1088 =over 4
1089
1090 =item How do I validate input?
1091
1092 =item How do I unescape a string?
1093
1094 =item How do I remove consecutive pairs of characters?
1095
1096 =item How do I expand function calls in a string?
1097
1098 =item How do I find matching/nesting anything?
1099
1100 =item How do I reverse a string?
1101
1102 =item How do I expand tabs in a string?
1103
1104 =item How do I reformat a paragraph?
1105
1106 =item How can I access or change N characters of a string?
1107
1108 =item How do I change the Nth occurrence of something?
1109
1110 =item How can I count the number of occurrences of a substring within a
1111 string?
1112
1113 =item How do I capitalize all the words on one line?
1114
1115 =item How can I split a [character] delimited string except when inside
1116 [character]?
1117
1118 =item How do I strip blank space from the beginning/end of a string?
1119
1120 =item How do I pad a string with blanks or pad a number with zeroes?
1121
1122 =item How do I extract selected columns from a string?
1123
1124 =item How do I find the soundex value of a string?
1125
1126 =item How can I expand variables in text strings?
1127
1128 =item What's wrong with always quoting "$vars"?
1129
1130 =item Why don't my E<lt>E<lt>HERE documents work?
1131
1132 There must be no space after the E<lt>E<lt> part, There (probably) should
1133 be a semicolon at the end, You can't (easily) have any space in front of
1134 the tag
1135
1136 =back
1137
1138 =item Data: Arrays
1139
1140 =over 4
1141
1142 =item What is the difference between a list and an array?
1143
1144 =item What is the difference between $array[1] and @array[1]?
1145
1146 =item How can I remove duplicate elements from a list or array?
1147
1148 a), b), c), d), e)
1149
1150 =item How can I tell whether a certain element is contained in a list or
1151 array?
1152
1153 =item How do I compute the difference of two arrays?  How do I compute the
1154 intersection of two arrays?
1155
1156 =item How do I test whether two arrays or hashes are equal?
1157
1158 =item How do I find the first array element for which a condition is true?
1159
1160 =item How do I handle linked lists?
1161
1162 =item How do I handle circular lists?
1163
1164 =item How do I shuffle an array randomly?
1165
1166 =item How do I process/modify each element of an array?
1167
1168 =item How do I select a random element from an array?
1169
1170 =item How do I permute N elements of a list?
1171
1172 =item How do I sort an array by (anything)?
1173
1174 =item How do I manipulate arrays of bits?
1175
1176 =item Why does defined() return true on empty arrays and hashes?
1177
1178 =back
1179
1180 =item Data: Hashes (Associative Arrays)
1181
1182 =over 4
1183
1184 =item How do I process an entire hash?
1185
1186 =item What happens if I add or remove keys from a hash while iterating over
1187 it?
1188
1189 =item How do I look up a hash element by value?
1190
1191 =item How can I know how many entries are in a hash?
1192
1193 =item How do I sort a hash (optionally by value instead of key)?
1194
1195 =item How can I always keep my hash sorted?
1196
1197 =item What's the difference between "delete" and "undef" with hashes?
1198
1199 =item Why don't my tied hashes make the defined/exists distinction?
1200
1201 =item How do I reset an each() operation part-way through?
1202
1203 =item How can I get the unique keys from two hashes?
1204
1205 =item How can I store a multidimensional array in a DBM file?
1206
1207 =item How can I make my hash remember the order I put elements into it?
1208
1209 =item Why does passing a subroutine an undefined element in a hash create
1210 it?
1211
1212 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
1213 array of hashes or arrays?
1214
1215 =item How can I use a reference as a hash key?
1216
1217 =back
1218
1219 =item Data: Misc
1220
1221 =over 4
1222
1223 =item How do I handle binary data correctly?
1224
1225 =item How do I determine whether a scalar is a number/whole/integer/float?
1226
1227 =item How do I keep persistent data across program calls?
1228
1229 =item How do I print out or copy a recursive data structure?
1230
1231 =item How do I define methods for every class/object?
1232
1233 =item How do I verify a credit card checksum?
1234
1235 =item How do I pack arrays of doubles or floats for XS code?
1236
1237 =back
1238
1239 =item AUTHOR AND COPYRIGHT
1240
1241 =back
1242
1243 =head2 perlfaq5 - Files and Formats ($Revision: 1.30 $, $Date: 2003/11/23
1244 08:07:46 $)
1245
1246 =over 4
1247
1248 =item DESCRIPTION
1249
1250 =over 4
1251
1252 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
1253
1254 =item How do I change one line in a file/delete a line in a file/insert a
1255 line in the middle of a file/append to the beginning of a file?
1256
1257 =item How do I count the number of lines in a file?
1258
1259 =item How can I use Perl's C<-i> option from within a program?
1260
1261 =item How do I make a temporary file name?
1262
1263 =item How can I manipulate fixed-record-length files?
1264
1265 =item How can I make a filehandle local to a subroutine?  How do I pass
1266 filehandles between subroutines?  How do I make an array of filehandles?
1267
1268 =item How can I use a filehandle indirectly?
1269
1270 =item How can I set up a footer format to be used with write()?
1271
1272 =item How can I write() into a string?
1273
1274 =item How can I output my numbers with commas added?
1275
1276 =item How can I translate tildes (~) in a filename?
1277
1278 =item How come when I open a file read-write it wipes it out?
1279
1280 =item Why do I sometimes get an "Argument list too long" when I use
1281 E<lt>*E<gt>?
1282
1283 =item Is there a leak/bug in glob()?
1284
1285 =item How can I open a file with a leading ">" or trailing blanks?
1286
1287 =item How can I reliably rename a file?
1288
1289 =item How can I lock a file?
1290
1291 =item Why can't I just open(FH, "E<gt>file.lock")?
1292
1293 =item I still don't get locking.  I just want to increment the number in
1294 the file.  How can I do this?
1295
1296 =item All I want to do is append a small amount of text to the end of a
1297 file.  Do I still have to use locking?
1298
1299 =item How do I randomly update a binary file?
1300
1301 =item How do I get a file's timestamp in perl?
1302
1303 =item How do I set a file's timestamp in perl?
1304
1305 =item How do I print to more than one file at once?
1306
1307 =item How can I read in an entire file all at once?
1308
1309 =item How can I read in a file by paragraphs?
1310
1311 =item How can I read a single character from a file?  From the keyboard?
1312
1313 =item How can I tell whether there's a character waiting on a filehandle?
1314
1315 =item How do I do a C<tail -f> in perl?
1316
1317 =item How do I dup() a filehandle in Perl?
1318
1319 =item How do I close a file descriptor by number?
1320
1321 =item Why can't I use "C:\temp\foo" in DOS paths?  Why doesn't
1322 `C:\temp\foo.exe` work?
1323
1324 =item Why doesn't glob("*.*") get all the files?
1325
1326 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
1327 protected files?  Isn't this a bug in Perl?
1328
1329 =item How do I select a random line from a file?
1330
1331 =item Why do I get weird spaces when I print an array of lines?
1332
1333 =back
1334
1335 =item AUTHOR AND COPYRIGHT
1336
1337 =back
1338
1339 =head2 perlfaq6 - Regular Expressions ($Revision: 1.20 $, $Date: 2003/01/03
1340 20:05:28 $)
1341
1342 =over 4
1343
1344 =item DESCRIPTION
1345
1346 =over 4
1347
1348 =item How can I hope to use regular expressions without creating illegible
1349 and unmaintainable code?
1350
1351 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
1352
1353 =item I'm having trouble matching over more than one line.  What's wrong?
1354
1355 =item How can I pull out lines between two patterns that are themselves on
1356 different lines?
1357
1358 =item I put a regular expression into $/ but it didn't work. What's wrong?
1359
1360 =item How do I substitute case insensitively on the LHS while preserving
1361 case on the RHS?
1362
1363 =item How can I make C<\w> match national character sets?
1364
1365 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
1366
1367 =item How can I quote a variable to use in a regex?
1368
1369 =item What is C</o> really for?
1370
1371 =item How do I use a regular expression to strip C style comments from a
1372 file?
1373
1374 =item Can I use Perl regular expressions to match balanced text?
1375
1376 =item What does it mean that regexes are greedy?  How can I get around it?
1377
1378 =item How do I process each word on each line?
1379
1380 =item How can I print out a word-frequency or line-frequency summary?
1381
1382 =item How can I do approximate matching?
1383
1384 =item How do I efficiently match many regular expressions at once?
1385
1386 =item Why don't word-boundary searches with C<\b> work for me?
1387
1388 =item Why does using $&, $`, or $' slow my program down?
1389
1390 =item What good is C<\G> in a regular expression?
1391
1392 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
1393
1394 =item What's wrong with using grep in a void context?
1395
1396 =item How can I match strings with multibyte characters?
1397
1398 =item How do I match a pattern that is supplied by the user?
1399
1400 =back
1401
1402 =item AUTHOR AND COPYRIGHT
1403
1404 =back
1405
1406 =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.15 $, $Date:
1407 2003/07/24 02:17:21 $)
1408
1409 =over 4
1410
1411 =item DESCRIPTION
1412
1413 =over 4
1414
1415 =item Can I get a BNF/yacc/RE for the Perl language?
1416
1417 =item What are all these $@%&* punctuation signs, and how do I know when to
1418 use them?
1419
1420 =item Do I always/never have to quote my strings or use semicolons and
1421 commas?
1422
1423 =item How do I skip some return values?
1424
1425 =item How do I temporarily block warnings?
1426
1427 =item What's an extension?
1428
1429 =item Why do Perl operators have different precedence than C operators?
1430
1431 =item How do I declare/create a structure?
1432
1433 =item How do I create a module?
1434
1435 =item How do I create a class?
1436
1437 =item How can I tell if a variable is tainted?
1438
1439 =item What's a closure?
1440
1441 =item What is variable suicide and how can I prevent it?
1442
1443 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
1444 Regex}?
1445
1446 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
1447 Passing Methods
1448
1449 =item How do I create a static variable?
1450
1451 =item What's the difference between dynamic and lexical (static) scoping? 
1452 Between local() and my()?
1453
1454 =item How can I access a dynamic variable while a similarly named lexical
1455 is in scope?
1456
1457 =item What's the difference between deep and shallow binding?
1458
1459 =item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?
1460
1461 =item How do I redefine a builtin function, operator, or method?
1462
1463 =item What's the difference between calling a function as &foo and foo()?
1464
1465 =item How do I create a switch or case statement?
1466
1467 =item How can I catch accesses to undefined variables, functions, or
1468 methods?
1469
1470 =item Why can't a method included in this same file be found?
1471
1472 =item How can I find out my current package?
1473
1474 =item How can I comment out a large block of perl code?
1475
1476 =item How do I clear a package?
1477
1478 =item How can I use a variable as a variable name?
1479
1480 =item What does "bad interpreter" mean?
1481
1482 =back
1483
1484 =item AUTHOR AND COPYRIGHT
1485
1486 =back
1487
1488 =head2 perlfaq8 - System Interaction ($Revision: 1.17 $, $Date: 2003/01/26
1489 17:44:04 $)
1490
1491 =over 4
1492
1493 =item DESCRIPTION
1494
1495 =over 4
1496
1497 =item How do I find out which operating system I'm running under?
1498
1499 =item How come exec() doesn't return?
1500
1501 =item How do I do fancy stuff with the keyboard/screen/mouse?
1502
1503 Keyboard, Screen, Mouse
1504
1505 =item How do I print something out in color?
1506
1507 =item How do I read just one key without waiting for a return key?
1508
1509 =item How do I check whether input is ready on the keyboard?
1510
1511 =item How do I clear the screen?
1512
1513 =item How do I get the screen size?
1514
1515 =item How do I ask the user for a password?
1516
1517 =item How do I read and write the serial port?
1518
1519 lockfiles, open mode, end of line, flushing output, non-blocking input
1520
1521 =item How do I decode encrypted password files?
1522
1523 =item How do I start a process in the background?
1524
1525 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
1526
1527 =item How do I trap control characters/signals?
1528
1529 =item How do I modify the shadow password file on a Unix system?
1530
1531 =item How do I set the time and date?
1532
1533 =item How can I sleep() or alarm() for under a second?
1534
1535 =item How can I measure time under a second?
1536
1537 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
1538
1539 =item Why doesn't my sockets program work under System V (Solaris)?  What
1540 does the error message "Protocol not supported" mean?
1541
1542 =item How can I call my system's unique C functions from Perl?
1543
1544 =item Where do I get the include files to do ioctl() or syscall()?
1545
1546 =item Why do setuid perl scripts complain about kernel problems?
1547
1548 =item How can I open a pipe both to and from a command?
1549
1550 =item Why can't I get the output of a command with system()?
1551
1552 =item How can I capture STDERR from an external command?
1553
1554 =item Why doesn't open() return an error when a pipe open fails?
1555
1556 =item What's wrong with using backticks in a void context?
1557
1558 =item How can I call backticks without shell processing?
1559
1560 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
1561 ^Z on MS-DOS)?
1562
1563 =item How can I convert my shell script to perl?
1564
1565 =item Can I use perl to run a telnet or ftp session?
1566
1567 =item How can I write expect in Perl?
1568
1569 =item Is there a way to hide perl's command line from programs such as
1570 "ps"?
1571
1572 =item I {changed directory, modified my environment} in a perl script.  How
1573 come the change disappeared when I exited the script?  How do I get my
1574 changes to be visible?
1575
1576 Unix
1577
1578 =item How do I close a process's filehandle without waiting for it to
1579 complete?
1580
1581 =item How do I fork a daemon process?
1582
1583 =item How do I find out if I'm running interactively or not?
1584
1585 =item How do I timeout a slow event?
1586
1587 =item How do I set CPU limits?
1588
1589 =item How do I avoid zombies on a Unix system?
1590
1591 =item How do I use an SQL database?
1592
1593 =item How do I make a system() exit on control-C?
1594
1595 =item How do I open a file without blocking?
1596
1597 =item How do I install a module from CPAN?
1598
1599 =item What's the difference between require and use?
1600
1601 =item How do I keep my own module/library directory?
1602
1603 =item How do I add the directory my program lives in to the module/library
1604 search path?
1605
1606 =item How do I add a directory to my include path (@INC) at runtime?
1607
1608 =item What is socket.ph and where do I get it?
1609
1610 =back
1611
1612 =item AUTHOR AND COPYRIGHT
1613
1614 =back
1615
1616 =head2 perlfaq9 - Networking ($Revision: 1.15 $, $Date: 2003/01/31 17:36:57
1617 $)
1618
1619 =over 4
1620
1621 =item DESCRIPTION
1622
1623 =over 4
1624
1625 =item What is the correct form of response from a CGI script?
1626
1627 =item My CGI script runs from the command line but not the browser.  (500
1628 Server Error)
1629
1630 =item How can I get better error messages from a CGI program?
1631
1632 =item How do I remove HTML from a string?
1633
1634 =item How do I extract URLs?
1635
1636 =item How do I download a file from the user's machine?  How do I open a
1637 file on another machine?
1638
1639 =item How do I make a pop-up menu in HTML?
1640
1641 =item How do I fetch an HTML file?
1642
1643 =item How do I automate an HTML form submission?
1644
1645 =item How do I decode or create those %-encodings on the web?
1646
1647 =item How do I redirect to another page?
1648
1649 =item How do I put a password on my web pages?
1650
1651 =item How do I edit my .htpasswd and .htgroup files with Perl?
1652
1653 =item How do I make sure users can't enter values into a form that cause my
1654 CGI script to do bad things?
1655
1656 =item How do I parse a mail header?
1657
1658 =item How do I decode a CGI form?
1659
1660 =item How do I check a valid mail address?
1661
1662 =item How do I decode a MIME/BASE64 string?
1663
1664 =item How do I return the user's mail address?
1665
1666 =item How do I send mail?
1667
1668 =item How do I use MIME to make an attachment to a mail message?
1669
1670 =item How do I read mail?
1671
1672 =item How do I find out my hostname/domainname/IP address?
1673
1674 =item How do I fetch a news article or the active newsgroups?
1675
1676 =item How do I fetch/put an FTP file?
1677
1678 =item How can I do RPC in Perl?
1679
1680 =back
1681
1682 =item AUTHOR AND COPYRIGHT
1683
1684 =back
1685
1686 =head2 perlsyn - Perl syntax
1687
1688 =over 4
1689
1690 =item DESCRIPTION
1691
1692 =over 4
1693
1694 =item Declarations
1695
1696 =item Comments
1697
1698 =item Simple Statements
1699
1700 =item Truth and Falsehood
1701
1702 =item Statement Modifiers
1703
1704 =item Compound Statements
1705
1706 =item Loop Control
1707
1708 =item For Loops
1709
1710 =item Foreach Loops
1711
1712 =item Basic BLOCKs and Switch Statements
1713
1714 =item Goto
1715
1716 =item PODs: Embedded Documentation
1717
1718 =item Plain Old Comments (Not!)
1719
1720 =back
1721
1722 =back
1723
1724 =head2 perldata - Perl data types
1725
1726 =over 4
1727
1728 =item DESCRIPTION
1729
1730 =over 4
1731
1732 =item Variable names
1733
1734 =item Context
1735
1736 =item Scalar values
1737
1738 =item Scalar value constructors
1739
1740 =item List value constructors
1741
1742 =item Subscripts
1743
1744 =item Slices
1745
1746 =item Typeglobs and Filehandles
1747
1748 =back
1749
1750 =item SEE ALSO
1751
1752 =back
1753
1754 =head2 perlop - Perl operators and precedence
1755
1756 =over 4
1757
1758 =item DESCRIPTION
1759
1760 =over 4
1761
1762 =item Operator Precedence and Associativity
1763
1764 =item Terms and List Operators (Leftward)
1765
1766 =item The Arrow Operator
1767
1768 =item Auto-increment and Auto-decrement
1769
1770 =item Exponentiation
1771
1772 =item Symbolic Unary Operators
1773
1774 =item Binding Operators
1775
1776 =item Multiplicative Operators
1777
1778 =item Additive Operators
1779
1780 =item Shift Operators
1781
1782 =item Named Unary Operators
1783
1784 =item Relational Operators
1785
1786 =item Equality Operators
1787
1788 =item Bitwise And
1789
1790 =item Bitwise Or and Exclusive Or
1791
1792 =item C-style Logical And
1793
1794 =item C-style Logical Or
1795
1796 =item C-style Logical Defined-Or
1797
1798 =item Range Operators
1799
1800 =item Conditional Operator
1801
1802 =item Assignment Operators
1803
1804 =item Comma Operator
1805
1806 =item List Operators (Rightward)
1807
1808 =item Logical Not
1809
1810 =item Logical And
1811
1812 =item Logical or, Defined or, and Exclusive Or
1813
1814 =item C Operators Missing From Perl
1815
1816 unary &, unary *, (TYPE)
1817
1818 =item Quote and Quote-like Operators
1819
1820 =item Regexp Quote-Like Operators
1821
1822 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
1823 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
1824 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
1825 y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF
1826
1827 =item Gory details of parsing quoted constructs
1828
1829 Finding the end, Removal of backslashes before delimiters, Interpolation,
1830 C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
1831 C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>,
1832 C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
1833 regular expressions
1834
1835 =item I/O Operators
1836
1837 =item Constant Folding
1838
1839 =item Bitwise String Operators
1840
1841 =item Integer Arithmetic
1842
1843 =item Floating-point Arithmetic
1844
1845 =item Bigger Numbers
1846
1847 =back
1848
1849 =back
1850
1851 =head2 perlsub - Perl subroutines
1852
1853 =over 4
1854
1855 =item SYNOPSIS
1856
1857 =item DESCRIPTION
1858
1859 =over 4
1860
1861 =item Private Variables via my()
1862
1863 =item Persistent Private Variables
1864
1865 =item Temporary Values via local()
1866
1867 =item Lvalue subroutines
1868
1869 Lvalue subroutines are EXPERIMENTAL
1870
1871 =item Passing Symbol Table Entries (typeglobs)
1872
1873 =item When to Still Use local()
1874
1875 =item Pass by Reference
1876
1877 =item Prototypes
1878
1879 =item Constant Functions
1880
1881 =item Overriding Built-in Functions
1882
1883 =item Autoloading
1884
1885 =item Subroutine Attributes
1886
1887 =back
1888
1889 =item SEE ALSO
1890
1891 =back
1892
1893 =head2 perlfunc - Perl builtin functions
1894
1895 =over 4
1896
1897 =item DESCRIPTION
1898
1899 =over 4
1900
1901 =item Perl Functions by Category
1902
1903 Functions for SCALARs or strings, Regular expressions and pattern matching,
1904 Numeric functions, Functions for real @ARRAYs, Functions for list data,
1905 Functions for real %HASHes, Input and output functions, Functions for fixed
1906 length data or records, Functions for filehandles, files, or directories,
1907 Keywords related to the control flow of your perl program, Keywords related
1908 to scoping, Miscellaneous functions, Functions for processes and process
1909 groups, Keywords related to perl modules, Keywords related to classes and
1910 object-orientedness, Low-level socket functions, System V interprocess
1911 communication functions, Fetching user and group info, Fetching network
1912 info, Time-related functions, Functions new in perl5, Functions obsoleted
1913 in perl5
1914
1915 =item Portability
1916
1917 =item Alphabetical Listing of Perl Functions
1918
1919 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, abs VALUE, abs, accept
1920 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
1921 binmode FILEHANDLE, LAYER, binmode FILEHANDLE, bless REF,CLASSNAME, bless
1922 REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE, chomp(
1923 LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr NUMBER,
1924 chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE,
1925 connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT,
1926 dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete
1927 EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump,
1928 each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST,
1929 exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl
1930 FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION,
1931 fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin,
1932 getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam
1933 NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname
1934 NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr
1935 ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
1936 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
1937 getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent
1938 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
1939 endhostent, endnetent, endprotoent, endservent, getsockname SOCKET,
1940 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL,
1941 goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex,
1942 import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
1943 FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST,
1944 last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length,
1945 link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR,
1946 lock THING, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map
1947 EXPR,LIST, mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget
1948 KEY,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my
1949 TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL, next, no
1950 Module VERSION LIST, no Module VERSION, no Module LIST, no Module, oct
1951 EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open
1952 FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE,MODE,REFERENCE, open FILEHANDLE,
1953 opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR TYPE, our EXPR :
1954 ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST, package NAMESPACE,
1955 package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos,
1956 print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST,
1957 printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/,
1958 qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta,
1959 rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
1960 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
1961 readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
1962 ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR,
1963 require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir
1964 DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME,
1965 rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir
1966 DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT,
1967 semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
1968 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
1969 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
1970 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
1971 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
1972 EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
1973 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
1974 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
1975 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split
1976 /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, format
1977 parameter index, flags, vector flag, (minimum) width, precision, or maximum
1978 width, size, order of arguments, sqrt EXPR, sqrt, srand EXPR, srand, stat
1979 FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub NAME BLOCK, sub NAME
1980 (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK,
1981 substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
1982 EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall NUMBER, LIST, sysopen
1983 FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
1984 FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
1985 FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite
1986 FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH,
1987 syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie
1988 VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate
1989 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR,
1990 ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack
1991 TEMPLATE,EXPR, unpack TEMPLATE, untie VARIABLE, unshift ARRAY,LIST, use
1992 Module VERSION LIST, use Module VERSION, use Module LIST, use Module, use
1993 VERSION, utime LIST, values HASH, vec EXPR,OFFSET,BITS, wait, waitpid
1994 PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y///
1995
1996 =back
1997
1998 =back
1999
2000 =head2 perlopentut - tutorial on opening things in Perl
2001
2002 =over 4
2003
2004 =item DESCRIPTION
2005
2006 =item Open E<agrave> la shell
2007
2008 =over 4
2009
2010 =item Simple Opens
2011
2012 =item Indirect Filehandles
2013
2014 =item Pipe Opens
2015
2016 =item The Minus File
2017
2018 =item Mixing Reads and Writes
2019
2020 =item Filters 
2021
2022 =back
2023
2024 =item Open E<agrave> la C
2025
2026 =over 4
2027
2028 =item Permissions E<agrave> la mode
2029
2030 =back
2031
2032 =item Obscure Open Tricks
2033
2034 =over 4
2035
2036 =item Re-Opening Files (dups)
2037
2038 =item Dispelling the Dweomer
2039
2040 =item Paths as Opens
2041
2042 =item Single Argument Open
2043
2044 =item Playing with STDIN and STDOUT
2045
2046 =back
2047
2048 =item Other I/O Issues
2049
2050 =over 4
2051
2052 =item Opening Non-File Files
2053
2054 =item Opening Named Pipes
2055
2056 =item Opening Sockets
2057
2058 =item Binary Files
2059
2060 =item File Locking
2061
2062 =item IO Layers
2063
2064 =back
2065
2066 =item SEE ALSO 
2067
2068 =item AUTHOR and COPYRIGHT
2069
2070 =item HISTORY
2071
2072 =back
2073
2074 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
2075
2076 =over 4
2077
2078 =item DESCRIPTION
2079
2080 =item The Basic Principle
2081
2082 =item Packing Text
2083
2084 =item Packing Numbers
2085
2086 =over 4
2087
2088 =item Integers
2089
2090 =item Unpacking a Stack Frame
2091
2092 =item How to Eat an Egg on a Net
2093
2094 =item Floating point Numbers
2095
2096 =back
2097
2098 =item Exotic Templates
2099
2100 =over 4
2101
2102 =item Bit Strings
2103
2104 =item Uuencoding
2105
2106 =item Doing Sums
2107
2108 =item  Unicode
2109
2110 =item Another Portable Binary Encoding
2111
2112 =back
2113
2114 =item Template Grouping
2115
2116 =item Lengths and Widths
2117
2118 =over 4
2119
2120 =item String Lengths
2121
2122 =item Dynamic Templates
2123
2124 =item Counting Repetitions
2125
2126 =back
2127
2128 =item Packing and Unpacking C Structures
2129
2130 =over 4
2131
2132 =item The Alignment Pit
2133
2134 =item Alignment, Take 2
2135
2136 =item Alignment, Take 3
2137
2138 =item Pointers for How to Use Them
2139
2140 =back
2141
2142 =item Pack Recipes
2143
2144 =item Funnies Section
2145
2146 =item Authors
2147
2148 =back
2149
2150 =head2 perlpod - the Plain Old Documentation format
2151
2152 =over 4
2153
2154 =item DESCRIPTION
2155
2156 =over 4
2157
2158 =item Ordinary Paragraph
2159
2160 =item Verbatim Paragraph
2161
2162 =item Command Paragraph
2163
2164 C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
2165 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item
2166 I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end
2167 I<formatname>>, C<=for I<formatname> I<text...>>, C<=encoding
2168 I<encodingname>>
2169
2170 =item Formatting Codes
2171
2172 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2173 C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink,
2174 C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used
2175 for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces,
2176 C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null
2177 (zero-effect) formatting code
2178
2179 =item The Intent
2180
2181 =item Embedding Pods in Perl Modules
2182
2183 =item Hints for Writing Pod
2184
2185 =back
2186
2187 =item SEE ALSO
2188
2189 =item AUTHOR
2190
2191 =back
2192
2193 =head2 perlpodspec - Plain Old Documentation: format specification and
2194 notes
2195
2196 =over 4
2197
2198 =item DESCRIPTION
2199
2200 =item Pod Definitions
2201
2202 =item Pod Commands
2203
2204 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
2205 "=back", "=begin formatname", "=end formatname", "=for formatname text...",
2206 "=encoding encodingname"
2207
2208 =item Pod Formatting Codes
2209
2210 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2211 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
2212 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
2213 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
2214 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
2215 contains non-breaking spaces
2216
2217 =item Notes on Implementing Pod Processors
2218
2219 =item About LE<lt>...E<gt> Codes
2220
2221 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
2222
2223 =item About =over...=back Regions
2224
2225 =item About Data Paragraphs and "=begin/=end" Regions
2226
2227 =item SEE ALSO
2228
2229 =item AUTHOR
2230
2231 =back
2232
2233 =head2 perlrun - how to execute the Perl interpreter
2234
2235 =over 4
2236
2237 =item SYNOPSIS
2238
2239 =item DESCRIPTION
2240
2241 =over 4
2242
2243 =item #! and quoting on non-Unix systems
2244
2245 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
2246
2247 =item Location of Perl
2248
2249 =item Command Switches
2250
2251 B<-0>[I<octal/hexadecimal>], B<-A [I<assertions>]>, B<-a>, B<-C
2252 [I<number/list>]>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>, B<-D>I<letters>,
2253 B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>, B<-h>,
2254 B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
2255 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
2256 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
2257 B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>,
2258 B<-X>, B<-x> I<directory>
2259
2260 =back
2261
2262 =item ENVIRONMENT
2263
2264 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
2265 :perlio, :pop, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
2266 PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS,
2267 PERL_DESTRUCT_LEVEL, PERL_DL_NONLAZY, PERL_ENCODING, PERL_HASH_SEED,
2268 PERL_HASH_SEED_DEBUG, PERL_ROOT (specific to the VMS port), PERL_SIGNALS,
2269 PERL_UNICODE, SYS$LOGIN (specific to the VMS port)
2270
2271 =back
2272
2273 =head2 perldiag - various Perl diagnostics
2274
2275 =over 4
2276
2277 =item DESCRIPTION
2278
2279 =back
2280
2281 =head2 perllexwarn - Perl Lexical Warnings
2282
2283 =over 4
2284
2285 =item DESCRIPTION
2286
2287 =over 4
2288
2289 =item Default Warnings and Optional Warnings
2290
2291 =item What's wrong with B<-w> and C<$^W>
2292
2293 =item Controlling Warnings from the Command Line
2294
2295 B<-w>, B<-W>, B<-X>
2296
2297 =item Backward Compatibility
2298
2299 =item Category Hierarchy
2300
2301 =item Fatal Warnings
2302
2303 =item Reporting Warnings from a Module
2304
2305 =back
2306
2307 =item TODO
2308
2309 =item SEE ALSO
2310
2311 =item AUTHOR
2312
2313 =back
2314
2315 =head2 perldebug - Perl debugging
2316
2317 =over 4
2318
2319 =item DESCRIPTION
2320
2321 =item The Perl Debugger
2322
2323 =over 4
2324
2325 =item Debugger Commands
2326
2327 h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y
2328 [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l
2329 min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/,
2330 ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b
2331 subname [condition], b postpone subname [condition], b load filename, b
2332 compile subname, B line, B *, a [line] command, A line, A *, w expr, W
2333 expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [
2334 command ], < *, << command, > ?, > command, > *, >> command, { ?, { [
2335 command ], { *, {{ command, ! number, ! -number, ! pattern, !! cmd, source
2336 file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man
2337 [manpage]
2338
2339 =item Configurable Options
2340
2341 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
2342 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
2343 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
2344 C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
2345 C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
2346 C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
2347 C<NonStop>
2348
2349 =item Debugger input/output
2350
2351 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
2352 listing
2353
2354 =item Debugging compile-time statements
2355
2356 =item Debugger Customization
2357
2358 =item Readline Support
2359
2360 =item Editor Support for Debugging
2361
2362 =item The Perl Profiler
2363
2364 =back
2365
2366 =item Debugging regular expressions
2367
2368 =item Debugging memory usage
2369
2370 =item SEE ALSO
2371
2372 =item BUGS
2373
2374 =back
2375
2376 =head2 perlvar - Perl predefined variables
2377
2378 =over 4
2379
2380 =item DESCRIPTION
2381
2382 =over 4
2383
2384 =item Predefined Names
2385
2386 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
2387 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+,
2388 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
2389 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
2390 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
2391 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
2392 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
2393 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $#,
2394 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
2395 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
2396 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
2397 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
2398 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
2399 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
2400 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
2401 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
2402 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
2403 IO::Handle->format_line_break_characters EXPR,
2404 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
2405 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
2406 $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
2407 $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
2408 $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
2409 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
2410 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
2411 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
2412 0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R,
2413 $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, ${^UNICODE},
2414 $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, $EXECUTABLE_NAME, $^X,
2415 ARGV, $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG,
2416 $SIG{expr}
2417
2418 =item Error Indicators
2419
2420 =item Technical Note on the Syntax of Variable Names
2421
2422 =back
2423
2424 =item BUGS
2425
2426 =back
2427
2428 =head2 perlre - Perl regular expressions
2429
2430 =over 4
2431
2432 =item DESCRIPTION
2433
2434 i, m, s, x
2435
2436 =over 4
2437
2438 =item Regular Expressions
2439
2440 [1], [2], [3], cntrl, graph, print, punct, xdigit
2441
2442 =item Extended Patterns
2443
2444 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
2445 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
2446 code })>, C<(??{ code })>, C<< (?>pattern) >>,
2447 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
2448
2449 =item Backtracking
2450
2451 =item Version 8 Regular Expressions
2452
2453 =item Warning on \1 vs $1
2454
2455 =item Repeated patterns matching zero-length substring
2456
2457 =item Combining pieces together
2458
2459 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
2460 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
2461 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
2462 C<(?(condition)yes-pattern|no-pattern)>
2463
2464 =item Creating custom RE engines
2465
2466 =back
2467
2468 =item BUGS
2469
2470 =item SEE ALSO
2471
2472 =back
2473
2474 =head2 perlreref - Perl Regular Expressions Reference
2475
2476 =over 4
2477
2478 =item DESCRIPTION
2479
2480 =over 4
2481
2482 =item OPERATORS
2483
2484 =item SYNTAX
2485
2486 =item ESCAPE SEQUENCES
2487
2488 =item CHARACTER CLASSES
2489
2490 =item ANCHORS
2491
2492 =item QUANTIFIERS
2493
2494 =item EXTENDED CONSTRUCTS
2495
2496 =item VARIABLES
2497
2498 =item FUNCTIONS
2499
2500 =item TERMINOLOGY
2501
2502 =back
2503
2504 =item AUTHOR
2505
2506 =item SEE ALSO
2507
2508 =item THANKS
2509
2510 =back
2511
2512 =head2 perlref - Perl references and nested data structures
2513
2514 =over 4
2515
2516 =item NOTE
2517
2518 =item DESCRIPTION
2519
2520 =over 4
2521
2522 =item Making References
2523
2524 =item Using References
2525
2526 =item Symbolic references
2527
2528 =item Not-so-symbolic references
2529
2530 =item Pseudo-hashes: Using an array as a hash
2531
2532 =item Function Templates
2533
2534 =back
2535
2536 =item WARNING
2537
2538 =item SEE ALSO
2539
2540 =back
2541
2542 =head2 perlform - Perl formats
2543
2544 =over 4
2545
2546 =item DESCRIPTION
2547
2548 =over 4
2549
2550 =item Text Fields
2551
2552 =item Numeric Fields
2553
2554 =item The Field @* for Variable Width Multi-Line Text
2555
2556 =item The Field ^* for Variable Width One-line-at-a-time Text
2557
2558 =item Specifying Values
2559
2560 =item Using Fill Mode
2561
2562 =item Suppressing Lines Where All Fields Are Void
2563
2564 =item Repeating Format Lines
2565
2566 =item Top of Form Processing
2567
2568 =item Format Variables
2569
2570 =back
2571
2572 =item NOTES
2573
2574 =over 4
2575
2576 =item Footers
2577
2578 =item Accessing Formatting Internals
2579
2580 =back
2581
2582 =item WARNINGS
2583
2584 =back
2585
2586 =head2 perlobj - Perl objects
2587
2588 =over 4
2589
2590 =item DESCRIPTION
2591
2592 =over 4
2593
2594 =item An Object is Simply a Reference
2595
2596 =item A Class is Simply a Package
2597
2598 =item A Method is Simply a Subroutine
2599
2600 =item Method Invocation
2601
2602 =item Indirect Object Syntax
2603
2604 =item Default UNIVERSAL methods
2605
2606 isa(CLASS), can(METHOD), VERSION( [NEED] )
2607
2608 =item Destructors
2609
2610 =item Summary
2611
2612 =item Two-Phased Garbage Collection
2613
2614 =back
2615
2616 =item SEE ALSO
2617
2618 =back
2619
2620 =head2 perltie - how to hide an object class in a simple variable
2621
2622 =over 4
2623
2624 =item SYNOPSIS
2625
2626 =item DESCRIPTION
2627
2628 =over 4
2629
2630 =item Tying Scalars
2631
2632 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
2633 DESTROY this
2634
2635 =item Tying Arrays
2636
2637 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
2638 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
2639 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
2640 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
2641 this
2642
2643 =item Tying Hashes
2644
2645 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
2646 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
2647 this, NEXTKEY this, lastkey, SCALAR this, UNTIE this, DESTROY this
2648
2649 =item Tying FileHandles
2650
2651 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
2652 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
2653 DESTROY this
2654
2655 =item UNTIE this
2656
2657 =item The C<untie> Gotcha
2658
2659 =back
2660
2661 =item SEE ALSO
2662
2663 =item BUGS
2664
2665 =item AUTHOR
2666
2667 =back
2668
2669 =head2 perldbmfilter - Perl DBM Filters
2670
2671 =over 4
2672
2673 =item SYNOPSIS
2674
2675 =item DESCRIPTION
2676
2677 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
2678 B<filter_fetch_value>
2679
2680 =over 4
2681
2682 =item The Filter
2683
2684 =item An Example -- the NULL termination problem.
2685
2686 =item Another Example -- Key is a C int.
2687
2688 =back
2689
2690 =item SEE ALSO
2691
2692 =item AUTHOR
2693
2694 =back
2695
2696 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
2697 safe subprocesses, sockets, and semaphores)
2698
2699 =over 4
2700
2701 =item DESCRIPTION
2702
2703 =item Signals
2704
2705 =over 4
2706
2707 =item Handling the SIGHUP Signal in Daemons
2708
2709 =back
2710
2711 =item Named Pipes
2712
2713 =over 4
2714
2715 =item Deferred Signals (Safe Signals)
2716
2717 Long running opcodes, Interrupting IO, Restartable system calls, Signals as
2718 "faults", Signals triggered by operating system state
2719
2720 =back
2721
2722 =item Using open() for IPC
2723
2724 =over 4
2725
2726 =item Filehandles
2727
2728 =item Background Processes
2729
2730 =item Complete Dissociation of Child from Parent
2731
2732 =item Safe Pipe Opens
2733
2734 =item Bidirectional Communication with Another Process
2735
2736 =item Bidirectional Communication with Yourself
2737
2738 =back
2739
2740 =item Sockets: Client/Server Communication
2741
2742 =over 4
2743
2744 =item Internet Line Terminators
2745
2746 =item Internet TCP Clients and Servers
2747
2748 =item Unix-Domain TCP Clients and Servers
2749
2750 =back
2751
2752 =item TCP Clients with IO::Socket
2753
2754 =over 4
2755
2756 =item A Simple Client
2757
2758 C<Proto>, C<PeerAddr>, C<PeerPort>
2759
2760 =item A Webget Client
2761
2762 =item Interactive Client with IO::Socket
2763
2764 =back
2765
2766 =item TCP Servers with IO::Socket
2767
2768 Proto, LocalPort, Listen, Reuse
2769
2770 =item UDP: Message Passing
2771
2772 =item SysV IPC
2773
2774 =item NOTES
2775
2776 =item BUGS
2777
2778 =item AUTHOR
2779
2780 =item SEE ALSO
2781
2782 =back
2783
2784 =head2 perlfork - Perl's fork() emulation
2785
2786 =over 4
2787
2788 =item SYNOPSIS
2789
2790 =item DESCRIPTION
2791
2792 =over 4
2793
2794 =item Behavior of other Perl features in forked pseudo-processes
2795
2796 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
2797 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
2798 files, directories and network sockets
2799
2800 =item Resource limits
2801
2802 =item Killing the parent process
2803
2804 =item Lifetime of the parent process and pseudo-processes
2805
2806 =item CAVEATS AND LIMITATIONS
2807
2808 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
2809 Global state maintained by XSUBs, Interpreter embedded in larger
2810 application, Thread-safety of extensions
2811
2812 =back
2813
2814 =item BUGS
2815
2816 =item AUTHOR
2817
2818 =item SEE ALSO
2819
2820 =back
2821
2822 =head2 perlnumber - semantics of numbers and numeric operations in Perl
2823
2824 =over 4
2825
2826 =item SYNOPSIS
2827
2828 =item DESCRIPTION
2829
2830 =item Storing numbers
2831
2832 =item Numeric operators and numeric conversions
2833
2834 =item Flavors of Perl numeric operations
2835
2836 Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other
2837 mathematical operators, Bitwise operators, Bitwise operators during C<use
2838 integer>, Operators which expect an integer, Operators which expect a
2839 string
2840
2841 =item AUTHOR
2842
2843 =item SEE ALSO
2844
2845 =back
2846
2847 =head2 perlthrtut - tutorial on threads in Perl
2848
2849 =over 4
2850
2851 =item DESCRIPTION
2852
2853 =item Status
2854
2855 =item What Is A Thread Anyway?
2856
2857 =item Threaded Program Models
2858
2859 =over 4
2860
2861 =item Boss/Worker
2862
2863 =item Work Crew
2864
2865 =item Pipeline
2866
2867 =back
2868
2869 =item What kind of threads are Perl threads?
2870
2871 =item Thread-Safe Modules
2872
2873 =item Thread Basics
2874
2875 =over 4
2876
2877 =item Basic Thread Support
2878
2879 =item A Note about the Examples
2880
2881 =item Creating Threads
2882
2883 =item Waiting For A Thread To Exit
2884
2885 =item Ignoring A Thread
2886
2887 =back
2888
2889 =item Threads And Data
2890
2891 =over 4
2892
2893 =item Shared And Unshared Data
2894
2895 =item Thread Pitfalls: Races
2896
2897 =back
2898
2899 =item Synchronization and control
2900
2901 =over 4
2902
2903 =item Controlling access: lock()
2904
2905 =item A Thread Pitfall: Deadlocks
2906
2907 =item Queues: Passing Data Around
2908
2909 =item Semaphores: Synchronizing Data Access
2910
2911 =item Basic semaphores
2912
2913 =item Advanced Semaphores
2914
2915 =item cond_wait() and cond_signal()
2916
2917 =item Giving up control
2918
2919 =back
2920
2921 =item General Thread Utility Routines
2922
2923 =over 4
2924
2925 =item What Thread Am I In?
2926
2927 =item Thread IDs
2928
2929 =item Are These Threads The Same?
2930
2931 =item What Threads Are Running?
2932
2933 =back
2934
2935 =item A Complete Example
2936
2937 =item Different implementations of threads
2938
2939 =item Performance considerations
2940
2941 =item Process-scope Changes
2942
2943 =item Thread-Safety of System Libraries
2944
2945 =item Conclusion
2946
2947 =item Bibliography
2948
2949 =over 4
2950
2951 =item Introductory Texts
2952
2953 =item OS-Related References
2954
2955 =item Other References
2956
2957 =back
2958
2959 =item Acknowledgements
2960
2961 =item AUTHOR
2962
2963 =item Copyrights
2964
2965 =back
2966
2967 =head2 perlothrtut - old tutorial on threads in Perl
2968
2969 =over 4
2970
2971 =item DESCRIPTION
2972
2973 =item What Is A Thread Anyway?
2974
2975 =item Threaded Program Models
2976
2977 =over 4
2978
2979 =item Boss/Worker
2980
2981 =item Work Crew
2982
2983 =item Pipeline
2984
2985 =back
2986
2987 =item Native threads
2988
2989 =item What kind of threads are perl threads?
2990
2991 =item Threadsafe Modules
2992
2993 =item Thread Basics
2994
2995 =over 4
2996
2997 =item Basic Thread Support
2998
2999 =item Creating Threads
3000
3001 =item Giving up control
3002
3003 =item Waiting For A Thread To Exit
3004
3005 =item Errors In Threads
3006
3007 =item Ignoring A Thread
3008
3009 =back
3010
3011 =item Threads And Data
3012
3013 =over 4
3014
3015 =item Shared And Unshared Data
3016
3017 =item Thread Pitfall: Races
3018
3019 =item Controlling access: lock()
3020
3021 =item Thread Pitfall: Deadlocks
3022
3023 =item Queues: Passing Data Around
3024
3025 =back
3026
3027 =item Threads And Code
3028
3029 =over 4
3030
3031 =item Semaphores: Synchronizing Data Access
3032
3033 Basic semaphores, Advanced Semaphores
3034
3035 =item Attributes: Restricting Access To Subroutines
3036
3037 =item Subroutine Locks
3038
3039 =item Methods
3040
3041 =item Locking A Subroutine
3042
3043 =back
3044
3045 =item General Thread Utility Routines
3046
3047 =over 4
3048
3049 =item What Thread Am I In?
3050
3051 =item Thread IDs
3052
3053 =item Are These Threads The Same?
3054
3055 =item What Threads Are Running?
3056
3057 =back
3058
3059 =item A Complete Example
3060
3061 =item Conclusion
3062
3063 =item Bibliography
3064
3065 =over 4
3066
3067 =item Introductory Texts
3068
3069 =item OS-Related References
3070
3071 =item Other References
3072
3073 =back
3074
3075 =item Acknowledgements
3076
3077 =item AUTHOR
3078
3079 =item Copyrights
3080
3081 =back
3082
3083 =head2 perlport - Writing portable Perl
3084
3085 =over 4
3086
3087 =item DESCRIPTION
3088
3089 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
3090 portable
3091
3092 =item ISSUES
3093
3094 =over 4
3095
3096 =item Newlines
3097
3098 =item Numbers endianness and Width
3099
3100 =item Files and Filesystems
3101
3102 =item System Interaction
3103
3104 =item Command names versus file pathnames
3105
3106 =item Networking
3107
3108 =item Interprocess Communication (IPC)
3109
3110 =item External Subroutines (XS)
3111
3112 =item Standard Modules
3113
3114 =item Time and Date
3115
3116 =item Character sets and character encoding
3117
3118 =item Internationalisation
3119
3120 =item System Resources
3121
3122 =item Security
3123
3124 =item Style
3125
3126 =back
3127
3128 =item CPAN Testers
3129
3130 Mailing list: cpan-testers@perl.org, Testing results:
3131 http://testers.cpan.org/
3132
3133 =item PLATFORMS
3134
3135 =over 4
3136
3137 =item Unix
3138
3139 =item DOS and Derivatives
3140
3141 =item S<Mac OS>
3142
3143 =item VMS
3144
3145 =item VOS
3146
3147 =item EBCDIC Platforms
3148
3149 =item Acorn RISC OS
3150
3151 =item Other perls
3152
3153 =back
3154
3155 =item FUNCTION IMPLEMENTATIONS
3156
3157 =over 4
3158
3159 =item Alphabetical Listing of Perl Functions
3160
3161 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, binmode FILEHANDLE, chmod LIST, chown
3162 LIST, chroot FILENAME, chroot, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen
3163 HASH,DBNAME,MODE, dump LABEL, exec LIST, exit EXPR, exit, fcntl
3164 FILEHANDLE,FUNCTION,SCALAR, flock FILEHANDLE,OPERATION, fork, getlogin,
3165 getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME,
3166 getnetbyname NAME, getpwuid UID, getgrgid GID, getnetbyaddr ADDR,ADDRTYPE,
3167 getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, getgrent,
3168 gethostbyname, gethostent, getnetent, getprotoent, getservent, sethostent
3169 STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN,
3170 endpwent, endgrent, endhostent, endnetent, endprotoent, endservent,
3171 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl
3172 FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat
3173 FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd
3174 ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open
3175 FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select
3176 RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
3177 KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
3178 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
3179 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
3180 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
3181 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
3182 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
3183 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
3184 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
3185 wait, waitpid PID,FLAGS
3186
3187 =back
3188
3189 =item CHANGES
3190
3191 v1.49, 12 August 2002, v1.48, 02 February 2001, v1.47, 22 March 2000,
3192 v1.46, 12 February 2000, v1.45, 20 December 1999, v1.44, 19 July 1999,
3193 v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May 1999, v1.40, 11 April
3194 1999, v1.39, 11 February 1999, v1.38, 31 December 1998, v1.37, 19 December
3195 1998, v1.36, 9 September 1998, v1.35, 13 August 1998, v1.33, 06 August
3196 1998, v1.32, 05 August 1998, v1.30, 03 August 1998, v1.23, 10 July 1998
3197
3198 =item Supported Platforms
3199
3200 =item SEE ALSO
3201
3202 =item AUTHORS / CONTRIBUTORS
3203
3204 =back
3205
3206 =head2 perllocale - Perl locale handling (internationalization and
3207 localization)
3208
3209 =over 4
3210
3211 =item DESCRIPTION
3212
3213 =item PREPARING TO USE LOCALES
3214
3215 =item USING LOCALES
3216
3217 =over 4
3218
3219 =item The use locale pragma
3220
3221 =item The setlocale function
3222
3223 =item Finding locales
3224
3225 =item LOCALE PROBLEMS
3226
3227 =item Temporarily fixing locale problems
3228
3229 =item Permanently fixing locale problems
3230
3231 =item Permanently fixing your system's locale configuration
3232
3233 =item Fixing system locale configuration
3234
3235 =item The localeconv function
3236
3237 =item I18N::Langinfo
3238
3239 =back
3240
3241 =item LOCALE CATEGORIES
3242
3243 =over 4
3244
3245 =item Category LC_COLLATE: Collation
3246
3247 =item Category LC_CTYPE: Character Types
3248
3249 =item Category LC_NUMERIC: Numeric Formatting
3250
3251 =item Category LC_MONETARY: Formatting of monetary amounts
3252
3253 =item LC_TIME
3254
3255 =item Other categories
3256
3257 =back
3258
3259 =item SECURITY
3260
3261 =item ENVIRONMENT
3262
3263 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
3264 LC_NUMERIC, LC_TIME, LANG
3265
3266 =item NOTES
3267
3268 =over 4
3269
3270 =item Backward compatibility
3271
3272 =item I18N:Collate obsolete
3273
3274 =item Sort speed and memory use impacts
3275
3276 =item write() and LC_NUMERIC
3277
3278 =item Freely available locale definitions
3279
3280 =item I18n and l10n
3281
3282 =item An imperfect standard
3283
3284 =back
3285
3286 =item Unicode and UTF-8
3287
3288 =item BUGS
3289
3290 =over 4
3291
3292 =item Broken systems
3293
3294 =back
3295
3296 =item SEE ALSO
3297
3298 =item HISTORY
3299
3300 =back
3301
3302 =head2 perluniintro - Perl Unicode introduction
3303
3304 =over 4
3305
3306 =item DESCRIPTION
3307
3308 =over 4
3309
3310 =item Unicode
3311
3312 =item Perl's Unicode Support
3313
3314 =item Perl's Unicode Model
3315
3316 =item Unicode and EBCDIC
3317
3318 =item Creating Unicode
3319
3320 =item Handling Unicode
3321
3322 =item Legacy Encodings
3323
3324 =item Unicode I/O
3325
3326 =item Displaying Unicode As Text
3327
3328 =item Special Cases
3329
3330 =item Advanced Topics
3331
3332 =item Miscellaneous
3333
3334 =item Questions With Answers
3335
3336 =item Hexadecimal Notation
3337
3338 =item Further Resources
3339
3340 =back
3341
3342 =item UNICODE IN OLDER PERLS
3343
3344 =item SEE ALSO
3345
3346 =item ACKNOWLEDGMENTS
3347
3348 =item AUTHOR, COPYRIGHT, AND LICENSE
3349
3350 =back
3351
3352 =head2 perlunicode - Unicode support in Perl
3353
3354 =over 4
3355
3356 =item DESCRIPTION
3357
3358 =over 4
3359
3360 =item Important Caveats
3361
3362 Input and Output Layers, Regular Expressions, C<use utf8> still needed to
3363 enable UTF-8/UTF-EBCDIC in scripts, C<use encoding> needed to upgrade
3364 non-Latin-1 byte strings
3365
3366 =item Byte and Character Semantics
3367
3368 =item Effects of Character Semantics
3369
3370 =item Scripts
3371
3372 =item Blocks
3373
3374 =item User-Defined Character Properties
3375
3376 =item Character Encodings for Input and Output
3377
3378 =item Unicode Regular Expression Support Level
3379
3380 =item Unicode Encodings
3381
3382 =item Security Implications of Unicode
3383
3384 =item Unicode in Perl on EBCDIC
3385
3386 =item Locales
3387
3388 =item When Unicode Does Not Happen
3389
3390 =item Forcing Unicode in Perl (Or Unforcing Unicode in Perl)
3391
3392 =item Using Unicode in XS
3393
3394 =back
3395
3396 =item BUGS
3397
3398 =over 4
3399
3400 =item Interaction with Locales
3401
3402 =item Interaction with Extensions
3403
3404 =item Speed
3405
3406 =item Porting code from perl-5.6.X
3407
3408 =back
3409
3410 =item SEE ALSO
3411
3412 =back
3413
3414 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
3415
3416 =over 4
3417
3418 =item DESCRIPTION
3419
3420 =item COMMON CHARACTER CODE SETS
3421
3422 =over 4
3423
3424 =item ASCII
3425
3426 =item ISO 8859
3427
3428 =item Latin 1 (ISO 8859-1)
3429
3430 =item EBCDIC
3431
3432 =item 13 variant characters
3433
3434 =item 0037
3435
3436 =item 1047
3437
3438 =item POSIX-BC
3439
3440 =item Unicode code points versus EBCDIC code points
3441
3442 =item Remaining Perl Unicode problems in EBCDIC
3443
3444 =item Unicode and UTF
3445
3446 =item Using Encode
3447
3448 =back
3449
3450 =item SINGLE OCTET TABLES
3451
3452 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
3453
3454 =item IDENTIFYING CHARACTER CODE SETS
3455
3456 =item CONVERSIONS
3457
3458 =over 4
3459
3460 =item tr///
3461
3462 =item iconv
3463
3464 =item C RTL
3465
3466 =back
3467
3468 =item OPERATOR DIFFERENCES
3469
3470 =item FUNCTION DIFFERENCES
3471
3472 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
3473
3474 =item REGULAR EXPRESSION DIFFERENCES
3475
3476 =item SOCKETS
3477
3478 =item SORTING
3479
3480 =over 4
3481
3482 =item Ignore ASCII vs. EBCDIC sort differences.
3483
3484 =item MONO CASE then sort data.
3485
3486 =item Convert, sort data, then re convert.
3487
3488 =item Perform sorting on one type of machine only.
3489
3490 =back
3491
3492 =item TRANSFORMATION FORMATS
3493
3494 =over 4
3495
3496 =item URL decoding and encoding
3497
3498 =item uu encoding and decoding
3499
3500 =item Quoted-Printable encoding and decoding
3501
3502 =item Caesarian ciphers
3503
3504 =back
3505
3506 =item Hashing order and checksums
3507
3508 =item I18N AND L10N
3509
3510 =item MULTI OCTET CHARACTER SETS
3511
3512 =item OS ISSUES
3513
3514 =over 4
3515
3516 =item OS/400
3517
3518 PASE, IFS access
3519
3520 =item OS/390, z/OS
3521
3522 chcp, dataset access, OS/390, z/OS iconv, locales
3523
3524 =item VM/ESA?
3525
3526 =item POSIX-BC?
3527
3528 =back
3529
3530 =item BUGS
3531
3532 =item SEE ALSO
3533
3534 =item REFERENCES
3535
3536 =item HISTORY
3537
3538 =item AUTHOR
3539
3540 =back
3541
3542 =head2 perlsec - Perl security
3543
3544 =over 4
3545
3546 =item DESCRIPTION
3547
3548 =over 4
3549
3550 =item Laundering and Detecting Tainted Data
3551
3552 =item Switches On the "#!" Line
3553
3554 =item Taint mode and @INC
3555
3556 =item Cleaning Up Your Path
3557
3558 =item Security Bugs
3559
3560 =item Protecting Your Programs
3561
3562 =item Unicode
3563
3564 =item Algorithmic Complexity Attacks
3565
3566 =back
3567
3568 =item SEE ALSO
3569
3570 =back
3571
3572 =head2 perlmod - Perl modules (packages and symbol tables)
3573
3574 =over 4
3575
3576 =item DESCRIPTION
3577
3578 =over 4
3579
3580 =item Packages
3581
3582 =item Symbol Tables
3583
3584 =item BEGIN, CHECK, INIT and END
3585
3586 =item Perl Classes
3587
3588 =item Perl Modules
3589
3590 =item Making your module threadsafe
3591
3592 =back
3593
3594 =item SEE ALSO
3595
3596 =back
3597
3598 =head2 perlmodlib - constructing new Perl modules and finding existing ones
3599
3600 =over 4
3601
3602 =item THE PERL MODULE LIBRARY
3603
3604 =over 4
3605
3606 =item Pragmatic Modules
3607
3608 assertions, assertions::activate, attributes, attrs, autouse, base, bigint,
3609 bignum, bigrat, blib, bytes, charnames, constant, diagnostics, encoding,
3610 fields, filetest, if, integer, less, lib, locale, open, ops, overload, re,
3611 sigtrap, sort, strict, subs, threads, threads::shared, utf8, vars, version,
3612 vmsish, warnings, warnings::register
3613
3614 =item Standard Modules
3615
3616 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
3617 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
3618 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
3619 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
3620 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
3621 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
3622 Class::Struct, Config, Cwd, DB, DBM_Filter, DB_File, Data::Dumper,
3623 Devel::DProf, Devel::PPPort, Devel::Peek, Devel::SelfStubber, Digest,
3624 Digest::MD5, Digest::base, DirHandle, Dumpvalue, DynaLoader, Encode,
3625 Encode::Alias, Encode::Byte, Encode::CJKConstants, Encode::CN,
3626 Encode::CN::HZ, Encode::Config, Encode::EBCDIC, Encode::Encoder,
3627 Encode::Encoding, Encode::Guess, Encode::JP, Encode::JP::H2Z,
3628 Encode::JP::JIS7, Encode::KR, Encode::KR::2022_KR, Encode::MIME::Header,
3629 Encode::PerlIO, Encode::Supported, Encode::Symbol, Encode::TW,
3630 Encode::Unicode, Encode::Unicode::UTF7, English, Env, Errno, Exporter,
3631 Exporter::Heavy, ExtUtils::Command, ExtUtils::Command::MM,
3632 ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install,
3633 ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_Any,
3634 ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS,
3635 ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_UWIN,
3636 ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
3637 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker,
3638 ExtUtils::MakeMaker::FAQ, ExtUtils::MakeMaker::Tutorial,
3639 ExtUtils::MakeMaker::bytes, ExtUtils::MakeMaker::vmsish,
3640 ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists,
3641 ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename,
3642 File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find,
3643 File::Glob, File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc,
3644 File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix,
3645 File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache,
3646 FileHandle, Filter::Simple, Filter::Util::Call, FindBin, GDBM_File,
3647 Getopt::Long, Getopt::Std, Hash::Util, I18N::Collate, I18N::LangTags,
3648 I18N::LangTags::List, I18N::Langinfo, IO, IO::Dir, IO::File, IO::Handle,
3649 IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET,
3650 IO::Socket::UNIX, IPC::Open2, IPC::Open3, IPC::SysV, IPC::SysV::Msg,
3651 IPC::SysV::Semaphore, List::Util, Locale::Constants, Locale::Country,
3652 Locale::Currency, Locale::Language, Locale::Maketext,
3653 Locale::Maketext::TPJ13, Locale::Script, MIME::Base64,
3654 MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt,
3655 Math::BigInt::Calc, Math::BigInt::CalcEmu, Math::BigRat, Math::Complex,
3656 Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire,
3657 Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File,
3658 Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT, Net::Cmd,
3659 Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3,
3660 Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent,
3661 Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO,
3662 PerlIO::encoding, PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint,
3663 Pod::Checker, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects,
3664 Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser,
3665 Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff,
3666 Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText,
3667 Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer,
3668 Pod::Select, Pod::Text, Pod::Text::Color, Pod::Text::Overstrike,
3669 Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Scalar::Util,
3670 Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch,
3671 Symbol, Sys::Hostname, Sys::Syslog, Term::ANSIColor, Term::Cap,
3672 Term::Complete, Term::ReadLine, Test, Test::Builder, Test::Harness,
3673 Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Straps,
3674 Test::More, Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced,
3675 Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Thread,
3676 Thread::Queue, Thread::Semaphore, Thread::Signal, Thread::Specific,
3677 Tie::Array, Tie::File, Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash,
3678 Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::gmtime,
3679 Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate, Unicode::Normalize,
3680 Unicode::UCD, User::grent, User::pwent, Win32, XS::APItest, XS::Typemap,
3681 XSLoader
3682
3683 =item Extension Modules
3684
3685 =back
3686
3687 =item CPAN
3688
3689 =over 4
3690
3691 =item Africa
3692
3693 South Africa
3694
3695 =item Asia
3696
3697 China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi
3698 Arabia, Singapore, South Korea, Taiwan, Thailand
3699
3700 =item Central America
3701
3702 Costa Rica
3703
3704 =item Europe
3705
3706 Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Czech
3707 Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary,
3708 Iceland, Ireland, Italy, Latvia, Lithuania, Netherlands, Norway, Poland,
3709 Portugal, Romania, Russia, Slovakia, Slovenia, Spain, Sweden, Switzerland,
3710 Turkey, Ukraine, United Kingdom
3711
3712 =item North America
3713
3714 Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States,
3715 Alabama, California, Colorado, Delaware, District of Columbia, Florida,
3716 Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey, New York,
3717 North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, Utah,
3718 Virginia, Washington, Wisconsin
3719
3720 =item Oceania
3721
3722 Australia, New Zealand, United States
3723
3724 =item South America
3725
3726 Argentina, Brazil, Chile
3727
3728 =item RSYNC Mirrors
3729
3730 =back
3731
3732 =item Modules: Creation, Use, and Abuse
3733
3734 =over 4
3735
3736 =item Guidelines for Module Creation
3737
3738 =item Guidelines for Converting Perl 4 Library Scripts into Modules
3739
3740 =item Guidelines for Reusing Application Code
3741
3742 =back
3743
3744 =item NOTE
3745
3746 =back
3747
3748 =head2 perlmodstyle - Perl module style guide
3749
3750 =over 4
3751
3752 =item INTRODUCTION
3753
3754 =item QUICK CHECKLIST
3755
3756 =over 4
3757
3758 =item Before you start
3759
3760 =item The API
3761
3762 =item Stability
3763
3764 =item Documentation
3765
3766 =item Release considerations
3767
3768 =back
3769
3770 =item BEFORE YOU START WRITING A MODULE
3771
3772 =over 4
3773
3774 =item Has it been done before?
3775
3776 =item Do one thing and do it well
3777
3778 =item What's in a name?
3779
3780 =back
3781
3782 =item DESIGNING AND WRITING YOUR MODULE
3783
3784 =over 4
3785
3786 =item To OO or not to OO?
3787
3788 =item Designing your API
3789
3790 Write simple routines to do simple things, Separate functionality from
3791 output, Provide sensible shortcuts and defaults, Naming conventions,
3792 Parameter passing
3793
3794 =item Strictness and warnings
3795
3796 =item Backwards compatibility
3797
3798 =item Error handling and messages
3799
3800 =back
3801
3802 =item DOCUMENTING YOUR MODULE
3803
3804 =over 4
3805
3806 =item POD
3807
3808 =item README, INSTALL, release notes, changelogs
3809
3810 perl Makefile.PL, make, make test, make install, perl Build.PL, perl Build,
3811 perl Build test, perl Build install
3812
3813 =back
3814
3815 =item RELEASE CONSIDERATIONS
3816
3817 =over 4
3818
3819 =item Version numbering
3820
3821 =item Pre-requisites
3822
3823 =item Testing
3824
3825 =item Packaging
3826
3827 =item Licensing
3828
3829 =back
3830
3831 =item COMMON PITFALLS
3832
3833 =over 4
3834
3835 =item Reinventing the wheel
3836
3837 =item Trying to do too much
3838
3839 =item Inappropriate documentation
3840
3841 =back
3842
3843 =item SEE ALSO
3844
3845 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Packaging Tools,
3846 Testing tools, http://pause.perl.org/, Any good book on software
3847 engineering
3848
3849 =item AUTHOR
3850
3851 =back
3852
3853 =head2 perlmodinstall - Installing CPAN Modules
3854
3855 =over 4
3856
3857 =item DESCRIPTION
3858
3859 =over 4
3860
3861 =item PREAMBLE
3862
3863 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
3864 module (sometimes unnecessary), B<INSTALL> the module
3865
3866 =back
3867
3868 =item PORTABILITY
3869
3870 =item HEY
3871
3872 =item AUTHOR
3873
3874 =item COPYRIGHT
3875
3876 =back
3877
3878 =head2 perlnewmod - preparing a new module for distribution
3879
3880 =over 4
3881
3882 =item DESCRIPTION
3883
3884 =over 4
3885
3886 =item Warning
3887
3888 =item What should I make into a module?
3889
3890 =item Step-by-step: Preparing the ground
3891
3892 Look around, Check it's new, Discuss the need, Choose a name, Check again
3893
3894 =item Step-by-step: Making the module
3895
3896 Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
3897 L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
3898 documentation|perlpod>, Write tests, Write the README
3899
3900 =item Step-by-step: Distributing your module
3901
3902 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
3903 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
3904
3905 =back
3906
3907 =item AUTHOR
3908
3909 =item SEE ALSO
3910
3911 =back
3912
3913 =head2 perlutil - utilities packaged with the Perl distribution
3914
3915 =over 4
3916
3917 =item DESCRIPTION
3918
3919 =over 4
3920
3921 =item DOCUMENTATION
3922
3923 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
3924 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
3925 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
3926 L<roffitall|roffitall>
3927
3928 =item CONVERTORS
3929
3930 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
3931
3932 =item Administration
3933
3934 L<libnetcfg|libnetcfg>
3935
3936 =item Development
3937
3938 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
3939 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
3940
3941 =item SEE ALSO
3942
3943 =back
3944
3945 =back
3946
3947 =head2 perlcompile - Introduction to the Perl Compiler-Translator 
3948
3949 =over 4
3950
3951 =item DESCRIPTION
3952
3953 =over 4
3954
3955 =item Layout
3956
3957 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3958
3959 =back
3960
3961 =item Using The Back Ends
3962
3963 =over 4
3964
3965 =item The Cross Referencing Back End
3966
3967 i, &, s, r
3968
3969 =item The Decompiling Back End
3970
3971 =item The Lint Back End
3972
3973 =item The Simple C Back End
3974
3975 =item The Bytecode Back End
3976
3977 =item The Optimized C Back End
3978
3979 =back
3980
3981 =item Module List for the Compiler Suite
3982
3983 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3984 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
3985 B::Stackobj, B::Stash, B::Terse, B::Xref
3986
3987 =item KNOWN PROBLEMS
3988
3989 =item AUTHOR
3990
3991 =back
3992
3993 =head2 perlfilter - Source Filters
3994
3995 =over 4
3996
3997 =item DESCRIPTION
3998
3999 =item CONCEPTS
4000
4001 =item USING FILTERS
4002
4003 =item WRITING A SOURCE FILTER
4004
4005 =item WRITING A SOURCE FILTER IN C
4006
4007 B<Decryption Filters>
4008
4009 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4010
4011 =item WRITING A SOURCE FILTER IN PERL
4012
4013 =item USING CONTEXT: THE DEBUG FILTER
4014
4015 =item CONCLUSION
4016
4017 =item THINGS TO LOOK OUT FOR
4018
4019 Some Filters Clobber the C<DATA> Handle
4020
4021 =item REQUIREMENTS
4022
4023 =item AUTHOR
4024
4025 =item Copyrights
4026
4027 =back
4028
4029 =head2 perlembed - how to embed perl in your C program
4030
4031 =over 4
4032
4033 =item DESCRIPTION
4034
4035 =over 4
4036
4037 =item PREAMBLE
4038
4039 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
4040 Perl?>, B<Use C from C?>, B<Use Perl from C?>
4041
4042 =item ROADMAP
4043
4044 =item Compiling your C program
4045
4046 =item Adding a Perl interpreter to your C program
4047
4048 =item Calling a Perl subroutine from your C program
4049
4050 =item Evaluating a Perl statement from your C program
4051
4052 =item Performing Perl pattern matches and substitutions from your C program
4053
4054 =item Fiddling with the Perl stack from your C program
4055
4056 =item Maintaining a persistent interpreter
4057
4058 =item Execution of END blocks
4059
4060 =item Maintaining multiple interpreter instances
4061
4062 =item Using Perl modules, which themselves use C libraries, from your C
4063 program
4064
4065 =back
4066
4067 =item Embedding Perl under Win32
4068
4069 =item Hiding Perl_
4070
4071 =item MORAL
4072
4073 =item AUTHOR
4074
4075 =item COPYRIGHT
4076
4077 =back
4078
4079 =head2 perldebguts - Guts of Perl debugging 
4080
4081 =over 4
4082
4083 =item DESCRIPTION
4084
4085 =item Debugger Internals
4086
4087 =over 4
4088
4089 =item Writing Your Own Debugger
4090
4091 =back
4092
4093 =item Frame Listing Output Examples
4094
4095 =item Debugging regular expressions
4096
4097 =over 4
4098
4099 =item Compile-time output
4100
4101 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
4102 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
4103 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
4104 C<anchored(TYPE)>
4105
4106 =item Types of nodes
4107
4108 =item Run-time output
4109
4110 =back
4111
4112 =item Debugging Perl memory usage
4113
4114 =over 4
4115
4116 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
4117
4118 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
4119 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
4120 6144>
4121
4122 =item Example of using B<-DL> switch
4123
4124 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
4125
4126 =item B<-DL> details
4127
4128 C<!!!>, C<!!>, C<!>
4129
4130 =item Limitations of B<-DL> statistics
4131
4132 =back
4133
4134 =item SEE ALSO
4135
4136 =back
4137
4138 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
4139
4140 =over 4
4141
4142 =item DESCRIPTION
4143
4144 =item SPECIAL NOTES
4145
4146 =over 4
4147
4148 =item make
4149
4150 =item Version caveat
4151
4152 =item Dynamic Loading versus Static Loading
4153
4154 =back
4155
4156 =item TUTORIAL
4157
4158 =over 4
4159
4160 =item EXAMPLE 1
4161
4162 =item EXAMPLE 2
4163
4164 =item What has gone on?
4165
4166 =item Writing good test scripts
4167
4168 =item EXAMPLE 3
4169
4170 =item What's new here?
4171
4172 =item Input and Output Parameters
4173
4174 =item The XSUBPP Program
4175
4176 =item The TYPEMAP file
4177
4178 =item Warning about Output Arguments
4179
4180 =item EXAMPLE 4
4181
4182 =item What has happened here?
4183
4184 =item Anatomy of .xs file
4185
4186 =item Getting the fat out of XSUBs
4187
4188 =item More about XSUB arguments
4189
4190 =item The Argument Stack
4191
4192 =item Extending your Extension
4193
4194 =item Documenting your Extension
4195
4196 =item Installing your Extension
4197
4198 =item EXAMPLE 5
4199
4200 =item New Things in this Example
4201
4202 =item EXAMPLE 6
4203
4204 =item New Things in this Example
4205
4206 =item EXAMPLE 7 (Coming Soon)
4207
4208 =item EXAMPLE 8 (Coming Soon)
4209
4210 =item EXAMPLE 9 Passing open files to XSes
4211
4212 =item Troubleshooting these Examples
4213
4214 =back
4215
4216 =item See also
4217
4218 =item Author
4219
4220 =over 4
4221
4222 =item Last Changed
4223
4224 =back
4225
4226 =back
4227
4228 =head2 perlxs - XS language reference manual
4229
4230 =over 4
4231
4232 =item DESCRIPTION
4233
4234 =over 4
4235
4236 =item Introduction
4237
4238 =item On The Road
4239
4240 =item The Anatomy of an XSUB
4241
4242 =item The Argument Stack
4243
4244 =item The RETVAL Variable
4245
4246 =item Returning SVs, AVs and HVs through RETVAL
4247
4248 =item The MODULE Keyword
4249
4250 =item The PACKAGE Keyword
4251
4252 =item The PREFIX Keyword
4253
4254 =item The OUTPUT: Keyword
4255
4256 =item The NO_OUTPUT Keyword
4257
4258 =item The CODE: Keyword
4259
4260 =item The INIT: Keyword
4261
4262 =item The NO_INIT Keyword
4263
4264 =item Initializing Function Parameters
4265
4266 =item Default Parameter Values
4267
4268 =item The PREINIT: Keyword
4269
4270 =item The SCOPE: Keyword
4271
4272 =item The INPUT: Keyword
4273
4274 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
4275
4276 =item The C<length(NAME)> Keyword
4277
4278 =item Variable-length Parameter Lists
4279
4280 =item The C_ARGS: Keyword
4281
4282 =item The PPCODE: Keyword
4283
4284 =item Returning Undef And Empty Lists
4285
4286 =item The REQUIRE: Keyword
4287
4288 =item The CLEANUP: Keyword
4289
4290 =item The POSTCALL: Keyword
4291
4292 =item The BOOT: Keyword
4293
4294 =item The VERSIONCHECK: Keyword
4295
4296 =item The PROTOTYPES: Keyword
4297
4298 =item The PROTOTYPE: Keyword
4299
4300 =item The ALIAS: Keyword
4301
4302 =item The OVERLOAD: Keyword
4303
4304 =item The FALLBACK: Keyword
4305
4306 =item The INTERFACE: Keyword
4307
4308 =item The INTERFACE_MACRO: Keyword
4309
4310 =item The INCLUDE: Keyword
4311
4312 =item The CASE: Keyword
4313
4314 =item The & Unary Operator
4315
4316 =item Inserting POD, Comments and C Preprocessor Directives
4317
4318 =item Using XS With C++
4319
4320 =item Interface Strategy
4321
4322 =item Perl Objects And C Structures
4323
4324 =item The Typemap
4325
4326 =item Safely Storing Static Data in XS
4327
4328 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4329
4330 =back
4331
4332 =item EXAMPLES
4333
4334 =item XS VERSION
4335
4336 =item AUTHOR
4337
4338 =back
4339
4340 =head2 perlclib - Internal replacements for standard C library functions
4341
4342 =over 4
4343
4344 =item DESCRIPTION
4345
4346 =over 4
4347
4348 =item Conventions
4349
4350 C<t>, C<p>, C<n>, C<s>
4351
4352 =item File Operations
4353
4354 =item File Input and Output
4355
4356 =item File Positioning
4357
4358 =item Memory Management and String Handling
4359
4360 =item Character Class Tests
4361
4362 =item F<stdlib.h> functions
4363
4364 =item Miscellaneous functions
4365
4366 =back
4367
4368 =item SEE ALSO
4369
4370 =back
4371
4372 =head2 perlguts - Introduction to the Perl API
4373
4374 =over 4
4375
4376 =item DESCRIPTION
4377
4378 =item Variables
4379
4380 =over 4
4381
4382 =item Datatypes
4383
4384 =item What is an "IV"?
4385
4386 =item Working with SVs
4387
4388 =item Offsets
4389
4390 =item What's Really Stored in an SV?
4391
4392 =item Working with AVs
4393
4394 =item Working with HVs
4395
4396 =item Hash API Extensions
4397
4398 =item AVs, HVs and undefined values
4399
4400 =item References
4401
4402 =item Blessed References and Class Objects
4403
4404 =item Creating New Variables
4405
4406 GV_ADDMULTI, GV_ADDWARN
4407
4408 =item Reference Counts and Mortality
4409
4410 =item Stashes and Globs
4411
4412 =item Double-Typed SVs
4413
4414 =item Magic Variables
4415
4416 =item Assigning Magic
4417
4418 =item Magic Virtual Tables
4419
4420 =item Finding Magic
4421
4422 =item Understanding the Magic of Tied Hashes and Arrays
4423
4424 =item Localizing changes
4425
4426 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
4427 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
4428 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
4429 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
4430 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
4431 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
4432 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
4433 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
4434 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
4435 save_hptr(HV **hptr)>
4436
4437 =back
4438
4439 =item Subroutines
4440
4441 =over 4
4442
4443 =item XSUBs and the Argument Stack
4444
4445 =item Calling Perl Routines from within C Programs
4446
4447 =item Memory Allocation
4448
4449 =item PerlIO
4450
4451 =item Putting a C value on Perl stack
4452
4453 =item Scratchpads
4454
4455 =item Scratchpads and recursion
4456
4457 =back
4458
4459 =item Compiled code
4460
4461 =over 4
4462
4463 =item Code tree
4464
4465 =item Examining the tree
4466
4467 =item Compile pass 1: check routines
4468
4469 =item Compile pass 1a: constant folding
4470
4471 =item Compile pass 2: context propagation
4472
4473 =item Compile pass 3: peephole optimization
4474
4475 =item Pluggable runops
4476
4477 =back
4478
4479 =item Examining internal data structures with the C<dump> functions
4480
4481 =item How multiple interpreters and concurrency are supported
4482
4483 =over 4
4484
4485 =item Background and PERL_IMPLICIT_CONTEXT
4486
4487 =item So what happened to dTHR?
4488
4489 =item How do I use all this in extensions?
4490
4491 =item Should I do anything special if I call perl from multiple threads?
4492
4493 =item Future Plans and PERL_IMPLICIT_SYS
4494
4495 =back
4496
4497 =item Internal Functions
4498
4499 A, p, d, s, n, r, f, M, o, x, m, X, E, b
4500
4501 =over 4
4502
4503 =item Formatted Printing of IVs, UVs, and NVs
4504
4505 =item Pointer-To-Integer and Integer-To-Pointer
4506
4507 =item Source Documentation
4508
4509 =back
4510
4511 =item Unicode Support
4512
4513 =over 4
4514
4515 =item What B<is> Unicode, anyway?
4516
4517 =item How can I recognise a UTF-8 string?
4518
4519 =item How does UTF-8 represent Unicode characters?
4520
4521 =item How does Perl store UTF-8 strings?
4522
4523 =item How do I convert a string to UTF-8?
4524
4525 =item Is there anything else I need to know?
4526
4527 =back
4528
4529 =item Custom Operators
4530
4531 =item AUTHORS
4532
4533 =item SEE ALSO
4534
4535 =back
4536
4537 =head2 perlcall - Perl calling conventions from C
4538
4539 =over 4
4540
4541 =item DESCRIPTION
4542
4543 An Error Handler, An Event Driven Program
4544
4545 =item THE CALL_ FUNCTIONS
4546
4547 call_sv, call_pv, call_method, call_argv
4548
4549 =item FLAG VALUES
4550
4551 =over 4
4552
4553 =item  G_VOID
4554
4555 =item  G_SCALAR
4556
4557 =item G_ARRAY
4558
4559 =item G_DISCARD
4560
4561 =item G_NOARGS
4562
4563 =item G_EVAL
4564
4565 =item G_KEEPERR
4566
4567 =item Determining the Context
4568
4569 =back
4570
4571 =item KNOWN PROBLEMS
4572
4573 =item EXAMPLES
4574
4575 =over 4
4576
4577 =item No Parameters, Nothing returned
4578
4579 =item Passing Parameters
4580
4581 =item Returning a Scalar
4582
4583 =item Returning a list of values
4584
4585 =item Returning a list in a scalar context
4586
4587 =item Returning Data from Perl via the parameter list
4588
4589 =item Using G_EVAL
4590
4591 =item Using G_KEEPERR
4592
4593 =item Using call_sv
4594
4595 =item Using call_argv
4596
4597 =item Using call_method
4598
4599 =item Using GIMME_V
4600
4601 =item Using Perl to dispose of temporaries
4602
4603 =item Strategies for storing Callback Context Information
4604
4605 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
4606 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
4607 callback
4608
4609 =item Alternate Stack Manipulation
4610
4611 =item Creating and calling an anonymous subroutine in C
4612
4613 =back
4614
4615 =item SEE ALSO
4616
4617 =item AUTHOR
4618
4619 =item DATE
4620
4621 =back
4622
4623 =head2 perlapi - autogenerated documentation for the perl public API
4624
4625 =over 4
4626
4627 =item DESCRIPTION
4628
4629 =item "Gimme" Values
4630
4631 GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
4632
4633 =item Array Manipulation Functions
4634
4635 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4636 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4637 get_av, newAV, Nullav, sortsv
4638
4639 =item Callback Functions
4640
4641 call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
4642 FREETMPS, LEAVE, SAVETMPS
4643
4644 =item Character classes
4645
4646 isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
4647
4648 =item Cloning an interpreter
4649
4650 perl_clone
4651
4652 =item CV Manipulation Functions
4653
4654 CvSTASH, get_cv, Nullcv
4655
4656 =item Embedding Functions
4657
4658 cv_undef, load_module, nothreadhook, perl_alloc, perl_construct,
4659 perl_destruct, perl_free, perl_parse, perl_run, require_pv
4660
4661 =item Functions in file pp_pack.c
4662
4663 packlist, pack_cat, unpackstring, unpack_str
4664
4665 =item Global Variables
4666
4667 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
4668
4669 =item GV Functions
4670
4671 GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
4672 gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
4673
4674 =item Handy Values
4675
4676 HEf_SVKEY, Nullch, Nullsv
4677
4678 =item Hash Manipulation Functions
4679
4680 get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set,
4681 HeVAL, HvNAME, hv_assert, hv_clear, hv_clear_placeholders, hv_delete,
4682 hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
4683 hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv,
4684 hv_iternext_flags, hv_iterval, hv_magic, hv_scalar, hv_store, hv_store_ent,
4685 hv_undef, newHV, Nullhv
4686
4687 =item Magical Functions
4688
4689 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
4690 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
4691 SvSetSV, SvSetSV_nosteal, SvSHARE
4692
4693 =item Memory Management
4694
4695 Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree,
4696 savepv, savepvn, savesharedpv, StructCopy, Zero
4697
4698 =item Miscellaneous Functions
4699
4700 fbm_compile, fbm_instr, form, getcwd_sv, new_version, scan_version, strEQ,
4701 strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_nolocking,
4702 sv_nosharing, sv_nounlocking, upg_version, vcmp, vnumify, vstringify
4703
4704 =item Numeric functions
4705
4706 grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
4707 scan_hex, scan_oct
4708
4709 =item Optree Manipulation Functions
4710
4711 cv_const_sv, newCONSTSUB, newXS
4712
4713 =item Pad Data Structures
4714
4715 pad_sv
4716
4717 =item Stack Manipulation Macros
4718
4719 dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp,
4720 POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
4721 PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN,
4722 XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
4723 XSRETURN_UV, XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF,
4724 XST_mYES
4725
4726 =item SV Flags
4727
4728 svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
4729
4730 =item SV Manipulation Functions
4731
4732 get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
4733 newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
4734 SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off,
4735 SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIsCOW,
4736 SvIsCOW_shared_hash, SvIV, SvIVx, SvIVX, SvIV_nomg, SvLEN, SvNIOK, SvNIOKp,
4737 SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX,
4738 SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only,
4739 SvPOK_only_UTF8, SvPV, SvPVbyte, SvPVbytex, SvPVbytex_force,
4740 SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, SvPVutf8x, SvPVutf8x_force,
4741 SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX, SvPV_force, SvPV_force_nomg,
4742 SvPV_nolen, SvPV_nomg, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK,
4743 SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off,
4744 SvTAINTED_on, SvTRUE, SvTYPE, SvUNLOCK, SvUOK, SvUPGRADE, SvUTF8,
4745 SvUTF8_off, SvUTF8_on, SvUV, SvUVX, SvUVx, SvUV_nomg, SvVOK, sv_2bool,
4746 sv_2cv, sv_2io, sv_2iv_flags, sv_2mortal, sv_2nv, sv_2pvbyte,
4747 sv_2pvbyte_nolen, sv_2pvutf8, sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen,
4748 sv_2uv_flags, sv_backoff, sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg,
4749 sv_catpvn, sv_catpvn_flags, sv_catpvn_mg, sv_catpv_mg, sv_catsv,
4750 sv_catsv_flags, sv_catsv_mg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale,
4751 sv_collxfrm, sv_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal,
4752 sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, sv_insert,
4753 sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, sv_magicext,
4754 sv_mortalcopy, sv_newmortal, sv_newref, sv_nv, sv_pos_b2u, sv_pos_u2b,
4755 sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force,
4756 sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype,
4757 sv_replace, sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg,
4758 sv_setnv, sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv,
4759 sv_setpviv_mg, sv_setpvn, sv_setpvn_mg, sv_setpv_mg, sv_setref_iv,
4760 sv_setref_nv, sv_setref_pv, sv_setref_pvn, sv_setref_uv, sv_setsv,
4761 sv_setsv_flags, sv_setsv_mg, sv_setuv, sv_setuv_mg, sv_taint, sv_tainted,
4762 sv_true, sv_unmagic, sv_unref, sv_unref_flags, sv_untaint, sv_upgrade,
4763 sv_usepvn, sv_usepvn_mg, sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode,
4764 sv_utf8_upgrade, sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn
4765
4766 =item Unicode Support
4767
4768 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
4769 is_utf8_string_loc, pv_uni_display, sv_cat_decode, sv_recode_to_utf8,
4770 sv_uni_display, to_utf8_case, to_utf8_fold, to_utf8_lower, to_utf8_title,
4771 to_utf8_upper, utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop,
4772 utf8_length, utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8,
4773 uvuni_to_utf8_flags
4774
4775 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
4776
4777 ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST,
4778 THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK
4779
4780 =item Warning and Dieing
4781
4782 croak, warn
4783
4784 =item AUTHORS
4785
4786 =item SEE ALSO
4787
4788 =back
4789
4790 =head2 perlintern - autogenerated documentation of purely B<internal>
4791                  Perl functions
4792
4793 =over 4
4794
4795 =item DESCRIPTION
4796
4797 =item CV reference counts and CvOUTSIDE
4798
4799 CvWEAKOUTSIDE
4800
4801 =item Functions in file pad.h
4802
4803 CX_CURPAD_SAVE, CX_CURPAD_SV, PAD_BASE_SV, PAD_CLONE_VARS,
4804 PAD_COMPNAME_FLAGS, PAD_COMPNAME_GEN, PAD_COMPNAME_OURSTASH,
4805 PAD_COMPNAME_PV, PAD_COMPNAME_TYPE, PAD_DUP, PAD_RESTORE_LOCAL,
4806 PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV, PAD_SET_CUR,
4807 PAD_SET_CUR_NOSAVE, PAD_SV, PAD_SVl, SAVECLEARSV, SAVECOMPPAD, SAVEPADSV
4808
4809 =item Functions in file pp_ctl.c
4810
4811 find_runcv
4812
4813 =item Global Variables
4814
4815 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
4816 PL_rs
4817
4818 =item GV Functions
4819
4820 is_gv_magical
4821
4822 =item IO Functions
4823
4824 start_glob
4825
4826 =item Pad Data Structures
4827
4828 CvPADLIST, cv_clone, cv_dump, do_dump_pad, intro_my, pad_add_anon,
4829 pad_add_name, pad_alloc, pad_block_start, pad_check_dup, pad_findlex,
4830 pad_findmy, pad_fixup_inner_anons, pad_free, pad_leavemy, pad_new,
4831 pad_push, pad_reset, pad_setsv, pad_swipe, pad_tidy, pad_undef
4832
4833 =item Stack Manipulation Macros
4834
4835 djSP, LVRET
4836
4837 =item SV Manipulation Functions
4838
4839 report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
4840
4841 =item AUTHORS
4842
4843 =item SEE ALSO
4844
4845 =back
4846
4847 =head2 perliol - C API for Perl's implementation of IO in Layers.
4848
4849 =over 4
4850
4851 =item SYNOPSIS
4852
4853 =item DESCRIPTION
4854
4855 =over 4
4856
4857 =item History and Background
4858
4859 =item Basic Structure
4860
4861 =item Layers vs Disciplines
4862
4863 =item Data Structures
4864
4865 =item Functions and Attributes
4866
4867 =item Per-instance Data
4868
4869 =item Layers in action.
4870
4871 =item Per-instance flag bits
4872
4873 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4874 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4875 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4876 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4877
4878 =item Methods in Detail
4879
4880 fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF,
4881 PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode,
4882 Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof,
4883 Error,  Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
4884 Set_ptrcnt
4885
4886 =item Utilities
4887
4888 =item Implementing PerlIO Layers
4889
4890 C implementations, Perl implementations
4891
4892 =item Core Layers
4893
4894 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4895
4896 =item Extension Layers
4897
4898 ":encoding", ":scalar", ":via"
4899
4900 =back
4901
4902 =item TODO
4903
4904 =back
4905
4906 =head2 perlapio - perl's IO abstraction interface.
4907
4908 =over 4
4909
4910 =item SYNOPSIS
4911
4912 =item DESCRIPTION
4913
4914 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4915 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4916 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4917 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4918 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4919 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4920 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4921 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4922 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4923 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4924 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4925
4926 =over 4
4927
4928 =item Co-existence with stdio
4929
4930 B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
4931 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
4932
4933 =item "Fast gets" Functions
4934
4935 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4936 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4937 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4938 B<PerlIO_get_bufsiz(f)>
4939
4940 =item Other Functions
4941
4942 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4943 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4944
4945 =back
4946
4947 =back
4948
4949 =head2 perlhack - How to hack at the Perl internals
4950
4951 =over 4
4952
4953 =item DESCRIPTION
4954
4955 Does concept match the general goals of Perl?, Where is the
4956 implementation?, Backwards compatibility, Could it be a module instead?, Is
4957 the feature generic enough?, Does it potentially introduce new bugs?, Does
4958 it preclude other desirable features?, Is the implementation robust?, Is
4959 the implementation generic enough to be portable?, Is the implementation
4960 tested?, Is there enough documentation?, Is there another way to do it?,
4961 Does it create too much work?, Patches speak louder than words
4962
4963 =over 4
4964
4965 =item Keeping in sync
4966
4967 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
4968 NFS, rsync'ing the patches
4969
4970 =item Why rsync the source tree
4971
4972 It's easier to rsync the source tree, It's more reliable
4973
4974 =item Why rsync the patches
4975
4976 It's easier to rsync the patches, It's a good reference, Finding a start
4977 point, Finding how to fix a bug, Finding the source of misbehaviour
4978
4979 =item Perlbug administration
4980
4981 =item Submitting patches
4982
4983 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
4984 F<Porting/pumpkin.pod>, The perl5-porters FAQ
4985
4986 =item Finding Your Way Around
4987
4988 Core modules, Tests, Documentation, Configure, Interpreter
4989
4990 =item Elements of the interpreter
4991
4992 Startup, Parsing, Optimization, Running
4993
4994 =item Internal Variable Types
4995
4996 =item Op Trees
4997
4998 =item Stacks
4999
5000 Argument stack, Mark stack, Save stack
5001
5002 =item Millions of Macros
5003
5004 =item The .i Targets
5005
5006 =item Poking at Perl
5007
5008 =item Using a source-level debugger
5009
5010 run [args], break function_name, break source.c:xxx, step, next, continue,
5011 finish, 'enter', print
5012
5013 =item gdb macro support
5014
5015 =item Dumping Perl Data Structures
5016
5017 =item Patching
5018
5019 =item Patching a core module
5020
5021 =item Adding a new function to the core
5022
5023 =item Writing a test
5024
5025 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5026 F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base t/comp,
5027 t/cmd t/run t/io t/op, t/lib ext lib
5028
5029 =item Special Make Test Targets
5030
5031 coretest, test.deparse, test.taintwarn, minitest, test.valgrind
5032 check.valgrind utest.valgrind ucheck.valgrind, test.third check.third
5033 utest.third ucheck.third, test.torture torturetest, utest ucheck test.utf8
5034 check.utf8, test_harness
5035
5036 =item Running tests by hand
5037
5038 PERL_CORE=1, PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST
5039
5040 =back
5041
5042 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5043
5044 =over 4
5045
5046 =item Rational Software's Purify
5047
5048 =item Purify on Unix
5049
5050 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5051
5052 =item Purify on NT
5053
5054 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5055
5056 =item valgrind
5057
5058 =item Compaq's/Digital's/HP's Third Degree
5059
5060 =item PERL_DESTRUCT_LEVEL
5061
5062 =item Profiling
5063
5064 =item Gprof Profiling
5065
5066 -a, -b, -e routine, -f routine, -s, -z
5067
5068 =item GCC gcov Profiling
5069
5070 =item Pixie Profiling
5071
5072 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5073 -z[ero]
5074
5075 =item Miscellaneous tricks
5076
5077 =item CONCLUSION
5078
5079 I<The Road goes ever on and on, down from the door where it began.>
5080
5081 =back
5082
5083 =item AUTHOR
5084
5085 =back
5086
5087 =head2 perlbook - Perl book information
5088
5089 =over 4
5090
5091 =item DESCRIPTION
5092
5093 =back
5094
5095 =head2 perltodo - Perl TO-DO List
5096
5097 =over 4
5098
5099 =item DESCRIPTION
5100
5101 =item To do during 5.6.x
5102
5103 =over 4
5104
5105 =item Support for I/O disciplines
5106
5107 =item Autoload bytes.pm
5108
5109 =item Make "\u{XXXX}" et al work
5110
5111 =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
5112
5113 =item Overloadable regex assertions
5114
5115 =item Unicode
5116
5117 =item Work out exit/die semantics for threads
5118
5119 =item Better support for nonpreemptive threading systems like GNU pth
5120
5121 =item Typed lexicals for compiler
5122
5123 =item Compiler workarounds for Win32
5124
5125 =item AUTOLOADing in the compiler
5126
5127 =item Fixing comppadlist when compiling
5128
5129 =item Cleaning up exported namespace
5130
5131 =item Complete signal handling
5132
5133 =item Out-of-source builds
5134
5135 =item POSIX realtime support
5136
5137 =item UNIX98 support
5138
5139 =item IPv6 Support
5140
5141 =item Long double conversion
5142
5143 =item Locales
5144
5145 =item Arithmetic on non-Arabic numerals
5146
5147 =item POSIX Unicode character classes
5148
5149 =item Factoring out common suffices/prefices in regexps (trie optimization)
5150
5151 =item Security audit shipped utilities
5152
5153 =item Sort out the uid-setting mess
5154
5155 =item Custom opcodes
5156
5157 =item DLL Versioning
5158
5159 =item Introduce @( and @)
5160
5161 =item Floating point handling
5162
5163 =item IV/UV preservation
5164
5165 =item Replace pod2html with something using Pod::Parser
5166
5167 =item Automate module testing on CPAN
5168
5169 =item sendmsg and recvmsg
5170
5171 =item Rewrite perlre documentation
5172
5173 =item Convert example code to IO::Handle filehandles
5174
5175 =item Document Win32 choices
5176
5177 =item Check new modules
5178
5179 =item Make roffitall find pods and libs itself
5180
5181 =back
5182
5183 =item To do at some point
5184
5185 =over 4
5186
5187 =item Remove regular expression recursion
5188
5189 =item Memory leaks after failed eval
5190
5191 =item bitfields in pack
5192
5193 =item Cross compilation
5194
5195 =item Perl preprocessor / macros
5196
5197 =item Perl lexer in Perl
5198
5199 =item Using POSIX calls internally
5200
5201 =item -i rename file when changed
5202
5203 =item All ARGV input should act like E<lt>E<gt>
5204
5205 =item Support for rerunning debugger
5206
5207 =item Test Suite for the Debugger
5208
5209 =item my sub foo { }
5210
5211 =item One-pass global destruction
5212
5213 =item Rewrite regexp parser
5214
5215 =item Cache recently used regexps
5216
5217 =item Cross-compilation support
5218
5219 =item Bit-shifting bitvectors
5220
5221 =item debugger pragma
5222
5223 =item use less pragma
5224
5225 =item switch structures
5226
5227 =item Cache eval tree
5228
5229 =item rcatmaybe
5230
5231 =item Shrink opcode tables
5232
5233 =item Optimize away @_
5234
5235 =item Prototypes versus indirect objects
5236
5237 =item Install HTML
5238
5239 =item Prototype method calls
5240
5241 =item Return context prototype declarations
5242
5243 =item magic_setisa
5244
5245 =item Garbage collection
5246
5247 =item IO tutorial
5248
5249 =item Rewrite perldoc
5250
5251 =item Install .3p manpages
5252
5253 =item Unicode tutorial
5254
5255 =item Update POSIX.pm for 1003.1-2
5256
5257 =item Retargetable installation
5258
5259 =item POSIX emulation on non-POSIX systems
5260
5261 =item Rename Win32 headers
5262
5263 =item Finish off lvalue functions
5264
5265 =item Update sprintf documentation
5266
5267 =item Use fchown/fchmod internally
5268
5269 =item Make v-strings overloaded objects
5270
5271 =item Allow restricted hash assignment
5272
5273 =item Should overload be inheritable?
5274
5275 =item Taint rethink
5276
5277 =item Perform correctly when XSUBs call subroutines that exit via
5278 goto(LABEL) and friends
5279
5280 =back
5281
5282 =item Vague ideas
5283
5284 =over 4
5285
5286 =item ref() in list context
5287
5288 =item Make tr/// return histogram of characters in list context
5289
5290 =item Compile to real threaded code
5291
5292 =item Structured types
5293
5294 =item Modifiable $1 et al.
5295
5296 =item Procedural interfaces for IO::*, etc.
5297
5298 =item RPC modules
5299
5300 =item Attach/detach debugger from running program
5301
5302 =item GUI::Native
5303
5304 =item foreach(reverse ...)
5305
5306 =item Constant function cache
5307
5308 =item Approximate regular expression matching
5309
5310 =back
5311
5312 =item Ongoing
5313
5314 =over 4
5315
5316 =item Update guts documentation
5317
5318 =item Add more tests
5319
5320 =item Update auxiliary tools
5321
5322 =item Create debugging macros
5323
5324 =item truncate to the people
5325
5326 =item Unicode in Filenames
5327
5328 =back
5329
5330 =item Unicode in %ENV
5331
5332 =item Recently done things
5333
5334 =over 4
5335
5336 =item Alternative RE syntax module
5337
5338 =item Safe signal handling
5339
5340 =item Tie Modules
5341
5342 =item gettimeofday
5343
5344 =item setitimer and getimiter
5345
5346 =item Testing __DIE__ hook
5347
5348 =item CPP equivalent in Perl
5349
5350 =item Explicit switch statements
5351
5352 =item autocroak
5353
5354 =item UTF/EBCDIC
5355
5356 =item UTF Regexes
5357
5358 =item perlcc to produce executable
5359
5360 =item END blocks saved in compiled output
5361
5362 =item Secure temporary file module
5363
5364 =item Integrate Time::HiRes
5365
5366 =item Turn Cwd into XS
5367
5368 =item Mmap for input
5369
5370 =item Byte to/from UTF-8 and UTF-8 to/from local conversion
5371
5372 =item Add sockatmark support
5373
5374 =item Mailing list archives
5375
5376 =item Bug tracking
5377
5378 =item Integrate MacPerl
5379
5380 =item Web "nerve center" for Perl
5381
5382 =item Regular expression tutorial
5383
5384 =item Debugging Tutorial
5385
5386 =item Integrate new modules
5387
5388 =item Integrate profiler
5389
5390 =item Y2K error detection
5391
5392 =item Regular expression debugger
5393
5394 =item POD checker
5395
5396 =item "Dynamic" lexicals
5397
5398 =item Cache precompiled modules
5399
5400 =back
5401
5402 =item Deprecated Wishes
5403
5404 =over 4
5405
5406 =item Loop control on do{}
5407
5408 =item Lexically scoped typeglobs
5409
5410 =item format BOTTOM
5411
5412 =item report HANDLE
5413
5414 =item Generalised want()/caller())
5415
5416 =item Named prototypes
5417
5418 =item Built-in globbing
5419
5420 =item Regression tests for suidperl
5421
5422 =item Cached hash values
5423
5424 =item Add compression modules
5425
5426 =item Reorganise documentation into tutorials/references
5427
5428 =item Remove distinction between functions and operators
5429
5430 =item Make XS easier to use
5431
5432 =item Make embedding easier to use
5433
5434 =item man for perl
5435
5436 =item my $Package::variable
5437
5438 =item "or" tests defined, not truth
5439
5440 =item "class"-based lexicals
5441
5442 =item byteperl
5443
5444 =item Lazy evaluation / tail recursion removal
5445
5446 =item Make "use utf8" the default
5447
5448 =item Unicode collation and normalization
5449
5450 =item pack/unpack tutorial
5451
5452 =back
5453
5454 =back
5455
5456 =head2 perldoc - Look up Perl documentation in Pod format.
5457
5458 =over 4
5459
5460 =item SYNOPSIS
5461
5462 =item DESCRIPTION
5463
5464 =item OPTIONS
5465
5466 B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
5467 I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
5468 I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
5469 B<-w> I<option:value> or B<-w> I<option>, B<-X>,
5470 B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
5471 B<-V>
5472
5473 =item SECURITY
5474
5475 =item ENVIRONMENT
5476
5477 =item AUTHOR
5478
5479 =back
5480
5481 =head2 perlhist - the Perl history records
5482
5483 =over 4
5484
5485 =item DESCRIPTION
5486
5487 =item INTRODUCTION
5488
5489 =item THE KEEPERS OF THE PUMPKIN
5490
5491 =over 4
5492
5493 =item PUMPKIN?
5494
5495 =back
5496
5497 =item THE RECORDS
5498
5499 =over 4
5500
5501 =item SELECTED RELEASE SIZES
5502
5503 =item SELECTED PATCH SIZES
5504
5505 =back
5506
5507 =item THE KEEPERS OF THE RECORDS
5508
5509 =back
5510
5511 =head2 perldelta - what is new for perl v5.9.1
5512
5513 =over 4
5514
5515 =item DESCRIPTION
5516
5517 =item Incompatible Changes
5518
5519 =over 4
5520
5521 =item substr() lvalues are no longer fixed-length
5522
5523 =item The C<:unique> attribute is only meaningful for globals
5524
5525 =back
5526
5527 =item Core Enhancements
5528
5529 =over 4
5530
5531 =item Lexical C<$_>
5532
5533 =item Tied hashes in scalar context
5534
5535 =item Formats
5536
5537 =item Stacked filetest operators
5538
5539 =back
5540
5541 =item Modules and Pragmata
5542
5543 Benchmark, Carp, Exporter, FindBin, List::Util, threads::shared
5544
5545 =item Utility Changes
5546
5547 =item Documentation
5548
5549 =item Performance Enhancements
5550
5551 =item Selected Bug Fixes
5552
5553 =over 4
5554
5555 =item UTF-8 bugs
5556
5557 =item Threading bugs
5558
5559 =item More bugs
5560
5561 =back
5562
5563 =item New or Changed Diagnostics
5564
5565 =item Changed Internals
5566
5567 =over 4
5568
5569 =item Reordering of SVt_* constants
5570
5571 =item Removal of CPP symbols
5572
5573 =item Less space is used by ops
5574
5575 =item New parser
5576
5577 =back
5578
5579 =item Configuration and Building
5580
5581 =item Known Problems
5582
5583 =over 4
5584
5585 =item Platform Specific Problems
5586
5587 =back
5588
5589 =item To-do for perl 5.10.0
5590
5591 =item Reporting Bugs
5592
5593 =item SEE ALSO
5594
5595 =back
5596
5597 =head2 perl592delta, perldelta - what is new for perl v5.9.2
5598
5599 =over 4
5600
5601 =item DESCRIPTION
5602
5603 =item Incompatible Changes
5604
5605 =item Core Enhancements
5606
5607 =item Modules and Pragmata
5608
5609 =item Utility Changes
5610
5611 =item Documentation
5612
5613 =item Performance Enhancements
5614
5615 =item Installation and Configuration Improvements
5616
5617 =item Selected Bug Fixes
5618
5619 =item New or Changed Diagnostics
5620
5621 =item Changed Internals
5622
5623 =item Known Problems
5624
5625 =over 4
5626
5627 =item Platform Specific Problems
5628
5629 =back
5630
5631 =item Reporting Bugs
5632
5633 =item SEE ALSO
5634
5635 =back
5636
5637 =head2 perl591delta, perldelta - what is new for perl v5.9.1
5638
5639 =over 4
5640
5641 =item DESCRIPTION
5642
5643 =item Incompatible Changes
5644
5645 =over 4
5646
5647 =item substr() lvalues are no longer fixed-length
5648
5649 =item The C<:unique> attribute is only meaningful for globals
5650
5651 =back
5652
5653 =item Core Enhancements
5654
5655 =over 4
5656
5657 =item Lexical C<$_>
5658
5659 =item Tied hashes in scalar context
5660
5661 =item Formats
5662
5663 =item Stacked filetest operators
5664
5665 =back
5666
5667 =item Modules and Pragmata
5668
5669 Benchmark, Carp, Exporter, FindBin, List::Util, threads::shared
5670
5671 =item Utility Changes
5672
5673 =item Documentation
5674
5675 =item Performance Enhancements
5676
5677 =item Selected Bug Fixes
5678
5679 =over 4
5680
5681 =item UTF-8 bugs
5682
5683 =item Threading bugs
5684
5685 =item More bugs
5686
5687 =back
5688
5689 =item New or Changed Diagnostics
5690
5691 =item Changed Internals
5692
5693 =over 4
5694
5695 =item Reordering of SVt_* constants
5696
5697 =item Removal of CPP symbols
5698
5699 =item Less space is used by ops
5700
5701 =item New parser
5702
5703 =back
5704
5705 =item Configuration and Building
5706
5707 =item Known Problems
5708
5709 =over 4
5710
5711 =item Platform Specific Problems
5712
5713 =back
5714
5715 =item To-do for perl 5.10.0
5716
5717 =item Reporting Bugs
5718
5719 =item SEE ALSO
5720
5721 =back
5722
5723 =head2 perl590delta, perldelta - what is new for perl v5.9.0
5724
5725 =over 4
5726
5727 =item DESCRIPTION
5728
5729 =item Incompatible Changes
5730
5731 =over 4
5732
5733 =item Hash Randomisation
5734
5735 =item UTF-8 On Filehandles No Longer Activated By Locale
5736
5737 =item Single-number v-strings are no longer v-strings before "=>"
5738
5739 =item (Win32) The -C Switch Has Been Repurposed
5740
5741 =item (Win32) The /d Switch Of cmd.exe
5742
5743 =item The C<$*> variable has been removed
5744
5745 =back
5746
5747 =item Core Enhancements
5748
5749 =over 4
5750
5751 =item Assertions
5752
5753 =item Defined-or operators
5754
5755 =item UTF-8 no longer default under UTF-8 locales
5756
5757 =item Unsafe signals again available
5758
5759 =item Tied Arrays with Negative Array Indices
5760
5761 =item local ${$x}
5762
5763 =item Unicode Character Database 4.0.0
5764
5765 =item Miscellaneous Enhancements
5766
5767 =back
5768
5769 =item Modules and Pragmata
5770
5771 =over 4
5772
5773 =item Updated Modules And Pragmata
5774
5775 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
5776 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
5777 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
5778 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
5779 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
5780 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
5781 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
5782 Win32::GetOSVersion
5783
5784 =back
5785
5786 =item Utility Changes
5787
5788 =item New Documentation
5789
5790 =item Performance Enhancements
5791
5792 =item Installation and Configuration Improvements
5793
5794 =over 4
5795
5796 =item Platform-specific enhancements
5797
5798 =back
5799
5800 =item Selected Bug Fixes
5801
5802 =over 4
5803
5804 =item Closures, eval and lexicals
5805
5806 =item Generic fixes
5807
5808 =item Platform-specific fixes
5809
5810 =back
5811
5812 =item New or Changed Diagnostics
5813
5814 =over 4
5815
5816 =item Changed "A thread exited while %d threads were running"
5817
5818 =item Removed "Attempt to clear a restricted hash"
5819
5820 =item New "Illegal declaration of anonymous subroutine"
5821
5822 =item Changed "Invalid range "%s" in transliteration operator"
5823
5824 =item New "Missing control char name in \c"
5825
5826 =item New "Newline in left-justified string for %s"
5827
5828 =item New "Possible precedence problem on bitwise %c operator"
5829
5830 =item New "read() on %s filehandle %s"
5831
5832 =item New "Tied variable freed while still in use"
5833
5834 =item New "To%s: illegal mapping '%s'"
5835
5836 =item New "Use of freed value in iteration"
5837
5838 =back
5839
5840 =item Changed Internals
5841
5842 =item New Tests
5843
5844 =item Known Problems
5845
5846 =over 4
5847
5848 =item Tied hashes in scalar context
5849
5850 =item Net::Ping 450_service and 510_ping_udp failures
5851
5852 =item B::C
5853
5854 =back
5855
5856 =item Platform Specific Problems
5857
5858 =over 4
5859
5860 =item EBCDIC Platforms
5861
5862 =item Cygwin 1.5 problems
5863
5864 =item HP-UX: HP cc warnings about sendfile and sendpath
5865
5866 =item IRIX: t/uni/tr_7jis.t falsely failing
5867
5868 =item Mac OS X: no usemymalloc
5869
5870 =item Tru64: No threaded builds with GNU cc (gcc)
5871
5872 =item Win32: sysopen, sysread, syswrite
5873
5874 =back
5875
5876 =item TODO
5877
5878 =item Reporting Bugs
5879
5880 =item SEE ALSO
5881
5882 =back
5883
5884 =head2 perl583delta - what is new for perl v5.8.3
5885
5886 =over 4
5887
5888 =item DESCRIPTION
5889
5890 =item Incompatible Changes
5891
5892 =item Core Enhancements
5893
5894 =item Modules and Pragmata
5895
5896 CGI, Cwd, Digest, Digest::MD5, Encode, File::Spec, FindBin, List::Util,
5897 Math::BigInt, PodParser, Pod::Perldoc, POSIX, Unicode::Collate,
5898 Unicode::Normalize, Test::Harness, threads::shared
5899
5900 =item Utility Changes
5901
5902 =item New Documentation
5903
5904 =item Installation and Configuration Improvements
5905
5906 =item Selected Bug Fixes
5907
5908 =item New or Changed Diagnostics
5909
5910 =item Changed Internals
5911
5912 =item Configuration and Building
5913
5914 =item Platform Specific Problems
5915
5916 =item Known Problems
5917
5918 =item Future Directions
5919
5920 =item Obituary
5921
5922 =item Reporting Bugs
5923
5924 =item SEE ALSO
5925
5926 =back
5927
5928 =head2 perl582delta - what is new for perl v5.8.2
5929
5930 =over 4
5931
5932 =item DESCRIPTION
5933
5934 =item Incompatible Changes
5935
5936 =item Core Enhancements
5937
5938 =over 4
5939
5940 =item Hash Randomisation
5941
5942 =item Threading
5943
5944 =back
5945
5946 =item Modules and Pragmata
5947
5948 =over 4
5949
5950 =item Updated Modules And Pragmata
5951
5952 Devel::PPPort, Digest::MD5, I18N::LangTags, libnet, MIME::Base64,
5953 Pod::Perldoc, strict, Tie::Hash, Time::HiRes, Unicode::Collate,
5954 Unicode::Normalize, UNIVERSAL
5955
5956 =back
5957
5958 =item Selected Bug Fixes
5959
5960 =item Changed Internals
5961
5962 =item Platform Specific Problems
5963
5964 =item Future Directions
5965
5966 =item Reporting Bugs
5967
5968 =item SEE ALSO
5969
5970 =back
5971
5972 =head2 perl581delta - what is new for perl v5.8.1
5973
5974 =over 4
5975
5976 =item DESCRIPTION
5977
5978 =item Incompatible Changes
5979
5980 =over 4
5981
5982 =item Hash Randomisation
5983
5984 =item UTF-8 On Filehandles No Longer Activated By Locale
5985
5986 =item Single-number v-strings are no longer v-strings before "=>"
5987
5988 =item (Win32) The -C Switch Has Been Repurposed
5989
5990 =item (Win32) The /d Switch Of cmd.exe
5991
5992 =back
5993
5994 =item Core Enhancements
5995
5996 =over 4
5997
5998 =item UTF-8 no longer default under UTF-8 locales
5999
6000 =item Unsafe signals again available
6001
6002 =item Tied Arrays with Negative Array Indices
6003
6004 =item local ${$x}
6005
6006 =item Unicode Character Database 4.0.0
6007
6008 =item Deprecation Warnings
6009
6010 =item Miscellaneous Enhancements
6011
6012 =back
6013
6014 =item Modules and Pragmata
6015
6016 =over 4
6017
6018 =item Updated Modules And Pragmata
6019
6020 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
6021 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
6022 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
6023 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
6024 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
6025 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
6026 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
6027 Win32::GetOSVersion
6028
6029 =back
6030
6031 =item Utility Changes
6032
6033 =item New Documentation
6034
6035 =item Installation and Configuration Improvements
6036
6037 =over 4
6038
6039 =item Platform-specific enhancements
6040
6041 =back
6042
6043 =item Selected Bug Fixes
6044
6045 =over 4
6046
6047 =item Closures, eval and lexicals
6048
6049 =item Generic fixes
6050
6051 =item Platform-specific fixes
6052
6053 =back
6054
6055 =item New or Changed Diagnostics
6056
6057 =over 4
6058
6059 =item Changed "A thread exited while %d threads were running"
6060
6061 =item Removed "Attempt to clear a restricted hash"
6062
6063 =item New "Illegal declaration of anonymous subroutine"
6064
6065 =item Changed "Invalid range "%s" in transliteration operator"
6066
6067 =item New "Missing control char name in \c"
6068
6069 =item New "Newline in left-justified string for %s"
6070
6071 =item New "Possible precedence problem on bitwise %c operator"
6072
6073 =item New "Pseudo-hashes are deprecated"
6074
6075 =item New "read() on %s filehandle %s"
6076
6077 =item New "5.005 threads are deprecated"
6078
6079 =item New "Tied variable freed while still in use"
6080
6081 =item New "To%s: illegal mapping '%s'"
6082
6083 =item New "Use of freed value in iteration"
6084
6085 =back
6086
6087 =item Changed Internals
6088
6089 =item New Tests
6090
6091 =item Known Problems
6092
6093 =over 4
6094
6095 =item Tied hashes in scalar context
6096
6097 =item Net::Ping 450_service and 510_ping_udp failures
6098
6099 =item B::C
6100
6101 =back
6102
6103 =item Platform Specific Problems
6104
6105 =over 4
6106
6107 =item EBCDIC Platforms
6108
6109 =item Cygwin 1.5 problems
6110
6111 =item HP-UX: HP cc warnings about sendfile and sendpath
6112
6113 =item IRIX: t/uni/tr_7jis.t falsely failing
6114
6115 =item Mac OS X: no usemymalloc
6116
6117 =item Tru64: No threaded builds with GNU cc (gcc)
6118
6119 =item Win32: sysopen, sysread, syswrite
6120
6121 =back
6122
6123 =item Future Directions
6124
6125 =item Reporting Bugs
6126
6127 =item SEE ALSO
6128
6129 =back
6130
6131 =head2 perl58delta - what is new for perl v5.8.0
6132
6133 =over 4
6134
6135 =item DESCRIPTION
6136
6137 =item Highlights In 5.8.0
6138
6139 =item Incompatible Changes
6140
6141 =over 4
6142
6143 =item Binary Incompatibility
6144
6145 =item 64-bit platforms and malloc
6146
6147 =item AIX Dynaloading
6148
6149 =item Attributes for C<my> variables now handled at run-time
6150
6151 =item Socket Extension Dynamic in VMS
6152
6153 =item IEEE-format Floating Point Default on OpenVMS Alpha
6154
6155 =item New Unicode Semantics (no more C<use utf8>, almost)
6156
6157 =item New Unicode Properties
6158
6159 =item REF(...) Instead Of SCALAR(...)
6160
6161 =item pack/unpack D/F recycled
6162
6163 =item glob() now returns filenames in alphabetical order
6164
6165 =item Deprecations
6166
6167 =back
6168
6169 =item Core Enhancements
6170
6171 =over 4
6172
6173 =item Unicode Overhaul
6174
6175 =item PerlIO is Now The Default
6176
6177 =item ithreads
6178
6179 =item Restricted Hashes
6180
6181 =item Safe Signals
6182
6183 =item Understanding of Numbers
6184
6185 =item Arrays now always interpolate into double-quoted strings [561]
6186
6187 =item Miscellaneous Changes
6188
6189 =back
6190
6191 =item Modules and Pragmata
6192
6193 =over 4
6194
6195 =item New Modules and Pragmata
6196
6197 =item Updated And Improved Modules and Pragmata
6198
6199 =back
6200
6201 =item Utility Changes
6202
6203 =item New Documentation
6204
6205 =item Performance Enhancements
6206
6207 =item Installation and Configuration Improvements
6208
6209 =over 4
6210
6211 =item Generic Improvements
6212
6213 =item New Or Improved Platforms
6214
6215 =back
6216
6217 =item Selected Bug Fixes
6218
6219 =over 4
6220
6221 =item Platform Specific Changes and Fixes
6222
6223 =back
6224
6225 =item New or Changed Diagnostics
6226
6227 =item Changed Internals
6228
6229 =item Security Vulnerability Closed [561]
6230
6231 =item New Tests
6232
6233 =item Known Problems
6234
6235 =over 4
6236
6237 =item The Compiler Suite Is Still Very Experimental
6238
6239 =item Localising Tied Arrays and Hashes Is Broken
6240
6241 =item Building Extensions Can Fail Because Of Largefiles
6242
6243 =item Modifying $_ Inside for(..)
6244
6245 =item mod_perl 1.26 Doesn't Build With Threaded Perl
6246
6247 =item lib/ftmp-security tests warn 'system possibly insecure'
6248
6249 =item libwww-perl (LWP) fails base/date #51
6250
6251 =item PDL failing some tests
6252
6253 =item Perl_get_sv
6254
6255 =item Self-tying Problems
6256
6257 =item ext/threads/t/libc
6258
6259 =item Failure of Thread (5.005-style) tests
6260
6261 =item Timing problems
6262
6263 =item Tied/Magical Array/Hash Elements Do Not Autovivify
6264
6265 =item Unicode in package/class and subroutine names does not work
6266
6267 =back
6268
6269 =item Platform Specific Problems
6270
6271 =over 4
6272
6273 =item AIX
6274
6275 =item Alpha systems with old gccs fail several tests
6276
6277 =item AmigaOS
6278
6279 =item BeOS
6280
6281 =item Cygwin "unable to remap"
6282
6283 =item Cygwin ndbm tests fail on FAT
6284
6285 =item DJGPP Failures
6286
6287 =item FreeBSD built with ithreads coredumps reading large directories
6288
6289 =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
6290
6291 =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
6292
6293 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
6294
6295 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
6296
6297 =item Linux With Sfio Fails op/misc Test 48
6298
6299 =item Mac OS X
6300
6301 =item Mac OS X dyld undefined symbols
6302
6303 =item OS/2 Test Failures
6304
6305 =item op/sprintf tests 91, 129, and 130
6306
6307 =item SCO
6308
6309 =item Solaris 2.5
6310
6311 =item Solaris x86 Fails Tests With -Duse64bitint
6312
6313 =item SUPER-UX (NEC SX)
6314
6315 =item Term::ReadKey not working on Win32
6316
6317 =item UNICOS/mk
6318
6319 =item UTS
6320
6321 =item VOS (Stratus)
6322
6323 =item VMS
6324
6325 =item Win32
6326
6327 =item XML::Parser not working
6328
6329 =item z/OS (OS/390)
6330
6331 =item Unicode Support on EBCDIC Still Spotty
6332
6333 =item Seen In Perl 5.7 But Gone Now
6334
6335 =back
6336
6337 =item Reporting Bugs
6338
6339 =item SEE ALSO
6340
6341 =item HISTORY
6342
6343 =back
6344
6345 =head2 perl573delta - what's new for perl v5.7.3
6346
6347 =over 4
6348
6349 =item DESCRIPTION
6350
6351 =item Changes
6352
6353 =item Reporting Bugs
6354
6355 =item SEE ALSO
6356
6357 =item HISTORY
6358
6359 =back
6360
6361 =head2 perl572delta - what's new for perl v5.7.2
6362
6363 =over 4
6364
6365 =item DESCRIPTION
6366
6367 =item Security Vulnerability Closed
6368
6369 =item Incompatible Changes
6370
6371 =over 4
6372
6373 =item 64-bit platforms and malloc
6374
6375 =item AIX Dynaloading
6376
6377 =item Socket Extension Dynamic in VMS
6378
6379 =item Different Definition of the Unicode Character Classes \p{In...}
6380
6381 =item Deprecations
6382
6383 =back
6384
6385 =item Core Enhancements
6386
6387 =item Modules and Pragmata
6388
6389 =over 4
6390
6391 =item New Modules and Distributions
6392
6393 =item Updated And Improved Modules and Pragmata
6394
6395 =back
6396
6397 =item Utility Changes
6398
6399 =item New Documentation
6400
6401 =item Installation and Configuration Improvements
6402
6403 =over 4
6404
6405 =item New Or Improved Platforms
6406
6407 =item Generic Improvements
6408
6409 =back
6410
6411 =item Selected Bug Fixes
6412
6413 =over 4
6414
6415 =item Platform Specific Changes and Fixes
6416
6417 =back
6418
6419 =item New or Changed Diagnostics
6420
6421 =item Source Code Enhancements
6422
6423 =over 4
6424
6425 =item MAGIC constants
6426
6427 =item Better commented code
6428
6429 =item Regex pre-/post-compilation items matched up
6430
6431 =item gcc -Wall
6432
6433 =back
6434
6435 =item New Tests
6436
6437 =item Known Problems
6438
6439 =over 4
6440
6441 =item AIX
6442
6443 =item Amiga Perl Invoking Mystery
6444
6445 =item lib/ftmp-security tests warn 'system possibly insecure'
6446
6447 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
6448
6449 =item HP-UX lib/io_multihomed Fails When LP64-Configured
6450
6451 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
6452
6453 =item Linux With Sfio Fails op/misc Test 48
6454
6455 =item OS/390
6456
6457 =item op/sprintf tests 129 and 130
6458
6459 =item  Failure of Thread tests
6460
6461 =item UNICOS
6462
6463 =item UTS
6464
6465 =item VMS
6466
6467 =item Win32
6468
6469 =item Localising a Tied Variable Leaks Memory
6470
6471 =item Self-tying of Arrays and Hashes Is Forbidden
6472
6473 =item Variable Attributes are not Currently Usable for Tieing
6474
6475 =item Building Extensions Can Fail Because Of Largefiles
6476
6477 =item The Compiler Suite Is Still Experimental
6478
6479 =item The Long Double Support is Still Experimental
6480
6481 =back
6482
6483 =item Reporting Bugs
6484
6485 =item SEE ALSO
6486
6487 =item HISTORY
6488
6489 =back
6490
6491 =head2 perl571delta - what's new for perl v5.7.1
6492
6493 =over 4
6494
6495 =item DESCRIPTION
6496
6497 =item Security Vulnerability Closed
6498
6499 =item Incompatible Changes
6500
6501 =item Core Enhancements
6502
6503 =over 4
6504
6505 =item AUTOLOAD Is Now Lvaluable
6506
6507 =item PerlIO is Now The Default
6508
6509 =item Signals Are Now Safe
6510
6511 =back
6512
6513 =item Modules and Pragmata
6514
6515 =over 4
6516
6517 =item New Modules
6518
6519 =item Updated And Improved Modules and Pragmata
6520
6521 =back
6522
6523 =item Performance Enhancements
6524
6525 =item Utility Changes
6526
6527 =item New Documentation
6528
6529 =over 4
6530
6531 =item perlclib
6532
6533 =item perliol
6534
6535 =item README.aix
6536
6537 =item README.bs2000
6538
6539 =item README.macos
6540
6541 =item README.mpeix
6542
6543 =item README.solaris
6544
6545 =item README.vos
6546
6547 =item Porting/repository.pod
6548
6549 =back
6550
6551 =item Installation and Configuration Improvements
6552
6553 =over 4
6554
6555 =item New Or Improved Platforms
6556
6557 =item Generic Improvements
6558
6559 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
6560 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
6561 d_strtoq, d_u32align, d_ualarm, d_usleep
6562
6563 =back
6564
6565 =item Selected Bug Fixes
6566
6567 =over 4
6568
6569 =item Platform Specific Changes and Fixes
6570
6571 =back
6572
6573 =item New or Changed Diagnostics
6574
6575 =item Changed Internals
6576
6577 =item New Tests
6578
6579 =item Known Problems
6580
6581 =over 4
6582
6583 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
6584
6585 =item lib/ftmp-security tests warn 'system possibly insecure'
6586
6587 =item lib/io_multihomed Fails In LP64-Configured HP-UX
6588
6589 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
6590
6591 =item lib/b test 19
6592
6593 =item Linux With Sfio Fails op/misc Test 48
6594
6595 =item sigaction test 13 in VMS
6596
6597 =item sprintf tests 129 and 130
6598
6599 =item  Failure of Thread tests
6600
6601 =item Localising a Tied Variable Leaks Memory
6602
6603 =item Self-tying of Arrays and Hashes Is Forbidden
6604
6605 =item Building Extensions Can Fail Because Of Largefiles
6606
6607 =item The Compiler Suite Is Still Experimental
6608
6609 =back
6610
6611 =item Reporting Bugs
6612
6613 =item SEE ALSO
6614
6615 =item HISTORY
6616
6617 =back
6618
6619 =head2 perl570delta - what's new for perl v5.7.0
6620
6621 =over 4
6622
6623 =item DESCRIPTION
6624
6625 =item Security Vulnerability Closed
6626
6627 =item Incompatible Changes
6628
6629 =item Core Enhancements
6630
6631 =item Modules and Pragmata
6632
6633 =over 4
6634
6635 =item New Modules
6636
6637 =item Updated And Improved Modules and Pragmata
6638
6639 =back
6640
6641 =item Utility Changes
6642
6643 =item New Documentation
6644
6645 =item Performance Enhancements
6646
6647 =item Installation and Configuration Improvements
6648
6649 =over 4
6650
6651 =item Generic Improvements
6652
6653 =back
6654
6655 =item Selected Bug Fixes
6656
6657 =over 4
6658
6659 =item Platform Specific Changes and Fixes
6660
6661 =back
6662
6663 =item New or Changed Diagnostics
6664
6665 =item Changed Internals
6666
6667 =item Known Problems
6668
6669 =over 4
6670
6671 =item Unicode Support Still Far From Perfect
6672
6673 =item EBCDIC Still A Lost Platform
6674
6675 =item Building Extensions Can Fail Because Of Largefiles
6676
6677 =item ftmp-security tests warn 'system possibly insecure'
6678
6679 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
6680
6681 =item Long Doubles Still Don't Work In Solaris
6682
6683 =item Linux With Sfio Fails op/misc Test 48
6684
6685 =item Storable tests fail in some platforms
6686
6687 =item Threads Are Still Experimental
6688
6689 =item The Compiler Suite Is Still Experimental
6690
6691 =back
6692
6693 =item Reporting Bugs
6694
6695 =item SEE ALSO
6696
6697 =item HISTORY
6698
6699 =back
6700
6701 =head2 perl561delta - what's new for perl v5.6.x
6702
6703 =over 4
6704
6705 =item DESCRIPTION
6706
6707 =item Summary of changes between 5.6.0 and 5.6.1
6708
6709 =over 4
6710
6711 =item Security Issues
6712
6713 =item Core bug fixes
6714
6715 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
6716 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
6717 references to special variables, Lexical warnings, Spurious warnings and
6718 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
6719 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
6720 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
6721 Module;>, Tests
6722
6723 =item Core features
6724
6725 =item Configuration issues
6726
6727 =item Documentation
6728
6729 =item Bundled modules
6730
6731 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
6732 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
6733 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
6734 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
6735
6736 =item Platform-specific improvements
6737
6738 NCR MP-RAS, NonStop-UX
6739
6740 =back
6741
6742 =item Core Enhancements
6743
6744 =over 4
6745
6746 =item Interpreter cloning, threads, and concurrency
6747
6748 =item Lexically scoped warning categories
6749
6750 =item Unicode and UTF-8 support
6751
6752 =item Support for interpolating named characters
6753
6754 =item "our" declarations
6755
6756 =item Support for strings represented as a vector of ordinals
6757
6758 =item Improved Perl version numbering system
6759
6760 =item New syntax for declaring subroutine attributes
6761
6762 =item File and directory handles can be autovivified
6763
6764 =item open() with more than two arguments
6765
6766 =item 64-bit support
6767
6768 =item Large file support
6769
6770 =item Long doubles
6771
6772 =item "more bits"
6773
6774 =item Enhanced support for sort() subroutines
6775
6776 =item C<sort $coderef @foo> allowed
6777
6778 =item File globbing implemented internally
6779
6780 =item Support for CHECK blocks
6781
6782 =item POSIX character class syntax [: :] supported
6783
6784 =item Better pseudo-random number generator
6785
6786 =item Improved C<qw//> operator
6787
6788 =item Better worst-case behavior of hashes
6789
6790 =item pack() format 'Z' supported
6791
6792 =item pack() format modifier '!' supported
6793
6794 =item pack() and unpack() support counted strings
6795
6796 =item Comments in pack() templates
6797
6798 =item Weak references
6799
6800 =item Binary numbers supported
6801
6802 =item Lvalue subroutines
6803
6804 =item Some arrows may be omitted in calls through references
6805
6806 =item Boolean assignment operators are legal lvalues
6807
6808 =item exists() is supported on subroutine names
6809
6810 =item exists() and delete() are supported on array elements
6811
6812 =item Pseudo-hashes work better
6813
6814 =item Automatic flushing of output buffers
6815
6816 =item Better diagnostics on meaningless filehandle operations
6817
6818 =item Where possible, buffered data discarded from duped input filehandle
6819
6820 =item eof() has the same old magic as <>
6821
6822 =item binmode() can be used to set :crlf and :raw modes
6823
6824 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6825
6826 =item system(), backticks and pipe open now reflect exec() failure
6827
6828 =item Improved diagnostics
6829
6830 =item Diagnostics follow STDERR
6831
6832 =item More consistent close-on-exec behavior
6833
6834 =item syswrite() ease-of-use
6835
6836 =item Better syntax checks on parenthesized unary operators
6837
6838 =item Bit operators support full native integer width
6839
6840 =item Improved security features
6841
6842 =item More functional bareword prototype (*)
6843
6844 =item C<require> and C<do> may be overridden
6845
6846 =item $^X variables may now have names longer than one character
6847
6848 =item New variable $^C reflects C<-c> switch
6849
6850 =item New variable $^V contains Perl version as a string
6851
6852 =item Optional Y2K warnings
6853
6854 =item Arrays now always interpolate into double-quoted strings
6855
6856 =back
6857
6858 =item Modules and Pragmata
6859
6860 =over 4
6861
6862 =item Modules
6863
6864 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6865 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6866 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6867 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6868 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6869 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6870 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6871 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6872
6873 =item Pragmata
6874
6875 =back
6876
6877 =item Utility Changes
6878
6879 =over 4
6880
6881 =item dprofpp
6882
6883 =item find2perl
6884
6885 =item h2xs
6886
6887 =item perlcc
6888
6889 =item perldoc
6890
6891 =item The Perl Debugger
6892
6893 =back
6894
6895 =item Improved Documentation
6896
6897 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6898 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6899 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6900 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6901
6902 =item Performance enhancements
6903
6904 =over 4
6905
6906 =item Simple sort() using { $a <=> $b } and the like are optimized
6907
6908 =item Optimized assignments to lexical variables
6909
6910 =item Faster subroutine calls
6911
6912 =item delete(), each(), values() and hash iteration are faster
6913
6914 =back
6915
6916 =item Installation and Configuration Improvements
6917
6918 =over 4
6919
6920 =item -Dusethreads means something different
6921
6922 =item New Configure flags
6923
6924 =item Threadedness and 64-bitness now more daring
6925
6926 =item Long Doubles
6927
6928 =item -Dusemorebits
6929
6930 =item -Duselargefiles
6931
6932 =item installusrbinperl
6933
6934 =item SOCKS support
6935
6936 =item C<-A> flag
6937
6938 =item Enhanced Installation Directories
6939
6940 =item gcc automatically tried if 'cc' does not seem to be working
6941
6942 =back
6943
6944 =item Platform specific changes
6945
6946 =over 4
6947
6948 =item Supported platforms
6949
6950 =item DOS
6951
6952 =item OS390 (OpenEdition MVS)
6953
6954 =item VMS
6955
6956 =item Win32
6957
6958 =back
6959
6960 =item Significant bug fixes
6961
6962 =over 4
6963
6964 =item <HANDLE> on empty files
6965
6966 =item C<eval '...'> improvements
6967
6968 =item All compilation errors are true errors
6969
6970 =item Implicitly closed filehandles are safer
6971
6972 =item Behavior of list slices is more consistent
6973
6974 =item C<(\$)> prototype and C<$foo{a}>
6975
6976 =item C<goto &sub> and AUTOLOAD
6977
6978 =item C<-bareword> allowed under C<use integer>
6979
6980 =item Failures in DESTROY()
6981
6982 =item Locale bugs fixed
6983
6984 =item Memory leaks
6985
6986 =item Spurious subroutine stubs after failed subroutine calls
6987
6988 =item Taint failures under C<-U>
6989
6990 =item END blocks and the C<-c> switch
6991
6992 =item Potential to leak DATA filehandles
6993
6994 =back
6995
6996 =item New or Changed Diagnostics
6997
6998 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6999 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
7000 / cannot take a count, / must be followed by a, A or Z, / must be followed
7001 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
7002 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
7003 passed through, /%s/ should probably be written as "%s", %s() called too
7004 early to check prototype, %s argument is not a HASH or ARRAY element, %s
7005 argument is not a HASH or ARRAY element or slice, %s argument is not a
7006 subroutine name, %s package attribute may clash with future reserved word:
7007 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
7008 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
7009 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
7010 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
7011 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
7012 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
7013 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
7014 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
7015 weaken a nonreference, Character class [:%s:] unknown, Character class
7016 syntax [%s] belongs inside character classes, Constant is not %s reference,
7017 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
7018 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
7019 "local" instead of "our"?), Document contains no data, entering effective
7020 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
7021 output, flock() on closed filehandle %s, Global symbol "%s" requires
7022 explicit package name, Hexadecimal number > 0xffffffff non-portable,
7023 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
7024 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
7025 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
7026 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
7027 separator character %s in attribute list, Invalid separator character %s in
7028 subroutine attribute list, leaving effective %s failed, Lvalue subs
7029 returning %s not implemented yet, Method %s not permitted, Missing
7030 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
7031 No %s specified for -%c, No package name allowed for variable %s in "our",
7032 No space allowed after -%c, no UTC offset information; assuming local time
7033 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
7034 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
7035 around "%s" list, Possible unintended interpolation of %s in string,
7036 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
7037 instead, Premature end of script headers, Repeat count in pack overflows,
7038 Repeat count in unpack overflows, realloc() of freed memory ignored,
7039 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
7040 zero-length expression, switching effective %s is not implemented, This
7041 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
7042 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
7043 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
7044 escape \\%c passed through, Unterminated attribute parameter in attribute
7045 list, Unterminated attribute list, Unterminated attribute parameter in
7046 subroutine attribute list, Unterminated subroutine attribute list, Value of
7047 CLI symbol "%s" too long, Version number must be a constant number
7048
7049 =item New tests
7050
7051 =item Incompatible Changes
7052
7053 =over 4
7054
7055 =item Perl Source Incompatibilities
7056
7057 CHECK is a new keyword, Treatment of list slices of undef has changed,
7058 Format of $English::PERL_VERSION is different, Literals of the form
7059 C<1.2.3> parse differently, Possibly changed pseudo-random number
7060 generator, Hashing function for hash keys has changed, C<undef> fails on
7061 read only values, Close-on-exec bit may be set on pipe and socket handles,
7062 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
7063 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
7064 Text of some diagnostic output has changed, C<%@> has been removed,
7065 Parenthesized not() behaves like a list operator, Semantics of bareword
7066 prototype C<(*)> have changed, Semantics of bit operators may have changed
7067 on 64-bit platforms, More builtins taint their results
7068
7069 =item C Source Incompatibilities
7070
7071 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
7072
7073 =item Compatible C Source API Changes
7074
7075 C<PATCHLEVEL> is now C<PERL_VERSION>
7076
7077 =item Binary Incompatibilities
7078
7079 =back
7080
7081 =item Known Problems
7082
7083 =over 4
7084
7085 =item Localizing a tied hash element may leak memory
7086
7087 =item Known test failures
7088
7089 =item EBCDIC platforms not fully supported
7090
7091 =item UNICOS/mk CC failures during Configure run
7092
7093 =item Arrow operator and arrays
7094
7095 =item Experimental features
7096
7097 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
7098 pseudo-hash data type, The Compiler suite, Internal implementation of file
7099 globbing, The DB module, The regular expression code constructs:
7100
7101 =back
7102
7103 =item Obsolete Diagnostics
7104
7105 Character class syntax [: :] is reserved for future extensions, Ill-formed
7106 logical name |%s| in prime_env_iter, In string, @%s now must be written as
7107 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
7108 to mean "${$}<digit>" is deprecated
7109
7110 =item Reporting Bugs
7111
7112 =item SEE ALSO
7113
7114 =item HISTORY
7115
7116 =back
7117
7118 =head2 perl56delta - what's new for perl v5.6.0
7119
7120 =over 4
7121
7122 =item DESCRIPTION
7123
7124 =item Core Enhancements
7125
7126 =over 4
7127
7128 =item Interpreter cloning, threads, and concurrency
7129
7130 =item Lexically scoped warning categories
7131
7132 =item Unicode and UTF-8 support
7133
7134 =item Support for interpolating named characters
7135
7136 =item "our" declarations
7137
7138 =item Support for strings represented as a vector of ordinals
7139
7140 =item Improved Perl version numbering system
7141
7142 =item New syntax for declaring subroutine attributes
7143
7144 =item File and directory handles can be autovivified
7145
7146 =item open() with more than two arguments
7147
7148 =item 64-bit support
7149
7150 =item Large file support
7151
7152 =item Long doubles
7153
7154 =item "more bits"
7155
7156 =item Enhanced support for sort() subroutines
7157
7158 =item C<sort $coderef @foo> allowed
7159
7160 =item File globbing implemented internally
7161
7162 =item Support for CHECK blocks
7163
7164 =item POSIX character class syntax [: :] supported
7165
7166 =item Better pseudo-random number generator
7167
7168 =item Improved C<qw//> operator
7169
7170 =item Better worst-case behavior of hashes
7171
7172 =item pack() format 'Z' supported
7173
7174 =item pack() format modifier '!' supported
7175
7176 =item pack() and unpack() support counted strings
7177
7178 =item Comments in pack() templates
7179
7180 =item Weak references
7181
7182 =item Binary numbers supported
7183
7184 =item Lvalue subroutines
7185
7186 =item Some arrows may be omitted in calls through references
7187
7188 =item Boolean assignment operators are legal lvalues
7189
7190 =item exists() is supported on subroutine names
7191
7192 =item exists() and delete() are supported on array elements
7193
7194 =item Pseudo-hashes work better
7195
7196 =item Automatic flushing of output buffers
7197
7198 =item Better diagnostics on meaningless filehandle operations
7199
7200 =item Where possible, buffered data discarded from duped input filehandle
7201
7202 =item eof() has the same old magic as <>
7203
7204 =item binmode() can be used to set :crlf and :raw modes
7205
7206 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
7207
7208 =item system(), backticks and pipe open now reflect exec() failure
7209
7210 =item Improved diagnostics
7211
7212 =item Diagnostics follow STDERR
7213
7214 =item More consistent close-on-exec behavior
7215
7216 =item syswrite() ease-of-use
7217
7218 =item Better syntax checks on parenthesized unary operators
7219
7220 =item Bit operators support full native integer width
7221
7222 =item Improved security features
7223
7224 =item More functional bareword prototype (*)
7225
7226 =item C<require> and C<do> may be overridden
7227
7228 =item $^X variables may now have names longer than one character
7229
7230 =item New variable $^C reflects C<-c> switch
7231
7232 =item New variable $^V contains Perl version as a string
7233
7234 =item Optional Y2K warnings
7235
7236 =item Arrays now always interpolate into double-quoted strings
7237
7238 =back
7239
7240 =item Modules and Pragmata
7241
7242 =over 4
7243
7244 =item Modules
7245
7246 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
7247 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
7248 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
7249 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
7250 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
7251 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
7252 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
7253 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
7254
7255 =item Pragmata
7256
7257 =back
7258
7259 =item Utility Changes
7260
7261 =over 4
7262
7263 =item dprofpp
7264
7265 =item find2perl
7266
7267 =item h2xs
7268
7269 =item perlcc
7270
7271 =item perldoc
7272
7273 =item The Perl Debugger
7274
7275 =back
7276
7277 =item Improved Documentation
7278
7279 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
7280 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
7281 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
7282 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
7283
7284 =item Performance enhancements
7285
7286 =over 4
7287
7288 =item Simple sort() using { $a <=> $b } and the like are optimized
7289
7290 =item Optimized assignments to lexical variables
7291
7292 =item Faster subroutine calls
7293
7294 =item delete(), each(), values() and hash iteration are faster
7295
7296 =back
7297
7298 =item Installation and Configuration Improvements
7299
7300 =over 4
7301
7302 =item -Dusethreads means something different
7303
7304 =item New Configure flags
7305
7306 =item Threadedness and 64-bitness now more daring
7307
7308 =item Long Doubles
7309
7310 =item -Dusemorebits
7311
7312 =item -Duselargefiles
7313
7314 =item installusrbinperl
7315
7316 =item SOCKS support
7317
7318 =item C<-A> flag
7319
7320 =item Enhanced Installation Directories
7321
7322 =back
7323
7324 =item Platform specific changes
7325
7326 =over 4
7327
7328 =item Supported platforms
7329
7330 =item DOS
7331
7332 =item OS390 (OpenEdition MVS)
7333
7334 =item VMS
7335
7336 =item Win32
7337
7338 =back
7339
7340 =item Significant bug fixes
7341
7342 =over 4
7343
7344 =item <HANDLE> on empty files
7345
7346 =item C<eval '...'> improvements
7347
7348 =item All compilation errors are true errors
7349
7350 =item Implicitly closed filehandles are safer
7351
7352 =item Behavior of list slices is more consistent
7353
7354 =item C<(\$)> prototype and C<$foo{a}>
7355
7356 =item C<goto &sub> and AUTOLOAD
7357
7358 =item C<-bareword> allowed under C<use integer>
7359
7360 =item Failures in DESTROY()
7361
7362 =item Locale bugs fixed
7363
7364 =item Memory leaks
7365
7366 =item Spurious subroutine stubs after failed subroutine calls
7367
7368 =item Taint failures under C<-U>
7369
7370 =item END blocks and the C<-c> switch
7371
7372 =item Potential to leak DATA filehandles
7373
7374 =back
7375
7376 =item New or Changed Diagnostics
7377
7378 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
7379 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
7380 / cannot take a count, / must be followed by a, A or Z, / must be followed
7381 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
7382 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
7383 passed through, /%s/ should probably be written as "%s", %s() called too
7384 early to check prototype, %s argument is not a HASH or ARRAY element, %s
7385 argument is not a HASH or ARRAY element or slice, %s argument is not a
7386 subroutine name, %s package attribute may clash with future reserved word:
7387 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
7388 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
7389 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
7390 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
7391 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
7392 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
7393 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
7394 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
7395 weaken a nonreference, Character class [:%s:] unknown, Character class
7396 syntax [%s] belongs inside character classes, Constant is not %s reference,
7397 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
7398 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
7399 "local" instead of "our"?), Document contains no data, entering effective
7400 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
7401 output, flock() on closed filehandle %s, Global symbol "%s" requires
7402 explicit package name, Hexadecimal number > 0xffffffff non-portable,
7403 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
7404 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
7405 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
7406 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
7407 separator character %s in attribute list, Invalid separator character %s in
7408 subroutine attribute list, leaving effective %s failed, Lvalue subs
7409 returning %s not implemented yet, Method %s not permitted, Missing
7410 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
7411 No %s specified for -%c, No package name allowed for variable %s in "our",
7412 No space allowed after -%c, no UTC offset information; assuming local time
7413 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
7414 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
7415 around "%s" list, Possible unintended interpolation of %s in string,
7416 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
7417 instead, Premature end of script headers, Repeat count in pack overflows,
7418 Repeat count in unpack overflows, realloc() of freed memory ignored,
7419 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
7420 zero-length expression, switching effective %s is not implemented, This
7421 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
7422 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
7423 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
7424 escape \\%c passed through, Unterminated attribute parameter in attribute
7425 list, Unterminated attribute list, Unterminated attribute parameter in
7426 subroutine attribute list, Unterminated subroutine attribute list, Value of
7427 CLI symbol "%s" too long, Version number must be a constant number
7428
7429 =item New tests
7430
7431 =item Incompatible Changes
7432
7433 =over 4
7434
7435 =item Perl Source Incompatibilities
7436
7437 CHECK is a new keyword, Treatment of list slices of undef has changed,
7438 Format of $English::PERL_VERSION is different, Literals of the form
7439 C<1.2.3> parse differently, Possibly changed pseudo-random number
7440 generator, Hashing function for hash keys has changed, C<undef> fails on
7441 read only values, Close-on-exec bit may be set on pipe and socket handles,
7442 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
7443 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
7444 Text of some diagnostic output has changed, C<%@> has been removed,
7445 Parenthesized not() behaves like a list operator, Semantics of bareword
7446 prototype C<(*)> have changed, Semantics of bit operators may have changed
7447 on 64-bit platforms, More builtins taint their results
7448
7449 =item C Source Incompatibilities
7450
7451 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
7452
7453 =item Compatible C Source API Changes
7454
7455 C<PATCHLEVEL> is now C<PERL_VERSION>
7456
7457 =item Binary Incompatibilities
7458
7459 =back
7460
7461 =item Known Problems
7462
7463 =over 4
7464
7465 =item Thread test failures
7466
7467 =item EBCDIC platforms not supported
7468
7469 =item In 64-bit HP-UX the lib/io_multihomed test may hang
7470
7471 =item NEXTSTEP 3.3 POSIX test failure
7472
7473 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
7474 gcc
7475
7476 =item UNICOS/mk CC failures during Configure run
7477
7478 =item Arrow operator and arrays
7479
7480 =item Experimental features
7481
7482 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
7483 pseudo-hash data type, The Compiler suite, Internal implementation of file
7484 globbing, The DB module, The regular expression code constructs:
7485
7486 =back
7487
7488 =item Obsolete Diagnostics
7489
7490 Character class syntax [: :] is reserved for future extensions, Ill-formed
7491 logical name |%s| in prime_env_iter, In string, @%s now must be written as
7492 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
7493 to mean "${$}<digit>" is deprecated
7494
7495 =item Reporting Bugs
7496
7497 =item SEE ALSO
7498
7499 =item HISTORY
7500
7501 =back
7502
7503 =head2 perl5005delta - what's new for perl5.005
7504
7505 =over 4
7506
7507 =item DESCRIPTION
7508
7509 =item About the new versioning system
7510
7511 =item Incompatible Changes
7512
7513 =over 4
7514
7515 =item WARNING:  This version is not binary compatible with Perl 5.004.
7516
7517 =item Default installation structure has changed
7518
7519 =item Perl Source Compatibility
7520
7521 =item C Source Compatibility
7522
7523 =item Binary Compatibility
7524
7525 =item Security fixes may affect compatibility
7526
7527 =item Relaxed new mandatory warnings introduced in 5.004
7528
7529 =item Licensing
7530
7531 =back
7532
7533 =item Core Changes
7534
7535 =over 4
7536
7537 =item Threads
7538
7539 =item Compiler
7540
7541 =item Regular Expressions
7542
7543 Many new and improved optimizations, Many bug fixes, New regular expression
7544 constructs, New operator for precompiled regular expressions, Other
7545 improvements, Incompatible changes
7546
7547 =item   Improved malloc()
7548
7549 =item Quicksort is internally implemented
7550
7551 =item Reliable signals
7552
7553 =item Reliable stack pointers
7554
7555 =item More generous treatment of carriage returns
7556
7557 =item Memory leaks
7558
7559 =item Better support for multiple interpreters
7560
7561 =item Behavior of local() on array and hash elements is now well-defined
7562
7563 =item C<%!> is transparently tied to the L<Errno> module
7564
7565 =item Pseudo-hashes are supported
7566
7567 =item C<EXPR foreach EXPR> is supported
7568
7569 =item Keywords can be globally overridden
7570
7571 =item C<$^E> is meaningful on Win32
7572
7573 =item C<foreach (1..1000000)> optimized
7574
7575 =item C<Foo::> can be used as implicitly quoted package name
7576
7577 =item C<exists $Foo::{Bar::}> tests existence of a package
7578
7579 =item Better locale support
7580
7581 =item Experimental support for 64-bit platforms
7582
7583 =item prototype() returns useful results on builtins
7584
7585 =item Extended support for exception handling
7586
7587 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
7588
7589 =item All C<printf> format conversions are handled internally
7590
7591 =item New C<INIT> keyword
7592
7593 =item New C<lock> keyword
7594
7595 =item New C<qr//> operator
7596
7597 =item C<our> is now a reserved word
7598
7599 =item Tied arrays are now fully supported
7600
7601 =item Tied handles support is better
7602
7603 =item 4th argument to substr
7604
7605 =item Negative LENGTH argument to splice
7606
7607 =item Magic lvalues are now more magical
7608
7609 =item <> now reads in records
7610
7611 =back
7612
7613 =item Supported Platforms
7614
7615 =over 4
7616
7617 =item New Platforms
7618
7619 =item Changes in existing support
7620
7621 =back
7622
7623 =item Modules and Pragmata
7624
7625 =over 4
7626
7627 =item New Modules
7628
7629 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
7630 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
7631 Thread, attrs, fields, re
7632
7633 =item Changes in existing modules
7634
7635 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
7636 MakeMaker, CPAN, Cwd
7637
7638 =back
7639
7640 =item Utility Changes
7641
7642 =item Documentation Changes
7643
7644 =item New Diagnostics
7645
7646 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
7647 while coercing array into hash, Bareword "%s" refers to nonexistent
7648 package, Can't call method "%s" on an undefined value, Can't check
7649 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
7650 goto subroutine from an eval-string, Can't localize pseudo-hash element,
7651 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
7652 for "%s", Character class syntax [. .] is reserved for future extensions,
7653 Character class syntax [: :] is reserved for future extensions, Character
7654 class syntax [= =] is reserved for future extensions, %s: Eval-group in
7655 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
7656 Eval-group not allowed at run time, Explicit blessing to '' (assuming
7657 package main), Illegal hex digit ignored, No such array field, No such
7658 field "%s" in variable %s of type %s, Out of memory during ridiculously
7659 large request, Range iterator outside integer range, Recursive inheritance
7660 detected while looking for method '%s' %s, Reference found where even-sized
7661 list expected, Undefined value assigned to typeglob, Use of reserved word
7662 "%s" is deprecated, perl: warning: Setting locale failed
7663
7664 =item Obsolete Diagnostics
7665
7666 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
7667 temporary file, regexp too big
7668
7669 =item Configuration Changes
7670
7671 =item BUGS
7672
7673 =item SEE ALSO
7674
7675 =item HISTORY
7676
7677 =back
7678
7679 =head2 perl5004delta - what's new for perl5.004
7680
7681 =over 4
7682
7683 =item DESCRIPTION
7684
7685 =item Supported Environments
7686
7687 =item Core Changes
7688
7689 =over 4
7690
7691 =item List assignment to %ENV works
7692
7693 =item Change to "Can't locate Foo.pm in @INC" error
7694
7695 =item Compilation option: Binary compatibility with 5.003
7696
7697 =item $PERL5OPT environment variable
7698
7699 =item Limitations on B<-M>, B<-m>, and B<-T> options
7700
7701 =item More precise warnings
7702
7703 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
7704
7705 =item Previously deprecated %OVERLOAD is no longer usable
7706
7707 =item Subroutine arguments created only when they're modified
7708
7709 =item Group vector changeable with C<$)>
7710
7711 =item Fixed parsing of $$<digit>, &$<digit>, etc.
7712
7713 =item Fixed localization of $<digit>, $&, etc.
7714
7715 =item No resetting of $. on implicit close
7716
7717 =item C<wantarray> may return undef
7718
7719 =item C<eval EXPR> determines value of EXPR in scalar context
7720
7721 =item Changes to tainting checks
7722
7723 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
7724 spawning if tainted $TERM doesn't look like a terminal name
7725
7726 =item New Opcode module and revised Safe module
7727
7728 =item Embedding improvements
7729
7730 =item Internal change: FileHandle class based on IO::* classes
7731
7732 =item Internal change: PerlIO abstraction interface
7733
7734 =item New and changed syntax
7735
7736 $coderef->(PARAMS)
7737
7738 =item New and changed builtin constants
7739
7740 __PACKAGE__
7741
7742 =item New and changed builtin variables
7743
7744 $^E, $^H, $^M
7745
7746 =item New and changed builtin functions
7747
7748 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
7749 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
7750 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
7751 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
7752 nested C<sub{}> closures work now, formats work right on changing lexicals
7753
7754 =item New builtin methods
7755
7756 isa(CLASS), can(METHOD), VERSION( [NEED] )
7757
7758 =item TIEHANDLE now supported
7759
7760 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
7761 LIST, READLINE this, GETC this, DESTROY this
7762
7763 =item Malloc enhancements
7764
7765 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
7766
7767 =item Miscellaneous efficiency enhancements
7768
7769 =back
7770
7771 =item Support for More Operating Systems
7772
7773 =over 4
7774
7775 =item Win32
7776
7777 =item Plan 9
7778
7779 =item QNX
7780
7781 =item AmigaOS
7782
7783 =back
7784
7785 =item Pragmata
7786
7787 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
7788 constant NAME => VALUE, use locale, use ops, use vmsish
7789
7790 =item Modules
7791
7792 =over 4
7793
7794 =item Required Updates
7795
7796 =item Installation directories
7797
7798 =item Module information summary
7799
7800 =item Fcntl
7801
7802 =item IO
7803
7804 =item Math::Complex
7805
7806 =item Math::Trig
7807
7808 =item DB_File
7809
7810 =item Net::Ping
7811
7812 =item Object-oriented overrides for builtin operators
7813
7814 =back
7815
7816 =item Utility Changes
7817
7818 =over 4
7819
7820 =item pod2html
7821
7822 Sends converted HTML to standard output
7823
7824 =item xsubpp
7825
7826 C<void> XSUBs now default to returning nothing
7827
7828 =back
7829
7830 =item C Language API Changes
7831
7832 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
7833 manipulating hashes
7834
7835 =item Documentation Changes
7836
7837 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
7838 L<perlmodlib>, L<perldebug>, L<perlsec>
7839
7840 =item New Diagnostics
7841
7842 "my" variable %s masks earlier declaration in same scope, %s argument is
7843 not a HASH element or slice, Allocation too large: %lx, Allocation too
7844 large, Applying %s to %s will act on scalar(%s), Attempt to free
7845 nonexistent shared string, Attempt to use reference as lvalue in substr,
7846 Bareword "%s" refers to nonexistent package, Can't redefine active sort
7847 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
7848 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
7849 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
7850 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
7851 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
7852 %s, Integer overflow in hex number, Integer overflow in octal number,
7853 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
7854 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
7855 possible typo, Null picture in formline, Offset outside string, Out of
7856 memory!, Out of memory during request for %s, panic: frexp, Possible
7857 attempt to put comments in qw() list, Possible attempt to separate words
7858 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
7859 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
7860 option, untie attempted while %d inner references still exist, Unrecognized
7861 character %s, Unsupported function fork, Use of "$$<digit>" to mean
7862 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
7863 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
7864 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
7865 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
7866 long, Process terminated by SIG%s
7867
7868 =item BUGS
7869
7870 =item SEE ALSO
7871
7872 =item HISTORY
7873
7874 =back
7875
7876 =head2 perlartistic - the Perl Artistic License
7877
7878 =over 4
7879
7880 =item SYNOPSIS
7881
7882 =item DESCRIPTION
7883
7884 =item The "Artistic License"
7885
7886 =over 4
7887
7888 =item Preamble
7889
7890 =item Definitions
7891
7892 "Package", "Standard Version", "Copyright Holder", "You", "Reasonable
7893 copying fee", "Freely Available"
7894
7895 =item Conditions
7896
7897 a), b), c), d), a), b), c), d)
7898
7899 =back
7900
7901 =back
7902
7903 =head2 perlgpl - the GNU General Public License, version 2
7904
7905 =over 4
7906
7907 =item SYNOPSIS
7908
7909 =back
7910
7911 =over 4
7912
7913 =item DESCRIPTION
7914
7915 =item GNU GENERAL PUBLIC LICENSE
7916
7917 =back
7918
7919 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
7920
7921 =over 4
7922
7923 =item DESCRIPTION
7924
7925 =over 4
7926
7927 =item Compiling Perl 5 on AIX
7928
7929 =item OS level
7930
7931 =item Building Dynamic Extensions on AIX
7932
7933 =item The IBM ANSI C Compiler
7934
7935 =item The usenm option
7936
7937 =item Using GNU's gcc for building perl
7938
7939 =item Using Large Files with Perl
7940
7941 =item Threaded Perl
7942
7943 =item 64-bit Perl
7944
7945 =item AIX 4.2 and extensions using C++ with statics
7946
7947 =back
7948
7949 =item AUTHOR
7950
7951 =item DATE
7952
7953 =back
7954
7955 =head2 perlamiga - Perl under Amiga OS
7956
7957 =over 4
7958
7959 =item NOTE
7960
7961 =item SYNOPSIS
7962
7963 =back
7964
7965 =over 4
7966
7967 =item DESCRIPTION
7968
7969 =over 4
7970
7971 =item Prerequisites for Compiling Perl on AmigaOS
7972
7973 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
7974
7975 =item Starting Perl programs under AmigaOS
7976
7977 =item Shortcomings of Perl under AmigaOS
7978
7979 =back
7980
7981 =item INSTALLATION
7982
7983 =item Accessing documentation
7984
7985 =over 4
7986
7987 =item Manpages for Perl on AmigaOS
7988
7989 =item Perl HTML Documentation on AmigaOS
7990
7991 =item Perl GNU Info Files on AmigaOS
7992
7993 =item Perl LaTeX Documentation on AmigaOS
7994
7995 =back
7996
7997 =item BUILDING PERL ON AMIGAOS
7998
7999 =over 4
8000
8001 =item Build Prerequisites for Perl on AmigaOS
8002
8003 =item Getting the Perl Source for AmigaOS
8004
8005 =item Making Perl on AmigaOS
8006
8007 =item Testing Perl on AmigaOS
8008
8009 =item Installing the built Perl on AmigaOS
8010
8011 =back
8012
8013 =item PERL 5.8.0 BROKEN IN AMIGAOS
8014
8015 =item AUTHORS
8016
8017 =item SEE ALSO
8018
8019 =back
8020
8021 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
8022
8023 =over 4
8024
8025 =item DESCRIPTION
8026
8027 =item AUTHOR
8028
8029 =back
8030
8031 =head2 perlbeos, README.beos - Perl version 5 on BeOS
8032
8033 =over 4
8034
8035 =item DESCRIPTION
8036
8037 =over 4
8038
8039 =item General Issues with Perl on BeOS
8040
8041 =item BeOS Release-specific Notes
8042
8043 R4 x86, R4 PPC
8044
8045 =item Contact Information
8046
8047 =item Update 2002-05-30
8048
8049 =back
8050
8051 =back
8052
8053 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
8054
8055 =over 4
8056
8057 =item SYNOPSIS
8058
8059 =item DESCRIPTION
8060
8061 =over 4
8062
8063 =item gzip on BS2000
8064
8065 =item bison on BS2000
8066
8067 =item Unpacking Perl Distribution on BS2000
8068
8069 =item Compiling Perl on BS2000
8070
8071 =item Testing Perl on BS2000
8072
8073 =item Installing Perl on BS2000
8074
8075 =item Using Perl in the Posix-Shell of BS2000
8076
8077 =item Using Perl in "native" BS2000
8078
8079 =item Floating point anomalies on BS2000
8080
8081 =item Using PerlIO and different encodings on ASCII and EBCDIC partitions
8082
8083 =back
8084
8085 =item AUTHORS
8086
8087 =item SEE ALSO
8088
8089 =over 4
8090
8091 =item Mailing list
8092
8093 =back
8094
8095 =item HISTORY
8096
8097 =back
8098
8099 =head2 perlce - Perl for WinCE
8100
8101 =over 4
8102
8103 =item DESCRIPTION
8104
8105 =item BUILD
8106
8107 =over 4
8108
8109 =item Tools & SDK
8110
8111 Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's
8112 celib-sources, Rainer Keuchel's console-sources
8113
8114 =item Make
8115
8116 go to ./wince subdirectory, edit file compile.bat, run    compile.bat, run 
8117   compile.bat dist
8118
8119 =back
8120
8121 =item ACKNOWLEDGEMENTS
8122
8123 =item AUTHORS
8124
8125 =back
8126
8127 =head2 perlcygwin, README.cygwin - Perl for Cygwin
8128
8129 =over 4
8130
8131 =item SYNOPSIS
8132
8133 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
8134
8135 =over 4
8136
8137 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
8138
8139 =item Cygwin Configuration
8140
8141 C<PATH>, I<nroff>, Permissions
8142
8143 =back
8144
8145 =item CONFIGURE PERL ON CYGWIN
8146
8147 =over 4
8148
8149 =item Stripping Perl Binaries on Cygwin
8150
8151 =item Optional Libraries for Perl on Cygwin
8152
8153 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
8154 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
8155
8156 =item Configure-time Options for Perl on Cygwin
8157
8158 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
8159 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
8160 C<-Dmksymlinks>
8161
8162 =item Suspicious Warnings on Cygwin
8163
8164 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
8165
8166 =back
8167
8168 =item MAKE ON CYGWIN
8169
8170 =over 4
8171
8172 =item Errors on Cygwin
8173
8174 =item ld2 on Cygwin
8175
8176 =back
8177
8178 =item TEST ON CYGWIN
8179
8180 =over 4
8181
8182 =item File Permissions on Cygwin
8183
8184 =item NDBM_File and ODBM_File do not work on FAT filesystems
8185
8186 =item C<fork()> failures in io_* tests
8187
8188 =item Script Portability on Cygwin
8189
8190 Pathnames, Text/Binary, PerlIO, F<.exe>, C<chown()>, Miscellaneous
8191
8192 =back
8193
8194 =item INSTALL PERL ON CYGWIN
8195
8196 =item MANIFEST ON CYGWIN
8197
8198 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
8199 Source, Compiled Module Source, Perl Modules/Scripts
8200
8201 =item BUGS ON CYGWIN
8202
8203 =item AUTHORS
8204
8205 =item HISTORY
8206
8207 =back
8208
8209 =head2 perldgux - Perl under DG/UX.
8210
8211 =over 4
8212
8213 =item SYNOPSIS
8214
8215 =back
8216
8217 =over 4
8218
8219 =item DESCRIPTION
8220
8221 =item BUILDING PERL ON DG/UX
8222
8223 =over 4
8224
8225 =item Non-threaded Perl on DG/UX
8226
8227 =item Threaded Perl on DG/UX
8228
8229 =item Testing Perl on DG/UX
8230
8231 =item Installing the built perl on DG/UX
8232
8233 =back
8234
8235 =item AUTHOR
8236
8237 =item SEE ALSO
8238
8239 =back
8240
8241 =head2 perldos - Perl under DOS, W31, W95.
8242
8243 =over 4
8244
8245 =item SYNOPSIS
8246
8247 =item DESCRIPTION
8248
8249 =over 4
8250
8251 =item Prerequisites for Compiling Perl on DOS
8252
8253 DJGPP, Pthreads
8254
8255 =item Shortcomings of Perl under DOS
8256
8257 =item Building Perl on DOS
8258
8259 =item Testing Perl on DOS
8260
8261 =item Installation of Perl on DOS
8262
8263 =back
8264
8265 =item BUILDING AND INSTALLING MODULES ON DOS
8266
8267 =over 4
8268
8269 =item Building Prerequisites for Perl on DOS
8270
8271 =item Unpacking CPAN Modules on DOS
8272
8273 =item Building Non-XS Modules on DOS
8274
8275 =item Building XS Modules on DOS
8276
8277 =back
8278
8279 =item AUTHOR
8280
8281 =item SEE ALSO
8282
8283 =back
8284
8285 =head2 perlepoc, README.epoc - Perl for EPOC
8286
8287 =over 4
8288
8289 =item SYNOPSIS
8290
8291 =item INTRODUCTION
8292
8293 =item INSTALLING PERL ON EPOC
8294
8295 =item STARTING PERL ON EPOC
8296
8297 =over 4
8298
8299 =item Editors on Epoc
8300
8301 =item Features of Perl on Epoc
8302
8303 =item Restrictions of Perl on Epoc
8304
8305 =item Compiling Perl 5 on the EPOC cross compiling environment
8306
8307 =back
8308
8309 =item SUPPORT STATUS OF PERL ON EPOC
8310
8311 =item AUTHOR
8312
8313 =item LAST UPDATE
8314
8315 =back
8316
8317 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
8318
8319 =over 4
8320
8321 =item DESCRIPTION
8322
8323 =over 4
8324
8325 =item FreeBSD core dumps from readdir_r with ithreads
8326
8327 =item $^X doesn't always contain a full path in FreeBSD
8328
8329 =item Perl will no longer be part of "base FreeBSD"
8330
8331 =back
8332
8333 =item AUTHOR
8334
8335 =back
8336
8337 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
8338 (HP-UX) systems
8339
8340 =over 4
8341
8342 =item DESCRIPTION
8343
8344 =over 4
8345
8346 =item Using perl as shipped with HP-UX
8347
8348 =item Using perl from HP's porting centre
8349
8350 =item Compiling Perl 5 on HP-UX
8351
8352 =item PA-RISC
8353
8354 =item PA-RISC 1.0
8355
8356 =item PA-RISC 1.1
8357
8358 =item PA-RISC 2.0
8359
8360 =item Itanium
8361
8362 =item Portability Between PA-RISC Versions
8363
8364 =item Itanium Processor Family and HP-UX
8365
8366 =item Building Dynamic Extensions on HP-UX
8367
8368 =item The HP ANSI C Compiler
8369
8370 =item The GNU C Compiler
8371
8372 =item Using Large Files with Perl on HP-UX
8373
8374 =item Threaded Perl on HP-UX
8375
8376 =item 64-bit Perl on HP-UX
8377
8378 =item Oracle on HP-UX
8379
8380 =item GDBM and Threads on HP-UX
8381
8382 =item NFS filesystems and utime(2) on HP-UX
8383
8384 =item perl -P and // and HP-UX
8385
8386 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
8387
8388 =back
8389
8390 =item nss_delete core dump from op/pwent or op/grent
8391
8392 =item AUTHOR
8393
8394 =item DATE
8395
8396 =back
8397
8398 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
8399
8400 =over 4
8401
8402 =item DESCRIPTION
8403
8404 =over 4
8405
8406 =item Known Problems with Perl on Hurd 
8407
8408 =back
8409
8410 =item AUTHOR
8411
8412 =back
8413
8414 =head2 perlirix, README.irix - Perl version 5 on Irix systems
8415
8416 =over 4
8417
8418 =item DESCRIPTION
8419
8420 =over 4
8421
8422 =item Building 32-bit Perl in Irix
8423
8424 =item Building 64-bit Perl in Irix
8425
8426 =item About Compiler Versions of Irix
8427
8428 =item Linker Problems in Irix
8429
8430 =item Malloc in Irix
8431
8432 =item Building with threads in Irix
8433
8434 =item Irix 5.3
8435
8436 =back
8437
8438 =item AUTHOR
8439
8440 =back
8441
8442 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
8443 systems
8444
8445 =over 4
8446
8447 =item DESCRIPTION
8448
8449 =over 4
8450
8451 =item Perl version 5.8.x and greater not supported
8452
8453 =item Compiling Perl 5.6.x on MachTen
8454
8455 =item Failures during C<make test> on MachTen
8456
8457 op/lexassign.t, pragma/warnings.t
8458
8459 =item Building external modules on MachTen
8460
8461 =back
8462
8463 =item AUTHOR
8464
8465 =item DATE
8466
8467 =back
8468
8469 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
8470
8471 =over 4
8472
8473 =item SYNOPSIS
8474
8475 =item DESCRIPTION
8476
8477 =item AUTHOR
8478
8479 =item DATE
8480
8481 =back
8482
8483 =head2 perlmacosx, README.macosx - Perl under Mac OS X
8484
8485 =over 4
8486
8487 =item SYNOPSIS
8488
8489 =item DESCRIPTION
8490
8491 =over 4
8492
8493 =item Installation Prefix
8494
8495 =item libperl and Prebinding
8496
8497 =item Updating Panther
8498
8499 =item Known problems
8500
8501 =item MacPerl
8502
8503 =item Carbon
8504
8505 =item Cocoa
8506
8507 =back
8508
8509 =item Starting From Scratch
8510
8511 =item AUTHOR
8512
8513 =item DATE
8514
8515 =back
8516
8517 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
8518
8519 =over 4
8520
8521 =item DESCRIPTION
8522
8523 =item Known problems with Perl on MiNT
8524
8525 =item AUTHOR
8526
8527 =back
8528
8529 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
8530
8531 =over 4
8532
8533 =item SYNOPSIS
8534
8535 =item NOTE
8536
8537 =item Binary distribution from HP
8538
8539 =item What's New in Perl for MPE/iX
8540
8541 =item Welcome to Perl/iX
8542
8543 =item System Requirements for Perl/iX
8544
8545 =item How to Obtain Perl/iX
8546
8547 =item Perl/iX Distribution Contents Highlights
8548
8549 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
8550 public_html/feedback.cgi, src/perl-5.6.0-mpe
8551
8552 =item How to Compile Perl/iX
8553
8554  4,  6
8555
8556 =item Getting Started with Perl/iX
8557
8558 =item MPE/iX Implementation Considerations
8559
8560 =item Known Perl/iX Bugs Under Investigation
8561
8562 =item Perl/iX To-Do List
8563
8564 =item Perl/iX Change History
8565
8566 =item AUTHOR
8567
8568 =back
8569
8570 =head2 perlnetware - Perl for NetWare
8571
8572 =over 4
8573
8574 =item DESCRIPTION
8575
8576 =item BUILD
8577
8578 =over 4
8579
8580 =item Tools & SDK
8581
8582 =item Setup
8583
8584 SetNWBld.bat, Buildtype.bat
8585
8586 =item Make
8587
8588 =item Interpreter
8589
8590 =item Extensions
8591
8592 =back
8593
8594 =item INSTALL
8595
8596 =item BUILD NEW EXTENSIONS
8597
8598 =item ACKNOWLEDGEMENTS
8599
8600 =item AUTHORS
8601
8602 =item DATE
8603
8604 =back
8605
8606 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
8607
8608 =over 4
8609
8610 =item SYNOPSIS
8611
8612 =back
8613
8614 =over 4
8615
8616 =item DESCRIPTION
8617
8618 =over 4
8619
8620 =item Target
8621
8622 =item Other OSes
8623
8624 =item Prerequisites
8625
8626 EMX, RSX, HPFS, pdksh
8627
8628 =item Starting Perl programs under OS/2 (and DOS and...)
8629
8630 =item Starting OS/2 (and DOS) programs under Perl
8631
8632 =back
8633
8634 =item Frequently asked questions
8635
8636 =over 4
8637
8638 =item "It does not work"
8639
8640 =item I cannot run external programs
8641
8642 =item I cannot embed perl into my program, or use F<perl.dll> from my
8643 program. 
8644
8645 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
8646 L<ExtUtils::Embed>?
8647
8648 =item C<``> and pipe-C<open> do not work under DOS.
8649
8650 =item Cannot start C<find.exe "pattern" file>
8651
8652 =back
8653
8654 =item INSTALLATION
8655
8656 =over 4
8657
8658 =item Automatic binary installation
8659
8660 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
8661
8662 =item Manual binary installation
8663
8664 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
8665 (statically linked), Executables for Perl utilities, Main Perl library,
8666 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
8667 and utilities, Manpages for Perl modules, Source for Perl documentation,
8668 Perl manual in F<.INF> format, Pdksh
8669
8670 =item B<Warning>
8671
8672 =back
8673
8674 =item Accessing documentation
8675
8676 =over 4
8677
8678 =item OS/2 F<.INF> file
8679
8680 =item Plain text
8681
8682 =item Manpages
8683
8684 =item HTML
8685
8686 =item GNU C<info> files
8687
8688 =item F<PDF> files
8689
8690 =item C<LaTeX> docs
8691
8692 =back
8693
8694 =item BUILD
8695
8696 =over 4
8697
8698 =item The short story
8699
8700 =item Prerequisites
8701
8702 =item Getting perl source
8703
8704 =item Application of the patches
8705
8706 =item Hand-editing
8707
8708 =item Making
8709
8710 =item Testing
8711
8712 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
8713 F<op/stat.t>
8714
8715 =item Installing the built perl
8716
8717 =item C<a.out>-style build
8718
8719 =back
8720
8721 =item Building a binary distribution
8722
8723 =item Building custom F<.EXE> files
8724
8725 =over 4
8726
8727 =item Making executables with a custom collection of statically loaded
8728 extensions
8729
8730 =item Making executables with a custom search-paths
8731
8732 =back
8733
8734 =item Build FAQ
8735
8736 =over 4
8737
8738 =item Some C</> became C<\> in pdksh.
8739
8740 =item C<'errno'> - unresolved external
8741
8742 =item Problems with tr or sed
8743
8744 =item Some problem (forget which ;-)
8745
8746 =item Library ... not found
8747
8748 =item Segfault in make
8749
8750 =item op/sprintf test failure
8751
8752 =back
8753
8754 =item Specific (mis)features of OS/2 port
8755
8756 =over 4
8757
8758 =item C<setpriority>, C<getpriority>
8759
8760 =item C<system()>
8761
8762 =item C<extproc> on the first line
8763
8764 =item Additional modules:
8765
8766 =item Prebuilt methods:
8767
8768 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
8769  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>, 
8770 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>, 
8771 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>, 
8772 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>, 
8773 C<Cwd::extLibpath_set( path [, type ] )>,
8774 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
8775 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
8776 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
8777 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
8778 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
8779 C<OS2::DLLname([how [, \&xsub]])>
8780
8781 =item Prebuilt variables:
8782
8783 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
8784 $OS2::nsyserror
8785
8786 =item Misfeatures
8787
8788 =item Modifications
8789
8790 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
8791 C<flock>
8792
8793 =item Identifying DLLs
8794
8795 =item Centralized management of resources
8796
8797 C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
8798 C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
8799 C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
8800 C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
8801
8802 =back
8803
8804 =item Perl flavors
8805
8806 =over 4
8807
8808 =item F<perl.exe>
8809
8810 =item F<perl_.exe>
8811
8812 =item F<perl__.exe>
8813
8814 =item F<perl___.exe>
8815
8816 =item Why strange names?
8817
8818 =item Why dynamic linking?
8819
8820 =item Why chimera build?
8821
8822 =back
8823
8824 =item ENVIRONMENT
8825
8826 =over 4
8827
8828 =item C<PERLLIB_PREFIX>
8829
8830 =item C<PERL_BADLANG>
8831
8832 =item C<PERL_BADFREE>
8833
8834 =item C<PERL_SH_DIR>
8835
8836 =item C<USE_PERL_FLOCK>
8837
8838 =item C<TMP> or C<TEMP>
8839
8840 =back
8841
8842 =item Evolution
8843
8844 =over 4
8845
8846 =item Text-mode filehandles
8847
8848 =item Priorities
8849
8850 =item DLL name mangling: pre 5.6.2
8851
8852 =item DLL name mangling: 5.6.2 and beyond
8853
8854 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
8855 C<LIBPATH>
8856
8857 =item DLL forwarder generation
8858
8859 =item Threading
8860
8861 =item Calls to external programs
8862
8863 =item Memory allocation
8864
8865 =item Threads
8866
8867 C<COND_WAIT>, F<os2.c>
8868
8869 =back
8870
8871 =item BUGS
8872
8873 =back
8874
8875 =over 4
8876
8877 =item AUTHOR
8878
8879 =item SEE ALSO
8880
8881 =back
8882
8883 =head2 perlos390, README.os390 - building and installing Perl for OS/390
8884 and z/OS
8885
8886 =over 4
8887
8888 =item SYNOPSIS
8889
8890 =item DESCRIPTION
8891
8892 =over 4
8893
8894 =item Tools
8895
8896 =item Unpacking Perl distribution on OS/390
8897
8898 =item Setup and utilities for Perl on OS/390
8899
8900 =item Configure Perl on OS/390
8901
8902 =item Build, Test, Install Perl on OS/390
8903
8904 =item Build Anomalies with Perl on OS/390
8905
8906 =item Testing Anomalies with Perl on OS/390
8907
8908 =item Installation Anomalies with Perl on OS/390
8909
8910 =item Usage Hints for Perl on OS/390
8911
8912 =item Floating Point Anomalies with Perl on OS/390
8913
8914 =item Modules and Extensions for Perl on OS/390
8915
8916 =back
8917
8918 =item AUTHORS
8919
8920 =item SEE ALSO
8921
8922 =over 4
8923
8924 =item Mailing list for Perl on OS/390
8925
8926 =back
8927
8928 =item HISTORY
8929
8930 =back
8931
8932 =head2 perlos400, README.os400 - Perl version 5 on OS/400
8933
8934 =over 4
8935
8936 =item DESCRIPTION
8937
8938 =over 4
8939
8940 =item Compiling Perl for OS/400 PASE
8941
8942 =item Installing Perl in OS/400 PASE
8943
8944 =item Using Perl in OS/400 PASE
8945
8946 =item Known Problems
8947
8948 =item Perl on ILE
8949
8950 =back
8951
8952 =item AUTHORS
8953
8954 =back
8955
8956 =head2 perlplan9 - Plan 9-specific documentation for Perl
8957
8958 =over 4
8959
8960 =item DESCRIPTION
8961
8962 =over 4
8963
8964 =item Invoking Perl
8965
8966 =item What's in Plan 9 Perl
8967
8968 =item What's not in Plan 9 Perl
8969
8970 =item Perl5 Functions not currently supported in Plan 9 Perl
8971
8972 =item Signals in Plan 9 Perl
8973
8974 =back
8975
8976 =item COMPILING AND INSTALLING PERL ON PLAN 9
8977
8978 =over 4
8979
8980 =item Installing Perl Documentation on Plan 9
8981
8982 =back
8983
8984 =item BUGS
8985
8986 =item Revision date
8987
8988 =item AUTHOR
8989
8990 =back
8991
8992 =head2 perlqnx, README.qnx - Perl version 5 on QNX
8993
8994 =over 4
8995
8996 =item DESCRIPTION
8997
8998 =over 4
8999
9000 =item Required Software for Compiling Perl on QNX4
9001
9002 /bin/sh, ar, nm, cpp, make
9003
9004 =item Outstanding Issues with Perl on QNX4
9005
9006 =item QNX auxiliary files
9007
9008 qnx/ar, qnx/cpp
9009
9010 =item Outstanding issues with perl under QNX6
9011
9012 =back
9013
9014 =item AUTHOR
9015
9016 =back
9017
9018 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
9019
9020 =over 4
9021
9022 =item DESCRIPTION
9023
9024 =over 4
9025
9026 =item Solaris Version Numbers.
9027
9028 =back
9029
9030 =item RESOURCES
9031
9032 Solaris FAQ, Precompiled Binaries, Solaris Documentation
9033
9034 =item SETTING UP
9035
9036 =over 4
9037
9038 =item File Extraction Problems on Solaris.
9039
9040 =item Compiler and Related Tools on Solaris.
9041
9042 =item Environment for Compiling perl on Solaris
9043
9044 =back
9045
9046 =item RUN CONFIGURE.
9047
9048 =over 4
9049
9050 =item 64-bit perl on Solaris.
9051
9052 =item Threads in perl on Solaris.
9053
9054 =item Malloc Issues with perl on Solaris.
9055
9056 =back
9057
9058 =item MAKE PROBLEMS.
9059
9060 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
9061 relocation error:, dlopen: stub interception failed, #error "No
9062 DATAMODEL_NATIVE specified", sh: ar: not found
9063
9064 =item MAKE TEST
9065
9066 =over 4
9067
9068 =item op/stat.t test 4 in Solaris
9069
9070 =item nss_delete core dump from op/pwent or op/grent
9071
9072 =back
9073
9074 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
9075
9076 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
9077
9078 =over 4
9079
9080 =item Limits on Numbers of Open Files on Solaris.
9081
9082 =back
9083
9084 =item SOLARIS-SPECIFIC MODULES.
9085
9086 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
9087
9088 =over 4
9089
9090 =item Proc::ProcessTable on Solaris
9091
9092 =item BSD::Resource on Solaris
9093
9094 =item Net::SSLeay on Solaris
9095
9096 =back
9097
9098 =item SunOS 4.x
9099
9100 =item AUTHOR
9101
9102 =item LAST MODIFIED
9103
9104 =back
9105
9106 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
9107 Digital UNIX formerly known as DEC OSF/1) systems
9108
9109 =over 4
9110
9111 =item DESCRIPTION
9112
9113 =over 4
9114
9115 =item Compiling Perl 5 on Tru64
9116
9117 =item Using Large Files with Perl on Tru64
9118
9119 =item Threaded Perl on Tru64
9120
9121 =item Long Doubles on Tru64
9122
9123 =item DB_File tests failing on Tru64
9124
9125 =item 64-bit Perl on Tru64
9126
9127 =item Warnings about floating-point overflow when compiling Perl on Tru64
9128
9129 =back
9130
9131 =item Testing Perl on Tru64
9132
9133 =item ext/ODBM_File/odbm Test Failing With Static Builds
9134
9135 =item Perl Fails Because Of Unresolved Symbol sockatmark
9136
9137 =item AUTHOR
9138
9139 =back
9140
9141 =head2 perluts - Perl under UTS
9142
9143 =over 4
9144
9145 =item SYNOPSIS
9146
9147 =item DESCRIPTION
9148
9149 =item BUILDING PERL ON UTS
9150
9151 =item Installing the built perl on UTS
9152
9153 =item AUTHOR
9154
9155 =back
9156
9157 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
9158
9159 =over 4
9160
9161 =item SYNOPSIS
9162
9163 =item DESCRIPTION
9164
9165 =over 4
9166
9167 =item Unpacking Perl Distribution on VM/ESA
9168
9169 =item Setup Perl and utilities on VM/ESA
9170
9171 =item Configure Perl on VM/ESA
9172
9173 =item Testing Anomalies of Perl on VM/ESA
9174
9175 =item Usage Hints for Perl on VM/ESA
9176
9177 =back
9178
9179 =item AUTHORS
9180
9181 =item SEE ALSO
9182
9183 =over 4
9184
9185 =item Mailing list for Perl on VM/ESA
9186
9187 =back
9188
9189 =back
9190
9191 =head2 perlvms - VMS-specific documentation for Perl
9192
9193 =over 4
9194
9195 =item DESCRIPTION
9196
9197 =item Installation
9198
9199 =item Organization of Perl Images
9200
9201 =over 4
9202
9203 =item Core Images
9204
9205 =item Perl Extensions
9206
9207 =item Installing static extensions
9208
9209 =item Installing dynamic extensions
9210
9211 =back
9212
9213 =item File specifications
9214
9215 =over 4
9216
9217 =item Syntax
9218
9219 =item Wildcard expansion
9220
9221 =item Pipes
9222
9223 =back
9224
9225 =item PERL5LIB and PERLLIB
9226
9227 =item Command line
9228
9229 =over 4
9230
9231 =item I/O redirection and backgrounding
9232
9233 =item Command line switches
9234
9235 -i, -S, -u
9236
9237 =back
9238
9239 =item Perl functions
9240
9241 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
9242 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
9243 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
9244 LIST, waitpid PID,FLAGS
9245
9246 =item Perl variables
9247
9248 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
9249
9250 =item Standard modules with VMS-specific differences
9251
9252 =over 4
9253
9254 =item SDBM_File
9255
9256 =back
9257
9258 =item Revision date
9259
9260 =item AUTHOR
9261
9262 =back
9263
9264 =head2 perlvos, README.vos - Perl for Stratus VOS
9265
9266 =over 4
9267
9268 =item SYNOPSIS
9269
9270 =item BUILDING PERL FOR VOS
9271
9272 =item INSTALLING PERL IN VOS
9273
9274 =item USING PERL IN VOS
9275
9276 =over 4
9277
9278 =item Restrictions of Perl on VOS
9279
9280 =item Handling of underflow and overflow
9281
9282 =back
9283
9284 =item TEST STATUS
9285
9286 =item SUPPORT STATUS
9287
9288 =item AUTHOR
9289
9290 =item LAST UPDATE
9291
9292 =back
9293
9294 =head2 perlwin32 - Perl under Windows
9295
9296 =over 4
9297
9298 =item SYNOPSIS
9299
9300 =item DESCRIPTION
9301
9302 =over 4
9303
9304 =item Setting Up Perl on Win32
9305
9306 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform
9307 SDK 64-bit Compiler, MinGW32 with gcc, MinGW release 1
9308
9309 =item Building
9310
9311 =item Testing Perl on Win32
9312
9313 =item Installation of Perl on Win32
9314
9315 =item Usage Hints for Perl on Win32
9316
9317 Environment Variables, File Globbing, Using perl from the command line,
9318 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
9319 Extensions, Notes on 64-bit Windows
9320
9321 =item Running Perl Scripts
9322
9323 Miscellaneous Things
9324
9325 =back
9326
9327 =item BUGS AND CAVEATS
9328
9329 =item ACKNOWLEDGEMENTS
9330
9331 =item AUTHORS
9332
9333 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
9334 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
9335 E<lt>nick@ing-simmons.netE<gt>
9336
9337 =item SEE ALSO
9338
9339 =item HISTORY
9340
9341 =back
9342
9343 =head1 PRAGMA DOCUMENTATION
9344
9345 =head2 attrs - set/get attributes of a subroutine (deprecated)
9346
9347 =over 4
9348
9349 =item SYNOPSIS
9350
9351 =item DESCRIPTION
9352
9353 method, locked
9354
9355 =back
9356
9357 =head2 re - Perl pragma to alter regular expression behaviour
9358
9359 =over 4
9360
9361 =item SYNOPSIS
9362
9363 =item DESCRIPTION
9364
9365 =back
9366
9367 =head2 threadshared::shared, threads::shared - Perl extension for sharing
9368 data structures between threads
9369
9370 =over 4
9371
9372 =item SYNOPSIS
9373
9374 =item DESCRIPTION
9375
9376 =item EXPORT
9377
9378 =item FUNCTIONS
9379
9380 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
9381 LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
9382 ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
9383
9384 =item NOTES
9385
9386 =item BUGS
9387
9388 =item AUTHOR
9389
9390 =item SEE ALSO
9391
9392 =back
9393
9394 =head2 threads - Perl extension allowing use of interpreter based threads
9395 from perl
9396
9397 =over 4
9398
9399 =item SYNOPSIS
9400
9401 =item DESCRIPTION
9402
9403 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
9404 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
9405 threads->list();, async BLOCK;
9406
9407 =item WARNINGS
9408
9409 A thread exited while %d other threads were still running
9410
9411 =item TODO
9412
9413 =item BUGS
9414
9415 Parent-Child threads, Returning objects, Creating threads inside BEGIN
9416 blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
9417
9418 =item AUTHOR and COPYRIGHT
9419
9420 =item SEE ALSO
9421
9422 =back
9423
9424 =head2 assertions - select assertions in blocks of code
9425
9426 =over 4
9427
9428 =item SYNOPSIS
9429
9430 =item DESCRIPTION
9431
9432 =item SEE ALSO
9433
9434 =item AUTHOR
9435
9436 =item COPYRIGHT AND LICENSE
9437
9438 =back
9439
9440 =head2 assertions::activate - activate assertions
9441
9442 =over 4
9443
9444 =item SYNOPSIS
9445
9446 =item DESCRIPTION
9447
9448 =item SEE ALSO
9449
9450 =item AUTHOR
9451
9452 =item COPYRIGHT AND LICENSE
9453
9454 =back
9455
9456 =head2 attributes - get/set subroutine or variable attributes
9457
9458 =over 4
9459
9460 =item SYNOPSIS
9461
9462 =item DESCRIPTION
9463
9464 =over 4
9465
9466 =item Built-in Attributes
9467
9468 locked, method, lvalue
9469
9470 =item Available Subroutines
9471
9472 get, reftype
9473
9474 =item Package-specific Attribute Handling
9475
9476 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
9477
9478 =item Syntax of Attribute Lists
9479
9480 =back
9481
9482 =item EXPORTS
9483
9484 =over 4
9485
9486 =item Default exports
9487
9488 =item Available exports
9489
9490 =item Export tags defined
9491
9492 =back
9493
9494 =item EXAMPLES
9495
9496 =item SEE ALSO
9497
9498 =back
9499
9500 =head2 autouse - postpone load of modules until a function is used
9501
9502 =over 4
9503
9504 =item SYNOPSIS
9505
9506 =item DESCRIPTION
9507
9508 =item WARNING
9509
9510 =item AUTHOR
9511
9512 =item SEE ALSO
9513
9514 =back
9515
9516 =head2 base - Establish IS-A relationship with base classes at compile time
9517
9518 =over 4
9519
9520 =item SYNOPSIS
9521
9522 =item DESCRIPTION
9523
9524 =item HISTORY
9525
9526 =item CAVEATS
9527
9528 =item SEE ALSO
9529
9530 =back
9531
9532 =head2 bigint - Transparent BigInteger support for Perl
9533
9534 =over 4
9535
9536 =item SYNOPSIS
9537
9538 =item DESCRIPTION
9539
9540 =over 4
9541
9542 =item OPTIONS
9543
9544 a or accuracy, p or precision, t or trace, l or lib, v or version
9545
9546 =item MATH LIBRARY
9547
9548 =item INTERNAL FORMAT
9549
9550 =item SIGN
9551
9552 =item METHODS
9553
9554 =item CAVEAT
9555
9556 =back
9557
9558 =item MODULES USED
9559
9560 =item EXAMPLES
9561
9562 =item LICENSE
9563
9564 =item SEE ALSO
9565
9566 =item AUTHORS
9567
9568 =back
9569
9570 =head2 bignum - Transparent BigNumber support for Perl
9571
9572 =over 4
9573
9574 =item SYNOPSIS
9575
9576 =item DESCRIPTION
9577
9578 =over 4
9579
9580 =item OPTIONS
9581
9582 a or accuracy, p or precision, t or trace, l or lib, v or version
9583
9584 =item METHODS
9585
9586 =item CAVEAT
9587
9588 inf(), NaN(), upgrade()
9589
9590 =item MATH LIBRARY
9591
9592 =item INTERNAL FORMAT
9593
9594 =item SIGN
9595
9596 =back
9597
9598 =item MODULES USED
9599
9600 =item EXAMPLES
9601
9602 =item LICENSE
9603
9604 =item SEE ALSO
9605
9606 =item AUTHORS
9607
9608 =back
9609
9610 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
9611
9612 =over 4
9613
9614 =item SYNOPSIS
9615
9616 =item DESCRIPTION
9617
9618 =over 4
9619
9620 =item MODULES USED
9621
9622 =item MATH LIBRARY
9623
9624 =item SIGN
9625
9626 =item METHODS
9627
9628 =item CAVEAT
9629
9630 =back
9631
9632 =item EXAMPLES
9633
9634         perl -Mbigrat -le 'print sqrt(33)'
9635         perl -Mbigrat -le 'print 2*255'
9636         perl -Mbigrat -le 'print 4.5+2*255'
9637         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'       
9638         perl -Mbigrat -le 'print 12->is_odd()';
9639
9640 =item LICENSE
9641
9642 =item SEE ALSO
9643
9644 =item AUTHORS
9645
9646 =back
9647
9648 =head2 blib - Use MakeMaker's uninstalled version of a package
9649
9650 =over 4
9651
9652 =item SYNOPSIS
9653
9654 =item DESCRIPTION
9655
9656 =item BUGS
9657
9658 =item AUTHOR
9659
9660 =back
9661
9662 =head2 bytes - Perl pragma to force byte semantics rather than character
9663 semantics
9664
9665 =over 4
9666
9667 =item SYNOPSIS
9668
9669 =item DESCRIPTION
9670
9671 =item LIMITATIONS
9672
9673 =item SEE ALSO
9674
9675 =back
9676
9677 =head2 charnames - define character names for C<\N{named}> string literal
9678 escapes
9679
9680 =over 4
9681
9682 =item SYNOPSIS
9683
9684 =item DESCRIPTION
9685
9686 =item CUSTOM TRANSLATORS
9687
9688 =item CUSTOM ALIASES
9689
9690 =over 4
9691
9692 =item Anonymous hashes
9693
9694 =item Alias file
9695
9696 =item Alias shortcut
9697
9698 =back
9699
9700 =item charnames::viacode(code)
9701
9702 =item charnames::vianame(name)
9703
9704 =item ALIASES
9705
9706 =item ILLEGAL CHARACTERS
9707
9708 =item BUGS
9709
9710 =back
9711
9712 =head2 constant - Perl pragma to declare constants
9713
9714 =over 4
9715
9716 =item SYNOPSIS
9717
9718 =item DESCRIPTION
9719
9720 =item NOTES
9721
9722 =over 4
9723
9724 =item List constants
9725
9726 =item Defining multiple constants at once
9727
9728 =item Magic constants
9729
9730 =back
9731
9732 =item TECHNICAL NOTES
9733
9734 =item BUGS
9735
9736 =item AUTHOR
9737
9738 =item COPYRIGHT
9739
9740 =back
9741
9742 =head2 diagnostics, splain - produce verbose warning diagnostics
9743
9744 =over 4
9745
9746 =item SYNOPSIS
9747
9748 =item DESCRIPTION
9749
9750 =over 4
9751
9752 =item The C<diagnostics> Pragma
9753
9754 =item The I<splain> Program
9755
9756 =back
9757
9758 =item EXAMPLES
9759
9760 =item INTERNALS
9761
9762 =item BUGS
9763
9764 =item AUTHOR
9765
9766 =back
9767
9768 =head2 encoding - allows you to write your script in non-ascii or non-utf8
9769
9770 =over 4
9771
9772 =item SYNOPSIS
9773
9774 =item ABSTRACT
9775
9776 =over 4
9777
9778 =item Literal Conversions
9779
9780 =item PerlIO layers for C<STD(IN|OUT)>
9781
9782 =item Implicit upgrading for byte strings
9783
9784 =back
9785
9786 =item FEATURES THAT REQUIRE 5.8.1
9787
9788 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
9789
9790 =item USAGE
9791
9792 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
9793 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
9794
9795 =item The Filter Option
9796
9797 =over 4
9798
9799 =item Filter-related changes at Encode version 1.87
9800
9801 =back
9802
9803 =item CAVEATS
9804
9805 =over 4
9806
9807 =item NOT SCOPED
9808
9809 =item DO NOT MIX MULTIPLE ENCODINGS
9810
9811 =item tr/// with ranges
9812
9813 Legend of characters above
9814
9815 =back
9816
9817 =item EXAMPLE - Greekperl
9818
9819 =item KNOWN PROBLEMS
9820
9821 literals in regex that are longer than 127 bytes, EBCDIC, format
9822
9823 =item HISTORY
9824
9825 =item SEE ALSO
9826
9827 =back
9828
9829 =head2 fields - compile-time class fields
9830
9831 =over 4
9832
9833 =item SYNOPSIS
9834
9835 =item DESCRIPTION
9836
9837 new, phash
9838
9839 =item SEE ALSO
9840
9841 =back
9842
9843 =head2 filetest - Perl pragma to control the filetest permission operators
9844
9845 =over 4
9846
9847 =item SYNOPSIS
9848
9849 =item DESCRIPTION
9850
9851 =over 4
9852
9853 =item subpragma access
9854
9855 =back
9856
9857 =back
9858
9859 =head2 if - C<use> a Perl module if a condition holds
9860
9861 =over 4
9862
9863 =item SYNOPSIS
9864
9865 =item DESCRIPTION
9866
9867 =item BUGS
9868
9869 =item AUTHOR
9870
9871 =back
9872
9873 =head2 integer - Perl pragma to use integer arithmetic instead of floating
9874 point
9875
9876 =over 4
9877
9878 =item SYNOPSIS
9879
9880 =item DESCRIPTION
9881
9882 =back
9883
9884 =head2 less - perl pragma to request less of something from the compiler
9885
9886 =over 4
9887
9888 =item SYNOPSIS
9889
9890 =item DESCRIPTION
9891
9892 =back
9893
9894 =head2 lib - manipulate @INC at compile time
9895
9896 =over 4
9897
9898 =item SYNOPSIS
9899
9900 =item DESCRIPTION
9901
9902 =over 4
9903
9904 =item Adding directories to @INC
9905
9906 =item Deleting directories from @INC
9907
9908 =item Restoring original @INC
9909
9910 =back
9911
9912 =item CAVEATS
9913
9914 =item NOTES
9915
9916 =item SEE ALSO
9917
9918 =item AUTHOR
9919
9920 =back
9921
9922 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
9923 operations
9924
9925 =over 4
9926
9927 =item SYNOPSIS
9928
9929 =item DESCRIPTION
9930
9931 =back
9932
9933 =head2 open - perl pragma to set default PerlIO layers for input and output
9934
9935 =over 4
9936
9937 =item SYNOPSIS
9938
9939 =item DESCRIPTION
9940
9941 =item NONPERLIO FUNCTIONALITY
9942
9943 =item IMPLEMENTATION DETAILS
9944
9945 =item SEE ALSO
9946
9947 =back
9948
9949 =head2 ops - Perl pragma to restrict unsafe operations when compiling
9950
9951 =over 4
9952
9953 =item SYNOPSIS  
9954
9955 =item DESCRIPTION
9956
9957 =item SEE ALSO
9958
9959 =back
9960
9961 =head2 overload - Package for overloading perl operations
9962
9963 =over 4
9964
9965 =item SYNOPSIS
9966
9967 =item DESCRIPTION
9968
9969 =over 4
9970
9971 =item Declaration of overloaded functions
9972
9973 =item Calling Conventions for Binary Operations
9974
9975 FALSE, TRUE, C<undef>
9976
9977 =item Calling Conventions for Unary Operations
9978
9979 =item Calling Conventions for Mutators
9980
9981 C<++> and C<-->, C<x=> and other assignment versions
9982
9983 =item Overloadable Operations
9984
9985 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
9986 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
9987 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
9988
9989 =item Inheritance and overloading
9990
9991 Strings as values of C<use overload> directive, Overloading of an operation
9992 is inherited by derived classes
9993
9994 =back
9995
9996 =item SPECIAL SYMBOLS FOR C<use overload>
9997
9998 =over 4
9999
10000 =item Last Resort
10001
10002 =item Fallback
10003
10004 C<undef>, TRUE, defined, but FALSE
10005
10006 =item Copy Constructor
10007
10008 B<Example>
10009
10010 =back
10011
10012 =item MAGIC AUTOGENERATION
10013
10014 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
10015 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
10016 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
10017 I<Copy operator>
10018
10019 =item Losing overloading
10020
10021 =item Run-time Overloading
10022
10023 =item Public functions
10024
10025 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
10026
10027 =item Overloading constants
10028
10029 integer, float, binary, q, qr
10030
10031 =item IMPLEMENTATION
10032
10033 =item Metaphor clash
10034
10035 =item Cookbook
10036
10037 =over 4
10038
10039 =item Two-face scalars
10040
10041 =item Two-face references
10042
10043 =item Symbolic calculator
10044
10045 =item I<Really> symbolic calculator
10046
10047 =back
10048
10049 =item AUTHOR
10050
10051 =item DIAGNOSTICS
10052
10053 Odd number of arguments for overload::constant, `%s' is not an overloadable
10054 type, `%s' is not a code reference
10055
10056 =item BUGS
10057
10058 =back
10059
10060 =head2 sigtrap - Perl pragma to enable simple signal handling
10061
10062 =over 4
10063
10064 =item SYNOPSIS
10065
10066 =item DESCRIPTION
10067
10068 =item OPTIONS
10069
10070 =over 4
10071
10072 =item SIGNAL HANDLERS
10073
10074 B<stack-trace>, B<die>, B<handler> I<your-handler>
10075
10076 =item SIGNAL LISTS
10077
10078 B<normal-signals>, B<error-signals>, B<old-interface-signals>
10079
10080 =item OTHER
10081
10082 B<untrapped>, B<any>, I<signal>, I<number>
10083
10084 =back
10085
10086 =item EXAMPLES
10087
10088 =back
10089
10090 =head2 sort - perl pragma to control sort() behaviour
10091
10092 =over 4
10093
10094 =item SYNOPSIS
10095
10096 =item DESCRIPTION
10097
10098 =item CAVEATS
10099
10100 =back
10101
10102 =head2 strict - Perl pragma to restrict unsafe constructs
10103
10104 =over 4
10105
10106 =item SYNOPSIS
10107
10108 =item DESCRIPTION
10109
10110 C<strict refs>, C<strict vars>, C<strict subs>
10111
10112 =item HISTORY
10113
10114 =back
10115
10116 =head2 subs - Perl pragma to predeclare sub names
10117
10118 =over 4
10119
10120 =item SYNOPSIS
10121
10122 =item DESCRIPTION
10123
10124 =back
10125
10126 =head2 threadshared, threads::shared - Perl extension for sharing data
10127 structures between threads
10128
10129 =over 4
10130
10131 =item SYNOPSIS
10132
10133 =item DESCRIPTION
10134
10135 =item EXPORT
10136
10137 =item FUNCTIONS
10138
10139 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
10140 LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
10141 ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
10142
10143 =item NOTES
10144
10145 =item BUGS
10146
10147 =item AUTHOR
10148
10149 =item SEE ALSO
10150
10151 =back
10152
10153 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
10154 code
10155
10156 =over 4
10157
10158 =item SYNOPSIS
10159
10160 =item DESCRIPTION
10161
10162 =over 4
10163
10164 =item Utility functions
10165
10166 $num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[,
10167 FAIL_OK]), utf8::encode($string), utf8::decode($string), $flag =
10168 utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
10169
10170 =back
10171
10172 =item BUGS
10173
10174 =item SEE ALSO
10175
10176 =back
10177
10178 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
10179
10180 =over 4
10181
10182 =item SYNOPSIS
10183
10184 =item DESCRIPTION
10185
10186 =back
10187
10188 =head2 version - Perl extension for Version Objects
10189
10190 =over 4
10191
10192 =item SYNOPSIS
10193
10194 =item DESCRIPTION
10195
10196 =over 4
10197
10198 =item What IS a version
10199
10200 Numeric Versions, Quoted Versions
10201
10202 =item What about v-strings?
10203
10204 =item Numeric Versions
10205
10206 =item Quoted Versions
10207
10208 =item Object Methods
10209
10210 New Operator, qv(), Stringification, Numification, Comparison operators,
10211 Logical Operators
10212
10213 =item Quoting
10214
10215 =item Types of Versions Objects
10216
10217 Ordinary versions, Alpha versions
10218
10219 =item Replacement UNIVERSAL::VERSION
10220
10221 =back
10222
10223 =item EXPORT
10224
10225 =item AUTHOR
10226
10227 =item SEE ALSO
10228
10229 =back
10230
10231 =head2 vmsish - Perl pragma to control VMS-specific language features
10232
10233 =over 4
10234
10235 =item SYNOPSIS
10236
10237 =item DESCRIPTION
10238
10239 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
10240
10241 =back
10242
10243 =head2 warnings - Perl pragma to control optional warnings
10244
10245 =over 4
10246
10247 =item SYNOPSIS
10248
10249 =item DESCRIPTION
10250
10251 use warnings::register, warnings::enabled(), warnings::enabled($category),
10252 warnings::enabled($object), warnings::warn($message),
10253 warnings::warn($category, $message), warnings::warn($object, $message),
10254 warnings::warnif($message), warnings::warnif($category, $message),
10255 warnings::warnif($object, $message)
10256
10257 =back
10258
10259 =head2 warnings::register - warnings import function
10260
10261 =over 4
10262
10263 =item SYNOPSIS
10264
10265 =item DESCRIPTION
10266
10267 =back
10268
10269 =head1 MODULE DOCUMENTATION
10270
10271 =head2 AnyDBM_File - provide framework for multiple DBMs
10272
10273 =over 4
10274
10275 =item SYNOPSIS
10276
10277 =item DESCRIPTION
10278
10279 =over 4
10280
10281 =item DBM Comparisons
10282
10283 [0], [1], [2], [3]
10284
10285 =back
10286
10287 =item SEE ALSO
10288
10289 =back
10290
10291 =head2 Attribute::Handlers - Simpler definition of attribute handlers
10292
10293 =over 4
10294
10295 =item VERSION
10296
10297 =item SYNOPSIS
10298
10299 =item DESCRIPTION
10300
10301 [0], [1], [2], [3], [4], [5]
10302
10303 =over 4
10304
10305 =item Typed lexicals
10306
10307 =item Type-specific attribute handlers
10308
10309 =item Non-interpretive attribute handlers
10310
10311 =item Phase-specific attribute handlers
10312
10313 =item Attributes as C<tie> interfaces
10314
10315 =back
10316
10317 =item EXAMPLES
10318
10319 =item DIAGNOSTICS
10320
10321 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
10322 attributes>, C<Declaration of %s attribute in package %s may clash with
10323 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
10324 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
10325 be able to apply END handler>
10326
10327 =item AUTHOR
10328
10329 =item BUGS
10330
10331 =item COPYRIGHT
10332
10333 =back
10334
10335 =head2 AutoLoader - load subroutines only on demand
10336
10337 =over 4
10338
10339 =item SYNOPSIS
10340
10341 =item DESCRIPTION
10342
10343 =over 4
10344
10345 =item Subroutine Stubs
10346
10347 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
10348
10349 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
10350
10351 =item Package Lexicals
10352
10353 =item Not Using AutoLoader
10354
10355 =item B<AutoLoader> vs. B<SelfLoader>
10356
10357 =back
10358
10359 =item CAVEATS
10360
10361 =item SEE ALSO
10362
10363 =back
10364
10365 =head2 AutoSplit - split a package for autoloading
10366
10367 =over 4
10368
10369 =item SYNOPSIS
10370
10371 =item DESCRIPTION
10372
10373 $keep, $check, $modtime
10374
10375 =over 4
10376
10377 =item Multiple packages
10378
10379 =back
10380
10381 =item DIAGNOSTICS
10382
10383 =back
10384
10385 =head2 B - The Perl Compiler
10386
10387 =over 4
10388
10389 =item SYNOPSIS
10390
10391 =item DESCRIPTION
10392
10393 =item OVERVIEW
10394
10395 =item Utility Functions
10396
10397 =over 4
10398
10399 =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV>
10400 objects
10401
10402 sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av,
10403 check_av, begin_av, end_av, comppadlist, regex_padav, main_cv
10404
10405 =item Functions for Examining the Symbol Table
10406
10407 walksymtable(SYMREF, METHOD, RECURSE, PREFIX)
10408
10409 =item Functions Returning C<B::OP> objects or for walking op trees
10410
10411 main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG)
10412
10413 =item Miscellaneous Utility Functions
10414
10415 ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR),
10416 perlstring(STR), class(OBJ), threadsv_names
10417
10418 =back
10419
10420 =item OVERVIEW OF CLASSES
10421
10422 =over 4
10423
10424 =item SV-RELATED CLASSES
10425
10426 =item B::SV Methods
10427
10428 REFCNT, FLAGS, object_2svref
10429
10430 =item B::IV Methods
10431
10432 IV, IVX, UVX, int_value, needs64bits, packiv
10433
10434 =item B::NV Methods
10435
10436 NV, NVX
10437
10438 =item B::RV Methods
10439
10440 RV
10441
10442 =item B::PV Methods
10443
10444 PV, RV, PVX
10445
10446 =item B::PVMG Methods
10447
10448 MAGIC, SvSTASH
10449
10450 =item B::MAGIC Methods
10451
10452 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
10453
10454 =item B::PVLV Methods
10455
10456 TARGOFF, TARGLEN, TYPE, TARG
10457
10458 =item B::BM Methods
10459
10460 USEFUL, PREVIOUS, RARE, TABLE
10461
10462 =item B::GV Methods
10463
10464 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
10465 LINE, FILE, FILEGV, GvREFCNT, FLAGS
10466
10467 =item B::IO Methods
10468
10469 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
10470 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
10471
10472 =item B::AV Methods
10473
10474 FILL, MAX, OFF, ARRAY, ARRAYelt, AvFLAGS
10475
10476 =item B::CV Methods
10477
10478 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB,
10479 XSUBANY, CvFLAGS, const_sv
10480
10481 =item B::HV Methods
10482
10483 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
10484
10485 =item OP-RELATED CLASSES
10486
10487 =item B::OP Methods
10488
10489 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
10490
10491 =item B::UNOP METHOD
10492
10493 first
10494
10495 =item B::BINOP METHOD
10496
10497 last
10498
10499 =item B::LOGOP METHOD
10500
10501 other
10502
10503 =item B::LISTOP METHOD
10504
10505 children
10506
10507 =item B::PMOP Methods
10508
10509 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
10510 pmpermflags, precomp, pmoffset
10511
10512 =item B::SVOP METHOD
10513
10514 sv, gv
10515
10516 =item B::PADOP METHOD
10517
10518 padix
10519
10520 =item B::PVOP METHOD
10521
10522 pv
10523
10524 =item B::LOOP Methods
10525
10526 redoop, nextop, lastop
10527
10528 =item B::COP Methods
10529
10530 label, stash, stashpv, file, cop_seq, arybase, line, warnings, io
10531
10532 =back
10533
10534 =item AUTHOR
10535
10536 =back
10537
10538 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
10539 bytecode
10540
10541 =over 4
10542
10543 =item SYNOPSIS
10544
10545 =item DESCRIPTION
10546
10547 %insn_data, @insn_name, @optype, @specialsv_name
10548
10549 =item AUTHOR
10550
10551 =back
10552
10553 =head2 B::Assembler - Assemble Perl bytecode
10554
10555 =over 4
10556
10557 =item SYNOPSIS
10558
10559 =item DESCRIPTION
10560
10561 =item AUTHORS
10562
10563 =back
10564
10565 =head2 B::Bblock - Walk basic blocks
10566
10567 =over 4
10568
10569 =item SYNOPSIS
10570
10571 =item DESCRIPTION
10572
10573 =over 4
10574
10575 =item Functions
10576
10577 B<find_leaders>
10578
10579 =back
10580
10581 =item AUTHOR
10582
10583 =back
10584
10585 =head2 B::Bytecode - Perl compiler's bytecode backend
10586
10587 =over 4
10588
10589 =item SYNOPSIS
10590
10591 =item DESCRIPTION
10592
10593 =item EXAMPLE
10594
10595 =item OPTIONS
10596
10597 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
10598
10599 =item KNOWN BUGS
10600
10601 =item NOTICE
10602
10603 =item AUTHORS
10604
10605 =back
10606
10607 =head2 B::C - Perl compiler's C backend
10608
10609 =over 4
10610
10611 =item SYNOPSIS
10612
10613 =item DESCRIPTION
10614
10615 =item OPTIONS
10616
10617 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
10618 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
10619 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
10620 B<-llimit>
10621
10622 =item EXAMPLES
10623
10624 =item BUGS
10625
10626 =item AUTHOR
10627
10628 =back
10629
10630 =head2 B::CC - Perl compiler's optimized C translation backend
10631
10632 =over 4
10633
10634 =item SYNOPSIS
10635
10636 =item DESCRIPTION
10637
10638 =item OPTIONS
10639
10640 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
10641 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
10642 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
10643
10644 =item EXAMPLES
10645
10646 =item BUGS
10647
10648 =item DIFFERENCES
10649
10650 =over 4
10651
10652 =item Loops
10653
10654 =item Context of ".."
10655
10656 =item Arithmetic
10657
10658 =item Deprecated features
10659
10660 =back
10661
10662 =item AUTHOR
10663
10664 =back
10665
10666 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
10667
10668 =over 4
10669
10670 =item SYNOPSIS
10671
10672 =item DESCRIPTION
10673
10674 =item EXAMPLE
10675
10676 =item OPTIONS
10677
10678 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
10679 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
10680 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
10681
10682 =item FORMATTING SPECIFICATIONS
10683
10684 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
10685 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
10686 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
10687 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
10688 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
10689 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
10690 B<#seq>, B<#opt>, B<#static>, B<#sibaddr>, B<#svaddr>, B<#svclass>,
10691 B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
10692
10693 =item ABBREVIATIONS
10694
10695 =over 4
10696
10697 =item OP flags abbreviations
10698
10699 =item OP class abbreviations
10700
10701 =back
10702
10703 =item Using B::Concise outside of the O framework
10704
10705 =item AUTHOR
10706
10707 =back
10708
10709 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
10710
10711 =over 4
10712
10713 =item SYNOPSIS
10714
10715 =item DESCRIPTION
10716
10717 =item AUTHOR
10718
10719 =back
10720
10721 =head2 B::Deparse - Perl compiler backend to produce perl code
10722
10723 =over 4
10724
10725 =item SYNOPSIS
10726
10727 =item DESCRIPTION
10728
10729 =item OPTIONS
10730
10731 B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>,
10732 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
10733
10734 =item USING B::Deparse AS A MODULE
10735
10736 =over 4
10737
10738 =item Synopsis
10739
10740 =item Description
10741
10742 =item new
10743
10744 =item ambient_pragmas
10745
10746 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
10747
10748 =item coderef2text
10749
10750 =back
10751
10752 =item BUGS
10753
10754 =item AUTHOR
10755
10756 =back
10757
10758 =head2 B::Disassembler - Disassemble Perl bytecode
10759
10760 =over 4
10761
10762 =item SYNOPSIS
10763
10764 =item DESCRIPTION
10765
10766 =item AUTHOR
10767
10768 =back
10769
10770 =head2 B::Lint - Perl lint
10771
10772 =over 4
10773
10774 =item SYNOPSIS
10775
10776 =item DESCRIPTION
10777
10778 =item OPTIONS AND LINT CHECKS
10779
10780 B<context>, B<implicit-read> and B<implicit-write>, B<bare-subs>,
10781 B<dollar-underscore>, B<private-names>, B<undefined-subs>,
10782 B<regexp-variables>, B<all>, B<none>
10783
10784 =item NON LINT-CHECK OPTIONS
10785
10786 B<-u Package>
10787
10788 =item BUGS
10789
10790 =item AUTHOR
10791
10792 =back
10793
10794 =head2 B::O, O - Generic interface to Perl Compiler backends
10795
10796 =over 4
10797
10798 =item SYNOPSIS
10799
10800 =item DESCRIPTION
10801
10802 =item CONVENTIONS
10803
10804 =item IMPLEMENTATION
10805
10806 =item BUGS
10807
10808 =item AUTHOR
10809
10810 =back
10811
10812 =head2 B::Showlex - Show lexical variables used in functions or files
10813
10814 =over 4
10815
10816 =item SYNOPSIS
10817
10818 =item DESCRIPTION
10819
10820 =item AUTHOR
10821
10822 =back
10823
10824 =head2 B::Stackobj - Helper module for CC backend
10825
10826 =over 4
10827
10828 =item SYNOPSIS
10829
10830 =item DESCRIPTION
10831
10832 =item AUTHOR
10833
10834 =back
10835
10836 =head2 B::Stash - show what stashes are loaded
10837
10838 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
10839
10840 =over 4
10841
10842 =item SYNOPSIS
10843
10844 =item DESCRIPTION
10845
10846 =item AUTHOR
10847
10848 =back
10849
10850 =head2 B::Xref - Generates cross reference reports for Perl programs
10851
10852 =over 4
10853
10854 =item SYNOPSIS
10855
10856 =item DESCRIPTION
10857
10858 =item OPTIONS
10859
10860 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
10861
10862 =item BUGS
10863
10864 =item AUTHOR
10865
10866 =back
10867
10868 =head2 Bblock, B::Bblock - Walk basic blocks
10869
10870 =over 4
10871
10872 =item SYNOPSIS
10873
10874 =item DESCRIPTION
10875
10876 =over 4
10877
10878 =item Functions
10879
10880 B<find_leaders>
10881
10882 =back
10883
10884 =item AUTHOR
10885
10886 =back
10887
10888 =head2 Benchmark - benchmark running times of Perl code
10889
10890 =over 4
10891
10892 =item SYNOPSIS
10893
10894 =item DESCRIPTION
10895
10896 =over 4
10897
10898 =item Methods
10899
10900 new, debug, iters
10901
10902 =item Standard Exports
10903
10904 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
10905 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
10906 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
10907
10908 =item Optional Exports
10909
10910 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [
10911 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
10912 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
10913
10914 =item :hireswallclock
10915
10916 =back
10917
10918 =item NOTES
10919
10920 =item EXAMPLES
10921
10922 =item INHERITANCE
10923
10924 =item CAVEATS
10925
10926 =item SEE ALSO
10927
10928 =item AUTHORS
10929
10930 =item MODIFICATION HISTORY
10931
10932 =back
10933
10934 =head2 ByteLoader - load byte compiled perl code
10935
10936 =over 4
10937
10938 =item SYNOPSIS
10939
10940 =item DESCRIPTION
10941
10942 =item AUTHOR
10943
10944 =item SEE ALSO
10945
10946 =back
10947
10948 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
10949
10950 =over 4
10951
10952 =item SYNOPSIS
10953
10954 =item DESCRIPTION
10955
10956 =item EXAMPLE
10957
10958 =item OPTIONS
10959
10960 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
10961
10962 =item KNOWN BUGS
10963
10964 =item NOTICE
10965
10966 =item AUTHORS
10967
10968 =back
10969
10970 =head2 CGI - Simple Common Gateway Interface Class
10971
10972 =over 4
10973
10974 =item SYNOPSIS
10975
10976 =item ABSTRACT
10977
10978 =item DESCRIPTION
10979
10980 =over 4
10981
10982 =item PROGRAMMING STYLE
10983
10984 =item CALLING CGI.PM ROUTINES
10985
10986 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
10987
10988 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
10989
10990 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
10991
10992 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
10993
10994 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
10995
10996 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
10997
10998 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
10999
11000 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
11001
11002 =item DELETING A PARAMETER COMPLETELY:
11003
11004 =item DELETING ALL PARAMETERS:
11005
11006 =item DIRECT ACCESS TO THE PARAMETER LIST:
11007
11008 =item FETCHING THE PARAMETER LIST AS A HASH:
11009
11010 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
11011
11012 =item RETRIEVING CGI ERRORS
11013
11014 =item USING THE FUNCTION-ORIENTED INTERFACE
11015
11016 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
11017 B<:standard>, B<:all>
11018
11019 =item PRAGMAS
11020
11021 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
11022 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
11023 -private_tempfiles
11024
11025 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
11026
11027 1. start_table() (generates a <table> tag), 2. end_table() (generates a
11028 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
11029 a </ul> tag)
11030
11031 =back
11032
11033 =item GENERATING DYNAMIC DOCUMENTS
11034
11035 =over 4
11036
11037 =item CREATING A STANDARD HTTP HEADER:
11038
11039 =item GENERATING A REDIRECTION HEADER
11040
11041 =item CREATING THE HTML DOCUMENT HEADER
11042
11043 B<Parameters:>, 4, 5, 6..
11044
11045 =item ENDING THE HTML DOCUMENT:
11046
11047 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
11048
11049 =item OBTAINING THE SCRIPT'S URL
11050
11051 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
11052 (B<-query_string>), B<-base>
11053
11054 =item MIXING POST AND URL PARAMETERS
11055
11056 =back
11057
11058 =item CREATING STANDARD HTML ELEMENTS:
11059
11060 =over 4
11061
11062 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
11063
11064 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
11065
11066 =item HTML SHORTCUTS AND LIST INTERPOLATION
11067
11068 =item NON-STANDARD HTML SHORTCUTS
11069
11070 =item AUTOESCAPING HTML
11071
11072 $escaped_string = escapeHTML("unescaped string");, $charset =
11073 charset([$charset]);, $flag = autoEscape([$flag]);
11074
11075 =item PRETTY-PRINTING HTML
11076
11077 =back
11078
11079 =item CREATING FILL-OUT FORMS:
11080
11081 =over 4
11082
11083 =item CREATING AN ISINDEX TAG
11084
11085 =item STARTING AND ENDING A FORM
11086
11087 B<application/x-www-form-urlencoded>, B<multipart/form-data>
11088
11089 =item CREATING A TEXT FIELD
11090
11091 B<Parameters>
11092
11093 =item CREATING A BIG TEXT FIELD
11094
11095 =item CREATING A PASSWORD FIELD
11096
11097 =item CREATING A FILE UPLOAD FIELD
11098
11099 B<Parameters>
11100
11101 =item CREATING A POPUP MENU
11102
11103 =item CREATING AN OPTION GROUP
11104
11105 =item CREATING A SCROLLING LIST
11106
11107 B<Parameters:>
11108
11109 =item CREATING A GROUP OF RELATED CHECKBOXES
11110
11111 B<Parameters:>
11112
11113 =item CREATING A STANDALONE CHECKBOX
11114
11115 B<Parameters:>
11116
11117 =item CREATING A RADIO BUTTON GROUP
11118
11119 B<Parameters:>
11120
11121 =item CREATING A SUBMIT BUTTON 
11122
11123 B<Parameters:>
11124
11125 =item CREATING A RESET BUTTON
11126
11127 =item CREATING A DEFAULT BUTTON
11128
11129 =item CREATING A HIDDEN FIELD
11130
11131 B<Parameters:>
11132
11133 =item CREATING A CLICKABLE IMAGE BUTTON
11134
11135 B<Parameters:>, 3. The third option (-align, optional) is an alignment
11136 type, and may be TOP, BOTTOM or MIDDLE
11137
11138 =item CREATING A JAVASCRIPT ACTION BUTTON
11139
11140 =back
11141
11142 =item HTTP COOKIES
11143
11144 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
11145 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
11146
11147 =item WORKING WITH FRAMES
11148
11149 1. Create a <Frameset> document, 2. Specify the destination for the
11150 document in the HTTP header, 3. Specify the destination for the document in
11151 the <form> tag
11152
11153 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
11154
11155 =item DEBUGGING
11156
11157 =over 4
11158
11159 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
11160
11161 =back
11162
11163 =item FETCHING ENVIRONMENT VARIABLES
11164
11165 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
11166 B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
11167 name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
11168 ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
11169 B<virtual_port ()>, B<server_software ()>, B<remote_user ()>, B<user_name
11170 ()>, B<request_method()>, B<content_type()>, B<http()>, B<https()>
11171
11172 =item USING NPH SCRIPTS
11173
11174 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
11175 parameters
11176
11177 =item Server Push
11178
11179 multipart_init(), multipart_start(), multipart_end(), multipart_final()
11180
11181 =item Avoiding Denial of Service Attacks
11182
11183 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
11184 basis>, B<2. Globally for all scripts>
11185
11186 =item COMPATIBILITY WITH CGI-LIB.PL
11187
11188 =item AUTHOR INFORMATION
11189
11190 =item CREDITS
11191
11192 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
11193 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
11194 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
11195 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
11196 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
11197 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
11198 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
11199 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
11200 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
11201 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
11202 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
11203 ...and many many more..
11204
11205 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
11206
11207 =item BUGS
11208
11209 =item SEE ALSO
11210
11211 =back
11212
11213 =head2 CGI::Apache - Backward compatibility module for CGI.pm
11214
11215 =over 4
11216
11217 =item SYNOPSIS
11218
11219 =item ABSTRACT
11220
11221 =item DESCRIPTION
11222
11223 =item AUTHOR INFORMATION
11224
11225 =item BUGS
11226
11227 =item SEE ALSO
11228
11229 =back
11230
11231 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
11232 other) error log
11233
11234 =over 4
11235
11236 =item SYNOPSIS
11237
11238 =item DESCRIPTION
11239
11240 =item REDIRECTING ERROR MESSAGES
11241
11242 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
11243
11244 =over 4
11245
11246 =item Changing the default message
11247
11248 =back
11249
11250 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
11251
11252 =item OVERRIDING THE NAME OF THE PROGRAM
11253
11254 =item AUTHORS
11255
11256 =item SEE ALSO
11257
11258 =back
11259
11260 =head2 CGI::Cookie - Interface to Netscape Cookies
11261
11262 =over 4
11263
11264 =item SYNOPSIS
11265
11266 =item DESCRIPTION
11267
11268 =item USING CGI::Cookie
11269
11270 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
11271
11272 =over 4
11273
11274 =item Creating New Cookies
11275
11276 =item Sending the Cookie to the Browser
11277
11278 =item Recovering Previous Cookies
11279
11280 =item Manipulating Cookies
11281
11282 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
11283
11284 =back
11285
11286 =item AUTHOR INFORMATION
11287
11288 =item BUGS
11289
11290 =item SEE ALSO
11291
11292 =back
11293
11294 =head2 CGI::Fast - CGI Interface for Fast CGI
11295
11296 =over 4
11297
11298 =item SYNOPSIS
11299
11300 =item DESCRIPTION
11301
11302 =item OTHER PIECES OF THE PUZZLE
11303
11304 =item WRITING FASTCGI PERL SCRIPTS
11305
11306 =item INSTALLING FASTCGI SCRIPTS
11307
11308 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
11309
11310 =item EXTERNAL FASTCGI SERVER INVOCATION
11311
11312 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
11313
11314 =item CAVEATS
11315
11316 =item AUTHOR INFORMATION
11317
11318 =item BUGS
11319
11320 =item SEE ALSO
11321
11322 =back
11323
11324 =head2 CGI::Pretty - module to produce nicely formatted HTML code
11325
11326 =over 4
11327
11328 =item SYNOPSIS
11329
11330 =item DESCRIPTION
11331
11332 =over 4
11333
11334 =item Tags that won't be formatted
11335
11336 =item Customizing the Indenting
11337
11338 =back
11339
11340 =item BUGS
11341
11342 =item AUTHOR
11343
11344 =item SEE ALSO
11345
11346 =back
11347
11348 =head2 CGI::Push - Simple Interface to Server Push
11349
11350 =over 4
11351
11352 =item SYNOPSIS
11353
11354 =item DESCRIPTION
11355
11356 =item USING CGI::Push
11357
11358 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
11359
11360 =over 4
11361
11362 =item Heterogeneous Pages
11363
11364 =item Changing the Page Delay on the Fly
11365
11366 =back
11367
11368 =item INSTALLING CGI::Push SCRIPTS
11369
11370 =item AUTHOR INFORMATION
11371
11372 =item BUGS
11373
11374 =item SEE ALSO
11375
11376 =back
11377
11378 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
11379
11380 =over 4
11381
11382 =item SYNOPSIS
11383
11384 =item ABSTRACT
11385
11386 =item DESCRIPTION
11387
11388 =item AUTHOR INFORMATION
11389
11390 =item BUGS
11391
11392 =item SEE ALSO
11393
11394 =back
11395
11396 =head2 CGI::Util - Internal utilities used by CGI module
11397
11398 =over 4
11399
11400 =item SYNOPSIS
11401
11402 =item DESCRIPTION
11403
11404 =item AUTHOR INFORMATION
11405
11406 =item SEE ALSO
11407
11408 =back
11409
11410 =head2 CPAN - query, download and build perl modules from CPAN sites
11411
11412 =over 4
11413
11414 =item SYNOPSIS
11415
11416 =item STATUS
11417
11418 =item DESCRIPTION
11419
11420 =over 4
11421
11422 =item Interactive Mode
11423
11424 Searching for authors, bundles, distribution files and modules, make, test,
11425 install, clean  modules or distributions, get, readme, look module or
11426 distribution, ls author, Signals
11427
11428 =item CPAN::Shell
11429
11430 =item autobundle
11431
11432 =item recompile
11433
11434 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
11435
11436 =item Programmer's interface
11437
11438 expand($type,@things), expandany(@things), Programming Examples
11439
11440 =item Methods in the other Classes
11441
11442 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
11443 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
11444 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
11445 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
11446 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
11447 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
11448 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
11449 CPAN::Bundle::readme(), CPAN::Bundle::test(),
11450 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
11451 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
11452 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
11453 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
11454 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
11455 CPAN::Distribution::look(), CPAN::Distribution::make(),
11456 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
11457 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
11458 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
11459 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
11460 CPAN::Module::clean(), CPAN::Module::cpan_file(),
11461 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
11462 CPAN::Module::description(), CPAN::Module::force($method,@args),
11463 CPAN::Module::get(), CPAN::Module::inst_file(),
11464 CPAN::Module::inst_version(), CPAN::Module::install(),
11465 CPAN::Module::look(), CPAN::Module::make(),
11466 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
11467 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
11468
11469 =item Cache Manager
11470
11471 =item Bundles
11472
11473 =item Prerequisites
11474
11475 =item Finding packages and VERSION
11476
11477 =item Debugging
11478
11479 =item Floppy, Zip, Offline Mode
11480
11481 =back
11482
11483 =item CONFIGURATION
11484
11485 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
11486 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
11487 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
11488 [unshift|push|splice] E<lt>listE<gt>>
11489
11490 =over 4
11491
11492 =item Note on urllist parameter's format
11493
11494 =item urllist parameter has CD-ROM support
11495
11496 =back
11497
11498 =item SECURITY
11499
11500 =item EXPORT
11501
11502 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
11503
11504 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
11505
11506 =over 4
11507
11508 =item Three basic types of firewalls
11509
11510 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
11511
11512 =item Configuring lynx or ncftp for going through a firewall
11513
11514 =back
11515
11516 =item FAQ
11517
11518 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
11519
11520 =item BUGS
11521
11522 =item AUTHOR
11523
11524 =item TRANSLATIONS
11525
11526 =item SEE ALSO
11527
11528 =back
11529
11530 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
11531
11532 =over 4
11533
11534 =item SYNOPSIS
11535
11536 =item DESCRIPTION
11537
11538 =back
11539
11540 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
11541 module
11542
11543 =over 4
11544
11545 =item SYNOPSIS
11546
11547 =item DESCRIPTION
11548
11549 =item  SEE ALSO
11550
11551 =back
11552
11553 =head2 Carp, carp    - warn of errors (from perspective of caller)
11554
11555 =over 4
11556
11557 =item SYNOPSIS
11558
11559 =item DESCRIPTION
11560
11561 =over 4
11562
11563 =item Forcing a Stack Trace
11564
11565 =back
11566
11567 =item BUGS
11568
11569 =back
11570
11571 =head2 Carp::Heavy - heavy machinery, no user serviceable parts inside
11572
11573 =head2 Class::ISA -- report the search path for a class's ISA tree
11574
11575 =over 4
11576
11577 =item SYNOPSIS
11578
11579 =item DESCRIPTION
11580
11581 =item FUNCTIONS
11582
11583 the function Class::ISA::super_path($CLASS), the function
11584 Class::ISA::self_and_super_path($CLASS), the function
11585 Class::ISA::self_and_super_versions($CLASS)
11586
11587 =item CAUTIONARY NOTES
11588
11589 =item COPYRIGHT
11590
11591 =item AUTHOR
11592
11593 =back
11594
11595 =head2 Class::Struct - declare struct-like datatypes as Perl classes
11596
11597 =over 4
11598
11599 =item SYNOPSIS
11600
11601 =item DESCRIPTION
11602
11603 =over 4
11604
11605 =item The C<struct()> function
11606
11607 =item Class Creation at Compile Time
11608
11609 =item Element Types and Accessor Methods
11610
11611 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
11612 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
11613
11614 =item Initializing with C<new>
11615
11616 =back
11617
11618 =item EXAMPLES
11619
11620 Example 1, Example 2, Example 3
11621
11622 =item Author and Modification History
11623
11624 =back
11625
11626 =head2 Config - access Perl configuration information
11627
11628 =over 4
11629
11630 =item SYNOPSIS
11631
11632 =item DESCRIPTION
11633
11634 myconfig(), config_sh(), config_re($regex), config_vars(@names)
11635
11636 =item EXAMPLE
11637
11638 =item WARNING
11639
11640 =item GLOSSARY
11641
11642 =over 4
11643
11644 =item _
11645
11646 C<_a>, C<_exe>, C<_o>
11647
11648 =item a
11649
11650 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
11651 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
11652 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
11653 C<asctime_r_proto>, C<awk>
11654
11655 =item b
11656
11657 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
11658
11659 =item c
11660
11661 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
11662 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
11663 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
11664 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
11665 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
11666 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
11667 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
11668
11669 =item d
11670
11671 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>,
11672 C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>,
11673 C<d_bcmp>, C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>,
11674 C<d_bzero>, C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>,
11675 C<d_chroot>, C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>,
11676 C<d_const>, C<d_copysignl>, C<d_crypt>, C<d_crypt_r>, C<d_csh>,
11677 C<d_ctermid_r>, C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>,
11678 C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>, C<d_dirnamlen>, C<d_dlerror>,
11679 C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, C<d_drand48_r>, C<d_drand48proto>,
11680 C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endgrent_r>, C<d_endhent>,
11681 C<d_endhostent_r>, C<d_endnent>, C<d_endnetent_r>, C<d_endpent>,
11682 C<d_endprotoent_r>, C<d_endpwent>, C<d_endpwent_r>, C<d_endsent>,
11683 C<d_endservent_r>, C<d_eofnblk>, C<d_eunice>, C<d_faststdio>, C<d_fchdir>,
11684 C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>,
11685 C<d_fd_set>, C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>,
11686 C<d_flexfnam>, C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>,
11687 C<d_fpathconf>, C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>,
11688 C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>,
11689 C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>, C<d_ftime>,
11690 C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>,
11691 C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>,
11692 C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
11693 C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>,
11694 C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>,
11695 C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>,
11696 C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>,
11697 C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
11698 C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
11699 C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>,
11700 C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
11701 C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>,
11702 C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>,
11703 C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>,
11704 C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
11705 C<d_htonl>, C<d_ilogbl>, C<d_index>, C<d_inetaton>, C<d_int64_t>,
11706 C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>,
11707 C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>,
11708 C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>,
11709 C<d_lstat>, C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>,
11710 C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>,
11711 C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>,
11712 C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>,
11713 C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>,
11714 C<d_msg_peek>, C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>,
11715 C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>,
11716 C<d_nice>, C<d_nl_langinfo>, C<d_nv_preserves_uv>, C<d_off64_t>,
11717 C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
11718 C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
11719 C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
11720 C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
11721 C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>,
11722 C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, C<d_pthread_atfork>,
11723 C<d_pthread_attr_setscope>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
11724 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
11725 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
11726 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
11727 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
11728 C<d_sanemcmp>, C<d_sbrkproto>, C<d_scalbnl>, C<d_sched_yield>,
11729 C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>,
11730 C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>,
11731 C<d_semop>, C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>,
11732 C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>,
11733 C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>,
11734 C<d_setnent>, C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>,
11735 C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>,
11736 C<d_setpwent>, C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>,
11737 C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>,
11738 C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>,
11739 C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>,
11740 C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>,
11741 C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>,
11742 C<d_socks5_init>, C<d_sqrtl>, C<d_srand48_r>, C<d_srandom_r>,
11743 C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>,
11744 C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
11745 C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>,
11746 C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>,
11747 C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strerror_r>,
11748 C<d_strftime>, C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>,
11749 C<d_strtoq>, C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>,
11750 C<d_suidsafe>, C<d_symlink>, C<d_syscall>, C<d_syscallproto>, C<d_sysconf>,
11751 C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>,
11752 C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>,
11753 C<d_tm_tm_gmtoff>, C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>,
11754 C<d_ttyname_r>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>,
11755 C<d_uname>, C<d_union_semun>, C<d_unordered>, C<d_usleep>,
11756 C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>,
11757 C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>, C<d_void_closedir>,
11758 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
11759 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
11760 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
11761 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
11762 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
11763
11764 =item e
11765
11766 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
11767 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
11768 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
11769 C<expr>, C<extensions>, C<extras>
11770
11771 =item f
11772
11773 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
11774 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
11775 C<full_sed>
11776
11777 =item g
11778
11779 C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>,
11780 C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>,
11781 C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>,
11782 C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>,
11783 C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>,
11784 C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>,
11785 C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>,
11786 C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>,
11787 C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>,
11788 C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
11789
11790 =item h
11791
11792 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>,
11793 C<html3dir>, C<html3direxp>
11794
11795 =item i
11796
11797 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
11798 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
11799 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
11800 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
11801 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
11802 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
11803 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
11804 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
11805 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
11806 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
11807 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
11808 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
11809 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
11810 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
11811 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
11812 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
11813 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
11814 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
11815 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installhtml1dir>,
11816 C<installhtml3dir>, C<installman1dir>, C<installman3dir>, C<installprefix>,
11817 C<installprefixexp>, C<installprivlib>, C<installscript>,
11818 C<installsitearch>, C<installsitebin>, C<installsitehtml1dir>,
11819 C<installsitehtml3dir>, C<installsitelib>, C<installsiteman1dir>,
11820 C<installsiteman3dir>, C<installsitescript>, C<installstyle>,
11821 C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>,
11822 C<installvendorhtml1dir>, C<installvendorhtml3dir>, C<installvendorlib>,
11823 C<installvendorman1dir>, C<installvendorman3dir>, C<installvendorscript>,
11824 C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
11825
11826 =item k
11827
11828 C<known_extensions>, C<ksh>
11829
11830 =item l
11831
11832 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
11833 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
11834 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
11835 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
11836 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
11837 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
11838 C<lseektype>
11839
11840 =item m
11841
11842 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
11843 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
11844 C<man3direxp>, C<man3ext>
11845
11846 =item M
11847
11848 C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>,
11849 C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>,
11850 C<myuname>
11851
11852 =item n
11853
11854 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
11855 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
11856 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
11857 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
11858 C<nvsize>, C<nvtype>
11859
11860 =item o
11861
11862 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
11863 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
11864
11865 =item p
11866
11867 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
11868 C<perl>, C<perl_patchlevel>
11869
11870 =item P
11871
11872 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
11873 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
11874 C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>, C<privlibexp>,
11875 C<procselfexe>, C<prototype>, C<ptrsize>
11876
11877 =item q
11878
11879 C<quadkind>, C<quadtype>
11880
11881 =item r
11882
11883 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
11884 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
11885 C<rmail>, C<run>, C<runnm>
11886
11887 =item s
11888
11889 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
11890 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
11891 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
11892 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
11893 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
11894 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
11895 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
11896 C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>,
11897 C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>,
11898 C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>,
11899 C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>,
11900 C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>,
11901 C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>,
11902 C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>,
11903 C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>,
11904 C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>,
11905 C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>,
11906 C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>,
11907 C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>,
11908 C<submit>, C<subversion>, C<sysman>
11909
11910 =item t
11911
11912 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
11913 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
11914 C<ttyname_r_proto>
11915
11916 =item u
11917
11918 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
11919 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
11920 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
11921 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>,
11922 C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemorebits>,
11923 C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>,
11924 C<useposix>, C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>,
11925 C<usethreads>, C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>,
11926 C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>,
11927 C<uvXUformat>
11928
11929 =item v
11930
11931 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
11932 C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>,
11933 C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>,
11934 C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>,
11935 C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>,
11936 C<vendorscriptexp>, C<version>, C<version_patchlevel_string>,
11937 C<versiononly>, C<vi>, C<voidflags>
11938
11939 =item x
11940
11941 C<xlibpth>
11942
11943 =item y
11944
11945 C<yacc>, C<yaccflags>
11946
11947 =item z
11948
11949 C<zcat>, C<zip>
11950
11951 =back
11952
11953 =item NOTE
11954
11955 =back
11956
11957 =head2 Cwd - get pathname of current working directory
11958
11959 =over 4
11960
11961 =item SYNOPSIS
11962
11963 =item DESCRIPTION
11964
11965 =over 4
11966
11967 =item getcwd and friends
11968
11969 getcwd, cwd, fastcwd, fastgetcwd
11970
11971 =item abs_path and friends
11972
11973 abs_path, realpath, fast_abs_path
11974
11975 =item $ENV{PWD}
11976
11977 =back
11978
11979 =item NOTES
11980
11981 =item AUTHOR
11982
11983 =item SEE ALSO
11984
11985 =back
11986
11987 =head2 DB - programmatic interface to the Perl debugging API (draft,
11988 subject to
11989 change)
11990
11991 =over 4
11992
11993 =item SYNOPSIS
11994
11995 =item DESCRIPTION
11996
11997 =over 4
11998
11999 =item Global Variables
12000
12001  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args, 
12002 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname, 
12003 $DB::lineno
12004
12005 =item API Methods
12006
12007 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
12008 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
12009
12010 =item Client Callback Methods
12011
12012 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
12013 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
12014 CLIENT->output(LIST)
12015
12016 =back
12017
12018 =item BUGS
12019
12020 =item AUTHOR
12021
12022 =back
12023
12024 =head2 DBM_Filter -- Filter DBM keys/values 
12025
12026 =over 4
12027
12028 =item SYNOPSIS
12029
12030 =item DESCRIPTION
12031
12032 =item What is a DBM Filter?
12033
12034 =over 4
12035
12036 =item So what's new?
12037
12038 =back
12039
12040 =item METHODS
12041
12042 =over 4
12043
12044 =item $db->Filter_Push()
12045
12046 =item $db->Filter_Key_Push()
12047
12048 =item $db->Filter_Value_Push()
12049
12050 Filter_Push, Filter_Key_Push, Filter_Value_Push
12051
12052 =item $db->Filter_Pop()
12053
12054 =item $db->Filtered()
12055
12056 =back
12057
12058 =item Writing a Filter
12059
12060 =over 4
12061
12062 =item Immediate Filters
12063
12064 =item Canned Filters
12065
12066 "name", params
12067
12068 =back
12069
12070 =item Filters Included
12071
12072 utf8, encode, compress, int32, null
12073
12074 =item NOTES
12075
12076 =over 4
12077
12078 =item Maintain Round Trip Integrity
12079
12080 =item Don't mix filtered & non-filtered data in the same database file. 
12081
12082 =back
12083
12084 =item EXAMPLE
12085
12086 =item SEE ALSO
12087
12088 =item AUTHOR
12089
12090 =back
12091
12092 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
12093
12094 =over 4
12095
12096 =item SYNOPSIS
12097
12098 =item DESCRIPTION
12099
12100 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
12101
12102 =over 4
12103
12104 =item Using DB_File with Berkeley DB version 2 or greater
12105
12106 =item Interface to Berkeley DB
12107
12108 =item Opening a Berkeley DB Database File
12109
12110 =item Default Parameters
12111
12112 =item In Memory Databases
12113
12114 =back
12115
12116 =item DB_HASH
12117
12118 =over 4
12119
12120 =item A Simple Example
12121
12122 =back
12123
12124 =item DB_BTREE
12125
12126 =over 4
12127
12128 =item Changing the BTREE sort order
12129
12130 =item Handling Duplicate Keys 
12131
12132 =item The get_dup() Method
12133
12134 =item The find_dup() Method
12135
12136 =item The del_dup() Method
12137
12138 =item Matching Partial Keys 
12139
12140 =back
12141
12142 =item DB_RECNO
12143
12144 =over 4
12145
12146 =item The 'bval' Option
12147
12148 =item A Simple Example
12149
12150 =item Extra RECNO Methods
12151
12152 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
12153 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
12154 length, elements);>
12155
12156 =item Another Example
12157
12158 =back
12159
12160 =item THE API INTERFACE
12161
12162 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
12163 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
12164 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
12165 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
12166
12167 =item DBM FILTERS
12168
12169 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
12170 B<filter_fetch_value>
12171
12172 =over 4
12173
12174 =item The Filter
12175
12176 =item An Example -- the NULL termination problem.
12177
12178 =item Another Example -- Key is a C int.
12179
12180 =back
12181
12182 =item HINTS AND TIPS 
12183
12184 =over 4
12185
12186 =item Locking: The Trouble with fd
12187
12188 =item Safe ways to lock a database
12189
12190 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
12191
12192 =item Sharing Databases With C Applications
12193
12194 =item The untie() Gotcha
12195
12196 =back
12197
12198 =item COMMON QUESTIONS
12199
12200 =over 4
12201
12202 =item Why is there Perl source in my database?
12203
12204 =item How do I store complex data structures with DB_File?
12205
12206 =item What does "Invalid Argument" mean?
12207
12208 =item What does "Bareword 'DB_File' not allowed" mean? 
12209
12210 =back
12211
12212 =item REFERENCES
12213
12214 =item HISTORY
12215
12216 =item BUGS
12217
12218 =item AVAILABILITY
12219
12220 =item COPYRIGHT
12221
12222 =item SEE ALSO
12223
12224 =item AUTHOR
12225
12226 =back
12227
12228 =head2 Data::Dumper - stringified perl data structures, suitable for both
12229 printing and C<eval>
12230
12231 =over 4
12232
12233 =item SYNOPSIS
12234
12235 =item DESCRIPTION
12236
12237 =over 4
12238
12239 =item Methods
12240
12241 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or> 
12242 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
12243 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
12244 I<$OBJ>->Reset
12245
12246 =item Functions
12247
12248 Dumper(I<LIST>)
12249
12250 =item Configuration Variables or Methods
12251
12252 =item Exports
12253
12254 Dumper
12255
12256 =back
12257
12258 =item EXAMPLES
12259
12260 =item BUGS
12261
12262 =over 4
12263
12264 =item NOTE
12265
12266 =back
12267
12268 =item AUTHOR
12269
12270 =item VERSION
12271
12272 =item SEE ALSO
12273
12274 =back
12275
12276 =head2 Devel::DProf - a Perl code profiler
12277
12278 =over 4
12279
12280 =item SYNOPSIS
12281
12282 =item DESCRIPTION
12283
12284 =item PROFILE FORMAT
12285
12286 =item AUTOLOAD
12287
12288 =item ENVIRONMENT
12289
12290 =item BUGS
12291
12292 =item SEE ALSO
12293
12294 =back
12295
12296 =head2 Devel::PPPort - Perl/Pollution/Portability
12297
12298 =over 4
12299
12300 =item SYNOPSIS
12301
12302 =item DESCRIPTION
12303
12304 =over 4
12305
12306 =item WriteFile
12307
12308 =back
12309
12310 =item ppport.h
12311
12312 =item AUTHOR
12313
12314 =item SEE ALSO
12315
12316 =back
12317
12318 =head2 Devel::Peek - A data debugging tool for the XS programmer
12319
12320 =over 4
12321
12322 =item SYNOPSIS
12323
12324 =item DESCRIPTION
12325
12326 =over 4
12327
12328 =item Runtime debugging
12329
12330 =item Memory footprint debugging
12331
12332 =back
12333
12334 =item EXAMPLES
12335
12336 =over 4
12337
12338 =item A simple scalar string
12339
12340 =item A simple scalar number
12341
12342 =item A simple scalar with an extra reference
12343
12344 =item A reference to a simple scalar
12345
12346 =item A reference to an array
12347
12348 =item A reference to a hash
12349
12350 =item Dumping a large array or hash
12351
12352 =item A reference to an SV which holds a C pointer
12353
12354 =item A reference to a subroutine
12355
12356 =back
12357
12358 =item EXPORTS
12359
12360 =item BUGS
12361
12362 =item AUTHOR
12363
12364 =item SEE ALSO
12365
12366 =back
12367
12368 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
12369
12370 =over 4
12371
12372 =item SYNOPSIS
12373
12374 =item DESCRIPTION
12375
12376 =back
12377
12378 =head2 Digest - Modules that calculate message digests
12379
12380 =over 4
12381
12382 =item SYNOPSIS
12383
12384 =item DESCRIPTION
12385
12386 I<binary>, I<hex>, I<base64>
12387
12388 =item OO INTERFACE
12389
12390 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
12391 Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset,
12392 $ctx->add( $data, ... ), $ctx->addfile( $io_handle ), $ctx->add_bits(
12393 $data, $nbits ), $ctx->add_bits( $bitstring ), $ctx->digest,
12394 $ctx->hexdigest, $ctx->b64digest
12395
12396 =item Digest speed
12397
12398 =item SEE ALSO
12399
12400 =item AUTHOR
12401
12402 =back
12403
12404 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
12405
12406 =over 4
12407
12408 =item SYNOPSIS
12409
12410 =item DESCRIPTION
12411
12412 =item FUNCTIONS
12413
12414 md5($data,...), md5_hex($data,...), md5_base64($data,...)
12415
12416 =item METHODS
12417
12418 $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...),
12419 $md5->addfile($io_handle), $md5->add_bits($data, $nbits),
12420 $md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest
12421
12422 =item EXAMPLES
12423
12424 =item SEE ALSO
12425
12426 =item COPYRIGHT
12427
12428 =item AUTHORS
12429
12430 =back
12431
12432 =head2 Digest::base - Digest base class
12433
12434 =over 4
12435
12436 =item SYNPOSIS
12437
12438 =item DESCRIPTION
12439
12440 =item SEE ALSO
12441
12442 =back
12443
12444 =head2 DirHandle - supply object methods for directory handles
12445
12446 =over 4
12447
12448 =item SYNOPSIS
12449
12450 =item DESCRIPTION
12451
12452 =item NOTES
12453
12454 =back
12455
12456 =head2 Dumpvalue - provides screen dump of Perl data.
12457
12458 =over 4
12459
12460 =item SYNOPSIS
12461
12462 =item DESCRIPTION
12463
12464 =over 4
12465
12466 =item Creation
12467
12468 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
12469 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
12470 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
12471 stopDbSignal
12472
12473 =item Methods
12474
12475 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
12476 compactDump, veryCompact, set, get
12477
12478 =back
12479
12480 =back
12481
12482 =head2 DynaLoader - Dynamically load C libraries into Perl code
12483
12484 =over 4
12485
12486 =item SYNOPSIS
12487
12488 =item DESCRIPTION
12489
12490 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
12491 @dl_modules, @dl_shared_objects, dl_error(), $dl_debug, dl_findfile(),
12492 dl_expandspec(), dl_load_file(), dl_unload_file(), dl_load_flags(),
12493 dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(),
12494 dl_install_xsub(), bootstrap()
12495
12496 =item AUTHOR
12497
12498 =back
12499
12500 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
12501 Perl code
12502
12503 =over 4
12504
12505 =item SYNOPSIS
12506
12507 =item DESCRIPTION
12508
12509 =over 4
12510
12511 =item Migration from C<DynaLoader>
12512
12513 =item Backward compatible boilerplate
12514
12515 =back
12516
12517 =item Order of initialization: early load()
12518
12519 =over 4
12520
12521 =item The most hairy case
12522
12523 =back
12524
12525 =item LIMITATIONS
12526
12527 =item AUTHOR
12528
12529 =back
12530
12531 =head2 Encode - character encodings
12532
12533 =over 4
12534
12535 =item SYNOPSIS
12536
12537 =over 4
12538
12539 =item Table of Contents
12540
12541 =back
12542
12543 =item DESCRIPTION
12544
12545 =over 4
12546
12547 =item TERMINOLOGY
12548
12549 =back
12550
12551 =item PERL ENCODING API
12552
12553 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
12554 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
12555 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
12556 CHECK]);
12557
12558 =over 4
12559
12560 =item Listing available encodings
12561
12562 =item Defining Aliases
12563
12564 =back
12565
12566 =item Encoding via PerlIO
12567
12568 =item Handling Malformed Data
12569
12570 I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
12571 I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
12572 (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
12573 Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
12574 bitmask
12575
12576 =over 4
12577
12578 =item Unimplemented fallback schemes
12579
12580 =back
12581
12582 =item Defining Encodings
12583
12584 =item The UTF-8 flag
12585
12586 Goal #1:, Goal #2:, Goal #3:, Goal #4:
12587
12588 =over 4
12589
12590 =item Messing with Perl's Internals
12591
12592 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
12593
12594 =back
12595
12596 =item SEE ALSO
12597
12598 =item MAINTAINER
12599
12600 =back
12601
12602 =head2 Encode::Alias - alias definitions to encodings
12603
12604 =over 4
12605
12606 =item SYNOPSIS
12607
12608 =item DESCRIPTION
12609
12610 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
12611 reference, e.g.:
12612
12613 =over 4
12614
12615 =item Alias overloading
12616
12617 =back
12618
12619 =item SEE ALSO
12620
12621 =back
12622
12623 =head2 Encode::Byte - Single Byte Encodings
12624
12625 =over 4
12626
12627 =item SYNOPSIS
12628
12629 =item ABSTRACT
12630
12631 =item DESCRIPTION
12632
12633 =item SEE ALSO
12634
12635 =back
12636
12637 =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
12638
12639 =head2 Encode::CN - China-based Chinese Encodings
12640
12641 =over 4
12642
12643 =item SYNOPSIS
12644
12645 =item DESCRIPTION
12646
12647 =item NOTES
12648
12649 =item BUGS
12650
12651 =item SEE ALSO
12652
12653 =back
12654
12655 =head2 Encode::CN::HZ -- internally used by Encode::CN
12656
12657 =head2 Encode::Config -- internally used by Encode
12658
12659 =head2 Encode::EBCDIC - EBCDIC Encodings
12660
12661 =over 4
12662
12663 =item SYNOPSIS
12664
12665 =item ABSTRACT
12666
12667 =item DESCRIPTION
12668
12669 =item SEE ALSO
12670
12671 =back
12672
12673 =head2 Encode::Encoding - Encode Implementation Base Class
12674
12675 =over 4
12676
12677 =item SYNOPSIS
12678
12679 =item DESCRIPTION
12680
12681 =over 4
12682
12683 =item Methods you should implement
12684
12685 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
12686 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
12687
12688 =item Other methods defined in Encode::Encodings
12689
12690 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
12691
12692 =item Example: Encode::ROT13
12693
12694 =back
12695
12696 =item Why the heck Encode API is different?
12697
12698 =over 4
12699
12700 =item Compiled Encodings
12701
12702 =back
12703
12704 =item SEE ALSO
12705
12706 Scheme 1, Scheme 2, Other Schemes
12707
12708 =back
12709
12710 =head2 Encode::Guess -- Guesses encoding from data
12711
12712 =over 4
12713
12714 =item SYNOPSIS
12715
12716 =item ABSTRACT
12717
12718 =item DESCRIPTION
12719
12720 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
12721 Encode::decode("Guess" ...), Encode::Guess->guess($data),
12722 guess_encoding($data, [, I<list of suspects>])
12723
12724 =item CAVEATS
12725
12726 =item TO DO
12727
12728 =item SEE ALSO
12729
12730 =back
12731
12732 =head2 Encode::JP - Japanese Encodings
12733
12734 =over 4
12735
12736 =item SYNOPSIS
12737
12738 =item ABSTRACT
12739
12740 =item DESCRIPTION
12741
12742 =item Note on ISO-2022-JP(-1)?
12743
12744 =item BUGS
12745
12746 =item SEE ALSO
12747
12748 =back
12749
12750 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
12751
12752 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
12753
12754 =head2 Encode::KR - Korean Encodings
12755
12756 =over 4
12757
12758 =item SYNOPSIS
12759
12760 =item DESCRIPTION
12761
12762 =item BUGS
12763
12764 =item SEE ALSO
12765
12766 =back
12767
12768 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
12769
12770 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
12771
12772 =over 4
12773
12774 =item SYNOPSIS
12775
12776 =item ABSTRACT
12777
12778 =item DESCRIPTION
12779
12780 =item BUGS
12781
12782 =item SEE ALSO
12783
12784 =back
12785
12786 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
12787
12788 =over 4
12789
12790 =item Overview
12791
12792 =item How does it work?
12793
12794 =item Line Buffering
12795
12796 =over 4
12797
12798 =item How can I tell whether my encoding fully supports PerlIO ?
12799
12800 =back
12801
12802 =item SEE ALSO
12803
12804 =back
12805
12806 =head2 Encode::Supported -- Encodings supported by Encode
12807
12808 =over 4
12809
12810 =item DESCRIPTION
12811
12812 =over 4
12813
12814 =item Encoding Names
12815
12816 =back
12817
12818 =item Supported Encodings
12819
12820 =over 4
12821
12822 =item Built-in Encodings
12823
12824 =item Encode::Unicode -- other Unicode encodings
12825
12826 =item Encode::Byte -- Extended ASCII
12827
12828 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
12829 the Cyrillic world, gsm0338 - Hentai Latin 1
12830
12831 =item CJK: Chinese, Japanese, Korean (Multibyte)
12832
12833 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
12834 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
12835 Encode::JIS2K -- JIS X 0213 encodings via CPAN
12836
12837 =item Miscellaneous encodings
12838
12839 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
12840
12841 =back
12842
12843 =item Unsupported encodings
12844
12845   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
12846 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
12847 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
12848 Various Mac encodings, (Mac) Indic encodings
12849
12850 =item Encoding vs. Charset -- terminology
12851
12852 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
12853
12854 =over 4
12855
12856 =item Microsoft-related naming mess
12857
12858 KS_C_5601-1987, GB2312, Big5, Shift_JIS
12859
12860 =back
12861
12862 =item Glossary
12863
12864 character repertoire, coded character set (CCS), character encoding scheme
12865 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
12866 UTF-16
12867
12868 =item See Also
12869
12870 =item References
12871
12872 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
12873 RFC, UC, Unicode Glossary
12874
12875 =over 4
12876
12877 =item Other Notable Sites
12878
12879 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
12880 "Introduction to i18n"
12881
12882 =item Offline sources
12883
12884 C<CJKV Information Processing> by Ken Lunde
12885
12886 =back
12887
12888 =back
12889
12890 =head2 Encode::Symbol - Symbol Encodings
12891
12892 =over 4
12893
12894 =item SYNOPSIS
12895
12896 =item ABSTRACT
12897
12898 =item DESCRIPTION
12899
12900 =item SEE ALSO
12901
12902 =back
12903
12904 =head2 Encode::TW - Taiwan-based Chinese Encodings
12905
12906 =over 4
12907
12908 =item SYNOPSIS
12909
12910 =item DESCRIPTION
12911
12912 =item NOTES
12913
12914 =item BUGS
12915
12916 =item SEE ALSO
12917
12918 =back
12919
12920 =head2 Encode::Unicode -- Various Unicode Transformation Formats
12921
12922 =over 4
12923
12924 =item SYNOPSIS
12925
12926 =item ABSTRACT
12927
12928 L<http://www.unicode.org/glossary/> says:, Quick Reference
12929
12930 =item Size, Endianness, and BOM
12931
12932 =over 4
12933
12934 =item by size
12935
12936 =item by endianness
12937
12938 BOM as integer when fetched in network byte order
12939
12940 =back
12941
12942 =item Surrogate Pairs
12943
12944 =item SEE ALSO
12945
12946 =back
12947
12948 =head2 Encode::Unicode::UTF7 -- UTF-7 encoding
12949
12950 =over 4
12951
12952 =item SYNOPSIS
12953
12954 =item ABSTRACT
12955
12956 =item In Practice
12957
12958 =item SEE ALSO
12959
12960 =back
12961
12962 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
12963 encodings
12964
12965 =over 4
12966
12967 =item SYNOPSIS
12968
12969 =item DESCRIPTION
12970
12971 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
12972 reference, e.g.:
12973
12974 =over 4
12975
12976 =item Alias overloading
12977
12978 =back
12979
12980 =item SEE ALSO
12981
12982 =back
12983
12984 =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm --
12985 Internally used by Encode::??::ISO_2022_*
12986
12987 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
12988 Encode::CN
12989
12990 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
12991 Encode
12992
12993 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
12994 Implementation Base Class
12995
12996 =over 4
12997
12998 =item SYNOPSIS
12999
13000 =item DESCRIPTION
13001
13002 =over 4
13003
13004 =item Methods you should implement
13005
13006 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
13007 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
13008
13009 =item Other methods defined in Encode::Encodings
13010
13011 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
13012
13013 =item Example: Encode::ROT13
13014
13015 =back
13016
13017 =item Why the heck Encode API is different?
13018
13019 =over 4
13020
13021 =item Compiled Encodings
13022
13023 =back
13024
13025 =item SEE ALSO
13026
13027 Scheme 1, Scheme 2, Other Schemes
13028
13029 =back
13030
13031 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
13032 data
13033
13034 =over 4
13035
13036 =item SYNOPSIS
13037
13038 =item ABSTRACT
13039
13040 =item DESCRIPTION
13041
13042 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
13043 Encode::decode("Guess" ...), Encode::Guess->guess($data),
13044 guess_encoding($data, [, I<list of suspects>])
13045
13046 =item CAVEATS
13047
13048 =item TO DO
13049
13050 =item SEE ALSO
13051
13052 =back
13053
13054 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
13055 Encode::JP::2022_JP*
13056
13057 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
13058 by Encode::JP
13059
13060 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
13061 used by Encode::KR
13062
13063 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
13064 and 'Q' header encoding
13065
13066 =over 4
13067
13068 =item SYNOPSIS
13069
13070 =item ABSTRACT
13071
13072 =item DESCRIPTION
13073
13074 =item BUGS
13075
13076 =item SEE ALSO
13077
13078 =back
13079
13080 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
13081 on Encode and PerlIO
13082
13083 =over 4
13084
13085 =item Overview
13086
13087 =item How does it work?
13088
13089 =item Line Buffering
13090
13091 =over 4
13092
13093 =item How can I tell whether my encoding fully supports PerlIO ?
13094
13095 =back
13096
13097 =item SEE ALSO
13098
13099 =back
13100
13101 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
13102 supported by Encode
13103
13104 =over 4
13105
13106 =item DESCRIPTION
13107
13108 =over 4
13109
13110 =item Encoding Names
13111
13112 =back
13113
13114 =item Supported Encodings
13115
13116 =over 4
13117
13118 =item Built-in Encodings
13119
13120 =item Encode::Unicode -- other Unicode encodings
13121
13122 =item Encode::Byte -- Extended ASCII
13123
13124 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
13125 the Cyrillic world, gsm0338 - Hentai Latin 1
13126
13127 =item CJK: Chinese, Japanese, Korean (Multibyte)
13128
13129 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
13130 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
13131 Encode::JIS2K -- JIS X 0213 encodings via CPAN
13132
13133 =item Miscellaneous encodings
13134
13135 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
13136
13137 =back
13138
13139 =item Unsupported encodings
13140
13141   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
13142 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
13143 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
13144 Various Mac encodings, (Mac) Indic encodings
13145
13146 =item Encoding vs. Charset -- terminology
13147
13148 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
13149
13150 =over 4
13151
13152 =item Microsoft-related naming mess
13153
13154 KS_C_5601-1987, GB2312, Big5, Shift_JIS
13155
13156 =back
13157
13158 =item Glossary
13159
13160 character repertoire, coded character set (CCS), character encoding scheme
13161 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
13162 UTF-16
13163
13164 =item See Also
13165
13166 =item References
13167
13168 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
13169 RFC, UC, Unicode Glossary
13170
13171 =over 4
13172
13173 =item Other Notable Sites
13174
13175 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
13176 "Introduction to i18n"
13177
13178 =item Offline sources
13179
13180 C<CJKV Information Processing> by Ken Lunde
13181
13182 =back
13183
13184 =back
13185
13186 =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7
13187 encoding
13188
13189 =over 4
13190
13191 =item SYNOPSIS
13192
13193 =item ABSTRACT
13194
13195 =item In Practice
13196
13197 =item SEE ALSO
13198
13199 =back
13200
13201 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
13202
13203 =over 4
13204
13205 =item SYNOPSIS
13206
13207 =item ABSTRACT
13208
13209 =item Description
13210
13211 =over 4
13212
13213 =item Predefined Methods
13214
13215 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
13216 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
13217 $e-E<gt>bytes([$encoding])
13218
13219 =item Example: base64 transcoder
13220
13221 =item Operator Overloading
13222
13223 =back
13224
13225 =item SEE ALSO
13226
13227 =back
13228
13229 =head2 Encodencoding, encoding - allows you to write your script in
13230 non-ascii or non-utf8
13231
13232 =over 4
13233
13234 =item SYNOPSIS
13235
13236 =item ABSTRACT
13237
13238 =over 4
13239
13240 =item Literal Conversions
13241
13242 =item PerlIO layers for C<STD(IN|OUT)>
13243
13244 =item Implicit upgrading for byte strings
13245
13246 =back
13247
13248 =item FEATURES THAT REQUIRE 5.8.1
13249
13250 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
13251
13252 =item USAGE
13253
13254 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
13255 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
13256
13257 =item The Filter Option
13258
13259 =over 4
13260
13261 =item Filter-related changes at Encode version 1.87
13262
13263 =back
13264
13265 =item CAVEATS
13266
13267 =over 4
13268
13269 =item NOT SCOPED
13270
13271 =item DO NOT MIX MULTIPLE ENCODINGS
13272
13273 =item tr/// with ranges
13274
13275 Legend of characters above
13276
13277 =back
13278
13279 =item EXAMPLE - Greekperl
13280
13281 =item KNOWN PROBLEMS
13282
13283 literals in regex that are longer than 127 bytes, EBCDIC, format
13284
13285 =item HISTORY
13286
13287 =item SEE ALSO
13288
13289 =back
13290
13291 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
13292
13293 =over 4
13294
13295 =item SYNOPSIS
13296
13297 =item ABSTRACT
13298
13299 =item Description
13300
13301 =over 4
13302
13303 =item Predefined Methods
13304
13305 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
13306 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
13307 $e-E<gt>bytes([$encoding])
13308
13309 =item Example: base64 transcoder
13310
13311 =item Operator Overloading
13312
13313 =back
13314
13315 =item SEE ALSO
13316
13317 =back
13318
13319 =head2 English - use nice English (or awk) names for ugly punctuation
13320 variables
13321
13322 =over 4
13323
13324 =item SYNOPSIS
13325
13326 =item DESCRIPTION
13327
13328 =item PERFORMANCE
13329
13330 =back
13331
13332 =head2 Env - perl module that imports environment variables as scalars or
13333 arrays
13334
13335 =over 4
13336
13337 =item SYNOPSIS
13338
13339 =item DESCRIPTION
13340
13341 =item LIMITATIONS
13342
13343 =item AUTHOR
13344
13345 =back
13346
13347 =head2 Errno - System errno constants
13348
13349 =over 4
13350
13351 =item SYNOPSIS
13352
13353 =item DESCRIPTION
13354
13355 =item CAVEATS
13356
13357 =item AUTHOR
13358
13359 =item COPYRIGHT
13360
13361 =back
13362
13363 =head2 Exporter - Implements default import method for modules
13364
13365 =over 4
13366
13367 =item SYNOPSIS
13368
13369 =item DESCRIPTION
13370
13371 =over 4
13372
13373 =item How to Export
13374
13375 =item Selecting What To Export
13376
13377 =item How to Import
13378
13379 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
13380
13381 =back
13382
13383 =item Advanced features
13384
13385 =over 4
13386
13387 =item Specialised Import Lists
13388
13389 =item Exporting without using Exporter's import method
13390
13391 =item Exporting without inheriting from Exporter
13392
13393 =item Module Version Checking
13394
13395 =item Managing Unknown Symbols
13396
13397 =item Tag Handling Utility Functions
13398
13399 =item Generating combined tags
13400
13401 =item C<AUTOLOAD>ed Constants
13402
13403 =back
13404
13405 =back
13406
13407 =head2 Exporter::Heavy - Exporter guts
13408
13409 =over 4
13410
13411 =item SYNOPSIS
13412
13413 =item DESCRIPTION
13414
13415 =back
13416
13417 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
13418 Makefiles etc.
13419
13420 =over 4
13421
13422 =item SYNOPSIS
13423
13424 =item DESCRIPTION
13425
13426 =back
13427
13428 cat
13429
13430 eqtime src dst
13431
13432 rm_rf files...
13433
13434 rm_f files...
13435
13436 touch files ..
13437
13438 mv source... destination
13439
13440 cp source... destination
13441
13442 chmod mode files..
13443
13444 mkpath directory..
13445
13446 test_f file
13447
13448 dos2unix
13449
13450 =over 4
13451
13452 =item BUGS
13453
13454 =item SEE ALSO 
13455
13456 =item AUTHOR
13457
13458 =back
13459
13460 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
13461
13462 =over 4
13463
13464 =item SYNOPSIS
13465
13466 =item DESCRIPTION
13467
13468 B<test_harness>
13469
13470 =back
13471
13472 B<pod2man>
13473
13474 B<warn_if_old_packlist>
13475
13476 B<perllocal_install>
13477
13478 B<uninstall>
13479
13480 =head2 ExtUtils::Constant - generate XS code to import C header constants
13481
13482 =over 4
13483
13484 =item SYNOPSIS
13485
13486 =item DESCRIPTION
13487
13488 =item USAGE
13489
13490 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
13491
13492 =item FUNCTIONS
13493
13494 =back
13495
13496 C_stringify NAME
13497
13498 perl_stringify NAME
13499
13500 constant_types
13501
13502 memEQ_clause NAME, CHECKED_AT, INDENT
13503
13504 assign INDENT, TYPE, PRE, POST, VALUE..
13505
13506 return_clause
13507
13508 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
13509
13510 params WHAT
13511
13512 dump_names
13513
13514 dogfood
13515
13516 C_constant, name, type, value, macro, default, pre, post, def_pre =item
13517 def_post, utf8
13518
13519 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
13520
13521 autoload PACKAGE, VERSION, AUTOLOADER
13522
13523 WriteMakefileSnippet
13524
13525 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
13526 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
13527
13528 =over 4
13529
13530 =item AUTHOR
13531
13532 =back
13533
13534 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
13535
13536 =over 4
13537
13538 =item SYNOPSIS
13539
13540 =item DESCRIPTION
13541
13542 =item @EXPORT
13543
13544 =item FUNCTIONS
13545
13546 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
13547 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
13548
13549 =item EXAMPLES
13550
13551 =item SEE ALSO
13552
13553 =item AUTHOR
13554
13555 =back
13556
13557 =head2 ExtUtils::Install - install files from here to there
13558
13559 =over 4
13560
13561 =item SYNOPSIS
13562
13563 =item DESCRIPTION
13564
13565 =over 4
13566
13567 =item Functions
13568
13569 B<install>
13570
13571 =back
13572
13573 =back
13574
13575 B<install_default> I<DISCOURAGED>
13576
13577 B<uninstall>
13578
13579 B<pm_to_blib>
13580
13581 _autosplit
13582
13583 =over 4
13584
13585 =item ENVIRONMENT
13586
13587 B<PERL_INSTALL_ROOT>
13588
13589 =item AUTHOR
13590
13591 =item LICENSE
13592
13593 =back
13594
13595 =head2 ExtUtils::Installed - Inventory management of installed modules
13596
13597 =over 4
13598
13599 =item SYNOPSIS
13600
13601 =item DESCRIPTION
13602
13603 =item USAGE
13604
13605 =item FUNCTIONS
13606
13607 new(), modules(), files(), directories(), directory_tree(), validate(),
13608 packlist(), version()
13609
13610 =item EXAMPLE
13611
13612 =item AUTHOR
13613
13614 =back
13615
13616 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
13617
13618 =over 4
13619
13620 =item SYNOPSIS
13621
13622 =item DESCRIPTION
13623
13624 For static extensions, For dynamic extensions at build/link time, For
13625 dynamic extensions at load time
13626
13627 =over 4
13628
13629 =item EXTRALIBS
13630
13631 =item LDLOADLIBS and LD_RUN_PATH
13632
13633 =item BSLOADLIBS
13634
13635 =back
13636
13637 =item PORTABILITY
13638
13639 =over 4
13640
13641 =item VMS implementation
13642
13643 =item Win32 implementation
13644
13645 =back
13646
13647 =item SEE ALSO
13648
13649 =back
13650
13651 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
13652
13653 =over 4
13654
13655 =item SYNOPSIS
13656
13657 =item DESCRIPTION
13658
13659 =back
13660
13661 =head2 ExtUtils::MM_Any - Platform-agnostic MM methods
13662
13663 =over 4
13664
13665 =item SYNOPSIS
13666
13667 =item DESCRIPTION
13668
13669 =item Inherently Cross-Platform Methods
13670
13671 installvars
13672
13673 =back
13674
13675 os_flavor_is
13676
13677 blibdirs_target (o)
13678
13679 =over 4
13680
13681 =item File::Spec wrappers
13682
13683 catfile
13684
13685 =back
13686
13687 =over 4
13688
13689 =item Thought To Be Cross-Platform Methods
13690
13691 B<split_command>
13692
13693 =back
13694
13695 B<echo>
13696
13697 init_VERSION
13698
13699 wraplist
13700
13701 manifypods
13702
13703 manifypods_target
13704
13705 makemakerdflt_target
13706
13707 special_targets
13708
13709 POD2MAN_macro
13710
13711 test_via_harness
13712
13713 test_via_script
13714
13715 libscan
13716
13717 tool_autosplit
13718
13719 all_target
13720
13721 metafile_target
13722
13723 signature_target
13724
13725 metafile_addtomanifest_target
13726
13727 signature_addtomanifest_target
13728
13729 =over 4
13730
13731 =item Abstract methods
13732
13733 oneliner, B<quote_literal>, B<escape_newlines>, max_exec_len,
13734 B<init_others>, init_DIRFILESEP, init_linker, init_platform,
13735 platform_constants
13736
13737 =back
13738
13739 os_flavor
13740
13741 =over 4
13742
13743 =item AUTHOR
13744
13745 =back
13746
13747 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
13748 ExtUtils::MakeMaker
13749
13750 =over 4
13751
13752 =item SYNOPSIS
13753
13754 =item DESCRIPTION
13755
13756 =back
13757
13758 os_flavor (o)
13759
13760 init_linker
13761
13762 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
13763 ExtUtils::MakeMaker
13764
13765 =over 4
13766
13767 =item SYNOPSIS
13768
13769 =item DESCRIPTION
13770
13771 os_flavor (o)
13772
13773 =back
13774
13775 cflags (o)
13776
13777 replace_manpage_separator (o)
13778
13779 init_linker
13780
13781 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
13782
13783 =over 4
13784
13785 =item SYNOPSIS
13786
13787 =item DESCRIPTION
13788
13789 =over 4
13790
13791 =item Overridden methods
13792
13793 os_flavor
13794
13795 =back
13796
13797 =back
13798
13799 B<replace_manpage_separator>
13800
13801 =over 4
13802
13803 =item AUTHOR
13804
13805 =item SEE ALSO
13806
13807 =back
13808
13809 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
13810 ExtUtils::MakeMaker
13811
13812 =over 4
13813
13814 =item SYNOPSIS
13815
13816 =item DESCRIPTION
13817
13818 =back
13819
13820 maybe_command
13821
13822 guess_name
13823
13824 macify
13825
13826 patternify
13827
13828 init_main
13829
13830 init_others
13831
13832 init_platform, platform_constants
13833
13834 init_dirscan
13835
13836 init_VERSION (o)
13837
13838 special_targets (o)
13839
13840 static (o)
13841
13842 dlsyms (o)
13843
13844 dynamic (o)
13845
13846 clean (o)
13847
13848 clean_subdirs_target
13849
13850 realclean (o)
13851
13852 realclean_subdirs_target
13853
13854 rulez (o)
13855
13856 processPL (o)
13857
13858 os_flavor
13859
13860 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
13861 ExtUtils::MakeMaker
13862
13863 =over 4
13864
13865 =item SYNOPSIS
13866
13867 =item DESCRIPTION
13868
13869 =back
13870
13871 os_flavor
13872
13873 init_platform (o), platform_constants
13874
13875 const_cccmd (o)
13876
13877 static_lib (o)
13878
13879 dynamic_lib (o)
13880
13881 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
13882 ExtUtils::MakeMaker
13883
13884 =over 4
13885
13886 =item SYNOPSIS
13887
13888 =item DESCRIPTION
13889
13890 =item METHODS
13891
13892 init_dist (o)
13893
13894 =back
13895
13896 init_linker
13897
13898 os_flavor
13899
13900 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
13901
13902 =over 4
13903
13904 =item SYNOPSIS
13905
13906 =item DESCRIPTION
13907
13908 =over 4
13909
13910 =item Overridden methods
13911
13912 os_flavor
13913
13914 =back
13915
13916 =back
13917
13918 B<replace_manpage_separator>
13919
13920 =over 4
13921
13922 =item AUTHOR
13923
13924 =item SEE ALSO
13925
13926 =back
13927
13928 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
13929
13930 =over 4
13931
13932 =item SYNOPSIS
13933
13934 =item DESCRIPTION
13935
13936 =item METHODS
13937
13938 =back
13939
13940 =over 4
13941
13942 =item Methods
13943
13944 os_flavor (o)
13945
13946 =back
13947
13948 c_o (o)
13949
13950 cflags (o)
13951
13952 clean (o)
13953
13954 clean_subdirs_target
13955
13956 const_cccmd (o)
13957
13958 const_config (o)
13959
13960 const_loadlibs (o)
13961
13962 constants (o)
13963
13964 depend (o)
13965
13966 dir_target B<DEPRECATED>
13967
13968 init_DEST
13969
13970 init_dist
13971
13972 dist (o)
13973
13974 dist_basics (o)
13975
13976 dist_ci (o)
13977
13978 dist_core (o)
13979
13980 B<dist_target>
13981
13982 B<tardist_target>
13983
13984 B<zipdist_target>
13985
13986 B<tarfile_target>
13987
13988 zipfile_target
13989
13990 uutardist_target
13991
13992 shdist_target
13993
13994 distdir
13995
13996 dist_test
13997
13998 dlsyms (o)
13999
14000 dynamic (o)
14001
14002 dynamic_bs (o)
14003
14004 dynamic_lib (o)
14005
14006 exescan
14007
14008 extliblist
14009
14010 find_perl
14011
14012 find_tests
14013
14014 =over 4
14015
14016 =item Methods to actually produce chunks of text for the Makefile
14017
14018 fixin
14019
14020 =back
14021
14022 force (o)
14023
14024 guess_name
14025
14026 has_link_code
14027
14028 init_dirscan
14029
14030 init_DIRFILESEP
14031
14032 init_main
14033
14034 init_others
14035
14036 init_INST
14037
14038 init_INSTALL
14039
14040 init_linker
14041
14042 init_lib2arch
14043
14044 init_PERL
14045
14046 init_platform (o), platform_constants (o)
14047
14048 init_PERM
14049
14050 init_xs
14051
14052 install (o)
14053
14054 installbin (o)
14055
14056 linkext (o)
14057
14058 lsdir
14059
14060 macro (o)
14061
14062 makeaperl (o)
14063
14064 makefile (o)
14065
14066 maybe_command
14067
14068 needs_linking (o)
14069
14070 nicetext
14071
14072 parse_abstract
14073
14074 parse_version
14075
14076 pasthru (o)
14077
14078 perl_script
14079
14080 perldepend (o)
14081
14082 perm_rw (o)
14083
14084 perm_rwx (o)
14085
14086 pm_to_blib
14087
14088 post_constants (o)
14089
14090 post_initialize (o)
14091
14092 postamble (o)
14093
14094 ppd
14095
14096 prefixify
14097
14098 processPL (o)
14099
14100 quote_paren
14101
14102 realclean (o)
14103
14104 realclean_subdirs_target
14105
14106 replace_manpage_separator
14107
14108 oneliner (o)
14109
14110 quote_literal
14111
14112 escape_newlines
14113
14114 max_exec_len
14115
14116 static (o)
14117
14118 static_lib (o)
14119
14120 staticmake (o)
14121
14122 subdir_x (o)
14123
14124 subdirs (o)
14125
14126 test (o)
14127
14128 test_via_harness (override)
14129
14130 test_via_script (override)
14131
14132 tools_other (o)
14133
14134 tool_xsubpp (o)
14135
14136 all_target
14137
14138 top_targets (o)
14139
14140 writedoc
14141
14142 xs_c (o)
14143
14144 xs_cpp (o)
14145
14146 xs_o (o)
14147
14148 =over 4
14149
14150 =item SEE ALSO
14151
14152 =back
14153
14154 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
14155 ExtUtils::MakeMaker
14156
14157 =over 4
14158
14159 =item SYNOPSIS
14160
14161 =item DESCRIPTION
14162
14163 =over 4
14164
14165 =item Methods always loaded
14166
14167 wraplist
14168
14169 =back
14170
14171 =back
14172
14173 =over 4
14174
14175 =item Methods
14176
14177 guess_name (override)
14178
14179 =back
14180
14181 find_perl (override)
14182
14183 maybe_command (override)
14184
14185 perl_script (override)
14186
14187 replace_manpage_separator
14188
14189 init_DEST
14190
14191 init_DIRFILESEP
14192
14193 init_main (override)
14194
14195 init_others (override)
14196
14197 init_platform (override)
14198
14199 platform_constants
14200
14201 init_VERSION (override)
14202
14203 constants (override)
14204
14205 special_targets
14206
14207 cflags (override)
14208
14209 const_cccmd (override)
14210
14211 tool_sxubpp (override)
14212
14213 tools_other (override)
14214
14215 init_dist (override)
14216
14217 c_o (override)
14218
14219 xs_c (override)
14220
14221 xs_o (override)
14222
14223 dlsyms (override)
14224
14225 dynamic_lib (override)
14226
14227 dynamic_bs (override)
14228
14229 static_lib (override)
14230
14231 processPL (override)
14232
14233 installbin (override)
14234
14235 subdir_x (override)
14236
14237 clean (override)
14238
14239 clean_subdirs_target
14240
14241 realclean (override)
14242
14243 zipfile_target (o), tarfile_target (o), shdist_target (o)
14244
14245 dist_test (override)
14246
14247 install (override)
14248
14249 perldepend (override)
14250
14251 makefile (override)
14252
14253 find_tests (override)
14254
14255 test (override)
14256
14257 makeaperl (override)
14258
14259 nicetext (override)
14260
14261 prefixify (override)
14262
14263 oneliner (o)
14264
14265 B<echo> (o)
14266
14267 quote_literal
14268
14269 escape_newlines
14270
14271 max_exec_len
14272
14273 init_linker (o)
14274
14275 eliminate_macros
14276
14277 fixpath
14278
14279 os_flavor
14280
14281 blibdirs_target (override)
14282
14283 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
14284 ExtUtils::MakeMaker
14285
14286 =over 4
14287
14288 =item SYNOPSIS
14289
14290 =item DESCRIPTION
14291
14292 =back
14293
14294 =over 4
14295
14296 =item Overridden methods
14297
14298 B<dlsyms>
14299
14300 =back
14301
14302 replace_manpage_separator
14303
14304 B<maybe_command>
14305
14306 B<find_tests>
14307
14308 B<init_DIRFILESEP>
14309
14310 B<init_others>
14311
14312 init_platform (o), platform_constants (o)
14313
14314 special_targets (o)
14315
14316 static_lib (o)
14317
14318 dynamic_lib (o)
14319
14320 clean
14321
14322 init_linker
14323
14324 perl_script
14325
14326 xs_o (o)
14327
14328 pasthru (o)
14329
14330 oneliner (o)
14331
14332 max_exec_len
14333
14334 os_flavor
14335
14336 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
14337
14338 =over 4
14339
14340 =item SYNOPSIS
14341
14342 =item DESCRIPTION
14343
14344 =over 4
14345
14346 =item Overriden methods
14347
14348 dist_test
14349
14350 =back
14351
14352 =back
14353
14354 subdir_x
14355
14356 xs_c
14357
14358 xs_cpp
14359
14360 xs_o
14361
14362 clean_subdirs_target
14363
14364 realclean_subdirs_target
14365
14366 max_exec_len
14367
14368 os_flavor
14369
14370 =over 4
14371
14372 =item AUTHOR
14373
14374 =back
14375
14376 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
14377
14378 =over 4
14379
14380 =item SYNOPSIS
14381
14382 =item DESCRIPTION
14383
14384 =back
14385
14386 =head2 ExtUtils::MakeMaker - Create a module Makefile
14387
14388 =over 4
14389
14390 =item SYNOPSIS
14391
14392 =item DESCRIPTION
14393
14394 =over 4
14395
14396 =item How To Write A Makefile.PL
14397
14398 =item Default Makefile Behaviour
14399
14400 =item make test
14401
14402 =item make testdb
14403
14404 =item make install
14405
14406 =item PREFIX and LIB attribute
14407
14408 =item AFS users
14409
14410 =item Static Linking of a new Perl Binary
14411
14412 =item Determination of Perl Library and Installation Locations
14413
14414 =item Which architecture dependent directory?
14415
14416 =item Using Attributes and Parameters
14417
14418 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
14419 CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS,
14420 EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN,
14421 FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB,
14422 INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
14423 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB,
14424 INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLVENDORARCH,
14425 INSTALLVENDORBIN, INSTALLVENDORLIB, INSTALLVENDORMAN1DIR,
14426 INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR,
14427 INST_MAN3DIR, INST_SCRIPT, LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS,
14428 LINKTYPE, MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET,
14429 MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT,
14430 OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB,
14431 PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW,
14432 PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
14433 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT,
14434 PRINT_PREREQ, SITEPREFIX, SIGN, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST,
14435 VERSION, VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION
14436
14437 =item Additional lowercase attributes
14438
14439 clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean,
14440 test, tool_autosplit
14441
14442 =item Overriding MakeMaker Methods
14443
14444 =item The End Of Cargo Cult Programming
14445
14446 C<<MAN3PODS => ' '>>
14447
14448 =item Hintsfile support
14449
14450 =item Distribution Support
14451
14452    make distcheck,    make skipcheck,    make distclean,    make manifest, 
14453   make distdir,   make disttest,    make tardist,    make dist,    make
14454 uutardist,    make shdist,    make zipdist,    make ci
14455
14456 =item Module Meta-Data
14457
14458 =item Disabling an extension
14459
14460 =item Other Handy Functions
14461
14462 prompt
14463
14464 =back
14465
14466 =item ENVIRONMENT
14467
14468 PERL_MM_OPT, PERL_MM_USE_DEFAULT
14469
14470 =item SEE ALSO
14471
14472 =item AUTHORS
14473
14474 =item LICENSE
14475
14476 =back
14477
14478 =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About
14479 MakeMaker
14480
14481 =over 4
14482
14483 =item DESCRIPTION
14484
14485 =over 4
14486
14487 =item Module Installation
14488
14489 How do I keep from installing man pages?, How do I use a module without
14490 installing it?
14491
14492 =item Philosophy and History
14493
14494 Why not just use <insert other build config tool here>?, What is
14495 Module::Build and how does it relate to MakeMaker?, pure perl.  no make, no
14496 shell commands, easier to customize, cleaner internals, less cruft
14497
14498 =item Module Writing
14499
14500 How do I keep my $VERSION up to date without resetting it manually?, What's
14501 this F<META.yml> thing and how did it get in my F<MANIFEST>?!
14502
14503 =item XS
14504
14505 How to I prevent "object version X.XX does not match bootstrap parameter
14506 Y.YY" errors?, How do I make two or more XS files coexist in the same
14507 directory?
14508
14509 =back
14510
14511 =item PATCHING
14512
14513 =item AUTHOR
14514
14515 =item SEE ALSO
14516
14517 =back
14518
14519 =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker
14520
14521 =over 4
14522
14523 =item SYNOPSIS
14524
14525 =item DESCRIPTION
14526
14527 =over 4
14528
14529 =item The Mantra
14530
14531 =item The Layout
14532
14533 Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP,
14534 bin/
14535
14536 =back
14537
14538 =item SEE ALSO
14539
14540 =back
14541
14542 =head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm
14543
14544 =over 4
14545
14546 =item SYNOPSIS
14547
14548 =item DESCRIPTION
14549
14550 =back
14551
14552 =head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm
14553
14554 =over 4
14555
14556 =item SYNOPSIS
14557
14558 =item DESCRIPTION
14559
14560 =back
14561
14562 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
14563
14564 =over 4
14565
14566 =item SYNOPSIS
14567
14568 =item DESCRIPTION
14569
14570 =over 4
14571
14572 =item Functions
14573
14574 mkmanifest
14575
14576 =back
14577
14578 =back
14579
14580 manifind
14581
14582 manicheck
14583
14584 filecheck
14585
14586 fullcheck
14587
14588 skipcheck
14589
14590 maniread
14591
14592 manicopy
14593
14594 maniadd
14595
14596 =over 4
14597
14598 =item MANIFEST
14599
14600 =item MANIFEST.SKIP
14601
14602 =item EXPORT_OK
14603
14604 =item GLOBAL VARIABLES
14605
14606 =back
14607
14608 =over 4
14609
14610 =item DIAGNOSTICS
14611
14612 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
14613 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
14614
14615 =item ENVIRONMENT
14616
14617 B<PERL_MM_MANIFEST_DEBUG>
14618
14619 =item SEE ALSO
14620
14621 =item AUTHOR
14622
14623 =back
14624
14625 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
14626
14627 =over 4
14628
14629 =item SYNOPSIS
14630
14631 =item DESCRIPTION
14632
14633 =item SEE ALSO
14634
14635 =back
14636
14637 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
14638
14639 =over 4
14640
14641 =item SYNOPSIS
14642
14643 =item DESCRIPTION
14644
14645 =back
14646
14647 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
14648 extension
14649
14650 =over 4
14651
14652 =item SYNOPSIS
14653
14654 =item DESCRIPTION
14655
14656 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
14657
14658 =item AUTHOR
14659
14660 =item REVISION
14661
14662 =back
14663
14664 =head2 ExtUtils::Packlist - manage .packlist files
14665
14666 =over 4
14667
14668 =item SYNOPSIS
14669
14670 =item DESCRIPTION
14671
14672 =item USAGE
14673
14674 =item FUNCTIONS
14675
14676 new(), read(), write(), validate(), packlist_file()
14677
14678 =item EXAMPLE
14679
14680 =item AUTHOR
14681
14682 =back
14683
14684 =head2 ExtUtils::testlib - add blib/* directories to @INC
14685
14686 =over 4
14687
14688 =item SYNOPSIS
14689
14690 =item DESCRIPTION
14691
14692 =back
14693
14694 =head2 Fatal - replace functions with equivalents which succeed or die
14695
14696 =over 4
14697
14698 =item SYNOPSIS
14699
14700 =item DESCRIPTION
14701
14702 =item AUTHOR
14703
14704 =back
14705
14706 =head2 Fcntl - load the C Fcntl.h defines
14707
14708 =over 4
14709
14710 =item SYNOPSIS
14711
14712 =item DESCRIPTION
14713
14714 =item NOTE
14715
14716 =item EXPORTED SYMBOLS
14717
14718 =back
14719
14720 =head2 File::Basename, fileparse - split a pathname into pieces
14721
14722 =over 4
14723
14724 =item SYNOPSIS
14725
14726 =item DESCRIPTION
14727
14728 fileparse_set_fstype, fileparse
14729
14730 =item EXAMPLES
14731
14732 C<basename>, C<dirname>
14733
14734 =back
14735
14736 =head2 File::CheckTree, validate - run many filetest checks on a tree
14737
14738 =over 4
14739
14740 =item SYNOPSIS
14741
14742 =item DESCRIPTION
14743
14744 =item AUTHOR
14745
14746 =item HISTORY
14747
14748 =back
14749
14750 =head2 File::Compare - Compare files or filehandles
14751
14752 =over 4
14753
14754 =item SYNOPSIS
14755
14756 =item DESCRIPTION
14757
14758 =item RETURN
14759
14760 =item AUTHOR
14761
14762 =back
14763
14764 =head2 File::Copy - Copy files or filehandles
14765
14766 =over 4
14767
14768 =item SYNOPSIS
14769
14770 =item DESCRIPTION
14771
14772 =over 4
14773
14774 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
14775
14776 rmscopy($from,$to[,$date_flag])
14777
14778 =back
14779
14780 =item RETURN
14781
14782 =item NOTES
14783
14784 =item AUTHOR
14785
14786 =back
14787
14788 =head2 File::DosGlob - DOS like globbing and then some
14789
14790 =over 4
14791
14792 =item SYNOPSIS
14793
14794 =item DESCRIPTION
14795
14796 =item NOTES
14797
14798 =item EXPORTS (by request only)
14799
14800 =item BUGS
14801
14802 =item AUTHOR
14803
14804 =item HISTORY
14805
14806 =item SEE ALSO
14807
14808 =back
14809
14810 =head2 File::Find - Traverse a directory tree.
14811
14812 =over 4
14813
14814 =item SYNOPSIS
14815
14816 =item DESCRIPTION
14817
14818 B<find>, B<finddepth>
14819
14820 =over 4
14821
14822 =item %options
14823
14824 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
14825 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
14826 C<untaint>, C<untaint_pattern>, C<untaint_skip>
14827
14828 =item The wanted function
14829
14830 C<$File::Find::dir> is the current directory name,, C<$_> is the current
14831 filename within that directory, C<$File::Find::name> is the complete
14832 pathname to the file
14833
14834 =back
14835
14836 =item WARNINGS
14837
14838 =item CAVEAT
14839
14840 $dont_use_nlink, symlinks
14841
14842 =item NOTES
14843
14844 =item BUGS AND CAVEATS
14845
14846 =item HISTORY
14847
14848 =back
14849
14850 =head2 File::Glob - Perl extension for BSD glob routine
14851
14852 =over 4
14853
14854 =item SYNOPSIS
14855
14856 =item DESCRIPTION
14857
14858 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
14859 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
14860 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
14861
14862 =item DIAGNOSTICS
14863
14864 C<GLOB_NOSPACE>, C<GLOB_ABEND>
14865
14866 =item NOTES
14867
14868 =item AUTHOR
14869
14870 =back
14871
14872 =head2 File::Path - create or remove directory trees
14873
14874 =over 4
14875
14876 =item SYNOPSIS
14877
14878 =item DESCRIPTION
14879
14880 =item DIAGNOSTICS
14881
14882 =item AUTHORS
14883
14884 =back
14885
14886 =head2 File::Spec - portably perform operations on file names
14887
14888 =over 4
14889
14890 =item SYNOPSIS
14891
14892 =item DESCRIPTION
14893
14894 =item METHODS
14895
14896 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
14897 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
14898 splitdir, catpath(), abs2rel, rel2abs()
14899
14900 =item SEE ALSO
14901
14902 =item AUTHORS
14903
14904 =back
14905
14906 =head2 File::Spec::Cygwin - methods for Cygwin file specs
14907
14908 =over 4
14909
14910 =item SYNOPSIS
14911
14912 =item DESCRIPTION
14913
14914 =back
14915
14916 canonpath
14917
14918 file_name_is_absolute
14919
14920 tmpdir (override)
14921
14922 =head2 File::Spec::Epoc - methods for Epoc file specs
14923
14924 =over 4
14925
14926 =item SYNOPSIS
14927
14928 =item DESCRIPTION
14929
14930 =item AUTHORS
14931
14932 =back
14933
14934 canonpath()
14935
14936 =over 4
14937
14938 =item SEE ALSO
14939
14940 =back
14941
14942 =head2 File::Spec::Functions - portably perform operations on file names
14943
14944 =over 4
14945
14946 =item SYNOPSIS
14947
14948 =item DESCRIPTION
14949
14950 =over 4
14951
14952 =item Exports
14953
14954 =back
14955
14956 =item SEE ALSO
14957
14958 =back
14959
14960 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
14961
14962 =over 4
14963
14964 =item SYNOPSIS
14965
14966 =item DESCRIPTION
14967
14968 =item METHODS
14969
14970 canonpath
14971
14972 =back
14973
14974 catdir()
14975
14976 catfile
14977
14978 curdir
14979
14980 devnull
14981
14982 rootdir
14983
14984 tmpdir
14985
14986 updir
14987
14988 file_name_is_absolute
14989
14990 path
14991
14992 splitpath
14993
14994 splitdir
14995
14996 catpath
14997
14998 abs2rel
14999
15000 rel2abs
15001
15002 =over 4
15003
15004 =item AUTHORS
15005
15006 =item SEE ALSO
15007
15008 =back
15009
15010 =head2 File::Spec::OS2 - methods for OS/2 file specs
15011
15012 =over 4
15013
15014 =item SYNOPSIS
15015
15016 =item DESCRIPTION
15017
15018 tmpdir, splitpath
15019
15020 =back
15021
15022 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
15023 modules
15024
15025 =over 4
15026
15027 =item SYNOPSIS
15028
15029 =item DESCRIPTION
15030
15031 =item METHODS
15032
15033 canonpath()
15034
15035 =back
15036
15037 catdir()
15038
15039 catfile
15040
15041 curdir
15042
15043 devnull
15044
15045 rootdir
15046
15047 tmpdir
15048
15049 updir
15050
15051 no_upwards
15052
15053 case_tolerant
15054
15055 file_name_is_absolute
15056
15057 path
15058
15059 join
15060
15061 splitpath
15062
15063 splitdir
15064
15065 catpath()
15066
15067 abs2rel
15068
15069 rel2abs()
15070
15071 =over 4
15072
15073 =item SEE ALSO
15074
15075 =back
15076
15077 =head2 File::Spec::VMS - methods for VMS file specs
15078
15079 =over 4
15080
15081 =item SYNOPSIS
15082
15083 =item DESCRIPTION
15084
15085 eliminate_macros
15086
15087 =back
15088
15089 fixpath
15090
15091 =over 4
15092
15093 =item Methods always loaded
15094
15095 canonpath (override)
15096
15097 =back
15098
15099 catdir
15100
15101 catfile
15102
15103 curdir (override)
15104
15105 devnull (override)
15106
15107 rootdir (override)
15108
15109 tmpdir (override)
15110
15111 updir (override)
15112
15113 case_tolerant (override)
15114
15115 path (override)
15116
15117 file_name_is_absolute (override)
15118
15119 splitpath (override)
15120
15121 splitdir (override)
15122
15123 catpath (override)
15124
15125 abs2rel (override)
15126
15127 rel2abs (override)
15128
15129 =over 4
15130
15131 =item SEE ALSO
15132
15133 =back
15134
15135 =head2 File::Spec::Win32 - methods for Win32 file specs
15136
15137 =over 4
15138
15139 =item SYNOPSIS
15140
15141 =item DESCRIPTION
15142
15143 devnull
15144
15145 =back
15146
15147 tmpdir
15148
15149 catfile
15150
15151 canonpath
15152
15153 splitpath
15154
15155 splitdir
15156
15157 catpath
15158
15159 =over 4
15160
15161 =item Note For File::Spec::Win32 Maintainers
15162
15163 =back
15164
15165 =over 4
15166
15167 =item SEE ALSO
15168
15169 =back
15170
15171 =head2 File::Temp - return name and handle of a temporary file safely
15172
15173 =over 4
15174
15175 =item PORTABILITY
15176
15177 =item SYNOPSIS
15178
15179 =item DESCRIPTION
15180
15181 =back
15182
15183 =over 4
15184
15185 =item OO INTERFACE
15186
15187 B<new>
15188
15189 =back
15190
15191 B<filename>
15192
15193 B<DESTROY>
15194
15195 =over 4
15196
15197 =item FUNCTIONS
15198
15199 B<tempfile>
15200
15201 =back
15202
15203 B<tempdir>
15204
15205 =over 4
15206
15207 =item MKTEMP FUNCTIONS
15208
15209 B<mkstemp>
15210
15211 =back
15212
15213 B<mkstemps>
15214
15215 B<mkdtemp>
15216
15217 B<mktemp>
15218
15219 =over 4
15220
15221 =item POSIX FUNCTIONS
15222
15223 B<tmpnam>
15224
15225 =back
15226
15227 B<tmpfile>
15228
15229 =over 4
15230
15231 =item ADDITIONAL FUNCTIONS
15232
15233 B<tempnam>
15234
15235 =back
15236
15237 =over 4
15238
15239 =item UTILITY FUNCTIONS
15240
15241 B<unlink0>
15242
15243 =back
15244
15245 B<cmpstat>
15246
15247 B<unlink1>
15248
15249 =over 4
15250
15251 =item PACKAGE VARIABLES
15252
15253 B<safe_level>, STANDARD, MEDIUM, HIGH
15254
15255 =back
15256
15257 TopSystemUID
15258
15259 =over 4
15260
15261 =item WARNING
15262
15263 =over 4
15264
15265 =item Temporary files and NFS
15266
15267 =back
15268
15269 =item HISTORY
15270
15271 =item SEE ALSO
15272
15273 =item AUTHOR
15274
15275 =back
15276
15277 =head2 File::stat - by-name interface to Perl's built-in stat() functions
15278
15279 =over 4
15280
15281 =item SYNOPSIS
15282
15283 =item DESCRIPTION
15284
15285 =item BUGS
15286
15287 =item NOTE
15288
15289 =item AUTHOR
15290
15291 =back
15292
15293 =head2 FileCache - keep more files open than the system permits
15294
15295 =over 4
15296
15297 =item SYNOPSIS
15298
15299 =item DESCRIPTION
15300
15301 cacheout EXPR, cacheout MODE, EXPR
15302
15303 =item CAVEATS
15304
15305 =item BUGS
15306
15307 =item NOTES
15308
15309 =back
15310
15311 =head2 FileHandle - supply object methods for filehandles
15312
15313 =over 4
15314
15315 =item SYNOPSIS
15316
15317 =item DESCRIPTION
15318
15319 $fh->print, $fh->printf, $fh->getline, $fh->getlines
15320
15321 =item SEE ALSO
15322
15323 =back
15324
15325 =head2 Filter::Simple - Simplified source filtering
15326
15327 =over 4
15328
15329 =item SYNOPSIS
15330
15331 =item DESCRIPTION
15332
15333 =over 4
15334
15335 =item The Problem
15336
15337 =item A Solution
15338
15339 =item Disabling or changing <no> behaviour
15340
15341 =item All-in-one interface
15342
15343 =item Filtering only specific components of source code
15344
15345 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
15346 C<"all">
15347
15348 =item Filtering only the code parts of source code
15349
15350 Most source code ceases to be grammatically correct when it is broken up
15351 into the pieces between string literals and regexes. So the C<'code'>
15352 component filter behaves slightly differently from the other partial
15353 filters
15354 described in the previous section.
15355
15356 =item Using Filter::Simple with an explicit C<import> subroutine
15357
15358 =item Using Filter::Simple and Exporter together
15359
15360 =item How it works
15361
15362 =back
15363
15364 =item AUTHOR
15365
15366 =item COPYRIGHT
15367
15368 =back
15369
15370 =head2 Filter::Util::Call - Perl Source Filter Utility Module
15371
15372 =over 4
15373
15374 =item SYNOPSIS
15375
15376 =item DESCRIPTION
15377
15378 =over 4
15379
15380 =item B<use Filter::Util::Call>
15381
15382 =item B<import()>
15383
15384 =item B<filter() and anonymous sub>
15385
15386 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
15387
15388 =back
15389
15390 =item EXAMPLES
15391
15392 =over 4
15393
15394 =item Example 1: A simple filter.
15395
15396 =item Example 2: Using the context
15397
15398 =item Example 3: Using the context within the filter
15399
15400 =item Example 4: Using filter_del
15401
15402 =back
15403
15404 =item Filter::Simple
15405
15406 =item AUTHOR
15407
15408 =item DATE
15409
15410 =back
15411
15412 =head2 FindBin - Locate directory of original perl script
15413
15414 =over 4
15415
15416 =item SYNOPSIS
15417
15418 =item DESCRIPTION
15419
15420 =item EXPORTABLE VARIABLES
15421
15422 =item KNOWN ISSUES
15423
15424 =item KNOWN BUGS
15425
15426 =item AUTHORS
15427
15428 =item COPYRIGHT
15429
15430 =back
15431
15432 =head2 GDBM_File - Perl5 access to the gdbm library.
15433
15434 =over 4
15435
15436 =item SYNOPSIS
15437
15438 =item DESCRIPTION
15439
15440 =item AVAILABILITY
15441
15442 =item BUGS
15443
15444 =item SEE ALSO
15445
15446 =back
15447
15448 =head2 Getopt::Long - Extended processing of command line options
15449
15450 =over 4
15451
15452 =item SYNOPSIS
15453
15454 =item DESCRIPTION
15455
15456 =item Command Line Options, an Introduction
15457
15458 =item Getting Started with Getopt::Long
15459
15460 =over 4
15461
15462 =item Simple options
15463
15464 =item A little bit less simple options
15465
15466 =item Mixing command line option with other arguments
15467
15468 =item Options with values
15469
15470 =item Options with multiple values
15471
15472 =item Options with hash values
15473
15474 =item User-defined subroutines to handle options
15475
15476 =item Options with multiple names
15477
15478 =item Case and abbreviations
15479
15480 =item Summary of Option Specifications
15481
15482 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
15483 + [ I<desttype> ]
15484
15485 =back
15486
15487 =item Advanced Possibilities
15488
15489 =over 4
15490
15491 =item Object oriented interface
15492
15493 =item Thread Safety
15494
15495 =item Documentation and help texts
15496
15497 =item Storing options in a hash
15498
15499 =item Bundling
15500
15501 =item The lonesome dash
15502
15503 =item Argument callback
15504
15505 =back
15506
15507 =item Configuring Getopt::Long
15508
15509 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
15510 require_order, permute, bundling (default: disabled), bundling_override
15511 (default: disabled), ignore_case  (default: enabled), ignore_case_always
15512 (default: disabled), auto_version (default:disabled), auto_help
15513 (default:disabled), pass_through (default: disabled), prefix,
15514 prefix_pattern, debug (default: disabled)
15515
15516 =item Exportable Methods
15517
15518 VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage
15519
15520 =item Return values and Errors
15521
15522 =item Legacy
15523
15524 =over 4
15525
15526 =item Default destinations
15527
15528 =item Alternative option starters
15529
15530 =item Configuration variables
15531
15532 =back
15533
15534 =item Trouble Shooting
15535
15536 =over 4
15537
15538 =item GetOptions does not return a false result when an option is not
15539 supplied
15540
15541 =item GetOptions does not split the command line correctly
15542
15543 =item Undefined subroutine &main::GetOptions called
15544
15545 =item How do I put a "-?" option into a Getopt::Long?
15546
15547 =back
15548
15549 =item AUTHOR
15550
15551 =item COPYRIGHT AND DISCLAIMER
15552
15553 =back
15554
15555 =head2 Getopt::Std, getopt, getopts - Process single-character switches
15556 with switch clustering
15557
15558 =over 4
15559
15560 =item SYNOPSIS
15561
15562 =item DESCRIPTION
15563
15564 =item C<--help> and C<--version>
15565
15566 =back
15567
15568 =head2 Hash::Util - A selection of general-utility hash subroutines
15569
15570 =over 4
15571
15572 =item SYNOPSIS
15573
15574 =item DESCRIPTION
15575
15576 =over 4
15577
15578 =item Restricted hashes
15579
15580 lock_keys, unlock_keys
15581
15582 =back
15583
15584 =back
15585
15586 lock_value, unlock_value
15587
15588 B<lock_hash>, B<unlock_hash>
15589
15590 B<hash_seed>
15591
15592 =over 4
15593
15594 =item CAVEATS
15595
15596 =item AUTHOR
15597
15598 =item SEE ALSO
15599
15600 =back
15601
15602 =head2 I18N::Collate - compare 8-bit scalar data according to the current
15603 locale
15604
15605 =over 4
15606
15607 =item SYNOPSIS
15608
15609 =item DESCRIPTION
15610
15611 =back
15612
15613 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
15614 tags
15615
15616 =over 4
15617
15618 =item SYNOPSIS
15619
15620 =item DESCRIPTION
15621
15622 =back
15623
15624 the function is_language_tag($lang1)
15625
15626 the function extract_language_tags($whatever)
15627
15628 the function same_language_tag($lang1, $lang2)
15629
15630 the function similarity_language_tag($lang1, $lang2)
15631
15632 the function is_dialect_of($lang1, $lang2)
15633
15634 the function super_languages($lang1)
15635
15636 the function locale2language_tag($locale_identifier)
15637
15638 the function encode_language_tag($lang1)
15639
15640 the function alternate_language_tags($lang1)
15641
15642 the function @langs = panic_languages(@accept_languages)
15643
15644 =over 4
15645
15646 =item ABOUT LOWERCASING
15647
15648 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
15649
15650 =item SEE ALSO
15651
15652 =item COPYRIGHT
15653
15654 =item AUTHOR
15655
15656 =back
15657
15658 =head2 I18N::LangTags::List -- tags and names for human languages
15659
15660 =over 4
15661
15662 =item SYNOPSIS
15663
15664 =item DESCRIPTION
15665
15666 =item ABOUT LANGUAGE TAGS
15667
15668 =item LIST OF LANGUAGES
15669
15670 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} :
15671 Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} :
15672 Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian,
15673 {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)],
15674 {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic,
15675 {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy}
15676 : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} :
15677 Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} :
15678 Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae}
15679 : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} :
15680 Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai}
15681 : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} :
15682 Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} :
15683 Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber
15684 (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini,
15685 {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} :
15686 Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} :
15687 Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian
15688 (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central
15689 American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages],
15690 {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb}
15691 : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} :
15692 Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} :
15693 Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree,
15694 {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf}
15695 : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based
15696 Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} :
15697 Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} :
15698 Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru)
15699 Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri,
15700 {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch,
15701 {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi}
15702 : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} :
15703 English, {enm} : Old English (1100-1500), {ang} : Old English
15704 (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} :
15705 Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat}
15706 : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} :
15707 Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French
15708 (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} :
15709 Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan,
15710 {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian,
15711 {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High
15712 German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon}
15713 : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient
15714 Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} :
15715 Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian,
15716 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
15717 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
15718 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo,
15719 {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European
15720 (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua
15721 (International Auxiliary Language Association), {ie} : Interlingue, {iu} :
15722 Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} :
15723 Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian
15724 languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} :
15725 Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle,
15726 {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} :
15727 Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar}
15728 : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh,
15729 {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese,
15730 {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz,
15731 {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} :
15732 Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama,
15733 {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} :
15734 Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} :
15735 Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} :
15736 Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban
15737 (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui}
15738 : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai,
15739 {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili,
15740 {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} :
15741 Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} :
15742 Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} :
15743 Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai,
15744 [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} :
15745 Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} :
15746 Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)],
15747 {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple
15748 languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan,
15749 {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele,
15750 {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
15751 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
15752 {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} :
15753 Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} :
15754 Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi}
15755 : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} :
15756 Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
15757 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
15758 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
15759 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
15760 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
15761 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
15762 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
15763 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
15764 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
15765 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
15766 languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} :
15767 Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami,
15768 [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} :
15769 Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak,
15770 {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian,
15771 {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign
15772 Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} :
15773 Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave
15774 (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian,
15775 {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} :
15776 Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} :
15777 South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} :
15778 Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati,
15779 {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} :
15780 Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao,
15781 {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} :
15782 Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} :
15783 Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau,
15784 {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian,
15785 {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} :
15786 Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh}
15787 : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} :
15788 Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian,
15789 {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} :
15790 Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak}
15791 : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was}
15792 : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private
15793 Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} :
15794 Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
15795 : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu,
15796 {zun} : Zuni
15797
15798 =item SEE ALSO
15799
15800 =item COPYRIGHT AND DISCLAIMER
15801
15802 =item AUTHOR
15803
15804 =back
15805
15806 =head2 I18N::Langinfo - query locale information
15807
15808 =over 4
15809
15810 =item SYNOPSIS
15811
15812 =item DESCRIPTION
15813
15814 =over 4
15815
15816 =item EXPORT
15817
15818 =back
15819
15820 =item SEE ALSO
15821
15822 =item AUTHOR
15823
15824 =item COPYRIGHT AND LICENSE
15825
15826 =back
15827
15828 =head2 IO - load various IO modules
15829
15830 =over 4
15831
15832 =item SYNOPSIS
15833
15834 =item DESCRIPTION
15835
15836 =item DEPRECATED
15837
15838 =back
15839
15840 =head2 IO::Dir - supply object methods for directory handles
15841
15842 =over 4
15843
15844 =item SYNOPSIS
15845
15846 =item DESCRIPTION
15847
15848 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
15849 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
15850
15851 =item SEE ALSO
15852
15853 =item AUTHOR
15854
15855 =item COPYRIGHT
15856
15857 =back
15858
15859 =head2 IO::File - supply object methods for filehandles
15860
15861 =over 4
15862
15863 =item SYNOPSIS
15864
15865 =item DESCRIPTION
15866
15867 =item CONSTRUCTOR
15868
15869 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
15870
15871 =item METHODS
15872
15873 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
15874
15875 =item SEE ALSO
15876
15877 =item HISTORY
15878
15879 =back
15880
15881 =head2 IO::Handle - supply object methods for I/O handles
15882
15883 =over 4
15884
15885 =item SYNOPSIS
15886
15887 =item DESCRIPTION
15888
15889 =item CONSTRUCTOR
15890
15891 new (), new_from_fd ( FD, MODE )
15892
15893 =item METHODS
15894
15895 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
15896 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
15897 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
15898 $io->blocking ( [ BOOL ] ), $io->untaint
15899
15900 =item NOTE
15901
15902 =item SEE ALSO
15903
15904 =item BUGS
15905
15906 =item HISTORY
15907
15908 =back
15909
15910 =head2 IO::Pipe - supply object methods for pipes
15911
15912 =over 4
15913
15914 =item SYNOPSIS
15915
15916 =item DESCRIPTION
15917
15918 =item CONSTRUCTOR
15919
15920 new ( [READER, WRITER] )
15921
15922 =item METHODS
15923
15924 reader ([ARGS]), writer ([ARGS]), handles ()
15925
15926 =item SEE ALSO
15927
15928 =item AUTHOR
15929
15930 =item COPYRIGHT
15931
15932 =back
15933
15934 =head2 IO::Poll - Object interface to system poll call
15935
15936 =over 4
15937
15938 =item SYNOPSIS
15939
15940 =item DESCRIPTION
15941
15942 =item METHODS
15943
15944 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
15945 IO ), handles( [ EVENT_MASK ] )
15946
15947 =item SEE ALSO
15948
15949 =item AUTHOR
15950
15951 =item COPYRIGHT
15952
15953 =back
15954
15955 =head2 IO::Seekable - supply seek based methods for I/O objects
15956
15957 =over 4
15958
15959 =item SYNOPSIS
15960
15961 =item DESCRIPTION
15962
15963 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
15964 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
15965 $io->tell
15966
15967 =item SEE ALSO
15968
15969 =item HISTORY
15970
15971 =back
15972
15973 =head2 IO::Select - OO interface to the select system call
15974
15975 =over 4
15976
15977 =item SYNOPSIS
15978
15979 =item DESCRIPTION
15980
15981 =item CONSTRUCTOR
15982
15983 new ( [ HANDLES ] )
15984
15985 =item METHODS
15986
15987 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
15988 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
15989 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
15990
15991 =item EXAMPLE
15992
15993 =item AUTHOR
15994
15995 =item COPYRIGHT
15996
15997 =back
15998
15999 =head2 IO::Socket - Object interface to socket communications
16000
16001 =over 4
16002
16003 =item SYNOPSIS
16004
16005 =item DESCRIPTION
16006
16007 =item CONSTRUCTOR
16008
16009 new ( [ARGS] )
16010
16011 =item METHODS
16012
16013 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
16014 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
16015
16016 =item SEE ALSO
16017
16018 =item AUTHOR
16019
16020 =item COPYRIGHT
16021
16022 =back
16023
16024 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
16025
16026 =over 4
16027
16028 =item SYNOPSIS
16029
16030 =item DESCRIPTION
16031
16032 =item CONSTRUCTOR
16033
16034 new ( [ARGS] )
16035
16036 =over 4
16037
16038 =item METHODS
16039
16040 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
16041 ()
16042
16043 =back
16044
16045 =item SEE ALSO
16046
16047 =item AUTHOR
16048
16049 =item COPYRIGHT
16050
16051 =back
16052
16053 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
16054
16055 =over 4
16056
16057 =item SYNOPSIS
16058
16059 =item DESCRIPTION
16060
16061 =item CONSTRUCTOR
16062
16063 new ( [ARGS] )
16064
16065 =item METHODS
16066
16067 hostpath(), peerpath()
16068
16069 =item SEE ALSO
16070
16071 =item AUTHOR
16072
16073 =item COPYRIGHT
16074
16075 =back
16076
16077 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
16078 handles
16079
16080 =over 4
16081
16082 =item SYNOPSIS
16083
16084 =item DESCRIPTION
16085
16086 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
16087 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
16088
16089 =item SEE ALSO
16090
16091 =item AUTHOR
16092
16093 =item COPYRIGHT
16094
16095 =back
16096
16097 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
16098
16099 =over 4
16100
16101 =item SYNOPSIS
16102
16103 =item DESCRIPTION
16104
16105 =item CONSTRUCTOR
16106
16107 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
16108
16109 =item METHODS
16110
16111 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
16112
16113 =item SEE ALSO
16114
16115 =item HISTORY
16116
16117 =back
16118
16119 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
16120 handles
16121
16122 =over 4
16123
16124 =item SYNOPSIS
16125
16126 =item DESCRIPTION
16127
16128 =item CONSTRUCTOR
16129
16130 new (), new_from_fd ( FD, MODE )
16131
16132 =item METHODS
16133
16134 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
16135 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
16136 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
16137 $io->blocking ( [ BOOL ] ), $io->untaint
16138
16139 =item NOTE
16140
16141 =item SEE ALSO
16142
16143 =item BUGS
16144
16145 =item HISTORY
16146
16147 =back
16148
16149 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
16150
16151 =over 4
16152
16153 =item SYNOPSIS
16154
16155 =item DESCRIPTION
16156
16157 =item CONSTRUCTOR
16158
16159 new ( [READER, WRITER] )
16160
16161 =item METHODS
16162
16163 reader ([ARGS]), writer ([ARGS]), handles ()
16164
16165 =item SEE ALSO
16166
16167 =item AUTHOR
16168
16169 =item COPYRIGHT
16170
16171 =back
16172
16173 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
16174
16175 =over 4
16176
16177 =item SYNOPSIS
16178
16179 =item DESCRIPTION
16180
16181 =item METHODS
16182
16183 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
16184 IO ), handles( [ EVENT_MASK ] )
16185
16186 =item SEE ALSO
16187
16188 =item AUTHOR
16189
16190 =item COPYRIGHT
16191
16192 =back
16193
16194 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
16195 I/O objects
16196
16197 =over 4
16198
16199 =item SYNOPSIS
16200
16201 =item DESCRIPTION
16202
16203 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
16204 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
16205 $io->tell
16206
16207 =item SEE ALSO
16208
16209 =item HISTORY
16210
16211 =back
16212
16213 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
16214 call
16215
16216 =over 4
16217
16218 =item SYNOPSIS
16219
16220 =item DESCRIPTION
16221
16222 =item CONSTRUCTOR
16223
16224 new ( [ HANDLES ] )
16225
16226 =item METHODS
16227
16228 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
16229 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
16230 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
16231
16232 =item EXAMPLE
16233
16234 =item AUTHOR
16235
16236 =item COPYRIGHT
16237
16238 =back
16239
16240 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
16241 communications
16242
16243 =over 4
16244
16245 =item SYNOPSIS
16246
16247 =item DESCRIPTION
16248
16249 =item CONSTRUCTOR
16250
16251 new ( [ARGS] )
16252
16253 =item METHODS
16254
16255 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
16256 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
16257
16258 =item SEE ALSO
16259
16260 =item AUTHOR
16261
16262 =item COPYRIGHT
16263
16264 =back
16265
16266 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
16267 AF_INET domain sockets
16268
16269 =over 4
16270
16271 =item SYNOPSIS
16272
16273 =item DESCRIPTION
16274
16275 =item CONSTRUCTOR
16276
16277 new ( [ARGS] )
16278
16279 =over 4
16280
16281 =item METHODS
16282
16283 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
16284 ()
16285
16286 =back
16287
16288 =item SEE ALSO
16289
16290 =item AUTHOR
16291
16292 =item COPYRIGHT
16293
16294 =back
16295
16296 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
16297 AF_UNIX domain sockets
16298
16299 =over 4
16300
16301 =item SYNOPSIS
16302
16303 =item DESCRIPTION
16304
16305 =item CONSTRUCTOR
16306
16307 new ( [ARGS] )
16308
16309 =item METHODS
16310
16311 hostpath(), peerpath()
16312
16313 =item SEE ALSO
16314
16315 =item AUTHOR
16316
16317 =item COPYRIGHT
16318
16319 =back
16320
16321 =head2 IPC::Msg - SysV Msg IPC object class
16322
16323 =over 4
16324
16325 =item SYNOPSIS
16326
16327 =item DESCRIPTION
16328
16329 =item METHODS
16330
16331 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
16332 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
16333 FLAGS ] ), stat
16334
16335 =item SEE ALSO
16336
16337 =item AUTHOR
16338
16339 =item COPYRIGHT
16340
16341 =back
16342
16343 =head2 IPC::Open2, open2 - open a process for both reading and writing
16344
16345 =over 4
16346
16347 =item SYNOPSIS
16348
16349 =item DESCRIPTION
16350
16351 =item WARNING 
16352
16353 =item SEE ALSO
16354
16355 =back
16356
16357 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
16358 handling
16359
16360 =over 4
16361
16362 =item SYNOPSIS
16363
16364 =item DESCRIPTION
16365
16366 =item WARNING
16367
16368 =back
16369
16370 =head2 IPC::Semaphore - SysV Semaphore IPC object class
16371
16372 =over 4
16373
16374 =item SYNOPSIS
16375
16376 =item DESCRIPTION
16377
16378 =item METHODS
16379
16380 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
16381 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
16382 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
16383 , VALUE ), stat
16384
16385 =item SEE ALSO
16386
16387 =item AUTHOR
16388
16389 =item COPYRIGHT
16390
16391 =back
16392
16393 =head2 IPC::SysV - SysV IPC constants
16394
16395 =over 4
16396
16397 =item SYNOPSIS
16398
16399 =item DESCRIPTION
16400
16401 ftok( PATH, ID )
16402
16403 =item SEE ALSO
16404
16405 =item AUTHORS
16406
16407 =item COPYRIGHT
16408
16409 =back
16410
16411 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
16412
16413 =over 4
16414
16415 =item SYNOPSIS
16416
16417 =item DESCRIPTION
16418
16419 =item METHODS
16420
16421 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
16422 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
16423 FLAGS ] ), stat
16424
16425 =item SEE ALSO
16426
16427 =item AUTHOR
16428
16429 =item COPYRIGHT
16430
16431 =back
16432
16433 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
16434 class
16435
16436 =over 4
16437
16438 =item SYNOPSIS
16439
16440 =item DESCRIPTION
16441
16442 =item METHODS
16443
16444 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
16445 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
16446 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
16447 , VALUE ), stat
16448
16449 =item SEE ALSO
16450
16451 =item AUTHOR
16452
16453 =item COPYRIGHT
16454
16455 =back
16456
16457 =head2 List::Util - A selection of general-utility list subroutines
16458
16459 =over 4
16460
16461 =item SYNOPSIS
16462
16463 =item DESCRIPTION
16464
16465 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
16466 BLOCK LIST, shuffle LIST, sum LIST
16467
16468 =item KNOWN BUGS
16469
16470 =item SUGGESTED ADDITIONS
16471
16472 =item COPYRIGHT
16473
16474 =back
16475
16476 =head2 List::Utilib::List::Util, List::Util - A selection of
16477 general-utility list subroutines
16478
16479 =over 4
16480
16481 =item SYNOPSIS
16482
16483 =item DESCRIPTION
16484
16485 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
16486 BLOCK LIST, shuffle LIST, sum LIST
16487
16488 =item KNOWN BUGS
16489
16490 =item SUGGESTED ADDITIONS
16491
16492 =item COPYRIGHT
16493
16494 =back
16495
16496 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
16497 general-utility scalar subroutines
16498
16499 =over 4
16500
16501 =item SYNOPSIS
16502
16503 =item DESCRIPTION
16504
16505 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
16506 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
16507 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
16508
16509 =item KNOWN BUGS
16510
16511 =item COPYRIGHT
16512
16513 =item BLATANT PLUG
16514
16515 =back
16516
16517 =head2 Locale::Constants - constants for Locale codes
16518
16519 =over 4
16520
16521 =item SYNOPSIS
16522
16523 =item DESCRIPTION
16524
16525 =item KNOWN BUGS AND LIMITATIONS
16526
16527 =item SEE ALSO
16528
16529 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
16530
16531 =item AUTHOR
16532
16533 =item COPYRIGHT
16534
16535 =back
16536
16537 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
16538
16539 =over 4
16540
16541 =item SYNOPSIS
16542
16543 =item DESCRIPTION
16544
16545 B<alpha-2>, B<alpha-3>, B<numeric>
16546
16547 =item CONVERSION ROUTINES
16548
16549 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
16550 country_code2code( CODE, CODESET, CODESET )
16551
16552 =item QUERY ROUTINES
16553
16554 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
16555
16556 =item SEMI-PRIVATE ROUTINES
16557
16558 =over 4
16559
16560 =item alias_code
16561
16562 =item rename_country
16563
16564 =back
16565
16566 =item EXAMPLES
16567
16568 =item DOMAIN NAMES
16569
16570 =item KNOWN BUGS AND LIMITATIONS
16571
16572 =item SEE ALSO
16573
16574 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
16575 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
16576 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
16577 http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
16578
16579 =item AUTHOR
16580
16581 =item COPYRIGHT
16582
16583 =back
16584
16585 =head2 Locale::Currency - ISO three letter codes for currency
16586 identification (ISO 4217)
16587
16588 =over 4
16589
16590 =item SYNOPSIS
16591
16592 =item DESCRIPTION
16593
16594 XTS, XXX
16595
16596 =item CONVERSION ROUTINES
16597
16598 code2currency(), currency2code()
16599
16600 =item QUERY ROUTINES
16601
16602 C<all_currency_codes()>, C<all_currency_names()>
16603
16604 =item EXAMPLES
16605
16606 =item KNOWN BUGS AND LIMITATIONS
16607
16608 =item SEE ALSO
16609
16610 Locale::Country, Locale::Script, ISO 4217:1995,
16611 http://www.bsi-global.com/iso4217currency
16612
16613 =item AUTHOR
16614
16615 =item COPYRIGHT
16616
16617 =back
16618
16619 =head2 Locale::Language - ISO two letter codes for language identification
16620 (ISO 639)
16621
16622 =over 4
16623
16624 =item SYNOPSIS
16625
16626 =item DESCRIPTION
16627
16628 =item CONVERSION ROUTINES
16629
16630 code2language(), language2code()
16631
16632 =item QUERY ROUTINES
16633
16634 C<all_language_codes()>, C<all_language_names()>
16635
16636 =item EXAMPLES
16637
16638 =item KNOWN BUGS AND LIMITATIONS
16639
16640 =item SEE ALSO
16641
16642 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
16643 http://lcweb.loc.gov/standards/iso639-2/langhome.html
16644
16645 =item AUTHOR
16646
16647 =item COPYRIGHT
16648
16649 =back
16650
16651 =head2 Locale::Maketext - framework for localization
16652
16653 =over 4
16654
16655 =item SYNOPSIS
16656
16657 =item DESCRIPTION
16658
16659 =item QUICK OVERVIEW
16660
16661 =item METHODS
16662
16663 =over 4
16664
16665 =item Construction Methods
16666
16667 =item The "maketext" Method
16668
16669 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
16670
16671 =item Utility Methods
16672
16673 $language->quant($number, $singular), $language->quant($number, $singular,
16674 $plural), $language->quant($number, $singular, $plural, $negative),
16675 $language->numf($number), $language->sprintf($format, @items),
16676 $language->language_tag(), $language->encoding()
16677
16678 =item Language Handle Attributes and Internals
16679
16680 =back
16681
16682 =item LANGUAGE CLASS HIERARCHIES
16683
16684 =item ENTRIES IN EACH LEXICON
16685
16686 =item BRACKET NOTATION
16687
16688 =item AUTO LEXICONS
16689
16690 =item CONTROLLING LOOKUP FAILURE
16691
16692 =item HOW TO USE MAKETEXT
16693
16694 =item SEE ALSO
16695
16696 =item COPYRIGHT AND DISCLAIMER
16697
16698 =item AUTHOR
16699
16700 =back
16701
16702 =head2 Locale::Maketext::TPJ13 -- article about software localization
16703
16704 =over 4
16705
16706 =item SYNOPSIS
16707
16708 =item DESCRIPTION
16709
16710 =item Localization and Perl: gettext breaks, Maketext fixes
16711
16712 =over 4
16713
16714 =item A Localization Horror Story: It Could Happen To You
16715
16716 =item The Linguistic View
16717
16718 =item Breaking gettext
16719
16720 =item Replacing gettext
16721
16722 =item Buzzwords: Abstraction and Encapsulation
16723
16724 =item Buzzword: Isomorphism
16725
16726 =item Buzzword: Inheritance
16727
16728 =item Buzzword: Concision
16729
16730 =item The Devil in the Details
16731
16732 =item The Proof in the Pudding: Localizing Web Sites
16733
16734 =item References
16735
16736 =back
16737
16738 =back
16739
16740 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
16741
16742 =over 4
16743
16744 =item SYNOPSIS
16745
16746 =item DESCRIPTION
16747
16748 B<alpha-2>, B<alpha-3>, B<numeric>
16749
16750 =over 4
16751
16752 =item SPECIAL CODES
16753
16754 =back
16755
16756 =item CONVERSION ROUTINES
16757
16758 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
16759 script_code2code( CODE, CODESET, CODESET )
16760
16761 =item QUERY ROUTINES
16762
16763 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
16764
16765 =item EXAMPLES
16766
16767 =item KNOWN BUGS AND LIMITATIONS
16768
16769 =item SEE ALSO
16770
16771 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
16772 http://www.evertype.com/standards/iso15924/
16773
16774 =item AUTHOR
16775
16776 =item COPYRIGHT
16777
16778 =back
16779
16780 =head2 MIME::Base64 - Encoding and decoding of base64 strings
16781
16782 =over 4
16783
16784 =item SYNOPSIS
16785
16786 =item DESCRIPTION
16787
16788 encode_base64($str), encode_base64($str, $eol);, decode_base64($str)
16789
16790 =item DIAGNOSTICS
16791
16792 Premature end of base64 data, Premature padding of base64 data
16793
16794 =item EXAMPLES
16795
16796 =item COPYRIGHT
16797
16798 =item SEE ALSO
16799
16800 =back
16801
16802 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
16803 of quoted-printable strings
16804
16805 =over 4
16806
16807 =item SYNOPSIS
16808
16809 =item DESCRIPTION
16810
16811 encode_qp($str), encode_qp($str, $eol), decode_qp($str);
16812
16813 =item COPYRIGHT
16814
16815 =item SEE ALSO
16816
16817 =back
16818
16819 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
16820 strings
16821
16822 =over 4
16823
16824 =item SYNOPSIS
16825
16826 =item DESCRIPTION
16827
16828 encode_qp($str), encode_qp($str, $eol), decode_qp($str);
16829
16830 =item COPYRIGHT
16831
16832 =item SEE ALSO
16833
16834 =back
16835
16836 =head2 Math::BigFloat - Arbitrary size floating point math package
16837
16838 =over 4
16839
16840 =item SYNOPSIS
16841
16842 =item DESCRIPTION
16843
16844 =over 4
16845
16846 =item Canonical notation
16847
16848 =item Output
16849
16850 =item C<mantissa()>, C<exponent()> and C<parts()>
16851
16852 =item Accuracy vs. Precision
16853
16854 =item Rounding
16855
16856 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
16857 ), fround  ( -$scale ) and fround ( 0 )
16858
16859 =back
16860
16861 =item EXAMPLES
16862
16863   # not ready yet
16864
16865 =item Autocreating constants
16866
16867 =over 4
16868
16869 =item Math library
16870
16871 =item Using Math::BigInt::Lite
16872
16873 =back
16874
16875 =item BUGS
16876
16877 =item CAVEATS
16878
16879 stringify, bstr(), bdiv, Modifying and =, bpow
16880
16881 =item SEE ALSO
16882
16883 =item LICENSE
16884
16885 =item AUTHORS
16886
16887 =back
16888
16889 =head2 Math::BigInt - Arbitrary size integer math package
16890
16891 =over 4
16892
16893 =item SYNOPSIS
16894
16895 =item DESCRIPTION
16896
16897 Input, Output
16898
16899 =item METHODS
16900
16901 =over 4
16902
16903 =item config
16904
16905 =item accuracy
16906
16907 =item precision
16908
16909 =item brsft
16910
16911 =item new
16912
16913 =item bnan
16914
16915 =item bzero
16916
16917 =item binf
16918
16919 =item bone
16920
16921 =item is_one()/is_zero()/is_nan()/is_inf()
16922
16923 =item is_pos()/is_neg()
16924
16925         $x->is_pos();                   # true if >= 0
16926         $x->is_neg();                   # true if <  0
16927
16928 =item is_odd()/is_even()/is_int()
16929
16930 =item bcmp
16931
16932 =item bacmp
16933
16934 =item sign
16935
16936 =item digit
16937
16938 =item bneg
16939
16940 =item babs
16941
16942 =item bnorm
16943
16944 =item bnot
16945
16946 =item binc
16947
16948 =item bdec
16949
16950 =item badd
16951
16952 =item bsub
16953
16954 =item bmul
16955
16956 =item bdiv
16957
16958 =item bmod
16959
16960 =item bmodinv
16961
16962 =item bmodpow
16963
16964 =item bpow
16965
16966 =item blsft
16967
16968 =item brsft
16969
16970 =item band
16971
16972 =item bior
16973
16974 =item bxor
16975
16976 =item bnot
16977
16978 =item bsqrt
16979
16980 =item bfac
16981
16982 =item round
16983
16984 =item bround
16985
16986 =item bfround
16987
16988 =item bfloor
16989
16990 =item bceil
16991
16992 =item bgcd
16993
16994 =item blcm
16995
16996 =item exponent
16997
16998 =item mantissa
16999
17000 =item parts
17001
17002 =item copy
17003
17004 =item as_int
17005
17006 =item bsstr
17007
17008 =item as_hex
17009
17010 =item as_bin
17011
17012 =back
17013
17014 =item ACCURACY and PRECISION
17015
17016 =over 4
17017
17018 =item Precision P
17019
17020 =item Accuracy A
17021
17022 =item Fallback F
17023
17024 =item Rounding mode R
17025
17026 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
17027 (significant digits), Setting/Accessing, Creating numbers, Usage,
17028 Precedence, Overriding globals, Local settings, Rounding, Default values,
17029 Remarks
17030
17031 =back
17032
17033 =item INTERNALS
17034
17035 =over 4
17036
17037 =item MATH LIBRARY
17038
17039 =item SIGN
17040
17041 =item mantissa(), exponent() and parts()
17042
17043 =back
17044
17045 =item EXAMPLES
17046
17047   use Math::BigInt;
17048
17049 =item Autocreating constants
17050
17051 =item PERFORMANCE
17052
17053 =over 4
17054
17055 =item Alternative math libraries
17056
17057 =item SUBCLASSING
17058
17059 =back
17060
17061 =item Subclassing Math::BigInt
17062
17063 =item UPGRADING
17064
17065 =over 4
17066
17067 =item Auto-upgrade
17068
17069 bsqrt(), div(), blog()
17070
17071 =back
17072
17073 =item BUGS
17074
17075 broot() does not work, Out of Memory!, Fails to load Calc on Perl prior
17076 5.6.0
17077
17078 =item CAVEATS
17079
17080 bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling,
17081 Modifying and =, bpow, Overloading -$x, Mixing different object types,
17082 bsqrt(), brsft()
17083
17084 =item LICENSE
17085
17086 =item SEE ALSO
17087
17088 =item AUTHORS
17089
17090 =back
17091
17092 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
17093
17094 =over 4
17095
17096 =item SYNOPSIS
17097
17098 =item DESCRIPTION
17099
17100 =item STORAGE
17101
17102 =item METHODS
17103
17104 =item WRAP YOUR OWN
17105
17106 =item LICENSE
17107
17108 This program is free software; you may redistribute it and/or modify it
17109 under
17110 the same terms as Perl itself. 
17111
17112 =item AUTHORS
17113
17114 =item SEE ALSO
17115
17116 =back
17117
17118 =head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code
17119
17120 =over 4
17121
17122 =item SYNOPSIS
17123
17124 =item DESCRIPTION
17125
17126 =item METHODS
17127
17128 =item LICENSE
17129
17130 This program is free software; you may redistribute it and/or modify it
17131 under
17132 the same terms as Perl itself. 
17133
17134 =item AUTHORS
17135
17136 =item SEE ALSO
17137
17138 =back
17139
17140 =head2 Math::BigRat - arbitrarily big rational numbers
17141
17142 =over 4
17143
17144 =item SYNOPSIS
17145
17146 =item DESCRIPTION
17147
17148 =over 4
17149
17150 =item MATH LIBRARY
17151
17152 =back
17153
17154 =item METHODS
17155
17156 =over 4
17157
17158 =item new()
17159
17160 =item numerator()
17161
17162 =item denominator()
17163
17164         $d = $x->denominator();
17165
17166 =item parts()
17167
17168 =item as_number()
17169
17170 =item bfac()
17171
17172 =item blog()
17173
17174 =item bround()/round()/bfround()
17175
17176 =item bmod()
17177
17178 =item is_one()
17179
17180 =item is_zero()
17181
17182 =item is_positive()
17183
17184 =item is_negative()
17185
17186 =item is_int()
17187
17188 =item is_odd()
17189
17190 =item is_even()
17191
17192 =item bceil()
17193
17194 =item bfloor()
17195
17196         $x->bfloor();
17197
17198 =item bsqrt()
17199
17200         $x->bsqrt();
17201
17202 =item config
17203
17204 =back
17205
17206 =item BUGS
17207
17208 inf handling (partial), NaN handling (partial), rounding (not implemented
17209 except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(),
17210 blog(), bmodinv() and bmodpow() (partial)
17211
17212 =item LICENSE
17213
17214 =item SEE ALSO
17215
17216 =item AUTHORS
17217
17218 =back
17219
17220 =head2 Math::Complex - complex numbers and associated mathematical
17221 functions
17222
17223 =over 4
17224
17225 =item SYNOPSIS
17226
17227 =item DESCRIPTION
17228
17229 =item OPERATIONS
17230
17231 =item CREATION
17232
17233 =item STRINGIFICATION
17234
17235 =over 4
17236
17237 =item CHANGED IN PERL 5.6
17238
17239 =back
17240
17241 =item USAGE
17242
17243 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
17244
17245 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
17246
17247 =item BUGS
17248
17249 =item AUTHORS
17250
17251 =back
17252
17253 =head2 Math::Trig - trigonometric functions
17254
17255 =over 4
17256
17257 =item SYNOPSIS
17258
17259 =item DESCRIPTION
17260
17261 =item TRIGONOMETRIC FUNCTIONS
17262
17263 B<tan>
17264
17265 =over 4
17266
17267 =item ERRORS DUE TO DIVISION BY ZERO
17268
17269 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
17270
17271 =back
17272
17273 =item PLANE ANGLE CONVERSIONS
17274
17275 =item RADIAL COORDINATE CONVERSIONS
17276
17277 =over 4
17278
17279 =item COORDINATE SYSTEMS
17280
17281 =item 3-D ANGLE CONVERSIONS
17282
17283 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
17284 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
17285
17286 =back
17287
17288 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
17289
17290 =item EXAMPLES
17291
17292 =over 4
17293
17294 =item CAVEAT FOR GREAT CIRCLE FORMULAS
17295
17296 =back
17297
17298 =item BUGS
17299
17300 =item AUTHORS
17301
17302 =back
17303
17304 =head2 Memoize - Make functions faster by trading space for time
17305
17306 =over 4
17307
17308 =item SYNOPSIS
17309
17310 =item DESCRIPTION
17311
17312 =item DETAILS
17313
17314 =item OPTIONS
17315
17316 =over 4
17317
17318 =item INSTALL
17319
17320 =item NORMALIZER
17321
17322 =item C<SCALAR_CACHE>, C<LIST_CACHE>
17323
17324 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
17325
17326 =back
17327
17328 =item OTHER FACILITIES
17329
17330 =over 4
17331
17332 =item C<unmemoize>
17333
17334 =item C<flush_cache>
17335
17336 =back
17337
17338 =item CAVEATS
17339
17340 =item PERSISTENT CACHE SUPPORT
17341
17342 =item EXPIRATION SUPPORT
17343
17344 =item BUGS
17345
17346 =item MAILING LIST
17347
17348 =item AUTHOR
17349
17350 =item COPYRIGHT AND LICENSE
17351
17352 =item THANK YOU
17353
17354 =back
17355
17356 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
17357 Storable use
17358
17359 =over 4
17360
17361 =item DESCRIPTION
17362
17363 =back
17364
17365 =head2 Memoize::Expire - Plug-in module for automatic expiration of
17366 memoized values
17367
17368 =over 4
17369
17370 =item SYNOPSIS
17371
17372 =item DESCRIPTION
17373
17374 =item INTERFACE
17375
17376  TIEHASH,  EXISTS,  STORE
17377
17378 =item ALTERNATIVES
17379
17380 =item CAVEATS
17381
17382 =item AUTHOR
17383
17384 =item SEE ALSO
17385
17386 =back
17387
17388 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
17389
17390 =over 4
17391
17392 =item DESCRIPTION
17393
17394 =back
17395
17396 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
17397
17398 =over 4
17399
17400 =item DESCRIPTION
17401
17402 =back
17403
17404 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
17405 Storable use
17406
17407 =over 4
17408
17409 =item DESCRIPTION
17410
17411 =back
17412
17413 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
17414 Storable use
17415
17416 =over 4
17417
17418 =item DESCRIPTION
17419
17420 =back
17421
17422 =head2 Memoize::Storable - store Memoized data in Storable database
17423
17424 =over 4
17425
17426 =item DESCRIPTION
17427
17428 =back
17429
17430 =head2 NDBM_File - Tied access to ndbm files
17431
17432 =over 4
17433
17434 =item SYNOPSIS
17435
17436 =item DESCRIPTION
17437
17438 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17439
17440 =item DIAGNOSTICS
17441
17442 =over 4
17443
17444 =item C<ndbm store returned -1, errno 22, key "..." at ...>
17445
17446 =back
17447
17448 =item BUGS AND WARNINGS
17449
17450 =back
17451
17452 =head2 NEXT - Provide a pseudo-class NEXT (et al) that allows method
17453 redispatch
17454
17455 =over 4
17456
17457 =item SYNOPSIS
17458
17459 =item DESCRIPTION
17460
17461 =over 4
17462
17463 =item Enforcing redispatch
17464
17465 =item Avoiding repetitions
17466
17467 =item Invoking all versions of a method with a single call
17468
17469 =item Using C<EVERY> methods
17470
17471 =back
17472
17473 =item AUTHOR
17474
17475 =item BUGS AND IRRITATIONS
17476
17477 =item COPYRIGHT
17478
17479 =back
17480
17481 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
17482
17483 =over 4
17484
17485 =item SYNOPSIS
17486
17487 =item DESCRIPTION
17488
17489 =item USER METHODS
17490
17491 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
17492 dataend ()
17493
17494 =item CLASS METHODS
17495
17496 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
17497 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
17498 ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh ()
17499
17500 =item EXPORTS
17501
17502 =item AUTHOR
17503
17504 =item COPYRIGHT
17505
17506 =back
17507
17508 =head2 Net::Config - Local configuration data for libnet
17509
17510 =over 4
17511
17512 =item SYNOPSYS
17513
17514 =item DESCRIPTION
17515
17516 =item METHODS
17517
17518 requires_firewall HOST
17519
17520 =item NetConfig VALUES
17521
17522 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
17523 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
17524 ftp_int_pasive, local_netmask, test_hosts, test_exists
17525
17526 =back
17527
17528 =head2 Net::Domain - Attempt to evaluate the current host's internet name
17529 and domain
17530
17531 =over 4
17532
17533 =item SYNOPSIS
17534
17535 =item DESCRIPTION
17536
17537 hostfqdn (), hostname (), hostdomain ()
17538
17539 =item AUTHOR
17540
17541 =item COPYRIGHT
17542
17543 =back
17544
17545 =head2 Net::FTP - FTP Client class
17546
17547 =over 4
17548
17549 =item SYNOPSIS
17550
17551 =item DESCRIPTION
17552
17553 =item OVERVIEW
17554
17555 =item CONSTRUCTOR
17556
17557 new (HOST [,OPTIONS])
17558
17559 =item METHODS
17560
17561 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
17562 site (ARGS), ascii, binary, rename ( OLDNAME, NEWNAME ), delete ( FILENAME
17563 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR [,
17564 RECURSE ]), mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), alloc ( SIZE [,
17565 RECORD_SIZE] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]]
17566 ), put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [,
17567 REMOTE_FILE ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (),
17568 mdtm ( FILE ), size ( FILE ), supported ( CMD ), hash (
17569 [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [
17570 DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe ( FILE ), port (
17571 [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
17572 pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait (
17573 NON_PASV_SERVER ), abort (), quit ()
17574
17575 =over 4
17576
17577 =item Methods for the adventurous
17578
17579 quot (CMD [,ARGS])
17580
17581 =back
17582
17583 =item THE dataconn CLASS
17584
17585 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
17586 bytes_read (), abort (), close ()
17587
17588 =item UNIMPLEMENTED
17589
17590 B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
17591
17592 =item REPORTING BUGS
17593
17594 =item AUTHOR
17595
17596 =item SEE ALSO
17597
17598 =item USE EXAMPLES
17599
17600 http://www.csh.rit.edu/~adam/Progs/
17601
17602 =item CREDITS
17603
17604 =item COPYRIGHT
17605
17606 =back
17607
17608 =head2 Net::NNTP - NNTP Client class
17609
17610 =over 4
17611
17612 =item SYNOPSIS
17613
17614 =item DESCRIPTION
17615
17616 =item CONSTRUCTOR
17617
17618 new ( [ HOST ] [, OPTIONS ])
17619
17620 =item METHODS
17621
17622 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
17623 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
17624 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
17625 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
17626 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
17627 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
17628 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
17629
17630 =over 4
17631
17632 =item Extension methods
17633
17634 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
17635 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
17636 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
17637 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
17638 GROUP ] ), reader
17639
17640 =back
17641
17642 =item UNSUPPORTED
17643
17644 =item DEFINITIONS
17645
17646 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
17647
17648 =item SEE ALSO
17649
17650 =item AUTHOR
17651
17652 =item COPYRIGHT
17653
17654 =back
17655
17656 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
17657
17658 =over 4
17659
17660 =item SYNOPSIS
17661
17662 =item DESCRIPTION
17663
17664 =item CONSTRUCTOR
17665
17666 new ( [ HOST, ] [ OPTIONS ] )
17667
17668 =item METHODS
17669
17670 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
17671 PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
17672 [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
17673 MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
17674
17675 =item NOTES
17676
17677 =item SEE ALSO
17678
17679 =item AUTHOR
17680
17681 =item COPYRIGHT
17682
17683 =back
17684
17685 =head2 Net::Ping - check a remote host for reachability
17686
17687 =over 4
17688
17689 =item SYNOPSIS
17690
17691 =item DESCRIPTION
17692
17693 =over 4
17694
17695 =item Functions
17696
17697 Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos
17698 ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
17699 $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
17700 $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
17701 [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host
17702 [, $timeout]);
17703
17704 =back
17705
17706 =item NOTES
17707
17708 =item INSTALL
17709
17710 =item BUGS
17711
17712 =item AUTHORS
17713
17714 =item COPYRIGHT
17715
17716 =back
17717
17718 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
17719
17720 =over 4
17721
17722 =item SYNOPSIS
17723
17724 =item DESCRIPTION
17725
17726 =item EXAMPLES
17727
17728 =item CONSTRUCTOR
17729
17730 new Net::SMTP [ HOST, ] [ OPTIONS ]
17731
17732 =item METHODS
17733
17734 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
17735 PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
17736 ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
17737 ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
17738 ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
17739 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
17740 quit ()
17741
17742 =item ADDRESSES
17743
17744 =item SEE ALSO
17745
17746 =item AUTHOR
17747
17748 =item COPYRIGHT
17749
17750 =back
17751
17752 =head2 Net::Time - time and daytime network client interface
17753
17754 =over 4
17755
17756 =item SYNOPSIS
17757
17758 =item DESCRIPTION
17759
17760 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
17761 PROTOCOL [, TIMEOUT]]])
17762
17763 =item AUTHOR
17764
17765 =item COPYRIGHT
17766
17767 =back
17768
17769 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
17770 functions
17771
17772 =over 4
17773
17774 =item SYNOPSIS
17775
17776 =item DESCRIPTION
17777
17778 =item EXAMPLES
17779
17780 =item NOTE
17781
17782 =item AUTHOR
17783
17784 =back
17785
17786 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
17787
17788 =over 4
17789
17790 =item DESCRIPTION
17791
17792 =over 4
17793
17794 =item Where to get this document
17795
17796 =item How to contribute to this document
17797
17798 =back
17799
17800 =item Author and Copyright Information
17801
17802 =over 4
17803
17804 =item Disclaimer
17805
17806 =back
17807
17808 =item Obtaining and installing libnet
17809
17810 =over 4
17811
17812 =item What is libnet ?
17813
17814 =item Which version of perl do I need ?
17815
17816 =item What other modules do I need ?
17817
17818 =item What machines support libnet ?
17819
17820 =item Where can I get the latest libnet release
17821
17822 =back
17823
17824 =item Using Net::FTP
17825
17826 =over 4
17827
17828 =item How do I download files from an FTP server ?
17829
17830 =item How do I transfer files in binary mode ?
17831
17832 =item How can I get the size of a file on a remote FTP server ?
17833
17834 =item How can I get the modification time of a file on a remote FTP server
17835 ?
17836
17837 =item How can I change the permissions of a file on a remote server ?
17838
17839 =item Can I do a reget operation like the ftp command ?
17840
17841 =item How do I get a directory listing from an FTP server ?
17842
17843 =item Changing directory to "" does not fail ?
17844
17845 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
17846
17847 =item I am behind an FTP proxy firewall, but cannot access machines outside
17848 ?
17849
17850 =item My ftp proxy firewall does not listen on port 21
17851
17852 =item Is it possible to change the file permissions of a file on an FTP
17853 server ?
17854
17855 =item I have seen scripts call a method message, but cannot find it
17856 documented ?
17857
17858 =item Why does Net::FTP not implement mput and mget methods
17859
17860 =back
17861
17862 =item Using Net::SMTP
17863
17864 =over 4
17865
17866 =item Why can't the part of an Email address after the @ be used as the
17867 hostname ?
17868
17869 =item Why does Net::SMTP not do DNS MX lookups ?
17870
17871 =item The verify method always returns true ?
17872
17873 =back
17874
17875 =item Debugging scripts
17876
17877 =over 4
17878
17879 =item How can I debug my scripts that use Net::* modules ?
17880
17881 =back
17882
17883 =item AUTHOR AND COPYRIGHT
17884
17885 =back
17886
17887 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
17888 functions
17889
17890 =over 4
17891
17892 =item SYNOPSIS
17893
17894 =item DESCRIPTION
17895
17896 =item EXAMPLES
17897
17898 =item NOTE
17899
17900 =item AUTHOR
17901
17902 =back
17903
17904 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
17905 functions
17906
17907 =over 4
17908
17909 =item SYNOPSIS
17910
17911 =item DESCRIPTION
17912
17913 =item NOTE
17914
17915 =item AUTHOR
17916
17917 =back
17918
17919 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
17920 functions
17921
17922 =over 4
17923
17924 =item SYNOPSIS
17925
17926 =item DESCRIPTION
17927
17928 =item EXAMPLES
17929
17930 =item NOTE
17931
17932 =item AUTHOR
17933
17934 =back
17935
17936 =head2 Netrc, Net::Netrc - OO interface to users netrc file
17937
17938 =over 4
17939
17940 =item SYNOPSIS
17941
17942 =item DESCRIPTION
17943
17944 =item THE .netrc FILE
17945
17946 machine name, default, login name, password string, account string, macdef
17947 name
17948
17949 =item CONSTRUCTOR
17950
17951 lookup ( MACHINE [, LOGIN ])
17952
17953 =item METHODS
17954
17955 login (), password (), account (), lpa ()
17956
17957 =item AUTHOR
17958
17959 =item SEE ALSO
17960
17961 =item COPYRIGHT
17962
17963 =back
17964
17965 =head2 O - Generic interface to Perl Compiler backends
17966
17967 =over 4
17968
17969 =item SYNOPSIS
17970
17971 =item DESCRIPTION
17972
17973 =item CONVENTIONS
17974
17975 =item IMPLEMENTATION
17976
17977 =item BUGS
17978
17979 =item AUTHOR
17980
17981 =back
17982
17983 =head2 ODBM_File - Tied access to odbm files
17984
17985 =over 4
17986
17987 =item SYNOPSIS
17988
17989 =item DESCRIPTION
17990
17991 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17992
17993 =item DIAGNOSTICS
17994
17995 =over 4
17996
17997 =item C<odbm store returned -1, errno 22, key "..." at ...>
17998
17999 =back
18000
18001 =item BUGS AND WARNINGS
18002
18003 =back
18004
18005 =head2 Opcode - Disable named opcodes when compiling perl code
18006
18007 =over 4
18008
18009 =item SYNOPSIS
18010
18011 =item DESCRIPTION
18012
18013 =item NOTE
18014
18015 =item WARNING
18016
18017 =item Operator Names and Operator Lists
18018
18019 an operator name (opname), an operator tag name (optag), a negated opname
18020 or optag, an operator set (opset)
18021
18022 =item Opcode Functions
18023
18024 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
18025 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
18026 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
18027 opdump (PAT)
18028
18029 =item Manipulating Opsets
18030
18031 =item TO DO (maybe)
18032
18033 =back
18034
18035 =over 4
18036
18037 =item Predefined Opcode Tags
18038
18039 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
18040 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
18041 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
18042 :dangerous
18043
18044 =item SEE ALSO
18045
18046 =item AUTHORS
18047
18048 =back
18049
18050 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
18051 compartments
18052
18053 =over 4
18054
18055 =item SYNOPSIS
18056
18057 =item DESCRIPTION
18058
18059 a new namespace, an operator mask
18060
18061 =item WARNING
18062
18063 =over 4
18064
18065 =item RECENT CHANGES
18066
18067 =item Methods in class Safe
18068
18069 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
18070 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
18071 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
18072 root (NAMESPACE), mask (MASK)
18073
18074 =item Some Safety Issues
18075
18076 Memory, CPU, Snooping, Signals, State Changes
18077
18078 =item AUTHOR
18079
18080 =back
18081
18082 =back
18083
18084 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
18085 compiling
18086
18087 =over 4
18088
18089 =item SYNOPSIS  
18090
18091 =item DESCRIPTION
18092
18093 =item SEE ALSO
18094
18095 =back
18096
18097 =head2 POSIX - Perl interface to IEEE Std 1003.1
18098
18099 =over 4
18100
18101 =item SYNOPSIS
18102
18103 =item DESCRIPTION
18104
18105 =item NOTE
18106
18107 =item CAVEATS 
18108
18109 =item FUNCTIONS
18110
18111 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
18112 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
18113 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
18114 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
18115 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
18116 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
18117 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
18118 fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv,
18119 geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid,
18120 getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha,
18121 isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace,
18122 isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime,
18123 log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr,
18124 memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice,
18125 offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc,
18126 putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename,
18127 rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid,
18128 setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
18129 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
18130 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
18131 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
18132 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
18133 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
18134 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
18135 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
18136 wctomb, write
18137
18138 =item CLASSES
18139
18140 =over 4
18141
18142 =item POSIX::SigAction
18143
18144 new, handler, mask, flags, safe
18145
18146 =item POSIX::SigSet
18147
18148 new, addset, delset, emptyset, fillset, ismember
18149
18150 =item POSIX::Termios
18151
18152 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
18153 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
18154 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
18155 field values, c_cflag field values, c_iflag field values, c_lflag field
18156 values, c_oflag field values
18157
18158 =back
18159
18160 =item PATHNAME CONSTANTS
18161
18162 Constants
18163
18164 =item POSIX CONSTANTS
18165
18166 Constants
18167
18168 =item SYSTEM CONFIGURATION
18169
18170 Constants
18171
18172 =item ERRNO
18173
18174 Constants
18175
18176 =item FCNTL
18177
18178 Constants
18179
18180 =item FLOAT
18181
18182 Constants
18183
18184 =item LIMITS
18185
18186 Constants
18187
18188 =item LOCALE
18189
18190 Constants
18191
18192 =item MATH
18193
18194 Constants
18195
18196 =item SIGNAL
18197
18198 Constants
18199
18200 =item STAT
18201
18202 Constants, Macros
18203
18204 =item STDLIB
18205
18206 Constants
18207
18208 =item STDIO
18209
18210 Constants
18211
18212 =item TIME
18213
18214 Constants
18215
18216 =item UNISTD
18217
18218 Constants
18219
18220 =item WAIT
18221
18222 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
18223 WTERMSIG, WIFSTOPPED, WSTOPSIG
18224
18225 =back
18226
18227 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
18228 name space
18229
18230 =over 4
18231
18232 =item SYNOPSIS
18233
18234 =item DESCRIPTION
18235
18236 :unix, :stdio, :perlio, :crlf, :mmap, :utf8, :bytes, :raw, :pop, :win32
18237
18238 =over 4
18239
18240 =item Custom Layers
18241
18242 :encoding, :via
18243
18244 =item Alternatives to raw
18245
18246 =item Defaults and how to override them
18247
18248 =item Querying the layers of filehandles
18249
18250 =back
18251
18252 =item AUTHOR
18253
18254 =item SEE ALSO
18255
18256 =back
18257
18258 =head2 PerlIO::encoding - encoding layer
18259
18260 =over 4
18261
18262 =item SYNOPSIS
18263
18264 =item DESCRIPTION
18265
18266 =item SEE ALSO
18267
18268 =back
18269
18270 =head2 PerlIO::scalar - in-memory IO, scalar IO
18271
18272 =over 4
18273
18274 =item SYNOPSIS
18275
18276 =item DESCRIPTION
18277
18278 =item IMPLEMENTATION NOTE
18279
18280 =back
18281
18282 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
18283
18284 =over 4
18285
18286 =item SYNOPSIS
18287
18288 =item DESCRIPTION
18289
18290 =item EXPECTED METHODS
18291
18292 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
18293 $obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]),
18294 $obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]),
18295 $obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh),
18296 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
18297 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
18298 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
18299 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
18300
18301 =item EXAMPLES
18302
18303 =over 4
18304
18305 =item Example - a Hexadecimal Handle
18306
18307 =back
18308
18309 =back
18310
18311 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
18312
18313 =over 4
18314
18315 =item SYNOPSIS
18316
18317 =item DESCRIPTION
18318
18319 =item REQUIRED MODULES
18320
18321 =item SEE ALSO
18322
18323 =item ACKNOWLEDGEMENTS
18324
18325 =item COPYRIGHT
18326
18327 =back
18328
18329 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
18330
18331 =over 4
18332
18333 =item SYNOPSIS
18334
18335 =item OPTIONS/ARGUMENTS
18336
18337 =over 4
18338
18339 =item podchecker()
18340
18341 B<-warnings> =E<gt> I<val>
18342
18343 =back
18344
18345 =item DESCRIPTION
18346
18347 =item DIAGNOSTICS
18348
18349 =over 4
18350
18351 =item Errors
18352
18353 empty =headn, =over on line I<N> without closing =back, =item without
18354 previous =over, =back without previous =over, No argument for =begin, =end
18355 without =begin, Nested =begin's, =for without formatter specification,
18356 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
18357 interior-sequence "I<SEQ>", nested commands
18358 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
18359 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
18360 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
18361 after =back
18362
18363 =item Warnings
18364
18365 multiple occurrence of link target I<name>, line containing nothing but
18366 whitespace in paragraph, file does not start with =head, previous =item has
18367 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
18368 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
18369 items in =over, No argument for =item, empty section in previous paragraph,
18370 Verbatim paragraph in NAME section, =headI<n> without preceding higher
18371 level
18372
18373 =item Hyperlinks
18374
18375 ignoring leading/trailing whitespace in link, (section) in '$page'
18376 deprecated, alternative text/node '%s' contains non-escaped | or /
18377
18378 =back
18379
18380 =item RETURN VALUE
18381
18382 =item EXAMPLES
18383
18384 =item INTERFACE
18385
18386 =back
18387
18388 C<Pod::Checker-E<gt>new( %options )>
18389
18390 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
18391 @args )>
18392
18393 C<$checker-E<gt>num_errors()>
18394
18395 C<$checker-E<gt>num_warnings()>
18396
18397 C<$checker-E<gt>name()>
18398
18399 C<$checker-E<gt>node()>
18400
18401 C<$checker-E<gt>idx()>
18402
18403 C<$checker-E<gt>hyperlink()>
18404
18405 =over 4
18406
18407 =item AUTHOR
18408
18409 =back
18410
18411 =head2 Pod::Find - find POD documents in directory trees
18412
18413 =over 4
18414
18415 =item SYNOPSIS
18416
18417 =item DESCRIPTION
18418
18419 =back
18420
18421 =over 4
18422
18423 =item C<pod_find( { %opts } , @directories )>
18424
18425 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
18426 1>
18427
18428 =back
18429
18430 =over 4
18431
18432 =item C<simplify_name( $str )>
18433
18434 =back
18435
18436 =over 4
18437
18438 =item C<pod_where( { %opts }, $pod )>
18439
18440 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
18441 1>
18442
18443 =back
18444
18445 =over 4
18446
18447 =item C<contains_pod( $file , $verbose )>
18448
18449 =back
18450
18451 =over 4
18452
18453 =item AUTHOR
18454
18455 =item SEE ALSO
18456
18457 =back
18458
18459 =head2 Pod::Html - module to convert pod files to HTML
18460
18461 =over 4
18462
18463 =item SYNOPSIS
18464
18465 =item DESCRIPTION
18466
18467 =item ARGUMENTS
18468
18469 backlink, cachedir, css, flush, header, help, hiddendirs, htmldir,
18470 htmlroot, index, infile, libpods, netscape, outfile, podpath, podroot,
18471 quiet, recurse, title, verbose
18472
18473 =item EXAMPLE
18474
18475 =item ENVIRONMENT
18476
18477 =item AUTHOR
18478
18479 =item SEE ALSO
18480
18481 =item COPYRIGHT
18482
18483 =back
18484
18485 =head2 Pod::InputObjects - objects representing POD input paragraphs,
18486 commands, etc.
18487
18488 =over 4
18489
18490 =item SYNOPSIS
18491
18492 =item REQUIRES
18493
18494 =item EXPORTS
18495
18496 =item DESCRIPTION
18497
18498 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
18499 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
18500
18501 =back
18502
18503 =over 4
18504
18505 =item B<Pod::InputSource>
18506
18507 =back
18508
18509 =over 4
18510
18511 =item B<new()>
18512
18513 =back
18514
18515 =over 4
18516
18517 =item B<name()>
18518
18519 =back
18520
18521 =over 4
18522
18523 =item B<handle()>
18524
18525 =back
18526
18527 =over 4
18528
18529 =item B<was_cutting()>
18530
18531 =back
18532
18533 =over 4
18534
18535 =item B<Pod::Paragraph>
18536
18537 =back
18538
18539 =over 4
18540
18541 =item Pod::Paragraph-E<gt>B<new()>
18542
18543 =back
18544
18545 =over 4
18546
18547 =item $pod_para-E<gt>B<cmd_name()>
18548
18549 =back
18550
18551 =over 4
18552
18553 =item $pod_para-E<gt>B<text()>
18554
18555 =back
18556
18557 =over 4
18558
18559 =item $pod_para-E<gt>B<raw_text()>
18560
18561 =back
18562
18563 =over 4
18564
18565 =item $pod_para-E<gt>B<cmd_prefix()>
18566
18567 =back
18568
18569 =over 4
18570
18571 =item $pod_para-E<gt>B<cmd_separator()>
18572
18573 =back
18574
18575 =over 4
18576
18577 =item $pod_para-E<gt>B<parse_tree()>
18578
18579 =back
18580
18581 =over 4
18582
18583 =item $pod_para-E<gt>B<file_line()>
18584
18585 =back
18586
18587 =over 4
18588
18589 =item B<Pod::InteriorSequence>
18590
18591 =back
18592
18593 =over 4
18594
18595 =item Pod::InteriorSequence-E<gt>B<new()>
18596
18597 =back
18598
18599 =over 4
18600
18601 =item $pod_seq-E<gt>B<cmd_name()>
18602
18603 =back
18604
18605 =over 4
18606
18607 =item $pod_seq-E<gt>B<prepend()>
18608
18609 =back
18610
18611 =over 4
18612
18613 =item $pod_seq-E<gt>B<append()>
18614
18615 =back
18616
18617 =over 4
18618
18619 =item $pod_seq-E<gt>B<nested()>
18620
18621 =back
18622
18623 =over 4
18624
18625 =item $pod_seq-E<gt>B<raw_text()>
18626
18627 =back
18628
18629 =over 4
18630
18631 =item $pod_seq-E<gt>B<left_delimiter()>
18632
18633 =back
18634
18635 =over 4
18636
18637 =item $pod_seq-E<gt>B<right_delimiter()>
18638
18639 =back
18640
18641 =over 4
18642
18643 =item $pod_seq-E<gt>B<parse_tree()>
18644
18645 =back
18646
18647 =over 4
18648
18649 =item $pod_seq-E<gt>B<file_line()>
18650
18651 =back
18652
18653 =over 4
18654
18655 =item Pod::InteriorSequence::B<DESTROY()>
18656
18657 =back
18658
18659 =over 4
18660
18661 =item B<Pod::ParseTree>
18662
18663 =back
18664
18665 =over 4
18666
18667 =item Pod::ParseTree-E<gt>B<new()>
18668
18669 =back
18670
18671 =over 4
18672
18673 =item $ptree-E<gt>B<top()>
18674
18675 =back
18676
18677 =over 4
18678
18679 =item $ptree-E<gt>B<children()>
18680
18681 =back
18682
18683 =over 4
18684
18685 =item $ptree-E<gt>B<prepend()>
18686
18687 =back
18688
18689 =over 4
18690
18691 =item $ptree-E<gt>B<append()>
18692
18693 =back
18694
18695 =over 4
18696
18697 =item $ptree-E<gt>B<raw_text()>
18698
18699 =back
18700
18701 =over 4
18702
18703 =item Pod::ParseTree::B<DESTROY()>
18704
18705 =back
18706
18707 =over 4
18708
18709 =item SEE ALSO
18710
18711 =item AUTHOR
18712
18713 =back
18714
18715 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
18716
18717 =over 4
18718
18719 =item SYNOPSIS
18720
18721 =item DESCRIPTION
18722
18723 =back
18724
18725 =over 4
18726
18727 =item OBJECT METHODS
18728
18729 C<initialize>
18730
18731 =back
18732
18733 =over 4
18734
18735 =item Data Accessors
18736
18737 B<AddPreamble>
18738
18739 =back
18740
18741 B<AddPostamble>
18742
18743 B<Head1Level>
18744
18745 B<Label>
18746
18747 B<LevelNoNum>
18748
18749 B<MakeIndex>
18750
18751 B<ReplaceNAMEwithSection>
18752
18753 B<StartWithNewPage>
18754
18755 B<TableOfContents>
18756
18757 B<UniqueLabels>
18758
18759 B<UserPreamble>
18760
18761 B<UserPostamble>
18762
18763 B<Lists>
18764
18765 =over 4
18766
18767 =item Subclassed methods
18768
18769 =back
18770
18771 B<begin_pod>
18772
18773 B<end_pod>
18774
18775 B<command>
18776
18777 B<verbatim>
18778
18779 B<textblock>
18780
18781 B<interior_sequence>
18782
18783 =over 4
18784
18785 =item List Methods
18786
18787 B<begin_list>
18788
18789 =back
18790
18791 B<end_list>
18792
18793 B<add_item>
18794
18795 =over 4
18796
18797 =item Methods for headings
18798
18799 B<head>
18800
18801 =back
18802
18803 =over 4
18804
18805 =item Internal methods
18806
18807 B<_output>
18808
18809 =back
18810
18811 B<_replace_special_chars>
18812
18813 B<_replace_special_chars_late>
18814
18815 B<_create_label>
18816
18817 B<_create_index>
18818
18819 B<_clean_latex_commands>
18820
18821 B<_split_delimited>
18822
18823 =over 4
18824
18825 =item NOTES
18826
18827 =item SEE ALSO
18828
18829 =item AUTHORS
18830
18831 =item COPYRIGHT
18832
18833 =item REVISION
18834
18835 =back
18836
18837 =head2 Pod::Man - Convert POD data to formatted *roff input
18838
18839 =over 4
18840
18841 =item SYNOPSIS
18842
18843 =item DESCRIPTION
18844
18845 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
18846 release, section
18847
18848 =item DIAGNOSTICS
18849
18850 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
18851 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
18852 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
18853 =back
18854
18855 =item BUGS
18856
18857 =item CAVEATS
18858
18859 =item SEE ALSO
18860
18861 =item AUTHOR
18862
18863 =item COPYRIGHT AND LICENSE
18864
18865 =back
18866
18867 =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
18868
18869 =over 4
18870
18871 =item SYNOPSIS
18872
18873 =item DESCRIPTION
18874
18875 =item SEE ALSO
18876
18877 =item AUTHOR
18878
18879 =item COPYRIGHT AND LICENSE
18880
18881 =back
18882
18883 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
18884
18885 =over 4
18886
18887 =item SYNOPSIS
18888
18889 =item DESCRIPTION
18890
18891 =back
18892
18893 =over 4
18894
18895 =item Pod::List
18896
18897 Pod::List-E<gt>new()
18898
18899 =back
18900
18901 $list-E<gt>file()
18902
18903 $list-E<gt>start()
18904
18905 $list-E<gt>indent()
18906
18907 $list-E<gt>type()
18908
18909 $list-E<gt>rx()
18910
18911 $list-E<gt>item()
18912
18913 $list-E<gt>parent()
18914
18915 $list-E<gt>tag()
18916
18917 =over 4
18918
18919 =item Pod::Hyperlink
18920
18921 Pod::Hyperlink-E<gt>new()
18922
18923 =back
18924
18925 $link-E<gt>parse($string)
18926
18927 $link-E<gt>markup($string)
18928
18929 $link-E<gt>text()
18930
18931 $link-E<gt>warning()
18932
18933 $link-E<gt>file(), $link-E<gt>line()
18934
18935 $link-E<gt>page()
18936
18937 $link-E<gt>node()
18938
18939 $link-E<gt>alttext()
18940
18941 $link-E<gt>type()
18942
18943 $link-E<gt>link()
18944
18945 =over 4
18946
18947 =item Pod::Cache
18948
18949 Pod::Cache-E<gt>new()
18950
18951 =back
18952
18953 $cache-E<gt>item()
18954
18955 $cache-E<gt>find_page($name)
18956
18957 =over 4
18958
18959 =item Pod::Cache::Item
18960
18961 Pod::Cache::Item-E<gt>new()
18962
18963 =back
18964
18965 $cacheitem-E<gt>page()
18966
18967 $cacheitem-E<gt>description()
18968
18969 $cacheitem-E<gt>path()
18970
18971 $cacheitem-E<gt>file()
18972
18973 $cacheitem-E<gt>nodes()
18974
18975 $cacheitem-E<gt>find_node($name)
18976
18977 $cacheitem-E<gt>idx()
18978
18979 =over 4
18980
18981 =item AUTHOR
18982
18983 =item SEE ALSO
18984
18985 =back
18986
18987 =head2 Pod::Parser - base class for creating POD filters and translators
18988
18989 =over 4
18990
18991 =item SYNOPSIS
18992
18993 =item REQUIRES
18994
18995 =item EXPORTS
18996
18997 =item DESCRIPTION
18998
18999 =item QUICK OVERVIEW
19000
19001 =item PARSING OPTIONS
19002
19003 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
19004 B<-warnings> (default: unset)
19005
19006 =back
19007
19008 =over 4
19009
19010 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
19011
19012 =back
19013
19014 =over 4
19015
19016 =item B<command()>
19017
19018 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
19019
19020 =back
19021
19022 =over 4
19023
19024 =item B<verbatim()>
19025
19026 C<$text>, C<$line_num>, C<$pod_para>
19027
19028 =back
19029
19030 =over 4
19031
19032 =item B<textblock()>
19033
19034 C<$text>, C<$line_num>, C<$pod_para>
19035
19036 =back
19037
19038 =over 4
19039
19040 =item B<interior_sequence()>
19041
19042 =back
19043
19044 =over 4
19045
19046 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
19047
19048 =back
19049
19050 =over 4
19051
19052 =item B<new()>
19053
19054 =back
19055
19056 =over 4
19057
19058 =item B<initialize()>
19059
19060 =back
19061
19062 =over 4
19063
19064 =item B<begin_pod()>
19065
19066 =back
19067
19068 =over 4
19069
19070 =item B<begin_input()>
19071
19072 =back
19073
19074 =over 4
19075
19076 =item B<end_input()>
19077
19078 =back
19079
19080 =over 4
19081
19082 =item B<end_pod()>
19083
19084 =back
19085
19086 =over 4
19087
19088 =item B<preprocess_line()>
19089
19090 =back
19091
19092 =over 4
19093
19094 =item B<preprocess_paragraph()>
19095
19096 =back
19097
19098 =over 4
19099
19100 =item METHODS FOR PARSING AND PROCESSING
19101
19102 =back
19103
19104 =over 4
19105
19106 =item B<parse_text()>
19107
19108 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
19109 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
19110 I<code-ref>|I<method-name>
19111
19112 =back
19113
19114 =over 4
19115
19116 =item B<interpolate()>
19117
19118 =back
19119
19120 =over 4
19121
19122 =item B<parse_paragraph()>
19123
19124 =back
19125
19126 =over 4
19127
19128 =item B<parse_from_filehandle()>
19129
19130 =back
19131
19132 =over 4
19133
19134 =item B<parse_from_file()>
19135
19136 =back
19137
19138 =over 4
19139
19140 =item ACCESSOR METHODS
19141
19142 =back
19143
19144 =over 4
19145
19146 =item B<errorsub()>
19147
19148 =back
19149
19150 =over 4
19151
19152 =item B<cutting()>
19153
19154 =back
19155
19156 =over 4
19157
19158 =item B<parseopts()>
19159
19160 =back
19161
19162 =over 4
19163
19164 =item B<output_file()>
19165
19166 =back
19167
19168 =over 4
19169
19170 =item B<output_handle()>
19171
19172 =back
19173
19174 =over 4
19175
19176 =item B<input_file()>
19177
19178 =back
19179
19180 =over 4
19181
19182 =item B<input_handle()>
19183
19184 =back
19185
19186 =over 4
19187
19188 =item B<input_streams()>
19189
19190 =back
19191
19192 =over 4
19193
19194 =item B<top_stream()>
19195
19196 =back
19197
19198 =over 4
19199
19200 =item PRIVATE METHODS AND DATA
19201
19202 =back
19203
19204 =over 4
19205
19206 =item B<_push_input_stream()>
19207
19208 =back
19209
19210 =over 4
19211
19212 =item B<_pop_input_stream()>
19213
19214 =back
19215
19216 =over 4
19217
19218 =item TREE-BASED PARSING
19219
19220 =item SEE ALSO
19221
19222 =item AUTHOR
19223
19224 =back
19225
19226 =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors
19227
19228 =over 4
19229
19230 =item SYNOPSIS
19231
19232 =item DESCRIPTION
19233
19234 =item SEE ALSO
19235
19236 =item COPYRIGHT AND DISCLAIMERS
19237
19238 =item AUTHOR
19239
19240 =back
19241
19242 =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages
19243
19244 =over 4
19245
19246 =item SYNOPSIS
19247
19248 =item DESCRIPTION
19249
19250 =item CAVEAT
19251
19252 =item SEE ALSO
19253
19254 =item COPYRIGHT AND DISCLAIMERS
19255
19256 =item AUTHOR
19257
19258 =back
19259
19260 =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff
19261
19262 =over 4
19263
19264 =item SYNOPSIS
19265
19266 =item DESCRIPTION
19267
19268 =item CAVEAT
19269
19270 =item SEE ALSO
19271
19272 =item COPYRIGHT AND DISCLAIMERS
19273
19274 =item AUTHOR
19275
19276 =back
19277
19278 =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod!
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::Perldoc::ToRtf - let Perldoc render Pod as RTF
19295
19296 =over 4
19297
19298 =item SYNOPSIS
19299
19300 =item DESCRIPTION
19301
19302 =item SEE ALSO
19303
19304 =item COPYRIGHT AND DISCLAIMERS
19305
19306 =item AUTHOR
19307
19308 =back
19309
19310 =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext
19311
19312 =over 4
19313
19314 =item SYNOPSIS
19315
19316 =item DESCRIPTION
19317
19318 =item CAVEAT
19319
19320 =item SEE ALSO
19321
19322 =item COPYRIGHT AND DISCLAIMERS
19323
19324 =item AUTHOR
19325
19326 =back
19327
19328 =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod
19329
19330 =over 4
19331
19332 =item SYNOPSIS
19333
19334 =item DESCRIPTION
19335
19336 =item SEE ALSO
19337
19338 =item AUTHOR
19339
19340 =back
19341
19342 =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML
19343
19344 =over 4
19345
19346 =item SYNOPSIS
19347
19348 =item DESCRIPTION
19349
19350 =item SEE ALSO
19351
19352 =item COPYRIGHT AND DISCLAIMERS
19353
19354 =item AUTHOR
19355
19356 =back
19357
19358 =head2 Pod::PlainText - Convert POD data to formatted ASCII text
19359
19360 =over 4
19361
19362 =item SYNOPSIS
19363
19364 =item DESCRIPTION
19365
19366 alt, indent, loose, sentence, width
19367
19368 =item DIAGNOSTICS
19369
19370 Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
19371 Unknown sequence: %s, Unmatched =back
19372
19373 =item RESTRICTIONS
19374
19375 =item NOTES
19376
19377 =item SEE ALSO
19378
19379 =item AUTHOR
19380
19381 =back
19382
19383 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
19384
19385 =over 4
19386
19387 =item SYNOPSIS
19388
19389 =item DESCRIPTION
19390
19391 =over 4
19392
19393 =item EXPORT
19394
19395 =back
19396
19397 =item AUTHOR
19398
19399 =item SEE ALSO
19400
19401 =back
19402
19403 =head2 Pod::Select, podselect() - extract selected sections of POD from
19404 input
19405
19406 =over 4
19407
19408 =item SYNOPSIS
19409
19410 =item REQUIRES
19411
19412 =item EXPORTS
19413
19414 =item DESCRIPTION
19415
19416 =item SECTION SPECIFICATIONS
19417
19418 =item RANGE SPECIFICATIONS
19419
19420 =back
19421
19422 =over 4
19423
19424 =item OBJECT METHODS
19425
19426 =back
19427
19428 =over 4
19429
19430 =item B<curr_headings()>
19431
19432 =back
19433
19434 =over 4
19435
19436 =item B<select()>
19437
19438 =back
19439
19440 =over 4
19441
19442 =item B<add_selection()>
19443
19444 =back
19445
19446 =over 4
19447
19448 =item B<clear_selections()>
19449
19450 =back
19451
19452 =over 4
19453
19454 =item B<match_section()>
19455
19456 =back
19457
19458 =over 4
19459
19460 =item B<is_selected()>
19461
19462 =back
19463
19464 =over 4
19465
19466 =item EXPORTED FUNCTIONS
19467
19468 =back
19469
19470 =over 4
19471
19472 =item B<podselect()>
19473
19474 B<-output>, B<-sections>, B<-ranges>
19475
19476 =back
19477
19478 =over 4
19479
19480 =item PRIVATE METHODS AND DATA
19481
19482 =back
19483
19484 =over 4
19485
19486 =item B<_compile_section_spec()>
19487
19488 =back
19489
19490 =over 4
19491
19492 =item $self->{_SECTION_HEADINGS}
19493
19494 =back
19495
19496 =over 4
19497
19498 =item $self->{_SELECTED_SECTIONS}
19499
19500 =back
19501
19502 =over 4
19503
19504 =item SEE ALSO
19505
19506 =item AUTHOR
19507
19508 =back
19509
19510 =head2 Pod::Text - Convert POD data to formatted ASCII text
19511
19512 =over 4
19513
19514 =item SYNOPSIS
19515
19516 =item DESCRIPTION
19517
19518 alt, code, indent, loose, margin, quotes, sentence, width
19519
19520 =item DIAGNOSTICS
19521
19522 Bizarre space in item, Item called without tag, Can't open %s for reading:
19523 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
19524 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
19525 Unmatched =back
19526
19527 =item RESTRICTIONS
19528
19529 =item NOTES
19530
19531 =item SEE ALSO
19532
19533 =item AUTHOR
19534
19535 =item COPYRIGHT AND LICENSE
19536
19537 =back
19538
19539 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
19540
19541 =over 4
19542
19543 =item SYNOPSIS
19544
19545 =item DESCRIPTION
19546
19547 =item BUGS
19548
19549 =item SEE ALSO
19550
19551 =item AUTHOR
19552
19553 =item COPYRIGHT AND LICENSE
19554
19555 =back
19556
19557 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
19558 text
19559
19560 =over 4
19561
19562 =item SYNOPSIS
19563
19564 =item DESCRIPTION
19565
19566 =item BUGS
19567
19568 =item SEE ALSO
19569
19570 =item AUTHOR
19571
19572 =item COPYRIGHT AND LICENSE
19573
19574 =back
19575
19576 =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
19577 escapes
19578
19579 =over 4
19580
19581 =item SYNOPSIS
19582
19583 =item DESCRIPTION
19584
19585 =item NOTES
19586
19587 =item SEE ALSO
19588
19589 =item AUTHOR
19590
19591 =item COPYRIGHT AND LICENSE
19592
19593 =back
19594
19595 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
19596 documentation
19597
19598 =over 4
19599
19600 =item SYNOPSIS
19601
19602 =item ARGUMENTS
19603
19604 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
19605 C<-pathlist>
19606
19607 =item DESCRIPTION
19608
19609 =item EXAMPLES
19610
19611 =over 4
19612
19613 =item Recommended Use
19614
19615 =back
19616
19617 =item CAVEATS
19618
19619 =item AUTHOR
19620
19621 =item ACKNOWLEDGEMENTS
19622
19623 =back
19624
19625 =head2 SDBM_File - Tied access to sdbm files
19626
19627 =over 4
19628
19629 =item SYNOPSIS
19630
19631 =item DESCRIPTION
19632
19633 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
19634
19635 =item DIAGNOSTICS
19636
19637 =over 4
19638
19639 =item C<sdbm store returned -1, errno 22, key "..." at ...>
19640
19641 =back
19642
19643 =item BUGS AND WARNINGS
19644
19645 =back
19646
19647 =head2 Safe - Compile and execute code in restricted compartments
19648
19649 =over 4
19650
19651 =item SYNOPSIS
19652
19653 =item DESCRIPTION
19654
19655 a new namespace, an operator mask
19656
19657 =item WARNING
19658
19659 =over 4
19660
19661 =item RECENT CHANGES
19662
19663 =item Methods in class Safe
19664
19665 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
19666 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
19667 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
19668 root (NAMESPACE), mask (MASK)
19669
19670 =item Some Safety Issues
19671
19672 Memory, CPU, Snooping, Signals, State Changes
19673
19674 =item AUTHOR
19675
19676 =back
19677
19678 =back
19679
19680 =head2 Scalar::Util - A selection of general-utility scalar subroutines
19681
19682 =over 4
19683
19684 =item SYNOPSIS
19685
19686 =item DESCRIPTION
19687
19688 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
19689 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
19690 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
19691
19692 =item KNOWN BUGS
19693
19694 =item COPYRIGHT
19695
19696 =item BLATANT PLUG
19697
19698 =back
19699
19700 =head2 Search::Dict, look - search for key in dictionary file
19701
19702 =over 4
19703
19704 =item SYNOPSIS
19705
19706 =item DESCRIPTION
19707
19708 =back
19709
19710 =head2 SelectSaver - save and restore selected file handle
19711
19712 =over 4
19713
19714 =item SYNOPSIS
19715
19716 =item DESCRIPTION
19717
19718 =back
19719
19720 =head2 SelfLoader - load functions only on demand
19721
19722 =over 4
19723
19724 =item SYNOPSIS
19725
19726 =item DESCRIPTION
19727
19728 =over 4
19729
19730 =item The __DATA__ token
19731
19732 =item SelfLoader autoloading
19733
19734 =item Autoloading and package lexicals
19735
19736 =item SelfLoader and AutoLoader
19737
19738 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
19739
19740 =item Classes and inherited methods.
19741
19742 =back
19743
19744 =item Multiple packages and fully qualified subroutine names
19745
19746 =back
19747
19748 =head2 Shell - run shell commands transparently within perl
19749
19750 =over 4
19751
19752 =item SYNOPSIS
19753
19754 =item DESCRIPTION
19755
19756 =over 4
19757
19758 =item OBJECT ORIENTED SYNTAX
19759
19760 =back
19761
19762 =item AUTHOR
19763
19764 =back
19765
19766 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
19767 socket.h defines and structure manipulators 
19768
19769 =over 4
19770
19771 =item SYNOPSIS
19772
19773 =item DESCRIPTION
19774
19775 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
19776 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
19777 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
19778 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
19779 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
19780
19781 =back
19782
19783 =head2 Storable - persistence for Perl data structures
19784
19785 =over 4
19786
19787 =item SYNOPSIS
19788
19789 =item DESCRIPTION
19790
19791 =item MEMORY STORE
19792
19793 =item ADVISORY LOCKING
19794
19795 =item SPEED
19796
19797 =item CANONICAL REPRESENTATION
19798
19799 =item CODE REFERENCES
19800
19801 =item FORWARD COMPATIBILITY
19802
19803 utf8 data, restricted hashes, files from future versions of Storable
19804
19805 =item ERROR REPORTING
19806
19807 =item WIZARDS ONLY
19808
19809 =over 4
19810
19811 =item Hooks
19812
19813 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
19814 I<serialized>, ..
19815
19816 =item Predicates
19817
19818 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
19819 C<Storable::is_retrieving>
19820
19821 =item Recursion
19822
19823 =item Deep Cloning
19824
19825 =back
19826
19827 =item Storable magic
19828
19829 =item EXAMPLES
19830
19831 =item WARNING
19832
19833 =item BUGS
19834
19835 =over 4
19836
19837 =item 64 bit data in perl 5.6.0 and 5.6.1
19838
19839 =back
19840
19841 =item CREDITS
19842
19843 =item AUTHOR
19844
19845 =item SEE ALSO
19846
19847 =back
19848
19849 =head2 Switch - A switch statement for Perl
19850
19851 =over 4
19852
19853 =item VERSION
19854
19855 =item SYNOPSIS
19856
19857 =item BACKGROUND
19858
19859 =item DESCRIPTION
19860
19861 =over 4
19862
19863 =item Allowing fall-through
19864
19865 =item Automating fall-through
19866
19867 =item Alternative syntax
19868
19869 =item Higher-order Operations
19870
19871 =back
19872
19873 =item DEPENDENCIES
19874
19875 =item AUTHOR
19876
19877 =item BUGS
19878
19879 =item LIMITATIONS
19880
19881 =item COPYRIGHT
19882
19883 =back
19884
19885 =head2 Symbol - manipulate Perl symbols and their names
19886
19887 =over 4
19888
19889 =item SYNOPSIS
19890
19891 =item DESCRIPTION
19892
19893 =item BUGS
19894
19895 =back
19896
19897 =head2 Sys::Hostname - Try every conceivable way to get hostname
19898
19899 =over 4
19900
19901 =item SYNOPSIS
19902
19903 =item DESCRIPTION
19904
19905 =item AUTHOR
19906
19907 =back
19908
19909 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
19910 interface to the UNIX syslog(3) calls
19911
19912 =over 4
19913
19914 =item SYNOPSIS
19915
19916 =item DESCRIPTION
19917
19918 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19919 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19920 in 5.004_02), closelog
19921
19922 =item EXAMPLES
19923
19924 =item SEE ALSO
19925
19926 =item AUTHOR
19927
19928 =back
19929
19930 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
19931 Perl interface to the UNIX syslog(3) calls
19932
19933 =over 4
19934
19935 =item SYNOPSIS
19936
19937 =item DESCRIPTION
19938
19939 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19940 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19941 in 5.004_02), closelog
19942
19943 =item EXAMPLES
19944
19945 =item SEE ALSO
19946
19947 =item AUTHOR
19948
19949 =back
19950
19951 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
19952
19953 =over 4
19954
19955 =item SYNOPSIS
19956
19957 =item DESCRIPTION
19958
19959 =item DIAGNOSTICS
19960
19961 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
19962 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
19963 comma allowed after filehandle, No name for escape sequence %s
19964
19965 =item ENVIRONMENT
19966
19967 ANSI_COLORS_DISABLED
19968
19969 =item RESTRICTIONS
19970
19971 =item NOTES
19972
19973 =item SEE ALSO
19974
19975 =item AUTHORS
19976
19977 =item COPYRIGHT AND LICENSE
19978
19979 =back
19980
19981 =head2 Term::Cap - Perl termcap interface
19982
19983 =over 4
19984
19985 =item SYNOPSIS
19986
19987 =item DESCRIPTION
19988
19989 =over 4
19990
19991 =item METHODS
19992
19993 =back
19994
19995 =back
19996
19997 B<Tgetent>, OSPEED, TERM
19998
19999 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
20000
20001 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
20002
20003 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
20004
20005 B<Trequire>
20006
20007 =over 4
20008
20009 =item EXAMPLES
20010
20011 =item COPYRIGHT AND LICENSE
20012
20013 =item AUTHOR
20014
20015 =item SEE ALSO
20016
20017 =back
20018
20019 =head2 Term::Complete - Perl word completion module
20020
20021 =over 4
20022
20023 =item SYNOPSIS
20024
20025 =item DESCRIPTION
20026
20027 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
20028
20029 =item DIAGNOSTICS
20030
20031 =item BUGS
20032
20033 =item AUTHOR
20034
20035 =back
20036
20037 =head2 Term::ReadLine - Perl interface to various C<readline> packages.
20038 If no real package is found, substitutes stubs instead of basic functions.
20039
20040 =over 4
20041
20042 =item SYNOPSIS
20043
20044 =item DESCRIPTION
20045
20046 =item Minimal set of supported functions
20047
20048 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>,
20049 C<findConsole>, Attribs, C<Features>
20050
20051 =item Additional supported functions
20052
20053 C<tkRunning>, C<ornaments>, C<newTTY>
20054
20055 =item EXPORTS
20056
20057 =item ENVIRONMENT
20058
20059 =item CAVEATS
20060
20061 =back
20062
20063 =head2 Test - provides a simple framework for writing test scripts
20064
20065 =over 4
20066
20067 =item SYNOPSIS
20068
20069 =item DESCRIPTION
20070
20071 =item QUICK START GUIDE
20072
20073 =over 4
20074
20075 =item Functions
20076
20077 C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>,
20078 C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub>
20079
20080 =back
20081
20082 =back
20083
20084 B<_to_value>
20085
20086 C<ok(...)>
20087
20088 C<skip(I<skip_if_true>, I<args...>)>
20089
20090 =over 4
20091
20092 =item TEST TYPES
20093
20094 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
20095
20096 =item ONFAIL
20097
20098 =item BUGS and CAVEATS
20099
20100 =item NOTE
20101
20102 =item SEE ALSO
20103
20104 =item AUTHOR
20105
20106 =back
20107
20108 =head2 Test::Builder - Backend for building test libraries
20109
20110 =over 4
20111
20112 =item SYNOPSIS
20113
20114 =item DESCRIPTION
20115
20116 =over 4
20117
20118 =item Construction
20119
20120 B<new>
20121
20122 =back
20123
20124 =back
20125
20126 =over 4
20127
20128 =item Setting up tests
20129
20130 B<exported_to>
20131
20132 =back
20133
20134 B<plan>
20135
20136 B<expected_tests>
20137
20138 B<no_plan>
20139
20140 B<has_plan>
20141
20142 B<skip_all>
20143
20144 =over 4
20145
20146 =item Running tests
20147
20148 B<ok>
20149
20150 =back
20151
20152 B<is_eq>, B<is_num>
20153
20154 B<isnt_eq>, B<isnt_num>
20155
20156 B<like>, B<unlike>
20157
20158 B<maybe_regex>
20159
20160 B<cmp_ok>
20161
20162 B<BAILOUT>
20163
20164 B<skip>
20165
20166 B<todo_skip>
20167
20168 B<skip_rest>
20169
20170 =over 4
20171
20172 =item Test style
20173
20174 B<level>
20175
20176 =back
20177
20178 B<use_numbers>
20179
20180 B<no_header>, B<no_ending>
20181
20182 =over 4
20183
20184 =item Output
20185
20186 B<diag>
20187
20188 =back
20189
20190 B<_print>
20191
20192 B<output>, B<failure_output>, B<todo_output>
20193
20194 =over 4
20195
20196 =item Test Status and Info
20197
20198 B<current_test>
20199
20200 =back
20201
20202 B<summary>
20203
20204 B<details>
20205
20206 B<todo>
20207
20208 B<caller>
20209
20210 B<_sanity_check>
20211
20212 B<_whoa>
20213
20214 B<_my_exit>
20215
20216 =over 4
20217
20218 =item THREADS
20219
20220 =item EXAMPLES
20221
20222 =item SEE ALSO
20223
20224 =item AUTHORS
20225
20226 =item COPYRIGHT
20227
20228 =back
20229
20230 =head2 Test::Harness - Run Perl standard test scripts with statistics
20231
20232 =over 4
20233
20234 =item VERSION
20235
20236 =back
20237
20238 =over 4
20239
20240 =item SYNOPSIS
20241
20242 =item DESCRIPTION
20243
20244 =over 4
20245
20246 =item The test script output
20247
20248 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
20249 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
20250 else>
20251
20252 =item Taint mode
20253
20254 =item Configuration variables.
20255
20256 B<$Test::Harness::Verbose>, B<$Test::Harness::switches>
20257
20258 =item Failure
20259
20260 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
20261 Failed>
20262
20263 =item Functions
20264
20265 B<runtests>
20266
20267 =back
20268
20269 =back
20270
20271 B<_all_ok>
20272
20273 B<_globdir>
20274
20275 B<_run_all_tests>
20276
20277 B<_mk_leader>
20278
20279 B<_leader_width>
20280
20281 =over 4
20282
20283 =item EXPORT
20284
20285 =item DIAGNOSTICS
20286
20287 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
20288 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
20289 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
20290 %s>, C<FAILED--Further testing stopped: %s>
20291
20292 =item ENVIRONMENT
20293
20294 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
20295 C<HARNESS_DEBUG>, C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>,
20296 C<HARNESS_NOTTY>, C<HARNESS_OK_SLOW>, C<HARNESS_PERL>,
20297 C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
20298
20299 =item EXAMPLE
20300
20301 =item SEE ALSO
20302
20303 =item AUTHORS
20304
20305 =item LICENSE
20306
20307 =item TODO
20308
20309 =item BUGS
20310
20311 =item AUTHORS
20312
20313 =item COPYRIGHT
20314
20315 =back
20316
20317 =head2 Test::Harness::Assert - simple assert
20318
20319 =over 4
20320
20321 =item SYNOPSIS
20322
20323 =item DESCRIPTION
20324
20325 =item FUNCTIONS
20326
20327 =over 4
20328
20329 =item C<assert()>
20330
20331 =back
20332
20333 =back
20334
20335 =over 4
20336
20337 =item AUTHOR
20338
20339 =item SEE ALSO
20340
20341 =back
20342
20343 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
20344
20345 =over 4
20346
20347 =item SYNOPSIS
20348
20349 =item DESCRIPTION
20350
20351 =over 4
20352
20353 =item new()
20354
20355 =item next()
20356
20357 =back
20358
20359 =back
20360
20361 =head2 Test::Harness::Straps - detailed analysis of test results
20362
20363 =over 4
20364
20365 =item SYNOPSIS
20366
20367 =item DESCRIPTION
20368
20369 =item Construction
20370
20371 =over 4
20372
20373 =item C<new>
20374
20375 =back
20376
20377 =back
20378
20379 =over 4
20380
20381 =item C<_init>
20382
20383 =back
20384
20385 =over 4
20386
20387 =item Analysis
20388
20389 =over 4
20390
20391 =item C<analyze>
20392
20393 =back
20394
20395 =back
20396
20397 =over 4
20398
20399 =item C<analyze_fh>
20400
20401 =back
20402
20403 =over 4
20404
20405 =item C<analyze_file>
20406
20407 =back
20408
20409 =over 4
20410
20411 =item C<_command_line( $file )>
20412
20413 =back
20414
20415 =over 4
20416
20417 =item C<_command>
20418
20419 =back
20420
20421 =over 4
20422
20423 =item C<_switches>
20424
20425 =back
20426
20427 =over 4
20428
20429 =item C<_cleaned_switches>
20430
20431 =back
20432
20433 =over 4
20434
20435 =item C<_INC2PERL5LIB>
20436
20437 =back
20438
20439 =over 4
20440
20441 =item C<_filtered_INC>
20442
20443 =back
20444
20445 =over 4
20446
20447 =item C<_restore_PERL5LIB>
20448
20449 =back
20450
20451 =over 4
20452
20453 =item Parsing
20454
20455 =over 4
20456
20457 =item C<_is_comment>
20458
20459 =back
20460
20461 =back
20462
20463 =over 4
20464
20465 =item C<_is_header>
20466
20467 =back
20468
20469 =over 4
20470
20471 =item C<_is_test>
20472
20473 =back
20474
20475 =over 4
20476
20477 =item C<_is_bail_out>
20478
20479 =back
20480
20481 =over 4
20482
20483 =item C<_reset_file_state>
20484
20485 =back
20486
20487 =over 4
20488
20489 =item Results
20490
20491 =over 4
20492
20493 =item C<_detailize>
20494
20495 =back
20496
20497 =back
20498
20499 =over 4
20500
20501 =item EXAMPLES
20502
20503 =item AUTHOR
20504
20505 =item SEE ALSO
20506
20507 =back
20508
20509 =head2 Test::More - yet another framework for writing test scripts
20510
20511 =over 4
20512
20513 =item SYNOPSIS
20514
20515 =item DESCRIPTION
20516
20517 =over 4
20518
20519 =item I love it when a plan comes together
20520
20521 =back
20522
20523 =back
20524
20525 =over 4
20526
20527 =item Test names
20528
20529 =item I'm ok, you're not ok.
20530
20531 B<ok>
20532
20533 =back
20534
20535 B<is>, B<isnt>
20536
20537 B<like>
20538
20539 B<unlike>
20540
20541 B<cmp_ok>
20542
20543 B<can_ok>
20544
20545 B<isa_ok>
20546
20547 B<pass>, B<fail>
20548
20549 =over 4
20550
20551 =item Diagnostics
20552
20553 B<diag>
20554
20555 =back
20556
20557 =over 4
20558
20559 =item Module tests
20560
20561 B<use_ok>
20562
20563 =back
20564
20565 B<require_ok>
20566
20567 =over 4
20568
20569 =item Conditional tests
20570
20571 B<SKIP: BLOCK>
20572
20573 =back
20574
20575 B<TODO: BLOCK>, B<todo_skip>
20576
20577 When do I use SKIP vs. TODO?
20578
20579 =over 4
20580
20581 =item Comparison functions
20582
20583 B<is_deeply>
20584
20585 =back
20586
20587 B<eq_array>
20588
20589 B<eq_hash>
20590
20591 B<eq_set>
20592
20593 =over 4
20594
20595 =item Extending and Embedding Test::More
20596
20597 B<builder>
20598
20599 =back
20600
20601 =over 4
20602
20603 =item NOTES
20604
20605 =item BUGS and CAVEATS
20606
20607 Making your own ok(), The eq_* family has some caveats, Test::Harness
20608 upgrades
20609
20610 =item HISTORY
20611
20612 =item SEE ALSO
20613
20614 =item AUTHORS
20615
20616 =item COPYRIGHT
20617
20618 =back
20619
20620 =head2 Test::Simple - Basic utilities for writing tests.
20621
20622 =over 4
20623
20624 =item SYNOPSIS
20625
20626 =item DESCRIPTION
20627
20628 B<ok>
20629
20630 =back
20631
20632 =over 4
20633
20634 =item EXAMPLE
20635
20636 =item CAVEATS
20637
20638 =item NOTES
20639
20640 =item HISTORY
20641
20642 =item SEE ALSO
20643
20644 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
20645 L<Test::Harness>
20646
20647 =item AUTHORS
20648
20649 =item COPYRIGHT
20650
20651 =back
20652
20653 =head2 Test::Tutorial - A tutorial about writing really basic tests
20654
20655 =over 4
20656
20657 =item DESCRIPTION
20658
20659 =over 4
20660
20661 =item Nuts and bolts of testing.
20662
20663 =item Where to start?
20664
20665 =item Names
20666
20667 =item Test the manual
20668
20669 =item Sometimes the tests are wrong
20670
20671 =item Testing lots of values
20672
20673 =item Informative names
20674
20675 =item Skipping tests
20676
20677 =item Todo tests
20678
20679 =item Testing with taint mode.
20680
20681 =back
20682
20683 =item FOOTNOTES
20684
20685 =item AUTHORS
20686
20687 =item COPYRIGHT
20688
20689 =back
20690
20691 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
20692
20693 =over 4
20694
20695 =item SYNOPSIS
20696
20697 =item DESCRIPTION
20698
20699 =item EXAMPLE
20700
20701 =back
20702
20703 =head2 Text::Balanced - Extract delimited text sequences from strings.
20704
20705 =over 4
20706
20707 =item SYNOPSIS
20708
20709 =item DESCRIPTION
20710
20711 =over 4
20712
20713 =item General behaviour in list contexts
20714
20715 [0], [1], [2]
20716
20717 =item General behaviour in scalar and void contexts
20718
20719 =item A note about prefixes
20720
20721 =item C<extract_delimited>
20722
20723 =item C<extract_bracketed>
20724
20725 =item C<extract_variable>
20726
20727 [0], [1], [2]
20728
20729 =item C<extract_tagged>
20730
20731 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
20732 [0], [1], [2], [3], [4], [5]
20733
20734 =item C<gen_extract_tagged>
20735
20736 =item C<extract_quotelike>
20737
20738 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
20739
20740 =item C<extract_quotelike> and "here documents"
20741
20742 [0], [1], [2], [3], [4], [5], [6], [7..10]
20743
20744 =item C<extract_codeblock>
20745
20746 =item C<extract_multiple>
20747
20748 =item C<gen_delimited_pat>
20749
20750 =back
20751
20752 =item DIAGNOSTICS
20753
20754  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>, 
20755 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
20756 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">, 
20757 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
20758 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
20759 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
20760 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
20761 after dereferencer>, C<Did not find expected opening bracket at %s>,
20762 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
20763 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
20764 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
20765 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
20766 tag>
20767
20768 =item AUTHOR
20769
20770 =item BUGS AND IRRITATIONS
20771
20772 =item COPYRIGHT
20773
20774 =back
20775
20776 =head2 Text::ParseWords - parse text into an array of tokens or array of
20777 arrays
20778
20779 =over 4
20780
20781 =item SYNOPSIS
20782
20783 =item DESCRIPTION
20784
20785 =item EXAMPLES
20786
20787 =item AUTHORS
20788
20789 =back
20790
20791 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
20792 by Knuth
20793
20794 =over 4
20795
20796 =item SYNOPSIS
20797
20798 =item DESCRIPTION
20799
20800 =item EXAMPLES
20801
20802 =item LIMITATIONS
20803
20804 =item AUTHOR
20805
20806 =back
20807
20808 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
20809 unexpand(1)
20810
20811 =over 4
20812
20813 =item SYNOPSIS
20814
20815 =item DESCRIPTION
20816
20817 =item BUGS
20818
20819 =item AUTHOR
20820
20821 =back
20822
20823 =head2 Text::Wrap - line wrapping to form simple paragraphs
20824
20825 =over 4
20826
20827 =item SYNOPSIS 
20828
20829 =item DESCRIPTION
20830
20831 =item OVERRIDES
20832
20833 =item EXAMPLE
20834
20835 =item AUTHOR
20836
20837 =back
20838
20839 =head2 Thread - manipulate threads in Perl (for old code only)
20840
20841 =over 4
20842
20843 =item CAVEAT
20844
20845 =item SYNOPSIS
20846
20847 =item DESCRIPTION
20848
20849 =item FUNCTIONS
20850
20851 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
20852 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
20853 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
20854
20855 =item METHODS
20856
20857 join, eval, detach, equal, tid, flags, done
20858
20859 =item LIMITATIONS
20860
20861 =item SEE ALSO
20862
20863 =back
20864
20865 =head2 Thread::Queue - thread-safe queues
20866
20867 =over 4
20868
20869 =item SYNOPSIS
20870
20871 =item DESCRIPTION
20872
20873 =item FUNCTIONS AND METHODS
20874
20875 new, enqueue LIST, dequeue, dequeue_nb, pending
20876
20877 =item SEE ALSO
20878
20879 =back
20880
20881 =head2 Thread::Semaphore - thread-safe semaphores
20882
20883 =over 4
20884
20885 =item SYNOPSIS
20886
20887 =item DESCRIPTION
20888
20889 =item FUNCTIONS AND METHODS
20890
20891 new, new NUMBER, down, down NUMBER, up, up NUMBER
20892
20893 =back
20894
20895 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
20896 (for old code)
20897
20898 =over 4
20899
20900 =item CAVEAT
20901
20902 =item SYNOPSIS
20903
20904 =item DESCRIPTION
20905
20906 =item BUGS
20907
20908 =back
20909
20910 =head2 Thread::Specific - thread-specific keys
20911
20912 =over 4
20913
20914 =item SYNOPSIS
20915
20916 =item DESCRIPTION
20917
20918 =back
20919
20920 =head2 Tie::Array - base class for tied arrays
20921
20922 =over 4
20923
20924 =item SYNOPSIS
20925
20926 =item DESCRIPTION
20927
20928 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
20929 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
20930 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
20931 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
20932
20933 =item CAVEATS
20934
20935 =item AUTHOR
20936
20937 =back
20938
20939 =head2 Tie::File - Access the lines of a disk file via a Perl array
20940
20941 =over 4
20942
20943 =item SYNOPSIS
20944
20945 =item DESCRIPTION
20946
20947 =over 4
20948
20949 =item C<recsep>
20950
20951 =item C<autochomp>
20952
20953 =item C<mode>
20954
20955 =item C<memory>
20956
20957 =item C<dw_size>
20958
20959 =item Option Format
20960
20961 =back
20962
20963 =item Public Methods
20964
20965 =over 4
20966
20967 =item C<flock>
20968
20969 =item C<autochomp>
20970
20971 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
20972
20973 =item C<offset>
20974
20975 =back
20976
20977 =item Tying to an already-opened filehandle
20978
20979 =item Deferred Writing
20980
20981 =over 4
20982
20983 =item Autodeferring
20984
20985 =back
20986
20987 =item CONCURRENT ACCESS TO FILES
20988
20989 =item CAVEATS
20990
20991 =item SUBCLASSING
20992
20993 =item WHAT ABOUT C<DB_File>?
20994
20995 =item AUTHOR
20996
20997 =item LICENSE
20998
20999 =item WARRANTY
21000
21001 =item THANKS
21002
21003 =item TODO
21004
21005 =back
21006
21007 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
21008 handles
21009
21010 =over 4
21011
21012 =item SYNOPSIS
21013
21014 =item DESCRIPTION
21015
21016 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
21017 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
21018 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
21019 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
21020
21021 =item MORE INFORMATION
21022
21023 =item COMPATIBILITY
21024
21025 =back
21026
21027 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
21028 tied hashes
21029
21030 =over 4
21031
21032 =item SYNOPSIS
21033
21034 =item DESCRIPTION
21035
21036 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
21037 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR
21038 this, SCALAR this
21039
21040 =item Inheriting from B<Tie::StdHash>
21041
21042 =item Inheriting from B<Tie::ExtraHash>
21043
21044 =item C<SCALAR>, C<UNTIE> and C<DESTROY>
21045
21046 =item MORE INFORMATION
21047
21048 =back
21049
21050 =head2 Tie::Memoize - add data to hash when needed
21051
21052 =over 4
21053
21054 =item SYNOPSIS
21055
21056 =item DESCRIPTION
21057
21058 =item Inheriting from B<Tie::Memoize>
21059
21060 =item EXAMPLE
21061
21062 =item BUGS
21063
21064 =item AUTHOR
21065
21066 =back
21067
21068 =head2 Tie::RefHash - use references as hash keys
21069
21070 =over 4
21071
21072 =item SYNOPSIS
21073
21074 =item DESCRIPTION
21075
21076 =item EXAMPLE
21077
21078 =item AUTHOR
21079
21080 =item VERSION
21081
21082 =item SEE ALSO
21083
21084 =back
21085
21086 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
21087 scalars
21088
21089 =over 4
21090
21091 =item SYNOPSIS
21092
21093 =item DESCRIPTION
21094
21095 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
21096
21097 =item MORE INFORMATION
21098
21099 =back
21100
21101 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
21102
21103 =over 4
21104
21105 =item SYNOPSIS
21106
21107 =item DESCRIPTION
21108
21109 =item CAVEATS
21110
21111 =back
21112
21113 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
21114 timers
21115
21116 =over 4
21117
21118 =item SYNOPSIS
21119
21120 =item DESCRIPTION
21121
21122 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
21123 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
21124 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer (
21125 $which, $floating_seconds [, $interval_floating_seconds ] ), getitimer (
21126 $which )
21127
21128 =item EXAMPLES
21129
21130 =item C API
21131
21132 =item DIAGNOSTICS
21133
21134 =over 4
21135
21136 =item negative time not invented yet
21137
21138 =item internal error: useconds < 0 (unsigned ... signed ...)
21139
21140 =back
21141
21142 =item CAVEATS
21143
21144 =item AUTHORS
21145
21146 =item COPYRIGHT AND LICENSE
21147
21148 =back
21149
21150 =head2 Time::Local - efficiently compute time from local and GMT time
21151
21152 =over 4
21153
21154 =item SYNOPSIS
21155
21156 =item DESCRIPTION
21157
21158 =over 4
21159
21160 =item Ambiguous Local Times (DST)
21161
21162 =item Negative Epoch Values
21163
21164 =back
21165
21166 =item IMPLEMENTATION
21167
21168 =item BUGS
21169
21170 =item SUPPORT
21171
21172 =item AUTHOR
21173
21174 =back
21175
21176 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
21177 function
21178
21179 =over 4
21180
21181 =item SYNOPSIS
21182
21183 =item DESCRIPTION
21184
21185 =item NOTE
21186
21187 =item AUTHOR
21188
21189 =back
21190
21191 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
21192 function
21193
21194 =over 4
21195
21196 =item SYNOPSIS
21197
21198 =item DESCRIPTION
21199
21200 =item NOTE
21201
21202 =item AUTHOR
21203
21204 =back
21205
21206 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
21207
21208 =over 4
21209
21210 =item SYNOPSIS
21211
21212 =item DESCRIPTION
21213
21214 =item AUTHOR
21215
21216 =back
21217
21218 =head2 UNIVERSAL - base class for ALL classes (blessed references)
21219
21220 =over 4
21221
21222 =item SYNOPSIS
21223
21224 =item DESCRIPTION
21225
21226 C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<isa( VAL, TYPE )>,
21227 C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD ) >>, C<<
21228 CLASS->can( METHOD ) >>, C<can( VAL, METHOD )>, C<VERSION ( [ REQUIRE ] )>
21229
21230 =item EXPORTS
21231
21232 =back
21233
21234 =head2 Unicode::Collate - Unicode Collation Algorithm
21235
21236 =over 4
21237
21238 =item SYNOPSIS
21239
21240 =item DESCRIPTION
21241
21242 =over 4
21243
21244 =item Constructor and Tailoring
21245
21246 UCA_Version, backwards, entry, hangul_terminator, ignoreName, ignoreChar,
21247 level, normalization, overrideCJK, overrideHangul, preprocess, rearrange,
21248 table, undefName, undefChar, katakana_before_hiragana, upper_before_lower,
21249 variable, alternate
21250
21251 =item Methods for Collation
21252
21253 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
21254 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
21255 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
21256 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
21257 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
21258 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
21259 $Collator-E<gt>viewSortKey($string)>
21260
21261 =item Methods for Searching
21262
21263 C<$position = $Collator-E<gt>index($string, $substring[, $position])>,
21264 C<($position, $length) = $Collator-E<gt>index($string, $substring[,
21265 $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>,
21266 C<($match)   = $Collator-E<gt>match($string, $substring)>, C<@match =
21267 $Collator-E<gt>gmatch($string, $substring)>, C<$count =
21268 $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count =
21269 $Collator-E<gt>gsubst($string, $substring, $replacement)>
21270
21271 =item Other Methods
21272
21273 C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, C<$version =
21274 $Collator-E<gt>version()>, C<UCA_Version()>, C<Base_Unicode_Version()>
21275
21276 =item EXPORT
21277
21278 =item CAVEAT
21279
21280 =item Conformance Test
21281
21282 =back
21283
21284 =item AUTHOR
21285
21286 =item SEE ALSO
21287
21288 Unicode Collation Algorithm - UTS #10, The Default Unicode Collation
21289 Element Table (DUCET), The conformance test for the UCA, Hangul Syllable
21290 Type, Unicode Normalization Forms - UAX #15, L<Unicode::Normalize>
21291
21292 =back
21293
21294 =head2 Unicode::Normalize - Unicode Normalization Forms
21295
21296 =over 4
21297
21298 =item SYNOPSIS
21299
21300 =item DESCRIPTION
21301
21302 =over 4
21303
21304 =item Normalization Forms
21305
21306 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
21307 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
21308 C<$FCD_string = FCD($string)>, C<$FCC_string = FCC($string)>,
21309 C<$normalized_string = normalize($form_name, $string)>
21310
21311 =item Decomposition and Composition
21312
21313 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
21314 decompose($string, $useCompatMapping)>, C<$reordered_string  =
21315 reorder($string)>, C<$composed_string   = compose($string)>
21316
21317 =item Quick Check
21318
21319 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
21320 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
21321 checkFCD($string)>, C<$result = checkFCC($string)>, C<$result =
21322 check($form_name, $string)>
21323
21324 =item Character Data
21325
21326 C<$canonical_decomposed = getCanon($codepoint)>,
21327 C<$compatibility_decomposed = getCompat($codepoint)>,
21328 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
21329 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
21330 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
21331 C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>,
21332 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
21333
21334 =item EXPORT
21335
21336 =back
21337
21338 =item AUTHOR
21339
21340 =item SEE ALSO
21341
21342 http://www.unicode.org/reports/tr15/,
21343 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt,
21344 http://www.unicode.org/notes/tn5/
21345
21346 =back
21347
21348 =head2 Unicode::UCD - Unicode character database
21349
21350 =over 4
21351
21352 =item SYNOPSIS
21353
21354 =item DESCRIPTION
21355
21356 =back
21357
21358 =over 4
21359
21360 =item charinfo
21361
21362 =back
21363
21364 =over 4
21365
21366 =item charblock
21367
21368 =back
21369
21370 =over 4
21371
21372 =item charscript
21373
21374 =back
21375
21376 =over 4
21377
21378 =item charblocks
21379
21380 =back
21381
21382 =over 4
21383
21384 =item charscripts
21385
21386 =back
21387
21388 =over 4
21389
21390 =item Blocks versus Scripts
21391
21392 =item Matching Scripts and Blocks
21393
21394 =item Code Point Arguments
21395
21396 =item charinrange
21397
21398 =back
21399
21400 =over 4
21401
21402 =item compexcl
21403
21404 =back
21405
21406 =over 4
21407
21408 =item casefold
21409
21410 =back
21411
21412 =over 4
21413
21414 =item casespec
21415
21416 =back
21417
21418 =over 4
21419
21420 =item Unicode::UCD::UnicodeVersion
21421
21422 =back
21423
21424 =over 4
21425
21426 =item Implementation Note
21427
21428 =back
21429
21430 =over 4
21431
21432 =item BUGS
21433
21434 =item AUTHOR
21435
21436 =back
21437
21438 =head2 User::grent - by-name interface to Perl's built-in getgr*()
21439 functions
21440
21441 =over 4
21442
21443 =item SYNOPSIS
21444
21445 =item DESCRIPTION
21446
21447 =item NOTE
21448
21449 =item AUTHOR
21450
21451 =back
21452
21453 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
21454 functions
21455
21456 =over 4
21457
21458 =item SYNOPSIS
21459
21460 =item DESCRIPTION
21461
21462 =over 4
21463
21464 =item System Specifics
21465
21466 =back
21467
21468 =item NOTE
21469
21470 =item AUTHOR
21471
21472 =item HISTORY
21473
21474 March 18th, 2000
21475
21476 =back
21477
21478 =head2 Win32 - Interfaces to some Win32 API Functions
21479
21480 =over 4
21481
21482 =item DESCRIPTION
21483
21484 =over 4
21485
21486 =item Alphabetical Listing of Win32 Functions
21487
21488 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
21489 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
21490 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
21491 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
21492 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFolderPath(FOLDER [,
21493 CREATE]), Win32::GetFullPathName(FILENAME), Win32::GetLastError(),
21494 Win32::GetLongPathName(PATHNAME), Win32::GetNextAvailDrive(),
21495 Win32::GetOSVersion(), Win32::GetOSName(),
21496 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
21497 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
21498 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
21499 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
21500 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
21501 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
21502 Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
21503 Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
21504 Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
21505 Win32::UnregisterServer(LIBRARYNAME)
21506
21507 =back
21508
21509 =back
21510
21511 =head2 XSLoader - Dynamically load C libraries into Perl code
21512
21513 =over 4
21514
21515 =item SYNOPSIS
21516
21517 =item DESCRIPTION
21518
21519 =over 4
21520
21521 =item Migration from C<DynaLoader>
21522
21523 =item Backward compatible boilerplate
21524
21525 =back
21526
21527 =item Order of initialization: early load()
21528
21529 =over 4
21530
21531 =item The most hairy case
21532
21533 =back
21534
21535 =item LIMITATIONS
21536
21537 =item AUTHOR
21538
21539 =back
21540
21541 =head1 AUXILIARY DOCUMENTATION
21542
21543 Here should be listed all the extra programs' documentation, but they
21544 don't all have manual pages yet:
21545
21546 =over 4
21547
21548 =item a2p
21549
21550 =item c2ph
21551
21552 =item dprofpp
21553
21554 =item h2ph
21555
21556 =item h2xs
21557
21558 =item perlbug
21559
21560 =item perldoc
21561
21562 =item pl2pm
21563
21564 =item pod2html
21565
21566 =item pod2man
21567
21568 =item s2p
21569
21570 =item splain
21571
21572 =item xsubpp
21573
21574 =back
21575
21576 =head1 AUTHOR
21577
21578 Larry Wall <F<larry@wall.org>>, with the help of oodles
21579 of other folks.
21580