Upgrade to Test::Harness 2.38.
[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.35 $, $Date: 2003/08/24
938 05:26:59 $)
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.52 $, $Date: 2003/10/02
1025 04:44:33 $)
1026
1027 =over 4
1028
1029 =item DESCRIPTION
1030
1031 =item Data: Numbers
1032
1033 =over 4
1034
1035 =item Why am I getting long decimals (eg, 19.9499999999999) instead of the
1036 numbers I should be getting (eg, 19.95)?
1037
1038 =item Why is int() broken?
1039
1040 =item Why isn't my octal data interpreted correctly?
1041
1042 =item Does Perl have a round() function?  What about ceil() and floor()? 
1043 Trig functions?
1044
1045 =item How do I convert between numeric representations/bases/radixes?
1046
1047 How do I convert hexadecimal into decimal, How do I convert from decimal to
1048 hexadecimal, How do I convert from octal to decimal, How do I convert from
1049 decimal to octal, How do I convert from binary to decimal, How do I convert
1050 from decimal to binary
1051
1052 =item Why doesn't & work the way I want it to?
1053
1054 =item How do I multiply matrices?
1055
1056 =item How do I perform an operation on a series of integers?
1057
1058 =item How can I output Roman numerals?
1059
1060 =item Why aren't my random numbers random?
1061
1062 =item How do I get a random number between X and Y?
1063
1064 =back
1065
1066 =item Data: Dates
1067
1068 =over 4
1069
1070 =item How do I find the day or week of the year?
1071
1072 =item How do I find the current century or millennium?
1073
1074 =item How can I compare two dates and find the difference?
1075
1076 =item How can I take a string and turn it into epoch seconds?
1077
1078 =item How can I find the Julian Day?
1079
1080 =item How do I find yesterday's date?
1081
1082 =item Does Perl have a Year 2000 problem?  Is Perl Y2K compliant?
1083
1084 =back
1085
1086 =item Data: Strings
1087
1088 =over 4
1089
1090 =item How do I validate input?
1091
1092 =item How do I unescape a string?
1093
1094 =item How do I remove consecutive pairs of characters?
1095
1096 =item How do I expand function calls in a string?
1097
1098 =item How do I find matching/nesting anything?
1099
1100 =item How do I reverse a string?
1101
1102 =item How do I expand tabs in a string?
1103
1104 =item How do I reformat a paragraph?
1105
1106 =item How can I access or change N characters of a string?
1107
1108 =item How do I change the Nth occurrence of something?
1109
1110 =item How can I count the number of occurrences of a substring within a
1111 string?
1112
1113 =item How do I capitalize all the words on one line?
1114
1115 =item How can I split a [character] delimited string except when inside
1116 [character]?
1117
1118 =item How do I strip blank space from the beginning/end of a string?
1119
1120 =item How do I pad a string with blanks or pad a number with zeroes?
1121
1122 =item How do I extract selected columns from a string?
1123
1124 =item How do I find the soundex value of a string?
1125
1126 =item How can I expand variables in text strings?
1127
1128 =item What's wrong with always quoting "$vars"?
1129
1130 =item Why don't my E<lt>E<lt>HERE documents work?
1131
1132 There must be no space after the E<lt>E<lt> part, There (probably) should
1133 be a semicolon at the end, You can't (easily) have any space in front of
1134 the tag
1135
1136 =back
1137
1138 =item Data: Arrays
1139
1140 =over 4
1141
1142 =item What is the difference between a list and an array?
1143
1144 =item What is the difference between $array[1] and @array[1]?
1145
1146 =item How can I remove duplicate elements from a list or array?
1147
1148 a), b), c), d), e)
1149
1150 =item How can I tell whether a certain element is contained in a list or
1151 array?
1152
1153 =item How do I compute the difference of two arrays?  How do I compute the
1154 intersection of two arrays?
1155
1156 =item How do I test whether two arrays or hashes are equal?
1157
1158 =item How do I find the first array element for which a condition is true?
1159
1160 =item How do I handle linked lists?
1161
1162 =item How do I handle circular lists?
1163
1164 =item How do I shuffle an array randomly?
1165
1166 =item How do I process/modify each element of an array?
1167
1168 =item How do I select a random element from an array?
1169
1170 =item How do I permute N elements of a list?
1171
1172 =item How do I sort an array by (anything)?
1173
1174 =item How do I manipulate arrays of bits?
1175
1176 =item Why does defined() return true on empty arrays and hashes?
1177
1178 =back
1179
1180 =item Data: Hashes (Associative Arrays)
1181
1182 =over 4
1183
1184 =item How do I process an entire hash?
1185
1186 =item What happens if I add or remove keys from a hash while iterating over
1187 it?
1188
1189 =item How do I look up a hash element by value?
1190
1191 =item How can I know how many entries are in a hash?
1192
1193 =item How do I sort a hash (optionally by value instead of key)?
1194
1195 =item How can I always keep my hash sorted?
1196
1197 =item What's the difference between "delete" and "undef" with hashes?
1198
1199 =item Why don't my tied hashes make the defined/exists distinction?
1200
1201 =item How do I reset an each() operation part-way through?
1202
1203 =item How can I get the unique keys from two hashes?
1204
1205 =item How can I store a multidimensional array in a DBM file?
1206
1207 =item How can I make my hash remember the order I put elements into it?
1208
1209 =item Why does passing a subroutine an undefined element in a hash create
1210 it?
1211
1212 =item How can I make the Perl equivalent of a C structure/C++ class/hash or
1213 array of hashes or arrays?
1214
1215 =item How can I use a reference as a hash key?
1216
1217 =back
1218
1219 =item Data: Misc
1220
1221 =over 4
1222
1223 =item How do I handle binary data correctly?
1224
1225 =item How do I determine whether a scalar is a number/whole/integer/float?
1226
1227 =item How do I keep persistent data across program calls?
1228
1229 =item How do I print out or copy a recursive data structure?
1230
1231 =item How do I define methods for every class/object?
1232
1233 =item How do I verify a credit card checksum?
1234
1235 =item How do I pack arrays of doubles or floats for XS code?
1236
1237 =back
1238
1239 =item AUTHOR AND COPYRIGHT
1240
1241 =back
1242
1243 =head2 perlfaq5 - Files and Formats ($Revision: 1.28 $, $Date: 2003/01/26
1244 17:45:46 $)
1245
1246 =over 4
1247
1248 =item DESCRIPTION
1249
1250 =over 4
1251
1252 =item How do I flush/unbuffer an output filehandle?  Why must I do this?
1253
1254 =item How do I change one line in a file/delete a line in a file/insert a
1255 line in the middle of a file/append to the beginning of a file?
1256
1257 =item How do I count the number of lines in a file?
1258
1259 =item How can I use Perl's C<-i> option from within a program?
1260
1261 =item How do I make a temporary file name?
1262
1263 =item How can I manipulate fixed-record-length files?
1264
1265 =item How can I make a filehandle local to a subroutine?  How do I pass
1266 filehandles between subroutines?  How do I make an array of filehandles?
1267
1268 =item How can I use a filehandle indirectly?
1269
1270 =item How can I set up a footer format to be used with write()?
1271
1272 =item How can I write() into a string?
1273
1274 =item How can I output my numbers with commas added?
1275
1276 =item How can I translate tildes (~) in a filename?
1277
1278 =item How come when I open a file read-write it wipes it out?
1279
1280 =item Why do I sometimes get an "Argument list too long" when I use
1281 E<lt>*E<gt>?
1282
1283 =item Is there a leak/bug in glob()?
1284
1285 =item How can I open a file with a leading ">" or trailing blanks?
1286
1287 =item How can I reliably rename a file?
1288
1289 =item How can I lock a file?
1290
1291 =item Why can't I just open(FH, "E<gt>file.lock")?
1292
1293 =item I still don't get locking.  I just want to increment the number in
1294 the file.  How can I do this?
1295
1296 =item All I want to do is append a small amount of text to the end of a
1297 file.  Do I still have to use locking?
1298
1299 =item How do I randomly update a binary file?
1300
1301 =item How do I get a file's timestamp in perl?
1302
1303 =item How do I set a file's timestamp in perl?
1304
1305 =item How do I print to more than one file at once?
1306
1307 =item How can I read in an entire file all at once?
1308
1309 =item How can I read in a file by paragraphs?
1310
1311 =item How can I read a single character from a file?  From the keyboard?
1312
1313 =item How can I tell whether there's a character waiting on a filehandle?
1314
1315 =item How do I do a C<tail -f> in perl?
1316
1317 =item How do I dup() a filehandle in Perl?
1318
1319 =item How do I close a file descriptor by number?
1320
1321 =item Why can't I use "C:\temp\foo" in DOS paths?  Why doesn't
1322 `C:\temp\foo.exe` work?
1323
1324 =item Why doesn't glob("*.*") get all the files?
1325
1326 =item Why does Perl let me delete read-only files?  Why does C<-i> clobber
1327 protected files?  Isn't this a bug in Perl?
1328
1329 =item How do I select a random line from a file?
1330
1331 =item Why do I get weird spaces when I print an array of lines?
1332
1333 =back
1334
1335 =item AUTHOR AND COPYRIGHT
1336
1337 =back
1338
1339 =head2 perlfaq6 - Regular Expressions ($Revision: 1.20 $, $Date: 2003/01/03
1340 20:05:28 $)
1341
1342 =over 4
1343
1344 =item DESCRIPTION
1345
1346 =over 4
1347
1348 =item How can I hope to use regular expressions without creating illegible
1349 and unmaintainable code?
1350
1351 Comments Outside the Regex, Comments Inside the Regex, Different Delimiters
1352
1353 =item I'm having trouble matching over more than one line.  What's wrong?
1354
1355 =item How can I pull out lines between two patterns that are themselves on
1356 different lines?
1357
1358 =item I put a regular expression into $/ but it didn't work. What's wrong?
1359
1360 =item How do I substitute case insensitively on the LHS while preserving
1361 case on the RHS?
1362
1363 =item How can I make C<\w> match national character sets?
1364
1365 =item How can I match a locale-smart version of C</[a-zA-Z]/>?
1366
1367 =item How can I quote a variable to use in a regex?
1368
1369 =item What is C</o> really for?
1370
1371 =item How do I use a regular expression to strip C style comments from a
1372 file?
1373
1374 =item Can I use Perl regular expressions to match balanced text?
1375
1376 =item What does it mean that regexes are greedy?  How can I get around it?
1377
1378 =item How do I process each word on each line?
1379
1380 =item How can I print out a word-frequency or line-frequency summary?
1381
1382 =item How can I do approximate matching?
1383
1384 =item How do I efficiently match many regular expressions at once?
1385
1386 =item Why don't word-boundary searches with C<\b> work for me?
1387
1388 =item Why does using $&, $`, or $' slow my program down?
1389
1390 =item What good is C<\G> in a regular expression?
1391
1392 =item Are Perl regexes DFAs or NFAs?  Are they POSIX compliant?
1393
1394 =item What's wrong with using grep in a void context?
1395
1396 =item How can I match strings with multibyte characters?
1397
1398 =item How do I match a pattern that is supplied by the user?
1399
1400 =back
1401
1402 =item AUTHOR AND COPYRIGHT
1403
1404 =back
1405
1406 =head2 perlfaq7 - General Perl Language Issues ($Revision: 1.15 $, $Date:
1407 2003/07/24 02:17:21 $)
1408
1409 =over 4
1410
1411 =item DESCRIPTION
1412
1413 =over 4
1414
1415 =item Can I get a BNF/yacc/RE for the Perl language?
1416
1417 =item What are all these $@%&* punctuation signs, and how do I know when to
1418 use them?
1419
1420 =item Do I always/never have to quote my strings or use semicolons and
1421 commas?
1422
1423 =item How do I skip some return values?
1424
1425 =item How do I temporarily block warnings?
1426
1427 =item What's an extension?
1428
1429 =item Why do Perl operators have different precedence than C operators?
1430
1431 =item How do I declare/create a structure?
1432
1433 =item How do I create a module?
1434
1435 =item How do I create a class?
1436
1437 =item How can I tell if a variable is tainted?
1438
1439 =item What's a closure?
1440
1441 =item What is variable suicide and how can I prevent it?
1442
1443 =item How can I pass/return a {Function, FileHandle, Array, Hash, Method,
1444 Regex}?
1445
1446 Passing Variables and Functions, Passing Filehandles, Passing Regexes,
1447 Passing Methods
1448
1449 =item How do I create a static variable?
1450
1451 =item What's the difference between dynamic and lexical (static) scoping? 
1452 Between local() and my()?
1453
1454 =item How can I access a dynamic variable while a similarly named lexical
1455 is in scope?
1456
1457 =item What's the difference between deep and shallow binding?
1458
1459 =item Why doesn't "my($foo) = E<lt>FILEE<gt>;" work right?
1460
1461 =item How do I redefine a builtin function, operator, or method?
1462
1463 =item What's the difference between calling a function as &foo and foo()?
1464
1465 =item How do I create a switch or case statement?
1466
1467 =item How can I catch accesses to undefined variables, functions, or
1468 methods?
1469
1470 =item Why can't a method included in this same file be found?
1471
1472 =item How can I find out my current package?
1473
1474 =item How can I comment out a large block of perl code?
1475
1476 =item How do I clear a package?
1477
1478 =item How can I use a variable as a variable name?
1479
1480 =item What does "bad interpreter" mean?
1481
1482 =back
1483
1484 =item AUTHOR AND COPYRIGHT
1485
1486 =back
1487
1488 =head2 perlfaq8 - System Interaction ($Revision: 1.17 $, $Date: 2003/01/26
1489 17:44:04 $)
1490
1491 =over 4
1492
1493 =item DESCRIPTION
1494
1495 =over 4
1496
1497 =item How do I find out which operating system I'm running under?
1498
1499 =item How come exec() doesn't return?
1500
1501 =item How do I do fancy stuff with the keyboard/screen/mouse?
1502
1503 Keyboard, Screen, Mouse
1504
1505 =item How do I print something out in color?
1506
1507 =item How do I read just one key without waiting for a return key?
1508
1509 =item How do I check whether input is ready on the keyboard?
1510
1511 =item How do I clear the screen?
1512
1513 =item How do I get the screen size?
1514
1515 =item How do I ask the user for a password?
1516
1517 =item How do I read and write the serial port?
1518
1519 lockfiles, open mode, end of line, flushing output, non-blocking input
1520
1521 =item How do I decode encrypted password files?
1522
1523 =item How do I start a process in the background?
1524
1525 STDIN, STDOUT, and STDERR are shared, Signals, Zombies
1526
1527 =item How do I trap control characters/signals?
1528
1529 =item How do I modify the shadow password file on a Unix system?
1530
1531 =item How do I set the time and date?
1532
1533 =item How can I sleep() or alarm() for under a second?
1534
1535 =item How can I measure time under a second?
1536
1537 =item How can I do an atexit() or setjmp()/longjmp()? (Exception handling)
1538
1539 =item Why doesn't my sockets program work under System V (Solaris)?  What
1540 does the error message "Protocol not supported" mean?
1541
1542 =item How can I call my system's unique C functions from Perl?
1543
1544 =item Where do I get the include files to do ioctl() or syscall()?
1545
1546 =item Why do setuid perl scripts complain about kernel problems?
1547
1548 =item How can I open a pipe both to and from a command?
1549
1550 =item Why can't I get the output of a command with system()?
1551
1552 =item How can I capture STDERR from an external command?
1553
1554 =item Why doesn't open() return an error when a pipe open fails?
1555
1556 =item What's wrong with using backticks in a void context?
1557
1558 =item How can I call backticks without shell processing?
1559
1560 =item Why can't my script read from STDIN after I gave it EOF (^D on Unix,
1561 ^Z on MS-DOS)?
1562
1563 =item How can I convert my shell script to perl?
1564
1565 =item Can I use perl to run a telnet or ftp session?
1566
1567 =item How can I write expect in Perl?
1568
1569 =item Is there a way to hide perl's command line from programs such as
1570 "ps"?
1571
1572 =item I {changed directory, modified my environment} in a perl script.  How
1573 come the change disappeared when I exited the script?  How do I get my
1574 changes to be visible?
1575
1576 Unix
1577
1578 =item How do I close a process's filehandle without waiting for it to
1579 complete?
1580
1581 =item How do I fork a daemon process?
1582
1583 =item How do I find out if I'm running interactively or not?
1584
1585 =item How do I timeout a slow event?
1586
1587 =item How do I set CPU limits?
1588
1589 =item How do I avoid zombies on a Unix system?
1590
1591 =item How do I use an SQL database?
1592
1593 =item How do I make a system() exit on control-C?
1594
1595 =item How do I open a file without blocking?
1596
1597 =item How do I install a module from CPAN?
1598
1599 =item What's the difference between require and use?
1600
1601 =item How do I keep my own module/library directory?
1602
1603 =item How do I add the directory my program lives in to the module/library
1604 search path?
1605
1606 =item How do I add a directory to my include path (@INC) at runtime?
1607
1608 =item What is socket.ph and where do I get it?
1609
1610 =back
1611
1612 =item AUTHOR AND COPYRIGHT
1613
1614 =back
1615
1616 =head2 perlfaq9 - Networking ($Revision: 1.15 $, $Date: 2003/01/31 17:36:57
1617 $)
1618
1619 =over 4
1620
1621 =item DESCRIPTION
1622
1623 =over 4
1624
1625 =item What is the correct form of response from a CGI script?
1626
1627 =item My CGI script runs from the command line but not the browser.  (500
1628 Server Error)
1629
1630 =item How can I get better error messages from a CGI program?
1631
1632 =item How do I remove HTML from a string?
1633
1634 =item How do I extract URLs?
1635
1636 =item How do I download a file from the user's machine?  How do I open a
1637 file on another machine?
1638
1639 =item How do I make a pop-up menu in HTML?
1640
1641 =item How do I fetch an HTML file?
1642
1643 =item How do I automate an HTML form submission?
1644
1645 =item How do I decode or create those %-encodings on the web?
1646
1647 =item How do I redirect to another page?
1648
1649 =item How do I put a password on my web pages?
1650
1651 =item How do I edit my .htpasswd and .htgroup files with Perl?
1652
1653 =item How do I make sure users can't enter values into a form that cause my
1654 CGI script to do bad things?
1655
1656 =item How do I parse a mail header?
1657
1658 =item How do I decode a CGI form?
1659
1660 =item How do I check a valid mail address?
1661
1662 =item How do I decode a MIME/BASE64 string?
1663
1664 =item How do I return the user's mail address?
1665
1666 =item How do I send mail?
1667
1668 =item How do I use MIME to make an attachment to a mail message?
1669
1670 =item How do I read mail?
1671
1672 =item How do I find out my hostname/domainname/IP address?
1673
1674 =item How do I fetch a news article or the active newsgroups?
1675
1676 =item How do I fetch/put an FTP file?
1677
1678 =item How can I do RPC in Perl?
1679
1680 =back
1681
1682 =item AUTHOR AND COPYRIGHT
1683
1684 =back
1685
1686 =head2 perlsyn - Perl syntax
1687
1688 =over 4
1689
1690 =item DESCRIPTION
1691
1692 =over 4
1693
1694 =item Declarations
1695
1696 =item Comments
1697
1698 =item Simple Statements
1699
1700 =item Truth and Falsehood
1701
1702 =item Statement Modifiers
1703
1704 =item Compound Statements
1705
1706 =item Loop Control
1707
1708 =item For Loops
1709
1710 =item Foreach Loops
1711
1712 =item Basic BLOCKs and Switch Statements
1713
1714 =item Goto
1715
1716 =item PODs: Embedded Documentation
1717
1718 =item Plain Old Comments (Not!)
1719
1720 =back
1721
1722 =back
1723
1724 =head2 perldata - Perl data types
1725
1726 =over 4
1727
1728 =item DESCRIPTION
1729
1730 =over 4
1731
1732 =item Variable names
1733
1734 =item Context
1735
1736 =item Scalar values
1737
1738 =item Scalar value constructors
1739
1740 =item List value constructors
1741
1742 =item Subscripts
1743
1744 =item Slices
1745
1746 =item Typeglobs and Filehandles
1747
1748 =back
1749
1750 =item SEE ALSO
1751
1752 =back
1753
1754 =head2 perlop - Perl operators and precedence
1755
1756 =over 4
1757
1758 =item DESCRIPTION
1759
1760 =over 4
1761
1762 =item Operator Precedence and Associativity
1763
1764 =item Terms and List Operators (Leftward)
1765
1766 =item The Arrow Operator
1767
1768 =item Auto-increment and Auto-decrement
1769
1770 =item Exponentiation
1771
1772 =item Symbolic Unary Operators
1773
1774 =item Binding Operators
1775
1776 =item Multiplicative Operators
1777
1778 =item Additive Operators
1779
1780 =item Shift Operators
1781
1782 =item Named Unary Operators
1783
1784 =item Relational Operators
1785
1786 =item Equality Operators
1787
1788 =item Bitwise And
1789
1790 =item Bitwise Or and Exclusive Or
1791
1792 =item C-style Logical And
1793
1794 =item C-style Logical Or
1795
1796 =item C-style Logical Defined-Or
1797
1798 =item Range Operators
1799
1800 =item Conditional Operator
1801
1802 =item Assignment Operators
1803
1804 =item Comma Operator
1805
1806 =item List Operators (Rightward)
1807
1808 =item Logical Not
1809
1810 =item Logical And
1811
1812 =item Logical or, Defined or, and Exclusive Or
1813
1814 =item C Operators Missing From Perl
1815
1816 unary &, unary *, (TYPE)
1817
1818 =item Quote and Quote-like Operators
1819
1820 =item Regexp Quote-Like Operators
1821
1822 ?PATTERN?, m/PATTERN/cgimosx, /PATTERN/cgimosx, q/STRING/, C<'STRING'>,
1823 qq/STRING/, "STRING", qr/STRING/imosx, qx/STRING/, `STRING`, qw/STRING/,
1824 s/PATTERN/REPLACEMENT/egimosx, tr/SEARCHLIST/REPLACEMENTLIST/cds,
1825 y/SEARCHLIST/REPLACEMENTLIST/cds, <<EOF
1826
1827 =item Gory details of parsing quoted constructs
1828
1829 Finding the end, Removal of backslashes before delimiters, Interpolation,
1830 C<<<'EOF'>, C<m''>, C<s'''>, C<tr///>, C<y///>, C<''>, C<q//>, C<"">,
1831 C<``>, C<qq//>, C<qx//>, C<< <file*glob> >>, C<?RE?>, C</RE/>, C<m/RE/>,
1832 C<s/RE/foo/>,, Interpolation of regular expressions, Optimization of
1833 regular expressions
1834
1835 =item I/O Operators
1836
1837 =item Constant Folding
1838
1839 =item Bitwise String Operators
1840
1841 =item Integer Arithmetic
1842
1843 =item Floating-point Arithmetic
1844
1845 =item Bigger Numbers
1846
1847 =back
1848
1849 =back
1850
1851 =head2 perlsub - Perl subroutines
1852
1853 =over 4
1854
1855 =item SYNOPSIS
1856
1857 =item DESCRIPTION
1858
1859 =over 4
1860
1861 =item Private Variables via my()
1862
1863 =item Persistent Private Variables
1864
1865 =item Temporary Values via local()
1866
1867 =item Lvalue subroutines
1868
1869 Lvalue subroutines are EXPERIMENTAL
1870
1871 =item Passing Symbol Table Entries (typeglobs)
1872
1873 =item When to Still Use local()
1874
1875 =item Pass by Reference
1876
1877 =item Prototypes
1878
1879 =item Constant Functions
1880
1881 =item Overriding Built-in Functions
1882
1883 =item Autoloading
1884
1885 =item Subroutine Attributes
1886
1887 =back
1888
1889 =item SEE ALSO
1890
1891 =back
1892
1893 =head2 perlfunc - Perl builtin functions
1894
1895 =over 4
1896
1897 =item DESCRIPTION
1898
1899 =over 4
1900
1901 =item Perl Functions by Category
1902
1903 Functions for SCALARs or strings, Regular expressions and pattern matching,
1904 Numeric functions, Functions for real @ARRAYs, Functions for list data,
1905 Functions for real %HASHes, Input and output functions, Functions for fixed
1906 length data or records, Functions for filehandles, files, or directories,
1907 Keywords related to the control flow of your perl program, Keywords related
1908 to scoping, Miscellaneous functions, Functions for processes and process
1909 groups, Keywords related to perl modules, Keywords related to classes and
1910 object-orientedness, Low-level socket functions, System V interprocess
1911 communication functions, Fetching user and group info, Fetching network
1912 info, Time-related functions, Functions new in perl5, Functions obsoleted
1913 in perl5
1914
1915 =item Portability
1916
1917 =item Alphabetical Listing of Perl Functions
1918
1919 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, abs VALUE, abs, accept
1920 NEWSOCKET,GENERICSOCKET, alarm SECONDS, alarm, atan2 Y,X, bind SOCKET,NAME,
1921 binmode FILEHANDLE, LAYER, binmode FILEHANDLE, bless REF,CLASSNAME, bless
1922 REF, caller EXPR, caller, chdir EXPR, chmod LIST, chomp VARIABLE, chomp(
1923 LIST ), chomp, chop VARIABLE, chop( LIST ), chop, chown LIST, chr NUMBER,
1924 chr, chroot FILENAME, chroot, close FILEHANDLE, close, closedir DIRHANDLE,
1925 connect SOCKET,NAME, continue BLOCK, cos EXPR, cos, crypt PLAINTEXT,SALT,
1926 dbmclose HASH, dbmopen HASH,DBNAME,MASK, defined EXPR, defined, delete
1927 EXPR, die LIST, do BLOCK, do SUBROUTINE(LIST), do EXPR, dump LABEL, dump,
1928 each HASH, eof FILEHANDLE, eof (), eof, eval EXPR, eval BLOCK, exec LIST,
1929 exec PROGRAM LIST, exists EXPR, exit EXPR, exp EXPR, exp, fcntl
1930 FILEHANDLE,FUNCTION,SCALAR, fileno FILEHANDLE, flock FILEHANDLE,OPERATION,
1931 fork, format, formline PICTURE,LIST, getc FILEHANDLE, getc, getlogin,
1932 getpeername SOCKET, getpgrp PID, getppid, getpriority WHICH,WHO, getpwnam
1933 NAME, getgrnam NAME, gethostbyname NAME, getnetbyname NAME, getprotobyname
1934 NAME, getpwuid UID, getgrgid GID, getservbyname NAME,PROTO, gethostbyaddr
1935 ADDR,ADDRTYPE, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
1936 getservbyport PORT,PROTO, getpwent, getgrent, gethostent, getnetent,
1937 getprotoent, getservent, setpwent, setgrent, sethostent STAYOPEN, setnetent
1938 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
1939 endhostent, endnetent, endprotoent, endservent, getsockname SOCKET,
1940 getsockopt SOCKET,LEVEL,OPTNAME, glob EXPR, glob, gmtime EXPR, goto LABEL,
1941 goto EXPR, goto &NAME, grep BLOCK LIST, grep EXPR,LIST, hex EXPR, hex,
1942 import, index STR,SUBSTR,POSITION, index STR,SUBSTR, int EXPR, int, ioctl
1943 FILEHANDLE,FUNCTION,SCALAR, join EXPR,LIST, keys HASH, kill SIGNAL, LIST,
1944 last LABEL, last, lc EXPR, lc, lcfirst EXPR, lcfirst, length EXPR, length,
1945 link OLDFILE,NEWFILE, listen SOCKET,QUEUESIZE, local EXPR, localtime EXPR,
1946 lock THING, log EXPR, log, lstat EXPR, lstat, m//, map BLOCK LIST, map
1947 EXPR,LIST, mkdir FILENAME,MASK, mkdir FILENAME, msgctl ID,CMD,ARG, msgget
1948 KEY,FLAGS, msgrcv ID,VAR,SIZE,TYPE,FLAGS, msgsnd ID,MSG,FLAGS, my EXPR, my
1949 TYPE EXPR, my EXPR : ATTRS, my TYPE EXPR : ATTRS, next LABEL, next, no
1950 Module VERSION LIST, no Module VERSION, no Module LIST, no Module, oct
1951 EXPR, oct, open FILEHANDLE,EXPR, open FILEHANDLE,MODE,EXPR, open
1952 FILEHANDLE,MODE,EXPR,LIST, open FILEHANDLE,MODE,REFERENCE, open FILEHANDLE,
1953 opendir DIRHANDLE,EXPR, ord EXPR, ord, our EXPR, our EXPR TYPE, our EXPR :
1954 ATTRS, our TYPE EXPR : ATTRS, pack TEMPLATE,LIST, package NAMESPACE,
1955 package, pipe READHANDLE,WRITEHANDLE, pop ARRAY, pop, pos SCALAR, pos,
1956 print FILEHANDLE LIST, print LIST, print, printf FILEHANDLE FORMAT, LIST,
1957 printf FORMAT, LIST, prototype FUNCTION, push ARRAY,LIST, q/STRING/,
1958 qq/STRING/, qr/STRING/, qx/STRING/, qw/STRING/, quotemeta EXPR, quotemeta,
1959 rand EXPR, rand, read FILEHANDLE,SCALAR,LENGTH,OFFSET, read
1960 FILEHANDLE,SCALAR,LENGTH, readdir DIRHANDLE, readline EXPR, readlink EXPR,
1961 readlink, readpipe EXPR, recv SOCKET,SCALAR,LENGTH,FLAGS, redo LABEL, redo,
1962 ref EXPR, ref, rename OLDNAME,NEWNAME, require VERSION, require EXPR,
1963 require, reset EXPR, reset, return EXPR, return, reverse LIST, rewinddir
1964 DIRHANDLE, rindex STR,SUBSTR,POSITION, rindex STR,SUBSTR, rmdir FILENAME,
1965 rmdir, s///, scalar EXPR, seek FILEHANDLE,POSITION,WHENCE, seekdir
1966 DIRHANDLE,POS, select FILEHANDLE, select, select RBITS,WBITS,EBITS,TIMEOUT,
1967 semctl ID,SEMNUM,CMD,ARG, semget KEY,NSEMS,FLAGS, semop KEY,OPSTRING, send
1968 SOCKET,MSG,FLAGS,TO, send SOCKET,MSG,FLAGS, setpgrp PID,PGRP, setpriority
1969 WHICH,WHO,PRIORITY, setsockopt SOCKET,LEVEL,OPTNAME,OPTVAL, shift ARRAY,
1970 shift, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS, shmread ID,VAR,POS,SIZE,
1971 shmwrite ID,STRING,POS,SIZE, shutdown SOCKET,HOW, sin EXPR, sin, sleep
1972 EXPR, sleep, socket SOCKET,DOMAIN,TYPE,PROTOCOL, socketpair
1973 SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, sort SUBNAME LIST, sort BLOCK LIST,
1974 sort LIST, splice ARRAY,OFFSET,LENGTH,LIST, splice ARRAY,OFFSET,LENGTH,
1975 splice ARRAY,OFFSET, splice ARRAY, split /PATTERN/,EXPR,LIMIT, split
1976 /PATTERN/,EXPR, split /PATTERN/, split, sprintf FORMAT, LIST, format
1977 parameter index, flags, vector flag, (minimum) width, precision, or maximum
1978 width, size, order of arguments, sqrt EXPR, sqrt, srand EXPR, srand, stat
1979 FILEHANDLE, stat EXPR, stat, study SCALAR, study, sub NAME BLOCK, sub NAME
1980 (PROTO) BLOCK, sub NAME : ATTRS BLOCK, sub NAME (PROTO) : ATTRS BLOCK,
1981 substr EXPR,OFFSET,LENGTH,REPLACEMENT, substr EXPR,OFFSET,LENGTH, substr
1982 EXPR,OFFSET, symlink OLDFILE,NEWFILE, syscall NUMBER, LIST, sysopen
1983 FILEHANDLE,FILENAME,MODE, sysopen FILEHANDLE,FILENAME,MODE,PERMS, sysread
1984 FILEHANDLE,SCALAR,LENGTH,OFFSET, sysread FILEHANDLE,SCALAR,LENGTH, sysseek
1985 FILEHANDLE,POSITION,WHENCE, system LIST, system PROGRAM LIST, syswrite
1986 FILEHANDLE,SCALAR,LENGTH,OFFSET, syswrite FILEHANDLE,SCALAR,LENGTH,
1987 syswrite FILEHANDLE,SCALAR, tell FILEHANDLE, tell, telldir DIRHANDLE, tie
1988 VARIABLE,CLASSNAME,LIST, tied VARIABLE, time, times, tr///, truncate
1989 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, uc EXPR, uc, ucfirst EXPR,
1990 ucfirst, umask EXPR, umask, undef EXPR, undef, unlink LIST, unlink, unpack
1991 TEMPLATE,EXPR, unpack TEMPLATE, untie VARIABLE, unshift ARRAY,LIST, use
1992 Module VERSION LIST, use Module VERSION, use Module LIST, use Module, use
1993 VERSION, utime LIST, values HASH, vec EXPR,OFFSET,BITS, wait, waitpid
1994 PID,FLAGS, wantarray, warn LIST, write FILEHANDLE, write EXPR, write, y///
1995
1996 =back
1997
1998 =back
1999
2000 =head2 perlopentut - tutorial on opening things in Perl
2001
2002 =over 4
2003
2004 =item DESCRIPTION
2005
2006 =item Open E<agrave> la shell
2007
2008 =over 4
2009
2010 =item Simple Opens
2011
2012 =item Indirect Filehandles
2013
2014 =item Pipe Opens
2015
2016 =item The Minus File
2017
2018 =item Mixing Reads and Writes
2019
2020 =item Filters 
2021
2022 =back
2023
2024 =item Open E<agrave> la C
2025
2026 =over 4
2027
2028 =item Permissions E<agrave> la mode
2029
2030 =back
2031
2032 =item Obscure Open Tricks
2033
2034 =over 4
2035
2036 =item Re-Opening Files (dups)
2037
2038 =item Dispelling the Dweomer
2039
2040 =item Paths as Opens
2041
2042 =item Single Argument Open
2043
2044 =item Playing with STDIN and STDOUT
2045
2046 =back
2047
2048 =item Other I/O Issues
2049
2050 =over 4
2051
2052 =item Opening Non-File Files
2053
2054 =item Opening Named Pipes
2055
2056 =item Opening Sockets
2057
2058 =item Binary Files
2059
2060 =item File Locking
2061
2062 =item IO Layers
2063
2064 =back
2065
2066 =item SEE ALSO 
2067
2068 =item AUTHOR and COPYRIGHT
2069
2070 =item HISTORY
2071
2072 =back
2073
2074 =head2 perlpacktut - tutorial on C<pack> and C<unpack>
2075
2076 =over 4
2077
2078 =item DESCRIPTION
2079
2080 =item The Basic Principle
2081
2082 =item Packing Text
2083
2084 =item Packing Numbers
2085
2086 =over 4
2087
2088 =item Integers
2089
2090 =item Unpacking a Stack Frame
2091
2092 =item How to Eat an Egg on a Net
2093
2094 =item Floating point Numbers
2095
2096 =back
2097
2098 =item Exotic Templates
2099
2100 =over 4
2101
2102 =item Bit Strings
2103
2104 =item Uuencoding
2105
2106 =item Doing Sums
2107
2108 =item  Unicode
2109
2110 =item Another Portable Binary Encoding
2111
2112 =back
2113
2114 =item Template Grouping
2115
2116 =item Lengths and Widths
2117
2118 =over 4
2119
2120 =item String Lengths
2121
2122 =item Dynamic Templates
2123
2124 =item Counting Repetitions
2125
2126 =back
2127
2128 =item Packing and Unpacking C Structures
2129
2130 =over 4
2131
2132 =item The Alignment Pit
2133
2134 =item Alignment, Take 2
2135
2136 =item Alignment, Take 3
2137
2138 =item Pointers for How to Use Them
2139
2140 =back
2141
2142 =item Pack Recipes
2143
2144 =item Funnies Section
2145
2146 =item Authors
2147
2148 =back
2149
2150 =head2 perlpod - the Plain Old Documentation format
2151
2152 =over 4
2153
2154 =item DESCRIPTION
2155
2156 =over 4
2157
2158 =item Ordinary Paragraph
2159
2160 =item Verbatim Paragraph
2161
2162 =item Command Paragraph
2163
2164 C<=head1 I<Heading Text>>, C<=head2 I<Heading Text>>, C<=head3 I<Heading
2165 Text>>, C<=head4 I<Heading Text>>, C<=over I<indentlevel>>, C<=item
2166 I<stuff...>>, C<=back>, C<=cut>, C<=pod>, C<=begin I<formatname>>, C<=end
2167 I<formatname>>, C<=for I<formatname> I<text...>>, C<=encoding
2168 I<encodingname>>
2169
2170 =item Formatting Codes
2171
2172 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2173 C<CE<lt>codeE<gt>> -- code text, C<LE<lt>nameE<gt>> -- a hyperlink,
2174 C<EE<lt>escapeE<gt>> -- a character escape, C<FE<lt>filenameE<gt>> -- used
2175 for filenames, C<SE<lt>textE<gt>> -- text contains non-breaking spaces,
2176 C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a null
2177 (zero-effect) formatting code
2178
2179 =item The Intent
2180
2181 =item Embedding Pods in Perl Modules
2182
2183 =item Hints for Writing Pod
2184
2185 =back
2186
2187 =item SEE ALSO
2188
2189 =item AUTHOR
2190
2191 =back
2192
2193 =head2 perlpodspec - Plain Old Documentation: format specification and
2194 notes
2195
2196 =over 4
2197
2198 =item DESCRIPTION
2199
2200 =item Pod Definitions
2201
2202 =item Pod Commands
2203
2204 "=head1", "=head2", "=head3", "=head4", "=pod", "=cut", "=over", "=item",
2205 "=back", "=begin formatname", "=end formatname", "=for formatname text...",
2206 "=encoding encodingname"
2207
2208 =item Pod Formatting Codes
2209
2210 C<IE<lt>textE<gt>> -- italic text, C<BE<lt>textE<gt>> -- bold text,
2211 C<CE<lt>codeE<gt>> -- code text, C<FE<lt>filenameE<gt>> -- style for
2212 filenames, C<XE<lt>topic nameE<gt>> -- an index entry, C<ZE<lt>E<gt>> -- a
2213 null (zero-effect) formatting code, C<LE<lt>nameE<gt>> -- a hyperlink,
2214 C<EE<lt>escapeE<gt>> -- a character escape, C<SE<lt>textE<gt>> -- text
2215 contains non-breaking spaces
2216
2217 =item Notes on Implementing Pod Processors
2218
2219 =item About LE<lt>...E<gt> Codes
2220
2221 First:, Second:, Third:, Fourth:, Fifth:, Sixth:
2222
2223 =item About =over...=back Regions
2224
2225 =item About Data Paragraphs and "=begin/=end" Regions
2226
2227 =item SEE ALSO
2228
2229 =item AUTHOR
2230
2231 =back
2232
2233 =head2 perlrun - how to execute the Perl interpreter
2234
2235 =over 4
2236
2237 =item SYNOPSIS
2238
2239 =item DESCRIPTION
2240
2241 =over 4
2242
2243 =item #! and quoting on non-Unix systems
2244
2245 OS/2, MS-DOS, Win95/NT, Macintosh, VMS
2246
2247 =item Location of Perl
2248
2249 =item Command Switches
2250
2251 B<-0>[I<octal/hexadecimal>], B<-A [I<assertions>]>, B<-a>, B<-C
2252 [I<number/list>]>, B<-c>, B<-d>, B<-d:>I<foo[=bar,baz]>, B<-D>I<letters>,
2253 B<-D>I<number>, B<-e> I<commandline>, B<-F>I<pattern>, B<-h>,
2254 B<-i>[I<extension>], B<-I>I<directory>, B<-l>[I<octnum>],
2255 B<-m>[B<->]I<module>, B<-M>[B<->]I<module>, B<-M>[B<->]I<'module ...'>,
2256 B<-[mM]>[B<->]I<module=arg[,arg]...>, B<-n>, B<-p>, B<-P>, B<-s>, B<-S>,
2257 B<-t>, B<-T>, B<-u>, B<-U>, B<-v>, B<-V>, B<-V:>I<name>, B<-w>, B<-W>,
2258 B<-X>, B<-x> I<directory>
2259
2260 =back
2261
2262 =item ENVIRONMENT
2263
2264 HOME, LOGDIR, PATH, PERL5LIB, PERL5OPT, PERLIO, :bytes, :crlf, :mmap,
2265 :perlio, :pop, :raw, :stdio, :unix, :utf8, :win32, PERLIO_DEBUG, PERLLIB,
2266 PERL5DB, PERL5SHELL (specific to the Win32 port), PERL_DEBUG_MSTATS,
2267 PERL_DESTRUCT_LEVEL, PERL_DL_NONLAZY, PERL_ENCODING, PERL_HASH_SEED,
2268 PERL_HASH_SEED_DEBUG, PERL_ROOT (specific to the VMS port), PERL_SIGNALS,
2269 PERL_UNICODE, SYS$LOGIN (specific to the VMS port)
2270
2271 =back
2272
2273 =head2 perldiag - various Perl diagnostics
2274
2275 =over 4
2276
2277 =item DESCRIPTION
2278
2279 =back
2280
2281 =head2 perllexwarn - Perl Lexical Warnings
2282
2283 =over 4
2284
2285 =item DESCRIPTION
2286
2287 =over 4
2288
2289 =item Default Warnings and Optional Warnings
2290
2291 =item What's wrong with B<-w> and C<$^W>
2292
2293 =item Controlling Warnings from the Command Line
2294
2295 B<-w>, B<-W>, B<-X>
2296
2297 =item Backward Compatibility
2298
2299 =item Category Hierarchy
2300
2301 =item Fatal Warnings
2302
2303 =item Reporting Warnings from a Module
2304
2305 =back
2306
2307 =item TODO
2308
2309 =item SEE ALSO
2310
2311 =item AUTHOR
2312
2313 =back
2314
2315 =head2 perldebug - Perl debugging
2316
2317 =over 4
2318
2319 =item DESCRIPTION
2320
2321 =item The Perl Debugger
2322
2323 =over 4
2324
2325 =item Debugger Commands
2326
2327 h, h [command], h h, p expr, x [maxdepth] expr, V [pkg [vars]], X [vars], y
2328 [level [vars]], T, s [expr], n [expr], r, <CR>, c [line|sub], l, l
2329 min+incr, l min-max, l line, l subname, -, v [line], f filename, /pattern/,
2330 ?pattern?, L [abw], S [[!]regex], t, t expr, b, b [line] [condition], b
2331 subname [condition], b postpone subname [condition], b load filename, b
2332 compile subname, B line, B *, a [line] command, A line, A *, w expr, W
2333 expr, W *, o, o booloption .., o anyoption? .., o option=value .., < ?, < [
2334 command ], < *, << command, > ?, > command, > *, >> command, { ?, { [
2335 command ], { *, {{ command, ! number, ! -number, ! pattern, !! cmd, source
2336 file, H -number, q or ^D, R, |dbcmd, ||dbcmd, command, m expr, M, man
2337 [manpage]
2338
2339 =item Configurable Options
2340
2341 C<recallCommand>, C<ShellBang>, C<pager>, C<tkRunning>, C<signalLevel>,
2342 C<warnLevel>, C<dieLevel>, C<AutoTrace>, C<LineInfo>, C<inhibit_exit>,
2343 C<PrintRet>, C<ornaments>, C<frame>, C<maxTraceLen>, C<windowSize>,
2344 C<arrayDepth>, C<hashDepth>, C<dumpDepth>, C<compactDump>, C<veryCompact>,
2345 C<globPrint>, C<DumpDBFiles>, C<DumpPackages>, C<DumpReused>, C<quote>,
2346 C<HighBit>, C<undefPrint>, C<UsageOnly>, C<TTY>, C<noTTY>, C<ReadLine>,
2347 C<NonStop>
2348
2349 =item Debugger input/output
2350
2351 Prompt, Multiline commands, Stack backtrace, Line Listing Format, Frame
2352 listing
2353
2354 =item Debugging compile-time statements
2355
2356 =item Debugger Customization
2357
2358 =item Readline Support
2359
2360 =item Editor Support for Debugging
2361
2362 =item The Perl Profiler
2363
2364 =back
2365
2366 =item Debugging regular expressions
2367
2368 =item Debugging memory usage
2369
2370 =item SEE ALSO
2371
2372 =item BUGS
2373
2374 =back
2375
2376 =head2 perlvar - Perl predefined variables
2377
2378 =over 4
2379
2380 =item DESCRIPTION
2381
2382 =over 4
2383
2384 =item Predefined Names
2385
2386 $ARG, $_, $a, $b, $<I<digits>>, $MATCH, $&, $PREMATCH, $`, $POSTMATCH, $',
2387 $LAST_PAREN_MATCH, $+, $^N, @LAST_MATCH_END, @+,
2388 HANDLE->input_line_number(EXPR), $INPUT_LINE_NUMBER, $NR, $,
2389 IO::Handle->input_record_separator(EXPR), $INPUT_RECORD_SEPARATOR, $RS, $/,
2390 HANDLE->autoflush(EXPR), $OUTPUT_AUTOFLUSH, $|,
2391 IO::Handle->output_field_separator EXPR, $OUTPUT_FIELD_SEPARATOR, $OFS, $,,
2392 IO::Handle->output_record_separator EXPR, $OUTPUT_RECORD_SEPARATOR, $ORS,
2393 $\, $LIST_SEPARATOR, $", $SUBSCRIPT_SEPARATOR, $SUBSEP, $;, $#,
2394 HANDLE->format_page_number(EXPR), $FORMAT_PAGE_NUMBER, $%,
2395 HANDLE->format_lines_per_page(EXPR), $FORMAT_LINES_PER_PAGE, $=,
2396 HANDLE->format_lines_left(EXPR), $FORMAT_LINES_LEFT, $-, @LAST_MATCH_START,
2397 @-, C<$`> is the same as C<substr($var, 0, $-[0])>, C<$&> is the same as
2398 C<substr($var, $-[0], $+[0] - $-[0])>, C<$'> is the same as C<substr($var,
2399 $+[0])>, C<$1> is the same as C<substr($var, $-[1], $+[1] - $-[1])>, C<$2>
2400 is the same as C<substr($var, $-[2], $+[2] - $-[2])>, C<$3> is the same as
2401 C<substr $var, $-[3], $+[3] - $-[3])>, HANDLE->format_name(EXPR),
2402 $FORMAT_NAME, $~, HANDLE->format_top_name(EXPR), $FORMAT_TOP_NAME, $^,
2403 IO::Handle->format_line_break_characters EXPR,
2404 $FORMAT_LINE_BREAK_CHARACTERS, $:, IO::Handle->format_formfeed EXPR,
2405 $FORMAT_FORMFEED, $^L, $ACCUMULATOR, $^A, $CHILD_ERROR, $?, ${^ENCODING},
2406 $OS_ERROR, $ERRNO, $!, %!, $EXTENDED_OS_ERROR, $^E, $EVAL_ERROR, $@,
2407 $PROCESS_ID, $PID, $$, $REAL_USER_ID, $UID, $<, $EFFECTIVE_USER_ID, $EUID,
2408 $>, $REAL_GROUP_ID, $GID, $(, $EFFECTIVE_GROUP_ID, $EGID, $),
2409 $PROGRAM_NAME, $0, $[, $], $COMPILING, $^C, $DEBUGGING, $^D,
2410 $SYSTEM_FD_MAX, $^F, $^H, %^H, $INPLACE_EDIT, $^I, $^M, $OSNAME, $^O,
2411 ${^OPEN}, $PERLDB, $^P, 0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80,
2412 0x100, 0x200, 0x400, $LAST_REGEXP_CODE_RESULT, $^R,
2413 $EXCEPTIONS_BEING_CAUGHT, $^S, $BASETIME, $^T, ${^TAINT}, ${^UNICODE},
2414 $PERL_VERSION, $^V, $WARNING, $^W, ${^WARNING_BITS}, $EXECUTABLE_NAME, $^X,
2415 ARGV, $ARGV, @ARGV, ARGVOUT, @F, @INC, @_, %INC, %ENV, $ENV{expr}, %SIG,
2416 $SIG{expr}
2417
2418 =item Error Indicators
2419
2420 =item Technical Note on the Syntax of Variable Names
2421
2422 =back
2423
2424 =item BUGS
2425
2426 =back
2427
2428 =head2 perlre - Perl regular expressions
2429
2430 =over 4
2431
2432 =item DESCRIPTION
2433
2434 i, m, s, x
2435
2436 =over 4
2437
2438 =item Regular Expressions
2439
2440 [1], [2], [3], cntrl, graph, print, punct, xdigit
2441
2442 =item Extended Patterns
2443
2444 C<(?#text)>, C<(?imsx-imsx)>, C<(?:pattern)>, C<(?imsx-imsx:pattern)>,
2445 C<(?=pattern)>, C<(?!pattern)>, C<(?<=pattern)>, C<(?<!pattern)>, C<(?{
2446 code })>, C<(??{ code })>, C<< (?>pattern) >>,
2447 C<(?(condition)yes-pattern|no-pattern)>, C<(?(condition)yes-pattern)>
2448
2449 =item Backtracking
2450
2451 =item Version 8 Regular Expressions
2452
2453 =item Warning on \1 vs $1
2454
2455 =item Repeated patterns matching zero-length substring
2456
2457 =item Combining pieces together
2458
2459 C<ST>, C<S|T>, C<S{REPEAT_COUNT}>, C<S{min,max}>, C<S{min,max}?>, C<S?>,
2460 C<S*>, C<S+>, C<S??>, C<S*?>, C<S+?>, C<< (?>S) >>, C<(?=S)>, C<(?<=S)>,
2461 C<(?!S)>, C<(?<!S)>, C<(??{ EXPR })>,
2462 C<(?(condition)yes-pattern|no-pattern)>
2463
2464 =item Creating custom RE engines
2465
2466 =back
2467
2468 =item BUGS
2469
2470 =item SEE ALSO
2471
2472 =back
2473
2474 =head2 perlreref - Perl Regular Expressions Reference
2475
2476 =over 4
2477
2478 =item DESCRIPTION
2479
2480 =over 4
2481
2482 =item OPERATORS
2483
2484 =item SYNTAX
2485
2486 =item ESCAPE SEQUENCES
2487
2488 =item CHARACTER CLASSES
2489
2490 =item ANCHORS
2491
2492 =item QUANTIFIERS
2493
2494 =item EXTENDED CONSTRUCTS
2495
2496 =item VARIABLES
2497
2498 =item FUNCTIONS
2499
2500 =item TERMINOLOGY
2501
2502 =back
2503
2504 =item AUTHOR
2505
2506 =item SEE ALSO
2507
2508 =item THANKS
2509
2510 =back
2511
2512 =head2 perlref - Perl references and nested data structures
2513
2514 =over 4
2515
2516 =item NOTE
2517
2518 =item DESCRIPTION
2519
2520 =over 4
2521
2522 =item Making References
2523
2524 =item Using References
2525
2526 =item Symbolic references
2527
2528 =item Not-so-symbolic references
2529
2530 =item Pseudo-hashes: Using an array as a hash
2531
2532 =item Function Templates
2533
2534 =back
2535
2536 =item WARNING
2537
2538 =item SEE ALSO
2539
2540 =back
2541
2542 =head2 perlform - Perl formats
2543
2544 =over 4
2545
2546 =item DESCRIPTION
2547
2548 =over 4
2549
2550 =item Format Variables
2551
2552 =back
2553
2554 =item NOTES
2555
2556 =over 4
2557
2558 =item Footers
2559
2560 =item Accessing Formatting Internals
2561
2562 =back
2563
2564 =item WARNINGS
2565
2566 =back
2567
2568 =head2 perlobj - Perl objects
2569
2570 =over 4
2571
2572 =item DESCRIPTION
2573
2574 =over 4
2575
2576 =item An Object is Simply a Reference
2577
2578 =item A Class is Simply a Package
2579
2580 =item A Method is Simply a Subroutine
2581
2582 =item Method Invocation
2583
2584 =item Indirect Object Syntax
2585
2586 =item Default UNIVERSAL methods
2587
2588 isa(CLASS), can(METHOD), VERSION( [NEED] )
2589
2590 =item Destructors
2591
2592 =item Summary
2593
2594 =item Two-Phased Garbage Collection
2595
2596 =back
2597
2598 =item SEE ALSO
2599
2600 =back
2601
2602 =head2 perltie - how to hide an object class in a simple variable
2603
2604 =over 4
2605
2606 =item SYNOPSIS
2607
2608 =item DESCRIPTION
2609
2610 =over 4
2611
2612 =item Tying Scalars
2613
2614 TIESCALAR classname, LIST, FETCH this, STORE this, value, UNTIE this,
2615 DESTROY this
2616
2617 =item Tying Arrays
2618
2619 TIEARRAY classname, LIST, FETCH this, index, STORE this, index, value,
2620 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
2621 key, DELETE this, key, CLEAR this, PUSH this, LIST, POP this, SHIFT this,
2622 UNSHIFT this, LIST, SPLICE this, offset, length, LIST, UNTIE this, DESTROY
2623 this
2624
2625 =item Tying Hashes
2626
2627 USER, HOME, CLOBBER, LIST, TIEHASH classname, LIST, FETCH this, key, STORE
2628 this, key, value, DELETE this, key, CLEAR this, EXISTS this, key, FIRSTKEY
2629 this, NEXTKEY this, lastkey, UNTIE this, DESTROY this
2630
2631 =item Tying FileHandles
2632
2633 TIEHANDLE classname, LIST, WRITE this, LIST, PRINT this, LIST, PRINTF this,
2634 LIST, READ this, LIST, READLINE this, GETC this, CLOSE this, UNTIE this,
2635 DESTROY this
2636
2637 =item UNTIE this
2638
2639 =item The C<untie> Gotcha
2640
2641 =back
2642
2643 =item SEE ALSO
2644
2645 =item BUGS
2646
2647 =item AUTHOR
2648
2649 =back
2650
2651 =head2 perldbmfilter - Perl DBM Filters
2652
2653 =over 4
2654
2655 =item SYNOPSIS
2656
2657 =item DESCRIPTION
2658
2659 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
2660 B<filter_fetch_value>
2661
2662 =over 4
2663
2664 =item The Filter
2665
2666 =item An Example -- the NULL termination problem.
2667
2668 =item Another Example -- Key is a C int.
2669
2670 =back
2671
2672 =item SEE ALSO
2673
2674 =item AUTHOR
2675
2676 =back
2677
2678 =head2 perlipc - Perl interprocess communication (signals, fifos, pipes,
2679 safe subprocesses, sockets, and semaphores)
2680
2681 =over 4
2682
2683 =item DESCRIPTION
2684
2685 =item Signals
2686
2687 =over 4
2688
2689 =item Handling the SIGHUP Signal in Daemons
2690
2691 =back
2692
2693 =item Named Pipes
2694
2695 =over 4
2696
2697 =item Deferred Signals (Safe Signals)
2698
2699 Long running opcodes, Interrupting IO, Restartable system calls, Signals as
2700 "faults", Signals triggered by operating system state
2701
2702 =back
2703
2704 =item Using open() for IPC
2705
2706 =over 4
2707
2708 =item Filehandles
2709
2710 =item Background Processes
2711
2712 =item Complete Dissociation of Child from Parent
2713
2714 =item Safe Pipe Opens
2715
2716 =item Bidirectional Communication with Another Process
2717
2718 =item Bidirectional Communication with Yourself
2719
2720 =back
2721
2722 =item Sockets: Client/Server Communication
2723
2724 =over 4
2725
2726 =item Internet Line Terminators
2727
2728 =item Internet TCP Clients and Servers
2729
2730 =item Unix-Domain TCP Clients and Servers
2731
2732 =back
2733
2734 =item TCP Clients with IO::Socket
2735
2736 =over 4
2737
2738 =item A Simple Client
2739
2740 C<Proto>, C<PeerAddr>, C<PeerPort>
2741
2742 =item A Webget Client
2743
2744 =item Interactive Client with IO::Socket
2745
2746 =back
2747
2748 =item TCP Servers with IO::Socket
2749
2750 Proto, LocalPort, Listen, Reuse
2751
2752 =item UDP: Message Passing
2753
2754 =item SysV IPC
2755
2756 =item NOTES
2757
2758 =item BUGS
2759
2760 =item AUTHOR
2761
2762 =item SEE ALSO
2763
2764 =back
2765
2766 =head2 perlfork - Perl's fork() emulation
2767
2768 =over 4
2769
2770 =item SYNOPSIS
2771
2772 =item DESCRIPTION
2773
2774 =over 4
2775
2776 =item Behavior of other Perl features in forked pseudo-processes
2777
2778 $$ or $PROCESS_ID, %ENV, chdir() and all other builtins that accept
2779 filenames, wait() and waitpid(), kill(), exec(), exit(), Open handles to
2780 files, directories and network sockets
2781
2782 =item Resource limits
2783
2784 =item Killing the parent process
2785
2786 =item Lifetime of the parent process and pseudo-processes
2787
2788 =item CAVEATS AND LIMITATIONS
2789
2790 BEGIN blocks, Open filehandles, Forking pipe open() not yet implemented,
2791 Global state maintained by XSUBs, Interpreter embedded in larger
2792 application, Thread-safety of extensions
2793
2794 =back
2795
2796 =item BUGS
2797
2798 =item AUTHOR
2799
2800 =item SEE ALSO
2801
2802 =back
2803
2804 =head2 perlnumber - semantics of numbers and numeric operations in Perl
2805
2806 =over 4
2807
2808 =item SYNOPSIS
2809
2810 =item DESCRIPTION
2811
2812 =item Storing numbers
2813
2814 =item Numeric operators and numeric conversions
2815
2816 =item Flavors of Perl numeric operations
2817
2818 Arithmetic operators, ++, Arithmetic operators during C<use integer>, Other
2819 mathematical operators, Bitwise operators, Bitwise operators during C<use
2820 integer>, Operators which expect an integer, Operators which expect a
2821 string
2822
2823 =item AUTHOR
2824
2825 =item SEE ALSO
2826
2827 =back
2828
2829 =head2 perlthrtut - tutorial on threads in Perl
2830
2831 =over 4
2832
2833 =item DESCRIPTION
2834
2835 =item Status
2836
2837 =item What Is A Thread Anyway?
2838
2839 =item Threaded Program Models
2840
2841 =over 4
2842
2843 =item Boss/Worker
2844
2845 =item Work Crew
2846
2847 =item Pipeline
2848
2849 =back
2850
2851 =item What kind of threads are Perl threads?
2852
2853 =item Thread-Safe Modules
2854
2855 =item Thread Basics
2856
2857 =over 4
2858
2859 =item Basic Thread Support
2860
2861 =item A Note about the Examples
2862
2863 =item Creating Threads
2864
2865 =item Waiting For A Thread To Exit
2866
2867 =item Ignoring A Thread
2868
2869 =back
2870
2871 =item Threads And Data
2872
2873 =over 4
2874
2875 =item Shared And Unshared Data
2876
2877 =item Thread Pitfalls: Races
2878
2879 =back
2880
2881 =item Synchronization and control
2882
2883 =over 4
2884
2885 =item Controlling access: lock()
2886
2887 =item A Thread Pitfall: Deadlocks
2888
2889 =item Queues: Passing Data Around
2890
2891 =item Semaphores: Synchronizing Data Access
2892
2893 =item Basic semaphores
2894
2895 =item Advanced Semaphores
2896
2897 =item cond_wait() and cond_signal()
2898
2899 =item Giving up control
2900
2901 =back
2902
2903 =item General Thread Utility Routines
2904
2905 =over 4
2906
2907 =item What Thread Am I In?
2908
2909 =item Thread IDs
2910
2911 =item Are These Threads The Same?
2912
2913 =item What Threads Are Running?
2914
2915 =back
2916
2917 =item A Complete Example
2918
2919 =item Different implementations of threads
2920
2921 =item Performance considerations
2922
2923 =item Process-scope Changes
2924
2925 =item Thread-Safety of System Libraries
2926
2927 =item Conclusion
2928
2929 =item Bibliography
2930
2931 =over 4
2932
2933 =item Introductory Texts
2934
2935 =item OS-Related References
2936
2937 =item Other References
2938
2939 =back
2940
2941 =item Acknowledgements
2942
2943 =item AUTHOR
2944
2945 =item Copyrights
2946
2947 =back
2948
2949 =head2 perlothrtut - old tutorial on threads in Perl
2950
2951 =over 4
2952
2953 =item DESCRIPTION
2954
2955 =item What Is A Thread Anyway?
2956
2957 =item Threaded Program Models
2958
2959 =over 4
2960
2961 =item Boss/Worker
2962
2963 =item Work Crew
2964
2965 =item Pipeline
2966
2967 =back
2968
2969 =item Native threads
2970
2971 =item What kind of threads are perl threads?
2972
2973 =item Threadsafe Modules
2974
2975 =item Thread Basics
2976
2977 =over 4
2978
2979 =item Basic Thread Support
2980
2981 =item Creating Threads
2982
2983 =item Giving up control
2984
2985 =item Waiting For A Thread To Exit
2986
2987 =item Errors In Threads
2988
2989 =item Ignoring A Thread
2990
2991 =back
2992
2993 =item Threads And Data
2994
2995 =over 4
2996
2997 =item Shared And Unshared Data
2998
2999 =item Thread Pitfall: Races
3000
3001 =item Controlling access: lock()
3002
3003 =item Thread Pitfall: Deadlocks
3004
3005 =item Queues: Passing Data Around
3006
3007 =back
3008
3009 =item Threads And Code
3010
3011 =over 4
3012
3013 =item Semaphores: Synchronizing Data Access
3014
3015 Basic semaphores, Advanced Semaphores
3016
3017 =item Attributes: Restricting Access To Subroutines
3018
3019 =item Subroutine Locks
3020
3021 =item Methods
3022
3023 =item Locking A Subroutine
3024
3025 =back
3026
3027 =item General Thread Utility Routines
3028
3029 =over 4
3030
3031 =item What Thread Am I In?
3032
3033 =item Thread IDs
3034
3035 =item Are These Threads The Same?
3036
3037 =item What Threads Are Running?
3038
3039 =back
3040
3041 =item A Complete Example
3042
3043 =item Conclusion
3044
3045 =item Bibliography
3046
3047 =over 4
3048
3049 =item Introductory Texts
3050
3051 =item OS-Related References
3052
3053 =item Other References
3054
3055 =back
3056
3057 =item Acknowledgements
3058
3059 =item AUTHOR
3060
3061 =item Copyrights
3062
3063 =back
3064
3065 =head2 perlport - Writing portable Perl
3066
3067 =over 4
3068
3069 =item DESCRIPTION
3070
3071 Not all Perl programs have to be portable, Nearly all of Perl already I<is>
3072 portable
3073
3074 =item ISSUES
3075
3076 =over 4
3077
3078 =item Newlines
3079
3080 =item Numbers endianness and Width
3081
3082 =item Files and Filesystems
3083
3084 =item System Interaction
3085
3086 =item Command names versus file pathnames
3087
3088 =item Networking
3089
3090 =item Interprocess Communication (IPC)
3091
3092 =item External Subroutines (XS)
3093
3094 =item Standard Modules
3095
3096 =item Time and Date
3097
3098 =item Character sets and character encoding
3099
3100 =item Internationalisation
3101
3102 =item System Resources
3103
3104 =item Security
3105
3106 =item Style
3107
3108 =back
3109
3110 =item CPAN Testers
3111
3112 Mailing list: cpan-testers@perl.org, Testing results:
3113 http://testers.cpan.org/
3114
3115 =item PLATFORMS
3116
3117 =over 4
3118
3119 =item Unix
3120
3121 =item DOS and Derivatives
3122
3123 =item S<Mac OS>
3124
3125 =item VMS
3126
3127 =item VOS
3128
3129 =item EBCDIC Platforms
3130
3131 =item Acorn RISC OS
3132
3133 =item Other perls
3134
3135 =back
3136
3137 =item FUNCTION IMPLEMENTATIONS
3138
3139 =over 4
3140
3141 =item Alphabetical Listing of Perl Functions
3142
3143 -I<X> FILEHANDLE, -I<X> EXPR, -I<X>, alarm SECONDS, alarm, binmode
3144 FILEHANDLE, chmod LIST, chown LIST, chroot FILENAME, chroot, crypt
3145 PLAINTEXT,SALT, dbmclose HASH, dbmopen HASH,DBNAME,MODE, dump LABEL, exec
3146 LIST, exit EXPR, exit, fcntl FILEHANDLE,FUNCTION,SCALAR, flock
3147 FILEHANDLE,OPERATION, fork, getlogin, getpgrp PID, getppid, getpriority
3148 WHICH,WHO, getpwnam NAME, getgrnam NAME, getnetbyname NAME, getpwuid UID,
3149 getgrgid GID, getnetbyaddr ADDR,ADDRTYPE, getprotobynumber NUMBER,
3150 getservbyport PORT,PROTO, getpwent, getgrent, gethostbyname, gethostent,
3151 getnetent, getprotoent, getservent, sethostent STAYOPEN, setnetent
3152 STAYOPEN, setprotoent STAYOPEN, setservent STAYOPEN, endpwent, endgrent,
3153 endhostent, endnetent, endprotoent, endservent, getsockopt
3154 SOCKET,LEVEL,OPTNAME, glob EXPR, glob, ioctl FILEHANDLE,FUNCTION,SCALAR,
3155 kill SIGNAL, LIST, link OLDFILE,NEWFILE, lstat FILEHANDLE, lstat EXPR,
3156 lstat, msgctl ID,CMD,ARG, msgget KEY,FLAGS, msgsnd ID,MSG,FLAGS, msgrcv
3157 ID,VAR,SIZE,TYPE,FLAGS, open FILEHANDLE,EXPR, open FILEHANDLE, pipe
3158 READHANDLE,WRITEHANDLE, readlink EXPR, readlink, select
3159 RBITS,WBITS,EBITS,TIMEOUT, semctl ID,SEMNUM,CMD,ARG, semget
3160 KEY,NSEMS,FLAGS, semop KEY,OPSTRING, setgrent, setpgrp PID,PGRP,
3161 setpriority WHICH,WHO,PRIORITY, setpwent, setsockopt
3162 SOCKET,LEVEL,OPTNAME,OPTVAL, shmctl ID,CMD,ARG, shmget KEY,SIZE,FLAGS,
3163 shmread ID,VAR,POS,SIZE, shmwrite ID,STRING,POS,SIZE, sockatmark SOCKET,
3164 socketpair SOCKET1,SOCKET2,DOMAIN,TYPE,PROTOCOL, stat FILEHANDLE, stat
3165 EXPR, stat, symlink OLDFILE,NEWFILE, syscall LIST, sysopen
3166 FILEHANDLE,FILENAME,MODE,PERMS, system LIST, times, truncate
3167 FILEHANDLE,LENGTH, truncate EXPR,LENGTH, umask EXPR, umask, utime LIST,
3168 wait, waitpid PID,FLAGS
3169
3170 =back
3171
3172 =item CHANGES
3173
3174 v1.49, 12 August 2002, v1.48, 02 February 2001, v1.47, 22 March 2000,
3175 v1.46, 12 February 2000, v1.45, 20 December 1999, v1.44, 19 July 1999,
3176 v1.43, 24 May 1999, v1.42, 22 May 1999, v1.41, 19 May 1999, v1.40, 11 April
3177 1999, v1.39, 11 February 1999, v1.38, 31 December 1998, v1.37, 19 December
3178 1998, v1.36, 9 September 1998, v1.35, 13 August 1998, v1.33, 06 August
3179 1998, v1.32, 05 August 1998, v1.30, 03 August 1998, v1.23, 10 July 1998
3180
3181 =item Supported Platforms
3182
3183 =item SEE ALSO
3184
3185 =item AUTHORS / CONTRIBUTORS
3186
3187 =back
3188
3189 =head2 perllocale - Perl locale handling (internationalization and
3190 localization)
3191
3192 =over 4
3193
3194 =item DESCRIPTION
3195
3196 =item PREPARING TO USE LOCALES
3197
3198 =item USING LOCALES
3199
3200 =over 4
3201
3202 =item The use locale pragma
3203
3204 =item The setlocale function
3205
3206 =item Finding locales
3207
3208 =item LOCALE PROBLEMS
3209
3210 =item Temporarily fixing locale problems
3211
3212 =item Permanently fixing locale problems
3213
3214 =item Permanently fixing your system's locale configuration
3215
3216 =item Fixing system locale configuration
3217
3218 =item The localeconv function
3219
3220 =item I18N::Langinfo
3221
3222 =back
3223
3224 =item LOCALE CATEGORIES
3225
3226 =over 4
3227
3228 =item Category LC_COLLATE: Collation
3229
3230 =item Category LC_CTYPE: Character Types
3231
3232 =item Category LC_NUMERIC: Numeric Formatting
3233
3234 =item Category LC_MONETARY: Formatting of monetary amounts
3235
3236 =item LC_TIME
3237
3238 =item Other categories
3239
3240 =back
3241
3242 =item SECURITY
3243
3244 =item ENVIRONMENT
3245
3246 PERL_BADLANG, LC_ALL, LANGUAGE, LC_CTYPE, LC_COLLATE, LC_MONETARY,
3247 LC_NUMERIC, LC_TIME, LANG
3248
3249 =item NOTES
3250
3251 =over 4
3252
3253 =item Backward compatibility
3254
3255 =item I18N:Collate obsolete
3256
3257 =item Sort speed and memory use impacts
3258
3259 =item write() and LC_NUMERIC
3260
3261 =item Freely available locale definitions
3262
3263 =item I18n and l10n
3264
3265 =item An imperfect standard
3266
3267 =back
3268
3269 =item Unicode and UTF-8
3270
3271 =item BUGS
3272
3273 =over 4
3274
3275 =item Broken systems
3276
3277 =back
3278
3279 =item SEE ALSO
3280
3281 =item HISTORY
3282
3283 =back
3284
3285 =head2 perluniintro - Perl Unicode introduction
3286
3287 =over 4
3288
3289 =item DESCRIPTION
3290
3291 =over 4
3292
3293 =item Unicode
3294
3295 =item Perl's Unicode Support
3296
3297 =item Perl's Unicode Model
3298
3299 =item Unicode and EBCDIC
3300
3301 =item Creating Unicode
3302
3303 =item Handling Unicode
3304
3305 =item Legacy Encodings
3306
3307 =item Unicode I/O
3308
3309 =item Displaying Unicode As Text
3310
3311 =item Special Cases
3312
3313 =item Advanced Topics
3314
3315 =item Miscellaneous
3316
3317 =item Questions With Answers
3318
3319 =item Hexadecimal Notation
3320
3321 =item Further Resources
3322
3323 =back
3324
3325 =item UNICODE IN OLDER PERLS
3326
3327 =item SEE ALSO
3328
3329 =item ACKNOWLEDGMENTS
3330
3331 =item AUTHOR, COPYRIGHT, AND LICENSE
3332
3333 =back
3334
3335 =head2 perlunicode - Unicode support in Perl
3336
3337 =over 4
3338
3339 =item DESCRIPTION
3340
3341 =over 4
3342
3343 =item Important Caveats
3344
3345 Input and Output Layers, Regular Expressions, C<use utf8> still needed to
3346 enable UTF-8/UTF-EBCDIC in scripts
3347
3348 =item Byte and Character Semantics
3349
3350 =item Effects of Character Semantics
3351
3352 =item Scripts
3353
3354 =item Blocks
3355
3356 =item User-Defined Character Properties
3357
3358 =item Character Encodings for Input and Output
3359
3360 =item Unicode Regular Expression Support Level
3361
3362 =item Unicode Encodings
3363
3364 =item Security Implications of Unicode
3365
3366 =item Unicode in Perl on EBCDIC
3367
3368 =item Locales
3369
3370 =item When Unicode Does Not Happen
3371
3372 =item Forcing Unicode in Perl (Or Unforcing Unicode in Perl)
3373
3374 =item Using Unicode in XS
3375
3376 =back
3377
3378 =item BUGS
3379
3380 =over 4
3381
3382 =item Interaction with Locales
3383
3384 =item Interaction with Extensions
3385
3386 =item Speed
3387
3388 =item Porting code from perl-5.6.X
3389
3390 =back
3391
3392 =item SEE ALSO
3393
3394 =back
3395
3396 =head2 perlebcdic - Considerations for running Perl on EBCDIC platforms
3397
3398 =over 4
3399
3400 =item DESCRIPTION
3401
3402 =item COMMON CHARACTER CODE SETS
3403
3404 =over 4
3405
3406 =item ASCII
3407
3408 =item ISO 8859
3409
3410 =item Latin 1 (ISO 8859-1)
3411
3412 =item EBCDIC
3413
3414 =item 13 variant characters
3415
3416 =item 0037
3417
3418 =item 1047
3419
3420 =item POSIX-BC
3421
3422 =item Unicode code points versus EBCDIC code points
3423
3424 =item Remaining Perl Unicode problems in EBCDIC
3425
3426 =item Unicode and UTF
3427
3428 =item Using Encode
3429
3430 =back
3431
3432 =item SINGLE OCTET TABLES
3433
3434 recipe 0, recipe 1, recipe 2, recipe 3, recipe 4, recipe 5, recipe 6
3435
3436 =item IDENTIFYING CHARACTER CODE SETS
3437
3438 =item CONVERSIONS
3439
3440 =over 4
3441
3442 =item tr///
3443
3444 =item iconv
3445
3446 =item C RTL
3447
3448 =back
3449
3450 =item OPERATOR DIFFERENCES
3451
3452 =item FUNCTION DIFFERENCES
3453
3454 chr(), ord(), pack(), print(), printf(), sort(), sprintf(), unpack()
3455
3456 =item REGULAR EXPRESSION DIFFERENCES
3457
3458 =item SOCKETS
3459
3460 =item SORTING
3461
3462 =over 4
3463
3464 =item Ignore ASCII vs. EBCDIC sort differences.
3465
3466 =item MONO CASE then sort data.
3467
3468 =item Convert, sort data, then re convert.
3469
3470 =item Perform sorting on one type of machine only.
3471
3472 =back
3473
3474 =item TRANSFORMATION FORMATS
3475
3476 =over 4
3477
3478 =item URL decoding and encoding
3479
3480 =item uu encoding and decoding
3481
3482 =item Quoted-Printable encoding and decoding
3483
3484 =item Caesarian ciphers
3485
3486 =back
3487
3488 =item Hashing order and checksums
3489
3490 =item I18N AND L10N
3491
3492 =item MULTI OCTET CHARACTER SETS
3493
3494 =item OS ISSUES
3495
3496 =over 4
3497
3498 =item OS/400
3499
3500 PASE, IFS access
3501
3502 =item OS/390, z/OS
3503
3504 chcp, dataset access, OS/390, z/OS iconv, locales
3505
3506 =item VM/ESA?
3507
3508 =item POSIX-BC?
3509
3510 =back
3511
3512 =item BUGS
3513
3514 =item SEE ALSO
3515
3516 =item REFERENCES
3517
3518 =item HISTORY
3519
3520 =item AUTHOR
3521
3522 =back
3523
3524 =head2 perlsec - Perl security
3525
3526 =over 4
3527
3528 =item DESCRIPTION
3529
3530 =over 4
3531
3532 =item Laundering and Detecting Tainted Data
3533
3534 =item Switches On the "#!" Line
3535
3536 =item Cleaning Up Your Path
3537
3538 =item Security Bugs
3539
3540 =item Protecting Your Programs
3541
3542 =item Unicode
3543
3544 =item Algorithmic Complexity Attacks
3545
3546 =back
3547
3548 =item SEE ALSO
3549
3550 =back
3551
3552 =head2 perlmod - Perl modules (packages and symbol tables)
3553
3554 =over 4
3555
3556 =item DESCRIPTION
3557
3558 =over 4
3559
3560 =item Packages
3561
3562 =item Symbol Tables
3563
3564 =item Package Constructors and Destructors
3565
3566 =item Perl Classes
3567
3568 =item Perl Modules
3569
3570 =item Making your module threadsafe
3571
3572 =back
3573
3574 =item SEE ALSO
3575
3576 =back
3577
3578 =head2 perlmodlib - constructing new Perl modules and finding existing ones
3579
3580 =over 4
3581
3582 =item THE PERL MODULE LIBRARY
3583
3584 =over 4
3585
3586 =item Pragmatic Modules
3587
3588 assertions, assertions::activate, attributes, attrs, autouse, base, bigint,
3589 bignum, bigrat, blib, bytes, charnames, constant, diagnostics, encoding,
3590 fields, filetest, if, integer, less, lib, locale, open, ops, overload, re,
3591 sigtrap, sort, strict, subs, threads, threads::shared, utf8, vars, version,
3592 vmsish, warnings, warnings::register
3593
3594 =item Standard Modules
3595
3596 AnyDBM_File, Attribute::Handlers, AutoLoader, AutoSplit, B, B::Asmdata,
3597 B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC, B::Concise, B::Debug,
3598 B::Deparse, B::Disassembler, B::Lint, B::Showlex, B::Stackobj, B::Stash,
3599 B::Terse, B::Xref, Benchmark, ByteLoader, CGI, CGI::Apache, CGI::Carp,
3600 CGI::Cookie, CGI::Fast, CGI::Pretty, CGI::Push, CGI::Switch, CGI::Util,
3601 CPAN, CPAN::FirstTime, CPAN::Nox, Carp, Carp::Heavy, Class::ISA,
3602 Class::Struct, Config, Cwd, DB, DB_File, Data::Dumper, Devel::DProf,
3603 Devel::PPPort, Devel::Peek, Devel::SelfStubber, Digest, Digest::MD5,
3604 DirHandle, Dumpvalue, DynaLoader, Encode, Encode::Alias, Encode::Byte,
3605 Encode::CJKConstants, Encode::CN, Encode::CN::HZ, Encode::Config,
3606 Encode::EBCDIC, Encode::Encoder, Encode::Encoding, Encode::Guess,
3607 Encode::JP, Encode::JP::H2Z, Encode::JP::JIS7, Encode::KR,
3608 Encode::KR::2022_KR, Encode::MIME::Header, Encode::PerlIO,
3609 Encode::Supported, Encode::Symbol, Encode::TW, Encode::Unicode,
3610 Encode::Unicode::UTF7, English, Env, Errno, Exporter, Exporter::Heavy,
3611 ExtUtils::Command, ExtUtils::Command::MM, ExtUtils::Constant,
3612 ExtUtils::Embed, ExtUtils::Install, ExtUtils::Installed, ExtUtils::Liblist,
3613 ExtUtils::MM, ExtUtils::MM_Any, ExtUtils::MM_BeOS, ExtUtils::MM_Cygwin,
3614 ExtUtils::MM_DOS, ExtUtils::MM_MacOS, ExtUtils::MM_NW5, ExtUtils::MM_OS2,
3615 ExtUtils::MM_UWIN, ExtUtils::MM_Unix, ExtUtils::MM_VMS, ExtUtils::MM_Win32,
3616 ExtUtils::MM_Win95, ExtUtils::MY, ExtUtils::MakeMaker,
3617 ExtUtils::MakeMaker::FAQ, ExtUtils::MakeMaker::Tutorial,
3618 ExtUtils::MakeMaker::bytes, ExtUtils::MakeMaker::vmsish,
3619 ExtUtils::Manifest, ExtUtils::Mkbootstrap, ExtUtils::Mksymlists,
3620 ExtUtils::Packlist, ExtUtils::testlib, Fatal, Fcntl, File::Basename,
3621 File::CheckTree, File::Compare, File::Copy, File::DosGlob, File::Find,
3622 File::Glob, File::Path, File::Spec, File::Spec::Cygwin, File::Spec::Epoc,
3623 File::Spec::Functions, File::Spec::Mac, File::Spec::OS2, File::Spec::Unix,
3624 File::Spec::VMS, File::Spec::Win32, File::Temp, File::stat, FileCache,
3625 FileHandle, Filter::Simple, Filter::Util::Call, FindBin, GDBM_File,
3626 Getopt::Long, Getopt::Std, Hash::Util, I18N::Collate, I18N::LangTags,
3627 I18N::LangTags::List, I18N::Langinfo, IO, IO::Dir, IO::File, IO::Handle,
3628 IO::Pipe, IO::Poll, IO::Seekable, IO::Select, IO::Socket, IO::Socket::INET,
3629 IO::Socket::UNIX, IPC::Open2, IPC::Open3, IPC::SysV, IPC::SysV::Msg,
3630 IPC::SysV::Semaphore, List::Util, Locale::Constants, Locale::Country,
3631 Locale::Currency, Locale::Language, Locale::Maketext,
3632 Locale::Maketext::TPJ13, Locale::Script, MIME::Base64,
3633 MIME::Base64::QuotedPrint, Math::BigFloat, Math::BigInt,
3634 Math::BigInt::Calc, Math::BigInt::Scalar, Math::BigRat, Math::Complex,
3635 Math::Trig, Memoize, Memoize::AnyDBM_File, Memoize::Expire,
3636 Memoize::ExpireFile, Memoize::ExpireTest, Memoize::NDBM_File,
3637 Memoize::SDBM_File, Memoize::Storable, NDBM_File, NEXT, Net::Cmd,
3638 Net::Config, Net::Domain, Net::FTP, Net::NNTP, Net::Netrc, Net::POP3,
3639 Net::Ping, Net::SMTP, Net::Time, Net::hostent, Net::libnetFAQ, Net::netent,
3640 Net::protoent, Net::servent, O, ODBM_File, Opcode, POSIX, PerlIO,
3641 PerlIO::encoding, PerlIO::scalar, PerlIO::via, PerlIO::via::QuotedPrint,
3642 Pod::Checker, Pod::Find, Pod::Functions, Pod::Html, Pod::InputObjects,
3643 Pod::LaTeX, Pod::Man, Pod::ParseLink, Pod::ParseUtils, Pod::Parser,
3644 Pod::Perldoc::ToChecker, Pod::Perldoc::ToMan, Pod::Perldoc::ToNroff,
3645 Pod::Perldoc::ToPod, Pod::Perldoc::ToRtf, Pod::Perldoc::ToText,
3646 Pod::Perldoc::ToTk, Pod::Perldoc::ToXml, Pod::PlainText, Pod::Plainer,
3647 Pod::Select, Pod::Text, Pod::Text::Color, Pod::Text::Overstrike,
3648 Pod::Text::Termcap, Pod::Usage, SDBM_File, Safe, Scalar::Util,
3649 Search::Dict, SelectSaver, SelfLoader, Shell, Socket, Storable, Switch,
3650 Symbol, Sys::Hostname, Sys::Syslog, Term::ANSIColor, Term::Cap,
3651 Term::Complete, Term::ReadLine, Test, Test::Builder, Test::Harness,
3652 Test::Harness::Assert, Test::Harness::Iterator, Test::Harness::Straps,
3653 Test::More, Test::Simple, Test::Tutorial, Text::Abbrev, Text::Balanced,
3654 Text::ParseWords, Text::Soundex, Text::Tabs, Text::Wrap, Thread,
3655 Thread::Queue, Thread::Semaphore, Thread::Signal, Thread::Specific,
3656 Tie::Array, Tie::File, Tie::Handle, Tie::Hash, Tie::Memoize, Tie::RefHash,
3657 Tie::Scalar, Tie::SubstrHash, Time::HiRes, Time::Local, Time::gmtime,
3658 Time::localtime, Time::tm, UNIVERSAL, Unicode::Collate, Unicode::Normalize,
3659 Unicode::UCD, User::grent, User::pwent, Win32, XS::APItest, XS::Typemap,
3660 XSLoader
3661
3662 =item Extension Modules
3663
3664 =back
3665
3666 =item CPAN
3667
3668 =over 4
3669
3670 =item Africa
3671
3672 South Africa
3673
3674 =item Asia
3675
3676 China, Indonesia, Israel, Japan, Malaysia, Russian Federation, Saudi
3677 Arabia, Singapore, South Korea, Taiwan, Thailand
3678
3679 =item Central America
3680
3681 Costa Rica
3682
3683 =item Europe
3684
3685 Austria, Belgium, Bosnia and Herzegovina, Bulgaria, Croatia, Czech
3686 Republic, Denmark, Estonia, Finland, France, Germany, Greece, Hungary,
3687 Iceland, Ireland, Italy, Latvia, Lithuania, Netherlands, Norway, Poland,
3688 Portugal, Romania, Russia, Slovakia, Slovenia, Spain, Sweden, Switzerland,
3689 Turkey, Ukraine, United Kingdom
3690
3691 =item North America
3692
3693 Canada, Alberta, Manitoba, Nova Scotia, Ontario, Mexico, United States,
3694 Alabama, California, Colorado, Delaware, District of Columbia, Florida,
3695 Indiana, Kentucky, Massachusetts, Michigan, Nevada, New Jersey, New York,
3696 North Carolina, Oklahoma, Oregon, Pennsylvania, Tennessee, Texas, Utah,
3697 Virginia, Washington, Wisconsin
3698
3699 =item Oceania
3700
3701 Australia, New Zealand, United States
3702
3703 =item South America
3704
3705 Argentina, Brazil, Chile
3706
3707 =item RSYNC Mirrors
3708
3709 =back
3710
3711 =item Modules: Creation, Use, and Abuse
3712
3713 =over 4
3714
3715 =item Guidelines for Module Creation
3716
3717 =item Guidelines for Converting Perl 4 Library Scripts into Modules
3718
3719 =item Guidelines for Reusing Application Code
3720
3721 =back
3722
3723 =item NOTE
3724
3725 =back
3726
3727 =head2 perlmodstyle - Perl module style guide
3728
3729 =over 4
3730
3731 =item INTRODUCTION
3732
3733 =item QUICK CHECKLIST
3734
3735 =over 4
3736
3737 =item Before you start
3738
3739 =item The API
3740
3741 =item Stability
3742
3743 =item Documentation
3744
3745 =item Release considerations
3746
3747 =back
3748
3749 =item BEFORE YOU START WRITING A MODULE
3750
3751 =over 4
3752
3753 =item Has it been done before?
3754
3755 =item Do one thing and do it well
3756
3757 =item What's in a name?
3758
3759 =back
3760
3761 =item DESIGNING AND WRITING YOUR MODULE
3762
3763 =over 4
3764
3765 =item To OO or not to OO?
3766
3767 =item Designing your API
3768
3769 Write simple routines to do simple things, Separate functionality from
3770 output, Provide sensible shortcuts and defaults, Naming conventions,
3771 Parameter passing
3772
3773 =item Strictness and warnings
3774
3775 =item Backwards compatibility
3776
3777 =item Error handling and messages
3778
3779 =back
3780
3781 =item DOCUMENTING YOUR MODULE
3782
3783 =over 4
3784
3785 =item POD
3786
3787 =item README, INSTALL, release notes, changelogs
3788
3789 perl Makefile.PL, make, make test, make install, perl Build.PL, perl Build,
3790 perl Build test, perl Build install
3791
3792 =back
3793
3794 =item RELEASE CONSIDERATIONS
3795
3796 =over 4
3797
3798 =item Version numbering
3799
3800 =item Pre-requisites
3801
3802 =item Testing
3803
3804 =item Packaging
3805
3806 =item Licensing
3807
3808 =back
3809
3810 =item COMMON PITFALLS
3811
3812 =over 4
3813
3814 =item Reinventing the wheel
3815
3816 =item Trying to do too much
3817
3818 =item Inappropriate documentation
3819
3820 =back
3821
3822 =item SEE ALSO
3823
3824 L<perlstyle>, L<perlnewmod>, L<perlpod>, L<podchecker>, Packaging Tools,
3825 Testing tools, http://pause.perl.org/, Any good book on software
3826 engineering
3827
3828 =item AUTHOR
3829
3830 =back
3831
3832 =head2 perlmodinstall - Installing CPAN Modules
3833
3834 =over 4
3835
3836 =item DESCRIPTION
3837
3838 =over 4
3839
3840 =item PREAMBLE
3841
3842 B<DECOMPRESS> the file, B<UNPACK> the file into a directory, B<BUILD> the
3843 module (sometimes unnecessary), B<INSTALL> the module
3844
3845 =back
3846
3847 =item PORTABILITY
3848
3849 =item HEY
3850
3851 =item AUTHOR
3852
3853 =item COPYRIGHT
3854
3855 =back
3856
3857 =head2 perlnewmod - preparing a new module for distribution
3858
3859 =over 4
3860
3861 =item DESCRIPTION
3862
3863 =over 4
3864
3865 =item Warning
3866
3867 =item What should I make into a module?
3868
3869 =item Step-by-step: Preparing the ground
3870
3871 Look around, Check it's new, Discuss the need, Choose a name, Check again
3872
3873 =item Step-by-step: Making the module
3874
3875 Start with F<h2xs>, Use L<strict|strict> and L<warnings|warnings>, Use
3876 L<Carp|Carp>, Use L<Exporter|Exporter> - wisely!, Use L<plain old
3877 documentation|perlpod>, Write tests, Write the README
3878
3879 =item Step-by-step: Distributing your module
3880
3881 Get a CPAN user ID, C<perl Makefile.PL; make test; make dist>, Upload the
3882 tarball, Announce to the modules list, Announce to clpa, Fix bugs!
3883
3884 =back
3885
3886 =item AUTHOR
3887
3888 =item SEE ALSO
3889
3890 =back
3891
3892 =head2 perlutil - utilities packaged with the Perl distribution
3893
3894 =over 4
3895
3896 =item DESCRIPTION
3897
3898 =over 4
3899
3900 =item DOCUMENTATION
3901
3902 L<perldoc|perldoc>, L<pod2man|pod2man> and L<pod2text|pod2text>,
3903 L<pod2html|pod2html> and L<pod2latex|pod2latex>, L<pod2usage|pod2usage>,
3904 L<podselect|podselect>, L<podchecker|podchecker>, L<splain|splain>,
3905 L<roffitall|roffitall>
3906
3907 =item CONVERTORS
3908
3909 L<a2p|a2p>, L<s2p|s2p>, L<find2perl|find2perl>
3910
3911 =item Administration
3912
3913 L<libnetcfg|libnetcfg>
3914
3915 =item Development
3916
3917 L<perlbug|perlbug>, L<h2ph|h2ph>, L<c2ph|c2ph> and L<pstruct|pstruct>,
3918 L<h2xs|h2xs>, L<dprofpp|dprofpp>, L<perlcc|perlcc>
3919
3920 =item SEE ALSO
3921
3922 =back
3923
3924 =back
3925
3926 =head2 perlcompile - Introduction to the Perl Compiler-Translator 
3927
3928 =over 4
3929
3930 =item DESCRIPTION
3931
3932 =over 4
3933
3934 =item Layout
3935
3936 B::Bytecode, B::C, B::CC, B::Lint, B::Deparse, B::Xref
3937
3938 =back
3939
3940 =item Using The Back Ends
3941
3942 =over 4
3943
3944 =item The Cross Referencing Back End
3945
3946 i, &, s, r
3947
3948 =item The Decompiling Back End
3949
3950 =item The Lint Back End
3951
3952 =item The Simple C Back End
3953
3954 =item The Bytecode Back End
3955
3956 =item The Optimized C Back End
3957
3958 =back
3959
3960 =item Module List for the Compiler Suite
3961
3962 B, O, B::Asmdata, B::Assembler, B::Bblock, B::Bytecode, B::C, B::CC,
3963 B::Concise, B::Debug, B::Deparse, B::Disassembler, B::Lint, B::Showlex,
3964 B::Stackobj, B::Stash, B::Terse, B::Xref
3965
3966 =item KNOWN PROBLEMS
3967
3968 =item AUTHOR
3969
3970 =back
3971
3972 =head2 perlfilter - Source Filters
3973
3974 =over 4
3975
3976 =item DESCRIPTION
3977
3978 =item CONCEPTS
3979
3980 =item USING FILTERS
3981
3982 =item WRITING A SOURCE FILTER
3983
3984 =item WRITING A SOURCE FILTER IN C
3985
3986 B<Decryption Filters>
3987
3988 =item CREATING A SOURCE FILTER AS A SEPARATE EXECUTABLE
3989
3990 =item WRITING A SOURCE FILTER IN PERL
3991
3992 =item USING CONTEXT: THE DEBUG FILTER
3993
3994 =item CONCLUSION
3995
3996 =item THINGS TO LOOK OUT FOR
3997
3998 Some Filters Clobber the C<DATA> Handle
3999
4000 =item REQUIREMENTS
4001
4002 =item AUTHOR
4003
4004 =item Copyrights
4005
4006 =back
4007
4008 =head2 perlembed - how to embed perl in your C program
4009
4010 =over 4
4011
4012 =item DESCRIPTION
4013
4014 =over 4
4015
4016 =item PREAMBLE
4017
4018 B<Use C from Perl?>, B<Use a Unix program from Perl?>, B<Use Perl from
4019 Perl?>, B<Use C from C?>, B<Use Perl from C?>
4020
4021 =item ROADMAP
4022
4023 =item Compiling your C program
4024
4025 =item Adding a Perl interpreter to your C program
4026
4027 =item Calling a Perl subroutine from your C program
4028
4029 =item Evaluating a Perl statement from your C program
4030
4031 =item Performing Perl pattern matches and substitutions from your C program
4032
4033 =item Fiddling with the Perl stack from your C program
4034
4035 =item Maintaining a persistent interpreter
4036
4037 =item Execution of END blocks
4038
4039 =item Maintaining multiple interpreter instances
4040
4041 =item Using Perl modules, which themselves use C libraries, from your C
4042 program
4043
4044 =back
4045
4046 =item Embedding Perl under Win32
4047
4048 =item Hiding Perl_
4049
4050 =item MORAL
4051
4052 =item AUTHOR
4053
4054 =item COPYRIGHT
4055
4056 =back
4057
4058 =head2 perldebguts - Guts of Perl debugging 
4059
4060 =over 4
4061
4062 =item DESCRIPTION
4063
4064 =item Debugger Internals
4065
4066 =over 4
4067
4068 =item Writing Your Own Debugger
4069
4070 =back
4071
4072 =item Frame Listing Output Examples
4073
4074 =item Debugging regular expressions
4075
4076 =over 4
4077
4078 =item Compile-time output
4079
4080 C<anchored> I<STRING> C<at> I<POS>, C<floating> I<STRING> C<at>
4081 I<POS1..POS2>, C<matching floating/anchored>, C<minlen>, C<stclass>
4082 I<TYPE>, C<noscan>, C<isall>, C<GPOS>, C<plus>, C<implicit>, C<with eval>,
4083 C<anchored(TYPE)>
4084
4085 =item Types of nodes
4086
4087 =item Run-time output
4088
4089 =back
4090
4091 =item Debugging Perl memory usage
4092
4093 =over 4
4094
4095 =item Using C<$ENV{PERL_DEBUG_MSTATS}>
4096
4097 C<buckets SMALLEST(APPROX)..GREATEST(APPROX)>, Free/Used, C<Total sbrk():
4098 SBRKed/SBRKs:CONTINUOUS>, C<pad: 0>, C<heads: 2192>, C<chain: 0>, C<tail:
4099 6144>
4100
4101 =item Example of using B<-DL> switch
4102
4103 C<717>, C<002>, C<054>, C<602>, C<702>, C<704>
4104
4105 =item B<-DL> details
4106
4107 C<!!!>, C<!!>, C<!>
4108
4109 =item Limitations of B<-DL> statistics
4110
4111 =back
4112
4113 =item SEE ALSO
4114
4115 =back
4116
4117 =head2 perlxstut, perlXStut - Tutorial for writing XSUBs
4118
4119 =over 4
4120
4121 =item DESCRIPTION
4122
4123 =item SPECIAL NOTES
4124
4125 =over 4
4126
4127 =item make
4128
4129 =item Version caveat
4130
4131 =item Dynamic Loading versus Static Loading
4132
4133 =back
4134
4135 =item TUTORIAL
4136
4137 =over 4
4138
4139 =item EXAMPLE 1
4140
4141 =item EXAMPLE 2
4142
4143 =item What has gone on?
4144
4145 =item Writing good test scripts
4146
4147 =item EXAMPLE 3
4148
4149 =item What's new here?
4150
4151 =item Input and Output Parameters
4152
4153 =item The XSUBPP Program
4154
4155 =item The TYPEMAP file
4156
4157 =item Warning about Output Arguments
4158
4159 =item EXAMPLE 4
4160
4161 =item What has happened here?
4162
4163 =item Anatomy of .xs file
4164
4165 =item Getting the fat out of XSUBs
4166
4167 =item More about XSUB arguments
4168
4169 =item The Argument Stack
4170
4171 =item Extending your Extension
4172
4173 =item Documenting your Extension
4174
4175 =item Installing your Extension
4176
4177 =item EXAMPLE 5
4178
4179 =item New Things in this Example
4180
4181 =item EXAMPLE 6
4182
4183 =item New Things in this Example
4184
4185 =item EXAMPLE 7 (Coming Soon)
4186
4187 =item EXAMPLE 8 (Coming Soon)
4188
4189 =item EXAMPLE 9 Passing open files to XSes
4190
4191 =item Troubleshooting these Examples
4192
4193 =back
4194
4195 =item See also
4196
4197 =item Author
4198
4199 =over 4
4200
4201 =item Last Changed
4202
4203 =back
4204
4205 =back
4206
4207 =head2 perlxs - XS language reference manual
4208
4209 =over 4
4210
4211 =item DESCRIPTION
4212
4213 =over 4
4214
4215 =item Introduction
4216
4217 =item On The Road
4218
4219 =item The Anatomy of an XSUB
4220
4221 =item The Argument Stack
4222
4223 =item The RETVAL Variable
4224
4225 =item The MODULE Keyword
4226
4227 =item The PACKAGE Keyword
4228
4229 =item The PREFIX Keyword
4230
4231 =item The OUTPUT: Keyword
4232
4233 =item The NO_OUTPUT Keyword
4234
4235 =item The CODE: Keyword
4236
4237 =item The INIT: Keyword
4238
4239 =item The NO_INIT Keyword
4240
4241 =item Initializing Function Parameters
4242
4243 =item Default Parameter Values
4244
4245 =item The PREINIT: Keyword
4246
4247 =item The SCOPE: Keyword
4248
4249 =item The INPUT: Keyword
4250
4251 =item The IN/OUTLIST/IN_OUTLIST/OUT/IN_OUT Keywords
4252
4253 =item The C<length(NAME)> Keyword
4254
4255 =item Variable-length Parameter Lists
4256
4257 =item The C_ARGS: Keyword
4258
4259 =item The PPCODE: Keyword
4260
4261 =item Returning Undef And Empty Lists
4262
4263 =item The REQUIRE: Keyword
4264
4265 =item The CLEANUP: Keyword
4266
4267 =item The POSTCALL: Keyword
4268
4269 =item The BOOT: Keyword
4270
4271 =item The VERSIONCHECK: Keyword
4272
4273 =item The PROTOTYPES: Keyword
4274
4275 =item The PROTOTYPE: Keyword
4276
4277 =item The ALIAS: Keyword
4278
4279 =item The OVERLOAD: Keyword
4280
4281 =item The FALLBACK: Keyword
4282
4283 =item The INTERFACE: Keyword
4284
4285 =item The INTERFACE_MACRO: Keyword
4286
4287 =item The INCLUDE: Keyword
4288
4289 =item The CASE: Keyword
4290
4291 =item The & Unary Operator
4292
4293 =item Inserting POD, Comments and C Preprocessor Directives
4294
4295 =item Using XS With C++
4296
4297 =item Interface Strategy
4298
4299 =item Perl Objects And C Structures
4300
4301 =item The Typemap
4302
4303 =item Safely Storing Static Data in XS
4304
4305 MY_CXT_KEY, typedef my_cxt_t, START_MY_CXT, MY_CXT_INIT, dMY_CXT, MY_CXT
4306
4307 =back
4308
4309 =item EXAMPLES
4310
4311 =item XS VERSION
4312
4313 =item AUTHOR
4314
4315 =back
4316
4317 =head2 perlclib - Internal replacements for standard C library functions
4318
4319 =over 4
4320
4321 =item DESCRIPTION
4322
4323 =over 4
4324
4325 =item Conventions
4326
4327 C<t>, C<p>, C<n>, C<s>
4328
4329 =item File Operations
4330
4331 =item File Input and Output
4332
4333 =item File Positioning
4334
4335 =item Memory Management and String Handling
4336
4337 =item Character Class Tests
4338
4339 =item F<stdlib.h> functions
4340
4341 =item Miscellaneous functions
4342
4343 =back
4344
4345 =item SEE ALSO
4346
4347 =back
4348
4349 =head2 perlguts - Introduction to the Perl API
4350
4351 =over 4
4352
4353 =item DESCRIPTION
4354
4355 =item Variables
4356
4357 =over 4
4358
4359 =item Datatypes
4360
4361 =item What is an "IV"?
4362
4363 =item Working with SVs
4364
4365 =item Offsets
4366
4367 =item What's Really Stored in an SV?
4368
4369 =item Working with AVs
4370
4371 =item Working with HVs
4372
4373 =item Hash API Extensions
4374
4375 =item AVs, HVs and undefined values
4376
4377 =item References
4378
4379 =item Blessed References and Class Objects
4380
4381 =item Creating New Variables
4382
4383 GV_ADDMULTI, GV_ADDWARN
4384
4385 =item Reference Counts and Mortality
4386
4387 =item Stashes and Globs
4388
4389 =item Double-Typed SVs
4390
4391 =item Magic Variables
4392
4393 =item Assigning Magic
4394
4395 =item Magic Virtual Tables
4396
4397 =item Finding Magic
4398
4399 =item Understanding the Magic of Tied Hashes and Arrays
4400
4401 =item Localizing changes
4402
4403 C<SAVEINT(int i)>, C<SAVEIV(IV i)>, C<SAVEI32(I32 i)>, C<SAVELONG(long i)>,
4404 C<SAVESPTR(s)>, C<SAVEPPTR(p)>, C<SAVEFREESV(SV *sv)>, C<SAVEMORTALIZESV(SV
4405 *sv)>, C<SAVEFREEOP(OP *op)>, C<SAVEFREEPV(p)>, C<SAVECLEARSV(SV *sv)>,
4406 C<SAVEDELETE(HV *hv, char *key, I32 length)>,
4407 C<SAVEDESTRUCTOR(DESTRUCTORFUNC_NOCONTEXT_t f, void *p)>,
4408 C<SAVEDESTRUCTOR_X(DESTRUCTORFUNC_t f, void *p)>, C<SAVESTACK_POS()>, C<SV*
4409 save_scalar(GV *gv)>, C<AV* save_ary(GV *gv)>, C<HV* save_hash(GV *gv)>,
4410 C<void save_item(SV *item)>, C<void save_list(SV **sarg, I32 maxsarg)>,
4411 C<SV* save_svref(SV **sptr)>, C<void save_aptr(AV **aptr)>, C<void
4412 save_hptr(HV **hptr)>
4413
4414 =back
4415
4416 =item Subroutines
4417
4418 =over 4
4419
4420 =item XSUBs and the Argument Stack
4421
4422 =item Calling Perl Routines from within C Programs
4423
4424 =item Memory Allocation
4425
4426 =item PerlIO
4427
4428 =item Putting a C value on Perl stack
4429
4430 =item Scratchpads
4431
4432 =item Scratchpads and recursion
4433
4434 =back
4435
4436 =item Compiled code
4437
4438 =over 4
4439
4440 =item Code tree
4441
4442 =item Examining the tree
4443
4444 =item Compile pass 1: check routines
4445
4446 =item Compile pass 1a: constant folding
4447
4448 =item Compile pass 2: context propagation
4449
4450 =item Compile pass 3: peephole optimization
4451
4452 =item Pluggable runops
4453
4454 =back
4455
4456 =item Examining internal data structures with the C<dump> functions
4457
4458 =item How multiple interpreters and concurrency are supported
4459
4460 =over 4
4461
4462 =item Background and PERL_IMPLICIT_CONTEXT
4463
4464 =item So what happened to dTHR?
4465
4466 =item How do I use all this in extensions?
4467
4468 =item Should I do anything special if I call perl from multiple threads?
4469
4470 =item Future Plans and PERL_IMPLICIT_SYS
4471
4472 =back
4473
4474 =item Internal Functions
4475
4476 A, p, d, s, n, r, f, M, o, x, m, X, E, b
4477
4478 =over 4
4479
4480 =item Formatted Printing of IVs, UVs, and NVs
4481
4482 =item Pointer-To-Integer and Integer-To-Pointer
4483
4484 =item Source Documentation
4485
4486 =back
4487
4488 =item Unicode Support
4489
4490 =over 4
4491
4492 =item What B<is> Unicode, anyway?
4493
4494 =item How can I recognise a UTF-8 string?
4495
4496 =item How does UTF-8 represent Unicode characters?
4497
4498 =item How does Perl store UTF-8 strings?
4499
4500 =item How do I convert a string to UTF-8?
4501
4502 =item Is there anything else I need to know?
4503
4504 =back
4505
4506 =item Custom Operators
4507
4508 =item AUTHORS
4509
4510 =item SEE ALSO
4511
4512 =back
4513
4514 =head2 perlcall - Perl calling conventions from C
4515
4516 =over 4
4517
4518 =item DESCRIPTION
4519
4520 An Error Handler, An Event Driven Program
4521
4522 =item THE CALL_ FUNCTIONS
4523
4524 call_sv, call_pv, call_method, call_argv
4525
4526 =item FLAG VALUES
4527
4528 =over 4
4529
4530 =item  G_VOID
4531
4532 =item  G_SCALAR
4533
4534 =item G_ARRAY
4535
4536 =item G_DISCARD
4537
4538 =item G_NOARGS
4539
4540 =item G_EVAL
4541
4542 =item G_KEEPERR
4543
4544 =item Determining the Context
4545
4546 =back
4547
4548 =item KNOWN PROBLEMS
4549
4550 =item EXAMPLES
4551
4552 =over 4
4553
4554 =item No Parameters, Nothing returned
4555
4556 =item Passing Parameters
4557
4558 =item Returning a Scalar
4559
4560 =item Returning a list of values
4561
4562 =item Returning a list in a scalar context
4563
4564 =item Returning Data from Perl via the parameter list
4565
4566 =item Using G_EVAL
4567
4568 =item Using G_KEEPERR
4569
4570 =item Using call_sv
4571
4572 =item Using call_argv
4573
4574 =item Using call_method
4575
4576 =item Using GIMME_V
4577
4578 =item Using Perl to dispose of temporaries
4579
4580 =item Strategies for storing Callback Context Information
4581
4582 1. Ignore the problem - Allow only 1 callback, 2. Create a sequence of
4583 callbacks - hard wired limit, 3. Use a parameter to map to the Perl
4584 callback
4585
4586 =item Alternate Stack Manipulation
4587
4588 =item Creating and calling an anonymous subroutine in C
4589
4590 =back
4591
4592 =item SEE ALSO
4593
4594 =item AUTHOR
4595
4596 =item DATE
4597
4598 =back
4599
4600 =head2 perlapi - autogenerated documentation for the perl public API
4601
4602 =over 4
4603
4604 =item DESCRIPTION
4605
4606 =item "Gimme" Values
4607
4608 GIMME, GIMME_V, G_ARRAY, G_DISCARD, G_EVAL, G_NOARGS, G_SCALAR, G_VOID
4609
4610 =item Array Manipulation Functions
4611
4612 AvFILL, av_clear, av_delete, av_exists, av_extend, av_fetch, av_fill,
4613 av_len, av_make, av_pop, av_push, av_shift, av_store, av_undef, av_unshift,
4614 get_av, newAV, Nullav, sortsv
4615
4616 =item Callback Functions
4617
4618 call_argv, call_method, call_pv, call_sv, ENTER, eval_pv, eval_sv,
4619 FREETMPS, LEAVE, SAVETMPS
4620
4621 =item Character classes
4622
4623 isALNUM, isALPHA, isDIGIT, isLOWER, isSPACE, isUPPER, toLOWER, toUPPER
4624
4625 =item Cloning an interpreter
4626
4627 perl_clone
4628
4629 =item CV Manipulation Functions
4630
4631 CvSTASH, get_cv, Nullcv
4632
4633 =item Embedding Functions
4634
4635 cv_undef, load_module, nothreadhook, perl_alloc, perl_construct,
4636 perl_destruct, perl_free, perl_parse, perl_run, require_pv
4637
4638 =item Functions in file pp_pack.c
4639
4640 packlist, pack_cat, unpackstring, unpack_str
4641
4642 =item Global Variables
4643
4644 PL_modglobal, PL_na, PL_sv_no, PL_sv_undef, PL_sv_yes
4645
4646 =item GV Functions
4647
4648 GvSV, gv_fetchmeth, gv_fetchmethod, gv_fetchmethod_autoload,
4649 gv_fetchmeth_autoload, gv_stashpv, gv_stashsv
4650
4651 =item Handy Values
4652
4653 HEf_SVKEY, Nullch, Nullsv
4654
4655 =item Hash Manipulation Functions
4656
4657 get_hv, HeHASH, HeKEY, HeKLEN, HePV, HeSVKEY, HeSVKEY_force, HeSVKEY_set,
4658 HeVAL, HvNAME, hv_assert, hv_clear, hv_delete, hv_delete_ent, hv_exists,
4659 hv_exists_ent, hv_fetch, hv_fetch_ent, hv_iterinit, hv_iterkey,
4660 hv_iterkeysv, hv_iternext, hv_iternextsv, hv_iternext_flags, hv_iterval,
4661 hv_magic, hv_store, hv_store_ent, hv_undef, newHV, Nullhv
4662
4663 =item Magical Functions
4664
4665 mg_clear, mg_copy, mg_find, mg_free, mg_get, mg_length, mg_magical, mg_set,
4666 SvGETMAGIC, SvLOCK, SvSETMAGIC, SvSetMagicSV, SvSetMagicSV_nosteal,
4667 SvSetSV, SvSetSV_nosteal, SvSHARE
4668
4669 =item Memory Management
4670
4671 Copy, Move, New, Newc, NEWSV, Newz, Poison, Renew, Renewc, Safefree,
4672 savepv, savepvn, savesharedpv, StructCopy, Zero
4673
4674 =item Miscellaneous Functions
4675
4676 fbm_compile, fbm_instr, form, getcwd_sv, new_version, scan_version, strEQ,
4677 strGE, strGT, strLE, strLT, strNE, strnEQ, strnNE, sv_nolocking,
4678 sv_nosharing, sv_nounlocking, upg_version, vcmp, vnumify, vstringify
4679
4680 =item Numeric functions
4681
4682 grok_bin, grok_hex, grok_number, grok_numeric_radix, grok_oct, scan_bin,
4683 scan_hex, scan_oct
4684
4685 =item Optree Manipulation Functions
4686
4687 cv_const_sv, newCONSTSUB, newXS
4688
4689 =item Pad Data Structures
4690
4691 pad_sv
4692
4693 =item Stack Manipulation Macros
4694
4695 dMARK, dORIGMARK, dSP, EXTEND, MARK, ORIGMARK, POPi, POPl, POPn, POPp,
4696 POPpbytex, POPpx, POPs, PUSHi, PUSHMARK, PUSHn, PUSHp, PUSHs, PUSHu,
4697 PUTBACK, SP, SPAGAIN, XPUSHi, XPUSHn, XPUSHp, XPUSHs, XPUSHu, XSRETURN,
4698 XSRETURN_IV, XSRETURN_NO, XSRETURN_NV, XSRETURN_PV, XSRETURN_UNDEF,
4699 XSRETURN_UV, XSRETURN_YES, XST_mIV, XST_mNO, XST_mNV, XST_mPV, XST_mUNDEF,
4700 XST_mYES
4701
4702 =item SV Flags
4703
4704 svtype, SVt_IV, SVt_NV, SVt_PV, SVt_PVAV, SVt_PVCV, SVt_PVHV, SVt_PVMG
4705
4706 =item SV Manipulation Functions
4707
4708 get_sv, looks_like_number, newRV_inc, newRV_noinc, newSV, newSViv, newSVnv,
4709 newSVpv, newSVpvf, newSVpvn, newSVpvn_share, newSVrv, newSVsv, newSVuv,
4710 SvCUR, SvCUR_set, SvEND, SvGROW, SvIOK, SvIOKp, SvIOK_notUV, SvIOK_off,
4711 SvIOK_on, SvIOK_only, SvIOK_only_UV, SvIOK_UV, SvIsCOW,
4712 SvIsCOW_shared_hash, SvIV, SvIVx, SvIVX, SvLEN, SvNIOK, SvNIOKp,
4713 SvNIOK_off, SvNOK, SvNOKp, SvNOK_off, SvNOK_on, SvNOK_only, SvNV, SvNVX,
4714 SvNVx, SvOK, SvOOK, SvPOK, SvPOKp, SvPOK_off, SvPOK_on, SvPOK_only,
4715 SvPOK_only_UTF8, SvPV, SvPVbyte, SvPVbytex, SvPVbytex_force,
4716 SvPVbyte_force, SvPVbyte_nolen, SvPVutf8, SvPVutf8x, SvPVutf8x_force,
4717 SvPVutf8_force, SvPVutf8_nolen, SvPVx, SvPVX, SvPV_force, SvPV_force_nomg,
4718 SvPV_nolen, SvREFCNT, SvREFCNT_dec, SvREFCNT_inc, SvROK, SvROK_off,
4719 SvROK_on, SvRV, SvSTASH, SvTAINT, SvTAINTED, SvTAINTED_off, SvTAINTED_on,
4720 SvTRUE, SvTYPE, SvUNLOCK, SvUOK, SvUPGRADE, SvUTF8, SvUTF8_off, SvUTF8_on,
4721 SvUV, SvUVX, SvUVx, SvVOK, sv_2bool, sv_2cv, sv_2io, sv_2iv, sv_2mortal,
4722 sv_2nv, sv_2pvbyte, sv_2pvbyte_nolen, sv_2pvutf8, sv_2pvutf8_nolen,
4723 sv_2pv_flags, sv_2pv_nolen, sv_2uv, sv_backoff, sv_bless, sv_catpv,
4724 sv_catpvf, sv_catpvf_mg, sv_catpvn, sv_catpvn_flags, sv_catpvn_mg,
4725 sv_catpv_mg, sv_catsv, sv_catsv_flags, sv_catsv_mg, sv_chop, sv_clear,
4726 sv_cmp, sv_cmp_locale, sv_collxfrm, sv_copypv, sv_dec, sv_derived_from,
4727 sv_eq, sv_force_normal, sv_force_normal_flags, sv_free, sv_gets, sv_grow,
4728 sv_inc, sv_insert, sv_isa, sv_isobject, sv_iv, sv_len, sv_len_utf8,
4729 sv_magic, sv_magicext, sv_mortalcopy, sv_newmortal, sv_newref, sv_nv,
4730 sv_pos_b2u, sv_pos_u2b, sv_pv, sv_pvbyte, sv_pvbyten, sv_pvbyten_force,
4731 sv_pvn, sv_pvn_force, sv_pvn_force_flags, sv_pvutf8, sv_pvutf8n,
4732 sv_pvutf8n_force, sv_reftype, sv_replace, sv_report_used, sv_reset,
4733 sv_rvweaken, sv_setiv, sv_setiv_mg, sv_setnv, sv_setnv_mg, sv_setpv,
4734 sv_setpvf, sv_setpvf_mg, sv_setpviv, sv_setpviv_mg, sv_setpvn,
4735 sv_setpvn_mg, sv_setpv_mg, sv_setref_iv, sv_setref_nv, sv_setref_pv,
4736 sv_setref_pvn, sv_setref_uv, sv_setsv, sv_setsv_flags, sv_setsv_mg,
4737 sv_setuv, sv_setuv_mg, sv_taint, sv_tainted, sv_true, sv_unmagic, sv_unref,
4738 sv_unref_flags, sv_untaint, sv_upgrade, sv_usepvn, sv_usepvn_mg,
4739 sv_utf8_decode, sv_utf8_downgrade, sv_utf8_encode, sv_utf8_upgrade,
4740 sv_utf8_upgrade_flags, sv_uv, sv_vcatpvfn, sv_vsetpvfn
4741
4742 =item Unicode Support
4743
4744 bytes_from_utf8, bytes_to_utf8, ibcmp_utf8, is_utf8_char, is_utf8_string,
4745 is_utf8_string_loc, pv_uni_display, sv_cat_decode, sv_recode_to_utf8,
4746 sv_uni_display, to_utf8_case, to_utf8_fold, to_utf8_lower, to_utf8_title,
4747 to_utf8_upper, utf8n_to_uvchr, utf8n_to_uvuni, utf8_distance, utf8_hop,
4748 utf8_length, utf8_to_bytes, utf8_to_uvchr, utf8_to_uvuni, uvchr_to_utf8,
4749 uvuni_to_utf8_flags
4750
4751 =item Variables created by C<xsubpp> and C<xsubpp> internal functions
4752
4753 ax, CLASS, dAX, dITEMS, dXSARGS, dXSI32, items, ix, newXSproto, RETVAL, ST,
4754 THIS, XS, XSRETURN_EMPTY, XS_VERSION, XS_VERSION_BOOTCHECK
4755
4756 =item Warning and Dieing
4757
4758 croak, warn
4759
4760 =item AUTHORS
4761
4762 =item SEE ALSO
4763
4764 =back
4765
4766 =head2 perlintern - autogenerated documentation of purely B<internal>
4767                  Perl functions
4768
4769 =over 4
4770
4771 =item DESCRIPTION
4772
4773 =item CV reference counts and CvOUTSIDE
4774
4775 CvWEAKOUTSIDE
4776
4777 =item Functions in file pad.h
4778
4779 CX_CURPAD_SAVE, CX_CURPAD_SV, PAD_BASE_SV, PAD_CLONE_VARS,
4780 PAD_COMPNAME_FLAGS, PAD_COMPNAME_GEN, PAD_COMPNAME_OURSTASH,
4781 PAD_COMPNAME_PV, PAD_COMPNAME_TYPE, PAD_DUP, PAD_RESTORE_LOCAL,
4782 PAD_SAVE_LOCAL, PAD_SAVE_SETNULLPAD, PAD_SETSV, PAD_SET_CUR,
4783 PAD_SET_CUR_NOSAVE, PAD_SV, PAD_SVl, SAVECLEARSV, SAVECOMPPAD, SAVEPADSV
4784
4785 =item Functions in file pp_ctl.c
4786
4787 find_runcv
4788
4789 =item Global Variables
4790
4791 PL_DBsingle, PL_DBsub, PL_DBtrace, PL_dowarn, PL_last_in_gv, PL_ofs_sv,
4792 PL_rs
4793
4794 =item GV Functions
4795
4796 is_gv_magical
4797
4798 =item IO Functions
4799
4800 start_glob
4801
4802 =item Pad Data Structures
4803
4804 CvPADLIST, cv_clone, cv_dump, do_dump_pad, intro_my, pad_add_anon,
4805 pad_add_name, pad_alloc, pad_block_start, pad_check_dup, pad_findlex,
4806 pad_findmy, pad_fixup_inner_anons, pad_free, pad_leavemy, pad_new,
4807 pad_push, pad_reset, pad_setsv, pad_swipe, pad_tidy, pad_undef
4808
4809 =item Stack Manipulation Macros
4810
4811 djSP, LVRET
4812
4813 =item SV Manipulation Functions
4814
4815 report_uninit, sv_add_arena, sv_clean_all, sv_clean_objs, sv_free_arenas
4816
4817 =item AUTHORS
4818
4819 =item SEE ALSO
4820
4821 =back
4822
4823 =head2 perliol - C API for Perl's implementation of IO in Layers.
4824
4825 =over 4
4826
4827 =item SYNOPSIS
4828
4829 =item DESCRIPTION
4830
4831 =over 4
4832
4833 =item History and Background
4834
4835 =item Basic Structure
4836
4837 =item Layers vs Disciplines
4838
4839 =item Data Structures
4840
4841 =item Functions and Attributes
4842
4843 =item Per-instance Data
4844
4845 =item Layers in action.
4846
4847 =item Per-instance flag bits
4848
4849 PERLIO_F_EOF, PERLIO_F_CANWRITE,  PERLIO_F_CANREAD, PERLIO_F_ERROR,
4850 PERLIO_F_TRUNCATE, PERLIO_F_APPEND, PERLIO_F_CRLF, PERLIO_F_UTF8,
4851 PERLIO_F_UNBUF, PERLIO_F_WRBUF, PERLIO_F_RDBUF, PERLIO_F_LINEBUF,
4852 PERLIO_F_TEMP, PERLIO_F_OPEN, PERLIO_F_FASTGETS
4853
4854 =item Methods in Detail
4855
4856 fsize, name, size, kind, PERLIO_K_BUFFERED, PERLIO_K_RAW, PERLIO_K_CANCRLF,
4857 PERLIO_K_FASTGETS, PERLIO_K_MULTIARG, Pushed, Popped, Open, Binmode,
4858 Getarg, Fileno, Dup, Read, Write, Seek, Tell, Close, Flush, Fill, Eof,
4859 Error,  Clearerr, Setlinebuf, Get_base, Get_bufsiz, Get_ptr, Get_cnt,
4860 Set_ptrcnt
4861
4862 =item Utilities
4863
4864 =item Implementing PerlIO Layers
4865
4866 C implementations, Perl implementations
4867
4868 =item Core Layers
4869
4870 "unix", "perlio", "stdio", "crlf", "mmap", "pending", "raw", "utf8"
4871
4872 =item Extension Layers
4873
4874 ":encoding", ":scalar", ":via"
4875
4876 =back
4877
4878 =item TODO
4879
4880 =back
4881
4882 =head2 perlapio - perl's IO abstraction interface.
4883
4884 =over 4
4885
4886 =item SYNOPSIS
4887
4888 =item DESCRIPTION
4889
4890 1. USE_STDIO, 2. USE_SFIO, 3. USE_PERLIO, B<PerlIO_stdin()>,
4891 B<PerlIO_stdout()>, B<PerlIO_stderr()>, B<PerlIO_open(path, mode)>,
4892 B<PerlIO_fdopen(fd,mode)>, B<PerlIO_reopen(path,mode,f)>,
4893 B<PerlIO_printf(f,fmt,...)>, B<PerlIO_vprintf(f,fmt,a)>,
4894 B<PerlIO_stdoutf(fmt,...)>, B<PerlIO_read(f,buf,count)>,
4895 B<PerlIO_write(f,buf,count)>, B<PerlIO_close(f)>, B<PerlIO_puts(f,s)>,
4896 B<PerlIO_putc(f,c)>, B<PerlIO_ungetc(f,c)>, B<PerlIO_getc(f)>,
4897 B<PerlIO_eof(f)>, B<PerlIO_error(f)>, B<PerlIO_fileno(f)>,
4898 B<PerlIO_clearerr(f)>, B<PerlIO_flush(f)>, B<PerlIO_seek(f,offset,whence)>,
4899 B<PerlIO_tell(f)>, B<PerlIO_getpos(f,p)>, B<PerlIO_setpos(f,p)>,
4900 B<PerlIO_rewind(f)>, B<PerlIO_tmpfile()>, B<PerlIO_setlinebuf(f)>
4901
4902 =over 4
4903
4904 =item Co-existence with stdio
4905
4906 B<PerlIO_importFILE(f,mode)>, B<PerlIO_exportFILE(f,mode)>,
4907 B<PerlIO_releaseFILE(p,f)>, B<PerlIO_findFILE(f)>
4908
4909 =item "Fast gets" Functions
4910
4911 B<PerlIO_fast_gets(f)>, B<PerlIO_has_cntptr(f)>, B<PerlIO_get_cnt(f)>,
4912 B<PerlIO_get_ptr(f)>, B<PerlIO_set_ptrcnt(f,p,c)>, B<PerlIO_canset_cnt(f)>,
4913 B<PerlIO_set_cnt(f,c)>, B<PerlIO_has_base(f)>, B<PerlIO_get_base(f)>,
4914 B<PerlIO_get_bufsiz(f)>
4915
4916 =item Other Functions
4917
4918 PerlIO_apply_layers(f,mode,layers), PerlIO_binmode(f,ptype,imode,layers),
4919 'E<lt>' read, 'E<gt>' write, '+' read/write, PerlIO_debug(fmt,...)
4920
4921 =back
4922
4923 =back
4924
4925 =head2 perlhack - How to hack at the Perl internals
4926
4927 =over 4
4928
4929 =item DESCRIPTION
4930
4931 Does concept match the general goals of Perl?, Where is the
4932 implementation?, Backwards compatibility, Could it be a module instead?, Is
4933 the feature generic enough?, Does it potentially introduce new bugs?, Does
4934 it preclude other desirable features?, Is the implementation robust?, Is
4935 the implementation generic enough to be portable?, Is the implementation
4936 tested?, Is there enough documentation?, Is there another way to do it?,
4937 Does it create too much work?, Patches speak louder than words
4938
4939 =over 4
4940
4941 =item Keeping in sync
4942
4943 rsync'ing the source tree, Using rsync over the LAN, Using pushing over the
4944 NFS, rsync'ing the patches
4945
4946 =item Why rsync the source tree
4947
4948 It's easier to rsync the source tree, It's more reliable
4949
4950 =item Why rsync the patches
4951
4952 It's easier to rsync the patches, It's a good reference, Finding a start
4953 point, Finding how to fix a bug, Finding the source of misbehaviour
4954
4955 =item Perlbug administration
4956
4957 =item Submitting patches
4958
4959 L<perlguts>, L<perlxstut> and L<perlxs>, L<perlapi>,
4960 F<Porting/pumpkin.pod>, The perl5-porters FAQ
4961
4962 =item Finding Your Way Around
4963
4964 Core modules, Tests, Documentation, Configure, Interpreter
4965
4966 =item Elements of the interpreter
4967
4968 Startup, Parsing, Optimization, Running
4969
4970 =item Internal Variable Types
4971
4972 =item Op Trees
4973
4974 =item Stacks
4975
4976 Argument stack, Mark stack, Save stack
4977
4978 =item Millions of Macros
4979
4980 =item The .i Targets
4981
4982 =item Poking at Perl
4983
4984 =item Using a source-level debugger
4985
4986 run [args], break function_name, break source.c:xxx, step, next, continue,
4987 finish, 'enter', print
4988
4989 =item gdb macro support
4990
4991 =item Dumping Perl Data Structures
4992
4993 =item Patching
4994
4995 =item Patching a core module
4996
4997 =item Adding a new function to the core
4998
4999 =item Writing a test
5000
5001 F<t/base/>, F<t/cmd/>, F<t/comp/>, F<t/io/>, F<t/lib/>, F<t/op/>,
5002 F<t/pod/>, F<t/run/>, F<t/uni/>, F<t/win32/>, F<t/x2p>, t/base t/comp,
5003 t/cmd t/run t/io t/op, t/lib ext lib
5004
5005 =item Special Make Test Targets
5006
5007 coretest, test.deparse, test.taintwarn, minitest, test.valgrind
5008 check.valgrind utest.valgrind ucheck.valgrind, test.third check.third
5009 utest.third ucheck.third, test.torture torturetest, utest ucheck test.utf8
5010 check.utf8, test_harness
5011
5012 =item Running tests by hand
5013
5014 PERL_CORE=1, PERL_DESTRUCT_LEVEL=2, PERL, PERL_SKIP_TTY_TEST
5015
5016 =back
5017
5018 =item EXTERNAL TOOLS FOR DEBUGGING PERL
5019
5020 =over 4
5021
5022 =item Rational Software's Purify
5023
5024 =item Purify on Unix
5025
5026 -Accflags=-DPURIFY, -Doptimize='-g', -Uusemymalloc, -Dusemultiplicity
5027
5028 =item Purify on NT
5029
5030 DEFINES, USE_MULTI = define, #PERL_MALLOC = define, CFG = Debug
5031
5032 =item valgrind
5033
5034 =item Compaq's/Digital's/HP's Third Degree
5035
5036 =item PERL_DESTRUCT_LEVEL
5037
5038 =item Profiling
5039
5040 =item Gprof Profiling
5041
5042 -a, -b, -e routine, -f routine, -s, -z
5043
5044 =item GCC gcov Profiling
5045
5046 =item Pixie Profiling
5047
5048 -h, -l, -p[rocedures], -h[eavy], -i[nvocations], -l[ines], -testcoverage,
5049 -z[ero]
5050
5051 =item Miscellaneous tricks
5052
5053 =item CONCLUSION
5054
5055 I<The Road goes ever on and on, down from the door where it began.>
5056
5057 =back
5058
5059 =item AUTHOR
5060
5061 =back
5062
5063 =head2 perlbook - Perl book information
5064
5065 =over 4
5066
5067 =item DESCRIPTION
5068
5069 =back
5070
5071 =head2 perltodo - Perl TO-DO List
5072
5073 =over 4
5074
5075 =item DESCRIPTION
5076
5077 =item To do during 5.6.x
5078
5079 =over 4
5080
5081 =item Support for I/O disciplines
5082
5083 =item Autoload bytes.pm
5084
5085 =item Make "\u{XXXX}" et al work
5086
5087 =item Create a char *sv_pvprintify(sv, STRLEN *lenp, UV flags)
5088
5089 =item Overloadable regex assertions
5090
5091 =item Unicode
5092
5093 =item Work out exit/die semantics for threads
5094
5095 =item Better support for nonpreemptive threading systems like GNU pth
5096
5097 =item Typed lexicals for compiler
5098
5099 =item Compiler workarounds for Win32
5100
5101 =item AUTOLOADing in the compiler
5102
5103 =item Fixing comppadlist when compiling
5104
5105 =item Cleaning up exported namespace
5106
5107 =item Complete signal handling
5108
5109 =item Out-of-source builds
5110
5111 =item POSIX realtime support
5112
5113 =item UNIX98 support
5114
5115 =item IPv6 Support
5116
5117 =item Long double conversion
5118
5119 =item Locales
5120
5121 =item Arithmetic on non-Arabic numerals
5122
5123 =item POSIX Unicode character classes
5124
5125 =item Factoring out common suffices/prefices in regexps (trie optimization)
5126
5127 =item Security audit shipped utilities
5128
5129 =item Sort out the uid-setting mess
5130
5131 =item Custom opcodes
5132
5133 =item DLL Versioning
5134
5135 =item Introduce @( and @)
5136
5137 =item Floating point handling
5138
5139 =item IV/UV preservation
5140
5141 =item Replace pod2html with something using Pod::Parser
5142
5143 =item Automate module testing on CPAN
5144
5145 =item sendmsg and recvmsg
5146
5147 =item Rewrite perlre documentation
5148
5149 =item Convert example code to IO::Handle filehandles
5150
5151 =item Document Win32 choices
5152
5153 =item Check new modules
5154
5155 =item Make roffitall find pods and libs itself
5156
5157 =back
5158
5159 =item To do at some point
5160
5161 =over 4
5162
5163 =item Remove regular expression recursion
5164
5165 =item Memory leaks after failed eval
5166
5167 =item bitfields in pack
5168
5169 =item Cross compilation
5170
5171 =item Perl preprocessor / macros
5172
5173 =item Perl lexer in Perl
5174
5175 =item Using POSIX calls internally
5176
5177 =item -i rename file when changed
5178
5179 =item All ARGV input should act like E<lt>E<gt>
5180
5181 =item Support for rerunning debugger
5182
5183 =item Test Suite for the Debugger
5184
5185 =item my sub foo { }
5186
5187 =item One-pass global destruction
5188
5189 =item Rewrite regexp parser
5190
5191 =item Cache recently used regexps
5192
5193 =item Cross-compilation support
5194
5195 =item Bit-shifting bitvectors
5196
5197 =item debugger pragma
5198
5199 =item use less pragma
5200
5201 =item switch structures
5202
5203 =item Cache eval tree
5204
5205 =item rcatmaybe
5206
5207 =item Shrink opcode tables
5208
5209 =item Optimize away @_
5210
5211 =item Prototypes versus indirect objects
5212
5213 =item Install HTML
5214
5215 =item Prototype method calls
5216
5217 =item Return context prototype declarations
5218
5219 =item magic_setisa
5220
5221 =item Garbage collection
5222
5223 =item IO tutorial
5224
5225 =item Rewrite perldoc
5226
5227 =item Install .3p manpages
5228
5229 =item Unicode tutorial
5230
5231 =item Update POSIX.pm for 1003.1-2
5232
5233 =item Retargetable installation
5234
5235 =item POSIX emulation on non-POSIX systems
5236
5237 =item Rename Win32 headers
5238
5239 =item Finish off lvalue functions
5240
5241 =item Update sprintf documentation
5242
5243 =item Use fchown/fchmod internally
5244
5245 =item Make v-strings overloaded objects
5246
5247 =item Allow restricted hash assignment
5248
5249 =item Should overload be inheritable?
5250
5251 =item Taint rethink
5252
5253 =item Perform correctly when XSUBs call subroutines that exit via
5254 goto(LABEL) and friends
5255
5256 =back
5257
5258 =item Vague ideas
5259
5260 =over 4
5261
5262 =item ref() in list context
5263
5264 =item Make tr/// return histogram of characters in list context
5265
5266 =item Compile to real threaded code
5267
5268 =item Structured types
5269
5270 =item Modifiable $1 et al.
5271
5272 =item Procedural interfaces for IO::*, etc.
5273
5274 =item RPC modules
5275
5276 =item Attach/detach debugger from running program
5277
5278 =item GUI::Native
5279
5280 =item foreach(reverse ...)
5281
5282 =item Constant function cache
5283
5284 =item Approximate regular expression matching
5285
5286 =back
5287
5288 =item Ongoing
5289
5290 =over 4
5291
5292 =item Update guts documentation
5293
5294 =item Add more tests
5295
5296 =item Update auxiliary tools
5297
5298 =item Create debugging macros
5299
5300 =item truncate to the people
5301
5302 =item Unicode in Filenames
5303
5304 =back
5305
5306 =item Unicode in %ENV
5307
5308 =item Recently done things
5309
5310 =over 4
5311
5312 =item Alternative RE syntax module
5313
5314 =item Safe signal handling
5315
5316 =item Tie Modules
5317
5318 =item gettimeofday
5319
5320 =item setitimer and getimiter
5321
5322 =item Testing __DIE__ hook
5323
5324 =item CPP equivalent in Perl
5325
5326 =item Explicit switch statements
5327
5328 =item autocroak
5329
5330 =item UTF/EBCDIC
5331
5332 =item UTF Regexes
5333
5334 =item perlcc to produce executable
5335
5336 =item END blocks saved in compiled output
5337
5338 =item Secure temporary file module
5339
5340 =item Integrate Time::HiRes
5341
5342 =item Turn Cwd into XS
5343
5344 =item Mmap for input
5345
5346 =item Byte to/from UTF-8 and UTF-8 to/from local conversion
5347
5348 =item Add sockatmark support
5349
5350 =item Mailing list archives
5351
5352 =item Bug tracking
5353
5354 =item Integrate MacPerl
5355
5356 =item Web "nerve center" for Perl
5357
5358 =item Regular expression tutorial
5359
5360 =item Debugging Tutorial
5361
5362 =item Integrate new modules
5363
5364 =item Integrate profiler
5365
5366 =item Y2K error detection
5367
5368 =item Regular expression debugger
5369
5370 =item POD checker
5371
5372 =item "Dynamic" lexicals
5373
5374 =item Cache precompiled modules
5375
5376 =back
5377
5378 =item Deprecated Wishes
5379
5380 =over 4
5381
5382 =item Loop control on do{}
5383
5384 =item Lexically scoped typeglobs
5385
5386 =item format BOTTOM
5387
5388 =item report HANDLE
5389
5390 =item Generalised want()/caller())
5391
5392 =item Named prototypes
5393
5394 =item Built-in globbing
5395
5396 =item Regression tests for suidperl
5397
5398 =item Cached hash values
5399
5400 =item Add compression modules
5401
5402 =item Reorganise documentation into tutorials/references
5403
5404 =item Remove distinction between functions and operators
5405
5406 =item Make XS easier to use
5407
5408 =item Make embedding easier to use
5409
5410 =item man for perl
5411
5412 =item my $Package::variable
5413
5414 =item "or" tests defined, not truth
5415
5416 =item "class"-based lexicals
5417
5418 =item byteperl
5419
5420 =item Lazy evaluation / tail recursion removal
5421
5422 =item Make "use utf8" the default
5423
5424 =item Unicode collation and normalization
5425
5426 =item pack/unpack tutorial
5427
5428 =back
5429
5430 =back
5431
5432 =head2 perldoc - Look up Perl documentation in Pod format.
5433
5434 =over 4
5435
5436 =item SYNOPSIS
5437
5438 =item DESCRIPTION
5439
5440 =item OPTIONS
5441
5442 B<-h>, B<-v>, B<-t>, B<-u>, B<-m> I<module>, B<-l>, B<-F>, B<-f>
5443 I<perlfunc>, B<-q> I<perlfaq-search-regexp>, B<-T>, B<-d>
5444 I<destination-filename>, B<-o> I<output-formatname>, B<-M> I<module-name>,
5445 B<-w> I<option:value> or B<-w> I<option>, B<-X>,
5446 B<PageName|ModuleName|ProgramName>, B<-n> I<some-formatter>, B<-r>, B<-i>,
5447 B<-V>
5448
5449 =item SECURITY
5450
5451 =item ENVIRONMENT
5452
5453 =item AUTHOR
5454
5455 =back
5456
5457 =head2 perlhist - the Perl history records
5458
5459 =over 4
5460
5461 =item DESCRIPTION
5462
5463 =item INTRODUCTION
5464
5465 =item THE KEEPERS OF THE PUMPKIN
5466
5467 =over 4
5468
5469 =item PUMPKIN?
5470
5471 =back
5472
5473 =item THE RECORDS
5474
5475 =over 4
5476
5477 =item SELECTED RELEASE SIZES
5478
5479 =item SELECTED PATCH SIZES
5480
5481 =back
5482
5483 =item THE KEEPERS OF THE RECORDS
5484
5485 =back
5486
5487 =head2 perldelta - what is new for perl v5.9.0
5488
5489 =over 4
5490
5491 =item DESCRIPTION
5492
5493 =item Incompatible Changes
5494
5495 =over 4
5496
5497 =item Hash Randomisation
5498
5499 =item UTF-8 On Filehandles No Longer Activated By Locale
5500
5501 =item Single-number v-strings are no longer v-strings before "=>"
5502
5503 =item (Win32) The -C Switch Has Been Repurposed
5504
5505 =item (Win32) The /d Switch Of cmd.exe
5506
5507 =item The C<$*> variable has been removed
5508
5509 =back
5510
5511 =item Core Enhancements
5512
5513 =over 4
5514
5515 =item Assertions
5516
5517 =item Defined-or operators
5518
5519 =item UTF-8 no longer default under UTF-8 locales
5520
5521 =item Unsafe signals again available
5522
5523 =item Tied Arrays with Negative Array Indices
5524
5525 =item local ${$x}
5526
5527 =item Unicode Character Database 4.0.0
5528
5529 =item Miscellaneous Enhancements
5530
5531 =back
5532
5533 =item Modules and Pragmata
5534
5535 =over 4
5536
5537 =item Updated Modules And Pragmata
5538
5539 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
5540 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
5541 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
5542 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
5543 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
5544 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
5545 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
5546 Win32::GetOSVersion
5547
5548 =back
5549
5550 =item Utility Changes
5551
5552 =item New Documentation
5553
5554 =item Performance Enhancements
5555
5556 =item Installation and Configuration Improvements
5557
5558 =over 4
5559
5560 =item Platform-specific enhancements
5561
5562 =back
5563
5564 =item Selected Bug Fixes
5565
5566 =over 4
5567
5568 =item Closures, eval and lexicals
5569
5570 =item Generic fixes
5571
5572 =item Platform-specific fixes
5573
5574 =back
5575
5576 =item New or Changed Diagnostics
5577
5578 =over 4
5579
5580 =item Changed "A thread exited while %d threads were running"
5581
5582 =item Removed "Attempt to clear a restricted hash"
5583
5584 =item New "Illegal declaration of anonymous subroutine"
5585
5586 =item Changed "Invalid range "%s" in transliteration operator"
5587
5588 =item New "Missing control char name in \c"
5589
5590 =item New "Newline in left-justified string for %s"
5591
5592 =item New "Possible precedence problem on bitwise %c operator"
5593
5594 =item New "read() on %s filehandle %s"
5595
5596 =item New "Tied variable freed while still in use"
5597
5598 =item New "To%s: illegal mapping '%s'"
5599
5600 =item New "Use of freed value in iteration"
5601
5602 =back
5603
5604 =item Changed Internals
5605
5606 =item New Tests
5607
5608 =item Known Problems
5609
5610 =over 4
5611
5612 =item Tied hashes in scalar context
5613
5614 =item Net::Ping 450_service and 510_ping_udp failures
5615
5616 =item B::C
5617
5618 =back
5619
5620 =item Platform Specific Problems
5621
5622 =over 4
5623
5624 =item EBCDIC Platforms
5625
5626 =item Cygwin 1.5 problems
5627
5628 =item HP-UX: HP cc warnings about sendfile and sendpath
5629
5630 =item IRIX: t/uni/tr_7jis.t falsely failing
5631
5632 =item Mac OS X: no usemymalloc
5633
5634 =item Tru64: No threaded builds with GNU cc (gcc)
5635
5636 =item Win32: sysopen, sysread, syswrite
5637
5638 =back
5639
5640 =item TODO
5641
5642 =item Reporting Bugs
5643
5644 =item SEE ALSO
5645
5646 =back
5647
5648 =head2 perl58delta, perldelta - what is new for perl v5.8.0
5649
5650 =over 4
5651
5652 =item DESCRIPTION
5653
5654 =item Highlights In 5.8.0
5655
5656 =item Incompatible Changes
5657
5658 =over 4
5659
5660 =item Binary Incompatibility
5661
5662 =item 64-bit platforms and malloc
5663
5664 =item AIX Dynaloading
5665
5666 =item Attributes for C<my> variables now handled at run-time
5667
5668 =item Socket Extension Dynamic in VMS
5669
5670 =item IEEE-format Floating Point Default on OpenVMS Alpha
5671
5672 =item New Unicode Semantics (no more C<use utf8>, almost)
5673
5674 =item New Unicode Properties
5675
5676 =item REF(...) Instead Of SCALAR(...)
5677
5678 =item pack/unpack D/F recycled
5679
5680 =item glob() now returns filenames in alphabetical order
5681
5682 =item Deprecations
5683
5684 =back
5685
5686 =item Core Enhancements
5687
5688 =over 4
5689
5690 =item Unicode Overhaul
5691
5692 =item PerlIO is Now The Default
5693
5694 =item ithreads
5695
5696 =item Restricted Hashes
5697
5698 =item Safe Signals
5699
5700 =item Understanding of Numbers
5701
5702 =item Arrays now always interpolate into double-quoted strings [561]
5703
5704 =item Miscellaneous Changes
5705
5706 =back
5707
5708 =item Modules and Pragmata
5709
5710 =over 4
5711
5712 =item New Modules and Pragmata
5713
5714 =item Updated And Improved Modules and Pragmata
5715
5716 =back
5717
5718 =item Utility Changes
5719
5720 =item New Documentation
5721
5722 =item Performance Enhancements
5723
5724 =item Installation and Configuration Improvements
5725
5726 =over 4
5727
5728 =item Generic Improvements
5729
5730 =item New Or Improved Platforms
5731
5732 =back
5733
5734 =item Selected Bug Fixes
5735
5736 =over 4
5737
5738 =item Platform Specific Changes and Fixes
5739
5740 =back
5741
5742 =item New or Changed Diagnostics
5743
5744 =item Changed Internals
5745
5746 =item Security Vulnerability Closed [561]
5747
5748 =item New Tests
5749
5750 =item Known Problems
5751
5752 =over 4
5753
5754 =item The Compiler Suite Is Still Very Experimental
5755
5756 =item Localising Tied Arrays and Hashes Is Broken
5757
5758 =item Building Extensions Can Fail Because Of Largefiles
5759
5760 =item Modifying $_ Inside for(..)
5761
5762 =item mod_perl 1.26 Doesn't Build With Threaded Perl
5763
5764 =item lib/ftmp-security tests warn 'system possibly insecure'
5765
5766 =item libwww-perl (LWP) fails base/date #51
5767
5768 =item PDL failing some tests
5769
5770 =item Perl_get_sv
5771
5772 =item Self-tying Problems
5773
5774 =item ext/threads/t/libc
5775
5776 =item Failure of Thread (5.005-style) tests
5777
5778 =item Timing problems
5779
5780 =item Tied/Magical Array/Hash Elements Do Not Autovivify
5781
5782 =item Unicode in package/class and subroutine names does not work
5783
5784 =back
5785
5786 =item Platform Specific Problems
5787
5788 =over 4
5789
5790 =item AIX
5791
5792 =item Alpha systems with old gccs fail several tests
5793
5794 =item AmigaOS
5795
5796 =item BeOS
5797
5798 =item Cygwin "unable to remap"
5799
5800 =item Cygwin ndbm tests fail on FAT
5801
5802 =item DJGPP Failures
5803
5804 =item FreeBSD built with ithreads coredumps reading large directories
5805
5806 =item FreeBSD Failing locale Test 117 For ISO 8859-15 Locales
5807
5808 =item IRIX fails ext/List/Util/t/shuffle.t or Digest::MD5
5809
5810 =item HP-UX lib/posix Subtest 9 Fails When LP64-Configured
5811
5812 =item Linux with glibc 2.2.5 fails t/op/int subtest #6 with -Duse64bitint
5813
5814 =item Linux With Sfio Fails op/misc Test 48
5815
5816 =item Mac OS X
5817
5818 =item Mac OS X dyld undefined symbols
5819
5820 =item OS/2 Test Failures
5821
5822 =item op/sprintf tests 91, 129, and 130
5823
5824 =item SCO
5825
5826 =item Solaris 2.5
5827
5828 =item Solaris x86 Fails Tests With -Duse64bitint
5829
5830 =item SUPER-UX (NEC SX)
5831
5832 =item Term::ReadKey not working on Win32
5833
5834 =item UNICOS/mk
5835
5836 =item UTS
5837
5838 =item VOS (Stratus)
5839
5840 =item VMS
5841
5842 =item Win32
5843
5844 =item XML::Parser not working
5845
5846 =item z/OS (OS/390)
5847
5848 =item Unicode Support on EBCDIC Still Spotty
5849
5850 =item Seen In Perl 5.7 But Gone Now
5851
5852 =back
5853
5854 =item Reporting Bugs
5855
5856 =item SEE ALSO
5857
5858 =item HISTORY
5859
5860 =back
5861
5862 =head2 perl581delta, perldelta - what is new for perl v5.8.1
5863
5864 =over 4
5865
5866 =item DESCRIPTION
5867
5868 =item Incompatible Changes
5869
5870 =over 4
5871
5872 =item Hash Randomisation
5873
5874 =item UTF-8 On Filehandles No Longer Activated By Locale
5875
5876 =item Single-number v-strings are no longer v-strings before "=>"
5877
5878 =item (Win32) The -C Switch Has Been Repurposed
5879
5880 =item (Win32) The /d Switch Of cmd.exe
5881
5882 =back
5883
5884 =item Core Enhancements
5885
5886 =over 4
5887
5888 =item UTF-8 no longer default under UTF-8 locales
5889
5890 =item Unsafe signals again available
5891
5892 =item Tied Arrays with Negative Array Indices
5893
5894 =item local ${$x}
5895
5896 =item Unicode Character Database 4.0.0
5897
5898 =item Deprecation Warnings
5899
5900 =item Miscellaneous Enhancements
5901
5902 =back
5903
5904 =item Modules and Pragmata
5905
5906 =over 4
5907
5908 =item Updated Modules And Pragmata
5909
5910 base, B::Bytecode, B::Concise, B::Deparse, Benchmark, ByteLoader, bytes,
5911 CGI, charnames, CPAN, Data::Dumper, DB_File, Devel::PPPort, Digest::MD5,
5912 Encode, fields, libnet, Math::BigInt, MIME::Base64, NEXT, Net::Ping,
5913 PerlIO::scalar, podlators, Pod::LaTeX, PodParsers, Pod::Perldoc,
5914 Scalar::Util, Storable, strict, Term::ANSIcolor, Test::Harness, Test::More,
5915 Test::Simple, Text::Balanced, Time::HiRes, threads, threads::shared,
5916 Unicode::Collate, Unicode::Normalize, Win32::GetFolderPath,
5917 Win32::GetOSVersion
5918
5919 =back
5920
5921 =item Utility Changes
5922
5923 =item New Documentation
5924
5925 =item Installation and Configuration Improvements
5926
5927 =over 4
5928
5929 =item Platform-specific enhancements
5930
5931 =back
5932
5933 =item Selected Bug Fixes
5934
5935 =over 4
5936
5937 =item Closures, eval and lexicals
5938
5939 =item Generic fixes
5940
5941 =item Platform-specific fixes
5942
5943 =back
5944
5945 =item New or Changed Diagnostics
5946
5947 =over 4
5948
5949 =item Changed "A thread exited while %d threads were running"
5950
5951 =item Removed "Attempt to clear a restricted hash"
5952
5953 =item New "Illegal declaration of anonymous subroutine"
5954
5955 =item Changed "Invalid range "%s" in transliteration operator"
5956
5957 =item New "Missing control char name in \c"
5958
5959 =item New "Newline in left-justified string for %s"
5960
5961 =item New "Possible precedence problem on bitwise %c operator"
5962
5963 =item New "Pseudo-hashes are deprecated"
5964
5965 =item New "read() on %s filehandle %s"
5966
5967 =item New "5.005 threads are deprecated"
5968
5969 =item New "Tied variable freed while still in use"
5970
5971 =item New "To%s: illegal mapping '%s'"
5972
5973 =item New "Use of freed value in iteration"
5974
5975 =back
5976
5977 =item Changed Internals
5978
5979 =item New Tests
5980
5981 =item Known Problems
5982
5983 =over 4
5984
5985 =item Tied hashes in scalar context
5986
5987 =item Net::Ping 450_service and 510_ping_udp failures
5988
5989 =item B::C
5990
5991 =back
5992
5993 =item Platform Specific Problems
5994
5995 =over 4
5996
5997 =item EBCDIC Platforms
5998
5999 =item Cygwin 1.5 problems
6000
6001 =item HP-UX: HP cc warnings about sendfile and sendpath
6002
6003 =item IRIX: t/uni/tr_7jis.t falsely failing
6004
6005 =item Mac OS X: no usemymalloc
6006
6007 =item Tru64: No threaded builds with GNU cc (gcc)
6008
6009 =item Win32: sysopen, sysread, syswrite
6010
6011 =back
6012
6013 =item Future Directions
6014
6015 =item Reporting Bugs
6016
6017 =item SEE ALSO
6018
6019 =back
6020
6021 =head2 perl573delta - what's new for perl v5.7.3
6022
6023 =over 4
6024
6025 =item DESCRIPTION
6026
6027 =item Changes
6028
6029 =item Reporting Bugs
6030
6031 =item SEE ALSO
6032
6033 =item HISTORY
6034
6035 =back
6036
6037 =head2 perl572delta - what's new for perl v5.7.2
6038
6039 =over 4
6040
6041 =item DESCRIPTION
6042
6043 =item Security Vulnerability Closed
6044
6045 =item Incompatible Changes
6046
6047 =over 4
6048
6049 =item 64-bit platforms and malloc
6050
6051 =item AIX Dynaloading
6052
6053 =item Socket Extension Dynamic in VMS
6054
6055 =item Different Definition of the Unicode Character Classes \p{In...}
6056
6057 =item Deprecations
6058
6059 =back
6060
6061 =item Core Enhancements
6062
6063 =item Modules and Pragmata
6064
6065 =over 4
6066
6067 =item New Modules and Distributions
6068
6069 =item Updated And Improved Modules and Pragmata
6070
6071 =back
6072
6073 =item Utility Changes
6074
6075 =item New Documentation
6076
6077 =item Installation and Configuration Improvements
6078
6079 =over 4
6080
6081 =item New Or Improved Platforms
6082
6083 =item Generic Improvements
6084
6085 =back
6086
6087 =item Selected Bug Fixes
6088
6089 =over 4
6090
6091 =item Platform Specific Changes and Fixes
6092
6093 =back
6094
6095 =item New or Changed Diagnostics
6096
6097 =item Source Code Enhancements
6098
6099 =over 4
6100
6101 =item MAGIC constants
6102
6103 =item Better commented code
6104
6105 =item Regex pre-/post-compilation items matched up
6106
6107 =item gcc -Wall
6108
6109 =back
6110
6111 =item New Tests
6112
6113 =item Known Problems
6114
6115 =over 4
6116
6117 =item AIX
6118
6119 =item Amiga Perl Invoking Mystery
6120
6121 =item lib/ftmp-security tests warn 'system possibly insecure'
6122
6123 =item Cygwin intermittent failures of lib/Memoize/t/expire_file 11 and 12
6124
6125 =item HP-UX lib/io_multihomed Fails When LP64-Configured
6126
6127 =item  HP-UX lib/posix Subtest 9 Fails When LP64-Configured
6128
6129 =item Linux With Sfio Fails op/misc Test 48
6130
6131 =item OS/390
6132
6133 =item op/sprintf tests 129 and 130
6134
6135 =item  Failure of Thread tests
6136
6137 =item UNICOS
6138
6139 =item UTS
6140
6141 =item VMS
6142
6143 =item Win32
6144
6145 =item Localising a Tied Variable Leaks Memory
6146
6147 =item Self-tying of Arrays and Hashes Is Forbidden
6148
6149 =item Variable Attributes are not Currently Usable for Tieing
6150
6151 =item Building Extensions Can Fail Because Of Largefiles
6152
6153 =item The Compiler Suite Is Still Experimental
6154
6155 =item The Long Double Support is Still Experimental
6156
6157 =back
6158
6159 =item Reporting Bugs
6160
6161 =item SEE ALSO
6162
6163 =item HISTORY
6164
6165 =back
6166
6167 =head2 perl571delta - what's new for perl v5.7.1
6168
6169 =over 4
6170
6171 =item DESCRIPTION
6172
6173 =item Security Vulnerability Closed
6174
6175 =item Incompatible Changes
6176
6177 =item Core Enhancements
6178
6179 =over 4
6180
6181 =item AUTOLOAD Is Now Lvaluable
6182
6183 =item PerlIO is Now The Default
6184
6185 =item Signals Are Now Safe
6186
6187 =back
6188
6189 =item Modules and Pragmata
6190
6191 =over 4
6192
6193 =item New Modules
6194
6195 =item Updated And Improved Modules and Pragmata
6196
6197 =back
6198
6199 =item Performance Enhancements
6200
6201 =item Utility Changes
6202
6203 =item New Documentation
6204
6205 =over 4
6206
6207 =item perlclib
6208
6209 =item perliol
6210
6211 =item README.aix
6212
6213 =item README.bs2000
6214
6215 =item README.macos
6216
6217 =item README.mpeix
6218
6219 =item README.solaris
6220
6221 =item README.vos
6222
6223 =item Porting/repository.pod
6224
6225 =back
6226
6227 =item Installation and Configuration Improvements
6228
6229 =over 4
6230
6231 =item New Or Improved Platforms
6232
6233 =item Generic Improvements
6234
6235 d_cmsghdr, d_fcntl_can_lock, d_fsync, d_getitimer, d_getpagsz, d_msghdr_s,
6236 need_va_copy, d_readv, d_recvmsg, d_sendmsg, sig_size, d_sockatmark,
6237 d_strtoq, d_u32align, d_ualarm, d_usleep
6238
6239 =back
6240
6241 =item Selected Bug Fixes
6242
6243 =over 4
6244
6245 =item Platform Specific Changes and Fixes
6246
6247 =back
6248
6249 =item New or Changed Diagnostics
6250
6251 =item Changed Internals
6252
6253 =item New Tests
6254
6255 =item Known Problems
6256
6257 =over 4
6258
6259 =item AIX vac 5.0.0.0 May Produce Buggy Code For Perl
6260
6261 =item lib/ftmp-security tests warn 'system possibly insecure'
6262
6263 =item lib/io_multihomed Fails In LP64-Configured HP-UX
6264
6265 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
6266
6267 =item lib/b test 19
6268
6269 =item Linux With Sfio Fails op/misc Test 48
6270
6271 =item sigaction test 13 in VMS
6272
6273 =item sprintf tests 129 and 130
6274
6275 =item  Failure of Thread tests
6276
6277 =item Localising a Tied Variable Leaks Memory
6278
6279 =item Self-tying of Arrays and Hashes Is Forbidden
6280
6281 =item Building Extensions Can Fail Because Of Largefiles
6282
6283 =item The Compiler Suite Is Still Experimental
6284
6285 =back
6286
6287 =item Reporting Bugs
6288
6289 =item SEE ALSO
6290
6291 =item HISTORY
6292
6293 =back
6294
6295 =head2 perl570delta - what's new for perl v5.7.0
6296
6297 =over 4
6298
6299 =item DESCRIPTION
6300
6301 =item Security Vulnerability Closed
6302
6303 =item Incompatible Changes
6304
6305 =item Core Enhancements
6306
6307 =item Modules and Pragmata
6308
6309 =over 4
6310
6311 =item New Modules
6312
6313 =item Updated And Improved Modules and Pragmata
6314
6315 =back
6316
6317 =item Utility Changes
6318
6319 =item New Documentation
6320
6321 =item Performance Enhancements
6322
6323 =item Installation and Configuration Improvements
6324
6325 =over 4
6326
6327 =item Generic Improvements
6328
6329 =back
6330
6331 =item Selected Bug Fixes
6332
6333 =over 4
6334
6335 =item Platform Specific Changes and Fixes
6336
6337 =back
6338
6339 =item New or Changed Diagnostics
6340
6341 =item Changed Internals
6342
6343 =item Known Problems
6344
6345 =over 4
6346
6347 =item Unicode Support Still Far From Perfect
6348
6349 =item EBCDIC Still A Lost Platform
6350
6351 =item Building Extensions Can Fail Because Of Largefiles
6352
6353 =item ftmp-security tests warn 'system possibly insecure'
6354
6355 =item Test lib/posix Subtest 9 Fails In LP64-Configured HP-UX
6356
6357 =item Long Doubles Still Don't Work In Solaris
6358
6359 =item Linux With Sfio Fails op/misc Test 48
6360
6361 =item Storable tests fail in some platforms
6362
6363 =item Threads Are Still Experimental
6364
6365 =item The Compiler Suite Is Still Experimental
6366
6367 =back
6368
6369 =item Reporting Bugs
6370
6371 =item SEE ALSO
6372
6373 =item HISTORY
6374
6375 =back
6376
6377 =head2 perl561delta - what's new for perl v5.6.x
6378
6379 =over 4
6380
6381 =item DESCRIPTION
6382
6383 =item Summary of changes between 5.6.0 and 5.6.1
6384
6385 =over 4
6386
6387 =item Security Issues
6388
6389 =item Core bug fixes
6390
6391 C<UNIVERSAL::isa()>, Memory leaks, Numeric conversions, qw(a\\b), caller(),
6392 Bugs in regular expressions, "slurp" mode, Autovivification of symbolic
6393 references to special variables, Lexical warnings, Spurious warnings and
6394 errors, glob(), Tainting, sort(), #line directives, Subroutine prototypes,
6395 map(), Debugger, PERL5OPT, chop(), Unicode support, 64-bit support,
6396 Compiler, Lvalue subroutines, IO::Socket, File::Find, xsubpp, C<no
6397 Module;>, Tests
6398
6399 =item Core features
6400
6401 =item Configuration issues
6402
6403 =item Documentation
6404
6405 =item Bundled modules
6406
6407 B::Concise, File::Temp, Pod::LaTeX, Pod::Text::Overstrike, CGI, CPAN,
6408 Class::Struct, DB_File, Devel::Peek, File::Find, Getopt::Long, IO::Poll,
6409 IPC::Open3, Math::BigFloat, Math::Complex, Net::Ping, Opcode, Pod::Parser,
6410 Pod::Text, SDBM_File, Sys::Syslog, Tie::RefHash, Tie::SubstrHash
6411
6412 =item Platform-specific improvements
6413
6414 NCR MP-RAS, NonStop-UX
6415
6416 =back
6417
6418 =item Core Enhancements
6419
6420 =over 4
6421
6422 =item Interpreter cloning, threads, and concurrency
6423
6424 =item Lexically scoped warning categories
6425
6426 =item Unicode and UTF-8 support
6427
6428 =item Support for interpolating named characters
6429
6430 =item "our" declarations
6431
6432 =item Support for strings represented as a vector of ordinals
6433
6434 =item Improved Perl version numbering system
6435
6436 =item New syntax for declaring subroutine attributes
6437
6438 =item File and directory handles can be autovivified
6439
6440 =item open() with more than two arguments
6441
6442 =item 64-bit support
6443
6444 =item Large file support
6445
6446 =item Long doubles
6447
6448 =item "more bits"
6449
6450 =item Enhanced support for sort() subroutines
6451
6452 =item C<sort $coderef @foo> allowed
6453
6454 =item File globbing implemented internally
6455
6456 =item Support for CHECK blocks
6457
6458 =item POSIX character class syntax [: :] supported
6459
6460 =item Better pseudo-random number generator
6461
6462 =item Improved C<qw//> operator
6463
6464 =item Better worst-case behavior of hashes
6465
6466 =item pack() format 'Z' supported
6467
6468 =item pack() format modifier '!' supported
6469
6470 =item pack() and unpack() support counted strings
6471
6472 =item Comments in pack() templates
6473
6474 =item Weak references
6475
6476 =item Binary numbers supported
6477
6478 =item Lvalue subroutines
6479
6480 =item Some arrows may be omitted in calls through references
6481
6482 =item Boolean assignment operators are legal lvalues
6483
6484 =item exists() is supported on subroutine names
6485
6486 =item exists() and delete() are supported on array elements
6487
6488 =item Pseudo-hashes work better
6489
6490 =item Automatic flushing of output buffers
6491
6492 =item Better diagnostics on meaningless filehandle operations
6493
6494 =item Where possible, buffered data discarded from duped input filehandle
6495
6496 =item eof() has the same old magic as <>
6497
6498 =item binmode() can be used to set :crlf and :raw modes
6499
6500 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6501
6502 =item system(), backticks and pipe open now reflect exec() failure
6503
6504 =item Improved diagnostics
6505
6506 =item Diagnostics follow STDERR
6507
6508 =item More consistent close-on-exec behavior
6509
6510 =item syswrite() ease-of-use
6511
6512 =item Better syntax checks on parenthesized unary operators
6513
6514 =item Bit operators support full native integer width
6515
6516 =item Improved security features
6517
6518 =item More functional bareword prototype (*)
6519
6520 =item C<require> and C<do> may be overridden
6521
6522 =item $^X variables may now have names longer than one character
6523
6524 =item New variable $^C reflects C<-c> switch
6525
6526 =item New variable $^V contains Perl version as a string
6527
6528 =item Optional Y2K warnings
6529
6530 =item Arrays now always interpolate into double-quoted strings
6531
6532 =back
6533
6534 =item Modules and Pragmata
6535
6536 =over 4
6537
6538 =item Modules
6539
6540 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6541 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6542 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6543 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6544 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6545 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6546 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6547 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6548
6549 =item Pragmata
6550
6551 =back
6552
6553 =item Utility Changes
6554
6555 =over 4
6556
6557 =item dprofpp
6558
6559 =item find2perl
6560
6561 =item h2xs
6562
6563 =item perlcc
6564
6565 =item perldoc
6566
6567 =item The Perl Debugger
6568
6569 =back
6570
6571 =item Improved Documentation
6572
6573 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6574 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6575 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6576 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6577
6578 =item Performance enhancements
6579
6580 =over 4
6581
6582 =item Simple sort() using { $a <=> $b } and the like are optimized
6583
6584 =item Optimized assignments to lexical variables
6585
6586 =item Faster subroutine calls
6587
6588 =item delete(), each(), values() and hash iteration are faster
6589
6590 =back
6591
6592 =item Installation and Configuration Improvements
6593
6594 =over 4
6595
6596 =item -Dusethreads means something different
6597
6598 =item New Configure flags
6599
6600 =item Threadedness and 64-bitness now more daring
6601
6602 =item Long Doubles
6603
6604 =item -Dusemorebits
6605
6606 =item -Duselargefiles
6607
6608 =item installusrbinperl
6609
6610 =item SOCKS support
6611
6612 =item C<-A> flag
6613
6614 =item Enhanced Installation Directories
6615
6616 =item gcc automatically tried if 'cc' does not seem to be working
6617
6618 =back
6619
6620 =item Platform specific changes
6621
6622 =over 4
6623
6624 =item Supported platforms
6625
6626 =item DOS
6627
6628 =item OS390 (OpenEdition MVS)
6629
6630 =item VMS
6631
6632 =item Win32
6633
6634 =back
6635
6636 =item Significant bug fixes
6637
6638 =over 4
6639
6640 =item <HANDLE> on empty files
6641
6642 =item C<eval '...'> improvements
6643
6644 =item All compilation errors are true errors
6645
6646 =item Implicitly closed filehandles are safer
6647
6648 =item Behavior of list slices is more consistent
6649
6650 =item C<(\$)> prototype and C<$foo{a}>
6651
6652 =item C<goto &sub> and AUTOLOAD
6653
6654 =item C<-bareword> allowed under C<use integer>
6655
6656 =item Failures in DESTROY()
6657
6658 =item Locale bugs fixed
6659
6660 =item Memory leaks
6661
6662 =item Spurious subroutine stubs after failed subroutine calls
6663
6664 =item Taint failures under C<-U>
6665
6666 =item END blocks and the C<-c> switch
6667
6668 =item Potential to leak DATA filehandles
6669
6670 =back
6671
6672 =item New or Changed Diagnostics
6673
6674 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
6675 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
6676 / cannot take a count, / must be followed by a, A or Z, / must be followed
6677 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
6678 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
6679 passed through, /%s/ should probably be written as "%s", %s() called too
6680 early to check prototype, %s argument is not a HASH or ARRAY element, %s
6681 argument is not a HASH or ARRAY element or slice, %s argument is not a
6682 subroutine name, %s package attribute may clash with future reserved word:
6683 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
6684 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
6685 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
6686 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
6687 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
6688 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
6689 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
6690 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
6691 weaken a nonreference, Character class [:%s:] unknown, Character class
6692 syntax [%s] belongs inside character classes, Constant is not %s reference,
6693 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
6694 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
6695 "local" instead of "our"?), Document contains no data, entering effective
6696 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
6697 output, flock() on closed filehandle %s, Global symbol "%s" requires
6698 explicit package name, Hexadecimal number > 0xffffffff non-portable,
6699 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
6700 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
6701 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
6702 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
6703 separator character %s in attribute list, Invalid separator character %s in
6704 subroutine attribute list, leaving effective %s failed, Lvalue subs
6705 returning %s not implemented yet, Method %s not permitted, Missing
6706 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
6707 No %s specified for -%c, No package name allowed for variable %s in "our",
6708 No space allowed after -%c, no UTC offset information; assuming local time
6709 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
6710 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
6711 around "%s" list, Possible unintended interpolation of %s in string,
6712 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
6713 instead, Premature end of script headers, Repeat count in pack overflows,
6714 Repeat count in unpack overflows, realloc() of freed memory ignored,
6715 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
6716 zero-length expression, switching effective %s is not implemented, This
6717 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
6718 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
6719 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
6720 escape \\%c passed through, Unterminated attribute parameter in attribute
6721 list, Unterminated attribute list, Unterminated attribute parameter in
6722 subroutine attribute list, Unterminated subroutine attribute list, Value of
6723 CLI symbol "%s" too long, Version number must be a constant number
6724
6725 =item New tests
6726
6727 =item Incompatible Changes
6728
6729 =over 4
6730
6731 =item Perl Source Incompatibilities
6732
6733 CHECK is a new keyword, Treatment of list slices of undef has changed,
6734 Format of $English::PERL_VERSION is different, Literals of the form
6735 C<1.2.3> parse differently, Possibly changed pseudo-random number
6736 generator, Hashing function for hash keys has changed, C<undef> fails on
6737 read only values, Close-on-exec bit may be set on pipe and socket handles,
6738 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
6739 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
6740 Text of some diagnostic output has changed, C<%@> has been removed,
6741 Parenthesized not() behaves like a list operator, Semantics of bareword
6742 prototype C<(*)> have changed, Semantics of bit operators may have changed
6743 on 64-bit platforms, More builtins taint their results
6744
6745 =item C Source Incompatibilities
6746
6747 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
6748
6749 =item Compatible C Source API Changes
6750
6751 C<PATCHLEVEL> is now C<PERL_VERSION>
6752
6753 =item Binary Incompatibilities
6754
6755 =back
6756
6757 =item Known Problems
6758
6759 =over 4
6760
6761 =item Localizing a tied hash element may leak memory
6762
6763 =item Known test failures
6764
6765 =item EBCDIC platforms not fully supported
6766
6767 =item UNICOS/mk CC failures during Configure run
6768
6769 =item Arrow operator and arrays
6770
6771 =item Experimental features
6772
6773 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
6774 pseudo-hash data type, The Compiler suite, Internal implementation of file
6775 globbing, The DB module, The regular expression code constructs:
6776
6777 =back
6778
6779 =item Obsolete Diagnostics
6780
6781 Character class syntax [: :] is reserved for future extensions, Ill-formed
6782 logical name |%s| in prime_env_iter, In string, @%s now must be written as
6783 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
6784 to mean "${$}<digit>" is deprecated
6785
6786 =item Reporting Bugs
6787
6788 =item SEE ALSO
6789
6790 =item HISTORY
6791
6792 =back
6793
6794 =head2 perl56delta - what's new for perl v5.6.0
6795
6796 =over 4
6797
6798 =item DESCRIPTION
6799
6800 =item Core Enhancements
6801
6802 =over 4
6803
6804 =item Interpreter cloning, threads, and concurrency
6805
6806 =item Lexically scoped warning categories
6807
6808 =item Unicode and UTF-8 support
6809
6810 =item Support for interpolating named characters
6811
6812 =item "our" declarations
6813
6814 =item Support for strings represented as a vector of ordinals
6815
6816 =item Improved Perl version numbering system
6817
6818 =item New syntax for declaring subroutine attributes
6819
6820 =item File and directory handles can be autovivified
6821
6822 =item open() with more than two arguments
6823
6824 =item 64-bit support
6825
6826 =item Large file support
6827
6828 =item Long doubles
6829
6830 =item "more bits"
6831
6832 =item Enhanced support for sort() subroutines
6833
6834 =item C<sort $coderef @foo> allowed
6835
6836 =item File globbing implemented internally
6837
6838 =item Support for CHECK blocks
6839
6840 =item POSIX character class syntax [: :] supported
6841
6842 =item Better pseudo-random number generator
6843
6844 =item Improved C<qw//> operator
6845
6846 =item Better worst-case behavior of hashes
6847
6848 =item pack() format 'Z' supported
6849
6850 =item pack() format modifier '!' supported
6851
6852 =item pack() and unpack() support counted strings
6853
6854 =item Comments in pack() templates
6855
6856 =item Weak references
6857
6858 =item Binary numbers supported
6859
6860 =item Lvalue subroutines
6861
6862 =item Some arrows may be omitted in calls through references
6863
6864 =item Boolean assignment operators are legal lvalues
6865
6866 =item exists() is supported on subroutine names
6867
6868 =item exists() and delete() are supported on array elements
6869
6870 =item Pseudo-hashes work better
6871
6872 =item Automatic flushing of output buffers
6873
6874 =item Better diagnostics on meaningless filehandle operations
6875
6876 =item Where possible, buffered data discarded from duped input filehandle
6877
6878 =item eof() has the same old magic as <>
6879
6880 =item binmode() can be used to set :crlf and :raw modes
6881
6882 =item C<-T> filetest recognizes UTF-8 encoded files as "text"
6883
6884 =item system(), backticks and pipe open now reflect exec() failure
6885
6886 =item Improved diagnostics
6887
6888 =item Diagnostics follow STDERR
6889
6890 =item More consistent close-on-exec behavior
6891
6892 =item syswrite() ease-of-use
6893
6894 =item Better syntax checks on parenthesized unary operators
6895
6896 =item Bit operators support full native integer width
6897
6898 =item Improved security features
6899
6900 =item More functional bareword prototype (*)
6901
6902 =item C<require> and C<do> may be overridden
6903
6904 =item $^X variables may now have names longer than one character
6905
6906 =item New variable $^C reflects C<-c> switch
6907
6908 =item New variable $^V contains Perl version as a string
6909
6910 =item Optional Y2K warnings
6911
6912 =item Arrays now always interpolate into double-quoted strings
6913
6914 =back
6915
6916 =item Modules and Pragmata
6917
6918 =over 4
6919
6920 =item Modules
6921
6922 attributes, B, Benchmark, ByteLoader, constant, charnames, Data::Dumper,
6923 DB, DB_File, Devel::DProf, Devel::Peek, Dumpvalue, DynaLoader, English,
6924 Env, Fcntl, File::Compare, File::Find, File::Glob, File::Spec,
6925 File::Spec::Functions, Getopt::Long, IO, JPL, lib, Math::BigInt,
6926 Math::Complex, Math::Trig, Pod::Parser, Pod::InputObjects, Pod::Checker,
6927 podchecker, Pod::ParseUtils, Pod::Find, Pod::Select, podselect, Pod::Usage,
6928 pod2usage, Pod::Text and Pod::Man, SDBM_File, Sys::Syslog, Sys::Hostname,
6929 Term::ANSIColor, Time::Local, Win32, XSLoader, DBM Filters
6930
6931 =item Pragmata
6932
6933 =back
6934
6935 =item Utility Changes
6936
6937 =over 4
6938
6939 =item dprofpp
6940
6941 =item find2perl
6942
6943 =item h2xs
6944
6945 =item perlcc
6946
6947 =item perldoc
6948
6949 =item The Perl Debugger
6950
6951 =back
6952
6953 =item Improved Documentation
6954
6955 perlapi.pod, perlboot.pod, perlcompile.pod, perldbmfilter.pod,
6956 perldebug.pod, perldebguts.pod, perlfork.pod, perlfilter.pod, perlhack.pod,
6957 perlintern.pod, perllexwarn.pod, perlnumber.pod, perlopentut.pod,
6958 perlreftut.pod, perltootc.pod, perltodo.pod, perlunicode.pod
6959
6960 =item Performance enhancements
6961
6962 =over 4
6963
6964 =item Simple sort() using { $a <=> $b } and the like are optimized
6965
6966 =item Optimized assignments to lexical variables
6967
6968 =item Faster subroutine calls
6969
6970 =item delete(), each(), values() and hash iteration are faster
6971
6972 =back
6973
6974 =item Installation and Configuration Improvements
6975
6976 =over 4
6977
6978 =item -Dusethreads means something different
6979
6980 =item New Configure flags
6981
6982 =item Threadedness and 64-bitness now more daring
6983
6984 =item Long Doubles
6985
6986 =item -Dusemorebits
6987
6988 =item -Duselargefiles
6989
6990 =item installusrbinperl
6991
6992 =item SOCKS support
6993
6994 =item C<-A> flag
6995
6996 =item Enhanced Installation Directories
6997
6998 =back
6999
7000 =item Platform specific changes
7001
7002 =over 4
7003
7004 =item Supported platforms
7005
7006 =item DOS
7007
7008 =item OS390 (OpenEdition MVS)
7009
7010 =item VMS
7011
7012 =item Win32
7013
7014 =back
7015
7016 =item Significant bug fixes
7017
7018 =over 4
7019
7020 =item <HANDLE> on empty files
7021
7022 =item C<eval '...'> improvements
7023
7024 =item All compilation errors are true errors
7025
7026 =item Implicitly closed filehandles are safer
7027
7028 =item Behavior of list slices is more consistent
7029
7030 =item C<(\$)> prototype and C<$foo{a}>
7031
7032 =item C<goto &sub> and AUTOLOAD
7033
7034 =item C<-bareword> allowed under C<use integer>
7035
7036 =item Failures in DESTROY()
7037
7038 =item Locale bugs fixed
7039
7040 =item Memory leaks
7041
7042 =item Spurious subroutine stubs after failed subroutine calls
7043
7044 =item Taint failures under C<-U>
7045
7046 =item END blocks and the C<-c> switch
7047
7048 =item Potential to leak DATA filehandles
7049
7050 =back
7051
7052 =item New or Changed Diagnostics
7053
7054 "%s" variable %s masks earlier declaration in same %s, "my sub" not yet
7055 implemented, "our" variable %s redeclared, '!' allowed only after types %s,
7056 / cannot take a count, / must be followed by a, A or Z, / must be followed
7057 by a*, A* or Z*, / must follow a numeric type, /%s/: Unrecognized escape
7058 \\%c passed through, /%s/: Unrecognized escape \\%c in character class
7059 passed through, /%s/ should probably be written as "%s", %s() called too
7060 early to check prototype, %s argument is not a HASH or ARRAY element, %s
7061 argument is not a HASH or ARRAY element or slice, %s argument is not a
7062 subroutine name, %s package attribute may clash with future reserved word:
7063 %s, (in cleanup) %s, <> should be quotes, Attempt to join self, Bad evalled
7064 substitution pattern, Bad realloc() ignored, Bareword found in conditional,
7065 Binary number > 0b11111111111111111111111111111111 non-portable, Bit vector
7066 size > 32 non-portable, Buffer overflow in prime_env_iter: %s, Can't check
7067 filesystem of script "%s", Can't declare class for non-scalar %s in "%s",
7068 Can't declare %s in "%s", Can't ignore signal CHLD, forcing to default,
7069 Can't modify non-lvalue subroutine call, Can't read CRTL environ, Can't
7070 remove %s: %s, skipping file, Can't return %s from lvalue subroutine, Can't
7071 weaken a nonreference, Character class [:%s:] unknown, Character class
7072 syntax [%s] belongs inside character classes, Constant is not %s reference,
7073 constant(%s): %s, CORE::%s is not a keyword, defined(@array) is deprecated,
7074 defined(%hash) is deprecated, Did not produce a valid header, (Did you mean
7075 "local" instead of "our"?), Document contains no data, entering effective
7076 %s failed, false [] range "%s" in regexp, Filehandle %s opened only for
7077 output, flock() on closed filehandle %s, Global symbol "%s" requires
7078 explicit package name, Hexadecimal number > 0xffffffff non-portable,
7079 Ill-formed CRTL environ value "%s", Ill-formed message in prime_env_iter:
7080 |%s|, Illegal binary digit %s, Illegal binary digit %s ignored, Illegal
7081 number of bits in vec, Integer overflow in %s number, Invalid %s attribute:
7082 %s, Invalid %s attributes: %s, invalid [] range "%s" in regexp, Invalid
7083 separator character %s in attribute list, Invalid separator character %s in
7084 subroutine attribute list, leaving effective %s failed, Lvalue subs
7085 returning %s not implemented yet, Method %s not permitted, Missing
7086 %sbrace%s on \N{}, Missing command in piped open, Missing name in "my sub",
7087 No %s specified for -%c, No package name allowed for variable %s in "our",
7088 No space allowed after -%c, no UTC offset information; assuming local time
7089 is UTC, Octal number > 037777777777 non-portable, panic: del_backref,
7090 panic: kid popen errno read, panic: magic_killbackrefs, Parentheses missing
7091 around "%s" list, Possible unintended interpolation of %s in string,
7092 Possible Y2K bug: %s, pragma "attrs" is deprecated, use "sub NAME : ATTRS"
7093 instead, Premature end of script headers, Repeat count in pack overflows,
7094 Repeat count in unpack overflows, realloc() of freed memory ignored,
7095 Reference is already weak, setpgrp can't take arguments, Strange *+?{} on
7096 zero-length expression, switching effective %s is not implemented, This
7097 Perl can't reset CRTL environ elements (%s), This Perl can't set CRTL
7098 environ elements (%s=%s), Too late to run %s block, Unknown open() mode
7099 '%s', Unknown process %x sent message to prime_env_iter: %s, Unrecognized
7100 escape \\%c passed through, Unterminated attribute parameter in attribute
7101 list, Unterminated attribute list, Unterminated attribute parameter in
7102 subroutine attribute list, Unterminated subroutine attribute list, Value of
7103 CLI symbol "%s" too long, Version number must be a constant number
7104
7105 =item New tests
7106
7107 =item Incompatible Changes
7108
7109 =over 4
7110
7111 =item Perl Source Incompatibilities
7112
7113 CHECK is a new keyword, Treatment of list slices of undef has changed,
7114 Format of $English::PERL_VERSION is different, Literals of the form
7115 C<1.2.3> parse differently, Possibly changed pseudo-random number
7116 generator, Hashing function for hash keys has changed, C<undef> fails on
7117 read only values, Close-on-exec bit may be set on pipe and socket handles,
7118 Writing C<"$$1"> to mean C<"${$}1"> is unsupported, delete(), each(),
7119 values() and C<\(%h)>, vec(EXPR,OFFSET,BITS) enforces powers-of-two BITS,
7120 Text of some diagnostic output has changed, C<%@> has been removed,
7121 Parenthesized not() behaves like a list operator, Semantics of bareword
7122 prototype C<(*)> have changed, Semantics of bit operators may have changed
7123 on 64-bit platforms, More builtins taint their results
7124
7125 =item C Source Incompatibilities
7126
7127 C<PERL_POLLUTE>, C<PERL_IMPLICIT_CONTEXT>, C<PERL_POLLUTE_MALLOC>
7128
7129 =item Compatible C Source API Changes
7130
7131 C<PATCHLEVEL> is now C<PERL_VERSION>
7132
7133 =item Binary Incompatibilities
7134
7135 =back
7136
7137 =item Known Problems
7138
7139 =over 4
7140
7141 =item Thread test failures
7142
7143 =item EBCDIC platforms not supported
7144
7145 =item In 64-bit HP-UX the lib/io_multihomed test may hang
7146
7147 =item NEXTSTEP 3.3 POSIX test failure
7148
7149 =item Tru64 (aka Digital UNIX, aka DEC OSF/1) lib/sdbm test failure with
7150 gcc
7151
7152 =item UNICOS/mk CC failures during Configure run
7153
7154 =item Arrow operator and arrays
7155
7156 =item Experimental features
7157
7158 Threads, Unicode, 64-bit support, Lvalue subroutines, Weak references, The
7159 pseudo-hash data type, The Compiler suite, Internal implementation of file
7160 globbing, The DB module, The regular expression code constructs:
7161
7162 =back
7163
7164 =item Obsolete Diagnostics
7165
7166 Character class syntax [: :] is reserved for future extensions, Ill-formed
7167 logical name |%s| in prime_env_iter, In string, @%s now must be written as
7168 \@%s, Probable precedence problem on %s, regexp too big, Use of "$$<digit>"
7169 to mean "${$}<digit>" is deprecated
7170
7171 =item Reporting Bugs
7172
7173 =item SEE ALSO
7174
7175 =item HISTORY
7176
7177 =back
7178
7179 =head2 perl5005delta - what's new for perl5.005
7180
7181 =over 4
7182
7183 =item DESCRIPTION
7184
7185 =item About the new versioning system
7186
7187 =item Incompatible Changes
7188
7189 =over 4
7190
7191 =item WARNING:  This version is not binary compatible with Perl 5.004.
7192
7193 =item Default installation structure has changed
7194
7195 =item Perl Source Compatibility
7196
7197 =item C Source Compatibility
7198
7199 =item Binary Compatibility
7200
7201 =item Security fixes may affect compatibility
7202
7203 =item Relaxed new mandatory warnings introduced in 5.004
7204
7205 =item Licensing
7206
7207 =back
7208
7209 =item Core Changes
7210
7211 =over 4
7212
7213 =item Threads
7214
7215 =item Compiler
7216
7217 =item Regular Expressions
7218
7219 Many new and improved optimizations, Many bug fixes, New regular expression
7220 constructs, New operator for precompiled regular expressions, Other
7221 improvements, Incompatible changes
7222
7223 =item   Improved malloc()
7224
7225 =item Quicksort is internally implemented
7226
7227 =item Reliable signals
7228
7229 =item Reliable stack pointers
7230
7231 =item More generous treatment of carriage returns
7232
7233 =item Memory leaks
7234
7235 =item Better support for multiple interpreters
7236
7237 =item Behavior of local() on array and hash elements is now well-defined
7238
7239 =item C<%!> is transparently tied to the L<Errno> module
7240
7241 =item Pseudo-hashes are supported
7242
7243 =item C<EXPR foreach EXPR> is supported
7244
7245 =item Keywords can be globally overridden
7246
7247 =item C<$^E> is meaningful on Win32
7248
7249 =item C<foreach (1..1000000)> optimized
7250
7251 =item C<Foo::> can be used as implicitly quoted package name
7252
7253 =item C<exists $Foo::{Bar::}> tests existence of a package
7254
7255 =item Better locale support
7256
7257 =item Experimental support for 64-bit platforms
7258
7259 =item prototype() returns useful results on builtins
7260
7261 =item Extended support for exception handling
7262
7263 =item Re-blessing in DESTROY() supported for chaining DESTROY() methods
7264
7265 =item All C<printf> format conversions are handled internally
7266
7267 =item New C<INIT> keyword
7268
7269 =item New C<lock> keyword
7270
7271 =item New C<qr//> operator
7272
7273 =item C<our> is now a reserved word
7274
7275 =item Tied arrays are now fully supported
7276
7277 =item Tied handles support is better
7278
7279 =item 4th argument to substr
7280
7281 =item Negative LENGTH argument to splice
7282
7283 =item Magic lvalues are now more magical
7284
7285 =item <> now reads in records
7286
7287 =back
7288
7289 =item Supported Platforms
7290
7291 =over 4
7292
7293 =item New Platforms
7294
7295 =item Changes in existing support
7296
7297 =back
7298
7299 =item Modules and Pragmata
7300
7301 =over 4
7302
7303 =item New Modules
7304
7305 B, Data::Dumper, Dumpvalue, Errno, File::Spec, ExtUtils::Installed,
7306 ExtUtils::Packlist, Fatal, IPC::SysV, Test, Tie::Array, Tie::Handle,
7307 Thread, attrs, fields, re
7308
7309 =item Changes in existing modules
7310
7311 Benchmark, Carp, CGI, Fcntl, Math::Complex, Math::Trig, POSIX, DB_File,
7312 MakeMaker, CPAN, Cwd
7313
7314 =back
7315
7316 =item Utility Changes
7317
7318 =item Documentation Changes
7319
7320 =item New Diagnostics
7321
7322 Ambiguous call resolved as CORE::%s(), qualify as such or use &, Bad index
7323 while coercing array into hash, Bareword "%s" refers to nonexistent
7324 package, Can't call method "%s" on an undefined value, Can't check
7325 filesystem of script "%s" for nosuid, Can't coerce array into hash, Can't
7326 goto subroutine from an eval-string, Can't localize pseudo-hash element,
7327 Can't use %%! because Errno.pm is not available, Cannot find an opnumber
7328 for "%s", Character class syntax [. .] is reserved for future extensions,
7329 Character class syntax [: :] is reserved for future extensions, Character
7330 class syntax [= =] is reserved for future extensions, %s: Eval-group in
7331 insecure regular expression, %s: Eval-group not allowed, use re 'eval', %s:
7332 Eval-group not allowed at run time, Explicit blessing to '' (assuming
7333 package main), Illegal hex digit ignored, No such array field, No such
7334 field "%s" in variable %s of type %s, Out of memory during ridiculously
7335 large request, Range iterator outside integer range, Recursive inheritance
7336 detected while looking for method '%s' %s, Reference found where even-sized
7337 list expected, Undefined value assigned to typeglob, Use of reserved word
7338 "%s" is deprecated, perl: warning: Setting locale failed
7339
7340 =item Obsolete Diagnostics
7341
7342 Can't mktemp(), Can't write to temp file for B<-e>: %s, Cannot open
7343 temporary file, regexp too big
7344
7345 =item Configuration Changes
7346
7347 =item BUGS
7348
7349 =item SEE ALSO
7350
7351 =item HISTORY
7352
7353 =back
7354
7355 =head2 perl5004delta - what's new for perl5.004
7356
7357 =over 4
7358
7359 =item DESCRIPTION
7360
7361 =item Supported Environments
7362
7363 =item Core Changes
7364
7365 =over 4
7366
7367 =item List assignment to %ENV works
7368
7369 =item Change to "Can't locate Foo.pm in @INC" error
7370
7371 =item Compilation option: Binary compatibility with 5.003
7372
7373 =item $PERL5OPT environment variable
7374
7375 =item Limitations on B<-M>, B<-m>, and B<-T> options
7376
7377 =item More precise warnings
7378
7379 =item Deprecated: Inherited C<AUTOLOAD> for non-methods
7380
7381 =item Previously deprecated %OVERLOAD is no longer usable
7382
7383 =item Subroutine arguments created only when they're modified
7384
7385 =item Group vector changeable with C<$)>
7386
7387 =item Fixed parsing of $$<digit>, &$<digit>, etc.
7388
7389 =item Fixed localization of $<digit>, $&, etc.
7390
7391 =item No resetting of $. on implicit close
7392
7393 =item C<wantarray> may return undef
7394
7395 =item C<eval EXPR> determines value of EXPR in scalar context
7396
7397 =item Changes to tainting checks
7398
7399 No glob() or <*>, No spawning if tainted $CDPATH, $ENV, $BASH_ENV, No
7400 spawning if tainted $TERM doesn't look like a terminal name
7401
7402 =item New Opcode module and revised Safe module
7403
7404 =item Embedding improvements
7405
7406 =item Internal change: FileHandle class based on IO::* classes
7407
7408 =item Internal change: PerlIO abstraction interface
7409
7410 =item New and changed syntax
7411
7412 $coderef->(PARAMS)
7413
7414 =item New and changed builtin constants
7415
7416 __PACKAGE__
7417
7418 =item New and changed builtin variables
7419
7420 $^E, $^H, $^M
7421
7422 =item New and changed builtin functions
7423
7424 delete on slices, flock, printf and sprintf, keys as an lvalue, my() in
7425 Control Structures, pack() and unpack(), sysseek(), use VERSION, use Module
7426 VERSION LIST, prototype(FUNCTION), srand, $_ as Default, C<m//gc> does not
7427 reset search position on failure, C<m//x> ignores whitespace before ?*+{},
7428 nested C<sub{}> closures work now, formats work right on changing lexicals
7429
7430 =item New builtin methods
7431
7432 isa(CLASS), can(METHOD), VERSION( [NEED] )
7433
7434 =item TIEHANDLE now supported
7435
7436 TIEHANDLE classname, LIST, PRINT this, LIST, PRINTF this, LIST, READ this
7437 LIST, READLINE this, GETC this, DESTROY this
7438
7439 =item Malloc enhancements
7440
7441 -DPERL_EMERGENCY_SBRK, -DPACK_MALLOC, -DTWO_POT_OPTIMIZE
7442
7443 =item Miscellaneous efficiency enhancements
7444
7445 =back
7446
7447 =item Support for More Operating Systems
7448
7449 =over 4
7450
7451 =item Win32
7452
7453 =item Plan 9
7454
7455 =item QNX
7456
7457 =item AmigaOS
7458
7459 =back
7460
7461 =item Pragmata
7462
7463 use autouse MODULE => qw(sub1 sub2 sub3), use blib, use blib 'dir', use
7464 constant NAME => VALUE, use locale, use ops, use vmsish
7465
7466 =item Modules
7467
7468 =over 4
7469
7470 =item Required Updates
7471
7472 =item Installation directories
7473
7474 =item Module information summary
7475
7476 =item Fcntl
7477
7478 =item IO
7479
7480 =item Math::Complex
7481
7482 =item Math::Trig
7483
7484 =item DB_File
7485
7486 =item Net::Ping
7487
7488 =item Object-oriented overrides for builtin operators
7489
7490 =back
7491
7492 =item Utility Changes
7493
7494 =over 4
7495
7496 =item pod2html
7497
7498 Sends converted HTML to standard output
7499
7500 =item xsubpp
7501
7502 C<void> XSUBs now default to returning nothing
7503
7504 =back
7505
7506 =item C Language API Changes
7507
7508 C<gv_fetchmethod> and C<perl_call_sv>, C<perl_eval_pv>, Extended API for
7509 manipulating hashes
7510
7511 =item Documentation Changes
7512
7513 L<perldelta>, L<perlfaq>, L<perllocale>, L<perltoot>, L<perlapio>,
7514 L<perlmodlib>, L<perldebug>, L<perlsec>
7515
7516 =item New Diagnostics
7517
7518 "my" variable %s masks earlier declaration in same scope, %s argument is
7519 not a HASH element or slice, Allocation too large: %lx, Allocation too
7520 large, Applying %s to %s will act on scalar(%s), Attempt to free
7521 nonexistent shared string, Attempt to use reference as lvalue in substr,
7522 Bareword "%s" refers to nonexistent package, Can't redefine active sort
7523 subroutine %s, Can't use bareword ("%s") as %s ref while "strict refs" in
7524 use, Cannot resolve method `%s' overloading `%s' in package `%s', Constant
7525 subroutine %s redefined, Constant subroutine %s undefined, Copy method did
7526 not return a reference, Died, Exiting pseudo-block via %s, Identifier too
7527 long, Illegal character %s (carriage return), Illegal switch in PERL5OPT:
7528 %s, Integer overflow in hex number, Integer overflow in octal number,
7529 internal error: glob failed, Invalid conversion in %s: "%s", Invalid type
7530 in pack: '%s', Invalid type in unpack: '%s', Name "%s::%s" used only once:
7531 possible typo, Null picture in formline, Offset outside string, Out of
7532 memory!, Out of memory during request for %s, panic: frexp, Possible
7533 attempt to put comments in qw() list, Possible attempt to separate words
7534 with commas, Scalar value @%s{%s} better written as $%s{%s}, Stub found
7535 while resolving method `%s' overloading `%s' in %s, Too late for "B<-T>"
7536 option, untie attempted while %d inner references still exist, Unrecognized
7537 character %s, Unsupported function fork, Use of "$$<digit>" to mean
7538 "${$}<digit>" is deprecated, Value of %s can be "0"; test with defined(),
7539 Variable "%s" may be unavailable, Variable "%s" will not stay shared,
7540 Warning: something's wrong, Ill-formed logical name |%s| in prime_env_iter,
7541 Got an error from DosAllocMem, Malformed PERLLIB_PREFIX, PERL_SH_DIR too
7542 long, Process terminated by SIG%s
7543
7544 =item BUGS
7545
7546 =item SEE ALSO
7547
7548 =item HISTORY
7549
7550 =back
7551
7552 =head2 perlartistic - the Perl Artistic License
7553
7554 =over 4
7555
7556 =item SYNOPSIS
7557
7558 =item DESCRIPTION
7559
7560 =item The "Artistic License"
7561
7562 =over 4
7563
7564 =item Preamble
7565
7566 =item Definitions
7567
7568 "Package", "Standard Version", "Copyright Holder", "You", "Reasonable
7569 copying fee", "Freely Available"
7570
7571 =item Conditions
7572
7573 a), b), c), d), a), b), c), d)
7574
7575 =back
7576
7577 =back
7578
7579 =head2 perlgpl - the GNU General Public License, version 2
7580
7581 =over 4
7582
7583 =item SYNOPSIS
7584
7585 =back
7586
7587 =over 4
7588
7589 =item DESCRIPTION
7590
7591 =item GNU GENERAL PUBLIC LICENSE
7592
7593 =back
7594
7595 =head2 perlaix, README.aix - Perl version 5 on IBM Unix (AIX) systems
7596
7597 =over 4
7598
7599 =item DESCRIPTION
7600
7601 =over 4
7602
7603 =item Compiling Perl 5 on AIX
7604
7605 =item OS level
7606
7607 =item Building Dynamic Extensions on AIX
7608
7609 =item The IBM ANSI C Compiler
7610
7611 =item The usenm option
7612
7613 =item Using GNU's gcc for building perl
7614
7615 =item Using Large Files with Perl
7616
7617 =item Threaded Perl
7618
7619 =item 64-bit Perl
7620
7621 =item AIX 4.2 and extensions using C++ with statics
7622
7623 =back
7624
7625 =item AUTHOR
7626
7627 =item DATE
7628
7629 =back
7630
7631 =head2 perlamiga - Perl under Amiga OS
7632
7633 =over 4
7634
7635 =item NOTE
7636
7637 =item SYNOPSIS
7638
7639 =back
7640
7641 =over 4
7642
7643 =item DESCRIPTION
7644
7645 =over 4
7646
7647 =item Prerequisites for Compiling Perl on AmigaOS
7648
7649 B<Unix emulation for AmigaOS: ixemul.library>, B<Version of Amiga OS>
7650
7651 =item Starting Perl programs under AmigaOS
7652
7653 =item Shortcomings of Perl under AmigaOS
7654
7655 =back
7656
7657 =item INSTALLATION
7658
7659 =item Accessing documentation
7660
7661 =over 4
7662
7663 =item Manpages for Perl on AmigaOS
7664
7665 =item Perl HTML Documentation on AmigaOS
7666
7667 =item Perl GNU Info Files on AmigaOS
7668
7669 =item Perl LaTeX Documentation on AmigaOS
7670
7671 =back
7672
7673 =item BUILDING PERL ON AMIGAOS
7674
7675 =over 4
7676
7677 =item Build Prerequisites for Perl on AmigaOS
7678
7679 =item Getting the Perl Source for AmigaOS
7680
7681 =item Making Perl on AmigaOS
7682
7683 =item Testing Perl on AmigaOS
7684
7685 =item Installing the built Perl on AmigaOS
7686
7687 =back
7688
7689 =item PERL 5.8.0 BROKEN IN AMIGAOS
7690
7691 =item AUTHORS
7692
7693 =item SEE ALSO
7694
7695 =back
7696
7697 =head2 perlapollo, README.apollo - Perl version 5 on Apollo DomainOS
7698
7699 =over 4
7700
7701 =item DESCRIPTION
7702
7703 =item AUTHOR
7704
7705 =back
7706
7707 =head2 perlbeos, README.beos - Perl version 5 on BeOS
7708
7709 =over 4
7710
7711 =item DESCRIPTION
7712
7713 =over 4
7714
7715 =item General Issues with Perl on BeOS
7716
7717 =item BeOS Release-specific Notes
7718
7719 R4 x86, R4 PPC
7720
7721 =item Contact Information
7722
7723 =item Update 2002-05-30
7724
7725 =back
7726
7727 =back
7728
7729 =head2 perlbs2000, README.BS2000 - building and installing Perl for BS2000.
7730
7731 =over 4
7732
7733 =item SYNOPSIS
7734
7735 =item DESCRIPTION
7736
7737 =over 4
7738
7739 =item gzip on BS2000
7740
7741 =item bison on BS2000
7742
7743 =item Unpacking Perl Distribution on BS2000
7744
7745 =item Compiling Perl on BS2000
7746
7747 =item Testing Perl on BS2000
7748
7749 =item Installing Perl on BS2000
7750
7751 =item Using Perl in the Posix-Shell of BS2000
7752
7753 =item Using Perl in "native" BS2000
7754
7755 =item Floating point anomalies on BS2000
7756
7757 =item Using PerlIO and different encodings on ASCII and EBCDIC partitions
7758
7759 =back
7760
7761 =item AUTHORS
7762
7763 =item SEE ALSO
7764
7765 =over 4
7766
7767 =item Mailing list
7768
7769 =back
7770
7771 =item HISTORY
7772
7773 =back
7774
7775 =over 4
7776
7777 =item Name
7778
7779 =item Description
7780
7781 =item Build
7782
7783 =over 4
7784
7785 =item Tools & SDK
7786
7787 Microsoft Embedded Visual Tools, Microsoft Visual C++, Rainer Keuchel's
7788 celib-sources, Rainer Keuchel's console-sources
7789
7790 =item Make
7791
7792 go to ./wince subdirectory, edit file compile.bat, run    compile.bat, run 
7793   compile.bat dist
7794
7795 =back
7796
7797 =item Acknowledgements
7798
7799 =item AUTHORS
7800
7801 =back
7802
7803 =head2 perlcygwin, README.cygwin - Perl for Cygwin
7804
7805 =over 4
7806
7807 =item SYNOPSIS
7808
7809 =item PREREQUISITES FOR COMPILING PERL ON CYGWIN
7810
7811 =over 4
7812
7813 =item Cygwin = GNU+Cygnus+Windows (Don't leave UNIX without it)
7814
7815 =item Cygwin Configuration
7816
7817 C<PATH>, I<nroff>, Permissions
7818
7819 =back
7820
7821 =item CONFIGURE PERL ON CYGWIN
7822
7823 =over 4
7824
7825 =item Stripping Perl Binaries on Cygwin
7826
7827 =item Optional Libraries for Perl on Cygwin
7828
7829 C<-lcrypt>, C<-lgdbm> (C<use GDBM_File>), C<-ldb> (C<use DB_File>),
7830 C<-lcygipc> (C<use IPC::SysV>), C<-lutil>
7831
7832 =item Configure-time Options for Perl on Cygwin
7833
7834 C<-Uusedl>, C<-Uusemymalloc>, C<-Uuseperlio>, C<-Dusemultiplicity>,
7835 C<-Duse64bitint>, C<-Duselongdouble>, C<-Dusethreads>, C<-Duselargefiles>,
7836 C<-Dmksymlinks>
7837
7838 =item Suspicious Warnings on Cygwin
7839
7840 I<dlsym()>, Win9x and C<d_eofnblk>, Compiler/Preprocessor defines
7841
7842 =back
7843
7844 =item MAKE ON CYGWIN
7845
7846 =over 4
7847
7848 =item Errors on Cygwin
7849
7850 =item ld2 on Cygwin
7851
7852 =back
7853
7854 =item TEST ON CYGWIN
7855
7856 =over 4
7857
7858 =item File Permissions on Cygwin
7859
7860 =item NDBM_File and ODBM_File do not work on FAT filesystems
7861
7862 =item C<fork()> failures in io_* tests
7863
7864 =item Script Portability on Cygwin
7865
7866 Pathnames, Text/Binary, PerlIO, F<.exe>, C<chown()>, Miscellaneous
7867
7868 =back
7869
7870 =item INSTALL PERL ON CYGWIN
7871
7872 =item MANIFEST ON CYGWIN
7873
7874 Documentation, Build, Configure, Make, Install, Tests, Compiled Perl
7875 Source, Compiled Module Source, Perl Modules/Scripts
7876
7877 =item BUGS ON CYGWIN
7878
7879 =item AUTHORS
7880
7881 =item HISTORY
7882
7883 =back
7884
7885 =head2 perldgux - Perl under DG/UX.
7886
7887 =over 4
7888
7889 =item SYNOPSIS
7890
7891 =back
7892
7893 =over 4
7894
7895 =item DESCRIPTION
7896
7897 =item BUILDING PERL ON DG/UX
7898
7899 =over 4
7900
7901 =item Non-threaded Perl on DG/UX
7902
7903 =item Threaded Perl on DG/UX
7904
7905 =item Testing Perl on DG/UX
7906
7907 =item Installing the built perl on DG/UX
7908
7909 =back
7910
7911 =item AUTHOR
7912
7913 =item SEE ALSO
7914
7915 =back
7916
7917 =head2 perldos - Perl under DOS, W31, W95.
7918
7919 =over 4
7920
7921 =item SYNOPSIS
7922
7923 =item DESCRIPTION
7924
7925 =over 4
7926
7927 =item Prerequisites for Compiling Perl on DOS
7928
7929 DJGPP, Pthreads
7930
7931 =item Shortcomings of Perl under DOS
7932
7933 =item Building Perl on DOS
7934
7935 =item Testing Perl on DOS
7936
7937 =item Installation of Perl on DOS
7938
7939 =back
7940
7941 =item BUILDING AND INSTALLING MODULES ON DOS
7942
7943 =over 4
7944
7945 =item Building Prerequisites for Perl on DOS
7946
7947 =item Unpacking CPAN Modules on DOS
7948
7949 =item Building Non-XS Modules on DOS
7950
7951 =item Building XS Modules on DOS
7952
7953 =back
7954
7955 =item AUTHOR
7956
7957 =item SEE ALSO
7958
7959 =back
7960
7961 =head2 perlepoc, README.epoc - Perl for EPOC
7962
7963 =over 4
7964
7965 =item SYNOPSIS
7966
7967 =item INTRODUCTION
7968
7969 =item INSTALLING PERL ON EPOC
7970
7971 =item STARTING PERL ON EPOC
7972
7973 =over 4
7974
7975 =item Editors on Epoc
7976
7977 =item Features of Perl on Epoc
7978
7979 =item Restrictions of Perl on Epoc
7980
7981 =item Compiling Perl 5 on the EPOC cross compiling environment
7982
7983 =back
7984
7985 =item SUPPORT STATUS OF PERL ON EPOC
7986
7987 =item AUTHOR
7988
7989 =item LAST UPDATE
7990
7991 =back
7992
7993 =head2 perlfreebsd, README.freebsd - Perl version 5 on FreeBSD systems
7994
7995 =over 4
7996
7997 =item DESCRIPTION
7998
7999 =over 4
8000
8001 =item FreeBSD core dumps from readdir_r with ithreads
8002
8003 =item $^X doesn't always contain a full path in FreeBSD
8004
8005 =item Perl will no longer be part of "base FreeBSD"
8006
8007 =back
8008
8009 =item AUTHOR
8010
8011 =back
8012
8013 =head2 perlhpux, README.hpux - Perl version 5 on Hewlett-Packard Unix
8014 (HP-UX) systems
8015
8016 =over 4
8017
8018 =item DESCRIPTION
8019
8020 =over 4
8021
8022 =item Using perl as shipped with HP-UX
8023
8024 =item Using perl from HP's porting centre
8025
8026 =item Compiling Perl 5 on HP-UX
8027
8028 =item PA-RISC
8029
8030 =item PA-RISC 1.0
8031
8032 =item PA-RISC 1.1
8033
8034 =item PA-RISC 2.0
8035
8036 =item Itanium
8037
8038 =item Portability Between PA-RISC Versions
8039
8040 =item Itanium Processor Family and HP-UX
8041
8042 =item Building Dynamic Extensions on HP-UX
8043
8044 =item The HP ANSI C Compiler
8045
8046 =item The GNU C Compiler
8047
8048 =item Using Large Files with Perl on HP-UX
8049
8050 =item Threaded Perl on HP-UX
8051
8052 =item 64-bit Perl on HP-UX
8053
8054 =item Oracle on HP-UX
8055
8056 =item GDBM and Threads on HP-UX
8057
8058 =item NFS filesystems and utime(2) on HP-UX
8059
8060 =item perl -P and // and HP-UX
8061
8062 =item HP-UX Kernel Parameters (maxdsiz) for Compiling Perl
8063
8064 =back
8065
8066 =item nss_delete core dump from op/pwent or op/grent
8067
8068 =item AUTHOR
8069
8070 =item DATE
8071
8072 =back
8073
8074 =head2 perlhurd, README.hurd - Perl version 5 on Hurd
8075
8076 =over 4
8077
8078 =item DESCRIPTION
8079
8080 =over 4
8081
8082 =item Known Problems with Perl on Hurd 
8083
8084 =back
8085
8086 =item AUTHOR
8087
8088 =back
8089
8090 =head2 perlirix, README.irix - Perl version 5 on Irix systems
8091
8092 =over 4
8093
8094 =item DESCRIPTION
8095
8096 =over 4
8097
8098 =item Building 32-bit Perl in Irix
8099
8100 =item Building 64-bit Perl in Irix
8101
8102 =item About Compiler Versions of Irix
8103
8104 =item Linker Problems in Irix
8105
8106 =item Malloc in Irix
8107
8108 =item Building with threads in Irix
8109
8110 =item Irix 5.3
8111
8112 =back
8113
8114 =item AUTHOR
8115
8116 =back
8117
8118 =head2 perlmachten, README.machten - Perl version 5 on Power MachTen
8119 systems
8120
8121 =over 4
8122
8123 =item DESCRIPTION
8124
8125 =over 4
8126
8127 =item Compiling Perl 5 on MachTen
8128
8129 =item Failures during C<make test> on MachTen
8130
8131 op/lexassign.t, pragma/warnings.t
8132
8133 =item Building external modules on MachTen
8134
8135 =back
8136
8137 =item AUTHOR
8138
8139 =item DATE
8140
8141 =back
8142
8143 =head2 perlmacos, README.macos - Perl under Mac OS (Classic)
8144
8145 =over 4
8146
8147 =item SYNOPSIS
8148
8149 =item DESCRIPTION
8150
8151 =item AUTHOR
8152
8153 =item DATE
8154
8155 =back
8156
8157 =head2 perlmacosx, README.macosx - Perl under Mac OS X
8158
8159 =over 4
8160
8161 =item SYNOPSIS
8162
8163 =item DESCRIPTION
8164
8165 =over 4
8166
8167 =item Installation Prefix
8168
8169 =item libperl and Prebinding
8170
8171 =item Updating Panther
8172
8173 =item Known problems
8174
8175 =item MacPerl
8176
8177 =item Carbon
8178
8179 =item Cocoa
8180
8181 =back
8182
8183 =item Starting From Scratch
8184
8185 =item AUTHOR
8186
8187 =item DATE
8188
8189 =back
8190
8191 =head2 perlmint, README.mint - Perl version 5 on Atari MiNT
8192
8193 =over 4
8194
8195 =item DESCRIPTION
8196
8197 =item Known problems with Perl on MiNT
8198
8199 =item AUTHOR
8200
8201 =back
8202
8203 =head2 perlmpeix, README.mpeix - Perl/iX for HP e3000 MPE
8204
8205 =over 4
8206
8207 =item SYNOPSIS
8208
8209 =item NOTE
8210
8211 =item Binary distribution from HP
8212
8213 =item What's New in Perl for MPE/iX
8214
8215 =item Welcome to Perl/iX
8216
8217 =item System Requirements for Perl/iX
8218
8219 =item How to Obtain Perl/iX
8220
8221 =item Perl/iX Distribution Contents Highlights
8222
8223 README, INSTALL, LIBSHP3K, PERL, .cpan/, lib/, man/,
8224 public_html/feedback.cgi, src/perl-5.6.0-mpe
8225
8226 =item How to Compile Perl/iX
8227
8228  4,  6
8229
8230 =item Getting Started with Perl/iX
8231
8232 =item MPE/iX Implementation Considerations
8233
8234 =item Known Perl/iX Bugs Under Investigation
8235
8236 =item Perl/iX To-Do List
8237
8238 =item Perl/iX Change History
8239
8240 =item AUTHOR
8241
8242 =item Name
8243
8244 =item Description
8245
8246 =item Build
8247
8248 =over 4
8249
8250 =item Tools & SDK
8251
8252 =item Setup
8253
8254 SetNWBld.bat, Buildtype.bat
8255
8256 =item Make
8257
8258 =item Interpreter
8259
8260 =item Extensions
8261
8262 =back
8263
8264 =item Install
8265
8266 =item Build new extensions
8267
8268 =item Acknowledgements
8269
8270 =item Authors
8271
8272 =item Date
8273
8274 =back
8275
8276 =head2 perlos2 - Perl under OS/2, DOS, Win0.3*, Win0.95 and WinNT.
8277
8278 =over 4
8279
8280 =item SYNOPSIS
8281
8282 =back
8283
8284 =over 4
8285
8286 =item DESCRIPTION
8287
8288 =over 4
8289
8290 =item Target
8291
8292 =item Other OSes
8293
8294 =item Prerequisites
8295
8296 EMX, RSX, HPFS, pdksh
8297
8298 =item Starting Perl programs under OS/2 (and DOS and...)
8299
8300 =item Starting OS/2 (and DOS) programs under Perl
8301
8302 =back
8303
8304 =item Frequently asked questions
8305
8306 =over 4
8307
8308 =item "It does not work"
8309
8310 =item I cannot run external programs
8311
8312 =item I cannot embed perl into my program, or use F<perl.dll> from my
8313 program. 
8314
8315 Is your program EMX-compiled with C<-Zmt -Zcrtdll>?, Did you use
8316 L<ExtUtils::Embed>?
8317
8318 =item C<``> and pipe-C<open> do not work under DOS.
8319
8320 =item Cannot start C<find.exe "pattern" file>
8321
8322 =back
8323
8324 =item INSTALLATION
8325
8326 =over 4
8327
8328 =item Automatic binary installation
8329
8330 C<PERL_BADLANG>, C<PERL_BADFREE>, F<Config.pm>
8331
8332 =item Manual binary installation
8333
8334 Perl VIO and PM executables (dynamically linked), Perl_ VIO executable
8335 (statically linked), Executables for Perl utilities, Main Perl library,
8336 Additional Perl modules, Tools to compile Perl modules, Manpages for Perl
8337 and utilities, Manpages for Perl modules, Source for Perl documentation,
8338 Perl manual in F<.INF> format, Pdksh
8339
8340 =item B<Warning>
8341
8342 =back
8343
8344 =item Accessing documentation
8345
8346 =over 4
8347
8348 =item OS/2 F<.INF> file
8349
8350 =item Plain text
8351
8352 =item Manpages
8353
8354 =item HTML
8355
8356 =item GNU C<info> files
8357
8358 =item F<PDF> files
8359
8360 =item C<LaTeX> docs
8361
8362 =back
8363
8364 =item BUILD
8365
8366 =over 4
8367
8368 =item The short story
8369
8370 =item Prerequisites
8371
8372 =item Getting perl source
8373
8374 =item Application of the patches
8375
8376 =item Hand-editing
8377
8378 =item Making
8379
8380 =item Testing
8381
8382 A lot of C<bad free>, Process terminated by SIGTERM/SIGINT, F<op/fs.t>,
8383 F<op/stat.t>
8384
8385 =item Installing the built perl
8386
8387 =item C<a.out>-style build
8388
8389 =back
8390
8391 =item Build FAQ
8392
8393 =over 4
8394
8395 =item Some C</> became C<\> in pdksh.
8396
8397 =item C<'errno'> - unresolved external
8398
8399 =item Problems with tr or sed
8400
8401 =item Some problem (forget which ;-)
8402
8403 =item Library ... not found
8404
8405 =item Segfault in make
8406
8407 =item op/sprintf test failure
8408
8409 =back
8410
8411 =item Specific (mis)features of OS/2 port
8412
8413 =over 4
8414
8415 =item C<setpriority>, C<getpriority>
8416
8417 =item C<system()>
8418
8419 =item C<extproc> on the first line
8420
8421 =item Additional modules:
8422
8423 =item Prebuilt methods:
8424
8425 C<File::Copy::syscopy>, C<DynaLoader::mod2fname>,  C<Cwd::current_drive()>,
8426  C<Cwd::sys_chdir(name)>,  C<Cwd::change_drive(name)>, 
8427 C<Cwd::sys_is_absolute(name)>,  C<Cwd::sys_is_rooted(name)>, 
8428 C<Cwd::sys_is_relative(name)>,  C<Cwd::sys_cwd(name)>, 
8429 C<Cwd::sys_abspath(name, dir)>,  C<Cwd::extLibpath([type])>, 
8430 C<Cwd::extLibpath_set( path [, type ] )>,
8431 C<OS2::Error(do_harderror,do_exception)>, C<OS2::Errors2Drive(drive)>,
8432 OS2::SysInfo(), OS2::BootDrive(), C<OS2::MorphPM(serve)>,
8433 C<OS2::UnMorphPM(serve)>, C<OS2::Serve_Messages(force)>,
8434 C<OS2::Process_Messages(force [, cnt])>, C<OS2::_control87(new,mask)>,
8435 OS2::get_control87(), C<OS2::set_control87_em(new=MCW_EM,mask=MCW_EM)>,
8436 C<OS2::DLLname([how [, \&xsub]])>
8437
8438 =item Prebuilt variables:
8439
8440 $OS2::emx_rev, $OS2::emx_env, $OS2::os_ver, $OS2::is_aout, $OS2::can_fork,
8441 $OS2::nsyserror
8442
8443 =item Misfeatures
8444
8445 =item Modifications
8446
8447 C<popen>, C<tmpnam>, C<tmpfile>, C<ctermid>, C<stat>, C<mkdir>, C<rmdir>,
8448 C<flock>
8449
8450 =item Identifying DLLs
8451
8452 =item Centralized management of resources
8453
8454 C<HAB>, C<HMQ>, Treating errors reported by OS/2 API,
8455 C<CheckOSError(expr)>, C<CheckWinError(expr)>, C<SaveWinError(expr)>,
8456 C<SaveCroakWinError(expr,die,name1,name2)>, C<WinError_2_Perl_rc>,
8457 C<FillWinError>, C<FillOSError(rc)>, Loading DLLs and ordinals in DLLs
8458
8459 =back
8460
8461 =item Perl flavors
8462
8463 =over 4
8464
8465 =item F<perl.exe>
8466
8467 =item F<perl_.exe>
8468
8469 =item F<perl__.exe>
8470
8471 =item F<perl___.exe>
8472
8473 =item Why strange names?
8474
8475 =item Why dynamic linking?
8476
8477 =item Why chimera build?
8478
8479 =back
8480
8481 =item ENVIRONMENT
8482
8483 =over 4
8484
8485 =item C<PERLLIB_PREFIX>
8486
8487 =item C<PERL_BADLANG>
8488
8489 =item C<PERL_BADFREE>
8490
8491 =item C<PERL_SH_DIR>
8492
8493 =item C<USE_PERL_FLOCK>
8494
8495 =item C<TMP> or C<TEMP>
8496
8497 =back
8498
8499 =item Evolution
8500
8501 =over 4
8502
8503 =item Text-mode filehandles
8504
8505 =item Priorities
8506
8507 =item DLL name mangling: pre 5.6.2
8508
8509 =item DLL name mangling: 5.6.2 and beyond
8510
8511 Global DLLs, specific DLLs, C<BEGINLIBPATH> and C<ENDLIBPATH>, F<.> from
8512 C<LIBPATH>
8513
8514 =item DLL forwarder generation
8515
8516 =item Threading
8517
8518 =item Calls to external programs
8519
8520 =item Memory allocation
8521
8522 =item Threads
8523
8524 C<COND_WAIT>, F<os2.c>
8525
8526 =back
8527
8528 =item BUGS
8529
8530 =back
8531
8532 =over 4
8533
8534 =item AUTHOR
8535
8536 =item SEE ALSO
8537
8538 =back
8539
8540 =head2 perlos390, README.os390 - building and installing Perl for OS/390
8541 and z/OS
8542
8543 =over 4
8544
8545 =item SYNOPSIS
8546
8547 =item DESCRIPTION
8548
8549 =over 4
8550
8551 =item Tools
8552
8553 =item Unpacking Perl distribution on OS/390
8554
8555 =item Setup and utilities for Perl on OS/390
8556
8557 =item Configure Perl on OS/390
8558
8559 =item Build, Test, Install Perl on OS/390
8560
8561 =item Build Anomalies with Perl on OS/390
8562
8563 =item Testing Anomalies with Perl on OS/390
8564
8565 =item Installation Anomalies with Perl on OS/390
8566
8567 =item Usage Hints for Perl on OS/390
8568
8569 =item Floating Point Anomalies with Perl on OS/390
8570
8571 =item Modules and Extensions for Perl on OS/390
8572
8573 =back
8574
8575 =item AUTHORS
8576
8577 =item SEE ALSO
8578
8579 =over 4
8580
8581 =item Mailing list for Perl on OS/390
8582
8583 =back
8584
8585 =item HISTORY
8586
8587 =back
8588
8589 =head2 perlos400, README.os400 - Perl version 5 on OS/400
8590
8591 =over 4
8592
8593 =item DESCRIPTION
8594
8595 =over 4
8596
8597 =item Compiling Perl for OS/400 PASE
8598
8599 =item Installing Perl in OS/400 PASE
8600
8601 =item Using Perl in OS/400 PASE
8602
8603 =item Known Problems
8604
8605 =item Perl on ILE
8606
8607 =back
8608
8609 =item AUTHORS
8610
8611 =back
8612
8613 =head2 perlplan9 - Plan 9-specific documentation for Perl
8614
8615 =over 4
8616
8617 =item DESCRIPTION
8618
8619 =over 4
8620
8621 =item Invoking Perl
8622
8623 =item What's in Plan 9 Perl
8624
8625 =item What's not in Plan 9 Perl
8626
8627 =item Perl5 Functions not currently supported in Plan 9 Perl
8628
8629 =item Signals in Plan 9 Perl
8630
8631 =back
8632
8633 =item COMPILING AND INSTALLING PERL ON PLAN 9
8634
8635 =over 4
8636
8637 =item Installing Perl Documentation on Plan 9
8638
8639 =back
8640
8641 =item BUGS
8642
8643 =item Revision date
8644
8645 =item AUTHOR
8646
8647 =back
8648
8649 =head2 perlqnx, README.qnx - Perl version 5 on QNX
8650
8651 =over 4
8652
8653 =item DESCRIPTION
8654
8655 =over 4
8656
8657 =item Required Software for Compiling Perl on QNX4
8658
8659 /bin/sh, ar, nm, cpp, make
8660
8661 =item Outstanding Issues with Perl on QNX4
8662
8663 =item QNX auxiliary files
8664
8665 qnx/ar, qnx/cpp
8666
8667 =item Outstanding issues with perl under QNX6
8668
8669 =back
8670
8671 =item AUTHOR
8672
8673 =back
8674
8675 =head2 perlsolaris, README.solaris - Perl version 5 on Solaris systems
8676
8677 =over 4
8678
8679 =item DESCRIPTION
8680
8681 =over 4
8682
8683 =item Solaris Version Numbers.
8684
8685 =back
8686
8687 =item RESOURCES
8688
8689 Solaris FAQ, Precompiled Binaries, Solaris Documentation
8690
8691 =item SETTING UP
8692
8693 =over 4
8694
8695 =item File Extraction Problems on Solaris.
8696
8697 =item Compiler and Related Tools on Solaris.
8698
8699 =item Environment for Compiling perl on Solaris
8700
8701 =back
8702
8703 =item RUN CONFIGURE.
8704
8705 =over 4
8706
8707 =item 64-bit perl on Solaris.
8708
8709 =item Threads in perl on Solaris.
8710
8711 =item Malloc Issues with perl on Solaris.
8712
8713 =back
8714
8715 =item MAKE PROBLEMS.
8716
8717 Dynamic Loading Problems With GNU as and GNU ld, ld.so.1: ./perl: fatal:
8718 relocation error:, dlopen: stub interception failed, #error "No
8719 DATAMODEL_NATIVE specified", sh: ar: not found
8720
8721 =item MAKE TEST
8722
8723 =over 4
8724
8725 =item op/stat.t test 4 in Solaris
8726
8727 =item nss_delete core dump from op/pwent or op/grent
8728
8729 =back
8730
8731 =item PREBUILT BINARIES OF PERL FOR SOLARIS.
8732
8733 =item RUNTIME ISSUES FOR PERL ON SOLARIS.
8734
8735 =over 4
8736
8737 =item Limits on Numbers of Open Files on Solaris.
8738
8739 =back
8740
8741 =item SOLARIS-SPECIFIC MODULES.
8742
8743 =item SOLARIS-SPECIFIC PROBLEMS WITH MODULES.
8744
8745 =over 4
8746
8747 =item Proc::ProcessTable on Solaris
8748
8749 =item BSD::Resource on Solaris
8750
8751 =item Net::SSLeay on Solaris
8752
8753 =back
8754
8755 =item SunOS 4.x
8756
8757 =item AUTHOR
8758
8759 =item LAST MODIFIED
8760
8761 =back
8762
8763 =head2 perltru64, README.tru64 - Perl version 5 on Tru64 (formerly known as
8764 Digital UNIX formerly known as DEC OSF/1) systems
8765
8766 =over 4
8767
8768 =item DESCRIPTION
8769
8770 =over 4
8771
8772 =item Compiling Perl 5 on Tru64
8773
8774 =item Using Large Files with Perl on Tru64
8775
8776 =item Threaded Perl on Tru64
8777
8778 =item Long Doubles on Tru64
8779
8780 =item DB_File tests failing on Tru64
8781
8782 =item 64-bit Perl on Tru64
8783
8784 =item Warnings about floating-point overflow when compiling Perl on Tru64
8785
8786 =back
8787
8788 =item Testing Perl on Tru64
8789
8790 =item ext/ODBM_File/odbm Test Failing With Static Builds
8791
8792 =item Perl Fails Because Of Unresolved Symbol sockatmark
8793
8794 =item AUTHOR
8795
8796 =back
8797
8798 =head2 perluts - Perl under UTS
8799
8800 =over 4
8801
8802 =item SYNOPSIS
8803
8804 =item DESCRIPTION
8805
8806 =item BUILDING PERL ON UTS
8807
8808 =item Installing the built perl on UTS
8809
8810 =item AUTHOR
8811
8812 =back
8813
8814 =head2 perlvmesa, README.vmesa - building and installing Perl for VM/ESA.
8815
8816 =over 4
8817
8818 =item SYNOPSIS
8819
8820 =item DESCRIPTION
8821
8822 =over 4
8823
8824 =item Unpacking Perl Distribution on VM/ESA
8825
8826 =item Setup Perl and utilities on VM/ESA
8827
8828 =item Configure Perl on VM/ESA
8829
8830 =item Testing Anomalies of Perl on VM/ESA
8831
8832 =item Usage Hints for Perl on VM/ESA
8833
8834 =back
8835
8836 =item AUTHORS
8837
8838 =item SEE ALSO
8839
8840 =over 4
8841
8842 =item Mailing list for Perl on VM/ESA
8843
8844 =back
8845
8846 =back
8847
8848 =head2 perlvms - VMS-specific documentation for Perl
8849
8850 =over 4
8851
8852 =item DESCRIPTION
8853
8854 =item Installation
8855
8856 =item Organization of Perl Images
8857
8858 =over 4
8859
8860 =item Core Images
8861
8862 =item Perl Extensions
8863
8864 =item Installing static extensions
8865
8866 =item Installing dynamic extensions
8867
8868 =back
8869
8870 =item File specifications
8871
8872 =over 4
8873
8874 =item Syntax
8875
8876 =item Wildcard expansion
8877
8878 =item Pipes
8879
8880 =back
8881
8882 =item PERL5LIB and PERLLIB
8883
8884 =item Command line
8885
8886 =over 4
8887
8888 =item I/O redirection and backgrounding
8889
8890 =item Command line switches
8891
8892 -i, -S, -u
8893
8894 =back
8895
8896 =item Perl functions
8897
8898 File tests, backticks, binmode FILEHANDLE, crypt PLAINTEXT, USER, dump,
8899 exec LIST, fork, getpwent, getpwnam, getpwuid, gmtime, kill, qx//, select
8900 (system call), stat EXPR, system LIST, time, times, unlink LIST, utime
8901 LIST, waitpid PID,FLAGS
8902
8903 =item Perl variables
8904
8905 %ENV, CRTL_ENV, CLISYM_[LOCAL], Any other string, $!, $^E, $?, $|
8906
8907 =item Standard modules with VMS-specific differences
8908
8909 =over 4
8910
8911 =item SDBM_File
8912
8913 =back
8914
8915 =item Revision date
8916
8917 =item AUTHOR
8918
8919 =back
8920
8921 =head2 perlvos, README.vos - Perl for Stratus VOS
8922
8923 =over 4
8924
8925 =item SYNOPSIS
8926
8927 =item BUILDING PERL FOR VOS
8928
8929 =item INSTALLING PERL IN VOS
8930
8931 =item USING PERL IN VOS
8932
8933 =over 4
8934
8935 =item Restrictions of Perl on VOS
8936
8937 =item Handling of underflow and overflow
8938
8939 =back
8940
8941 =item TEST STATUS
8942
8943 =item SUPPORT STATUS
8944
8945 =item AUTHOR
8946
8947 =item LAST UPDATE
8948
8949 =back
8950
8951 =head2 perlwin32 - Perl under Windows
8952
8953 =over 4
8954
8955 =item SYNOPSIS
8956
8957 =item DESCRIPTION
8958
8959 =over 4
8960
8961 =item Setting Up Perl on Win32
8962
8963 Make, Command Shell, Borland C++, Microsoft Visual C++, Microsoft Platform
8964 SDK 64-bit Compiler, MinGW32 with gcc, MinGW release 1
8965
8966 =item Building
8967
8968 =item Testing Perl on Win32
8969
8970 =item Installation of Perl on Win32
8971
8972 =item Usage Hints for Perl on Win32
8973
8974 Environment Variables, File Globbing, Using perl from the command line,
8975 Building Extensions, Command-line Wildcard Expansion, Win32 Specific
8976 Extensions, Notes on 64-bit Windows
8977
8978 =item Running Perl Scripts
8979
8980 Miscellaneous Things
8981
8982 =back
8983
8984 =item BUGS AND CAVEATS
8985
8986 =item AUTHORS
8987
8988 Gary Ng E<lt>71564.1743@CompuServe.COME<gt>, Gurusamy Sarathy
8989 E<lt>gsar@activestate.comE<gt>, Nick Ing-Simmons
8990 E<lt>nick@ing-simmons.netE<gt>
8991
8992 =item SEE ALSO
8993
8994 =item HISTORY
8995
8996 =back
8997
8998 =head1 PRAGMA DOCUMENTATION
8999
9000 =head2 attrs - set/get attributes of a subroutine (deprecated)
9001
9002 =over 4
9003
9004 =item SYNOPSIS
9005
9006 =item DESCRIPTION
9007
9008 method, locked
9009
9010 =back
9011
9012 =head2 re - Perl pragma to alter regular expression behaviour
9013
9014 =over 4
9015
9016 =item SYNOPSIS
9017
9018 =item DESCRIPTION
9019
9020 =back
9021
9022 =head2 threadshared::shared, threads::shared - Perl extension for sharing
9023 data structures between threads
9024
9025 =over 4
9026
9027 =item SYNOPSIS
9028
9029 =item DESCRIPTION
9030
9031 =item EXPORT
9032
9033 =item FUNCTIONS
9034
9035 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
9036 cond_broadcast VARIABLE
9037
9038 =item NOTES
9039
9040 =item BUGS
9041
9042 =item AUTHOR
9043
9044 =item SEE ALSO
9045
9046 =back
9047
9048 =head2 threads - Perl extension allowing use of interpreter based threads
9049 from perl
9050
9051 =over 4
9052
9053 =item SYNOPSIS
9054
9055 =item DESCRIPTION
9056
9057 $thread = threads->create(function, LIST), $thread->join, $thread->detach,
9058 threads->self, $thread->tid, threads->object( tid ), threads->yield();,
9059 threads->list();, async BLOCK;
9060
9061 =item WARNINGS
9062
9063 A thread exited while %d other threads were still running
9064
9065 =item TODO
9066
9067 =item BUGS
9068
9069 Parent-Child threads, Returning objects, Creating threads inside BEGIN
9070 blocks, PERL_OLD_SIGNALS are not threadsafe, will not be
9071
9072 =item AUTHOR and COPYRIGHT
9073
9074 =item SEE ALSO
9075
9076 =back
9077
9078 =head2 assertions - select assertions in blocks of code
9079
9080 =over 4
9081
9082 =item SYNOPSIS
9083
9084 =item DESCRIPTION
9085
9086 =item SEE ALSO
9087
9088 =item AUTHOR
9089
9090 =item COPYRIGHT AND LICENSE
9091
9092 =back
9093
9094 =head2 assertions::activate - activate assertions
9095
9096 =over 4
9097
9098 =item SYNOPSIS
9099
9100 =item DESCRIPTION
9101
9102 =item SEE ALSO
9103
9104 =item AUTHOR
9105
9106 =item COPYRIGHT AND LICENSE
9107
9108 =back
9109
9110 =head2 attributes - get/set subroutine or variable attributes
9111
9112 =over 4
9113
9114 =item SYNOPSIS
9115
9116 =item DESCRIPTION
9117
9118 =over 4
9119
9120 =item Built-in Attributes
9121
9122 locked, method, lvalue
9123
9124 =item Available Subroutines
9125
9126 get, reftype
9127
9128 =item Package-specific Attribute Handling
9129
9130 FETCH_I<type>_ATTRIBUTES, MODIFY_I<type>_ATTRIBUTES
9131
9132 =item Syntax of Attribute Lists
9133
9134 =back
9135
9136 =item EXPORTS
9137
9138 =over 4
9139
9140 =item Default exports
9141
9142 =item Available exports
9143
9144 =item Export tags defined
9145
9146 =back
9147
9148 =item EXAMPLES
9149
9150 =item SEE ALSO
9151
9152 =back
9153
9154 =head2 autouse - postpone load of modules until a function is used
9155
9156 =over 4
9157
9158 =item SYNOPSIS
9159
9160 =item DESCRIPTION
9161
9162 =item WARNING
9163
9164 =item AUTHOR
9165
9166 =item SEE ALSO
9167
9168 =back
9169
9170 =head2 base - Establish IS-A relationship with base class at compile time
9171
9172 =over 4
9173
9174 =item SYNOPSIS
9175
9176 =item DESCRIPTION
9177
9178 =item HISTORY
9179
9180 =item CAVEATS
9181
9182 =item SEE ALSO
9183
9184 =back
9185
9186 =head2 bigint - Transparent BigInteger support for Perl
9187
9188 =over 4
9189
9190 =item SYNOPSIS
9191
9192 =item DESCRIPTION
9193
9194 =over 4
9195
9196 =item OPTIONS
9197
9198 a or accuracy, p or precision, t or trace, l or lib, v or version
9199
9200 =item MATH LIBRARY
9201
9202 =item INTERNAL FORMAT
9203
9204 =item SIGN
9205
9206 =item METHODS
9207
9208 =item CAVEAT
9209
9210 =back
9211
9212 =item MODULES USED
9213
9214 =item EXAMPLES
9215
9216 =item LICENSE
9217
9218 =item SEE ALSO
9219
9220 =item AUTHORS
9221
9222 =back
9223
9224 =head2 bignum - Transparent BigNumber support for Perl
9225
9226 =over 4
9227
9228 =item SYNOPSIS
9229
9230 =item DESCRIPTION
9231
9232 =over 4
9233
9234 =item OPTIONS
9235
9236 a or accuracy, p or precision, t or trace, l or lib, v or version
9237
9238 =item METHODS
9239
9240 =item CAVEAT
9241
9242 inf(), NaN(), upgrade()
9243
9244 =item MATH LIBRARY
9245
9246 =item INTERNAL FORMAT
9247
9248 =item SIGN
9249
9250 =back
9251
9252 =item MODULES USED
9253
9254 =item EXAMPLES
9255
9256 =item LICENSE
9257
9258 =item SEE ALSO
9259
9260 =item AUTHORS
9261
9262 =back
9263
9264 =head2 bigrat - Transparent BigNumber/BigRational support for Perl
9265
9266 =over 4
9267
9268 =item SYNOPSIS
9269
9270 =item DESCRIPTION
9271
9272 =over 4
9273
9274 =item MODULES USED
9275
9276 =item MATH LIBRARY
9277
9278 =item SIGN
9279
9280 =item METHODS
9281
9282 =item CAVEAT
9283
9284 =back
9285
9286 =item EXAMPLES
9287
9288         perl -Mbigrat -le 'print sqrt(33)'
9289         perl -Mbigrat -le 'print 2*255'
9290         perl -Mbigrat -le 'print 4.5+2*255'
9291         perl -Mbigrat -le 'print 3/7 + 5/7 + 8/3'       
9292         perl -Mbigrat -le 'print 12->is_odd()';
9293
9294 =item LICENSE
9295
9296 =item SEE ALSO
9297
9298 =item AUTHORS
9299
9300 =back
9301
9302 =head2 blib - Use MakeMaker's uninstalled version of a package
9303
9304 =over 4
9305
9306 =item SYNOPSIS
9307
9308 =item DESCRIPTION
9309
9310 =item BUGS
9311
9312 =item AUTHOR
9313
9314 =back
9315
9316 =head2 bytes - Perl pragma to force byte semantics rather than character
9317 semantics
9318
9319 =over 4
9320
9321 =item SYNOPSIS
9322
9323 =item DESCRIPTION
9324
9325 =item LIMITATIONS
9326
9327 =item SEE ALSO
9328
9329 =back
9330
9331 =head2 charnames - define character names for C<\N{named}> string literal
9332 escapes
9333
9334 =over 4
9335
9336 =item SYNOPSIS
9337
9338 =item DESCRIPTION
9339
9340 =item CUSTOM TRANSLATORS
9341
9342 =item CUSTOM ALIASES
9343
9344 =over 4
9345
9346 =item Anonymous hashes
9347
9348 =item Alias file
9349
9350 =item Alias shortcut
9351
9352 =back
9353
9354 =item charnames::viacode(code)
9355
9356 =item charnames::vianame(name)
9357
9358 =item ALIASES
9359
9360 =item ILLEGAL CHARACTERS
9361
9362 =item BUGS
9363
9364 =back
9365
9366 =head2 constant - Perl pragma to declare constants
9367
9368 =over 4
9369
9370 =item SYNOPSIS
9371
9372 =item DESCRIPTION
9373
9374 =item NOTES
9375
9376 =over 4
9377
9378 =item List constants
9379
9380 =item Defining multiple constants at once
9381
9382 =item Magic constants
9383
9384 =back
9385
9386 =item TECHNICAL NOTES
9387
9388 =item BUGS
9389
9390 =item AUTHOR
9391
9392 =item COPYRIGHT
9393
9394 =back
9395
9396 =head2 diagnostics - Perl compiler pragma to force verbose warning
9397 diagnostics
9398
9399 =over 4
9400
9401 =item SYNOPSIS
9402
9403 =item DESCRIPTION
9404
9405 =over 4
9406
9407 =item The C<diagnostics> Pragma
9408
9409 =item The I<splain> Program
9410
9411 =back
9412
9413 =item EXAMPLES
9414
9415 =item INTERNALS
9416
9417 =item BUGS
9418
9419 =item AUTHOR
9420
9421 =back
9422
9423 =head2 encoding - allows you to write your script in non-ascii or non-utf8
9424
9425 =over 4
9426
9427 =item SYNOPSIS
9428
9429 =item ABSTRACT
9430
9431 =over 4
9432
9433 =item Literal Conversions
9434
9435 =item PerlIO layers for C<STD(IN|OUT)>
9436
9437 =back
9438
9439 =item FEATURES THAT REQUIRE 5.8.1
9440
9441 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
9442
9443 =item USAGE
9444
9445 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
9446 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
9447
9448 =item The Filter Option
9449
9450 =over 4
9451
9452 =item Filter-related changes at Encode version 1.87
9453
9454 =back
9455
9456 =item CAVEATS
9457
9458 =over 4
9459
9460 =item NOT SCOPED
9461
9462 =item DO NOT MIX MULTIPLE ENCODINGS
9463
9464 =item tr/// with ranges
9465
9466 Legend of characters above
9467
9468 =back
9469
9470 =item EXAMPLE - Greekperl
9471
9472 =item KNOWN PROBLEMS
9473
9474 literals in regex that are longer than 127 bytes, EBCDIC, format
9475
9476 =item HISTORY
9477
9478 =item SEE ALSO
9479
9480 =back
9481
9482 =head2 fields - compile-time class fields
9483
9484 =over 4
9485
9486 =item SYNOPSIS
9487
9488 =item DESCRIPTION
9489
9490 new, phash
9491
9492 =item SEE ALSO
9493
9494 =back
9495
9496 =head2 filetest - Perl pragma to control the filetest permission operators
9497
9498 =over 4
9499
9500 =item SYNOPSIS
9501
9502 =item DESCRIPTION
9503
9504 =over 4
9505
9506 =item subpragma access
9507
9508 =back
9509
9510 =back
9511
9512 =head2 if - C<use> a Perl module if a condition holds
9513
9514 =over 4
9515
9516 =item SYNOPSIS
9517
9518 =item DESCRIPTION
9519
9520 =item BUGS
9521
9522 =item AUTHOR
9523
9524 =back
9525
9526 =head2 integer - Perl pragma to use integer arithmetic instead of floating
9527 point
9528
9529 =over 4
9530
9531 =item SYNOPSIS
9532
9533 =item DESCRIPTION
9534
9535 =back
9536
9537 =head2 less - perl pragma to request less of something from the compiler
9538
9539 =over 4
9540
9541 =item SYNOPSIS
9542
9543 =item DESCRIPTION
9544
9545 =back
9546
9547 =head2 lib - manipulate @INC at compile time
9548
9549 =over 4
9550
9551 =item SYNOPSIS
9552
9553 =item DESCRIPTION
9554
9555 =over 4
9556
9557 =item Adding directories to @INC
9558
9559 =item Deleting directories from @INC
9560
9561 =item Restoring original @INC
9562
9563 =back
9564
9565 =item CAVEATS
9566
9567 =item NOTES
9568
9569 =item SEE ALSO
9570
9571 =item AUTHOR
9572
9573 =back
9574
9575 =head2 locale - Perl pragma to use and avoid POSIX locales for built-in
9576 operations
9577
9578 =over 4
9579
9580 =item SYNOPSIS
9581
9582 =item DESCRIPTION
9583
9584 =back
9585
9586 =head2 open - perl pragma to set default PerlIO layers for input and output
9587
9588 =over 4
9589
9590 =item SYNOPSIS
9591
9592 =item DESCRIPTION
9593
9594 =item NONPERLIO FUNCTIONALITY
9595
9596 =item IMPLEMENTATION DETAILS
9597
9598 =item SEE ALSO
9599
9600 =back
9601
9602 =head2 ops - Perl pragma to restrict unsafe operations when compiling
9603
9604 =over 4
9605
9606 =item SYNOPSIS  
9607
9608 =item DESCRIPTION
9609
9610 =item SEE ALSO
9611
9612 =back
9613
9614 =head2 overload - Package for overloading perl operations
9615
9616 =over 4
9617
9618 =item SYNOPSIS
9619
9620 =item DESCRIPTION
9621
9622 =over 4
9623
9624 =item Declaration of overloaded functions
9625
9626 =item Calling Conventions for Binary Operations
9627
9628 FALSE, TRUE, C<undef>
9629
9630 =item Calling Conventions for Unary Operations
9631
9632 =item Calling Conventions for Mutators
9633
9634 C<++> and C<-->, C<x=> and other assignment versions
9635
9636 =item Overloadable Operations
9637
9638 I<Arithmetic operations>, I<Comparison operations>, I<Bit operations>,
9639 I<Increment and decrement>, I<Transcendental functions>, I<Boolean, string
9640 and numeric conversion>, I<Iteration>, I<Dereferencing>, I<Special>
9641
9642 =item Inheritance and overloading
9643
9644 Strings as values of C<use overload> directive, Overloading of an operation
9645 is inherited by derived classes
9646
9647 =back
9648
9649 =item SPECIAL SYMBOLS FOR C<use overload>
9650
9651 =over 4
9652
9653 =item Last Resort
9654
9655 =item Fallback
9656
9657 C<undef>, TRUE, defined, but FALSE
9658
9659 =item Copy Constructor
9660
9661 B<Example>
9662
9663 =back
9664
9665 =item MAGIC AUTOGENERATION
9666
9667 I<Assignment forms of arithmetic operations>, I<Conversion operations>,
9668 I<Increment and decrement>, C<abs($a)>, I<Unary minus>, I<Negation>,
9669 I<Concatenation>, I<Comparison operations>, I<Iterator>, I<Dereferencing>,
9670 I<Copy operator>
9671
9672 =item Losing overloading
9673
9674 =item Run-time Overloading
9675
9676 =item Public functions
9677
9678 overload::StrVal(arg), overload::Overloaded(arg), overload::Method(obj,op)
9679
9680 =item Overloading constants
9681
9682 integer, float, binary, q, qr
9683
9684 =item IMPLEMENTATION
9685
9686 =item Metaphor clash
9687
9688 =item Cookbook
9689
9690 =over 4
9691
9692 =item Two-face scalars
9693
9694 =item Two-face references
9695
9696 =item Symbolic calculator
9697
9698 =item I<Really> symbolic calculator
9699
9700 =back
9701
9702 =item AUTHOR
9703
9704 =item DIAGNOSTICS
9705
9706 Odd number of arguments for overload::constant, `%s' is not an overloadable
9707 type, `%s' is not a code reference
9708
9709 =item BUGS
9710
9711 =back
9712
9713 =head2 sigtrap - Perl pragma to enable simple signal handling
9714
9715 =over 4
9716
9717 =item SYNOPSIS
9718
9719 =item DESCRIPTION
9720
9721 =item OPTIONS
9722
9723 =over 4
9724
9725 =item SIGNAL HANDLERS
9726
9727 B<stack-trace>, B<die>, B<handler> I<your-handler>
9728
9729 =item SIGNAL LISTS
9730
9731 B<normal-signals>, B<error-signals>, B<old-interface-signals>
9732
9733 =item OTHER
9734
9735 B<untrapped>, B<any>, I<signal>, I<number>
9736
9737 =back
9738
9739 =item EXAMPLES
9740
9741 =back
9742
9743 =head2 sort - perl pragma to control sort() behaviour
9744
9745 =over 4
9746
9747 =item SYNOPSIS
9748
9749 =item DESCRIPTION
9750
9751 =item CAVEATS
9752
9753 =back
9754
9755 =head2 strict - Perl pragma to restrict unsafe constructs
9756
9757 =over 4
9758
9759 =item SYNOPSIS
9760
9761 =item DESCRIPTION
9762
9763 C<strict refs>, C<strict vars>, C<strict subs>
9764
9765 =item HISTORY
9766
9767 =back
9768
9769 =head2 subs - Perl pragma to predeclare sub names
9770
9771 =over 4
9772
9773 =item SYNOPSIS
9774
9775 =item DESCRIPTION
9776
9777 =back
9778
9779 =head2 threadshared, threads::shared - Perl extension for sharing data
9780 structures between threads
9781
9782 =over 4
9783
9784 =item SYNOPSIS
9785
9786 =item DESCRIPTION
9787
9788 =item EXPORT
9789
9790 =item FUNCTIONS
9791
9792 share VARIABLE, lock VARIABLE, cond_wait VARIABLE, cond_signal VARIABLE,
9793 cond_broadcast VARIABLE
9794
9795 =item NOTES
9796
9797 =item BUGS
9798
9799 =item AUTHOR
9800
9801 =item SEE ALSO
9802
9803 =back
9804
9805 =head2 utf8 - Perl pragma to enable/disable UTF-8 (or UTF-EBCDIC) in source
9806 code
9807
9808 =over 4
9809
9810 =item SYNOPSIS
9811
9812 =item DESCRIPTION
9813
9814 =over 4
9815
9816 =item Utility functions
9817
9818 $num_octets = utf8::upgrade($string), $success = utf8::downgrade($string[,
9819 FAIL_OK]), utf8::encode($string), utf8::decode($string), $flag =
9820 utf8::is_utf8(STRING), $flag = utf8::valid(STRING)
9821
9822 =back
9823
9824 =item BUGS
9825
9826 =item SEE ALSO
9827
9828 =back
9829
9830 =head2 vars - Perl pragma to predeclare global variable names (obsolete)
9831
9832 =over 4
9833
9834 =item SYNOPSIS
9835
9836 =item DESCRIPTION
9837
9838 =back
9839
9840 =head2 version - Perl extension for Version Objects
9841
9842 =over 4
9843
9844 =item SYNOPSIS
9845
9846 =item DESCRIPTION
9847
9848 =over 4
9849
9850 =item What IS a version
9851
9852 Numeric Versions, V-String Versions
9853
9854 =item Numeric Versions
9855
9856 =item V-String Versions
9857
9858 =item Object Methods
9859
9860 New Operator, Stringification, Numification, Comparison operators, Logical
9861 Operators
9862
9863 =item Quoting
9864
9865 =item Types of Versions Objects
9866
9867 Ordinary versions, alpha versions
9868
9869 =item Replacement UNIVERSAL::VERSION
9870
9871 =back
9872
9873 =item EXPORT
9874
9875 =item AUTHOR
9876
9877 =item SEE ALSO
9878
9879 =back
9880
9881 =head2 vmsish - Perl pragma to control VMS-specific language features
9882
9883 =over 4
9884
9885 =item SYNOPSIS
9886
9887 =item DESCRIPTION
9888
9889 C<vmsish status>, C<vmsish exit>, C<vmsish time>, C<vmsish hushed>
9890
9891 =back
9892
9893 =head2 warnings - Perl pragma to control optional warnings
9894
9895 =over 4
9896
9897 =item SYNOPSIS
9898
9899 =item DESCRIPTION
9900
9901 use warnings::register, warnings::enabled(), warnings::enabled($category),
9902 warnings::enabled($object), warnings::warn($message),
9903 warnings::warn($category, $message), warnings::warn($object, $message),
9904 warnings::warnif($message), warnings::warnif($category, $message),
9905 warnings::warnif($object, $message)
9906
9907 =back
9908
9909 =head2 warnings::register - warnings import function
9910
9911 =over 4
9912
9913 =item SYNOPSIS
9914
9915 =item DESCRIPTION
9916
9917 =back
9918
9919 =head1 MODULE DOCUMENTATION
9920
9921 =head2 AnyDBM_File - provide framework for multiple DBMs
9922
9923 =over 4
9924
9925 =item SYNOPSIS
9926
9927 =item DESCRIPTION
9928
9929 =over 4
9930
9931 =item DBM Comparisons
9932
9933 [0], [1], [2], [3]
9934
9935 =back
9936
9937 =item SEE ALSO
9938
9939 =back
9940
9941 =head2 Attribute::Handlers - Simpler definition of attribute handlers
9942
9943 =over 4
9944
9945 =item VERSION
9946
9947 =item SYNOPSIS
9948
9949 =item DESCRIPTION
9950
9951 [0], [1], [2], [3], [4], [5]
9952
9953 =over 4
9954
9955 =item Typed lexicals
9956
9957 =item Type-specific attribute handlers
9958
9959 =item Non-interpretive attribute handlers
9960
9961 =item Phase-specific attribute handlers
9962
9963 =item Attributes as C<tie> interfaces
9964
9965 =back
9966
9967 =item EXAMPLES
9968
9969 =item DIAGNOSTICS
9970
9971 C<Bad attribute type: ATTR(%s)>, C<Attribute handler %s doesn't handle %s
9972 attributes>, C<Declaration of %s attribute in package %s may clash with
9973 future reserved word>, C<Can't have two ATTR specifiers on one subroutine>,
9974 C<Can't autotie a %s>, C<Internal error: %s symbol went missing>, C<Won't
9975 be able to apply END handler>
9976
9977 =item AUTHOR
9978
9979 =item BUGS
9980
9981 =item COPYRIGHT
9982
9983 =back
9984
9985 =head2 AutoLoader - load subroutines only on demand
9986
9987 =over 4
9988
9989 =item SYNOPSIS
9990
9991 =item DESCRIPTION
9992
9993 =over 4
9994
9995 =item Subroutine Stubs
9996
9997 =item Using B<AutoLoader>'s AUTOLOAD Subroutine
9998
9999 =item Overriding B<AutoLoader>'s AUTOLOAD Subroutine
10000
10001 =item Package Lexicals
10002
10003 =item Not Using AutoLoader
10004
10005 =item B<AutoLoader> vs. B<SelfLoader>
10006
10007 =back
10008
10009 =item CAVEATS
10010
10011 =item SEE ALSO
10012
10013 =back
10014
10015 =head2 AutoSplit - split a package for autoloading
10016
10017 =over 4
10018
10019 =item SYNOPSIS
10020
10021 =item DESCRIPTION
10022
10023 $keep, $check, $modtime
10024
10025 =over 4
10026
10027 =item Multiple packages
10028
10029 =back
10030
10031 =item DIAGNOSTICS
10032
10033 =back
10034
10035 =head2 B - The Perl Compiler
10036
10037 =over 4
10038
10039 =item SYNOPSIS
10040
10041 =item DESCRIPTION
10042
10043 =item OVERVIEW
10044
10045 =item Utility Functions
10046
10047 =over 4
10048
10049 =item Functions Returning C<B::SV>, C<B::AV>, C<B::HV>, and C<B::CV>
10050 objects
10051
10052 sv_undef, sv_yes, sv_no, svref_2object(SVREF), amagic_generation, init_av,
10053 check_av, begin_av, end_av, comppadlist, regex_padav, main_cv
10054
10055 =item Functions for Examining the Symbol Table
10056
10057 walksymtable(SYMREF, METHOD, RECURSE, PREFIX)
10058
10059 =item Functions Returning C<B::OP> objects or for walking op trees
10060
10061 main_root, main_start, walkoptree(OP, METHOD), walkoptree_debug(DEBUG)
10062
10063 =item Miscellaneous Utility Functions
10064
10065 ppname(OPNUM), hash(STR), cast_I32(I), minus_c, cstring(STR),
10066 perlstring(STR), class(OBJ), threadsv_names
10067
10068 =back
10069
10070 =item OVERVIEW OF CLASSES
10071
10072 =over 4
10073
10074 =item SV-RELATED CLASSES
10075
10076 =item B::SV Methods
10077
10078 REFCNT, FLAGS, object_2svref
10079
10080 =item B::IV Methods
10081
10082 IV, IVX, UVX, int_value, needs64bits, packiv
10083
10084 =item B::NV Methods
10085
10086 NV, NVX
10087
10088 =item B::RV Methods
10089
10090 RV
10091
10092 =item B::PV Methods
10093
10094 PV, RV, PVX
10095
10096 =item B::PVMG Methods
10097
10098 MAGIC, SvSTASH
10099
10100 =item B::MAGIC Methods
10101
10102 MOREMAGIC, precomp, PRIVATE, TYPE, FLAGS, OBJ, PTR, REGEX
10103
10104 =item B::PVLV Methods
10105
10106 TARGOFF, TARGLEN, TYPE, TARG
10107
10108 =item B::BM Methods
10109
10110 USEFUL, PREVIOUS, RARE, TABLE
10111
10112 =item B::GV Methods
10113
10114 is_empty, NAME, SAFENAME, STASH, SV, IO, FORM, AV, HV, EGV, CV, CVGEN,
10115 LINE, FILE, FILEGV, GvREFCNT, FLAGS
10116
10117 =item B::IO Methods
10118
10119 LINES, PAGE, PAGE_LEN, LINES_LEFT, TOP_NAME, TOP_GV, FMT_NAME, FMT_GV,
10120 BOTTOM_NAME, BOTTOM_GV, SUBPROCESS, IoTYPE, IoFLAGS, IsSTD
10121
10122 =item B::AV Methods
10123
10124 FILL, MAX, OFF, ARRAY, ARRAYelt, AvFLAGS
10125
10126 =item B::CV Methods
10127
10128 STASH, START, ROOT, GV, FILE, DEPTH, PADLIST, OUTSIDE, OUTSIDE_SEQ, XSUB,
10129 XSUBANY, CvFLAGS, const_sv
10130
10131 =item B::HV Methods
10132
10133 FILL, MAX, KEYS, RITER, NAME, PMROOT, ARRAY
10134
10135 =item OP-RELATED CLASSES
10136
10137 =item B::OP Methods
10138
10139 next, sibling, name, ppaddr, desc, targ, type, seq, flags, private
10140
10141 =item B::UNOP METHOD
10142
10143 first
10144
10145 =item B::BINOP METHOD
10146
10147 last
10148
10149 =item B::LOGOP METHOD
10150
10151 other
10152
10153 =item B::LISTOP METHOD
10154
10155 children
10156
10157 =item B::PMOP Methods
10158
10159 pmreplroot, pmreplstart, pmnext, pmregexp, pmflags, pmdynflags,
10160 pmpermflags, precomp, pmoffset
10161
10162 =item B::SVOP METHOD
10163
10164 sv, gv
10165
10166 =item B::PADOP METHOD
10167
10168 padix
10169
10170 =item B::PVOP METHOD
10171
10172 pv
10173
10174 =item B::LOOP Methods
10175
10176 redoop, nextop, lastop
10177
10178 =item B::COP Methods
10179
10180 label, stash, stashpv, file, cop_seq, arybase, line, warnings, io
10181
10182 =back
10183
10184 =item AUTHOR
10185
10186 =back
10187
10188 =head2 B::Asmdata - Autogenerated data about Perl ops, used to generate
10189 bytecode
10190
10191 =over 4
10192
10193 =item SYNOPSIS
10194
10195 =item DESCRIPTION
10196
10197 %insn_data, @insn_name, @optype, @specialsv_name
10198
10199 =item AUTHOR
10200
10201 =back
10202
10203 =head2 B::Assembler - Assemble Perl bytecode
10204
10205 =over 4
10206
10207 =item SYNOPSIS
10208
10209 =item DESCRIPTION
10210
10211 =item AUTHORS
10212
10213 =back
10214
10215 =head2 B::Bblock - Walk basic blocks
10216
10217 =over 4
10218
10219 =item SYNOPSIS
10220
10221 =item DESCRIPTION
10222
10223 =over 4
10224
10225 =item Functions
10226
10227 B<find_leaders>
10228
10229 =back
10230
10231 =item AUTHOR
10232
10233 =back
10234
10235 =head2 B::Bytecode - Perl compiler's bytecode backend
10236
10237 =over 4
10238
10239 =item SYNOPSIS
10240
10241 =item DESCRIPTION
10242
10243 =item EXAMPLE
10244
10245 =item OPTIONS
10246
10247 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
10248
10249 =item KNOWN BUGS
10250
10251 =item NOTICE
10252
10253 =item AUTHORS
10254
10255 =back
10256
10257 =head2 B::C - Perl compiler's C backend
10258
10259 =over 4
10260
10261 =item SYNOPSIS
10262
10263 =item DESCRIPTION
10264
10265 =item OPTIONS
10266
10267 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-D>, B<-Do>, B<-Dc>, B<-DA>,
10268 B<-DC>, B<-DM>, B<-f>, B<-fcog>, B<-fsave-data>, B<-fppaddr>, B<-fwarn-sv>,
10269 B<-fuse-script-name>, B<-fsave-sig-hash>, B<-On>, B<-O0>, B<-O1>, B<-O2>,
10270 B<-llimit>
10271
10272 =item EXAMPLES
10273
10274 =item BUGS
10275
10276 =item AUTHOR
10277
10278 =back
10279
10280 =head2 B::CC - Perl compiler's optimized C translation backend
10281
10282 =over 4
10283
10284 =item SYNOPSIS
10285
10286 =item DESCRIPTION
10287
10288 =item OPTIONS
10289
10290 B<-ofilename>, B<-v>, B<-->, B<-uPackname>, B<-mModulename>, B<-D>, B<-Dr>,
10291 B<-DO>, B<-Ds>, B<-Dp>, B<-Dq>, B<-Dl>, B<-Dt>, B<-f>,
10292 B<-ffreetmps-each-bblock>, B<-ffreetmps-each-loop>, B<-fomit-taint>, B<-On>
10293
10294 =item EXAMPLES
10295
10296 =item BUGS
10297
10298 =item DIFFERENCES
10299
10300 =over 4
10301
10302 =item Loops
10303
10304 =item Context of ".."
10305
10306 =item Arithmetic
10307
10308 =item Deprecated features
10309
10310 =back
10311
10312 =item AUTHOR
10313
10314 =back
10315
10316 =head2 B::Concise - Walk Perl syntax tree, printing concise info about ops
10317
10318 =over 4
10319
10320 =item SYNOPSIS
10321
10322 =item DESCRIPTION
10323
10324 =item EXAMPLE
10325
10326 =item OPTIONS
10327
10328 B<-basic>, B<-exec>, B<-tree>, B<-compact>, B<-loose>, B<-vt>, B<-ascii>,
10329 B<-main>, B<-base>I<n>, B<-bigendian>, B<-littleendian>, B<-concise>,
10330 B<-terse>, B<-linenoise>, B<-debug>, B<-env>
10331
10332 =item FORMATTING SPECIFICATIONS
10333
10334 B<(x(>I<exec_text>B<;>I<basic_text>B<)x)>, B<(*(>I<text>B<)*)>,
10335 B<(*(>I<text1>B<;>I<text2>B<)*)>, B<(?(>I<text1>B<#>I<var>I<Text2>B<)?)>,
10336 B<#>I<var>, B<#>I<var>I<N>, B<~>, B<#addr>, B<#arg>, B<#class>,
10337 B<#classsym>, B<#coplabel>, B<#exname>, B<#extarg>, B<#firstaddr>,
10338 B<#flags>, B<#flagval>, B<#hyphseq>, B<#label>, B<#lastaddr>, B<#name>,
10339 B<#NAME>, B<#next>, B<#nextaddr>, B<#noise>, B<#private>, B<#privval>,
10340 B<#seq>, B<#seqnum>, B<#sibaddr>, B<#svaddr>, B<#svclass>, B<#svval>,
10341 B<#targ>, B<#targarg>, B<#targarglife>, B<#typenum>
10342
10343 =item ABBREVIATIONS
10344
10345 =over 4
10346
10347 =item OP flags abbreviations
10348
10349 =item OP class abbreviations
10350
10351 =back
10352
10353 =item Using B::Concise outside of the O framework
10354
10355 =item AUTHOR
10356
10357 =back
10358
10359 =head2 B::Debug - Walk Perl syntax tree, printing debug info about ops
10360
10361 =over 4
10362
10363 =item SYNOPSIS
10364
10365 =item DESCRIPTION
10366
10367 =item AUTHOR
10368
10369 =back
10370
10371 =head2 B::Deparse - Perl compiler backend to produce perl code
10372
10373 =over 4
10374
10375 =item SYNOPSIS
10376
10377 =item DESCRIPTION
10378
10379 =item OPTIONS
10380
10381 B<-d>, B<-f>I<FILE>, B<-l>, B<-p>, B<-P>, B<-q>, B<-s>I<LETTERS>, B<C>,
10382 B<i>I<NUMBER>, B<T>, B<v>I<STRING>B<.>, B<-x>I<LEVEL>
10383
10384 =item USING B::Deparse AS A MODULE
10385
10386 =over 4
10387
10388 =item Synopsis
10389
10390 =item Description
10391
10392 =item new
10393
10394 =item ambient_pragmas
10395
10396 strict, $[, bytes, utf8, integer, re, warnings, hint_bits, warning_bits
10397
10398 =item coderef2text
10399
10400 =back
10401
10402 =item BUGS
10403
10404 =item AUTHOR
10405
10406 =back
10407
10408 =head2 B::Disassembler - Disassemble Perl bytecode
10409
10410 =over 4
10411
10412 =item SYNOPSIS
10413
10414 =item DESCRIPTION
10415
10416 =item AUTHOR
10417
10418 =back
10419
10420 =head2 B::Lint - Perl lint
10421
10422 =over 4
10423
10424 =item SYNOPSIS
10425
10426 =item DESCRIPTION
10427
10428 =item OPTIONS AND LINT CHECKS
10429
10430 B<context>, B<implicit-read> and B<implicit-write>, B<bare-subs>,
10431 B<dollar-underscore>, B<private-names>, B<undefined-subs>,
10432 B<regexp-variables>, B<all>, B<none>
10433
10434 =item NON LINT-CHECK OPTIONS
10435
10436 B<-u Package>
10437
10438 =item BUGS
10439
10440 =item AUTHOR
10441
10442 =back
10443
10444 =head2 B::O, O - Generic interface to Perl Compiler backends
10445
10446 =over 4
10447
10448 =item SYNOPSIS
10449
10450 =item DESCRIPTION
10451
10452 =item CONVENTIONS
10453
10454 =item IMPLEMENTATION
10455
10456 =item BUGS
10457
10458 =item AUTHOR
10459
10460 =back
10461
10462 =head2 B::Showlex - Show lexical variables used in functions or files
10463
10464 =over 4
10465
10466 =item SYNOPSIS
10467
10468 =item DESCRIPTION
10469
10470 =item AUTHOR
10471
10472 =back
10473
10474 =head2 B::Stackobj - Helper module for CC backend
10475
10476 =over 4
10477
10478 =item SYNOPSIS
10479
10480 =item DESCRIPTION
10481
10482 =item AUTHOR
10483
10484 =back
10485
10486 =head2 B::Stash - show what stashes are loaded
10487
10488 =head2 B::Terse - Walk Perl syntax tree, printing terse info about ops
10489
10490 =over 4
10491
10492 =item SYNOPSIS
10493
10494 =item DESCRIPTION
10495
10496 =item AUTHOR
10497
10498 =back
10499
10500 =head2 B::Xref - Generates cross reference reports for Perl programs
10501
10502 =over 4
10503
10504 =item SYNOPSIS
10505
10506 =item DESCRIPTION
10507
10508 =item OPTIONS
10509
10510 C<-oFILENAME>, C<-r>, C<-d>, C<-D[tO]>
10511
10512 =item BUGS
10513
10514 =item AUTHOR
10515
10516 =back
10517
10518 =head2 Bblock, B::Bblock - Walk basic blocks
10519
10520 =over 4
10521
10522 =item SYNOPSIS
10523
10524 =item DESCRIPTION
10525
10526 =over 4
10527
10528 =item Functions
10529
10530 B<find_leaders>
10531
10532 =back
10533
10534 =item AUTHOR
10535
10536 =back
10537
10538 =head2 Benchmark - benchmark running times of Perl code
10539
10540 =over 4
10541
10542 =item SYNOPSIS
10543
10544 =item DESCRIPTION
10545
10546 =over 4
10547
10548 =item Methods
10549
10550 new, debug, iters
10551
10552 =item Standard Exports
10553
10554 timeit(COUNT, CODE), timethis ( COUNT, CODE, [ TITLE, [ STYLE ]] ),
10555 timethese ( COUNT, CODEHASHREF, [ STYLE ] ), timediff ( T1, T2 ), timestr (
10556 TIMEDIFF, [ STYLE, [ FORMAT ] ] )
10557
10558 =item Optional Exports
10559
10560 clearcache ( COUNT ), clearallcache ( ), cmpthese ( COUNT, CODEHASHREF, [
10561 STYLE ] ), cmpthese ( RESULTSHASHREF, [ STYLE ] ), countit(TIME, CODE),
10562 disablecache ( ), enablecache ( ), timesum ( T1, T2 )
10563
10564 =item :hireswallclock
10565
10566 =back
10567
10568 =item NOTES
10569
10570 =item EXAMPLES
10571
10572 =item INHERITANCE
10573
10574 =item CAVEATS
10575
10576 =item SEE ALSO
10577
10578 =item AUTHORS
10579
10580 =item MODIFICATION HISTORY
10581
10582 =back
10583
10584 =head2 ByteLoader - load byte compiled perl code
10585
10586 =over 4
10587
10588 =item SYNOPSIS
10589
10590 =item DESCRIPTION
10591
10592 =item AUTHOR
10593
10594 =item SEE ALSO
10595
10596 =back
10597
10598 =head2 Bytecode, B::Bytecode - Perl compiler's bytecode backend
10599
10600 =over 4
10601
10602 =item SYNOPSIS
10603
10604 =item DESCRIPTION
10605
10606 =item EXAMPLE
10607
10608 =item OPTIONS
10609
10610 B<-b>, B<-H>, B<-k>, B<-o>I<outfile>, B<-s>
10611
10612 =item KNOWN BUGS
10613
10614 =item NOTICE
10615
10616 =item AUTHORS
10617
10618 =back
10619
10620 =head2 CGI - Simple Common Gateway Interface Class
10621
10622 =over 4
10623
10624 =item SYNOPSIS
10625
10626 =item ABSTRACT
10627
10628 =item DESCRIPTION
10629
10630 =over 4
10631
10632 =item PROGRAMMING STYLE
10633
10634 =item CALLING CGI.PM ROUTINES
10635
10636 =item CREATING A NEW QUERY OBJECT (OBJECT-ORIENTED STYLE):
10637
10638 =item CREATING A NEW QUERY OBJECT FROM AN INPUT FILE
10639
10640 =item FETCHING A LIST OF KEYWORDS FROM THE QUERY:
10641
10642 =item FETCHING THE NAMES OF ALL THE PARAMETERS PASSED TO YOUR SCRIPT:
10643
10644 =item FETCHING THE VALUE OR VALUES OF A SINGLE NAMED PARAMETER:
10645
10646 =item SETTING THE VALUE(S) OF A NAMED PARAMETER:
10647
10648 =item APPENDING ADDITIONAL VALUES TO A NAMED PARAMETER:
10649
10650 =item IMPORTING ALL PARAMETERS INTO A NAMESPACE:
10651
10652 =item DELETING A PARAMETER COMPLETELY:
10653
10654 =item DELETING ALL PARAMETERS:
10655
10656 =item DIRECT ACCESS TO THE PARAMETER LIST:
10657
10658 =item FETCHING THE PARAMETER LIST AS A HASH:
10659
10660 =item SAVING THE STATE OF THE SCRIPT TO A FILE:
10661
10662 =item RETRIEVING CGI ERRORS
10663
10664 =item USING THE FUNCTION-ORIENTED INTERFACE
10665
10666 B<:cgi>, B<:form>, B<:html2>, B<:html3>, B<:html4>, B<:netscape>, B<:html>,
10667 B<:standard>, B<:all>
10668
10669 =item PRAGMAS
10670
10671 -any, -compile, -nosticky, -no_undef_params, -no_xhtml, -nph,
10672 -newstyle_urls, -oldstyle_urls, -autoload, -no_debug, -debug,
10673 -private_tempfiles
10674
10675 =item SPECIAL FORMS FOR IMPORTING HTML-TAG FUNCTIONS
10676
10677 1. start_table() (generates a <table> tag), 2. end_table() (generates a
10678 </table> tag), 3. start_ul() (generates a <ul> tag), 4. end_ul() (generates
10679 a </ul> tag)
10680
10681 =back
10682
10683 =item GENERATING DYNAMIC DOCUMENTS
10684
10685 =over 4
10686
10687 =item CREATING A STANDARD HTTP HEADER:
10688
10689 =item GENERATING A REDIRECTION HEADER
10690
10691 =item CREATING THE HTML DOCUMENT HEADER
10692
10693 B<Parameters:>, 4, 5, 6..
10694
10695 =item ENDING THE HTML DOCUMENT:
10696
10697 =item CREATING A SELF-REFERENCING URL THAT PRESERVES STATE INFORMATION:
10698
10699 =item OBTAINING THE SCRIPT'S URL
10700
10701 B<-absolute>, B<-relative>, B<-full>, B<-path> (B<-path_info>), B<-query>
10702 (B<-query_string>), B<-base>
10703
10704 =item MIXING POST AND URL PARAMETERS
10705
10706 =back
10707
10708 =item CREATING STANDARD HTML ELEMENTS:
10709
10710 =over 4
10711
10712 =item PROVIDING ARGUMENTS TO HTML SHORTCUTS
10713
10714 =item THE DISTRIBUTIVE PROPERTY OF HTML SHORTCUTS
10715
10716 =item HTML SHORTCUTS AND LIST INTERPOLATION
10717
10718 =item NON-STANDARD HTML SHORTCUTS
10719
10720 =item AUTOESCAPING HTML
10721
10722 $escaped_string = escapeHTML("unescaped string");, $charset =
10723 charset([$charset]);, $flag = autoEscape([$flag]);
10724
10725 =item PRETTY-PRINTING HTML
10726
10727 =back
10728
10729 =item CREATING FILL-OUT FORMS:
10730
10731 =over 4
10732
10733 =item CREATING AN ISINDEX TAG
10734
10735 =item STARTING AND ENDING A FORM
10736
10737 B<application/x-www-form-urlencoded>, B<multipart/form-data>
10738
10739 =item CREATING A TEXT FIELD
10740
10741 B<Parameters>
10742
10743 =item CREATING A BIG TEXT FIELD
10744
10745 =item CREATING A PASSWORD FIELD
10746
10747 =item CREATING A FILE UPLOAD FIELD
10748
10749 B<Parameters>
10750
10751 =item CREATING A POPUP MENU
10752
10753 =item CREATING AN OPTION GROUP
10754
10755 =item CREATING A SCROLLING LIST
10756
10757 B<Parameters:>
10758
10759 =item CREATING A GROUP OF RELATED CHECKBOXES
10760
10761 B<Parameters:>
10762
10763 =item CREATING A STANDALONE CHECKBOX
10764
10765 B<Parameters:>
10766
10767 =item CREATING A RADIO BUTTON GROUP
10768
10769 B<Parameters:>
10770
10771 =item CREATING A SUBMIT BUTTON 
10772
10773 B<Parameters:>
10774
10775 =item CREATING A RESET BUTTON
10776
10777 =item CREATING A DEFAULT BUTTON
10778
10779 =item CREATING A HIDDEN FIELD
10780
10781 B<Parameters:>
10782
10783 =item CREATING A CLICKABLE IMAGE BUTTON
10784
10785 B<Parameters:>, 3. The third option (-align, optional) is an alignment
10786 type, and may be TOP, BOTTOM or MIDDLE
10787
10788 =item CREATING A JAVASCRIPT ACTION BUTTON
10789
10790 =back
10791
10792 =item HTTP COOKIES
10793
10794 1. an expiration time, 2. a domain, 3. a path, 4. a "secure" flag,
10795 B<-name>, B<-value>, B<-path>, B<-domain>, B<-expires>, B<-secure>
10796
10797 =item WORKING WITH FRAMES
10798
10799 1. Create a <Frameset> document, 2. Specify the destination for the
10800 document in the HTTP header, 3. Specify the destination for the document in
10801 the <form> tag
10802
10803 =item LIMITED SUPPORT FOR CASCADING STYLE SHEETS
10804
10805 =item DEBUGGING
10806
10807 =over 4
10808
10809 =item DUMPING OUT ALL THE NAME/VALUE PAIRS
10810
10811 =back
10812
10813 =item FETCHING ENVIRONMENT VARIABLES
10814
10815 B<Accept()>, B<raw_cookie()>, B<user_agent()>, B<path_info()>,
10816 B<path_translated()>, B<remote_host()>, B<script_name()> Return the script
10817 name as a partial URL, for self-refering scripts, B<referer()>, B<auth_type
10818 ()>, B<server_name ()>, B<virtual_host ()>, B<server_port ()>,
10819 B<server_software ()>, B<remote_user ()>, B<user_name ()>,
10820 B<request_method()>, B<content_type()>, B<http()>, B<https()>
10821
10822 =item USING NPH SCRIPTS
10823
10824 In the B<use> statement, By calling the B<nph()> method:, By using B<-nph>
10825 parameters
10826
10827 =item Server Push
10828
10829 multipart_init(), multipart_start(), multipart_end(), multipart_final()
10830
10831 =item Avoiding Denial of Service Attacks
10832
10833 B<$CGI::POST_MAX>, B<$CGI::DISABLE_UPLOADS>, B<1. On a script-by-script
10834 basis>, B<2. Globally for all scripts>
10835
10836 =item COMPATIBILITY WITH CGI-LIB.PL
10837
10838 =item AUTHOR INFORMATION
10839
10840 =item CREDITS
10841
10842 Matt Heffron (heffron@falstaff.css.beckman.com), James Taylor
10843 (james.taylor@srs.gov), Scott Anguish <sanguish@digifix.com>, Mike Jewell
10844 (mlj3u@virginia.edu), Timothy Shimmin (tes@kbs.citri.edu.au), Joergen Haegg
10845 (jh@axis.se), Laurent Delfosse (delfosse@delfosse.com), Richard Resnick
10846 (applepi1@aol.com), Craig Bishop (csb@barwonwater.vic.gov.au), Tony Curtis
10847 (tc@vcpc.univie.ac.at), Tim Bunce (Tim.Bunce@ig.co.uk), Tom Christiansen
10848 (tchrist@convex.com), Andreas Koenig (k@franz.ww.TU-Berlin.DE), Tim
10849 MacKenzie (Tim.MacKenzie@fulcrum.com.au), Kevin B. Hendricks
10850 (kbhend@dogwood.tyler.wm.edu), Stephen Dahmen (joyfire@inxpress.net), Ed
10851 Jordan (ed@fidalgo.net), David Alan Pisoni (david@cnation.com), Doug
10852 MacEachern (dougm@opengroup.org), Robin Houston (robin@oneworld.org),
10853 ...and many many more..
10854
10855 =item A COMPLETE EXAMPLE OF A SIMPLE FORM-BASED SCRIPT
10856
10857 =item BUGS
10858
10859 =item SEE ALSO
10860
10861 =back
10862
10863 =head2 CGI::Apache - Backward compatibility module for CGI.pm
10864
10865 =over 4
10866
10867 =item SYNOPSIS
10868
10869 =item ABSTRACT
10870
10871 =item DESCRIPTION
10872
10873 =item AUTHOR INFORMATION
10874
10875 =item BUGS
10876
10877 =item SEE ALSO
10878
10879 =back
10880
10881 =head2 CGI::Carp, B<CGI::Carp> - CGI routines for writing to the HTTPD (or
10882 other) error log
10883
10884 =over 4
10885
10886 =item SYNOPSIS
10887
10888 =item DESCRIPTION
10889
10890 =item REDIRECTING ERROR MESSAGES
10891
10892 =item MAKING PERL ERRORS APPEAR IN THE BROWSER WINDOW
10893
10894 =over 4
10895
10896 =item Changing the default message
10897
10898 =back
10899
10900 =item MAKING WARNINGS APPEAR AS HTML COMMENTS
10901
10902 =item OVERRIDING THE NAME OF THE PROGRAM
10903
10904 =item AUTHORS
10905
10906 =item SEE ALSO
10907
10908 =back
10909
10910 =head2 CGI::Cookie - Interface to Netscape Cookies
10911
10912 =over 4
10913
10914 =item SYNOPSIS
10915
10916 =item DESCRIPTION
10917
10918 =item USING CGI::Cookie
10919
10920 B<1. expiration date>, B<2. domain>, B<3. path>, B<4. secure flag>
10921
10922 =over 4
10923
10924 =item Creating New Cookies
10925
10926 =item Sending the Cookie to the Browser
10927
10928 =item Recovering Previous Cookies
10929
10930 =item Manipulating Cookies
10931
10932 B<name()>, B<value()>, B<domain()>, B<path()>, B<expires()>
10933
10934 =back
10935
10936 =item AUTHOR INFORMATION
10937
10938 =item BUGS
10939
10940 =item SEE ALSO
10941
10942 =back
10943
10944 =head2 CGI::Fast - CGI Interface for Fast CGI
10945
10946 =over 4
10947
10948 =item SYNOPSIS
10949
10950 =item DESCRIPTION
10951
10952 =item OTHER PIECES OF THE PUZZLE
10953
10954 =item WRITING FASTCGI PERL SCRIPTS
10955
10956 =item INSTALLING FASTCGI SCRIPTS
10957
10958 =item USING FASTCGI SCRIPTS AS CGI SCRIPTS
10959
10960 =item EXTERNAL FASTCGI SERVER INVOCATION
10961
10962 FCGI_SOCKET_PATH, FCGI_LISTEN_QUEUE
10963
10964 =item CAVEATS
10965
10966 =item AUTHOR INFORMATION
10967
10968 =item BUGS
10969
10970 =item SEE ALSO
10971
10972 =back
10973
10974 =head2 CGI::Pretty - module to produce nicely formatted HTML code
10975
10976 =over 4
10977
10978 =item SYNOPSIS
10979
10980 =item DESCRIPTION
10981
10982 =over 4
10983
10984 =item Tags that won't be formatted
10985
10986 =item Customizing the Indenting
10987
10988 =back
10989
10990 =item BUGS
10991
10992 =item AUTHOR
10993
10994 =item SEE ALSO
10995
10996 =back
10997
10998 =head2 CGI::Push - Simple Interface to Server Push
10999
11000 =over 4
11001
11002 =item SYNOPSIS
11003
11004 =item DESCRIPTION
11005
11006 =item USING CGI::Push
11007
11008 -next_page, -last_page, -type, -delay, -cookie, -target, -expires, -nph
11009
11010 =over 4
11011
11012 =item Heterogeneous Pages
11013
11014 =item Changing the Page Delay on the Fly
11015
11016 =back
11017
11018 =item INSTALLING CGI::Push SCRIPTS
11019
11020 =item AUTHOR INFORMATION
11021
11022 =item BUGS
11023
11024 =item SEE ALSO
11025
11026 =back
11027
11028 =head2 CGI::Switch - Backward compatibility module for defunct CGI::Switch
11029
11030 =over 4
11031
11032 =item SYNOPSIS
11033
11034 =item ABSTRACT
11035
11036 =item DESCRIPTION
11037
11038 =item AUTHOR INFORMATION
11039
11040 =item BUGS
11041
11042 =item SEE ALSO
11043
11044 =back
11045
11046 =head2 CGI::Util - Internal utilities used by CGI module
11047
11048 =over 4
11049
11050 =item SYNOPSIS
11051
11052 =item DESCRIPTION
11053
11054 =item AUTHOR INFORMATION
11055
11056 =item SEE ALSO
11057
11058 =back
11059
11060 =head2 CPAN - query, download and build perl modules from CPAN sites
11061
11062 =over 4
11063
11064 =item SYNOPSIS
11065
11066 =item STATUS
11067
11068 =item DESCRIPTION
11069
11070 =over 4
11071
11072 =item Interactive Mode
11073
11074 Searching for authors, bundles, distribution files and modules, make, test,
11075 install, clean  modules or distributions, get, readme, look module or
11076 distribution, ls author, Signals
11077
11078 =item CPAN::Shell
11079
11080 =item autobundle
11081
11082 =item recompile
11083
11084 =item The four C<CPAN::*> Classes: Author, Bundle, Module, Distribution
11085
11086 =item Programmer's interface
11087
11088 expand($type,@things), expandany(@things), Programming Examples
11089
11090 =item Methods in the other Classes
11091
11092 CPAN::Author::as_glimpse(), CPAN::Author::as_string(),
11093 CPAN::Author::email(), CPAN::Author::fullname(), CPAN::Author::name(),
11094 CPAN::Bundle::as_glimpse(), CPAN::Bundle::as_string(),
11095 CPAN::Bundle::clean(), CPAN::Bundle::contains(),
11096 CPAN::Bundle::force($method,@args), CPAN::Bundle::get(),
11097 CPAN::Bundle::inst_file(), CPAN::Bundle::inst_version(),
11098 CPAN::Bundle::uptodate(), CPAN::Bundle::install(), CPAN::Bundle::make(),
11099 CPAN::Bundle::readme(), CPAN::Bundle::test(),
11100 CPAN::Distribution::as_glimpse(), CPAN::Distribution::as_string(),
11101 CPAN::Distribution::clean(), CPAN::Distribution::containsmods(),
11102 CPAN::Distribution::cvs_import(), CPAN::Distribution::dir(),
11103 CPAN::Distribution::force($method,@args), CPAN::Distribution::get(),
11104 CPAN::Distribution::install(), CPAN::Distribution::isa_perl(),
11105 CPAN::Distribution::look(), CPAN::Distribution::make(),
11106 CPAN::Distribution::prereq_pm(), CPAN::Distribution::readme(),
11107 CPAN::Distribution::test(), CPAN::Distribution::uptodate(),
11108 CPAN::Index::force_reload(), CPAN::Index::reload(), CPAN::InfoObj::dump(),
11109 CPAN::Module::as_glimpse(), CPAN::Module::as_string(),
11110 CPAN::Module::clean(), CPAN::Module::cpan_file(),
11111 CPAN::Module::cpan_version(), CPAN::Module::cvs_import(),
11112 CPAN::Module::description(), CPAN::Module::force($method,@args),
11113 CPAN::Module::get(), CPAN::Module::inst_file(),
11114 CPAN::Module::inst_version(), CPAN::Module::install(),
11115 CPAN::Module::look(), CPAN::Module::make(),
11116 CPAN::Module::manpage_headline(), CPAN::Module::readme(),
11117 CPAN::Module::test(), CPAN::Module::uptodate(), CPAN::Module::userid()
11118
11119 =item Cache Manager
11120
11121 =item Bundles
11122
11123 =item Prerequisites
11124
11125 =item Finding packages and VERSION
11126
11127 =item Debugging
11128
11129 =item Floppy, Zip, Offline Mode
11130
11131 =back
11132
11133 =item CONFIGURATION
11134
11135 C<o conf E<lt>scalar optionE<gt>>, C<o conf E<lt>scalar optionE<gt>
11136 E<lt>valueE<gt>>, C<o conf E<lt>list optionE<gt>>, C<o conf E<lt>list
11137 optionE<gt> [shift|pop]>, C<o conf E<lt>list optionE<gt>
11138 [unshift|push|splice] E<lt>listE<gt>>
11139
11140 =over 4
11141
11142 =item Note on urllist parameter's format
11143
11144 =item urllist parameter has CD-ROM support
11145
11146 =back
11147
11148 =item SECURITY
11149
11150 =item EXPORT
11151
11152 =item POPULATE AN INSTALLATION WITH LOTS OF MODULES
11153
11154 =item WORKING WITH CPAN.pm BEHIND FIREWALLS
11155
11156 =over 4
11157
11158 =item Three basic types of firewalls
11159
11160 http firewall, ftp firewall, One way visibility, SOCKS, IP Masquerade
11161
11162 =item Configuring lynx or ncftp for going through a firewall
11163
11164 =back
11165
11166 =item FAQ
11167
11168 1), 2), 3), 4), 5), 6), 7), 8), 9), 10)
11169
11170 =item BUGS
11171
11172 =item AUTHOR
11173
11174 =item TRANSLATIONS
11175
11176 =item SEE ALSO
11177
11178 =back
11179
11180 =head2 CPAN::FirstTime - Utility for CPAN::Config file Initialization
11181
11182 =over 4
11183
11184 =item SYNOPSIS
11185
11186 =item DESCRIPTION
11187
11188 =back
11189
11190 =head2 CPANox, CPAN::Nox - Wrapper around CPAN.pm without using any XS
11191 module
11192
11193 =over 4
11194
11195 =item SYNOPSIS
11196
11197 =item DESCRIPTION
11198
11199 =item  SEE ALSO
11200
11201 =back
11202
11203 =head2 Carp, carp    - warn of errors (from perspective of caller)
11204
11205 =over 4
11206
11207 =item SYNOPSIS
11208
11209 =item DESCRIPTION
11210
11211 =over 4
11212
11213 =item Forcing a Stack Trace
11214
11215 =back
11216
11217 =item BUGS
11218
11219 =back
11220
11221 =head2 Carp::Heavy, Carp heavy machinery - no user serviceable parts inside
11222
11223 =head2 Class::ISA -- report the search path for a class's ISA tree
11224
11225 =over 4
11226
11227 =item SYNOPSIS
11228
11229 =item DESCRIPTION
11230
11231 =item FUNCTIONS
11232
11233 the function Class::ISA::super_path($CLASS), the function
11234 Class::ISA::self_and_super_path($CLASS), the function
11235 Class::ISA::self_and_super_versions($CLASS)
11236
11237 =item CAUTIONARY NOTES
11238
11239 =item COPYRIGHT
11240
11241 =item AUTHOR
11242
11243 =back
11244
11245 =head2 Class::Struct - declare struct-like datatypes as Perl classes
11246
11247 =over 4
11248
11249 =item SYNOPSIS
11250
11251 =item DESCRIPTION
11252
11253 =over 4
11254
11255 =item The C<struct()> function
11256
11257 =item Class Creation at Compile Time
11258
11259 =item Element Types and Accessor Methods
11260
11261 Scalar (C<'$'> or C<'*$'>), Array (C<'@'> or C<'*@'>), Hash (C<'%'> or
11262 C<'*%'>), Class (C<'Class_Name'> or C<'*Class_Name'>)
11263
11264 =item Initializing with C<new>
11265
11266 =back
11267
11268 =item EXAMPLES
11269
11270 Example 1, Example 2, Example 3
11271
11272 =item Author and Modification History
11273
11274 =back
11275
11276 =head2 Config - access Perl configuration information
11277
11278 =over 4
11279
11280 =item SYNOPSIS
11281
11282 =item DESCRIPTION
11283
11284 myconfig(), config_sh(), config_re($regex), config_vars(@names)
11285
11286 =item EXAMPLE
11287
11288 =item WARNING
11289
11290 =item GLOSSARY
11291
11292 =over 4
11293
11294 =item _
11295
11296 C<_a>, C<_exe>, C<_o>
11297
11298 =item a
11299
11300 C<afs>, C<afsroot>, C<alignbytes>, C<ansi2knr>, C<aphostname>,
11301 C<api_revision>, C<api_subversion>, C<api_version>, C<api_versionstring>,
11302 C<ar>, C<archlib>, C<archlibexp>, C<archname64>, C<archname>, C<archobjs>,
11303 C<asctime_r_proto>, C<awk>
11304
11305 =item b
11306
11307 C<baserev>, C<bash>, C<bin>, C<binexp>, C<bison>, C<byacc>, C<byteorder>
11308
11309 =item c
11310
11311 C<c>, C<castflags>, C<cat>, C<cc>, C<cccdlflags>, C<ccdlflags>, C<ccflags>,
11312 C<ccflags_uselargefiles>, C<ccname>, C<ccsymbols>, C<ccversion>, C<cf_by>,
11313 C<cf_email>, C<cf_time>, C<charsize>, C<chgrp>, C<chmod>, C<chown>,
11314 C<clocktype>, C<comm>, C<compress>, C<contains>, C<cp>, C<cpio>, C<cpp>,
11315 C<cpp_stuff>, C<cppccsymbols>, C<cppflags>, C<cpplast>, C<cppminus>,
11316 C<cpprun>, C<cppstdin>, C<cppsymbols>, C<crypt_r_proto>, C<cryptlib>,
11317 C<csh>, C<ctermid_r_proto>, C<ctime_r_proto>
11318
11319 =item d
11320
11321 C<d__fwalk>, C<d_access>, C<d_accessx>, C<d_aintl>, C<d_alarm>,
11322 C<d_archlib>, C<d_asctime_r>, C<d_atolf>, C<d_atoll>, C<d_attribut>,
11323 C<d_bcmp>, C<d_bcopy>, C<d_bsd>, C<d_bsdgetpgrp>, C<d_bsdsetpgrp>,
11324 C<d_bzero>, C<d_casti32>, C<d_castneg>, C<d_charvspr>, C<d_chown>,
11325 C<d_chroot>, C<d_chsize>, C<d_class>, C<d_closedir>, C<d_cmsghdr_s>,
11326 C<d_const>, C<d_copysignl>, C<d_crypt>, C<d_crypt_r>, C<d_csh>,
11327 C<d_ctermid_r>, C<d_ctime_r>, C<d_cuserid>, C<d_dbl_dig>,
11328 C<d_dbminitproto>, C<d_difftime>, C<d_dirfd>, C<d_dirnamlen>, C<d_dlerror>,
11329 C<d_dlopen>, C<d_dlsymun>, C<d_dosuid>, C<d_drand48_r>, C<d_drand48proto>,
11330 C<d_dup2>, C<d_eaccess>, C<d_endgrent>, C<d_endgrent_r>, C<d_endhent>,
11331 C<d_endhostent_r>, C<d_endnent>, C<d_endnetent_r>, C<d_endpent>,
11332 C<d_endprotoent_r>, C<d_endpwent>, C<d_endpwent_r>, C<d_endsent>,
11333 C<d_endservent_r>, C<d_eofnblk>, C<d_eunice>, C<d_faststdio>, C<d_fchdir>,
11334 C<d_fchmod>, C<d_fchown>, C<d_fcntl>, C<d_fcntl_can_lock>, C<d_fd_macros>,
11335 C<d_fd_set>, C<d_fds_bits>, C<d_fgetpos>, C<d_finite>, C<d_finitel>,
11336 C<d_flexfnam>, C<d_flock>, C<d_flockproto>, C<d_fork>, C<d_fp_class>,
11337 C<d_fpathconf>, C<d_fpclass>, C<d_fpclassify>, C<d_fpclassl>,
11338 C<d_fpos64_t>, C<d_frexpl>, C<d_fs_data_s>, C<d_fseeko>, C<d_fsetpos>,
11339 C<d_fstatfs>, C<d_fstatvfs>, C<d_fsync>, C<d_ftello>, C<d_ftime>,
11340 C<d_Gconvert>, C<d_getcwd>, C<d_getespwnam>, C<d_getfsstat>, C<d_getgrent>,
11341 C<d_getgrent_r>, C<d_getgrgid_r>, C<d_getgrnam_r>, C<d_getgrps>,
11342 C<d_gethbyaddr>, C<d_gethbyname>, C<d_gethent>, C<d_gethname>,
11343 C<d_gethostbyaddr_r>, C<d_gethostbyname_r>, C<d_gethostent_r>,
11344 C<d_gethostprotos>, C<d_getitimer>, C<d_getlogin>, C<d_getlogin_r>,
11345 C<d_getmnt>, C<d_getmntent>, C<d_getnbyaddr>, C<d_getnbyname>,
11346 C<d_getnent>, C<d_getnetbyaddr_r>, C<d_getnetbyname_r>, C<d_getnetent_r>,
11347 C<d_getnetprotos>, C<d_getpagsz>, C<d_getpbyname>, C<d_getpbynumber>,
11348 C<d_getpent>, C<d_getpgid>, C<d_getpgrp2>, C<d_getpgrp>, C<d_getppid>,
11349 C<d_getprior>, C<d_getprotobyname_r>, C<d_getprotobynumber_r>,
11350 C<d_getprotoent_r>, C<d_getprotoprotos>, C<d_getprpwnam>, C<d_getpwent>,
11351 C<d_getpwent_r>, C<d_getpwnam_r>, C<d_getpwuid_r>, C<d_getsbyname>,
11352 C<d_getsbyport>, C<d_getsent>, C<d_getservbyname_r>, C<d_getservbyport_r>,
11353 C<d_getservent_r>, C<d_getservprotos>, C<d_getspnam>, C<d_getspnam_r>,
11354 C<d_gettimeod>, C<d_gmtime_r>, C<d_gnulibc>, C<d_grpasswd>, C<d_hasmntopt>,
11355 C<d_htonl>, C<d_ilogbl>, C<d_index>, C<d_inetaton>, C<d_int64_t>,
11356 C<d_isascii>, C<d_isfinite>, C<d_isinf>, C<d_isnan>, C<d_isnanl>,
11357 C<d_killpg>, C<d_lchown>, C<d_ldbl_dig>, C<d_link>, C<d_localtime_r>,
11358 C<d_locconv>, C<d_lockf>, C<d_longdbl>, C<d_longlong>, C<d_lseekproto>,
11359 C<d_lstat>, C<d_madvise>, C<d_mblen>, C<d_mbstowcs>, C<d_mbtowc>,
11360 C<d_memchr>, C<d_memcmp>, C<d_memcpy>, C<d_memmove>, C<d_memset>,
11361 C<d_mkdir>, C<d_mkdtemp>, C<d_mkfifo>, C<d_mkstemp>, C<d_mkstemps>,
11362 C<d_mktime>, C<d_mmap>, C<d_modfl>, C<d_modfl_pow32_bug>, C<d_modflproto>,
11363 C<d_mprotect>, C<d_msg>, C<d_msg_ctrunc>, C<d_msg_dontroute>, C<d_msg_oob>,
11364 C<d_msg_peek>, C<d_msg_proxy>, C<d_msgctl>, C<d_msgget>, C<d_msghdr_s>,
11365 C<d_msgrcv>, C<d_msgsnd>, C<d_msync>, C<d_munmap>, C<d_mymalloc>,
11366 C<d_nice>, C<d_nl_langinfo>, C<d_nv_preserves_uv>, C<d_off64_t>,
11367 C<d_old_pthread_create_joinable>, C<d_oldpthreads>, C<d_oldsock>,
11368 C<d_open3>, C<d_pathconf>, C<d_pause>, C<d_perl_otherlibdirs>,
11369 C<d_phostname>, C<d_pipe>, C<d_poll>, C<d_portable>, C<d_PRId64>,
11370 C<d_PRIeldbl>, C<d_PRIEUldbl>, C<d_PRIfldbl>, C<d_PRIFUldbl>,
11371 C<d_PRIgldbl>, C<d_PRIGUldbl>, C<d_PRIi64>, C<d_PRIo64>, C<d_PRIu64>,
11372 C<d_PRIx64>, C<d_PRIXU64>, C<d_procselfexe>, C<d_pthread_atfork>,
11373 C<d_pthread_attr_setscope>, C<d_pthread_yield>, C<d_pwage>, C<d_pwchange>,
11374 C<d_pwclass>, C<d_pwcomment>, C<d_pwexpire>, C<d_pwgecos>, C<d_pwpasswd>,
11375 C<d_pwquota>, C<d_qgcvt>, C<d_quad>, C<d_random_r>, C<d_readdir64_r>,
11376 C<d_readdir>, C<d_readdir_r>, C<d_readlink>, C<d_readv>, C<d_recvmsg>,
11377 C<d_rename>, C<d_rewinddir>, C<d_rmdir>, C<d_safebcpy>, C<d_safemcpy>,
11378 C<d_sanemcmp>, C<d_sbrkproto>, C<d_scalbnl>, C<d_sched_yield>,
11379 C<d_scm_rights>, C<d_SCNfldbl>, C<d_seekdir>, C<d_select>, C<d_sem>,
11380 C<d_semctl>, C<d_semctl_semid_ds>, C<d_semctl_semun>, C<d_semget>,
11381 C<d_semop>, C<d_sendmsg>, C<d_setegid>, C<d_seteuid>, C<d_setgrent>,
11382 C<d_setgrent_r>, C<d_setgrps>, C<d_sethent>, C<d_sethostent_r>,
11383 C<d_setitimer>, C<d_setlinebuf>, C<d_setlocale>, C<d_setlocale_r>,
11384 C<d_setnent>, C<d_setnetent_r>, C<d_setpent>, C<d_setpgid>, C<d_setpgrp2>,
11385 C<d_setpgrp>, C<d_setprior>, C<d_setproctitle>, C<d_setprotoent_r>,
11386 C<d_setpwent>, C<d_setpwent_r>, C<d_setregid>, C<d_setresgid>,
11387 C<d_setresuid>, C<d_setreuid>, C<d_setrgid>, C<d_setruid>, C<d_setsent>,
11388 C<d_setservent_r>, C<d_setsid>, C<d_setvbuf>, C<d_sfio>, C<d_shm>,
11389 C<d_shmat>, C<d_shmatprototype>, C<d_shmctl>, C<d_shmdt>, C<d_shmget>,
11390 C<d_sigaction>, C<d_sigprocmask>, C<d_sigsetjmp>, C<d_sockatmark>,
11391 C<d_sockatmarkproto>, C<d_socket>, C<d_socklen_t>, C<d_sockpair>,
11392 C<d_socks5_init>, C<d_sqrtl>, C<d_srand48_r>, C<d_srandom_r>,
11393 C<d_sresgproto>, C<d_sresuproto>, C<d_statblks>, C<d_statfs_f_flags>,
11394 C<d_statfs_s>, C<d_statvfs>, C<d_stdio_cnt_lval>, C<d_stdio_ptr_lval>,
11395 C<d_stdio_ptr_lval_nochange_cnt>, C<d_stdio_ptr_lval_sets_cnt>,
11396 C<d_stdio_stream_array>, C<d_stdiobase>, C<d_stdstdio>, C<d_strchr>,
11397 C<d_strcoll>, C<d_strctcpy>, C<d_strerrm>, C<d_strerror>, C<d_strerror_r>,
11398 C<d_strftime>, C<d_strtod>, C<d_strtol>, C<d_strtold>, C<d_strtoll>,
11399 C<d_strtoq>, C<d_strtoul>, C<d_strtoull>, C<d_strtouq>, C<d_strxfrm>,
11400 C<d_suidsafe>, C<d_symlink>, C<d_syscall>, C<d_syscallproto>, C<d_sysconf>,
11401 C<d_sysernlst>, C<d_syserrlst>, C<d_system>, C<d_tcgetpgrp>,
11402 C<d_tcsetpgrp>, C<d_telldir>, C<d_telldirproto>, C<d_time>, C<d_times>,
11403 C<d_tm_tm_gmtoff>, C<d_tm_tm_zone>, C<d_tmpnam_r>, C<d_truncate>,
11404 C<d_ttyname_r>, C<d_tzname>, C<d_u32align>, C<d_ualarm>, C<d_umask>,
11405 C<d_uname>, C<d_union_semun>, C<d_unordered>, C<d_usleep>,
11406 C<d_usleepproto>, C<d_ustat>, C<d_vendorarch>, C<d_vendorbin>,
11407 C<d_vendorlib>, C<d_vendorscript>, C<d_vfork>, C<d_void_closedir>,
11408 C<d_voidsig>, C<d_voidtty>, C<d_volatile>, C<d_vprintf>, C<d_wait4>,
11409 C<d_waitpid>, C<d_wcstombs>, C<d_wctomb>, C<d_writev>, C<d_xenix>, C<date>,
11410 C<db_hashtype>, C<db_prefixtype>, C<db_version_major>, C<db_version_minor>,
11411 C<db_version_patch>, C<defvoidused>, C<direntrytype>, C<dlext>, C<dlsrc>,
11412 C<doublesize>, C<drand01>, C<drand48_r_proto>, C<dynamic_ext>
11413
11414 =item e
11415
11416 C<eagain>, C<ebcdic>, C<echo>, C<egrep>, C<emacs>, C<endgrent_r_proto>,
11417 C<endhostent_r_proto>, C<endnetent_r_proto>, C<endprotoent_r_proto>,
11418 C<endpwent_r_proto>, C<endservent_r_proto>, C<eunicefix>, C<exe_ext>,
11419 C<expr>, C<extensions>, C<extras>
11420
11421 =item f
11422
11423 C<fflushall>, C<fflushNULL>, C<find>, C<firstmakefile>, C<flex>,
11424 C<fpossize>, C<fpostype>, C<freetype>, C<from>, C<full_ar>, C<full_csh>,
11425 C<full_sed>
11426
11427 =item g
11428
11429 C<gccansipedantic>, C<gccosandvers>, C<gccversion>, C<getgrent_r_proto>,
11430 C<getgrgid_r_proto>, C<getgrnam_r_proto>, C<gethostbyaddr_r_proto>,
11431 C<gethostbyname_r_proto>, C<gethostent_r_proto>, C<getlogin_r_proto>,
11432 C<getnetbyaddr_r_proto>, C<getnetbyname_r_proto>, C<getnetent_r_proto>,
11433 C<getprotobyname_r_proto>, C<getprotobynumber_r_proto>,
11434 C<getprotoent_r_proto>, C<getpwent_r_proto>, C<getpwnam_r_proto>,
11435 C<getpwuid_r_proto>, C<getservbyname_r_proto>, C<getservbyport_r_proto>,
11436 C<getservent_r_proto>, C<getspnam_r_proto>, C<gidformat>, C<gidsign>,
11437 C<gidsize>, C<gidtype>, C<glibpth>, C<gmake>, C<gmtime_r_proto>,
11438 C<gnulibc_version>, C<grep>, C<groupcat>, C<groupstype>, C<gzip>
11439
11440 =item h
11441
11442 C<h_fcntl>, C<h_sysfile>, C<hint>, C<hostcat>, C<html1dir>, C<html1direxp>,
11443 C<html3dir>, C<html3direxp>
11444
11445 =item i
11446
11447 C<i16size>, C<i16type>, C<i32size>, C<i32type>, C<i64size>, C<i64type>,
11448 C<i8size>, C<i8type>, C<i_arpainet>, C<i_bsdioctl>, C<i_crypt>, C<i_db>,
11449 C<i_dbm>, C<i_dirent>, C<i_dld>, C<i_dlfcn>, C<i_fcntl>, C<i_float>,
11450 C<i_fp>, C<i_fp_class>, C<i_gdbm>, C<i_grp>, C<i_ieeefp>, C<i_inttypes>,
11451 C<i_langinfo>, C<i_libutil>, C<i_limits>, C<i_locale>, C<i_machcthr>,
11452 C<i_malloc>, C<i_math>, C<i_memory>, C<i_mntent>, C<i_ndbm>, C<i_netdb>,
11453 C<i_neterrno>, C<i_netinettcp>, C<i_niin>, C<i_poll>, C<i_prot>,
11454 C<i_pthread>, C<i_pwd>, C<i_rpcsvcdbm>, C<i_sfio>, C<i_sgtty>, C<i_shadow>,
11455 C<i_socks>, C<i_stdarg>, C<i_stddef>, C<i_stdlib>, C<i_string>,
11456 C<i_sunmath>, C<i_sysaccess>, C<i_sysdir>, C<i_sysfile>, C<i_sysfilio>,
11457 C<i_sysin>, C<i_sysioctl>, C<i_syslog>, C<i_sysmman>, C<i_sysmode>,
11458 C<i_sysmount>, C<i_sysndir>, C<i_sysparam>, C<i_sysresrc>, C<i_syssecrt>,
11459 C<i_sysselct>, C<i_syssockio>, C<i_sysstat>, C<i_sysstatfs>,
11460 C<i_sysstatvfs>, C<i_systime>, C<i_systimek>, C<i_systimes>, C<i_systypes>,
11461 C<i_sysuio>, C<i_sysun>, C<i_sysutsname>, C<i_sysvfs>, C<i_syswait>,
11462 C<i_termio>, C<i_termios>, C<i_time>, C<i_unistd>, C<i_ustat>, C<i_utime>,
11463 C<i_values>, C<i_varargs>, C<i_varhdr>, C<i_vfork>,
11464 C<ignore_versioned_solibs>, C<inc_version_list>, C<inc_version_list_init>,
11465 C<incpath>, C<inews>, C<installarchlib>, C<installbin>, C<installhtml1dir>,
11466 C<installhtml3dir>, C<installman1dir>, C<installman3dir>, C<installprefix>,
11467 C<installprefixexp>, C<installprivlib>, C<installscript>,
11468 C<installsitearch>, C<installsitebin>, C<installsitehtml1dir>,
11469 C<installsitehtml3dir>, C<installsitelib>, C<installsiteman1dir>,
11470 C<installsiteman3dir>, C<installsitescript>, C<installstyle>,
11471 C<installusrbinperl>, C<installvendorarch>, C<installvendorbin>,
11472 C<installvendorhtml1dir>, C<installvendorhtml3dir>, C<installvendorlib>,
11473 C<installvendorman1dir>, C<installvendorman3dir>, C<installvendorscript>,
11474 C<intsize>, C<issymlink>, C<ivdformat>, C<ivsize>, C<ivtype>
11475
11476 =item k
11477
11478 C<known_extensions>, C<ksh>
11479
11480 =item l
11481
11482 C<ld>, C<lddlflags>, C<ldflags>, C<ldflags_uselargefiles>, C<ldlibpthname>,
11483 C<less>, C<lib_ext>, C<libc>, C<libperl>, C<libpth>, C<libs>, C<libsdirs>,
11484 C<libsfiles>, C<libsfound>, C<libspath>, C<libswanted>,
11485 C<libswanted_uselargefiles>, C<line>, C<lint>, C<lkflags>, C<ln>, C<lns>,
11486 C<localtime_r_proto>, C<locincpth>, C<loclibpth>, C<longdblsize>,
11487 C<longlongsize>, C<longsize>, C<lp>, C<lpr>, C<ls>, C<lseeksize>,
11488 C<lseektype>
11489
11490 =item m
11491
11492 C<mail>, C<mailx>, C<make>, C<make_set_make>, C<mallocobj>, C<mallocsrc>,
11493 C<malloctype>, C<man1dir>, C<man1direxp>, C<man1ext>, C<man3dir>,
11494 C<man3direxp>, C<man3ext>
11495
11496 =item M
11497
11498 C<Mcc>, C<mips_type>, C<mistrustnm>, C<mkdir>, C<mmaptype>, C<modetype>,
11499 C<more>, C<multiarch>, C<mv>, C<myarchname>, C<mydomain>, C<myhostname>,
11500 C<myuname>
11501
11502 =item n
11503
11504 C<n>, C<need_va_copy>, C<netdb_hlen_type>, C<netdb_host_type>,
11505 C<netdb_name_type>, C<netdb_net_type>, C<nm>, C<nm_opt>, C<nm_so_opt>,
11506 C<nonxs_ext>, C<nroff>, C<nv_preserves_uv_bits>, C<nveformat>,
11507 C<nvEUformat>, C<nvfformat>, C<nvFUformat>, C<nvgformat>, C<nvGUformat>,
11508 C<nvsize>, C<nvtype>
11509
11510 =item o
11511
11512 C<o_nonblock>, C<obj_ext>, C<old_pthread_create_joinable>, C<optimize>,
11513 C<orderlib>, C<osname>, C<osvers>, C<otherlibdirs>
11514
11515 =item p
11516
11517 C<package>, C<pager>, C<passcat>, C<patchlevel>, C<path_sep>, C<perl5>,
11518 C<perl>, C<perl_patchlevel>
11519
11520 =item P
11521
11522 C<PERL_REVISION>, C<PERL_SUBVERSION>, C<PERL_VERSION>, C<perladmin>,
11523 C<perllibs>, C<perlpath>, C<pg>, C<phostname>, C<pidtype>, C<plibpth>,
11524 C<pm_apiversion>, C<pmake>, C<pr>, C<prefix>, C<prefixexp>, C<privlib>,
11525 C<privlibexp>, C<procselfexe>, C<prototype>, C<ptrsize>
11526
11527 =item q
11528
11529 C<quadkind>, C<quadtype>
11530
11531 =item r
11532
11533 C<randbits>, C<randfunc>, C<random_r_proto>, C<randseedtype>, C<ranlib>,
11534 C<rd_nodata>, C<readdir64_r_proto>, C<readdir_r_proto>, C<revision>, C<rm>,
11535 C<rmail>, C<run>, C<runnm>
11536
11537 =item s
11538
11539 C<sched_yield>, C<scriptdir>, C<scriptdirexp>, C<sed>, C<seedfunc>,
11540 C<selectminbits>, C<selecttype>, C<sendmail>, C<setgrent_r_proto>,
11541 C<sethostent_r_proto>, C<setlocale_r_proto>, C<setnetent_r_proto>,
11542 C<setprotoent_r_proto>, C<setpwent_r_proto>, C<setservent_r_proto>, C<sh>,
11543 C<shar>, C<sharpbang>, C<shmattype>, C<shortsize>, C<shrpenv>, C<shsharp>,
11544 C<sig_count>, C<sig_name>, C<sig_name_init>, C<sig_num>, C<sig_num_init>,
11545 C<sig_size>, C<signal_t>, C<sitearch>, C<sitearchexp>, C<sitebin>,
11546 C<sitebinexp>, C<sitehtml1dir>, C<sitehtml1direxp>, C<sitehtml3dir>,
11547 C<sitehtml3direxp>, C<sitelib>, C<sitelib_stem>, C<sitelibexp>,
11548 C<siteman1dir>, C<siteman1direxp>, C<siteman3dir>, C<siteman3direxp>,
11549 C<siteprefix>, C<siteprefixexp>, C<sitescript>, C<sitescriptexp>,
11550 C<sizesize>, C<sizetype>, C<sleep>, C<smail>, C<so>, C<sockethdr>,
11551 C<socketlib>, C<socksizetype>, C<sort>, C<spackage>, C<spitshell>,
11552 C<sPRId64>, C<sPRIeldbl>, C<sPRIEUldbl>, C<sPRIfldbl>, C<sPRIFUldbl>,
11553 C<sPRIgldbl>, C<sPRIGUldbl>, C<sPRIi64>, C<sPRIo64>, C<sPRIu64>,
11554 C<sPRIx64>, C<sPRIXU64>, C<srand48_r_proto>, C<srandom_r_proto>, C<src>,
11555 C<sSCNfldbl>, C<ssizetype>, C<startperl>, C<startsh>, C<static_ext>,
11556 C<stdchar>, C<stdio_base>, C<stdio_bufsiz>, C<stdio_cnt>, C<stdio_filbuf>,
11557 C<stdio_ptr>, C<stdio_stream_array>, C<strerror_r_proto>, C<strings>,
11558 C<submit>, C<subversion>, C<sysman>
11559
11560 =item t
11561
11562 C<tail>, C<tar>, C<targetarch>, C<tbl>, C<tee>, C<test>, C<timeincl>,
11563 C<timetype>, C<tmpnam_r_proto>, C<to>, C<touch>, C<tr>, C<trnl>, C<troff>,
11564 C<ttyname_r_proto>
11565
11566 =item u
11567
11568 C<u16size>, C<u16type>, C<u32size>, C<u32type>, C<u64size>, C<u64type>,
11569 C<u8size>, C<u8type>, C<uidformat>, C<uidsign>, C<uidsize>, C<uidtype>,
11570 C<uname>, C<uniq>, C<uquadtype>, C<use5005threads>, C<use64bitall>,
11571 C<use64bitint>, C<usecrosscompile>, C<usedl>, C<usefaststdio>,
11572 C<useithreads>, C<uselargefiles>, C<uselongdouble>, C<usemorebits>,
11573 C<usemultiplicity>, C<usemymalloc>, C<usenm>, C<useopcode>, C<useperlio>,
11574 C<useposix>, C<usereentrant>, C<usesfio>, C<useshrplib>, C<usesocks>,
11575 C<usethreads>, C<usevendorprefix>, C<usevfork>, C<usrinc>, C<uuname>,
11576 C<uvoformat>, C<uvsize>, C<uvtype>, C<uvuformat>, C<uvxformat>,
11577 C<uvXUformat>
11578
11579 =item v
11580
11581 C<vendorarch>, C<vendorarchexp>, C<vendorbin>, C<vendorbinexp>,
11582 C<vendorhtml1dir>, C<vendorhtml1direxp>, C<vendorhtml3dir>,
11583 C<vendorhtml3direxp>, C<vendorlib>, C<vendorlib_stem>, C<vendorlibexp>,
11584 C<vendorman1dir>, C<vendorman1direxp>, C<vendorman3dir>,
11585 C<vendorman3direxp>, C<vendorprefix>, C<vendorprefixexp>, C<vendorscript>,
11586 C<vendorscriptexp>, C<version>, C<version_patchlevel_string>,
11587 C<versiononly>, C<vi>, C<voidflags>
11588
11589 =item x
11590
11591 C<xlibpth>, C<xs_apiversion>
11592
11593 =item y
11594
11595 C<yacc>, C<yaccflags>
11596
11597 =item z
11598
11599 C<zcat>, C<zip>
11600
11601 =back
11602
11603 =item NOTE
11604
11605 =back
11606
11607 =head2 Cwd - get pathname of current working directory
11608
11609 =over 4
11610
11611 =item SYNOPSIS
11612
11613 =item DESCRIPTION
11614
11615 =over 4
11616
11617 =item getcwd and friends
11618
11619 getcwd, cwd, fastcwd, fastgetcwd
11620
11621 =item abs_path and friends
11622
11623 abs_path, realpath, fast_abs_path
11624
11625 =item $ENV{PWD}
11626
11627 =back
11628
11629 =item NOTES
11630
11631 =item SEE ALSO
11632
11633 =back
11634
11635 =head2 DB - programmatic interface to the Perl debugging API (draft,
11636 subject to
11637 change)
11638
11639 =over 4
11640
11641 =item SYNOPSIS
11642
11643 =item DESCRIPTION
11644
11645 =over 4
11646
11647 =item Global Variables
11648
11649  $DB::sub,  %DB::sub,  $DB::single,  $DB::signal,  $DB::trace,  @DB::args, 
11650 @DB::dbline,  %DB::dbline,  $DB::package,  $DB::filename,  $DB::subname, 
11651 $DB::lineno
11652
11653 =item API Methods
11654
11655 CLIENT->register(), CLIENT->evalcode(STRING), CLIENT->skippkg('D::hide'),
11656 CLIENT->run(), CLIENT->step(), CLIENT->next(), CLIENT->done()
11657
11658 =item Client Callback Methods
11659
11660 CLIENT->init(), CLIENT->prestop([STRING]), CLIENT->stop(), CLIENT->idle(),
11661 CLIENT->poststop([STRING]), CLIENT->evalcode(STRING), CLIENT->cleanup(),
11662 CLIENT->output(LIST)
11663
11664 =back
11665
11666 =item BUGS
11667
11668 =item AUTHOR
11669
11670 =back
11671
11672 =head2 DB_File - Perl5 access to Berkeley DB version 1.x
11673
11674 =over 4
11675
11676 =item SYNOPSIS
11677
11678 =item DESCRIPTION
11679
11680 B<DB_HASH>, B<DB_BTREE>, B<DB_RECNO>
11681
11682 =over 4
11683
11684 =item Using DB_File with Berkeley DB version 2 or greater
11685
11686 =item Interface to Berkeley DB
11687
11688 =item Opening a Berkeley DB Database File
11689
11690 =item Default Parameters
11691
11692 =item In Memory Databases
11693
11694 =back
11695
11696 =item DB_HASH
11697
11698 =over 4
11699
11700 =item A Simple Example
11701
11702 =back
11703
11704 =item DB_BTREE
11705
11706 =over 4
11707
11708 =item Changing the BTREE sort order
11709
11710 =item Handling Duplicate Keys 
11711
11712 =item The get_dup() Method
11713
11714 =item The find_dup() Method
11715
11716 =item The del_dup() Method
11717
11718 =item Matching Partial Keys 
11719
11720 =back
11721
11722 =item DB_RECNO
11723
11724 =over 4
11725
11726 =item The 'bval' Option
11727
11728 =item A Simple Example
11729
11730 =item Extra RECNO Methods
11731
11732 B<$X-E<gt>push(list) ;>, B<$value = $X-E<gt>pop ;>, B<$X-E<gt>shift>,
11733 B<$X-E<gt>unshift(list) ;>, B<$X-E<gt>length>, B<$X-E<gt>splice(offset,
11734 length, elements);>
11735
11736 =item Another Example
11737
11738 =back
11739
11740 =item THE API INTERFACE
11741
11742 B<$status = $X-E<gt>get($key, $value [, $flags]) ;>, B<$status =
11743 $X-E<gt>put($key, $value [, $flags]) ;>, B<$status = $X-E<gt>del($key [,
11744 $flags]) ;>, B<$status = $X-E<gt>fd ;>, B<$status = $X-E<gt>seq($key,
11745 $value, $flags) ;>, B<$status = $X-E<gt>sync([$flags]) ;>
11746
11747 =item DBM FILTERS
11748
11749 B<filter_store_key>, B<filter_store_value>, B<filter_fetch_key>,
11750 B<filter_fetch_value>
11751
11752 =over 4
11753
11754 =item The Filter
11755
11756 =item An Example -- the NULL termination problem.
11757
11758 =item Another Example -- Key is a C int.
11759
11760 =back
11761
11762 =item HINTS AND TIPS 
11763
11764 =over 4
11765
11766 =item Locking: The Trouble with fd
11767
11768 =item Safe ways to lock a database
11769
11770 B<Tie::DB_Lock>, B<Tie::DB_LockFile>, B<DB_File::Lock>
11771
11772 =item Sharing Databases With C Applications
11773
11774 =item The untie() Gotcha
11775
11776 =back
11777
11778 =item COMMON QUESTIONS
11779
11780 =over 4
11781
11782 =item Why is there Perl source in my database?
11783
11784 =item How do I store complex data structures with DB_File?
11785
11786 =item What does "Invalid Argument" mean?
11787
11788 =item What does "Bareword 'DB_File' not allowed" mean? 
11789
11790 =back
11791
11792 =item REFERENCES
11793
11794 =item HISTORY
11795
11796 =item BUGS
11797
11798 =item AVAILABILITY
11799
11800 =item COPYRIGHT
11801
11802 =item SEE ALSO
11803
11804 =item AUTHOR
11805
11806 =back
11807
11808 =head2 Data::Dumper - stringified perl data structures, suitable for both
11809 printing and C<eval>
11810
11811 =over 4
11812
11813 =item SYNOPSIS
11814
11815 =item DESCRIPTION
11816
11817 =over 4
11818
11819 =item Methods
11820
11821 I<PACKAGE>->new(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Dump  I<or> 
11822 I<PACKAGE>->Dump(I<ARRAYREF [>, I<ARRAYREF]>), I<$OBJ>->Seen(I<[HASHREF]>),
11823 I<$OBJ>->Values(I<[ARRAYREF]>), I<$OBJ>->Names(I<[ARRAYREF]>),
11824 I<$OBJ>->Reset
11825
11826 =item Functions
11827
11828 Dumper(I<LIST>)
11829
11830 =item Configuration Variables or Methods
11831
11832 =item Exports
11833
11834 Dumper
11835
11836 =back
11837
11838 =item EXAMPLES
11839
11840 =item BUGS
11841
11842 =over 4
11843
11844 =item NOTE
11845
11846 =back
11847
11848 =item AUTHOR
11849
11850 =item VERSION
11851
11852 =item SEE ALSO
11853
11854 =back
11855
11856 =head2 Devel::DProf - a Perl code profiler
11857
11858 =over 4
11859
11860 =item SYNOPSIS
11861
11862 =item DESCRIPTION
11863
11864 =item PROFILE FORMAT
11865
11866 =item AUTOLOAD
11867
11868 =item ENVIRONMENT
11869
11870 =item BUGS
11871
11872 =item SEE ALSO
11873
11874 =back
11875
11876 =head2 Devel::PPPort - Perl/Pollution/Portability
11877
11878 =over 4
11879
11880 =item SYNOPSIS
11881
11882 =item DESCRIPTION
11883
11884 =over 4
11885
11886 =item WriteFile
11887
11888 =back
11889
11890 =item ppport.h
11891
11892 =item AUTHOR
11893
11894 =item SEE ALSO
11895
11896 =back
11897
11898 =head2 Devel::Peek - A data debugging tool for the XS programmer
11899
11900 =over 4
11901
11902 =item SYNOPSIS
11903
11904 =item DESCRIPTION
11905
11906 =over 4
11907
11908 =item Runtime debugging
11909
11910 =item Memory footprint debugging
11911
11912 =back
11913
11914 =item EXAMPLES
11915
11916 =over 4
11917
11918 =item A simple scalar string
11919
11920 =item A simple scalar number
11921
11922 =item A simple scalar with an extra reference
11923
11924 =item A reference to a simple scalar
11925
11926 =item A reference to an array
11927
11928 =item A reference to a hash
11929
11930 =item Dumping a large array or hash
11931
11932 =item A reference to an SV which holds a C pointer
11933
11934 =item A reference to a subroutine
11935
11936 =back
11937
11938 =item EXPORTS
11939
11940 =item BUGS
11941
11942 =item AUTHOR
11943
11944 =item SEE ALSO
11945
11946 =back
11947
11948 =head2 Devel::SelfStubber - generate stubs for a SelfLoading module
11949
11950 =over 4
11951
11952 =item SYNOPSIS
11953
11954 =item DESCRIPTION
11955
11956 =back
11957
11958 =head2 Digest:: - Modules that calculate message digests
11959
11960 =over 4
11961
11962 =item SYNOPSIS
11963
11964 =item DESCRIPTION
11965
11966 I<binary>, I<hex>, I<base64>
11967
11968 =item OO INTERFACE
11969
11970 $ctx = Digest->XXX($arg,...), $ctx = Digest->new(XXX => $arg,...), $ctx =
11971 Digest::XXX->new($arg,...), $other_ctx = $ctx->clone, $ctx->reset,
11972 $ctx->add($data,...), $ctx->addfile($io_handle), $ctx->digest,
11973 $ctx->hexdigest, $ctx->b64digest
11974
11975 =item SEE ALSO
11976
11977 =item AUTHOR
11978
11979 =back
11980
11981 =head2 Digest::MD5 - Perl interface to the MD5 Algorithm
11982
11983 =over 4
11984
11985 =item SYNOPSIS
11986
11987 =item DESCRIPTION
11988
11989 =item FUNCTIONS
11990
11991 md5($data,...), md5_hex($data,...), md5_base64($data,...)
11992
11993 =item METHODS
11994
11995 $md5 = Digest::MD5->new, $md5->reset, $md5->clone, $md5->add($data,...),
11996 $md5->addfile($io_handle), $md5->digest, $md5->hexdigest, $md5->b64digest
11997
11998 =item EXAMPLES
11999
12000 =item SEE ALSO
12001
12002 =item COPYRIGHT
12003
12004 =item AUTHORS
12005
12006 =back
12007
12008 =head2 DirHandle - supply object methods for directory handles
12009
12010 =over 4
12011
12012 =item SYNOPSIS
12013
12014 =item DESCRIPTION
12015
12016 =item NOTES
12017
12018 =back
12019
12020 =head2 Dumpvalue - provides screen dump of Perl data.
12021
12022 =over 4
12023
12024 =item SYNOPSIS
12025
12026 =item DESCRIPTION
12027
12028 =over 4
12029
12030 =item Creation
12031
12032 C<arrayDepth>, C<hashDepth>, C<compactDump>, C<veryCompact>, C<globPrint>,
12033 C<dumpDBFiles>, C<dumpPackages>, C<dumpReused>, C<tick>, C<quoteHighBit>,
12034 C<printUndef>, C<usageOnly>, unctrl, subdump, bareStringify, quoteHighBit,
12035 stopDbSignal
12036
12037 =item Methods
12038
12039 dumpValue, dumpValues, stringify, dumpvars, set_quote, set_unctrl,
12040 compactDump, veryCompact, set, get
12041
12042 =back
12043
12044 =back
12045
12046 =head2 DynaLoader - Dynamically load C libraries into Perl code
12047
12048 =over 4
12049
12050 =item SYNOPSIS
12051
12052 =item DESCRIPTION
12053
12054 @dl_library_path, @dl_resolve_using, @dl_require_symbols, @dl_librefs,
12055 @dl_modules, dl_error(), $dl_debug, dl_findfile(), dl_expandspec(),
12056 dl_load_file(), dl_unload_file(), dl_load_flags(), dl_find_symbol(),
12057 dl_find_symbol_anywhere(), dl_undef_symbols(), dl_install_xsub(),
12058 bootstrap()
12059
12060 =item AUTHOR
12061
12062 =back
12063
12064 =head2 DynaLoader::XSLoader, XSLoader - Dynamically load C libraries into
12065 Perl code
12066
12067 =over 4
12068
12069 =item SYNOPSIS
12070
12071 =item DESCRIPTION
12072
12073 =over 4
12074
12075 =item Migration from C<DynaLoader>
12076
12077 =item Backward compatible boilerplate
12078
12079 =back
12080
12081 =item Order of initialization: early load()
12082
12083 =over 4
12084
12085 =item The most hairy case
12086
12087 =back
12088
12089 =item LIMITATIONS
12090
12091 =item AUTHOR
12092
12093 =back
12094
12095 =head2 Encode - character encodings
12096
12097 =over 4
12098
12099 =item SYNOPSIS
12100
12101 =over 4
12102
12103 =item Table of Contents
12104
12105 =back
12106
12107 =item DESCRIPTION
12108
12109 =over 4
12110
12111 =item TERMINOLOGY
12112
12113 =back
12114
12115 =item PERL ENCODING API
12116
12117 $octets  = encode(ENCODING, $string [, CHECK]), $string = decode(ENCODING,
12118 $octets [, CHECK]), [$length =] from_to($octets, FROM_ENC, TO_ENC [,
12119 CHECK]), $octets = encode_utf8($string);, $string = decode_utf8($octets [,
12120 CHECK]);
12121
12122 =over 4
12123
12124 =item Listing available encodings
12125
12126 =item Defining Aliases
12127
12128 =back
12129
12130 =item Encoding via PerlIO
12131
12132 =item Handling Malformed Data
12133
12134 I<CHECK> = Encode::FB_DEFAULT ( == 0), I<CHECK> = Encode::FB_CROAK ( == 1),
12135 I<CHECK> = Encode::FB_QUIET, I<CHECK> = Encode::FB_WARN, perlqq mode
12136 (I<CHECK> = Encode::FB_PERLQQ), HTML charref mode (I<CHECK> =
12137 Encode::FB_HTMLCREF), XML charref mode (I<CHECK> = Encode::FB_XMLCREF), The
12138 bitmask
12139
12140 =over 4
12141
12142 =item Unimplemented fallback schemes
12143
12144 =back
12145
12146 =item Defining Encodings
12147
12148 =item The UTF-8 flag
12149
12150 Goal #1:, Goal #2:, Goal #3:, Goal #4:
12151
12152 =over 4
12153
12154 =item Messing with Perl's Internals
12155
12156 is_utf8(STRING [, CHECK]), _utf8_on(STRING), _utf8_off(STRING)
12157
12158 =back
12159
12160 =item SEE ALSO
12161
12162 =item MAINTAINER
12163
12164 =back
12165
12166 =head2 Encode::Alias - alias definitions to encodings
12167
12168 =over 4
12169
12170 =item SYNOPSIS
12171
12172 =item DESCRIPTION
12173
12174 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
12175 reference, e.g.:
12176
12177 =over 4
12178
12179 =item Alias overloading
12180
12181 =back
12182
12183 =item SEE ALSO
12184
12185 =back
12186
12187 =head2 Encode::Byte - Single Byte Encodings
12188
12189 =over 4
12190
12191 =item SYNOPSIS
12192
12193 =item ABSTRACT
12194
12195 =item DESCRIPTION
12196
12197 =item SEE ALSO
12198
12199 =back
12200
12201 =head2 Encode::CJKConstants -- Internally used by Encode::??::ISO_2022_*
12202
12203 =head2 Encode::CN - China-based Chinese Encodings
12204
12205 =over 4
12206
12207 =item SYNOPSIS
12208
12209 =item DESCRIPTION
12210
12211 =item NOTES
12212
12213 =item BUGS
12214
12215 =item SEE ALSO
12216
12217 =back
12218
12219 =head2 Encode::CN::HZ -- internally used by Encode::CN
12220
12221 =head2 Encode::Config -- internally used by Encode
12222
12223 =head2 Encode::EBCDIC - EBCDIC Encodings
12224
12225 =over 4
12226
12227 =item SYNOPSIS
12228
12229 =item ABSTRACT
12230
12231 =item DESCRIPTION
12232
12233 =item SEE ALSO
12234
12235 =back
12236
12237 =head2 Encode::Encoding - Encode Implementation Base Class
12238
12239 =over 4
12240
12241 =item SYNOPSIS
12242
12243 =item DESCRIPTION
12244
12245 =over 4
12246
12247 =item Methods you should implement
12248
12249 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
12250 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
12251
12252 =item Other methods defined in Encode::Encodings
12253
12254 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
12255
12256 =item Example: Encode::ROT13
12257
12258 =back
12259
12260 =item Why the heck Encode API is different?
12261
12262 =over 4
12263
12264 =item Compiled Encodings
12265
12266 =back
12267
12268 =item SEE ALSO
12269
12270 Scheme 1, Scheme 2, Other Schemes
12271
12272 =back
12273
12274 =head2 Encode::Guess -- Guesses encoding from data
12275
12276 =over 4
12277
12278 =item SYNOPSIS
12279
12280 =item ABSTRACT
12281
12282 =item DESCRIPTION
12283
12284 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
12285 Encode::decode("Guess" ...), Encode::Guess->guess($data),
12286 guess_encoding($data, [, I<list of suspects>])
12287
12288 =item CAVEATS
12289
12290 =item TO DO
12291
12292 =item SEE ALSO
12293
12294 =back
12295
12296 =head2 Encode::JP - Japanese Encodings
12297
12298 =over 4
12299
12300 =item SYNOPSIS
12301
12302 =item ABSTRACT
12303
12304 =item DESCRIPTION
12305
12306 =item Note on ISO-2022-JP(-1)?
12307
12308 =item BUGS
12309
12310 =item SEE ALSO
12311
12312 =back
12313
12314 =head2 Encode::JP::H2Z -- internally used by Encode::JP::2022_JP*
12315
12316 =head2 Encode::JP::JIS7 -- internally used by Encode::JP
12317
12318 =head2 Encode::KR - Korean Encodings
12319
12320 =over 4
12321
12322 =item SYNOPSIS
12323
12324 =item DESCRIPTION
12325
12326 =item BUGS
12327
12328 =item SEE ALSO
12329
12330 =back
12331
12332 =head2 Encode::KR::2022_KR -- internally used by Encode::KR
12333
12334 =head2 Encode::MIME::Header -- MIME 'B' and 'Q' header encoding
12335
12336 =over 4
12337
12338 =item SYNOPSIS
12339
12340 =item ABSTRACT
12341
12342 =item DESCRIPTION
12343
12344 =item BUGS
12345
12346 =item SEE ALSO
12347
12348 =back
12349
12350 =head2 Encode::PerlIO -- a detailed document 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::Supported -- Encodings supported by Encode
12371
12372 =over 4
12373
12374 =item DESCRIPTION
12375
12376 =over 4
12377
12378 =item Encoding Names
12379
12380 =back
12381
12382 =item Supported Encodings
12383
12384 =over 4
12385
12386 =item Built-in Encodings
12387
12388 =item Encode::Unicode -- other Unicode encodings
12389
12390 =item Encode::Byte -- Extended ASCII
12391
12392 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
12393 the Cyrillic world, gsm0338 - Hentai Latin 1
12394
12395 =item CJK: Chinese, Japanese, Korean (Multibyte)
12396
12397 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
12398 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
12399 Encode::JIS2K -- JIS X 0213 encodings via CPAN
12400
12401 =item Miscellaneous encodings
12402
12403 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
12404
12405 =back
12406
12407 =item Unsupported encodings
12408
12409   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
12410 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
12411 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
12412 Various Mac encodings, (Mac) Indic encodings
12413
12414 =item Encoding vs. Charset -- terminology
12415
12416 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
12417
12418 =over 4
12419
12420 =item Microsoft-related naming mess
12421
12422 KS_C_5601-1987, GB2312, Big5, Shift_JIS
12423
12424 =back
12425
12426 =item Glossary
12427
12428 character repertoire, coded character set (CCS), character encoding scheme
12429 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
12430 UTF-16
12431
12432 =item See Also
12433
12434 =item References
12435
12436 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
12437 RFC, UC, Unicode Glossary
12438
12439 =over 4
12440
12441 =item Other Notable Sites
12442
12443 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
12444 "Introduction to i18n"
12445
12446 =item Offline sources
12447
12448 C<CJKV Information Processing> by Ken Lunde
12449
12450 =back
12451
12452 =back
12453
12454 =head2 Encode::Symbol - Symbol Encodings
12455
12456 =over 4
12457
12458 =item SYNOPSIS
12459
12460 =item ABSTRACT
12461
12462 =item DESCRIPTION
12463
12464 =item SEE ALSO
12465
12466 =back
12467
12468 =head2 Encode::TW - Taiwan-based Chinese Encodings
12469
12470 =over 4
12471
12472 =item SYNOPSIS
12473
12474 =item DESCRIPTION
12475
12476 =item NOTES
12477
12478 =item BUGS
12479
12480 =item SEE ALSO
12481
12482 =back
12483
12484 =head2 Encode::Unicode -- Various Unicode Transformation Formats
12485
12486 =over 4
12487
12488 =item SYNOPSIS
12489
12490 =item ABSTRACT
12491
12492 L<http://www.unicode.org/glossary/> says:, Quick Reference
12493
12494 =item Size, Endianness, and BOM
12495
12496 =over 4
12497
12498 =item by size
12499
12500 =item by endianness
12501
12502 BOM as integer when fetched in network byte order
12503
12504 =back
12505
12506 =item Surrogate Pairs
12507
12508 =item SEE ALSO
12509
12510 =back
12511
12512 =head2 Encode::Unicode::UTF7 -- UTF-7 encoding
12513
12514 =over 4
12515
12516 =item SYNOPSIS
12517
12518 =item ABSTRACT
12519
12520 =item In Practice
12521
12522 =item SEE ALSO
12523
12524 =back
12525
12526 =head2 Encode::lib::Encode::Alias, Encode::Alias - alias definitions to
12527 encodings
12528
12529 =over 4
12530
12531 =item SYNOPSIS
12532
12533 =item DESCRIPTION
12534
12535 As a simple string, As a qr// compiled regular expression, e.g.:, As a code
12536 reference, e.g.:
12537
12538 =over 4
12539
12540 =item Alias overloading
12541
12542 =back
12543
12544 =item SEE ALSO
12545
12546 =back
12547
12548 =head2 Encode::lib::Encode::CJKConstants, Encode::CJKConstants.pm --
12549 Internally used by Encode::??::ISO_2022_*
12550
12551 =head2 Encode::lib::Encode::CN::HZ, Encode::CN::HZ -- internally used by
12552 Encode::CN
12553
12554 =head2 Encode::lib::Encode::Config, Encode::Config -- internally used by
12555 Encode
12556
12557 =head2 Encode::lib::Encode::Encoding, Encode::Encoding - Encode
12558 Implementation Base Class
12559
12560 =over 4
12561
12562 =item SYNOPSIS
12563
12564 =item DESCRIPTION
12565
12566 =over 4
12567
12568 =item Methods you should implement
12569
12570 -E<gt>encode($string [,$check]), -E<gt>decode($octets [,$check]),
12571 -E<gt>cat_decode($destination, $octets, $offset, $terminator [,$check])
12572
12573 =item Other methods defined in Encode::Encodings
12574
12575 -E<gt>name, -E<gt>renew, -E<gt>perlio_ok(), -E<gt>needs_lines()
12576
12577 =item Example: Encode::ROT13
12578
12579 =back
12580
12581 =item Why the heck Encode API is different?
12582
12583 =over 4
12584
12585 =item Compiled Encodings
12586
12587 =back
12588
12589 =item SEE ALSO
12590
12591 Scheme 1, Scheme 2, Other Schemes
12592
12593 =back
12594
12595 =head2 Encode::lib::Encode::Guess, Encode::Guess -- Guesses encoding from
12596 data
12597
12598 =over 4
12599
12600 =item SYNOPSIS
12601
12602 =item ABSTRACT
12603
12604 =item DESCRIPTION
12605
12606 Encode::Guess->set_suspects, Encode::Guess->add_suspects,
12607 Encode::decode("Guess" ...), Encode::Guess->guess($data),
12608 guess_encoding($data, [, I<list of suspects>])
12609
12610 =item CAVEATS
12611
12612 =item TO DO
12613
12614 =item SEE ALSO
12615
12616 =back
12617
12618 =head2 Encode::lib::Encode::JP::H2Z, Encode::JP::H2Z -- internally used by
12619 Encode::JP::2022_JP*
12620
12621 =head2 Encode::lib::Encode::JP::JIS7, Encode::JP::JIS7 -- internally used
12622 by Encode::JP
12623
12624 =head2 Encode::lib::Encode::KR::2022_KR, Encode::KR::2022_KR -- internally
12625 used by Encode::KR
12626
12627 =head2 Encode::lib::Encode::MIME::Header, Encode::MIME::Header -- MIME 'B'
12628 and 'Q' header encoding
12629
12630 =over 4
12631
12632 =item SYNOPSIS
12633
12634 =item ABSTRACT
12635
12636 =item DESCRIPTION
12637
12638 =item BUGS
12639
12640 =item SEE ALSO
12641
12642 =back
12643
12644 =head2 Encode::lib::Encode::PerlIO, Encode::PerlIO -- a detailed document
12645 on Encode and PerlIO
12646
12647 =over 4
12648
12649 =item Overview
12650
12651 =item How does it work?
12652
12653 =item Line Buffering
12654
12655 =over 4
12656
12657 =item How can I tell whether my encoding fully supports PerlIO ?
12658
12659 =back
12660
12661 =item SEE ALSO
12662
12663 =back
12664
12665 =head2 Encode::lib::Encode::Supported, Encode::Supported -- Encodings
12666 supported by Encode
12667
12668 =over 4
12669
12670 =item DESCRIPTION
12671
12672 =over 4
12673
12674 =item Encoding Names
12675
12676 =back
12677
12678 =item Supported Encodings
12679
12680 =over 4
12681
12682 =item Built-in Encodings
12683
12684 =item Encode::Unicode -- other Unicode encodings
12685
12686 =item Encode::Byte -- Extended ASCII
12687
12688 ISO-8859 and corresponding vendor mappings, KOI8 - De Facto Standard for
12689 the Cyrillic world, gsm0338 - Hentai Latin 1
12690
12691 =item CJK: Chinese, Japanese, Korean (Multibyte)
12692
12693 Encode::CN -- Continental China, Encode::JP -- Japan, Encode::KR -- Korea,
12694 Encode::TW -- Taiwan, Encode::HanExtra -- More Chinese via CPAN,
12695 Encode::JIS2K -- JIS X 0213 encodings via CPAN
12696
12697 =item Miscellaneous encodings
12698
12699 Encode::EBCDIC, Encode::Symbols, Encode::MIME::Header, Encode::Guess
12700
12701 =back
12702
12703 =item Unsupported encodings
12704
12705   ISO-2022-JP-2 [RFC1554], ISO-2022-CN [RFC1922], Various HP-UX encodings,
12706 Cyrillic encoding ISO-IR-111, ISO-8859-8-1 [Hebrew], ISIRI 3342, Iran
12707 System, ISIRI 2900 [Farsi], Thai encoding TCVN, Vietnamese encodings VPS,
12708 Various Mac encodings, (Mac) Indic encodings
12709
12710 =item Encoding vs. Charset -- terminology
12711
12712 =item Encoding Classification (by Anton Tagunov and Dan Kogai)
12713
12714 =over 4
12715
12716 =item Microsoft-related naming mess
12717
12718 KS_C_5601-1987, GB2312, Big5, Shift_JIS
12719
12720 =back
12721
12722 =item Glossary
12723
12724 character repertoire, coded character set (CCS), character encoding scheme
12725 (CES), charset (in MIME context), EUC, ISO-2022, UCS, UCS-2, Unicode, UTF,
12726 UTF-16
12727
12728 =item See Also
12729
12730 =item References
12731
12732 ECMA, ECMA-035 (eq C<ISO-2022>), IANA, Assigned Charset Names by IANA, ISO,
12733 RFC, UC, Unicode Glossary
12734
12735 =over 4
12736
12737 =item Other Notable Sites
12738
12739 czyborra.com, CJK.inf, Jungshik Shin's Hangul FAQ, debian.org:
12740 "Introduction to i18n"
12741
12742 =item Offline sources
12743
12744 C<CJKV Information Processing> by Ken Lunde
12745
12746 =back
12747
12748 =back
12749
12750 =head2 Encode::lib::Encode::Unicode::UTF7, Encode::Unicode::UTF7 -- UTF-7
12751 encoding
12752
12753 =over 4
12754
12755 =item SYNOPSIS
12756
12757 =item ABSTRACT
12758
12759 =item In Practice
12760
12761 =item SEE ALSO
12762
12763 =back
12764
12765 =head2 Encode::lib::Encoder, Encode::Encoder -- Object Oriented Encoder
12766
12767 =over 4
12768
12769 =item SYNOPSIS
12770
12771 =item ABSTRACT
12772
12773 =item Description
12774
12775 =over 4
12776
12777 =item Predefined Methods
12778
12779 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12780 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12781 $e-E<gt>bytes([$encoding])
12782
12783 =item Example: base64 transcoder
12784
12785 =item Operator Overloading
12786
12787 =back
12788
12789 =item SEE ALSO
12790
12791 =back
12792
12793 =head2 Encodencoding, encoding - allows you to write your script in
12794 non-ascii or non-utf8
12795
12796 =over 4
12797
12798 =item SYNOPSIS
12799
12800 =item ABSTRACT
12801
12802 =over 4
12803
12804 =item Literal Conversions
12805
12806 =item PerlIO layers for C<STD(IN|OUT)>
12807
12808 =back
12809
12810 =item FEATURES THAT REQUIRE 5.8.1
12811
12812 "NON-EUC" doublebyte encodings, tr//, DATA pseudo-filehandle
12813
12814 =item USAGE
12815
12816 use encoding [I<ENCNAME>] ;, use encoding I<ENCNAME> [ STDIN =E<gt>
12817 I<ENCNAME_IN> ...] ;, use encoding I<ENCNAME> Filter=E<gt>1;, no encoding;
12818
12819 =item The Filter Option
12820
12821 =over 4
12822
12823 =item Filter-related changes at Encode version 1.87
12824
12825 =back
12826
12827 =item CAVEATS
12828
12829 =over 4
12830
12831 =item NOT SCOPED
12832
12833 =item DO NOT MIX MULTIPLE ENCODINGS
12834
12835 =item tr/// with ranges
12836
12837 Legend of characters above
12838
12839 =back
12840
12841 =item EXAMPLE - Greekperl
12842
12843 =item KNOWN PROBLEMS
12844
12845 literals in regex that are longer than 127 bytes, EBCDIC, format
12846
12847 =item HISTORY
12848
12849 =item SEE ALSO
12850
12851 =back
12852
12853 =head2 Encoder, Encode::Encoder -- Object Oriented Encoder
12854
12855 =over 4
12856
12857 =item SYNOPSIS
12858
12859 =item ABSTRACT
12860
12861 =item Description
12862
12863 =over 4
12864
12865 =item Predefined Methods
12866
12867 $e = Encode::Encoder-E<gt>new([$data, $encoding]);, encoder(),
12868 $e-E<gt>data([$data]), $e-E<gt>encoding([$encoding]),
12869 $e-E<gt>bytes([$encoding])
12870
12871 =item Example: base64 transcoder
12872
12873 =item Operator Overloading
12874
12875 =back
12876
12877 =item SEE ALSO
12878
12879 =back
12880
12881 =head2 English - use nice English (or awk) names for ugly punctuation
12882 variables
12883
12884 =over 4
12885
12886 =item SYNOPSIS
12887
12888 =item DESCRIPTION
12889
12890 =item PERFORMANCE
12891
12892 =back
12893
12894 =head2 Env - perl module that imports environment variables as scalars or
12895 arrays
12896
12897 =over 4
12898
12899 =item SYNOPSIS
12900
12901 =item DESCRIPTION
12902
12903 =item LIMITATIONS
12904
12905 =item AUTHOR
12906
12907 =back
12908
12909 =head2 Errno - System errno constants
12910
12911 =over 4
12912
12913 =item SYNOPSIS
12914
12915 =item DESCRIPTION
12916
12917 =item CAVEATS
12918
12919 =item AUTHOR
12920
12921 =item COPYRIGHT
12922
12923 =back
12924
12925 =head2 Exporter - Implements default import method for modules
12926
12927 =over 4
12928
12929 =item SYNOPSIS
12930
12931 =item DESCRIPTION
12932
12933 =over 4
12934
12935 =item How to Export
12936
12937 =item Selecting What To Export
12938
12939 =item How to Import
12940
12941 C<use ModuleName;>, C<use ModuleName ();>, C<use ModuleName qw(...);>
12942
12943 =back
12944
12945 =item Advanced features
12946
12947 =over 4
12948
12949 =item Specialised Import Lists
12950
12951 =item Exporting without using Exporter's import method
12952
12953 =item Module Version Checking
12954
12955 =item Managing Unknown Symbols
12956
12957 =item Tag Handling Utility Functions
12958
12959 =item Generating combined tags
12960
12961 =item C<AUTOLOAD>ed Constants
12962
12963 =back
12964
12965 =back
12966
12967 =head2 Exporter::Heavy - Exporter guts
12968
12969 =over 4
12970
12971 =item SYNOPSIS
12972
12973 =item DESCRIPTION
12974
12975 =back
12976
12977 =head2 ExtUtils::Command - utilities to replace common UNIX commands in
12978 Makefiles etc.
12979
12980 =over 4
12981
12982 =item SYNOPSIS
12983
12984 =item DESCRIPTION
12985
12986 =back
12987
12988 cat
12989
12990 eqtime src dst
12991
12992 rm_rf files...
12993
12994 rm_f files...
12995
12996 touch files ..
12997
12998 mv source... destination
12999
13000 cp source... destination
13001
13002 chmod mode files..
13003
13004 mkpath directory..
13005
13006 test_f file
13007
13008 dos2unix
13009
13010 =over 4
13011
13012 =item BUGS
13013
13014 =item SEE ALSO 
13015
13016 =item AUTHOR
13017
13018 =back
13019
13020 =head2 ExtUtils::Command::MM - Commands for the MM's to use in Makefiles
13021
13022 =over 4
13023
13024 =item SYNOPSIS
13025
13026 =item DESCRIPTION
13027
13028 B<test_harness>
13029
13030 =back
13031
13032 B<pod2man>
13033
13034 B<warn_if_old_packlist>
13035
13036 B<perllocal_install>
13037
13038 B<uninstall>
13039
13040 =head2 ExtUtils::Constant - generate XS code to import C header constants
13041
13042 =over 4
13043
13044 =item SYNOPSIS
13045
13046 =item DESCRIPTION
13047
13048 =item USAGE
13049
13050 IV, UV, NV, PV, PVN, SV, YES, NO, UNDEF
13051
13052 =item FUNCTIONS
13053
13054 =back
13055
13056 C_stringify NAME
13057
13058 perl_stringify NAME
13059
13060 constant_types
13061
13062 memEQ_clause NAME, CHECKED_AT, INDENT
13063
13064 assign INDENT, TYPE, PRE, POST, VALUE..
13065
13066 return_clause
13067
13068 switch_clause INDENT, NAMELEN, ITEMHASH, ITEM..
13069
13070 params WHAT
13071
13072 dump_names
13073
13074 dogfood
13075
13076 C_constant, name, type, value, macro, default, pre, post, def_pre =item
13077 def_post, utf8
13078
13079 XS_constant PACKAGE, TYPES, SUBNAME, C_SUBNAME
13080
13081 autoload PACKAGE, VERSION, AUTOLOADER
13082
13083 WriteMakefileSnippet
13084
13085 WriteConstants ATTRIBUTE =E<gt> VALUE [, ...], NAME, DEFAULT_TYPE,
13086 BREAKOUT_AT, NAMES, C_FILE, XS_FILE, SUBNAME, C_SUBNAME
13087
13088 =over 4
13089
13090 =item AUTHOR
13091
13092 =back
13093
13094 =head2 ExtUtils::Embed - Utilities for embedding Perl in C/C++ applications
13095
13096 =over 4
13097
13098 =item SYNOPSIS
13099
13100 =item DESCRIPTION
13101
13102 =item @EXPORT
13103
13104 =item FUNCTIONS
13105
13106 xsinit(), Examples, ldopts(), Examples, perl_inc(), ccflags(), ccdlflags(),
13107 ccopts(), xsi_header(), xsi_protos(@modules), xsi_body(@modules)
13108
13109 =item EXAMPLES
13110
13111 =item SEE ALSO
13112
13113 =item AUTHOR
13114
13115 =back
13116
13117 =head2 ExtUtils::Install - install files from here to there
13118
13119 =over 4
13120
13121 =item SYNOPSIS
13122
13123 =item DESCRIPTION
13124
13125 =over 4
13126
13127 =item Functions
13128
13129 B<install>
13130
13131 =back
13132
13133 =back
13134
13135 B<install_default> I<DISCOURAGED>
13136
13137 B<uninstall>
13138
13139 B<pm_to_blib>
13140
13141 _autosplit
13142
13143 =over 4
13144
13145 =item ENVIRONMENT
13146
13147 B<PERL_INSTALL_ROOT>
13148
13149 =item AUTHOR
13150
13151 =item LICENSE
13152
13153 =back
13154
13155 =head2 ExtUtils::Installed - Inventory management of installed modules
13156
13157 =over 4
13158
13159 =item SYNOPSIS
13160
13161 =item DESCRIPTION
13162
13163 =item USAGE
13164
13165 =item FUNCTIONS
13166
13167 new(), modules(), files(), directories(), directory_tree(), validate(),
13168 packlist(), version()
13169
13170 =item EXAMPLE
13171
13172 =item AUTHOR
13173
13174 =back
13175
13176 =head2 ExtUtils::Liblist - determine libraries to use and how to use them
13177
13178 =over 4
13179
13180 =item SYNOPSIS
13181
13182 =item DESCRIPTION
13183
13184 For static extensions, For dynamic extensions at build/link time, For
13185 dynamic extensions at load time
13186
13187 =over 4
13188
13189 =item EXTRALIBS
13190
13191 =item LDLOADLIBS and LD_RUN_PATH
13192
13193 =item BSLOADLIBS
13194
13195 =back
13196
13197 =item PORTABILITY
13198
13199 =over 4
13200
13201 =item VMS implementation
13202
13203 =item Win32 implementation
13204
13205 =back
13206
13207 =item SEE ALSO
13208
13209 =back
13210
13211 =head2 ExtUtils::MM - OS adjusted ExtUtils::MakeMaker subclass
13212
13213 =over 4
13214
13215 =item SYNOPSIS
13216
13217 =item DESCRIPTION
13218
13219 =back
13220
13221 =head2 ExtUtils::MM_Any - Platform-agnostic MM methods
13222
13223 =over 4
13224
13225 =item SYNOPSIS
13226
13227 =item DESCRIPTION
13228
13229 =item Inherently Cross-Platform Methods
13230
13231 installvars
13232
13233 =back
13234
13235 os_flavor_is
13236
13237 blibdirs_target (o)
13238
13239 =over 4
13240
13241 =item File::Spec wrappers
13242
13243 catfile
13244
13245 =back
13246
13247 =over 4
13248
13249 =item Thought To Be Cross-Platform Methods
13250
13251 B<split_command>
13252
13253 =back
13254
13255 B<echo>
13256
13257 init_VERSION
13258
13259 wraplist
13260
13261 manifypods
13262
13263 manifypods_target
13264
13265 makemakerdflt_target
13266
13267 special_targets
13268
13269 POD2MAN_macro
13270
13271 test_via_harness
13272
13273 test_via_script
13274
13275 libscan
13276
13277 tool_autosplit
13278
13279 all_target
13280
13281 metafile_target
13282
13283 signature_target
13284
13285 metafile_addtomanifest_target
13286
13287 signature_addtomanifest_target
13288
13289 =over 4
13290
13291 =item Abstract methods
13292
13293 oneliner, B<quote_literal>, B<escape_newlines>, max_exec_len,
13294 B<init_others>, init_DIRFILESEP, init_linker, init_platform,
13295 platform_constants
13296
13297 =back
13298
13299 os_flavor
13300
13301 =over 4
13302
13303 =item AUTHOR
13304
13305 =back
13306
13307 =head2 ExtUtils::MM_BeOS - methods to override UN*X behaviour in
13308 ExtUtils::MakeMaker
13309
13310 =over 4
13311
13312 =item SYNOPSIS
13313
13314 =item DESCRIPTION
13315
13316 =back
13317
13318 os_flavor (o)
13319
13320 init_linker
13321
13322 =head2 ExtUtils::MM_Cygwin - methods to override UN*X behaviour in
13323 ExtUtils::MakeMaker
13324
13325 =over 4
13326
13327 =item SYNOPSIS
13328
13329 =item DESCRIPTION
13330
13331 os_flavor (o)
13332
13333 =back
13334
13335 cflags (o)
13336
13337 replace_manpage_separator (o)
13338
13339 init_linker
13340
13341 =head2 ExtUtils::MM_DOS - DOS specific subclass of ExtUtils::MM_Unix
13342
13343 =over 4
13344
13345 =item SYNOPSIS
13346
13347 =item DESCRIPTION
13348
13349 =over 4
13350
13351 =item Overridden methods
13352
13353 os_flavor
13354
13355 =back
13356
13357 =back
13358
13359 B<replace_manpage_separator>
13360
13361 =over 4
13362
13363 =item AUTHOR
13364
13365 =item SEE ALSO
13366
13367 =back
13368
13369 =head2 ExtUtils::MM_MacOS - methods to override UN*X behaviour in
13370 ExtUtils::MakeMaker
13371
13372 =over 4
13373
13374 =item SYNOPSIS
13375
13376 =item DESCRIPTION
13377
13378 =back
13379
13380 maybe_command
13381
13382 guess_name
13383
13384 macify
13385
13386 patternify
13387
13388 init_main
13389
13390 init_others
13391
13392 init_platform, platform_constants
13393
13394 init_dirscan
13395
13396 init_VERSION (o)
13397
13398 special_targets (o)
13399
13400 static (o)
13401
13402 dlsyms (o)
13403
13404 dynamic (o)
13405
13406 clean (o)
13407
13408 clean_subdirs_target
13409
13410 realclean (o)
13411
13412 realclean_subdirs_target
13413
13414 rulez (o)
13415
13416 processPL (o)
13417
13418 os_flavor
13419
13420 =head2 ExtUtils::MM_NW5 - methods to override UN*X behaviour in
13421 ExtUtils::MakeMaker
13422
13423 =over 4
13424
13425 =item SYNOPSIS
13426
13427 =item DESCRIPTION
13428
13429 =back
13430
13431 os_flavor
13432
13433 init_platform (o), platform_constants
13434
13435 const_cccmd (o)
13436
13437 static_lib (o)
13438
13439 dynamic_lib (o)
13440
13441 =head2 ExtUtils::MM_OS2 - methods to override UN*X behaviour in
13442 ExtUtils::MakeMaker
13443
13444 =over 4
13445
13446 =item SYNOPSIS
13447
13448 =item DESCRIPTION
13449
13450 =item METHODS
13451
13452 init_dist (o)
13453
13454 =back
13455
13456 init_linker
13457
13458 os_flavor
13459
13460 =head2 ExtUtils::MM_UWIN - U/WIN specific subclass of ExtUtils::MM_Unix
13461
13462 =over 4
13463
13464 =item SYNOPSIS
13465
13466 =item DESCRIPTION
13467
13468 =over 4
13469
13470 =item Overridden methods
13471
13472 os_flavor
13473
13474 =back
13475
13476 =back
13477
13478 B<replace_manpage_separator>
13479
13480 =over 4
13481
13482 =item AUTHOR
13483
13484 =item SEE ALSO
13485
13486 =back
13487
13488 =head2 ExtUtils::MM_Unix - methods used by ExtUtils::MakeMaker
13489
13490 =over 4
13491
13492 =item SYNOPSIS
13493
13494 =item DESCRIPTION
13495
13496 =item METHODS
13497
13498 =back
13499
13500 =over 4
13501
13502 =item Methods
13503
13504 os_flavor (o)
13505
13506 =back
13507
13508 c_o (o)
13509
13510 cflags (o)
13511
13512 clean (o)
13513
13514 clean_subdirs_target
13515
13516 const_cccmd (o)
13517
13518 const_config (o)
13519
13520 const_loadlibs (o)
13521
13522 constants (o)
13523
13524 depend (o)
13525
13526 dir_target B<DEPRECATED>
13527
13528 init_DEST
13529
13530 init_dist
13531
13532 dist (o)
13533
13534 dist_basics (o)
13535
13536 dist_ci (o)
13537
13538 dist_core (o)
13539
13540 B<dist_target>
13541
13542 B<tardist_target>
13543
13544 B<zipdist_target>
13545
13546 B<tarfile_target>
13547
13548 zipfile_target
13549
13550 uutardist_target
13551
13552 shdist_target
13553
13554 distdir
13555
13556 dist_test
13557
13558 dlsyms (o)
13559
13560 dynamic (o)
13561
13562 dynamic_bs (o)
13563
13564 dynamic_lib (o)
13565
13566 exescan
13567
13568 extliblist
13569
13570 find_perl
13571
13572 find_tests
13573
13574 =over 4
13575
13576 =item Methods to actually produce chunks of text for the Makefile
13577
13578 fixin
13579
13580 =back
13581
13582 force (o)
13583
13584 guess_name
13585
13586 has_link_code
13587
13588 init_dirscan
13589
13590 init_DIRFILESEP
13591
13592 init_main
13593
13594 init_others
13595
13596 init_INST
13597
13598 init_INSTALL
13599
13600 init_linker
13601
13602 init_lib2arch
13603
13604 init_PERL
13605
13606 init_platform (o), platform_constants (o)
13607
13608 init_PERM
13609
13610 init_xs
13611
13612 install (o)
13613
13614 installbin (o)
13615
13616 linkext (o)
13617
13618 lsdir
13619
13620 macro (o)
13621
13622 makeaperl (o)
13623
13624 makefile (o)
13625
13626 maybe_command
13627
13628 needs_linking (o)
13629
13630 nicetext
13631
13632 parse_abstract
13633
13634 parse_version
13635
13636 pasthru (o)
13637
13638 perl_script
13639
13640 perldepend (o)
13641
13642 perm_rw (o)
13643
13644 perm_rwx (o)
13645
13646 pm_to_blib
13647
13648 post_constants (o)
13649
13650 post_initialize (o)
13651
13652 postamble (o)
13653
13654 ppd
13655
13656 prefixify
13657
13658 processPL (o)
13659
13660 quote_paren
13661
13662 realclean (o)
13663
13664 realclean_subdirs_target
13665
13666 replace_manpage_separator
13667
13668 oneliner (o)
13669
13670 quote_literal
13671
13672 escape_newlines
13673
13674 max_exec_len
13675
13676 static (o)
13677
13678 static_lib (o)
13679
13680 staticmake (o)
13681
13682 subdir_x (o)
13683
13684 subdirs (o)
13685
13686 test (o)
13687
13688 test_via_harness (override)
13689
13690 test_via_script (override)
13691
13692 tools_other (o)
13693
13694 tool_xsubpp (o)
13695
13696 all_target
13697
13698 top_targets (o)
13699
13700 writedoc
13701
13702 xs_c (o)
13703
13704 xs_cpp (o)
13705
13706 xs_o (o)
13707
13708 =over 4
13709
13710 =item SEE ALSO
13711
13712 =back
13713
13714 =head2 ExtUtils::MM_VMS - methods to override UN*X behaviour in
13715 ExtUtils::MakeMaker
13716
13717 =over 4
13718
13719 =item SYNOPSIS
13720
13721 =item DESCRIPTION
13722
13723 =over 4
13724
13725 =item Methods always loaded
13726
13727 wraplist
13728
13729 =back
13730
13731 =back
13732
13733 =over 4
13734
13735 =item Methods
13736
13737 guess_name (override)
13738
13739 =back
13740
13741 find_perl (override)
13742
13743 maybe_command (override)
13744
13745 perl_script (override)
13746
13747 replace_manpage_separator
13748
13749 init_DEST
13750
13751 init_DIRFILESEP
13752
13753 init_main (override)
13754
13755 init_others (override)
13756
13757 init_platform (override)
13758
13759 platform_constants
13760
13761 init_VERSION (override)
13762
13763 constants (override)
13764
13765 special_targets
13766
13767 cflags (override)
13768
13769 const_cccmd (override)
13770
13771 tool_sxubpp (override)
13772
13773 tools_other (override)
13774
13775 init_dist (override)
13776
13777 c_o (override)
13778
13779 xs_c (override)
13780
13781 xs_o (override)
13782
13783 dlsyms (override)
13784
13785 dynamic_lib (override)
13786
13787 dynamic_bs (override)
13788
13789 static_lib (override)
13790
13791 processPL (override)
13792
13793 installbin (override)
13794
13795 subdir_x (override)
13796
13797 clean (override)
13798
13799 clean_subdirs_target
13800
13801 realclean (override)
13802
13803 zipfile_target (o), tarfile_target (o), shdist_target (o)
13804
13805 dist_test (override)
13806
13807 install (override)
13808
13809 perldepend (override)
13810
13811 makefile (override)
13812
13813 find_tests (override)
13814
13815 test (override)
13816
13817 makeaperl (override)
13818
13819 nicetext (override)
13820
13821 prefixify (override)
13822
13823 oneliner (o)
13824
13825 B<echo> (o)
13826
13827 quote_literal
13828
13829 escape_newlines
13830
13831 max_exec_len
13832
13833 init_linker (o)
13834
13835 eliminate_macros
13836
13837 fixpath
13838
13839 os_flavor
13840
13841 =head2 ExtUtils::MM_Win32 - methods to override UN*X behaviour in
13842 ExtUtils::MakeMaker
13843
13844 =over 4
13845
13846 =item SYNOPSIS
13847
13848 =item DESCRIPTION
13849
13850 =back
13851
13852 =over 4
13853
13854 =item Overridden methods
13855
13856 B<dlsyms>
13857
13858 =back
13859
13860 replace_manpage_separator
13861
13862 B<maybe_command>
13863
13864 B<find_tests>
13865
13866 B<init_DIRFILESEP>
13867
13868 B<init_others>
13869
13870 init_platform (o), platform_constants (o)
13871
13872 special_targets (o)
13873
13874 static_lib (o)
13875
13876 dynamic_lib (o)
13877
13878 clean
13879
13880 init_linker
13881
13882 perl_script
13883
13884 xs_o (o)
13885
13886 pasthru (o)
13887
13888 oneliner (o)
13889
13890 max_exec_len
13891
13892 os_flavor
13893
13894 =head2 ExtUtils::MM_Win95 - method to customize MakeMaker for Win9X
13895
13896 =over 4
13897
13898 =item SYNOPSIS
13899
13900 =item DESCRIPTION
13901
13902 =over 4
13903
13904 =item Overriden methods
13905
13906 dist_test
13907
13908 =back
13909
13910 =back
13911
13912 subdir_x
13913
13914 xs_c
13915
13916 xs_cpp
13917
13918 xs_o
13919
13920 clean_subdirs_target
13921
13922 realclean_subdirs_target
13923
13924 os_flavor
13925
13926 =over 4
13927
13928 =item AUTHOR
13929
13930 =back
13931
13932 =head2 ExtUtils::MY - ExtUtils::MakeMaker subclass for customization
13933
13934 =over 4
13935
13936 =item SYNOPSIS
13937
13938 =item DESCRIPTION
13939
13940 =back
13941
13942 =head2 ExtUtils::MakeMaker - Create a module Makefile
13943
13944 =over 4
13945
13946 =item SYNOPSIS
13947
13948 =item DESCRIPTION
13949
13950 =over 4
13951
13952 =item How To Write A Makefile.PL
13953
13954 =item Default Makefile Behaviour
13955
13956 =item make test
13957
13958 =item make testdb
13959
13960 =item make install
13961
13962 =item PREFIX and LIB attribute
13963
13964 =item AFS users
13965
13966 =item Static Linking of a new Perl Binary
13967
13968 =item Determination of Perl Library and Installation Locations
13969
13970 =item Which architecture dependent directory?
13971
13972 =item Using Attributes and Parameters
13973
13974 ABSTRACT, ABSTRACT_FROM, AUTHOR, BINARY_LOCATION, C, CCFLAGS, CONFIG,
13975 CONFIGURE, DEFINE, DESTDIR, DIR, DISTNAME, DISTVNAME, DL_FUNCS, DL_VARS,
13976 EXCLUDE_EXT, EXE_FILES, FIRST_MAKEFILE, FULLPERL, FULLPERLRUN,
13977 FULLPERLRUNINST, FUNCLIST, H, IMPORTS, INC, INCLUDE_EXT, INSTALLARCHLIB,
13978 INSTALLBIN, INSTALLDIRS, INSTALLMAN1DIR, INSTALLMAN3DIR, INSTALLPRIVLIB,
13979 INSTALLSCRIPT, INSTALLSITEARCH, INSTALLSITEBIN, INSTALLSITELIB,
13980 INSTALLSITEMAN1DIR, INSTALLSITEMAN3DIR, INSTALLVENDORARCH,
13981 INSTALLVENDORBIN, INSTALLVENDORLIB, INSTALLVENDORMAN1DIR,
13982 INSTALLVENDORMAN3DIR, INST_ARCHLIB, INST_BIN, INST_LIB, INST_MAN1DIR,
13983 INST_MAN3DIR, INST_SCRIPT, LD, LDDLFLAGS, LDFROM, LIB, LIBPERL_A, LIBS,
13984 LINKTYPE, MAKEAPERL, MAKEFILE_OLD, MAN1PODS, MAN3PODS, MAP_TARGET,
13985 MYEXTLIB, NAME, NEEDS_LINKING, NOECHO, NORECURS, NO_META, NO_VC, OBJECT,
13986 OPTIMIZE, PERL, PERL_CORE, PERLMAINCC, PERL_ARCHLIB, PERL_LIB,
13987 PERL_MALLOC_OK, PERLPREFIX, PERLRUN, PERLRUNINST, PERL_SRC, PERM_RW,
13988 PERM_RWX, PL_FILES, PM, PMLIBDIRS, PM_FILTER, POLLUTE, PPM_INSTALL_EXEC,
13989 PPM_INSTALL_SCRIPT, PREFIX, PREREQ_FATAL, PREREQ_PM, PREREQ_PRINT,
13990 PRINT_PREREQ, SITEPREFIX, SIGN, SKIP, TYPEMAPS, VENDORPREFIX, VERBINST,
13991 VERSION, VERSION_FROM, VERSION_SYM, XS, XSOPT, XSPROTOARG, XS_VERSION
13992
13993 =item Additional lowercase attributes
13994
13995 clean, depend, dist, dynamic_lib, linkext, macro, postamble, realclean,
13996 test, tool_autosplit
13997
13998 =item Overriding MakeMaker Methods
13999
14000 =item The End Of Cargo Cult Programming
14001
14002 C<<MAN3PODS => ' '>>
14003
14004 =item Hintsfile support
14005
14006 =item Distribution Support
14007
14008    make distcheck,    make skipcheck,    make distclean,    make manifest, 
14009   make distdir,   make disttest,    make tardist,    make dist,    make
14010 uutardist,    make shdist,    make zipdist,    make ci
14011
14012 =item Module Meta-Data
14013
14014 =item Disabling an extension
14015
14016 =item Other Handy Functions
14017
14018 prompt
14019
14020 =back
14021
14022 =item ENVIRONMENT
14023
14024 PERL_MM_OPT, PERL_MM_USE_DEFAULT
14025
14026 =item SEE ALSO
14027
14028 =item AUTHORS
14029
14030 =item LICENSE
14031
14032 =back
14033
14034 =head2 ExtUtils::MakeMaker::FAQ - Frequently Asked Questions About
14035 MakeMaker
14036
14037 =over 4
14038
14039 =item DESCRIPTION
14040
14041 =over 4
14042
14043 =item Philosophy and History
14044
14045 Why not just use <insert other build config tool here>?, What's
14046 Module::Build and how does it relate to MakeMaker?, pure perl.  no make, no
14047 shell commands, easier to customize, cleaner internals, less cruft
14048
14049 =item Module Writing
14050
14051 How do I keep my $VERSION up to date without resetting it manually?, What's
14052 this F<META.yml> thing and how did it get in my F<MANIFEST>?!
14053
14054 =item XS
14055
14056 How to I prevent "object version X.XX does not match bootstrap parameter
14057 Y.YY" errors?, How do I make two or more XS files coexist in the same
14058 directory?
14059
14060 =back
14061
14062 =item PATCHING
14063
14064 =item AUTHOR
14065
14066 =item SEE ALSO
14067
14068 =back
14069
14070 =head2 ExtUtils::MakeMaker::Tutorial - Writing a module with MakeMaker
14071
14072 =over 4
14073
14074 =item SYNOPSIS
14075
14076 =item DESCRIPTION
14077
14078 =over 4
14079
14080 =item The Mantra
14081
14082 =item The Layout
14083
14084 Makefile.PL, MANIFEST, lib/, t/, Changes, README, INSTALL, MANIFEST.SKIP,
14085 bin/
14086
14087 =back
14088
14089 =item SEE ALSO
14090
14091 =back
14092
14093 =head2 ExtUtils::MakeMaker::bytes - Version-agnostic bytes.pm
14094
14095 =over 4
14096
14097 =item SYNOPSIS
14098
14099 =item DESCRIPTION
14100
14101 =back
14102
14103 =head2 ExtUtils::MakeMaker::vmsish - Platform-agnostic vmsish.pm
14104
14105 =over 4
14106
14107 =item SYNOPSIS
14108
14109 =item DESCRIPTION
14110
14111 =back
14112
14113 =head2 ExtUtils::Manifest - utilities to write and check a MANIFEST file
14114
14115 =over 4
14116
14117 =item SYNOPSIS
14118
14119 =item DESCRIPTION
14120
14121 =over 4
14122
14123 =item Functions
14124
14125 mkmanifest
14126
14127 =back
14128
14129 =back
14130
14131 manifind
14132
14133 manicheck
14134
14135 filecheck
14136
14137 fullcheck
14138
14139 skipcheck
14140
14141 maniread
14142
14143 manicopy
14144
14145 maniadd
14146
14147 =over 4
14148
14149 =item MANIFEST
14150
14151 =item MANIFEST.SKIP
14152
14153 =item EXPORT_OK
14154
14155 =item GLOBAL VARIABLES
14156
14157 =back
14158
14159 =over 4
14160
14161 =item DIAGNOSTICS
14162
14163 C<Not in MANIFEST:> I<file>, C<Skipping> I<file>, C<No such file:> I<file>,
14164 C<MANIFEST:> I<$!>, C<Added to MANIFEST:> I<file>
14165
14166 =item ENVIRONMENT
14167
14168 B<PERL_MM_MANIFEST_DEBUG>
14169
14170 =item SEE ALSO
14171
14172 =item AUTHOR
14173
14174 =back
14175
14176 =head2 ExtUtils::Miniperl, writemain - write the C code for perlmain.c
14177
14178 =over 4
14179
14180 =item SYNOPSIS
14181
14182 =item DESCRIPTION
14183
14184 =item SEE ALSO
14185
14186 =back
14187
14188 =head2 ExtUtils::Mkbootstrap - make a bootstrap file for use by DynaLoader
14189
14190 =over 4
14191
14192 =item SYNOPSIS
14193
14194 =item DESCRIPTION
14195
14196 =back
14197
14198 =head2 ExtUtils::Mksymlists - write linker options files for dynamic
14199 extension
14200
14201 =over 4
14202
14203 =item SYNOPSIS
14204
14205 =item DESCRIPTION
14206
14207 DLBASE, DL_FUNCS, DL_VARS, FILE, FUNCLIST, IMPORTS, NAME
14208
14209 =item AUTHOR
14210
14211 =item REVISION
14212
14213 =back
14214
14215 =head2 ExtUtils::Packlist - manage .packlist files
14216
14217 =over 4
14218
14219 =item SYNOPSIS
14220
14221 =item DESCRIPTION
14222
14223 =item USAGE
14224
14225 =item FUNCTIONS
14226
14227 new(), read(), write(), validate(), packlist_file()
14228
14229 =item EXAMPLE
14230
14231 =item AUTHOR
14232
14233 =back
14234
14235 =head2 ExtUtils::testlib - add blib/* directories to @INC
14236
14237 =over 4
14238
14239 =item SYNOPSIS
14240
14241 =item DESCRIPTION
14242
14243 =back
14244
14245 =head2 Fatal - replace functions with equivalents which succeed or die
14246
14247 =over 4
14248
14249 =item SYNOPSIS
14250
14251 =item DESCRIPTION
14252
14253 =item AUTHOR
14254
14255 =back
14256
14257 =head2 Fcntl - load the C Fcntl.h defines
14258
14259 =over 4
14260
14261 =item SYNOPSIS
14262
14263 =item DESCRIPTION
14264
14265 =item NOTE
14266
14267 =item EXPORTED SYMBOLS
14268
14269 =back
14270
14271 =head2 File::Basename, fileparse - split a pathname into pieces
14272
14273 =over 4
14274
14275 =item SYNOPSIS
14276
14277 =item DESCRIPTION
14278
14279 fileparse_set_fstype, fileparse
14280
14281 =item EXAMPLES
14282
14283 C<basename>, C<dirname>
14284
14285 =back
14286
14287 =head2 File::CheckTree, validate - run many filetest checks on a tree
14288
14289 =over 4
14290
14291 =item SYNOPSIS
14292
14293 =item DESCRIPTION
14294
14295 =item AUTHOR
14296
14297 =item HISTORY
14298
14299 =back
14300
14301 =head2 File::Compare - Compare files or filehandles
14302
14303 =over 4
14304
14305 =item SYNOPSIS
14306
14307 =item DESCRIPTION
14308
14309 =item RETURN
14310
14311 =item AUTHOR
14312
14313 =back
14314
14315 =head2 File::Copy - Copy files or filehandles
14316
14317 =over 4
14318
14319 =item SYNOPSIS
14320
14321 =item DESCRIPTION
14322
14323 =over 4
14324
14325 =item Special behaviour if C<syscopy> is defined (OS/2, VMS and Win32)
14326
14327 rmscopy($from,$to[,$date_flag])
14328
14329 =back
14330
14331 =item RETURN
14332
14333 =item NOTES
14334
14335 =item AUTHOR
14336
14337 =back
14338
14339 =head2 File::DosGlob - DOS like globbing and then some
14340
14341 =over 4
14342
14343 =item SYNOPSIS
14344
14345 =item DESCRIPTION
14346
14347 =item NOTES
14348
14349 =item EXPORTS (by request only)
14350
14351 =item BUGS
14352
14353 =item AUTHOR
14354
14355 =item HISTORY
14356
14357 =item SEE ALSO
14358
14359 =back
14360
14361 =head2 File::Find - Traverse a directory tree.
14362
14363 =over 4
14364
14365 =item SYNOPSIS
14366
14367 =item DESCRIPTION
14368
14369 B<find>, B<finddepth>
14370
14371 =over 4
14372
14373 =item %options
14374
14375 C<wanted>, C<bydepth>, C<preprocess>, C<postprocess>, C<follow>,
14376 C<follow_fast>, C<follow_skip>, C<dangling_symlinks>, C<no_chdir>,
14377 C<untaint>, C<untaint_pattern>, C<untaint_skip>
14378
14379 =item The wanted function
14380
14381 C<$File::Find::dir> is the current directory name,, C<$_> is the current
14382 filename within that directory, C<$File::Find::name> is the complete
14383 pathname to the file
14384
14385 =back
14386
14387 =item WARNINGS
14388
14389 =item CAVEAT
14390
14391 $dont_use_nlink, symlinks
14392
14393 =item NOTES
14394
14395 =item HISTORY
14396
14397 =back
14398
14399 =head2 File::Glob - Perl extension for BSD glob routine
14400
14401 =over 4
14402
14403 =item SYNOPSIS
14404
14405 =item DESCRIPTION
14406
14407 C<GLOB_ERR>, C<GLOB_LIMIT>, C<GLOB_MARK>, C<GLOB_NOCASE>, C<GLOB_NOCHECK>,
14408 C<GLOB_NOSORT>, C<GLOB_BRACE>, C<GLOB_NOMAGIC>, C<GLOB_QUOTE>,
14409 C<GLOB_TILDE>, C<GLOB_CSH>, C<GLOB_ALPHASORT>
14410
14411 =item DIAGNOSTICS
14412
14413 C<GLOB_NOSPACE>, C<GLOB_ABEND>
14414
14415 =item NOTES
14416
14417 =item AUTHOR
14418
14419 =back
14420
14421 =head2 File::Path - create or remove directory trees
14422
14423 =over 4
14424
14425 =item SYNOPSIS
14426
14427 =item DESCRIPTION
14428
14429 =item DIAGNOSTICS
14430
14431 =item AUTHORS
14432
14433 =back
14434
14435 =head2 File::Spec - portably perform operations on file names
14436
14437 =over 4
14438
14439 =item SYNOPSIS
14440
14441 =item DESCRIPTION
14442
14443 =item METHODS
14444
14445 canonpath, catdir, catfile, curdir, devnull, rootdir, tmpdir, updir,
14446 no_upwards, case_tolerant, file_name_is_absolute, path, join, splitpath,
14447 splitdir, catpath(), abs2rel, rel2abs()
14448
14449 =item SEE ALSO
14450
14451 =item AUTHORS
14452
14453 =back
14454
14455 =head2 File::Spec::Cygwin - methods for Cygwin file specs
14456
14457 =over 4
14458
14459 =item SYNOPSIS
14460
14461 =item DESCRIPTION
14462
14463 =back
14464
14465 canonpath
14466
14467 file_name_is_absolute
14468
14469 tmpdir (override)
14470
14471 =head2 File::Spec::Epoc - methods for Epoc file specs
14472
14473 =over 4
14474
14475 =item SYNOPSIS
14476
14477 =item DESCRIPTION
14478
14479 =item AUTHORS
14480
14481 =back
14482
14483 canonpath()
14484
14485 =over 4
14486
14487 =item SEE ALSO
14488
14489 =back
14490
14491 =head2 File::Spec::Functions - portably perform operations on file names
14492
14493 =over 4
14494
14495 =item SYNOPSIS
14496
14497 =item DESCRIPTION
14498
14499 =over 4
14500
14501 =item Exports
14502
14503 =back
14504
14505 =item SEE ALSO
14506
14507 =back
14508
14509 =head2 File::Spec::Mac - File::Spec for Mac OS (Classic)
14510
14511 =over 4
14512
14513 =item SYNOPSIS
14514
14515 =item DESCRIPTION
14516
14517 =item METHODS
14518
14519 canonpath
14520
14521 =back
14522
14523 catdir()
14524
14525 catfile
14526
14527 curdir
14528
14529 devnull
14530
14531 rootdir
14532
14533 tmpdir
14534
14535 updir
14536
14537 file_name_is_absolute
14538
14539 path
14540
14541 splitpath
14542
14543 splitdir
14544
14545 catpath
14546
14547 abs2rel
14548
14549 rel2abs
14550
14551 =over 4
14552
14553 =item AUTHORS
14554
14555 =item SEE ALSO
14556
14557 =back
14558
14559 =head2 File::Spec::OS2 - methods for OS/2 file specs
14560
14561 =over 4
14562
14563 =item SYNOPSIS
14564
14565 =item DESCRIPTION
14566
14567 tmpdir, splitpath
14568
14569 =back
14570
14571 =head2 File::Spec::Unix - File::Spec for Unix, base for other File::Spec
14572 modules
14573
14574 =over 4
14575
14576 =item SYNOPSIS
14577
14578 =item DESCRIPTION
14579
14580 =item METHODS
14581
14582 canonpath()
14583
14584 =back
14585
14586 catdir()
14587
14588 catfile
14589
14590 curdir
14591
14592 devnull
14593
14594 rootdir
14595
14596 tmpdir
14597
14598 updir
14599
14600 no_upwards
14601
14602 case_tolerant
14603
14604 file_name_is_absolute
14605
14606 path
14607
14608 join
14609
14610 splitpath
14611
14612 splitdir
14613
14614 catpath()
14615
14616 abs2rel
14617
14618 rel2abs()
14619
14620 =over 4
14621
14622 =item SEE ALSO
14623
14624 =back
14625
14626 =head2 File::Spec::VMS - methods for VMS file specs
14627
14628 =over 4
14629
14630 =item SYNOPSIS
14631
14632 =item DESCRIPTION
14633
14634 eliminate_macros
14635
14636 =back
14637
14638 fixpath
14639
14640 =over 4
14641
14642 =item Methods always loaded
14643
14644 canonpath (override)
14645
14646 =back
14647
14648 catdir
14649
14650 catfile
14651
14652 curdir (override)
14653
14654 devnull (override)
14655
14656 rootdir (override)
14657
14658 tmpdir (override)
14659
14660 updir (override)
14661
14662 case_tolerant (override)
14663
14664 path (override)
14665
14666 file_name_is_absolute (override)
14667
14668 splitpath (override)
14669
14670 splitdir (override)
14671
14672 catpath (override)
14673
14674 abs2rel (override)
14675
14676 rel2abs (override)
14677
14678 =over 4
14679
14680 =item SEE ALSO
14681
14682 =back
14683
14684 =head2 File::Spec::Win32 - methods for Win32 file specs
14685
14686 =over 4
14687
14688 =item SYNOPSIS
14689
14690 =item DESCRIPTION
14691
14692 devnull
14693
14694 =back
14695
14696 tmpdir
14697
14698 catfile
14699
14700 canonpath
14701
14702 splitpath
14703
14704 splitdir
14705
14706 catpath
14707
14708 =over 4
14709
14710 =item Note For File::Spec::Win32 Maintainers
14711
14712 =back
14713
14714 =over 4
14715
14716 =item SEE ALSO
14717
14718 =back
14719
14720 =head2 File::Temp - return name and handle of a temporary file safely
14721
14722 =over 4
14723
14724 =item PORTABILITY
14725
14726 =item SYNOPSIS
14727
14728 =item DESCRIPTION
14729
14730 =back
14731
14732 =over 4
14733
14734 =item OO INTERFACE
14735
14736 B<new>
14737
14738 =back
14739
14740 B<filename>
14741
14742 B<DESTROY>
14743
14744 =over 4
14745
14746 =item FUNCTIONS
14747
14748 B<tempfile>
14749
14750 =back
14751
14752 B<tempdir>
14753
14754 =over 4
14755
14756 =item MKTEMP FUNCTIONS
14757
14758 B<mkstemp>
14759
14760 =back
14761
14762 B<mkstemps>
14763
14764 B<mkdtemp>
14765
14766 B<mktemp>
14767
14768 =over 4
14769
14770 =item POSIX FUNCTIONS
14771
14772 B<tmpnam>
14773
14774 =back
14775
14776 B<tmpfile>
14777
14778 =over 4
14779
14780 =item ADDITIONAL FUNCTIONS
14781
14782 B<tempnam>
14783
14784 =back
14785
14786 =over 4
14787
14788 =item UTILITY FUNCTIONS
14789
14790 B<unlink0>
14791
14792 =back
14793
14794 B<cmpstat>
14795
14796 B<unlink1>
14797
14798 =over 4
14799
14800 =item PACKAGE VARIABLES
14801
14802 B<safe_level>, STANDARD, MEDIUM, HIGH
14803
14804 =back
14805
14806 TopSystemUID
14807
14808 =over 4
14809
14810 =item WARNING
14811
14812 =over 4
14813
14814 =item Temporary files and NFS
14815
14816 =back
14817
14818 =item HISTORY
14819
14820 =item SEE ALSO
14821
14822 =item AUTHOR
14823
14824 =back
14825
14826 =head2 File::stat - by-name interface to Perl's built-in stat() functions
14827
14828 =over 4
14829
14830 =item SYNOPSIS
14831
14832 =item DESCRIPTION
14833
14834 =item BUGS
14835
14836 =item NOTE
14837
14838 =item AUTHOR
14839
14840 =back
14841
14842 =head2 FileCache - keep more files open than the system permits
14843
14844 =over 4
14845
14846 =item SYNOPSIS
14847
14848 =item DESCRIPTION
14849
14850 cacheout EXPR, cacheout MODE, EXPR
14851
14852 =item CAVEATS
14853
14854 =item BUGS
14855
14856 =item NOTES
14857
14858 =back
14859
14860 =head2 FileHandle - supply object methods for filehandles
14861
14862 =over 4
14863
14864 =item SYNOPSIS
14865
14866 =item DESCRIPTION
14867
14868 $fh->print, $fh->printf, $fh->getline, $fh->getlines
14869
14870 =item SEE ALSO
14871
14872 =back
14873
14874 =head2 Filter::Simple - Simplified source filtering
14875
14876 =over 4
14877
14878 =item SYNOPSIS
14879
14880 =item DESCRIPTION
14881
14882 =over 4
14883
14884 =item The Problem
14885
14886 =item A Solution
14887
14888 =item Disabling or changing <no> behaviour
14889
14890 =item All-in-one interface
14891
14892 =item Filtering only specific components of source code
14893
14894 C<"code">, C<"executable">, C<"quotelike">, C<"string">, C<"regex">,
14895 C<"all">
14896
14897 =item Filtering only the code parts of source code
14898
14899 Most source code ceases to be grammatically correct when it is broken up
14900 into the pieces between string literals and regexes. So the C<'code'>
14901 component filter behaves slightly differently from the other partial
14902 filters
14903 described in the previous section.
14904
14905 =item Using Filter::Simple with an explicit C<import> subroutine
14906
14907 =item Using Filter::Simple and Exporter together
14908
14909 =item How it works
14910
14911 =back
14912
14913 =item AUTHOR
14914
14915 =item COPYRIGHT
14916
14917 =back
14918
14919 =head2 Filter::Util::Call - Perl Source Filter Utility Module
14920
14921 =over 4
14922
14923 =item SYNOPSIS
14924
14925 =item DESCRIPTION
14926
14927 =over 4
14928
14929 =item B<use Filter::Util::Call>
14930
14931 =item B<import()>
14932
14933 =item B<filter() and anonymous sub>
14934
14935 B<$_>, B<$status>, B<filter_read> and B<filter_read_exact>, B<filter_del>
14936
14937 =back
14938
14939 =item EXAMPLES
14940
14941 =over 4
14942
14943 =item Example 1: A simple filter.
14944
14945 =item Example 2: Using the context
14946
14947 =item Example 3: Using the context within the filter
14948
14949 =item Example 4: Using filter_del
14950
14951 =back
14952
14953 =item Filter::Simple
14954
14955 =item AUTHOR
14956
14957 =item DATE
14958
14959 =back
14960
14961 =head2 FindBin - Locate directory of original perl script
14962
14963 =over 4
14964
14965 =item SYNOPSIS
14966
14967 =item DESCRIPTION
14968
14969 =item EXPORTABLE VARIABLES
14970
14971 =item KNOWN ISSUES
14972
14973 =item KNOWN BUGS
14974
14975 =item AUTHORS
14976
14977 =item COPYRIGHT
14978
14979 =back
14980
14981 =head2 GDBM_File - Perl5 access to the gdbm library.
14982
14983 =over 4
14984
14985 =item SYNOPSIS
14986
14987 =item DESCRIPTION
14988
14989 =item AVAILABILITY
14990
14991 =item BUGS
14992
14993 =item SEE ALSO
14994
14995 =back
14996
14997 =head2 Getopt::Long - Extended processing of command line options
14998
14999 =over 4
15000
15001 =item SYNOPSIS
15002
15003 =item DESCRIPTION
15004
15005 =item Command Line Options, an Introduction
15006
15007 =item Getting Started with Getopt::Long
15008
15009 =over 4
15010
15011 =item Simple options
15012
15013 =item A little bit less simple options
15014
15015 =item Mixing command line option with other arguments
15016
15017 =item Options with values
15018
15019 =item Options with multiple values
15020
15021 =item Options with hash values
15022
15023 =item User-defined subroutines to handle options
15024
15025 =item Options with multiple names
15026
15027 =item Case and abbreviations
15028
15029 =item Summary of Option Specifications
15030
15031 !, +, s, i, o, f, : I<type> [ I<desttype> ], : I<number> [ I<desttype> ], :
15032 + [ I<desttype> ]
15033
15034 =back
15035
15036 =item Advanced Possibilities
15037
15038 =over 4
15039
15040 =item Object oriented interface
15041
15042 =item Thread Safety
15043
15044 =item Documentation and help texts
15045
15046 =item Storing options in a hash
15047
15048 =item Bundling
15049
15050 =item The lonesome dash
15051
15052 =item Argument callback
15053
15054 =back
15055
15056 =item Configuring Getopt::Long
15057
15058 default, posix_default, auto_abbrev, getopt_compat, gnu_compat, gnu_getopt,
15059 require_order, permute, bundling (default: disabled), bundling_override
15060 (default: disabled), ignore_case  (default: enabled), ignore_case_always
15061 (default: disabled), auto_version (default:disabled), auto_help
15062 (default:disabled), pass_through (default: disabled), prefix,
15063 prefix_pattern, debug (default: disabled)
15064
15065 =item Exportable Methods
15066
15067 VersionMessage, C<-message>, C<-msg>, C<-exitval>, C<-output>, HelpMessage
15068
15069 =item Return values and Errors
15070
15071 =item Legacy
15072
15073 =over 4
15074
15075 =item Default destinations
15076
15077 =item Alternative option starters
15078
15079 =item Configuration variables
15080
15081 =back
15082
15083 =item Trouble Shooting
15084
15085 =over 4
15086
15087 =item GetOptions does not return a false result when an option is not
15088 supplied
15089
15090 =item GetOptions does not split the command line correctly
15091
15092 =item Undefined subroutine &main::GetOptions called
15093
15094 =item How do I put a "-?" option into a Getopt::Long?
15095
15096 =back
15097
15098 =item AUTHOR
15099
15100 =item COPYRIGHT AND DISCLAIMER
15101
15102 =back
15103
15104 =head2 Getopt::Std, getopt - Process single-character switches with switch
15105 clustering
15106
15107 =over 4
15108
15109 =item SYNOPSIS
15110
15111 =item DESCRIPTION
15112
15113 =item C<--help> and C<--version>
15114
15115 =back
15116
15117 =head2 Hash::Util - A selection of general-utility hash subroutines
15118
15119 =over 4
15120
15121 =item SYNOPSIS
15122
15123 =item DESCRIPTION
15124
15125 =over 4
15126
15127 =item Restricted hashes
15128
15129 lock_keys, unlock_keys
15130
15131 =back
15132
15133 =back
15134
15135 lock_value, unlock_value
15136
15137 B<lock_hash>, B<unlock_hash>
15138
15139 B<hash_seed>
15140
15141 =over 4
15142
15143 =item CAVEATS
15144
15145 =item AUTHOR
15146
15147 =item SEE ALSO
15148
15149 =back
15150
15151 =head2 I18N::Collate - compare 8-bit scalar data according to the current
15152 locale
15153
15154 =over 4
15155
15156 =item SYNOPSIS
15157
15158 =item DESCRIPTION
15159
15160 =back
15161
15162 =head2 I18N::LangTags - functions for dealing with RFC3066-style language
15163 tags
15164
15165 =over 4
15166
15167 =item SYNOPSIS
15168
15169 =item DESCRIPTION
15170
15171 =back
15172
15173 the function is_language_tag($lang1)
15174
15175 the function extract_language_tags($whatever)
15176
15177 the function same_language_tag($lang1, $lang2)
15178
15179 the function similarity_language_tag($lang1, $lang2)
15180
15181 the function is_dialect_of($lang1, $lang2)
15182
15183 the function super_languages($lang1)
15184
15185 the function locale2language_tag($locale_identifier)
15186
15187 the function encode_language_tag($lang1)
15188
15189 the function alternate_language_tags($lang1)
15190
15191 the function @langs = panic_languages(@accept_languages)
15192
15193 =over 4
15194
15195 =item ABOUT LOWERCASING
15196
15197 =item ABOUT UNICODE PLAINTEXT LANGUAGE TAGS
15198
15199 =item SEE ALSO
15200
15201 =item COPYRIGHT
15202
15203 =item AUTHOR
15204
15205 =back
15206
15207 =head2 I18N::LangTags::List -- tags and names for human languages
15208
15209 =over 4
15210
15211 =item SYNOPSIS
15212
15213 =item DESCRIPTION
15214
15215 =item ABOUT LANGUAGE TAGS
15216
15217 =item LIST OF LANGUAGES
15218
15219 {ab} : Abkhazian, {ace} : Achinese, {ach} : Acoli, {ada} : Adangme, {ady} :
15220 Adyghe, {aa} : Afar, {afh} : Afrihili, {af} : Afrikaans, [{afa} :
15221 Afro-Asiatic (Other)], {ak} : Akan, {akk} : Akkadian, {sq} : Albanian,
15222 {ale} : Aleut, [{alg} : Algonquian languages], [{tut} : Altaic (Other)],
15223 {am} : Amharic, {i-ami} : Ami, [{apa} : Apache languages], {ar} : Arabic,
15224 {arc} : Aramaic, {arp} : Arapaho, {arn} : Araucanian, {arw} : Arawak, {hy}
15225 : Armenian, {an} : Aragonese, [{art} : Artificial (Other)], {ast} :
15226 Asturian, {as} : Assamese, [{ath} : Athapascan languages], [{aus} :
15227 Australian languages], [{map} : Austronesian (Other)], {av} : Avaric, {ae}
15228 : Avestan, {awa} : Awadhi, {ay} : Aymara, {az} : Azerbaijani, {ban} :
15229 Balinese, [{bat} : Baltic (Other)], {bal} : Baluchi, {bm} : Bambara, [{bai}
15230 : Bamileke languages], {bad} : Banda, [{bnt} : Bantu (Other)], {bas} :
15231 Basa, {ba} : Bashkir, {eu} : Basque, {btk} : Batak (Indonesia), {bej} :
15232 Beja, {be} : Belarusian, {bem} : Bemba, {bn} : Bengali, [{ber} : Berber
15233 (Other)], {bho} : Bhojpuri, {bh} : Bihari, {bik} : Bikol, {bin} : Bini,
15234 {bi} : Bislama, {bs} : Bosnian, {bra} : Braj, {br} : Breton, {bug} :
15235 Buginese, {bg} : Bulgarian, {i-bnn} : Bunun, {bua} : Buriat, {my} :
15236 Burmese, {cad} : Caddo, {car} : Carib, {ca} : Catalan, [{cau} : Caucasian
15237 (Other)], {ceb} : Cebuano, [{cel} : Celtic (Other)], [{cai} : Central
15238 American Indian (Other)], {chg} : Chagatai, [{cmc} : Chamic languages],
15239 {ch} : Chamorro, {ce} : Chechen, {chr} : Cherokee, {chy} : Cheyenne, {chb}
15240 : Chibcha, {ny} : Chichewa, {zh} : Chinese, {chn} : Chinook Jargon, {chp} :
15241 Chipewyan, {cho} : Choctaw, {cu} : Church Slavic, {chk} : Chuukese, {cv} :
15242 Chuvash, {cop} : Coptic, {kw} : Cornish, {co} : Corsican, {cr} : Cree,
15243 {mus} : Creek, [{cpe} : English-based Creoles and pidgins (Other)], [{cpf}
15244 : French-based Creoles and pidgins (Other)], [{cpp} : Portuguese-based
15245 Creoles and pidgins (Other)], [{crp} : Creoles and pidgins (Other)], {hr} :
15246 Croatian, [{cus} : Cushitic (Other)], {cs} : Czech, {dak} : Dakota, {da} :
15247 Danish, {dar} : Dargwa, {day} : Dayak, {i-default} : Default (Fallthru)
15248 Language, {del} : Delaware, {din} : Dinka, {dv} : Divehi, {doi} : Dogri,
15249 {dgr} : Dogrib, [{dra} : Dravidian (Other)], {dua} : Duala, {nl} : Dutch,
15250 {dum} : Middle Dutch (ca.1050-1350), {dyu} : Dyula, {dz} : Dzongkha, {efi}
15251 : Efik, {egy} : Ancient Egyptian, {eka} : Ekajuk, {elx} : Elamite, {en} :
15252 English, {enm} : Old English (1100-1500), {ang} : Old English
15253 (ca.450-1100), {i-enochian} : Enochian (Artificial), {myv} : Erzya, {eo} :
15254 Esperanto, {et} : Estonian, {ee} : Ewe, {ewo} : Ewondo, {fan} : Fang, {fat}
15255 : Fanti, {fo} : Faroese, {fj} : Fijian, {fi} : Finnish, [{fiu} :
15256 Finno-Ugrian (Other)], {fon} : Fon, {fr} : French, {frm} : Middle French
15257 (ca.1400-1600), {fro} : Old French (842-ca.1400), {fy} : Frisian, {fur} :
15258 Friulian, {ff} : Fulah, {gaa} : Ga, {gd} : Scots Gaelic, {gl} : Gallegan,
15259 {lg} : Ganda, {gay} : Gayo, {gba} : Gbaya, {gez} : Geez, {ka} : Georgian,
15260 {de} : German, {gmh} : Middle High German (ca.1050-1500), {goh} : Old High
15261 German (ca.750-1050), [{gem} : Germanic (Other)], {gil} : Gilbertese, {gon}
15262 : Gondi, {gor} : Gorontalo, {got} : Gothic, {grb} : Grebo, {grc} : Ancient
15263 Greek, {el} : Modern Greek, {gn} : Guarani, {gu} : Gujarati, {gwi} :
15264 Gwich'in, {hai} : Haida, {ht} : Haitian, {ha} : Hausa, {haw} : Hawaiian,
15265 {he} : Hebrew, {hz} : Herero, {hil} : Hiligaynon, {him} : Himachali, {hi} :
15266 Hindi, {ho} : Hiri Motu, {hit} : Hittite, {hmn} : Hmong, {hu} : Hungarian,
15267 {hup} : Hupa, {iba} : Iban, {is} : Icelandic, {io} : Ido, {ig} : Igbo,
15268 {ijo} : Ijo, {ilo} : Iloko, [{inc} : Indic (Other)], [{ine} : Indo-European
15269 (Other)], {id} : Indonesian, {inh} : Ingush, {ia} : Interlingua
15270 (International Auxiliary Language Association), {ie} : Interlingue, {iu} :
15271 Inuktitut, {ik} : Inupiaq, [{ira} : Iranian (Other)], {ga} : Irish, {mga} :
15272 Middle Irish (900-1200), {sga} : Old Irish (to 900), [{iro} : Iroquoian
15273 languages], {it} : Italian, {ja} : Japanese, {jv} : Javanese, {jrb} :
15274 Judeo-Arabic, {jpr} : Judeo-Persian, {kbd} : Kabardian, {kab} : Kabyle,
15275 {kac} : Kachin, {kl} : Kalaallisut, {xal} : Kalmyk, {kam} : Kamba, {kn} :
15276 Kannada, {kr} : Kanuri, {krc} : Karachay-Balkar, {kaa} : Kara-Kalpak, {kar}
15277 : Karen, {ks} : Kashmiri, {csb} : Kashubian, {kaw} : Kawi, {kk} : Kazakh,
15278 {kha} : Khasi, {km} : Khmer, [{khi} : Khoisan (Other)], {kho} : Khotanese,
15279 {ki} : Kikuyu, {kmb} : Kimbundu, {rw} : Kinyarwanda, {ky} : Kirghiz,
15280 {i-klingon} : Klingon, {kv} : Komi, {kg} : Kongo, {kok} : Konkani, {ko} :
15281 Korean, {kos} : Kosraean, {kpe} : Kpelle, {kro} : Kru, {kj} : Kuanyama,
15282 {kum} : Kumyk, {ku} : Kurdish, {kru} : Kurukh, {kut} : Kutenai, {lad} :
15283 Ladino, {lah} : Lahnda, {lam} : Lamba, {lo} : Lao, {la} : Latin, {lv} :
15284 Latvian, {lb} : Letzeburgesch, {lez} : Lezghian, {li} : Limburgish, {ln} :
15285 Lingala, {lt} : Lithuanian, {nds} : Low German, {art-lojban} : Lojban
15286 (Artificial), {loz} : Lozi, {lu} : Luba-Katanga, {lua} : Luba-Lulua, {lui}
15287 : Luiseno, {lun} : Lunda, {luo} : Luo (Kenya and Tanzania), {lus} : Lushai,
15288 {mk} : Macedonian, {mad} : Madurese, {mag} : Magahi, {mai} : Maithili,
15289 {mak} : Makasar, {mg} : Malagasy, {ms} : Malay, {ml} : Malayalam, {mt} :
15290 Maltese, {mnc} : Manchu, {mdr} : Mandar, {man} : Mandingo, {mni} :
15291 Manipuri, [{mno} : Manobo languages], {gv} : Manx, {mi} : Maori, {mr} :
15292 Marathi, {chm} : Mari, {mh} : Marshall, {mwr} : Marwari, {mas} : Masai,
15293 [{myn} : Mayan languages], {men} : Mende, {mic} : Micmac, {min} :
15294 Minangkabau, {i-mingo} : Mingo, [{mis} : Miscellaneous languages], {moh} :
15295 Mohawk, {mdf} : Moksha, {mo} : Moldavian, [{mkh} : Mon-Khmer (Other)],
15296 {lol} : Mongo, {mn} : Mongolian, {mos} : Mossi, [{mul} : Multiple
15297 languages], [{mun} : Munda languages], {nah} : Nahuatl, {nap} : Neapolitan,
15298 {na} : Nauru, {nv} : Navajo, {nd} : North Ndebele, {nr} : South Ndebele,
15299 {ng} : Ndonga, {ne} : Nepali, {new} : Newari, {nia} : Nias, [{nic} :
15300 Niger-Kordofanian (Other)], [{ssa} : Nilo-Saharan (Other)], {niu} : Niuean,
15301 {nog} : Nogai, {non} : Old Norse, [{nai} : North American Indian], {no} :
15302 Norwegian, {nb} : Norwegian Bokmal, {nn} : Norwegian Nynorsk, [{nub} :
15303 Nubian languages], {nym} : Nyamwezi, {nyn} : Nyankole, {nyo} : Nyoro, {nzi}
15304 : Nzima, {oc} : Occitan (post 1500), {oj} : Ojibwa, {or} : Oriya, {om} :
15305 Oromo, {osa} : Osage, {os} : Ossetian; Ossetic, [{oto} : Otomian
15306 languages], {pal} : Pahlavi, {i-pwn} : Paiwan, {pau} : Palauan, {pi} :
15307 Pali, {pam} : Pampanga, {pag} : Pangasinan, {pa} : Panjabi, {pap} :
15308 Papiamento, [{paa} : Papuan (Other)], {fa} : Persian, {peo} : Old Persian
15309 (ca.600-400 B.C.), [{phi} : Philippine (Other)], {phn} : Phoenician, {pon}
15310 : Pohnpeian, {pl} : Polish, {pt} : Portuguese, [{pra} : Prakrit languages],
15311 {pro} : Old Provencal (to 1500), {ps} : Pushto, {qu} : Quechua, {rm} :
15312 Raeto-Romance, {raj} : Rajasthani, {rap} : Rapanui, {rar} : Rarotongan,
15313 [{qaa - qtz} : Reserved for local use.], [{roa} : Romance (Other)], {ro} :
15314 Romanian, {rom} : Romany, {rn} : Rundi, {ru} : Russian, [{sal} : Salishan
15315 languages], {sam} : Samaritan Aramaic, {se} : Northern Sami, {sma} :
15316 Southern Sami, {smn} : Inari Sami, {smj} : Lule Sami, {sms} : Skolt Sami,
15317 [{smi} : Sami languages (Other)], {sm} : Samoan, {sad} : Sandawe, {sg} :
15318 Sango, {sa} : Sanskrit, {sat} : Santali, {sc} : Sardinian, {sas} : Sasak,
15319 {sco} : Scots, {sel} : Selkup, [{sem} : Semitic (Other)], {sr} : Serbian,
15320 {srr} : Serer, {shn} : Shan, {sn} : Shona, {sid} : Sidamo, {sgn-...} : Sign
15321 Languages, {bla} : Siksika, {sd} : Sindhi, {si} : Sinhalese, [{sit} :
15322 Sino-Tibetan (Other)], [{sio} : Siouan languages], {den} : Slave
15323 (Athapascan), [{sla} : Slavic (Other)], {sk} : Slovak, {sl} : Slovenian,
15324 {sog} : Sogdian, {so} : Somali, {son} : Songhai, {snk} : Soninke, {wen} :
15325 Sorbian languages, {nso} : Northern Sotho, {st} : Southern Sotho, [{sai} :
15326 South American Indian (Other)], {es} : Spanish, {suk} : Sukuma, {sux} :
15327 Sumerian, {su} : Sundanese, {sus} : Susu, {sw} : Swahili, {ss} : Swati,
15328 {sv} : Swedish, {syr} : Syriac, {tl} : Tagalog, {ty} : Tahitian, [{tai} :
15329 Tai (Other)], {tg} : Tajik, {tmh} : Tamashek, {ta} : Tamil, {i-tao} : Tao,
15330 {tt} : Tatar, {i-tay} : Tayal, {te} : Telugu, {ter} : Tereno, {tet} :
15331 Tetum, {th} : Thai, {bo} : Tibetan, {tig} : Tigre, {ti} : Tigrinya, {tem} :
15332 Timne, {tiv} : Tiv, {tli} : Tlingit, {tpi} : Tok Pisin, {tkl} : Tokelau,
15333 {tog} : Tonga (Nyasa), {to} : Tonga (Tonga Islands), {tsi} : Tsimshian,
15334 {ts} : Tsonga, {i-tsu} : Tsou, {tn} : Tswana, {tum} : Tumbuka, [{tup} :
15335 Tupi languages], {tr} : Turkish, {ota} : Ottoman Turkish (1500-1928), {crh}
15336 : Crimean Turkish, {tk} : Turkmen, {tvl} : Tuvalu, {tyv} : Tuvinian, {tw} :
15337 Twi, {udm} : Udmurt, {uga} : Ugaritic, {ug} : Uighur, {uk} : Ukrainian,
15338 {umb} : Umbundu, {und} : Undetermined, {ur} : Urdu, {uz} : Uzbek, {vai} :
15339 Vai, {ve} : Venda, {vi} : Vietnamese, {vo} : Volapuk, {vot} : Votic, [{wak}
15340 : Wakashan languages], {wa} : Walloon, {wal} : Walamo, {war} : Waray, {was}
15341 : Washo, {cy} : Welsh, {wo} : Wolof, {x-...} : Unregistered (Semi-Private
15342 Use), {xh} : Xhosa, {sah} : Yakut, {yao} : Yao, {yap} : Yapese, {ii} :
15343 Sichuan Yi, {yi} : Yiddish, {yo} : Yoruba, [{ypk} : Yupik languages], {znd}
15344 : Zande, [{zap} : Zapotec], {zen} : Zenaga, {za} : Zhuang, {zu} : Zulu,
15345 {zun} : Zuni
15346
15347 =item SEE ALSO
15348
15349 =item COPYRIGHT AND DISCLAIMER
15350
15351 =item AUTHOR
15352
15353 =back
15354
15355 =head2 I18N::Langinfo - query locale information
15356
15357 =over 4
15358
15359 =item SYNOPSIS
15360
15361 =item DESCRIPTION
15362
15363 =over 4
15364
15365 =item EXPORT
15366
15367 =back
15368
15369 =item SEE ALSO
15370
15371 =item AUTHOR
15372
15373 =item COPYRIGHT AND LICENSE
15374
15375 =back
15376
15377 =head2 IO - load various IO modules
15378
15379 =over 4
15380
15381 =item SYNOPSIS
15382
15383 =item DESCRIPTION
15384
15385 =item DEPRECATED
15386
15387 =back
15388
15389 =head2 IO::Dir - supply object methods for directory handles
15390
15391 =over 4
15392
15393 =item SYNOPSIS
15394
15395 =item DESCRIPTION
15396
15397 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
15398 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
15399
15400 =item SEE ALSO
15401
15402 =item AUTHOR
15403
15404 =item COPYRIGHT
15405
15406 =back
15407
15408 =head2 IO::File - supply object methods for filehandles
15409
15410 =over 4
15411
15412 =item SYNOPSIS
15413
15414 =item DESCRIPTION
15415
15416 =item CONSTRUCTOR
15417
15418 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
15419
15420 =item METHODS
15421
15422 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
15423
15424 =item SEE ALSO
15425
15426 =item HISTORY
15427
15428 =back
15429
15430 =head2 IO::Handle - supply object methods for I/O handles
15431
15432 =over 4
15433
15434 =item SYNOPSIS
15435
15436 =item DESCRIPTION
15437
15438 =item CONSTRUCTOR
15439
15440 new (), new_from_fd ( FD, MODE )
15441
15442 =item METHODS
15443
15444 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
15445 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
15446 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
15447 $io->blocking ( [ BOOL ] ), $io->untaint
15448
15449 =item NOTE
15450
15451 =item SEE ALSO
15452
15453 =item BUGS
15454
15455 =item HISTORY
15456
15457 =back
15458
15459 =head2 IO::Pipe - supply object methods for pipes
15460
15461 =over 4
15462
15463 =item SYNOPSIS
15464
15465 =item DESCRIPTION
15466
15467 =item CONSTRUCTOR
15468
15469 new ( [READER, WRITER] )
15470
15471 =item METHODS
15472
15473 reader ([ARGS]), writer ([ARGS]), handles ()
15474
15475 =item SEE ALSO
15476
15477 =item AUTHOR
15478
15479 =item COPYRIGHT
15480
15481 =back
15482
15483 =head2 IO::Poll - Object interface to system poll call
15484
15485 =over 4
15486
15487 =item SYNOPSIS
15488
15489 =item DESCRIPTION
15490
15491 =item METHODS
15492
15493 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
15494 IO ), handles( [ EVENT_MASK ] )
15495
15496 =item SEE ALSO
15497
15498 =item AUTHOR
15499
15500 =item COPYRIGHT
15501
15502 =back
15503
15504 =head2 IO::Seekable - supply seek based methods for I/O objects
15505
15506 =over 4
15507
15508 =item SYNOPSIS
15509
15510 =item DESCRIPTION
15511
15512 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
15513 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
15514 $io->tell
15515
15516 =item SEE ALSO
15517
15518 =item HISTORY
15519
15520 =back
15521
15522 =head2 IO::Select - OO interface to the select system call
15523
15524 =over 4
15525
15526 =item SYNOPSIS
15527
15528 =item DESCRIPTION
15529
15530 =item CONSTRUCTOR
15531
15532 new ( [ HANDLES ] )
15533
15534 =item METHODS
15535
15536 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
15537 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
15538 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
15539
15540 =item EXAMPLE
15541
15542 =item AUTHOR
15543
15544 =item COPYRIGHT
15545
15546 =back
15547
15548 =head2 IO::Socket - Object interface to socket communications
15549
15550 =over 4
15551
15552 =item SYNOPSIS
15553
15554 =item DESCRIPTION
15555
15556 =item CONSTRUCTOR
15557
15558 new ( [ARGS] )
15559
15560 =item METHODS
15561
15562 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
15563 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
15564
15565 =item SEE ALSO
15566
15567 =item AUTHOR
15568
15569 =item COPYRIGHT
15570
15571 =back
15572
15573 =head2 IO::Socket::INET - Object interface for AF_INET domain sockets
15574
15575 =over 4
15576
15577 =item SYNOPSIS
15578
15579 =item DESCRIPTION
15580
15581 =item CONSTRUCTOR
15582
15583 new ( [ARGS] )
15584
15585 =over 4
15586
15587 =item METHODS
15588
15589 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
15590 ()
15591
15592 =back
15593
15594 =item SEE ALSO
15595
15596 =item AUTHOR
15597
15598 =item COPYRIGHT
15599
15600 =back
15601
15602 =head2 IO::Socket::UNIX - Object interface for AF_UNIX domain sockets
15603
15604 =over 4
15605
15606 =item SYNOPSIS
15607
15608 =item DESCRIPTION
15609
15610 =item CONSTRUCTOR
15611
15612 new ( [ARGS] )
15613
15614 =item METHODS
15615
15616 hostpath(), peerpath()
15617
15618 =item SEE ALSO
15619
15620 =item AUTHOR
15621
15622 =item COPYRIGHT
15623
15624 =back
15625
15626 =head2 IO::lib::IO::Dir, IO::Dir - supply object methods for directory
15627 handles
15628
15629 =over 4
15630
15631 =item SYNOPSIS
15632
15633 =item DESCRIPTION
15634
15635 new ( [ DIRNAME ] ), open ( DIRNAME ), read (), seek ( POS ), tell (),
15636 rewind (), close (), tie %hash, 'IO::Dir', DIRNAME [, OPTIONS ]
15637
15638 =item SEE ALSO
15639
15640 =item AUTHOR
15641
15642 =item COPYRIGHT
15643
15644 =back
15645
15646 =head2 IO::lib::IO::File, IO::File - supply object methods for filehandles
15647
15648 =over 4
15649
15650 =item SYNOPSIS
15651
15652 =item DESCRIPTION
15653
15654 =item CONSTRUCTOR
15655
15656 new ( FILENAME [,MODE [,PERMS]] ), new_tmpfile
15657
15658 =item METHODS
15659
15660 open( FILENAME [,MODE [,PERMS]] ), open( FILENAME, IOLAYERS )
15661
15662 =item SEE ALSO
15663
15664 =item HISTORY
15665
15666 =back
15667
15668 =head2 IO::lib::IO::Handle, IO::Handle - supply object methods for I/O
15669 handles
15670
15671 =over 4
15672
15673 =item SYNOPSIS
15674
15675 =item DESCRIPTION
15676
15677 =item CONSTRUCTOR
15678
15679 new (), new_from_fd ( FD, MODE )
15680
15681 =item METHODS
15682
15683 $io->fdopen ( FD, MODE ), $io->opened, $io->getline, $io->getlines,
15684 $io->ungetc ( ORD ), $io->write ( BUF, LEN [, OFFSET ] ), $io->error,
15685 $io->clearerr, $io->sync, $io->flush, $io->printflush ( ARGS ),
15686 $io->blocking ( [ BOOL ] ), $io->untaint
15687
15688 =item NOTE
15689
15690 =item SEE ALSO
15691
15692 =item BUGS
15693
15694 =item HISTORY
15695
15696 =back
15697
15698 =head2 IO::lib::IO::Pipe, IO::Pipe - supply object methods for pipes
15699
15700 =over 4
15701
15702 =item SYNOPSIS
15703
15704 =item DESCRIPTION
15705
15706 =item CONSTRUCTOR
15707
15708 new ( [READER, WRITER] )
15709
15710 =item METHODS
15711
15712 reader ([ARGS]), writer ([ARGS]), handles ()
15713
15714 =item SEE ALSO
15715
15716 =item AUTHOR
15717
15718 =item COPYRIGHT
15719
15720 =back
15721
15722 =head2 IO::lib::IO::Poll, IO::Poll - Object interface to system poll call
15723
15724 =over 4
15725
15726 =item SYNOPSIS
15727
15728 =item DESCRIPTION
15729
15730 =item METHODS
15731
15732 mask ( IO [, EVENT_MASK ] ), poll ( [ TIMEOUT ] ), events ( IO ), remove (
15733 IO ), handles( [ EVENT_MASK ] )
15734
15735 =item SEE ALSO
15736
15737 =item AUTHOR
15738
15739 =item COPYRIGHT
15740
15741 =back
15742
15743 =head2 IO::lib::IO::Seekable, IO::Seekable - supply seek based methods for
15744 I/O objects
15745
15746 =over 4
15747
15748 =item SYNOPSIS
15749
15750 =item DESCRIPTION
15751
15752 $io->getpos, $io->setpos, $io->seek ( POS, WHENCE ), WHENCE=0 (SEEK_SET),
15753 WHENCE=1 (SEEK_CUR), WHENCE=2 (SEEK_END), $io->sysseek( POS, WHENCE ),
15754 $io->tell
15755
15756 =item SEE ALSO
15757
15758 =item HISTORY
15759
15760 =back
15761
15762 =head2 IO::lib::IO::Select, IO::Select - OO interface to the select system
15763 call
15764
15765 =over 4
15766
15767 =item SYNOPSIS
15768
15769 =item DESCRIPTION
15770
15771 =item CONSTRUCTOR
15772
15773 new ( [ HANDLES ] )
15774
15775 =item METHODS
15776
15777 add ( HANDLES ), remove ( HANDLES ), exists ( HANDLE ), handles, can_read (
15778 [ TIMEOUT ] ), can_write ( [ TIMEOUT ] ), has_exception ( [ TIMEOUT ] ),
15779 count (), bits(), select ( READ, WRITE, EXCEPTION [, TIMEOUT ] )
15780
15781 =item EXAMPLE
15782
15783 =item AUTHOR
15784
15785 =item COPYRIGHT
15786
15787 =back
15788
15789 =head2 IO::lib::IO::Socket, IO::Socket - Object interface to socket
15790 communications
15791
15792 =over 4
15793
15794 =item SYNOPSIS
15795
15796 =item DESCRIPTION
15797
15798 =item CONSTRUCTOR
15799
15800 new ( [ARGS] )
15801
15802 =item METHODS
15803
15804 accept([PKG]), socketpair(DOMAIN, TYPE, PROTOCOL), atmark, connected,
15805 protocol, sockdomain, sockopt(OPT [, VAL]), socktype, timeout([VAL])
15806
15807 =item SEE ALSO
15808
15809 =item AUTHOR
15810
15811 =item COPYRIGHT
15812
15813 =back
15814
15815 =head2 IO::lib::IO::Socket::INET, IO::Socket::INET - Object interface for
15816 AF_INET domain sockets
15817
15818 =over 4
15819
15820 =item SYNOPSIS
15821
15822 =item DESCRIPTION
15823
15824 =item CONSTRUCTOR
15825
15826 new ( [ARGS] )
15827
15828 =over 4
15829
15830 =item METHODS
15831
15832 sockaddr (), sockport (), sockhost (), peeraddr (), peerport (), peerhost
15833 ()
15834
15835 =back
15836
15837 =item SEE ALSO
15838
15839 =item AUTHOR
15840
15841 =item COPYRIGHT
15842
15843 =back
15844
15845 =head2 IO::lib::IO::Socket::UNIX, IO::Socket::UNIX - Object interface for
15846 AF_UNIX domain sockets
15847
15848 =over 4
15849
15850 =item SYNOPSIS
15851
15852 =item DESCRIPTION
15853
15854 =item CONSTRUCTOR
15855
15856 new ( [ARGS] )
15857
15858 =item METHODS
15859
15860 hostpath(), peerpath()
15861
15862 =item SEE ALSO
15863
15864 =item AUTHOR
15865
15866 =item COPYRIGHT
15867
15868 =back
15869
15870 =head2 IPC::Msg - SysV Msg IPC object class
15871
15872 =over 4
15873
15874 =item SYNOPSIS
15875
15876 =item DESCRIPTION
15877
15878 =item METHODS
15879
15880 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
15881 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
15882 FLAGS ] ), stat
15883
15884 =item SEE ALSO
15885
15886 =item AUTHOR
15887
15888 =item COPYRIGHT
15889
15890 =back
15891
15892 =head2 IPC::Open2, open2 - open a process for both reading and writing
15893
15894 =over 4
15895
15896 =item SYNOPSIS
15897
15898 =item DESCRIPTION
15899
15900 =item WARNING 
15901
15902 =item SEE ALSO
15903
15904 =back
15905
15906 =head2 IPC::Open3, open3 - open a process for reading, writing, and error
15907 handling
15908
15909 =over 4
15910
15911 =item SYNOPSIS
15912
15913 =item DESCRIPTION
15914
15915 =item WARNING
15916
15917 =back
15918
15919 =head2 IPC::Semaphore - SysV Semaphore IPC object class
15920
15921 =over 4
15922
15923 =item SYNOPSIS
15924
15925 =item DESCRIPTION
15926
15927 =item METHODS
15928
15929 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
15930 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
15931 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
15932 , VALUE ), stat
15933
15934 =item SEE ALSO
15935
15936 =item AUTHOR
15937
15938 =item COPYRIGHT
15939
15940 =back
15941
15942 =head2 IPC::SysV - SysV IPC constants
15943
15944 =over 4
15945
15946 =item SYNOPSIS
15947
15948 =item DESCRIPTION
15949
15950 ftok( PATH, ID )
15951
15952 =item SEE ALSO
15953
15954 =item AUTHORS
15955
15956 =item COPYRIGHT
15957
15958 =back
15959
15960 =head2 IPC::SysV::Msg, IPC::Msg - SysV Msg IPC object class
15961
15962 =over 4
15963
15964 =item SYNOPSIS
15965
15966 =item DESCRIPTION
15967
15968 =item METHODS
15969
15970 new ( KEY , FLAGS ), id, rcv ( BUF, LEN [, TYPE [, FLAGS ]] ), remove, set
15971 ( STAT ), set ( NAME => VALUE [, NAME => VALUE ...] ), snd ( TYPE, MSG [,
15972 FLAGS ] ), stat
15973
15974 =item SEE ALSO
15975
15976 =item AUTHOR
15977
15978 =item COPYRIGHT
15979
15980 =back
15981
15982 =head2 IPC::SysV::Semaphore, IPC::Semaphore - SysV Semaphore IPC object
15983 class
15984
15985 =over 4
15986
15987 =item SYNOPSIS
15988
15989 =item DESCRIPTION
15990
15991 =item METHODS
15992
15993 new ( KEY , NSEMS , FLAGS ), getall, getncnt ( SEM ), getpid ( SEM ),
15994 getval ( SEM ), getzcnt ( SEM ), id, op ( OPLIST ), remove, set ( STAT ),
15995 set ( NAME => VALUE [, NAME => VALUE ...] ), setall ( VALUES ), setval ( N
15996 , VALUE ), stat
15997
15998 =item SEE ALSO
15999
16000 =item AUTHOR
16001
16002 =item COPYRIGHT
16003
16004 =back
16005
16006 =head2 List::Util - A selection of general-utility list subroutines
16007
16008 =over 4
16009
16010 =item SYNOPSIS
16011
16012 =item DESCRIPTION
16013
16014 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
16015 BLOCK LIST, shuffle LIST, sum LIST
16016
16017 =item KNOWN BUGS
16018
16019 =item SUGGESTED ADDITIONS
16020
16021 =item COPYRIGHT
16022
16023 =back
16024
16025 =head2 List::Utilib::List::Util, List::Util - A selection of
16026 general-utility list subroutines
16027
16028 =over 4
16029
16030 =item SYNOPSIS
16031
16032 =item DESCRIPTION
16033
16034 first BLOCK LIST, max LIST, maxstr LIST, min LIST, minstr LIST, reduce
16035 BLOCK LIST, shuffle LIST, sum LIST
16036
16037 =item KNOWN BUGS
16038
16039 =item SUGGESTED ADDITIONS
16040
16041 =item COPYRIGHT
16042
16043 =back
16044
16045 =head2 List::Utilib::Scalar::Util, Scalar::Util - A selection of
16046 general-utility scalar subroutines
16047
16048 =over 4
16049
16050 =item SYNOPSIS
16051
16052 =item DESCRIPTION
16053
16054 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
16055 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
16056 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
16057
16058 =item KNOWN BUGS
16059
16060 =item COPYRIGHT
16061
16062 =item BLATANT PLUG
16063
16064 =back
16065
16066 =head2 Locale::Constants - constants for Locale codes
16067
16068 =over 4
16069
16070 =item SYNOPSIS
16071
16072 =item DESCRIPTION
16073
16074 =item KNOWN BUGS AND LIMITATIONS
16075
16076 =item SEE ALSO
16077
16078 Locale::Language, Locale::Country, Locale::Script, Locale::Currency
16079
16080 =item AUTHOR
16081
16082 =item COPYRIGHT
16083
16084 =back
16085
16086 =head2 Locale::Country - ISO codes for country identification (ISO 3166)
16087
16088 =over 4
16089
16090 =item SYNOPSIS
16091
16092 =item DESCRIPTION
16093
16094 B<alpha-2>, B<alpha-3>, B<numeric>
16095
16096 =item CONVERSION ROUTINES
16097
16098 code2country( CODE, [ CODESET ] ), country2code( STRING, [ CODESET ] ),
16099 country_code2code( CODE, CODESET, CODESET )
16100
16101 =item QUERY ROUTINES
16102
16103 C<all_country_codes( [ CODESET ] )>, C<all_country_names( [ CODESET ] )>
16104
16105 =item SEMI-PRIVATE ROUTINES
16106
16107 =over 4
16108
16109 =item alias_code
16110
16111 =item rename_country
16112
16113 =back
16114
16115 =item EXAMPLES
16116
16117 =item DOMAIN NAMES
16118
16119 =item KNOWN BUGS AND LIMITATIONS
16120
16121 =item SEE ALSO
16122
16123 Locale::Language, Locale::Script, Locale::Currency, Locale::SubCountry, ISO
16124 3166-1, http://www.iso.org/iso/en/prods-services/iso3166ma/index.html,
16125 http://www.egt.ie/standards/iso3166/iso3166-1-en.html,
16126 http://www.cia.gov/cia/publications/factbook/docs/app-d-1.html
16127
16128 =item AUTHOR
16129
16130 =item COPYRIGHT
16131
16132 =back
16133
16134 =head2 Locale::Currency - ISO three letter codes for currency
16135 identification (ISO 4217)
16136
16137 =over 4
16138
16139 =item SYNOPSIS
16140
16141 =item DESCRIPTION
16142
16143 XTS, XXX
16144
16145 =item CONVERSION ROUTINES
16146
16147 code2currency(), currency2code()
16148
16149 =item QUERY ROUTINES
16150
16151 C<all_currency_codes()>, C<all_currency_names()>
16152
16153 =item EXAMPLES
16154
16155 =item KNOWN BUGS AND LIMITATIONS
16156
16157 =item SEE ALSO
16158
16159 Locale::Country, Locale::Script, ISO 4217:1995,
16160 http://www.bsi-global.com/iso4217currency
16161
16162 =item AUTHOR
16163
16164 =item COPYRIGHT
16165
16166 =back
16167
16168 =head2 Locale::Language - ISO two letter codes for language identification
16169 (ISO 639)
16170
16171 =over 4
16172
16173 =item SYNOPSIS
16174
16175 =item DESCRIPTION
16176
16177 =item CONVERSION ROUTINES
16178
16179 code2language(), language2code()
16180
16181 =item QUERY ROUTINES
16182
16183 C<all_language_codes()>, C<all_language_names()>
16184
16185 =item EXAMPLES
16186
16187 =item KNOWN BUGS AND LIMITATIONS
16188
16189 =item SEE ALSO
16190
16191 Locale::Country, Locale::Script, Locale::Currency, ISO 639:1988 (E/F),
16192 http://lcweb.loc.gov/standards/iso639-2/langhome.html
16193
16194 =item AUTHOR
16195
16196 =item COPYRIGHT
16197
16198 =back
16199
16200 =head2 Locale::Maketext - framework for localization
16201
16202 =over 4
16203
16204 =item SYNOPSIS
16205
16206 =item DESCRIPTION
16207
16208 =item QUICK OVERVIEW
16209
16210 =item METHODS
16211
16212 =over 4
16213
16214 =item Construction Methods
16215
16216 =item The "maketext" Method
16217
16218 $lh->fail_with I<or> $lh->fail_with(I<PARAM>), $lh->failure_handler_auto
16219
16220 =item Utility Methods
16221
16222 $language->quant($number, $singular), $language->quant($number, $singular,
16223 $plural), $language->quant($number, $singular, $plural, $negative),
16224 $language->numf($number), $language->sprintf($format, @items),
16225 $language->language_tag(), $language->encoding()
16226
16227 =item Language Handle Attributes and Internals
16228
16229 =back
16230
16231 =item LANGUAGE CLASS HIERARCHIES
16232
16233 =item ENTRIES IN EACH LEXICON
16234
16235 =item BRACKET NOTATION
16236
16237 =item AUTO LEXICONS
16238
16239 =item CONTROLLING LOOKUP FAILURE
16240
16241 =item HOW TO USE MAKETEXT
16242
16243 =item SEE ALSO
16244
16245 =item COPYRIGHT AND DISCLAIMER
16246
16247 =item AUTHOR
16248
16249 =back
16250
16251 =head2 Locale::Maketext::TPJ13 -- article about software localization
16252
16253 =over 4
16254
16255 =item SYNOPSIS
16256
16257 =item DESCRIPTION
16258
16259 =item Localization and Perl: gettext breaks, Maketext fixes
16260
16261 =over 4
16262
16263 =item A Localization Horror Story: It Could Happen To You
16264
16265 =item The Linguistic View
16266
16267 =item Breaking gettext
16268
16269 =item Replacing gettext
16270
16271 =item Buzzwords: Abstraction and Encapsulation
16272
16273 =item Buzzword: Isomorphism
16274
16275 =item Buzzword: Inheritance
16276
16277 =item Buzzword: Concision
16278
16279 =item The Devil in the Details
16280
16281 =item The Proof in the Pudding: Localizing Web Sites
16282
16283 =item References
16284
16285 =back
16286
16287 =back
16288
16289 =head2 Locale::Script - ISO codes for script identification (ISO 15924)
16290
16291 =over 4
16292
16293 =item SYNOPSIS
16294
16295 =item DESCRIPTION
16296
16297 B<alpha-2>, B<alpha-3>, B<numeric>
16298
16299 =over 4
16300
16301 =item SPECIAL CODES
16302
16303 =back
16304
16305 =item CONVERSION ROUTINES
16306
16307 code2script( CODE, [ CODESET ] ), script2code( STRING, [ CODESET ] ),
16308 script_code2code( CODE, CODESET, CODESET )
16309
16310 =item QUERY ROUTINES
16311
16312 C<all_script_codes ( [ CODESET ] )>, C<all_script_names ( [ CODESET ] )>
16313
16314 =item EXAMPLES
16315
16316 =item KNOWN BUGS AND LIMITATIONS
16317
16318 =item SEE ALSO
16319
16320 Locale::Language, Locale::Currency, Locale::Country, ISO 15924,
16321 http://www.evertype.com/standards/iso15924/
16322
16323 =item AUTHOR
16324
16325 =item COPYRIGHT
16326
16327 =back
16328
16329 =head2 MIME::Base64 - Encoding and decoding of base64 strings
16330
16331 =over 4
16332
16333 =item SYNOPSIS
16334
16335 =item DESCRIPTION
16336
16337 encode_base64($str), encode_base64($str, $eol);, decode_base64($str)
16338
16339 =item DIAGNOSTICS
16340
16341 Premature end of base64 data, Premature padding of base64 data
16342
16343 =item EXAMPLES
16344
16345 =item COPYRIGHT
16346
16347 =item SEE ALSO
16348
16349 =back
16350
16351 =head2 MIME::Base64::QuotedPrint, MIME::QuotedPrint - Encoding and decoding
16352 of quoted-printable strings
16353
16354 =over 4
16355
16356 =item SYNOPSIS
16357
16358 =item DESCRIPTION
16359
16360 encode_qp($str), encode_qp($str, $eol), decode_qp($str);
16361
16362 =item COPYRIGHT
16363
16364 =item SEE ALSO
16365
16366 =back
16367
16368 =head2 MIME::QuotedPrint - Encoding and decoding of quoted-printable
16369 strings
16370
16371 =over 4
16372
16373 =item SYNOPSIS
16374
16375 =item DESCRIPTION
16376
16377 encode_qp($str), encode_qp($str, $eol), decode_qp($str);
16378
16379 =item COPYRIGHT
16380
16381 =item SEE ALSO
16382
16383 =back
16384
16385 =head2 Math::BigFloat - Arbitrary size floating point math package
16386
16387 =over 4
16388
16389 =item SYNOPSIS
16390
16391 =item DESCRIPTION
16392
16393 =over 4
16394
16395 =item Canonical notation
16396
16397 =item Output
16398
16399 =item C<mantissa()>, C<exponent()> and C<parts()>
16400
16401 =item Accuracy vs. Precision
16402
16403 =item Rounding
16404
16405 ffround ( +$scale ), ffround ( -$scale ), ffround ( 0 ), fround  ( +$scale
16406 ), fround  ( -$scale ) and fround ( 0 )
16407
16408 =back
16409
16410 =item EXAMPLES
16411
16412   # not ready yet
16413
16414 =item Autocreating constants
16415
16416 =over 4
16417
16418 =item Math library
16419
16420 =item Using Math::BigInt::Lite
16421
16422 =back
16423
16424 =item BUGS
16425
16426 =item CAVEATS
16427
16428 stringify, bstr(), bdiv, Modifying and =, bpow
16429
16430 =item SEE ALSO
16431
16432 =item LICENSE
16433
16434 =item AUTHORS
16435
16436 =back
16437
16438 =head2 Math::BigInt - Arbitrary size integer math package
16439
16440 =over 4
16441
16442 =item SYNOPSIS
16443
16444 =item DESCRIPTION
16445
16446 Input, Output
16447
16448 =item METHODS
16449
16450 =over 4
16451
16452 =item config
16453
16454 =item accuracy
16455
16456 =item precision
16457
16458 =item brsft
16459
16460 =item new
16461
16462 =item bnan
16463
16464 =item bzero
16465
16466 =item binf
16467
16468 =item bone
16469
16470 =item is_one()/is_zero()/is_nan()/is_inf()
16471
16472 =item is_positive()/is_negative()
16473
16474         $x->is_positive();              # true if >= 0
16475         $x->is_negative();              # true if <  0
16476
16477 =item is_odd()/is_even()/is_int()
16478
16479 =item bcmp
16480
16481 =item bacmp
16482
16483 =item sign
16484
16485 =item bcmp
16486
16487 =item bneg
16488
16489 =item babs
16490
16491 =item bnorm
16492
16493 =item bnot
16494
16495 =item binc
16496
16497 =item bdec
16498
16499 =item badd
16500
16501 =item bsub
16502
16503 =item bmul
16504
16505 =item bdiv
16506
16507 =item bmod
16508
16509 =item bmodinv
16510
16511 =item bmodpow
16512
16513 =item bpow
16514
16515 =item blsft
16516
16517 =item brsft
16518
16519 =item band
16520
16521 =item bior
16522
16523 =item bxor
16524
16525 =item bnot
16526
16527 =item bsqrt
16528
16529 =item bfac
16530
16531 =item round
16532
16533 =item bround
16534
16535 =item bfround
16536
16537 =item bfloor
16538
16539 =item bceil
16540
16541 =item bgcd
16542
16543 =item blcm
16544
16545 =item exponent
16546
16547 =item mantissa
16548
16549 =item parts
16550
16551 =item copy
16552
16553 =item as_number
16554
16555 =item bsstr
16556
16557 =item as_hex
16558
16559 =item as_bin
16560
16561 =back
16562
16563 =item ACCURACY and PRECISION
16564
16565 =over 4
16566
16567 =item Precision P
16568
16569 =item Accuracy A
16570
16571 =item Fallback F
16572
16573 =item Rounding mode R
16574
16575 'trunc', 'even', 'odd', '+inf', '-inf', 'zero', Precision, Accuracy
16576 (significant digits), Setting/Accessing, Creating numbers, Usage,
16577 Precedence, Overriding globals, Local settings, Rounding, Default values,
16578 Remarks
16579
16580 =back
16581
16582 =item INTERNALS
16583
16584 =over 4
16585
16586 =item MATH LIBRARY
16587
16588 =item SIGN
16589
16590 =item mantissa(), exponent() and parts()
16591
16592 =back
16593
16594 =item EXAMPLES
16595
16596   use Math::BigInt;
16597
16598 =item Autocreating constants
16599
16600 =item PERFORMANCE
16601
16602 =over 4
16603
16604 =item Alternative math libraries
16605
16606 =item SUBCLASSING
16607
16608 =back
16609
16610 =item Subclassing Math::BigInt
16611
16612 =item UPGRADING
16613
16614 =over 4
16615
16616 =item Auto-upgrade
16617
16618 bsqrt(), div(), blog()
16619
16620 =back
16621
16622 =item BUGS
16623
16624 broot() does not work, Out of Memory!, Fails to load Calc on Perl prior
16625 5.6.0
16626
16627 =item CAVEATS
16628
16629 stringify, bstr(), bsstr() and 'cmp', int(), length, bdiv, infinity
16630 handling, Modifying and =, bpow, Overloading -$x, Mixing different object
16631 types, bsqrt(), brsft()
16632
16633 =item LICENSE
16634
16635 =item SEE ALSO
16636
16637 =item AUTHORS
16638
16639 =back
16640
16641 =head2 Math::BigInt::Calc - Pure Perl module to support Math::BigInt
16642
16643 =over 4
16644
16645 =item SYNOPSIS
16646
16647 =item DESCRIPTION
16648
16649 =item STORAGE
16650
16651 =item METHODS
16652
16653 =item WRAP YOUR OWN
16654
16655 =item LICENSE
16656
16657 This program is free software; you may redistribute it and/or modify it
16658 under
16659 the same terms as Perl itself. 
16660
16661 =item AUTHORS
16662
16663 =item SEE ALSO
16664
16665 =back
16666
16667 =head2 Math::BigInt::Scalar - Pure Perl module to test Math::BigInt with
16668 scalars
16669
16670 =over 4
16671
16672 =item SYNOPSIS
16673
16674 =item DESCRIPTION
16675
16676 =item LICENSE
16677
16678 This program is free software; you may redistribute it and/or modify it
16679 under
16680 the same terms as Perl itself. 
16681
16682 =item AUTHOR
16683
16684 =item SEE ALSO
16685
16686 =back
16687
16688 =head2 Math::BigRat - arbitrarily big rationals
16689
16690 =over 4
16691
16692 =item SYNOPSIS
16693
16694 =item DESCRIPTION
16695
16696 =over 4
16697
16698 =item MATH LIBRARY
16699
16700 =back
16701
16702 =item METHODS
16703
16704 =over 4
16705
16706 =item new()
16707
16708 =item numerator()
16709
16710 =item denominator()
16711
16712         $d = $x->denominator();
16713
16714 =item parts()
16715
16716 =item as_number()
16717
16718 =item bfac()
16719
16720 =item blog()
16721
16722 =item bround()/round()/bfround()
16723
16724 =item bmod()
16725
16726 =item is_one()
16727
16728 =item is_zero()
16729
16730 =item is_positive()
16731
16732 =item is_negative()
16733
16734 =item is_int()
16735
16736 =item is_odd()
16737
16738 =item is_even()
16739
16740 =item bceil()
16741
16742 =item bfloor()
16743
16744         $x->bfloor();
16745
16746 =item config
16747
16748 =back
16749
16750 =item BUGS
16751
16752 inf handling (partial), NaN handling (partial), rounding (not implemented
16753 except for bceil/bfloor), $x ** $y where $y is not an integer
16754
16755 =item LICENSE
16756
16757 =item SEE ALSO
16758
16759 =item AUTHORS
16760
16761 =back
16762
16763 =head2 Math::Complex - complex numbers and associated mathematical
16764 functions
16765
16766 =over 4
16767
16768 =item SYNOPSIS
16769
16770 =item DESCRIPTION
16771
16772 =item OPERATIONS
16773
16774 =item CREATION
16775
16776 =item STRINGIFICATION
16777
16778 =over 4
16779
16780 =item CHANGED IN PERL 5.6
16781
16782 =back
16783
16784 =item USAGE
16785
16786 =item ERRORS DUE TO DIVISION BY ZERO OR LOGARITHM OF ZERO
16787
16788 =item ERRORS DUE TO INDIGESTIBLE ARGUMENTS
16789
16790 =item BUGS
16791
16792 =item AUTHORS
16793
16794 =back
16795
16796 =head2 Math::Trig - trigonometric functions
16797
16798 =over 4
16799
16800 =item SYNOPSIS
16801
16802 =item DESCRIPTION
16803
16804 =item TRIGONOMETRIC FUNCTIONS
16805
16806 B<tan>
16807
16808 =over 4
16809
16810 =item ERRORS DUE TO DIVISION BY ZERO
16811
16812 =item SIMPLE (REAL) ARGUMENTS, COMPLEX RESULTS
16813
16814 =back
16815
16816 =item PLANE ANGLE CONVERSIONS
16817
16818 =item RADIAL COORDINATE CONVERSIONS
16819
16820 =over 4
16821
16822 =item COORDINATE SYSTEMS
16823
16824 =item 3-D ANGLE CONVERSIONS
16825
16826 cartesian_to_cylindrical, cartesian_to_spherical, cylindrical_to_cartesian,
16827 cylindrical_to_spherical, spherical_to_cartesian, spherical_to_cylindrical
16828
16829 =back
16830
16831 =item GREAT CIRCLE DISTANCES AND DIRECTIONS
16832
16833 =item EXAMPLES
16834
16835 =over 4
16836
16837 =item CAVEAT FOR GREAT CIRCLE FORMULAS
16838
16839 =back
16840
16841 =item BUGS
16842
16843 =item AUTHORS
16844
16845 =back
16846
16847 =head2 Memoize - Make functions faster by trading space for time
16848
16849 =over 4
16850
16851 =item SYNOPSIS
16852
16853 =item DESCRIPTION
16854
16855 =item DETAILS
16856
16857 =item OPTIONS
16858
16859 =over 4
16860
16861 =item INSTALL
16862
16863 =item NORMALIZER
16864
16865 =item C<SCALAR_CACHE>, C<LIST_CACHE>
16866
16867 C<MEMORY>, C<HASH>, C<TIE>, C<FAULT>, C<MERGE>
16868
16869 =back
16870
16871 =item OTHER FACILITIES
16872
16873 =over 4
16874
16875 =item C<unmemoize>
16876
16877 =item C<flush_cache>
16878
16879 =back
16880
16881 =item CAVEATS
16882
16883 =item PERSISTENT CACHE SUPPORT
16884
16885 =item EXPIRATION SUPPORT
16886
16887 =item BUGS
16888
16889 =item MAILING LIST
16890
16891 =item AUTHOR
16892
16893 =item COPYRIGHT AND LICENSE
16894
16895 =item THANK YOU
16896
16897 =back
16898
16899 =head2 Memoize::AnyDBM_File - glue to provide EXISTS for AnyDBM_File for
16900 Storable use
16901
16902 =over 4
16903
16904 =item DESCRIPTION
16905
16906 =back
16907
16908 =head2 Memoize::Expire - Plug-in module for automatic expiration of
16909 memoized values
16910
16911 =over 4
16912
16913 =item SYNOPSIS
16914
16915 =item DESCRIPTION
16916
16917 =item INTERFACE
16918
16919  TIEHASH,  EXISTS,  STORE
16920
16921 =item ALTERNATIVES
16922
16923 =item CAVEATS
16924
16925 =item AUTHOR
16926
16927 =item SEE ALSO
16928
16929 =back
16930
16931 =head2 Memoize::ExpireFile - test for Memoize expiration semantics
16932
16933 =over 4
16934
16935 =item DESCRIPTION
16936
16937 =back
16938
16939 =head2 Memoize::ExpireTest - test for Memoize expiration semantics
16940
16941 =over 4
16942
16943 =item DESCRIPTION
16944
16945 =back
16946
16947 =head2 Memoize::NDBM_File - glue to provide EXISTS for NDBM_File for
16948 Storable use
16949
16950 =over 4
16951
16952 =item DESCRIPTION
16953
16954 =back
16955
16956 =head2 Memoize::SDBM_File - glue to provide EXISTS for SDBM_File for
16957 Storable use
16958
16959 =over 4
16960
16961 =item DESCRIPTION
16962
16963 =back
16964
16965 =head2 Memoize::Storable - store Memoized data in Storable database
16966
16967 =over 4
16968
16969 =item DESCRIPTION
16970
16971 =back
16972
16973 =head2 NDBM_File - Tied access to ndbm files
16974
16975 =over 4
16976
16977 =item SYNOPSIS
16978
16979 =item DESCRIPTION
16980
16981 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
16982
16983 =item DIAGNOSTICS
16984
16985 =over 4
16986
16987 =item C<ndbm store returned -1, errno 22, key "..." at ...>
16988
16989 =back
16990
16991 =item BUGS AND WARNINGS
16992
16993 =back
16994
16995 =head2 NEXT - Provide a pseudo-class NEXT (et al) that allows method
16996 redispatch
16997
16998 =over 4
16999
17000 =item SYNOPSIS
17001
17002 =item DESCRIPTION
17003
17004 =over 4
17005
17006 =item Enforcing redispatch
17007
17008 =item Avoiding repetitions
17009
17010 =item Invoking all versions of a method with a single call
17011
17012 =item Using C<EVERY> methods
17013
17014 =back
17015
17016 =item AUTHOR
17017
17018 =item BUGS AND IRRITATIONS
17019
17020 =item COPYRIGHT
17021
17022 =back
17023
17024 =head2 Net::Cmd - Network Command class (as used by FTP, SMTP etc)
17025
17026 =over 4
17027
17028 =item SYNOPSIS
17029
17030 =item DESCRIPTION
17031
17032 =item USER METHODS
17033
17034 debug ( VALUE ), message (), code (), ok (), status (), datasend ( DATA ),
17035 dataend ()
17036
17037 =item CLASS METHODS
17038
17039 debug_print ( DIR, TEXT ), debug_text ( TEXT ), command ( CMD [, ARGS, ...
17040 ]), unsupported (), response (), parse_response ( TEXT ), getline (),
17041 ungetline ( TEXT ), rawdatasend ( DATA ), read_until_dot (), tied_fh ()
17042
17043 =item EXPORTS
17044
17045 =item AUTHOR
17046
17047 =item COPYRIGHT
17048
17049 =back
17050
17051 =head2 Net::Config - Local configuration data for libnet
17052
17053 =over 4
17054
17055 =item SYNOPSYS
17056
17057 =item DESCRIPTION
17058
17059 =item METHODS
17060
17061 requires_firewall HOST
17062
17063 =item NetConfig VALUES
17064
17065 nntp_hosts, snpp_hosts, pop3_hosts, smtp_hosts, ph_hosts, daytime_hosts,
17066 time_hosts, inet_domain, ftp_firewall, ftp_firewall_type, ftp_ext_passive,
17067 ftp_int_pasive, local_netmask, test_hosts, test_exists
17068
17069 =back
17070
17071 =head2 Net::Domain - Attempt to evaluate the current host's internet name
17072 and domain
17073
17074 =over 4
17075
17076 =item SYNOPSIS
17077
17078 =item DESCRIPTION
17079
17080 hostfqdn (), hostname (), hostdomain ()
17081
17082 =item AUTHOR
17083
17084 =item COPYRIGHT
17085
17086 =back
17087
17088 =head2 Net::FTP - FTP Client class
17089
17090 =over 4
17091
17092 =item SYNOPSIS
17093
17094 =item DESCRIPTION
17095
17096 =item OVERVIEW
17097
17098 =item CONSTRUCTOR
17099
17100 new (HOST [,OPTIONS])
17101
17102 =item METHODS
17103
17104 login ([LOGIN [,PASSWORD [, ACCOUNT] ] ]), authorize ( [AUTH [, RESP]]),
17105 site (ARGS), ascii, binary, rename ( OLDNAME, NEWNAME ), delete ( FILENAME
17106 ), cwd ( [ DIR ] ), cdup (), pwd (), restart ( WHERE ), rmdir ( DIR [,
17107 RECURSE ]), mkdir ( DIR [, RECURSE ]), ls ( [ DIR ] ), alloc ( SIZE [,
17108 RECORD_SIZE] ), dir ( [ DIR ] ), get ( REMOTE_FILE [, LOCAL_FILE [, WHERE]]
17109 ), put ( LOCAL_FILE [, REMOTE_FILE ] ), put_unique ( LOCAL_FILE [,
17110 REMOTE_FILE ] ), append ( LOCAL_FILE [, REMOTE_FILE ] ), unique_name (),
17111 mdtm ( FILE ), size ( FILE ), supported ( CMD ), hash (
17112 [FILEHANDLE_GLOB_REF],[ BYTES_PER_HASH_MARK] ), nlst ( [ DIR ] ), list ( [
17113 DIR ] ), retr ( FILE ), stor ( FILE ), stou ( FILE ), appe ( FILE ), port (
17114 [ PORT ] ), pasv (), pasv_xfer ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ),
17115 pasv_xfer_unique ( SRC_FILE, DEST_SERVER [, DEST_FILE ] ), pasv_wait (
17116 NON_PASV_SERVER ), abort (), quit ()
17117
17118 =over 4
17119
17120 =item Methods for the adventurous
17121
17122 quot (CMD [,ARGS])
17123
17124 =back
17125
17126 =item THE dataconn CLASS
17127
17128 read ( BUFFER, SIZE [, TIMEOUT ] ), write ( BUFFER, SIZE [, TIMEOUT ] ),
17129 bytes_read (), abort (), close ()
17130
17131 =item UNIMPLEMENTED
17132
17133 B<SMNT>, B<HELP>, B<MODE>, B<SYST>, B<STAT>, B<STRU>, B<REIN>
17134
17135 =item REPORTING BUGS
17136
17137 =item AUTHOR
17138
17139 =item SEE ALSO
17140
17141 =item USE EXAMPLES
17142
17143 http://www.csh.rit.edu/~adam/Progs/
17144
17145 =item CREDITS
17146
17147 =item COPYRIGHT
17148
17149 =back
17150
17151 =head2 Net::NNTP - NNTP Client class
17152
17153 =over 4
17154
17155 =item SYNOPSIS
17156
17157 =item DESCRIPTION
17158
17159 =item CONSTRUCTOR
17160
17161 new ( [ HOST ] [, OPTIONS ])
17162
17163 =item METHODS
17164
17165 article ( [ MSGID|MSGNUM ], [FH] ), body ( [ MSGID|MSGNUM ], [FH] ), head (
17166 [ MSGID|MSGNUM ], [FH] ), articlefh ( [ MSGID|MSGNUM ] ), bodyfh ( [
17167 MSGID|MSGNUM ] ), headfh ( [ MSGID|MSGNUM ] ), nntpstat ( [ MSGID|MSGNUM ]
17168 ), group ( [ GROUP ] ), ihave ( MSGID [, MESSAGE ]), last (), date (),
17169 postok (), authinfo ( USER, PASS ), list (), newgroups ( SINCE [,
17170 DISTRIBUTIONS ]), newnews ( SINCE [, GROUPS [, DISTRIBUTIONS ]]), next (),
17171 post ( [ MESSAGE ] ), postfh (), slave (), quit ()
17172
17173 =over 4
17174
17175 =item Extension methods
17176
17177 newsgroups ( [ PATTERN ] ), distributions (), subscriptions (),
17178 overview_fmt (), active_times (), active ( [ PATTERN ] ), xgtitle ( PATTERN
17179 ), xhdr ( HEADER, MESSAGE-SPEC ), xover ( MESSAGE-SPEC ), xpath (
17180 MESSAGE-ID ), xpat ( HEADER, PATTERN, MESSAGE-SPEC), xrover, listgroup ( [
17181 GROUP ] ), reader
17182
17183 =back
17184
17185 =item UNSUPPORTED
17186
17187 =item DEFINITIONS
17188
17189 MESSAGE-SPEC, PATTERN, Examples, C<[^]-]>, C<*bdc>, C<[0-9a-zA-Z]>, C<a??d>
17190
17191 =item SEE ALSO
17192
17193 =item AUTHOR
17194
17195 =item COPYRIGHT
17196
17197 =back
17198
17199 =head2 Net::POP3 - Post Office Protocol 3 Client class (RFC1939)
17200
17201 =over 4
17202
17203 =item SYNOPSIS
17204
17205 =item DESCRIPTION
17206
17207 =item CONSTRUCTOR
17208
17209 new ( [ HOST, ] [ OPTIONS ] )
17210
17211 =item METHODS
17212
17213 user ( USER ), pass ( PASS ), login ( [ USER [, PASS ]] ), apop ( [ USER [,
17214 PASS ]] ), top ( MSGNUM [, NUMLINES ] ), list ( [ MSGNUM ] ), get ( MSGNUM
17215 [, FH ] ), getfh ( MSGNUM ), last (), popstat (), ping ( USER ), uidl ( [
17216 MSGNUM ] ), delete ( MSGNUM ), reset (), quit ()
17217
17218 =item NOTES
17219
17220 =item SEE ALSO
17221
17222 =item AUTHOR
17223
17224 =item COPYRIGHT
17225
17226 =back
17227
17228 =head2 Net::Ping - check a remote host for reachability
17229
17230 =over 4
17231
17232 =item SYNOPSIS
17233
17234 =item DESCRIPTION
17235
17236 =over 4
17237
17238 =item Functions
17239
17240 Net::Ping->new([$proto [, $def_timeout [, $bytes [, $device [, $tos
17241 ]]]]]);, $p->ping($host [, $timeout]);, $p->source_verify( { 0 | 1 } );,
17242 $p->service_check( { 0 | 1 } );, $p->tcp_service_check( { 0 | 1 } );,
17243 $p->hires( { 0 | 1 } );, $p->bind($local_addr);, $p->open($host);, $p->ack(
17244 [ $host ] );, $p->nack( $failed_ack_host );, $p->close();, pingecho($host
17245 [, $timeout]);
17246
17247 =back
17248
17249 =item NOTES
17250
17251 =item INSTALL
17252
17253 =item BUGS
17254
17255 =item AUTHORS
17256
17257 =item COPYRIGHT
17258
17259 =back
17260
17261 =head2 Net::SMTP - Simple Mail Transfer Protocol Client
17262
17263 =over 4
17264
17265 =item SYNOPSIS
17266
17267 =item DESCRIPTION
17268
17269 =item EXAMPLES
17270
17271 =item CONSTRUCTOR
17272
17273 new Net::SMTP [ HOST, ] [ OPTIONS ]
17274
17275 =item METHODS
17276
17277 banner (), domain (), hello ( DOMAIN ), etrn ( DOMAIN ), auth ( USERNAME,
17278 PASSWORD ), mail ( ADDRESS [, OPTIONS] ), send ( ADDRESS ), send_or_mail (
17279 ADDRESS ), send_and_mail ( ADDRESS ), reset (), recipient ( ADDRESS [,
17280 ADDRESS [ ...]] [, OPTIONS ] ), to ( ADDRESS [, ADDRESS [...]] ), cc (
17281 ADDRESS [, ADDRESS [...]] ), bcc ( ADDRESS [, ADDRESS [...]] ), data ( [
17282 DATA ] ), expand ( ADDRESS ), verify ( ADDRESS ), help ( [ $subject ] ),
17283 quit ()
17284
17285 =item ADDRESSES
17286
17287 =item SEE ALSO
17288
17289 =item AUTHOR
17290
17291 =item COPYRIGHT
17292
17293 =back
17294
17295 =head2 Net::Time - time and daytime network client interface
17296
17297 =over 4
17298
17299 =item SYNOPSIS
17300
17301 =item DESCRIPTION
17302
17303 inet_time ( [HOST [, PROTOCOL [, TIMEOUT]]]), inet_daytime ( [HOST [,
17304 PROTOCOL [, TIMEOUT]]])
17305
17306 =item AUTHOR
17307
17308 =item COPYRIGHT
17309
17310 =back
17311
17312 =head2 Net::hostent - by-name interface to Perl's built-in gethost*()
17313 functions
17314
17315 =over 4
17316
17317 =item SYNOPSIS
17318
17319 =item DESCRIPTION
17320
17321 =item EXAMPLES
17322
17323 =item NOTE
17324
17325 =item AUTHOR
17326
17327 =back
17328
17329 =head2 Net::libnetFAQ, libnetFAQ - libnet Frequently Asked Questions
17330
17331 =over 4
17332
17333 =item DESCRIPTION
17334
17335 =over 4
17336
17337 =item Where to get this document
17338
17339 =item How to contribute to this document
17340
17341 =back
17342
17343 =item Author and Copyright Information
17344
17345 =over 4
17346
17347 =item Disclaimer
17348
17349 =back
17350
17351 =item Obtaining and installing libnet
17352
17353 =over 4
17354
17355 =item What is libnet ?
17356
17357 =item Which version of perl do I need ?
17358
17359 =item What other modules do I need ?
17360
17361 =item What machines support libnet ?
17362
17363 =item Where can I get the latest libnet release
17364
17365 =back
17366
17367 =item Using Net::FTP
17368
17369 =over 4
17370
17371 =item How do I download files from an FTP server ?
17372
17373 =item How do I transfer files in binary mode ?
17374
17375 =item How can I get the size of a file on a remote FTP server ?
17376
17377 =item How can I get the modification time of a file on a remote FTP server
17378 ?
17379
17380 =item How can I change the permissions of a file on a remote server ?
17381
17382 =item Can I do a reget operation like the ftp command ?
17383
17384 =item How do I get a directory listing from an FTP server ?
17385
17386 =item Changing directory to "" does not fail ?
17387
17388 =item I am behind a SOCKS firewall, but the Firewall option does not work ?
17389
17390 =item I am behind an FTP proxy firewall, but cannot access machines outside
17391 ?
17392
17393 =item My ftp proxy firewall does not listen on port 21
17394
17395 =item Is it possible to change the file permissions of a file on an FTP
17396 server ?
17397
17398 =item I have seen scripts call a method message, but cannot find it
17399 documented ?
17400
17401 =item Why does Net::FTP not implement mput and mget methods
17402
17403 =back
17404
17405 =item Using Net::SMTP
17406
17407 =over 4
17408
17409 =item Why can't the part of an Email address after the @ be used as the
17410 hostname ?
17411
17412 =item Why does Net::SMTP not do DNS MX lookups ?
17413
17414 =item The verify method always returns true ?
17415
17416 =back
17417
17418 =item Debugging scripts
17419
17420 =over 4
17421
17422 =item How can I debug my scripts that use Net::* modules ?
17423
17424 =back
17425
17426 =item AUTHOR AND COPYRIGHT
17427
17428 =back
17429
17430 =head2 Net::netent - by-name interface to Perl's built-in getnet*()
17431 functions
17432
17433 =over 4
17434
17435 =item SYNOPSIS
17436
17437 =item DESCRIPTION
17438
17439 =item EXAMPLES
17440
17441 =item NOTE
17442
17443 =item AUTHOR
17444
17445 =back
17446
17447 =head2 Net::protoent - by-name interface to Perl's built-in getproto*()
17448 functions
17449
17450 =over 4
17451
17452 =item SYNOPSIS
17453
17454 =item DESCRIPTION
17455
17456 =item NOTE
17457
17458 =item AUTHOR
17459
17460 =back
17461
17462 =head2 Net::servent - by-name interface to Perl's built-in getserv*()
17463 functions
17464
17465 =over 4
17466
17467 =item SYNOPSIS
17468
17469 =item DESCRIPTION
17470
17471 =item EXAMPLES
17472
17473 =item NOTE
17474
17475 =item AUTHOR
17476
17477 =back
17478
17479 =head2 Netrc, Net::Netrc - OO interface to users netrc file
17480
17481 =over 4
17482
17483 =item SYNOPSIS
17484
17485 =item DESCRIPTION
17486
17487 =item THE .netrc FILE
17488
17489 machine name, default, login name, password string, account string, macdef
17490 name
17491
17492 =item CONSTRUCTOR
17493
17494 lookup ( MACHINE [, LOGIN ])
17495
17496 =item METHODS
17497
17498 login (), password (), account (), lpa ()
17499
17500 =item AUTHOR
17501
17502 =item SEE ALSO
17503
17504 =item COPYRIGHT
17505
17506 =back
17507
17508 =head2 O - Generic interface to Perl Compiler backends
17509
17510 =over 4
17511
17512 =item SYNOPSIS
17513
17514 =item DESCRIPTION
17515
17516 =item CONVENTIONS
17517
17518 =item IMPLEMENTATION
17519
17520 =item BUGS
17521
17522 =item AUTHOR
17523
17524 =back
17525
17526 =head2 ODBM_File - Tied access to odbm files
17527
17528 =over 4
17529
17530 =item SYNOPSIS
17531
17532 =item DESCRIPTION
17533
17534 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
17535
17536 =item DIAGNOSTICS
17537
17538 =over 4
17539
17540 =item C<odbm store returned -1, errno 22, key "..." at ...>
17541
17542 =back
17543
17544 =item BUGS AND WARNINGS
17545
17546 =back
17547
17548 =head2 Opcode - Disable named opcodes when compiling perl code
17549
17550 =over 4
17551
17552 =item SYNOPSIS
17553
17554 =item DESCRIPTION
17555
17556 =item NOTE
17557
17558 =item WARNING
17559
17560 =item Operator Names and Operator Lists
17561
17562 an operator name (opname), an operator tag name (optag), a negated opname
17563 or optag, an operator set (opset)
17564
17565 =item Opcode Functions
17566
17567 opcodes, opset (OP, ...), opset_to_ops (OPSET), opset_to_hex (OPSET),
17568 full_opset, empty_opset, invert_opset (OPSET), verify_opset (OPSET, ...),
17569 define_optag (OPTAG, OPSET), opmask_add (OPSET), opmask, opdesc (OP, ...),
17570 opdump (PAT)
17571
17572 =item Manipulating Opsets
17573
17574 =item TO DO (maybe)
17575
17576 =back
17577
17578 =over 4
17579
17580 =item Predefined Opcode Tags
17581
17582 :base_core, :base_mem, :base_loop, :base_io, :base_orig, :base_math,
17583 :base_thread, :default, :filesys_read, :sys_db, :browse, :filesys_open,
17584 :filesys_write, :subprocess, :ownprocess, :others, :still_to_be_decided,
17585 :dangerous
17586
17587 =item SEE ALSO
17588
17589 =item AUTHORS
17590
17591 =back
17592
17593 =head2 Opcode::Safe, Safe - Compile and execute code in restricted
17594 compartments
17595
17596 =over 4
17597
17598 =item SYNOPSIS
17599
17600 =item DESCRIPTION
17601
17602 a new namespace, an operator mask
17603
17604 =item WARNING
17605
17606 =over 4
17607
17608 =item RECENT CHANGES
17609
17610 =item Methods in class Safe
17611
17612 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
17613 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
17614 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
17615 root (NAMESPACE), mask (MASK)
17616
17617 =item Some Safety Issues
17618
17619 Memory, CPU, Snooping, Signals, State Changes
17620
17621 =item AUTHOR
17622
17623 =back
17624
17625 =back
17626
17627 =head2 Opcode::ops, ops - Perl pragma to restrict unsafe operations when
17628 compiling
17629
17630 =over 4
17631
17632 =item SYNOPSIS  
17633
17634 =item DESCRIPTION
17635
17636 =item SEE ALSO
17637
17638 =back
17639
17640 =head2 POSIX - Perl interface to IEEE Std 1003.1
17641
17642 =over 4
17643
17644 =item SYNOPSIS
17645
17646 =item DESCRIPTION
17647
17648 =item NOTE
17649
17650 =item CAVEATS 
17651
17652 =item FUNCTIONS
17653
17654 _exit, abort, abs, access, acos, alarm, asctime, asin, assert, atan, atan2,
17655 atexit, atof, atoi, atol, bsearch, calloc, ceil, chdir, chmod, chown,
17656 clearerr, clock, close, closedir, cos, cosh, creat, ctermid, ctime,
17657 cuserid, difftime, div, dup, dup2, errno, execl, execle, execlp, execv,
17658 execve, execvp, exit, exp, fabs, fclose, fcntl, fdopen, feof, ferror,
17659 fflush, fgetc, fgetpos, fgets, fileno, floor, fmod, fopen, fork, fpathconf,
17660 fprintf, fputc, fputs, fread, free, freopen, frexp, fscanf, fseek, fsetpos,
17661 fstat, fsync, ftell, fwrite, getc, getchar, getcwd, getegid, getenv,
17662 geteuid, getgid, getgrgid, getgrnam, getgroups, getlogin, getpgrp, getpid,
17663 getppid, getpwnam, getpwuid, gets, getuid, gmtime, isalnum, isalpha,
17664 isatty, iscntrl, isdigit, isgraph, islower, isprint, ispunct, isspace,
17665 isupper, isxdigit, kill, labs, ldexp, ldiv, link, localeconv, localtime,
17666 log, log10, longjmp, lseek, malloc, mblen, mbstowcs, mbtowc, memchr,
17667 memcmp, memcpy, memmove, memset, mkdir, mkfifo, mktime, modf, nice,
17668 offsetof, open, opendir, pathconf, pause, perror, pipe, pow, printf, putc,
17669 putchar, puts, qsort, raise, rand, read, readdir, realloc, remove, rename,
17670 rewind, rewinddir, rmdir, scanf, setgid, setjmp, setlocale, setpgid,
17671 setsid, setuid, sigaction, siglongjmp, sigpending, sigprocmask, sigsetjmp,
17672 sigsuspend, sin, sinh, sleep, sprintf, sqrt, srand, sscanf, stat, strcat,
17673 strchr, strcmp, strcoll, strcpy, strcspn, strerror, strftime, strlen,
17674 strncat, strncmp, strncpy, strpbrk, strrchr, strspn, strstr, strtod,
17675 strtok, strtol, strtoul, strxfrm, sysconf, system, tan, tanh, tcdrain,
17676 tcflow, tcflush, tcgetpgrp, tcsendbreak, tcsetpgrp, time, times, tmpfile,
17677 tmpnam, tolower, toupper, ttyname, tzname, tzset, umask, uname, ungetc,
17678 unlink, utime, vfprintf, vprintf, vsprintf, wait, waitpid, wcstombs,
17679 wctomb, write
17680
17681 =item CLASSES
17682
17683 =over 4
17684
17685 =item POSIX::SigAction
17686
17687 new, handler, mask, flags, safe
17688
17689 =item POSIX::SigSet
17690
17691 new, addset, delset, emptyset, fillset, ismember
17692
17693 =item POSIX::Termios
17694
17695 new, getattr, getcc, getcflag, getiflag, getispeed, getlflag, getoflag,
17696 getospeed, setattr, setcc, setcflag, setiflag, setispeed, setlflag,
17697 setoflag, setospeed, Baud rate values, Terminal interface values, c_cc
17698 field values, c_cflag field values, c_iflag field values, c_lflag field
17699 values, c_oflag field values
17700
17701 =back
17702
17703 =item PATHNAME CONSTANTS
17704
17705 Constants
17706
17707 =item POSIX CONSTANTS
17708
17709 Constants
17710
17711 =item SYSTEM CONFIGURATION
17712
17713 Constants
17714
17715 =item ERRNO
17716
17717 Constants
17718
17719 =item FCNTL
17720
17721 Constants
17722
17723 =item FLOAT
17724
17725 Constants
17726
17727 =item LIMITS
17728
17729 Constants
17730
17731 =item LOCALE
17732
17733 Constants
17734
17735 =item MATH
17736
17737 Constants
17738
17739 =item SIGNAL
17740
17741 Constants
17742
17743 =item STAT
17744
17745 Constants, Macros
17746
17747 =item STDLIB
17748
17749 Constants
17750
17751 =item STDIO
17752
17753 Constants
17754
17755 =item TIME
17756
17757 Constants
17758
17759 =item UNISTD
17760
17761 Constants
17762
17763 =item WAIT
17764
17765 Constants, WNOHANG, WUNTRACED, Macros, WIFEXITED, WEXITSTATUS, WIFSIGNALED,
17766 WTERMSIG, WIFSTOPPED, WSTOPSIG
17767
17768 =back
17769
17770 =head2 PerlIO - On demand loader for PerlIO layers and root of PerlIO::*
17771 name space
17772
17773 =over 4
17774
17775 =item SYNOPSIS
17776
17777 =item DESCRIPTION
17778
17779 :unix, :stdio, :perlio, :crlf, :mmap, :utf8, :bytes, :raw, :pop, :win32
17780
17781 =over 4
17782
17783 =item Custom Layers
17784
17785 :encoding, :via
17786
17787 =item Alternatives to raw
17788
17789 =item Defaults and how to override them
17790
17791 =item Querying the layers of filehandles
17792
17793 =back
17794
17795 =item AUTHOR
17796
17797 =item SEE ALSO
17798
17799 =back
17800
17801 =head2 PerlIO::encoding - encoding layer
17802
17803 =over 4
17804
17805 =item SYNOPSIS
17806
17807 =item DESCRIPTION
17808
17809 =item SEE ALSO
17810
17811 =back
17812
17813 =head2 PerlIO::scalar - in-memory IO, scalar IO
17814
17815 =over 4
17816
17817 =item SYNOPSIS
17818
17819 =item DESCRIPTION
17820
17821 =item IMPLEMENTATION NOTE
17822
17823 =back
17824
17825 =head2 PerlIO::via - Helper class for PerlIO layers implemented in perl
17826
17827 =over 4
17828
17829 =item SYNOPSIS
17830
17831 =item DESCRIPTION
17832
17833 =item EXPECTED METHODS
17834
17835 $class->PUSHED([$mode[,$fh]]), $obj->POPPED([$fh]),
17836 $obj->UTF8($bellowFlag,[$fh]), $obj->OPEN($path,$mode[,$fh]),
17837 $obj->BINMODE([,$fh]), $obj->FDOPEN($fd[,$fh]),
17838 $obj->SYSOPEN($path,$imode,$perm,[,$fh]), $obj->FILENO($fh),
17839 $obj->READ($buffer,$len,$fh), $obj->WRITE($buffer,$fh), $obj->FILL($fh),
17840 $obj->CLOSE($fh), $obj->SEEK($posn,$whence,$fh), $obj->TELL($fh),
17841 $obj->UNREAD($buffer,$fh), $obj->FLUSH($fh), $obj->SETLINEBUF($fh),
17842 $obj->CLEARERR($fh), $obj->ERROR($fh), $obj->EOF($fh)
17843
17844 =item EXAMPLES
17845
17846 =over 4
17847
17848 =item Example - a Hexadecimal Handle
17849
17850 =back
17851
17852 =back
17853
17854 =head2 PerlIO::via::QuotedPrint - PerlIO layer for quoted-printable strings
17855
17856 =over 4
17857
17858 =item SYNOPSIS
17859
17860 =item DESCRIPTION
17861
17862 =item SEE ALSO
17863
17864 =item ACKNOWLEDGEMENTS
17865
17866 =item COPYRIGHT
17867
17868 =back
17869
17870 =head2 Pod::Checker, podchecker() - check pod documents for syntax errors
17871
17872 =over 4
17873
17874 =item SYNOPSIS
17875
17876 =item OPTIONS/ARGUMENTS
17877
17878 =over 4
17879
17880 =item podchecker()
17881
17882 B<-warnings> =E<gt> I<val>
17883
17884 =back
17885
17886 =item DESCRIPTION
17887
17888 =item DIAGNOSTICS
17889
17890 =over 4
17891
17892 =item Errors
17893
17894 empty =headn, =over on line I<N> without closing =back, =item without
17895 previous =over, =back without previous =over, No argument for =begin, =end
17896 without =begin, Nested =begin's, =for without formatter specification,
17897 unresolved internal link I<NAME>, Unknown command "I<CMD>", Unknown
17898 interior-sequence "I<SEQ>", nested commands
17899 I<CMD>E<lt>...I<CMD>E<lt>...E<gt>...E<gt>, garbled entity I<STRING>, Entity
17900 number out of range, malformed link LE<lt>E<gt>, nonempty ZE<lt>E<gt>,
17901 empty XE<lt>E<gt>, Spurious text after =pod / =cut, Spurious character(s)
17902 after =back
17903
17904 =item Warnings
17905
17906 multiple occurrence of link target I<name>, line containing nothing but
17907 whitespace in paragraph, file does not start with =head, previous =item has
17908 no contents, preceding non-item paragraph(s), =item type mismatch (I<one>
17909 vs. I<two>), I<N> unescaped C<E<lt>E<gt>> in paragraph, Unknown entity, No
17910 items in =over, No argument for =item, empty section in previous paragraph,
17911 Verbatim paragraph in NAME section, =headI<n> without preceding higher
17912 level
17913
17914 =item Hyperlinks
17915
17916 ignoring leading/trailing whitespace in link, (section) in '$page'
17917 deprecated, alternative text/node '%s' contains non-escaped | or /
17918
17919 =back
17920
17921 =item RETURN VALUE
17922
17923 =item EXAMPLES
17924
17925 =item INTERFACE
17926
17927 =back
17928
17929 C<Pod::Checker-E<gt>new( %options )>
17930
17931 C<$checker-E<gt>poderror( @args )>, C<$checker-E<gt>poderror( {%opts},
17932 @args )>
17933
17934 C<$checker-E<gt>num_errors()>
17935
17936 C<$checker-E<gt>num_warnings()>
17937
17938 C<$checker-E<gt>name()>
17939
17940 C<$checker-E<gt>node()>
17941
17942 C<$checker-E<gt>idx()>
17943
17944 C<$checker-E<gt>hyperlink()>
17945
17946 =over 4
17947
17948 =item AUTHOR
17949
17950 =back
17951
17952 =head2 Pod::Find - find POD documents in directory trees
17953
17954 =over 4
17955
17956 =item SYNOPSIS
17957
17958 =item DESCRIPTION
17959
17960 =back
17961
17962 =over 4
17963
17964 =item C<pod_find( { %opts } , @directories )>
17965
17966 C<-verbose =E<gt> 1>, C<-perl =E<gt> 1>, C<-script =E<gt> 1>, C<-inc =E<gt>
17967 1>
17968
17969 =back
17970
17971 =over 4
17972
17973 =item C<simplify_name( $str )>
17974
17975 =back
17976
17977 =over 4
17978
17979 =item C<pod_where( { %opts }, $pod )>
17980
17981 C<-inc =E<gt> 1>, C<-dirs =E<gt> [ $dir1, $dir2, ... ]>, C<-verbose =E<gt>
17982 1>
17983
17984 =back
17985
17986 =over 4
17987
17988 =item C<contains_pod( $file , $verbose )>
17989
17990 =back
17991
17992 =over 4
17993
17994 =item AUTHOR
17995
17996 =item SEE ALSO
17997
17998 =back
17999
18000 =head2 Pod::Html - module to convert pod files to HTML
18001
18002 =over 4
18003
18004 =item SYNOPSIS
18005
18006 =item DESCRIPTION
18007
18008 =item ARGUMENTS
18009
18010 backlink, cachedir, css, flush, header, help, htmldir, htmlroot, index,
18011 infile, libpods, netscape, outfile, podpath, podroot, quiet, recurse,
18012 title, verbose
18013
18014 =item EXAMPLE
18015
18016 =item ENVIRONMENT
18017
18018 =item AUTHOR
18019
18020 =item SEE ALSO
18021
18022 =item COPYRIGHT
18023
18024 =back
18025
18026 =head2 Pod::InputObjects - objects representing POD input paragraphs,
18027 commands, etc.
18028
18029 =over 4
18030
18031 =item SYNOPSIS
18032
18033 =item REQUIRES
18034
18035 =item EXPORTS
18036
18037 =item DESCRIPTION
18038
18039 package B<Pod::InputSource>, package B<Pod::Paragraph>, package
18040 B<Pod::InteriorSequence>, package B<Pod::ParseTree>
18041
18042 =back
18043
18044 =over 4
18045
18046 =item B<Pod::InputSource>
18047
18048 =back
18049
18050 =over 4
18051
18052 =item B<new()>
18053
18054 =back
18055
18056 =over 4
18057
18058 =item B<name()>
18059
18060 =back
18061
18062 =over 4
18063
18064 =item B<handle()>
18065
18066 =back
18067
18068 =over 4
18069
18070 =item B<was_cutting()>
18071
18072 =back
18073
18074 =over 4
18075
18076 =item B<Pod::Paragraph>
18077
18078 =back
18079
18080 =over 4
18081
18082 =item Pod::Paragraph-E<gt>B<new()>
18083
18084 =back
18085
18086 =over 4
18087
18088 =item $pod_para-E<gt>B<cmd_name()>
18089
18090 =back
18091
18092 =over 4
18093
18094 =item $pod_para-E<gt>B<text()>
18095
18096 =back
18097
18098 =over 4
18099
18100 =item $pod_para-E<gt>B<raw_text()>
18101
18102 =back
18103
18104 =over 4
18105
18106 =item $pod_para-E<gt>B<cmd_prefix()>
18107
18108 =back
18109
18110 =over 4
18111
18112 =item $pod_para-E<gt>B<cmd_separator()>
18113
18114 =back
18115
18116 =over 4
18117
18118 =item $pod_para-E<gt>B<parse_tree()>
18119
18120 =back
18121
18122 =over 4
18123
18124 =item $pod_para-E<gt>B<file_line()>
18125
18126 =back
18127
18128 =over 4
18129
18130 =item B<Pod::InteriorSequence>
18131
18132 =back
18133
18134 =over 4
18135
18136 =item Pod::InteriorSequence-E<gt>B<new()>
18137
18138 =back
18139
18140 =over 4
18141
18142 =item $pod_seq-E<gt>B<cmd_name()>
18143
18144 =back
18145
18146 =over 4
18147
18148 =item $pod_seq-E<gt>B<prepend()>
18149
18150 =back
18151
18152 =over 4
18153
18154 =item $pod_seq-E<gt>B<append()>
18155
18156 =back
18157
18158 =over 4
18159
18160 =item $pod_seq-E<gt>B<nested()>
18161
18162 =back
18163
18164 =over 4
18165
18166 =item $pod_seq-E<gt>B<raw_text()>
18167
18168 =back
18169
18170 =over 4
18171
18172 =item $pod_seq-E<gt>B<left_delimiter()>
18173
18174 =back
18175
18176 =over 4
18177
18178 =item $pod_seq-E<gt>B<right_delimiter()>
18179
18180 =back
18181
18182 =over 4
18183
18184 =item $pod_seq-E<gt>B<parse_tree()>
18185
18186 =back
18187
18188 =over 4
18189
18190 =item $pod_seq-E<gt>B<file_line()>
18191
18192 =back
18193
18194 =over 4
18195
18196 =item Pod::InteriorSequence::B<DESTROY()>
18197
18198 =back
18199
18200 =over 4
18201
18202 =item B<Pod::ParseTree>
18203
18204 =back
18205
18206 =over 4
18207
18208 =item Pod::ParseTree-E<gt>B<new()>
18209
18210 =back
18211
18212 =over 4
18213
18214 =item $ptree-E<gt>B<top()>
18215
18216 =back
18217
18218 =over 4
18219
18220 =item $ptree-E<gt>B<children()>
18221
18222 =back
18223
18224 =over 4
18225
18226 =item $ptree-E<gt>B<prepend()>
18227
18228 =back
18229
18230 =over 4
18231
18232 =item $ptree-E<gt>B<append()>
18233
18234 =back
18235
18236 =over 4
18237
18238 =item $ptree-E<gt>B<raw_text()>
18239
18240 =back
18241
18242 =over 4
18243
18244 =item Pod::ParseTree::B<DESTROY()>
18245
18246 =back
18247
18248 =over 4
18249
18250 =item SEE ALSO
18251
18252 =item AUTHOR
18253
18254 =back
18255
18256 =head2 Pod::LaTeX - Convert Pod data to formatted Latex
18257
18258 =over 4
18259
18260 =item SYNOPSIS
18261
18262 =item DESCRIPTION
18263
18264 =back
18265
18266 =over 4
18267
18268 =item OBJECT METHODS
18269
18270 C<initialize>
18271
18272 =back
18273
18274 =over 4
18275
18276 =item Data Accessors
18277
18278 B<AddPreamble>
18279
18280 =back
18281
18282 B<AddPostamble>
18283
18284 B<Head1Level>
18285
18286 B<Label>
18287
18288 B<LevelNoNum>
18289
18290 B<MakeIndex>
18291
18292 B<ReplaceNAMEwithSection>
18293
18294 B<StartWithNewPage>
18295
18296 B<TableOfContents>
18297
18298 B<UniqueLabels>
18299
18300 B<UserPreamble>
18301
18302 B<UserPostamble>
18303
18304 B<Lists>
18305
18306 =over 4
18307
18308 =item Subclassed methods
18309
18310 =back
18311
18312 B<begin_pod>
18313
18314 B<end_pod>
18315
18316 B<command>
18317
18318 B<verbatim>
18319
18320 B<textblock>
18321
18322 B<interior_sequence>
18323
18324 =over 4
18325
18326 =item List Methods
18327
18328 B<begin_list>
18329
18330 =back
18331
18332 B<end_list>
18333
18334 B<add_item>
18335
18336 =over 4
18337
18338 =item Methods for headings
18339
18340 B<head>
18341
18342 =back
18343
18344 =over 4
18345
18346 =item Internal methods
18347
18348 B<_output>
18349
18350 =back
18351
18352 B<_replace_special_chars>
18353
18354 B<_replace_special_chars_late>
18355
18356 B<_create_label>
18357
18358 B<_create_index>
18359
18360 B<_clean_latex_commands>
18361
18362 B<_split_delimited>
18363
18364 =over 4
18365
18366 =item NOTES
18367
18368 =item SEE ALSO
18369
18370 =item AUTHORS
18371
18372 =item COPYRIGHT
18373
18374 =item REVISION
18375
18376 =back
18377
18378 =head2 Pod::Man - Convert POD data to formatted *roff input
18379
18380 =over 4
18381
18382 =item SYNOPSIS
18383
18384 =item DESCRIPTION
18385
18386 center, date, fixed, fixedbold, fixeditalic, fixedbolditalic, name, quotes,
18387 release, section
18388
18389 =item DIAGNOSTICS
18390
18391 roff font should be 1 or 2 chars, not "%s", Invalid link %s, Invalid quote
18392 specification "%s", %s:%d: Unknown command paragraph "%s", %s:%d: Unknown
18393 escape EE<lt>%sE<gt>, %s:%d: Unknown formatting code %s, %s:%d: Unmatched
18394 =back
18395
18396 =item BUGS
18397
18398 =item CAVEATS
18399
18400 =item SEE ALSO
18401
18402 =item AUTHOR
18403
18404 =item COPYRIGHT AND LICENSE
18405
18406 =back
18407
18408 =head2 Pod::ParseLink - Parse an LE<lt>E<gt> formatting code in POD text
18409
18410 =over 4
18411
18412 =item SYNOPSIS
18413
18414 =item DESCRIPTION
18415
18416 =item SEE ALSO
18417
18418 =item AUTHOR
18419
18420 =item COPYRIGHT AND LICENSE
18421
18422 =back
18423
18424 =head2 Pod::ParseUtils - helpers for POD parsing and conversion
18425
18426 =over 4
18427
18428 =item SYNOPSIS
18429
18430 =item DESCRIPTION
18431
18432 =back
18433
18434 =over 4
18435
18436 =item Pod::List
18437
18438 Pod::List-E<gt>new()
18439
18440 =back
18441
18442 $list-E<gt>file()
18443
18444 $list-E<gt>start()
18445
18446 $list-E<gt>indent()
18447
18448 $list-E<gt>type()
18449
18450 $list-E<gt>rx()
18451
18452 $list-E<gt>item()
18453
18454 $list-E<gt>parent()
18455
18456 $list-E<gt>tag()
18457
18458 =over 4
18459
18460 =item Pod::Hyperlink
18461
18462 Pod::Hyperlink-E<gt>new()
18463
18464 =back
18465
18466 $link-E<gt>parse($string)
18467
18468 $link-E<gt>markup($string)
18469
18470 $link-E<gt>text()
18471
18472 $link-E<gt>warning()
18473
18474 $link-E<gt>file(), $link-E<gt>line()
18475
18476 $link-E<gt>page()
18477
18478 $link-E<gt>node()
18479
18480 $link-E<gt>alttext()
18481
18482 $link-E<gt>type()
18483
18484 $link-E<gt>link()
18485
18486 =over 4
18487
18488 =item Pod::Cache
18489
18490 Pod::Cache-E<gt>new()
18491
18492 =back
18493
18494 $cache-E<gt>item()
18495
18496 $cache-E<gt>find_page($name)
18497
18498 =over 4
18499
18500 =item Pod::Cache::Item
18501
18502 Pod::Cache::Item-E<gt>new()
18503
18504 =back
18505
18506 $cacheitem-E<gt>page()
18507
18508 $cacheitem-E<gt>description()
18509
18510 $cacheitem-E<gt>path()
18511
18512 $cacheitem-E<gt>file()
18513
18514 $cacheitem-E<gt>nodes()
18515
18516 $cacheitem-E<gt>find_node($name)
18517
18518 $cacheitem-E<gt>idx()
18519
18520 =over 4
18521
18522 =item AUTHOR
18523
18524 =item SEE ALSO
18525
18526 =back
18527
18528 =head2 Pod::Parser - base class for creating POD filters and translators
18529
18530 =over 4
18531
18532 =item SYNOPSIS
18533
18534 =item REQUIRES
18535
18536 =item EXPORTS
18537
18538 =item DESCRIPTION
18539
18540 =item QUICK OVERVIEW
18541
18542 =item PARSING OPTIONS
18543
18544 B<-want_nonPODs> (default: unset), B<-process_cut_cmd> (default: unset),
18545 B<-warnings> (default: unset)
18546
18547 =back
18548
18549 =over 4
18550
18551 =item RECOMMENDED SUBROUTINE/METHOD OVERRIDES
18552
18553 =back
18554
18555 =over 4
18556
18557 =item B<command()>
18558
18559 C<$cmd>, C<$text>, C<$line_num>, C<$pod_para>
18560
18561 =back
18562
18563 =over 4
18564
18565 =item B<verbatim()>
18566
18567 C<$text>, C<$line_num>, C<$pod_para>
18568
18569 =back
18570
18571 =over 4
18572
18573 =item B<textblock()>
18574
18575 C<$text>, C<$line_num>, C<$pod_para>
18576
18577 =back
18578
18579 =over 4
18580
18581 =item B<interior_sequence()>
18582
18583 =back
18584
18585 =over 4
18586
18587 =item OPTIONAL SUBROUTINE/METHOD OVERRIDES
18588
18589 =back
18590
18591 =over 4
18592
18593 =item B<new()>
18594
18595 =back
18596
18597 =over 4
18598
18599 =item B<initialize()>
18600
18601 =back
18602
18603 =over 4
18604
18605 =item B<begin_pod()>
18606
18607 =back
18608
18609 =over 4
18610
18611 =item B<begin_input()>
18612
18613 =back
18614
18615 =over 4
18616
18617 =item B<end_input()>
18618
18619 =back
18620
18621 =over 4
18622
18623 =item B<end_pod()>
18624
18625 =back
18626
18627 =over 4
18628
18629 =item B<preprocess_line()>
18630
18631 =back
18632
18633 =over 4
18634
18635 =item B<preprocess_paragraph()>
18636
18637 =back
18638
18639 =over 4
18640
18641 =item METHODS FOR PARSING AND PROCESSING
18642
18643 =back
18644
18645 =over 4
18646
18647 =item B<parse_text()>
18648
18649 B<-expand_seq> =E<gt> I<code-ref>|I<method-name>, B<-expand_text> =E<gt>
18650 I<code-ref>|I<method-name>, B<-expand_ptree> =E<gt>
18651 I<code-ref>|I<method-name>
18652
18653 =back
18654
18655 =over 4
18656
18657 =item B<interpolate()>
18658
18659 =back
18660
18661 =over 4
18662
18663 =item B<parse_paragraph()>
18664
18665 =back
18666
18667 =over 4
18668
18669 =item B<parse_from_filehandle()>
18670
18671 =back
18672
18673 =over 4
18674
18675 =item B<parse_from_file()>
18676
18677 =back
18678
18679 =over 4
18680
18681 =item ACCESSOR METHODS
18682
18683 =back
18684
18685 =over 4
18686
18687 =item B<errorsub()>
18688
18689 =back
18690
18691 =over 4
18692
18693 =item B<cutting()>
18694
18695 =back
18696
18697 =over 4
18698
18699 =item B<parseopts()>
18700
18701 =back
18702
18703 =over 4
18704
18705 =item B<output_file()>
18706
18707 =back
18708
18709 =over 4
18710
18711 =item B<output_handle()>
18712
18713 =back
18714
18715 =over 4
18716
18717 =item B<input_file()>
18718
18719 =back
18720
18721 =over 4
18722
18723 =item B<input_handle()>
18724
18725 =back
18726
18727 =over 4
18728
18729 =item B<input_streams()>
18730
18731 =back
18732
18733 =over 4
18734
18735 =item B<top_stream()>
18736
18737 =back
18738
18739 =over 4
18740
18741 =item PRIVATE METHODS AND DATA
18742
18743 =back
18744
18745 =over 4
18746
18747 =item B<_push_input_stream()>
18748
18749 =back
18750
18751 =over 4
18752
18753 =item B<_pop_input_stream()>
18754
18755 =back
18756
18757 =over 4
18758
18759 =item TREE-BASED PARSING
18760
18761 =item SEE ALSO
18762
18763 =item AUTHOR
18764
18765 =back
18766
18767 =head2 Pod::Perldoc::ToChecker - let Perldoc check Pod for errors
18768
18769 =over 4
18770
18771 =item SYNOPSIS
18772
18773 =item DESCRIPTION
18774
18775 =item SEE ALSO
18776
18777 =item COPYRIGHT AND DISCLAIMERS
18778
18779 =item AUTHOR
18780
18781 =back
18782
18783 =head2 Pod::Perldoc::ToMan - let Perldoc render Pod as man pages
18784
18785 =over 4
18786
18787 =item SYNOPSIS
18788
18789 =item DESCRIPTION
18790
18791 =item CAVEAT
18792
18793 =item SEE ALSO
18794
18795 =item COPYRIGHT AND DISCLAIMERS
18796
18797 =item AUTHOR
18798
18799 =back
18800
18801 =head2 Pod::Perldoc::ToNroff - let Perldoc convert Pod to nroff
18802
18803 =over 4
18804
18805 =item SYNOPSIS
18806
18807 =item DESCRIPTION
18808
18809 =item CAVEAT
18810
18811 =item SEE ALSO
18812
18813 =item COPYRIGHT AND DISCLAIMERS
18814
18815 =item AUTHOR
18816
18817 =back
18818
18819 =head2 Pod::Perldoc::ToPod - let Perldoc render Pod as ... Pod!
18820
18821 =over 4
18822
18823 =item SYNOPSIS
18824
18825 =item DESCRIPTION
18826
18827 =item SEE ALSO
18828
18829 =item COPYRIGHT AND DISCLAIMERS
18830
18831 =item AUTHOR
18832
18833 =back
18834
18835 =head2 Pod::Perldoc::ToRtf - let Perldoc render Pod as RTF
18836
18837 =over 4
18838
18839 =item SYNOPSIS
18840
18841 =item DESCRIPTION
18842
18843 =item SEE ALSO
18844
18845 =item COPYRIGHT AND DISCLAIMERS
18846
18847 =item AUTHOR
18848
18849 =back
18850
18851 =head2 Pod::Perldoc::ToText - let Perldoc render Pod as plaintext
18852
18853 =over 4
18854
18855 =item SYNOPSIS
18856
18857 =item DESCRIPTION
18858
18859 =item CAVEAT
18860
18861 =item SEE ALSO
18862
18863 =item COPYRIGHT AND DISCLAIMERS
18864
18865 =item AUTHOR
18866
18867 =back
18868
18869 =head2 Pod::Perldoc::ToTk - let Perldoc use Tk::Pod to render Pod
18870
18871 =over 4
18872
18873 =item SYNOPSIS
18874
18875 =item DESCRIPTION
18876
18877 =item SEE ALSO
18878
18879 =item AUTHOR
18880
18881 =back
18882
18883 =head2 Pod::Perldoc::ToXml - let Perldoc render Pod as XML
18884
18885 =over 4
18886
18887 =item SYNOPSIS
18888
18889 =item DESCRIPTION
18890
18891 =item SEE ALSO
18892
18893 =item COPYRIGHT AND DISCLAIMERS
18894
18895 =item AUTHOR
18896
18897 =back
18898
18899 =head2 Pod::PlainText - Convert POD data to formatted ASCII text
18900
18901 =over 4
18902
18903 =item SYNOPSIS
18904
18905 =item DESCRIPTION
18906
18907 alt, indent, loose, sentence, width
18908
18909 =item DIAGNOSTICS
18910
18911 Bizarre space in item, Can't open %s for reading: %s, Unknown escape: %s,
18912 Unknown sequence: %s, Unmatched =back
18913
18914 =item RESTRICTIONS
18915
18916 =item NOTES
18917
18918 =item SEE ALSO
18919
18920 =item AUTHOR
18921
18922 =back
18923
18924 =head2 Pod::Plainer - Perl extension for converting Pod to old style Pod.
18925
18926 =over 4
18927
18928 =item SYNOPSIS
18929
18930 =item DESCRIPTION
18931
18932 =over 4
18933
18934 =item EXPORT
18935
18936 =back
18937
18938 =item AUTHOR
18939
18940 =item SEE ALSO
18941
18942 =back
18943
18944 =head2 Pod::Select, podselect() - extract selected sections of POD from
18945 input
18946
18947 =over 4
18948
18949 =item SYNOPSIS
18950
18951 =item REQUIRES
18952
18953 =item EXPORTS
18954
18955 =item DESCRIPTION
18956
18957 =item SECTION SPECIFICATIONS
18958
18959 =item RANGE SPECIFICATIONS
18960
18961 =back
18962
18963 =over 4
18964
18965 =item OBJECT METHODS
18966
18967 =back
18968
18969 =over 4
18970
18971 =item B<curr_headings()>
18972
18973 =back
18974
18975 =over 4
18976
18977 =item B<select()>
18978
18979 =back
18980
18981 =over 4
18982
18983 =item B<add_selection()>
18984
18985 =back
18986
18987 =over 4
18988
18989 =item B<clear_selections()>
18990
18991 =back
18992
18993 =over 4
18994
18995 =item B<match_section()>
18996
18997 =back
18998
18999 =over 4
19000
19001 =item B<is_selected()>
19002
19003 =back
19004
19005 =over 4
19006
19007 =item EXPORTED FUNCTIONS
19008
19009 =back
19010
19011 =over 4
19012
19013 =item B<podselect()>
19014
19015 B<-output>, B<-sections>, B<-ranges>
19016
19017 =back
19018
19019 =over 4
19020
19021 =item PRIVATE METHODS AND DATA
19022
19023 =back
19024
19025 =over 4
19026
19027 =item B<_compile_section_spec()>
19028
19029 =back
19030
19031 =over 4
19032
19033 =item $self->{_SECTION_HEADINGS}
19034
19035 =back
19036
19037 =over 4
19038
19039 =item $self->{_SELECTED_SECTIONS}
19040
19041 =back
19042
19043 =over 4
19044
19045 =item SEE ALSO
19046
19047 =item AUTHOR
19048
19049 =back
19050
19051 =head2 Pod::Text - Convert POD data to formatted ASCII text
19052
19053 =over 4
19054
19055 =item SYNOPSIS
19056
19057 =item DESCRIPTION
19058
19059 alt, code, indent, loose, margin, quotes, sentence, width
19060
19061 =item DIAGNOSTICS
19062
19063 Bizarre space in item, Item called without tag, Can't open %s for reading:
19064 %s, Invalid quote specification "%s", %s:%d: Unknown command paragraph: %s,
19065 %s:%d: Unknown escape: %s, %s:%d: Unknown formatting code: %s, %s:%d:
19066 Unmatched =back
19067
19068 =item RESTRICTIONS
19069
19070 =item NOTES
19071
19072 =item SEE ALSO
19073
19074 =item AUTHOR
19075
19076 =item COPYRIGHT AND LICENSE
19077
19078 =back
19079
19080 =head2 Pod::Text::Color - Convert POD data to formatted color ASCII text
19081
19082 =over 4
19083
19084 =item SYNOPSIS
19085
19086 =item DESCRIPTION
19087
19088 =item BUGS
19089
19090 =item SEE ALSO
19091
19092 =item AUTHOR
19093
19094 =item COPYRIGHT AND LICENSE
19095
19096 =back
19097
19098 =head2 Pod::Text::Overstrike - Convert POD data to formatted overstrike
19099 text
19100
19101 =over 4
19102
19103 =item SYNOPSIS
19104
19105 =item DESCRIPTION
19106
19107 =item BUGS
19108
19109 =item SEE ALSO
19110
19111 =item AUTHOR
19112
19113 =item COPYRIGHT AND LICENSE
19114
19115 =back
19116
19117 =head2 Pod::Text::Termcap - Convert POD data to ASCII text with format
19118 escapes
19119
19120 =over 4
19121
19122 =item SYNOPSIS
19123
19124 =item DESCRIPTION
19125
19126 =item NOTES
19127
19128 =item SEE ALSO
19129
19130 =item AUTHOR
19131
19132 =item COPYRIGHT AND LICENSE
19133
19134 =back
19135
19136 =head2 Pod::Usage, pod2usage() - print a usage message from embedded pod
19137 documentation
19138
19139 =over 4
19140
19141 =item SYNOPSIS
19142
19143 =item ARGUMENTS
19144
19145 C<-message>, C<-msg>, C<-exitval>, C<-verbose>, C<-output>, C<-input>,
19146 C<-pathlist>
19147
19148 =item DESCRIPTION
19149
19150 =item EXAMPLES
19151
19152 =over 4
19153
19154 =item Recommended Use
19155
19156 =back
19157
19158 =item CAVEATS
19159
19160 =item AUTHOR
19161
19162 =item ACKNOWLEDGEMENTS
19163
19164 =back
19165
19166 =head2 SDBM_File - Tied access to sdbm files
19167
19168 =over 4
19169
19170 =item SYNOPSIS
19171
19172 =item DESCRIPTION
19173
19174 C<O_RDONLY>, C<O_WRONLY>, C<O_RDWR>
19175
19176 =item DIAGNOSTICS
19177
19178 =over 4
19179
19180 =item C<sdbm store returned -1, errno 22, key "..." at ...>
19181
19182 =back
19183
19184 =item BUGS AND WARNINGS
19185
19186 =back
19187
19188 =head2 Safe - Compile and execute code in restricted compartments
19189
19190 =over 4
19191
19192 =item SYNOPSIS
19193
19194 =item DESCRIPTION
19195
19196 a new namespace, an operator mask
19197
19198 =item WARNING
19199
19200 =over 4
19201
19202 =item RECENT CHANGES
19203
19204 =item Methods in class Safe
19205
19206 permit (OP, ...), permit_only (OP, ...), deny (OP, ...), deny_only (OP,
19207 ...), trap (OP, ...), untrap (OP, ...), share (NAME, ...), share_from
19208 (PACKAGE, ARRAYREF), varglob (VARNAME), reval (STRING), rdo (FILENAME),
19209 root (NAMESPACE), mask (MASK)
19210
19211 =item Some Safety Issues
19212
19213 Memory, CPU, Snooping, Signals, State Changes
19214
19215 =item AUTHOR
19216
19217 =back
19218
19219 =back
19220
19221 =head2 Scalar::Util - A selection of general-utility scalar subroutines
19222
19223 =over 4
19224
19225 =item SYNOPSIS
19226
19227 =item DESCRIPTION
19228
19229 blessed EXPR, dualvar NUM, STRING, isvstring EXPR, isweak EXPR,
19230 looks_like_number EXPR, openhandle FH, refaddr EXPR, reftype EXPR,
19231 set_prototype CODEREF, PROTOTYPE, tainted EXPR, weaken REF
19232
19233 =item KNOWN BUGS
19234
19235 =item COPYRIGHT
19236
19237 =item BLATANT PLUG
19238
19239 =back
19240
19241 =head2 Search::Dict, look - search for key in dictionary file
19242
19243 =over 4
19244
19245 =item SYNOPSIS
19246
19247 =item DESCRIPTION
19248
19249 =back
19250
19251 =head2 SelectSaver - save and restore selected file handle
19252
19253 =over 4
19254
19255 =item SYNOPSIS
19256
19257 =item DESCRIPTION
19258
19259 =back
19260
19261 =head2 SelfLoader - load functions only on demand
19262
19263 =over 4
19264
19265 =item SYNOPSIS
19266
19267 =item DESCRIPTION
19268
19269 =over 4
19270
19271 =item The __DATA__ token
19272
19273 =item SelfLoader autoloading
19274
19275 =item Autoloading and package lexicals
19276
19277 =item SelfLoader and AutoLoader
19278
19279 =item __DATA__, __END__, and the FOOBAR::DATA filehandle.
19280
19281 =item Classes and inherited methods.
19282
19283 =back
19284
19285 =item Multiple packages and fully qualified subroutine names
19286
19287 =back
19288
19289 =head2 Shell - run shell commands transparently within perl
19290
19291 =over 4
19292
19293 =item SYNOPSIS
19294
19295 =item DESCRIPTION
19296
19297 =over 4
19298
19299 =item OBJECT ORIENTED SYNTAX
19300
19301 =back
19302
19303 =item AUTHOR
19304
19305 =back
19306
19307 =head2 Socket, sockaddr_in, sockaddr_un, inet_aton, inet_ntoa - load the C
19308 socket.h defines and structure manipulators 
19309
19310 =over 4
19311
19312 =item SYNOPSIS
19313
19314 =item DESCRIPTION
19315
19316 inet_aton HOSTNAME, inet_ntoa IP_ADDRESS, INADDR_ANY, INADDR_BROADCAST,
19317 INADDR_LOOPBACK, INADDR_NONE, sockaddr_family SOCKADDR, sockaddr_in PORT,
19318 ADDRESS, sockaddr_in SOCKADDR_IN, pack_sockaddr_in PORT, IP_ADDRESS,
19319 unpack_sockaddr_in SOCKADDR_IN, sockaddr_un PATHNAME, sockaddr_un
19320 SOCKADDR_UN, pack_sockaddr_un PATH, unpack_sockaddr_un SOCKADDR_UN
19321
19322 =back
19323
19324 =head2 Storable - persistence for Perl data structures
19325
19326 =over 4
19327
19328 =item SYNOPSIS
19329
19330 =item DESCRIPTION
19331
19332 =item MEMORY STORE
19333
19334 =item ADVISORY LOCKING
19335
19336 =item SPEED
19337
19338 =item CANONICAL REPRESENTATION
19339
19340 =item CODE REFERENCES
19341
19342 =item FORWARD COMPATIBILITY
19343
19344 utf8 data, restricted hashes, files from future versions of Storable
19345
19346 =item ERROR REPORTING
19347
19348 =item WIZARDS ONLY
19349
19350 =over 4
19351
19352 =item Hooks
19353
19354 C<STORABLE_freeze> I<obj>, I<cloning>, C<STORABLE_thaw> I<obj>, I<cloning>,
19355 I<serialized>, ..
19356
19357 =item Predicates
19358
19359 C<Storable::last_op_in_netorder>, C<Storable::is_storing>,
19360 C<Storable::is_retrieving>
19361
19362 =item Recursion
19363
19364 =item Deep Cloning
19365
19366 =back
19367
19368 =item Storable magic
19369
19370 =item EXAMPLES
19371
19372 =item WARNING
19373
19374 =item BUGS
19375
19376 =over 4
19377
19378 =item 64 bit data in perl 5.6.0 and 5.6.1
19379
19380 =back
19381
19382 =item CREDITS
19383
19384 =item AUTHOR
19385
19386 =item SEE ALSO
19387
19388 =back
19389
19390 =head2 Switch - A switch statement for Perl
19391
19392 =over 4
19393
19394 =item VERSION
19395
19396 =item SYNOPSIS
19397
19398 =item BACKGROUND
19399
19400 =item DESCRIPTION
19401
19402 =over 4
19403
19404 =item Allowing fall-through
19405
19406 =item Automating fall-through
19407
19408 =item Alternative syntax
19409
19410 =item Higher-order Operations
19411
19412 =back
19413
19414 =item DEPENDENCIES
19415
19416 =item AUTHOR
19417
19418 =item BUGS
19419
19420 =item LIMITATION
19421
19422 =item COPYRIGHT
19423
19424 =back
19425
19426 =head2 Symbol - manipulate Perl symbols and their names
19427
19428 =over 4
19429
19430 =item SYNOPSIS
19431
19432 =item DESCRIPTION
19433
19434 =item BUGS
19435
19436 =back
19437
19438 =head2 Sys::Hostname - Try every conceivable way to get hostname
19439
19440 =over 4
19441
19442 =item SYNOPSIS
19443
19444 =item DESCRIPTION
19445
19446 =item AUTHOR
19447
19448 =back
19449
19450 =head2 Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog - Perl
19451 interface to the UNIX syslog(3) calls
19452
19453 =over 4
19454
19455 =item SYNOPSIS
19456
19457 =item DESCRIPTION
19458
19459 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19460 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19461 in 5.004_02), closelog
19462
19463 =item EXAMPLES
19464
19465 =item SEE ALSO
19466
19467 =item AUTHOR
19468
19469 =back
19470
19471 =head2 Syslog::Syslog, Sys::Syslog, openlog, closelog, setlogmask, syslog -
19472 Perl interface to the UNIX syslog(3) calls
19473
19474 =over 4
19475
19476 =item SYNOPSIS
19477
19478 =item DESCRIPTION
19479
19480 openlog $ident, $logopt, $facility, syslog $priority, $format, @args,
19481 setlogmask $mask_priority, setlogsock $sock_type [$stream_location] (added
19482 in 5.004_02), closelog
19483
19484 =item EXAMPLES
19485
19486 =item SEE ALSO
19487
19488 =item AUTHOR
19489
19490 =back
19491
19492 =head2 Term::ANSIColor - Color screen output using ANSI escape sequences
19493
19494 =over 4
19495
19496 =item SYNOPSIS
19497
19498 =item DESCRIPTION
19499
19500 =item DIAGNOSTICS
19501
19502 Bad escape sequence %s, Bareword "%s" not allowed while "strict subs" in
19503 use, Invalid attribute name %s, Name "%s" used only once: possible typo, No
19504 comma allowed after filehandle, No name for escape sequence %s
19505
19506 =item ENVIRONMENT
19507
19508 ANSI_COLORS_DISABLED
19509
19510 =item RESTRICTIONS
19511
19512 =item NOTES
19513
19514 =item SEE ALSO
19515
19516 =item AUTHORS
19517
19518 =item COPYRIGHT AND LICENSE
19519
19520 =back
19521
19522 =head2 Term::Cap - Perl termcap interface
19523
19524 =over 4
19525
19526 =item SYNOPSIS
19527
19528 =item DESCRIPTION
19529
19530 =over 4
19531
19532 =item METHODS
19533
19534 =back
19535
19536 =back
19537
19538 B<Tgetent>, OSPEED, TERM
19539
19540 B<Tpad>, B<$string>, B<$cnt>, B<$FH>
19541
19542 B<Tputs>, B<$cap>, B<$cnt>, B<$FH>
19543
19544 B<Tgoto>, B<$cap>, B<$col>, B<$row>, B<$FH>
19545
19546 B<Trequire>
19547
19548 =over 4
19549
19550 =item EXAMPLES
19551
19552 =item COPYRIGHT AND LICENSE
19553
19554 =item AUTHOR
19555
19556 =item SEE ALSO
19557
19558 =back
19559
19560 =head2 Term::Complete - Perl word completion module
19561
19562 =over 4
19563
19564 =item SYNOPSIS
19565
19566 =item DESCRIPTION
19567
19568 E<lt>tabE<gt>, ^D, ^U, E<lt>delE<gt>, E<lt>bsE<gt>
19569
19570 =item DIAGNOSTICS
19571
19572 =item BUGS
19573
19574 =item AUTHOR
19575
19576 =back
19577
19578 =head2 Term::ReadLine - Perl interface to various C<readline> packages.
19579 If no real package is found, substitutes stubs instead of basic functions.
19580
19581 =over 4
19582
19583 =item SYNOPSIS
19584
19585 =item DESCRIPTION
19586
19587 =item Minimal set of supported functions
19588
19589 C<ReadLine>, C<new>, C<readline>, C<addhistory>, C<IN>, C<OUT>, C<MinLine>,
19590 C<findConsole>, Attribs, C<Features>
19591
19592 =item Additional supported functions
19593
19594 C<tkRunning>, C<ornaments>, C<newTTY>
19595
19596 =item EXPORTS
19597
19598 =item ENVIRONMENT
19599
19600 =item CAVEATS
19601
19602 =back
19603
19604 =head2 Test - provides a simple framework for writing test scripts
19605
19606 =over 4
19607
19608 =item SYNOPSIS
19609
19610 =item DESCRIPTION
19611
19612 =item QUICK START GUIDE
19613
19614 =over 4
19615
19616 =item Functions
19617
19618 C<plan(...)>, C<tests =E<gt> I<number>>, C<todo =E<gt> [I<1,5,14>]>,
19619 C<onfail =E<gt> sub { ... }>, C<onfail =E<gt> \&some_sub>
19620
19621 =back
19622
19623 =back
19624
19625 B<_to_value>
19626
19627 C<ok(...)>
19628
19629 C<skip(I<skip_if_true>, I<args...>)>
19630
19631 =over 4
19632
19633 =item TEST TYPES
19634
19635 NORMAL TESTS, SKIPPED TESTS, TODO TESTS
19636
19637 =item ONFAIL
19638
19639 =item BUGS and CAVEATS
19640
19641 =item NOTE
19642
19643 =item SEE ALSO
19644
19645 =item AUTHOR
19646
19647 =back
19648
19649 =head2 Test::Builder - Backend for building test libraries
19650
19651 =over 4
19652
19653 =item SYNOPSIS
19654
19655 =item DESCRIPTION
19656
19657 =over 4
19658
19659 =item Construction
19660
19661 B<new>
19662
19663 =back
19664
19665 =back
19666
19667 =over 4
19668
19669 =item Setting up tests
19670
19671 B<exported_to>
19672
19673 =back
19674
19675 B<plan>
19676
19677 B<expected_tests>
19678
19679 B<no_plan>
19680
19681 B<has_plan>
19682
19683 B<skip_all>
19684
19685 =over 4
19686
19687 =item Running tests
19688
19689 B<ok>
19690
19691 =back
19692
19693 B<is_eq>, B<is_num>
19694
19695 B<isnt_eq>, B<isnt_num>
19696
19697 B<like>, B<unlike>
19698
19699 B<maybe_regex>
19700
19701 B<cmp_ok>
19702
19703 B<BAILOUT>
19704
19705 B<skip>
19706
19707 B<todo_skip>
19708
19709 B<skip_rest>
19710
19711 =over 4
19712
19713 =item Test style
19714
19715 B<level>
19716
19717 =back
19718
19719 B<use_numbers>
19720
19721 B<no_header>, B<no_ending>
19722
19723 =over 4
19724
19725 =item Output
19726
19727 B<diag>
19728
19729 =back
19730
19731 B<_print>
19732
19733 B<output>, B<failure_output>, B<todo_output>
19734
19735 =over 4
19736
19737 =item Test Status and Info
19738
19739 B<current_test>
19740
19741 =back
19742
19743 B<summary>
19744
19745 B<details>
19746
19747 B<todo>
19748
19749 B<caller>
19750
19751 B<_sanity_check>
19752
19753 B<_whoa>
19754
19755 B<_my_exit>
19756
19757 =over 4
19758
19759 =item THREADS
19760
19761 =item EXAMPLES
19762
19763 =item SEE ALSO
19764
19765 =item AUTHORS
19766
19767 =item COPYRIGHT
19768
19769 =back
19770
19771 =head2 Test::Harness - run perl standard test scripts with statistics
19772
19773 =over 4
19774
19775 =item SYNOPSIS
19776
19777 =item DESCRIPTION
19778
19779 =over 4
19780
19781 =item The test script output
19782
19783 B<'1..M'>, B<'ok', 'not ok'.  Ok?>, B<test numbers>, B<test names>,
19784 B<Skipping tests>, B<Todo tests>, B<Bail out!>, B<Comments>, B<Anything
19785 else>
19786
19787 =item Taint mode
19788
19789 =item Configuration variables.
19790
19791 B<$Test::Harness::verbose>, B<$Test::Harness::switches>
19792
19793 =item Failure
19794
19795 B<Failed Test>, B<Stat>, B<Wstat>, B<Total>, B<Fail>, B<Failed>, B<List of
19796 Failed>
19797
19798 =item Functions
19799
19800 B<runtests>
19801
19802 =back
19803
19804 =back
19805
19806 B<_all_ok>
19807
19808 B<_globdir>
19809
19810 B<_run_all_tests>
19811
19812 B<_mk_leader>
19813
19814 B<_leader_width>
19815
19816 =over 4
19817
19818 =item EXPORT
19819
19820 =item DIAGNOSTICS
19821
19822 C<All tests successful.\nFiles=%d,  Tests=%d, %s>, C<FAILED tests
19823 %s\n\tFailed %d/%d tests, %.2f%% okay.>, C<Test returned status %d (wstat
19824 %d)>, C<Failed 1 test, %.2f%% okay. %s>, C<Failed %d/%d tests, %.2f%% okay.
19825 %s>, C<FAILED--Further testing stopped: %s>
19826
19827 =item ENVIRONMENT
19828
19829 C<HARNESS_ACTIVE>, C<HARNESS_COLUMNS>, C<HARNESS_COMPILE_TEST>,
19830 C<HARNESS_FILELEAK_IN_DIR>, C<HARNESS_IGNORE_EXITCODE>, C<HARNESS_NOTTY>,
19831 C<HARNESS_OK_SLOW>, C<HARNESS_PERL_SWITCHES>, C<HARNESS_VERBOSE>
19832
19833 =item EXAMPLE
19834
19835 =item SEE ALSO
19836
19837 =item AUTHORS
19838
19839 =item LICENSE
19840
19841 =item TODO
19842
19843 =item BUGS
19844
19845 =back
19846
19847 =head2 Test::Harness::Assert - simple assert
19848
19849 =over 4
19850
19851 =item SYNOPSIS
19852
19853 =item DESCRIPTION
19854
19855 =over 4
19856
19857 =item Functions
19858
19859 B<assert>
19860
19861 =back
19862
19863 =back
19864
19865 =over 4
19866
19867 =item AUTHOR
19868
19869 =item SEE ALSO
19870
19871 =back
19872
19873 =head2 Test::Harness::Iterator - Internal Test::Harness Iterator
19874
19875 =over 4
19876
19877 =item SYNOPSIS
19878
19879 =item DESCRIPTION
19880
19881 =back
19882
19883 =head2 Test::Harness::Straps - detailed analysis of test results
19884
19885 =over 4
19886
19887 =item SYNOPSIS
19888
19889 =item DESCRIPTION
19890
19891 =item Construction
19892
19893 =over 4
19894
19895 =item C<new>
19896
19897 =back
19898
19899 =back
19900
19901 =over 4
19902
19903 =item C<_init>
19904
19905 =back
19906
19907 =over 4
19908
19909 =item Analysis
19910
19911 =over 4
19912
19913 =item C<analyze>
19914
19915 =back
19916
19917 =back
19918
19919 =over 4
19920
19921 =item C<analyze_fh>
19922
19923 =back
19924
19925 =over 4
19926
19927 =item C<analyze_file>
19928
19929 =back
19930
19931 =over 4
19932
19933 =item C<_switches>
19934
19935 =back
19936
19937 =over 4
19938
19939 =item C<_INC2PERL5LIB>
19940
19941 =back
19942
19943 =over 4
19944
19945 =item C<_filtered_INC>
19946
19947 =back
19948
19949 =over 4
19950
19951 =item C<_restore_PERL5LIB>
19952
19953 =back
19954
19955 =over 4
19956
19957 =item Parsing
19958
19959 =over 4
19960
19961 =item C<_is_comment>
19962
19963 =back
19964
19965 =back
19966
19967 =over 4
19968
19969 =item C<_is_header>
19970
19971 =back
19972
19973 =over 4
19974
19975 =item C<_is_test>
19976
19977 =back
19978
19979 =over 4
19980
19981 =item C<_is_bail_out>
19982
19983 =back
19984
19985 =over 4
19986
19987 =item C<_reset_file_state>
19988
19989 =back
19990
19991 =over 4
19992
19993 =item Results
19994
19995 =over 4
19996
19997 =item C<_detailize>
19998
19999 =back
20000
20001 =back
20002
20003 =over 4
20004
20005 =item EXAMPLES
20006
20007 =item AUTHOR
20008
20009 =item SEE ALSO
20010
20011 =back
20012
20013 =head2 Test::More - yet another framework for writing test scripts
20014
20015 =over 4
20016
20017 =item SYNOPSIS
20018
20019 =item DESCRIPTION
20020
20021 =over 4
20022
20023 =item I love it when a plan comes together
20024
20025 =back
20026
20027 =back
20028
20029 =over 4
20030
20031 =item Test names
20032
20033 =item I'm ok, you're not ok.
20034
20035 B<ok>
20036
20037 =back
20038
20039 B<is>, B<isnt>
20040
20041 B<like>
20042
20043 B<unlike>
20044
20045 B<cmp_ok>
20046
20047 B<can_ok>
20048
20049 B<isa_ok>
20050
20051 B<pass>, B<fail>
20052
20053 =over 4
20054
20055 =item Diagnostics
20056
20057 B<diag>
20058
20059 =back
20060
20061 =over 4
20062
20063 =item Module tests
20064
20065 B<use_ok>
20066
20067 =back
20068
20069 B<require_ok>
20070
20071 =over 4
20072
20073 =item Conditional tests
20074
20075 B<SKIP: BLOCK>
20076
20077 =back
20078
20079 B<TODO: BLOCK>, B<todo_skip>
20080
20081 When do I use SKIP vs. TODO?
20082
20083 =over 4
20084
20085 =item Comparison functions
20086
20087 B<is_deeply>
20088
20089 =back
20090
20091 B<eq_array>
20092
20093 B<eq_hash>
20094
20095 B<eq_set>
20096
20097 =over 4
20098
20099 =item Extending and Embedding Test::More
20100
20101 B<builder>
20102
20103 =back
20104
20105 =over 4
20106
20107 =item NOTES
20108
20109 =item BUGS and CAVEATS
20110
20111 Making your own ok(), The eq_* family has some caveats, Test::Harness
20112 upgrades
20113
20114 =item HISTORY
20115
20116 =item SEE ALSO
20117
20118 =item AUTHORS
20119
20120 =item COPYRIGHT
20121
20122 =back
20123
20124 =head2 Test::Simple - Basic utilities for writing tests.
20125
20126 =over 4
20127
20128 =item SYNOPSIS
20129
20130 =item DESCRIPTION
20131
20132 B<ok>
20133
20134 =back
20135
20136 =over 4
20137
20138 =item EXAMPLE
20139
20140 =item CAVEATS
20141
20142 =item NOTES
20143
20144 =item HISTORY
20145
20146 =item SEE ALSO
20147
20148 L<Test::More>, L<Test>, L<Test::Unit>, L<Test::Inline>, L<SelfTest>,
20149 L<Test::Harness>
20150
20151 =item AUTHORS
20152
20153 =item COPYRIGHT
20154
20155 =back
20156
20157 =head2 Test::Tutorial - A tutorial about writing really basic tests
20158
20159 =over 4
20160
20161 =item DESCRIPTION
20162
20163 =over 4
20164
20165 =item Nuts and bolts of testing.
20166
20167 =item Where to start?
20168
20169 =item Names
20170
20171 =item Test the manual
20172
20173 =item Sometimes the tests are wrong
20174
20175 =item Testing lots of values
20176
20177 =item Informative names
20178
20179 =item Skipping tests
20180
20181 =item Todo tests
20182
20183 =item Testing with taint mode.
20184
20185 =back
20186
20187 =item FOOTNOTES
20188
20189 =item AUTHORS
20190
20191 =item COPYRIGHT
20192
20193 =back
20194
20195 =head2 Text::Abbrev, abbrev - create an abbreviation table from a list
20196
20197 =over 4
20198
20199 =item SYNOPSIS
20200
20201 =item DESCRIPTION
20202
20203 =item EXAMPLE
20204
20205 =back
20206
20207 =head2 Text::Balanced - Extract delimited text sequences from strings.
20208
20209 =over 4
20210
20211 =item SYNOPSIS
20212
20213 =item DESCRIPTION
20214
20215 =over 4
20216
20217 =item General behaviour in list contexts
20218
20219 [0], [1], [2]
20220
20221 =item General behaviour in scalar and void contexts
20222
20223 =item A note about prefixes
20224
20225 =item C<extract_delimited>
20226
20227 =item C<extract_bracketed>
20228
20229 =item C<extract_variable>
20230
20231 [0], [1], [2]
20232
20233 =item C<extract_tagged>
20234
20235 C<reject =E<gt> $listref>, C<ignore =E<gt> $listref>, C<fail =E<gt> $str>,
20236 [0], [1], [2], [3], [4], [5]
20237
20238 =item C<gen_extract_tagged>
20239
20240 =item C<extract_quotelike>
20241
20242 [0], [1], [2], [3], [4], [5], [6], [7], [8], [9], [10]
20243
20244 =item C<extract_quotelike> and "here documents"
20245
20246 [0], [1], [2], [3], [4], [5], [6], [7..10]
20247
20248 =item C<extract_codeblock>
20249
20250 =item C<extract_multiple>
20251
20252 =item C<gen_delimited_pat>
20253
20254 =back
20255
20256 =item DIAGNOSTICS
20257
20258  C<Did not find a suitable bracket: "%s">,  C<Did not find prefix: /%s/>, 
20259 C<Did not find opening bracket after prefix: "%s">,  C<No quotelike
20260 operator found after prefix: "%s">,  C<Unmatched closing bracket: "%c">, 
20261 C<Unmatched opening bracket(s): "%s">, C<Unmatched embedded quote (%s)>,
20262 C<Did not find closing delimiter to match '%s'>,  C<Mismatched closing
20263 bracket: expected "%c" but found "%s">,  C<No block delimiter found after
20264 quotelike "%s">, C<Did not find leading dereferencer>, C<Bad identifier
20265 after dereferencer>, C<Did not find expected opening bracket at %s>,
20266 C<Improperly nested codeblock at %s>,  C<Missing second block for quotelike
20267 "%s">, C<No match found for opening bracket>, C<Did not find opening tag:
20268 /%s/>, C<Unable to construct closing tag to match: /%s/>, C<Found invalid
20269 nested tag: %s>, C<Found unbalanced nested tag: %s>, C<Did not find closing
20270 tag>
20271
20272 =item AUTHOR
20273
20274 =item BUGS AND IRRITATIONS
20275
20276 =item COPYRIGHT
20277
20278 =back
20279
20280 =head2 Text::ParseWords - parse text into an array of tokens or array of
20281 arrays
20282
20283 =over 4
20284
20285 =item SYNOPSIS
20286
20287 =item DESCRIPTION
20288
20289 =item EXAMPLES
20290
20291 =item AUTHORS
20292
20293 =back
20294
20295 =head2 Text::Soundex - Implementation of the Soundex Algorithm as Described
20296 by Knuth
20297
20298 =over 4
20299
20300 =item SYNOPSIS
20301
20302 =item DESCRIPTION
20303
20304 =item EXAMPLES
20305
20306 =item LIMITATIONS
20307
20308 =item AUTHOR
20309
20310 =back
20311
20312 =head2 Text::Tabs -- expand and unexpand tabs per the unix expand(1) and
20313 unexpand(1)
20314
20315 =over 4
20316
20317 =item SYNOPSIS
20318
20319 =item DESCRIPTION
20320
20321 =item BUGS
20322
20323 =item AUTHOR
20324
20325 =back
20326
20327 =head2 Text::Wrap - line wrapping to form simple paragraphs
20328
20329 =over 4
20330
20331 =item SYNOPSIS 
20332
20333 =item DESCRIPTION
20334
20335 =item OVERRIDES
20336
20337 =item EXAMPLE
20338
20339 =item AUTHOR
20340
20341 =back
20342
20343 =head2 Thread - manipulate threads in Perl (for old code only)
20344
20345 =over 4
20346
20347 =item CAVEAT
20348
20349 =item SYNOPSIS
20350
20351 =item DESCRIPTION
20352
20353 =item FUNCTIONS
20354
20355 $thread = Thread->new(\&start_sub), $thread = Thread->new(\&start_sub,
20356 LIST), lock VARIABLE, async BLOCK;, Thread->self, cond_wait VARIABLE,
20357 cond_signal VARIABLE, cond_broadcast VARIABLE, yield
20358
20359 =item METHODS
20360
20361 join, eval, detach, equal, tid, flags, done
20362
20363 =item LIMITATIONS
20364
20365 =item SEE ALSO
20366
20367 =back
20368
20369 =head2 Thread::Queue - thread-safe queues
20370
20371 =over 4
20372
20373 =item SYNOPSIS
20374
20375 =item DESCRIPTION
20376
20377 =item FUNCTIONS AND METHODS
20378
20379 new, enqueue LIST, dequeue, dequeue_nb, pending
20380
20381 =item SEE ALSO
20382
20383 =back
20384
20385 =head2 Thread::Semaphore - thread-safe semaphores
20386
20387 =over 4
20388
20389 =item SYNOPSIS
20390
20391 =item DESCRIPTION
20392
20393 =item FUNCTIONS AND METHODS
20394
20395 new, new NUMBER, down, down NUMBER, up, up NUMBER
20396
20397 =back
20398
20399 =head2 Thread::Signal - Start a thread which runs signal handlers reliably
20400 (for old code)
20401
20402 =over 4
20403
20404 =item CAVEAT
20405
20406 =item SYNOPSIS
20407
20408 =item DESCRIPTION
20409
20410 =item BUGS
20411
20412 =back
20413
20414 =head2 Thread::Specific - thread-specific keys
20415
20416 =over 4
20417
20418 =item SYNOPSIS
20419
20420 =item DESCRIPTION
20421
20422 =back
20423
20424 =head2 Tie::Array - base class for tied arrays
20425
20426 =over 4
20427
20428 =item SYNOPSIS
20429
20430 =item DESCRIPTION
20431
20432 TIEARRAY classname, LIST, STORE this, index, value, FETCH this, index,
20433 FETCHSIZE this, STORESIZE this, count, EXTEND this, count, EXISTS this,
20434 key, DELETE this, key, CLEAR this, DESTROY this, PUSH this, LIST, POP this,
20435 SHIFT this, UNSHIFT this, LIST, SPLICE this, offset, length, LIST
20436
20437 =item CAVEATS
20438
20439 =item AUTHOR
20440
20441 =back
20442
20443 =head2 Tie::File - Access the lines of a disk file via a Perl array
20444
20445 =over 4
20446
20447 =item SYNOPSIS
20448
20449 =item DESCRIPTION
20450
20451 =over 4
20452
20453 =item C<recsep>
20454
20455 =item C<autochomp>
20456
20457 =item C<mode>
20458
20459 =item C<memory>
20460
20461 =item C<dw_size>
20462
20463 =item Option Format
20464
20465 =back
20466
20467 =item Public Methods
20468
20469 =over 4
20470
20471 =item C<flock>
20472
20473 =item C<autochomp>
20474
20475 =item C<defer>, C<flush>, C<discard>, and C<autodefer>
20476
20477 =item C<offset>
20478
20479 =back
20480
20481 =item Tying to an already-opened filehandle
20482
20483 =item Deferred Writing
20484
20485 =over 4
20486
20487 =item Autodeferring
20488
20489 =back
20490
20491 =item CONCURRENT ACCESS TO FILES
20492
20493 =item CAVEATS
20494
20495 =item SUBCLASSING
20496
20497 =item WHAT ABOUT C<DB_File>?
20498
20499 =item AUTHOR
20500
20501 =item LICENSE
20502
20503 =item WARRANTY
20504
20505 =item THANKS
20506
20507 =item TODO
20508
20509 =back
20510
20511 =head2 Tie::Handle, Tie::StdHandle  - base class definitions for tied
20512 handles
20513
20514 =over 4
20515
20516 =item SYNOPSIS
20517
20518 =item DESCRIPTION
20519
20520 TIEHANDLE classname, LIST, WRITE this, scalar, length, offset, PRINT this,
20521 LIST, PRINTF this, format, LIST, READ this, scalar, length, offset,
20522 READLINE this, GETC this, CLOSE this, OPEN this, filename, BINMODE this,
20523 EOF this, TELL this, SEEK this, offset, whence, DESTROY this
20524
20525 =item MORE INFORMATION
20526
20527 =item COMPATIBILITY
20528
20529 =back
20530
20531 =head2 Tie::Hash, Tie::StdHash, Tie::ExtraHash - base class definitions for
20532 tied hashes
20533
20534 =over 4
20535
20536 =item SYNOPSIS
20537
20538 =item DESCRIPTION
20539
20540 TIEHASH classname, LIST, STORE this, key, value, FETCH this, key, FIRSTKEY
20541 this, NEXTKEY this, lastkey, EXISTS this, key, DELETE this, key, CLEAR this
20542
20543 =item Inheriting from B<Tie::StdHash>
20544
20545 =item Inheriting from B<Tie::ExtraHash>
20546
20547 =item C<UNTIE> and C<DESTROY>
20548
20549 =item MORE INFORMATION
20550
20551 =back
20552
20553 =head2 Tie::Memoize - add data to hash when needed
20554
20555 =over 4
20556
20557 =item SYNOPSIS
20558
20559 =item DESCRIPTION
20560
20561 =item Inheriting from B<Tie::Memoize>
20562
20563 =item EXAMPLE
20564
20565 =item BUGS
20566
20567 =item AUTHOR
20568
20569 =back
20570
20571 =head2 Tie::RefHash - use references as hash keys
20572
20573 =over 4
20574
20575 =item SYNOPSIS
20576
20577 =item DESCRIPTION
20578
20579 =item EXAMPLE
20580
20581 =item AUTHOR
20582
20583 =item VERSION
20584
20585 =item SEE ALSO
20586
20587 =back
20588
20589 =head2 Tie::Scalar, Tie::StdScalar - base class definitions for tied
20590 scalars
20591
20592 =over 4
20593
20594 =item SYNOPSIS
20595
20596 =item DESCRIPTION
20597
20598 TIESCALAR classname, LIST, FETCH this, STORE this, value, DESTROY this
20599
20600 =item MORE INFORMATION
20601
20602 =back
20603
20604 =head2 Tie::SubstrHash - Fixed-table-size, fixed-key-length hashing
20605
20606 =over 4
20607
20608 =item SYNOPSIS
20609
20610 =item DESCRIPTION
20611
20612 =item CAVEATS
20613
20614 =back
20615
20616 =head2 Time::HiRes - High resolution alarm, sleep, gettimeofday, interval
20617 timers
20618
20619 =over 4
20620
20621 =item SYNOPSIS
20622
20623 =item DESCRIPTION
20624
20625 gettimeofday (), usleep ( $useconds ), ualarm ( $useconds [,
20626 $interval_useconds ] ), tv_interval, time (), sleep ( $floating_seconds ),
20627 alarm ( $floating_seconds [, $interval_floating_seconds ] ), setitimer (
20628 $which, $floating_seconds [, $interval_floating_seconds ] ), getitimer (
20629 $which )
20630
20631 =item EXAMPLES
20632
20633 =item C API
20634
20635 =item DIAGNOSTICS
20636
20637 =over 4
20638
20639 =item negative time not invented yet
20640
20641 =item internal error: useconds < 0 (unsigned ... signed ...)
20642
20643 =back
20644
20645 =item CAVEATS
20646
20647 =item AUTHORS
20648
20649 =item COPYRIGHT AND LICENSE
20650
20651 =back
20652
20653 =head2 Time::Local - efficiently compute time from local and GMT time
20654
20655 =over 4
20656
20657 =item SYNOPSIS
20658
20659 =item DESCRIPTION
20660
20661 =item IMPLEMENTATION
20662
20663 =item BUGS
20664
20665 =item SUPPORT
20666
20667 =item AUTHOR
20668
20669 =back
20670
20671 =head2 Time::gmtime - by-name interface to Perl's built-in gmtime()
20672 function
20673
20674 =over 4
20675
20676 =item SYNOPSIS
20677
20678 =item DESCRIPTION
20679
20680 =item NOTE
20681
20682 =item AUTHOR
20683
20684 =back
20685
20686 =head2 Time::localtime - by-name interface to Perl's built-in localtime()
20687 function
20688
20689 =over 4
20690
20691 =item SYNOPSIS
20692
20693 =item DESCRIPTION
20694
20695 =item NOTE
20696
20697 =item AUTHOR
20698
20699 =back
20700
20701 =head2 Time::tm - internal object used by Time::gmtime and Time::localtime
20702
20703 =over 4
20704
20705 =item SYNOPSIS
20706
20707 =item DESCRIPTION
20708
20709 =item AUTHOR
20710
20711 =back
20712
20713 =head2 UNIVERSAL - base class for ALL classes (blessed references)
20714
20715 =over 4
20716
20717 =item SYNOPSIS
20718
20719 =item DESCRIPTION
20720
20721 C<< $obj->isa( TYPE ) >>, C<< CLASS->isa( TYPE ) >>, C<isa( VAL, TYPE )>,
20722 C<TYPE>, C<$obj>, C<CLASS>, C<VAL>, C<< $obj->can( METHOD ) >>, C<<
20723 CLASS->can( METHOD ) >>, C<can( VAL, METHOD )>, C<VERSION ( [ REQUIRE ] )>
20724
20725 =item EXPORTS
20726
20727 =back
20728
20729 =head2 Unicode::Collate - Unicode Collation Algorithm
20730
20731 =over 4
20732
20733 =item SYNOPSIS
20734
20735 =item DESCRIPTION
20736
20737 =over 4
20738
20739 =item Constructor and Tailoring
20740
20741 UCA_Version, backwards, entry, hangul_terminator, ignoreName, ignoreChar,
20742 level, normalization, overrideCJK, overrideHangul, preprocess, rearrange,
20743 table, undefName, undefChar, katakana_before_hiragana, upper_before_lower,
20744 variable, alternate
20745
20746 =item Methods for Collation
20747
20748 C<@sorted = $Collator-E<gt>sort(@not_sorted)>, C<$result =
20749 $Collator-E<gt>cmp($a, $b)>, C<$result = $Collator-E<gt>eq($a, $b)>,
20750 C<$result = $Collator-E<gt>ne($a, $b)>, C<$result = $Collator-E<gt>lt($a,
20751 $b)>, C<$result = $Collator-E<gt>le($a, $b)>, C<$result =
20752 $Collator-E<gt>gt($a, $b)>, C<$result = $Collator-E<gt>ge($a, $b)>,
20753 C<$sortKey = $Collator-E<gt>getSortKey($string)>, C<$sortKeyForm =
20754 $Collator-E<gt>viewSortKey($string)>
20755
20756 =item Methods for Searching
20757
20758 C<$position = $Collator-E<gt>index($string, $substring[, $position])>,
20759 C<($position, $length) = $Collator-E<gt>index($string, $substring[,
20760 $position])>, C<$match_ref = $Collator-E<gt>match($string, $substring)>,
20761 C<($match)   = $Collator-E<gt>match($string, $substring)>, C<@match =
20762 $Collator-E<gt>gmatch($string, $substring)>, C<$count =
20763 $Collator-E<gt>subst($string, $substring, $replacement)>, C<$count =
20764 $Collator-E<gt>gsubst($string, $substring, $replacement)>
20765
20766 =item Other Methods
20767
20768 C<%old_tailoring = $Collator-E<gt>change(%new_tailoring)>, C<$version =
20769 $Collator-E<gt>version()>, C<UCA_Version()>, C<Base_Unicode_Version()>
20770
20771 =item EXPORT
20772
20773 =item CAVEAT
20774
20775 =item Conformance Test
20776
20777 =back
20778
20779 =item AUTHOR
20780
20781 =item SEE ALSO
20782
20783 Unicode Collation Algorithm - UTS #10, The Default Unicode Collation
20784 Element Table (DUCET), The conformance test for the UCA, Hangul Syllable
20785 Type, Unicode Normalization Forms - UAX #15, L<Unicode::Normalize>
20786
20787 =back
20788
20789 =head2 Unicode::Normalize - Unicode Normalization Forms
20790
20791 =over 4
20792
20793 =item SYNOPSIS
20794
20795 =item DESCRIPTION
20796
20797 =over 4
20798
20799 =item Normalization Forms
20800
20801 C<$NFD_string = NFD($string)>, C<$NFC_string = NFC($string)>,
20802 C<$NFKD_string = NFKD($string)>, C<$NFKC_string = NFKC($string)>,
20803 C<$FCD_string = FCD($string)>, C<$FCC_string = FCC($string)>,
20804 C<$normalized_string = normalize($form_name, $string)>
20805
20806 =item Decomposition and Composition
20807
20808 C<$decomposed_string = decompose($string)>, C<$decomposed_string =
20809 decompose($string, $useCompatMapping)>, C<$reordered_string  =
20810 reorder($string)>, C<$composed_string   = compose($string)>
20811
20812 =item Quick Check
20813
20814 C<$result = checkNFD($string)>, C<$result = checkNFC($string)>, C<$result =
20815 checkNFKD($string)>, C<$result = checkNFKC($string)>, C<$result =
20816 checkFCD($string)>, C<$result = checkFCC($string)>, C<$result =
20817 check($form_name, $string)>
20818
20819 =item Character Data
20820
20821 C<$canonical_decomposed = getCanon($codepoint)>,
20822 C<$compatibility_decomposed = getCompat($codepoint)>,
20823 C<$codepoint_composite = getComposite($codepoint_here, $codepoint_next)>,
20824 C<$combining_class = getCombinClass($codepoint)>, C<$is_exclusion =
20825 isExclusion($codepoint)>, C<$is_singleton = isSingleton($codepoint)>,
20826 C<$is_non_starter_decomposition = isNonStDecomp($codepoint)>,
20827 C<$may_be_composed_with_prev_char = isComp2nd($codepoint)>
20828
20829 =item EXPORT
20830
20831 =back
20832
20833 =item AUTHOR
20834
20835 =item SEE ALSO
20836
20837 http://www.unicode.org/unicode/reports/tr15/,
20838 http://www.unicode.org/Public/UNIDATA/DerivedNormalizationProps.txt,
20839 http://www.unicode.org/notes/tn5/
20840
20841 =back
20842
20843 =head2 Unicode::UCD - Unicode character database
20844
20845 =over 4
20846
20847 =item SYNOPSIS
20848
20849 =item DESCRIPTION
20850
20851 =back
20852
20853 =over 4
20854
20855 =item charinfo
20856
20857 =back
20858
20859 =over 4
20860
20861 =item charblock
20862
20863 =back
20864
20865 =over 4
20866
20867 =item charscript
20868
20869 =back
20870
20871 =over 4
20872
20873 =item charblocks
20874
20875 =back
20876
20877 =over 4
20878
20879 =item charscripts
20880
20881 =back
20882
20883 =over 4
20884
20885 =item Blocks versus Scripts
20886
20887 =item Matching Scripts and Blocks
20888
20889 =item Code Point Arguments
20890
20891 =item charinrange
20892
20893 =back
20894
20895 =over 4
20896
20897 =item compexcl
20898
20899 =back
20900
20901 =over 4
20902
20903 =item casefold
20904
20905 =back
20906
20907 =over 4
20908
20909 =item casespec
20910
20911 =back
20912
20913 =over 4
20914
20915 =item Unicode::UCD::UnicodeVersion
20916
20917 =back
20918
20919 =over 4
20920
20921 =item Implementation Note
20922
20923 =back
20924
20925 =over 4
20926
20927 =item BUGS
20928
20929 =item AUTHOR
20930
20931 =back
20932
20933 =head2 User::grent - by-name interface to Perl's built-in getgr*()
20934 functions
20935
20936 =over 4
20937
20938 =item SYNOPSIS
20939
20940 =item DESCRIPTION
20941
20942 =item NOTE
20943
20944 =item AUTHOR
20945
20946 =back
20947
20948 =head2 User::pwent - by-name interface to Perl's built-in getpw*()
20949 functions
20950
20951 =over 4
20952
20953 =item SYNOPSIS
20954
20955 =item DESCRIPTION
20956
20957 =over 4
20958
20959 =item System Specifics
20960
20961 =back
20962
20963 =item NOTE
20964
20965 =item AUTHOR
20966
20967 =item HISTORY
20968
20969 March 18th, 2000
20970
20971 =back
20972
20973 =head2 Win32 - Interfaces to some Win32 API Functions
20974
20975 =over 4
20976
20977 =item DESCRIPTION
20978
20979 =over 4
20980
20981 =item Alphabetical Listing of Win32 Functions
20982
20983 Win32::AbortSystemShutdown(MACHINE), Win32::BuildNumber(),
20984 Win32::CopyFile(FROM, TO, OVERWRITE), Win32::DomainName(),
20985 Win32::ExpandEnvironmentStrings(STRING), Win32::FormatMessage(ERRORCODE),
20986 Win32::FsType(), Win32::FreeLibrary(HANDLE), Win32::GetArchName(),
20987 Win32::GetChipName(), Win32::GetCwd(), Win32::GetFolderPath(FOLDER [,
20988 CREATE]), Win32::GetFullPathName(FILENAME), Win32::GetLastError(),
20989 Win32::GetLongPathName(PATHNAME), Win32::GetNextAvailDrive(),
20990 Win32::GetOSVersion(), Win32::GetOSName(),
20991 Win32::GetShortPathName(PATHNAME), Win32::GetProcAddress(INSTANCE,
20992 PROCNAME), Win32::GetTickCount(), Win32::InitiateSystemShutdown,
20993 Win32::IsWinNT(), Win32::IsWin95(), Win32::LoadLibrary(LIBNAME),
20994 Win32::LoginName(), Win32::LookupAccountName(SYSTEM, ACCOUNT, DOMAIN, SID,
20995 SIDTYPE), Win32::LookupAccountSID(SYSTEM, SID, ACCOUNT, DOMAIN, SIDTYPE),
20996 Win32::MsgBox(MESSAGE [, FLAGS [, TITLE]]), Win32::NodeName(),
20997 Win32::RegisterServer(LIBRARYNAME), Win32::SetChildShowWindow(SHOWWINDOW),
20998 Win32::SetCwd(NEWDIRECTORY), Win32::SetLastError(ERROR),
20999 Win32::Sleep(TIME), Win32::Spawn(COMMAND, ARGS, PID),
21000 Win32::UnregisterServer(LIBRARYNAME)
21001
21002 =back
21003
21004 =back
21005
21006 =head2 XSLoader - Dynamically load C libraries into Perl code
21007
21008 =over 4
21009
21010 =item SYNOPSIS
21011
21012 =item DESCRIPTION
21013
21014 =over 4
21015
21016 =item Migration from C<DynaLoader>
21017
21018 =item Backward compatible boilerplate
21019
21020 =back
21021
21022 =item Order of initialization: early load()
21023
21024 =over 4
21025
21026 =item The most hairy case
21027
21028 =back
21029
21030 =item LIMITATIONS
21031
21032 =item AUTHOR
21033
21034 =back
21035
21036 =head1 AUXILIARY DOCUMENTATION
21037
21038 Here should be listed all the extra programs' documentation, but they
21039 don't all have manual pages yet:
21040
21041 =over 4
21042
21043 =item a2p
21044
21045 =item c2ph
21046
21047 =item dprofpp
21048
21049 =item h2ph
21050
21051 =item h2xs
21052
21053 =item perlbug
21054
21055 =item perldoc
21056
21057 =item pl2pm
21058
21059 =item pod2html
21060
21061 =item pod2man
21062
21063 =item s2p
21064
21065 =item splain
21066
21067 =item xsubpp
21068
21069 =back
21070
21071 =head1 AUTHOR
21072
21073 Larry Wall <F<larry@wall.org>>, with the help of oodles
21074 of other folks.
21075