some method calls not autoloaded
[p5sagit/p5-mst-13.2.git] / pod / perltoc.pod
1
2 # !!!!!!!   DO NOT EDIT THIS FILE   !!!!!!!
3 # This file is autogenerated by buildtoc from all the other pods.
4 # Edit those files and run buildtoc --build-toc to effect changes.
5
6 =head1 NAME
7
8 perltoc - perl documentation table of contents
9
10 =head1 DESCRIPTION
11
12 This page provides a brief table of contents for the rest of the Perl
13 documentation set.  It is meant to be scanned quickly or grepped
14 through to locate the proper section you're looking for.
15
16 =head1 BASIC DOCUMENTATION
17
18 =head2 perl - Practical Extraction and Report Language
19
20 =over 4
21
22 =item SYNOPSIS
23
24 =over 4
25
26 =item Overview
27
28 =item Tutorials
29
30 =item Reference Manual
31
32 =item Internals and C Language Interface
33
34 =item Miscellaneous
35
36 =item Language-Specific
37
38 =item Platform-Specific
39
40 =back
41
42 =item DESCRIPTION
43
44 =item AVAILABILITY
45
46 =item ENVIRONMENT
47
48 =item AUTHOR
49
50 =item FILES
51
52 =item SEE ALSO
53
54 =item DIAGNOSTICS
55
56 =item BUGS
57
58 =item NOTES
59
60 =back
61
62 =head2 perlintro -- a brief introduction and overview of Perl
63
64 =over 4
65
66 =item DESCRIPTION
67
68 =over 4
69
70 =item What is Perl?
71
72 =item Running Perl programs
73
74 =item Basic syntax overview
75
76 =item Perl variable types
77
78 Scalars, Arrays, Hashes
79
80 =item Variable scoping
81
82 =item Conditional and looping constructs
83
84 if, while, for, foreach
85
86 =item Builtin operators and functions
87
88 Arithmetic, Numeric comparison, String comparison, Boolean logic,
89 Miscellaneous
90
91 =item Files and I/O
92
93 =item Regular expressions
94
95 Simple matching, Simple substitution, More complex regular expressions,
96 Parentheses for capturing, Other regexp features
97
98 =item Writing subroutines
99
100 =item OO Perl
101
102 =item Using Perl modules
103
104 =back
105
106 =item AUTHOR
107
108 =back
109
110 =head2 perlreftut - Mark's very short tutorial about references
111
112 =over 4
113
114 =item DESCRIPTION
115
116 =item Who Needs Complicated Data Structures?
117
118 =item The Solution
119
120 =item Syntax
121
122 =over 4
123
124 =item Making References
125
126 =item Using References
127
128 =item An Example
129
130 =item Arrow Rule
131
132 =back
133
134 =item Solution
135
136 =item The Rest
137
138 =item Summary
139
140 =item Credits
141
142 =over 4
143
144 =item Distribution Conditions
145
146 =back
147
148 =back
149
150 =head2 perldsc - Perl Data Structures Cookbook
151
152 =over 4
153
154 =item DESCRIPTION
155
156 arrays of arrays, hashes of arrays, arrays of hashes, hashes of hashes,
157 more elaborate constructs
158
159 =item REFERENCES
160
161 =item COMMON MISTAKES
162
163 =item CAVEAT ON PRECEDENCE
164
165 =item WHY YOU SHOULD ALWAYS C<use strict>
166
167 =item DEBUGGING
168
169 =item CODE EXAMPLES
170
171 =item ARRAYS OF ARRAYS
172
173 =over 4
174
175 =item Declaration of an ARRAY OF ARRAYS
176
177 =item Generation of an ARRAY OF ARRAYS
178
179 =item Access and Printing of an ARRAY OF ARRAYS
180
181 =back
182
183 =item HASHES OF ARRAYS
184
185 =over 4
186
187 =item Declaration of a HASH OF ARRAYS
188
189 =item Generation of a HASH OF ARRAYS
190
191 =item Access and Printing of a HASH OF ARRAYS
192
193 =back
194
195 =item ARRAYS OF HASHES
196
197 =over 4
198
199 =item Declaration of an ARRAY OF HASHES
200
201 =item Generation of an ARRAY OF HASHES
202
203 =item Access and Printing of an ARRAY OF HASHES
204
205 =back
206
207 =item HASHES OF HASHES
208
209 =over 4
210
211 =item Declaration of a HASH OF HASHES
212
213 =item Generation of a HASH OF HASHES
214
215 =item Access and Printing of a HASH OF HASHES
216
217 =back
218
219 =item MORE ELABORATE RECORDS
220
221 =over 4
222
223 =item Declaration of MORE ELABORATE RECORDS
224
225 =item Declaration of a HASH OF COMPLEX RECORDS
226
227 =item Generation of a HASH OF COMPLEX RECORDS
228
229 =back
230
231 =item Database Ties
232
233 =item SEE ALSO
234
235 =item AUTHOR
236
237 =back
238
239 =head2 perllol - Manipulating Arrays of Arrays in Perl
240
241 =over 4
242
243 =item DESCRIPTION
244
245 =over 4
246
247 =item Declaration and Access of Arrays of Arrays
248
249 =item Growing Your Own
250
251 =item Access and Printing
252
253 =item Slices
254
255 =back
256
257 =item SEE ALSO
258
259 =item AUTHOR
260
261 =back
262
263 =head2 perlrequick - Perl regular expressions quick start
264
265 =over 4
266
267 =item DESCRIPTION
268
269 =item The Guide
270
271 =over 4
272
273 =item Simple word matching
274
275 =item Using character classes
276
277 =item Matching this or that
278
279 =item Grouping things and hierarchical matching
280
281 =item Extracting matches
282
283 =item Matching repetitions
284
285 =item More matching
286
287 =item Search and replace
288
289 =item The split operator
290
291 =back
292
293 =item BUGS
294
295 =item SEE ALSO
296
297 =item AUTHOR AND COPYRIGHT
298
299 =over 4
300
301 =item Acknowledgments
302
303 =back
304
305 =back
306
307 =head2 perlretut - Perl regular expressions tutorial
308
309 =over 4
310
311 =item DESCRIPTION
312
313 =item Part 1: The basics
314
315 =over 4
316
317 =item Simple word matching
318
319 =item Using character classes
320
321 =item Matching this or that
322
323 =item Grouping things and hierarchical matching
324
325 =item Extracting matches
326
327 =item Matching repetitions
328
329 =item Building a regexp
330
331 =item Using regular expressions in Perl
332
333 =back
334
335 =item Part 2: Power tools
336
337 =over 4
338
339 =item More on characters, strings, and character classes
340
341 =item Compiling and saving regular expressions
342
343 =item Embedding comments and modifiers in a regular expression
344
345 =item Non-capturing groupings
346
347 =item Looking ahead and looking behind
348
349 =item Using independent subexpressions to prevent backtracking
350
351 =item Conditional expressions
352
353 =item A bit of magic: executing Perl code in a regular expression
354
355 =item Pragmas and debugging
356
357 =back
358
359 =item BUGS
360
361 =item SEE ALSO
362
363 =item AUTHOR AND COPYRIGHT
364
365 =over 4
366
367 =item Acknowledgments
368
369 =back
370
371 =back
372
373 =head2 perlboot - Beginner's Object-Oriented Tutorial
374
375 =over 4
376
377 =item DESCRIPTION
378
379 =over 4
380
381 =item If we could talk to the animals...
382
383 =item Introducing the method invocation arrow
384
385 =item Invoking a barnyard
386
387 =item The extra parameter of method invocation
388
389 =item Calling a second method to simplify things
390
391 =item Inheriting the windpipes
392
393 =item A few notes about @ISA
394
395 =item Overriding the methods
396
397 =item Starting the search from a different place
398
399 =item The SUPER way of doing things
400
401 =item Where we're at so far...
402
403 =item A horse is a horse, of course of course -- or is it?
404
405 =item Invoking an instance method
406
407 =item Accessing the instance data
408
409 =item How to build a horse
410
411 =item Inheriting the constructor
412
413 =item Making a method work with either classes or instances
414
415 =item Adding parameters to a method
416
417 =item More interesting instances
418
419 =item A horse of a different color
420
421 =item Summary
422
423 =back
424
425 =item SEE ALSO
426
427 =item COPYRIGHT
428
429 =back
430
431 =head2 perltoot - Tom's object-oriented tutorial for perl
432
433 =over 4
434
435 =item DESCRIPTION
436
437 =item Creating a Class
438
439 =over 4
440
441 =item Object Representation
442
443 =item Class Interface
444
445 =item Constructors and Instance Methods
446
447 =item Planning for the Future: Better Constructors
448
449 =item Destructors
450
451 =item Other Object Methods
452
453 =back
454
455 =item Class Data
456
457 =over 4
458
459 =item Accessing Class Data
460
461 =item Debugging Methods
462
463 =item Class Destructors
464
465 =item Documenting the Interface
466
467 =back
468
469 =item Aggregation
470
471 =item Inheritance
472
473 =over 4
474
475 =item Overridden Methods
476
477 =item Multiple Inheritance
478
479 =item UNIVERSAL: The Root of All Objects
480
481 =back
482
483 =item Alternate Object Representations
484
485 =over 4
486
487 =item Arrays as Objects
488
489 =item Closures as Objects
490
491 =back
492
493 =item AUTOLOAD: Proxy Methods
494
495 =over 4
496
497 =item Autoloaded Data Methods
498
499 =item Inherited Autoloaded Data Methods
500
501 =back
502
503 =item Metaclassical Tools
504
505 =over 4
506
507 =item Class::Struct
508
509 =item Data Members as Variables
510
511 =back
512
513 =item NOTES
514
515 =over 4
516
517 =item Object Terminology
518
519 =back
520
521 =item SEE ALSO
522
523 =item AUTHOR AND COPYRIGHT
524
525 =item COPYRIGHT
526
527 =over 4
528
529 =item Acknowledgments
530
531 =back
532
533 =back
534
535 =head2 perltooc - Tom's OO Tutorial for Class Data in Perl
536
537 =over 4
538
539 =item DESCRIPTION
540
541 =item Class Data in a Can
542
543 =item Class Data as Package Variables
544
545 =over 4
546
547 =item Putting All Your Eggs in One Basket
548
549 =item Inheritance Concerns
550
551 =item The Eponymous Meta-Object
552
553 =item Indirect References to Class Data
554
555 =item Monadic Classes
556
557 =item Translucent Attributes
558
559 =back
560
561 =item Class Data as Lexical Variables
562
563 =over 4
564
565 =item Privacy and Responsibility 
566
567 =item File-Scoped Lexicals
568
569 =item More Inheritance Concerns
570
571 =item Locking the Door and Throwing Away the Key
572
573 =item Translucency Revisited
574
575 =back
576
577 =item NOTES
578
579 =item SEE ALSO
580
581 =item AUTHOR AND COPYRIGHT
582
583 =item ACKNOWLEDGEMENTS
584
585 =item HISTORY
586
587 =back
588
589 =head2 perlbot - Bag'o Object Tricks (the BOT)
590
591 =over 4
592
593 =item DESCRIPTION
594
595 =item OO SCALING TIPS
596
597 =item INSTANCE VARIABLES
598
599 =item SCALAR INSTANCE VARIABLES
600
601 =item INSTANCE VARIABLE INHERITANCE
602
603 =item OBJECT RELATIONSHIPS
604
605 =item OVERRIDING SUPERCLASS METHODS
606
607 =item USING RELATIONSHIP WITH SDBM
608
609 =item THINKING OF CODE REUSE
610
611 =item CLASS CONTEXT AND THE OBJECT
612
613 =item INHERITING A CONSTRUCTOR
614
615 =item DELEGATION
616
617 =item SEE ALSO
618
619 =back
620
621 =head2 perlstyle - Perl style guide
622
623 =over 4
624
625 =item DESCRIPTION
626
627 =back
628
629 =head2 perlcheat - Perl 5 Cheat Sheet
630
631 =over 4
632
633 =item DESCRIPTION
634
635 =over 4
636
637 =item The sheet
638
639 =back
640
641 =item ACKNOWLEDGEMENTS
642
643 =item AUTHOR
644
645 =item SEE ALSO
646
647 =back
648
649 =head2 perltrap - Perl traps for the unwary
650
651 =over 4
652
653 =item DESCRIPTION
654
655 =over 4
656
657 =item Awk Traps
658
659 =item C/C++ Traps
660
661 =item Sed Traps
662
663 =item Shell Traps
664
665 =item Perl Traps
666
667 =item Perl4 to Perl5 Traps
668
669 Discontinuance, Deprecation, and BugFix traps, Parsing Traps, Numerical
670 Traps, General data type traps, Context Traps - scalar, list contexts,
671 Precedence Traps, General Regular Expression Traps using s///, etc,
672 Subroutine, Signal, Sorting Traps, OS Traps, DBM Traps, Unclassified Traps
673
674 =item Discontinuance, Deprecation, and BugFix traps
675
676 Discontinuance, Deprecation, BugFix, Discontinuance, Discontinuance,
677 Discontinuance, BugFix, Discontinuance, Discontinuance, BugFix,
678 Discontinuance, Deprecation, Discontinuance, Discontinuance
679
680 =item Parsing Traps
681
682 Parsing, Parsing, Parsing, Parsing, Parsing
683
684 =item Numerical Traps
685
686 Numerical, Numerical, Numerical, Bitwise string ops
687
688 =item General data type traps
689
690 (Arrays), (Arrays), (Hashes), (Globs), (Globs), (Scalar String),
691 (Constants), (Scalars), (Variable Suicide)
692
693 =item Context Traps - scalar, list contexts
694
695 (list context), (scalar context), (scalar context), (list, builtin)
696
697 =item Precedence Traps
698
699 Precedence, Precedence, Precedence, Precedence, Precedence, Precedence,
700 Precedence
701
702 =item General Regular Expression Traps using s///, etc.
703
704 Regular Expression, Regular Expression, Regular Expression, Regular
705 Expression, Regular Expression, Regular Expression, Regular Expression,
706 Regular Expression, Regular Expression
707
708 =item Subroutine, Signal, Sorting Traps
709
710 (Signals), (Sort Subroutine), warn() won't let you specify a filehandle
711
712 =item OS Traps
713
714 (SysV), (SysV)
715
716 =item Interpolation Traps
717
718 Interpolation, Interpolation, Interpolation, Interpolation, Interpolation,
719 Interpolation, Interpolation, Interpolation, Interpolation
720
721 =item DBM Traps
722
723 DBM, DBM
724
725 =item Unclassified Traps
726
727 C<require>/C<do> trap using returned value, C<split> on empty string with
728 LIMIT specified
729
730 =back
731
732 =back
733
734 =head2 perldebtut - Perl debugging tutorial
735
736 =over 4
737
738 =item DESCRIPTION
739
740 =item use strict
741
742 =item Looking at data and -w and v
743
744 =item help
745
746 =item Stepping through code
747
748 =item Placeholder for a, w, t, T
749
750 =item REGULAR EXPRESSIONS
751
752 =item OUTPUT TIPS
753
754 =item CGI
755
756 =item GUIs
757
758 =item SUMMARY
759
760 =item SEE ALSO
761
762 =item AUTHOR
763
764 =item CONTRIBUTORS
765
766 =back
767
768 =head2 perlfaq - frequently asked questions about Perl ($Date: 2003/01/31
769 17:37:17 $)
770
771 =over 4
772
773 =item DESCRIPTION
774
775 =over 4
776
777 =item Where to get the perlfaq
778
779 =item How to contribute to the perlfaq
780
781 =item What will happen if you mail your Perl programming problems to the
782 authors
783
784 =back
785
786 =item Credits
787
788 =item Author and Copyright Information
789
790 =over 4
791
792 =item Bundled Distributions
793
794 =item Disclaimer
795
796 =back
797
798 =item Table of Contents
799
800 perlfaq  - this document, perlfaq1 - General Questions About Perl, perlfaq2
801 - Obtaining and Learning about Perl, perlfaq3 - Programming Tools, perlfaq4
802 - Data Manipulation, perlfaq5 - Files and Formats, perlfaq6 - Regular
803 Expressions, perlfaq7 - General Perl Language Issues, perlfaq8 - System
804 Interaction, perlfaq9 - Networking
805
806 =item The Questions
807
808 =over 4
809
810 =item L<perlfaq1>: General Questions About Perl
811
812 =item L<perlfaq2>: Obtaining and Learning about Perl
813
814 =item L<perlfaq3>: Programming Tools
815
816 =item L<perlfaq4>: Data Manipulation
817
818 =item L<perlfaq5>: Files and Formats
819
820 =item L<perlfaq6>: Regular Expressions
821
822 =item L<perlfaq7>: General Perl Language Issues
823
824 =item L<perlfaq8>: System Interaction
825
826 =item L<perlfaq9>: Networking
827
828 =back
829
830 =back
831
832 =head2 perlfaq1 - General Questions About Perl ($Revision: 1.12 $, $Date:
833 2003/07/09 15:47:28 $)
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.20 $,
882 $Date: 2003/01/26 17:50:56 $)
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.33 $, $Date: 2003/01/31
938 17:34:56 $)
939
940 =over 4
941
942 =item DESCRIPTION
943
944 =over 4
945
946 =item How do I do (anything)?
947
948 =item How can I use Perl interactively?
949
950 =item Is there a Perl shell?
951
952 =item How do I find which modules are installed on my system?
953
954 =item How do I debug my Perl programs?
955
956 =item How do I profile my Perl programs?
957
958 =item How do I cross-reference my Perl programs?
959
960 =item Is there a pretty-printer (formatter) for Perl?
961
962 =item Is there a ctags for Perl?
963
964 =item Is there an IDE or Windows Perl Editor?
965
966 Komodo, The Object System, Open Perl IDE, PerlBuilder, visiPerl+, OptiPerl,
967 GNU Emacs, MicroEMACS, XEmacs, Jed, Elvis, Vile, Vim, Codewright,
968 MultiEdit, SlickEdit, Bash, Ksh, Tcsh, Zsh, BBEdit and BBEdit Lite, Alpha
969
970 =item Where can I get Perl macros for vi?
971
972 =item Where can I get perl-mode for emacs?
973
974 =item How can I use curses with Perl?
975
976 =item How can I use X or Tk with Perl?
977
978 =item How can I generate simple menus without using CGI or Tk?
979
980 =item How can I make my Perl program run faster?
981
982 =item How can I make my Perl program take less memory?
983
984 Don't slurp!, Use map and grep selectively, Avoid unnecessary quotes and
985 stringification, Pass by reference, Tie large variables to disk
986
987 =item Is it safe to return a reference to local or lexical data?
988
989 =item How can I free an array or hash so my program shrinks?
990
991 =item How can I make my CGI script more efficient?
992
993 =item How can I hide the source for my Perl program?
994
995 =item How can I compile my Perl program into byte code or C?
996
997 =item How can I compile Perl into Java?
998
999 =item How can I get C<#!perl> to work on [MS-DOS,NT,...]?
1000
1001 =item Can I write useful Perl programs on the command line?
1002
1003 =item Why don't Perl one-liners work on my DOS/Mac/VMS system?
1004
1005 =item Where can I learn about CGI or Web programming in Perl?
1006
1007 =item Where can I learn about object-oriented Perl programming?
1008
1009 =item Where can I learn about linking C with Perl? [h2xs, xsubpp]
1010
1011 =item I've read perlembed, perlguts, etc., but I can't embed perl in
1012 my C program; what am I doing wrong?
1013
1014 =item When I tried to run my script, I got this message. What does it mean?
1015
1016 =item What's MakeMaker?
1017
1018 =back
1019
1020 =item AUTHOR AND COPYRIGHT
1021
1022 =back
1023
1024 =head2 perlfaq4 - Data Manipulation ($Revision: 1.44 $, $Date: 2003/07/28
1025 17:35:21 $)
1026
1027 =over 4
1028
1029 =item DESCRIPTION
1030
1031 =item Data: Numbers
1032
1033 =over 4
1034
1035 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
1036 numbers I should be getting (eg, 19.95)?
1037
1038 =item Why isn't my octal data interpreted correctly?
1039
1040 =item Does Perl have a round() function?  What about ceil() and floor()? 
1041 Trig functions?
1042
1043 =item How do I convert between numeric representations?
1044
1045 How do I convert hexadecimal into decimal, How do I convert from decimal to
1046 hexadecimal, How do I convert from octal to decimal, How do I convert from
1047 decimal to octal, How do I convert from binary to decimal, How do I convert
1048 from decimal to binary
1049
1050 =item Why doesn't & work the way I want it to?
1051
1052 =item How do I multiply matrices?
1053
1054 =item How do I perform an operation on a series of integers?
1055
1056 =item How can I output Roman numerals?
1057
1058 =item Why aren't my random numbers random?
1059
1060 =item How do I get a random number between X and Y?
1061
1062 =back
1063
1064 =item Data: Dates
1065
1066 =over 4
1067
1068 =item How do I find the day or week of the year?
1069
1070 =item How do I find the current century or millennium?
1071
1072 =item How can I compare two dates and find the difference?
1073
1074 =item How can I take a string and turn it into epoch seconds?
1075
1076 =item How can I find the Julian Day?
1077
1078 =item How do I find yesterday's date?
1079
1080 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
1081
1082 =back
1083
1084 =item Data: Strings
1085
1086 =over 4
1087
1088 =item How do I validate input?
1089
1090 =item How do I unescape a string?
1091
1092 =item How do I remove consecutive pairs of characters?
1093
1094 =item How do I expand function calls in a string?
1095
1096 =item How do I find matching/nesting anything?
1097
1098 =item How do I reverse a string?
1099
1100 =item How do I expand tabs in a string?
1101
1102 =item How do I reformat a paragraph?
1103
1104 =item How can I access or change N characters of a string?
1105
1106 =item How do I change the Nth occurrence of something?
1107
1108 =item How can I count the number of occurrences of a substring within a
1109 string?
1110
1111 =item How do I capitalize all the words on one line?
1112
1113 =item How can I split a [character] delimited string except when inside
1114 [character]?
1115
1116 =item How do I strip blank space from the beginning/end of a string?
1117
1118 =item How do I pad a string with blanks or pad a number with zeroes?
1119
1120 =item How do I extract selected columns from a string?
1121
1122 =item How do I find the soundex value of a string?
1123
1124 =item How can I expand variables in text strings?
1125
1126 =item What's wrong with always quoting "$vars"?
1127
1128 =item Why don't my E<lt>E<lt>HERE documents work?
1129
1130 There must be no space after the E<lt>E<lt> part, There (probably) should
1131 be a semicolon at the end, You can't (easily) have any space in front of
1132 the tag
1133
1134 =back
1135
1136 =item Data: Arrays
1137
1138 =over 4
1139
1140 =item What is the difference between a list and an array?
1141
1142 =item What is the difference between $array[1] and @array[1]?
1143
1144 =item How can I remove duplicate elements from a list or array?
1145
1146 a), b), c), d), e)
1147
1148 =item How can I tell whether a certain element is contained in a list or
1149 array?
1150
1151 =item How do I compute the difference of two arrays?  How do I compute the
1152 intersection of two arrays?
1153
1154 =item How do I test whether two arrays or hashes are equal?
1155
1156 =item How do I find the first array element for which a condition is true?
1157
1158 =item How do I handle linked lists?
1159
1160 =item How do I handle circular lists?
1161
1162 =item How do I shuffle an array randomly?
1163
1164 =item How do I process/modify each element of an array?
1165
1166 =item How do I select a random element from an array?
1167
1168 =item How do I permute N elements of a list?
1169
1170 =item How do I sort an array by (anything)?
1171
1172 =item How do I manipulate arrays of bits?
1173
1174 =item Why does defined() return true on empty arrays and hashes?
1175
1176 =back
1177
1178 =item Data: Hashes (Associative Arrays)
1179
1180 =over 4
1181
1182 =item How do I process an entire hash?
1183
1184 =item What happens if I add or remove keys from a hash while iterating over
1185 it?
1186
1187 =item How do I look up a hash element by value?
1188
1189 =item How can I know how many entries are in a hash?
1190
1191 =item How do I sort a hash (optionally by value instead of key)?
1192
1193 =item How can I always keep my hash sorted?
1194
1195 =item What's the difference between "delete" and "undef" with hashes?
1196
1197 =item Why don't my tied hashes make the defined/exists distinction?
1198
1199 =item How do I reset an each() operation part-way through?
1200
1201 =item How can I get the unique keys from two hashes?
1202
1203 =item How can I store a multidimensional array in a DBM file?
1204
1205 =item How can I make my hash remember the order I put elements into it?
1206
1207 =item Why does passing a subroutine an undefined element in a hash create
1208 it?
1209
1210 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
1211 array of hashes or arrays?
1212
1213 =item How can I use a reference as a hash key?
1214
1215 =back
1216
1217 =item Data: Misc
1218
1219 =over 4
1220
1221 =item How do I handle binary data correctly?
1222
1223 =item How do I determine whether a scalar is a number/whole/integer/float?
1224
1225 =item How do I keep persistent data across program calls?
1226
1227 =item How do I print out or copy a recursive data structure?
1228
1229 =item How do I define methods for every class/object?
1230
1231 =item How do I verify a credit card checksum?
1232
1233 =item How do I pack arrays of doubles or floats for XS code?
1234
1235 =back
1236
1237 =item AUTHOR AND COPYRIGHT
1238
1239 =back
1240
1241 =head2 perlfaq5 - Files and Formats ($Revision: 1.28 $, $Date: 2003/01/26
1242 17:45:46 $)
1243
1244 =over 4
1245
1246 =item DESCRIPTION
1247
1248 =over 4
1249
1250 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
1251
1252 =item How do I change one line in a file/delete a line in a file/insert a
1253 line in the middle of a file/append to the beginning of a file?
1254
1255 =item How do I count the number of lines in a file?
1256
1257 =item How can I use Perl's C<-i> option from within a program?
1258
1259 =item How do I make a temporary file name?
1260
1261 =item How can I manipulate fixed-record-length files?
1262
1263 =item How can I make a filehandle local to a subroutine?  How do I pass
1264 filehandles between subroutines?  How do I make an array of filehandles?
1265
1266 =item How can I use a filehandle indirectly?
1267
1268 =item How can I set up a footer format to be used with write()?
1269
1270 =item How can I write() into a string?
1271
1272 =item How can I output my numbers with commas added?
1273
1274 =item How can I translate tildes (~) in a filename?
1275
1276 =item How come when I open a file read-write it wipes it out?
1277
1278 =item Why do I sometimes get an "Argument list too long" when I use
1279 E<lt>*E<gt>?
1280
1281 =item Is there a leak/bug in glob()?
1282
1283 =item How can I open a file with a leading ">" or trailing blanks?
1284
1285 =item How can I reliably rename a file?
1286
1287 =item How can I lock a file?
1288
1289 =item Why can't I just open(FH, "E<gt>file.lock")?
1290
1291 =item I still don't get locking.  I just want to increment the number in
1292 the file.  How can I do this?
1293
1294 =item All I want to do is append a small amount of text to the end of a
1295 file.  Do I still have to use locking?
1296
1297 =item How do I randomly update a binary file?
1298
1299 =item How do I get a file's timestamp in perl?
1300
1301 =item How do I set a file's timestamp in perl?
1302
1303 =item How do I print to more than one file at once?
1304
1305 =item How can I read in an entire file all at once?
1306
1307 =item How can I read in a file by paragraphs?
1308
1309 =item How can I read a single character from a file?  From the keyboard?
1310
1311 =item How can I tell whether there's a character waiting on a filehandle?
1312
1313 =item How do I do a C<tail -f> in perl?
1314
1315 =item How do I dup() a filehandle in Perl?
1316
1317 =item How do I close a file descriptor by number?
1318
1319 =item Why can't I use "C:\temp\foo" in DOS paths?  Why doesn't
1320 `C:\temp\foo.exe` work?
1321
1322 =item Why doesn't glob("*.*") get all the files?
1323
1324 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
1325 protected files?  Isn't this a bug in Perl?
1326
1327 =item How do I select a random line from a file?
1328
1329 =item Why do I get weird spaces when I print an array of lines?
1330
1331 =back
1332
1333 =item AUTHOR AND COPYRIGHT
1334
1335 =back
1336
1337 =head2 perlfaq6 - Regular Expressions ($Revision: 1.20 $, $Date: 2003/01/03
1338 20:05:28 $)
1339
1340 =over 4
1341
1342 =item DESCRIPTION
1343
1344 =over 4
1345
1346 =item How can I hope to use regular expressions without creating illegible
1347 and unmaintainable code?
1348
1349 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
1350
1351 =item I'm having trouble matching over more than one line.  What's wrong?
1352
1353 =item How can I pull out lines between two patterns that are themselves on
1354 different lines?
1355
1356 =item I put a regular expression into $/ but it didn't work. What's wrong?
1357
1358 =item How do I substitute case insensitively on the LHS while preserving
1359 case on the RHS?
1360
1361 =item How can I make C<\w> match national character sets?
1362
1363 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
1364
1365 =item How can I quote a variable to use in a regex?
1366
1367 =item What is C</o> really for?
1368
1369 =item How do I use a regular expression to strip C style comments from a
1370 file?
1371
1372 =item Can I use Perl regular expressions to match balanced text?
1373
1374 =item What does it mean that regexes are greedy?  How can I get around it?
1375
1376 =item How do I process each word on each line?
1377
1378 =item How can I print out a word-frequency or line-frequency summary?
1379
1380 =item How can I do approximate matching?
1381
1382 =item How do I efficiently match many regular expressions at once?
1383
1384 =item Why don't word-boundary searches with C<\b> work for me?
1385
1386 =item Why does using $&, $`, or $' slow my program down?
1387
1388 =item What good is C<\G> in a regular expression?
1389
1390 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
1391
1392 =item What's wrong with using grep or map in a void context?
1393
1394 =item How can I match strings with multibyte characters?
1395
1396 =item How do I match a pattern that is supplied by the user?
1397
1398 =back
1399
1400 =item AUTHOR AND COPYRIGHT
1401
1402 =back
1403
1404 =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.15 $, $Date:
1405 2003/07/24 02:17:21 $)
1406
1407 =over 4
1408
1409 =item DESCRIPTION
1410
1411 =over 4
1412
1413 =item Can I get a BNF/yacc/RE for the Perl language?
1414
1415 =item What are all these $@%&* punctuation signs, and how do I know when to
1416 use them?
1417
1418 =item Do I always/never have to quote my strings or use semicolons and
1419 commas?
1420
1421 =item How do I skip some return values?
1422
1423 =item How do I temporarily block warnings?
1424
1425 =item What's an extension?
1426
1427 =item Why do Perl operators have different precedence than C operators?
1428
1429 =item How do I declare/create a structure?
1430
1431 =item How do I create a module?
1432
1433 =item How do I create a class?
1434
1435 =item How can I tell if a variable is tainted?
1436
1437 =item What's a closure?
1438
1439 =item What is variable suicide and how can I prevent it?
1440
1441 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
1442 Regex}?
1443
1444 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
1445 Passing Methods
1446
1447 =item How do I create a static variable?
1448
1449 =item What's the difference between dynamic and lexical (static) scoping? 
1450 Between local() and my()?
1451
1452 =item How can I access a dynamic variable while a similarly named lexical
1453 is in scope?
1454
1455 =item What's the difference between deep and shallow binding?
1456
1457 =item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?
1458
1459 =item How do I redefine a builtin function, operator, or method?
1460
1461 =item What's the difference between calling a function as &foo and foo()?
1462
1463 =item How do I create a switch or case statement?
1464
1465 =item How can I catch accesses to undefined variables, functions, or
1466 methods?
1467
1468 =item Why can't a method included in this same file be found?
1469
1470 =item How can I find out my current package?
1471
1472 =item How can I comment out a large block of perl code?
1473
1474 =item How do I clear a package?
1475
1476 =item How can I use a variable as a variable name?
1477
1478 =item What does "bad interpreter" mean?
1479
1480 =back
1481
1482 =item AUTHOR AND COPYRIGHT
1483
1484 =back
1485
1486 =head2 perlfaq8 - System Interaction ($Revision: 1.17 $, $Date: 2003/01/26
1487 17:44:04 $)
1488
1489 =over 4
1490
1491 =item DESCRIPTION
1492
1493 =over 4
1494
1495 =item How do I find out which operating system I'm running under?
1496
1497 =item How come exec() doesn't return?
1498
1499 =item How do I do fancy stuff with the keyboard/screen/mouse?
1500
1501 Keyboard, Screen, Mouse
1502
1503 =item How do I print something out in color?
1504
1505 =item How do I read just one key without waiting for a return key?
1506
1507 =item How do I check whether input is ready on the keyboard?
1508
1509 =item How do I clear the screen?
1510
1511 =item How do I get the screen size?
1512
1513 =item How do I ask the user for a password?
1514
1515 =item How do I read and write the serial port?
1516
1517 lockfiles, open mode, end of line, flushing output, non-blocking input
1518
1519 =item How do I decode encrypted password files?
1520
1521 =item How do I start a process in the background?
1522
1523 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
1524
1525 =item How do I trap control characters/signals?
1526
1527 =item How do I modify the shadow password file on a Unix system?
1528
1529 =item How do I set the time and date?
1530
1531 =item How can I sleep() or alarm() for under a second?
1532
1533 =item How can I measure time under a second?
1534
1535 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
1536
1537 =item Why doesn't my sockets program work under System V (Solaris)?  What
1538 does the error message "Protocol not supported" mean?
1539
1540 =item How can I call my system's unique C functions from Perl?
1541
1542 =item Where do I get the include files to do ioctl() or syscall()?
1543
1544 =item Why do setuid perl scripts complain about kernel problems?
1545
1546 =item How can I open a pipe both to and from a command?
1547
1548 =item Why can't I get the output of a command with system()?
1549
1550 =item How can I capture STDERR from an external command?
1551
1552 =item Why doesn't open() return an error when a pipe open fails?
1553
1554 =item What's wrong with using backticks in a void context?
1555
1556 =item How can I call backticks without shell processing?
1557
1558 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
1559 ^Z on MS-DOS)?
1560
1561 =item How can I convert my shell script to perl?
1562
1563 =item Can I use perl to run a telnet or ftp session?
1564
1565 =item How can I write expect in Perl?
1566
1567 =item Is there a way to hide perl's command line from programs such as
1568 "ps"?
1569
1570 =item I {changed directory, modified my environment} in a perl script.  How
1571 come the change disappeared when I exited the script?  How do I get my
1572 changes to be visible?
1573
1574 Unix
1575
1576 =item How do I close a process's filehandle without waiting for it to
1577 complete?
1578
1579 =item How do I fork a daemon process?
1580
1581 =item How do I find out if I'm running interactively or not?
1582
1583 =item How do I timeout a slow event?
1584
1585 =item How do I set CPU limits?
1586
1587 =item How do I avoid zombies on a Unix system?
1588
1589 =item How do I use an SQL database?
1590
1591 =item How do I make a system() exit on control-C?
1592
1593 =item How do I open a file without blocking?
1594
1595 =item How do I install a module from CPAN?
1596
1597 =item What's the difference between require and use?
1598
1599 =item How do I keep my own module/library directory?
1600
1601 =item How do I add the directory my program lives in to the module/library
1602 search path?
1603
1604 =item How do I add a directory to my include path at runtime?
1605
1606 =item What is socket.ph and where do I get it?
1607
1608 =back
1609
1610 =item AUTHOR AND COPYRIGHT
1611
1612 =back
1613
1614 =head2 perlfaq9 - Networking ($Revision: 1.15 $, $Date: 2003/01/31 17:36:57
1615 $)
1616
1617 =over 4
1618
1619 =item DESCRIPTION
1620
1621 =over 4
1622
1623 =item What is the correct form of response from a CGI script?
1624
1625 =item My CGI script runs from the command line but not the browser.  (500
1626 Server Error)
1627
1628 =item How can I get better error messages from a CGI program?
1629
1630 =item How do I remove HTML from a string?
1631
1632 =item How do I extract URLs?
1633
1634 =item How do I download a file from the user's machine?  How do I open a
1635 file on another machine?
1636
1637 =item How do I make a pop-up menu in HTML?
1638
1639 =item How do I fetch an HTML file?
1640
1641 =item How do I automate an HTML form submission?
1642
1643 =item How do I decode or create those %-encodings on the web?
1644
1645 =item How do I redirect to another page?
1646
1647 =item How do I put a password on my web pages?
1648
1649 =item How do I edit my .htpasswd and .htgroup files with Perl?
1650
1651 =item How do I make sure users can't enter values into a form that cause my
1652 CGI script to do bad things?
1653
1654 =item How do I parse a mail header?
1655
1656 =item How do I decode a CGI form?
1657
1658 =item How do I check a valid mail address?
1659
1660 =item How do I decode a MIME/BASE64 string?
1661
1662 =item How do I return the user's mail address?
1663
1664 =item How do I send mail?
1665
1666 =item How do I use MIME to make an attachment to a mail message?
1667
1668 =item How do I read mail?
1669
1670 =item How do I find out my hostname/domainname/IP address?
1671
1672 =item How do I fetch a news article or the active newsgroups?
1673
1674 =item How do I fetch/put an FTP file?
1675
1676 =item How can I do RPC in Perl?
1677
1678 =back
1679
1680 =item AUTHOR AND COPYRIGHT
1681
1682 =back
1683
1684 =head2 perlsyn - Perl syntax
1685
1686 =over 4
1687
1688 =item DESCRIPTION
1689
1690 =over 4
1691
1692 =item Declarations
1693
1694 =item Comments
1695
1696 =item Simple Statements
1697
1698 =item Compound Statements
1699
1700 =item Loop Control
1701
1702 =item For Loops
1703
1704 =item Foreach Loops
1705
1706 =item Basic BLOCKs and Switch Statements
1707
1708 =item Goto
1709
1710 =item PODs: Embedded Documentation
1711
1712 =item Plain Old Comments (Not!)
1713
1714 =back
1715
1716 =back
1717
1718 =head2 perldata - Perl data types
1719
1720 =over 4
1721
1722 =item DESCRIPTION
1723
1724 =over 4
1725
1726 =item Variable names
1727
1728 =item Context
1729
1730 =item Scalar values
1731
1732 =item Scalar value constructors
1733
1734 =item List value constructors
1735
1736 =item Subscripts
1737
1738 =item Slices
1739
1740 =item Typeglobs and Filehandles
1741
1742 =back
1743
1744 =item SEE ALSO
1745
1746 =back
1747
1748 =head2 perlop - Perl operators and precedence
1749
1750 =over 4
1751
1752 =item SYNOPSIS
1753
1754 =item DESCRIPTION
1755
1756 =over 4
1757
1758 =item Terms and List Operators (Leftward)
1759
1760 =item The Arrow Operator
1761
1762 =item Auto-increment and Auto-decrement
1763
1764 =item Exponentiation
1765
1766 =item Symbolic Unary Operators
1767
1768 =item Binding Operators
1769
1770 =item Multiplicative Operators
1771
1772 =item Additive Operators
1773
1774 =item Shift Operators
1775
1776 =item Named Unary Operators
1777
1778 =item Relational Operators
1779
1780 =item Equality Operators
1781
1782 =item Bitwise And
1783
1784 =item Bitwise Or and Exclusive Or
1785
1786 =item C-style Logical And
1787
1788 =item C-style Logical Or
1789
1790 =item C-style Logical Defined-Or
1791
1792 =item Range Operators
1793
1794 =item Conditional Operator
1795
1796 =item Assignment Operators
1797
1798 =item Comma Operator
1799
1800 =item List Operators (Rightward)
1801
1802 =item Logical Not
1803
1804 =item Logical And
1805
1806 =item Logical or, Defined or, and Exclusive Or
1807
1808 =item C Operators Missing From Perl
1809
1810 unary &, unary *, (TYPE)
1811
1812 =item Quote and Quote-like Operators
1813
1814 =item Regexp Quote-Like Operators
1815
1816 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
1817 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
1818 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
1819 y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF
1820
1821 =item Gory details of parsing quoted constructs
1822
1823 Finding the end, Removal of backslashes before delimiters, Interpolation,
1824 C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
1825 C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>,
1826 C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
1827 regular expressions
1828
1829 =item I/O Operators
1830
1831 =item Constant Folding
1832
1833 =item Bitwise String Operators
1834
1835 =item Integer Arithmetic
1836
1837 =item Floating-point Arithmetic
1838
1839 =item Bigger Numbers
1840
1841 =back
1842
1843 =back
1844
1845 =head2 perlsub - Perl subroutines
1846
1847 =over 4
1848
1849 =item SYNOPSIS
1850
1851 =item DESCRIPTION
1852
1853 =over 4
1854
1855 =item Private Variables via my()
1856
1857 =item Persistent Private Variables
1858
1859 =item Temporary Values via local()
1860
1861 =item Lvalue subroutines
1862
1863 Lvalue subroutines are EXPERIMENTAL
1864
1865 =item Passing Symbol Table Entries (typeglobs)
1866
1867 =item When to Still Use local()
1868
1869 =item Pass by Reference
1870
1871 =item Prototypes
1872
1873 =item Constant Functions
1874
1875 =item Overriding Built-in Functions
1876
1877 =item Autoloading
1878
1879 =item Subroutine Attributes
1880
1881 =back
1882
1883 =item SEE ALSO
1884
1885 =back
1886
1887 =head2 perlfunc - Perl builtin functions
1888
1889 =over 4
1890
1891 =item DESCRIPTION
1892
1893 =over 4
1894
1895 =item Perl Functions by Category
1896
1897 Functions for SCALARs or strings, Regular expressions and pattern matching,
1898 Numeric functions, Functions for real @ARRAYs, Functions for list data,
1899 Functions for real %HASHes, Input and output functions, Functions for fixed
1900 length data or records, Functions for filehandles, files, or directories,
1901 Keywords related to the control flow of your perl program, Keywords related
1902 to scoping, Miscellaneous functions, Functions for processes and process
1903 groups, Keywords related to perl modules, Keywords related to classes and
1904 object-orientedness, Low-level socket functions, System V interprocess
1905 communication functions, Fetching user and group info, Fetching network
1906 info, Time-related functions, Functions new in perl5, Functions obsoleted
1907 in perl5
1908
1909 =item Portability
1910
1911 =item Alphabetical Listing of Perl Functions
1912
1913 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, abs VALUE, abs, accept
1914 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
1915 binmode FILEHANDLE, LAYER, binmode FILEHANDLE, bless REF,CLASSNAME, bless
1916 REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE, chomp(
1917 LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr NUMBER,
1918 chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE,
1919 connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT,
1920 dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete
1921 EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump,
1922 each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST,
1923 exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl
1924 FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION,
1925 fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin,
1926 getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam
1927 NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname
1928 NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr
1929 ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
1930 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
1931 getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent
1932 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
1933 endhostent, endnetent, endprotoent, endservent, getsockname SOCKET,
1934 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL,
1935 goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex,
1936 import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
1937 FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST,
1938 last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length,
1939 link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR,
1940 lock THING, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map
1941 EXPR,LIST, mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget
1942 KEY,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my
1943 TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL, next, no
1944 Module VERSION LIST, no Module VERSION, no Module LIST, no Module, oct
1945 EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open
1946 FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE,MODE,REFERENCE, open FILEHANDLE,
1947 opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR TYPE, our EXPR :
1948 ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST, package NAMESPACE,
1949 package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos,
1950 print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST,
1951 printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/,
1952 qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta,
1953 rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
1954 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
1955 readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
1956 ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR,
1957 require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir
1958 DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME,
1959 rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir
1960 DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT,
1961 semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
1962 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
1963 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
1964 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
1965 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
1966 EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
1967 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
1968 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
1969 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split
1970 /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, format
1971 parameter index, flags, vector flag, (minimum) width, precision, or maximum
1972 width, size, order of arguments, sqrt EXPR, sqrt, srand EXPR, srand, stat
1973 FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub NAME BLOCK, sub NAME
1974 (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK,
1975 substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
1976 EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
1977 FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
1978 FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
1979 FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite
1980 FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH,
1981 syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie
1982 VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate
1983 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR,
1984 ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack
1985 TEMPLATE,EXPR, unpack TEMPLATE, untie VARIABLE, unshift ARRAY,LIST, use
1986 Module VERSION LIST, use Module VERSION, use Module LIST, use Module, use
1987 VERSION, utime LIST, values HASH, vec EXPR,OFFSET,BITS, wait, waitpid
1988 PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y///
1989
1990 =back
1991
1992 =back
1993
1994 =head2 perlopentut - tutorial on opening things in Perl
1995
1996 =over 4
1997
1998 =item DESCRIPTION
1999
2000 =item Open E<agrave> la shell
2001
2002 =over 4
2003
2004 =item Simple Opens
2005
2006 =item Indirect Filehandles
2007
2008 =item Pipe Opens
2009
2010 =item The Minus File
2011
2012 =item Mixing Reads and Writes
2013
2014 =item Filters 
2015
2016 =back
2017
2018 =item Open E<agrave> la C
2019
2020 =over 4
2021
2022 =item Permissions E<agrave> la mode
2023
2024 =back
2025
2026 =item Obscure Open Tricks
2027
2028 =over 4
2029
2030 =item Re-Opening Files (dups)
2031
2032 =item Dispelling the Dweomer
2033
2034 =item Paths as Opens
2035
2036 =item Single Argument Open
2037
2038 =item Playing with STDIN and STDOUT
2039
2040 =back
2041
2042 =item Other I/O Issues
2043
2044 =over 4
2045
2046 =item Opening Non-File Files
2047
2048 =item Opening Named Pipes
2049
2050 =item Opening Sockets
2051
2052 =item Binary Files
2053
2054 =item File Locking
2055
2056 =item IO Layers
2057
2058 =back
2059
2060 =item SEE ALSO 
2061
2062 =item AUTHOR and COPYRIGHT
2063
2064 =item HISTORY
2065
2066 =back
2067
2068 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
2069
2070 =over 4
2071
2072 =item DESCRIPTION
2073
2074 =item The Basic Principle
2075
2076 =item Packing Text
2077
2078 =item Packing Numbers
2079
2080 =over 4
2081
2082 =item Integers
2083
2084 =item Unpacking a Stack Frame
2085
2086 =item How to Eat an Egg on a Net
2087
2088 =item Floating point Numbers
2089
2090 =back
2091
2092 =item Exotic Templates
2093
2094 =over 4
2095
2096 =item Bit Strings
2097
2098 =item Uuencoding
2099
2100 =item Doing Sums
2101
2102 =item  Unicode
2103
2104 =item Another Portable Binary Encoding
2105
2106 =back
2107
2108 =item Template Grouping
2109
2110 =item Lengths and Widths
2111
2112 =over 4
2113
2114 =item String Lengths
2115
2116 =item Dynamic Templates
2117
2118 =item Counting Repetitions
2119
2120 =back
2121
2122 =item Packing and Unpacking C Structures
2123
2124 =over 4
2125
2126 =item The Alignment Pit
2127
2128 =item Alignment, Take 2
2129
2130 =item Alignment, Take 3
2131
2132 =item Pointers for How to Use Them
2133
2134 =back
2135
2136 =item Pack Recipes
2137
2138 =item Funnies Section
2139
2140 =item Authors
2141
2142 =back
2143
2144 =head2 perlpod - the Plain Old Documentation format
2145
2146 =over 4
2147
2148 =item DESCRIPTION
2149
2150 =over 4
2151
2152 =item Ordinary Paragraph
2153
2154 =item Verbatim Paragraph
2155
2156 =item Command Paragraph
2157
2158 C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
2159 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item
2160 I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end
2161 I<formatname>>, C<=for I<formatname> I<text...>>
2162
2163 =item Formatting Codes
2164
2165 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2166 C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink,
2167 C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used
2168 for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces,
2169 C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null
2170 (zero-effect) formatting code
2171
2172 =item The Intent
2173
2174 =item Embedding Pods in Perl Modules
2175
2176 =item Hints for Writing Pod
2177
2178 =back
2179
2180 =item SEE ALSO
2181
2182 =item AUTHOR
2183
2184 =back
2185
2186 =head2 perlpodspec - Plain Old Documentation: format specification and
2187 notes
2188
2189 =over 4
2190
2191 =item DESCRIPTION
2192
2193 =item Pod Definitions
2194
2195 =item Pod Commands
2196
2197 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
2198 "=back", "=begin formatname", "=end formatname", "=for formatname text..."
2199
2200 =item Pod Formatting Codes
2201
2202 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2203 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
2204 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
2205 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
2206 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
2207 contains non-breaking spaces
2208
2209 =item Notes on Implementing Pod Processors
2210
2211 =item About LE<lt>...E<gt> Codes
2212
2213 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
2214
2215 =item About =over...=back Regions
2216
2217 =item About Data Paragraphs and "=begin/=end" Regions
2218
2219 =item SEE ALSO
2220
2221 =item AUTHOR
2222
2223 =back
2224
2225 =head2 perlrun - how to execute the Perl interpreter
2226
2227 =over 4
2228
2229 =item SYNOPSIS
2230
2231 =item DESCRIPTION
2232
2233 =over 4
2234
2235 =item #! and quoting on non-Unix systems
2236
2237 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
2238
2239 =item Location of Perl
2240
2241 =item Command Switches
2242
2243 B<-0>[I<octal/hexadecimal>], B<-A [I<assertions>]>, B<-a>, B<-C
2244 [I<number/list>]>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>, B<-D>I<letters>,
2245 B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>, B<-h>,
2246 B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
2247 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
2248 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
2249 B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>,
2250 B<-X>, B<-x> I<directory>
2251
2252 =back
2253
2254 =item ENVIRONMENT
2255
2256 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
2257 :perlio, :pop, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
2258 PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS,
2259 PERL_DESTRUCT_LEVEL, PERL_ENCODING, PERL_HASH_SEED, PERL_HASH_SEED_DEBUG,
2260 PERL_ROOT (specific to the VMS port), PERL_SIGNALS, PERL_UNICODE, SYS$LOGIN
2261 (specific to the VMS port)
2262
2263 =back
2264
2265 =head2 perldiag - various Perl diagnostics
2266
2267 =over 4
2268
2269 =item DESCRIPTION
2270
2271 =back
2272
2273 =head2 perllexwarn - Perl Lexical Warnings
2274
2275 =over 4
2276
2277 =item DESCRIPTION
2278
2279 =over 4
2280
2281 =item Default Warnings and Optional Warnings
2282
2283 =item What's wrong with B<-w> and C<$^W>
2284
2285 =item Controlling Warnings from the Command Line
2286
2287 B<-w>, B<-W>, B<-X>
2288
2289 =item Backward Compatibility
2290
2291 =item Category Hierarchy
2292
2293 =item Fatal Warnings
2294
2295 =item Reporting Warnings from a Module
2296
2297 =back
2298
2299 =item TODO
2300
2301 =item SEE ALSO
2302
2303 =item AUTHOR
2304
2305 =back
2306
2307 =head2 perldebug - Perl debugging
2308
2309 =over 4
2310
2311 =item DESCRIPTION
2312
2313 =item The Perl Debugger
2314
2315 =over 4
2316
2317 =item Debugger Commands
2318
2319 h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y
2320 [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l
2321 min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/,
2322 ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b
2323 subname [condition], b postpone subname [condition], b load filename, b
2324 compile subname, B line, B *, a [line] command, A line, A *, w expr, W
2325 expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [
2326 command ], < *, << command, > ?, > command, > *, >> command, { ?, { [
2327 command ], { *, {{ command, ! number, ! -number, ! pattern, !! cmd, source
2328 file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man
2329 [manpage]
2330
2331 =item Configurable Options
2332
2333 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
2334 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
2335 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
2336 C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
2337 C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
2338 C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
2339 C<NonStop>
2340
2341 =item Debugger input/output
2342
2343 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
2344 listing
2345
2346 =item Debugging compile-time statements
2347
2348 =item Debugger Customization
2349
2350 =item Readline Support
2351
2352 =item Editor Support for Debugging
2353
2354 =item The Perl Profiler
2355
2356 =back
2357
2358 =item Debugging regular expressions
2359
2360 =item Debugging memory usage
2361
2362 =item SEE ALSO
2363
2364 =item BUGS
2365
2366 =back
2367
2368 =head2 perlvar - Perl predefined variables
2369
2370 =over 4
2371
2372 =item DESCRIPTION
2373
2374 =over 4
2375
2376 =item Predefined Names
2377
2378 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
2379 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+,
2380 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
2381 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
2382 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
2383 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
2384 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
2385 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $OFMT, $#,
2386 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
2387 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
2388 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
2389 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
2390 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
2391 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
2392 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
2393 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
2394 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
2395 IO::Handle->format_line_break_characters EXPR,
2396 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
2397 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
2398 $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
2399 $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
2400 $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
2401 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
2402 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
2403 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
2404 0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R,
2405 $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, ${^UNICODE},
2406 $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, $EXECUTABLE_NAME, $^X,
2407 ARGV, $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG,
2408 $SIG{expr}
2409
2410 =item Error Indicators
2411
2412 =item Technical Note on the Syntax of Variable Names
2413
2414 =back
2415
2416 =item BUGS
2417
2418 =back
2419
2420 =head2 perlre - Perl regular expressions
2421
2422 =over 4
2423
2424 =item DESCRIPTION
2425
2426 i, m, s, x
2427
2428 =over 4
2429
2430 =item Regular Expressions
2431
2432 [1], [2], [3], cntrl, graph, print, punct, xdigit
2433
2434 =item Extended Patterns
2435
2436 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
2437 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
2438 code })>, C<(??{ code })>, C<< (?>pattern) >>,
2439 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
2440
2441 =item Backtracking
2442
2443 =item Version 8 Regular Expressions
2444
2445 =item Warning on \1 vs $1
2446
2447 =item Repeated patterns matching zero-length substring
2448
2449 =item Combining pieces together
2450
2451 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
2452 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
2453 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
2454 C<(?(condition)yes-pattern|no-pattern)>
2455
2456 =item Creating custom RE engines
2457
2458 =back
2459
2460 =item BUGS
2461
2462 =item SEE ALSO
2463
2464 =back
2465
2466 =head2 perlreref - Perl Regular Expressions Reference
2467
2468 =over 4
2469
2470 =item DESCRIPTION
2471
2472 =over 4
2473
2474 =item OPERATORS
2475
2476 =item SYNTAX
2477
2478 =item ESCAPE SEQUENCES
2479
2480 =item CHARACTER CLASSES
2481
2482 =item ANCHORS
2483
2484 =item QUANTIFIERS
2485
2486 =item EXTENDED CONSTRUCTS
2487
2488 =item VARIABLES
2489
2490 =item FUNCTIONS
2491
2492 =item TERMINOLOGY
2493
2494 =back
2495
2496 =item AUTHOR
2497
2498 =item SEE ALSO
2499
2500 =item THANKS
2501
2502 =back
2503
2504 =head2 perlref - Perl references and nested data structures
2505
2506 =over 4
2507
2508 =item NOTE
2509
2510 =item DESCRIPTION
2511
2512 =over 4
2513
2514 =item Making References
2515
2516 =item Using References
2517
2518 =item Symbolic references
2519
2520 =item Not-so-symbolic references
2521
2522 =item Pseudo-hashes: Using an array as a hash
2523
2524 =item Function Templates
2525
2526 =back
2527
2528 =item WARNING
2529
2530 =item SEE ALSO
2531
2532 =back
2533
2534 =head2 perlform - Perl formats
2535
2536 =over 4
2537
2538 =item DESCRIPTION
2539
2540 =over 4
2541
2542 =item Format Variables
2543
2544 =back
2545
2546 =item NOTES
2547
2548 =over 4
2549
2550 =item Footers
2551
2552 =item Accessing Formatting Internals
2553
2554 =back
2555
2556 =item WARNINGS
2557
2558 =back
2559
2560 =head2 perlobj - Perl objects
2561
2562 =over 4
2563
2564 =item DESCRIPTION
2565
2566 =over 4
2567
2568 =item An Object is Simply a Reference
2569
2570 =item A Class is Simply a Package
2571
2572 =item A Method is Simply a Subroutine
2573
2574 =item Method Invocation
2575
2576 =item Indirect Object Syntax
2577
2578 =item Default UNIVERSAL methods
2579
2580 isa(CLASS), can(METHOD), VERSION( [NEED] )
2581
2582 =item Destructors
2583
2584 =item Summary
2585
2586 =item Two-Phased Garbage Collection
2587
2588 =back
2589
2590 =item SEE ALSO
2591
2592 =back
2593
2594 =head2 perltie - how to hide an object class in a simple variable
2595
2596 =over 4
2597
2598 =item SYNOPSIS
2599
2600 =item DESCRIPTION
2601
2602 =over 4
2603
2604 =item Tying Scalars
2605
2606 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
2607 DESTROY this
2608
2609 =item Tying Arrays
2610
2611 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
2612 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
2613 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
2614 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
2615 this
2616
2617 =item Tying Hashes
2618
2619 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
2620 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
2621 this, NEXTKEY this, lastkey, UNTIE this, DESTROY this
2622
2623 =item Tying FileHandles
2624
2625 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
2626 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
2627 DESTROY this
2628
2629 =item UNTIE this
2630
2631 =item The C<untie> Gotcha
2632
2633 =back
2634
2635 =item SEE ALSO
2636
2637 =item BUGS
2638
2639 =item AUTHOR
2640
2641 =back
2642
2643 =head2 perldbmfilter - Perl DBM Filters
2644
2645 =over 4
2646
2647 =item SYNOPSIS
2648
2649 =item DESCRIPTION
2650
2651 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
2652 B<filter_fetch_value>
2653
2654 =over 4
2655
2656 =item The Filter
2657
2658 =item An Example -- the NULL termination problem.
2659
2660 =item Another Example -- Key is a C int.
2661
2662 =back
2663
2664 =item SEE ALSO
2665
2666 =item AUTHOR
2667
2668 =back
2669
2670 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
2671 safe subprocesses, sockets, and semaphores)
2672
2673 =over 4
2674
2675 =item DESCRIPTION
2676
2677 =item Signals
2678
2679 =over 4
2680
2681 =item Handling the SIGHUP Signal in Daemons
2682
2683 =back
2684
2685 =item Named Pipes
2686
2687 =over 4
2688
2689 =item Deferred Signals (Safe Signals)
2690
2691 Long running opcodes, Interrupting IO, Restartable system calls, Signals as
2692 "faults", Signals triggered by operating system state
2693
2694 =back
2695
2696 =item Using open() for IPC
2697
2698 =over 4
2699
2700 =item Filehandles
2701
2702 =item Background Processes
2703
2704 =item Complete Dissociation of Child from Parent
2705
2706 =item Safe Pipe Opens
2707
2708 =item Bidirectional Communication with Another Process
2709
2710 =item Bidirectional Communication with Yourself
2711
2712 =back
2713
2714 =item Sockets: Client/Server Communication
2715
2716 =over 4
2717
2718 =item Internet Line Terminators
2719
2720 =item Internet TCP Clients and Servers
2721
2722 =item Unix-Domain TCP Clients and Servers
2723
2724 =back
2725
2726 =item TCP Clients with IO::Socket
2727
2728 =over 4
2729
2730 =item A Simple Client
2731
2732 C<Proto>, C<PeerAddr>, C<PeerPort>
2733
2734 =item A Webget Client
2735
2736 =item Interactive Client with IO::Socket
2737
2738 =back
2739
2740 =item TCP Servers with IO::Socket
2741
2742 Proto, LocalPort, Listen, Reuse
2743
2744 =item UDP: Message Passing
2745
2746 =item SysV IPC
2747
2748 =item NOTES
2749
2750 =item BUGS
2751
2752 =item AUTHOR
2753
2754 =item SEE ALSO
2755
2756 =back
2757
2758 =head2 perlfork - Perl's fork() emulation
2759
2760 =over 4
2761
2762 =item SYNOPSIS
2763
2764 =item DESCRIPTION
2765
2766 =over 4
2767
2768 =item Behavior of other Perl features in forked pseudo-processes
2769
2770 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
2771 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
2772 files, directories and network sockets
2773
2774 =item Resource limits
2775
2776 =item Killing the parent process
2777
2778 =item Lifetime of the parent process and pseudo-processes
2779
2780 =item CAVEATS AND LIMITATIONS
2781
2782 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
2783 Global state maintained by XSUBs, Interpreter embedded in larger
2784 application, Thread-safety of extensions
2785
2786 =back
2787
2788 =item BUGS
2789
2790 =item AUTHOR
2791
2792 =item SEE ALSO
2793
2794 =back
2795
2796 =head2 perlnumber - semantics of numbers and numeric operations in Perl
2797
2798 =over 4
2799
2800 =item SYNOPSIS
2801
2802 =item DESCRIPTION
2803
2804 =item Storing numbers
2805
2806 =item Numeric operators and numeric conversions
2807
2808 =item Flavors of Perl numeric operations
2809
2810 Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other
2811 mathematical operators, Bitwise operators, Bitwise operators during C<use
2812 integer>, Operators which expect an integer, Operators which expect a
2813 string
2814
2815 =item AUTHOR
2816
2817 =item SEE ALSO
2818
2819 =back
2820
2821 =head2 perlthrtut - tutorial on threads in Perl
2822
2823 =over 4
2824
2825 =item DESCRIPTION
2826
2827 =item Status
2828
2829 =item What Is A Thread Anyway?
2830
2831 =item Threaded Program Models
2832
2833 =over 4
2834
2835 =item Boss/Worker
2836
2837 =item Work Crew
2838
2839 =item Pipeline
2840
2841 =back
2842
2843 =item What kind of threads are Perl threads?
2844
2845 =item Thread-Safe Modules
2846
2847 =item Thread Basics
2848
2849 =over 4
2850
2851 =item Basic Thread Support
2852
2853 =item A Note about the Examples
2854
2855 =item Creating Threads
2856
2857 =item Waiting For A Thread To Exit
2858
2859 =item Ignoring A Thread
2860
2861 =back
2862
2863 =item Threads And Data
2864
2865 =over 4
2866
2867 =item Shared And Unshared Data
2868
2869 =item Thread Pitfalls: Races
2870
2871 =back
2872
2873 =item Synchronization and control
2874
2875 =over 4
2876
2877 =item Controlling access: lock()
2878
2879 =item A Thread Pitfall: Deadlocks
2880
2881 =item Queues: Passing Data Around
2882
2883 =item Semaphores: Synchronizing Data Access
2884
2885 =item Basic semaphores
2886
2887 =item Advanced Semaphores
2888
2889 =item cond_wait() and cond_signal()
2890
2891 =item Giving up control
2892
2893 =back
2894
2895 =item General Thread Utility Routines
2896
2897 =over 4
2898
2899 =item What Thread Am I In?
2900
2901 =item Thread IDs
2902
2903 =item Are These Threads The Same?
2904
2905 =item What Threads Are Running?
2906
2907 =back
2908
2909 =item A Complete Example
2910
2911 =item Different implementations of threads
2912
2913 =item Performance considerations
2914
2915 =item Process-scope Changes
2916
2917 =item Thread-Safety of System Libraries
2918
2919 =item Conclusion
2920
2921 =item Bibliography
2922
2923 =over 4
2924
2925 =item Introductory Texts
2926
2927 =item OS-Related References
2928
2929 =item Other References
2930
2931 =back
2932
2933 =item Acknowledgements
2934
2935 =item AUTHOR
2936
2937 =item Copyrights
2938
2939 =back
2940
2941 =head2 perlothrtut - old tutorial on threads in Perl
2942
2943 =over 4
2944
2945 =item DESCRIPTION
2946
2947 =item What Is A Thread Anyway?
2948
2949 =item Threaded Program Models
2950
2951 =over 4
2952
2953 =item Boss/Worker
2954
2955 =item Work Crew
2956
2957 =item Pipeline
2958
2959 =back
2960
2961 =item Native threads
2962
2963 =item What kind of threads are perl threads?
2964
2965 =item Threadsafe Modules
2966
2967 =item Thread Basics
2968
2969 =over 4
2970
2971 =item Basic Thread Support
2972
2973 =item Creating Threads
2974
2975 =item Giving up control
2976
2977 =item Waiting For A Thread To Exit
2978
2979 =item Errors In Threads
2980
2981 =item Ignoring A Thread
2982
2983 =back
2984
2985 =item Threads And Data
2986
2987 =over 4
2988
2989 =item Shared And Unshared Data
2990
2991 =item Thread Pitfall: Races
2992
2993 =item Controlling access: lock()
2994
2995 =item Thread Pitfall: Deadlocks
2996
2997 =item Queues: Passing Data Around
2998
2999 =back
3000
3001 =item Threads And Code
3002
3003 =over 4
3004
3005 =item Semaphores: Synchronizing Data Access
3006
3007 Basic semaphores, Advanced Semaphores
3008
3009 =item Attributes: Restricting Access To Subroutines
3010
3011 =item Subroutine Locks
3012
3013 =item Methods
3014
3015 =item Locking A Subroutine
3016
3017 =back
3018
3019 =item General Thread Utility Routines
3020
3021 =over 4
3022
3023 =item What Thread Am I In?
3024
3025 =item Thread IDs
3026
3027 =item Are These Threads The Same?
3028
3029 =item What Threads Are Running?
3030
3031 =back
3032
3033 =item A Complete Example
3034
3035 =item Conclusion
3036
3037 =item Bibliography
3038
3039 =over 4
3040
3041 =item Introductory Texts
3042
3043 =item OS-Related References
3044
3045 =item Other References
3046
3047 =back
3048
3049 =item Acknowledgements
3050
3051 =item AUTHOR
3052
3053 =item Copyrights
3054
3055 =back
3056
3057 =head2 perlport - Writing portable Perl
3058
3059 =over 4
3060
3061 =item DESCRIPTION
3062
3063 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
3064 portable
3065
3066 =item ISSUES
3067
3068 =over 4
3069
3070 =item Newlines
3071
3072 =item Numbers endianness and Width
3073
3074 =item Files and Filesystems
3075
3076 =item System Interaction
3077
3078 =item Command names versus file pathnames
3079
3080 =item Networking
3081
3082 =item Interprocess Communication (IPC)
3083
3084 =item External Subroutines (XS)
3085
3086 =item Standard Modules
3087
3088 =item Time and Date
3089
3090 =item Character sets and character encoding
3091
3092 =item Internationalisation
3093
3094 =item System Resources
3095
3096 =item Security
3097
3098 =item Style
3099
3100 =back
3101
3102 =item CPAN Testers
3103
3104 Mailing list: cpan-testers@perl.org, Testing results:
3105 http://testers.cpan.org/
3106
3107 =item PLATFORMS
3108
3109 =over 4
3110
3111 =item Unix
3112
3113 =item DOS and Derivatives
3114
3115 =item S<Mac OS>
3116
3117 =item VMS
3118
3119 =item VOS
3120
3121 =item EBCDIC Platforms
3122
3123 =item Acorn RISC OS
3124
3125 =item Other perls
3126
3127 =back
3128
3129 =item FUNCTION IMPLEMENTATIONS
3130
3131 =over 4
3132
3133 =item Alphabetical Listing of Perl Functions
3134
3135 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
3136 FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
3137 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
3138 LIST, exit EXPR, exit, fcntl FILEHANDLE,FUNCTION,SCALAR, flock
3139 FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, getpriority
3140 WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, getpwuid UID,
3141 getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
3142 getservbyport PORT,PROTO, getpwent, getgrent, gethostbyname, gethostent,
3143 getnetent, getprotoent, getservent, sethostent STAYOPEN, setnetent
3144 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
3145 endhostent, endnetent, endprotoent, endservent, getsockopt
3146 SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR,
3147 kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR,
3148 lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv
3149 ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open FILEHANDLE, pipe
3150 READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select
3151 RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
3152 KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
3153 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
3154 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
3155 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
3156 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
3157 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
3158 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
3159 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
3160 wait, waitpid PID,FLAGS
3161
3162 =back
3163
3164 =item CHANGES
3165
3166 v1.49, 12 August 2002, v1.48, 02 February 2001, v1.47, 22 March 2000,
3167 v1.46, 12 February 2000, v1.45, 20 December 1999, v1.44, 19 July 1999,
3168 v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May 1999, v1.40, 11 April
3169 1999, v1.39, 11 February 1999, v1.38, 31 December 1998, v1.37, 19 December
3170 1998, v1.36, 9 September 1998, v1.35, 13 August 1998, v1.33, 06 August
3171 1998, v1.32, 05 August 1998, v1.30, 03 August 1998, v1.23, 10 July 1998
3172
3173 =item Supported Platforms
3174
3175 =item SEE ALSO
3176
3177 =item AUTHORS / CONTRIBUTORS
3178
3179 =back
3180
3181 =head2 perllocale - Perl locale handling (internationalization and
3182 localization)
3183
3184 =over 4
3185
3186 =item DESCRIPTION
3187
3188 =item PREPARING TO USE LOCALES
3189
3190 =item USING LOCALES
3191
3192 =over 4
3193
3194 =item The use locale pragma
3195
3196 =item The setlocale function
3197
3198 =item Finding locales
3199
3200 =item LOCALE PROBLEMS
3201
3202 =item Temporarily fixing locale problems
3203
3204 =item Permanently fixing locale problems
3205
3206 =item Permanently fixing your system's locale configuration
3207
3208 =item Fixing system locale configuration
3209
3210 =item The localeconv function
3211
3212 =item I18N::Langinfo
3213
3214 =back
3215
3216 =item LOCALE CATEGORIES
3217
3218 =over 4
3219
3220 =item Category LC_COLLATE: Collation
3221
3222 =item Category LC_CTYPE: Character Types
3223
3224 =item Category LC_NUMERIC: Numeric Formatting
3225
3226 =item Category LC_MONETARY: Formatting of monetary amounts
3227
3228 =item LC_TIME
3229
3230 =item Other categories
3231
3232 =back
3233
3234 =item SECURITY
3235
3236 =item ENVIRONMENT
3237
3238 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
3239 LC_NUMERIC, LC_TIME, LANG
3240
3241 =item NOTES
3242
3243 =over 4
3244
3245 =item Backward compatibility
3246
3247 =item I18N:Collate obsolete
3248
3249 =item Sort speed and memory use impacts
3250
3251 =item write() and LC_NUMERIC
3252
3253 =item Freely available locale definitions
3254
3255 =item I18n and l10n
3256
3257 =item An imperfect standard
3258
3259 =back
3260
3261 =item Unicode and UTF-8
3262
3263 =item BUGS
3264
3265 =over 4
3266
3267 =item Broken systems
3268
3269 =back
3270
3271 =item SEE ALSO
3272
3273 =item HISTORY
3274
3275 =back
3276
3277 =head2 perluniintro - Perl Unicode introduction
3278
3279 =over 4
3280
3281 =item DESCRIPTION
3282
3283 =over 4
3284
3285 =item Unicode
3286
3287 =item Perl's Unicode Support
3288
3289 =item Perl's Unicode Model
3290
3291 =item Unicode and EBCDIC
3292
3293 =item Creating Unicode
3294
3295 =item Handling Unicode
3296
3297 =item Legacy Encodings
3298
3299 =item Unicode I/O
3300
3301 =item Displaying Unicode As Text
3302
3303 =item Special Cases
3304
3305 =item Advanced Topics
3306
3307 =item Miscellaneous
3308
3309 =item Questions With Answers
3310
3311 =item Hexadecimal Notation
3312
3313 =item Further Resources
3314
3315 =back
3316
3317 =item UNICODE IN OLDER PERLS
3318
3319 =item SEE ALSO
3320
3321 =item ACKNOWLEDGMENTS
3322
3323 =item AUTHOR, COPYRIGHT, AND LICENSE
3324
3325 =back
3326
3327 =head2 perlunicode - Unicode support in Perl
3328
3329 =over 4
3330
3331 =item DESCRIPTION
3332
3333 =over 4
3334
3335 =item Important Caveats
3336
3337 Input and Output Layers, Regular Expressions, C<use utf8> still needed to
3338 enable UTF-8/UTF-EBCDIC in scripts
3339
3340 =item Byte and Character Semantics
3341
3342 =item Effects of Character Semantics
3343
3344 =item Scripts
3345
3346 =item Blocks
3347
3348 =item User-Defined Character Properties
3349
3350 =item Character Encodings for Input and Output
3351
3352 =item Unicode Regular Expression Support Level
3353
3354 =item Unicode Encodings
3355
3356 =item Security Implications of Unicode
3357
3358 =item Unicode in Perl on EBCDIC
3359
3360 =item Locales
3361
3362 =item When Unicode Does Not Happen
3363
3364 =item Forcing Unicode in Perl (Or Unforcing Unicode in Perl)
3365
3366 =item Using Unicode in XS
3367
3368 =back
3369
3370 =item BUGS
3371
3372 =over 4
3373
3374 =item Interaction with Locales
3375
3376 =item Interaction with Extensions
3377
3378 =item Speed
3379
3380 =item Porting code from perl-5.6.X
3381
3382 =back
3383
3384 =item SEE ALSO
3385
3386 =back
3387
3388 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
3389
3390 =over 4
3391
3392 =item DESCRIPTION
3393
3394 =item COMMON CHARACTER CODE SETS
3395
3396 =over 4
3397
3398 =item ASCII
3399
3400 =item ISO 8859
3401
3402 =item Latin 1 (ISO 8859-1)
3403
3404 =item EBCDIC
3405
3406 =item 13 variant characters
3407
3408 =item 0037
3409
3410 =item 1047
3411
3412 =item POSIX-BC
3413
3414 =item Unicode code points versus EBCDIC code points
3415
3416 =item Remaining Perl Unicode problems in EBCDIC
3417
3418 =item Unicode and UTF
3419
3420 =item Using Encode
3421
3422 =back
3423
3424 =item SINGLE OCTET TABLES
3425
3426 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
3427
3428 =item IDENTIFYING CHARACTER CODE SETS
3429
3430 =item CONVERSIONS
3431
3432 =over 4
3433
3434 =item tr///
3435
3436 =item iconv
3437
3438 =item C RTL
3439
3440 =back
3441
3442 =item OPERATOR DIFFERENCES
3443
3444 =item FUNCTION DIFFERENCES
3445
3446 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
3447
3448 =item REGULAR EXPRESSION DIFFERENCES
3449
3450 =item SOCKETS
3451
3452 =item SORTING
3453
3454 =over 4
3455
3456 =item Ignore ASCII vs. EBCDIC sort differences.
3457
3458 =item MONO CASE then sort data.
3459
3460 =item Convert, sort data, then re convert.
3461
3462 =item Perform sorting on one type of machine only.
3463
3464 =back
3465
3466 =item TRANSFORMATION FORMATS
3467
3468 =over 4
3469
3470 =item URL decoding and encoding
3471
3472 =item uu encoding and decoding
3473
3474 =item Quoted-Printable encoding and decoding
3475
3476 =item Caesarian ciphers
3477
3478 =back
3479
3480 =item Hashing order and checksums
3481
3482 =item I18N AND L10N
3483
3484 =item MULTI OCTET CHARACTER SETS
3485
3486 =item OS ISSUES
3487
3488 =over 4
3489
3490 =item OS/400
3491
3492 PASE, IFS access
3493
3494 =item OS/390, z/OS
3495
3496 chcp, dataset access, OS/390, z/OS iconv, locales
3497
3498 =item VM/ESA?
3499
3500 =item POSIX-BC?
3501
3502 =back
3503
3504 =item BUGS
3505
3506 =item SEE ALSO
3507
3508 =item REFERENCES
3509
3510 =item HISTORY
3511
3512 =item AUTHOR
3513
3514 =back
3515
3516 =head2 perlsec - Perl security
3517
3518 =over 4
3519
3520 =item DESCRIPTION
3521
3522 =over 4
3523
3524 =item Laundering and Detecting Tainted Data
3525
3526 =item Switches On the "#!" Line
3527
3528 =item Cleaning Up Your Path
3529
3530 =item Security Bugs
3531
3532 =item Protecting Your Programs
3533
3534 =item Unicode
3535
3536 =item Algorithmic Complexity Attacks
3537
3538 =back
3539
3540 =item SEE ALSO
3541
3542 =back
3543
3544 =head2 perlmod - Perl modules (packages and symbol tables)
3545
3546 =over 4
3547
3548 =item DESCRIPTION
3549
3550 =over 4
3551
3552 =item Packages
3553
3554 =item Symbol Tables
3555
3556 =item Package Constructors and Destructors
3557
3558 =item Perl Classes
3559
3560 =item Perl Modules
3561
3562 =item Making your module threadsafe
3563
3564 =back
3565
3566 =item SEE ALSO
3567
3568 =back
3569
3570 =head2 perlmodlib - constructing new Perl modules and finding existing ones
3571
3572 =over 4
3573
3574 =item THE PERL MODULE LIBRARY
3575
3576 =over 4
3577
3578 =item Pragmatic Modules
3579
3580 assertions, assertions::activate, attributes, attrs, autouse, base, bigint,
3581 bignum, bigrat, blib, bytes, charnames, constant, diagnostics, encoding,
3582 fields, filetest, if, integer, less, lib, locale, open, ops, overload, re,
3583 sigtrap, sort, strict, subs, threads, threads::shared, utf8, vars, version,
3584 vmsish, warnings, warnings::register
3585
3586 =item Standard Modules
3587
3588 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
3589 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
3590 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
3591 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
3592 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
3593 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
3594 Class::Struct, Config, Cwd, DB, DB_File, Data::Dumper, Devel::DProf,
3595 Devel::PPPort, Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5,
3596 DirHandle, Dumpvalue, DynaLoader, Encode, Encode::Alias, Encode::Byte,
3597 Encode::CJKConstants, Encode::CN, Encode::CN::HZ, Encode::Config,
3598 Encode::EBCDIC, Encode::Encoder, Encode::Encoding, Encode::Guess,
3599 Encode::JP, Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR,
3600 Encode::KR::2022_KR, Encode::MIME::Header, Encode::PerlIO,
3601 Encode::Supported, Encode::Symbol, Encode::TW, Encode::Unicode,
3602 Encode::Unicode::UTF7, English, Env, Errno, Exporter, Exporter::Heavy,
3603 ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant,
3604 ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
3605 ExtUtils::MM, ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin,
3606 ExtUtils::MM_DOS, ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2,
3607 ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
3608 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker,
3609 ExtUtils::MakeMaker::FAQ, ExtUtils::MakeMaker::Tutorial,
3610 ExtUtils::MakeMaker::bytes, ExtUtils::MakeMaker::vmsish,
3611 ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists,
3612 ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename,
3613 File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find,
3614 File::Glob, File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc,
3615 File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix,
3616 File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache,
3617 FileHandle, Filter::Simple, Filter::Util::Call, FindBin, GDBM_File,
3618 Getopt::Long, Getopt::Std, Hash::Util, I18N::Collate, I18N::LangTags,
3619 I18N::LangTags::List, I18N::Langinfo, IO, IO::Dir, IO::File, IO::Handle,
3620 IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET,
3621 IO::Socket::UNIX, IPC::Open2, IPC::Open3, IPC::SysV, IPC::SysV::Msg,
3622 IPC::SysV::Semaphore, List::Util, Locale::Constants, Locale::Country,
3623 Locale::Currency, Locale::Language, Locale::Maketext,
3624 Locale::Maketext::TPJ13, Locale::Script, MIME::Base64,
3625 MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt,
3626 Math::BigInt::Calc, Math::BigInt::Scalar, Math::BigRat, Math::Complex,
3627 Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire,
3628 Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File,
3629 Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT, Net::Cmd,
3630 Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3,
3631 Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent,
3632 Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO,
3633 PerlIO::encoding, PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint,
3634 Pod::Checker, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects,
3635 Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser,
3636 Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff,
3637 Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText,
3638 Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer,
3639 Pod::Select, Pod::Text, Pod::Text::Color, Pod::Text::Overstrike,
3640 Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Scalar::Util,
3641 Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch,
3642 Symbol, Sys::Hostname, Sys::Syslog, Term::ANSIColor, Term::Cap,
3643 Term::Complete, Term::ReadLine, Test, Test::Builder, Test::Harness,
3644 Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Straps,
3645 Test::More, Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced,
3646 Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Thread,
3647 Thread::Queue, Thread::Semaphore, Thread::Signal, Thread::Specific,
3648 Tie::Array, Tie::File, Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash,
3649 Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::gmtime,
3650 Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate, Unicode::Normalize,
3651 Unicode::UCD, User::grent, User::pwent, Win32, XS::APItest, XS::Typemap,
3652 XSLoader
3653
3654 =item Extension Modules
3655
3656 =back
3657
3658 =item CPAN
3659
3660 =over 4
3661
3662 =item Africa
3663
3664 South Africa
3665
3666 =item Asia
3667
3668 China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi
3669 Arabia, Singapore, South Korea, Taiwan, Thailand
3670
3671 =item Central America
3672
3673 Costa Rica
3674
3675 =item Europe
3676
3677 Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Czech
3678 Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary,
3679 Iceland, Ireland, Italy, Latvia, Lithuania, Netherlands, Norway, Poland,
3680 Portugal, Romania, Russia, Slovakia, Slovenia, Spain, Sweden, Switzerland,
3681 Turkey, Ukraine, United Kingdom
3682
3683 =item North America
3684
3685 Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States,
3686 Alabama, California, Colorado, Delaware, District of Columbia, Florida,
3687 Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey, New York,
3688 North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, Utah,
3689 Virginia, Washington, Wisconsin
3690
3691 =item Oceania
3692
3693 Australia, New Zealand, United States
3694
3695 =item South America
3696
3697 Argentina, Brazil, Chile
3698
3699 =item RSYNC Mirrors
3700
3701 =back
3702
3703 =item Modules: Creation, Use, and Abuse
3704
3705 =over 4
3706
3707 =item Guidelines for Module Creation
3708
3709 =item Guidelines for Converting Perl 4 Library Scripts into Modules
3710
3711 =item Guidelines for Reusing Application Code
3712
3713 =back
3714
3715 =item NOTE
3716
3717 =back
3718
3719 =head2 perlmodstyle - Perl module style guide
3720
3721 =over 4
3722
3723 =item INTRODUCTION
3724
3725 =item QUICK CHECKLIST
3726
3727 =over 4
3728
3729 =item Before you start
3730
3731 =item The API
3732
3733 =item Stability
3734
3735 =item Documentation
3736
3737 =item Release considerations
3738
3739 =back
3740
3741 =item BEFORE YOU START WRITING A MODULE
3742
3743 =over 4
3744
3745 =item Has it been done before?
3746
3747 =item Do one thing and do it well
3748
3749 =item What's in a name?
3750
3751 =back
3752
3753 =item DESIGNING AND WRITING YOUR MODULE
3754
3755 =over 4
3756
3757 =item To OO or not to OO?
3758
3759 =item Designing your API
3760
3761 Write simple routines to do simple things, Separate functionality from
3762 output, Provide sensible shortcuts and defaults, Naming conventions,
3763 Parameter passing
3764
3765 =item Strictness and warnings
3766
3767 =item Backwards compatibility
3768
3769 =item Error handling and messages
3770
3771 =back
3772
3773 =item DOCUMENTING YOUR MODULE
3774
3775 =over 4
3776
3777 =item POD
3778
3779 =item README, INSTALL, release notes, changelogs
3780
3781 perl Makefile.PL, make, make test, make install, perl Build.PL, perl Build,
3782 perl Build test, perl Build install
3783
3784 =back
3785
3786 =item RELEASE CONSIDERATIONS
3787
3788 =over 4
3789
3790 =item Version numbering
3791
3792 =item Pre-requisites
3793
3794 =item Testing
3795
3796 =item Packaging
3797
3798 =item Licensing
3799
3800 =back
3801
3802 =item COMMON PITFALLS
3803
3804 =over 4
3805
3806 =item Reinventing the wheel
3807
3808 =item Trying to do too much
3809
3810 =item Inappropriate documentation
3811
3812 =back
3813
3814 =item SEE ALSO
3815
3816 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Packaging Tools,
3817 Testing tools, http://pause.perl.org/, Any good book on software
3818 engineering
3819
3820 =item AUTHOR
3821
3822 =back
3823
3824 =head2 perlmodinstall - Installing CPAN Modules
3825
3826 =over 4
3827
3828 =item DESCRIPTION
3829
3830 =over 4
3831
3832 =item PREAMBLE
3833
3834 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
3835 module (sometimes unnecessary), B<INSTALL> the module
3836
3837 =back
3838
3839 =item PORTABILITY
3840
3841 =item HEY
3842
3843 =item AUTHOR
3844
3845 =item COPYRIGHT
3846
3847 =back
3848
3849 =head2 perlnewmod - preparing a new module for distribution
3850
3851 =over 4
3852
3853 =item DESCRIPTION
3854
3855 =over 4
3856
3857 =item Warning
3858
3859 =item What should I make into a module?
3860
3861 =item Step-by-step: Preparing the ground
3862
3863 Look around, Check it's new, Discuss the need, Choose a name, Check again
3864
3865 =item Step-by-step: Making the module
3866
3867 Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
3868 L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
3869 documentation|perlpod>, Write tests, Write the README
3870
3871 =item Step-by-step: Distributing your module
3872
3873 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
3874 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
3875
3876 =back
3877
3878 =item AUTHOR
3879
3880 =item SEE ALSO
3881
3882 =back
3883
3884 =head2 perlutil - utilities packaged with the Perl distribution
3885
3886 =over 4
3887
3888 =item DESCRIPTION
3889
3890 =over 4
3891
3892 =item DOCUMENTATION
3893
3894 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
3895 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
3896 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
3897 L<roffitall|roffitall>
3898
3899 =item CONVERTORS
3900
3901 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
3902
3903 =item Administration
3904
3905 L<libnetcfg|libnetcfg>
3906
3907 =item Development
3908
3909 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
3910 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
3911
3912 =item SEE ALSO
3913
3914 =back
3915
3916 =back
3917
3918 =head2 perlcompile - Introduction to the Perl Compiler-Translator 
3919
3920 =over 4
3921
3922 =item DESCRIPTION
3923
3924 =over 4
3925
3926 =item Layout
3927
3928 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3929
3930 =back
3931
3932 =item Using The Back Ends
3933
3934 =over 4
3935
3936 =item The Cross Referencing Back End
3937
3938 i, &, s, r
3939
3940 =item The Decompiling Back End
3941
3942 =item The Lint Back End
3943
3944 =item The Simple C Back End
3945
3946 =item The Bytecode Back End
3947
3948 =item The Optimized C Back End
3949
3950 =back
3951
3952 =item Module List for the Compiler Suite
3953
3954 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3955 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
3956 B::Stackobj, B::Stash, B::Terse, B::Xref
3957
3958 =item KNOWN PROBLEMS
3959
3960 =item AUTHOR
3961
3962 =back
3963
3964 =head2 perlfilter - Source Filters
3965
3966 =over 4
3967
3968 =item DESCRIPTION
3969
3970 =item CONCEPTS
3971
3972 =item USING FILTERS
3973
3974 =item WRITING A SOURCE FILTER
3975
3976 =item WRITING A SOURCE FILTER IN C
3977
3978 B<Decryption Filters>
3979
3980 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
3981
3982 =item WRITING A SOURCE FILTER IN PERL
3983
3984 =item USING CONTEXT: THE DEBUG FILTER
3985
3986 =item CONCLUSION
3987
3988 =item THINGS TO LOOK OUT FOR
3989
3990 Some Filters Clobber the C<DATA> Handle
3991
3992 =item REQUIREMENTS
3993
3994 =item AUTHOR
3995
3996 =item Copyrights
3997
3998 =back
3999
4000 =head2 perlembed - how to embed perl in your C program
4001
4002 =over 4
4003
4004 =item DESCRIPTION
4005
4006 =over 4
4007
4008 =item PREAMBLE
4009
4010 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
4011 Perl?>, B<Use C from C?>, B<Use Perl from C?>
4012
4013 =item ROADMAP
4014
4015 =item Compiling your C program
4016
4017 =item Adding a Perl interpreter to your C program
4018
4019 =item Calling a Perl subroutine from your C program
4020
4021 =item Evaluating a Perl statement from your C program
4022
4023 =item Performing Perl pattern matches and substitutions from your C program
4024
4025 =item Fiddling with the Perl stack from your C program
4026
4027 =item Maintaining a persistent interpreter
4028
4029 =item Execution of END blocks
4030
4031 =item Maintaining multiple interpreter instances
4032
4033 =item Using Perl modules, which themselves use C libraries, from your C
4034 program
4035
4036 =back
4037
4038 =item Embedding Perl under Win32
4039
4040 =item Hiding Perl_
4041
4042 =item MORAL
4043
4044 =item AUTHOR
4045
4046 =item COPYRIGHT
4047
4048 =back
4049
4050 =head2 perldebguts - Guts of Perl debugging 
4051
4052 =over 4
4053
4054 =item DESCRIPTION
4055
4056 =item Debugger Internals
4057
4058 =over 4
4059
4060 =item Writing Your Own Debugger
4061
4062 =back
4063
4064 =item Frame Listing Output Examples
4065
4066 =item Debugging regular expressions
4067
4068 =over 4
4069
4070 =item Compile-time output
4071
4072 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
4073 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
4074 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
4075 C<anchored(TYPE)>
4076
4077 =item Types of nodes
4078
4079 =item Run-time output
4080
4081 =back
4082
4083 =item Debugging Perl memory usage
4084
4085 =over 4
4086
4087 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
4088
4089 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
4090 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
4091 6144>
4092
4093 =item Example of using B<-DL> switch
4094
4095 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
4096
4097 =item B<-DL> details
4098
4099 C<!!!>, C<!!>, C<!>
4100
4101 =item Limitations of B<-DL> statistics
4102
4103 =back
4104
4105 =item SEE ALSO
4106
4107 =back
4108
4109 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
4110
4111 =over 4
4112
4113 =item DESCRIPTION
4114
4115 =item SPECIAL NOTES
4116
4117 =over 4
4118
4119 =item make
4120
4121 =item Version caveat
4122
4123 =item Dynamic Loading versus Static Loading
4124
4125 =back
4126
4127 =item TUTORIAL
4128
4129 =over 4
4130
4131 =item EXAMPLE 1
4132
4133 =item EXAMPLE 2
4134
4135 =item What has gone on?
4136
4137 =item Writing good test scripts
4138
4139 =item EXAMPLE 3
4140
4141 =item What's new here?
4142
4143 =item Input and Output Parameters
4144
4145 =item The XSUBPP Program
4146
4147 =item The TYPEMAP file
4148
4149 =item Warning about Output Arguments
4150
4151 =item EXAMPLE 4
4152
4153 =item What has happened here?
4154
4155 =item Anatomy of .xs file
4156
4157 =item Getting the fat out of XSUBs
4158
4159 =item More about XSUB arguments
4160
4161 =item The Argument Stack
4162
4163 =item Extending your Extension
4164
4165 =item Documenting your Extension
4166
4167 =item Installing your Extension
4168
4169 =item EXAMPLE 5
4170
4171 =item New Things in this Example
4172
4173 =item EXAMPLE 6
4174
4175 =item New Things in this Example
4176
4177 =item EXAMPLE 7 (Coming Soon)
4178
4179 =item EXAMPLE 8 (Coming Soon)
4180
4181 =item EXAMPLE 9 Passing open files to XSes
4182
4183 =item Troubleshooting these Examples
4184
4185 =back
4186
4187 =item See also
4188
4189 =item Author
4190
4191 =over 4
4192
4193 =item Last Changed
4194
4195 =back
4196
4197 =back
4198
4199 =head2 perlxs - XS language reference manual
4200
4201 =over 4
4202
4203 =item DESCRIPTION
4204
4205 =over 4
4206
4207 =item Introduction
4208
4209 =item On The Road
4210
4211 =item The Anatomy of an XSUB
4212
4213 =item The Argument Stack
4214
4215 =item The RETVAL Variable
4216
4217 =item The MODULE Keyword
4218
4219 =item The PACKAGE Keyword
4220
4221 =item The PREFIX Keyword
4222
4223 =item The OUTPUT: Keyword
4224
4225 =item The NO_OUTPUT Keyword
4226
4227 =item The CODE: Keyword
4228
4229 =item The INIT: Keyword
4230
4231 =item The NO_INIT Keyword
4232
4233 =item Initializing Function Parameters
4234
4235 =item Default Parameter Values
4236
4237 =item The PREINIT: Keyword
4238
4239 =item The SCOPE: Keyword
4240
4241 =item The INPUT: Keyword
4242
4243 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
4244
4245 =item The C<length(NAME)> Keyword
4246
4247 =item Variable-length Parameter Lists
4248
4249 =item The C_ARGS: Keyword
4250
4251 =item The PPCODE: Keyword
4252
4253 =item Returning Undef And Empty Lists
4254
4255 =item The REQUIRE: Keyword
4256
4257 =item The CLEANUP: Keyword
4258
4259 =item The POSTCALL: Keyword
4260
4261 =item The BOOT: Keyword
4262
4263 =item The VERSIONCHECK: Keyword
4264
4265 =item The PROTOTYPES: Keyword
4266
4267 =item The PROTOTYPE: Keyword
4268
4269 =item The ALIAS: Keyword
4270
4271 =item The OVERLOAD: Keyword
4272
4273 =item The FALLBACK: Keyword
4274
4275 =item The INTERFACE: Keyword
4276
4277 =item The INTERFACE_MACRO: Keyword
4278
4279 =item The INCLUDE: Keyword
4280
4281 =item The CASE: Keyword
4282
4283 =item The & Unary Operator
4284
4285 =item Inserting POD, Comments and C Preprocessor Directives
4286
4287 =item Using XS With C++
4288
4289 =item Interface Strategy
4290
4291 =item Perl Objects And C Structures
4292
4293 =item The Typemap
4294
4295 =item Safely Storing Static Data in XS
4296
4297 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4298
4299 =back
4300
4301 =item EXAMPLES
4302
4303 =item XS VERSION
4304
4305 =item AUTHOR
4306
4307 =back
4308
4309 =head2 perlclib - Internal replacements for standard C library functions
4310
4311 =over 4
4312
4313 =item DESCRIPTION
4314
4315 =over 4
4316
4317 =item Conventions
4318
4319 C<t>, C<p>, C<n>, C<s>
4320
4321 =item File Operations
4322
4323 =item File Input and Output
4324
4325 =item File Positioning
4326
4327 =item Memory Management and String Handling
4328
4329 =item Character Class Tests
4330
4331 =item F<stdlib.h> functions
4332
4333 =item Miscellaneous functions
4334
4335 =back
4336
4337 =item SEE ALSO
4338
4339 =back
4340
4341 =head2 perlguts - Introduction to the Perl API
4342
4343 =over 4
4344
4345 =item DESCRIPTION
4346
4347 =item Variables
4348
4349 =over 4
4350
4351 =item Datatypes
4352
4353 =item What is an "IV"?
4354
4355 =item Working with SVs
4356
4357 =item Offsets
4358
4359 =item What's Really Stored in an SV?
4360
4361 =item Working with AVs
4362
4363 =item Working with HVs
4364
4365 =item Hash API Extensions
4366
4367 =item AVs, HVs and undefined values
4368
4369 =item References
4370
4371 =item Blessed References and Class Objects
4372
4373 =item Creating New Variables
4374
4375 GV_ADDMULTI, GV_ADDWARN
4376
4377 =item Reference Counts and Mortality
4378
4379 =item Stashes and Globs
4380
4381 =item Double-Typed SVs
4382
4383 =item Magic Variables
4384
4385 =item Assigning Magic
4386
4387 =item Magic Virtual Tables
4388
4389 =item Finding Magic
4390
4391 =item Understanding the Magic of Tied Hashes and Arrays
4392
4393 =item Localizing changes
4394
4395 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
4396 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
4397 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
4398 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
4399 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
4400 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
4401 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
4402 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
4403 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
4404 save_hptr(HV **hptr)>
4405
4406 =back
4407
4408 =item Subroutines
4409
4410 =over 4
4411
4412 =item XSUBs and the Argument Stack
4413
4414 =item Calling Perl Routines from within C Programs
4415
4416 =item Memory Allocation
4417
4418 =item PerlIO
4419
4420 =item Putting a C value on Perl stack
4421
4422 =item Scratchpads
4423
4424 =item Scratchpads and recursion
4425
4426 =back
4427
4428 =item Compiled code
4429
4430 =over 4
4431
4432 =item Code tree
4433
4434 =item Examining the tree
4435
4436 =item Compile pass 1: check routines
4437
4438 =item Compile pass 1a: constant folding
4439
4440 =item Compile pass 2: context propagation
4441
4442 =item Compile pass 3: peephole optimization
4443
4444 =item Pluggable runops
4445
4446 =back
4447
4448 =item Examining internal data structures with the C<dump> functions
4449
4450 =item How multiple interpreters and concurrency are supported
4451
4452 =over 4
4453
4454 =item Background and PERL_IMPLICIT_CONTEXT
4455
4456 =item So what happened to dTHR?
4457
4458 =item How do I use all this in extensions?
4459
4460 =item Should I do anything special if I call perl from multiple threads?
4461
4462 =item Future Plans and PERL_IMPLICIT_SYS
4463
4464 =back
4465
4466 =item Internal Functions
4467
4468 A, p, d, s, n, r, f, M, o, j, x
4469
4470 =over 4
4471
4472 =item Formatted Printing of IVs, UVs, and NVs
4473
4474 =item Pointer-To-Integer and Integer-To-Pointer
4475
4476 =item Source Documentation
4477
4478 =back
4479
4480 =item Unicode Support
4481
4482 =over 4
4483
4484 =item What B<is> Unicode, anyway?
4485
4486 =item How can I recognise a UTF8 string?
4487
4488 =item How does UTF8 represent Unicode characters?
4489
4490 =item How does Perl store UTF8 strings?
4491
4492 =item How do I convert a string to UTF8?
4493
4494 =item Is there anything else I need to know?
4495
4496 =back
4497
4498 =item Custom Operators
4499
4500 =item AUTHORS
4501
4502 =item SEE ALSO
4503
4504 =back
4505
4506 =head2 perlcall - Perl calling conventions from C
4507
4508 =over 4
4509
4510 =item DESCRIPTION
4511
4512 An Error Handler, An Event Driven Program
4513
4514 =item THE CALL_ FUNCTIONS
4515
4516 call_sv, call_pv, call_method, call_argv
4517
4518 =item FLAG VALUES
4519
4520 =over 4
4521
4522 =item  G_VOID
4523
4524 =item  G_SCALAR
4525
4526 =item G_ARRAY
4527
4528 =item G_DISCARD
4529
4530 =item G_NOARGS
4531
4532 =item G_EVAL
4533
4534 =item G_KEEPERR
4535
4536 =item Determining the Context
4537
4538 =back
4539
4540 =item KNOWN PROBLEMS
4541
4542 =item EXAMPLES
4543
4544 =over 4
4545
4546 =item No Parameters, Nothing returned
4547
4548 =item Passing Parameters
4549
4550 =item Returning a Scalar
4551
4552 =item Returning a list of values
4553
4554 =item Returning a list in a scalar context
4555
4556 =item Returning Data from Perl via the parameter list
4557
4558 =item Using G_EVAL
4559
4560 =item Using G_KEEPERR
4561
4562 =item Using call_sv
4563
4564 =item Using call_argv
4565
4566 =item Using call_method
4567
4568 =item Using GIMME_V
4569
4570 =item Using Perl to dispose of temporaries
4571
4572 =item Strategies for storing Callback Context Information
4573
4574 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
4575 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
4576 callback
4577
4578 =item Alternate Stack Manipulation
4579
4580 =item Creating and calling an anonymous subroutine in C
4581
4582 =back
4583
4584 =item SEE ALSO
4585
4586 =item AUTHOR
4587
4588 =item DATE
4589
4590 =back
4591
4592 =head2 perlapi - autogenerated documentation for the perl public API
4593
4594 =over 4
4595
4596 =item DESCRIPTION
4597
4598 =item "Gimme" Values
4599
4600 GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
4601
4602 =item Array Manipulation Functions
4603
4604 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4605 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4606 get_av, newAV, Nullav, sortsv
4607
4608 =item Callback Functions
4609
4610 call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
4611 FREETMPS, LEAVE, SAVETMPS
4612
4613 =item Character classes
4614
4615 isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
4616
4617 =item Cloning an interpreter
4618
4619 perl_clone
4620
4621 =item CV Manipulation Functions
4622
4623 CvSTASH, get_cv, Nullcv
4624
4625 =item Embedding Functions
4626
4627 cv_undef, load_module, nothreadhook, perl_alloc, perl_construct,
4628 perl_destruct, perl_free, perl_parse, perl_run, require_pv
4629
4630 =item Functions in file pp_pack.c
4631
4632 packlist, pack_cat, unpackstring, unpack_str
4633
4634 =item Global Variables
4635
4636 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
4637
4638 =item GV Functions
4639
4640 GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
4641 gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
4642
4643 =item Handy Values
4644
4645 HEf_SVKEY, Nullch, Nullsv
4646
4647 =item Hash Manipulation Functions
4648
4649 get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set,
4650 HeVAL, HvNAME, hv_clear, hv_delete, hv_delete_ent, hv_exists,
4651 hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey,
4652 hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iternext_flags, hv_iterval,
4653 hv_magic, hv_store, hv_store_ent, hv_undef, newHV, Nullhv
4654
4655 =item Magical Functions
4656
4657 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
4658 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
4659 SvSetSV, SvSetSV_nosteal, SvSHARE
4660
4661 =item Memory Management
4662
4663 Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree,
4664 savepv, savepvn, savesharedpv, StructCopy, Zero
4665
4666 =item Miscellaneous Functions
4667
4668 fbm_compile, fbm_instr, form, getcwd_sv, new_version, scan_version, strEQ,
4669 strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_nolocking,
4670 sv_nosharing, sv_nounlocking, upg_version, vcmp, vnumify, vstringify
4671
4672 =item Numeric functions
4673
4674 grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
4675 scan_hex, scan_oct
4676
4677 =item Optree Manipulation Functions
4678
4679 cv_const_sv, newCONSTSUB, newXS
4680
4681 =item Pad Data Structures
4682
4683 pad_sv
4684
4685 =item Stack Manipulation Macros
4686
4687 dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp,
4688 POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
4689 PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN,
4690 XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
4691 XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF, XST_mYES
4692
4693 =item SV Flags
4694
4695 svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
4696
4697 =item SV Manipulation Functions
4698
4699 get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
4700 newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
4701 SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off,
4702 SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIsCOW,
4703 SvIsCOW_shared_hash, SvIV, SvIVx, SvIVX, SvLEN, SvNIOK, SvNIOKp,
4704 SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX,
4705 SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only,
4706 SvPOK_only_UTF8, SvPV, SvPVbyte, SvPVbytex, SvPVbytex_force,
4707 SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, SvPVutf8x, SvPVutf8x_force,
4708 SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX, SvPV_force, SvPV_force_nomg,
4709 SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off,
4710 SvROK_on, SvRV, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on,
4711 SvTRUE, SvTYPE, SvUNLOCK, SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on,
4712 SvUV, SvUVX, SvUVx, SvVOK, sv_2bool, sv_2cv, sv_2io, sv_2iv, sv_2mortal,
4713 sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen, sv_2pvutf8, sv_2pvutf8_nolen,
4714 sv_2pv_flags, sv_2pv_nolen, sv_2uv, sv_backoff, sv_bless, sv_catpv,
4715 sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_flags, sv_catpvn_mg,
4716 sv_catpv_mg, sv_catsv, sv_catsv_flags, sv_catsv_mg, sv_chop, sv_clear,
4717 sv_cmp, sv_cmp_locale, sv_collxfrm, sv_copypv, sv_dec, sv_derived_from,
4718 sv_eq, sv_force_normal, sv_force_normal_flags, sv_free, sv_gets, sv_grow,
4719 sv_inc, sv_insert, sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8,
4720 sv_magic, sv_magicext, sv_mortalcopy, sv_newmortal, sv_newref, sv_nv,
4721 sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force,
4722 sv_pvn, sv_pvn_force, sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n,
4723 sv_pvutf8n_force, sv_reftype, sv_replace, sv_report_used, sv_reset,
4724 sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv,
4725 sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn,
4726 sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv,
4727 sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg,
4728 sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref,
4729 sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg,
4730 sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade,
4731 sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn
4732
4733 =item Unicode Support
4734
4735 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
4736 pv_uni_display, sv_cat_decode, sv_recode_to_utf8, sv_uni_display,
4737 to_utf8_case, to_utf8_fold, to_utf8_lower, to_utf8_title, to_utf8_upper,
4738 utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop, utf8_length,
4739 utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8,
4740 uvuni_to_utf8_flags
4741
4742 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
4743
4744 ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST,
4745 THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK
4746
4747 =item Warning and Dieing
4748
4749 croak, warn
4750
4751 =item AUTHORS
4752
4753 =item SEE ALSO
4754
4755 =back
4756
4757 =head2 perlintern - autogenerated documentation of purely B<internal>
4758                  Perl functions
4759
4760 =over 4
4761
4762 =item DESCRIPTION
4763
4764 =item CV reference counts and CvOUTSIDE
4765
4766 CvWEAKOUTSIDE
4767
4768 =item Functions in file pad.h
4769
4770 CX_CURPAD_SAVE, CX_CURPAD_SV, PAD_BASE_SV, PAD_CLONE_VARS,
4771 PAD_COMPNAME_FLAGS, PAD_COMPNAME_GEN, PAD_COMPNAME_OURSTASH,
4772 PAD_COMPNAME_PV, PAD_COMPNAME_TYPE, PAD_DUP, PAD_RESTORE_LOCAL,
4773 PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV, PAD_SET_CUR, PAD_SV,
4774 PAD_SVl, SAVECLEARSV, SAVECOMPPAD, SAVEPADSV
4775
4776 =item Functions in file pp_ctl.c
4777
4778 find_runcv
4779
4780 =item Global Variables
4781
4782 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
4783 PL_rs
4784
4785 =item GV Functions
4786
4787 is_gv_magical
4788
4789 =item IO Functions
4790
4791 start_glob
4792
4793 =item Pad Data Structures
4794
4795 CvPADLIST, cv_clone, cv_dump, do_dump_pad, intro_my, pad_add_anon,
4796 pad_add_name, pad_alloc, pad_block_start, pad_check_dup, pad_findlex,
4797 pad_findmy, pad_fixup_inner_anons, pad_free, pad_leavemy, pad_new,
4798 pad_push, pad_reset, pad_setsv, pad_swipe, pad_tidy, pad_undef
4799
4800 =item Stack Manipulation Macros
4801
4802 djSP, LVRET
4803
4804 =item SV Manipulation Functions
4805
4806 report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
4807
4808 =item AUTHORS
4809
4810 =item SEE ALSO
4811
4812 =back
4813
4814 =head2 perliol - C API for Perl's implementation of IO in Layers.
4815
4816 =over 4
4817
4818 =item SYNOPSIS
4819
4820 =item DESCRIPTION
4821
4822 =over 4
4823
4824 =item History and Background
4825
4826 =item Layers vs Disciplines
4827
4828 =item Data Structures
4829
4830 =item Functions and Attributes
4831
4832 =item Per-instance Data
4833
4834 =item Layers in action.
4835
4836 =item Per-instance flag bits
4837
4838 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4839 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4840 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4841 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4842
4843 =item Methods in Detail
4844
4845 fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF,
4846 PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode,
4847 Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof,
4848 Error,  Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
4849 Set_ptrcnt
4850
4851 =item Implementing PerlIO Layers
4852
4853 C implementations, Perl implementations
4854
4855 =item Core Layers
4856
4857 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4858
4859 =item Extension Layers
4860
4861 ":encoding", ":scalar", ":via"
4862
4863 =back
4864
4865 =item TODO
4866
4867 =back
4868
4869 =head2 perlapio - perl's IO abstraction interface.
4870
4871 =over 4
4872
4873 =item SYNOPSIS
4874
4875 =item DESCRIPTION
4876
4877 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4878 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4879 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4880 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4881 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4882 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4883 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4884 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4885 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4886 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4887 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4888
4889 =over 4
4890
4891 =item Co-existence with stdio
4892
4893 B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
4894 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
4895
4896 =item "Fast gets" Functions
4897
4898 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4899 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4900 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4901 B<PerlIO_get_bufsiz(f)>
4902
4903 =item Other Functions
4904
4905 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4906 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4907
4908 =back
4909
4910 =back
4911
4912 =head2 perlhack - How to hack at the Perl internals
4913
4914 =over 4
4915
4916 =item DESCRIPTION
4917
4918 Does concept match the general goals of Perl?, Where is the
4919 implementation?, Backwards compatibility, Could it be a module instead?, Is
4920 the feature generic enough?, Does it potentially introduce new bugs?, Does
4921 it preclude other desirable features?, Is the implementation robust?, Is
4922 the implementation generic enough to be portable?, Is the implementation
4923 tested?, Is there enough documentation?, Is there another way to do it?,
4924 Does it create too much work?, Patches speak louder than words
4925
4926 =over 4
4927
4928 =item Keeping in sync
4929
4930 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
4931 NFS, rsync'ing the patches
4932
4933 =item Why rsync the source tree
4934
4935 It's easier to rsync the source tree, It's more reliable
4936
4937 =item Why rsync the patches
4938
4939 It's easier to rsync the patches, It's a good reference, Finding a start
4940 point, Finding how to fix a bug, Finding the source of misbehaviour
4941
4942 =item Perlbug administration
4943
4944 =item Submitting patches
4945
4946 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
4947 F<Porting/pumpkin.pod>, The perl5-porters FAQ
4948
4949 =item Finding Your Way Around
4950
4951 Core modules, Tests, Documentation, Configure, Interpreter
4952
4953 =item Elements of the interpreter
4954
4955 Startup, Parsing, Optimization, Running
4956
4957 =item Internal Variable Types
4958
4959 =item Op Trees
4960
4961 =item Stacks
4962
4963 Argument stack, Mark stack, Save stack
4964
4965 =item Millions of Macros
4966
4967 =item The .i Targets
4968
4969 =item Poking at Perl
4970
4971 =item Using a source-level debugger
4972
4973 run [args], break function_name, break source.c:xxx, step, next, continue,
4974 finish, 'enter', print
4975
4976 =item gdb macro support
4977
4978 =item Dumping Perl Data Structures
4979
4980 =item Patching
4981
4982 =item Patching a core module
4983
4984 =item Adding a new function to the core
4985
4986 =item Writing a test
4987
4988 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
4989 F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base t/comp,
4990 t/cmd t/run t/io t/op, t/lib ext lib
4991
4992 =item Special Make Test Targets
4993
4994 coretest, test.deparse, minitest, test.valgrind check.valgrind
4995 utest.valgrind ucheck.valgrind, test.third check.third utest.third
4996 ucheck.third, test.torture torturetest, utest ucheck test.utf8 check.utf8,
4997 test_harness
4998
4999 =item Running tests by hand
5000
5001 PERL_CORE=1, PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST
5002
5003 =back
5004
5005 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5006
5007 =over 4
5008
5009 =item Rational Software's Purify
5010
5011 =item Purify on Unix
5012
5013 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5014
5015 =item Purify on NT
5016
5017 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5018
5019 =item valgrind
5020
5021 =item Compaq's/Digital's/HP's Third Degree
5022
5023 =item PERL_DESTRUCT_LEVEL
5024
5025 =item Profiling
5026
5027 =item Gprof Profiling
5028
5029 -a, -b, -e routine, -f routine, -s, -z
5030
5031 =item GCC gcov Profiling
5032
5033 =item Pixie Profiling
5034
5035 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5036 -z[ero]
5037
5038 =item Miscellaneous tricks
5039
5040 =item CONCLUSION
5041
5042 I<The Road goes ever on and on, down from the door where it began.>
5043
5044 =back
5045
5046 =item AUTHOR
5047
5048 =back
5049
5050 =head2 perlbook - Perl book information
5051
5052 =over 4
5053
5054 =item DESCRIPTION
5055
5056 =back
5057
5058 =head2 perltodo - Perl TO-DO List
5059
5060 =over 4
5061
5062 =item DESCRIPTION
5063
5064 =item To do during 5.6.x
5065
5066 =over 4
5067
5068 =item Support for I/O disciplines
5069
5070 =item Autoload bytes.pm
5071
5072 =item Make "\u{XXXX}" et al work
5073
5074 =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
5075
5076 =item Overloadable regex assertions
5077
5078 =item Unicode
5079
5080 =item Work out exit/die semantics for threads
5081
5082 =item Better support for nonpreemptive threading systems like GNU pth
5083
5084 =item Typed lexicals for compiler
5085
5086 =item Compiler workarounds for Win32
5087
5088 =item AUTOLOADing in the compiler
5089
5090 =item Fixing comppadlist when compiling
5091
5092 =item Cleaning up exported namespace
5093
5094 =item Complete signal handling
5095
5096 =item Out-of-source builds
5097
5098 =item POSIX realtime support
5099
5100 =item UNIX98 support
5101
5102 =item IPv6 Support
5103
5104 =item Long double conversion
5105
5106 =item Locales
5107
5108 =item Arithmetic on non-Arabic numerals
5109
5110 =item POSIX Unicode character classes
5111
5112 =item Factoring out common suffices/prefices in regexps (trie optimization)
5113
5114 =item Security audit shipped utilities
5115
5116 =item Sort out the uid-setting mess
5117
5118 =item Custom opcodes
5119
5120 =item DLL Versioning
5121
5122 =item Introduce @( and @)
5123
5124 =item Floating point handling
5125
5126 =item IV/UV preservation
5127
5128 =item Replace pod2html with something using Pod::Parser
5129
5130 =item Automate module testing on CPAN
5131
5132 =item sendmsg and recvmsg
5133
5134 =item Rewrite perlre documentation
5135
5136 =item Convert example code to IO::Handle filehandles
5137
5138 =item Document Win32 choices
5139
5140 =item Check new modules
5141
5142 =item Make roffitall find pods and libs itself
5143
5144 =back
5145
5146 =item To do at some point
5147
5148 =over 4
5149
5150 =item Remove regular expression recursion
5151
5152 =item Memory leaks after failed eval
5153
5154 =item bitfields in pack
5155
5156 =item Cross compilation
5157
5158 =item Perl preprocessor / macros
5159
5160 =item Perl lexer in Perl
5161
5162 =item Using POSIX calls internally
5163
5164 =item -i rename file when changed
5165
5166 =item All ARGV input should act like E<lt>E<gt>
5167
5168 =item Support for rerunning debugger
5169
5170 =item Test Suite for the Debugger
5171
5172 =item my sub foo { }
5173
5174 =item One-pass global destruction
5175
5176 =item Rewrite regexp parser
5177
5178 =item Cache recently used regexps
5179
5180 =item Cross-compilation support
5181
5182 =item Bit-shifting bitvectors
5183
5184 =item debugger pragma
5185
5186 =item use less pragma
5187
5188 =item switch structures
5189
5190 =item Cache eval tree
5191
5192 =item rcatmaybe
5193
5194 =item Shrink opcode tables
5195
5196 =item Optimize away @_
5197
5198 =item Prototypes versus indirect objects
5199
5200 =item Install HTML
5201
5202 =item Prototype method calls
5203
5204 =item Return context prototype declarations
5205
5206 =item magic_setisa
5207
5208 =item Garbage collection
5209
5210 =item IO tutorial
5211
5212 =item Rewrite perldoc
5213
5214 =item Install .3p manpages
5215
5216 =item Unicode tutorial
5217
5218 =item Update POSIX.pm for 1003.1-2
5219
5220 =item Retargetable installation
5221
5222 =item POSIX emulation on non-POSIX systems
5223
5224 =item Rename Win32 headers
5225
5226 =item Finish off lvalue functions
5227
5228 =item Update sprintf documentation
5229
5230 =item Use fchown/fchmod internally
5231
5232 =item Make v-strings overloaded objects
5233
5234 =item Allow restricted hash assignment
5235
5236 =item Should overload be inheritable?
5237
5238 =item Taint rethink
5239
5240 =item Perform correctly when XSUBs call subroutines that exit via
5241 goto(LABEL) and friends
5242
5243 =back
5244
5245 =item Vague ideas
5246
5247 =over 4
5248
5249 =item ref() in list context
5250
5251 =item Make tr/// return histogram of characters in list context
5252
5253 =item Compile to real threaded code
5254
5255 =item Structured types
5256
5257 =item Modifiable $1 et al.
5258
5259 =item Procedural interfaces for IO::*, etc.
5260
5261 =item RPC modules
5262
5263 =item Attach/detach debugger from running program
5264
5265 =item GUI::Native
5266
5267 =item foreach(reverse ...)
5268
5269 =item Constant function cache
5270
5271 =item Approximate regular expression matching
5272
5273 =back
5274
5275 =item Ongoing
5276
5277 =over 4
5278
5279 =item Update guts documentation
5280
5281 =item Add more tests
5282
5283 =item Update auxiliary tools
5284
5285 =item Create debugging macros
5286
5287 =item truncate to the people
5288
5289 =item Unicode in Filenames
5290
5291 =back
5292
5293 =item Unicode in %ENV
5294
5295 =item Recently done things
5296
5297 =over 4
5298
5299 =item Alternative RE syntax module
5300
5301 =item Safe signal handling
5302
5303 =item Tie Modules
5304
5305 =item gettimeofday
5306
5307 =item setitimer and getimiter
5308
5309 =item Testing __DIE__ hook
5310
5311 =item CPP equivalent in Perl
5312
5313 =item Explicit switch statements
5314
5315 =item autocroak
5316
5317 =item UTF/EBCDIC
5318
5319 =item UTF Regexes
5320
5321 =item perlcc to produce executable
5322
5323 =item END blocks saved in compiled output
5324
5325 =item Secure temporary file module
5326
5327 =item Integrate Time::HiRes
5328
5329 =item Turn Cwd into XS
5330
5331 =item Mmap for input
5332
5333 =item Byte to/from UTF8 and UTF8 to/from local conversion
5334
5335 =item Add sockatmark support
5336
5337 =item Mailing list archives
5338
5339 =item Bug tracking
5340
5341 =item Integrate MacPerl
5342
5343 =item Web "nerve center" for Perl
5344
5345 =item Regular expression tutorial
5346
5347 =item Debugging Tutorial
5348
5349 =item Integrate new modules
5350
5351 =item Integrate profiler
5352
5353 =item Y2K error detection
5354
5355 =item Regular expression debugger
5356
5357 =item POD checker
5358
5359 =item "Dynamic" lexicals
5360
5361 =item Cache precompiled modules
5362
5363 =back
5364
5365 =item Deprecated Wishes
5366
5367 =over 4
5368
5369 =item Loop control on do{}
5370
5371 =item Lexically scoped typeglobs
5372
5373 =item format BOTTOM
5374
5375 =item report HANDLE
5376
5377 =item Generalised want()/caller())
5378
5379 =item Named prototypes
5380
5381 =item Built-in globbing
5382
5383 =item Regression tests for suidperl
5384
5385 =item Cached hash values
5386
5387 =item Add compression modules
5388
5389 =item Reorganise documentation into tutorials/references
5390
5391 =item Remove distinction between functions and operators
5392
5393 =item Make XS easier to use
5394
5395 =item Make embedding easier to use
5396
5397 =item man for perl
5398
5399 =item my $Package::variable
5400
5401 =item "or" tests defined, not truth
5402
5403 =item "class"-based lexicals
5404
5405 =item byteperl
5406
5407 =item Lazy evaluation / tail recursion removal
5408
5409 =item Make "use utf8" the default
5410
5411 =item Unicode collation and normalization
5412
5413 =item pack/unpack tutorial
5414
5415 =back
5416
5417 =back
5418
5419 =head2 perldoc - Look up Perl documentation in Pod format.
5420
5421 =over 4
5422
5423 =item SYNOPSIS
5424
5425 =item DESCRIPTION
5426
5427 =item OPTIONS
5428
5429 B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
5430 I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
5431 I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
5432 B<-w> I<option:value> or B<-w> I<option>, B<-X>,
5433 B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
5434 B<-V>
5435
5436 =item SECURITY
5437
5438 =item ENVIRONMENT
5439
5440 =item AUTHOR
5441
5442 =back
5443
5444 =head2 perlhist - the Perl history records
5445
5446 =over 4
5447
5448 =item DESCRIPTION
5449
5450 =item INTRODUCTION
5451
5452 =item THE KEEPERS OF THE PUMPKIN
5453
5454 =over 4
5455
5456 =item PUMPKIN?
5457
5458 =back
5459
5460 =item THE RECORDS
5461
5462 =over 4
5463
5464 =item SELECTED RELEASE SIZES
5465
5466 =item SELECTED PATCH SIZES
5467
5468 =back
5469
5470 =item THE KEEPERS OF THE RECORDS
5471
5472 =back
5473
5474 =head2 perldelta - what is new for perl v5.9.0
5475
5476 =over 4
5477
5478 =item DESCRIPTION
5479
5480 =item Incompatible Changes
5481
5482 =over 4
5483
5484 =item The C<$*> variable has been removed
5485
5486 =back
5487
5488 =item Core Enhancements
5489
5490 =over 4
5491
5492 =item Tied Arrays with Negative Array Indices
5493
5494 =back
5495
5496 =item Modules and Pragmata
5497
5498 =item Utility Changes
5499
5500 =item New Documentation
5501
5502 =item Performance Enhancements
5503
5504 =item Installation and Configuration Improvements
5505
5506 =item Selected Bug Fixes
5507
5508 =item New or Changed Diagnostics
5509
5510 =item Changed Internals
5511
5512 =item New Tests
5513
5514 =item Known Problems
5515
5516 =item Platform Specific Problems
5517
5518 =item Reporting Bugs
5519
5520 =item SEE ALSO
5521
5522 =back
5523
5524 =head2 perl58delta, perldelta - what is new for perl v5.8.0
5525
5526 =over 4
5527
5528 =item DESCRIPTION
5529
5530 =item Highlights In 5.8.0
5531
5532 =item Incompatible Changes
5533
5534 =over 4
5535
5536 =item Binary Incompatibility
5537
5538 =item 64-bit platforms and malloc
5539
5540 =item AIX Dynaloading
5541
5542 =item Attributes for C<my> variables now handled at run-time
5543
5544 =item Socket Extension Dynamic in VMS
5545
5546 =item IEEE-format Floating Point Default on OpenVMS Alpha
5547
5548 =item New Unicode Semantics (no more C<use utf8>, almost)
5549
5550 =item New Unicode Properties
5551
5552 =item REF(...) Instead Of SCALAR(...)
5553
5554 =item pack/unpack D/F recycled
5555
5556 =item glob() now returns filenames in alphabetical order
5557
5558 =item Deprecations
5559
5560 =back
5561
5562 =item Core Enhancements
5563
5564 =over 4
5565
5566 =item Unicode Overhaul
5567
5568 =item PerlIO is Now The Default
5569
5570 =item ithreads
5571
5572 =item Restricted Hashes
5573
5574 =item Safe Signals
5575
5576 =item Understanding of Numbers
5577
5578 =item Arrays now always interpolate into double-quoted strings [561]
5579
5580 =item Miscellaneous Changes
5581
5582 =back
5583
5584 =item Modules and Pragmata
5585
5586 =over 4
5587
5588 =item New Modules and Pragmata
5589
5590 =item Updated And Improved Modules and Pragmata
5591
5592 =back
5593
5594 =item Utility Changes
5595
5596 =item New Documentation
5597
5598 =item Performance Enhancements
5599
5600 =item Installation and Configuration Improvements
5601
5602 =over 4
5603
5604 =item Generic Improvements
5605
5606 =item New Or Improved Platforms
5607
5608 =back
5609
5610 =item Selected Bug Fixes
5611
5612 =over 4
5613
5614 =item Platform Specific Changes and Fixes
5615
5616 =back
5617
5618 =item New or Changed Diagnostics
5619
5620 =item Changed Internals
5621
5622 =item Security Vulnerability Closed [561]
5623
5624 =item New Tests
5625
5626 =item Known Problems
5627
5628 =over 4
5629
5630 =item The Compiler Suite Is Still Very Experimental
5631
5632 =item Localising Tied Arrays and Hashes Is Broken
5633
5634 =item Building Extensions Can Fail Because Of Largefiles
5635
5636 =item Modifying $_ Inside for(..)
5637
5638 =item mod_perl 1.26 Doesn't Build With Threaded Perl
5639
5640 =item lib/ftmp-security tests warn 'system possibly insecure'
5641
5642 =item libwww-perl (LWP) fails base/date #51
5643
5644 =item PDL failing some tests
5645
5646 =item Perl_get_sv
5647
5648 =item Self-tying Problems
5649
5650 =item ext/threads/t/libc
5651
5652 =item Failure of Thread (5.005-style) tests
5653
5654 =item Timing problems
5655
5656 =item Tied/Magical Array/Hash Elements Do Not Autovivify
5657
5658 =item Unicode in package/class and subroutine names does not work
5659
5660 =back
5661
5662 =item Platform Specific Problems
5663
5664 =over 4
5665
5666 =item AIX
5667
5668 =item Alpha systems with old gccs fail several tests
5669
5670 =item AmigaOS
5671
5672 =item BeOS
5673
5674 =item Cygwin "unable to remap"
5675
5676 =item Cygwin ndbm tests fail on FAT
5677
5678 =item DJGPP Failures
5679
5680 =item FreeBSD built with ithreads coredumps reading large directories
5681
5682 =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
5683
5684 =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
5685
5686 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5687
5688 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
5689
5690 =item Linux With Sfio Fails op/misc Test 48
5691
5692 =item Mac OS X
5693
5694 =item Mac OS X dyld undefined symbols
5695
5696 =item OS/2 Test Failures
5697
5698 =item op/sprintf tests 91, 129, and 130
5699
5700 =item SCO
5701
5702 =item Solaris 2.5
5703
5704 =item Solaris x86 Fails Tests With -Duse64bitint
5705
5706 =item SUPER-UX (NEC SX)
5707
5708 =item Term::ReadKey not working on Win32
5709
5710 =item UNICOS/mk
5711
5712 =item UTS
5713
5714 =item VOS (Stratus)
5715
5716 =item VMS
5717
5718 =item Win32
5719
5720 =item XML::Parser not working
5721
5722 =item z/OS (OS/390)
5723
5724 =item Unicode Support on EBCDIC Still Spotty
5725
5726 =item Seen In Perl 5.7 But Gone Now
5727
5728 =back
5729
5730 =item Reporting Bugs
5731
5732 =item SEE ALSO
5733
5734 =item HISTORY
5735
5736 =back
5737
5738 =head2 perl573delta - what's new for perl v5.7.3
5739
5740 =over 4
5741
5742 =item DESCRIPTION
5743
5744 =item Changes
5745
5746 =item Reporting Bugs
5747
5748 =item SEE ALSO
5749
5750 =item HISTORY
5751
5752 =back
5753
5754 =head2 perl572delta - what's new for perl v5.7.2
5755
5756 =over 4
5757
5758 =item DESCRIPTION
5759
5760 =item Security Vulnerability Closed
5761
5762 =item Incompatible Changes
5763
5764 =over 4
5765
5766 =item 64-bit platforms and malloc
5767
5768 =item AIX Dynaloading
5769
5770 =item Socket Extension Dynamic in VMS
5771
5772 =item Different Definition of the Unicode Character Classes \p{In...}
5773
5774 =item Deprecations
5775
5776 =back
5777
5778 =item Core Enhancements
5779
5780 =item Modules and Pragmata
5781
5782 =over 4
5783
5784 =item New Modules and Distributions
5785
5786 =item Updated And Improved Modules and Pragmata
5787
5788 =back
5789
5790 =item Utility Changes
5791
5792 =item New Documentation
5793
5794 =item Installation and Configuration Improvements
5795
5796 =over 4
5797
5798 =item New Or Improved Platforms
5799
5800 =item Generic Improvements
5801
5802 =back
5803
5804 =item Selected Bug Fixes
5805
5806 =over 4
5807
5808 =item Platform Specific Changes and Fixes
5809
5810 =back
5811
5812 =item New or Changed Diagnostics
5813
5814 =item Source Code Enhancements
5815
5816 =over 4
5817
5818 =item MAGIC constants
5819
5820 =item Better commented code
5821
5822 =item Regex pre-/post-compilation items matched up
5823
5824 =item gcc -Wall
5825
5826 =back
5827
5828 =item New Tests
5829
5830 =item Known Problems
5831
5832 =over 4
5833
5834 =item AIX
5835
5836 =item Amiga Perl Invoking Mystery
5837
5838 =item lib/ftmp-security tests warn 'system possibly insecure'
5839
5840 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
5841
5842 =item HP-UX lib/io_multihomed Fails When LP64-Configured
5843
5844 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5845
5846 =item Linux With Sfio Fails op/misc Test 48
5847
5848 =item OS/390
5849
5850 =item op/sprintf tests 129 and 130
5851
5852 =item  Failure of Thread tests
5853
5854 =item UNICOS
5855
5856 =item UTS
5857
5858 =item VMS
5859
5860 =item Win32
5861
5862 =item Localising a Tied Variable Leaks Memory
5863
5864 =item Self-tying of Arrays and Hashes Is Forbidden
5865
5866 =item Variable Attributes are not Currently Usable for Tieing
5867
5868 =item Building Extensions Can Fail Because Of Largefiles
5869
5870 =item The Compiler Suite Is Still Experimental
5871
5872 =item The Long Double Support is Still Experimental
5873
5874 =back
5875
5876 =item Reporting Bugs
5877
5878 =item SEE ALSO
5879
5880 =item HISTORY
5881
5882 =back
5883
5884 =head2 perl571delta - what's new for perl v5.7.1
5885
5886 =over 4
5887
5888 =item DESCRIPTION
5889
5890 =item Security Vulnerability Closed
5891
5892 =item Incompatible Changes
5893
5894 =item Core Enhancements
5895
5896 =over 4
5897
5898 =item AUTOLOAD Is Now Lvaluable
5899
5900 =item PerlIO is Now The Default
5901
5902 =item Signals Are Now Safe
5903
5904 =back
5905
5906 =item Modules and Pragmata
5907
5908 =over 4
5909
5910 =item New Modules
5911
5912 =item Updated And Improved Modules and Pragmata
5913
5914 =back
5915
5916 =item Performance Enhancements
5917
5918 =item Utility Changes
5919
5920 =item New Documentation
5921
5922 =over 4
5923
5924 =item perlclib
5925
5926 =item perliol
5927
5928 =item README.aix
5929
5930 =item README.bs2000
5931
5932 =item README.macos
5933
5934 =item README.mpeix
5935
5936 =item README.solaris
5937
5938 =item README.vos
5939
5940 =item Porting/repository.pod
5941
5942 =back
5943
5944 =item Installation and Configuration Improvements
5945
5946 =over 4
5947
5948 =item New Or Improved Platforms
5949
5950 =item Generic Improvements
5951
5952 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
5953 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
5954 d_strtoq, d_u32align, d_ualarm, d_usleep
5955
5956 =back
5957
5958 =item Selected Bug Fixes
5959
5960 =over 4
5961
5962 =item Platform Specific Changes and Fixes
5963
5964 =back
5965
5966 =item New or Changed Diagnostics
5967
5968 =item Changed Internals
5969
5970 =item New Tests
5971
5972 =item Known Problems
5973
5974 =over 4
5975
5976 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
5977
5978 =item lib/ftmp-security tests warn 'system possibly insecure'
5979
5980 =item lib/io_multihomed Fails In LP64-Configured HP-UX
5981
5982 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
5983
5984 =item lib/b test 19
5985
5986 =item Linux With Sfio Fails op/misc Test 48
5987
5988 =item sigaction test 13 in VMS
5989
5990 =item sprintf tests 129 and 130
5991
5992 =item  Failure of Thread tests
5993
5994 =item Localising a Tied Variable Leaks Memory
5995
5996 =item Self-tying of Arrays and Hashes Is Forbidden
5997
5998 =item Building Extensions Can Fail Because Of Largefiles
5999
6000 =item The Compiler Suite Is Still Experimental
6001
6002 =back
6003
6004 =item Reporting Bugs
6005
6006 =item SEE ALSO
6007
6008 =item HISTORY
6009
6010 =back
6011
6012 =head2 perl570delta - what's new for perl v5.7.0
6013
6014 =over 4
6015
6016 =item DESCRIPTION
6017
6018 =item Security Vulnerability Closed
6019
6020 =item Incompatible Changes
6021
6022 =item Core Enhancements
6023
6024 =item Modules and Pragmata
6025
6026 =over 4
6027
6028 =item New Modules
6029
6030 =item Updated And Improved Modules and Pragmata
6031
6032 =back
6033
6034 =item Utility Changes
6035
6036 =item New Documentation
6037
6038 =item Performance Enhancements
6039
6040 =item Installation and Configuration Improvements
6041
6042 =over 4
6043
6044 =item Generic Improvements
6045
6046 =back
6047
6048 =item Selected Bug Fixes
6049
6050 =over 4
6051
6052 =item Platform Specific Changes and Fixes
6053
6054 =back
6055
6056 =item New or Changed Diagnostics
6057
6058 =item Changed Internals
6059
6060 =item Known Problems
6061
6062 =over 4
6063
6064 =item Unicode Support Still Far From Perfect
6065
6066 =item EBCDIC Still A Lost Platform
6067
6068 =item Building Extensions Can Fail Because Of Largefiles
6069
6070 =item ftmp-security tests warn 'system possibly insecure'
6071
6072 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
6073
6074 =item Long Doubles Still Don't Work In Solaris
6075
6076 =item Linux With Sfio Fails op/misc Test 48
6077
6078 =item Storable tests fail in some platforms
6079
6080 =item Threads Are Still Experimental
6081
6082 =item The Compiler Suite Is Still Experimental
6083
6084 =back
6085
6086 =item Reporting Bugs
6087
6088 =item SEE ALSO
6089
6090 =item HISTORY
6091
6092 =back
6093
6094 =head2 perl561delta - what's new for perl v5.6.x
6095
6096 =over 4
6097
6098 =item DESCRIPTION
6099
6100 =item Summary of changes between 5.6.0 and 5.6.1
6101
6102 =over 4
6103
6104 =item Security Issues
6105
6106 =item Core bug fixes
6107
6108 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
6109 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
6110 references to special variables, Lexical warnings, Spurious warnings and
6111 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
6112 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
6113 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
6114 Module;>, Tests
6115
6116 =item Core features
6117
6118 =item Configuration issues
6119
6120 =item Documentation
6121
6122 =item Bundled modules
6123
6124 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
6125 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
6126 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
6127 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
6128
6129 =item Platform-specific improvements
6130
6131 NCR MP-RAS, NonStop-UX
6132
6133 =back
6134
6135 =item Core Enhancements
6136
6137 =over 4
6138
6139 =item Interpreter cloning, threads, and concurrency
6140
6141 =item Lexically scoped warning categories
6142
6143 =item Unicode and UTF-8 support
6144
6145 =item Support for interpolating named characters
6146
6147 =item "our" declarations
6148
6149 =item Support for strings represented as a vector of ordinals
6150
6151 =item Improved Perl version numbering system
6152
6153 =item New syntax for declaring subroutine attributes
6154
6155 =item File and directory handles can be autovivified
6156
6157 =item open() with more than two arguments
6158
6159 =item 64-bit support
6160
6161 =item Large file support
6162
6163 =item Long doubles
6164
6165 =item "more bits"
6166
6167 =item Enhanced support for sort() subroutines
6168
6169 =item C<sort $coderef @foo> allowed
6170
6171 =item File globbing implemented internally
6172
6173 =item Support for CHECK blocks
6174
6175 =item POSIX character class syntax [: :] supported
6176
6177 =item Better pseudo-random number generator
6178
6179 =item Improved C<qw//> operator
6180
6181 =item Better worst-case behavior of hashes
6182
6183 =item pack() format 'Z' supported
6184
6185 =item pack() format modifier '!' supported
6186
6187 =item pack() and unpack() support counted strings
6188
6189 =item Comments in pack() templates
6190
6191 =item Weak references
6192
6193 =item Binary numbers supported
6194
6195 =item Lvalue subroutines
6196
6197 =item Some arrows may be omitted in calls through references
6198
6199 =item Boolean assignment operators are legal lvalues
6200
6201 =item exists() is supported on subroutine names
6202
6203 =item exists() and delete() are supported on array elements
6204
6205 =item Pseudo-hashes work better
6206
6207 =item Automatic flushing of output buffers
6208
6209 =item Better diagnostics on meaningless filehandle operations
6210
6211 =item Where possible, buffered data discarded from duped input filehandle
6212
6213 =item eof() has the same old magic as <>
6214
6215 =item binmode() can be used to set :crlf and :raw modes
6216
6217 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6218
6219 =item system(), backticks and pipe open now reflect exec() failure
6220
6221 =item Improved diagnostics
6222
6223 =item Diagnostics follow STDERR
6224
6225 =item More consistent close-on-exec behavior
6226
6227 =item syswrite() ease-of-use
6228
6229 =item Better syntax checks on parenthesized unary operators
6230
6231 =item Bit operators support full native integer width
6232
6233 =item Improved security features
6234
6235 =item More functional bareword prototype (*)
6236
6237 =item C<require> and C<do> may be overridden
6238
6239 =item $^X variables may now have names longer than one character
6240
6241 =item New variable $^C reflects C<-c> switch
6242
6243 =item New variable $^V contains Perl version as a string
6244
6245 =item Optional Y2K warnings
6246
6247 =item Arrays now always interpolate into double-quoted strings
6248
6249 =back
6250
6251 =item Modules and Pragmata
6252
6253 =over 4
6254
6255 =item Modules
6256
6257 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6258 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6259 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6260 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6261 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6262 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6263 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6264 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6265
6266 =item Pragmata
6267
6268 =back
6269
6270 =item Utility Changes
6271
6272 =over 4
6273
6274 =item dprofpp
6275
6276 =item find2perl
6277
6278 =item h2xs
6279
6280 =item perlcc
6281
6282 =item perldoc
6283
6284 =item The Perl Debugger
6285
6286 =back
6287
6288 =item Improved Documentation
6289
6290 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6291 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6292 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6293 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6294
6295 =item Performance enhancements
6296
6297 =over 4
6298
6299 =item Simple sort() using { $a <=> $b } and the like are optimized
6300
6301 =item Optimized assignments to lexical variables
6302
6303 =item Faster subroutine calls
6304
6305 =item delete(), each(), values() and hash iteration are faster
6306
6307 =back
6308
6309 =item Installation and Configuration Improvements
6310
6311 =over 4
6312
6313 =item -Dusethreads means something different
6314
6315 =item New Configure flags
6316
6317 =item Threadedness and 64-bitness now more daring
6318
6319 =item Long Doubles
6320
6321 =item -Dusemorebits
6322
6323 =item -Duselargefiles
6324
6325 =item installusrbinperl
6326
6327 =item SOCKS support
6328
6329 =item C<-A> flag
6330
6331 =item Enhanced Installation Directories
6332
6333 =item gcc automatically tried if 'cc' does not seem to be working
6334
6335 =back
6336
6337 =item Platform specific changes
6338
6339 =over 4
6340
6341 =item Supported platforms
6342
6343 =item DOS
6344
6345 =item OS390 (OpenEdition MVS)
6346
6347 =item VMS
6348
6349 =item Win32
6350
6351 =back
6352
6353 =item Significant bug fixes
6354
6355 =over 4
6356
6357 =item <HANDLE> on empty files
6358
6359 =item C<eval '...'> improvements
6360
6361 =item All compilation errors are true errors
6362
6363 =item Implicitly closed filehandles are safer
6364
6365 =item Behavior of list slices is more consistent
6366
6367 =item C<(\$)> prototype and C<$foo{a}>
6368
6369 =item C<goto &sub> and AUTOLOAD
6370
6371 =item C<-bareword> allowed under C<use integer>
6372
6373 =item Failures in DESTROY()
6374
6375 =item Locale bugs fixed
6376
6377 =item Memory leaks
6378
6379 =item Spurious subroutine stubs after failed subroutine calls
6380
6381 =item Taint failures under C<-U>
6382
6383 =item END blocks and the C<-c> switch
6384
6385 =item Potential to leak DATA filehandles
6386
6387 =back
6388
6389 =item New or Changed Diagnostics
6390
6391 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6392 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6393 / cannot take a count, / must be followed by a, A or Z, / must be followed
6394 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6395 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6396 passed through, /%s/ should probably be written as "%s", %s() called too
6397 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6398 argument is not a HASH or ARRAY element or slice, %s argument is not a
6399 subroutine name, %s package attribute may clash with future reserved word:
6400 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6401 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6402 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6403 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6404 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6405 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6406 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6407 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6408 weaken a nonreference, Character class [:%s:] unknown, Character class
6409 syntax [%s] belongs inside character classes, Constant is not %s reference,
6410 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6411 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6412 "local" instead of "our"?), Document contains no data, entering effective
6413 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6414 output, flock() on closed filehandle %s, Global symbol "%s" requires
6415 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6416 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6417 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6418 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6419 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6420 separator character %s in attribute list, Invalid separator character %s in
6421 subroutine attribute list, leaving effective %s failed, Lvalue subs
6422 returning %s not implemented yet, Method %s not permitted, Missing
6423 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6424 No %s specified for -%c, No package name allowed for variable %s in "our",
6425 No space allowed after -%c, no UTC offset information; assuming local time
6426 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6427 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6428 around "%s" list, Possible unintended interpolation of %s in string,
6429 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6430 instead, Premature end of script headers, Repeat count in pack overflows,
6431 Repeat count in unpack overflows, realloc() of freed memory ignored,
6432 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6433 zero-length expression, switching effective %s is not implemented, This
6434 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6435 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6436 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6437 escape \\%c passed through, Unterminated attribute parameter in attribute
6438 list, Unterminated attribute list, Unterminated attribute parameter in
6439 subroutine attribute list, Unterminated subroutine attribute list, Value of
6440 CLI symbol "%s" too long, Version number must be a constant number
6441
6442 =item New tests
6443
6444 =item Incompatible Changes
6445
6446 =over 4
6447
6448 =item Perl Source Incompatibilities
6449
6450 CHECK is a new keyword, Treatment of list slices of undef has changed,
6451 Format of $English::PERL_VERSION is different, Literals of the form
6452 C<1.2.3> parse differently, Possibly changed pseudo-random number
6453 generator, Hashing function for hash keys has changed, C<undef> fails on
6454 read only values, Close-on-exec bit may be set on pipe and socket handles,
6455 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6456 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6457 Text of some diagnostic output has changed, C<%@> has been removed,
6458 Parenthesized not() behaves like a list operator, Semantics of bareword
6459 prototype C<(*)> have changed, Semantics of bit operators may have changed
6460 on 64-bit platforms, More builtins taint their results
6461
6462 =item C Source Incompatibilities
6463
6464 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6465
6466 =item Compatible C Source API Changes
6467
6468 C<PATCHLEVEL> is now C<PERL_VERSION>
6469
6470 =item Binary Incompatibilities
6471
6472 =back
6473
6474 =item Known Problems
6475
6476 =over 4
6477
6478 =item Localizing a tied hash element may leak memory
6479
6480 =item Known test failures
6481
6482 =item EBCDIC platforms not fully supported
6483
6484 =item UNICOS/mk CC failures during Configure run
6485
6486 =item Arrow operator and arrays
6487
6488 =item Experimental features
6489
6490 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6491 pseudo-hash data type, The Compiler suite, Internal implementation of file
6492 globbing, The DB module, The regular expression code constructs:
6493
6494 =back
6495
6496 =item Obsolete Diagnostics
6497
6498 Character class syntax [: :] is reserved for future extensions, Ill-formed
6499 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6500 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6501 to mean "${$}<digit>" is deprecated
6502
6503 =item Reporting Bugs
6504
6505 =item SEE ALSO
6506
6507 =item HISTORY
6508
6509 =back
6510
6511 =head2 perl56delta - what's new for perl v5.6.0
6512
6513 =over 4
6514
6515 =item DESCRIPTION
6516
6517 =item Core Enhancements
6518
6519 =over 4
6520
6521 =item Interpreter cloning, threads, and concurrency
6522
6523 =item Lexically scoped warning categories
6524
6525 =item Unicode and UTF-8 support
6526
6527 =item Support for interpolating named characters
6528
6529 =item "our" declarations
6530
6531 =item Support for strings represented as a vector of ordinals
6532
6533 =item Improved Perl version numbering system
6534
6535 =item New syntax for declaring subroutine attributes
6536
6537 =item File and directory handles can be autovivified
6538
6539 =item open() with more than two arguments
6540
6541 =item 64-bit support
6542
6543 =item Large file support
6544
6545 =item Long doubles
6546
6547 =item "more bits"
6548
6549 =item Enhanced support for sort() subroutines
6550
6551 =item C<sort $coderef @foo> allowed
6552
6553 =item File globbing implemented internally
6554
6555 =item Support for CHECK blocks
6556
6557 =item POSIX character class syntax [: :] supported
6558
6559 =item Better pseudo-random number generator
6560
6561 =item Improved C<qw//> operator
6562
6563 =item Better worst-case behavior of hashes
6564
6565 =item pack() format 'Z' supported
6566
6567 =item pack() format modifier '!' supported
6568
6569 =item pack() and unpack() support counted strings
6570
6571 =item Comments in pack() templates
6572
6573 =item Weak references
6574
6575 =item Binary numbers supported
6576
6577 =item Lvalue subroutines
6578
6579 =item Some arrows may be omitted in calls through references
6580
6581 =item Boolean assignment operators are legal lvalues
6582
6583 =item exists() is supported on subroutine names
6584
6585 =item exists() and delete() are supported on array elements
6586
6587 =item Pseudo-hashes work better
6588
6589 =item Automatic flushing of output buffers
6590
6591 =item Better diagnostics on meaningless filehandle operations
6592
6593 =item Where possible, buffered data discarded from duped input filehandle
6594
6595 =item eof() has the same old magic as <>
6596
6597 =item binmode() can be used to set :crlf and :raw modes
6598
6599 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6600
6601 =item system(), backticks and pipe open now reflect exec() failure
6602
6603 =item Improved diagnostics
6604
6605 =item Diagnostics follow STDERR
6606
6607 =item More consistent close-on-exec behavior
6608
6609 =item syswrite() ease-of-use
6610
6611 =item Better syntax checks on parenthesized unary operators
6612
6613 =item Bit operators support full native integer width
6614
6615 =item Improved security features
6616
6617 =item More functional bareword prototype (*)
6618
6619 =item C<require> and C<do> may be overridden
6620
6621 =item $^X variables may now have names longer than one character
6622
6623 =item New variable $^C reflects C<-c> switch
6624
6625 =item New variable $^V contains Perl version as a string
6626
6627 =item Optional Y2K warnings
6628
6629 =item Arrays now always interpolate into double-quoted strings
6630
6631 =back
6632
6633 =item Modules and Pragmata
6634
6635 =over 4
6636
6637 =item Modules
6638
6639 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6640 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6641 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6642 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6643 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6644 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6645 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6646 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6647
6648 =item Pragmata
6649
6650 =back
6651
6652 =item Utility Changes
6653
6654 =over 4
6655
6656 =item dprofpp
6657
6658 =item find2perl
6659
6660 =item h2xs
6661
6662 =item perlcc
6663
6664 =item perldoc
6665
6666 =item The Perl Debugger
6667
6668 =back
6669
6670 =item Improved Documentation
6671
6672 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6673 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6674 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6675 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6676
6677 =item Performance enhancements
6678
6679 =over 4
6680
6681 =item Simple sort() using { $a <=> $b } and the like are optimized
6682
6683 =item Optimized assignments to lexical variables
6684
6685 =item Faster subroutine calls
6686
6687 =item delete(), each(), values() and hash iteration are faster
6688
6689 =back
6690
6691 =item Installation and Configuration Improvements
6692
6693 =over 4
6694
6695 =item -Dusethreads means something different
6696
6697 =item New Configure flags
6698
6699 =item Threadedness and 64-bitness now more daring
6700
6701 =item Long Doubles
6702
6703 =item -Dusemorebits
6704
6705 =item -Duselargefiles
6706
6707 =item installusrbinperl
6708
6709 =item SOCKS support
6710
6711 =item C<-A> flag
6712
6713 =item Enhanced Installation Directories
6714
6715 =back
6716
6717 =item Platform specific changes
6718
6719 =over 4
6720
6721 =item Supported platforms
6722
6723 =item DOS
6724
6725 =item OS390 (OpenEdition MVS)
6726
6727 =item VMS
6728
6729 =item Win32
6730
6731 =back
6732
6733 =item Significant bug fixes
6734
6735 =over 4
6736
6737 =item <HANDLE> on empty files
6738
6739 =item C<eval '...'> improvements
6740
6741 =item All compilation errors are true errors
6742
6743 =item Implicitly closed filehandles are safer
6744
6745 =item Behavior of list slices is more consistent
6746
6747 =item C<(\$)> prototype and C<$foo{a}>
6748
6749 =item C<goto &sub> and AUTOLOAD
6750
6751 =item C<-bareword> allowed under C<use integer>
6752
6753 =item Failures in DESTROY()
6754
6755 =item Locale bugs fixed
6756
6757 =item Memory leaks
6758
6759 =item Spurious subroutine stubs after failed subroutine calls
6760
6761 =item Taint failures under C<-U>
6762
6763 =item END blocks and the C<-c> switch
6764
6765 =item Potential to leak DATA filehandles
6766
6767 =back
6768
6769 =item New or Changed Diagnostics
6770
6771 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6772 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6773 / cannot take a count, / must be followed by a, A or Z, / must be followed
6774 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6775 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6776 passed through, /%s/ should probably be written as "%s", %s() called too
6777 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6778 argument is not a HASH or ARRAY element or slice, %s argument is not a
6779 subroutine name, %s package attribute may clash with future reserved word:
6780 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6781 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6782 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6783 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6784 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6785 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6786 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6787 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6788 weaken a nonreference, Character class [:%s:] unknown, Character class
6789 syntax [%s] belongs inside character classes, Constant is not %s reference,
6790 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6791 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6792 "local" instead of "our"?), Document contains no data, entering effective
6793 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6794 output, flock() on closed filehandle %s, Global symbol "%s" requires
6795 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6796 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6797 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6798 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6799 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6800 separator character %s in attribute list, Invalid separator character %s in
6801 subroutine attribute list, leaving effective %s failed, Lvalue subs
6802 returning %s not implemented yet, Method %s not permitted, Missing
6803 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6804 No %s specified for -%c, No package name allowed for variable %s in "our",
6805 No space allowed after -%c, no UTC offset information; assuming local time
6806 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6807 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6808 around "%s" list, Possible unintended interpolation of %s in string,
6809 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6810 instead, Premature end of script headers, Repeat count in pack overflows,
6811 Repeat count in unpack overflows, realloc() of freed memory ignored,
6812 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6813 zero-length expression, switching effective %s is not implemented, This
6814 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6815 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6816 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6817 escape \\%c passed through, Unterminated attribute parameter in attribute
6818 list, Unterminated attribute list, Unterminated attribute parameter in
6819 subroutine attribute list, Unterminated subroutine attribute list, Value of
6820 CLI symbol "%s" too long, Version number must be a constant number
6821
6822 =item New tests
6823
6824 =item Incompatible Changes
6825
6826 =over 4
6827
6828 =item Perl Source Incompatibilities
6829
6830 CHECK is a new keyword, Treatment of list slices of undef has changed,
6831 Format of $English::PERL_VERSION is different, Literals of the form
6832 C<1.2.3> parse differently, Possibly changed pseudo-random number
6833 generator, Hashing function for hash keys has changed, C<undef> fails on
6834 read only values, Close-on-exec bit may be set on pipe and socket handles,
6835 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6836 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6837 Text of some diagnostic output has changed, C<%@> has been removed,
6838 Parenthesized not() behaves like a list operator, Semantics of bareword
6839 prototype C<(*)> have changed, Semantics of bit operators may have changed
6840 on 64-bit platforms, More builtins taint their results
6841
6842 =item C Source Incompatibilities
6843
6844 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6845
6846 =item Compatible C Source API Changes
6847
6848 C<PATCHLEVEL> is now C<PERL_VERSION>
6849
6850 =item Binary Incompatibilities
6851
6852 =back
6853
6854 =item Known Problems
6855
6856 =over 4
6857
6858 =item Thread test failures
6859
6860 =item EBCDIC platforms not supported
6861
6862 =item In 64-bit HP-UX the lib/io_multihomed test may hang
6863
6864 =item NEXTSTEP 3.3 POSIX test failure
6865
6866 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
6867 gcc
6868
6869 =item UNICOS/mk CC failures during Configure run
6870
6871 =item Arrow operator and arrays
6872
6873 =item Experimental features
6874
6875 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6876 pseudo-hash data type, The Compiler suite, Internal implementation of file
6877 globbing, The DB module, The regular expression code constructs:
6878
6879 =back
6880
6881 =item Obsolete Diagnostics
6882
6883 Character class syntax [: :] is reserved for future extensions, Ill-formed
6884 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6885 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6886 to mean "${$}<digit>" is deprecated
6887
6888 =item Reporting Bugs
6889
6890 =item SEE ALSO
6891
6892 =item HISTORY
6893
6894 =back
6895
6896 =head2 perl5005delta - what's new for perl5.005
6897
6898 =over 4
6899
6900 =item DESCRIPTION
6901
6902 =item About the new versioning system
6903
6904 =item Incompatible Changes
6905
6906 =over 4
6907
6908 =item WARNING:  This version is not binary compatible with Perl 5.004.
6909
6910 =item Default installation structure has changed
6911
6912 =item Perl Source Compatibility
6913
6914 =item C Source Compatibility
6915
6916 =item Binary Compatibility
6917
6918 =item Security fixes may affect compatibility
6919
6920 =item Relaxed new mandatory warnings introduced in 5.004
6921
6922 =item Licensing
6923
6924 =back
6925
6926 =item Core Changes
6927
6928 =over 4
6929
6930 =item Threads
6931
6932 =item Compiler
6933
6934 =item Regular Expressions
6935
6936 Many new and improved optimizations, Many bug fixes, New regular expression
6937 constructs, New operator for precompiled regular expressions, Other
6938 improvements, Incompatible changes
6939
6940 =item   Improved malloc()
6941
6942 =item Quicksort is internally implemented
6943
6944 =item Reliable signals
6945
6946 =item Reliable stack pointers
6947
6948 =item More generous treatment of carriage returns
6949
6950 =item Memory leaks
6951
6952 =item Better support for multiple interpreters
6953
6954 =item Behavior of local() on array and hash elements is now well-defined
6955
6956 =item C<%!> is transparently tied to the L<Errno> module
6957
6958 =item Pseudo-hashes are supported
6959
6960 =item C<EXPR foreach EXPR> is supported
6961
6962 =item Keywords can be globally overridden
6963
6964 =item C<$^E> is meaningful on Win32
6965
6966 =item C<foreach (1..1000000)> optimized
6967
6968 =item C<Foo::> can be used as implicitly quoted package name
6969
6970 =item C<exists $Foo::{Bar::}> tests existence of a package
6971
6972 =item Better locale support
6973
6974 =item Experimental support for 64-bit platforms
6975
6976 =item prototype() returns useful results on builtins
6977
6978 =item Extended support for exception handling
6979
6980 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
6981
6982 =item All C<printf> format conversions are handled internally
6983
6984 =item New C<INIT> keyword
6985
6986 =item New C<lock> keyword
6987
6988 =item New C<qr//> operator
6989
6990 =item C<our> is now a reserved word
6991
6992 =item Tied arrays are now fully supported
6993
6994 =item Tied handles support is better
6995
6996 =item 4th argument to substr
6997
6998 =item Negative LENGTH argument to splice
6999
7000 =item Magic lvalues are now more magical
7001
7002 =item <> now reads in records
7003
7004 =back
7005
7006 =item Supported Platforms
7007
7008 =over 4
7009
7010 =item New Platforms
7011
7012 =item Changes in existing support
7013
7014 =back
7015
7016 =item Modules and Pragmata
7017
7018 =over 4
7019
7020 =item New Modules
7021
7022 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
7023 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
7024 Thread, attrs, fields, re
7025
7026 =item Changes in existing modules
7027
7028 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
7029 MakeMaker, CPAN, Cwd
7030
7031 =back
7032
7033 =item Utility Changes
7034
7035 =item Documentation Changes
7036
7037 =item New Diagnostics
7038
7039 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
7040 while coercing array into hash, Bareword "%s" refers to nonexistent
7041 package, Can't call method "%s" on an undefined value, Can't check
7042 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
7043 goto subroutine from an eval-string, Can't localize pseudo-hash element,
7044 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
7045 for "%s", Character class syntax [. .] is reserved for future extensions,
7046 Character class syntax [: :] is reserved for future extensions, Character
7047 class syntax [= =] is reserved for future extensions, %s: Eval-group in
7048 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
7049 Eval-group not allowed at run time, Explicit blessing to '' (assuming
7050 package main), Illegal hex digit ignored, No such array field, No such
7051 field "%s" in variable %s of type %s, Out of memory during ridiculously
7052 large request, Range iterator outside integer range, Recursive inheritance
7053 detected while looking for method '%s' %s, Reference found where even-sized
7054 list expected, Undefined value assigned to typeglob, Use of reserved word
7055 "%s" is deprecated, perl: warning: Setting locale failed
7056
7057 =item Obsolete Diagnostics
7058
7059 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
7060 temporary file, regexp too big
7061
7062 =item Configuration Changes
7063
7064 =item BUGS
7065
7066 =item SEE ALSO
7067
7068 =item HISTORY
7069
7070 =back
7071
7072 =head2 perl5004delta - what's new for perl5.004
7073
7074 =over 4
7075
7076 =item DESCRIPTION
7077
7078 =item Supported Environments
7079
7080 =item Core Changes
7081
7082 =over 4
7083
7084 =item List assignment to %ENV works
7085
7086 =item Change to "Can't locate Foo.pm in @INC" error
7087
7088 =item Compilation option: Binary compatibility with 5.003
7089
7090 =item $PERL5OPT environment variable
7091
7092 =item Limitations on B<-M>, B<-m>, and B<-T> options
7093
7094 =item More precise warnings
7095
7096 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
7097
7098 =item Previously deprecated %OVERLOAD is no longer usable
7099
7100 =item Subroutine arguments created only when they're modified
7101
7102 =item Group vector changeable with C<$)>
7103
7104 =item Fixed parsing of $$<digit>, &$<digit>, etc.
7105
7106 =item Fixed localization of $<digit>, $&, etc.
7107
7108 =item No resetting of $. on implicit close
7109
7110 =item C<wantarray> may return undef
7111
7112 =item C<eval EXPR> determines value of EXPR in scalar context
7113
7114 =item Changes to tainting checks
7115
7116 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
7117 spawning if tainted $TERM doesn't look like a terminal name
7118
7119 =item New Opcode module and revised Safe module
7120
7121 =item Embedding improvements
7122
7123 =item Internal change: FileHandle class based on IO::* classes
7124
7125 =item Internal change: PerlIO abstraction interface
7126
7127 =item New and changed syntax
7128
7129 $coderef->(PARAMS)
7130
7131 =item New and changed builtin constants
7132
7133 __PACKAGE__
7134
7135 =item New and changed builtin variables
7136
7137 $^E, $^H, $^M
7138
7139 =item New and changed builtin functions
7140
7141 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
7142 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
7143 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
7144 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
7145 nested C<sub{}> closures work now, formats work right on changing lexicals
7146
7147 =item New builtin methods
7148
7149 isa(CLASS), can(METHOD), VERSION( [NEED] )
7150
7151 =item TIEHANDLE now supported
7152
7153 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
7154 LIST, READLINE this, GETC this, DESTROY this
7155
7156 =item Malloc enhancements
7157
7158 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
7159
7160 =item Miscellaneous efficiency enhancements
7161
7162 =back
7163
7164 =item Support for More Operating Systems
7165
7166 =over 4
7167
7168 =item Win32
7169
7170 =item Plan 9
7171
7172 =item QNX
7173
7174 =item AmigaOS
7175
7176 =back
7177
7178 =item Pragmata
7179
7180 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
7181 constant NAME => VALUE, use locale, use ops, use vmsish
7182
7183 =item Modules
7184
7185 =over 4
7186
7187 =item Required Updates
7188
7189 =item Installation directories
7190
7191 =item Module information summary
7192
7193 =item Fcntl
7194
7195 =item IO
7196
7197 =item Math::Complex
7198
7199 =item Math::Trig
7200
7201 =item DB_File
7202
7203 =item Net::Ping
7204
7205 =item Object-oriented overrides for builtin operators
7206
7207 =back
7208
7209 =item Utility Changes
7210
7211 =over 4
7212
7213 =item pod2html
7214
7215 Sends converted HTML to standard output
7216
7217 =item xsubpp
7218
7219 C<void> XSUBs now default to returning nothing
7220
7221 =back
7222
7223 =item C Language API Changes
7224
7225 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
7226 manipulating hashes
7227
7228 =item Documentation Changes
7229
7230 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
7231 L<perlmodlib>, L<perldebug>, L<perlsec>
7232
7233 =item New Diagnostics
7234
7235 "my" variable %s masks earlier declaration in same scope, %s argument is
7236 not a HASH element or slice, Allocation too large: %lx, Allocation too
7237 large, Applying %s to %s will act on scalar(%s), Attempt to free
7238 nonexistent shared string, Attempt to use reference as lvalue in substr,
7239 Bareword "%s" refers to nonexistent package, Can't redefine active sort
7240 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
7241 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
7242 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
7243 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
7244 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
7245 %s, Integer overflow in hex number, Integer overflow in octal number,
7246 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
7247 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
7248 possible typo, Null picture in formline, Offset outside string, Out of
7249 memory!, Out of memory during request for %s, panic: frexp, Possible
7250 attempt to put comments in qw() list, Possible attempt to separate words
7251 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
7252 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
7253 option, untie attempted while %d inner references still exist, Unrecognized
7254 character %s, Unsupported function fork, Use of "$$<digit>" to mean
7255 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
7256 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
7257 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
7258 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
7259 long, Process terminated by SIG%s
7260
7261 =item BUGS
7262
7263 =item SEE ALSO
7264
7265 =item HISTORY
7266
7267 =back
7268
7269 =head2 perlartistic - the Perl Artistic License
7270
7271 =over 4
7272
7273 =item SYNOPSIS
7274
7275 =item DESCRIPTION
7276
7277 =item The "Artistic License"
7278
7279 =over 4
7280
7281 =item Preamble
7282
7283 =item Definitions
7284
7285 "Package", "Standard Version", "Copyright Holder", "You", "Reasonable
7286 copying fee", "Freely Available"
7287
7288 =item Conditions
7289
7290 a), b), c), d), a), b), c), d)
7291
7292 =back
7293
7294 =back
7295
7296 =head2 perlgpl - the GNU General Public License, version 2
7297
7298 =over 4
7299
7300 =item SYNOPSIS
7301
7302 =back
7303
7304 =over 4
7305
7306 =item DESCRIPTION
7307
7308 =item GNU GENERAL PUBLIC LICENSE
7309
7310 =back
7311
7312 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
7313
7314 =over 4
7315
7316 =item DESCRIPTION
7317
7318 =over 4
7319
7320 =item Compiling Perl 5 on AIX
7321
7322 =item OS level
7323
7324 =item Building Dynamic Extensions on AIX
7325
7326 =item The IBM ANSI C Compiler
7327
7328 =item Using GNU's gcc for building perl
7329
7330 =item Using Large Files with Perl
7331
7332 =item Threaded Perl
7333
7334 =item 64-bit Perl
7335
7336 =item AIX 4.2 and extensions using C++ with statics
7337
7338 =back
7339
7340 =item AUTHOR
7341
7342 =item DATE
7343
7344 =back
7345
7346 =head2 perlamiga - Perl under Amiga OS
7347
7348 =over 4
7349
7350 =item NOTE
7351
7352 =item SYNOPSIS
7353
7354 =back
7355
7356 =over 4
7357
7358 =item DESCRIPTION
7359
7360 =over 4
7361
7362 =item Prerequisites for Compiling Perl on AmigaOS
7363
7364 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
7365
7366 =item Starting Perl programs under AmigaOS
7367
7368 =item Shortcomings of Perl under AmigaOS
7369
7370 =back
7371
7372 =item INSTALLATION
7373
7374 =item Accessing documentation
7375
7376 =over 4
7377
7378 =item Manpages for Perl on AmigaOS
7379
7380 =item Perl HTML Documentation on AmigaOS
7381
7382 =item Perl GNU Info Files on AmigaOS
7383
7384 =item Perl LaTeX Documentation on AmigaOS
7385
7386 =back
7387
7388 =item BUILDING PERL ON AMIGAOS
7389
7390 =over 4
7391
7392 =item Build Prerequisites for Perl on AmigaOS
7393
7394 =item Getting the Perl Source for AmigaOS
7395
7396 =item Making Perl on AmigaOS
7397
7398 =item Testing Perl on AmigaOS
7399
7400 =item Installing the built Perl on AmigaOS
7401
7402 =back
7403
7404 =item PERL 5.8.0 BROKEN IN AMIGAOS
7405
7406 =item AUTHORS
7407
7408 =item SEE ALSO
7409
7410 =back
7411
7412 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
7413
7414 =over 4
7415
7416 =item DESCRIPTION
7417
7418 =item AUTHOR
7419
7420 =back
7421
7422 =head2 perlbeos, README.beos - Perl version 5 on BeOS
7423
7424 =over 4
7425
7426 =item DESCRIPTION
7427
7428 =over 4
7429
7430 =item General Issues with Perl on BeOS
7431
7432 =item BeOS Release-specific Notes
7433
7434 R4 x86, R4 PPC
7435
7436 =item Contact Information
7437
7438 =item Update 2002-05-30
7439
7440 =back
7441
7442 =back
7443
7444 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
7445
7446 =over 4
7447
7448 =item SYNOPSIS
7449
7450 =item DESCRIPTION
7451
7452 =over 4
7453
7454 =item gzip on BS2000
7455
7456 =item bison on BS2000
7457
7458 =item Unpacking Perl Distribution on BS2000
7459
7460 =item Compiling Perl on BS2000
7461
7462 =item Testing Perl on BS2000
7463
7464 =item Installing Perl on BS2000
7465
7466 =item Using Perl in the Posix-Shell of BS2000
7467
7468 =item Using Perl in "native" BS2000
7469
7470 =item Floating point anomalies on BS2000
7471
7472 =back
7473
7474 =item AUTHORS
7475
7476 =item SEE ALSO
7477
7478 =over 4
7479
7480 =item Mailing list
7481
7482 =back
7483
7484 =item HISTORY
7485
7486 =back
7487
7488 =over 4
7489
7490 =item Name
7491
7492 =item Description
7493
7494 =item Build
7495
7496 =over 4
7497
7498 =item Tools & SDK
7499
7500 Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's
7501 celib-sources, Rainer Keuchel's console-sources
7502
7503 =item Make
7504
7505 go to ./wince subdirectory, edit file compile.bat, run    compile.bat, run 
7506   compile.bat dist
7507
7508 =back
7509
7510 =item Acknowledgements
7511
7512 =item AUTHORS
7513
7514 =back
7515
7516 =head2 perlcygwin, README.cygwin - Perl for Cygwin
7517
7518 =over 4
7519
7520 =item SYNOPSIS
7521
7522 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
7523
7524 =over 4
7525
7526 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
7527
7528 =item Cygwin Configuration
7529
7530 C<PATH>, I<nroff>, Permissions
7531
7532 =back
7533
7534 =item CONFIGURE PERL ON CYGWIN
7535
7536 =over 4
7537
7538 =item Stripping Perl Binaries on Cygwin
7539
7540 =item Optional Libraries for Perl on Cygwin
7541
7542 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
7543 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
7544
7545 =item Configure-time Options for Perl on Cygwin
7546
7547 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
7548 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
7549 C<-Dmksymlinks>
7550
7551 =item Suspicious Warnings on Cygwin
7552
7553 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
7554
7555 =back
7556
7557 =item MAKE ON CYGWIN
7558
7559 =over 4
7560
7561 =item Errors on Cygwin
7562
7563 =item ld2 on Cygwin
7564
7565 =back
7566
7567 =item TEST ON CYGWIN
7568
7569 =over 4
7570
7571 =item File Permissions on Cygwin
7572
7573 =item NDBM_File and ODBM_File do not work on FAT filesystems
7574
7575 =item C<fork()> failures in io_* tests
7576
7577 =item Script Portability on Cygwin
7578
7579 Pathnames, Text/Binary, PerlIO, F<.exe>, C<chown()>, Miscellaneous
7580
7581 =back
7582
7583 =item INSTALL PERL ON CYGWIN
7584
7585 =item MANIFEST ON CYGWIN
7586
7587 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
7588 Source, Compiled Module Source, Perl Modules/Scripts
7589
7590 =item BUGS ON CYGWIN
7591
7592 =item AUTHORS
7593
7594 =item HISTORY
7595
7596 =back
7597
7598 =head2 perldgux - Perl under DG/UX.
7599
7600 =over 4
7601
7602 =item SYNOPSIS
7603
7604 =back
7605
7606 =over 4
7607
7608 =item DESCRIPTION
7609
7610 =item BUILDING PERL ON DG/UX
7611
7612 =over 4
7613
7614 =item Non-threaded Perl on DG/UX
7615
7616 =item Threaded Perl on DG/UX
7617
7618 =item Testing Perl on DG/UX
7619
7620 =item Installing the built perl on DG/UX
7621
7622 =back
7623
7624 =item AUTHOR
7625
7626 =item SEE ALSO
7627
7628 =back
7629
7630 =head2 perldos - Perl under DOS, W31, W95.
7631
7632 =over 4
7633
7634 =item SYNOPSIS
7635
7636 =item DESCRIPTION
7637
7638 =over 4
7639
7640 =item Prerequisites for Compiling Perl on DOS
7641
7642 DJGPP, Pthreads
7643
7644 =item Shortcomings of Perl under DOS
7645
7646 =item Building Perl on DOS
7647
7648 =item Testing Perl on DOS
7649
7650 =item Installation of Perl on DOS
7651
7652 =back
7653
7654 =item BUILDING AND INSTALLING MODULES ON DOS
7655
7656 =over 4
7657
7658 =item Building Prerequisites for Perl on DOS
7659
7660 =item Unpacking CPAN Modules on DOS
7661
7662 =item Building Non-XS Modules on DOS
7663
7664 =item Building XS Modules on DOS
7665
7666 =back
7667
7668 =item AUTHOR
7669
7670 =item SEE ALSO
7671
7672 =back
7673
7674 =head2 perlepoc, README.epoc - Perl for EPOC
7675
7676 =over 4
7677
7678 =item SYNOPSIS
7679
7680 =item INTRODUCTION
7681
7682 =item INSTALLING PERL ON EPOC
7683
7684 =item STARTING PERL ON EPOC
7685
7686 =over 4
7687
7688 =item Editors on Epoc
7689
7690 =item Features of Perl on Epoc
7691
7692 =item Restrictions of Perl on Epoc
7693
7694 =item Compiling Perl 5 on the EPOC cross compiling environment
7695
7696 =back
7697
7698 =item SUPPORT STATUS OF PERL ON EPOC
7699
7700 =item AUTHOR
7701
7702 =item LAST UPDATE
7703
7704 =back
7705
7706 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
7707
7708 =over 4
7709
7710 =item DESCRIPTION
7711
7712 =over 4
7713
7714 =item FreeBSD core dumps from readdir_r with ithreads
7715
7716 =item $^X doesn't always contain a full path in FreeBSD
7717
7718 =item Perl will no longer be part of "base FreeBSD"
7719
7720 =back
7721
7722 =item AUTHOR
7723
7724 =back
7725
7726 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
7727 (HP-UX) systems
7728
7729 =over 4
7730
7731 =item DESCRIPTION
7732
7733 =over 4
7734
7735 =item Using perl as shipped with HP-UX
7736
7737 =item Using perl from HP's porting centre
7738
7739 =item Compiling Perl 5 on HP-UX
7740
7741 =item PA-RISC
7742
7743 =item PA-RISC 1.0
7744
7745 =item PA-RISC 1.1
7746
7747 =item PA-RISC 2.0
7748
7749 =item Itanium
7750
7751 =item Portability Between PA-RISC Versions
7752
7753 =item Itanium Processor Family and HP-UX
7754
7755 =item Building Dynamic Extensions on HP-UX
7756
7757 =item The HP ANSI C Compiler
7758
7759 =item The GNU C Compiler
7760
7761 =item Using Large Files with Perl on HP-UX
7762
7763 =item Threaded Perl on HP-UX
7764
7765 =item 64-bit Perl on HP-UX
7766
7767 =item Oracle on HP-UX
7768
7769 =item GDBM and Threads on HP-UX
7770
7771 =item NFS filesystems and utime(2) on HP-UX
7772
7773 =item perl -P and // and HP-UX
7774
7775 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
7776
7777 =back
7778
7779 =item nss_delete core dump from op/pwent or op/grent
7780
7781 =item AUTHOR
7782
7783 =item DATE
7784
7785 =back
7786
7787 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
7788
7789 =over 4
7790
7791 =item DESCRIPTION
7792
7793 =over 4
7794
7795 =item Known Problems with Perl on Hurd 
7796
7797 =back
7798
7799 =item AUTHOR
7800
7801 =back
7802
7803 =head2 perlirix, README.irix - Perl version 5 on Irix systems
7804
7805 =over 4
7806
7807 =item DESCRIPTION
7808
7809 =over 4
7810
7811 =item Building 32-bit Perl in Irix
7812
7813 =item Building 64-bit Perl in Irix
7814
7815 =item About Compiler Versions of Irix
7816
7817 =item Linker Problems in Irix
7818
7819 =item Malloc in Irix
7820
7821 =item Building with threads in Irix
7822
7823 =item Irix 5.3
7824
7825 =back
7826
7827 =item AUTHOR
7828
7829 =back
7830
7831 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
7832 systems
7833
7834 =over 4
7835
7836 =item DESCRIPTION
7837
7838 =over 4
7839
7840 =item Compiling Perl 5 on MachTen
7841
7842 =item Failures during C<make test> on MachTen
7843
7844 op/lexassign.t, pragma/warnings.t
7845
7846 =item Building external modules on MachTen
7847
7848 =back
7849
7850 =item AUTHOR
7851
7852 =item DATE
7853
7854 =back
7855
7856 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
7857
7858 =over 4
7859
7860 =item SYNOPSIS
7861
7862 =item DESCRIPTION
7863
7864 =item AUTHOR
7865
7866 =item DATE
7867
7868 =back
7869
7870 =head2 perlmacosx, README.macosx - Perl under Mac OS X
7871
7872 =over 4
7873
7874 =item SYNOPSIS
7875
7876 =item DESCRIPTION
7877
7878 =over 4
7879
7880 =item Installation Prefix
7881
7882 =item libperl and Prebinding
7883
7884 =item Updating Panther
7885
7886 =item Known problems
7887
7888 =item MacPerl
7889
7890 =item Carbon
7891
7892 =item Cocoa
7893
7894 =back
7895
7896 =item AUTHOR
7897
7898 =item DATE
7899
7900 =back
7901
7902 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
7903
7904 =over 4
7905
7906 =item DESCRIPTION
7907
7908 =item Known problems with Perl on MiNT
7909
7910 =item AUTHOR
7911
7912 =back
7913
7914 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
7915
7916 =over 4
7917
7918 =item SYNOPSIS
7919
7920 =item NOTE
7921
7922 =item Binary distribution from HP
7923
7924 =item What's New in Perl for MPE/iX
7925
7926 =item Welcome to Perl/iX
7927
7928 =item System Requirements for Perl/iX
7929
7930 =item How to Obtain Perl/iX
7931
7932 =item Perl/iX Distribution Contents Highlights
7933
7934 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
7935 public_html/feedback.cgi, src/perl-5.6.0-mpe
7936
7937 =item How to Compile Perl/iX
7938
7939  4,  6
7940
7941 =item Getting Started with Perl/iX
7942
7943 =item MPE/iX Implementation Considerations
7944
7945 =item Known Perl/iX Bugs Under Investigation
7946
7947 =item Perl/iX To-Do List
7948
7949 =item Perl/iX Change History
7950
7951 =item AUTHOR
7952
7953 =item Name
7954
7955 =item Description
7956
7957 =item Build
7958
7959 =over 4
7960
7961 =item Tools & SDK
7962
7963 =item Setup
7964
7965 SetNWBld.bat, Buildtype.bat
7966
7967 =item Make
7968
7969 =item Interpreter
7970
7971 =item Extensions
7972
7973 =back
7974
7975 =item Install
7976
7977 =item Build new extensions
7978
7979 =item Acknowledgements
7980
7981 =item Authors
7982
7983 =item Date
7984
7985 =back
7986
7987 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
7988
7989 =over 4
7990
7991 =item SYNOPSIS
7992
7993 =back
7994
7995 =over 4
7996
7997 =item DESCRIPTION
7998
7999 =over 4
8000
8001 =item Target
8002
8003 =item Other OSes
8004
8005 =item Prerequisites
8006
8007 EMX, RSX, HPFS, pdksh
8008
8009 =item Starting Perl programs under OS/2 (and DOS and...)
8010
8011 =item Starting OS/2 (and DOS) programs under Perl
8012
8013 =back
8014
8015 =item Frequently asked questions
8016
8017 =over 4
8018
8019 =item "It does not work"
8020
8021 =item I cannot run external programs
8022
8023 =item I cannot embed perl into my program, or use F<perl.dll> from my
8024 program. 
8025
8026 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
8027 L<ExtUtils::Embed>?
8028
8029 =item C<``> and pipe-C<open> do not work under DOS.
8030
8031 =item Cannot start C<find.exe "pattern" file>
8032
8033 =back
8034
8035 =item INSTALLATION
8036
8037 =over 4
8038
8039 =item Automatic binary installation
8040
8041 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
8042
8043 =item Manual binary installation
8044
8045 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
8046 (statically linked), Executables for Perl utilities, Main Perl library,
8047 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
8048 and utilities, Manpages for Perl modules, Source for Perl documentation,
8049 Perl manual in F<.INF> format, Pdksh
8050
8051 =item B<Warning>
8052
8053 =back
8054
8055 =item Accessing documentation
8056
8057 =over 4
8058
8059 =item OS/2 F<.INF> file
8060
8061 =item Plain text
8062
8063 =item Manpages
8064
8065 =item HTML
8066
8067 =item GNU C<info> files
8068
8069 =item F<PDF> files
8070
8071 =item C<LaTeX> docs
8072
8073 =back
8074
8075 =item BUILD
8076
8077 =over 4
8078
8079 =item The short story
8080
8081 =item Prerequisites
8082
8083 =item Getting perl source
8084
8085 =item Application of the patches
8086
8087 =item Hand-editing
8088
8089 =item Making
8090
8091 =item Testing
8092
8093 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
8094 F<op/stat.t>
8095
8096 =item Installing the built perl
8097
8098 =item C<a.out>-style build
8099
8100 =back
8101
8102 =item Build FAQ
8103
8104 =over 4
8105
8106 =item Some C</> became C<\> in pdksh.
8107
8108 =item C<'errno'> - unresolved external
8109
8110 =item Problems with tr or sed
8111
8112 =item Some problem (forget which ;-)
8113
8114 =item Library ... not found
8115
8116 =item Segfault in make
8117
8118 =item op/sprintf test failure
8119
8120 =back
8121
8122 =item Specific (mis)features of OS/2 port
8123
8124 =over 4
8125
8126 =item C<setpriority>, C<getpriority>
8127
8128 =item C<system()>
8129
8130 =item C<extproc> on the first line
8131
8132 =item Additional modules:
8133
8134 =item Prebuilt methods:
8135
8136 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
8137  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>, 
8138 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>, 
8139 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>, 
8140 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>, 
8141 C<Cwd::extLibpath_set( path [, type ] )>,
8142 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
8143 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
8144 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
8145 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
8146 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
8147 C<OS2::DLLname([how [, \&xsub]])>
8148
8149 =item Prebuilt variables:
8150
8151 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
8152 $OS2::nsyserror
8153
8154 =item Misfeatures
8155
8156 =item Modifications
8157
8158 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
8159 C<flock>
8160
8161 =item Identifying DLLs
8162
8163 =item Centralized management of resources
8164
8165 C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
8166 C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
8167 C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
8168 C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
8169
8170 =back
8171
8172 =item Perl flavors
8173
8174 =over 4
8175
8176 =item F<perl.exe>
8177
8178 =item F<perl_.exe>
8179
8180 =item F<perl__.exe>
8181
8182 =item F<perl___.exe>
8183
8184 =item Why strange names?
8185
8186 =item Why dynamic linking?
8187
8188 =item Why chimera build?
8189
8190 =back
8191
8192 =item ENVIRONMENT
8193
8194 =over 4
8195
8196 =item C<PERLLIB_PREFIX>
8197
8198 =item C<PERL_BADLANG>
8199
8200 =item C<PERL_BADFREE>
8201
8202 =item C<PERL_SH_DIR>
8203
8204 =item C<USE_PERL_FLOCK>
8205
8206 =item C<TMP> or C<TEMP>
8207
8208 =back
8209
8210 =item Evolution
8211
8212 =over 4
8213
8214 =item Text-mode filehandles
8215
8216 =item Priorities
8217
8218 =item DLL name mangling: pre 5.6.2
8219
8220 =item DLL name mangling: 5.6.2 and beyond
8221
8222 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
8223 C<LIBPATH>
8224
8225 =item DLL forwarder generation
8226
8227 =item Threading
8228
8229 =item Calls to external programs
8230
8231 =item Memory allocation
8232
8233 =item Threads
8234
8235 C<COND_WAIT>, F<os2.c>
8236
8237 =back
8238
8239 =item BUGS
8240
8241 =back
8242
8243 =over 4
8244
8245 =item AUTHOR
8246
8247 =item SEE ALSO
8248
8249 =back
8250
8251 =head2 perlos390, README.os390 - building and installing Perl for OS/390
8252 and z/OS
8253
8254 =over 4
8255
8256 =item SYNOPSIS
8257
8258 =item DESCRIPTION
8259
8260 =over 4
8261
8262 =item Tools
8263
8264 =item Unpacking Perl distribution on OS/390
8265
8266 =item Setup and utilities for Perl on OS/390
8267
8268 =item Configure Perl on OS/390
8269
8270 =item Build, Test, Install Perl on OS/390
8271
8272 =item Build Anomalies with Perl on OS/390
8273
8274 =item Testing Anomalies with Perl on OS/390
8275
8276 =item Installation Anomalies with Perl on OS/390
8277
8278 =item Usage Hints for Perl on OS/390
8279
8280 =item Floating Point Anomalies with Perl on OS/390
8281
8282 =item Modules and Extensions for Perl on OS/390
8283
8284 =back
8285
8286 =item AUTHORS
8287
8288 =item SEE ALSO
8289
8290 =over 4
8291
8292 =item Mailing list for Perl on OS/390
8293
8294 =back
8295
8296 =item HISTORY
8297
8298 =back
8299
8300 =head2 perlos400, README.os400 - Perl version 5 on OS/400
8301
8302 =over 4
8303
8304 =item DESCRIPTION
8305
8306 =over 4
8307
8308 =item Compiling Perl for OS/400 PASE
8309
8310 =item Installing Perl in OS/400 PASE
8311
8312 =item Using Perl in OS/400 PASE
8313
8314 =item Known Problems
8315
8316 =item Perl on ILE
8317
8318 =back
8319
8320 =item AUTHORS
8321
8322 =back
8323
8324 =head2 perlplan9 - Plan 9-specific documentation for Perl
8325
8326 =over 4
8327
8328 =item DESCRIPTION
8329
8330 =over 4
8331
8332 =item Invoking Perl
8333
8334 =item What's in Plan 9 Perl
8335
8336 =item What's not in Plan 9 Perl
8337
8338 =item Perl5 Functions not currently supported in Plan 9 Perl
8339
8340 =item Signals in Plan 9 Perl
8341
8342 =back
8343
8344 =item COMPILING AND INSTALLING PERL ON PLAN 9
8345
8346 =over 4
8347
8348 =item Installing Perl Documentation on Plan 9
8349
8350 =back
8351
8352 =item BUGS
8353
8354 =item Revision date
8355
8356 =item AUTHOR
8357
8358 =back
8359
8360 =head2 perlqnx, README.qnx - Perl version 5 on QNX
8361
8362 =over 4
8363
8364 =item DESCRIPTION
8365
8366 =over 4
8367
8368 =item Required Software for Compiling Perl on QNX4
8369
8370 /bin/sh, ar, nm, cpp, make
8371
8372 =item Outstanding Issues with Perl on QNX4
8373
8374 =item QNX auxiliary files
8375
8376 qnx/ar, qnx/cpp
8377
8378 =item Outstanding issues with perl under QNX6
8379
8380 =back
8381
8382 =item AUTHOR
8383
8384 =back
8385
8386 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
8387
8388 =over 4
8389
8390 =item DESCRIPTION
8391
8392 =over 4
8393
8394 =item Solaris Version Numbers.
8395
8396 =back
8397
8398 =item RESOURCES
8399
8400 Solaris FAQ, Precompiled Binaries, Solaris Documentation
8401
8402 =item SETTING UP
8403
8404 =over 4
8405
8406 =item File Extraction Problems on Solaris.
8407
8408 =item Compiler and Related Tools on Solaris.
8409
8410 =item Environment for Compiling perl on Solaris
8411
8412 =back
8413
8414 =item RUN CONFIGURE.
8415
8416 =over 4
8417
8418 =item 64-bit perl on Solaris.
8419
8420 =item Threads in perl on Solaris.
8421
8422 =item Malloc Issues with perl on Solaris.
8423
8424 =back
8425
8426 =item MAKE PROBLEMS.
8427
8428 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
8429 relocation error:, dlopen: stub interception failed, #error "No
8430 DATAMODEL_NATIVE specified", sh: ar: not found
8431
8432 =item MAKE TEST
8433
8434 =over 4
8435
8436 =item op/stat.t test 4 in Solaris
8437
8438 =item nss_delete core dump from op/pwent or op/grent
8439
8440 =back
8441
8442 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
8443
8444 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
8445
8446 =over 4
8447
8448 =item Limits on Numbers of Open Files on Solaris.
8449
8450 =back
8451
8452 =item SOLARIS-SPECIFIC MODULES.
8453
8454 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
8455
8456 =over 4
8457
8458 =item Proc::ProcessTable on Solaris
8459
8460 =item BSD::Resource on Solaris
8461
8462 =item Net::SSLeay on Solaris
8463
8464 =back
8465
8466 =item AUTHOR
8467
8468 =item LAST MODIFIED
8469
8470 =back
8471
8472 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
8473 Digital UNIX formerly known as DEC OSF/1) systems
8474
8475 =over 4
8476
8477 =item DESCRIPTION
8478
8479 =over 4
8480
8481 =item Compiling Perl 5 on Tru64
8482
8483 =item Using Large Files with Perl on Tru64
8484
8485 =item Threaded Perl on Tru64
8486
8487 =item Long Doubles on Tru64
8488
8489 =item DB_File tests failing on Tru64
8490
8491 =item 64-bit Perl on Tru64
8492
8493 =item Warnings about floating-point overflow when compiling Perl on Tru64
8494
8495 =back
8496
8497 =item Testing Perl on Tru64
8498
8499 =item ext/ODBM_File/odbm Test Failing With Static Builds
8500
8501 =item Perl Fails Because Of Unresolved Symbol sockatmark
8502
8503 =item AUTHOR
8504
8505 =back
8506
8507 =head2 perluts - Perl under UTS
8508
8509 =over 4
8510
8511 =item SYNOPSIS
8512
8513 =item DESCRIPTION
8514
8515 =item BUILDING PERL ON UTS
8516
8517 =item Installing the built perl on UTS
8518
8519 =item AUTHOR
8520
8521 =back
8522
8523 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
8524
8525 =over 4
8526
8527 =item SYNOPSIS
8528
8529 =item DESCRIPTION
8530
8531 =over 4
8532
8533 =item Unpacking Perl Distribution on VM/ESA
8534
8535 =item Setup Perl and utilities on VM/ESA
8536
8537 =item Configure Perl on VM/ESA
8538
8539 =item Testing Anomalies of Perl on VM/ESA
8540
8541 =item Usage Hints for Perl on VM/ESA
8542
8543 =back
8544
8545 =item AUTHORS
8546
8547 =item SEE ALSO
8548
8549 =over 4
8550
8551 =item Mailing list for Perl on VM/ESA
8552
8553 =back
8554
8555 =back
8556
8557 =head2 perlvms - VMS-specific documentation for Perl
8558
8559 =over 4
8560
8561 =item DESCRIPTION
8562
8563 =item Installation
8564
8565 =item Organization of Perl Images
8566
8567 =over 4
8568
8569 =item Core Images
8570
8571 =item Perl Extensions
8572
8573 =item Installing static extensions
8574
8575 =item Installing dynamic extensions
8576
8577 =back
8578
8579 =item File specifications
8580
8581 =over 4
8582
8583 =item Syntax
8584
8585 =item Wildcard expansion
8586
8587 =item Pipes
8588
8589 =back
8590
8591 =item PERL5LIB and PERLLIB
8592
8593 =item Command line
8594
8595 =over 4
8596
8597 =item I/O redirection and backgrounding
8598
8599 =item Command line switches
8600
8601 -i, -S, -u
8602
8603 =back
8604
8605 =item Perl functions
8606
8607 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
8608 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
8609 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
8610 LIST, waitpid PID,FLAGS
8611
8612 =item Perl variables
8613
8614 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
8615
8616 =item Standard modules with VMS-specific differences
8617
8618 =over 4
8619
8620 =item SDBM_File
8621
8622 =back
8623
8624 =item Revision date
8625
8626 =item AUTHOR
8627
8628 =back
8629
8630 =head2 perlvos, README.vos - Perl for Stratus VOS
8631
8632 =over 4
8633
8634 =item SYNOPSIS
8635
8636 =item BUILDING PERL FOR VOS
8637
8638 =item INSTALLING PERL IN VOS
8639
8640 =item USING PERL IN VOS
8641
8642 =over 4
8643
8644 =item Restrictions of Perl on VOS
8645
8646 =item Handling of underflow and overflow
8647
8648 =back
8649
8650 =item TEST STATUS
8651
8652 =item SUPPORT STATUS
8653
8654 =item AUTHOR
8655
8656 =item LAST UPDATE
8657
8658 =back
8659
8660 =head2 perlwin32 - Perl under Windows
8661
8662 =over 4
8663
8664 =item SYNOPSIS
8665
8666 =item DESCRIPTION
8667
8668 =over 4
8669
8670 =item Setting Up Perl on Win32
8671
8672 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform
8673 SDK 64-bit Compiler, MinGW32 with gcc, MinGW release 1
8674
8675 =item Building
8676
8677 =item Testing Perl on Win32
8678
8679 =item Installation of Perl on Win32
8680
8681 =item Usage Hints for Perl on Win32
8682
8683 Environment Variables, File Globbing, Using perl from the command line,
8684 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
8685 Extensions, Notes on 64-bit Windows
8686
8687 =item Running Perl Scripts
8688
8689 Miscellaneous Things
8690
8691 =back
8692
8693 =item BUGS AND CAVEATS
8694
8695 =item AUTHORS
8696
8697 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
8698 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
8699 E<lt>nick@ing-simmons.netE<gt>
8700
8701 =item SEE ALSO
8702
8703 =item HISTORY
8704
8705 =back
8706
8707 =head1 PRAGMA DOCUMENTATION
8708
8709 =head2 attrs - set/get attributes of a subroutine (deprecated)
8710
8711 =over 4
8712
8713 =item SYNOPSIS
8714
8715 =item DESCRIPTION
8716
8717 method, locked
8718
8719 =back
8720
8721 =head2 re - Perl pragma to alter regular expression behaviour
8722
8723 =over 4
8724
8725 =item SYNOPSIS
8726
8727 =item DESCRIPTION
8728
8729 =back
8730
8731 =head2 threadshared::shared, threads::shared - Perl extension for sharing
8732 data structures between threads
8733
8734 =over 4
8735
8736 =item SYNOPSIS
8737
8738 =item DESCRIPTION
8739
8740 =item EXPORT
8741
8742 =item FUNCTIONS
8743
8744 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
8745 cond_broadcast VARIABLE
8746
8747 =item NOTES
8748
8749 =item BUGS
8750
8751 =item AUTHOR
8752
8753 =item SEE ALSO
8754
8755 =back
8756
8757 =head2 threads - Perl extension allowing use of interpreter based threads
8758 from perl
8759
8760 =over 4
8761
8762 =item SYNOPSIS
8763
8764 =item DESCRIPTION
8765
8766 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
8767 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
8768 threads->list();, async BLOCK;
8769
8770 =item WARNINGS
8771
8772 A thread exited while %d other threads were still running
8773
8774 =item TODO
8775
8776 =item BUGS
8777
8778 Parent-Child threads, Returning objects, Creating threads inside BEGIN
8779 blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
8780
8781 =item AUTHOR and COPYRIGHT
8782
8783 =item SEE ALSO
8784
8785 =back
8786
8787 =head2 assertions - select assertions in blocks of code
8788
8789 =over 4
8790
8791 =item SYNOPSIS
8792
8793 =item DESCRIPTION
8794
8795 =item SEE ALSO
8796
8797 =item AUTHOR
8798
8799 =item COPYRIGHT AND LICENSE
8800
8801 =back
8802
8803 =head2 assertions::activate - activate assertions
8804
8805 =over 4
8806
8807 =item SYNOPSIS
8808
8809 =item DESCRIPTION
8810
8811 =item SEE ALSO
8812
8813 =item AUTHOR
8814
8815 =item COPYRIGHT AND LICENSE
8816
8817 =back
8818
8819 =head2 attributes - get/set subroutine or variable attributes
8820
8821 =over 4
8822
8823 =item SYNOPSIS
8824
8825 =item DESCRIPTION
8826
8827 =over 4
8828
8829 =item Built-in Attributes
8830
8831 locked, method, lvalue
8832
8833 =item Available Subroutines
8834
8835 get, reftype
8836
8837 =item Package-specific Attribute Handling
8838
8839 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
8840
8841 =item Syntax of Attribute Lists
8842
8843 =back
8844
8845 =item EXPORTS
8846
8847 =over 4
8848
8849 =item Default exports
8850
8851 =item Available exports
8852
8853 =item Export tags defined
8854
8855 =back
8856
8857 =item EXAMPLES
8858
8859 =item SEE ALSO
8860
8861 =back
8862
8863 =head2 autouse - postpone load of modules until a function is used
8864
8865 =over 4
8866
8867 =item SYNOPSIS
8868
8869 =item DESCRIPTION
8870
8871 =item WARNING
8872
8873 =item AUTHOR
8874
8875 =item SEE ALSO
8876
8877 =back
8878
8879 =head2 base - Establish IS-A relationship with base class at compile time
8880
8881 =over 4
8882
8883 =item SYNOPSIS
8884
8885 =item DESCRIPTION
8886
8887 =item HISTORY
8888
8889 =item SEE ALSO
8890
8891 =back
8892
8893 =head2 bigint - Transparent BigInteger support for Perl
8894
8895 =over 4
8896
8897 =item SYNOPSIS
8898
8899 =item DESCRIPTION
8900
8901 =over 4
8902
8903 =item OPTIONS
8904
8905 a or accuracy, p or precision, t or trace, l or lib, v or version
8906
8907 =item MATH LIBRARY
8908
8909 =item INTERNAL FORMAT
8910
8911 =item SIGN
8912
8913 =item METHODS
8914
8915 =item CAVEAT
8916
8917 =back
8918
8919 =item MODULES USED
8920
8921 =item EXAMPLES
8922
8923 =item LICENSE
8924
8925 =item SEE ALSO
8926
8927 =item AUTHORS
8928
8929 =back
8930
8931 =head2 bignum - Transparent BigNumber support for Perl
8932
8933 =over 4
8934
8935 =item SYNOPSIS
8936
8937 =item DESCRIPTION
8938
8939 =over 4
8940
8941 =item OPTIONS
8942
8943 a or accuracy, p or precision, t or trace, l or lib, v or version
8944
8945 =item METHODS
8946
8947 =item CAVEAT
8948
8949 inf(), NaN(), upgrade()
8950
8951 =item MATH LIBRARY
8952
8953 =item INTERNAL FORMAT
8954
8955 =item SIGN
8956
8957 =back
8958
8959 =item MODULES USED
8960
8961 =item EXAMPLES
8962
8963 =item LICENSE
8964
8965 =item SEE ALSO
8966
8967 =item AUTHORS
8968
8969 =back
8970
8971 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
8972
8973 =over 4
8974
8975 =item SYNOPSIS
8976
8977 =item DESCRIPTION
8978
8979 =over 4
8980
8981 =item MODULES USED
8982
8983 =item MATH LIBRARY
8984
8985 =item SIGN
8986
8987 =item METHODS
8988
8989 =item CAVEAT
8990
8991 =back
8992
8993 =item EXAMPLES
8994
8995         perl -Mbigrat -le 'print sqrt(33)'
8996         perl -Mbigrat -le 'print 2*255'
8997         perl -Mbigrat -le 'print 4.5+2*255'
8998         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'       
8999         perl -Mbigrat -le 'print 12->is_odd()';
9000
9001 =item LICENSE
9002
9003 =item SEE ALSO
9004
9005 =item AUTHORS
9006
9007 =back
9008
9009 =head2 blib - Use MakeMaker's uninstalled version of a package
9010
9011 =over 4
9012
9013 =item SYNOPSIS
9014
9015 =item DESCRIPTION
9016
9017 =item BUGS
9018
9019 =item AUTHOR
9020
9021 =back
9022
9023 =head2 bytes - Perl pragma to force byte semantics rather than character
9024 semantics
9025
9026 =over 4
9027
9028 =item SYNOPSIS
9029
9030 =item DESCRIPTION
9031
9032 =item SEE ALSO
9033
9034 =back
9035
9036 =head2 charnames - define character names for C<\N{named}> string literal
9037 escapes
9038
9039 =over 4
9040
9041 =item SYNOPSIS
9042
9043 =item DESCRIPTION
9044
9045 =item CUSTOM TRANSLATORS
9046
9047 =item CUSTOM ALIASES
9048
9049 =over 4
9050
9051 =item Anonymous hashes
9052
9053 =item Alias file
9054
9055 =item Alias shortcut
9056
9057 =back
9058
9059 =item charnames::viacode(code)
9060
9061 =item charnames::vianame(name)
9062
9063 =item ALIASES
9064
9065 =item ILLEGAL CHARACTERS
9066
9067 =item BUGS
9068
9069 =back
9070
9071 =head2 constant - Perl pragma to declare constants
9072
9073 =over 4
9074
9075 =item SYNOPSIS
9076
9077 =item DESCRIPTION
9078
9079 =item NOTES
9080
9081 =over 4
9082
9083 =item List constants
9084
9085 =item Defining multiple constants at once
9086
9087 =item Magic constants
9088
9089 =back
9090
9091 =item TECHNICAL NOTES
9092
9093 =item BUGS
9094
9095 =item AUTHOR
9096
9097 =item COPYRIGHT
9098
9099 =back
9100
9101 =head2 diagnostics - Perl compiler pragma to force verbose warning
9102 diagnostics
9103
9104 =over 4
9105
9106 =item SYNOPSIS
9107
9108 =item DESCRIPTION
9109
9110 =over 4
9111
9112 =item The C<diagnostics> Pragma
9113
9114 =item The I<splain> Program
9115
9116 =back
9117
9118 =item EXAMPLES
9119
9120 =item INTERNALS
9121
9122 =item BUGS
9123
9124 =item AUTHOR
9125
9126 =back
9127
9128 =head2 encoding - allows you to write your script in non-ascii or non-utf8
9129
9130 =over 4
9131
9132 =item SYNOPSIS
9133
9134 =item ABSTRACT
9135
9136 =over 4
9137
9138 =item Literal Conversions
9139
9140 =item PerlIO layers for C<STD(IN|OUT)>
9141
9142 =back
9143
9144 =item FEATURES THAT REQUIRE 5.8.1
9145
9146 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
9147
9148 =item USAGE
9149
9150 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
9151 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
9152
9153 =item The Filter Option
9154
9155 =over 4
9156
9157 =item Filter-related changes at Encode version 1.87
9158
9159 =back
9160
9161 =item CAVEATS
9162
9163 =over 4
9164
9165 =item NOT SCOPED
9166
9167 =item DO NOT MIX MULTIPLE ENCODINGS
9168
9169 =item tr/// with ranges
9170
9171 Legend of characters above
9172
9173 =back
9174
9175 =item EXAMPLE - Greekperl
9176
9177 =item KNOWN PROBLEMS
9178
9179 literals in regex that are longer than 127 bytes, EBCDIC, format
9180
9181 =item HISTORY
9182
9183 =item SEE ALSO
9184
9185 =back
9186
9187 =head2 fields - compile-time class fields
9188
9189 =over 4
9190
9191 =item SYNOPSIS
9192
9193 =item DESCRIPTION
9194
9195 new, phash
9196
9197 =item SEE ALSO
9198
9199 =back
9200
9201 =head2 filetest - Perl pragma to control the filetest permission operators
9202
9203 =over 4
9204
9205 =item SYNOPSIS
9206
9207 =item DESCRIPTION
9208
9209 =over 4
9210
9211 =item subpragma access
9212
9213 =back
9214
9215 =back
9216
9217 =head2 if - C<use> a Perl module if a condition holds
9218
9219 =over 4
9220
9221 =item SYNOPSIS
9222
9223 =item DESCRIPTION
9224
9225 =item BUGS
9226
9227 =item AUTHOR
9228
9229 =back
9230
9231 =head2 integer - Perl pragma to use integer arithmetic instead of floating
9232 point
9233
9234 =over 4
9235
9236 =item SYNOPSIS
9237
9238 =item DESCRIPTION
9239
9240 =back
9241
9242 =head2 less - perl pragma to request less of something from the compiler
9243
9244 =over 4
9245
9246 =item SYNOPSIS
9247
9248 =item DESCRIPTION
9249
9250 =back
9251
9252 =head2 lib - manipulate @INC at compile time
9253
9254 =over 4
9255
9256 =item SYNOPSIS
9257
9258 =item DESCRIPTION
9259
9260 =over 4
9261
9262 =item Adding directories to @INC
9263
9264 =item Deleting directories from @INC
9265
9266 =item Restoring original @INC
9267
9268 =back
9269
9270 =item CAVEATS
9271
9272 =item NOTES
9273
9274 =item SEE ALSO
9275
9276 =item AUTHOR
9277
9278 =back
9279
9280 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
9281 operations
9282
9283 =over 4
9284
9285 =item SYNOPSIS
9286
9287 =item DESCRIPTION
9288
9289 =back
9290
9291 =head2 open - perl pragma to set default PerlIO layers for input and output
9292
9293 =over 4
9294
9295 =item SYNOPSIS
9296
9297 =item DESCRIPTION
9298
9299 =item NONPERLIO FUNCTIONALITY
9300
9301 =item IMPLEMENTATION DETAILS
9302
9303 =item SEE ALSO
9304
9305 =back
9306
9307 =head2 ops - Perl pragma to restrict unsafe operations when compiling
9308
9309 =over 4
9310
9311 =item SYNOPSIS  
9312
9313 =item DESCRIPTION
9314
9315 =item SEE ALSO
9316
9317 =back
9318
9319 =head2 overload - Package for overloading perl operations
9320
9321 =over 4
9322
9323 =item SYNOPSIS
9324
9325 =item DESCRIPTION
9326
9327 =over 4
9328
9329 =item Declaration of overloaded functions
9330
9331 =item Calling Conventions for Binary Operations
9332
9333 FALSE, TRUE, C<undef>
9334
9335 =item Calling Conventions for Unary Operations
9336
9337 =item Calling Conventions for Mutators
9338
9339 C<++> and C<-->, C<x=> and other assignment versions
9340
9341 =item Overloadable Operations
9342
9343 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
9344 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
9345 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
9346
9347 =item Inheritance and overloading
9348
9349 Strings as values of C<use overload> directive, Overloading of an operation
9350 is inherited by derived classes
9351
9352 =back
9353
9354 =item SPECIAL SYMBOLS FOR C<use overload>
9355
9356 =over 4
9357
9358 =item Last Resort
9359
9360 =item Fallback
9361
9362 C<undef>, TRUE, defined, but FALSE
9363
9364 =item Copy Constructor
9365
9366 B<Example>
9367
9368 =back
9369
9370 =item MAGIC AUTOGENERATION
9371
9372 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
9373 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
9374 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
9375 I<Copy operator>
9376
9377 =item Losing overloading
9378
9379 =item Run-time Overloading
9380
9381 =item Public functions
9382
9383 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
9384
9385 =item Overloading constants
9386
9387 integer, float, binary, q, qr
9388
9389 =item IMPLEMENTATION
9390
9391 =item Metaphor clash
9392
9393 =item Cookbook
9394
9395 =over 4
9396
9397 =item Two-face scalars
9398
9399 =item Two-face references
9400
9401 =item Symbolic calculator
9402
9403 =item I<Really> symbolic calculator
9404
9405 =back
9406
9407 =item AUTHOR
9408
9409 =item DIAGNOSTICS
9410
9411 Odd number of arguments for overload::constant, `%s' is not an overloadable
9412 type, `%s' is not a code reference
9413
9414 =item BUGS
9415
9416 =back
9417
9418 =head2 sigtrap - Perl pragma to enable simple signal handling
9419
9420 =over 4
9421
9422 =item SYNOPSIS
9423
9424 =item DESCRIPTION
9425
9426 =item OPTIONS
9427
9428 =over 4
9429
9430 =item SIGNAL HANDLERS
9431
9432 B<stack-trace>, B<die>, B<handler> I<your-handler>
9433
9434 =item SIGNAL LISTS
9435
9436 B<normal-signals>, B<error-signals>, B<old-interface-signals>
9437
9438 =item OTHER
9439
9440 B<untrapped>, B<any>, I<signal>, I<number>
9441
9442 =back
9443
9444 =item EXAMPLES
9445
9446 =back
9447
9448 =head2 sort - perl pragma to control sort() behaviour
9449
9450 =over 4
9451
9452 =item SYNOPSIS
9453
9454 =item DESCRIPTION
9455
9456 =item CAVEATS
9457
9458 =back
9459
9460 =head2 strict - Perl pragma to restrict unsafe constructs
9461
9462 =over 4
9463
9464 =item SYNOPSIS
9465
9466 =item DESCRIPTION
9467
9468 C<strict refs>, C<strict vars>, C<strict subs>
9469
9470 =item HISTORY
9471
9472 =back
9473
9474 =head2 subs - Perl pragma to predeclare sub names
9475
9476 =over 4
9477
9478 =item SYNOPSIS
9479
9480 =item DESCRIPTION
9481
9482 =back
9483
9484 =head2 threadshared, threads::shared - Perl extension for sharing data
9485 structures between threads
9486
9487 =over 4
9488
9489 =item SYNOPSIS
9490
9491 =item DESCRIPTION
9492
9493 =item EXPORT
9494
9495 =item FUNCTIONS
9496
9497 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
9498 cond_broadcast VARIABLE
9499
9500 =item NOTES
9501
9502 =item BUGS
9503
9504 =item AUTHOR
9505
9506 =item SEE ALSO
9507
9508 =back
9509
9510 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
9511 code
9512
9513 =over 4
9514
9515 =item SYNOPSIS
9516
9517 =item DESCRIPTION
9518
9519 =over 4
9520
9521 =item Utility functions
9522
9523 $num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[,
9524 FAIL_OK]), utf8::encode($string), utf8::decode($string), $flag =
9525 utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
9526
9527 =back
9528
9529 =item BUGS
9530
9531 =item SEE ALSO
9532
9533 =back
9534
9535 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
9536
9537 =over 4
9538
9539 =item SYNOPSIS
9540
9541 =item DESCRIPTION
9542
9543 =back
9544
9545 =head2 version - Perl extension for Version Objects
9546
9547 =over 4
9548
9549 =item SYNOPSIS
9550
9551 =item DESCRIPTION
9552
9553 =over 4
9554
9555 =item What IS a version
9556
9557 Numeric Versions, V-String Versions
9558
9559 =item Numeric Versions
9560
9561 =item V-String Versions
9562
9563 =item Object Methods
9564
9565 New Operator, Stringification, Numification, Comparison operators, Logical
9566 Operators
9567
9568 =item Quoting
9569
9570 =item Types of Versions Objects
9571
9572 Ordinary versions, alpha versions
9573
9574 =item Replacement UNIVERSAL::VERSION
9575
9576 =back
9577
9578 =item EXPORT
9579
9580 =item AUTHOR
9581
9582 =item SEE ALSO
9583
9584 =back
9585
9586 =head2 vmsish - Perl pragma to control VMS-specific language features
9587
9588 =over 4
9589
9590 =item SYNOPSIS
9591
9592 =item DESCRIPTION
9593
9594 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
9595
9596 =back
9597
9598 =head2 warnings - Perl pragma to control optional warnings
9599
9600 =over 4
9601
9602 =item SYNOPSIS
9603
9604 =item DESCRIPTION
9605
9606 use warnings::register, warnings::enabled(), warnings::enabled($category),
9607 warnings::enabled($object), warnings::warn($message),
9608 warnings::warn($category, $message), warnings::warn($object, $message),
9609 warnings::warnif($message), warnings::warnif($category, $message),
9610 warnings::warnif($object, $message)
9611
9612 =back
9613
9614 =head2 warnings::register - warnings import function
9615
9616 =over 4
9617
9618 =item SYNOPSIS
9619
9620 =item DESCRIPTION
9621
9622 =back
9623
9624 =head1 MODULE DOCUMENTATION
9625
9626 =head2 AnyDBM_File - provide framework for multiple DBMs
9627
9628 =over 4
9629
9630 =item SYNOPSIS
9631
9632 =item DESCRIPTION
9633
9634 =over 4
9635
9636 =item DBM Comparisons
9637
9638 [0], [1], [2], [3]
9639
9640 =back
9641
9642 =item SEE ALSO
9643
9644 =back
9645
9646 =head2 Attribute::Handlers - Simpler definition of attribute handlers
9647
9648 =over 4
9649
9650 =item VERSION
9651
9652 =item SYNOPSIS
9653
9654 =item DESCRIPTION
9655
9656 [0], [1], [2], [3], [4], [5]
9657
9658 =over 4
9659
9660 =item Typed lexicals
9661
9662 =item Type-specific attribute handlers
9663
9664 =item Non-interpretive attribute handlers
9665
9666 =item Phase-specific attribute handlers
9667
9668 =item Attributes as C<tie> interfaces
9669
9670 =back
9671
9672 =item EXAMPLES
9673
9674 =item DIAGNOSTICS
9675
9676 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
9677 attributes>, C<Declaration of %s attribute in package %s may clash with
9678 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
9679 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
9680 be able to apply END handler>
9681
9682 =item AUTHOR
9683
9684 =item BUGS
9685
9686 =item COPYRIGHT
9687
9688 =back
9689
9690 =head2 AutoLoader - load subroutines only on demand
9691
9692 =over 4
9693
9694 =item SYNOPSIS
9695
9696 =item DESCRIPTION
9697
9698 =over 4
9699
9700 =item Subroutine Stubs
9701
9702 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
9703
9704 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
9705
9706 =item Package Lexicals
9707
9708 =item Not Using AutoLoader
9709
9710 =item B<AutoLoader> vs. B<SelfLoader>
9711
9712 =back
9713
9714 =item CAVEATS
9715
9716 =item SEE ALSO
9717
9718 =back
9719
9720 =head2 AutoSplit - split a package for autoloading
9721
9722 =over 4
9723
9724 =item SYNOPSIS
9725
9726 =item DESCRIPTION
9727
9728 $keep, $check, $modtime
9729
9730 =over 4
9731
9732 =item Multiple packages
9733
9734 =back
9735
9736 =item DIAGNOSTICS
9737
9738 =back
9739
9740 =head2 B - The Perl Compiler
9741
9742 =over 4
9743
9744 =item SYNOPSIS
9745
9746 =item DESCRIPTION
9747
9748 =item OVERVIEW
9749
9750 =item Utility Functions
9751
9752 =over 4
9753
9754 =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV>
9755 objects
9756
9757 sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av,
9758 check_av, begin_av, end_av, comppadlist, regex_padav, main_cv
9759
9760 =item Functions for Examining the Symbol Table
9761
9762 walksymtable(SYMREF, METHOD, RECURSE, PREFIX)
9763
9764 =item Functions Returning C<B::OP> objects or for walking op trees
9765
9766 main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG)
9767
9768 =item Miscellaneous Utility Functions
9769
9770 ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR),
9771 perlstring(STR), class(OBJ), threadsv_names
9772
9773 =back
9774
9775 =item OVERVIEW OF CLASSES
9776
9777 =over 4
9778
9779 =item SV-RELATED CLASSES
9780
9781 =item B::SV Methods
9782
9783 REFCNT, FLAGS, object_2svref
9784
9785 =item B::IV Methods
9786
9787 IV, IVX, UVX, int_value, needs64bits, packiv
9788
9789 =item B::NV Methods
9790
9791 NV, NVX
9792
9793 =item B::RV Methods
9794
9795 RV
9796
9797 =item B::PV Methods
9798
9799 PV, RV, PVX
9800
9801 =item B::PVMG Methods
9802
9803 MAGIC, SvSTASH
9804
9805 =item B::MAGIC Methods
9806
9807 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
9808
9809 =item B::PVLV Methods
9810
9811 TARGOFF, TARGLEN, TYPE, TARG
9812
9813 =item B::BM Methods
9814
9815 USEFUL, PREVIOUS, RARE, TABLE
9816
9817 =item B::GV Methods
9818
9819 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
9820 LINE, FILE, FILEGV, GvREFCNT, FLAGS
9821
9822 =item B::IO Methods
9823
9824 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
9825 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
9826
9827 =item B::AV Methods
9828
9829 FILL, MAX, OFF, ARRAY, ARRAYelt, AvFLAGS
9830
9831 =item B::CV Methods
9832
9833 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB,
9834 XSUBANY, CvFLAGS, const_sv
9835
9836 =item B::HV Methods
9837
9838 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
9839
9840 =item OP-RELATED CLASSES
9841
9842 =item B::OP Methods
9843
9844 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
9845
9846 =item B::UNOP METHOD
9847
9848 first
9849
9850 =item B::BINOP METHOD
9851
9852 last
9853
9854 =item B::LOGOP METHOD
9855
9856 other
9857
9858 =item B::LISTOP METHOD
9859
9860 children
9861
9862 =item B::PMOP Methods
9863
9864 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
9865 pmpermflags, precomp, pmoffset
9866
9867 =item B::SVOP METHOD
9868
9869 sv, gv
9870
9871 =item B::PADOP METHOD
9872
9873 padix
9874
9875 =item B::PVOP METHOD
9876
9877 pv
9878
9879 =item B::LOOP Methods
9880
9881 redoop, nextop, lastop
9882
9883 =item B::COP Methods
9884
9885 label, stash, stashpv, file, cop_seq, arybase, line, warnings, io
9886
9887 =back
9888
9889 =item AUTHOR
9890
9891 =back
9892
9893 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
9894 bytecode
9895
9896 =over 4
9897
9898 =item SYNOPSIS
9899
9900 =item DESCRIPTION
9901
9902 %insn_data, @insn_name, @optype, @specialsv_name
9903
9904 =item AUTHOR
9905
9906 =back
9907
9908 =head2 B::Assembler - Assemble Perl bytecode
9909
9910 =over 4
9911
9912 =item SYNOPSIS
9913
9914 =item DESCRIPTION
9915
9916 =item AUTHORS
9917
9918 =back
9919
9920 =head2 B::Bblock - Walk basic blocks
9921
9922 =over 4
9923
9924 =item SYNOPSIS
9925
9926 =item DESCRIPTION
9927
9928 =over 4
9929
9930 =item Functions
9931
9932 B<find_leaders>
9933
9934 =back
9935
9936 =item AUTHOR
9937
9938 =back
9939
9940 =head2 B::Bytecode - Perl compiler's bytecode backend
9941
9942 =over 4
9943
9944 =item SYNOPSIS
9945
9946 =item DESCRIPTION
9947
9948 =item EXAMPLE
9949
9950 =item OPTIONS
9951
9952 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
9953
9954 =item KNOWN BUGS
9955
9956 =item NOTICE
9957
9958 =item AUTHORS
9959
9960 =back
9961
9962 =head2 B::C - Perl compiler's C backend
9963
9964 =over 4
9965
9966 =item SYNOPSIS
9967
9968 =item DESCRIPTION
9969
9970 =item OPTIONS
9971
9972 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
9973 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
9974 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
9975 B<-llimit>
9976
9977 =item EXAMPLES
9978
9979 =item BUGS
9980
9981 =item AUTHOR
9982
9983 =back
9984
9985 =head2 B::CC - Perl compiler's optimized C translation backend
9986
9987 =over 4
9988
9989 =item SYNOPSIS
9990
9991 =item DESCRIPTION
9992
9993 =item OPTIONS
9994
9995 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
9996 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
9997 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
9998
9999 =item EXAMPLES
10000
10001 =item BUGS
10002
10003 =item DIFFERENCES
10004
10005 =over 4
10006
10007 =item Loops
10008
10009 =item Context of ".."
10010
10011 =item Arithmetic
10012
10013 =item Deprecated features
10014
10015 =back
10016
10017 =item AUTHOR
10018
10019 =back
10020
10021 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
10022
10023 =over 4
10024
10025 =item SYNOPSIS
10026
10027 =item DESCRIPTION
10028
10029 =item EXAMPLE
10030
10031 =item OPTIONS
10032
10033 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
10034 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
10035 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
10036
10037 =item FORMATTING SPECIFICATIONS
10038
10039 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
10040 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
10041 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
10042 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
10043 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
10044 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
10045 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
10046 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
10047
10048 =item ABBREVIATIONS
10049
10050 =over 4
10051
10052 =item OP flags abbreviations
10053
10054 =item OP class abbreviations
10055
10056 =back
10057
10058 =item Using B::Concise outside of the O framework
10059
10060 =item AUTHOR
10061
10062 =back
10063
10064 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
10065
10066 =over 4
10067
10068 =item SYNOPSIS
10069
10070 =item DESCRIPTION
10071
10072 =item AUTHOR
10073
10074 =back
10075
10076 =head2 B::Deparse - Perl compiler backend to produce perl code
10077
10078 =over 4
10079
10080 =item SYNOPSIS
10081
10082 =item DESCRIPTION
10083
10084 =item OPTIONS
10085
10086 B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>,
10087 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
10088
10089 =item USING B::Deparse AS A MODULE
10090
10091 =over 4
10092
10093 =item Synopsis
10094
10095 =item Description
10096
10097 =item new
10098
10099 =item ambient_pragmas
10100
10101 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
10102
10103 =item coderef2text
10104
10105 =back
10106
10107 =item BUGS
10108
10109 =item AUTHOR
10110
10111 =back
10112
10113 =head2 B::Disassembler - Disassemble Perl bytecode
10114
10115 =over 4
10116
10117 =item SYNOPSIS
10118
10119 =item DESCRIPTION
10120
10121 =item AUTHOR
10122
10123 =back
10124
10125 =head2 B::Lint - Perl lint
10126
10127 =over 4
10128
10129 =item SYNOPSIS
10130
10131 =item DESCRIPTION
10132
10133 =item OPTIONS AND LINT CHECKS
10134
10135 B<context>, B<implicit-read> and B<implicit-write>, B<bare-subs>,
10136 B<dollar-underscore>, B<private-names>, B<undefined-subs>,
10137 B<regexp-variables>, B<all>, B<none>
10138
10139 =item NON LINT-CHECK OPTIONS
10140
10141 B<-u Package>
10142
10143 =item BUGS
10144
10145 =item AUTHOR
10146
10147 =back
10148
10149 =head2 B::O, O - Generic interface to Perl Compiler backends
10150
10151 =over 4
10152
10153 =item SYNOPSIS
10154
10155 =item DESCRIPTION
10156
10157 =item CONVENTIONS
10158
10159 =item IMPLEMENTATION
10160
10161 =item BUGS
10162
10163 =item AUTHOR
10164
10165 =back
10166
10167 =head2 B::Showlex - Show lexical variables used in functions or files
10168
10169 =over 4
10170
10171 =item SYNOPSIS
10172
10173 =item DESCRIPTION
10174
10175 =item AUTHOR
10176
10177 =back
10178
10179 =head2 B::Stackobj - Helper module for CC backend
10180
10181 =over 4
10182
10183 =item SYNOPSIS
10184
10185 =item DESCRIPTION
10186
10187 =item AUTHOR
10188
10189 =back
10190
10191 =head2 B::Stash - show what stashes are loaded
10192
10193 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
10194
10195 =over 4
10196
10197 =item SYNOPSIS
10198
10199 =item DESCRIPTION
10200
10201 =item AUTHOR
10202
10203 =back
10204
10205 =head2 B::Xref - Generates cross reference reports for Perl programs
10206
10207 =over 4
10208
10209 =item SYNOPSIS
10210
10211 =item DESCRIPTION
10212
10213 =item OPTIONS
10214
10215 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
10216
10217 =item BUGS
10218
10219 =item AUTHOR
10220
10221 =back
10222
10223 =head2 Bblock, B::Bblock - Walk basic blocks
10224
10225 =over 4
10226
10227 =item SYNOPSIS
10228
10229 =item DESCRIPTION
10230
10231 =over 4
10232
10233 =item Functions
10234
10235 B<find_leaders>
10236
10237 =back
10238
10239 =item AUTHOR
10240
10241 =back
10242
10243 =head2 Benchmark - benchmark running times of Perl code
10244
10245 =over 4
10246
10247 =item SYNOPSIS
10248
10249 =item DESCRIPTION
10250
10251 =over 4
10252
10253 =item Methods
10254
10255 new, debug, iters
10256
10257 =item Standard Exports
10258
10259 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
10260 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
10261 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
10262
10263 =item Optional Exports
10264
10265 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [
10266 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
10267 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
10268
10269 =item :hireswallclock
10270
10271 =back
10272
10273 =item NOTES
10274
10275 =item EXAMPLES
10276
10277 =item INHERITANCE
10278
10279 =item CAVEATS
10280
10281 =item SEE ALSO
10282
10283 =item AUTHORS
10284
10285 =item MODIFICATION HISTORY
10286
10287 =back
10288
10289 =head2 ByteLoader - load byte compiled perl code
10290
10291 =over 4
10292
10293 =item SYNOPSIS
10294
10295 =item DESCRIPTION
10296
10297 =item AUTHOR
10298
10299 =item SEE ALSO
10300
10301 =back
10302
10303 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
10304
10305 =over 4
10306
10307 =item SYNOPSIS
10308
10309 =item DESCRIPTION
10310
10311 =item EXAMPLE
10312
10313 =item OPTIONS
10314
10315 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
10316
10317 =item KNOWN BUGS
10318
10319 =item NOTICE
10320
10321 =item AUTHORS
10322
10323 =back
10324
10325 =head2 CGI - Simple Common Gateway Interface Class
10326
10327 =over 4
10328
10329 =item SYNOPSIS
10330
10331 =item ABSTRACT
10332
10333 =item DESCRIPTION
10334
10335 =over 4
10336
10337 =item PROGRAMMING STYLE
10338
10339 =item CALLING CGI.PM ROUTINES
10340
10341 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
10342
10343 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
10344
10345 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
10346
10347 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
10348
10349 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
10350
10351 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
10352
10353 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
10354
10355 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
10356
10357 =item DELETING A PARAMETER COMPLETELY:
10358
10359 =item DELETING ALL PARAMETERS:
10360
10361 =item DIRECT ACCESS TO THE PARAMETER LIST:
10362
10363 =item FETCHING THE PARAMETER LIST AS A HASH:
10364
10365 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
10366
10367 =item RETRIEVING CGI ERRORS
10368
10369 =item USING THE FUNCTION-ORIENTED INTERFACE
10370
10371 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
10372 B<:standard>, B<:all>
10373
10374 =item PRAGMAS
10375
10376 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
10377 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
10378 -private_tempfiles
10379
10380 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
10381
10382 1. start_table() (generates a <table> tag), 2. end_table() (generates a
10383 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
10384 a </ul> tag)
10385
10386 =back
10387
10388 =item GENERATING DYNAMIC DOCUMENTS
10389
10390 =over 4
10391
10392 =item CREATING A STANDARD HTTP HEADER:
10393
10394 =item GENERATING A REDIRECTION HEADER
10395
10396 =item CREATING THE HTML DOCUMENT HEADER
10397
10398 B<Parameters:>, 4, 5, 6..
10399
10400 =item ENDING THE HTML DOCUMENT:
10401
10402 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
10403
10404 =item OBTAINING THE SCRIPT'S URL
10405
10406 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
10407 (B<-query_string>), B<-base>
10408
10409 =item MIXING POST AND URL PARAMETERS
10410
10411 =back
10412
10413 =item CREATING STANDARD HTML ELEMENTS:
10414
10415 =over 4
10416
10417 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
10418
10419 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
10420
10421 =item HTML SHORTCUTS AND LIST INTERPOLATION
10422
10423 =item NON-STANDARD HTML SHORTCUTS
10424
10425 =item AUTOESCAPING HTML
10426
10427 $escaped_string = escapeHTML("unescaped string");, $charset =
10428 charset([$charset]);, $flag = autoEscape([$flag]);
10429
10430 =item PRETTY-PRINTING HTML
10431
10432 =back
10433
10434 =item CREATING FILL-OUT FORMS:
10435
10436 =over 4
10437
10438 =item CREATING AN ISINDEX TAG
10439
10440 =item STARTING AND ENDING A FORM
10441
10442 B<application/x-www-form-urlencoded>, B<multipart/form-data>
10443
10444 =item CREATING A TEXT FIELD
10445
10446 B<Parameters>
10447
10448 =item CREATING A BIG TEXT FIELD
10449
10450 =item CREATING A PASSWORD FIELD
10451
10452 =item CREATING A FILE UPLOAD FIELD
10453
10454 B<Parameters>
10455
10456 =item CREATING A POPUP MENU
10457
10458 =item CREATING AN OPTION GROUP
10459
10460 =item CREATING A SCROLLING LIST
10461
10462 B<Parameters:>
10463
10464 =item CREATING A GROUP OF RELATED CHECKBOXES
10465
10466 B<Parameters:>
10467
10468 =item CREATING A STANDALONE CHECKBOX
10469
10470 B<Parameters:>
10471
10472 =item CREATING A RADIO BUTTON GROUP
10473
10474 B<Parameters:>
10475
10476 =item CREATING A SUBMIT BUTTON 
10477
10478 B<Parameters:>
10479
10480 =item CREATING A RESET BUTTON
10481
10482 =item CREATING A DEFAULT BUTTON
10483
10484 =item CREATING A HIDDEN FIELD
10485
10486 B<Parameters:>
10487
10488 =item CREATING A CLICKABLE IMAGE BUTTON
10489
10490 B<Parameters:>, 3. The third option (-align, optional) is an alignment
10491 type, and may be TOP, BOTTOM or MIDDLE
10492
10493 =item CREATING A JAVASCRIPT ACTION BUTTON
10494
10495 =back
10496
10497 =item HTTP COOKIES
10498
10499 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
10500 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
10501
10502 =item WORKING WITH FRAMES
10503
10504 1. Create a <Frameset> document, 2. Specify the destination for the
10505 document in the HTTP header, 3. Specify the destination for the document in
10506 the <form> tag
10507
10508 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
10509
10510 =item DEBUGGING
10511
10512 =over 4
10513
10514 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
10515
10516 =back
10517
10518 =item FETCHING ENVIRONMENT VARIABLES
10519
10520 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
10521 B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
10522 name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
10523 ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
10524 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
10525 B<request_method()>, B<content_type()>, B<http()>, B<https()>
10526
10527 =item USING NPH SCRIPTS
10528
10529 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
10530 parameters
10531
10532 =item Server Push
10533
10534 multipart_init(), multipart_start(), multipart_end(), multipart_final()
10535
10536 =item Avoiding Denial of Service Attacks
10537
10538 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
10539 basis>, B<2. Globally for all scripts>
10540
10541 =item COMPATIBILITY WITH CGI-LIB.PL
10542
10543 =item AUTHOR INFORMATION
10544
10545 =item CREDITS
10546
10547 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
10548 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
10549 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
10550 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
10551 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
10552 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
10553 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
10554 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
10555 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
10556 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
10557 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
10558 ...and many many more..
10559
10560 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
10561
10562 =item BUGS
10563
10564 =item SEE ALSO
10565
10566 =back
10567
10568 =head2 CGI::Apache - Backward compatibility module for CGI.pm
10569
10570 =over 4
10571
10572 =item SYNOPSIS
10573
10574 =item ABSTRACT
10575
10576 =item DESCRIPTION
10577
10578 =item AUTHOR INFORMATION
10579
10580 =item BUGS
10581
10582 =item SEE ALSO
10583
10584 =back
10585
10586 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
10587 other) error log
10588
10589 =over 4
10590
10591 =item SYNOPSIS
10592
10593 =item DESCRIPTION
10594
10595 =item REDIRECTING ERROR MESSAGES
10596
10597 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
10598
10599 =over 4
10600
10601 =item Changing the default message
10602
10603 =back
10604
10605 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
10606
10607 =item OVERRIDING THE NAME OF THE PROGRAM
10608
10609 =item AUTHORS
10610
10611 =item SEE ALSO
10612
10613 =back
10614
10615 =head2 CGI::Cookie - Interface to Netscape Cookies
10616
10617 =over 4
10618
10619 =item SYNOPSIS
10620
10621 =item DESCRIPTION
10622
10623 =item USING CGI::Cookie
10624
10625 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
10626
10627 =over 4
10628
10629 =item Creating New Cookies
10630
10631 =item Sending the Cookie to the Browser
10632
10633 =item Recovering Previous Cookies
10634
10635 =item Manipulating Cookies
10636
10637 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
10638
10639 =back
10640
10641 =item AUTHOR INFORMATION
10642
10643 =item BUGS
10644
10645 =item SEE ALSO
10646
10647 =back
10648
10649 =head2 CGI::Fast - CGI Interface for Fast CGI
10650
10651 =over 4
10652
10653 =item SYNOPSIS
10654
10655 =item DESCRIPTION
10656
10657 =item OTHER PIECES OF THE PUZZLE
10658
10659 =item WRITING FASTCGI PERL SCRIPTS
10660
10661 =item INSTALLING FASTCGI SCRIPTS
10662
10663 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
10664
10665 =item EXTERNAL FASTCGI SERVER INVOCATION
10666
10667 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
10668
10669 =item CAVEATS
10670
10671 =item AUTHOR INFORMATION
10672
10673 =item BUGS
10674
10675 =item SEE ALSO
10676
10677 =back
10678
10679 =head2 CGI::Pretty - module to produce nicely formatted HTML code
10680
10681 =over 4
10682
10683 =item SYNOPSIS
10684
10685 =item DESCRIPTION
10686
10687 =over 4
10688
10689 =item Tags that won't be formatted
10690
10691 =item Customizing the Indenting
10692
10693 =back
10694
10695 =item BUGS
10696
10697 =item AUTHOR
10698
10699 =item SEE ALSO
10700
10701 =back
10702
10703 =head2 CGI::Push - Simple Interface to Server Push
10704
10705 =over 4
10706
10707 =item SYNOPSIS
10708
10709 =item DESCRIPTION
10710
10711 =item USING CGI::Push
10712
10713 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
10714
10715 =over 4
10716
10717 =item Heterogeneous Pages
10718
10719 =item Changing the Page Delay on the Fly
10720
10721 =back
10722
10723 =item INSTALLING CGI::Push SCRIPTS
10724
10725 =item AUTHOR INFORMATION
10726
10727 =item BUGS
10728
10729 =item SEE ALSO
10730
10731 =back
10732
10733 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
10734
10735 =over 4
10736
10737 =item SYNOPSIS
10738
10739 =item ABSTRACT
10740
10741 =item DESCRIPTION
10742
10743 =item AUTHOR INFORMATION
10744
10745 =item BUGS
10746
10747 =item SEE ALSO
10748
10749 =back
10750
10751 =head2 CGI::Util - Internal utilities used by CGI module
10752
10753 =over 4
10754
10755 =item SYNOPSIS
10756
10757 =item DESCRIPTION
10758
10759 =item AUTHOR INFORMATION
10760
10761 =item SEE ALSO
10762
10763 =back
10764
10765 =head2 CPAN - query, download and build perl modules from CPAN sites
10766
10767 =over 4
10768
10769 =item SYNOPSIS
10770
10771 =item STATUS
10772
10773 =item DESCRIPTION
10774
10775 =over 4
10776
10777 =item Interactive Mode
10778
10779 Searching for authors, bundles, distribution files and modules, make, test,
10780 install, clean  modules or distributions, get, readme, look module or
10781 distribution, ls author, Signals
10782
10783 =item CPAN::Shell
10784
10785 =item autobundle
10786
10787 =item recompile
10788
10789 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
10790
10791 =item Programmer's interface
10792
10793 expand($type,@things), expandany(@things), Programming Examples
10794
10795 =item Methods in the other Classes
10796
10797 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
10798 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
10799 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
10800 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
10801 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
10802 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
10803 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
10804 CPAN::Bundle::readme(), CPAN::Bundle::test(),
10805 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
10806 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
10807 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
10808 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
10809 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
10810 CPAN::Distribution::look(), CPAN::Distribution::make(),
10811 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
10812 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
10813 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
10814 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
10815 CPAN::Module::clean(), CPAN::Module::cpan_file(),
10816 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
10817 CPAN::Module::description(), CPAN::Module::force($method,@args),
10818 CPAN::Module::get(), CPAN::Module::inst_file(),
10819 CPAN::Module::inst_version(), CPAN::Module::install(),
10820 CPAN::Module::look(), CPAN::Module::make(),
10821 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
10822 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
10823
10824 =item Cache Manager
10825
10826 =item Bundles
10827
10828 =item Prerequisites
10829
10830 =item Finding packages and VERSION
10831
10832 =item Debugging
10833
10834 =item Floppy, Zip, Offline Mode
10835
10836 =back
10837
10838 =item CONFIGURATION
10839
10840 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
10841 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
10842 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
10843 [unshift|push|splice] E<lt>listE<gt>>
10844
10845 =over 4
10846
10847 =item Note on urllist parameter's format
10848
10849 =item urllist parameter has CD-ROM support
10850
10851 =back
10852
10853 =item SECURITY
10854
10855 =item EXPORT
10856
10857 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
10858
10859 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
10860
10861 =over 4
10862
10863 =item Three basic types of firewalls
10864
10865 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
10866
10867 =item Configuring lynx or ncftp for going through a firewall
10868
10869 =back
10870
10871 =item FAQ
10872
10873 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
10874
10875 =item BUGS
10876
10877 =item AUTHOR
10878
10879 =item TRANSLATIONS
10880
10881 =item SEE ALSO
10882
10883 =back
10884
10885 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
10886
10887 =over 4
10888
10889 =item SYNOPSIS
10890
10891 =item DESCRIPTION
10892
10893 =back
10894
10895 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
10896 module
10897
10898 =over 4
10899
10900 =item SYNOPSIS
10901
10902 =item DESCRIPTION
10903
10904 =item  SEE ALSO
10905
10906 =back
10907
10908 =head2 Carp, carp    - warn of errors (from perspective of caller)
10909
10910 =over 4
10911
10912 =item SYNOPSIS
10913
10914 =item DESCRIPTION
10915
10916 =over 4
10917
10918 =item Forcing a Stack Trace
10919
10920 =back
10921
10922 =item BUGS
10923
10924 =back
10925
10926 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
10927
10928 =head2 Class::ISA -- report the search path for a class's ISA tree
10929
10930 =over 4
10931
10932 =item SYNOPSIS
10933
10934 =item DESCRIPTION
10935
10936 =item FUNCTIONS
10937
10938 the function Class::ISA::super_path($CLASS), the function
10939 Class::ISA::self_and_super_path($CLASS), the function
10940 Class::ISA::self_and_super_versions($CLASS)
10941
10942 =item CAUTIONARY NOTES
10943
10944 =item COPYRIGHT
10945
10946 =item AUTHOR
10947
10948 =back
10949
10950 =head2 Class::Struct - declare struct-like datatypes as Perl classes
10951
10952 =over 4
10953
10954 =item SYNOPSIS
10955
10956 =item DESCRIPTION
10957
10958 =over 4
10959
10960 =item The C<struct()> function
10961
10962 =item Class Creation at Compile Time
10963
10964 =item Element Types and Accessor Methods
10965
10966 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
10967 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
10968
10969 =item Initializing with C<new>
10970
10971 =back
10972
10973 =item EXAMPLES
10974
10975 Example 1, Example 2, Example 3
10976
10977 =item Author and Modification History
10978
10979 =back
10980
10981 =head2 Config - access Perl configuration information
10982
10983 =over 4
10984
10985 =item SYNOPSIS
10986
10987 =item DESCRIPTION
10988
10989 myconfig(), config_sh(), config_re($regex), config_vars(@names)
10990
10991 =item EXAMPLE
10992
10993 =item WARNING
10994
10995 =item GLOSSARY
10996
10997 =over 4
10998
10999 =item _
11000
11001 C<_a>, C<_exe>, C<_o>
11002
11003 =item a
11004
11005 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
11006 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
11007 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
11008 C<asctime_r_proto>, C<awk>
11009
11010 =item b
11011
11012 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
11013
11014 =item c
11015
11016 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
11017 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
11018 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
11019 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
11020 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
11021 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
11022 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
11023
11024 =item d
11025
11026 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>,
11027 C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>,
11028 C<d_bcmp>, C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>,
11029 C<d_bzero>, C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>,
11030 C<d_chroot>, C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>,
11031 C<d_const>, C<d_copysignl>, C<d_crypt>, C<d_crypt_r>, C<d_csh>,
11032 C<d_ctermid_r>, C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>,
11033 C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>, C<d_dirnamlen>, C<d_dlerror>,
11034 C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, C<d_drand48_r>, C<d_drand48proto>,
11035 C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endgrent_r>, C<d_endhent>,
11036 C<d_endhostent_r>, C<d_endnent>, C<d_endnetent_r>, C<d_endpent>,
11037 C<d_endprotoent_r>, C<d_endpwent>, C<d_endpwent_r>, C<d_endsent>,
11038 C<d_endservent_r>, C<d_eofnblk>, C<d_eunice>, C<d_faststdio>, C<d_fchdir>,
11039 C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>,
11040 C<d_fd_set>, C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>,
11041 C<d_flexfnam>, C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>,
11042 C<d_fpathconf>, C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>,
11043 C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>,
11044 C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>, C<d_ftime>,
11045 C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>,
11046 C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>,
11047 C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
11048 C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>,
11049 C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>,
11050 C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>,
11051 C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>,
11052 C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
11053 C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
11054 C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>,
11055 C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
11056 C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>,
11057 C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>,
11058 C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>,
11059 C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
11060 C<d_htonl>, C<d_ilogbl>, C<d_index>, C<d_inetaton>, C<d_int64_t>,
11061 C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>,
11062 C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>,
11063 C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>,
11064 C<d_lstat>, C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>,
11065 C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>,
11066 C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>,
11067 C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>,
11068 C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>,
11069 C<d_msg_peek>, C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>,
11070 C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>,
11071 C<d_nice>, C<d_nl_langinfo>, C<d_nv_preserves_uv>, C<d_off64_t>,
11072 C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
11073 C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
11074 C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
11075 C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
11076 C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>,
11077 C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, C<d_pthread_atfork>,
11078 C<d_pthread_attr_setscope>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
11079 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
11080 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
11081 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
11082 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
11083 C<d_sanemcmp>, C<d_sbrkproto>, C<d_scalbnl>, C<d_sched_yield>,
11084 C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>,
11085 C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>,
11086 C<d_semop>, C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>,
11087 C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>,
11088 C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>,
11089 C<d_setnent>, C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>,
11090 C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>,
11091 C<d_setpwent>, C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>,
11092 C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>,
11093 C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>,
11094 C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>,
11095 C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>,
11096 C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>,
11097 C<d_socks5_init>, C<d_sqrtl>, C<d_srand48_r>, C<d_srandom_r>,
11098 C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>,
11099 C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
11100 C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>,
11101 C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>,
11102 C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strerror_r>,
11103 C<d_strftime>, C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>,
11104 C<d_strtoq>, C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>,
11105 C<d_suidsafe>, C<d_symlink>, C<d_syscall>, C<d_syscallproto>, C<d_sysconf>,
11106 C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>,
11107 C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>,
11108 C<d_tm_tm_gmtoff>, C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>,
11109 C<d_ttyname_r>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>,
11110 C<d_uname>, C<d_union_semun>, C<d_unordered>, C<d_usleep>,
11111 C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>,
11112 C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>, C<d_void_closedir>,
11113 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
11114 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
11115 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
11116 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
11117 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
11118
11119 =item e
11120
11121 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
11122 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
11123 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
11124 C<expr>, C<extensions>, C<extras>
11125
11126 =item f
11127
11128 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
11129 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
11130 C<full_sed>
11131
11132 =item g
11133
11134 C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>,
11135 C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>,
11136 C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>,
11137 C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>,
11138 C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>,
11139 C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>,
11140 C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>,
11141 C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>,
11142 C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>,
11143 C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
11144
11145 =item h
11146
11147 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>,
11148 C<html3dir>, C<html3direxp>
11149
11150 =item i
11151
11152 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
11153 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
11154 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
11155 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
11156 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
11157 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
11158 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
11159 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
11160 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
11161 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
11162 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
11163 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
11164 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
11165 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
11166 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
11167 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
11168 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
11169 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
11170 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installhtml1dir>,
11171 C<installhtml3dir>, C<installman1dir>, C<installman3dir>, C<installprefix>,
11172 C<installprefixexp>, C<installprivlib>, C<installscript>,
11173 C<installsitearch>, C<installsitebin>, C<installsitehtml1dir>,
11174 C<installsitehtml3dir>, C<installsitelib>, C<installsiteman1dir>,
11175 C<installsiteman3dir>, C<installsitescript>, C<installstyle>,
11176 C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>,
11177 C<installvendorhtml1dir>, C<installvendorhtml3dir>, C<installvendorlib>,
11178 C<installvendorman1dir>, C<installvendorman3dir>, C<installvendorscript>,
11179 C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
11180
11181 =item k
11182
11183 C<known_extensions>, C<ksh>
11184
11185 =item l
11186
11187 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
11188 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
11189 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
11190 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
11191 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
11192 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
11193 C<lseektype>
11194
11195 =item m
11196
11197 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
11198 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
11199 C<man3direxp>, C<man3ext>
11200
11201 =item M
11202
11203 C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>,
11204 C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>,
11205 C<myuname>
11206
11207 =item n
11208
11209 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
11210 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
11211 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
11212 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
11213 C<nvsize>, C<nvtype>
11214
11215 =item o
11216
11217 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
11218 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
11219
11220 =item p
11221
11222 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
11223 C<perl>, C<perl_patchlevel>
11224
11225 =item P
11226
11227 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
11228 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
11229 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
11230 C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
11231
11232 =item q
11233
11234 C<quadkind>, C<quadtype>
11235
11236 =item r
11237
11238 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
11239 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
11240 C<rmail>, C<run>, C<runnm>
11241
11242 =item s
11243
11244 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
11245 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
11246 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
11247 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
11248 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
11249 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
11250 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
11251 C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>,
11252 C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>,
11253 C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>,
11254 C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>,
11255 C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>,
11256 C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>,
11257 C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>,
11258 C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>,
11259 C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>,
11260 C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>,
11261 C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>,
11262 C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>,
11263 C<submit>, C<subversion>, C<sysman>
11264
11265 =item t
11266
11267 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
11268 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
11269 C<ttyname_r_proto>
11270
11271 =item u
11272
11273 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
11274 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
11275 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
11276 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>,
11277 C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemorebits>,
11278 C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>,
11279 C<useposix>, C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>,
11280 C<usethreads>, C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>,
11281 C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>,
11282 C<uvXUformat>
11283
11284 =item v
11285
11286 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
11287 C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>,
11288 C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>,
11289 C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>,
11290 C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>,
11291 C<vendorscriptexp>, C<version>, C<version_patchlevel_string>,
11292 C<versiononly>, C<vi>, C<voidflags>
11293
11294 =item x
11295
11296 C<xlibpth>, C<xs_apiversion>
11297
11298 =item y
11299
11300 C<yacc>, C<yaccflags>
11301
11302 =item z
11303
11304 C<zcat>, C<zip>
11305
11306 =back
11307
11308 =item NOTE
11309
11310 =back
11311
11312 =head2 Cwd - get pathname of current working directory
11313
11314 =over 4
11315
11316 =item SYNOPSIS
11317
11318 =item DESCRIPTION
11319
11320 =over 4
11321
11322 =item getcwd and friends
11323
11324 getcwd, cwd, fastcwd, fastgetcwd
11325
11326 =item abs_path and friends
11327
11328 abs_path, realpath, fast_abs_path
11329
11330 =item $ENV{PWD}
11331
11332 =back
11333
11334 =item NOTES
11335
11336 =item SEE ALSO
11337
11338 =back
11339
11340 =head2 DB - programmatic interface to the Perl debugging API (draft,
11341 subject to
11342 change)
11343
11344 =over 4
11345
11346 =item SYNOPSIS
11347
11348 =item DESCRIPTION
11349
11350 =over 4
11351
11352 =item Global Variables
11353
11354  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args, 
11355 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname, 
11356 $DB::lineno
11357
11358 =item API Methods
11359
11360 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
11361 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
11362
11363 =item Client Callback Methods
11364
11365 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
11366 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
11367 CLIENT->output(LIST)
11368
11369 =back
11370
11371 =item BUGS
11372
11373 =item AUTHOR
11374
11375 =back
11376
11377 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
11378
11379 =over 4
11380
11381 =item SYNOPSIS
11382
11383 =item DESCRIPTION
11384
11385 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
11386
11387 =over 4
11388
11389 =item Using DB_File with Berkeley DB version 2 or greater
11390
11391 =item Interface to Berkeley DB
11392
11393 =item Opening a Berkeley DB Database File
11394
11395 =item Default Parameters
11396
11397 =item In Memory Databases
11398
11399 =back
11400
11401 =item DB_HASH
11402
11403 =over 4
11404
11405 =item A Simple Example
11406
11407 =back
11408
11409 =item DB_BTREE
11410
11411 =over 4
11412
11413 =item Changing the BTREE sort order
11414
11415 =item Handling Duplicate Keys 
11416
11417 =item The get_dup() Method
11418
11419 =item The find_dup() Method
11420
11421 =item The del_dup() Method
11422
11423 =item Matching Partial Keys 
11424
11425 =back
11426
11427 =item DB_RECNO
11428
11429 =over 4
11430
11431 =item The 'bval' Option
11432
11433 =item A Simple Example
11434
11435 =item Extra RECNO Methods
11436
11437 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
11438 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
11439 length, elements);>
11440
11441 =item Another Example
11442
11443 =back
11444
11445 =item THE API INTERFACE
11446
11447 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
11448 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
11449 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
11450 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
11451
11452 =item DBM FILTERS
11453
11454 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
11455 B<filter_fetch_value>
11456
11457 =over 4
11458
11459 =item The Filter
11460
11461 =item An Example -- the NULL termination problem.
11462
11463 =item Another Example -- Key is a C int.
11464
11465 =back
11466
11467 =item HINTS AND TIPS 
11468
11469 =over 4
11470
11471 =item Locking: The Trouble with fd
11472
11473 =item Safe ways to lock a database
11474
11475 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
11476
11477 =item Sharing Databases With C Applications
11478
11479 =item The untie() Gotcha
11480
11481 =back
11482
11483 =item COMMON QUESTIONS
11484
11485 =over 4
11486
11487 =item Why is there Perl source in my database?
11488
11489 =item How do I store complex data structures with DB_File?
11490
11491 =item What does "Invalid Argument" mean?
11492
11493 =item What does "Bareword 'DB_File' not allowed" mean? 
11494
11495 =back
11496
11497 =item REFERENCES
11498
11499 =item HISTORY
11500
11501 =item BUGS
11502
11503 =item AVAILABILITY
11504
11505 =item COPYRIGHT
11506
11507 =item SEE ALSO
11508
11509 =item AUTHOR
11510
11511 =back
11512
11513 =head2 Data::Dumper - stringified perl data structures, suitable for both
11514 printing and C<eval>
11515
11516 =over 4
11517
11518 =item SYNOPSIS
11519
11520 =item DESCRIPTION
11521
11522 =over 4
11523
11524 =item Methods
11525
11526 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or> 
11527 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
11528 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
11529 I<$OBJ>->Reset
11530
11531 =item Functions
11532
11533 Dumper(I<LIST>)
11534
11535 =item Configuration Variables or Methods
11536
11537 =item Exports
11538
11539 Dumper
11540
11541 =back
11542
11543 =item EXAMPLES
11544
11545 =item BUGS
11546
11547 =over 4
11548
11549 =item NOTE
11550
11551 =back
11552
11553 =item AUTHOR
11554
11555 =item VERSION
11556
11557 =item SEE ALSO
11558
11559 =back
11560
11561 =head2 Devel::DProf - a Perl code profiler
11562
11563 =over 4
11564
11565 =item SYNOPSIS
11566
11567 =item DESCRIPTION
11568
11569 =item PROFILE FORMAT
11570
11571 =item AUTOLOAD
11572
11573 =item ENVIRONMENT
11574
11575 =item BUGS
11576
11577 =item SEE ALSO
11578
11579 =back
11580
11581 =head2 Devel::PPPort - Perl/Pollution/Portability
11582
11583 =over 4
11584
11585 =item SYNOPSIS
11586
11587 =item DESCRIPTION
11588
11589 =over 4
11590
11591 =item WriteFile
11592
11593 =back
11594
11595 =item ppport.h
11596
11597 =item AUTHOR
11598
11599 =item SEE ALSO
11600
11601 =back
11602
11603 =head2 Devel::Peek - A data debugging tool for the XS programmer
11604
11605 =over 4
11606
11607 =item SYNOPSIS
11608
11609 =item DESCRIPTION
11610
11611 =over 4
11612
11613 =item Runtime debugging
11614
11615 =item Memory footprint debugging
11616
11617 =back
11618
11619 =item EXAMPLES
11620
11621 =over 4
11622
11623 =item A simple scalar string
11624
11625 =item A simple scalar number
11626
11627 =item A simple scalar with an extra reference
11628
11629 =item A reference to a simple scalar
11630
11631 =item A reference to an array
11632
11633 =item A reference to a hash
11634
11635 =item Dumping a large array or hash
11636
11637 =item A reference to an SV which holds a C pointer
11638
11639 =item A reference to a subroutine
11640
11641 =back
11642
11643 =item EXPORTS
11644
11645 =item BUGS
11646
11647 =item AUTHOR
11648
11649 =item SEE ALSO
11650
11651 =back
11652
11653 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
11654
11655 =over 4
11656
11657 =item SYNOPSIS
11658
11659 =item DESCRIPTION
11660
11661 =back
11662
11663 =head2 Digest:: - Modules that calculate message digests
11664
11665 =over 4
11666
11667 =item SYNOPSIS
11668
11669 =item DESCRIPTION
11670
11671 I<binary>, I<hex>, I<base64>
11672
11673 =item OO INTERFACE
11674
11675 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
11676 Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset,
11677 $ctx->add($data,...), $ctx->addfile($io_handle), $ctx->digest,
11678 $ctx->hexdigest, $ctx->b64digest
11679
11680 =item SEE ALSO
11681
11682 =item AUTHOR
11683
11684 =back
11685
11686 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
11687
11688 =over 4
11689
11690 =item SYNOPSIS
11691
11692 =item DESCRIPTION
11693
11694 =item FUNCTIONS
11695
11696 md5($data,...), md5_hex($data,...), md5_base64($data,...)
11697
11698 =item METHODS
11699
11700 $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...),
11701 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
11702
11703 =item EXAMPLES
11704
11705 =item SEE ALSO
11706
11707 =item COPYRIGHT
11708
11709 =item AUTHORS
11710
11711 =back
11712
11713 =head2 DirHandle - supply object methods for directory handles
11714
11715 =over 4
11716
11717 =item SYNOPSIS
11718
11719 =item DESCRIPTION
11720
11721 =item NOTES
11722
11723 =back
11724
11725 =head2 Dumpvalue - provides screen dump of Perl data.
11726
11727 =over 4
11728
11729 =item SYNOPSIS
11730
11731 =item DESCRIPTION
11732
11733 =over 4
11734
11735 =item Creation
11736
11737 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
11738 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
11739 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
11740 stopDbSignal
11741
11742 =item Methods
11743
11744 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
11745 compactDump, veryCompact, set, get
11746
11747 =back
11748
11749 =back
11750
11751 =head2 DynaLoader - Dynamically load C libraries into Perl code
11752
11753 =over 4
11754
11755 =item SYNOPSIS
11756
11757 =item DESCRIPTION
11758
11759 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
11760 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
11761 dl_load_file(), dl_unload_file(), dl_load_flags(), dl_find_symbol(),
11762 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
11763 bootstrap()
11764
11765 =item AUTHOR
11766
11767 =back
11768
11769 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
11770 Perl code
11771
11772 =over 4
11773
11774 =item SYNOPSIS
11775
11776 =item DESCRIPTION
11777
11778 =over 4
11779
11780 =item Migration from C<DynaLoader>
11781
11782 =item Backward compatible boilerplate
11783
11784 =back
11785
11786 =item Order of initialization: early load()
11787
11788 =over 4
11789
11790 =item The most hairy case
11791
11792 =back
11793
11794 =item LIMITATIONS
11795
11796 =item AUTHOR
11797
11798 =back
11799
11800 =head2 Encode - character encodings
11801
11802 =over 4
11803
11804 =item SYNOPSIS
11805
11806 =over 4
11807
11808 =item Table of Contents
11809
11810 =back
11811
11812 =item DESCRIPTION
11813
11814 =over 4
11815
11816 =item TERMINOLOGY
11817
11818 =back
11819
11820 =item PERL ENCODING API
11821
11822 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
11823 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
11824 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
11825 CHECK]);
11826
11827 =over 4
11828
11829 =item Listing available encodings
11830
11831 =item Defining Aliases
11832
11833 =back
11834
11835 =item Encoding via PerlIO
11836
11837 =item Handling Malformed Data
11838
11839 I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
11840 I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
11841 (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
11842 Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
11843 bitmask
11844
11845 =over 4
11846
11847 =item Unimplemented fallback schemes
11848
11849 =back
11850
11851 =item Defining Encodings
11852
11853 =item The UTF-8 flag
11854
11855 Goal #1:, Goal #2:, Goal #3:, Goal #4:
11856
11857 =over 4
11858
11859 =item Messing with Perl's Internals
11860
11861 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
11862
11863 =back
11864
11865 =item SEE ALSO
11866
11867 =item MAINTAINER
11868
11869 =back
11870
11871 =head2 Encode::Alias - alias definitions to encodings
11872
11873 =over 4
11874
11875 =item SYNOPSIS
11876
11877 =item DESCRIPTION
11878
11879 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
11880 reference, e.g.:
11881
11882 =over 4
11883
11884 =item Alias overloading
11885
11886 =back
11887
11888 =item SEE ALSO
11889
11890 =back
11891
11892 =head2 Encode::Byte - Single Byte Encodings
11893
11894 =over 4
11895
11896 =item SYNOPSIS
11897
11898 =item ABSTRACT
11899
11900 =item DESCRIPTION
11901
11902 =item SEE ALSO
11903
11904 =back
11905
11906 =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
11907
11908 =head2 Encode::CN - China-based Chinese Encodings
11909
11910 =over 4
11911
11912 =item SYNOPSIS
11913
11914 =item DESCRIPTION
11915
11916 =item NOTES
11917
11918 =item BUGS
11919
11920 =item SEE ALSO
11921
11922 =back
11923
11924 =head2 Encode::CN::HZ -- internally used by Encode::CN
11925
11926 =head2 Encode::Config -- internally used by Encode
11927
11928 =head2 Encode::EBCDIC - EBCDIC Encodings
11929
11930 =over 4
11931
11932 =item SYNOPSIS
11933
11934 =item ABSTRACT
11935
11936 =item DESCRIPTION
11937
11938 =item SEE ALSO
11939
11940 =back
11941
11942 =head2 Encode::Encoding - Encode Implementation Base Class
11943
11944 =over 4
11945
11946 =item SYNOPSIS
11947
11948 =item DESCRIPTION
11949
11950 =over 4
11951
11952 =item Methods you should implement
11953
11954 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
11955 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
11956
11957 =item Other methods defined in Encode::Encodings
11958
11959 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
11960
11961 =item Example: Encode::ROT13
11962
11963 =back
11964
11965 =item Why the heck Encode API is different?
11966
11967 =over 4
11968
11969 =item Compiled Encodings
11970
11971 =back
11972
11973 =item SEE ALSO
11974
11975 Scheme 1, Scheme 2, Other Schemes
11976
11977 =back
11978
11979 =head2 Encode::Guess -- Guesses encoding from data
11980
11981 =over 4
11982
11983 =item SYNOPSIS
11984
11985 =item ABSTRACT
11986
11987 =item DESCRIPTION
11988
11989 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
11990 Encode::decode("Guess" ...), Encode::Guess->guess($data),
11991 guess_encoding($data, [, I<list of suspects>])
11992
11993 =item CAVEATS
11994
11995 =item TO DO
11996
11997 =item SEE ALSO
11998
11999 =back
12000
12001 =head2 Encode::JP - Japanese Encodings
12002
12003 =over 4
12004
12005 =item SYNOPSIS
12006
12007 =item ABSTRACT
12008
12009 =item DESCRIPTION
12010
12011 =item Note on ISO-2022-JP(-1)?
12012
12013 =item BUGS
12014
12015 =item SEE ALSO
12016
12017 =back
12018
12019 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
12020
12021 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
12022
12023 =head2 Encode::KR - Korean Encodings
12024
12025 =over 4
12026
12027 =item SYNOPSIS
12028
12029 =item DESCRIPTION
12030
12031 =item BUGS
12032
12033 =item SEE ALSO
12034
12035 =back
12036
12037 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
12038
12039 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
12040
12041 =over 4
12042
12043 =item SYNOPSIS
12044
12045 =item ABSTRACT
12046
12047 =item DESCRIPTION
12048
12049 =item BUGS
12050
12051 =item SEE ALSO
12052
12053 =back
12054
12055 =head2 Encode::PerlIO -- a detailed document on Encode and PerlIO
12056
12057 =over 4
12058
12059 =item Overview
12060
12061 =item How does it work?
12062
12063 =item Line Buffering
12064
12065 =over 4
12066
12067 =item How can I tell whether my encoding fully supports PerlIO ?
12068
12069 =back
12070
12071 =item SEE ALSO
12072
12073 =back
12074
12075 =head2 Encode::Supported -- Encodings supported by Encode
12076
12077 =over 4
12078
12079 =item DESCRIPTION
12080
12081 =over 4
12082
12083 =item Encoding Names
12084
12085 =back
12086
12087 =item Supported Encodings
12088
12089 =over 4
12090
12091 =item Built-in Encodings
12092
12093 =item Encode::Unicode -- other Unicode encodings
12094
12095 =item Encode::Byte -- Extended ASCII
12096
12097 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
12098 the Cyrillic world, gsm0338 - Hentai Latin 1
12099
12100 =item CJK: Chinese, Japanese, Korean (Multibyte)
12101
12102 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
12103 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
12104 Encode::JIS2K -- JIS X 0213 encodings via CPAN
12105
12106 =item Miscellaneous encodings
12107
12108 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
12109
12110 =back
12111
12112 =item Unsupported encodings
12113
12114   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
12115 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
12116 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
12117 Various Mac encodings, (Mac) Indic encodings
12118
12119 =item Encoding vs. Charset -- terminology
12120
12121 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
12122
12123 =over 4
12124
12125 =item Microsoft-related naming mess
12126
12127 KS_C_5601-1987, GB2312, Big5, Shift_JIS
12128
12129 =back
12130
12131 =item Glossary
12132
12133 character repertoire, coded character set (CCS), character encoding scheme
12134 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
12135 UTF-16
12136
12137 =item See Also
12138
12139 =item References
12140
12141 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
12142 RFC, UC, Unicode Glossary
12143
12144 =over 4
12145
12146 =item Other Notable Sites
12147
12148 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
12149 "Introduction to i18n"
12150
12151 =item Offline sources
12152
12153 C<CJKV Information Processing> by Ken Lunde
12154
12155 =back
12156
12157 =back
12158
12159 =head2 Encode::Symbol - Symbol Encodings
12160
12161 =over 4
12162
12163 =item SYNOPSIS
12164
12165 =item ABSTRACT
12166
12167 =item DESCRIPTION
12168
12169 =item SEE ALSO
12170
12171 =back
12172
12173 =head2 Encode::TW - Taiwan-based Chinese Encodings
12174
12175 =over 4
12176
12177 =item SYNOPSIS
12178
12179 =item DESCRIPTION
12180
12181 =item NOTES
12182
12183 =item BUGS
12184
12185 =item SEE ALSO
12186
12187 =back
12188
12189 =head2 Encode::Unicode -- Various Unicode Transformation Formats
12190
12191 =over 4
12192
12193 =item SYNOPSIS
12194
12195 =item ABSTRACT
12196
12197 L<http://www.unicode.org/glossary/> says:, Quick Reference
12198
12199 =item Size, Endianness, and BOM
12200
12201 =over 4
12202
12203 =item by size
12204
12205 =item by endianness
12206
12207 BOM as integer when fetched in network byte order
12208
12209 =back
12210
12211 =item Surrogate Pairs
12212
12213 =item SEE ALSO
12214
12215 =back
12216
12217 =head2 Encode::Unicode::UTF7 -- UTF-7 encoding
12218
12219 =over 4
12220
12221 =item SYNOPSIS
12222
12223 =item ABSTRACT
12224
12225 =item In Practice
12226
12227 =item SEE ALSO
12228
12229 =back
12230
12231 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
12232 encodings
12233
12234 =over 4
12235
12236 =item SYNOPSIS
12237
12238 =item DESCRIPTION
12239
12240 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
12241 reference, e.g.:
12242
12243 =over 4
12244
12245 =item Alias overloading
12246
12247 =back
12248
12249 =item SEE ALSO
12250
12251 =back
12252
12253 =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm --
12254 Internally used by Encode::??::ISO_2022_*
12255
12256 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
12257 Encode::CN
12258
12259 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
12260 Encode
12261
12262 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
12263 Implementation Base Class
12264
12265 =over 4
12266
12267 =item SYNOPSIS
12268
12269 =item DESCRIPTION
12270
12271 =over 4
12272
12273 =item Methods you should implement
12274
12275 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
12276 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
12277
12278 =item Other methods defined in Encode::Encodings
12279
12280 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
12281
12282 =item Example: Encode::ROT13
12283
12284 =back
12285
12286 =item Why the heck Encode API is different?
12287
12288 =over 4
12289
12290 =item Compiled Encodings
12291
12292 =back
12293
12294 =item SEE ALSO
12295
12296 Scheme 1, Scheme 2, Other Schemes
12297
12298 =back
12299
12300 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
12301 data
12302
12303 =over 4
12304
12305 =item SYNOPSIS
12306
12307 =item ABSTRACT
12308
12309 =item DESCRIPTION
12310
12311 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
12312 Encode::decode("Guess" ...), Encode::Guess->guess($data),
12313 guess_encoding($data, [, I<list of suspects>])
12314
12315 =item CAVEATS
12316
12317 =item TO DO
12318
12319 =item SEE ALSO
12320
12321 =back
12322
12323 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
12324 Encode::JP::2022_JP*
12325
12326 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
12327 by Encode::JP
12328
12329 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
12330 used by Encode::KR
12331
12332 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
12333 and 'Q' header encoding
12334
12335 =over 4
12336
12337 =item SYNOPSIS
12338
12339 =item ABSTRACT
12340
12341 =item DESCRIPTION
12342
12343 =item BUGS
12344
12345 =item SEE ALSO
12346
12347 =back
12348
12349 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
12350 on Encode and PerlIO
12351
12352 =over 4
12353
12354 =item Overview
12355
12356 =item How does it work?
12357
12358 =item Line Buffering
12359
12360 =over 4
12361
12362 =item How can I tell whether my encoding fully supports PerlIO ?
12363
12364 =back
12365
12366 =item SEE ALSO
12367
12368 =back
12369
12370 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
12371 supported by Encode
12372
12373 =over 4
12374
12375 =item DESCRIPTION
12376
12377 =over 4
12378
12379 =item Encoding Names
12380
12381 =back
12382
12383 =item Supported Encodings
12384
12385 =over 4
12386
12387 =item Built-in Encodings
12388
12389 =item Encode::Unicode -- other Unicode encodings
12390
12391 =item Encode::Byte -- Extended ASCII
12392
12393 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
12394 the Cyrillic world, gsm0338 - Hentai Latin 1
12395
12396 =item CJK: Chinese, Japanese, Korean (Multibyte)
12397
12398 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
12399 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
12400 Encode::JIS2K -- JIS X 0213 encodings via CPAN
12401
12402 =item Miscellaneous encodings
12403
12404 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
12405
12406 =back
12407
12408 =item Unsupported encodings
12409
12410   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
12411 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
12412 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
12413 Various Mac encodings, (Mac) Indic encodings
12414
12415 =item Encoding vs. Charset -- terminology
12416
12417 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
12418
12419 =over 4
12420
12421 =item Microsoft-related naming mess
12422
12423 KS_C_5601-1987, GB2312, Big5, Shift_JIS
12424
12425 =back
12426
12427 =item Glossary
12428
12429 character repertoire, coded character set (CCS), character encoding scheme
12430 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
12431 UTF-16
12432
12433 =item See Also
12434
12435 =item References
12436
12437 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
12438 RFC, UC, Unicode Glossary
12439
12440 =over 4
12441
12442 =item Other Notable Sites
12443
12444 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
12445 "Introduction to i18n"
12446
12447 =item Offline sources
12448
12449 C<CJKV Information Processing> by Ken Lunde
12450
12451 =back
12452
12453 =back
12454
12455 =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7
12456 encoding
12457
12458 =over 4
12459
12460 =item SYNOPSIS
12461
12462 =item ABSTRACT
12463
12464 =item In Practice
12465
12466 =item SEE ALSO
12467
12468 =back
12469
12470 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
12471
12472 =over 4
12473
12474 =item SYNOPSIS
12475
12476 =item ABSTRACT
12477
12478 =item Description
12479
12480 =over 4
12481
12482 =item Predefined Methods
12483
12484 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12485 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12486 $e-E<gt>bytes([$encoding])
12487
12488 =item Example: base64 transcoder
12489
12490 =item Operator Overloading
12491
12492 =back
12493
12494 =item SEE ALSO
12495
12496 =back
12497
12498 =head2 Encodencoding, encoding - allows you to write your script in
12499 non-ascii or non-utf8
12500
12501 =over 4
12502
12503 =item SYNOPSIS
12504
12505 =item ABSTRACT
12506
12507 =over 4
12508
12509 =item Literal Conversions
12510
12511 =item PerlIO layers for C<STD(IN|OUT)>
12512
12513 =back
12514
12515 =item FEATURES THAT REQUIRE 5.8.1
12516
12517 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
12518
12519 =item USAGE
12520
12521 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
12522 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
12523
12524 =item The Filter Option
12525
12526 =over 4
12527
12528 =item Filter-related changes at Encode version 1.87
12529
12530 =back
12531
12532 =item CAVEATS
12533
12534 =over 4
12535
12536 =item NOT SCOPED
12537
12538 =item DO NOT MIX MULTIPLE ENCODINGS
12539
12540 =item tr/// with ranges
12541
12542 Legend of characters above
12543
12544 =back
12545
12546 =item EXAMPLE - Greekperl
12547
12548 =item KNOWN PROBLEMS
12549
12550 literals in regex that are longer than 127 bytes, EBCDIC, format
12551
12552 =item HISTORY
12553
12554 =item SEE ALSO
12555
12556 =back
12557
12558 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
12559
12560 =over 4
12561
12562 =item SYNOPSIS
12563
12564 =item ABSTRACT
12565
12566 =item Description
12567
12568 =over 4
12569
12570 =item Predefined Methods
12571
12572 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12573 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12574 $e-E<gt>bytes([$encoding])
12575
12576 =item Example: base64 transcoder
12577
12578 =item Operator Overloading
12579
12580 =back
12581
12582 =item SEE ALSO
12583
12584 =back
12585
12586 =head2 English - use nice English (or awk) names for ugly punctuation
12587 variables
12588
12589 =over 4
12590
12591 =item SYNOPSIS
12592
12593 =item DESCRIPTION
12594
12595 =item PERFORMANCE
12596
12597 =back
12598
12599 =head2 Env - perl module that imports environment variables as scalars or
12600 arrays
12601
12602 =over 4
12603
12604 =item SYNOPSIS
12605
12606 =item DESCRIPTION
12607
12608 =item LIMITATIONS
12609
12610 =item AUTHOR
12611
12612 =back
12613
12614 =head2 Errno - System errno constants
12615
12616 =over 4
12617
12618 =item SYNOPSIS
12619
12620 =item DESCRIPTION
12621
12622 =item CAVEATS
12623
12624 =item AUTHOR
12625
12626 =item COPYRIGHT
12627
12628 =back
12629
12630 =head2 Exporter - Implements default import method for modules
12631
12632 =over 4
12633
12634 =item SYNOPSIS
12635
12636 =item DESCRIPTION
12637
12638 =over 4
12639
12640 =item How to Export
12641
12642 =item Selecting What To Export
12643
12644 =item How to Import
12645
12646 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
12647
12648 =back
12649
12650 =item Advanced features
12651
12652 =over 4
12653
12654 =item Specialised Import Lists
12655
12656 =item Exporting without using Exporter's import method
12657
12658 =item Module Version Checking
12659
12660 =item Managing Unknown Symbols
12661
12662 =item Tag Handling Utility Functions
12663
12664 =item Generating combined tags
12665
12666 =item C<AUTOLOAD>ed Constants
12667
12668 =back
12669
12670 =back
12671
12672 =head2 Exporter::Heavy - Exporter guts
12673
12674 =over 4
12675
12676 =item SYNOPSIS
12677
12678 =item DESCRIPTION
12679
12680 =back
12681
12682 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
12683 Makefiles etc.
12684
12685 =over 4
12686
12687 =item SYNOPSIS
12688
12689 =item DESCRIPTION
12690
12691 =back
12692
12693 cat
12694
12695 eqtime src dst
12696
12697 rm_rf files...
12698
12699 rm_f files...
12700
12701 touch files ..
12702
12703 mv source... destination
12704
12705 cp source... destination
12706
12707 chmod mode files..
12708
12709 mkpath directory..
12710
12711 test_f file
12712
12713 =over 4
12714
12715 =item BUGS
12716
12717 =item SEE ALSO 
12718
12719 =item AUTHOR
12720
12721 =back
12722
12723 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
12724
12725 =over 4
12726
12727 =item SYNOPSIS
12728
12729 =item DESCRIPTION
12730
12731 B<test_harness>
12732
12733 =back
12734
12735 B<pod2man>
12736
12737 B<warn_if_old_packlist>
12738
12739 B<perllocal_install>
12740
12741 B<uninstall>
12742
12743 =head2 ExtUtils::Constant - generate XS code to import C header constants
12744
12745 =over 4
12746
12747 =item SYNOPSIS
12748
12749 =item DESCRIPTION
12750
12751 =item USAGE
12752
12753 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
12754
12755 =item FUNCTIONS
12756
12757 =back
12758
12759 C_stringify NAME
12760
12761 perl_stringify NAME
12762
12763 constant_types
12764
12765 memEQ_clause NAME, CHECKED_AT, INDENT
12766
12767 assign INDENT, TYPE, PRE, POST, VALUE..
12768
12769 return_clause
12770
12771 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
12772
12773 params WHAT
12774
12775 dump_names
12776
12777 dogfood
12778
12779 C_constant, name, type, value, macro, default, pre, post, def_pre =item
12780 def_post, utf8
12781
12782 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
12783
12784 autoload PACKAGE, VERSION, AUTOLOADER
12785
12786 WriteMakefileSnippet
12787
12788 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
12789 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
12790
12791 =over 4
12792
12793 =item AUTHOR
12794
12795 =back
12796
12797 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
12798
12799 =over 4
12800
12801 =item SYNOPSIS
12802
12803 =item DESCRIPTION
12804
12805 =item @EXPORT
12806
12807 =item FUNCTIONS
12808
12809 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
12810 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
12811
12812 =item EXAMPLES
12813
12814 =item SEE ALSO
12815
12816 =item AUTHOR
12817
12818 =back
12819
12820 =head2 ExtUtils::Install - install files from here to there
12821
12822 =over 4
12823
12824 =item SYNOPSIS
12825
12826 =item DESCRIPTION
12827
12828 =over 4
12829
12830 =item Functions
12831
12832 B<install>
12833
12834 =back
12835
12836 =back
12837
12838 B<install_default> I<DISCOURAGED>
12839
12840 B<uninstall>
12841
12842 B<pm_to_blib>
12843
12844 _autosplit
12845
12846 =over 4
12847
12848 =item ENVIRONMENT
12849
12850 B<PERL_INSTALL_ROOT>
12851
12852 =item AUTHOR
12853
12854 =item LICENSE
12855
12856 =back
12857
12858 =head2 ExtUtils::Installed - Inventory management of installed modules
12859
12860 =over 4
12861
12862 =item SYNOPSIS
12863
12864 =item DESCRIPTION
12865
12866 =item USAGE
12867
12868 =item FUNCTIONS
12869
12870 new(), modules(), files(), directories(), directory_tree(), validate(),
12871 packlist(), version()
12872
12873 =item EXAMPLE
12874
12875 =item AUTHOR
12876
12877 =back
12878
12879 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
12880
12881 =over 4
12882
12883 =item SYNOPSIS
12884
12885 =item DESCRIPTION
12886
12887 For static extensions, For dynamic extensions at build/link time, For
12888 dynamic extensions at load time
12889
12890 =over 4
12891
12892 =item EXTRALIBS
12893
12894 =item LDLOADLIBS and LD_RUN_PATH
12895
12896 =item BSLOADLIBS
12897
12898 =back
12899
12900 =item PORTABILITY
12901
12902 =over 4
12903
12904 =item VMS implementation
12905
12906 =item Win32 implementation
12907
12908 =back
12909
12910 =item SEE ALSO
12911
12912 =back
12913
12914 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
12915
12916 =over 4
12917
12918 =item SYNOPSIS
12919
12920 =item DESCRIPTION
12921
12922 =back
12923
12924 =head2 ExtUtils::MM_Any - Platform agnostic MM methods
12925
12926 =over 4
12927
12928 =item SYNOPSIS
12929
12930 =item DESCRIPTION
12931
12932 =item Inherently Cross-Platform Methods
12933
12934 installvars
12935
12936 =back
12937
12938 os_flavor_is
12939
12940 =over 4
12941
12942 =item File::Spec wrappers
12943
12944 catfile
12945
12946 =back
12947
12948 =over 4
12949
12950 =item Thought To Be Cross-Platform Methods
12951
12952 B<split_command>
12953
12954 =back
12955
12956 B<echo>
12957
12958 init_VERSION
12959
12960 wraplist
12961
12962 manifypods
12963
12964 manifypods_target
12965
12966 makemakerdflt_target
12967
12968 special_targets
12969
12970 POD2MAN_macro
12971
12972 test_via_harness
12973
12974 test_via_script
12975
12976 libscan
12977
12978 tool_autosplit
12979
12980 all_target
12981
12982 metafile_target
12983
12984 metafile_addtomanifest_target
12985
12986 =over 4
12987
12988 =item Abstract methods
12989
12990 oneliner, B<quote_literal>, B<escape_newlines>, max_exec_len,
12991 B<init_others>, init_DIRFILESEP, init_linker, init_platform,
12992 platform_constants
12993
12994 =back
12995
12996 os_flavor
12997
12998 =over 4
12999
13000 =item AUTHOR
13001
13002 =back
13003
13004 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
13005 ExtUtils::MakeMaker
13006
13007 =over 4
13008
13009 =item SYNOPSIS
13010
13011 =item DESCRIPTION
13012
13013 =back
13014
13015 os_flavor (o)
13016
13017 init_linker
13018
13019 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
13020 ExtUtils::MakeMaker
13021
13022 =over 4
13023
13024 =item SYNOPSIS
13025
13026 =item DESCRIPTION
13027
13028 os_flavor (o)
13029
13030 =back
13031
13032 cflags (o)
13033
13034 replace_manpage_separator (o)
13035
13036 init_linker
13037
13038 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
13039
13040 =over 4
13041
13042 =item SYNOPSIS
13043
13044 =item DESCRIPTION
13045
13046 =over 4
13047
13048 =item Overridden methods
13049
13050 os_flavor
13051
13052 =back
13053
13054 =back
13055
13056 B<replace_manpage_separator>
13057
13058 =over 4
13059
13060 =item AUTHOR
13061
13062 =item SEE ALSO
13063
13064 =back
13065
13066 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
13067 ExtUtils::MakeMaker
13068
13069 =over 4
13070
13071 =item SYNOPSIS
13072
13073 =item DESCRIPTION
13074
13075 =back
13076
13077 maybe_command
13078
13079 guess_name
13080
13081 macify
13082
13083 patternify
13084
13085 init_main
13086
13087 init_others
13088
13089 init_platform, platform_constants
13090
13091 init_dirscan
13092
13093 init_VERSION (o)
13094
13095 special_targets (o)
13096
13097 static (o)
13098
13099 dlsyms (o)
13100
13101 dynamic (o)
13102
13103 clean (o)
13104
13105 clean_subdirs_target
13106
13107 realclean (o)
13108
13109 realclean_subdirs_target
13110
13111 rulez (o)
13112
13113 processPL (o)
13114
13115 os_flavor
13116
13117 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
13118 ExtUtils::MakeMaker
13119
13120 =over 4
13121
13122 =item SYNOPSIS
13123
13124 =item DESCRIPTION
13125
13126 =back
13127
13128 os_flavor
13129
13130 init_platform (o), platform_constants
13131
13132 const_cccmd (o)
13133
13134 static_lib (o)
13135
13136 dynamic_lib (o)
13137
13138 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
13139 ExtUtils::MakeMaker
13140
13141 =over 4
13142
13143 =item SYNOPSIS
13144
13145 =item DESCRIPTION
13146
13147 =item METHODS
13148
13149 init_dist (o)
13150
13151 =back
13152
13153 init_linker
13154
13155 os_flavor
13156
13157 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
13158
13159 =over 4
13160
13161 =item SYNOPSIS
13162
13163 =item DESCRIPTION
13164
13165 =over 4
13166
13167 =item Overridden methods
13168
13169 os_flavor
13170
13171 =back
13172
13173 =back
13174
13175 B<replace_manpage_separator>
13176
13177 =over 4
13178
13179 =item AUTHOR
13180
13181 =item SEE ALSO
13182
13183 =back
13184
13185 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
13186
13187 =over 4
13188
13189 =item SYNOPSIS
13190
13191 =item DESCRIPTION
13192
13193 =item METHODS
13194
13195 =back
13196
13197 =over 4
13198
13199 =item Methods
13200
13201 os_flavor (o)
13202
13203 =back
13204
13205 c_o (o)
13206
13207 cflags (o)
13208
13209 clean (o)
13210
13211 clean_subdirs_target
13212
13213 const_cccmd (o)
13214
13215 const_config (o)
13216
13217 const_loadlibs (o)
13218
13219 constants (o)
13220
13221 depend (o)
13222
13223 dir_target (o)
13224
13225 init_DEST
13226
13227 init_dist
13228
13229 dist (o)
13230
13231 dist_basics (o)
13232
13233 dist_ci (o)
13234
13235 dist_core (o)
13236
13237 B<dist_target>
13238
13239 B<tardist_target>
13240
13241 B<zipdist_target>
13242
13243 B<tarfile_target>
13244
13245 zipfile_target
13246
13247 uutardist_target
13248
13249 shdist_target
13250
13251 distdir
13252
13253 dist_test
13254
13255 dlsyms (o)
13256
13257 dynamic (o)
13258
13259 dynamic_bs (o)
13260
13261 dynamic_lib (o)
13262
13263 exescan
13264
13265 extliblist
13266
13267 find_perl
13268
13269 find_tests
13270
13271 =over 4
13272
13273 =item Methods to actually produce chunks of text for the Makefile
13274
13275 fixin
13276
13277 =back
13278
13279 force (o)
13280
13281 guess_name
13282
13283 has_link_code
13284
13285 init_dirscan
13286
13287 init_DIRFILESEP
13288
13289 init_main
13290
13291 init_others
13292
13293 init_INST
13294
13295 init_INSTALL
13296
13297 init_linker
13298
13299 init_lib2arch
13300
13301 init_PERL
13302
13303 init_platform (o), platform_constants (o)
13304
13305 init_PERM
13306
13307 init_xs
13308
13309 install (o)
13310
13311 installbin (o)
13312
13313 linkext (o)
13314
13315 lsdir
13316
13317 macro (o)
13318
13319 makeaperl (o)
13320
13321 makefile (o)
13322
13323 maybe_command
13324
13325 needs_linking (o)
13326
13327 nicetext
13328
13329 parse_abstract
13330
13331 parse_version
13332
13333 pasthru (o)
13334
13335 perl_script
13336
13337 perldepend (o)
13338
13339 perm_rw (o)
13340
13341 perm_rwx (o)
13342
13343 pm_to_blib
13344
13345 post_constants (o)
13346
13347 post_initialize (o)
13348
13349 postamble (o)
13350
13351 ppd
13352
13353 prefixify
13354
13355 processPL (o)
13356
13357 quote_paren
13358
13359 realclean (o)
13360
13361 realclean_subdirs_target
13362
13363 replace_manpage_separator
13364
13365 oneliner (o)
13366
13367 quote_literal
13368
13369 escape_newlines
13370
13371 max_exec_len
13372
13373 static (o)
13374
13375 static_lib (o)
13376
13377 staticmake (o)
13378
13379 subdir_x (o)
13380
13381 subdirs (o)
13382
13383 test (o)
13384
13385 test_via_harness (override)
13386
13387 test_via_script (override)
13388
13389 tools_other (o)
13390
13391 tool_xsubpp (o)
13392
13393 all_target
13394
13395 top_targets (o)
13396
13397 writedoc
13398
13399 xs_c (o)
13400
13401 xs_cpp (o)
13402
13403 xs_o (o)
13404
13405 =over 4
13406
13407 =item SEE ALSO
13408
13409 =back
13410
13411 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
13412 ExtUtils::MakeMaker
13413
13414 =over 4
13415
13416 =item SYNOPSIS
13417
13418 =item DESCRIPTION
13419
13420 =over 4
13421
13422 =item Methods always loaded
13423
13424 wraplist
13425
13426 =back
13427
13428 =back
13429
13430 =over 4
13431
13432 =item Methods
13433
13434 guess_name (override)
13435
13436 =back
13437
13438 find_perl (override)
13439
13440 maybe_command (override)
13441
13442 perl_script (override)
13443
13444 replace_manpage_separator
13445
13446 init_DEST
13447
13448 init_DIRFILESEP
13449
13450 init_main (override)
13451
13452 init_others (override)
13453
13454 init_platform (override)
13455
13456 platform_constants
13457
13458 init_VERSION (override)
13459
13460 constants (override)
13461
13462 special_targets
13463
13464 cflags (override)
13465
13466 const_cccmd (override)
13467
13468 tool_sxubpp (override)
13469
13470 tools_other (override)
13471
13472 init_dist (override)
13473
13474 c_o (override)
13475
13476 xs_c (override)
13477
13478 xs_o (override)
13479
13480 dlsyms (override)
13481
13482 dynamic_lib (override)
13483
13484 dynamic_bs (override)
13485
13486 static_lib (override)
13487
13488 processPL (override)
13489
13490 installbin (override)
13491
13492 subdir_x (override)
13493
13494 clean (override)
13495
13496 clean_subdirs_target
13497
13498 realclean (override)
13499
13500 zipfile_target (o), tarfile_target (o), shdist_target (o)
13501
13502 dist_test (override)
13503
13504 install (override)
13505
13506 perldepend (override)
13507
13508 makefile (override)
13509
13510 find_tests (override)
13511
13512 test (override)
13513
13514 makeaperl (override)
13515
13516 nicetext (override)
13517
13518 prefixify (override)
13519
13520 oneliner (o)
13521
13522 B<echo> (o)
13523
13524 quote_literal
13525
13526 escape_newlines
13527
13528 max_exec_len
13529
13530 init_linker (o)
13531
13532 eliminate_macros
13533
13534 fixpath
13535
13536 os_flavor
13537
13538 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
13539 ExtUtils::MakeMaker
13540
13541 =over 4
13542
13543 =item SYNOPSIS
13544
13545 =item DESCRIPTION
13546
13547 =back
13548
13549 =over 4
13550
13551 =item Overridden methods
13552
13553 B<dlsyms>
13554
13555 =back
13556
13557 replace_manpage_separator
13558
13559 B<maybe_command>
13560
13561 B<find_tests>
13562
13563 B<init_DIRFILESEP>
13564
13565 B<init_others>
13566
13567 init_platform (o), platform_constants (o)
13568
13569 special_targets (o)
13570
13571 static_lib (o)
13572
13573 dynamic_lib (o)
13574
13575 clean
13576
13577 init_linker
13578
13579 perl_script
13580
13581 xs_o (o)
13582
13583 pasthru (o)
13584
13585 oneliner (o)
13586
13587 max_exec_len
13588
13589 os_flavor
13590
13591 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
13592
13593 =over 4
13594
13595 =item SYNOPSIS
13596
13597 =item DESCRIPTION
13598
13599 =over 4
13600
13601 =item Overriden methods
13602
13603 dist_test
13604
13605 =back
13606
13607 =back
13608
13609 subdir_x
13610
13611 xs_c
13612
13613 xs_cpp
13614
13615 xs_o
13616
13617 clean_subdirs_target
13618
13619 realclean_subdirs_target
13620
13621 os_flavor
13622
13623 =over 4
13624
13625 =item AUTHOR
13626
13627 =back
13628
13629 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
13630
13631 =over 4
13632
13633 =item SYNOPSIS
13634
13635 =item DESCRIPTION
13636
13637 =back
13638
13639 =head2 ExtUtils::MakeMaker - Create a module Makefile
13640
13641 =over 4
13642
13643 =item SYNOPSIS
13644
13645 =item DESCRIPTION
13646
13647 =over 4
13648
13649 =item How To Write A Makefile.PL
13650
13651 =item Default Makefile Behaviour
13652
13653 =item make test
13654
13655 =item make testdb
13656
13657 =item make install
13658
13659 =item PREFIX and LIB attribute
13660
13661 =item AFS users
13662
13663 =item Static Linking of a new Perl Binary
13664
13665 =item Determination of Perl Library and Installation Locations
13666
13667 =item Which architecture dependent directory?
13668
13669 =item Using Attributes and Parameters
13670
13671 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
13672 CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS,
13673 EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN,
13674 FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB,
13675 INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
13676 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB,
13677 INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLVENDORARCH,
13678 INSTALLVENDORBIN, INSTALLVENDORLIB, INSTALLVENDORMAN1DIR,
13679 INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR,
13680 INST_MAN3DIR, INST_SCRIPT, LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS,
13681 LINKTYPE, MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET,
13682 MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT,
13683 OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB,
13684 PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW,
13685 PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
13686 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT,
13687 PRINT_PREREQ, SITEPREFIX, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST, VERSION,
13688 VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION
13689
13690 =item Additional lowercase attributes
13691
13692 clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean,
13693 test, tool_autosplit
13694
13695 =item Overriding MakeMaker Methods
13696
13697 =item The End Of Cargo Cult Programming
13698
13699 C<<MAN3PODS => ' '>>
13700
13701 =item Hintsfile support
13702
13703 =item Distribution Support
13704
13705    make distcheck,    make skipcheck,    make distclean,    make manifest, 
13706   make distdir,   make disttest,    make tardist,    make dist,    make
13707 uutardist,    make shdist,    make zipdist,    make ci
13708
13709 =item Module Meta-Data
13710
13711 =item Disabling an extension
13712
13713 =item Other Handy Functions
13714
13715 prompt
13716
13717 =back
13718
13719 =item ENVIRONMENT
13720
13721 PERL_MM_OPT, PERL_MM_USE_DEFAULT
13722
13723 =item SEE ALSO
13724
13725 =item AUTHORS
13726
13727 =item LICENSE
13728
13729 =back
13730
13731 =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About
13732 MakeMaker
13733
13734 =over 4
13735
13736 =item DESCRIPTION
13737
13738 =over 4
13739
13740 =item Philosophy and History
13741
13742 Why not just use <insert other build config tool here>?, What's
13743 Module::Build and how does it relate to MakeMaker?, pure perl.  no make, no
13744 shell commands, easier to customize, cleaner internals, less cruft
13745
13746 =item Module Writing
13747
13748 How do I keep my $VERSION up to date without resetting it manually?, What's
13749 this F<META.yml> thing and how did it get in my F<MANIFEST>?!
13750
13751 =item XS
13752
13753 How to I prevent "object version X.XX does not match bootstrap parameter
13754 Y.YY" errors?, How do I make two or more XS files coexist in the same
13755 directory?
13756
13757 =back
13758
13759 =item PATCHING
13760
13761 =item AUTHOR
13762
13763 =item SEE ALSO
13764
13765 =back
13766
13767 =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker
13768
13769 =over 4
13770
13771 =item SYNOPSIS
13772
13773 =item DESCRIPTION
13774
13775 =over 4
13776
13777 =item The Mantra
13778
13779 =item The Layout
13780
13781 Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP,
13782 bin/
13783
13784 =back
13785
13786 =item SEE ALSO
13787
13788 =back
13789
13790 =head2 ExtUtils::MakeMaker::bytes - Version agnostic bytes.pm
13791
13792 =over 4
13793
13794 =item SYNOPSIS
13795
13796 =item DESCRIPTION
13797
13798 =back
13799
13800 =head2 ExtUtils::MakeMaker::vmsish - Platform agnostic vmsish.pm
13801
13802 =over 4
13803
13804 =item SYNOPSIS
13805
13806 =item DESCRIPTION
13807
13808 =back
13809
13810 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
13811
13812 =over 4
13813
13814 =item SYNOPSIS
13815
13816 =item DESCRIPTION
13817
13818 =over 4
13819
13820 =item Functions
13821
13822 mkmanifest
13823
13824 =back
13825
13826 =back
13827
13828 manifind
13829
13830 manicheck
13831
13832 filecheck
13833
13834 fullcheck
13835
13836 skipcheck
13837
13838 maniread
13839
13840 manicopy
13841
13842 maniadd
13843
13844 =over 4
13845
13846 =item MANIFEST
13847
13848 =item MANIFEST.SKIP
13849
13850 =item EXPORT_OK
13851
13852 =item GLOBAL VARIABLES
13853
13854 =back
13855
13856 =over 4
13857
13858 =item DIAGNOSTICS
13859
13860 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
13861 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
13862
13863 =item ENVIRONMENT
13864
13865 B<PERL_MM_MANIFEST_DEBUG>
13866
13867 =item SEE ALSO
13868
13869 =item AUTHOR
13870
13871 =back
13872
13873 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
13874
13875 =over 4
13876
13877 =item SYNOPSIS
13878
13879 =item DESCRIPTION
13880
13881 =item SEE ALSO
13882
13883 =back
13884
13885 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
13886
13887 =over 4
13888
13889 =item SYNOPSIS
13890
13891 =item DESCRIPTION
13892
13893 =back
13894
13895 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
13896 extension
13897
13898 =over 4
13899
13900 =item SYNOPSIS
13901
13902 =item DESCRIPTION
13903
13904 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
13905
13906 =item AUTHOR
13907
13908 =item REVISION
13909
13910 =back
13911
13912 =head2 ExtUtils::Packlist - manage .packlist files
13913
13914 =over 4
13915
13916 =item SYNOPSIS
13917
13918 =item DESCRIPTION
13919
13920 =item USAGE
13921
13922 =item FUNCTIONS
13923
13924 new(), read(), write(), validate(), packlist_file()
13925
13926 =item EXAMPLE
13927
13928 =item AUTHOR
13929
13930 =back
13931
13932 =head2 ExtUtils::testlib - add blib/* directories to @INC
13933
13934 =over 4
13935
13936 =item SYNOPSIS
13937
13938 =item DESCRIPTION
13939
13940 =back
13941
13942 =head2 Fatal - replace functions with equivalents which succeed or die
13943
13944 =over 4
13945
13946 =item SYNOPSIS
13947
13948 =item DESCRIPTION
13949
13950 =item AUTHOR
13951
13952 =back
13953
13954 =head2 Fcntl - load the C Fcntl.h defines
13955
13956 =over 4
13957
13958 =item SYNOPSIS
13959
13960 =item DESCRIPTION
13961
13962 =item NOTE
13963
13964 =item EXPORTED SYMBOLS
13965
13966 =back
13967
13968 =head2 File::Basename, fileparse - split a pathname into pieces
13969
13970 =over 4
13971
13972 =item SYNOPSIS
13973
13974 =item DESCRIPTION
13975
13976 fileparse_set_fstype, fileparse
13977
13978 =item EXAMPLES
13979
13980 C<basename>, C<dirname>
13981
13982 =back
13983
13984 =head2 File::CheckTree, validate - run many filetest checks on a tree
13985
13986 =over 4
13987
13988 =item SYNOPSIS
13989
13990 =item DESCRIPTION
13991
13992 =item AUTHOR
13993
13994 =item HISTORY
13995
13996 =back
13997
13998 =head2 File::Compare - Compare files or filehandles
13999
14000 =over 4
14001
14002 =item SYNOPSIS
14003
14004 =item DESCRIPTION
14005
14006 =item RETURN
14007
14008 =item AUTHOR
14009
14010 =back
14011
14012 =head2 File::Copy - Copy files or filehandles
14013
14014 =over 4
14015
14016 =item SYNOPSIS
14017
14018 =item DESCRIPTION
14019
14020 =over 4
14021
14022 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
14023
14024 rmscopy($from,$to[,$date_flag])
14025
14026 =back
14027
14028 =item RETURN
14029
14030 =item NOTES
14031
14032 =item AUTHOR
14033
14034 =back
14035
14036 =head2 File::DosGlob - DOS like globbing and then some
14037
14038 =over 4
14039
14040 =item SYNOPSIS
14041
14042 =item DESCRIPTION
14043
14044 =item NOTES
14045
14046 =item EXPORTS (by request only)
14047
14048 =item BUGS
14049
14050 =item AUTHOR
14051
14052 =item HISTORY
14053
14054 =item SEE ALSO
14055
14056 =back
14057
14058 =head2 File::Find - Traverse a directory tree.
14059
14060 =over 4
14061
14062 =item SYNOPSIS
14063
14064 =item DESCRIPTION
14065
14066 B<find>, B<finddepth>
14067
14068 =over 4
14069
14070 =item %options
14071
14072 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
14073 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
14074 C<untaint>, C<untaint_pattern>, C<untaint_skip>
14075
14076 =item The wanted function
14077
14078 C<$File::Find::dir> is the current directory name,, C<$_> is the current
14079 filename within that directory, C<$File::Find::name> is the complete
14080 pathname to the file
14081
14082 =back
14083
14084 =item WARNINGS
14085
14086 =item CAVEAT
14087
14088 $dont_use_nlink, symlinks
14089
14090 =item NOTES
14091
14092 =item HISTORY
14093
14094 =back
14095
14096 =head2 File::Glob - Perl extension for BSD glob routine
14097
14098 =over 4
14099
14100 =item SYNOPSIS
14101
14102 =item DESCRIPTION
14103
14104 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
14105 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
14106 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
14107
14108 =item DIAGNOSTICS
14109
14110 C<GLOB_NOSPACE>, C<GLOB_ABEND>
14111
14112 =item NOTES
14113
14114 =item AUTHOR
14115
14116 =back
14117
14118 =head2 File::Path - create or remove directory trees
14119
14120 =over 4
14121
14122 =item SYNOPSIS
14123
14124 =item DESCRIPTION
14125
14126 =item DIAGNOSTICS
14127
14128 =item AUTHORS
14129
14130 =back
14131
14132 =head2 File::Spec - portably perform operations on file names
14133
14134 =over 4
14135
14136 =item SYNOPSIS
14137
14138 =item DESCRIPTION
14139
14140 =item METHODS
14141
14142 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
14143 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
14144 splitdir, catpath(), abs2rel, rel2abs()
14145
14146 =item SEE ALSO
14147
14148 =item AUTHORS
14149
14150 =back
14151
14152 =head2 File::Spec::Cygwin - methods for Cygwin file specs
14153
14154 =over 4
14155
14156 =item SYNOPSIS
14157
14158 =item DESCRIPTION
14159
14160 =back
14161
14162 canonpath
14163
14164 file_name_is_absolute
14165
14166 tmpdir (override)
14167
14168 =head2 File::Spec::Epoc - methods for Epoc file specs
14169
14170 =over 4
14171
14172 =item SYNOPSIS
14173
14174 =item DESCRIPTION
14175
14176 =item AUTHORS
14177
14178 =back
14179
14180 canonpath()
14181
14182 =over 4
14183
14184 =item SEE ALSO
14185
14186 =back
14187
14188 =head2 File::Spec::Functions - portably perform operations on file names
14189
14190 =over 4
14191
14192 =item SYNOPSIS
14193
14194 =item DESCRIPTION
14195
14196 =over 4
14197
14198 =item Exports
14199
14200 =back
14201
14202 =item SEE ALSO
14203
14204 =back
14205
14206 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
14207
14208 =over 4
14209
14210 =item SYNOPSIS
14211
14212 =item DESCRIPTION
14213
14214 =item METHODS
14215
14216 canonpath
14217
14218 =back
14219
14220 catdir()
14221
14222 catfile
14223
14224 curdir
14225
14226 devnull
14227
14228 rootdir
14229
14230 tmpdir
14231
14232 updir
14233
14234 file_name_is_absolute
14235
14236 path
14237
14238 splitpath
14239
14240 splitdir
14241
14242 catpath
14243
14244 abs2rel
14245
14246 rel2abs
14247
14248 =over 4
14249
14250 =item AUTHORS
14251
14252 =item SEE ALSO
14253
14254 =back
14255
14256 =head2 File::Spec::OS2 - methods for OS/2 file specs
14257
14258 =over 4
14259
14260 =item SYNOPSIS
14261
14262 =item DESCRIPTION
14263
14264 tmpdir, splitpath
14265
14266 =back
14267
14268 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
14269 modules
14270
14271 =over 4
14272
14273 =item SYNOPSIS
14274
14275 =item DESCRIPTION
14276
14277 =item METHODS
14278
14279 canonpath()
14280
14281 =back
14282
14283 catdir()
14284
14285 catfile
14286
14287 curdir
14288
14289 devnull
14290
14291 rootdir
14292
14293 tmpdir
14294
14295 updir
14296
14297 no_upwards
14298
14299 case_tolerant
14300
14301 file_name_is_absolute
14302
14303 path
14304
14305 join
14306
14307 splitpath
14308
14309 splitdir
14310
14311 catpath()
14312
14313 abs2rel
14314
14315 rel2abs()
14316
14317 =over 4
14318
14319 =item SEE ALSO
14320
14321 =back
14322
14323 =head2 File::Spec::VMS - methods for VMS file specs
14324
14325 =over 4
14326
14327 =item SYNOPSIS
14328
14329 =item DESCRIPTION
14330
14331 eliminate_macros
14332
14333 =back
14334
14335 fixpath
14336
14337 =over 4
14338
14339 =item Methods always loaded
14340
14341 canonpath (override)
14342
14343 =back
14344
14345 catdir
14346
14347 catfile
14348
14349 curdir (override)
14350
14351 devnull (override)
14352
14353 rootdir (override)
14354
14355 tmpdir (override)
14356
14357 updir (override)
14358
14359 case_tolerant (override)
14360
14361 path (override)
14362
14363 file_name_is_absolute (override)
14364
14365 splitpath (override)
14366
14367 splitdir (override)
14368
14369 catpath (override)
14370
14371 abs2rel (override)
14372
14373 rel2abs (override)
14374
14375 =over 4
14376
14377 =item SEE ALSO
14378
14379 =back
14380
14381 =head2 File::Spec::Win32 - methods for Win32 file specs
14382
14383 =over 4
14384
14385 =item SYNOPSIS
14386
14387 =item DESCRIPTION
14388
14389 devnull
14390
14391 =back
14392
14393 tmpdir
14394
14395 catfile
14396
14397 canonpath
14398
14399 splitpath
14400
14401 splitdir
14402
14403 catpath
14404
14405 =over 4
14406
14407 =item Note For File::Spec::Win32 Maintainers
14408
14409 =back
14410
14411 =over 4
14412
14413 =item SEE ALSO
14414
14415 =back
14416
14417 =head2 File::Temp - return name and handle of a temporary file safely
14418
14419 =over 4
14420
14421 =item PORTABILITY
14422
14423 =item SYNOPSIS
14424
14425 =item DESCRIPTION
14426
14427 =back
14428
14429 =over 4
14430
14431 =item OO INTERFACE
14432
14433 B<new>
14434
14435 =back
14436
14437 B<filename>
14438
14439 B<DESTROY>
14440
14441 =over 4
14442
14443 =item FUNCTIONS
14444
14445 B<tempfile>
14446
14447 =back
14448
14449 B<tempdir>
14450
14451 =over 4
14452
14453 =item MKTEMP FUNCTIONS
14454
14455 B<mkstemp>
14456
14457 =back
14458
14459 B<mkstemps>
14460
14461 B<mkdtemp>
14462
14463 B<mktemp>
14464
14465 =over 4
14466
14467 =item POSIX FUNCTIONS
14468
14469 B<tmpnam>
14470
14471 =back
14472
14473 B<tmpfile>
14474
14475 =over 4
14476
14477 =item ADDITIONAL FUNCTIONS
14478
14479 B<tempnam>
14480
14481 =back
14482
14483 =over 4
14484
14485 =item UTILITY FUNCTIONS
14486
14487 B<unlink0>
14488
14489 =back
14490
14491 B<cmpstat>
14492
14493 B<unlink1>
14494
14495 =over 4
14496
14497 =item PACKAGE VARIABLES
14498
14499 B<safe_level>, STANDARD, MEDIUM, HIGH
14500
14501 =back
14502
14503 TopSystemUID
14504
14505 =over 4
14506
14507 =item WARNING
14508
14509 =over 4
14510
14511 =item Temporary files and NFS
14512
14513 =back
14514
14515 =item HISTORY
14516
14517 =item SEE ALSO
14518
14519 =item AUTHOR
14520
14521 =back
14522
14523 =head2 File::stat - by-name interface to Perl's built-in stat() functions
14524
14525 =over 4
14526
14527 =item SYNOPSIS
14528
14529 =item DESCRIPTION
14530
14531 =item BUGS
14532
14533 =item NOTE
14534
14535 =item AUTHOR
14536
14537 =back
14538
14539 =head2 FileCache - keep more files open than the system permits
14540
14541 =over 4
14542
14543 =item SYNOPSIS
14544
14545 =item DESCRIPTION
14546
14547 cacheout EXPR, cacheout MODE, EXPR
14548
14549 =item CAVEATS
14550
14551 =item BUGS
14552
14553 =item NOTES
14554
14555 =back
14556
14557 =head2 FileHandle - supply object methods for filehandles
14558
14559 =over 4
14560
14561 =item SYNOPSIS
14562
14563 =item DESCRIPTION
14564
14565 $fh->print, $fh->printf, $fh->getline, $fh->getlines
14566
14567 =item SEE ALSO
14568
14569 =back
14570
14571 =head2 Filter::Simple - Simplified source filtering
14572
14573 =over 4
14574
14575 =item SYNOPSIS
14576
14577 =item DESCRIPTION
14578
14579 =over 4
14580
14581 =item The Problem
14582
14583 =item A Solution
14584
14585 =item Disabling or changing <no> behaviour
14586
14587 =item All-in-one interface
14588
14589 =item Filtering only specific components of source code
14590
14591 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
14592 C<"all">
14593
14594 =item Filtering only the code parts of source code
14595
14596 Most source code ceases to be grammatically correct when it is broken up
14597 into the pieces between string literals and regexes. So the C<'code'>
14598 component filter behaves slightly differently from the other partial
14599 filters
14600 described in the previous section.
14601
14602 =item Using Filter::Simple with an explicit C<import> subroutine
14603
14604 =item Using Filter::Simple and Exporter together
14605
14606 =item How it works
14607
14608 =back
14609
14610 =item AUTHOR
14611
14612 =item COPYRIGHT
14613
14614 =back
14615
14616 =head2 Filter::Util::Call - Perl Source Filter Utility Module
14617
14618 =over 4
14619
14620 =item SYNOPSIS
14621
14622 =item DESCRIPTION
14623
14624 =over 4
14625
14626 =item B<use Filter::Util::Call>
14627
14628 =item B<import()>
14629
14630 =item B<filter() and anonymous sub>
14631
14632 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
14633
14634 =back
14635
14636 =item EXAMPLES
14637
14638 =over 4
14639
14640 =item Example 1: A simple filter.
14641
14642 =item Example 2: Using the context
14643
14644 =item Example 3: Using the context within the filter
14645
14646 =item Example 4: Using filter_del
14647
14648 =back
14649
14650 =item Filter::Simple
14651
14652 =item AUTHOR
14653
14654 =item DATE
14655
14656 =back
14657
14658 =head2 FindBin - Locate directory of original perl script
14659
14660 =over 4
14661
14662 =item SYNOPSIS
14663
14664 =item DESCRIPTION
14665
14666 =item EXPORTABLE VARIABLES
14667
14668 =item KNOWN ISSUES
14669
14670 =item KNOWN BUGS
14671
14672 =item AUTHORS
14673
14674 =item COPYRIGHT
14675
14676 =back
14677
14678 =head2 GDBM_File - Perl5 access to the gdbm library.
14679
14680 =over 4
14681
14682 =item SYNOPSIS
14683
14684 =item DESCRIPTION
14685
14686 =item AVAILABILITY
14687
14688 =item BUGS
14689
14690 =item SEE ALSO
14691
14692 =back
14693
14694 =head2 Getopt::Long - Extended processing of command line options
14695
14696 =over 4
14697
14698 =item SYNOPSIS
14699
14700 =item DESCRIPTION
14701
14702 =item Command Line Options, an Introduction
14703
14704 =item Getting Started with Getopt::Long
14705
14706 =over 4
14707
14708 =item Simple options
14709
14710 =item A little bit less simple options
14711
14712 =item Mixing command line option with other arguments
14713
14714 =item Options with values
14715
14716 =item Options with multiple values
14717
14718 =item Options with hash values
14719
14720 =item User-defined subroutines to handle options
14721
14722 =item Options with multiple names
14723
14724 =item Case and abbreviations
14725
14726 =item Summary of Option Specifications
14727
14728 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
14729 + [ I<desttype> ]
14730
14731 =back
14732
14733 =item Advanced Possibilities
14734
14735 =over 4
14736
14737 =item Object oriented interface
14738
14739 =item Thread Safety
14740
14741 =item Documentation and help texts
14742
14743 =item Storing options in a hash
14744
14745 =item Bundling
14746
14747 =item The lonesome dash
14748
14749 =item Argument callback
14750
14751 =back
14752
14753 =item Configuring Getopt::Long
14754
14755 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
14756 require_order, permute, bundling (default: disabled), bundling_override
14757 (default: disabled), ignore_case  (default: enabled), ignore_case_always
14758 (default: disabled), auto_version (default:disabled), auto_help
14759 (default:disabled), pass_through (default: disabled), prefix,
14760 prefix_pattern, debug (default: disabled)
14761
14762 =item Exportable Methods
14763
14764 VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage
14765
14766 =item Return values and Errors
14767
14768 =item Legacy
14769
14770 =over 4
14771
14772 =item Default destinations
14773
14774 =item Alternative option starters
14775
14776 =item Configuration variables
14777
14778 =back
14779
14780 =item Trouble Shooting
14781
14782 =over 4
14783
14784 =item Warning: Ignoring '!' modifier for short option
14785
14786 =item GetOptions does not return a false result when an option is not
14787 supplied
14788
14789 =item GetOptions does not split the command line correctly
14790
14791 =item Undefined subroutine &main::GetOptions called
14792
14793 =item How do I put a "-?" option into a Getopt::Long?
14794
14795 =back
14796
14797 =item AUTHOR
14798
14799 =item COPYRIGHT AND DISCLAIMER
14800
14801 =back
14802
14803 =head2 Getopt::Std, getopt - Process single-character switches with switch
14804 clustering
14805
14806 =over 4
14807
14808 =item SYNOPSIS
14809
14810 =item DESCRIPTION
14811
14812 =item C<--help> and C<--version>
14813
14814 =back
14815
14816 =head2 Hash::Util - A selection of general-utility hash subroutines
14817
14818 =over 4
14819
14820 =item SYNOPSIS
14821
14822 =item DESCRIPTION
14823
14824 =over 4
14825
14826 =item Restricted hashes
14827
14828 lock_keys, unlock_keys
14829
14830 =back
14831
14832 =back
14833
14834 lock_value, unlock_value
14835
14836 B<lock_hash>, B<unlock_hash>
14837
14838 =over 4
14839
14840 =item CAVEATS
14841
14842 =item AUTHOR
14843
14844 =item SEE ALSO
14845
14846 =back
14847
14848 =head2 I18N::Collate - compare 8-bit scalar data according to the current
14849 locale
14850
14851 =over 4
14852
14853 =item SYNOPSIS
14854
14855 =item DESCRIPTION
14856
14857 =back
14858
14859 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
14860 tags
14861
14862 =over 4
14863
14864 =item SYNOPSIS
14865
14866 =item DESCRIPTION
14867
14868 =back
14869
14870 the function is_language_tag($lang1)
14871
14872 the function extract_language_tags($whatever)
14873
14874 the function same_language_tag($lang1, $lang2)
14875
14876 the function similarity_language_tag($lang1, $lang2)
14877
14878 the function is_dialect_of($lang1, $lang2)
14879
14880 the function super_languages($lang1)
14881
14882 the function locale2language_tag($locale_identifier)
14883
14884 the function encode_language_tag($lang1)
14885
14886 the function alternate_language_tags($lang1)
14887
14888 the function @langs = panic_languages(@accept_languages)
14889
14890 =over 4
14891
14892 =item ABOUT LOWERCASING
14893
14894 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
14895
14896 =item SEE ALSO
14897
14898 =item COPYRIGHT
14899
14900 =item AUTHOR
14901
14902 =back
14903
14904 =head2 I18N::LangTags::List -- tags and names for human languages
14905
14906 =over 4
14907
14908 =item SYNOPSIS
14909
14910 =item DESCRIPTION
14911
14912 =item ABOUT LANGUAGE TAGS
14913
14914 =item LIST OF LANGUAGES
14915
14916 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} :
14917 Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} :
14918 Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian,
14919 {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)],
14920 {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic,
14921 {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy}
14922 : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} :
14923 Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} :
14924 Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae}
14925 : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} :
14926 Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai}
14927 : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} :
14928 Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} :
14929 Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber
14930 (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini,
14931 {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} :
14932 Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} :
14933 Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian
14934 (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central
14935 American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages],
14936 {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb}
14937 : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} :
14938 Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} :
14939 Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree,
14940 {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf}
14941 : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based
14942 Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} :
14943 Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} :
14944 Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru)
14945 Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri,
14946 {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch,
14947 {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi}
14948 : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} :
14949 English, {enm} : Old English (1100-1500), {ang} : Old English
14950 (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} :
14951 Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat}
14952 : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} :
14953 Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French
14954 (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} :
14955 Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan,
14956 {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian,
14957 {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High
14958 German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon}
14959 : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient
14960 Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} :
14961 Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian,
14962 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
14963 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
14964 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo,
14965 {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European
14966 (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua
14967 (International Auxiliary Language Association), {ie} : Interlingue, {iu} :
14968 Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} :
14969 Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian
14970 languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} :
14971 Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle,
14972 {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} :
14973 Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar}
14974 : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh,
14975 {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese,
14976 {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz,
14977 {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} :
14978 Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama,
14979 {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} :
14980 Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} :
14981 Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} :
14982 Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban
14983 (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui}
14984 : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai,
14985 {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili,
14986 {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} :
14987 Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} :
14988 Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} :
14989 Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai,
14990 [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} :
14991 Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} :
14992 Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)],
14993 {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple
14994 languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan,
14995 {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele,
14996 {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
14997 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
14998 {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} :
14999 Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} :
15000 Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi}
15001 : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} :
15002 Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
15003 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
15004 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
15005 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
15006 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
15007 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
15008 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
15009 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
15010 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
15011 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
15012 languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} :
15013 Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami,
15014 [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} :
15015 Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak,
15016 {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian,
15017 {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign
15018 Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} :
15019 Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave
15020 (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian,
15021 {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} :
15022 Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} :
15023 South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} :
15024 Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati,
15025 {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} :
15026 Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao,
15027 {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} :
15028 Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} :
15029 Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau,
15030 {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian,
15031 {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} :
15032 Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh}
15033 : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} :
15034 Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian,
15035 {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} :
15036 Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak}
15037 : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was}
15038 : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private
15039 Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} :
15040 Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
15041 : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu,
15042 {zun} : Zuni
15043
15044 =item SEE ALSO
15045
15046 =item COPYRIGHT AND DISCLAIMER
15047
15048 =item AUTHOR
15049
15050 =back
15051
15052 =head2 I18N::Langinfo - query locale information
15053
15054 =over 4
15055
15056 =item SYNOPSIS
15057
15058 =item DESCRIPTION
15059
15060 =over 4
15061
15062 =item EXPORT
15063
15064 =back
15065
15066 =item SEE ALSO
15067
15068 =item AUTHOR
15069
15070 =item COPYRIGHT AND LICENSE
15071
15072 =back
15073
15074 =head2 IO - load various IO modules
15075
15076 =over 4
15077
15078 =item SYNOPSIS
15079
15080 =item DESCRIPTION
15081
15082 =item DEPRECATED
15083
15084 =back
15085
15086 =head2 IO::Dir - supply object methods for directory handles
15087
15088 =over 4
15089
15090 =item SYNOPSIS
15091
15092 =item DESCRIPTION
15093
15094 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
15095 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
15096
15097 =item SEE ALSO
15098
15099 =item AUTHOR
15100
15101 =item COPYRIGHT
15102
15103 =back
15104
15105 =head2 IO::File - supply object methods for filehandles
15106
15107 =over 4
15108
15109 =item SYNOPSIS
15110
15111 =item DESCRIPTION
15112
15113 =item CONSTRUCTOR
15114
15115 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
15116
15117 =item METHODS
15118
15119 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
15120
15121 =item SEE ALSO
15122
15123 =item HISTORY
15124
15125 =back
15126
15127 =head2 IO::Handle - supply object methods for I/O handles
15128
15129 =over 4
15130
15131 =item SYNOPSIS
15132
15133 =item DESCRIPTION
15134
15135 =item CONSTRUCTOR
15136
15137 new (), new_from_fd ( FD, MODE )
15138
15139 =item METHODS
15140
15141 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
15142 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
15143 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
15144 $io->blocking ( [ BOOL ] ), $io->untaint
15145
15146 =item NOTE
15147
15148 =item SEE ALSO
15149
15150 =item BUGS
15151
15152 =item HISTORY
15153
15154 =back
15155
15156 =head2 IO::Pipe - supply object methods for pipes
15157
15158 =over 4
15159
15160 =item SYNOPSIS
15161
15162 =item DESCRIPTION
15163
15164 =item CONSTRUCTOR
15165
15166 new ( [READER, WRITER] )
15167
15168 =item METHODS
15169
15170 reader ([ARGS]), writer ([ARGS]), handles ()
15171
15172 =item SEE ALSO
15173
15174 =item AUTHOR
15175
15176 =item COPYRIGHT
15177
15178 =back
15179
15180 =head2 IO::Poll - Object interface to system poll call
15181
15182 =over 4
15183
15184 =item SYNOPSIS
15185
15186 =item DESCRIPTION
15187
15188 =item METHODS
15189
15190 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
15191 IO ), handles( [ EVENT_MASK ] )
15192
15193 =item SEE ALSO
15194
15195 =item AUTHOR
15196
15197 =item COPYRIGHT
15198
15199 =back
15200
15201 =head2 IO::Seekable - supply seek based methods for I/O objects
15202
15203 =over 4
15204
15205 =item SYNOPSIS
15206
15207 =item DESCRIPTION
15208
15209 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
15210 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
15211 $io->tell
15212
15213 =item SEE ALSO
15214
15215 =item HISTORY
15216
15217 =back
15218
15219 =head2 IO::Select - OO interface to the select system call
15220
15221 =over 4
15222
15223 =item SYNOPSIS
15224
15225 =item DESCRIPTION
15226
15227 =item CONSTRUCTOR
15228
15229 new ( [ HANDLES ] )
15230
15231 =item METHODS
15232
15233 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
15234 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
15235 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
15236
15237 =item EXAMPLE
15238
15239 =item AUTHOR
15240
15241 =item COPYRIGHT
15242
15243 =back
15244
15245 =head2 IO::Socket - Object interface to socket communications
15246
15247 =over 4
15248
15249 =item SYNOPSIS
15250
15251 =item DESCRIPTION
15252
15253 =item CONSTRUCTOR
15254
15255 new ( [ARGS] )
15256
15257 =item METHODS
15258
15259 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
15260 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
15261
15262 =item SEE ALSO
15263
15264 =item AUTHOR
15265
15266 =item COPYRIGHT
15267
15268 =back
15269
15270 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
15271
15272 =over 4
15273
15274 =item SYNOPSIS
15275
15276 =item DESCRIPTION
15277
15278 =item CONSTRUCTOR
15279
15280 new ( [ARGS] )
15281
15282 =over 4
15283
15284 =item METHODS
15285
15286 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
15287 ()
15288
15289 =back
15290
15291 =item SEE ALSO
15292
15293 =item AUTHOR
15294
15295 =item COPYRIGHT
15296
15297 =back
15298
15299 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
15300
15301 =over 4
15302
15303 =item SYNOPSIS
15304
15305 =item DESCRIPTION
15306
15307 =item CONSTRUCTOR
15308
15309 new ( [ARGS] )
15310
15311 =item METHODS
15312
15313 hostpath(), peerpath()
15314
15315 =item SEE ALSO
15316
15317 =item AUTHOR
15318
15319 =item COPYRIGHT
15320
15321 =back
15322
15323 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
15324 handles
15325
15326 =over 4
15327
15328 =item SYNOPSIS
15329
15330 =item DESCRIPTION
15331
15332 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
15333 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
15334
15335 =item SEE ALSO
15336
15337 =item AUTHOR
15338
15339 =item COPYRIGHT
15340
15341 =back
15342
15343 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
15344
15345 =over 4
15346
15347 =item SYNOPSIS
15348
15349 =item DESCRIPTION
15350
15351 =item CONSTRUCTOR
15352
15353 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
15354
15355 =item METHODS
15356
15357 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
15358
15359 =item SEE ALSO
15360
15361 =item HISTORY
15362
15363 =back
15364
15365 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
15366 handles
15367
15368 =over 4
15369
15370 =item SYNOPSIS
15371
15372 =item DESCRIPTION
15373
15374 =item CONSTRUCTOR
15375
15376 new (), new_from_fd ( FD, MODE )
15377
15378 =item METHODS
15379
15380 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
15381 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
15382 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
15383 $io->blocking ( [ BOOL ] ), $io->untaint
15384
15385 =item NOTE
15386
15387 =item SEE ALSO
15388
15389 =item BUGS
15390
15391 =item HISTORY
15392
15393 =back
15394
15395 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
15396
15397 =over 4
15398
15399 =item SYNOPSIS
15400
15401 =item DESCRIPTION
15402
15403 =item CONSTRUCTOR
15404
15405 new ( [READER, WRITER] )
15406
15407 =item METHODS
15408
15409 reader ([ARGS]), writer ([ARGS]), handles ()
15410
15411 =item SEE ALSO
15412
15413 =item AUTHOR
15414
15415 =item COPYRIGHT
15416
15417 =back
15418
15419 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
15420
15421 =over 4
15422
15423 =item SYNOPSIS
15424
15425 =item DESCRIPTION
15426
15427 =item METHODS
15428
15429 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
15430 IO ), handles( [ EVENT_MASK ] )
15431
15432 =item SEE ALSO
15433
15434 =item AUTHOR
15435
15436 =item COPYRIGHT
15437
15438 =back
15439
15440 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
15441 I/O objects
15442
15443 =over 4
15444
15445 =item SYNOPSIS
15446
15447 =item DESCRIPTION
15448
15449 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
15450 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
15451 $io->tell
15452
15453 =item SEE ALSO
15454
15455 =item HISTORY
15456
15457 =back
15458
15459 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
15460 call
15461
15462 =over 4
15463
15464 =item SYNOPSIS
15465
15466 =item DESCRIPTION
15467
15468 =item CONSTRUCTOR
15469
15470 new ( [ HANDLES ] )
15471
15472 =item METHODS
15473
15474 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
15475 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
15476 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
15477
15478 =item EXAMPLE
15479
15480 =item AUTHOR
15481
15482 =item COPYRIGHT
15483
15484 =back
15485
15486 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
15487 communications
15488
15489 =over 4
15490
15491 =item SYNOPSIS
15492
15493 =item DESCRIPTION
15494
15495 =item CONSTRUCTOR
15496
15497 new ( [ARGS] )
15498
15499 =item METHODS
15500
15501 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
15502 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
15503
15504 =item SEE ALSO
15505
15506 =item AUTHOR
15507
15508 =item COPYRIGHT
15509
15510 =back
15511
15512 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
15513 AF_INET domain sockets
15514
15515 =over 4
15516
15517 =item SYNOPSIS
15518
15519 =item DESCRIPTION
15520
15521 =item CONSTRUCTOR
15522
15523 new ( [ARGS] )
15524
15525 =over 4
15526
15527 =item METHODS
15528
15529 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
15530 ()
15531
15532 =back
15533
15534 =item SEE ALSO
15535
15536 =item AUTHOR
15537
15538 =item COPYRIGHT
15539
15540 =back
15541
15542 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
15543 AF_UNIX domain sockets
15544
15545 =over 4
15546
15547 =item SYNOPSIS
15548
15549 =item DESCRIPTION
15550
15551 =item CONSTRUCTOR
15552
15553 new ( [ARGS] )
15554
15555 =item METHODS
15556
15557 hostpath(), peerpath()
15558
15559 =item SEE ALSO
15560
15561 =item AUTHOR
15562
15563 =item COPYRIGHT
15564
15565 =back
15566
15567 =head2 IPC::Msg - SysV Msg IPC object class
15568
15569 =over 4
15570
15571 =item SYNOPSIS
15572
15573 =item DESCRIPTION
15574
15575 =item METHODS
15576
15577 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
15578 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
15579 FLAGS ] ), stat
15580
15581 =item SEE ALSO
15582
15583 =item AUTHOR
15584
15585 =item COPYRIGHT
15586
15587 =back
15588
15589 =head2 IPC::Open2, open2 - open a process for both reading and writing
15590
15591 =over 4
15592
15593 =item SYNOPSIS
15594
15595 =item DESCRIPTION
15596
15597 =item WARNING 
15598
15599 =item SEE ALSO
15600
15601 =back
15602
15603 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
15604 handling
15605
15606 =over 4
15607
15608 =item SYNOPSIS
15609
15610 =item DESCRIPTION
15611
15612 =item WARNING
15613
15614 =back
15615
15616 =head2 IPC::Semaphore - SysV Semaphore IPC object class
15617
15618 =over 4
15619
15620 =item SYNOPSIS
15621
15622 =item DESCRIPTION
15623
15624 =item METHODS
15625
15626 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
15627 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
15628 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
15629 , VALUE ), stat
15630
15631 =item SEE ALSO
15632
15633 =item AUTHOR
15634
15635 =item COPYRIGHT
15636
15637 =back
15638
15639 =head2 IPC::SysV - SysV IPC constants
15640
15641 =over 4
15642
15643 =item SYNOPSIS
15644
15645 =item DESCRIPTION
15646
15647 ftok( PATH, ID )
15648
15649 =item SEE ALSO
15650
15651 =item AUTHORS
15652
15653 =item COPYRIGHT
15654
15655 =back
15656
15657 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
15658
15659 =over 4
15660
15661 =item SYNOPSIS
15662
15663 =item DESCRIPTION
15664
15665 =item METHODS
15666
15667 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
15668 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
15669 FLAGS ] ), stat
15670
15671 =item SEE ALSO
15672
15673 =item AUTHOR
15674
15675 =item COPYRIGHT
15676
15677 =back
15678
15679 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
15680 class
15681
15682 =over 4
15683
15684 =item SYNOPSIS
15685
15686 =item DESCRIPTION
15687
15688 =item METHODS
15689
15690 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
15691 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
15692 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
15693 , VALUE ), stat
15694
15695 =item SEE ALSO
15696
15697 =item AUTHOR
15698
15699 =item COPYRIGHT
15700
15701 =back
15702
15703 =head2 List::Util - A selection of general-utility list subroutines
15704
15705 =over 4
15706
15707 =item SYNOPSIS
15708
15709 =item DESCRIPTION
15710
15711 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
15712 BLOCK LIST, shuffle LIST, sum LIST
15713
15714 =item KNOWN BUGS
15715
15716 =item SUGGESTED ADDITIONS
15717
15718 =item COPYRIGHT
15719
15720 =back
15721
15722 =head2 List::Utilib::List::Util, List::Util - A selection of
15723 general-utility list subroutines
15724
15725 =over 4
15726
15727 =item SYNOPSIS
15728
15729 =item DESCRIPTION
15730
15731 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
15732 BLOCK LIST, shuffle LIST, sum LIST
15733
15734 =item KNOWN BUGS
15735
15736 =item SUGGESTED ADDITIONS
15737
15738 =item COPYRIGHT
15739
15740 =back
15741
15742 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
15743 general-utility scalar subroutines
15744
15745 =over 4
15746
15747 =item SYNOPSIS
15748
15749 =item DESCRIPTION
15750
15751 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
15752 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
15753 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
15754
15755 =item KNOWN BUGS
15756
15757 =item COPYRIGHT
15758
15759 =item BLATANT PLUG
15760
15761 =back
15762
15763 =head2 Locale::Constants - constants for Locale codes
15764
15765 =over 4
15766
15767 =item SYNOPSIS
15768
15769 =item DESCRIPTION
15770
15771 =item KNOWN BUGS AND LIMITATIONS
15772
15773 =item SEE ALSO
15774
15775 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
15776
15777 =item AUTHOR
15778
15779 =item COPYRIGHT
15780
15781 =back
15782
15783 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
15784
15785 =over 4
15786
15787 =item SYNOPSIS
15788
15789 =item DESCRIPTION
15790
15791 B<alpha-2>, B<alpha-3>, B<numeric>
15792
15793 =item CONVERSION ROUTINES
15794
15795 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
15796 country_code2code( CODE, CODESET, CODESET )
15797
15798 =item QUERY ROUTINES
15799
15800 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
15801
15802 =item SEMI-PRIVATE ROUTINES
15803
15804 =over 4
15805
15806 =item alias_code
15807
15808 =item rename_country
15809
15810 =back
15811
15812 =item EXAMPLES
15813
15814 =item DOMAIN NAMES
15815
15816 =item KNOWN BUGS AND LIMITATIONS
15817
15818 =item SEE ALSO
15819
15820 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
15821 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
15822 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
15823 http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
15824
15825 =item AUTHOR
15826
15827 =item COPYRIGHT
15828
15829 =back
15830
15831 =head2 Locale::Currency - ISO three letter codes for currency
15832 identification (ISO 4217)
15833
15834 =over 4
15835
15836 =item SYNOPSIS
15837
15838 =item DESCRIPTION
15839
15840 XTS, XXX
15841
15842 =item CONVERSION ROUTINES
15843
15844 code2currency(), currency2code()
15845
15846 =item QUERY ROUTINES
15847
15848 C<all_currency_codes()>, C<all_currency_names()>
15849
15850 =item EXAMPLES
15851
15852 =item KNOWN BUGS AND LIMITATIONS
15853
15854 =item SEE ALSO
15855
15856 Locale::Country, Locale::Script, ISO 4217:1995,
15857 http://www.bsi-global.com/iso4217currency
15858
15859 =item AUTHOR
15860
15861 =item COPYRIGHT
15862
15863 =back
15864
15865 =head2 Locale::Language - ISO two letter codes for language identification
15866 (ISO 639)
15867
15868 =over 4
15869
15870 =item SYNOPSIS
15871
15872 =item DESCRIPTION
15873
15874 =item CONVERSION ROUTINES
15875
15876 code2language(), language2code()
15877
15878 =item QUERY ROUTINES
15879
15880 C<all_language_codes()>, C<all_language_names()>
15881
15882 =item EXAMPLES
15883
15884 =item KNOWN BUGS AND LIMITATIONS
15885
15886 =item SEE ALSO
15887
15888 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
15889 http://lcweb.loc.gov/standards/iso639-2/langhome.html
15890
15891 =item AUTHOR
15892
15893 =item COPYRIGHT
15894
15895 =back
15896
15897 =head2 Locale::Maketext - framework for localization
15898
15899 =over 4
15900
15901 =item SYNOPSIS
15902
15903 =item DESCRIPTION
15904
15905 =item QUICK OVERVIEW
15906
15907 =item METHODS
15908
15909 =over 4
15910
15911 =item Construction Methods
15912
15913 =item The "maketext" Method
15914
15915 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
15916
15917 =item Utility Methods
15918
15919 $language->quant($number, $singular), $language->quant($number, $singular,
15920 $plural), $language->quant($number, $singular, $plural, $negative),
15921 $language->numf($number), $language->sprintf($format, @items),
15922 $language->language_tag(), $language->encoding()
15923
15924 =item Language Handle Attributes and Internals
15925
15926 =back
15927
15928 =item LANGUAGE CLASS HIERARCHIES
15929
15930 =item ENTRIES IN EACH LEXICON
15931
15932 =item BRACKET NOTATION
15933
15934 =item AUTO LEXICONS
15935
15936 =item CONTROLLING LOOKUP FAILURE
15937
15938 =item HOW TO USE MAKETEXT
15939
15940 =item SEE ALSO
15941
15942 =item COPYRIGHT AND DISCLAIMER
15943
15944 =item AUTHOR
15945
15946 =back
15947
15948 =head2 Locale::Maketext::TPJ13 -- article about software localization
15949
15950 =over 4
15951
15952 =item SYNOPSIS
15953
15954 =item DESCRIPTION
15955
15956 =item Localization and Perl: gettext breaks, Maketext fixes
15957
15958 =over 4
15959
15960 =item A Localization Horror Story: It Could Happen To You
15961
15962 =item The Linguistic View
15963
15964 =item Breaking gettext
15965
15966 =item Replacing gettext
15967
15968 =item Buzzwords: Abstraction and Encapsulation
15969
15970 =item Buzzword: Isomorphism
15971
15972 =item Buzzword: Inheritance
15973
15974 =item Buzzword: Concision
15975
15976 =item The Devil in the Details
15977
15978 =item The Proof in the Pudding: Localizing Web Sites
15979
15980 =item References
15981
15982 =back
15983
15984 =back
15985
15986 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
15987
15988 =over 4
15989
15990 =item SYNOPSIS
15991
15992 =item DESCRIPTION
15993
15994 B<alpha-2>, B<alpha-3>, B<numeric>
15995
15996 =over 4
15997
15998 =item SPECIAL CODES
15999
16000 =back
16001
16002 =item CONVERSION ROUTINES
16003
16004 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
16005 script_code2code( CODE, CODESET, CODESET )
16006
16007 =item QUERY ROUTINES
16008
16009 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
16010
16011 =item EXAMPLES
16012
16013 =item KNOWN BUGS AND LIMITATIONS
16014
16015 =item SEE ALSO
16016
16017 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
16018 http://www.evertype.com/standards/iso15924/
16019
16020 =item AUTHOR
16021
16022 =item COPYRIGHT
16023
16024 =back
16025
16026 =head2 MIME::Base64 - Encoding and decoding of base64 strings
16027
16028 =over 4
16029
16030 =item SYNOPSIS
16031
16032 =item DESCRIPTION
16033
16034 encode_base64($str), encode_base64($str, $eol);, decode_base64($str)
16035
16036 =item DIAGNOSTICS
16037
16038 Premature end of base64 data, Premature padding of base64 data
16039
16040 =item EXAMPLES
16041
16042 =item COPYRIGHT
16043
16044 =back
16045
16046 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
16047 of quoted-printable strings
16048
16049 =over 4
16050
16051 =item SYNOPSIS
16052
16053 =item DESCRIPTION
16054
16055 encode_qp($str), encode_qp($str, $eol), decode_qp($str);
16056
16057 =item COPYRIGHT
16058
16059 =back
16060
16061 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
16062 strings
16063
16064 =over 4
16065
16066 =item SYNOPSIS
16067
16068 =item DESCRIPTION
16069
16070 encode_qp($str), encode_qp($str, $eol), decode_qp($str);
16071
16072 =item COPYRIGHT
16073
16074 =back
16075
16076 =head2 Math::BigFloat - Arbitrary size floating point math package
16077
16078 =over 4
16079
16080 =item SYNOPSIS
16081
16082 =item DESCRIPTION
16083
16084 =over 4
16085
16086 =item Canonical notation
16087
16088 =item Output
16089
16090 =item C<mantissa()>, C<exponent()> and C<parts()>
16091
16092 =item Accuracy vs. Precision
16093
16094 =item Rounding
16095
16096 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
16097 ), fround  ( -$scale ) and fround ( 0 )
16098
16099 =back
16100
16101 =item EXAMPLES
16102
16103   # not ready yet
16104
16105 =item Autocreating constants
16106
16107 =over 4
16108
16109 =item Math library
16110
16111 =item Using Math::BigInt::Lite
16112
16113 =back
16114
16115 =item BUGS
16116
16117 =item CAVEATS
16118
16119 stringify, bstr(), bdiv, Modifying and =, bpow
16120
16121 =item SEE ALSO
16122
16123 =item LICENSE
16124
16125 =item AUTHORS
16126
16127 =back
16128
16129 =head2 Math::BigInt - Arbitrary size integer math package
16130
16131 =over 4
16132
16133 =item SYNOPSIS
16134
16135 =item DESCRIPTION
16136
16137 Canonical notation, Input, Output
16138
16139 =item METHODS
16140
16141 =over 4
16142
16143 =item config
16144
16145 =item accuracy
16146
16147 =item precision
16148
16149 =item brsft
16150
16151 =item new
16152
16153 =item bnan
16154
16155 =item bzero
16156
16157 =item binf
16158
16159 =item bone
16160
16161 =item is_one()/is_zero()/is_nan()/is_inf()
16162
16163 =item is_positive()/is_negative()
16164
16165         $x->is_positive();              # true if >= 0
16166         $x->is_negative();              # true if <  0
16167
16168 =item is_odd()/is_even()/is_int()
16169
16170 =item bcmp
16171
16172 =item bacmp
16173
16174 =item sign
16175
16176 =item bcmp
16177
16178 =item bneg
16179
16180 =item babs
16181
16182 =item bnorm
16183
16184 =item bnot
16185
16186 =item binc
16187
16188 =item bdec
16189
16190 =item badd
16191
16192 =item bsub
16193
16194 =item bmul
16195
16196 =item bdiv
16197
16198 =item bmod
16199
16200 =item bmodinv
16201
16202 =item bmodpow
16203
16204 =item bpow
16205
16206 =item blsft
16207
16208 =item brsft
16209
16210 =item band
16211
16212 =item bior
16213
16214 =item bxor
16215
16216 =item bnot
16217
16218 =item bsqrt
16219
16220 =item bfac
16221
16222 =item round
16223
16224 =item bround
16225
16226 =item bfround
16227
16228 =item bfloor
16229
16230 =item bceil
16231
16232 =item bgcd
16233
16234 =item blcm
16235
16236 =item exponent
16237
16238 =item mantissa
16239
16240 =item parts
16241
16242 =item copy
16243
16244 =item as_number
16245
16246 =item bsstr
16247
16248 =item as_hex
16249
16250 =item as_bin
16251
16252 =back
16253
16254 =item ACCURACY and PRECISION
16255
16256 =over 4
16257
16258 =item Precision P
16259
16260 =item Accuracy A
16261
16262 =item Fallback F
16263
16264 =item Rounding mode R
16265
16266 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
16267 (significant digits), Setting/Accessing, Creating numbers, Usage,
16268 Precedence, Overriding globals, Local settings, Rounding, Default values,
16269 Remarks
16270
16271 =back
16272
16273 =item INTERNALS
16274
16275 =over 4
16276
16277 =item MATH LIBRARY
16278
16279 =item SIGN
16280
16281 =item mantissa(), exponent() and parts()
16282
16283 =back
16284
16285 =item EXAMPLES
16286
16287   use Math::BigInt;
16288
16289 =item Autocreating constants
16290
16291 =item PERFORMANCE
16292
16293 =over 4
16294
16295 =item Alternative math libraries
16296
16297 =item SUBCLASSING
16298
16299 =back
16300
16301 =item Subclassing Math::BigInt
16302
16303 =item UPGRADING
16304
16305 =over 4
16306
16307 =item Auto-upgrade
16308
16309 bsqrt(), div(), blog()
16310
16311 =back
16312
16313 =item BUGS
16314
16315 broot() does not work, Out of Memory!, Fails to load Calc on Perl prior
16316 5.6.0
16317
16318 =item CAVEATS
16319
16320 stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
16321 handling, Modifying and =, bpow, Overloading -$x, Mixing different object
16322 types, bsqrt(), brsft()
16323
16324 =item LICENSE
16325
16326 =item SEE ALSO
16327
16328 =item AUTHORS
16329
16330 =back
16331
16332 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
16333
16334 =over 4
16335
16336 =item SYNOPSIS
16337
16338 =item DESCRIPTION
16339
16340 =item STORAGE
16341
16342 =item METHODS
16343
16344 =item WRAP YOUR OWN
16345
16346 =item LICENSE
16347
16348 This program is free software; you may redistribute it and/or modify it
16349 under
16350 the same terms as Perl itself. 
16351
16352 =item AUTHORS
16353
16354 =item SEE ALSO
16355
16356 =back
16357
16358 =head2 Math::BigInt::Scalar - Pure Perl module to test Math::BigInt with
16359 scalars
16360
16361 =over 4
16362
16363 =item SYNOPSIS
16364
16365 =item DESCRIPTION
16366
16367 =item LICENSE
16368
16369 This program is free software; you may redistribute it and/or modify it
16370 under
16371 the same terms as Perl itself. 
16372
16373 =item AUTHOR
16374
16375 =item SEE ALSO
16376
16377 =back
16378
16379 =head2 Math::BigRat - arbitrarily big rationals
16380
16381 =over 4
16382
16383 =item SYNOPSIS
16384
16385 =item DESCRIPTION
16386
16387 =over 4
16388
16389 =item MATH LIBRARY
16390
16391 =back
16392
16393 =item METHODS
16394
16395 =over 4
16396
16397 =item new()
16398
16399 =item numerator()
16400
16401 =item denominator()
16402
16403         $d = $x->denominator();
16404
16405 =item parts()
16406
16407 =item as_number()
16408
16409 =item bfac()
16410
16411 =item blog()
16412
16413 =item bround()/round()/bfround()
16414
16415 =item bmod()
16416
16417 =item is_one()
16418
16419 =item is_zero()
16420
16421 =item is_positive()
16422
16423 =item is_negative()
16424
16425 =item is_int()
16426
16427 =item is_odd()
16428
16429 =item is_even()
16430
16431 =item bceil()
16432
16433 =item bfloor()
16434
16435         $x->bfloor();
16436
16437 =item config
16438
16439 =back
16440
16441 =item BUGS
16442
16443 inf handling (partial), NaN handling (partial), rounding (not implemented
16444 except for bceil/bfloor), $x ** $y where $y is not an integer
16445
16446 =item LICENSE
16447
16448 =item SEE ALSO
16449
16450 =item AUTHORS
16451
16452 =back
16453
16454 =head2 Math::Complex - complex numbers and associated mathematical
16455 functions
16456
16457 =over 4
16458
16459 =item SYNOPSIS
16460
16461 =item DESCRIPTION
16462
16463 =item OPERATIONS
16464
16465 =item CREATION
16466
16467 =item STRINGIFICATION
16468
16469 =over 4
16470
16471 =item CHANGED IN PERL 5.6
16472
16473 =back
16474
16475 =item USAGE
16476
16477 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
16478
16479 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
16480
16481 =item BUGS
16482
16483 =item AUTHORS
16484
16485 =back
16486
16487 =head2 Math::Trig - trigonometric functions
16488
16489 =over 4
16490
16491 =item SYNOPSIS
16492
16493 =item DESCRIPTION
16494
16495 =item TRIGONOMETRIC FUNCTIONS
16496
16497 B<tan>
16498
16499 =over 4
16500
16501 =item ERRORS DUE TO DIVISION BY ZERO
16502
16503 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
16504
16505 =back
16506
16507 =item PLANE ANGLE CONVERSIONS
16508
16509 =item RADIAL COORDINATE CONVERSIONS
16510
16511 =over 4
16512
16513 =item COORDINATE SYSTEMS
16514
16515 =item 3-D ANGLE CONVERSIONS
16516
16517 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
16518 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
16519
16520 =back
16521
16522 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
16523
16524 =item EXAMPLES
16525
16526 =over 4
16527
16528 =item CAVEAT FOR GREAT CIRCLE FORMULAS
16529
16530 =back
16531
16532 =item BUGS
16533
16534 =item AUTHORS
16535
16536 =back
16537
16538 =head2 Memoize - Make functions faster by trading space for time
16539
16540 =over 4
16541
16542 =item SYNOPSIS
16543
16544 =item DESCRIPTION
16545
16546 =item DETAILS
16547
16548 =item OPTIONS
16549
16550 =over 4
16551
16552 =item INSTALL
16553
16554 =item NORMALIZER
16555
16556 =item C<SCALAR_CACHE>, C<LIST_CACHE>
16557
16558 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
16559
16560 =back
16561
16562 =item OTHER FACILITIES
16563
16564 =over 4
16565
16566 =item C<unmemoize>
16567
16568 =item C<flush_cache>
16569
16570 =back
16571
16572 =item CAVEATS
16573
16574 =item PERSISTENT CACHE SUPPORT
16575
16576 =item EXPIRATION SUPPORT
16577
16578 =item BUGS
16579
16580 =item MAILING LIST
16581
16582 =item AUTHOR
16583
16584 =item COPYRIGHT AND LICENSE
16585
16586 =item THANK YOU
16587
16588 =back
16589
16590 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
16591 Storable use
16592
16593 =over 4
16594
16595 =item DESCRIPTION
16596
16597 =back
16598
16599 =head2 Memoize::Expire - Plug-in module for automatic expiration of
16600 memoized values
16601
16602 =over 4
16603
16604 =item SYNOPSIS
16605
16606 =item DESCRIPTION
16607
16608 =item INTERFACE
16609
16610  TIEHASH,  EXISTS,  STORE
16611
16612 =item ALTERNATIVES
16613
16614 =item CAVEATS
16615
16616 =item AUTHOR
16617
16618 =item SEE ALSO
16619
16620 =back
16621
16622 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
16623
16624 =over 4
16625
16626 =item DESCRIPTION
16627
16628 =back
16629
16630 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
16631
16632 =over 4
16633
16634 =item DESCRIPTION
16635
16636 =back
16637
16638 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
16639 Storable use
16640
16641 =over 4
16642
16643 =item DESCRIPTION
16644
16645 =back
16646
16647 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
16648 Storable use
16649
16650 =over 4
16651
16652 =item DESCRIPTION
16653
16654 =back
16655
16656 =head2 Memoize::Storable - store Memoized data in Storable database
16657
16658 =over 4
16659
16660 =item DESCRIPTION
16661
16662 =back
16663
16664 =head2 NDBM_File - Tied access to ndbm files
16665
16666 =over 4
16667
16668 =item SYNOPSIS
16669
16670 =item DESCRIPTION
16671
16672 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
16673
16674 =item DIAGNOSTICS
16675
16676 =over 4
16677
16678 =item C<ndbm store returned -1, errno 22, key "..." at ...>
16679
16680 =back
16681
16682 =item BUGS AND WARNINGS
16683
16684 =back
16685
16686 =head2 NEXT - Provide a pseudo-class NEXT (et al) that allows method
16687 redispatch
16688
16689 =over 4
16690
16691 =item SYNOPSIS
16692
16693 =item DESCRIPTION
16694
16695 =over 4
16696
16697 =item Enforcing redispatch
16698
16699 =item Avoiding repetitions
16700
16701 =item Invoking all versions of a method with a single call
16702
16703 =item Using C<EVERY> methods
16704
16705 =back
16706
16707 =item AUTHOR
16708
16709 =item BUGS AND IRRITATIONS
16710
16711 =item COPYRIGHT
16712
16713 =back
16714
16715 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
16716
16717 =over 4
16718
16719 =item SYNOPSIS
16720
16721 =item DESCRIPTION
16722
16723 =item USER METHODS
16724
16725 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
16726 dataend ()
16727
16728 =item CLASS METHODS
16729
16730 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
16731 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
16732 ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh ()
16733
16734 =item EXPORTS
16735
16736 =item AUTHOR
16737
16738 =item COPYRIGHT
16739
16740 =back
16741
16742 =head2 Net::Config - Local configuration data for libnet
16743
16744 =over 4
16745
16746 =item SYNOPSYS
16747
16748 =item DESCRIPTION
16749
16750 =item METHODS
16751
16752 requires_firewall HOST
16753
16754 =item NetConfig VALUES
16755
16756 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
16757 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
16758 ftp_int_pasive, local_netmask, test_hosts, test_exists
16759
16760 =back
16761
16762 =head2 Net::Domain - Attempt to evaluate the current host's internet name
16763 and domain
16764
16765 =over 4
16766
16767 =item SYNOPSIS
16768
16769 =item DESCRIPTION
16770
16771 hostfqdn (), hostname (), hostdomain ()
16772
16773 =item AUTHOR
16774
16775 =item COPYRIGHT
16776
16777 =back
16778
16779 =head2 Net::FTP - FTP Client class
16780
16781 =over 4
16782
16783 =item SYNOPSIS
16784
16785 =item DESCRIPTION
16786
16787 =item OVERVIEW
16788
16789 =item CONSTRUCTOR
16790
16791 new (HOST [,OPTIONS])
16792
16793 =item METHODS
16794
16795 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
16796 site (ARGS), type (TYPE [, ARGS]), ascii ([ARGS]) binary([ARGS])
16797 ebcdic([ARGS]) byte([ARGS]), rename ( OLDNAME, NEWNAME ), delete ( FILENAME
16798 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR ),
16799 mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), alloc ( SIZE [, RECORD_SIZE] ),
16800 dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]] ), put (
16801 LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [, REMOTE_FILE ] ),
16802 append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (), mdtm ( FILE ), size
16803 ( FILE ), supported ( CMD ), hash ( [FILEHANDLE_GLOB_REF],[
16804 BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [ DIR ] ), retr ( FILE ),
16805 stor ( FILE ), stou ( FILE ), appe ( FILE ), port ( [ PORT ] ), pasv (),
16806 pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_xfer_unique (
16807 SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait ( NON_PASV_SERVER ),
16808 abort (), quit ()
16809
16810 =over 4
16811
16812 =item Methods for the adventurous
16813
16814 quot (CMD [,ARGS])
16815
16816 =back
16817
16818 =item THE dataconn CLASS
16819
16820 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
16821 bytes_read (), abort (), close ()
16822
16823 =item UNIMPLEMENTED
16824
16825 B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
16826
16827 =item REPORTING BUGS
16828
16829 =item AUTHOR
16830
16831 =item SEE ALSO
16832
16833 =item USE EXAMPLES
16834
16835 http://www.csh.rit.edu/~adam/Progs/autoftp-2.0.tar.gz
16836
16837 =item CREDITS
16838
16839 =item COPYRIGHT
16840
16841 =back
16842
16843 =head2 Net::NNTP - NNTP Client class
16844
16845 =over 4
16846
16847 =item SYNOPSIS
16848
16849 =item DESCRIPTION
16850
16851 =item CONSTRUCTOR
16852
16853 new ( [ HOST ] [, OPTIONS ])
16854
16855 =item METHODS
16856
16857 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
16858 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
16859 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
16860 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
16861 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
16862 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
16863 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
16864
16865 =over 4
16866
16867 =item Extension methods
16868
16869 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
16870 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
16871 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
16872 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
16873 GROUP ] ), reader
16874
16875 =back
16876
16877 =item UNSUPPORTED
16878
16879 =item DEFINITIONS
16880
16881 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
16882
16883 =item SEE ALSO
16884
16885 =item AUTHOR
16886
16887 =item COPYRIGHT
16888
16889 =back
16890
16891 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
16892
16893 =over 4
16894
16895 =item SYNOPSIS
16896
16897 =item DESCRIPTION
16898
16899 =item CONSTRUCTOR
16900
16901 new ( [ HOST, ] [ OPTIONS ] )
16902
16903 =item METHODS
16904
16905 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
16906 PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
16907 [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
16908 MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
16909
16910 =item NOTES
16911
16912 =item SEE ALSO
16913
16914 =item AUTHOR
16915
16916 =item COPYRIGHT
16917
16918 =back
16919
16920 =head2 Net::Ping - check a remote host for reachability
16921
16922 =over 4
16923
16924 =item SYNOPSIS
16925
16926 =item DESCRIPTION
16927
16928 =over 4
16929
16930 =item Functions
16931
16932 Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos
16933 ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
16934 $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
16935 $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
16936 [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host
16937 [, $timeout]);
16938
16939 =back
16940
16941 =item NOTES
16942
16943 =item INSTALL
16944
16945 =item BUGS
16946
16947 =item AUTHORS
16948
16949 =item COPYRIGHT
16950
16951 =back
16952
16953 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
16954
16955 =over 4
16956
16957 =item SYNOPSIS
16958
16959 =item DESCRIPTION
16960
16961 =item EXAMPLES
16962
16963 =item CONSTRUCTOR
16964
16965 new Net::SMTP [ HOST, ] [ OPTIONS ]
16966
16967 =item METHODS
16968
16969 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
16970 PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
16971 ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
16972 ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
16973 ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
16974 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
16975 quit ()
16976
16977 =item ADDRESSES
16978
16979 =item SEE ALSO
16980
16981 =item AUTHOR
16982
16983 =item COPYRIGHT
16984
16985 =back
16986
16987 =head2 Net::Time - time and daytime network client interface
16988
16989 =over 4
16990
16991 =item SYNOPSIS
16992
16993 =item DESCRIPTION
16994
16995 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
16996 PROTOCOL [, TIMEOUT]]])
16997
16998 =item AUTHOR
16999
17000 =item COPYRIGHT
17001
17002 =back
17003
17004 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
17005 functions
17006
17007 =over 4
17008
17009 =item SYNOPSIS
17010
17011 =item DESCRIPTION
17012
17013 =item EXAMPLES
17014
17015 =item NOTE
17016
17017 =item AUTHOR
17018
17019 =back
17020
17021 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
17022
17023 =over 4
17024
17025 =item DESCRIPTION
17026
17027 =over 4
17028
17029 =item Where to get this document
17030
17031 =item How to contribute to this document
17032
17033 =back
17034
17035 =item Author and Copyright Information
17036
17037 =over 4
17038
17039 =item Disclaimer
17040
17041 =back
17042
17043 =item Obtaining and installing libnet
17044
17045 =over 4
17046
17047 =item What is libnet ?
17048
17049 =item Which version of perl do I need ?
17050
17051 =item What other modules do I need ?
17052
17053 =item What machines support libnet ?
17054
17055 =item Where can I get the latest libnet release
17056
17057 =back
17058
17059 =item Using Net::FTP
17060
17061 =over 4
17062
17063 =item How do I download files from an FTP server ?
17064
17065 =item How do I transfer files in binary mode ?
17066
17067 =item How can I get the size of a file on a remote FTP server ?
17068
17069 =item How can I get the modification time of a file on a remote FTP server
17070 ?
17071
17072 =item How can I change the permissions of a file on a remote server ?
17073
17074 =item Can I do a reget operation like the ftp command ?
17075
17076 =item How do I get a directory listing from an FTP server ?
17077
17078 =item Changing directory to "" does not fail ?
17079
17080 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
17081
17082 =item I am behind an FTP proxy firewall, but cannot access machines outside
17083 ?
17084
17085 =item My ftp proxy firewall does not listen on port 21
17086
17087 =item Is it possible to change the file permissions of a file on an FTP
17088 server ?
17089
17090 =item I have seen scripts call a method message, but cannot find it
17091 documented ?
17092
17093 =item Why does Net::FTP not implement mput and mget methods
17094
17095 =back
17096
17097 =item Using Net::SMTP
17098
17099 =over 4
17100
17101 =item Why can't the part of an Email address after the @ be used as the
17102 hostname ?
17103
17104 =item Why does Net::SMTP not do DNS MX lookups ?
17105
17106 =item The verify method always returns true ?
17107
17108 =back
17109
17110 =item Debugging scripts
17111
17112 =over 4
17113
17114 =item How can I debug my scripts that use Net::* modules ?
17115
17116 =back
17117
17118 =item AUTHOR AND COPYRIGHT
17119
17120 =back
17121
17122 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
17123 functions
17124
17125 =over 4
17126
17127 =item SYNOPSIS
17128
17129 =item DESCRIPTION
17130
17131 =item EXAMPLES
17132
17133 =item NOTE
17134
17135 =item AUTHOR
17136
17137 =back
17138
17139 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
17140 functions
17141
17142 =over 4
17143
17144 =item SYNOPSIS
17145
17146 =item DESCRIPTION
17147
17148 =item NOTE
17149
17150 =item AUTHOR
17151
17152 =back
17153
17154 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
17155 functions
17156
17157 =over 4
17158
17159 =item SYNOPSIS
17160
17161 =item DESCRIPTION
17162
17163 =item EXAMPLES
17164
17165 =item NOTE
17166
17167 =item AUTHOR
17168
17169 =back
17170
17171 =head2 Netrc, Net::Netrc - OO interface to users netrc file
17172
17173 =over 4
17174
17175 =item SYNOPSIS
17176
17177 =item DESCRIPTION
17178
17179 =item THE .netrc FILE
17180
17181 machine name, default, login name, password string, account string, macdef
17182 name
17183
17184 =item CONSTRUCTOR
17185
17186 lookup ( MACHINE [, LOGIN ])
17187
17188 =item METHODS
17189
17190 login (), password (), account (), lpa ()
17191
17192 =item AUTHOR
17193
17194 =item SEE ALSO
17195
17196 =item COPYRIGHT
17197
17198 =back
17199
17200 =head2 O - Generic interface to Perl Compiler backends
17201
17202 =over 4
17203
17204 =item SYNOPSIS
17205
17206 =item DESCRIPTION
17207
17208 =item CONVENTIONS
17209
17210 =item IMPLEMENTATION
17211
17212 =item BUGS
17213
17214 =item AUTHOR
17215
17216 =back
17217
17218 =head2 ODBM_File - Tied access to odbm files
17219
17220 =over 4
17221
17222 =item SYNOPSIS
17223
17224 =item DESCRIPTION
17225
17226 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17227
17228 =item DIAGNOSTICS
17229
17230 =over 4
17231
17232 =item C<odbm store returned -1, errno 22, key "..." at ...>
17233
17234 =back
17235
17236 =item BUGS AND WARNINGS
17237
17238 =back
17239
17240 =head2 Opcode - Disable named opcodes when compiling perl code
17241
17242 =over 4
17243
17244 =item SYNOPSIS
17245
17246 =item DESCRIPTION
17247
17248 =item NOTE
17249
17250 =item WARNING
17251
17252 =item Operator Names and Operator Lists
17253
17254 an operator name (opname), an operator tag name (optag), a negated opname
17255 or optag, an operator set (opset)
17256
17257 =item Opcode Functions
17258
17259 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
17260 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
17261 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
17262 opdump (PAT)
17263
17264 =item Manipulating Opsets
17265
17266 =item TO DO (maybe)
17267
17268 =back
17269
17270 =over 4
17271
17272 =item Predefined Opcode Tags
17273
17274 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
17275 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
17276 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
17277 :dangerous
17278
17279 =item SEE ALSO
17280
17281 =item AUTHORS
17282
17283 =back
17284
17285 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
17286 compartments
17287
17288 =over 4
17289
17290 =item SYNOPSIS
17291
17292 =item DESCRIPTION
17293
17294 a new namespace, an operator mask
17295
17296 =item WARNING
17297
17298 =over 4
17299
17300 =item RECENT CHANGES
17301
17302 =item Methods in class Safe
17303
17304 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
17305 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
17306 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
17307 root (NAMESPACE), mask (MASK)
17308
17309 =item Some Safety Issues
17310
17311 Memory, CPU, Snooping, Signals, State Changes
17312
17313 =item AUTHOR
17314
17315 =back
17316
17317 =back
17318
17319 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
17320 compiling
17321
17322 =over 4
17323
17324 =item SYNOPSIS  
17325
17326 =item DESCRIPTION
17327
17328 =item SEE ALSO
17329
17330 =back
17331
17332 =head2 POSIX - Perl interface to IEEE Std 1003.1
17333
17334 =over 4
17335
17336 =item SYNOPSIS
17337
17338 =item DESCRIPTION
17339
17340 =item NOTE
17341
17342 =item CAVEATS 
17343
17344 =item FUNCTIONS
17345
17346 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
17347 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
17348 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
17349 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
17350 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
17351 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
17352 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
17353 fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv,
17354 geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid,
17355 getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha,
17356 isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace,
17357 isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime,
17358 log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr,
17359 memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice,
17360 offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc,
17361 putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename,
17362 rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid,
17363 setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
17364 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
17365 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
17366 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
17367 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
17368 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
17369 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
17370 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
17371 wctomb, write
17372
17373 =item CLASSES
17374
17375 =over 4
17376
17377 =item POSIX::SigAction
17378
17379 new, handler, mask, flags, safe
17380
17381 =item POSIX::SigSet
17382
17383 new, addset, delset, emptyset, fillset, ismember
17384
17385 =item POSIX::Termios
17386
17387 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
17388 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
17389 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
17390 field values, c_cflag field values, c_iflag field values, c_lflag field
17391 values, c_oflag field values
17392
17393 =back
17394
17395 =item PATHNAME CONSTANTS
17396
17397 Constants
17398
17399 =item POSIX CONSTANTS
17400
17401 Constants
17402
17403 =item SYSTEM CONFIGURATION
17404
17405 Constants
17406
17407 =item ERRNO
17408
17409 Constants
17410
17411 =item FCNTL
17412
17413 Constants
17414
17415 =item FLOAT
17416
17417 Constants
17418
17419 =item LIMITS
17420
17421 Constants
17422
17423 =item LOCALE
17424
17425 Constants
17426
17427 =item MATH
17428
17429 Constants
17430
17431 =item SIGNAL
17432
17433 Constants
17434
17435 =item STAT
17436
17437 Constants, Macros
17438
17439 =item STDLIB
17440
17441 Constants
17442
17443 =item STDIO
17444
17445 Constants
17446
17447 =item TIME
17448
17449 Constants
17450
17451 =item UNISTD
17452
17453 Constants
17454
17455 =item WAIT
17456
17457 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
17458 WTERMSIG, WIFSTOPPED, WSTOPSIG
17459
17460 =back
17461
17462 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
17463 name space
17464
17465 =over 4
17466
17467 =item SYNOPSIS
17468
17469 =item DESCRIPTION
17470
17471 unix, stdio, perlio, crlf, utf8, bytes, raw, pop
17472
17473 =over 4
17474
17475 =item Custom Layers
17476
17477 :encoding, :via
17478
17479 =item Alternatives to raw
17480
17481 =item Defaults and how to override them
17482
17483 =item Querying the layers of filehandle
17484
17485 =back
17486
17487 =item AUTHOR
17488
17489 =item SEE ALSO
17490
17491 =back
17492
17493 =head2 PerlIO::encoding - encoding layer
17494
17495 =over 4
17496
17497 =item SYNOPSIS
17498
17499 =item DESCRIPTION
17500
17501 =item SEE ALSO
17502
17503 =back
17504
17505 =head2 PerlIO::scalar - support module for in-memory IO.
17506
17507 =over 4
17508
17509 =item SYNOPSIS
17510
17511 =item DESCRIPTION
17512
17513 =back
17514
17515 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
17516
17517 =over 4
17518
17519 =item SYNOPSIS
17520
17521 =item DESCRIPTION
17522
17523 =item EXPECTED METHODS
17524
17525 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
17526 $obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]),
17527 $obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]),
17528 $obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh),
17529 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
17530 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
17531 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
17532 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
17533
17534 =item EXAMPLES
17535
17536 =over 4
17537
17538 =item Example - a Hexadecimal Handle
17539
17540 =back
17541
17542 =back
17543
17544 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
17545
17546 =over 4
17547
17548 =item SYNOPSIS
17549
17550 =item DESCRIPTION
17551
17552 =item SEE ALSO
17553
17554 =item ACKNOWLEDGEMENTS
17555
17556 =item COPYRIGHT
17557
17558 =back
17559
17560 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
17561
17562 =over 4
17563
17564 =item SYNOPSIS
17565
17566 =item OPTIONS/ARGUMENTS
17567
17568 =over 4
17569
17570 =item podchecker()
17571
17572 B<-warnings> =E<gt> I<val>
17573
17574 =back
17575
17576 =item DESCRIPTION
17577
17578 =item DIAGNOSTICS
17579
17580 =over 4
17581
17582 =item Errors
17583
17584 empty =headn, =over on line I<N> without closing =back, =item without
17585 previous =over, =back without previous =over, No argument for =begin, =end
17586 without =begin, Nested =begin's, =for without formatter specification,
17587 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
17588 interior-sequence "I<SEQ>", nested commands
17589 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
17590 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
17591 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
17592 after =back
17593
17594 =item Warnings
17595
17596 multiple occurrence of link target I<name>, line containing nothing but
17597 whitespace in paragraph, file does not start with =head, previous =item has
17598 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
17599 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
17600 items in =over, No argument for =item, empty section in previous paragraph,
17601 Verbatim paragraph in NAME section, =headI<n> without preceding higher
17602 level
17603
17604 =item Hyperlinks
17605
17606 ignoring leading/trailing whitespace in link, (section) in '$page'
17607 deprecated, alternative text/node '%s' contains non-escaped | or /
17608
17609 =back
17610
17611 =item RETURN VALUE
17612
17613 =item EXAMPLES
17614
17615 =item INTERFACE
17616
17617 =back
17618
17619 C<Pod::Checker-E<gt>new( %options )>
17620
17621 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
17622 @args )>
17623
17624 C<$checker-E<gt>num_errors()>
17625
17626 C<$checker-E<gt>num_warnings()>
17627
17628 C<$checker-E<gt>name()>
17629
17630 C<$checker-E<gt>node()>
17631
17632 C<$checker-E<gt>idx()>
17633
17634 C<$checker-E<gt>hyperlink()>
17635
17636 =over 4
17637
17638 =item AUTHOR
17639
17640 =back
17641
17642 =head2 Pod::Find - find POD documents in directory trees
17643
17644 =over 4
17645
17646 =item SYNOPSIS
17647
17648 =item DESCRIPTION
17649
17650 =back
17651
17652 =over 4
17653
17654 =item C<pod_find( { %opts } , @directories )>
17655
17656 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
17657 1>
17658
17659 =back
17660
17661 =over 4
17662
17663 =item C<simplify_name( $str )>
17664
17665 =back
17666
17667 =over 4
17668
17669 =item C<pod_where( { %opts }, $pod )>
17670
17671 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
17672 1>
17673
17674 =back
17675
17676 =over 4
17677
17678 =item C<contains_pod( $file , $verbose )>
17679
17680 =back
17681
17682 =over 4
17683
17684 =item AUTHOR
17685
17686 =item SEE ALSO
17687
17688 =back
17689
17690 =head2 Pod::Html - module to convert pod files to HTML
17691
17692 =over 4
17693
17694 =item SYNOPSIS
17695
17696 =item DESCRIPTION
17697
17698 =item ARGUMENTS
17699
17700 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
17701 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
17702 title, verbose
17703
17704 =item EXAMPLE
17705
17706 =item ENVIRONMENT
17707
17708 =item AUTHOR
17709
17710 =item SEE ALSO
17711
17712 =item COPYRIGHT
17713
17714 =back
17715
17716 =head2 Pod::InputObjects - objects representing POD input paragraphs,
17717 commands, etc.
17718
17719 =over 4
17720
17721 =item SYNOPSIS
17722
17723 =item REQUIRES
17724
17725 =item EXPORTS
17726
17727 =item DESCRIPTION
17728
17729 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
17730 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
17731
17732 =back
17733
17734 =over 4
17735
17736 =item B<Pod::InputSource>
17737
17738 =back
17739
17740 =over 4
17741
17742 =item B<new()>
17743
17744 =back
17745
17746 =over 4
17747
17748 =item B<name()>
17749
17750 =back
17751
17752 =over 4
17753
17754 =item B<handle()>
17755
17756 =back
17757
17758 =over 4
17759
17760 =item B<was_cutting()>
17761
17762 =back
17763
17764 =over 4
17765
17766 =item B<Pod::Paragraph>
17767
17768 =back
17769
17770 =over 4
17771
17772 =item Pod::Paragraph-E<gt>B<new()>
17773
17774 =back
17775
17776 =over 4
17777
17778 =item $pod_para-E<gt>B<cmd_name()>
17779
17780 =back
17781
17782 =over 4
17783
17784 =item $pod_para-E<gt>B<text()>
17785
17786 =back
17787
17788 =over 4
17789
17790 =item $pod_para-E<gt>B<raw_text()>
17791
17792 =back
17793
17794 =over 4
17795
17796 =item $pod_para-E<gt>B<cmd_prefix()>
17797
17798 =back
17799
17800 =over 4
17801
17802 =item $pod_para-E<gt>B<cmd_separator()>
17803
17804 =back
17805
17806 =over 4
17807
17808 =item $pod_para-E<gt>B<parse_tree()>
17809
17810 =back
17811
17812 =over 4
17813
17814 =item $pod_para-E<gt>B<file_line()>
17815
17816 =back
17817
17818 =over 4
17819
17820 =item B<Pod::InteriorSequence>
17821
17822 =back
17823
17824 =over 4
17825
17826 =item Pod::InteriorSequence-E<gt>B<new()>
17827
17828 =back
17829
17830 =over 4
17831
17832 =item $pod_seq-E<gt>B<cmd_name()>
17833
17834 =back
17835
17836 =over 4
17837
17838 =item $pod_seq-E<gt>B<prepend()>
17839
17840 =back
17841
17842 =over 4
17843
17844 =item $pod_seq-E<gt>B<append()>
17845
17846 =back
17847
17848 =over 4
17849
17850 =item $pod_seq-E<gt>B<nested()>
17851
17852 =back
17853
17854 =over 4
17855
17856 =item $pod_seq-E<gt>B<raw_text()>
17857
17858 =back
17859
17860 =over 4
17861
17862 =item $pod_seq-E<gt>B<left_delimiter()>
17863
17864 =back
17865
17866 =over 4
17867
17868 =item $pod_seq-E<gt>B<right_delimiter()>
17869
17870 =back
17871
17872 =over 4
17873
17874 =item $pod_seq-E<gt>B<parse_tree()>
17875
17876 =back
17877
17878 =over 4
17879
17880 =item $pod_seq-E<gt>B<file_line()>
17881
17882 =back
17883
17884 =over 4
17885
17886 =item Pod::InteriorSequence::B<DESTROY()>
17887
17888 =back
17889
17890 =over 4
17891
17892 =item B<Pod::ParseTree>
17893
17894 =back
17895
17896 =over 4
17897
17898 =item Pod::ParseTree-E<gt>B<new()>
17899
17900 =back
17901
17902 =over 4
17903
17904 =item $ptree-E<gt>B<top()>
17905
17906 =back
17907
17908 =over 4
17909
17910 =item $ptree-E<gt>B<children()>
17911
17912 =back
17913
17914 =over 4
17915
17916 =item $ptree-E<gt>B<prepend()>
17917
17918 =back
17919
17920 =over 4
17921
17922 =item $ptree-E<gt>B<append()>
17923
17924 =back
17925
17926 =over 4
17927
17928 =item $ptree-E<gt>B<raw_text()>
17929
17930 =back
17931
17932 =over 4
17933
17934 =item Pod::ParseTree::B<DESTROY()>
17935
17936 =back
17937
17938 =over 4
17939
17940 =item SEE ALSO
17941
17942 =item AUTHOR
17943
17944 =back
17945
17946 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
17947
17948 =over 4
17949
17950 =item SYNOPSIS
17951
17952 =item DESCRIPTION
17953
17954 =back
17955
17956 =over 4
17957
17958 =item OBJECT METHODS
17959
17960 C<initialize>
17961
17962 =back
17963
17964 =over 4
17965
17966 =item Data Accessors
17967
17968 B<AddPreamble>
17969
17970 =back
17971
17972 B<AddPostamble>
17973
17974 B<Head1Level>
17975
17976 B<Label>
17977
17978 B<LevelNoNum>
17979
17980 B<MakeIndex>
17981
17982 B<ReplaceNAMEwithSection>
17983
17984 B<StartWithNewPage>
17985
17986 B<TableOfContents>
17987
17988 B<UniqueLabels>
17989
17990 B<UserPreamble>
17991
17992 B<UserPostamble>
17993
17994 B<Lists>
17995
17996 =over 4
17997
17998 =item Subclassed methods
17999
18000 =back
18001
18002 B<begin_pod>
18003
18004 B<end_pod>
18005
18006 B<command>
18007
18008 B<verbatim>
18009
18010 B<textblock>
18011
18012 B<interior_sequence>
18013
18014 =over 4
18015
18016 =item List Methods
18017
18018 B<begin_list>
18019
18020 =back
18021
18022 B<end_list>
18023
18024 B<add_item>
18025
18026 =over 4
18027
18028 =item Methods for headings
18029
18030 B<head>
18031
18032 =back
18033
18034 =over 4
18035
18036 =item Internal methods
18037
18038 B<_output>
18039
18040 =back
18041
18042 B<_replace_special_chars>
18043
18044 B<_replace_special_chars_late>
18045
18046 B<_create_label>
18047
18048 B<_create_index>
18049
18050 B<_clean_latex_commands>
18051
18052 B<_split_delimited>
18053
18054 =over 4
18055
18056 =item NOTES
18057
18058 =item SEE ALSO
18059
18060 =item AUTHORS
18061
18062 =item COPYRIGHT
18063
18064 =item REVISION
18065
18066 =back
18067
18068 =head2 Pod::Man - Convert POD data to formatted *roff input
18069
18070 =over 4
18071
18072 =item SYNOPSIS
18073
18074 =item DESCRIPTION
18075
18076 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
18077 release, section
18078
18079 =item DIAGNOSTICS
18080
18081 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
18082 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
18083 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
18084 =back
18085
18086 =item BUGS
18087
18088 =item CAVEATS
18089
18090 =item SEE ALSO
18091
18092 =item AUTHOR
18093
18094 =item COPYRIGHT AND LICENSE
18095
18096 =back
18097
18098 =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
18099
18100 =over 4
18101
18102 =item SYNOPSIS
18103
18104 =item DESCRIPTION
18105
18106 =item SEE ALSO
18107
18108 =item AUTHOR
18109
18110 =item COPYRIGHT AND LICENSE
18111
18112 =back
18113
18114 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
18115
18116 =over 4
18117
18118 =item SYNOPSIS
18119
18120 =item DESCRIPTION
18121
18122 =back
18123
18124 =over 4
18125
18126 =item Pod::List
18127
18128 Pod::List-E<gt>new()
18129
18130 =back
18131
18132 $list-E<gt>file()
18133
18134 $list-E<gt>start()
18135
18136 $list-E<gt>indent()
18137
18138 $list-E<gt>type()
18139
18140 $list-E<gt>rx()
18141
18142 $list-E<gt>item()
18143
18144 $list-E<gt>parent()
18145
18146 $list-E<gt>tag()
18147
18148 =over 4
18149
18150 =item Pod::Hyperlink
18151
18152 Pod::Hyperlink-E<gt>new()
18153
18154 =back
18155
18156 $link-E<gt>parse($string)
18157
18158 $link-E<gt>markup($string)
18159
18160 $link-E<gt>text()
18161
18162 $link-E<gt>warning()
18163
18164 $link-E<gt>file(), $link-E<gt>line()
18165
18166 $link-E<gt>page()
18167
18168 $link-E<gt>node()
18169
18170 $link-E<gt>alttext()
18171
18172 $link-E<gt>type()
18173
18174 $link-E<gt>link()
18175
18176 =over 4
18177
18178 =item Pod::Cache
18179
18180 Pod::Cache-E<gt>new()
18181
18182 =back
18183
18184 $cache-E<gt>item()
18185
18186 $cache-E<gt>find_page($name)
18187
18188 =over 4
18189
18190 =item Pod::Cache::Item
18191
18192 Pod::Cache::Item-E<gt>new()
18193
18194 =back
18195
18196 $cacheitem-E<gt>page()
18197
18198 $cacheitem-E<gt>description()
18199
18200 $cacheitem-E<gt>path()
18201
18202 $cacheitem-E<gt>file()
18203
18204 $cacheitem-E<gt>nodes()
18205
18206 $cacheitem-E<gt>find_node($name)
18207
18208 $cacheitem-E<gt>idx()
18209
18210 =over 4
18211
18212 =item AUTHOR
18213
18214 =item SEE ALSO
18215
18216 =back
18217
18218 =head2 Pod::Parser - base class for creating POD filters and translators
18219
18220 =over 4
18221
18222 =item SYNOPSIS
18223
18224 =item REQUIRES
18225
18226 =item EXPORTS
18227
18228 =item DESCRIPTION
18229
18230 =item QUICK OVERVIEW
18231
18232 =item PARSING OPTIONS
18233
18234 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
18235 B<-warnings> (default: unset)
18236
18237 =back
18238
18239 =over 4
18240
18241 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
18242
18243 =back
18244
18245 =over 4
18246
18247 =item B<command()>
18248
18249 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
18250
18251 =back
18252
18253 =over 4
18254
18255 =item B<verbatim()>
18256
18257 C<$text>, C<$line_num>, C<$pod_para>
18258
18259 =back
18260
18261 =over 4
18262
18263 =item B<textblock()>
18264
18265 C<$text>, C<$line_num>, C<$pod_para>
18266
18267 =back
18268
18269 =over 4
18270
18271 =item B<interior_sequence()>
18272
18273 =back
18274
18275 =over 4
18276
18277 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
18278
18279 =back
18280
18281 =over 4
18282
18283 =item B<new()>
18284
18285 =back
18286
18287 =over 4
18288
18289 =item B<initialize()>
18290
18291 =back
18292
18293 =over 4
18294
18295 =item B<begin_pod()>
18296
18297 =back
18298
18299 =over 4
18300
18301 =item B<begin_input()>
18302
18303 =back
18304
18305 =over 4
18306
18307 =item B<end_input()>
18308
18309 =back
18310
18311 =over 4
18312
18313 =item B<end_pod()>
18314
18315 =back
18316
18317 =over 4
18318
18319 =item B<preprocess_line()>
18320
18321 =back
18322
18323 =over 4
18324
18325 =item B<preprocess_paragraph()>
18326
18327 =back
18328
18329 =over 4
18330
18331 =item METHODS FOR PARSING AND PROCESSING
18332
18333 =back
18334
18335 =over 4
18336
18337 =item B<parse_text()>
18338
18339 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
18340 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
18341 I<code-ref>|I<method-name>
18342
18343 =back
18344
18345 =over 4
18346
18347 =item B<interpolate()>
18348
18349 =back
18350
18351 =over 4
18352
18353 =item B<parse_paragraph()>
18354
18355 =back
18356
18357 =over 4
18358
18359 =item B<parse_from_filehandle()>
18360
18361 =back
18362
18363 =over 4
18364
18365 =item B<parse_from_file()>
18366
18367 =back
18368
18369 =over 4
18370
18371 =item ACCESSOR METHODS
18372
18373 =back
18374
18375 =over 4
18376
18377 =item B<errorsub()>
18378
18379 =back
18380
18381 =over 4
18382
18383 =item B<cutting()>
18384
18385 =back
18386
18387 =over 4
18388
18389 =item B<parseopts()>
18390
18391 =back
18392
18393 =over 4
18394
18395 =item B<output_file()>
18396
18397 =back
18398
18399 =over 4
18400
18401 =item B<output_handle()>
18402
18403 =back
18404
18405 =over 4
18406
18407 =item B<input_file()>
18408
18409 =back
18410
18411 =over 4
18412
18413 =item B<input_handle()>
18414
18415 =back
18416
18417 =over 4
18418
18419 =item B<input_streams()>
18420
18421 =back
18422
18423 =over 4
18424
18425 =item B<top_stream()>
18426
18427 =back
18428
18429 =over 4
18430
18431 =item PRIVATE METHODS AND DATA
18432
18433 =back
18434
18435 =over 4
18436
18437 =item B<_push_input_stream()>
18438
18439 =back
18440
18441 =over 4
18442
18443 =item B<_pop_input_stream()>
18444
18445 =back
18446
18447 =over 4
18448
18449 =item TREE-BASED PARSING
18450
18451 =item SEE ALSO
18452
18453 =item AUTHOR
18454
18455 =back
18456
18457 =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors
18458
18459 =over 4
18460
18461 =item SYNOPSIS
18462
18463 =item DESCRIPTION
18464
18465 =item SEE ALSO
18466
18467 =item COPYRIGHT AND DISCLAIMERS
18468
18469 =item AUTHOR
18470
18471 =back
18472
18473 =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages
18474
18475 =over 4
18476
18477 =item SYNOPSIS
18478
18479 =item DESCRIPTION
18480
18481 =item CAVEAT
18482
18483 =item SEE ALSO
18484
18485 =item COPYRIGHT AND DISCLAIMERS
18486
18487 =item AUTHOR
18488
18489 =back
18490
18491 =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff
18492
18493 =over 4
18494
18495 =item SYNOPSIS
18496
18497 =item DESCRIPTION
18498
18499 =item CAVEAT
18500
18501 =item SEE ALSO
18502
18503 =item COPYRIGHT AND DISCLAIMERS
18504
18505 =item AUTHOR
18506
18507 =back
18508
18509 =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod!
18510
18511 =over 4
18512
18513 =item SYNOPSIS
18514
18515 =item DESCRIPTION
18516
18517 =item SEE ALSO
18518
18519 =item COPYRIGHT AND DISCLAIMERS
18520
18521 =item AUTHOR
18522
18523 =back
18524
18525 =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF
18526
18527 =over 4
18528
18529 =item SYNOPSIS
18530
18531 =item DESCRIPTION
18532
18533 =item SEE ALSO
18534
18535 =item COPYRIGHT AND DISCLAIMERS
18536
18537 =item AUTHOR
18538
18539 =back
18540
18541 =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext
18542
18543 =over 4
18544
18545 =item SYNOPSIS
18546
18547 =item DESCRIPTION
18548
18549 =item CAVEAT
18550
18551 =item SEE ALSO
18552
18553 =item COPYRIGHT AND DISCLAIMERS
18554
18555 =item AUTHOR
18556
18557 =back
18558
18559 =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod
18560
18561 =over 4
18562
18563 =item SYNOPSIS
18564
18565 =item DESCRIPTION
18566
18567 =item SEE ALSO
18568
18569 =item AUTHOR
18570
18571 =back
18572
18573 =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML
18574
18575 =over 4
18576
18577 =item SYNOPSIS
18578
18579 =item DESCRIPTION
18580
18581 =item SEE ALSO
18582
18583 =item COPYRIGHT AND DISCLAIMERS
18584
18585 =item AUTHOR
18586
18587 =back
18588
18589 =head2 Pod::PlainText - Convert POD data to formatted ASCII text
18590
18591 =over 4
18592
18593 =item SYNOPSIS
18594
18595 =item DESCRIPTION
18596
18597 alt, indent, loose, sentence, width
18598
18599 =item DIAGNOSTICS
18600
18601 Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
18602 Unknown sequence: %s, Unmatched =back
18603
18604 =item RESTRICTIONS
18605
18606 =item NOTES
18607
18608 =item SEE ALSO
18609
18610 =item AUTHOR
18611
18612 =back
18613
18614 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
18615
18616 =over 4
18617
18618 =item SYNOPSIS
18619
18620 =item DESCRIPTION
18621
18622 =over 4
18623
18624 =item EXPORT
18625
18626 =back
18627
18628 =item AUTHOR
18629
18630 =item SEE ALSO
18631
18632 =back
18633
18634 =head2 Pod::Select, podselect() - extract selected sections of POD from
18635 input
18636
18637 =over 4
18638
18639 =item SYNOPSIS
18640
18641 =item REQUIRES
18642
18643 =item EXPORTS
18644
18645 =item DESCRIPTION
18646
18647 =item SECTION SPECIFICATIONS
18648
18649 =item RANGE SPECIFICATIONS
18650
18651 =back
18652
18653 =over 4
18654
18655 =item OBJECT METHODS
18656
18657 =back
18658
18659 =over 4
18660
18661 =item B<curr_headings()>
18662
18663 =back
18664
18665 =over 4
18666
18667 =item B<select()>
18668
18669 =back
18670
18671 =over 4
18672
18673 =item B<add_selection()>
18674
18675 =back
18676
18677 =over 4
18678
18679 =item B<clear_selections()>
18680
18681 =back
18682
18683 =over 4
18684
18685 =item B<match_section()>
18686
18687 =back
18688
18689 =over 4
18690
18691 =item B<is_selected()>
18692
18693 =back
18694
18695 =over 4
18696
18697 =item EXPORTED FUNCTIONS
18698
18699 =back
18700
18701 =over 4
18702
18703 =item B<podselect()>
18704
18705 B<-output>, B<-sections>, B<-ranges>
18706
18707 =back
18708
18709 =over 4
18710
18711 =item PRIVATE METHODS AND DATA
18712
18713 =back
18714
18715 =over 4
18716
18717 =item B<_compile_section_spec()>
18718
18719 =back
18720
18721 =over 4
18722
18723 =item $self->{_SECTION_HEADINGS}
18724
18725 =back
18726
18727 =over 4
18728
18729 =item $self->{_SELECTED_SECTIONS}
18730
18731 =back
18732
18733 =over 4
18734
18735 =item SEE ALSO
18736
18737 =item AUTHOR
18738
18739 =back
18740
18741 =head2 Pod::Text - Convert POD data to formatted ASCII text
18742
18743 =over 4
18744
18745 =item SYNOPSIS
18746
18747 =item DESCRIPTION
18748
18749 alt, code, indent, loose, margin, quotes, sentence, width
18750
18751 =item DIAGNOSTICS
18752
18753 Bizarre space in item, Item called without tag, Can't open %s for reading:
18754 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
18755 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
18756 Unmatched =back
18757
18758 =item RESTRICTIONS
18759
18760 =item NOTES
18761
18762 =item SEE ALSO
18763
18764 =item AUTHOR
18765
18766 =item COPYRIGHT AND LICENSE
18767
18768 =back
18769
18770 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
18771
18772 =over 4
18773
18774 =item SYNOPSIS
18775
18776 =item DESCRIPTION
18777
18778 =item BUGS
18779
18780 =item SEE ALSO
18781
18782 =item AUTHOR
18783
18784 =item COPYRIGHT AND LICENSE
18785
18786 =back
18787
18788 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
18789 text
18790
18791 =over 4
18792
18793 =item SYNOPSIS
18794
18795 =item DESCRIPTION
18796
18797 =item BUGS
18798
18799 =item SEE ALSO
18800
18801 =item AUTHOR
18802
18803 =item COPYRIGHT AND LICENSE
18804
18805 =back
18806
18807 =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
18808 escapes
18809
18810 =over 4
18811
18812 =item SYNOPSIS
18813
18814 =item DESCRIPTION
18815
18816 =item NOTES
18817
18818 =item SEE ALSO
18819
18820 =item AUTHOR
18821
18822 =item COPYRIGHT AND LICENSE
18823
18824 =back
18825
18826 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
18827 documentation
18828
18829 =over 4
18830
18831 =item SYNOPSIS
18832
18833 =item ARGUMENTS
18834
18835 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
18836 C<-pathlist>
18837
18838 =item DESCRIPTION
18839
18840 =item EXAMPLES
18841
18842 =over 4
18843
18844 =item Recommended Use
18845
18846 =back
18847
18848 =item CAVEATS
18849
18850 =item AUTHOR
18851
18852 =item ACKNOWLEDGEMENTS
18853
18854 =back
18855
18856 =head2 SDBM_File - Tied access to sdbm files
18857
18858 =over 4
18859
18860 =item SYNOPSIS
18861
18862 =item DESCRIPTION
18863
18864 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
18865
18866 =item DIAGNOSTICS
18867
18868 =over 4
18869
18870 =item C<sdbm store returned -1, errno 22, key "..." at ...>
18871
18872 =back
18873
18874 =item BUGS AND WARNINGS
18875
18876 =back
18877
18878 =head2 Safe - Compile and execute code in restricted compartments
18879
18880 =over 4
18881
18882 =item SYNOPSIS
18883
18884 =item DESCRIPTION
18885
18886 a new namespace, an operator mask
18887
18888 =item WARNING
18889
18890 =over 4
18891
18892 =item RECENT CHANGES
18893
18894 =item Methods in class Safe
18895
18896 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
18897 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
18898 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
18899 root (NAMESPACE), mask (MASK)
18900
18901 =item Some Safety Issues
18902
18903 Memory, CPU, Snooping, Signals, State Changes
18904
18905 =item AUTHOR
18906
18907 =back
18908
18909 =back
18910
18911 =head2 Scalar::Util - A selection of general-utility scalar subroutines
18912
18913 =over 4
18914
18915 =item SYNOPSIS
18916
18917 =item DESCRIPTION
18918
18919 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
18920 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
18921 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
18922
18923 =item KNOWN BUGS
18924
18925 =item COPYRIGHT
18926
18927 =item BLATANT PLUG
18928
18929 =back
18930
18931 =head2 Search::Dict, look - search for key in dictionary file
18932
18933 =over 4
18934
18935 =item SYNOPSIS
18936
18937 =item DESCRIPTION
18938
18939 =back
18940
18941 =head2 SelectSaver - save and restore selected file handle
18942
18943 =over 4
18944
18945 =item SYNOPSIS
18946
18947 =item DESCRIPTION
18948
18949 =back
18950
18951 =head2 SelfLoader - load functions only on demand
18952
18953 =over 4
18954
18955 =item SYNOPSIS
18956
18957 =item DESCRIPTION
18958
18959 =over 4
18960
18961 =item The __DATA__ token
18962
18963 =item SelfLoader autoloading
18964
18965 =item Autoloading and package lexicals
18966
18967 =item SelfLoader and AutoLoader
18968
18969 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
18970
18971 =item Classes and inherited methods.
18972
18973 =back
18974
18975 =item Multiple packages and fully qualified subroutine names
18976
18977 =back
18978
18979 =head2 Shell - run shell commands transparently within perl
18980
18981 =over 4
18982
18983 =item SYNOPSIS
18984
18985 =item DESCRIPTION
18986
18987 =over 4
18988
18989 =item OBJECT ORIENTED SYNTAX
18990
18991 =back
18992
18993 =item AUTHOR
18994
18995 =back
18996
18997 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
18998 socket.h defines and structure manipulators 
18999
19000 =over 4
19001
19002 =item SYNOPSIS
19003
19004 =item DESCRIPTION
19005
19006 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
19007 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
19008 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
19009 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
19010 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
19011
19012 =back
19013
19014 =head2 Storable - persistence for Perl data structures
19015
19016 =over 4
19017
19018 =item SYNOPSIS
19019
19020 =item DESCRIPTION
19021
19022 =item MEMORY STORE
19023
19024 =item ADVISORY LOCKING
19025
19026 =item SPEED
19027
19028 =item CANONICAL REPRESENTATION
19029
19030 =item CODE REFERENCES
19031
19032 =item FORWARD COMPATIBILITY
19033
19034 utf8 data, restricted hashes, files from future versions of Storable
19035
19036 =item ERROR REPORTING
19037
19038 =item WIZARDS ONLY
19039
19040 =over 4
19041
19042 =item Hooks
19043
19044 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
19045 I<serialized>, ..
19046
19047 =item Predicates
19048
19049 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
19050 C<Storable::is_retrieving>
19051
19052 =item Recursion
19053
19054 =item Deep Cloning
19055
19056 =back
19057
19058 =item Storable magic
19059
19060 =item EXAMPLES
19061
19062 =item WARNING
19063
19064 =item BUGS
19065
19066 =over 4
19067
19068 =item 64 bit data in perl 5.6.0 and 5.6.1
19069
19070 =back
19071
19072 =item CREDITS
19073
19074 =item AUTHOR
19075
19076 =item SEE ALSO
19077
19078 =back
19079
19080 =head2 Switch - A switch statement for Perl
19081
19082 =over 4
19083
19084 =item VERSION
19085
19086 =item SYNOPSIS
19087
19088 =item BACKGROUND
19089
19090 =item DESCRIPTION
19091
19092 =over 4
19093
19094 =item Allowing fall-through
19095
19096 =item Automating fall-through
19097
19098 =item Alternative syntax
19099
19100 =item Higher-order Operations
19101
19102 =back
19103
19104 =item DEPENDENCIES
19105
19106 =item AUTHOR
19107
19108 =item BUGS
19109
19110 =item LIMITATION
19111
19112 =item COPYRIGHT
19113
19114 =back
19115
19116 =head2 Symbol - manipulate Perl symbols and their names
19117
19118 =over 4
19119
19120 =item SYNOPSIS
19121
19122 =item DESCRIPTION
19123
19124 =back
19125
19126 =head2 Sys::Hostname - Try every conceivable way to get hostname
19127
19128 =over 4
19129
19130 =item SYNOPSIS
19131
19132 =item DESCRIPTION
19133
19134 =item AUTHOR
19135
19136 =back
19137
19138 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
19139 interface to the UNIX syslog(3) calls
19140
19141 =over 4
19142
19143 =item SYNOPSIS
19144
19145 =item DESCRIPTION
19146
19147 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19148 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19149 in 5.004_02), closelog
19150
19151 =item EXAMPLES
19152
19153 =item SEE ALSO
19154
19155 =item AUTHOR
19156
19157 =back
19158
19159 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
19160 Perl interface to the UNIX syslog(3) calls
19161
19162 =over 4
19163
19164 =item SYNOPSIS
19165
19166 =item DESCRIPTION
19167
19168 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19169 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19170 in 5.004_02), closelog
19171
19172 =item EXAMPLES
19173
19174 =item SEE ALSO
19175
19176 =item AUTHOR
19177
19178 =back
19179
19180 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
19181
19182 =over 4
19183
19184 =item SYNOPSIS
19185
19186 =item DESCRIPTION
19187
19188 =item DIAGNOSTICS
19189
19190 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
19191 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
19192 comma allowed after filehandle, No name for escape sequence %s
19193
19194 =item ENVIRONMENT
19195
19196 ANSI_COLORS_DISABLED
19197
19198 =item RESTRICTIONS
19199
19200 =item NOTES
19201
19202 =item SEE ALSO
19203
19204 =item AUTHORS
19205
19206 =item COPYRIGHT AND LICENSE
19207
19208 =back
19209
19210 =head2 Term::Cap - Perl termcap interface
19211
19212 =over 4
19213
19214 =item SYNOPSIS
19215
19216 =item DESCRIPTION
19217
19218 =over 4
19219
19220 =item METHODS
19221
19222 =back
19223
19224 =back
19225
19226 B<Tgetent>, OSPEED, TERM
19227
19228 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
19229
19230 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
19231
19232 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
19233
19234 B<Trequire>
19235
19236 =over 4
19237
19238 =item EXAMPLES
19239
19240 =item COPYRIGHT AND LICENSE
19241
19242 =item AUTHOR
19243
19244 =item SEE ALSO
19245
19246 =back
19247
19248 =head2 Term::Complete - Perl word completion module
19249
19250 =over 4
19251
19252 =item SYNOPSIS
19253
19254 =item DESCRIPTION
19255
19256 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
19257
19258 =item DIAGNOSTICS
19259
19260 =item BUGS
19261
19262 =item AUTHOR
19263
19264 =back
19265
19266 =head2 Term::ReadLine - Perl interface to various C<readline> packages.
19267 If no real package is found, substitutes stubs instead of basic functions.
19268
19269 =over 4
19270
19271 =item SYNOPSIS
19272
19273 =item DESCRIPTION
19274
19275 =item Minimal set of supported functions
19276
19277 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>,
19278 C<findConsole>, Attribs, C<Features>
19279
19280 =item Additional supported functions
19281
19282 C<tkRunning>, C<ornaments>, C<newTTY>
19283
19284 =item EXPORTS
19285
19286 =item ENVIRONMENT
19287
19288 =item CAVEATS
19289
19290 =back
19291
19292 =head2 Test - provides a simple framework for writing test scripts
19293
19294 =over 4
19295
19296 =item SYNOPSIS
19297
19298 =item DESCRIPTION
19299
19300 =item QUICK START GUIDE
19301
19302 =over 4
19303
19304 =item Functions
19305
19306 C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>,
19307 C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub>
19308
19309 =back
19310
19311 =back
19312
19313 B<_to_value>
19314
19315 C<ok(...)>
19316
19317 C<skip(I<skip_if_true>, I<args...>)>
19318
19319 =over 4
19320
19321 =item TEST TYPES
19322
19323 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
19324
19325 =item ONFAIL
19326
19327 =item BUGS and CAVEATS
19328
19329 =item NOTE
19330
19331 =item SEE ALSO
19332
19333 =item AUTHOR
19334
19335 =back
19336
19337 =head2 Test::Builder - Backend for building test libraries
19338
19339 =over 4
19340
19341 =item SYNOPSIS
19342
19343 =item DESCRIPTION
19344
19345 =over 4
19346
19347 =item Construction
19348
19349 B<new>
19350
19351 =back
19352
19353 =back
19354
19355 =over 4
19356
19357 =item Setting up tests
19358
19359 B<exported_to>
19360
19361 =back
19362
19363 B<plan>
19364
19365 B<expected_tests>
19366
19367 B<no_plan>
19368
19369 B<has_plan>
19370
19371 B<skip_all>
19372
19373 =over 4
19374
19375 =item Running tests
19376
19377 B<ok>
19378
19379 =back
19380
19381 B<is_eq>, B<is_num>
19382
19383 B<isnt_eq>, B<isnt_num>
19384
19385 B<like>, B<unlike>
19386
19387 B<maybe_regex>
19388
19389 B<cmp_ok>
19390
19391 B<BAILOUT>
19392
19393 B<skip>
19394
19395 B<todo_skip>
19396
19397 B<skip_rest>
19398
19399 =over 4
19400
19401 =item Test style
19402
19403 B<level>
19404
19405 =back
19406
19407 B<use_numbers>
19408
19409 B<no_header>, B<no_ending>
19410
19411 =over 4
19412
19413 =item Output
19414
19415 B<diag>
19416
19417 =back
19418
19419 B<_print>
19420
19421 B<output>, B<failure_output>, B<todo_output>
19422
19423 =over 4
19424
19425 =item Test Status and Info
19426
19427 B<current_test>
19428
19429 =back
19430
19431 B<summary>
19432
19433 B<details>
19434
19435 B<todo>
19436
19437 B<caller>
19438
19439 B<_sanity_check>
19440
19441 B<_whoa>
19442
19443 B<_my_exit>
19444
19445 =over 4
19446
19447 =item THREADS
19448
19449 =item EXAMPLES
19450
19451 =item SEE ALSO
19452
19453 =item AUTHORS
19454
19455 =item COPYRIGHT
19456
19457 =back
19458
19459 =head2 Test::Harness - run perl standard test scripts with statistics
19460
19461 =over 4
19462
19463 =item SYNOPSIS
19464
19465 =item DESCRIPTION
19466
19467 =over 4
19468
19469 =item The test script output
19470
19471 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
19472 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
19473 else>
19474
19475 =item Taint mode
19476
19477 =item Configuration variables.
19478
19479 B<$Test::Harness::verbose>, B<$Test::Harness::switches>
19480
19481 =item Failure
19482
19483 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
19484 Failed>
19485
19486 =item Functions
19487
19488 B<runtests>
19489
19490 =back
19491
19492 =back
19493
19494 B<_all_ok>
19495
19496 B<_globdir>
19497
19498 B<_run_all_tests>
19499
19500 B<_mk_leader>
19501
19502 B<_leader_width>
19503
19504 =over 4
19505
19506 =item EXPORT
19507
19508 =item DIAGNOSTICS
19509
19510 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
19511 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
19512 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
19513 %s>, C<FAILED--Further testing stopped: %s>
19514
19515 =item ENVIRONMENT
19516
19517 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
19518 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
19519 C<HARNESS_OK_SLOW>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
19520
19521 =item EXAMPLE
19522
19523 =item SEE ALSO
19524
19525 =item AUTHORS
19526
19527 =item LICENSE
19528
19529 =item TODO
19530
19531 =item BUGS
19532
19533 =back
19534
19535 =head2 Test::Harness::Assert - simple assert
19536
19537 =over 4
19538
19539 =item SYNOPSIS
19540
19541 =item DESCRIPTION
19542
19543 =over 4
19544
19545 =item Functions
19546
19547 B<assert>
19548
19549 =back
19550
19551 =back
19552
19553 =over 4
19554
19555 =item AUTHOR
19556
19557 =item SEE ALSO
19558
19559 =back
19560
19561 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
19562
19563 =over 4
19564
19565 =item SYNOPSIS
19566
19567 =item DESCRIPTION
19568
19569 =back
19570
19571 =head2 Test::Harness::Straps - detailed analysis of test results
19572
19573 =over 4
19574
19575 =item SYNOPSIS
19576
19577 =item DESCRIPTION
19578
19579 =item Construction
19580
19581 =over 4
19582
19583 =item C<new>
19584
19585 =back
19586
19587 =back
19588
19589 =over 4
19590
19591 =item C<_init>
19592
19593 =back
19594
19595 =over 4
19596
19597 =item Analysis
19598
19599 =over 4
19600
19601 =item C<analyze>
19602
19603 =back
19604
19605 =back
19606
19607 =over 4
19608
19609 =item C<analyze_fh>
19610
19611 =back
19612
19613 =over 4
19614
19615 =item C<analyze_file>
19616
19617 =back
19618
19619 =over 4
19620
19621 =item C<_switches>
19622
19623 =back
19624
19625 =over 4
19626
19627 =item C<_INC2PERL5LIB>
19628
19629 =back
19630
19631 =over 4
19632
19633 =item C<_filtered_INC>
19634
19635 =back
19636
19637 =over 4
19638
19639 =item C<_restore_PERL5LIB>
19640
19641 =back
19642
19643 =over 4
19644
19645 =item Parsing
19646
19647 =over 4
19648
19649 =item C<_is_comment>
19650
19651 =back
19652
19653 =back
19654
19655 =over 4
19656
19657 =item C<_is_header>
19658
19659 =back
19660
19661 =over 4
19662
19663 =item C<_is_test>
19664
19665 =back
19666
19667 =over 4
19668
19669 =item C<_is_bail_out>
19670
19671 =back
19672
19673 =over 4
19674
19675 =item C<_reset_file_state>
19676
19677 =back
19678
19679 =over 4
19680
19681 =item Results
19682
19683 =over 4
19684
19685 =item C<_detailize>
19686
19687 =back
19688
19689 =back
19690
19691 =over 4
19692
19693 =item EXAMPLES
19694
19695 =item AUTHOR
19696
19697 =item SEE ALSO
19698
19699 =back
19700
19701 =head2 Test::More - yet another framework for writing test scripts
19702
19703 =over 4
19704
19705 =item SYNOPSIS
19706
19707 =item DESCRIPTION
19708
19709 =over 4
19710
19711 =item I love it when a plan comes together
19712
19713 =back
19714
19715 =back
19716
19717 =over 4
19718
19719 =item Test names
19720
19721 =item I'm ok, you're not ok.
19722
19723 B<ok>
19724
19725 =back
19726
19727 B<is>, B<isnt>
19728
19729 B<like>
19730
19731 B<unlike>
19732
19733 B<cmp_ok>
19734
19735 B<can_ok>
19736
19737 B<isa_ok>
19738
19739 B<pass>, B<fail>
19740
19741 =over 4
19742
19743 =item Diagnostics
19744
19745 B<diag>
19746
19747 =back
19748
19749 =over 4
19750
19751 =item Module tests
19752
19753 B<use_ok>
19754
19755 =back
19756
19757 B<require_ok>
19758
19759 =over 4
19760
19761 =item Conditional tests
19762
19763 B<SKIP: BLOCK>
19764
19765 =back
19766
19767 B<TODO: BLOCK>, B<todo_skip>
19768
19769 When do I use SKIP vs. TODO?
19770
19771 =over 4
19772
19773 =item Comparison functions
19774
19775 B<is_deeply>
19776
19777 =back
19778
19779 B<eq_array>
19780
19781 B<eq_hash>
19782
19783 B<eq_set>
19784
19785 =over 4
19786
19787 =item Extending and Embedding Test::More
19788
19789 B<builder>
19790
19791 =back
19792
19793 =over 4
19794
19795 =item NOTES
19796
19797 =item BUGS and CAVEATS
19798
19799 Making your own ok(), The eq_* family has some caveats, Test::Harness
19800 upgrades
19801
19802 =item HISTORY
19803
19804 =item SEE ALSO
19805
19806 =item AUTHORS
19807
19808 =item COPYRIGHT
19809
19810 =back
19811
19812 =head2 Test::Simple - Basic utilities for writing tests.
19813
19814 =over 4
19815
19816 =item SYNOPSIS
19817
19818 =item DESCRIPTION
19819
19820 B<ok>
19821
19822 =back
19823
19824 =over 4
19825
19826 =item EXAMPLE
19827
19828 =item CAVEATS
19829
19830 =item NOTES
19831
19832 =item HISTORY
19833
19834 =item SEE ALSO
19835
19836 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
19837 L<Test::Harness>
19838
19839 =item AUTHORS
19840
19841 =item COPYRIGHT
19842
19843 =back
19844
19845 =head2 Test::Tutorial - A tutorial about writing really basic tests
19846
19847 =over 4
19848
19849 =item DESCRIPTION
19850
19851 =over 4
19852
19853 =item Nuts and bolts of testing.
19854
19855 =item Where to start?
19856
19857 =item Names
19858
19859 =item Test the manual
19860
19861 =item Sometimes the tests are wrong
19862
19863 =item Testing lots of values
19864
19865 =item Informative names
19866
19867 =item Skipping tests
19868
19869 =item Todo tests
19870
19871 =item Testing with taint mode.
19872
19873 =back
19874
19875 =item FOOTNOTES
19876
19877 =item AUTHORS
19878
19879 =item COPYRIGHT
19880
19881 =back
19882
19883 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
19884
19885 =over 4
19886
19887 =item SYNOPSIS
19888
19889 =item DESCRIPTION
19890
19891 =item EXAMPLE
19892
19893 =back
19894
19895 =head2 Text::Balanced - Extract delimited text sequences from strings.
19896
19897 =over 4
19898
19899 =item SYNOPSIS
19900
19901 =item DESCRIPTION
19902
19903 =over 4
19904
19905 =item General behaviour in list contexts
19906
19907 [0], [1], [2]
19908
19909 =item General behaviour in scalar and void contexts
19910
19911 =item A note about prefixes
19912
19913 =item C<extract_delimited>
19914
19915 =item C<extract_bracketed>
19916
19917 =item C<extract_variable>
19918
19919 [0], [1], [2]
19920
19921 =item C<extract_tagged>
19922
19923 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
19924 [0], [1], [2], [3], [4], [5]
19925
19926 =item C<gen_extract_tagged>
19927
19928 =item C<extract_quotelike>
19929
19930 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
19931
19932 =item C<extract_quotelike> and "here documents"
19933
19934 [0], [1], [2], [3], [4], [5], [6], [7..10]
19935
19936 =item C<extract_codeblock>
19937
19938 =item C<extract_multiple>
19939
19940 =item C<gen_delimited_pat>
19941
19942 =back
19943
19944 =item DIAGNOSTICS
19945
19946  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>, 
19947 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
19948 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">, 
19949 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
19950 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
19951 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
19952 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
19953 after dereferencer>, C<Did not find expected opening bracket at %s>,
19954 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
19955 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
19956 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
19957 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
19958 tag>
19959
19960 =item AUTHOR
19961
19962 =item BUGS AND IRRITATIONS
19963
19964 =item COPYRIGHT
19965
19966 =back
19967
19968 =head2 Text::ParseWords - parse text into an array of tokens or array of
19969 arrays
19970
19971 =over 4
19972
19973 =item SYNOPSIS
19974
19975 =item DESCRIPTION
19976
19977 =item EXAMPLES
19978
19979 =item AUTHORS
19980
19981 =back
19982
19983 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
19984 by Knuth
19985
19986 =over 4
19987
19988 =item SYNOPSIS
19989
19990 =item DESCRIPTION
19991
19992 =item EXAMPLES
19993
19994 =item LIMITATIONS
19995
19996 =item AUTHOR
19997
19998 =back
19999
20000 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
20001 unexpand(1)
20002
20003 =over 4
20004
20005 =item SYNOPSIS
20006
20007 =item DESCRIPTION
20008
20009 =item BUGS
20010
20011 =item AUTHOR
20012
20013 =back
20014
20015 =head2 Text::Wrap - line wrapping to form simple paragraphs
20016
20017 =over 4
20018
20019 =item SYNOPSIS 
20020
20021 =item DESCRIPTION
20022
20023 =item OVERRIDES
20024
20025 =item EXAMPLE
20026
20027 =item AUTHOR
20028
20029 =back
20030
20031 =head2 Thread - manipulate threads in Perl (for old code only)
20032
20033 =over 4
20034
20035 =item CAVEAT
20036
20037 =item SYNOPSIS
20038
20039 =item DESCRIPTION
20040
20041 =item FUNCTIONS
20042
20043 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
20044 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
20045 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
20046
20047 =item METHODS
20048
20049 join, eval, detach, equal, tid, flags, done
20050
20051 =item LIMITATIONS
20052
20053 =item SEE ALSO
20054
20055 =back
20056
20057 =head2 Thread::Queue - thread-safe queues
20058
20059 =over 4
20060
20061 =item SYNOPSIS
20062
20063 =item DESCRIPTION
20064
20065 =item FUNCTIONS AND METHODS
20066
20067 new, enqueue LIST, dequeue, dequeue_nb, pending
20068
20069 =item SEE ALSO
20070
20071 =back
20072
20073 =head2 Thread::Semaphore - thread-safe semaphores
20074
20075 =over 4
20076
20077 =item SYNOPSIS
20078
20079 =item DESCRIPTION
20080
20081 =item FUNCTIONS AND METHODS
20082
20083 new, new NUMBER, down, down NUMBER, up, up NUMBER
20084
20085 =back
20086
20087 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
20088 (for old code)
20089
20090 =over 4
20091
20092 =item CAVEAT
20093
20094 =item SYNOPSIS
20095
20096 =item DESCRIPTION
20097
20098 =item BUGS
20099
20100 =back
20101
20102 =head2 Thread::Specific - thread-specific keys
20103
20104 =over 4
20105
20106 =item SYNOPSIS
20107
20108 =item DESCRIPTION
20109
20110 =back
20111
20112 =head2 Tie::Array - base class for tied arrays
20113
20114 =over 4
20115
20116 =item SYNOPSIS
20117
20118 =item DESCRIPTION
20119
20120 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
20121 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
20122 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
20123 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
20124
20125 =item CAVEATS
20126
20127 =item AUTHOR
20128
20129 =back
20130
20131 =head2 Tie::File - Access the lines of a disk file via a Perl array
20132
20133 =over 4
20134
20135 =item SYNOPSIS
20136
20137 =item DESCRIPTION
20138
20139 =over 4
20140
20141 =item C<recsep>
20142
20143 =item C<autochomp>
20144
20145 =item C<mode>
20146
20147 =item C<memory>
20148
20149 =item C<dw_size>
20150
20151 =item Option Format
20152
20153 =back
20154
20155 =item Public Methods
20156
20157 =over 4
20158
20159 =item C<flock>
20160
20161 =item C<autochomp>
20162
20163 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
20164
20165 =item C<offset>
20166
20167 =back
20168
20169 =item Tying to an already-opened filehandle
20170
20171 =item Deferred Writing
20172
20173 =over 4
20174
20175 =item Autodeferring
20176
20177 =back
20178
20179 =item CONCURRENT ACCESS TO FILES
20180
20181 =item CAVEATS
20182
20183 =item SUBCLASSING
20184
20185 =item WHAT ABOUT C<DB_File>?
20186
20187 =item AUTHOR
20188
20189 =item LICENSE
20190
20191 =item WARRANTY
20192
20193 =item THANKS
20194
20195 =item TODO
20196
20197 =back
20198
20199 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
20200 handles
20201
20202 =over 4
20203
20204 =item SYNOPSIS
20205
20206 =item DESCRIPTION
20207
20208 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
20209 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
20210 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
20211 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
20212
20213 =item MORE INFORMATION
20214
20215 =item COMPATIBILITY
20216
20217 =back
20218
20219 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
20220 tied hashes
20221
20222 =over 4
20223
20224 =item SYNOPSIS
20225
20226 =item DESCRIPTION
20227
20228 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
20229 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
20230
20231 =item Inheriting from B<Tie::StdHash>
20232
20233 =item Inheriting from B<Tie::ExtraHash>
20234
20235 =item C<UNTIE> and C<DESTROY>
20236
20237 =item MORE INFORMATION
20238
20239 =back
20240
20241 =head2 Tie::Memoize - add data to hash when needed
20242
20243 =over 4
20244
20245 =item SYNOPSIS
20246
20247 =item DESCRIPTION
20248
20249 =item Inheriting from B<Tie::Memoize>
20250
20251 =item EXAMPLE
20252
20253 =item BUGS
20254
20255 =item AUTHOR
20256
20257 =back
20258
20259 =head2 Tie::RefHash - use references as hash keys
20260
20261 =over 4
20262
20263 =item SYNOPSIS
20264
20265 =item DESCRIPTION
20266
20267 =item EXAMPLE
20268
20269 =item AUTHOR
20270
20271 =item VERSION
20272
20273 =item SEE ALSO
20274
20275 =back
20276
20277 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
20278 scalars
20279
20280 =over 4
20281
20282 =item SYNOPSIS
20283
20284 =item DESCRIPTION
20285
20286 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
20287
20288 =item MORE INFORMATION
20289
20290 =back
20291
20292 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
20293
20294 =over 4
20295
20296 =item SYNOPSIS
20297
20298 =item DESCRIPTION
20299
20300 =item CAVEATS
20301
20302 =back
20303
20304 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
20305 timers
20306
20307 =over 4
20308
20309 =item SYNOPSIS
20310
20311 =item DESCRIPTION
20312
20313 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
20314 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
20315 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer (
20316 $which, $floating_seconds [, $interval_floating_seconds ] ), getitimer (
20317 $which )
20318
20319 =item EXAMPLES
20320
20321 =item C API
20322
20323 =item DIAGNOSTICS
20324
20325 =over 4
20326
20327 =item negative time not invented yet
20328
20329 =item internal error: useconds < 0 (unsigned ... signed ...)
20330
20331 =back
20332
20333 =item CAVEATS
20334
20335 =item AUTHORS
20336
20337 =item COPYRIGHT AND LICENSE
20338
20339 =back
20340
20341 =head2 Time::Local - efficiently compute time from local and GMT time
20342
20343 =over 4
20344
20345 =item SYNOPSIS
20346
20347 =item DESCRIPTION
20348
20349 =item IMPLEMENTATION
20350
20351 =item BUGS
20352
20353 =item SUPPORT
20354
20355 =item AUTHOR
20356
20357 =back
20358
20359 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
20360 function
20361
20362 =over 4
20363
20364 =item SYNOPSIS
20365
20366 =item DESCRIPTION
20367
20368 =item NOTE
20369
20370 =item AUTHOR
20371
20372 =back
20373
20374 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
20375 function
20376
20377 =over 4
20378
20379 =item SYNOPSIS
20380
20381 =item DESCRIPTION
20382
20383 =item NOTE
20384
20385 =item AUTHOR
20386
20387 =back
20388
20389 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
20390
20391 =over 4
20392
20393 =item SYNOPSIS
20394
20395 =item DESCRIPTION
20396
20397 =item AUTHOR
20398
20399 =back
20400
20401 =head2 UNIVERSAL - base class for ALL classes (blessed references)
20402
20403 =over 4
20404
20405 =item SYNOPSIS
20406
20407 =item DESCRIPTION
20408
20409 C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<isa( VAL, TYPE )>,
20410 C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD ) >>, C<<
20411 CLASS->can( METHOD ) >>, C<can( VAL, METHOD )>, C<VERSION ( [ REQUIRE ] )>
20412
20413 =item EXPORTS
20414
20415 =back
20416
20417 =head2 Unicode::Collate - Unicode Collation Algorithm
20418
20419 =over 4
20420
20421 =item SYNOPSIS
20422
20423 =item DESCRIPTION
20424
20425 =over 4
20426
20427 =item Constructor and Tailoring
20428
20429 UCA_Version, alternate, backwards, entry, ignoreName, ignoreChar, level,
20430 normalization, overrideCJK, overrideHangul, preprocess, rearrange, table,
20431 undefName, undefChar, katakana_before_hiragana, upper_before_lower
20432
20433 =item Methods for Collation
20434
20435 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
20436 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
20437 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
20438 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
20439 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
20440 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
20441 $Collator-E<gt>viewSortKey($string)>
20442
20443 =item Methods for Searching
20444
20445 C<$position = $Collator-E<gt>index($string, $substring[, $position])>,
20446 C<($position, $length) = $Collator-E<gt>index($string, $substring[,
20447 $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>,
20448 C<($match)   = $Collator-E<gt>match($string, $substring)>, C<@match =
20449 $Collator-E<gt>gmatch($string, $substring)>, C<$count =
20450 $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count =
20451 $Collator-E<gt>gsubst($string, $substring, $replacement)>
20452
20453 =item Other Methods
20454
20455 C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, UCA_Version,
20456 Base_Unicode_Version
20457
20458 =item EXPORT
20459
20460 =item CAVEAT
20461
20462 =item Conformance Test
20463
20464 =back
20465
20466 =item AUTHOR
20467
20468 =item SEE ALSO
20469
20470 http://www.unicode.org/reports/tr10/,
20471 http://www.unicode.org/reports/tr10/allkeys.txt,
20472 http://www.unicode.org/reports/tr10/CollationTest.html
20473 http://www.unicode.org/reports/tr10/CollationTest.zip,
20474 http://www.unicode.org/reports/tr15/, L<Unicode::Normalize>
20475
20476 =back
20477
20478 =head2 Unicode::Normalize - Unicode Normalization Forms
20479
20480 =over 4
20481
20482 =item SYNOPSIS
20483
20484 =item DESCRIPTION
20485
20486 =over 4
20487
20488 =item Normalization Forms
20489
20490 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
20491 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
20492 C<$normalized_string = normalize($form_name, $string)>
20493
20494 =item Decomposition and Composition
20495
20496 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
20497 decompose($string, $useCompatMapping)>, C<$reordered_string  =
20498 reorder($string)>, C<$composed_string   = compose($string)>
20499
20500 =item Quick Check
20501
20502 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
20503 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
20504 check($form_name, $string)>
20505
20506 =item Character Data
20507
20508 C<$canonical_decomposed = getCanon($codepoint)>,
20509 C<$compatibility_decomposed = getCompat($codepoint)>,
20510 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
20511 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
20512 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
20513 C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>,
20514 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
20515
20516 =item EXPORT
20517
20518 =back
20519
20520 =item AUTHOR
20521
20522 =item SEE ALSO
20523
20524 http://www.unicode.org/unicode/reports/tr15/,
20525 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt
20526
20527 =back
20528
20529 =head2 Unicode::UCD - Unicode character database
20530
20531 =over 4
20532
20533 =item SYNOPSIS
20534
20535 =item DESCRIPTION
20536
20537 =back
20538
20539 =over 4
20540
20541 =item charinfo
20542
20543 =back
20544
20545 =over 4
20546
20547 =item charblock
20548
20549 =back
20550
20551 =over 4
20552
20553 =item charscript
20554
20555 =back
20556
20557 =over 4
20558
20559 =item charblocks
20560
20561 =back
20562
20563 =over 4
20564
20565 =item charscripts
20566
20567 =back
20568
20569 =over 4
20570
20571 =item Blocks versus Scripts
20572
20573 =item Matching Scripts and Blocks
20574
20575 =item Code Point Arguments
20576
20577 =item charinrange
20578
20579 =back
20580
20581 =over 4
20582
20583 =item compexcl
20584
20585 =back
20586
20587 =over 4
20588
20589 =item casefold
20590
20591 =back
20592
20593 =over 4
20594
20595 =item casespec
20596
20597 =back
20598
20599 =over 4
20600
20601 =item Unicode::UCD::UnicodeVersion
20602
20603 =back
20604
20605 =over 4
20606
20607 =item Implementation Note
20608
20609 =back
20610
20611 =over 4
20612
20613 =item BUGS
20614
20615 =item AUTHOR
20616
20617 =back
20618
20619 =head2 User::grent - by-name interface to Perl's built-in getgr*()
20620 functions
20621
20622 =over 4
20623
20624 =item SYNOPSIS
20625
20626 =item DESCRIPTION
20627
20628 =item NOTE
20629
20630 =item AUTHOR
20631
20632 =back
20633
20634 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
20635 functions
20636
20637 =over 4
20638
20639 =item SYNOPSIS
20640
20641 =item DESCRIPTION
20642
20643 =over 4
20644
20645 =item System Specifics
20646
20647 =back
20648
20649 =item NOTE
20650
20651 =item AUTHOR
20652
20653 =item HISTORY
20654
20655 March 18th, 2000
20656
20657 =back
20658
20659 =head2 Win32 - Interfaces to some Win32 API Functions
20660
20661 =over 4
20662
20663 =item DESCRIPTION
20664
20665 =over 4
20666
20667 =item Alphabetical Listing of Win32 Functions
20668
20669 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
20670 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
20671 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
20672 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
20673 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFolderPath(FOLDER [,
20674 CREATE]), Win32::GetFullPathName(FILENAME), Win32::GetLastError(),
20675 Win32::GetLongPathName(PATHNAME), Win32::GetNextAvailDrive(),
20676 Win32::GetOSVersion(), Win32::GetOSName(),
20677 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
20678 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
20679 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
20680 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
20681 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
20682 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
20683 Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
20684 Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
20685 Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
20686 Win32::UnregisterServer(LIBRARYNAME)
20687
20688 =back
20689
20690 =back
20691
20692 =head2 XSLoader - Dynamically load C libraries into Perl code
20693
20694 =over 4
20695
20696 =item SYNOPSIS
20697
20698 =item DESCRIPTION
20699
20700 =over 4
20701
20702 =item Migration from C<DynaLoader>
20703
20704 =item Backward compatible boilerplate
20705
20706 =back
20707
20708 =item Order of initialization: early load()
20709
20710 =over 4
20711
20712 =item The most hairy case
20713
20714 =back
20715
20716 =item LIMITATIONS
20717
20718 =item AUTHOR
20719
20720 =back
20721
20722 =head1 AUXILIARY DOCUMENTATION
20723
20724 Here should be listed all the extra programs' documentation, but they
20725 don't all have manual pages yet:
20726
20727 =over 4
20728
20729 =item a2p
20730
20731 =item c2ph
20732
20733 =item dprofpp
20734
20735 =item h2ph
20736
20737 =item h2xs
20738
20739 =item perlbug
20740
20741 =item perldoc
20742
20743 =item pl2pm
20744
20745 =item pod2html
20746
20747 =item pod2man
20748
20749 =item s2p
20750
20751 =item splain
20752
20753 =item xsubpp
20754
20755 =back
20756
20757 =head1 AUTHOR
20758
20759 Larry Wall <F<larry@wall.org>>, with the help of oodles
20760 of other folks.
20761