Add perl586delta.pod to all the necessary makefiles and tables of
[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: 2004/10/05
769 22:15:44 $)
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.15 $, $Date:
833 2004/10/11 05:06: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.29 $,
882 $Date: 2004/10/25 18:37:23 $)
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.41 $, $Date: 2004/11/03
938 22:45:32 $)
939
940 =over 4
941
942 =item DESCRIPTION
943
944 =over 4
945
946 =item How do I do (anything)?
947
948 =item How can I use Perl interactively?
949
950 =item Is there a Perl shell?
951
952 =item How do I find which modules are installed on my system?
953
954 =item How do I debug my Perl programs?
955
956 =item How do I profile my Perl programs?
957
958 =item How do I cross-reference my Perl programs?
959
960 =item Is there a pretty-printer (formatter) for Perl?
961
962 =item Is there a ctags for Perl?
963
964 =item Is there an IDE or Windows Perl Editor?
965
966 Eclipse, Komodo, Open Perl IDE, OptiPerl, PerlBuilder, visiPerl+, Visual
967 Perl, GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis, Vile, Vim, Codewright,
968 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, Affrus, Alpha, BBEdit and
969 BBEdit Lite
970
971 =item Where can I get Perl macros for vi?
972
973 =item Where can I get perl-mode for emacs?
974
975 =item How can I use curses with Perl?
976
977 =item How can I use X or Tk with Perl?
978
979 =item How can I generate simple menus without using CGI or Tk?
980
981 =item How can I make my Perl program run faster?
982
983 =item How can I make my Perl program take less memory?
984
985 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
986 stringification, Pass by reference, Tie large variables to disk
987
988 =item Is it safe to return a reference to local or lexical data?
989
990 =item How can I free an array or hash so my program shrinks?
991
992 =item How can I make my CGI script more efficient?
993
994 =item How can I hide the source for my Perl program?
995
996 =item How can I compile my Perl program into byte code or C?
997
998 =item How can I compile Perl into Java?
999
1000 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
1001
1002 =item Can I write useful Perl programs on the command line?
1003
1004 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
1005
1006 =item Where can I learn about CGI or Web programming in Perl?
1007
1008 =item Where can I learn about object-oriented Perl programming?
1009
1010 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
1011
1012 =item I've read perlembed, perlguts, etc., but I can't embed perl in
1013 my C program; what am I doing wrong?
1014
1015 =item When I tried to run my script, I got this message. What does it mean?
1016
1017 =item What's MakeMaker?
1018
1019 =back
1020
1021 =item AUTHOR AND COPYRIGHT
1022
1023 =back
1024
1025 =head2 perlfaq4 - Data Manipulation ($Revision: 1.56 $, $Date: 2004/11/03
1026 22:47:56 $)
1027
1028 =over 4
1029
1030 =item DESCRIPTION
1031
1032 =item Data: Numbers
1033
1034 =over 4
1035
1036 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
1037 numbers I should be getting (eg, 19.95)?
1038
1039 =item Why is int() broken?
1040
1041 =item Why isn't my octal data interpreted correctly?
1042
1043 =item Does Perl have a round() function?  What about ceil() and floor()? 
1044 Trig functions?
1045
1046 =item How do I convert between numeric representations/bases/radixes?
1047
1048 How do I convert hexadecimal into decimal, How do I convert from decimal to
1049 hexadecimal, How do I convert from octal to decimal, How do I convert from
1050 decimal to octal, How do I convert from binary to decimal, How do I convert
1051 from decimal to binary
1052
1053 =item Why doesn't & work the way I want it to?
1054
1055 =item How do I multiply matrices?
1056
1057 =item How do I perform an operation on a series of integers?
1058
1059 =item How can I output Roman numerals?
1060
1061 =item Why aren't my random numbers random?
1062
1063 =item How do I get a random number between X and Y?
1064
1065 =back
1066
1067 =item Data: Dates
1068
1069 =over 4
1070
1071 =item How do I find the day or week of the year?
1072
1073 =item How do I find the current century or millennium?
1074
1075 =item How can I compare two dates and find the difference?
1076
1077 =item How can I take a string and turn it into epoch seconds?
1078
1079 =item How can I find the Julian Day?
1080
1081 =item How do I find yesterday's date?
1082
1083 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
1084
1085 =back
1086
1087 =item Data: Strings
1088
1089 =over 4
1090
1091 =item How do I validate input?
1092
1093 =item How do I unescape a string?
1094
1095 =item How do I remove consecutive pairs of characters?
1096
1097 =item How do I expand function calls in a string?
1098
1099 =item How do I find matching/nesting anything?
1100
1101 =item How do I reverse a string?
1102
1103 =item How do I expand tabs in a string?
1104
1105 =item How do I reformat a paragraph?
1106
1107 =item How can I access or change N characters of a string?
1108
1109 =item How do I change the Nth occurrence of something?
1110
1111 =item How can I count the number of occurrences of a substring within a
1112 string?
1113
1114 =item How do I capitalize all the words on one line?
1115
1116 =item How can I split a [character] delimited string except when inside
1117 [character]?
1118
1119 =item How do I strip blank space from the beginning/end of a string?
1120
1121 =item How do I pad a string with blanks or pad a number with zeroes?
1122
1123 =item How do I extract selected columns from a string?
1124
1125 =item How do I find the soundex value of a string?
1126
1127 =item How can I expand variables in text strings?
1128
1129 =item What's wrong with always quoting "$vars"?
1130
1131 =item Why don't my E<lt>E<lt>HERE documents work?
1132
1133 There must be no space after the E<lt>E<lt> part, There (probably) should
1134 be a semicolon at the end, You can't (easily) have any space in front of
1135 the tag
1136
1137 =back
1138
1139 =item Data: Arrays
1140
1141 =over 4
1142
1143 =item What is the difference between a list and an array?
1144
1145 =item What is the difference between $array[1] and @array[1]?
1146
1147 =item How can I remove duplicate elements from a list or array?
1148
1149 a), b), c), d), e)
1150
1151 =item How can I tell whether a certain element is contained in a list or
1152 array?
1153
1154 =item How do I compute the difference of two arrays?  How do I compute the
1155 intersection of two arrays?
1156
1157 =item How do I test whether two arrays or hashes are equal?
1158
1159 =item How do I find the first array element for which a condition is true?
1160
1161 =item How do I handle linked lists?
1162
1163 =item How do I handle circular lists?
1164
1165 =item How do I shuffle an array randomly?
1166
1167 =item How do I process/modify each element of an array?
1168
1169 =item How do I select a random element from an array?
1170
1171 =item How do I permute N elements of a list?
1172
1173 =item How do I sort an array by (anything)?
1174
1175 =item How do I manipulate arrays of bits?
1176
1177 =item Why does defined() return true on empty arrays and hashes?
1178
1179 =back
1180
1181 =item Data: Hashes (Associative Arrays)
1182
1183 =over 4
1184
1185 =item How do I process an entire hash?
1186
1187 =item What happens if I add or remove keys from a hash while iterating over
1188 it?
1189
1190 =item How do I look up a hash element by value?
1191
1192 =item How can I know how many entries are in a hash?
1193
1194 =item How do I sort a hash (optionally by value instead of key)?
1195
1196 =item How can I always keep my hash sorted?
1197
1198 =item What's the difference between "delete" and "undef" with hashes?
1199
1200 =item Why don't my tied hashes make the defined/exists distinction?
1201
1202 =item How do I reset an each() operation part-way through?
1203
1204 =item How can I get the unique keys from two hashes?
1205
1206 =item How can I store a multidimensional array in a DBM file?
1207
1208 =item How can I make my hash remember the order I put elements into it?
1209
1210 =item Why does passing a subroutine an undefined element in a hash create
1211 it?
1212
1213 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
1214 array of hashes or arrays?
1215
1216 =item How can I use a reference as a hash key?
1217
1218 =back
1219
1220 =item Data: Misc
1221
1222 =over 4
1223
1224 =item How do I handle binary data correctly?
1225
1226 =item How do I determine whether a scalar is a number/whole/integer/float?
1227
1228 =item How do I keep persistent data across program calls?
1229
1230 =item How do I print out or copy a recursive data structure?
1231
1232 =item How do I define methods for every class/object?
1233
1234 =item How do I verify a credit card checksum?
1235
1236 =item How do I pack arrays of doubles or floats for XS code?
1237
1238 =back
1239
1240 =item AUTHOR AND COPYRIGHT
1241
1242 =back
1243
1244 =head2 perlfaq5 - Files and Formats ($Revision: 1.31 $, $Date: 2004/02/07
1245 04:29:50 $)
1246
1247 =over 4
1248
1249 =item DESCRIPTION
1250
1251 =over 4
1252
1253 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
1254
1255 =item How do I change one line in a file/delete a line in a file/insert a
1256 line in the middle of a file/append to the beginning of a file?
1257
1258 =item How do I count the number of lines in a file?
1259
1260 =item How can I use Perl's C<-i> option from within a program?
1261
1262 =item How do I make a temporary file name?
1263
1264 =item How can I manipulate fixed-record-length files?
1265
1266 =item How can I make a filehandle local to a subroutine?  How do I pass
1267 filehandles between subroutines?  How do I make an array of filehandles?
1268
1269 =item How can I use a filehandle indirectly?
1270
1271 =item How can I set up a footer format to be used with write()?
1272
1273 =item How can I write() into a string?
1274
1275 =item How can I output my numbers with commas added?
1276
1277 =item How can I translate tildes (~) in a filename?
1278
1279 =item How come when I open a file read-write it wipes it out?
1280
1281 =item Why do I sometimes get an "Argument list too long" when I use
1282 E<lt>*E<gt>?
1283
1284 =item Is there a leak/bug in glob()?
1285
1286 =item How can I open a file with a leading ">" or trailing blanks?
1287
1288 =item How can I reliably rename a file?
1289
1290 =item How can I lock a file?
1291
1292 =item Why can't I just open(FH, "E<gt>file.lock")?
1293
1294 =item I still don't get locking.  I just want to increment the number in
1295 the file.  How can I do this?
1296
1297 =item All I want to do is append a small amount of text to the end of a
1298 file.  Do I still have to use locking?
1299
1300 =item How do I randomly update a binary file?
1301
1302 =item How do I get a file's timestamp in perl?
1303
1304 =item How do I set a file's timestamp in perl?
1305
1306 =item How do I print to more than one file at once?
1307
1308 =item How can I read in an entire file all at once?
1309
1310 =item How can I read in a file by paragraphs?
1311
1312 =item How can I read a single character from a file?  From the keyboard?
1313
1314 =item How can I tell whether there's a character waiting on a filehandle?
1315
1316 =item How do I do a C<tail -f> in perl?
1317
1318 =item How do I dup() a filehandle in Perl?
1319
1320 =item How do I close a file descriptor by number?
1321
1322 =item Why can't I use "C:\temp\foo" in DOS paths?  Why doesn't
1323 `C:\temp\foo.exe` work?
1324
1325 =item Why doesn't glob("*.*") get all the files?
1326
1327 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
1328 protected files?  Isn't this a bug in Perl?
1329
1330 =item How do I select a random line from a file?
1331
1332 =item Why do I get weird spaces when I print an array of lines?
1333
1334 =back
1335
1336 =item AUTHOR AND COPYRIGHT
1337
1338 =back
1339
1340 =head2 perlfaq6 - Regular Expressions ($Revision: 1.27 $, $Date: 2004/11/03
1341 22:52:16 $)
1342
1343 =over 4
1344
1345 =item DESCRIPTION
1346
1347 =over 4
1348
1349 =item How can I hope to use regular expressions without creating illegible
1350 and unmaintainable code?
1351
1352 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
1353
1354 =item I'm having trouble matching over more than one line.  What's wrong?
1355
1356 =item How can I pull out lines between two patterns that are themselves on
1357 different lines?
1358
1359 =item I put a regular expression into $/ but it didn't work. What's wrong?
1360
1361 =item How do I substitute case insensitively on the LHS while preserving
1362 case on the RHS?
1363
1364 =item How can I make C<\w> match national character sets?
1365
1366 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
1367
1368 =item How can I quote a variable to use in a regex?
1369
1370 =item What is C</o> really for?
1371
1372 =item How do I use a regular expression to strip C style comments from a
1373 file?
1374
1375 =item Can I use Perl regular expressions to match balanced text?
1376
1377 =item What does it mean that regexes are greedy?  How can I get around it?
1378
1379 =item How do I process each word on each line?
1380
1381 =item How can I print out a word-frequency or line-frequency summary?
1382
1383 =item How can I do approximate matching?
1384
1385 =item How do I efficiently match many regular expressions at once?
1386
1387 =item Why don't word-boundary searches with C<\b> work for me?
1388
1389 =item Why does using $&, $`, or $' slow my program down?
1390
1391 =item What good is C<\G> in a regular expression?
1392
1393 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
1394
1395 =item What's wrong with using grep in a void context?
1396
1397 =item How can I match strings with multibyte characters?
1398
1399 =item How do I match a pattern that is supplied by the user?
1400
1401 =back
1402
1403 =item AUTHOR AND COPYRIGHT
1404
1405 =back
1406
1407 =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.18 $, $Date:
1408 2004/11/03 22:54:08 $)
1409
1410 =over 4
1411
1412 =item DESCRIPTION
1413
1414 =over 4
1415
1416 =item Can I get a BNF/yacc/RE for the Perl language?
1417
1418 =item What are all these $@%&* punctuation signs, and how do I know when to
1419 use them?
1420
1421 =item Do I always/never have to quote my strings or use semicolons and
1422 commas?
1423
1424 =item How do I skip some return values?
1425
1426 =item How do I temporarily block warnings?
1427
1428 =item What's an extension?
1429
1430 =item Why do Perl operators have different precedence than C operators?
1431
1432 =item How do I declare/create a structure?
1433
1434 =item How do I create a module?
1435
1436 =item How do I create a class?
1437
1438 =item How can I tell if a variable is tainted?
1439
1440 =item What's a closure?
1441
1442 =item What is variable suicide and how can I prevent it?
1443
1444 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
1445 Regex}?
1446
1447 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
1448 Passing Methods
1449
1450 =item How do I create a static variable?
1451
1452 =item What's the difference between dynamic and lexical (static) scoping? 
1453 Between local() and my()?
1454
1455 =item How can I access a dynamic variable while a similarly named lexical
1456 is in scope?
1457
1458 =item What's the difference between deep and shallow binding?
1459
1460 =item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?
1461
1462 =item How do I redefine a builtin function, operator, or method?
1463
1464 =item What's the difference between calling a function as &foo and foo()?
1465
1466 =item How do I create a switch or case statement?
1467
1468 =item How can I catch accesses to undefined variables, functions, or
1469 methods?
1470
1471 =item Why can't a method included in this same file be found?
1472
1473 =item How can I find out my current package?
1474
1475 =item How can I comment out a large block of perl code?
1476
1477 =item How do I clear a package?
1478
1479 =item How can I use a variable as a variable name?
1480
1481 =item What does "bad interpreter" mean?
1482
1483 =back
1484
1485 =item AUTHOR AND COPYRIGHT
1486
1487 =back
1488
1489 =head2 perlfaq8 - System Interaction ($Revision: 1.22 $, $Date: 2004/10/05
1490 22:13:49 $)
1491
1492 =over 4
1493
1494 =item DESCRIPTION
1495
1496 =over 4
1497
1498 =item How do I find out which operating system I'm running under?
1499
1500 =item How come exec() doesn't return?
1501
1502 =item How do I do fancy stuff with the keyboard/screen/mouse?
1503
1504 Keyboard, Screen, Mouse
1505
1506 =item How do I print something out in color?
1507
1508 =item How do I read just one key without waiting for a return key?
1509
1510 =item How do I check whether input is ready on the keyboard?
1511
1512 =item How do I clear the screen?
1513
1514 =item How do I get the screen size?
1515
1516 =item How do I ask the user for a password?
1517
1518 =item How do I read and write the serial port?
1519
1520 lockfiles, open mode, end of line, flushing output, non-blocking input
1521
1522 =item How do I decode encrypted password files?
1523
1524 =item How do I start a process in the background?
1525
1526 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
1527
1528 =item How do I trap control characters/signals?
1529
1530 =item How do I modify the shadow password file on a Unix system?
1531
1532 =item How do I set the time and date?
1533
1534 =item How can I sleep() or alarm() for under a second?
1535
1536 =item How can I measure time under a second?
1537
1538 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
1539
1540 =item Why doesn't my sockets program work under System V (Solaris)?  What
1541 does the error message "Protocol not supported" mean?
1542
1543 =item How can I call my system's unique C functions from Perl?
1544
1545 =item Where do I get the include files to do ioctl() or syscall()?
1546
1547 =item Why do setuid perl scripts complain about kernel problems?
1548
1549 =item How can I open a pipe both to and from a command?
1550
1551 =item Why can't I get the output of a command with system()?
1552
1553 =item How can I capture STDERR from an external command?
1554
1555 =item Why doesn't open() return an error when a pipe open fails?
1556
1557 =item What's wrong with using backticks in a void context?
1558
1559 =item How can I call backticks without shell processing?
1560
1561 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
1562 ^Z on MS-DOS)?
1563
1564 =item How can I convert my shell script to perl?
1565
1566 =item Can I use perl to run a telnet or ftp session?
1567
1568 =item How can I write expect in Perl?
1569
1570 =item Is there a way to hide perl's command line from programs such as
1571 "ps"?
1572
1573 =item I {changed directory, modified my environment} in a perl script.  How
1574 come the change disappeared when I exited the script?  How do I get my
1575 changes to be visible?
1576
1577 Unix
1578
1579 =item How do I close a process's filehandle without waiting for it to
1580 complete?
1581
1582 =item How do I fork a daemon process?
1583
1584 =item How do I find out if I'm running interactively or not?
1585
1586 =item How do I timeout a slow event?
1587
1588 =item How do I set CPU limits?
1589
1590 =item How do I avoid zombies on a Unix system?
1591
1592 =item How do I use an SQL database?
1593
1594 =item How do I make a system() exit on control-C?
1595
1596 =item How do I open a file without blocking?
1597
1598 =item How do I tell the difference between errors from the shell and perl?
1599
1600 =item How do I install a module from CPAN?
1601
1602 =item What's the difference between require and use?
1603
1604 =item How do I keep my own module/library directory?
1605
1606 =item How do I add the directory my program lives in to the module/library
1607 search path?
1608
1609 =item How do I add a directory to my include path (@INC) at runtime?
1610
1611 =item What is socket.ph and where do I get it?
1612
1613 =back
1614
1615 =item AUTHOR AND COPYRIGHT
1616
1617 =back
1618
1619 =head2 perlfaq9 - Networking ($Revision: 1.16 $, $Date: 2004/10/30 12:20:59
1620 $)
1621
1622 =over 4
1623
1624 =item DESCRIPTION
1625
1626 =over 4
1627
1628 =item What is the correct form of response from a CGI script?
1629
1630 =item My CGI script runs from the command line but not the browser.  (500
1631 Server Error)
1632
1633 =item How can I get better error messages from a CGI program?
1634
1635 =item How do I remove HTML from a string?
1636
1637 =item How do I extract URLs?
1638
1639 =item How do I download a file from the user's machine?  How do I open a
1640 file on another machine?
1641
1642 =item How do I make a pop-up menu in HTML?
1643
1644 =item How do I fetch an HTML file?
1645
1646 =item How do I automate an HTML form submission?
1647
1648 =item How do I decode or create those %-encodings on the web?
1649
1650 =item How do I redirect to another page?
1651
1652 =item How do I put a password on my web pages?
1653
1654 =item How do I edit my .htpasswd and .htgroup files with Perl?
1655
1656 =item How do I make sure users can't enter values into a form that cause my
1657 CGI script to do bad things?
1658
1659 =item How do I parse a mail header?
1660
1661 =item How do I decode a CGI form?
1662
1663 =item How do I check a valid mail address?
1664
1665 =item How do I decode a MIME/BASE64 string?
1666
1667 =item How do I return the user's mail address?
1668
1669 =item How do I send mail?
1670
1671 =item How do I use MIME to make an attachment to a mail message?
1672
1673 =item How do I read mail?
1674
1675 =item How do I find out my hostname/domainname/IP address?
1676
1677 =item How do I fetch a news article or the active newsgroups?
1678
1679 =item How do I fetch/put an FTP file?
1680
1681 =item How can I do RPC in Perl?
1682
1683 =back
1684
1685 =item AUTHOR AND COPYRIGHT
1686
1687 =back
1688
1689 =head2 perlsyn - Perl syntax
1690
1691 =over 4
1692
1693 =item DESCRIPTION
1694
1695 =over 4
1696
1697 =item Declarations
1698
1699 =item Comments
1700
1701 =item Simple Statements
1702
1703 =item Truth and Falsehood
1704
1705 =item Statement Modifiers
1706
1707 =item Compound Statements
1708
1709 =item Loop Control
1710
1711 =item For Loops
1712
1713 =item Foreach Loops
1714
1715 =item Basic BLOCKs and Switch Statements
1716
1717 =item Goto
1718
1719 =item PODs: Embedded Documentation
1720
1721 =item Plain Old Comments (Not!)
1722
1723 =back
1724
1725 =back
1726
1727 =head2 perldata - Perl data types
1728
1729 =over 4
1730
1731 =item DESCRIPTION
1732
1733 =over 4
1734
1735 =item Variable names
1736
1737 =item Context
1738
1739 =item Scalar values
1740
1741 =item Scalar value constructors
1742
1743 =item List value constructors
1744
1745 =item Subscripts
1746
1747 =item Slices
1748
1749 =item Typeglobs and Filehandles
1750
1751 =back
1752
1753 =item SEE ALSO
1754
1755 =back
1756
1757 =head2 perlop - Perl operators and precedence
1758
1759 =over 4
1760
1761 =item DESCRIPTION
1762
1763 =over 4
1764
1765 =item Operator Precedence and Associativity
1766
1767 =item Terms and List Operators (Leftward)
1768
1769 =item The Arrow Operator
1770
1771 =item Auto-increment and Auto-decrement
1772
1773 =item Exponentiation
1774
1775 =item Symbolic Unary Operators
1776
1777 =item Binding Operators
1778
1779 =item Multiplicative Operators
1780
1781 =item Additive Operators
1782
1783 =item Shift Operators
1784
1785 =item Named Unary Operators
1786
1787 =item Relational Operators
1788
1789 =item Equality Operators
1790
1791 =item Bitwise And
1792
1793 =item Bitwise Or and Exclusive Or
1794
1795 =item C-style Logical And
1796
1797 =item C-style Logical Or
1798
1799 =item C-style Logical Defined-Or
1800
1801 =item Range Operators
1802
1803 =item Conditional Operator
1804
1805 =item Assignment Operators
1806
1807 =item Comma Operator
1808
1809 =item List Operators (Rightward)
1810
1811 =item Logical Not
1812
1813 =item Logical And
1814
1815 =item Logical or, Defined or, and Exclusive Or
1816
1817 =item C Operators Missing From Perl
1818
1819 unary &, unary *, (TYPE)
1820
1821 =item Quote and Quote-like Operators
1822
1823 =item Regexp Quote-Like Operators
1824
1825 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
1826 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
1827 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
1828 y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF
1829
1830 =item Gory details of parsing quoted constructs
1831
1832 Finding the end, Removal of backslashes before delimiters, Interpolation,
1833 C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
1834 C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>,
1835 C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
1836 regular expressions
1837
1838 =item I/O Operators
1839
1840 =item Constant Folding
1841
1842 =item No-ops
1843
1844 =item Bitwise String Operators
1845
1846 =item Integer Arithmetic
1847
1848 =item Floating-point Arithmetic
1849
1850 =item Bigger Numbers
1851
1852 =back
1853
1854 =back
1855
1856 =head2 perlsub - Perl subroutines
1857
1858 =over 4
1859
1860 =item SYNOPSIS
1861
1862 =item DESCRIPTION
1863
1864 =over 4
1865
1866 =item Private Variables via my()
1867
1868 =item Persistent Private Variables
1869
1870 =item Temporary Values via local()
1871
1872 =item Lvalue subroutines
1873
1874 Lvalue subroutines are EXPERIMENTAL
1875
1876 =item Passing Symbol Table Entries (typeglobs)
1877
1878 =item When to Still Use local()
1879
1880 =item Pass by Reference
1881
1882 =item Prototypes
1883
1884 =item Constant Functions
1885
1886 =item Overriding Built-in Functions
1887
1888 =item Autoloading
1889
1890 =item Subroutine Attributes
1891
1892 =back
1893
1894 =item SEE ALSO
1895
1896 =back
1897
1898 =head2 perlfunc - Perl builtin functions
1899
1900 =over 4
1901
1902 =item DESCRIPTION
1903
1904 =over 4
1905
1906 =item Perl Functions by Category
1907
1908 Functions for SCALARs or strings, Regular expressions and pattern matching,
1909 Numeric functions, Functions for real @ARRAYs, Functions for list data,
1910 Functions for real %HASHes, Input and output functions, Functions for fixed
1911 length data or records, Functions for filehandles, files, or directories,
1912 Keywords related to the control flow of your perl program, Keywords related
1913 to scoping, Miscellaneous functions, Functions for processes and process
1914 groups, Keywords related to perl modules, Keywords related to classes and
1915 object-orientedness, Low-level socket functions, System V interprocess
1916 communication functions, Fetching user and group info, Fetching network
1917 info, Time-related functions, Functions new in perl5, Functions obsoleted
1918 in perl5
1919
1920 =item Portability
1921
1922 =item Alphabetical Listing of Perl Functions
1923
1924 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, abs VALUE, abs, accept
1925 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
1926 binmode FILEHANDLE, LAYER, binmode FILEHANDLE, bless REF,CLASSNAME, bless
1927 REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE, chomp(
1928 LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr NUMBER,
1929 chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE,
1930 connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT,
1931 dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete
1932 EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump,
1933 each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST,
1934 exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl
1935 FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION,
1936 fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin,
1937 getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam
1938 NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname
1939 NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr
1940 ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
1941 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
1942 getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent
1943 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
1944 endhostent, endnetent, endprotoent, endservent, getsockname SOCKET,
1945 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL,
1946 goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex,
1947 import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
1948 FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST,
1949 last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length,
1950 link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR,
1951 lock THING, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map
1952 EXPR,LIST, mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget
1953 KEY,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my
1954 TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL, next, no
1955 Module VERSION LIST, no Module VERSION, no Module LIST, no Module, oct
1956 EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open
1957 FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE,MODE,REFERENCE, open FILEHANDLE,
1958 opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR TYPE, our EXPR :
1959 ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST, package NAMESPACE,
1960 package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos,
1961 print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST,
1962 printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/,
1963 qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta,
1964 rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
1965 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
1966 readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
1967 ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR,
1968 require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir
1969 DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME,
1970 rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir
1971 DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT,
1972 semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
1973 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
1974 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
1975 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
1976 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
1977 EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
1978 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
1979 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
1980 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split
1981 /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, format
1982 parameter index, flags, vector flag, (minimum) width, precision, or maximum
1983 width, size, order of arguments, sqrt EXPR, sqrt, srand EXPR, srand, stat
1984 FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub NAME BLOCK, sub NAME
1985 (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK,
1986 substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
1987 EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall NUMBER, LIST, sysopen
1988 FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
1989 FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
1990 FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite
1991 FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH,
1992 syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie
1993 VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate
1994 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR,
1995 ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack
1996 TEMPLATE,EXPR, unpack TEMPLATE, untie VARIABLE, unshift ARRAY,LIST, use
1997 Module VERSION LIST, use Module VERSION, use Module LIST, use Module, use
1998 VERSION, utime LIST, values HASH, vec EXPR,OFFSET,BITS, wait, waitpid
1999 PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y///
2000
2001 =back
2002
2003 =back
2004
2005 =head2 perlopentut - tutorial on opening things in Perl
2006
2007 =over 4
2008
2009 =item DESCRIPTION
2010
2011 =item Open E<agrave> la shell
2012
2013 =over 4
2014
2015 =item Simple Opens
2016
2017 =item Indirect Filehandles
2018
2019 =item Pipe Opens
2020
2021 =item The Minus File
2022
2023 =item Mixing Reads and Writes
2024
2025 =item Filters 
2026
2027 =back
2028
2029 =item Open E<agrave> la C
2030
2031 =over 4
2032
2033 =item Permissions E<agrave> la mode
2034
2035 =back
2036
2037 =item Obscure Open Tricks
2038
2039 =over 4
2040
2041 =item Re-Opening Files (dups)
2042
2043 =item Dispelling the Dweomer
2044
2045 =item Paths as Opens
2046
2047 =item Single Argument Open
2048
2049 =item Playing with STDIN and STDOUT
2050
2051 =back
2052
2053 =item Other I/O Issues
2054
2055 =over 4
2056
2057 =item Opening Non-File Files
2058
2059 =item Opening Named Pipes
2060
2061 =item Opening Sockets
2062
2063 =item Binary Files
2064
2065 =item File Locking
2066
2067 =item IO Layers
2068
2069 =back
2070
2071 =item SEE ALSO 
2072
2073 =item AUTHOR and COPYRIGHT
2074
2075 =item HISTORY
2076
2077 =back
2078
2079 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
2080
2081 =over 4
2082
2083 =item DESCRIPTION
2084
2085 =item The Basic Principle
2086
2087 =item Packing Text
2088
2089 =item Packing Numbers
2090
2091 =over 4
2092
2093 =item Integers
2094
2095 =item Unpacking a Stack Frame
2096
2097 =item How to Eat an Egg on a Net
2098
2099 =item Byte-order modifiers
2100
2101 =item Floating point Numbers
2102
2103 =back
2104
2105 =item Exotic Templates
2106
2107 =over 4
2108
2109 =item Bit Strings
2110
2111 =item Uuencoding
2112
2113 =item Doing Sums
2114
2115 =item  Unicode
2116
2117 =item Another Portable Binary Encoding
2118
2119 =back
2120
2121 =item Template Grouping
2122
2123 =item Lengths and Widths
2124
2125 =over 4
2126
2127 =item String Lengths
2128
2129 =item Dynamic Templates
2130
2131 =item Counting Repetitions
2132
2133 =back
2134
2135 =item Packing and Unpacking C Structures
2136
2137 =over 4
2138
2139 =item The Alignment Pit
2140
2141 =item Dealing with Endian-ness
2142
2143 =item Alignment, Take 2
2144
2145 =item Alignment, Take 3
2146
2147 =item Pointers for How to Use Them
2148
2149 =back
2150
2151 =item Pack Recipes
2152
2153 =item Funnies Section
2154
2155 =item Authors
2156
2157 =back
2158
2159 =head2 perlpod - the Plain Old Documentation format
2160
2161 =over 4
2162
2163 =item DESCRIPTION
2164
2165 =over 4
2166
2167 =item Ordinary Paragraph
2168
2169 =item Verbatim Paragraph
2170
2171 =item Command Paragraph
2172
2173 C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
2174 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item
2175 I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end
2176 I<formatname>>, C<=for I<formatname> I<text...>>, C<=encoding
2177 I<encodingname>>
2178
2179 =item Formatting Codes
2180
2181 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2182 C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink,
2183 C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used
2184 for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces,
2185 C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null
2186 (zero-effect) formatting code
2187
2188 =item The Intent
2189
2190 =item Embedding Pods in Perl Modules
2191
2192 =item Hints for Writing Pod
2193
2194 =back
2195
2196 =item SEE ALSO
2197
2198 =item AUTHOR
2199
2200 =back
2201
2202 =head2 perlpodspec - Plain Old Documentation: format specification and
2203 notes
2204
2205 =over 4
2206
2207 =item DESCRIPTION
2208
2209 =item Pod Definitions
2210
2211 =item Pod Commands
2212
2213 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
2214 "=back", "=begin formatname", "=end formatname", "=for formatname text...",
2215 "=encoding encodingname"
2216
2217 =item Pod Formatting Codes
2218
2219 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2220 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
2221 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
2222 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
2223 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
2224 contains non-breaking spaces
2225
2226 =item Notes on Implementing Pod Processors
2227
2228 =item About LE<lt>...E<gt> Codes
2229
2230 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
2231
2232 =item About =over...=back Regions
2233
2234 =item About Data Paragraphs and "=begin/=end" Regions
2235
2236 =item SEE ALSO
2237
2238 =item AUTHOR
2239
2240 =back
2241
2242 =head2 perlrun - how to execute the Perl interpreter
2243
2244 =over 4
2245
2246 =item SYNOPSIS
2247
2248 =item DESCRIPTION
2249
2250 =over 4
2251
2252 =item #! and quoting on non-Unix systems
2253
2254 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
2255
2256 =item Location of Perl
2257
2258 =item Command Switches
2259
2260 B<-0>[I<octal/hexadecimal>], B<-A [I<assertions>]>, B<-a>, B<-C
2261 [I<number/list>]>, B<-c>, B<-d>, B<-dt>, B<-d:>I<foo[=bar,baz]>,
2262 B<-dt:>I<foo[=bar,baz]>, B<-D>I<letters>, B<-D>I<number>, B<-e>
2263 I<commandline>, B<-F>I<pattern>, B<-h>, B<-i>[I<extension>],
2264 B<-I>I<directory>, B<-l>[I<octnum>], B<-m>[B<->]I<module>,
2265 B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
2266 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
2267 B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<configvar>, B<-w>, B<-W>,
2268 B<-X>, B<-x>, B<-x> I<directory>
2269
2270 =back
2271
2272 =item ENVIRONMENT
2273
2274 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
2275 :perlio, :pop, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
2276 PERL5DB, PERL5DB_THREADED, PERL5SHELL (specific to the Win32 port),
2277 PERL_ALLOW_NON_IFS_LSP (specific to the Win32 port), PERL_DEBUG_MSTATS,
2278 PERL_DESTRUCT_LEVEL, PERL_DL_NONLAZY, PERL_ENCODING, PERL_HASH_SEED,
2279 PERL_HASH_SEED_DEBUG, PERL_ROOT (specific to the VMS port), PERL_SIGNALS,
2280 PERL_UNICODE, SYS$LOGIN (specific to the VMS port)
2281
2282 =back
2283
2284 =head2 perldiag - various Perl diagnostics
2285
2286 =over 4
2287
2288 =item DESCRIPTION
2289
2290 =back
2291
2292 =head2 perllexwarn - Perl Lexical Warnings
2293
2294 =over 4
2295
2296 =item DESCRIPTION
2297
2298 =over 4
2299
2300 =item Default Warnings and Optional Warnings
2301
2302 =item What's wrong with B<-w> and C<$^W>
2303
2304 =item Controlling Warnings from the Command Line
2305
2306 B<-w>, B<-W>, B<-X>
2307
2308 =item Backward Compatibility
2309
2310 =item Category Hierarchy
2311
2312 =item Fatal Warnings
2313
2314 =item Reporting Warnings from a Module
2315
2316 =back
2317
2318 =item TODO
2319
2320 =item SEE ALSO
2321
2322 =item AUTHOR
2323
2324 =back
2325
2326 =head2 perldebug - Perl debugging
2327
2328 =over 4
2329
2330 =item DESCRIPTION
2331
2332 =item The Perl Debugger
2333
2334 =over 4
2335
2336 =item Debugger Commands
2337
2338 h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y
2339 [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l
2340 min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/,
2341 ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b
2342 subname [condition], b postpone subname [condition], b load filename, b
2343 compile subname, B line, B *, a [line] command, A line, A *, w expr, W
2344 expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [
2345 command ], < *, << command, > ?, > command, > *, >> command, { ?, { [
2346 command ], { *, {{ command, ! number, ! -number, ! pattern, !! cmd, source
2347 file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man
2348 [manpage]
2349
2350 =item Configurable Options
2351
2352 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
2353 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
2354 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
2355 C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
2356 C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
2357 C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
2358 C<NonStop>
2359
2360 =item Debugger input/output
2361
2362 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
2363 listing
2364
2365 =item Debugging compile-time statements
2366
2367 =item Debugger Customization
2368
2369 =item Readline Support
2370
2371 =item Editor Support for Debugging
2372
2373 =item The Perl Profiler
2374
2375 =back
2376
2377 =item Debugging regular expressions
2378
2379 =item Debugging memory usage
2380
2381 =item SEE ALSO
2382
2383 =item BUGS
2384
2385 =back
2386
2387 =head2 perlvar - Perl predefined variables
2388
2389 =over 4
2390
2391 =item DESCRIPTION
2392
2393 =over 4
2394
2395 =item Predefined Names
2396
2397 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
2398 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+,
2399 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
2400 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
2401 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
2402 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
2403 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
2404 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $#,
2405 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
2406 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
2407 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
2408 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
2409 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
2410 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
2411 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
2412 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
2413 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
2414 IO::Handle->format_line_break_characters EXPR,
2415 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
2416 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
2417 $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
2418 $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
2419 $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
2420 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
2421 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
2422 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
2423 0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R,
2424 $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, ${^UNICODE},
2425 $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, $EXECUTABLE_NAME, $^X,
2426 ARGV, $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG,
2427 $SIG{expr}
2428
2429 =item Error Indicators
2430
2431 =item Technical Note on the Syntax of Variable Names
2432
2433 =back
2434
2435 =item BUGS
2436
2437 =back
2438
2439 =head2 perlre - Perl regular expressions
2440
2441 =over 4
2442
2443 =item DESCRIPTION
2444
2445 i, m, s, x
2446
2447 =over 4
2448
2449 =item Regular Expressions
2450
2451 [1], [2], [3], cntrl, graph, print, punct, xdigit
2452
2453 =item Extended Patterns
2454
2455 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
2456 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
2457 code })>, C<(??{ code })>, C<< (?>pattern) >>,
2458 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
2459
2460 =item Backtracking
2461
2462 =item Version 8 Regular Expressions
2463
2464 =item Warning on \1 vs $1
2465
2466 =item Repeated patterns matching zero-length substring
2467
2468 =item Combining pieces together
2469
2470 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
2471 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
2472 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
2473 C<(?(condition)yes-pattern|no-pattern)>
2474
2475 =item Creating custom RE engines
2476
2477 =back
2478
2479 =item BUGS
2480
2481 =item SEE ALSO
2482
2483 =back
2484
2485 =head2 perlreref - Perl Regular Expressions Reference
2486
2487 =over 4
2488
2489 =item DESCRIPTION
2490
2491 =over 4
2492
2493 =item OPERATORS
2494
2495 =item SYNTAX
2496
2497 =item ESCAPE SEQUENCES
2498
2499 =item CHARACTER CLASSES
2500
2501 =item ANCHORS
2502
2503 =item QUANTIFIERS
2504
2505 =item EXTENDED CONSTRUCTS
2506
2507 =item VARIABLES
2508
2509 =item FUNCTIONS
2510
2511 =item TERMINOLOGY
2512
2513 =back
2514
2515 =item AUTHOR
2516
2517 =item SEE ALSO
2518
2519 =item THANKS
2520
2521 =back
2522
2523 =head2 perlref - Perl references and nested data structures
2524
2525 =over 4
2526
2527 =item NOTE
2528
2529 =item DESCRIPTION
2530
2531 =over 4
2532
2533 =item Making References
2534
2535 =item Using References
2536
2537 =item Symbolic references
2538
2539 =item Not-so-symbolic references
2540
2541 =item Pseudo-hashes: Using an array as a hash
2542
2543 =item Function Templates
2544
2545 =back
2546
2547 =item WARNING
2548
2549 =item SEE ALSO
2550
2551 =back
2552
2553 =head2 perlform - Perl formats
2554
2555 =over 4
2556
2557 =item DESCRIPTION
2558
2559 =over 4
2560
2561 =item Text Fields
2562
2563 =item Numeric Fields
2564
2565 =item The Field @* for Variable Width Multi-Line Text
2566
2567 =item The Field ^* for Variable Width One-line-at-a-time Text
2568
2569 =item Specifying Values
2570
2571 =item Using Fill Mode
2572
2573 =item Suppressing Lines Where All Fields Are Void
2574
2575 =item Repeating Format Lines
2576
2577 =item Top of Form Processing
2578
2579 =item Format Variables
2580
2581 =back
2582
2583 =item NOTES
2584
2585 =over 4
2586
2587 =item Footers
2588
2589 =item Accessing Formatting Internals
2590
2591 =back
2592
2593 =item WARNINGS
2594
2595 =back
2596
2597 =head2 perlobj - Perl objects
2598
2599 =over 4
2600
2601 =item DESCRIPTION
2602
2603 =over 4
2604
2605 =item An Object is Simply a Reference
2606
2607 =item A Class is Simply a Package
2608
2609 =item A Method is Simply a Subroutine
2610
2611 =item Method Invocation
2612
2613 =item Indirect Object Syntax
2614
2615 =item Default UNIVERSAL methods
2616
2617 isa(CLASS), can(METHOD), VERSION( [NEED] )
2618
2619 =item Destructors
2620
2621 =item Summary
2622
2623 =item Two-Phased Garbage Collection
2624
2625 =back
2626
2627 =item SEE ALSO
2628
2629 =back
2630
2631 =head2 perltie - how to hide an object class in a simple variable
2632
2633 =over 4
2634
2635 =item SYNOPSIS
2636
2637 =item DESCRIPTION
2638
2639 =over 4
2640
2641 =item Tying Scalars
2642
2643 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
2644 DESTROY this
2645
2646 =item Tying Arrays
2647
2648 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
2649 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
2650 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
2651 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
2652 this
2653
2654 =item Tying Hashes
2655
2656 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
2657 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
2658 this, NEXTKEY this, lastkey, SCALAR this, UNTIE this, DESTROY this
2659
2660 =item Tying FileHandles
2661
2662 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
2663 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
2664 DESTROY this
2665
2666 =item UNTIE this
2667
2668 =item The C<untie> Gotcha
2669
2670 =back
2671
2672 =item SEE ALSO
2673
2674 =item BUGS
2675
2676 =item AUTHOR
2677
2678 =back
2679
2680 =head2 perldbmfilter - Perl DBM Filters
2681
2682 =over 4
2683
2684 =item SYNOPSIS
2685
2686 =item DESCRIPTION
2687
2688 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
2689 B<filter_fetch_value>
2690
2691 =over 4
2692
2693 =item The Filter
2694
2695 =item An Example -- the NULL termination problem.
2696
2697 =item Another Example -- Key is a C int.
2698
2699 =back
2700
2701 =item SEE ALSO
2702
2703 =item AUTHOR
2704
2705 =back
2706
2707 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
2708 safe subprocesses, sockets, and semaphores)
2709
2710 =over 4
2711
2712 =item DESCRIPTION
2713
2714 =item Signals
2715
2716 =over 4
2717
2718 =item Handling the SIGHUP Signal in Daemons
2719
2720 =back
2721
2722 =item Named Pipes
2723
2724 =over 4
2725
2726 =item Deferred Signals (Safe Signals)
2727
2728 Long running opcodes, Interrupting IO, Restartable system calls, Signals as
2729 "faults", Signals triggered by operating system state
2730
2731 =back
2732
2733 =item Using open() for IPC
2734
2735 =over 4
2736
2737 =item Filehandles
2738
2739 =item Background Processes
2740
2741 =item Complete Dissociation of Child from Parent
2742
2743 =item Safe Pipe Opens
2744
2745 =item Bidirectional Communication with Another Process
2746
2747 =item Bidirectional Communication with Yourself
2748
2749 =back
2750
2751 =item Sockets: Client/Server Communication
2752
2753 =over 4
2754
2755 =item Internet Line Terminators
2756
2757 =item Internet TCP Clients and Servers
2758
2759 =item Unix-Domain TCP Clients and Servers
2760
2761 =back
2762
2763 =item TCP Clients with IO::Socket
2764
2765 =over 4
2766
2767 =item A Simple Client
2768
2769 C<Proto>, C<PeerAddr>, C<PeerPort>
2770
2771 =item A Webget Client
2772
2773 =item Interactive Client with IO::Socket
2774
2775 =back
2776
2777 =item TCP Servers with IO::Socket
2778
2779 Proto, LocalPort, Listen, Reuse
2780
2781 =item UDP: Message Passing
2782
2783 =item SysV IPC
2784
2785 =item NOTES
2786
2787 =item BUGS
2788
2789 =item AUTHOR
2790
2791 =item SEE ALSO
2792
2793 =back
2794
2795 =head2 perlfork - Perl's fork() emulation
2796
2797 =over 4
2798
2799 =item SYNOPSIS
2800
2801 =item DESCRIPTION
2802
2803 =over 4
2804
2805 =item Behavior of other Perl features in forked pseudo-processes
2806
2807 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
2808 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
2809 files, directories and network sockets
2810
2811 =item Resource limits
2812
2813 =item Killing the parent process
2814
2815 =item Lifetime of the parent process and pseudo-processes
2816
2817 =item CAVEATS AND LIMITATIONS
2818
2819 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
2820 Global state maintained by XSUBs, Interpreter embedded in larger
2821 application, Thread-safety of extensions
2822
2823 =back
2824
2825 =item BUGS
2826
2827 =item AUTHOR
2828
2829 =item SEE ALSO
2830
2831 =back
2832
2833 =head2 perlnumber - semantics of numbers and numeric operations in Perl
2834
2835 =over 4
2836
2837 =item SYNOPSIS
2838
2839 =item DESCRIPTION
2840
2841 =item Storing numbers
2842
2843 =item Numeric operators and numeric conversions
2844
2845 =item Flavors of Perl numeric operations
2846
2847 Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other
2848 mathematical operators, Bitwise operators, Bitwise operators during C<use
2849 integer>, Operators which expect an integer, Operators which expect a
2850 string
2851
2852 =item AUTHOR
2853
2854 =item SEE ALSO
2855
2856 =back
2857
2858 =head2 perlthrtut - tutorial on threads in Perl
2859
2860 =over 4
2861
2862 =item DESCRIPTION
2863
2864 =item Status
2865
2866 =item What Is A Thread Anyway?
2867
2868 =item Threaded Program Models
2869
2870 =over 4
2871
2872 =item Boss/Worker
2873
2874 =item Work Crew
2875
2876 =item Pipeline
2877
2878 =back
2879
2880 =item What kind of threads are Perl threads?
2881
2882 =item Thread-Safe Modules
2883
2884 =item Thread Basics
2885
2886 =over 4
2887
2888 =item Basic Thread Support
2889
2890 =item A Note about the Examples
2891
2892 =item Creating Threads
2893
2894 =item Waiting For A Thread To Exit
2895
2896 =item Ignoring A Thread
2897
2898 =back
2899
2900 =item Threads And Data
2901
2902 =over 4
2903
2904 =item Shared And Unshared Data
2905
2906 =item Thread Pitfalls: Races
2907
2908 =back
2909
2910 =item Synchronization and control
2911
2912 =over 4
2913
2914 =item Controlling access: lock()
2915
2916 =item A Thread Pitfall: Deadlocks
2917
2918 =item Queues: Passing Data Around
2919
2920 =item Semaphores: Synchronizing Data Access
2921
2922 =item Basic semaphores
2923
2924 =item Advanced Semaphores
2925
2926 =item cond_wait() and cond_signal()
2927
2928 =item Giving up control
2929
2930 =back
2931
2932 =item General Thread Utility Routines
2933
2934 =over 4
2935
2936 =item What Thread Am I In?
2937
2938 =item Thread IDs
2939
2940 =item Are These Threads The Same?
2941
2942 =item What Threads Are Running?
2943
2944 =back
2945
2946 =item A Complete Example
2947
2948 =item Different implementations of threads
2949
2950 =item Performance considerations
2951
2952 =item Process-scope Changes
2953
2954 =item Thread-Safety of System Libraries
2955
2956 =item Conclusion
2957
2958 =item Bibliography
2959
2960 =over 4
2961
2962 =item Introductory Texts
2963
2964 =item OS-Related References
2965
2966 =item Other References
2967
2968 =back
2969
2970 =item Acknowledgements
2971
2972 =item AUTHOR
2973
2974 =item Copyrights
2975
2976 =back
2977
2978 =head2 perlothrtut - old tutorial on threads in Perl
2979
2980 =over 4
2981
2982 =item DESCRIPTION
2983
2984 =item What Is A Thread Anyway?
2985
2986 =item Threaded Program Models
2987
2988 =over 4
2989
2990 =item Boss/Worker
2991
2992 =item Work Crew
2993
2994 =item Pipeline
2995
2996 =back
2997
2998 =item Native threads
2999
3000 =item What kind of threads are perl threads?
3001
3002 =item Threadsafe Modules
3003
3004 =item Thread Basics
3005
3006 =over 4
3007
3008 =item Basic Thread Support
3009
3010 =item Creating Threads
3011
3012 =item Giving up control
3013
3014 =item Waiting For A Thread To Exit
3015
3016 =item Errors In Threads
3017
3018 =item Ignoring A Thread
3019
3020 =back
3021
3022 =item Threads And Data
3023
3024 =over 4
3025
3026 =item Shared And Unshared Data
3027
3028 =item Thread Pitfall: Races
3029
3030 =item Controlling access: lock()
3031
3032 =item Thread Pitfall: Deadlocks
3033
3034 =item Queues: Passing Data Around
3035
3036 =back
3037
3038 =item Threads And Code
3039
3040 =over 4
3041
3042 =item Semaphores: Synchronizing Data Access
3043
3044 Basic semaphores, Advanced Semaphores
3045
3046 =item Attributes: Restricting Access To Subroutines
3047
3048 =item Subroutine Locks
3049
3050 =item Methods
3051
3052 =item Locking A Subroutine
3053
3054 =back
3055
3056 =item General Thread Utility Routines
3057
3058 =over 4
3059
3060 =item What Thread Am I In?
3061
3062 =item Thread IDs
3063
3064 =item Are These Threads The Same?
3065
3066 =item What Threads Are Running?
3067
3068 =back
3069
3070 =item A Complete Example
3071
3072 =item Conclusion
3073
3074 =item Bibliography
3075
3076 =over 4
3077
3078 =item Introductory Texts
3079
3080 =item OS-Related References
3081
3082 =item Other References
3083
3084 =back
3085
3086 =item Acknowledgements
3087
3088 =item AUTHOR
3089
3090 =item Copyrights
3091
3092 =back
3093
3094 =head2 perlport - Writing portable Perl
3095
3096 =over 4
3097
3098 =item DESCRIPTION
3099
3100 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
3101 portable
3102
3103 =item ISSUES
3104
3105 =over 4
3106
3107 =item Newlines
3108
3109 =item Numbers endianness and Width
3110
3111 =item Files and Filesystems
3112
3113 =item System Interaction
3114
3115 =item Command names versus file pathnames
3116
3117 =item Networking
3118
3119 =item Interprocess Communication (IPC)
3120
3121 =item External Subroutines (XS)
3122
3123 =item Standard Modules
3124
3125 =item Time and Date
3126
3127 =item Character sets and character encoding
3128
3129 =item Internationalisation
3130
3131 =item System Resources
3132
3133 =item Security
3134
3135 =item Style
3136
3137 =back
3138
3139 =item CPAN Testers
3140
3141 Mailing list: cpan-testers@perl.org, Testing results:
3142 http://testers.cpan.org/
3143
3144 =item PLATFORMS
3145
3146 =over 4
3147
3148 =item Unix
3149
3150 =item DOS and Derivatives
3151
3152 =item S<Mac OS>
3153
3154 =item VMS
3155
3156 =item VOS
3157
3158 =item EBCDIC Platforms
3159
3160 =item Acorn RISC OS
3161
3162 =item Other perls
3163
3164 =back
3165
3166 =item FUNCTION IMPLEMENTATIONS
3167
3168 =over 4
3169
3170 =item Alphabetical Listing of Perl Functions
3171
3172 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, binmode FILEHANDLE, chmod LIST, chown
3173 LIST, chroot FILENAME, chroot, crypt PLAINTEXT,SALT, dbmclose HASH, dbmopen
3174 HASH,DBNAME,MODE, dump LABEL, exec LIST, exit EXPR, exit, fcntl
3175 FILEHANDLE,FUNCTION,SCALAR, flock FILEHANDLE,OPERATION, fork, getlogin,
3176 getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam NAME, getgrnam NAME,
3177 getnetbyname NAME, getpwuid UID, getgrgid GID, getnetbyaddr ADDR,ADDRTYPE,
3178 getprotobynumber NUMBER, getservbyport PORT,PROTO, getpwent, getgrent,
3179 gethostbyname, gethostent, getnetent, getprotoent, getservent, sethostent
3180 STAYOPEN, setnetent STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN,
3181 endpwent, endgrent, endhostent, endnetent, endprotoent, endservent,
3182 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl
3183 FILEHANDLE,FUNCTION,SCALAR, kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat
3184 FILEHANDLE, lstat EXPR, lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd
3185 ID,MSG,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open
3186 FILEHANDLE, pipe READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select
3187 RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
3188 KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
3189 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
3190 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
3191 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
3192 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
3193 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
3194 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
3195 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
3196 wait, waitpid PID,FLAGS
3197
3198 =back
3199
3200 =item CHANGES
3201
3202 v1.49, 12 August 2002, v1.48, 02 February 2001, v1.47, 22 March 2000,
3203 v1.46, 12 February 2000, v1.45, 20 December 1999, v1.44, 19 July 1999,
3204 v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May 1999, v1.40, 11 April
3205 1999, v1.39, 11 February 1999, v1.38, 31 December 1998, v1.37, 19 December
3206 1998, v1.36, 9 September 1998, v1.35, 13 August 1998, v1.33, 06 August
3207 1998, v1.32, 05 August 1998, v1.30, 03 August 1998, v1.23, 10 July 1998
3208
3209 =item Supported Platforms
3210
3211 =item SEE ALSO
3212
3213 =item AUTHORS / CONTRIBUTORS
3214
3215 =back
3216
3217 =head2 perllocale - Perl locale handling (internationalization and
3218 localization)
3219
3220 =over 4
3221
3222 =item DESCRIPTION
3223
3224 =item PREPARING TO USE LOCALES
3225
3226 =item USING LOCALES
3227
3228 =over 4
3229
3230 =item The use locale pragma
3231
3232 =item The setlocale function
3233
3234 =item Finding locales
3235
3236 =item LOCALE PROBLEMS
3237
3238 =item Temporarily fixing locale problems
3239
3240 =item Permanently fixing locale problems
3241
3242 =item Permanently fixing your system's locale configuration
3243
3244 =item Fixing system locale configuration
3245
3246 =item The localeconv function
3247
3248 =item I18N::Langinfo
3249
3250 =back
3251
3252 =item LOCALE CATEGORIES
3253
3254 =over 4
3255
3256 =item Category LC_COLLATE: Collation
3257
3258 =item Category LC_CTYPE: Character Types
3259
3260 =item Category LC_NUMERIC: Numeric Formatting
3261
3262 =item Category LC_MONETARY: Formatting of monetary amounts
3263
3264 =item LC_TIME
3265
3266 =item Other categories
3267
3268 =back
3269
3270 =item SECURITY
3271
3272 =item ENVIRONMENT
3273
3274 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
3275 LC_NUMERIC, LC_TIME, LANG
3276
3277 =item NOTES
3278
3279 =over 4
3280
3281 =item Backward compatibility
3282
3283 =item I18N:Collate obsolete
3284
3285 =item Sort speed and memory use impacts
3286
3287 =item write() and LC_NUMERIC
3288
3289 =item Freely available locale definitions
3290
3291 =item I18n and l10n
3292
3293 =item An imperfect standard
3294
3295 =back
3296
3297 =item Unicode and UTF-8
3298
3299 =item BUGS
3300
3301 =over 4
3302
3303 =item Broken systems
3304
3305 =back
3306
3307 =item SEE ALSO
3308
3309 =item HISTORY
3310
3311 =back
3312
3313 =head2 perluniintro - Perl Unicode introduction
3314
3315 =over 4
3316
3317 =item DESCRIPTION
3318
3319 =over 4
3320
3321 =item Unicode
3322
3323 =item Perl's Unicode Support
3324
3325 =item Perl's Unicode Model
3326
3327 =item Unicode and EBCDIC
3328
3329 =item Creating Unicode
3330
3331 =item Handling Unicode
3332
3333 =item Legacy Encodings
3334
3335 =item Unicode I/O
3336
3337 =item Displaying Unicode As Text
3338
3339 =item Special Cases
3340
3341 =item Advanced Topics
3342
3343 =item Miscellaneous
3344
3345 =item Questions With Answers
3346
3347 =item Hexadecimal Notation
3348
3349 =item Further Resources
3350
3351 =back
3352
3353 =item UNICODE IN OLDER PERLS
3354
3355 =item SEE ALSO
3356
3357 =item ACKNOWLEDGMENTS
3358
3359 =item AUTHOR, COPYRIGHT, AND LICENSE
3360
3361 =back
3362
3363 =head2 perlunicode - Unicode support in Perl
3364
3365 =over 4
3366
3367 =item DESCRIPTION
3368
3369 =over 4
3370
3371 =item Important Caveats
3372
3373 Input and Output Layers, Regular Expressions, C<use utf8> still needed to
3374 enable UTF-8/UTF-EBCDIC in scripts, BOM-marked scripts and UTF-16 scripts
3375 autodetected, C<use encoding> needed to upgrade non-Latin-1 byte strings
3376
3377 =item Byte and Character Semantics
3378
3379 =item Effects of Character Semantics
3380
3381 =item Scripts
3382
3383 =item Blocks
3384
3385 =item User-Defined Character Properties
3386
3387 =item Character Encodings for Input and Output
3388
3389 =item Unicode Regular Expression Support Level
3390
3391 =item Unicode Encodings
3392
3393 =item Security Implications of Unicode
3394
3395 =item Unicode in Perl on EBCDIC
3396
3397 =item Locales
3398
3399 =item When Unicode Does Not Happen
3400
3401 =item Forcing Unicode in Perl (Or Unforcing Unicode in Perl)
3402
3403 =item Using Unicode in XS
3404
3405 =back
3406
3407 =item BUGS
3408
3409 =over 4
3410
3411 =item Interaction with Locales
3412
3413 =item Interaction with Extensions
3414
3415 =item Speed
3416
3417 =item Porting code from perl-5.6.X
3418
3419 =back
3420
3421 =item SEE ALSO
3422
3423 =back
3424
3425 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
3426
3427 =over 4
3428
3429 =item DESCRIPTION
3430
3431 =item COMMON CHARACTER CODE SETS
3432
3433 =over 4
3434
3435 =item ASCII
3436
3437 =item ISO 8859
3438
3439 =item Latin 1 (ISO 8859-1)
3440
3441 =item EBCDIC
3442
3443 =item 13 variant characters
3444
3445 =item 0037
3446
3447 =item 1047
3448
3449 =item POSIX-BC
3450
3451 =item Unicode code points versus EBCDIC code points
3452
3453 =item Remaining Perl Unicode problems in EBCDIC
3454
3455 =item Unicode and UTF
3456
3457 =item Using Encode
3458
3459 =back
3460
3461 =item SINGLE OCTET TABLES
3462
3463 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
3464
3465 =item IDENTIFYING CHARACTER CODE SETS
3466
3467 =item CONVERSIONS
3468
3469 =over 4
3470
3471 =item tr///
3472
3473 =item iconv
3474
3475 =item C RTL
3476
3477 =back
3478
3479 =item OPERATOR DIFFERENCES
3480
3481 =item FUNCTION DIFFERENCES
3482
3483 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
3484
3485 =item REGULAR EXPRESSION DIFFERENCES
3486
3487 =item SOCKETS
3488
3489 =item SORTING
3490
3491 =over 4
3492
3493 =item Ignore ASCII vs. EBCDIC sort differences.
3494
3495 =item MONO CASE then sort data.
3496
3497 =item Convert, sort data, then re convert.
3498
3499 =item Perform sorting on one type of machine only.
3500
3501 =back
3502
3503 =item TRANSFORMATION FORMATS
3504
3505 =over 4
3506
3507 =item URL decoding and encoding
3508
3509 =item uu encoding and decoding
3510
3511 =item Quoted-Printable encoding and decoding
3512
3513 =item Caesarian ciphers
3514
3515 =back
3516
3517 =item Hashing order and checksums
3518
3519 =item I18N AND L10N
3520
3521 =item MULTI OCTET CHARACTER SETS
3522
3523 =item OS ISSUES
3524
3525 =over 4
3526
3527 =item OS/400
3528
3529 PASE, IFS access
3530
3531 =item OS/390, z/OS
3532
3533 chcp, dataset access, OS/390, z/OS iconv, locales
3534
3535 =item VM/ESA?
3536
3537 =item POSIX-BC?
3538
3539 =back
3540
3541 =item BUGS
3542
3543 =item SEE ALSO
3544
3545 =item REFERENCES
3546
3547 =item HISTORY
3548
3549 =item AUTHOR
3550
3551 =back
3552
3553 =head2 perlsec - Perl security
3554
3555 =over 4
3556
3557 =item DESCRIPTION
3558
3559 =over 4
3560
3561 =item Laundering and Detecting Tainted Data
3562
3563 =item Switches On the "#!" Line
3564
3565 =item Taint mode and @INC
3566
3567 =item Cleaning Up Your Path
3568
3569 =item Security Bugs
3570
3571 =item Protecting Your Programs
3572
3573 =item Unicode
3574
3575 =item Algorithmic Complexity Attacks
3576
3577 =back
3578
3579 =item SEE ALSO
3580
3581 =back
3582
3583 =head2 perlmod - Perl modules (packages and symbol tables)
3584
3585 =over 4
3586
3587 =item DESCRIPTION
3588
3589 =over 4
3590
3591 =item Packages
3592
3593 =item Symbol Tables
3594
3595 =item BEGIN, CHECK, INIT and END
3596
3597 =item Perl Classes
3598
3599 =item Perl Modules
3600
3601 =item Making your module threadsafe
3602
3603 =back
3604
3605 =item SEE ALSO
3606
3607 =back
3608
3609 =head2 perlmodlib - constructing new Perl modules and finding existing ones
3610
3611 =over 4
3612
3613 =item THE PERL MODULE LIBRARY
3614
3615 =over 4
3616
3617 =item Pragmatic Modules
3618
3619 assertions, assertions::activate, attributes, attrs, autouse, base, bigint,
3620 bignum, bigrat, blib, bytes, charnames, constant, diagnostics, encoding,
3621 fields, filetest, if, integer, less, lib, locale, open, ops, overload, re,
3622 sigtrap, sort, strict, subs, threads, threads::shared, utf8, vars, version,
3623 vmsish, warnings, warnings::register
3624
3625 =item Standard Modules
3626
3627 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
3628 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
3629 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
3630 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
3631 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
3632 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
3633 Class::Struct, Config, Cwd, DB, DBM_Filter, DB_File, Data::Dumper,
3634 Devel::DProf, Devel::PPPort, Devel::Peek, Devel::SelfStubber, Digest,
3635 Digest::MD5, Digest::base, DirHandle, Dumpvalue, DynaLoader, Encode,
3636 Encode::Alias, Encode::Byte, Encode::CJKConstants, Encode::CN,
3637 Encode::CN::HZ, Encode::Config, Encode::EBCDIC, Encode::Encoder,
3638 Encode::Encoding, Encode::Guess, Encode::JP, Encode::JP::H2Z,
3639 Encode::JP::JIS7, Encode::KR, Encode::KR::2022_KR, Encode::MIME::Header,
3640 Encode::PerlIO, Encode::Supported, Encode::Symbol, Encode::TW,
3641 Encode::Unicode, Encode::Unicode::UTF7, English, Env, Errno, Exporter,
3642 Exporter::Heavy, ExtUtils::Command, ExtUtils::Command::MM,
3643 ExtUtils::Constant, ExtUtils::Embed, ExtUtils::Install,
3644 ExtUtils::Installed, ExtUtils::Liblist, ExtUtils::MM, ExtUtils::MM_Any,
3645 ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin, ExtUtils::MM_DOS,
3646 ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2, ExtUtils::MM_UWIN,
3647 ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
3648 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker,
3649 ExtUtils::MakeMaker::FAQ, ExtUtils::MakeMaker::Tutorial,
3650 ExtUtils::MakeMaker::bytes, ExtUtils::MakeMaker::vmsish,
3651 ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists,
3652 ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename,
3653 File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find,
3654 File::Glob, File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc,
3655 File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix,
3656 File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache,
3657 FileHandle, Filter::Simple, Filter::Util::Call, FindBin, GDBM_File,
3658 Getopt::Long, Getopt::Std, Hash::Util, I18N::Collate, I18N::LangTags,
3659 I18N::LangTags::List, I18N::Langinfo, IO, IO::Dir, IO::File, IO::Handle,
3660 IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET,
3661 IO::Socket::UNIX, IPC::Open2, IPC::Open3, IPC::SysV, IPC::SysV::Msg,
3662 IPC::SysV::Semaphore, List::Util, Locale::Constants, Locale::Country,
3663 Locale::Currency, Locale::Language, Locale::Maketext,
3664 Locale::Maketext::TPJ13, Locale::Script, MIME::Base64,
3665 MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt,
3666 Math::BigInt::Calc, Math::BigInt::CalcEmu, Math::BigRat, Math::Complex,
3667 Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire,
3668 Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File,
3669 Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT, Net::Cmd,
3670 Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3,
3671 Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent,
3672 Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO,
3673 PerlIO::encoding, PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint,
3674 Pod::Checker, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects,
3675 Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser,
3676 Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff,
3677 Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText,
3678 Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer,
3679 Pod::Select, Pod::Text, Pod::Text::Color, Pod::Text::Overstrike,
3680 Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Scalar::Util,
3681 Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch,
3682 Symbol, Sys::Hostname, Sys::Syslog, Term::ANSIColor, Term::Cap,
3683 Term::Complete, Term::ReadLine, Test, Test::Builder, Test::Harness,
3684 Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Straps,
3685 Test::More, Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced,
3686 Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Thread,
3687 Thread::Queue, Thread::Semaphore, Thread::Signal, Thread::Specific,
3688 Tie::Array, Tie::File, Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash,
3689 Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::gmtime,
3690 Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate, Unicode::Normalize,
3691 Unicode::UCD, User::grent, User::pwent, Win32, XS::APItest, XS::Typemap,
3692 XSLoader
3693
3694 =item Extension Modules
3695
3696 =back
3697
3698 =item CPAN
3699
3700 =over 4
3701
3702 =item Africa
3703
3704 South Africa
3705
3706 =item Asia
3707
3708 China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi
3709 Arabia, Singapore, South Korea, Taiwan, Thailand
3710
3711 =item Central America
3712
3713 Costa Rica
3714
3715 =item Europe
3716
3717 Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Czech
3718 Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary,
3719 Iceland, Ireland, Italy, Latvia, Lithuania, Netherlands, Norway, Poland,
3720 Portugal, Romania, Russia, Slovakia, Slovenia, Spain, Sweden, Switzerland,
3721 Turkey, Ukraine, United Kingdom
3722
3723 =item North America
3724
3725 Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States,
3726 Alabama, California, Colorado, Delaware, District of Columbia, Florida,
3727 Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey, New York,
3728 North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, Utah,
3729 Virginia, Washington, Wisconsin
3730
3731 =item Oceania
3732
3733 Australia, New Zealand, United States
3734
3735 =item South America
3736
3737 Argentina, Brazil, Chile
3738
3739 =item RSYNC Mirrors
3740
3741 =back
3742
3743 =item Modules: Creation, Use, and Abuse
3744
3745 =over 4
3746
3747 =item Guidelines for Module Creation
3748
3749 =item Guidelines for Converting Perl 4 Library Scripts into Modules
3750
3751 =item Guidelines for Reusing Application Code
3752
3753 =back
3754
3755 =item NOTE
3756
3757 =back
3758
3759 =head2 perlmodstyle - Perl module style guide
3760
3761 =over 4
3762
3763 =item INTRODUCTION
3764
3765 =item QUICK CHECKLIST
3766
3767 =over 4
3768
3769 =item Before you start
3770
3771 =item The API
3772
3773 =item Stability
3774
3775 =item Documentation
3776
3777 =item Release considerations
3778
3779 =back
3780
3781 =item BEFORE YOU START WRITING A MODULE
3782
3783 =over 4
3784
3785 =item Has it been done before?
3786
3787 =item Do one thing and do it well
3788
3789 =item What's in a name?
3790
3791 =back
3792
3793 =item DESIGNING AND WRITING YOUR MODULE
3794
3795 =over 4
3796
3797 =item To OO or not to OO?
3798
3799 =item Designing your API
3800
3801 Write simple routines to do simple things, Separate functionality from
3802 output, Provide sensible shortcuts and defaults, Naming conventions,
3803 Parameter passing
3804
3805 =item Strictness and warnings
3806
3807 =item Backwards compatibility
3808
3809 =item Error handling and messages
3810
3811 =back
3812
3813 =item DOCUMENTING YOUR MODULE
3814
3815 =over 4
3816
3817 =item POD
3818
3819 =item README, INSTALL, release notes, changelogs
3820
3821 perl Makefile.PL, make, make test, make install, perl Build.PL, perl Build,
3822 perl Build test, perl Build install
3823
3824 =back
3825
3826 =item RELEASE CONSIDERATIONS
3827
3828 =over 4
3829
3830 =item Version numbering
3831
3832 =item Pre-requisites
3833
3834 =item Testing
3835
3836 =item Packaging
3837
3838 =item Licensing
3839
3840 =back
3841
3842 =item COMMON PITFALLS
3843
3844 =over 4
3845
3846 =item Reinventing the wheel
3847
3848 =item Trying to do too much
3849
3850 =item Inappropriate documentation
3851
3852 =back
3853
3854 =item SEE ALSO
3855
3856 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Packaging Tools,
3857 Testing tools, http://pause.perl.org/, Any good book on software
3858 engineering
3859
3860 =item AUTHOR
3861
3862 =back
3863
3864 =head2 perlmodinstall - Installing CPAN Modules
3865
3866 =over 4
3867
3868 =item DESCRIPTION
3869
3870 =over 4
3871
3872 =item PREAMBLE
3873
3874 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
3875 module (sometimes unnecessary), B<INSTALL> the module
3876
3877 =back
3878
3879 =item PORTABILITY
3880
3881 =item HEY
3882
3883 =item AUTHOR
3884
3885 =item COPYRIGHT
3886
3887 =back
3888
3889 =head2 perlnewmod - preparing a new module for distribution
3890
3891 =over 4
3892
3893 =item DESCRIPTION
3894
3895 =over 4
3896
3897 =item Warning
3898
3899 =item What should I make into a module?
3900
3901 =item Step-by-step: Preparing the ground
3902
3903 Look around, Check it's new, Discuss the need, Choose a name, Check again
3904
3905 =item Step-by-step: Making the module
3906
3907 Start with F<module-starter> or F<h2xs>, Use L<strict|strict> and
3908 L<warnings|warnings>, Use L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!,
3909 Use L<plain old documentation|perlpod>, Write tests, Write the README
3910
3911 =item Step-by-step: Distributing your module
3912
3913 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
3914 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
3915
3916 =back
3917
3918 =item AUTHOR
3919
3920 =item SEE ALSO
3921
3922 =back
3923
3924 =head2 perlutil - utilities packaged with the Perl distribution
3925
3926 =over 4
3927
3928 =item DESCRIPTION
3929
3930 =over 4
3931
3932 =item DOCUMENTATION
3933
3934 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
3935 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
3936 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
3937 L<roffitall|roffitall>
3938
3939 =item CONVERTORS
3940
3941 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
3942
3943 =item Administration
3944
3945 L<libnetcfg|libnetcfg>
3946
3947 =item Development
3948
3949 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
3950 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
3951
3952 =item SEE ALSO
3953
3954 =back
3955
3956 =back
3957
3958 =head2 perlcompile - Introduction to the Perl Compiler-Translator 
3959
3960 =over 4
3961
3962 =item DESCRIPTION
3963
3964 =over 4
3965
3966 =item Layout
3967
3968 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3969
3970 =back
3971
3972 =item Using The Back Ends
3973
3974 =over 4
3975
3976 =item The Cross Referencing Back End
3977
3978 i, &, s, r
3979
3980 =item The Decompiling Back End
3981
3982 =item The Lint Back End
3983
3984 =item The Simple C Back End
3985
3986 =item The Bytecode Back End
3987
3988 =item The Optimized C Back End
3989
3990 =back
3991
3992 =item Module List for the Compiler Suite
3993
3994 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3995 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
3996 B::Stackobj, B::Stash, B::Terse, B::Xref
3997
3998 =item KNOWN PROBLEMS
3999
4000 =item AUTHOR
4001
4002 =back
4003
4004 =head2 perlfilter - Source Filters
4005
4006 =over 4
4007
4008 =item DESCRIPTION
4009
4010 =item CONCEPTS
4011
4012 =item USING FILTERS
4013
4014 =item WRITING A SOURCE FILTER
4015
4016 =item WRITING A SOURCE FILTER IN C
4017
4018 B<Decryption Filters>
4019
4020 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
4021
4022 =item WRITING A SOURCE FILTER IN PERL
4023
4024 =item USING CONTEXT: THE DEBUG FILTER
4025
4026 =item CONCLUSION
4027
4028 =item THINGS TO LOOK OUT FOR
4029
4030 Some Filters Clobber the C<DATA> Handle
4031
4032 =item REQUIREMENTS
4033
4034 =item AUTHOR
4035
4036 =item Copyrights
4037
4038 =back
4039
4040 =head2 perlembed - how to embed perl in your C program
4041
4042 =over 4
4043
4044 =item DESCRIPTION
4045
4046 =over 4
4047
4048 =item PREAMBLE
4049
4050 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
4051 Perl?>, B<Use C from C?>, B<Use Perl from C?>
4052
4053 =item ROADMAP
4054
4055 =item Compiling your C program
4056
4057 =item Adding a Perl interpreter to your C program
4058
4059 =item Calling a Perl subroutine from your C program
4060
4061 =item Evaluating a Perl statement from your C program
4062
4063 =item Performing Perl pattern matches and substitutions from your C program
4064
4065 =item Fiddling with the Perl stack from your C program
4066
4067 =item Maintaining a persistent interpreter
4068
4069 =item Execution of END blocks
4070
4071 =item Maintaining multiple interpreter instances
4072
4073 =item Using Perl modules, which themselves use C libraries, from your C
4074 program
4075
4076 =back
4077
4078 =item Embedding Perl under Win32
4079
4080 =item Hiding Perl_
4081
4082 =item MORAL
4083
4084 =item AUTHOR
4085
4086 =item COPYRIGHT
4087
4088 =back
4089
4090 =head2 perldebguts - Guts of Perl debugging 
4091
4092 =over 4
4093
4094 =item DESCRIPTION
4095
4096 =item Debugger Internals
4097
4098 =over 4
4099
4100 =item Writing Your Own Debugger
4101
4102 =back
4103
4104 =item Frame Listing Output Examples
4105
4106 =item Debugging regular expressions
4107
4108 =over 4
4109
4110 =item Compile-time output
4111
4112 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
4113 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
4114 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
4115 C<anchored(TYPE)>
4116
4117 =item Types of nodes
4118
4119 =item Run-time output
4120
4121 =back
4122
4123 =item Debugging Perl memory usage
4124
4125 =over 4
4126
4127 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
4128
4129 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
4130 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
4131 6144>
4132
4133 =item Example of using B<-DL> switch
4134
4135 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
4136
4137 =item B<-DL> details
4138
4139 C<!!!>, C<!!>, C<!>
4140
4141 =item Limitations of B<-DL> statistics
4142
4143 =back
4144
4145 =item SEE ALSO
4146
4147 =back
4148
4149 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
4150
4151 =over 4
4152
4153 =item DESCRIPTION
4154
4155 =item SPECIAL NOTES
4156
4157 =over 4
4158
4159 =item make
4160
4161 =item Version caveat
4162
4163 =item Dynamic Loading versus Static Loading
4164
4165 =back
4166
4167 =item TUTORIAL
4168
4169 =over 4
4170
4171 =item EXAMPLE 1
4172
4173 =item EXAMPLE 2
4174
4175 =item What has gone on?
4176
4177 =item Writing good test scripts
4178
4179 =item EXAMPLE 3
4180
4181 =item What's new here?
4182
4183 =item Input and Output Parameters
4184
4185 =item The XSUBPP Program
4186
4187 =item The TYPEMAP file
4188
4189 =item Warning about Output Arguments
4190
4191 =item EXAMPLE 4
4192
4193 =item What has happened here?
4194
4195 =item Anatomy of .xs file
4196
4197 =item Getting the fat out of XSUBs
4198
4199 =item More about XSUB arguments
4200
4201 =item The Argument Stack
4202
4203 =item Extending your Extension
4204
4205 =item Documenting your Extension
4206
4207 =item Installing your Extension
4208
4209 =item EXAMPLE 5
4210
4211 =item New Things in this Example
4212
4213 =item EXAMPLE 6
4214
4215 =item New Things in this Example
4216
4217 =item EXAMPLE 7 (Coming Soon)
4218
4219 =item EXAMPLE 8 (Coming Soon)
4220
4221 =item EXAMPLE 9 Passing open files to XSes
4222
4223 =item Troubleshooting these Examples
4224
4225 =back
4226
4227 =item See also
4228
4229 =item Author
4230
4231 =over 4
4232
4233 =item Last Changed
4234
4235 =back
4236
4237 =back
4238
4239 =head2 perlxs - XS language reference manual
4240
4241 =over 4
4242
4243 =item DESCRIPTION
4244
4245 =over 4
4246
4247 =item Introduction
4248
4249 =item On The Road
4250
4251 =item The Anatomy of an XSUB
4252
4253 =item The Argument Stack
4254
4255 =item The RETVAL Variable
4256
4257 =item Returning SVs, AVs and HVs through RETVAL
4258
4259 =item The MODULE Keyword
4260
4261 =item The PACKAGE Keyword
4262
4263 =item The PREFIX Keyword
4264
4265 =item The OUTPUT: Keyword
4266
4267 =item The NO_OUTPUT Keyword
4268
4269 =item The CODE: Keyword
4270
4271 =item The INIT: Keyword
4272
4273 =item The NO_INIT Keyword
4274
4275 =item Initializing Function Parameters
4276
4277 =item Default Parameter Values
4278
4279 =item The PREINIT: Keyword
4280
4281 =item The SCOPE: Keyword
4282
4283 =item The INPUT: Keyword
4284
4285 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
4286
4287 =item The C<length(NAME)> Keyword
4288
4289 =item Variable-length Parameter Lists
4290
4291 =item The C_ARGS: Keyword
4292
4293 =item The PPCODE: Keyword
4294
4295 =item Returning Undef And Empty Lists
4296
4297 =item The REQUIRE: Keyword
4298
4299 =item The CLEANUP: Keyword
4300
4301 =item The POSTCALL: Keyword
4302
4303 =item The BOOT: Keyword
4304
4305 =item The VERSIONCHECK: Keyword
4306
4307 =item The PROTOTYPES: Keyword
4308
4309 =item The PROTOTYPE: Keyword
4310
4311 =item The ALIAS: Keyword
4312
4313 =item The OVERLOAD: Keyword
4314
4315 =item The FALLBACK: Keyword
4316
4317 =item The INTERFACE: Keyword
4318
4319 =item The INTERFACE_MACRO: Keyword
4320
4321 =item The INCLUDE: Keyword
4322
4323 =item The CASE: Keyword
4324
4325 =item The & Unary Operator
4326
4327 =item Inserting POD, Comments and C Preprocessor Directives
4328
4329 =item Using XS With C++
4330
4331 =item Interface Strategy
4332
4333 =item Perl Objects And C Structures
4334
4335 =item The Typemap
4336
4337 =item Safely Storing Static Data in XS
4338
4339 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4340
4341 =back
4342
4343 =item EXAMPLES
4344
4345 =item XS VERSION
4346
4347 =item AUTHOR
4348
4349 =back
4350
4351 =head2 perlclib - Internal replacements for standard C library functions
4352
4353 =over 4
4354
4355 =item DESCRIPTION
4356
4357 =over 4
4358
4359 =item Conventions
4360
4361 C<t>, C<p>, C<n>, C<s>
4362
4363 =item File Operations
4364
4365 =item File Input and Output
4366
4367 =item File Positioning
4368
4369 =item Memory Management and String Handling
4370
4371 =item Character Class Tests
4372
4373 =item F<stdlib.h> functions
4374
4375 =item Miscellaneous functions
4376
4377 =back
4378
4379 =item SEE ALSO
4380
4381 =back
4382
4383 =head2 perlguts - Introduction to the Perl API
4384
4385 =over 4
4386
4387 =item DESCRIPTION
4388
4389 =item Variables
4390
4391 =over 4
4392
4393 =item Datatypes
4394
4395 =item What is an "IV"?
4396
4397 =item Working with SVs
4398
4399 =item Offsets
4400
4401 =item What's Really Stored in an SV?
4402
4403 =item Working with AVs
4404
4405 =item Working with HVs
4406
4407 =item Hash API Extensions
4408
4409 =item AVs, HVs and undefined values
4410
4411 =item References
4412
4413 =item Blessed References and Class Objects
4414
4415 =item Creating New Variables
4416
4417 GV_ADDMULTI, GV_ADDWARN
4418
4419 =item Reference Counts and Mortality
4420
4421 =item Stashes and Globs
4422
4423 =item Double-Typed SVs
4424
4425 =item Magic Variables
4426
4427 =item Assigning Magic
4428
4429 =item Magic Virtual Tables
4430
4431 =item Finding Magic
4432
4433 =item Understanding the Magic of Tied Hashes and Arrays
4434
4435 =item Localizing changes
4436
4437 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
4438 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
4439 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
4440 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
4441 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
4442 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
4443 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
4444 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
4445 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
4446 save_hptr(HV **hptr)>
4447
4448 =back
4449
4450 =item Subroutines
4451
4452 =over 4
4453
4454 =item XSUBs and the Argument Stack
4455
4456 =item Calling Perl Routines from within C Programs
4457
4458 =item Memory Allocation
4459
4460 =item PerlIO
4461
4462 =item Putting a C value on Perl stack
4463
4464 =item Scratchpads
4465
4466 =item Scratchpads and recursion
4467
4468 =back
4469
4470 =item Compiled code
4471
4472 =over 4
4473
4474 =item Code tree
4475
4476 =item Examining the tree
4477
4478 =item Compile pass 1: check routines
4479
4480 =item Compile pass 1a: constant folding
4481
4482 =item Compile pass 2: context propagation
4483
4484 =item Compile pass 3: peephole optimization
4485
4486 =item Pluggable runops
4487
4488 =back
4489
4490 =item Examining internal data structures with the C<dump> functions
4491
4492 =item How multiple interpreters and concurrency are supported
4493
4494 =over 4
4495
4496 =item Background and PERL_IMPLICIT_CONTEXT
4497
4498 =item So what happened to dTHR?
4499
4500 =item How do I use all this in extensions?
4501
4502 =item Should I do anything special if I call perl from multiple threads?
4503
4504 =item Future Plans and PERL_IMPLICIT_SYS
4505
4506 =back
4507
4508 =item Internal Functions
4509
4510 A, p, d, s, n, r, f, M, o, x, m, X, E, b
4511
4512 =over 4
4513
4514 =item Formatted Printing of IVs, UVs, and NVs
4515
4516 =item Pointer-To-Integer and Integer-To-Pointer
4517
4518 =item Source Documentation
4519
4520 =back
4521
4522 =item Unicode Support
4523
4524 =over 4
4525
4526 =item What B<is> Unicode, anyway?
4527
4528 =item How can I recognise a UTF-8 string?
4529
4530 =item How does UTF-8 represent Unicode characters?
4531
4532 =item How does Perl store UTF-8 strings?
4533
4534 =item How do I convert a string to UTF-8?
4535
4536 =item Is there anything else I need to know?
4537
4538 =back
4539
4540 =item Custom Operators
4541
4542 =item AUTHORS
4543
4544 =item SEE ALSO
4545
4546 =back
4547
4548 =head2 perlcall - Perl calling conventions from C
4549
4550 =over 4
4551
4552 =item DESCRIPTION
4553
4554 An Error Handler, An Event Driven Program
4555
4556 =item THE CALL_ FUNCTIONS
4557
4558 call_sv, call_pv, call_method, call_argv
4559
4560 =item FLAG VALUES
4561
4562 =over 4
4563
4564 =item  G_VOID
4565
4566 =item  G_SCALAR
4567
4568 =item G_ARRAY
4569
4570 =item G_DISCARD
4571
4572 =item G_NOARGS
4573
4574 =item G_EVAL
4575
4576 =item G_KEEPERR
4577
4578 =item Determining the Context
4579
4580 =back
4581
4582 =item KNOWN PROBLEMS
4583
4584 =item EXAMPLES
4585
4586 =over 4
4587
4588 =item No Parameters, Nothing returned
4589
4590 =item Passing Parameters
4591
4592 =item Returning a Scalar
4593
4594 =item Returning a list of values
4595
4596 =item Returning a list in a scalar context
4597
4598 =item Returning Data from Perl via the parameter list
4599
4600 =item Using G_EVAL
4601
4602 =item Using G_KEEPERR
4603
4604 =item Using call_sv
4605
4606 =item Using call_argv
4607
4608 =item Using call_method
4609
4610 =item Using GIMME_V
4611
4612 =item Using Perl to dispose of temporaries
4613
4614 =item Strategies for storing Callback Context Information
4615
4616 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
4617 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
4618 callback
4619
4620 =item Alternate Stack Manipulation
4621
4622 =item Creating and calling an anonymous subroutine in C
4623
4624 =back
4625
4626 =item SEE ALSO
4627
4628 =item AUTHOR
4629
4630 =item DATE
4631
4632 =back
4633
4634 =head2 perlapi - autogenerated documentation for the perl public API
4635
4636 =over 4
4637
4638 =item DESCRIPTION
4639
4640 =item "Gimme" Values
4641
4642 GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
4643
4644 =item Array Manipulation Functions
4645
4646 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4647 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4648 get_av, newAV, sortsv
4649
4650 =item Callback Functions
4651
4652 call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
4653 FREETMPS, LEAVE, SAVETMPS
4654
4655 =item Character classes
4656
4657 isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
4658
4659 =item Cloning an interpreter
4660
4661 perl_clone
4662
4663 =item CV Manipulation Functions
4664
4665 CvSTASH, get_cv
4666
4667 =item Embedding Functions
4668
4669 cv_undef, load_module, nothreadhook, perl_alloc, perl_construct,
4670 perl_destruct, perl_free, perl_parse, perl_run, require_pv
4671
4672 =item Functions in file pp_pack.c
4673
4674 packlist, pack_cat, unpackstring, unpack_str
4675
4676 =item Global Variables
4677
4678 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
4679
4680 =item GV Functions
4681
4682 GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
4683 gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
4684
4685 =item Handy Values
4686
4687 Nullav, Nullch, Nullcv, Nullhv, Nullsv
4688
4689 =item Hash Manipulation Functions
4690
4691 get_hv, HEf_SVKEY, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force,
4692 HeSVKEY_set, HeVAL, HvNAME, hv_assert, hv_clear, hv_clear_placeholders,
4693 hv_delete, hv_delete_ent, hv_exists, hv_exists_ent, hv_fetch, hv_fetch_ent,
4694 hv_iterinit, hv_iterkey, hv_iterkeysv, hv_iternext, hv_iternextsv,
4695 hv_iternext_flags, hv_iterval, hv_magic, hv_scalar, hv_store, hv_store_ent,
4696 hv_undef, newHV
4697
4698 =item Magical Functions
4699
4700 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
4701 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
4702 SvSetSV, SvSetSV_nosteal, SvSHARE, SvUNLOCK
4703
4704 =item Memory Management
4705
4706 Copy, CopyD, Move, MoveD, New, Newc, Newz, Poison, Renew, Renewc, Safefree,
4707 savepv, savepvn, savesharedpv, StructCopy, Zero, ZeroD
4708
4709 =item Miscellaneous Functions
4710
4711 fbm_compile, fbm_instr, form, getcwd_sv, new_version, scan_version, strEQ,
4712 strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_nolocking,
4713 sv_nosharing, sv_nounlocking, upg_version, vcmp, vnormal, vnumify,
4714 vstringify
4715
4716 =item Numeric functions
4717
4718 grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
4719 scan_hex, scan_oct
4720
4721 =item Optree Manipulation Functions
4722
4723 cv_const_sv, newCONSTSUB, newXS
4724
4725 =item Pad Data Structures
4726
4727 pad_sv
4728
4729 =item Stack Manipulation Macros
4730
4731 dMARK, dORIGMARK, dSP, EXTEND, MARK, mPUSHi, mPUSHn, mPUSHp, mPUSHu,
4732 mXPUSHi, mXPUSHn, mXPUSHp, mXPUSHu, ORIGMARK, POPi, POPl, POPn, POPp,
4733 POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHmortal, PUSHn, PUSHp, PUSHs,
4734 PUSHu, PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHmortal, XPUSHn, XPUSHp, XPUSHs,
4735 XPUSHu, XSRETURN, XSRETURN_EMPTY, XSRETURN_IV, XSRETURN_NO, XSRETURN_NV,
4736 XSRETURN_PV, XSRETURN_UNDEF, XSRETURN_UV, XSRETURN_YES, XST_mIV, XST_mNO,
4737 XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
4738
4739 =item SV Flags
4740
4741 svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
4742
4743 =item SV Manipulation Functions
4744
4745 get_sv, looks_like_number, newRV_inc, newRV_noinc, NEWSV, newSV, newSViv,
4746 newSVnv, newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv,
4747 newSVuv, SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV,
4748 SvIOK_off, SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIsCOW,
4749 SvIsCOW_shared_hash, SvIV, SvIVx, SvIVX, SvIV_nomg, SvLEN, SvNIOK, SvNIOKp,
4750 SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX,
4751 SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only,
4752 SvPOK_only_UTF8, SvPV, SvPVbyte, SvPVbytex, SvPVbytex_force,
4753 SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, SvPVutf8x, SvPVutf8x_force,
4754 SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX, SvPV_force, SvPV_force_nomg,
4755 SvPV_nolen, SvPV_nomg, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK,
4756 SvROK_off, SvROK_on, SvRV, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off,
4757 SvTAINTED_on, SvTRUE, SvTYPE, SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off,
4758 SvUTF8_on, SvUV, SvUVX, SvUVx, SvUV_nomg, SvVOK, sv_2bool, sv_2cv, sv_2io,
4759 sv_2iv_flags, sv_2mortal, sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen, sv_2pvutf8,
4760 sv_2pvutf8_nolen, sv_2pv_flags, sv_2pv_nolen, sv_2uv_flags, sv_backoff,
4761 sv_bless, sv_catpv, sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_flags,
4762 sv_catpvn_mg, sv_catpvn_nomg, sv_catpv_mg, sv_catsv, sv_catsv_flags,
4763 sv_catsv_mg, sv_catsv_nomg, sv_chop, sv_clear, sv_cmp, sv_cmp_locale,
4764 sv_collxfrm, sv_copypv, sv_dec, sv_derived_from, sv_eq, sv_force_normal,
4765 sv_force_normal_flags, sv_free, sv_gets, sv_grow, sv_inc, sv_insert,
4766 sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8, sv_magic, sv_magicext,
4767 sv_mortalcopy, sv_newmortal, sv_newref, sv_nv, sv_pos_b2u, sv_pos_u2b,
4768 sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force, sv_pvn, sv_pvn_force,
4769 sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n, sv_pvutf8n_force, sv_reftype,
4770 sv_replace, sv_report_used, sv_reset, sv_rvweaken, sv_setiv, sv_setiv_mg,
4771 sv_setnv, sv_setnv_mg, sv_setpv, sv_setpvf, sv_setpvf_mg, sv_setpviv,
4772 sv_setpviv_mg, sv_setpvn, sv_setpvn_mg, sv_setpv_mg, sv_setref_iv,
4773 sv_setref_nv, sv_setref_pv, sv_setref_pvn, sv_setref_uv, sv_setsv,
4774 sv_setsv_flags, sv_setsv_mg, sv_setsv_nomg, sv_setuv, sv_setuv_mg,
4775 sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref, sv_unref_flags,
4776 sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg, sv_utf8_decode,
4777 sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade, sv_utf8_upgrade_flags,
4778 sv_uv, sv_vcatpvf, sv_vcatpvfn, sv_vcatpvf_mg, sv_vsetpvf, sv_vsetpvfn,
4779 sv_vsetpvf_mg
4780
4781 =item Unicode Support
4782
4783 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
4784 is_utf8_string_loc, pv_uni_display, sv_cat_decode, sv_recode_to_utf8,
4785 sv_uni_display, to_utf8_case, to_utf8_fold, to_utf8_lower, to_utf8_title,
4786 to_utf8_upper, utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop,
4787 utf8_length, utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8,
4788 uvuni_to_utf8_flags
4789
4790 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
4791
4792 ax, CLASS, dAX, dITEMS, dUNDERBAR, dXSARGS, dXSI32, items, ix, newXSproto,
4793 RETVAL, ST, THIS, UNDERBAR, XS, XS_VERSION, XS_VERSION_BOOTCHECK
4794
4795 =item Warning and Dieing
4796
4797 croak, warn
4798
4799 =item AUTHORS
4800
4801 =item SEE ALSO
4802
4803 =back
4804
4805 =head2 perlintern - autogenerated documentation of purely B<internal>
4806                  Perl functions
4807
4808 =over 4
4809
4810 =item DESCRIPTION
4811
4812 =item CV reference counts and CvOUTSIDE
4813
4814 CvWEAKOUTSIDE
4815
4816 =item Functions in file pad.h
4817
4818 CX_CURPAD_SAVE, CX_CURPAD_SV, PAD_BASE_SV, PAD_CLONE_VARS,
4819 PAD_COMPNAME_FLAGS, PAD_COMPNAME_GEN, PAD_COMPNAME_OURSTASH,
4820 PAD_COMPNAME_PV, PAD_COMPNAME_TYPE, PAD_DUP, PAD_RESTORE_LOCAL,
4821 PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV, PAD_SET_CUR,
4822 PAD_SET_CUR_NOSAVE, PAD_SV, PAD_SVl, SAVECLEARSV, SAVECOMPPAD, SAVEPADSV
4823
4824 =item Functions in file pp_ctl.c
4825
4826 find_runcv
4827
4828 =item Global Variables
4829
4830 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
4831 PL_rs
4832
4833 =item GV Functions
4834
4835 is_gv_magical
4836
4837 =item IO Functions
4838
4839 start_glob
4840
4841 =item Pad Data Structures
4842
4843 CvPADLIST, cv_clone, cv_dump, do_dump_pad, intro_my, pad_add_anon,
4844 pad_add_name, pad_alloc, pad_block_start, pad_check_dup, pad_findlex,
4845 pad_findmy, pad_fixup_inner_anons, pad_free, pad_leavemy, pad_new,
4846 pad_push, pad_reset, pad_setsv, pad_swipe, pad_tidy, pad_undef
4847
4848 =item Stack Manipulation Macros
4849
4850 djSP, LVRET
4851
4852 =item SV Manipulation Functions
4853
4854 find_uninit_var, report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs,
4855 sv_free_arenas
4856
4857 =item AUTHORS
4858
4859 =item SEE ALSO
4860
4861 =back
4862
4863 =head2 perliol - C API for Perl's implementation of IO in Layers.
4864
4865 =over 4
4866
4867 =item SYNOPSIS
4868
4869 =item DESCRIPTION
4870
4871 =over 4
4872
4873 =item History and Background
4874
4875 =item Basic Structure
4876
4877 =item Layers vs Disciplines
4878
4879 =item Data Structures
4880
4881 =item Functions and Attributes
4882
4883 =item Per-instance Data
4884
4885 =item Layers in action.
4886
4887 =item Per-instance flag bits
4888
4889 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4890 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4891 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4892 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4893
4894 =item Methods in Detail
4895
4896 fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF,
4897 PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode,
4898 Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof,
4899 Error,  Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
4900 Set_ptrcnt
4901
4902 =item Utilities
4903
4904 =item Implementing PerlIO Layers
4905
4906 C implementations, Perl implementations
4907
4908 =item Core Layers
4909
4910 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4911
4912 =item Extension Layers
4913
4914 ":encoding", ":scalar", ":via"
4915
4916 =back
4917
4918 =item TODO
4919
4920 =back
4921
4922 =head2 perlapio - perl's IO abstraction interface.
4923
4924 =over 4
4925
4926 =item SYNOPSIS
4927
4928 =item DESCRIPTION
4929
4930 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4931 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4932 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4933 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4934 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4935 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4936 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4937 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4938 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4939 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4940 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4941
4942 =over 4
4943
4944 =item Co-existence with stdio
4945
4946 B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
4947 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
4948
4949 =item "Fast gets" Functions
4950
4951 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4952 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4953 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4954 B<PerlIO_get_bufsiz(f)>
4955
4956 =item Other Functions
4957
4958 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4959 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4960
4961 =back
4962
4963 =back
4964
4965 =head2 perlhack - How to hack at the Perl internals
4966
4967 =over 4
4968
4969 =item DESCRIPTION
4970
4971 Does concept match the general goals of Perl?, Where is the
4972 implementation?, Backwards compatibility, Could it be a module instead?, Is
4973 the feature generic enough?, Does it potentially introduce new bugs?, Does
4974 it preclude other desirable features?, Is the implementation robust?, Is
4975 the implementation generic enough to be portable?, Is the implementation
4976 tested?, Is there enough documentation?, Is there another way to do it?,
4977 Does it create too much work?, Patches speak louder than words
4978
4979 =over 4
4980
4981 =item Keeping in sync
4982
4983 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
4984 NFS, rsync'ing the patches
4985
4986 =item Why rsync the source tree
4987
4988 It's easier to rsync the source tree, It's more reliable
4989
4990 =item Why rsync the patches
4991
4992 It's easier to rsync the patches, It's a good reference, Finding a start
4993 point, Finding how to fix a bug, Finding the source of misbehaviour
4994
4995 =item Working with the source
4996
4997 =item Perlbug administration
4998
4999 =item Submitting patches
5000
5001 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
5002 F<Porting/pumpkin.pod>, The perl5-porters FAQ
5003
5004 =item Finding Your Way Around
5005
5006 Core modules, Tests, Documentation, Configure, Interpreter
5007
5008 =item Elements of the interpreter
5009
5010 Startup, Parsing, Optimization, Running
5011
5012 =item Internal Variable Types
5013
5014 =item Op Trees
5015
5016 =item Stacks
5017
5018 Argument stack, Mark stack, Save stack
5019
5020 =item Millions of Macros
5021
5022 =item The .i Targets
5023
5024 =item Poking at Perl
5025
5026 =item Using a source-level debugger
5027
5028 run [args], break function_name, break source.c:xxx, step, next, continue,
5029 finish, 'enter', print
5030
5031 =item gdb macro support
5032
5033 =item Dumping Perl Data Structures
5034
5035 =item Patching
5036
5037 =item Patching a core module
5038
5039 =item Adding a new function to the core
5040
5041 =item Writing a test
5042
5043 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5044 F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base t/comp,
5045 t/cmd t/run t/io t/op, t/lib ext lib
5046
5047 =item Special Make Test Targets
5048
5049 coretest, test.deparse, test.taintwarn, minitest, test.valgrind
5050 check.valgrind utest.valgrind ucheck.valgrind, test.third check.third
5051 utest.third ucheck.third, test.torture torturetest, utest ucheck test.utf8
5052 check.utf8, minitest.utf16 test.utf16, test_harness
5053
5054 =item Running tests by hand
5055
5056 PERL_CORE=1, PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST
5057
5058 =back
5059
5060 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5061
5062 =over 4
5063
5064 =item Rational Software's Purify
5065
5066 =item Purify on Unix
5067
5068 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5069
5070 =item Purify on NT
5071
5072 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5073
5074 =item valgrind
5075
5076 =item Compaq's/Digital's/HP's Third Degree
5077
5078 =item PERL_DESTRUCT_LEVEL
5079
5080 =item Profiling
5081
5082 =item Gprof Profiling
5083
5084 -a, -b, -e routine, -f routine, -s, -z
5085
5086 =item GCC gcov Profiling
5087
5088 =item Pixie Profiling
5089
5090 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5091 -z[ero]
5092
5093 =item Miscellaneous tricks
5094
5095 =item CONCLUSION
5096
5097 I<The Road goes ever on and on, down from the door where it began.>
5098
5099 =back
5100
5101 =item AUTHOR
5102
5103 =back
5104
5105 =head2 perlbook - Perl book information
5106
5107 =over 4
5108
5109 =item DESCRIPTION
5110
5111 =back
5112
5113 =head2 perltodo - Perl TO-DO List
5114
5115 =over 4
5116
5117 =item DESCRIPTION
5118
5119 =item assertions
5120
5121 =item iCOW
5122
5123 =item (?{...}) closures in regexps
5124
5125 =item A re-entrant regexp engine
5126
5127 =item pragmata
5128
5129 =over 4
5130
5131 =item lexical pragmas
5132
5133 =item use less 'memory'
5134
5135 =back
5136
5137 =item prototypes and functions
5138
5139 =over 4
5140
5141 =item _ prototype character
5142
5143 =item inlining autoloaded constants
5144
5145 =item Finish off lvalue functions
5146
5147 =back
5148
5149 =item Unicode and UTF8
5150
5151 =over 4
5152
5153 =item Implicit Latin 1 => Unicode translation
5154
5155 =item UTF8 caching code
5156
5157 =item Unicode in Filenames
5158
5159 =item Unicode in %ENV
5160
5161 =back
5162
5163 =item Regexps
5164
5165 =over 4
5166
5167 =item regexp optimiser optional
5168
5169 =item common suffices/prefices in regexps (trie optimization)
5170
5171 =back
5172
5173 =item POD
5174
5175 =over 4
5176
5177 =item POD -> HTML conversion still sucks
5178
5179 =back
5180
5181 =item Misc medium sized projects
5182
5183 =over 4
5184
5185 =item UNITCHECK
5186
5187 =item optional optimizer
5188
5189 =item You WANT *how* many
5190
5191 =item lexical aliases
5192
5193 =item no 6
5194
5195 =item IPv6
5196
5197 =item entersub XS vs Perl
5198
5199 =item @INC source filter to Filter::Simple
5200
5201 =item bincompat functions
5202
5203 =item Use fchown/fchmod internally
5204
5205 =back
5206
5207 =item Tests
5208
5209 =over 4
5210
5211 =item Make Schwern poorer
5212
5213 =item test B
5214
5215 =item Improve tests for Config.pm
5216
5217 =item common test code for timed bailout
5218
5219 =back
5220
5221 =item Installation
5222
5223 =over 4
5224
5225 =item compressed man pages
5226
5227 =item Make Config.pm cope with differences between build and installed perl
5228
5229 =item Relocatable perl
5230
5231 =item make HTML install work
5232
5233 =item put patchlevel in -v
5234
5235 =back
5236
5237 =item Incremental things
5238
5239 =over 4
5240
5241 =item autovivification
5242
5243 =item fix tainting bugs
5244
5245 =item Make tainting consistent
5246
5247 =item Dual life everything
5248
5249 =back
5250
5251 =item Vague things
5252
5253 =over 4
5254
5255 =item threads
5256
5257 =item POSIX memory footprint
5258
5259 =item Optimize away @_
5260
5261 =item switch ops
5262
5263 =item Attach/detach debugger from running program
5264
5265 =item A decent benchmark
5266
5267 =item readpipe(LIST)
5268
5269 =back
5270
5271 =back
5272
5273 =head2 perldoc - Look up Perl documentation in Pod format.
5274
5275 =over 4
5276
5277 =item SYNOPSIS
5278
5279 =item DESCRIPTION
5280
5281 =item OPTIONS
5282
5283 B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
5284 I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
5285 I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
5286 B<-w> I<option:value> or B<-w> I<option>, B<-X>,
5287 B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
5288 B<-V>
5289
5290 =item SECURITY
5291
5292 =item ENVIRONMENT
5293
5294 =item AUTHOR
5295
5296 =back
5297
5298 =head2 perlhist - the Perl history records
5299
5300 =over 4
5301
5302 =item DESCRIPTION
5303
5304 =item INTRODUCTION
5305
5306 =item THE KEEPERS OF THE PUMPKIN
5307
5308 =over 4
5309
5310 =item PUMPKIN?
5311
5312 =back
5313
5314 =item THE RECORDS
5315
5316 =over 4
5317
5318 =item SELECTED RELEASE SIZES
5319
5320 =item SELECTED PATCH SIZES
5321
5322 =back
5323
5324 =item THE KEEPERS OF THE RECORDS
5325
5326 =back
5327
5328 =head2 perldelta - what is new for perl v5.9.2
5329
5330 =over 4
5331
5332 =item DESCRIPTION
5333
5334 =item Incompatible Changes
5335
5336 =item Core Enhancements
5337
5338 =item Modules and Pragmata
5339
5340 =item Utility Changes
5341
5342 =item Documentation
5343
5344 =item Performance Enhancements
5345
5346 =item Installation and Configuration Improvements
5347
5348 =item Selected Bug Fixes
5349
5350 =item New or Changed Diagnostics
5351
5352 =item Changed Internals
5353
5354 =item Known Problems
5355
5356 =over 4
5357
5358 =item Platform Specific Problems
5359
5360 =back
5361
5362 =item Reporting Bugs
5363
5364 =item SEE ALSO
5365
5366 =back
5367
5368 =head2 perl592delta, perldelta - what is new for perl v5.9.2
5369
5370 =over 4
5371
5372 =item DESCRIPTION
5373
5374 =item Incompatible Changes
5375
5376 =item Core Enhancements
5377
5378 =item Modules and Pragmata
5379
5380 =item Utility Changes
5381
5382 =item Documentation
5383
5384 =item Performance Enhancements
5385
5386 =item Installation and Configuration Improvements
5387
5388 =item Selected Bug Fixes
5389
5390 =item New or Changed Diagnostics
5391
5392 =item Changed Internals
5393
5394 =item Known Problems
5395
5396 =over 4
5397
5398 =item Platform Specific Problems
5399
5400 =back
5401
5402 =item Reporting Bugs
5403
5404 =item SEE ALSO
5405
5406 =back
5407
5408 =head2 perl591delta, perldelta - what is new for perl v5.9.1
5409
5410 =over 4
5411
5412 =item DESCRIPTION
5413
5414 =item Incompatible Changes
5415
5416 =over 4
5417
5418 =item substr() lvalues are no longer fixed-length
5419
5420 =item The C<:unique> attribute is only meaningful for globals
5421
5422 =back
5423
5424 =item Core Enhancements
5425
5426 =over 4
5427
5428 =item Lexical C<$_>
5429
5430 =item Tied hashes in scalar context
5431
5432 =item Formats
5433
5434 =item Stacked filetest operators
5435
5436 =back
5437
5438 =item Modules and Pragmata
5439
5440 Benchmark, Carp, Exporter, FindBin, List::Util, threads::shared
5441
5442 =item Utility Changes
5443
5444 =item Documentation
5445
5446 =item Performance Enhancements
5447
5448 =item Selected Bug Fixes
5449
5450 =over 4
5451
5452 =item UTF-8 bugs
5453
5454 =item Threading bugs
5455
5456 =item More bugs
5457
5458 =back
5459
5460 =item New or Changed Diagnostics
5461
5462 =item Changed Internals
5463
5464 =over 4
5465
5466 =item Reordering of SVt_* constants
5467
5468 =item Removal of CPP symbols
5469
5470 =item Less space is used by ops
5471
5472 =item New parser
5473
5474 =back
5475
5476 =item Configuration and Building
5477
5478 =item Known Problems
5479
5480 =over 4
5481
5482 =item Platform Specific Problems
5483
5484 =back
5485
5486 =item To-do for perl 5.10.0
5487
5488 =item Reporting Bugs
5489
5490 =item SEE ALSO
5491
5492 =back
5493
5494 =head2 perl590delta, perldelta - what is new for perl v5.9.0
5495
5496 =over 4
5497
5498 =item DESCRIPTION
5499
5500 =item Incompatible Changes
5501
5502 =over 4
5503
5504 =item Hash Randomisation
5505
5506 =item UTF-8 On Filehandles No Longer Activated By Locale
5507
5508 =item Single-number v-strings are no longer v-strings before "=>"
5509
5510 =item (Win32) The -C Switch Has Been Repurposed
5511
5512 =item (Win32) The /d Switch Of cmd.exe
5513
5514 =item The C<$*> variable has been removed
5515
5516 =back
5517
5518 =item Core Enhancements
5519
5520 =over 4
5521
5522 =item Assertions
5523
5524 =item Defined-or operators
5525
5526 =item UTF-8 no longer default under UTF-8 locales
5527
5528 =item Unsafe signals again available
5529
5530 =item Tied Arrays with Negative Array Indices
5531
5532 =item local ${$x}
5533
5534 =item Unicode Character Database 4.0.0
5535
5536 =item Miscellaneous Enhancements
5537
5538 =back
5539
5540 =item Modules and Pragmata
5541
5542 =over 4
5543
5544 =item Updated Modules And Pragmata
5545
5546 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
5547 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
5548 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
5549 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
5550 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
5551 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
5552 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
5553 Win32::GetOSVersion
5554
5555 =back
5556
5557 =item Utility Changes
5558
5559 =item New Documentation
5560
5561 =item Performance Enhancements
5562
5563 =item Installation and Configuration Improvements
5564
5565 =over 4
5566
5567 =item Platform-specific enhancements
5568
5569 =back
5570
5571 =item Selected Bug Fixes
5572
5573 =over 4
5574
5575 =item Closures, eval and lexicals
5576
5577 =item Generic fixes
5578
5579 =item Platform-specific fixes
5580
5581 =back
5582
5583 =item New or Changed Diagnostics
5584
5585 =over 4
5586
5587 =item Changed "A thread exited while %d threads were running"
5588
5589 =item Removed "Attempt to clear a restricted hash"
5590
5591 =item New "Illegal declaration of anonymous subroutine"
5592
5593 =item Changed "Invalid range "%s" in transliteration operator"
5594
5595 =item New "Missing control char name in \c"
5596
5597 =item New "Newline in left-justified string for %s"
5598
5599 =item New "Possible precedence problem on bitwise %c operator"
5600
5601 =item New "read() on %s filehandle %s"
5602
5603 =item New "Tied variable freed while still in use"
5604
5605 =item New "To%s: illegal mapping '%s'"
5606
5607 =item New "Use of freed value in iteration"
5608
5609 =back
5610
5611 =item Changed Internals
5612
5613 =item New Tests
5614
5615 =item Known Problems
5616
5617 =over 4
5618
5619 =item Tied hashes in scalar context
5620
5621 =item Net::Ping 450_service and 510_ping_udp failures
5622
5623 =item B::C
5624
5625 =back
5626
5627 =item Platform Specific Problems
5628
5629 =over 4
5630
5631 =item EBCDIC Platforms
5632
5633 =item Cygwin 1.5 problems
5634
5635 =item HP-UX: HP cc warnings about sendfile and sendpath
5636
5637 =item IRIX: t/uni/tr_7jis.t falsely failing
5638
5639 =item Mac OS X: no usemymalloc
5640
5641 =item Tru64: No threaded builds with GNU cc (gcc)
5642
5643 =item Win32: sysopen, sysread, syswrite
5644
5645 =back
5646
5647 =item TODO
5648
5649 =item Reporting Bugs
5650
5651 =item SEE ALSO
5652
5653 =back
5654
5655 =head2 perl586delta - what is new for perl v5.8.6
5656
5657 =over 4
5658
5659 =item DESCRIPTION
5660
5661 =item Incompatible Changes
5662
5663 =item Core Enhancements
5664
5665 =item Modules and Pragmata
5666
5667 =item Utility Changes
5668
5669 =item Performance Enhancements
5670
5671 =item Selected Bug Fixes
5672
5673 =item New or Changed Diagnostics
5674
5675 =item Changed Internals
5676
5677 =item New Tests
5678
5679 =item Reporting Bugs
5680
5681 =item SEE ALSO
5682
5683 =back
5684
5685 =head2 perl585delta - what is new for perl v5.8.5
5686
5687 =over 4
5688
5689 =item DESCRIPTION
5690
5691 =item Incompatible Changes
5692
5693 =item Core Enhancements
5694
5695 =item Modules and Pragmata
5696
5697 =item Utility Changes
5698
5699 =over 4
5700
5701 =item Perl's debugger
5702
5703 =item h2ph
5704
5705 =back
5706
5707 =item Installation and Configuration Improvements
5708
5709 =item Selected Bug Fixes
5710
5711 =item New or Changed Diagnostics
5712
5713 =item Changed Internals
5714
5715 =item Known Problems
5716
5717 =item Platform Specific Problems
5718
5719 =item Reporting Bugs
5720
5721 =item SEE ALSO
5722
5723 =back
5724
5725 =head2 perl584delta - what is new for perl v5.8.4
5726
5727 =over 4
5728
5729 =item DESCRIPTION
5730
5731 =item Incompatible Changes
5732
5733 =item Core Enhancements
5734
5735 =over 4
5736
5737 =item Malloc wrapping
5738
5739 =item Unicode Character Database 4.0.1
5740
5741 =item suidperl less insecure
5742
5743 =item format
5744
5745 =back
5746
5747 =item Modules and Pragmata
5748
5749 =over 4
5750
5751 =item Updated modules
5752
5753 Attribute::Handlers, B, Benchmark, CGI, Carp, Cwd, Exporter, File::Find,
5754 IO, IPC::Open3, Local::Maketext, Math::BigFloat, Math::BigInt,
5755 Math::BigRat, MIME::Base64, ODBM_File, POSIX, Shell, Socket, Storable,
5756 Switch, Sys::Syslog, Term::ANSIColor, Time::HiRes, Unicode::UCD, Win32,
5757 base, open, threads, utf8
5758
5759 =back
5760
5761 =item Performance Enhancements
5762
5763 =item Utility Changes
5764
5765 =item Installation and Configuration Improvements
5766
5767 =item Selected Bug Fixes
5768
5769 =item New or Changed Diagnostics
5770
5771 =item Changed Internals
5772
5773 =item Future Directions
5774
5775 =item Platform Specific Problems
5776
5777 =item Reporting Bugs
5778
5779 =item SEE ALSO
5780
5781 =back
5782
5783 =head2 perl583delta - what is new for perl v5.8.3
5784
5785 =over 4
5786
5787 =item DESCRIPTION
5788
5789 =item Incompatible Changes
5790
5791 =item Core Enhancements
5792
5793 =item Modules and Pragmata
5794
5795 CGI, Cwd, Digest, Digest::MD5, Encode, File::Spec, FindBin, List::Util,
5796 Math::BigInt, PodParser, Pod::Perldoc, POSIX, Unicode::Collate,
5797 Unicode::Normalize, Test::Harness, threads::shared
5798
5799 =item Utility Changes
5800
5801 =item New Documentation
5802
5803 =item Installation and Configuration Improvements
5804
5805 =item Selected Bug Fixes
5806
5807 =item New or Changed Diagnostics
5808
5809 =item Changed Internals
5810
5811 =item Configuration and Building
5812
5813 =item Platform Specific Problems
5814
5815 =item Known Problems
5816
5817 =item Future Directions
5818
5819 =item Obituary
5820
5821 =item Reporting Bugs
5822
5823 =item SEE ALSO
5824
5825 =back
5826
5827 =head2 perl582delta - what is new for perl v5.8.2
5828
5829 =over 4
5830
5831 =item DESCRIPTION
5832
5833 =item Incompatible Changes
5834
5835 =item Core Enhancements
5836
5837 =over 4
5838
5839 =item Hash Randomisation
5840
5841 =item Threading
5842
5843 =back
5844
5845 =item Modules and Pragmata
5846
5847 =over 4
5848
5849 =item Updated Modules And Pragmata
5850
5851 Devel::PPPort, Digest::MD5, I18N::LangTags, libnet, MIME::Base64,
5852 Pod::Perldoc, strict, Tie::Hash, Time::HiRes, Unicode::Collate,
5853 Unicode::Normalize, UNIVERSAL
5854
5855 =back
5856
5857 =item Selected Bug Fixes
5858
5859 =item Changed Internals
5860
5861 =item Platform Specific Problems
5862
5863 =item Future Directions
5864
5865 =item Reporting Bugs
5866
5867 =item SEE ALSO
5868
5869 =back
5870
5871 =head2 perl581delta - what is new for perl v5.8.1
5872
5873 =over 4
5874
5875 =item DESCRIPTION
5876
5877 =item Incompatible Changes
5878
5879 =over 4
5880
5881 =item Hash Randomisation
5882
5883 =item UTF-8 On Filehandles No Longer Activated By Locale
5884
5885 =item Single-number v-strings are no longer v-strings before "=>"
5886
5887 =item (Win32) The -C Switch Has Been Repurposed
5888
5889 =item (Win32) The /d Switch Of cmd.exe
5890
5891 =back
5892
5893 =item Core Enhancements
5894
5895 =over 4
5896
5897 =item UTF-8 no longer default under UTF-8 locales
5898
5899 =item Unsafe signals again available
5900
5901 =item Tied Arrays with Negative Array Indices
5902
5903 =item local ${$x}
5904
5905 =item Unicode Character Database 4.0.0
5906
5907 =item Deprecation Warnings
5908
5909 =item Miscellaneous Enhancements
5910
5911 =back
5912
5913 =item Modules and Pragmata
5914
5915 =over 4
5916
5917 =item Updated Modules And Pragmata
5918
5919 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
5920 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
5921 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
5922 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
5923 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
5924 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
5925 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
5926 Win32::GetOSVersion
5927
5928 =back
5929
5930 =item Utility Changes
5931
5932 =item New Documentation
5933
5934 =item Installation and Configuration Improvements
5935
5936 =over 4
5937
5938 =item Platform-specific enhancements
5939
5940 =back
5941
5942 =item Selected Bug Fixes
5943
5944 =over 4
5945
5946 =item Closures, eval and lexicals
5947
5948 =item Generic fixes
5949
5950 =item Platform-specific fixes
5951
5952 =back
5953
5954 =item New or Changed Diagnostics
5955
5956 =over 4
5957
5958 =item Changed "A thread exited while %d threads were running"
5959
5960 =item Removed "Attempt to clear a restricted hash"
5961
5962 =item New "Illegal declaration of anonymous subroutine"
5963
5964 =item Changed "Invalid range "%s" in transliteration operator"
5965
5966 =item New "Missing control char name in \c"
5967
5968 =item New "Newline in left-justified string for %s"
5969
5970 =item New "Possible precedence problem on bitwise %c operator"
5971
5972 =item New "Pseudo-hashes are deprecated"
5973
5974 =item New "read() on %s filehandle %s"
5975
5976 =item New "5.005 threads are deprecated"
5977
5978 =item New "Tied variable freed while still in use"
5979
5980 =item New "To%s: illegal mapping '%s'"
5981
5982 =item New "Use of freed value in iteration"
5983
5984 =back
5985
5986 =item Changed Internals
5987
5988 =item New Tests
5989
5990 =item Known Problems
5991
5992 =over 4
5993
5994 =item Tied hashes in scalar context
5995
5996 =item Net::Ping 450_service and 510_ping_udp failures
5997
5998 =item B::C
5999
6000 =back
6001
6002 =item Platform Specific Problems
6003
6004 =over 4
6005
6006 =item EBCDIC Platforms
6007
6008 =item Cygwin 1.5 problems
6009
6010 =item HP-UX: HP cc warnings about sendfile and sendpath
6011
6012 =item IRIX: t/uni/tr_7jis.t falsely failing
6013
6014 =item Mac OS X: no usemymalloc
6015
6016 =item Tru64: No threaded builds with GNU cc (gcc)
6017
6018 =item Win32: sysopen, sysread, syswrite
6019
6020 =back
6021
6022 =item Future Directions
6023
6024 =item Reporting Bugs
6025
6026 =item SEE ALSO
6027
6028 =back
6029
6030 =head2 perl58delta - what is new for perl v5.8.0
6031
6032 =over 4
6033
6034 =item DESCRIPTION
6035
6036 =item Highlights In 5.8.0
6037
6038 =item Incompatible Changes
6039
6040 =over 4
6041
6042 =item Binary Incompatibility
6043
6044 =item 64-bit platforms and malloc
6045
6046 =item AIX Dynaloading
6047
6048 =item Attributes for C<my> variables now handled at run-time
6049
6050 =item Socket Extension Dynamic in VMS
6051
6052 =item IEEE-format Floating Point Default on OpenVMS Alpha
6053
6054 =item New Unicode Semantics (no more C<use utf8>, almost)
6055
6056 =item New Unicode Properties
6057
6058 =item REF(...) Instead Of SCALAR(...)
6059
6060 =item pack/unpack D/F recycled
6061
6062 =item glob() now returns filenames in alphabetical order
6063
6064 =item Deprecations
6065
6066 =back
6067
6068 =item Core Enhancements
6069
6070 =over 4
6071
6072 =item Unicode Overhaul
6073
6074 =item PerlIO is Now The Default
6075
6076 =item ithreads
6077
6078 =item Restricted Hashes
6079
6080 =item Safe Signals
6081
6082 =item Understanding of Numbers
6083
6084 =item Arrays now always interpolate into double-quoted strings [561]
6085
6086 =item Miscellaneous Changes
6087
6088 =back
6089
6090 =item Modules and Pragmata
6091
6092 =over 4
6093
6094 =item New Modules and Pragmata
6095
6096 =item Updated And Improved Modules and Pragmata
6097
6098 =back
6099
6100 =item Utility Changes
6101
6102 =item New Documentation
6103
6104 =item Performance Enhancements
6105
6106 =item Installation and Configuration Improvements
6107
6108 =over 4
6109
6110 =item Generic Improvements
6111
6112 =item New Or Improved Platforms
6113
6114 =back
6115
6116 =item Selected Bug Fixes
6117
6118 =over 4
6119
6120 =item Platform Specific Changes and Fixes
6121
6122 =back
6123
6124 =item New or Changed Diagnostics
6125
6126 =item Changed Internals
6127
6128 =item Security Vulnerability Closed [561]
6129
6130 =item New Tests
6131
6132 =item Known Problems
6133
6134 =over 4
6135
6136 =item The Compiler Suite Is Still Very Experimental
6137
6138 =item Localising Tied Arrays and Hashes Is Broken
6139
6140 =item Building Extensions Can Fail Because Of Largefiles
6141
6142 =item Modifying $_ Inside for(..)
6143
6144 =item mod_perl 1.26 Doesn't Build With Threaded Perl
6145
6146 =item lib/ftmp-security tests warn 'system possibly insecure'
6147
6148 =item libwww-perl (LWP) fails base/date #51
6149
6150 =item PDL failing some tests
6151
6152 =item Perl_get_sv
6153
6154 =item Self-tying Problems
6155
6156 =item ext/threads/t/libc
6157
6158 =item Failure of Thread (5.005-style) tests
6159
6160 =item Timing problems
6161
6162 =item Tied/Magical Array/Hash Elements Do Not Autovivify
6163
6164 =item Unicode in package/class and subroutine names does not work
6165
6166 =back
6167
6168 =item Platform Specific Problems
6169
6170 =over 4
6171
6172 =item AIX
6173
6174 =item Alpha systems with old gccs fail several tests
6175
6176 =item AmigaOS
6177
6178 =item BeOS
6179
6180 =item Cygwin "unable to remap"
6181
6182 =item Cygwin ndbm tests fail on FAT
6183
6184 =item DJGPP Failures
6185
6186 =item FreeBSD built with ithreads coredumps reading large directories
6187
6188 =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
6189
6190 =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
6191
6192 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
6193
6194 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
6195
6196 =item Linux With Sfio Fails op/misc Test 48
6197
6198 =item Mac OS X
6199
6200 =item Mac OS X dyld undefined symbols
6201
6202 =item OS/2 Test Failures
6203
6204 =item op/sprintf tests 91, 129, and 130
6205
6206 =item SCO
6207
6208 =item Solaris 2.5
6209
6210 =item Solaris x86 Fails Tests With -Duse64bitint
6211
6212 =item SUPER-UX (NEC SX)
6213
6214 =item Term::ReadKey not working on Win32
6215
6216 =item UNICOS/mk
6217
6218 =item UTS
6219
6220 =item VOS (Stratus)
6221
6222 =item VMS
6223
6224 =item Win32
6225
6226 =item XML::Parser not working
6227
6228 =item z/OS (OS/390)
6229
6230 =item Unicode Support on EBCDIC Still Spotty
6231
6232 =item Seen In Perl 5.7 But Gone Now
6233
6234 =back
6235
6236 =item Reporting Bugs
6237
6238 =item SEE ALSO
6239
6240 =item HISTORY
6241
6242 =back
6243
6244 =head2 perl573delta - what's new for perl v5.7.3
6245
6246 =over 4
6247
6248 =item DESCRIPTION
6249
6250 =item Changes
6251
6252 =item Reporting Bugs
6253
6254 =item SEE ALSO
6255
6256 =item HISTORY
6257
6258 =back
6259
6260 =head2 perl572delta - what's new for perl v5.7.2
6261
6262 =over 4
6263
6264 =item DESCRIPTION
6265
6266 =item Security Vulnerability Closed
6267
6268 =item Incompatible Changes
6269
6270 =over 4
6271
6272 =item 64-bit platforms and malloc
6273
6274 =item AIX Dynaloading
6275
6276 =item Socket Extension Dynamic in VMS
6277
6278 =item Different Definition of the Unicode Character Classes \p{In...}
6279
6280 =item Deprecations
6281
6282 =back
6283
6284 =item Core Enhancements
6285
6286 =item Modules and Pragmata
6287
6288 =over 4
6289
6290 =item New Modules and Distributions
6291
6292 =item Updated And Improved Modules and Pragmata
6293
6294 =back
6295
6296 =item Utility Changes
6297
6298 =item New Documentation
6299
6300 =item Installation and Configuration Improvements
6301
6302 =over 4
6303
6304 =item New Or Improved Platforms
6305
6306 =item Generic Improvements
6307
6308 =back
6309
6310 =item Selected Bug Fixes
6311
6312 =over 4
6313
6314 =item Platform Specific Changes and Fixes
6315
6316 =back
6317
6318 =item New or Changed Diagnostics
6319
6320 =item Source Code Enhancements
6321
6322 =over 4
6323
6324 =item MAGIC constants
6325
6326 =item Better commented code
6327
6328 =item Regex pre-/post-compilation items matched up
6329
6330 =item gcc -Wall
6331
6332 =back
6333
6334 =item New Tests
6335
6336 =item Known Problems
6337
6338 =over 4
6339
6340 =item AIX
6341
6342 =item Amiga Perl Invoking Mystery
6343
6344 =item lib/ftmp-security tests warn 'system possibly insecure'
6345
6346 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
6347
6348 =item HP-UX lib/io_multihomed Fails When LP64-Configured
6349
6350 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
6351
6352 =item Linux With Sfio Fails op/misc Test 48
6353
6354 =item OS/390
6355
6356 =item op/sprintf tests 129 and 130
6357
6358 =item  Failure of Thread tests
6359
6360 =item UNICOS
6361
6362 =item UTS
6363
6364 =item VMS
6365
6366 =item Win32
6367
6368 =item Localising a Tied Variable Leaks Memory
6369
6370 =item Self-tying of Arrays and Hashes Is Forbidden
6371
6372 =item Variable Attributes are not Currently Usable for Tieing
6373
6374 =item Building Extensions Can Fail Because Of Largefiles
6375
6376 =item The Compiler Suite Is Still Experimental
6377
6378 =item The Long Double Support is Still Experimental
6379
6380 =back
6381
6382 =item Reporting Bugs
6383
6384 =item SEE ALSO
6385
6386 =item HISTORY
6387
6388 =back
6389
6390 =head2 perl571delta - what's new for perl v5.7.1
6391
6392 =over 4
6393
6394 =item DESCRIPTION
6395
6396 =item Security Vulnerability Closed
6397
6398 =item Incompatible Changes
6399
6400 =item Core Enhancements
6401
6402 =over 4
6403
6404 =item AUTOLOAD Is Now Lvaluable
6405
6406 =item PerlIO is Now The Default
6407
6408 =item Signals Are Now Safe
6409
6410 =back
6411
6412 =item Modules and Pragmata
6413
6414 =over 4
6415
6416 =item New Modules
6417
6418 =item Updated And Improved Modules and Pragmata
6419
6420 =back
6421
6422 =item Performance Enhancements
6423
6424 =item Utility Changes
6425
6426 =item New Documentation
6427
6428 =over 4
6429
6430 =item perlclib
6431
6432 =item perliol
6433
6434 =item README.aix
6435
6436 =item README.bs2000
6437
6438 =item README.macos
6439
6440 =item README.mpeix
6441
6442 =item README.solaris
6443
6444 =item README.vos
6445
6446 =item Porting/repository.pod
6447
6448 =back
6449
6450 =item Installation and Configuration Improvements
6451
6452 =over 4
6453
6454 =item New Or Improved Platforms
6455
6456 =item Generic Improvements
6457
6458 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
6459 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
6460 d_strtoq, d_u32align, d_ualarm, d_usleep
6461
6462 =back
6463
6464 =item Selected Bug Fixes
6465
6466 =over 4
6467
6468 =item Platform Specific Changes and Fixes
6469
6470 =back
6471
6472 =item New or Changed Diagnostics
6473
6474 =item Changed Internals
6475
6476 =item New Tests
6477
6478 =item Known Problems
6479
6480 =over 4
6481
6482 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
6483
6484 =item lib/ftmp-security tests warn 'system possibly insecure'
6485
6486 =item lib/io_multihomed Fails In LP64-Configured HP-UX
6487
6488 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
6489
6490 =item lib/b test 19
6491
6492 =item Linux With Sfio Fails op/misc Test 48
6493
6494 =item sigaction test 13 in VMS
6495
6496 =item sprintf tests 129 and 130
6497
6498 =item  Failure of Thread tests
6499
6500 =item Localising a Tied Variable Leaks Memory
6501
6502 =item Self-tying of Arrays and Hashes Is Forbidden
6503
6504 =item Building Extensions Can Fail Because Of Largefiles
6505
6506 =item The Compiler Suite Is Still Experimental
6507
6508 =back
6509
6510 =item Reporting Bugs
6511
6512 =item SEE ALSO
6513
6514 =item HISTORY
6515
6516 =back
6517
6518 =head2 perl570delta - what's new for perl v5.7.0
6519
6520 =over 4
6521
6522 =item DESCRIPTION
6523
6524 =item Security Vulnerability Closed
6525
6526 =item Incompatible Changes
6527
6528 =item Core Enhancements
6529
6530 =item Modules and Pragmata
6531
6532 =over 4
6533
6534 =item New Modules
6535
6536 =item Updated And Improved Modules and Pragmata
6537
6538 =back
6539
6540 =item Utility Changes
6541
6542 =item New Documentation
6543
6544 =item Performance Enhancements
6545
6546 =item Installation and Configuration Improvements
6547
6548 =over 4
6549
6550 =item Generic Improvements
6551
6552 =back
6553
6554 =item Selected Bug Fixes
6555
6556 =over 4
6557
6558 =item Platform Specific Changes and Fixes
6559
6560 =back
6561
6562 =item New or Changed Diagnostics
6563
6564 =item Changed Internals
6565
6566 =item Known Problems
6567
6568 =over 4
6569
6570 =item Unicode Support Still Far From Perfect
6571
6572 =item EBCDIC Still A Lost Platform
6573
6574 =item Building Extensions Can Fail Because Of Largefiles
6575
6576 =item ftmp-security tests warn 'system possibly insecure'
6577
6578 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
6579
6580 =item Long Doubles Still Don't Work In Solaris
6581
6582 =item Linux With Sfio Fails op/misc Test 48
6583
6584 =item Storable tests fail in some platforms
6585
6586 =item Threads Are Still Experimental
6587
6588 =item The Compiler Suite Is Still Experimental
6589
6590 =back
6591
6592 =item Reporting Bugs
6593
6594 =item SEE ALSO
6595
6596 =item HISTORY
6597
6598 =back
6599
6600 =head2 perl561delta - what's new for perl v5.6.x
6601
6602 =over 4
6603
6604 =item DESCRIPTION
6605
6606 =item Summary of changes between 5.6.0 and 5.6.1
6607
6608 =over 4
6609
6610 =item Security Issues
6611
6612 =item Core bug fixes
6613
6614 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
6615 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
6616 references to special variables, Lexical warnings, Spurious warnings and
6617 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
6618 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
6619 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
6620 Module;>, Tests
6621
6622 =item Core features
6623
6624 =item Configuration issues
6625
6626 =item Documentation
6627
6628 =item Bundled modules
6629
6630 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
6631 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
6632 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
6633 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
6634
6635 =item Platform-specific improvements
6636
6637 NCR MP-RAS, NonStop-UX
6638
6639 =back
6640
6641 =item Core Enhancements
6642
6643 =over 4
6644
6645 =item Interpreter cloning, threads, and concurrency
6646
6647 =item Lexically scoped warning categories
6648
6649 =item Unicode and UTF-8 support
6650
6651 =item Support for interpolating named characters
6652
6653 =item "our" declarations
6654
6655 =item Support for strings represented as a vector of ordinals
6656
6657 =item Improved Perl version numbering system
6658
6659 =item New syntax for declaring subroutine attributes
6660
6661 =item File and directory handles can be autovivified
6662
6663 =item open() with more than two arguments
6664
6665 =item 64-bit support
6666
6667 =item Large file support
6668
6669 =item Long doubles
6670
6671 =item "more bits"
6672
6673 =item Enhanced support for sort() subroutines
6674
6675 =item C<sort $coderef @foo> allowed
6676
6677 =item File globbing implemented internally
6678
6679 =item Support for CHECK blocks
6680
6681 =item POSIX character class syntax [: :] supported
6682
6683 =item Better pseudo-random number generator
6684
6685 =item Improved C<qw//> operator
6686
6687 =item Better worst-case behavior of hashes
6688
6689 =item pack() format 'Z' supported
6690
6691 =item pack() format modifier '!' supported
6692
6693 =item pack() and unpack() support counted strings
6694
6695 =item Comments in pack() templates
6696
6697 =item Weak references
6698
6699 =item Binary numbers supported
6700
6701 =item Lvalue subroutines
6702
6703 =item Some arrows may be omitted in calls through references
6704
6705 =item Boolean assignment operators are legal lvalues
6706
6707 =item exists() is supported on subroutine names
6708
6709 =item exists() and delete() are supported on array elements
6710
6711 =item Pseudo-hashes work better
6712
6713 =item Automatic flushing of output buffers
6714
6715 =item Better diagnostics on meaningless filehandle operations
6716
6717 =item Where possible, buffered data discarded from duped input filehandle
6718
6719 =item eof() has the same old magic as <>
6720
6721 =item binmode() can be used to set :crlf and :raw modes
6722
6723 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6724
6725 =item system(), backticks and pipe open now reflect exec() failure
6726
6727 =item Improved diagnostics
6728
6729 =item Diagnostics follow STDERR
6730
6731 =item More consistent close-on-exec behavior
6732
6733 =item syswrite() ease-of-use
6734
6735 =item Better syntax checks on parenthesized unary operators
6736
6737 =item Bit operators support full native integer width
6738
6739 =item Improved security features
6740
6741 =item More functional bareword prototype (*)
6742
6743 =item C<require> and C<do> may be overridden
6744
6745 =item $^X variables may now have names longer than one character
6746
6747 =item New variable $^C reflects C<-c> switch
6748
6749 =item New variable $^V contains Perl version as a string
6750
6751 =item Optional Y2K warnings
6752
6753 =item Arrays now always interpolate into double-quoted strings
6754
6755 =back
6756
6757 =item Modules and Pragmata
6758
6759 =over 4
6760
6761 =item Modules
6762
6763 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6764 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6765 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6766 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6767 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6768 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6769 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6770 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6771
6772 =item Pragmata
6773
6774 =back
6775
6776 =item Utility Changes
6777
6778 =over 4
6779
6780 =item dprofpp
6781
6782 =item find2perl
6783
6784 =item h2xs
6785
6786 =item perlcc
6787
6788 =item perldoc
6789
6790 =item The Perl Debugger
6791
6792 =back
6793
6794 =item Improved Documentation
6795
6796 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6797 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6798 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6799 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6800
6801 =item Performance enhancements
6802
6803 =over 4
6804
6805 =item Simple sort() using { $a <=> $b } and the like are optimized
6806
6807 =item Optimized assignments to lexical variables
6808
6809 =item Faster subroutine calls
6810
6811 =item delete(), each(), values() and hash iteration are faster
6812
6813 =back
6814
6815 =item Installation and Configuration Improvements
6816
6817 =over 4
6818
6819 =item -Dusethreads means something different
6820
6821 =item New Configure flags
6822
6823 =item Threadedness and 64-bitness now more daring
6824
6825 =item Long Doubles
6826
6827 =item -Dusemorebits
6828
6829 =item -Duselargefiles
6830
6831 =item installusrbinperl
6832
6833 =item SOCKS support
6834
6835 =item C<-A> flag
6836
6837 =item Enhanced Installation Directories
6838
6839 =item gcc automatically tried if 'cc' does not seem to be working
6840
6841 =back
6842
6843 =item Platform specific changes
6844
6845 =over 4
6846
6847 =item Supported platforms
6848
6849 =item DOS
6850
6851 =item OS390 (OpenEdition MVS)
6852
6853 =item VMS
6854
6855 =item Win32
6856
6857 =back
6858
6859 =item Significant bug fixes
6860
6861 =over 4
6862
6863 =item <HANDLE> on empty files
6864
6865 =item C<eval '...'> improvements
6866
6867 =item All compilation errors are true errors
6868
6869 =item Implicitly closed filehandles are safer
6870
6871 =item Behavior of list slices is more consistent
6872
6873 =item C<(\$)> prototype and C<$foo{a}>
6874
6875 =item C<goto &sub> and AUTOLOAD
6876
6877 =item C<-bareword> allowed under C<use integer>
6878
6879 =item Failures in DESTROY()
6880
6881 =item Locale bugs fixed
6882
6883 =item Memory leaks
6884
6885 =item Spurious subroutine stubs after failed subroutine calls
6886
6887 =item Taint failures under C<-U>
6888
6889 =item END blocks and the C<-c> switch
6890
6891 =item Potential to leak DATA filehandles
6892
6893 =back
6894
6895 =item New or Changed Diagnostics
6896
6897 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6898 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6899 / cannot take a count, / must be followed by a, A or Z, / must be followed
6900 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6901 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6902 passed through, /%s/ should probably be written as "%s", %s() called too
6903 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6904 argument is not a HASH or ARRAY element or slice, %s argument is not a
6905 subroutine name, %s package attribute may clash with future reserved word:
6906 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6907 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6908 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6909 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6910 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6911 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6912 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6913 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6914 weaken a nonreference, Character class [:%s:] unknown, Character class
6915 syntax [%s] belongs inside character classes, Constant is not %s reference,
6916 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6917 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6918 "local" instead of "our"?), Document contains no data, entering effective
6919 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6920 output, flock() on closed filehandle %s, Global symbol "%s" requires
6921 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6922 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6923 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6924 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6925 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6926 separator character %s in attribute list, Invalid separator character %s in
6927 subroutine attribute list, leaving effective %s failed, Lvalue subs
6928 returning %s not implemented yet, Method %s not permitted, Missing
6929 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6930 No %s specified for -%c, No package name allowed for variable %s in "our",
6931 No space allowed after -%c, no UTC offset information; assuming local time
6932 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6933 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6934 around "%s" list, Possible unintended interpolation of %s in string,
6935 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6936 instead, Premature end of script headers, Repeat count in pack overflows,
6937 Repeat count in unpack overflows, realloc() of freed memory ignored,
6938 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6939 zero-length expression, switching effective %s is not implemented, This
6940 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6941 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6942 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6943 escape \\%c passed through, Unterminated attribute parameter in attribute
6944 list, Unterminated attribute list, Unterminated attribute parameter in
6945 subroutine attribute list, Unterminated subroutine attribute list, Value of
6946 CLI symbol "%s" too long, Version number must be a constant number
6947
6948 =item New tests
6949
6950 =item Incompatible Changes
6951
6952 =over 4
6953
6954 =item Perl Source Incompatibilities
6955
6956 CHECK is a new keyword, Treatment of list slices of undef has changed,
6957 Format of $English::PERL_VERSION is different, Literals of the form
6958 C<1.2.3> parse differently, Possibly changed pseudo-random number
6959 generator, Hashing function for hash keys has changed, C<undef> fails on
6960 read only values, Close-on-exec bit may be set on pipe and socket handles,
6961 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6962 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6963 Text of some diagnostic output has changed, C<%@> has been removed,
6964 Parenthesized not() behaves like a list operator, Semantics of bareword
6965 prototype C<(*)> have changed, Semantics of bit operators may have changed
6966 on 64-bit platforms, More builtins taint their results
6967
6968 =item C Source Incompatibilities
6969
6970 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6971
6972 =item Compatible C Source API Changes
6973
6974 C<PATCHLEVEL> is now C<PERL_VERSION>
6975
6976 =item Binary Incompatibilities
6977
6978 =back
6979
6980 =item Known Problems
6981
6982 =over 4
6983
6984 =item Localizing a tied hash element may leak memory
6985
6986 =item Known test failures
6987
6988 =item EBCDIC platforms not fully supported
6989
6990 =item UNICOS/mk CC failures during Configure run
6991
6992 =item Arrow operator and arrays
6993
6994 =item Experimental features
6995
6996 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6997 pseudo-hash data type, The Compiler suite, Internal implementation of file
6998 globbing, The DB module, The regular expression code constructs:
6999
7000 =back
7001
7002 =item Obsolete Diagnostics
7003
7004 Character class syntax [: :] is reserved for future extensions, Ill-formed
7005 logical name |%s| in prime_env_iter, In string, @%s now must be written as
7006 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
7007 to mean "${$}<digit>" is deprecated
7008
7009 =item Reporting Bugs
7010
7011 =item SEE ALSO
7012
7013 =item HISTORY
7014
7015 =back
7016
7017 =head2 perl56delta - what's new for perl v5.6.0
7018
7019 =over 4
7020
7021 =item DESCRIPTION
7022
7023 =item Core Enhancements
7024
7025 =over 4
7026
7027 =item Interpreter cloning, threads, and concurrency
7028
7029 =item Lexically scoped warning categories
7030
7031 =item Unicode and UTF-8 support
7032
7033 =item Support for interpolating named characters
7034
7035 =item "our" declarations
7036
7037 =item Support for strings represented as a vector of ordinals
7038
7039 =item Improved Perl version numbering system
7040
7041 =item New syntax for declaring subroutine attributes
7042
7043 =item File and directory handles can be autovivified
7044
7045 =item open() with more than two arguments
7046
7047 =item 64-bit support
7048
7049 =item Large file support
7050
7051 =item Long doubles
7052
7053 =item "more bits"
7054
7055 =item Enhanced support for sort() subroutines
7056
7057 =item C<sort $coderef @foo> allowed
7058
7059 =item File globbing implemented internally
7060
7061 =item Support for CHECK blocks
7062
7063 =item POSIX character class syntax [: :] supported
7064
7065 =item Better pseudo-random number generator
7066
7067 =item Improved C<qw//> operator
7068
7069 =item Better worst-case behavior of hashes
7070
7071 =item pack() format 'Z' supported
7072
7073 =item pack() format modifier '!' supported
7074
7075 =item pack() and unpack() support counted strings
7076
7077 =item Comments in pack() templates
7078
7079 =item Weak references
7080
7081 =item Binary numbers supported
7082
7083 =item Lvalue subroutines
7084
7085 =item Some arrows may be omitted in calls through references
7086
7087 =item Boolean assignment operators are legal lvalues
7088
7089 =item exists() is supported on subroutine names
7090
7091 =item exists() and delete() are supported on array elements
7092
7093 =item Pseudo-hashes work better
7094
7095 =item Automatic flushing of output buffers
7096
7097 =item Better diagnostics on meaningless filehandle operations
7098
7099 =item Where possible, buffered data discarded from duped input filehandle
7100
7101 =item eof() has the same old magic as <>
7102
7103 =item binmode() can be used to set :crlf and :raw modes
7104
7105 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
7106
7107 =item system(), backticks and pipe open now reflect exec() failure
7108
7109 =item Improved diagnostics
7110
7111 =item Diagnostics follow STDERR
7112
7113 =item More consistent close-on-exec behavior
7114
7115 =item syswrite() ease-of-use
7116
7117 =item Better syntax checks on parenthesized unary operators
7118
7119 =item Bit operators support full native integer width
7120
7121 =item Improved security features
7122
7123 =item More functional bareword prototype (*)
7124
7125 =item C<require> and C<do> may be overridden
7126
7127 =item $^X variables may now have names longer than one character
7128
7129 =item New variable $^C reflects C<-c> switch
7130
7131 =item New variable $^V contains Perl version as a string
7132
7133 =item Optional Y2K warnings
7134
7135 =item Arrays now always interpolate into double-quoted strings
7136
7137 =back
7138
7139 =item Modules and Pragmata
7140
7141 =over 4
7142
7143 =item Modules
7144
7145 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
7146 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
7147 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
7148 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
7149 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
7150 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
7151 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
7152 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
7153
7154 =item Pragmata
7155
7156 =back
7157
7158 =item Utility Changes
7159
7160 =over 4
7161
7162 =item dprofpp
7163
7164 =item find2perl
7165
7166 =item h2xs
7167
7168 =item perlcc
7169
7170 =item perldoc
7171
7172 =item The Perl Debugger
7173
7174 =back
7175
7176 =item Improved Documentation
7177
7178 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
7179 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
7180 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
7181 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
7182
7183 =item Performance enhancements
7184
7185 =over 4
7186
7187 =item Simple sort() using { $a <=> $b } and the like are optimized
7188
7189 =item Optimized assignments to lexical variables
7190
7191 =item Faster subroutine calls
7192
7193 =item delete(), each(), values() and hash iteration are faster
7194
7195 =back
7196
7197 =item Installation and Configuration Improvements
7198
7199 =over 4
7200
7201 =item -Dusethreads means something different
7202
7203 =item New Configure flags
7204
7205 =item Threadedness and 64-bitness now more daring
7206
7207 =item Long Doubles
7208
7209 =item -Dusemorebits
7210
7211 =item -Duselargefiles
7212
7213 =item installusrbinperl
7214
7215 =item SOCKS support
7216
7217 =item C<-A> flag
7218
7219 =item Enhanced Installation Directories
7220
7221 =back
7222
7223 =item Platform specific changes
7224
7225 =over 4
7226
7227 =item Supported platforms
7228
7229 =item DOS
7230
7231 =item OS390 (OpenEdition MVS)
7232
7233 =item VMS
7234
7235 =item Win32
7236
7237 =back
7238
7239 =item Significant bug fixes
7240
7241 =over 4
7242
7243 =item <HANDLE> on empty files
7244
7245 =item C<eval '...'> improvements
7246
7247 =item All compilation errors are true errors
7248
7249 =item Implicitly closed filehandles are safer
7250
7251 =item Behavior of list slices is more consistent
7252
7253 =item C<(\$)> prototype and C<$foo{a}>
7254
7255 =item C<goto &sub> and AUTOLOAD
7256
7257 =item C<-bareword> allowed under C<use integer>
7258
7259 =item Failures in DESTROY()
7260
7261 =item Locale bugs fixed
7262
7263 =item Memory leaks
7264
7265 =item Spurious subroutine stubs after failed subroutine calls
7266
7267 =item Taint failures under C<-U>
7268
7269 =item END blocks and the C<-c> switch
7270
7271 =item Potential to leak DATA filehandles
7272
7273 =back
7274
7275 =item New or Changed Diagnostics
7276
7277 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
7278 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
7279 / cannot take a count, / must be followed by a, A or Z, / must be followed
7280 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
7281 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
7282 passed through, /%s/ should probably be written as "%s", %s() called too
7283 early to check prototype, %s argument is not a HASH or ARRAY element, %s
7284 argument is not a HASH or ARRAY element or slice, %s argument is not a
7285 subroutine name, %s package attribute may clash with future reserved word:
7286 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
7287 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
7288 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
7289 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
7290 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
7291 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
7292 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
7293 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
7294 weaken a nonreference, Character class [:%s:] unknown, Character class
7295 syntax [%s] belongs inside character classes, Constant is not %s reference,
7296 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
7297 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
7298 "local" instead of "our"?), Document contains no data, entering effective
7299 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
7300 output, flock() on closed filehandle %s, Global symbol "%s" requires
7301 explicit package name, Hexadecimal number > 0xffffffff non-portable,
7302 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
7303 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
7304 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
7305 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
7306 separator character %s in attribute list, Invalid separator character %s in
7307 subroutine attribute list, leaving effective %s failed, Lvalue subs
7308 returning %s not implemented yet, Method %s not permitted, Missing
7309 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
7310 No %s specified for -%c, No package name allowed for variable %s in "our",
7311 No space allowed after -%c, no UTC offset information; assuming local time
7312 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
7313 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
7314 around "%s" list, Possible unintended interpolation of %s in string,
7315 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
7316 instead, Premature end of script headers, Repeat count in pack overflows,
7317 Repeat count in unpack overflows, realloc() of freed memory ignored,
7318 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
7319 zero-length expression, switching effective %s is not implemented, This
7320 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
7321 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
7322 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
7323 escape \\%c passed through, Unterminated attribute parameter in attribute
7324 list, Unterminated attribute list, Unterminated attribute parameter in
7325 subroutine attribute list, Unterminated subroutine attribute list, Value of
7326 CLI symbol "%s" too long, Version number must be a constant number
7327
7328 =item New tests
7329
7330 =item Incompatible Changes
7331
7332 =over 4
7333
7334 =item Perl Source Incompatibilities
7335
7336 CHECK is a new keyword, Treatment of list slices of undef has changed,
7337 Format of $English::PERL_VERSION is different, Literals of the form
7338 C<1.2.3> parse differently, Possibly changed pseudo-random number
7339 generator, Hashing function for hash keys has changed, C<undef> fails on
7340 read only values, Close-on-exec bit may be set on pipe and socket handles,
7341 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
7342 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
7343 Text of some diagnostic output has changed, C<%@> has been removed,
7344 Parenthesized not() behaves like a list operator, Semantics of bareword
7345 prototype C<(*)> have changed, Semantics of bit operators may have changed
7346 on 64-bit platforms, More builtins taint their results
7347
7348 =item C Source Incompatibilities
7349
7350 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
7351
7352 =item Compatible C Source API Changes
7353
7354 C<PATCHLEVEL> is now C<PERL_VERSION>
7355
7356 =item Binary Incompatibilities
7357
7358 =back
7359
7360 =item Known Problems
7361
7362 =over 4
7363
7364 =item Thread test failures
7365
7366 =item EBCDIC platforms not supported
7367
7368 =item In 64-bit HP-UX the lib/io_multihomed test may hang
7369
7370 =item NEXTSTEP 3.3 POSIX test failure
7371
7372 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
7373 gcc
7374
7375 =item UNICOS/mk CC failures during Configure run
7376
7377 =item Arrow operator and arrays
7378
7379 =item Experimental features
7380
7381 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
7382 pseudo-hash data type, The Compiler suite, Internal implementation of file
7383 globbing, The DB module, The regular expression code constructs:
7384
7385 =back
7386
7387 =item Obsolete Diagnostics
7388
7389 Character class syntax [: :] is reserved for future extensions, Ill-formed
7390 logical name |%s| in prime_env_iter, In string, @%s now must be written as
7391 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
7392 to mean "${$}<digit>" is deprecated
7393
7394 =item Reporting Bugs
7395
7396 =item SEE ALSO
7397
7398 =item HISTORY
7399
7400 =back
7401
7402 =head2 perl5005delta - what's new for perl5.005
7403
7404 =over 4
7405
7406 =item DESCRIPTION
7407
7408 =item About the new versioning system
7409
7410 =item Incompatible Changes
7411
7412 =over 4
7413
7414 =item WARNING:  This version is not binary compatible with Perl 5.004.
7415
7416 =item Default installation structure has changed
7417
7418 =item Perl Source Compatibility
7419
7420 =item C Source Compatibility
7421
7422 =item Binary Compatibility
7423
7424 =item Security fixes may affect compatibility
7425
7426 =item Relaxed new mandatory warnings introduced in 5.004
7427
7428 =item Licensing
7429
7430 =back
7431
7432 =item Core Changes
7433
7434 =over 4
7435
7436 =item Threads
7437
7438 =item Compiler
7439
7440 =item Regular Expressions
7441
7442 Many new and improved optimizations, Many bug fixes, New regular expression
7443 constructs, New operator for precompiled regular expressions, Other
7444 improvements, Incompatible changes
7445
7446 =item   Improved malloc()
7447
7448 =item Quicksort is internally implemented
7449
7450 =item Reliable signals
7451
7452 =item Reliable stack pointers
7453
7454 =item More generous treatment of carriage returns
7455
7456 =item Memory leaks
7457
7458 =item Better support for multiple interpreters
7459
7460 =item Behavior of local() on array and hash elements is now well-defined
7461
7462 =item C<%!> is transparently tied to the L<Errno> module
7463
7464 =item Pseudo-hashes are supported
7465
7466 =item C<EXPR foreach EXPR> is supported
7467
7468 =item Keywords can be globally overridden
7469
7470 =item C<$^E> is meaningful on Win32
7471
7472 =item C<foreach (1..1000000)> optimized
7473
7474 =item C<Foo::> can be used as implicitly quoted package name
7475
7476 =item C<exists $Foo::{Bar::}> tests existence of a package
7477
7478 =item Better locale support
7479
7480 =item Experimental support for 64-bit platforms
7481
7482 =item prototype() returns useful results on builtins
7483
7484 =item Extended support for exception handling
7485
7486 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
7487
7488 =item All C<printf> format conversions are handled internally
7489
7490 =item New C<INIT> keyword
7491
7492 =item New C<lock> keyword
7493
7494 =item New C<qr//> operator
7495
7496 =item C<our> is now a reserved word
7497
7498 =item Tied arrays are now fully supported
7499
7500 =item Tied handles support is better
7501
7502 =item 4th argument to substr
7503
7504 =item Negative LENGTH argument to splice
7505
7506 =item Magic lvalues are now more magical
7507
7508 =item <> now reads in records
7509
7510 =back
7511
7512 =item Supported Platforms
7513
7514 =over 4
7515
7516 =item New Platforms
7517
7518 =item Changes in existing support
7519
7520 =back
7521
7522 =item Modules and Pragmata
7523
7524 =over 4
7525
7526 =item New Modules
7527
7528 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
7529 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
7530 Thread, attrs, fields, re
7531
7532 =item Changes in existing modules
7533
7534 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
7535 MakeMaker, CPAN, Cwd
7536
7537 =back
7538
7539 =item Utility Changes
7540
7541 =item Documentation Changes
7542
7543 =item New Diagnostics
7544
7545 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
7546 while coercing array into hash, Bareword "%s" refers to nonexistent
7547 package, Can't call method "%s" on an undefined value, Can't check
7548 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
7549 goto subroutine from an eval-string, Can't localize pseudo-hash element,
7550 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
7551 for "%s", Character class syntax [. .] is reserved for future extensions,
7552 Character class syntax [: :] is reserved for future extensions, Character
7553 class syntax [= =] is reserved for future extensions, %s: Eval-group in
7554 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
7555 Eval-group not allowed at run time, Explicit blessing to '' (assuming
7556 package main), Illegal hex digit ignored, No such array field, No such
7557 field "%s" in variable %s of type %s, Out of memory during ridiculously
7558 large request, Range iterator outside integer range, Recursive inheritance
7559 detected while looking for method '%s' %s, Reference found where even-sized
7560 list expected, Undefined value assigned to typeglob, Use of reserved word
7561 "%s" is deprecated, perl: warning: Setting locale failed
7562
7563 =item Obsolete Diagnostics
7564
7565 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
7566 temporary file, regexp too big
7567
7568 =item Configuration Changes
7569
7570 =item BUGS
7571
7572 =item SEE ALSO
7573
7574 =item HISTORY
7575
7576 =back
7577
7578 =head2 perl5004delta - what's new for perl5.004
7579
7580 =over 4
7581
7582 =item DESCRIPTION
7583
7584 =item Supported Environments
7585
7586 =item Core Changes
7587
7588 =over 4
7589
7590 =item List assignment to %ENV works
7591
7592 =item Change to "Can't locate Foo.pm in @INC" error
7593
7594 =item Compilation option: Binary compatibility with 5.003
7595
7596 =item $PERL5OPT environment variable
7597
7598 =item Limitations on B<-M>, B<-m>, and B<-T> options
7599
7600 =item More precise warnings
7601
7602 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
7603
7604 =item Previously deprecated %OVERLOAD is no longer usable
7605
7606 =item Subroutine arguments created only when they're modified
7607
7608 =item Group vector changeable with C<$)>
7609
7610 =item Fixed parsing of $$<digit>, &$<digit>, etc.
7611
7612 =item Fixed localization of $<digit>, $&, etc.
7613
7614 =item No resetting of $. on implicit close
7615
7616 =item C<wantarray> may return undef
7617
7618 =item C<eval EXPR> determines value of EXPR in scalar context
7619
7620 =item Changes to tainting checks
7621
7622 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
7623 spawning if tainted $TERM doesn't look like a terminal name
7624
7625 =item New Opcode module and revised Safe module
7626
7627 =item Embedding improvements
7628
7629 =item Internal change: FileHandle class based on IO::* classes
7630
7631 =item Internal change: PerlIO abstraction interface
7632
7633 =item New and changed syntax
7634
7635 $coderef->(PARAMS)
7636
7637 =item New and changed builtin constants
7638
7639 __PACKAGE__
7640
7641 =item New and changed builtin variables
7642
7643 $^E, $^H, $^M
7644
7645 =item New and changed builtin functions
7646
7647 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
7648 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
7649 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
7650 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
7651 nested C<sub{}> closures work now, formats work right on changing lexicals
7652
7653 =item New builtin methods
7654
7655 isa(CLASS), can(METHOD), VERSION( [NEED] )
7656
7657 =item TIEHANDLE now supported
7658
7659 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
7660 LIST, READLINE this, GETC this, DESTROY this
7661
7662 =item Malloc enhancements
7663
7664 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
7665
7666 =item Miscellaneous efficiency enhancements
7667
7668 =back
7669
7670 =item Support for More Operating Systems
7671
7672 =over 4
7673
7674 =item Win32
7675
7676 =item Plan 9
7677
7678 =item QNX
7679
7680 =item AmigaOS
7681
7682 =back
7683
7684 =item Pragmata
7685
7686 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
7687 constant NAME => VALUE, use locale, use ops, use vmsish
7688
7689 =item Modules
7690
7691 =over 4
7692
7693 =item Required Updates
7694
7695 =item Installation directories
7696
7697 =item Module information summary
7698
7699 =item Fcntl
7700
7701 =item IO
7702
7703 =item Math::Complex
7704
7705 =item Math::Trig
7706
7707 =item DB_File
7708
7709 =item Net::Ping
7710
7711 =item Object-oriented overrides for builtin operators
7712
7713 =back
7714
7715 =item Utility Changes
7716
7717 =over 4
7718
7719 =item pod2html
7720
7721 Sends converted HTML to standard output
7722
7723 =item xsubpp
7724
7725 C<void> XSUBs now default to returning nothing
7726
7727 =back
7728
7729 =item C Language API Changes
7730
7731 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
7732 manipulating hashes
7733
7734 =item Documentation Changes
7735
7736 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
7737 L<perlmodlib>, L<perldebug>, L<perlsec>
7738
7739 =item New Diagnostics
7740
7741 "my" variable %s masks earlier declaration in same scope, %s argument is
7742 not a HASH element or slice, Allocation too large: %lx, Allocation too
7743 large, Applying %s to %s will act on scalar(%s), Attempt to free
7744 nonexistent shared string, Attempt to use reference as lvalue in substr,
7745 Bareword "%s" refers to nonexistent package, Can't redefine active sort
7746 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
7747 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
7748 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
7749 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
7750 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
7751 %s, Integer overflow in hex number, Integer overflow in octal number,
7752 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
7753 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
7754 possible typo, Null picture in formline, Offset outside string, Out of
7755 memory!, Out of memory during request for %s, panic: frexp, Possible
7756 attempt to put comments in qw() list, Possible attempt to separate words
7757 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
7758 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
7759 option, untie attempted while %d inner references still exist, Unrecognized
7760 character %s, Unsupported function fork, Use of "$$<digit>" to mean
7761 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
7762 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
7763 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
7764 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
7765 long, Process terminated by SIG%s
7766
7767 =item BUGS
7768
7769 =item SEE ALSO
7770
7771 =item HISTORY
7772
7773 =back
7774
7775 =head2 perlartistic - the Perl Artistic License
7776
7777 =over 4
7778
7779 =item SYNOPSIS
7780
7781 =item DESCRIPTION
7782
7783 =item The "Artistic License"
7784
7785 =over 4
7786
7787 =item Preamble
7788
7789 =item Definitions
7790
7791 "Package", "Standard Version", "Copyright Holder", "You", "Reasonable
7792 copying fee", "Freely Available"
7793
7794 =item Conditions
7795
7796 a), b), c), d), a), b), c), d)
7797
7798 =back
7799
7800 =back
7801
7802 =head2 perlgpl - the GNU General Public License, version 2
7803
7804 =over 4
7805
7806 =item SYNOPSIS
7807
7808 =back
7809
7810 =over 4
7811
7812 =item DESCRIPTION
7813
7814 =item GNU GENERAL PUBLIC LICENSE
7815
7816 =back
7817
7818 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
7819
7820 =over 4
7821
7822 =item DESCRIPTION
7823
7824 =over 4
7825
7826 =item Compiling Perl 5 on AIX
7827
7828 =item OS level
7829
7830 =item Building Dynamic Extensions on AIX
7831
7832 =item The IBM ANSI C Compiler
7833
7834 =item The usenm option
7835
7836 =item Using GNU's gcc for building perl
7837
7838 =item Using Large Files with Perl
7839
7840 =item Threaded Perl
7841
7842 =item 64-bit Perl
7843
7844 =item AIX 4.2 and extensions using C++ with statics
7845
7846 =back
7847
7848 =item AUTHOR
7849
7850 =item DATE
7851
7852 =back
7853
7854 =head2 perlamiga - Perl under Amiga OS
7855
7856 =over 4
7857
7858 =item NOTE
7859
7860 =item SYNOPSIS
7861
7862 =back
7863
7864 =over 4
7865
7866 =item DESCRIPTION
7867
7868 =over 4
7869
7870 =item Prerequisites for Compiling Perl on AmigaOS
7871
7872 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
7873
7874 =item Starting Perl programs under AmigaOS
7875
7876 =item Shortcomings of Perl under AmigaOS
7877
7878 =back
7879
7880 =item INSTALLATION
7881
7882 =item Accessing documentation
7883
7884 =over 4
7885
7886 =item Manpages for Perl on AmigaOS
7887
7888 =item Perl HTML Documentation on AmigaOS
7889
7890 =item Perl GNU Info Files on AmigaOS
7891
7892 =item Perl LaTeX Documentation on AmigaOS
7893
7894 =back
7895
7896 =item BUILDING PERL ON AMIGAOS
7897
7898 =over 4
7899
7900 =item Build Prerequisites for Perl on AmigaOS
7901
7902 =item Getting the Perl Source for AmigaOS
7903
7904 =item Making Perl on AmigaOS
7905
7906 =item Testing Perl on AmigaOS
7907
7908 =item Installing the built Perl on AmigaOS
7909
7910 =back
7911
7912 =item PERL 5.8.0 BROKEN IN AMIGAOS
7913
7914 =item AUTHORS
7915
7916 =item SEE ALSO
7917
7918 =back
7919
7920 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
7921
7922 =over 4
7923
7924 =item DESCRIPTION
7925
7926 =item AUTHOR
7927
7928 =back
7929
7930 =head2 perlbeos, README.beos - Perl version 5 on BeOS
7931
7932 =over 4
7933
7934 =item DESCRIPTION
7935
7936 =over 4
7937
7938 =item General Issues with Perl on BeOS
7939
7940 =item BeOS Release-specific Notes
7941
7942 R4 x86, R4 PPC
7943
7944 =item Contact Information
7945
7946 =item Update 2002-05-30
7947
7948 =back
7949
7950 =back
7951
7952 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
7953
7954 =over 4
7955
7956 =item SYNOPSIS
7957
7958 =item DESCRIPTION
7959
7960 =over 4
7961
7962 =item gzip on BS2000
7963
7964 =item bison on BS2000
7965
7966 =item Unpacking Perl Distribution on BS2000
7967
7968 =item Compiling Perl on BS2000
7969
7970 =item Testing Perl on BS2000
7971
7972 =item Installing Perl on BS2000
7973
7974 =item Using Perl in the Posix-Shell of BS2000
7975
7976 =item Using Perl in "native" BS2000
7977
7978 =item Floating point anomalies on BS2000
7979
7980 =item Using PerlIO and different encodings on ASCII and EBCDIC partitions
7981
7982 =back
7983
7984 =item AUTHORS
7985
7986 =item SEE ALSO
7987
7988 =over 4
7989
7990 =item Mailing list
7991
7992 =back
7993
7994 =item HISTORY
7995
7996 =back
7997
7998 =head2 perlce - Perl for WinCE
7999
8000 =over 4
8001
8002 =item DESCRIPTION
8003
8004 =item BUILD
8005
8006 =over 4
8007
8008 =item Tools & SDK
8009
8010 Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's
8011 celib-sources, Rainer Keuchel's console-sources
8012
8013 =item Make
8014
8015 go to ./wince subdirectory, edit file compile.bat, run    compile.bat, run 
8016   compile.bat dist
8017
8018 =back
8019
8020 =item ACKNOWLEDGEMENTS
8021
8022 =item AUTHORS
8023
8024 =back
8025
8026 =head2 perlcygwin, README.cygwin - Perl for Cygwin
8027
8028 =over 4
8029
8030 =item SYNOPSIS
8031
8032 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
8033
8034 =over 4
8035
8036 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
8037
8038 =item Cygwin Configuration
8039
8040 C<PATH>, I<nroff>, Permissions
8041
8042 =back
8043
8044 =item CONFIGURE PERL ON CYGWIN
8045
8046 =over 4
8047
8048 =item Stripping Perl Binaries on Cygwin
8049
8050 =item Optional Libraries for Perl on Cygwin
8051
8052 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
8053 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
8054
8055 =item Configure-time Options for Perl on Cygwin
8056
8057 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
8058 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
8059 C<-Dmksymlinks>
8060
8061 =item Suspicious Warnings on Cygwin
8062
8063 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
8064
8065 =back
8066
8067 =item MAKE ON CYGWIN
8068
8069 =over 4
8070
8071 =item Errors on Cygwin
8072
8073 =item ld2 on Cygwin
8074
8075 =back
8076
8077 =item TEST ON CYGWIN
8078
8079 =over 4
8080
8081 =item File Permissions on Cygwin
8082
8083 =item NDBM_File and ODBM_File do not work on FAT filesystems
8084
8085 =item C<fork()> failures in io_* tests
8086
8087 =item Script Portability on Cygwin
8088
8089 Pathnames, Text/Binary, PerlIO, F<.exe>, C<chown()>, Miscellaneous
8090
8091 =back
8092
8093 =item INSTALL PERL ON CYGWIN
8094
8095 =item MANIFEST ON CYGWIN
8096
8097 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
8098 Source, Compiled Module Source, Perl Modules/Scripts
8099
8100 =item BUGS ON CYGWIN
8101
8102 =item AUTHORS
8103
8104 =item HISTORY
8105
8106 =back
8107
8108 =head2 perldgux - Perl under DG/UX.
8109
8110 =over 4
8111
8112 =item SYNOPSIS
8113
8114 =back
8115
8116 =over 4
8117
8118 =item DESCRIPTION
8119
8120 =item BUILDING PERL ON DG/UX
8121
8122 =over 4
8123
8124 =item Non-threaded Perl on DG/UX
8125
8126 =item Threaded Perl on DG/UX
8127
8128 =item Testing Perl on DG/UX
8129
8130 =item Installing the built perl on DG/UX
8131
8132 =back
8133
8134 =item AUTHOR
8135
8136 =item SEE ALSO
8137
8138 =back
8139
8140 =head2 perldos - Perl under DOS, W31, W95.
8141
8142 =over 4
8143
8144 =item SYNOPSIS
8145
8146 =item DESCRIPTION
8147
8148 =over 4
8149
8150 =item Prerequisites for Compiling Perl on DOS
8151
8152 DJGPP, Pthreads
8153
8154 =item Shortcomings of Perl under DOS
8155
8156 =item Building Perl on DOS
8157
8158 =item Testing Perl on DOS
8159
8160 =item Installation of Perl on DOS
8161
8162 =back
8163
8164 =item BUILDING AND INSTALLING MODULES ON DOS
8165
8166 =over 4
8167
8168 =item Building Prerequisites for Perl on DOS
8169
8170 =item Unpacking CPAN Modules on DOS
8171
8172 =item Building Non-XS Modules on DOS
8173
8174 =item Building XS Modules on DOS
8175
8176 =back
8177
8178 =item AUTHOR
8179
8180 =item SEE ALSO
8181
8182 =back
8183
8184 =head2 perlepoc, README.epoc - Perl for EPOC
8185
8186 =over 4
8187
8188 =item SYNOPSIS
8189
8190 =item INTRODUCTION
8191
8192 =item INSTALLING PERL ON EPOC
8193
8194 =item STARTING PERL ON EPOC
8195
8196 =over 4
8197
8198 =item Editors on Epoc
8199
8200 =item Features of Perl on Epoc
8201
8202 =item Restrictions of Perl on Epoc
8203
8204 =item Compiling Perl 5 on the EPOC cross compiling environment
8205
8206 =back
8207
8208 =item SUPPORT STATUS OF PERL ON EPOC
8209
8210 =item AUTHOR
8211
8212 =item LAST UPDATE
8213
8214 =back
8215
8216 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
8217
8218 =over 4
8219
8220 =item DESCRIPTION
8221
8222 =over 4
8223
8224 =item FreeBSD core dumps from readdir_r with ithreads
8225
8226 =item $^X doesn't always contain a full path in FreeBSD
8227
8228 =item Perl will no longer be part of "base FreeBSD"
8229
8230 =back
8231
8232 =item AUTHOR
8233
8234 =back
8235
8236 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
8237 (HP-UX) systems
8238
8239 =over 4
8240
8241 =item DESCRIPTION
8242
8243 =over 4
8244
8245 =item Using perl as shipped with HP-UX
8246
8247 =item Using perl from HP's porting centre
8248
8249 =item Compiling Perl 5 on HP-UX
8250
8251 =item PA-RISC
8252
8253 =item Portability Between PA-RISC Versions
8254
8255 =item PA-RISC 1.0
8256
8257 =item PA-RISC 1.1
8258
8259 =item PA-RISC 2.0
8260
8261 =item Itanium Processor Family and HP-UX
8262
8263 =item Itanium & Itanium 2
8264
8265 =item Building Dynamic Extensions on HP-UX
8266
8267 =item The HP ANSI C Compiler
8268
8269 =item The GNU C Compiler
8270
8271 =item Using Large Files with Perl on HP-UX
8272
8273 =item Threaded Perl on HP-UX
8274
8275 =item 64-bit Perl on HP-UX
8276
8277 =item Oracle on HP-UX
8278
8279 =item GDBM and Threads on HP-UX
8280
8281 =item NFS filesystems and utime(2) on HP-UX
8282
8283 =item perl -P and // and HP-UX
8284
8285 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
8286
8287 =back
8288
8289 =item nss_delete core dump from op/pwent or op/grent
8290
8291 =item AUTHOR
8292
8293 =item DATE
8294
8295 =back
8296
8297 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
8298
8299 =over 4
8300
8301 =item DESCRIPTION
8302
8303 =over 4
8304
8305 =item Known Problems with Perl on Hurd 
8306
8307 =back
8308
8309 =item AUTHOR
8310
8311 =back
8312
8313 =head2 perlirix, README.irix - Perl version 5 on Irix systems
8314
8315 =over 4
8316
8317 =item DESCRIPTION
8318
8319 =over 4
8320
8321 =item Building 32-bit Perl in Irix
8322
8323 =item Building 64-bit Perl in Irix
8324
8325 =item About Compiler Versions of Irix
8326
8327 =item Linker Problems in Irix
8328
8329 =item Malloc in Irix
8330
8331 =item Building with threads in Irix
8332
8333 =item Irix 5.3
8334
8335 =back
8336
8337 =item AUTHOR
8338
8339 =back
8340
8341 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
8342 systems
8343
8344 =over 4
8345
8346 =item DESCRIPTION
8347
8348 =over 4
8349
8350 =item Perl version 5.8.x and greater not supported
8351
8352 =item Compiling Perl 5.6.x on MachTen
8353
8354 =item Failures during C<make test> on MachTen
8355
8356 op/lexassign.t, pragma/warnings.t
8357
8358 =item Building external modules on MachTen
8359
8360 =back
8361
8362 =item AUTHOR
8363
8364 =item DATE
8365
8366 =back
8367
8368 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
8369
8370 =over 4
8371
8372 =item SYNOPSIS
8373
8374 =item DESCRIPTION
8375
8376 =item AUTHOR
8377
8378 =item DATE
8379
8380 =back
8381
8382 =head2 perlmacosx, README.macosx - Perl under Mac OS X
8383
8384 =over 4
8385
8386 =item SYNOPSIS
8387
8388 =item DESCRIPTION
8389
8390 =over 4
8391
8392 =item Installation Prefix
8393
8394 =item libperl and Prebinding
8395
8396 =item Updating Panther
8397
8398 =item Known problems
8399
8400 =item MacPerl
8401
8402 =item Carbon
8403
8404 =item Cocoa
8405
8406 =back
8407
8408 =item Starting From Scratch
8409
8410 =item AUTHOR
8411
8412 =item DATE
8413
8414 =back
8415
8416 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
8417
8418 =over 4
8419
8420 =item DESCRIPTION
8421
8422 =item Known problems with Perl on MiNT
8423
8424 =item AUTHOR
8425
8426 =back
8427
8428 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
8429
8430 =over 4
8431
8432 =item SYNOPSIS
8433
8434 =item NOTE
8435
8436 =item Binary distribution from HP
8437
8438 =item What's New in Perl for MPE/iX
8439
8440 =item Welcome to Perl/iX
8441
8442 =item System Requirements for Perl/iX
8443
8444 =item How to Obtain Perl/iX
8445
8446 =item Perl/iX Distribution Contents Highlights
8447
8448 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
8449 public_html/feedback.cgi, src/perl-5.6.0-mpe
8450
8451 =item How to Compile Perl/iX
8452
8453  4,  6
8454
8455 =item Getting Started with Perl/iX
8456
8457 =item MPE/iX Implementation Considerations
8458
8459 =item Known Perl/iX Bugs Under Investigation
8460
8461 =item Perl/iX To-Do List
8462
8463 =item Perl/iX Change History
8464
8465 =item AUTHOR
8466
8467 =back
8468
8469 =head2 perlnetware - Perl for NetWare
8470
8471 =over 4
8472
8473 =item DESCRIPTION
8474
8475 =item BUILD
8476
8477 =over 4
8478
8479 =item Tools & SDK
8480
8481 =item Setup
8482
8483 SetNWBld.bat, Buildtype.bat
8484
8485 =item Make
8486
8487 =item Interpreter
8488
8489 =item Extensions
8490
8491 =back
8492
8493 =item INSTALL
8494
8495 =item BUILD NEW EXTENSIONS
8496
8497 =item ACKNOWLEDGEMENTS
8498
8499 =item AUTHORS
8500
8501 =item DATE
8502
8503 =back
8504
8505 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
8506
8507 =over 4
8508
8509 =item SYNOPSIS
8510
8511 =back
8512
8513 =over 4
8514
8515 =item DESCRIPTION
8516
8517 =over 4
8518
8519 =item Target
8520
8521 =item Other OSes
8522
8523 =item Prerequisites
8524
8525 EMX, RSX, HPFS, pdksh
8526
8527 =item Starting Perl programs under OS/2 (and DOS and...)
8528
8529 =item Starting OS/2 (and DOS) programs under Perl
8530
8531 =back
8532
8533 =item Frequently asked questions
8534
8535 =over 4
8536
8537 =item "It does not work"
8538
8539 =item I cannot run external programs
8540
8541 =item I cannot embed perl into my program, or use F<perl.dll> from my
8542 program. 
8543
8544 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
8545 L<ExtUtils::Embed>?
8546
8547 =item C<``> and pipe-C<open> do not work under DOS.
8548
8549 =item Cannot start C<find.exe "pattern" file>
8550
8551 =back
8552
8553 =item INSTALLATION
8554
8555 =over 4
8556
8557 =item Automatic binary installation
8558
8559 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
8560
8561 =item Manual binary installation
8562
8563 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
8564 (statically linked), Executables for Perl utilities, Main Perl library,
8565 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
8566 and utilities, Manpages for Perl modules, Source for Perl documentation,
8567 Perl manual in F<.INF> format, Pdksh
8568
8569 =item B<Warning>
8570
8571 =back
8572
8573 =item Accessing documentation
8574
8575 =over 4
8576
8577 =item OS/2 F<.INF> file
8578
8579 =item Plain text
8580
8581 =item Manpages
8582
8583 =item HTML
8584
8585 =item GNU C<info> files
8586
8587 =item F<PDF> files
8588
8589 =item C<LaTeX> docs
8590
8591 =back
8592
8593 =item BUILD
8594
8595 =over 4
8596
8597 =item The short story
8598
8599 =item Prerequisites
8600
8601 =item Getting perl source
8602
8603 =item Application of the patches
8604
8605 =item Hand-editing
8606
8607 =item Making
8608
8609 =item Testing
8610
8611 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
8612 F<op/stat.t>
8613
8614 =item Installing the built perl
8615
8616 =item C<a.out>-style build
8617
8618 =back
8619
8620 =item Building a binary distribution
8621
8622 =item Building custom F<.EXE> files
8623
8624 =over 4
8625
8626 =item Making executables with a custom collection of statically loaded
8627 extensions
8628
8629 =item Making executables with a custom search-paths
8630
8631 =back
8632
8633 =item Build FAQ
8634
8635 =over 4
8636
8637 =item Some C</> became C<\> in pdksh.
8638
8639 =item C<'errno'> - unresolved external
8640
8641 =item Problems with tr or sed
8642
8643 =item Some problem (forget which ;-)
8644
8645 =item Library ... not found
8646
8647 =item Segfault in make
8648
8649 =item op/sprintf test failure
8650
8651 =back
8652
8653 =item Specific (mis)features of OS/2 port
8654
8655 =over 4
8656
8657 =item C<setpriority>, C<getpriority>
8658
8659 =item C<system()>
8660
8661 =item C<extproc> on the first line
8662
8663 =item Additional modules:
8664
8665 =item Prebuilt methods:
8666
8667 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
8668  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>, 
8669 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>, 
8670 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>, 
8671 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>, 
8672 C<Cwd::extLibpath_set( path [, type ] )>,
8673 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
8674 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
8675 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
8676 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
8677 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
8678 C<OS2::DLLname([how [, \&xsub]])>
8679
8680 =item Prebuilt variables:
8681
8682 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
8683 $OS2::nsyserror
8684
8685 =item Misfeatures
8686
8687 =item Modifications
8688
8689 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
8690 C<flock>
8691
8692 =item Identifying DLLs
8693
8694 =item Centralized management of resources
8695
8696 C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
8697 C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
8698 C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
8699 C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
8700
8701 =back
8702
8703 =item Perl flavors
8704
8705 =over 4
8706
8707 =item F<perl.exe>
8708
8709 =item F<perl_.exe>
8710
8711 =item F<perl__.exe>
8712
8713 =item F<perl___.exe>
8714
8715 =item Why strange names?
8716
8717 =item Why dynamic linking?
8718
8719 =item Why chimera build?
8720
8721 =back
8722
8723 =item ENVIRONMENT
8724
8725 =over 4
8726
8727 =item C<PERLLIB_PREFIX>
8728
8729 =item C<PERL_BADLANG>
8730
8731 =item C<PERL_BADFREE>
8732
8733 =item C<PERL_SH_DIR>
8734
8735 =item C<USE_PERL_FLOCK>
8736
8737 =item C<TMP> or C<TEMP>
8738
8739 =back
8740
8741 =item Evolution
8742
8743 =over 4
8744
8745 =item Text-mode filehandles
8746
8747 =item Priorities
8748
8749 =item DLL name mangling: pre 5.6.2
8750
8751 =item DLL name mangling: 5.6.2 and beyond
8752
8753 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
8754 C<LIBPATH>
8755
8756 =item DLL forwarder generation
8757
8758 =item Threading
8759
8760 =item Calls to external programs
8761
8762 =item Memory allocation
8763
8764 =item Threads
8765
8766 C<COND_WAIT>, F<os2.c>
8767
8768 =back
8769
8770 =item BUGS
8771
8772 =back
8773
8774 =over 4
8775
8776 =item AUTHOR
8777
8778 =item SEE ALSO
8779
8780 =back
8781
8782 =head2 perlos390, README.os390 - building and installing Perl for OS/390
8783 and z/OS
8784
8785 =over 4
8786
8787 =item SYNOPSIS
8788
8789 =item DESCRIPTION
8790
8791 =over 4
8792
8793 =item Tools
8794
8795 =item Unpacking Perl distribution on OS/390
8796
8797 =item Setup and utilities for Perl on OS/390
8798
8799 =item Configure Perl on OS/390
8800
8801 =item Build, Test, Install Perl on OS/390
8802
8803 =item Build Anomalies with Perl on OS/390
8804
8805 =item Testing Anomalies with Perl on OS/390
8806
8807 =item Installation Anomalies with Perl on OS/390
8808
8809 =item Usage Hints for Perl on OS/390
8810
8811 =item Floating Point Anomalies with Perl on OS/390
8812
8813 =item Modules and Extensions for Perl on OS/390
8814
8815 =back
8816
8817 =item AUTHORS
8818
8819 =item SEE ALSO
8820
8821 =over 4
8822
8823 =item Mailing list for Perl on OS/390
8824
8825 =back
8826
8827 =item HISTORY
8828
8829 =back
8830
8831 =head2 perlos400, README.os400 - Perl version 5 on OS/400
8832
8833 =over 4
8834
8835 =item DESCRIPTION
8836
8837 =over 4
8838
8839 =item Compiling Perl for OS/400 PASE
8840
8841 =item Installing Perl in OS/400 PASE
8842
8843 =item Using Perl in OS/400 PASE
8844
8845 =item Known Problems
8846
8847 =item Perl on ILE
8848
8849 =back
8850
8851 =item AUTHORS
8852
8853 =back
8854
8855 =head2 perlplan9 - Plan 9-specific documentation for Perl
8856
8857 =over 4
8858
8859 =item DESCRIPTION
8860
8861 =over 4
8862
8863 =item Invoking Perl
8864
8865 =item What's in Plan 9 Perl
8866
8867 =item What's not in Plan 9 Perl
8868
8869 =item Perl5 Functions not currently supported in Plan 9 Perl
8870
8871 =item Signals in Plan 9 Perl
8872
8873 =back
8874
8875 =item COMPILING AND INSTALLING PERL ON PLAN 9
8876
8877 =over 4
8878
8879 =item Installing Perl Documentation on Plan 9
8880
8881 =back
8882
8883 =item BUGS
8884
8885 =item Revision date
8886
8887 =item AUTHOR
8888
8889 =back
8890
8891 =head2 perlqnx, README.qnx - Perl version 5 on QNX
8892
8893 =over 4
8894
8895 =item DESCRIPTION
8896
8897 =over 4
8898
8899 =item Required Software for Compiling Perl on QNX4
8900
8901 /bin/sh, ar, nm, cpp, make
8902
8903 =item Outstanding Issues with Perl on QNX4
8904
8905 =item QNX auxiliary files
8906
8907 qnx/ar, qnx/cpp
8908
8909 =item Outstanding issues with perl under QNX6
8910
8911 =back
8912
8913 =item AUTHOR
8914
8915 =back
8916
8917 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
8918
8919 =over 4
8920
8921 =item DESCRIPTION
8922
8923 =over 4
8924
8925 =item Solaris Version Numbers.
8926
8927 =back
8928
8929 =item RESOURCES
8930
8931 Solaris FAQ, Precompiled Binaries, Solaris Documentation
8932
8933 =item SETTING UP
8934
8935 =over 4
8936
8937 =item File Extraction Problems on Solaris.
8938
8939 =item Compiler and Related Tools on Solaris.
8940
8941 =item Environment for Compiling perl on Solaris
8942
8943 =back
8944
8945 =item RUN CONFIGURE.
8946
8947 =over 4
8948
8949 =item 64-bit perl on Solaris.
8950
8951 =item Threads in perl on Solaris.
8952
8953 =item Malloc Issues with perl on Solaris.
8954
8955 =back
8956
8957 =item MAKE PROBLEMS.
8958
8959 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
8960 relocation error:, dlopen: stub interception failed, #error "No
8961 DATAMODEL_NATIVE specified", sh: ar: not found
8962
8963 =item MAKE TEST
8964
8965 =over 4
8966
8967 =item op/stat.t test 4 in Solaris
8968
8969 =item nss_delete core dump from op/pwent or op/grent
8970
8971 =back
8972
8973 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
8974
8975 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
8976
8977 =over 4
8978
8979 =item Limits on Numbers of Open Files on Solaris.
8980
8981 =back
8982
8983 =item SOLARIS-SPECIFIC MODULES.
8984
8985 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
8986
8987 =over 4
8988
8989 =item Proc::ProcessTable on Solaris
8990
8991 =item BSD::Resource on Solaris
8992
8993 =item Net::SSLeay on Solaris
8994
8995 =back
8996
8997 =item SunOS 4.x
8998
8999 =item AUTHOR
9000
9001 =item LAST MODIFIED
9002
9003 =back
9004
9005 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
9006 Digital UNIX formerly known as DEC OSF/1) systems
9007
9008 =over 4
9009
9010 =item DESCRIPTION
9011
9012 =over 4
9013
9014 =item Compiling Perl 5 on Tru64
9015
9016 =item Using Large Files with Perl on Tru64
9017
9018 =item Threaded Perl on Tru64
9019
9020 =item Long Doubles on Tru64
9021
9022 =item DB_File tests failing on Tru64
9023
9024 =item 64-bit Perl on Tru64
9025
9026 =item Warnings about floating-point overflow when compiling Perl on Tru64
9027
9028 =back
9029
9030 =item Testing Perl on Tru64
9031
9032 =item ext/ODBM_File/odbm Test Failing With Static Builds
9033
9034 =item Perl Fails Because Of Unresolved Symbol sockatmark
9035
9036 =item AUTHOR
9037
9038 =back
9039
9040 =head2 perluts - Perl under UTS
9041
9042 =over 4
9043
9044 =item SYNOPSIS
9045
9046 =item DESCRIPTION
9047
9048 =item BUILDING PERL ON UTS
9049
9050 =item Installing the built perl on UTS
9051
9052 =item AUTHOR
9053
9054 =back
9055
9056 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
9057
9058 =over 4
9059
9060 =item SYNOPSIS
9061
9062 =item DESCRIPTION
9063
9064 =over 4
9065
9066 =item Unpacking Perl Distribution on VM/ESA
9067
9068 =item Setup Perl and utilities on VM/ESA
9069
9070 =item Configure Perl on VM/ESA
9071
9072 =item Testing Anomalies of Perl on VM/ESA
9073
9074 =item Usage Hints for Perl on VM/ESA
9075
9076 =back
9077
9078 =item AUTHORS
9079
9080 =item SEE ALSO
9081
9082 =over 4
9083
9084 =item Mailing list for Perl on VM/ESA
9085
9086 =back
9087
9088 =back
9089
9090 =head2 perlvms - VMS-specific documentation for Perl
9091
9092 =over 4
9093
9094 =item DESCRIPTION
9095
9096 =item Installation
9097
9098 =item Organization of Perl Images
9099
9100 =over 4
9101
9102 =item Core Images
9103
9104 =item Perl Extensions
9105
9106 =item Installing static extensions
9107
9108 =item Installing dynamic extensions
9109
9110 =back
9111
9112 =item File specifications
9113
9114 =over 4
9115
9116 =item Syntax
9117
9118 =item Wildcard expansion
9119
9120 =item Pipes
9121
9122 =back
9123
9124 =item PERL5LIB and PERLLIB
9125
9126 =item Command line
9127
9128 =over 4
9129
9130 =item I/O redirection and backgrounding
9131
9132 =item Command line switches
9133
9134 -i, -S, -u
9135
9136 =back
9137
9138 =item Perl functions
9139
9140 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
9141 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
9142 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
9143 LIST, waitpid PID,FLAGS
9144
9145 =item Perl variables
9146
9147 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
9148
9149 =item Standard modules with VMS-specific differences
9150
9151 =over 4
9152
9153 =item SDBM_File
9154
9155 =back
9156
9157 =item Revision date
9158
9159 =item AUTHOR
9160
9161 =back
9162
9163 =head2 perlvos, README.vos - Perl for Stratus VOS
9164
9165 =over 4
9166
9167 =item SYNOPSIS
9168
9169 =item BUILDING PERL FOR VOS
9170
9171 =item INSTALLING PERL IN VOS
9172
9173 =item USING PERL IN VOS
9174
9175 =over 4
9176
9177 =item Restrictions of Perl on VOS
9178
9179 =item Handling of underflow and overflow
9180
9181 =back
9182
9183 =item TEST STATUS
9184
9185 =item SUPPORT STATUS
9186
9187 =item AUTHOR
9188
9189 =item LAST UPDATE
9190
9191 =back
9192
9193 =head2 perlwin32 - Perl under Windows
9194
9195 =over 4
9196
9197 =item SYNOPSIS
9198
9199 =item DESCRIPTION
9200
9201 =over 4
9202
9203 =item Setting Up Perl on Win32
9204
9205 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Visual
9206 C++ Toolkit 2003, Microsoft Platform SDK 64-bit Compiler, MinGW release 3
9207 with gcc, MinGW release 1 with gcc
9208
9209 =item Building
9210
9211 =item Testing Perl on Win32
9212
9213 =item Installation of Perl on Win32
9214
9215 =item Usage Hints for Perl on Win32
9216
9217 Environment Variables, File Globbing, Using perl from the command line,
9218 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
9219 Extensions, Notes on 64-bit Windows
9220
9221 =item Running Perl Scripts
9222
9223 =item Miscellaneous Things
9224
9225 =back
9226
9227 =item BUGS AND CAVEATS
9228
9229 =item ACKNOWLEDGEMENTS
9230
9231 =item AUTHORS
9232
9233 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
9234 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
9235 E<lt>nick@ing-simmons.netE<gt>
9236
9237 =item SEE ALSO
9238
9239 =item HISTORY
9240
9241 =back
9242
9243 =head1 PRAGMA DOCUMENTATION
9244
9245 =head2 attrs - set/get attributes of a subroutine (deprecated)
9246
9247 =over 4
9248
9249 =item SYNOPSIS
9250
9251 =item DESCRIPTION
9252
9253 method, locked
9254
9255 =back
9256
9257 =head2 re - Perl pragma to alter regular expression behaviour
9258
9259 =over 4
9260
9261 =item SYNOPSIS
9262
9263 =item DESCRIPTION
9264
9265 =back
9266
9267 =head2 threadshared::shared, threads::shared - Perl extension for sharing
9268 data structures between threads
9269
9270 =over 4
9271
9272 =item SYNOPSIS
9273
9274 =item DESCRIPTION
9275
9276 =item EXPORT
9277
9278 =item FUNCTIONS
9279
9280 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
9281 LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
9282 ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
9283
9284 =item NOTES
9285
9286 =item BUGS
9287
9288 =item AUTHOR
9289
9290 =item SEE ALSO
9291
9292 =back
9293
9294 =head2 threads - Perl extension allowing use of interpreter based threads
9295 from perl
9296
9297 =over 4
9298
9299 =item SYNOPSIS
9300
9301 =item DESCRIPTION
9302
9303 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
9304 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
9305 threads->list();, async BLOCK;
9306
9307 =item WARNINGS
9308
9309 A thread exited while %d other threads were still running
9310
9311 =item TODO
9312
9313 =item BUGS
9314
9315 Parent-Child threads, Returning objects, Creating threads inside BEGIN
9316 blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
9317
9318 =item AUTHOR and COPYRIGHT
9319
9320 =item SEE ALSO
9321
9322 =back
9323
9324 =head2 assertions - select assertions in blocks of code
9325
9326 =over 4
9327
9328 =item SYNOPSIS
9329
9330 =item DESCRIPTION
9331
9332 =item SEE ALSO
9333
9334 =item AUTHOR
9335
9336 =item COPYRIGHT AND LICENSE
9337
9338 =back
9339
9340 =head2 assertions::activate - activate assertions
9341
9342 =over 4
9343
9344 =item SYNOPSIS
9345
9346 =item DESCRIPTION
9347
9348 =item SEE ALSO
9349
9350 =item AUTHOR
9351
9352 =item COPYRIGHT AND LICENSE
9353
9354 =back
9355
9356 =head2 attributes - get/set subroutine or variable attributes
9357
9358 =over 4
9359
9360 =item SYNOPSIS
9361
9362 =item DESCRIPTION
9363
9364 =over 4
9365
9366 =item Built-in Attributes
9367
9368 locked, method, lvalue
9369
9370 =item Available Subroutines
9371
9372 get, reftype
9373
9374 =item Package-specific Attribute Handling
9375
9376 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
9377
9378 =item Syntax of Attribute Lists
9379
9380 =back
9381
9382 =item EXPORTS
9383
9384 =over 4
9385
9386 =item Default exports
9387
9388 =item Available exports
9389
9390 =item Export tags defined
9391
9392 =back
9393
9394 =item EXAMPLES
9395
9396 =item SEE ALSO
9397
9398 =back
9399
9400 =head2 autouse - postpone load of modules until a function is used
9401
9402 =over 4
9403
9404 =item SYNOPSIS
9405
9406 =item DESCRIPTION
9407
9408 =item WARNING
9409
9410 =item AUTHOR
9411
9412 =item SEE ALSO
9413
9414 =back
9415
9416 =head2 base - Establish IS-A relationship with base classes at compile time
9417
9418 =over 4
9419
9420 =item SYNOPSIS
9421
9422 =item DESCRIPTION
9423
9424 =item DIAGNOSTICS
9425
9426 Base class package "%s" is empty
9427
9428 =item HISTORY
9429
9430 =item CAVEATS
9431
9432 =item SEE ALSO
9433
9434 =back
9435
9436 =head2 bigint - Transparent BigInteger support for Perl
9437
9438 =over 4
9439
9440 =item SYNOPSIS
9441
9442 =item DESCRIPTION
9443
9444 =over 4
9445
9446 =item OPTIONS
9447
9448 a or accuracy, p or precision, t or trace, l or lib, v or version
9449
9450 =item MATH LIBRARY
9451
9452 =item INTERNAL FORMAT
9453
9454 =item SIGN
9455
9456 =item METHODS
9457
9458 =item CAVEAT
9459
9460 =back
9461
9462 =item MODULES USED
9463
9464 =item EXAMPLES
9465
9466 =item LICENSE
9467
9468 =item SEE ALSO
9469
9470 =item AUTHORS
9471
9472 =back
9473
9474 =head2 bignum - Transparent BigNumber support for Perl
9475
9476 =over 4
9477
9478 =item SYNOPSIS
9479
9480 =item DESCRIPTION
9481
9482 =over 4
9483
9484 =item OPTIONS
9485
9486 a or accuracy, p or precision, t or trace, l or lib, v or version
9487
9488 =item METHODS
9489
9490 =item CAVEAT
9491
9492 inf(), NaN(), upgrade()
9493
9494 =item MATH LIBRARY
9495
9496 =item INTERNAL FORMAT
9497
9498 =item SIGN
9499
9500 =back
9501
9502 =item MODULES USED
9503
9504 =item EXAMPLES
9505
9506 =item LICENSE
9507
9508 =item SEE ALSO
9509
9510 =item AUTHORS
9511
9512 =back
9513
9514 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
9515
9516 =over 4
9517
9518 =item SYNOPSIS
9519
9520 =item DESCRIPTION
9521
9522 =over 4
9523
9524 =item MODULES USED
9525
9526 =item MATH LIBRARY
9527
9528 =item SIGN
9529
9530 =item METHODS
9531
9532 =item CAVEAT
9533
9534 =back
9535
9536 =item EXAMPLES
9537
9538         perl -Mbigrat -le 'print sqrt(33)'
9539         perl -Mbigrat -le 'print 2*255'
9540         perl -Mbigrat -le 'print 4.5+2*255'
9541         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'       
9542         perl -Mbigrat -le 'print 12->is_odd()';
9543
9544 =item LICENSE
9545
9546 =item SEE ALSO
9547
9548 =item AUTHORS
9549
9550 =back
9551
9552 =head2 blib - Use MakeMaker's uninstalled version of a package
9553
9554 =over 4
9555
9556 =item SYNOPSIS
9557
9558 =item DESCRIPTION
9559
9560 =item BUGS
9561
9562 =item AUTHOR
9563
9564 =back
9565
9566 =head2 bytes - Perl pragma to force byte semantics rather than character
9567 semantics
9568
9569 =over 4
9570
9571 =item SYNOPSIS
9572
9573 =item DESCRIPTION
9574
9575 =item LIMITATIONS
9576
9577 =item SEE ALSO
9578
9579 =back
9580
9581 =head2 charnames - define character names for C<\N{named}> string literal
9582 escapes
9583
9584 =over 4
9585
9586 =item SYNOPSIS
9587
9588 =item DESCRIPTION
9589
9590 =item CUSTOM TRANSLATORS
9591
9592 =item CUSTOM ALIASES
9593
9594 =over 4
9595
9596 =item Anonymous hashes
9597
9598 =item Alias file
9599
9600 =item Alias shortcut
9601
9602 =back
9603
9604 =item charnames::viacode(code)
9605
9606 =item charnames::vianame(name)
9607
9608 =item ALIASES
9609
9610 =item ILLEGAL CHARACTERS
9611
9612 =item BUGS
9613
9614 =back
9615
9616 =head2 constant - Perl pragma to declare constants
9617
9618 =over 4
9619
9620 =item SYNOPSIS
9621
9622 =item DESCRIPTION
9623
9624 =item NOTES
9625
9626 =over 4
9627
9628 =item List constants
9629
9630 =item Defining multiple constants at once
9631
9632 =item Magic constants
9633
9634 =back
9635
9636 =item TECHNICAL NOTES
9637
9638 =item BUGS
9639
9640 =item AUTHOR
9641
9642 =item COPYRIGHT
9643
9644 =back
9645
9646 =head2 diagnostics, splain - produce verbose warning diagnostics
9647
9648 =over 4
9649
9650 =item SYNOPSIS
9651
9652 =item DESCRIPTION
9653
9654 =over 4
9655
9656 =item The C<diagnostics> Pragma
9657
9658 =item The I<splain> Program
9659
9660 =back
9661
9662 =item EXAMPLES
9663
9664 =item INTERNALS
9665
9666 =item BUGS
9667
9668 =item AUTHOR
9669
9670 =back
9671
9672 =head2 encoding - allows you to write your script in non-ascii or non-utf8
9673
9674 =over 4
9675
9676 =item SYNOPSIS
9677
9678 =item ABSTRACT
9679
9680 =over 4
9681
9682 =item Literal Conversions
9683
9684 =item PerlIO layers for C<STD(IN|OUT)>
9685
9686 =item Implicit upgrading for byte strings
9687
9688 =back
9689
9690 =item FEATURES THAT REQUIRE 5.8.1
9691
9692 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
9693
9694 =item USAGE
9695
9696 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
9697 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
9698
9699 =item The Filter Option
9700
9701 =over 4
9702
9703 =item Filter-related changes at Encode version 1.87
9704
9705 =back
9706
9707 =item CAVEATS
9708
9709 =over 4
9710
9711 =item NOT SCOPED
9712
9713 =item DO NOT MIX MULTIPLE ENCODINGS
9714
9715 =item tr/// with ranges
9716
9717 Legend of characters above
9718
9719 =back
9720
9721 =item EXAMPLE - Greekperl
9722
9723 =item KNOWN PROBLEMS
9724
9725 literals in regex that are longer than 127 bytes, EBCDIC, format
9726
9727 =over 4
9728
9729 =item The Logic of :locale
9730
9731 =back
9732
9733 =item HISTORY
9734
9735 =item SEE ALSO
9736
9737 =back
9738
9739 =head2 fields - compile-time class fields
9740
9741 =over 4
9742
9743 =item SYNOPSIS
9744
9745 =item DESCRIPTION
9746
9747 new, phash
9748
9749 =item SEE ALSO
9750
9751 =back
9752
9753 =head2 filetest - Perl pragma to control the filetest permission operators
9754
9755 =over 4
9756
9757 =item SYNOPSIS
9758
9759 =item DESCRIPTION
9760
9761 =over 4
9762
9763 =item subpragma access
9764
9765 =back
9766
9767 =back
9768
9769 =head2 if - C<use> a Perl module if a condition holds
9770
9771 =over 4
9772
9773 =item SYNOPSIS
9774
9775 =item DESCRIPTION
9776
9777 =item BUGS
9778
9779 =item AUTHOR
9780
9781 =back
9782
9783 =head2 integer - Perl pragma to use integer arithmetic instead of floating
9784 point
9785
9786 =over 4
9787
9788 =item SYNOPSIS
9789
9790 =item DESCRIPTION
9791
9792 =back
9793
9794 =head2 less - perl pragma to request less of something from the compiler
9795
9796 =over 4
9797
9798 =item SYNOPSIS
9799
9800 =item DESCRIPTION
9801
9802 =back
9803
9804 =head2 lib - manipulate @INC at compile time
9805
9806 =over 4
9807
9808 =item SYNOPSIS
9809
9810 =item DESCRIPTION
9811
9812 =over 4
9813
9814 =item Adding directories to @INC
9815
9816 =item Deleting directories from @INC
9817
9818 =item Restoring original @INC
9819
9820 =back
9821
9822 =item CAVEATS
9823
9824 =item NOTES
9825
9826 =item SEE ALSO
9827
9828 =item AUTHOR
9829
9830 =back
9831
9832 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
9833 operations
9834
9835 =over 4
9836
9837 =item SYNOPSIS
9838
9839 =item DESCRIPTION
9840
9841 =back
9842
9843 =head2 open - perl pragma to set default PerlIO layers for input and output
9844
9845 =over 4
9846
9847 =item SYNOPSIS
9848
9849 =item DESCRIPTION
9850
9851 =item NONPERLIO FUNCTIONALITY
9852
9853 =item IMPLEMENTATION DETAILS
9854
9855 =item SEE ALSO
9856
9857 =back
9858
9859 =head2 ops - Perl pragma to restrict unsafe operations when compiling
9860
9861 =over 4
9862
9863 =item SYNOPSIS  
9864
9865 =item DESCRIPTION
9866
9867 =item SEE ALSO
9868
9869 =back
9870
9871 =head2 overload - Package for overloading perl operations
9872
9873 =over 4
9874
9875 =item SYNOPSIS
9876
9877 =item DESCRIPTION
9878
9879 =over 4
9880
9881 =item Declaration of overloaded functions
9882
9883 =item Calling Conventions for Binary Operations
9884
9885 FALSE, TRUE, C<undef>
9886
9887 =item Calling Conventions for Unary Operations
9888
9889 =item Calling Conventions for Mutators
9890
9891 C<++> and C<-->, C<x=> and other assignment versions
9892
9893 =item Overloadable Operations
9894
9895 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
9896 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
9897 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
9898
9899 =item Inheritance and overloading
9900
9901 Strings as values of C<use overload> directive, Overloading of an operation
9902 is inherited by derived classes
9903
9904 =back
9905
9906 =item SPECIAL SYMBOLS FOR C<use overload>
9907
9908 =over 4
9909
9910 =item Last Resort
9911
9912 =item Fallback
9913
9914 C<undef>, TRUE, defined, but FALSE
9915
9916 =item Copy Constructor
9917
9918 B<Example>
9919
9920 =back
9921
9922 =item MAGIC AUTOGENERATION
9923
9924 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
9925 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
9926 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
9927 I<Copy operator>
9928
9929 =item Losing overloading
9930
9931 =item Run-time Overloading
9932
9933 =item Public functions
9934
9935 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
9936
9937 =item Overloading constants
9938
9939 integer, float, binary, q, qr
9940
9941 =item IMPLEMENTATION
9942
9943 =item Metaphor clash
9944
9945 =item Cookbook
9946
9947 =over 4
9948
9949 =item Two-face scalars
9950
9951 =item Two-face references
9952
9953 =item Symbolic calculator
9954
9955 =item I<Really> symbolic calculator
9956
9957 =back
9958
9959 =item AUTHOR
9960
9961 =item DIAGNOSTICS
9962
9963 Odd number of arguments for overload::constant, `%s' is not an overloadable
9964 type, `%s' is not a code reference
9965
9966 =item BUGS
9967
9968 =back
9969
9970 =head2 sigtrap - Perl pragma to enable simple signal handling
9971
9972 =over 4
9973
9974 =item SYNOPSIS
9975
9976 =item DESCRIPTION
9977
9978 =item OPTIONS
9979
9980 =over 4
9981
9982 =item SIGNAL HANDLERS
9983
9984 B<stack-trace>, B<die>, B<handler> I<your-handler>
9985
9986 =item SIGNAL LISTS
9987
9988 B<normal-signals>, B<error-signals>, B<old-interface-signals>
9989
9990 =item OTHER
9991
9992 B<untrapped>, B<any>, I<signal>, I<number>
9993
9994 =back
9995
9996 =item EXAMPLES
9997
9998 =back
9999
10000 =head2 sort - perl pragma to control sort() behaviour
10001
10002 =over 4
10003
10004 =item SYNOPSIS
10005
10006 =item DESCRIPTION
10007
10008 =item CAVEATS
10009
10010 =back
10011
10012 =head2 strict - Perl pragma to restrict unsafe constructs
10013
10014 =over 4
10015
10016 =item SYNOPSIS
10017
10018 =item DESCRIPTION
10019
10020 C<strict refs>, C<strict vars>, C<strict subs>
10021
10022 =item HISTORY
10023
10024 =back
10025
10026 =head2 subs - Perl pragma to predeclare sub names
10027
10028 =over 4
10029
10030 =item SYNOPSIS
10031
10032 =item DESCRIPTION
10033
10034 =back
10035
10036 =head2 threadshared, threads::shared - Perl extension for sharing data
10037 structures between threads
10038
10039 =over 4
10040
10041 =item SYNOPSIS
10042
10043 =item DESCRIPTION
10044
10045 =item EXPORT
10046
10047 =item FUNCTIONS
10048
10049 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_wait CONDVAR,
10050 LOCKVAR, cond_timedwait VARIABLE, ABS_TIMEOUT, cond_timedwait CONDVAR,
10051 ABS_TIMEOUT, LOCKVAR, cond_signal VARIABLE, cond_broadcast VARIABLE
10052
10053 =item NOTES
10054
10055 =item BUGS
10056
10057 =item AUTHOR
10058
10059 =item SEE ALSO
10060
10061 =back
10062
10063 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
10064 code
10065
10066 =over 4
10067
10068 =item SYNOPSIS
10069
10070 =item DESCRIPTION
10071
10072 =over 4
10073
10074 =item Utility functions
10075
10076 $num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[,
10077 FAIL_OK]), utf8::encode($string), utf8::decode($string), $flag =
10078 utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
10079
10080 =back
10081
10082 =item BUGS
10083
10084 =item SEE ALSO
10085
10086 =back
10087
10088 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
10089
10090 =over 4
10091
10092 =item SYNOPSIS
10093
10094 =item DESCRIPTION
10095
10096 =back
10097
10098 =head2 version - Perl extension for Version Objects
10099
10100 =over 4
10101
10102 =item SYNOPSIS
10103
10104 =item DESCRIPTION
10105
10106 =over 4
10107
10108 =item What IS a version
10109
10110 Numeric Versions, Quoted Versions
10111
10112 =item What about v-strings?
10113
10114 =item Numeric Versions
10115
10116 =item Quoted Versions
10117
10118 =item Object Methods
10119
10120 New Operator, qv(), Normal Form, Numification, Stringification, Comparison
10121 operators, Logical Operators
10122
10123 =item Quoting
10124
10125 =item Types of Versions Objects
10126
10127 Ordinary versions, Alpha versions
10128
10129 =item Replacement UNIVERSAL::VERSION
10130
10131 =back
10132
10133 =item EXPORT
10134
10135 =item AUTHOR
10136
10137 =item SEE ALSO
10138
10139 =back
10140
10141 =head2 vmsish - Perl pragma to control VMS-specific language features
10142
10143 =over 4
10144
10145 =item SYNOPSIS
10146
10147 =item DESCRIPTION
10148
10149 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
10150
10151 =back
10152
10153 =head2 warnings - Perl pragma to control optional warnings
10154
10155 =over 4
10156
10157 =item SYNOPSIS
10158
10159 =item DESCRIPTION
10160
10161 use warnings::register, warnings::enabled(), warnings::enabled($category),
10162 warnings::enabled($object), warnings::warn($message),
10163 warnings::warn($category, $message), warnings::warn($object, $message),
10164 warnings::warnif($message), warnings::warnif($category, $message),
10165 warnings::warnif($object, $message)
10166
10167 =back
10168
10169 =head2 warnings::register - warnings import function
10170
10171 =over 4
10172
10173 =item SYNOPSIS
10174
10175 =item DESCRIPTION
10176
10177 =back
10178
10179 =head1 MODULE DOCUMENTATION
10180
10181 =head2 AnyDBM_File - provide framework for multiple DBMs
10182
10183 =over 4
10184
10185 =item SYNOPSIS
10186
10187 =item DESCRIPTION
10188
10189 =over 4
10190
10191 =item DBM Comparisons
10192
10193 [0], [1], [2], [3]
10194
10195 =back
10196
10197 =item SEE ALSO
10198
10199 =back
10200
10201 =head2 Attribute::Handlers - Simpler definition of attribute handlers
10202
10203 =over 4
10204
10205 =item VERSION
10206
10207 =item SYNOPSIS
10208
10209 =item DESCRIPTION
10210
10211 [0], [1], [2], [3], [4], [5]
10212
10213 =over 4
10214
10215 =item Typed lexicals
10216
10217 =item Type-specific attribute handlers
10218
10219 =item Non-interpretive attribute handlers
10220
10221 =item Phase-specific attribute handlers
10222
10223 =item Attributes as C<tie> interfaces
10224
10225 =back
10226
10227 =item EXAMPLES
10228
10229 =item DIAGNOSTICS
10230
10231 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
10232 attributes>, C<Declaration of %s attribute in package %s may clash with
10233 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
10234 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
10235 be able to apply END handler>
10236
10237 =item AUTHOR
10238
10239 =item BUGS
10240
10241 =item COPYRIGHT
10242
10243 =back
10244
10245 =head2 AutoLoader - load subroutines only on demand
10246
10247 =over 4
10248
10249 =item SYNOPSIS
10250
10251 =item DESCRIPTION
10252
10253 =over 4
10254
10255 =item Subroutine Stubs
10256
10257 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
10258
10259 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
10260
10261 =item Package Lexicals
10262
10263 =item Not Using AutoLoader
10264
10265 =item B<AutoLoader> vs. B<SelfLoader>
10266
10267 =back
10268
10269 =item CAVEATS
10270
10271 =item SEE ALSO
10272
10273 =back
10274
10275 =head2 AutoSplit - split a package for autoloading
10276
10277 =over 4
10278
10279 =item SYNOPSIS
10280
10281 =item DESCRIPTION
10282
10283 $keep, $check, $modtime
10284
10285 =over 4
10286
10287 =item Multiple packages
10288
10289 =back
10290
10291 =item DIAGNOSTICS
10292
10293 =back
10294
10295 =head2 B - The Perl Compiler
10296
10297 =over 4
10298
10299 =item SYNOPSIS
10300
10301 =item DESCRIPTION
10302
10303 =item OVERVIEW
10304
10305 =item Utility Functions
10306
10307 =over 4
10308
10309 =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV>
10310 objects
10311
10312 sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av,
10313 check_av, begin_av, end_av, comppadlist, regex_padav, main_cv
10314
10315 =item Functions for Examining the Symbol Table
10316
10317 walksymtable(SYMREF, METHOD, RECURSE, PREFIX)
10318
10319 =item Functions Returning C<B::OP> objects or for walking op trees
10320
10321 main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG)
10322
10323 =item Miscellaneous Utility Functions
10324
10325 ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR),
10326 perlstring(STR), class(OBJ), threadsv_names
10327
10328 =back
10329
10330 =item OVERVIEW OF CLASSES
10331
10332 =over 4
10333
10334 =item SV-RELATED CLASSES
10335
10336 =item B::SV Methods
10337
10338 REFCNT, FLAGS, object_2svref
10339
10340 =item B::IV Methods
10341
10342 IV, IVX, UVX, int_value, needs64bits, packiv
10343
10344 =item B::NV Methods
10345
10346 NV, NVX
10347
10348 =item B::RV Methods
10349
10350 RV
10351
10352 =item B::PV Methods
10353
10354 PV, RV, PVX
10355
10356 =item B::PVMG Methods
10357
10358 MAGIC, SvSTASH
10359
10360 =item B::MAGIC Methods
10361
10362 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
10363
10364 =item B::PVLV Methods
10365
10366 TARGOFF, TARGLEN, TYPE, TARG
10367
10368 =item B::BM Methods
10369
10370 USEFUL, PREVIOUS, RARE, TABLE
10371
10372 =item B::GV Methods
10373
10374 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
10375 LINE, FILE, FILEGV, GvREFCNT, FLAGS
10376
10377 =item B::IO Methods
10378
10379 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
10380 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
10381
10382 =item B::AV Methods
10383
10384 FILL, MAX, OFF, ARRAY, ARRAYelt, AvFLAGS
10385
10386 =item B::CV Methods
10387
10388 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB,
10389 XSUBANY, CvFLAGS, const_sv
10390
10391 =item B::HV Methods
10392
10393 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
10394
10395 =item OP-RELATED CLASSES
10396
10397 =item B::OP Methods
10398
10399 next, sibling, name, ppaddr, desc, targ, type, opt, static, flags, private,
10400 spare
10401
10402 =item B::UNOP METHOD
10403
10404 first
10405
10406 =item B::BINOP METHOD
10407
10408 last
10409
10410 =item B::LOGOP METHOD
10411
10412 other
10413
10414 =item B::LISTOP METHOD
10415
10416 children
10417
10418 =item B::PMOP Methods
10419
10420 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
10421 pmpermflags, precomp, pmoffset
10422
10423 =item B::SVOP METHOD
10424
10425 sv, gv
10426
10427 =item B::PADOP METHOD
10428
10429 padix
10430
10431 =item B::PVOP METHOD
10432
10433 pv
10434
10435 =item B::LOOP Methods
10436
10437 redoop, nextop, lastop
10438
10439 =item B::COP Methods
10440
10441 label, stash, stashpv, file, cop_seq, arybase, line, warnings, io
10442
10443 =back
10444
10445 =item AUTHOR
10446
10447 =back
10448
10449 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
10450 bytecode
10451
10452 =over 4
10453
10454 =item SYNOPSIS
10455
10456 =item DESCRIPTION
10457
10458 %insn_data, @insn_name, @optype, @specialsv_name
10459
10460 =item AUTHOR
10461
10462 =back
10463
10464 =head2 B::Assembler - Assemble Perl bytecode
10465
10466 =over 4
10467
10468 =item SYNOPSIS
10469
10470 =item DESCRIPTION
10471
10472 =item AUTHORS
10473
10474 =back
10475
10476 =head2 B::Bblock - Walk basic blocks
10477
10478 =over 4
10479
10480 =item SYNOPSIS
10481
10482 =item DESCRIPTION
10483
10484 =over 4
10485
10486 =item Functions
10487
10488 B<find_leaders>
10489
10490 =back
10491
10492 =item AUTHOR
10493
10494 =back
10495
10496 =head2 B::Bytecode - Perl compiler's bytecode backend
10497
10498 =over 4
10499
10500 =item SYNOPSIS
10501
10502 =item DESCRIPTION
10503
10504 =item EXAMPLE
10505
10506 =item OPTIONS
10507
10508 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
10509
10510 =item KNOWN BUGS
10511
10512 =item NOTICE
10513
10514 =item AUTHORS
10515
10516 =back
10517
10518 =head2 B::C - Perl compiler's C backend
10519
10520 =over 4
10521
10522 =item SYNOPSIS
10523
10524 =item DESCRIPTION
10525
10526 =item OPTIONS
10527
10528 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
10529 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
10530 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
10531 B<-llimit>
10532
10533 =item EXAMPLES
10534
10535 =item BUGS
10536
10537 =item AUTHOR
10538
10539 =back
10540
10541 =head2 B::CC - Perl compiler's optimized C translation backend
10542
10543 =over 4
10544
10545 =item SYNOPSIS
10546
10547 =item DESCRIPTION
10548
10549 =item OPTIONS
10550
10551 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
10552 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
10553 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
10554
10555 =item EXAMPLES
10556
10557 =item BUGS
10558
10559 =item DIFFERENCES
10560
10561 =over 4
10562
10563 =item Loops
10564
10565 =item Context of ".."
10566
10567 =item Arithmetic
10568
10569 =item Deprecated features
10570
10571 =back
10572
10573 =item AUTHOR
10574
10575 =back
10576
10577 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
10578
10579 =over 4
10580
10581 =item SYNOPSIS
10582
10583 =item DESCRIPTION
10584
10585 =item EXAMPLE
10586
10587 =item OPTIONS
10588
10589 =over 4
10590
10591 =item Options for Opcode Ordering
10592
10593 B<-basic>, B<-exec>, B<-tree>
10594
10595 =item Options for Line-Style
10596
10597 B<-concise>, B<-terse>, B<-linenoise>, B<-debug>, B<-env>
10598
10599 =item Options for tree-specific formatting
10600
10601 B<-compact>, B<-loose>, B<-vt>, B<-ascii>
10602
10603 =item Options controlling sequence numbering
10604
10605 B<-base>I<n>, B<-bigendian>, B<-littleendian>
10606
10607 =item Other options
10608
10609 B<-main>, B<-nomain>, B<-nobanner>, B<-banner>, B<-banneris> => subref
10610
10611 =item Option Stickiness
10612
10613 =back
10614
10615 =item ABBREVIATIONS
10616
10617 =over 4
10618
10619 =item OP class abbreviations
10620
10621 =item OP flags abbreviations
10622
10623 =back
10624
10625 =item FORMATTING SPECIFICATIONS
10626
10627 =over 4
10628
10629 =item Special Patterns
10630
10631 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
10632 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
10633 B<~>
10634
10635 =item # Variables
10636
10637 B<#>I<var>, B<#>I<var>I<N>, B<#>I<Var>, B<#addr>, B<#arg>, B<#class>,
10638 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
10639 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
10640 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
10641 B<#seq>, B<#seqnum>, B<#opt>, B<#static>, B<#sibaddr>, B<#svaddr>,
10642 B<#svclass>, B<#svval>, B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
10643
10644 =back
10645
10646 =item Using B::Concise outside of the O framework
10647
10648 =over 4
10649
10650 =item Example: Altering Concise Renderings
10651
10652 =item set_style()
10653
10654 =item set_style_standard($name)
10655
10656 =item add_style()
10657
10658 =item add_callback()
10659
10660 =item Running B::Concise::compile()
10661
10662 =item B::Concise::reset_sequence()
10663
10664 =item Errors
10665
10666 =back
10667
10668 =item AUTHOR
10669
10670 =back
10671
10672 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
10673
10674 =over 4
10675
10676 =item SYNOPSIS
10677
10678 =item DESCRIPTION
10679
10680 =item AUTHOR
10681
10682 =back
10683
10684 =head2 B::Deparse - Perl compiler backend to produce perl code
10685
10686 =over 4
10687
10688 =item SYNOPSIS
10689
10690 =item DESCRIPTION
10691
10692 =item OPTIONS
10693
10694 B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>,
10695 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
10696
10697 =item USING B::Deparse AS A MODULE
10698
10699 =over 4
10700
10701 =item Synopsis
10702
10703 =item Description
10704
10705 =item new
10706
10707 =item ambient_pragmas
10708
10709 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
10710
10711 =item coderef2text
10712
10713 =back
10714
10715 =item BUGS
10716
10717 =item AUTHOR
10718
10719 =back
10720
10721 =head2 B::Disassembler - Disassemble Perl bytecode
10722
10723 =over 4
10724
10725 =item SYNOPSIS
10726
10727 =item DESCRIPTION
10728
10729 =item AUTHOR
10730
10731 =back
10732
10733 =head2 B::Lint - Perl lint
10734
10735 =over 4
10736
10737 =item SYNOPSIS
10738
10739 =item DESCRIPTION
10740
10741 =item OPTIONS AND LINT CHECKS
10742
10743 B<context>, B<implicit-read> and B<implicit-write>, B<bare-subs>,
10744 B<dollar-underscore>, B<private-names>, B<undefined-subs>,
10745 B<regexp-variables>, B<all>, B<none>
10746
10747 =item NON LINT-CHECK OPTIONS
10748
10749 B<-u Package>
10750
10751 =item BUGS
10752
10753 =item AUTHOR
10754
10755 =back
10756
10757 =head2 B::O, O - Generic interface to Perl Compiler backends
10758
10759 =over 4
10760
10761 =item SYNOPSIS
10762
10763 =item DESCRIPTION
10764
10765 =item CONVENTIONS
10766
10767 =item IMPLEMENTATION
10768
10769 =item BUGS
10770
10771 =item AUTHOR
10772
10773 =back
10774
10775 =head2 B::Showlex - Show lexical variables used in functions or files
10776
10777 =over 4
10778
10779 =item SYNOPSIS
10780
10781 =item DESCRIPTION
10782
10783 =item EXAMPLES
10784
10785 =over 4
10786
10787 =item OPTIONS
10788
10789 =back
10790
10791 =item SEE ALSO
10792
10793 =item TODO
10794
10795 =item AUTHOR
10796
10797 =back
10798
10799 =head2 B::Stackobj - Helper module for CC backend
10800
10801 =over 4
10802
10803 =item SYNOPSIS
10804
10805 =item DESCRIPTION
10806
10807 =item AUTHOR
10808
10809 =back
10810
10811 =head2 B::Stash - show what stashes are loaded
10812
10813 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
10814
10815 =over 4
10816
10817 =item SYNOPSIS
10818
10819 =item DESCRIPTION
10820
10821 =item AUTHOR
10822
10823 =back
10824
10825 =head2 B::Xref - Generates cross reference reports for Perl programs
10826
10827 =over 4
10828
10829 =item SYNOPSIS
10830
10831 =item DESCRIPTION
10832
10833 =item OPTIONS
10834
10835 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
10836
10837 =item BUGS
10838
10839 =item AUTHOR
10840
10841 =back
10842
10843 =head2 Bblock, B::Bblock - Walk basic blocks
10844
10845 =over 4
10846
10847 =item SYNOPSIS
10848
10849 =item DESCRIPTION
10850
10851 =over 4
10852
10853 =item Functions
10854
10855 B<find_leaders>
10856
10857 =back
10858
10859 =item AUTHOR
10860
10861 =back
10862
10863 =head2 Benchmark - benchmark running times of Perl code
10864
10865 =over 4
10866
10867 =item SYNOPSIS
10868
10869 =item DESCRIPTION
10870
10871 =over 4
10872
10873 =item Methods
10874
10875 new, debug, iters
10876
10877 =item Standard Exports
10878
10879 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
10880 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
10881 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
10882
10883 =item Optional Exports
10884
10885 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [
10886 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
10887 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
10888
10889 =item :hireswallclock
10890
10891 =back
10892
10893 =item NOTES
10894
10895 =item EXAMPLES
10896
10897 =item INHERITANCE
10898
10899 =item CAVEATS
10900
10901 =item SEE ALSO
10902
10903 =item AUTHORS
10904
10905 =item MODIFICATION HISTORY
10906
10907 =back
10908
10909 =head2 ByteLoader - load byte compiled perl code
10910
10911 =over 4
10912
10913 =item SYNOPSIS
10914
10915 =item DESCRIPTION
10916
10917 =item AUTHOR
10918
10919 =item SEE ALSO
10920
10921 =back
10922
10923 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
10924
10925 =over 4
10926
10927 =item SYNOPSIS
10928
10929 =item DESCRIPTION
10930
10931 =item EXAMPLE
10932
10933 =item OPTIONS
10934
10935 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
10936
10937 =item KNOWN BUGS
10938
10939 =item NOTICE
10940
10941 =item AUTHORS
10942
10943 =back
10944
10945 =head2 CGI - Simple Common Gateway Interface Class
10946
10947 =over 4
10948
10949 =item SYNOPSIS
10950
10951 =item ABSTRACT
10952
10953 =item DESCRIPTION
10954
10955 =over 4
10956
10957 =item PROGRAMMING STYLE
10958
10959 =item CALLING CGI.PM ROUTINES
10960
10961 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
10962
10963 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
10964
10965 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
10966
10967 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
10968
10969 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
10970
10971 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
10972
10973 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
10974
10975 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
10976
10977 =item DELETING A PARAMETER COMPLETELY:
10978
10979 =item DELETING ALL PARAMETERS:
10980
10981 =item DIRECT ACCESS TO THE PARAMETER LIST:
10982
10983 =item FETCHING THE PARAMETER LIST AS A HASH:
10984
10985 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
10986
10987 =item RETRIEVING CGI ERRORS
10988
10989 =item USING THE FUNCTION-ORIENTED INTERFACE
10990
10991 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
10992 B<:standard>, B<:all>
10993
10994 =item PRAGMAS
10995
10996 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
10997 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
10998 -private_tempfiles
10999
11000 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
11001
11002 1. start_table() (generates a <table> tag), 2. end_table() (generates a
11003 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
11004 a </ul> tag)
11005
11006 =back
11007
11008 =item GENERATING DYNAMIC DOCUMENTS
11009
11010 =over 4
11011
11012 =item CREATING A STANDARD HTTP HEADER:
11013
11014 =item GENERATING A REDIRECTION HEADER
11015
11016 =item CREATING THE HTML DOCUMENT HEADER
11017
11018 B<Parameters:>, 4, 5, 6..
11019
11020 =item ENDING THE HTML DOCUMENT:
11021
11022 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
11023
11024 =item OBTAINING THE SCRIPT'S URL
11025
11026 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
11027 (B<-query_string>), B<-base>
11028
11029 =item MIXING POST AND URL PARAMETERS
11030
11031 =back
11032
11033 =item CREATING STANDARD HTML ELEMENTS:
11034
11035 =over 4
11036
11037 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
11038
11039 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
11040
11041 =item HTML SHORTCUTS AND LIST INTERPOLATION
11042
11043 =item NON-STANDARD HTML SHORTCUTS
11044
11045 =item AUTOESCAPING HTML
11046
11047 $escaped_string = escapeHTML("unescaped string");, $charset =
11048 charset([$charset]);, $flag = autoEscape([$flag]);
11049
11050 =item PRETTY-PRINTING HTML
11051
11052 =back
11053
11054 =item CREATING FILL-OUT FORMS:
11055
11056 =over 4
11057
11058 =item CREATING AN ISINDEX TAG
11059
11060 =item STARTING AND ENDING A FORM
11061
11062 B<application/x-www-form-urlencoded>, B<multipart/form-data>
11063
11064 =item CREATING A TEXT FIELD
11065
11066 B<Parameters>
11067
11068 =item CREATING A BIG TEXT FIELD
11069
11070 =item CREATING A PASSWORD FIELD
11071
11072 =item CREATING A FILE UPLOAD FIELD
11073
11074 B<Parameters>
11075
11076 =item CREATING A POPUP MENU
11077
11078 =item CREATING AN OPTION GROUP
11079
11080 =item CREATING A SCROLLING LIST
11081
11082 B<Parameters:>
11083
11084 =item CREATING A GROUP OF RELATED CHECKBOXES
11085
11086 B<Parameters:>
11087
11088 =item CREATING A STANDALONE CHECKBOX
11089
11090 B<Parameters:>
11091
11092 =item CREATING A RADIO BUTTON GROUP
11093
11094 B<Parameters:>
11095
11096 =item CREATING A SUBMIT BUTTON 
11097
11098 B<Parameters:>
11099
11100 =item CREATING A RESET BUTTON
11101
11102 =item CREATING A DEFAULT BUTTON
11103
11104 =item CREATING A HIDDEN FIELD
11105
11106 B<Parameters:>
11107
11108 =item CREATING A CLICKABLE IMAGE BUTTON
11109
11110 B<Parameters:>, 3. The third option (-align, optional) is an alignment
11111 type, and may be TOP, BOTTOM or MIDDLE
11112
11113 =item CREATING A JAVASCRIPT ACTION BUTTON
11114
11115 =back
11116
11117 =item HTTP COOKIES
11118
11119 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
11120 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
11121
11122 =item WORKING WITH FRAMES
11123
11124 1. Create a <Frameset> document, 2. Specify the destination for the
11125 document in the HTTP header, 3. Specify the destination for the document in
11126 the <form> tag
11127
11128 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
11129
11130 =item DEBUGGING
11131
11132 =over 4
11133
11134 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
11135
11136 =back
11137
11138 =item FETCHING ENVIRONMENT VARIABLES
11139
11140 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
11141 B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
11142 name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
11143 ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
11144 B<virtual_port ()>, B<server_software ()>, B<remote_user ()>, B<user_name
11145 ()>, B<request_method()>, B<content_type()>, B<http()>, B<https()>
11146
11147 =item USING NPH SCRIPTS
11148
11149 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
11150 parameters
11151
11152 =item Server Push
11153
11154 multipart_init(), multipart_start(), multipart_end(), multipart_final()
11155
11156 =item Avoiding Denial of Service Attacks
11157
11158 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
11159 basis>, B<2. Globally for all scripts>
11160
11161 =item COMPATIBILITY WITH CGI-LIB.PL
11162
11163 =item AUTHOR INFORMATION
11164
11165 =item CREDITS
11166
11167 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
11168 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
11169 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
11170 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
11171 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
11172 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
11173 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
11174 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
11175 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
11176 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
11177 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
11178 ...and many many more..
11179
11180 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
11181
11182 =item BUGS
11183
11184 =item SEE ALSO
11185
11186 =back
11187
11188 =head2 CGI::Apache - Backward compatibility module for CGI.pm
11189
11190 =over 4
11191
11192 =item SYNOPSIS
11193
11194 =item ABSTRACT
11195
11196 =item DESCRIPTION
11197
11198 =item AUTHOR INFORMATION
11199
11200 =item BUGS
11201
11202 =item SEE ALSO
11203
11204 =back
11205
11206 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
11207 other) error log
11208
11209 =over 4
11210
11211 =item SYNOPSIS
11212
11213 =item DESCRIPTION
11214
11215 =item REDIRECTING ERROR MESSAGES
11216
11217 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
11218
11219 =over 4
11220
11221 =item Changing the default message
11222
11223 =back
11224
11225 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
11226
11227 =item OVERRIDING THE NAME OF THE PROGRAM
11228
11229 =item AUTHORS
11230
11231 =item SEE ALSO
11232
11233 =back
11234
11235 =head2 CGI::Cookie - Interface to Netscape Cookies
11236
11237 =over 4
11238
11239 =item SYNOPSIS
11240
11241 =item DESCRIPTION
11242
11243 =item USING CGI::Cookie
11244
11245 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
11246
11247 =over 4
11248
11249 =item Creating New Cookies
11250
11251 =item Sending the Cookie to the Browser
11252
11253 =item Recovering Previous Cookies
11254
11255 =item Manipulating Cookies
11256
11257 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
11258
11259 =back
11260
11261 =item AUTHOR INFORMATION
11262
11263 =item BUGS
11264
11265 =item SEE ALSO
11266
11267 =back
11268
11269 =head2 CGI::Fast - CGI Interface for Fast CGI
11270
11271 =over 4
11272
11273 =item SYNOPSIS
11274
11275 =item DESCRIPTION
11276
11277 =item OTHER PIECES OF THE PUZZLE
11278
11279 =item WRITING FASTCGI PERL SCRIPTS
11280
11281 =item INSTALLING FASTCGI SCRIPTS
11282
11283 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
11284
11285 =item EXTERNAL FASTCGI SERVER INVOCATION
11286
11287 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
11288
11289 =item CAVEATS
11290
11291 =item AUTHOR INFORMATION
11292
11293 =item BUGS
11294
11295 =item SEE ALSO
11296
11297 =back
11298
11299 =head2 CGI::Pretty - module to produce nicely formatted HTML code
11300
11301 =over 4
11302
11303 =item SYNOPSIS
11304
11305 =item DESCRIPTION
11306
11307 =over 4
11308
11309 =item Tags that won't be formatted
11310
11311 =item Customizing the Indenting
11312
11313 =back
11314
11315 =item BUGS
11316
11317 =item AUTHOR
11318
11319 =item SEE ALSO
11320
11321 =back
11322
11323 =head2 CGI::Push - Simple Interface to Server Push
11324
11325 =over 4
11326
11327 =item SYNOPSIS
11328
11329 =item DESCRIPTION
11330
11331 =item USING CGI::Push
11332
11333 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
11334
11335 =over 4
11336
11337 =item Heterogeneous Pages
11338
11339 =item Changing the Page Delay on the Fly
11340
11341 =back
11342
11343 =item INSTALLING CGI::Push SCRIPTS
11344
11345 =item AUTHOR INFORMATION
11346
11347 =item BUGS
11348
11349 =item SEE ALSO
11350
11351 =back
11352
11353 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
11354
11355 =over 4
11356
11357 =item SYNOPSIS
11358
11359 =item ABSTRACT
11360
11361 =item DESCRIPTION
11362
11363 =item AUTHOR INFORMATION
11364
11365 =item BUGS
11366
11367 =item SEE ALSO
11368
11369 =back
11370
11371 =head2 CGI::Util - Internal utilities used by CGI module
11372
11373 =over 4
11374
11375 =item SYNOPSIS
11376
11377 =item DESCRIPTION
11378
11379 =item AUTHOR INFORMATION
11380
11381 =item SEE ALSO
11382
11383 =back
11384
11385 =head2 CPAN - query, download and build perl modules from CPAN sites
11386
11387 =over 4
11388
11389 =item SYNOPSIS
11390
11391 =item STATUS
11392
11393 =item DESCRIPTION
11394
11395 =over 4
11396
11397 =item Interactive Mode
11398
11399 Searching for authors, bundles, distribution files and modules, make, test,
11400 install, clean  modules or distributions, get, readme, look module or
11401 distribution, ls author, Signals
11402
11403 =item CPAN::Shell
11404
11405 =item autobundle
11406
11407 =item recompile
11408
11409 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
11410
11411 =item Programmer's interface
11412
11413 expand($type,@things), expandany(@things), Programming Examples
11414
11415 =item Methods in the other Classes
11416
11417 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
11418 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
11419 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
11420 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
11421 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
11422 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
11423 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
11424 CPAN::Bundle::readme(), CPAN::Bundle::test(),
11425 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
11426 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
11427 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
11428 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
11429 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
11430 CPAN::Distribution::look(), CPAN::Distribution::make(),
11431 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
11432 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
11433 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
11434 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
11435 CPAN::Module::clean(), CPAN::Module::cpan_file(),
11436 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
11437 CPAN::Module::description(), CPAN::Module::force($method,@args),
11438 CPAN::Module::get(), CPAN::Module::inst_file(),
11439 CPAN::Module::inst_version(), CPAN::Module::install(),
11440 CPAN::Module::look(), CPAN::Module::make(),
11441 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
11442 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
11443
11444 =item Cache Manager
11445
11446 =item Bundles
11447
11448 =item Prerequisites
11449
11450 =item Finding packages and VERSION
11451
11452 =item Debugging
11453
11454 =item Floppy, Zip, Offline Mode
11455
11456 =back
11457
11458 =item CONFIGURATION
11459
11460 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
11461 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
11462 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
11463 [unshift|push|splice] E<lt>listE<gt>>
11464
11465 =over 4
11466
11467 =item Note on urllist parameter's format
11468
11469 =item urllist parameter has CD-ROM support
11470
11471 =back
11472
11473 =item SECURITY
11474
11475 =item EXPORT
11476
11477 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
11478
11479 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
11480
11481 =over 4
11482
11483 =item Three basic types of firewalls
11484
11485 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
11486
11487 =item Configuring lynx or ncftp for going through a firewall
11488
11489 =back
11490
11491 =item FAQ
11492
11493 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
11494
11495 =item BUGS
11496
11497 =item AUTHOR
11498
11499 =item TRANSLATIONS
11500
11501 =item SEE ALSO
11502
11503 =back
11504
11505 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
11506
11507 =over 4
11508
11509 =item SYNOPSIS
11510
11511 =item DESCRIPTION
11512
11513 =back
11514
11515 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
11516 module
11517
11518 =over 4
11519
11520 =item SYNOPSIS
11521
11522 =item DESCRIPTION
11523
11524 =item  SEE ALSO
11525
11526 =back
11527
11528 =head2 Carp, carp    - warn of errors (from perspective of caller)
11529
11530 =over 4
11531
11532 =item SYNOPSIS
11533
11534 =item DESCRIPTION
11535
11536 =over 4
11537
11538 =item Forcing a Stack Trace
11539
11540 =back
11541
11542 =back
11543
11544 =over 4
11545
11546 =item GLOBAL VARIABLES
11547
11548 =over 4
11549
11550 =item $Carp::CarpLevel
11551
11552 =item $Carp::MaxEvalLen
11553
11554 =item $Carp::MaxArgLen
11555
11556 =item $Carp::MaxArgNums
11557
11558 =item $Carp::Verbose
11559
11560 =back
11561
11562 =back
11563
11564 =over 4
11565
11566 =item BUGS
11567
11568 =back
11569
11570 =head2 Carp::Heavy - heavy machinery, no user serviceable parts inside
11571
11572 =head2 Class::ISA -- report the search path for a class's ISA tree
11573
11574 =over 4
11575
11576 =item SYNOPSIS
11577
11578 =item DESCRIPTION
11579
11580 =item FUNCTIONS
11581
11582 the function Class::ISA::super_path($CLASS), the function
11583 Class::ISA::self_and_super_path($CLASS), the function
11584 Class::ISA::self_and_super_versions($CLASS)
11585
11586 =item CAUTIONARY NOTES
11587
11588 =item COPYRIGHT
11589
11590 =item AUTHOR
11591
11592 =back
11593
11594 =head2 Class::Struct - declare struct-like datatypes as Perl classes
11595
11596 =over 4
11597
11598 =item SYNOPSIS
11599
11600 =item DESCRIPTION
11601
11602 =over 4
11603
11604 =item The C<struct()> function
11605
11606 =item Class Creation at Compile Time
11607
11608 =item Element Types and Accessor Methods
11609
11610 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
11611 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
11612
11613 =item Initializing with C<new>
11614
11615 =back
11616
11617 =item EXAMPLES
11618
11619 Example 1, Example 2, Example 3
11620
11621 =item Author and Modification History
11622
11623 =back
11624
11625 =head2 Config - access Perl configuration information
11626
11627 =over 4
11628
11629 =item SYNOPSIS
11630
11631 =item DESCRIPTION
11632
11633 myconfig(), config_sh(), config_re($regex), config_vars(@names)
11634
11635 =item EXAMPLE
11636
11637 =item WARNING
11638
11639 =item GLOSSARY
11640
11641 =over 4
11642
11643 =item _
11644
11645 C<_a>, C<_exe>, C<_o>
11646
11647 =item a
11648
11649 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
11650 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
11651 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
11652 C<asctime_r_proto>, C<awk>
11653
11654 =item b
11655
11656 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
11657
11658 =item c
11659
11660 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
11661 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
11662 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
11663 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
11664 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
11665 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
11666 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
11667
11668 =item d
11669
11670 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>,
11671 C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>,
11672 C<d_bcmp>, C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>,
11673 C<d_bzero>, C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>,
11674 C<d_chroot>, C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>,
11675 C<d_const>, C<d_copysignl>, C<d_crypt>, C<d_crypt_r>, C<d_csh>,
11676 C<d_ctermid_r>, C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>,
11677 C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>, C<d_dirnamlen>, C<d_dlerror>,
11678 C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, C<d_drand48_r>, C<d_drand48proto>,
11679 C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endgrent_r>, C<d_endhent>,
11680 C<d_endhostent_r>, C<d_endnent>, C<d_endnetent_r>, C<d_endpent>,
11681 C<d_endprotoent_r>, C<d_endpwent>, C<d_endpwent_r>, C<d_endsent>,
11682 C<d_endservent_r>, C<d_eofnblk>, C<d_eunice>, C<d_faststdio>, C<d_fchdir>,
11683 C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>,
11684 C<d_fd_set>, C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>,
11685 C<d_flexfnam>, C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>,
11686 C<d_fpathconf>, C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>,
11687 C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>,
11688 C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>, C<d_ftime>,
11689 C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>,
11690 C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>,
11691 C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
11692 C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>,
11693 C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>,
11694 C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>,
11695 C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>,
11696 C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
11697 C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
11698 C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>,
11699 C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
11700 C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>,
11701 C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>,
11702 C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>,
11703 C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
11704 C<d_htonl>, C<d_ilogbl>, C<d_index>, C<d_inetaton>, C<d_int64_t>,
11705 C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>,
11706 C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>,
11707 C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>,
11708 C<d_lstat>, C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>,
11709 C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>,
11710 C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>,
11711 C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>,
11712 C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>,
11713 C<d_msg_peek>, C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>,
11714 C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>,
11715 C<d_nice>, C<d_nl_langinfo>, C<d_nv_preserves_uv>, C<d_off64_t>,
11716 C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
11717 C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
11718 C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
11719 C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
11720 C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>,
11721 C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, C<d_pthread_atfork>,
11722 C<d_pthread_attr_setscope>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
11723 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
11724 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
11725 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
11726 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
11727 C<d_sanemcmp>, C<d_sbrkproto>, C<d_scalbnl>, C<d_sched_yield>,
11728 C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>,
11729 C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>,
11730 C<d_semop>, C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>,
11731 C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>,
11732 C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>,
11733 C<d_setnent>, C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>,
11734 C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>,
11735 C<d_setpwent>, C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>,
11736 C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>,
11737 C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>,
11738 C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>,
11739 C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>,
11740 C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>,
11741 C<d_socks5_init>, C<d_sqrtl>, C<d_srand48_r>, C<d_srandom_r>,
11742 C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>,
11743 C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
11744 C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>,
11745 C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>,
11746 C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strerror_r>,
11747 C<d_strftime>, C<d_strlcat>, C<d_strlcpy>, C<d_strtod>, C<d_strtol>,
11748 C<d_strtold>, C<d_strtoll>, C<d_strtoq>, C<d_strtoul>, C<d_strtoull>,
11749 C<d_strtouq>, C<d_strxfrm>, C<d_suidsafe>, C<d_symlink>, C<d_syscall>,
11750 C<d_syscallproto>, C<d_sysconf>, C<d_sysernlst>, C<d_syserrlst>,
11751 C<d_system>, C<d_tcgetpgrp>, C<d_tcsetpgrp>, C<d_telldir>,
11752 C<d_telldirproto>, C<d_time>, C<d_times>, C<d_tm_tm_gmtoff>,
11753 C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>, C<d_ttyname_r>, C<d_tzname>,
11754 C<d_u32align>, C<d_ualarm>, C<d_umask>, C<d_uname>, C<d_union_semun>,
11755 C<d_unordered>, C<d_usleep>, C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>,
11756 C<d_vendorbin>, C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>,
11757 C<d_void_closedir>, C<d_voidsig>, C<d_voidtty>, C<d_volatile>,
11758 C<d_vprintf>, C<d_wait4>, C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>,
11759 C<d_writev>, C<d_xenix>, C<date>, C<db_hashtype>, C<db_prefixtype>,
11760 C<db_version_major>, C<db_version_minor>, C<db_version_patch>,
11761 C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>, C<doublesize>,
11762 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<usemallocwrap>,
11923 C<usemorebits>, C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>,
11924 C<useperlio>, C<useposix>, C<usereentrant>, C<usesfio>, C<useshrplib>,
11925 C<usesocks>, C<usethreads>, C<usevendorprefix>, C<usevfork>, C<usrinc>,
11926 C<uuname>, 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, getdcwd
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 Why use ppport.h?
12307
12308 You should use F<ppport.h> in modern code so that your code will work
12309 with the widest range of Perl interpreters possible, without significant
12310 additional work.
12311
12312 =item How to use ppport.h
12313
12314 =item Running ppport.h
12315
12316 =back
12317
12318 =item FUNCTIONS
12319
12320 =over 4
12321
12322 =item WriteFile
12323
12324 =back
12325
12326 =item COMPATIBILITY
12327
12328 =over 4
12329
12330 =item Provided Perl compatibility API
12331
12332 =item Perl API not supported by ppport.h
12333
12334 perl 5.9.2, perl 5.9.1, perl 5.9.0, perl 5.8.3, perl 5.8.1, perl 5.8.0,
12335 perl 5.7.3, perl 5.7.2, perl 5.7.1, perl 5.6.1, perl 5.6.0, perl 5.005_03,
12336 perl 5.005, perl 5.004_05, perl 5.004_04, perl 5.004
12337
12338 =back
12339
12340 =item BUGS
12341
12342 =item AUTHORS
12343
12344 =item COPYRIGHT
12345
12346 =item SEE ALSO
12347
12348 =back
12349
12350 =head2 Devel::Peek - A data debugging tool for the XS programmer
12351
12352 =over 4
12353
12354 =item SYNOPSIS
12355
12356 =item DESCRIPTION
12357
12358 =over 4
12359
12360 =item Runtime debugging
12361
12362 =item Memory footprint debugging
12363
12364 =back
12365
12366 =item EXAMPLES
12367
12368 =over 4
12369
12370 =item A simple scalar string
12371
12372 =item A simple scalar number
12373
12374 =item A simple scalar with an extra reference
12375
12376 =item A reference to a simple scalar
12377
12378 =item A reference to an array
12379
12380 =item A reference to a hash
12381
12382 =item Dumping a large array or hash
12383
12384 =item A reference to an SV which holds a C pointer
12385
12386 =item A reference to a subroutine
12387
12388 =back
12389
12390 =item EXPORTS
12391
12392 =item BUGS
12393
12394 =item AUTHOR
12395
12396 =item SEE ALSO
12397
12398 =back
12399
12400 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
12401
12402 =over 4
12403
12404 =item SYNOPSIS
12405
12406 =item DESCRIPTION
12407
12408 =back
12409
12410 =head2 Digest - Modules that calculate message digests
12411
12412 =over 4
12413
12414 =item SYNOPSIS
12415
12416 =item DESCRIPTION
12417
12418 I<binary>, I<hex>, I<base64>
12419
12420 =item OO INTERFACE
12421
12422 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
12423 Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset,
12424 $ctx->add( $data, ... ), $ctx->addfile( $io_handle ), $ctx->add_bits(
12425 $data, $nbits ), $ctx->add_bits( $bitstring ), $ctx->digest,
12426 $ctx->hexdigest, $ctx->b64digest
12427
12428 =item Digest speed
12429
12430 =item SEE ALSO
12431
12432 =item AUTHOR
12433
12434 =back
12435
12436 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
12437
12438 =over 4
12439
12440 =item SYNOPSIS
12441
12442 =item DESCRIPTION
12443
12444 =item FUNCTIONS
12445
12446 md5($data,...), md5_hex($data,...), md5_base64($data,...)
12447
12448 =item METHODS
12449
12450 $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...),
12451 $md5->addfile($io_handle), $md5->add_bits($data, $nbits),
12452 $md5->add_bits($bitstring), $md5->digest, $md5->hexdigest, $md5->b64digest
12453
12454 =item EXAMPLES
12455
12456 =item SEE ALSO
12457
12458 =item COPYRIGHT
12459
12460 =item AUTHORS
12461
12462 =back
12463
12464 =head2 Digest::base - Digest base class
12465
12466 =over 4
12467
12468 =item SYNPOSIS
12469
12470 =item DESCRIPTION
12471
12472 =item SEE ALSO
12473
12474 =back
12475
12476 =head2 DirHandle - supply object methods for directory handles
12477
12478 =over 4
12479
12480 =item SYNOPSIS
12481
12482 =item DESCRIPTION
12483
12484 =item NOTES
12485
12486 =back
12487
12488 =head2 Dumpvalue - provides screen dump of Perl data.
12489
12490 =over 4
12491
12492 =item SYNOPSIS
12493
12494 =item DESCRIPTION
12495
12496 =over 4
12497
12498 =item Creation
12499
12500 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
12501 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
12502 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
12503 stopDbSignal
12504
12505 =item Methods
12506
12507 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
12508 compactDump, veryCompact, set, get
12509
12510 =back
12511
12512 =back
12513
12514 =head2 DynaLoader - Dynamically load C libraries into Perl code
12515
12516 =over 4
12517
12518 =item SYNOPSIS
12519
12520 =item DESCRIPTION
12521
12522 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
12523 @dl_modules, @dl_shared_objects, dl_error(), $dl_debug, dl_findfile(),
12524 dl_expandspec(), dl_load_file(), dl_unload_file(), dl_load_flags(),
12525 dl_find_symbol(), dl_find_symbol_anywhere(), dl_undef_symbols(),
12526 dl_install_xsub(), bootstrap()
12527
12528 =item AUTHOR
12529
12530 =back
12531
12532 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
12533 Perl code
12534
12535 =over 4
12536
12537 =item SYNOPSIS
12538
12539 =item DESCRIPTION
12540
12541 =over 4
12542
12543 =item Migration from C<DynaLoader>
12544
12545 =item Backward compatible boilerplate
12546
12547 =back
12548
12549 =item Order of initialization: early load()
12550
12551 =over 4
12552
12553 =item The most hairy case
12554
12555 =back
12556
12557 =item LIMITATIONS
12558
12559 =item AUTHOR
12560
12561 =back
12562
12563 =head2 Encode - character encodings
12564
12565 =over 4
12566
12567 =item SYNOPSIS
12568
12569 =over 4
12570
12571 =item Table of Contents
12572
12573 =back
12574
12575 =item DESCRIPTION
12576
12577 =over 4
12578
12579 =item TERMINOLOGY
12580
12581 =back
12582
12583 =item PERL ENCODING API
12584
12585 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
12586 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
12587 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
12588 CHECK]);
12589
12590 =over 4
12591
12592 =item Listing available encodings
12593
12594 =item Defining Aliases
12595
12596 =back
12597
12598 =item Encoding via PerlIO
12599
12600 =item Handling Malformed Data
12601
12602 B<NOTE:> Not all encoding suppport this feature, I<CHECK> =
12603 Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1), I<CHECK> =
12604 Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode (I<CHECK> =
12605 Encode::FB_PERLQQ), HTML charref mode (I<CHECK> = Encode::FB_HTMLCREF), XML
12606 charref mode (I<CHECK> = Encode::FB_XMLCREF), The bitmask
12607
12608 =over 4
12609
12610 =item Unimplemented fallback schemes
12611
12612 =back
12613
12614 =item Defining Encodings
12615
12616 =item The UTF-8 flag
12617
12618 Goal #1:, Goal #2:, Goal #3:, Goal #4:
12619
12620 =over 4
12621
12622 =item Messing with Perl's Internals
12623
12624 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
12625
12626 =back
12627
12628 =item SEE ALSO
12629
12630 =item MAINTAINER
12631
12632 =back
12633
12634 =head2 Encode::Alias - alias definitions to encodings
12635
12636 =over 4
12637
12638 =item SYNOPSIS
12639
12640 =item DESCRIPTION
12641
12642 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
12643 reference, e.g.:
12644
12645 =over 4
12646
12647 =item Alias overloading
12648
12649 =back
12650
12651 =item SEE ALSO
12652
12653 =back
12654
12655 =head2 Encode::Byte - Single Byte Encodings
12656
12657 =over 4
12658
12659 =item SYNOPSIS
12660
12661 =item ABSTRACT
12662
12663 =item DESCRIPTION
12664
12665 =item SEE ALSO
12666
12667 =back
12668
12669 =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
12670
12671 =head2 Encode::CN - China-based Chinese Encodings
12672
12673 =over 4
12674
12675 =item SYNOPSIS
12676
12677 =item DESCRIPTION
12678
12679 =item NOTES
12680
12681 =item BUGS
12682
12683 =item SEE ALSO
12684
12685 =back
12686
12687 =head2 Encode::CN::HZ -- internally used by Encode::CN
12688
12689 =head2 Encode::Config -- internally used by Encode
12690
12691 =head2 Encode::EBCDIC - EBCDIC Encodings
12692
12693 =over 4
12694
12695 =item SYNOPSIS
12696
12697 =item ABSTRACT
12698
12699 =item DESCRIPTION
12700
12701 =item SEE ALSO
12702
12703 =back
12704
12705 =head2 Encode::Encoding - Encode Implementation Base Class
12706
12707 =over 4
12708
12709 =item SYNOPSIS
12710
12711 =item DESCRIPTION
12712
12713 =over 4
12714
12715 =item Methods you should implement
12716
12717 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
12718 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
12719
12720 =item Other methods defined in Encode::Encodings
12721
12722 -E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(),
12723 -E<gt>needs_lines()
12724
12725 =item Example: Encode::ROT13
12726
12727 =back
12728
12729 =item Why the heck Encode API is different?
12730
12731 =over 4
12732
12733 =item Compiled Encodings
12734
12735 =back
12736
12737 =item SEE ALSO
12738
12739 Scheme 1, Scheme 2, Other Schemes
12740
12741 =back
12742
12743 =head2 Encode::Guess -- Guesses encoding from data
12744
12745 =over 4
12746
12747 =item SYNOPSIS
12748
12749 =item ABSTRACT
12750
12751 =item DESCRIPTION
12752
12753 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
12754 Encode::decode("Guess" ...), Encode::Guess->guess($data),
12755 guess_encoding($data, [, I<list of suspects>])
12756
12757 =item CAVEATS
12758
12759 =item TO DO
12760
12761 =item SEE ALSO
12762
12763 =back
12764
12765 =head2 Encode::JP - Japanese Encodings
12766
12767 =over 4
12768
12769 =item SYNOPSIS
12770
12771 =item ABSTRACT
12772
12773 =item DESCRIPTION
12774
12775 =item Note on ISO-2022-JP(-1)?
12776
12777 =item BUGS
12778
12779 =item SEE ALSO
12780
12781 =back
12782
12783 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
12784
12785 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
12786
12787 =head2 Encode::KR - Korean Encodings
12788
12789 =over 4
12790
12791 =item SYNOPSIS
12792
12793 =item DESCRIPTION
12794
12795 =item BUGS
12796
12797 =item SEE ALSO
12798
12799 =back
12800
12801 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
12802
12803 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
12804
12805 =over 4
12806
12807 =item SYNOPSIS
12808
12809 =item ABSTRACT
12810
12811 =item DESCRIPTION
12812
12813 =item BUGS
12814
12815 =item SEE ALSO
12816
12817 =back
12818
12819 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
12820
12821 =over 4
12822
12823 =item Overview
12824
12825 =item How does it work?
12826
12827 =item Line Buffering
12828
12829 =over 4
12830
12831 =item How can I tell whether my encoding fully supports PerlIO ?
12832
12833 =back
12834
12835 =item SEE ALSO
12836
12837 =back
12838
12839 =head2 Encode::Supported -- Encodings supported by Encode
12840
12841 =over 4
12842
12843 =item DESCRIPTION
12844
12845 =over 4
12846
12847 =item Encoding Names
12848
12849 =back
12850
12851 =item Supported Encodings
12852
12853 =over 4
12854
12855 =item Built-in Encodings
12856
12857 =item Encode::Unicode -- other Unicode encodings
12858
12859 =item Encode::Byte -- Extended ASCII
12860
12861 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
12862 the Cyrillic world, gsm0338 - Hentai Latin 1
12863
12864 =item CJK: Chinese, Japanese, Korean (Multibyte)
12865
12866 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
12867 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
12868 Encode::JIS2K -- JIS X 0213 encodings via CPAN
12869
12870 =item Miscellaneous encodings
12871
12872 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
12873
12874 =back
12875
12876 =item Unsupported encodings
12877
12878   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
12879 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
12880 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
12881 Various Mac encodings, (Mac) Indic encodings
12882
12883 =item Encoding vs. Charset -- terminology
12884
12885 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
12886
12887 =over 4
12888
12889 =item Microsoft-related naming mess
12890
12891 KS_C_5601-1987, GB2312, Big5, Shift_JIS
12892
12893 =back
12894
12895 =item Glossary
12896
12897 character repertoire, coded character set (CCS), character encoding scheme
12898 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
12899 UTF-16
12900
12901 =item See Also
12902
12903 =item References
12904
12905 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
12906 RFC, UC, Unicode Glossary
12907
12908 =over 4
12909
12910 =item Other Notable Sites
12911
12912 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
12913 "Introduction to i18n"
12914
12915 =item Offline sources
12916
12917 C<CJKV Information Processing> by Ken Lunde
12918
12919 =back
12920
12921 =back
12922
12923 =head2 Encode::Symbol - Symbol Encodings
12924
12925 =over 4
12926
12927 =item SYNOPSIS
12928
12929 =item ABSTRACT
12930
12931 =item DESCRIPTION
12932
12933 =item SEE ALSO
12934
12935 =back
12936
12937 =head2 Encode::TW - Taiwan-based Chinese Encodings
12938
12939 =over 4
12940
12941 =item SYNOPSIS
12942
12943 =item DESCRIPTION
12944
12945 =item NOTES
12946
12947 =item BUGS
12948
12949 =item SEE ALSO
12950
12951 =back
12952
12953 =head2 Encode::Unicode -- Various Unicode Transformation Formats
12954
12955 =over 4
12956
12957 =item SYNOPSIS
12958
12959 =item ABSTRACT
12960
12961 L<http://www.unicode.org/glossary/> says:, Quick Reference
12962
12963 =item Size, Endianness, and BOM
12964
12965 =over 4
12966
12967 =item by size
12968
12969 =item by endianness
12970
12971 BOM as integer when fetched in network byte order
12972
12973 =back
12974
12975 =item Surrogate Pairs
12976
12977 =item Error Checking
12978
12979 =item SEE ALSO
12980
12981 =back
12982
12983 =head2 Encode::Unicode::UTF7 -- UTF-7 encoding
12984
12985 =over 4
12986
12987 =item SYNOPSIS
12988
12989 =item ABSTRACT
12990
12991 =item In Practice
12992
12993 =item SEE ALSO
12994
12995 =back
12996
12997 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
12998 encodings
12999
13000 =over 4
13001
13002 =item SYNOPSIS
13003
13004 =item DESCRIPTION
13005
13006 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
13007 reference, e.g.:
13008
13009 =over 4
13010
13011 =item Alias overloading
13012
13013 =back
13014
13015 =item SEE ALSO
13016
13017 =back
13018
13019 =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm --
13020 Internally used by Encode::??::ISO_2022_*
13021
13022 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
13023 Encode::CN
13024
13025 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
13026 Encode
13027
13028 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
13029 Implementation Base Class
13030
13031 =over 4
13032
13033 =item SYNOPSIS
13034
13035 =item DESCRIPTION
13036
13037 =over 4
13038
13039 =item Methods you should implement
13040
13041 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
13042 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
13043
13044 =item Other methods defined in Encode::Encodings
13045
13046 -E<gt>name, -E<gt>renew, -E<gt>renewed, -E<gt>perlio_ok(),
13047 -E<gt>needs_lines()
13048
13049 =item Example: Encode::ROT13
13050
13051 =back
13052
13053 =item Why the heck Encode API is different?
13054
13055 =over 4
13056
13057 =item Compiled Encodings
13058
13059 =back
13060
13061 =item SEE ALSO
13062
13063 Scheme 1, Scheme 2, Other Schemes
13064
13065 =back
13066
13067 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
13068 data
13069
13070 =over 4
13071
13072 =item SYNOPSIS
13073
13074 =item ABSTRACT
13075
13076 =item DESCRIPTION
13077
13078 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
13079 Encode::decode("Guess" ...), Encode::Guess->guess($data),
13080 guess_encoding($data, [, I<list of suspects>])
13081
13082 =item CAVEATS
13083
13084 =item TO DO
13085
13086 =item SEE ALSO
13087
13088 =back
13089
13090 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
13091 Encode::JP::2022_JP*
13092
13093 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
13094 by Encode::JP
13095
13096 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
13097 used by Encode::KR
13098
13099 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
13100 and 'Q' header encoding
13101
13102 =over 4
13103
13104 =item SYNOPSIS
13105
13106 =item ABSTRACT
13107
13108 =item DESCRIPTION
13109
13110 =item BUGS
13111
13112 =item SEE ALSO
13113
13114 =back
13115
13116 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
13117 on Encode and PerlIO
13118
13119 =over 4
13120
13121 =item Overview
13122
13123 =item How does it work?
13124
13125 =item Line Buffering
13126
13127 =over 4
13128
13129 =item How can I tell whether my encoding fully supports PerlIO ?
13130
13131 =back
13132
13133 =item SEE ALSO
13134
13135 =back
13136
13137 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
13138 supported by Encode
13139
13140 =over 4
13141
13142 =item DESCRIPTION
13143
13144 =over 4
13145
13146 =item Encoding Names
13147
13148 =back
13149
13150 =item Supported Encodings
13151
13152 =over 4
13153
13154 =item Built-in Encodings
13155
13156 =item Encode::Unicode -- other Unicode encodings
13157
13158 =item Encode::Byte -- Extended ASCII
13159
13160 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
13161 the Cyrillic world, gsm0338 - Hentai Latin 1
13162
13163 =item CJK: Chinese, Japanese, Korean (Multibyte)
13164
13165 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
13166 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
13167 Encode::JIS2K -- JIS X 0213 encodings via CPAN
13168
13169 =item Miscellaneous encodings
13170
13171 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
13172
13173 =back
13174
13175 =item Unsupported encodings
13176
13177   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
13178 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
13179 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
13180 Various Mac encodings, (Mac) Indic encodings
13181
13182 =item Encoding vs. Charset -- terminology
13183
13184 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
13185
13186 =over 4
13187
13188 =item Microsoft-related naming mess
13189
13190 KS_C_5601-1987, GB2312, Big5, Shift_JIS
13191
13192 =back
13193
13194 =item Glossary
13195
13196 character repertoire, coded character set (CCS), character encoding scheme
13197 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
13198 UTF-16
13199
13200 =item See Also
13201
13202 =item References
13203
13204 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
13205 RFC, UC, Unicode Glossary
13206
13207 =over 4
13208
13209 =item Other Notable Sites
13210
13211 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
13212 "Introduction to i18n"
13213
13214 =item Offline sources
13215
13216 C<CJKV Information Processing> by Ken Lunde
13217
13218 =back
13219
13220 =back
13221
13222 =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7
13223 encoding
13224
13225 =over 4
13226
13227 =item SYNOPSIS
13228
13229 =item ABSTRACT
13230
13231 =item In Practice
13232
13233 =item SEE ALSO
13234
13235 =back
13236
13237 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
13238
13239 =over 4
13240
13241 =item SYNOPSIS
13242
13243 =item ABSTRACT
13244
13245 =item Description
13246
13247 =over 4
13248
13249 =item Predefined Methods
13250
13251 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
13252 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
13253 $e-E<gt>bytes([$encoding])
13254
13255 =item Example: base64 transcoder
13256
13257 =item Operator Overloading
13258
13259 =back
13260
13261 =item SEE ALSO
13262
13263 =back
13264
13265 =head2 Encodencoding, encoding - allows you to write your script in
13266 non-ascii or non-utf8
13267
13268 =over 4
13269
13270 =item SYNOPSIS
13271
13272 =item ABSTRACT
13273
13274 =over 4
13275
13276 =item Literal Conversions
13277
13278 =item PerlIO layers for C<STD(IN|OUT)>
13279
13280 =item Implicit upgrading for byte strings
13281
13282 =back
13283
13284 =item FEATURES THAT REQUIRE 5.8.1
13285
13286 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
13287
13288 =item USAGE
13289
13290 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
13291 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
13292
13293 =item The Filter Option
13294
13295 =over 4
13296
13297 =item Filter-related changes at Encode version 1.87
13298
13299 =back
13300
13301 =item CAVEATS
13302
13303 =over 4
13304
13305 =item NOT SCOPED
13306
13307 =item DO NOT MIX MULTIPLE ENCODINGS
13308
13309 =item tr/// with ranges
13310
13311 Legend of characters above
13312
13313 =back
13314
13315 =item EXAMPLE - Greekperl
13316
13317 =item KNOWN PROBLEMS
13318
13319 literals in regex that are longer than 127 bytes, EBCDIC, format
13320
13321 =over 4
13322
13323 =item The Logic of :locale
13324
13325 =back
13326
13327 =item HISTORY
13328
13329 =item SEE ALSO
13330
13331 =back
13332
13333 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
13334
13335 =over 4
13336
13337 =item SYNOPSIS
13338
13339 =item ABSTRACT
13340
13341 =item Description
13342
13343 =over 4
13344
13345 =item Predefined Methods
13346
13347 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
13348 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
13349 $e-E<gt>bytes([$encoding])
13350
13351 =item Example: base64 transcoder
13352
13353 =item Operator Overloading
13354
13355 =back
13356
13357 =item SEE ALSO
13358
13359 =back
13360
13361 =head2 English - use nice English (or awk) names for ugly punctuation
13362 variables
13363
13364 =over 4
13365
13366 =item SYNOPSIS
13367
13368 =item DESCRIPTION
13369
13370 =item PERFORMANCE
13371
13372 =back
13373
13374 =head2 Env - perl module that imports environment variables as scalars or
13375 arrays
13376
13377 =over 4
13378
13379 =item SYNOPSIS
13380
13381 =item DESCRIPTION
13382
13383 =item LIMITATIONS
13384
13385 =item AUTHOR
13386
13387 =back
13388
13389 =head2 Errno - System errno constants
13390
13391 =over 4
13392
13393 =item SYNOPSIS
13394
13395 =item DESCRIPTION
13396
13397 =item CAVEATS
13398
13399 =item AUTHOR
13400
13401 =item COPYRIGHT
13402
13403 =back
13404
13405 =head2 Exporter - Implements default import method for modules
13406
13407 =over 4
13408
13409 =item SYNOPSIS
13410
13411 =item DESCRIPTION
13412
13413 =over 4
13414
13415 =item How to Export
13416
13417 =item Selecting What To Export
13418
13419 =item How to Import
13420
13421 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
13422
13423 =back
13424
13425 =item Advanced features
13426
13427 =over 4
13428
13429 =item Specialised Import Lists
13430
13431 =item Exporting without using Exporter's import method
13432
13433 =item Exporting without inheriting from Exporter
13434
13435 =item Module Version Checking
13436
13437 =item Managing Unknown Symbols
13438
13439 =item Tag Handling Utility Functions
13440
13441 =item Generating combined tags
13442
13443 =item C<AUTOLOAD>ed Constants
13444
13445 =back
13446
13447 =back
13448
13449 =head2 Exporter::Heavy - Exporter guts
13450
13451 =over 4
13452
13453 =item SYNOPSIS
13454
13455 =item DESCRIPTION
13456
13457 =back
13458
13459 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
13460 Makefiles etc.
13461
13462 =over 4
13463
13464 =item SYNOPSIS
13465
13466 =item DESCRIPTION
13467
13468 =back
13469
13470 cat
13471
13472 eqtime src dst
13473
13474 rm_rf files...
13475
13476 rm_f files...
13477
13478 touch files ..
13479
13480 mv source... destination
13481
13482 cp source... destination
13483
13484 chmod mode files..
13485
13486 mkpath directory..
13487
13488 test_f file
13489
13490 dos2unix
13491
13492 =over 4
13493
13494 =item BUGS
13495
13496 =item SEE ALSO 
13497
13498 =item AUTHOR
13499
13500 =back
13501
13502 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
13503
13504 =over 4
13505
13506 =item SYNOPSIS
13507
13508 =item DESCRIPTION
13509
13510 B<test_harness>
13511
13512 =back
13513
13514 B<pod2man>
13515
13516 B<warn_if_old_packlist>
13517
13518 B<perllocal_install>
13519
13520 B<uninstall>
13521
13522 =head2 ExtUtils::Constant - generate XS code to import C header constants
13523
13524 =over 4
13525
13526 =item SYNOPSIS
13527
13528 =item DESCRIPTION
13529
13530 =item USAGE
13531
13532 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
13533
13534 =item FUNCTIONS
13535
13536 =back
13537
13538 C_stringify NAME
13539
13540 perl_stringify NAME
13541
13542 constant_types
13543
13544 memEQ_clause NAME, CHECKED_AT, INDENT
13545
13546 assign INDENT, TYPE, PRE, POST, VALUE..
13547
13548 return_clause
13549
13550 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
13551
13552 params WHAT
13553
13554 dump_names
13555
13556 dogfood
13557
13558 C_constant, name, type, value, macro, default, pre, post, def_pre =item
13559 def_post, utf8
13560
13561 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
13562
13563 autoload PACKAGE, VERSION, AUTOLOADER
13564
13565 WriteMakefileSnippet
13566
13567 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
13568 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
13569
13570 =over 4
13571
13572 =item AUTHOR
13573
13574 =back
13575
13576 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
13577
13578 =over 4
13579
13580 =item SYNOPSIS
13581
13582 =item DESCRIPTION
13583
13584 =item @EXPORT
13585
13586 =item FUNCTIONS
13587
13588 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
13589 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
13590
13591 =item EXAMPLES
13592
13593 =item SEE ALSO
13594
13595 =item AUTHOR
13596
13597 =back
13598
13599 =head2 ExtUtils::Install - install files from here to there
13600
13601 =over 4
13602
13603 =item SYNOPSIS
13604
13605 =item DESCRIPTION
13606
13607 =over 4
13608
13609 =item Functions
13610
13611 B<install>
13612
13613 =back
13614
13615 =back
13616
13617 B<install_default> I<DISCOURAGED>
13618
13619 B<uninstall>
13620
13621 B<pm_to_blib>
13622
13623 _autosplit
13624
13625 =over 4
13626
13627 =item ENVIRONMENT
13628
13629 B<PERL_INSTALL_ROOT>
13630
13631 =item AUTHOR
13632
13633 =item LICENSE
13634
13635 =back
13636
13637 =head2 ExtUtils::Installed - Inventory management of installed modules
13638
13639 =over 4
13640
13641 =item SYNOPSIS
13642
13643 =item DESCRIPTION
13644
13645 =item USAGE
13646
13647 =item FUNCTIONS
13648
13649 new(), modules(), files(), directories(), directory_tree(), validate(),
13650 packlist(), version()
13651
13652 =item EXAMPLE
13653
13654 =item AUTHOR
13655
13656 =back
13657
13658 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
13659
13660 =over 4
13661
13662 =item SYNOPSIS
13663
13664 =item DESCRIPTION
13665
13666 For static extensions, For dynamic extensions at build/link time, For
13667 dynamic extensions at load time
13668
13669 =over 4
13670
13671 =item EXTRALIBS
13672
13673 =item LDLOADLIBS and LD_RUN_PATH
13674
13675 =item BSLOADLIBS
13676
13677 =back
13678
13679 =item PORTABILITY
13680
13681 =over 4
13682
13683 =item VMS implementation
13684
13685 =item Win32 implementation
13686
13687 =back
13688
13689 =item SEE ALSO
13690
13691 =back
13692
13693 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
13694
13695 =over 4
13696
13697 =item SYNOPSIS
13698
13699 =item DESCRIPTION
13700
13701 =back
13702
13703 =head2 ExtUtils::MM_Any - Platform-agnostic MM methods
13704
13705 =over 4
13706
13707 =item SYNOPSIS
13708
13709 =item DESCRIPTION
13710
13711 =item Inherently Cross-Platform Methods
13712
13713 installvars
13714
13715 =back
13716
13717 os_flavor_is
13718
13719 blibdirs_target (o)
13720
13721 =over 4
13722
13723 =item File::Spec wrappers
13724
13725 catfile
13726
13727 =back
13728
13729 =over 4
13730
13731 =item Thought To Be Cross-Platform Methods
13732
13733 B<split_command>
13734
13735 =back
13736
13737 B<echo>
13738
13739 init_VERSION
13740
13741 wraplist
13742
13743 manifypods
13744
13745 manifypods_target
13746
13747 makemakerdflt_target
13748
13749 special_targets
13750
13751 POD2MAN_macro
13752
13753 test_via_harness
13754
13755 test_via_script
13756
13757 libscan
13758
13759 tool_autosplit
13760
13761 all_target
13762
13763 metafile_target
13764
13765 signature_target
13766
13767 metafile_addtomanifest_target
13768
13769 signature_addtomanifest_target
13770
13771 =over 4
13772
13773 =item Abstract methods
13774
13775 oneliner, B<quote_literal>, B<escape_newlines>, max_exec_len,
13776 B<init_others>, init_DIRFILESEP, init_linker, init_platform,
13777 platform_constants
13778
13779 =back
13780
13781 os_flavor
13782
13783 =over 4
13784
13785 =item AUTHOR
13786
13787 =back
13788
13789 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
13790 ExtUtils::MakeMaker
13791
13792 =over 4
13793
13794 =item SYNOPSIS
13795
13796 =item DESCRIPTION
13797
13798 =back
13799
13800 os_flavor (o)
13801
13802 init_linker
13803
13804 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
13805 ExtUtils::MakeMaker
13806
13807 =over 4
13808
13809 =item SYNOPSIS
13810
13811 =item DESCRIPTION
13812
13813 os_flavor (o)
13814
13815 =back
13816
13817 cflags (o)
13818
13819 replace_manpage_separator (o)
13820
13821 init_linker
13822
13823 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
13824
13825 =over 4
13826
13827 =item SYNOPSIS
13828
13829 =item DESCRIPTION
13830
13831 =over 4
13832
13833 =item Overridden methods
13834
13835 os_flavor
13836
13837 =back
13838
13839 =back
13840
13841 B<replace_manpage_separator>
13842
13843 =over 4
13844
13845 =item AUTHOR
13846
13847 =item SEE ALSO
13848
13849 =back
13850
13851 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
13852 ExtUtils::MakeMaker
13853
13854 =over 4
13855
13856 =item SYNOPSIS
13857
13858 =item DESCRIPTION
13859
13860 =back
13861
13862 maybe_command
13863
13864 guess_name
13865
13866 macify
13867
13868 patternify
13869
13870 init_main
13871
13872 init_others
13873
13874 init_platform, platform_constants
13875
13876 init_dirscan
13877
13878 init_VERSION (o)
13879
13880 special_targets (o)
13881
13882 static (o)
13883
13884 dlsyms (o)
13885
13886 dynamic (o)
13887
13888 clean (o)
13889
13890 clean_subdirs_target
13891
13892 realclean (o)
13893
13894 realclean_subdirs_target
13895
13896 rulez (o)
13897
13898 processPL (o)
13899
13900 os_flavor
13901
13902 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
13903 ExtUtils::MakeMaker
13904
13905 =over 4
13906
13907 =item SYNOPSIS
13908
13909 =item DESCRIPTION
13910
13911 =back
13912
13913 os_flavor
13914
13915 init_platform (o), platform_constants
13916
13917 const_cccmd (o)
13918
13919 static_lib (o)
13920
13921 dynamic_lib (o)
13922
13923 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
13924 ExtUtils::MakeMaker
13925
13926 =over 4
13927
13928 =item SYNOPSIS
13929
13930 =item DESCRIPTION
13931
13932 =item METHODS
13933
13934 init_dist (o)
13935
13936 =back
13937
13938 init_linker
13939
13940 os_flavor
13941
13942 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
13943
13944 =over 4
13945
13946 =item SYNOPSIS
13947
13948 =item DESCRIPTION
13949
13950 =over 4
13951
13952 =item Overridden methods
13953
13954 os_flavor
13955
13956 =back
13957
13958 =back
13959
13960 B<replace_manpage_separator>
13961
13962 =over 4
13963
13964 =item AUTHOR
13965
13966 =item SEE ALSO
13967
13968 =back
13969
13970 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
13971
13972 =over 4
13973
13974 =item SYNOPSIS
13975
13976 =item DESCRIPTION
13977
13978 =item METHODS
13979
13980 =back
13981
13982 =over 4
13983
13984 =item Methods
13985
13986 os_flavor (o)
13987
13988 =back
13989
13990 c_o (o)
13991
13992 cflags (o)
13993
13994 clean (o)
13995
13996 clean_subdirs_target
13997
13998 const_cccmd (o)
13999
14000 const_config (o)
14001
14002 const_loadlibs (o)
14003
14004 constants (o)
14005
14006 depend (o)
14007
14008 dir_target B<DEPRECATED>
14009
14010 init_DEST
14011
14012 init_dist
14013
14014 dist (o)
14015
14016 dist_basics (o)
14017
14018 dist_ci (o)
14019
14020 dist_core (o)
14021
14022 B<dist_target>
14023
14024 B<tardist_target>
14025
14026 B<zipdist_target>
14027
14028 B<tarfile_target>
14029
14030 zipfile_target
14031
14032 uutardist_target
14033
14034 shdist_target
14035
14036 distdir
14037
14038 dist_test
14039
14040 dlsyms (o)
14041
14042 dynamic (o)
14043
14044 dynamic_bs (o)
14045
14046 dynamic_lib (o)
14047
14048 exescan
14049
14050 extliblist
14051
14052 find_perl
14053
14054 find_tests
14055
14056 =over 4
14057
14058 =item Methods to actually produce chunks of text for the Makefile
14059
14060 fixin
14061
14062 =back
14063
14064 force (o)
14065
14066 guess_name
14067
14068 has_link_code
14069
14070 init_dirscan
14071
14072 init_DIRFILESEP
14073
14074 init_main
14075
14076 init_others
14077
14078 init_INST
14079
14080 init_INSTALL
14081
14082 init_linker
14083
14084 init_lib2arch
14085
14086 init_PERL
14087
14088 init_platform (o), platform_constants (o)
14089
14090 init_PERM
14091
14092 init_xs
14093
14094 install (o)
14095
14096 installbin (o)
14097
14098 linkext (o)
14099
14100 lsdir
14101
14102 macro (o)
14103
14104 makeaperl (o)
14105
14106 makefile (o)
14107
14108 maybe_command
14109
14110 needs_linking (o)
14111
14112 nicetext
14113
14114 parse_abstract
14115
14116 parse_version
14117
14118 pasthru (o)
14119
14120 perl_script
14121
14122 perldepend (o)
14123
14124 perm_rw (o)
14125
14126 perm_rwx (o)
14127
14128 pm_to_blib
14129
14130 post_constants (o)
14131
14132 post_initialize (o)
14133
14134 postamble (o)
14135
14136 ppd
14137
14138 prefixify
14139
14140 processPL (o)
14141
14142 quote_paren
14143
14144 realclean (o)
14145
14146 realclean_subdirs_target
14147
14148 replace_manpage_separator
14149
14150 oneliner (o)
14151
14152 quote_literal
14153
14154 escape_newlines
14155
14156 max_exec_len
14157
14158 static (o)
14159
14160 static_lib (o)
14161
14162 staticmake (o)
14163
14164 subdir_x (o)
14165
14166 subdirs (o)
14167
14168 test (o)
14169
14170 test_via_harness (override)
14171
14172 test_via_script (override)
14173
14174 tools_other (o)
14175
14176 tool_xsubpp (o)
14177
14178 all_target
14179
14180 top_targets (o)
14181
14182 writedoc
14183
14184 xs_c (o)
14185
14186 xs_cpp (o)
14187
14188 xs_o (o)
14189
14190 =over 4
14191
14192 =item SEE ALSO
14193
14194 =back
14195
14196 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
14197 ExtUtils::MakeMaker
14198
14199 =over 4
14200
14201 =item SYNOPSIS
14202
14203 =item DESCRIPTION
14204
14205 =over 4
14206
14207 =item Methods always loaded
14208
14209 wraplist
14210
14211 =back
14212
14213 =back
14214
14215 =over 4
14216
14217 =item Methods
14218
14219 guess_name (override)
14220
14221 =back
14222
14223 find_perl (override)
14224
14225 maybe_command (override)
14226
14227 perl_script (override)
14228
14229 replace_manpage_separator
14230
14231 init_DEST
14232
14233 init_DIRFILESEP
14234
14235 init_main (override)
14236
14237 init_others (override)
14238
14239 init_platform (override)
14240
14241 platform_constants
14242
14243 init_VERSION (override)
14244
14245 constants (override)
14246
14247 special_targets
14248
14249 cflags (override)
14250
14251 const_cccmd (override)
14252
14253 tool_sxubpp (override)
14254
14255 tools_other (override)
14256
14257 init_dist (override)
14258
14259 c_o (override)
14260
14261 xs_c (override)
14262
14263 xs_o (override)
14264
14265 dlsyms (override)
14266
14267 dynamic_lib (override)
14268
14269 dynamic_bs (override)
14270
14271 static_lib (override)
14272
14273 processPL (override)
14274
14275 installbin (override)
14276
14277 subdir_x (override)
14278
14279 clean (override)
14280
14281 clean_subdirs_target
14282
14283 realclean (override)
14284
14285 zipfile_target (o), tarfile_target (o), shdist_target (o)
14286
14287 dist_test (override)
14288
14289 install (override)
14290
14291 perldepend (override)
14292
14293 makefile (override)
14294
14295 find_tests (override)
14296
14297 test (override)
14298
14299 makeaperl (override)
14300
14301 nicetext (override)
14302
14303 prefixify (override)
14304
14305 oneliner (o)
14306
14307 B<echo> (o)
14308
14309 quote_literal
14310
14311 escape_newlines
14312
14313 max_exec_len
14314
14315 init_linker (o)
14316
14317 eliminate_macros
14318
14319 fixpath
14320
14321 os_flavor
14322
14323 blibdirs_target (override)
14324
14325 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
14326 ExtUtils::MakeMaker
14327
14328 =over 4
14329
14330 =item SYNOPSIS
14331
14332 =item DESCRIPTION
14333
14334 =back
14335
14336 =over 4
14337
14338 =item Overridden methods
14339
14340 B<dlsyms>
14341
14342 =back
14343
14344 replace_manpage_separator
14345
14346 B<maybe_command>
14347
14348 B<find_tests>
14349
14350 B<init_DIRFILESEP>
14351
14352 B<init_others>
14353
14354 init_platform (o), platform_constants (o)
14355
14356 special_targets (o)
14357
14358 static_lib (o)
14359
14360 dynamic_lib (o)
14361
14362 clean
14363
14364 init_linker
14365
14366 perl_script
14367
14368 xs_o (o)
14369
14370 pasthru (o)
14371
14372 oneliner (o)
14373
14374 max_exec_len
14375
14376 os_flavor
14377
14378 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
14379
14380 =over 4
14381
14382 =item SYNOPSIS
14383
14384 =item DESCRIPTION
14385
14386 =over 4
14387
14388 =item Overriden methods
14389
14390 dist_test
14391
14392 =back
14393
14394 =back
14395
14396 subdir_x
14397
14398 xs_c
14399
14400 xs_cpp
14401
14402 xs_o
14403
14404 clean_subdirs_target
14405
14406 realclean_subdirs_target
14407
14408 max_exec_len
14409
14410 os_flavor
14411
14412 =over 4
14413
14414 =item AUTHOR
14415
14416 =back
14417
14418 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
14419
14420 =over 4
14421
14422 =item SYNOPSIS
14423
14424 =item DESCRIPTION
14425
14426 =back
14427
14428 =head2 ExtUtils::MakeMaker - Create a module Makefile
14429
14430 =over 4
14431
14432 =item SYNOPSIS
14433
14434 =item DESCRIPTION
14435
14436 =over 4
14437
14438 =item How To Write A Makefile.PL
14439
14440 =item Default Makefile Behaviour
14441
14442 =item make test
14443
14444 =item make testdb
14445
14446 =item make install
14447
14448 =item PREFIX and LIB attribute
14449
14450 =item AFS users
14451
14452 =item Static Linking of a new Perl Binary
14453
14454 =item Determination of Perl Library and Installation Locations
14455
14456 =item Which architecture dependent directory?
14457
14458 =item Using Attributes and Parameters
14459
14460 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
14461 CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS,
14462 EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN,
14463 FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB,
14464 INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
14465 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB,
14466 INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLVENDORARCH,
14467 INSTALLVENDORBIN, INSTALLVENDORLIB, INSTALLVENDORMAN1DIR,
14468 INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR,
14469 INST_MAN3DIR, INST_SCRIPT, LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS,
14470 LINKTYPE, MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET,
14471 MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT,
14472 OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB,
14473 PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW,
14474 PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
14475 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT,
14476 PRINT_PREREQ, SITEPREFIX, SIGN, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST,
14477 VERSION, VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION
14478
14479 =item Additional lowercase attributes
14480
14481 clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean,
14482 test, tool_autosplit
14483
14484 =item Overriding MakeMaker Methods
14485
14486 =item The End Of Cargo Cult Programming
14487
14488 C<<MAN3PODS => ' '>>
14489
14490 =item Hintsfile support
14491
14492 =item Distribution Support
14493
14494    make distcheck,    make skipcheck,    make distclean,    make manifest, 
14495   make distdir,   make disttest,    make tardist,    make dist,    make
14496 uutardist,    make shdist,    make zipdist,    make ci
14497
14498 =item Module Meta-Data
14499
14500 =item Disabling an extension
14501
14502 =item Other Handy Functions
14503
14504 prompt
14505
14506 =back
14507
14508 =item ENVIRONMENT
14509
14510 PERL_MM_OPT, PERL_MM_USE_DEFAULT
14511
14512 =item SEE ALSO
14513
14514 =item AUTHORS
14515
14516 =item LICENSE
14517
14518 =back
14519
14520 =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About
14521 MakeMaker
14522
14523 =over 4
14524
14525 =item DESCRIPTION
14526
14527 =over 4
14528
14529 =item Module Installation
14530
14531 How do I keep from installing man pages?, How do I use a module without
14532 installing it?
14533
14534 =item Philosophy and History
14535
14536 Why not just use <insert other build config tool here>?, What is
14537 Module::Build and how does it relate to MakeMaker?, pure perl.  no make, no
14538 shell commands, easier to customize, cleaner internals, less cruft
14539
14540 =item Module Writing
14541
14542 How do I keep my $VERSION up to date without resetting it manually?, What's
14543 this F<META.yml> thing and how did it get in my F<MANIFEST>?!
14544
14545 =item XS
14546
14547 How to I prevent "object version X.XX does not match bootstrap parameter
14548 Y.YY" errors?, How do I make two or more XS files coexist in the same
14549 directory?
14550
14551 =back
14552
14553 =item PATCHING
14554
14555 =item AUTHOR
14556
14557 =item SEE ALSO
14558
14559 =back
14560
14561 =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker
14562
14563 =over 4
14564
14565 =item SYNOPSIS
14566
14567 =item DESCRIPTION
14568
14569 =over 4
14570
14571 =item The Mantra
14572
14573 =item The Layout
14574
14575 Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP,
14576 bin/
14577
14578 =back
14579
14580 =item SEE ALSO
14581
14582 =back
14583
14584 =head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm
14585
14586 =over 4
14587
14588 =item SYNOPSIS
14589
14590 =item DESCRIPTION
14591
14592 =back
14593
14594 =head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm
14595
14596 =over 4
14597
14598 =item SYNOPSIS
14599
14600 =item DESCRIPTION
14601
14602 =back
14603
14604 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
14605
14606 =over 4
14607
14608 =item SYNOPSIS
14609
14610 =item DESCRIPTION
14611
14612 =over 4
14613
14614 =item Functions
14615
14616 mkmanifest
14617
14618 =back
14619
14620 =back
14621
14622 manifind
14623
14624 manicheck
14625
14626 filecheck
14627
14628 fullcheck
14629
14630 skipcheck
14631
14632 maniread
14633
14634 manicopy
14635
14636 maniadd
14637
14638 =over 4
14639
14640 =item MANIFEST
14641
14642 =item MANIFEST.SKIP
14643
14644 =item EXPORT_OK
14645
14646 =item GLOBAL VARIABLES
14647
14648 =back
14649
14650 =over 4
14651
14652 =item DIAGNOSTICS
14653
14654 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
14655 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
14656
14657 =item ENVIRONMENT
14658
14659 B<PERL_MM_MANIFEST_DEBUG>
14660
14661 =item SEE ALSO
14662
14663 =item AUTHOR
14664
14665 =back
14666
14667 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
14668
14669 =over 4
14670
14671 =item SYNOPSIS
14672
14673 =item DESCRIPTION
14674
14675 =item SEE ALSO
14676
14677 =back
14678
14679 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
14680
14681 =over 4
14682
14683 =item SYNOPSIS
14684
14685 =item DESCRIPTION
14686
14687 =back
14688
14689 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
14690 extension
14691
14692 =over 4
14693
14694 =item SYNOPSIS
14695
14696 =item DESCRIPTION
14697
14698 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
14699
14700 =item AUTHOR
14701
14702 =item REVISION
14703
14704 =back
14705
14706 =head2 ExtUtils::Packlist - manage .packlist files
14707
14708 =over 4
14709
14710 =item SYNOPSIS
14711
14712 =item DESCRIPTION
14713
14714 =item USAGE
14715
14716 =item FUNCTIONS
14717
14718 new(), read(), write(), validate(), packlist_file()
14719
14720 =item EXAMPLE
14721
14722 =item AUTHOR
14723
14724 =back
14725
14726 =head2 ExtUtils::testlib - add blib/* directories to @INC
14727
14728 =over 4
14729
14730 =item SYNOPSIS
14731
14732 =item DESCRIPTION
14733
14734 =back
14735
14736 =head2 Fatal - replace functions with equivalents which succeed or die
14737
14738 =over 4
14739
14740 =item SYNOPSIS
14741
14742 =item DESCRIPTION
14743
14744 =item AUTHOR
14745
14746 =back
14747
14748 =head2 Fcntl - load the C Fcntl.h defines
14749
14750 =over 4
14751
14752 =item SYNOPSIS
14753
14754 =item DESCRIPTION
14755
14756 =item NOTE
14757
14758 =item EXPORTED SYMBOLS
14759
14760 =back
14761
14762 =head2 File::Basename, fileparse - split a pathname into pieces
14763
14764 =over 4
14765
14766 =item SYNOPSIS
14767
14768 =item DESCRIPTION
14769
14770 fileparse_set_fstype, fileparse
14771
14772 =item EXAMPLES
14773
14774 C<basename>, C<dirname>
14775
14776 =back
14777
14778 =head2 File::CheckTree, validate - run many filetest checks on a tree
14779
14780 =over 4
14781
14782 =item SYNOPSIS
14783
14784 =item DESCRIPTION
14785
14786 =item AUTHOR
14787
14788 =item HISTORY
14789
14790 =back
14791
14792 =head2 File::Compare - Compare files or filehandles
14793
14794 =over 4
14795
14796 =item SYNOPSIS
14797
14798 =item DESCRIPTION
14799
14800 =item RETURN
14801
14802 =item AUTHOR
14803
14804 =back
14805
14806 =head2 File::Copy - Copy files or filehandles
14807
14808 =over 4
14809
14810 =item SYNOPSIS
14811
14812 =item DESCRIPTION
14813
14814 =over 4
14815
14816 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
14817
14818 rmscopy($from,$to[,$date_flag])
14819
14820 =back
14821
14822 =item RETURN
14823
14824 =item NOTES
14825
14826 =item AUTHOR
14827
14828 =back
14829
14830 =head2 File::DosGlob - DOS like globbing and then some
14831
14832 =over 4
14833
14834 =item SYNOPSIS
14835
14836 =item DESCRIPTION
14837
14838 =item NOTES
14839
14840 =item EXPORTS (by request only)
14841
14842 =item BUGS
14843
14844 =item AUTHOR
14845
14846 =item HISTORY
14847
14848 =item SEE ALSO
14849
14850 =back
14851
14852 =head2 File::Find - Traverse a directory tree.
14853
14854 =over 4
14855
14856 =item SYNOPSIS
14857
14858 =item DESCRIPTION
14859
14860 B<find>, B<finddepth>
14861
14862 =over 4
14863
14864 =item %options
14865
14866 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
14867 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
14868 C<untaint>, C<untaint_pattern>, C<untaint_skip>
14869
14870 =item The wanted function
14871
14872 C<$File::Find::dir> is the current directory name,, C<$_> is the current
14873 filename within that directory, C<$File::Find::name> is the complete
14874 pathname to the file
14875
14876 =back
14877
14878 =item WARNINGS
14879
14880 =item CAVEAT
14881
14882 $dont_use_nlink, symlinks
14883
14884 =item NOTES
14885
14886 =item BUGS AND CAVEATS
14887
14888 =item HISTORY
14889
14890 =back
14891
14892 =head2 File::Glob - Perl extension for BSD glob routine
14893
14894 =over 4
14895
14896 =item SYNOPSIS
14897
14898 =item DESCRIPTION
14899
14900 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
14901 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
14902 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
14903
14904 =item DIAGNOSTICS
14905
14906 C<GLOB_NOSPACE>, C<GLOB_ABEND>
14907
14908 =item NOTES
14909
14910 =item AUTHOR
14911
14912 =back
14913
14914 =head2 File::Path - create or remove directory trees
14915
14916 =over 4
14917
14918 =item SYNOPSIS
14919
14920 =item DESCRIPTION
14921
14922 =item DIAGNOSTICS
14923
14924 =item AUTHORS
14925
14926 =back
14927
14928 =head2 File::Spec - portably perform operations on file names
14929
14930 =over 4
14931
14932 =item SYNOPSIS
14933
14934 =item DESCRIPTION
14935
14936 =item METHODS
14937
14938 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
14939 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
14940 splitdir, catpath(), abs2rel, rel2abs()
14941
14942 =item SEE ALSO
14943
14944 =item AUTHOR
14945
14946 =back
14947
14948 =head2 File::Spec::Cygwin - methods for Cygwin file specs
14949
14950 =over 4
14951
14952 =item SYNOPSIS
14953
14954 =item DESCRIPTION
14955
14956 =back
14957
14958 canonpath
14959
14960 file_name_is_absolute
14961
14962 tmpdir (override)
14963
14964 =head2 File::Spec::Epoc - methods for Epoc file specs
14965
14966 =over 4
14967
14968 =item SYNOPSIS
14969
14970 =item DESCRIPTION
14971
14972 =item AUTHORS
14973
14974 =back
14975
14976 canonpath()
14977
14978 =over 4
14979
14980 =item SEE ALSO
14981
14982 =back
14983
14984 =head2 File::Spec::Functions - portably perform operations on file names
14985
14986 =over 4
14987
14988 =item SYNOPSIS
14989
14990 =item DESCRIPTION
14991
14992 =over 4
14993
14994 =item Exports
14995
14996 =back
14997
14998 =item SEE ALSO
14999
15000 =back
15001
15002 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
15003
15004 =over 4
15005
15006 =item SYNOPSIS
15007
15008 =item DESCRIPTION
15009
15010 =item METHODS
15011
15012 canonpath
15013
15014 =back
15015
15016 catdir()
15017
15018 catfile
15019
15020 curdir
15021
15022 devnull
15023
15024 rootdir
15025
15026 tmpdir
15027
15028 updir
15029
15030 file_name_is_absolute
15031
15032 path
15033
15034 splitpath
15035
15036 splitdir
15037
15038 catpath
15039
15040 abs2rel
15041
15042 rel2abs
15043
15044 =over 4
15045
15046 =item AUTHORS
15047
15048 =item SEE ALSO
15049
15050 =back
15051
15052 =head2 File::Spec::OS2 - methods for OS/2 file specs
15053
15054 =over 4
15055
15056 =item SYNOPSIS
15057
15058 =item DESCRIPTION
15059
15060 tmpdir, splitpath
15061
15062 =back
15063
15064 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
15065 modules
15066
15067 =over 4
15068
15069 =item SYNOPSIS
15070
15071 =item DESCRIPTION
15072
15073 =item METHODS
15074
15075 canonpath()
15076
15077 =back
15078
15079 catdir()
15080
15081 catfile
15082
15083 curdir
15084
15085 devnull
15086
15087 rootdir
15088
15089 tmpdir
15090
15091 updir
15092
15093 no_upwards
15094
15095 case_tolerant
15096
15097 file_name_is_absolute
15098
15099 path
15100
15101 join
15102
15103 splitpath
15104
15105 splitdir
15106
15107 catpath()
15108
15109 abs2rel
15110
15111 rel2abs()
15112
15113 =over 4
15114
15115 =item SEE ALSO
15116
15117 =back
15118
15119 =head2 File::Spec::VMS - methods for VMS file specs
15120
15121 =over 4
15122
15123 =item SYNOPSIS
15124
15125 =item DESCRIPTION
15126
15127 eliminate_macros
15128
15129 =back
15130
15131 fixpath
15132
15133 =over 4
15134
15135 =item Methods always loaded
15136
15137 canonpath (override)
15138
15139 =back
15140
15141 catdir
15142
15143 catfile
15144
15145 curdir (override)
15146
15147 devnull (override)
15148
15149 rootdir (override)
15150
15151 tmpdir (override)
15152
15153 updir (override)
15154
15155 case_tolerant (override)
15156
15157 path (override)
15158
15159 file_name_is_absolute (override)
15160
15161 splitpath (override)
15162
15163 splitdir (override)
15164
15165 catpath (override)
15166
15167 abs2rel (override)
15168
15169 rel2abs (override)
15170
15171 =over 4
15172
15173 =item SEE ALSO
15174
15175 =back
15176
15177 =head2 File::Spec::Win32 - methods for Win32 file specs
15178
15179 =over 4
15180
15181 =item SYNOPSIS
15182
15183 =item DESCRIPTION
15184
15185 devnull
15186
15187 =back
15188
15189 tmpdir
15190
15191 catfile
15192
15193 canonpath
15194
15195 splitpath
15196
15197 splitdir
15198
15199 catpath
15200
15201 =over 4
15202
15203 =item Note For File::Spec::Win32 Maintainers
15204
15205 =back
15206
15207 =over 4
15208
15209 =item SEE ALSO
15210
15211 =back
15212
15213 =head2 File::Temp - return name and handle of a temporary file safely
15214
15215 =over 4
15216
15217 =item PORTABILITY
15218
15219 =item SYNOPSIS
15220
15221 =item DESCRIPTION
15222
15223 =back
15224
15225 =over 4
15226
15227 =item OO INTERFACE
15228
15229 B<new>
15230
15231 =back
15232
15233 B<filename>
15234
15235 B<DESTROY>
15236
15237 =over 4
15238
15239 =item FUNCTIONS
15240
15241 B<tempfile>
15242
15243 =back
15244
15245 B<tempdir>
15246
15247 =over 4
15248
15249 =item MKTEMP FUNCTIONS
15250
15251 B<mkstemp>
15252
15253 =back
15254
15255 B<mkstemps>
15256
15257 B<mkdtemp>
15258
15259 B<mktemp>
15260
15261 =over 4
15262
15263 =item POSIX FUNCTIONS
15264
15265 B<tmpnam>
15266
15267 =back
15268
15269 B<tmpfile>
15270
15271 =over 4
15272
15273 =item ADDITIONAL FUNCTIONS
15274
15275 B<tempnam>
15276
15277 =back
15278
15279 =over 4
15280
15281 =item UTILITY FUNCTIONS
15282
15283 B<unlink0>
15284
15285 =back
15286
15287 B<cmpstat>
15288
15289 B<unlink1>
15290
15291 =over 4
15292
15293 =item PACKAGE VARIABLES
15294
15295 B<safe_level>, STANDARD, MEDIUM, HIGH
15296
15297 =back
15298
15299 TopSystemUID
15300
15301 =over 4
15302
15303 =item WARNING
15304
15305 =over 4
15306
15307 =item Temporary files and NFS
15308
15309 =back
15310
15311 =item HISTORY
15312
15313 =item SEE ALSO
15314
15315 =item AUTHOR
15316
15317 =back
15318
15319 =head2 File::stat - by-name interface to Perl's built-in stat() functions
15320
15321 =over 4
15322
15323 =item SYNOPSIS
15324
15325 =item DESCRIPTION
15326
15327 =item BUGS
15328
15329 =item NOTE
15330
15331 =item AUTHOR
15332
15333 =back
15334
15335 =head2 FileCache - keep more files open than the system permits
15336
15337 =over 4
15338
15339 =item SYNOPSIS
15340
15341 =item DESCRIPTION
15342
15343 cacheout EXPR, cacheout MODE, EXPR
15344
15345 =item CAVEATS
15346
15347 =item BUGS
15348
15349 =back
15350
15351 =head2 FileHandle - supply object methods for filehandles
15352
15353 =over 4
15354
15355 =item SYNOPSIS
15356
15357 =item DESCRIPTION
15358
15359 $fh->print, $fh->printf, $fh->getline, $fh->getlines
15360
15361 =item SEE ALSO
15362
15363 =back
15364
15365 =head2 Filter::Simple - Simplified source filtering
15366
15367 =over 4
15368
15369 =item SYNOPSIS
15370
15371 =item DESCRIPTION
15372
15373 =over 4
15374
15375 =item The Problem
15376
15377 =item A Solution
15378
15379 =item Disabling or changing <no> behaviour
15380
15381 =item All-in-one interface
15382
15383 =item Filtering only specific components of source code
15384
15385 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
15386 C<"all">
15387
15388 =item Filtering only the code parts of source code
15389
15390 Most source code ceases to be grammatically correct when it is broken up
15391 into the pieces between string literals and regexes. So the C<'code'>
15392 component filter behaves slightly differently from the other partial
15393 filters
15394 described in the previous section.
15395
15396 =item Using Filter::Simple with an explicit C<import> subroutine
15397
15398 =item Using Filter::Simple and Exporter together
15399
15400 =item How it works
15401
15402 =back
15403
15404 =item AUTHOR
15405
15406 =item COPYRIGHT
15407
15408 =back
15409
15410 =head2 Filter::Util::Call - Perl Source Filter Utility Module
15411
15412 =over 4
15413
15414 =item SYNOPSIS
15415
15416 =item DESCRIPTION
15417
15418 =over 4
15419
15420 =item B<use Filter::Util::Call>
15421
15422 =item B<import()>
15423
15424 =item B<filter() and anonymous sub>
15425
15426 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
15427
15428 =back
15429
15430 =item EXAMPLES
15431
15432 =over 4
15433
15434 =item Example 1: A simple filter.
15435
15436 =item Example 2: Using the context
15437
15438 =item Example 3: Using the context within the filter
15439
15440 =item Example 4: Using filter_del
15441
15442 =back
15443
15444 =item Filter::Simple
15445
15446 =item AUTHOR
15447
15448 =item DATE
15449
15450 =back
15451
15452 =head2 FindBin - Locate directory of original perl script
15453
15454 =over 4
15455
15456 =item SYNOPSIS
15457
15458 =item DESCRIPTION
15459
15460 =item EXPORTABLE VARIABLES
15461
15462 =item KNOWN ISSUES
15463
15464 =item KNOWN BUGS
15465
15466 =item AUTHORS
15467
15468 =item COPYRIGHT
15469
15470 =back
15471
15472 =head2 GDBM_File - Perl5 access to the gdbm library.
15473
15474 =over 4
15475
15476 =item SYNOPSIS
15477
15478 =item DESCRIPTION
15479
15480 =item AVAILABILITY
15481
15482 =item BUGS
15483
15484 =item SEE ALSO
15485
15486 =back
15487
15488 =head2 Getopt::Long - Extended processing of command line options
15489
15490 =over 4
15491
15492 =item SYNOPSIS
15493
15494 =item DESCRIPTION
15495
15496 =item Command Line Options, an Introduction
15497
15498 =item Getting Started with Getopt::Long
15499
15500 =over 4
15501
15502 =item Simple options
15503
15504 =item A little bit less simple options
15505
15506 =item Mixing command line option with other arguments
15507
15508 =item Options with values
15509
15510 =item Options with multiple values
15511
15512 =item Options with hash values
15513
15514 =item User-defined subroutines to handle options
15515
15516 =item Options with multiple names
15517
15518 =item Case and abbreviations
15519
15520 =item Summary of Option Specifications
15521
15522 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
15523 + [ I<desttype> ]
15524
15525 =back
15526
15527 =item Advanced Possibilities
15528
15529 =over 4
15530
15531 =item Object oriented interface
15532
15533 =item Thread Safety
15534
15535 =item Documentation and help texts
15536
15537 =item Storing options in a hash
15538
15539 =item Bundling
15540
15541 =item The lonesome dash
15542
15543 =item Argument callback
15544
15545 =back
15546
15547 =item Configuring Getopt::Long
15548
15549 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
15550 require_order, permute, bundling (default: disabled), bundling_override
15551 (default: disabled), ignore_case  (default: enabled), ignore_case_always
15552 (default: disabled), auto_version (default:disabled), auto_help
15553 (default:disabled), pass_through (default: disabled), prefix,
15554 prefix_pattern, debug (default: disabled)
15555
15556 =item Exportable Methods
15557
15558 VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage
15559
15560 =item Return values and Errors
15561
15562 =item Legacy
15563
15564 =over 4
15565
15566 =item Default destinations
15567
15568 =item Alternative option starters
15569
15570 =item Configuration variables
15571
15572 =back
15573
15574 =item Trouble Shooting
15575
15576 =over 4
15577
15578 =item GetOptions does not return a false result when an option is not
15579 supplied
15580
15581 =item GetOptions does not split the command line correctly
15582
15583 =item Undefined subroutine &main::GetOptions called
15584
15585 =item How do I put a "-?" option into a Getopt::Long?
15586
15587 =back
15588
15589 =item AUTHOR
15590
15591 =item COPYRIGHT AND DISCLAIMER
15592
15593 =back
15594
15595 =head2 Getopt::Std, getopt, getopts - Process single-character switches
15596 with switch clustering
15597
15598 =over 4
15599
15600 =item SYNOPSIS
15601
15602 =item DESCRIPTION
15603
15604 =item C<--help> and C<--version>
15605
15606 =back
15607
15608 =head2 Hash::Util - A selection of general-utility hash subroutines
15609
15610 =over 4
15611
15612 =item SYNOPSIS
15613
15614 =item DESCRIPTION
15615
15616 =over 4
15617
15618 =item Restricted hashes
15619
15620 lock_keys, unlock_keys
15621
15622 =back
15623
15624 =back
15625
15626 lock_value, unlock_value
15627
15628 B<lock_hash>, B<unlock_hash>
15629
15630 B<hash_seed>
15631
15632 =over 4
15633
15634 =item CAVEATS
15635
15636 =item AUTHOR
15637
15638 =item SEE ALSO
15639
15640 =back
15641
15642 =head2 I18N::Collate - compare 8-bit scalar data according to the current
15643 locale
15644
15645 =over 4
15646
15647 =item SYNOPSIS
15648
15649 =item DESCRIPTION
15650
15651 =back
15652
15653 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
15654 tags
15655
15656 =over 4
15657
15658 =item SYNOPSIS
15659
15660 =item DESCRIPTION
15661
15662 =back
15663
15664 the function is_language_tag($lang1)
15665
15666 the function extract_language_tags($whatever)
15667
15668 the function same_language_tag($lang1, $lang2)
15669
15670 the function similarity_language_tag($lang1, $lang2)
15671
15672 the function is_dialect_of($lang1, $lang2)
15673
15674 the function super_languages($lang1)
15675
15676 the function locale2language_tag($locale_identifier)
15677
15678 the function encode_language_tag($lang1)
15679
15680 the function alternate_language_tags($lang1)
15681
15682 the function @langs = panic_languages(@accept_languages)
15683
15684 the function implicate_supers( ...languages... ), the function
15685 implicate_supers_strictly( ...languages... )
15686
15687 =over 4
15688
15689 =item ABOUT LOWERCASING
15690
15691 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
15692
15693 =item SEE ALSO
15694
15695 =item COPYRIGHT
15696
15697 =item AUTHOR
15698
15699 =back
15700
15701 =head2 I18N::LangTags::Detect - detect the user's language preferences
15702
15703 =over 4
15704
15705 =item SYNOPSIS
15706
15707 =item DESCRIPTION
15708
15709 =item FUNCTIONS
15710
15711 =item ENVIRONMENT
15712
15713 =item SEE ALSO
15714
15715 =item COPYRIGHT
15716
15717 =item AUTHOR
15718
15719 =back
15720
15721 =head2 I18N::LangTags::List -- tags and names for human languages
15722
15723 =over 4
15724
15725 =item SYNOPSIS
15726
15727 =item DESCRIPTION
15728
15729 =item ABOUT LANGUAGE TAGS
15730
15731 =item LIST OF LANGUAGES
15732
15733 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} :
15734 Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} :
15735 Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian,
15736 {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)],
15737 {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic,
15738 {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy}
15739 : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} :
15740 Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} :
15741 Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae}
15742 : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} :
15743 Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai}
15744 : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} :
15745 Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} :
15746 Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber
15747 (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini,
15748 {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} :
15749 Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} :
15750 Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian
15751 (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central
15752 American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages],
15753 {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb}
15754 : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} :
15755 Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} :
15756 Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree,
15757 {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf}
15758 : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based
15759 Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} :
15760 Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} :
15761 Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru)
15762 Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri,
15763 {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch,
15764 {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi}
15765 : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} :
15766 English, {enm} : Old English (1100-1500), {ang} : Old English
15767 (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} :
15768 Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat}
15769 : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} :
15770 Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French
15771 (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} :
15772 Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan,
15773 {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian,
15774 {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High
15775 German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon}
15776 : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient
15777 Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} :
15778 Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian,
15779 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
15780 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
15781 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo,
15782 {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European
15783 (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua
15784 (International Auxiliary Language Association), {ie} : Interlingue, {iu} :
15785 Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} :
15786 Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian
15787 languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} :
15788 Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle,
15789 {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} :
15790 Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar}
15791 : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh,
15792 {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese,
15793 {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz,
15794 {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} :
15795 Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama,
15796 {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} :
15797 Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} :
15798 Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} :
15799 Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban
15800 (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui}
15801 : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai,
15802 {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili,
15803 {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} :
15804 Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} :
15805 Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} :
15806 Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai,
15807 [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} :
15808 Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} :
15809 Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)],
15810 {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple
15811 languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan,
15812 {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele,
15813 {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
15814 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
15815 {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} :
15816 Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} :
15817 Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi}
15818 : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} :
15819 Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
15820 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
15821 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
15822 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
15823 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
15824 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
15825 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
15826 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
15827 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
15828 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
15829 languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} :
15830 Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami,
15831 [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} :
15832 Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak,
15833 {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian,
15834 {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign
15835 Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} :
15836 Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave
15837 (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian,
15838 {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} :
15839 Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} :
15840 South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} :
15841 Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati,
15842 {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} :
15843 Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao,
15844 {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} :
15845 Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} :
15846 Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau,
15847 {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian,
15848 {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} :
15849 Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh}
15850 : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} :
15851 Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian,
15852 {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} :
15853 Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak}
15854 : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was}
15855 : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private
15856 Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} :
15857 Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
15858 : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu,
15859 {zun} : Zuni
15860
15861 =item SEE ALSO
15862
15863 =item COPYRIGHT AND DISCLAIMER
15864
15865 =item AUTHOR
15866
15867 =back
15868
15869 =head2 I18N::Langinfo - query locale information
15870
15871 =over 4
15872
15873 =item SYNOPSIS
15874
15875 =item DESCRIPTION
15876
15877 =over 4
15878
15879 =item EXPORT
15880
15881 =back
15882
15883 =item SEE ALSO
15884
15885 =item AUTHOR
15886
15887 =item COPYRIGHT AND LICENSE
15888
15889 =back
15890
15891 =head2 IO - load various IO modules
15892
15893 =over 4
15894
15895 =item SYNOPSIS
15896
15897 =item DESCRIPTION
15898
15899 =item DEPRECATED
15900
15901 =back
15902
15903 =head2 IO::Dir - supply object methods for directory handles
15904
15905 =over 4
15906
15907 =item SYNOPSIS
15908
15909 =item DESCRIPTION
15910
15911 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
15912 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
15913
15914 =item SEE ALSO
15915
15916 =item AUTHOR
15917
15918 =item COPYRIGHT
15919
15920 =back
15921
15922 =head2 IO::File - supply object methods for filehandles
15923
15924 =over 4
15925
15926 =item SYNOPSIS
15927
15928 =item DESCRIPTION
15929
15930 =item CONSTRUCTOR
15931
15932 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
15933
15934 =item METHODS
15935
15936 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode(
15937 [LAYER] )
15938
15939 =item SEE ALSO
15940
15941 =item HISTORY
15942
15943 =back
15944
15945 =head2 IO::Handle - supply object methods for I/O handles
15946
15947 =over 4
15948
15949 =item SYNOPSIS
15950
15951 =item DESCRIPTION
15952
15953 =item CONSTRUCTOR
15954
15955 new (), new_from_fd ( FD, MODE )
15956
15957 =item METHODS
15958
15959 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
15960 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
15961 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
15962 $io->blocking ( [ BOOL ] ), $io->untaint
15963
15964 =item NOTE
15965
15966 =item SEE ALSO
15967
15968 =item BUGS
15969
15970 =item HISTORY
15971
15972 =back
15973
15974 =head2 IO::Pipe - supply object methods for pipes
15975
15976 =over 4
15977
15978 =item SYNOPSIS
15979
15980 =item DESCRIPTION
15981
15982 =item CONSTRUCTOR
15983
15984 new ( [READER, WRITER] )
15985
15986 =item METHODS
15987
15988 reader ([ARGS]), writer ([ARGS]), handles ()
15989
15990 =item SEE ALSO
15991
15992 =item AUTHOR
15993
15994 =item COPYRIGHT
15995
15996 =back
15997
15998 =head2 IO::Poll - Object interface to system poll call
15999
16000 =over 4
16001
16002 =item SYNOPSIS
16003
16004 =item DESCRIPTION
16005
16006 =item METHODS
16007
16008 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
16009 IO ), handles( [ EVENT_MASK ] )
16010
16011 =item SEE ALSO
16012
16013 =item AUTHOR
16014
16015 =item COPYRIGHT
16016
16017 =back
16018
16019 =head2 IO::Seekable - supply seek based methods for I/O objects
16020
16021 =over 4
16022
16023 =item SYNOPSIS
16024
16025 =item DESCRIPTION
16026
16027 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
16028 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
16029 $io->tell
16030
16031 =item SEE ALSO
16032
16033 =item HISTORY
16034
16035 =back
16036
16037 =head2 IO::Select - OO interface to the select system call
16038
16039 =over 4
16040
16041 =item SYNOPSIS
16042
16043 =item DESCRIPTION
16044
16045 =item CONSTRUCTOR
16046
16047 new ( [ HANDLES ] )
16048
16049 =item METHODS
16050
16051 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
16052 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
16053 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
16054
16055 =item EXAMPLE
16056
16057 =item AUTHOR
16058
16059 =item COPYRIGHT
16060
16061 =back
16062
16063 =head2 IO::Socket - Object interface to socket communications
16064
16065 =over 4
16066
16067 =item SYNOPSIS
16068
16069 =item DESCRIPTION
16070
16071 =item CONSTRUCTOR
16072
16073 new ( [ARGS] )
16074
16075 =item METHODS
16076
16077 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
16078 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
16079
16080 =item SEE ALSO
16081
16082 =item AUTHOR
16083
16084 =item COPYRIGHT
16085
16086 =back
16087
16088 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
16089
16090 =over 4
16091
16092 =item SYNOPSIS
16093
16094 =item DESCRIPTION
16095
16096 =item CONSTRUCTOR
16097
16098 new ( [ARGS] )
16099
16100 =over 4
16101
16102 =item METHODS
16103
16104 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
16105 ()
16106
16107 =back
16108
16109 =item SEE ALSO
16110
16111 =item AUTHOR
16112
16113 =item COPYRIGHT
16114
16115 =back
16116
16117 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
16118
16119 =over 4
16120
16121 =item SYNOPSIS
16122
16123 =item DESCRIPTION
16124
16125 =item CONSTRUCTOR
16126
16127 new ( [ARGS] )
16128
16129 =item METHODS
16130
16131 hostpath(), peerpath()
16132
16133 =item SEE ALSO
16134
16135 =item AUTHOR
16136
16137 =item COPYRIGHT
16138
16139 =back
16140
16141 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
16142 handles
16143
16144 =over 4
16145
16146 =item SYNOPSIS
16147
16148 =item DESCRIPTION
16149
16150 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
16151 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
16152
16153 =item SEE ALSO
16154
16155 =item AUTHOR
16156
16157 =item COPYRIGHT
16158
16159 =back
16160
16161 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
16162
16163 =over 4
16164
16165 =item SYNOPSIS
16166
16167 =item DESCRIPTION
16168
16169 =item CONSTRUCTOR
16170
16171 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
16172
16173 =item METHODS
16174
16175 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS ), binmode(
16176 [LAYER] )
16177
16178 =item SEE ALSO
16179
16180 =item HISTORY
16181
16182 =back
16183
16184 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
16185 handles
16186
16187 =over 4
16188
16189 =item SYNOPSIS
16190
16191 =item DESCRIPTION
16192
16193 =item CONSTRUCTOR
16194
16195 new (), new_from_fd ( FD, MODE )
16196
16197 =item METHODS
16198
16199 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
16200 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
16201 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
16202 $io->blocking ( [ BOOL ] ), $io->untaint
16203
16204 =item NOTE
16205
16206 =item SEE ALSO
16207
16208 =item BUGS
16209
16210 =item HISTORY
16211
16212 =back
16213
16214 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
16215
16216 =over 4
16217
16218 =item SYNOPSIS
16219
16220 =item DESCRIPTION
16221
16222 =item CONSTRUCTOR
16223
16224 new ( [READER, WRITER] )
16225
16226 =item METHODS
16227
16228 reader ([ARGS]), writer ([ARGS]), handles ()
16229
16230 =item SEE ALSO
16231
16232 =item AUTHOR
16233
16234 =item COPYRIGHT
16235
16236 =back
16237
16238 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
16239
16240 =over 4
16241
16242 =item SYNOPSIS
16243
16244 =item DESCRIPTION
16245
16246 =item METHODS
16247
16248 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
16249 IO ), handles( [ EVENT_MASK ] )
16250
16251 =item SEE ALSO
16252
16253 =item AUTHOR
16254
16255 =item COPYRIGHT
16256
16257 =back
16258
16259 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
16260 I/O objects
16261
16262 =over 4
16263
16264 =item SYNOPSIS
16265
16266 =item DESCRIPTION
16267
16268 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
16269 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
16270 $io->tell
16271
16272 =item SEE ALSO
16273
16274 =item HISTORY
16275
16276 =back
16277
16278 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
16279 call
16280
16281 =over 4
16282
16283 =item SYNOPSIS
16284
16285 =item DESCRIPTION
16286
16287 =item CONSTRUCTOR
16288
16289 new ( [ HANDLES ] )
16290
16291 =item METHODS
16292
16293 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
16294 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
16295 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
16296
16297 =item EXAMPLE
16298
16299 =item AUTHOR
16300
16301 =item COPYRIGHT
16302
16303 =back
16304
16305 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
16306 communications
16307
16308 =over 4
16309
16310 =item SYNOPSIS
16311
16312 =item DESCRIPTION
16313
16314 =item CONSTRUCTOR
16315
16316 new ( [ARGS] )
16317
16318 =item METHODS
16319
16320 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
16321 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
16322
16323 =item SEE ALSO
16324
16325 =item AUTHOR
16326
16327 =item COPYRIGHT
16328
16329 =back
16330
16331 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
16332 AF_INET domain sockets
16333
16334 =over 4
16335
16336 =item SYNOPSIS
16337
16338 =item DESCRIPTION
16339
16340 =item CONSTRUCTOR
16341
16342 new ( [ARGS] )
16343
16344 =over 4
16345
16346 =item METHODS
16347
16348 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
16349 ()
16350
16351 =back
16352
16353 =item SEE ALSO
16354
16355 =item AUTHOR
16356
16357 =item COPYRIGHT
16358
16359 =back
16360
16361 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
16362 AF_UNIX domain sockets
16363
16364 =over 4
16365
16366 =item SYNOPSIS
16367
16368 =item DESCRIPTION
16369
16370 =item CONSTRUCTOR
16371
16372 new ( [ARGS] )
16373
16374 =item METHODS
16375
16376 hostpath(), peerpath()
16377
16378 =item SEE ALSO
16379
16380 =item AUTHOR
16381
16382 =item COPYRIGHT
16383
16384 =back
16385
16386 =head2 IPC::Msg - SysV Msg IPC object class
16387
16388 =over 4
16389
16390 =item SYNOPSIS
16391
16392 =item DESCRIPTION
16393
16394 =item METHODS
16395
16396 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
16397 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
16398 FLAGS ] ), stat
16399
16400 =item SEE ALSO
16401
16402 =item AUTHOR
16403
16404 =item COPYRIGHT
16405
16406 =back
16407
16408 =head2 IPC::Open2, open2 - open a process for both reading and writing
16409
16410 =over 4
16411
16412 =item SYNOPSIS
16413
16414 =item DESCRIPTION
16415
16416 =item WARNING 
16417
16418 =item SEE ALSO
16419
16420 =back
16421
16422 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
16423 handling
16424
16425 =over 4
16426
16427 =item SYNOPSIS
16428
16429 =item DESCRIPTION
16430
16431 =item WARNING
16432
16433 =back
16434
16435 =head2 IPC::Semaphore - SysV Semaphore IPC object class
16436
16437 =over 4
16438
16439 =item SYNOPSIS
16440
16441 =item DESCRIPTION
16442
16443 =item METHODS
16444
16445 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
16446 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
16447 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
16448 , VALUE ), stat
16449
16450 =item SEE ALSO
16451
16452 =item AUTHOR
16453
16454 =item COPYRIGHT
16455
16456 =back
16457
16458 =head2 IPC::SysV - SysV IPC constants
16459
16460 =over 4
16461
16462 =item SYNOPSIS
16463
16464 =item DESCRIPTION
16465
16466 ftok( PATH, ID )
16467
16468 =item SEE ALSO
16469
16470 =item AUTHORS
16471
16472 =item COPYRIGHT
16473
16474 =back
16475
16476 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
16477
16478 =over 4
16479
16480 =item SYNOPSIS
16481
16482 =item DESCRIPTION
16483
16484 =item METHODS
16485
16486 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
16487 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
16488 FLAGS ] ), stat
16489
16490 =item SEE ALSO
16491
16492 =item AUTHOR
16493
16494 =item COPYRIGHT
16495
16496 =back
16497
16498 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
16499 class
16500
16501 =over 4
16502
16503 =item SYNOPSIS
16504
16505 =item DESCRIPTION
16506
16507 =item METHODS
16508
16509 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
16510 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
16511 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
16512 , VALUE ), stat
16513
16514 =item SEE ALSO
16515
16516 =item AUTHOR
16517
16518 =item COPYRIGHT
16519
16520 =back
16521
16522 =head2 List::Util - A selection of general-utility list subroutines
16523
16524 =over 4
16525
16526 =item SYNOPSIS
16527
16528 =item DESCRIPTION
16529
16530 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
16531 BLOCK LIST, shuffle LIST, sum LIST
16532
16533 =item KNOWN BUGS
16534
16535 =item SUGGESTED ADDITIONS
16536
16537 =item COPYRIGHT
16538
16539 =back
16540
16541 =head2 List::Utilib::List::Util, List::Util - A selection of
16542 general-utility list subroutines
16543
16544 =over 4
16545
16546 =item SYNOPSIS
16547
16548 =item DESCRIPTION
16549
16550 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
16551 BLOCK LIST, shuffle LIST, sum LIST
16552
16553 =item KNOWN BUGS
16554
16555 =item SUGGESTED ADDITIONS
16556
16557 =item COPYRIGHT
16558
16559 =back
16560
16561 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
16562 general-utility scalar subroutines
16563
16564 =over 4
16565
16566 =item SYNOPSIS
16567
16568 =item DESCRIPTION
16569
16570 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
16571 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
16572 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
16573
16574 =item KNOWN BUGS
16575
16576 =item COPYRIGHT
16577
16578 =item BLATANT PLUG
16579
16580 =back
16581
16582 =head2 Locale::Constants - constants for Locale codes
16583
16584 =over 4
16585
16586 =item SYNOPSIS
16587
16588 =item DESCRIPTION
16589
16590 =item KNOWN BUGS AND LIMITATIONS
16591
16592 =item SEE ALSO
16593
16594 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
16595
16596 =item AUTHOR
16597
16598 =item COPYRIGHT
16599
16600 =back
16601
16602 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
16603
16604 =over 4
16605
16606 =item SYNOPSIS
16607
16608 =item DESCRIPTION
16609
16610 B<alpha-2>, B<alpha-3>, B<numeric>
16611
16612 =item CONVERSION ROUTINES
16613
16614 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
16615 country_code2code( CODE, CODESET, CODESET )
16616
16617 =item QUERY ROUTINES
16618
16619 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
16620
16621 =item SEMI-PRIVATE ROUTINES
16622
16623 =over 4
16624
16625 =item alias_code
16626
16627 =item rename_country
16628
16629 =back
16630
16631 =item EXAMPLES
16632
16633 =item DOMAIN NAMES
16634
16635 =item KNOWN BUGS AND LIMITATIONS
16636
16637 =item SEE ALSO
16638
16639 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
16640 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
16641 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
16642 http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
16643
16644 =item AUTHOR
16645
16646 =item COPYRIGHT
16647
16648 =back
16649
16650 =head2 Locale::Currency - ISO three letter codes for currency
16651 identification (ISO 4217)
16652
16653 =over 4
16654
16655 =item SYNOPSIS
16656
16657 =item DESCRIPTION
16658
16659 XTS, XXX
16660
16661 =item CONVERSION ROUTINES
16662
16663 code2currency(), currency2code()
16664
16665 =item QUERY ROUTINES
16666
16667 C<all_currency_codes()>, C<all_currency_names()>
16668
16669 =item EXAMPLES
16670
16671 =item KNOWN BUGS AND LIMITATIONS
16672
16673 =item SEE ALSO
16674
16675 Locale::Country, Locale::Script, ISO 4217:1995,
16676 http://www.bsi-global.com/iso4217currency
16677
16678 =item AUTHOR
16679
16680 =item COPYRIGHT
16681
16682 =back
16683
16684 =head2 Locale::Language - ISO two letter codes for language identification
16685 (ISO 639)
16686
16687 =over 4
16688
16689 =item SYNOPSIS
16690
16691 =item DESCRIPTION
16692
16693 =item CONVERSION ROUTINES
16694
16695 code2language(), language2code()
16696
16697 =item QUERY ROUTINES
16698
16699 C<all_language_codes()>, C<all_language_names()>
16700
16701 =item EXAMPLES
16702
16703 =item KNOWN BUGS AND LIMITATIONS
16704
16705 =item SEE ALSO
16706
16707 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
16708 http://lcweb.loc.gov/standards/iso639-2/langhome.html
16709
16710 =item AUTHOR
16711
16712 =item COPYRIGHT
16713
16714 =back
16715
16716 =head2 Locale::Maketext - framework for localization
16717
16718 =over 4
16719
16720 =item SYNOPSIS
16721
16722 =item DESCRIPTION
16723
16724 =item QUICK OVERVIEW
16725
16726 =item METHODS
16727
16728 =over 4
16729
16730 =item Construction Methods
16731
16732 =item The "maketext" Method
16733
16734 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
16735
16736 =item Utility Methods
16737
16738 $language->quant($number, $singular), $language->quant($number, $singular,
16739 $plural), $language->quant($number, $singular, $plural, $negative),
16740 $language->numf($number), $language->sprintf($format, @items),
16741 $language->language_tag(), $language->encoding()
16742
16743 =item Language Handle Attributes and Internals
16744
16745 =back
16746
16747 =item LANGUAGE CLASS HIERARCHIES
16748
16749 =item ENTRIES IN EACH LEXICON
16750
16751 =item BRACKET NOTATION
16752
16753 =item AUTO LEXICONS
16754
16755 =item CONTROLLING LOOKUP FAILURE
16756
16757 =item HOW TO USE MAKETEXT
16758
16759 =item SEE ALSO
16760
16761 =item COPYRIGHT AND DISCLAIMER
16762
16763 =item AUTHOR
16764
16765 =back
16766
16767 =head2 Locale::Maketext::TPJ13 -- article about software localization
16768
16769 =over 4
16770
16771 =item SYNOPSIS
16772
16773 =item DESCRIPTION
16774
16775 =item Localization and Perl: gettext breaks, Maketext fixes
16776
16777 =over 4
16778
16779 =item A Localization Horror Story: It Could Happen To You
16780
16781 =item The Linguistic View
16782
16783 =item Breaking gettext
16784
16785 =item Replacing gettext
16786
16787 =item Buzzwords: Abstraction and Encapsulation
16788
16789 =item Buzzword: Isomorphism
16790
16791 =item Buzzword: Inheritance
16792
16793 =item Buzzword: Concision
16794
16795 =item The Devil in the Details
16796
16797 =item The Proof in the Pudding: Localizing Web Sites
16798
16799 =item References
16800
16801 =back
16802
16803 =back
16804
16805 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
16806
16807 =over 4
16808
16809 =item SYNOPSIS
16810
16811 =item DESCRIPTION
16812
16813 B<alpha-2>, B<alpha-3>, B<numeric>
16814
16815 =over 4
16816
16817 =item SPECIAL CODES
16818
16819 =back
16820
16821 =item CONVERSION ROUTINES
16822
16823 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
16824 script_code2code( CODE, CODESET, CODESET )
16825
16826 =item QUERY ROUTINES
16827
16828 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
16829
16830 =item EXAMPLES
16831
16832 =item KNOWN BUGS AND LIMITATIONS
16833
16834 =item SEE ALSO
16835
16836 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
16837 http://www.evertype.com/standards/iso15924/
16838
16839 =item AUTHOR
16840
16841 =item COPYRIGHT
16842
16843 =back
16844
16845 =head2 MIME::Base64 - Encoding and decoding of base64 strings
16846
16847 =over 4
16848
16849 =item SYNOPSIS
16850
16851 =item DESCRIPTION
16852
16853 encode_base64($str), encode_base64($str, $eol);, decode_base64($str)
16854
16855 =item DIAGNOSTICS
16856
16857 Premature end of base64 data, Premature padding of base64 data
16858
16859 =item EXAMPLES
16860
16861 =item COPYRIGHT
16862
16863 =item SEE ALSO
16864
16865 =back
16866
16867 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
16868 of quoted-printable strings
16869
16870 =over 4
16871
16872 =item SYNOPSIS
16873
16874 =item DESCRIPTION
16875
16876 encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode),
16877 decode_qp($str);
16878
16879 =item COPYRIGHT
16880
16881 =item SEE ALSO
16882
16883 =back
16884
16885 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
16886 strings
16887
16888 =over 4
16889
16890 =item SYNOPSIS
16891
16892 =item DESCRIPTION
16893
16894 encode_qp($str), encode_qp($str, $eol), encode_qp($str, $eol, $binmode),
16895 decode_qp($str);
16896
16897 =item COPYRIGHT
16898
16899 =item SEE ALSO
16900
16901 =back
16902
16903 =head2 Math::BigFloat - Arbitrary size floating point math package
16904
16905 =over 4
16906
16907 =item SYNOPSIS
16908
16909 =item DESCRIPTION
16910
16911 =over 4
16912
16913 =item Canonical notation
16914
16915 =item Output
16916
16917 =item C<mantissa()>, C<exponent()> and C<parts()>
16918
16919 =item Accuracy vs. Precision
16920
16921 =item Rounding
16922
16923 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
16924 ), fround  ( -$scale ) and fround ( 0 )
16925
16926 =back
16927
16928 =item EXAMPLES
16929
16930   # not ready yet
16931
16932 =item Autocreating constants
16933
16934 =over 4
16935
16936 =item Math library
16937
16938 =item Using Math::BigInt::Lite
16939
16940 =back
16941
16942 =item BUGS
16943
16944 =item CAVEATS
16945
16946 stringify, bstr(), bdiv, Modifying and =, bpow
16947
16948 =item SEE ALSO
16949
16950 =item LICENSE
16951
16952 =item AUTHORS
16953
16954 =back
16955
16956 =head2 Math::BigInt - Arbitrary size integer math package
16957
16958 =over 4
16959
16960 =item SYNOPSIS
16961
16962 =item DESCRIPTION
16963
16964 Input, Output
16965
16966 =item METHODS
16967
16968 =over 4
16969
16970 =item config
16971
16972 =item accuracy
16973
16974 =item precision
16975
16976 =item brsft
16977
16978 =item new
16979
16980 =item bnan
16981
16982 =item bzero
16983
16984 =item binf
16985
16986 =item bone
16987
16988 =item is_one()/is_zero()/is_nan()/is_inf()
16989
16990 =item is_pos()/is_neg()
16991
16992         $x->is_pos();                   # true if >= 0
16993         $x->is_neg();                   # true if <  0
16994
16995 =item is_odd()/is_even()/is_int()
16996
16997 =item bcmp
16998
16999 =item bacmp
17000
17001 =item sign
17002
17003 =item digit
17004
17005 =item bneg
17006
17007 =item babs
17008
17009 =item bnorm
17010
17011 =item bnot
17012
17013 =item binc
17014
17015 =item bdec
17016
17017 =item badd
17018
17019 =item bsub
17020
17021 =item bmul
17022
17023 =item bdiv
17024
17025 =item bmod
17026
17027 =item bmodinv
17028
17029 =item bmodpow
17030
17031 =item bpow
17032
17033 =item blsft
17034
17035 =item brsft
17036
17037 =item band
17038
17039 =item bior
17040
17041 =item bxor
17042
17043 =item bnot
17044
17045 =item bsqrt
17046
17047 =item bfac
17048
17049 =item round
17050
17051 =item bround
17052
17053 =item bfround
17054
17055 =item bfloor
17056
17057 =item bceil
17058
17059 =item bgcd
17060
17061 =item blcm
17062
17063 =item exponent
17064
17065 =item mantissa
17066
17067 =item parts
17068
17069 =item copy
17070
17071 =item as_int
17072
17073 =item bsstr
17074
17075 =item as_hex
17076
17077 =item as_bin
17078
17079 =back
17080
17081 =item ACCURACY and PRECISION
17082
17083 =over 4
17084
17085 =item Precision P
17086
17087 =item Accuracy A
17088
17089 =item Fallback F
17090
17091 =item Rounding mode R
17092
17093 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
17094 (significant digits), Setting/Accessing, Creating numbers, Usage,
17095 Precedence, Overriding globals, Local settings, Rounding, Default values,
17096 Remarks
17097
17098 =back
17099
17100 =item INTERNALS
17101
17102 =over 4
17103
17104 =item MATH LIBRARY
17105
17106 =item SIGN
17107
17108 =item mantissa(), exponent() and parts()
17109
17110 =back
17111
17112 =item EXAMPLES
17113
17114   use Math::BigInt;
17115
17116 =item Autocreating constants
17117
17118 =item PERFORMANCE
17119
17120 =over 4
17121
17122 =item Alternative math libraries
17123
17124 =item SUBCLASSING
17125
17126 =back
17127
17128 =item Subclassing Math::BigInt
17129
17130 =item UPGRADING
17131
17132 =over 4
17133
17134 =item Auto-upgrade
17135
17136 bsqrt(), div(), blog()
17137
17138 =back
17139
17140 =item BUGS
17141
17142 broot() does not work, Out of Memory!, Fails to load Calc on Perl prior
17143 5.6.0
17144
17145 =item CAVEATS
17146
17147 bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity handling,
17148 Modifying and =, bpow, Overloading -$x, Mixing different object types,
17149 bsqrt(), brsft()
17150
17151 =item LICENSE
17152
17153 =item SEE ALSO
17154
17155 =item AUTHORS
17156
17157 =back
17158
17159 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
17160
17161 =over 4
17162
17163 =item SYNOPSIS
17164
17165 =item DESCRIPTION
17166
17167 =item STORAGE
17168
17169 =item METHODS
17170
17171 =item WRAP YOUR OWN
17172
17173 =item LICENSE
17174
17175 This program is free software; you may redistribute it and/or modify it
17176 under
17177 the same terms as Perl itself. 
17178
17179 =item AUTHORS
17180
17181 =item SEE ALSO
17182
17183 =back
17184
17185 =head2 Math::BigInt::CalcEmu - Emulate low-level math with BigInt code
17186
17187 =over 4
17188
17189 =item SYNOPSIS
17190
17191 =item DESCRIPTION
17192
17193 =item METHODS
17194
17195 =item LICENSE
17196
17197 This program is free software; you may redistribute it and/or modify it
17198 under
17199 the same terms as Perl itself. 
17200
17201 =item AUTHORS
17202
17203 =item SEE ALSO
17204
17205 =back
17206
17207 =head2 Math::BigRat - arbitrarily big rational numbers
17208
17209 =over 4
17210
17211 =item SYNOPSIS
17212
17213 =item DESCRIPTION
17214
17215 =over 4
17216
17217 =item MATH LIBRARY
17218
17219 =back
17220
17221 =item METHODS
17222
17223 =over 4
17224
17225 =item new()
17226
17227 =item numerator()
17228
17229 =item denominator()
17230
17231         $d = $x->denominator();
17232
17233 =item parts()
17234
17235 =item as_number()
17236
17237 =item bfac()
17238
17239 =item blog()
17240
17241 =item bround()/round()/bfround()
17242
17243 =item bmod()
17244
17245 =item is_one()
17246
17247 =item is_zero()
17248
17249 =item is_positive()
17250
17251 =item is_negative()
17252
17253 =item is_int()
17254
17255 =item is_odd()
17256
17257 =item is_even()
17258
17259 =item bceil()
17260
17261 =item bfloor()
17262
17263         $x->bfloor();
17264
17265 =item bsqrt()
17266
17267         $x->bsqrt();
17268
17269 =item config
17270
17271 =back
17272
17273 =item BUGS
17274
17275 inf handling (partial), NaN handling (partial), rounding (not implemented
17276 except for bceil/bfloor), $x ** $y where $y is not an integer, bmod(),
17277 blog(), bmodinv() and bmodpow() (partial)
17278
17279 =item LICENSE
17280
17281 =item SEE ALSO
17282
17283 =item AUTHORS
17284
17285 =back
17286
17287 =head2 Math::Complex - complex numbers and associated mathematical
17288 functions
17289
17290 =over 4
17291
17292 =item SYNOPSIS
17293
17294 =item DESCRIPTION
17295
17296 =item OPERATIONS
17297
17298 =item CREATION
17299
17300 =item STRINGIFICATION
17301
17302 =over 4
17303
17304 =item CHANGED IN PERL 5.6
17305
17306 =back
17307
17308 =item USAGE
17309
17310 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
17311
17312 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
17313
17314 =item BUGS
17315
17316 =item AUTHORS
17317
17318 =back
17319
17320 =head2 Math::Trig - trigonometric functions
17321
17322 =over 4
17323
17324 =item SYNOPSIS
17325
17326 =item DESCRIPTION
17327
17328 =item TRIGONOMETRIC FUNCTIONS
17329
17330 B<tan>
17331
17332 =over 4
17333
17334 =item ERRORS DUE TO DIVISION BY ZERO
17335
17336 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
17337
17338 =back
17339
17340 =item PLANE ANGLE CONVERSIONS
17341
17342 =item RADIAL COORDINATE CONVERSIONS
17343
17344 =over 4
17345
17346 =item COORDINATE SYSTEMS
17347
17348 =item 3-D ANGLE CONVERSIONS
17349
17350 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
17351 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
17352
17353 =back
17354
17355 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
17356
17357 =item EXAMPLES
17358
17359 =over 4
17360
17361 =item CAVEAT FOR GREAT CIRCLE FORMULAS
17362
17363 =back
17364
17365 =item BUGS
17366
17367 =item AUTHORS
17368
17369 =back
17370
17371 =head2 Memoize - Make functions faster by trading space for time
17372
17373 =over 4
17374
17375 =item SYNOPSIS
17376
17377 =item DESCRIPTION
17378
17379 =item DETAILS
17380
17381 =item OPTIONS
17382
17383 =over 4
17384
17385 =item INSTALL
17386
17387 =item NORMALIZER
17388
17389 =item C<SCALAR_CACHE>, C<LIST_CACHE>
17390
17391 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
17392
17393 =back
17394
17395 =item OTHER FACILITIES
17396
17397 =over 4
17398
17399 =item C<unmemoize>
17400
17401 =item C<flush_cache>
17402
17403 =back
17404
17405 =item CAVEATS
17406
17407 =item PERSISTENT CACHE SUPPORT
17408
17409 =item EXPIRATION SUPPORT
17410
17411 =item BUGS
17412
17413 =item MAILING LIST
17414
17415 =item AUTHOR
17416
17417 =item COPYRIGHT AND LICENSE
17418
17419 =item THANK YOU
17420
17421 =back
17422
17423 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
17424 Storable use
17425
17426 =over 4
17427
17428 =item DESCRIPTION
17429
17430 =back
17431
17432 =head2 Memoize::Expire - Plug-in module for automatic expiration of
17433 memoized values
17434
17435 =over 4
17436
17437 =item SYNOPSIS
17438
17439 =item DESCRIPTION
17440
17441 =item INTERFACE
17442
17443  TIEHASH,  EXISTS,  STORE
17444
17445 =item ALTERNATIVES
17446
17447 =item CAVEATS
17448
17449 =item AUTHOR
17450
17451 =item SEE ALSO
17452
17453 =back
17454
17455 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
17456
17457 =over 4
17458
17459 =item DESCRIPTION
17460
17461 =back
17462
17463 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
17464
17465 =over 4
17466
17467 =item DESCRIPTION
17468
17469 =back
17470
17471 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
17472 Storable use
17473
17474 =over 4
17475
17476 =item DESCRIPTION
17477
17478 =back
17479
17480 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
17481 Storable use
17482
17483 =over 4
17484
17485 =item DESCRIPTION
17486
17487 =back
17488
17489 =head2 Memoize::Storable - store Memoized data in Storable database
17490
17491 =over 4
17492
17493 =item DESCRIPTION
17494
17495 =back
17496
17497 =head2 NDBM_File - Tied access to ndbm files
17498
17499 =over 4
17500
17501 =item SYNOPSIS
17502
17503 =item DESCRIPTION
17504
17505 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17506
17507 =item DIAGNOSTICS
17508
17509 =over 4
17510
17511 =item C<ndbm store returned -1, errno 22, key "..." at ...>
17512
17513 =back
17514
17515 =item BUGS AND WARNINGS
17516
17517 =back
17518
17519 =head2 NEXT - Provide a pseudo-class NEXT (et al) that allows method
17520 redispatch
17521
17522 =over 4
17523
17524 =item SYNOPSIS
17525
17526 =item DESCRIPTION
17527
17528 =over 4
17529
17530 =item Enforcing redispatch
17531
17532 =item Avoiding repetitions
17533
17534 =item Invoking all versions of a method with a single call
17535
17536 =item Using C<EVERY> methods
17537
17538 =back
17539
17540 =item AUTHOR
17541
17542 =item BUGS AND IRRITATIONS
17543
17544 =item COPYRIGHT
17545
17546 =back
17547
17548 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
17549
17550 =over 4
17551
17552 =item SYNOPSIS
17553
17554 =item DESCRIPTION
17555
17556 =item USER METHODS
17557
17558 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
17559 dataend ()
17560
17561 =item CLASS METHODS
17562
17563 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
17564 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
17565 ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh ()
17566
17567 =item EXPORTS
17568
17569 =item AUTHOR
17570
17571 =item COPYRIGHT
17572
17573 =back
17574
17575 =head2 Net::Config - Local configuration data for libnet
17576
17577 =over 4
17578
17579 =item SYNOPSYS
17580
17581 =item DESCRIPTION
17582
17583 =item METHODS
17584
17585 requires_firewall HOST
17586
17587 =item NetConfig VALUES
17588
17589 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
17590 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
17591 ftp_int_pasive, local_netmask, test_hosts, test_exists
17592
17593 =back
17594
17595 =head2 Net::Domain - Attempt to evaluate the current host's internet name
17596 and domain
17597
17598 =over 4
17599
17600 =item SYNOPSIS
17601
17602 =item DESCRIPTION
17603
17604 hostfqdn (), hostname (), hostdomain ()
17605
17606 =item AUTHOR
17607
17608 =item COPYRIGHT
17609
17610 =back
17611
17612 =head2 Net::FTP - FTP Client class
17613
17614 =over 4
17615
17616 =item SYNOPSIS
17617
17618 =item DESCRIPTION
17619
17620 =item OVERVIEW
17621
17622 =item CONSTRUCTOR
17623
17624 new ([ HOST ] [, OPTIONS ])
17625
17626 =item METHODS
17627
17628 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
17629 site (ARGS), ascii, binary, rename ( OLDNAME, NEWNAME ), delete ( FILENAME
17630 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR [,
17631 RECURSE ]), mkdir ( DIR [, RECURSE ]), alloc ( SIZE [, RECORD_SIZE] ), ls (
17632 [ DIR ] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ),
17633 put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE
17634 ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ),
17635 size ( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[
17636 BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ DIR ] ), retr ( FILE ),
17637 stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [ PORT ] ), pasv (),
17638 pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_xfer_unique (
17639 SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( NON_PASV_SERVER ),
17640 abort (), quit ()
17641
17642 =over 4
17643
17644 =item Methods for the adventurous
17645
17646 quot (CMD [,ARGS])
17647
17648 =back
17649
17650 =item THE dataconn CLASS
17651
17652 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
17653 bytes_read (), abort (), close ()
17654
17655 =item UNIMPLEMENTED
17656
17657 B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
17658
17659 =item REPORTING BUGS
17660
17661 =item AUTHOR
17662
17663 =item SEE ALSO
17664
17665 =item USE EXAMPLES
17666
17667 http://www.csh.rit.edu/~adam/Progs/
17668
17669 =item CREDITS
17670
17671 =item COPYRIGHT
17672
17673 =back
17674
17675 =head2 Net::NNTP - NNTP Client class
17676
17677 =over 4
17678
17679 =item SYNOPSIS
17680
17681 =item DESCRIPTION
17682
17683 =item CONSTRUCTOR
17684
17685 new ( [ HOST ] [, OPTIONS ])
17686
17687 =item METHODS
17688
17689 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
17690 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
17691 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
17692 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
17693 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
17694 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
17695 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
17696
17697 =over 4
17698
17699 =item Extension methods
17700
17701 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
17702 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
17703 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
17704 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
17705 GROUP ] ), reader
17706
17707 =back
17708
17709 =item UNSUPPORTED
17710
17711 =item DEFINITIONS
17712
17713 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
17714
17715 =item SEE ALSO
17716
17717 =item AUTHOR
17718
17719 =item COPYRIGHT
17720
17721 =back
17722
17723 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
17724
17725 =over 4
17726
17727 =item SYNOPSIS
17728
17729 =item DESCRIPTION
17730
17731 =item CONSTRUCTOR
17732
17733 new ( [ HOST ] [, OPTIONS ] 0
17734
17735 =item METHODS
17736
17737 auth ( USERNAME, PASSWORD ), user ( USER ), pass ( PASS ), login ( [ USER
17738 [, PASS ]] ), apop ( [ USER [, PASS ]] ), banner (), capa (),  capabilities
17739 (), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM [, FH ]
17740 ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [ MSGNUM ]
17741 ), delete ( MSGNUM ), reset (), quit ()
17742
17743 =item NOTES
17744
17745 =item SEE ALSO
17746
17747 =item AUTHOR
17748
17749 =item COPYRIGHT
17750
17751 =back
17752
17753 =head2 Net::Ping - check a remote host for reachability
17754
17755 =over 4
17756
17757 =item SYNOPSIS
17758
17759 =item DESCRIPTION
17760
17761 =over 4
17762
17763 =item Functions
17764
17765 Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos
17766 ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
17767 $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
17768 $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
17769 [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host
17770 [, $timeout]);
17771
17772 =back
17773
17774 =item NOTES
17775
17776 =item INSTALL
17777
17778 =item BUGS
17779
17780 =item AUTHORS
17781
17782 =item COPYRIGHT
17783
17784 =back
17785
17786 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
17787
17788 =over 4
17789
17790 =item SYNOPSIS
17791
17792 =item DESCRIPTION
17793
17794 =item EXAMPLES
17795
17796 =item CONSTRUCTOR
17797
17798 new ( [ HOST ] [, OPTIONS ] )
17799
17800 =item METHODS
17801
17802 banner (), domain (), hello ( DOMAIN ), host (), etrn ( DOMAIN ), auth (
17803 USERNAME, PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ),
17804 send_or_mail ( ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient (
17805 ADDRESS [, ADDRESS, [...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]]
17806 ), cc ( ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ),
17807 data ( [ DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [
17808 $subject ] ), quit ()
17809
17810 =item ADDRESSES
17811
17812 =item SEE ALSO
17813
17814 =item AUTHOR
17815
17816 =item COPYRIGHT
17817
17818 =back
17819
17820 =head2 Net::Time - time and daytime network client interface
17821
17822 =over 4
17823
17824 =item SYNOPSIS
17825
17826 =item DESCRIPTION
17827
17828 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
17829 PROTOCOL [, TIMEOUT]]])
17830
17831 =item AUTHOR
17832
17833 =item COPYRIGHT
17834
17835 =back
17836
17837 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
17838 functions
17839
17840 =over 4
17841
17842 =item SYNOPSIS
17843
17844 =item DESCRIPTION
17845
17846 =item EXAMPLES
17847
17848 =item NOTE
17849
17850 =item AUTHOR
17851
17852 =back
17853
17854 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
17855
17856 =over 4
17857
17858 =item DESCRIPTION
17859
17860 =over 4
17861
17862 =item Where to get this document
17863
17864 =item How to contribute to this document
17865
17866 =back
17867
17868 =item Author and Copyright Information
17869
17870 =over 4
17871
17872 =item Disclaimer
17873
17874 =back
17875
17876 =item Obtaining and installing libnet
17877
17878 =over 4
17879
17880 =item What is libnet ?
17881
17882 =item Which version of perl do I need ?
17883
17884 =item What other modules do I need ?
17885
17886 =item What machines support libnet ?
17887
17888 =item Where can I get the latest libnet release
17889
17890 =back
17891
17892 =item Using Net::FTP
17893
17894 =over 4
17895
17896 =item How do I download files from an FTP server ?
17897
17898 =item How do I transfer files in binary mode ?
17899
17900 =item How can I get the size of a file on a remote FTP server ?
17901
17902 =item How can I get the modification time of a file on a remote FTP server
17903 ?
17904
17905 =item How can I change the permissions of a file on a remote server ?
17906
17907 =item Can I do a reget operation like the ftp command ?
17908
17909 =item How do I get a directory listing from an FTP server ?
17910
17911 =item Changing directory to "" does not fail ?
17912
17913 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
17914
17915 =item I am behind an FTP proxy firewall, but cannot access machines outside
17916 ?
17917
17918 =item My ftp proxy firewall does not listen on port 21
17919
17920 =item Is it possible to change the file permissions of a file on an FTP
17921 server ?
17922
17923 =item I have seen scripts call a method message, but cannot find it
17924 documented ?
17925
17926 =item Why does Net::FTP not implement mput and mget methods
17927
17928 =back
17929
17930 =item Using Net::SMTP
17931
17932 =over 4
17933
17934 =item Why can't the part of an Email address after the @ be used as the
17935 hostname ?
17936
17937 =item Why does Net::SMTP not do DNS MX lookups ?
17938
17939 =item The verify method always returns true ?
17940
17941 =back
17942
17943 =item Debugging scripts
17944
17945 =over 4
17946
17947 =item How can I debug my scripts that use Net::* modules ?
17948
17949 =back
17950
17951 =item AUTHOR AND COPYRIGHT
17952
17953 =back
17954
17955 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
17956 functions
17957
17958 =over 4
17959
17960 =item SYNOPSIS
17961
17962 =item DESCRIPTION
17963
17964 =item EXAMPLES
17965
17966 =item NOTE
17967
17968 =item AUTHOR
17969
17970 =back
17971
17972 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
17973 functions
17974
17975 =over 4
17976
17977 =item SYNOPSIS
17978
17979 =item DESCRIPTION
17980
17981 =item NOTE
17982
17983 =item AUTHOR
17984
17985 =back
17986
17987 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
17988 functions
17989
17990 =over 4
17991
17992 =item SYNOPSIS
17993
17994 =item DESCRIPTION
17995
17996 =item EXAMPLES
17997
17998 =item NOTE
17999
18000 =item AUTHOR
18001
18002 =back
18003
18004 =head2 Netrc, Net::Netrc - OO interface to users netrc file
18005
18006 =over 4
18007
18008 =item SYNOPSIS
18009
18010 =item DESCRIPTION
18011
18012 =item THE .netrc FILE
18013
18014 machine name, default, login name, password string, account string, macdef
18015 name
18016
18017 =item CONSTRUCTOR
18018
18019 lookup ( MACHINE [, LOGIN ])
18020
18021 =item METHODS
18022
18023 login (), password (), account (), lpa ()
18024
18025 =item AUTHOR
18026
18027 =item SEE ALSO
18028
18029 =item COPYRIGHT
18030
18031 =back
18032
18033 =head2 O - Generic interface to Perl Compiler backends
18034
18035 =over 4
18036
18037 =item SYNOPSIS
18038
18039 =item DESCRIPTION
18040
18041 =item CONVENTIONS
18042
18043 =item IMPLEMENTATION
18044
18045 =item BUGS
18046
18047 =item AUTHOR
18048
18049 =back
18050
18051 =head2 ODBM_File - Tied access to odbm files
18052
18053 =over 4
18054
18055 =item SYNOPSIS
18056
18057 =item DESCRIPTION
18058
18059 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
18060
18061 =item DIAGNOSTICS
18062
18063 =over 4
18064
18065 =item C<odbm store returned -1, errno 22, key "..." at ...>
18066
18067 =back
18068
18069 =item BUGS AND WARNINGS
18070
18071 =back
18072
18073 =head2 Opcode - Disable named opcodes when compiling perl code
18074
18075 =over 4
18076
18077 =item SYNOPSIS
18078
18079 =item DESCRIPTION
18080
18081 =item NOTE
18082
18083 =item WARNING
18084
18085 =item Operator Names and Operator Lists
18086
18087 an operator name (opname), an operator tag name (optag), a negated opname
18088 or optag, an operator set (opset)
18089
18090 =item Opcode Functions
18091
18092 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
18093 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
18094 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
18095 opdump (PAT)
18096
18097 =item Manipulating Opsets
18098
18099 =item TO DO (maybe)
18100
18101 =back
18102
18103 =over 4
18104
18105 =item Predefined Opcode Tags
18106
18107 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
18108 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
18109 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
18110 :dangerous
18111
18112 =item SEE ALSO
18113
18114 =item AUTHORS
18115
18116 =back
18117
18118 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
18119 compartments
18120
18121 =over 4
18122
18123 =item SYNOPSIS
18124
18125 =item DESCRIPTION
18126
18127 a new namespace, an operator mask
18128
18129 =item WARNING
18130
18131 =over 4
18132
18133 =item RECENT CHANGES
18134
18135 =item Methods in class Safe
18136
18137 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
18138 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
18139 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
18140 root (NAMESPACE), mask (MASK)
18141
18142 =item Some Safety Issues
18143
18144 Memory, CPU, Snooping, Signals, State Changes
18145
18146 =item AUTHOR
18147
18148 =back
18149
18150 =back
18151
18152 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
18153 compiling
18154
18155 =over 4
18156
18157 =item SYNOPSIS  
18158
18159 =item DESCRIPTION
18160
18161 =item SEE ALSO
18162
18163 =back
18164
18165 =head2 POSIX - Perl interface to IEEE Std 1003.1
18166
18167 =over 4
18168
18169 =item SYNOPSIS
18170
18171 =item DESCRIPTION
18172
18173 =item NOTE
18174
18175 =item CAVEATS 
18176
18177 =item FUNCTIONS
18178
18179 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
18180 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
18181 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
18182 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
18183 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
18184 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
18185 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
18186 fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv,
18187 geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid,
18188 getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha,
18189 isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace,
18190 isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime,
18191 log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr,
18192 memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice,
18193 offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc,
18194 putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename,
18195 rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid,
18196 setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
18197 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
18198 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
18199 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
18200 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
18201 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
18202 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
18203 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
18204 wctomb, write
18205
18206 =item CLASSES
18207
18208 =over 4
18209
18210 =item POSIX::SigAction
18211
18212 new, handler, mask, flags, safe
18213
18214 =item POSIX::SigSet
18215
18216 new, addset, delset, emptyset, fillset, ismember
18217
18218 =item POSIX::Termios
18219
18220 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
18221 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
18222 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
18223 field values, c_cflag field values, c_iflag field values, c_lflag field
18224 values, c_oflag field values
18225
18226 =back
18227
18228 =item PATHNAME CONSTANTS
18229
18230 Constants
18231
18232 =item POSIX CONSTANTS
18233
18234 Constants
18235
18236 =item SYSTEM CONFIGURATION
18237
18238 Constants
18239
18240 =item ERRNO
18241
18242 Constants
18243
18244 =item FCNTL
18245
18246 Constants
18247
18248 =item FLOAT
18249
18250 Constants
18251
18252 =item LIMITS
18253
18254 Constants
18255
18256 =item LOCALE
18257
18258 Constants
18259
18260 =item MATH
18261
18262 Constants
18263
18264 =item SIGNAL
18265
18266 Constants
18267
18268 =item STAT
18269
18270 Constants, Macros
18271
18272 =item STDLIB
18273
18274 Constants
18275
18276 =item STDIO
18277
18278 Constants
18279
18280 =item TIME
18281
18282 Constants
18283
18284 =item UNISTD
18285
18286 Constants
18287
18288 =item WAIT
18289
18290 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
18291 WTERMSIG, WIFSTOPPED, WSTOPSIG
18292
18293 =back
18294
18295 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
18296 name space
18297
18298 =over 4
18299
18300 =item SYNOPSIS
18301
18302 =item DESCRIPTION
18303
18304 :unix, :stdio, :perlio, :crlf, :mmap, :utf8, :bytes, :raw, :pop, :win32
18305
18306 =over 4
18307
18308 =item Custom Layers
18309
18310 :encoding, :via
18311
18312 =item Alternatives to raw
18313
18314 =item Defaults and how to override them
18315
18316 =item Querying the layers of filehandles
18317
18318 =back
18319
18320 =item AUTHOR
18321
18322 =item SEE ALSO
18323
18324 =back
18325
18326 =head2 PerlIO::encoding - encoding layer
18327
18328 =over 4
18329
18330 =item SYNOPSIS
18331
18332 =item DESCRIPTION
18333
18334 =item SEE ALSO
18335
18336 =back
18337
18338 =head2 PerlIO::scalar - in-memory IO, scalar IO
18339
18340 =over 4
18341
18342 =item SYNOPSIS
18343
18344 =item DESCRIPTION
18345
18346 =item IMPLEMENTATION NOTE
18347
18348 =back
18349
18350 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
18351
18352 =over 4
18353
18354 =item SYNOPSIS
18355
18356 =item DESCRIPTION
18357
18358 =item EXPECTED METHODS
18359
18360 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
18361 $obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]),
18362 $obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]),
18363 $obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh),
18364 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
18365 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
18366 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
18367 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
18368
18369 =item EXAMPLES
18370
18371 =over 4
18372
18373 =item Example - a Hexadecimal Handle
18374
18375 =back
18376
18377 =back
18378
18379 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
18380
18381 =over 4
18382
18383 =item SYNOPSIS
18384
18385 =item DESCRIPTION
18386
18387 =item REQUIRED MODULES
18388
18389 =item SEE ALSO
18390
18391 =item ACKNOWLEDGEMENTS
18392
18393 =item COPYRIGHT
18394
18395 =back
18396
18397 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
18398
18399 =over 4
18400
18401 =item SYNOPSIS
18402
18403 =item OPTIONS/ARGUMENTS
18404
18405 =over 4
18406
18407 =item podchecker()
18408
18409 B<-warnings> =E<gt> I<val>
18410
18411 =back
18412
18413 =item DESCRIPTION
18414
18415 =item DIAGNOSTICS
18416
18417 =over 4
18418
18419 =item Errors
18420
18421 empty =headn, =over on line I<N> without closing =back, =item without
18422 previous =over, =back without previous =over, No argument for =begin, =end
18423 without =begin, Nested =begin's, =for without formatter specification,
18424 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
18425 interior-sequence "I<SEQ>", nested commands
18426 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
18427 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
18428 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
18429 after =back
18430
18431 =item Warnings
18432
18433 multiple occurrence of link target I<name>, line containing nothing but
18434 whitespace in paragraph, file does not start with =head, previous =item has
18435 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
18436 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
18437 items in =over, No argument for =item, empty section in previous paragraph,
18438 Verbatim paragraph in NAME section, =headI<n> without preceding higher
18439 level
18440
18441 =item Hyperlinks
18442
18443 ignoring leading/trailing whitespace in link, (section) in '$page'
18444 deprecated, alternative text/node '%s' contains non-escaped | or /
18445
18446 =back
18447
18448 =item RETURN VALUE
18449
18450 =item EXAMPLES
18451
18452 =item INTERFACE
18453
18454 =back
18455
18456 C<Pod::Checker-E<gt>new( %options )>
18457
18458 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
18459 @args )>
18460
18461 C<$checker-E<gt>num_errors()>
18462
18463 C<$checker-E<gt>num_warnings()>
18464
18465 C<$checker-E<gt>name()>
18466
18467 C<$checker-E<gt>node()>
18468
18469 C<$checker-E<gt>idx()>
18470
18471 C<$checker-E<gt>hyperlink()>
18472
18473 =over 4
18474
18475 =item AUTHOR
18476
18477 =back
18478
18479 =head2 Pod::Find - find POD documents in directory trees
18480
18481 =over 4
18482
18483 =item SYNOPSIS
18484
18485 =item DESCRIPTION
18486
18487 =back
18488
18489 =over 4
18490
18491 =item C<pod_find( { %opts } , @directories )>
18492
18493 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
18494 1>
18495
18496 =back
18497
18498 =over 4
18499
18500 =item C<simplify_name( $str )>
18501
18502 =back
18503
18504 =over 4
18505
18506 =item C<pod_where( { %opts }, $pod )>
18507
18508 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
18509 1>
18510
18511 =back
18512
18513 =over 4
18514
18515 =item C<contains_pod( $file , $verbose )>
18516
18517 =back
18518
18519 =over 4
18520
18521 =item AUTHOR
18522
18523 =item SEE ALSO
18524
18525 =back
18526
18527 =head2 Pod::Html - module to convert pod files to HTML
18528
18529 =over 4
18530
18531 =item SYNOPSIS
18532
18533 =item DESCRIPTION
18534
18535 =item ARGUMENTS
18536
18537 backlink, cachedir, css, flush, header, help, hiddendirs, htmldir,
18538 htmlroot, index, infile, libpods, netscape, outfile, podpath, podroot,
18539 quiet, recurse, title, verbose
18540
18541 =item EXAMPLE
18542
18543 =item ENVIRONMENT
18544
18545 =item AUTHOR
18546
18547 =item SEE ALSO
18548
18549 =item COPYRIGHT
18550
18551 =back
18552
18553 =head2 Pod::InputObjects - objects representing POD input paragraphs,
18554 commands, etc.
18555
18556 =over 4
18557
18558 =item SYNOPSIS
18559
18560 =item REQUIRES
18561
18562 =item EXPORTS
18563
18564 =item DESCRIPTION
18565
18566 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
18567 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
18568
18569 =back
18570
18571 =over 4
18572
18573 =item B<Pod::InputSource>
18574
18575 =back
18576
18577 =over 4
18578
18579 =item B<new()>
18580
18581 =back
18582
18583 =over 4
18584
18585 =item B<name()>
18586
18587 =back
18588
18589 =over 4
18590
18591 =item B<handle()>
18592
18593 =back
18594
18595 =over 4
18596
18597 =item B<was_cutting()>
18598
18599 =back
18600
18601 =over 4
18602
18603 =item B<Pod::Paragraph>
18604
18605 =back
18606
18607 =over 4
18608
18609 =item Pod::Paragraph-E<gt>B<new()>
18610
18611 =back
18612
18613 =over 4
18614
18615 =item $pod_para-E<gt>B<cmd_name()>
18616
18617 =back
18618
18619 =over 4
18620
18621 =item $pod_para-E<gt>B<text()>
18622
18623 =back
18624
18625 =over 4
18626
18627 =item $pod_para-E<gt>B<raw_text()>
18628
18629 =back
18630
18631 =over 4
18632
18633 =item $pod_para-E<gt>B<cmd_prefix()>
18634
18635 =back
18636
18637 =over 4
18638
18639 =item $pod_para-E<gt>B<cmd_separator()>
18640
18641 =back
18642
18643 =over 4
18644
18645 =item $pod_para-E<gt>B<parse_tree()>
18646
18647 =back
18648
18649 =over 4
18650
18651 =item $pod_para-E<gt>B<file_line()>
18652
18653 =back
18654
18655 =over 4
18656
18657 =item B<Pod::InteriorSequence>
18658
18659 =back
18660
18661 =over 4
18662
18663 =item Pod::InteriorSequence-E<gt>B<new()>
18664
18665 =back
18666
18667 =over 4
18668
18669 =item $pod_seq-E<gt>B<cmd_name()>
18670
18671 =back
18672
18673 =over 4
18674
18675 =item $pod_seq-E<gt>B<prepend()>
18676
18677 =back
18678
18679 =over 4
18680
18681 =item $pod_seq-E<gt>B<append()>
18682
18683 =back
18684
18685 =over 4
18686
18687 =item $pod_seq-E<gt>B<nested()>
18688
18689 =back
18690
18691 =over 4
18692
18693 =item $pod_seq-E<gt>B<raw_text()>
18694
18695 =back
18696
18697 =over 4
18698
18699 =item $pod_seq-E<gt>B<left_delimiter()>
18700
18701 =back
18702
18703 =over 4
18704
18705 =item $pod_seq-E<gt>B<right_delimiter()>
18706
18707 =back
18708
18709 =over 4
18710
18711 =item $pod_seq-E<gt>B<parse_tree()>
18712
18713 =back
18714
18715 =over 4
18716
18717 =item $pod_seq-E<gt>B<file_line()>
18718
18719 =back
18720
18721 =over 4
18722
18723 =item Pod::InteriorSequence::B<DESTROY()>
18724
18725 =back
18726
18727 =over 4
18728
18729 =item B<Pod::ParseTree>
18730
18731 =back
18732
18733 =over 4
18734
18735 =item Pod::ParseTree-E<gt>B<new()>
18736
18737 =back
18738
18739 =over 4
18740
18741 =item $ptree-E<gt>B<top()>
18742
18743 =back
18744
18745 =over 4
18746
18747 =item $ptree-E<gt>B<children()>
18748
18749 =back
18750
18751 =over 4
18752
18753 =item $ptree-E<gt>B<prepend()>
18754
18755 =back
18756
18757 =over 4
18758
18759 =item $ptree-E<gt>B<append()>
18760
18761 =back
18762
18763 =over 4
18764
18765 =item $ptree-E<gt>B<raw_text()>
18766
18767 =back
18768
18769 =over 4
18770
18771 =item Pod::ParseTree::B<DESTROY()>
18772
18773 =back
18774
18775 =over 4
18776
18777 =item SEE ALSO
18778
18779 =item AUTHOR
18780
18781 =back
18782
18783 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
18784
18785 =over 4
18786
18787 =item SYNOPSIS
18788
18789 =item DESCRIPTION
18790
18791 =back
18792
18793 =over 4
18794
18795 =item OBJECT METHODS
18796
18797 C<initialize>
18798
18799 =back
18800
18801 =over 4
18802
18803 =item Data Accessors
18804
18805 B<AddPreamble>
18806
18807 =back
18808
18809 B<AddPostamble>
18810
18811 B<Head1Level>
18812
18813 B<Label>
18814
18815 B<LevelNoNum>
18816
18817 B<MakeIndex>
18818
18819 B<ReplaceNAMEwithSection>
18820
18821 B<StartWithNewPage>
18822
18823 B<TableOfContents>
18824
18825 B<UniqueLabels>
18826
18827 B<UserPreamble>
18828
18829 B<UserPostamble>
18830
18831 B<Lists>
18832
18833 =over 4
18834
18835 =item Subclassed methods
18836
18837 =back
18838
18839 B<begin_pod>
18840
18841 B<end_pod>
18842
18843 B<command>
18844
18845 B<verbatim>
18846
18847 B<textblock>
18848
18849 B<interior_sequence>
18850
18851 =over 4
18852
18853 =item List Methods
18854
18855 B<begin_list>
18856
18857 =back
18858
18859 B<end_list>
18860
18861 B<add_item>
18862
18863 =over 4
18864
18865 =item Methods for headings
18866
18867 B<head>
18868
18869 =back
18870
18871 =over 4
18872
18873 =item Internal methods
18874
18875 B<_output>
18876
18877 =back
18878
18879 B<_replace_special_chars>
18880
18881 B<_replace_special_chars_late>
18882
18883 B<_create_label>
18884
18885 B<_create_index>
18886
18887 B<_clean_latex_commands>
18888
18889 B<_split_delimited>
18890
18891 =over 4
18892
18893 =item NOTES
18894
18895 =item SEE ALSO
18896
18897 =item AUTHORS
18898
18899 =item COPYRIGHT
18900
18901 =item REVISION
18902
18903 =back
18904
18905 =head2 Pod::Man - Convert POD data to formatted *roff input
18906
18907 =over 4
18908
18909 =item SYNOPSIS
18910
18911 =item DESCRIPTION
18912
18913 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
18914 release, section
18915
18916 =item DIAGNOSTICS
18917
18918 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
18919 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
18920 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
18921 =back
18922
18923 =item BUGS
18924
18925 =item CAVEATS
18926
18927 =item SEE ALSO
18928
18929 =item AUTHOR
18930
18931 =item COPYRIGHT AND LICENSE
18932
18933 =back
18934
18935 =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
18936
18937 =over 4
18938
18939 =item SYNOPSIS
18940
18941 =item DESCRIPTION
18942
18943 =item SEE ALSO
18944
18945 =item AUTHOR
18946
18947 =item COPYRIGHT AND LICENSE
18948
18949 =back
18950
18951 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
18952
18953 =over 4
18954
18955 =item SYNOPSIS
18956
18957 =item DESCRIPTION
18958
18959 =back
18960
18961 =over 4
18962
18963 =item Pod::List
18964
18965 Pod::List-E<gt>new()
18966
18967 =back
18968
18969 $list-E<gt>file()
18970
18971 $list-E<gt>start()
18972
18973 $list-E<gt>indent()
18974
18975 $list-E<gt>type()
18976
18977 $list-E<gt>rx()
18978
18979 $list-E<gt>item()
18980
18981 $list-E<gt>parent()
18982
18983 $list-E<gt>tag()
18984
18985 =over 4
18986
18987 =item Pod::Hyperlink
18988
18989 Pod::Hyperlink-E<gt>new()
18990
18991 =back
18992
18993 $link-E<gt>parse($string)
18994
18995 $link-E<gt>markup($string)
18996
18997 $link-E<gt>text()
18998
18999 $link-E<gt>warning()
19000
19001 $link-E<gt>file(), $link-E<gt>line()
19002
19003 $link-E<gt>page()
19004
19005 $link-E<gt>node()
19006
19007 $link-E<gt>alttext()
19008
19009 $link-E<gt>type()
19010
19011 $link-E<gt>link()
19012
19013 =over 4
19014
19015 =item Pod::Cache
19016
19017 Pod::Cache-E<gt>new()
19018
19019 =back
19020
19021 $cache-E<gt>item()
19022
19023 $cache-E<gt>find_page($name)
19024
19025 =over 4
19026
19027 =item Pod::Cache::Item
19028
19029 Pod::Cache::Item-E<gt>new()
19030
19031 =back
19032
19033 $cacheitem-E<gt>page()
19034
19035 $cacheitem-E<gt>description()
19036
19037 $cacheitem-E<gt>path()
19038
19039 $cacheitem-E<gt>file()
19040
19041 $cacheitem-E<gt>nodes()
19042
19043 $cacheitem-E<gt>find_node($name)
19044
19045 $cacheitem-E<gt>idx()
19046
19047 =over 4
19048
19049 =item AUTHOR
19050
19051 =item SEE ALSO
19052
19053 =back
19054
19055 =head2 Pod::Parser - base class for creating POD filters and translators
19056
19057 =over 4
19058
19059 =item SYNOPSIS
19060
19061 =item REQUIRES
19062
19063 =item EXPORTS
19064
19065 =item DESCRIPTION
19066
19067 =item QUICK OVERVIEW
19068
19069 =item PARSING OPTIONS
19070
19071 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
19072 B<-warnings> (default: unset)
19073
19074 =back
19075
19076 =over 4
19077
19078 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
19079
19080 =back
19081
19082 =over 4
19083
19084 =item B<command()>
19085
19086 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
19087
19088 =back
19089
19090 =over 4
19091
19092 =item B<verbatim()>
19093
19094 C<$text>, C<$line_num>, C<$pod_para>
19095
19096 =back
19097
19098 =over 4
19099
19100 =item B<textblock()>
19101
19102 C<$text>, C<$line_num>, C<$pod_para>
19103
19104 =back
19105
19106 =over 4
19107
19108 =item B<interior_sequence()>
19109
19110 =back
19111
19112 =over 4
19113
19114 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
19115
19116 =back
19117
19118 =over 4
19119
19120 =item B<new()>
19121
19122 =back
19123
19124 =over 4
19125
19126 =item B<initialize()>
19127
19128 =back
19129
19130 =over 4
19131
19132 =item B<begin_pod()>
19133
19134 =back
19135
19136 =over 4
19137
19138 =item B<begin_input()>
19139
19140 =back
19141
19142 =over 4
19143
19144 =item B<end_input()>
19145
19146 =back
19147
19148 =over 4
19149
19150 =item B<end_pod()>
19151
19152 =back
19153
19154 =over 4
19155
19156 =item B<preprocess_line()>
19157
19158 =back
19159
19160 =over 4
19161
19162 =item B<preprocess_paragraph()>
19163
19164 =back
19165
19166 =over 4
19167
19168 =item METHODS FOR PARSING AND PROCESSING
19169
19170 =back
19171
19172 =over 4
19173
19174 =item B<parse_text()>
19175
19176 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
19177 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
19178 I<code-ref>|I<method-name>
19179
19180 =back
19181
19182 =over 4
19183
19184 =item B<interpolate()>
19185
19186 =back
19187
19188 =over 4
19189
19190 =item B<parse_paragraph()>
19191
19192 =back
19193
19194 =over 4
19195
19196 =item B<parse_from_filehandle()>
19197
19198 =back
19199
19200 =over 4
19201
19202 =item B<parse_from_file()>
19203
19204 =back
19205
19206 =over 4
19207
19208 =item ACCESSOR METHODS
19209
19210 =back
19211
19212 =over 4
19213
19214 =item B<errorsub()>
19215
19216 =back
19217
19218 =over 4
19219
19220 =item B<cutting()>
19221
19222 =back
19223
19224 =over 4
19225
19226 =item B<parseopts()>
19227
19228 =back
19229
19230 =over 4
19231
19232 =item B<output_file()>
19233
19234 =back
19235
19236 =over 4
19237
19238 =item B<output_handle()>
19239
19240 =back
19241
19242 =over 4
19243
19244 =item B<input_file()>
19245
19246 =back
19247
19248 =over 4
19249
19250 =item B<input_handle()>
19251
19252 =back
19253
19254 =over 4
19255
19256 =item B<input_streams()>
19257
19258 =back
19259
19260 =over 4
19261
19262 =item B<top_stream()>
19263
19264 =back
19265
19266 =over 4
19267
19268 =item PRIVATE METHODS AND DATA
19269
19270 =back
19271
19272 =over 4
19273
19274 =item B<_push_input_stream()>
19275
19276 =back
19277
19278 =over 4
19279
19280 =item B<_pop_input_stream()>
19281
19282 =back
19283
19284 =over 4
19285
19286 =item TREE-BASED PARSING
19287
19288 =item SEE ALSO
19289
19290 =item AUTHOR
19291
19292 =back
19293
19294 =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors
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::ToMan - let Perldoc render Pod as man pages
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::ToNroff - let Perldoc convert Pod to nroff
19329
19330 =over 4
19331
19332 =item SYNOPSIS
19333
19334 =item DESCRIPTION
19335
19336 =item CAVEAT
19337
19338 =item SEE ALSO
19339
19340 =item COPYRIGHT AND DISCLAIMERS
19341
19342 =item AUTHOR
19343
19344 =back
19345
19346 =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod!
19347
19348 =over 4
19349
19350 =item SYNOPSIS
19351
19352 =item DESCRIPTION
19353
19354 =item SEE ALSO
19355
19356 =item COPYRIGHT AND DISCLAIMERS
19357
19358 =item AUTHOR
19359
19360 =back
19361
19362 =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF
19363
19364 =over 4
19365
19366 =item SYNOPSIS
19367
19368 =item DESCRIPTION
19369
19370 =item SEE ALSO
19371
19372 =item COPYRIGHT AND DISCLAIMERS
19373
19374 =item AUTHOR
19375
19376 =back
19377
19378 =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext
19379
19380 =over 4
19381
19382 =item SYNOPSIS
19383
19384 =item DESCRIPTION
19385
19386 =item CAVEAT
19387
19388 =item SEE ALSO
19389
19390 =item COPYRIGHT AND DISCLAIMERS
19391
19392 =item AUTHOR
19393
19394 =back
19395
19396 =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod
19397
19398 =over 4
19399
19400 =item SYNOPSIS
19401
19402 =item DESCRIPTION
19403
19404 =item SEE ALSO
19405
19406 =item AUTHOR
19407
19408 =back
19409
19410 =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML
19411
19412 =over 4
19413
19414 =item SYNOPSIS
19415
19416 =item DESCRIPTION
19417
19418 =item SEE ALSO
19419
19420 =item COPYRIGHT AND DISCLAIMERS
19421
19422 =item AUTHOR
19423
19424 =back
19425
19426 =head2 Pod::PlainText - Convert POD data to formatted ASCII text
19427
19428 =over 4
19429
19430 =item SYNOPSIS
19431
19432 =item DESCRIPTION
19433
19434 alt, indent, loose, sentence, width
19435
19436 =item DIAGNOSTICS
19437
19438 Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
19439 Unknown sequence: %s, Unmatched =back
19440
19441 =item RESTRICTIONS
19442
19443 =item NOTES
19444
19445 =item SEE ALSO
19446
19447 =item AUTHOR
19448
19449 =back
19450
19451 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
19452
19453 =over 4
19454
19455 =item SYNOPSIS
19456
19457 =item DESCRIPTION
19458
19459 =over 4
19460
19461 =item EXPORT
19462
19463 =back
19464
19465 =item AUTHOR
19466
19467 =item SEE ALSO
19468
19469 =back
19470
19471 =head2 Pod::Select, podselect() - extract selected sections of POD from
19472 input
19473
19474 =over 4
19475
19476 =item SYNOPSIS
19477
19478 =item REQUIRES
19479
19480 =item EXPORTS
19481
19482 =item DESCRIPTION
19483
19484 =item SECTION SPECIFICATIONS
19485
19486 =item RANGE SPECIFICATIONS
19487
19488 =back
19489
19490 =over 4
19491
19492 =item OBJECT METHODS
19493
19494 =back
19495
19496 =over 4
19497
19498 =item B<curr_headings()>
19499
19500 =back
19501
19502 =over 4
19503
19504 =item B<select()>
19505
19506 =back
19507
19508 =over 4
19509
19510 =item B<add_selection()>
19511
19512 =back
19513
19514 =over 4
19515
19516 =item B<clear_selections()>
19517
19518 =back
19519
19520 =over 4
19521
19522 =item B<match_section()>
19523
19524 =back
19525
19526 =over 4
19527
19528 =item B<is_selected()>
19529
19530 =back
19531
19532 =over 4
19533
19534 =item EXPORTED FUNCTIONS
19535
19536 =back
19537
19538 =over 4
19539
19540 =item B<podselect()>
19541
19542 B<-output>, B<-sections>, B<-ranges>
19543
19544 =back
19545
19546 =over 4
19547
19548 =item PRIVATE METHODS AND DATA
19549
19550 =back
19551
19552 =over 4
19553
19554 =item B<_compile_section_spec()>
19555
19556 =back
19557
19558 =over 4
19559
19560 =item $self->{_SECTION_HEADINGS}
19561
19562 =back
19563
19564 =over 4
19565
19566 =item $self->{_SELECTED_SECTIONS}
19567
19568 =back
19569
19570 =over 4
19571
19572 =item SEE ALSO
19573
19574 =item AUTHOR
19575
19576 =back
19577
19578 =head2 Pod::Text - Convert POD data to formatted ASCII text
19579
19580 =over 4
19581
19582 =item SYNOPSIS
19583
19584 =item DESCRIPTION
19585
19586 alt, code, indent, loose, margin, quotes, sentence, width
19587
19588 =item DIAGNOSTICS
19589
19590 Bizarre space in item, Item called without tag, Can't open %s for reading:
19591 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
19592 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
19593 Unmatched =back
19594
19595 =item RESTRICTIONS
19596
19597 =item NOTES
19598
19599 =item SEE ALSO
19600
19601 =item AUTHOR
19602
19603 =item COPYRIGHT AND LICENSE
19604
19605 =back
19606
19607 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
19608
19609 =over 4
19610
19611 =item SYNOPSIS
19612
19613 =item DESCRIPTION
19614
19615 =item BUGS
19616
19617 =item SEE ALSO
19618
19619 =item AUTHOR
19620
19621 =item COPYRIGHT AND LICENSE
19622
19623 =back
19624
19625 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
19626 text
19627
19628 =over 4
19629
19630 =item SYNOPSIS
19631
19632 =item DESCRIPTION
19633
19634 =item BUGS
19635
19636 =item SEE ALSO
19637
19638 =item AUTHOR
19639
19640 =item COPYRIGHT AND LICENSE
19641
19642 =back
19643
19644 =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
19645 escapes
19646
19647 =over 4
19648
19649 =item SYNOPSIS
19650
19651 =item DESCRIPTION
19652
19653 =item NOTES
19654
19655 =item SEE ALSO
19656
19657 =item AUTHOR
19658
19659 =item COPYRIGHT AND LICENSE
19660
19661 =back
19662
19663 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
19664 documentation
19665
19666 =over 4
19667
19668 =item SYNOPSIS
19669
19670 =item ARGUMENTS
19671
19672 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
19673 C<-pathlist>
19674
19675 =item DESCRIPTION
19676
19677 =item EXAMPLES
19678
19679 =over 4
19680
19681 =item Recommended Use
19682
19683 =back
19684
19685 =item CAVEATS
19686
19687 =item AUTHOR
19688
19689 =item ACKNOWLEDGEMENTS
19690
19691 =back
19692
19693 =head2 SDBM_File - Tied access to sdbm files
19694
19695 =over 4
19696
19697 =item SYNOPSIS
19698
19699 =item DESCRIPTION
19700
19701 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
19702
19703 =item DIAGNOSTICS
19704
19705 =over 4
19706
19707 =item C<sdbm store returned -1, errno 22, key "..." at ...>
19708
19709 =back
19710
19711 =item BUGS AND WARNINGS
19712
19713 =back
19714
19715 =head2 Safe - Compile and execute code in restricted compartments
19716
19717 =over 4
19718
19719 =item SYNOPSIS
19720
19721 =item DESCRIPTION
19722
19723 a new namespace, an operator mask
19724
19725 =item WARNING
19726
19727 =over 4
19728
19729 =item RECENT CHANGES
19730
19731 =item Methods in class Safe
19732
19733 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
19734 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
19735 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
19736 root (NAMESPACE), mask (MASK)
19737
19738 =item Some Safety Issues
19739
19740 Memory, CPU, Snooping, Signals, State Changes
19741
19742 =item AUTHOR
19743
19744 =back
19745
19746 =back
19747
19748 =head2 Scalar::Util - A selection of general-utility scalar subroutines
19749
19750 =over 4
19751
19752 =item SYNOPSIS
19753
19754 =item DESCRIPTION
19755
19756 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
19757 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
19758 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
19759
19760 =item KNOWN BUGS
19761
19762 =item COPYRIGHT
19763
19764 =item BLATANT PLUG
19765
19766 =back
19767
19768 =head2 Search::Dict, look - search for key in dictionary file
19769
19770 =over 4
19771
19772 =item SYNOPSIS
19773
19774 =item DESCRIPTION
19775
19776 =back
19777
19778 =head2 SelectSaver - save and restore selected file handle
19779
19780 =over 4
19781
19782 =item SYNOPSIS
19783
19784 =item DESCRIPTION
19785
19786 =back
19787
19788 =head2 SelfLoader - load functions only on demand
19789
19790 =over 4
19791
19792 =item SYNOPSIS
19793
19794 =item DESCRIPTION
19795
19796 =over 4
19797
19798 =item The __DATA__ token
19799
19800 =item SelfLoader autoloading
19801
19802 =item Autoloading and package lexicals
19803
19804 =item SelfLoader and AutoLoader
19805
19806 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
19807
19808 =item Classes and inherited methods.
19809
19810 =back
19811
19812 =item Multiple packages and fully qualified subroutine names
19813
19814 =back
19815
19816 =head2 Shell - run shell commands transparently within perl
19817
19818 =over 4
19819
19820 =item SYNOPSIS
19821
19822 =item DESCRIPTION
19823
19824 =over 4
19825
19826 =item Caveats
19827
19828 =item Escaping Magic Characters
19829
19830 =item Configuration
19831
19832 =back
19833
19834 =item BUGS
19835
19836 =item AUTHOR
19837
19838 =back
19839
19840 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
19841 socket.h defines and structure manipulators 
19842
19843 =over 4
19844
19845 =item SYNOPSIS
19846
19847 =item DESCRIPTION
19848
19849 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
19850 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
19851 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
19852 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
19853 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
19854
19855 =back
19856
19857 =head2 Storable - persistence for Perl data structures
19858
19859 =over 4
19860
19861 =item SYNOPSIS
19862
19863 =item DESCRIPTION
19864
19865 =item MEMORY STORE
19866
19867 =item ADVISORY LOCKING
19868
19869 =item SPEED
19870
19871 =item CANONICAL REPRESENTATION
19872
19873 =item CODE REFERENCES
19874
19875 =item FORWARD COMPATIBILITY
19876
19877 utf8 data, restricted hashes, files from future versions of Storable
19878
19879 =item ERROR REPORTING
19880
19881 =item WIZARDS ONLY
19882
19883 =over 4
19884
19885 =item Hooks
19886
19887 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
19888 I<serialized>, ..
19889
19890 =item Predicates
19891
19892 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
19893 C<Storable::is_retrieving>
19894
19895 =item Recursion
19896
19897 =item Deep Cloning
19898
19899 =back
19900
19901 =item Storable magic
19902
19903 =item EXAMPLES
19904
19905 =item WARNING
19906
19907 =item BUGS
19908
19909 =over 4
19910
19911 =item 64 bit data in perl 5.6.0 and 5.6.1
19912
19913 =back
19914
19915 =item CREDITS
19916
19917 =item AUTHOR
19918
19919 =item SEE ALSO
19920
19921 =back
19922
19923 =head2 Switch - A switch statement for Perl
19924
19925 =over 4
19926
19927 =item VERSION
19928
19929 =item SYNOPSIS
19930
19931 =item BACKGROUND
19932
19933 =item DESCRIPTION
19934
19935 =over 4
19936
19937 =item Allowing fall-through
19938
19939 =item Automating fall-through
19940
19941 =item Alternative syntax
19942
19943 =item Higher-order Operations
19944
19945 =back
19946
19947 =item DEPENDENCIES
19948
19949 =item AUTHOR
19950
19951 =item BUGS
19952
19953 =item LIMITATIONS
19954
19955 =item COPYRIGHT
19956
19957 =back
19958
19959 =head2 Symbol - manipulate Perl symbols and their names
19960
19961 =over 4
19962
19963 =item SYNOPSIS
19964
19965 =item DESCRIPTION
19966
19967 =item BUGS
19968
19969 =back
19970
19971 =head2 Sys::Hostname - Try every conceivable way to get hostname
19972
19973 =over 4
19974
19975 =item SYNOPSIS
19976
19977 =item DESCRIPTION
19978
19979 =item AUTHOR
19980
19981 =back
19982
19983 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
19984 interface to the UNIX syslog(3) calls
19985
19986 =over 4
19987
19988 =item SYNOPSIS
19989
19990 =item DESCRIPTION
19991
19992 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19993 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19994 in 5.004_02), closelog
19995
19996 =item EXAMPLES
19997
19998 =item SEE ALSO
19999
20000 =item AUTHOR
20001
20002 =back
20003
20004 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
20005 Perl interface to the UNIX syslog(3) calls
20006
20007 =over 4
20008
20009 =item SYNOPSIS
20010
20011 =item DESCRIPTION
20012
20013 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
20014 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
20015 in 5.004_02), closelog
20016
20017 =item EXAMPLES
20018
20019 =item SEE ALSO
20020
20021 =item AUTHOR
20022
20023 =back
20024
20025 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
20026
20027 =over 4
20028
20029 =item SYNOPSIS
20030
20031 =item DESCRIPTION
20032
20033 =item DIAGNOSTICS
20034
20035 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
20036 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
20037 comma allowed after filehandle, No name for escape sequence %s
20038
20039 =item ENVIRONMENT
20040
20041 ANSI_COLORS_DISABLED
20042
20043 =item RESTRICTIONS
20044
20045 =item NOTES
20046
20047 =item SEE ALSO
20048
20049 =item AUTHORS
20050
20051 =item COPYRIGHT AND LICENSE
20052
20053 =back
20054
20055 =head2 Term::Cap - Perl termcap interface
20056
20057 =over 4
20058
20059 =item SYNOPSIS
20060
20061 =item DESCRIPTION
20062
20063 =over 4
20064
20065 =item METHODS
20066
20067 =back
20068
20069 =back
20070
20071 B<Tgetent>, OSPEED, TERM
20072
20073 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
20074
20075 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
20076
20077 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
20078
20079 B<Trequire>
20080
20081 =over 4
20082
20083 =item EXAMPLES
20084
20085 =item COPYRIGHT AND LICENSE
20086
20087 =item AUTHOR
20088
20089 =item SEE ALSO
20090
20091 =back
20092
20093 =head2 Term::Complete - Perl word completion module
20094
20095 =over 4
20096
20097 =item SYNOPSIS
20098
20099 =item DESCRIPTION
20100
20101 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
20102
20103 =item DIAGNOSTICS
20104
20105 =item BUGS
20106
20107 =item AUTHOR
20108
20109 =back
20110
20111 =head2 Term::ReadLine - Perl interface to various C<readline> packages.
20112 If no real package is found, substitutes stubs instead of basic functions.
20113
20114 =over 4
20115
20116 =item SYNOPSIS
20117
20118 =item DESCRIPTION
20119
20120 =item Minimal set of supported functions
20121
20122 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>,
20123 C<findConsole>, Attribs, C<Features>
20124
20125 =item Additional supported functions
20126
20127 C<tkRunning>, C<ornaments>, C<newTTY>
20128
20129 =item EXPORTS
20130
20131 =item ENVIRONMENT
20132
20133 =item CAVEATS
20134
20135 =back
20136
20137 =head2 Test - provides a simple framework for writing test scripts
20138
20139 =over 4
20140
20141 =item SYNOPSIS
20142
20143 =item DESCRIPTION
20144
20145 =item QUICK START GUIDE
20146
20147 =over 4
20148
20149 =item Functions
20150
20151 C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>,
20152 C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub>
20153
20154 =back
20155
20156 =back
20157
20158 B<_to_value>
20159
20160 C<ok(...)>
20161
20162 C<skip(I<skip_if_true>, I<args...>)>
20163
20164 =over 4
20165
20166 =item TEST TYPES
20167
20168 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
20169
20170 =item ONFAIL
20171
20172 =item BUGS and CAVEATS
20173
20174 =item ENVIRONMENT
20175
20176 =item NOTE
20177
20178 =item SEE ALSO
20179
20180 =item AUTHOR
20181
20182 =back
20183
20184 =head2 Test::Builder - Backend for building test libraries
20185
20186 =over 4
20187
20188 =item SYNOPSIS
20189
20190 =item DESCRIPTION
20191
20192 =over 4
20193
20194 =item Construction
20195
20196 B<new>
20197
20198 =back
20199
20200 =back
20201
20202 B<reset>
20203
20204 =over 4
20205
20206 =item Setting up tests
20207
20208 B<exported_to>
20209
20210 =back
20211
20212 B<plan>
20213
20214 B<expected_tests>
20215
20216 B<no_plan>
20217
20218 B<has_plan>
20219
20220 B<skip_all>
20221
20222 =over 4
20223
20224 =item Running tests
20225
20226 B<ok>
20227
20228 =back
20229
20230 B<is_eq>, B<is_num>
20231
20232 B<isnt_eq>, B<isnt_num>
20233
20234 B<like>, B<unlike>
20235
20236 B<maybe_regex>
20237
20238 B<cmp_ok>
20239
20240 B<BAILOUT>
20241
20242 B<skip>
20243
20244 B<todo_skip>
20245
20246 B<skip_rest>
20247
20248 =over 4
20249
20250 =item Test style
20251
20252 B<level>
20253
20254 =back
20255
20256 B<use_numbers>
20257
20258 B<no_header>, B<no_ending>
20259
20260 =over 4
20261
20262 =item Output
20263
20264 B<diag>
20265
20266 =back
20267
20268 B<_print>
20269
20270 B<_print_diag>
20271
20272 B<output>, B<failure_output>, B<todo_output>
20273
20274 =over 4
20275
20276 =item Test Status and Info
20277
20278 B<current_test>
20279
20280 =back
20281
20282 B<summary>
20283
20284 B<details>
20285
20286 B<todo>
20287
20288 B<caller>
20289
20290 B<_sanity_check>
20291
20292 B<_whoa>
20293
20294 B<_my_exit>
20295
20296 =over 4
20297
20298 =item EXIT CODES
20299
20300 =item THREADS
20301
20302 =item EXAMPLES
20303
20304 =item SEE ALSO
20305
20306 =item AUTHORS
20307
20308 =item COPYRIGHT
20309
20310 =back
20311
20312 =head2 Test::Harness - Run Perl standard test scripts with statistics
20313
20314 =over 4
20315
20316 =item VERSION
20317
20318 =back
20319
20320 =over 4
20321
20322 =item SYNOPSIS
20323
20324 =item DESCRIPTION
20325
20326 =over 4
20327
20328 =item The test script output
20329
20330 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
20331 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
20332 else>
20333
20334 =item Taint mode
20335
20336 =item Configuration variables.
20337
20338 B<$Test::Harness::Verbose>, B<$Test::Harness::switches>
20339
20340 =item Failure
20341
20342 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
20343 Failed>
20344
20345 =item Functions
20346
20347 B<runtests>
20348
20349 =back
20350
20351 =back
20352
20353 B<_all_ok>
20354
20355 B<_globdir>
20356
20357 B<_run_all_tests>
20358
20359 B<_mk_leader>
20360
20361 B<_leader_width>
20362
20363 =over 4
20364
20365 =item EXPORT
20366
20367 =item DIAGNOSTICS
20368
20369 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
20370 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
20371 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
20372 %s>, C<FAILED--Further testing stopped: %s>
20373
20374 =item ENVIRONMENT
20375
20376 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
20377 C<HARNESS_DEBUG>, C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>,
20378 C<HARNESS_NOTTY>, C<HARNESS_OK_SLOW>, C<HARNESS_PERL>,
20379 C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
20380
20381 =item EXAMPLE
20382
20383 =item SEE ALSO
20384
20385 =item AUTHORS
20386
20387 =item LICENSE
20388
20389 =item TODO
20390
20391 =item BUGS
20392
20393 =item AUTHORS
20394
20395 =item COPYRIGHT
20396
20397 =back
20398
20399 =head2 Test::Harness::Assert - simple assert
20400
20401 =over 4
20402
20403 =item SYNOPSIS
20404
20405 =item DESCRIPTION
20406
20407 =item FUNCTIONS
20408
20409 =over 4
20410
20411 =item C<assert()>
20412
20413 =back
20414
20415 =back
20416
20417 =over 4
20418
20419 =item AUTHOR
20420
20421 =item SEE ALSO
20422
20423 =back
20424
20425 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
20426
20427 =over 4
20428
20429 =item SYNOPSIS
20430
20431 =item DESCRIPTION
20432
20433 =over 4
20434
20435 =item new()
20436
20437 =item next()
20438
20439 =back
20440
20441 =back
20442
20443 =head2 Test::Harness::Straps - detailed analysis of test results
20444
20445 =over 4
20446
20447 =item SYNOPSIS
20448
20449 =item DESCRIPTION
20450
20451 =item Construction
20452
20453 =over 4
20454
20455 =item C<new>
20456
20457 =back
20458
20459 =back
20460
20461 =over 4
20462
20463 =item C<_init>
20464
20465 =back
20466
20467 =over 4
20468
20469 =item Analysis
20470
20471 =over 4
20472
20473 =item C<analyze>
20474
20475 =back
20476
20477 =back
20478
20479 =over 4
20480
20481 =item C<analyze_fh>
20482
20483 =back
20484
20485 =over 4
20486
20487 =item C<analyze_file>
20488
20489 =back
20490
20491 =over 4
20492
20493 =item C<_command_line( $file )>
20494
20495 =back
20496
20497 =over 4
20498
20499 =item C<_command>
20500
20501 =back
20502
20503 =over 4
20504
20505 =item C<_switches>
20506
20507 =back
20508
20509 =over 4
20510
20511 =item C<_cleaned_switches>
20512
20513 =back
20514
20515 =over 4
20516
20517 =item C<_INC2PERL5LIB>
20518
20519 =back
20520
20521 =over 4
20522
20523 =item C<_filtered_INC>
20524
20525 =back
20526
20527 =over 4
20528
20529 =item C<_restore_PERL5LIB>
20530
20531 =back
20532
20533 =over 4
20534
20535 =item Parsing
20536
20537 =over 4
20538
20539 =item C<_is_comment>
20540
20541 =back
20542
20543 =back
20544
20545 =over 4
20546
20547 =item C<_is_header>
20548
20549 =back
20550
20551 =over 4
20552
20553 =item C<_is_test>
20554
20555 =back
20556
20557 =over 4
20558
20559 =item C<_is_bail_out>
20560
20561 =back
20562
20563 =over 4
20564
20565 =item C<_reset_file_state>
20566
20567 =back
20568
20569 =over 4
20570
20571 =item Results
20572
20573 =over 4
20574
20575 =item C<_detailize>
20576
20577 =back
20578
20579 =back
20580
20581 =over 4
20582
20583 =item EXAMPLES
20584
20585 =item AUTHOR
20586
20587 =item SEE ALSO
20588
20589 =back
20590
20591 =head2 Test::More - yet another framework for writing test scripts
20592
20593 =over 4
20594
20595 =item SYNOPSIS
20596
20597 =item DESCRIPTION
20598
20599 =over 4
20600
20601 =item I love it when a plan comes together
20602
20603 =back
20604
20605 =back
20606
20607 =over 4
20608
20609 =item Test names
20610
20611 =item I'm ok, you're not ok.
20612
20613 B<ok>
20614
20615 =back
20616
20617 B<is>, B<isnt>
20618
20619 B<like>
20620
20621 B<unlike>
20622
20623 B<cmp_ok>
20624
20625 B<can_ok>
20626
20627 B<isa_ok>
20628
20629 B<pass>, B<fail>
20630
20631 =over 4
20632
20633 =item Diagnostics
20634
20635 B<diag>
20636
20637 =back
20638
20639 =over 4
20640
20641 =item Module tests
20642
20643 B<use_ok>
20644
20645 =back
20646
20647 B<require_ok>
20648
20649 =over 4
20650
20651 =item Conditional tests
20652
20653 B<SKIP: BLOCK>
20654
20655 =back
20656
20657 B<TODO: BLOCK>, B<todo_skip>
20658
20659 When do I use SKIP vs. TODO?
20660
20661 =over 4
20662
20663 =item Comparison functions
20664
20665 B<is_deeply>
20666
20667 =back
20668
20669 B<eq_array>
20670
20671 B<eq_hash>
20672
20673 B<eq_set>
20674
20675 =over 4
20676
20677 =item Extending and Embedding Test::More
20678
20679 B<builder>
20680
20681 =back
20682
20683 =over 4
20684
20685 =item EXIT CODES
20686
20687 =item CAVEATS and NOTES
20688
20689 Backwards compatibility, Overloaded objects, Threads, Test::Harness upgrade
20690
20691 =item HISTORY
20692
20693 =item SEE ALSO
20694
20695 =item AUTHORS
20696
20697 =item BUGS
20698
20699 =item COPYRIGHT
20700
20701 =back
20702
20703 =head2 Test::Simple - Basic utilities for writing tests.
20704
20705 =over 4
20706
20707 =item SYNOPSIS
20708
20709 =item DESCRIPTION
20710
20711 B<ok>
20712
20713 =back
20714
20715 =over 4
20716
20717 =item EXAMPLE
20718
20719 =item CAVEATS
20720
20721 =item NOTES
20722
20723 =item HISTORY
20724
20725 =item SEE ALSO
20726
20727 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
20728 L<Test::Harness>
20729
20730 =item AUTHORS
20731
20732 =item COPYRIGHT
20733
20734 =back
20735
20736 =head2 Test::Tutorial - A tutorial about writing really basic tests
20737
20738 =over 4
20739
20740 =item DESCRIPTION
20741
20742 =over 4
20743
20744 =item Nuts and bolts of testing.
20745
20746 =item Where to start?
20747
20748 =item Names
20749
20750 =item Test the manual
20751
20752 =item Sometimes the tests are wrong
20753
20754 =item Testing lots of values
20755
20756 =item Informative names
20757
20758 =item Skipping tests
20759
20760 =item Todo tests
20761
20762 =item Testing with taint mode.
20763
20764 =back
20765
20766 =item FOOTNOTES
20767
20768 =item AUTHORS
20769
20770 =item COPYRIGHT
20771
20772 =back
20773
20774 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
20775
20776 =over 4
20777
20778 =item SYNOPSIS
20779
20780 =item DESCRIPTION
20781
20782 =item EXAMPLE
20783
20784 =back
20785
20786 =head2 Text::Balanced - Extract delimited text sequences from strings.
20787
20788 =over 4
20789
20790 =item SYNOPSIS
20791
20792 =item DESCRIPTION
20793
20794 =over 4
20795
20796 =item General behaviour in list contexts
20797
20798 [0], [1], [2]
20799
20800 =item General behaviour in scalar and void contexts
20801
20802 =item A note about prefixes
20803
20804 =item C<extract_delimited>
20805
20806 =item C<extract_bracketed>
20807
20808 =item C<extract_variable>
20809
20810 [0], [1], [2]
20811
20812 =item C<extract_tagged>
20813
20814 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
20815 [0], [1], [2], [3], [4], [5]
20816
20817 =item C<gen_extract_tagged>
20818
20819 =item C<extract_quotelike>
20820
20821 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
20822
20823 =item C<extract_quotelike> and "here documents"
20824
20825 [0], [1], [2], [3], [4], [5], [6], [7..10]
20826
20827 =item C<extract_codeblock>
20828
20829 =item C<extract_multiple>
20830
20831 =item C<gen_delimited_pat>
20832
20833 =back
20834
20835 =item DIAGNOSTICS
20836
20837  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>, 
20838 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
20839 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">, 
20840 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
20841 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
20842 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
20843 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
20844 after dereferencer>, C<Did not find expected opening bracket at %s>,
20845 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
20846 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
20847 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
20848 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
20849 tag>
20850
20851 =item AUTHOR
20852
20853 =item BUGS AND IRRITATIONS
20854
20855 =item COPYRIGHT
20856
20857 =back
20858
20859 =head2 Text::ParseWords - parse text into an array of tokens or array of
20860 arrays
20861
20862 =over 4
20863
20864 =item SYNOPSIS
20865
20866 =item DESCRIPTION
20867
20868 =item EXAMPLES
20869
20870 =item AUTHORS
20871
20872 =back
20873
20874 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
20875 by Knuth
20876
20877 =over 4
20878
20879 =item SYNOPSIS
20880
20881 =item DESCRIPTION
20882
20883 =item EXAMPLES
20884
20885 =item LIMITATIONS
20886
20887 =item AUTHOR
20888
20889 =back
20890
20891 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
20892 unexpand(1)
20893
20894 =over 4
20895
20896 =item SYNOPSIS
20897
20898 =item DESCRIPTION
20899
20900 =item BUGS
20901
20902 =item AUTHOR
20903
20904 =back
20905
20906 =head2 Text::Wrap - line wrapping to form simple paragraphs
20907
20908 =over 4
20909
20910 =item SYNOPSIS 
20911
20912 =item DESCRIPTION
20913
20914 =item OVERRIDES
20915
20916 =item EXAMPLE
20917
20918 =item AUTHOR
20919
20920 =back
20921
20922 =head2 Thread - manipulate threads in Perl (for old code only)
20923
20924 =over 4
20925
20926 =item CAVEAT
20927
20928 =item SYNOPSIS
20929
20930 =item DESCRIPTION
20931
20932 =item FUNCTIONS
20933
20934 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
20935 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
20936 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
20937
20938 =item METHODS
20939
20940 join, eval, detach, equal, tid, flags, done
20941
20942 =item LIMITATIONS
20943
20944 =item SEE ALSO
20945
20946 =back
20947
20948 =head2 Thread::Queue - thread-safe queues
20949
20950 =over 4
20951
20952 =item SYNOPSIS
20953
20954 =item DESCRIPTION
20955
20956 =item FUNCTIONS AND METHODS
20957
20958 new, enqueue LIST, dequeue, dequeue_nb, pending
20959
20960 =item SEE ALSO
20961
20962 =back
20963
20964 =head2 Thread::Semaphore - thread-safe semaphores
20965
20966 =over 4
20967
20968 =item SYNOPSIS
20969
20970 =item DESCRIPTION
20971
20972 =item FUNCTIONS AND METHODS
20973
20974 new, new NUMBER, down, down NUMBER, up, up NUMBER
20975
20976 =back
20977
20978 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
20979 (for old code)
20980
20981 =over 4
20982
20983 =item CAVEAT
20984
20985 =item SYNOPSIS
20986
20987 =item DESCRIPTION
20988
20989 =item BUGS
20990
20991 =back
20992
20993 =head2 Thread::Specific - thread-specific keys
20994
20995 =over 4
20996
20997 =item SYNOPSIS
20998
20999 =item DESCRIPTION
21000
21001 =back
21002
21003 =head2 Tie::Array - base class for tied arrays
21004
21005 =over 4
21006
21007 =item SYNOPSIS
21008
21009 =item DESCRIPTION
21010
21011 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
21012 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
21013 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
21014 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
21015
21016 =item CAVEATS
21017
21018 =item AUTHOR
21019
21020 =back
21021
21022 =head2 Tie::File - Access the lines of a disk file via a Perl array
21023
21024 =over 4
21025
21026 =item SYNOPSIS
21027
21028 =item DESCRIPTION
21029
21030 =over 4
21031
21032 =item C<recsep>
21033
21034 =item C<autochomp>
21035
21036 =item C<mode>
21037
21038 =item C<memory>
21039
21040 =item C<dw_size>
21041
21042 =item Option Format
21043
21044 =back
21045
21046 =item Public Methods
21047
21048 =over 4
21049
21050 =item C<flock>
21051
21052 =item C<autochomp>
21053
21054 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
21055
21056 =item C<offset>
21057
21058 =back
21059
21060 =item Tying to an already-opened filehandle
21061
21062 =item Deferred Writing
21063
21064 =over 4
21065
21066 =item Autodeferring
21067
21068 =back
21069
21070 =item CONCURRENT ACCESS TO FILES
21071
21072 =item CAVEATS
21073
21074 =item SUBCLASSING
21075
21076 =item WHAT ABOUT C<DB_File>?
21077
21078 =item AUTHOR
21079
21080 =item LICENSE
21081
21082 =item WARRANTY
21083
21084 =item THANKS
21085
21086 =item TODO
21087
21088 =back
21089
21090 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
21091 handles
21092
21093 =over 4
21094
21095 =item SYNOPSIS
21096
21097 =item DESCRIPTION
21098
21099 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
21100 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
21101 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
21102 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
21103
21104 =item MORE INFORMATION
21105
21106 =item COMPATIBILITY
21107
21108 =back
21109
21110 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
21111 tied hashes
21112
21113 =over 4
21114
21115 =item SYNOPSIS
21116
21117 =item DESCRIPTION
21118
21119 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
21120 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR
21121 this, SCALAR this
21122
21123 =item Inheriting from B<Tie::StdHash>
21124
21125 =item Inheriting from B<Tie::ExtraHash>
21126
21127 =item C<SCALAR>, C<UNTIE> and C<DESTROY>
21128
21129 =item MORE INFORMATION
21130
21131 =back
21132
21133 =head2 Tie::Memoize - add data to hash when needed
21134
21135 =over 4
21136
21137 =item SYNOPSIS
21138
21139 =item DESCRIPTION
21140
21141 =item Inheriting from B<Tie::Memoize>
21142
21143 =item EXAMPLE
21144
21145 =item BUGS
21146
21147 =item AUTHOR
21148
21149 =back
21150
21151 =head2 Tie::RefHash - use references as hash keys
21152
21153 =over 4
21154
21155 =item SYNOPSIS
21156
21157 =item DESCRIPTION
21158
21159 =item EXAMPLE
21160
21161 =item AUTHOR
21162
21163 =item VERSION
21164
21165 =item SEE ALSO
21166
21167 =back
21168
21169 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
21170 scalars
21171
21172 =over 4
21173
21174 =item SYNOPSIS
21175
21176 =item DESCRIPTION
21177
21178 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
21179
21180 =item MORE INFORMATION
21181
21182 =back
21183
21184 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
21185
21186 =over 4
21187
21188 =item SYNOPSIS
21189
21190 =item DESCRIPTION
21191
21192 =item CAVEATS
21193
21194 =back
21195
21196 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
21197 timers
21198
21199 =over 4
21200
21201 =item SYNOPSIS
21202
21203 =item DESCRIPTION
21204
21205 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
21206 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
21207 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer (
21208 $which, $floating_seconds [, $interval_floating_seconds ] ), getitimer (
21209 $which )
21210
21211 =item EXAMPLES
21212
21213 =item C API
21214
21215 =item DIAGNOSTICS
21216
21217 =over 4
21218
21219 =item negative time not invented yet
21220
21221 =item internal error: useconds < 0 (unsigned ... signed ...)
21222
21223 =back
21224
21225 =item CAVEATS
21226
21227 =item AUTHORS
21228
21229 =item COPYRIGHT AND LICENSE
21230
21231 =back
21232
21233 =head2 Time::Local - efficiently compute time from local and GMT time
21234
21235 =over 4
21236
21237 =item SYNOPSIS
21238
21239 =item DESCRIPTION
21240
21241 =over 4
21242
21243 =item Ambiguous Local Times (DST)
21244
21245 =item Non-Existent Local Times (DST)
21246
21247 =item Negative Epoch Values
21248
21249 =back
21250
21251 =item IMPLEMENTATION
21252
21253 =item BUGS
21254
21255 =item SUPPORT
21256
21257 =item AUTHOR
21258
21259 =back
21260
21261 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
21262 function
21263
21264 =over 4
21265
21266 =item SYNOPSIS
21267
21268 =item DESCRIPTION
21269
21270 =item NOTE
21271
21272 =item AUTHOR
21273
21274 =back
21275
21276 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
21277 function
21278
21279 =over 4
21280
21281 =item SYNOPSIS
21282
21283 =item DESCRIPTION
21284
21285 =item NOTE
21286
21287 =item AUTHOR
21288
21289 =back
21290
21291 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
21292
21293 =over 4
21294
21295 =item SYNOPSIS
21296
21297 =item DESCRIPTION
21298
21299 =item AUTHOR
21300
21301 =back
21302
21303 =head2 UNIVERSAL - base class for ALL classes (blessed references)
21304
21305 =over 4
21306
21307 =item SYNOPSIS
21308
21309 =item DESCRIPTION
21310
21311 C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<isa( VAL, TYPE )>,
21312 C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD ) >>, C<<
21313 CLASS->can( METHOD ) >>, C<can( VAL, METHOD )>, C<VERSION ( [ REQUIRE ] )>
21314
21315 =item EXPORTS
21316
21317 =back
21318
21319 =head2 Unicode::Collate - Unicode Collation Algorithm
21320
21321 =over 4
21322
21323 =item SYNOPSIS
21324
21325 =item DESCRIPTION
21326
21327 =over 4
21328
21329 =item Constructor and Tailoring
21330
21331 UCA_Version, backwards, entry, hangul_terminator, ignoreName, ignoreChar,
21332 level, normalization, overrideCJK, overrideHangul, preprocess, rearrange,
21333 table, undefName, undefChar, katakana_before_hiragana, upper_before_lower,
21334 variable, alternate
21335
21336 =item Methods for Collation
21337
21338 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
21339 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
21340 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
21341 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
21342 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
21343 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
21344 $Collator-E<gt>viewSortKey($string)>
21345
21346 =item Methods for Searching
21347
21348 C<$position = $Collator-E<gt>index($string, $substring[, $position])>,
21349 C<($position, $length) = $Collator-E<gt>index($string, $substring[,
21350 $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>,
21351 C<($match)   = $Collator-E<gt>match($string, $substring)>, C<@match =
21352 $Collator-E<gt>gmatch($string, $substring)>, C<$count =
21353 $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count =
21354 $Collator-E<gt>gsubst($string, $substring, $replacement)>
21355
21356 =item Other Methods
21357
21358 C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, C<$version =
21359 $Collator-E<gt>version()>, C<UCA_Version()>, C<Base_Unicode_Version()>
21360
21361 =item EXPORT
21362
21363 =item CAVEAT
21364
21365 =item Conformance Test
21366
21367 =back
21368
21369 =item AUTHOR
21370
21371 =item SEE ALSO
21372
21373 Unicode Collation Algorithm - UTS #10, The Default Unicode Collation
21374 Element Table (DUCET), The conformance test for the UCA, Hangul Syllable
21375 Type, Unicode Normalization Forms - UAX #15, L<Unicode::Normalize>
21376
21377 =back
21378
21379 =head2 Unicode::Normalize - Unicode Normalization Forms
21380
21381 =over 4
21382
21383 =item SYNOPSIS
21384
21385 =item DESCRIPTION
21386
21387 =over 4
21388
21389 =item Normalization Forms
21390
21391 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
21392 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
21393 C<$FCD_string = FCD($string)>, C<$FCC_string = FCC($string)>,
21394 C<$normalized_string = normalize($form_name, $string)>
21395
21396 =item Decomposition and Composition
21397
21398 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
21399 decompose($string, $useCompatMapping)>, C<$reordered_string  =
21400 reorder($string)>, C<$composed_string   = compose($string)>
21401
21402 =item Quick Check
21403
21404 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
21405 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
21406 checkFCD($string)>, C<$result = checkFCC($string)>, C<$result =
21407 check($form_name, $string)>
21408
21409 =item Character Data
21410
21411 C<$canonical_decomposed = getCanon($codepoint)>,
21412 C<$compatibility_decomposed = getCompat($codepoint)>,
21413 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
21414 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
21415 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
21416 C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>,
21417 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
21418
21419 =item EXPORT
21420
21421 =back
21422
21423 =item AUTHOR
21424
21425 =item SEE ALSO
21426
21427 http://www.unicode.org/reports/tr15/,
21428 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt,
21429 http://www.unicode.org/notes/tn5/
21430
21431 =back
21432
21433 =head2 Unicode::UCD - Unicode character database
21434
21435 =over 4
21436
21437 =item SYNOPSIS
21438
21439 =item DESCRIPTION
21440
21441 =back
21442
21443 =over 4
21444
21445 =item charinfo
21446
21447 =back
21448
21449 =over 4
21450
21451 =item charblock
21452
21453 =back
21454
21455 =over 4
21456
21457 =item charscript
21458
21459 =back
21460
21461 =over 4
21462
21463 =item charblocks
21464
21465 =back
21466
21467 =over 4
21468
21469 =item charscripts
21470
21471 =back
21472
21473 =over 4
21474
21475 =item Blocks versus Scripts
21476
21477 =item Matching Scripts and Blocks
21478
21479 =item Code Point Arguments
21480
21481 =item charinrange
21482
21483 =back
21484
21485 =over 4
21486
21487 =item compexcl
21488
21489 =back
21490
21491 =over 4
21492
21493 =item casefold
21494
21495 =back
21496
21497 =over 4
21498
21499 =item casespec
21500
21501 =back
21502
21503 =over 4
21504
21505 =item Unicode::UCD::UnicodeVersion
21506
21507 =back
21508
21509 =over 4
21510
21511 =item Implementation Note
21512
21513 =back
21514
21515 =over 4
21516
21517 =item BUGS
21518
21519 =item AUTHOR
21520
21521 =back
21522
21523 =head2 User::grent - by-name interface to Perl's built-in getgr*()
21524 functions
21525
21526 =over 4
21527
21528 =item SYNOPSIS
21529
21530 =item DESCRIPTION
21531
21532 =item NOTE
21533
21534 =item AUTHOR
21535
21536 =back
21537
21538 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
21539 functions
21540
21541 =over 4
21542
21543 =item SYNOPSIS
21544
21545 =item DESCRIPTION
21546
21547 =over 4
21548
21549 =item System Specifics
21550
21551 =back
21552
21553 =item NOTE
21554
21555 =item AUTHOR
21556
21557 =item HISTORY
21558
21559 March 18th, 2000
21560
21561 =back
21562
21563 =head2 XSLoader - Dynamically load C libraries into Perl code
21564
21565 =over 4
21566
21567 =item SYNOPSIS
21568
21569 =item DESCRIPTION
21570
21571 =over 4
21572
21573 =item Migration from C<DynaLoader>
21574
21575 =item Backward compatible boilerplate
21576
21577 =back
21578
21579 =item Order of initialization: early load()
21580
21581 =over 4
21582
21583 =item The most hairy case
21584
21585 =back
21586
21587 =item LIMITATIONS
21588
21589 =item AUTHOR
21590
21591 =back
21592
21593 =head1 AUXILIARY DOCUMENTATION
21594
21595 Here should be listed all the extra programs' documentation, but they
21596 don't all have manual pages yet:
21597
21598 =over 4
21599
21600 =item a2p
21601
21602 =item c2ph
21603
21604 =item dprofpp
21605
21606 =item h2ph
21607
21608 =item h2xs
21609
21610 =item perlbug
21611
21612 =item perldoc
21613
21614 =item pl2pm
21615
21616 =item pod2html
21617
21618 =item pod2man
21619
21620 =item s2p
21621
21622 =item splain
21623
21624 =item xsubpp
21625
21626 =back
21627
21628 =head1 AUTHOR
21629
21630 Larry Wall <F<larry@wall.org>>, with the help of oodles
21631 of other folks.
21632